diff --git a/README.md b/README.md index d28433236..9d28b95fc 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ The docs repo is for the product content for IBM Bluemix that is authored in Mar Each directory in the docs repo must synch with the overall architecture of the Bluemix doc app. -##How to suggest changes or updates to Bluemix documentation +## How to suggest changes or updates to Bluemix documentation All you need is a GitHub ID, and you can suggest edits and changes to Bluemix docs. A Bluemix team member will review any pull requests, and merge all or parts of your suggested changes as quickly as possible. To make your changes: @@ -20,7 +20,7 @@ For more detailed information on how to contribute content to Bluemix documentat https://help.github.com/articles/github-flow-in-the-browser/ -##Authoring Bluemix content in Markdown +## Authoring Bluemix content in Markdown =============== Purpose @@ -36,10 +36,10 @@ Bluemix has designed a parser that transforms Markdown into HTML5. Because the s Before you begin ----------- -###Markdown Editors +### Markdown Editors There are many free Markdown editors available, however, not all editors will honor the syntax used by Bluemix extensions. Notepad ++ is free, compatible, and also supports YAML, which is used to define content reference keywords. -#Mappings between DITA, MarkDown, and HTML 5 +# Mappings between DITA, MarkDown, and HTML 5 | Element | XDITA | HDITA | MarkDown (Git flavored) | HTML 5 | |-----------------|-----------|-------------|--------------------------|---------------| @@ -72,7 +72,7 @@ There are many free Markdown editors available, however, not all editors will ho | **comments** | | | `` | `` | | **mdash** | | | `no equivalent` | `—` | -#Mappings for how to code in DITA vs Markdown +# Mappings for how to code in DITA vs Markdown | Dita Element | HTML 5 output from Dita | How to code in Markdown | HTML 5 output from Markdown | |-----------------|-----------|-------------|-------------------| @@ -93,7 +93,7 @@ There are many free Markdown editors available, however, not all editors will ho | **shortdesc** | `

` | This is a shortdesc paragraph
`{: shortdesc} `
**Note:** This requires the following attribute definition available in the attribute definition template: `{:shortdesc: .shortdesc}` | `

`| | **term** | `term` |`*term*` | `term`| -#Bluemix special mappings for how to code in DITA vs Markdown +# Bluemix special mappings for how to code in DITA vs Markdown | Dita Element | HTML 5 output from Dita | How to code in Markdown | HTML 5 output from Markdown | |-----------------|-----------|-------------|-------------------| @@ -127,7 +127,7 @@ You can use the Bluemix attributes extension to map the following attributes to **Note**: Attributes, when defined and applied within a Markdown file, are output by the Bluemix Markdown parser by default. No additional parameters or flags need to be passed to the parser when the command is run. -####How attributes are defined in Markdown +#### How attributes are defined in Markdown Attributes are defined at the top of your Markdown file. Each Attribute definition must be enclosed in curly brackets { }, and must contain a unique name. While you can provide attribute definition values for ID, Class, and Custom, none of these values are required, and you can define any combination of these different attribute values. The Bluemix Attribute Definitions implimentation is based on the Kramdown / Maraku Attribute Definiton extension: (http://kramdown.gettalong.org/syntax.html#attribute-list-definitions). For Example: @@ -144,7 +144,7 @@ For Example: * **.Class** sets a value associated with the Class attribute. This value is optional. If I define a Class of `.ph` in my attribute, and I set this attribute on a Header, the HTML5 output will produce `

`. This value must begin with a pound period (.). * **.Custom** sets a custom attribute value. This value is optional. If I define a Custom value of `data-hd-programlang='java'` in my attribute, and I set this attribute on a Header, the HTML5 output will produce `

`. -####How attributes are applied in Markdown +#### How attributes are applied in Markdown After you define your attribute at the top of your Markdown file, you can apply the attribute by adding a call to the name of your attribute to the end of the Markdown tag you want to bind your attribute to. The implimentation of Bluemix attribute usage is based on the Kramdown / Maraku Block/Span Inline Attribute Lists: http://kramdown.gettalong.org/syntax.html#inline-attribute-lists To apply a defined attribute, call the name of the attribute surrounded by curly brackets, and pre-pended by a colon and a space: `{: Name}` @@ -165,7 +165,7 @@ The Markdown parser will output HTML5 that looks like this: ``` -####Attributes in DITA vs Markdown +#### Attributes in DITA vs Markdown In DITA, attributes are used to add metadata to elements. For example, you might add a `product`, `props`, or `otherprops` attribute on a phrase or paragraph element in order to associate a value with that phrase or paragraph. These values allow for filtering either during build or runtime. DITA transforms to HTML5 also apply Class attributes to HTML5 elements, and these values are used by the .CSS stylesheets at runtime to control the display. Example of DITA attributes (from `using_rabbitmq_service.dita`): @@ -216,7 +216,7 @@ Output of HTML5 from Markdown parser: ### Headers and footers Bluemix needed to add copyright and metadata to the header of the HTML 5 output. We have standard header and footer files that are called during transformation. -####Anchor IDs Generated for all Headers +#### Anchor IDs Generated for all Headers When the Bluemix Markdown parser transforms Markdown to HTML5, it automatically binds an anchor ID to all Header elements. Any time the parser transforms a Markdown file that contains a header, the HTML5 output of that header tag will produce an `id` attribute, with a value that is unique. Unique anchor IDs on headers provide writers with the ability to link directly to a sub-topic that begins with a Header. For example, here is a level 4 Header in Markdown: @@ -229,7 +229,7 @@ When the above Markdown is transformed into HTML5, the parser produces a unique ``` **Note**: Header anchor IDs are output by the Bluemix Markdown parser by default. No additional parameters or flags need to be passed to the parser when the command is run. -####Changing an anchor ID on a Header +#### Changing an anchor ID on a Header The Anchor ID is bound to a header by default, and it always uses the text of the header as its name, so you can always just link to that. However, any time you want to override the anchor tag of a header, you can use an attribute. See the Attribute section above for more details on using attributes. @@ -260,7 +260,7 @@ HTML5 output: {: myanchor} ``` -####Linking to an anchor ID for a header +#### Linking to an anchor ID for a header You can link directly to a header within a file using the header anchor ID. You can link to sub-headings; it does not need to be the top-level header. Use the automatically generated header value based on the text that is defined in the header (see Anchor IDs Generated for all Headers), or add your own anchor ID to use for linking (see Changing an anchor ID on a header). The following example for linking uses user-defined ID anchors for each header, and the goal is to provide a link to content that is further down in the same file. @@ -303,7 +303,7 @@ Conref definitions in YAML are structured in nested keys, each key that contains Conrefs in Markdown are called by using the following syntax: `{{site.data.key1.key2...keyN}}` **Note:** While you can Nest keys as deep as you like in YAML, and call deeper sets of keys from markdown, Bluemix conrefs use only 2 keys. For example: `{{site.data.keyword.bluemix}}` -####Content references in DITA vs Markdown +#### Content references in DITA vs Markdown In DITA, a content reference, or conref, is a way of reusing or pulling content from one file into another file; effectively making a copy during the transform. Example of conrefs sourced in DITA (stored in cloudoeconrefs.dita): diff --git a/admin/nl/it/account.md b/admin/nl/it/account.md index a076d77be..0e63d1300 100644 --- a/admin/nl/it/account.md +++ b/admin/nl/it/account.md @@ -1,102 +1,102 @@ ---- - - - -copyright: - - years: 2015, 2017 -lastupdated: "2017-01-09" - - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} - -# Gestione del tuo account {{site.data.keyword.Bluemix_notm}} -{: #mngacct} - -Vai al link **Account** per impostare le notifiche, visualizzare l'utilizzo del tuo account o la tua fattura. -{:shortdesc} - -## Registrazione a {{site.data.keyword.Bluemix_notm}} -{: #signup} - -Puoi registrarti per un account {{site.data.keyword.Bluemix_notm}} utilizzando un ID IBM esistente, creando un nuovo ID IBM o utilizzando un ID federato. Un ID federato è un ID all'interno di un dominio aziendale che è stato registrato con IBM, in modo che le credenziali di dominio e utente possano essere utilizzate per accedere alle applicazioni Web. - -Un ID federato può essere utilizzato per la registrazione a {{site.data.keyword.Bluemix_notm}} solo se la tua azienda ha già effettuato una registrazione con IBM. La registrazione di un dominio aziendale con IBM consente agli utenti di accedere a prodotti e servizi IBM utilizzando le proprie credenziali aziendali esistenti. L'autenticazione viene quindi gestita dal provider di identità dell'azienda. Quando accedi a {{site.data.keyword.Bluemix_notm}} con un ID federato, ti viene richiesto di accedere tramite la pagina di accesso della tua azienda. Per informazioni sulla richiesta di registrazione del dominio della tua organizzazione o azienda con IBM o per ulteriori informazioni sul processo, consulta [IBMid Enterprise Federation Adoption Guide ![Icona link esterno](../icons/launch-glyph.svg)](https://ibm.box.com/v/IBMid-Federation-Guide){: new_window}. Quando richiedi di registrare gli ID federati, è necessario uno sponsor IBM, ad esempio un rappresentate di offerte o clienti. - -| Metodi di registrazione | Dettagli | -|-----------------|---------| -|ID IBM esistente | Se già disponi di un ID IBM, registrati a {{site.data.keyword.Bluemix_notm}} con le credenziali esistenti che utilizzi per i prodotti e servizi IBM. Durante la registrazione, ti viene richiesto di immettere un numero di telefono. | -|Nuovo ID IBM | Se non hai ancora un ID IBM, puoi scegliere di crearne uno. L'ID IBM ti consente di utilizzare un unico nome utente di accesso per tutti i prodotti e servizi IBM che vorrai utilizzare, incluso {{site.data.keyword.Bluemix_notm}}. Ti viene richiesto di immettere i tuoi dati personali, tra cui nome e cognome, numero di telefono e password per le nuove credenziali. Puoi utilizzare questo ID IBM per eseguire l'accesso quando utilizzi altri servizi e prodotti IBM. | -|ID federato | Se la tua azienda ha richiesto di registrare le credenziali utente dal dominio aziendale con IBM, puoi registrarti a {{site.data.keyword.Bluemix_notm}} utilizzando le credenziali che usi già per l'accesso della tua azienda. Durante la registrazione, ti viene richiesto di immettere un numero di telefono. | -{:caption="Table 1. Sign up methods" caption-side="top"} - -## Impostazione delle notifiche -{: #notifications} - -Fai clic su **Account** > **Notifiche** per impostare l'account generale e le notifiche di spesa. Le notifiche di spesa sono disponibili solo per i proprietari degli account {{site.data.keyword.Bluemix_notm}} Pagamento a consumo e Sottoscrizione. - -Puoi impostare le notifiche email della piattaforma per gli incidenti e la manutenzione pianificata {{site.data.keyword.Bluemix_notm}} e puoi impostare le notifiche di spesa per avvisarti quando il tuo account è vicino alla soglia di spesa che hai specificato. Completa le seguenti attività per impostare differenti tipi di notifica per il tuo account. - -### Configurazione delle notifiche della piattaforma - -Fai clic su **Account** > **Notifiche** > **Piattaforma** per impostare le notifiche e-mail per gli incidenti e la manutenzione pianificata {{site.data.keyword.Bluemix_notm}}. Puoi selezionare o cancellare ogni opzione per abilitare o disabilitare la notifica email. - - - -### Configurazione delle notifiche di spesa -{: #spendingnotifications} - -Se sei il proprietario di un account {{site.data.keyword.Bluemix_notm}} Pagamento a consumo o Sottoscrizione, puoi impostare le notifiche di spesa via email. Imposta le notifiche per la spesa totale di account, runtime, contenitori e servizi, nonché la spesa per singoli servizi, tranne quelli di terze parti. Ricevi le notifiche quando raggiungi l'80%, il 90% e il 100% delle soglie di spesa da te specificate. Puoi modificare ogni notifica di spesa in qualsiasi momento, secondo le tue esigenze. - -Completa la seguente procedura per impostare le notifiche via email per i limiti di spesa: - -
    -
  1. Fai clic su **Account** > **Notifiche** > **Spesa**.
    2. -
  2. Immetti un valore numerico per impostare la soglia di spesa per l'attivazione di una notifica per ciascun tipo di notifica:
    -
      -
    • Totale account
      • -
    • Totale runtime
      • -
    • Totale servizi
      • -
    • Totale contenitore
      • -
    • Spesa per un servizio specifico
      • -
    -
    3. -
  3. Al termine dell'operazione, fai clic su **Salva**.
    4. -
- -**Nota**: se hai un account di prova, puoi eseguire l'upgrade a un account Sottoscrizione o Pagamento a consumo per impostare i limiti di spesa. Per ulteriori informazioni sugli account Pagamento a consumo e Sottoscrizione, consulta [Modalità di fatturazione](/docs/pricing/index.html#pay-accounts). - -## Visualizzazione dell'utilizzo -{: #acctusage} - -In qualità di proprietario dell'account o gestore della fatturazione per un'organizzazione, puoi utilizzare la pagina Dashboard di utilizzo per visualizzare gli addebiti in -tempo reale per i runtime, i contenitori, i servizi e il supporto utilizzati al mese nelle tue organizzazioni. Puoi vedere i GB-ora di runtime e il consumo dei servizi in tutte le regioni oppure puoi -selezionare la visualizzazione di una specifica regione. - -Per aprire la pagina Dashboard di utilizzo, fai clic su **Account** > *nome_del_tuo_account* > **Dashboard di utilizzo**. I gestori della fatturazione possono visualizzare i dettagli solo per le organizzazioni in cui ricoprono tale ruolo. - -Al proprietario dell'account viene addebitato l'utilizzo totale sostenuto su tutte le organizzazioni alla fine di ciascun ciclo di fatturazione. In qualità di proprietario dell'account, puoi filtrare il riepilogo dell'utilizzo in base alla regione e all'organizzazione. Puoi anche fare clic su uno specifico mese per visualizzare il relativo utilizzo. Seleziona **Tutte le organizzazioni** dall'elenco **Organizzazione** per visualizzare l'utilizzo per tutte le organizzazioni nell'account. - -## Aggiornamento delle informazioni di fatturazione -{: #account_billing} - -In qualità di proprietario dell'account, puoi modificare, aggiungere o rimuovere le informazioni sulla carta di credito salvate che sono associate al tuo account {{site.data.keyword.Bluemix_notm}}. Fai clic su **Account** > *nome_del_tuo_account* > **Fatturazione**. - -Se hai un account SoftLayer collegato al tuo account {{site.data.keyword.Bluemix_notm}}, vedi [Fatturazione per l'utilizzo di {{site.data.keyword.Bluemix_notm}} con account collegati](/docs/admin/softlayerlink.html#bill_usage) per ulteriori informazioni sulla fatturazione. +--- + + + +copyright: + + years: 2015, 2017 +lastupdated: "2017-01-09" + + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} + +# Gestione del tuo account {{site.data.keyword.Bluemix_notm}} +{: #mngacct} + +Vai al link **Account** per impostare le notifiche, visualizzare l'utilizzo del tuo account o la tua fattura. +{:shortdesc} + +## Registrazione a {{site.data.keyword.Bluemix_notm}} +{: #signup} + +Puoi registrarti per un account {{site.data.keyword.Bluemix_notm}} utilizzando un ID IBM esistente, creando un nuovo ID IBM o utilizzando un ID federato. Un ID federato è un ID all'interno di un dominio aziendale che è stato registrato con IBM, in modo che le credenziali di dominio e utente possano essere utilizzate per accedere alle applicazioni Web. + +Un ID federato può essere utilizzato per la registrazione a {{site.data.keyword.Bluemix_notm}} solo se la tua azienda ha già effettuato una registrazione con IBM. La registrazione di un dominio aziendale con IBM consente agli utenti di accedere a prodotti e servizi IBM utilizzando le proprie credenziali aziendali esistenti. L'autenticazione viene quindi gestita dal provider di identità dell'azienda. Quando accedi a {{site.data.keyword.Bluemix_notm}} con un ID federato, ti viene richiesto di accedere tramite la pagina di accesso della tua azienda. Per informazioni sulla richiesta di registrazione del dominio della tua organizzazione o azienda con IBM o per ulteriori informazioni sul processo, consulta [IBMid Enterprise Federation Adoption Guide ![Icona link esterno](../icons/launch-glyph.svg)](https://ibm.box.com/v/IBMid-Federation-Guide){: new_window}. Quando richiedi di registrare gli ID federati, è necessario uno sponsor IBM, ad esempio un rappresentate di offerte o clienti. + +| Metodi di registrazione | Dettagli | +|-----------------|---------| +|ID IBM esistente | Se già disponi di un ID IBM, registrati a {{site.data.keyword.Bluemix_notm}} con le credenziali esistenti che utilizzi per i prodotti e servizi IBM. Durante la registrazione, ti viene richiesto di immettere un numero di telefono. | +|Nuovo ID IBM | Se non hai ancora un ID IBM, puoi scegliere di crearne uno. L'ID IBM ti consente di utilizzare un unico nome utente di accesso per tutti i prodotti e servizi IBM che vorrai utilizzare, incluso {{site.data.keyword.Bluemix_notm}}. Ti viene richiesto di immettere i tuoi dati personali, tra cui nome e cognome, numero di telefono e password per le nuove credenziali. Puoi utilizzare questo ID IBM per eseguire l'accesso quando utilizzi altri servizi e prodotti IBM. | +|ID federato | Se la tua azienda ha richiesto di registrare le credenziali utente dal dominio aziendale con IBM, puoi registrarti a {{site.data.keyword.Bluemix_notm}} utilizzando le credenziali che usi già per l'accesso della tua azienda. Durante la registrazione, ti viene richiesto di immettere un numero di telefono. | +{:caption="Table 1. Sign up methods" caption-side="top"} + +## Impostazione delle notifiche +{: #notifications} + +Fai clic su **Account** > **Notifiche** per impostare l'account generale e le notifiche di spesa. Le notifiche di spesa sono disponibili solo per i proprietari degli account {{site.data.keyword.Bluemix_notm}} Pagamento a consumo e Sottoscrizione. + +Puoi impostare le notifiche email della piattaforma per gli incidenti e la manutenzione pianificata {{site.data.keyword.Bluemix_notm}} e puoi impostare le notifiche di spesa per avvisarti quando il tuo account è vicino alla soglia di spesa che hai specificato. Completa le seguenti attività per impostare differenti tipi di notifica per il tuo account. + +### Configurazione delle notifiche della piattaforma + +Fai clic su **Account** > **Notifiche** > **Piattaforma** per impostare le notifiche e-mail per gli incidenti e la manutenzione pianificata {{site.data.keyword.Bluemix_notm}}. Puoi selezionare o cancellare ogni opzione per abilitare o disabilitare la notifica email. + + + +### Configurazione delle notifiche di spesa +{: #spendingnotifications} + +Se sei il proprietario di un account {{site.data.keyword.Bluemix_notm}} Pagamento a consumo o Sottoscrizione, puoi impostare le notifiche di spesa via email. Imposta le notifiche per la spesa totale di account, runtime, contenitori e servizi, nonché la spesa per singoli servizi, tranne quelli di terze parti. Ricevi le notifiche quando raggiungi l'80%, il 90% e il 100% delle soglie di spesa da te specificate. Puoi modificare ogni notifica di spesa in qualsiasi momento, secondo le tue esigenze. + +Completa la seguente procedura per impostare le notifiche via email per i limiti di spesa: + +
    +
  1. Fai clic su **Account** > **Notifiche** > **Spesa**.
    2. +
  2. Immetti un valore numerico per impostare la soglia di spesa per l'attivazione di una notifica per ciascun tipo di notifica:
    +
      +
    • Totale account
      • +
    • Totale runtime
      • +
    • Totale servizi
      • +
    • Totale contenitore
      • +
    • Spesa per un servizio specifico
      • +
    +
    3. +
  3. Al termine dell'operazione, fai clic su **Salva**.
    4. +
+ +**Nota**: se hai un account di prova, puoi eseguire l'upgrade a un account Sottoscrizione o Pagamento a consumo per impostare i limiti di spesa. Per ulteriori informazioni sugli account Pagamento a consumo e Sottoscrizione, consulta [Modalità di fatturazione](/docs/pricing/index.html#pay-accounts). + +## Visualizzazione dell'utilizzo +{: #acctusage} + +In qualità di proprietario dell'account o gestore della fatturazione per un'organizzazione, puoi utilizzare la pagina Dashboard di utilizzo per visualizzare gli addebiti in +tempo reale per i runtime, i contenitori, i servizi e il supporto utilizzati al mese nelle tue organizzazioni. Puoi vedere i GB-ora di runtime e il consumo dei servizi in tutte le regioni oppure puoi +selezionare la visualizzazione di una specifica regione. + +Per aprire la pagina Dashboard di utilizzo, fai clic su **Account** > *nome_del_tuo_account* > **Dashboard di utilizzo**. I gestori della fatturazione possono visualizzare i dettagli solo per le organizzazioni in cui ricoprono tale ruolo. + +Al proprietario dell'account viene addebitato l'utilizzo totale sostenuto su tutte le organizzazioni alla fine di ciascun ciclo di fatturazione. In qualità di proprietario dell'account, puoi filtrare il riepilogo dell'utilizzo in base alla regione e all'organizzazione. Puoi anche fare clic su uno specifico mese per visualizzare il relativo utilizzo. Seleziona **Tutte le organizzazioni** dall'elenco **Organizzazione** per visualizzare l'utilizzo per tutte le organizzazioni nell'account. + +## Aggiornamento delle informazioni di fatturazione +{: #account_billing} + +In qualità di proprietario dell'account, puoi modificare, aggiungere o rimuovere le informazioni sulla carta di credito salvate che sono associate al tuo account {{site.data.keyword.Bluemix_notm}}. Fai clic su **Account** > *nome_del_tuo_account* > **Fatturazione**. + +Se hai un account SoftLayer collegato al tuo account {{site.data.keyword.Bluemix_notm}}, vedi [Fatturazione per l'utilizzo di {{site.data.keyword.Bluemix_notm}} con account collegati](/docs/admin/softlayerlink.html#bill_usage) per ulteriori informazioni sulla fatturazione. diff --git a/admin/nl/it/adminpublic.md b/admin/nl/it/adminpublic.md index b93993554..131e8b071 100644 --- a/admin/nl/it/adminpublic.md +++ b/admin/nl/it/adminpublic.md @@ -1,52 +1,52 @@ ---- - - - -copyright: - - years: 2015, 2017 -lastupdated: "2017-01-09" - - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} - - - -# Configurazione del tuo account -{: #account} - -Ora che ti sei registrato in {{site.data.keyword.Bluemix_notm}}, devi configurare il tuo account in modo da poter passare rapidamente al provisioning dell'infrastruttura o alla creazione di applicazioni. -{:shortdesc} - -La prima volta che utilizzi {{site.data.keyword.Bluemix_notm}}, potrai configurare il tuo profilo di account, che include il caricamento di un'immagine di profilo. Puoi anche configurare le organizzazioni e gli spazi per il tuo account e invitare i membri del team a ogni organizzazione e spazio. - -Puoi visualizzare i dettagli di tutti i tuoi account facendo clic sul link **Account** nella barra dei menu. Questi dettagli includono le informazioni di fatturazione associate, le informazioni sull'utilizzo, una directory team dei membri e tutte le organizzazioni che ti appartengono o che gestisci per ciascun account. - -Se sei un amministratore per {{site.data.keyword.Bluemix_notm}} locale o {{site.data.keyword.Bluemix_notm}} dedicato, vedi [Gestione di {{site.data.keyword.Bluemix_notm}} locale o {{site.data.keyword.Bluemix_notm}} dedicato](/docs/admin/index.html#mng) per i dettagli sulla gestione del tuo account utilizzando la pagina Amministrazione. - -Potresti anche voler registrarti per ricevere le notifiche; controlla le opzioni di supporto per scoprire dove richiedere assistenza o anche per fornire un feedback a IBM. - -- **Notifiche** - - Registrati per ricevere le notifiche relative agli aggiornamenti di manutenzione alle regioni pubbliche della piattaforma {{site.data.keyword.Bluemix_notm}} e ai servizi associati, nonché a incidenti, sicurezza e altri annunci. Puoi puntare il lettore di feed RSS al link RSS nella [pagina sugli stati Bluemix ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/Bluemixstatus){: new_window} per restare aggiornato sulle modifiche a {{site.data.keyword.Bluemix_notm}} pubblico. Per ulteriori dettagli sull'impostazione delle notifiche, vedi [Visualizzazione dello stato di Bluemix](/docs/support/index.html#viewing-bluemix-status). - -- **Opzioni di supporto** - - Controlla le opzioni di supporto disponibili in modo da sapere esattamente dove andare e cosa fare in caso di problemi. Per ulteriori dettagli sulle opzioni di supporto, vedi [Richiesta di assistenza clienti](/docs/support/index.html#getting-customer-support). - -- **Inizia a codificare** - - Crea la tua prima applicazione. Vai al **Catalogo** per esaminare la varietà di elaborazioni e servizi disponibili con cui sviluppare e per controllare i contenitori tipo e le applicazioni di esempio con cui puoi iniziare subito a codificare. - -- **Fornisci un feedback su {{site.data.keyword.Bluemix_notm}}** - - Puoi fornire un feedback sul prodotto o sulla documentazione. - - Per inviare le tue idee per migliorare {{site.data.keyword.Bluemix_notm}} e i servizi, vai a [IBM Cloud Ideas ![icona link esterno](../icons/launch-glyph.svg)](https://ibmcloud.ideas.aha.io){: new_window}. Per ulteriori informazioni su come utilizzare il portale delle nuove idee, vedi [Think, write, submit: New ideas portal for IBM Cloud ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/bluemix/2016/10/05/think-write-submit/){: new_window}. - - Per fornire un feedback sulla documentazione, fai clic sul link **Feedback** in ciascuna pagina o collabora con noi facendo clic sul link **Modifica in GitHub** dopo il titolo. Per ulteriori informazioni su come contribuire alle documentazioni, vedi [When it comes to docs, everyone can contribute in Bluemix ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/bluemix/2016/01/13/bluemix-docs-now-open-source-on-github/){: new_window}. +--- + + + +copyright: + + years: 2015, 2017 +lastupdated: "2017-01-09" + + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} + + + +# Configurazione del tuo account +{: #account} + +Ora che ti sei registrato in {{site.data.keyword.Bluemix_notm}}, devi configurare il tuo account in modo da poter passare rapidamente al provisioning dell'infrastruttura o alla creazione di applicazioni. +{:shortdesc} + +La prima volta che utilizzi {{site.data.keyword.Bluemix_notm}}, potrai configurare il tuo profilo di account, che include il caricamento di un'immagine di profilo. Puoi anche configurare le organizzazioni e gli spazi per il tuo account e invitare i membri del team a ogni organizzazione e spazio. + +Puoi visualizzare i dettagli di tutti i tuoi account facendo clic sul link **Account** nella barra dei menu. Questi dettagli includono le informazioni di fatturazione associate, le informazioni sull'utilizzo, una directory team dei membri e tutte le organizzazioni che ti appartengono o che gestisci per ciascun account. + +Se sei un amministratore per {{site.data.keyword.Bluemix_notm}} locale o {{site.data.keyword.Bluemix_notm}} dedicato, vedi [Gestione di {{site.data.keyword.Bluemix_notm}} locale o {{site.data.keyword.Bluemix_notm}} dedicato](/docs/admin/index.html#mng) per i dettagli sulla gestione del tuo account utilizzando la pagina Amministrazione. + +Potresti anche voler registrarti per ricevere le notifiche; controlla le opzioni di supporto per scoprire dove richiedere assistenza o anche per fornire un feedback a IBM. + +- **Notifiche** + + Registrati per ricevere le notifiche relative agli aggiornamenti di manutenzione alle regioni pubbliche della piattaforma {{site.data.keyword.Bluemix_notm}} e ai servizi associati, nonché a incidenti, sicurezza e altri annunci. Puoi puntare il lettore di feed RSS al link RSS nella [pagina sugli stati Bluemix ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/Bluemixstatus){: new_window} per restare aggiornato sulle modifiche a {{site.data.keyword.Bluemix_notm}} pubblico. Per ulteriori dettagli sull'impostazione delle notifiche, vedi [Visualizzazione dello stato di Bluemix](/docs/support/index.html#viewing-bluemix-status). + +- **Opzioni di supporto** + + Controlla le opzioni di supporto disponibili in modo da sapere esattamente dove andare e cosa fare in caso di problemi. Per ulteriori dettagli sulle opzioni di supporto, vedi [Richiesta di assistenza clienti](/docs/support/index.html#getting-customer-support). + +- **Inizia a codificare** + + Crea la tua prima applicazione. Vai al **Catalogo** per esaminare la varietà di elaborazioni e servizi disponibili con cui sviluppare e per controllare i contenitori tipo e le applicazioni di esempio con cui puoi iniziare subito a codificare. + +- **Fornisci un feedback su {{site.data.keyword.Bluemix_notm}}** + + Puoi fornire un feedback sul prodotto o sulla documentazione. + + Per inviare le tue idee per migliorare {{site.data.keyword.Bluemix_notm}} e i servizi, vai a [IBM Cloud Ideas ![icona link esterno](../icons/launch-glyph.svg)](https://ibmcloud.ideas.aha.io){: new_window}. Per ulteriori informazioni su come utilizzare il portale delle nuove idee, vedi [Think, write, submit: New ideas portal for IBM Cloud ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/bluemix/2016/10/05/think-write-submit/){: new_window}. + + Per fornire un feedback sulla documentazione, fai clic sul link **Feedback** in ciascuna pagina o collabora con noi facendo clic sul link **Modifica in GitHub** dopo il titolo. Per ulteriori informazioni su come contribuire alle documentazioni, vedi [When it comes to docs, everyone can contribute in Bluemix ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/bluemix/2016/01/13/bluemix-docs-now-open-source-on-github/){: new_window}. diff --git a/admin/nl/it/index.md b/admin/nl/it/index.md index fdef67d60..32469e611 100644 --- a/admin/nl/it/index.md +++ b/admin/nl/it/index.md @@ -1,2112 +1,2112 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-02-22" - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} -{:pre: .pre} -{:table: .aria-labeledby="caption"} - -# Gestione di {{site.data.keyword.Bluemix_notm}} locale e {{site.data.keyword.Bluemix_notm}} dedicato -{: #mng} - - -Se disponi dell'accesso come amministratore per {{site.data.keyword.Bluemix}} locale o {{site.data.keyword.Bluemix_notm}} dedicato, vai alla pagina **Amministrazione** per gestire risorse, monitorare l'utilizzo delle quote, amministrare le autorizzazioni utente, pianificare le notifiche di aggiornamento, visualizzare log e report di sicurezza e altro. Puoi gestire le tue organizzazioni creando degli spazi e impostando dei [ruoli e delle autorizzazioni per gli utenti](/docs/admin/index.html#oc_useradmin); vedi [Gestione delle tue organizzazioni](/docs/admin/orgs_spaces.html). -{:shortdesc} - -{: #ld_table1} - -| Quali operazioni posso eseguire? | Dettagli | -|----------------|---------| -|Monitorare l'utilizzo del sistema | Fai clic su **AMMINISTRAZIONE > UTILIZZO**. Visualizza le informazioni sul sistema, monitora l'utilizzo della CPU e pianifica l'utilizzo per ottimizzare il processo decisionale per la tua azienda. Vedi [Visualizzazione delle informazioni sull'utilizzo](/docs/admin/index.html#oc_resource).| -|Gestire il tuo catalogo | Fai clic su **AMMINISTRAZIONE > GESTIONE CATALOGO** per stabilire quali servizi sono visibili ai tuoi utenti e organizzazioni. Vedi [Gestione del tuo catalogo](/docs/admin/index.html#oc_catalog).| -|Amministrare le organizzazioni | Fai clic su **AMMINISTRAZIONE > AMMINISTRAZIONE ORGANIZZAZIONE** per creare organizzazioni, monitorare le quote per le organizzazioni e prendere decisioni rapide basate sulle esigenze. Vedi [Amministrazione delle organizzazioni](/docs/admin/index.html#oc_organizations).| -|Creare spazi e assegnare i ruoli utente | Fai clic su **Account** > **Gestisci organizzazioni** per creare gli spazi tra le tue organizzazioni. Aggiungi utenti e assegna loro dei ruoli per l'organizzazione e lo spazio. Vedi [Gestione delle tue organizzazioni](/docs/admin/orgs_spaces.html). | -|Gestire le autorizzazioni degli utenti amministrativi | Fai clic su **AMMINISTRAZIONE > AMMINISTRAZIONE UTENTI** per aggiungere e rimuovere utenti e modifica le autorizzazioni utente. Vedi [Gestione di utenti e autorizzazioni](/docs/admin/index.html#oc_useradmin). | -|Esaminare report e log | Fai clic su **AMMINISTRAZIONE > REPORT E LOG** per visualizzare i report di sicurezza e i log di controllo relativi alla tua istanza. Vedi [Visualizzazione dei report](/docs/admin/index.html#oc_report). | -|Visualizzare le informazioni sul sistema. | Fai clic su **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA** per visualizzare le informazioni di sistema, quali aggiornamenti di manutenzione in sospeso, nome e versione della tua istanza, regione, URL API, URL CLI, dettagli di configurazione LDAP, associazioni di gruppi e utenti, statistiche e domini condivisi. Vedi [Visualizzazione delle informazioni sul sistema](/docs/admin/index.html#oc_system). | -|Estendere le notifiche e impostare le sottoscrizioni notifica | Fai clic su **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso**. Puoi utilizzare webhook da integrare con un servizio Web a scelta per impostare una sottoscrizione di notifica evento per un aggiornamento o incidente. Vedi [Notifiche e sottoscrizioni di notifica](/docs/admin/index.html#oc_eventsubscription). | -{: caption="Table 1. Administrative tasks for managing your {{site.data.keyword.Bluemix_notm}} local or dedicated instance" caption-side="top"} - - - -**Suggerimento**: il dashboard Infrastruttura nella console {{site.data.keyword.Bluemix_notm}} è disponibile solo per gli account collegati negli ambienti di {{site.data.keyword.Bluemix_notm}} pubblico. - - - - - -## Notifiche e sottoscrizioni di notifica -{: #oc_eventsubscription} - -Puoi sempre conoscere lo stato del tuo ambiente consultando la pagina Stato. Non appena si verificano, gli incidenti e gli eventi di aggiornamento della manutenzione pianificata con interruzioni del servizio vengono segnalati nella pagina Stato. {{site.data.keyword.Bluemix_notm}} invia inoltre alla pagina Amministrazione dell'area Notifiche le eventuali notifiche riguardanti eventi quali aggiornamenti di manutenzione pianificati o in sospeso. - -### Notifiche - -Puoi visualizzare le notifiche riguardanti il tuo ambiente locale o dedicato, al fine di monitorare lo stato del tuo ambiente. Consulta la seguente tabella per informazioni sui diversi tipi di notifiche e sui rispettivi punti di pubblicazione. - -{: #ld_table2} - -| **Tipo di evento** | **Metodo di notifica** | -|-----------------|-------------------| -| Aggiornamenti di manutenzione | Per visualizzare uno storico e un elenco completo delle tue notifiche complete e in sospeso, fai clic su **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA** > *Numero* **in sospeso**. Ricevi anche un avviso degli eventi di aggiornamento della manutenzione pianificata con interruzioni del servizio nella pagina Stato. Fai clic su **Supporto** > **Stato**. Puoi estendere la funzionalità di notifica impostando una sottoscrizione che invia un'e-mail a destinatari di tua scelta. In alternativa, puoi impostare una sottoscrizione che utilizza dei webhook per integrare le notifiche provenienti dalla pagina Amministrazione con un servizio Web a scelta.| -| Incidenti critici | Vieni avvisato degli incidenti critici sulla pagina Stato. Fai clic su **Supporto** > **Stato**. Puoi estendere la funzionalità di notifica impostando una sottoscrizione di notifica che invia un'e-mail a un destinatario di tua scelta. In alternativa, puoi impostare una sottoscrizione che utilizza dei webhook per integrare le notifiche provenienti dalla pagina Amministrazione con un servizio Web a scelta. | -| Eventi di soglia | Puoi impostare una sottoscrizione di notifica che invia un'e-mail a un destinatario di tua scelta quando nel tuo ambiente vengono raggiunte le soglie per la quota dell'organizzazione, il disco fisico, la memoria fisica o la memoria riservata. In alternativa, puoi impostare una sottoscrizione che utilizza dei webhook per integrare le notifiche con un servizio Web di tua scelta. | -| Stato di {{site.data.keyword.Bluemix_notm}} | In qualsiasi momento puoi visualizzare l'ultimo stato della piattaforma, dei servizi e della tua istanza {{site.data.keyword.Bluemix_notm}} nella pagina Stato. Fai clic su **Supporto** > **Stato**. | -{: caption="Table 2. Event types and notifications methods" caption-side="top"} - -### Impostazione di sottoscrizioni di notifica -{: #seteventsub} - -Puoi estendere la funzionalità delle notifiche inviate alla pagina Amministrazione e alla pagina Stato, utilizzando le sottoscrizioni di notifica. Utilizza le sottoscrizioni di notifica per configurare un'e-mail personalizzata o utilizzare dei webhook da integrare con uno strumento a scelta. - * Se selezioni l'opzione e-mail, le notifiche vengono inviate agli indirizzi e-mail da te specificati. Puoi selezionare le notifiche di incidenti, aggiornamenti di manutenzione o soglie. Viene inviata una notifica e-mail iniziale. Successivamente, ogni volta che l'evento subisce delle modifiche, viene inviata un'altra notifica con la modifica apportata. - * Se selezioni l'opzione webhook, le tue notifiche vengono indirizzate direttamente a una destinazione a scelta, ad esempio un numero di telefono (tramite messaggio SMS). Puoi personalizzare il tipo di notifica, in particolare gli aggiornamenti di manutenzione, gli avvisi di incidenti critici e le soglie. Puoi scegliere se ricevere nuove notifiche oppure notifiche sulle modifiche apportate alle sottoscrizioni e puoi indicare quali informazioni includere nel corpo di ogni notifica. - -**Nota**: solo gli utenti con autorizzazione Superuser (`ops.admin`) possono impostare le sottoscrizioni di notifica. - -Per creare una sottoscrizione webhook o e-mail dalla pagina **Sottoscrizioni di notifica**, completa la seguente procedura: - -1. Passa alla pagina **Sottoscrizioni di notifica**. Vai a **INFORMAZIONI DI SISTEMA> Ambiente > Sottoscrizioni**. -2. Fai clic su **Aggiungi sottoscrizione**. -3. Completa il modulo di sottoscrizione di notifica. - - * Per creare sottoscrizioni di notifica e-mail per gli aggiornamenti di manutenzione o gli incidenti, vedi le informazioni nella [Tabella 3](index.html#emailnotmaintinc). - * Per creare sottoscrizioni di notifica e-mail per le soglie, vedi le informazioni nella [Tabella 4](index.html#emailnottrhesh). - * Per creare sottoscrizioni di notifica webhook per gli aggiornamenti di manutenzione o gli incidenti, vedi le informazioni nella [Tabella 5](index.html#webhooknotsub). - * Per creare sottoscrizioni di notifica webhook per le soglie, vedi le informazioni nella [Tabella 6](index.html#webhooknotthresh). - -4. Una volta completato il modulo, puoi scegliere tra le seguenti opzioni: - - * Fai clic su **Salva** per salvare la sottoscrizione nel tuo elenco di sottoscrizioni di notifica. - * Fare clic su **Salva e verifica** per salvare e verificare la notifica. - * Fai clic su **Salva e chiudi** per salvare la sottoscrizione nel tuo elenco di sottoscrizioni di notifica e tornare alla pagina precedente. - -{: #emailnotmaintinc} - -| **Campo** | **Descrizione** | -|-----------------|-------------------| -| Abilitato | Seleziona questa opzione per abilitare le notifiche e-mail. Deselezionare l'opzione per disabilitare la notifica e-mail. Le sottoscrizioni sono abilitate per impostazione predefinita. | -| Tipo | Seleziona **E-mail**. | -| Evento | Seleziona l'opzione per sottoscrivere le notifiche di un evento di **Manutenzione** o **Incidente**. | -| Combina notifiche | Seleziona l'opzione per combinare le notifiche di incidente di tutte le regioni in una singola notifica. Questa opzione è disponibile solo per gli incidenti. | -| Oggetto | Compila la riga oggetto dell'e-mail. Questo campo è obbligatorio. | -| Corpo | Immetti il testo del corpo del messaggio da inviare nell'e-mail. Puoi utilizzare i valori payload IBM per inserire nella notifica e-mail informazioni pertinenti. Vedi la tabella [Valori della sezione di payload di manutenzione e incidenti](index.html#payload) per identificare i valori utilizzabili. Utilizza tag HTML di base per strutturare l'e-mail. Questo campo è obbligatorio. | -| A: | Immetti uno o più indirizzi e-mail tramite elenco separato da virgole per indicare i destinatari della notifica e-mail. Espandi le opzioni "cc" o "bcc" per inviare copia dell'e-mail ad altri destinatari. Questo campo è obbligatorio. | -| Descrizione | Aggiungi una descrizione univoca della sottoscrizione e stai creando. | -{: caption="Table 3. Fields for email notification subscriptions about thresholds" caption-side="top"} - - -{: #emailnottrhesh} - -| **Campo** | **Descrizione** | -|-----------------|-------------------| -| Abilitato | Seleziona questa opzione per abilitare le notifiche e-mail. Deselezionare l'opzione per disabilitare la notifica e-mail. Le sottoscrizioni sono abilitate per impostazione predefinita. | -| Tipo | Seleziona **E-mail**. | -| Evento | Seleziona **Soglia**. | -| Soglia | Seleziona il tipo di soglia per cui ricevere una notifica: Quota organizzazione, Disco fisico, Memoria fisica, Disco riservato o Memoria riservata. | -| Direzione soglia | Seleziona la direzione in cui spostare i dati, in ordine crescente o decrescente, quando si supera il valore Notifica quando incrociato che hai impostato. Ad esempio, se il valore di Notifica quando incrociato è 50%, e la direzione è decrescente, riceverai una notifica solo se la percentuale di utilizzo va da più di 50% a meno di 50%. Se imposti la direzione su Crescente, riceverai una notifica quando la percentuale di utilizzo va da meno di 50% a più di 50%. | -| Notifica quando incrociato superiore a (%) | Immetti la percentuale di soglia per cui ricevere una notifica. Se nel campo Direzione soglia hai scelto la proprietà Crescente, la notifica e-mail viene inviata quando la soglia supera questa percentuale. | -| Notifica quando incrociato inferiore a (%) | Immetti la percentuale di soglia per cui ricevere una notifica. Se nel campo Direzione soglia hai scelto la proprietà Decrescente, la notifica e-mail viene inviata quando la soglia scende sotto questa percentuale. | -| Descrizione | Aggiungi una descrizione univoca della sottoscrizione e stai creando. | -| Oggetto | Compila la riga oggetto dell'e-mail. Questo campo è obbligatorio. | -| Corpo del messaggio | Immetti il testo del corpo del messaggio da inviare nell'e-mail. Puoi utilizzare i valori payload IBM per inserire nella notifica e-mail informazioni pertinenti. Vedi la tabella [Valori della sezione di payload di soglia](index.html#threshpayload) per identificare i valori utilizzabili. Utilizza tag HTML di base per strutturare l'e-mail. Questo campo è obbligatorio. | -| A: | Immetti uno o più indirizzi e-mail tramite elenco separato da virgole per indicare i destinatari della notifica e-mail. Espandi le opzioni "cc" o "bcc" per inviare copia dell'e-mail ad altri destinatari. Questo campo è obbligatorio. | -{: caption="Table 4. Fields for email notification subscriptions about maintenance updates or incidents" caption-side="top"} - -I dati della soglia vengono raccolti una volta ogni 6 ore. Una notifica viene inviata solo una volta quando il valore supera il valore soglia impostato. Se hai scelto la proprietà crescente, non viene inviata una nuova notifica a meno che il valore non scenda sotto la soglia e quindi la oltrepassi nuovamente. Allo stesso modo, se hai scelto la proprietà decrescente, ricevi una notifica solo se il valore supera la soglia impostata e quindi scende di nuovo sotto la soglia. - -Se non vuoi aspettare 6 ore per ricevere la notifica sul raggiungimento della soglia, dopo aver completato i campi nel modulo, puoi fare clic su **Salva e verifica** per ricevere una notifica di verifica con i dati di esempio. - -Una notifica per la soglia della Quota organizzazione include solo le organizzazioni che hanno superato la percentuale di soglia specificata nel periodo di tempo di 6 ore corrispondente a tale notifica. Le organizzazioni che hanno superato una soglia durante intervalli di 6 ore precedenti non verranno incluse, anche se rimangono sopra o sotto la soglia. Le tre risorse che compongono la quota di un'organizzazione (memoria riservata, servizi e rotte) vengono considerate separatamente quando si deve valutare se inviare una notifica sulla quota. Ad esempio, se la quantità di memoria riservata utilizzata da un'organizzazione supera il 50% della quota, una soglia della Quota organizzazione configurata con un valore di 50% comporterà l'invio di una notifica. Se il numero di servizi utilizzati dalla stessa organizzazione supera successivamente il 50% della quota, anche se la quantità di memoria utilizzata rimane invariata, la stessa sottoscrizione di soglia della Quota dell'organizzazione comporterà anch'essa l'invio di una notifica. - -{: #webhooknotsub} - -| **Campo** | **Descrizione** | -|-----------------|-------------------| -| Abilitato | Seleziona l'opzione per abilitare la notifica. Deselezionare l'opzione per disabilitare la notifica. Le sottoscrizioni sono abilitate per impostazione predefinita. | -| Tipo | Seleziona **Webhook** | -| Evento | Seleziona l'opzione per sottoscrivere le notifiche di un evento di **Manutenzione** o **Incidente**. | -| Autorizzazione | Scegli se abilitare l'autorizzazione. Le opzioni sono: **Di base** o **Nessuna**. | -| Nome utente | Se hai scelto l'autorizzazione **Di base**, immetti il tuo nome utente per il servizio Web. Se non desideri utilizzare le tue credenziali personali, puoi impostare un ID funzionale da utilizzare specificatamente con {{site.data.keyword.Bluemix_notm}}. | -| Password | Se hai scelto l'autorizzazione **Di base**, immetti la tua password per il servizio Web. | -| Descrizione | Aggiungi una descrizione univoca della sottoscrizione e stai creando. | -| Nuovo evento | Seleziona questa opzione per abilitare la notifica per i nuovi eventi di manutenzione o incidente. Deselezionare l'opzione per disabilitare la notifica. | -| Metodo | Seleziona **GET**, **POST** o **PUT**. | -| URL | Immetti l'URL per la connessione al tuo servizio Web. | -| Proprietà di risposta | Questo campo facoltativo è il nome della proprietà che identifica la risorsa creata dal tuo servizio Web quando viene inviata una richiesta POST o PUT. Se fornisci una proprietà di risposta per un nuovo evento e scegli di creare una sottoscrizione per le modifiche a un evento, dovrai fornirla anche per la sottoscrizione Modifica all'evento. A seconda del servizio Web utilizzato, puoi specificarla come parte dell'URL o come valore di payload. | -| Payload | Se hai selezionato il metodo POST o PUT, immetti le proprietà specifiche del servizio Web che stai utilizzando insieme i valori di payload utilizzati per la notifica IBM. Vedi la tabella [Valori della sezione di payload di manutenzione e incidenti](index.html#payload) per identificare i valori utilizzabili. Se non immetti informazioni in questa sezione, ricevi una notifica che non contiene informazioni aggiuntive. | -| Modifica all'evento | Seleziona questa opzione per creare sottoscrizioni di notifica relative alle modifiche agli eventi di manutenzione o incidenti per cui hai creato le sottoscrizioni. Deselezionare l'opzione per disabilitare la notifica. | -| Utilizza valori e payload da Nuovo evento | Usa il contenuto del campi Metodo, URL e Payload della sezione Nuovo evento. Nota che se l'opzione è selezionata, questi campi non sono disponibili per ulteriori modifiche nella sezione Modifica all'evento. | -| Metodo | Seleziona **GET**, **POST** o **PUT**. | -| URL | Immetti l'URL per la connessione al tuo servizio Web. | -| Payload | Se hai selezionato il metodo POST o PUT, immetti le proprietà specifiche del servizio Web che stai utilizzando insieme i valori di payload utilizzati per la notifica IBM. Vedi la tabella [Valori della sezione di payload di manutenzione e incidenti](index.html#payload) per identificare i valori utilizzabili. Se non immetti informazioni in questa sezione, ricevi una notifica che non contiene informazioni aggiuntive. | -| Combina notifiche | Seleziona l'opzione per combinare le notifiche di incidente di tutte le regioni in una singola notifica. Questa opzione è disponibile solo per gli incidenti. | -{: caption="Table 5. Form fields for a webhook notification subscription about maintenance or incidents" caption-side="top"} - - -{: #webhooknotthresh} - -| **Campo** | **Descrizione** | -|-----------------|-------------------| -| Abilitato | Seleziona l'opzione per abilitare la notifica. Deselezionare l'opzione per disabilitare la notifica. Le sottoscrizioni sono abilitate per impostazione predefinita. | -| Tipo | Seleziona **Webhook**. | -| Evento | Seleziona **Soglia**. | -| Soglia | Seleziona il tipo di soglia per cui ricevere una notifica: Quota organizzazione, Disco fisico, Memoria fisica, Disco riservato o Memoria riservata.| -| Direzione soglia | Scegli se visualizzare i dati di soglia in ordine crescente o decrescente. | -| Notifica quando incrociato inferiore a (%) | Se hai selezionato la **Direzione di soglia** **Decrescente**, immetti la percentuale di soglia per cui ricevere una notifica. Quando la soglia scende sotto questa percentuale, viene inviata una notifica webhook. | -| Notifica quando incrociato superiore a (%) | Se hai selezionato la **Direzione di soglia** **Crescente**, immetti la percentuale di soglia per cui ricevere una notifica. Quando la soglia supera questa percentuale, viene inviata una notifica webhook. | -| Descrizione | Aggiungi una descrizione univoca della sottoscrizione e stai creando. | -| Autorizzazione | Scegli se abilitare l'autorizzazione. Le opzioni sono: **Di base** o **Nessuna**. | -| Nome utente | Se hai scelto l'autorizzazione di base, immetti il tuo nome utente per il servizio Web. Se non desideri utilizzare le tue credenziali personali, puoi impostare un ID funzionale da utilizzare specificatamente con {{site.data.keyword.Bluemix_notm}}. | -| Password | Se hai scelto l'autorizzazione di base, immetti la tua password per il servizio Web. | -| Metodo | Seleziona **GET**, **POST** o **PUT**. | -| URL | Immetti l'URL per la connessione al tuo servizio Web. | -{: caption="Table 6. Form fields for a webhook notification subscription about thresholds" caption-side="top"} - -I dati della soglia vengono raccolti una volta ogni 6 ore. Una notifica viene inviata solo una volta quando il valore supera il valore soglia impostato. Non viene inviata una nuova notifica a meno che il valore non vada al di sotto della soglia (se hai scelto la proprietà crescente) e quindi la risuperi nuovamente. Allo stesso modo, se hai scelto la proprietà decrescente, ricevi una nuova una notifica se il valore supera la soglia impostata e quindi scende di nuovo sotto la soglia. - -Se non vuoi aspettare 6 ore per ricevere la notifica sul raggiungimento della soglia, dopo aver completato i campi nel modulo, puoi fare clic su **Salva e verifica** per salvare e verificare la notifica con i dati di esempio. - -Una notifica per la soglia della Quota organizzazione include solo le organizzazioni che hanno superato la percentuale di soglia specificata nel periodo di tempo di 6 ore corrispondente a tale notifica. Le organizzazioni che hanno superato una soglia durante intervalli di 6 ore precedenti non verranno incluse, anche se rimangono sopra o sotto la soglia. Le tre risorse che compongono la quota di un'organizzazione, ossia memoria riservata, servizi e rotte, vengono considerate separatamente quando si deve valutare se inviare una notifica sulla quota. Ad esempio, se la quantità di memoria riservata utilizzata da un'organizzazione supera il 50% della quota, una soglia della Quota organizzazione configurata con un valore di 50% comporterà l'invio di una notifica. Se il numero di servizi utilizzati dalla stessa organizzazione supera successivamente il 50% della quota, anche se la quantità di memoria utilizzata rimane invariata, la stessa sottoscrizione di soglia della Quota dell'organizzazione comporterà anch'essa l'invio di una notifica. - -{: #payload} - -| **Valore IBM** | **Descrizione** | **Tipo di evento** | -|----------------|----------------|------------------------| -| {{content.category}} | Servizi interessati | Incidente | -| {{content.disruption}} | Componenti interessati | Aggiornamento di manutenzione | -| {{content.message}} | Descrizione del messaggio | Aggiornamento di manutenzione e incidente | -| {{content.scheduleWindow.start}} | Data di inizio pianificata per l'aggiornamento | Aggiornamento di manutenzione | -| {{content.scheduleWindow.end}} | Ora di fine pianificata per l'aggiornamento | Aggiornamento di manutenzione | -| {{content.severity}} | Classificazione della severità | Incidente | -| {{content.subCategoryName}} | Componenti interessati | Incidente | -| {{content.title}} | Titolo del messaggio | Aggiornamento di manutenzione e incidente | -| {{region}} | Regione interessata | Aggiornamento di manutenzione e incidente | -| {{status}} | Stato dell'aggiornamento | Aggiornamento di manutenzione | -| {{type}} | Aggiornamento o incidente | Aggiornamento di manutenzione e incidente | -{: caption="Table 7. Maintenance and incident payload section values" caption-side="top"} - - -{: #threshpayload} - -| **Valore IBM** | **Descrizione** | **Tipo di evento** | -|----------------|----------------|------------------------| -| {{content.org_quota}} | Soglia quota organizzazione | Soglia | -| {{content.physical_disk}} | Soglia disco fisico | Soglia | -| {{content.physical_memory}} | Soglia memoria fisica | Soglia | -| {{content.reserved_disk}} | Soglia disco riservato | Soglia | -| {{content.reserved_memory}} | Soglia memoria riservata | Soglia | -{: caption="Table 8. Threshold payload section values" caption-side="top"} - -Quando salvi la tua sottoscrizione di notifica, ricevi notifiche attraverso il metodo che hai impostato. Le notifiche vengono ancora pubblicate nelle seguenti posizioni: - * Nella pagina Stato per gli incidenti - * Nella pagina Stato per gli eventi di aggiornamento della manutenzione pianificata con interruzioni del servizio - * Nell'area Notifica della pagina Amministrazione per gli aggiornamenti di manutenzione - -Puoi selezionare qualsiasi sottoscrizione di notifica salvata, visualizzare le attività recenti o modificarle come necessario. Fai clic per espandere qualsiasi voce delle attività recenti per visualizzare i dettagli della cronologia. - -## Aggiornamenti di manutenzione -{: #oc_schedulemaintenance} - -Puoi visualizzare gli aggiornamenti di manutenzione pianificata e in sospeso solo se disponi dell'autorizzazione superuser (`ops.admin`), facendo clic su **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso** per accedere alla pagina **Aggiornamenti di sistema**. Tutti gli utenti del tuo ambiente possono visualizzare gli eventi di aggiornamento della manutenzione pianificata con interruzioni del servizio facendo clic su **Supporto** > **Stato**. - -**Nota**: consultare la seguente sezione per [Impostazione di finestre di manutenzione preapprovate](index.html#preapprovedmaintenance). Queste finestre devono essere impostate per consentire a IBM di pianificare la manutenzione per il tuo ambiente. - -
-
Aggiornamenti che non comportano interruzioni del servizio
-
Un aggiornamento che non comporta interruzioni del servizio non influenza il tuo ambiente, le tue applicazioni in esecuzione o l'accesso dei tuoi utenti alle tue applicazioni. Questo tipo di aggiornamento non richiede un'approvazione caso per caso e verrà applicato durante le finestre di manutenzione disponibili preapprovate da te impostate dalla pagina Aggiornamenti di sistema.
-
Aggiornamenti che comportano interruzioni del servizio
-
Un aggiornamento che comporta interruzioni del servizio può influenzare il tuo ambiente, le applicazioni in esecuzione o l'accesso dei tuoi utenti alle tue applicazioni. Devi pianificare e approvare ciascuno di questi aggiornamenti di manutenzione entro la finestra di manutenzione di 21 giorni assegnata. Puoi selezionare l'ora e la data di distribuzione suggerita, l'opzione per qualsiasi finestra preapprovata da te oppure aprire il calendario per selezionare tre date/ore specifiche tra cui IBM può scegliere durante la pianificazione dell'aggiornamento.
-
- - -### Impostazione delle finestre di manutenzione preapprovate -{: #preapprovedmaintenance} - -Gli aggiornamenti di manutenzione che non comportano interruzioni del servizio sono pianificati per essere eseguiti durante finestre temporali preapprovate. Per impostazione predefinita, vengono create due finestre di aggiornamenti disponibili settimanali per il tuo sistema. Queste finestre sono in genere impostate per ripetersi ogni sabato e domenica sera. Puoi modificare le impostazioni predefinite in uno dei seguenti modi: - * Modifica le finestre di aggiornamento predefinite scegliendo un giorno e/o un'ora di inizio differenti. - * Crea una finestra di aggiornamento e quindi elimina la finestra predefinita - -Per salvare le modifiche, devi comunque rispettare il periodo di tempo minimo richiesto per ogni settimana. - -Devi impostare un minimo di 12 ore disponibili in una settimana per un periodo minimo di due giorni per ogni settimana. Ad esempio, puoi impostare finestre temporali di sei ore in due giorni distinti o puoi impostare finestre di quattro ore in tre giorni diversi. Per accertarti che le finestre temporali siano sufficienti per consentire l'applicazione di un aggiornamento, la durata minima di ciascuna finestra deve essere pari a 4 ore. - -**Nota**: solo gli utenti con autorizzazione Superuser (`ops.admin`) possono pianificare e approvare gli aggiornamenti di manutenzione. - -1. Vai a **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso > Gestisci disponibilità**. -2. Espandi la sezione **Gestisci finestre di aggiornamento disponibili**. -3. Fai clic su **Aggiungi nuovo** ![Aggiungi nuovo](images/add-new.png). -4. Imposta la prima finestra di disponibilità selezionando la frequenza, la durata e l'ora di inizio per la finestra. -5. Facoltativo: seleziona **Contrassegna come preferito**, se vuoi impostare la tua finestra di disponibilità ricorrente come orario preferito per le distribuzioni da pianificare. Le finestre temporali preferiti avranno la priorità, laddove possibile. -6. Fai clic su **Inoltra**. -7. Ripeti questo processo finché non hai soddisfatto i requisiti minimi per le finestre temporali settimanali. - -### Impostazione delle finestre di manutenzione non disponibili -{: #blockpreapprovedmaintenance} - -Puoi scegliere di impostare specifiche finestre di aggiornamento non disponibili in cui il tuo ambiente non sarà disponibile per gli aggiornamenti di manutenzione che non comportano interruzioni del servizio. Ad esempio, puoi scegliere un fine settimana o una vacanza ad alto traffico in cui non applicare alcuna manutenzione per garantire che le tue applicazioni siano disponibili ai tuoi utenti. - -Devi impostare un minimo di 12 ore disponibili in una settimana per un periodo minimo di due giorni per ogni settimana. Se tenti di creare una finestra di aggiornamento non disponibile, potresti non riuscire a salvare le modifiche qualora questa nuova finestra faccia sì che il sistema scenda al di sotto del minimo settimanale richiesto. In questo caso, devi prima rimuovere alcune finestre di aggiornamento non disponibili esistenti o aggiungerne delle altre prima di poter salvare la nuova finestra di aggiornamento non disponibile. Per ulteriori informazioni, vedi [Impostazione delle finestre di manutenzione preapprovate](index.html#preapprovedmaintenance). - -1. Vai a **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso > Gestisci disponibilità**. -2. Espandi la sezione **Gestisci finestre di aggiornamento non disponibili**. -3. Fai clic su **Aggiungi nuovo** ![Aggiungi nuovo](images/add-new.png). -4. Imposta la tua finestra non disponibile selezionando la frequenza, la durata e l'ora di inizio per la finestra. -5. Fai clic su **Inoltra**. - -### Pianificazione e approvazione di aggiornamenti -{: #scheduleandapprove} - -Dopo che hai impostato le tue finestre di manutenzione preapprovate, gli aggiornamenti che non comportano interruzioni del servizio verranno automaticamente pianificati durante questi periodi. Per questi tipi di aggiornamenti non è richiesta la tua approvazione esplicita. Puoi tuttavia visualizzare i dettagli per ciascun aggiornamento di manutenzione, compresa l'indicazione di cosa si sta aggiornando, quanto ci vorrà per l'aggiornamento e quando esso è pianificato. - -Per visualizzare i dettagli per un aggiornamento che non comporta l'interruzione del servizio, completa la seguente procedura: - -1. Vai a **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso** -2. Identifica le righe in cui **Pianificazione cliente obbligatoria** è impostato su **No**. -3. Seleziona la riga per l'aggiornamento di cui visualizzare i dettagli. - -Un aggiornamento che comporta interruzioni del servizio può influenzare il tuo ambiente, le applicazioni in esecuzione o l'accesso dei tuoi utenti alle tue applicazioni. Devi pianificare e approvare ciascuno di questi aggiornamenti di manutenzione entro la finestra di manutenzione di 21 giorni assegnata. Puoi selezionare l'ora e la data di distribuzione suggerita, l'opzione per qualsiasi finestra preapprovata da te oppure aprire il calendario per selezionare tre date/ore specifiche tra cui IBM può scegliere durante la pianificazione dell'aggiornamento. - -Per gli aggiornamenti che comportano un'interruzione del servizio che richiedono la tua approvazione, completa la seguente procedura: - -1. Vai a **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso** -2. Identifica le righe in cui **Pianificazione cliente obbligatoria** è impostato su **Sì**. -3. Seleziona la riga per di un aggiornamento per esaminarne i dettagli, compresi la sua descrizione, la sua data e ora consigliata, i componenti interessati e la sua durata. -4. Seleziona **Pianifica e approva**. -5. Scegli una delle seguenti opzioni: **Data suggerita**, **Date alternative** o **Qualsiasi finestra preapprovata**. Se selezioni **Date alternative**, puoi aprire il calendario per selezionare tre opzioni tra cui può scegliere IBM. -6. Facoltativo: dall'elenco di date alternative selezionate nel calendario, seleziona quelle che desideri impostare come preferite per la distribuzione. Ogni data selezionata viene indicata come preferita per il deployer che pianificherà la distribuzione. IBM tenta di pianificare la manutenzione durante le finestre di aggiornamento preferite. -7. Quando hai finito, seleziona **Invia**. - -A seconda della tua selezione, l'aggiornamento viene pianificato in modo da essere distribuito durante la data suggerita che hai accettato, durante una delle tue finestre temporali preapprovate o in una delle date e ore specifiche che hai selezionato. Quando IBM pianifica la distribuzione dell'aggiornamento, la data prevista viene rispecchiata nei dettagli dell'aggiornamento, sulla pagina **Aggiornamenti di sistema**. Puoi ripianificare una distribuzione già pianificata solo un giorno (24 ore) prima della data e ora di inizio pianificata. Dopo aver ripianificato una distribuzione, non potrai ripianificarla di nuovo. - - -## Visualizzazione delle informazioni sul sistema -{: #oc_system} - -Per visualizzare le informazioni sul sistema, fai clic su **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA**. - -Puoi visualizzare diverse sezioni che includono aggiornamenti di sistema in sospeso, informazioni generali sul sistema, informazioni su API e CLI e -dettagli di configurazione LDAP. - -### Aggiornamenti di sistema in sospeso - -Nella sezione Aggiornamenti, puoi visualizzare il numero di notifiche di -aggiornamenti in sospeso che richiedono un tuo intervento. Ci sono due tipi che potresti vedere: - -
-
Aggiornamenti che non comportano interruzioni del servizio
-
Un aggiornamento che non comporta interruzioni del servizio non influenza il tuo ambiente, le tue applicazioni in esecuzione o l'accesso dei tuoi utenti alle tue applicazioni. Questo tipo di aggiornamento non richiede un'approvazione caso per caso. Questi aggiornamenti sono applicati nelle finestre di manutenzione disponibili preapprovate da te impostate dalla pagina Aggiornamenti di sistema.
-
Aggiornamenti che comportano interruzioni del servizio
-
Un aggiornamento che comporta interruzioni del servizio può influenzare il tuo ambiente, le applicazioni in esecuzione o l'accesso dei tuoi utenti alle tue applicazioni. Puoi pianificare e approvare ciascuno di questi aggiornamenti di manutenzione entro la finestra di manutenzione di 21 giorni assegnata per garantire che l'aggiornamento non venga applicato durante ore lavorative critiche. Puoi selezionare la data e ora di distribuzione consigliata, che si basa sulle tue finestre di aggiornamento preapprovate, oppure selezionare due ore e date aggiuntive tra cui IBM può scegliere durante l'applicazione dell'aggiornamento.
-
- -Per ulteriori informazioni sull'impostazione delle finestre di manutenzione preapprovate e sull'impostazione di specifiche date non disponibili per la manutenzione, vedi [Aggiornamenti di manutenzione](index.html#oc_schedulemaintenance). - -### Informazioni generali sul sistema - -Nella sezione di informazioni generali, puoi visualizzare le seguenti informazioni: - -- Le informazioni di base sulla build {{site.data.keyword.Bluemix_notm}}. -- Le informazioni sull'API, compresi versione, URL, regione e un link alla documentazione della CLI. -- Le informazioni sul dominio condiviso relative al tuo sistema e al tuo servizio. -- Le statistiche sul numero totale di applicazioni, utenti e organizzazioni. - -### Dettagli configurazione LDAP - -Nella sezione Dettagli di configurazione LDAP, puoi selezionare il server LDAP -e visualizzare le informazioni relative alle associazioni di utenti e gruppi. Se stai utilizzando un WebID {{site.data.keyword.IBM}}, questo viene indicato in questa sezione. - -## Visualizzazione di utilizzo e report -{: #oc_resource} - -Puoi visualizzare differenti tipi di informazioni sull'utilizzo della tua istanza locale o dedicata e sull'account {{site.data.keyword.Bluemix_notm}}. Puoi anche scaricare e visualizzare i report e i log di sicurezza per la tua istanza {{site.data.keyword.Bluemix_notm}}. - -- Informazioni sulle risorse, quali spazio su disco, utilizzo della CPU, utilizzo della rete e tempi medi di risposta. Vedi [Utilizzo risorsa](index.html#resourceusage). -- Utilizzo dell'account per organizzazione, incluso il numero di applicazioni di runtime con utilizzo, numero totale di GB-ore di runtime e numero di istanze di servizio con relativo utilizzo. Vedi [Utilizzo dell'account](index.html#accountusage). -- Utilizzo di quote di memoria, memoria dell'applicazione assegnata in base alla percentuale totale di memoria utilizzata e una vista sull'utilizzo di GB-ore per applicazione in relazione a un'organizzazione specifica. Puoi anche visualizzare l'utilizzo della quota per tutte le organizzazioni nella pagina Amministrazione della sezione **Monitoraggio quota**. Vedi [Amministrazione organizzazione](../admin/index.html#orgusage). - - -### Utilizzo delle risorse -{: #resourceusage} - -Per visualizzare le informazioni sull'utilizzo delle risorse, fai clic su **AMMINISTRAZIONE > Utilizzo risorsa**. - -Nella sezione **Utilizzo risorsa **, puoi visualizzare le seguenti informazioni: - -- Informazioni sull'utilizzo delle risorse, ad esempio la quantità di memoria e spazio su disco che può essere riservata e quella fisicamente disponibile e la quantità di memoria e spazio su disco realmente riservata e quella fisicamente utilizzata. Puoi anche visualizzare le informazioni relative all'utilizzo medio della CPU tra tutti gli agent DEA (Droplet Execution Agent). Per informazioni più dettagliate sull'utilizzo di memoria, disco e CPU, vedi [Dettagli memoria, disco e CPU](index.html#resourceusagedetails). -- Informazioni sull'utilizzo della rete per la larghezza di banda in entrata e in uscita nelle ultime 6 ore o nel giorno precedente. I dati visualizzati sono basati sulla somma del traffico in entrata e in uscita per la rete pubblica e quella privata. -- Il tempo di risposta medio per {{site.data.keyword.Bluemix_notm}} negli ultimi 10 minuti, 1 ora e 1 giorno. -- Le transazioni medie al secondo per {{site.data.keyword.Bluemix_notm}} nel corso degli ultimi 10 minuti, dell'ultima ora e dell'ultimo giorno. - -#### Dettagli memoria, disco e CPU -{: #resourceusagedetails} - -Nella sezione **Utilizzo risorsa**, puoi vedere un riepilogo dello spazio **Riservato** e **Fisico** relativo a memoria e disco. -
-
Fisico
-
La quantità di memoria o spazio su disco che è stata acquistata per il tuo ambiente.
-
Riservato
-
La quantità totale di memoria o spazio su disco disponibile che può essere riservata da tutte le applicazioni distribuite e in esecuzione nel tuo ambiente. Poiché le applicazioni raramente utilizzano tutta la memoria riservata per loro, il valore fisico è di solito inferiore al valore riservato.
-
- -Oltre alla rappresentazione grafica, puoi visualizzare la percentuale di memoria e spazio su disco utilizzata dal tuo ambiente. Puoi anche visualizzare la quantità riservata e fisica, in GB, dell'utilizzo reale rispetto alla quantità disponibile. - -Per visualizzare l'utilizzo della memoria, disco o CPU da parte di DEA, fai clic su **Suddivisione**. - -Per informazioni più dettagliate sull'utilizzo della memoria o del disco fisico e riservato nel tempo, fai clic su **Cronologia.** Puoi specificare l'intervallo di tempo da visualizzare come settimanale o mensile. La vista dell'utilizzo cronologico mostra un grafico di utilizzo della memoria o del disco nel corso del tempo da te scelto. -
-
Limite riservato
-
Indicato in forma di linea tratteggiata orizzontale, il limite riservato è la quantità totale di memoria o spazio su disco che può essere riservata in blocco da tutte le applicazioni in esecuzione nel tuo ambiente.
-
Riservato
-
L'area Riservato mostra la quantità di memoria o di spazio su disco che è attualmente riservata in blocco da tutte le applicazioni in esecuzione nel tuo ambiente. -

Per vedere quali organizzazioni hanno riservato la maggior parte della memoria in un determinato momento, passa il mouse sopra il punto lungo l'area Riservato associato a quel momento nel tempo. Puoi quindi fare clic su un'organizzazione nel grafico a torta che viene mostrato per visualizzare ulteriori informazioni su tale organizzazione.

-
Limite fisico
-
Indicato in forma di linea tratteggiata orizzontale, il limite fisico mostra la quantità fisica di memoria o spazio su disco che è stata acquistata per il tuo ambiente.
-
Fisico
-
L'area Fisico mostra la quantità di memoria o spazio su disco effettivamente utilizzata.
-
- - -### Utilizzo dell'account -{: #accountusage} - -Puoi visualizzare l'utilizzo mensile del tuo account per il tuo ambiente locale o dedicato. Puoi utilizzare questi dati per sapere quanto addebitare a determinate organizzazioni in base all'uso effettuato. Tutti gli utenti della console di gestione che dispongono dell'autorizzazione **Utenti** con accesso in **Lettura** possono visualizzare i dati di utilizzo dell'account. Inoltre, i gestori di fatturazione dell'organizzazione possono visualizzare i dati di utilizzo account relativi alle proprie organizzazioni, anche se il gestore di fatturazione non dispone dell'autorizzazione **Utenti** della console di gestione. In qualità di amministratore della console di gestione (autorizzazione Superuser), puoi assegnare il ruolo di gestore di fatturazione per le organizzazioni facendo clic su **Account** > **Gestisci organizzazioni**. - -Per visualizzare i dati di utilizzo account, completa la seguente procedura: - -
    -
  1. Fai clic su Account > Dashboard di utilizzo.
    2. -
  2. Seleziona l'organizzazione per cui desideri visualizzare i dati.
    3. -
  3. Puoi vedere i dettagli di utilizzo per le seguenti categorie: -
      -
    • Applicazioni di runtime con utilizzo
      • -
    • Utilizzo totale delle applicazioni di runtime in GB-ore
      • -
    • Istanze di servizio con utilizzo
      • -
    -
    4. -
  4. Facoltativo: visualizza i tuoi dati per un mese specifico, utilizzando il menu La tua attività cloud per selezionare un mese a scelta.
    5. -
  5. Facoltativo: fai clic su ESPORTA DATI e scegli tra CSV o JSON per esportare i dati per il mese selezionato in un file CSV o JSON.
    6. -
- -Puoi anche visualizzare l'utilizzo mensile e gli addebiti associati a livello di account per i tuoi runtime, applicazioni e servizi diffusi da {{site.data.keyword.Bluemix_notm}} pubblico. Puoi utilizzare questi dati per sapere quanto addebitare a determinate organizzazioni in base all'uso effettuato. - -
    -
  1. Fai clic su Account > Dashboard di utilizzo.
    2. -
  2. Fai clic su Pubblico.
    3. -
  3. Seleziona l'organizzazione per cui desideri visualizzare i dati.
    4. -
  4. Puoi vedere i dettagli di utilizzo per le seguenti categorie: -
      -
    • Applicazioni di runtime con utilizzo
      • -
    • Utilizzo totale delle applicazioni di runtime in GB-ore
      • -
    • Istanze di servizio con utilizzo
      • -
    • Riepilogo degli addebiti per tutte le applicazioni, i servizi e i runtime diffusi
      • -
    -
    5. -
  5. Facoltativo: visualizza i tuoi dati per un mese specifico, selezionando un mese a scelta dal grafico a barre. Per impostazione standard vengono visualizzati i dati del mese corrente.
    6. -
  6. Facoltativo: fai clic su ESPORTA DATI e scegli tra CSV o JSON per esportare i dati per il mese selezionato in un file CSV o JSON.
    7. -
- - -### Utilizzo delle organizzazioni -{: #orgusage} - -Per visualizzare l'utilizzo per organizzazione, fai clic su **AMMINISTRAZIONE > AMMINISTRAZIONE ORGANIZZAZIONE**, quindi seleziona un'organizzazione dall'**Elenco delle organizzazioni**. Nella pagina **Gestisci organizzazioni** dell'organizzazione selezionata, puoi visualizzare le seguenti informazioni sull'utilizzo: - -- Numero di servizi attualmente in uso. -- Numero di rotte attualmente in uso. -- Grafico delle quote di memoria che mostra le percentuali di quota di memoria attualmente in uso e non in uso. -- Grafico sull'assegnazione delle applicazioni che mostra quali applicazioni sono incluse nella quota di memoria utilizzata. -- Grafico sull'utilizzo misurato dell'applicazione che mostra un report trimestrale sulle GB-ore utilizzate per applicazione distribuita. Puoi selezionare la **Vista elenco** per visualizzare i dati per tutte le applicazioni, compresa l'assegnazione di memoria per applicazione e l'utilizzo a consumo di GB-ore degli ultimi tre mesi. - -Per ulteriori informazioni sulla visualizzazione dell'utilizzo per organizzazione, sull'adeguamento dei piani di quota e sulla gestione delle tue organizzazioni, vedi [Amministrazione delle organizzazioni](../admin/index.html#oc_organizations). - -### Report -{: #oc_report} - -Puoi visualizzare i report e i log di sicurezza, quali DataPower™, firewall e controllo accessi, per la tua istanza {{site.data.keyword.Bluemix_notm}}. Per visualizzare report e log, fai clic su **AMMINISTRAZIONE > REPORT E LOG**. - -Seleziona dalle seguenti opzioni: - -- Puoi selezionare le date di inizio e di fine dai campi per filtrare i report e i log da -visualizzare. -- Puoi espandere e visualizzare i diversi report dal riquadro di navigazione. -- Puoi effettuare ricerche nella tua raccolta di report e log. La ricerca si applica ai nomi di report e al contenuto testuale -all'interno di report e log. Puoi anche scegliere di filtrare la ricerca in base -agli **Eventi di amministrazione**, ai **Report DataPower**, al **Firewall** e al **Controllo accessi**. -- Durante la visualizzazione di un report o log, puoi fare clic sull'icona ![Download](images/icon_download.png) -per scaricare il report. - -La seguente tabella mostra l'elenco dei report di sicurezza generati per {{site.data.keyword.Bluemix_notm}} locale e {{site.data.keyword.Bluemix_notm}} dedicato. La maggior parte dei report viene generata ogni giorno. Tuttavia, i report per gli eventi di gestione chiavi e crittografia vengono generati mensilmente. Tutti i report vengono conservati per 90 giorni nella console di gestione. Al termine dei 90 giorni, i report sono disponibili offline su richiesta a {{site.data.keyword.Bluemix_notm}} per 9 mesi. In totale, i report sono disponibili per il recupero per un massimo di 1 anno. - - -{: #ld_table9} - -| **Categoria** | **Report** | **Descrizione** | -|-----------------|-------------------|---------------------| -| Firewall | Accessi firewall | Eventi relativi all'accesso dell'amministratore ai dispositivi firewall Vyatta. | -| Firewall | Accessi firewall negati | Eventi generati da dispositivi firewall Vyatta quando una richiesta di accesso viene negata in base alle regole firewall in vigore. | -| Eventi di accesso dell'amministratore {{site.data.keyword.Bluemix_notm}} | Accesso amministratori {{site.data.keyword.Bluemix_notm}} | Eventi generati dal sistema operativo quando un amministratore avvia una sessione SSH su ogni sistema {{site.data.keyword.Bluemix_notm}}. | -| Eventi di accesso dello sviluppatore di applicazioni {{site.data.keyword.Bluemix_notm}} | Accesso sviluppatori di applicazioni {{site.data.keyword.Bluemix_notm}} | Eventi generati dal componente di accesso della piattaforma {{site.data.keyword.Bluemix_notm}} quando un utente di {{site.data.keyword.Bluemix_notm}} avvia una sessione utilizzando la riga comandi, le API REST o l'interfaccia utente {{site.data.keyword.Bluemix_notm}}. | -| Eventi amministrativi dell'amministratore {{site.data.keyword.Bluemix_notm}} | Eventi amministrativi di sistema operativo degli amministratori {{site.data.keyword.Bluemix_notm}} | Eventi generati dal sistema operativo quando un amministratore svolge un'azione all'interno di una sessione di lavoro corrente. | -| Eventi amministrativi dello sviluppatore di applicazioni {{site.data.keyword.Bluemix_notm}} | Eventi amministrativi {{site.data.keyword.Bluemix_notm}} (Cloud Foundry) | Eventi relativi alle operazioni effettuate dall'utente della piattaforma {{site.data.keyword.Bluemix_notm}} utilizzando la riga comandi, le API REST o l'interfaccia utente {{site.data.keyword.Bluemix_notm}}. | -| Eventi amministrativi di database dell'amministratore {{site.data.keyword.Bluemix_notm}} | Eventi amministrativi di database | Eventi relativi alle operazioni effettuate da un amministratore di database nei database interni {{site.data.keyword.Bluemix_notm}}. | -| Eventi di amministrazione | Eventi di gestione utente | Eventi relativi alle azioni di gestione utente eseguite nella pagina Amministrazione. | -| Eventi di amministrazione | Catalogo | Eventi relativi alle modifiche del catalogo dei servizi. | -| Eventi di amministrazione | Eventi di gestione dei report di sicurezza | Eventi relativi alle azioni di gestione dei report di sicurezza eseguite nella pagina Amministrazione. | -| Revisioni accesso | Report di revisioni accesso | Revisioni per accessi privilegiati. | -| Gestione modifiche | Gestione delle modifiche del software | Attività di gestione delle modifiche. | -| Gestione chiavi | Gestione dei certificati SSL personalizzati | Certificazioni SSL personalizzate che sono state caricate e archiviate. | -| Crittografia | Crittografia dei data-in-transit | Crittografia configurata per i data-in-transit. | -| Antivirus | Report di scansione antivirus | Software antivirus in uso. | -| Gestione delle correzioni software | Report di applicazione patch | Correzioni software applicate. | -| Gestione degli incidenti di sicurezza | Report di correzione incidenti di sicurezza | Prove di incidenti di sicurezza per consentirne la gestione. | -{: caption="Table 9. Security report list" caption-side="top"} - -## Visualizzazione dello stato -{: #oc_status} - -Puoi visualizzare lo stato per l'ambiente {{site.data.keyword.Bluemix_notm}} e per la console di gestione. - -### Stato dell'ambiente {{site.data.keyword.Bluemix_notm}} - -Puoi monitorare lo stato per la tua istanza {{site.data.keyword.Bluemix_notm}} utilizzando la pagina Stato di {{site.data.keyword.Bluemix_notm}}. Fai clic su **Supporto** > **Stato**. - -La pagina Stato è la posizione centrale per trovare notifiche e annunci sugli eventi chiave che interessano la piattaforma {{site.data.keyword.Bluemix_notm}} e i servizi principali in {{site.data.keyword.Bluemix_notm}}. Puoi sottoscrivere a un feed RSS per le notifiche in modo da non doverle controllare personalmente. Per ulteriori informazioni sulla pagina Stato e sulla configurazione del feed RSS, vedi [Visualizzazione di {{site.data.keyword.Bluemix_notm}}](../support/index.html#viewing-bluemix-status). - -### Stato della console di gestione - -Dopo la distribuzione iniziale del tuo ambiente {{site.data.keyword.Bluemix_notm}}, un controllo di verifica viene completato automaticamente sui componenti utilizzati per amministrare il tuo ambiente. Puoi andare alla pagina Controllo verifica console di gestione per controllare lo stato dei componenti dopo che è stato eseguito il controllo di verifica. Per accedere alla pagina, -vai a https://console.<dominiosecondario>.bluemix.net/check, dove `` è il nome della tua istanza locale o dedicata. - -Puoi eseguire una verifica in qualsiasi momento. Devi aver eseguito l'accesso per selezionare l'opzione per eseguire la verifica. Se riscontri dei malfunzionamenti mentre stai aggiungendo un utente, modificando un'organizzazione o gestendo i tuoi servizi, esegui questo controllo per identificare eventuali componenti malfunzionanti o disconnessi. Puoi aprire un ticket del supporto con le informazioni dal controllo per far risolvere rapidamente il problema. - -## Gestione del tuo catalogo -{: #oc_catalog} - -Puoi gestire quali servizi {{site.data.keyword.Bluemix_notm}} sono visibili agli utenti nel Catalogo {{site.data.keyword.Bluemix_notm}}. Fai clic su **AMMINISTRAZIONE > GESTIONE CATALOGO**. - -Seleziona un tile di servizio per modificare la visibilità del piano di servizio. Per modificare la -visibilità, seleziona dalle seguenti opzioni: - -- Per visualizzare il servizio nascosto in modo che sia visibile ai tuoi utenti nel -Catalogo, seleziona **ABILITA TUTTI I PIANI**. -- Per nascondere il servizio ai tuoi utenti nel Catalogo {{site.data.keyword.Bluemix_notm}}, -seleziona **DISABILITA TUTTI I PIANI**. -- Per controllare la visibilità di un singolo piano, seleziona il nome del piano e utilizza quindi -il menu a discesa per selezionare **Abilita per tutte le organizzazioni**, **Disabilita per -tutte le organizzazioni** o **Abilita piano per specifiche organizzazioni**. - - - -Puoi inoltre gestire l'ordine di priorità dei pacchetti di build disponibili da scegliere in base alla compatibilità, che i tuoi sviluppatori utilizzeranno durante la creazione di applicazioni. - -1. Vai a **AMMINISTRAZIONE> GESTIONE CATALOGO** -2. Vai alla sezione **Calcola**. -3. Seleziona **Priorità pacchetto di build**. -4. Seleziona l'opzione pacchetto di build a cui assegnare una priorità maggiore o minore nell'elenco. -5. Con l'opzione selezionata, utilizza le frecce per spostare l'opzione all'interno dell'elenco. - - - -### Registrazione di un broker dei servizi -{: #servicebrokerui} - -Se vuoi visualizzare un determinato servizio nel tuo catalogo {{site.data.keyword.Bluemix_notm}}, devi implementare e registrare un [broker dei servizi ![icona link esterno](../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/services/api.html){: new_window}. Una volta registrato il tuo broker, puoi scegliere quali organizzazioni possono accedere al servizio nella tua istanza locale o dedicata. - -Le modalità d'uso del tuo broker dei servizi variano a seconda del numero di servizi che gestisce o dalla sua eventuale precedente registrazione in {{site.data.keyword.Bluemix_notm}}. - -- Se il tuo broker dei servizi gestisce un unico servizio, puoi utilizzare l'interfaccia utente per registrarlo al termine dell'implementazione dell'[API broker dei servizi ![icona link esterno](../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/services/api.html){: new_window}. Vedi [Registrazione di un broker dei servizi che gestisce un unico servizio](index.html#registerbrokerui). -- Se il tuo broker dei servizi gestisce più servizi, utilizza la CLI cf con il plug-in [{{site.data.keyword.Bluemix_notm}} Admin CLI](../cli/plugins/bluemix_admin/index.html) (sottocomando `ba`) o l'[API del servizio personalizzato](index.html#servicebrokerapi). -- Se il tuo broker dei servizi è già registrato e desideri aggiornarlo o eliminarlo, utilizza la CLI cf con il plug-in [{{site.data.keyword.Bluemix_notm}} Admin CLI](../cli/plugins/bluemix_admin/index.html) (sottocomando `ba`) o l'[API del servizio personalizzato](index.html#servicebrokerapi). - -#### Registrazione di un broker dei servizi che gestisce un unico servizio -{: #registerbrokerui} - - - -Esamina le seguenti informazioni e completa la procedura per registrare il tuo broker dei servizi: - -**rima di iniziare**: implementa l'API broker dei servizi Cloud Foundry icona link esterno per consentire la comunicazione tra il tuo servizio e {{site.data.keyword.Bluemix_notm}}. L'API broker dei servizi è un insieme di endpoint REST utilizzati da {{site.data.keyword.Bluemix_notm}}. - -Quando implementi il broker dei servizi, nella risposta JSON di GET /v2/catalog devi fornire le definizioni per i tuoi piani di servizio e servizi, incluse le informazioni sul servizio che desideri visualizzare. Ad esempio, consulta il seguente file JSON di esempio della risposta del catalogo (GET): - -``` -{ -"services":[ - { - "bindable":true, - "description":"Cool Service è una soluzione di analisi e data warehousing.", - "id":"cool-service-id", - "name":"coolservice", - "metadata":{ - "displayName":"Cool Service", - "serviceMonitorApi":"https://myservicesstatus.mybluemix.net/healthcheck/", - "providerDisplayName":"Cool company", - "longDescription":"Cool Service è una soluzione di data warehousing e analisi. Puoi spostare rapidamente i tuoi dati in un database in-memoria a colonne di prossima generazione e iniziare ad eseguire query analitiche complesse.", - "bullets":[ - { - "title":"Rapido e semplice", - "description":"Cool Service utilizza innovazioni e tecnologia a colonne in memoria dinamiche, come l'elaborazione vettoriale parallela e una compressione su cui è possibile intervenire per eseguire rapidamente la scansione dei dati pertinenti ed eseguirne la restituzione." - }, - { - "title":"Connettività", - "description":"Cool Service è progettato per consentirti di connetterti facilmente a tutti i servizi e a tutte le applicazioni. Puoi iniziare immediatamente ad analizzare i tuoi dati con strumenti familiari." - } - ], - "featuredImageUrl":"http://path/to/icon_64x64.png", - "imageUrl":"http://path/to/icon_50x50.png", - "mediumImageUrl":"http://path/to/icon_32x32.png", - "smallImageUrl":"http://path/to/icon_24x24.png", - "documentationUrl":"http://path/to/documentation.html", - "instructionsUrl":"http://path/to/servicesample.md", - "termsUrl":"http://path/to/terms_of_agreement.pdf", - "media":[ - { - "type":"youtube", - "thumbnailUrl":"http://path/to/thumbnail.png", - "url":"http://path/to/youtube/video", - "caption":"Come usare Cool Service in 60 secondi" - }, - { - "type":"image", - "thumbnailUrl":"http://path/to/thumbnail.png", - "url":"http://path/to/image_file.png", - "caption":"Connessione di applicazioni con Cool Service" - }, - { - "type":"video", - "thumbnailUrl":"http://path/to/thumb.png", - "caption":"Cool Service gestisce le tabelle", - "source":[ - { - "type":"video/mp4", - "url":"http://path/to/video_file.mp4" - }, - { - "type":"video/ogg", - "url":"http://path/to/video_file.ogg" - } - ] - } - ] - }, - "plans":[ - { - "name":"smallplan", - "description":"Spazio tabelle e schema dedicati per istanza di servizio su un server condiviso. L'archiviazione dei database compressi da 1 e 10 GB può contenere fino a, rispettivamente, 5 e 50 GB di dati non compressi, con rapporti di compressione standard.", - "free":false, - "id":"cool-service-plan-id", - "metadata":{ - "bullets":[ - "Minimo 1 GB per istanza. Massimo 10 GB per istanza." - ], - "costs":[ - { - "unitId":"INSTANCES_PER_MONTH", - "unit":"MONTHLY", - "partNumber":"D15UTLL" - } - ], - "displayName":"Small" - } - } - ] - } -] -} -``` -{: codeblock} - -Le seguenti tabelle possono aiutarti a compilare il file JSON. - - -{: #ld_table10} - -| **Campi JSON** | **Descrizione** | -|-----------------|-----------------| -|bindable | Un valore booleano che indica se le istanze del servizio possono essere associate tramite bind alle applicazioni. | -|description | La descrizione del servizio visualizzata quando utilizzi il comando cf marketplace o passi il mouse sull'icona del servizio nel catalogo dell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Puoi aggiungere una singola parola o frase per la descrizione. | -|name | Il nome del servizio visualizzato nell'interfaccia riga di comando cf. Questo nome deve essere univoco all'interno di {{site.data.keyword.Bluemix_notm}}, deve utilizzare lettere minuscole e non può contenere spazi. Dopo aver registrato il servizio con {{site.data.keyword.Bluemix_notm}}, non potrai più modificarne il nome. | -|ID | L'ID del servizio. Questo ID deve essere univoco in {{site.data.keyword.Bluemix_notm}} e deve essere un GUID (Globally Unique Identifier). Dopo aver registrato il servizio con {{site.data.keyword.Bluemix_notm}}, non potrai più modificare l'ID. | -|metadata | I metadati del piano di servizio visualizzati nel catalogo {{site.data.keyword.Bluemix_notm}} e nel listino prezzi. Il campo dei metadati è facoltativo. Puoi specificare più campi per i metadati. Per ulteriori informazioni, vedi la seguente tabella per i [campi Metadati](index.html#metadatafields). | -|plans | Un array di definizioni del piano di servizio. Per ulteriori informazioni, vedi la seguente tabella per i [campi Piano](index.html#planfields). | -{: caption="Table 10. JSON fields" caption-side="top"} - - -{: #metadatafields} - -| **Valori metadati** | **Descrizione** | -|---------------------|-----------------| -|displayName | Il nome del piano visualizzato nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Questo nome viene visualizzato sia nel catalogo alla pagina dei dettagli del servizio che nel listino prezzi. Scrivi in maiuscolo solo la prima lettera del nome del piano. Non utilizzare "Predefinito" come nome piano predefinito, usa invece "Standard". | -|providerDisplayName | Il nome del provider di servizi | -|longDescription | La descrizione dettagliata per il servizio. Utilizza almeno due frasi per una descrizione lunga. | -|plans | Un array di definizioni del piano di servizio. Ogni voce di array del campo plans comprende i seguenti campi: name, description, free, id e metadata. Per ulteriori informazioni, vedi la seguente tabella per i [campi Piano](index.html#planfields). | -|bullets | Un array di stringhe visualizzate per un servizio. Puoi utilizzare gli elementi bullet per fornire informazioni in aggiunta alla descrizione lunga. Il campo bullets deve contenere almeno due elementi bullet. Ogni elemento bullet include il campo del titolo e della descrizione. | -|imageUrl | L'URL di un'immagine PNG grande (50 x 50 pixel). | -|smallImageUrl | L'URL di un'immagine PNG piccola (24 x 24 pixel). | -|mediumImageUrl | L'URL di un'immagine PNG media (32 x 32 pixel). | -|featuredImageUrl | L'URL di un'immagine in evidenza (64 x 64 pixel). | -|documentationUrl | L'URL della documentazione per il servizio. | -|termsUrl | L'URL dei file PDF che contengono i termini dell'accordo. | -|media (facoltativo) | Un array di elementi per visualizzare i video e le acquisizioni schermo che introducono il servizio nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Un elemento media può contenere i seguenti campi: type (image, youtube, video), thumbnailUrl (l'URL dell'immagine di anteprima per l'elemento media), url (l'URL dell'acquisizione schermo o del video YouTube), source (le origini dei video che non sono ospitati su YouTube. Il "type" delle origini del video deve essere supportato da HTML5. Includi "type" e "url" per il video)e caption (la didascalia per l'elemento media. Le didascalie consentono un accesso facilitato agli utenti con disabilità per comprendere gli elementi media). | -|serviceKeysSupported | Un valore booleano che indica se l'API delle chiavi del servizio è supportata. L'API delle chiavi del servizio permette di abilitare l'utilizzo di un servizio al di fuori di {{site.data.keyword.Bluemix_notm}}. Il valore predefinito è false. | -|plan_updateable | Un valore booleano che indica se il servizio supporta le modifiche del piano. Il valore predefinito è false. | -|embeddableDashboard (facoltativo) | Un campo che indica come viene visualizzato il dashboard del servizio nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Se non specifichi questo campo, il dashboard viene integrato ma viene limitato a una larghezza minima di 960px e il dashboard avrà un ulteriore riempimento orizzontale intorno all'iframe. Puoi utilizzare true, false, drilldown o launch. Per questo valore puoi utilizzare i seguenti campi: true, false, drilldown e launch. | -|notCreatable (facoltativo) | Un valore booleano che indica se le istanze per il servizio possono essere create dall'interfaccia utente {{site.data.keyword.Bluemix_notm}} e dall'interfaccia riga di comando cf. Il valore true significa che le istanze del servizio non possono essere create né dall'interfaccia utente {{site.data.keyword.Bluemix_notm}} né dall'interfaccia riga di comando cf. Il valore predefinito è false. | -|notCreatableMessage (facoltativo) | Un messaggio che viene visualizzato nell'interfaccia utente {{site.data.keyword.Bluemix_notm}} se non è possibile creare le istanze del servizio. Se non specifichi questo campo, verrà visualizzato il seguente messaggio predefinito: Per ricevere una notifica sulla disponibilità del servizio, confermare l'indirizzo email o immettere un nuovo indirizzo. | -|notCreatableRobotMessage (facoltativo) | Un messaggio che viene visualizzato nell'area commenti della pagina dei dettagli del servizio nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Il messaggio viene utilizzato per indicare che un servizio potrebbe avere un problema o altre cause che lo rendono non disponibile. Puoi specificare un messaggio per spiegare il motivo. Se non specifichi questo campo, verrà visualizzato il seguente messaggio predefinito: Questo servizio non è al momento disponibile. | -|apiReferenceUrl (facoltativo) | L'URL dell'iframe nell'area Riferimento API nella pagina dei dettagli del servizio all'interno del catalogo. Se non viene utilizzato per la pagina dei dettagli del servizio nel Catalogo, puoi immettere il valore numerico assegnato alla Documentazione API REST del tuo servizio durante la registrazione nel microservizio Documentazione API REST di {{site.data.keyword.Bluemix_notm}}. In questo modo, la documentazione dell'API REST verrà visualizzata nel dashboard del servizio. | -|sdkDownloadUrl (facoltativo) | L'URL della pagina Web che si apre quando fai clic sul pulsante Scarica SDK. Il pulsante Scarica SDK si trova nel tile del servizio nella pagina di panoramica dell'applicazione nel Dashboard. La pagina Web si apre in una scheda del browser. | -|serviceMonitorApi | L'URL di un'API che restituisce i dati JSON, come mostrato nel seguente esempio, che segnala l'integrità del servizio. Devi avere serviceMonitorApi o serviceMonitorApp nei metadati del servizio. Consulta il seguente codice come esempio. | -|serviceMonitorApp | L'URL a un'applicazione che può essere distribuita in {{site.data.keyword.Bluemix_notm}} ed essere associata a un servizio per fornire l'output specifico dello stato del servizio. L'applicazione deve restituire il formato dei dati JSON uguale al serviceMonitorApi. Devi avere serviceMonitorApi o serviceMonitorApp nei metadati del servizio. Consulta il seguente codice come esempio. | -{: caption="Table 11. Metadata fields" caption-side="top"} - - -``` -{ - "service": "servicename", - "version": 1, - "health": [ - { - "plan": "starter", - "status": 0, - "serviceinput": "count(*) from healthcheck", - "serviceoutput": "10…or error 1234 database not running", - "responsetime": 4 - }, - { - "plan": "enterprise", - "status": 1, - "serviceinput": "count(*)fromhealthcheck", - "serviceoutput": "10…orerror1234databasenotrunning", - "responsetime": 4 - } - ] -} -``` -{: pre} - -Il seguente esempio mostra come la risposta JSON di GET /v2/catalog è associata alla pagina dei dettagli del servizio nel catalogo {{site.data.keyword.Bluemix_notm}}: - -![Dettagli del servizio nel catalogo.](images/metadata.png "Vista dettagli del servizio nel catalogo Bluemix") - - -{: #planfields} - -| **Valori del piano** | **Descrizione** | -|---------------------|-----------------| -|name | Il nome del piano di servizio utilizzato nell'interfaccia riga di comando cf. Il nome del piano viene, ad esempio, visualizzato nell'output del comando cf marketplace. Il nome del piano deve essere in lettere minuscole, non può contenere spazi e deve essere univoco all'interno del servizio. | -|description | La descrizione del piano di servizio. La descrizione viene visualizzata quando selezioni una piano nella pagina dei dettagli del servizio nel catalogo {{site.data.keyword.Bluemix_notm}}. | -|free | Un valore booleano che indica se il piano di servizio è gratuito. Il valore predefinito è true. | -|ID | L'ID del piano di servizio. L'ID deve essere univoco e deve essere un GUID. | -|metadata (facoltativo) | I metadati del piano di servizio visualizzati nel catalogo {{site.data.keyword.Bluemix_notm}} e nel listino prezzi. Il campo dei metadati è facoltativo. Nel campo metadata puoi specificare i seguenti campi: displayName, type (subscription, reservable, planDetails), bullets, costs (unitId, unit, partNumber) e paidOnly. Per ulteriori informazioni, vedi la seguente tabella per i [campi Metadati del piano](index.html#planmetadata). | -{: caption="Table 12. Plan fields" caption-side="top"} - - -{: #planmetadata} - -| **Valori dei metadati del piano** | **Descrizione** | -|------------------------|-----------------| -|displayName | Il nome del piano visualizzato nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Questo nome viene visualizzato sia nel catalogo alla pagina dei dettagli del servizio che nel listino prezzi. | -|type | Il tipo di piano. Per questo campo, puoi utilizzare i seguenti valori: subscription (un piano di sottoscrizione. Il valore predefinito è false), reservable (un piano riservabile. Questo valore viene utilizzato solo quando il piano è un piano di sottoscrizione, ossia, il valore di plan.metadata.subscription è true. Il valore predefinito è false), planDetails (quantità e descrizione dettagliata delle risorse che possono essere utilizzate con il piano. Questo valore viene utilizzato solo quando il piano è riservabile, ossia, il valore di plan.metadata.reserveable è true.) | -|bullets | Una descrizione delle risorse che possono essere utilizzate con il piano. La descrizione viene visualizzata nella colonna **Funzioni** nella pagina dei dettagli del servizio del catalogo e nel listino prezzi. | -|costs | Informazioni sui costi del servizio che vengono visualizzate nella colonna Prezzo nella pagina dei dettagli del servizio del catalogo e nel listino prezzi. Ogni voce di array contiene i seguenti campi: unitId (l'ID dell'unità. Utilizza la forma plurale e scrivi in maiuscolo tutte le lettere. Per i piani gratuiti, questo campo è facoltativo), unit (la metrica utilizzata per calcolare gli addebiti del servizio. Il valore di questo campo è utilizzato nell'interfaccia utente {{site.data.keyword.Bluemix_notm}} per rappresentare la metrica di addebito)e partNumber (l'identificativo `part_number` utilizzato dal sistema di fatturazione. Per i piani gratuiti, questo campo è facoltativo). | -|paidOnly (facoltativo) | Un valore booleano che indica se questo piano di servizio è disponibile solo per gli account a pagamento {{site.data.keyword.Bluemix_notm}}. Il valore **true** significa che il piano di servizio è destinato solo agli account a pagamento e non può essere aggiunto agli account di prova. Il valore **false** significa che il piano di servizio può essere aggiunto sia agli account a pagamento che di prova. Il valore predefinito è **false**. | -{: caption="Table 13. Plan metadata fields" caption-side="top"} - -Il seguente esempio mostra come la risposta JSON di GET /v2/catalog è associata alla pagina dei dettagli del servizio nel catalogo {{site.data.keyword.Bluemix_notm}}. In particolare, il modo in cui i campi dei metadati del piano descritti nella tabella precedente vengono associati all'interfaccia utente: - -![Dettagli dei metadati del piano nel catalogo.](images/plan_metadata.png "Vista dei valori metadati del piano nel catalogo") - - - - -
    -
  1. Una volta implementata l'API broker dei servizi, vai a AMMINISTRAZIONE > GESTIONE CATALOGO.
    2. -
  2. Fai clic su REGISTRA UN BROKER DEI SERVIZI.
    3. -
  3. Completa il modulo immettendo valori nei seguenti campi: -
      -
    • Nome del broker dei servizi
      • -
    • URL del broker dei servizi
      • -
    • Nome utente del broker dei servizi
      • -
    • Password del broker dei servizi
      • -
    -
    4. -
  4. Fai clic su CONNETTI.
    5. -
  5. Controlla le informazioni sul tuo servizio, inclusi i piani disponibili, l'icona e la descrizione del servizio.
    -

    Nota: se devi modificare le informazioni di catalogo del servizio, aggiorna il tuo broker di servizi e riavvia il processo di registrazione, compilando il modulo.

    -
    6. -
  6. Fai clic su REGISTRA.
    7. -
  7. Scegli di abilitare tutti i piani o solo piani specifici per il servizio. Tutti i piani sono disabilitati per impostazione predefinita.
    8. -
  8. Abilita l'istanza del servizio per tutte le organizzazioni o solo per organizzazioni specifiche.
    9. -
- -Ora puoi vedere il tuo servizio nella categoria Servizi personalizzati del tuo catalogo {{site.data.keyword.Bluemix_notm}}. Vai a **AMMINISTRAZIONE > GESTIONE CATALOGO** e seleziona il tile del catalogo. Puoi abilitare differenti piani e modificarne la visibilità per le tue organizzazioni in qualsiasi momento. - - -## Amministrazione delle organizzazioni -{: #oc_organizations} - -Puoi gestire le tue organizzazioni attraverso la creazione e l'eliminazione di organizzazioni, l'aggiunta o la rimozione di gestori alle/dalle organizzazioni e il monitoraggio dell'utilizzo delle quote, così da adottare le scelte migliori per la tua attività. - -Fai clic su **AMMINISTRAZIONE > AMMINISTRAZIONE ORGANIZZAZIONE**. - -Puoi espandere e visualizzare le diverse sezioni. Puoi anche riesaminare e gestire i piani di quota per le tue organizzazioni. - -### Creazione di organizzazioni - -Per creare un'organizzazione e aggiungere gestori, completa la seguente procedura: - -1. Fai clic su CREA ORGANIZZAZIONE. -2. Immetti un nome per l'organizzazione. -3. Immetti il nome o l'email della persona che vuoi aggiungere come gestore. Puoi aggiungere più di un gestore immettendo e selezionando più nomi. -4. Fai clic su CREA ORGANIZZAZIONE per salvare le tue modifiche e creare l'organizzazione. - -### Creazione di spazi - -Puoi creare degli spazi nella tua organizzazione; ad esempio, -uno spazio *dev* come un ambiente di sviluppo, -uno spazio *test* come un ambiente di test e uno -spazio *production* come un ambiente di produzione. Puoi quindi associare -le tue applicazioni agli spazi. Per creare uno spazio completa la seguente procedura: - -1. Dalla barra dei menu, fai clic su **Account** > **Gestisci organizzazioni**. -2. Seleziona l'organizzazione a cui vuoi aggiungere uno spazio. -3. Fai clic su **Crea uno spazio**. -4. Immetti un nome spazio. -5. Fai clic su **Crea**. - -### Monitoraggio quota - -Puoi espandere la sezione **Monitoraggio quota** per visualizzare le seguenti informazioni: - -- Utilizzo della memoria dell'ambiente mostra in dettaglio l'utilizzo della memoria per l'intero ambiente di sistema. Il grafico mostra le seguenti informazioni: - -I seguenti tipi di utilizzo della memoria vengono visualizzati nel grafico. - -
-
Memoria fisica utilizzata
-
La memoria fisica utilizzata dal tuo ambiente.
-
Limite fisico
-
La memoria fisica totale disponibile nel tuo ambiente.
-
Quota riservata
-
La somma di memoria riservata per tutte le applicazioni distribuite, tra tutte le organizzazioni. La somma della quota riservata può superare il limite fisico di memoria per il tuo ambiente. Ad esempio, se hai un limite di memoria fisica pari a 16 GB, potresti riservare 4 GB di memoria ciascuna per un totale di cinque diverse applicazioni. La quota riservata supera il limite fisico della memoria. Tuttavia, in molti casi, le applicazioni potrebbero non utilizzare la quota totale riservata singolarmente a ciascuna di esse. Inoltre, è possibile che le applicazioni non utilizzino - contemporaneamente la quota totale della memoria riservata.
-
Limite riserva
-
La memoria totale che può essere riservata tra tutte le applicazioni per il tuo ambiente.
-
Quota totale
-
La quota di memoria totale tra tutte le organizzazioni.
-
- **Nota**: i dati vengono aggiornati automaticamente ogni 4 ore. Fai clic su **Ricalcola** se desideri aggiornare i dati sulla pagina prima dell'aggiornamento automatico. - -- Utilizzo della memoria dell'organizzazione. Questa sezione mostra in dettaglio l'utilizzo della memoria a livello di organizzazione. Puoi visualizzare la quota di memoria totale, la quota riservata e la memoria fisica utilizzata da ogni organizzazione. Il grafico fornisce informazioni che vengono elencate in base alla quantità di memoria riservata per ogni organizzazione e, per impostazione predefinita, viene elencata per prima l'organizzazione che riserva la maggiore quantità di memoria. Puoi ordinare per **Utilizzo massimo memoria** e **Assegnazione memoria in eccesso**. - -
-
Utilizzo massimo memoria
-
Usa questa opzione per identificare l'organizzazione che ha riservato la maggiore quantità di memoria. Ordina in base all'utilizzo massimo di memoria per identificare le organizzazioni che hanno riservato la maggiore quantità di memoria. L'elenco viene ordinato in base alla quota riservata.
-
Assegnazione memoria in eccesso
-
Usa questa opzione per identificare le organizzazioni che hanno una quota di memoria totale superiore a quella necessaria. Ordina per Assegnazione memoria in eccesso per identificare le organizzazioni che utilizzano -la minore quantità di memoria per la quota assegnata per l'organizzazione.
-
- -### Gestione delle quote -{: #manageorgquota} - -Una quota rappresenta i limiti di risorse per le organizzazioni, che viene assegnata quando l'organizzazione viene creata. Applicazioni o servizi in uno spazio all'interno dell'organizzazione contribuiscono tutti all'utilizzo della quota assegnata. Per gestire i seguenti passi completare la gestione della quota per un'organizzazione: - -
    -
  1. Fai clic sulla barra del grafico -relativo all'organizzazione che vuoi modificare nella sezione Utilizzo della memoria dell'organizzazione o seleziona il nome -dell'organizzazione nella sezione Elenco organizzazioni. Dalla pagina Informazioni sull'organizzazione, puoi ridenominare l'organizzazione e aggiungere o rimuovere i gestori. -

    Nota: se selezioni un piano di quota che non è sufficiente per l'utilizzo corrente -dell'organizzazione, riceverai un messaggio.

    2. -
  2. Fai clic su Cloud Foundry o Containers. Per impostazione predefinita, si apre la pagina della quota Cloud Foundry. -
      -
    • Dalla pagina Cloud Foundry, puoi selezionare un piano e visualizzare i dettagli della quota per le seguenti risorse: -
        -
      • Servizi
        • -
      • Rotte
        • -
      • Quota di memoria
        • -
      • Assegnazione applicazione
        • -
      -
      • -
    • Dalla pagina Containers, puoi assegnare i valori, che devono essere numeri interi, per i seguenti campi: -
      -
      Limite immagine
      -
      Il numero massimo di immagini contenitore che puoi avere nel tuo registro privato. Un'immagine contenitore è la base per ogni contenitore che crei. Un'immagine viene creata da un Dockerfile che è un file in sola lettura che ospita il sistema operativo, l'applicazione e tutte le relative dipendenze e descrive come viene configurato un contenitore. Le immagini sono condivise tra tutti i membri di un'organizzazione.
      -
      Assegnazione memoria predefinita
      -
      La quantità di memoria del contenitore che viene automaticamente assegnata quando viene creato un nuovo spazio. Quando crei un contenitore, devi scegliere una dimensione del contenitore. La dimensione determina la quantità di memoria che il contenitore può utilizzare sull'host di calcolo ed è compresa nel tuo limite di memoria del contenitore.
      -
      Assegnazione memoria massima
      -
      La quantità massima di memoria della memoria del contenitore che può essere assegnata tra tutti gli spazi di un'organizzazione.
      -
      IP mobili predefiniti
      -
      Il numero di indirizzi IP pubblici che viene automaticamente assegnato quando viene creato un nuovo spazio. Puoi eseguire il bind degli indirizzi IP pubblici a contenitori singoli o a gruppi di contenitori per renderli accessibili da internet.
      -
      Numero massimo di IP mobili
      -
      Il numero massimo di indirizzi IP pubblici che puoi assegnare tra tutti gli spazi di un'organizzazione.
      -
      -Nota: se non disponi ancora di contenitori nel tuo ambiente o se non li hai ancora configurati, ricevi un messaggio di errore. -

      Per ulteriori informazioni sui contenitori, consulta [Informazioni su IBM Containers](/docs/containers/container_ov.html). Per ulteriori informazioni sulle quote del contenitore, consulta [Quota e account Bluemix](/docs/containers/container_planning_org_ov.html#container_planning_quota).

      -Nota: i contenitori non sono disponibili nella regione {{site.data.keyword.Bluemix_notm}} Sydney.
      • -
    -
  3. Per salvare le eventuali modifiche apportate nella pagina Gestisci organizzazione, fai clic su SALVA.
    4. -
- - -### Gestione delle tue organizzazioni dall'elenco delle organizzazioni -{: #manageorgfrolis} - -Nella sezione Elenco organizzazioni, puoi visualizzare tutte le organizzazioni -dell'ambiente {{site.data.keyword.Bluemix_notm}} e intervenire sulle singole organizzazioni facendo clic sul nome dell'organizzazione. - -- Per eliminare l'organizzazione, fai clic sull'icona **Elimina** ![Elimina](images/icon_trash.svg) nella colonna Azioni. -- Per visualizzare il piano di quota e l'utilizzo di un'organizzazione, fai clic sul nome dell'organizzazione -nell'elenco. Nella pagina **Gestisci organizzazioni** dell'organizzazione selezionata, puoi visualizzare le seguenti informazioni sull'utilizzo: - - - Numero di servizi attualmente in uso. - - Numero di rotte attualmente in uso. - - Grafico delle quote di memoria che mostra le percentuali di quota di memoria attualmente in uso e non in uso. - - Grafico sull'assegnazione delle applicazioni che mostra quali applicazioni sono incluse nella quota di memoria utilizzata. - - Grafico sull'utilizzo misurato dell'applicazione che mostra un report trimestrale sulle GB-ore utilizzate per applicazione distribuita. Puoi selezionare la **Vista elenco** per visualizzare i dati per tutte le applicazioni, compresa l'assegnazione di memoria per applicazione e l'utilizzo a consumo di GB-ore degli ultimi tre mesi. - -- Per modificare il nome dell'organizzazione e aggiungere o rimuovere gestori, fai clic sul nome dell'organizzazione - nell'elenco e segui i prompt mostrati a schermo. -- Per visualizzare le informazioni su un utente specifico dell'organizzazione che stai visualizzando, fai clic sul nome utente per visualizzarne le informazioni. Puoi quindi fare clic sul nome dell'organizzazione per ritornare a visualizzare le informazioni sull'organizzazione. - -## Gestione di utenti e autorizzazioni -{: #oc_useradmin} - -Puoi aggiungere gli utenti singolarmente o in gruppi. In genere, gli utenti vengono aggiunti alla tua istanza {{site.data.keyword.Bluemix_notm}} dal registro utenti della tua azienda tramite LDAP (Lightweight Directory Access Protocol). Puoi anche visualizzare le autorizzazioni utente. Se disponi dell'autorizzazione **Superuser**, puoi anche impostare e gestire le autorizzazioni per gli altri utenti. Fai clic su **AMMINISTRAZIONE > AMMINISTRAZIONE UTENTI**. - -La pagina Amministrazione utenti visualizza tutti gli utenti per l'istanza locale o dedicata. Sono visualizzate le autorizzazioni per ciascun utente utilizzando le icone nella tabella. Le autorizzazioni possono essere: Nessuna, **Superuser**, **Accesso di base**, **Catalogo**, **Report** e **Utenti**. -Le autorizzazioni **Superuser** e **Accesso di base** possono essere impostate su **Attivo** o **Disattivo**, mentre le altre autorizzazioni vengono abilitate o disabilitate con specifici tipi di accesso, tra cui l'accesso in **Lettura** o **Scrittura** per l'autorizzazione indicata, come rappresentato dalle icone. Consulta [Autorizzazioni](#permissions) per delle descrizioni di -ciascun tipo e una spiegazione delle icone. - -### Gestione degli utenti -{: #workwithusers} - -A seconda del tuo accesso di **Lettura** o **Scrittura** per le autorizzazioni dell'utente, puoi cercare utenti esistenti, rimuovere utenti e aggiungere utenti singolarmente o in base a un gruppo. Se hai l'autorizzazione **Superuser**, disponi dell'accesso completo per eseguire tutte le attività di gestione utente nell'ambiente. Esamina le seguenti attività di gestione utente e il livello di accesso necessario per completare ogni attività: - -* Individua utenti. Se disponi dell'accesso in **Lettura** o **Scrittura** e conosci tutto o parte del nome utente, puoi individuare gli utenti nella tabella utilizzando il campo **Ricerca**. Puoi anche filtrare l'elenco di utenti in base alle relative organizzazioni e autorizzazioni. Per filtrare un elenco di utenti, completa la seguente procedura: -
    -
  1. Fai clic su Filtro.
    2. -
  2. Seleziona Organizzazioni o Autorizzazioni, a seconda del filtro che desideri utilizzare. -
    -
    Organizzazione
    -
    Per filtrare gli utenti in base all'organizzazione, inizia a immettere il nome dell'organizzazione nel campo Organizzazione e selezionala dall'elenco. Seleziona, quindi, uno o più ruoli assegnati agli utenti all'interno dell'organizzazione.
    -
    Autorizzazioni
    -
    Per filtrare gli utenti in base alle autorizzazioni, seleziona prima il tipo di utente o utenti. Ad esempio, potresti voler visualizzare tutti i Superuser. Per le autorizzazioni diverse da Superuser o Accesso di base, puoi selezionare anche il tipo di accesso, ad esempio Lettura o Scrittura.
    -
    3. -
  3. Fai clic su Applica.
    4. -
- - La finestra Gestione utenti mostra i filtri da te impostati e gli utenti che risultano dai filtri specificati. Puoi quindi cercare un utente nella tabella filtrata. Inoltre, puoi modificare l'elenco dei filtri specificati rimuovendo un'opzione di filtro. - -* Aggiungi un singolo utente. Se disponi dell'autorizzazione **Superuser** o -**Utenti** con l'accesso in **Scrittura**, puoi aggiungere gli utenti. - - 1. Per aggiungere un singolo utente dalla tua directory LDAP, fai clic su **Aggiungi utente**. - 2. Nel campo **Ricerca**, immetti l'indirizzo email per l'utente e seleziona quindi l'utente dall'elenco compilato. - 3. Quindi, dal campo **Organizzazione**, scegli l'organizzazione a cui vuoi aggiungere l'utente immettendo il nome dell'organizzazione e selezionandolo dall'elenco compilato. - 4. Per aggiungere l'utente all'organizzazione selezionata, fai clic su **Aggiungi utente**. - - **Nota**: quando l'operazione di aggiunta viene eseguita con esito positivo, l'utente viene aggiunto alla tabella per consentirti operazioni di visualizzazione e ricerca. Quando gli utenti vengono aggiunti, -non dispongono di autorizzazioni. - -* Aggiunta di un gruppo di utenti dalla tua directory LDAP. Se disponi dell'autorizzazione **Superuser** o -**Utenti** con l'accesso in **Scrittura**, puoi aggiungere gli utenti. - - 1. Fai clic su **Aggiungi gruppo di utenti**. - 2. Nel campo **Ricerca**, immetti un nome gruppo da cercare e seleziona il nome gruppo dall'elenco compilato. - 3. Quindi, dal campo **Organizzazione**, scegli l'organizzazione a cui vuoi aggiungere il gruppo di utenti immettendo il nome dell'organizzazione e selezionandolo dall'elenco compilato. - 4. Per aggiungere il gruppo di utenti all'organizzazione selezionata, fai clic su **Aggiungi utenti**. - - **Nota**: i gruppi di più di 50 utenti vengono aggiunti tramite un lavoro batch in background. Se l'operazione di aggiunta viene -completata correttamente, l'utente o il gruppo viene aggiunto alla tabella per consentirti operazioni di visualizzazione e ricerca. Quando gli utenti vengono aggiunti, -non dispongono di autorizzazioni. - -* Aggiungi un gruppo di utenti importando un foglio di calcolo che include ID utente, indirizzi email utente e l'organizzazione a cui intendi aggiungere l'utente. Se disponi dell'autorizzazione **Superuser** o **Utenti** con l'accesso in **Scrittura**, puoi aggiungere gli utenti. - -**Nota**: immetti gli ID utente che corrispondono ai valori utilizzati nel tuo registro utenti. - - 1. Fai clic su **Importa utenti**. - 2. Fai clic su **Scarica modello (.CSV)** per scaricare un foglio di calcolo con le colonne richieste compilabili. In alternativa puoi crearne uno personalizzato, utilizzando un foglio di calcolo che includa le intestazioni di colonna richieste: **ID utente**, **Email** e **Organizzazione**. Il template include anche due colonne facoltative: **Nome** e **Cognome**. - 3. Compila i valori utente per le colonne obbligatorie. Se non utilizzi una directory LDAP, utilizza le intestazioni colonna obbligatorie e facoltative per gli utenti di importazione. - 4. Salva il tuo file e fai clic su **Carica file**. - - **Nota**: le colonne nel tuo foglio di calcolo possono essere in qualsiasi ordine, a condizione che tu abbia tutte le colonne obbligatorie. Se l'importazione ha avuto esito positivo, ricevi un messaggio di conferma che indica che sono stati aggiunti tutti gli utenti. Se l'importazione ha avuto esito positivo per qualche utente ma non per altri, esamina il messaggio di errore per intervenire sugli utenti che non è stato possibile aggiungere. - -* Rimuovere utenti. Se disponi dell'autorizzazione **Superuser** o **Utenti** con l'accesso in **Scrittura**, puoi rimuovere gli utenti dall'ambiente in modo permanente. - - 1. Individua l'utente e fai clic sull'icona ![Elimina](images/icon_trash.svg). - 2. Fai clic su **Rimuovi**. - -* La modifica di autorizzazioni e organizzazioni a cui appartengono gli utenti richiede che tu disponga dell'autorizzazione **Superuser**. Per modificare le autorizzazioni per gli utenti, individua l'utente e fai clic sul nome utente. Dalla pagina **Modifica utente**, puoi abilitare o disabilitare le autorizzazioni: - - * Seleziona **Attivo** dall'elenco per abilitare l'autorizzazione **Superuser** o **Accesso di base**. - * Seleziona **Lettura** dall'elenco per consentire all'utente di disporre dell'accesso in **Visualizzazione** (sola lettura) per tale autorizzazione oppure seleziona **Scrittura** per consentire l'accesso in **Scrittura** (modifica o aggiunta e rimozione) per tale autorizzazione. - * Seleziona **Disattivo** per disabilitare tutte le autorizzazioni. - - **Nota**: l'impostazione dell'autorizzazione **Superuser** su **Attivo** imposta tutte le altre autorizzazioni con l'accesso in **Scrittura**. - -* Per aggiungere o rimuovere un utente da una specifica organizzazione, devi disporre dell'autorizzazione **Superuser** o **Utenti** con l'accesso in **Scrittura**. - - 1. Per aggiungere un utente a un'organizzazione, seleziona il nome utente dalla tabella per accedere alla pagina **Modifica utente**. Utilizza quindi il campo di ricerca per individuare un'organizzazione, seleziona l'organizzazione dall'elenco e fai clic su **Salva**. - 2. Per rimuovere un utente da un'organizzazione, seleziona il nome utente dalla tabella per accedere alla pagina **Modifica utente**. Fai quindi clic su ![Rimuovi](images/icon_remove.svg) per l'organizzazione da cui vuoi rimuovere l'utente e fai clic su **Salva**. - -* Per visualizzare le informazioni sull'organizzazione a cui è assegnato l'utente, fai clic sul nome dell'organizzazione per visualizzarne le informazioni. Puoi quindi fare clic sul nome dell'utente per ritornare a visualizzare le informazioni sull'utente. - -### Autorizzazioni -{: #permissions} - -È possibile assegnare agli utenti le seguenti autorizzazioni con livelli di accesso specifici (lettura o scrittura) che consentono all'utente di completare attività specifiche all'interno della console di gestione. - - -{: #ld_table14} - -| **Autorizzazione utente** | **Descrizione** | -|-----------------|-------------------| -| Superuser | Gli utenti con l'autorizzazione **Superuser** impostata su **Attivo** possono modificare le autorizzazioni per gli altri utenti. Se hai l'autorizzazione attiva, ti viene automaticamente abilitato l'accesso completo alle altre autorizzazioni. Oltre alle attività descritte per ogni autorizzazione nella tabella, questi utenti possono anche impostare le sottoscrizioni di notifica per essere direttamente avvertiti in merito a manutenzione o incidenti, per pianificare la manutenzione, eseguire i controlli di verifica sui componenti della console e creare organizzazioni e spazi per l'ambiente. Questa autorizzazione equivale al ruolo di amministratore (admin) per la console di gestione. | -| Accesso di base | Gli utenti con l'autorizzazione **Accesso di base** impostata su **Attivo** possono visualizzare l'opzione della pagina di amministrazione nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Gli utenti con l'autorizzazione abilitata possono avere accesso alle [Informazioni di sistema](#oc_system) e ai tile [Utilizzo della risorsa](#oc_resource). Senza questa autorizzazione, gli utenti non possono visualizzare o accedere all'opzione di menu Amministrazione. Questa autorizzazione equivale al ruolo di amministratore (admin) per la console di gestione. Equivale all'autorizzazione di accesso utilizzata precedentemente per la console di gestione. | -| Catalogo | Agli utenti con autorizzazione **Catalogo** può essere assegnato l'accesso in **Lettura** o in **Scrittura** (modifica) per i servizi disponibili nell'istanza locale o dedicata. L'accesso in lettura consente all'utente di accedere al tile di gestione del catalogo per visualizzare i servizi disponibili. L'accesso in scrittura consente all'utente di accedere al tile [Gestione catalogo](#oc_catalog) per visualizzare i servizi, modificare la visibilità dei servizi, registrare i servizi personalizzati e controllare l'elenco di priorità del pacchetto di build. | -| Report | Agli utenti con autorizzazione **Report** può essere assegnato l'accesso in **Lettura** o in **Scrittura** (modifica) per i report di sicurezza. L'accesso in lettura consente all'utente di accedere al tile Report e log per scaricare i report. L'accesso in scrittura consente agli utenti di visualizzare il tile [Report e log](#oc_report) così come di utilizzare la CLI per caricare nuovi report e creare nuove categorie per l'accesso degli utenti. | -| Utenti | Agli utenti con autorizzazione **Utenti** può essere assegnato l'accesso in **Lettura ** (visualizzazione) per l'elenco di utenti o in **Scrittura** (aggiunta o rimozione) per gli utenti. Questa autorizzazione non ti consente di impostare le autorizzazioni per gli altri utenti. L'accesso in scrittura consente all'utente di aggiungere nuovi utenti all'ambiente, eliminare utenti dall'ambiente e aggiungere utenti esistenti all'organizzazione che già esistono nell'ambiente. In aggiunta, l'accesso in **Scrittura** consente agli utenti di aggiungere nuove organizzazioni, eliminare le organizzazioni e modificare gli utenti nelle organizzazioni. | -{: caption="Table 14. Permissions" caption-side="top"} - -## Utilizzo delle API REST -{: #auth_adminapi} - -Per utilizzare i comandi dell'API REST, devi innanzitutto eseguire l'autenticazione. Per generare e supportare le sessioni, puoi utilizzare i comandi cURL per compiere le seguenti attività: - -* [Accesso alla Console di gestione](#auth_loginapi) -* [Memorizzazione di ID utente e password](#auth_setuidpw) -* [Memorizzazione di cookie](#auth_apistorecook) -* [Riutilizzo dei cookie](#auth_apireusecook) - -### Accesso alla Console di gestione -{: #auth_loginapi} - -Prima di poter eseguire qualsiasi richiesta API `Admin`, -devi eseguire l'accesso alla Console di gestione. - -Per accedere alla Console di gestione, puoi utilizzare l'autenticazione di accesso di base -sull'endpoint `https://console..bluemix.net/login`. Il server restituisce un cookie con la tua sessione. Puoi utilizzare tale -cookie per tutte le operazioni con la Console di gestione. - -**Nota:** la sessione diventa non valida se non viene utilizzata per qualche ora. - -Per accedere alla -Console di gestione, esegui questo comando: - -`curl --user : -c ./cookies.txt --header "Accept: application/json" https://console..bluemix.net/login | python -m json.tool` -{: codeblock} - -
-
--user id_utente:password
-
Accetta l'ID utente e la password e invia un'intestazione di autorizzazione di base.
-
-c nomefile
-
Memorizza l'ID utente e la password specificati come un cookie nel file specificato.
-
-b nomefile
-
Richiama l'ID utente e la password specificati come un cookie nel file specificato.
-
--header
-
Invia un'intestazione Accept.
-
- -Il seguente esempio mostra l'output di questo - comando: -``` -{ - "message": "Logged in", - "name": { - "familyName": "*last_name*", - "givenName": "*first_name*" - } -} -``` -{: screen} - -### Memorizzazione di ID utente e password -{: #auth_setuidpw} - -Puoi memorizzare il tuo ID utente e password in modo da non doverli immettere manualmente ogni volta che esegui l'accesso. Per memorizzare il tuo ID utente e password per poterli riutilizzare, utilizza il seguente esempio cURL: - -`curl -X GET -H "Authorization: Basic " -H "Accept: application/json" "http://localhost:3000/login"` -{: codeblock} - -Per configurare le tue informazioni di accesso in un file separato e quindi richiamare il file in modo da non doverlo immettere per ogni richiesta di autenticazione, utilizza l'opzione `--netrc` fornita dal comando cURL. - -Per utilizzare l'opzione `--netrc` con cURL, crea prima un file nella directory home dell'utente in uno dei seguenti modi: -* Su un sistema Unix, crea un file denominato .netrc -* Su un sistema Windows, crea un file denominato _netrc. - -Nel file, immetti le seguenti informazioni: - -`machine console..bluemix.net -login -password ` -{: codeblock} - -Quando si richiama un comando cURL, aggiungi il seguente argomento: `--netrc`. -

Per utilizzare un file netrc che si trova in una directory differente, utilizza l'opzione `--netrc-file [file]`, dove `[file]` è la posizione del file netrc.

- - - - -### Memorizzazione di cookie -{: #auth_apistorecook} - -Quando accedi alla Console di gestione, il server restituisce un cookie con la tua sessione. Questo cookie è richiesto come parte del processo di accesso per le future chiamate API per tutte le operazioni con la Console di gestione. Puoi memorizzare i cookie anche per un utilizzo successivo. - -Per memorizzare i cookie dopo aver eseguito l'accesso, utilizza l'opzione `-c`, come mostrato nel seguente esempio CURL: - -`curl --user : -c ./cookies.txt --header "Accept: application/json" https://console..bluemix.net/login | python -m json.tool` -{: codeblock} - -### Riutilizzo dei cookie -{: #auth_apireusecook} - -Per riutilizzare i cookie, utilizza l'opzione `-b` con il nome del file cookie che hai assegnato con l'opzione `-c`, come mostrato nel seguente esempio CURL: - -`curl --user : -b ./cookies.txt` -{: codeblock} - -## Gestione degli utenti con la API REST Admin - -{: #usingadminapi} - -Puoi utilizzare l'API REST `Admin` per aggiungere e rimuovere utenti per l'istanza {{site.data.keyword.Bluemix_notm}}. -Gli endpoint della API REST `Admin` e le risposte JSON sono fornite su base sperimentale per abilitare le operazioni di base da una riga di comando. Gli endpoint e gli URL negli esempi nelle presenti -informazioni possono variare o potrebbero essere abbandonate con breve preavviso. - -Se disponi dell'autorizzazione **Superuser** o **Utenti** -con l'accesso in **Scrittura**, puoi aggiungere o rimuovere gli utenti. Per modificare le autorizzazioni di altri utenti devi disporre -dell'autorizzazione **Superuser**. - -Anche se puoi utilizzare altri strumenti, i seguenti sono prerequisiti per l'utilizzo degli esempi che seguono: -utilizzare altri strumenti. -* cURL, per immettere richieste API REST come comandi. cURL è un programma di utilità gratuito che puoi - utilizzare per inviare richieste HTTP a un server e ricevere le risposte - attraverso un'interfaccia riga di comando. Puoi scaricare -cURL dal [sito cURL Download ![icona link esterno](../icons/launch-glyph.svg)](http://curl.haxx.se/download.html){: new_window}. -* Python, per utilizzare lo strumento JSON Pretty-Print Python. Questo strumento -facoltativo prende il testo JSON come input e fornisce un output facile da leggere. Puoi scaricare -Python dal [sito Python Downloads ![icona link esterno](../icons/launch-glyph.svg)](https://www.python.org/downloads){: new_window}. - - -### Elenco delle organizzazioni -{: #listingorg} - -Quando aggiungi un utente, devi specificare un'organizzazione. Puoi -utilizzare la API REST `Admin` per elencare tutte le organizzazioni. Devi disporre dell'autorizzazione -**Utenti** con l'accesso in **Lettura** per elencare -le organizzazioni. Per elencare tutte le organizzazioni, esegui questo comando: - -`curl -b ./cookies.txt https://.ibm.com/codi/v1/organizations | python -m json.tool` -{: codeblock} - -
- -
-b nomefile
-
Passa l'ID utente e la password memorizzati precedentemente -con l'opzione -c nel file al server HTTP come -un cookie.
- -
- -Per ciascuna organizzazione, i risultati includono le seguenti informazioni: -* `"guid"`, GUID dell'organizzazione -* `"name"`, nome dell'organizzazione - -Il seguente esempio mostra l'output di questo - comando: -``` -{ - "resources": [ - { - "guid": "05af098d-d476-4fb0-8b87-a84350e72af3", - "name": "org-1" - }, - { - "guid": "5129a5a8-37c2-4ee4-a9b2-bebae3531db5", - "name": "org-2" - }, - - .... - - ], - "total_results": 284 -} -``` -{: screen} - -### Elenco degli utenti -{: #listingusr} - -Puoi determinare se un utente è già stato aggiunto al tuo ambiente {{site.data.keyword.Bluemix_notm}} utilizzando -l'API REST `Admin` per elencare gli utenti registrati. Devi disporre dell'autorizzazione -**Utenti** con l'accesso in **Lettura** per elencare gli -utenti registrati. Per elencare tutti gli utenti, esegui questo comando: - -`curl -b ./cookies.txt https://.ibm.com/codi/v1/users | python -m json.tool` -{: codeblock} - -
-
-b nomefile
-
Passa l'ID utente e la password memorizzati precedentemente -con l'opzione -c nel file al server HTTP come -un cookie.
-
- -Per ciascun utente registrato, i risultati includono le seguenti informazioni: -* `"first_name"` (nome) e - `"last_name"` (cognome) -* `"user_id"`, ID utente e indirizzo email -* `"guid"`, GUID dell'organizzazione. -* `"permissions"`, ossia le autorizzazioni assegnate all'utente per la Console di gestione. - -Il seguente esempio mostra l'output di questo - comando: - -``` -{ - "next_url": "/codi/v1/users?results_per_page=100&page=2", - "prev_url": "", - "resources": [ - { - "active": true, - "created_at": "2015-04-08T17:38:51.788Z", - "created_by": "", - "first_name": "some first name", - "guid": "5d5268cf-39c0-48d3-96ae-7afe928e5dd7", - "last_name": "some last name", - "permissions": [ - { - "display": "ops.admin" - }, - { - "display": "ops.catalog.write" - }, - { - "display": "ops.reports.write" - }, - { - "display": "ops.catalog.read" - }, - { - "display": "ops.users.write" - }, - { - "display": "ops.reports.read" - }, - { - "display": "ops.login" - }, - { - "display": "ops.users.read" - } - ], - "user_id": "someid@us.ibm.com" - }, - ... - - - } - ], - "total_pages": 395, - "total_results": 39421 -} - -``` -{: screen} - -### Aggiunta di un utente - -Puoi utilizzare l'API REST `Admin` per aggiungere utenti all'istanza {{site.data.keyword.Bluemix_notm}}. Devi -disporre dell'autorizzazione **Utenti** con l'accesso in **Scrittura** per aggiungere -gli utenti o l'autorizzazione **Superuser** (ops.admin) per la console di gestione. Inoltre, in qualità di Ammin, puoi consentire ai membri dell'organizzazione che non hanno le autorizzazioni `utente` o `superuser` generali della console di gestione, la possibilità di aggiungere nuovi utenti solo alle loro organizzazioni. Utilizza il seguente comando API per questa specifica capacità per i gestori organizzazione: - -``` -PUT console..bluemix.net/codi/env_config/allow_managers?flag= -``` -{: screen} - -Puoi aggiungere un singolo utente o un elenco di utenti. Puoi aggiungere utenti a una -o più organizzazioni. Per aggiungere un utente, -devi fornire le seguenti informazioni: - -* Nome e cognome dell'utente. Fornisci `"nome"` e `"cognome"` da [Elenco degli utenti](index.html#listingusr). -* Indirizzo email e ID utente: fornisci l'`"id_utente"` da [Elenco degli utenti](index.html#listingusr) sia per l'indirizzo email sia per l'ID utente. -* `"guid"`. Fornisci il GUID dell'organizzazione da [Elenco delle organizzazioni](index.html#listingorg). - -Per fornire le informazioni, ti servi di un file JSON. - -`curl -b ./cookies.txt https://.ibm.com/codi/v1/users | python -m json.tool` -{: codeblock} - -
-
-b nomefile
-
Passa l'ID utente e la password memorizzati precedentemente -con l'opzione -c nel file al server HTTP come -un cookie.
-
- -
    -
  1. Crea un file JSON che contiene le informazioni in un formato JSON corretto. -

    Ad esempio, crea un file denominato `user.json` che presenta -questo contenuto:

    -
    -{
-    "members": [
-        {
-            "emails": [
-                "un_id_utente@dominio.com"
-            ],
-            "first_name": "un_nome",
-            "last_name": "un_cognome",
-            "user_id": "un_id_utente@dominio.com"
-        }
-    ],
-    "organization_roles": [
-        {
-            "id": "7a891f9c-e4e7-46c7-8b4e-dffaa7eb3bcd"
-        }
-    ]
-}
-
    -
    2. -
  2. Pubblica il contenuto del file JSON nell'endpoint dell'utente immettendo il seguente -comando:

    - -curl -v -b ./cookies.txt -X POST -H "Content-Type: application/json" -d @./user.json https://.ibm.com/codi/v1/users - -
    3. -
- -
-
-v
-
Specifica un output dettagliato.
-
-X POST
-
Specifica una richiesta POST, sovrascrivendo la richiesta GET predefinita.
-
-H "Content-Type: application/json"
-
Specifica l'intestazione content-type, che in questo caso è JSON.
-
-d *dati*
-
Specifica i dati, in questo caso il file `user.json`, -da inviare nella richiesta POST al server HTTP.
-
- -Il seguente esempio mostra l'output di questo - comando: - -``` -* Connected to localhost (127.0.0.1) port 3000 (#0) - > POST /codi/v1/users HTTP/1.1 - > User-Agent: curl/7.37.1 - > Host: localhost:3000 - > Accept: */* - > Cookie: opsConsole.sid=s%3AHLcwKGumyEb3IxREmikDOG3ATKD5xYMe.jfjWAa1tJC0rGghpeV8RPHqE2JaFVL4ZFIJbQpSC%2FAI - > Content-Type: application/json - > Content-Length: 333 - > - * upload completely sent off: 333 out of 333 bytes - < HTTP/1.1 201 Created - < x-powered-by: Express - < vary: X-HTTP-Method-Override - < content-type: application/json - < date: Wed, 22 Apr 2015 19:32:54 GMT - < connection: close - < transfer-encoding: chunked - < X-Time_Check: Proxy Time: 5612 msec - ``` -{: screen} - -### Rimozione di un utente - -Puoi utilizzare l'API REST `Admin` per rimuovere gli utenti dall'istanza {{site.data.keyword.Bluemix_notm}}. Per rimuovere -gli utenti, devi disporre dell'autorizzazione **Utenti** con l'accesso in **Scrittura**. - -Per rimuovere un utente, devi fornire l'ID dell'utente: Immetti il seguente comando: - -`curl -v -b ./cookies.txt -X DELETE https://.ibm.com/codi/v1/users?user_id=` -{: codeblock} - -
-
-X DELETE
-
Specifica una richiesta DELETE.
-
- -Il seguente esempio mostra l'output di questo - comando: - -``` - * connect to ::1 port 3000 failed: Connection refused - * Trying 127.0.0.1... - * Connected to localhost (127.0.0.1) port 3000 (#0) - > DELETE /codi/v1/users?user_id=exampleuser@domain.com HTTP/1.1 - > User-Agent: curl/7.37.1 - > Host: localhost:3000 - > Accept: */* - > Cookie: opsConsole.sid=s%3AHLcwKGumyEb3IxREmikDOG3ATKD5xYMe.jfjWAa1tJC0rGghpeV8RPHqE2JaFVL4ZFIJbQpSC%2FAI - > - < HTTP/1.1 201 Created - < x-powered-by: Express - < content-type: application/json - < date: Wed, 22 Apr 2015 21:01:09 GMT - < connection: close - < transfer-encoding: chunked - < X-Time_Check: Proxy Time: 1922 msec - < - ``` -{: screen} - -## API per le metriche (sperimentale) -{: #envappmetricsapi} - -Puoi utilizzare tre API sperimentali per raccogliere le metriche sul tuo ambiente o sulle tue applicazioni. Queste API restituiscono un array di punti dati per le metriche che hai richiesto nell'intervallo di tempo che hai specificato. - -Puoi accedere alle API delle metriche descritte nelle seguenti sezioni dall'endpoint specifico della regione, ad esempio: - -`https://console..bluemix.net/admin/metrics` -{: codeblock} - -**Note**: - -1. Un utente può effettuare fino a 200 richieste API per le metriche in un'ora. -2. Ogni richiesta API restituisce fino a 200 punti dati per richiesta. Se sono disponibili più dati, viene fornito un URL per il caricamento della successiva serie di dati. -3. Ogni richiesta API richiede che un utente disponga almeno dell'accesso di base alla Console di gestione. Potrebbero essere richieste delle autorizzazioni aggiuntive, come specificato di seguito. - -## Raccolta delle metriche sul tuo ambiente - -Puoi utilizzare l'API di ambiente sperimentale per raccogliere le informazioni sull'ambiente di alto livello in un periodo di tempo che specifichi. Vengono restituiti i punti dati nel periodo di tempo che specifichi. I dati sono registrati approssimativamente ogni ora. Se, ad esempio, hai richiesto sei ore di dati CPU per l'ambiente, la risposta includerà i dati CPU per ognuna delle sei ore richieste. - - -### Endpoint di ambiente - -Puoi utilizzare il seguente endpoint per richiamare questo comando API: `/api/v1/env` - -**Nota**: per accedere a questi endpoint, è richiesta una delle seguenti autorizzazioni: **Accesso di base**, **Lettura utente**, **Scrittura utente** o **Superuser** - -### Parametri della query delle metriche di ambiente - -Utilizzando i seguenti parametri della query, puoi raccogliere le metriche per i tuoi CPU, disco, memoria, rete, quota e applicazioni: - -
-
metrica
-
Uno o più dei seguenti valori, separati da virgole: `memory`, `disk`, `cpu`, `network`, `quota` e `apps`.
-
OraInizio
-
Il primo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata una OraInizio, viene incluso il primo punto dati disponibile. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraInizio di 14.
-
OraFine
-
L'ultimo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata alcuna OraFine, viene utilizzato il punto dati più recente. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraFine di 17.
-
ordinamento
-
L'ordinamento in cui vengono restituiti i dati. I valori validi sono `asc` (crescente) e `desc` (decrescente). Il valore predefinito è decrescente, che restituisce prima i dati più recenti.
-
- -Il seguente esempio utilizza i parametri di query per raccogliere le metriche relative al tuo ambiente: - -``` -curl -b ./cookies.txt --header "Accept: application/json" https://console..bluemix.net/admin/metrics/api/v1/env?metric=cpu,network,disk,apps,memory -``` -{: codeblock} - - -### Formato dei dati delle metriche di ambiente - -Le seguenti sezioni forniscono il formato dei dati. - - * Per raccogliere i dati registrati sul tuo utilizzo della memoria, utilizza il seguente formato dei dati: - -``` -{ - "sample_time": 1477494000000, - "memory": { - "total": { - "physical": { - "total_gb": 1728, - "used": { - "value_gb": 673.68, - "percent": 38.99 - } - }, - "allocated": { - "reserved_gb": 3456, - "total_allocated": { - "value_gb": 2575.18, - "percent": 74.51 - } - }, - }, - "cell": { - "physical": { - "total_gb": 864, - "used": { - "value_gb": 336.84, - "percent": 38.99 - } - }, - "allocated": { - "reserved_gb": 1728, - "total_allocated": { - "value_gb": 1287.59, - "percent": 74.51 - } - }, - }, - "dea": { - "physical": { - "total_gb": 864, - "used": { - "value_gb": 336.84, - "percent": 38.99 - } - }, - "allocated": { - "reserved_gb": 1728, - "total_allocated": { - "value_gb": 1287.59, - "percent": 74.51 - } - }, - }, - "memory_by_container": [ - { - "name": "dea_next/0", - "type": "dea", - "ip": "169.53.225.93", - "percent": "47" - }, - { - "name": "dea_next/1", - "type": "dea", - "ip": "169.53.225.89", - "percent": "51" - }, - { - "name": "dea_next/2", - "type": "dea", - "ip": "169.53.230.49", - "percent": "45" - }, - { - "name": "dea_next/3", - "type": "dea", - "ip": "169.44.109.231", - "percent": "43" - } - ] - } -} -``` -{: screen} - - * Per raccogliere i dati registrati sul tuo utilizzo del disco, utilizza il seguente formato dei dati: - -``` -{ - "sample_time": 1477494000000, - "disk": { - "total": { - "physical": { - "total_gb": 16200, - "used": { - "value_gb": 1614, - "percent": 9.96 - } - }, - "allocated": { - "reserved_gb": 32400, - "total_allocated": { - "value_gb": 3979, - "percent": 12.28 - } - }, - }, - "cell": { - "physical": { - "total_gb": 8100, - "used": { - "value_gb": 807, - "percent": 9.96 - } - }, - "allocated": { - "reserved_gb": 16200, - "total_allocated": { - "value_gb": 1989.5, - "percent": 12.28 - } - }, - }, - "dea": { - "physical": { - "total_gb": 8100, - "used": { - "value_gb": 807, - "percent": 9.96 - } - }, - "allocated": { - "reserved_gb": 16200, - "total_allocated": { - "value_gb": 1989.5, - "percent": 12.28 - } - }, - }, - "disk_by_container": [ - { - "name": "dea_next/0", - "type": "dea", - "ip": "169.53.225.93", - "percent": "13" - }, - { - "name": "dea_next/1", - "type": "dea", - "ip": "169.53.225.89", - "percent": "14" - }, - { - "name": "dea_next/2", - "type": "dea", - "ip": "169.53.230.49", - "percent": "13" - }, - { - "name": "dea_next/3", - "type": "dea", - "ip": "169.44.109.231", - "percent": "12" - } - ] - } -} -``` -{: screen} - - * Per raccogliere i dati registrati sul tuo utilizzo della CPU, utilizza il seguente formato dei dati: - -``` -{ - "sample_time": 1477494000000, - "cpu": { - "total": { - "average_percent_cpu_used": 14.725 - }, - "cell": { - "average_percent_cpu_used": 19 - }, - "dea": { - "average_percent_cpu_used": 10.45 - }, - "cpu_by_container": [ - { - "name": "dea_next/0", - "type": "dea", - "ip": "169.53.225.93", - "sys_percent": "8.4", - "user_percent": "2.7", - "wait_percent": "0.0" - }, - { - "name": "dea_next/1", - "type": "dea", - "ip": "169.53.225.89", - "sys_percent": "7.4", - "user_percent": "2.4", - "wait_percent": "0.0" - }, - { - "name": "cell/1", - "type": "cell", - "ip": "169.53.230.49", - "sys_percent": "5.3", - "user_percent": "1.9", - "wait_percent": "0.0" - }, - { - "name": "cell/2", - "type": "cell", - "ip": "169.44.109.231", - "sys_percent": "8.2", - "user_percent": "22.6", - "wait_percent": "0.0" - } - ] - } -} -``` -{: screen} - - * Per raccogliere i dati registrati sulla tua rete, utilizza il seguente formato dei dati: - -``` -{ - "sample_time": 1477494000000, - "network": { - "datapower": { - "response_times": [ - { - "proxy": "custom_certificates", - "ten_seconds_ms": "0", - "one_minute_ms": "0", - "ten_minutes_ms": "0", - "one_hour_ms": "0", - "one_day_ms": "0" - }, - { - "proxy": "bluemix", - "ten_seconds_ms": "90", - "one_minute_ms": "89", - "ten_minutes_ms": "83", - "one_hour_ms": "85", - "one_day_ms": "95" - } - ], - "transactions": [ - { - "proxy": "custom_domains", - "ten_seconds_ms": "0", - "one_minute_ms": "0", - "ten_minutes_ms": "0", - "one_hour_ms": "0", - "one_day_ms": "0" - }, - { - "proxy": "bluemix", - "ten_seconds_ms": "697", - "one_minute_ms": "747", - "ten_minutes_ms": "802", - "one_hour_ms": "794", - "one_day_ms": "730" - } - ], - "bandwidth": { - "in_kbps": 10855, - "out_kbps": 38090 - } - } -} -``` -{: screen} - -* Per raccogliere i dati registrati sul tuo utilizzo della quota, utilizza il seguente formato dei dati: - -``` -{ - "sample_time": 1477494000000, - "quota": { - "reserved_memory": { - "total_bytes": 33176474877952 - }, - "services": { - "total": 111650 - }, - "routes": { - "total": 1675000 - } - } -} -``` -{: screen} - -* Per raccogliere i dati registrati sulle tue applicazioni, utilizza il seguente formato dei dati: - -``` -{ - "sample_time": 1477494000000, - "apps": { - "count": 1406, - "allocation": { - "memory_gb": 571.8, - "disk_gb": 1204 - } - } -} -``` -{: screen} - -### Formato della risposta delle metriche di ambiente - -``` -{ - docs: [], - next_url: -} -``` -{: screen} - -## Raccolta delle metriche sulle tue organizzazioni - -I dati vengono registrati per tutte le organizzazioni approssimativamente ogni ora. Una richiesta per una metrica particolare restituisce le informazioni per tutte le organizzazioni in ogni esempio di dati nel periodo di tempo che specifichi, ordinate in modo decrescente per la metrica richiesta. Ad esempio, la richiesta di tutte le organizzazioni per memoria in un periodo di tempo di 6 ore in un ambiente con 200 applicazioni restituisce 1200 record, 200 alla volta. - -Per ridurre la quantità di informazioni restituite per ogni esempio di dati nel periodo di tempo richiesto, puoi specificare un'opzione di conteggio. Utilizzando il precedente esempio e aggiungendo un'opzione di conteggio di 5, vengono restituiti 30 record che rappresentano le prime 5 organizzazioni per memoria per ogni esempio di dati. - -### Endpoint delle organizzazioni - -Puoi utilizzare i seguenti endpoint per richiamare questo comando API: -* `/api/v1/org/memory/physical` -* `/api/v1/org/memory/reserved` -* `/api/v1/org/disk/physical` -* `/api/v1/org/disk/reserved` - -**Nota**: per accedere a questi endpoint, è richiesta una delle seguenti autorizzazioni: **Lettura utente**, **Scrittura utente** o **Superuser** - -### Parametri di query delle organizzazioni - -Utilizza i seguenti parametri della query per raccogliere le metriche per le tue organizzazioni: - -
-
OraInizio
-
Il primo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata una OraInizio, viene incluso il primo punto dati disponibile. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraInizio di 14.
-
OraFine
-
L'ultimo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata alcuna OraFine, viene utilizzato il punto dati più recente. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraFine di 17.
-
conteggio
-
Il numero di record da restituire in ogni esempio di dati. -
-
minValue
-
Il valore minimo da restituire per la metrica specificata. Se non si specifica alcun minValue, vengono restituiti tutti i valori. Ad esempio, per raccogliere organizzazioni che utilizzano almeno 20000 byte di memoria fisica, specifica un minValue di 20000. -
-
- -Il seguente esempio raccoglie le metriche relative alle tue organizzazioni: - -``` -curl -b ./cookies.txt --header "Accept: application/json" https://console..bluemix.net/admin/metrics/api/v1/org/memory/physical?count=5&startTime=2016-12-02T16:54:09.467Z -``` -{: codeblock} - -### Formato della risposta delle organizzazioni - -``` -{ - docs: [], - next_url: -} -``` -{: screen} - -Ogni documento restituito rappresenta le metriche richieste per un'organizzazione in ogni esempio di dati, al momento della richiesta. - -## Raccolta delle metriche sulle tue applicazioni - -I dati vengono registrati per tutte le applicazioni approssimativamente ogni ora. Una richiesta per una metrica particolare restituisce le informazioni per tutte le applicazioni in ogni esempio di dati nel periodo di tempo che specifichi, ordinate in modo decrescente per la metrica richiesta. Ad esempio, la richiesta di tutte le applicazioni per la CPU in un periodo di tempo di 6 ore in un ambiente con 200 applicazioni restituisce 1200 record, 200 alla volta. - -Per ridurre la quantità di informazioni restituite per ogni esempio di dati nel periodo di tempo richiesto, puoi specificare un'opzione di conteggio. Utilizzando il precedente esempio e aggiungendo un'opzione di conteggio di 5, vengono restituiti 30 record che rappresentano le prime 5 applicazioni per CPU per ogni esempio di dati. - -### Endpoint delle applicazioni - -Puoi utilizzare i seguenti endpoint per richiamare questo comando API: -* `/api/v1/app/cpu/physical` -* `/api/v1/app/memory/physical` -* `/api/v1/app/memory/reserved` -* `/api/v1/app/disk/physical` -* `/api/v1/app/disk/reserved` - -**Nota**: per accedere a questi endpoint, è richiesta una delle seguenti autorizzazioni: **Lettura utente**, **Scrittura utente** o **Superuser** - -### Parametri della query delle applicazioni - -Utilizza i seguenti parametri della query per raccogliere le metriche per le tue applicazioni: - -
-
OraInizio
-
Il primo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata una OraInizio, viene incluso il primo punto dati disponibile. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraInizio di 14.
-
OraFine
-
L'ultimo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata alcuna OraFine, viene utilizzato il punto dati più recente. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraFine di 17.
-
conteggio
-
Il numero di record da restituire in ogni esempio di dati. -
-
minValue
-
Il valore minimo da restituire per la metrica specificata. Se non si specifica alcun minValue, vengono restituiti tutti i valori. Ad esempio, per raccogliere applicazioni che utilizzano almeno 20000 byte di memoria fisica, specifica un minValue di 20000. -
-
- -Il seguente esempio raccoglie le metriche relative alle tue applicazioni: - -``` -curl -b ./cookies.txt --header "Accept: application/json" https://console..bluemix.net/admin/metrics/api/v1/app/cpu/physical?count=5&startTime=2016-12-02T16:54:09.467Z -``` -{: codeblock} - - -### Formato della risposta delle applicazioni - -``` -{ - docs: [], - next_url: -} -``` -{: screen} - -Ogni documento restituito rappresenta le metriche richieste per un'applicazione in ogni esempio di dati, al momento della richiesta. - - -## API del servizio personalizzato -{: #servicebrokerapi} - -Sono disponibili tre API che ti consentono di registrare o creare un servizio, di aggiornare un servizio e di eliminare un servizio. - -Tutte le API sono relative a https://console.<subdomain>.bluemix.net/. - -
-
<dominiosecondario>
-
Questo valore è il nome della tua istanza locale o dedicata. Il nome del dominio secondario per la tua istanza {{site.data.keyword.Bluemix}} è stato -assegnato durante l'onboarding.
-
- -## Registrazione di un nuovo servizio - -Utilizza i seguenti esempi di API e codice per registrare un nuovo servizio. - -### Rotta -{: #registerroute} - -``` -POST /codi/v1/serviceBrokers -``` -{: screen} - -### Richiesta -{: #registerrequest} - -{: #ld_table15} - -| **Nome** | **Descrizione** | -|-----------------|-------------------| -| name | Nome del broker dei servizi. | -| auth_username | Nome utente utilizzato per connettersi al broker dei servizi. | -| auth_password | Password utilizzata per connettersi al broker dei servizi. | -| broker_url | URL utilizzato per connettersi al broker dei servizi. | -| owningOrganization | Organizzazione iniziale per cui aggiungere il servizio nell'elenco elementi consentiti. | -{: caption="Table 15. Fields" caption-side="top"} - -#### Corpo -{: #registerbody} - -``` -{ - "name" : "Nome del broker dei servizi", - "auth_username" : "nome utente", - "auth_password" : "password", - "broker_url" : "https://broker.comp.com", - "owningOrganization" : "ORG" -} -``` -{: screen} - -#### Intestazioni -{: #registerheaders} - -``` -Autorizzazione: bearer eyJ0eXAiOiJKV1QiLCJhbG ... ciOiJIUzI1 -Host: console.comp.bluemix.net -Content-Type: application/json -``` -{: screen} - -### Risposta -{: #registerresponse} - -#### Stato -{: #registerstatus} - -``` -201 Creato -``` -{: screen} - -#### Corpo -{: #registerbody2} - -``` -{ - "_id": "2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68", - "name": "Service broker's name", - "broker_url": "https://provision-broker.comp.bluemix.net/bmx/provisioning/brokers/2063580064-8f23230c-7f36-4ce5-a298-2ab4108f1120", - "proxy_broker_url": "https://provision-broker.dys0.bluemix.net/bmx/provisioning/brokers/2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68", - "auth_username": "username", - "created_on": "2016-09-30T16:45:56.304Z" -} - -``` -{: screen} - -## Aggiornamento di un servizio - -Utilizza i seguenti esempi di API e codice per aggiornare un servizio. - -### Rotta -{: #updateroute} - -`PUT /codi/v1/serviceBrokers` -{: screen} - -### Richiesta -{: #updaterequest} - -{: #ld_table16} - -| **Nome** | **Descrizione** | -|-----------------|-------------------| -| name | Nome del broker dei servizi. Questo nome non può essere modificato dal nome con cui è stato creato il servizio. | -| auth_username | Nome utente utilizzato per connettersi al broker dei servizi. | -| auth_password | Password utilizzata per connettersi al broker dei servizi. | -| broker_url | URL utilizzato per connettersi al broker dei servizi. | -| owningOrganization | Organizzazione iniziale per cui aggiungere il servizio nell'elenco elementi consentiti. | -{: caption="Table 16. Requests" caption-side="top"} - -#### Corpo -{: #updatebody} - -``` -{ - "name" : "Nome del broker dei servizi", - "auth_username" : "nome utente", - "auth_password" : "nuova password", - "broker_url" : "https://broker.comp.com", - "owningOrganization" : "ORG" -} -``` -{: screen} - -#### Intestazioni -{: #updateheaders} - -``` -Autorizzazione: bearer eyJ0eXAiOiJKV1QiLCJhbG ... ciOiJIUzI1 -Host: console.comp.bluemix.net -Content-Type: application/json -``` -{: screen} - -### Risposta -{: #updateresponse} - -#### Stato -{: #updatestatus} - -``` -201 Creato -``` -{: screen} - -#### Corpo -{: #updatebody2} - -``` -{ - "_id": "2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68", - "name": "Service Broker's name", - "broker_url": "https://provision-broker.dys0.bluemix.net/bmx/provisioning/brokers/2063580064-d11bdd84-7556-469f-858d-2098b531f7f2", - "proxy_broker_url": "https://provision-broker.dys0.bluemix.net/bmx/provisioning/brokers/2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68", - "auth_username": "username", - "created_on": "2016-09-30T16:45:56.304Z" -} -``` -{: screen} - -## Eliminazione di un servizio - -Utilizza i seguenti esempi di API e codice per eliminare un servizio. - - -{: #ld_table17} - -| **Nome** | **Descrizione** | -|-----------------|-------------------| -| name | Nome del broker dei servizi. Questo nome non può essere modificato dal nome con cui è stato creato il servizio. | -{: caption="Table 17. Parameter" caption-side="top"} - -### Rotta - -``` -DELETE /codi/v1/serviceBrokers?name=name of service broker -``` -{: screen} - -### Richiesta -{: #deleterequest} - -#### Intestazioni -{: #deleteheaders} - -``` -Autorizzazione: bearer eyJ0eXAiOiJKV1QiLCJhbG ... ciOiJIUzI1 -Host: console.comp.bluemix.net -Content-Type: application/json -``` -{: screen} - -### Risposta -{: #deleteresponse} - -#### Stato -{: #deletestatus} - -``` -204 Nessun contenuto -``` -{: screen} - -## Gestione degli utenti con la CLI cf -{: #usingadmincli} - -Puoi gestire gli utenti per il tuo ambiente {{site.data.keyword.Bluemix_notm}} -utilizzando l'interfaccia riga di comando Cloud Foundry insieme al plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI. Ad -esempio, puoi aggiungere utenti da un registro LDAP. - -Prima di iniziare, installa l'interfaccia riga di comando cf. Il plug-in {{site.data.keyword.Bluemix_notm}} Admin -CLI richiede cf versione 6.11.2 o successive. [Scarica Cloud Foundry command line interface ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/cli/releases){: new_window}. - -**Limitazione:** l'interfaccia riga di comando Cloud Foundry non -è supportata da Cygwin. Utilizza l'interfaccia riga di comando Cloud Foundry -in una finestra riga di comando diversa da quella di Cygwin. - -### Aggiunta del plug-in {{site.data.keyword.Bluemix_notm}} Admin -CLI - -Dopo aver installato l'interfaccia riga di comandi cf, puoi -aggiungere il plug-in {{site.data.keyword.Bluemix_notm}} Admin -CLI. - -**Nota**: se avevi già installato il plug-in Gestione {{site.data.keyword.Bluemix_notm}}, per ottenere gli ultimi aggiornamenti potresti doverlo disinstallare, eliminare il repository e reinstallare il plug-in. - -Completa la seguente procedura per aggiungere il repository e installare -il plug-in: - -
    -
  1. Per aggiungere il repository del plug-in Gestione {{site.data.keyword.Bluemix_notm}}, immetti il seguente comando:

    - -cf add-plugin-repo BluemixAdmin https://console.<subdomain>.bluemix.net/cli -

    -
    -
    <dominiosecondario>
    -
    Dominio secondario dell'URL per la tua istanza {{site.data.keyword.Bluemix_notm}}.
    -
    -
    2. -
  2. Per installare il plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI, immetti il seguente comando:

    - -cf install-plugin bluemix-admin-cli -r BluemixAdmin - -
    3. -
- -Per visualizzare un elenco di comandi, immetti il seguente -comando: - -``` -cf plugins -``` -{: codeblock} - -Per ulteriore assistenza per un comando, utilizza l'opzione `-help`. - -Per ulteriori informazioni su come utilizzare il plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI, vedi [{{site.data.keyword.Bluemix_notm}} admin](../cli/plugins/bluemix_admin/index.html). +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-02-22" + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} +{:pre: .pre} +{:table: .aria-labeledby="caption"} + +# Gestione di {{site.data.keyword.Bluemix_notm}} locale e {{site.data.keyword.Bluemix_notm}} dedicato +{: #mng} + + +Se disponi dell'accesso come amministratore per {{site.data.keyword.Bluemix}} locale o {{site.data.keyword.Bluemix_notm}} dedicato, vai alla pagina **Amministrazione** per gestire risorse, monitorare l'utilizzo delle quote, amministrare le autorizzazioni utente, pianificare le notifiche di aggiornamento, visualizzare log e report di sicurezza e altro. Puoi gestire le tue organizzazioni creando degli spazi e impostando dei [ruoli e delle autorizzazioni per gli utenti](/docs/admin/index.html#oc_useradmin); vedi [Gestione delle tue organizzazioni](/docs/admin/orgs_spaces.html). +{:shortdesc} + +{: #ld_table1} + +| Quali operazioni posso eseguire? | Dettagli | +|----------------|---------| +|Monitorare l'utilizzo del sistema | Fai clic su **AMMINISTRAZIONE > UTILIZZO**. Visualizza le informazioni sul sistema, monitora l'utilizzo della CPU e pianifica l'utilizzo per ottimizzare il processo decisionale per la tua azienda. Vedi [Visualizzazione delle informazioni sull'utilizzo](/docs/admin/index.html#oc_resource).| +|Gestire il tuo catalogo | Fai clic su **AMMINISTRAZIONE > GESTIONE CATALOGO** per stabilire quali servizi sono visibili ai tuoi utenti e organizzazioni. Vedi [Gestione del tuo catalogo](/docs/admin/index.html#oc_catalog).| +|Amministrare le organizzazioni | Fai clic su **AMMINISTRAZIONE > AMMINISTRAZIONE ORGANIZZAZIONE** per creare organizzazioni, monitorare le quote per le organizzazioni e prendere decisioni rapide basate sulle esigenze. Vedi [Amministrazione delle organizzazioni](/docs/admin/index.html#oc_organizations).| +|Creare spazi e assegnare i ruoli utente | Fai clic su **Account** > **Gestisci organizzazioni** per creare gli spazi tra le tue organizzazioni. Aggiungi utenti e assegna loro dei ruoli per l'organizzazione e lo spazio. Vedi [Gestione delle tue organizzazioni](/docs/admin/orgs_spaces.html). | +|Gestire le autorizzazioni degli utenti amministrativi | Fai clic su **AMMINISTRAZIONE > AMMINISTRAZIONE UTENTI** per aggiungere e rimuovere utenti e modifica le autorizzazioni utente. Vedi [Gestione di utenti e autorizzazioni](/docs/admin/index.html#oc_useradmin). | +|Esaminare report e log | Fai clic su **AMMINISTRAZIONE > REPORT E LOG** per visualizzare i report di sicurezza e i log di controllo relativi alla tua istanza. Vedi [Visualizzazione dei report](/docs/admin/index.html#oc_report). | +|Visualizzare le informazioni sul sistema. | Fai clic su **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA** per visualizzare le informazioni di sistema, quali aggiornamenti di manutenzione in sospeso, nome e versione della tua istanza, regione, URL API, URL CLI, dettagli di configurazione LDAP, associazioni di gruppi e utenti, statistiche e domini condivisi. Vedi [Visualizzazione delle informazioni sul sistema](/docs/admin/index.html#oc_system). | +|Estendere le notifiche e impostare le sottoscrizioni notifica | Fai clic su **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso**. Puoi utilizzare webhook da integrare con un servizio Web a scelta per impostare una sottoscrizione di notifica evento per un aggiornamento o incidente. Vedi [Notifiche e sottoscrizioni di notifica](/docs/admin/index.html#oc_eventsubscription). | +{: caption="Table 1. Administrative tasks for managing your {{site.data.keyword.Bluemix_notm}} local or dedicated instance" caption-side="top"} + + + +**Suggerimento**: il dashboard Infrastruttura nella console {{site.data.keyword.Bluemix_notm}} è disponibile solo per gli account collegati negli ambienti di {{site.data.keyword.Bluemix_notm}} pubblico. + + + + + +## Notifiche e sottoscrizioni di notifica +{: #oc_eventsubscription} + +Puoi sempre conoscere lo stato del tuo ambiente consultando la pagina Stato. Non appena si verificano, gli incidenti e gli eventi di aggiornamento della manutenzione pianificata con interruzioni del servizio vengono segnalati nella pagina Stato. {{site.data.keyword.Bluemix_notm}} invia inoltre alla pagina Amministrazione dell'area Notifiche le eventuali notifiche riguardanti eventi quali aggiornamenti di manutenzione pianificati o in sospeso. + +### Notifiche + +Puoi visualizzare le notifiche riguardanti il tuo ambiente locale o dedicato, al fine di monitorare lo stato del tuo ambiente. Consulta la seguente tabella per informazioni sui diversi tipi di notifiche e sui rispettivi punti di pubblicazione. + +{: #ld_table2} + +| **Tipo di evento** | **Metodo di notifica** | +|-----------------|-------------------| +| Aggiornamenti di manutenzione | Per visualizzare uno storico e un elenco completo delle tue notifiche complete e in sospeso, fai clic su **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA** > *Numero* **in sospeso**. Ricevi anche un avviso degli eventi di aggiornamento della manutenzione pianificata con interruzioni del servizio nella pagina Stato. Fai clic su **Supporto** > **Stato**. Puoi estendere la funzionalità di notifica impostando una sottoscrizione che invia un'e-mail a destinatari di tua scelta. In alternativa, puoi impostare una sottoscrizione che utilizza dei webhook per integrare le notifiche provenienti dalla pagina Amministrazione con un servizio Web a scelta.| +| Incidenti critici | Vieni avvisato degli incidenti critici sulla pagina Stato. Fai clic su **Supporto** > **Stato**. Puoi estendere la funzionalità di notifica impostando una sottoscrizione di notifica che invia un'e-mail a un destinatario di tua scelta. In alternativa, puoi impostare una sottoscrizione che utilizza dei webhook per integrare le notifiche provenienti dalla pagina Amministrazione con un servizio Web a scelta. | +| Eventi di soglia | Puoi impostare una sottoscrizione di notifica che invia un'e-mail a un destinatario di tua scelta quando nel tuo ambiente vengono raggiunte le soglie per la quota dell'organizzazione, il disco fisico, la memoria fisica o la memoria riservata. In alternativa, puoi impostare una sottoscrizione che utilizza dei webhook per integrare le notifiche con un servizio Web di tua scelta. | +| Stato di {{site.data.keyword.Bluemix_notm}} | In qualsiasi momento puoi visualizzare l'ultimo stato della piattaforma, dei servizi e della tua istanza {{site.data.keyword.Bluemix_notm}} nella pagina Stato. Fai clic su **Supporto** > **Stato**. | +{: caption="Table 2. Event types and notifications methods" caption-side="top"} + +### Impostazione di sottoscrizioni di notifica +{: #seteventsub} + +Puoi estendere la funzionalità delle notifiche inviate alla pagina Amministrazione e alla pagina Stato, utilizzando le sottoscrizioni di notifica. Utilizza le sottoscrizioni di notifica per configurare un'e-mail personalizzata o utilizzare dei webhook da integrare con uno strumento a scelta. + * Se selezioni l'opzione e-mail, le notifiche vengono inviate agli indirizzi e-mail da te specificati. Puoi selezionare le notifiche di incidenti, aggiornamenti di manutenzione o soglie. Viene inviata una notifica e-mail iniziale. Successivamente, ogni volta che l'evento subisce delle modifiche, viene inviata un'altra notifica con la modifica apportata. + * Se selezioni l'opzione webhook, le tue notifiche vengono indirizzate direttamente a una destinazione a scelta, ad esempio un numero di telefono (tramite messaggio SMS). Puoi personalizzare il tipo di notifica, in particolare gli aggiornamenti di manutenzione, gli avvisi di incidenti critici e le soglie. Puoi scegliere se ricevere nuove notifiche oppure notifiche sulle modifiche apportate alle sottoscrizioni e puoi indicare quali informazioni includere nel corpo di ogni notifica. + +**Nota**: solo gli utenti con autorizzazione Superuser (`ops.admin`) possono impostare le sottoscrizioni di notifica. + +Per creare una sottoscrizione webhook o e-mail dalla pagina **Sottoscrizioni di notifica**, completa la seguente procedura: + +1. Passa alla pagina **Sottoscrizioni di notifica**. Vai a **INFORMAZIONI DI SISTEMA> Ambiente > Sottoscrizioni**. +2. Fai clic su **Aggiungi sottoscrizione**. +3. Completa il modulo di sottoscrizione di notifica. + + * Per creare sottoscrizioni di notifica e-mail per gli aggiornamenti di manutenzione o gli incidenti, vedi le informazioni nella [Tabella 3](index.html#emailnotmaintinc). + * Per creare sottoscrizioni di notifica e-mail per le soglie, vedi le informazioni nella [Tabella 4](index.html#emailnottrhesh). + * Per creare sottoscrizioni di notifica webhook per gli aggiornamenti di manutenzione o gli incidenti, vedi le informazioni nella [Tabella 5](index.html#webhooknotsub). + * Per creare sottoscrizioni di notifica webhook per le soglie, vedi le informazioni nella [Tabella 6](index.html#webhooknotthresh). + +4. Una volta completato il modulo, puoi scegliere tra le seguenti opzioni: + + * Fai clic su **Salva** per salvare la sottoscrizione nel tuo elenco di sottoscrizioni di notifica. + * Fare clic su **Salva e verifica** per salvare e verificare la notifica. + * Fai clic su **Salva e chiudi** per salvare la sottoscrizione nel tuo elenco di sottoscrizioni di notifica e tornare alla pagina precedente. + +{: #emailnotmaintinc} + +| **Campo** | **Descrizione** | +|-----------------|-------------------| +| Abilitato | Seleziona questa opzione per abilitare le notifiche e-mail. Deselezionare l'opzione per disabilitare la notifica e-mail. Le sottoscrizioni sono abilitate per impostazione predefinita. | +| Tipo | Seleziona **E-mail**. | +| Evento | Seleziona l'opzione per sottoscrivere le notifiche di un evento di **Manutenzione** o **Incidente**. | +| Combina notifiche | Seleziona l'opzione per combinare le notifiche di incidente di tutte le regioni in una singola notifica. Questa opzione è disponibile solo per gli incidenti. | +| Oggetto | Compila la riga oggetto dell'e-mail. Questo campo è obbligatorio. | +| Corpo | Immetti il testo del corpo del messaggio da inviare nell'e-mail. Puoi utilizzare i valori payload IBM per inserire nella notifica e-mail informazioni pertinenti. Vedi la tabella [Valori della sezione di payload di manutenzione e incidenti](index.html#payload) per identificare i valori utilizzabili. Utilizza tag HTML di base per strutturare l'e-mail. Questo campo è obbligatorio. | +| A: | Immetti uno o più indirizzi e-mail tramite elenco separato da virgole per indicare i destinatari della notifica e-mail. Espandi le opzioni "cc" o "bcc" per inviare copia dell'e-mail ad altri destinatari. Questo campo è obbligatorio. | +| Descrizione | Aggiungi una descrizione univoca della sottoscrizione e stai creando. | +{: caption="Table 3. Fields for email notification subscriptions about thresholds" caption-side="top"} + + +{: #emailnottrhesh} + +| **Campo** | **Descrizione** | +|-----------------|-------------------| +| Abilitato | Seleziona questa opzione per abilitare le notifiche e-mail. Deselezionare l'opzione per disabilitare la notifica e-mail. Le sottoscrizioni sono abilitate per impostazione predefinita. | +| Tipo | Seleziona **E-mail**. | +| Evento | Seleziona **Soglia**. | +| Soglia | Seleziona il tipo di soglia per cui ricevere una notifica: Quota organizzazione, Disco fisico, Memoria fisica, Disco riservato o Memoria riservata. | +| Direzione soglia | Seleziona la direzione in cui spostare i dati, in ordine crescente o decrescente, quando si supera il valore Notifica quando incrociato che hai impostato. Ad esempio, se il valore di Notifica quando incrociato è 50%, e la direzione è decrescente, riceverai una notifica solo se la percentuale di utilizzo va da più di 50% a meno di 50%. Se imposti la direzione su Crescente, riceverai una notifica quando la percentuale di utilizzo va da meno di 50% a più di 50%. | +| Notifica quando incrociato superiore a (%) | Immetti la percentuale di soglia per cui ricevere una notifica. Se nel campo Direzione soglia hai scelto la proprietà Crescente, la notifica e-mail viene inviata quando la soglia supera questa percentuale. | +| Notifica quando incrociato inferiore a (%) | Immetti la percentuale di soglia per cui ricevere una notifica. Se nel campo Direzione soglia hai scelto la proprietà Decrescente, la notifica e-mail viene inviata quando la soglia scende sotto questa percentuale. | +| Descrizione | Aggiungi una descrizione univoca della sottoscrizione e stai creando. | +| Oggetto | Compila la riga oggetto dell'e-mail. Questo campo è obbligatorio. | +| Corpo del messaggio | Immetti il testo del corpo del messaggio da inviare nell'e-mail. Puoi utilizzare i valori payload IBM per inserire nella notifica e-mail informazioni pertinenti. Vedi la tabella [Valori della sezione di payload di soglia](index.html#threshpayload) per identificare i valori utilizzabili. Utilizza tag HTML di base per strutturare l'e-mail. Questo campo è obbligatorio. | +| A: | Immetti uno o più indirizzi e-mail tramite elenco separato da virgole per indicare i destinatari della notifica e-mail. Espandi le opzioni "cc" o "bcc" per inviare copia dell'e-mail ad altri destinatari. Questo campo è obbligatorio. | +{: caption="Table 4. Fields for email notification subscriptions about maintenance updates or incidents" caption-side="top"} + +I dati della soglia vengono raccolti una volta ogni 6 ore. Una notifica viene inviata solo una volta quando il valore supera il valore soglia impostato. Se hai scelto la proprietà crescente, non viene inviata una nuova notifica a meno che il valore non scenda sotto la soglia e quindi la oltrepassi nuovamente. Allo stesso modo, se hai scelto la proprietà decrescente, ricevi una notifica solo se il valore supera la soglia impostata e quindi scende di nuovo sotto la soglia. + +Se non vuoi aspettare 6 ore per ricevere la notifica sul raggiungimento della soglia, dopo aver completato i campi nel modulo, puoi fare clic su **Salva e verifica** per ricevere una notifica di verifica con i dati di esempio. + +Una notifica per la soglia della Quota organizzazione include solo le organizzazioni che hanno superato la percentuale di soglia specificata nel periodo di tempo di 6 ore corrispondente a tale notifica. Le organizzazioni che hanno superato una soglia durante intervalli di 6 ore precedenti non verranno incluse, anche se rimangono sopra o sotto la soglia. Le tre risorse che compongono la quota di un'organizzazione (memoria riservata, servizi e rotte) vengono considerate separatamente quando si deve valutare se inviare una notifica sulla quota. Ad esempio, se la quantità di memoria riservata utilizzata da un'organizzazione supera il 50% della quota, una soglia della Quota organizzazione configurata con un valore di 50% comporterà l'invio di una notifica. Se il numero di servizi utilizzati dalla stessa organizzazione supera successivamente il 50% della quota, anche se la quantità di memoria utilizzata rimane invariata, la stessa sottoscrizione di soglia della Quota dell'organizzazione comporterà anch'essa l'invio di una notifica. + +{: #webhooknotsub} + +| **Campo** | **Descrizione** | +|-----------------|-------------------| +| Abilitato | Seleziona l'opzione per abilitare la notifica. Deselezionare l'opzione per disabilitare la notifica. Le sottoscrizioni sono abilitate per impostazione predefinita. | +| Tipo | Seleziona **Webhook** | +| Evento | Seleziona l'opzione per sottoscrivere le notifiche di un evento di **Manutenzione** o **Incidente**. | +| Autorizzazione | Scegli se abilitare l'autorizzazione. Le opzioni sono: **Di base** o **Nessuna**. | +| Nome utente | Se hai scelto l'autorizzazione **Di base**, immetti il tuo nome utente per il servizio Web. Se non desideri utilizzare le tue credenziali personali, puoi impostare un ID funzionale da utilizzare specificatamente con {{site.data.keyword.Bluemix_notm}}. | +| Password | Se hai scelto l'autorizzazione **Di base**, immetti la tua password per il servizio Web. | +| Descrizione | Aggiungi una descrizione univoca della sottoscrizione e stai creando. | +| Nuovo evento | Seleziona questa opzione per abilitare la notifica per i nuovi eventi di manutenzione o incidente. Deselezionare l'opzione per disabilitare la notifica. | +| Metodo | Seleziona **GET**, **POST** o **PUT**. | +| URL | Immetti l'URL per la connessione al tuo servizio Web. | +| Proprietà di risposta | Questo campo facoltativo è il nome della proprietà che identifica la risorsa creata dal tuo servizio Web quando viene inviata una richiesta POST o PUT. Se fornisci una proprietà di risposta per un nuovo evento e scegli di creare una sottoscrizione per le modifiche a un evento, dovrai fornirla anche per la sottoscrizione Modifica all'evento. A seconda del servizio Web utilizzato, puoi specificarla come parte dell'URL o come valore di payload. | +| Payload | Se hai selezionato il metodo POST o PUT, immetti le proprietà specifiche del servizio Web che stai utilizzando insieme i valori di payload utilizzati per la notifica IBM. Vedi la tabella [Valori della sezione di payload di manutenzione e incidenti](index.html#payload) per identificare i valori utilizzabili. Se non immetti informazioni in questa sezione, ricevi una notifica che non contiene informazioni aggiuntive. | +| Modifica all'evento | Seleziona questa opzione per creare sottoscrizioni di notifica relative alle modifiche agli eventi di manutenzione o incidenti per cui hai creato le sottoscrizioni. Deselezionare l'opzione per disabilitare la notifica. | +| Utilizza valori e payload da Nuovo evento | Usa il contenuto del campi Metodo, URL e Payload della sezione Nuovo evento. Nota che se l'opzione è selezionata, questi campi non sono disponibili per ulteriori modifiche nella sezione Modifica all'evento. | +| Metodo | Seleziona **GET**, **POST** o **PUT**. | +| URL | Immetti l'URL per la connessione al tuo servizio Web. | +| Payload | Se hai selezionato il metodo POST o PUT, immetti le proprietà specifiche del servizio Web che stai utilizzando insieme i valori di payload utilizzati per la notifica IBM. Vedi la tabella [Valori della sezione di payload di manutenzione e incidenti](index.html#payload) per identificare i valori utilizzabili. Se non immetti informazioni in questa sezione, ricevi una notifica che non contiene informazioni aggiuntive. | +| Combina notifiche | Seleziona l'opzione per combinare le notifiche di incidente di tutte le regioni in una singola notifica. Questa opzione è disponibile solo per gli incidenti. | +{: caption="Table 5. Form fields for a webhook notification subscription about maintenance or incidents" caption-side="top"} + + +{: #webhooknotthresh} + +| **Campo** | **Descrizione** | +|-----------------|-------------------| +| Abilitato | Seleziona l'opzione per abilitare la notifica. Deselezionare l'opzione per disabilitare la notifica. Le sottoscrizioni sono abilitate per impostazione predefinita. | +| Tipo | Seleziona **Webhook**. | +| Evento | Seleziona **Soglia**. | +| Soglia | Seleziona il tipo di soglia per cui ricevere una notifica: Quota organizzazione, Disco fisico, Memoria fisica, Disco riservato o Memoria riservata.| +| Direzione soglia | Scegli se visualizzare i dati di soglia in ordine crescente o decrescente. | +| Notifica quando incrociato inferiore a (%) | Se hai selezionato la **Direzione di soglia** **Decrescente**, immetti la percentuale di soglia per cui ricevere una notifica. Quando la soglia scende sotto questa percentuale, viene inviata una notifica webhook. | +| Notifica quando incrociato superiore a (%) | Se hai selezionato la **Direzione di soglia** **Crescente**, immetti la percentuale di soglia per cui ricevere una notifica. Quando la soglia supera questa percentuale, viene inviata una notifica webhook. | +| Descrizione | Aggiungi una descrizione univoca della sottoscrizione e stai creando. | +| Autorizzazione | Scegli se abilitare l'autorizzazione. Le opzioni sono: **Di base** o **Nessuna**. | +| Nome utente | Se hai scelto l'autorizzazione di base, immetti il tuo nome utente per il servizio Web. Se non desideri utilizzare le tue credenziali personali, puoi impostare un ID funzionale da utilizzare specificatamente con {{site.data.keyword.Bluemix_notm}}. | +| Password | Se hai scelto l'autorizzazione di base, immetti la tua password per il servizio Web. | +| Metodo | Seleziona **GET**, **POST** o **PUT**. | +| URL | Immetti l'URL per la connessione al tuo servizio Web. | +{: caption="Table 6. Form fields for a webhook notification subscription about thresholds" caption-side="top"} + +I dati della soglia vengono raccolti una volta ogni 6 ore. Una notifica viene inviata solo una volta quando il valore supera il valore soglia impostato. Non viene inviata una nuova notifica a meno che il valore non vada al di sotto della soglia (se hai scelto la proprietà crescente) e quindi la risuperi nuovamente. Allo stesso modo, se hai scelto la proprietà decrescente, ricevi una nuova una notifica se il valore supera la soglia impostata e quindi scende di nuovo sotto la soglia. + +Se non vuoi aspettare 6 ore per ricevere la notifica sul raggiungimento della soglia, dopo aver completato i campi nel modulo, puoi fare clic su **Salva e verifica** per salvare e verificare la notifica con i dati di esempio. + +Una notifica per la soglia della Quota organizzazione include solo le organizzazioni che hanno superato la percentuale di soglia specificata nel periodo di tempo di 6 ore corrispondente a tale notifica. Le organizzazioni che hanno superato una soglia durante intervalli di 6 ore precedenti non verranno incluse, anche se rimangono sopra o sotto la soglia. Le tre risorse che compongono la quota di un'organizzazione, ossia memoria riservata, servizi e rotte, vengono considerate separatamente quando si deve valutare se inviare una notifica sulla quota. Ad esempio, se la quantità di memoria riservata utilizzata da un'organizzazione supera il 50% della quota, una soglia della Quota organizzazione configurata con un valore di 50% comporterà l'invio di una notifica. Se il numero di servizi utilizzati dalla stessa organizzazione supera successivamente il 50% della quota, anche se la quantità di memoria utilizzata rimane invariata, la stessa sottoscrizione di soglia della Quota dell'organizzazione comporterà anch'essa l'invio di una notifica. + +{: #payload} + +| **Valore IBM** | **Descrizione** | **Tipo di evento** | +|----------------|----------------|------------------------| +| {{content.category}} | Servizi interessati | Incidente | +| {{content.disruption}} | Componenti interessati | Aggiornamento di manutenzione | +| {{content.message}} | Descrizione del messaggio | Aggiornamento di manutenzione e incidente | +| {{content.scheduleWindow.start}} | Data di inizio pianificata per l'aggiornamento | Aggiornamento di manutenzione | +| {{content.scheduleWindow.end}} | Ora di fine pianificata per l'aggiornamento | Aggiornamento di manutenzione | +| {{content.severity}} | Classificazione della severità | Incidente | +| {{content.subCategoryName}} | Componenti interessati | Incidente | +| {{content.title}} | Titolo del messaggio | Aggiornamento di manutenzione e incidente | +| {{region}} | Regione interessata | Aggiornamento di manutenzione e incidente | +| {{status}} | Stato dell'aggiornamento | Aggiornamento di manutenzione | +| {{type}} | Aggiornamento o incidente | Aggiornamento di manutenzione e incidente | +{: caption="Table 7. Maintenance and incident payload section values" caption-side="top"} + + +{: #threshpayload} + +| **Valore IBM** | **Descrizione** | **Tipo di evento** | +|----------------|----------------|------------------------| +| {{content.org_quota}} | Soglia quota organizzazione | Soglia | +| {{content.physical_disk}} | Soglia disco fisico | Soglia | +| {{content.physical_memory}} | Soglia memoria fisica | Soglia | +| {{content.reserved_disk}} | Soglia disco riservato | Soglia | +| {{content.reserved_memory}} | Soglia memoria riservata | Soglia | +{: caption="Table 8. Threshold payload section values" caption-side="top"} + +Quando salvi la tua sottoscrizione di notifica, ricevi notifiche attraverso il metodo che hai impostato. Le notifiche vengono ancora pubblicate nelle seguenti posizioni: + * Nella pagina Stato per gli incidenti + * Nella pagina Stato per gli eventi di aggiornamento della manutenzione pianificata con interruzioni del servizio + * Nell'area Notifica della pagina Amministrazione per gli aggiornamenti di manutenzione + +Puoi selezionare qualsiasi sottoscrizione di notifica salvata, visualizzare le attività recenti o modificarle come necessario. Fai clic per espandere qualsiasi voce delle attività recenti per visualizzare i dettagli della cronologia. + +## Aggiornamenti di manutenzione +{: #oc_schedulemaintenance} + +Puoi visualizzare gli aggiornamenti di manutenzione pianificata e in sospeso solo se disponi dell'autorizzazione superuser (`ops.admin`), facendo clic su **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso** per accedere alla pagina **Aggiornamenti di sistema**. Tutti gli utenti del tuo ambiente possono visualizzare gli eventi di aggiornamento della manutenzione pianificata con interruzioni del servizio facendo clic su **Supporto** > **Stato**. + +**Nota**: consultare la seguente sezione per [Impostazione di finestre di manutenzione preapprovate](index.html#preapprovedmaintenance). Queste finestre devono essere impostate per consentire a IBM di pianificare la manutenzione per il tuo ambiente. + +
+
Aggiornamenti che non comportano interruzioni del servizio
+
Un aggiornamento che non comporta interruzioni del servizio non influenza il tuo ambiente, le tue applicazioni in esecuzione o l'accesso dei tuoi utenti alle tue applicazioni. Questo tipo di aggiornamento non richiede un'approvazione caso per caso e verrà applicato durante le finestre di manutenzione disponibili preapprovate da te impostate dalla pagina Aggiornamenti di sistema.
+
Aggiornamenti che comportano interruzioni del servizio
+
Un aggiornamento che comporta interruzioni del servizio può influenzare il tuo ambiente, le applicazioni in esecuzione o l'accesso dei tuoi utenti alle tue applicazioni. Devi pianificare e approvare ciascuno di questi aggiornamenti di manutenzione entro la finestra di manutenzione di 21 giorni assegnata. Puoi selezionare l'ora e la data di distribuzione suggerita, l'opzione per qualsiasi finestra preapprovata da te oppure aprire il calendario per selezionare tre date/ore specifiche tra cui IBM può scegliere durante la pianificazione dell'aggiornamento.
+
+ + +### Impostazione delle finestre di manutenzione preapprovate +{: #preapprovedmaintenance} + +Gli aggiornamenti di manutenzione che non comportano interruzioni del servizio sono pianificati per essere eseguiti durante finestre temporali preapprovate. Per impostazione predefinita, vengono create due finestre di aggiornamenti disponibili settimanali per il tuo sistema. Queste finestre sono in genere impostate per ripetersi ogni sabato e domenica sera. Puoi modificare le impostazioni predefinite in uno dei seguenti modi: + * Modifica le finestre di aggiornamento predefinite scegliendo un giorno e/o un'ora di inizio differenti. + * Crea una finestra di aggiornamento e quindi elimina la finestra predefinita + +Per salvare le modifiche, devi comunque rispettare il periodo di tempo minimo richiesto per ogni settimana. + +Devi impostare un minimo di 12 ore disponibili in una settimana per un periodo minimo di due giorni per ogni settimana. Ad esempio, puoi impostare finestre temporali di sei ore in due giorni distinti o puoi impostare finestre di quattro ore in tre giorni diversi. Per accertarti che le finestre temporali siano sufficienti per consentire l'applicazione di un aggiornamento, la durata minima di ciascuna finestra deve essere pari a 4 ore. + +**Nota**: solo gli utenti con autorizzazione Superuser (`ops.admin`) possono pianificare e approvare gli aggiornamenti di manutenzione. + +1. Vai a **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso > Gestisci disponibilità**. +2. Espandi la sezione **Gestisci finestre di aggiornamento disponibili**. +3. Fai clic su **Aggiungi nuovo** ![Aggiungi nuovo](images/add-new.png). +4. Imposta la prima finestra di disponibilità selezionando la frequenza, la durata e l'ora di inizio per la finestra. +5. Facoltativo: seleziona **Contrassegna come preferito**, se vuoi impostare la tua finestra di disponibilità ricorrente come orario preferito per le distribuzioni da pianificare. Le finestre temporali preferiti avranno la priorità, laddove possibile. +6. Fai clic su **Inoltra**. +7. Ripeti questo processo finché non hai soddisfatto i requisiti minimi per le finestre temporali settimanali. + +### Impostazione delle finestre di manutenzione non disponibili +{: #blockpreapprovedmaintenance} + +Puoi scegliere di impostare specifiche finestre di aggiornamento non disponibili in cui il tuo ambiente non sarà disponibile per gli aggiornamenti di manutenzione che non comportano interruzioni del servizio. Ad esempio, puoi scegliere un fine settimana o una vacanza ad alto traffico in cui non applicare alcuna manutenzione per garantire che le tue applicazioni siano disponibili ai tuoi utenti. + +Devi impostare un minimo di 12 ore disponibili in una settimana per un periodo minimo di due giorni per ogni settimana. Se tenti di creare una finestra di aggiornamento non disponibile, potresti non riuscire a salvare le modifiche qualora questa nuova finestra faccia sì che il sistema scenda al di sotto del minimo settimanale richiesto. In questo caso, devi prima rimuovere alcune finestre di aggiornamento non disponibili esistenti o aggiungerne delle altre prima di poter salvare la nuova finestra di aggiornamento non disponibile. Per ulteriori informazioni, vedi [Impostazione delle finestre di manutenzione preapprovate](index.html#preapprovedmaintenance). + +1. Vai a **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso > Gestisci disponibilità**. +2. Espandi la sezione **Gestisci finestre di aggiornamento non disponibili**. +3. Fai clic su **Aggiungi nuovo** ![Aggiungi nuovo](images/add-new.png). +4. Imposta la tua finestra non disponibile selezionando la frequenza, la durata e l'ora di inizio per la finestra. +5. Fai clic su **Inoltra**. + +### Pianificazione e approvazione di aggiornamenti +{: #scheduleandapprove} + +Dopo che hai impostato le tue finestre di manutenzione preapprovate, gli aggiornamenti che non comportano interruzioni del servizio verranno automaticamente pianificati durante questi periodi. Per questi tipi di aggiornamenti non è richiesta la tua approvazione esplicita. Puoi tuttavia visualizzare i dettagli per ciascun aggiornamento di manutenzione, compresa l'indicazione di cosa si sta aggiornando, quanto ci vorrà per l'aggiornamento e quando esso è pianificato. + +Per visualizzare i dettagli per un aggiornamento che non comporta l'interruzione del servizio, completa la seguente procedura: + +1. Vai a **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso** +2. Identifica le righe in cui **Pianificazione cliente obbligatoria** è impostato su **No**. +3. Seleziona la riga per l'aggiornamento di cui visualizzare i dettagli. + +Un aggiornamento che comporta interruzioni del servizio può influenzare il tuo ambiente, le applicazioni in esecuzione o l'accesso dei tuoi utenti alle tue applicazioni. Devi pianificare e approvare ciascuno di questi aggiornamenti di manutenzione entro la finestra di manutenzione di 21 giorni assegnata. Puoi selezionare l'ora e la data di distribuzione suggerita, l'opzione per qualsiasi finestra preapprovata da te oppure aprire il calendario per selezionare tre date/ore specifiche tra cui IBM può scegliere durante la pianificazione dell'aggiornamento. + +Per gli aggiornamenti che comportano un'interruzione del servizio che richiedono la tua approvazione, completa la seguente procedura: + +1. Vai a **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA > *Numero* in sospeso** +2. Identifica le righe in cui **Pianificazione cliente obbligatoria** è impostato su **Sì**. +3. Seleziona la riga per di un aggiornamento per esaminarne i dettagli, compresi la sua descrizione, la sua data e ora consigliata, i componenti interessati e la sua durata. +4. Seleziona **Pianifica e approva**. +5. Scegli una delle seguenti opzioni: **Data suggerita**, **Date alternative** o **Qualsiasi finestra preapprovata**. Se selezioni **Date alternative**, puoi aprire il calendario per selezionare tre opzioni tra cui può scegliere IBM. +6. Facoltativo: dall'elenco di date alternative selezionate nel calendario, seleziona quelle che desideri impostare come preferite per la distribuzione. Ogni data selezionata viene indicata come preferita per il deployer che pianificherà la distribuzione. IBM tenta di pianificare la manutenzione durante le finestre di aggiornamento preferite. +7. Quando hai finito, seleziona **Invia**. + +A seconda della tua selezione, l'aggiornamento viene pianificato in modo da essere distribuito durante la data suggerita che hai accettato, durante una delle tue finestre temporali preapprovate o in una delle date e ore specifiche che hai selezionato. Quando IBM pianifica la distribuzione dell'aggiornamento, la data prevista viene rispecchiata nei dettagli dell'aggiornamento, sulla pagina **Aggiornamenti di sistema**. Puoi ripianificare una distribuzione già pianificata solo un giorno (24 ore) prima della data e ora di inizio pianificata. Dopo aver ripianificato una distribuzione, non potrai ripianificarla di nuovo. + + +## Visualizzazione delle informazioni sul sistema +{: #oc_system} + +Per visualizzare le informazioni sul sistema, fai clic su **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA**. + +Puoi visualizzare diverse sezioni che includono aggiornamenti di sistema in sospeso, informazioni generali sul sistema, informazioni su API e CLI e +dettagli di configurazione LDAP. + +### Aggiornamenti di sistema in sospeso + +Nella sezione Aggiornamenti, puoi visualizzare il numero di notifiche di +aggiornamenti in sospeso che richiedono un tuo intervento. Ci sono due tipi che potresti vedere: + +
+
Aggiornamenti che non comportano interruzioni del servizio
+
Un aggiornamento che non comporta interruzioni del servizio non influenza il tuo ambiente, le tue applicazioni in esecuzione o l'accesso dei tuoi utenti alle tue applicazioni. Questo tipo di aggiornamento non richiede un'approvazione caso per caso. Questi aggiornamenti sono applicati nelle finestre di manutenzione disponibili preapprovate da te impostate dalla pagina Aggiornamenti di sistema.
+
Aggiornamenti che comportano interruzioni del servizio
+
Un aggiornamento che comporta interruzioni del servizio può influenzare il tuo ambiente, le applicazioni in esecuzione o l'accesso dei tuoi utenti alle tue applicazioni. Puoi pianificare e approvare ciascuno di questi aggiornamenti di manutenzione entro la finestra di manutenzione di 21 giorni assegnata per garantire che l'aggiornamento non venga applicato durante ore lavorative critiche. Puoi selezionare la data e ora di distribuzione consigliata, che si basa sulle tue finestre di aggiornamento preapprovate, oppure selezionare due ore e date aggiuntive tra cui IBM può scegliere durante l'applicazione dell'aggiornamento.
+
+ +Per ulteriori informazioni sull'impostazione delle finestre di manutenzione preapprovate e sull'impostazione di specifiche date non disponibili per la manutenzione, vedi [Aggiornamenti di manutenzione](index.html#oc_schedulemaintenance). + +### Informazioni generali sul sistema + +Nella sezione di informazioni generali, puoi visualizzare le seguenti informazioni: + +- Le informazioni di base sulla build {{site.data.keyword.Bluemix_notm}}. +- Le informazioni sull'API, compresi versione, URL, regione e un link alla documentazione della CLI. +- Le informazioni sul dominio condiviso relative al tuo sistema e al tuo servizio. +- Le statistiche sul numero totale di applicazioni, utenti e organizzazioni. + +### Dettagli configurazione LDAP + +Nella sezione Dettagli di configurazione LDAP, puoi selezionare il server LDAP +e visualizzare le informazioni relative alle associazioni di utenti e gruppi. Se stai utilizzando un WebID {{site.data.keyword.IBM}}, questo viene indicato in questa sezione. + +## Visualizzazione di utilizzo e report +{: #oc_resource} + +Puoi visualizzare differenti tipi di informazioni sull'utilizzo della tua istanza locale o dedicata e sull'account {{site.data.keyword.Bluemix_notm}}. Puoi anche scaricare e visualizzare i report e i log di sicurezza per la tua istanza {{site.data.keyword.Bluemix_notm}}. + +- Informazioni sulle risorse, quali spazio su disco, utilizzo della CPU, utilizzo della rete e tempi medi di risposta. Vedi [Utilizzo risorsa](index.html#resourceusage). +- Utilizzo dell'account per organizzazione, incluso il numero di applicazioni di runtime con utilizzo, numero totale di GB-ore di runtime e numero di istanze di servizio con relativo utilizzo. Vedi [Utilizzo dell'account](index.html#accountusage). +- Utilizzo di quote di memoria, memoria dell'applicazione assegnata in base alla percentuale totale di memoria utilizzata e una vista sull'utilizzo di GB-ore per applicazione in relazione a un'organizzazione specifica. Puoi anche visualizzare l'utilizzo della quota per tutte le organizzazioni nella pagina Amministrazione della sezione **Monitoraggio quota**. Vedi [Amministrazione organizzazione](../admin/index.html#orgusage). + + +### Utilizzo delle risorse +{: #resourceusage} + +Per visualizzare le informazioni sull'utilizzo delle risorse, fai clic su **AMMINISTRAZIONE > Utilizzo risorsa**. + +Nella sezione **Utilizzo risorsa **, puoi visualizzare le seguenti informazioni: + +- Informazioni sull'utilizzo delle risorse, ad esempio la quantità di memoria e spazio su disco che può essere riservata e quella fisicamente disponibile e la quantità di memoria e spazio su disco realmente riservata e quella fisicamente utilizzata. Puoi anche visualizzare le informazioni relative all'utilizzo medio della CPU tra tutti gli agent DEA (Droplet Execution Agent). Per informazioni più dettagliate sull'utilizzo di memoria, disco e CPU, vedi [Dettagli memoria, disco e CPU](index.html#resourceusagedetails). +- Informazioni sull'utilizzo della rete per la larghezza di banda in entrata e in uscita nelle ultime 6 ore o nel giorno precedente. I dati visualizzati sono basati sulla somma del traffico in entrata e in uscita per la rete pubblica e quella privata. +- Il tempo di risposta medio per {{site.data.keyword.Bluemix_notm}} negli ultimi 10 minuti, 1 ora e 1 giorno. +- Le transazioni medie al secondo per {{site.data.keyword.Bluemix_notm}} nel corso degli ultimi 10 minuti, dell'ultima ora e dell'ultimo giorno. + +#### Dettagli memoria, disco e CPU +{: #resourceusagedetails} + +Nella sezione **Utilizzo risorsa**, puoi vedere un riepilogo dello spazio **Riservato** e **Fisico** relativo a memoria e disco. +
+
Fisico
+
La quantità di memoria o spazio su disco che è stata acquistata per il tuo ambiente.
+
Riservato
+
La quantità totale di memoria o spazio su disco disponibile che può essere riservata da tutte le applicazioni distribuite e in esecuzione nel tuo ambiente. Poiché le applicazioni raramente utilizzano tutta la memoria riservata per loro, il valore fisico è di solito inferiore al valore riservato.
+
+ +Oltre alla rappresentazione grafica, puoi visualizzare la percentuale di memoria e spazio su disco utilizzata dal tuo ambiente. Puoi anche visualizzare la quantità riservata e fisica, in GB, dell'utilizzo reale rispetto alla quantità disponibile. + +Per visualizzare l'utilizzo della memoria, disco o CPU da parte di DEA, fai clic su **Suddivisione**. + +Per informazioni più dettagliate sull'utilizzo della memoria o del disco fisico e riservato nel tempo, fai clic su **Cronologia.** Puoi specificare l'intervallo di tempo da visualizzare come settimanale o mensile. La vista dell'utilizzo cronologico mostra un grafico di utilizzo della memoria o del disco nel corso del tempo da te scelto. +
+
Limite riservato
+
Indicato in forma di linea tratteggiata orizzontale, il limite riservato è la quantità totale di memoria o spazio su disco che può essere riservata in blocco da tutte le applicazioni in esecuzione nel tuo ambiente.
+
Riservato
+
L'area Riservato mostra la quantità di memoria o di spazio su disco che è attualmente riservata in blocco da tutte le applicazioni in esecuzione nel tuo ambiente. +

Per vedere quali organizzazioni hanno riservato la maggior parte della memoria in un determinato momento, passa il mouse sopra il punto lungo l'area Riservato associato a quel momento nel tempo. Puoi quindi fare clic su un'organizzazione nel grafico a torta che viene mostrato per visualizzare ulteriori informazioni su tale organizzazione.

+
Limite fisico
+
Indicato in forma di linea tratteggiata orizzontale, il limite fisico mostra la quantità fisica di memoria o spazio su disco che è stata acquistata per il tuo ambiente.
+
Fisico
+
L'area Fisico mostra la quantità di memoria o spazio su disco effettivamente utilizzata.
+
+ + +### Utilizzo dell'account +{: #accountusage} + +Puoi visualizzare l'utilizzo mensile del tuo account per il tuo ambiente locale o dedicato. Puoi utilizzare questi dati per sapere quanto addebitare a determinate organizzazioni in base all'uso effettuato. Tutti gli utenti della console di gestione che dispongono dell'autorizzazione **Utenti** con accesso in **Lettura** possono visualizzare i dati di utilizzo dell'account. Inoltre, i gestori di fatturazione dell'organizzazione possono visualizzare i dati di utilizzo account relativi alle proprie organizzazioni, anche se il gestore di fatturazione non dispone dell'autorizzazione **Utenti** della console di gestione. In qualità di amministratore della console di gestione (autorizzazione Superuser), puoi assegnare il ruolo di gestore di fatturazione per le organizzazioni facendo clic su **Account** > **Gestisci organizzazioni**. + +Per visualizzare i dati di utilizzo account, completa la seguente procedura: + +
    +
  1. Fai clic su Account > Dashboard di utilizzo.
    2. +
  2. Seleziona l'organizzazione per cui desideri visualizzare i dati.
    3. +
  3. Puoi vedere i dettagli di utilizzo per le seguenti categorie: +
      +
    • Applicazioni di runtime con utilizzo
      • +
    • Utilizzo totale delle applicazioni di runtime in GB-ore
      • +
    • Istanze di servizio con utilizzo
      • +
    +
    4. +
  4. Facoltativo: visualizza i tuoi dati per un mese specifico, utilizzando il menu La tua attività cloud per selezionare un mese a scelta.
    5. +
  5. Facoltativo: fai clic su ESPORTA DATI e scegli tra CSV o JSON per esportare i dati per il mese selezionato in un file CSV o JSON.
    6. +
+ +Puoi anche visualizzare l'utilizzo mensile e gli addebiti associati a livello di account per i tuoi runtime, applicazioni e servizi diffusi da {{site.data.keyword.Bluemix_notm}} pubblico. Puoi utilizzare questi dati per sapere quanto addebitare a determinate organizzazioni in base all'uso effettuato. + +
    +
  1. Fai clic su Account > Dashboard di utilizzo.
    2. +
  2. Fai clic su Pubblico.
    3. +
  3. Seleziona l'organizzazione per cui desideri visualizzare i dati.
    4. +
  4. Puoi vedere i dettagli di utilizzo per le seguenti categorie: +
      +
    • Applicazioni di runtime con utilizzo
      • +
    • Utilizzo totale delle applicazioni di runtime in GB-ore
      • +
    • Istanze di servizio con utilizzo
      • +
    • Riepilogo degli addebiti per tutte le applicazioni, i servizi e i runtime diffusi
      • +
    +
    5. +
  5. Facoltativo: visualizza i tuoi dati per un mese specifico, selezionando un mese a scelta dal grafico a barre. Per impostazione standard vengono visualizzati i dati del mese corrente.
    6. +
  6. Facoltativo: fai clic su ESPORTA DATI e scegli tra CSV o JSON per esportare i dati per il mese selezionato in un file CSV o JSON.
    7. +
+ + +### Utilizzo delle organizzazioni +{: #orgusage} + +Per visualizzare l'utilizzo per organizzazione, fai clic su **AMMINISTRAZIONE > AMMINISTRAZIONE ORGANIZZAZIONE**, quindi seleziona un'organizzazione dall'**Elenco delle organizzazioni**. Nella pagina **Gestisci organizzazioni** dell'organizzazione selezionata, puoi visualizzare le seguenti informazioni sull'utilizzo: + +- Numero di servizi attualmente in uso. +- Numero di rotte attualmente in uso. +- Grafico delle quote di memoria che mostra le percentuali di quota di memoria attualmente in uso e non in uso. +- Grafico sull'assegnazione delle applicazioni che mostra quali applicazioni sono incluse nella quota di memoria utilizzata. +- Grafico sull'utilizzo misurato dell'applicazione che mostra un report trimestrale sulle GB-ore utilizzate per applicazione distribuita. Puoi selezionare la **Vista elenco** per visualizzare i dati per tutte le applicazioni, compresa l'assegnazione di memoria per applicazione e l'utilizzo a consumo di GB-ore degli ultimi tre mesi. + +Per ulteriori informazioni sulla visualizzazione dell'utilizzo per organizzazione, sull'adeguamento dei piani di quota e sulla gestione delle tue organizzazioni, vedi [Amministrazione delle organizzazioni](../admin/index.html#oc_organizations). + +### Report +{: #oc_report} + +Puoi visualizzare i report e i log di sicurezza, quali DataPower™, firewall e controllo accessi, per la tua istanza {{site.data.keyword.Bluemix_notm}}. Per visualizzare report e log, fai clic su **AMMINISTRAZIONE > REPORT E LOG**. + +Seleziona dalle seguenti opzioni: + +- Puoi selezionare le date di inizio e di fine dai campi per filtrare i report e i log da +visualizzare. +- Puoi espandere e visualizzare i diversi report dal riquadro di navigazione. +- Puoi effettuare ricerche nella tua raccolta di report e log. La ricerca si applica ai nomi di report e al contenuto testuale +all'interno di report e log. Puoi anche scegliere di filtrare la ricerca in base +agli **Eventi di amministrazione**, ai **Report DataPower**, al **Firewall** e al **Controllo accessi**. +- Durante la visualizzazione di un report o log, puoi fare clic sull'icona ![Download](images/icon_download.png) +per scaricare il report. + +La seguente tabella mostra l'elenco dei report di sicurezza generati per {{site.data.keyword.Bluemix_notm}} locale e {{site.data.keyword.Bluemix_notm}} dedicato. La maggior parte dei report viene generata ogni giorno. Tuttavia, i report per gli eventi di gestione chiavi e crittografia vengono generati mensilmente. Tutti i report vengono conservati per 90 giorni nella console di gestione. Al termine dei 90 giorni, i report sono disponibili offline su richiesta a {{site.data.keyword.Bluemix_notm}} per 9 mesi. In totale, i report sono disponibili per il recupero per un massimo di 1 anno. + + +{: #ld_table9} + +| **Categoria** | **Report** | **Descrizione** | +|-----------------|-------------------|---------------------| +| Firewall | Accessi firewall | Eventi relativi all'accesso dell'amministratore ai dispositivi firewall Vyatta. | +| Firewall | Accessi firewall negati | Eventi generati da dispositivi firewall Vyatta quando una richiesta di accesso viene negata in base alle regole firewall in vigore. | +| Eventi di accesso dell'amministratore {{site.data.keyword.Bluemix_notm}} | Accesso amministratori {{site.data.keyword.Bluemix_notm}} | Eventi generati dal sistema operativo quando un amministratore avvia una sessione SSH su ogni sistema {{site.data.keyword.Bluemix_notm}}. | +| Eventi di accesso dello sviluppatore di applicazioni {{site.data.keyword.Bluemix_notm}} | Accesso sviluppatori di applicazioni {{site.data.keyword.Bluemix_notm}} | Eventi generati dal componente di accesso della piattaforma {{site.data.keyword.Bluemix_notm}} quando un utente di {{site.data.keyword.Bluemix_notm}} avvia una sessione utilizzando la riga comandi, le API REST o l'interfaccia utente {{site.data.keyword.Bluemix_notm}}. | +| Eventi amministrativi dell'amministratore {{site.data.keyword.Bluemix_notm}} | Eventi amministrativi di sistema operativo degli amministratori {{site.data.keyword.Bluemix_notm}} | Eventi generati dal sistema operativo quando un amministratore svolge un'azione all'interno di una sessione di lavoro corrente. | +| Eventi amministrativi dello sviluppatore di applicazioni {{site.data.keyword.Bluemix_notm}} | Eventi amministrativi {{site.data.keyword.Bluemix_notm}} (Cloud Foundry) | Eventi relativi alle operazioni effettuate dall'utente della piattaforma {{site.data.keyword.Bluemix_notm}} utilizzando la riga comandi, le API REST o l'interfaccia utente {{site.data.keyword.Bluemix_notm}}. | +| Eventi amministrativi di database dell'amministratore {{site.data.keyword.Bluemix_notm}} | Eventi amministrativi di database | Eventi relativi alle operazioni effettuate da un amministratore di database nei database interni {{site.data.keyword.Bluemix_notm}}. | +| Eventi di amministrazione | Eventi di gestione utente | Eventi relativi alle azioni di gestione utente eseguite nella pagina Amministrazione. | +| Eventi di amministrazione | Catalogo | Eventi relativi alle modifiche del catalogo dei servizi. | +| Eventi di amministrazione | Eventi di gestione dei report di sicurezza | Eventi relativi alle azioni di gestione dei report di sicurezza eseguite nella pagina Amministrazione. | +| Revisioni accesso | Report di revisioni accesso | Revisioni per accessi privilegiati. | +| Gestione modifiche | Gestione delle modifiche del software | Attività di gestione delle modifiche. | +| Gestione chiavi | Gestione dei certificati SSL personalizzati | Certificazioni SSL personalizzate che sono state caricate e archiviate. | +| Crittografia | Crittografia dei data-in-transit | Crittografia configurata per i data-in-transit. | +| Antivirus | Report di scansione antivirus | Software antivirus in uso. | +| Gestione delle correzioni software | Report di applicazione patch | Correzioni software applicate. | +| Gestione degli incidenti di sicurezza | Report di correzione incidenti di sicurezza | Prove di incidenti di sicurezza per consentirne la gestione. | +{: caption="Table 9. Security report list" caption-side="top"} + +## Visualizzazione dello stato +{: #oc_status} + +Puoi visualizzare lo stato per l'ambiente {{site.data.keyword.Bluemix_notm}} e per la console di gestione. + +### Stato dell'ambiente {{site.data.keyword.Bluemix_notm}} + +Puoi monitorare lo stato per la tua istanza {{site.data.keyword.Bluemix_notm}} utilizzando la pagina Stato di {{site.data.keyword.Bluemix_notm}}. Fai clic su **Supporto** > **Stato**. + +La pagina Stato è la posizione centrale per trovare notifiche e annunci sugli eventi chiave che interessano la piattaforma {{site.data.keyword.Bluemix_notm}} e i servizi principali in {{site.data.keyword.Bluemix_notm}}. Puoi sottoscrivere a un feed RSS per le notifiche in modo da non doverle controllare personalmente. Per ulteriori informazioni sulla pagina Stato e sulla configurazione del feed RSS, vedi [Visualizzazione di {{site.data.keyword.Bluemix_notm}}](../support/index.html#viewing-bluemix-status). + +### Stato della console di gestione + +Dopo la distribuzione iniziale del tuo ambiente {{site.data.keyword.Bluemix_notm}}, un controllo di verifica viene completato automaticamente sui componenti utilizzati per amministrare il tuo ambiente. Puoi andare alla pagina Controllo verifica console di gestione per controllare lo stato dei componenti dopo che è stato eseguito il controllo di verifica. Per accedere alla pagina, +vai a https://console.<dominiosecondario>.bluemix.net/check, dove `` è il nome della tua istanza locale o dedicata. + +Puoi eseguire una verifica in qualsiasi momento. Devi aver eseguito l'accesso per selezionare l'opzione per eseguire la verifica. Se riscontri dei malfunzionamenti mentre stai aggiungendo un utente, modificando un'organizzazione o gestendo i tuoi servizi, esegui questo controllo per identificare eventuali componenti malfunzionanti o disconnessi. Puoi aprire un ticket del supporto con le informazioni dal controllo per far risolvere rapidamente il problema. + +## Gestione del tuo catalogo +{: #oc_catalog} + +Puoi gestire quali servizi {{site.data.keyword.Bluemix_notm}} sono visibili agli utenti nel Catalogo {{site.data.keyword.Bluemix_notm}}. Fai clic su **AMMINISTRAZIONE > GESTIONE CATALOGO**. + +Seleziona un tile di servizio per modificare la visibilità del piano di servizio. Per modificare la +visibilità, seleziona dalle seguenti opzioni: + +- Per visualizzare il servizio nascosto in modo che sia visibile ai tuoi utenti nel +Catalogo, seleziona **ABILITA TUTTI I PIANI**. +- Per nascondere il servizio ai tuoi utenti nel Catalogo {{site.data.keyword.Bluemix_notm}}, +seleziona **DISABILITA TUTTI I PIANI**. +- Per controllare la visibilità di un singolo piano, seleziona il nome del piano e utilizza quindi +il menu a discesa per selezionare **Abilita per tutte le organizzazioni**, **Disabilita per +tutte le organizzazioni** o **Abilita piano per specifiche organizzazioni**. + + + +Puoi inoltre gestire l'ordine di priorità dei pacchetti di build disponibili da scegliere in base alla compatibilità, che i tuoi sviluppatori utilizzeranno durante la creazione di applicazioni. + +1. Vai a **AMMINISTRAZIONE> GESTIONE CATALOGO** +2. Vai alla sezione **Calcola**. +3. Seleziona **Priorità pacchetto di build**. +4. Seleziona l'opzione pacchetto di build a cui assegnare una priorità maggiore o minore nell'elenco. +5. Con l'opzione selezionata, utilizza le frecce per spostare l'opzione all'interno dell'elenco. + + + +### Registrazione di un broker dei servizi +{: #servicebrokerui} + +Se vuoi visualizzare un determinato servizio nel tuo catalogo {{site.data.keyword.Bluemix_notm}}, devi implementare e registrare un [broker dei servizi ![icona link esterno](../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/services/api.html){: new_window}. Una volta registrato il tuo broker, puoi scegliere quali organizzazioni possono accedere al servizio nella tua istanza locale o dedicata. + +Le modalità d'uso del tuo broker dei servizi variano a seconda del numero di servizi che gestisce o dalla sua eventuale precedente registrazione in {{site.data.keyword.Bluemix_notm}}. + +- Se il tuo broker dei servizi gestisce un unico servizio, puoi utilizzare l'interfaccia utente per registrarlo al termine dell'implementazione dell'[API broker dei servizi ![icona link esterno](../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/services/api.html){: new_window}. Vedi [Registrazione di un broker dei servizi che gestisce un unico servizio](index.html#registerbrokerui). +- Se il tuo broker dei servizi gestisce più servizi, utilizza la CLI cf con il plug-in [{{site.data.keyword.Bluemix_notm}} Admin CLI](../cli/plugins/bluemix_admin/index.html) (sottocomando `ba`) o l'[API del servizio personalizzato](index.html#servicebrokerapi). +- Se il tuo broker dei servizi è già registrato e desideri aggiornarlo o eliminarlo, utilizza la CLI cf con il plug-in [{{site.data.keyword.Bluemix_notm}} Admin CLI](../cli/plugins/bluemix_admin/index.html) (sottocomando `ba`) o l'[API del servizio personalizzato](index.html#servicebrokerapi). + +#### Registrazione di un broker dei servizi che gestisce un unico servizio +{: #registerbrokerui} + + + +Esamina le seguenti informazioni e completa la procedura per registrare il tuo broker dei servizi: + +**rima di iniziare**: implementa l'API broker dei servizi Cloud Foundry icona link esterno per consentire la comunicazione tra il tuo servizio e {{site.data.keyword.Bluemix_notm}}. L'API broker dei servizi è un insieme di endpoint REST utilizzati da {{site.data.keyword.Bluemix_notm}}. + +Quando implementi il broker dei servizi, nella risposta JSON di GET /v2/catalog devi fornire le definizioni per i tuoi piani di servizio e servizi, incluse le informazioni sul servizio che desideri visualizzare. Ad esempio, consulta il seguente file JSON di esempio della risposta del catalogo (GET): + +``` +{ +"services":[ + { + "bindable":true, + "description":"Cool Service è una soluzione di analisi e data warehousing.", + "id":"cool-service-id", + "name":"coolservice", + "metadata":{ + "displayName":"Cool Service", + "serviceMonitorApi":"https://myservicesstatus.mybluemix.net/healthcheck/", + "providerDisplayName":"Cool company", + "longDescription":"Cool Service è una soluzione di data warehousing e analisi. Puoi spostare rapidamente i tuoi dati in un database in-memoria a colonne di prossima generazione e iniziare ad eseguire query analitiche complesse.", + "bullets":[ + { + "title":"Rapido e semplice", + "description":"Cool Service utilizza innovazioni e tecnologia a colonne in memoria dinamiche, come l'elaborazione vettoriale parallela e una compressione su cui è possibile intervenire per eseguire rapidamente la scansione dei dati pertinenti ed eseguirne la restituzione." + }, + { + "title":"Connettività", + "description":"Cool Service è progettato per consentirti di connetterti facilmente a tutti i servizi e a tutte le applicazioni. Puoi iniziare immediatamente ad analizzare i tuoi dati con strumenti familiari." + } + ], + "featuredImageUrl":"http://path/to/icon_64x64.png", + "imageUrl":"http://path/to/icon_50x50.png", + "mediumImageUrl":"http://path/to/icon_32x32.png", + "smallImageUrl":"http://path/to/icon_24x24.png", + "documentationUrl":"http://path/to/documentation.html", + "instructionsUrl":"http://path/to/servicesample.md", + "termsUrl":"http://path/to/terms_of_agreement.pdf", + "media":[ + { + "type":"youtube", + "thumbnailUrl":"http://path/to/thumbnail.png", + "url":"http://path/to/youtube/video", + "caption":"Come usare Cool Service in 60 secondi" + }, + { + "type":"image", + "thumbnailUrl":"http://path/to/thumbnail.png", + "url":"http://path/to/image_file.png", + "caption":"Connessione di applicazioni con Cool Service" + }, + { + "type":"video", + "thumbnailUrl":"http://path/to/thumb.png", + "caption":"Cool Service gestisce le tabelle", + "source":[ + { + "type":"video/mp4", + "url":"http://path/to/video_file.mp4" + }, + { + "type":"video/ogg", + "url":"http://path/to/video_file.ogg" + } + ] + } + ] + }, + "plans":[ + { + "name":"smallplan", + "description":"Spazio tabelle e schema dedicati per istanza di servizio su un server condiviso. L'archiviazione dei database compressi da 1 e 10 GB può contenere fino a, rispettivamente, 5 e 50 GB di dati non compressi, con rapporti di compressione standard.", + "free":false, + "id":"cool-service-plan-id", + "metadata":{ + "bullets":[ + "Minimo 1 GB per istanza. Massimo 10 GB per istanza." + ], + "costs":[ + { + "unitId":"INSTANCES_PER_MONTH", + "unit":"MONTHLY", + "partNumber":"D15UTLL" + } + ], + "displayName":"Small" + } + } + ] + } +] +} +``` +{: codeblock} + +Le seguenti tabelle possono aiutarti a compilare il file JSON. + + +{: #ld_table10} + +| **Campi JSON** | **Descrizione** | +|-----------------|-----------------| +|bindable | Un valore booleano che indica se le istanze del servizio possono essere associate tramite bind alle applicazioni. | +|description | La descrizione del servizio visualizzata quando utilizzi il comando cf marketplace o passi il mouse sull'icona del servizio nel catalogo dell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Puoi aggiungere una singola parola o frase per la descrizione. | +|name | Il nome del servizio visualizzato nell'interfaccia riga di comando cf. Questo nome deve essere univoco all'interno di {{site.data.keyword.Bluemix_notm}}, deve utilizzare lettere minuscole e non può contenere spazi. Dopo aver registrato il servizio con {{site.data.keyword.Bluemix_notm}}, non potrai più modificarne il nome. | +|ID | L'ID del servizio. Questo ID deve essere univoco in {{site.data.keyword.Bluemix_notm}} e deve essere un GUID (Globally Unique Identifier). Dopo aver registrato il servizio con {{site.data.keyword.Bluemix_notm}}, non potrai più modificare l'ID. | +|metadata | I metadati del piano di servizio visualizzati nel catalogo {{site.data.keyword.Bluemix_notm}} e nel listino prezzi. Il campo dei metadati è facoltativo. Puoi specificare più campi per i metadati. Per ulteriori informazioni, vedi la seguente tabella per i [campi Metadati](index.html#metadatafields). | +|plans | Un array di definizioni del piano di servizio. Per ulteriori informazioni, vedi la seguente tabella per i [campi Piano](index.html#planfields). | +{: caption="Table 10. JSON fields" caption-side="top"} + + +{: #metadatafields} + +| **Valori metadati** | **Descrizione** | +|---------------------|-----------------| +|displayName | Il nome del piano visualizzato nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Questo nome viene visualizzato sia nel catalogo alla pagina dei dettagli del servizio che nel listino prezzi. Scrivi in maiuscolo solo la prima lettera del nome del piano. Non utilizzare "Predefinito" come nome piano predefinito, usa invece "Standard". | +|providerDisplayName | Il nome del provider di servizi | +|longDescription | La descrizione dettagliata per il servizio. Utilizza almeno due frasi per una descrizione lunga. | +|plans | Un array di definizioni del piano di servizio. Ogni voce di array del campo plans comprende i seguenti campi: name, description, free, id e metadata. Per ulteriori informazioni, vedi la seguente tabella per i [campi Piano](index.html#planfields). | +|bullets | Un array di stringhe visualizzate per un servizio. Puoi utilizzare gli elementi bullet per fornire informazioni in aggiunta alla descrizione lunga. Il campo bullets deve contenere almeno due elementi bullet. Ogni elemento bullet include il campo del titolo e della descrizione. | +|imageUrl | L'URL di un'immagine PNG grande (50 x 50 pixel). | +|smallImageUrl | L'URL di un'immagine PNG piccola (24 x 24 pixel). | +|mediumImageUrl | L'URL di un'immagine PNG media (32 x 32 pixel). | +|featuredImageUrl | L'URL di un'immagine in evidenza (64 x 64 pixel). | +|documentationUrl | L'URL della documentazione per il servizio. | +|termsUrl | L'URL dei file PDF che contengono i termini dell'accordo. | +|media (facoltativo) | Un array di elementi per visualizzare i video e le acquisizioni schermo che introducono il servizio nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Un elemento media può contenere i seguenti campi: type (image, youtube, video), thumbnailUrl (l'URL dell'immagine di anteprima per l'elemento media), url (l'URL dell'acquisizione schermo o del video YouTube), source (le origini dei video che non sono ospitati su YouTube. Il "type" delle origini del video deve essere supportato da HTML5. Includi "type" e "url" per il video)e caption (la didascalia per l'elemento media. Le didascalie consentono un accesso facilitato agli utenti con disabilità per comprendere gli elementi media). | +|serviceKeysSupported | Un valore booleano che indica se l'API delle chiavi del servizio è supportata. L'API delle chiavi del servizio permette di abilitare l'utilizzo di un servizio al di fuori di {{site.data.keyword.Bluemix_notm}}. Il valore predefinito è false. | +|plan_updateable | Un valore booleano che indica se il servizio supporta le modifiche del piano. Il valore predefinito è false. | +|embeddableDashboard (facoltativo) | Un campo che indica come viene visualizzato il dashboard del servizio nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Se non specifichi questo campo, il dashboard viene integrato ma viene limitato a una larghezza minima di 960px e il dashboard avrà un ulteriore riempimento orizzontale intorno all'iframe. Puoi utilizzare true, false, drilldown o launch. Per questo valore puoi utilizzare i seguenti campi: true, false, drilldown e launch. | +|notCreatable (facoltativo) | Un valore booleano che indica se le istanze per il servizio possono essere create dall'interfaccia utente {{site.data.keyword.Bluemix_notm}} e dall'interfaccia riga di comando cf. Il valore true significa che le istanze del servizio non possono essere create né dall'interfaccia utente {{site.data.keyword.Bluemix_notm}} né dall'interfaccia riga di comando cf. Il valore predefinito è false. | +|notCreatableMessage (facoltativo) | Un messaggio che viene visualizzato nell'interfaccia utente {{site.data.keyword.Bluemix_notm}} se non è possibile creare le istanze del servizio. Se non specifichi questo campo, verrà visualizzato il seguente messaggio predefinito: Per ricevere una notifica sulla disponibilità del servizio, confermare l'indirizzo email o immettere un nuovo indirizzo. | +|notCreatableRobotMessage (facoltativo) | Un messaggio che viene visualizzato nell'area commenti della pagina dei dettagli del servizio nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Il messaggio viene utilizzato per indicare che un servizio potrebbe avere un problema o altre cause che lo rendono non disponibile. Puoi specificare un messaggio per spiegare il motivo. Se non specifichi questo campo, verrà visualizzato il seguente messaggio predefinito: Questo servizio non è al momento disponibile. | +|apiReferenceUrl (facoltativo) | L'URL dell'iframe nell'area Riferimento API nella pagina dei dettagli del servizio all'interno del catalogo. Se non viene utilizzato per la pagina dei dettagli del servizio nel Catalogo, puoi immettere il valore numerico assegnato alla Documentazione API REST del tuo servizio durante la registrazione nel microservizio Documentazione API REST di {{site.data.keyword.Bluemix_notm}}. In questo modo, la documentazione dell'API REST verrà visualizzata nel dashboard del servizio. | +|sdkDownloadUrl (facoltativo) | L'URL della pagina Web che si apre quando fai clic sul pulsante Scarica SDK. Il pulsante Scarica SDK si trova nel tile del servizio nella pagina di panoramica dell'applicazione nel Dashboard. La pagina Web si apre in una scheda del browser. | +|serviceMonitorApi | L'URL di un'API che restituisce i dati JSON, come mostrato nel seguente esempio, che segnala l'integrità del servizio. Devi avere serviceMonitorApi o serviceMonitorApp nei metadati del servizio. Consulta il seguente codice come esempio. | +|serviceMonitorApp | L'URL a un'applicazione che può essere distribuita in {{site.data.keyword.Bluemix_notm}} ed essere associata a un servizio per fornire l'output specifico dello stato del servizio. L'applicazione deve restituire il formato dei dati JSON uguale al serviceMonitorApi. Devi avere serviceMonitorApi o serviceMonitorApp nei metadati del servizio. Consulta il seguente codice come esempio. | +{: caption="Table 11. Metadata fields" caption-side="top"} + + +``` +{ + "service": "servicename", + "version": 1, + "health": [ + { + "plan": "starter", + "status": 0, + "serviceinput": "count(*) from healthcheck", + "serviceoutput": "10…or error 1234 database not running", + "responsetime": 4 + }, + { + "plan": "enterprise", + "status": 1, + "serviceinput": "count(*)fromhealthcheck", + "serviceoutput": "10…orerror1234databasenotrunning", + "responsetime": 4 + } + ] +} +``` +{: pre} + +Il seguente esempio mostra come la risposta JSON di GET /v2/catalog è associata alla pagina dei dettagli del servizio nel catalogo {{site.data.keyword.Bluemix_notm}}: + +![Dettagli del servizio nel catalogo.](images/metadata.png "Vista dettagli del servizio nel catalogo Bluemix") + + +{: #planfields} + +| **Valori del piano** | **Descrizione** | +|---------------------|-----------------| +|name | Il nome del piano di servizio utilizzato nell'interfaccia riga di comando cf. Il nome del piano viene, ad esempio, visualizzato nell'output del comando cf marketplace. Il nome del piano deve essere in lettere minuscole, non può contenere spazi e deve essere univoco all'interno del servizio. | +|description | La descrizione del piano di servizio. La descrizione viene visualizzata quando selezioni una piano nella pagina dei dettagli del servizio nel catalogo {{site.data.keyword.Bluemix_notm}}. | +|free | Un valore booleano che indica se il piano di servizio è gratuito. Il valore predefinito è true. | +|ID | L'ID del piano di servizio. L'ID deve essere univoco e deve essere un GUID. | +|metadata (facoltativo) | I metadati del piano di servizio visualizzati nel catalogo {{site.data.keyword.Bluemix_notm}} e nel listino prezzi. Il campo dei metadati è facoltativo. Nel campo metadata puoi specificare i seguenti campi: displayName, type (subscription, reservable, planDetails), bullets, costs (unitId, unit, partNumber) e paidOnly. Per ulteriori informazioni, vedi la seguente tabella per i [campi Metadati del piano](index.html#planmetadata). | +{: caption="Table 12. Plan fields" caption-side="top"} + + +{: #planmetadata} + +| **Valori dei metadati del piano** | **Descrizione** | +|------------------------|-----------------| +|displayName | Il nome del piano visualizzato nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Questo nome viene visualizzato sia nel catalogo alla pagina dei dettagli del servizio che nel listino prezzi. | +|type | Il tipo di piano. Per questo campo, puoi utilizzare i seguenti valori: subscription (un piano di sottoscrizione. Il valore predefinito è false), reservable (un piano riservabile. Questo valore viene utilizzato solo quando il piano è un piano di sottoscrizione, ossia, il valore di plan.metadata.subscription è true. Il valore predefinito è false), planDetails (quantità e descrizione dettagliata delle risorse che possono essere utilizzate con il piano. Questo valore viene utilizzato solo quando il piano è riservabile, ossia, il valore di plan.metadata.reserveable è true.) | +|bullets | Una descrizione delle risorse che possono essere utilizzate con il piano. La descrizione viene visualizzata nella colonna **Funzioni** nella pagina dei dettagli del servizio del catalogo e nel listino prezzi. | +|costs | Informazioni sui costi del servizio che vengono visualizzate nella colonna Prezzo nella pagina dei dettagli del servizio del catalogo e nel listino prezzi. Ogni voce di array contiene i seguenti campi: unitId (l'ID dell'unità. Utilizza la forma plurale e scrivi in maiuscolo tutte le lettere. Per i piani gratuiti, questo campo è facoltativo), unit (la metrica utilizzata per calcolare gli addebiti del servizio. Il valore di questo campo è utilizzato nell'interfaccia utente {{site.data.keyword.Bluemix_notm}} per rappresentare la metrica di addebito)e partNumber (l'identificativo `part_number` utilizzato dal sistema di fatturazione. Per i piani gratuiti, questo campo è facoltativo). | +|paidOnly (facoltativo) | Un valore booleano che indica se questo piano di servizio è disponibile solo per gli account a pagamento {{site.data.keyword.Bluemix_notm}}. Il valore **true** significa che il piano di servizio è destinato solo agli account a pagamento e non può essere aggiunto agli account di prova. Il valore **false** significa che il piano di servizio può essere aggiunto sia agli account a pagamento che di prova. Il valore predefinito è **false**. | +{: caption="Table 13. Plan metadata fields" caption-side="top"} + +Il seguente esempio mostra come la risposta JSON di GET /v2/catalog è associata alla pagina dei dettagli del servizio nel catalogo {{site.data.keyword.Bluemix_notm}}. In particolare, il modo in cui i campi dei metadati del piano descritti nella tabella precedente vengono associati all'interfaccia utente: + +![Dettagli dei metadati del piano nel catalogo.](images/plan_metadata.png "Vista dei valori metadati del piano nel catalogo") + + + + +
    +
  1. Una volta implementata l'API broker dei servizi, vai a AMMINISTRAZIONE > GESTIONE CATALOGO.
    2. +
  2. Fai clic su REGISTRA UN BROKER DEI SERVIZI.
    3. +
  3. Completa il modulo immettendo valori nei seguenti campi: +
      +
    • Nome del broker dei servizi
      • +
    • URL del broker dei servizi
      • +
    • Nome utente del broker dei servizi
      • +
    • Password del broker dei servizi
      • +
    +
    4. +
  4. Fai clic su CONNETTI.
    5. +
  5. Controlla le informazioni sul tuo servizio, inclusi i piani disponibili, l'icona e la descrizione del servizio.
    +

    Nota: se devi modificare le informazioni di catalogo del servizio, aggiorna il tuo broker di servizi e riavvia il processo di registrazione, compilando il modulo.

    +
    6. +
  6. Fai clic su REGISTRA.
    7. +
  7. Scegli di abilitare tutti i piani o solo piani specifici per il servizio. Tutti i piani sono disabilitati per impostazione predefinita.
    8. +
  8. Abilita l'istanza del servizio per tutte le organizzazioni o solo per organizzazioni specifiche.
    9. +
+ +Ora puoi vedere il tuo servizio nella categoria Servizi personalizzati del tuo catalogo {{site.data.keyword.Bluemix_notm}}. Vai a **AMMINISTRAZIONE > GESTIONE CATALOGO** e seleziona il tile del catalogo. Puoi abilitare differenti piani e modificarne la visibilità per le tue organizzazioni in qualsiasi momento. + + +## Amministrazione delle organizzazioni +{: #oc_organizations} + +Puoi gestire le tue organizzazioni attraverso la creazione e l'eliminazione di organizzazioni, l'aggiunta o la rimozione di gestori alle/dalle organizzazioni e il monitoraggio dell'utilizzo delle quote, così da adottare le scelte migliori per la tua attività. + +Fai clic su **AMMINISTRAZIONE > AMMINISTRAZIONE ORGANIZZAZIONE**. + +Puoi espandere e visualizzare le diverse sezioni. Puoi anche riesaminare e gestire i piani di quota per le tue organizzazioni. + +### Creazione di organizzazioni + +Per creare un'organizzazione e aggiungere gestori, completa la seguente procedura: + +1. Fai clic su CREA ORGANIZZAZIONE. +2. Immetti un nome per l'organizzazione. +3. Immetti il nome o l'email della persona che vuoi aggiungere come gestore. Puoi aggiungere più di un gestore immettendo e selezionando più nomi. +4. Fai clic su CREA ORGANIZZAZIONE per salvare le tue modifiche e creare l'organizzazione. + +### Creazione di spazi + +Puoi creare degli spazi nella tua organizzazione; ad esempio, +uno spazio *dev* come un ambiente di sviluppo, +uno spazio *test* come un ambiente di test e uno +spazio *production* come un ambiente di produzione. Puoi quindi associare +le tue applicazioni agli spazi. Per creare uno spazio completa la seguente procedura: + +1. Dalla barra dei menu, fai clic su **Account** > **Gestisci organizzazioni**. +2. Seleziona l'organizzazione a cui vuoi aggiungere uno spazio. +3. Fai clic su **Crea uno spazio**. +4. Immetti un nome spazio. +5. Fai clic su **Crea**. + +### Monitoraggio quota + +Puoi espandere la sezione **Monitoraggio quota** per visualizzare le seguenti informazioni: + +- Utilizzo della memoria dell'ambiente mostra in dettaglio l'utilizzo della memoria per l'intero ambiente di sistema. Il grafico mostra le seguenti informazioni: +
    +
  • La memoria fisica in uso e il limite di memoria fisica disponibile
    • +
  • La quota di memoria attualmente riservata e il limite di memoria che è possibile riservare
    • +
  • La quota totale di memoria per le tue organizzazioni
    • +
+I seguenti tipi di utilizzo della memoria vengono visualizzati nel grafico. + +
+
Memoria fisica utilizzata
+
La memoria fisica utilizzata dal tuo ambiente.
+
Limite fisico
+
La memoria fisica totale disponibile nel tuo ambiente.
+
Quota riservata
+
La somma di memoria riservata per tutte le applicazioni distribuite, tra tutte le organizzazioni. La somma della quota riservata può superare il limite fisico di memoria per il tuo ambiente. Ad esempio, se hai un limite di memoria fisica pari a 16 GB, potresti riservare 4 GB di memoria ciascuna per un totale di cinque diverse applicazioni. La quota riservata supera il limite fisico della memoria. Tuttavia, in molti casi, le applicazioni potrebbero non utilizzare la quota totale riservata singolarmente a ciascuna di esse. Inoltre, è possibile che le applicazioni non utilizzino + contemporaneamente la quota totale della memoria riservata.
+
Limite riserva
+
La memoria totale che può essere riservata tra tutte le applicazioni per il tuo ambiente.
+
Quota totale
+
La quota di memoria totale tra tutte le organizzazioni.
+
+ **Nota**: i dati vengono aggiornati automaticamente ogni 4 ore. Fai clic su **Ricalcola** se desideri aggiornare i dati sulla pagina prima dell'aggiornamento automatico. + +- Utilizzo della memoria dell'organizzazione. Questa sezione mostra in dettaglio l'utilizzo della memoria a livello di organizzazione. Puoi visualizzare la quota di memoria totale, la quota riservata e la memoria fisica utilizzata da ogni organizzazione. Il grafico fornisce informazioni che vengono elencate in base alla quantità di memoria riservata per ogni organizzazione e, per impostazione predefinita, viene elencata per prima l'organizzazione che riserva la maggiore quantità di memoria. Puoi ordinare per **Utilizzo massimo memoria** e **Assegnazione memoria in eccesso**. + +
+
Utilizzo massimo memoria
+
Usa questa opzione per identificare l'organizzazione che ha riservato la maggiore quantità di memoria. Ordina in base all'utilizzo massimo di memoria per identificare le organizzazioni che hanno riservato la maggiore quantità di memoria. L'elenco viene ordinato in base alla quota riservata.
+
Assegnazione memoria in eccesso
+
Usa questa opzione per identificare le organizzazioni che hanno una quota di memoria totale superiore a quella necessaria. Ordina per Assegnazione memoria in eccesso per identificare le organizzazioni che utilizzano +la minore quantità di memoria per la quota assegnata per l'organizzazione.
+
+ +### Gestione delle quote +{: #manageorgquota} + +Una quota rappresenta i limiti di risorse per le organizzazioni, che viene assegnata quando l'organizzazione viene creata. Applicazioni o servizi in uno spazio all'interno dell'organizzazione contribuiscono tutti all'utilizzo della quota assegnata. Per gestire i seguenti passi completare la gestione della quota per un'organizzazione: + +
    +
  1. Fai clic sulla barra del grafico +relativo all'organizzazione che vuoi modificare nella sezione Utilizzo della memoria dell'organizzazione o seleziona il nome +dell'organizzazione nella sezione Elenco organizzazioni. Dalla pagina Informazioni sull'organizzazione, puoi ridenominare l'organizzazione e aggiungere o rimuovere i gestori. +

    Nota: se selezioni un piano di quota che non è sufficiente per l'utilizzo corrente +dell'organizzazione, riceverai un messaggio.

    2. +
  2. Fai clic su Cloud Foundry o Containers. Per impostazione predefinita, si apre la pagina della quota Cloud Foundry. +
      +
    • Dalla pagina Cloud Foundry, puoi selezionare un piano e visualizzare i dettagli della quota per le seguenti risorse: +
        +
      • Servizi
        • +
      • Rotte
        • +
      • Quota di memoria
        • +
      • Assegnazione applicazione
        • +
      +
      • +
    • Dalla pagina Containers, puoi assegnare i valori, che devono essere numeri interi, per i seguenti campi: +
      +
      Limite immagine
      +
      Il numero massimo di immagini contenitore che puoi avere nel tuo registro privato. Un'immagine contenitore è la base per ogni contenitore che crei. Un'immagine viene creata da un Dockerfile che è un file in sola lettura che ospita il sistema operativo, l'applicazione e tutte le relative dipendenze e descrive come viene configurato un contenitore. Le immagini sono condivise tra tutti i membri di un'organizzazione.
      +
      Assegnazione memoria predefinita
      +
      La quantità di memoria del contenitore che viene automaticamente assegnata quando viene creato un nuovo spazio. Quando crei un contenitore, devi scegliere una dimensione del contenitore. La dimensione determina la quantità di memoria che il contenitore può utilizzare sull'host di calcolo ed è compresa nel tuo limite di memoria del contenitore.
      +
      Assegnazione memoria massima
      +
      La quantità massima di memoria della memoria del contenitore che può essere assegnata tra tutti gli spazi di un'organizzazione.
      +
      IP mobili predefiniti
      +
      Il numero di indirizzi IP pubblici che viene automaticamente assegnato quando viene creato un nuovo spazio. Puoi eseguire il bind degli indirizzi IP pubblici a contenitori singoli o a gruppi di contenitori per renderli accessibili da internet.
      +
      Numero massimo di IP mobili
      +
      Il numero massimo di indirizzi IP pubblici che puoi assegnare tra tutti gli spazi di un'organizzazione.
      +
      +Nota: se non disponi ancora di contenitori nel tuo ambiente o se non li hai ancora configurati, ricevi un messaggio di errore. +

      Per ulteriori informazioni sui contenitori, consulta [Informazioni su IBM Containers](/docs/containers/container_ov.html). Per ulteriori informazioni sulle quote del contenitore, consulta [Quota e account Bluemix](/docs/containers/container_planning_org_ov.html#container_planning_quota).

      +Nota: i contenitori non sono disponibili nella regione {{site.data.keyword.Bluemix_notm}} Sydney.
      • +
    +
  3. Per salvare le eventuali modifiche apportate nella pagina Gestisci organizzazione, fai clic su SALVA.
    4. +
+ + +### Gestione delle tue organizzazioni dall'elenco delle organizzazioni +{: #manageorgfrolis} + +Nella sezione Elenco organizzazioni, puoi visualizzare tutte le organizzazioni +dell'ambiente {{site.data.keyword.Bluemix_notm}} e intervenire sulle singole organizzazioni facendo clic sul nome dell'organizzazione. + +- Per eliminare l'organizzazione, fai clic sull'icona **Elimina** ![Elimina](images/icon_trash.svg) nella colonna Azioni. +- Per visualizzare il piano di quota e l'utilizzo di un'organizzazione, fai clic sul nome dell'organizzazione +nell'elenco. Nella pagina **Gestisci organizzazioni** dell'organizzazione selezionata, puoi visualizzare le seguenti informazioni sull'utilizzo: + + - Numero di servizi attualmente in uso. + - Numero di rotte attualmente in uso. + - Grafico delle quote di memoria che mostra le percentuali di quota di memoria attualmente in uso e non in uso. + - Grafico sull'assegnazione delle applicazioni che mostra quali applicazioni sono incluse nella quota di memoria utilizzata. + - Grafico sull'utilizzo misurato dell'applicazione che mostra un report trimestrale sulle GB-ore utilizzate per applicazione distribuita. Puoi selezionare la **Vista elenco** per visualizzare i dati per tutte le applicazioni, compresa l'assegnazione di memoria per applicazione e l'utilizzo a consumo di GB-ore degli ultimi tre mesi. + +- Per modificare il nome dell'organizzazione e aggiungere o rimuovere gestori, fai clic sul nome dell'organizzazione + nell'elenco e segui i prompt mostrati a schermo. +- Per visualizzare le informazioni su un utente specifico dell'organizzazione che stai visualizzando, fai clic sul nome utente per visualizzarne le informazioni. Puoi quindi fare clic sul nome dell'organizzazione per ritornare a visualizzare le informazioni sull'organizzazione. + +## Gestione di utenti e autorizzazioni +{: #oc_useradmin} + +Puoi aggiungere gli utenti singolarmente o in gruppi. In genere, gli utenti vengono aggiunti alla tua istanza {{site.data.keyword.Bluemix_notm}} dal registro utenti della tua azienda tramite LDAP (Lightweight Directory Access Protocol). Puoi anche visualizzare le autorizzazioni utente. Se disponi dell'autorizzazione **Superuser**, puoi anche impostare e gestire le autorizzazioni per gli altri utenti. Fai clic su **AMMINISTRAZIONE > AMMINISTRAZIONE UTENTI**. + +La pagina Amministrazione utenti visualizza tutti gli utenti per l'istanza locale o dedicata. Sono visualizzate le autorizzazioni per ciascun utente utilizzando le icone nella tabella. Le autorizzazioni possono essere: Nessuna, **Superuser**, **Accesso di base**, **Catalogo**, **Report** e **Utenti**. +Le autorizzazioni **Superuser** e **Accesso di base** possono essere impostate su **Attivo** o **Disattivo**, mentre le altre autorizzazioni vengono abilitate o disabilitate con specifici tipi di accesso, tra cui l'accesso in **Lettura** o **Scrittura** per l'autorizzazione indicata, come rappresentato dalle icone. Consulta [Autorizzazioni](#permissions) per delle descrizioni di +ciascun tipo e una spiegazione delle icone. + +### Gestione degli utenti +{: #workwithusers} + +A seconda del tuo accesso di **Lettura** o **Scrittura** per le autorizzazioni dell'utente, puoi cercare utenti esistenti, rimuovere utenti e aggiungere utenti singolarmente o in base a un gruppo. Se hai l'autorizzazione **Superuser**, disponi dell'accesso completo per eseguire tutte le attività di gestione utente nell'ambiente. Esamina le seguenti attività di gestione utente e il livello di accesso necessario per completare ogni attività: + +* Individua utenti. Se disponi dell'accesso in **Lettura** o **Scrittura** e conosci tutto o parte del nome utente, puoi individuare gli utenti nella tabella utilizzando il campo **Ricerca**. Puoi anche filtrare l'elenco di utenti in base alle relative organizzazioni e autorizzazioni. Per filtrare un elenco di utenti, completa la seguente procedura: +
    +
  1. Fai clic su Filtro.
    2. +
  2. Seleziona Organizzazioni o Autorizzazioni, a seconda del filtro che desideri utilizzare. +
    +
    Organizzazione
    +
    Per filtrare gli utenti in base all'organizzazione, inizia a immettere il nome dell'organizzazione nel campo Organizzazione e selezionala dall'elenco. Seleziona, quindi, uno o più ruoli assegnati agli utenti all'interno dell'organizzazione.
    +
    Autorizzazioni
    +
    Per filtrare gli utenti in base alle autorizzazioni, seleziona prima il tipo di utente o utenti. Ad esempio, potresti voler visualizzare tutti i Superuser. Per le autorizzazioni diverse da Superuser o Accesso di base, puoi selezionare anche il tipo di accesso, ad esempio Lettura o Scrittura.
    +
    3. +
  3. Fai clic su Applica.
    4. +
+ + La finestra Gestione utenti mostra i filtri da te impostati e gli utenti che risultano dai filtri specificati. Puoi quindi cercare un utente nella tabella filtrata. Inoltre, puoi modificare l'elenco dei filtri specificati rimuovendo un'opzione di filtro. + +* Aggiungi un singolo utente. Se disponi dell'autorizzazione **Superuser** o +**Utenti** con l'accesso in **Scrittura**, puoi aggiungere gli utenti. + + 1. Per aggiungere un singolo utente dalla tua directory LDAP, fai clic su **Aggiungi utente**. + 2. Nel campo **Ricerca**, immetti l'indirizzo email per l'utente e seleziona quindi l'utente dall'elenco compilato. + 3. Quindi, dal campo **Organizzazione**, scegli l'organizzazione a cui vuoi aggiungere l'utente immettendo il nome dell'organizzazione e selezionandolo dall'elenco compilato. + 4. Per aggiungere l'utente all'organizzazione selezionata, fai clic su **Aggiungi utente**. + + **Nota**: quando l'operazione di aggiunta viene eseguita con esito positivo, l'utente viene aggiunto alla tabella per consentirti operazioni di visualizzazione e ricerca. Quando gli utenti vengono aggiunti, +non dispongono di autorizzazioni. + +* Aggiunta di un gruppo di utenti dalla tua directory LDAP. Se disponi dell'autorizzazione **Superuser** o +**Utenti** con l'accesso in **Scrittura**, puoi aggiungere gli utenti. + + 1. Fai clic su **Aggiungi gruppo di utenti**. + 2. Nel campo **Ricerca**, immetti un nome gruppo da cercare e seleziona il nome gruppo dall'elenco compilato. + 3. Quindi, dal campo **Organizzazione**, scegli l'organizzazione a cui vuoi aggiungere il gruppo di utenti immettendo il nome dell'organizzazione e selezionandolo dall'elenco compilato. + 4. Per aggiungere il gruppo di utenti all'organizzazione selezionata, fai clic su **Aggiungi utenti**. + + **Nota**: i gruppi di più di 50 utenti vengono aggiunti tramite un lavoro batch in background. Se l'operazione di aggiunta viene +completata correttamente, l'utente o il gruppo viene aggiunto alla tabella per consentirti operazioni di visualizzazione e ricerca. Quando gli utenti vengono aggiunti, +non dispongono di autorizzazioni. + +* Aggiungi un gruppo di utenti importando un foglio di calcolo che include ID utente, indirizzi email utente e l'organizzazione a cui intendi aggiungere l'utente. Se disponi dell'autorizzazione **Superuser** o **Utenti** con l'accesso in **Scrittura**, puoi aggiungere gli utenti. + +**Nota**: immetti gli ID utente che corrispondono ai valori utilizzati nel tuo registro utenti. + + 1. Fai clic su **Importa utenti**. + 2. Fai clic su **Scarica modello (.CSV)** per scaricare un foglio di calcolo con le colonne richieste compilabili. In alternativa puoi crearne uno personalizzato, utilizzando un foglio di calcolo che includa le intestazioni di colonna richieste: **ID utente**, **Email** e **Organizzazione**. Il template include anche due colonne facoltative: **Nome** e **Cognome**. + 3. Compila i valori utente per le colonne obbligatorie. Se non utilizzi una directory LDAP, utilizza le intestazioni colonna obbligatorie e facoltative per gli utenti di importazione. + 4. Salva il tuo file e fai clic su **Carica file**. + + **Nota**: le colonne nel tuo foglio di calcolo possono essere in qualsiasi ordine, a condizione che tu abbia tutte le colonne obbligatorie. Se l'importazione ha avuto esito positivo, ricevi un messaggio di conferma che indica che sono stati aggiunti tutti gli utenti. Se l'importazione ha avuto esito positivo per qualche utente ma non per altri, esamina il messaggio di errore per intervenire sugli utenti che non è stato possibile aggiungere. + +* Rimuovere utenti. Se disponi dell'autorizzazione **Superuser** o **Utenti** con l'accesso in **Scrittura**, puoi rimuovere gli utenti dall'ambiente in modo permanente. + + 1. Individua l'utente e fai clic sull'icona ![Elimina](images/icon_trash.svg). + 2. Fai clic su **Rimuovi**. + +* La modifica di autorizzazioni e organizzazioni a cui appartengono gli utenti richiede che tu disponga dell'autorizzazione **Superuser**. Per modificare le autorizzazioni per gli utenti, individua l'utente e fai clic sul nome utente. Dalla pagina **Modifica utente**, puoi abilitare o disabilitare le autorizzazioni: + + * Seleziona **Attivo** dall'elenco per abilitare l'autorizzazione **Superuser** o **Accesso di base**. + * Seleziona **Lettura** dall'elenco per consentire all'utente di disporre dell'accesso in **Visualizzazione** (sola lettura) per tale autorizzazione oppure seleziona **Scrittura** per consentire l'accesso in **Scrittura** (modifica o aggiunta e rimozione) per tale autorizzazione. + * Seleziona **Disattivo** per disabilitare tutte le autorizzazioni. + + **Nota**: l'impostazione dell'autorizzazione **Superuser** su **Attivo** imposta tutte le altre autorizzazioni con l'accesso in **Scrittura**. + +* Per aggiungere o rimuovere un utente da una specifica organizzazione, devi disporre dell'autorizzazione **Superuser** o **Utenti** con l'accesso in **Scrittura**. + + 1. Per aggiungere un utente a un'organizzazione, seleziona il nome utente dalla tabella per accedere alla pagina **Modifica utente**. Utilizza quindi il campo di ricerca per individuare un'organizzazione, seleziona l'organizzazione dall'elenco e fai clic su **Salva**. + 2. Per rimuovere un utente da un'organizzazione, seleziona il nome utente dalla tabella per accedere alla pagina **Modifica utente**. Fai quindi clic su ![Rimuovi](images/icon_remove.svg) per l'organizzazione da cui vuoi rimuovere l'utente e fai clic su **Salva**. + +* Per visualizzare le informazioni sull'organizzazione a cui è assegnato l'utente, fai clic sul nome dell'organizzazione per visualizzarne le informazioni. Puoi quindi fare clic sul nome dell'utente per ritornare a visualizzare le informazioni sull'utente. + +### Autorizzazioni +{: #permissions} + +È possibile assegnare agli utenti le seguenti autorizzazioni con livelli di accesso specifici (lettura o scrittura) che consentono all'utente di completare attività specifiche all'interno della console di gestione. + + +{: #ld_table14} + +| **Autorizzazione utente** | **Descrizione** | +|-----------------|-------------------| +| Superuser | Gli utenti con l'autorizzazione **Superuser** impostata su **Attivo** possono modificare le autorizzazioni per gli altri utenti. Se hai l'autorizzazione attiva, ti viene automaticamente abilitato l'accesso completo alle altre autorizzazioni. Oltre alle attività descritte per ogni autorizzazione nella tabella, questi utenti possono anche impostare le sottoscrizioni di notifica per essere direttamente avvertiti in merito a manutenzione o incidenti, per pianificare la manutenzione, eseguire i controlli di verifica sui componenti della console e creare organizzazioni e spazi per l'ambiente. Questa autorizzazione equivale al ruolo di amministratore (admin) per la console di gestione. | +| Accesso di base | Gli utenti con l'autorizzazione **Accesso di base** impostata su **Attivo** possono visualizzare l'opzione della pagina di amministrazione nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Gli utenti con l'autorizzazione abilitata possono avere accesso alle [Informazioni di sistema](#oc_system) e ai tile [Utilizzo della risorsa](#oc_resource). Senza questa autorizzazione, gli utenti non possono visualizzare o accedere all'opzione di menu Amministrazione. Questa autorizzazione equivale al ruolo di amministratore (admin) per la console di gestione. Equivale all'autorizzazione di accesso utilizzata precedentemente per la console di gestione. | +| Catalogo | Agli utenti con autorizzazione **Catalogo** può essere assegnato l'accesso in **Lettura** o in **Scrittura** (modifica) per i servizi disponibili nell'istanza locale o dedicata. L'accesso in lettura consente all'utente di accedere al tile di gestione del catalogo per visualizzare i servizi disponibili. L'accesso in scrittura consente all'utente di accedere al tile [Gestione catalogo](#oc_catalog) per visualizzare i servizi, modificare la visibilità dei servizi, registrare i servizi personalizzati e controllare l'elenco di priorità del pacchetto di build. | +| Report | Agli utenti con autorizzazione **Report** può essere assegnato l'accesso in **Lettura** o in **Scrittura** (modifica) per i report di sicurezza. L'accesso in lettura consente all'utente di accedere al tile Report e log per scaricare i report. L'accesso in scrittura consente agli utenti di visualizzare il tile [Report e log](#oc_report) così come di utilizzare la CLI per caricare nuovi report e creare nuove categorie per l'accesso degli utenti. | +| Utenti | Agli utenti con autorizzazione **Utenti** può essere assegnato l'accesso in **Lettura ** (visualizzazione) per l'elenco di utenti o in **Scrittura** (aggiunta o rimozione) per gli utenti. Questa autorizzazione non ti consente di impostare le autorizzazioni per gli altri utenti. L'accesso in scrittura consente all'utente di aggiungere nuovi utenti all'ambiente, eliminare utenti dall'ambiente e aggiungere utenti esistenti all'organizzazione che già esistono nell'ambiente. In aggiunta, l'accesso in **Scrittura** consente agli utenti di aggiungere nuove organizzazioni, eliminare le organizzazioni e modificare gli utenti nelle organizzazioni. | +{: caption="Table 14. Permissions" caption-side="top"} + +## Utilizzo delle API REST +{: #auth_adminapi} + +Per utilizzare i comandi dell'API REST, devi innanzitutto eseguire l'autenticazione. Per generare e supportare le sessioni, puoi utilizzare i comandi cURL per compiere le seguenti attività: + +* [Accesso alla Console di gestione](#auth_loginapi) +* [Memorizzazione di ID utente e password](#auth_setuidpw) +* [Memorizzazione di cookie](#auth_apistorecook) +* [Riutilizzo dei cookie](#auth_apireusecook) + +### Accesso alla Console di gestione +{: #auth_loginapi} + +Prima di poter eseguire qualsiasi richiesta API `Admin`, +devi eseguire l'accesso alla Console di gestione. + +Per accedere alla Console di gestione, puoi utilizzare l'autenticazione di accesso di base +sull'endpoint `https://console..bluemix.net/login`. Il server restituisce un cookie con la tua sessione. Puoi utilizzare tale +cookie per tutte le operazioni con la Console di gestione. + +**Nota:** la sessione diventa non valida se non viene utilizzata per qualche ora. + +Per accedere alla +Console di gestione, esegui questo comando: + +`curl --user : -c ./cookies.txt --header "Accept: application/json" https://console..bluemix.net/login | python -m json.tool` +{: codeblock} + +
+
--user id_utente:password
+
Accetta l'ID utente e la password e invia un'intestazione di autorizzazione di base.
+
-c nomefile
+
Memorizza l'ID utente e la password specificati come un cookie nel file specificato.
+
-b nomefile
+
Richiama l'ID utente e la password specificati come un cookie nel file specificato.
+
--header
+
Invia un'intestazione Accept.
+
+ +Il seguente esempio mostra l'output di questo + comando: +``` +{ + "message": "Logged in", + "name": { + "familyName": "*last_name*", + "givenName": "*first_name*" + } +} +``` +{: screen} + +### Memorizzazione di ID utente e password +{: #auth_setuidpw} + +Puoi memorizzare il tuo ID utente e password in modo da non doverli immettere manualmente ogni volta che esegui l'accesso. Per memorizzare il tuo ID utente e password per poterli riutilizzare, utilizza il seguente esempio cURL: + +`curl -X GET -H "Authorization: Basic " -H "Accept: application/json" "http://localhost:3000/login"` +{: codeblock} + +Per configurare le tue informazioni di accesso in un file separato e quindi richiamare il file in modo da non doverlo immettere per ogni richiesta di autenticazione, utilizza l'opzione `--netrc` fornita dal comando cURL. + +Per utilizzare l'opzione `--netrc` con cURL, crea prima un file nella directory home dell'utente in uno dei seguenti modi: +* Su un sistema Unix, crea un file denominato .netrc +* Su un sistema Windows, crea un file denominato _netrc. + +Nel file, immetti le seguenti informazioni: + +`machine console..bluemix.net +login +password ` +{: codeblock} + +Quando si richiama un comando cURL, aggiungi il seguente argomento: `--netrc`. +

Per utilizzare un file netrc che si trova in una directory differente, utilizza l'opzione `--netrc-file [file]`, dove `[file]` è la posizione del file netrc.

+ + + + +### Memorizzazione di cookie +{: #auth_apistorecook} + +Quando accedi alla Console di gestione, il server restituisce un cookie con la tua sessione. Questo cookie è richiesto come parte del processo di accesso per le future chiamate API per tutte le operazioni con la Console di gestione. Puoi memorizzare i cookie anche per un utilizzo successivo. + +Per memorizzare i cookie dopo aver eseguito l'accesso, utilizza l'opzione `-c`, come mostrato nel seguente esempio CURL: + +`curl --user : -c ./cookies.txt --header "Accept: application/json" https://console..bluemix.net/login | python -m json.tool` +{: codeblock} + +### Riutilizzo dei cookie +{: #auth_apireusecook} + +Per riutilizzare i cookie, utilizza l'opzione `-b` con il nome del file cookie che hai assegnato con l'opzione `-c`, come mostrato nel seguente esempio CURL: + +`curl --user : -b ./cookies.txt` +{: codeblock} + +## Gestione degli utenti con la API REST Admin + +{: #usingadminapi} + +Puoi utilizzare l'API REST `Admin` per aggiungere e rimuovere utenti per l'istanza {{site.data.keyword.Bluemix_notm}}. +Gli endpoint della API REST `Admin` e le risposte JSON sono fornite su base sperimentale per abilitare le operazioni di base da una riga di comando. Gli endpoint e gli URL negli esempi nelle presenti +informazioni possono variare o potrebbero essere abbandonate con breve preavviso. + +Se disponi dell'autorizzazione **Superuser** o **Utenti** +con l'accesso in **Scrittura**, puoi aggiungere o rimuovere gli utenti. Per modificare le autorizzazioni di altri utenti devi disporre +dell'autorizzazione **Superuser**. + +Anche se puoi utilizzare altri strumenti, i seguenti sono prerequisiti per l'utilizzo degli esempi che seguono: +utilizzare altri strumenti. +* cURL, per immettere richieste API REST come comandi. cURL è un programma di utilità gratuito che puoi + utilizzare per inviare richieste HTTP a un server e ricevere le risposte + attraverso un'interfaccia riga di comando. Puoi scaricare +cURL dal [sito cURL Download ![icona link esterno](../icons/launch-glyph.svg)](http://curl.haxx.se/download.html){: new_window}. +* Python, per utilizzare lo strumento JSON Pretty-Print Python. Questo strumento +facoltativo prende il testo JSON come input e fornisce un output facile da leggere. Puoi scaricare +Python dal [sito Python Downloads ![icona link esterno](../icons/launch-glyph.svg)](https://www.python.org/downloads){: new_window}. + + +### Elenco delle organizzazioni +{: #listingorg} + +Quando aggiungi un utente, devi specificare un'organizzazione. Puoi +utilizzare la API REST `Admin` per elencare tutte le organizzazioni. Devi disporre dell'autorizzazione +**Utenti** con l'accesso in **Lettura** per elencare +le organizzazioni. Per elencare tutte le organizzazioni, esegui questo comando: + +`curl -b ./cookies.txt https://.ibm.com/codi/v1/organizations | python -m json.tool` +{: codeblock} + +
+ +
-b nomefile
+
Passa l'ID utente e la password memorizzati precedentemente +con l'opzione -c nel file al server HTTP come +un cookie.
+ +
+ +Per ciascuna organizzazione, i risultati includono le seguenti informazioni: +* `"guid"`, GUID dell'organizzazione +* `"name"`, nome dell'organizzazione + +Il seguente esempio mostra l'output di questo + comando: +``` +{ + "resources": [ + { + "guid": "05af098d-d476-4fb0-8b87-a84350e72af3", + "name": "org-1" + }, + { + "guid": "5129a5a8-37c2-4ee4-a9b2-bebae3531db5", + "name": "org-2" + }, + + .... + + ], + "total_results": 284 +} +``` +{: screen} + +### Elenco degli utenti +{: #listingusr} + +Puoi determinare se un utente è già stato aggiunto al tuo ambiente {{site.data.keyword.Bluemix_notm}} utilizzando +l'API REST `Admin` per elencare gli utenti registrati. Devi disporre dell'autorizzazione +**Utenti** con l'accesso in **Lettura** per elencare gli +utenti registrati. Per elencare tutti gli utenti, esegui questo comando: + +`curl -b ./cookies.txt https://.ibm.com/codi/v1/users | python -m json.tool` +{: codeblock} + +
+
-b nomefile
+
Passa l'ID utente e la password memorizzati precedentemente +con l'opzione -c nel file al server HTTP come +un cookie.
+
+ +Per ciascun utente registrato, i risultati includono le seguenti informazioni: +* `"first_name"` (nome) e + `"last_name"` (cognome) +* `"user_id"`, ID utente e indirizzo email +* `"guid"`, GUID dell'organizzazione. +* `"permissions"`, ossia le autorizzazioni assegnate all'utente per la Console di gestione. + +Il seguente esempio mostra l'output di questo + comando: + +``` +{ + "next_url": "/codi/v1/users?results_per_page=100&page=2", + "prev_url": "", + "resources": [ + { + "active": true, + "created_at": "2015-04-08T17:38:51.788Z", + "created_by": "", + "first_name": "some first name", + "guid": "5d5268cf-39c0-48d3-96ae-7afe928e5dd7", + "last_name": "some last name", + "permissions": [ + { + "display": "ops.admin" + }, + { + "display": "ops.catalog.write" + }, + { + "display": "ops.reports.write" + }, + { + "display": "ops.catalog.read" + }, + { + "display": "ops.users.write" + }, + { + "display": "ops.reports.read" + }, + { + "display": "ops.login" + }, + { + "display": "ops.users.read" + } + ], + "user_id": "someid@us.ibm.com" + }, + ... + + + } + ], + "total_pages": 395, + "total_results": 39421 +} + +``` +{: screen} + +### Aggiunta di un utente + +Puoi utilizzare l'API REST `Admin` per aggiungere utenti all'istanza {{site.data.keyword.Bluemix_notm}}. Devi +disporre dell'autorizzazione **Utenti** con l'accesso in **Scrittura** per aggiungere +gli utenti o l'autorizzazione **Superuser** (ops.admin) per la console di gestione. Inoltre, in qualità di Ammin, puoi consentire ai membri dell'organizzazione che non hanno le autorizzazioni `utente` o `superuser` generali della console di gestione, la possibilità di aggiungere nuovi utenti solo alle loro organizzazioni. Utilizza il seguente comando API per questa specifica capacità per i gestori organizzazione: + +``` +PUT console..bluemix.net/codi/env_config/allow_managers?flag= +``` +{: screen} + +Puoi aggiungere un singolo utente o un elenco di utenti. Puoi aggiungere utenti a una +o più organizzazioni. Per aggiungere un utente, +devi fornire le seguenti informazioni: + +* Nome e cognome dell'utente. Fornisci `"nome"` e `"cognome"` da [Elenco degli utenti](index.html#listingusr). +* Indirizzo email e ID utente: fornisci l'`"id_utente"` da [Elenco degli utenti](index.html#listingusr) sia per l'indirizzo email sia per l'ID utente. +* `"guid"`. Fornisci il GUID dell'organizzazione da [Elenco delle organizzazioni](index.html#listingorg). + +Per fornire le informazioni, ti servi di un file JSON. + +`curl -b ./cookies.txt https://.ibm.com/codi/v1/users | python -m json.tool` +{: codeblock} + +
+
-b nomefile
+
Passa l'ID utente e la password memorizzati precedentemente +con l'opzione -c nel file al server HTTP come +un cookie.
+
+ +
    +
  1. Crea un file JSON che contiene le informazioni in un formato JSON corretto. +

    Ad esempio, crea un file denominato `user.json` che presenta +questo contenuto:

    +
    +{
+    "members": [
+        {
+            "emails": [
+                "un_id_utente@dominio.com"
+            ],
+            "first_name": "un_nome",
+            "last_name": "un_cognome",
+            "user_id": "un_id_utente@dominio.com"
+        }
+    ],
+    "organization_roles": [
+        {
+            "id": "7a891f9c-e4e7-46c7-8b4e-dffaa7eb3bcd"
+        }
+    ]
+}
+
    +
    2. +
  2. Pubblica il contenuto del file JSON nell'endpoint dell'utente immettendo il seguente +comando:

    + +curl -v -b ./cookies.txt -X POST -H "Content-Type: application/json" -d @./user.json https://.ibm.com/codi/v1/users + +
    3. +
+ +
+
-v
+
Specifica un output dettagliato.
+
-X POST
+
Specifica una richiesta POST, sovrascrivendo la richiesta GET predefinita.
+
-H "Content-Type: application/json"
+
Specifica l'intestazione content-type, che in questo caso è JSON.
+
-d *dati*
+
Specifica i dati, in questo caso il file `user.json`, +da inviare nella richiesta POST al server HTTP.
+
+ +Il seguente esempio mostra l'output di questo + comando: + +``` +* Connected to localhost (127.0.0.1) port 3000 (#0) + > POST /codi/v1/users HTTP/1.1 + > User-Agent: curl/7.37.1 + > Host: localhost:3000 + > Accept: */* + > Cookie: opsConsole.sid=s%3AHLcwKGumyEb3IxREmikDOG3ATKD5xYMe.jfjWAa1tJC0rGghpeV8RPHqE2JaFVL4ZFIJbQpSC%2FAI + > Content-Type: application/json + > Content-Length: 333 + > + * upload completely sent off: 333 out of 333 bytes + < HTTP/1.1 201 Created + < x-powered-by: Express + < vary: X-HTTP-Method-Override + < content-type: application/json + < date: Wed, 22 Apr 2015 19:32:54 GMT + < connection: close + < transfer-encoding: chunked + < X-Time_Check: Proxy Time: 5612 msec + ``` +{: screen} + +### Rimozione di un utente + +Puoi utilizzare l'API REST `Admin` per rimuovere gli utenti dall'istanza {{site.data.keyword.Bluemix_notm}}. Per rimuovere +gli utenti, devi disporre dell'autorizzazione **Utenti** con l'accesso in **Scrittura**. + +Per rimuovere un utente, devi fornire l'ID dell'utente: Immetti il seguente comando: + +`curl -v -b ./cookies.txt -X DELETE https://.ibm.com/codi/v1/users?user_id=` +{: codeblock} + +
+
-X DELETE
+
Specifica una richiesta DELETE.
+
+ +Il seguente esempio mostra l'output di questo + comando: + +``` + * connect to ::1 port 3000 failed: Connection refused + * Trying 127.0.0.1... + * Connected to localhost (127.0.0.1) port 3000 (#0) + > DELETE /codi/v1/users?user_id=exampleuser@domain.com HTTP/1.1 + > User-Agent: curl/7.37.1 + > Host: localhost:3000 + > Accept: */* + > Cookie: opsConsole.sid=s%3AHLcwKGumyEb3IxREmikDOG3ATKD5xYMe.jfjWAa1tJC0rGghpeV8RPHqE2JaFVL4ZFIJbQpSC%2FAI + > + < HTTP/1.1 201 Created + < x-powered-by: Express + < content-type: application/json + < date: Wed, 22 Apr 2015 21:01:09 GMT + < connection: close + < transfer-encoding: chunked + < X-Time_Check: Proxy Time: 1922 msec + < + ``` +{: screen} + +## API per le metriche (sperimentale) +{: #envappmetricsapi} + +Puoi utilizzare tre API sperimentali per raccogliere le metriche sul tuo ambiente o sulle tue applicazioni. Queste API restituiscono un array di punti dati per le metriche che hai richiesto nell'intervallo di tempo che hai specificato. + +Puoi accedere alle API delle metriche descritte nelle seguenti sezioni dall'endpoint specifico della regione, ad esempio: + +`https://console..bluemix.net/admin/metrics` +{: codeblock} + +**Note**: + +1. Un utente può effettuare fino a 200 richieste API per le metriche in un'ora. +2. Ogni richiesta API restituisce fino a 200 punti dati per richiesta. Se sono disponibili più dati, viene fornito un URL per il caricamento della successiva serie di dati. +3. Ogni richiesta API richiede che un utente disponga almeno dell'accesso di base alla Console di gestione. Potrebbero essere richieste delle autorizzazioni aggiuntive, come specificato di seguito. + +## Raccolta delle metriche sul tuo ambiente + +Puoi utilizzare l'API di ambiente sperimentale per raccogliere le informazioni sull'ambiente di alto livello in un periodo di tempo che specifichi. Vengono restituiti i punti dati nel periodo di tempo che specifichi. I dati sono registrati approssimativamente ogni ora. Se, ad esempio, hai richiesto sei ore di dati CPU per l'ambiente, la risposta includerà i dati CPU per ognuna delle sei ore richieste. + + +### Endpoint di ambiente + +Puoi utilizzare il seguente endpoint per richiamare questo comando API: `/api/v1/env` + +**Nota**: per accedere a questi endpoint, è richiesta una delle seguenti autorizzazioni: **Accesso di base**, **Lettura utente**, **Scrittura utente** o **Superuser** + +### Parametri della query delle metriche di ambiente + +Utilizzando i seguenti parametri della query, puoi raccogliere le metriche per i tuoi CPU, disco, memoria, rete, quota e applicazioni: + +
+
metrica
+
Uno o più dei seguenti valori, separati da virgole: `memory`, `disk`, `cpu`, `network`, `quota` e `apps`.
+
OraInizio
+
Il primo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata una OraInizio, viene incluso il primo punto dati disponibile. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraInizio di 14.
+
OraFine
+
L'ultimo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata alcuna OraFine, viene utilizzato il punto dati più recente. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraFine di 17.
+
ordinamento
+
L'ordinamento in cui vengono restituiti i dati. I valori validi sono `asc` (crescente) e `desc` (decrescente). Il valore predefinito è decrescente, che restituisce prima i dati più recenti.
+
+ +Il seguente esempio utilizza i parametri di query per raccogliere le metriche relative al tuo ambiente: + +``` +curl -b ./cookies.txt --header "Accept: application/json" https://console..bluemix.net/admin/metrics/api/v1/env?metric=cpu,network,disk,apps,memory +``` +{: codeblock} + + +### Formato dei dati delle metriche di ambiente + +Le seguenti sezioni forniscono il formato dei dati. + + * Per raccogliere i dati registrati sul tuo utilizzo della memoria, utilizza il seguente formato dei dati: + +``` +{ + "sample_time": 1477494000000, + "memory": { + "total": { + "physical": { + "total_gb": 1728, + "used": { + "value_gb": 673.68, + "percent": 38.99 + } + }, + "allocated": { + "reserved_gb": 3456, + "total_allocated": { + "value_gb": 2575.18, + "percent": 74.51 + } + }, + }, + "cell": { + "physical": { + "total_gb": 864, + "used": { + "value_gb": 336.84, + "percent": 38.99 + } + }, + "allocated": { + "reserved_gb": 1728, + "total_allocated": { + "value_gb": 1287.59, + "percent": 74.51 + } + }, + }, + "dea": { + "physical": { + "total_gb": 864, + "used": { + "value_gb": 336.84, + "percent": 38.99 + } + }, + "allocated": { + "reserved_gb": 1728, + "total_allocated": { + "value_gb": 1287.59, + "percent": 74.51 + } + }, + }, + "memory_by_container": [ + { + "name": "dea_next/0", + "type": "dea", + "ip": "169.53.225.93", + "percent": "47" + }, + { + "name": "dea_next/1", + "type": "dea", + "ip": "169.53.225.89", + "percent": "51" + }, + { + "name": "dea_next/2", + "type": "dea", + "ip": "169.53.230.49", + "percent": "45" + }, + { + "name": "dea_next/3", + "type": "dea", + "ip": "169.44.109.231", + "percent": "43" + } + ] + } +} +``` +{: screen} + + * Per raccogliere i dati registrati sul tuo utilizzo del disco, utilizza il seguente formato dei dati: + +``` +{ + "sample_time": 1477494000000, + "disk": { + "total": { + "physical": { + "total_gb": 16200, + "used": { + "value_gb": 1614, + "percent": 9.96 + } + }, + "allocated": { + "reserved_gb": 32400, + "total_allocated": { + "value_gb": 3979, + "percent": 12.28 + } + }, + }, + "cell": { + "physical": { + "total_gb": 8100, + "used": { + "value_gb": 807, + "percent": 9.96 + } + }, + "allocated": { + "reserved_gb": 16200, + "total_allocated": { + "value_gb": 1989.5, + "percent": 12.28 + } + }, + }, + "dea": { + "physical": { + "total_gb": 8100, + "used": { + "value_gb": 807, + "percent": 9.96 + } + }, + "allocated": { + "reserved_gb": 16200, + "total_allocated": { + "value_gb": 1989.5, + "percent": 12.28 + } + }, + }, + "disk_by_container": [ + { + "name": "dea_next/0", + "type": "dea", + "ip": "169.53.225.93", + "percent": "13" + }, + { + "name": "dea_next/1", + "type": "dea", + "ip": "169.53.225.89", + "percent": "14" + }, + { + "name": "dea_next/2", + "type": "dea", + "ip": "169.53.230.49", + "percent": "13" + }, + { + "name": "dea_next/3", + "type": "dea", + "ip": "169.44.109.231", + "percent": "12" + } + ] + } +} +``` +{: screen} + + * Per raccogliere i dati registrati sul tuo utilizzo della CPU, utilizza il seguente formato dei dati: + +``` +{ + "sample_time": 1477494000000, + "cpu": { + "total": { + "average_percent_cpu_used": 14.725 + }, + "cell": { + "average_percent_cpu_used": 19 + }, + "dea": { + "average_percent_cpu_used": 10.45 + }, + "cpu_by_container": [ + { + "name": "dea_next/0", + "type": "dea", + "ip": "169.53.225.93", + "sys_percent": "8.4", + "user_percent": "2.7", + "wait_percent": "0.0" + }, + { + "name": "dea_next/1", + "type": "dea", + "ip": "169.53.225.89", + "sys_percent": "7.4", + "user_percent": "2.4", + "wait_percent": "0.0" + }, + { + "name": "cell/1", + "type": "cell", + "ip": "169.53.230.49", + "sys_percent": "5.3", + "user_percent": "1.9", + "wait_percent": "0.0" + }, + { + "name": "cell/2", + "type": "cell", + "ip": "169.44.109.231", + "sys_percent": "8.2", + "user_percent": "22.6", + "wait_percent": "0.0" + } + ] + } +} +``` +{: screen} + + * Per raccogliere i dati registrati sulla tua rete, utilizza il seguente formato dei dati: + +``` +{ + "sample_time": 1477494000000, + "network": { + "datapower": { + "response_times": [ + { + "proxy": "custom_certificates", + "ten_seconds_ms": "0", + "one_minute_ms": "0", + "ten_minutes_ms": "0", + "one_hour_ms": "0", + "one_day_ms": "0" + }, + { + "proxy": "bluemix", + "ten_seconds_ms": "90", + "one_minute_ms": "89", + "ten_minutes_ms": "83", + "one_hour_ms": "85", + "one_day_ms": "95" + } + ], + "transactions": [ + { + "proxy": "custom_domains", + "ten_seconds_ms": "0", + "one_minute_ms": "0", + "ten_minutes_ms": "0", + "one_hour_ms": "0", + "one_day_ms": "0" + }, + { + "proxy": "bluemix", + "ten_seconds_ms": "697", + "one_minute_ms": "747", + "ten_minutes_ms": "802", + "one_hour_ms": "794", + "one_day_ms": "730" + } + ], + "bandwidth": { + "in_kbps": 10855, + "out_kbps": 38090 + } + } +} +``` +{: screen} + +* Per raccogliere i dati registrati sul tuo utilizzo della quota, utilizza il seguente formato dei dati: + +``` +{ + "sample_time": 1477494000000, + "quota": { + "reserved_memory": { + "total_bytes": 33176474877952 + }, + "services": { + "total": 111650 + }, + "routes": { + "total": 1675000 + } + } +} +``` +{: screen} + +* Per raccogliere i dati registrati sulle tue applicazioni, utilizza il seguente formato dei dati: + +``` +{ + "sample_time": 1477494000000, + "apps": { + "count": 1406, + "allocation": { + "memory_gb": 571.8, + "disk_gb": 1204 + } + } +} +``` +{: screen} + +### Formato della risposta delle metriche di ambiente + +``` +{ + docs: [], + next_url: +} +``` +{: screen} + +## Raccolta delle metriche sulle tue organizzazioni + +I dati vengono registrati per tutte le organizzazioni approssimativamente ogni ora. Una richiesta per una metrica particolare restituisce le informazioni per tutte le organizzazioni in ogni esempio di dati nel periodo di tempo che specifichi, ordinate in modo decrescente per la metrica richiesta. Ad esempio, la richiesta di tutte le organizzazioni per memoria in un periodo di tempo di 6 ore in un ambiente con 200 applicazioni restituisce 1200 record, 200 alla volta. + +Per ridurre la quantità di informazioni restituite per ogni esempio di dati nel periodo di tempo richiesto, puoi specificare un'opzione di conteggio. Utilizzando il precedente esempio e aggiungendo un'opzione di conteggio di 5, vengono restituiti 30 record che rappresentano le prime 5 organizzazioni per memoria per ogni esempio di dati. + +### Endpoint delle organizzazioni + +Puoi utilizzare i seguenti endpoint per richiamare questo comando API: +* `/api/v1/org/memory/physical` +* `/api/v1/org/memory/reserved` +* `/api/v1/org/disk/physical` +* `/api/v1/org/disk/reserved` + +**Nota**: per accedere a questi endpoint, è richiesta una delle seguenti autorizzazioni: **Lettura utente**, **Scrittura utente** o **Superuser** + +### Parametri di query delle organizzazioni + +Utilizza i seguenti parametri della query per raccogliere le metriche per le tue organizzazioni: + +
+
OraInizio
+
Il primo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata una OraInizio, viene incluso il primo punto dati disponibile. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraInizio di 14.
+
OraFine
+
L'ultimo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata alcuna OraFine, viene utilizzato il punto dati più recente. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraFine di 17.
+
conteggio
+
Il numero di record da restituire in ogni esempio di dati. +
+
minValue
+
Il valore minimo da restituire per la metrica specificata. Se non si specifica alcun minValue, vengono restituiti tutti i valori. Ad esempio, per raccogliere organizzazioni che utilizzano almeno 20000 byte di memoria fisica, specifica un minValue di 20000. +
+
+ +Il seguente esempio raccoglie le metriche relative alle tue organizzazioni: + +``` +curl -b ./cookies.txt --header "Accept: application/json" https://console..bluemix.net/admin/metrics/api/v1/org/memory/physical?count=5&startTime=2016-12-02T16:54:09.467Z +``` +{: codeblock} + +### Formato della risposta delle organizzazioni + +``` +{ + docs: [], + next_url: +} +``` +{: screen} + +Ogni documento restituito rappresenta le metriche richieste per un'organizzazione in ogni esempio di dati, al momento della richiesta. + +## Raccolta delle metriche sulle tue applicazioni + +I dati vengono registrati per tutte le applicazioni approssimativamente ogni ora. Una richiesta per una metrica particolare restituisce le informazioni per tutte le applicazioni in ogni esempio di dati nel periodo di tempo che specifichi, ordinate in modo decrescente per la metrica richiesta. Ad esempio, la richiesta di tutte le applicazioni per la CPU in un periodo di tempo di 6 ore in un ambiente con 200 applicazioni restituisce 1200 record, 200 alla volta. + +Per ridurre la quantità di informazioni restituite per ogni esempio di dati nel periodo di tempo richiesto, puoi specificare un'opzione di conteggio. Utilizzando il precedente esempio e aggiungendo un'opzione di conteggio di 5, vengono restituiti 30 record che rappresentano le prime 5 applicazioni per CPU per ogni esempio di dati. + +### Endpoint delle applicazioni + +Puoi utilizzare i seguenti endpoint per richiamare questo comando API: +* `/api/v1/app/cpu/physical` +* `/api/v1/app/memory/physical` +* `/api/v1/app/memory/reserved` +* `/api/v1/app/disk/physical` +* `/api/v1/app/disk/reserved` + +**Nota**: per accedere a questi endpoint, è richiesta una delle seguenti autorizzazioni: **Lettura utente**, **Scrittura utente** o **Superuser** + +### Parametri della query delle applicazioni + +Utilizza i seguenti parametri della query per raccogliere le metriche per le tue applicazioni: + +
+
OraInizio
+
Il primo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata una OraInizio, viene incluso il primo punto dati disponibile. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraInizio di 14.
+
OraFine
+
L'ultimo punto nel tempo da cui vengono restituiti i dati. Se non viene specificata alcuna OraFine, viene utilizzato il punto dati più recente. Ad esempio, per raccogliere i dati tra la 14 e le 17, specificare una OraFine di 17.
+
conteggio
+
Il numero di record da restituire in ogni esempio di dati. +
+
minValue
+
Il valore minimo da restituire per la metrica specificata. Se non si specifica alcun minValue, vengono restituiti tutti i valori. Ad esempio, per raccogliere applicazioni che utilizzano almeno 20000 byte di memoria fisica, specifica un minValue di 20000. +
+
+ +Il seguente esempio raccoglie le metriche relative alle tue applicazioni: + +``` +curl -b ./cookies.txt --header "Accept: application/json" https://console..bluemix.net/admin/metrics/api/v1/app/cpu/physical?count=5&startTime=2016-12-02T16:54:09.467Z +``` +{: codeblock} + + +### Formato della risposta delle applicazioni + +``` +{ + docs: [], + next_url: +} +``` +{: screen} + +Ogni documento restituito rappresenta le metriche richieste per un'applicazione in ogni esempio di dati, al momento della richiesta. + + +## API del servizio personalizzato +{: #servicebrokerapi} + +Sono disponibili tre API che ti consentono di registrare o creare un servizio, di aggiornare un servizio e di eliminare un servizio. + +Tutte le API sono relative a https://console.<subdomain>.bluemix.net/. + +
+
<dominiosecondario>
+
Questo valore è il nome della tua istanza locale o dedicata. Il nome del dominio secondario per la tua istanza {{site.data.keyword.Bluemix}} è stato +assegnato durante l'onboarding.
+
+ +## Registrazione di un nuovo servizio + +Utilizza i seguenti esempi di API e codice per registrare un nuovo servizio. + +### Rotta +{: #registerroute} + +``` +POST /codi/v1/serviceBrokers +``` +{: screen} + +### Richiesta +{: #registerrequest} + +{: #ld_table15} + +| **Nome** | **Descrizione** | +|-----------------|-------------------| +| name | Nome del broker dei servizi. | +| auth_username | Nome utente utilizzato per connettersi al broker dei servizi. | +| auth_password | Password utilizzata per connettersi al broker dei servizi. | +| broker_url | URL utilizzato per connettersi al broker dei servizi. | +| owningOrganization | Organizzazione iniziale per cui aggiungere il servizio nell'elenco elementi consentiti. | +{: caption="Table 15. Fields" caption-side="top"} + +#### Corpo +{: #registerbody} + +``` +{ + "name" : "Nome del broker dei servizi", + "auth_username" : "nome utente", + "auth_password" : "password", + "broker_url" : "https://broker.comp.com", + "owningOrganization" : "ORG" +} +``` +{: screen} + +#### Intestazioni +{: #registerheaders} + +``` +Autorizzazione: bearer eyJ0eXAiOiJKV1QiLCJhbG ... ciOiJIUzI1 +Host: console.comp.bluemix.net +Content-Type: application/json +``` +{: screen} + +### Risposta +{: #registerresponse} + +#### Stato +{: #registerstatus} + +``` +201 Creato +``` +{: screen} + +#### Corpo +{: #registerbody2} + +``` +{ + "_id": "2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68", + "name": "Service broker's name", + "broker_url": "https://provision-broker.comp.bluemix.net/bmx/provisioning/brokers/2063580064-8f23230c-7f36-4ce5-a298-2ab4108f1120", + "proxy_broker_url": "https://provision-broker.dys0.bluemix.net/bmx/provisioning/brokers/2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68", + "auth_username": "username", + "created_on": "2016-09-30T16:45:56.304Z" +} + +``` +{: screen} + +## Aggiornamento di un servizio + +Utilizza i seguenti esempi di API e codice per aggiornare un servizio. + +### Rotta +{: #updateroute} + +`PUT /codi/v1/serviceBrokers` +{: screen} + +### Richiesta +{: #updaterequest} + +{: #ld_table16} + +| **Nome** | **Descrizione** | +|-----------------|-------------------| +| name | Nome del broker dei servizi. Questo nome non può essere modificato dal nome con cui è stato creato il servizio. | +| auth_username | Nome utente utilizzato per connettersi al broker dei servizi. | +| auth_password | Password utilizzata per connettersi al broker dei servizi. | +| broker_url | URL utilizzato per connettersi al broker dei servizi. | +| owningOrganization | Organizzazione iniziale per cui aggiungere il servizio nell'elenco elementi consentiti. | +{: caption="Table 16. Requests" caption-side="top"} + +#### Corpo +{: #updatebody} + +``` +{ + "name" : "Nome del broker dei servizi", + "auth_username" : "nome utente", + "auth_password" : "nuova password", + "broker_url" : "https://broker.comp.com", + "owningOrganization" : "ORG" +} +``` +{: screen} + +#### Intestazioni +{: #updateheaders} + +``` +Autorizzazione: bearer eyJ0eXAiOiJKV1QiLCJhbG ... ciOiJIUzI1 +Host: console.comp.bluemix.net +Content-Type: application/json +``` +{: screen} + +### Risposta +{: #updateresponse} + +#### Stato +{: #updatestatus} + +``` +201 Creato +``` +{: screen} + +#### Corpo +{: #updatebody2} + +``` +{ + "_id": "2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68", + "name": "Service Broker's name", + "broker_url": "https://provision-broker.dys0.bluemix.net/bmx/provisioning/brokers/2063580064-d11bdd84-7556-469f-858d-2098b531f7f2", + "proxy_broker_url": "https://provision-broker.dys0.bluemix.net/bmx/provisioning/brokers/2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68", + "auth_username": "username", + "created_on": "2016-09-30T16:45:56.304Z" +} +``` +{: screen} + +## Eliminazione di un servizio + +Utilizza i seguenti esempi di API e codice per eliminare un servizio. + + +{: #ld_table17} + +| **Nome** | **Descrizione** | +|-----------------|-------------------| +| name | Nome del broker dei servizi. Questo nome non può essere modificato dal nome con cui è stato creato il servizio. | +{: caption="Table 17. Parameter" caption-side="top"} + +### Rotta + +``` +DELETE /codi/v1/serviceBrokers?name=name of service broker +``` +{: screen} + +### Richiesta +{: #deleterequest} + +#### Intestazioni +{: #deleteheaders} + +``` +Autorizzazione: bearer eyJ0eXAiOiJKV1QiLCJhbG ... ciOiJIUzI1 +Host: console.comp.bluemix.net +Content-Type: application/json +``` +{: screen} + +### Risposta +{: #deleteresponse} + +#### Stato +{: #deletestatus} + +``` +204 Nessun contenuto +``` +{: screen} + +## Gestione degli utenti con la CLI cf +{: #usingadmincli} + +Puoi gestire gli utenti per il tuo ambiente {{site.data.keyword.Bluemix_notm}} +utilizzando l'interfaccia riga di comando Cloud Foundry insieme al plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI. Ad +esempio, puoi aggiungere utenti da un registro LDAP. + +Prima di iniziare, installa l'interfaccia riga di comando cf. Il plug-in {{site.data.keyword.Bluemix_notm}} Admin +CLI richiede cf versione 6.11.2 o successive. [Scarica Cloud Foundry command line interface ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/cli/releases){: new_window}. + +**Limitazione:** l'interfaccia riga di comando Cloud Foundry non +è supportata da Cygwin. Utilizza l'interfaccia riga di comando Cloud Foundry +in una finestra riga di comando diversa da quella di Cygwin. + +### Aggiunta del plug-in {{site.data.keyword.Bluemix_notm}} Admin +CLI + +Dopo aver installato l'interfaccia riga di comandi cf, puoi +aggiungere il plug-in {{site.data.keyword.Bluemix_notm}} Admin +CLI. + +**Nota**: se avevi già installato il plug-in Gestione {{site.data.keyword.Bluemix_notm}}, per ottenere gli ultimi aggiornamenti potresti doverlo disinstallare, eliminare il repository e reinstallare il plug-in. + +Completa la seguente procedura per aggiungere il repository e installare +il plug-in: + +
    +
  1. Per aggiungere il repository del plug-in Gestione {{site.data.keyword.Bluemix_notm}}, immetti il seguente comando:

    + +cf add-plugin-repo BluemixAdmin https://console.<subdomain>.bluemix.net/cli +

    +
    +
    <dominiosecondario>
    +
    Dominio secondario dell'URL per la tua istanza {{site.data.keyword.Bluemix_notm}}.
    +
    +
    2. +
  2. Per installare il plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI, immetti il seguente comando:

    + +cf install-plugin bluemix-admin-cli -r BluemixAdmin + +
    3. +
+ +Per visualizzare un elenco di comandi, immetti il seguente +comando: + +``` +cf plugins +``` +{: codeblock} + +Per ulteriore assistenza per un comando, utilizza l'opzione `-help`. + +Per ulteriori informazioni su come utilizzare il plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI, vedi [{{site.data.keyword.Bluemix_notm}} admin](../cli/plugins/bluemix_admin/index.html). diff --git a/admin/nl/it/orgs_spaces.md b/admin/nl/it/orgs_spaces.md index 2453c5b7a..f469a3326 100644 --- a/admin/nl/it/orgs_spaces.md +++ b/admin/nl/it/orgs_spaces.md @@ -1,198 +1,198 @@ ---- - - - -copyright: - - years: 2015, 2016 -lastupdated: "2016-12-05" - - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} - -# Gestione di organizzazioni e spazi -{: #orgsspacesusers} - -In qualità di proprietario dell'account, puoi gestire le tue organizzazioni andando alla pagina **Gestisci organizzazioni**. I gestori dell'organizzazione possono anche utilizzare la pagina Gestisci organizzazioni per gestire le organizzazioni dove sono impostati come gestore. -{:shortdesc} - -Le attività di gestione includono quanto segue: - -* Creazione di un'organizzazione o di uno spazio -* Rinominazione di un'organizzazione -* Eliminazione di un'organizzazione o di uno spazio esistenti -* Elencazione dei membri del team aggiunti al tuo account o alla tua organizzazione -* Gestione o visualizzazione della quota -* Gestione dei domini personalizzati - -**Nota**: per creare un'organizzazione devi essere il proprietario di un account con pagamento a consumo. - -## Organizzazioni -{: #orginfo} - -Le organizzazioni possono estendersi a più regioni e sono definite dai seguenti elementi: - -
-
Membri dei team
-
Il ruolo con l'autorizzazione di base in organizzazioni e spazi. Devi essere assegnato -a un'organizzazione prima che ti possano essere concesse altre autorizzazioni agli -spazi all'interno dell'organizzazione. Per informazioni dettagliate, -consulta [Utenti e ruoli](users_roles.html#userrolesinfo).
-
Domini
-
Fornisci la rotta su internet che è assegnata all'organizzazione. Una rotta ha un dominio secondario e un dominio. Un dominio secondario è di norma il -nome dell'applicazione. Un dominio può essere un dominio di sistema o un dominio personalizzato che hai registrato per la tua applicazione. Vedi [Gestione dei domini personalizzati](orgs_spaces.html#managedomains).
-

**Nota**: se aggiungi un dominio personalizzato, devi configurare il server DNS per risolvere il tuo dominio personalizzato per puntare al dominio di sistema {{site.data.keyword.Bluemix_notm}}. In questo modo, quando {{site.data.keyword.Bluemix_notm}} riceve una richiesta per il tuo dominio personalizzato, può correttamente instradarla alla tua applicazione.

-
Quota
-
Rappresenta i limiti di risorse per l'organizzazione, compreso il numero di servizi -e la quantità di memoria che può essere assegnata per l'utilizzo da parte dell'organizzazione. Le quote vengono assegnate quando -vengono create le organizzazioni. Applicazioni o servizi in uno spazio dell'organizzazione contribuiscono tutti -all'utilizzo della quota. La quota non è una restrizione imposta. È invece un trigger per le notifiche di spesa. Con i piani Pagamento a consumo o Sottoscrizione, puoi regolare la tua quota per le applicazioni e i contenitori Cloud Foundry in base al variare delle esigenze della tua organizzazione. Vedi [Gestione della quota](orgs_spaces.html#managequota).
-
- -In {{site.data.keyword.Bluemix_notm}}, puoi utilizzare le organizzazioni per abilitare la collaborazione tra i membri del team e per facilitare il raggruppamento -logico di risorse dei progetti nei seguenti modi: - -
    -
  • Puoi raggruppare un insieme di spazi, applicazioni, servizi, domini, rotte e membri del team nelle organizzazioni.
    • -
  • Puoi gestire l'accesso agli spazi e alle organizzazioni in base ai singoli utenti.
    • -
- -Quando crei -un'organizzazione, il suo nome deve essere univoco in {{site.data.keyword.Bluemix_notm}}. Se il nome dell'organizzazione è già utilizzato da un altro utente di {{site.data.keyword.Bluemix_notm}} pubblico, dedicato o locale, devi specificare un nuovo nome. Dopo che hai creato l'organizzazione, ti verrà automaticamente assegnata -l'autorizzazione *Gestore organizzazione*, che ti consente di modificare il nome dell'organizzazione, di aggiungere membri del team e di creare o eliminare spazi nell'organizzazione. - -Per eliminare un'organizzazione devi rivolgerti al [Supporto di {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixsupport){: new_window} per eliminare un'organizzazione. Quando richiedi al team di supporto di eliminare un'organizzazione, vengono eliminati tutti gli spazi, i servizi e le applicazioni al suo interno. - -I seguenti [ruoli utente](/docs/admin/users_roles.html#userrolesinfo) possono essere assegnati ai membri del team in un'organizzazione: - -
    -
  • Gestore organizzazione
    • -
  • Gestore fatturazione dell'organizzazione
    • -
  • Revisore organizzazione
    • -
- - - -## Spazi -{: #spaceinfo} - -In un'organizzazione, puoi utilizzare gli spazi per raggruppare una serie di applicazioni, servizi e membri del team. Gli spazi sono collegati a una specifica -regione in {{site.data.keyword.Bluemix_notm}}. - -Dopo che hai aggiunto dei membri del team a un'organizzazione, puoi concedere loro le autorizzazioni agli spazi. Analogamente alle organizzazioni, anche gli spazi hanno una serie di [ruoli utente](/docs/admin/users_roles.html#userrolesinfo) con specifiche autorizzazioni che vengono assegnati ai membri del team: - -
    -
  • Gestore spazio
    • -
  • Sviluppatore spazio
    • -
  • Revisore spazio
    • -
- -**Nota**: a un membro del team deve essere assegnata almeno una delle autorizzazioni nello spazio. - -## Creazione di organizzazioni e spazi -{: #createorg} - -Solo i proprietari di account con degli account Pagamento a consumo possono creare un'organizzazione. Puoi creare un'organizzazione completando la seguente procedura: - -1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. -2. Fai clic su **Aggiungi una nuova organizzazione**. -3. Immetti il nome dell'organizzazione. -4. Fai clic su **Aggiungi**. - -Puoi creare degli spazi nella tua organizzazione; ad esempio, -uno spazio *dev* come un ambiente di sviluppo, -uno spazio *test* come un ambiente di test e uno -spazio *production* come un ambiente di produzione. Puoi quindi associare le tue applicazioni agli spazi. Per creare uno spazio, completa la seguente procedura: - -1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. -2. Identifica l'organizzazione a cui vuoi aggiungere uno spazio e seleziona **Visualizza dettagli**. -4. Fai clic su **Aggiungi uno spazio**. -5. Immetti il nome dello spazio. -6. Fai clic su **Aggiungi**. - -## Rinominazione di un'organizzazione -{: #orgrename} - -Per rinominare la tua organizzazione, completa la seguente procedura: - -1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. -2. Identifica l'organizzazione che vuoi modificare e seleziona **Visualizza dettagli**. -3. Seleziona **Modifica organizzazione**. -4. Seleziona **Modifica** per il titolo dell'organizzazione. -5. Immetti il nome della nuova organizzazione. -6. Fai clic su **SALVA**. - -## Eliminazione di un'organizzazione o di uno spazio esistenti -{: #deleteorgs} - -In qualità di proprietario dell'account, puoi rivolgerti al [supporto di {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixsupport){: new_window} per eliminare un'organizzazione. - -**Nota**: le operazioni di eliminazione sono irreversibili. Perdi tutte le applicazioni e tutti i servizi associati all'organizzazione. - -Puoi eliminare uno spazio dalla pagina **Gestisci organizzazioni**: - -1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. -2. Identifica l'organizzazione che vuoi modificare e seleziona **Visualizza dettagli**. -3. Identifica lo spazio che vuoi eliminare e seleziona **Modifica spazio**. -4. Fai clic su **Modifica spazio**. - -## Elenco dei membri -{: #listmembers} - -Per elencare i membri per una specifica organizzazione, completa la seguente procedura: - -1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. -2. Identifica l'organizzazione per cui vuoi visualizzare i membri e fai clic su **Visualizza dettagli**. -3. Fai clic su **Modifica organizzazione**. -4. Puoi visualizzare i membri della tua organizzazione e i loro ruoli nella scheda **UTENTI**. - -Per elencare i membri per uno specifico spazio, completa la seguente procedura: - -1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. -2. Identifica l'organizzazione per cui vuoi visualizzare i membri e fai clic su **Visualizza dettagli**. -3. Identifica lo spazio per cui vuoi visualizzare i membri e fai clic su **Modifica spazio**. -4. Puoi visualizzare i membri del tuo spazio e i loro ruoli nella scheda **UTENTI**. - -## Gestione della quota -{: #managequota} - -In qualità di proprietario dell'account o di gestore dell'organizzazione {{site.data.keyword.Bluemix_notm}}, puoi visualizzare la quota utilizzata e assegnata per un'organizzazione. La quota rappresenta i limiti di risorse per l'organizzazione, che viene assegnata quando l'organizzazione viene creata. Il limite non è una restrizione imposta nell'organizzazione. È invece un trigger per le notifiche di spesa. A seconda che si disponga di un account di prova o di un account fatturabile, le risorse disponibili per un'organizzazione sono diverse. Applicazioni o servizi in uno spazio all'interno dell'organizzazione contribuiscono tutti all'utilizzo della quota assegnata. - -Per visualizzare la quota utilizzata e assegnata per un'organizzazione, completa la seguente procedura: - -1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. -2. Identifica l'organizzazione per cui vuoi visualizzare la quota e fai clic su **Visualizza dettagli**. -3. Fai clic su **Modifica organizzazione**. -4. Se hai degli spazi definiti in più di un'organizzazione, seleziona la specifica regione che vuoi visualizzare. -5. Fai clic su **QUOTA**. -6. Per impostazione predefinita, si apre la pagina della quota **Cloud Foundry**. Puoi visualizzare i dettagli della quota per le seguenti risorse: - * MEMORIA - * SERVIZI - * PIANO - * PREZZO -7. Fai clic su **Contenitori** per visualizzare l'assegnazione della quota utilizzate e disponibile per i contenitori. L'assegnazione del contenitore varia a seconda del piano prezzi. Puoi visualizzare i dettagli della quota per le seguenti risorse: - * MEMORIA - * IP PUBBLICO - -**Nota:** i contenitori non sono disponibili nella regione {{site.data.keyword.Bluemix_notm}} Sydney. - -Per ulteriori informazioni sui contenitori, vedi [Quota](/docs/containers/container_planning_org_ov.html#container_planning_quota) nella documentazione dei contenitori. -Per modificare la quota assegnata a un'organizzazione, devi aprire un ticket di supporto. Per ulteriori informazioni sull'apertura di un ticket di supporto, vedi [Richiesta di assistenza clienti](/docs/support/index.html#contacting-support). - -## Gestione dei domini -{: #managedomains} - -In qualità di proprietario dell'account o di gestore dell'organizzazione, puoi visualizzare il dominio di sistema e aggiungere domini personalizzati per le applicazioni create all'interno di un'organizzazione e dei relativi spazi. In qualità di gestore spazio, la scheda **Domini** per uno spazio è un elenco di sola lettura dei domini assegnati allo spazio. - -1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. -2. Identifica l'organizzazione per cui vuoi visualizzare o modificare i domini. -3. Seleziona **Visualizza dettagli** per tale organizzazione. -4. Fai clic su **Modifica organizzazione**. -5. Fai clic su **DOMINI**. - -Se aggiungi un dominio personalizzato, devi configurare il server DNS per risolvere il tuo dominio personalizzato per puntare al dominio di sistema {{site.data.keyword.Bluemix_notm}}. In questo modo, quando {{site.data.keyword.Bluemix_notm}} riceve una richiesta per il tuo dominio personalizzato, può correttamente instradarla alla tua applicazione. Il dominio di sistema è sempre disponibile per uno spazio e a uno spazio è anche possibile assegnare dei domini personalizzati. Le applicazioni create in uno spazio possono utilizzare qualsiasi dominio elencato per tale spazio. Per ulteriori informazioni sulla creazione e l'utilizzo dei domini personalizzati, consulta [Utilizzo di un dominio personalizzato](/docs/manageapps/updapps.html#domain). +--- + + + +copyright: + + years: 2015, 2016 +lastupdated: "2016-12-05" + + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} + +# Gestione di organizzazioni e spazi +{: #orgsspacesusers} + +In qualità di proprietario dell'account, puoi gestire le tue organizzazioni andando alla pagina **Gestisci organizzazioni**. I gestori dell'organizzazione possono anche utilizzare la pagina Gestisci organizzazioni per gestire le organizzazioni dove sono impostati come gestore. +{:shortdesc} + +Le attività di gestione includono quanto segue: + +* Creazione di un'organizzazione o di uno spazio +* Rinominazione di un'organizzazione +* Eliminazione di un'organizzazione o di uno spazio esistenti +* Elencazione dei membri del team aggiunti al tuo account o alla tua organizzazione +* Gestione o visualizzazione della quota +* Gestione dei domini personalizzati + +**Nota**: per creare un'organizzazione devi essere il proprietario di un account con pagamento a consumo. + +## Organizzazioni +{: #orginfo} + +Le organizzazioni possono estendersi a più regioni e sono definite dai seguenti elementi: + +
+
Membri dei team
+
Il ruolo con l'autorizzazione di base in organizzazioni e spazi. Devi essere assegnato +a un'organizzazione prima che ti possano essere concesse altre autorizzazioni agli +spazi all'interno dell'organizzazione. Per informazioni dettagliate, +consulta [Utenti e ruoli](users_roles.html#userrolesinfo).
+
Domini
+
Fornisci la rotta su internet che è assegnata all'organizzazione. Una rotta ha un dominio secondario e un dominio. Un dominio secondario è di norma il +nome dell'applicazione. Un dominio può essere un dominio di sistema o un dominio personalizzato che hai registrato per la tua applicazione. Vedi [Gestione dei domini personalizzati](orgs_spaces.html#managedomains).
+

**Nota**: se aggiungi un dominio personalizzato, devi configurare il server DNS per risolvere il tuo dominio personalizzato per puntare al dominio di sistema {{site.data.keyword.Bluemix_notm}}. In questo modo, quando {{site.data.keyword.Bluemix_notm}} riceve una richiesta per il tuo dominio personalizzato, può correttamente instradarla alla tua applicazione.

+
Quota
+
Rappresenta i limiti di risorse per l'organizzazione, compreso il numero di servizi +e la quantità di memoria che può essere assegnata per l'utilizzo da parte dell'organizzazione. Le quote vengono assegnate quando +vengono create le organizzazioni. Applicazioni o servizi in uno spazio dell'organizzazione contribuiscono tutti +all'utilizzo della quota. La quota non è una restrizione imposta. È invece un trigger per le notifiche di spesa. Con i piani Pagamento a consumo o Sottoscrizione, puoi regolare la tua quota per le applicazioni e i contenitori Cloud Foundry in base al variare delle esigenze della tua organizzazione. Vedi [Gestione della quota](orgs_spaces.html#managequota).
+
+ +In {{site.data.keyword.Bluemix_notm}}, puoi utilizzare le organizzazioni per abilitare la collaborazione tra i membri del team e per facilitare il raggruppamento +logico di risorse dei progetti nei seguenti modi: + +
    +
  • Puoi raggruppare un insieme di spazi, applicazioni, servizi, domini, rotte e membri del team nelle organizzazioni.
    • +
  • Puoi gestire l'accesso agli spazi e alle organizzazioni in base ai singoli utenti.
    • +
+ +Quando crei +un'organizzazione, il suo nome deve essere univoco in {{site.data.keyword.Bluemix_notm}}. Se il nome dell'organizzazione è già utilizzato da un altro utente di {{site.data.keyword.Bluemix_notm}} pubblico, dedicato o locale, devi specificare un nuovo nome. Dopo che hai creato l'organizzazione, ti verrà automaticamente assegnata +l'autorizzazione *Gestore organizzazione*, che ti consente di modificare il nome dell'organizzazione, di aggiungere membri del team e di creare o eliminare spazi nell'organizzazione. + +Per eliminare un'organizzazione devi rivolgerti al [Supporto di {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixsupport){: new_window} per eliminare un'organizzazione. Quando richiedi al team di supporto di eliminare un'organizzazione, vengono eliminati tutti gli spazi, i servizi e le applicazioni al suo interno. + +I seguenti [ruoli utente](/docs/admin/users_roles.html#userrolesinfo) possono essere assegnati ai membri del team in un'organizzazione: + +
    +
  • Gestore organizzazione
    • +
  • Gestore fatturazione dell'organizzazione
    • +
  • Revisore organizzazione
    • +
+ + + +## Spazi +{: #spaceinfo} + +In un'organizzazione, puoi utilizzare gli spazi per raggruppare una serie di applicazioni, servizi e membri del team. Gli spazi sono collegati a una specifica +regione in {{site.data.keyword.Bluemix_notm}}. + +Dopo che hai aggiunto dei membri del team a un'organizzazione, puoi concedere loro le autorizzazioni agli spazi. Analogamente alle organizzazioni, anche gli spazi hanno una serie di [ruoli utente](/docs/admin/users_roles.html#userrolesinfo) con specifiche autorizzazioni che vengono assegnati ai membri del team: + +
    +
  • Gestore spazio
    • +
  • Sviluppatore spazio
    • +
  • Revisore spazio
    • +
+ +**Nota**: a un membro del team deve essere assegnata almeno una delle autorizzazioni nello spazio. + +## Creazione di organizzazioni e spazi +{: #createorg} + +Solo i proprietari di account con degli account Pagamento a consumo possono creare un'organizzazione. Puoi creare un'organizzazione completando la seguente procedura: + +1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. +2. Fai clic su **Aggiungi una nuova organizzazione**. +3. Immetti il nome dell'organizzazione. +4. Fai clic su **Aggiungi**. + +Puoi creare degli spazi nella tua organizzazione; ad esempio, +uno spazio *dev* come un ambiente di sviluppo, +uno spazio *test* come un ambiente di test e uno +spazio *production* come un ambiente di produzione. Puoi quindi associare le tue applicazioni agli spazi. Per creare uno spazio, completa la seguente procedura: + +1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. +2. Identifica l'organizzazione a cui vuoi aggiungere uno spazio e seleziona **Visualizza dettagli**. +4. Fai clic su **Aggiungi uno spazio**. +5. Immetti il nome dello spazio. +6. Fai clic su **Aggiungi**. + +## Rinominazione di un'organizzazione +{: #orgrename} + +Per rinominare la tua organizzazione, completa la seguente procedura: + +1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. +2. Identifica l'organizzazione che vuoi modificare e seleziona **Visualizza dettagli**. +3. Seleziona **Modifica organizzazione**. +4. Seleziona **Modifica** per il titolo dell'organizzazione. +5. Immetti il nome della nuova organizzazione. +6. Fai clic su **SALVA**. + +## Eliminazione di un'organizzazione o di uno spazio esistenti +{: #deleteorgs} + +In qualità di proprietario dell'account, puoi rivolgerti al [supporto di {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixsupport){: new_window} per eliminare un'organizzazione. + +**Nota**: le operazioni di eliminazione sono irreversibili. Perdi tutte le applicazioni e tutti i servizi associati all'organizzazione. + +Puoi eliminare uno spazio dalla pagina **Gestisci organizzazioni**: + +1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. +2. Identifica l'organizzazione che vuoi modificare e seleziona **Visualizza dettagli**. +3. Identifica lo spazio che vuoi eliminare e seleziona **Modifica spazio**. +4. Fai clic su **Modifica spazio**. + +## Elenco dei membri +{: #listmembers} + +Per elencare i membri per una specifica organizzazione, completa la seguente procedura: + +1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. +2. Identifica l'organizzazione per cui vuoi visualizzare i membri e fai clic su **Visualizza dettagli**. +3. Fai clic su **Modifica organizzazione**. +4. Puoi visualizzare i membri della tua organizzazione e i loro ruoli nella scheda **UTENTI**. + +Per elencare i membri per uno specifico spazio, completa la seguente procedura: + +1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. +2. Identifica l'organizzazione per cui vuoi visualizzare i membri e fai clic su **Visualizza dettagli**. +3. Identifica lo spazio per cui vuoi visualizzare i membri e fai clic su **Modifica spazio**. +4. Puoi visualizzare i membri del tuo spazio e i loro ruoli nella scheda **UTENTI**. + +## Gestione della quota +{: #managequota} + +In qualità di proprietario dell'account o di gestore dell'organizzazione {{site.data.keyword.Bluemix_notm}}, puoi visualizzare la quota utilizzata e assegnata per un'organizzazione. La quota rappresenta i limiti di risorse per l'organizzazione, che viene assegnata quando l'organizzazione viene creata. Il limite non è una restrizione imposta nell'organizzazione. È invece un trigger per le notifiche di spesa. A seconda che si disponga di un account di prova o di un account fatturabile, le risorse disponibili per un'organizzazione sono diverse. Applicazioni o servizi in uno spazio all'interno dell'organizzazione contribuiscono tutti all'utilizzo della quota assegnata. + +Per visualizzare la quota utilizzata e assegnata per un'organizzazione, completa la seguente procedura: + +1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. +2. Identifica l'organizzazione per cui vuoi visualizzare la quota e fai clic su **Visualizza dettagli**. +3. Fai clic su **Modifica organizzazione**. +4. Se hai degli spazi definiti in più di un'organizzazione, seleziona la specifica regione che vuoi visualizzare. +5. Fai clic su **QUOTA**. +6. Per impostazione predefinita, si apre la pagina della quota **Cloud Foundry**. Puoi visualizzare i dettagli della quota per le seguenti risorse: + * MEMORIA + * SERVIZI + * PIANO + * PREZZO +7. Fai clic su **Contenitori** per visualizzare l'assegnazione della quota utilizzate e disponibile per i contenitori. L'assegnazione del contenitore varia a seconda del piano prezzi. Puoi visualizzare i dettagli della quota per le seguenti risorse: + * MEMORIA + * IP PUBBLICO + +**Nota:** i contenitori non sono disponibili nella regione {{site.data.keyword.Bluemix_notm}} Sydney. + +Per ulteriori informazioni sui contenitori, vedi [Quota](/docs/containers/container_planning_org_ov.html#container_planning_quota) nella documentazione dei contenitori. +Per modificare la quota assegnata a un'organizzazione, devi aprire un ticket di supporto. Per ulteriori informazioni sull'apertura di un ticket di supporto, vedi [Richiesta di assistenza clienti](/docs/support/index.html#contacting-support). + +## Gestione dei domini +{: #managedomains} + +In qualità di proprietario dell'account o di gestore dell'organizzazione, puoi visualizzare il dominio di sistema e aggiungere domini personalizzati per le applicazioni create all'interno di un'organizzazione e dei relativi spazi. In qualità di gestore spazio, la scheda **Domini** per uno spazio è un elenco di sola lettura dei domini assegnati allo spazio. + +1. Fai clic sulla pagina **Account** > **Gestisci organizzazioni**. +2. Identifica l'organizzazione per cui vuoi visualizzare o modificare i domini. +3. Seleziona **Visualizza dettagli** per tale organizzazione. +4. Fai clic su **Modifica organizzazione**. +5. Fai clic su **DOMINI**. + +Se aggiungi un dominio personalizzato, devi configurare il server DNS per risolvere il tuo dominio personalizzato per puntare al dominio di sistema {{site.data.keyword.Bluemix_notm}}. In questo modo, quando {{site.data.keyword.Bluemix_notm}} riceve una richiesta per il tuo dominio personalizzato, può correttamente instradarla alla tua applicazione. Il dominio di sistema è sempre disponibile per uno spazio e a uno spazio è anche possibile assegnare dei domini personalizzati. Le applicazioni create in uno spazio possono utilizzare qualsiasi dominio elencato per tale spazio. Per ulteriori informazioni sulla creazione e l'utilizzo dei domini personalizzati, consulta [Utilizzo di un dominio personalizzato](/docs/manageapps/updapps.html#domain). diff --git a/admin/nl/it/profile.md b/admin/nl/it/profile.md index 026f1b01e..65af87bd6 100644 --- a/admin/nl/it/profile.md +++ b/admin/nl/it/profile.md @@ -1,61 +1,61 @@ ---- - - - -copyright: - - years: 2015, 2016 -lastupdated: "2016-10-20" - - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} - -# Impostazioni del profilo -{: #usersettings} - -Vai all'icona **{{site.data.keyword.avatar}}** ![icona Avatar](../icons/i-avatar-icon.svg) > **Profilo utente** per aggiornare le impostazioni del tuo profilo. -{:shortdesc} - - Nella pagina **Profilo**, puoi impostare o aggiornare le seguenti informazioni: - - * Una foto del profilo visibile agli altri utenti {{site.data.keyword.Bluemix_notm}} - * Informazioni dell'ID IBM, tra cui nome, e-mail, numero di telefono, password, azienda e ruolo. - * Impostazione della traccia di analisi - -## Modifica della tua foto del profilo -{: #photo} - -1. Vai all'icona **{{site.data.keyword.avatar}}** ![icona Avatar](../icons/i-avatar-icon.svg) > **Profilo utente**. - -* Fai clic su **CARICA UNA FOTO** per caricare una foto. -* Fai clic su **MODIFICA FOTO** per caricare una nuova foto. -* Fai clic su **Rimuovi foto** per rimuovere la tua foto. - -## Modifica delle informazioni del tuo ID IBM -{: #ibmid} - -Un ID IBM è un singolo ID che utilizzi per accedere al tuo account {{site.data.keyword.Bluemix_notm}} per le funzioni di infrastruttura, servizi e applicazione. Il tuo ID IBM è lo stesso ID che puoi utilizzare per accedere alle altre applicazioni IBM. - -L'ID IBM non può essere modificato, ma puoi modificare le tue informazioni di profilo ad esso associate. Se devi modificare le informazioni relative al tuo account dell'ID IBM, quali nome, e-mail, numero di telefono, password o nome dell'azienda, completa la seguente procedura: - -1. Vai all'icona **{{site.data.keyword.avatar}}** ![icona Avatar](../icons/i-avatar-icon.svg) > **Profilo utente**. -2. Fai clic su **modifica il tuo ID IBM**. -3. Modifica le tue informazioni utente. -4. Fai clic su **Salva**. - -## Impostazione della traccia di analisi -{: #tracking} - -Le azioni nell'interfaccia utente {{site.data.keyword.Bluemix_notm}} sono tracciate per impostazione predefinita. La traccia consente al team di {{site.data.keyword.Bluemix_notm}} di mettere a punto una migliore esperienza per te e di fornire un migliore supporto. I dati raccolti non vengono utilizzati o condivisi per altri scopi. - -Se scegli di disabilitare la traccia, potresti non essere in grado di utilizzare alcune funzioni in {{site.data.keyword.Bluemix_notm}}, come le comunicazioni via chat. - -Per disabilitare la traccia di analisi, completa la seguente procedura: - -1. Vai all'icona **{{site.data.keyword.avatar}}** ![icona Avatar](../icons/i-avatar-icon.svg) > **Profilo utente**. -2. Imposta la traccia di analisi su **disattivo**. +--- + + + +copyright: + + years: 2015, 2016 +lastupdated: "2016-10-20" + + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} + +# Impostazioni del profilo +{: #usersettings} + +Vai all'icona **{{site.data.keyword.avatar}}** ![icona Avatar](../icons/i-avatar-icon.svg) > **Profilo utente** per aggiornare le impostazioni del tuo profilo. +{:shortdesc} + + Nella pagina **Profilo**, puoi impostare o aggiornare le seguenti informazioni: + + * Una foto del profilo visibile agli altri utenti {{site.data.keyword.Bluemix_notm}} + * Informazioni dell'ID IBM, tra cui nome, e-mail, numero di telefono, password, azienda e ruolo. + * Impostazione della traccia di analisi + +## Modifica della tua foto del profilo +{: #photo} + +1. Vai all'icona **{{site.data.keyword.avatar}}** ![icona Avatar](../icons/i-avatar-icon.svg) > **Profilo utente**. + +* Fai clic su **CARICA UNA FOTO** per caricare una foto. +* Fai clic su **MODIFICA FOTO** per caricare una nuova foto. +* Fai clic su **Rimuovi foto** per rimuovere la tua foto. + +## Modifica delle informazioni del tuo ID IBM +{: #ibmid} + +Un ID IBM è un singolo ID che utilizzi per accedere al tuo account {{site.data.keyword.Bluemix_notm}} per le funzioni di infrastruttura, servizi e applicazione. Il tuo ID IBM è lo stesso ID che puoi utilizzare per accedere alle altre applicazioni IBM. + +L'ID IBM non può essere modificato, ma puoi modificare le tue informazioni di profilo ad esso associate. Se devi modificare le informazioni relative al tuo account dell'ID IBM, quali nome, e-mail, numero di telefono, password o nome dell'azienda, completa la seguente procedura: + +1. Vai all'icona **{{site.data.keyword.avatar}}** ![icona Avatar](../icons/i-avatar-icon.svg) > **Profilo utente**. +2. Fai clic su **modifica il tuo ID IBM**. +3. Modifica le tue informazioni utente. +4. Fai clic su **Salva**. + +## Impostazione della traccia di analisi +{: #tracking} + +Le azioni nell'interfaccia utente {{site.data.keyword.Bluemix_notm}} sono tracciate per impostazione predefinita. La traccia consente al team di {{site.data.keyword.Bluemix_notm}} di mettere a punto una migliore esperienza per te e di fornire un migliore supporto. I dati raccolti non vengono utilizzati o condivisi per altri scopi. + +Se scegli di disabilitare la traccia, potresti non essere in grado di utilizzare alcune funzioni in {{site.data.keyword.Bluemix_notm}}, come le comunicazioni via chat. + +Per disabilitare la traccia di analisi, completa la seguente procedura: + +1. Vai all'icona **{{site.data.keyword.avatar}}** ![icona Avatar](../icons/i-avatar-icon.svg) > **Profilo utente**. +2. Imposta la traccia di analisi su **disattivo**. diff --git a/admin/nl/it/softlayerlink.md b/admin/nl/it/softlayerlink.md index 566d7a9ea..bd311bc7e 100644 --- a/admin/nl/it/softlayerlink.md +++ b/admin/nl/it/softlayerlink.md @@ -1,245 +1,245 @@ ---- - - - -copyright: - - years: 2016, 2017 -lastupdated: "2017-01-11" - - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} - -# Aggiornamento e unificazione degli account di fatturazione {{site.data.keyword.Bluemix_notm}} e SoftLayer -{: #softlayerlink} - -Se disponi di un account {{site.data.keyword.Bluemix_notm}} di prova e vuoi accedere al dashboard Infrastruttura, devi eseguire l'aggiornamento a un account {{site.data.keyword.Bluemix_notm}} con pagamento a consumo. Devi inoltre eseguire l'aggiornamento se desideri utilizzare altre risorse a consumo che non sono disponibili in un account di prova o se il tuo account di prova è terminato. - -Puoi unificare i tuoi account {{site.data.keyword.Bluemix_notm}} e SoftLayer esistenti collegando tali account. Quando colleghi i tuoi account, ricevi la fattura attraverso {{site.data.keyword.Bluemix_notm}} sia per le risorse {{site.data.keyword.Bluemix_notm}} che per le risorse SoftLayer. - -**Attenzione:** un account di sottoscrizione {{site.data.keyword.Bluemix_notm}} non può essere collegato a un account SoftLayer. Per accedere al dashboard Infrastruttura, devi creare un account Pagamento a consumo, un secondo account che viene collegato automaticamente a un account SoftLayer. Riceverai quindi due fatture, una per ogni account {{site.data.keyword.Bluemix_notm}}. Anche se le risorse dell'infrastruttura verranno fatturate in un account Pagamento a consumo separato, le risorse possono essere utilizzate con applicazioni e servizi nel tuo account di sottoscrizione. Ad esempio, se attivi un servizio Watson nel tuo account di sottoscrizione, puoi copiare le credenziali del servizio e quindi aggiungerle alla tua applicazione bare metal proveniente dal tuo account Pagamento a consumo. -{:shortdesc} - -## Aggiornamento a un account Pagamento a consumo di {{site.data.keyword.Bluemix_notm}} -{: #upgradetopayg} - -Quando ti colleghi a {{site.data.keyword.Bluemix_notm}} utilizzando un account di prova, non puoi accedere al dashboard Infrastruttura {{site.data.keyword.Bluemix_notm}}. Se vuoi che le tue applicazioni utilizzino le risorse dell'infrastruttura, devi eseguire l'aggiornamento a un account Pagamento a consumo. - -Per aggiornare il tuo account di prova in un account Pagamento a consumo {{site.data.keyword.Bluemix_notm}}, completa la seguente procedura: - - 1. Fai clic su **Account** > **Fatturazione**. - 2. Seleziona **Aggiungi carta di credito**. - 3. Immetti i dettagli di fatturazione richiesti. - 4. Leggi e accetta i termini e le condizioni per l'account Pagamento a consumo. - 5. Al termine, fai clic su **Aggiorna**. - -Una volta eseguito l'aggiornamento a un account Pagamento a consumo, le opzioni di **Infrastruttura** vengono elencate nel **Catalogo** {{site.data.keyword.Bluemix_notm}}. Se superi la franchigia consentita, riceverai una fattura mensile da parte di {{site.data.keyword.Bluemix_notm}}. La fattura sarà in dollari americani (USD) e verranno descritti gli addebiti delle risorse. - -## Unificazione degli account {{site.data.keyword.Bluemix_notm}} e SoftLayer -{: #unifyingaccounts} - -Puoi unificare i tuoi account {{site.data.keyword.Bluemix_notm}} e SoftLayer per utilizzare risorse combinate. Quando colleghi gli account {{site.data.keyword.Bluemix_notm}} e Softlayer, riceverai un'unica fattura {{site.data.keyword.Bluemix_notm}}. Se hai un account {{site.data.keyword.Bluemix_notm}} esistente, la fatturazione tramite {{site.data.keyword.Bluemix_notm}} per le risorse SoftLayer parte dal nuovo ciclo di fatturazione che inizia dopo il collegamento degli account. - -**Importante:** tutti gli account collegati in {{site.data.keyword.Bluemix_notm}} devono essere del tipo Pagamento a consumo. Puoi creare un nuovo account Pagamento a consumo o collegarne uno esistente. In alternativa, puoi collegare un account di prova esistente, che verrà tuttavia aggiornato in un account Pagamento a consumo. Gli account Sottoscrizione di {{site.data.keyword.Bluemix_notm}} non possono essere collegati. - -Dopo che gli account sono stati collegati: - -* Devi utilizzare le credenziali dell'ID IBM per accedere a entrambi gli account SoftLayer e {{site.data.keyword.Bluemix_notm}}. -* Eventuali sconti SoftLayer esistenti vengono applicati agli addebiti {{site.data.keyword.Bluemix_notm}}. -* Riceverai un'unica fattura in dollari americani (USD). -* Puoi monitorare l'utilizzo delle tue risorse {{site.data.keyword.BluSoftlayer}} nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. - -**Attenzione:** una volta collegati, gli account non possono più essere scollegati. - -Se hai un account SoftLayer e desideri collegare gli account SoftLayer e {{site.data.keyword.Bluemix_notm}}, completa la seguente procedura: - - 1. Dal {{site.data.keyword.slportal}}, fai clic su **Collega un account {{site.data.keyword.Bluemix_notm}}**. - 2. Leggi e accetta le condizioni di collegamento degli account SoftLayer e {{site.data.keyword.Bluemix_notm}}. - 3. Quando richiesto, fornisci l'indirizzo e-mail associato al tuo account {{site.data.keyword.Bluemix_notm}}. Se non hai un account {{site.data.keyword.Bluemix_notm}}, fornisci l'indirizzo e-mail che desideri utilizzare, quindi segui le istruzioni per ricevere l'invito a {{site.data.keyword.Bluemix_notm}} e crea un account. - -Per collegare gli account, devi essere un utente master dell'account SoftLayer. - -Dopo aver collegato gli account, nell'intestazione generale di SoftLayer viene visualizzato il link **Vai a {{site.data.keyword.Bluemix_notm}}**. Facendo clic su questo link, arrivi alla pagina di accesso {{site.data.keyword.Bluemix_notm}}. Inoltre, il link **SoftLayer** è ora disponibile nell'intestazione di {{site.data.keyword.Bluemix_notm}}. Facendo clic sul collegamento, accedi attraverso una nuova finestra alla home page di {{site.data.keyword.slportal}}. - -Le offerte dell'infrastruttura {{site.data.keyword.Bluemix_notm}} sono collegate a una rete a tre livelli, segmentando il traffico pubblico, privato e di gestione. Le offerte dell'infrastruttura sull'account {{site.data.keyword.Bluemix_notm}} di un cliente potrebbe trasferire i dati da uno all'altro attraverso la rete privata a costo zero. Le offerte dell'infrastruttura, quali i server bare metal, i server virtuali e l'archiviazione cloud, si collegano ad altre applicazioni e altri servizi nel catalogo {{site.data.keyword.Bluemix_notm}}, ad esempio i servizi Watson, contenitori o runtime, attraverso al rete pubblica. Il trasferimento dati tra questi due tipi di offerte viene misurato e addebitato a tariffe di larghezza di banda della rete pubblica standard. - -## Come invitare membri del team SoftLayer in {{site.data.keyword.Bluemix_notm}} -{: #invite_users} - -Quando colleghi gli account {{site.data.keyword.Bluemix_notm}} e SoftLayer, puoi invitare i membri del tuo team SoftLayer a unirsi a {{site.data.keyword.Bluemix_notm}}. In alternativa, puoi invitare successivamente i membri del team SoftLayer dall'interfaccia utente {{site.data.keyword.Bluemix_notm}}. -{:shortdesc} - -Dall'interfaccia utente {{site.data.keyword.Bluemix_notm}} puoi scegliere di invitare tutti i membri del tuo account SoftLayer oppure puoi selezionare singoli membri. Quando inviti membri del team, devi impostare il ruolo account {{site.data.keyword.Bluemix_notm}} ruolo per gli invitati. Per ulteriori informazioni sui differenti ruoli in {{site.data.keyword.Bluemix_notm}}, vedi [Ruoli utente](https://console.ng.bluemix.net/docs/admin/users_roles.html#userrolesinfo). - -Per invitare membri del team a unirsi all'account {{site.data.keyword.Bluemix_notm}}, devi essere un utente master dell'account SoftLayer. - -Per invitare membri del team tramite {{site.data.keyword.Bluemix_notm}}, completa la seguente procedura: - - 1. Fai clic su **Account** > **Invita membri del team**. - 2. Fai clic su **Aggiungi** per eseguire l'autenticazione nel tuo account SoftLayer e visualizzare un elenco di membri del team dal tuo account {{site.data.keyword.BluSoftlayer}}. - 3. Seleziona i membri del team da invitare e fai clic su **Invia**. - -Il membro del team riceve un'e-mail che include un link **Unisciti all'organizzazione**. Se il membro del team non dispone di un ID IBM, viene reindirizzato a una pagina di registrazione. Successivamente, il membro del team può immettere alcune informazioni di base e creare il proprio account {{site.data.keyword.Bluemix_notm}}. - -Per ulteriori informazioni su come invitare i membri del team attraverso l'interfaccia utente {{site.data.keyword.Bluemix_notm}}, vedi [Come invitare membri del team](https://console.ng.bluemix.net/docs/admin/users_roles.html#inviteteammembers). - -## Passaggio all'ID IBM -{: #ibmid_switch} - -L'autenticazione in SoftLayer utilizza adesso un ID IBM per fornire un singolo accesso per tutti i {{site.data.keyword.Bluemix_notm}}. Gli account SoftLayer esistenti verranno abilitati a passare all'autenticazione tramite ID IBM. Una procedura guidata di migrazione ti guiderà in questo passaggio. -{:shortdesc} - -Se sei un utente master o non visualizzi un prompt per passare a un ID IBM nel {{site.data.keyword.slportal}}, [Contatta il supporto IBM](/docs/support/index.html#contacting-support) per assistenza su come abilitare questa funzione. - -Quando inizi a passare a un ID IBM, puoi sempre annullare il passaggio prima di completare il processo. Tuttavia, ogni volta che accedi verrà visualizzato il prompt per passare a un ID IBM. Ogni account SoftLayer che prevedi di collegare a un account {{site.data.keyword.Bluemix_notm}} deve appartenere a un unico ID IBM con un indirizzo e-mail univoco. - -Per passare dal tuo nome utente SoftLayer esistente a un ID IBM, completa la seguente procedura: - - 1. Accedi al tuo account SoftLayer. Quando viene visualizzato il prompt per passare a un ID IBM, fai clic su **OK**. - - Se hai già eseguito l'accesso (e hai fatto clic su **Dopo** nel prompt per passare a un ID IBM), ma vuoi passare all'autenticazione con ID IBM nella sessione corrente, vai alla pagina Modifica profilo utente e fai clic su **Passa a ID IBM**. - - 2. Segui le istruzioni della procedura guidata per creare il tuo ID IBM. - - Per creare un nuovo ID IBM, immetti un indirizzo e-mail che non sia attualmente utilizzato da nessun ID IBM. Il nuovo ID IBM utilizzerà tale indirizzo come nome utente e indirizzo e-mail. Una volta che l'ID IBM è stato creato, puoi aggiornare l'indirizzo e-mail associato all'ID IBM, ma non puoi modificare il nome utente. L'e-mail di invito verrà indirizzata all'indirizzo fornito. - - Dopo aver completato la procedura guidata, riceverai un'e-mail con il tuo codice di registrazione. - - 3. Quando ricevi l'e-mail, segui il link o copia l'URL in un browser e immetti quindi il codice di registrazione. Il codice è valido per 7 giorni e puoi utilizzarlo solo una volta. - - Dopo il passaggio all'autenticazione tramite ID IBM, puoi accedere al tuo account solo con il tuo ID IBM. Al prompt di accesso dell'account, vai alla sezione **Accesso account ID IBM** e fai clic su **Accedi con ID IBM**. Non utilizzare i campi **Nome utente** e **Password** che utilizzavi in precedenza con il tuo ID SoftLayer. - -Se sei un nuovo cliente, quando controlli il tuo ordine ti verrà chiesto il tuo ID IBM esistente o di crearne uno nuovo. - - * Per utilizzare un ID IBM esistente, immetti il nome utente o l'indirizzo e-mail dell'ID IBM se è univoco (vale a dire, che non sia condiviso tra più ID IBM). - - * Per creare un nuovo ID IBM, immetti un indirizzo e-mail che non sia attualmente utilizzato da nessun ID IBM. Il nuovo ID IBM utilizzerà tale indirizzo come nome utente e indirizzo e-mail. Una volta che l'ID IBM è stato creato, puoi aggiornare l'indirizzo e-mail associato all'ID IBM, ma non puoi modificare il nome utente. L'e-mail di invito verrà indirizzata all'indirizzo fornito. - -Per risolvere eventuali problemi di accesso con il tuo ID IBM, vedi [Risoluzione dei problemi di accesso a Bluemix](/docs/troubleshoot/ts_accessing.html#accessing). - - -### Abilitazione degli utenti al passaggio all'ID IBM -{: #link_accounts_resellers} - -In alcuni casi, prima che un utente possa passare a un ID IBM, un rivenditore o un distributore deve abilitare l'account ad utilizzare l'autenticazione tramite ID IBM. - - * Per abilitare un account esistente con le credenziali legacy SoftLayer per utilizzare l'autenticazione ID IBM, [Contattare il supporto IBM](https://console.ng.bluemix.net/docs/support/index.html#contacting-support) per abilitare la migrazione all'ID IBM. Questa procedura deve essere abilitata per ogni account utente finale esistente che desideri collegare a un account {{site.data.keyword.Bluemix_notm}}. - - * Per assicurarti che i nuovi account utente sono stati creati con un ID IBM, l'attributo `CREATE_NEW_ACCOUNT_WITH_IBMid_AUTHENTICATION` deve essere impostato nell'account utente master immediato. [Contatta il supporto IBM](https://console.ng.bluemix.net/docs/support/index.html#contacting-support) o il tuo fornitore per avere questa impostazione configurata per i tuoi account. - -### Collegamento dei tuoi account utente -{: #link_user_accounts} -Dopo che i tuoi utenti sono passati all'autenticazione tramite ID IBM, i rivenditori e i distributori possono collegare gli account SoftLayer e {{site.data.keyword.Bluemix_notm}}. - -**Nota:** - * L'utente master dell'account che sta venendo collegato deve essere un ID IBM. - * Accedi ad ogni account utente finale come utente master. Vai alla pagina del profilo e fai clic su **Passa a ID IBM**. - * Ogni account che colleghi all'account {{site.data.keyword.Bluemix_notm}} deve essere gestito da un solo ID IBM univoco con un indirizzo email univoco. Anche se un ID IBM può visualizzare più account SoftLayer, non puoi collegarli agli account {{site.data.keyword.Bluemix_notm}}. Se un ID IBM è l'utente master per più account SoftLayer e desideri collegarli agli account {{site.data.keyword.Bluemix_notm}}, devi modificare gli utenti master in modo che siano un ID IBM univoco per ogni account. Contatta il [Supporto IBM SoftLayer ![icona link esterno](../icons/launch-glyph.svg)](https://knowledgelayer.softlayer.com/topic/support){: new_window} per modificare l'utente master per un account SoftLayer. - -Completa la seguente procedura per collegare tutti gli account all'account {{site.data.keyword.Bluemix_notm}}: - - 1. Per creare un nuovo account {{site.data.keyword.Bluemix_notm}} o per il collegamento a un account {{site.data.keyword.Bluemix_notm}} esistente, accedi al tuo account SoftLayer come utente master e fai clic sul link **{{site.data.keyword.Bluemix_notm}}**. Questo ti darà la possibilità di creare un nuovo account {{site.data.keyword.Bluemix_notm}} o di collegare un account {{site.data.keyword.Bluemix_notm}} esistente. L'ID IBM che è l'utente master per l'account SoftLayer deve essere il proprietario dell'account Bluemix a cui stati eseguendo il collegamento. Segui le istruzioni nella procedura guidata, inclusa l'aggiunta di utenti nell'account SoftLayer all'account {{site.data.keyword.Bluemix_notm}}. - 2. Dopo aver collegato l'account, informa gli utenti finali dell'account di migrare all'ID IBM. Gli utenti finali possono quindi accedere ai dashboard Infrastruttura, Applicazioni e Servizi nella console {{site.data.keyword.Bluemix_notm}}. - 3. Quando vengono aggiunti nuovi utenti all'account collegato, dovrai aggiungerli all'account SoftLayer e {{site.data.keyword.Bluemix_notm}} in modo da fornirgli l'accesso a tutte le funzionalità nella console unificata. - -**Raccomandazione:** migra solo gli account utente finale all'ID IBM. Non migrare gli account dell'azienda che sono account principali per gli account utente finale e non contengono alcuna risorsa. Gli utenti degli account dell'azienda che eseguono la migrazione all'ID IBM perdono la possibilità di accedere al portale BAP (Brand Agent Portal). - - - - -## Utilizzo di servizi {{site.data.keyword.Bluemix_notm}} con risorse SoftLayer -{: #bluemix_services} - -Puoi utilizzare facilmente servizi {{site.data.keyword.Bluemix_notm}} pubblici basati sull'API insieme alle tue risorse SoftLayer. Tutte le API sono sicure e codificate, cosicché i dati siano protetti. -{:shortdesc} - -Ad esempio, hai mai desiderato di aggiungere da SoftLayer capacità cognitive Watson alle tue applicazioni eseguite su server bare metal? Puoi aggiungere un servizio quale {{site.data.keyword.personalityinsightsshort}} per aiutare l'utente delle tue applicazioni in quattro semplici passi: - -1. Cerca il servizio nel catalogo {{site.data.keyword.Bluemix_notm}}. -2. Fornisci un'istanza del servizio con pochi clic. -3. Imposta il servizio da eseguire con il codice esistente copiandone le credenziali e aggiungendole alla tua applicazione. -4. Effettuato l'aggiornamento nell'applicazione, distribuisci la nuova versione sulla tua infrastruttura SoftLayer. - -Puoi ottenere una conoscenza di *Insights and Cognitive* richiamando le API Watson dalle tue applicazioni in SoftLayer per personalizzarle maggiormente. In alternativa, utilizza i servizi *Data and Analytics* per accedere a un'analisi ad alte prestazioni per le tue applicazioni. In alternativa, selezionare un database-as-a-service in cui tu possa lasciare la gestione a {{site.data.keyword.Bluemix_notm}}. - -Rinnova lo sviluppo delle tue applicazioni attraverso contenitori con servizi quali {{site.data.keyword.activedeployshort}} e {{site.data.keyword.deliverypipeline}}. Puoi quindi utilizzare il servizio {{site.data.keyword.vpn_short}} per comunicare con SoftLayer per connettere il tuo contenitore appartenente a una rete privata alla rete privata SoftLayer. Tutti gli addebiti di utilizzo dei servizi e delle risorse di calcolo sono riportati nella fattura {{site.data.keyword.Bluemix_notm}}. - -### Servizi {{site.data.keyword.Bluemix_notm}} basati sull'API -Non tutti i servizi {{site.data.keyword.Bluemix_notm}} possono essere utilizzati con SoftLayer. I seguenti servizi possono essere impostati in modo da essere eseguiti con il codice della tua applicazione: -* {{site.data.keyword.alchemyapishort}} -* {{site.data.keyword.alertnotificationshort}} -* {{site.data.keyword.sparks}} -* {{site.data.keyword.appseccloudshort}} -* {{site.data.keyword.blockchain}} -* {{site.data.keyword.cloudant}} -* {{site.data.keyword.conceptinsightsshort}} -* {{site.data.keyword.iotmapinsights_short}} -* {{site.data.keyword.dashdbshort}} -* {{site.data.keyword.dialogshort}} -* {{site.data.keyword.documentconversionshort}} -* {{site.data.keyword.twittershort}} -* {{site.data.keyword.weather_short}} -* {{site.data.keyword.iotdriverinsights_short}} -* {{site.data.keyword.geospatialshort_Geospatial}} -* {{site.data.keyword.graphshort}} -* {{site.data.keyword.iotelectronics}} -* {{site.data.keyword.languagetranslationshort}} -* {{site.data.keyword.messagehub}} -* {{site.data.keyword.mqa}} -* {{site.data.keyword.mobileappbuilder_short}} -* {{site.data.keyword.mql}} -* {{site.data.keyword.nlclassifiershort}} -* {{site.data.keyword.objectstorageshort}} -* {{site.data.keyword.personalityinsightsshort}} -* {{site.data.keyword.presenceinsightsshort}} -* {{site.data.keyword.relationshipextractionshort}} -* {{site.data.keyword.retrieveandrankshort}} -* {{site.data.keyword.speechtotextshort}} -* {{site.data.keyword.sqldb}} -* {{site.data.keyword.streaminganalyticsshort}} -* {{site.data.keyword.texttospeechshort}} -* {{site.data.keyword.toneanalyzershort}} -* {{site.data.keyword.tradeoffanalyticsshort}} -* {{site.data.keyword.visualinsightsshort}} -* {{site.data.keyword.visualrecognitionshort}} -* {{site.data.keyword.workflow}} -* {{site.data.keyword.workloadscheduler}} - -**Nota:** non tutti i piani di questi servizi sono disponibili. Solo i piani abilitati per gli account Pagamento a consumo possono essere utilizzati con gli account collegati. Tuttavia, se disponi di un account {{site.data.keyword.Bluemix_notm}} distinto, fatturato separatamente, puoi utilizzare qualsiasi piano di uno qualsiasi di questi servizi. - -## Fatturazione per l'utilizzo di {{site.data.keyword.Bluemix_notm}} con gli account collegati -{: #bill_usage} - -Una volta collegati i tuoi account di fatturazione {{site.data.keyword.Bluemix_notm}} e SoftLayer, il successivo ciclo di fatturazione verrà addebitato in un'unica fattura {{site.data.keyword.Bluemix_notm}}. -{:shortdesc} - -Il tuo ciclo di utilizzo di {{site.data.keyword.Bluemix_notm}} si basa sul mese di calendario, perciò l'addebito per il tuo account viene effettuato con cadenza mensile il giorno di fatturazione stabilito nel tuo accordo di addebito. Con SoftLayer, il ciclo di utilizzo inizia nel momento in cui viene avviato e viene pertanto addebitato con cadenza mensile lo stesso giorno del mese in cui hai sottoscritto l'account SoftLayer. - -Quando gli account sono collegati, l'utilizzo di {{site.data.keyword.Bluemix_notm}} continua a essere misurato per il ciclo del mese corrente e viene fatturato con una fattura {{site.data.keyword.Bluemix_notm}}. Dal primo giorno del mese successivo, gli addebiti {{site.data.keyword.Bluemix_notm}} e SoftLayer verranno combinati nella tua fattura {{site.data.keyword.Bluemix_notm}}. - -Ad esempio, se hai collegato gli account il 16 aprile, riceverai una fattura Bluemix per l'utilizzo di aprile. A seconda di quando hai collegato i tuoi account, potresti ricevere una fattura separata per l'utilizzo di SoftLayer. L'utilizzo di maggio per SoftLayer e {{site.data.keyword.Bluemix_notm}} verrà fatturato tramite l'account {{site.data.keyword.Bluemix_notm}}. - -![Collegamento del riepilogo degli account Bluemix e SoftLayer](images/BluemixSoftLayerBill.svg) - -Una volta collegate le fatture, la tua fattura {{site.data.keyword.Bluemix_notm}} elencherà i diversi addebiti per ogni risorsa utilizzata nelle seguenti intestazioni: - -* **Server Bare Metal e servizi collegati** -* **Server virtuali e servizi collegati** -* **Servizi non collegati** - -Per informazioni sulla visualizzazione dell'utilizzo di {{site.data.keyword.Bluemix_notm}}, vedi [Visualizzazione dei dettagli di utilizzo](https://console.ng.bluemix.net/docs/pricing/index.html#usage). - +--- + + + +copyright: + + years: 2016, 2017 +lastupdated: "2017-01-11" + + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} + +# Aggiornamento e unificazione degli account di fatturazione {{site.data.keyword.Bluemix_notm}} e SoftLayer +{: #softlayerlink} + +Se disponi di un account {{site.data.keyword.Bluemix_notm}} di prova e vuoi accedere al dashboard Infrastruttura, devi eseguire l'aggiornamento a un account {{site.data.keyword.Bluemix_notm}} con pagamento a consumo. Devi inoltre eseguire l'aggiornamento se desideri utilizzare altre risorse a consumo che non sono disponibili in un account di prova o se il tuo account di prova è terminato. + +Puoi unificare i tuoi account {{site.data.keyword.Bluemix_notm}} e SoftLayer esistenti collegando tali account. Quando colleghi i tuoi account, ricevi la fattura attraverso {{site.data.keyword.Bluemix_notm}} sia per le risorse {{site.data.keyword.Bluemix_notm}} che per le risorse SoftLayer. + +**Attenzione:** un account di sottoscrizione {{site.data.keyword.Bluemix_notm}} non può essere collegato a un account SoftLayer. Per accedere al dashboard Infrastruttura, devi creare un account Pagamento a consumo, un secondo account che viene collegato automaticamente a un account SoftLayer. Riceverai quindi due fatture, una per ogni account {{site.data.keyword.Bluemix_notm}}. Anche se le risorse dell'infrastruttura verranno fatturate in un account Pagamento a consumo separato, le risorse possono essere utilizzate con applicazioni e servizi nel tuo account di sottoscrizione. Ad esempio, se attivi un servizio Watson nel tuo account di sottoscrizione, puoi copiare le credenziali del servizio e quindi aggiungerle alla tua applicazione bare metal proveniente dal tuo account Pagamento a consumo. +{:shortdesc} + +## Aggiornamento a un account Pagamento a consumo di {{site.data.keyword.Bluemix_notm}} +{: #upgradetopayg} + +Quando ti colleghi a {{site.data.keyword.Bluemix_notm}} utilizzando un account di prova, non puoi accedere al dashboard Infrastruttura {{site.data.keyword.Bluemix_notm}}. Se vuoi che le tue applicazioni utilizzino le risorse dell'infrastruttura, devi eseguire l'aggiornamento a un account Pagamento a consumo. + +Per aggiornare il tuo account di prova in un account Pagamento a consumo {{site.data.keyword.Bluemix_notm}}, completa la seguente procedura: + + 1. Fai clic su **Account** > **Fatturazione**. + 2. Seleziona **Aggiungi carta di credito**. + 3. Immetti i dettagli di fatturazione richiesti. + 4. Leggi e accetta i termini e le condizioni per l'account Pagamento a consumo. + 5. Al termine, fai clic su **Aggiorna**. + +Una volta eseguito l'aggiornamento a un account Pagamento a consumo, le opzioni di **Infrastruttura** vengono elencate nel **Catalogo** {{site.data.keyword.Bluemix_notm}}. Se superi la franchigia consentita, riceverai una fattura mensile da parte di {{site.data.keyword.Bluemix_notm}}. La fattura sarà in dollari americani (USD) e verranno descritti gli addebiti delle risorse. + +## Unificazione degli account {{site.data.keyword.Bluemix_notm}} e SoftLayer +{: #unifyingaccounts} + +Puoi unificare i tuoi account {{site.data.keyword.Bluemix_notm}} e SoftLayer per utilizzare risorse combinate. Quando colleghi gli account {{site.data.keyword.Bluemix_notm}} e Softlayer, riceverai un'unica fattura {{site.data.keyword.Bluemix_notm}}. Se hai un account {{site.data.keyword.Bluemix_notm}} esistente, la fatturazione tramite {{site.data.keyword.Bluemix_notm}} per le risorse SoftLayer parte dal nuovo ciclo di fatturazione che inizia dopo il collegamento degli account. + +**Importante:** tutti gli account collegati in {{site.data.keyword.Bluemix_notm}} devono essere del tipo Pagamento a consumo. Puoi creare un nuovo account Pagamento a consumo o collegarne uno esistente. In alternativa, puoi collegare un account di prova esistente, che verrà tuttavia aggiornato in un account Pagamento a consumo. Gli account Sottoscrizione di {{site.data.keyword.Bluemix_notm}} non possono essere collegati. + +Dopo che gli account sono stati collegati: + +* Devi utilizzare le credenziali dell'ID IBM per accedere a entrambi gli account SoftLayer e {{site.data.keyword.Bluemix_notm}}. +* Eventuali sconti SoftLayer esistenti vengono applicati agli addebiti {{site.data.keyword.Bluemix_notm}}. +* Riceverai un'unica fattura in dollari americani (USD). +* Puoi monitorare l'utilizzo delle tue risorse {{site.data.keyword.BluSoftlayer}} nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. + +**Attenzione:** una volta collegati, gli account non possono più essere scollegati. + +Se hai un account SoftLayer e desideri collegare gli account SoftLayer e {{site.data.keyword.Bluemix_notm}}, completa la seguente procedura: + + 1. Dal {{site.data.keyword.slportal}}, fai clic su **Collega un account {{site.data.keyword.Bluemix_notm}}**. + 2. Leggi e accetta le condizioni di collegamento degli account SoftLayer e {{site.data.keyword.Bluemix_notm}}. + 3. Quando richiesto, fornisci l'indirizzo e-mail associato al tuo account {{site.data.keyword.Bluemix_notm}}. Se non hai un account {{site.data.keyword.Bluemix_notm}}, fornisci l'indirizzo e-mail che desideri utilizzare, quindi segui le istruzioni per ricevere l'invito a {{site.data.keyword.Bluemix_notm}} e crea un account. + +Per collegare gli account, devi essere un utente master dell'account SoftLayer. + +Dopo aver collegato gli account, nell'intestazione generale di SoftLayer viene visualizzato il link **Vai a {{site.data.keyword.Bluemix_notm}}**. Facendo clic su questo link, arrivi alla pagina di accesso {{site.data.keyword.Bluemix_notm}}. Inoltre, il link **SoftLayer** è ora disponibile nell'intestazione di {{site.data.keyword.Bluemix_notm}}. Facendo clic sul collegamento, accedi attraverso una nuova finestra alla home page di {{site.data.keyword.slportal}}. + +Le offerte dell'infrastruttura {{site.data.keyword.Bluemix_notm}} sono collegate a una rete a tre livelli, segmentando il traffico pubblico, privato e di gestione. Le offerte dell'infrastruttura sull'account {{site.data.keyword.Bluemix_notm}} di un cliente potrebbe trasferire i dati da uno all'altro attraverso la rete privata a costo zero. Le offerte dell'infrastruttura, quali i server bare metal, i server virtuali e l'archiviazione cloud, si collegano ad altre applicazioni e altri servizi nel catalogo {{site.data.keyword.Bluemix_notm}}, ad esempio i servizi Watson, contenitori o runtime, attraverso al rete pubblica. Il trasferimento dati tra questi due tipi di offerte viene misurato e addebitato a tariffe di larghezza di banda della rete pubblica standard. + +## Come invitare membri del team SoftLayer in {{site.data.keyword.Bluemix_notm}} +{: #invite_users} + +Quando colleghi gli account {{site.data.keyword.Bluemix_notm}} e SoftLayer, puoi invitare i membri del tuo team SoftLayer a unirsi a {{site.data.keyword.Bluemix_notm}}. In alternativa, puoi invitare successivamente i membri del team SoftLayer dall'interfaccia utente {{site.data.keyword.Bluemix_notm}}. +{:shortdesc} + +Dall'interfaccia utente {{site.data.keyword.Bluemix_notm}} puoi scegliere di invitare tutti i membri del tuo account SoftLayer oppure puoi selezionare singoli membri. Quando inviti membri del team, devi impostare il ruolo account {{site.data.keyword.Bluemix_notm}} ruolo per gli invitati. Per ulteriori informazioni sui differenti ruoli in {{site.data.keyword.Bluemix_notm}}, vedi [Ruoli utente](https://console.ng.bluemix.net/docs/admin/users_roles.html#userrolesinfo). + +Per invitare membri del team a unirsi all'account {{site.data.keyword.Bluemix_notm}}, devi essere un utente master dell'account SoftLayer. + +Per invitare membri del team tramite {{site.data.keyword.Bluemix_notm}}, completa la seguente procedura: + + 1. Fai clic su **Account** > **Invita membri del team**. + 2. Fai clic su **Aggiungi** per eseguire l'autenticazione nel tuo account SoftLayer e visualizzare un elenco di membri del team dal tuo account {{site.data.keyword.BluSoftlayer}}. + 3. Seleziona i membri del team da invitare e fai clic su **Invia**. + +Il membro del team riceve un'e-mail che include un link **Unisciti all'organizzazione**. Se il membro del team non dispone di un ID IBM, viene reindirizzato a una pagina di registrazione. Successivamente, il membro del team può immettere alcune informazioni di base e creare il proprio account {{site.data.keyword.Bluemix_notm}}. + +Per ulteriori informazioni su come invitare i membri del team attraverso l'interfaccia utente {{site.data.keyword.Bluemix_notm}}, vedi [Come invitare membri del team](https://console.ng.bluemix.net/docs/admin/users_roles.html#inviteteammembers). + +## Passaggio all'ID IBM +{: #ibmid_switch} + +L'autenticazione in SoftLayer utilizza adesso un ID IBM per fornire un singolo accesso per tutti i {{site.data.keyword.Bluemix_notm}}. Gli account SoftLayer esistenti verranno abilitati a passare all'autenticazione tramite ID IBM. Una procedura guidata di migrazione ti guiderà in questo passaggio. +{:shortdesc} + +Se sei un utente master o non visualizzi un prompt per passare a un ID IBM nel {{site.data.keyword.slportal}}, [Contatta il supporto IBM](/docs/support/index.html#contacting-support) per assistenza su come abilitare questa funzione. + +Quando inizi a passare a un ID IBM, puoi sempre annullare il passaggio prima di completare il processo. Tuttavia, ogni volta che accedi verrà visualizzato il prompt per passare a un ID IBM. Ogni account SoftLayer che prevedi di collegare a un account {{site.data.keyword.Bluemix_notm}} deve appartenere a un unico ID IBM con un indirizzo e-mail univoco. + +Per passare dal tuo nome utente SoftLayer esistente a un ID IBM, completa la seguente procedura: + + 1. Accedi al tuo account SoftLayer. Quando viene visualizzato il prompt per passare a un ID IBM, fai clic su **OK**. + + Se hai già eseguito l'accesso (e hai fatto clic su **Dopo** nel prompt per passare a un ID IBM), ma vuoi passare all'autenticazione con ID IBM nella sessione corrente, vai alla pagina Modifica profilo utente e fai clic su **Passa a ID IBM**. + + 2. Segui le istruzioni della procedura guidata per creare il tuo ID IBM. + + Per creare un nuovo ID IBM, immetti un indirizzo e-mail che non sia attualmente utilizzato da nessun ID IBM. Il nuovo ID IBM utilizzerà tale indirizzo come nome utente e indirizzo e-mail. Una volta che l'ID IBM è stato creato, puoi aggiornare l'indirizzo e-mail associato all'ID IBM, ma non puoi modificare il nome utente. L'e-mail di invito verrà indirizzata all'indirizzo fornito. + + Dopo aver completato la procedura guidata, riceverai un'e-mail con il tuo codice di registrazione. + + 3. Quando ricevi l'e-mail, segui il link o copia l'URL in un browser e immetti quindi il codice di registrazione. Il codice è valido per 7 giorni e puoi utilizzarlo solo una volta. + + Dopo il passaggio all'autenticazione tramite ID IBM, puoi accedere al tuo account solo con il tuo ID IBM. Al prompt di accesso dell'account, vai alla sezione **Accesso account ID IBM** e fai clic su **Accedi con ID IBM**. Non utilizzare i campi **Nome utente** e **Password** che utilizzavi in precedenza con il tuo ID SoftLayer. + +Se sei un nuovo cliente, quando controlli il tuo ordine ti verrà chiesto il tuo ID IBM esistente o di crearne uno nuovo. + + * Per utilizzare un ID IBM esistente, immetti il nome utente o l'indirizzo e-mail dell'ID IBM se è univoco (vale a dire, che non sia condiviso tra più ID IBM). + + * Per creare un nuovo ID IBM, immetti un indirizzo e-mail che non sia attualmente utilizzato da nessun ID IBM. Il nuovo ID IBM utilizzerà tale indirizzo come nome utente e indirizzo e-mail. Una volta che l'ID IBM è stato creato, puoi aggiornare l'indirizzo e-mail associato all'ID IBM, ma non puoi modificare il nome utente. L'e-mail di invito verrà indirizzata all'indirizzo fornito. + +Per risolvere eventuali problemi di accesso con il tuo ID IBM, vedi [Risoluzione dei problemi di accesso a Bluemix](/docs/troubleshoot/ts_accessing.html#accessing). + + +### Abilitazione degli utenti al passaggio all'ID IBM +{: #link_accounts_resellers} + +In alcuni casi, prima che un utente possa passare a un ID IBM, un rivenditore o un distributore deve abilitare l'account ad utilizzare l'autenticazione tramite ID IBM. + + * Per abilitare un account esistente con le credenziali legacy SoftLayer per utilizzare l'autenticazione ID IBM, [Contattare il supporto IBM](https://console.ng.bluemix.net/docs/support/index.html#contacting-support) per abilitare la migrazione all'ID IBM. Questa procedura deve essere abilitata per ogni account utente finale esistente che desideri collegare a un account {{site.data.keyword.Bluemix_notm}}. + + * Per assicurarti che i nuovi account utente sono stati creati con un ID IBM, l'attributo `CREATE_NEW_ACCOUNT_WITH_IBMid_AUTHENTICATION` deve essere impostato nell'account utente master immediato. [Contatta il supporto IBM](https://console.ng.bluemix.net/docs/support/index.html#contacting-support) o il tuo fornitore per avere questa impostazione configurata per i tuoi account. + +### Collegamento dei tuoi account utente +{: #link_user_accounts} +Dopo che i tuoi utenti sono passati all'autenticazione tramite ID IBM, i rivenditori e i distributori possono collegare gli account SoftLayer e {{site.data.keyword.Bluemix_notm}}. + +**Nota:** + * L'utente master dell'account che sta venendo collegato deve essere un ID IBM. + * Accedi ad ogni account utente finale come utente master. Vai alla pagina del profilo e fai clic su **Passa a ID IBM**. + * Ogni account che colleghi all'account {{site.data.keyword.Bluemix_notm}} deve essere gestito da un solo ID IBM univoco con un indirizzo email univoco. Anche se un ID IBM può visualizzare più account SoftLayer, non puoi collegarli agli account {{site.data.keyword.Bluemix_notm}}. Se un ID IBM è l'utente master per più account SoftLayer e desideri collegarli agli account {{site.data.keyword.Bluemix_notm}}, devi modificare gli utenti master in modo che siano un ID IBM univoco per ogni account. Contatta il [Supporto IBM SoftLayer ![icona link esterno](../icons/launch-glyph.svg)](https://knowledgelayer.softlayer.com/topic/support){: new_window} per modificare l'utente master per un account SoftLayer. + +Completa la seguente procedura per collegare tutti gli account all'account {{site.data.keyword.Bluemix_notm}}: + + 1. Per creare un nuovo account {{site.data.keyword.Bluemix_notm}} o per il collegamento a un account {{site.data.keyword.Bluemix_notm}} esistente, accedi al tuo account SoftLayer come utente master e fai clic sul link **{{site.data.keyword.Bluemix_notm}}**. Questo ti darà la possibilità di creare un nuovo account {{site.data.keyword.Bluemix_notm}} o di collegare un account {{site.data.keyword.Bluemix_notm}} esistente. L'ID IBM che è l'utente master per l'account SoftLayer deve essere il proprietario dell'account Bluemix a cui stati eseguendo il collegamento. Segui le istruzioni nella procedura guidata, inclusa l'aggiunta di utenti nell'account SoftLayer all'account {{site.data.keyword.Bluemix_notm}}. + 2. Dopo aver collegato l'account, informa gli utenti finali dell'account di migrare all'ID IBM. Gli utenti finali possono quindi accedere ai dashboard Infrastruttura, Applicazioni e Servizi nella console {{site.data.keyword.Bluemix_notm}}. + 3. Quando vengono aggiunti nuovi utenti all'account collegato, dovrai aggiungerli all'account SoftLayer e {{site.data.keyword.Bluemix_notm}} in modo da fornirgli l'accesso a tutte le funzionalità nella console unificata. + +**Raccomandazione:** migra solo gli account utente finale all'ID IBM. Non migrare gli account dell'azienda che sono account principali per gli account utente finale e non contengono alcuna risorsa. Gli utenti degli account dell'azienda che eseguono la migrazione all'ID IBM perdono la possibilità di accedere al portale BAP (Brand Agent Portal). + + + + +## Utilizzo di servizi {{site.data.keyword.Bluemix_notm}} con risorse SoftLayer +{: #bluemix_services} + +Puoi utilizzare facilmente servizi {{site.data.keyword.Bluemix_notm}} pubblici basati sull'API insieme alle tue risorse SoftLayer. Tutte le API sono sicure e codificate, cosicché i dati siano protetti. +{:shortdesc} + +Ad esempio, hai mai desiderato di aggiungere da SoftLayer capacità cognitive Watson alle tue applicazioni eseguite su server bare metal? Puoi aggiungere un servizio quale {{site.data.keyword.personalityinsightsshort}} per aiutare l'utente delle tue applicazioni in quattro semplici passi: + +1. Cerca il servizio nel catalogo {{site.data.keyword.Bluemix_notm}}. +2. Fornisci un'istanza del servizio con pochi clic. +3. Imposta il servizio da eseguire con il codice esistente copiandone le credenziali e aggiungendole alla tua applicazione. +4. Effettuato l'aggiornamento nell'applicazione, distribuisci la nuova versione sulla tua infrastruttura SoftLayer. + +Puoi ottenere una conoscenza di *Insights and Cognitive* richiamando le API Watson dalle tue applicazioni in SoftLayer per personalizzarle maggiormente. In alternativa, utilizza i servizi *Data and Analytics* per accedere a un'analisi ad alte prestazioni per le tue applicazioni. In alternativa, selezionare un database-as-a-service in cui tu possa lasciare la gestione a {{site.data.keyword.Bluemix_notm}}. + +Rinnova lo sviluppo delle tue applicazioni attraverso contenitori con servizi quali {{site.data.keyword.activedeployshort}} e {{site.data.keyword.deliverypipeline}}. Puoi quindi utilizzare il servizio {{site.data.keyword.vpn_short}} per comunicare con SoftLayer per connettere il tuo contenitore appartenente a una rete privata alla rete privata SoftLayer. Tutti gli addebiti di utilizzo dei servizi e delle risorse di calcolo sono riportati nella fattura {{site.data.keyword.Bluemix_notm}}. + +### Servizi {{site.data.keyword.Bluemix_notm}} basati sull'API +Non tutti i servizi {{site.data.keyword.Bluemix_notm}} possono essere utilizzati con SoftLayer. I seguenti servizi possono essere impostati in modo da essere eseguiti con il codice della tua applicazione: +* {{site.data.keyword.alchemyapishort}} +* {{site.data.keyword.alertnotificationshort}} +* {{site.data.keyword.sparks}} +* {{site.data.keyword.appseccloudshort}} +* {{site.data.keyword.blockchain}} +* {{site.data.keyword.cloudant}} +* {{site.data.keyword.conceptinsightsshort}} +* {{site.data.keyword.iotmapinsights_short}} +* {{site.data.keyword.dashdbshort}} +* {{site.data.keyword.dialogshort}} +* {{site.data.keyword.documentconversionshort}} +* {{site.data.keyword.twittershort}} +* {{site.data.keyword.weather_short}} +* {{site.data.keyword.iotdriverinsights_short}} +* {{site.data.keyword.geospatialshort_Geospatial}} +* {{site.data.keyword.graphshort}} +* {{site.data.keyword.iotelectronics}} +* {{site.data.keyword.languagetranslationshort}} +* {{site.data.keyword.messagehub}} +* {{site.data.keyword.mqa}} +* {{site.data.keyword.mobileappbuilder_short}} +* {{site.data.keyword.mql}} +* {{site.data.keyword.nlclassifiershort}} +* {{site.data.keyword.objectstorageshort}} +* {{site.data.keyword.personalityinsightsshort}} +* {{site.data.keyword.presenceinsightsshort}} +* {{site.data.keyword.relationshipextractionshort}} +* {{site.data.keyword.retrieveandrankshort}} +* {{site.data.keyword.speechtotextshort}} +* {{site.data.keyword.sqldb}} +* {{site.data.keyword.streaminganalyticsshort}} +* {{site.data.keyword.texttospeechshort}} +* {{site.data.keyword.toneanalyzershort}} +* {{site.data.keyword.tradeoffanalyticsshort}} +* {{site.data.keyword.visualinsightsshort}} +* {{site.data.keyword.visualrecognitionshort}} +* {{site.data.keyword.workflow}} +* {{site.data.keyword.workloadscheduler}} + +**Nota:** non tutti i piani di questi servizi sono disponibili. Solo i piani abilitati per gli account Pagamento a consumo possono essere utilizzati con gli account collegati. Tuttavia, se disponi di un account {{site.data.keyword.Bluemix_notm}} distinto, fatturato separatamente, puoi utilizzare qualsiasi piano di uno qualsiasi di questi servizi. + +## Fatturazione per l'utilizzo di {{site.data.keyword.Bluemix_notm}} con gli account collegati +{: #bill_usage} + +Una volta collegati i tuoi account di fatturazione {{site.data.keyword.Bluemix_notm}} e SoftLayer, il successivo ciclo di fatturazione verrà addebitato in un'unica fattura {{site.data.keyword.Bluemix_notm}}. +{:shortdesc} + +Il tuo ciclo di utilizzo di {{site.data.keyword.Bluemix_notm}} si basa sul mese di calendario, perciò l'addebito per il tuo account viene effettuato con cadenza mensile il giorno di fatturazione stabilito nel tuo accordo di addebito. Con SoftLayer, il ciclo di utilizzo inizia nel momento in cui viene avviato e viene pertanto addebitato con cadenza mensile lo stesso giorno del mese in cui hai sottoscritto l'account SoftLayer. + +Quando gli account sono collegati, l'utilizzo di {{site.data.keyword.Bluemix_notm}} continua a essere misurato per il ciclo del mese corrente e viene fatturato con una fattura {{site.data.keyword.Bluemix_notm}}. Dal primo giorno del mese successivo, gli addebiti {{site.data.keyword.Bluemix_notm}} e SoftLayer verranno combinati nella tua fattura {{site.data.keyword.Bluemix_notm}}. + +Ad esempio, se hai collegato gli account il 16 aprile, riceverai una fattura Bluemix per l'utilizzo di aprile. A seconda di quando hai collegato i tuoi account, potresti ricevere una fattura separata per l'utilizzo di SoftLayer. L'utilizzo di maggio per SoftLayer e {{site.data.keyword.Bluemix_notm}} verrà fatturato tramite l'account {{site.data.keyword.Bluemix_notm}}. + +![Collegamento del riepilogo degli account Bluemix e SoftLayer](images/BluemixSoftLayerBill.svg) + +Una volta collegate le fatture, la tua fattura {{site.data.keyword.Bluemix_notm}} elencherà i diversi addebiti per ogni risorsa utilizzata nelle seguenti intestazioni: + +* **Server Bare Metal e servizi collegati** +* **Server virtuali e servizi collegati** +* **Servizi non collegati** + +Per informazioni sulla visualizzazione dell'utilizzo di {{site.data.keyword.Bluemix_notm}}, vedi [Visualizzazione dei dettagli di utilizzo](https://console.ng.bluemix.net/docs/pricing/index.html#usage). + diff --git a/admin/nl/it/users_roles.md b/admin/nl/it/users_roles.md index 050ca7a95..9146da68b 100644 --- a/admin/nl/it/users_roles.md +++ b/admin/nl/it/users_roles.md @@ -1,143 +1,143 @@ ---- - - - -copyright: - - years: 2015, 2016 -lastupdated: "2016-12-05" - - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} - - -# Gestione dei membri dei team e dei ruoli -{: #userroles} - -Dalla pagina **Directory team** per il tuo account, puoi gestire i membri dei team esistenti e i loro ruoli nella tua organizzazione e nei tuoi spazi, oltre che invitare nuovi membri del team. Per accedere alla directory del team per il tuo account, fai clic su **Account** > **Directory team**. -{:shortdesc} - -I proprietari degli account eseguono tutte le operazioni sulle organizzazioni e sugli spazi, compresa la gestione dei membri dei team e dei loro ruoli assegnati. I gestori dell'organizzazione dispongono di un accesso che consente loro di invitare membri del team e gestire i ruoli. I gestori dello spazio possono utilizzare la pagina -**Gestisci organizzazioni** per aggiungere i membri dell'account esistenti allo spazio e regolare i loro ruoli. Per ulteriori informazioni sui ruoli, -consulta le seguenti informazioni. - -## Ruoli -{: #userrolesinfo} - -A livello di account, esistono due ruoli che abilitano l'accesso a funzioni di gestione dell'account differenti: - -| Ruolo dell'account | Autorizzazioni | -|----------------|---------| -|Proprietario | Un proprietario per l'account ha accesso al proprio profilo e dashboard di utilizzo e alle proprie directory di team, informazioni di fatturazione e notifiche di spesa. Dalla pagina directory team, il proprietario può invitare nuovi membri del team e regolare i ruoli. Il proprietario può anche aggiungere dei crediti promozionali, impostare o modificare il limite di fatturazione, impostare l'accesso al servizio e gestire organizzazioni e spazi. | -|Membro | Un membro ha accesso ai proprio limiti di fatturazione, crediti dell'account e profilo e alla propria directory team nell'intestazione {{site.data.keyword.Bluemix_notm}}. Tuttavia, nella pagina directory team, un membro può visualizzare solo i membri del team all'interno dell'account. | -{:caption="Table 1. Account roles and permissions" caption-side="top"} - - Tutti i nuovi membri del team vengono aggiunti come un membro dell'account. Puoi assegnare i ruoli organizzazione e spazio agli invitati per abilitare specifiche viste e autorizzazioni in {{site.data.keyword.Bluemix_notm}}. Ai nuovi membri del team aggiunti a un'organizzazione, con l'eccezione di un ambiente locale o dedicato, viene assegnato per impostazione predefinita il ruolo organizzazione di revisore. Per uno specifico spazio, puoi scegliere di assegnare il ruolo di sviluppatore o di revisore agli invitati. Dopo che gli invitati hanno accettato l'invito e si sono uniti a {{site.data.keyword.Bluemix_notm}}, puoi modificarne i ruoli nella pagina **Directory team**. - -I seguenti ruoli possono essere assegnati a livello dell'organizzazione: - -| Ruolo organizzazione | Autorizzazioni | -|-------------------|-------------| -|Gestore | I gestori dell'organizzazione possono creare, visualizzare, modificare o eliminare gli spazi nell'organizzazione, visualizzare l'utilizzo e la quota dell'organizzazione, invitare membri del team all'organizzazione, gestire chi ha accesso all'organizzazione e i loro ruoli al suo interno e gestire i domini personalizzati per l'organizzazione. | -|Gestore fatturazione | I gestori fatturazione possono visualizzare le informazioni sull'utilizzo di runtime e servizi per l'organizzazione nella pagina Dashboard di utilizzo. | -|Revisore | I revisori organizzazione possono visualizzare il contenuto di applicazioni e servizi nell'organizzazione. I revisori possono anche visualizzare i membri -del team nell'organizzazione e i ruoli ad essi assegnati, nonché la quota per l'organizzazione. Questo ruolo viene assegnato a tutti gli invitati per impostazione predefinita con l'eccezione degli ambienti locale o dedicato. | -{:caption="Table 2. Organization roles and permissions" caption-side="top"} - -I seguenti ruoli possono essere assegnati a livello dello spazio: - -| Ruolo spazio | Autorizzazioni | -|------------|-------------| -|Gestore | I gestori spazio possono aggiungere membri del team esistenti e gestire i ruoli nello spazio. Il gestore spazio può anche visualizzare il numero di istanze, i bind di servizio e l'utilizzo delle risorse per ciascuna applicazione nello spazio. | -|Sviluppatore | Gli sviluppatori spazio possono creare, eliminare e gestire applicazioni e servizi nello spazio. Alcune delle attività di gestione includono la distribuzione di applicazioni, l'avvio e l'arresto di applicazioni, la rinominazione di un'applicazione, l'eliminazione di un'applicazione, la rinominazione di uno spazio, il bind o l'annullamento del bind di un servizio a un'applicazione, la visualizzazione del numero di istanze, i bind di servizi e l'utilizzo di risorse per ciascuna applicazione nello spazio. Inoltre, lo sviluppatore spazio può associare un URL interno o esterno a un'applicazione nello spazio. | -|Revisore | I revisori spazio hanno un accesso in sola lettura a tutte le informazioni sullo spazio, quali le informazioni sul numero di istanze, i bind di servizio e l'utilizzo di risorse per ciascuna applicazione nello spazio. | -{:caption="Table 3. Space roles and permissions" caption-side="top"} - -**Nota**: ai membri del team a cui nello spazio è assegnato il ruolo di gestore o sviluppatore possono accedere alla variabile di ambiente VCAP_SERVICES. Tuttavia, un membro del team a cui è assegnato il ruolo di revisore non può accedere a VCAP_SERVICES. - -## Regolazione della visibilità della directory del team -{: #teamdirectoryvisibility} - -A seconda di come hai configurato le tue organizzazioni e account {{site.data.keyword.Bluemix_notm}}, potresti voler modificare la visibilità della pagina della directory del team. Per impostazione predefinita, tutti i membri del team nel tuo account possono visualizzare l'elenco completo dei membri del team dell'account, inclusi tutti i membri di tutte le organizzazioni nell'account. È possibile che ti venga richiesto di modificare la visibilità della pagina della directory del team per motivi di sicurezza e privacy. Hai due opzioni per configurare la visibilità della pagina della directory del team: tutti i membri o solo tu come proprietario dell'account. - -Per modificare la visibilità della pagina della directory del team, completare la seguente procedura: - -1. Fai clic su **Account** > **Directory team**. -2. Per l'opzione **Visibile a**, fai clic sulla seleziona corrente per visualizzare le opzioni. -3. Quindi, seleziona **Tutti** o **Solo io** in base ai bisogni del tuo account. -4. Fai quindi clic su **Salva**. - -## Come invitare membri del team -{: #inviteteammembers} - -I proprietari dell'account e i gestori dell'organizzazione possono invitare i membri del team alle organizzazioni dalla pagina Invita membri del team. Quando aggiungi dei nuovi membri del team, con l'eccezione di un ambiente locale o dedicato, a essi viene automaticamente assegnato i ruoli di revisore. Puoi modificare i ruoli successivamente nella pagina Directory team. Per invitare un membro del team, completa questa procedura: - -
    -
  1. Fai clic su **Account** > **Invita membri del team**.
    2. -
  2. Seleziona l'organizzazione a cui vuoi invitare i membri del team.
    3. -
  3. Fai clic su **Avanti**.
    4. -
  4. Seleziona gli spazi a cui vuoi consentire l'accesso per i tuoi membri del team.
    5. -
  5. Seleziona il ruolo da assegnare per gli spazi selezionati nell'organizzazione.
    6. -
  6. Seleziona l'opzione per confermare che ti assumi la responsabilità finanziaria per tutti gli addebiti sostenuti sull'account.
    7. -
  7. Immetti l'indirizzo email per un singolo membro del team oppure gli indirizzi email per più membri del team: -
      -
    • Per aggiungere un singolo membro del team, immetti l'indirizzo email e fai clic su **Invia**.
      • -
    • Per aggiungere più di un membro del team, fai clic su **Invitali tutti in una singola operazione**. Immetti gli indirizzi email utilizzando un elenco separato da virgole, spazi o interruzioni di riga. Fai quindi clic su **Avanti** per verificare gli indirizzi email a cui inviare gli inviti e fai clic su **Invia**.
      • -
    -
    8. -
- -Fai clic su **Visualizza in sospeso** per controllare se gli inviti sono in sospeso o sono stati accettati. Puoi scegliere di inviare nuovamente l'email di invito o di annullare l'invito per un invito in sospeso in qualsiasi momento. - - -### Aggiunta di membri del team SoftLayer - -Se hai un account SoftLayer collegato al tuo account Bluemix, puoi aggiungere i membri del tuo team SoftLayer. - -1. Vai a **Account** > **Invita membri del team**. -2. Fai clic su **Aggiungi** nella sezione **Aggiungi membri del team SoftLayer** per effettuare l'autenticazione nel tuo account SoftLayer e visualizzare un elenco di membri del team dal tuo account SoftLayer. - -L'aggiunta dei membri del team al tuo account Bluemix non concede loro l'accesso all'infrastruttura Bluemix. Per concedere agli utenti l'accesso al dashboard Infrastruttura, vai a **Infrastruttura** > **Account** > **Utenti** e fai clic sul link **Aggiungi utente**. Per aggiungere gli utenti, devi disporre dell'autorizzazione. - -Per ulteriori informazioni sull'aggiunta di membri del team dal tuo account SoftLayer, vedi [Invito di membri del team SoftLayer in Bluemix](https://console.ng.bluemix.net/docs/admin/softlayerlink.html#invite_users). - - -## Modifica di ruoli -{: #editinguserroles} - -I proprietari dell'account e i gestori dell'organizzazione possono modificare i ruoli di organizzazione e spazio per i membri del team esistenti nella pagina **Directory team**. - -1. Fai clic su **Account** > **Directory team**. -2. Individua il membro del team di cui vuoi modificare i ruoli. -3. Fai clic su **Visualizza ruoli**. -4. Seleziona o deseleziona le selezioni di ruolo dell'organizzazione per modificare l'accesso all'organizzazione per il membro del team. -5. Fai clic su **Visualizza spazi** per aggiungere o rimuovere ruoli dello spazio. -6. Seleziona o deseleziona le selezioni di ruolo dello spazio per modificare l'accesso allo spazio per il membro del team. -7. Fai clic su **Chiudi spazi**. -8. Fai clic su **Salva** alla fine della pagina. - -I gestori spazio possono modificare i ruoli per i membri del team nel loro spazio nella pagina **Gestisci organizzazioni**. - -1. Fai clic su **Account** > **Gestisci organizzazioni**. -2. Individua l'organizzazione in cui si trova il tuo spazio. -3. Fai clic su **Visualizza dettagli**. -4. Individua il tuo spazio e fai clic su **Modifica spazio**. -5. Seleziona la scheda **Utenti**. -6. Seleziona o deseleziona l'opzione di ruolo spazio per il ruolo che vuoi aggiungere al, o rimuovere dal, membro del team. -7. Fai quindi clic su **Salva**. - -## Rimozione dei membri del team -{: #removingteammembers} - -I proprietari dell'account e i gestori dell'organizzazione possono rimuovere membri del team da un account utilizzando la pagina **Directory team**. Per rimuovere un membro del team, completa la seguente procedura: - -1. Fai clic su **Account** > **Directory team**. -3. Individua l'utente che desideri rimuovere dall'account e fai clic sull'icona **Rimuovi** ![Icona Rimuovi](../icons/icon_remove_teamuser.svg). -4. Nella finestra **Rimuovi utente**, fai clic su **Rimuovi** per confermare di voler rimuovere l'utente specificato dall'account. - -L'utente viene rimosso dall'elenco di membri del team visualizzato per l'account. +--- + + + +copyright: + + years: 2015, 2016 +lastupdated: "2016-12-05" + + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} + + +# Gestione dei membri dei team e dei ruoli +{: #userroles} + +Dalla pagina **Directory team** per il tuo account, puoi gestire i membri dei team esistenti e i loro ruoli nella tua organizzazione e nei tuoi spazi, oltre che invitare nuovi membri del team. Per accedere alla directory del team per il tuo account, fai clic su **Account** > **Directory team**. +{:shortdesc} + +I proprietari degli account eseguono tutte le operazioni sulle organizzazioni e sugli spazi, compresa la gestione dei membri dei team e dei loro ruoli assegnati. I gestori dell'organizzazione dispongono di un accesso che consente loro di invitare membri del team e gestire i ruoli. I gestori dello spazio possono utilizzare la pagina +**Gestisci organizzazioni** per aggiungere i membri dell'account esistenti allo spazio e regolare i loro ruoli. Per ulteriori informazioni sui ruoli, +consulta le seguenti informazioni. + +## Ruoli +{: #userrolesinfo} + +A livello di account, esistono due ruoli che abilitano l'accesso a funzioni di gestione dell'account differenti: + +| Ruolo dell'account | Autorizzazioni | +|----------------|---------| +|Proprietario | Un proprietario per l'account ha accesso al proprio profilo e dashboard di utilizzo e alle proprie directory di team, informazioni di fatturazione e notifiche di spesa. Dalla pagina directory team, il proprietario può invitare nuovi membri del team e regolare i ruoli. Il proprietario può anche aggiungere dei crediti promozionali, impostare o modificare il limite di fatturazione, impostare l'accesso al servizio e gestire organizzazioni e spazi. | +|Membro | Un membro ha accesso ai proprio limiti di fatturazione, crediti dell'account e profilo e alla propria directory team nell'intestazione {{site.data.keyword.Bluemix_notm}}. Tuttavia, nella pagina directory team, un membro può visualizzare solo i membri del team all'interno dell'account. | +{:caption="Table 1. Account roles and permissions" caption-side="top"} + + Tutti i nuovi membri del team vengono aggiunti come un membro dell'account. Puoi assegnare i ruoli organizzazione e spazio agli invitati per abilitare specifiche viste e autorizzazioni in {{site.data.keyword.Bluemix_notm}}. Ai nuovi membri del team aggiunti a un'organizzazione, con l'eccezione di un ambiente locale o dedicato, viene assegnato per impostazione predefinita il ruolo organizzazione di revisore. Per uno specifico spazio, puoi scegliere di assegnare il ruolo di sviluppatore o di revisore agli invitati. Dopo che gli invitati hanno accettato l'invito e si sono uniti a {{site.data.keyword.Bluemix_notm}}, puoi modificarne i ruoli nella pagina **Directory team**. + +I seguenti ruoli possono essere assegnati a livello dell'organizzazione: + +| Ruolo organizzazione | Autorizzazioni | +|-------------------|-------------| +|Gestore | I gestori dell'organizzazione possono creare, visualizzare, modificare o eliminare gli spazi nell'organizzazione, visualizzare l'utilizzo e la quota dell'organizzazione, invitare membri del team all'organizzazione, gestire chi ha accesso all'organizzazione e i loro ruoli al suo interno e gestire i domini personalizzati per l'organizzazione. | +|Gestore fatturazione | I gestori fatturazione possono visualizzare le informazioni sull'utilizzo di runtime e servizi per l'organizzazione nella pagina Dashboard di utilizzo. | +|Revisore | I revisori organizzazione possono visualizzare il contenuto di applicazioni e servizi nell'organizzazione. I revisori possono anche visualizzare i membri +del team nell'organizzazione e i ruoli ad essi assegnati, nonché la quota per l'organizzazione. Questo ruolo viene assegnato a tutti gli invitati per impostazione predefinita con l'eccezione degli ambienti locale o dedicato. | +{:caption="Table 2. Organization roles and permissions" caption-side="top"} + +I seguenti ruoli possono essere assegnati a livello dello spazio: + +| Ruolo spazio | Autorizzazioni | +|------------|-------------| +|Gestore | I gestori spazio possono aggiungere membri del team esistenti e gestire i ruoli nello spazio. Il gestore spazio può anche visualizzare il numero di istanze, i bind di servizio e l'utilizzo delle risorse per ciascuna applicazione nello spazio. | +|Sviluppatore | Gli sviluppatori spazio possono creare, eliminare e gestire applicazioni e servizi nello spazio. Alcune delle attività di gestione includono la distribuzione di applicazioni, l'avvio e l'arresto di applicazioni, la rinominazione di un'applicazione, l'eliminazione di un'applicazione, la rinominazione di uno spazio, il bind o l'annullamento del bind di un servizio a un'applicazione, la visualizzazione del numero di istanze, i bind di servizi e l'utilizzo di risorse per ciascuna applicazione nello spazio. Inoltre, lo sviluppatore spazio può associare un URL interno o esterno a un'applicazione nello spazio. | +|Revisore | I revisori spazio hanno un accesso in sola lettura a tutte le informazioni sullo spazio, quali le informazioni sul numero di istanze, i bind di servizio e l'utilizzo di risorse per ciascuna applicazione nello spazio. | +{:caption="Table 3. Space roles and permissions" caption-side="top"} + +**Nota**: ai membri del team a cui nello spazio è assegnato il ruolo di gestore o sviluppatore possono accedere alla variabile di ambiente VCAP_SERVICES. Tuttavia, un membro del team a cui è assegnato il ruolo di revisore non può accedere a VCAP_SERVICES. + +## Regolazione della visibilità della directory del team +{: #teamdirectoryvisibility} + +A seconda di come hai configurato le tue organizzazioni e account {{site.data.keyword.Bluemix_notm}}, potresti voler modificare la visibilità della pagina della directory del team. Per impostazione predefinita, tutti i membri del team nel tuo account possono visualizzare l'elenco completo dei membri del team dell'account, inclusi tutti i membri di tutte le organizzazioni nell'account. È possibile che ti venga richiesto di modificare la visibilità della pagina della directory del team per motivi di sicurezza e privacy. Hai due opzioni per configurare la visibilità della pagina della directory del team: tutti i membri o solo tu come proprietario dell'account. + +Per modificare la visibilità della pagina della directory del team, completare la seguente procedura: + +1. Fai clic su **Account** > **Directory team**. +2. Per l'opzione **Visibile a**, fai clic sulla seleziona corrente per visualizzare le opzioni. +3. Quindi, seleziona **Tutti** o **Solo io** in base ai bisogni del tuo account. +4. Fai quindi clic su **Salva**. + +## Come invitare membri del team +{: #inviteteammembers} + +I proprietari dell'account e i gestori dell'organizzazione possono invitare i membri del team alle organizzazioni dalla pagina Invita membri del team. Quando aggiungi dei nuovi membri del team, con l'eccezione di un ambiente locale o dedicato, a essi viene automaticamente assegnato i ruoli di revisore. Puoi modificare i ruoli successivamente nella pagina Directory team. Per invitare un membro del team, completa questa procedura: + +
    +
  1. Fai clic su **Account** > **Invita membri del team**.
    2. +
  2. Seleziona l'organizzazione a cui vuoi invitare i membri del team.
    3. +
  3. Fai clic su **Avanti**.
    4. +
  4. Seleziona gli spazi a cui vuoi consentire l'accesso per i tuoi membri del team.
    5. +
  5. Seleziona il ruolo da assegnare per gli spazi selezionati nell'organizzazione.
    6. +
  6. Seleziona l'opzione per confermare che ti assumi la responsabilità finanziaria per tutti gli addebiti sostenuti sull'account.
    7. +
  7. Immetti l'indirizzo email per un singolo membro del team oppure gli indirizzi email per più membri del team: +
      +
    • Per aggiungere un singolo membro del team, immetti l'indirizzo email e fai clic su **Invia**.
      • +
    • Per aggiungere più di un membro del team, fai clic su **Invitali tutti in una singola operazione**. Immetti gli indirizzi email utilizzando un elenco separato da virgole, spazi o interruzioni di riga. Fai quindi clic su **Avanti** per verificare gli indirizzi email a cui inviare gli inviti e fai clic su **Invia**.
      • +
    +
    8. +
+ +Fai clic su **Visualizza in sospeso** per controllare se gli inviti sono in sospeso o sono stati accettati. Puoi scegliere di inviare nuovamente l'email di invito o di annullare l'invito per un invito in sospeso in qualsiasi momento. + + +### Aggiunta di membri del team SoftLayer + +Se hai un account SoftLayer collegato al tuo account Bluemix, puoi aggiungere i membri del tuo team SoftLayer. + +1. Vai a **Account** > **Invita membri del team**. +2. Fai clic su **Aggiungi** nella sezione **Aggiungi membri del team SoftLayer** per effettuare l'autenticazione nel tuo account SoftLayer e visualizzare un elenco di membri del team dal tuo account SoftLayer. + +L'aggiunta dei membri del team al tuo account Bluemix non concede loro l'accesso all'infrastruttura Bluemix. Per concedere agli utenti l'accesso al dashboard Infrastruttura, vai a **Infrastruttura** > **Account** > **Utenti** e fai clic sul link **Aggiungi utente**. Per aggiungere gli utenti, devi disporre dell'autorizzazione. + +Per ulteriori informazioni sull'aggiunta di membri del team dal tuo account SoftLayer, vedi [Invito di membri del team SoftLayer in Bluemix](https://console.ng.bluemix.net/docs/admin/softlayerlink.html#invite_users). + + +## Modifica di ruoli +{: #editinguserroles} + +I proprietari dell'account e i gestori dell'organizzazione possono modificare i ruoli di organizzazione e spazio per i membri del team esistenti nella pagina **Directory team**. + +1. Fai clic su **Account** > **Directory team**. +2. Individua il membro del team di cui vuoi modificare i ruoli. +3. Fai clic su **Visualizza ruoli**. +4. Seleziona o deseleziona le selezioni di ruolo dell'organizzazione per modificare l'accesso all'organizzazione per il membro del team. +5. Fai clic su **Visualizza spazi** per aggiungere o rimuovere ruoli dello spazio. +6. Seleziona o deseleziona le selezioni di ruolo dello spazio per modificare l'accesso allo spazio per il membro del team. +7. Fai clic su **Chiudi spazi**. +8. Fai clic su **Salva** alla fine della pagina. + +I gestori spazio possono modificare i ruoli per i membri del team nel loro spazio nella pagina **Gestisci organizzazioni**. + +1. Fai clic su **Account** > **Gestisci organizzazioni**. +2. Individua l'organizzazione in cui si trova il tuo spazio. +3. Fai clic su **Visualizza dettagli**. +4. Individua il tuo spazio e fai clic su **Modifica spazio**. +5. Seleziona la scheda **Utenti**. +6. Seleziona o deseleziona l'opzione di ruolo spazio per il ruolo che vuoi aggiungere al, o rimuovere dal, membro del team. +7. Fai quindi clic su **Salva**. + +## Rimozione dei membri del team +{: #removingteammembers} + +I proprietari dell'account e i gestori dell'organizzazione possono rimuovere membri del team da un account utilizzando la pagina **Directory team**. Per rimuovere un membro del team, completa la seguente procedura: + +1. Fai clic su **Account** > **Directory team**. +3. Individua l'utente che desideri rimuovere dall'account e fai clic sull'icona **Rimuovi** ![Icona Rimuovi](../icons/icon_remove_teamuser.svg). +4. Nella finestra **Rimuovi utente**, fai clic su **Rimuovi** per confermare di voler rimuovere l'utente specificato dall'account. + +L'utente viene rimosso dall'elenco di membri del team visualizzato per l'account. diff --git a/admin/patterns.md b/admin/patterns.md index fdcd8b2b1..d7a1eabc0 100644 --- a/admin/patterns.md +++ b/admin/patterns.md @@ -1,363 +1,363 @@ ---- - - - -copyright: - - years: 2015, 2017 -lastupdated: "2017-02-22" - - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Best practices for setting up your {{site.data.keyword.Bluemix_notm}} environment -{: #patterns} - -For a successful project, take time to plan and design which resources you need and what your enterprise requirements are. To help you get started with your cloud project, consider the following questions: - -* How many, and what type of, applications will be developed? -* Which services will the applications need to access? -* Who will be collaborating in the development process and what role will they play? -* What degree of isolation is required for each phase of the project? -* Will your enterprise supply the infrastructure resources? -* How does your company communicate? -* Is there a naming standard that you can implement to clearly identify the organization and space usage? - -{:shortdesc} - -When you design a cloud solution, also think about account security and operational requirements, country regulations, market directives, and corporate policies. -To cater for your project needs, {{site.data.keyword.Bluemix}} offers three types of cloud environments. - -* [{{site.data.keyword.Bluemix_notm}} Public](/docs/overview/whatisbluemix.html "{{site.data.keyword.Bluemix_notm}} Public"): The infrastructure resources are shared by different companies and users. -* [{{site.data.keyword.Bluemix_notm}} Dedicated](/docs/dedicated/index.html#dedicated "{{site.data.keyword.Bluemix_notm}} Dedicated"): You use your own dedicated SoftLayer infrastructure, which you can connect securely to the {{site.data.keyword.Bluemix_notm}} Public cloud and your own network. -* [{{site.data.keyword.Bluemix_notm}} Local](/docs/local/index.html#local "{{site.data.keyword.Bluemix_notm}} Local"): Sits behind your company firewall, which can protect your most sensitive workloads and can connect securely to both {{site.data.keyword.Bluemix_notm}} Public and {{site.data.keyword.Bluemix_notm}} Dedicated clouds. - -As part of deciding which type of cloud environment you need, plan the structure of your account, organizations, spaces, resources, and team members. - -For most companies, a single {{site.data.keyword.Bluemix_notm}} account is sufficient. For larger companies, where there is more than one business area, you might -want a separate {{site.data.keyword.Bluemix_notm}} account for each business domain. For example, within a large banking corporation there might be separate accounts for the retail and commercial sectors. - -The folllowing table provides a summary of some of the key elements. - -| Element | Description | -|---------------------------------------|--------------------------------------------------------------------------------------| -| Account | Each account has one account owner. | -|| Contains one or more organizations. You must have a Pay-As-You-Go account to create more than one organization. | -| Account owner | Responsible for all of the usage charges that are accumulated within the account. | -|| Can own only one account. | -|| Can add one or more organization managers to delegate the org management, which includes the read and write permissions to the organizations. | -|| Can be a team member in organizations and spaces in other {{site.data.keyword.Bluemix_notm}} accounts. | -| Organization | Contains one or more spaces. | -|| Contains one or more org managers. | -|| Contains one or more team members. Each team member can be granted one or more roles. | -|| The usage charges, which are generated by a deployed application within a space, are reported at the organization level. | -| Space | Contains one or more resources. | -|| Contains one or more applications. | -|| Contains one or more space managers. | -|| Contains one or more team members. Each user must already be a team member in the owning organization. Each team member can be granted one or more roles. | -| Team member | Can be added to one or more organizations and spaces across different accounts. | -|| Can be given more than one role within the same organization, space, or both. | -{:caption="Table 1. Description of key elements" caption-side="top"} - -## Determining your {{site.data.keyword.Bluemix_notm}} environment -{: #bpimplementation} - -Instead of the traditional, strictly defined development, test, and production methodology, you can implement an environment where developers and testers can collaborate along with other team members. If you design the way you want to develop and deliver your aplications, you can create {{site.data.keyword.Bluemix_notm}} spaces to fulfil that methodology. Instead of designing your environment from the organization level down, consider designing your {{site.data.keyword.Bluemix_notm}} environment from the space level up. - -Consider the scale and scope of the applications you plan to develop and deploy. A {{site.data.keyword.Bluemix_notm}} space can be used as a development environment for one or more applications that are tightly connected or defined. Apart from a development space, for example, you might want to create spaces for unit testing, performance testing, and integration testing. Spaces can also be defined for build, staging, and production. Each of the spaces that you create can be shared with different team members within the same organization. - -Create separate {{site.data.keyword.Bluemix_notm}} organizations when you have people working on different business areas and where their activities do not overlap. If there are two completely independent groups, then creating an organization for each defines clear boundaries for the delivery and management of team players and resources. You can define an API to communicate between the organizations. - -{{site.data.keyword.Bluemix_notm}} organizations can be created to match how you want to work rather than the structure within a company. Typically, company organizations can change but the development and maintenance of an application will continue regardless. -Design your {{site.data.keyword.Bluemix_notm}} environment for the lifetime of the applications and not on your company organization structure. - -Iterative development and deployment can result in applications expanding quickly. Your delivery process design must be able to scale up quickly and easily. You will want continuous development with a fast deployment rate. Having your development and production spaces in the same {{site.data.keyword.Bluemix_notm}} organization will provide access to the same resources. Managing different spaces within a single organization reduces the administration overhead. The development, test, and operations personnel can collaborate easily if they are working within the same {{site.data.keyword.Bluemix_notm}} organization. - -Implement a naming standard to clearly identify the organization and space usage. For example, you might include the type of cloud, the geographical region, the usage type (such as dev, test, prod), the application name, and the version or revision number. The organizations and spaces can then be easily identified for administration and access purposes. - -The number of spaces can multiply rapidly because of iterative development. You can define as many spaces as you need within an organization. If you plan to define a large number of spaces, you might want to create an application to help manage the spaces. When the number of spaces exceeds sixty, you might want to consider defining another organization. - -Have one person create and manage an organization, define the spaces, and grant team member access. A second person can be given the same access to maintain the environment when the organization manager is unavailable. - -Identify all of the people who will need access to each space and organization. Determine their role. The job role of a team member will determine their authority. For example, a senior developer will need the authority to view and update the whole {{site.data.keyword.Bluemix_notm}} development environment. However, a junior developer will be limited as to what they can view and update. - -## Determining your organization architecture -{: #orgstructure} - -To design a cloud environment that uses {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, {{site.data.keyword.Bluemix_notm}} Local, or any combination, you can use the following organization architectures: - -* Single-organization: Consider using this architecture if you require the same set of users to access resources that are available anywhere in the organization either in {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, or {{site.data.keyword.Bluemix_notm}} Local. -* Multi-organization: Consider using this architecture if you require isolation between different environments within {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, or {{site.data.keyword.Bluemix_notm}} Local. - -### Single-organization versus multi-organization -{: #singleormulti} - -In a single-organization environment, the infrastructure resources are shared by different areas of -the company. Whereas, in a multi-organization environment the infrastructure resources are not shared. - -Both organization architectures support the following priciples: - -* Boundary enforcement for applications, projects, or both. -* Authorization to manage resources granted by user role. - -To implement a single-organization architecture, create an account in {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, or -{{site.data.keyword.Bluemix_notm}} Local, and define one organization. You can then define multiple spaces that are based on different lines of business (LOB), -the delivery phases, specific projects, applications, user permisisons, or a combination of these components. - -To implement a multi-organization architecture, create an account in {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, -or {{site.data.keyword.Bluemix_notm}} Local. Next, you can define organizations that correspond to different LOBs, delivery phases, -specific projects, user permisisons, or a combination of these components. You can then define multiple spaces that are based on applications or projects that are delivered by the same department in the company. - -**Note:** You must have a billable account, such as Pay-As-You-Go or Subscription, to define multiple organizations. - -### Organization considerations -{: #orgconsiderations} - -When you implement a single-organization architecture, the organization includes all of the cloud resources, services, and applications that you use to develop, manage, and -deploy cloud applications. In {{site.data.keyword.Bluemix_notm}} Public, the organization provides segregation between accounts and is available across all regions. - - ![Figure that shows the single-organization architecture in {{site.data.keyword.Bluemix_notm}}](images/singleorg_example.svg "Figure that shows the single-organization architecture in {{site.data.keyword.Bluemix_notm}}") - - Figure 1. Example of a single-organization architecture for {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, and - {{site.data.keyword.Bluemix_notm}} Local -{: #bpfigure1} - -When you implement a multi-organization architecture, organizations provide the first level of boundary enforcement and abstraction that you can use to control and define what can be -done and by whom. Design each organization around the different LOBs, the delivery phases, the roles of the users, specific projects, or a combination of these components. - -The number of organizations that you require depends on multiple factors: - -* The level of granularity that you require within your organization to manage quotas and control costs. -* The level of security that you must enforce in your different environments. For example, if you are using containers, you might want to segregate container images that are used for development from the container images that are used for production. -* The location of the organizations due to corporate, country, and industry requirements. For example, you might want to run all of your apps in a dedicated cloud that is located in a specific region in your geography (geo). - -When you are defining the different organizations for your cloud structure, consider the following guidance: - -* Define and then enforce a naming convention. For example, define a naming convention where the name of the organization includes information about the business area, the type of cloud ({{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Local, or {{site.data.keyword.Bluemix_notm}} Dedicated), and the process phase (development, testing, or production). For organizations that are located in {{site.data.keyword.Bluemix_notm}} Public, you might want to add information about the region too. -* Define the restrictions that apply to the organization. For example, define the role of the team members that are going to work in that organization. -* Identify the manager of the organization. -* Identify the area of the business that is allocated to this organization. - -The following scenarios show different approaches that you can adopt when you define the number of {{site.data.keyword.Bluemix_notm}} organizations in a cloud environment: -* **Scenario 1: Segregation of user groups by business application delivery** - - Description: Corporate rules require that the apps of each LOB must be developed, managed, and deployed by users from each LOB. Security must be enforced so that users can access only the apps that are relevant to their part of the business. So, the users work in different business areas, the applications they are working on require access to different {{site.data.keyword.Bluemix_notm}} resources, and there is no activity overlap. - - Solution: You can create an organization for each business application delivery process. For example, one organization for retail banking, and one for investment banking. - - ![Figure that shows segregation of users by business application delivery](images/bank_example.svg "Figure that shows segregation of users by business application delivery") - - Figure 2. Example of a multi-organization architecture aligned to LOB delivery -{: #bpfigure2} - -* **Scenario 2: Segregation based on type of users (internal users, external users)** - - Description: Your company works with different partners and you require clear boundaries between internal and external users. - - Solution: You can create an organization to deliver applications that are used internally. In addition, you can create one organization for each external partner. - -* **Scenario 3: Isolation by project** - - Description: Your company runs hackathons to identify new services. - - Solution: You can define one organization per hackathon and use the organization as a sandbox. After the hackathon, you can promote the sandbox organization into an additional organization in your account. - -* **Scenario 4: Isolation of users by delivery phase** - - Description: A company wants development, test, and production users to collaborate across a delivery, but their access is controlled by user role and job experience. - - Solution: You can create a single-organization and define a space for each delivery phase. Then, depending on the user role and job experience, grant the read and write access they require to complete their work and also collaborate within the organization. - - ![Figure that shows isolation of users by delivery phase](images/user_groups_example.svg "Figure that shows isolation of users by delivery phase") - - Figure 3. Example of a single-organization architecture aligned by delivery phase -{: #bpfigure3} - -### Organization naming, restrictions, and management  -{: #orgadmin} - -Consider the following organization guidance: - -* Define and enforce a naming convention. For example, define a naming convention where the name of the organization includes information about the business area, the type of cloud ({{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Local, or {{site.data.keyword.Bluemix_notm}} Dedicated), and the IT role (development, testing, or production). For organizations that are located in {{site.data.keyword.Bluemix_notm}} Public, you might want to add information about the region too. You can change the name of an organization after it is created. If an organization name is altered, notify all of the organization team members about the change. -* Define the restrictions that apply to the organization. For example, define the role of each of the team members and the permissions they need to work in that organization. -* Identify the manager of the organization. You might want to delegate the organization administration to more that one person. -* Identify the area of the business that is allocated to this organization. The application usage that is generated in each of the spaces, within the organization, is accumulated and reported at the organization level. - -## Determining your spaces -{: #determinespaces} - -Within an organization, spaces provide an additional level of boundary enforcement and abstraction. - -A space is a reserved area in the organization where users can develop and run applications and services. You can create any number of spaces in an organization. -You can control the users that have access to a space. For more information, see [Spaces](/docs/admin/orgs_spaces.html#spaceinfo "Spaces"). - -If you plan to define a large number of spaces, you might want to create an application to help manage the spaces. When the number of -spaces exceeds sixty, you might want to consider defining another organization. - -### Spaces for single-organization versus multi-organization -{: #spaceconsiderations} - -When you adopt a single-organization architecture, the level of segregation and abstraction is provided by the spaces that you define within the organization. Consider the following guidance when you define spaces: - -* Define a space to host a service that requires provisioning and configuring only once in the organization. -* Define spaces based on the delivery lifecycle. - For example, you can define one or more spaces for applications that are being developed, one or more spaces for applications that are in the test phase, and one or more - spaces for applications that are in production. -* If the delivery lifecycle boundary is not sufficient, you can achieve more segregation by defining one or more spaces per LOB and delivery phase. -* Identify if you need to enforce boundaries for different users groups. - For example, your developers cannot develop the application and test it. You require a different set of users to test the application. In this scenario, you create two spaces, one for - developers of the application and one for testers of the application. Then grant each set of users access to the correct space. - -When you implement a multi-organization architecture, you can segregate each organization by the LOB, the delivery lifecycle, or both. You can then define -multiple spaces, which are based on the number of applications or projects that are delivered by the same department in the company. Consider the following guidance when you plan the spaces in an organization: - -* Define a space to host a service that requires provisioning and configuring only once in the organization. -* Define a space per application, per group of related applications, or for a specific project. -* If you need to enforce boundaries for different users, define a space for each set of users. When a user is granted a developer role in a space, that user has full access to any resources and {{site.data.keyword.Bluemix_notm}} services) that are provisioned and running in that space. When you need to enforce tighter security to prevent users controlling every resource, consider defining different spaces. Within any of these spaces, you can provison {{site.data.keyword.Bluemix_notm}} services that are used by the apps running in that space. - -### Space naming, restrictions, and management -{: #spaceadmin} - -To define the different spaces for your cloud organization, consider the following guidance: - -* Define and enforce a naming convention. For example, define a naming convention where the space name includes information about where the organization is located and the type of cloud ({{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, or {{site.data.keyword.Bluemix_notm}} Local). You can change the name of a space after it is created. If a space name is altered, notify all of the space team members about the change. -* Define the restrictions that apply to the space. For example, define the type of applications that can be developed, managed, and deployed in each space. -* Identify the manager of the space. You might want to delegate the space administration to more than one person. - -## Determining quota for an organization -{: #determinequota} - -When you create an organization in {{site.data.keyword.Bluemix_notm}}, you provision infrastructure resources that include resources such as memory, Internet Protocol (IP), servers, and storage: -* For {{site.data.keyword.Bluemix_notm}} Public, a minimum set of resources is allocated by IBM to an organization. Based on the type of account, you have different resource allocations. These resources define the quota that is allocated by IBM to an organization. -* For {{site.data.keyword.Bluemix_notm}} Dedicated, you request a set of resources from IBM, and then you can distribute them between the different organizations in your {{site.data.keyword.Bluemix_notm}} Dedicated cloud environment. -* For {{site.data.keyword.Bluemix_notm}} Local, you provide the resources and then you can distribute them between organizations in your {{site.data.keyword.Bluemix_notm}} Local cloud environment. - -For {{site.data.keyword.Bluemix_notm}} Public and {{site.data.keyword.Bluemix_notm}} Dedicated, you can request additional resources from IBM. For -{{site.data.keyword.Bluemix_notm}} Local, you are responsible for providing any resources that might be required to run your business in the local cloud. - -The quota that is allocated to an organization represents the resources that are available within the organization. You manage the quota and you decide how the resources are distributed across the organization. - -### Managing and monitoring quota -{: #managequota} - -You manage and monitor the quota of an account by space and by infrastructure. Any resource that is provisioned in a space and is then used by the deployed application consumes a portion of the quota available to the organization. -* For more information about how to view and manage the quota of an organization in {{site.data.keyword.Bluemix_notm}} Public, see [Managing quota](/docs/admin/orgs_spaces.html#managequota "Managing quota"). -* For more information about how to view and manage the quota of an organization in {{site.data.keyword.Bluemix_notm}} Dedicated or {{site.data.keyword.Bluemix_notm}} local, see [Viewing usage and reports](/docs/admin/index.html?pos=2#oc_resource "Viewing usage and reports"). - -## Assigning roles -{: #roles} - -You can grant multiple roles to team members in a {{site.data.keyword.Bluemix_notm}} account. These roles define the permissions of the user to manage account and organization resources: -* You can grant [user roles](/docs/admin/users_roles.html#userrolesinfo "user roles" ) to members of an organization. These roles define the level of access within the organization, and restrict who can access a space and its resources. For example, you can grant users different permissions to different spaces. -* In {{site.data.keyword.Bluemix_notm}} Dedicated and {{site.data.keyword.Bluemix_notm}} Local only, you can grant [administrative roles](/docs/admin/index.html#oc_useradmin "administrative roles" ) to members of an account to manage system information, usage of account resources, reports and logs, catalog services, users, and resource usage per organization. - -### Account owner -{: #accountowner} - -Whether you design a multi-organization architecture or a single-organization architecture, the account owner is the super user of the cloud environment. - -The account owner core tasks include: - -* Managing the resources of the global account. -* Creating organizations. -* Adding team members to the account. - -To add team members to an account, use the email address of the user or a list of email addresses. In {{site.data.keyword.Bluemix_notm}} Dedicated and {{site.data.keyword.Bluemix_notm}} -Local, you can also use the company LDAP to add users, groups of users, or both. You can also import users from a file. For more information, see [Managing users and permissions](/docs/admin/index.html#oc_useradmin "Managing users and permissions"). - -The account owner can also perform the following tasks: - -* Add one or more users as managers of an organization by assigning these users the **Manager** role. Consider adding two users as organization managers. The first user acts as the principal manager of the organization. The second user acts as the deputy manager, in case, the principal manager is unavailable. -* In {{site.data.keyword.Bluemix_notm}} Public, and depending on the [account type](/docs/pricing/index.html#pay-accounts "account type"), setting spending notifications. First, the account owner defines the thresholds that are used to alert him when costs reach a certain limit. Then, [configures email notifications](/docs/admin/account.html#notifications "configures email notifications"). The account manager can use the information in the emails as alert notifications and might take action based on the information provided, for example upgrading the account. **Note:** The account owner is the only person that can receive spending notification emails. -* Add one or more users as administrators of the account by assigning these users the **Admin** role. Consider adding a minimum of two users. The first user acts as the principal administrator of the account. The second user acts as the deputy administrator. -* Define the account notifications to inform about maintenance updates or critical incident alerts. These notifications can be configured to send an email or a Short Message Service. - -### User roles -{: #userroles} - -User roles define the permissions that you can assign to a team member in an organization and define the level of access that a team member has within the organization and each space. - -In a multi-organization architecture or in a single-organization architecture, define the team members and the permissions that each user requires to complete their work: - -1. Identify the set of users that require access to an organization. -2. Define the permissions for each team member in the organization and in a space of the organization. -3. Select the role that grants a user the permissions they require. - - * Organization manager - * Organization auditor - * Organization billing manager - * Space manager - * Space developer - * Space auditor - -#### Organization manager -{: #bporgmgr} - -The tasks that an organization manager is responsible for includes creating spaces, distributing the quota between the spaces, inviting team members and optionally granting them specific roles, and defining custom domains. - -#### Organization auditor -{: #bporgauditor} - -The team members with the organization **Auditor** role can monitor the quota, the resource usage, and the team members for all of the spaces in an organization. -The auditors can then report on the organization efficiency and highlight any potential problems. - -* When you adopt a multi-organization architecture, you might want to grant the auditor role to the same team members for every organization that is part of the account. -Then, these team members can monitor the quota across all of the organizations in your cloud environment and obtain a global view of the account. -* When you adopt a single-organization architecture, grant the auditor role to the team members with the responsibility for monitoring the quota usage and overall efficiency -of the organization. - -#### Organization billing manager -{: #bporgbillingmgr} - -The team members with the **Billing Manager** role can monitor the costs of an organization. - -* When you adopt a multi-organization architecture, you might want to grant the billing role to the same set of team members for every organization that is part of the account. Then, these team members can then monitor the cost of each organization and obtain a global view of the account. -* In a single-organization architecture, identify the users that are responsible for monitoring the cost. - -#### Space manager -{: #bpspacemgr} - -The space **Manager** is responsible for any work that is done within the space that they manage and control. The space manager can perform the following tasks: - -* Monitoring the quota that is allocated to the space. -* Requesting additional resources to the organization manager. -* Notifying the organization manager of resources that are not required. -* Addind team members to the space with the **Developer** role. -* Optionally, assigning the space **Manager** role to a team member to act as a deputy space manager in their absence. - -#### Space developer -{: #bpspacedev} - -A space developer can do the following tasks: - -* Manage Cloud Foundry applications. -* Provision and configure {{site.data.keyword.Bluemix_notm}} services. -* Associate domains to applications. - -#### Space auditor -{: #bpspaceauditor} - -For every space, you might want to grant the space **Auditor** role to the same team members with the organization **Auditor** role. In your enterprise, this role might have to be granted to a specific set of users. - -### Administrative roles -{: #adminroles} - -[Administrative roles](/docs/admin/index.html#oc_useradmin "Administrative roles" ) define the permissions that you can grant to users to manage a {{site.data.keyword.Bluemix_notm}} Dedicated or a {{site.data.keyword.Bluemix_notm}} Local account. -You can grant read or write permissions to allow a user to view system information, usage of the account resources, reports and logs, catalog services, users, and resource usage per organization. - -In a multi-organization architecture or in a single-organization architecture, define the users and the permissions that each user requires to manage the account: - -1. Identify the set of administration cloud team users and fgrant them the relevant administration permissions. Include the organization managers as members of this team. -2. Define the permissions for these users in the account. Divide permissions to manage the catalog and reports between users of the team. -3. Select one or more roles for each user to match the permissions required to manage the account: - - * Admin role: Grant this role to two or more users in the account. Users with this role have the authority to manage the entire organization. - * User role: This role can be configured with read or write permissions. Grant this role with write permissions to managers of organizations to allow them to add users to the account and their organizations. Grant this role with read permissions to managers of organizations that might need access to see the list of members in the account. - * Catalog role: This role can be configured with read or write permissions. Grant this role to a set of users with write permissions to allow them to define and manage which Bluemix services and starters are visible to users in the {{site.data.keyword.Bluemix_notm}} Catalog. Grant this role with read permissions to managers of organizations. - * Reports role: This role can be configured with read or write permissions. Grant this role to a set of users with write permissions to allow them to view and add reports that other users with read permissions can download. Grant read permissions to all members of the admin team. - * Login role: Grant this role to all members of the admin team. You can also grant this role to other users in the account that require access to view the account notifications and system information. +--- + + + +copyright: + + years: 2015, 2017 +lastupdated: "2017-02-22" + + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Best practices for setting up your {{site.data.keyword.Bluemix_notm}} environment +{: #patterns} + +For a successful project, take time to plan and design which resources you need and what your enterprise requirements are. To help you get started with your cloud project, consider the following questions: + +* How many, and what type of, applications will be developed? +* Which services will the applications need to access? +* Who will be collaborating in the development process and what role will they play? +* What degree of isolation is required for each phase of the project? +* Will your enterprise supply the infrastructure resources? +* How does your company communicate? +* Is there a naming standard that you can implement to clearly identify the organization and space usage? + +{:shortdesc} + +When you design a cloud solution, also think about account security and operational requirements, country regulations, market directives, and corporate policies. +To cater for your project needs, {{site.data.keyword.Bluemix}} offers three types of cloud environments. + +* [{{site.data.keyword.Bluemix_notm}} Public](/docs/overview/whatisbluemix.html "{{site.data.keyword.Bluemix_notm}} Public"): The infrastructure resources are shared by different companies and users. +* [{{site.data.keyword.Bluemix_notm}} Dedicated](/docs/dedicated/index.html#dedicated "{{site.data.keyword.Bluemix_notm}} Dedicated"): You use your own dedicated SoftLayer infrastructure, which you can connect securely to the {{site.data.keyword.Bluemix_notm}} Public cloud and your own network. +* [{{site.data.keyword.Bluemix_notm}} Local](/docs/local/index.html#local "{{site.data.keyword.Bluemix_notm}} Local"): Sits behind your company firewall, which can protect your most sensitive workloads and can connect securely to both {{site.data.keyword.Bluemix_notm}} Public and {{site.data.keyword.Bluemix_notm}} Dedicated clouds. + +As part of deciding which type of cloud environment you need, plan the structure of your account, organizations, spaces, resources, and team members. + +For most companies, a single {{site.data.keyword.Bluemix_notm}} account is sufficient. For larger companies, where there is more than one business area, you might +want a separate {{site.data.keyword.Bluemix_notm}} account for each business domain. For example, within a large banking corporation there might be separate accounts for the retail and commercial sectors. + +The folllowing table provides a summary of some of the key elements. + +| Element | Description | +|---------------------------------------|--------------------------------------------------------------------------------------| +| Account | Each account has one account owner. | +|| Contains one or more organizations. You must have a Pay-As-You-Go account to create more than one organization. | +| Account owner | Responsible for all of the usage charges that are accumulated within the account. | +|| Can own only one account. | +|| Can add one or more organization managers to delegate the org management, which includes the read and write permissions to the organizations. | +|| Can be a team member in organizations and spaces in other {{site.data.keyword.Bluemix_notm}} accounts. | +| Organization | Contains one or more spaces. | +|| Contains one or more org managers. | +|| Contains one or more team members. Each team member can be granted one or more roles. | +|| The usage charges, which are generated by a deployed application within a space, are reported at the organization level. | +| Space | Contains one or more resources. | +|| Contains one or more applications. | +|| Contains one or more space managers. | +|| Contains one or more team members. Each user must already be a team member in the owning organization. Each team member can be granted one or more roles. | +| Team member | Can be added to one or more organizations and spaces across different accounts. | +|| Can be given more than one role within the same organization, space, or both. | +{:caption="Table 1. Description of key elements" caption-side="top"} + +## Determining your {{site.data.keyword.Bluemix_notm}} environment +{: #bpimplementation} + +Instead of the traditional, strictly defined development, test, and production methodology, you can implement an environment where developers and testers can collaborate along with other team members. If you design the way you want to develop and deliver your aplications, you can create {{site.data.keyword.Bluemix_notm}} spaces to fulfil that methodology. Instead of designing your environment from the organization level down, consider designing your {{site.data.keyword.Bluemix_notm}} environment from the space level up. + +Consider the scale and scope of the applications you plan to develop and deploy. A {{site.data.keyword.Bluemix_notm}} space can be used as a development environment for one or more applications that are tightly connected or defined. Apart from a development space, for example, you might want to create spaces for unit testing, performance testing, and integration testing. Spaces can also be defined for build, staging, and production. Each of the spaces that you create can be shared with different team members within the same organization. + +Create separate {{site.data.keyword.Bluemix_notm}} organizations when you have people working on different business areas and where their activities do not overlap. If there are two completely independent groups, then creating an organization for each defines clear boundaries for the delivery and management of team players and resources. You can define an API to communicate between the organizations. + +{{site.data.keyword.Bluemix_notm}} organizations can be created to match how you want to work rather than the structure within a company. Typically, company organizations can change but the development and maintenance of an application will continue regardless. +Design your {{site.data.keyword.Bluemix_notm}} environment for the lifetime of the applications and not on your company organization structure. + +Iterative development and deployment can result in applications expanding quickly. Your delivery process design must be able to scale up quickly and easily. You will want continuous development with a fast deployment rate. Having your development and production spaces in the same {{site.data.keyword.Bluemix_notm}} organization will provide access to the same resources. Managing different spaces within a single organization reduces the administration overhead. The development, test, and operations personnel can collaborate easily if they are working within the same {{site.data.keyword.Bluemix_notm}} organization. + +Implement a naming standard to clearly identify the organization and space usage. For example, you might include the type of cloud, the geographical region, the usage type (such as dev, test, prod), the application name, and the version or revision number. The organizations and spaces can then be easily identified for administration and access purposes. + +The number of spaces can multiply rapidly because of iterative development. You can define as many spaces as you need within an organization. If you plan to define a large number of spaces, you might want to create an application to help manage the spaces. When the number of spaces exceeds sixty, you might want to consider defining another organization. + +Have one person create and manage an organization, define the spaces, and grant team member access. A second person can be given the same access to maintain the environment when the organization manager is unavailable. + +Identify all of the people who will need access to each space and organization. Determine their role. The job role of a team member will determine their authority. For example, a senior developer will need the authority to view and update the whole {{site.data.keyword.Bluemix_notm}} development environment. However, a junior developer will be limited as to what they can view and update. + +## Determining your organization architecture +{: #orgstructure} + +To design a cloud environment that uses {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, {{site.data.keyword.Bluemix_notm}} Local, or any combination, you can use the following organization architectures: + +* Single-organization: Consider using this architecture if you require the same set of users to access resources that are available anywhere in the organization either in {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, or {{site.data.keyword.Bluemix_notm}} Local. +* Multi-organization: Consider using this architecture if you require isolation between different environments within {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, or {{site.data.keyword.Bluemix_notm}} Local. + +### Single-organization versus multi-organization +{: #singleormulti} + +In a single-organization environment, the infrastructure resources are shared by different areas of +the company. Whereas, in a multi-organization environment the infrastructure resources are not shared. + +Both organization architectures support the following priciples: + +* Boundary enforcement for applications, projects, or both. +* Authorization to manage resources granted by user role. + +To implement a single-organization architecture, create an account in {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, or +{{site.data.keyword.Bluemix_notm}} Local, and define one organization. You can then define multiple spaces that are based on different lines of business (LOB), +the delivery phases, specific projects, applications, user permisisons, or a combination of these components. + +To implement a multi-organization architecture, create an account in {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, +or {{site.data.keyword.Bluemix_notm}} Local. Next, you can define organizations that correspond to different LOBs, delivery phases, +specific projects, user permisisons, or a combination of these components. You can then define multiple spaces that are based on applications or projects that are delivered by the same department in the company. + +**Note:** You must have a billable account, such as Pay-As-You-Go or Subscription, to define multiple organizations. + +### Organization considerations +{: #orgconsiderations} + +When you implement a single-organization architecture, the organization includes all of the cloud resources, services, and applications that you use to develop, manage, and +deploy cloud applications. In {{site.data.keyword.Bluemix_notm}} Public, the organization provides segregation between accounts and is available across all regions. + + ![Figure that shows the single-organization architecture in {{site.data.keyword.Bluemix_notm}}](images/singleorg_example.svg "Figure that shows the single-organization architecture in {{site.data.keyword.Bluemix_notm}}") + + Figure 1. Example of a single-organization architecture for {{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, and + {{site.data.keyword.Bluemix_notm}} Local +{: #bpfigure1} + +When you implement a multi-organization architecture, organizations provide the first level of boundary enforcement and abstraction that you can use to control and define what can be +done and by whom. Design each organization around the different LOBs, the delivery phases, the roles of the users, specific projects, or a combination of these components. + +The number of organizations that you require depends on multiple factors: + +* The level of granularity that you require within your organization to manage quotas and control costs. +* The level of security that you must enforce in your different environments. For example, if you are using containers, you might want to segregate container images that are used for development from the container images that are used for production. +* The location of the organizations due to corporate, country, and industry requirements. For example, you might want to run all of your apps in a dedicated cloud that is located in a specific region in your geography (geo). + +When you are defining the different organizations for your cloud structure, consider the following guidance: + +* Define and then enforce a naming convention. For example, define a naming convention where the name of the organization includes information about the business area, the type of cloud ({{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Local, or {{site.data.keyword.Bluemix_notm}} Dedicated), and the process phase (development, testing, or production). For organizations that are located in {{site.data.keyword.Bluemix_notm}} Public, you might want to add information about the region too. +* Define the restrictions that apply to the organization. For example, define the role of the team members that are going to work in that organization. +* Identify the manager of the organization. +* Identify the area of the business that is allocated to this organization. + +The following scenarios show different approaches that you can adopt when you define the number of {{site.data.keyword.Bluemix_notm}} organizations in a cloud environment: +* **Scenario 1: Segregation of user groups by business application delivery** + + Description: Corporate rules require that the apps of each LOB must be developed, managed, and deployed by users from each LOB. Security must be enforced so that users can access only the apps that are relevant to their part of the business. So, the users work in different business areas, the applications they are working on require access to different {{site.data.keyword.Bluemix_notm}} resources, and there is no activity overlap. + + Solution: You can create an organization for each business application delivery process. For example, one organization for retail banking, and one for investment banking. + + ![Figure that shows segregation of users by business application delivery](images/bank_example.svg "Figure that shows segregation of users by business application delivery") + + Figure 2. Example of a multi-organization architecture aligned to LOB delivery +{: #bpfigure2} + +* **Scenario 2: Segregation based on type of users (internal users, external users)** + + Description: Your company works with different partners and you require clear boundaries between internal and external users. + + Solution: You can create an organization to deliver applications that are used internally. In addition, you can create one organization for each external partner. + +* **Scenario 3: Isolation by project** + + Description: Your company runs hackathons to identify new services. + + Solution: You can define one organization per hackathon and use the organization as a sandbox. After the hackathon, you can promote the sandbox organization into an additional organization in your account. + +* **Scenario 4: Isolation of users by delivery phase** + + Description: A company wants development, test, and production users to collaborate across a delivery, but their access is controlled by user role and job experience. + + Solution: You can create a single-organization and define a space for each delivery phase. Then, depending on the user role and job experience, grant the read and write access they require to complete their work and also collaborate within the organization. + + ![Figure that shows isolation of users by delivery phase](images/user_groups_example.svg "Figure that shows isolation of users by delivery phase") + + Figure 3. Example of a single-organization architecture aligned by delivery phase +{: #bpfigure3} + +### Organization naming, restrictions, and management  +{: #orgadmin} + +Consider the following organization guidance: + +* Define and enforce a naming convention. For example, define a naming convention where the name of the organization includes information about the business area, the type of cloud ({{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Local, or {{site.data.keyword.Bluemix_notm}} Dedicated), and the IT role (development, testing, or production). For organizations that are located in {{site.data.keyword.Bluemix_notm}} Public, you might want to add information about the region too. You can change the name of an organization after it is created. If an organization name is altered, notify all of the organization team members about the change. +* Define the restrictions that apply to the organization. For example, define the role of each of the team members and the permissions they need to work in that organization. +* Identify the manager of the organization. You might want to delegate the organization administration to more that one person. +* Identify the area of the business that is allocated to this organization. The application usage that is generated in each of the spaces, within the organization, is accumulated and reported at the organization level. + +## Determining your spaces +{: #determinespaces} + +Within an organization, spaces provide an additional level of boundary enforcement and abstraction. + +A space is a reserved area in the organization where users can develop and run applications and services. You can create any number of spaces in an organization. +You can control the users that have access to a space. For more information, see [Spaces](/docs/admin/orgs_spaces.html#spaceinfo "Spaces"). + +If you plan to define a large number of spaces, you might want to create an application to help manage the spaces. When the number of +spaces exceeds sixty, you might want to consider defining another organization. + +### Spaces for single-organization versus multi-organization +{: #spaceconsiderations} + +When you adopt a single-organization architecture, the level of segregation and abstraction is provided by the spaces that you define within the organization. Consider the following guidance when you define spaces: + +* Define a space to host a service that requires provisioning and configuring only once in the organization. +* Define spaces based on the delivery lifecycle. + For example, you can define one or more spaces for applications that are being developed, one or more spaces for applications that are in the test phase, and one or more + spaces for applications that are in production. +* If the delivery lifecycle boundary is not sufficient, you can achieve more segregation by defining one or more spaces per LOB and delivery phase. +* Identify if you need to enforce boundaries for different users groups. + For example, your developers cannot develop the application and test it. You require a different set of users to test the application. In this scenario, you create two spaces, one for + developers of the application and one for testers of the application. Then grant each set of users access to the correct space. + +When you implement a multi-organization architecture, you can segregate each organization by the LOB, the delivery lifecycle, or both. You can then define +multiple spaces, which are based on the number of applications or projects that are delivered by the same department in the company. Consider the following guidance when you plan the spaces in an organization: + +* Define a space to host a service that requires provisioning and configuring only once in the organization. +* Define a space per application, per group of related applications, or for a specific project. +* If you need to enforce boundaries for different users, define a space for each set of users. When a user is granted a developer role in a space, that user has full access to any resources and {{site.data.keyword.Bluemix_notm}} services) that are provisioned and running in that space. When you need to enforce tighter security to prevent users controlling every resource, consider defining different spaces. Within any of these spaces, you can provison {{site.data.keyword.Bluemix_notm}} services that are used by the apps running in that space. + +### Space naming, restrictions, and management +{: #spaceadmin} + +To define the different spaces for your cloud organization, consider the following guidance: + +* Define and enforce a naming convention. For example, define a naming convention where the space name includes information about where the organization is located and the type of cloud ({{site.data.keyword.Bluemix_notm}} Public, {{site.data.keyword.Bluemix_notm}} Dedicated, or {{site.data.keyword.Bluemix_notm}} Local). You can change the name of a space after it is created. If a space name is altered, notify all of the space team members about the change. +* Define the restrictions that apply to the space. For example, define the type of applications that can be developed, managed, and deployed in each space. +* Identify the manager of the space. You might want to delegate the space administration to more than one person. + +## Determining quota for an organization +{: #determinequota} + +When you create an organization in {{site.data.keyword.Bluemix_notm}}, you provision infrastructure resources that include resources such as memory, Internet Protocol (IP), servers, and storage: +* For {{site.data.keyword.Bluemix_notm}} Public, a minimum set of resources is allocated by IBM to an organization. Based on the type of account, you have different resource allocations. These resources define the quota that is allocated by IBM to an organization. +* For {{site.data.keyword.Bluemix_notm}} Dedicated, you request a set of resources from IBM, and then you can distribute them between the different organizations in your {{site.data.keyword.Bluemix_notm}} Dedicated cloud environment. +* For {{site.data.keyword.Bluemix_notm}} Local, you provide the resources and then you can distribute them between organizations in your {{site.data.keyword.Bluemix_notm}} Local cloud environment. + +For {{site.data.keyword.Bluemix_notm}} Public and {{site.data.keyword.Bluemix_notm}} Dedicated, you can request additional resources from IBM. For +{{site.data.keyword.Bluemix_notm}} Local, you are responsible for providing any resources that might be required to run your business in the local cloud. + +The quota that is allocated to an organization represents the resources that are available within the organization. You manage the quota and you decide how the resources are distributed across the organization. + +### Managing and monitoring quota +{: #managequota} + +You manage and monitor the quota of an account by space and by infrastructure. Any resource that is provisioned in a space and is then used by the deployed application consumes a portion of the quota available to the organization. +* For more information about how to view and manage the quota of an organization in {{site.data.keyword.Bluemix_notm}} Public, see [Managing quota](/docs/admin/orgs_spaces.html#managequota "Managing quota"). +* For more information about how to view and manage the quota of an organization in {{site.data.keyword.Bluemix_notm}} Dedicated or {{site.data.keyword.Bluemix_notm}} local, see [Viewing usage and reports](/docs/admin/index.html?pos=2#oc_resource "Viewing usage and reports"). + +## Assigning roles +{: #roles} + +You can grant multiple roles to team members in a {{site.data.keyword.Bluemix_notm}} account. These roles define the permissions of the user to manage account and organization resources: +* You can grant [user roles](/docs/admin/users_roles.html#userrolesinfo "user roles" ) to members of an organization. These roles define the level of access within the organization, and restrict who can access a space and its resources. For example, you can grant users different permissions to different spaces. +* In {{site.data.keyword.Bluemix_notm}} Dedicated and {{site.data.keyword.Bluemix_notm}} Local only, you can grant [administrative roles](/docs/admin/index.html#oc_useradmin "administrative roles" ) to members of an account to manage system information, usage of account resources, reports and logs, catalog services, users, and resource usage per organization. + +### Account owner +{: #accountowner} + +Whether you design a multi-organization architecture or a single-organization architecture, the account owner is the super user of the cloud environment. + +The account owner core tasks include: + +* Managing the resources of the global account. +* Creating organizations. +* Adding team members to the account. + +To add team members to an account, use the email address of the user or a list of email addresses. In {{site.data.keyword.Bluemix_notm}} Dedicated and {{site.data.keyword.Bluemix_notm}} +Local, you can also use the company LDAP to add users, groups of users, or both. You can also import users from a file. For more information, see [Managing users and permissions](/docs/admin/index.html#oc_useradmin "Managing users and permissions"). + +The account owner can also perform the following tasks: + +* Add one or more users as managers of an organization by assigning these users the **Manager** role. Consider adding two users as organization managers. The first user acts as the principal manager of the organization. The second user acts as the deputy manager, in case, the principal manager is unavailable. +* In {{site.data.keyword.Bluemix_notm}} Public, and depending on the [account type](/docs/pricing/index.html#pay-accounts "account type"), setting spending notifications. First, the account owner defines the thresholds that are used to alert him when costs reach a certain limit. Then, [configures email notifications](/docs/admin/account.html#notifications "configures email notifications"). The account manager can use the information in the emails as alert notifications and might take action based on the information provided, for example upgrading the account. **Note:** The account owner is the only person that can receive spending notification emails. +* Add one or more users as administrators of the account by assigning these users the **Admin** role. Consider adding a minimum of two users. The first user acts as the principal administrator of the account. The second user acts as the deputy administrator. +* Define the account notifications to inform about maintenance updates or critical incident alerts. These notifications can be configured to send an email or a Short Message Service. + +### User roles +{: #userroles} + +User roles define the permissions that you can assign to a team member in an organization and define the level of access that a team member has within the organization and each space. + +In a multi-organization architecture or in a single-organization architecture, define the team members and the permissions that each user requires to complete their work: + +1. Identify the set of users that require access to an organization. +2. Define the permissions for each team member in the organization and in a space of the organization. +3. Select the role that grants a user the permissions they require. + + * Organization manager + * Organization auditor + * Organization billing manager + * Space manager + * Space developer + * Space auditor + +#### Organization manager +{: #bporgmgr} + +The tasks that an organization manager is responsible for includes creating spaces, distributing the quota between the spaces, inviting team members and optionally granting them specific roles, and defining custom domains. + +#### Organization auditor +{: #bporgauditor} + +The team members with the organization **Auditor** role can monitor the quota, the resource usage, and the team members for all of the spaces in an organization. +The auditors can then report on the organization efficiency and highlight any potential problems. + +* When you adopt a multi-organization architecture, you might want to grant the auditor role to the same team members for every organization that is part of the account. +Then, these team members can monitor the quota across all of the organizations in your cloud environment and obtain a global view of the account. +* When you adopt a single-organization architecture, grant the auditor role to the team members with the responsibility for monitoring the quota usage and overall efficiency +of the organization. + +#### Organization billing manager +{: #bporgbillingmgr} + +The team members with the **Billing Manager** role can monitor the costs of an organization. + +* When you adopt a multi-organization architecture, you might want to grant the billing role to the same set of team members for every organization that is part of the account. Then, these team members can then monitor the cost of each organization and obtain a global view of the account. +* In a single-organization architecture, identify the users that are responsible for monitoring the cost. + +#### Space manager +{: #bpspacemgr} + +The space **Manager** is responsible for any work that is done within the space that they manage and control. The space manager can perform the following tasks: + +* Monitoring the quota that is allocated to the space. +* Requesting additional resources to the organization manager. +* Notifying the organization manager of resources that are not required. +* Addind team members to the space with the **Developer** role. +* Optionally, assigning the space **Manager** role to a team member to act as a deputy space manager in their absence. + +#### Space developer +{: #bpspacedev} + +A space developer can do the following tasks: + +* Manage Cloud Foundry applications. +* Provision and configure {{site.data.keyword.Bluemix_notm}} services. +* Associate domains to applications. + +#### Space auditor +{: #bpspaceauditor} + +For every space, you might want to grant the space **Auditor** role to the same team members with the organization **Auditor** role. In your enterprise, this role might have to be granted to a specific set of users. + +### Administrative roles +{: #adminroles} + +[Administrative roles](/docs/admin/index.html#oc_useradmin "Administrative roles" ) define the permissions that you can grant to users to manage a {{site.data.keyword.Bluemix_notm}} Dedicated or a {{site.data.keyword.Bluemix_notm}} Local account. +You can grant read or write permissions to allow a user to view system information, usage of the account resources, reports and logs, catalog services, users, and resource usage per organization. + +In a multi-organization architecture or in a single-organization architecture, define the users and the permissions that each user requires to manage the account: + +1. Identify the set of administration cloud team users and fgrant them the relevant administration permissions. Include the organization managers as members of this team. +2. Define the permissions for these users in the account. Divide permissions to manage the catalog and reports between users of the team. +3. Select one or more roles for each user to match the permissions required to manage the account: + + * Admin role: Grant this role to two or more users in the account. Users with this role have the authority to manage the entire organization. + * User role: This role can be configured with read or write permissions. Grant this role with write permissions to managers of organizations to allow them to add users to the account and their organizations. Grant this role with read permissions to managers of organizations that might need access to see the list of members in the account. + * Catalog role: This role can be configured with read or write permissions. Grant this role to a set of users with write permissions to allow them to define and manage which Bluemix services and starters are visible to users in the {{site.data.keyword.Bluemix_notm}} Catalog. Grant this role with read permissions to managers of organizations. + * Reports role: This role can be configured with read or write permissions. Grant this role to a set of users with write permissions to allow them to view and add reports that other users with read permissions can download. Grant read permissions to all members of the admin team. + * Login role: Grant this role to all members of the admin team. You can also grant this role to other users in the account that require access to view the account notifications and system information. diff --git a/cfapps/nl/es/hostingapps.md b/cfapps/nl/es/hostingapps.md index 7c11cb599..2e4b2f5ce 100644 --- a/cfapps/nl/es/hostingapps.md +++ b/cfapps/nl/es/hostingapps.md @@ -15,14 +15,14 @@ lastupdated: "2016-05-09" {:codeblock: .codeblock} {:screen: .screen} -#Alojamiento de apps en {{site.data.keyword.Bluemix_notm}} +# Alojamiento de apps en {{site.data.keyword.Bluemix_notm}} Con {{site.data.keyword.Bluemix}}, puede crear apps, así como alojar sus apps existentes. Puede migrar sus apps a {{site.data.keyword.Bluemix_notm}} siempre que estén preparadas para la nube. {{site.data.keyword.Bluemix_notm}} proporciona distintos modos para ejecutar las apps, como por ejemplo Cloud Foundry, IBM Containers y Virtual Machines. -##Haciendo que sus apps estén listas para la nube +## Haciendo que sus apps estén listas para la nube {: #cloud-readyapps} Una app lista para la nube sigue los principios de la plataforma de nube en su diseño y construcción. Una app lista para la nube puede utilizar las prestaciones proporcionadas por la plataforma de nube. @@ -79,7 +79,7 @@ Si su app cumple todos los principios siguientes, será una app lista para la nu Para obtener más información sobre aplicaciones listas para la nube, consulte [The 12-factor application ![icono de enlace externo](../icons/launch-glyph.svg)](http://12factor.net/){: new_window}. -##Migración de sus apps +## Migración de sus apps {: #ht_hostapp} Puede migrar sus apps a {{site.data.keyword.Bluemix_notm}} de forma incremental, en lugar de desplazarla completamente al entorno de nube. Primero puede migrar una parte de sus apps y conectar a los datos existentes o sistema de registros mediante el servicio Cloud integration. @@ -101,7 +101,7 @@ Puede utilizar las herramientas y servicios siguientes que {{site.data.keyword.B Si la plataforma Cloud Foundry no admite los requisitos de su app, puede utilizar un contenedor o MV en la que el tiempo de ejecución se establezca, configure y mantenga con opciones más personalizadas. -##Subir sus apps mediante la CLI de cf +## Subir sus apps mediante la CLI de cf {: #ht_cfcli} Puede gestionar su código en el cliente local y utilizar la interfaz de línea de mandatos de Cloud Foundry para subir su app manualmente a {{site.data.keyword.Bluemix_notm}}. Si cambia el código, debe enviar por push su app otra vez a {{site.data.keyword.Bluemix_notm}} para ejecutar el código actualizado. @@ -156,7 +156,7 @@ Realice los pasos siguientes para migrar su app: * Asegúrese de que su organización dispone de memoria suficiente para todas las instancias de su app. Para ver la cuota de memoria para su organización, utilice cf org org_name. * Para obtener más información sobre cf push, consulte [Mandatos cf](/docs/cli/reference/cfcommands/index.html). -##Migración de sus datos y uso de servicios +## Migración de sus datos y uso de servicios {: #ht_service} Tras subir su app a {{site.data.keyword.Bluemix_notm}}, seleccione en el Catálogo de {{site.data.keyword.Bluemix_notm}} el servicio al que está conectado su app, cree una instancia de servicio, enlace la instancia a su app y luego reinicie su app. diff --git a/cfapps/nl/fr/hostingapps.md b/cfapps/nl/fr/hostingapps.md index 830f6e8c9..1801de009 100644 --- a/cfapps/nl/fr/hostingapps.md +++ b/cfapps/nl/fr/hostingapps.md @@ -15,7 +15,7 @@ lastupdated: "2016-05-09" {:codeblock: .codeblock} {:screen: .screen} -#Hébergement d'applications dans {{site.data.keyword.Bluemix_notm}} +# Hébergement d'applications dans {{site.data.keyword.Bluemix_notm}} @@ -24,7 +24,7 @@ applications existantes. Vous pouvez migrer vos applications dans {{site.data.ke qu'elles soient prêtes pour le cloud. {{site.data.keyword.Bluemix_notm}} vous propose plusieurs manières d'exécuter vos applications, par exemple avec Cloud Foundry, IBM Containers et Virtual Machines. -##Rendre vos applications prêtes pour le cloud +## Rendre vos applications prêtes pour le cloud {: #cloud-readyapps} Pour qu'une application soit prête pour le cloud, vous devez respecter les principes de la plateforme de cloud lors de la conception et de la @@ -108,7 +108,7 @@ Pour plus d'informations sur les applications prêtes pour le cloud, voir [The 12-factor application ![icône de lien externe](../icons/launch-glyph.svg)](http://12factor.net/){: new_window}. -##Migration de vos applications +## Migration de vos applications {: #ht_hostapp} Vous pouvez migrer vos applications dans {{site.data.keyword.Bluemix_notm}} de manière incrémentielle @@ -138,7 +138,7 @@ Vous pouvez utiliser les outils et les services suivants mis à disposition par Si la plateforme Cloud Foundry ne prend pas en charge les exigences relatives à votre application, vous pouvez utiliser un conteneur ou une machine virtuelle où le contexte d'exécution est défini, configuré et géré avec des options personnalisées supplémentaires. -##Téléchargement de votre applications avec cf cli +## Téléchargement de votre applications avec cf cli {: #ht_cfcli} Vous pouvez gérer votre code sur le client local et utiliser l'interface de ligne de commande Cloud @@ -204,7 +204,7 @@ travail dans {{site.data.keyword.Bluemix_notm}}. Assurez-vous que votre réperto mémoire de votre organisation, utilisez cf org nom_organisation. * Pour plus d'informations sur cf push, voir [Commandes cf](/docs/cli/reference/cfcommands/index.html). -##Migration de vos données et utilisation des services +## Migration de vos données et utilisation des services {: #ht_service} Après avoir téléchargé votre application dans diff --git a/cfapps/nl/it/boilerplates.md b/cfapps/nl/it/boilerplates.md index a43058f08..e31d63326 100644 --- a/cfapps/nl/it/boilerplates.md +++ b/cfapps/nl/it/boilerplates.md @@ -1,21 +1,21 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2015-11-11" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# Contenitori tipo - -In {{site.data.keyword.Bluemix}}, un -contenitore tipo è un contenitore per un'applicazione e il -suo ambiente di runtime associato e i servizi predefiniti per uno specifico dominio. Puoi usare un contenitore tipo per essere operativo in pochissimo tempo. -{:shortdesc} +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2015-11-11" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# Contenitori tipo + +In {{site.data.keyword.Bluemix}}, un +contenitore tipo è un contenitore per un'applicazione e il +suo ambiente di runtime associato e i servizi predefiniti per uno specifico dominio. Puoi usare un contenitore tipo per essere operativo in pochissimo tempo. +{:shortdesc} diff --git a/cfapps/nl/it/byob.md b/cfapps/nl/it/byob.md index 7553ce65b..c4099bed4 100644 --- a/cfapps/nl/it/byob.md +++ b/cfapps/nl/it/byob.md @@ -1,115 +1,115 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2016-03-15" - - - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:pre: .pre} - -# Utilizzo dei pacchetti di build della community - -Se non riesci a trovare uno starter nel Catalogo {{site.data.keyword.Bluemix}} che ti fornisca il runtime desiderato, puoi portare tu un pacchetto di build esterno in {{site.data.keyword.Bluemix_notm}}. Puoi specificare un pacchetto di build personalizzato compatibile con Cloud Foundry quando distribuisci la tua applicazione utilizzando il comando cf push. -{:shortdesc} - -I pacchetti di build esterni sono forniti dalla community di Cloud Foundry -e puoi usarli come tuoi pacchetti di build. Prima di -distribuire la tua applicazione a {{site.data.keyword.Bluemix_notm}}, -assicurati di installare l'interfaccia riga di comando cf. - -**Nota:** i pacchetti di build esterni non sono forniti da IBM; pertanto, potresti dover contattare la community Cloud Foundry per assistenza. - -## Pacchetti di build della community integrati - -In {{site.data.keyword.Bluemix_notm}}, -puoi utilizzare i pacchetti di build integrati forniti dalla community di -Cloud Foundry. Per visualizzare i pacchetti di build integrati della community, esegui il comando cf buildpacks: - -``` -cf buildpacks -Getting buildpacks... - -buildpack position enabled locked filename -... -java_buildpack 7 true false buildpack_java_v2.0.2.zip -ruby_buildpack 8 true false buildpack_ruby_v46-245-g2fc4ad8.zip -nodejs_buildpack 9 true false buildpack_nodejs_v8-177-g2b0a5cf.zip -``` -{:screen} - -
    - -
  • -Per lo stesso runtime o framework, i pacchetti di build creati da IBM hanno la precedenza su quelli della community. Se vuoi usare il pacchetto di build della community per sovrascrivere quello creato da IBM, devi specificare il pacchetto di build utilizzando l'opzione -b con il comando cf push. -

    Ad esempio, puoi usare il pacchetto di build della community per le applicazioni Web Java™:

    -
    cf push app_name -b java_buildpack -p app_path
    -

    Puoi anche usare il pacchetto di build della community per le applicazioni Node.js:

    -
    cf push app_name -b nodejs_buildpack -p app_path
    -
    • - -
  • -

    Per un runtime o un framework non supportato da pacchetti di build creati da IBM ma supportato da pacchetti di build della community integrati, non devi necessariamente utilizzare l'opzione -b con il comando cf push.

    Ad esempio, per le applicazioni Ruby, non ci sono pacchetti di build creati da IBM. Puoi usare il pacchetto di build della community integrato immettendo il -seguente comando:

    -
    cf push app_name -p app_path
    -
    • -
- -## Pacchetti di build esterni - -Puoi utilizzare pacchetti di build esterni o personalizzati in {{site.data.keyword.Bluemix_notm}}. Devi specificare l'URL del pacchetto di build con l'opzione -b e specificare lo stack con l'opzione `-s` nel comando **cf push**. Ad esempio, per utilizzare un pacchetto di build della community esterno per i file statici, esegui questo comando - -``` -cf push app_name -p app_path -b https://github.com/cloudfoundry-incubator/staticfile-buildpack.git -s cflinuxfs2 -``` -{:pre} - -Come altro -esempio, se non desideri utilizzare il pacchetto di build della community integrato -per le applicazioni Ruby, puoi utilizzare un pacchetto di build esterno immettendo il seguente -comando: - -``` -cf push app_name -p app_path -b https://github.com/cloudfoundry/heroku-buildpack-ruby -s cflinuxfs2 -``` -{:pre} - -Puoi anche utilizzare un pacchetto di build personalizzato per la tua applicazione. Ad esempio, per utilizzare un pacchetto di build PHP open source fornito dalla community di Cloud Foundry, quando distribuisci la tua applicazione PHP a Bluemix, immetti il seguente comando per specificare l'URL del repository Git del pacchetto di build: - -``` -cf push app_name -p app_path -b https://github.com/dmikusa-pivotal/cf-php-build-pack -s cflinuxfs2 -``` -{:pre} - -È anche possibile modificare il file `manifest.yml` del tuo progetto per aggiungere una riga `buildpack`: - -``` -buildpack: https://github.com/cloudfoundry/python-buildpack.git -``` -{:pre} - - -## Specifica della versione del pacchetto di build Java - -
    -
  • -Utilizza il comando cf set-env. Ad esempio, immetti il seguente comando per impostare la versione Java su 1.7.0: -
    cf set-env app_name JBP_CONFIG_OPEN_JDK_JRE '{jre: { version: 1.7.0_+ }}'
    -

    Quindi, per rendere effettive -le modifiche, prepara di nuovo la tua applicazione:

    -
    cf restage app_name
    -
    • -
  • -Utilizza il file manifest.yml. Puoi aggiungere la -variabile di ambiente e il valore che vuoi specificare direttamente -nel file. Per informazioni dettagliate, vedi Variabili di ambiente.
+--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2016-03-15" + + + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:pre: .pre} + +# Utilizzo dei pacchetti di build della community + +Se non riesci a trovare uno starter nel Catalogo {{site.data.keyword.Bluemix}} che ti fornisca il runtime desiderato, puoi portare tu un pacchetto di build esterno in {{site.data.keyword.Bluemix_notm}}. Puoi specificare un pacchetto di build personalizzato compatibile con Cloud Foundry quando distribuisci la tua applicazione utilizzando il comando cf push. +{:shortdesc} + +I pacchetti di build esterni sono forniti dalla community di Cloud Foundry +e puoi usarli come tuoi pacchetti di build. Prima di +distribuire la tua applicazione a {{site.data.keyword.Bluemix_notm}}, +assicurati di installare l'interfaccia riga di comando cf. + +**Nota:** i pacchetti di build esterni non sono forniti da IBM; pertanto, potresti dover contattare la community Cloud Foundry per assistenza. + +## Pacchetti di build della community integrati + +In {{site.data.keyword.Bluemix_notm}}, +puoi utilizzare i pacchetti di build integrati forniti dalla community di +Cloud Foundry. Per visualizzare i pacchetti di build integrati della community, esegui il comando cf buildpacks: + +``` +cf buildpacks +Getting buildpacks... + +buildpack position enabled locked filename +... +java_buildpack 7 true false buildpack_java_v2.0.2.zip +ruby_buildpack 8 true false buildpack_ruby_v46-245-g2fc4ad8.zip +nodejs_buildpack 9 true false buildpack_nodejs_v8-177-g2b0a5cf.zip +``` +{:screen} + +
    + +
  • +Per lo stesso runtime o framework, i pacchetti di build creati da IBM hanno la precedenza su quelli della community. Se vuoi usare il pacchetto di build della community per sovrascrivere quello creato da IBM, devi specificare il pacchetto di build utilizzando l'opzione -b con il comando cf push. +

    Ad esempio, puoi usare il pacchetto di build della community per le applicazioni Web Java™:

    +
    cf push app_name -b java_buildpack -p app_path
    +

    Puoi anche usare il pacchetto di build della community per le applicazioni Node.js:

    +
    cf push app_name -b nodejs_buildpack -p app_path
    +
    • + +
  • +

    Per un runtime o un framework non supportato da pacchetti di build creati da IBM ma supportato da pacchetti di build della community integrati, non devi necessariamente utilizzare l'opzione -b con il comando cf push.

    Ad esempio, per le applicazioni Ruby, non ci sono pacchetti di build creati da IBM. Puoi usare il pacchetto di build della community integrato immettendo il +seguente comando:

    +
    cf push app_name -p app_path
    +
    • +
+ +## Pacchetti di build esterni + +Puoi utilizzare pacchetti di build esterni o personalizzati in {{site.data.keyword.Bluemix_notm}}. Devi specificare l'URL del pacchetto di build con l'opzione -b e specificare lo stack con l'opzione `-s` nel comando **cf push**. Ad esempio, per utilizzare un pacchetto di build della community esterno per i file statici, esegui questo comando + +``` +cf push app_name -p app_path -b https://github.com/cloudfoundry-incubator/staticfile-buildpack.git -s cflinuxfs2 +``` +{:pre} + +Come altro +esempio, se non desideri utilizzare il pacchetto di build della community integrato +per le applicazioni Ruby, puoi utilizzare un pacchetto di build esterno immettendo il seguente +comando: + +``` +cf push app_name -p app_path -b https://github.com/cloudfoundry/heroku-buildpack-ruby -s cflinuxfs2 +``` +{:pre} + +Puoi anche utilizzare un pacchetto di build personalizzato per la tua applicazione. Ad esempio, per utilizzare un pacchetto di build PHP open source fornito dalla community di Cloud Foundry, quando distribuisci la tua applicazione PHP a Bluemix, immetti il seguente comando per specificare l'URL del repository Git del pacchetto di build: + +``` +cf push app_name -p app_path -b https://github.com/dmikusa-pivotal/cf-php-build-pack -s cflinuxfs2 +``` +{:pre} + +È anche possibile modificare il file `manifest.yml` del tuo progetto per aggiungere una riga `buildpack`: + +``` +buildpack: https://github.com/cloudfoundry/python-buildpack.git +``` +{:pre} + + +## Specifica della versione del pacchetto di build Java + +
    +
  • +Utilizza il comando cf set-env. Ad esempio, immetti il seguente comando per impostare la versione Java su 1.7.0: +
    cf set-env app_name JBP_CONFIG_OPEN_JDK_JRE '{jre: { version: 1.7.0_+ }}'
    +

    Quindi, per rendere effettive +le modifiche, prepara di nuovo la tua applicazione:

    +
    cf restage app_name
    +
    • +
  • +Utilizza il file manifest.yml. Puoi aggiungere la +variabile di ambiente e il valore che vuoi specificare direttamente +nel file. Per informazioni dettagliate, vedi Variabili di ambiente.
diff --git a/cfapps/nl/it/ee.md b/cfapps/nl/it/ee.md index e3393e883..7ddc8a26f 100644 --- a/cfapps/nl/it/ee.md +++ b/cfapps/nl/it/ee.md @@ -1,326 +1,326 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2017-01-11" - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} -{:codeblock: .codeblock} -{:screen: .screen} - -# Scenario: sviluppo end-to-end -{: #ee} - - -Puoi utilizzare l'interfaccia utente, la piattaforma e una selezione di strumenti {{site.data.keyword.Bluemix}} -per la creazione, esecuzione e -distribuzione delle tue applicazioni. Per iniziare, segui questo scenario di sviluppo -end-to-end. -{:shortdesc} - -## Registrazione -{: #ee_start} - -Prima di iniziare, esegui la registrazione per un ID IBM da [https://console.ng.bluemix.net/ ![icona link esterno](../icons/launch-glyph.svg)](https://console.ng.bluemix.net/){: new_window}. Successivamente, potrai accedere a {{site.data.keyword.Bluemix_notm}} e -iniziare il periodo di prova di 30 giorni. {{site.data.keyword.Bluemix_notm}} fornisce -una franchigia di 2 GB di memoria di runtime e 10 istanze del servizio per la tua prova -gratuita. - -## Creazione della tua applicazione web utilizzando l'interfaccia utente {{site.data.keyword.Bluemix_notm}} -{: #ee_appui} - -Dopo la registrazione, inizia a creare la tua prima applicazione -utilizzando l'interfaccia utente {{site.data.keyword.Bluemix_notm}}. - -In {{site.data.keyword.Bluemix_notm}}, -le applicazioni sono associate a organizzazioni e spazi. Un'organizzazione -appartiene ed è utilizzata da più collaboratori. Inizialmente, ottieni -un'organizzazione predefinita che prende il nome dal tuo nome utente e di cui -sei l'unico collaboratore. All'interno di questa organizzazione ottieni anche uno spazio. Lo spazio è un ambiente per l'esecuzione delle tue applicazioni; ad esempio, puoi -avere uno spazio di sviluppo come un ambiente di sviluppo, uno spazio di test come un ambiente di test -e uno spazio di produzione come un ambiente di produzione. Inoltre, ciascun -ambiente appartiene a una regione. Con {{site.data.keyword.Bluemix_notm}}, -puoi distribuire le applicazioni a una specifica regione geografica -per una bassa latenza di rete, riservatezza dei dati e maggiore disponibilità. Per i dettagli, vedi Regioni. - -Per questo scenario, vuoi distribuire un'applicazione Web che utilizza Node.js. Supponiamo che ti trovi negli Stati Uniti così come la maggior parte degli utenti della -tua applicazione. Decidi di creare ed eseguire la tua applicazione vicino alla base -dei tuoi utenti, in modo da poter usufruire di una più bassa latenza di rete. Dopo che ti sei collegato a {{site.data.keyword.Bluemix_notm}}, fai clic sul link delle preferenze dell'account utente e seleziona la regione **Stati Uniti Sud**. Puoi quindi attenerti alla seguente procedura per creare un'applicazione: - - 1. Vai a **Catalogo** - 2. Seleziona **Runtime Cloud Foundry**. - 3. Seleziona **SDK for Node.js**. - 4. Immetti un nome univoco per la tua applicazione, ad esempio TestNode, e fai clic su **Crea**. Il nome dell'applicazione deve essere univoco -nell'intero ambiente {{site.data.keyword.Bluemix_notm}}. - 5. Fai clic su **Crea**. - -Puoi ora visualizzare le istruzioni **Inizia a scrivere codice**. Puoi seguire le istruzioni per scaricare, modificare e distribuire il codice starter di TestNode. - -All'applicazione viene assegnata 1 istanza e 512 MB di quota di memoria -per impostazione predefinita. Puoi aumentare la memoria o aggiungere più istanze per -garantire la disponibilità elevata della tua applicazione; ad esempio 3 istanze con 1 GB -di memoria per ciascuna istanza. Fai clic su **Visualizza panoramica dell'applicazione** per -specificare le istanze della tua applicazione e la quota di memoria. Ad esempio, immetti 3 per -istanze e 1 GB per quota di memoria e fai clic su **Salva**. Puoi inoltre visualizzare file, log e variabili di ambiente per la risoluzione -dei problemi. - -## Esecuzione del bind di un servizio utilizzando l'interfaccia utente {{site.data.keyword.Bluemix_notm}} -{: #ee_bindui} - -Dopo aver creato la tua applicazione, vuoi utilizzarla per connetterti a un -database. In questo modo, puoi memorizzare ed esaminare i dati di applicazione -utilizzando il linguaggio di query database. In questo scenario, decidi di -utilizzare il servizio {{site.data.keyword.cloudant}} -fornito da {{site.data.keyword.Bluemix_notm}}. - -Per utilizzare i servizi all'interno dell'applicazione, devi creare un'istanza -del servizio ed eseguire il bind della tua applicazione all'istanza del servizio completando -la seguente procedura: - 1. Fai clic su **Aggiungi un servizio o una API** nella pagina Panoramica dell'applicazione. - 2. Nel catalogo {{site.data.keyword.Bluemix_notm}}, seleziona il servizio {{site.data.keyword.cloudant}}. - 3. Immetti un nome univoco per l'istanza del servizio o utilizza il -nome predefinito generato da {{site.data.keyword.Bluemix_notm}}, -quindi fai clic su **Crea**. - 4. Viene visualizzata la finestra Prepara di nuovo applicazione. Fai clic su **Riprepara** per ripreparare la tua applicazione. - -La tua applicazione è ora associata al servizio {{site.data.keyword.cloudant}}. Puoi trovare tutti i dati necessari perché l'applicazione comunichi con l'istanza del servizio nella variabile di ambiente VCAP_SERVICES. Ad esempio, poiché {{site.data.keyword.Bluemix_notm}} -ospita diverse applicazioni sulla stessa macchina virtuale, le applicazioni -non possono utilizzare lo stesso numero di porta HTTP per ricevere le richieste -in entrata. Per evitare conflitti, a ciascuna applicazione viene dato un -numero di porta univoco. Questo numero di porta è disponibile nella variabile di ambiente VCAP_APP_PORT. - -Per ulteriori informazioni, clic su**Variabili di ambiente** nella pagina Panoramica dell'applicazione per visualizzare l'elenco completo di VCAP_SERVICES. -``` -{ - "cloudantNoSQLDB": [ - { - "name": "Cloudant NoSQL DB-tx", - "label": "cloudantNoSQLDB", - "plan": "Shared", - "credentials": { - "username": "d72837bb-b341-4038-9c8e-7f7232916197-bluemix", - "password": "b6fc4708942b70a88853177ee52a528d07a43fa8575a69abeb8e044a7b0a7424", - "host": "d72837bb-b341-4038-9c8e-7f7232916197-bluemix.cloudant.com", - "port": 443, - "url": "https://d72837bb-b341-4038-9c8e-7f7232916197-bluemix:b6fc4708942b70a88853177ee52a528d07a43fa8575a69abeb8e044a7b0a7424@d72837bb-b341-4038-9c8e-7f7232916197-bluemix.cloudant.com" - } - } - ] -} -``` - -**Nota:** questa variabile di ambiente è la serializzazione di un oggetto JSON con una singola voce per ogni istanza del servizio a cui è associata l'applicazione. La quantità e il tipo di dati forniti da ciascuna istanza del servizio -sono specifici per il servizio. Se l'applicazione non utilizza alcun servizio, VCAP_SERVICES è un oggetto JSON vuoto. Questa variabile di ambiente viene utilizzata solo -quando aggiungi un servizio alla tua applicazione. - -## Creazione della tua applicazione utilizzando la CLI cf -{: #ee_cf} - -{{site.data.keyword.Bluemix_notm}} fornisce -diversi strumenti che ti consentono di iniziare a scrivere codice con la tua applicazione, ad esempio l'interfaccia riga di comando cf -e gli strumenti Eclipse. Puoi scegliere l'interfaccia riga di comando cf per iniziare a scrivere codice con la tua applicazione TestNode. - - 1. Innanzitutto, scarica e sviluppa il codice della tua applicazione. - - 1. Vai alla pagina Inizia a scrivere codice dell'applicazione. Fai clic sul pulsante **Scarica codice di starter** per scaricare il codice della tua applicazione. - 2. Estrai il file scaricato in una directory, ad esempio `C:\test`. - 3. Sviluppa il codice con il tuo ambiente di sviluppo -integrato locale. - - 2. Installa l'interfaccia riga di comando **cf** -(CLI). - - 1. Scarica il programma di installazione dello strumento riga di comando cf per il tuo sistema operativo. - 2. Segui la procedura guidata dello strumento per completare l'installazione. - 3. Utilizza il comando **cf -v** per verificare la versione dell'interfaccia riga di comando cf. Ad -esempio: - - ``` - cf -v - ``` - - **Requisito:** assicurati di usare sempre la versione più recente dello strumento riga di comando cf. - 3. Dopo che hai installato l'interfaccia riga di comando **cf**, -devi specificare qual è la regione {{site.data.keyword.Bluemix_notm}} che -desideri gestire utilizzando il comando **cf api**. L'interfaccia riga di comando **cf** utilizza *https://api.Bluemix_URL*, dove *Bluemix_URL* è l'URL della regione. L'URL della regione Stati Uniti sud è stage1.ng.bluemix.net. Immetti il seguente comando per -stabilire una connessione a {{site.data.keyword.Bluemix_notm}}: - - ``` - cf api https://api.ng.bluemix.net - ``` - - Per ulteriori informazioni sulla connessione ad altre regioni {{site.data.keyword.Bluemix_notm}}, vedi Regioni {{site.data.keyword.Bluemix_notm}}. Dopo che hai specificato la regione {{site.data.keyword.Bluemix_notm}}, -le informazioni sull'ubicazione da te specificate vengono salvate. - - 4. Puoi quindi accedere a {{site.data.keyword.Bluemix_notm}} utilizzando il comando cf login. - - ``` - cf login -u your_user_ID -p ***** -o your_org_name -s your_space_name - ``` - - 5. Dopo che hai eseguito l'accesso a {{site.data.keyword.Bluemix_notm}}, -sei pronto a ridistribuire l'applicazione a {{site.data.keyword.Bluemix_notm}}. Dalla directory dell'applicazione `C:\test`, immetti il seguente -comando: - - ``` - cf push TestNode - ``` - - Per ulteriori informazioni sul comando **cf push**, vedi Caricamento della tua applicazione. - - 6. Puoi ora accedere all'applicazione immettendo il seguente URL -in un browser: - ``` - http://TestNode.mybluemix.net - ``` - -Per creare la tua applicazione puoi scegliere anche altri strumenti, ad esempio -gli strumenti Eclipse. Per ulteriori informazioni, consulta la pagina Inizia a scrivere codice della tua applicazione nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. - -## Esecuzione del bind di un servizio utilizzando la CLI cf -{: #ee_cfbind} - -Con {{site.data.keyword.Bluemix_notm}}, -puoi aggiungere un servizio utilizzando l'interfaccia utente Bluemix, come descritto -in precedenza in questo scenario. Tuttavia, puoi anche eseguire il bind di un servizio utilizzando l'interfaccia riga di comando **cf**. Supponiamo che tu voglia aggiungere il servizio {{site.data.keyword.cloudant}} alla tua applicazione TestNode utilizzando l'interfaccia riga di comando cf. - -Per utilizzare il servizio {{site.data.keyword.cloudant}} -all'interno dell'applicazione, devi creare un'istanza del servizio Cloudant, eseguire il bind -della tua applicazione all'istanza del servizio e farne quindi uso. La stessa procedura si applica a tutti gli altri servizi. - - 1. Crea un'istanza del servizio Cloudant NoSQL DB. - - Usa il comando cf create-service per creare una nuova istanza di un servizio. Ad -esempio: - - ``` - cf create-service cloudantNoSQLDB Shared cloudant100 - ``` - - Puoi anche usare il comando cf services per visualizzare l'elenco di istanze del servizio da te create. - - ``` - cf services - ``` - - Dopo essere stata creata, un'istanza del servizio è a disposizione di tutte le -tue applicazioni che possono eseguirne il bind e farne uso. - - 2. Esegui il bind dell'istanza del servizio alla tua applicazione. - - Per utilizzare un'istanza del servizio, devi eseguirne il bind alla -tua applicazione. Usa il comando cf bind-service per eseguire il bind di un'istanza del servizio a un'applicazione specificando il nome applicazione e l'istanza del servizio da te creata. - - ``` - cf bind-service TestNode cloudant100 - ``` - - L'esecuzione del bind di un'istanza del servizio a un'applicazione abilita {{site.data.keyword.Bluemix_notm}} a -comunicare con il servizio e a specificare che una nuova applicazione comunicherà con tale -istanza del servizio. Per servizi differenti, {{site.data.keyword.Bluemix_notm}} può -elaborare l'applicazione e l'istanza del servizio in modo differente, durante il bind. Ad esempio, alcuni servizi possono creare un nuovo -tenant per ciascuna applicazione che comunica con l'istanza del servizio. Il servizio risponde a -sua volta a {{site.data.keyword.Bluemix_notm}} con -delle informazioni, come le credenziali, che devono essere passate all'applicazione -per le comunicazioni tra l'applicazione e il servizio. - - **Nota:** se l'applicazione è in esecuzione quando è associata a un'istanza del servizio, la variabile di ambiente VCAP_SERVICES viene aggiornata solo dopo il riavvio dell'applicazione. Per riavviare la tua applicazione, usa il comando cf restart. - - 3. Usa l'istanza del servizio. - - In questo scenario, la variabile di ambiente VCAP_SERVICES include delle informazioni, come i seguenti elementi, che un'applicazione può utilizzare per stabilire una connessione a questa istanza di {{site.data.keyword.cloudant}}: - -
username
-
d72837bb-b341-4038-9c8e-7f7232916197-bluemix
-
password
-
b6fc4708942b70a88853177ee52a528d07a43fa8575a69abeb8e044a7b0a7424
-
url
-
https://d72837bb-b341-4038-9c8e-7f7232916197-bluemix:b6fc4708942b70a88853177ee52a528d07a43fa8575a69abeb8e044a7b0a7424@d72837bb-b341-4038-9c8e-7f7232916197-bluemix.cloudant.com
- - Ad esempio, la tua applicazione Node.js potrebbe accedere a queste -informazioni nel seguente modo: - ``` - if (process.env.VCAP_SERVICES) { - var env = JSON.parse(process.env.VCAP_SERVICES); - var cloudant = env['cloudantNoSQLDB'][0].credentials; - } else { - var cloudant = { - "username" : "user1", - "password" : "secret", - "url" : "https://user1:secret@localhost:25002" - } - }; - ``` - - **Nota:** come mostrato dal codice di esempio, per stabilire una connessione a un'istanza del servizio {{site.data.keyword.cloudant}}, puoi prima controllare se la variabile di ambiente VCAP_SERVICES esiste. Se esiste, l'applicazione può utilizzare le proprietà della variabile cloudant per accedere al database. Tuttavia, se la variabile di ambiente VCAP_SERVICES non è presente, l'istanza del servizio {{site.data.keyword.cloudant}} locale viene utilizza valori predefiniti forniti. - - 4. Interagisci con l'istanza del servizio. - - Puoi interagire con l'istanza del servizio utilizzando le informazioni delle credenziali. Le azioni che puoi eseguire includono la lettura, la scrittura e l'aggiornamento. Il -seguente esempio illustra come inserire un oggetto JSON nell'istanza del servizio -{{site.data.keyword.cloudant}}: - ``` - // create a new message -var create_message = function(req, res) { - require('cloudantdb').connect(cloudant.url, function(err, conn) { - var collection = conn.collection('messages'); - - // create message record - var parsedUrl = require('url').parse(req.url, true); - var queryObject = parsedUrl.query; - var name = (queryObject["name"] || 'Bluemix'); - var message = { 'message': 'Hello, ' + name, 'ts': new Date() -}; - collection.insert(message, {safe:true}, function(err){ - if (err) { console.log(err.stack); } - res.writeHead(200, {'Content-Type': 'text/plain'}); - res.write(JSON.stringify(message)); - res.end('\n'); - }); - }); -} - ``` - - 5. **Facoltativo:** annulla il bind di un'istanza del servizio oppure eliminala. - - È possibile che tu voglia annullare il bind di un'istanza del servizio oppure eliminarla qualora -non sia più utilizzata o per liberare dello spazio. Per annullare il bind di un'istanza del servizio alla tua applicazione, usa il **comando cf unbind-service**; per eliminare un'istanza del servizio, usa il comando **cf delete-service**. - - Per ulteriori informazioni sui servizi, vedi Servizi. Per ulteriori informazioni sulle opzioni **cf** che puoi utilizzare per gestire le tue applicazioni nell'ambiente {{site.data.keyword.Bluemix_notm}}, immetti il comando **cf --help** nell'interfaccia riga di comando **cf**. - - **Nota:** assicurati di non avere più bisogno di un'istanza del servizio, prima di eliminarla. L'eliminazione di un'istanza del servizio elimina tutti i dati a essa associati. È possibile aggiornare la variabile di ambiente VCAP_SERVICES di un'applicazione associata a un servizio eliminato solo dopo il riavvio dell'applicazione. - -## Calcolo del costo della tua applicazione -{: #ee_billing} - -Il tuo periodo di prova gratuito di 30 giorni è scaduto ma vuoi continuare -a utilizzare {{site.data.keyword.Bluemix_notm}}. Per continuare a utilizzare {{site.data.keyword.Bluemix_notm}} -dovrai aggiungere le informazioni della tua carta di credito per un account Pagamento a consumo o per un account Sottoscrizione. Tuttavia, {{site.data.keyword.Bluemix_notm}} continua a offrire una franchigia per la -maggior parte dei servizi e dei framework di runtime anche se passi a un account a pagamento. {{site.data.keyword.Bluemix_notm}} -non ti addebita niente a meno che l'utilizzo non superi le franchigie concesse. - -{{site.data.keyword.Bluemix_notm}} fornisce -una funzione di stima e un calcolatore per consentirti di visualizzare il costo della tua applicazione. Puoi visualizzare il costo di TestNode nei seguenti modi: - - * Nel tuo dashboard, fai clic su TestNode. Quindi, nella pagina Panoramica, fai clic su **Stima il costo di questa applicazione** per vedere il prezzo del runtime e del supporto **SDK for Node.js** e il prezzo totale mensile della tua applicazione. - - * In alternativa, nella pagina Listino prezzi, immetti l'utilizzo mensile del runtime e dei servizi della tua applicazione. d esempio 3 istanze di **SDK for Node.js** con 1 GB di memoria per ciascuna istanza. Il prezzo mensile viene calcolato e visualizzato. - -Puoi anche calcolare il costo della tua applicazione manualmente sommando i prezzi dei tuoi runtime e servizi -e sottraendo la franchigia. Per ulteriori informazioni, vedi Calcolo manuale dei tuoi costi. - -## Rimozione di applicazioni -{: #ee_removing} - -Man mano che crei ulteriori applicazioni, la quota potrebbe avvicinarsi al limite. Tuttavia, delle applicazioni -che tu potresti non utilizzare più continuano a consumare una parte della quota. È facile eliminare delle applicazioni per liberare dello -spazio in {{site.data.keyword.Bluemix_notm}} in qualsiasi momento. - -Nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}, vai alla pagina Panoramica dell'applicazione, fai clic sull'icona **Menu** ed elimina l'applicazione che non utilizzi più. Per eliminare le applicazioni puoi anche utilizzare il comando **cf delete**. +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2017-01-11" + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} +{:codeblock: .codeblock} +{:screen: .screen} + +# Scenario: sviluppo end-to-end +{: #ee} + + +Puoi utilizzare l'interfaccia utente, la piattaforma e una selezione di strumenti {{site.data.keyword.Bluemix}} +per la creazione, esecuzione e +distribuzione delle tue applicazioni. Per iniziare, segui questo scenario di sviluppo +end-to-end. +{:shortdesc} + +## Registrazione +{: #ee_start} + +Prima di iniziare, esegui la registrazione per un ID IBM da [https://console.ng.bluemix.net/ ![icona link esterno](../icons/launch-glyph.svg)](https://console.ng.bluemix.net/){: new_window}. Successivamente, potrai accedere a {{site.data.keyword.Bluemix_notm}} e +iniziare il periodo di prova di 30 giorni. {{site.data.keyword.Bluemix_notm}} fornisce +una franchigia di 2 GB di memoria di runtime e 10 istanze del servizio per la tua prova +gratuita. + +## Creazione della tua applicazione web utilizzando l'interfaccia utente {{site.data.keyword.Bluemix_notm}} +{: #ee_appui} + +Dopo la registrazione, inizia a creare la tua prima applicazione +utilizzando l'interfaccia utente {{site.data.keyword.Bluemix_notm}}. + +In {{site.data.keyword.Bluemix_notm}}, +le applicazioni sono associate a organizzazioni e spazi. Un'organizzazione +appartiene ed è utilizzata da più collaboratori. Inizialmente, ottieni +un'organizzazione predefinita che prende il nome dal tuo nome utente e di cui +sei l'unico collaboratore. All'interno di questa organizzazione ottieni anche uno spazio. Lo spazio è un ambiente per l'esecuzione delle tue applicazioni; ad esempio, puoi +avere uno spazio di sviluppo come un ambiente di sviluppo, uno spazio di test come un ambiente di test +e uno spazio di produzione come un ambiente di produzione. Inoltre, ciascun +ambiente appartiene a una regione. Con {{site.data.keyword.Bluemix_notm}}, +puoi distribuire le applicazioni a una specifica regione geografica +per una bassa latenza di rete, riservatezza dei dati e maggiore disponibilità. Per i dettagli, vedi Regioni. + +Per questo scenario, vuoi distribuire un'applicazione Web che utilizza Node.js. Supponiamo che ti trovi negli Stati Uniti così come la maggior parte degli utenti della +tua applicazione. Decidi di creare ed eseguire la tua applicazione vicino alla base +dei tuoi utenti, in modo da poter usufruire di una più bassa latenza di rete. Dopo che ti sei collegato a {{site.data.keyword.Bluemix_notm}}, fai clic sul link delle preferenze dell'account utente e seleziona la regione **Stati Uniti Sud**. Puoi quindi attenerti alla seguente procedura per creare un'applicazione: + + 1. Vai a **Catalogo** + 2. Seleziona **Runtime Cloud Foundry**. + 3. Seleziona **SDK for Node.js**. + 4. Immetti un nome univoco per la tua applicazione, ad esempio TestNode, e fai clic su **Crea**. Il nome dell'applicazione deve essere univoco +nell'intero ambiente {{site.data.keyword.Bluemix_notm}}. + 5. Fai clic su **Crea**. + +Puoi ora visualizzare le istruzioni **Inizia a scrivere codice**. Puoi seguire le istruzioni per scaricare, modificare e distribuire il codice starter di TestNode. + +All'applicazione viene assegnata 1 istanza e 512 MB di quota di memoria +per impostazione predefinita. Puoi aumentare la memoria o aggiungere più istanze per +garantire la disponibilità elevata della tua applicazione; ad esempio 3 istanze con 1 GB +di memoria per ciascuna istanza. Fai clic su **Visualizza panoramica dell'applicazione** per +specificare le istanze della tua applicazione e la quota di memoria. Ad esempio, immetti 3 per +istanze e 1 GB per quota di memoria e fai clic su **Salva**. Puoi inoltre visualizzare file, log e variabili di ambiente per la risoluzione +dei problemi. + +## Esecuzione del bind di un servizio utilizzando l'interfaccia utente {{site.data.keyword.Bluemix_notm}} +{: #ee_bindui} + +Dopo aver creato la tua applicazione, vuoi utilizzarla per connetterti a un +database. In questo modo, puoi memorizzare ed esaminare i dati di applicazione +utilizzando il linguaggio di query database. In questo scenario, decidi di +utilizzare il servizio {{site.data.keyword.cloudant}} +fornito da {{site.data.keyword.Bluemix_notm}}. + +Per utilizzare i servizi all'interno dell'applicazione, devi creare un'istanza +del servizio ed eseguire il bind della tua applicazione all'istanza del servizio completando +la seguente procedura: + 1. Fai clic su **Aggiungi un servizio o una API** nella pagina Panoramica dell'applicazione. + 2. Nel catalogo {{site.data.keyword.Bluemix_notm}}, seleziona il servizio {{site.data.keyword.cloudant}}. + 3. Immetti un nome univoco per l'istanza del servizio o utilizza il +nome predefinito generato da {{site.data.keyword.Bluemix_notm}}, +quindi fai clic su **Crea**. + 4. Viene visualizzata la finestra Prepara di nuovo applicazione. Fai clic su **Riprepara** per ripreparare la tua applicazione. + +La tua applicazione è ora associata al servizio {{site.data.keyword.cloudant}}. Puoi trovare tutti i dati necessari perché l'applicazione comunichi con l'istanza del servizio nella variabile di ambiente VCAP_SERVICES. Ad esempio, poiché {{site.data.keyword.Bluemix_notm}} +ospita diverse applicazioni sulla stessa macchina virtuale, le applicazioni +non possono utilizzare lo stesso numero di porta HTTP per ricevere le richieste +in entrata. Per evitare conflitti, a ciascuna applicazione viene dato un +numero di porta univoco. Questo numero di porta è disponibile nella variabile di ambiente VCAP_APP_PORT. + +Per ulteriori informazioni, clic su**Variabili di ambiente** nella pagina Panoramica dell'applicazione per visualizzare l'elenco completo di VCAP_SERVICES. +``` +{ + "cloudantNoSQLDB": [ + { + "name": "Cloudant NoSQL DB-tx", + "label": "cloudantNoSQLDB", + "plan": "Shared", + "credentials": { + "username": "d72837bb-b341-4038-9c8e-7f7232916197-bluemix", + "password": "b6fc4708942b70a88853177ee52a528d07a43fa8575a69abeb8e044a7b0a7424", + "host": "d72837bb-b341-4038-9c8e-7f7232916197-bluemix.cloudant.com", + "port": 443, + "url": "https://d72837bb-b341-4038-9c8e-7f7232916197-bluemix:b6fc4708942b70a88853177ee52a528d07a43fa8575a69abeb8e044a7b0a7424@d72837bb-b341-4038-9c8e-7f7232916197-bluemix.cloudant.com" + } + } + ] +} +``` + +**Nota:** questa variabile di ambiente è la serializzazione di un oggetto JSON con una singola voce per ogni istanza del servizio a cui è associata l'applicazione. La quantità e il tipo di dati forniti da ciascuna istanza del servizio +sono specifici per il servizio. Se l'applicazione non utilizza alcun servizio, VCAP_SERVICES è un oggetto JSON vuoto. Questa variabile di ambiente viene utilizzata solo +quando aggiungi un servizio alla tua applicazione. + +## Creazione della tua applicazione utilizzando la CLI cf +{: #ee_cf} + +{{site.data.keyword.Bluemix_notm}} fornisce +diversi strumenti che ti consentono di iniziare a scrivere codice con la tua applicazione, ad esempio l'interfaccia riga di comando cf +e gli strumenti Eclipse. Puoi scegliere l'interfaccia riga di comando cf per iniziare a scrivere codice con la tua applicazione TestNode. + + 1. Innanzitutto, scarica e sviluppa il codice della tua applicazione. + + 1. Vai alla pagina Inizia a scrivere codice dell'applicazione. Fai clic sul pulsante **Scarica codice di starter** per scaricare il codice della tua applicazione. + 2. Estrai il file scaricato in una directory, ad esempio `C:\test`. + 3. Sviluppa il codice con il tuo ambiente di sviluppo +integrato locale. + + 2. Installa l'interfaccia riga di comando **cf** +(CLI). + + 1. Scarica il programma di installazione dello strumento riga di comando cf per il tuo sistema operativo. + 2. Segui la procedura guidata dello strumento per completare l'installazione. + 3. Utilizza il comando **cf -v** per verificare la versione dell'interfaccia riga di comando cf. Ad +esempio: + + ``` + cf -v + ``` + + **Requisito:** assicurati di usare sempre la versione più recente dello strumento riga di comando cf. + 3. Dopo che hai installato l'interfaccia riga di comando **cf**, +devi specificare qual è la regione {{site.data.keyword.Bluemix_notm}} che +desideri gestire utilizzando il comando **cf api**. L'interfaccia riga di comando **cf** utilizza *https://api.Bluemix_URL*, dove *Bluemix_URL* è l'URL della regione. L'URL della regione Stati Uniti sud è stage1.ng.bluemix.net. Immetti il seguente comando per +stabilire una connessione a {{site.data.keyword.Bluemix_notm}}: + + ``` + cf api https://api.ng.bluemix.net + ``` + + Per ulteriori informazioni sulla connessione ad altre regioni {{site.data.keyword.Bluemix_notm}}, vedi Regioni {{site.data.keyword.Bluemix_notm}}. Dopo che hai specificato la regione {{site.data.keyword.Bluemix_notm}}, +le informazioni sull'ubicazione da te specificate vengono salvate. + + 4. Puoi quindi accedere a {{site.data.keyword.Bluemix_notm}} utilizzando il comando cf login. + + ``` + cf login -u your_user_ID -p ***** -o your_org_name -s your_space_name + ``` + + 5. Dopo che hai eseguito l'accesso a {{site.data.keyword.Bluemix_notm}}, +sei pronto a ridistribuire l'applicazione a {{site.data.keyword.Bluemix_notm}}. Dalla directory dell'applicazione `C:\test`, immetti il seguente +comando: + + ``` + cf push TestNode + ``` + + Per ulteriori informazioni sul comando **cf push**, vedi Caricamento della tua applicazione. + + 6. Puoi ora accedere all'applicazione immettendo il seguente URL +in un browser: + ``` + http://TestNode.mybluemix.net + ``` + +Per creare la tua applicazione puoi scegliere anche altri strumenti, ad esempio +gli strumenti Eclipse. Per ulteriori informazioni, consulta la pagina Inizia a scrivere codice della tua applicazione nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. + +## Esecuzione del bind di un servizio utilizzando la CLI cf +{: #ee_cfbind} + +Con {{site.data.keyword.Bluemix_notm}}, +puoi aggiungere un servizio utilizzando l'interfaccia utente Bluemix, come descritto +in precedenza in questo scenario. Tuttavia, puoi anche eseguire il bind di un servizio utilizzando l'interfaccia riga di comando **cf**. Supponiamo che tu voglia aggiungere il servizio {{site.data.keyword.cloudant}} alla tua applicazione TestNode utilizzando l'interfaccia riga di comando cf. + +Per utilizzare il servizio {{site.data.keyword.cloudant}} +all'interno dell'applicazione, devi creare un'istanza del servizio Cloudant, eseguire il bind +della tua applicazione all'istanza del servizio e farne quindi uso. La stessa procedura si applica a tutti gli altri servizi. + + 1. Crea un'istanza del servizio Cloudant NoSQL DB. + + Usa il comando cf create-service per creare una nuova istanza di un servizio. Ad +esempio: + + ``` + cf create-service cloudantNoSQLDB Shared cloudant100 + ``` + + Puoi anche usare il comando cf services per visualizzare l'elenco di istanze del servizio da te create. + + ``` + cf services + ``` + + Dopo essere stata creata, un'istanza del servizio è a disposizione di tutte le +tue applicazioni che possono eseguirne il bind e farne uso. + + 2. Esegui il bind dell'istanza del servizio alla tua applicazione. + + Per utilizzare un'istanza del servizio, devi eseguirne il bind alla +tua applicazione. Usa il comando cf bind-service per eseguire il bind di un'istanza del servizio a un'applicazione specificando il nome applicazione e l'istanza del servizio da te creata. + + ``` + cf bind-service TestNode cloudant100 + ``` + + L'esecuzione del bind di un'istanza del servizio a un'applicazione abilita {{site.data.keyword.Bluemix_notm}} a +comunicare con il servizio e a specificare che una nuova applicazione comunicherà con tale +istanza del servizio. Per servizi differenti, {{site.data.keyword.Bluemix_notm}} può +elaborare l'applicazione e l'istanza del servizio in modo differente, durante il bind. Ad esempio, alcuni servizi possono creare un nuovo +tenant per ciascuna applicazione che comunica con l'istanza del servizio. Il servizio risponde a +sua volta a {{site.data.keyword.Bluemix_notm}} con +delle informazioni, come le credenziali, che devono essere passate all'applicazione +per le comunicazioni tra l'applicazione e il servizio. + + **Nota:** se l'applicazione è in esecuzione quando è associata a un'istanza del servizio, la variabile di ambiente VCAP_SERVICES viene aggiornata solo dopo il riavvio dell'applicazione. Per riavviare la tua applicazione, usa il comando cf restart. + + 3. Usa l'istanza del servizio. + + In questo scenario, la variabile di ambiente VCAP_SERVICES include delle informazioni, come i seguenti elementi, che un'applicazione può utilizzare per stabilire una connessione a questa istanza di {{site.data.keyword.cloudant}}: + +
username
+
d72837bb-b341-4038-9c8e-7f7232916197-bluemix
+
password
+
b6fc4708942b70a88853177ee52a528d07a43fa8575a69abeb8e044a7b0a7424
+
url
+
https://d72837bb-b341-4038-9c8e-7f7232916197-bluemix:b6fc4708942b70a88853177ee52a528d07a43fa8575a69abeb8e044a7b0a7424@d72837bb-b341-4038-9c8e-7f7232916197-bluemix.cloudant.com
+ + Ad esempio, la tua applicazione Node.js potrebbe accedere a queste +informazioni nel seguente modo: + ``` + if (process.env.VCAP_SERVICES) { + var env = JSON.parse(process.env.VCAP_SERVICES); + var cloudant = env['cloudantNoSQLDB'][0].credentials; + } else { + var cloudant = { + "username" : "user1", + "password" : "secret", + "url" : "https://user1:secret@localhost:25002" + } + }; + ``` + + **Nota:** come mostrato dal codice di esempio, per stabilire una connessione a un'istanza del servizio {{site.data.keyword.cloudant}}, puoi prima controllare se la variabile di ambiente VCAP_SERVICES esiste. Se esiste, l'applicazione può utilizzare le proprietà della variabile cloudant per accedere al database. Tuttavia, se la variabile di ambiente VCAP_SERVICES non è presente, l'istanza del servizio {{site.data.keyword.cloudant}} locale viene utilizza valori predefiniti forniti. + + 4. Interagisci con l'istanza del servizio. + + Puoi interagire con l'istanza del servizio utilizzando le informazioni delle credenziali. Le azioni che puoi eseguire includono la lettura, la scrittura e l'aggiornamento. Il +seguente esempio illustra come inserire un oggetto JSON nell'istanza del servizio +{{site.data.keyword.cloudant}}: + ``` + // create a new message +var create_message = function(req, res) { + require('cloudantdb').connect(cloudant.url, function(err, conn) { + var collection = conn.collection('messages'); + + // create message record + var parsedUrl = require('url').parse(req.url, true); + var queryObject = parsedUrl.query; + var name = (queryObject["name"] || 'Bluemix'); + var message = { 'message': 'Hello, ' + name, 'ts': new Date() +}; + collection.insert(message, {safe:true}, function(err){ + if (err) { console.log(err.stack); } + res.writeHead(200, {'Content-Type': 'text/plain'}); + res.write(JSON.stringify(message)); + res.end('\n'); + }); + }); +} + ``` + + 5. **Facoltativo:** annulla il bind di un'istanza del servizio oppure eliminala. + + È possibile che tu voglia annullare il bind di un'istanza del servizio oppure eliminarla qualora +non sia più utilizzata o per liberare dello spazio. Per annullare il bind di un'istanza del servizio alla tua applicazione, usa il **comando cf unbind-service**; per eliminare un'istanza del servizio, usa il comando **cf delete-service**. + + Per ulteriori informazioni sui servizi, vedi Servizi. Per ulteriori informazioni sulle opzioni **cf** che puoi utilizzare per gestire le tue applicazioni nell'ambiente {{site.data.keyword.Bluemix_notm}}, immetti il comando **cf --help** nell'interfaccia riga di comando **cf**. + + **Nota:** assicurati di non avere più bisogno di un'istanza del servizio, prima di eliminarla. L'eliminazione di un'istanza del servizio elimina tutti i dati a essa associati. È possibile aggiornare la variabile di ambiente VCAP_SERVICES di un'applicazione associata a un servizio eliminato solo dopo il riavvio dell'applicazione. + +## Calcolo del costo della tua applicazione +{: #ee_billing} + +Il tuo periodo di prova gratuito di 30 giorni è scaduto ma vuoi continuare +a utilizzare {{site.data.keyword.Bluemix_notm}}. Per continuare a utilizzare {{site.data.keyword.Bluemix_notm}} +dovrai aggiungere le informazioni della tua carta di credito per un account Pagamento a consumo o per un account Sottoscrizione. Tuttavia, {{site.data.keyword.Bluemix_notm}} continua a offrire una franchigia per la +maggior parte dei servizi e dei framework di runtime anche se passi a un account a pagamento. {{site.data.keyword.Bluemix_notm}} +non ti addebita niente a meno che l'utilizzo non superi le franchigie concesse. + +{{site.data.keyword.Bluemix_notm}} fornisce +una funzione di stima e un calcolatore per consentirti di visualizzare il costo della tua applicazione. Puoi visualizzare il costo di TestNode nei seguenti modi: + + * Nel tuo dashboard, fai clic su TestNode. Quindi, nella pagina Panoramica, fai clic su **Stima il costo di questa applicazione** per vedere il prezzo del runtime e del supporto **SDK for Node.js** e il prezzo totale mensile della tua applicazione. + + * In alternativa, nella pagina Listino prezzi, immetti l'utilizzo mensile del runtime e dei servizi della tua applicazione. d esempio 3 istanze di **SDK for Node.js** con 1 GB di memoria per ciascuna istanza. Il prezzo mensile viene calcolato e visualizzato. + +Puoi anche calcolare il costo della tua applicazione manualmente sommando i prezzi dei tuoi runtime e servizi +e sottraendo la franchigia. Per ulteriori informazioni, vedi Calcolo manuale dei tuoi costi. + +## Rimozione di applicazioni +{: #ee_removing} + +Man mano che crei ulteriori applicazioni, la quota potrebbe avvicinarsi al limite. Tuttavia, delle applicazioni +che tu potresti non utilizzare più continuano a consumare una parte della quota. È facile eliminare delle applicazioni per liberare dello +spazio in {{site.data.keyword.Bluemix_notm}} in qualsiasi momento. + +Nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}, vai alla pagina Panoramica dell'applicazione, fai clic sull'icona **Menu** ed elimina l'applicazione che non utilizzi più. Per eliminare le applicazioni puoi anche utilizzare il comando **cf delete**. diff --git a/cfapps/nl/it/hostingapps.md b/cfapps/nl/it/hostingapps.md index c694f25a4..dfcd0b83d 100644 --- a/cfapps/nl/it/hostingapps.md +++ b/cfapps/nl/it/hostingapps.md @@ -1,195 +1,195 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2016-05-09" - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} -{:codeblock: .codeblock} -{:screen: .screen} - -#Host delle applicazioni in {{site.data.keyword.Bluemix_notm}} - - - -Con {{site.data.keyword.Bluemix}}, puoi creare applicazioni e fornire un host per le applicazioni esistenti. Purché pronte per il cloud, le tue applicazioni possono essere migrate in {{site.data.keyword.Bluemix_notm}}. {{site.data.keyword.Bluemix_notm}} fornisce diversi modi per eseguire le tue applicazioni, ad esempio Cloud Foundry, IBM Containers e Virtual Machines. - -##Come far sì che le tue applicazioni siano pronte per il cloud -{: #cloud-readyapps} - -Quando un'applicazione pronta per il cloud viene progettata e creata, segue i principi della piattaforma cloud. Un'applicazione pronta per il cloud può utilizzare le capacità fornite dalla piattaforma cloud. - -Se la tua applicazione osserva tutti i seguenti principi, essa è pronta per il cloud e può essere migrata in {{site.data.keyword.Bluemix_notm}}. Se l'applicazione viola uno dei principi, puoi generalmente modificarla per far sì che rispetti tutti i principi. - -* Non codificare direttamente la tua applicazione in una topologia specifica. - - In un ambiente non cloud, l'applicazione potrebbe utilizzare una particolare topologia di distribuzione. Tuttavia, la topologia dell'applicazione potrebbe cambiare nelle applicazioni cloud, poiché i servizi e le applicazioni pronti per il cloud consentono modifiche immediate per la scalabilità. Le modifiche per la scalabilità includono il ridimensionamento dinamico e il ridimensionamento manuale del numero di istanze di un'applicazione. - - Crea la tua applicazione in modo che sia il più possibile generica e senza stati, in modo da preservare la tua applicazione dagli effetti delle modifiche di scalabilità. - -* Non presupporre che il file system locale sia permanente. - - Poiché un'istanza di un'applicazione può essere spostata, eliminata o duplicata sul cloud in qualsiasi momento, non affidarti ai file scritti nel file system. Se un'applicazione utilizza il file system locale come cache delle informazioni più utilizzate, tra cui i registri delle applicazioni, le informazioni vengono perse nel momento in cui l'istanza viene arrestata e riavviata in un'ubicazione o VM differente. - - Invece che nel file system locale, puoi memorizzare le informazioni in un servizio, quale un database SQL o NoSQL. In un ambiente cloud dinamico, è fondamentale anche che i tuoi log siano disponibili in un servizio avente durata superiore alle istanze dell'applicazione in cui vengono generati i log. - -* Non memorizzare gli stati delle sessioni nella tua applicazione. - - Lo stato del tuo sistema viene definito dai database e dalla memoria condivisa e non da ciascuna istanza dell'applicazione in esecuzione. Qualsiasi tipo di mancanza di stato limita la scalabilità di un'applicazione. Cerca di ridurre al minimo l'impatto dello stato della sessione, memorizzandolo in un'ubicazione centralizzata sul server. - - Se non puoi eliminare del tutto lo stato della sessione, eseguine il push in una memoria altamente disponibile esterna al server della tua applicazione. Tra le memorie utilizzabili vi sono IBM WebSphere Extreme Scale, Redis, Memcached o un database esterno. - -* Non utilizzare dipendenze da infrastrutture specifiche. - - Questo principio generale si rivela sotto vari aspetti. Ad esempio, non partire dal presupposto che i servizi utilizzati dalla tua applicazione siano associati a indirizzi IP o nomi host specifici. Poiché i servizi potrebbero essere trasferiti o rigenerati nel tuo ambiente cloud, potrebbero cambiare anche i nomi host e gli indirizzi IP. - - L'estrazione di dipendenze specifiche dell'ambiente in una serie di file di proprietà rappresenta un miglioramento, ma resta inappropriato. La migliore prassi prevede la risoluzione degli endpoint dei servizi attraverso il registro di un servizio esterno o la delega dell'intera funzione di instradamento al bus di un servizio o a un programma di bilanciamento dei carichi con un nome virtuale. - -* Non utilizzare API infrastruttura nella tua applicazione. - - Se la tua applicazione si affida a un'API infrastruttura specifica, la modifica dell'infrastruttura risulta più complessa, poiché un'API infrastruttura può fare riferimento a livelli differenti del tuo stack software. - - Puoi invece affidarti ai prodotti commerciali od open source esistenti e lasciare le soluzioni PaaS nel livello PaaS in modo da mantenerle al di fuori del codice della tua applicazione. - -* Non utilizzare protocolli oscuri. - - Non utilizzare protocolli oscuri che richiedono una configurazione aggiuntiva per la resilienza. - - Le applicazioni basate su protocolli standard hanno maggiore resilienza con gli elementi della configurazione delegati alla piattaforma. I protocolli standard includono HTTP, SSL, database standard, accodamento e connessioni ai servizi Web. - -* Non affidarti a funzioni specifiche del sistema operativo - - Se hai già utilizzato funzioni specifiche del sistema operativo, puoi risolvere il problema utilizzando librerie di compatibilità, quali Cygwin e Mono. Cygwin è una libreria di compatibilità che fornisce una serie di strumenti Linux in un ambiente Windows. Mono è una libreria di compatibilità che fornisce le funzionalità di Windows .NET in Linux. - - Evita le dipendenze specifiche del sistema operativo; utilizza invece servizi forniti dall'infrastruttura middleware o da fornitori di servizi. - -* Non installare manualmente la tua applicazione. - - Nell'ambiente cloud dinamico, la tua applicazione potrebbe essere installata spesso on-demand Il processo di installazione deve avere script ed essere affidabile e i dati della configurazione devono essere esternalizzati dagli script. - - Acquisisci almeno l'installazione della tua applicazione come una serie uniforme di script indipendenti dal sistema operativo. Fa in modo che le dimensioni dell'installazione della tua applicazione restino contenute e preservane la portabilità, in modo che si adegui a differenti tecniche di automazione. Inoltre, riduci al minimo le dipendenze richieste dall'installazione dell'applicazione. - -Per ulteriori informazioni sulle applicazioni pronte per il cloud, vedi [The 12-factor application ![icona link esterno](../icons/launch-glyph.svg)](http://12factor.net/){: new_window}. - -##Migrazione delle tue applicazioni -{: #ht_hostapp} - -Invece di spostare completamente le applicazioni nell'ambiente cloud, puoi migrarle in {{site.data.keyword.Bluemix_notm}} in modo incrementale. Puoi migrare prima una parte della tua applicazione e connetterla al system of record o ai dati esistenti, attraverso il servizio Cloud Integration. - -Nelle tue applicazioni cloud potresti dover accedere ai servizi o ai dati backend quali, ad esempio, un system of record. In {{site.data.keyword.Bluemix_notm}}, puoi utilizzare il servizio Secure Gateway per stabilire un tunnel protetto tra un'organizzazione {{site.data.keyword.Bluemix_notm}} e la rete backend aziendale. Il servizio consente alle applicazioni su {{site.data.keyword.Bluemix_notm}} di accedere ai servizi e ai dati della rete backend. Per i dettagli, vedi [Reaching enterprise backend with Bluemix Secure Gateway via console ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/bluemix/2015/04/01/reaching-enterprise-backend-bluemix-secure-gateway/){: new_window}. - -Per distribuire la tua applicazione su {{site.data.keyword.Bluemix_notm}} come applicazione Cloud Foundry, seleziona un runtime dal Catalogo {{site.data.keyword.Bluemix_notm}}. Il runtime contiene un'applicazione starter Hello World che puoi sostituire con la tua propria applicazione. Se non riesci a trovare uno starter con il runtime desiderato, puoi portare un pacchetto di build personalizzato compatibile con Cloud Foundry in {{site.data.keyword.Bluemix_notm}} utilizzando l'opzione –b con il comando cf push. Per i dettagli, vedi [Utilizzo dei pacchetti di build della community](/docs/cfapps/byob.html). - -Puoi usare i seguenti servizi e strumenti forniti da {{site.data.keyword.Bluemix_notm}}: - -| Strumento | Metodo | -|:------|:--------| -|Interfaccia riga di comando Cloud Foundry (cf cli) |Gestisci il tuo codice su un client locale e utilizza l'interfaccia riga di comando Cloud Foundry per eseguire manualmente il push della tua applicazione su {{site.data.keyword.Bluemix_notm}}. Per ulteriori informazioni, vedi [Caricamento delle tue applicazioni](/docs/starters/upload_app.html).| -|Eclipse |Gestisci il tuo codice in Eclipse e utilizza gli strumenti di IBM Eclipse per {{site.data.keyword.Bluemix_notm}} per distribuire la tua applicazione.| -|Integrazione di Git |Gestisci il tuo codice su GitHub e integra Git in {{site.data.keyword.Bluemix_notm}}. Puoi collaborare con altri sviluppatori. La tua applicazione viene distribuita automaticamente in {{site.data.keyword.Bluemix_notm}} quando esegui il commit delle modifiche nel codice. Non devi eseguire manualmente il push dell'applicazione.| -|{{site.data.keyword.Bluemix_notm}} DevOps Delivery Pipeline |Gestisci il tuo codice sul repository DevOps GitHub e distribuisci la tua applicazione su {{site.data.keyword.Bluemix_notm}} utilizzando DevOps Delivery Pipeline.| -{: caption="Table 1. {{site.data.keyword.Bluemix_notm}} tools" caption-side="top"} - - -Se la piattaforma Cloud Foundry non risponde ai requisiti della tua applicazione, puoi utilizzare un contenitore o una VM in cui il runtime venga configurato e aggiornato con più opzioni personalizzate. - -##Caricamento delle tue applicazioni attraverso la CLI cf -{: #ht_cfcli} - -Puoi gestire il tuo codice su un client locale e utilizzare l'interfaccia riga di comando Cloud Foundry per caricare manualmente la tua applicazione su {{site.data.keyword.Bluemix_notm}}. Se modifichi il codice, per eseguire il codice aggiornato è necessario che riesegua il push dell'applicazione su {{site.data.keyword.Bluemix_notm}}. - -Per effettuare la migrazione della tua applicazione, attieniti alla seguente procedura: - -
    -
  1. Installa l'interfaccia riga di comando Cloud Foundry. Assicurati di usare la versione più recente dell'interfaccia riga di comando cf. -
      -
    1. Scarica il programma di installazione per il tuo sistema operativo.
      2. -
    2. Segui la procedura guidata di installazione della riga di comando.
      3. -
    3. Utilizza il seguente comando per verificare la versione dell'interfaccia riga di comando cf: -
      cf -v
      4. -
    -
    2. - -
  2. Facoltativo: se desideri specificare e salvare i dettagli di distribuzione prima di distribuire un'applicazione a {{site.data.keyword.Bluemix_notm}}, puoi aggiungere il manifest dell'applicazione effettuando le seguenti operazioni: -
      -
    1. Passa alla directory di lavoro della tua applicazione e crea un file denominato manifest.yml, che è il nome predefinito.
      2. -
    2. Specifica i dettagli di distribuzione nel file manifest. Il seguente esempio mostra un file manifest per un'applicazione Java™. -
      applications:
-- disk_quota: 1024M
-  host: myjavatest
-  name: MyJavaTest
-  path: webStarterApp.war
-  domain: mybluemix.net
-  instances: 1
-  memory: 512M
      -

      Per ulteriori informazioni sulle opzioni supportate utilizzabili in questo file, vedi il [Manifesto dell'applicazione](/docs/manageapps/depapps.html#appmanifest). - -

    -
    3. - -
  3. Esegui il push della tua applicazione. Puoi caricare la tua applicazione attraverso il comando cf push. -
      -
    1. Connettiti ed accedi a {{site.data.keyword.Bluemix_notm}} eseguendo il seguente comando. Quando richiesto, seleziona la tua organizzazione e il tuo spazio. -
      cf login -a https://api.ng.bluemix.net
      2. -
    2. Dalla directory della tua applicazione, immetti il comando cf push seguito dal nome dell'applicazione. Tale nome deve essere univoco nell'ambiente {{site.data.keyword.Bluemix_notm}}. -
      cf push nomeapplicazione
      3. -
    3. Facoltativo: se utilizzi un pacchetto di build esterno, devi utilizzare l'opzione -b con il comando cf push. Per esempio: -
      cf push nomeapplicazione -b buildpack_URL
      -

      Per ulteriori informazioni, vedi Utilizzo di pacchetti di build della community.

      -
    -
    4. - -
  4. Facoltativo: se modifichi la tua applicazione, devi caricare queste modifiche immettendo di nuovo il comando cf push. L'Interfaccia riga di comando cf utilizza le tue opzioni precedenti e le tue risposte ai prompt per aggiornare con i nuovi bit di codice le eventuali istanze dell'applicazione in esecuzione.
    5. -
- -**Note:** - -* Quando utilizzi il comando cf push, l'interfaccia riga di comando cf copia tutti i file e tutte le directory dalla tua directory corrente a {{site.data.keyword.Bluemix_notm}}. Assicurati di avere solo i file richiesti nella directory della tua applicazione. -* Accertati che la memoria della tua organizzazione sia sufficiente per tutte le istanze della tua applicazione. Per visualizzare la quota di memoria per la tua organizzazione, utilizza cf org org_name. -* Per ulteriori informazioni su cf push, vedi [comandi cf](/docs/cli/reference/cfcommands/index.html). - -##Migrazione dei tuoi dati e utilizzo dei servizi -{: #ht_service} - -Una volta caricata la tua applicazione su {{site.data.keyword.Bluemix_notm}}, seleziona il servizio a cui è collegata l'applicazione dal Catalogo {{site.data.keyword.Bluemix_notm}}, crea un'istanza di servizio, esegui il bind dell'istanza all'applicazione e riavvia l'applicazione. - -La variabile di ambiente VCAP_SERVICES della tua applicazione è un oggetto JSON che contiene informazioni su come interagire con un'istanza di servizio in {{site.data.keyword.Bluemix_notm}}. Tali informazioni includono il nome dell'istanza di servizio, le credenziali e l'URL di connessione all'istanza di servizio. - -Per eseguire il codice su {{site.data.keyword.Bluemix_notm}}, devi aggiungere la logica del codice per l'analisi della variabile VCAP_SERVICES, al fine di ottenere informazioni sulla connessione al servizio. Modifica la tua applicazione per acquisire la porta e l'host dell'istanza di servizio assegnati dinamicamente attraverso le variabili di ambiente. Il seguente esempio mostra come acquisire le credenziali di un'istanza di servizio Postgre SQL all'interno di un'applicazione Ruby: - -``` -services = JSON.parse(ENV['VCAP_SERVICES'], :symbolize_names => true) - url = services.values.map do |srvs| - srvs.map do |srv| - if srv[:credentials][:uri] =~ /^postgres/ - srv[:credentials][:uri] - else - [] - end - end - end.flatten!.first -``` -{:codeblock} - -Per accertarti che la tua applicazione possa essere eseguita in un ambiente locale una volta modificata l'applicazione per {{site.data.keyword.Bluemix_notm}}, verifica che sia presente la variabile d'ambiente VCAP_SERVICES, che viene impostata per tutte le applicazioni {{site.data.keyword.Bluemix_notm}} Cloud Foundry. - - -# Link correlati -{: #rellinks} - -## Link correlati -{: #general} - -* [IBM Containers](/docs/containers/container_index.html) -* [Virtual Machine](/docs/virtualmachines/vm_index.html) -* [Introduzione a Delivery Pipeline](/docs/services/DeliveryPipeline/index.html) -* [Distribuzione di applicazioni con IBM Eclipse Tools for Bluemix](/docs/manageapps/eclipsetools/eclipsetools.html) -* [The twelve-factor app ![icona link esterno](../icons/launch-glyph.svg)](http://12factor.net/){: new_window} -* [Reaching enterprise backend with Bluemix Secure Gateway via console ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/bluemix/2015/04/01/reaching-enterprise-backend-bluemix-secure-gateway/){: new_window} +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2016-05-09" + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} +{:codeblock: .codeblock} +{:screen: .screen} + +# Host delle applicazioni in {{site.data.keyword.Bluemix_notm}} + + + +Con {{site.data.keyword.Bluemix}}, puoi creare applicazioni e fornire un host per le applicazioni esistenti. Purché pronte per il cloud, le tue applicazioni possono essere migrate in {{site.data.keyword.Bluemix_notm}}. {{site.data.keyword.Bluemix_notm}} fornisce diversi modi per eseguire le tue applicazioni, ad esempio Cloud Foundry, IBM Containers e Virtual Machines. + +## Come far sì che le tue applicazioni siano pronte per il cloud +{: #cloud-readyapps} + +Quando un'applicazione pronta per il cloud viene progettata e creata, segue i principi della piattaforma cloud. Un'applicazione pronta per il cloud può utilizzare le capacità fornite dalla piattaforma cloud. + +Se la tua applicazione osserva tutti i seguenti principi, essa è pronta per il cloud e può essere migrata in {{site.data.keyword.Bluemix_notm}}. Se l'applicazione viola uno dei principi, puoi generalmente modificarla per far sì che rispetti tutti i principi. + +* Non codificare direttamente la tua applicazione in una topologia specifica. + + In un ambiente non cloud, l'applicazione potrebbe utilizzare una particolare topologia di distribuzione. Tuttavia, la topologia dell'applicazione potrebbe cambiare nelle applicazioni cloud, poiché i servizi e le applicazioni pronti per il cloud consentono modifiche immediate per la scalabilità. Le modifiche per la scalabilità includono il ridimensionamento dinamico e il ridimensionamento manuale del numero di istanze di un'applicazione. + + Crea la tua applicazione in modo che sia il più possibile generica e senza stati, in modo da preservare la tua applicazione dagli effetti delle modifiche di scalabilità. + +* Non presupporre che il file system locale sia permanente. + + Poiché un'istanza di un'applicazione può essere spostata, eliminata o duplicata sul cloud in qualsiasi momento, non affidarti ai file scritti nel file system. Se un'applicazione utilizza il file system locale come cache delle informazioni più utilizzate, tra cui i registri delle applicazioni, le informazioni vengono perse nel momento in cui l'istanza viene arrestata e riavviata in un'ubicazione o VM differente. + + Invece che nel file system locale, puoi memorizzare le informazioni in un servizio, quale un database SQL o NoSQL. In un ambiente cloud dinamico, è fondamentale anche che i tuoi log siano disponibili in un servizio avente durata superiore alle istanze dell'applicazione in cui vengono generati i log. + +* Non memorizzare gli stati delle sessioni nella tua applicazione. + + Lo stato del tuo sistema viene definito dai database e dalla memoria condivisa e non da ciascuna istanza dell'applicazione in esecuzione. Qualsiasi tipo di mancanza di stato limita la scalabilità di un'applicazione. Cerca di ridurre al minimo l'impatto dello stato della sessione, memorizzandolo in un'ubicazione centralizzata sul server. + + Se non puoi eliminare del tutto lo stato della sessione, eseguine il push in una memoria altamente disponibile esterna al server della tua applicazione. Tra le memorie utilizzabili vi sono IBM WebSphere Extreme Scale, Redis, Memcached o un database esterno. + +* Non utilizzare dipendenze da infrastrutture specifiche. + + Questo principio generale si rivela sotto vari aspetti. Ad esempio, non partire dal presupposto che i servizi utilizzati dalla tua applicazione siano associati a indirizzi IP o nomi host specifici. Poiché i servizi potrebbero essere trasferiti o rigenerati nel tuo ambiente cloud, potrebbero cambiare anche i nomi host e gli indirizzi IP. + + L'estrazione di dipendenze specifiche dell'ambiente in una serie di file di proprietà rappresenta un miglioramento, ma resta inappropriato. La migliore prassi prevede la risoluzione degli endpoint dei servizi attraverso il registro di un servizio esterno o la delega dell'intera funzione di instradamento al bus di un servizio o a un programma di bilanciamento dei carichi con un nome virtuale. + +* Non utilizzare API infrastruttura nella tua applicazione. + + Se la tua applicazione si affida a un'API infrastruttura specifica, la modifica dell'infrastruttura risulta più complessa, poiché un'API infrastruttura può fare riferimento a livelli differenti del tuo stack software. + + Puoi invece affidarti ai prodotti commerciali od open source esistenti e lasciare le soluzioni PaaS nel livello PaaS in modo da mantenerle al di fuori del codice della tua applicazione. + +* Non utilizzare protocolli oscuri. + + Non utilizzare protocolli oscuri che richiedono una configurazione aggiuntiva per la resilienza. + + Le applicazioni basate su protocolli standard hanno maggiore resilienza con gli elementi della configurazione delegati alla piattaforma. I protocolli standard includono HTTP, SSL, database standard, accodamento e connessioni ai servizi Web. + +* Non affidarti a funzioni specifiche del sistema operativo + + Se hai già utilizzato funzioni specifiche del sistema operativo, puoi risolvere il problema utilizzando librerie di compatibilità, quali Cygwin e Mono. Cygwin è una libreria di compatibilità che fornisce una serie di strumenti Linux in un ambiente Windows. Mono è una libreria di compatibilità che fornisce le funzionalità di Windows .NET in Linux. + + Evita le dipendenze specifiche del sistema operativo; utilizza invece servizi forniti dall'infrastruttura middleware o da fornitori di servizi. + +* Non installare manualmente la tua applicazione. + + Nell'ambiente cloud dinamico, la tua applicazione potrebbe essere installata spesso on-demand Il processo di installazione deve avere script ed essere affidabile e i dati della configurazione devono essere esternalizzati dagli script. + + Acquisisci almeno l'installazione della tua applicazione come una serie uniforme di script indipendenti dal sistema operativo. Fa in modo che le dimensioni dell'installazione della tua applicazione restino contenute e preservane la portabilità, in modo che si adegui a differenti tecniche di automazione. Inoltre, riduci al minimo le dipendenze richieste dall'installazione dell'applicazione. + +Per ulteriori informazioni sulle applicazioni pronte per il cloud, vedi [The 12-factor application ![icona link esterno](../icons/launch-glyph.svg)](http://12factor.net/){: new_window}. + +## Migrazione delle tue applicazioni +{: #ht_hostapp} + +Invece di spostare completamente le applicazioni nell'ambiente cloud, puoi migrarle in {{site.data.keyword.Bluemix_notm}} in modo incrementale. Puoi migrare prima una parte della tua applicazione e connetterla al system of record o ai dati esistenti, attraverso il servizio Cloud Integration. + +Nelle tue applicazioni cloud potresti dover accedere ai servizi o ai dati backend quali, ad esempio, un system of record. In {{site.data.keyword.Bluemix_notm}}, puoi utilizzare il servizio Secure Gateway per stabilire un tunnel protetto tra un'organizzazione {{site.data.keyword.Bluemix_notm}} e la rete backend aziendale. Il servizio consente alle applicazioni su {{site.data.keyword.Bluemix_notm}} di accedere ai servizi e ai dati della rete backend. Per i dettagli, vedi [Reaching enterprise backend with Bluemix Secure Gateway via console ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/bluemix/2015/04/01/reaching-enterprise-backend-bluemix-secure-gateway/){: new_window}. + +Per distribuire la tua applicazione su {{site.data.keyword.Bluemix_notm}} come applicazione Cloud Foundry, seleziona un runtime dal Catalogo {{site.data.keyword.Bluemix_notm}}. Il runtime contiene un'applicazione starter Hello World che puoi sostituire con la tua propria applicazione. Se non riesci a trovare uno starter con il runtime desiderato, puoi portare un pacchetto di build personalizzato compatibile con Cloud Foundry in {{site.data.keyword.Bluemix_notm}} utilizzando l'opzione –b con il comando cf push. Per i dettagli, vedi [Utilizzo dei pacchetti di build della community](/docs/cfapps/byob.html). + +Puoi usare i seguenti servizi e strumenti forniti da {{site.data.keyword.Bluemix_notm}}: + +| Strumento | Metodo | +|:------|:--------| +|Interfaccia riga di comando Cloud Foundry (cf cli) |Gestisci il tuo codice su un client locale e utilizza l'interfaccia riga di comando Cloud Foundry per eseguire manualmente il push della tua applicazione su {{site.data.keyword.Bluemix_notm}}. Per ulteriori informazioni, vedi [Caricamento delle tue applicazioni](/docs/starters/upload_app.html).| +|Eclipse |Gestisci il tuo codice in Eclipse e utilizza gli strumenti di IBM Eclipse per {{site.data.keyword.Bluemix_notm}} per distribuire la tua applicazione.| +|Integrazione di Git |Gestisci il tuo codice su GitHub e integra Git in {{site.data.keyword.Bluemix_notm}}. Puoi collaborare con altri sviluppatori. La tua applicazione viene distribuita automaticamente in {{site.data.keyword.Bluemix_notm}} quando esegui il commit delle modifiche nel codice. Non devi eseguire manualmente il push dell'applicazione.| +|{{site.data.keyword.Bluemix_notm}} DevOps Delivery Pipeline |Gestisci il tuo codice sul repository DevOps GitHub e distribuisci la tua applicazione su {{site.data.keyword.Bluemix_notm}} utilizzando DevOps Delivery Pipeline.| +{: caption="Table 1. {{site.data.keyword.Bluemix_notm}} tools" caption-side="top"} + + +Se la piattaforma Cloud Foundry non risponde ai requisiti della tua applicazione, puoi utilizzare un contenitore o una VM in cui il runtime venga configurato e aggiornato con più opzioni personalizzate. + +## Caricamento delle tue applicazioni attraverso la CLI cf +{: #ht_cfcli} + +Puoi gestire il tuo codice su un client locale e utilizzare l'interfaccia riga di comando Cloud Foundry per caricare manualmente la tua applicazione su {{site.data.keyword.Bluemix_notm}}. Se modifichi il codice, per eseguire il codice aggiornato è necessario che riesegua il push dell'applicazione su {{site.data.keyword.Bluemix_notm}}. + +Per effettuare la migrazione della tua applicazione, attieniti alla seguente procedura: + +
    +
  1. Installa l'interfaccia riga di comando Cloud Foundry. Assicurati di usare la versione più recente dell'interfaccia riga di comando cf. +
      +
    1. Scarica il programma di installazione per il tuo sistema operativo.
      2. +
    2. Segui la procedura guidata di installazione della riga di comando.
      3. +
    3. Utilizza il seguente comando per verificare la versione dell'interfaccia riga di comando cf: +
      cf -v
      4. +
    +
    2. + +
  2. Facoltativo: se desideri specificare e salvare i dettagli di distribuzione prima di distribuire un'applicazione a {{site.data.keyword.Bluemix_notm}}, puoi aggiungere il manifest dell'applicazione effettuando le seguenti operazioni: +
      +
    1. Passa alla directory di lavoro della tua applicazione e crea un file denominato manifest.yml, che è il nome predefinito.
      2. +
    2. Specifica i dettagli di distribuzione nel file manifest. Il seguente esempio mostra un file manifest per un'applicazione Java™. +
      applications:
+- disk_quota: 1024M
+  host: myjavatest
+  name: MyJavaTest
+  path: webStarterApp.war
+  domain: mybluemix.net
+  instances: 1
+  memory: 512M
      +

      Per ulteriori informazioni sulle opzioni supportate utilizzabili in questo file, vedi il [Manifesto dell'applicazione](/docs/manageapps/depapps.html#appmanifest). + +

    +
    3. + +
  3. Esegui il push della tua applicazione. Puoi caricare la tua applicazione attraverso il comando cf push. +
      +
    1. Connettiti ed accedi a {{site.data.keyword.Bluemix_notm}} eseguendo il seguente comando. Quando richiesto, seleziona la tua organizzazione e il tuo spazio. +
      cf login -a https://api.ng.bluemix.net
      2. +
    2. Dalla directory della tua applicazione, immetti il comando cf push seguito dal nome dell'applicazione. Tale nome deve essere univoco nell'ambiente {{site.data.keyword.Bluemix_notm}}. +
      cf push nomeapplicazione
      3. +
    3. Facoltativo: se utilizzi un pacchetto di build esterno, devi utilizzare l'opzione -b con il comando cf push. Per esempio: +
      cf push nomeapplicazione -b buildpack_URL
      +

      Per ulteriori informazioni, vedi Utilizzo di pacchetti di build della community.

      +
    +
    4. + +
  4. Facoltativo: se modifichi la tua applicazione, devi caricare queste modifiche immettendo di nuovo il comando cf push. L'Interfaccia riga di comando cf utilizza le tue opzioni precedenti e le tue risposte ai prompt per aggiornare con i nuovi bit di codice le eventuali istanze dell'applicazione in esecuzione.
    5. +
+ +**Note:** + +* Quando utilizzi il comando cf push, l'interfaccia riga di comando cf copia tutti i file e tutte le directory dalla tua directory corrente a {{site.data.keyword.Bluemix_notm}}. Assicurati di avere solo i file richiesti nella directory della tua applicazione. +* Accertati che la memoria della tua organizzazione sia sufficiente per tutte le istanze della tua applicazione. Per visualizzare la quota di memoria per la tua organizzazione, utilizza cf org org_name. +* Per ulteriori informazioni su cf push, vedi [comandi cf](/docs/cli/reference/cfcommands/index.html). + +## Migrazione dei tuoi dati e utilizzo dei servizi +{: #ht_service} + +Una volta caricata la tua applicazione su {{site.data.keyword.Bluemix_notm}}, seleziona il servizio a cui è collegata l'applicazione dal Catalogo {{site.data.keyword.Bluemix_notm}}, crea un'istanza di servizio, esegui il bind dell'istanza all'applicazione e riavvia l'applicazione. + +La variabile di ambiente VCAP_SERVICES della tua applicazione è un oggetto JSON che contiene informazioni su come interagire con un'istanza di servizio in {{site.data.keyword.Bluemix_notm}}. Tali informazioni includono il nome dell'istanza di servizio, le credenziali e l'URL di connessione all'istanza di servizio. + +Per eseguire il codice su {{site.data.keyword.Bluemix_notm}}, devi aggiungere la logica del codice per l'analisi della variabile VCAP_SERVICES, al fine di ottenere informazioni sulla connessione al servizio. Modifica la tua applicazione per acquisire la porta e l'host dell'istanza di servizio assegnati dinamicamente attraverso le variabili di ambiente. Il seguente esempio mostra come acquisire le credenziali di un'istanza di servizio Postgre SQL all'interno di un'applicazione Ruby: + +``` +services = JSON.parse(ENV['VCAP_SERVICES'], :symbolize_names => true) + url = services.values.map do |srvs| + srvs.map do |srv| + if srv[:credentials][:uri] =~ /^postgres/ + srv[:credentials][:uri] + else + [] + end + end + end.flatten!.first +``` +{:codeblock} + +Per accertarti che la tua applicazione possa essere eseguita in un ambiente locale una volta modificata l'applicazione per {{site.data.keyword.Bluemix_notm}}, verifica che sia presente la variabile d'ambiente VCAP_SERVICES, che viene impostata per tutte le applicazioni {{site.data.keyword.Bluemix_notm}} Cloud Foundry. + + +# Link correlati +{: #rellinks} + +## Link correlati +{: #general} + +* [IBM Containers](/docs/containers/container_index.html) +* [Virtual Machine](/docs/virtualmachines/vm_index.html) +* [Introduzione a Delivery Pipeline](/docs/services/DeliveryPipeline/index.html) +* [Distribuzione di applicazioni con IBM Eclipse Tools for Bluemix](/docs/manageapps/eclipsetools/eclipsetools.html) +* [The twelve-factor app ![icona link esterno](../icons/launch-glyph.svg)](http://12factor.net/){: new_window} +* [Reaching enterprise backend with Bluemix Secure Gateway via console ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/bluemix/2015/04/01/reaching-enterprise-backend-bluemix-secure-gateway/){: new_window} diff --git a/cfapps/nl/it/index.md b/cfapps/nl/it/index.md index 00d1fdeed..4101cdb0f 100644 --- a/cfapps/nl/it/index.md +++ b/cfapps/nl/it/index.md @@ -1,88 +1,88 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2016-04-18" - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Creazione di applicazioni Cloud Foundry - -Con {{site.data.keyword.Bluemix}}, puoi -creare la tua applicazione nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Dopo averla creata, puoi decidere di continuare a usare l'interfaccia utente, l'interfaccia riga di comando cf o {{site.data.keyword.jazzhub_title}} per -sviluppare, tracciare, pianificare e distribuire la tua applicazione. -{:shortdesc} - -Quando crei un'applicazione in {{site.data.keyword.Bluemix_notm}}, -inizi con uno starter. Uno *starter* è un template che include -dei servizi predefiniti e del codice applicativo configurato con uno -specifico pacchetto di build. Ci sono due tipi di starter: contenitori tipo e runtime. - -Un *contenitore tipo* è un contenitore per un'applicazione e il -suo ambiente di runtime associato e i servizi predefiniti per uno specifico dominio. Ad esempio, -il contenitore tipo Mobile Cloud include un runtime Node.js, oltre che i servizi -Mobile Data, Mobile Application Security e Push. Include anche un SDK e delle applicazioni di esempio per iniziare a sviluppare applicazioni -mobili che accedono a tali servizi. - -Un *runtime* è la serie di risorse utilizzata per eseguire un'applicazione. {{site.data.keyword.Bluemix_notm}} fornisce ambienti di runtime come contenitori per diversi tipi di applicazioni. Gli ambienti di runtime sono integrati come pacchetti di build in {{site.data.keyword.Bluemix_notm}}, -sono configurati automaticamente per l'utilizzo e richiedono una manutenzione minima, se non nulla. - -Per iniziare a creare la tua applicazione, attieniti alla seguente procedura: - 1. Vai al Dashboard nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. - 2. Fai clic su **CREA UN'APPLICAZIONE**. - 3. Fai clic su **WEB** e attieniti all'esperienza guidata -per scegliere uno starter, specificare un nome e selezionare come desideri eseguire -la codifica. - 4. Dopo che hai terminato l'esperienza guidata, fai clic su **VISUALIZZA PANORAMICA DELL'APPLICAZIONE**. La Panoramica per la tua applicazione è visualizzata nel Dashboard. - 5. Puoi aggiungere un servizio alla tua applicazione facendo clic su **AGGIUNGI UN SERVIZIO O UNA API** nella Panoramica dell'applicazione nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Cerca e seleziona i servizi dal catalogo o scorri alla fine del catalogo e fai clic su Servizi sperimentali **{{site.data.keyword.Bluemix_notm}}** per visualizzare i servizi sperimentali. In alternativa, puoi utilizzare l'interfaccia riga di comando cf. Vedi Opzioni per gestire le applicazioni. - 6. Nella Panoramica dell'applicazione, fai clic su Aggiungi Git per salvare la tua origine applicazione in un repository Git e creare un progetto ospitato da Git. Puoi anche distribuire l'applicazione da {{site.data.keyword.jazzhub_title}}. - -**Nota:** se un servizio che associ mediante bind a un'applicazione si arresta in modo anomalo, l'applicazione potrebbe interrompere l'esecuzione o provocare errori. {{site.data.keyword.Bluemix_notm}} non -riavvia automaticamente l'applicazione per eseguire un ripristino da tali problemi. Valuta una codifica della tua applicazione per identificare e ripristinare interruzioni, eccezioni ed errori -di connessione. Per ulteriori informazioni, consulta l'argomento di risoluzione dei problemi Le applicazioni non si riavviano automaticamente. - -## Opzioni per gestire le applicazioni - -Una volta creata la tua applicazione, disponi di alcune opzioni per continuare ad aggiungere -servizi ad essa, oltre che per crearla e distribuirla: - -
Interfaccia riga di comando cf
-
Usa l'interfaccia riga di comando cf per aggiornare la tua applicazione, creare un'istanza del servizio o eseguire il bind del servizio alla tua applicazione. Puoi anche usare l'interfaccia riga di comando cloud-cli per creare, aggiornare ed eliminare offerte di servizi.
-
Interfaccia utente {{site.data.keyword.Bluemix_notm}}
-
Usa l'interfaccia utente {{site.data.keyword.Bluemix_notm}} per -creare la tua applicazione selezionando, tra l'altro, quali servizi e runtime combinare per risolvere i -tuoi problemi di business.
-
{{site.data.keyword.jazzhub_title}}
-
Usa {{site.data.keyword.jazzhub_title}} per -creare un'applicazione nel cloud e distribuirla a {{site.data.keyword.Bluemix_notm}}. I servizi forniti da {{site.data.keyword.jazzhub_title}} includono Track & Plan e Delivery Pipeline, elencati nel Catalogo {{site.data.keyword.Bluemix_notm}} sotto DevOps, oltre a Web IDE e Git Hosting.
-
- -## Suggerimenti - -Mentre sviluppi le tue applicazioni web, avvaliti dei seguenti suggerimenti: - -
Persistenza
-
Non specificare archiviazioni locali per le tue applicazioni. Ogni istanza -della tua applicazione, anche se è in esecuzione solo una singola istanza, -può essere riavviata o spostata su una macchina virtuale differente in -qualsiasi momento, di norma per il bilanciamento del carico. Tutto quanto è memorizzato -in un'archiviazione locale viene cancellato quando l'applicazione viene spostata -o eliminata. Per la persistenza, usa uno dei servizi di archivio dati {{site.data.keyword.Bluemix_notm}}.
-
Limiti delle risorse
-
Tieni presente i limiti sulle quantità di risorse che un account di prova -può utilizzare. I limiti sono i seguenti: - - - - - - -
Tabella 1. Limiti delle risorse {{site.data.keyword.Bluemix_notm}} per un account di prova
Tipo di risorsa Quantità limite
Numero di servizi utilizzati in tutte le applicazioni 10
Memoria utilizzata in tutte le applicazioni 2 G
Numero di rotte 500
-
+--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2016-04-18" + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Creazione di applicazioni Cloud Foundry + +Con {{site.data.keyword.Bluemix}}, puoi +creare la tua applicazione nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Dopo averla creata, puoi decidere di continuare a usare l'interfaccia utente, l'interfaccia riga di comando cf o {{site.data.keyword.jazzhub_title}} per +sviluppare, tracciare, pianificare e distribuire la tua applicazione. +{:shortdesc} + +Quando crei un'applicazione in {{site.data.keyword.Bluemix_notm}}, +inizi con uno starter. Uno *starter* è un template che include +dei servizi predefiniti e del codice applicativo configurato con uno +specifico pacchetto di build. Ci sono due tipi di starter: contenitori tipo e runtime. + +Un *contenitore tipo* è un contenitore per un'applicazione e il +suo ambiente di runtime associato e i servizi predefiniti per uno specifico dominio. Ad esempio, +il contenitore tipo Mobile Cloud include un runtime Node.js, oltre che i servizi +Mobile Data, Mobile Application Security e Push. Include anche un SDK e delle applicazioni di esempio per iniziare a sviluppare applicazioni +mobili che accedono a tali servizi. + +Un *runtime* è la serie di risorse utilizzata per eseguire un'applicazione. {{site.data.keyword.Bluemix_notm}} fornisce ambienti di runtime come contenitori per diversi tipi di applicazioni. Gli ambienti di runtime sono integrati come pacchetti di build in {{site.data.keyword.Bluemix_notm}}, +sono configurati automaticamente per l'utilizzo e richiedono una manutenzione minima, se non nulla. + +Per iniziare a creare la tua applicazione, attieniti alla seguente procedura: + 1. Vai al Dashboard nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. + 2. Fai clic su **CREA UN'APPLICAZIONE**. + 3. Fai clic su **WEB** e attieniti all'esperienza guidata +per scegliere uno starter, specificare un nome e selezionare come desideri eseguire +la codifica. + 4. Dopo che hai terminato l'esperienza guidata, fai clic su **VISUALIZZA PANORAMICA DELL'APPLICAZIONE**. La Panoramica per la tua applicazione è visualizzata nel Dashboard. + 5. Puoi aggiungere un servizio alla tua applicazione facendo clic su **AGGIUNGI UN SERVIZIO O UNA API** nella Panoramica dell'applicazione nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Cerca e seleziona i servizi dal catalogo o scorri alla fine del catalogo e fai clic su Servizi sperimentali **{{site.data.keyword.Bluemix_notm}}** per visualizzare i servizi sperimentali. In alternativa, puoi utilizzare l'interfaccia riga di comando cf. Vedi Opzioni per gestire le applicazioni. + 6. Nella Panoramica dell'applicazione, fai clic su Aggiungi Git per salvare la tua origine applicazione in un repository Git e creare un progetto ospitato da Git. Puoi anche distribuire l'applicazione da {{site.data.keyword.jazzhub_title}}. + +**Nota:** se un servizio che associ mediante bind a un'applicazione si arresta in modo anomalo, l'applicazione potrebbe interrompere l'esecuzione o provocare errori. {{site.data.keyword.Bluemix_notm}} non +riavvia automaticamente l'applicazione per eseguire un ripristino da tali problemi. Valuta una codifica della tua applicazione per identificare e ripristinare interruzioni, eccezioni ed errori +di connessione. Per ulteriori informazioni, consulta l'argomento di risoluzione dei problemi Le applicazioni non si riavviano automaticamente. + +## Opzioni per gestire le applicazioni + +Una volta creata la tua applicazione, disponi di alcune opzioni per continuare ad aggiungere +servizi ad essa, oltre che per crearla e distribuirla: + +
Interfaccia riga di comando cf
+
Usa l'interfaccia riga di comando cf per aggiornare la tua applicazione, creare un'istanza del servizio o eseguire il bind del servizio alla tua applicazione. Puoi anche usare l'interfaccia riga di comando cloud-cli per creare, aggiornare ed eliminare offerte di servizi.
+
Interfaccia utente {{site.data.keyword.Bluemix_notm}}
+
Usa l'interfaccia utente {{site.data.keyword.Bluemix_notm}} per +creare la tua applicazione selezionando, tra l'altro, quali servizi e runtime combinare per risolvere i +tuoi problemi di business.
+
{{site.data.keyword.jazzhub_title}}
+
Usa {{site.data.keyword.jazzhub_title}} per +creare un'applicazione nel cloud e distribuirla a {{site.data.keyword.Bluemix_notm}}. I servizi forniti da {{site.data.keyword.jazzhub_title}} includono Track & Plan e Delivery Pipeline, elencati nel Catalogo {{site.data.keyword.Bluemix_notm}} sotto DevOps, oltre a Web IDE e Git Hosting.
+
+ +## Suggerimenti + +Mentre sviluppi le tue applicazioni web, avvaliti dei seguenti suggerimenti: + +
Persistenza
+
Non specificare archiviazioni locali per le tue applicazioni. Ogni istanza +della tua applicazione, anche se è in esecuzione solo una singola istanza, +può essere riavviata o spostata su una macchina virtuale differente in +qualsiasi momento, di norma per il bilanciamento del carico. Tutto quanto è memorizzato +in un'archiviazione locale viene cancellato quando l'applicazione viene spostata +o eliminata. Per la persistenza, usa uno dei servizi di archivio dati {{site.data.keyword.Bluemix_notm}}.
+
Limiti delle risorse
+
Tieni presente i limiti sulle quantità di risorse che un account di prova +può utilizzare. I limiti sono i seguenti: + + + + + + +
Tabella 1. Limiti delle risorse {{site.data.keyword.Bluemix_notm}} per un account di prova
Tipo di risorsa Quantità limite
Numero di servizi utilizzati in tutte le applicazioni 10
Memoria utilizzata in tutte le applicazioni 2 G
Numero di rotte 500
+
diff --git a/cfapps/nl/it/runtimes.md b/cfapps/nl/it/runtimes.md index a19313229..149dcb2d7 100644 --- a/cfapps/nl/it/runtimes.md +++ b/cfapps/nl/it/runtimes.md @@ -1,65 +1,65 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2015-11-11" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# Panoramica sui runtime - -Utilizza i runtime per rendere rapidamente operativa la tua applicazione, senza dover configurare e gestire macchine virtuali e sistemi operativi. In -{{site.data.keyword.Bluemix}}, i runtime sono -basati su Cloud Foundry, il che significa che i pacchetti di build della community o i plug-in degli strumenti -per Cloud Foundry funzionano anche con {{site.data.keyword.Bluemix_notm}}. Controlla l'elenco sempre più lungo di runtime per iniziare. -{:shortdesc} - - +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2015-11-11" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# Panoramica sui runtime + +Utilizza i runtime per rendere rapidamente operativa la tua applicazione, senza dover configurare e gestire macchine virtuali e sistemi operativi. In +{{site.data.keyword.Bluemix}}, i runtime sono +basati su Cloud Foundry, il che significa che i pacchetti di build della community o i plug-in degli strumenti +per Cloud Foundry funzionano anche con {{site.data.keyword.Bluemix_notm}}. Controlla l'elenco sempre più lungo di runtime per iniziare. +{:shortdesc} + + diff --git a/cfapps/nl/it/starter_app_usage.md b/cfapps/nl/it/starter_app_usage.md index c3651de96..a8dd4cd7b 100644 --- a/cfapps/nl/it/starter_app_usage.md +++ b/cfapps/nl/it/starter_app_usage.md @@ -1,37 +1,37 @@ ---- - - - -copyright: - - years: 2016, 2017 - -lastupdated: "2016-12-21" - ---- - - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - - -# Utilizzo delle applicazioni starter -{: #using_starter_applications} - -{{site.data.keyword.Bluemix}} fornisce applicazioni starter per i runtime. -Segui questa procedura per utilizzare le applicazioni starter. -{:shortdesc} - -1. Dal [Catalogo {{site.data.keyword.Bluemix_notm}}](https://console.{DomainName}/catalog/), -passa alla sezione Applicazioni Cloud Foundry. -2. Fai clic sul runtime che desideri utilizzare. -3. Se non l'hai già fatto, accedi a {{site.data.keyword.Bluemix_notm}}. -4. Fornisci il nome dell'applicazione, se necessario modifica il nome dell'host e fai clic su **Crea**. -5. Inizia così la preparazione della tua applicazione. All'avvio dell'applicazione ne viene visualizzata la pagina di destinazione sul dashboard {{site.data.keyword.Bluemix_notm}}. -6. Puoi seguire le istruzioni sulla pagina per effettuare le seguenti attività: - * Scarica l'interfaccia riga di comando Cloud Foundry. - * Scarica l'applicazione starter. - * Segui la procedura per la ridistribuzione dell'applicazione starter. -7. Modifica l'applicazione e distribuiscila nuovamente. - -La directory che contiene l'applicazione starter scaricata contiene un file README. Consulta il file README per una descrizione dei file del package applicazione starter. Apporta le modifiche al codice, distribuisci nuovamente l'applicazione e vedi l'effetto di queste operazioni sulla tua applicazione in esecuzione. +--- + + + +copyright: + + years: 2016, 2017 + +lastupdated: "2016-12-21" + +--- + + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + + +# Utilizzo delle applicazioni starter +{: #using_starter_applications} + +{{site.data.keyword.Bluemix}} fornisce applicazioni starter per i runtime. +Segui questa procedura per utilizzare le applicazioni starter. +{:shortdesc} + +1. Dal [Catalogo {{site.data.keyword.Bluemix_notm}}](https://console.{DomainName}/catalog/), +passa alla sezione Applicazioni Cloud Foundry. +2. Fai clic sul runtime che desideri utilizzare. +3. Se non l'hai già fatto, accedi a {{site.data.keyword.Bluemix_notm}}. +4. Fornisci il nome dell'applicazione, se necessario modifica il nome dell'host e fai clic su **Crea**. +5. Inizia così la preparazione della tua applicazione. All'avvio dell'applicazione ne viene visualizzata la pagina di destinazione sul dashboard {{site.data.keyword.Bluemix_notm}}. +6. Puoi seguire le istruzioni sulla pagina per effettuare le seguenti attività: + * Scarica l'interfaccia riga di comando Cloud Foundry. + * Scarica l'applicazione starter. + * Segui la procedura per la ridistribuzione dell'applicazione starter. +7. Modifica l'applicazione e distribuiscila nuovamente. + +La directory che contiene l'applicazione starter scaricata contiene un file README. Consulta il file README per una descrizione dei file del package applicazione starter. Apporta le modifiche al codice, distribuisci nuovamente l'applicazione e vedi l'effetto di queste operazioni sulla tua applicazione in esecuzione. diff --git a/cfapps/nl/ko/hostingapps.md b/cfapps/nl/ko/hostingapps.md index 640dc30d8..b4e8909fe 100644 --- a/cfapps/nl/ko/hostingapps.md +++ b/cfapps/nl/ko/hostingapps.md @@ -15,13 +15,13 @@ lastupdated: "2016-05-09" {:codeblock: .codeblock} {:screen: .screen} -#{{site.data.keyword.Bluemix_notm}}에서 앱 호스팅 +# {{site.data.keyword.Bluemix_notm}}에서 앱 호스팅 {{site.data.keyword.Bluemix}}에서는 애플리케이션을 작성할 수 있음은 물론 기존 애플리케이션을 호스팅할 수도 있습니다. 클라우드 준비 상태이면, 앱을 {{site.data.keyword.Bluemix_notm}}에 마이그레이션할 수 있습니다. {{site.data.keyword.Bluemix_notm}}에서는 애플리케이션을 실행할 수 있도록 다양한 방법을 제공합니다(예: Cloud Foundry, IBM Containers 및 Virtual Machines). -##앱 클라우드 준비 상태 만들기 +## 앱 클라우드 준비 상태 만들기 {: #cloud-readyapps} 클라우드 준비 애플리케이션은 애플리케이션이 디자인되고 빌드될 때 클라우드 플랫폼 원칙을 따릅니다. 클라우드 준비 애플리케이션은 클라우드 플랫폼에서 제공하는 기능을 사용할 수 있습니다. @@ -78,7 +78,7 @@ lastupdated: "2016-05-09" 클라우드 준비 애플리케이션에 대한 자세한 정보는 [The 12-factor application ![외부 링크 아이콘](../icons/launch-glyph.svg)](http://12factor.net/){: new_window}을 참조하십시오. -##앱 마이그레이션 +## 앱 마이그레이션 {: #ht_hostapp} 애플리케이션을 클라우드 환경으로 완전히 이동하는 대신, 증분 방식으로 {{site.data.keyword.Bluemix_notm}}에 애플리케이션을 마이그레이션할 수 있습니다. 우선 애플리케이션의 일부를 마이그레이션한 후에, 클라우드 통합 서비스를 사용하여 기존 데이터 또는 SOR(System of Record)에 연결할 수 있습니다. @@ -100,7 +100,7 @@ lastupdated: "2016-05-09" Cloud Foundry 플랫폼이 애플리케이션 요구사항을 충족하지 않는 경우에는 보다 사용자 정의된 옵션으로 런타임이 설정, 구성되고 유지보수되는 VM 또는 컨테이너를 사용할 수 있습니다. -##cf cli를 사용하여 앱 업로드 +## cf cli를 사용하여 앱 업로드 {: #ht_cfcli} 로컬 클라이언트에서 코드를 관리하고 Cloud Foundry 명령행 인터페이스를 사용하여 애플리케이션을 {{site.data.keyword.Bluemix_notm}}에 수동으로 업로드할 수 있습니다. 코드를 변경하는 경우에는 애플리케이션을 {{site.data.keyword.Bluemix_notm}}에 다시 푸시하여 업데이트된 코드를 실행해야 합니다. @@ -155,7 +155,7 @@ Cloud Foundry 플랫폼이 애플리케이션 요구사항을 충족하지 않 * 애플리케이션의 모든 인스턴스에 대해 조직에 충분한 메모리가 있는지 확인하십시오. 사용자 조직의 메모리 할당량을 보려면 cf org org_name을 사용하십시오. * cf push에 대한 자세한 정보는 [cf 명령](/docs/cli/reference/cfcommands/index.html) 명령을 참조하십시오. -##데이터 마이그레이션 및 서비스 사용 +## 데이터 마이그레이션 및 서비스 사용 {: #ht_service} {{site.data.keyword.Bluemix_notm}}에 애플리케이션을 업로드한 후에는 {{site.data.keyword.Bluemix_notm}} 카탈로그에서 애플리케이션이 연결된 서비스를 선택하고 서비스 인스턴스를 작성하며 인스턴스를 애플리케이션에 바인드한 후에 애플리케이션을 다시 시작하십시오. diff --git a/cfapps/nl/pt/BR/hostingapps.md b/cfapps/nl/pt/BR/hostingapps.md index eb0799a12..56ccb574b 100644 --- a/cfapps/nl/pt/BR/hostingapps.md +++ b/cfapps/nl/pt/BR/hostingapps.md @@ -15,13 +15,13 @@ lastupdated: "2016-05-09" {:codeblock: .codeblock} {:screen: .screen} -#Hospedando apps no {{site.data.keyword.Bluemix_notm}} +# Hospedando apps no {{site.data.keyword.Bluemix_notm}} Com o {{site.data.keyword.Bluemix}}, é possível criar aplicativos, assim como hospedar seus aplicativos existentes. É possível migrar seus apps para o {{site.data.keyword.Bluemix_notm}}, desde que ele esteja pronto para nuvem. O {{site.data.keyword.Bluemix_notm}} fornece várias maneiras de executar seus aplicativos, por exemplo, Cloud Foundry, IBM Containers e Virtual Machines. -##Tornando seus apps prontos para nuvem +## Tornando seus apps prontos para nuvem {: #cloud-readyapps} Um aplicativo pronto para nuvem segue os princípios da plataforma em nuvem, quando o aplicativo é designado e construído. Um aplicativo pronto para nuvem pode usar as capacidades fornecidas pela plataforma em nuvem. @@ -78,7 +78,7 @@ Se todos os princípios a seguir forem observados em seu aplicativo, o aplicativ Para obter mais informações sobre aplicativos prontos para a nuvem, veja [O aplicativo de 12 fatores ![Ícone de link externo](../icons/launch-glyph.svg)](http://12factor.net/){: new_window}. -##Migrando seus apps +## Migrando seus apps {: #ht_hostapp} É possível migrar seus aplicativos para o {{site.data.keyword.Bluemix_notm}} de uma maneira incremental, em vez de deslocar o aplicativo completamente para o ambiente de nuvem. É possível migrar uma parte de seu aplicativo primeiro e conectar aos dados existentes ou sistema de registros usando o serviço de Integração de nuvem. @@ -100,7 +100,7 @@ Para implementar seu aplicativo no {{site.data.keyword.Bluemix_notm}} como um ap Se a plataforma Cloud Foundry não suportar os requisitos de seu aplicativo, será possível usar um contêiner ou máquina virtual em que o tempo de execução é instalado, configurado e mantido com mais opções customizadas. -##Fazendo upload de apps usando cf cli +## Fazendo upload de apps usando cf cli {: #ht_cfcli} É possível gerenciar seu código no cliente local e usar a interface da linha de comandos Cloud Foundry para fazer upload de seu aplicativo para o {{site.data.keyword.Bluemix_notm}} manualmente. Se você alterar o código, deverá enviar o aplicativo por push para o {{site.data.keyword.Bluemix_notm}} novamente, para executar o código atualizado. @@ -155,7 +155,7 @@ Execute as etapas a seguir para migrar seu aplicativo. * Assegure-se de que sua organização tenha memória suficiente para todas as instâncias de seu aplicativo. Para visualizar a cota de memória de sua organização, use cf org org_name. * Para obter mais informações sobre cf push, consulte [comandos cf](/docs/cli/reference/cfcommands/index.html). -##Migrando seus dados e usando serviços +## Migrando seus dados e usando serviços {: #ht_service} Depois de fazer upload de seu aplicativo para o {{site.data.keyword.Bluemix_notm}}, selecione o serviço ao qual o aplicativo está conectado, no catálogo do {{site.data.keyword.Bluemix_notm}}, crie uma instância de serviço, vincule as instâncias ao seu aplicativo e depois reinicie o aplicativo. diff --git a/cfapps/nl/zh/CN/hostingapps.md b/cfapps/nl/zh/CN/hostingapps.md index 3ecbc63e1..76dc549e6 100644 --- a/cfapps/nl/zh/CN/hostingapps.md +++ b/cfapps/nl/zh/CN/hostingapps.md @@ -15,13 +15,13 @@ lastupdated: "2016-05-09" {:codeblock: .codeblock} {:screen: .screen} -#在 {{site.data.keyword.Bluemix_notm}} 中托管应用程序 +# 在 {{site.data.keyword.Bluemix_notm}} 中托管应用程序 通过 {{site.data.keyword.Bluemix}}，您可以创建应用程序以及托管现有应用程序。只要您的应用程序是云就绪型应用程序，就可以将其迁移到 {{site.data.keyword.Bluemix_notm}} 中。{{site.data.keyword.Bluemix_notm}} 为您提供了各种运行应用程序的方法，例如 Cloud Foundry、IBM Containers 和虚拟机。 -##使应用程序成为云就绪型应用程序 +## 使应用程序成为云就绪型应用程序 {: #cloud-readyapps} 云就绪型应用程序的设计和构建遵循云平台原则。云就绪型应用程序可以使用云平台提供的各项功能。 @@ -78,7 +78,7 @@ lastupdated: "2016-05-09" 有关云就绪型应用程序的更多信息，请参阅 [The 12-factor application ![外部链接图标](../icons/launch-glyph.svg)](http://12factor.net/){: new_window}。 -##迁移应用程序 +## 迁移应用程序 {: #ht_hostapp} 您可以将应用程序以递增方式迁移到 {{site.data.keyword.Bluemix_notm}} 中，而不是一下子将应用程序完全转移到云环境中。您可以先迁移应用程序的一部分，然后使用 Cloud Integration 服务来连接到现有数据或记录系统。 @@ -100,7 +100,7 @@ lastupdated: "2016-05-09" 如果 Cloud Foundry 平台不支持应用程序需求，那么可以使用可通过更多定制选项来设置、配置和维护运行时的容器或 VM。 -##使用 cf cli 上传应用程序 +## 使用 cf cli 上传应用程序 {: #ht_cfcli} 可以在本地客户机上管理代码，并使用 Cloud Foundry 命令行界面将应用程序手动上传到 {{site.data.keyword.Bluemix_notm}}。如果更改了代码，必须将应用程序重新推送到 {{site.data.keyword.Bluemix_notm}} 才能运行更新后的代码。 @@ -146,7 +146,7 @@ lastupdated: "2016-05-09" * 确保组织的内存足够供应用程序的所有实例使用。要查看组织的内存配额，请使用 cf org org_name。 * 有关 cf push 的更多信息，请参阅 [cf 命令](/docs/cli/reference/cfcommands/index.html)。 -##迁移数据和使用服务 +## 迁移数据和使用服务 {: #ht_service} 将应用程序上传到 {{site.data.keyword.Bluemix_notm}} 后，从 {{site.data.keyword.Bluemix_notm}}“目录”中选择与该应用程序连接的服务，创建服务实例，将实例绑定到该应用程序，然后重新启动该应用程序。 diff --git a/cli/nl/es/plugins/pnp/index.md b/cli/nl/es/plugins/pnp/index.md index 2d436ef94..56062f224 100644 --- a/cli/nl/es/plugins/pnp/index.md +++ b/cli/nl/es/plugins/pnp/index.md @@ -98,12 +98,12 @@ Para ver la información de ayuda para los mandatos, ejecute: `bluemix network [ bluemix network pnp-routers [--verbose (o -v)] ``` -#####Parámetros opcionales +##### Parámetros opcionales {: #op1} * **--verbose (o -v)** (distintivo): Ver la información de red detallada sobre cada direccionador. -######Ejemplo de mandato +###### Ejemplo de mandato {: #ex1} Para ver la información de red sobre todos los direccionadores: @@ -153,13 +153,13 @@ Para ver la información de red detallada sobre todos los direccionadores: bluemix network pnp-create ``` -#####Parámetros +##### Parámetros {: #p1} * **ip_direccionador**: direcciones IP de los dos direccionadores que desea conectar. Puede encontrar las direcciones IP utilizando el mandato: `bluemix network pnp-routers` * **nombre**: nombre de la conexión de igualdad de red privada. -######Ejemplo de mandato +###### Ejemplo de mandato {: #ex2} $ bluemix network pnp-create 129.41.234.246 129.41.237.172 demo @@ -170,19 +170,19 @@ bluemix network pnp-create Conexión de igualdad de red privada 'demo' creada. -####Crear una conexión de igualdad de red privada utilizando el nombre de la conexión +#### Crear una conexión de igualdad de red privada utilizando el nombre de la conexión ``` bluemix network pnp-create -i ``` -#####Parámetros +##### Parámetros {: #p2} * **--interactive (-i)** (distintivo): Modalidad interactiva para seleccionar direccionadores. * **nombre**: nombre de la conexión de igualdad de red privada. -######Ejemplo de mandato +###### Ejemplo de mandato {: #ex3} $ bluemix network pnp-create -i demo @@ -208,12 +208,12 @@ bluemix network pnp-create -i bluemix network pnp-show [--verbose (o -v)] ``` -#####Parámetros opcionales +##### Parámetros opcionales {: #op2} * **--verbose (o -v)** (distintivo): Ver la información de red detallada sobre cada direccionador. -######Ejemplo de mandato +###### Ejemplo de mandato {: #ex4} Ver información básica: @@ -247,16 +247,16 @@ Ver información detallada: ``` bluemix network pnp-delete [--force (o -f)] ``` -#####Parámetros +##### Parámetros {: #p3} * **id_conexión**: Uno o varios ID de conexión separados por una coma. -#####Parámetros opcionales +##### Parámetros opcionales {: #op3} * **--force (o -f)** (distintivo): Suprime la conexión sin solicitar la confirmación. -######Ejemplo de mandato: +###### Ejemplo de mandato: {: #ex5} Suprimir una conexión: diff --git a/cli/nl/it/bxplug-in.md b/cli/nl/it/bxplug-in.md index 4fd86afd0..3ce22309b 100644 --- a/cli/nl/it/bxplug-in.md +++ b/cli/nl/it/bxplug-in.md @@ -1,22 +1,22 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2017-01-12" - - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} - -# Plug-in interfaccia riga di comando {{site.data.keyword.Bluemix_notm}} (bx cli) - -Estendi la tua interfaccia riga di comando {{site.data.keyword.Bluemix_notm}} (bx cli) con i plug-in. Puoi installare e utilizzare i plug-in disponibili in [Repository di plug-in CLI ![icona link esterno](../icons/launch-glyph.svg)](http://plugins.ng.bluemix.net/){: new_window}. Ciascun plug-in viene identificato dal proprio nome file binario, dal nome plug-in definito dallo sviluppatore e dai comandi forniti dal plug-in. Puoi utilizzare il nome file binario solo per installare un plug-in, mentre per eseguire qualsiasi altra azione puoi utilizzare il nome plug-in o un comando. -{:shortdesc} +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2017-01-12" + + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} + +# Plug-in interfaccia riga di comando {{site.data.keyword.Bluemix_notm}} (bx cli) + +Estendi la tua interfaccia riga di comando {{site.data.keyword.Bluemix_notm}} (bx cli) con i plug-in. Puoi installare e utilizzare i plug-in disponibili in [Repository di plug-in CLI ![icona link esterno](../icons/launch-glyph.svg)](http://plugins.ng.bluemix.net/){: new_window}. Ciascun plug-in viene identificato dal proprio nome file binario, dal nome plug-in definito dallo sviluppatore e dai comandi forniti dal plug-in. Puoi utilizzare il nome file binario solo per installare un plug-in, mentre per eseguire qualsiasi altra azione puoi utilizzare il nome plug-in o un comando. +{:shortdesc} diff --git a/cli/nl/it/cliplug-in.md b/cli/nl/it/cliplug-in.md index 942d84f06..7a28a9ca0 100644 --- a/cli/nl/it/cliplug-in.md +++ b/cli/nl/it/cliplug-in.md @@ -1,21 +1,21 @@ ---- - - - -copyright: - - years: 2015, 2017 - -lastupdated: "2017-01-12" - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} - -# Plug-in interfaccia riga di comando Cloud Foundry - -Puoi installare e utilizzare i plug-in interfaccia riga di comando Cloud Foundry (cf cli) disponibili in [Repository di plug-in CLI ![icona link esterno](../icons/launch-glyph.svg)](http://plugins.ng.bluemix.net/){: new_window}. Ciascun plug-in viene identificato dal proprio nome file binario, dal nome plug-in definito dallo sviluppatore e dai comandi forniti dal plug-in. Puoi utilizzare il nome file binario solo per installare un plug-in, mentre per eseguire qualsiasi altra azione puoi utilizzare il nome plug-in o un comando. -{:shortdesc} +--- + + + +copyright: + + years: 2015, 2017 + +lastupdated: "2017-01-12" + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} + +# Plug-in interfaccia riga di comando Cloud Foundry + +Puoi installare e utilizzare i plug-in interfaccia riga di comando Cloud Foundry (cf cli) disponibili in [Repository di plug-in CLI ![icona link esterno](../icons/launch-glyph.svg)](http://plugins.ng.bluemix.net/){: new_window}. Ciascun plug-in viene identificato dal proprio nome file binario, dal nome plug-in definito dallo sviluppatore e dai comandi forniti dal plug-in. Puoi utilizzare il nome file binario solo per installare un plug-in, mentre per eseguire qualsiasi altra azione puoi utilizzare il nome plug-in o un comando. +{:shortdesc} diff --git a/cli/nl/it/clireference.md b/cli/nl/it/clireference.md index 87d8b3f4c..4d304a0f6 100644 --- a/cli/nl/it/clireference.md +++ b/cli/nl/it/clireference.md @@ -1,25 +1,25 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2017-01-12" - - - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} - -# Riferimenti dell'interfaccia riga di comando - -{{site.data.keyword.IBM}} {{site.data.keyword.Bluemix_short}} utilizza -l'interfaccia riga di comando Cloud Foundry, cf, per -modificare le applicazioni, le istanze di servizio e i bind di servizio. Puoi anche utilizzare lo strumento riga di comando {{site.data.keyword.Bluemix_notm}} che fornisce un'esperienza ampliata per gestire il tuo ambiente {{site.data.keyword.Bluemix_notm}} oltre le applicazioni Cloud Foundry. -{:shortdesc} +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2017-01-12" + + + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} + +# Riferimenti dell'interfaccia riga di comando + +{{site.data.keyword.IBM}} {{site.data.keyword.Bluemix_short}} utilizza +l'interfaccia riga di comando Cloud Foundry, cf, per +modificare le applicazioni, le istanze di servizio e i bind di servizio. Puoi anche utilizzare lo strumento riga di comando {{site.data.keyword.Bluemix_notm}} che fornisce un'esperienza ampliata per gestire il tuo ambiente {{site.data.keyword.Bluemix_notm}} oltre le applicazioni Cloud Foundry. +{:shortdesc} diff --git a/cli/nl/it/index.md b/cli/nl/it/index.md index 924439673..176ac9636 100644 --- a/cli/nl/it/index.md +++ b/cli/nl/it/index.md @@ -1,113 +1,113 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2017-01-12" - - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} - -# CLI e strumenti di sviluppo -{: #cli} - -Con {{site.data.keyword.Bluemix_short}}, hai accesso a potenti strumenti, quali un'interfaccia riga di comando unificata e i plug-in delle CLI. Ciascuno di questi download di CLI è disponibile a supporto della tua esperienza {{site.data.keyword.Bluemix_notm}}. -{:shortdesc} - -## ![](./images/CLI.svg) Interfacce riga di comando -{: #downloads} - -Scarica e installa le interfacce riga di comando a supporto della tua esperienza {{site.data.keyword.Bluemix_notm}}. - -Lo strumento riga di comando cf Cloud Foundry è un prerequisito per tutti gli altri strumenti CLI {{site.data.keyword.Bluemix_notm}}. Lo strumento riga di comando {{site.data.keyword.Bluemix_notm}} fornisce un'esperienza ampliata per gestire il tuo ambiente {{site.data.keyword.Bluemix_notm}} oltre le applicazioni Cloud Foundry. - -Questi strumenti CLI utilizzano entrambi la porta 443 per impostazione predefinita. Se è presente un proxy tra gli strumenti CLI e l'ambiente {{site.data.keyword.Bluemix_notm}}, devi configurare la variabile di ambiente `http-proxy` con la porta e l'url del proxy HTTP attuali se presenti. Per ulteriori dettagli, consulta [Utilizzo della CLI con un server proxy HTTP ![icona link esterno](../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/cf-cli/http-proxy.html){: new_window}s. - - -| *{{site.data.keyword.Bluemix_notm}}: bx* | *Cloud Foundry: cf* | -|---------------------|---------------| -| [Scarica CLI](http://clis.ng.bluemix.net/)
[Visualizza documenti](/docs/cli/reference/bluemix_cli/index.html)| [Scarica CLI ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/cli/releases){: new_window}
[Visualizza documenti](/docs/cli/reference/cfcommands/index.html) | -{: caption="Table 1. CLI download" caption-side="top"} - - -## ![](./images/CLI_Plugin.svg) Plug-in di interfaccia riga di comando - -Estendi facilmente la tua interfaccia riga di comando {{site.data.keyword.Bluemix_notm}} con più comandi. Per accedere ai plug-in di interfaccia riga di comando -{{site.data.keyword.Bluemix_notm}}, consulta il [Repository di plug-in CLI![icona link esterno](../icons/launch-glyph.svg)](https://plugins.ng.bluemix.net/). - -### Estendi la tua interfaccia riga di comando {{site.data.keyword.Bluemix_notm}}: bx -{: cli_bluemix_ext} - -* Per installare i plug-in CLI {{site.data.keyword.Bluemix_notm}} dal registro {{site.data.keyword.Bluemix_notm}}, imposta l'endpoint di registro di plug-in: - -``` -bluemix plugin repo-add bluemix-bx https://plugins.ng.bluemix.net -``` -{: codeblock} - -* Immetti quindi il seguente comando per installare un plug-in: - -``` -bluemix plugin install plugin_name -r bluemix-bx -``` -{: codeblock} - - -| *{{site.data.keyword.activedeployshort}} CLI* | *{{site.data.keyword.autoscaling}} CLI* | *IBM Containers* | -|-----|-----|-----| -| Nome del plug-in: active-deploy
[Visualizza documenti](/docs/services/ActiveDeploy/cli.html#cli) | Nome del plug-in: auto-scaling
[Visualizza documenti](/docs/cli/plugins/auto-scaling/index.html) | Nome del plug-in: IBM-Containers
[Visualizza documenti](/docs/cli/plugins/containers/index.html) | -{: caption="Table 2. Plug-ins" caption-side="top"} - -| *Peering della rete privata* | *VPN* | -|-----|-----| -| Nome del plug-in: private-network-peering
[Visualizza documenti](/docs/cli/plugins/pnp/index.html) |Nome del plug-in: VPN
[Visualizza documenti](/docs/cli/plugins/bx_vpn/index.html) | -{: caption="Table 3. Plug-ins" caption-side="top"} - - -### Estendi la tua interfaccia riga di comando Cloud Foundry: cf -{: cli_cf_ext} - -* Per installare i plug-in CLI dal registro {{site.data.keyword.Bluemix_notm}}, imposta l'endpoint di registro di plug-in: - -``` -cf add-plugin-repo bluemix-cf https://plugins.ng.bluemix.net -``` -{: codeblock} - -* Immetti quindi il seguente comando per installare un plug-in: - -``` -cf install-plugin plugin_name -r bluemix-cf -``` -{: codeblock} - - -| *Active Deploy* | *Console di gestione* | -|-----------------|-----------------| -| Nome del plug-in: active-deploy
[Visualizza documenti](/docs/services/ActiveDeploy/cli.html#cli) | Nome del plug-in: bluemix-admin
[Visualizza documenti](/docs/cli/plugins/bluemix_admin/index.html) | -{: caption="Table 4. Plug-ins" caption-side="top"} - - -| *{{site.data.keyword.IBM}} Containers for {{site.data.keyword.Bluemix_notm}}* | *VPN* | -|-----------------|-----------------| -| Nome del plug-in: ibm-containers
[Visualizza documenti](https://www.{DomainName}/docs/containers/container_cli_cfic.html#container_cli_cfic) | Nome del plug-in: VPN
[Visualizza documenti](/docs/cli/plugins/vpn/index.html) | -{: caption="Table 5. Plug-ins" caption-side="top"} - - -## ![](./images/Integrated_Dev_Tools.svg) Strumenti di sviluppo integrati - -Scarica e installa i plug-in per integrare i tuoi servizi {{site.data.keyword.Bluemix_notm}} preferiti. - -| *{{site.data.keyword.jazzhub_short}}* | *Liberty for Java* | *MobileFirst* | *{{site.data.keyword.rules_short}}* | *Eclipse Tools for Bluemix* | -|-------------|----------|----------|----------|----------| -| [Plug-in Eclipse Egit -![icona link esterno](../icons/launch-glyph.svg)](https://hub.jazz.net/docs/reference/gitclient/#eclipse_using_egit){: new_window}
[Plugin RTC Eclipse ![icona link esterno](../icons/launch-glyph.svg)](https://hub.jazz.net/docs/reference/gitclient/#eclipse_using_rtc){: new_window} | [Plugin Liberty Eclipse ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/wasdev/downloads/liberty-profile-using-eclipse/){: new_window} | [Plugin Eclipse ![icona link esterno](../icons/launch-glyph.svg)](https://marketplace.eclipse.org/content/ibm-mobilefirst-platform-studio){: new_window} | [Plugin Rules Designer Eclipse ![icona link esterno](../icons/launch-glyph.svg)](/docs/services/rules/index.html#rulov002) | [Plugin Bluemix Eclipse ![icona link esterno](../icons/launch-glyph.svg)](https://console.ng.bluemix.net/docs/manageapps/eclipsetools/eclipsetools.html){: new_window} | -{: caption="Table 6. Plug-ins" caption-side="top"} +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2017-01-12" + + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} + +# CLI e strumenti di sviluppo +{: #cli} + +Con {{site.data.keyword.Bluemix_short}}, hai accesso a potenti strumenti, quali un'interfaccia riga di comando unificata e i plug-in delle CLI. Ciascuno di questi download di CLI è disponibile a supporto della tua esperienza {{site.data.keyword.Bluemix_notm}}. +{:shortdesc} + +## ![](./images/CLI.svg) Interfacce riga di comando +{: #downloads} + +Scarica e installa le interfacce riga di comando a supporto della tua esperienza {{site.data.keyword.Bluemix_notm}}. + +Lo strumento riga di comando cf Cloud Foundry è un prerequisito per tutti gli altri strumenti CLI {{site.data.keyword.Bluemix_notm}}. Lo strumento riga di comando {{site.data.keyword.Bluemix_notm}} fornisce un'esperienza ampliata per gestire il tuo ambiente {{site.data.keyword.Bluemix_notm}} oltre le applicazioni Cloud Foundry. + +Questi strumenti CLI utilizzano entrambi la porta 443 per impostazione predefinita. Se è presente un proxy tra gli strumenti CLI e l'ambiente {{site.data.keyword.Bluemix_notm}}, devi configurare la variabile di ambiente `http-proxy` con la porta e l'url del proxy HTTP attuali se presenti. Per ulteriori dettagli, consulta [Utilizzo della CLI con un server proxy HTTP ![icona link esterno](../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/cf-cli/http-proxy.html){: new_window}s. + + +| *{{site.data.keyword.Bluemix_notm}}: bx* | *Cloud Foundry: cf* | +|---------------------|---------------| +| [Scarica CLI](http://clis.ng.bluemix.net/)
[Visualizza documenti](/docs/cli/reference/bluemix_cli/index.html)| [Scarica CLI ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/cli/releases){: new_window}
[Visualizza documenti](/docs/cli/reference/cfcommands/index.html) | +{: caption="Table 1. CLI download" caption-side="top"} + + +## ![](./images/CLI_Plugin.svg) Plug-in di interfaccia riga di comando + +Estendi facilmente la tua interfaccia riga di comando {{site.data.keyword.Bluemix_notm}} con più comandi. Per accedere ai plug-in di interfaccia riga di comando +{{site.data.keyword.Bluemix_notm}}, consulta il [Repository di plug-in CLI![icona link esterno](../icons/launch-glyph.svg)](https://plugins.ng.bluemix.net/). + +### Estendi la tua interfaccia riga di comando {{site.data.keyword.Bluemix_notm}}: bx +{: cli_bluemix_ext} + +* Per installare i plug-in CLI {{site.data.keyword.Bluemix_notm}} dal registro {{site.data.keyword.Bluemix_notm}}, imposta l'endpoint di registro di plug-in: + +``` +bluemix plugin repo-add bluemix-bx https://plugins.ng.bluemix.net +``` +{: codeblock} + +* Immetti quindi il seguente comando per installare un plug-in: + +``` +bluemix plugin install plugin_name -r bluemix-bx +``` +{: codeblock} + + +| *{{site.data.keyword.activedeployshort}} CLI* | *{{site.data.keyword.autoscaling}} CLI* | *IBM Containers* | +|-----|-----|-----| +| Nome del plug-in: active-deploy
[Visualizza documenti](/docs/services/ActiveDeploy/cli.html#cli) | Nome del plug-in: auto-scaling
[Visualizza documenti](/docs/cli/plugins/auto-scaling/index.html) | Nome del plug-in: IBM-Containers
[Visualizza documenti](/docs/cli/plugins/containers/index.html) | +{: caption="Table 2. Plug-ins" caption-side="top"} + +| *Peering della rete privata* | *VPN* | +|-----|-----| +| Nome del plug-in: private-network-peering
[Visualizza documenti](/docs/cli/plugins/pnp/index.html) |Nome del plug-in: VPN
[Visualizza documenti](/docs/cli/plugins/bx_vpn/index.html) | +{: caption="Table 3. Plug-ins" caption-side="top"} + + +### Estendi la tua interfaccia riga di comando Cloud Foundry: cf +{: cli_cf_ext} + +* Per installare i plug-in CLI dal registro {{site.data.keyword.Bluemix_notm}}, imposta l'endpoint di registro di plug-in: + +``` +cf add-plugin-repo bluemix-cf https://plugins.ng.bluemix.net +``` +{: codeblock} + +* Immetti quindi il seguente comando per installare un plug-in: + +``` +cf install-plugin plugin_name -r bluemix-cf +``` +{: codeblock} + + +| *Active Deploy* | *Console di gestione* | +|-----------------|-----------------| +| Nome del plug-in: active-deploy
[Visualizza documenti](/docs/services/ActiveDeploy/cli.html#cli) | Nome del plug-in: bluemix-admin
[Visualizza documenti](/docs/cli/plugins/bluemix_admin/index.html) | +{: caption="Table 4. Plug-ins" caption-side="top"} + + +| *{{site.data.keyword.IBM}} Containers for {{site.data.keyword.Bluemix_notm}}* | *VPN* | +|-----------------|-----------------| +| Nome del plug-in: ibm-containers
[Visualizza documenti](https://www.{DomainName}/docs/containers/container_cli_cfic.html#container_cli_cfic) | Nome del plug-in: VPN
[Visualizza documenti](/docs/cli/plugins/vpn/index.html) | +{: caption="Table 5. Plug-ins" caption-side="top"} + + +## ![](./images/Integrated_Dev_Tools.svg) Strumenti di sviluppo integrati + +Scarica e installa i plug-in per integrare i tuoi servizi {{site.data.keyword.Bluemix_notm}} preferiti. + +| *{{site.data.keyword.jazzhub_short}}* | *Liberty for Java* | *MobileFirst* | *{{site.data.keyword.rules_short}}* | *Eclipse Tools for Bluemix* | +|-------------|----------|----------|----------|----------| +| [Plug-in Eclipse Egit +![icona link esterno](../icons/launch-glyph.svg)](https://hub.jazz.net/docs/reference/gitclient/#eclipse_using_egit){: new_window}
[Plugin RTC Eclipse ![icona link esterno](../icons/launch-glyph.svg)](https://hub.jazz.net/docs/reference/gitclient/#eclipse_using_rtc){: new_window} | [Plugin Liberty Eclipse ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/wasdev/downloads/liberty-profile-using-eclipse/){: new_window} | [Plugin Eclipse ![icona link esterno](../icons/launch-glyph.svg)](https://marketplace.eclipse.org/content/ibm-mobilefirst-platform-studio){: new_window} | [Plugin Rules Designer Eclipse ![icona link esterno](../icons/launch-glyph.svg)](/docs/services/rules/index.html#rulov002) | [Plugin Bluemix Eclipse ![icona link esterno](../icons/launch-glyph.svg)](https://console.ng.bluemix.net/docs/manageapps/eclipsetools/eclipsetools.html){: new_window} | +{: caption="Table 6. Plug-ins" caption-side="top"} diff --git a/cli/nl/it/integrated_dev_tools.md b/cli/nl/it/integrated_dev_tools.md index a70e6af74..e50526f61 100644 --- a/cli/nl/it/integrated_dev_tools.md +++ b/cli/nl/it/integrated_dev_tools.md @@ -1,20 +1,20 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2015-11-10" - - ---- - -{:shortdesc: .shortdesc} - -# Strumenti di sviluppo integrati - - -Gli strumenti di sviluppo integrati come {{site.data.keyword.Bluemix}} ti consentono di aggiornare rapidamente l'istanza dell'applicazione su Bluemix ed eseguire attività di sviluppo come faresti sul desktop senza rieseguire la distribuzione. -{:shortdesc} +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2015-11-10" + + +--- + +{:shortdesc: .shortdesc} + +# Strumenti di sviluppo integrati + + +Gli strumenti di sviluppo integrati come {{site.data.keyword.Bluemix}} ti consentono di aggiornare rapidamente l'istanza dell'applicazione su Bluemix ed eseguire attività di sviluppo come faresti sul desktop senza rieseguire la distribuzione. +{:shortdesc} diff --git a/cli/nl/it/plugins/auto-scaling/index.md b/cli/nl/it/plugins/auto-scaling/index.md index cd3f2753c..5653e814c 100644 --- a/cli/nl/it/plugins/auto-scaling/index.md +++ b/cli/nl/it/plugins/auto-scaling/index.md @@ -1,143 +1,143 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2011-01-12" - - ---- - -{:codeblock: .codeblock} -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# CLI Auto-Scaling -{: #autoscalingcli} - - -Puoi configurare il servizio {{site.data.keyword.autoscaling}} utilizzando la CLI {{site.data.keyword.autoscaling}} per {{site.data.keyword.Bluemix_notm}}. La CLI {{site.data.keyword.autoscaling}} supporta Linux64, Win64 e OSX e fornisce delle funzionalità simili a quelle fornite dall'API RESTful di ridimensionamento automatico. -{: shortdesc} - -Prima di iniziare, installa la CLI {{site.data.keyword.Bluemix_notm}}. Consulta [Download {{site.data.keyword.Bluemix_notm}} CLI ![icona link esterno](../../../icons/launch-glyph.svg)](http://plugins.ng.bluemix.net/ui/home.html){: new_window} per istruzioni. - -## Aggiunta del plug-in CLI {{site.data.keyword.Bluemix_notm}} - -Una volta installata la CLI {{site.data.keyword.Bluemix_notm}}, puoi aggiungere il plug-in della CLI {{site.data.keyword.autoscaling}}. - -Completa la seguente procedura per aggiungere il repository e installare il plug-in: -1. Per aggiungere il repository di plug-in della CLI {{site.data.keyword.Bluemix_notm}}, immetti il seguente comando: -``` -bluemix plugin repo-add bluemix-plugin-repo https://plugins.ng.bluemix.net -``` -2. Per installare il plug-in della CLI {{site.data.keyword.autoscaling}}, immetti il seguente comando: -``` -bluemix plugin install auto-scaling -r bluemix-plugin-repo -``` - -## Collegamento di una politica di ridimensionamento automatico - -Puoi collegare una politica di ridimensionamento automatico a una specifica applicazione. Eseguendo il seguente comando: - -``` -bx as policy-attach -p -``` -{: codeblock} - -
-
<APP_NAME>
-
Il nome dell'applicazione a cui collegare una politica di ridimensionamento automatico.
-
<policy_file>
-
Il nome del file JSON che descrive la politica di ridimensionamento automatico. Vedi la documentazione dell'API RESTful {{site.data.keyword.autoscaling}} per ulteriori dettagli.
-
- - -## Generazione di una politica di ridimensionamento automatico - -Puoi generare una politica di ridimensionamento automatico rispondendo alle domande visualizzate nell'interfaccia riga di comando. A seconda del tuo input, un file JSON contenente la definizione della politica di ridimensionamento automatico viene salvato con il nome immesso. Se non immetti il nome del file, il contenuto della politica viene stampato direttamente nella riga di comando senza essere salvato in un file. Immetti il seguente comando: - -``` -bx as policy-create -``` -{: codeblock} - - -## Visualizzazione di una politica di ridimensionamento automatico - -Puoi visualizzare la politica di ridimensionamento automatico di un'applicazione. Il contenuto della politica viene stampato direttamente nella riga di comando. Immetti il seguente comando: - -``` -bx as policy-show [--json] -``` -{: codeblock} - -
-
<APP_NAME>
-
Il nome dell'applicazione per cui visualizzare la politica di ridimensionamento automatico. Per impostazione predefinita, la struttura JSON viene tradotta in una serie di output leggibili.
-
- -**Suggerimento:** puoi anche utilizzare l'opzione **--json** per stampare invece la riposta JSON originale. - - -## Scollegamento di una politica di ridimensionamento automatico - -Puoi rimuovere una politica di ridimensionamento automatico da un'applicazione. Eseguendo il seguente comando: - -``` -bx as policy-detach -``` -{: codeblock} - -
-
<APP_NAME>
-
Il nome dell'applicazione per la quale scollegare la politica di ridimensionamento automatico.
-
- - -## Abilitazione o disabilitazione di una politica di ridimensionamento automatico - -Puoi abilitare o disabilitare la politica di ridimensionamento automatico di una specifica applicazione. Eseguendo il seguente comando: - -``` -bx as policy-enable|policy-disable -``` -{: codeblock} - -
-
<APP_NAME>
-
Il nome dell'applicazione per cui abilitare o disabilitare la politica di ridimensionamento automatico.
-
- - -## Visualizzazione della cronologia di ridimensionamento automatico di un'applicazione - -Puoi visualizzare la cronologia dell'attività di ridimensionamento automatico di una specifica applicazione. Una tabella di record della cronologia del ridimensionamento automatico viene visualizzata nell'interfaccia riga di comando. - -``` -bx as history-show [--start-date=] [--end-date=] [--json] -``` -{: codeblock} - -
-
<APP_NAME>
-
Il nome dell'applicazione per cui visualizzare la cronologia della politica di ridimensionamento automatico. -
<start_timestamp>
-
La data e ora di inizio dell'intervallo della cronologia. I formati supportati sono `yyyy-MM-ddTHH:mm:ss+/-hhmm, yyyy-MM-ddTHH:mm:ssZ`. Per impostazione predefinita, la data e ora viene impostata su 50 ore avanti rispetto all'ora corrente. Consulta la W3C Date e Time Formats standard per i dettagli relativi al formato data e ora. -
<end_timestamp>
-
La data e ora di fine dell'intervallo della cronologia. I formati supportati sono `yyyy-MM-ddTHH:mm:ss+/-hhmm, yyyy-MM-ddTHH:mm:ssZ`. Per impostazione predefinita, la data e ora viene impostata sull'ora corrente. Consulta la W3C Date e Time Formats standard per i dettagli relativi al formato data e ora. -
- - - -**Suggerimento:** puoi anche utilizzare l'opzione **--json** per stampare invece la riposta JSON originale. - -# rellinks -{: rellinks} -## generale -{: general} -* [{{site.data.keyword.autoscaling}}servizio](/docs/services/Auto-Scaling/index.html) -* [{{site.data.keyword.Bluemix_notm}} CLI ![icona link esterno](../../../icons/launch-glyph.svg)](http://plugins.ng.bluemix.net/ui/home.html){: new_window} -* [W3C Date and Time Formats standard ![icona link esterno](../../../icons/launch-glyph.svg)](https://www.w3.org/TR/NOTE-datetime){: new_window} +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2011-01-12" + + +--- + +{:codeblock: .codeblock} +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# CLI Auto-Scaling +{: #autoscalingcli} + + +Puoi configurare il servizio {{site.data.keyword.autoscaling}} utilizzando la CLI {{site.data.keyword.autoscaling}} per {{site.data.keyword.Bluemix_notm}}. La CLI {{site.data.keyword.autoscaling}} supporta Linux64, Win64 e OSX e fornisce delle funzionalità simili a quelle fornite dall'API RESTful di ridimensionamento automatico. +{: shortdesc} + +Prima di iniziare, installa la CLI {{site.data.keyword.Bluemix_notm}}. Consulta [Download {{site.data.keyword.Bluemix_notm}} CLI ![icona link esterno](../../../icons/launch-glyph.svg)](http://plugins.ng.bluemix.net/ui/home.html){: new_window} per istruzioni. + +## Aggiunta del plug-in CLI {{site.data.keyword.Bluemix_notm}} + +Una volta installata la CLI {{site.data.keyword.Bluemix_notm}}, puoi aggiungere il plug-in della CLI {{site.data.keyword.autoscaling}}. + +Completa la seguente procedura per aggiungere il repository e installare il plug-in: +1. Per aggiungere il repository di plug-in della CLI {{site.data.keyword.Bluemix_notm}}, immetti il seguente comando: +``` +bluemix plugin repo-add bluemix-plugin-repo https://plugins.ng.bluemix.net +``` +2. Per installare il plug-in della CLI {{site.data.keyword.autoscaling}}, immetti il seguente comando: +``` +bluemix plugin install auto-scaling -r bluemix-plugin-repo +``` + +## Collegamento di una politica di ridimensionamento automatico + +Puoi collegare una politica di ridimensionamento automatico a una specifica applicazione. Eseguendo il seguente comando: + +``` +bx as policy-attach -p +``` +{: codeblock} + +
+
<APP_NAME>
+
Il nome dell'applicazione a cui collegare una politica di ridimensionamento automatico.
+
<policy_file>
+
Il nome del file JSON che descrive la politica di ridimensionamento automatico. Vedi la documentazione dell'API RESTful {{site.data.keyword.autoscaling}} per ulteriori dettagli.
+
+ + +## Generazione di una politica di ridimensionamento automatico + +Puoi generare una politica di ridimensionamento automatico rispondendo alle domande visualizzate nell'interfaccia riga di comando. A seconda del tuo input, un file JSON contenente la definizione della politica di ridimensionamento automatico viene salvato con il nome immesso. Se non immetti il nome del file, il contenuto della politica viene stampato direttamente nella riga di comando senza essere salvato in un file. Immetti il seguente comando: + +``` +bx as policy-create +``` +{: codeblock} + + +## Visualizzazione di una politica di ridimensionamento automatico + +Puoi visualizzare la politica di ridimensionamento automatico di un'applicazione. Il contenuto della politica viene stampato direttamente nella riga di comando. Immetti il seguente comando: + +``` +bx as policy-show [--json] +``` +{: codeblock} + +
+
<APP_NAME>
+
Il nome dell'applicazione per cui visualizzare la politica di ridimensionamento automatico. Per impostazione predefinita, la struttura JSON viene tradotta in una serie di output leggibili.
+
+ +**Suggerimento:** puoi anche utilizzare l'opzione **--json** per stampare invece la riposta JSON originale. + + +## Scollegamento di una politica di ridimensionamento automatico + +Puoi rimuovere una politica di ridimensionamento automatico da un'applicazione. Eseguendo il seguente comando: + +``` +bx as policy-detach +``` +{: codeblock} + +
+
<APP_NAME>
+
Il nome dell'applicazione per la quale scollegare la politica di ridimensionamento automatico.
+
+ + +## Abilitazione o disabilitazione di una politica di ridimensionamento automatico + +Puoi abilitare o disabilitare la politica di ridimensionamento automatico di una specifica applicazione. Eseguendo il seguente comando: + +``` +bx as policy-enable|policy-disable +``` +{: codeblock} + +
+
<APP_NAME>
+
Il nome dell'applicazione per cui abilitare o disabilitare la politica di ridimensionamento automatico.
+
+ + +## Visualizzazione della cronologia di ridimensionamento automatico di un'applicazione + +Puoi visualizzare la cronologia dell'attività di ridimensionamento automatico di una specifica applicazione. Una tabella di record della cronologia del ridimensionamento automatico viene visualizzata nell'interfaccia riga di comando. + +``` +bx as history-show [--start-date=] [--end-date=] [--json] +``` +{: codeblock} + +
+
<APP_NAME>
+
Il nome dell'applicazione per cui visualizzare la cronologia della politica di ridimensionamento automatico. +
<start_timestamp>
+
La data e ora di inizio dell'intervallo della cronologia. I formati supportati sono `yyyy-MM-ddTHH:mm:ss+/-hhmm, yyyy-MM-ddTHH:mm:ssZ`. Per impostazione predefinita, la data e ora viene impostata su 50 ore avanti rispetto all'ora corrente. Consulta la W3C Date e Time Formats standard per i dettagli relativi al formato data e ora. +
<end_timestamp>
+
La data e ora di fine dell'intervallo della cronologia. I formati supportati sono `yyyy-MM-ddTHH:mm:ss+/-hhmm, yyyy-MM-ddTHH:mm:ssZ`. Per impostazione predefinita, la data e ora viene impostata sull'ora corrente. Consulta la W3C Date e Time Formats standard per i dettagli relativi al formato data e ora. +
+ + + +**Suggerimento:** puoi anche utilizzare l'opzione **--json** per stampare invece la riposta JSON originale. + +# rellinks +{: rellinks} +## generale +{: general} +* [{{site.data.keyword.autoscaling}}servizio](/docs/services/Auto-Scaling/index.html) +* [{{site.data.keyword.Bluemix_notm}} CLI ![icona link esterno](../../../icons/launch-glyph.svg)](http://plugins.ng.bluemix.net/ui/home.html){: new_window} +* [W3C Date and Time Formats standard ![icona link esterno](../../../icons/launch-glyph.svg)](https://www.w3.org/TR/NOTE-datetime){: new_window} diff --git a/cli/nl/it/plugins/bluemix_admin/index.md b/cli/nl/it/plugins/bluemix_admin/index.md index 5ab2d64a1..e9412e42c 100644 --- a/cli/nl/it/plugins/bluemix_admin/index.md +++ b/cli/nl/it/plugins/bluemix_admin/index.md @@ -1,1131 +1,1131 @@ ---- - -copyright: - - years: 2015, 2017 - -lastupdated: "2017-02-20" - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} -{:new_window: target="_blank"} - -# {{site.data.keyword.Bluemix_notm}} Admin CLI -{: #bluemixadmincli} - - -Puoi gestire gli ambienti {{site.data.keyword.Bluemix_notm}} locale o {{site.data.keyword.Bluemix_notm}} dedicato utilizzando l'interfaccia riga di comando Cloud Foundry insieme al plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI. Ad -esempio, puoi aggiungere utenti da un registro LDAP. Se stai cercando informazioni sulla gestione del tuo account {{site.data.keyword.Bluemix_notm}} pubblico, vedi [Amministrazione](/docs/admin/adminpublic.html#administer). - -Prima di iniziare, installa l'interfaccia riga di comando cf. Il plug-in {{site.data.keyword.Bluemix_notm}} Admin -CLI richiede cf versione 6.11.2 o successive. [Scarica interfaccia riga di comando Cloud Foundry ![icona link esterno](../../../icons/launch-glyph.svg)](https://github.com/cloudfoundry/cli/releases){: new_window} - -**Limitazione:** l'interfaccia riga di comando Cloud Foundry non -è supportata da Cygwin. Utilizza l'interfaccia riga di comando Cloud Foundry -in una finestra riga di comando diversa da quella di Cygwin. - -**Nota**: {{site.data.keyword.Bluemix_notm}} Admin CLI è utilizzato solo per gli ambienti {{site.data.keyword.Bluemix_notm}} locale e {{site.data.keyword.Bluemix_notm}} dedicato. Non è supportato in {{site.data.keyword.Bluemix_notm}} pubblico. - -## Aggiunta del plug-in {{site.data.keyword.Bluemix_notm}} Admin -CLI - -Dopo aver installato l'interfaccia riga di comandi cf, puoi -aggiungere il plug-in {{site.data.keyword.Bluemix_notm}} Admin -CLI. - -**Nota**: se avevi già installato il plug-in Gestione {{site.data.keyword.Bluemix_notm}}, per ottenere gli ultimi aggiornamenti potresti doverlo disinstallare, eliminare il repository e reinstallare il plug-in. - -Completa la seguente procedura per aggiungere il repository e installare il plug-in: - -
    -
  1. Per aggiungere il repository del plug-in Gestione {{site.data.keyword.Bluemix_notm}}, immetti il seguente comando:

    - -cf add-plugin-repo BluemixAdmin http://plugins.ng.bluemix.net -

    -
    2. -
  2. Per installare il plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI, immetti il seguente comando:

    - -cf install-plugin BluemixAdminCLI -r BluemixAdmin - -
    3. -
- -Se devi disinstallare il plug-in, puoi utilizzare i seguenti comandi e quindi aggiungere il repository aggiornato e installare l'ultimo plug-in: - -* Disinstalla il plug-in: `cf uninstall-plugin BluemixAdminCLI` -* Rimuovi il repository di plug-in: `cf remove-plugin-repo BluemixAdmin` - - -## Utilizzo del plug-in {{site.data.keyword.Bluemix_notm}} Admin -CLI - -Puoi utilizzare il plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI per aggiungere o rimuovere utenti, assegnare o annullare l'assegnazione degli utenti dalle organizzazioni ed -effettuare altre attività di gestione. - -Per visualizzare un elenco di comandi, immetti il seguente -comando: - -``` -cf plugins -``` -{: codeblock} - -Per ulteriore assistenza per un comando, utilizza l'opzione `-help`. - -### Connessione e accesso a {{site.data.keyword.Bluemix_notm}} - -Prima di poter utilizzare il plug-in Admin CLI, -devi connetterti ed effettuare l'accesso. - -
    -
  1. Per connetterti all'endpoint dell'API {{site.data.keyword.Bluemix_notm}}, immetti il seguente comando:

    - -cf ba api https://console.<subdomain>.bluemix.net - -
    -
    <dominiosecondario>
    -
    Dominio secondario dell'URL per la tua istanza {{site.data.keyword.Bluemix_notm}}.
    -
    -
    -

    Puoi controllare l'URL corretto nella pagina Risorse e informazioni della Console di gestione. L'URL viene mostrato -nella sezione Informazioni API all'interno del campo **URL API**.

    -
    2. -
  2. Accedi a {{site.data.keyword.Bluemix_notm}} con il seguente comando:

    - -cf login - -
    3. -
- -## Gestione degli utenti -{: #admin_users} - -### Aggiunta di un utente -{: #admin_add_user} - -Per aggiungere un utente al tuo ambiente {{site.data.keyword.Bluemix_notm}} dal registro -utenti dell'ambiente, utilizza il seguente comando: - -``` -cf ba add-user -``` -{: codeblock} - -**Nota**: per aggiungere un utente a un'organizzazione specifica, devi essere un **Ammin** con autorizzazione **users.write** (o **Superuser**). Se sei un gestore organizzazione, ti può essere data la possibilità di aggiungere utenti alla tua organizzazione da un Superuser che esegue il comando **enable-managers-add-users**. Vedi [Abilitazione dei gestori all'aggiunta di utenti](index.html#clius_emau) per ulteriori informazioni. - -
-
<user_name>
-
Il nome dell'utente nel registro LDAP.
-
<organization>
-
Il nome o GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} a cui aggiungere l'utente.
-
<first_name>
-
Il nome dell'utente da aggiungere all'organizzazione.
-
<last_name>
-
Il cognome dell'utente da aggiungere all'arganizzazione.
-
- -**Suggerimento: ** puoi anche utilizzare **ba au** come alias per -il più lungo nome comando **ba add-user**. - - - -### Ricerca di un utente -{: #admin_search_user} - -Per ricercare un utente, utilizza il seguente comando insieme ai parametri di filtro di ricerca facoltativi -(nome, autorizzazione, organizzazione e ruolo): - -``` -cf ba search-users -name= -permission= -organization= -role= -``` -{: codeblock} - -
- -
<valore_nome_utente>
-
Il nome dell'utente in {{site.data.keyword.Bluemix_notm}}.
-
<valore_autorizzazione>
-
L'autorizzazione assegnata all'utente. Ad esempio, superuser, di base, catalogo, utente e report. Per ulteriori informazioni sulle autorizzazioni da assegnare all'utente, vedi [Autorizzazioni](/docs/admin/index.html#permissions). Non puoi utilizzare questo parametro insieme al parametro organizzazione nella stessa query.
-
<valore_organizzazione>
-
Il nome dell'organizzazione a cui appartiene l'utente. Non puoi utilizzare questo parametro insieme al parametro autorizzazione nella stessa query.
-
<valore_ruolo>
-
Il ruolo dell'organizzazione assegnato all'utente. Ad esempio, gestore, gestore fatturazione o revisore dell'organizzazione. Con questo parametro devi specificare l'organizzazione. Per ulteriori informazioni sui ruoli, vedi [Ruoli utente](/docs/admin/users_roles.html#userrolesinfo).
- -
- -**Suggerimento: ** puoi anche utilizzare **ba su** come alias per -il più lungo nome comando **ba search-users**. - -### Impostazione di autorizzazioni per un utente -{: #admin_setperm_user} - -Per impostare le autorizzazioni per uno specifico utente, utilizza il seguente comando: - -``` -cf ba set-permissions -``` -{: codeblock} - -**Nota**: puoi impostare una sola autorizzazione alla volta. - -
-
<nome_utente>
-
Il nome dell'utente in {{site.data.keyword.Bluemix_notm}}.
-
<autorizzazione>
-
Imposta le autorizzazioni per l'utente: Ammin (in alternativa Superuser), Accesso (in alternativa Di base), Catalogo (accesso in lettura o scrittura), Report (accesso in lettura o scrittura) o Utenti (accesso in lettura o scrittura).
-
<accesso>
-
Per le autorizzazioni Catalogo, Report e Utenti, devi inoltre impostare il livello di accesso su lettura o scrittura.
-
- -**Suggerimento: ** puoi anche utilizzare **ba sp** come alias per -il più lungo nome comando **ba set-permissions**. - - - -### Rimozione di un utente -{: #admin_remov_user} - -Per rimuovere un utente dal tuo ambiente {{site.data.keyword.Bluemix_notm}}, utilizza il seguente comando: - -``` -cf ba remove-user -``` -{: codeblock} - -
- -
<user_name>
-
Il nome dell'utente in {{site.data.keyword.Bluemix_notm}}.
- -
- -**Suggerimento: ** puoi anche utilizzare **ba ru** come alias per -il più lungo nome comando **ba remove-user**. - -### Abilitazione dei gestori all'aggiunta di utenti -{: #clius_emau} - -Se disponi dell'autorizzazione **Superuser** nel tuo ambiente {{site.data.keyword.Bluemix_notm}}, puoi abilitare i gestori organizzazione ad aggiungere utenti alle organizzazioni che essi gestiscono. Per abilitare i gestori ad aggiungere utenti, utilizza il seguente comando: - -``` -cf ba enable-managers-add-users -``` -{: codeblock} - -**Suggerimento:** puoi anche utilizzare **ba emau** come alias per il più lungo -nome comando **ba enable-managers-add-users**. - -### Disabilitazione dei gestori all'aggiunta di utenti -{: #clius_dmau} - -Se i gestori organizzazione sono stati abilitati ad aggiungere utenti alle organizzazioni che essi gestiscono nel tuo ambiente {{site.data.keyword.Bluemix_notm}} con il comando **enable-managers-add-users** e disponi dell'autorizzazione **Superuser**, puoi rimuovere questa impostazione. Per disabilitare i gestori all'aggiunta di utenti, utilizza il seguente comando: - -``` -cf ba disable-managers-add-users -``` -{: codeblock} - -**Suggerimento:** puoi anche utilizzare **ba dmau** come alias per il più lungo -nome comando **ba disable-managers-add-users**. - -## Amministrazione delle organizzazioni -{: #admin_orgs} - -### Aggiunta di un'organizzazione -{: #admin_add_org} - -Per aggiungere un'organizzazione, utilizza il seguente comando: - -``` -cf ba create-org -``` -{: codeblock} - -
-
<organization>
-
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} da aggiungere.
-
<gestore>
-
Il nome utente del gestore per l'organizzazione.
-
- -**Suggerimento:** puoi anche utilizzare **ba co** come alias per -il più lungo nome comando **ba create-org**. - -### Eliminazione di un'organizzazione -{: #admin_delete_org} - -Per eliminare un'organizzazione, utilizza il seguente comando: - -``` -cf ba delete-org -``` -{: codeblock} - -
-
<organization>
-
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} da eliminare.
-
- -**Suggerimento: ** puoi anche utilizzare **ba do** come alias per -il più lungo nome comando **ba delete-org**. - -### Assegnazione di un utente a un'organizzazione -{: #admin_ass_user_org} - -Per assegnare un utente del tuo ambiente {{site.data.keyword.Bluemix_notm}} a -una specifica organizzazione, utilizza il seguente comando: - -``` -cf ba set-org [] -``` -{: codeblock} - -
-
<user_name>
-
Il nome dell'utente in {{site.data.keyword.Bluemix_notm}}.
-
<organization>
-
Il nome o GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} a cui assegnare l'utente.
-
<ruolo>
-
Vedi [Ruoli](/docs/admin/users_roles.html) per i ruoli utente di {{site.data.keyword.Bluemix_notm}} e le relative -descrizioni.
-
- -**Suggerimento: ** puoi anche utilizzare **ba so** come alias per -il più lungo nome comando **ba set-org**. - -### Annullamento dell'assegnazione di un utente da un'organizzazione -{: #admin_unass_user_org} - -Per annullare l'assegnazione di un utente del tuo ambiente {{site.data.keyword.Bluemix_notm}} da -una specifica organizzazione, utilizza il seguente comando: - -``` -cf ba unset-org [] -``` -{: codeblock} - -
-
<user_name>
-
Il nome dell'utente in {{site.data.keyword.Bluemix_notm}}.
-
<organization>
-
Il nome o GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} a cui assegnare l'utente.
-
<ruolo>
-
Vedi [Assegnazione di ruoli](/docs/admin/users_roles.html) per -i ruoli utente di {{site.data.keyword.Bluemix_notm}} e le relative -descrizioni.
-
- -**Suggerimento: ** puoi anche utilizzare **ba uo** come alias per -il più lungo nome comando **ba unset-org**. - -#### Assegnazione di ruoli - -
-
OrgManager
-
Gestore organizzazione. Un gestore organizzazione ha l'autorità per svolgere le seguenti azioni: -
    -
  • Creare o eliminare spazi all'interno dell'organizzazione.
    • -
  • Invitare gli utenti all'organizzazione e gestirli.
    • -
  • Gestire i domini dell'organizzazione.
    • -
-
-
BillingManager
-
Gestore fatturazione. Un gestore fatturazione può visualizzare le informazioni relative all'utilizzo di runtime e servizi -per l'organizzazione.
-
OrgAuditor
-
Revisore organizzazione. Un revisore organizzazione può visualizzare i contenuti di applicazioni e servizi in uno -spazio.
-
- -### Impostazione di una quota per un'organizzazione -{: #admin_set_org_quota} - -Per impostare la quota di utilizzo per una specifica organizzazione, utilizza il seguente comando: - -``` -cf ba set-quota -``` -{: codeblock} - -
-
<organization>
-
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} per cui impostare la quota.
-
<piano>
-
Il piano di quota per un'organizzazione.
-
- -**Suggerimento: ** puoi anche utilizzare **ba sq** come alias per -il più lungo nome comando **ba set-quota**. - - -### Ricerca di quote contenitore per un'organizzazione -{: #admin_find_containquotas} - -Per trovare la quota per i contenitori di un'organizzazione, utilizza il seguente comando: - -``` -cf bluemix-admin containers-quota -``` -{: codeblock} - -
-
<organization>
-
Il nome o l'ID dell'organizzazione in Bluemix. Questo parametro è obbligatorio.
-
- -**Suggerimento:** puoi anche utilizzare **ba cq** come alias per il più lungo -nome comando **bluemix-admin containers-quota**. - -### Impostazione di quote contenitore per un'organizzazione -{: #admin_set_containquotas} - -Per impostare la quota per i contenitori di un'organizzazione, utilizza il seguente comando con almeno una delle opzioni incluse: - -``` -cf bluemix-admin set-containers-quota -``` -{: codeblock} - -**Nota**: puoi includere più opzioni, ma ne devi includere almeno una. - -
-
<organization>
-
Il nome o l'ID dell'organizzazione in Bluemix. Questo parametro è obbligatorio.
-
<opzioni>
-
Includi una o più delle seguenti opzioni in cui il valore deve essere un numero intero: -
    -
  • floating-ips-max <value>
    • -
  • floating-ips-space-default <value>
    • -
  • memory-max <value>
    • -
  • memory-space-default <value>
    • -
  • image-limit <value>
    • -
-
-
- -**Suggerimento:** puoi anche utilizzare i seguenti nomi brevi come un alias per i nomi delle opzioni più -lunghi: -
-
floating-ips-max <value>
-
fim
-
floating-ips-space-default <value>
-
fisd
-
memory-max <value>
-
mm
-
memory-space-default <value>
-
msd
-
image-limit <value>
-
il
-
- -Facoltativamente, puoi fornire un file che contiene i parametri di configurazione specifici in un oggetto JSON valido. Se utilizzi l'opzione **-file**, ha la precedenza e le altre opzioni vengono ignorate. Per fornire un file anziché impostare le opzioni, utilizza il seguente comando: - -``` -cf bluemix-admin set-containers-quota <-file path_to_JSON_file> -``` -{: codeblock} - -Il file JSON deve avere il formato mostrato nel seguente esempio: - -``` -{ - "floating_ips_max": 10, - "floating_ips_space_default": 0, - "ram_max": 4096, - "ram_space_default": 0, - "image_limit": 10 -} -``` -{: codeblock} - -**Suggerimento:** puoi anche utilizzare **ba scq** come alias per il più lungo -nome comando **bluemix-admin set-containers-quota**. - -## Amministrazione di spazi -{: #admin_spaces} - -### Aggiunta di uno spazio all'organizzazione - -Per aggiungere uno spazio nell'organizzazione, utilizza il seguente comando: - -``` -cf bluemix-admin create-space -``` - -{: codeblock} - -
-
<organization>
-
Il nome o GUID dell'organizzazione a cui aggiungere lo spazio.
-
<space_name>
-
Il nome dello spazio da creare nell'organizzazione.
-
- -**Suggerimento:** puoi anche utilizzare **ba cs** come alias per -il più lungo nome comando **ba create-space**. - -### Eliminazione di un spazio dall'organizzazione - -Per rimuovere uno spazio dall'organizzazione, utilizza il seguente comando: - -``` -cf bluemix-admin delete-space -``` - -{: codeblock} - -
-
<organization>
-
Il nome o GUID dell'organizzazione da cui rimuovere lo spazio.
-
<space_name>
-
Il nome dello spazio da rimuovere dall'organizzazione.
-
- -**Suggerimento:** puoi anche utilizzare **ba cs** come alias per -il più lungo nome comando **ba delete-space**. - -### Aggiunta di un utente a uno spazio con un ruolo - -Per creare un utente in uno spazio con un ruolo specificato, utilizza il seguente comando: - -``` -cf bluemix-admin set-space -``` - -{: codeblock} - -
-
<organizzazione>
-
Il nome o GUID dell'organizzazione a cui aggiungere l'utente.
-
<space_name>
-
Il nome dello spazio a cui aggiungere l'utente.
-
<user_anme>
-
Il nome dell'utente da aggiungere.
-
<ruolo>
-
Il ruolo da assegnare all'utente. Il valore può essere Gestore, Sviluppatore o Revisore. Vedi [Assegnazione di ruoli](/docs/admin/users_roles.html) per -i ruoli utente di {{site.data.keyword.Bluemix_notm}} e le relative -descrizioni in uno spazio.
-
- -**Suggerimento: ** puoi anche utilizzare **ba ss** come alias per -il più lungo nome comando **ba set-space**. - - -### Rimozione del ruolo di un utente in uno spazio - -Per rimuovere il ruolo di un utente in uno spazio, utilizza il seguente comando: - -``` -cf bluemix-admin unset-space -``` - -{: codeblock} - -
-
<organization>
-
Il nome o GUID dell'organizzazione a cui aggiungere l'utente.
-
<space_name>
-
Il nome dello spazio a cui aggiungere l'utente.
-
<user_anme>
-
Il nome dell'utente da aggiungere.
-
<ruolo>
-
Il ruolo da assegnare all'utente. Il valore può essere Gestore, Sviluppatore o Revisore. Vedi [Assegnazione di ruoli](/docs/admin/users_roles.html) per -i ruoli utente di {{site.data.keyword.Bluemix_notm}} e le relative -descrizioni in uno spazio.
-
- -**Suggerimento:** puoi anche utilizzare **ba us** come alias per il più lungo -nome comando **ba unset-space**. - -## Amministrazione del catalogo -{: #admin_catalog} - -### Abilitazione dei servizi per tutte le organizzazioni -{: #admin_ena_service_org} - -Per abilitare la visualizzazione di un servizio nel -Catalogo {{site.data.keyword.Bluemix_notm}} per tutte le -organizzazioni, utilizza il seguente comando: - -``` -cf ba enable-service-plan -``` -{: codeblock} - -
-
<identificativo_piano>
-
Il nome o il GUID del piano di servizio che desideri abilitare. Se immetti un nome del piano di servizio non univoco, ad esempio "Standard" o "Di base," ti verrà richiesto di scegliere tra dei piani di servizio. Per identificare il nome di un piano di servizio, seleziona la categoria di servizio dalla homepage, quindi fai clic su **Aggiungi** per visualizzarne i servizi. Fai clic sul nome del servizio per aprire la vista Dettagli, da cui puoi visualizzare i nomi dei piani di servizi disponibili per il servizio.
-
- -**Suggerimento:** puoi anche utilizzare **ba esp** come alias per il più lungo -nome comando **ba enable-service-plan**. - -### Disabilitazione dei servizi per tutte le organizzazioni -{: #admin_dis_service_org} - -Per disabilitare la visualizzazione di un servizio nel Catalogo {{site.data.keyword.Bluemix_notm}} per tutte le -organizzazioni, utilizza il seguente comando: - -``` -cf ba disable-service-plan -``` -{: codeblock} - -
-
<identificativo_piano>
-
Il nome o il GUID del piano di servizio che desideri abilitare. Se immetti un nome del piano di servizio non univoco, ad esempio "Standard" o "Di base," ti verrà richiesto di scegliere tra dei piani di servizio. Per identificare il nome di un piano di servizio, seleziona la categoria di servizio dalla homepage, quindi fai clic su **Aggiungi** per visualizzarne i servizi. Fai clic sul nome del servizio per aprire la vista Dettagli, da cui puoi visualizzare i nomi dei piani di servizi disponibili per il servizio.
-
- -**Suggerimento: ** puoi anche utilizzare **ba dsp** come alias per il più -lungo nome comando **ba disable-service-plan**. - -### Aggiunta della visibilità dei servizi per le organizzazioni -{: #admin_addvis_service_org} - -Puoi aggiungere un'organizzazione dall'elenco di organizzazioni che possono vedere uno specifico servizio nel Catalogo {{site.data.keyword.Bluemix_notm}}. Per consentire a un'organizzazione di visualizzare uno specifico servizio nel -Catalogo {{site.data.keyword.Bluemix_notm}}, utilizza il seguente comando: - -``` -cf ba add-service-plan-visibility -``` -{: codeblock} - -
-
<identificativo_piano>
-
Il nome o il GUID del piano di servizio che desideri abilitare. Se immetti un nome del piano di servizio non univoco, ad esempio "Standard" o "Di base," ti verrà richiesto di scegliere tra dei piani di servizio. Per identificare il nome di un piano di servizio, seleziona la categoria di servizio dalla homepage, quindi fai clic su **Aggiungi** per visualizzarne i servizi. Fai clic sul nome del servizio per aprire la vista Dettagli, da cui puoi visualizzare i nomi dei piani di servizi disponibili per il servizio.
-
<organization>
-
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} da aggiungere all'elenco di visibilità del servizio.
-
- -**Suggerimento:** puoi anche utilizzare **ba aspv** come alias per il più lungo -nome comando **ba add-service-plan-visibility**. - -### Rimozione della visibilità dei servizi per le organizzazioni -{: #admin_remvis_service_org} - -Puoi rimuovere un'organizzazione dall'elenco di organizzazioni che possono vedere -uno specifico servizio nel Catalogo {{site.data.keyword.Bluemix_notm}}. Per rimuovere la visibilità di un servizio nel -Catalogo {{site.data.keyword.Bluemix_notm}} per -un'organizzazione, utilizza il seguente comando: - -``` -cf ba remove-service-plan-visibility -``` -{: codeblock} - -
-
<identificativo_piano>
-
Il nome o il GUID del piano di servizio che desideri abilitare. Se immetti un nome del piano di servizio non univoco, ad esempio "Standard" o "Di base," ti verrà richiesto di scegliere tra dei piani di servizio. Per identificare il nome di un piano di servizio, seleziona la categoria di servizio dalla homepage, quindi fai clic su **Aggiungi** per visualizzarne i servizi. Fai clic sul nome del servizio per aprire la vista Dettagli, da cui puoi visualizzare i nomi dei piani di servizi disponibili per il servizio.
-
<organization>
-
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} da rimuovere dall'elenco di visibilità del servizio.
-
- -**Suggerimento: ** puoi anche utilizzare **ba rspv** come alias per il più -lungo nome comando **ba remove-service-plan-visibility**. - -### Modifica della visibilità dei servizi per le organizzazioni -{: #admin_editvis_service_org} - -Puoi modificare e sostituire l'elenco di servizi che specifiche -organizzazioni possono vedere nel Catalogo {{site.data.keyword.Bluemix_notm}}. Per sostituire tutti i servizi visibili esistenti per un'organizzazione o più organizzazioni, utilizza questo comando. - -``` -cf ba edit-service-plan-visibilities -``` -{: codeblock} - -**Nota:** questo comando sostituisce i servizi visibili esistenti per le organizzazioni specificate con il servizio da te specificato nel comando. - -
-
<identificativo_piano>
-
Il nome o il GUID del piano di servizio che desideri abilitare. Se immetti un nome del piano di servizio non univoco, ad esempio "Standard" o "Di base," ti verrà richiesto di scegliere tra dei piani di servizio. Per identificare il nome di un piano di servizio, seleziona la categoria di servizio dalla homepage, quindi fai clic su **Aggiungi** per visualizzarne i servizi. Fai clic sul nome del servizio per aprire la vista Dettagli, da cui puoi visualizzare i nomi dei piani di servizi disponibili per il servizio.
-
<organization>
-
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} per cui aggiungere la visibilità. Puoi abilitare la visibilità del servizio per più di una singola organizzazione immettendo i GUID o i nomi organizzazione aggiuntivi nel comando.
-
- -**Suggerimento:** puoi anche utilizzare **ba espv** come alias per il più lungo -nome comando **ba edit-service-plan-visibility**. - -## Gestione dei report -{: #admin_add_report} - -### Aggiunta di report -{: #admin_add_report} - -Per aggiungere un report di sicurezza, utilizza il seguente comando: - -``` -cf ba add-report -``` -{: codeblock} - -**Nota**: se hai accesso in scrittura per l'autorizzazione dei report, puoi creare una nuova categoria e aggiungere un report in uno qualsiasi dei formati accettati per i tuoi utenti. Immetti il nome della nuova categoria per il parametro `categoria` o aggiungi il nuovo report a una categoria esistente. - -
-
<categoria>
-
La categoria per il report. Se nel nome è presente uno spazio, racchiudi il nome -tra virgolette.
-
<data>
-
La data del report nel formato AAAAMMGG.
-
<PDF|TXT|LOG>
-
Il percorso del PDF, file di testo o file di log del report da caricare.
-
<RTF>
-
Un'opzione per includere una versione RTF (Rich Text Format) del PDF. Questa opzione si applica solo se -hai incluso il percorso del PDF del report. La versione RTF è utilizzata per l'indicizzazione e la ricerca.
-
- -**Suggerimento: ** puoi anche utilizzare **ba ar** come alias per -il più lungo nome comando **ba add-report**. - -### Eliminazione di report -{: #admin_del_report} - -Per eliminare un report di sicurezza, utilizza il seguente comando: - -``` -cf ba delete-report -``` -{: codeblock} - -
-
<categoria>
-
La categoria per il report. Se nel nome è presente uno spazio, racchiudi il nome -tra virgolette.
-
<data>
-
La data del report nel formato AAAAMMGG.
-
<nome>
-
Il nome del report.
-
- -**Suggerimento: ** puoi anche utilizzare **ba dr** come alias per -il più lungo nome comando **ba delete-report**. - -### Recupero di report -{: #admin_retr_report} - -Per recuperare un report di sicurezza, utilizza il seguente comando: - -``` -cf ba retrieve-report -``` -{: codeblock} - -
-
<search>
-
Il nome file del report. Se nel nome è presente uno spazio, racchiudi il nome -tra virgolette.
-
- -**Suggerimento: ** puoi anche utilizzare **ba rr** come alias per il più lungo nome comando **ba retrieve-report**. - -## Visualizzazione delle informazioni sulle metriche della risorsa -{: #cliresourceusage} - -Puoi visualizzare le informazioni sulle metriche della risorsa, tra cui l'utilizzo di memoria, disco e CPU. Oltre all'utilizzo di tali risorse, puoi vedere un riepilogo delle risorse fisiche e riservate disponibili. Puoi anche visualizzare i dati di utilizzo dei DEA (droplet execution agent) e delle celle (architettura Diego) e i dati cronologici per l'utilizzo di memoria e disco. Per impostazione predefinita, i dati cronologici per l'utilizzo di memoria e disco vengono visualizzati settimanalmente e in ordine decrescente. Per visualizzare le informazioni sulle metriche della risorsa, utilizza il seguente comando: - -``` -cf ba resource-metrics -``` -{: codeblock} - -
-
<mensile>
-
Visualizzare i dati cronologici per la memoria e lo spazio su disco un mese alla volta.
-
<settimanale>
-
Visualizzare i dati cronologici per la memoria e lo spazio su disco una settimana alla volta. Questo è il valore predefinito.
-
- -**Suggerimento:** puoi anche utilizzare **ba rsm** come alias per il più lungo -nome comando **ba resource-metrics**. - - -## Gestione dei broker di servizi -{: #admin_servbro} - -### Elenco dei broker dei servizi -{: #clilistservbro} - -Per elencare tutti i broker dei servizi, utilizza il seguente comando: - -``` -cf ba service-brokers -``` -{: codeblock} - -**Nota**: per elencare tutti i broker dei servizi, immetti il comando omettendo il parametro `nome_broker`. - -
-
<nome_broker>
-
Facoltativo: nome del broker dei servizi personalizzato. Utilizza questo parametro per ottenere informazioni per un broker dei servizi specifico.
-
- -**Suggerimento: ** puoi anche utilizzare **ba sb** come alias per il più -lungo nome comando **ba service-brokers**. - -### Aggiunta di un broker dei servizi -{: #cliaddservbro} - -Per aggiungere un broker dei servizi, in modo da poter aggiungere un servizio personalizzato al tuo -Catalogo {{site.data.keyword.Bluemix_notm}}, utilizza il seguente comando: - -``` -cf ba add-service-broker -``` -{: codeblock} - -
-
<nome_broker>
-
Nome del broker dei servizi personalizzato.
-
<user_name>
-
Nome utente per l'account con accesso al broker dei servizi.
-
<password>
-
Password per l'account con accesso al broker dei servizi.
-
<url_broker>
-
URL per il broker dei servizi.
-
- -**Suggerimento:** puoi anche utilizzare **ba asb** come alias per il più lungo -nome comando **ba add-service-broker**. - -### Eliminazione di un broker dei servizi -{: #clidelservbro} - -Per eliminare un broker dei servizi per rimuovere il servizio personalizzato dal tuo -Catalogo {{site.data.keyword.Bluemix_notm}}, utilizza il seguente comando: - -``` -cf ba delete-service-broker -``` -{: codeblock} - -
-
<broker_servizi>
-
Nome o GUID del broker dei servizi personalizzato.
-
- -**Suggerimento: ** puoi anche utilizzare **ba dsb** come alias per il più -lungo nome comando **ba delete-service-broker**. - -### Aggiornamento di un broker dei servizi -{: #cliupdservbro} - -Per aggiornare un broker dei servizi, utilizza il seguente comando: - -``` -cf ba update-service-broker -``` -{: codeblock} - -
-
<nome_broker>
-
Nome del broker dei servizi personalizzato.
-
<user_name>
-
Nome utente per l'account con accesso al broker dei servizi.
-
<password>
-
Password per l'account con accesso al broker dei servizi.
-
<url_broker>
-
URL per il broker dei servizi.
-
- -**Suggerimento:** puoi anche utilizzare **ba usb** come alias per il più lungo -nome comando **ba update-service-broker**. - - -## Gestione dei gruppi di sicurezza dell'applicazione -{: #admin_secgro} - -Per gestire i gruppi di sicurezza dell'applicazione (ASG), devi essere un amministratore con accesso completo all'ambiente locale o dedicato. Tutti gli utenti dell'ambiente possono elencare gli ASG disponibili per l'organizzazione a cui si fa riferimento con il comando. Tuttavia, per creare, aggiornare o associare gli ASG, devi essere l'amministratore dell'ambiente {{site.data.keyword.Bluemix_notm}}. - -I gruppi ASG funzionano come firewall virtuali che controllano il traffico dall'applicazione presente nel tuo ambiente {{site.data.keyword.Bluemix_notm}}. Ogni ASG è costituito da un elenco di regole che consentono un traffico specifico e la comunicazione da e verso la rete esterna. Puoi associare uno o più ASG a una specifica serie di gruppi di sicurezza, ad esempio a una serie di gruppi utilizzata per applicare l'accesso globale, oppure associarli agli spazi all'interno di un'organizzazione nel tuo ambiente {{site.data.keyword.Bluemix_notm}}. - -{{site.data.keyword.Bluemix_notm}} è inizialmente impostato con limitazioni a tutti gli accessi alla rete esterna. Due gruppi di sicurezza creati da IBM, `public_networks` e `dns`, abilitano l'accesso globale alla rete esterna quando esegui il bind di tali gruppi alla serie di gruppi di sicurezza Cloud Foundry predefinita. Le due serie di gruppi di sicurezza in Cloud Foundry utilizzate per applicare l'accesso globale sono **Preparazione predefinita** ed **Esecuzione predefinita**. Queste serie di gruppi applicano le regole per consentire il traffico a tutte le applicazioni in esecuzione o a tutte le applicazioni in fase di preparazione. Se non vuoi eseguire il bind a queste due serie di gruppi di sicurezza, puoi annullare il bind alle serie di gruppi Cloud Foundry e quindi associare il gruppo a uno specifico spazio. Per ulteriori informazioni, vedi [Binding Application Security Groups ![icona link esterno](../../../icons/launch-glyph.svg)](https://docs.cloudfoundry.org/adminguide/app-sec-groups.html#binding-groups){: new_window}. - -**Nota**: i seguenti comandi che consentono di gestire i gruppi di sicurezza, si basano su Cloud Foundry versione 1.6. Per ulteriori informazioni, inclusi i campi obbligatori e facoltativi, consulta la sezione Cloud Foundry relativa a [Creating Application Security Groups ![icona link esterno](../../../icons/launch-glyph.svg)](https://docs.cloudfoundry.org/adminguide/app-sec-groups.html#creating-groups){: new_window}. - -### Elenco dei gruppi di sicurezza -{: #clilissecgro} - -* Per elencare tutti i gruppi di sicurezza, utilizza il seguente comando: - -``` -cf ba security-groups -``` -{: codeblock} - -**Suggerimento:** puoi anche utilizzare **ba sgs** come alias per il più lungo nome comando -**ba security-groups**. - -* Per visualizzare i dettagli di uno specifico gruppo di sicurezza, utilizza il seguente comando: - -``` -cf ba security-groups -``` -{: codeblock} - -
-
<Gruppo di sicurezza>
-
Nome del gruppo di sicurezza
-
- -**Suggerimento:** puoi anche utilizzare **ba sg** come alias per il più lungo nome comando -**ba security-groups** con il parametro `security-group`. - - -### Creazione di un gruppo di sicurezza -{: #clicreasecgro} - -Per ulteriori informazioni sulla creazione di gruppi di sicurezza e sulle regole che definiscono il traffico in uscita, vedi [Creating Application Security Groups ![icona link esterno](../../../icons/launch-glyph.svg)](https://docs.cloudfoundry.org/adminguide/app-sec-groups.html#creating-groups){: new_window}. - -Per creare un gruppo di sicurezza, utilizza il seguente comando: - -``` -cf ba create-security-group -``` -{: codeblock} - -Al nome di ciascun gruppo di sicurezza creato, viene aggiunto il prefisso `adminconsole_` per distinguerlo dai gruppi di sicurezza creati da IBM. - -
-
<Gruppo di sicurezza>
-
Nome del tuo gruppo di sicurezza
-
<Percorso del file di regole>
-
Percorso assoluto o relativo a un file di regole
-
- -**Suggerimento:** puoi anche utilizzare **ba csg** come alias per il più lungo nome comando -**ba create-security-group**. - -### Aggiornamento di un gruppo di sicurezza -{: #cliupdsecgro} - -Per aggiornare un gruppo di sicurezza, utilizza il seguente comando: - -``` -cf ba update-security-group -``` -{: codeblock} - -
-
<Gruppo di sicurezza>
-
Nome del tuo gruppo di sicurezza
-
<Percorso del file di regole>
-
Percorso assoluto o relativo a un file di regole
-
- -**Suggerimento:** puoi anche utilizzare **ba usg** come alias per il più lungo nome comando -**ba update-security-group**. - -### Eliminazione di un gruppo di sicurezza -{: #clidelsecgro} - -Per eliminare un gruppo di sicurezza, utilizza il seguente comando: - -``` -cf ba delete-security-group -``` -{: codeblock} - -
-
<Gruppo di sicurezza>
-
Nome del tuo gruppo di sicurezza
-
- -**Suggerimento:** puoi anche utilizzare **ba dsg** come alias per il più lungo nome comando -**ba delete-security-group**. - - -### Esecuzione del bind dei gruppi di sicurezza -{: #clibindsecgro} - -Per ulteriori informazioni sull'esecuzione del bind dei gruppi di sicurezza, vedi [Binding Application Security Groups ![icona link esterno](../../../icons/launch-glyph.svg)](https://docs.cloudfoundry.org/adminguide/app-sec-groups.html#binding-groups){: new_window}. - -* Per eseguire il bind alla serie di gruppi di sicurezza Preparazione predefinita, utilizza il seguente comando: - -``` -cf ba bind-staging-security-group -``` -{: codeblock} - -
-
<Gruppo di sicurezza>
-
Nome del tuo gruppo di sicurezza
-
- -**Suggerimento:** puoi anche utilizzare **ba bssg** come alias per il più lungo nome comando -**ba bind-staging-security-group**. - -* Per eseguire il bind alla serie di gruppi di sicurezza Esecuzione predefinita, utilizza il seguente comando: - -``` -cf ba bind-running-security-group -``` -{: codeblock} - -
-
<Gruppo di sicurezza>
-
Nome del tuo gruppo di sicurezza
-
- -**Suggerimento:** puoi anche utilizzare **ba brsg** come alias per il più lungo nome comando -**ba bind-running-security-group**. - -* Per eseguire il bind di un gruppo di sicurezza a uno spazio, utilizza il seguente comando: - -``` -cf ba bind-security-group -``` -{: codeblock} - -
-
<Gruppo di sicurezza>
-
Nome del tuo gruppo di sicurezza
-
<Organizzazione>
-
Nome dell'organizzazione a cui eseguire il bind del gruppo di sicurezza
-
<Spazio>
-
Nome dello spazio all'interno dell'organizzazione a cui eseguire il bind del gruppo di sicurezza
-
- -**Suggerimento:** puoi anche utilizzare **ba bsg** come alias per il più lungo nome comando -**ba bind-security-group**. - -### Annullamento del bind dei gruppi di sicurezza -{: #cliunbindsecgro} - -Per ulteriori informazioni sull'annullamento del bind dei gruppi di sicurezza, vedi [Unbinding Application Security Groups ![icona link esterno](../../../icons/launch-glyph.svg)](https://docs.cloudfoundry.org/adminguide/app-sec-groups.html#unbinding-groups){: new_window}. - -* Per annullare il bind dalla serie di gruppi di sicurezza Preparazione predefinita, utilizza il seguente comando: - -``` -cf ba unbind-staging-security-group -``` -{: codeblock} - -
-
<Gruppo di sicurezza>
-
Nome del tuo gruppo di sicurezza
-
- -**Suggerimento:** puoi anche utilizzare **ba ussg** come alias per il più lungo nome comando -**ba unbind-staging-security-group**. - -* Per annullare il bind dalla serie di gruppi di sicurezza Esecuzione predefinita, utilizza il seguente comando: - -``` -cf ba unbind-running-security-group -``` -{: codeblock} - -
-
<Gruppo di sicurezza>
-
Nome del tuo gruppo di sicurezza
-
- -**Suggerimento:** puoi anche utilizzare **ba brsg** come alias per il più lungo nome comando -**ba bind-running-security-group**. - -* Per annullare il bind di un gruppo di sicurezza a uno spazio, utilizza il seguente comando: - -``` -cf ba unbind-security-group -``` -{: codeblock} - -
-
<Gruppo di sicurezza>
-
Nome del tuo gruppo di sicurezza
-
<Organizzazione>
-
Nome dell'organizzazione a cui eseguire il bind del gruppo di sicurezza
-
<Spazio>
-
Nome dello spazio all'interno dell'organizzazione a cui eseguire il bind del gruppo di sicurezza
-
- -**Suggerimento:** puoi anche utilizzare **ba usg** come alias per il più lungo nome comando -**ba unbind-staging-security-group**. - -## Gestione dei pacchetti di build -{: #admin_buildpack} - -### Elenco dei pacchetti di build -{: #clilistbuildpack} - -Se disponi di autorizzazioni di scrittura nel catalogo di applicazioni, puoi elencare i pacchetti di build. Per elencare tutti i pacchetti di build o visualizzarne uno specifico, utilizza il seguente comando: - -``` -cf ba buildpacks -``` -{: codeblock} - -
-
<nome_pacchettodibuild>
-
Un parametro facoltativo per specificare un determinato pacchetto di build da visualizzare.
-
- -**Suggerimento:** puoi anche utilizzare **ba lb** come alias per il più lungo -nome comando **ba buildpacks**. - -### Creazione e caricamento di un pacchetto di build -{: #clicreupbuildpack} - -Se disponi di autorizzazioni di scrittura nel catalogo di applicazioni, puoi creare e caricare un pacchetto di build. Puoi caricare qualsiasi file compresso che presenta un tipo di file .zip. Per caricare un pacchetto di build, utilizza il seguente comando: - -``` -cf ba create-buildpack -``` -{: codeblock} - -
-
<nome_pacchettodibuild>
-
Il nome del pacchetto di build da caricare.
-
<percorso_file>
-
Il percorso del file compresso del pacchetto di build.
-
<posizione>
-
L'ordine in cui vengono controllati i pacchetti di build durante il rilevamento automatico.
-
- -**Suggerimento: ** puoi anche utilizzare **ba cb** come alias per il più lungo -nome comando **ba create-buildpack**. - -### Aggiornamento di un pacchetto di build -{: #cliupdabuildpack} - -Se disponi di autorizzazioni di scrittura nel catalogo di applicazioni, puoi aggiornare un pacchetto di build esistente. Per aggiornare un pacchetto di build, utilizza il seguente comando: - -``` -cf ba update-buildpack -``` -{: codeblock} - -
-
<nome_pacchettodibuild>
-
Il nome del pacchetto di build da aggiornare.
-
<posizione>
-
L'ordine in cui vengono controllati i pacchetti di build durante il rilevamento automatico.
-
<abilitato>
-
Indica se il pacchetto di build è utilizzato per la fase di preparazione.
-
<bloccato>
-
Indica se il pacchetto di build è bloccato per impedire gli aggiornamenti.
-
- -**Suggerimento:** puoi anche utilizzare **ba ub** come alias per il più lungo -nome comando **ba update-buildpack**. - -### Eliminazione di un pacchetto di build -{: #clidelbuildpack} - -Se disponi di autorizzazioni di scrittura nel catalogo di applicazioni, puoi eliminare un pacchetto di build esistente. Per eliminare un pacchetto di build, utilizza il seguente comando: - -``` -cf ba delete-buildpack -``` -{: codeblock} - -
-
<nome_pacchettodibuild>
-
Il nome del pacchetto di build da eliminare.
-
- -**Suggerimento: ** puoi anche utilizzare **ba db** come alias per il più lungo -nome comando **ba delete-buildpack**. +--- + +copyright: + + years: 2015, 2017 + +lastupdated: "2017-02-20" + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} +{:new_window: target="_blank"} + +# {{site.data.keyword.Bluemix_notm}} Admin CLI +{: #bluemixadmincli} + + +Puoi gestire gli ambienti {{site.data.keyword.Bluemix_notm}} locale o {{site.data.keyword.Bluemix_notm}} dedicato utilizzando l'interfaccia riga di comando Cloud Foundry insieme al plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI. Ad +esempio, puoi aggiungere utenti da un registro LDAP. Se stai cercando informazioni sulla gestione del tuo account {{site.data.keyword.Bluemix_notm}} pubblico, vedi [Amministrazione](/docs/admin/adminpublic.html#administer). + +Prima di iniziare, installa l'interfaccia riga di comando cf. Il plug-in {{site.data.keyword.Bluemix_notm}} Admin +CLI richiede cf versione 6.11.2 o successive. [Scarica interfaccia riga di comando Cloud Foundry ![icona link esterno](../../../icons/launch-glyph.svg)](https://github.com/cloudfoundry/cli/releases){: new_window} + +**Limitazione:** l'interfaccia riga di comando Cloud Foundry non +è supportata da Cygwin. Utilizza l'interfaccia riga di comando Cloud Foundry +in una finestra riga di comando diversa da quella di Cygwin. + +**Nota**: {{site.data.keyword.Bluemix_notm}} Admin CLI è utilizzato solo per gli ambienti {{site.data.keyword.Bluemix_notm}} locale e {{site.data.keyword.Bluemix_notm}} dedicato. Non è supportato in {{site.data.keyword.Bluemix_notm}} pubblico. + +## Aggiunta del plug-in {{site.data.keyword.Bluemix_notm}} Admin +CLI + +Dopo aver installato l'interfaccia riga di comandi cf, puoi +aggiungere il plug-in {{site.data.keyword.Bluemix_notm}} Admin +CLI. + +**Nota**: se avevi già installato il plug-in Gestione {{site.data.keyword.Bluemix_notm}}, per ottenere gli ultimi aggiornamenti potresti doverlo disinstallare, eliminare il repository e reinstallare il plug-in. + +Completa la seguente procedura per aggiungere il repository e installare il plug-in: + +
    +
  1. Per aggiungere il repository del plug-in Gestione {{site.data.keyword.Bluemix_notm}}, immetti il seguente comando:

    + +cf add-plugin-repo BluemixAdmin http://plugins.ng.bluemix.net +

    +
    2. +
  2. Per installare il plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI, immetti il seguente comando:

    + +cf install-plugin BluemixAdminCLI -r BluemixAdmin + +
    3. +
+ +Se devi disinstallare il plug-in, puoi utilizzare i seguenti comandi e quindi aggiungere il repository aggiornato e installare l'ultimo plug-in: + +* Disinstalla il plug-in: `cf uninstall-plugin BluemixAdminCLI` +* Rimuovi il repository di plug-in: `cf remove-plugin-repo BluemixAdmin` + + +## Utilizzo del plug-in {{site.data.keyword.Bluemix_notm}} Admin +CLI + +Puoi utilizzare il plug-in {{site.data.keyword.Bluemix_notm}} Admin CLI per aggiungere o rimuovere utenti, assegnare o annullare l'assegnazione degli utenti dalle organizzazioni ed +effettuare altre attività di gestione. + +Per visualizzare un elenco di comandi, immetti il seguente +comando: + +``` +cf plugins +``` +{: codeblock} + +Per ulteriore assistenza per un comando, utilizza l'opzione `-help`. + +### Connessione e accesso a {{site.data.keyword.Bluemix_notm}} + +Prima di poter utilizzare il plug-in Admin CLI, +devi connetterti ed effettuare l'accesso. + +
    +
  1. Per connetterti all'endpoint dell'API {{site.data.keyword.Bluemix_notm}}, immetti il seguente comando:

    + +cf ba api https://console.<subdomain>.bluemix.net + +
    +
    <dominiosecondario>
    +
    Dominio secondario dell'URL per la tua istanza {{site.data.keyword.Bluemix_notm}}.
    +
    +
    +

    Puoi controllare l'URL corretto nella pagina Risorse e informazioni della Console di gestione. L'URL viene mostrato +nella sezione Informazioni API all'interno del campo **URL API**.

    +
    2. +
  2. Accedi a {{site.data.keyword.Bluemix_notm}} con il seguente comando:

    + +cf login + +
    3. +
+ +## Gestione degli utenti +{: #admin_users} + +### Aggiunta di un utente +{: #admin_add_user} + +Per aggiungere un utente al tuo ambiente {{site.data.keyword.Bluemix_notm}} dal registro +utenti dell'ambiente, utilizza il seguente comando: + +``` +cf ba add-user +``` +{: codeblock} + +**Nota**: per aggiungere un utente a un'organizzazione specifica, devi essere un **Ammin** con autorizzazione **users.write** (o **Superuser**). Se sei un gestore organizzazione, ti può essere data la possibilità di aggiungere utenti alla tua organizzazione da un Superuser che esegue il comando **enable-managers-add-users**. Vedi [Abilitazione dei gestori all'aggiunta di utenti](index.html#clius_emau) per ulteriori informazioni. + +
+
<user_name>
+
Il nome dell'utente nel registro LDAP.
+
<organization>
+
Il nome o GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} a cui aggiungere l'utente.
+
<first_name>
+
Il nome dell'utente da aggiungere all'organizzazione.
+
<last_name>
+
Il cognome dell'utente da aggiungere all'arganizzazione.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba au** come alias per +il più lungo nome comando **ba add-user**. + + + +### Ricerca di un utente +{: #admin_search_user} + +Per ricercare un utente, utilizza il seguente comando insieme ai parametri di filtro di ricerca facoltativi +(nome, autorizzazione, organizzazione e ruolo): + +``` +cf ba search-users -name= -permission= -organization= -role= +``` +{: codeblock} + +
+ +
<valore_nome_utente>
+
Il nome dell'utente in {{site.data.keyword.Bluemix_notm}}.
+
<valore_autorizzazione>
+
L'autorizzazione assegnata all'utente. Ad esempio, superuser, di base, catalogo, utente e report. Per ulteriori informazioni sulle autorizzazioni da assegnare all'utente, vedi [Autorizzazioni](/docs/admin/index.html#permissions). Non puoi utilizzare questo parametro insieme al parametro organizzazione nella stessa query.
+
<valore_organizzazione>
+
Il nome dell'organizzazione a cui appartiene l'utente. Non puoi utilizzare questo parametro insieme al parametro autorizzazione nella stessa query.
+
<valore_ruolo>
+
Il ruolo dell'organizzazione assegnato all'utente. Ad esempio, gestore, gestore fatturazione o revisore dell'organizzazione. Con questo parametro devi specificare l'organizzazione. Per ulteriori informazioni sui ruoli, vedi [Ruoli utente](/docs/admin/users_roles.html#userrolesinfo).
+ +
+ +**Suggerimento: ** puoi anche utilizzare **ba su** come alias per +il più lungo nome comando **ba search-users**. + +### Impostazione di autorizzazioni per un utente +{: #admin_setperm_user} + +Per impostare le autorizzazioni per uno specifico utente, utilizza il seguente comando: + +``` +cf ba set-permissions +``` +{: codeblock} + +**Nota**: puoi impostare una sola autorizzazione alla volta. + +
+
<nome_utente>
+
Il nome dell'utente in {{site.data.keyword.Bluemix_notm}}.
+
<autorizzazione>
+
Imposta le autorizzazioni per l'utente: Ammin (in alternativa Superuser), Accesso (in alternativa Di base), Catalogo (accesso in lettura o scrittura), Report (accesso in lettura o scrittura) o Utenti (accesso in lettura o scrittura).
+
<accesso>
+
Per le autorizzazioni Catalogo, Report e Utenti, devi inoltre impostare il livello di accesso su lettura o scrittura.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba sp** come alias per +il più lungo nome comando **ba set-permissions**. + + + +### Rimozione di un utente +{: #admin_remov_user} + +Per rimuovere un utente dal tuo ambiente {{site.data.keyword.Bluemix_notm}}, utilizza il seguente comando: + +``` +cf ba remove-user +``` +{: codeblock} + +
+ +
<user_name>
+
Il nome dell'utente in {{site.data.keyword.Bluemix_notm}}.
+ +
+ +**Suggerimento: ** puoi anche utilizzare **ba ru** come alias per +il più lungo nome comando **ba remove-user**. + +### Abilitazione dei gestori all'aggiunta di utenti +{: #clius_emau} + +Se disponi dell'autorizzazione **Superuser** nel tuo ambiente {{site.data.keyword.Bluemix_notm}}, puoi abilitare i gestori organizzazione ad aggiungere utenti alle organizzazioni che essi gestiscono. Per abilitare i gestori ad aggiungere utenti, utilizza il seguente comando: + +``` +cf ba enable-managers-add-users +``` +{: codeblock} + +**Suggerimento:** puoi anche utilizzare **ba emau** come alias per il più lungo +nome comando **ba enable-managers-add-users**. + +### Disabilitazione dei gestori all'aggiunta di utenti +{: #clius_dmau} + +Se i gestori organizzazione sono stati abilitati ad aggiungere utenti alle organizzazioni che essi gestiscono nel tuo ambiente {{site.data.keyword.Bluemix_notm}} con il comando **enable-managers-add-users** e disponi dell'autorizzazione **Superuser**, puoi rimuovere questa impostazione. Per disabilitare i gestori all'aggiunta di utenti, utilizza il seguente comando: + +``` +cf ba disable-managers-add-users +``` +{: codeblock} + +**Suggerimento:** puoi anche utilizzare **ba dmau** come alias per il più lungo +nome comando **ba disable-managers-add-users**. + +## Amministrazione delle organizzazioni +{: #admin_orgs} + +### Aggiunta di un'organizzazione +{: #admin_add_org} + +Per aggiungere un'organizzazione, utilizza il seguente comando: + +``` +cf ba create-org +``` +{: codeblock} + +
+
<organization>
+
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} da aggiungere.
+
<gestore>
+
Il nome utente del gestore per l'organizzazione.
+
+ +**Suggerimento:** puoi anche utilizzare **ba co** come alias per +il più lungo nome comando **ba create-org**. + +### Eliminazione di un'organizzazione +{: #admin_delete_org} + +Per eliminare un'organizzazione, utilizza il seguente comando: + +``` +cf ba delete-org +``` +{: codeblock} + +
+
<organization>
+
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} da eliminare.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba do** come alias per +il più lungo nome comando **ba delete-org**. + +### Assegnazione di un utente a un'organizzazione +{: #admin_ass_user_org} + +Per assegnare un utente del tuo ambiente {{site.data.keyword.Bluemix_notm}} a +una specifica organizzazione, utilizza il seguente comando: + +``` +cf ba set-org [] +``` +{: codeblock} + +
+
<user_name>
+
Il nome dell'utente in {{site.data.keyword.Bluemix_notm}}.
+
<organization>
+
Il nome o GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} a cui assegnare l'utente.
+
<ruolo>
+
Vedi [Ruoli](/docs/admin/users_roles.html) per i ruoli utente di {{site.data.keyword.Bluemix_notm}} e le relative +descrizioni.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba so** come alias per +il più lungo nome comando **ba set-org**. + +### Annullamento dell'assegnazione di un utente da un'organizzazione +{: #admin_unass_user_org} + +Per annullare l'assegnazione di un utente del tuo ambiente {{site.data.keyword.Bluemix_notm}} da +una specifica organizzazione, utilizza il seguente comando: + +``` +cf ba unset-org [] +``` +{: codeblock} + +
+
<user_name>
+
Il nome dell'utente in {{site.data.keyword.Bluemix_notm}}.
+
<organization>
+
Il nome o GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} a cui assegnare l'utente.
+
<ruolo>
+
Vedi [Assegnazione di ruoli](/docs/admin/users_roles.html) per +i ruoli utente di {{site.data.keyword.Bluemix_notm}} e le relative +descrizioni.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba uo** come alias per +il più lungo nome comando **ba unset-org**. + +#### Assegnazione di ruoli + +
+
OrgManager
+
Gestore organizzazione. Un gestore organizzazione ha l'autorità per svolgere le seguenti azioni: +
    +
  • Creare o eliminare spazi all'interno dell'organizzazione.
    • +
  • Invitare gli utenti all'organizzazione e gestirli.
    • +
  • Gestire i domini dell'organizzazione.
    • +
+
+
BillingManager
+
Gestore fatturazione. Un gestore fatturazione può visualizzare le informazioni relative all'utilizzo di runtime e servizi +per l'organizzazione.
+
OrgAuditor
+
Revisore organizzazione. Un revisore organizzazione può visualizzare i contenuti di applicazioni e servizi in uno +spazio.
+
+ +### Impostazione di una quota per un'organizzazione +{: #admin_set_org_quota} + +Per impostare la quota di utilizzo per una specifica organizzazione, utilizza il seguente comando: + +``` +cf ba set-quota +``` +{: codeblock} + +
+
<organization>
+
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} per cui impostare la quota.
+
<piano>
+
Il piano di quota per un'organizzazione.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba sq** come alias per +il più lungo nome comando **ba set-quota**. + + +### Ricerca di quote contenitore per un'organizzazione +{: #admin_find_containquotas} + +Per trovare la quota per i contenitori di un'organizzazione, utilizza il seguente comando: + +``` +cf bluemix-admin containers-quota +``` +{: codeblock} + +
+
<organization>
+
Il nome o l'ID dell'organizzazione in Bluemix. Questo parametro è obbligatorio.
+
+ +**Suggerimento:** puoi anche utilizzare **ba cq** come alias per il più lungo +nome comando **bluemix-admin containers-quota**. + +### Impostazione di quote contenitore per un'organizzazione +{: #admin_set_containquotas} + +Per impostare la quota per i contenitori di un'organizzazione, utilizza il seguente comando con almeno una delle opzioni incluse: + +``` +cf bluemix-admin set-containers-quota +``` +{: codeblock} + +**Nota**: puoi includere più opzioni, ma ne devi includere almeno una. + +
+
<organization>
+
Il nome o l'ID dell'organizzazione in Bluemix. Questo parametro è obbligatorio.
+
<opzioni>
+
Includi una o più delle seguenti opzioni in cui il valore deve essere un numero intero: +
    +
  • floating-ips-max <value>
    • +
  • floating-ips-space-default <value>
    • +
  • memory-max <value>
    • +
  • memory-space-default <value>
    • +
  • image-limit <value>
    • +
+
+
+ +**Suggerimento:** puoi anche utilizzare i seguenti nomi brevi come un alias per i nomi delle opzioni più +lunghi: +
+
floating-ips-max <value>
+
fim
+
floating-ips-space-default <value>
+
fisd
+
memory-max <value>
+
mm
+
memory-space-default <value>
+
msd
+
image-limit <value>
+
il
+
+ +Facoltativamente, puoi fornire un file che contiene i parametri di configurazione specifici in un oggetto JSON valido. Se utilizzi l'opzione **-file**, ha la precedenza e le altre opzioni vengono ignorate. Per fornire un file anziché impostare le opzioni, utilizza il seguente comando: + +``` +cf bluemix-admin set-containers-quota <-file path_to_JSON_file> +``` +{: codeblock} + +Il file JSON deve avere il formato mostrato nel seguente esempio: + +``` +{ + "floating_ips_max": 10, + "floating_ips_space_default": 0, + "ram_max": 4096, + "ram_space_default": 0, + "image_limit": 10 +} +``` +{: codeblock} + +**Suggerimento:** puoi anche utilizzare **ba scq** come alias per il più lungo +nome comando **bluemix-admin set-containers-quota**. + +## Amministrazione di spazi +{: #admin_spaces} + +### Aggiunta di uno spazio all'organizzazione + +Per aggiungere uno spazio nell'organizzazione, utilizza il seguente comando: + +``` +cf bluemix-admin create-space +``` + +{: codeblock} + +
+
<organization>
+
Il nome o GUID dell'organizzazione a cui aggiungere lo spazio.
+
<space_name>
+
Il nome dello spazio da creare nell'organizzazione.
+
+ +**Suggerimento:** puoi anche utilizzare **ba cs** come alias per +il più lungo nome comando **ba create-space**. + +### Eliminazione di un spazio dall'organizzazione + +Per rimuovere uno spazio dall'organizzazione, utilizza il seguente comando: + +``` +cf bluemix-admin delete-space +``` + +{: codeblock} + +
+
<organization>
+
Il nome o GUID dell'organizzazione da cui rimuovere lo spazio.
+
<space_name>
+
Il nome dello spazio da rimuovere dall'organizzazione.
+
+ +**Suggerimento:** puoi anche utilizzare **ba cs** come alias per +il più lungo nome comando **ba delete-space**. + +### Aggiunta di un utente a uno spazio con un ruolo + +Per creare un utente in uno spazio con un ruolo specificato, utilizza il seguente comando: + +``` +cf bluemix-admin set-space +``` + +{: codeblock} + +
+
<organizzazione>
+
Il nome o GUID dell'organizzazione a cui aggiungere l'utente.
+
<space_name>
+
Il nome dello spazio a cui aggiungere l'utente.
+
<user_anme>
+
Il nome dell'utente da aggiungere.
+
<ruolo>
+
Il ruolo da assegnare all'utente. Il valore può essere Gestore, Sviluppatore o Revisore. Vedi [Assegnazione di ruoli](/docs/admin/users_roles.html) per +i ruoli utente di {{site.data.keyword.Bluemix_notm}} e le relative +descrizioni in uno spazio.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba ss** come alias per +il più lungo nome comando **ba set-space**. + + +### Rimozione del ruolo di un utente in uno spazio + +Per rimuovere il ruolo di un utente in uno spazio, utilizza il seguente comando: + +``` +cf bluemix-admin unset-space +``` + +{: codeblock} + +
+
<organization>
+
Il nome o GUID dell'organizzazione a cui aggiungere l'utente.
+
<space_name>
+
Il nome dello spazio a cui aggiungere l'utente.
+
<user_anme>
+
Il nome dell'utente da aggiungere.
+
<ruolo>
+
Il ruolo da assegnare all'utente. Il valore può essere Gestore, Sviluppatore o Revisore. Vedi [Assegnazione di ruoli](/docs/admin/users_roles.html) per +i ruoli utente di {{site.data.keyword.Bluemix_notm}} e le relative +descrizioni in uno spazio.
+
+ +**Suggerimento:** puoi anche utilizzare **ba us** come alias per il più lungo +nome comando **ba unset-space**. + +## Amministrazione del catalogo +{: #admin_catalog} + +### Abilitazione dei servizi per tutte le organizzazioni +{: #admin_ena_service_org} + +Per abilitare la visualizzazione di un servizio nel +Catalogo {{site.data.keyword.Bluemix_notm}} per tutte le +organizzazioni, utilizza il seguente comando: + +``` +cf ba enable-service-plan +``` +{: codeblock} + +
+
<identificativo_piano>
+
Il nome o il GUID del piano di servizio che desideri abilitare. Se immetti un nome del piano di servizio non univoco, ad esempio "Standard" o "Di base," ti verrà richiesto di scegliere tra dei piani di servizio. Per identificare il nome di un piano di servizio, seleziona la categoria di servizio dalla homepage, quindi fai clic su **Aggiungi** per visualizzarne i servizi. Fai clic sul nome del servizio per aprire la vista Dettagli, da cui puoi visualizzare i nomi dei piani di servizi disponibili per il servizio.
+
+ +**Suggerimento:** puoi anche utilizzare **ba esp** come alias per il più lungo +nome comando **ba enable-service-plan**. + +### Disabilitazione dei servizi per tutte le organizzazioni +{: #admin_dis_service_org} + +Per disabilitare la visualizzazione di un servizio nel Catalogo {{site.data.keyword.Bluemix_notm}} per tutte le +organizzazioni, utilizza il seguente comando: + +``` +cf ba disable-service-plan +``` +{: codeblock} + +
+
<identificativo_piano>
+
Il nome o il GUID del piano di servizio che desideri abilitare. Se immetti un nome del piano di servizio non univoco, ad esempio "Standard" o "Di base," ti verrà richiesto di scegliere tra dei piani di servizio. Per identificare il nome di un piano di servizio, seleziona la categoria di servizio dalla homepage, quindi fai clic su **Aggiungi** per visualizzarne i servizi. Fai clic sul nome del servizio per aprire la vista Dettagli, da cui puoi visualizzare i nomi dei piani di servizi disponibili per il servizio.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba dsp** come alias per il più +lungo nome comando **ba disable-service-plan**. + +### Aggiunta della visibilità dei servizi per le organizzazioni +{: #admin_addvis_service_org} + +Puoi aggiungere un'organizzazione dall'elenco di organizzazioni che possono vedere uno specifico servizio nel Catalogo {{site.data.keyword.Bluemix_notm}}. Per consentire a un'organizzazione di visualizzare uno specifico servizio nel +Catalogo {{site.data.keyword.Bluemix_notm}}, utilizza il seguente comando: + +``` +cf ba add-service-plan-visibility +``` +{: codeblock} + +
+
<identificativo_piano>
+
Il nome o il GUID del piano di servizio che desideri abilitare. Se immetti un nome del piano di servizio non univoco, ad esempio "Standard" o "Di base," ti verrà richiesto di scegliere tra dei piani di servizio. Per identificare il nome di un piano di servizio, seleziona la categoria di servizio dalla homepage, quindi fai clic su **Aggiungi** per visualizzarne i servizi. Fai clic sul nome del servizio per aprire la vista Dettagli, da cui puoi visualizzare i nomi dei piani di servizi disponibili per il servizio.
+
<organization>
+
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} da aggiungere all'elenco di visibilità del servizio.
+
+ +**Suggerimento:** puoi anche utilizzare **ba aspv** come alias per il più lungo +nome comando **ba add-service-plan-visibility**. + +### Rimozione della visibilità dei servizi per le organizzazioni +{: #admin_remvis_service_org} + +Puoi rimuovere un'organizzazione dall'elenco di organizzazioni che possono vedere +uno specifico servizio nel Catalogo {{site.data.keyword.Bluemix_notm}}. Per rimuovere la visibilità di un servizio nel +Catalogo {{site.data.keyword.Bluemix_notm}} per +un'organizzazione, utilizza il seguente comando: + +``` +cf ba remove-service-plan-visibility +``` +{: codeblock} + +
+
<identificativo_piano>
+
Il nome o il GUID del piano di servizio che desideri abilitare. Se immetti un nome del piano di servizio non univoco, ad esempio "Standard" o "Di base," ti verrà richiesto di scegliere tra dei piani di servizio. Per identificare il nome di un piano di servizio, seleziona la categoria di servizio dalla homepage, quindi fai clic su **Aggiungi** per visualizzarne i servizi. Fai clic sul nome del servizio per aprire la vista Dettagli, da cui puoi visualizzare i nomi dei piani di servizi disponibili per il servizio.
+
<organization>
+
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} da rimuovere dall'elenco di visibilità del servizio.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba rspv** come alias per il più +lungo nome comando **ba remove-service-plan-visibility**. + +### Modifica della visibilità dei servizi per le organizzazioni +{: #admin_editvis_service_org} + +Puoi modificare e sostituire l'elenco di servizi che specifiche +organizzazioni possono vedere nel Catalogo {{site.data.keyword.Bluemix_notm}}. Per sostituire tutti i servizi visibili esistenti per un'organizzazione o più organizzazioni, utilizza questo comando. + +``` +cf ba edit-service-plan-visibilities +``` +{: codeblock} + +**Nota:** questo comando sostituisce i servizi visibili esistenti per le organizzazioni specificate con il servizio da te specificato nel comando. + +
+
<identificativo_piano>
+
Il nome o il GUID del piano di servizio che desideri abilitare. Se immetti un nome del piano di servizio non univoco, ad esempio "Standard" o "Di base," ti verrà richiesto di scegliere tra dei piani di servizio. Per identificare il nome di un piano di servizio, seleziona la categoria di servizio dalla homepage, quindi fai clic su **Aggiungi** per visualizzarne i servizi. Fai clic sul nome del servizio per aprire la vista Dettagli, da cui puoi visualizzare i nomi dei piani di servizi disponibili per il servizio.
+
<organization>
+
Il nome o il GUID dell'organizzazione {{site.data.keyword.Bluemix_notm}} per cui aggiungere la visibilità. Puoi abilitare la visibilità del servizio per più di una singola organizzazione immettendo i GUID o i nomi organizzazione aggiuntivi nel comando.
+
+ +**Suggerimento:** puoi anche utilizzare **ba espv** come alias per il più lungo +nome comando **ba edit-service-plan-visibility**. + +## Gestione dei report +{: #admin_add_report} + +### Aggiunta di report +{: #admin_add_report} + +Per aggiungere un report di sicurezza, utilizza il seguente comando: + +``` +cf ba add-report +``` +{: codeblock} + +**Nota**: se hai accesso in scrittura per l'autorizzazione dei report, puoi creare una nuova categoria e aggiungere un report in uno qualsiasi dei formati accettati per i tuoi utenti. Immetti il nome della nuova categoria per il parametro `categoria` o aggiungi il nuovo report a una categoria esistente. + +
+
<categoria>
+
La categoria per il report. Se nel nome è presente uno spazio, racchiudi il nome +tra virgolette.
+
<data>
+
La data del report nel formato AAAAMMGG.
+
<PDF|TXT|LOG>
+
Il percorso del PDF, file di testo o file di log del report da caricare.
+
<RTF>
+
Un'opzione per includere una versione RTF (Rich Text Format) del PDF. Questa opzione si applica solo se +hai incluso il percorso del PDF del report. La versione RTF è utilizzata per l'indicizzazione e la ricerca.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba ar** come alias per +il più lungo nome comando **ba add-report**. + +### Eliminazione di report +{: #admin_del_report} + +Per eliminare un report di sicurezza, utilizza il seguente comando: + +``` +cf ba delete-report +``` +{: codeblock} + +
+
<categoria>
+
La categoria per il report. Se nel nome è presente uno spazio, racchiudi il nome +tra virgolette.
+
<data>
+
La data del report nel formato AAAAMMGG.
+
<nome>
+
Il nome del report.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba dr** come alias per +il più lungo nome comando **ba delete-report**. + +### Recupero di report +{: #admin_retr_report} + +Per recuperare un report di sicurezza, utilizza il seguente comando: + +``` +cf ba retrieve-report +``` +{: codeblock} + +
+
<search>
+
Il nome file del report. Se nel nome è presente uno spazio, racchiudi il nome +tra virgolette.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba rr** come alias per il più lungo nome comando **ba retrieve-report**. + +## Visualizzazione delle informazioni sulle metriche della risorsa +{: #cliresourceusage} + +Puoi visualizzare le informazioni sulle metriche della risorsa, tra cui l'utilizzo di memoria, disco e CPU. Oltre all'utilizzo di tali risorse, puoi vedere un riepilogo delle risorse fisiche e riservate disponibili. Puoi anche visualizzare i dati di utilizzo dei DEA (droplet execution agent) e delle celle (architettura Diego) e i dati cronologici per l'utilizzo di memoria e disco. Per impostazione predefinita, i dati cronologici per l'utilizzo di memoria e disco vengono visualizzati settimanalmente e in ordine decrescente. Per visualizzare le informazioni sulle metriche della risorsa, utilizza il seguente comando: + +``` +cf ba resource-metrics +``` +{: codeblock} + +
+
<mensile>
+
Visualizzare i dati cronologici per la memoria e lo spazio su disco un mese alla volta.
+
<settimanale>
+
Visualizzare i dati cronologici per la memoria e lo spazio su disco una settimana alla volta. Questo è il valore predefinito.
+
+ +**Suggerimento:** puoi anche utilizzare **ba rsm** come alias per il più lungo +nome comando **ba resource-metrics**. + + +## Gestione dei broker di servizi +{: #admin_servbro} + +### Elenco dei broker dei servizi +{: #clilistservbro} + +Per elencare tutti i broker dei servizi, utilizza il seguente comando: + +``` +cf ba service-brokers +``` +{: codeblock} + +**Nota**: per elencare tutti i broker dei servizi, immetti il comando omettendo il parametro `nome_broker`. + +
+
<nome_broker>
+
Facoltativo: nome del broker dei servizi personalizzato. Utilizza questo parametro per ottenere informazioni per un broker dei servizi specifico.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba sb** come alias per il più +lungo nome comando **ba service-brokers**. + +### Aggiunta di un broker dei servizi +{: #cliaddservbro} + +Per aggiungere un broker dei servizi, in modo da poter aggiungere un servizio personalizzato al tuo +Catalogo {{site.data.keyword.Bluemix_notm}}, utilizza il seguente comando: + +``` +cf ba add-service-broker +``` +{: codeblock} + +
+
<nome_broker>
+
Nome del broker dei servizi personalizzato.
+
<user_name>
+
Nome utente per l'account con accesso al broker dei servizi.
+
<password>
+
Password per l'account con accesso al broker dei servizi.
+
<url_broker>
+
URL per il broker dei servizi.
+
+ +**Suggerimento:** puoi anche utilizzare **ba asb** come alias per il più lungo +nome comando **ba add-service-broker**. + +### Eliminazione di un broker dei servizi +{: #clidelservbro} + +Per eliminare un broker dei servizi per rimuovere il servizio personalizzato dal tuo +Catalogo {{site.data.keyword.Bluemix_notm}}, utilizza il seguente comando: + +``` +cf ba delete-service-broker +``` +{: codeblock} + +
+
<broker_servizi>
+
Nome o GUID del broker dei servizi personalizzato.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba dsb** come alias per il più +lungo nome comando **ba delete-service-broker**. + +### Aggiornamento di un broker dei servizi +{: #cliupdservbro} + +Per aggiornare un broker dei servizi, utilizza il seguente comando: + +``` +cf ba update-service-broker +``` +{: codeblock} + +
+
<nome_broker>
+
Nome del broker dei servizi personalizzato.
+
<user_name>
+
Nome utente per l'account con accesso al broker dei servizi.
+
<password>
+
Password per l'account con accesso al broker dei servizi.
+
<url_broker>
+
URL per il broker dei servizi.
+
+ +**Suggerimento:** puoi anche utilizzare **ba usb** come alias per il più lungo +nome comando **ba update-service-broker**. + + +## Gestione dei gruppi di sicurezza dell'applicazione +{: #admin_secgro} + +Per gestire i gruppi di sicurezza dell'applicazione (ASG), devi essere un amministratore con accesso completo all'ambiente locale o dedicato. Tutti gli utenti dell'ambiente possono elencare gli ASG disponibili per l'organizzazione a cui si fa riferimento con il comando. Tuttavia, per creare, aggiornare o associare gli ASG, devi essere l'amministratore dell'ambiente {{site.data.keyword.Bluemix_notm}}. + +I gruppi ASG funzionano come firewall virtuali che controllano il traffico dall'applicazione presente nel tuo ambiente {{site.data.keyword.Bluemix_notm}}. Ogni ASG è costituito da un elenco di regole che consentono un traffico specifico e la comunicazione da e verso la rete esterna. Puoi associare uno o più ASG a una specifica serie di gruppi di sicurezza, ad esempio a una serie di gruppi utilizzata per applicare l'accesso globale, oppure associarli agli spazi all'interno di un'organizzazione nel tuo ambiente {{site.data.keyword.Bluemix_notm}}. + +{{site.data.keyword.Bluemix_notm}} è inizialmente impostato con limitazioni a tutti gli accessi alla rete esterna. Due gruppi di sicurezza creati da IBM, `public_networks` e `dns`, abilitano l'accesso globale alla rete esterna quando esegui il bind di tali gruppi alla serie di gruppi di sicurezza Cloud Foundry predefinita. Le due serie di gruppi di sicurezza in Cloud Foundry utilizzate per applicare l'accesso globale sono **Preparazione predefinita** ed **Esecuzione predefinita**. Queste serie di gruppi applicano le regole per consentire il traffico a tutte le applicazioni in esecuzione o a tutte le applicazioni in fase di preparazione. Se non vuoi eseguire il bind a queste due serie di gruppi di sicurezza, puoi annullare il bind alle serie di gruppi Cloud Foundry e quindi associare il gruppo a uno specifico spazio. Per ulteriori informazioni, vedi [Binding Application Security Groups ![icona link esterno](../../../icons/launch-glyph.svg)](https://docs.cloudfoundry.org/adminguide/app-sec-groups.html#binding-groups){: new_window}. + +**Nota**: i seguenti comandi che consentono di gestire i gruppi di sicurezza, si basano su Cloud Foundry versione 1.6. Per ulteriori informazioni, inclusi i campi obbligatori e facoltativi, consulta la sezione Cloud Foundry relativa a [Creating Application Security Groups ![icona link esterno](../../../icons/launch-glyph.svg)](https://docs.cloudfoundry.org/adminguide/app-sec-groups.html#creating-groups){: new_window}. + +### Elenco dei gruppi di sicurezza +{: #clilissecgro} + +* Per elencare tutti i gruppi di sicurezza, utilizza il seguente comando: + +``` +cf ba security-groups +``` +{: codeblock} + +**Suggerimento:** puoi anche utilizzare **ba sgs** come alias per il più lungo nome comando +**ba security-groups**. + +* Per visualizzare i dettagli di uno specifico gruppo di sicurezza, utilizza il seguente comando: + +``` +cf ba security-groups +``` +{: codeblock} + +
+
<Gruppo di sicurezza>
+
Nome del gruppo di sicurezza
+
+ +**Suggerimento:** puoi anche utilizzare **ba sg** come alias per il più lungo nome comando +**ba security-groups** con il parametro `security-group`. + + +### Creazione di un gruppo di sicurezza +{: #clicreasecgro} + +Per ulteriori informazioni sulla creazione di gruppi di sicurezza e sulle regole che definiscono il traffico in uscita, vedi [Creating Application Security Groups ![icona link esterno](../../../icons/launch-glyph.svg)](https://docs.cloudfoundry.org/adminguide/app-sec-groups.html#creating-groups){: new_window}. + +Per creare un gruppo di sicurezza, utilizza il seguente comando: + +``` +cf ba create-security-group +``` +{: codeblock} + +Al nome di ciascun gruppo di sicurezza creato, viene aggiunto il prefisso `adminconsole_` per distinguerlo dai gruppi di sicurezza creati da IBM. + +
+
<Gruppo di sicurezza>
+
Nome del tuo gruppo di sicurezza
+
<Percorso del file di regole>
+
Percorso assoluto o relativo a un file di regole
+
+ +**Suggerimento:** puoi anche utilizzare **ba csg** come alias per il più lungo nome comando +**ba create-security-group**. + +### Aggiornamento di un gruppo di sicurezza +{: #cliupdsecgro} + +Per aggiornare un gruppo di sicurezza, utilizza il seguente comando: + +``` +cf ba update-security-group +``` +{: codeblock} + +
+
<Gruppo di sicurezza>
+
Nome del tuo gruppo di sicurezza
+
<Percorso del file di regole>
+
Percorso assoluto o relativo a un file di regole
+
+ +**Suggerimento:** puoi anche utilizzare **ba usg** come alias per il più lungo nome comando +**ba update-security-group**. + +### Eliminazione di un gruppo di sicurezza +{: #clidelsecgro} + +Per eliminare un gruppo di sicurezza, utilizza il seguente comando: + +``` +cf ba delete-security-group +``` +{: codeblock} + +
+
<Gruppo di sicurezza>
+
Nome del tuo gruppo di sicurezza
+
+ +**Suggerimento:** puoi anche utilizzare **ba dsg** come alias per il più lungo nome comando +**ba delete-security-group**. + + +### Esecuzione del bind dei gruppi di sicurezza +{: #clibindsecgro} + +Per ulteriori informazioni sull'esecuzione del bind dei gruppi di sicurezza, vedi [Binding Application Security Groups ![icona link esterno](../../../icons/launch-glyph.svg)](https://docs.cloudfoundry.org/adminguide/app-sec-groups.html#binding-groups){: new_window}. + +* Per eseguire il bind alla serie di gruppi di sicurezza Preparazione predefinita, utilizza il seguente comando: + +``` +cf ba bind-staging-security-group +``` +{: codeblock} + +
+
<Gruppo di sicurezza>
+
Nome del tuo gruppo di sicurezza
+
+ +**Suggerimento:** puoi anche utilizzare **ba bssg** come alias per il più lungo nome comando +**ba bind-staging-security-group**. + +* Per eseguire il bind alla serie di gruppi di sicurezza Esecuzione predefinita, utilizza il seguente comando: + +``` +cf ba bind-running-security-group +``` +{: codeblock} + +
+
<Gruppo di sicurezza>
+
Nome del tuo gruppo di sicurezza
+
+ +**Suggerimento:** puoi anche utilizzare **ba brsg** come alias per il più lungo nome comando +**ba bind-running-security-group**. + +* Per eseguire il bind di un gruppo di sicurezza a uno spazio, utilizza il seguente comando: + +``` +cf ba bind-security-group +``` +{: codeblock} + +
+
<Gruppo di sicurezza>
+
Nome del tuo gruppo di sicurezza
+
<Organizzazione>
+
Nome dell'organizzazione a cui eseguire il bind del gruppo di sicurezza
+
<Spazio>
+
Nome dello spazio all'interno dell'organizzazione a cui eseguire il bind del gruppo di sicurezza
+
+ +**Suggerimento:** puoi anche utilizzare **ba bsg** come alias per il più lungo nome comando +**ba bind-security-group**. + +### Annullamento del bind dei gruppi di sicurezza +{: #cliunbindsecgro} + +Per ulteriori informazioni sull'annullamento del bind dei gruppi di sicurezza, vedi [Unbinding Application Security Groups ![icona link esterno](../../../icons/launch-glyph.svg)](https://docs.cloudfoundry.org/adminguide/app-sec-groups.html#unbinding-groups){: new_window}. + +* Per annullare il bind dalla serie di gruppi di sicurezza Preparazione predefinita, utilizza il seguente comando: + +``` +cf ba unbind-staging-security-group +``` +{: codeblock} + +
+
<Gruppo di sicurezza>
+
Nome del tuo gruppo di sicurezza
+
+ +**Suggerimento:** puoi anche utilizzare **ba ussg** come alias per il più lungo nome comando +**ba unbind-staging-security-group**. + +* Per annullare il bind dalla serie di gruppi di sicurezza Esecuzione predefinita, utilizza il seguente comando: + +``` +cf ba unbind-running-security-group +``` +{: codeblock} + +
+
<Gruppo di sicurezza>
+
Nome del tuo gruppo di sicurezza
+
+ +**Suggerimento:** puoi anche utilizzare **ba brsg** come alias per il più lungo nome comando +**ba bind-running-security-group**. + +* Per annullare il bind di un gruppo di sicurezza a uno spazio, utilizza il seguente comando: + +``` +cf ba unbind-security-group +``` +{: codeblock} + +
+
<Gruppo di sicurezza>
+
Nome del tuo gruppo di sicurezza
+
<Organizzazione>
+
Nome dell'organizzazione a cui eseguire il bind del gruppo di sicurezza
+
<Spazio>
+
Nome dello spazio all'interno dell'organizzazione a cui eseguire il bind del gruppo di sicurezza
+
+ +**Suggerimento:** puoi anche utilizzare **ba usg** come alias per il più lungo nome comando +**ba unbind-staging-security-group**. + +## Gestione dei pacchetti di build +{: #admin_buildpack} + +### Elenco dei pacchetti di build +{: #clilistbuildpack} + +Se disponi di autorizzazioni di scrittura nel catalogo di applicazioni, puoi elencare i pacchetti di build. Per elencare tutti i pacchetti di build o visualizzarne uno specifico, utilizza il seguente comando: + +``` +cf ba buildpacks +``` +{: codeblock} + +
+
<nome_pacchettodibuild>
+
Un parametro facoltativo per specificare un determinato pacchetto di build da visualizzare.
+
+ +**Suggerimento:** puoi anche utilizzare **ba lb** come alias per il più lungo +nome comando **ba buildpacks**. + +### Creazione e caricamento di un pacchetto di build +{: #clicreupbuildpack} + +Se disponi di autorizzazioni di scrittura nel catalogo di applicazioni, puoi creare e caricare un pacchetto di build. Puoi caricare qualsiasi file compresso che presenta un tipo di file .zip. Per caricare un pacchetto di build, utilizza il seguente comando: + +``` +cf ba create-buildpack +``` +{: codeblock} + +
+
<nome_pacchettodibuild>
+
Il nome del pacchetto di build da caricare.
+
<percorso_file>
+
Il percorso del file compresso del pacchetto di build.
+
<posizione>
+
L'ordine in cui vengono controllati i pacchetti di build durante il rilevamento automatico.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba cb** come alias per il più lungo +nome comando **ba create-buildpack**. + +### Aggiornamento di un pacchetto di build +{: #cliupdabuildpack} + +Se disponi di autorizzazioni di scrittura nel catalogo di applicazioni, puoi aggiornare un pacchetto di build esistente. Per aggiornare un pacchetto di build, utilizza il seguente comando: + +``` +cf ba update-buildpack +``` +{: codeblock} + +
+
<nome_pacchettodibuild>
+
Il nome del pacchetto di build da aggiornare.
+
<posizione>
+
L'ordine in cui vengono controllati i pacchetti di build durante il rilevamento automatico.
+
<abilitato>
+
Indica se il pacchetto di build è utilizzato per la fase di preparazione.
+
<bloccato>
+
Indica se il pacchetto di build è bloccato per impedire gli aggiornamenti.
+
+ +**Suggerimento:** puoi anche utilizzare **ba ub** come alias per il più lungo +nome comando **ba update-buildpack**. + +### Eliminazione di un pacchetto di build +{: #clidelbuildpack} + +Se disponi di autorizzazioni di scrittura nel catalogo di applicazioni, puoi eliminare un pacchetto di build esistente. Per eliminare un pacchetto di build, utilizza il seguente comando: + +``` +cf ba delete-buildpack +``` +{: codeblock} + +
+
<nome_pacchettodibuild>
+
Il nome del pacchetto di build da eliminare.
+
+ +**Suggerimento: ** puoi anche utilizzare **ba db** come alias per il più lungo +nome comando **ba delete-buildpack**. diff --git a/cli/nl/it/plugins/bx_vpn/index.md b/cli/nl/it/plugins/bx_vpn/index.md index 09ceab56e..a771cc4a0 100644 --- a/cli/nl/it/plugins/bx_vpn/index.md +++ b/cli/nl/it/plugins/bx_vpn/index.md @@ -1,440 +1,440 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2016-06-20" - - ---- - -{:codeblock: .codeblock} -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Plug-in {{site.data.keyword.vpn_short}} per la CLI {{site.data.keyword.Bluemix_notm}} - -*Versione:* 1.4.0 - -Puoi utilizzare la CLI (command line interface) per configurare e gestire il tuo servizio {{site.data.keyword.vpn_full}}. Il plug-in della CLI {{site.data.keyword.vpn_short}} è disponibile in due versioni: una per l'utilizzo del plug-in con la CLI Cloud Foundry e l'altra per l'utilizzo del plug-in con la CLI {{site.data.keyword.Bluemix}}. Entrambe le versioni del plug-in forniscono la stessa funzionalità. -{:shortdesc} - -Il plug-in {{site.data.keyword.vpn_short}} è disponibile per i sistemi operativi Windows, MAC e Linux. Assicurati di utilizzare il plug-in adatto a te. - -Le seguenti istruzioni servono a gestire il plug-in della CLI {{site.data.keyword.Bluemix_notm}}. Per utilizzare il plug-in con il plug-in della CLI Cloud Foundry (cf), consulta [{{site.data.keyword.vpn_short}} CLI plug-in for cf CLI](../vpn/index.html). - - -Le informazioni qui di seguito elencano tutti i comandi supportati dalla CLI {{site.data.keyword.vpn_short}} per la CLI Bluemix CLI e includono i relativi nomi, opzioni, utilizzo, prerequisiti, descrizioni ed esempi. Consulta [Extend your Bluemix command line interface](../../index.html#cli_bluemix_ext) su come installare il plug-in vpn. - -**Nota:** i *Prerequisiti* elencano quali azioni sono richieste prima di utilizzare il comando. I prerequisiti possono includere una o più delle seguenti azioni: -
-
**Endpoint**
-
Un endpoint API deve essere impostato mediante `bluemix api` prima di utilizzare il comando.
-
**Accesso**
-
L'accesso utilizzando il comando `bluemix login` è richiesto prima di utilizzare questo comando.
-
**Destinazione**
-
Il comando `bluemix target` deve essere utilizzato per impostare un'organizzazione e uno spazio prima di utilizzare questo comando.
-
- - -## bluemix vpn connection-create -Crea una connessione VPN. - -``` -bluemix vpn connection-create CONNECTION_NAME -g GATEWAY_NAME -k PRESHARED_KEY -subnets "SUBNET/MASK" -cip CUSTOMER_GATEWAY_IP_ADDRESS [-d DESCRIPTION] [-peer_id PEER_ID] [-admin_state ADMIN_STATE] [-dpd-action ACTION] [-gateway_ip IP_ADDRESS] [-i INITIATOR_STATE] [-dpd-timeout VALUE] [-dpd-interval VALUE] [-ike NAME] [-ipsec NAME] -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_CONNESSIONE*  (obbligatorio): il nome della connessione. - --g *NOME_GATEWAY* (obbligatorio): il nome del gateway. - --k *CHIAVE_PRECONDIVISA* (obbligatorio): la chiave precondivisa. - --subnets "*SOTTORETE*/*MASCHERA*" (obbligatorio): l'indirizzo di sottorete remota in formato CIDR. - --cip *INDIRIZZO_IP_GATEWAY_CLIENTE* (obbligatorio): l'indirizzo IP dell'endpoint remoto del tunnel VPN. - --d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. - --peer_id *ID_PEER* (facoltativo): l'ID del peer remoto. Altro endpoint del tunnel VPN. - --admin_state *STATO_AMMINISTRAZIONE* (facoltativo): lo stato della connessione VPN. I valori validi sono `UP` o `DOWN`. - --dpd-action *AZIONE* (facoltativo): l'azione da eseguire quando viene rilevato che il peer è inattivo. I valori validi sono `hold`, `clear`, `disabled`, `restart` o `restart-by-peer`. Il valore predefinito è `hold`. - --gateway_ip *INDIRIZZO_IP* (facoltativo): l'indirizzo IP dell'endpoint del tunnel VPN locale. - --i *STATO_INIZIATORE* (facoltativo): lo stato dell'iniziatore. Il valore predefinito è `bi-directional`. - --dpd-timeout *VALORE* (facoltativo): il valore di timeout, espresso in secondi, dopo il quale la sessione viene terminata. Intervallo: 6 - 86400 secondi. Il valore predefinito è `120` secondi. - --dpd-interval *VALORE* (facoltativo): l'intervallo keepalive, in secondi. Invia dei messaggi keepalive all'intervallo configurato per verificare lo stato di attività del peer. Intervallo: 5-86399 secondi. Il valore predefinito è `15` secondi. - --ike *NOME* (facoltativo): il nome della politica IKE. - --ipsec *NOME* (facoltativo): il nome della politica IPSec. - -**Esempi**: - -Crea una nuova connessione vpn con il nome `my_connection`: -``` -bluemix vpn connection-create my_connection -g my_gateway -k 123456 -subnets "192.168.10.0/24" -cip 162.135.1.1 -``` - - -## bluemix vpn ike-create -Crea una politica IKE. - -``` -bluemix vpn ike-create POLICY_NAME -g GATEWAY_NAME [-d DESCRIPTION] [-pfs GROUP] [-e ENCRYPTION_ALGORITHM] [-lv LIFETIME_VALUE] -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_POLITICA*  (obbligatorio): il nome della politica IKE. - --g *NOME_GATEWAY* (obbligatorio): il nome del gateway. - --d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. - --pfs *GRUPPO* (facoltativo): l'identificativo del gruppo DH (Diffie-Hellman). I valori validi sono `Group2`, `Group5` o `Group14`. Il valore predefinito è `Group2`. - --e *ALGORITMO_DI_CRITTOGRAFIA* (facoltativo): l'algoritmo di crittografia. I valori validi sono `aes-128`, `aes-192`, `aes-256` o `3des`. Il valore predefinito è `aes-128`. - --lv *VALORE_DURATA* (facoltativo): il valore di durata dell'associazione di sicurezza IKE. Intervallo: 60 - 86400 secondi. Il valore predefinito è `86400` secondi. - -**Esempi**: - -Crea una nuova politica IKE con il nome `my_ike`: -``` -bluemix vpn ike-create my_ike -g my_gateway -``` - - -## bluemix vpn ipsec-create -Crea una politica IPSec. - -``` -bluemix vpn ipsec-create POLICY_NAME -g GATEWAY_NAME [-d DESCRIPTION] [-pfs GROUP] [-e ENCRYPTION_ALGORITHM] [-lv LIFETIME_VALUE] -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_POLITICA*  (obbligatorio): il nome della politica IPSec. - --g *NOME_GATEWAY* (obbligatorio): il nome del gateway. - --d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. - --pfs *GRUPPO* (facoltativo): l'identificativo del gruppo DH (Diffie-Hellman). I valori validi sono `Group2`, `Group5` o `Group14`. Il valore predefinito è `Group2`. - --e *ALGORITMO_DI_CRITTOGRAFIA* (facoltativo): l'algoritmo di crittografia. I valori validi sono `aes-128`, `aes-192`, `aes-256` o `3des`. Il valore predefinito è `aes-128`. - --lv *VALORE_DURATA* (facoltativo): il valore di durata dell'associazione di sicurezza. Intervallo: 60 - 86400 secondi. Il valore predefinito è `3600` secondi. - -**Esempi**: - -Crea una politica IPSec con il nome `my_policy`: -``` -bluemix vpn ipsec-create my_policy -g my_gateway -``` - - -## bluemix vpn gateway-create -Crea un gateway VPN. - -``` -bluemix vpn gateway-create GATEWAY_NAME -t TYPE [-gateway_ip IP_ADDRESS] [-subnets SUBNET_ADDRESS] -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_GATEWAY* (obbligatorio): il nome del gateway. - --t *TIPO* (obbligatorio): contenitori per i quali vuoi abilitare il servizio. I valori validi sono `allSingleContainers`, `allContainerGroups` o `allContainers`. Nessun valore predefinito; devi specificare un tipo. - --gateway_ip *INDIRIZZO_IP* (facoltativo); l'indirizzo IP del gateway. - --subnets *INDIRIZZO_SOTTORETE* (facoltativo): l'indirizzo di sottorete in formato CIDR. - -**Esempi**: - -Crea un gateway con il nome `my_gateway` e il tipo `allContainerGroups`: -``` -bluemix vpn gateway-create my_gateway -t allContainerGroups -``` - - -## bluemix vpn connections -Visualizza le informazioni su tutte le connessioni correnti. - -``` -bluemix vpn connections -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - - -## bluemix vpn ikes -Visualizza le informazioni sulle connessioni IKE correnti. - -``` -bluemix vpn ikes -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - - -## bluemix vpn ipsecs -Visualizza le informazioni sulle connessioni IPSec correnti. - -``` -bluemix vpn ipsecs -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - - -## bluemix vpn gateways -Visualizza le informazioni sui gateway correnti. - -``` -bluemix vpn gateways -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - - -## bluemix vpn connection -Visualizza tutte le informazioni su una specifica connessione. - -``` -bluemix vpn connection NOME_CONNESSIONE -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_CONNESSIONE*  (obbligatorio): il nome della connessione da visualizzare. - - -## bluemix vpn ike -Visualizza le informazioni su una connessione IKE. - -``` -bluemix vpn ike NOME_POLITICA -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_POLITICA* (obbligatorio): il nome della politica IKE da visualizzare. - - -## bluemix vpn ipsec -Visualizza le informazioni su una connessione IPSec. - -``` -bluemix vpn ipsec NOME_POLITICA -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_POLITICA* (obbligatorio): il nome della politica IPSec da visualizzare. - - -## bluemix vpn gateway -Visualizza le informazioni di connessione relative a un gateway. - -``` -bluemix vpn gateway NOME_GATEWAY -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_GATEWAY*  (obbligatorio): il nome del gateway da visualizzare. - - -## bluemix vpn connection-delete -Elimina una connessione esistente. - -``` -bluemix vpn connection-delete NOME_CONNESSIONE -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_CONNESSIONE*  (obbligatorio): il nome della connessione da eliminare. - - -## bluemix vpn ike-delete -Elimina una politica IKE esistente. - -``` -bluemix vpn ike-delete NOME_POLITICA -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_POLITICA* (obbligatorio): il nome della politica IKE da eliminare. - - -## bluemix vpn ipsec-delete -Elimina una politica IPSec esistente. - -``` -bluemix vpn ipsec-delete NOME_POLITICA -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_POLITICA* (obbligatorio): il nome della politica IPSec da eliminare. - - -## bluemix vpn gateway-delete -Elimina un gateway esistente. - -``` -bluemix vpn gateway-delete NOME_GATEWAY -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_GATEWAY*  (obbligatorio): il nome del gateway da eliminare. - - -## bluemix vpn connection-update -Aggiorna una connessione VPN esistente. - -``` -bluemix vpn connection-update CONNECTION_NAME [-g GATEWAY_NAME] [-k PRESHARED_KEY] [-subnets "SUBNET/MASK"] [-cip CUSTOMER_GATEWAY_IP_ADDRESS] [-d DESCRIPTION] [-peer_id PEER_ID] [-admin_state ADMIN_STATE] [-dpd-action ACTION] [-gateway_ip IP_ADDRESS] [-i INITIATOR_STATE] [-dpd-timeout VALUE] [-dpd-interval VALUE] [-ike NAME] [-ipsec NAME] -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_CONNESSIONE*  (obbligatorio): il nome della connessione. - --g *NOME_GATEWAY* (facoltativo): il nome del gateway. - --k *CHIAVE_PRECONDIVISA* (facoltativo): la chiave precondivisa. - --subnets "*SOTTORETE*/*MASCHERA*" (facoltativo): l'indirizzo di sottorete in formato CIDR. - --cip *INDIRIZZO_IP_GATEWAY_CLIENTE* (facoltativo): l'indirizzo IP dell'endpoint remoto del tunnel VPN. - --d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. - --peer_id *ID_PEER* (facoltativo): l'ID del peer remoto. Altro endpoint del tunnel VPN. - --admin_state *STATO_AMMINISTRAZIONE* (facoltativo): lo stato della connessione VPN. I valori validi sono `UP` o `DOWN`. - --dpd-action *AZIONE* (facoltativo): l'azione da eseguire quando viene rilevato che il peer è inattivo. I valori validi sono `hold`, `clear`, `disabled`, `restart` o `restart-by-peer`. - --gateway_ip *INDIRIZZO_IP* (facoltativo): l'indirizzo IP dell'endpoint del tunnel VPN locale. - --i *STATO_INIZIATORE* (facoltativo): lo stato dell'iniziatore. - --dpd-timeout *VALORE* (facoltativo): il valore di timeout, espresso in secondi, dopo il quale la sessione viene terminata. Intervallo: 6 - 86400 secondi. - --dpd-interval *VALORE* (facoltativo): l'intervallo keepalive, in secondi. Invia dei messaggi keepalive all'intervallo configurato per verificare lo stato di attività del peer. Intervallo: 5-86399 secondi. - --ike *NOME* (facoltativo): il nome della politica IKE. - --ipsec *NOME* (facoltativo): il nome della politica IPSec. - - -## bluemix vpn ike-update -Aggiorna una politica IKE. - -``` -bluemix vpn ike-update POLICY_NAME [-g GATEWAY_NAME] [-d DESCRIPTION] [-pfs GROUP] [-e ENCRYPTION_ALGORITHM] [-lv LIFETIME_VALUE] -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_POLITICA*  (obbligatorio): il nome della politica IKE. - --g *NOME_GATEWAY* (facoltativo): il nome del gateway. - --d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. - --pfs *GRUPPO* (facoltativo): l'identificativo del gruppo DH (Diffie-Hellman). I valori validi sono `Group2`, `Group5` o `Group14`. - --e *ALGORITMO_DI_CRITTOGRAFIA* (facoltativo): l'algoritmo di crittografia. I valori validi sono `aes-128`, `aes-192`, `aes-256` o `3des`. - --lv *VALORE_DURATA* (facoltativo): il valore di durata dell'associazione di sicurezza IKE. Intervallo: 60 - 86400 secondi. - - -## bluemix vpn ipsec-update -Aggiorna una politica IPSec. - -``` -bluemix vpn ipsec-update POLICY_NAME [-g GATEWAY_NAME] [-d DESCRIPTION] [-pfs GROUP] [-e ENCRYPTION_ALGORITHM] [-lv LIFETIME_VALUE] -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_POLITICA*  (obbligatorio): il nome della politica IPSec. - --g *NOME_GATEWAY* (facoltativo): il nome del gateway. - --d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. - --pfs *GRUPPO* (facoltativo): l'identificativo del gruppo DH (Diffie-Hellman). I valori validi sono `Group2`, `Group5` o `Group14`. - --e *ALGORITMO_DI_CRITTOGRAFIA* (facoltativo): l'algoritmo di crittografia. I valori validi sono `aes-128`, `aes-192`, `aes-256` o `3des`. - --lv *VALORE_DURATA* (facoltativo): il valore di durata dell'associazione di sicurezza. Intervallo: 60 - 86400 secondi. - - -## bluemix vpn gateway-update -Aggiorna un gateway VPN esistente. - -``` -bluemix vpn gateway-update GATEWAY_NAME [-t TYPE] [-gateway_ip IP_ADDRESS] [-subnets SUBNET_ADDRESS] -``` - -**Prerequisiti**: Endpoint, Accesso, Destinazione - -**Opzioni del comando**: - -*NOME_GATEWAY* (obbligatorio): il nome del gateway. - --t *TIPO* (facoltativo): contenitori per i quali vuoi abilitare il servizio. I valori validi sono `allSingleContainers`, `allContainerGroups` o `allContainers`. - --gateway_ip *INDIRIZZO_IP* (facoltativo); l'indirizzo IP del gateway. - --subnets *INDIRIZZO_SOTTORETE* (facoltativo): l'indirizzo di sottorete in formato CIDR. +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2016-06-20" + + +--- + +{:codeblock: .codeblock} +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Plug-in {{site.data.keyword.vpn_short}} per la CLI {{site.data.keyword.Bluemix_notm}} + +*Versione:* 1.4.0 + +Puoi utilizzare la CLI (command line interface) per configurare e gestire il tuo servizio {{site.data.keyword.vpn_full}}. Il plug-in della CLI {{site.data.keyword.vpn_short}} è disponibile in due versioni: una per l'utilizzo del plug-in con la CLI Cloud Foundry e l'altra per l'utilizzo del plug-in con la CLI {{site.data.keyword.Bluemix}}. Entrambe le versioni del plug-in forniscono la stessa funzionalità. +{:shortdesc} + +Il plug-in {{site.data.keyword.vpn_short}} è disponibile per i sistemi operativi Windows, MAC e Linux. Assicurati di utilizzare il plug-in adatto a te. + +Le seguenti istruzioni servono a gestire il plug-in della CLI {{site.data.keyword.Bluemix_notm}}. Per utilizzare il plug-in con il plug-in della CLI Cloud Foundry (cf), consulta [{{site.data.keyword.vpn_short}} CLI plug-in for cf CLI](../vpn/index.html). + + +Le informazioni qui di seguito elencano tutti i comandi supportati dalla CLI {{site.data.keyword.vpn_short}} per la CLI Bluemix CLI e includono i relativi nomi, opzioni, utilizzo, prerequisiti, descrizioni ed esempi. Consulta [Extend your Bluemix command line interface](../../index.html#cli_bluemix_ext) su come installare il plug-in vpn. + +**Nota:** i *Prerequisiti* elencano quali azioni sono richieste prima di utilizzare il comando. I prerequisiti possono includere una o più delle seguenti azioni: +
+
**Endpoint**
+
Un endpoint API deve essere impostato mediante `bluemix api` prima di utilizzare il comando.
+
**Accesso**
+
L'accesso utilizzando il comando `bluemix login` è richiesto prima di utilizzare questo comando.
+
**Destinazione**
+
Il comando `bluemix target` deve essere utilizzato per impostare un'organizzazione e uno spazio prima di utilizzare questo comando.
+
+ + +## bluemix vpn connection-create +Crea una connessione VPN. + +``` +bluemix vpn connection-create CONNECTION_NAME -g GATEWAY_NAME -k PRESHARED_KEY -subnets "SUBNET/MASK" -cip CUSTOMER_GATEWAY_IP_ADDRESS [-d DESCRIPTION] [-peer_id PEER_ID] [-admin_state ADMIN_STATE] [-dpd-action ACTION] [-gateway_ip IP_ADDRESS] [-i INITIATOR_STATE] [-dpd-timeout VALUE] [-dpd-interval VALUE] [-ike NAME] [-ipsec NAME] +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_CONNESSIONE*  (obbligatorio): il nome della connessione. + +-g *NOME_GATEWAY* (obbligatorio): il nome del gateway. + +-k *CHIAVE_PRECONDIVISA* (obbligatorio): la chiave precondivisa. + +-subnets "*SOTTORETE*/*MASCHERA*" (obbligatorio): l'indirizzo di sottorete remota in formato CIDR. + +-cip *INDIRIZZO_IP_GATEWAY_CLIENTE* (obbligatorio): l'indirizzo IP dell'endpoint remoto del tunnel VPN. + +-d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. + +-peer_id *ID_PEER* (facoltativo): l'ID del peer remoto. Altro endpoint del tunnel VPN. + +-admin_state *STATO_AMMINISTRAZIONE* (facoltativo): lo stato della connessione VPN. I valori validi sono `UP` o `DOWN`. + +-dpd-action *AZIONE* (facoltativo): l'azione da eseguire quando viene rilevato che il peer è inattivo. I valori validi sono `hold`, `clear`, `disabled`, `restart` o `restart-by-peer`. Il valore predefinito è `hold`. + +-gateway_ip *INDIRIZZO_IP* (facoltativo): l'indirizzo IP dell'endpoint del tunnel VPN locale. + +-i *STATO_INIZIATORE* (facoltativo): lo stato dell'iniziatore. Il valore predefinito è `bi-directional`. + +-dpd-timeout *VALORE* (facoltativo): il valore di timeout, espresso in secondi, dopo il quale la sessione viene terminata. Intervallo: 6 - 86400 secondi. Il valore predefinito è `120` secondi. + +-dpd-interval *VALORE* (facoltativo): l'intervallo keepalive, in secondi. Invia dei messaggi keepalive all'intervallo configurato per verificare lo stato di attività del peer. Intervallo: 5-86399 secondi. Il valore predefinito è `15` secondi. + +-ike *NOME* (facoltativo): il nome della politica IKE. + +-ipsec *NOME* (facoltativo): il nome della politica IPSec. + +**Esempi**: + +Crea una nuova connessione vpn con il nome `my_connection`: +``` +bluemix vpn connection-create my_connection -g my_gateway -k 123456 -subnets "192.168.10.0/24" -cip 162.135.1.1 +``` + + +## bluemix vpn ike-create +Crea una politica IKE. + +``` +bluemix vpn ike-create POLICY_NAME -g GATEWAY_NAME [-d DESCRIPTION] [-pfs GROUP] [-e ENCRYPTION_ALGORITHM] [-lv LIFETIME_VALUE] +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_POLITICA*  (obbligatorio): il nome della politica IKE. + +-g *NOME_GATEWAY* (obbligatorio): il nome del gateway. + +-d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. + +-pfs *GRUPPO* (facoltativo): l'identificativo del gruppo DH (Diffie-Hellman). I valori validi sono `Group2`, `Group5` o `Group14`. Il valore predefinito è `Group2`. + +-e *ALGORITMO_DI_CRITTOGRAFIA* (facoltativo): l'algoritmo di crittografia. I valori validi sono `aes-128`, `aes-192`, `aes-256` o `3des`. Il valore predefinito è `aes-128`. + +-lv *VALORE_DURATA* (facoltativo): il valore di durata dell'associazione di sicurezza IKE. Intervallo: 60 - 86400 secondi. Il valore predefinito è `86400` secondi. + +**Esempi**: + +Crea una nuova politica IKE con il nome `my_ike`: +``` +bluemix vpn ike-create my_ike -g my_gateway +``` + + +## bluemix vpn ipsec-create +Crea una politica IPSec. + +``` +bluemix vpn ipsec-create POLICY_NAME -g GATEWAY_NAME [-d DESCRIPTION] [-pfs GROUP] [-e ENCRYPTION_ALGORITHM] [-lv LIFETIME_VALUE] +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_POLITICA*  (obbligatorio): il nome della politica IPSec. + +-g *NOME_GATEWAY* (obbligatorio): il nome del gateway. + +-d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. + +-pfs *GRUPPO* (facoltativo): l'identificativo del gruppo DH (Diffie-Hellman). I valori validi sono `Group2`, `Group5` o `Group14`. Il valore predefinito è `Group2`. + +-e *ALGORITMO_DI_CRITTOGRAFIA* (facoltativo): l'algoritmo di crittografia. I valori validi sono `aes-128`, `aes-192`, `aes-256` o `3des`. Il valore predefinito è `aes-128`. + +-lv *VALORE_DURATA* (facoltativo): il valore di durata dell'associazione di sicurezza. Intervallo: 60 - 86400 secondi. Il valore predefinito è `3600` secondi. + +**Esempi**: + +Crea una politica IPSec con il nome `my_policy`: +``` +bluemix vpn ipsec-create my_policy -g my_gateway +``` + + +## bluemix vpn gateway-create +Crea un gateway VPN. + +``` +bluemix vpn gateway-create GATEWAY_NAME -t TYPE [-gateway_ip IP_ADDRESS] [-subnets SUBNET_ADDRESS] +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_GATEWAY* (obbligatorio): il nome del gateway. + +-t *TIPO* (obbligatorio): contenitori per i quali vuoi abilitare il servizio. I valori validi sono `allSingleContainers`, `allContainerGroups` o `allContainers`. Nessun valore predefinito; devi specificare un tipo. + +-gateway_ip *INDIRIZZO_IP* (facoltativo); l'indirizzo IP del gateway. + +-subnets *INDIRIZZO_SOTTORETE* (facoltativo): l'indirizzo di sottorete in formato CIDR. + +**Esempi**: + +Crea un gateway con il nome `my_gateway` e il tipo `allContainerGroups`: +``` +bluemix vpn gateway-create my_gateway -t allContainerGroups +``` + + +## bluemix vpn connections +Visualizza le informazioni su tutte le connessioni correnti. + +``` +bluemix vpn connections +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + + +## bluemix vpn ikes +Visualizza le informazioni sulle connessioni IKE correnti. + +``` +bluemix vpn ikes +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + + +## bluemix vpn ipsecs +Visualizza le informazioni sulle connessioni IPSec correnti. + +``` +bluemix vpn ipsecs +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + + +## bluemix vpn gateways +Visualizza le informazioni sui gateway correnti. + +``` +bluemix vpn gateways +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + + +## bluemix vpn connection +Visualizza tutte le informazioni su una specifica connessione. + +``` +bluemix vpn connection NOME_CONNESSIONE +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_CONNESSIONE*  (obbligatorio): il nome della connessione da visualizzare. + + +## bluemix vpn ike +Visualizza le informazioni su una connessione IKE. + +``` +bluemix vpn ike NOME_POLITICA +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_POLITICA* (obbligatorio): il nome della politica IKE da visualizzare. + + +## bluemix vpn ipsec +Visualizza le informazioni su una connessione IPSec. + +``` +bluemix vpn ipsec NOME_POLITICA +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_POLITICA* (obbligatorio): il nome della politica IPSec da visualizzare. + + +## bluemix vpn gateway +Visualizza le informazioni di connessione relative a un gateway. + +``` +bluemix vpn gateway NOME_GATEWAY +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_GATEWAY*  (obbligatorio): il nome del gateway da visualizzare. + + +## bluemix vpn connection-delete +Elimina una connessione esistente. + +``` +bluemix vpn connection-delete NOME_CONNESSIONE +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_CONNESSIONE*  (obbligatorio): il nome della connessione da eliminare. + + +## bluemix vpn ike-delete +Elimina una politica IKE esistente. + +``` +bluemix vpn ike-delete NOME_POLITICA +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_POLITICA* (obbligatorio): il nome della politica IKE da eliminare. + + +## bluemix vpn ipsec-delete +Elimina una politica IPSec esistente. + +``` +bluemix vpn ipsec-delete NOME_POLITICA +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_POLITICA* (obbligatorio): il nome della politica IPSec da eliminare. + + +## bluemix vpn gateway-delete +Elimina un gateway esistente. + +``` +bluemix vpn gateway-delete NOME_GATEWAY +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_GATEWAY*  (obbligatorio): il nome del gateway da eliminare. + + +## bluemix vpn connection-update +Aggiorna una connessione VPN esistente. + +``` +bluemix vpn connection-update CONNECTION_NAME [-g GATEWAY_NAME] [-k PRESHARED_KEY] [-subnets "SUBNET/MASK"] [-cip CUSTOMER_GATEWAY_IP_ADDRESS] [-d DESCRIPTION] [-peer_id PEER_ID] [-admin_state ADMIN_STATE] [-dpd-action ACTION] [-gateway_ip IP_ADDRESS] [-i INITIATOR_STATE] [-dpd-timeout VALUE] [-dpd-interval VALUE] [-ike NAME] [-ipsec NAME] +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_CONNESSIONE*  (obbligatorio): il nome della connessione. + +-g *NOME_GATEWAY* (facoltativo): il nome del gateway. + +-k *CHIAVE_PRECONDIVISA* (facoltativo): la chiave precondivisa. + +-subnets "*SOTTORETE*/*MASCHERA*" (facoltativo): l'indirizzo di sottorete in formato CIDR. + +-cip *INDIRIZZO_IP_GATEWAY_CLIENTE* (facoltativo): l'indirizzo IP dell'endpoint remoto del tunnel VPN. + +-d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. + +-peer_id *ID_PEER* (facoltativo): l'ID del peer remoto. Altro endpoint del tunnel VPN. + +-admin_state *STATO_AMMINISTRAZIONE* (facoltativo): lo stato della connessione VPN. I valori validi sono `UP` o `DOWN`. + +-dpd-action *AZIONE* (facoltativo): l'azione da eseguire quando viene rilevato che il peer è inattivo. I valori validi sono `hold`, `clear`, `disabled`, `restart` o `restart-by-peer`. + +-gateway_ip *INDIRIZZO_IP* (facoltativo): l'indirizzo IP dell'endpoint del tunnel VPN locale. + +-i *STATO_INIZIATORE* (facoltativo): lo stato dell'iniziatore. + +-dpd-timeout *VALORE* (facoltativo): il valore di timeout, espresso in secondi, dopo il quale la sessione viene terminata. Intervallo: 6 - 86400 secondi. + +-dpd-interval *VALORE* (facoltativo): l'intervallo keepalive, in secondi. Invia dei messaggi keepalive all'intervallo configurato per verificare lo stato di attività del peer. Intervallo: 5-86399 secondi. + +-ike *NOME* (facoltativo): il nome della politica IKE. + +-ipsec *NOME* (facoltativo): il nome della politica IPSec. + + +## bluemix vpn ike-update +Aggiorna una politica IKE. + +``` +bluemix vpn ike-update POLICY_NAME [-g GATEWAY_NAME] [-d DESCRIPTION] [-pfs GROUP] [-e ENCRYPTION_ALGORITHM] [-lv LIFETIME_VALUE] +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_POLITICA*  (obbligatorio): il nome della politica IKE. + +-g *NOME_GATEWAY* (facoltativo): il nome del gateway. + +-d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. + +-pfs *GRUPPO* (facoltativo): l'identificativo del gruppo DH (Diffie-Hellman). I valori validi sono `Group2`, `Group5` o `Group14`. + +-e *ALGORITMO_DI_CRITTOGRAFIA* (facoltativo): l'algoritmo di crittografia. I valori validi sono `aes-128`, `aes-192`, `aes-256` o `3des`. + +-lv *VALORE_DURATA* (facoltativo): il valore di durata dell'associazione di sicurezza IKE. Intervallo: 60 - 86400 secondi. + + +## bluemix vpn ipsec-update +Aggiorna una politica IPSec. + +``` +bluemix vpn ipsec-update POLICY_NAME [-g GATEWAY_NAME] [-d DESCRIPTION] [-pfs GROUP] [-e ENCRYPTION_ALGORITHM] [-lv LIFETIME_VALUE] +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_POLITICA*  (obbligatorio): il nome della politica IPSec. + +-g *NOME_GATEWAY* (facoltativo): il nome del gateway. + +-d *DESCRIZIONE* (facoltativo): la descrizione dei parametri specificati. + +-pfs *GRUPPO* (facoltativo): l'identificativo del gruppo DH (Diffie-Hellman). I valori validi sono `Group2`, `Group5` o `Group14`. + +-e *ALGORITMO_DI_CRITTOGRAFIA* (facoltativo): l'algoritmo di crittografia. I valori validi sono `aes-128`, `aes-192`, `aes-256` o `3des`. + +-lv *VALORE_DURATA* (facoltativo): il valore di durata dell'associazione di sicurezza. Intervallo: 60 - 86400 secondi. + + +## bluemix vpn gateway-update +Aggiorna un gateway VPN esistente. + +``` +bluemix vpn gateway-update GATEWAY_NAME [-t TYPE] [-gateway_ip IP_ADDRESS] [-subnets SUBNET_ADDRESS] +``` + +**Prerequisiti**: Endpoint, Accesso, Destinazione + +**Opzioni del comando**: + +*NOME_GATEWAY* (obbligatorio): il nome del gateway. + +-t *TIPO* (facoltativo): contenitori per i quali vuoi abilitare il servizio. I valori validi sono `allSingleContainers`, `allContainerGroups` o `allContainers`. + +-gateway_ip *INDIRIZZO_IP* (facoltativo); l'indirizzo IP del gateway. + +-subnets *INDIRIZZO_SOTTORETE* (facoltativo): l'indirizzo di sottorete in formato CIDR. diff --git a/cli/nl/it/plugins/dev_mode/index.md b/cli/nl/it/plugins/dev_mode/index.md index 4058944d0..45e3809a0 100644 --- a/cli/nl/it/plugins/dev_mode/index.md +++ b/cli/nl/it/plugins/dev_mode/index.md @@ -1,213 +1,213 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2017-01-12" - - - ---- - -{:codeblock: .codeblock} -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# (Obsoleto) CLI modalità di sviluppo -{: #devmodecli} - -**Questa CLI è obsoleta:** invece di utilizzare la CLI modalità di sviluppo (dev_mode), utilizza IBM Eclipse Tools for Bluemix o DevOps Web IDE. Puoi continuare a utilizzare la CLI dev_mode fino al 30 giugno 2016. - -Con l'interfaccia riga di comando in modalità di sviluppo di Bluemix (CLI dev_mode), puoi aggiornare le tue applicazioni mentre sono in esecuzione nel cloud. La CLI dev_mode è stata messa a punto come un plug-in CLI cf e supporta sia applicazioni Node.js IBM sia Liberty. -{: shortdesc} - - -Puoi eseguire le seguenti attività con la CLI dev_mode: -- Alterna la tua applicazione tra la modalità sviluppo e quella normale. -- Aggiorna i file applicazione in modo incrementale senza una nuova distribuzione. -- Avvia, arresta o riavvia la tua applicazione nel contenitore esistente. - -## Installazione del plug-in dev_mode -**Prerequisito:** prima di iniziare, installa la CLI Cloud Foundry. Vedi [Inizia a codificare con l'interfaccia riga di comando Cloud Foundry](https://github.com/cloudfoundry/cli) per i dettagli. - - -Utilizza uno dei seguenti metodi per installare lo strumento riga di comando dev_mode: -- Installa in locale. - 1. Scarica il plug-in dev_mode per la tua piattaforma da [IBM Bluemix CLI Plugin Repository](http://plugins.ng.bluemix.net). - 2. Passa alla cartella di salvataggio del plug-in dev_mode e installalo utilizzando il comando cf install-plugin. Per esempio: - - ``` - cf install-plugin dev_mode-linux64 - ``` - -- Installa dal repository CLI Bluemix. - 1. Aggiungi il repository bluemix-repo nel repository CLI Cloud Foundry utilizzando il seguente comando: - - ``` - cf add-plugin-repo bluemix-repo http://plugins.ng.bluemix.net - ``` - - 2. Immetti cf repo-plugins. Il plug-in dev_mode viene visualizzato nel repository bluemix-repo. - - ``` - cf repo-plugins - ``` - - 3. Installa il plug-in dev_mode nei plug-in CLI Cloud Foundry utilizzando il seguente comando: - - ``` - cf install-plugin dev_mode -r bluemix-repo - ``` - -## Visualizzazione dei comandi dev_mode - -Per visualizzare tutti i comandi della CLI dev_mode, utilizza il seguente comando: - -``` -cf plugins -``` - -## dev_mode CLI commands index -{: #dev_mode_cmds_index} - -Utilizza l'indice nella seguente tabella in modo che faccia riferimento ai comandi CLI dev_mode utilizzati più frequentemente: - - - - - - - - - - - - - - - - - - - - -
Tabella 1. Comandi dev_mode
Comandi dev_mode
[help](#help)[mode](#mode)[status](#status)[update-file](#update_file)
[delete-file](#delete_file)[start-inplace](#start_inplace)[stop-inplace](#stop_inplace)[restart-inplace](#restart_inplace)
- - -## help -{: #help} - -Visualizza la guida relativa a un comando. - -``` -cf help -``` - - -## mode -{: #mode} - -Modifica la modalità dell'applicazione. - -``` -cf mode -``` -Opzioni del comando: - -
-
dev
-
Modalità di sviluppo.
-
normal
-
Modalità di produzione.
-
- - -## status -{: #status} - -Visualizza la modalità dell'applicazione e lo stato del runtime. -``` -cf status -``` - - - -## update-file -{: #update_file} - -Aggiorna i file applicazione nel cloud. - -``` -cf update-file [opzioni_comando] -``` - - -Opzioni del comando: - -
-
expand
-
Indica se i file caricati devono essere estratti dal file zip.
-
restart
-
Riavvia il runtime dell'applicazione dopo che i file sono stati aggiornati.
-
- - - -## delete-file -{: #delete_file} - -Elimina i file applicazione nel cloud. - -``` -cf delete-file [opzioni_comando] -``` - - -Opzioni del comando: -
-
restart
-
Riavvia il runtime dell'applicazione dopo che i file sono stati aggiornati.
-
- - -## start-inplace -{: #start_inplace} -Avvia l'applicazione nel contenitore esistente. - -``` -cf start-inplace -``` - - - -## stop-inplace -{: #stop_inplace} -Arresta l'applicazione nel contenitore esistente. - -``` -cf stop-inplace -``` - - - -## restart-inplace -{: #restart_inplace} - -Riavvia l'applicazione nel contenitore esistente. - -``` -cf restart-inplace -``` - - - -# Link correlati -{: #rellinks} - -## Link correlati -{: #general} -* [CLI modalità di sviluppo ![icona link esterno](../../../icons/launch-glyph.svg)](http://clis.ng.bluemix.net/ui/repository.html#cf-plugins){:new_window} -* [IDE web DevOps ![icona link esterno](../../../icons/launch-glyph.svg)](https://hub.jazz.net/docs/deploy/){:new_window} +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2017-01-12" + + + +--- + +{:codeblock: .codeblock} +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# (Obsoleto) CLI modalità di sviluppo +{: #devmodecli} + +**Questa CLI è obsoleta:** invece di utilizzare la CLI modalità di sviluppo (dev_mode), utilizza IBM Eclipse Tools for Bluemix o DevOps Web IDE. Puoi continuare a utilizzare la CLI dev_mode fino al 30 giugno 2016. + +Con l'interfaccia riga di comando in modalità di sviluppo di Bluemix (CLI dev_mode), puoi aggiornare le tue applicazioni mentre sono in esecuzione nel cloud. La CLI dev_mode è stata messa a punto come un plug-in CLI cf e supporta sia applicazioni Node.js IBM sia Liberty. +{: shortdesc} + + +Puoi eseguire le seguenti attività con la CLI dev_mode: +- Alterna la tua applicazione tra la modalità sviluppo e quella normale. +- Aggiorna i file applicazione in modo incrementale senza una nuova distribuzione. +- Avvia, arresta o riavvia la tua applicazione nel contenitore esistente. + +## Installazione del plug-in dev_mode +**Prerequisito:** prima di iniziare, installa la CLI Cloud Foundry. Vedi [Inizia a codificare con l'interfaccia riga di comando Cloud Foundry](https://github.com/cloudfoundry/cli) per i dettagli. + + +Utilizza uno dei seguenti metodi per installare lo strumento riga di comando dev_mode: +- Installa in locale. + 1. Scarica il plug-in dev_mode per la tua piattaforma da [IBM Bluemix CLI Plugin Repository](http://plugins.ng.bluemix.net). + 2. Passa alla cartella di salvataggio del plug-in dev_mode e installalo utilizzando il comando cf install-plugin. Per esempio: + + ``` + cf install-plugin dev_mode-linux64 + ``` + +- Installa dal repository CLI Bluemix. + 1. Aggiungi il repository bluemix-repo nel repository CLI Cloud Foundry utilizzando il seguente comando: + + ``` + cf add-plugin-repo bluemix-repo http://plugins.ng.bluemix.net + ``` + + 2. Immetti cf repo-plugins. Il plug-in dev_mode viene visualizzato nel repository bluemix-repo. + + ``` + cf repo-plugins + ``` + + 3. Installa il plug-in dev_mode nei plug-in CLI Cloud Foundry utilizzando il seguente comando: + + ``` + cf install-plugin dev_mode -r bluemix-repo + ``` + +## Visualizzazione dei comandi dev_mode + +Per visualizzare tutti i comandi della CLI dev_mode, utilizza il seguente comando: + +``` +cf plugins +``` + +## dev_mode CLI commands index +{: #dev_mode_cmds_index} + +Utilizza l'indice nella seguente tabella in modo che faccia riferimento ai comandi CLI dev_mode utilizzati più frequentemente: + + + + + + + + + + + + + + + + + + + + +
Tabella 1. Comandi dev_mode
Comandi dev_mode
[help](#help)[mode](#mode)[status](#status)[update-file](#update_file)
[delete-file](#delete_file)[start-inplace](#start_inplace)[stop-inplace](#stop_inplace)[restart-inplace](#restart_inplace)
+ + +## help +{: #help} + +Visualizza la guida relativa a un comando. + +``` +cf help +``` + + +## mode +{: #mode} + +Modifica la modalità dell'applicazione. + +``` +cf mode +``` +Opzioni del comando: + +
+
dev
+
Modalità di sviluppo.
+
normal
+
Modalità di produzione.
+
+ + +## status +{: #status} + +Visualizza la modalità dell'applicazione e lo stato del runtime. +``` +cf status +``` + + + +## update-file +{: #update_file} + +Aggiorna i file applicazione nel cloud. + +``` +cf update-file [opzioni_comando] +``` + + +Opzioni del comando: + +
+
expand
+
Indica se i file caricati devono essere estratti dal file zip.
+
restart
+
Riavvia il runtime dell'applicazione dopo che i file sono stati aggiornati.
+
+ + + +## delete-file +{: #delete_file} + +Elimina i file applicazione nel cloud. + +``` +cf delete-file [opzioni_comando] +``` + + +Opzioni del comando: +
+
restart
+
Riavvia il runtime dell'applicazione dopo che i file sono stati aggiornati.
+
+ + +## start-inplace +{: #start_inplace} +Avvia l'applicazione nel contenitore esistente. + +``` +cf start-inplace +``` + + + +## stop-inplace +{: #stop_inplace} +Arresta l'applicazione nel contenitore esistente. + +``` +cf stop-inplace +``` + + + +## restart-inplace +{: #restart_inplace} + +Riavvia l'applicazione nel contenitore esistente. + +``` +cf restart-inplace +``` + + + +# Link correlati +{: #rellinks} + +## Link correlati +{: #general} +* [CLI modalità di sviluppo ![icona link esterno](../../../icons/launch-glyph.svg)](http://clis.ng.bluemix.net/ui/repository.html#cf-plugins){:new_window} +* [IDE web DevOps ![icona link esterno](../../../icons/launch-glyph.svg)](https://hub.jazz.net/docs/deploy/){:new_window} diff --git a/cli/nl/it/plugins/pnp/index.md b/cli/nl/it/plugins/pnp/index.md index 7fcbef349..23a6e8db6 100644 --- a/cli/nl/it/plugins/pnp/index.md +++ b/cli/nl/it/plugins/pnp/index.md @@ -98,12 +98,12 @@ Per visualizzare le informazioni di guida per i comandi, esegui: `bluemix networ bluemix network pnp-routers [--verbose (or -v)] ``` -#####Parametri facoltativi +##### Parametri facoltativi {: #op1} * **--verbose (or -v)** (indicatore): visualizza le informazioni di rete dettagliate relative a ciascun router. -######Esempio di comando +###### Esempio di comando {: #ex1} Per visualizzare le informazioni di rete per tutti i router: @@ -153,13 +153,13 @@ Per visualizzare informazioni di rete dettagliate per tutti i router: bluemix network pnp-create ``` -#####Parametri +##### Parametri {: #p1} * **ip_router**: gli indirizzi IP dei due router che vuoi connettere. Puoi trovare gli indirizzi IP utilizzando il seguente comando: `bluemix network pnp-routers` * **nome**: il nome della connessione peering della rete privata. -######Esempio di comando +###### Esempio di comando {: #ex2} $ bluemix network pnp-create 129.41.234.246 129.41.237.172 demo @@ -170,19 +170,19 @@ bluemix network pnp-create Private network peering connection 'demo' created. -####Crea una connessione peering della rete privata utilizzando il nome della connessione +#### Crea una connessione peering della rete privata utilizzando il nome della connessione ``` bluemix network pnp-create -i ``` -#####Parametri +##### Parametri {: #p2} * **--interactive (-i)** (indicatore): modalità interattiva per selezionare i router. * **nome**: il nome della connessione peering della rete privata. -######Esempio di comando +###### Esempio di comando {: #ex3} $ bluemix network pnp-create -i demo @@ -208,12 +208,12 @@ bluemix network pnp-create -i bluemix network pnp-show [--verbose (or -v)] ``` -#####Parametri facoltativi +##### Parametri facoltativi {: #op2} * **--verbose (or -v)** (indicatore): visualizza le informazioni di rete dettagliate relative a ciascun router. -######Esempio di comando +###### Esempio di comando {: #ex4} Visualizza informazioni di base: @@ -247,16 +247,16 @@ Visualizza informazioni dettagliate: ``` bluemix network pnp-delete [--force (or -f)] ``` -#####Parametri +##### Parametri {: #p3} * **id_connessione**: uno o più ID di connessione separati da una virgola. -#####Parametri facoltativi +##### Parametri facoltativi {: #op3} * **--force (or -f)** (indicatore): elimina la connessione senza richiedere una conferma. -######Esempio di comando: +###### Esempio di comando: {: #ex5} Elimina una connessione: diff --git a/cli/nl/it/reference/bluemix_cli/index.md b/cli/nl/it/reference/bluemix_cli/index.md index 1cd22d09b..5472d090c 100644 --- a/cli/nl/it/reference/bluemix_cli/index.md +++ b/cli/nl/it/reference/bluemix_cli/index.md @@ -1,3609 +1,3609 @@ ---- - - - -copyright: - - years: 2015, 2017 -lastupdated: "2017-02-16" - ---- - - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Introduzione alla CLI {{site.data.keyword.Bluemix_notm}} -{: #getting-started} - -La CLI {{site.data.keyword.Bluemix_notm}} ti fornisce un modo unico di interagire con le tue applicazioni, server virtuali, contenitori e altri servizi utilizzando un'interfaccia riga di comando. La CLI {{site.data.keyword.Bluemix_notm}} integra inoltre gli strumenti della community, come le CLI Cloud Foundry, Docker e OpenStack e inizializza le impostazioni dell'ambiente per interagire con diversi tipi di calcolo. - -**Restrizione**: la CLI {{site.data.keyword.Bluemix_notm}} non è supportata da Cygwin, per cui non utilizzare la CLI {{site.data.keyword.Bluemix_notm}} nella finestra della riga di comando di Cygwin. - -**Nota**: se la tua rete contiene un server proxy HTTP tra l'host che esegue la CLI e {{site.data.keyword.Bluemix_notm}}, devi specificare il nome host o l'indirizzo IP del server proxy nella variabile di ambiente HTTP_PROXY. - -## Installazione della CLI {{site.data.keyword.Bluemix_notm}} -{: #install_bluemix_cli} - -Prima di installare la CLI {{site.data.keyword.Bluemix_notm}}, installa la [CLI cf ![icona link esterno](../../../icons/launch-glyph.svg)](https://github.com/cloudfoundry/cli/releases){: new_window}. - -Per Mac OS e Windows, scarica il [pacchetto CLI {{site.data.keyword.Bluemix_notm}}](/docs/cli/index.html#downloads) ed esegui il programma di installazione. - -Per Linux, segui la seguente procedura: - - 1. Scarica il pacchetto ed estrailo. Ad -esempio: - - ``` - ~$ tar -xvf Bluemix_CLI.tar.gz - Bluemix_CLI/ - Bluemix_CLI/update_global_config - Bluemix_CLI/install_bluemix_cli - Bluemix_CLI/bx/ - Bluemix_CLI/bx/bash_autocomplete - Bluemix_CLI/bx/zsh_autocomplete - Bluemix_CLI/bin/ - Bluemix_CLI/bin/bluemix - ~$ - ``` - - 2. Passa alla directory `Bluemix_CLI` ed esegui il comando `./install_bluemix_cli` con l'autorizzazione root. Puoi eseguire il comando come utente root o utilizzare il comando `sudo` per ottenere l'autorizzazione root. Ad -esempio: - - ``` - ~# cd Bluemix_CLI - ~/Bluemix_CLI# sudo ./install_bluemix_cli - Superuser privileges are required to run this script. - The Cloud Foundry CLI version 6.15 is already installed. - Copying files... - The Bluemix CLI installed successfully. To get started, open a new Linux terminal and enter "bluemix help", or enter "bx help" as short name. - ~/Bluemix_CLI# - ``` - -Puoi ora iniziare a utilizzare la CLI {{site.data.keyword.Bluemix_notm}} o installare ulteriori plug-in. - -## Installazione di un plugin -{: #install_plug-in} - -Come la CLI Cloud Foundry, la CLI {{site.data.keyword.Bluemix_notm}} supporta un framework di estensione plug-in per integrare altri comandi oltre a quelli già integrati. - -Per installare un plugin dal tuo ambiente locale, completa la seguente procedura: - - 1. Scarica il plug-in. Ad -esempio: - - ``` - ~$ wget http://public.dhe.ibm.com/cloud/bluemix/cli/bluemix-plugins/auto-scaling-darwin-amd64.0.2.2--2016-02-18 14:02:12-- http://public.dhe.ibm.com/cloud/bluemix/cli/bluemix-plugins/auto-scaling-darwin-amd64.0.2.2 - Resolving public.dhe.ibm.com... 9.17.248.112 - Connection to public.dhe.ibm.com|9.17.248.112|:80... connected. - HTTP request sent, awaiting response... 200 OK - Length: 9857792 (9.4M) [text/plain] - Saving to: 'auto-scaling-darwin-amd64-0.2.2' - - auto-scaling-darwin-0.2.2 100%[===================>] 9.40M 518KB/s in 22s - - 2016-02-18 14:02:34 (443 KB/s) - `auto-scaling-darwin-amd64-0.2.2' saved [9857792/9857792] - ``` - - 2. Per un sistema simile a Unix, devi rendere eseguibile il file scaricato utilizzando il comando `chmod`. Ad -esempio: - - ``` - ~$ sudo chmod 755 auto-scaling-darwin-amd64-0.2.2 - Password: - ~$ - ``` - - 3. Installa il plug-in utilizzando il comando `bluemix plugin install`. Ad -esempio: - - ``` - ~$ bluemix plugin install ./auto-scaling-darwin-amd64-0.2.2 - Installing pluign './auto-scaling-darwin-amd64-0.2.2'... - OK - Plugin 'auto-scaling 0.2.2' was successfully installed. - ~$ - ``` - -Per l'installazione da un server remoto, attieniti alla seguente procedura: - - 1. Installa il plug-in da un URL remoto direttamente utilizzando il comando `bluemix plugin install`. Ad -esempio: - - ``` - ~$ bluemix plugin install http://public.dhe.ibm.com/cloud/bluemix/cli/bluemix-plugins/auto-scaling-darwin-amd64-0.2.2 - Attempting to download the binary file... - 9857792 bytes downloaded - Installing plugin '/var/folder/v7/l3hnkz0x0b9b5mf1fyxh7yw00000gn/T/BluemixFileDownload274645142/auto-scaling-darwin-adm64-0.2.2'... - OK - Plugin 'auto-scaling 0.2.2' was successfully installed. - ~$ - ``` - -Puoi inoltre installare un plugin dal repository. {{site.data.keyword.Bluemix_notm}} dispone di repository che ospitano i plugin della CLI {{site.data.keyword.Bluemix_notm}} e plugin della CLI Cloud Foundry: - - * [Repository di plug-in CLI Cloud Foundry ](http://clis.ng.bluemix.net/ui/repository.html#cf-plugins){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg), che contiene i plug-in per la CLI di Cloud Foundry. - * [Repository di plug-in CLI {{site.data.keyword.Bluemix_notm}}](http://clis.ng.bluemix.net/ui/repository.html#bluemix-plugins){: new_window} ![Icona link esterno](../../../icons/launch-glyph.svg), che contiene i plug-in specifici per la CLI {{site.data.keyword.Bluemix_notm}}. - -Per l'installazione da un repository, attieniti alla seguente procedura: - - 1. Trova il plug-in nel repository. Dopo aver installato la CLI {{site.data.keyword.Bluemix_notm}}, il repository ufficiale `Bluemix` viene aggiunto per impostazione predefinita. Puoi elencare i plugin nel repository `Bluemix` utilizzando il comando `bluemix plugin repo-plugins`. Ad -esempio: - - ``` - ~$ bluemix plugin repo-plugins -r Bluemix - Getting plug-ins from repository 'Bluemix'... - - Repository: Bluemix - Name Description Versions - auto-scaling Bluemix CLI plugin for Auto-Scaling service 0.2.1, 0.2.2 - nsg Bluemix Network Security Group plugin 0.1.1 - - ~$ - ``` - - 2. Installa il plug-in dal repository `Bluemix` utilizzando il comando `bluemix plugin install`. Ad -esempio: - - ``` - ~$ bluemix plugin install auto-scaling -r Bluemix - Looking up 'auto-scaling' from repository 'Bluemix'... - 9857792 bytes downloaded - Installing plugin '/var/folder/v7/l3hnkz0x0b9b5mf1fyxh7yw00000gn/T/BluemixFileDownload062468676/auto-scaling-darwin-adm64-0.2.2'... - OK - Plugin 'auto-scaling 0.2.2' was successfully installed. - ~$ - ``` - -## Accesso alla CLI {{site.data.keyword.Bluemix_notm}} -{: #log_bmcli} - -Dopo aver installato la CLI {{site.data.keyword.Bluemix_notm}}, puoi accedere a {{site.data.keyword.Bluemix_notm}} utilizzando il tuo ID IBM e password. Ad -esempio: - -``` -~$ bluemix login -a https://api.ng.bluemix.net -API endpoint: https://api.ng.bluemix.net - -Email> demo_user@foo.com - -Password> -Authenticating... -OK -``` - -Sei ora pronto a utilizzare i comandi integrati di {{site.data.keyword.Bluemix_notm}}. Ad esempio, esegui il comando `bluemix catalog templates` per elencare tutti i template di contenitore tipo {{site.data.keyword.Bluemix_notm}} disponibili: - -``` -~$ bluemix catalog templates -Listing Bluemix boilerplate templates... - -ID Name -pi-wdc-java-starter Personality Insights Java Web Starter -xpages-starter XPages Web Starter -mobileBackendStarter Mobile Cloud -pi-wdc-nodejs-starter Personality Insights Node.js Web Starter -mobileFirstPlatform MobileFirst Services Starter -xspHelloWorld IBM XPages -javacloudantbp Java Cloudant Web Starter -``` - -# Comandi {{site.data.keyword.Bluemix_notm}} (bx) -{: #bluemix_cli} - -Versione: 0.4.6 - -L'interfaccia di riga comando (CLI) {{site.data.keyword.Bluemix_notm}} fornisce una serie di comandi che vengono raggruppati in base allo spazio dei nomi per consentire agli utenti di interagire con {{site.data.keyword.Bluemix_notm}}. Alcuni comandi {{site.data.keyword.Bluemix_notm}} incapsulano comandi cf esistenti, mentre altri forniscono funzionalità estese agli utenti {{site.data.keyword.Bluemix_notm}}. Le seguenti informazioni elencano i comandi supportati dalla CLI {{site.data.keyword.Bluemix_notm}} e includono i relativi nomi, opzioni, utilizzo, prerequisiti, descrizioni ed esempi. -{:shortdesc} - -**Nota:** i *Prerequisiti* elencano quali azioni sono richieste prima di utilizzare il comando. I comandi che non hanno azioni prerequisite elencano **Nessuno**. Altrimenti, i prerequisiti possono includere una o più delle seguenti azioni: - -
-
Endpoint
-
Un endpoint API deve essere impostato mediante bluemix api prima di utilizzare il comando.
-
Accesso
-
L'accesso utilizzando il comando bluemix login è richiesto prima di utilizzare questo comando. Se stai eseguendo l'accesso con l'ID federato, utilizza l'opzione '--sso' per autenticarti con il passcode temporale.
-
Destinazione
-
Il comando bluemix target deve essere utilizzato per impostare un'organizzazione e uno spazio prima di utilizzare questo comando.
-
Docker
-
Per poter eseguire questo comando, è necessario che la CLI Docker (docker) sia installata.
-
- -## indice comandi bluemix -{: #bx_commands_index} - -Utilizza gli indici delle seguenti tabelle per fare riferimento ai comandi bluemix più utilizzati. - -**Nota:** puoi utilizzare il formato breve dei comandi bluemix; ad esempio `bx api` è l'abbreviazione di `bluemix api`. - - - - - - - - - - - - - - - - - - - - - -
Tabella 1. Comandi bluemix generali
Comandi bluemix generali
[bluemix help](index.html#bluemix_help)[bluemix api](index.html#bluemix_api)[bluemix_login](index.html#bluemix_login)[bluemix logout](index.html#bluemix_logout)[bluemix target](index.html#bluemix_target)
[bluemix info](index.html#bluemix_info) [bluemix config](index.html#bluemix_config)[bluemix curl](index.html#bluemix_curl)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Tabella 2. Comandi per la gestione di organizzazioni, spazi e utenti
Comandi per la gestione di organizzazioni, spazi e utenti
[bluemix iam orgs](index.html#bluemix_iam_orgs)[bluemix iam org](index.html#bluemix_iam_org)[bluemix iam org-create](index.html#bluemix_iam_org_create)[bluemix iam org-replicate](index.html#bluemix_iam_org_replicate)[bluemix iam org-rename](index.html#bluemix_iam_org_rename)
[bluemix iam org-delete](index.html#bluemix_iam_org_delete)[bluemix iam spaces](index.html#bluemix_iam_spaces)[bluemix iam space](index.html#bluemix_iam_space)[bluemix iam space-create](index.html#bluemix_iam_space_create)[bluemix iam space-rename](index.html#bluemix_iam_space_rename)
[bluemix iam space-delete](index.html#bluemix_iam_space_delete)[bluemix iam account-users](index.html#bluemix_iam_account_users)[bluemix iam account-users-delete](index.html#bluemix_iam_account_users_delete)[bluemix iam account-user-invite](index.html#bluemix_iam_account_user_invite)[bluemix iam account-user-reinvite](index.html#bluemix_iam_account_user_reinvite)[bluemix iam org-users](index.html#bluemix_iam_org_users)
[bluemix iam org-user-add](index.html#bluemix_iam_org_user_add)[bluemix iam org-user-remove](index.html#bluemix_iam_org_user_remove)[bluemix iam org-role-set](index.html#bluemix_iam_org_role_set)[bluemix iam org-role-unset](index.html#bluemix_iam_org_role_unset)[bluemix iam space-users](index.html#bluemix_iam_space_users)[bluemix iam space-role-set](index.html#bluemix_iam_space_role_set)
[bluemix iam space-role-unset](index.html#bluemix_iam_space_role_unset)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Tabella 3. Comandi per la gestione di applicazioni cf
Comandi per la gestione di applicazioni cf
[bluemix app push](index.html#bluemix_app_push)[bluemix app list](index.html#bluemix_app_list)[bluemix app show](index.html#bluemix_app_show)[bluemix app scale](index.html#bluemix_app_scale)[bluemix app delete](index.html#bluemix_app_delete)
[bluemix app rename](index.html#bluemix_app_rename)[bluemix app start](index.html#bluemix_app_start)[bluemix app stop](index.html#bluemix_app_stop)[bluemix app restart](index.html#bluemix_app_restart)[bluemix app restage](index.html#bluemix_app_restage)
[bluemix app instance-restart](index.html#bluemix_app_instance_restart)[bluemix app events](index.html#bluemix_app_events)[bluemix app files](index.html#bluemix_app_files)[bluemix app logs](index.html#bluemix_app_logs)[bluemix app env](index.html#bluemix_app_env)
[bluemix app env-set](index.html#bluemix_app_env_set)[bluemix app env-unset](index.html#bluemix_app_env_unset)[bluemix app stacks](index.html#bluemix_app_stacks)[bluemix app stack](index.html#bluemix_app_stack)[bluemix app manifest-create](index.html#bluemix_app_manifest_create)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Tabella 4. Comandi per la gestione dei servizi Bluemix
Comandi per la gestione dei servizi Bluemix
[bluemix service offerings](index.html#bluemix_service_offerings)[bluemix service list](index.html#bluemix_service_list)[bluemix service show](index.html#bluemix_service_show)[bluemix service create](index.html#bluemix_service_create)[bluemix service update](index.html#bluemix_service_update)
[bluemix service delete](index.html#bluemix_service_delete)[bluemix service rename](index.html#bluemix_service_rename)[bluemix service bind](index.html#bluemix_service_bind)[bluemix service unbind](index.html#bluemix_service_unbind)[bluemix service key-create](index.html#bluemix_service_key_create)
[bluemix service key-delete](index.html#bluemix_service_key_delete)[bluemix service keys](index.html#bluemix_service_keys)[bluemix service key-show](index.html#bluemix_service_key_show)[bluemix service user-provided-create](index.html#bluemix_service_user_provided_create)[bluemix service user-provided-update](index.html#bluemix_service_user_provided_update)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Tabella 5. Comandi per la gestione delle impostazioni di sicurezza, dei plug-in, della fatturazione e del catalogo Bluemix
Comandi per la gestione delle impostazioni di sicurezza, dei plug-in, della fatturazione e del catalogo Bluemix
[bluemix catalog templates](index.html#bluemix_catalog_templates)[bluemix catalog template](index.html#bluemix_catalog_template)[bluemix catalog template-run](index.html#bluemix_catalog_template_run)[bluemix plugin repos](index.html#bluemix_plugin_repos)[bluemix plugin repo-add](index.html#bluemix_plugin_repo_add)
[bluemix plugin repo-remove](index.html#bluemix_plugin_repo_remove)[bluemix plugin repo-plugins](index.html#bluemix_plugin_repo_plugins)[bluemix plugin list](index.html#bluemix_plugin_list)[bluemix plugin install](index.html#bluemix_plugin_install)[bluemix plugin uninstall](index.html#bluemix_plugin_uninstall)
[bluemix bss account-usage](index.html#bluemix_bss_account_usage)[bluemix bss org-usage](index.html#bluemix_bss_org_usage)[bluemix bss orgs-usage-summary](index.html#bluemix_orgs_usage_summary)[bluemix security cert](index.html#bluemix_security_cert)[bluemix security cert-add](index.html#bluemix_security_cert_add)
[bluemix security cert-remove](index.html#bluemix_security_cert_remove)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Tabella 6. Comandi per la gestione delle impostazioni di rete
Comandi per la gestione delle impostazioni di rete
[bluemix network regions](index.html#bluemix_network_regions)[bluemix network region-set](index.html#bluemix_network_region_set)[bluemix network routes](index.html#bluemix_network_routes)[bluemix network route-check](index.html#bluemix_network_route_check)[bluemix network route-map](index.html#bluemix_network_route_map)
[bluemix network route-unmap](index.html#bluemix_network_route_unmap)[bluemix network route-create](index.html#bluemix_network_route_create)[bluemix network route-delete](index.html#bluemix_network_route_delete)[bluemix network orphaned-routes-delete](index.html#bluemix_network_orphaned_routes_delete)[bluemix network domains](index.html#bluemix_network_domains)
[bluemix network domain-create](index.html#bluemix_network_domain_create)[bluemix network domain-delete](index.html#bluemix_network_domain_delete)[bluemix network shared-domain-create](index.html#bluemix_network_shared_domain_create)[bluemix network shared-domain-delete](index.html#bluemix_network_shared_domain_delete)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Tabella 7. Comandi per la gestione dei contenitori in Bluemix
Comandi per la gestione dei contenitori in Bluemix
[bluemix ic attach](index.html#bluemix_ic_attach)[bluemix ic build](index.html#bluemix_ic_build)[bluemix ic cp](index.html#bluemix_ic_cp)[bluemix ic cpi](index.html#bluemix_ic_cpi)[bluemix ic exec](index.html#bluemix_ic_exec)
[bluemix ic group-create](index.html#bluemix_ic_group_create)[bluemix ic group-inspect](index.html#bluemix_ic_group_inspect)[bluemix ic group-instances](index.html#bluemix_ic_group_instances)[bluemix ic group-remove](index.html#bluemix_ic_group_remove)[bluemix ic group-update](index.html#bluemix_ic_group_update)
[bluemix ic groups](index.html#bluemix_ic_groups)[bluemix ic info](index.html#bluemix_ic_info)[bluemix ic init](index.html#bluemix_ic_init)[bluemix ic images](index.html#bluemix_ic_images)[bluemix ic inspect](index.html#bluemix_ic_inspect)
[bluemix ic ip-bind](index.html#bluemix_ic_ip_bind)[bluemix ic ip-release](index.html#bluemix_ic_ip_release)[bluemix ic ip-request](index.html#ip_request)[bluemix ic ip-unbind](index.html#bluemix_ic_ip_unbind)[bluemix ic ips](index.html#bluemix_ic_ips)
[bluemix ic kill](index.html#bluemix_ic_kill)[bluemix ic logs](index.html#bluemix_ic_logs)[bluemix ic namespace-get](index.html#bluemix_ic_namespace_get)[bluemix ic namespace-set](index.html#bluemix_ic_namespace_set)[bluemix ic pause](index.html#pause)
[bluemix ic port](index.html#bluemix_ic_port)[bluemix ic ps](index.html#bluemix_ic_ps)[bluemix ic rename](index.html#bluemix_ic_rename)[bluemix ic reprovision](index.html#bluemix_ic_reprovision)[bluemix ic restart](index.html#bluemix_ic_restart)
[bluemix ic rm](index.html#bluemix_ic_rm)[bluemix ic rmi](index.html#bluemix_ic_rmi)[bluemix ic route-map](index.html#bluemix_ic_route_map)[bluemix ic route-unmap](index.html#bluemix_ic_route_unmap)[bluemix ic run](index.html#bluemix_ic_run)
[bluemix ic service-bind](index.html#bluemix_ic_service-bind)[bluemix ic service-unbind](index.html#bluemix_ic_service-unbind)[bluemix ic start](index.html#ic_start)[bluemix ic stats](index.html#bluemix_ic_stats)[bluemix ic stop](index.html#ic_stop)
[bluemix ic top](index.html#bluemix_ic_top)[bluemix ic unpause](index.html#unpause)[bluemix ic unprovision](index.html#bluemix_ic_unprovision)[bluemix ic volume-inspect](index.html#bluemix_ic_volume_inspect)[bluemix ic volume-create](index.html#bluemix_ic_volume_create)
[bluemix ic volume-fs](index.html#bluemix_ic_volume_fs)[bluemix ic volume-fs-create](index.html#bluemix_ic_volume_fs_create)[bluemix ic volume-fs-remove](index.html#bluemix_ic_volume_fs_remove)[bluemix ic volume-fs-inspect](index.html#bluemix_ic_volume_fs_inspect)[bluemix ic volume-fs-flavors](index.html#bluemix_ic_volume_fs_flavors)
[bluemix ic volume-remove](index.html#bluemix_ic_volume_remove)[bluemix ic volumes](index.html#bluemix_ic_volumes)[bluemix ic wait](index.html#bluemix_ic_wait)[bluemix ic wait-status](index.html#bluemix_ic_wait_status)[bluemix ic version](index.html#bluemix_ic_version)
- - -### bluemix help -{: #bluemix_help} -Visualizzare la guida generale per i comandi integrati di primo livello e gli spazi dei nomi supportati della CLI {{site.data.keyword.Bluemix_notm}} oppure la guida per un comando o uno spazio dei nomi integrati specifici. - -``` -bluemix help [COMMAND|NAMESPACE] -``` - -Prerequisiti: Nessuno - -Opzioni del comando: - -
-
COMANDO|SPAZIO_DEI_NOMI (facoltativo)
-
Il comando o lo spazio dei nomi per cui viene visualizzata la guida. Se non viene specificata, viene visualizzata la guida generale per la CLI {{site.data.keyword.Bluemix_notm}}.
-
- - - -Esempi: - -Visualizzare la guida generale per la CLI {{site.data.keyword.Bluemix_notm}}: - -``` -bluemix help -``` - -Visualizzare la guida per il comando `info`: - -``` -bluemix help info -``` - -Visualizzare la guida per il plug-in `ic`: - -``` -bluemix help ic -``` - -o - -``` -bluemix ic help -``` - -Visualizzare la guida per il comando `group-create` sotto il plug-in `ic`: - -``` -bluemix ic help group-create -``` - - -### bluemix api -{: #bluemix_api} -Impostare o visualizzare l'endpoint API {{site.data.keyword.Bluemix_notm}}. Questo comando include il comando `cf api`. - -``` -bluemix api [API_ENDPOINT] [--unset] -``` - -Prerequisiti: Nessuno - -Opzioni del comando: -
-
ENDPOINT_API (facoltativo)
-
L'endpoint API di destinazione, ad esempio `https://api.chinabluemix.net`. Se non vengono specificate entrambe le opzioni *ENDPOINT_API* e `--unset`, viene visualizzato l'endpoint API corrente.
-
--unset (facoltativo)
-
Rimuovere l'impostazione di endpoint API.
-
-Esempi: - -Impostare l'endpoint API su api.chinabluemix.net: - -``` -bluemix api api.chinabluemix.net -``` - -Visualizzare l'endpoint API corrente: - -``` -bluemix api -``` - -Annullare l'impostazione dell'endpoint API: - -``` -bluemix api --unset -``` - - -### bluemix login -{: #bluemix_login} - -Eseguire l'accesso dell'utente. Questo comando include il comando `cf login`. Le opzioni di comando sono le stesse del comando `cf login`. - -``` -bluemix login [OPZIONI...] -``` - -Prerequisiti: Endpoint - - - -Opzioni del comando: -Per informazioni sulle opzioni supportate dal comando `login`, vedi le informazioni sull'utilizzo del comando `cf login` per i comandi cf per la gestione delle applicazioni. - -Nota: -Se stai eseguendo l'accesso con l'ID federato, utilizza l'opzione '--sso' per autenticarti con il passcode temporale. - -### bluemix logout -{: #bluemix_logout} - -Disconnettere l'utente. Questo comando include il comando `cf logout`. - -``` -bluemix logout -``` - -Prerequisiti: Nessuno - - -### bluemix target -{: #bluemix_target} - - -Impostare o visualizzare l'organizzazione o lo spazio di destinazione. Questo comando include il comando `cf target`. - -``` -bluemix target [-o ORG_NAME] [-s SPACE_NAME] -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
-o NOME_ORGANIZZAZIONE (facoltativo)
-
Il nome dell'organizzazione di destinazione.
-
-s NOME_SPAZIO (facoltativo)
-
Il nome dello spazio di destinazione.
-
-Se non viene specificata né l'opzione -o *NOME_ORGANIZZAZIONE* né quella -s *NOME_SPAZIO*, vengono visualizzati l'organizzazione e lo spazio correnti. -Esempi: - -Impostare l'organizzazione corrente su `MyOrg` e lo spazio su `MySpace`: - -``` -bluemix target -o MyOrg -s MySpace -``` - -Visualizzare l'organizzazione e lo spazio correnti: - -``` -bluemix target -``` - - -### bluemix info -{: #bluemix_info} - -Visualizzare le informazioni su {{site.data.keyword.Bluemix_notm}} di base, compresi la regione corrente, la versione controller cloud e alcuni utili endpoint, quali gli endpoint per l'accesso e per lo scambio di token di accesso. - -``` -bluemix info -``` - -Prerequisiti: Endpoint - - -### bluemix config -{: #bluemix_config} - - -Scrivere i valori predefiniti nel file di configurazione. - -``` -bluemix config --http-timeout TIMEOUT_IN_SECONDS | --trace (true|false|path/to/file) | --color (true|false) | --locale (LOCALE|CLEAR) | --check-version (true|false) -``` - -Prerequisiti: Nessuno - -Opzioni del comando: -
-
--http-timeout TIMEOUT_IN_SECONDS
-
Il valore di timeout per le richieste HTTP. Il valore predefinito è 60 secondi.
-
--trace true|false|path-to-file
-
Traccia le richieste HTTP nel terminale o file specificato.
-
--color true|false
-
Abilita o disabilita l'output a colori. L'output a colori è abilitato per impostazione predefinita.
-
--locale LOCALE|CLEAR
-
Imposta una locale predefinita. Se la LOCALE è CLEAR, la locale precedente viene eliminata.
-
--check-version true|false
-
Abilita o disabilita il controllo della versione della CLI
-
- -È possibile specificare solo una di queste opzioni alla volta. - -Esempi: - -Impostare il timeout della richiesta HTTP su 30 secondi: - -``` -bluemix config --http-timeout 30 -``` - -Abilitare l'output di traccia per le richieste HTTP: - -``` -bluemix config --trace true -``` - -Traccia le richieste HTTP in un file specificato */home/usera/my_trace*: - -``` -bluemix config --trace /home/usera/my_trace -``` - -Disabilitare l'output a colori: - -``` -bluemix config --color false -``` - -Impostare la locale su zh_Hans: - -``` -bluemix config --locale zh_Hans -``` - -Cancellare le impostazioni della locale: - -``` -bluemix config --locale CLEAR -``` - - -### bluemix curl -{: #bluemix_curl} - -Eseguire una richiesta HTTP raw per {{site.data.keyword.Bluemix_notm}}. *Content-Type* è impostato su *application/json* come valore predefinito. Questo comando invia la richiesta al MCCP (Multi Cloud Control Proxy) {{site.data.keyword.Bluemix_notm}}. Per i percorsi supportati, fai riferimento alle definizioni del percorso API nella [Documentazione API CloudFoundry ](http://apidocs.cloudfoundry.org/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg). - -``` -bluemix curl PERCORSO [OPZIONI...] -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
PERCORSO (obbligatorio)
-
Il percorso URL della risorsa. Ad esempio, /v2/apps.
-
OPZIONI (facoltativo)
-
Le opzioni supportate dal comando `bluemix curl` sono le stesse del comando `cf curl`.
-
- -Esempi: - -Visualizzare le informazioni per tutte le organizzazioni dell'account corrente: - -``` -bluemix curl /v2/organizations -``` - - -### bluemix iam orgs -{: #bluemix_iam_orgs} - -Elencare tutte le organizzazioni - -``` -bluemix iam orgs [-r REGION --guid] -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
-r REGIONE (facoltativo)
-
Regione per cui vengono visualizzare le informazioni sull'organizzazione. Se impostato su 'all', vengono elencate tutte le organizzazioni in tutte le regioni.
-
--guid (facoltativo)
-
Visualizzare il GUID delle organizzazioni.
-
- -Esempi: - -Elencare tutte le organizzazioni della regione: `us-south` con il GUID visualizzato - -``` -bluemix iam orgs -r us-south --guid -``` - -### bluemix iam org -{: #bluemix_iam_org} - -Visualizzare le informazioni per l'organizzazione specificata. - -``` -bluemix iam org ORG_NAME [--guid] -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Il nome dell'organizzazione.
-
--guid (facoltativo)
-
Visualizzare il GUID dell'organizzazione.
-
- -Esempi: - -Mostrare le informazioni dell'organizzazione `IBM` con il GUID visualizzato - -``` -bluemix iam org IBM --guid -``` - -### bluemix iam org-create -{: #bluemix_iam_org_create} - -Creare una nuova organizzazione. Questa operazione può essere eseguita solo dal proprietario dell'account. - -``` -bluemix iam org-create ORG_NAME -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Il nome dell'organizzazione in fase di creazione.
-
- -Esempi: - -Creare un'organizzazione denominata `IBM`. - -``` -bluemix iam org-create IBM -``` - - -### bluemix iam org-replicate -{: #bluemix_iam_org_replicate} - -Replicare un'organizzazione dalla regione corrente in un'altra regione. - -``` -bluemix iam org-replicate ORG_NAME REGION_NAME -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Il nome dell'organizzazione esistente che deve essere replicata.
-
NOME_REGIONE (obbligatorio)
-
Il nome della regione che ospita l'organizzazione replicata.
-
- -Esempi: - -Replicare l'organizzazione `myorg` nella regione `eu-gb`: - -``` -bluemix iam org-replicate myorg eu-gb -``` - - -### bluemix iam org-rename -{: #bluemix_iam_org_rename} - -Rinominare un'organizzazione. Questa operazione può essere eseguita solo da un gestore organizzazione. - -``` -bluemix iam org-rename OLD_ORG_NAME NEW_ORG_NAME -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
NOME_ORG_PRECEDENTE (obbligatorio)
-
Il vecchio nome dell'organizzazione da rinominare.
-
NUOVO_NOME_ORG (obbligatorio)
-
Il nuovo nome con cui viene rinominata l'organizzazione.
-
- -### bluemix iam org-delete -{: #bluemix_iam_org_delete} - -Eliminare l'organizzazione specificata nella regione corrente. - -``` -bluemix iam org-delete ORG_NAME [-f --all] -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Il nome dell'organizzazione esistente che deve essere eliminata.
-
-f (facoltativo)
-
Forzare l'eliminazione senza conferma.
-
--all (facoltativo)
-
Eliminare l'organizzazione da tutte le regioni.
-
- - -### bluemix iam spaces -{: #bluemix_iam_spaces} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf spaces`. - - -### bluemix iam space -{: #bluemix_iam_space} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf space`. - - -### bluemix iam space-create -{: #bluemix_iam_space_create} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-space`. - - -### bluemix iam space-rename -{: #bluemix_iam_space_rename} - - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf rename-space`. - - -### bluemix iam space-delete -{: #bluemix_iam_space_delete} - - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-space`. - - -### bluemix iam account-users -{: #bluemix_iam_account_users} - -Visualizza gli utenti associati con l'account. Questa operazione può essere eseguita solo dal proprietario dell'account. - -``` -bluemix iam account-users -``` - -### bluemix iam account-user-invite -{: #bluemix_iam_account_user_invite} - - -Invita un utente nell'account con un'organizzazione e un ruolo spazio già impostati. Questa operazione può essere eseguita solo dal proprietario dell'account. - -``` -bluemix iam account-user-invite USER_NAME ORG_NAME ORG_ROLE SPACE_NAME SPACE_ROLE -``` - -Prerequisiti: Endpoint, Accesso - - -Opzioni del comando: - -
-
NOME_UTENTE (obbligatorio)
-
Il nome dell'utente invitato.
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Il nome dell'organizzazione in cui viene invitato l'utente.
-
RUOLO_ORGANIZZAZIONE (obbligatorio)
-
Il nome del ruolo organizzazione in cui viene invitato l'utente. Per esempio: -
    -
  • OrgManager: questo ruolo può invitare e gestire utenti, selezionare e modificare piani e impostare limiti di spesa.
    • -
  • BillingManager: questo ruolo può creare e gestire l'account di fatturazione e le informazioni sul pagamento.
    • -
  • OrgAuditor: questo ruolo dispone di un accesso in sola lettura a report e informazioni sull'organizzazione.
    • -
-
NOME_SPAZIO (obbligatorio)
-
Il nome dello spazio in cui viene invitato l'utente.
-
RUOLO_SPAZIO (obbligatorio)
-
Il nome dello spazio in cui viene invitato l'utente. Il nome del ruolo spazio in cui viene invitato l'utente. Per esempio: -
    -
  • SpaceManager: questo ruolo può invitare e gestire utenti e attivare funzioni per un dato spazio.
    • -
  • SpaceDeveloper: questo ruolo può creare e gestire applicazioni e servizi e visualizzare log e report.
    • -
  • SpaceAuditor: questo ruolo può visualizzare log, report e impostazioni per lo spazio.
    • -
-
-
- -Esempi: - -Invitare l'utente `Mary` nell'organizzazione `IBM` con il ruolo `OrgManager` e lo spazio `Cloud` con il ruolo `SpaceAuditor`: - -``` -bluemix iam account-user-invite Mary IBM OrgManager Cloud SpaceAuditor -``` - - -### bluemix iam account-user-reinvite -{: #bluemix_iam_account_user_reinvite} - -Invia di nuovo l'invito a un utente (è richiesto il gestore organizzazione o il proprietario account) -``` - bluemix iam account-user-reinvite USER_EMAIL ORG_NAME -``` - - -### bluemix iam org-users -{: #bluemix_iam_org_users} - -Visualizzare gli utenti nell'organizzazione specificata per il ruolo. - -``` -bluemix iam org-users ORG_NAME [-a] -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Il nome dell'organizzazione.
-
-a (facoltativo)
-
Elencare tutti gli utenti dell'organizzazione specificata, non raggruppati per ruolo.
-
- -### bluemix iam org-user-add -{: #bluemix_iam_org_user_add} - -Aggiungi un utente nell'organizzazione (è richiesto il gestore organizzazione). -``` - bluemix iam org-user-add USER_NAME ORG -``` - -### bluemix iam org-user-remove -{: #bluemix_iam_org_user_remove} - -Rimuovi un utente dall'organizzazione (gestore organizzazione o solo l'utente) -``` - bluemix iam org-user-remove USER_NAME ORG [-f, --force] -``` - -Opzioni del comando: -
-
--force, -f
-
Forzare l'eliminazione senza conferma.
-
- -### bluemix iam org-role-set -{: #bluemix_iam_org_role_set} - -Assegnare un ruolo dell'organizzazione ad un utente. Questa operazione può essere eseguita solo da un gestore organizzazione. - -``` -bluemix iam org-role-set USER_NAME ORG_NAME ORG_ROLE -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
NOME_UTENTE (obbligatorio)
-
Il nome dell'utente in fase di assegnazione.
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Il nome dell'organizzazione a cui viene assegnato l'utente.
-
RUOLO_ORGANIZZAZIONE (obbligatorio)
-
Il nome del ruolo organizzazione a cui viene assegnato l'utente. Per esempio: -
    -
  • OrgManager: questo ruolo può invitare e gestire utenti, selezionare e modificare piani e impostare limiti di spesa.
    • -
  • BillingManager: questo ruolo può creare e gestire l'account di fatturazione e le informazioni sul pagamento.
    • -
  • OrgAuditor: questo ruolo dispone di un accesso in sola lettura a report e informazioni sull'organizzazione.
    • -
-
-
- -Esempi: - -Assegnare l'utente `Mary` all'organizzazione `IBM` con il ruolo `OrgManager`: - -``` -bluemix iam org-role-set Mary IBM OrgManager -``` - - -### bluemix iam org-role-unset -{: #bluemix_iam_org_role_unset} - -Rimuovere un ruolo dell'organizzazione da un utente. Questa operazione può essere eseguita solo da un gestore organizzazione. - -``` -bluemix iam org-role-unset USER_NAME ORG_NAME ORG_ROLE -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
NOME_UTENTE (obbligatorio)
-
Il nome dell'utente in fase di eliminazione.
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Il nome dell'organizzazione da cui viene eliminato l'utente.
-
RUOLO_ORGANIZZAZIONE (obbligatorio)
-
Il nome del ruolo organizzazione da cui viene eliminato l'utente. Per esempio: -
    -
  • OrgManager: questo ruolo può invitare e gestire utenti, selezionare e modificare piani e impostare limiti di spesa.
    • -
  • BillingManager: questo ruolo può creare e gestire l'account di fatturazione e le informazioni sul pagamento.
    • -
  • OrgAuditor: questo ruolo dispone di un accesso in sola lettura a report e informazioni sull'organizzazione.
    • -
-
-
- -Esempi: - -Rimuovere l'utente `Mary` dall'organizzazione `IBM` con il ruolo `OrgManager`: - -``` -bluemix iam org-role-unset Mary IBM OrgManager -``` - - -### bluemix iam space-users -{: #bluemix_iam_space_users} - -Visualizzare gli utenti nello spazio specificato per il ruolo. - -``` -bluemix iam space-users ORG_NAME SPACE_NAME -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Il nome dell'organizzazione.
-
NOME_SPAZIO (obbligatorio)
-
Il nome dello spazio.
-
- - -### bluemix iam space-role-set -{: #bluemix_iam_space_role_set} - -Assegnare un ruolo dello spazio ad un utente. Questa operazione può essere eseguita solo da un gestore spazio. - -``` -bluemix iam space-role-set USER_NAME ORG_NAME SPACE_NAME SPACE_ROLE -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: - -
-
NOME_UTENTE (obbligatorio)
-
Il nome dell'utente in fase di assegnazione.
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Il nome dell'organizzazione a cui viene assegnato l'utente.
-
NOME_SPAZIO (obbligatorio)
-
Il nome dello spazio a cui è assegnato l'utente.
-
RUOLO_SPAZIO (obbligatorio)
-
Il nome del ruolo spazio a cui è assegnato l'utente. Per esempio: -
    -
  • SpaceManager: questo ruolo può invitare e gestire utenti e attivare funzioni per un dato spazio.
    • -
  • SpaceDeveloper: questo ruolo può creare e gestire applicazioni e servizi e visualizzare log e report.
    • -
  • SpaceAuditor: questo ruolo può visualizzare log, report e impostazioni per lo spazio.
    • -
-
- -Esempi: - -Assegnare l'utente `Mary` all'organizzazione `IBM` e allo spazio `Cloud` con il ruolo `SpaceManager`: - -``` -bluemix iam space-role-set Mary IBM Cloud SpaceManager -``` - -### bluemix iam space-role-unset -{: #bluemix_iam_space_role_unset} - -Rimuovere un ruolo dello spazio da un utente. Questa operazione può essere eseguita solo da un gestore spazio. - -``` -bluemix iam space-role-unset USER_NAME ORG_NAME SPACE_NAME SPACE_ROLE -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: - -
-
NOME_UTENTE (obbligatorio)
-
Il nome dell'utente in fase di eliminazione.
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Il nome dell'organizzazione da cui viene eliminato l'utente.
-
NOME_SPAZIO (obbligatorio)
-
Il nome dello spazio da cui viene eliminato l'utente.
-
RUOLO_SPAZIO (obbligatorio)
-
Il nome del ruolo spazio da cui viene eliminato l'utente. Per esempio: -
    -
  • SpaceManager: questo ruolo può invitare e gestire utenti e attivare funzioni per un dato spazio.
    • -
  • SpaceDeveloper: questo ruolo può creare e gestire applicazioni e servizi e visualizzare log e report.
    • -
  • SpaceAuditor: questo ruolo può visualizzare log, report e impostazioni per lo spazio.
    • -
-
- - -Esempi: - -Rimuovere l'utente `Mary` dall'organizzazione `IBM` e dall spazio `Cloud` con il ruolo `SpaceManager`: - -``` -bluemix iam space-role-unset Mary IBM Cloud SpaceManager -``` - - -### bluemix app push -{: #bluemix_app_push} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf push`. - - -### bluemix app list -{: #bluemix_app_list} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf apps`. - - -### bluemix app show -{: #bluemix_app_show} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf app`. - - -### bluemix app scale -{: #bluemix_app_scale} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf scale`. - - -### bluemix app delete -{: #bluemix_app_delete} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete`. - - -### bluemix app rename -{: #bluemix_app_rename} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf rename`. - - -### bluemix app start -{: #bluemix_app_start} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf start`. - - -### bluemix app stop -{: #bluemix_app_stop} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf stop`. - - -### bluemix app restart -{: #bluemix_app_restart} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf restart`. - - -### bluemix app restage -{: #bluemix_app_restage} - - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf restage`. - - -### bluemix app instance-restart -{: #bluemix_app_instance_restart} - - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf restart-app-instance`. - - -### bluemix app events -{: #bluemix_app_events} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf events`. - - -### bluemix app files -{: #bluemix_app_files} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf files`. - - -### bluemix app logs -{: #bluemix_app_logs} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf logs`. - - -### bluemix app env -{: #bluemix_app_env} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf env`. - - -### bluemix app env-set -{: #bluemix_app_env_set} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf set-env`. - - -### bluemix app env-unset -{: #bluemix_app_env_unset} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf unset-env`. - - -### bluemix app stacks -{: #bluemix_app_stacks} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf stacks`. - - -### bluemix app stack -{: #bluemix_app_stack} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf stack`. - - -### bluemix app manifest-create -{: #bluemix_app_manifest_create} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-app-manifest`. - - -### bluemix service offerings -{: #bluemix_service_offerings} - - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf marketplace`. - - -### bluemix service list -{: #bluemix_service_list} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf services`. - - -### bluemix service show -{: #bluemix_service_show} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf service`. - - -### bluemix service create -{: #bluemix_service_create} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-service`. - - -### bluemix service update -{: #bluemix_service_update} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf update-service`. - - -### bluemix service delete -{: #bluemix_service_delete} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-service`. - - -### bluemix service rename -{: #bluemix_service_rename} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf rename-service`. - - -### bluemix service bind -{: #bluemix_service_bind} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf bind-service`. - - -### bluemix service unbind -{: #bluemix_service_unbind} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf unbind-service`. - - -### bluemix service key-create -{: #bluemix_service_key_create} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-service-key`. - - -### bluemix service key-delete -{: #bluemix_service_key_delete} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-service-key`. - - -### bluemix service keys -{: #bluemix_service_keys} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf service-keys`. - - -### bluemix service key-show -{: #bluemix_service_key_show} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf service-key`. - - -### bluemix service user-provided-create -{: #bluemix_service_user_provided_create} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-user-provided-service`. - - -### bluemix service user-provided-update -{: #bluemix_service_user_provided_update} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf update-user-provided-service`. - - -### bluemix catalog templates -{: #bluemix_catalog_templates} - -Visualizzare i template di contenitore tipo su Bluemix. - -``` -bluemix catalog templates [-d] -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: - -
-
-d (facoltativo)
-
Se viene specificata l'opzione -d, viene visualizzata anche la descrizione di ciascun template. Altrimenti, vengono visualizzati solo l'ID e il nome di ciascun template.
-
- - -### bluemix catalog template -{: #bluemix_catalog_template} - -Visualizzare le informazioni dettagliate di un template contenitore tipo specificato. - -``` -bluemix catalog template TEMPLATE_ID -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: -
-
ID_TEMPLATE (obbligatorio)
-
L'ID del template contenitore tipo. Utilizza bluemix template per visualizzare l'ID di tutti i template.
-
- - -Esempi: - -Visualizzare i dettagli del template `mobileBackendStarter`: - -``` -bluemix catalog template mobileBackendStarter -``` - - -### bluemix catalog template-run -{: #bluemix_catalog_template_run} - -Creare un'applicazione cf basata sul template specificato con l'URL e la descrizione specificati. Per impostazione predefinita, la nuova applicazione viene avviata automaticamente. - -``` -bluemix catalog template-run TEMPLATE_ID CF_APP_NAME [-u URL] [-d DESCRIPTION] [--no-start] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: -
-
ID_TEMPLATE (obbligatorio)
-
Il template su cui verrà basata l'applicazione quando verrà creata. Utilizza bluemix templates per visualizzare l'ID di tutti i template.
-
NOME_APPLICAZIONE_CF (obbligatorio)
-
Il nome dell'applicazione cf da creare.
-
-u URL (facoltativo)
-
La rotta dell'applicazione. Se non specificata, la rotta viene impostata automaticamente da Bluemix, in base al tuo nome applicazione e al tuo dominio predefinito.
-
-d DESCRIZIONE (facoltativo)
-
Descrizione dell'applicazione.
-
--no-start (facoltativo)
-
Non avviare l'applicazione automaticamente una volta creata. Se non viene specificata, l'applicazione viene avviata automaticamente dopo la sua creazione.
-
- - -Esempi: - -Creare un'applicazione `my-app` basata sul template `javaHelloWorld`: - -``` -bluemix catalog template-run javaHelloWorld my-app -``` - -Creare un'applicazione `my-ruby-app` basata sul template `rubyHelloWorld` con la rotta `myrubyapp.chinabluemix.net` e la descrizione `My first ruby app on {{site.data.keyword.Bluemix_notm}}.`: - -``` -bluemix catalog template-run rubyHelloWorld my-ruby-app -u myrubyapp.chinabluemix.net -d "My first ruby app on {{site.data.keyword.Bluemix_notm}}." -``` - -Creare un'applicazione `my-python-app` basata sul template `pythonHelloWorld` senza l'avvio automatico: - -``` -bluemix catalog template-run pythonHelloWorld my-python-app --no-start -``` - - -### bluemix network regions -{: #bluemix_network_regions} - -Visualizzare le informazioni per tutte le regioni su {{site.data.keyword.Bluemix_notm}}. - -``` -bluemix network regions -``` - -Prerequisiti: Endpoint - - -### bluemix network region-set -{: #bluemix_network_region_set} - -Passare alla regione specificata. Questo comando ha automaticamente di nuovo come destinazione la stessa organizzazione e lo stesso spazio nella nuova regione, se possibile. Altrimenti, il comando richiede all'utente di selezionare una nuova organizzazione e un nuovo spazio, qualora l'utente sia già collegato. L'endpoint API viene modificato di conseguenza. - -``` -bluemix network region-set NOME_REGIONE -``` - -Prerequisiti: Endpoint - -Opzioni del comando: - -
-
NOME_REGIONE (obbligatorio)
-
Il nome della regione a cui si desidera passare. Puoi utilizzare il comando bluemix network regions per visualizzare tutti i nomi regione.
-
- -Esempi: - -Impostare la regione corrente su `eu-gb`: - -``` -bluemix network region-set eu-gb -``` - - -### bluemix network routes -{: #bluemix_network_routes} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf routes`. - - -### bluemix network route-check -{: #bluemix_network_route_check} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf check-route`. - - -### bluemix network route-map -{: #bluemix_network_route_map} - -Associare una rotta a un'applicazione cf o a un gruppo di contenitori esistenti che hanno il dominio e il nome host specificati. - -``` -bluemix network route-map CF_APP_NAME|CONTAINER_GROUP_NAME  DOMAIN  [-n HOST_NAME] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
NOME_APPLICAZIONE_CF|NOME_GRUPPO_CONTENITORE (obbligatorio)
-
Il nome dell'applicazione cf o del gruppo di contenitori da associare a una rotta.
-
DOMINIO (obbligatorio)
-
Il dominio della rotta. Ad esempio, mychinabluemix.net o chinabluemix.net.
-
-n NOME_HOST (facoltativo)
-
Il nome host della rotta. Se non viene fornito, il nome host è impostato sul nome applicazione o sul nome gruppo di contenitori per impostazione predefinita.
-
- -Esempi: - -Associare una rotta `my-app` con il dominio specificato: - -``` -bluemix network route-map my-app mychinabluemix.net -``` - -Associare una rotta a 'my-container-group' con il dominio e il nome host specificati: - -``` -bluemix network route-map my-container-group chinabluemix.net -n abc -``` - - -### bluemix network route-unmap -{: #bluemix_network_route_unmap} - -Annullare l'associazione della rotta specificata a un'applicazione cf o a un gruppo di contenitori esistenti. - -``` -bluemix network route-unmap CF_APP_NAME|CONTAINER_GROUP_NAME  DOMAIN  [-n HOST_NAME] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
NOME_APPLICAZIONE_CF|NOME_GRUPPO_CONTENITORE (obbligatorio)
-
Il nome dell'applicazione cf o del gruppo di contenitori.
-
DOMINIO (obbligatorio)
-
Il dominio della rotta (ad esempio, mychinabluemix.net o chinabluemix.net).
-
-n NOME_HOST (facoltativo)
-
Il nome host della rotta. Se non viene fornito, il nome host è impostato sul nome applicazione o sul nome gruppo di contenitori per impostazione predefinita.
-
- -Esempi: - -Annullare l'associazione di `my-app.mychinabluemix.net` da `my-app`: - -``` -bluemix network route-unmap my-app mychianbluemix.net -``` - -Annullare l'associazione di `abc.chinabluexmix.net` da `my-container-group`: - -``` -bluemix network route-unmap my-container-group chinabluemix.net -n abc -``` - - -### bluemix network route-create -{: #bluemix_network_route_create} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-route`. - - -### bluemix network route-delete -{: #bluemix_network_route_delete} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-route`. - - -### bluemix network orphaned-routes-delete -{: #bluemix_network_orphaned_routes_delete} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-orphaned-routes`. - - -### bluemix network domains -{: #bluemix_network_domains} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf domains`. - - -### bluemix network domain-create -{: #bluemix_network_domain_create} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-domain`. - - -### bluemix network domain-delete -{: #bluemix_network_domain_delete} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-domain`. - - -### bluemix network shared-domain-create -{: #bluemix_network_shared_domain_create} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-shared-domain`. - - -### bluemix network shared-domain-delete -{: #bluemix_network_shared_domain_delete} - -Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-shared-domain`. - - - -### bluemix bss account-usage -{: #bluemix_bss_account_usage} - -Mostra i costi e l'utilizzo mensile del tuo account. - -``` -bluemix bss account-usage [-d YYYY-MM] [--json] -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: - -
-
-d MONTH_DATE (facoltativo)
-
Visualizza i dati per il mese e la data specificando l'utilizzo nel formato YYYY-MM. Se non specificato, viene mostrato l'utilizzo del mese corrente.
-
--json (facoltativo)
-
Visualizza il risultato di utilizzo nel formato JSON.
-
- -Esempi: - -Mostra il report del costo e l'utilizzo dell'account per 2016-06: - -``` -bluemix bss account-usage -d 2016-06 -``` - -### bluemix bss org-usage -{: #bluemix_bss_org_usage} - -Mostra i dettagli dell'utilizzo mensile di un'organizzazione. Questa operazione può essere eseguita solo da un gestore della fatturazione dell'organizzazione. - -``` -bluemix bss org-usage ORG_NAME [-d YYYY-MM] [-r REGION_NAME] [--json] -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: - -
-
NOME_ORGANIZZAZIONE (obbligatorio)
-
Nome dell'organizzazione.
-
-d MONTH_DATE (facoltativo)
-
Visualizza i dati per il mese e la data specificata tramite l'utilizzo nel formato YYYY-MM. Se non specificato, viene mostrato l'utilizzo del mese corrente.
-
-r REGION_NAME
-
Nome della regione che ospita l'organizzazione. Se impostato su 'all', viene mostrato l'utilizzo dell'organizzazione in tutte le regioni.
-
--json (facoltativo)
-
Visualizza il risultato di utilizzo nel formato JSON.
-
- - - -### bluemix bss orgs-usage-summary -{: #bluemix_bss_orgs_usage_summary} - -Mostra il riepilogo dell'utilizzo mensile per le organizzazioni nel mio account. - -``` -bluemix bss orgs-usage-summary [-d YYYY-MM] [-r REGION_NAME] [--json] -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: - -
-
-d MONTH_DATE (facoltativo)
-
Visualizza i dati per il mese e la data specificata tramite l'utilizzo nel formato YYYY-MM. Se non specificato, viene mostrato l'utilizzo del mese corrente.
-
-r REGION_NAME
-
Nome della regione che ospita le organizzazioni. Se impostato su 'all', viene mostrato il riepilogo dell'utilizzo delle organizzazioni in tutte le regioni.
-
--json (facoltativo)
-
Visualizza il risultato di utilizzo nel formato JSON.
-
- - - -### bluemix security cert -{: #bluemix_security_cert} - -Elencare le informazioni sul certificato di un dominio. - -``` -bluemix security cert DOMAIN_NAME -``` - -Prerequisiti: Endpoint, Accesso - -Opzioni del comando: - -
-
NOME_DOMINIO (obbligatorio)
-
Il dominio che ospita il certificato.
-
- - - -Esempi: - -Visualizzare le informazioni sul certificato del dominio `ibmcxo-eventconnect.com`: - -``` -bluemix security cert ibmcxo-eventconnect.com -``` - - -### bluemix security cert-add -{: #bluemix_security_cert_add} - -Aggiungere un certificato al dominio specificato nell'organizzazione corrente. - -``` -bluemix security cert-add DOMAIN -k PRIVATE_KEY_FILE -c CERT_FILE [-p PASSWORD] [-i INTERMEDIATE_CERT_FILE] [--verify-client] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: -
-
DOMINIO (obbligatorio)
-
Il dominio a cui viene aggiunto il certificato.
-
-k FILE_CHIAVE PRIVATA (obbligatorio)
-
Il percorso del file della chiave privata.
-
-c FILE_CERTIFICATO (obbligatorio)
-
Il percorso del file del certificato.
-
-p PASSWORD (facoltativo)
-
La password per il certificato.
-
-i FILE_CERTIFICATO_INTERMEDIO (optional)
-
Il percorso del file di certificato intermedio.
-
--verify-client (facoltativo)
-
Stabilire se abilitare la verifica del certificato del client.
-
- - -Esempi: - -Aggiungere un certificato al dominio `ibmcxo-eventconnect.com`: - -``` -bluemix security cert-add ibmcxo-eventconnect.com -k key_file.key -c cert_file.crt -p 123 -i inter_cert.cert -``` - - -### bluemix security cert-remove -{: #bluemix_security_cert_remove} - -Rimuovere un certificato dal dominio specificato nell'organizzazione corrente. - -``` -bluemix security cert-remove DOMAIN [-f] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
DOMINIO (obbligatorio)
-
Il dominio da cui rimuovere il certificato.
-
-f (facoltativo)
-
Forzare l'eliminazione senza conferma.
-
- - - -### bluemix plugin repos -{: #bluemix_plugin_repos} - -Elencare i repository di plugin registrati nella CLI {{site.data.keyword.Bluemix_notm}}. - -``` -bluemix plugin repos -``` - -Prerequisiti: Nessuno - - -### bluemix plugin repo-add -{: #bluemix_plugin_repo_add} - -Aggiungere un nuovo repository di plugin alla CLI {{site.data.keyword.Bluemix_notm}}. - -``` -bluemix plugin repo-add NOME_REPOSITORY URL_REPOSITORY -``` - -Prerequisiti: Nessuno - -Opzioni del comando: - -
-
NOME_REPOSITORY (obbligatorio)
-
Il nome del repository da aggiungere. Puoi definire un tuo nome per ciascun repository.
-
URL_REPOSITORY (obbligatorio)
-
L'URL del repository da aggiungere. L'URL del repository deve contenere il protocollo (ad esempio, http://plugins.ng.bluemix.net invece di plugins.ng.bluemix.net). http://plugins.ng.bluemix.net è il repository di plugin ufficiale della CLI Bluemix.
-
- - -Esempi: - -Aggiungere il repository di plug-in ufficiale della CLI Bluemix come `bluemix-repo`: - -``` -bluemix plugin repo-add bluemix-repo http://plugins.ng.bluemix.net -``` - - -### bluemix plugin repo-remove -{: #bluemix_plugin_repo_remove} - -Rimuovere un repository di plugin dalla CLI {{site.data.keyword.Bluemix_notm}}. - -``` -bluemix plugin repo-remove NOME_REPOSITORY -``` - -Prerequisiti: Nessuno - -Opzioni del comando: -
-
NOME_REPOSITORY (obbligatorio)
-
Il nome del repository da rimuovere.
-
- -Esempi: - -Rimuovere il repository `bluemix-repo` dalla CLI {{site.data.keyword.Bluemix_notm}}: - -``` -bluemix plugin repo-remove bluemix-repo -``` - - -### bluemix plugin repo-plugins -{: #bluemix_plugin_repo_plugins} - -Elencare tutti i plugin disponibili in tutti i repository aggiunti o in uno specifico repository. - -``` -bluemix plugin repo-plugins [-r NOME_REPOSITORY] -``` - -Prerequisiti: Nessuno - -Opzioni del comando: - -
-
-r NOME_REPOSITORY (facoltativo)
-
Elencare solo i plugin del repository specificato.
-
- -Esempi: - -Elencare tutti i plugin in tutti i repository aggiunti: - -``` -bluemix plugin repo-plugins -``` - -Elencare tutti i plugin nel repository `bluemix-repo`: - -``` -bluemix plugin repo-plugins -r bluemix-repo -``` - - -### bluemix plugin list -{: #bluemix_plugin_list} - -Elencare tutti i plugin installati nella CLI {{site.data.keyword.Bluemix_notm}}. - -``` -bluemix plugin list -``` - -Prerequisiti: Nessuno - - -### bluemix plugin install -{: #bluemix_plugin_install} - -Installare la versione specifica del plugin nella CLI {{site.data.keyword.Bluemix_notm}} dal percorso o repository specificato. - -``` -bluemix plugin install PLUGIN_PATH|PLUGIN_NAME [-r REPO_NAME] [-v VERSION] -``` - -Prerequisiti: Nessuno - -Opzioni del comando: - -
-
PERCORSO_PLUGIN|NOME_PLUGIN (obbligatorio)
-
Se -r NOME_REPOSITORY non viene specificato, il plugin viene installato dal percorso locale o dall'URL remoto specificati.
-
-r NOME_REPOSITORY (facoltativo)
-
Il nome del repository in cui si trova il file binario del plugin.
-
-v VERSIONE (facoltativo)
-
La versione del plugin da installare. Se non fornita, viene installata l'ultima versione del plugin. Questa opzione è valida solo quando si installa il plugin dal repository.
-
- -Esempi: - -Installare un plugin dal file locale: - -``` -bluemix plugin install /downloads/new_plugin -``` - -Installare un plugin dall'URL remoto: - -``` -bluemix plugin install http://plugins.ng.bluemix.net/downloads/new_plugin -``` - -Installare il plugin `IBM-Containers` dell'ultima versione dal repository `bluemix-repo`: - -``` -bluemix plugin install IBM-Containers -r bluemix-repo -``` -Installare il plugin `IBM-Containers` con la versione `0.5.800` dal repository `bluemix-repo`: - -``` -bluemix plugin install IBM-Containers -r bluemix-repo -v 0.5.800 -``` - - - - - - -### bluemix plugin uninstall -{: #bluemix_plugin_uninstall} - -Disinstallare il plugin specificato dalla CLI {{site.data.keyword.Bluemix_notm}}. - -``` -bluemix plugin uninstall NOME_PLUGIN -``` - -Prerequisiti: Nessuno - -Opzioni del comando: - -
-
NOME_PLUGIN (obbligatorio)
-
Il nome del plugin da disinstallare.
-
- -Esempi: - -Disinstallare il plugin `IBM-Containers` che era stato precedentemente installato: - -``` -bluemix plugin uninstall IBM-Containers -``` - - -### bluemix ic attach -{: #bluemix_ic_attach} - -Controllare un contenitore in esecuzione o visualizzarne l'output. Utilizza `CTRL+C` per uscire e arrestare il contenitore. Questo comando richiama la CLI Docker. Per ulteriori informazioni, vedi il comando [attach ](https://docs.docker.com/engine/reference/commandline/attach/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - -``` -bluemix ic attach [--no-stdin] [--sig-proxy] CONTAINER -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
--no-stdin (facoltativo)
-
Non includere l'input standard.
-
--sig-proxy (facoltativo)
-
Eseguire il proxy di tutti i segnali ricevuti nel processo. Il -valore predefinito è true.
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di collegamento al contenitore `my_container`: -``` -bluemix ic attach my_container -``` - - -### bluemix ic build -{: #bluemix_ic_build} - -Richiamare il servizio di build IBM Containers per creare un'immagine Docker in locale o nel tuo repository {{site.data.keyword.Bluemix_notm}} privato. Questo comando richiama la CLI Docker. Per ulteriori informazioni, vedi il comando [build ](https://docs.docker.com/engine/reference/commandline/build/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - -``` -bluemix ic build -t TAG|--tag TAG [--no-cache] [-p|--pull] [-q|--quiet] DOCKERFILE_LOCATION -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: -
-
-t TAG|--tag TAG (obbligatorio)
-
Il nome repository da applicare all'immagine in fase di creazione.
-
--no-cache (facoltativo)
-
Non utilizzare la cache quando viene creata l'immagine. Il valore predefinito è false.
-
--pull (facoltativo)
-
Provare a estrarre l'immagine di base dal registro anche se è memorizzata nella cache.
-
-q|--quiet (facoltativo)
-
Sopprimere l'output dettagliato generato dai contenitori. Il valore predefinito è false.
-
DOCKERFILE_LOCATION (obbligatorio)
-
Il percorso verso Dockerfile e contesto sull'host locale.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di creazione di un'immagine denominata *myimage*. Il Dockerfile e altre risorse utente da utilizzare nella creazione si trovano nella stessa directory da cui viene eseguito il comando. Poiché il registro e lo spazio dei nomi sono inclusi nel nome dell'immagine, l'immagine viene creata nel repository {{site.data.keyword.Bluemix_notm}} privato della tua organizzazione. -``` -bluemix ic build -t registry.ng.bluemix.net/mynamespace/myimage . -``` - - -### bluemix ic cp -{: #bluemix_ic_cp} -Copia file o cartelle tra un contenitore e il file system locale. Questo comando richiama la CLI Docker. Per ulteriori informazioni, vedi il comando [cp ](https://docs.docker.com/engine/reference/commandline/cp/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - - -### bluemix ic cpi -{: #bluemix_ic_cpi} - -Accedere a un'immagine Docker Hub o a un'immagine dal tuo registro locale e copiarla nel tuo repository {{site.data.keyword.Bluemix_notm}} privato. - -``` -bluemix ic cpi IMMAGINE_DI_ORIGINE IMMAGINE_DI_DESTINAZIONE -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: -
-
IMMAGINE_DI_ORIGINE (obbligatorio)
-
Il nome del repository e dell'immagine di origine.
-
IMMAGINE_DI_DESTINAZIONE (obbligatorio)
-
L'URL del repository {{site.data.keyword.Bluemix_notm}} privato, che include lo spazio dei nomi e il nome dell'immagine di destinazione. Una tag per l'immagine è facoltativa.
-
- -Esempi: - -Copiare un'immagine dal repository di origine nel repository privato ed aggiungere una tag per l'immagine: - -``` -bluemix ic cpi source_repository/source_image_name private_registry_URL/destination_image_name:tag -``` - -Copiare l'immagine `sinatra` dal repository `training` nel repository privato `registry.ng.bluemix.net/mynamespace` e il nome dell'immagine `mysinatra`. Aggiungere una tag `v1` per l'immagine `mysinatra`. - -``` -bluemix ic cpi training/sinatra registry.ng.bluemix.net/mynamespace/mysinatra:v1 -``` - - -### bluemix ic exec -{: #bluemix_ic_exec} - -Eseguire un comando all'interno di un contenitore. Per ulteriori informazioni, vedi il comando [exec ](https://docs.docker.com/engine/reference/commandline/exec/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - -``` -bluemix ic exec [-d|--detach] [-it] [-u USER|--user USER] CONTAINER [CMD] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
-d|--detach (facoltativo)
-
Eseguire il comando specificato in background.
-
-it (facoltativo)
-
Modalità interattiva. L'input standard rimane visualizzato. Immetti exit per uscire.
-
-u UTENTE|--user UTENTE (facoltativo)
-
Il nome utente.
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
CMD (facoltativo)
-
Il comando da eseguire all'interno del contenitore o dei contenitori specificati.
-
- -Esempi: - -Eseguire il comando `bash` all'interno del contenitore `my_container` nella modalità interattiva: - -``` -bluemix ic exec -it my_container bash -``` - -Eseguire il comando `date` all'interno del contenitore `my_container`: - -``` -bluemix ic exec my_container date -``` - - -### bluemix ic group-create -{: #bluemix_ic_group_create} - -Creare un gruppo di contenitori scalabile. - -``` -bluemix ic group-create [--publish,-p PORT] --name GROUP_NAME [--memory,-m MEMORY_SIZE] [-n,--hostname HOSTNAME] [-d,--domain DOMAIN] [--env,-e ENV_KEY=ENV_VAL] [--env-file ENVIRONMENT_VARIABLE_FILE] [-P false|true] [--volume] [--min MIN_INSTANCE_COUNT] [--max MAX_INSTANCE_COUNT] [--desired DESIRED_INSTANCE_COUNT] [--anti false|true] [--auto false|true] IMAGE_NAME [CMD [CMD ...]] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: -
-
IMAGE_NAME (obbligatorio)
-
L'immagine da includere in ciascuna istanza del contenitore del gruppo di contenitori. L'immagine può essere seguita da un elenco di comandi, ma non da opzioni. Includi tutte le opzioni prima di specificare l'immagine.

Se utilizzi un'immagine nel repository {{site.data.keyword.Bluemix_notm}} privato della tua organizzazione, specificala con il seguente formato: registry.ng.bluemix.net/SPAZIO_NOMI/IMMAGINE.

Se utilizzi un'immagine fornita da IBM Containers, non includere lo spazio dei nomi della tua organizzazione. Specifica l'immagine con il seguente formato: registry.ng.bluemix.net/IMMAGINE.
-
--name GROUP_NAME (obbligatorio)
-
Assegnare un nome al gruppo. -n è stato dichiarato obsoleto.
- Suggerimento: il nome del contenitore deve iniziare con una lettera. Il nome può includere lettere maiuscole, lettere minuscole, numeri, punti., caratteri di sottolineatura _, o trattini -.
-
-m MEMORY_SIZE|--memory MEMORY_SIZE (facoltativo)
-
Assegnare un limite di memoria al gruppo in MB. Quando crei un gruppo di contenitori dalla CLI, il valore predefinito per ogni istanza del contenitore è 64 MB. Quando crei un gruppo di contenitori dal Dashboard {{site.data.keyword.Bluemix_notm}}, il valore predefinito per ogni istanza del contenitore è 256 MB. I valori accettati sono 64, 256, 512, 1024 e 2048. Una volta assegnato, il limite di memoria non può essere modificato.
-
-n HOSTNAME|--hostname HOSTNAME (facoltativo)
-
Il nome host, quale ad esempio mycontainerhost. L'host e il dominio si combinano per formare l'URL completo della rotta pubblica, quale ad esempio http://mycontainerhost.mybluemix.net. Quando esamini i dettagli di un gruppo di contenitori con il comando bluemix ic group-inspect, l'host e il dominio vengono elencati insieme come rotta.
-
-d DOMINIO|--domain DOMINIO (facoltativo)
-
Di solito, il dominio è .mybluemix.net. L'host e il dominio vengono combinati per formare l'URL completo della rotta pubblica, quale ad esempio http://mycontainerhost.mybluemix.net. Quando esamini i dettagli di un gruppo di contenitori con il comando bluemix ic group-inspect, l'host e il dominio vengono elencati insieme come rotta.
-
-e ENV_KEY=ENV_VAL|--env ENV_KEY=ENV_VAL (facoltativo)
-
Imposta la variabile di ambiente. In caso di più chiavi, elencale separatamente. Se sono incluse virgolette, includile racchiudendo sia il valore che il nome della variabile di ambiente. Ad esempio: `-e "key1=value1" -e "key2=value2" -e "key3=value3"`. La seguente tabella mostra alcune variabili di ambiente comunemente utilizzate che puoi specificare:
-
- - -| Variabile di ambiente | Descrizione | -| :----------------------------- | :------------------------------ | -| CCS_BIND_APP=*<nome_applicazione>* | Eseguire il bind di un servizio a un contenitore. Utilizza la variabile di ambiente `CCS_BIND_APP` per eseguire il bind di un'applicazione al contenitore. L'applicazione viene associata tramite bind al servizio di destinazione e funge da ponte che consente a {{site.data.keyword.Bluemix_notm}} di portare le informazioni `VCAP_SERVICES` dell'applicazione ponte all'istanza del contenitore in esecuzione.| -| CCS_BIND_SRV=*<nome_istanza_servizio1>*,*<nome_istanza_servizio2>* | Per eseguire direttamente il bind di un servizio Bluemix a un contenitore senza utilizzare un'applicazione ponte, utilizza CCS_BIND_SRV. Questo bind consente a Bluemix di inserire le informazioni VCAP_SERVICES nell'istanza del contenitore in esecuzione. Per elencare più servizi Bluemix, puoi includerli come parte della stessa variabile di ambiente. | -| LOG_LOCATIONS=*<>percorso_verso_file* | Aggiungere un file di log da monitorare nel contenitore. Includi la variabile di ambiente `LOG_LOCATIONS` in un percorso verso il file di log. | -{: caption="Table 8. Commonly used environment variables" caption-side="top"} - - -
-
--env-file FILE_VARIABILE_AMBIENTE (facoltativo)
-
Importa variabili di ambiente da un file dove ENVFILE è il percorso del tuo file nella directory locale. Ogni riga nel file rappresenta una coppia key=value.
-
--volume VOLUME:PERCORSO_CONTENITORE[:ro] (facoltativo)
-
Collegare un volume a un contenitore, specificando i dettagli nel formato IDVolume:PercorsoContenitore[:ro]. -
    -
  • VOLUME: l'ID o nome del volume.
    • -
  • PERCORSO_CONTENITORE: il percorso assoluto per il volume del contenitore.
    • -
  • ro: facoltativo. La specifica di ro rende il volume di sola lettura invece della lettura/scrittura predefinita.
-
-
-p PORTA|--publish PORTA (facoltativo)
-
Esporre la porta per il traffico HTTP. I contenitori del tuo gruppo devono essere in ascolto sulla porta HTTP. Non possono essere effettuate richieste HTTPS. Per i gruppi di contenitori, non puoi includere più porte.

Quando specifichi una porta, stai rendendo l'applicazione disponibile al programma di bilanciamento del carico {{site.data.keyword.Bluemix_notm}} o ai contenitori che stanno provando a raggiungere l'host nello stesso spazio {{site.data.keyword.Bluemix_notm}}. Quindi i contenitori o il bilanciamento del carico {{site.data.keyword.Bluemix_notm}} possono utilizzare la porta per raggiungere l'host e l'applicazione nello stesso spazio {{site.data.keyword.Bluemix_notm}}. Se nel Dockerfile è specificata una porta per l'immagine che stai utilizzando, includila.
- Suggerimenti:
    -
  • Per l'immagine Liberty Server certificata da IBM o una versione modificata di questa immagine, immetti la porta 9080.
    • -
  • Per l'immagine Node.js certificata da IBM o una versione modificata di questa immagine, immetti la porta 8000.
    • -
-
-
-P (facoltativo)
-
Pubblica tutte le porte
-
--min MIN_INSTANCE_COUNT (facoltativo)
-
Il numero minimo di istanze. Il valore predefinito è 1. Se imposti un numero minimo di istanze, una volta creato il gruppo di contenitori non è più possibile modificare questo valore.
-
--max MAX_INSTANCE_COUNT (facoltativo)
-
Il numero massimo di istanze. Il valore predefinito è 2. Se imposti un numero massimo di istanze, una volta creato il gruppo di contenitori non è più possibile modificare questo valore.
-
--desired DESIRED_INSTANCE_COUNT (facoltativo)
-
Il numero di istanze da te richiesto. Il valore predefinito è 2.
-
--auto (facoltativo)
-
Quando si crea il gruppo di contenitori e il ripristino automatico è abilitato, IBM Containers verifica l'integrità di ciascuna istanza con una richiesta HTTP alla porta assegnata.
- Se non viene ricevuta alcuna risposta da un'istanza del contenitore entro 2 intervalli consecutivi di 90 secondi, l'istanza viene rimossa e sostituita con una nuova istanza. Se il contenitore risponde non viene effettuata alcuna azione. Questo processo viene ripetuto continuamente. In una finestra di 30 minuti, se il numero totale di differenti contenitori membri del gruppo è uguale o 3 volte maggiore della dimensione massima osservata per il gruppo stesso, il ripristino automatico viene disabilitato in modo permanente per il gruppo di contenitori. Per abilitare di nuovo il ripristino automatico, devi ricreare il gruppo di contenitori.
-
--anti (facoltativo)
-
Utilizza l'opzione anti-affinity per rendere il tuo gruppo di contenitori molto più disponibile. L'opzione --anti forza l'inserimento di ogni istanza di contenitore del tuo gruppo in un nodo di elaborazione fisico separato, riducendo così la possibilità che si verifichi un arresto anomalo di tutti i contenitori nel gruppo a causa di un errore hardware. Potresti non essere in grado di utilizzare questa opzione con gruppi di dimensione maggiore in quanto ogni regione e organizzazione Bluemix ha a disposizione una serie di nodi di elaborazione limitata per la distribuzione. Se la distribuzione non riesce, riduci il numero di istanze del contenitore nel gruppo o rimuovi l'opzione --anti.
-
CMD (facoltativo)
-
Il comando e gli argomenti trasmessi al gruppo di contenitori per l'esecuzione. Questo comando deve essere un comando a esecuzione prolungata. Non utilizzare un comando di breve durata che non viene eseguito per molto tempo, quale ad esempio /bin/date, poiché tale comando potrebbe provocare un arresto anomalo del contenitore.
Note:
    -
  • Il comando e i relativi argomenti devono trovarsi alla fine della riga di comando bluemix ic run.
    • -
  • Se gli argomenti del comando includono il trattino -, come in -c nel comando di esempio precedente, il comando deve essere preceduto da due trattini (--).
    • -
-
- - -Esempi: - -Creare un gruppo di contenitori `my_container_group` utilizzando l'immagine `registry.ng.bluemix.net/ibmnode` fornita da IBM Containers, quindi eseguire il comando di lunga durata `ping localhost` su tale gruppo di contenitori: - -``` -bluemix ic group-create --name my_container_group registry.ng.bluemix.net/ibmnode ping localhost -``` - -Creare un gruppo di contenitori `my_container_group` utilizzando l'immagine `registry.ng.bluemix.net/ibmnode` fornita da IBM Containers, quindi eseguire il comando di lunga durata `tail -f /dev/null` su tale gruppo di contenitori: - -``` -bluemix ic group-create --name my_container_group registry.ng.bluemix.net/ibmnode -- tail -f /dev/null -``` - -Creare un gruppo scalabile `mygroup` con il ripristino automatico abilitato, utilizzando l'immagine `registry.ng.bluemix.net/ibmliberty`. La porta è `9080`, il nome host è `mycontainerhost`, il nome dominio è `mybluemix.net`. -``` -bluemix ic group-create -p 9080 --auto -n mycontainerhost -d mybluemix.net --name mygroup registry.ng.bluemix.net/ibmliberty -``` - - -### bluemix ic group-inspect -{: #bluemix_ic_group_inspect} - -Visualizzare informazioni dettagliate, quali le variabili di ambiente, le porte o la memoria, specificate per un gruppo di contenitori al momento della creazione. - -``` -bluemix ic group-inspect GRUPPO_CONTENITORI -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
GRUPPO_CONTENITORI (obbligatorio)
-
Il nome o l'ID del gruppo di contenitori.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di controllo del gruppo di contenitori `my_group`: -``` -bluemix ic group-inspect my_group -``` - - -### bluemix ic group-instances -{: #bluemix_ic_group_instances} - -Elencare istanze di un gruppo di contenitori specificato. - -``` -bluemix ic group-instances GRUPPO_CONTENITORI -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
GRUPPO_CONTENITORI (obbligatorio)
-
Il nome o l'ID del gruppo di contenitori.
-
- -Esempi: - -Elencare tutte le istanze del gruppo di contenitori `my_group`: -``` -bluemix ic group-instances my_group -``` - - -### bluemix ic group-remove -{: #bluemix_ic_group_remove} - -Rimuovere un gruppo di contenitori da uno spazio. - -``` -bluemix ic group-remove [-f|--force] GROUP_NAME [GROUP_NAME2 [...]] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
-f|--force (facoltativo)
-
Forza la rimozione di un contenitore in esecuzione o in errore.
-
NOME GRUPPO (obbligatorio)
-
Il nome o l'ID del gruppo di contenitori.
-
- - -Esempi: - -Il seguente esempio mostra una richiesta di rimozione di un gruppo di contenitori, dove `my_group` è il nome del gruppo di contenitori. -``` -bluemix ic group-remove my_group -``` - - -### bluemix ic group-update -{: #bluemix_ic_group_update} - -Aggiornare un gruppo di contenitori. - - -``` -bluemix ic group-update [--anti] [--desired DESIRED_INSTANCE_COUNT] [-e ENV_KEY=ENV_VAL] GROUP_NAME -``` - -**Suggerimento:** per aggiornare il nome host o il dominio di un gruppo di contenitori, utilizza `bluemix ic route-map [-n HOST][-d DOMAIN] GRUPPO_CONTENITORI`. - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: -
-
--anti (facoltativo)
-
Utilizza l'opzione anti-affinity per rendere il tuo gruppo di contenitori molto più disponibile. L'opzione --anti forza l'inserimento di ogni istanza di contenitore del tuo gruppo in un nodo di elaborazione fisico separato, riducendo così la possibilità che si verifichi un arresto anomalo di tutti i contenitori nel gruppo a causa di un errore hardware. Potresti non essere in grado di utilizzare questa opzione con gruppi di dimensione maggiore in quanto ogni regione e organizzazione Bluemix ha a disposizione una serie di nodi di elaborazione limitata per la distribuzione. Se la distribuzione non riesce, riduci il numero di istanze del contenitore nel gruppo o rimuovi l'opzione --anti.
-
--desired DESIRED_INSTANCE_COUNT (facoltativo)
-
Il numero di istanze da te richiesto. Il valore predefinito è 2.
-
-e ENV_KEY=ENV_VAL(facoltativo)
-
Imposta la variabile di ambiente. In caso di più chiavi, elencale separatamente. Se sono incluse virgolette, includile racchiudendo sia il valore che il nome della variabile di ambiente. Ad esempio: `-e "key1=value1" -e "key2=value2" -e "key3=value3"`.
-
NOME GRUPPO (obbligatorio)
-
Il nome o l'ID del gruppo di contenitori.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di aggiornamento del gruppo di contenitori `my_group`: -``` -bluemix ic group-update --desired 5 my_group -``` - - -### bluemix ic groups -{: #bluemix_ic_groups} - -Elencare i gruppi di contenitori nel repository {{site.data.keyword.Bluemix_notm}} privato dell'organizzazione. - -``` -bluemix ic groups [-q] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: -
-
-q (facoltativo)
-
Visualizza solo gli ID gruppo
-
- - -### bluemix ic images -{: #bluemix_ic_images} - -Visualizzare un elenco di tutte le immagini disponibili nel repository {{site.data.keyword.Bluemix_notm}} privato dell'organizzazione. Per ulteriori informazioni, vedi il comando [images ](https://docs.docker.com/engine/reference/commandline/images){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. L'elenco include l'ID immagine, la data di creazione e il nome dell'immagine. - -``` -bluemix ic images [-a|--all] [-f CONDITION] [--no-trunc] [-q|--quiet] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
-a|--all (facoltativo)
-
Includere tutti i livelli di immagine per ciascuna immagine del repository dell'organizzazione e non solo il più recente.
-
-f (facoltativo)
-
Filtrare l'elenco di immagini in base alla condizione fornita.
-
--no-trunc (facoltativo)
-
Non troncare l'output.
-
-q|--quiet (facoltativo)
-
Visualizzare solo gli ID numerici.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di elenco delle immagini disponibili per l'organizzazione: -``` -bluemix ic images -``` - - -### bluemix ic info -{: #bluemix_ic_info} - -Visualizzare un insieme di informazioni che descrivono lo stato dell'istanza del servizio cloud del contenitore. Le informazioni includono limite dei contenitori, utilizzo dei contenitori, contenitori in esecuzione, limite di memoria, utilizzo della memoria, limite dell'indirizzo IP mobile, utilizzo dell'indirizzo IP mobile, URL host CCS, URL host del registro e stato della modalità di debug. - -``` -bluemix ic info -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - - -### bluemix ic init -{: #bluemix_ic_init} - -Inizializzare l'ambiente dei contenitori sulla macchina locale in uso per sfruttare appieno le funzioni del servizio IBM Containers. - -``` -bluemix ic init -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -**Nota:** prima dell'inizializzazione, accertati che la CLI Docker (docker) sia installata e configurato nella tua variabile di ambiente PATH. Per passare a un'altra regione, utilizza il comando `bluemix region-set`. - -Esempi: - -Passare alla regione `us-south`: - -``` -bluemix region-set us-south -``` - - -### bluemix ic inspect -{: #bluemix_ic_inspect} - -Visualizzare le informazioni su un contenitore. Per ulteriori informazioni, vedi il comando [inspect](https://docs.docker.com/engine/reference/commandline/inspect){: new_window} nella guida di Docker. - -``` -bluemix ic inspect [IMAGE|images|CONTAINER] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
IMAGE (obbligatorio)
-
Visualizzare informazioni dettagliate su un'immagine specifica indicando l'ID o il nome dell'immagine.
-
images (obbligatorio)
-
Visualizzare informazioni dettagliate su tutte le immagini del tuo repository.
-
CONTAINER (obbligatorio)
-
Visualizzare informazioni dettagliate su un contenitore specifico, indicando l'ID o il nome del contenitore.
-
- -**Suggerimento:** non è possibile specificare *IMMAGINE*, *images* o il *CONTENITORE* contemporaneamente. - -Esempi: - -Il seguente esempio mostra una richiesta di controllo di un contenitore denominato `proxy`: -``` -bluemix ic inspect proxy -``` - - -### bluemix ic ip-bind -{: #bluemix_ic_ip_bind} - -Eseguire il bind di un indirizzo IP a virgola mobile disponibile a un contenitore. - -``` -bluemix ic ip-bind CONTENITORE INDIRIZZO_IP -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
IP_ADDRESS (obbligatorio)
-
L'indirizzo IP da associare mediante bind.
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore da associare mediante bind.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di bind dell'indirizzo IP `192.123.12.12 al` contenitore `proxy`: -``` -bluemix ic ip-bind 192.123.12.12 proxy -``` - - -### bluemix ic ip-release -{: #bluemix_ic_ip_release} - -Rilasciare un indirizzo IP a virgola mobile dall'istanza del servizio cloud del contenitore. - -``` -bluemix ic ip-release IP_ADDRESS [IP_ADDRESS2 [...]] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
IP_ADDRESS (obbligatorio)
-
L'indirizzo IP da rilasciare.
-
- - -### bluemix ic ip-request -{: #ip_request} -Richiedere un nuovo indirizzo IP mobile. - -``` -bluemix ic ip-request [-q] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
-q (facoltativo)
-
Elenca solo gli indirizzi IP, senza l'ID per i contenitori associati a tali indirizzi IP.
-
- - -### bluemix ic ip-unbind -{: #bluemix_ic_ip_unbind} - -Annullare il bind di un indirizzo IP a virgola mobile dal relativo contenitore. - -Gli indirizzi IP pubblici sono una risorsa limitata di IBM Containers. Pertanto, gli indirizzi IP pubblici assegnati a uno spazio e non associati mediante bind a un contenitore vengono recuperati periodicamente dagli utenti della versione di prova, approssimativamente su base settimanale. Gli indirizzi IP non associati non sono mai recuperati dai clienti con pagamento a consumo o con una sottoscrizione. - -``` -bluemix ic ip-unbind INDIRIZZO_IP CONTENITORE -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
IP_ADDRESS (obbligatorio)
-
L'indirizzo IP da scollegare.
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore da scollegare.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di annullamento del bind dell'indirizzo IP `192.123.12.12` dal contenitore `proxy`: -``` -bluemix ic ip-unbind 192.123.12.12 proxy -``` - - -### bluemix ic ips -{: #bluemix_ic_ips} - -Elencare gli indirizzi IP a virgola mobile disponibili per l'utente che ha effettuato l'accesso. L'elenco include gli indirizzi IP e l'ID contenitore a cui sono collegati gli indirizzi IP. Se l'indirizzo IP non è in uso, non verrà visualizzato alcun ID contenitore. - -``` -bluemix ic ips [-q] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
-q (facoltativo)
-
Elenca solo gli indirizzi IP, senza l'ID per i contenitori associati a tali indirizzi IP.
-
- - -Esempi: - -Il seguente esempio mostra una richiesta per ricevere un elenco di tutti gli indirizzi IP per l'organizzazione. -``` -bluemix ic ips -q -``` - - -### bluemix ic kill -{: #bluemix_ic_kill} - -Arrestare un processo in esecuzione in un contenitore senza arrestare il contenitore. Per ulteriori informazioni, vedi il comando [kill ](https://docs.docker.com/engine/reference/commandline/kill/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - -``` -bluemix ic kill [-s CMD|--signal CMD] CONTAINER -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
-s CMD|--signal CMD (facoltativo)
-
Inviare un comando al processo in esecuzione nel contenitore.
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
- - -Esempi: - -Il seguente esempio mostra una richiesta di terminazione di un contenitore denominato `proxy`: -``` -bluemix ic kill proxy -``` - - -### bluemix ic logs -{: #bluemix_ic_logs} - -Mostra i log di output o di errore per un contenitore in esecuzione. Per ulteriori informazioni, vedi il comando [logs ](https://docs.docker.com/engine/reference/commandline/logs/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. -``` -bluemix ic logs [OPTIONS] CONTAINER -``` - - -### bluemix ic namespace-get -{: #bluemix_ic_namespace_get} - -Visualizzare il nome del repository di immagini {{site.data.keyword.Bluemix_notm}} privato dell'organizzazione a cui sei collegato. - -``` -bluemix ic namespace-get -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - - -### bluemix ic namespace-set -{: #bluemix_ic_namespace_set} - -Impostare il nome del repository di immagini {{site.data.keyword.Bluemix_notm}} privato dell'organizzazione a cui sei collegato. - -*Limitazione*: non puoi utilizzare un trattino `-` nel nome del tuo spazio dei nomi del repository. - -``` -bluemix ic namespace-set NOME -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
NOME (obbligatorio)
-
Una funzione da eseguire una sola volta per impostare lo spazio dei nomi del repository per la tua organizzazione, se non già impostato. Una volta impostato lo spazio dei nomi, reinizializza IBM Containers attraverso il comando `bluemix ic init` prima di continuare.
-
- - -### bluemix ic pause -{: #pause} - -Mettere in pausa tutti i processi all'interno di un contenitore in esecuzione. Per ulteriori informazioni, vedi il comando [pause ](https://docs.docker.com/engine/reference/commandline/pause/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. Per arrestare un contenitore, vedi il comando [bluemix ic unpause](#unpause). - -``` -bluemix ic pause CONTENITORE -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: -
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
- -Risposte: - -- Contenitore correttamente in pausa. - -- Comando non riuscito con il servizio cloud del contenitore - - `{messaggio}` - - Dove `{messaggio}` è -l'errore correlato. - -- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore - -Esempi: - -Il seguente esempio mostra una richiesta di messa in pausa di un contenitore denominato `proxy`: -``` -bluemix ic pause proxy -``` - - -### bluemix ic port -{: #bluemix_ic_port} - -Elenca le associazioni delle porte o un'associazione specifica del contenitore. Questo comando include il comando `docker port`. Per ulteriori informazioni, vedi il comando [port ](https://docs.docker.com/engine/reference/commandline/port/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - - -### bluemix ic ps -{: #bluemix_ic_ps} -Visualizzare un elenco di contenitori in esecuzione nello spazio dei nomi dell'utente che ha effettuato l'accesso. Per impostazione predefinita, questo comando mostra solo i contenitori in esecuzione. Per ulteriori informazioni, vedi il comando [ps ](https://docs.docker.com/engine/reference/commandline/ps/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - -``` -bluemix ic ps [-a|--all] [--filter env=SEARCH_CRITERIA] [-s|--size] [-l NUM|--limit NUM] [-q|--quiet] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
-a|--all (facoltativo)
-
Visualizzare tutti i contenitori, sia quelli in esecuzione sia quelli arrestati.
-
--filter env=SEARCH_CRITERIA (facoltativo)
-
Cerca i contenitori che hanno uno specifico valore di variabile di ambiente. Puoi filtrare i tuoi contenitori in base a qualsiasi chiave o valore di variabile di ambiente elencato nella sezione Env della tua risposta CLI quando ispezioni un contenitore. Sostituisci SEARCH_CRITERIA con la chiave o valore che stai cercando. I tuoi criteri di ricerca non devono necessariamente essere una corrispondenza esatta.
-
-s|--size (facoltativo)
-
Elencare le dimensioni dei contenitori.
-
-l NUM|--limit NUM (facoltativo)
-
Elencare i contenitori creati più di recente, dove NUM è il numero dei contenitori creati più di recente che desideri restituire.

Ad esempio, se hai creato i contenitori da node1 a node5 in modo sequenziale, il comando bluemix ic ps --limit 2 restituisce node4 e node5 perché sono gli ultimi due contenitori creati.
-
-q|--quiet (facoltativo)
-
Visualizzare solo gli ID contenitore.
-
- - -Esempi: - -Il seguente esempio mostra una richiesta di visualizzazione di tutti i contenitori in esecuzione e arrestati: -``` -bluemix ic ps -a -``` - - -### bluemix ic rename -{: #bluemix_ic_rename} -Rinomina un contenitore. Per ulteriori informazioni, vedi il comando [rename ](https://docs.docker.com/engine/reference/commandline/rename/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - -``` -bluemix ic rename OLD_NAME NEW_NAME -``` -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
OLD_NAME (obbligatorio)
-
Il vecchio nome del contenitore.
-
NEW_NAME (obbligatorio)
-
Il nuovo nome del contenitore.
-
- - -### bluemix ic reprovision -{: #bluemix_ic_reprovision} - -Ricrea il servizio IBM Containers nello spazio Bluemix a cui sei collegato. La quota originale per lo spazio viene mantenuta. - -Importante: quando esegui questo comando, nessuno dei tuoi singoli contenitori e gruppi in questo spazio verrà migrato nello spazio di cui è stato eseguito di nuovo il provisioning e verranno rimossi durante il processo di migrazione. - -``` -bluemix ic reprovision [--force|-f] [ENVIRONMENT_NAME] -``` -Opzioni del comando: - -
-
--force|-f (facoltativo)
-
Forza la nuova creazione del servizio IBM Containers nello spazio Bluemix.
-
AVAILABILITY_ZONE (facoltativo)
-
Il nome della zona di disponibilità IBM Containers in cui vengono distribuiti i tuoi contenitori. Se non si specifica alcuna zona di disponibilità, viene utilizzata la zona predefinita impostata per la regione.
-
- - -### bluemix ic restart -{: #bluemix_ic_restart} - -Riavviare un contenitore. Per ulteriori informazioni, vedi il comando [restart ](https://docs.docker.com/engine/reference/commandline/restart/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - -``` -bluemix ic restart CONTAINER [-t SECS|--time SECS] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
-t SECONDI|--time SECONDI (facoltativo)
-
Il numero di secondi di attesa prima che il contenitore venga riavviato.
-
- - -Risposte: - -- Contenitore riavviato correttamente. - -- Comando non riuscito con il servizio cloud del contenitore - - `{messaggio}` - - Dove `{messaggio}` è -l'errore correlato. - -- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore - -Esempi: - -Il seguente esempio mostra una richiesta di riavvio di un contenitore denominato `proxy`: -``` -bluemix ic restart proxy -``` - - -### bluemix ic rm -{: #bluemix_ic_rm} - -Rimuovere un contenitore. Per ulteriori informazioni, vedi il comando [rm ](https://docs.docker.com/engine/reference/commandline/rm/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - -``` -bluemix ic rm [-f|--force] CONTAINER -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
-f|--force (facoltativo)
-
Forza la rimozione di un contenitore in esecuzione o in errore.
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
- -Risposte: - -- Contenitore rimosso correttamente. - -- Comando non riuscito con il servizio cloud del contenitore - - `{messaggio}` - - Dove `{messaggio}` è -l'errore correlato. - -- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore. - -Esempi: - -Il seguente esempio mostra una richiesta di rimozione di un contenitore denominato `proxy`: -``` -bluemix ic rm proxy -``` - - -### bluemix ic rmi -{: #bluemix_ic_rmi} - -Rimuovere un'immagine dallo spazio dei nomi dell'utente che ha effettuato l'accesso. Per ulteriori informazioni, vedi il comando [rmi ](https://docs.docker.com/engine/reference/commandline/rmi/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - -``` -bluemix ic rmi [-R REGISTRY|--registry REGISTRY] IMAGE -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
-R REGISTRO|--registry REGISTRO (facoltativo)
-
Modificare l'host del registro. Per impostazione predefinita verrà utilizzato il registro che hai specificato nel comando bluemix ic init.
-
IMAGE (obbligatorio)
-
Il nome dell'immagine che desideri rimuovere. Se non viene specificata -una tag nel nome immagine, per impostazione predefinita viene eliminata -l'immagine contrassegnata come latest.
-
- -Risposte: - -- Rimozione di: `{IMMAGINE}` - - Dove `{IMMAGINE}` è il -nome dell'immagine che è stata rimossa. - -- Errore. Nessun host registro specificato. - -- Rimozione dell'immagine non riuscita - Impossibile connettersi al registro cloud del contenitore - -- Comando non riuscito con il servizio cloud del contenitore - - `{messaggio}` - - Dove `{messaggio}` è -l'errore correlato. - -Esempi: - -Il seguente esempio mostra una richiesta di rimozione dell'immagine `mynamespace/myimage:latest`: -``` -bluemix ic rmi registry.ng.bluemix.net/mynamespace/myimage:latest -``` - - -### bluemix ic route-map -{: #bluemix_ic_route_map} - -Stabilire la rotta per il traffico internet da utilizzare per accedere al gruppo di contenitori. Puoi utilizzare questo comando per stabilire una nuova rotta o aggiornarne una esistente. - -``` -bluemix ic route-map [-n HOST|--hostname HOST] [-d DOMAIN|--domain DOMAIN] CONTAINER_GROUP -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
-n HOST|--hostname HOST (facoltativo)
-
Il nome host della rotta. Il nome host costituisce la prima parte dell'URL completo della rotta pubblica, quale ad esempio mycontainerhost nell'URL mycontainerhost.mybluemix.net.
-
-d DOMINIO|--domain DOMINIO (facoltativo)
-
Il nome dominio della rotta, che costituisce la seconda parte dell'URL completo della rotta pubblica. Nella maggior parte dei casi, il dominio è mybluemix.net. Puoi anche utilizzare questo parametro per specificare un dominio privato.
-
GRUPPO_CONTENITORI (obbligatorio)
-
Il nome o l'ID del gruppo di contenitori.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di associazione della rotta del gruppo denominato `GROUP1`, dove `my_host` è il nome host e `mybluemix.net` è il dominio. -``` -bluemix ic route-map -n my_host -d mybluemix.net GROUP1 -``` - - -### bluemix ic route-unmap -{: #bluemix_ic_route_unmap} - -Stabilire la rotta per il traffico internet da utilizzare per accedere al gruppo di contenitori. Puoi utilizzare questo comando per stabilire una nuova rotta o aggiornarne una esistente. - -``` -bluemix ic route-unmap [-n HOST|--hostname HOST] [-d DOMAIN|--domain DOMAIN] CONTAINER_GROUP -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
-n HOST|--hostname HOST (facoltativo)
-
Il nome host della rotta.
-
-d DOMINIO|--domain DOMINIO (facoltativo)
-
Il nome dominio della rotta.
-
GRUPPO_CONTENITORI (obbligatorio)
-
Il nome o l'ID del gruppo di contenitori.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di annullamento dell'associazione della rotta del gruppo denominato `GRUPPO1`, dove `mio_host` è il nome dell'host e `organization.com` è il dominio. -``` -bluemix ic route-unmap -n mio_host -d organization.com GRUPPO1 -``` - - -### bluemix ic run -{: #bluemix_ic_run} - -Avviare un nuovo contenitore nel servizio cloud del contenitore da -un nome immagine. Per ulteriori informazioni, vedi il comando [run ](https://docs.docker.com/engine/reference/commandline/run/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - - -``` -bluemix ic run [-p PORT|--publish PORTA] [-P] [-m MEMORIA|--memory MEMORIA] [-e ENV|--env ENV] [--volume VOLUME:PERCORSO_CONTENITORE] -n NOME|--name NOME [--link NOME:ALIAS] [-it] IMMAGINE [CMD [CMD ...]] -``` -**Nota:** accertati che lo strumento di comando Cloud Foundry sia installato e di disporre di un token Cloud Foundry. Se si accede correttamente tramite `bluemix login` e `bluemix ic init` vengono creati i certificati e i token richiesti. - - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
-p PORTA|--publish PORTA (facoltativo)
-
Esporre la porta per il traffico HTTP. Includi le eventuali porte specificate nel Dockerfile per l'immagine che stai utilizzando. Puoi includere più porte con più opzioni -p. L'esposizione di una porta comporta automaticamente il bind di un indirizzo IP pubblico, se disponibile, al contenitore.

Se disponi già di un indirizzo IP nello spazio che desideri associare mediante bind al contenitore, puoi specificare l'indirizzo IP invece di eseguirne il bind successivamente. L'indirizzo IP deve essere specificato nel seguente formato: <indirizzo_IP>:<porta_contenitore>:<porta_contenitore>

Per ulteriori informazioni sulla richiesta di indirizzi IP per uno spazio, vedi il comando bluemix ic ip-request.

Quando specifichi una porta, stai rendendo l'applicazione disponibile al programma di bilanciamento del carico {{site.data.keyword.Bluemix_notm}} o ai contenitori dello stesso spazio {{site.data.keyword.Bluemix_notm}} che stanno provando a raggiungere l'host. Se nel Dockerfile è specificata una porta per l'immagine che stai utilizzando, includila.

Suggerimenti:
  • Per l'immagine Liberty Server certificata da IBM o una versione modificata di questa immagine, immetti la porta 9080.
  • Per l'immagine Node.js certificata da IBM o una versione modificata di questa immagine, immetti la porta 8000.
-
-P (facoltativo)
-
Esporre automaticamente le porte specificate nel Dockerfile dell'immagine per il traffico HTTP.
-
-m MEMORIA|--memory MEMORIA (facoltativo)
-
Assegnare un limite di memoria al gruppo in MB. Quando crei un gruppo di contenitori dalla CLI, il valore predefinito per ogni istanza del contenitore è 64 MB. Quando crei un gruppo di contenitori dal Dashboard {{site.data.keyword.Bluemix_notm}}, il valore predefinito per ciascuna istanza è 256 MB. I valori accettati sono 64, 256, 512, 1024 e 2048. Una volta assegnato, il limite di memoria non può essere modificato.
-
-e AMB|--env AMB (facoltativo)
-
Impostare la variabile di ambiente, dove AMB è una coppia chiave=valore. In caso di più chiavi, elencale separatamente. Se includi virgolette, fallo racchiudendo sia il valore che il nome della variabile di ambiente. Ad esempio: -e "key1=value1" -e "key2=value2" -e "key3=value3". La seguente tabella mostra alcune variabili di ambiente comunemente utilizzate che puoi specificare:
-
- - -| Variabile di ambiente | Descrizione | -| :----------------------------- | :------------------------------ | -| CCS_BIND_APP=*<nome_applicazione>* | Eseguire il bind di un servizio a un contenitore. Utilizza la variabile di ambiente `CCS_BIND_APP` per eseguire il bind di un'applicazione al contenitore. L'applicazione viene associata mediante bind al servizio di destinazione e funge da ponte che consente a {{site.data.keyword.Bluemix_notm}} di portare le informazioni `VCAP_SERVICES` dell'applicazione ponte nell'istanza del contenitore in esecuzione. Per ulteriori informazioni sulla creazione di un'applicazione ponte, vedi [Esecuzione del bind di un servizio a un contenitore](/docs/containers/container_integrations_binding.html){: new_window}. | -| CCS_BIND_SRV=*<nome_istanza_servizio1>*,*<nome_istanza_servizio2>* | Per eseguire direttamente il bind di un servizio Bluemix a un contenitore senza utilizzare un'applicazione ponte, utilizza CCS_BIND_SRV. Questo bind consente a Bluemix di inserire le informazioni VCAP_SERVICES nell'istanza del contenitore in esecuzione. Per elencare più servizi Bluemix, puoi includerli come parte della stessa variabile di ambiente. | -| LOG_LOCATIONS=*<>percorso_verso_file* | Aggiungere un file di log da monitorare nel contenitore. Includi la variabile di ambiente `LOG_LOCATIONS` in un percorso verso il file di log. | -{: caption="Table 9. Commonly used environment variables" caption-side="top"} - - -
-
--volume VOLUME:PERCORSO_CONTENITORE[:ro] (facoltativo)
-
Collegare un volume a un contenitore, specificando i dettagli nel formato IDVolume:PercorsoContenitore[:ro]. -
    -
  • VOLUME: l'ID o nome del volume.
    • -
  • PERCORSO_CONTENITORE: il percorso assoluto per il volume del contenitore.
    • -
  • ro: facoltativo. La specifica di ro rende il volume di sola lettura invece della lettura/scrittura predefinita.
-
-
-n NOME|--name NOME (facoltativo)
-
Assegnare un nome al contenitore.
Suggerimento: il nome del contenitore deve iniziare con una lettera. Il nome può includere lettere maiuscole, lettere minuscole, numeri, punti., caratteri di sottolineatura _, o trattini -.
-
--link NOME:ALIAS (facoltativo)
-
Ogni volta che desideri che un contenitore comunichi con un altro contenitore in esecuzione, puoi farvi riferimento utilizzando un alias del nome host.
-
-it (facoltativo)
-
Eseguire il contenitore in modalità interattiva. Una volta creato il contenitore, mantieni l'input standard visualizzato. Immetti exit per uscire.
-
IMAGE (obbligatorio)
-
L'immagine da includere nel contenitore. L'immagine può essere seguita da un elenco di comandi, ma non da opzioni. Includi tutte le opzioni prima di specificare un'immagine. Includi tutte le opzioni prima di specificare l'immagine.

Se utilizzi un'immagine nel repository {{site.data.keyword.Bluemix_notm}} privato della tua organizzazione, specificala con il seguente formato: registry.ng.bluemix.net/SPAZIO_NOMI/IMMAGINE.

Se utilizzi un'immagine fornita da IBM Containers, specificala nel seguente formato: registry.ng.bluemix.net/IMMAGINE.
-
CMD (facoltativo)
-
Il comando e gli argomenti trasmessi al gruppo di contenitori per l'esecuzione. Questo comando deve essere un comando a esecuzione prolungata. Non utilizzare un comando di breve durata che non viene eseguito per molto tempo, quale ad esempio /bin/date, poiché tale comando potrebbe provocare un arresto anomalo del contenitore.
-
- - -Esempi: - -Esegui il comando a esecuzione prolungata `sh -c "while true; do date; sleep 20; done"` sul contenitore `mio_contenitore` creato sull'immagine `registry.ng.bluemix.net/ibmnode`. -``` -bluemix ic run --name mio_contenitore registry.ng.bluemix.net/ibmnode -- sh -c "while true; do date; sleep 20; done" -``` - - -Creare e successivamente riavviare un contenitore `proxy` con un limite di memoria di `1024` MB utilizzando l'immagine `mio_spazioNomi/nginx`, dove `mio_spazioNomi` è lo spazio dei nomi associato agli utenti che hanno effettuato l'accesso. -``` -bluemix ic run -n proxy -m 1024 registry.ng.bluemix.net/my_namespace/nginx -``` - -Creare e successivamente riavviare un contenitore utilizzando l'immagine `mio_spazioNomi/blog`, trasmettere le credenziali come variabili di ambiente. `mio_spazioNomi` è lo spazio dei nomi associato agli utenti che hanno effettuato l'accesso. -``` -bluemix ic run -n mio_contenitore -e USER=johnsmith -e PASS=password registry.ng.bluemix.net/mio_spazioNomi/blog -``` - -Aggiungere un volume a un contenitore utilizzando l'immagine `mio_spazioNomi/blog`, dove `mio_spazioNomi` è lo spazio dei nomi associato agli utenti che hanno effettuato l'accesso. -``` -bluemix ic run -n mio_contenitore -v VolId1:/first/path -v VolId2:/second/path registry.ng.bluemix.net/mio_spazioNomi/blog -``` - - -### bluemix ic service-bind -{: #bluemix_ic_service-bind} - -Aggiungi un servizio a un gruppo di contenitori in esecuzione. Questo comando è disponibile solo per i gruppi di contenitori. I singoli contenitori devono essere associati tramite bind a un servizio come parte del comando bluemix ic run. - -``` -bluemix ic service-bind GROUP_NAME SERVICE_INSTANCE -``` -Opzioni del comando: - -
-
NOME GRUPPO (obbligatorio)
-
L'ID o il nome del gruppo.
-
ISTANZA_SERVIZIO (obbligatorio)
-
Il nome dell'istanza del servizio da aggiungere al gruppo di contenitori.
-
- - -### bluemix ic service-unbind -{: #bluemix_ic_service-unbind} - -Rimuovi un servizio da un gruppo di contenitori in esecuzione. Questo comando è disponibile solo per i gruppi di contenitori. I singoli contenitori devono rimuovere il contenitore e crearne uno nuovo senza il servizio. - -``` -bluemix ic service-unbind GROUP_NAME SERVICE_INSTANCE -``` -Opzioni del comando: - -
-
NOME GRUPPO (obbligatorio)
-
L'ID o il nome del gruppo.
-
ISTANZA_SERVIZIO (obbligatorio)
-
Il nome dell'istanza del servizio da aggiungere al gruppo di contenitori.
-
- - -### bluemix ic start -{: #ic_start} -Avviare un contenitore arrestato. Per ulteriori informazioni, vedi il comando [start ](https://docs.docker.com/engine/reference/commandline/start/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. Per arrestare un contenitore, vedi il comando [bluemix ic stop](#ic_stop). - -``` -bluemix ic start CONTENITORE -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
- - -Risposte: - -- Contenitore avviato correttamente. - -- Comando non riuscito con il servizio cloud del contenitore - - `{messaggio}` - - Dove `{messaggio}` è -l'errore correlato. - -- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore - -Esempi: - -Il seguente esempio mostra una richiesta di avvio di un contenitore denominato `proxy`. -``` -bluemix ic start proxy -``` - - -### bluemix ic stats -{: #bluemix_ic_stats} - -Visualizzare le statistiche di utilizzo in tempo reale per uno o più contenitori. Utilizza `CTRL+C` per chiudere. Per ulteriori informazioni, vedi il comando [stats](https://docs.docker.com/engine/reference/commandline/stats/){: new_window} nella guida di Docker. - -``` -bluemix ic stats [--no-stream] CONTENITORE [CONTENITORE] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
--no-stream (facoltativo)
-
Visualizzare solo il risultato più recente, senza includere informazioni precedenti.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di visualizzazione delle statistiche più recenti su un contenitore: -``` -bluemix ic stats --no-stream mio_contenitore -``` - - -### bluemix ic stop -{: #ic_stop} -Arrestare un contenitore in esecuzione. Per ulteriori informazioni, vedi il comando [stop ](https://docs.docker.com/engine/reference/commandline/stop/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. Per avviare un contenitore, vedi il comando [bluemix ic start](#ic_start). - -``` -bluemix ic stop CONTAINER [-t SECS|--time SECS] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
-t SECONDI|--time SECONDI (facoltativo)
-
Il numero di secondi di attesa prima che il contenitore venga arrestato.
-
- -Risposte: - -- Contenitore arrestato correttamente. - -- Comando non riuscito con il servizio cloud del contenitore - - `{messaggio}` - - Dove `{messaggio}` è -l'errore correlato. - -- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore - -Esempi: - -Il seguente esempio mostra una richiesta di arresto di un contenitore denominato `proxy`. -``` -bluemix ic stop proxy -``` - - -### bluemix ic top -{: #bluemix_ic_top} - -Mostrare i processi in esecuzione nel contenitore. Per ulteriori informazioni, vedi il comando [top ](https://docs.docker.com/engine/reference/commandline/top/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - -``` -bluemix ic top CONTENITORE [CONTENITORE] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di visualizzazione dei processi di un contenitore denominato `mio_contenitore`. -``` -bluemix ic top mio_contenitore -``` - - -### bluemix ic unpause -{: #unpause} - -Riprendere tutti i processi all'interno di un contenitore in esecuzione. Per ulteriori informazioni, vedi il comando [unpause ](https://docs.docker.com/engine/reference/commandline/unpause/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. Per mettere in pausa un contenitore, vedi il comando [bluemix ic pause](#pause). - -``` -bluemix ic unpause CONTENITORE -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
- -Risposte: - -- Esecuzione del contenitore ripresa correttamente. - -- Comando non riuscito con il servizio cloud del contenitore - - `{messaggio}` - - Dove `{messaggio}` è -l'errore correlato. - -- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore - -Esempi: - -Il seguente esempio mostra una richiesta di ripresa dell'esecuzione di un contenitore denominato `proxy`: -``` -bluemix ic unpause proxy -``` - - -### bluemix ic unprovision -{: #bluemix_ic_unprovision} - -Elimina il servizio IBM Containers dallo spazio Bluemix a cui sei collegato. - -Attenzione: quando esegui questo comando, tutti i tuoi singoli contenitori e gruppi di contenitori vengono persi. Il tuo spazio sarà ancora disponibile in Bluemix. Per iniziare a utilizzare di nuovo IBM Containers, devi eseguire `bluemix ic reprovision` per effettuare nuovamente il provisioning del servizio IBM Containers. - -``` -bluemix ic reprovision [--force|-f] -``` -Opzioni del comando: - -
-
--force|-f (facoltativo)
-
Forza l'eliminazione di Bluemix dallo spazio Bluemix.
-
- - -### bluemix ic version -{: #bluemix_ic_version} - -Mostrare la versione di Docker e dell'API IBM Containers. - -``` -bluemix ic version -``` - -Prerequisiti: Docker - -Per visualizzare la versione di IBM Containers, eseguire `bluemix ic info`. Per ulteriori informazioni, vedi il comando [version ](https://docs.docker.com/engine/reference/commandline/version/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - - -### bluemix ic volume-create -{: #bluemix_ic_volume_create} - -Creare un volume. - -``` -bluemix ic volume-create NOME_VOLUME NOME_FS -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
NOME_FS (facoltativo)
-
Il nome della condivisione file. Se non viene denominata o non è disponibile alcuna condivisione file, il volume sarà creato nella condivisione file predefinita dello spazio.
-
NOME_VOLUME (obbligatorio)
-
Il nome del volume. Il nome può contenere lettere minuscole, numeri, caratteri di sottolineatura (_) e trattini (-).
-
- - -Esempi: - -Il seguente esempio mostra una richiesta di creazione di un volume. -``` -bluemix ic volume-create volume_name fileshare_name -``` - - -### bluemix ic volume-fs -{: #bluemix_ic_volume_fs} - -Elencare le condivisioni file. - -``` -bluemix ic volume-fs -``` - - -### bluemix ic volume-fs-create -{: #bluemix_ic_volume_fs_create} - -Creare una condivisione file. - -``` -bluemix ic volume-fs-create NOME_CONDIVISIONE_FILE -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
NOME_CONDIVISIONE_FILE (obbligatorio)
-
Il nome della condivisione file. Il nome può contenere lettere minuscole, numeri, caratteri di sottolineatura (_) e trattini (-).
-
- -Esempi: - -Il seguente esempio mostra una richiesta di creazione di una condivisione file. -``` -bluemix ic volume-fs-create my_file_share -``` - - -### bluemix ic volume-fs-flavors -{: #bluemix_ic_volume_fs_flavors} - -Elencare tutte le caratteristiche della condivisione file. - -``` -bluemix ic volume-fs-flavors -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - - -### bluemix ic volume-fs-inspect -{: #bluemix_ic_volume_fs_inspect} - -Ispezionare una condivisione file. - -``` -bluemix ic volume-fs-inspect NOME_CONDIVISIONE_FILE -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
NOME_CONDIVISIONE_FILE (obbligatorio)
-
Il nome della condivisione file.
-
- -Esempi: - -Il seguente esempio è una richiesta di ispezione di una condivisione file, dove `my_file_share` è il nome della condivisione file. -``` -bluemix ic volume-fs-inspect my_file_share -``` - - -### bluemix ic volume-fs-remove -{: #bluemix_ic_volume_fs_remove} - -Rimuovere una condivisione file. - -``` -bluemix ic volume-fs-remove NOME_CONDIVISIONE_FILE -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
NOME_CONDIVISIONE_FILE (obbligatorio)
-
Il nome della condivisione file.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di rimozione di una condivisione file, dove `my_file_share` è il nome della condivisione file. -``` -bluemix ic volume-fs-remove my_file_share -``` - - -### bluemix ic volume-inspect -{: #bluemix_ic_volume_inspect} - -Ispezionare un volume. - -``` -bluemix ic volume-inspect NOME_VOLUME -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
NOME_VOLUME (obbligatorio)
-
Il nome del volume.
-
- -Esempi: - -Il seguente esempio è una richiesta di ispezione di un volume, dove `nome_volume` è il nome del volume. -``` -bluemix ic volume-inspect volume_name -``` - - -### bluemix ic volume-remove -{: #bluemix_ic_volume_remove} - -Rimuovere un volume. - -``` -bluemix ic volume-remove NOME_VOLUME -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - -Opzioni del comando: - -
-
NOME_VOLUME (obbligatorio)
-
Il nome del volume.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di rimozione di un volume, dove `nome_volume` è il nome del volume. -``` -bluemix ic volume-remove nome_volume -``` - - -### bluemix ic volumes -{: #bluemix_ic_volumes} - -Elencare i volumi. - -``` -bluemix ic volumes -``` - -Prerequisiti: Endpoint, Accesso, Destinazione - - -### bluemix ic wait -{: #bluemix_ic_wait} - -Chiudere un contenitore e visualizzare il codice di uscita come conferma. Per ulteriori informazioni, vedi il comando [wait ](https://docs.docker.com/engine/reference/commandline/wait/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. - -``` -bluemix ic wait CONTENITORE [CONTENITORE] -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di chiusura di un contenitore denominato `mio_contenitore`: -``` -bluemix ic wait mio_contenitore -``` - - -### bluemix ic wait-status -{: #bluemix_ic_wait_status} - -Attendere che un singolo contenitore o gruppo di contenitori raggiunga lo stato non temporaneo. Durante questo tempo di attesa, la riga di comando non viene restituita e non puoi immettere i comandi. Non appena il contenitore raggiunge lo stato non temporaneo, viene visualizzato il messaggio OK. Per i singoli contenitori, gli stati non temporanei includono In esecuzione, Arresto, Arresto anomalo, In pausa o Sospeso. Per i gruppi di contenitori, gli stati non temporanei includono CREATE_COMPLETE, UPDATE_COMPLETE o FAILED - -``` -bluemix ic wait-status CONTAINER -``` - -Prerequisiti: Endpoint, Accesso, Destinazione, Docker - -Opzioni del comando: - -
-
CONTAINER (obbligatorio)
-
Il nome o l'ID del contenitore.
-
- -Esempi: - -Il seguente esempio mostra una richiesta di chiusura di un contenitore denominato `mio_contenitore`: -``` -bluemix ic wait mio_contenitore -``` - - - -# Link correlati -{: #rellinks} - -## Link correlati -{: #general} - -* [bx tool ](http://clis.ng.bluemix.net/ui/home.html){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) +--- + + + +copyright: + + years: 2015, 2017 +lastupdated: "2017-02-16" + +--- + + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Introduzione alla CLI {{site.data.keyword.Bluemix_notm}} +{: #getting-started} + +La CLI {{site.data.keyword.Bluemix_notm}} ti fornisce un modo unico di interagire con le tue applicazioni, server virtuali, contenitori e altri servizi utilizzando un'interfaccia riga di comando. La CLI {{site.data.keyword.Bluemix_notm}} integra inoltre gli strumenti della community, come le CLI Cloud Foundry, Docker e OpenStack e inizializza le impostazioni dell'ambiente per interagire con diversi tipi di calcolo. + +**Restrizione**: la CLI {{site.data.keyword.Bluemix_notm}} non è supportata da Cygwin, per cui non utilizzare la CLI {{site.data.keyword.Bluemix_notm}} nella finestra della riga di comando di Cygwin. + +**Nota**: se la tua rete contiene un server proxy HTTP tra l'host che esegue la CLI e {{site.data.keyword.Bluemix_notm}}, devi specificare il nome host o l'indirizzo IP del server proxy nella variabile di ambiente HTTP_PROXY. + +## Installazione della CLI {{site.data.keyword.Bluemix_notm}} +{: #install_bluemix_cli} + +Prima di installare la CLI {{site.data.keyword.Bluemix_notm}}, installa la [CLI cf ![icona link esterno](../../../icons/launch-glyph.svg)](https://github.com/cloudfoundry/cli/releases){: new_window}. + +Per Mac OS e Windows, scarica il [pacchetto CLI {{site.data.keyword.Bluemix_notm}}](/docs/cli/index.html#downloads) ed esegui il programma di installazione. + +Per Linux, segui la seguente procedura: + + 1. Scarica il pacchetto ed estrailo. Ad +esempio: + + ``` + ~$ tar -xvf Bluemix_CLI.tar.gz + Bluemix_CLI/ + Bluemix_CLI/update_global_config + Bluemix_CLI/install_bluemix_cli + Bluemix_CLI/bx/ + Bluemix_CLI/bx/bash_autocomplete + Bluemix_CLI/bx/zsh_autocomplete + Bluemix_CLI/bin/ + Bluemix_CLI/bin/bluemix + ~$ + ``` + + 2. Passa alla directory `Bluemix_CLI` ed esegui il comando `./install_bluemix_cli` con l'autorizzazione root. Puoi eseguire il comando come utente root o utilizzare il comando `sudo` per ottenere l'autorizzazione root. Ad +esempio: + + ``` + ~# cd Bluemix_CLI + ~/Bluemix_CLI# sudo ./install_bluemix_cli + Superuser privileges are required to run this script. + The Cloud Foundry CLI version 6.15 is already installed. + Copying files... + The Bluemix CLI installed successfully. To get started, open a new Linux terminal and enter "bluemix help", or enter "bx help" as short name. + ~/Bluemix_CLI# + ``` + +Puoi ora iniziare a utilizzare la CLI {{site.data.keyword.Bluemix_notm}} o installare ulteriori plug-in. + +## Installazione di un plugin +{: #install_plug-in} + +Come la CLI Cloud Foundry, la CLI {{site.data.keyword.Bluemix_notm}} supporta un framework di estensione plug-in per integrare altri comandi oltre a quelli già integrati. + +Per installare un plugin dal tuo ambiente locale, completa la seguente procedura: + + 1. Scarica il plug-in. Ad +esempio: + + ``` + ~$ wget http://public.dhe.ibm.com/cloud/bluemix/cli/bluemix-plugins/auto-scaling-darwin-amd64.0.2.2--2016-02-18 14:02:12-- http://public.dhe.ibm.com/cloud/bluemix/cli/bluemix-plugins/auto-scaling-darwin-amd64.0.2.2 + Resolving public.dhe.ibm.com... 9.17.248.112 + Connection to public.dhe.ibm.com|9.17.248.112|:80... connected. + HTTP request sent, awaiting response... 200 OK + Length: 9857792 (9.4M) [text/plain] + Saving to: 'auto-scaling-darwin-amd64-0.2.2' + + auto-scaling-darwin-0.2.2 100%[===================>] 9.40M 518KB/s in 22s + + 2016-02-18 14:02:34 (443 KB/s) - `auto-scaling-darwin-amd64-0.2.2' saved [9857792/9857792] + ``` + + 2. Per un sistema simile a Unix, devi rendere eseguibile il file scaricato utilizzando il comando `chmod`. Ad +esempio: + + ``` + ~$ sudo chmod 755 auto-scaling-darwin-amd64-0.2.2 + Password: + ~$ + ``` + + 3. Installa il plug-in utilizzando il comando `bluemix plugin install`. Ad +esempio: + + ``` + ~$ bluemix plugin install ./auto-scaling-darwin-amd64-0.2.2 + Installing pluign './auto-scaling-darwin-amd64-0.2.2'... + OK + Plugin 'auto-scaling 0.2.2' was successfully installed. + ~$ + ``` + +Per l'installazione da un server remoto, attieniti alla seguente procedura: + + 1. Installa il plug-in da un URL remoto direttamente utilizzando il comando `bluemix plugin install`. Ad +esempio: + + ``` + ~$ bluemix plugin install http://public.dhe.ibm.com/cloud/bluemix/cli/bluemix-plugins/auto-scaling-darwin-amd64-0.2.2 + Attempting to download the binary file... + 9857792 bytes downloaded + Installing plugin '/var/folder/v7/l3hnkz0x0b9b5mf1fyxh7yw00000gn/T/BluemixFileDownload274645142/auto-scaling-darwin-adm64-0.2.2'... + OK + Plugin 'auto-scaling 0.2.2' was successfully installed. + ~$ + ``` + +Puoi inoltre installare un plugin dal repository. {{site.data.keyword.Bluemix_notm}} dispone di repository che ospitano i plugin della CLI {{site.data.keyword.Bluemix_notm}} e plugin della CLI Cloud Foundry: + + * [Repository di plug-in CLI Cloud Foundry ](http://clis.ng.bluemix.net/ui/repository.html#cf-plugins){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg), che contiene i plug-in per la CLI di Cloud Foundry. + * [Repository di plug-in CLI {{site.data.keyword.Bluemix_notm}}](http://clis.ng.bluemix.net/ui/repository.html#bluemix-plugins){: new_window} ![Icona link esterno](../../../icons/launch-glyph.svg), che contiene i plug-in specifici per la CLI {{site.data.keyword.Bluemix_notm}}. + +Per l'installazione da un repository, attieniti alla seguente procedura: + + 1. Trova il plug-in nel repository. Dopo aver installato la CLI {{site.data.keyword.Bluemix_notm}}, il repository ufficiale `Bluemix` viene aggiunto per impostazione predefinita. Puoi elencare i plugin nel repository `Bluemix` utilizzando il comando `bluemix plugin repo-plugins`. Ad +esempio: + + ``` + ~$ bluemix plugin repo-plugins -r Bluemix + Getting plug-ins from repository 'Bluemix'... + + Repository: Bluemix + Name Description Versions + auto-scaling Bluemix CLI plugin for Auto-Scaling service 0.2.1, 0.2.2 + nsg Bluemix Network Security Group plugin 0.1.1 + + ~$ + ``` + + 2. Installa il plug-in dal repository `Bluemix` utilizzando il comando `bluemix plugin install`. Ad +esempio: + + ``` + ~$ bluemix plugin install auto-scaling -r Bluemix + Looking up 'auto-scaling' from repository 'Bluemix'... + 9857792 bytes downloaded + Installing plugin '/var/folder/v7/l3hnkz0x0b9b5mf1fyxh7yw00000gn/T/BluemixFileDownload062468676/auto-scaling-darwin-adm64-0.2.2'... + OK + Plugin 'auto-scaling 0.2.2' was successfully installed. + ~$ + ``` + +## Accesso alla CLI {{site.data.keyword.Bluemix_notm}} +{: #log_bmcli} + +Dopo aver installato la CLI {{site.data.keyword.Bluemix_notm}}, puoi accedere a {{site.data.keyword.Bluemix_notm}} utilizzando il tuo ID IBM e password. Ad +esempio: + +``` +~$ bluemix login -a https://api.ng.bluemix.net +API endpoint: https://api.ng.bluemix.net + +Email> demo_user@foo.com + +Password> +Authenticating... +OK +``` + +Sei ora pronto a utilizzare i comandi integrati di {{site.data.keyword.Bluemix_notm}}. Ad esempio, esegui il comando `bluemix catalog templates` per elencare tutti i template di contenitore tipo {{site.data.keyword.Bluemix_notm}} disponibili: + +``` +~$ bluemix catalog templates +Listing Bluemix boilerplate templates... + +ID Name +pi-wdc-java-starter Personality Insights Java Web Starter +xpages-starter XPages Web Starter +mobileBackendStarter Mobile Cloud +pi-wdc-nodejs-starter Personality Insights Node.js Web Starter +mobileFirstPlatform MobileFirst Services Starter +xspHelloWorld IBM XPages +javacloudantbp Java Cloudant Web Starter +``` + +# Comandi {{site.data.keyword.Bluemix_notm}} (bx) +{: #bluemix_cli} + +Versione: 0.4.6 + +L'interfaccia di riga comando (CLI) {{site.data.keyword.Bluemix_notm}} fornisce una serie di comandi che vengono raggruppati in base allo spazio dei nomi per consentire agli utenti di interagire con {{site.data.keyword.Bluemix_notm}}. Alcuni comandi {{site.data.keyword.Bluemix_notm}} incapsulano comandi cf esistenti, mentre altri forniscono funzionalità estese agli utenti {{site.data.keyword.Bluemix_notm}}. Le seguenti informazioni elencano i comandi supportati dalla CLI {{site.data.keyword.Bluemix_notm}} e includono i relativi nomi, opzioni, utilizzo, prerequisiti, descrizioni ed esempi. +{:shortdesc} + +**Nota:** i *Prerequisiti* elencano quali azioni sono richieste prima di utilizzare il comando. I comandi che non hanno azioni prerequisite elencano **Nessuno**. Altrimenti, i prerequisiti possono includere una o più delle seguenti azioni: + +
+
Endpoint
+
Un endpoint API deve essere impostato mediante bluemix api prima di utilizzare il comando.
+
Accesso
+
L'accesso utilizzando il comando bluemix login è richiesto prima di utilizzare questo comando. Se stai eseguendo l'accesso con l'ID federato, utilizza l'opzione '--sso' per autenticarti con il passcode temporale.
+
Destinazione
+
Il comando bluemix target deve essere utilizzato per impostare un'organizzazione e uno spazio prima di utilizzare questo comando.
+
Docker
+
Per poter eseguire questo comando, è necessario che la CLI Docker (docker) sia installata.
+
+ +## indice comandi bluemix +{: #bx_commands_index} + +Utilizza gli indici delle seguenti tabelle per fare riferimento ai comandi bluemix più utilizzati. + +**Nota:** puoi utilizzare il formato breve dei comandi bluemix; ad esempio `bx api` è l'abbreviazione di `bluemix api`. + + + + + + + + + + + + + + + + + + + + + +
Tabella 1. Comandi bluemix generali
Comandi bluemix generali
[bluemix help](index.html#bluemix_help)[bluemix api](index.html#bluemix_api)[bluemix_login](index.html#bluemix_login)[bluemix logout](index.html#bluemix_logout)[bluemix target](index.html#bluemix_target)
[bluemix info](index.html#bluemix_info) [bluemix config](index.html#bluemix_config)[bluemix curl](index.html#bluemix_curl)
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Tabella 2. Comandi per la gestione di organizzazioni, spazi e utenti
Comandi per la gestione di organizzazioni, spazi e utenti
[bluemix iam orgs](index.html#bluemix_iam_orgs)[bluemix iam org](index.html#bluemix_iam_org)[bluemix iam org-create](index.html#bluemix_iam_org_create)[bluemix iam org-replicate](index.html#bluemix_iam_org_replicate)[bluemix iam org-rename](index.html#bluemix_iam_org_rename)
[bluemix iam org-delete](index.html#bluemix_iam_org_delete)[bluemix iam spaces](index.html#bluemix_iam_spaces)[bluemix iam space](index.html#bluemix_iam_space)[bluemix iam space-create](index.html#bluemix_iam_space_create)[bluemix iam space-rename](index.html#bluemix_iam_space_rename)
[bluemix iam space-delete](index.html#bluemix_iam_space_delete)[bluemix iam account-users](index.html#bluemix_iam_account_users)[bluemix iam account-users-delete](index.html#bluemix_iam_account_users_delete)[bluemix iam account-user-invite](index.html#bluemix_iam_account_user_invite)[bluemix iam account-user-reinvite](index.html#bluemix_iam_account_user_reinvite)[bluemix iam org-users](index.html#bluemix_iam_org_users)
[bluemix iam org-user-add](index.html#bluemix_iam_org_user_add)[bluemix iam org-user-remove](index.html#bluemix_iam_org_user_remove)[bluemix iam org-role-set](index.html#bluemix_iam_org_role_set)[bluemix iam org-role-unset](index.html#bluemix_iam_org_role_unset)[bluemix iam space-users](index.html#bluemix_iam_space_users)[bluemix iam space-role-set](index.html#bluemix_iam_space_role_set)
[bluemix iam space-role-unset](index.html#bluemix_iam_space_role_unset)
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Tabella 3. Comandi per la gestione di applicazioni cf
Comandi per la gestione di applicazioni cf
[bluemix app push](index.html#bluemix_app_push)[bluemix app list](index.html#bluemix_app_list)[bluemix app show](index.html#bluemix_app_show)[bluemix app scale](index.html#bluemix_app_scale)[bluemix app delete](index.html#bluemix_app_delete)
[bluemix app rename](index.html#bluemix_app_rename)[bluemix app start](index.html#bluemix_app_start)[bluemix app stop](index.html#bluemix_app_stop)[bluemix app restart](index.html#bluemix_app_restart)[bluemix app restage](index.html#bluemix_app_restage)
[bluemix app instance-restart](index.html#bluemix_app_instance_restart)[bluemix app events](index.html#bluemix_app_events)[bluemix app files](index.html#bluemix_app_files)[bluemix app logs](index.html#bluemix_app_logs)[bluemix app env](index.html#bluemix_app_env)
[bluemix app env-set](index.html#bluemix_app_env_set)[bluemix app env-unset](index.html#bluemix_app_env_unset)[bluemix app stacks](index.html#bluemix_app_stacks)[bluemix app stack](index.html#bluemix_app_stack)[bluemix app manifest-create](index.html#bluemix_app_manifest_create)
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Tabella 4. Comandi per la gestione dei servizi Bluemix
Comandi per la gestione dei servizi Bluemix
[bluemix service offerings](index.html#bluemix_service_offerings)[bluemix service list](index.html#bluemix_service_list)[bluemix service show](index.html#bluemix_service_show)[bluemix service create](index.html#bluemix_service_create)[bluemix service update](index.html#bluemix_service_update)
[bluemix service delete](index.html#bluemix_service_delete)[bluemix service rename](index.html#bluemix_service_rename)[bluemix service bind](index.html#bluemix_service_bind)[bluemix service unbind](index.html#bluemix_service_unbind)[bluemix service key-create](index.html#bluemix_service_key_create)
[bluemix service key-delete](index.html#bluemix_service_key_delete)[bluemix service keys](index.html#bluemix_service_keys)[bluemix service key-show](index.html#bluemix_service_key_show)[bluemix service user-provided-create](index.html#bluemix_service_user_provided_create)[bluemix service user-provided-update](index.html#bluemix_service_user_provided_update)
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Tabella 5. Comandi per la gestione delle impostazioni di sicurezza, dei plug-in, della fatturazione e del catalogo Bluemix
Comandi per la gestione delle impostazioni di sicurezza, dei plug-in, della fatturazione e del catalogo Bluemix
[bluemix catalog templates](index.html#bluemix_catalog_templates)[bluemix catalog template](index.html#bluemix_catalog_template)[bluemix catalog template-run](index.html#bluemix_catalog_template_run)[bluemix plugin repos](index.html#bluemix_plugin_repos)[bluemix plugin repo-add](index.html#bluemix_plugin_repo_add)
[bluemix plugin repo-remove](index.html#bluemix_plugin_repo_remove)[bluemix plugin repo-plugins](index.html#bluemix_plugin_repo_plugins)[bluemix plugin list](index.html#bluemix_plugin_list)[bluemix plugin install](index.html#bluemix_plugin_install)[bluemix plugin uninstall](index.html#bluemix_plugin_uninstall)
[bluemix bss account-usage](index.html#bluemix_bss_account_usage)[bluemix bss org-usage](index.html#bluemix_bss_org_usage)[bluemix bss orgs-usage-summary](index.html#bluemix_orgs_usage_summary)[bluemix security cert](index.html#bluemix_security_cert)[bluemix security cert-add](index.html#bluemix_security_cert_add)
[bluemix security cert-remove](index.html#bluemix_security_cert_remove)
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Tabella 6. Comandi per la gestione delle impostazioni di rete
Comandi per la gestione delle impostazioni di rete
[bluemix network regions](index.html#bluemix_network_regions)[bluemix network region-set](index.html#bluemix_network_region_set)[bluemix network routes](index.html#bluemix_network_routes)[bluemix network route-check](index.html#bluemix_network_route_check)[bluemix network route-map](index.html#bluemix_network_route_map)
[bluemix network route-unmap](index.html#bluemix_network_route_unmap)[bluemix network route-create](index.html#bluemix_network_route_create)[bluemix network route-delete](index.html#bluemix_network_route_delete)[bluemix network orphaned-routes-delete](index.html#bluemix_network_orphaned_routes_delete)[bluemix network domains](index.html#bluemix_network_domains)
[bluemix network domain-create](index.html#bluemix_network_domain_create)[bluemix network domain-delete](index.html#bluemix_network_domain_delete)[bluemix network shared-domain-create](index.html#bluemix_network_shared_domain_create)[bluemix network shared-domain-delete](index.html#bluemix_network_shared_domain_delete)
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Tabella 7. Comandi per la gestione dei contenitori in Bluemix
Comandi per la gestione dei contenitori in Bluemix
[bluemix ic attach](index.html#bluemix_ic_attach)[bluemix ic build](index.html#bluemix_ic_build)[bluemix ic cp](index.html#bluemix_ic_cp)[bluemix ic cpi](index.html#bluemix_ic_cpi)[bluemix ic exec](index.html#bluemix_ic_exec)
[bluemix ic group-create](index.html#bluemix_ic_group_create)[bluemix ic group-inspect](index.html#bluemix_ic_group_inspect)[bluemix ic group-instances](index.html#bluemix_ic_group_instances)[bluemix ic group-remove](index.html#bluemix_ic_group_remove)[bluemix ic group-update](index.html#bluemix_ic_group_update)
[bluemix ic groups](index.html#bluemix_ic_groups)[bluemix ic info](index.html#bluemix_ic_info)[bluemix ic init](index.html#bluemix_ic_init)[bluemix ic images](index.html#bluemix_ic_images)[bluemix ic inspect](index.html#bluemix_ic_inspect)
[bluemix ic ip-bind](index.html#bluemix_ic_ip_bind)[bluemix ic ip-release](index.html#bluemix_ic_ip_release)[bluemix ic ip-request](index.html#ip_request)[bluemix ic ip-unbind](index.html#bluemix_ic_ip_unbind)[bluemix ic ips](index.html#bluemix_ic_ips)
[bluemix ic kill](index.html#bluemix_ic_kill)[bluemix ic logs](index.html#bluemix_ic_logs)[bluemix ic namespace-get](index.html#bluemix_ic_namespace_get)[bluemix ic namespace-set](index.html#bluemix_ic_namespace_set)[bluemix ic pause](index.html#pause)
[bluemix ic port](index.html#bluemix_ic_port)[bluemix ic ps](index.html#bluemix_ic_ps)[bluemix ic rename](index.html#bluemix_ic_rename)[bluemix ic reprovision](index.html#bluemix_ic_reprovision)[bluemix ic restart](index.html#bluemix_ic_restart)
[bluemix ic rm](index.html#bluemix_ic_rm)[bluemix ic rmi](index.html#bluemix_ic_rmi)[bluemix ic route-map](index.html#bluemix_ic_route_map)[bluemix ic route-unmap](index.html#bluemix_ic_route_unmap)[bluemix ic run](index.html#bluemix_ic_run)
[bluemix ic service-bind](index.html#bluemix_ic_service-bind)[bluemix ic service-unbind](index.html#bluemix_ic_service-unbind)[bluemix ic start](index.html#ic_start)[bluemix ic stats](index.html#bluemix_ic_stats)[bluemix ic stop](index.html#ic_stop)
[bluemix ic top](index.html#bluemix_ic_top)[bluemix ic unpause](index.html#unpause)[bluemix ic unprovision](index.html#bluemix_ic_unprovision)[bluemix ic volume-inspect](index.html#bluemix_ic_volume_inspect)[bluemix ic volume-create](index.html#bluemix_ic_volume_create)
[bluemix ic volume-fs](index.html#bluemix_ic_volume_fs)[bluemix ic volume-fs-create](index.html#bluemix_ic_volume_fs_create)[bluemix ic volume-fs-remove](index.html#bluemix_ic_volume_fs_remove)[bluemix ic volume-fs-inspect](index.html#bluemix_ic_volume_fs_inspect)[bluemix ic volume-fs-flavors](index.html#bluemix_ic_volume_fs_flavors)
[bluemix ic volume-remove](index.html#bluemix_ic_volume_remove)[bluemix ic volumes](index.html#bluemix_ic_volumes)[bluemix ic wait](index.html#bluemix_ic_wait)[bluemix ic wait-status](index.html#bluemix_ic_wait_status)[bluemix ic version](index.html#bluemix_ic_version)
+ + +### bluemix help +{: #bluemix_help} +Visualizzare la guida generale per i comandi integrati di primo livello e gli spazi dei nomi supportati della CLI {{site.data.keyword.Bluemix_notm}} oppure la guida per un comando o uno spazio dei nomi integrati specifici. + +``` +bluemix help [COMMAND|NAMESPACE] +``` + +Prerequisiti: Nessuno + +Opzioni del comando: + +
+
COMANDO|SPAZIO_DEI_NOMI (facoltativo)
+
Il comando o lo spazio dei nomi per cui viene visualizzata la guida. Se non viene specificata, viene visualizzata la guida generale per la CLI {{site.data.keyword.Bluemix_notm}}.
+
+ + + +Esempi: + +Visualizzare la guida generale per la CLI {{site.data.keyword.Bluemix_notm}}: + +``` +bluemix help +``` + +Visualizzare la guida per il comando `info`: + +``` +bluemix help info +``` + +Visualizzare la guida per il plug-in `ic`: + +``` +bluemix help ic +``` + +o + +``` +bluemix ic help +``` + +Visualizzare la guida per il comando `group-create` sotto il plug-in `ic`: + +``` +bluemix ic help group-create +``` + + +### bluemix api +{: #bluemix_api} +Impostare o visualizzare l'endpoint API {{site.data.keyword.Bluemix_notm}}. Questo comando include il comando `cf api`. + +``` +bluemix api [API_ENDPOINT] [--unset] +``` + +Prerequisiti: Nessuno + +Opzioni del comando: +
+
ENDPOINT_API (facoltativo)
+
L'endpoint API di destinazione, ad esempio `https://api.chinabluemix.net`. Se non vengono specificate entrambe le opzioni *ENDPOINT_API* e `--unset`, viene visualizzato l'endpoint API corrente.
+
--unset (facoltativo)
+
Rimuovere l'impostazione di endpoint API.
+
+Esempi: + +Impostare l'endpoint API su api.chinabluemix.net: + +``` +bluemix api api.chinabluemix.net +``` + +Visualizzare l'endpoint API corrente: + +``` +bluemix api +``` + +Annullare l'impostazione dell'endpoint API: + +``` +bluemix api --unset +``` + + +### bluemix login +{: #bluemix_login} + +Eseguire l'accesso dell'utente. Questo comando include il comando `cf login`. Le opzioni di comando sono le stesse del comando `cf login`. + +``` +bluemix login [OPZIONI...] +``` + +Prerequisiti: Endpoint + + + +Opzioni del comando: +Per informazioni sulle opzioni supportate dal comando `login`, vedi le informazioni sull'utilizzo del comando `cf login` per i comandi cf per la gestione delle applicazioni. + +Nota: +Se stai eseguendo l'accesso con l'ID federato, utilizza l'opzione '--sso' per autenticarti con il passcode temporale. + +### bluemix logout +{: #bluemix_logout} + +Disconnettere l'utente. Questo comando include il comando `cf logout`. + +``` +bluemix logout +``` + +Prerequisiti: Nessuno + + +### bluemix target +{: #bluemix_target} + + +Impostare o visualizzare l'organizzazione o lo spazio di destinazione. Questo comando include il comando `cf target`. + +``` +bluemix target [-o ORG_NAME] [-s SPACE_NAME] +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
-o NOME_ORGANIZZAZIONE (facoltativo)
+
Il nome dell'organizzazione di destinazione.
+
-s NOME_SPAZIO (facoltativo)
+
Il nome dello spazio di destinazione.
+
+Se non viene specificata né l'opzione -o *NOME_ORGANIZZAZIONE* né quella -s *NOME_SPAZIO*, vengono visualizzati l'organizzazione e lo spazio correnti. +Esempi: + +Impostare l'organizzazione corrente su `MyOrg` e lo spazio su `MySpace`: + +``` +bluemix target -o MyOrg -s MySpace +``` + +Visualizzare l'organizzazione e lo spazio correnti: + +``` +bluemix target +``` + + +### bluemix info +{: #bluemix_info} + +Visualizzare le informazioni su {{site.data.keyword.Bluemix_notm}} di base, compresi la regione corrente, la versione controller cloud e alcuni utili endpoint, quali gli endpoint per l'accesso e per lo scambio di token di accesso. + +``` +bluemix info +``` + +Prerequisiti: Endpoint + + +### bluemix config +{: #bluemix_config} + + +Scrivere i valori predefiniti nel file di configurazione. + +``` +bluemix config --http-timeout TIMEOUT_IN_SECONDS | --trace (true|false|path/to/file) | --color (true|false) | --locale (LOCALE|CLEAR) | --check-version (true|false) +``` + +Prerequisiti: Nessuno + +Opzioni del comando: +
+
--http-timeout TIMEOUT_IN_SECONDS
+
Il valore di timeout per le richieste HTTP. Il valore predefinito è 60 secondi.
+
--trace true|false|path-to-file
+
Traccia le richieste HTTP nel terminale o file specificato.
+
--color true|false
+
Abilita o disabilita l'output a colori. L'output a colori è abilitato per impostazione predefinita.
+
--locale LOCALE|CLEAR
+
Imposta una locale predefinita. Se la LOCALE è CLEAR, la locale precedente viene eliminata.
+
--check-version true|false
+
Abilita o disabilita il controllo della versione della CLI
+
+ +È possibile specificare solo una di queste opzioni alla volta. + +Esempi: + +Impostare il timeout della richiesta HTTP su 30 secondi: + +``` +bluemix config --http-timeout 30 +``` + +Abilitare l'output di traccia per le richieste HTTP: + +``` +bluemix config --trace true +``` + +Traccia le richieste HTTP in un file specificato */home/usera/my_trace*: + +``` +bluemix config --trace /home/usera/my_trace +``` + +Disabilitare l'output a colori: + +``` +bluemix config --color false +``` + +Impostare la locale su zh_Hans: + +``` +bluemix config --locale zh_Hans +``` + +Cancellare le impostazioni della locale: + +``` +bluemix config --locale CLEAR +``` + + +### bluemix curl +{: #bluemix_curl} + +Eseguire una richiesta HTTP raw per {{site.data.keyword.Bluemix_notm}}. *Content-Type* è impostato su *application/json* come valore predefinito. Questo comando invia la richiesta al MCCP (Multi Cloud Control Proxy) {{site.data.keyword.Bluemix_notm}}. Per i percorsi supportati, fai riferimento alle definizioni del percorso API nella [Documentazione API CloudFoundry ](http://apidocs.cloudfoundry.org/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg). + +``` +bluemix curl PERCORSO [OPZIONI...] +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
PERCORSO (obbligatorio)
+
Il percorso URL della risorsa. Ad esempio, /v2/apps.
+
OPZIONI (facoltativo)
+
Le opzioni supportate dal comando `bluemix curl` sono le stesse del comando `cf curl`.
+
+ +Esempi: + +Visualizzare le informazioni per tutte le organizzazioni dell'account corrente: + +``` +bluemix curl /v2/organizations +``` + + +### bluemix iam orgs +{: #bluemix_iam_orgs} + +Elencare tutte le organizzazioni + +``` +bluemix iam orgs [-r REGION --guid] +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
-r REGIONE (facoltativo)
+
Regione per cui vengono visualizzare le informazioni sull'organizzazione. Se impostato su 'all', vengono elencate tutte le organizzazioni in tutte le regioni.
+
--guid (facoltativo)
+
Visualizzare il GUID delle organizzazioni.
+
+ +Esempi: + +Elencare tutte le organizzazioni della regione: `us-south` con il GUID visualizzato + +``` +bluemix iam orgs -r us-south --guid +``` + +### bluemix iam org +{: #bluemix_iam_org} + +Visualizzare le informazioni per l'organizzazione specificata. + +``` +bluemix iam org ORG_NAME [--guid] +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Il nome dell'organizzazione.
+
--guid (facoltativo)
+
Visualizzare il GUID dell'organizzazione.
+
+ +Esempi: + +Mostrare le informazioni dell'organizzazione `IBM` con il GUID visualizzato + +``` +bluemix iam org IBM --guid +``` + +### bluemix iam org-create +{: #bluemix_iam_org_create} + +Creare una nuova organizzazione. Questa operazione può essere eseguita solo dal proprietario dell'account. + +``` +bluemix iam org-create ORG_NAME +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Il nome dell'organizzazione in fase di creazione.
+
+ +Esempi: + +Creare un'organizzazione denominata `IBM`. + +``` +bluemix iam org-create IBM +``` + + +### bluemix iam org-replicate +{: #bluemix_iam_org_replicate} + +Replicare un'organizzazione dalla regione corrente in un'altra regione. + +``` +bluemix iam org-replicate ORG_NAME REGION_NAME +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Il nome dell'organizzazione esistente che deve essere replicata.
+
NOME_REGIONE (obbligatorio)
+
Il nome della regione che ospita l'organizzazione replicata.
+
+ +Esempi: + +Replicare l'organizzazione `myorg` nella regione `eu-gb`: + +``` +bluemix iam org-replicate myorg eu-gb +``` + + +### bluemix iam org-rename +{: #bluemix_iam_org_rename} + +Rinominare un'organizzazione. Questa operazione può essere eseguita solo da un gestore organizzazione. + +``` +bluemix iam org-rename OLD_ORG_NAME NEW_ORG_NAME +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
NOME_ORG_PRECEDENTE (obbligatorio)
+
Il vecchio nome dell'organizzazione da rinominare.
+
NUOVO_NOME_ORG (obbligatorio)
+
Il nuovo nome con cui viene rinominata l'organizzazione.
+
+ +### bluemix iam org-delete +{: #bluemix_iam_org_delete} + +Eliminare l'organizzazione specificata nella regione corrente. + +``` +bluemix iam org-delete ORG_NAME [-f --all] +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Il nome dell'organizzazione esistente che deve essere eliminata.
+
-f (facoltativo)
+
Forzare l'eliminazione senza conferma.
+
--all (facoltativo)
+
Eliminare l'organizzazione da tutte le regioni.
+
+ + +### bluemix iam spaces +{: #bluemix_iam_spaces} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf spaces`. + + +### bluemix iam space +{: #bluemix_iam_space} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf space`. + + +### bluemix iam space-create +{: #bluemix_iam_space_create} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-space`. + + +### bluemix iam space-rename +{: #bluemix_iam_space_rename} + + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf rename-space`. + + +### bluemix iam space-delete +{: #bluemix_iam_space_delete} + + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-space`. + + +### bluemix iam account-users +{: #bluemix_iam_account_users} + +Visualizza gli utenti associati con l'account. Questa operazione può essere eseguita solo dal proprietario dell'account. + +``` +bluemix iam account-users +``` + +### bluemix iam account-user-invite +{: #bluemix_iam_account_user_invite} + + +Invita un utente nell'account con un'organizzazione e un ruolo spazio già impostati. Questa operazione può essere eseguita solo dal proprietario dell'account. + +``` +bluemix iam account-user-invite USER_NAME ORG_NAME ORG_ROLE SPACE_NAME SPACE_ROLE +``` + +Prerequisiti: Endpoint, Accesso + + +Opzioni del comando: + +
+
NOME_UTENTE (obbligatorio)
+
Il nome dell'utente invitato.
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Il nome dell'organizzazione in cui viene invitato l'utente.
+
RUOLO_ORGANIZZAZIONE (obbligatorio)
+
Il nome del ruolo organizzazione in cui viene invitato l'utente. Per esempio: +
    +
  • OrgManager: questo ruolo può invitare e gestire utenti, selezionare e modificare piani e impostare limiti di spesa.
    • +
  • BillingManager: questo ruolo può creare e gestire l'account di fatturazione e le informazioni sul pagamento.
    • +
  • OrgAuditor: questo ruolo dispone di un accesso in sola lettura a report e informazioni sull'organizzazione.
    • +
+
NOME_SPAZIO (obbligatorio)
+
Il nome dello spazio in cui viene invitato l'utente.
+
RUOLO_SPAZIO (obbligatorio)
+
Il nome dello spazio in cui viene invitato l'utente. Il nome del ruolo spazio in cui viene invitato l'utente. Per esempio: +
    +
  • SpaceManager: questo ruolo può invitare e gestire utenti e attivare funzioni per un dato spazio.
    • +
  • SpaceDeveloper: questo ruolo può creare e gestire applicazioni e servizi e visualizzare log e report.
    • +
  • SpaceAuditor: questo ruolo può visualizzare log, report e impostazioni per lo spazio.
    • +
+
+
+ +Esempi: + +Invitare l'utente `Mary` nell'organizzazione `IBM` con il ruolo `OrgManager` e lo spazio `Cloud` con il ruolo `SpaceAuditor`: + +``` +bluemix iam account-user-invite Mary IBM OrgManager Cloud SpaceAuditor +``` + + +### bluemix iam account-user-reinvite +{: #bluemix_iam_account_user_reinvite} + +Invia di nuovo l'invito a un utente (è richiesto il gestore organizzazione o il proprietario account) +``` + bluemix iam account-user-reinvite USER_EMAIL ORG_NAME +``` + + +### bluemix iam org-users +{: #bluemix_iam_org_users} + +Visualizzare gli utenti nell'organizzazione specificata per il ruolo. + +``` +bluemix iam org-users ORG_NAME [-a] +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Il nome dell'organizzazione.
+
-a (facoltativo)
+
Elencare tutti gli utenti dell'organizzazione specificata, non raggruppati per ruolo.
+
+ +### bluemix iam org-user-add +{: #bluemix_iam_org_user_add} + +Aggiungi un utente nell'organizzazione (è richiesto il gestore organizzazione). +``` + bluemix iam org-user-add USER_NAME ORG +``` + +### bluemix iam org-user-remove +{: #bluemix_iam_org_user_remove} + +Rimuovi un utente dall'organizzazione (gestore organizzazione o solo l'utente) +``` + bluemix iam org-user-remove USER_NAME ORG [-f, --force] +``` + +Opzioni del comando: +
+
--force, -f
+
Forzare l'eliminazione senza conferma.
+
+ +### bluemix iam org-role-set +{: #bluemix_iam_org_role_set} + +Assegnare un ruolo dell'organizzazione ad un utente. Questa operazione può essere eseguita solo da un gestore organizzazione. + +``` +bluemix iam org-role-set USER_NAME ORG_NAME ORG_ROLE +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
NOME_UTENTE (obbligatorio)
+
Il nome dell'utente in fase di assegnazione.
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Il nome dell'organizzazione a cui viene assegnato l'utente.
+
RUOLO_ORGANIZZAZIONE (obbligatorio)
+
Il nome del ruolo organizzazione a cui viene assegnato l'utente. Per esempio: +
    +
  • OrgManager: questo ruolo può invitare e gestire utenti, selezionare e modificare piani e impostare limiti di spesa.
    • +
  • BillingManager: questo ruolo può creare e gestire l'account di fatturazione e le informazioni sul pagamento.
    • +
  • OrgAuditor: questo ruolo dispone di un accesso in sola lettura a report e informazioni sull'organizzazione.
    • +
+
+
+ +Esempi: + +Assegnare l'utente `Mary` all'organizzazione `IBM` con il ruolo `OrgManager`: + +``` +bluemix iam org-role-set Mary IBM OrgManager +``` + + +### bluemix iam org-role-unset +{: #bluemix_iam_org_role_unset} + +Rimuovere un ruolo dell'organizzazione da un utente. Questa operazione può essere eseguita solo da un gestore organizzazione. + +``` +bluemix iam org-role-unset USER_NAME ORG_NAME ORG_ROLE +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
NOME_UTENTE (obbligatorio)
+
Il nome dell'utente in fase di eliminazione.
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Il nome dell'organizzazione da cui viene eliminato l'utente.
+
RUOLO_ORGANIZZAZIONE (obbligatorio)
+
Il nome del ruolo organizzazione da cui viene eliminato l'utente. Per esempio: +
    +
  • OrgManager: questo ruolo può invitare e gestire utenti, selezionare e modificare piani e impostare limiti di spesa.
    • +
  • BillingManager: questo ruolo può creare e gestire l'account di fatturazione e le informazioni sul pagamento.
    • +
  • OrgAuditor: questo ruolo dispone di un accesso in sola lettura a report e informazioni sull'organizzazione.
    • +
+
+
+ +Esempi: + +Rimuovere l'utente `Mary` dall'organizzazione `IBM` con il ruolo `OrgManager`: + +``` +bluemix iam org-role-unset Mary IBM OrgManager +``` + + +### bluemix iam space-users +{: #bluemix_iam_space_users} + +Visualizzare gli utenti nello spazio specificato per il ruolo. + +``` +bluemix iam space-users ORG_NAME SPACE_NAME +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Il nome dell'organizzazione.
+
NOME_SPAZIO (obbligatorio)
+
Il nome dello spazio.
+
+ + +### bluemix iam space-role-set +{: #bluemix_iam_space_role_set} + +Assegnare un ruolo dello spazio ad un utente. Questa operazione può essere eseguita solo da un gestore spazio. + +``` +bluemix iam space-role-set USER_NAME ORG_NAME SPACE_NAME SPACE_ROLE +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: + +
+
NOME_UTENTE (obbligatorio)
+
Il nome dell'utente in fase di assegnazione.
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Il nome dell'organizzazione a cui viene assegnato l'utente.
+
NOME_SPAZIO (obbligatorio)
+
Il nome dello spazio a cui è assegnato l'utente.
+
RUOLO_SPAZIO (obbligatorio)
+
Il nome del ruolo spazio a cui è assegnato l'utente. Per esempio: +
    +
  • SpaceManager: questo ruolo può invitare e gestire utenti e attivare funzioni per un dato spazio.
    • +
  • SpaceDeveloper: questo ruolo può creare e gestire applicazioni e servizi e visualizzare log e report.
    • +
  • SpaceAuditor: questo ruolo può visualizzare log, report e impostazioni per lo spazio.
    • +
+
+ +Esempi: + +Assegnare l'utente `Mary` all'organizzazione `IBM` e allo spazio `Cloud` con il ruolo `SpaceManager`: + +``` +bluemix iam space-role-set Mary IBM Cloud SpaceManager +``` + +### bluemix iam space-role-unset +{: #bluemix_iam_space_role_unset} + +Rimuovere un ruolo dello spazio da un utente. Questa operazione può essere eseguita solo da un gestore spazio. + +``` +bluemix iam space-role-unset USER_NAME ORG_NAME SPACE_NAME SPACE_ROLE +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: + +
+
NOME_UTENTE (obbligatorio)
+
Il nome dell'utente in fase di eliminazione.
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Il nome dell'organizzazione da cui viene eliminato l'utente.
+
NOME_SPAZIO (obbligatorio)
+
Il nome dello spazio da cui viene eliminato l'utente.
+
RUOLO_SPAZIO (obbligatorio)
+
Il nome del ruolo spazio da cui viene eliminato l'utente. Per esempio: +
    +
  • SpaceManager: questo ruolo può invitare e gestire utenti e attivare funzioni per un dato spazio.
    • +
  • SpaceDeveloper: questo ruolo può creare e gestire applicazioni e servizi e visualizzare log e report.
    • +
  • SpaceAuditor: questo ruolo può visualizzare log, report e impostazioni per lo spazio.
    • +
+
+ + +Esempi: + +Rimuovere l'utente `Mary` dall'organizzazione `IBM` e dall spazio `Cloud` con il ruolo `SpaceManager`: + +``` +bluemix iam space-role-unset Mary IBM Cloud SpaceManager +``` + + +### bluemix app push +{: #bluemix_app_push} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf push`. + + +### bluemix app list +{: #bluemix_app_list} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf apps`. + + +### bluemix app show +{: #bluemix_app_show} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf app`. + + +### bluemix app scale +{: #bluemix_app_scale} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf scale`. + + +### bluemix app delete +{: #bluemix_app_delete} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete`. + + +### bluemix app rename +{: #bluemix_app_rename} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf rename`. + + +### bluemix app start +{: #bluemix_app_start} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf start`. + + +### bluemix app stop +{: #bluemix_app_stop} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf stop`. + + +### bluemix app restart +{: #bluemix_app_restart} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf restart`. + + +### bluemix app restage +{: #bluemix_app_restage} + + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf restage`. + + +### bluemix app instance-restart +{: #bluemix_app_instance_restart} + + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf restart-app-instance`. + + +### bluemix app events +{: #bluemix_app_events} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf events`. + + +### bluemix app files +{: #bluemix_app_files} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf files`. + + +### bluemix app logs +{: #bluemix_app_logs} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf logs`. + + +### bluemix app env +{: #bluemix_app_env} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf env`. + + +### bluemix app env-set +{: #bluemix_app_env_set} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf set-env`. + + +### bluemix app env-unset +{: #bluemix_app_env_unset} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf unset-env`. + + +### bluemix app stacks +{: #bluemix_app_stacks} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf stacks`. + + +### bluemix app stack +{: #bluemix_app_stack} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf stack`. + + +### bluemix app manifest-create +{: #bluemix_app_manifest_create} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-app-manifest`. + + +### bluemix service offerings +{: #bluemix_service_offerings} + + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf marketplace`. + + +### bluemix service list +{: #bluemix_service_list} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf services`. + + +### bluemix service show +{: #bluemix_service_show} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf service`. + + +### bluemix service create +{: #bluemix_service_create} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-service`. + + +### bluemix service update +{: #bluemix_service_update} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf update-service`. + + +### bluemix service delete +{: #bluemix_service_delete} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-service`. + + +### bluemix service rename +{: #bluemix_service_rename} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf rename-service`. + + +### bluemix service bind +{: #bluemix_service_bind} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf bind-service`. + + +### bluemix service unbind +{: #bluemix_service_unbind} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf unbind-service`. + + +### bluemix service key-create +{: #bluemix_service_key_create} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-service-key`. + + +### bluemix service key-delete +{: #bluemix_service_key_delete} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-service-key`. + + +### bluemix service keys +{: #bluemix_service_keys} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf service-keys`. + + +### bluemix service key-show +{: #bluemix_service_key_show} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf service-key`. + + +### bluemix service user-provided-create +{: #bluemix_service_user_provided_create} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-user-provided-service`. + + +### bluemix service user-provided-update +{: #bluemix_service_user_provided_update} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf update-user-provided-service`. + + +### bluemix catalog templates +{: #bluemix_catalog_templates} + +Visualizzare i template di contenitore tipo su Bluemix. + +``` +bluemix catalog templates [-d] +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: + +
+
-d (facoltativo)
+
Se viene specificata l'opzione -d, viene visualizzata anche la descrizione di ciascun template. Altrimenti, vengono visualizzati solo l'ID e il nome di ciascun template.
+
+ + +### bluemix catalog template +{: #bluemix_catalog_template} + +Visualizzare le informazioni dettagliate di un template contenitore tipo specificato. + +``` +bluemix catalog template TEMPLATE_ID +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: +
+
ID_TEMPLATE (obbligatorio)
+
L'ID del template contenitore tipo. Utilizza bluemix template per visualizzare l'ID di tutti i template.
+
+ + +Esempi: + +Visualizzare i dettagli del template `mobileBackendStarter`: + +``` +bluemix catalog template mobileBackendStarter +``` + + +### bluemix catalog template-run +{: #bluemix_catalog_template_run} + +Creare un'applicazione cf basata sul template specificato con l'URL e la descrizione specificati. Per impostazione predefinita, la nuova applicazione viene avviata automaticamente. + +``` +bluemix catalog template-run TEMPLATE_ID CF_APP_NAME [-u URL] [-d DESCRIPTION] [--no-start] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: +
+
ID_TEMPLATE (obbligatorio)
+
Il template su cui verrà basata l'applicazione quando verrà creata. Utilizza bluemix templates per visualizzare l'ID di tutti i template.
+
NOME_APPLICAZIONE_CF (obbligatorio)
+
Il nome dell'applicazione cf da creare.
+
-u URL (facoltativo)
+
La rotta dell'applicazione. Se non specificata, la rotta viene impostata automaticamente da Bluemix, in base al tuo nome applicazione e al tuo dominio predefinito.
+
-d DESCRIZIONE (facoltativo)
+
Descrizione dell'applicazione.
+
--no-start (facoltativo)
+
Non avviare l'applicazione automaticamente una volta creata. Se non viene specificata, l'applicazione viene avviata automaticamente dopo la sua creazione.
+
+ + +Esempi: + +Creare un'applicazione `my-app` basata sul template `javaHelloWorld`: + +``` +bluemix catalog template-run javaHelloWorld my-app +``` + +Creare un'applicazione `my-ruby-app` basata sul template `rubyHelloWorld` con la rotta `myrubyapp.chinabluemix.net` e la descrizione `My first ruby app on {{site.data.keyword.Bluemix_notm}}.`: + +``` +bluemix catalog template-run rubyHelloWorld my-ruby-app -u myrubyapp.chinabluemix.net -d "My first ruby app on {{site.data.keyword.Bluemix_notm}}." +``` + +Creare un'applicazione `my-python-app` basata sul template `pythonHelloWorld` senza l'avvio automatico: + +``` +bluemix catalog template-run pythonHelloWorld my-python-app --no-start +``` + + +### bluemix network regions +{: #bluemix_network_regions} + +Visualizzare le informazioni per tutte le regioni su {{site.data.keyword.Bluemix_notm}}. + +``` +bluemix network regions +``` + +Prerequisiti: Endpoint + + +### bluemix network region-set +{: #bluemix_network_region_set} + +Passare alla regione specificata. Questo comando ha automaticamente di nuovo come destinazione la stessa organizzazione e lo stesso spazio nella nuova regione, se possibile. Altrimenti, il comando richiede all'utente di selezionare una nuova organizzazione e un nuovo spazio, qualora l'utente sia già collegato. L'endpoint API viene modificato di conseguenza. + +``` +bluemix network region-set NOME_REGIONE +``` + +Prerequisiti: Endpoint + +Opzioni del comando: + +
+
NOME_REGIONE (obbligatorio)
+
Il nome della regione a cui si desidera passare. Puoi utilizzare il comando bluemix network regions per visualizzare tutti i nomi regione.
+
+ +Esempi: + +Impostare la regione corrente su `eu-gb`: + +``` +bluemix network region-set eu-gb +``` + + +### bluemix network routes +{: #bluemix_network_routes} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf routes`. + + +### bluemix network route-check +{: #bluemix_network_route_check} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf check-route`. + + +### bluemix network route-map +{: #bluemix_network_route_map} + +Associare una rotta a un'applicazione cf o a un gruppo di contenitori esistenti che hanno il dominio e il nome host specificati. + +``` +bluemix network route-map CF_APP_NAME|CONTAINER_GROUP_NAME  DOMAIN  [-n HOST_NAME] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
NOME_APPLICAZIONE_CF|NOME_GRUPPO_CONTENITORE (obbligatorio)
+
Il nome dell'applicazione cf o del gruppo di contenitori da associare a una rotta.
+
DOMINIO (obbligatorio)
+
Il dominio della rotta. Ad esempio, mychinabluemix.net o chinabluemix.net.
+
-n NOME_HOST (facoltativo)
+
Il nome host della rotta. Se non viene fornito, il nome host è impostato sul nome applicazione o sul nome gruppo di contenitori per impostazione predefinita.
+
+ +Esempi: + +Associare una rotta `my-app` con il dominio specificato: + +``` +bluemix network route-map my-app mychinabluemix.net +``` + +Associare una rotta a 'my-container-group' con il dominio e il nome host specificati: + +``` +bluemix network route-map my-container-group chinabluemix.net -n abc +``` + + +### bluemix network route-unmap +{: #bluemix_network_route_unmap} + +Annullare l'associazione della rotta specificata a un'applicazione cf o a un gruppo di contenitori esistenti. + +``` +bluemix network route-unmap CF_APP_NAME|CONTAINER_GROUP_NAME  DOMAIN  [-n HOST_NAME] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
NOME_APPLICAZIONE_CF|NOME_GRUPPO_CONTENITORE (obbligatorio)
+
Il nome dell'applicazione cf o del gruppo di contenitori.
+
DOMINIO (obbligatorio)
+
Il dominio della rotta (ad esempio, mychinabluemix.net o chinabluemix.net).
+
-n NOME_HOST (facoltativo)
+
Il nome host della rotta. Se non viene fornito, il nome host è impostato sul nome applicazione o sul nome gruppo di contenitori per impostazione predefinita.
+
+ +Esempi: + +Annullare l'associazione di `my-app.mychinabluemix.net` da `my-app`: + +``` +bluemix network route-unmap my-app mychianbluemix.net +``` + +Annullare l'associazione di `abc.chinabluexmix.net` da `my-container-group`: + +``` +bluemix network route-unmap my-container-group chinabluemix.net -n abc +``` + + +### bluemix network route-create +{: #bluemix_network_route_create} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-route`. + + +### bluemix network route-delete +{: #bluemix_network_route_delete} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-route`. + + +### bluemix network orphaned-routes-delete +{: #bluemix_network_orphaned_routes_delete} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-orphaned-routes`. + + +### bluemix network domains +{: #bluemix_network_domains} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf domains`. + + +### bluemix network domain-create +{: #bluemix_network_domain_create} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-domain`. + + +### bluemix network domain-delete +{: #bluemix_network_domain_delete} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-domain`. + + +### bluemix network shared-domain-create +{: #bluemix_network_shared_domain_create} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf create-shared-domain`. + + +### bluemix network shared-domain-delete +{: #bluemix_network_shared_domain_delete} + +Questo comando ha la stessa funzione e le stesse opzioni del comando `cf delete-shared-domain`. + + + +### bluemix bss account-usage +{: #bluemix_bss_account_usage} + +Mostra i costi e l'utilizzo mensile del tuo account. + +``` +bluemix bss account-usage [-d YYYY-MM] [--json] +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: + +
+
-d MONTH_DATE (facoltativo)
+
Visualizza i dati per il mese e la data specificando l'utilizzo nel formato YYYY-MM. Se non specificato, viene mostrato l'utilizzo del mese corrente.
+
--json (facoltativo)
+
Visualizza il risultato di utilizzo nel formato JSON.
+
+ +Esempi: + +Mostra il report del costo e l'utilizzo dell'account per 2016-06: + +``` +bluemix bss account-usage -d 2016-06 +``` + +### bluemix bss org-usage +{: #bluemix_bss_org_usage} + +Mostra i dettagli dell'utilizzo mensile di un'organizzazione. Questa operazione può essere eseguita solo da un gestore della fatturazione dell'organizzazione. + +``` +bluemix bss org-usage ORG_NAME [-d YYYY-MM] [-r REGION_NAME] [--json] +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: + +
+
NOME_ORGANIZZAZIONE (obbligatorio)
+
Nome dell'organizzazione.
+
-d MONTH_DATE (facoltativo)
+
Visualizza i dati per il mese e la data specificata tramite l'utilizzo nel formato YYYY-MM. Se non specificato, viene mostrato l'utilizzo del mese corrente.
+
-r REGION_NAME
+
Nome della regione che ospita l'organizzazione. Se impostato su 'all', viene mostrato l'utilizzo dell'organizzazione in tutte le regioni.
+
--json (facoltativo)
+
Visualizza il risultato di utilizzo nel formato JSON.
+
+ + + +### bluemix bss orgs-usage-summary +{: #bluemix_bss_orgs_usage_summary} + +Mostra il riepilogo dell'utilizzo mensile per le organizzazioni nel mio account. + +``` +bluemix bss orgs-usage-summary [-d YYYY-MM] [-r REGION_NAME] [--json] +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: + +
+
-d MONTH_DATE (facoltativo)
+
Visualizza i dati per il mese e la data specificata tramite l'utilizzo nel formato YYYY-MM. Se non specificato, viene mostrato l'utilizzo del mese corrente.
+
-r REGION_NAME
+
Nome della regione che ospita le organizzazioni. Se impostato su 'all', viene mostrato il riepilogo dell'utilizzo delle organizzazioni in tutte le regioni.
+
--json (facoltativo)
+
Visualizza il risultato di utilizzo nel formato JSON.
+
+ + + +### bluemix security cert +{: #bluemix_security_cert} + +Elencare le informazioni sul certificato di un dominio. + +``` +bluemix security cert DOMAIN_NAME +``` + +Prerequisiti: Endpoint, Accesso + +Opzioni del comando: + +
+
NOME_DOMINIO (obbligatorio)
+
Il dominio che ospita il certificato.
+
+ + + +Esempi: + +Visualizzare le informazioni sul certificato del dominio `ibmcxo-eventconnect.com`: + +``` +bluemix security cert ibmcxo-eventconnect.com +``` + + +### bluemix security cert-add +{: #bluemix_security_cert_add} + +Aggiungere un certificato al dominio specificato nell'organizzazione corrente. + +``` +bluemix security cert-add DOMAIN -k PRIVATE_KEY_FILE -c CERT_FILE [-p PASSWORD] [-i INTERMEDIATE_CERT_FILE] [--verify-client] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: +
+
DOMINIO (obbligatorio)
+
Il dominio a cui viene aggiunto il certificato.
+
-k FILE_CHIAVE PRIVATA (obbligatorio)
+
Il percorso del file della chiave privata.
+
-c FILE_CERTIFICATO (obbligatorio)
+
Il percorso del file del certificato.
+
-p PASSWORD (facoltativo)
+
La password per il certificato.
+
-i FILE_CERTIFICATO_INTERMEDIO (optional)
+
Il percorso del file di certificato intermedio.
+
--verify-client (facoltativo)
+
Stabilire se abilitare la verifica del certificato del client.
+
+ + +Esempi: + +Aggiungere un certificato al dominio `ibmcxo-eventconnect.com`: + +``` +bluemix security cert-add ibmcxo-eventconnect.com -k key_file.key -c cert_file.crt -p 123 -i inter_cert.cert +``` + + +### bluemix security cert-remove +{: #bluemix_security_cert_remove} + +Rimuovere un certificato dal dominio specificato nell'organizzazione corrente. + +``` +bluemix security cert-remove DOMAIN [-f] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
DOMINIO (obbligatorio)
+
Il dominio da cui rimuovere il certificato.
+
-f (facoltativo)
+
Forzare l'eliminazione senza conferma.
+
+ + + +### bluemix plugin repos +{: #bluemix_plugin_repos} + +Elencare i repository di plugin registrati nella CLI {{site.data.keyword.Bluemix_notm}}. + +``` +bluemix plugin repos +``` + +Prerequisiti: Nessuno + + +### bluemix plugin repo-add +{: #bluemix_plugin_repo_add} + +Aggiungere un nuovo repository di plugin alla CLI {{site.data.keyword.Bluemix_notm}}. + +``` +bluemix plugin repo-add NOME_REPOSITORY URL_REPOSITORY +``` + +Prerequisiti: Nessuno + +Opzioni del comando: + +
+
NOME_REPOSITORY (obbligatorio)
+
Il nome del repository da aggiungere. Puoi definire un tuo nome per ciascun repository.
+
URL_REPOSITORY (obbligatorio)
+
L'URL del repository da aggiungere. L'URL del repository deve contenere il protocollo (ad esempio, http://plugins.ng.bluemix.net invece di plugins.ng.bluemix.net). http://plugins.ng.bluemix.net è il repository di plugin ufficiale della CLI Bluemix.
+
+ + +Esempi: + +Aggiungere il repository di plug-in ufficiale della CLI Bluemix come `bluemix-repo`: + +``` +bluemix plugin repo-add bluemix-repo http://plugins.ng.bluemix.net +``` + + +### bluemix plugin repo-remove +{: #bluemix_plugin_repo_remove} + +Rimuovere un repository di plugin dalla CLI {{site.data.keyword.Bluemix_notm}}. + +``` +bluemix plugin repo-remove NOME_REPOSITORY +``` + +Prerequisiti: Nessuno + +Opzioni del comando: +
+
NOME_REPOSITORY (obbligatorio)
+
Il nome del repository da rimuovere.
+
+ +Esempi: + +Rimuovere il repository `bluemix-repo` dalla CLI {{site.data.keyword.Bluemix_notm}}: + +``` +bluemix plugin repo-remove bluemix-repo +``` + + +### bluemix plugin repo-plugins +{: #bluemix_plugin_repo_plugins} + +Elencare tutti i plugin disponibili in tutti i repository aggiunti o in uno specifico repository. + +``` +bluemix plugin repo-plugins [-r NOME_REPOSITORY] +``` + +Prerequisiti: Nessuno + +Opzioni del comando: + +
+
-r NOME_REPOSITORY (facoltativo)
+
Elencare solo i plugin del repository specificato.
+
+ +Esempi: + +Elencare tutti i plugin in tutti i repository aggiunti: + +``` +bluemix plugin repo-plugins +``` + +Elencare tutti i plugin nel repository `bluemix-repo`: + +``` +bluemix plugin repo-plugins -r bluemix-repo +``` + + +### bluemix plugin list +{: #bluemix_plugin_list} + +Elencare tutti i plugin installati nella CLI {{site.data.keyword.Bluemix_notm}}. + +``` +bluemix plugin list +``` + +Prerequisiti: Nessuno + + +### bluemix plugin install +{: #bluemix_plugin_install} + +Installare la versione specifica del plugin nella CLI {{site.data.keyword.Bluemix_notm}} dal percorso o repository specificato. + +``` +bluemix plugin install PLUGIN_PATH|PLUGIN_NAME [-r REPO_NAME] [-v VERSION] +``` + +Prerequisiti: Nessuno + +Opzioni del comando: + +
+
PERCORSO_PLUGIN|NOME_PLUGIN (obbligatorio)
+
Se -r NOME_REPOSITORY non viene specificato, il plugin viene installato dal percorso locale o dall'URL remoto specificati.
+
-r NOME_REPOSITORY (facoltativo)
+
Il nome del repository in cui si trova il file binario del plugin.
+
-v VERSIONE (facoltativo)
+
La versione del plugin da installare. Se non fornita, viene installata l'ultima versione del plugin. Questa opzione è valida solo quando si installa il plugin dal repository.
+
+ +Esempi: + +Installare un plugin dal file locale: + +``` +bluemix plugin install /downloads/new_plugin +``` + +Installare un plugin dall'URL remoto: + +``` +bluemix plugin install http://plugins.ng.bluemix.net/downloads/new_plugin +``` + +Installare il plugin `IBM-Containers` dell'ultima versione dal repository `bluemix-repo`: + +``` +bluemix plugin install IBM-Containers -r bluemix-repo +``` +Installare il plugin `IBM-Containers` con la versione `0.5.800` dal repository `bluemix-repo`: + +``` +bluemix plugin install IBM-Containers -r bluemix-repo -v 0.5.800 +``` + + + + + + +### bluemix plugin uninstall +{: #bluemix_plugin_uninstall} + +Disinstallare il plugin specificato dalla CLI {{site.data.keyword.Bluemix_notm}}. + +``` +bluemix plugin uninstall NOME_PLUGIN +``` + +Prerequisiti: Nessuno + +Opzioni del comando: + +
+
NOME_PLUGIN (obbligatorio)
+
Il nome del plugin da disinstallare.
+
+ +Esempi: + +Disinstallare il plugin `IBM-Containers` che era stato precedentemente installato: + +``` +bluemix plugin uninstall IBM-Containers +``` + + +### bluemix ic attach +{: #bluemix_ic_attach} + +Controllare un contenitore in esecuzione o visualizzarne l'output. Utilizza `CTRL+C` per uscire e arrestare il contenitore. Questo comando richiama la CLI Docker. Per ulteriori informazioni, vedi il comando [attach ](https://docs.docker.com/engine/reference/commandline/attach/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + +``` +bluemix ic attach [--no-stdin] [--sig-proxy] CONTAINER +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
--no-stdin (facoltativo)
+
Non includere l'input standard.
+
--sig-proxy (facoltativo)
+
Eseguire il proxy di tutti i segnali ricevuti nel processo. Il +valore predefinito è true.
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di collegamento al contenitore `my_container`: +``` +bluemix ic attach my_container +``` + + +### bluemix ic build +{: #bluemix_ic_build} + +Richiamare il servizio di build IBM Containers per creare un'immagine Docker in locale o nel tuo repository {{site.data.keyword.Bluemix_notm}} privato. Questo comando richiama la CLI Docker. Per ulteriori informazioni, vedi il comando [build ](https://docs.docker.com/engine/reference/commandline/build/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + +``` +bluemix ic build -t TAG|--tag TAG [--no-cache] [-p|--pull] [-q|--quiet] DOCKERFILE_LOCATION +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: +
+
-t TAG|--tag TAG (obbligatorio)
+
Il nome repository da applicare all'immagine in fase di creazione.
+
--no-cache (facoltativo)
+
Non utilizzare la cache quando viene creata l'immagine. Il valore predefinito è false.
+
--pull (facoltativo)
+
Provare a estrarre l'immagine di base dal registro anche se è memorizzata nella cache.
+
-q|--quiet (facoltativo)
+
Sopprimere l'output dettagliato generato dai contenitori. Il valore predefinito è false.
+
DOCKERFILE_LOCATION (obbligatorio)
+
Il percorso verso Dockerfile e contesto sull'host locale.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di creazione di un'immagine denominata *myimage*. Il Dockerfile e altre risorse utente da utilizzare nella creazione si trovano nella stessa directory da cui viene eseguito il comando. Poiché il registro e lo spazio dei nomi sono inclusi nel nome dell'immagine, l'immagine viene creata nel repository {{site.data.keyword.Bluemix_notm}} privato della tua organizzazione. +``` +bluemix ic build -t registry.ng.bluemix.net/mynamespace/myimage . +``` + + +### bluemix ic cp +{: #bluemix_ic_cp} +Copia file o cartelle tra un contenitore e il file system locale. Questo comando richiama la CLI Docker. Per ulteriori informazioni, vedi il comando [cp ](https://docs.docker.com/engine/reference/commandline/cp/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + + +### bluemix ic cpi +{: #bluemix_ic_cpi} + +Accedere a un'immagine Docker Hub o a un'immagine dal tuo registro locale e copiarla nel tuo repository {{site.data.keyword.Bluemix_notm}} privato. + +``` +bluemix ic cpi IMMAGINE_DI_ORIGINE IMMAGINE_DI_DESTINAZIONE +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: +
+
IMMAGINE_DI_ORIGINE (obbligatorio)
+
Il nome del repository e dell'immagine di origine.
+
IMMAGINE_DI_DESTINAZIONE (obbligatorio)
+
L'URL del repository {{site.data.keyword.Bluemix_notm}} privato, che include lo spazio dei nomi e il nome dell'immagine di destinazione. Una tag per l'immagine è facoltativa.
+
+ +Esempi: + +Copiare un'immagine dal repository di origine nel repository privato ed aggiungere una tag per l'immagine: + +``` +bluemix ic cpi source_repository/source_image_name private_registry_URL/destination_image_name:tag +``` + +Copiare l'immagine `sinatra` dal repository `training` nel repository privato `registry.ng.bluemix.net/mynamespace` e il nome dell'immagine `mysinatra`. Aggiungere una tag `v1` per l'immagine `mysinatra`. + +``` +bluemix ic cpi training/sinatra registry.ng.bluemix.net/mynamespace/mysinatra:v1 +``` + + +### bluemix ic exec +{: #bluemix_ic_exec} + +Eseguire un comando all'interno di un contenitore. Per ulteriori informazioni, vedi il comando [exec ](https://docs.docker.com/engine/reference/commandline/exec/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + +``` +bluemix ic exec [-d|--detach] [-it] [-u USER|--user USER] CONTAINER [CMD] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
-d|--detach (facoltativo)
+
Eseguire il comando specificato in background.
+
-it (facoltativo)
+
Modalità interattiva. L'input standard rimane visualizzato. Immetti exit per uscire.
+
-u UTENTE|--user UTENTE (facoltativo)
+
Il nome utente.
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
CMD (facoltativo)
+
Il comando da eseguire all'interno del contenitore o dei contenitori specificati.
+
+ +Esempi: + +Eseguire il comando `bash` all'interno del contenitore `my_container` nella modalità interattiva: + +``` +bluemix ic exec -it my_container bash +``` + +Eseguire il comando `date` all'interno del contenitore `my_container`: + +``` +bluemix ic exec my_container date +``` + + +### bluemix ic group-create +{: #bluemix_ic_group_create} + +Creare un gruppo di contenitori scalabile. + +``` +bluemix ic group-create [--publish,-p PORT] --name GROUP_NAME [--memory,-m MEMORY_SIZE] [-n,--hostname HOSTNAME] [-d,--domain DOMAIN] [--env,-e ENV_KEY=ENV_VAL] [--env-file ENVIRONMENT_VARIABLE_FILE] [-P false|true] [--volume] [--min MIN_INSTANCE_COUNT] [--max MAX_INSTANCE_COUNT] [--desired DESIRED_INSTANCE_COUNT] [--anti false|true] [--auto false|true] IMAGE_NAME [CMD [CMD ...]] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: +
+
IMAGE_NAME (obbligatorio)
+
L'immagine da includere in ciascuna istanza del contenitore del gruppo di contenitori. L'immagine può essere seguita da un elenco di comandi, ma non da opzioni. Includi tutte le opzioni prima di specificare l'immagine.

Se utilizzi un'immagine nel repository {{site.data.keyword.Bluemix_notm}} privato della tua organizzazione, specificala con il seguente formato: registry.ng.bluemix.net/SPAZIO_NOMI/IMMAGINE.

Se utilizzi un'immagine fornita da IBM Containers, non includere lo spazio dei nomi della tua organizzazione. Specifica l'immagine con il seguente formato: registry.ng.bluemix.net/IMMAGINE.
+
--name GROUP_NAME (obbligatorio)
+
Assegnare un nome al gruppo. -n è stato dichiarato obsoleto.
+ Suggerimento: il nome del contenitore deve iniziare con una lettera. Il nome può includere lettere maiuscole, lettere minuscole, numeri, punti., caratteri di sottolineatura _, o trattini -.
+
-m MEMORY_SIZE|--memory MEMORY_SIZE (facoltativo)
+
Assegnare un limite di memoria al gruppo in MB. Quando crei un gruppo di contenitori dalla CLI, il valore predefinito per ogni istanza del contenitore è 64 MB. Quando crei un gruppo di contenitori dal Dashboard {{site.data.keyword.Bluemix_notm}}, il valore predefinito per ogni istanza del contenitore è 256 MB. I valori accettati sono 64, 256, 512, 1024 e 2048. Una volta assegnato, il limite di memoria non può essere modificato.
+
-n HOSTNAME|--hostname HOSTNAME (facoltativo)
+
Il nome host, quale ad esempio mycontainerhost. L'host e il dominio si combinano per formare l'URL completo della rotta pubblica, quale ad esempio http://mycontainerhost.mybluemix.net. Quando esamini i dettagli di un gruppo di contenitori con il comando bluemix ic group-inspect, l'host e il dominio vengono elencati insieme come rotta.
+
-d DOMINIO|--domain DOMINIO (facoltativo)
+
Di solito, il dominio è .mybluemix.net. L'host e il dominio vengono combinati per formare l'URL completo della rotta pubblica, quale ad esempio http://mycontainerhost.mybluemix.net. Quando esamini i dettagli di un gruppo di contenitori con il comando bluemix ic group-inspect, l'host e il dominio vengono elencati insieme come rotta.
+
-e ENV_KEY=ENV_VAL|--env ENV_KEY=ENV_VAL (facoltativo)
+
Imposta la variabile di ambiente. In caso di più chiavi, elencale separatamente. Se sono incluse virgolette, includile racchiudendo sia il valore che il nome della variabile di ambiente. Ad esempio: `-e "key1=value1" -e "key2=value2" -e "key3=value3"`. La seguente tabella mostra alcune variabili di ambiente comunemente utilizzate che puoi specificare:
+
+ + +| Variabile di ambiente | Descrizione | +| :----------------------------- | :------------------------------ | +| CCS_BIND_APP=*<nome_applicazione>* | Eseguire il bind di un servizio a un contenitore. Utilizza la variabile di ambiente `CCS_BIND_APP` per eseguire il bind di un'applicazione al contenitore. L'applicazione viene associata tramite bind al servizio di destinazione e funge da ponte che consente a {{site.data.keyword.Bluemix_notm}} di portare le informazioni `VCAP_SERVICES` dell'applicazione ponte all'istanza del contenitore in esecuzione.| +| CCS_BIND_SRV=*<nome_istanza_servizio1>*,*<nome_istanza_servizio2>* | Per eseguire direttamente il bind di un servizio Bluemix a un contenitore senza utilizzare un'applicazione ponte, utilizza CCS_BIND_SRV. Questo bind consente a Bluemix di inserire le informazioni VCAP_SERVICES nell'istanza del contenitore in esecuzione. Per elencare più servizi Bluemix, puoi includerli come parte della stessa variabile di ambiente. | +| LOG_LOCATIONS=*<>percorso_verso_file* | Aggiungere un file di log da monitorare nel contenitore. Includi la variabile di ambiente `LOG_LOCATIONS` in un percorso verso il file di log. | +{: caption="Table 8. Commonly used environment variables" caption-side="top"} + + +
+
--env-file FILE_VARIABILE_AMBIENTE (facoltativo)
+
Importa variabili di ambiente da un file dove ENVFILE è il percorso del tuo file nella directory locale. Ogni riga nel file rappresenta una coppia key=value.
+
--volume VOLUME:PERCORSO_CONTENITORE[:ro] (facoltativo)
+
Collegare un volume a un contenitore, specificando i dettagli nel formato IDVolume:PercorsoContenitore[:ro]. +
    +
  • VOLUME: l'ID o nome del volume.
    • +
  • PERCORSO_CONTENITORE: il percorso assoluto per il volume del contenitore.
    • +
  • ro: facoltativo. La specifica di ro rende il volume di sola lettura invece della lettura/scrittura predefinita.
+
+
-p PORTA|--publish PORTA (facoltativo)
+
Esporre la porta per il traffico HTTP. I contenitori del tuo gruppo devono essere in ascolto sulla porta HTTP. Non possono essere effettuate richieste HTTPS. Per i gruppi di contenitori, non puoi includere più porte.

Quando specifichi una porta, stai rendendo l'applicazione disponibile al programma di bilanciamento del carico {{site.data.keyword.Bluemix_notm}} o ai contenitori che stanno provando a raggiungere l'host nello stesso spazio {{site.data.keyword.Bluemix_notm}}. Quindi i contenitori o il bilanciamento del carico {{site.data.keyword.Bluemix_notm}} possono utilizzare la porta per raggiungere l'host e l'applicazione nello stesso spazio {{site.data.keyword.Bluemix_notm}}. Se nel Dockerfile è specificata una porta per l'immagine che stai utilizzando, includila.
+ Suggerimenti:
    +
  • Per l'immagine Liberty Server certificata da IBM o una versione modificata di questa immagine, immetti la porta 9080.
    • +
  • Per l'immagine Node.js certificata da IBM o una versione modificata di questa immagine, immetti la porta 8000.
    • +
+
+
-P (facoltativo)
+
Pubblica tutte le porte
+
--min MIN_INSTANCE_COUNT (facoltativo)
+
Il numero minimo di istanze. Il valore predefinito è 1. Se imposti un numero minimo di istanze, una volta creato il gruppo di contenitori non è più possibile modificare questo valore.
+
--max MAX_INSTANCE_COUNT (facoltativo)
+
Il numero massimo di istanze. Il valore predefinito è 2. Se imposti un numero massimo di istanze, una volta creato il gruppo di contenitori non è più possibile modificare questo valore.
+
--desired DESIRED_INSTANCE_COUNT (facoltativo)
+
Il numero di istanze da te richiesto. Il valore predefinito è 2.
+
--auto (facoltativo)
+
Quando si crea il gruppo di contenitori e il ripristino automatico è abilitato, IBM Containers verifica l'integrità di ciascuna istanza con una richiesta HTTP alla porta assegnata.
+ Se non viene ricevuta alcuna risposta da un'istanza del contenitore entro 2 intervalli consecutivi di 90 secondi, l'istanza viene rimossa e sostituita con una nuova istanza. Se il contenitore risponde non viene effettuata alcuna azione. Questo processo viene ripetuto continuamente. In una finestra di 30 minuti, se il numero totale di differenti contenitori membri del gruppo è uguale o 3 volte maggiore della dimensione massima osservata per il gruppo stesso, il ripristino automatico viene disabilitato in modo permanente per il gruppo di contenitori. Per abilitare di nuovo il ripristino automatico, devi ricreare il gruppo di contenitori.
+
--anti (facoltativo)
+
Utilizza l'opzione anti-affinity per rendere il tuo gruppo di contenitori molto più disponibile. L'opzione --anti forza l'inserimento di ogni istanza di contenitore del tuo gruppo in un nodo di elaborazione fisico separato, riducendo così la possibilità che si verifichi un arresto anomalo di tutti i contenitori nel gruppo a causa di un errore hardware. Potresti non essere in grado di utilizzare questa opzione con gruppi di dimensione maggiore in quanto ogni regione e organizzazione Bluemix ha a disposizione una serie di nodi di elaborazione limitata per la distribuzione. Se la distribuzione non riesce, riduci il numero di istanze del contenitore nel gruppo o rimuovi l'opzione --anti.
+
CMD (facoltativo)
+
Il comando e gli argomenti trasmessi al gruppo di contenitori per l'esecuzione. Questo comando deve essere un comando a esecuzione prolungata. Non utilizzare un comando di breve durata che non viene eseguito per molto tempo, quale ad esempio /bin/date, poiché tale comando potrebbe provocare un arresto anomalo del contenitore.
Note:
    +
  • Il comando e i relativi argomenti devono trovarsi alla fine della riga di comando bluemix ic run.
    • +
  • Se gli argomenti del comando includono il trattino -, come in -c nel comando di esempio precedente, il comando deve essere preceduto da due trattini (--).
    • +
+
+ + +Esempi: + +Creare un gruppo di contenitori `my_container_group` utilizzando l'immagine `registry.ng.bluemix.net/ibmnode` fornita da IBM Containers, quindi eseguire il comando di lunga durata `ping localhost` su tale gruppo di contenitori: + +``` +bluemix ic group-create --name my_container_group registry.ng.bluemix.net/ibmnode ping localhost +``` + +Creare un gruppo di contenitori `my_container_group` utilizzando l'immagine `registry.ng.bluemix.net/ibmnode` fornita da IBM Containers, quindi eseguire il comando di lunga durata `tail -f /dev/null` su tale gruppo di contenitori: + +``` +bluemix ic group-create --name my_container_group registry.ng.bluemix.net/ibmnode -- tail -f /dev/null +``` + +Creare un gruppo scalabile `mygroup` con il ripristino automatico abilitato, utilizzando l'immagine `registry.ng.bluemix.net/ibmliberty`. La porta è `9080`, il nome host è `mycontainerhost`, il nome dominio è `mybluemix.net`. +``` +bluemix ic group-create -p 9080 --auto -n mycontainerhost -d mybluemix.net --name mygroup registry.ng.bluemix.net/ibmliberty +``` + + +### bluemix ic group-inspect +{: #bluemix_ic_group_inspect} + +Visualizzare informazioni dettagliate, quali le variabili di ambiente, le porte o la memoria, specificate per un gruppo di contenitori al momento della creazione. + +``` +bluemix ic group-inspect GRUPPO_CONTENITORI +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
GRUPPO_CONTENITORI (obbligatorio)
+
Il nome o l'ID del gruppo di contenitori.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di controllo del gruppo di contenitori `my_group`: +``` +bluemix ic group-inspect my_group +``` + + +### bluemix ic group-instances +{: #bluemix_ic_group_instances} + +Elencare istanze di un gruppo di contenitori specificato. + +``` +bluemix ic group-instances GRUPPO_CONTENITORI +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
GRUPPO_CONTENITORI (obbligatorio)
+
Il nome o l'ID del gruppo di contenitori.
+
+ +Esempi: + +Elencare tutte le istanze del gruppo di contenitori `my_group`: +``` +bluemix ic group-instances my_group +``` + + +### bluemix ic group-remove +{: #bluemix_ic_group_remove} + +Rimuovere un gruppo di contenitori da uno spazio. + +``` +bluemix ic group-remove [-f|--force] GROUP_NAME [GROUP_NAME2 [...]] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
-f|--force (facoltativo)
+
Forza la rimozione di un contenitore in esecuzione o in errore.
+
NOME GRUPPO (obbligatorio)
+
Il nome o l'ID del gruppo di contenitori.
+
+ + +Esempi: + +Il seguente esempio mostra una richiesta di rimozione di un gruppo di contenitori, dove `my_group` è il nome del gruppo di contenitori. +``` +bluemix ic group-remove my_group +``` + + +### bluemix ic group-update +{: #bluemix_ic_group_update} + +Aggiornare un gruppo di contenitori. + + +``` +bluemix ic group-update [--anti] [--desired DESIRED_INSTANCE_COUNT] [-e ENV_KEY=ENV_VAL] GROUP_NAME +``` + +**Suggerimento:** per aggiornare il nome host o il dominio di un gruppo di contenitori, utilizza `bluemix ic route-map [-n HOST][-d DOMAIN] GRUPPO_CONTENITORI`. + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: +
+
--anti (facoltativo)
+
Utilizza l'opzione anti-affinity per rendere il tuo gruppo di contenitori molto più disponibile. L'opzione --anti forza l'inserimento di ogni istanza di contenitore del tuo gruppo in un nodo di elaborazione fisico separato, riducendo così la possibilità che si verifichi un arresto anomalo di tutti i contenitori nel gruppo a causa di un errore hardware. Potresti non essere in grado di utilizzare questa opzione con gruppi di dimensione maggiore in quanto ogni regione e organizzazione Bluemix ha a disposizione una serie di nodi di elaborazione limitata per la distribuzione. Se la distribuzione non riesce, riduci il numero di istanze del contenitore nel gruppo o rimuovi l'opzione --anti.
+
--desired DESIRED_INSTANCE_COUNT (facoltativo)
+
Il numero di istanze da te richiesto. Il valore predefinito è 2.
+
-e ENV_KEY=ENV_VAL(facoltativo)
+
Imposta la variabile di ambiente. In caso di più chiavi, elencale separatamente. Se sono incluse virgolette, includile racchiudendo sia il valore che il nome della variabile di ambiente. Ad esempio: `-e "key1=value1" -e "key2=value2" -e "key3=value3"`.
+
NOME GRUPPO (obbligatorio)
+
Il nome o l'ID del gruppo di contenitori.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di aggiornamento del gruppo di contenitori `my_group`: +``` +bluemix ic group-update --desired 5 my_group +``` + + +### bluemix ic groups +{: #bluemix_ic_groups} + +Elencare i gruppi di contenitori nel repository {{site.data.keyword.Bluemix_notm}} privato dell'organizzazione. + +``` +bluemix ic groups [-q] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: +
+
-q (facoltativo)
+
Visualizza solo gli ID gruppo
+
+ + +### bluemix ic images +{: #bluemix_ic_images} + +Visualizzare un elenco di tutte le immagini disponibili nel repository {{site.data.keyword.Bluemix_notm}} privato dell'organizzazione. Per ulteriori informazioni, vedi il comando [images ](https://docs.docker.com/engine/reference/commandline/images){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. L'elenco include l'ID immagine, la data di creazione e il nome dell'immagine. + +``` +bluemix ic images [-a|--all] [-f CONDITION] [--no-trunc] [-q|--quiet] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
-a|--all (facoltativo)
+
Includere tutti i livelli di immagine per ciascuna immagine del repository dell'organizzazione e non solo il più recente.
+
-f (facoltativo)
+
Filtrare l'elenco di immagini in base alla condizione fornita.
+
--no-trunc (facoltativo)
+
Non troncare l'output.
+
-q|--quiet (facoltativo)
+
Visualizzare solo gli ID numerici.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di elenco delle immagini disponibili per l'organizzazione: +``` +bluemix ic images +``` + + +### bluemix ic info +{: #bluemix_ic_info} + +Visualizzare un insieme di informazioni che descrivono lo stato dell'istanza del servizio cloud del contenitore. Le informazioni includono limite dei contenitori, utilizzo dei contenitori, contenitori in esecuzione, limite di memoria, utilizzo della memoria, limite dell'indirizzo IP mobile, utilizzo dell'indirizzo IP mobile, URL host CCS, URL host del registro e stato della modalità di debug. + +``` +bluemix ic info +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + + +### bluemix ic init +{: #bluemix_ic_init} + +Inizializzare l'ambiente dei contenitori sulla macchina locale in uso per sfruttare appieno le funzioni del servizio IBM Containers. + +``` +bluemix ic init +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +**Nota:** prima dell'inizializzazione, accertati che la CLI Docker (docker) sia installata e configurato nella tua variabile di ambiente PATH. Per passare a un'altra regione, utilizza il comando `bluemix region-set`. + +Esempi: + +Passare alla regione `us-south`: + +``` +bluemix region-set us-south +``` + + +### bluemix ic inspect +{: #bluemix_ic_inspect} + +Visualizzare le informazioni su un contenitore. Per ulteriori informazioni, vedi il comando [inspect](https://docs.docker.com/engine/reference/commandline/inspect){: new_window} nella guida di Docker. + +``` +bluemix ic inspect [IMAGE|images|CONTAINER] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
IMAGE (obbligatorio)
+
Visualizzare informazioni dettagliate su un'immagine specifica indicando l'ID o il nome dell'immagine.
+
images (obbligatorio)
+
Visualizzare informazioni dettagliate su tutte le immagini del tuo repository.
+
CONTAINER (obbligatorio)
+
Visualizzare informazioni dettagliate su un contenitore specifico, indicando l'ID o il nome del contenitore.
+
+ +**Suggerimento:** non è possibile specificare *IMMAGINE*, *images* o il *CONTENITORE* contemporaneamente. + +Esempi: + +Il seguente esempio mostra una richiesta di controllo di un contenitore denominato `proxy`: +``` +bluemix ic inspect proxy +``` + + +### bluemix ic ip-bind +{: #bluemix_ic_ip_bind} + +Eseguire il bind di un indirizzo IP a virgola mobile disponibile a un contenitore. + +``` +bluemix ic ip-bind CONTENITORE INDIRIZZO_IP +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
IP_ADDRESS (obbligatorio)
+
L'indirizzo IP da associare mediante bind.
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore da associare mediante bind.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di bind dell'indirizzo IP `192.123.12.12 al` contenitore `proxy`: +``` +bluemix ic ip-bind 192.123.12.12 proxy +``` + + +### bluemix ic ip-release +{: #bluemix_ic_ip_release} + +Rilasciare un indirizzo IP a virgola mobile dall'istanza del servizio cloud del contenitore. + +``` +bluemix ic ip-release IP_ADDRESS [IP_ADDRESS2 [...]] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
IP_ADDRESS (obbligatorio)
+
L'indirizzo IP da rilasciare.
+
+ + +### bluemix ic ip-request +{: #ip_request} +Richiedere un nuovo indirizzo IP mobile. + +``` +bluemix ic ip-request [-q] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
-q (facoltativo)
+
Elenca solo gli indirizzi IP, senza l'ID per i contenitori associati a tali indirizzi IP.
+
+ + +### bluemix ic ip-unbind +{: #bluemix_ic_ip_unbind} + +Annullare il bind di un indirizzo IP a virgola mobile dal relativo contenitore. + +Gli indirizzi IP pubblici sono una risorsa limitata di IBM Containers. Pertanto, gli indirizzi IP pubblici assegnati a uno spazio e non associati mediante bind a un contenitore vengono recuperati periodicamente dagli utenti della versione di prova, approssimativamente su base settimanale. Gli indirizzi IP non associati non sono mai recuperati dai clienti con pagamento a consumo o con una sottoscrizione. + +``` +bluemix ic ip-unbind INDIRIZZO_IP CONTENITORE +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
IP_ADDRESS (obbligatorio)
+
L'indirizzo IP da scollegare.
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore da scollegare.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di annullamento del bind dell'indirizzo IP `192.123.12.12` dal contenitore `proxy`: +``` +bluemix ic ip-unbind 192.123.12.12 proxy +``` + + +### bluemix ic ips +{: #bluemix_ic_ips} + +Elencare gli indirizzi IP a virgola mobile disponibili per l'utente che ha effettuato l'accesso. L'elenco include gli indirizzi IP e l'ID contenitore a cui sono collegati gli indirizzi IP. Se l'indirizzo IP non è in uso, non verrà visualizzato alcun ID contenitore. + +``` +bluemix ic ips [-q] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
-q (facoltativo)
+
Elenca solo gli indirizzi IP, senza l'ID per i contenitori associati a tali indirizzi IP.
+
+ + +Esempi: + +Il seguente esempio mostra una richiesta per ricevere un elenco di tutti gli indirizzi IP per l'organizzazione. +``` +bluemix ic ips -q +``` + + +### bluemix ic kill +{: #bluemix_ic_kill} + +Arrestare un processo in esecuzione in un contenitore senza arrestare il contenitore. Per ulteriori informazioni, vedi il comando [kill ](https://docs.docker.com/engine/reference/commandline/kill/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + +``` +bluemix ic kill [-s CMD|--signal CMD] CONTAINER +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
-s CMD|--signal CMD (facoltativo)
+
Inviare un comando al processo in esecuzione nel contenitore.
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
+ + +Esempi: + +Il seguente esempio mostra una richiesta di terminazione di un contenitore denominato `proxy`: +``` +bluemix ic kill proxy +``` + + +### bluemix ic logs +{: #bluemix_ic_logs} + +Mostra i log di output o di errore per un contenitore in esecuzione. Per ulteriori informazioni, vedi il comando [logs ](https://docs.docker.com/engine/reference/commandline/logs/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. +``` +bluemix ic logs [OPTIONS] CONTAINER +``` + + +### bluemix ic namespace-get +{: #bluemix_ic_namespace_get} + +Visualizzare il nome del repository di immagini {{site.data.keyword.Bluemix_notm}} privato dell'organizzazione a cui sei collegato. + +``` +bluemix ic namespace-get +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + + +### bluemix ic namespace-set +{: #bluemix_ic_namespace_set} + +Impostare il nome del repository di immagini {{site.data.keyword.Bluemix_notm}} privato dell'organizzazione a cui sei collegato. + +*Limitazione*: non puoi utilizzare un trattino `-` nel nome del tuo spazio dei nomi del repository. + +``` +bluemix ic namespace-set NOME +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
NOME (obbligatorio)
+
Una funzione da eseguire una sola volta per impostare lo spazio dei nomi del repository per la tua organizzazione, se non già impostato. Una volta impostato lo spazio dei nomi, reinizializza IBM Containers attraverso il comando `bluemix ic init` prima di continuare.
+
+ + +### bluemix ic pause +{: #pause} + +Mettere in pausa tutti i processi all'interno di un contenitore in esecuzione. Per ulteriori informazioni, vedi il comando [pause ](https://docs.docker.com/engine/reference/commandline/pause/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. Per arrestare un contenitore, vedi il comando [bluemix ic unpause](#unpause). + +``` +bluemix ic pause CONTENITORE +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: +
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
+ +Risposte: + +- Contenitore correttamente in pausa. + +- Comando non riuscito con il servizio cloud del contenitore + + `{messaggio}` + + Dove `{messaggio}` è +l'errore correlato. + +- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore + +Esempi: + +Il seguente esempio mostra una richiesta di messa in pausa di un contenitore denominato `proxy`: +``` +bluemix ic pause proxy +``` + + +### bluemix ic port +{: #bluemix_ic_port} + +Elenca le associazioni delle porte o un'associazione specifica del contenitore. Questo comando include il comando `docker port`. Per ulteriori informazioni, vedi il comando [port ](https://docs.docker.com/engine/reference/commandline/port/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + + +### bluemix ic ps +{: #bluemix_ic_ps} +Visualizzare un elenco di contenitori in esecuzione nello spazio dei nomi dell'utente che ha effettuato l'accesso. Per impostazione predefinita, questo comando mostra solo i contenitori in esecuzione. Per ulteriori informazioni, vedi il comando [ps ](https://docs.docker.com/engine/reference/commandline/ps/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + +``` +bluemix ic ps [-a|--all] [--filter env=SEARCH_CRITERIA] [-s|--size] [-l NUM|--limit NUM] [-q|--quiet] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
-a|--all (facoltativo)
+
Visualizzare tutti i contenitori, sia quelli in esecuzione sia quelli arrestati.
+
--filter env=SEARCH_CRITERIA (facoltativo)
+
Cerca i contenitori che hanno uno specifico valore di variabile di ambiente. Puoi filtrare i tuoi contenitori in base a qualsiasi chiave o valore di variabile di ambiente elencato nella sezione Env della tua risposta CLI quando ispezioni un contenitore. Sostituisci SEARCH_CRITERIA con la chiave o valore che stai cercando. I tuoi criteri di ricerca non devono necessariamente essere una corrispondenza esatta.
+
-s|--size (facoltativo)
+
Elencare le dimensioni dei contenitori.
+
-l NUM|--limit NUM (facoltativo)
+
Elencare i contenitori creati più di recente, dove NUM è il numero dei contenitori creati più di recente che desideri restituire.

Ad esempio, se hai creato i contenitori da node1 a node5 in modo sequenziale, il comando bluemix ic ps --limit 2 restituisce node4 e node5 perché sono gli ultimi due contenitori creati.
+
-q|--quiet (facoltativo)
+
Visualizzare solo gli ID contenitore.
+
+ + +Esempi: + +Il seguente esempio mostra una richiesta di visualizzazione di tutti i contenitori in esecuzione e arrestati: +``` +bluemix ic ps -a +``` + + +### bluemix ic rename +{: #bluemix_ic_rename} +Rinomina un contenitore. Per ulteriori informazioni, vedi il comando [rename ](https://docs.docker.com/engine/reference/commandline/rename/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + +``` +bluemix ic rename OLD_NAME NEW_NAME +``` +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
OLD_NAME (obbligatorio)
+
Il vecchio nome del contenitore.
+
NEW_NAME (obbligatorio)
+
Il nuovo nome del contenitore.
+
+ + +### bluemix ic reprovision +{: #bluemix_ic_reprovision} + +Ricrea il servizio IBM Containers nello spazio Bluemix a cui sei collegato. La quota originale per lo spazio viene mantenuta. + +Importante: quando esegui questo comando, nessuno dei tuoi singoli contenitori e gruppi in questo spazio verrà migrato nello spazio di cui è stato eseguito di nuovo il provisioning e verranno rimossi durante il processo di migrazione. + +``` +bluemix ic reprovision [--force|-f] [ENVIRONMENT_NAME] +``` +Opzioni del comando: + +
+
--force|-f (facoltativo)
+
Forza la nuova creazione del servizio IBM Containers nello spazio Bluemix.
+
AVAILABILITY_ZONE (facoltativo)
+
Il nome della zona di disponibilità IBM Containers in cui vengono distribuiti i tuoi contenitori. Se non si specifica alcuna zona di disponibilità, viene utilizzata la zona predefinita impostata per la regione.
+
+ + +### bluemix ic restart +{: #bluemix_ic_restart} + +Riavviare un contenitore. Per ulteriori informazioni, vedi il comando [restart ](https://docs.docker.com/engine/reference/commandline/restart/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + +``` +bluemix ic restart CONTAINER [-t SECS|--time SECS] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
-t SECONDI|--time SECONDI (facoltativo)
+
Il numero di secondi di attesa prima che il contenitore venga riavviato.
+
+ + +Risposte: + +- Contenitore riavviato correttamente. + +- Comando non riuscito con il servizio cloud del contenitore + + `{messaggio}` + + Dove `{messaggio}` è +l'errore correlato. + +- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore + +Esempi: + +Il seguente esempio mostra una richiesta di riavvio di un contenitore denominato `proxy`: +``` +bluemix ic restart proxy +``` + + +### bluemix ic rm +{: #bluemix_ic_rm} + +Rimuovere un contenitore. Per ulteriori informazioni, vedi il comando [rm ](https://docs.docker.com/engine/reference/commandline/rm/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + +``` +bluemix ic rm [-f|--force] CONTAINER +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
-f|--force (facoltativo)
+
Forza la rimozione di un contenitore in esecuzione o in errore.
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
+ +Risposte: + +- Contenitore rimosso correttamente. + +- Comando non riuscito con il servizio cloud del contenitore + + `{messaggio}` + + Dove `{messaggio}` è +l'errore correlato. + +- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore. + +Esempi: + +Il seguente esempio mostra una richiesta di rimozione di un contenitore denominato `proxy`: +``` +bluemix ic rm proxy +``` + + +### bluemix ic rmi +{: #bluemix_ic_rmi} + +Rimuovere un'immagine dallo spazio dei nomi dell'utente che ha effettuato l'accesso. Per ulteriori informazioni, vedi il comando [rmi ](https://docs.docker.com/engine/reference/commandline/rmi/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + +``` +bluemix ic rmi [-R REGISTRY|--registry REGISTRY] IMAGE +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
-R REGISTRO|--registry REGISTRO (facoltativo)
+
Modificare l'host del registro. Per impostazione predefinita verrà utilizzato il registro che hai specificato nel comando bluemix ic init.
+
IMAGE (obbligatorio)
+
Il nome dell'immagine che desideri rimuovere. Se non viene specificata +una tag nel nome immagine, per impostazione predefinita viene eliminata +l'immagine contrassegnata come latest.
+
+ +Risposte: + +- Rimozione di: `{IMMAGINE}` + + Dove `{IMMAGINE}` è il +nome dell'immagine che è stata rimossa. + +- Errore. Nessun host registro specificato. + +- Rimozione dell'immagine non riuscita - Impossibile connettersi al registro cloud del contenitore + +- Comando non riuscito con il servizio cloud del contenitore + + `{messaggio}` + + Dove `{messaggio}` è +l'errore correlato. + +Esempi: + +Il seguente esempio mostra una richiesta di rimozione dell'immagine `mynamespace/myimage:latest`: +``` +bluemix ic rmi registry.ng.bluemix.net/mynamespace/myimage:latest +``` + + +### bluemix ic route-map +{: #bluemix_ic_route_map} + +Stabilire la rotta per il traffico internet da utilizzare per accedere al gruppo di contenitori. Puoi utilizzare questo comando per stabilire una nuova rotta o aggiornarne una esistente. + +``` +bluemix ic route-map [-n HOST|--hostname HOST] [-d DOMAIN|--domain DOMAIN] CONTAINER_GROUP +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
-n HOST|--hostname HOST (facoltativo)
+
Il nome host della rotta. Il nome host costituisce la prima parte dell'URL completo della rotta pubblica, quale ad esempio mycontainerhost nell'URL mycontainerhost.mybluemix.net.
+
-d DOMINIO|--domain DOMINIO (facoltativo)
+
Il nome dominio della rotta, che costituisce la seconda parte dell'URL completo della rotta pubblica. Nella maggior parte dei casi, il dominio è mybluemix.net. Puoi anche utilizzare questo parametro per specificare un dominio privato.
+
GRUPPO_CONTENITORI (obbligatorio)
+
Il nome o l'ID del gruppo di contenitori.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di associazione della rotta del gruppo denominato `GROUP1`, dove `my_host` è il nome host e `mybluemix.net` è il dominio. +``` +bluemix ic route-map -n my_host -d mybluemix.net GROUP1 +``` + + +### bluemix ic route-unmap +{: #bluemix_ic_route_unmap} + +Stabilire la rotta per il traffico internet da utilizzare per accedere al gruppo di contenitori. Puoi utilizzare questo comando per stabilire una nuova rotta o aggiornarne una esistente. + +``` +bluemix ic route-unmap [-n HOST|--hostname HOST] [-d DOMAIN|--domain DOMAIN] CONTAINER_GROUP +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
-n HOST|--hostname HOST (facoltativo)
+
Il nome host della rotta.
+
-d DOMINIO|--domain DOMINIO (facoltativo)
+
Il nome dominio della rotta.
+
GRUPPO_CONTENITORI (obbligatorio)
+
Il nome o l'ID del gruppo di contenitori.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di annullamento dell'associazione della rotta del gruppo denominato `GRUPPO1`, dove `mio_host` è il nome dell'host e `organization.com` è il dominio. +``` +bluemix ic route-unmap -n mio_host -d organization.com GRUPPO1 +``` + + +### bluemix ic run +{: #bluemix_ic_run} + +Avviare un nuovo contenitore nel servizio cloud del contenitore da +un nome immagine. Per ulteriori informazioni, vedi il comando [run ](https://docs.docker.com/engine/reference/commandline/run/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + + +``` +bluemix ic run [-p PORT|--publish PORTA] [-P] [-m MEMORIA|--memory MEMORIA] [-e ENV|--env ENV] [--volume VOLUME:PERCORSO_CONTENITORE] -n NOME|--name NOME [--link NOME:ALIAS] [-it] IMMAGINE [CMD [CMD ...]] +``` +**Nota:** accertati che lo strumento di comando Cloud Foundry sia installato e di disporre di un token Cloud Foundry. Se si accede correttamente tramite `bluemix login` e `bluemix ic init` vengono creati i certificati e i token richiesti. + + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
-p PORTA|--publish PORTA (facoltativo)
+
Esporre la porta per il traffico HTTP. Includi le eventuali porte specificate nel Dockerfile per l'immagine che stai utilizzando. Puoi includere più porte con più opzioni -p. L'esposizione di una porta comporta automaticamente il bind di un indirizzo IP pubblico, se disponibile, al contenitore.

Se disponi già di un indirizzo IP nello spazio che desideri associare mediante bind al contenitore, puoi specificare l'indirizzo IP invece di eseguirne il bind successivamente. L'indirizzo IP deve essere specificato nel seguente formato: <indirizzo_IP>:<porta_contenitore>:<porta_contenitore>

Per ulteriori informazioni sulla richiesta di indirizzi IP per uno spazio, vedi il comando bluemix ic ip-request.

Quando specifichi una porta, stai rendendo l'applicazione disponibile al programma di bilanciamento del carico {{site.data.keyword.Bluemix_notm}} o ai contenitori dello stesso spazio {{site.data.keyword.Bluemix_notm}} che stanno provando a raggiungere l'host. Se nel Dockerfile è specificata una porta per l'immagine che stai utilizzando, includila.

Suggerimenti:
  • Per l'immagine Liberty Server certificata da IBM o una versione modificata di questa immagine, immetti la porta 9080.
  • Per l'immagine Node.js certificata da IBM o una versione modificata di questa immagine, immetti la porta 8000.
+
-P (facoltativo)
+
Esporre automaticamente le porte specificate nel Dockerfile dell'immagine per il traffico HTTP.
+
-m MEMORIA|--memory MEMORIA (facoltativo)
+
Assegnare un limite di memoria al gruppo in MB. Quando crei un gruppo di contenitori dalla CLI, il valore predefinito per ogni istanza del contenitore è 64 MB. Quando crei un gruppo di contenitori dal Dashboard {{site.data.keyword.Bluemix_notm}}, il valore predefinito per ciascuna istanza è 256 MB. I valori accettati sono 64, 256, 512, 1024 e 2048. Una volta assegnato, il limite di memoria non può essere modificato.
+
-e AMB|--env AMB (facoltativo)
+
Impostare la variabile di ambiente, dove AMB è una coppia chiave=valore. In caso di più chiavi, elencale separatamente. Se includi virgolette, fallo racchiudendo sia il valore che il nome della variabile di ambiente. Ad esempio: -e "key1=value1" -e "key2=value2" -e "key3=value3". La seguente tabella mostra alcune variabili di ambiente comunemente utilizzate che puoi specificare:
+
+ + +| Variabile di ambiente | Descrizione | +| :----------------------------- | :------------------------------ | +| CCS_BIND_APP=*<nome_applicazione>* | Eseguire il bind di un servizio a un contenitore. Utilizza la variabile di ambiente `CCS_BIND_APP` per eseguire il bind di un'applicazione al contenitore. L'applicazione viene associata mediante bind al servizio di destinazione e funge da ponte che consente a {{site.data.keyword.Bluemix_notm}} di portare le informazioni `VCAP_SERVICES` dell'applicazione ponte nell'istanza del contenitore in esecuzione. Per ulteriori informazioni sulla creazione di un'applicazione ponte, vedi [Esecuzione del bind di un servizio a un contenitore](/docs/containers/container_integrations_binding.html){: new_window}. | +| CCS_BIND_SRV=*<nome_istanza_servizio1>*,*<nome_istanza_servizio2>* | Per eseguire direttamente il bind di un servizio Bluemix a un contenitore senza utilizzare un'applicazione ponte, utilizza CCS_BIND_SRV. Questo bind consente a Bluemix di inserire le informazioni VCAP_SERVICES nell'istanza del contenitore in esecuzione. Per elencare più servizi Bluemix, puoi includerli come parte della stessa variabile di ambiente. | +| LOG_LOCATIONS=*<>percorso_verso_file* | Aggiungere un file di log da monitorare nel contenitore. Includi la variabile di ambiente `LOG_LOCATIONS` in un percorso verso il file di log. | +{: caption="Table 9. Commonly used environment variables" caption-side="top"} + + +
+
--volume VOLUME:PERCORSO_CONTENITORE[:ro] (facoltativo)
+
Collegare un volume a un contenitore, specificando i dettagli nel formato IDVolume:PercorsoContenitore[:ro]. +
    +
  • VOLUME: l'ID o nome del volume.
    • +
  • PERCORSO_CONTENITORE: il percorso assoluto per il volume del contenitore.
    • +
  • ro: facoltativo. La specifica di ro rende il volume di sola lettura invece della lettura/scrittura predefinita.
+
+
-n NOME|--name NOME (facoltativo)
+
Assegnare un nome al contenitore.
Suggerimento: il nome del contenitore deve iniziare con una lettera. Il nome può includere lettere maiuscole, lettere minuscole, numeri, punti., caratteri di sottolineatura _, o trattini -.
+
--link NOME:ALIAS (facoltativo)
+
Ogni volta che desideri che un contenitore comunichi con un altro contenitore in esecuzione, puoi farvi riferimento utilizzando un alias del nome host.
+
-it (facoltativo)
+
Eseguire il contenitore in modalità interattiva. Una volta creato il contenitore, mantieni l'input standard visualizzato. Immetti exit per uscire.
+
IMAGE (obbligatorio)
+
L'immagine da includere nel contenitore. L'immagine può essere seguita da un elenco di comandi, ma non da opzioni. Includi tutte le opzioni prima di specificare un'immagine. Includi tutte le opzioni prima di specificare l'immagine.

Se utilizzi un'immagine nel repository {{site.data.keyword.Bluemix_notm}} privato della tua organizzazione, specificala con il seguente formato: registry.ng.bluemix.net/SPAZIO_NOMI/IMMAGINE.

Se utilizzi un'immagine fornita da IBM Containers, specificala nel seguente formato: registry.ng.bluemix.net/IMMAGINE.
+
CMD (facoltativo)
+
Il comando e gli argomenti trasmessi al gruppo di contenitori per l'esecuzione. Questo comando deve essere un comando a esecuzione prolungata. Non utilizzare un comando di breve durata che non viene eseguito per molto tempo, quale ad esempio /bin/date, poiché tale comando potrebbe provocare un arresto anomalo del contenitore.
+
+ + +Esempi: + +Esegui il comando a esecuzione prolungata `sh -c "while true; do date; sleep 20; done"` sul contenitore `mio_contenitore` creato sull'immagine `registry.ng.bluemix.net/ibmnode`. +``` +bluemix ic run --name mio_contenitore registry.ng.bluemix.net/ibmnode -- sh -c "while true; do date; sleep 20; done" +``` + + +Creare e successivamente riavviare un contenitore `proxy` con un limite di memoria di `1024` MB utilizzando l'immagine `mio_spazioNomi/nginx`, dove `mio_spazioNomi` è lo spazio dei nomi associato agli utenti che hanno effettuato l'accesso. +``` +bluemix ic run -n proxy -m 1024 registry.ng.bluemix.net/my_namespace/nginx +``` + +Creare e successivamente riavviare un contenitore utilizzando l'immagine `mio_spazioNomi/blog`, trasmettere le credenziali come variabili di ambiente. `mio_spazioNomi` è lo spazio dei nomi associato agli utenti che hanno effettuato l'accesso. +``` +bluemix ic run -n mio_contenitore -e USER=johnsmith -e PASS=password registry.ng.bluemix.net/mio_spazioNomi/blog +``` + +Aggiungere un volume a un contenitore utilizzando l'immagine `mio_spazioNomi/blog`, dove `mio_spazioNomi` è lo spazio dei nomi associato agli utenti che hanno effettuato l'accesso. +``` +bluemix ic run -n mio_contenitore -v VolId1:/first/path -v VolId2:/second/path registry.ng.bluemix.net/mio_spazioNomi/blog +``` + + +### bluemix ic service-bind +{: #bluemix_ic_service-bind} + +Aggiungi un servizio a un gruppo di contenitori in esecuzione. Questo comando è disponibile solo per i gruppi di contenitori. I singoli contenitori devono essere associati tramite bind a un servizio come parte del comando bluemix ic run. + +``` +bluemix ic service-bind GROUP_NAME SERVICE_INSTANCE +``` +Opzioni del comando: + +
+
NOME GRUPPO (obbligatorio)
+
L'ID o il nome del gruppo.
+
ISTANZA_SERVIZIO (obbligatorio)
+
Il nome dell'istanza del servizio da aggiungere al gruppo di contenitori.
+
+ + +### bluemix ic service-unbind +{: #bluemix_ic_service-unbind} + +Rimuovi un servizio da un gruppo di contenitori in esecuzione. Questo comando è disponibile solo per i gruppi di contenitori. I singoli contenitori devono rimuovere il contenitore e crearne uno nuovo senza il servizio. + +``` +bluemix ic service-unbind GROUP_NAME SERVICE_INSTANCE +``` +Opzioni del comando: + +
+
NOME GRUPPO (obbligatorio)
+
L'ID o il nome del gruppo.
+
ISTANZA_SERVIZIO (obbligatorio)
+
Il nome dell'istanza del servizio da aggiungere al gruppo di contenitori.
+
+ + +### bluemix ic start +{: #ic_start} +Avviare un contenitore arrestato. Per ulteriori informazioni, vedi il comando [start ](https://docs.docker.com/engine/reference/commandline/start/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. Per arrestare un contenitore, vedi il comando [bluemix ic stop](#ic_stop). + +``` +bluemix ic start CONTENITORE +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
+ + +Risposte: + +- Contenitore avviato correttamente. + +- Comando non riuscito con il servizio cloud del contenitore + + `{messaggio}` + + Dove `{messaggio}` è +l'errore correlato. + +- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore + +Esempi: + +Il seguente esempio mostra una richiesta di avvio di un contenitore denominato `proxy`. +``` +bluemix ic start proxy +``` + + +### bluemix ic stats +{: #bluemix_ic_stats} + +Visualizzare le statistiche di utilizzo in tempo reale per uno o più contenitori. Utilizza `CTRL+C` per chiudere. Per ulteriori informazioni, vedi il comando [stats](https://docs.docker.com/engine/reference/commandline/stats/){: new_window} nella guida di Docker. + +``` +bluemix ic stats [--no-stream] CONTENITORE [CONTENITORE] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
--no-stream (facoltativo)
+
Visualizzare solo il risultato più recente, senza includere informazioni precedenti.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di visualizzazione delle statistiche più recenti su un contenitore: +``` +bluemix ic stats --no-stream mio_contenitore +``` + + +### bluemix ic stop +{: #ic_stop} +Arrestare un contenitore in esecuzione. Per ulteriori informazioni, vedi il comando [stop ](https://docs.docker.com/engine/reference/commandline/stop/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. Per avviare un contenitore, vedi il comando [bluemix ic start](#ic_start). + +``` +bluemix ic stop CONTAINER [-t SECS|--time SECS] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
-t SECONDI|--time SECONDI (facoltativo)
+
Il numero di secondi di attesa prima che il contenitore venga arrestato.
+
+ +Risposte: + +- Contenitore arrestato correttamente. + +- Comando non riuscito con il servizio cloud del contenitore + + `{messaggio}` + + Dove `{messaggio}` è +l'errore correlato. + +- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore + +Esempi: + +Il seguente esempio mostra una richiesta di arresto di un contenitore denominato `proxy`. +``` +bluemix ic stop proxy +``` + + +### bluemix ic top +{: #bluemix_ic_top} + +Mostrare i processi in esecuzione nel contenitore. Per ulteriori informazioni, vedi il comando [top ](https://docs.docker.com/engine/reference/commandline/top/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + +``` +bluemix ic top CONTENITORE [CONTENITORE] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di visualizzazione dei processi di un contenitore denominato `mio_contenitore`. +``` +bluemix ic top mio_contenitore +``` + + +### bluemix ic unpause +{: #unpause} + +Riprendere tutti i processi all'interno di un contenitore in esecuzione. Per ulteriori informazioni, vedi il comando [unpause ](https://docs.docker.com/engine/reference/commandline/unpause/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. Per mettere in pausa un contenitore, vedi il comando [bluemix ic pause](#pause). + +``` +bluemix ic unpause CONTENITORE +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
+ +Risposte: + +- Esecuzione del contenitore ripresa correttamente. + +- Comando non riuscito con il servizio cloud del contenitore + + `{messaggio}` + + Dove `{messaggio}` è +l'errore correlato. + +- Comando non riuscito - Impossibile connettersi al servizio cloud del contenitore + +Esempi: + +Il seguente esempio mostra una richiesta di ripresa dell'esecuzione di un contenitore denominato `proxy`: +``` +bluemix ic unpause proxy +``` + + +### bluemix ic unprovision +{: #bluemix_ic_unprovision} + +Elimina il servizio IBM Containers dallo spazio Bluemix a cui sei collegato. + +Attenzione: quando esegui questo comando, tutti i tuoi singoli contenitori e gruppi di contenitori vengono persi. Il tuo spazio sarà ancora disponibile in Bluemix. Per iniziare a utilizzare di nuovo IBM Containers, devi eseguire `bluemix ic reprovision` per effettuare nuovamente il provisioning del servizio IBM Containers. + +``` +bluemix ic reprovision [--force|-f] +``` +Opzioni del comando: + +
+
--force|-f (facoltativo)
+
Forza l'eliminazione di Bluemix dallo spazio Bluemix.
+
+ + +### bluemix ic version +{: #bluemix_ic_version} + +Mostrare la versione di Docker e dell'API IBM Containers. + +``` +bluemix ic version +``` + +Prerequisiti: Docker + +Per visualizzare la versione di IBM Containers, eseguire `bluemix ic info`. Per ulteriori informazioni, vedi il comando [version ](https://docs.docker.com/engine/reference/commandline/version/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + + +### bluemix ic volume-create +{: #bluemix_ic_volume_create} + +Creare un volume. + +``` +bluemix ic volume-create NOME_VOLUME NOME_FS +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
NOME_FS (facoltativo)
+
Il nome della condivisione file. Se non viene denominata o non è disponibile alcuna condivisione file, il volume sarà creato nella condivisione file predefinita dello spazio.
+
NOME_VOLUME (obbligatorio)
+
Il nome del volume. Il nome può contenere lettere minuscole, numeri, caratteri di sottolineatura (_) e trattini (-).
+
+ + +Esempi: + +Il seguente esempio mostra una richiesta di creazione di un volume. +``` +bluemix ic volume-create volume_name fileshare_name +``` + + +### bluemix ic volume-fs +{: #bluemix_ic_volume_fs} + +Elencare le condivisioni file. + +``` +bluemix ic volume-fs +``` + + +### bluemix ic volume-fs-create +{: #bluemix_ic_volume_fs_create} + +Creare una condivisione file. + +``` +bluemix ic volume-fs-create NOME_CONDIVISIONE_FILE +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
NOME_CONDIVISIONE_FILE (obbligatorio)
+
Il nome della condivisione file. Il nome può contenere lettere minuscole, numeri, caratteri di sottolineatura (_) e trattini (-).
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di creazione di una condivisione file. +``` +bluemix ic volume-fs-create my_file_share +``` + + +### bluemix ic volume-fs-flavors +{: #bluemix_ic_volume_fs_flavors} + +Elencare tutte le caratteristiche della condivisione file. + +``` +bluemix ic volume-fs-flavors +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + + +### bluemix ic volume-fs-inspect +{: #bluemix_ic_volume_fs_inspect} + +Ispezionare una condivisione file. + +``` +bluemix ic volume-fs-inspect NOME_CONDIVISIONE_FILE +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
NOME_CONDIVISIONE_FILE (obbligatorio)
+
Il nome della condivisione file.
+
+ +Esempi: + +Il seguente esempio è una richiesta di ispezione di una condivisione file, dove `my_file_share` è il nome della condivisione file. +``` +bluemix ic volume-fs-inspect my_file_share +``` + + +### bluemix ic volume-fs-remove +{: #bluemix_ic_volume_fs_remove} + +Rimuovere una condivisione file. + +``` +bluemix ic volume-fs-remove NOME_CONDIVISIONE_FILE +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
NOME_CONDIVISIONE_FILE (obbligatorio)
+
Il nome della condivisione file.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di rimozione di una condivisione file, dove `my_file_share` è il nome della condivisione file. +``` +bluemix ic volume-fs-remove my_file_share +``` + + +### bluemix ic volume-inspect +{: #bluemix_ic_volume_inspect} + +Ispezionare un volume. + +``` +bluemix ic volume-inspect NOME_VOLUME +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
NOME_VOLUME (obbligatorio)
+
Il nome del volume.
+
+ +Esempi: + +Il seguente esempio è una richiesta di ispezione di un volume, dove `nome_volume` è il nome del volume. +``` +bluemix ic volume-inspect volume_name +``` + + +### bluemix ic volume-remove +{: #bluemix_ic_volume_remove} + +Rimuovere un volume. + +``` +bluemix ic volume-remove NOME_VOLUME +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + +Opzioni del comando: + +
+
NOME_VOLUME (obbligatorio)
+
Il nome del volume.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di rimozione di un volume, dove `nome_volume` è il nome del volume. +``` +bluemix ic volume-remove nome_volume +``` + + +### bluemix ic volumes +{: #bluemix_ic_volumes} + +Elencare i volumi. + +``` +bluemix ic volumes +``` + +Prerequisiti: Endpoint, Accesso, Destinazione + + +### bluemix ic wait +{: #bluemix_ic_wait} + +Chiudere un contenitore e visualizzare il codice di uscita come conferma. Per ulteriori informazioni, vedi il comando [wait ](https://docs.docker.com/engine/reference/commandline/wait/){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) nella guida di Docker. + +``` +bluemix ic wait CONTENITORE [CONTENITORE] +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di chiusura di un contenitore denominato `mio_contenitore`: +``` +bluemix ic wait mio_contenitore +``` + + +### bluemix ic wait-status +{: #bluemix_ic_wait_status} + +Attendere che un singolo contenitore o gruppo di contenitori raggiunga lo stato non temporaneo. Durante questo tempo di attesa, la riga di comando non viene restituita e non puoi immettere i comandi. Non appena il contenitore raggiunge lo stato non temporaneo, viene visualizzato il messaggio OK. Per i singoli contenitori, gli stati non temporanei includono In esecuzione, Arresto, Arresto anomalo, In pausa o Sospeso. Per i gruppi di contenitori, gli stati non temporanei includono CREATE_COMPLETE, UPDATE_COMPLETE o FAILED + +``` +bluemix ic wait-status CONTAINER +``` + +Prerequisiti: Endpoint, Accesso, Destinazione, Docker + +Opzioni del comando: + +
+
CONTAINER (obbligatorio)
+
Il nome o l'ID del contenitore.
+
+ +Esempi: + +Il seguente esempio mostra una richiesta di chiusura di un contenitore denominato `mio_contenitore`: +``` +bluemix ic wait mio_contenitore +``` + + + +# Link correlati +{: #rellinks} + +## Link correlati +{: #general} + +* [bx tool ](http://clis.ng.bluemix.net/ui/home.html){: new_window} ![icona link esterno](../../../icons/launch-glyph.svg) diff --git a/cli/nl/it/reference/cfcommands/index.md b/cli/nl/it/reference/cfcommands/index.md index ce27b6c01..647e5e672 100644 --- a/cli/nl/it/reference/cfcommands/index.md +++ b/cli/nl/it/reference/cfcommands/index.md @@ -1,834 +1,834 @@ ---- - - - -copyright: - - years: 2016, 2017 - -lastupdated: "2017-01-12" - - ---- - - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} - - -# Comandi Cloud Foundry (cf) -{: #cf} - -L'interfaccia di riga comando (CLI) Cloud Foundry (cf) fornisce una serie di comandi per gestire le tue applicazioni. Le seguenti informazioni elencano i comandi cf più utilizzati per la gestione delle applicazioni e includono i relativi nomi, opzioni, utilizzo, prerequisiti, descrizioni ed esempi. Per elencare tutti i comandi cf e le informazioni di guida associate, utilizza `cf help`. Utilizza `cf nome_comando -h` per visualizzare delle informazioni di guida dettagliate per uno specifico comando. -{: shortdesc} - -**Nota**: se la tua rete contiene un server proxy HTTP tra l'host che esegue i comandi cf e l'endpoint API Cloud Foundry, devi specificare il nome host o l'indirizzo IP del server proxy impostando la variabile di ambiente `HTTP_PROXY`. Per i dettagli,vedi [Utilizzo della CLI cf con un server proxy HTTP ![icona link esterno](../../../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/devguide/installcf/http-proxy.html){: new_window}. - - -## Indice dei comandi della CLI Cloud Foundry -{: #CLIname_commands_index} - -Utilizza l'indice nella seguente tabella per fare riferimento ai comandi Cloud Foundry più utilizzati: - - - - - - - - - - - - - - - - -
Tabella 1. Comandi generali di Cloud Foundry
Comandi generali di Cloud Foundry
[api](/docs/cli/reference/cfcommands/index.html#cf_api)[help](/docs/cli/reference/cfcommands/index.html#cf_help)[login](/docs/cli/reference/cfcommands/index.html#cf_login)[stacks](/docs/cli/reference/cfcommands/index.html#cf_stacks)[target](/docs/cli/reference/cfcommands/index.html#cf_target)[-v ](/docs/cli/reference/cfcommands/index.html#cf_v)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Tabella 2. Comandi per la gestione di applicazioni, spazi e servizi
Comandi per la gestione di applicazioni, spazi e servizi
[apps](/docs/cli/reference/cfcommands/index.html#cf_apps)[bind-service](/docs/cli/reference/cfcommands/index.html#cf_bind-service)[create-service](/docs/cli/reference/cfcommands/index.html#cf_create-service)[create-space](/docs/cli/reference/cfcommands/index.html#cf_create-space)[delete](/docs/cli/reference/cfcommands/index.html#cf_delete)
[delete-space](/docs/cli/reference/cfcommands/index.html#cf_delete-space)[events](/docs/cli/reference/cfcommands/index.html#cf_events)[logs](/docs/cli/reference/cfcommands/index.html#cf_logs)[marketplace](/docs/cli/reference/cfcommands/index.html#cf_marketplace)[push (eseguire il)](/docs/cli/reference/cfcommands/index.html#cf_push)
[ingrandire](/docs/cli/reference/cfcommands/index.html#cf_scale)[services](/docs/cli/reference/cfcommands/index.html#cf_services) - [set-env](/docs/cli/reference/cfcommands/index.html#cf_set-env)[ssh](/docs/cli/reference/cfcommands/index.html#cf_ssh)[stop](/docs/cli/reference/cfcommands/index.html#cf_stop)
- -## cf api -{: #cf_api} - -Utilizza questo comando per visualizzare o specificare l'URL dell'endpoint API di {{site.data.keyword.Bluemix_notm}}. - -``` -cf api [BluemixServerURL] [--skip-ssl-validation] [--unset] -``` - -Prerequisiti: Nessuno. - -Opzioni del comando: - -
-
BluemixServerURL (facoltativo)
-
L'URL dell'endpoint API Bluemix che devi specificare quando stabilisci una connessione a {{site.data.keyword.Bluemix_notm}}. Solitamente, questo URL è `https://api.{DomainName}`. - Se vuoi visualizzare l'URL dell'endpoint API che stai attualmente utilizzando, non hai bisogno di specificare questo parametro per il comando cf api.
-
* --skip-ssl-validation
-
Disabilita il processo di convalida SSL. L'utilizzo di questo parametro può causare problemi di sicurezza.
-
* --unset
-
Rimuove le informazioni di connessione per tutti gli endpoint API.
-
- -Esempi: - -Visualizza l'endpoint API corrente -``` -cf api -``` -{: codeblock} - -Rimuovi la connessione a tutti gli endpoint API per api.ng.bluemix.net -``` -cf api api.ng.bluemix.network --unset -``` -{: codeblock} - -Disabilita il processo di convalida SSL per api.ng.bluemix.network -``` -cf api api.ng.bluemix.network --skip-ssl-validation -``` -{: codeblock} - - -## cf apps -{: #cf_apps} - -Elenca tutte le applicazioni da te distribuite nello spazio corrente. Viene visualizzato anche lo -stato di ciascuna applicazione. - -Presumi di avere una istanza per un'applicazione; nella colonna delle istanze della risposta dal comando cf apps, vedi 1/1 se la tua applicazione è attiva e 0/1 se è invece inattiva. Se vedi ?/1, che indica che lo stato dell'istanza dell'applicazione è sconosciuto, puoi copiare l'URL dell'applicazione nel tuo browser per verificare se l'applicazione risponde oppure puoi controllare la parte finale del log utilizzando il comando `cf logs appname` per vedere se l'applicazione sta generando il contenuto del log. - -``` -cf apps -``` - -Prerequisiti: `cf api`, `cf login`, `cf target` - - -## cf bind-service -{: #cf_bind-service} - -Esegue il bind di un'istanza del servizio -esistente alla tua applicazione. - -``` -cf bind-service nome_applicazione istanza_servizio -``` - -Prerequisiti: `cf api`, `cf login`, `cf target` - -Opzioni del comando: - -
-
nome_applicazione (obbligatorio)
-
Il nome dell'applicazione.
-
istanza_servizio (obbligatorio)
-
Il nome dell'istanza del servizio esistente.
-
- -Esempi: - -Esegui il bind di un'istanza del servizio denominata `my_dataworks` alla tua applicazione denominata `my_app`. -``` -cf bind-service my_app my_dataworks -``` -{: codeblock} - - -## cf create-service -{: #cf_create-service} - -Crea un'istanza del servizio - -``` -cf create-service nome_servizio piano_servizio istanza_servizio -``` - -Prerequisiti: `cf api`, `cf login`, `cf target` - -Opzioni del comando: - -
-
nome_servizio (obbligatorio)
-
Il nome del servizio.
-
piano_servizio (obbligatorio)
-
Il nome del piano di servizio.
-
istanza_servizio (obbligatorio)
-
Il nome che vuoi utilizzare per la nuova istanza del servizio da te -creata.
-
- -Esempi: - -Crea un'istanza del servizio {{site.data.keyword.dataworks_short}} con un piano `free`. -``` -cf create-service DataWorks free my_dataworks -``` -{: codeblock} - - -## cf create-space -{: #cf_create-space} - -Crea uno spazio. - -``` -cf create-space nome_spazio [-o] [-q] -``` - -Prerequisiti: `cf api`, `cf login` - -Opzioni del comando: - -
-
nome_spazio (obbligatorio)
-
Il nome dello spazio.
-
*-o* (facoltativo)
-
Il nome dell'organizzazione in cui vuoi creare uno spazio.
-
*-q* (facoltativo)
-
La quota da assegnare allo spazio appena creato. Se non viene specificata, viene automaticamente assegnata una quota predefinita.
-
- -Esempi: - -Crea uno spazio denominato nuovo_spazio -``` -cf create-space nuovo_spazio -``` -{: codeblock} - - -## cf delete -{: #cf_delete} - -Elimina -un'applicazione esistente. - -``` -cf delete nome_applicazione [-f] [-r] -``` - -Prerequisiti: `cf api`, `cf login`, `cf target` - -Opzioni del comando: - -
-
nome_applicazione (obbligatorio)
-
Il nome dell'applicazione.
-
*-f* (facoltativo)
-
Forza l'eliminazione dell'applicazione senza alcuna conferma.
-
*-r* (facoltativo)
-
Elimina tutti i nomi dominio associati all'applicazione.
-
- -Esempi: - -Elimina un'applicazione denominata `my_app` (richiede conferma). -``` -cf delete my_app -``` -{: codeblock} - -Elimina un'applicazione denominata `my_app` senza richiedere conferma. -``` -cf delete my_app -f -``` -{: codeblock} - -Elimina un'applicazione denominata `my_app` e tutti i nomi dominio associati a `my_app`. -``` -cf delete my_app -r -``` -{: codeblock} - -Elimina un'applicazione denominata `my_app` e tutti i nomi dominio associati a `my_app` senza richiedere conferma. -``` -cf delete my_app -f -r -``` -{: codeblock} - - -## cf delete-space -{: #cf_delete-space} - -Elimina uno spazio. - -``` -cf delete-space nome_spazio [-f] -``` - -Prerequisiti: `cf api`, `cf login` - -Opzioni del comando: - -
-
nome_spazio (obbligatorio)
-
Il nome dello spazio.
-
*-f* (facoltativo)
-
Forza l'eliminazione dello spazio senza alcuna conferma.
- *Nota:* l'eliminazione di uno spazio è un'operazione irreversibile. -
- -Esempi: - -Elimina un'applicazione denominata `my_app` (richiede conferma). -``` -cf delete my_app -``` -{: codeblock} - -Elimina un'applicazione denominata `my_app` senza richiedere conferma. -``` -cf delete my_app -f -``` -{: codeblock} - -Elimina un'applicazione denominata `my_app` e tutti i nomi dominio associati a `my_app`. -``` -cf delete my_app -r -``` -{: codeblock} - -Elimina un'applicazione denominata `my_app` e tutti i nomi dominio associati a `my_app` senza richiedere conferma. -``` -cf delete my_app -f -r -``` -{: codeblock} - - -## cf events -{: #cf_events} - -Visualizza -gli eventi di runtime che sono correlati ad un'applicazione. - -``` -cf events [nomeapplicazione] -``` - -Prerequisiti: `cf api`, `cf login`, `cf target` - -Opzioni del comando: - -
-
nomeapplicazione
-
Il nome dell'applicazione.
-
- -Esempi: - -Visualizza gli eventi per un'applicazione denominata `my_app`. -``` -cf events my_app -``` -{: codeblock} - - -## cf help -{: #cf_help} - -Visualizza le informazioni di guida per tutti i comandi cf o per un comando cf specifico. - -``` -cf help [nome_comando] -``` - -Prerequisiti: Nessuno. - -Opzioni del comando: - -
-
nome_comando (facoltativo)
-
Il nome di un comando.
-
- -Esempi: - -Visualizza le informazioni di guida per tutti i comandi cf. -``` -cf help -``` -{: codeblock} - -Visualizza le informazioni di guida per il comando di eventi. -``` -cf help events -``` -{: codeblock} - - -## cf login -{: #cf_login} - -Ti fa accedere a {{site.data.keyword.Bluemix_notm}}. - -**Nota**: se stai eseguendo l'accesso con un [ID federato](/docs/admin/account.html#signup), devi utilizzare il parametro SSO (single sign-on) per accedere. - -``` -cf login [-a url] [-u user_name] [-p password] [-sso] [-o organization_name] [-s space_name] [--skip-ssl-validation] -``` - -Prerequisiti: Nessuno. - -Opzioni del comando: - -
-
*-a* https://api.{DomainName} (facoltativo)
-
L'URL dell'endpoint API di {{site.data.keyword.Bluemix_notm}}.
-
*-u* nome_utente (facoltativo)
-
Il tuo nome utente.
-
*-p* password (facoltativo)
-
La tua password.
-
*Importante:* se fornisci la tua password utilizzando il parametro *-p* sull'interfaccia riga di comando, la password potrebbe essere registrata nella cronologia della riga di comando. Per motivi di sicurezza, evita di fornire la password utilizzando il parametro --p. Immetti invece la password quando te lo chiede l'interfaccia riga di comando.
-
*-sso*
-
Devi utilizzare l'opzione SSO (single sign-on ) quando accedi con un ID federato. Non è necessario quando accedi con un ID IBM. Se tenti di collegarti con un ID federato e non specifichi il parametro SSO, ti verrà richiesto di includerlo. Utilizza la richiesta del parametro SSO per immettere la passcode monouso all'accesso.
-
*-o*nome_organizzazione
-
Il nome dell'organizzazione alla quale desideri effettuare l'accesso.
-
*-s*nome_spazio
-
Il nome dello spazio al quale desideri effettuare l'accesso.
-
*--skip-ssl-validation* (facoltativo)
-
Disabilita il processo di convalida SSL. L'utilizzo di questo parametro può causare problemi di sicurezza.
-
- -*Nota:* se fornisci la tua password nel parametro *-p* di questo comando, la tua password potrebbe essere registrata nel file di cronologia dei comandi della shell e potrebbe essere visibile ad altri utenti del sistema operativo locale. - -Esempi: - -Accedi a {{site.data.keyword.Bluemix_notm}}. -``` -cf login -``` -{: codeblock} - -Accedi a {{site.data.keyword.Bluemix_notm}} con un endpoint definito di `https://api.ng.bluemix.net`. -``` -cf login -a https://api.ng.bluemix.net -``` -{: codeblock} - -Accedi a {{site.data.keyword.Bluemix_notm}} con un endpoint definito di `https://api.ng.bluemix.net`, un nome utente `nome_utente` e nessuna password specificata per motivi di sicurezza. -``` -cf login -a https://api.ng.bluemix.net -u nome_utente -``` -{: codeblock} - -Accedi a {{site.data.keyword.Bluemix_notm}} con un endpoint definito di `https://api.ng.bluemix.net`, un nome utente `nome_utente`, nessuna password specificata per motivi di sicurezza e un nome organizzazione `nome_organizzazione` e nome spazio `nome_spazio`. -``` -cf login -a https://api.ng.bluemix.net -u nome_utente -o nome_organizzazione -s nome_spazio -``` -{: codeblock} - - -## cf logs -{: #cf_logs} - -Visualizza i flussi di log -STDOUT e STDERR di un'applicazione. - -``` -cf logs nomeapplicazione [--recent] -``` -Prerequisiti: `cf api`, `cf login`, `cf target` - -Opzioni del comando: - -
-
nomeapplicazione
-
Il nome dell'applicazione.
-
*--recent* (facoltativo)
-
Richiama i log recenti.
-
- -Esempi: - -Visualizza i flussi di log per un'applicazione denominata `my_app`. -``` -cf logs my_app -``` -{: codeblock} - -Visualizza i flussi di log recenti per un'applicazione denominata `my_app`. -``` -cf logs my_app --recent -``` -{: codeblock} - - -## cf marketplace -{: #cf_marketplace} - -Elenca tutti -i servizi disponibili nel marketplace. I servizi elencati da questo comando sono visualizzati anche nel catalogo {{site.data.keyword.Bluemix_notm}}. - -``` -cf marketplace -``` -Prerequisiti: `cf api` - -Opzioni del comando: Nessuna. - -Esempi: - -Elenca tutti i servizi nel marketplace -``` -cf marketplace -``` -{: codeblock} - - -## cf push -{: #cf_push} - -Distribuisce una nuova applicazione a {{site.data.keyword.Bluemix_notm}} oppure aggiorna un'applicazione esistente in {{site.data.keyword.Bluemix_notm}}. - -``` -cf push appname [-b buildpack_name] [-c start_command] [-f manifest_path] [-i instance_number] [-k disk_limit] [-m memory_limit] [-n host_name] [-p app_path] [-s stack_name] [-t timeout_length] [--no-hostname] [--no-manifest] [--no-route] [--no-start] [--random-route] -``` - -Prerequisiti: `cf api`, `cf login`, `cf target` - -Opzioni del comando: - -
-
nome_applicazione (obbligatorio)
-
Il nome dell'applicazione.
-
*-b* nome_pacchettodibuild (facoltativo)
-
Il nome del pacchetto di build. Il nome_pacchettodibuild può essere un pacchetto di build personalizzato in base al nome (ad esempio liberty-for-java) oppure un URL Git (ad esempio https://github.com/cloudfoundry/java-buildpack.git) oppure un URL Git con un ramo o tag (ad esempio, https://github.com/cloudfoundry/java-buildpack.git#v3.3.0 per la tag v3.3.0).
-
*-c* comando_di_avvio (facoltativo)
-
Il comando di avvio della tua applicazione. Per utilizzare il comando di avvio predefinito, specifica un valore null per questa opzione.
-
*-f* percorso_manifest (facoltativo)
-
Il percorso al file manifest. Il file manifest predefinito è manifest.yml sotto la directory root della tua applicazione.
-
*-i* numero_istanze (facoltativo)
-
Il numero di istanze.
-
*-k* limite_dico (facoltativo)
-
Il limite di disco per l'applicazione. I valori possibili sono *256M*, *1024M* o *1G*.
-
*-m* limite_memoria (facoltativo)
-
Il limite di memoria per l'applicazione. I valori possibili sono *256M*, *1024M* o *1G*.
-
*-n* nome_host (facoltativo)
-
Il nome host per l'applicazione, ad esempio *my-subdomain*.
-
*-p* percorso_applicazione (facoltativo)
-
Il percorso alla directory dell'applicazione o al file di archivio dell'applicazione.
-
*-s* nome_stack (facoltativo)
-
Lo stack per l'esecuzione delle applicazioni. Uno stack è un file system precostruito che include il sistema operativo. Utilizza `cf stacks` per visualizzare gli stack disponibili in {{site.data.keyword.Bluemix_notm}}.
-
*-t* timeout (facoltativo)
-
Il tempo massimo in secondi per l'avvio dell'applicazione. Altri timeout lato server potrebbero -sovrascrivere questo valore.
-
*--no-hostname* (facoltativo)
-
Associa il dominio di sistema {{site.data.keyword.Bluemix_notm}} a questa applicazione.
-
*--no-manifest* (facoltativo)
-
Ignora il file manifest predefinito.
-
*--no-route* (facoltativo)
-
Non associa una rotta a questa applicazione.
-
*--no-start* (facoltativo)
-
Non avvia l'applicazione dopo che essa è stata distribuita.
-
*--random-route* (facoltativo)
-
Crea una rotta casuale per l'applicazione.
-
- -Esempi: - -Avvia un'applicazione denominata `my_app` con il comando di avvio predefinito. -``` -cf push `my_app` -c null -``` -{: codeblock} - -Avvia un'applicazione denominata `my_app` con l'opzione per eseguire un file di script denominato `run.sh`. -``` -cf push `my_app` -c "bash ./" -``` -{: codeblock} - - - -## cf scale -{: #cf_scale} - -Visualizza o modifica il numero di istanze, -il limite di spazio su disco e il limite di memoria per un'applicazione. - -``` -cf scale appname [-i instance_number] [-k disk_limit] [-m memory_limit] [-f] -``` - -Prerequisiti: `cf api`, `cf login`, `cf target` - -Opzioni del comando: - -
-
nome_applicazione (obbligatorio)
-
Il nome dell'applicazione.
-
*-i* numero_istanze (facoltativo)
-
Il numero di istanze
-
*-k* limite_dico (facoltativo)
-
Il limite di disco per l'applicazione; i valori possibili sono `256M`, `1024M` o `1G`.
-
*-m* limite_memoria (facoltativo)
-
Il limite di memoria per l'applicazione; i valori possibili sono `256M`, `1024M` o `1G`.
-
*-f* (facoltativo)
-
Forza il riavvio dell'applicazione senza che venga presentata alcuna richiesta.
-
- -Esempi: - -Visualizza il numero di istanze, il limite di spazio su disco e il limite di memoria per un'applicazione denominata `my_app`. -``` -cf scale my_app -``` -{: codeblock} - -Modifica il numero di istanze in `1234`, il limite di spazio su disco in `1G` e il limite di memoria in `1G` per un'applicazione denominata `my_app`. -``` -cf scale appname -i 1234 -k 1G -m 1G -``` -{: codeblock} - - -## cf services -{: #cf_services} - -Elenca tutti i servizi -disponibili nello spazio corrente. - -``` -cf services -``` -Prerequisiti: `cf api`, `cf login`, `cf target` - -Opzioni del comando: Nessuna. - -Esempi: - -Elenca tutti i servizi nello spazio corrente. -``` -cf services -``` -{: codeblock} - - -## cf set-env -{: #cf_set-env} - -Imposta una variabile di ambiente per un'applicazione - -``` -cf set-env nomeapplicazione nome_var valore_var -``` -Prerequisiti: `cf api`, `cf login`, `cf target` - -Opzioni del comando: - -
-
nome_applicazione (obbligatorio)
-
Il nome dell'applicazione.
-
nome_var (obbligatorio)
-
Il nome della variabile di ambiente.
-
valore_var (obbligatorio)
-
Il valore della variabile di ambiente.
-
- -Esempi: - -Imposta una variabile di ambiente denominata `variable_a` con un valore `123` per l'applicazione denominata `my_app`. -``` -cf set-env my_app variable_a 123 -``` -{: codeblock} - - -## cf ssh -{: #cf_ssh} - -Accedere in sicurezza al contenitore dell'applicazione. Il comando `cf ssh` può essere utilizzato per configurare una sessione SSH interattiva, eseguire comandi remoti, trasferire file e configurare l'inoltro alla porta con un'istanza del contenitore dell'applicazione specifica. - -``` -cf ssh -``` -Prerequisiti: `cf api`, `cf login`, `cf target` - -Per impostazione predefinita, l'accesso SSH è abilitato per le applicazioni Diego. Puoi utilizzare il comando `cf ssh-enabled` per verificare se l'accesso SSH è abilitato o il comando `cf enable-ssh` per abilitarlo se è disabilitato. - -Opzioni del comando: - -
-
nomeapplicazione
-
Il nome dell'applicazione.
-
-c
-
Specifica un comando remoto per l'esecuzione.
-
-i
-
Indirizza un'istanza specifica di un'applicazione. Se non specificato, viene utilizzata la prima istanza dell'applicazione (un'istanza con indice 0).
-
-L
-
Abilita l'inoltro alla porta locale, che esegue il bind di una porta di output sulla tua macchina a una porta di input nella VM dell'applicazione.
-
-N
-
Non esegue un comando remoto.
-
-t, -tt o -T
-
Ti abilita ad eseguire una sessione SSH in modalità pseudo-tty che genera l'output di riga del terminale.
-
- -Esempi: - -Avvia una sessione SSH interattiva con un'immagine del contenitore eseguendo l'applicazione `my_app`. -``` -$ cf ssh my_app -``` -{: codeblock} - -Esegui un solo comando nell'istanza del contenitore dell'applicazione `my_app`. -``` -$ cf ssh my_app -c "ls -l" -``` - -Trasferisci un solo file dall'istanza del contenitore dell'applicazione `my_app`. -``` -$ cf ssh my_app -c "/bin/cat logs/messages.log" > messages.log -``` - -Configura l'inoltro alla porta della porta 7777 nella macchina locale alla porta 8888 nell'istanza del contenitore dell'applicazione `my_app`. -``` -$ cf ssh -N -T -L 7777:localhost:8888 my_app - -``` - -## cf stacks -{: #cf_stacks} - -Elenca tutti -gli stack. Uno stack è un file system precostruito, compreso un sistema operativo che può eseguire -le applicazioni. - -``` -cf stacks -``` -Prerequisiti: `cf api`, `cf login` - -Opzioni del comando: Nessuna. - -Esempi: - -Elenca tutti gli stack. -``` -cf stacks -``` -{: codeblock} - - -## cf stop -{: #cf_stop} - -Arresta un'applicazione - -``` -cf stop nome_applicazione -``` -Prerequisiti: `cf api`, `cf login`, `cf target` - -Opzioni del comando: - -
-
nome_applicazione (obbligatorio)
-
Il nome dell'applicazione.
-
- -Esempi: - -Arresta l'applicazione denominata `my_app`. -``` -cf stop my_app -``` -{: codeblock} - - -## cf target -{: #cf_target} - -Imposta o visualizza l'organizzazione o spazio di destinazione - -``` -cf target [-o org_name] [-s space_name] -``` -Prerequisiti: `cf api`, `cf login` - -Opzioni del comando: - -
-
-o *nome_organizzazione* (facoltativo)
-
Il nome dell'organizzazione in cui si trova lo spazio.
-
-s *nome_spazio* (facoltativo)
-
Il nome dello spazio.
-
- -Esempi: - -Imposta la destinazione sull'organizzazione denominata "my_org" e sullo spazio denominato "my_space". -``` -cf target -o my_org -s my_space -``` -{: codeblock} - - -## cf -v -{: #cf_v} - -Visualizza la versione -dell'interfaccia riga di comando cf. - -``` -cf -v -``` -Prerequisiti: Nessuno. - -Opzioni del comando: Nessuna. - -Esempi: - -Visualizza la versione dell'interfaccia riga di comando cf. -``` -cf -v -``` -{: codeblock} - - - -# Link correlati -{: #rellinks} - -## Link correlati -{: #general} - -* [Scarica CLI Cloud Foundry ![icona link esterno](../../../icons/launch-glyph.svg)](https://github.com/cloudfoundry/cli/releases) -{: new_window} -* [Quick Reference Card - cf commands ![icona link esterno](../../../icons/launch-glyph.svg)](ftp://public.dhe.ibm.com/cloud/bluemix/cf_cli_refcard.html) -{: new_window} +--- + + + +copyright: + + years: 2016, 2017 + +lastupdated: "2017-01-12" + + +--- + + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} + + +# Comandi Cloud Foundry (cf) +{: #cf} + +L'interfaccia di riga comando (CLI) Cloud Foundry (cf) fornisce una serie di comandi per gestire le tue applicazioni. Le seguenti informazioni elencano i comandi cf più utilizzati per la gestione delle applicazioni e includono i relativi nomi, opzioni, utilizzo, prerequisiti, descrizioni ed esempi. Per elencare tutti i comandi cf e le informazioni di guida associate, utilizza `cf help`. Utilizza `cf nome_comando -h` per visualizzare delle informazioni di guida dettagliate per uno specifico comando. +{: shortdesc} + +**Nota**: se la tua rete contiene un server proxy HTTP tra l'host che esegue i comandi cf e l'endpoint API Cloud Foundry, devi specificare il nome host o l'indirizzo IP del server proxy impostando la variabile di ambiente `HTTP_PROXY`. Per i dettagli,vedi [Utilizzo della CLI cf con un server proxy HTTP ![icona link esterno](../../../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/devguide/installcf/http-proxy.html){: new_window}. + + +## Indice dei comandi della CLI Cloud Foundry +{: #CLIname_commands_index} + +Utilizza l'indice nella seguente tabella per fare riferimento ai comandi Cloud Foundry più utilizzati: + + + + + + + + + + + + + + + + +
Tabella 1. Comandi generali di Cloud Foundry
Comandi generali di Cloud Foundry
[api](/docs/cli/reference/cfcommands/index.html#cf_api)[help](/docs/cli/reference/cfcommands/index.html#cf_help)[login](/docs/cli/reference/cfcommands/index.html#cf_login)[stacks](/docs/cli/reference/cfcommands/index.html#cf_stacks)[target](/docs/cli/reference/cfcommands/index.html#cf_target)[-v ](/docs/cli/reference/cfcommands/index.html#cf_v)
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Tabella 2. Comandi per la gestione di applicazioni, spazi e servizi
Comandi per la gestione di applicazioni, spazi e servizi
[apps](/docs/cli/reference/cfcommands/index.html#cf_apps)[bind-service](/docs/cli/reference/cfcommands/index.html#cf_bind-service)[create-service](/docs/cli/reference/cfcommands/index.html#cf_create-service)[create-space](/docs/cli/reference/cfcommands/index.html#cf_create-space)[delete](/docs/cli/reference/cfcommands/index.html#cf_delete)
[delete-space](/docs/cli/reference/cfcommands/index.html#cf_delete-space)[events](/docs/cli/reference/cfcommands/index.html#cf_events)[logs](/docs/cli/reference/cfcommands/index.html#cf_logs)[marketplace](/docs/cli/reference/cfcommands/index.html#cf_marketplace)[push (eseguire il)](/docs/cli/reference/cfcommands/index.html#cf_push)
[ingrandire](/docs/cli/reference/cfcommands/index.html#cf_scale)[services](/docs/cli/reference/cfcommands/index.html#cf_services) + [set-env](/docs/cli/reference/cfcommands/index.html#cf_set-env)[ssh](/docs/cli/reference/cfcommands/index.html#cf_ssh)[stop](/docs/cli/reference/cfcommands/index.html#cf_stop)
+ +## cf api +{: #cf_api} + +Utilizza questo comando per visualizzare o specificare l'URL dell'endpoint API di {{site.data.keyword.Bluemix_notm}}. + +``` +cf api [BluemixServerURL] [--skip-ssl-validation] [--unset] +``` + +Prerequisiti: Nessuno. + +Opzioni del comando: + +
+
BluemixServerURL (facoltativo)
+
L'URL dell'endpoint API Bluemix che devi specificare quando stabilisci una connessione a {{site.data.keyword.Bluemix_notm}}. Solitamente, questo URL è `https://api.{DomainName}`. + Se vuoi visualizzare l'URL dell'endpoint API che stai attualmente utilizzando, non hai bisogno di specificare questo parametro per il comando cf api.
+
* --skip-ssl-validation
+
Disabilita il processo di convalida SSL. L'utilizzo di questo parametro può causare problemi di sicurezza.
+
* --unset
+
Rimuove le informazioni di connessione per tutti gli endpoint API.
+
+ +Esempi: + +Visualizza l'endpoint API corrente +``` +cf api +``` +{: codeblock} + +Rimuovi la connessione a tutti gli endpoint API per api.ng.bluemix.net +``` +cf api api.ng.bluemix.network --unset +``` +{: codeblock} + +Disabilita il processo di convalida SSL per api.ng.bluemix.network +``` +cf api api.ng.bluemix.network --skip-ssl-validation +``` +{: codeblock} + + +## cf apps +{: #cf_apps} + +Elenca tutte le applicazioni da te distribuite nello spazio corrente. Viene visualizzato anche lo +stato di ciascuna applicazione. + +Presumi di avere una istanza per un'applicazione; nella colonna delle istanze della risposta dal comando cf apps, vedi 1/1 se la tua applicazione è attiva e 0/1 se è invece inattiva. Se vedi ?/1, che indica che lo stato dell'istanza dell'applicazione è sconosciuto, puoi copiare l'URL dell'applicazione nel tuo browser per verificare se l'applicazione risponde oppure puoi controllare la parte finale del log utilizzando il comando `cf logs appname` per vedere se l'applicazione sta generando il contenuto del log. + +``` +cf apps +``` + +Prerequisiti: `cf api`, `cf login`, `cf target` + + +## cf bind-service +{: #cf_bind-service} + +Esegue il bind di un'istanza del servizio +esistente alla tua applicazione. + +``` +cf bind-service nome_applicazione istanza_servizio +``` + +Prerequisiti: `cf api`, `cf login`, `cf target` + +Opzioni del comando: + +
+
nome_applicazione (obbligatorio)
+
Il nome dell'applicazione.
+
istanza_servizio (obbligatorio)
+
Il nome dell'istanza del servizio esistente.
+
+ +Esempi: + +Esegui il bind di un'istanza del servizio denominata `my_dataworks` alla tua applicazione denominata `my_app`. +``` +cf bind-service my_app my_dataworks +``` +{: codeblock} + + +## cf create-service +{: #cf_create-service} + +Crea un'istanza del servizio + +``` +cf create-service nome_servizio piano_servizio istanza_servizio +``` + +Prerequisiti: `cf api`, `cf login`, `cf target` + +Opzioni del comando: + +
+
nome_servizio (obbligatorio)
+
Il nome del servizio.
+
piano_servizio (obbligatorio)
+
Il nome del piano di servizio.
+
istanza_servizio (obbligatorio)
+
Il nome che vuoi utilizzare per la nuova istanza del servizio da te +creata.
+
+ +Esempi: + +Crea un'istanza del servizio {{site.data.keyword.dataworks_short}} con un piano `free`. +``` +cf create-service DataWorks free my_dataworks +``` +{: codeblock} + + +## cf create-space +{: #cf_create-space} + +Crea uno spazio. + +``` +cf create-space nome_spazio [-o] [-q] +``` + +Prerequisiti: `cf api`, `cf login` + +Opzioni del comando: + +
+
nome_spazio (obbligatorio)
+
Il nome dello spazio.
+
*-o* (facoltativo)
+
Il nome dell'organizzazione in cui vuoi creare uno spazio.
+
*-q* (facoltativo)
+
La quota da assegnare allo spazio appena creato. Se non viene specificata, viene automaticamente assegnata una quota predefinita.
+
+ +Esempi: + +Crea uno spazio denominato nuovo_spazio +``` +cf create-space nuovo_spazio +``` +{: codeblock} + + +## cf delete +{: #cf_delete} + +Elimina +un'applicazione esistente. + +``` +cf delete nome_applicazione [-f] [-r] +``` + +Prerequisiti: `cf api`, `cf login`, `cf target` + +Opzioni del comando: + +
+
nome_applicazione (obbligatorio)
+
Il nome dell'applicazione.
+
*-f* (facoltativo)
+
Forza l'eliminazione dell'applicazione senza alcuna conferma.
+
*-r* (facoltativo)
+
Elimina tutti i nomi dominio associati all'applicazione.
+
+ +Esempi: + +Elimina un'applicazione denominata `my_app` (richiede conferma). +``` +cf delete my_app +``` +{: codeblock} + +Elimina un'applicazione denominata `my_app` senza richiedere conferma. +``` +cf delete my_app -f +``` +{: codeblock} + +Elimina un'applicazione denominata `my_app` e tutti i nomi dominio associati a `my_app`. +``` +cf delete my_app -r +``` +{: codeblock} + +Elimina un'applicazione denominata `my_app` e tutti i nomi dominio associati a `my_app` senza richiedere conferma. +``` +cf delete my_app -f -r +``` +{: codeblock} + + +## cf delete-space +{: #cf_delete-space} + +Elimina uno spazio. + +``` +cf delete-space nome_spazio [-f] +``` + +Prerequisiti: `cf api`, `cf login` + +Opzioni del comando: + +
+
nome_spazio (obbligatorio)
+
Il nome dello spazio.
+
*-f* (facoltativo)
+
Forza l'eliminazione dello spazio senza alcuna conferma.
+ *Nota:* l'eliminazione di uno spazio è un'operazione irreversibile. +
+ +Esempi: + +Elimina un'applicazione denominata `my_app` (richiede conferma). +``` +cf delete my_app +``` +{: codeblock} + +Elimina un'applicazione denominata `my_app` senza richiedere conferma. +``` +cf delete my_app -f +``` +{: codeblock} + +Elimina un'applicazione denominata `my_app` e tutti i nomi dominio associati a `my_app`. +``` +cf delete my_app -r +``` +{: codeblock} + +Elimina un'applicazione denominata `my_app` e tutti i nomi dominio associati a `my_app` senza richiedere conferma. +``` +cf delete my_app -f -r +``` +{: codeblock} + + +## cf events +{: #cf_events} + +Visualizza +gli eventi di runtime che sono correlati ad un'applicazione. + +``` +cf events [nomeapplicazione] +``` + +Prerequisiti: `cf api`, `cf login`, `cf target` + +Opzioni del comando: + +
+
nomeapplicazione
+
Il nome dell'applicazione.
+
+ +Esempi: + +Visualizza gli eventi per un'applicazione denominata `my_app`. +``` +cf events my_app +``` +{: codeblock} + + +## cf help +{: #cf_help} + +Visualizza le informazioni di guida per tutti i comandi cf o per un comando cf specifico. + +``` +cf help [nome_comando] +``` + +Prerequisiti: Nessuno. + +Opzioni del comando: + +
+
nome_comando (facoltativo)
+
Il nome di un comando.
+
+ +Esempi: + +Visualizza le informazioni di guida per tutti i comandi cf. +``` +cf help +``` +{: codeblock} + +Visualizza le informazioni di guida per il comando di eventi. +``` +cf help events +``` +{: codeblock} + + +## cf login +{: #cf_login} + +Ti fa accedere a {{site.data.keyword.Bluemix_notm}}. + +**Nota**: se stai eseguendo l'accesso con un [ID federato](/docs/admin/account.html#signup), devi utilizzare il parametro SSO (single sign-on) per accedere. + +``` +cf login [-a url] [-u user_name] [-p password] [-sso] [-o organization_name] [-s space_name] [--skip-ssl-validation] +``` + +Prerequisiti: Nessuno. + +Opzioni del comando: + +
+
*-a* https://api.{DomainName} (facoltativo)
+
L'URL dell'endpoint API di {{site.data.keyword.Bluemix_notm}}.
+
*-u* nome_utente (facoltativo)
+
Il tuo nome utente.
+
*-p* password (facoltativo)
+
La tua password.
+
*Importante:* se fornisci la tua password utilizzando il parametro *-p* sull'interfaccia riga di comando, la password potrebbe essere registrata nella cronologia della riga di comando. Per motivi di sicurezza, evita di fornire la password utilizzando il parametro +-p. Immetti invece la password quando te lo chiede l'interfaccia riga di comando.
+
*-sso*
+
Devi utilizzare l'opzione SSO (single sign-on ) quando accedi con un ID federato. Non è necessario quando accedi con un ID IBM. Se tenti di collegarti con un ID federato e non specifichi il parametro SSO, ti verrà richiesto di includerlo. Utilizza la richiesta del parametro SSO per immettere la passcode monouso all'accesso.
+
*-o*nome_organizzazione
+
Il nome dell'organizzazione alla quale desideri effettuare l'accesso.
+
*-s*nome_spazio
+
Il nome dello spazio al quale desideri effettuare l'accesso.
+
*--skip-ssl-validation* (facoltativo)
+
Disabilita il processo di convalida SSL. L'utilizzo di questo parametro può causare problemi di sicurezza.
+
+ +*Nota:* se fornisci la tua password nel parametro *-p* di questo comando, la tua password potrebbe essere registrata nel file di cronologia dei comandi della shell e potrebbe essere visibile ad altri utenti del sistema operativo locale. + +Esempi: + +Accedi a {{site.data.keyword.Bluemix_notm}}. +``` +cf login +``` +{: codeblock} + +Accedi a {{site.data.keyword.Bluemix_notm}} con un endpoint definito di `https://api.ng.bluemix.net`. +``` +cf login -a https://api.ng.bluemix.net +``` +{: codeblock} + +Accedi a {{site.data.keyword.Bluemix_notm}} con un endpoint definito di `https://api.ng.bluemix.net`, un nome utente `nome_utente` e nessuna password specificata per motivi di sicurezza. +``` +cf login -a https://api.ng.bluemix.net -u nome_utente +``` +{: codeblock} + +Accedi a {{site.data.keyword.Bluemix_notm}} con un endpoint definito di `https://api.ng.bluemix.net`, un nome utente `nome_utente`, nessuna password specificata per motivi di sicurezza e un nome organizzazione `nome_organizzazione` e nome spazio `nome_spazio`. +``` +cf login -a https://api.ng.bluemix.net -u nome_utente -o nome_organizzazione -s nome_spazio +``` +{: codeblock} + + +## cf logs +{: #cf_logs} + +Visualizza i flussi di log +STDOUT e STDERR di un'applicazione. + +``` +cf logs nomeapplicazione [--recent] +``` +Prerequisiti: `cf api`, `cf login`, `cf target` + +Opzioni del comando: + +
+
nomeapplicazione
+
Il nome dell'applicazione.
+
*--recent* (facoltativo)
+
Richiama i log recenti.
+
+ +Esempi: + +Visualizza i flussi di log per un'applicazione denominata `my_app`. +``` +cf logs my_app +``` +{: codeblock} + +Visualizza i flussi di log recenti per un'applicazione denominata `my_app`. +``` +cf logs my_app --recent +``` +{: codeblock} + + +## cf marketplace +{: #cf_marketplace} + +Elenca tutti +i servizi disponibili nel marketplace. I servizi elencati da questo comando sono visualizzati anche nel catalogo {{site.data.keyword.Bluemix_notm}}. + +``` +cf marketplace +``` +Prerequisiti: `cf api` + +Opzioni del comando: Nessuna. + +Esempi: + +Elenca tutti i servizi nel marketplace +``` +cf marketplace +``` +{: codeblock} + + +## cf push +{: #cf_push} + +Distribuisce una nuova applicazione a {{site.data.keyword.Bluemix_notm}} oppure aggiorna un'applicazione esistente in {{site.data.keyword.Bluemix_notm}}. + +``` +cf push appname [-b buildpack_name] [-c start_command] [-f manifest_path] [-i instance_number] [-k disk_limit] [-m memory_limit] [-n host_name] [-p app_path] [-s stack_name] [-t timeout_length] [--no-hostname] [--no-manifest] [--no-route] [--no-start] [--random-route] +``` + +Prerequisiti: `cf api`, `cf login`, `cf target` + +Opzioni del comando: + +
+
nome_applicazione (obbligatorio)
+
Il nome dell'applicazione.
+
*-b* nome_pacchettodibuild (facoltativo)
+
Il nome del pacchetto di build. Il nome_pacchettodibuild può essere un pacchetto di build personalizzato in base al nome (ad esempio liberty-for-java) oppure un URL Git (ad esempio https://github.com/cloudfoundry/java-buildpack.git) oppure un URL Git con un ramo o tag (ad esempio, https://github.com/cloudfoundry/java-buildpack.git#v3.3.0 per la tag v3.3.0).
+
*-c* comando_di_avvio (facoltativo)
+
Il comando di avvio della tua applicazione. Per utilizzare il comando di avvio predefinito, specifica un valore null per questa opzione.
+
*-f* percorso_manifest (facoltativo)
+
Il percorso al file manifest. Il file manifest predefinito è manifest.yml sotto la directory root della tua applicazione.
+
*-i* numero_istanze (facoltativo)
+
Il numero di istanze.
+
*-k* limite_dico (facoltativo)
+
Il limite di disco per l'applicazione. I valori possibili sono *256M*, *1024M* o *1G*.
+
*-m* limite_memoria (facoltativo)
+
Il limite di memoria per l'applicazione. I valori possibili sono *256M*, *1024M* o *1G*.
+
*-n* nome_host (facoltativo)
+
Il nome host per l'applicazione, ad esempio *my-subdomain*.
+
*-p* percorso_applicazione (facoltativo)
+
Il percorso alla directory dell'applicazione o al file di archivio dell'applicazione.
+
*-s* nome_stack (facoltativo)
+
Lo stack per l'esecuzione delle applicazioni. Uno stack è un file system precostruito che include il sistema operativo. Utilizza `cf stacks` per visualizzare gli stack disponibili in {{site.data.keyword.Bluemix_notm}}.
+
*-t* timeout (facoltativo)
+
Il tempo massimo in secondi per l'avvio dell'applicazione. Altri timeout lato server potrebbero +sovrascrivere questo valore.
+
*--no-hostname* (facoltativo)
+
Associa il dominio di sistema {{site.data.keyword.Bluemix_notm}} a questa applicazione.
+
*--no-manifest* (facoltativo)
+
Ignora il file manifest predefinito.
+
*--no-route* (facoltativo)
+
Non associa una rotta a questa applicazione.
+
*--no-start* (facoltativo)
+
Non avvia l'applicazione dopo che essa è stata distribuita.
+
*--random-route* (facoltativo)
+
Crea una rotta casuale per l'applicazione.
+
+ +Esempi: + +Avvia un'applicazione denominata `my_app` con il comando di avvio predefinito. +``` +cf push `my_app` -c null +``` +{: codeblock} + +Avvia un'applicazione denominata `my_app` con l'opzione per eseguire un file di script denominato `run.sh`. +``` +cf push `my_app` -c "bash ./" +``` +{: codeblock} + + + +## cf scale +{: #cf_scale} + +Visualizza o modifica il numero di istanze, +il limite di spazio su disco e il limite di memoria per un'applicazione. + +``` +cf scale appname [-i instance_number] [-k disk_limit] [-m memory_limit] [-f] +``` + +Prerequisiti: `cf api`, `cf login`, `cf target` + +Opzioni del comando: + +
+
nome_applicazione (obbligatorio)
+
Il nome dell'applicazione.
+
*-i* numero_istanze (facoltativo)
+
Il numero di istanze
+
*-k* limite_dico (facoltativo)
+
Il limite di disco per l'applicazione; i valori possibili sono `256M`, `1024M` o `1G`.
+
*-m* limite_memoria (facoltativo)
+
Il limite di memoria per l'applicazione; i valori possibili sono `256M`, `1024M` o `1G`.
+
*-f* (facoltativo)
+
Forza il riavvio dell'applicazione senza che venga presentata alcuna richiesta.
+
+ +Esempi: + +Visualizza il numero di istanze, il limite di spazio su disco e il limite di memoria per un'applicazione denominata `my_app`. +``` +cf scale my_app +``` +{: codeblock} + +Modifica il numero di istanze in `1234`, il limite di spazio su disco in `1G` e il limite di memoria in `1G` per un'applicazione denominata `my_app`. +``` +cf scale appname -i 1234 -k 1G -m 1G +``` +{: codeblock} + + +## cf services +{: #cf_services} + +Elenca tutti i servizi +disponibili nello spazio corrente. + +``` +cf services +``` +Prerequisiti: `cf api`, `cf login`, `cf target` + +Opzioni del comando: Nessuna. + +Esempi: + +Elenca tutti i servizi nello spazio corrente. +``` +cf services +``` +{: codeblock} + + +## cf set-env +{: #cf_set-env} + +Imposta una variabile di ambiente per un'applicazione + +``` +cf set-env nomeapplicazione nome_var valore_var +``` +Prerequisiti: `cf api`, `cf login`, `cf target` + +Opzioni del comando: + +
+
nome_applicazione (obbligatorio)
+
Il nome dell'applicazione.
+
nome_var (obbligatorio)
+
Il nome della variabile di ambiente.
+
valore_var (obbligatorio)
+
Il valore della variabile di ambiente.
+
+ +Esempi: + +Imposta una variabile di ambiente denominata `variable_a` con un valore `123` per l'applicazione denominata `my_app`. +``` +cf set-env my_app variable_a 123 +``` +{: codeblock} + + +## cf ssh +{: #cf_ssh} + +Accedere in sicurezza al contenitore dell'applicazione. Il comando `cf ssh` può essere utilizzato per configurare una sessione SSH interattiva, eseguire comandi remoti, trasferire file e configurare l'inoltro alla porta con un'istanza del contenitore dell'applicazione specifica. + +``` +cf ssh +``` +Prerequisiti: `cf api`, `cf login`, `cf target` + +Per impostazione predefinita, l'accesso SSH è abilitato per le applicazioni Diego. Puoi utilizzare il comando `cf ssh-enabled` per verificare se l'accesso SSH è abilitato o il comando `cf enable-ssh` per abilitarlo se è disabilitato. + +Opzioni del comando: + +
+
nomeapplicazione
+
Il nome dell'applicazione.
+
-c
+
Specifica un comando remoto per l'esecuzione.
+
-i
+
Indirizza un'istanza specifica di un'applicazione. Se non specificato, viene utilizzata la prima istanza dell'applicazione (un'istanza con indice 0).
+
-L
+
Abilita l'inoltro alla porta locale, che esegue il bind di una porta di output sulla tua macchina a una porta di input nella VM dell'applicazione.
+
-N
+
Non esegue un comando remoto.
+
-t, -tt o -T
+
Ti abilita ad eseguire una sessione SSH in modalità pseudo-tty che genera l'output di riga del terminale.
+
+ +Esempi: + +Avvia una sessione SSH interattiva con un'immagine del contenitore eseguendo l'applicazione `my_app`. +``` +$ cf ssh my_app +``` +{: codeblock} + +Esegui un solo comando nell'istanza del contenitore dell'applicazione `my_app`. +``` +$ cf ssh my_app -c "ls -l" +``` + +Trasferisci un solo file dall'istanza del contenitore dell'applicazione `my_app`. +``` +$ cf ssh my_app -c "/bin/cat logs/messages.log" > messages.log +``` + +Configura l'inoltro alla porta della porta 7777 nella macchina locale alla porta 8888 nell'istanza del contenitore dell'applicazione `my_app`. +``` +$ cf ssh -N -T -L 7777:localhost:8888 my_app + +``` + +## cf stacks +{: #cf_stacks} + +Elenca tutti +gli stack. Uno stack è un file system precostruito, compreso un sistema operativo che può eseguire +le applicazioni. + +``` +cf stacks +``` +Prerequisiti: `cf api`, `cf login` + +Opzioni del comando: Nessuna. + +Esempi: + +Elenca tutti gli stack. +``` +cf stacks +``` +{: codeblock} + + +## cf stop +{: #cf_stop} + +Arresta un'applicazione + +``` +cf stop nome_applicazione +``` +Prerequisiti: `cf api`, `cf login`, `cf target` + +Opzioni del comando: + +
+
nome_applicazione (obbligatorio)
+
Il nome dell'applicazione.
+
+ +Esempi: + +Arresta l'applicazione denominata `my_app`. +``` +cf stop my_app +``` +{: codeblock} + + +## cf target +{: #cf_target} + +Imposta o visualizza l'organizzazione o spazio di destinazione + +``` +cf target [-o org_name] [-s space_name] +``` +Prerequisiti: `cf api`, `cf login` + +Opzioni del comando: + +
+
-o *nome_organizzazione* (facoltativo)
+
Il nome dell'organizzazione in cui si trova lo spazio.
+
-s *nome_spazio* (facoltativo)
+
Il nome dello spazio.
+
+ +Esempi: + +Imposta la destinazione sull'organizzazione denominata "my_org" e sullo spazio denominato "my_space". +``` +cf target -o my_org -s my_space +``` +{: codeblock} + + +## cf -v +{: #cf_v} + +Visualizza la versione +dell'interfaccia riga di comando cf. + +``` +cf -v +``` +Prerequisiti: Nessuno. + +Opzioni del comando: Nessuna. + +Esempi: + +Visualizza la versione dell'interfaccia riga di comando cf. +``` +cf -v +``` +{: codeblock} + + + +# Link correlati +{: #rellinks} + +## Link correlati +{: #general} + +* [Scarica CLI Cloud Foundry ![icona link esterno](../../../icons/launch-glyph.svg)](https://github.com/cloudfoundry/cli/releases) +{: new_window} +* [Quick Reference Card - cf commands ![icona link esterno](../../../icons/launch-glyph.svg)](ftp://public.dhe.ibm.com/cloud/bluemix/cf_cli_refcard.html) +{: new_window} diff --git a/cli/nl/it/start_coding.md b/cli/nl/it/start_coding.md index 803e2ab1a..227127199 100644 --- a/cli/nl/it/start_coding.md +++ b/cli/nl/it/start_coding.md @@ -1,20 +1,20 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2015-12-07" - - ---- - -{:shortdesc: .shortdesc} - -# Inizia a codificare - - -In {{site.data.keyword.Bluemix_notm}} puoi iniziare a codificare rapidamente attenendoti alla procedura fornita dopo la creazione di un'applicazione. -{:shortdesc} +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2015-12-07" + + +--- + +{:shortdesc: .shortdesc} + +# Inizia a codificare + + +In {{site.data.keyword.Bluemix_notm}} puoi iniziare a codificare rapidamente attenendoti alla procedura fornita dopo la creazione di un'applicazione. +{:shortdesc} diff --git a/cli/nl/it/vcapsvc.md b/cli/nl/it/vcapsvc.md index 5b0faed47..b2d193f24 100644 --- a/cli/nl/it/vcapsvc.md +++ b/cli/nl/it/vcapsvc.md @@ -1,31 +1,31 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2016-03-15" - - ---- - -{:shortdesc: .shortdesc} - -# Servizi VCAP - - -La variabile di ambiente VCAP_SERVICES è un oggetto JSON che contiene le informazioni che puoi utilizzare per interagire con un'istanza del servizio in {{site.data.keyword.Bluemix_notm}}. -{:shortdesc} - - -## Richiamo del valore della variabile di ambiente VCAP_SERVICES -{:retrieving} - -La variabile di ambiente VCAP_SERVICES è un oggetto JSON che contiene le informazioni che puoi utilizzare per interagire con un'istanza del servizio in {{site.data.keyword.Bluemix_notm}}. Le informazioni includono il nome dell'istanza del servizio, le credenziali e l'URL di connessione all'istanza del servizio. Questi valori vengono inseriti nella variabile di ambiente VCAP_SERVICES quando la tua applicazione viene associata a un'istanza del servizio in {{site.data.keyword.Bluemix_notm}}. - -Il valore della variabile di ambiente VCAP_SERVICES è disponibile solo quando esegui il bind di un'istanza del servizio alla tua applicazione. Puoi visualizzare le variabili di ambiente dell'applicazione utilizzando seguente comando: -``` -cf env APP_NAME -``` +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2016-03-15" + + +--- + +{:shortdesc: .shortdesc} + +# Servizi VCAP + + +La variabile di ambiente VCAP_SERVICES è un oggetto JSON che contiene le informazioni che puoi utilizzare per interagire con un'istanza del servizio in {{site.data.keyword.Bluemix_notm}}. +{:shortdesc} + + +## Richiamo del valore della variabile di ambiente VCAP_SERVICES +{:retrieving} + +La variabile di ambiente VCAP_SERVICES è un oggetto JSON che contiene le informazioni che puoi utilizzare per interagire con un'istanza del servizio in {{site.data.keyword.Bluemix_notm}}. Le informazioni includono il nome dell'istanza del servizio, le credenziali e l'URL di connessione all'istanza del servizio. Questi valori vengono inseriti nella variabile di ambiente VCAP_SERVICES quando la tua applicazione viene associata a un'istanza del servizio in {{site.data.keyword.Bluemix_notm}}. + +Il valore della variabile di ambiente VCAP_SERVICES è disponibile solo quando esegui il bind di un'istanza del servizio alla tua applicazione. Puoi visualizzare le variabili di ambiente dell'applicazione utilizzando seguente comando: +``` +cf env APP_NAME +``` diff --git a/cli/nl/ja/plugins/pnp/index.md b/cli/nl/ja/plugins/pnp/index.md index 7ff2af018..df66b9aad 100644 --- a/cli/nl/ja/plugins/pnp/index.md +++ b/cli/nl/ja/plugins/pnp/index.md @@ -97,12 +97,12 @@ chmod a+x ./private-network-peering-linux-amd64 bluemix network pnp-routers [--verbose (または -v)] ``` -#####オプション・パラメーター +##### オプション・パラメーター {: #op1} * **--verbose (または -v)** (フラグ): 各ルーターに関する詳細ネットワーク情報を表示します。 -######コマンドの例 +###### コマンドの例 {: #ex1} すべてのルーターに関するネットワーク情報を表示するには、以下のようにします。 @@ -152,13 +152,13 @@ bluemix network pnp-routers [--verbose (または -v)] bluemix network pnp-create ``` -#####パラメーター +##### パラメーター {: #p1} * **router_ip**: 接続する 2 つのルーターの IP アドレス。IP アドレスを確認するには、`bluemix network pnp-routers` コマンドを使用します。 * **name**: プライベート・ネットワーク・ピアリング接続の名前。 -######コマンドの例 +###### コマンドの例 {: #ex2} $ bluemix network pnp-create 129.41.234.246 129.41.237.172 demo @@ -169,19 +169,19 @@ bluemix network pnp-create Private network peering connection 'demo' created. -####接続名を使用したプライベート・ネットワーク・ピアリング接続の作成 +#### 接続名を使用したプライベート・ネットワーク・ピアリング接続の作成 ``` bluemix network pnp-create -i ``` -#####パラメーター +##### パラメーター {: #p2} * **--interactive (-i)** (フラグ): ルーターを選択する対話モード。 * **name**: プライベート・ネットワーク・ピアリング接続の名前。 -######コマンドの例 +###### コマンドの例 {: #ex3} $ bluemix network pnp-create -i demo @@ -207,12 +207,12 @@ bluemix network pnp-create -i bluemix network pnp-show [--verbose (または -v)] ``` -#####オプション・パラメーター +##### オプション・パラメーター {: #op2} * **--verbose (または -v)** (フラグ): 各ルーターに関する詳細ネットワーク情報を表示します。 -######コマンドの例 +###### コマンドの例 {: #ex4} 基本情報を表示するには、以下のようにします。 @@ -246,16 +246,16 @@ bluemix network pnp-show [--verbose (または -v)] ``` bluemix network pnp-delete [--force (または -f)] ``` -#####パラメーター +##### パラメーター {: #p3} * **connection_id**: コンマで区切った、1 つ以上の接続 ID。 -#####オプション・パラメーター +##### オプション・パラメーター {: #op3} * **--force (または -f)** (フラグ): 確認を求めるプロンプトを出さずに接続を削除します。 -######コマンドの例: +###### コマンドの例: {: #ex5} 接続を削除するには、以下のようにします。 diff --git a/cli/nl/pt/BR/plugins/pnp/index.md b/cli/nl/pt/BR/plugins/pnp/index.md index fa302647d..39569cbeb 100644 --- a/cli/nl/pt/BR/plugins/pnp/index.md +++ b/cli/nl/pt/BR/plugins/pnp/index.md @@ -97,12 +97,12 @@ Para visualizar informações da ajuda para os comandos, execute: `bluemix netwo bluemix network pnp-routers [--verbose (or -v)] ``` -#####Parâmetros opcionais +##### Parâmetros opcionais {: #op1} * **--verbose (ou -v)** (sinalizador): visualizar informações de rede detalhadas sobre cada roteador. -######Exemplo de comando +###### Exemplo de comando {: #ex1} Para visualizar as informações de rede sobre todos os roteadores: @@ -152,13 +152,13 @@ Para visualizar informações de rede detalhadas sobre todos os roteadores: bluemix network pnp-create ``` -#####Parâmetros +##### Parâmetros {: #p1} * **router_ip**: endereços IP dos dois roteadores com os quais você deseja se conectar. É possível localizar os endereços IP usando o comando: `bluemix network pnp-routers` * **name**: nome da conexão de peering de rede privada. -######Exemplo de comando +###### Exemplo de comando {: #ex2} $ bluemix network pnp-create 129.41.234.246 129.41.237.172 demo @@ -169,19 +169,19 @@ bluemix network pnp-create 'Demo' de conexão de peering de rede privada criada. -####Crie uma conexão de peering de rede privada usando o nome da conexão +#### Crie uma conexão de peering de rede privada usando o nome da conexão ``` bluemix network pnp-create -i ``` -#####Parâmetros +##### Parâmetros {: #p2} * **--interactive (-i)** (sinalizador): modo interativo para selecionar roteadores. * **name**: nome da conexão de peering de rede privada. -######Exemplo de comando +###### Exemplo de comando {: #ex3} $ bluemix network pnp-create -i demo @@ -207,12 +207,12 @@ peering> 2 bluemix network pnp-show [--verbose (or -v)] ``` -#####Parâmetros opcionais +##### Parâmetros opcionais {: #op2} * **--verbose (ou -v)** (sinalizador): visualizar informações de rede detalhadas sobre cada roteador. -######Exemplo de comando +###### Exemplo de comando {: #ex4} Visualizar informações básicas: @@ -246,16 +246,16 @@ Visualize informações detalhadas: ``` bluemix network pnp-delete [--force (or -f)] ``` -#####Parâmetros +##### Parâmetros {: #p3} * **connection_id**: um ou mais IDs de conexão separados por uma vírgula. -#####Parâmetros opcionais +##### Parâmetros opcionais {: #op3} * **--force (ou -f)** (sinalizador): exclui a conexão sem solicitar uma confirmação. -######Exemplo de comando: +###### Exemplo de comando: {: #ex5} Exclua uma conexão: diff --git a/cli/nl/zh/CN/plugins/pnp/index.md b/cli/nl/zh/CN/plugins/pnp/index.md index 2569b561f..291a4dcc1 100644 --- a/cli/nl/zh/CN/plugins/pnp/index.md +++ b/cli/nl/zh/CN/plugins/pnp/index.md @@ -97,12 +97,12 @@ chmod a+x ./private-network-peering-linux-amd64 bluemix network pnp-routers [--verbose（或 -v）] ``` -#####可选参数 +##### 可选参数 {: #op1} * **--verbose（或 -v）**（标志）：查看有关每个路由器的详细网络信息。 -######命令示例 +###### 命令示例 {: #ex1} 查看有关所有路由器的网络信息： @@ -152,13 +152,13 @@ bluemix network pnp-routers [--verbose（或 -v）] bluemix network pnp-create ``` -#####参数 +##### 参数 {: #p1} * **router_ip**：要连接的两个路由器的 IP 地址。可以使用命令 `bluemix network pnp-routers` 来查找 IP 地址。 * **name**：专用网络对等连接的名称。 -######命令示例 +###### 命令示例 {: #ex2} $ bluemix network pnp-create 129.41.234.246 129.41.237.172 demo @@ -169,19 +169,19 @@ bluemix network pnp-create 专用网络对等连接“demo”已创建。 -####使用连接名称来创建专用网络对等连接 +#### 使用连接名称来创建专用网络对等连接 ``` bluemix network pnp-create -i ``` -#####参数 +##### 参数 {: #p2} * **--interactive (-i)**（标志）：以交互方式选择路由器。 * **name**：专用网络对等连接的名称。 -######命令示例 +###### 命令示例 {: #ex3} $ bluemix network pnp-create -i demo @@ -207,12 +207,12 @@ bluemix network pnp-create -i bluemix network pnp-show [--verbose（或 -v）] ``` -#####可选参数 +##### 可选参数 {: #op2} * **--verbose（或 -v）**（标志）：查看有关每个路由器的详细网络信息。 -######命令示例 +###### 命令示例 {: #ex4} 查看基本信息： @@ -246,16 +246,16 @@ bluemix network pnp-show [--verbose（或 -v）] ``` bluemix network pnp-delete [--force（或 -f）] ``` -#####参数 +##### 参数 {: #p3} * **connection_id**：一个或多个连接标识，用逗号分隔。 -#####可选参数 +##### 可选参数 {: #op3} * **--force（或 -f）**（标志）：删除连接，而不提示确认。 -######命令示例： +###### 命令示例： {: #ex5} 删除连接： diff --git a/cli/plugins/pnp/index.md b/cli/plugins/pnp/index.md index 50d8f5a6f..1c8f959c1 100644 --- a/cli/plugins/pnp/index.md +++ b/cli/plugins/pnp/index.md @@ -98,12 +98,12 @@ To view help information for the commands, run: `bluemix network [command] -h`. bluemix network pnp-routers [--verbose (or -v)] ``` -#####Optional parameters +##### Optional parameters {: #op1} * **--verbose (or -v)** (flag): View detailed network information about each router. -######Command example +###### Command example {: #ex1} To view network information about all routers: @@ -153,13 +153,13 @@ To view detailed network information about all routers: bluemix network pnp-create ``` -#####Parameters +##### Parameters {: #p1} * **router_ip**: IP addresses of the two routers that you want to connect. You can find the IP addresses by using the command: `bluemix network pnp-routers` * **name**: Name of the private network peering connection. -######Command example +###### Command example {: #ex2} $ bluemix network pnp-create 129.41.234.246 129.41.237.172 demo @@ -170,19 +170,19 @@ bluemix network pnp-create Private network peering connection 'demo' created. -####Create a private network peering connection by using the connection name +#### Create a private network peering connection by using the connection name ``` bluemix network pnp-create -i ``` -#####Parameters +##### Parameters {: #p2} * **--interactive (-i)** (flag): Interactive mode to select routers. * **name**: Name of the private network peering connection. -######Command example +###### Command example {: #ex3} $ bluemix network pnp-create -i demo @@ -208,12 +208,12 @@ bluemix network pnp-create -i bluemix network pnp-show [--verbose (or -v)] ``` -#####Optional parameters +##### Optional parameters {: #op2} * **--verbose (or -v)** (flag): View detailed network information about each router. -######Command example +###### Command example {: #ex4} View basic information: @@ -247,16 +247,16 @@ View detailed information: ``` bluemix network pnp-delete [--force (or -f)] ``` -#####Parameters +##### Parameters {: #p3} * **connection_id**: One or more connection IDs separated by a comma. -#####Optional parameters +##### Optional parameters {: #op3} * **--force (or -f)** (flag): Deletes the connection without prompting for a confirmation. -######Command example: +###### Command example: {: #ex5} Delete a connection: diff --git a/cloudnative/nl/de/cli.md b/cloudnative/nl/de/cli.md index d0e4911f4..9c584734b 100644 --- a/cloudnative/nl/de/cli.md +++ b/cloudnative/nl/de/cli.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Plug-ins für {{site.data.keyword.Bluemix_notm}} CLI -{: #cli} - -Die folgenden Plug-ins können zu {{site.data.keyword.Bluemix}} CLI hinzugefügt werden. Mit diesen Plug-ins können Sie {{site.data.keyword.dev_console}}-Projekte erstellen. - -* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) -* [{{site.data.keyword.IBM_notm}} SDK Generator-Plug-in](sdk_cli.html) +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Plug-ins für {{site.data.keyword.Bluemix_notm}} CLI +{: #cli} + +Die folgenden Plug-ins können zu {{site.data.keyword.Bluemix}} CLI hinzugefügt werden. Mit diesen Plug-ins können Sie {{site.data.keyword.dev_console}}-Projekte erstellen. + +* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) +* [{{site.data.keyword.IBM_notm}} SDK Generator-Plug-in](sdk_cli.html) diff --git a/cloudnative/nl/de/compute.md b/cloudnative/nl/de/compute.md index 6cbad291d..8139a3471 100644 --- a/cloudnative/nl/de/compute.md +++ b/cloudnative/nl/de/compute.md @@ -1,181 +1,181 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Compute -{: #compute} - -Wenn Sie eine cloudorientierte native Anwendung für digitale Vertriebskanäle für das Web und Mobilgeräte erstellen, dann hat es sich bewährt, mit einem BFF (Backend for Frontend) zu arbeiten, das entweder Ihrem digitalen Vertriebskanal zugeordnet ist oder die gleichen Daten und die gleiche Unterstützung für die logische Integration für Web-Client-Apps und mobile Client-Apps bietet. Weitere Informationen zu dieser Architektur finden Sie im Artikel zu den [Mikroservices für das Web und mobile Einheiten ![Symbol für externen Link](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture). - -Im folgenden Diagramm wird eine Übersicht zur BFF-Architektur dargestellt. - -![BFF-Architektur](images/bff-arch.png) - -Abbildung 1: BFF-Architektur - -Das BFF-Konzept basiert auf der Entfernung allgemeiner Geschäfts- und Integrationslogik aus den Mikroservices oder hochwertigen {{site.data.keyword.Bluemix}}-Cloud-Services. - -Mit dieser Architektur können Sie Updates für Ihre mobilen Anwendung oder Webanwendungen bereitstellen und freigeben und neue Versionen Ihres BFF bereitstellen, indem Sie kontinuierliche Delivery Pipelines für den DevOps-Service verwenden. - -Wenn Sie über eine BFF für iOS und eine separate BFF für Android verfügen, dann sind die Entwicklungsteams, die die Funktion für diese Apps liefern, bei der Freigabe von Features nicht durch einen zentralisierten API-Freigabeplan eingeschränkt. Dies stellt ein gemeinsames Ziel für Mikroservice-Architekturen und Architekturen für digitale Vertriebskanäle dar, um den Teams die häufige Freigabe von Funktionen und Features zu ermöglichen, ohne dass eine enge Abhängigkeit zum Freigabeplan eines anderen Teams besteht. - - - - -## Mobilen Client in BFF integrieren -{: #integration} - -Zur Bereitstellung einfacher Integrationsmöglichkeiten zwischen einem mobilen Client und einem BFF (Backend for Frontends) unterstützt {{site.data.keyword.Bluemix_notm}} die SDK-Generierung für mobile Clients für iOS und Android in Swift- bzw. Java-Sprachen. Zum Aktivieren dieses Features müssen Sie die BFF-Integration mithilfe eines Dokuments für Open API-Spezifikationen (Swagger) bereitstellen. Dieses Dokument kann im JSON- oder YAML-Format vorliegen. - -Der SDK-Generator des Clients verwendet die Open API-Definitionsdatei zum Definieren eines clientoptimierten Entwickler-SDK, das in Ihrer nativen mobilen Anwendung einfach zu verarbeiten ist. Auf diese Weise kann die Integration Ihres BFF in Ihre mobile Anwendung beschleunigt werden. - - -## API definieren -{: #definition} - -Das BFF muss eine der Open API-Spezifikation entsprechende API-Definitionsdatei bereitstellen, die auf einem Live-Serverendpunkt ausgeführt wird. Damit {{site.data.keyword.Bluemix_notm}} Developer Experience und die {{site.data.keyword.Bluemix_notm}}-SDK-CLI (Command Line Interface) diesen Endpunkt erkennen können, müssen Sie eine Umgebungsvariable mit dem Namen `OPENAPI_SPEC` zu Ihrer Cloud Foundry-Anwendung hinzufügen. Diese Umgebungsvariable muss mit einem relativen Pfad auf die Spezifikation verweisen. - -Führen Sie die folgenden Schritte aus, um die Umgebungsvariable `OPENAPI_SPEC` in {{site.data.keyword.Bluemix_notm}} hinzuzufügen: - -1. Melden Sie sich bei [{{site.data.keyword.Bluemix_notm}} ![Symbol für externen Link](../icons/launch-glyph.svg)](http://bluemix.net) an. -2. Wählen Sie eine Cloud Foundry-App aus. -3. Wählen Sie **Laufzeit** aus. -4. Wählen Sie **Umgebungsvariablen** aus. -5. Klicken Sie im Abschnitt **Benutzerdefiniert** auf **Hinzufügen**. -6. Legen Sie für **NAME** die Angabe `OPENAPI_SPEC` und einen relativen URL-Pfad zu Ihrer Open API-Definitionsdatei fest. -7. Klicken Sie auf **Speichern**. - - - -Beispiel: - -``` -OPENAPI_SPEC='/explorer/swagger.json' -``` -{: codeblock} - -Dieser Ansatz bietet insbesondere bei Verwendung von {{site.data.keyword.apiconnect_long}}- und Loopback-Anwendungen Vorteile. Sie können das Loopback und {{site.data.keyword.apiconnect_short}} verwenden, um ein persistentes Modell zu definieren und die CRUD-Operation (CRUD = Create, Read, Update, and Delete) mit der Open API-Definitionsdatei bereitzustellen. - -Außerdem können Sie Geschäftslogikoperationen definieren. - - -### Unterstützte Elemente der Open API-Spezifikation -{: #supported-elements notoc} - -Der einzige Bereich der Open API-Spezifikation, der nicht vollständig unterstützt wird, betrifft die Dateistruktur. Die Spezifikation erlaubt das Aufteilen der Definitionsabschnitte auf verschiedene Dateien und ihre Referenzierung mithilfe des JSON-Felds `$ref`. Ihre gesamte Definition muss in einer Datei enthalten sein. - - -## BFF-Beispiel für Verwendung von Bluegen -{: #bff-bluegen} - -{{site.data.keyword.Bluemix_notm}} hat mithilfe von {{site.data.keyword.apiconnect_short}} und Strongloop ein Referenz-BFF erstellt. Dabei wird eine Zuordnung zwischen einem Produktmodell und {{site.data.keyword.cloudant}} sowie einer Bild-API zur Referenzierung von Bildern in {{site.data.keyword.objectstorageshort}} hergestellt. - -Sie können dieses BFF-Muster verwenden, um rasch ein voll funktionsfähiges BFF in {{site.data.keyword.Bluemix_notm}} bereitzustellen, das die Einarbeitung in die Vorgehensweise zur Integration eines BFF in ein mobiles Projekt und das Generieren nativer SDKs für iOS und Android in Swift bzw. Java vereinfacht. - -Befolgen Sie die Anweisungen in der [README ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) zur Erstellung eines Projekts und zu seiner Installation. - - -## BFF mit Developer Experience-Projekt verwenden -{: #bff-devex} - -{{site.data.keyword.Bluemix_notm}} Mobile Developer Experience wurde so konzipiert, dass das Definieren eines mobilen Projekts mit einer Reihe zugeordneter Cloud-Services vereinfacht wird. Sie können [{{site.data.keyword.mobilepushshort}} ![Symbol für externen Link](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [Analytics ![Symbol für externen Link](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html) sowie Data- oder Storage-Services auf einfache Weise hinzufügen. - -Die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} bietet auf der Seite **Compute** die Möglichkeit zur Integration eines BFF in ein mobiles Projekt. Sie können vorhandene Compute-Serviceinstanzen zu Ihrem mobilen Projekt hinzufügen. Nach dem Hinzufügen können Sie entweder ein natives SDK für Ihre Sprachauswahl generieren oder Sie können das vollständige Projekt generieren. In diesem Fall wird das SDK auf der Seite **Code** in das Quellenpaket des Projekts integriert. Diese Vorgehensweise ist besonders nützlich, wenn Sie eine Integration mit BFFs durchführen, die bereits klar strukturiert sind. - -Nach dem Download des Projekts können Sie es mit Xcode oder Android Studio öffnen und das Projekt mit dem Client-SDK kompilieren. - - -## CLI verwenden -{: #cli} - -Während der Entwicklung des BFF kann es zu Änderungen an der API-Spezifikation kommen. Zur Unterstützung dieser Änderungen stehen Ihnen die beiden folgenden Optionen zur Verfügung. - -* Neuerstellung des gesamten Projekts in einem neuen GitHub-Zweig und Zusammenführen der Änderungen in Ihrem Entwicklungszweig. -* Direkte Neuerstellung des SDK mithilfe des Befehlszeilentools (CLI) und ausschließliche Aktualisierung der SDK-Komponente des mobilen Projekts. - -Zur Verwendung der CLI müssen Sie sie [installieren](sdk_cli.html#installation). - -Verwenden Sie den folgenden Befehl, um die Aktionen aufzulisten, die ausgeführt werden können. - -``` -bluemix sdk -``` -{: codeblock} - -Verwenden Sie den folgenden Befehl, um die aktiven Cloud Foundry-Instanzen in Ihrem aktuellen {{site.data.keyword.Bluemix_notm}}-Bereich aufzulisten. - -``` -bluemix sdk list -``` -{: codeblock} - -Jede App wird aufgelistet und die API wird überprüft, wenn die Umgebungsvariable `OPENAPI_SPEC` festgelegt wurde. In der Spalte `VALID` befindet sich ein grünes Häkchen oder ein rotes `X`. Das Häkchen in der Spalte `VALID` für die Anwendung bedeutet, dass eine gültige Open API-Definition vorhanden ist. Ein `X` in der Spalte `VALID` der Anwendung kann Folgendes bedeuten: - -* Es wurde keine Umgebungsvariable `OPENAPI_SPEC` für die Anwendung definiert ODER -* die API-Definition ist in Bezug auf die Open API-Spezifikation nicht gültig. - -Verwenden Sie den folgenden Befehl, um die vollständig formatierte URL der API anzuzeigen. Die vollständig formatierte Route und der URI zur API-Spezifikation werden aufgelistet. Sie können die unaufbereitete Spezifikation in einem Browser anzeigen, sie in der CLI direkt verarbeiten oder überprüfen, ob die Umgebungsvariable `OPENAPI_SPEC` korrekt festgelegt wurde. - -``` -bluemix sdk list --url -``` -{: codeblock} - -Verwenden Sie den folgenden Befehl, um die Open API-Definitionsdatei von `` zu überprüfen und so festzustellen, ob sie zum Generieren eines SDK verwendet werden kann. Der Befehl sucht `` in Ihrem aktuellen Bereich und verwendet den relativen Pfad in der Umgebungsvariablen `OPENAPI_SPEC` zum Suchen der Spezifikation für die Überprüfung. - -``` -bluemix sdk validate -``` -{: codeblock} - -Verwenden Sie den folgenden Befehl, um ein SDK für die native Plattform (``) Ihrer Wahl zu generieren und um eine komprimierte Datei im aktuellen Arbeitsverzeichnis zu platzieren. - -``` -bluemix sdk generate -- -``` -{: codeblock} - -Bei Verwendung der Option `--unzip` führt das System eine automatische Extraktion des SDK in Ihr aktuelles Arbeitsverzeichnis durch. Optional können Sie die Position zur Extraktion des SDK auch angeben, indem Sie die Option `--output` verwenden. Sie können den Quellcode mit GitHub verwalten und einen neuen Zweig speziell für die Aktualisierung des SDK erstellen. Mit diesem Ansatz wird die Anzeige der Änderungen und das Zusammenführen des aktualisierten SDK mit Ihrem Entwicklungszweig vereinfacht. - - -## Mit einem SDK generierte Modelle und APIs verwenden -{: #models-apis} - -Nachdem das BFF mithilfe eines generierten SDK in Ihre mobile App integriert wurde, können Sie damit arbeiten. - -Das SDK umfasst eine vollständig generierte Dokumentation, die sich im Verzeichnis `docs` und im Verzeichnis `source` befindet. Sie können die Datei `README.html` öffnen, um eine Webansicht der Dokumente anzuzeigen. Alternativ hierzu können Sie die Datei `README.md` öffnen, um eine Markdown-Ansicht der Dokumente anzuzeigen. Die Markdown-Dokumente sind nützlich, wenn Sie das SDK in Cocoapods oder Maven Central veröffentlichen wollen. - -Die Dokumentation enthält eine Liste der APIs, die generiert werden. Sie können auf die API klicken, um ein Code-Snippet anzuzeigen, das direkt in Ihre mobile App eingefügt werden kann. +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Compute +{: #compute} + +Wenn Sie eine cloudorientierte native Anwendung für digitale Vertriebskanäle für das Web und Mobilgeräte erstellen, dann hat es sich bewährt, mit einem BFF (Backend for Frontend) zu arbeiten, das entweder Ihrem digitalen Vertriebskanal zugeordnet ist oder die gleichen Daten und die gleiche Unterstützung für die logische Integration für Web-Client-Apps und mobile Client-Apps bietet. Weitere Informationen zu dieser Architektur finden Sie im Artikel zu den [Mikroservices für das Web und mobile Einheiten ![Symbol für externen Link](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture). + +Im folgenden Diagramm wird eine Übersicht zur BFF-Architektur dargestellt. + +![BFF-Architektur](images/bff-arch.png) + +Abbildung 1: BFF-Architektur + +Das BFF-Konzept basiert auf der Entfernung allgemeiner Geschäfts- und Integrationslogik aus den Mikroservices oder hochwertigen {{site.data.keyword.Bluemix}}-Cloud-Services. + +Mit dieser Architektur können Sie Updates für Ihre mobilen Anwendung oder Webanwendungen bereitstellen und freigeben und neue Versionen Ihres BFF bereitstellen, indem Sie kontinuierliche Delivery Pipelines für den DevOps-Service verwenden. + +Wenn Sie über eine BFF für iOS und eine separate BFF für Android verfügen, dann sind die Entwicklungsteams, die die Funktion für diese Apps liefern, bei der Freigabe von Features nicht durch einen zentralisierten API-Freigabeplan eingeschränkt. Dies stellt ein gemeinsames Ziel für Mikroservice-Architekturen und Architekturen für digitale Vertriebskanäle dar, um den Teams die häufige Freigabe von Funktionen und Features zu ermöglichen, ohne dass eine enge Abhängigkeit zum Freigabeplan eines anderen Teams besteht. + + + + +## Mobilen Client in BFF integrieren +{: #integration} + +Zur Bereitstellung einfacher Integrationsmöglichkeiten zwischen einem mobilen Client und einem BFF (Backend for Frontends) unterstützt {{site.data.keyword.Bluemix_notm}} die SDK-Generierung für mobile Clients für iOS und Android in Swift- bzw. Java-Sprachen. Zum Aktivieren dieses Features müssen Sie die BFF-Integration mithilfe eines Dokuments für Open API-Spezifikationen (Swagger) bereitstellen. Dieses Dokument kann im JSON- oder YAML-Format vorliegen. + +Der SDK-Generator des Clients verwendet die Open API-Definitionsdatei zum Definieren eines clientoptimierten Entwickler-SDK, das in Ihrer nativen mobilen Anwendung einfach zu verarbeiten ist. Auf diese Weise kann die Integration Ihres BFF in Ihre mobile Anwendung beschleunigt werden. + + +## API definieren +{: #definition} + +Das BFF muss eine der Open API-Spezifikation entsprechende API-Definitionsdatei bereitstellen, die auf einem Live-Serverendpunkt ausgeführt wird. Damit {{site.data.keyword.Bluemix_notm}} Developer Experience und die {{site.data.keyword.Bluemix_notm}}-SDK-CLI (Command Line Interface) diesen Endpunkt erkennen können, müssen Sie eine Umgebungsvariable mit dem Namen `OPENAPI_SPEC` zu Ihrer Cloud Foundry-Anwendung hinzufügen. Diese Umgebungsvariable muss mit einem relativen Pfad auf die Spezifikation verweisen. + +Führen Sie die folgenden Schritte aus, um die Umgebungsvariable `OPENAPI_SPEC` in {{site.data.keyword.Bluemix_notm}} hinzuzufügen: + +1. Melden Sie sich bei [{{site.data.keyword.Bluemix_notm}} ![Symbol für externen Link](../icons/launch-glyph.svg)](http://bluemix.net) an. +2. Wählen Sie eine Cloud Foundry-App aus. +3. Wählen Sie **Laufzeit** aus. +4. Wählen Sie **Umgebungsvariablen** aus. +5. Klicken Sie im Abschnitt **Benutzerdefiniert** auf **Hinzufügen**. +6. Legen Sie für **NAME** die Angabe `OPENAPI_SPEC` und einen relativen URL-Pfad zu Ihrer Open API-Definitionsdatei fest. +7. Klicken Sie auf **Speichern**. + + + +Beispiel: + +``` +OPENAPI_SPEC='/explorer/swagger.json' +``` +{: codeblock} + +Dieser Ansatz bietet insbesondere bei Verwendung von {{site.data.keyword.apiconnect_long}}- und Loopback-Anwendungen Vorteile. Sie können das Loopback und {{site.data.keyword.apiconnect_short}} verwenden, um ein persistentes Modell zu definieren und die CRUD-Operation (CRUD = Create, Read, Update, and Delete) mit der Open API-Definitionsdatei bereitzustellen. + +Außerdem können Sie Geschäftslogikoperationen definieren. + + +### Unterstützte Elemente der Open API-Spezifikation +{: #supported-elements notoc} + +Der einzige Bereich der Open API-Spezifikation, der nicht vollständig unterstützt wird, betrifft die Dateistruktur. Die Spezifikation erlaubt das Aufteilen der Definitionsabschnitte auf verschiedene Dateien und ihre Referenzierung mithilfe des JSON-Felds `$ref`. Ihre gesamte Definition muss in einer Datei enthalten sein. + + +## BFF-Beispiel für Verwendung von Bluegen +{: #bff-bluegen} + +{{site.data.keyword.Bluemix_notm}} hat mithilfe von {{site.data.keyword.apiconnect_short}} und Strongloop ein Referenz-BFF erstellt. Dabei wird eine Zuordnung zwischen einem Produktmodell und {{site.data.keyword.cloudant}} sowie einer Bild-API zur Referenzierung von Bildern in {{site.data.keyword.objectstorageshort}} hergestellt. + +Sie können dieses BFF-Muster verwenden, um rasch ein voll funktionsfähiges BFF in {{site.data.keyword.Bluemix_notm}} bereitzustellen, das die Einarbeitung in die Vorgehensweise zur Integration eines BFF in ein mobiles Projekt und das Generieren nativer SDKs für iOS und Android in Swift bzw. Java vereinfacht. + +Befolgen Sie die Anweisungen in der [README ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) zur Erstellung eines Projekts und zu seiner Installation. + + +## BFF mit Developer Experience-Projekt verwenden +{: #bff-devex} + +{{site.data.keyword.Bluemix_notm}} Mobile Developer Experience wurde so konzipiert, dass das Definieren eines mobilen Projekts mit einer Reihe zugeordneter Cloud-Services vereinfacht wird. Sie können [{{site.data.keyword.mobilepushshort}} ![Symbol für externen Link](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [Analytics ![Symbol für externen Link](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html) sowie Data- oder Storage-Services auf einfache Weise hinzufügen. + +Die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} bietet auf der Seite **Compute** die Möglichkeit zur Integration eines BFF in ein mobiles Projekt. Sie können vorhandene Compute-Serviceinstanzen zu Ihrem mobilen Projekt hinzufügen. Nach dem Hinzufügen können Sie entweder ein natives SDK für Ihre Sprachauswahl generieren oder Sie können das vollständige Projekt generieren. In diesem Fall wird das SDK auf der Seite **Code** in das Quellenpaket des Projekts integriert. Diese Vorgehensweise ist besonders nützlich, wenn Sie eine Integration mit BFFs durchführen, die bereits klar strukturiert sind. + +Nach dem Download des Projekts können Sie es mit Xcode oder Android Studio öffnen und das Projekt mit dem Client-SDK kompilieren. + + +## CLI verwenden +{: #cli} + +Während der Entwicklung des BFF kann es zu Änderungen an der API-Spezifikation kommen. Zur Unterstützung dieser Änderungen stehen Ihnen die beiden folgenden Optionen zur Verfügung. + +* Neuerstellung des gesamten Projekts in einem neuen GitHub-Zweig und Zusammenführen der Änderungen in Ihrem Entwicklungszweig. +* Direkte Neuerstellung des SDK mithilfe des Befehlszeilentools (CLI) und ausschließliche Aktualisierung der SDK-Komponente des mobilen Projekts. + +Zur Verwendung der CLI müssen Sie sie [installieren](sdk_cli.html#installation). + +Verwenden Sie den folgenden Befehl, um die Aktionen aufzulisten, die ausgeführt werden können. + +``` +bluemix sdk +``` +{: codeblock} + +Verwenden Sie den folgenden Befehl, um die aktiven Cloud Foundry-Instanzen in Ihrem aktuellen {{site.data.keyword.Bluemix_notm}}-Bereich aufzulisten. + +``` +bluemix sdk list +``` +{: codeblock} + +Jede App wird aufgelistet und die API wird überprüft, wenn die Umgebungsvariable `OPENAPI_SPEC` festgelegt wurde. In der Spalte `VALID` befindet sich ein grünes Häkchen oder ein rotes `X`. Das Häkchen in der Spalte `VALID` für die Anwendung bedeutet, dass eine gültige Open API-Definition vorhanden ist. Ein `X` in der Spalte `VALID` der Anwendung kann Folgendes bedeuten: + +* Es wurde keine Umgebungsvariable `OPENAPI_SPEC` für die Anwendung definiert ODER +* die API-Definition ist in Bezug auf die Open API-Spezifikation nicht gültig. + +Verwenden Sie den folgenden Befehl, um die vollständig formatierte URL der API anzuzeigen. Die vollständig formatierte Route und der URI zur API-Spezifikation werden aufgelistet. Sie können die unaufbereitete Spezifikation in einem Browser anzeigen, sie in der CLI direkt verarbeiten oder überprüfen, ob die Umgebungsvariable `OPENAPI_SPEC` korrekt festgelegt wurde. + +``` +bluemix sdk list --url +``` +{: codeblock} + +Verwenden Sie den folgenden Befehl, um die Open API-Definitionsdatei von `` zu überprüfen und so festzustellen, ob sie zum Generieren eines SDK verwendet werden kann. Der Befehl sucht `` in Ihrem aktuellen Bereich und verwendet den relativen Pfad in der Umgebungsvariablen `OPENAPI_SPEC` zum Suchen der Spezifikation für die Überprüfung. + +``` +bluemix sdk validate +``` +{: codeblock} + +Verwenden Sie den folgenden Befehl, um ein SDK für die native Plattform (``) Ihrer Wahl zu generieren und um eine komprimierte Datei im aktuellen Arbeitsverzeichnis zu platzieren. + +``` +bluemix sdk generate -- +``` +{: codeblock} + +Bei Verwendung der Option `--unzip` führt das System eine automatische Extraktion des SDK in Ihr aktuelles Arbeitsverzeichnis durch. Optional können Sie die Position zur Extraktion des SDK auch angeben, indem Sie die Option `--output` verwenden. Sie können den Quellcode mit GitHub verwalten und einen neuen Zweig speziell für die Aktualisierung des SDK erstellen. Mit diesem Ansatz wird die Anzeige der Änderungen und das Zusammenführen des aktualisierten SDK mit Ihrem Entwicklungszweig vereinfacht. + + +## Mit einem SDK generierte Modelle und APIs verwenden +{: #models-apis} + +Nachdem das BFF mithilfe eines generierten SDK in Ihre mobile App integriert wurde, können Sie damit arbeiten. + +Das SDK umfasst eine vollständig generierte Dokumentation, die sich im Verzeichnis `docs` und im Verzeichnis `source` befindet. Sie können die Datei `README.html` öffnen, um eine Webansicht der Dokumente anzuzeigen. Alternativ hierzu können Sie die Datei `README.md` öffnen, um eine Markdown-Ansicht der Dokumente anzuzeigen. Die Markdown-Dokumente sind nützlich, wenn Sie das SDK in Cocoapods oder Maven Central veröffentlichen wollen. + +Die Dokumentation enthält eine Liste der APIs, die generiert werden. Sie können auf die API klicken, um ein Code-Snippet anzuzeigen, das direkt in Ihre mobile App eingefügt werden kann. diff --git a/cloudnative/nl/de/dev_cli.md b/cloudnative/nl/de/dev_cli.md index f5bd027fc..d5be0966d 100644 --- a/cloudnative/nl/de/dev_cli.md +++ b/cloudnative/nl/de/dev_cli.md @@ -1,404 +1,404 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.dev_cli_short}} -{: #developercli} - -Das {{site.data.keyword.dev_cli_long}} bietet ein erweiterbares befehlsgesteuertes Konzept zum Erstellen, Entwickeln und Bereitstellen eines Webprojekts im Plug-in `dev`. Es ist ideal für Entwickler, die für die Entwicklung von End-to-End-Mikroservice-Anwendungen die Befehlszeilensteuerung verwenden möchten. - -{: shortdesc} - -Vom {{site.data.keyword.dev_cli_notm}} werden zwei Container zum leichteren Erstellen und Testen der Anwendung verwendet. Der erste ist der Container für die Tools, in dem die erforderlichen Dienstprogramme zum Erstellen und Testen der Anwendung enthalten sind. Die Dockerfile für diesen Container wird durch den Parameter [dockerfile-tools](#command-parameters) definiert. Er kann als Entwicklungscontainer angesehen werden, da er die Tools enthält, die normalerweise für Entwicklung einer bestimmten Laufzeit nützlich sind. - -Der zweite Container ist der Ausführungscontainer. Dieser Container ist so konzipiert, dass er sich zur Bereitstellung für die Verwendung eignet, zum Beispiel in {{site.data.keyword.Bluemix}}. Aus diesem Grund ist für diesen Container in der Regel ein Einstiegspunkt definiert, über den die Anwendung gestartet wird. Wenn Sie auswählen, dass die Anwendung über die {{site.data.keyword.dev_cli_short}} gestartet werden soll, wird hierfür dieser Container verwendet. Die Dockerfile für diesen Container wird durch den Parameter [dockerfile-run](#run-parameters) definiert. - - -## Ein {{site.data.keyword.dev_cli_notm}} hinzufügen -{: #add-cli} - - -### Voraussetzungen -{: #prereq} - -Zum vollständigen Kennenlernen und ordnungsgemäßen Verwenden der {{site.data.keyword.dev_cli_short}} müssen einige Voraussetzungen erfüllt sein, da es sehr erweiterbar ist und die Nutzung weiterer komplementärer Technologien ermöglicht. - -1. Installieren Sie die [Cloud Foundry CLI ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/cloudfoundry/cli#getting-started). - -2. Installieren Sie die [{{site.data.keyword.Bluemix}} CLI ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://clis.ng.bluemix.net/ui/home.html). - -3. Rufen Sie eine [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net)-ID ab. - -4. Optional: Wenn Sie beabsichtigen, Anwendungen lokal auszuführen und lokal für sie eine Fehlerbehebung auszuführen, müssen Sie auch [Docker ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.docker.com/get-docker) installieren. Dies ist nur für nicht mobile Projekt erforderlich. - - -### Installieren -{: #installation} - -1. Installieren Sie die [{{site.data.keyword.dev_cli_short}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} durch Ausführen des folgenden Befehls: - - ``` - bx plugin install dev -r Bluemix - ``` - {: codeblock} - -2. Überprüfen Sie durch die Ausführung des folgenden Befehls, ob die Installation erfolgreich war: - - ``` - bx dev - ``` - {: codeblock} - - -### Vorbemerkungen -{: #before-install} - -1. Melden Sie sich an {{site.data.keyword.Bluemix_notm}} an. - - ``` - bx login - ``` - {: codeblock} - - **Hinweis:** Wenn Ihre Berechtigungsnachweise abgelehnt werden, kann es sein, dass Sie eine föderierte ID verwenden. Führen Sie die folgenden Schritte aus, um sich mit einer föderierten ID zu authentifizieren. - - - - 1. Melden Sie sich an [{{site.data.keyword.iamshort}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.bluemix.net/iam/#/apikeys){: new_window} an. - 2. Wählen Sie **API-Schlüssel erstellen** aus. - * Geben Sie einen Namen und eine Beschreibung für den API-Schlüssel ein. - 3. Laden Sie den API-Schlüssel herunter. - 4. Öffnen Sie die Datei und kopieren Sie den Wert aus dem Feld `apiKey`. - 5. Melden Sie sich unter Verwendung des folgenden Befehls an: - - ``` - bx login --apikey - ``` - {: codeblock} - - -## Befehle -{: #commands} - -Verwenden Sie die folgenden Befehle, um ein Projekt zu erstellen, es bereitzustellen, eine Fehlerbehebung dafür auszuführen und es zu testen. - -### Erstellen -{: #build} - -Sie können eine Anwendung mit dem Befehl `build` erstellen. Das Konfigurationselement `build-cmd-run` wird zum Erstellen der Anwendung verwendet. Mit den Befehlen `test`, `debug` und `run` wird die Erstellung immer auf dieselbe Art wie mit diesem Befehl als Bestandteil der normalen Operation ausgeführt; somit ist die Ausführung vor diesen nicht erforderlich. - -Führen Sie den folgenden Befehl im aktuellen Projektverzeichnis aus, um die Anwendung zu erstellen: - -``` -bx dev build -``` -{: codeblock} - - -[Befehlsparameter erstellen](#command-parameters) - - -### Code -{: #code} - -Mit dem Befehl `code` können Sie nach der Bereitstellung Anwendungscode herunterladen, sodass Sie lokale Überprüfungen oder weitere Änderungen vornehmen können. - -Führen Sie den folgenden Befehl aus, um den Code von einem bestimmten Projekt herunterzuladen. - -``` -bx dev code -``` -{: codeblock} - - -### Erstellen -{: #create} - -Erstellen Sie ein neues Projekt, für das zum Angeben aller erforderlichen Informationen einschließlich Sprache, Projektname und Appmustertyp aufgefordert wird. Das Projekt wird im aktuellen Verzeichnis erstellt. - -Führen Sie den folgenden Befehl aus, um ein neues Projekt im aktuellen Projektverzeichnis zu erstellen und ihm Services zuzuordnen: - -``` -bx dev create -``` -{: codeblock} - - -### Debuggen -{: #debug} - -Sie können eine Anwendung mit dem Befehl `debug` debuggen. Zunächst wird für das Projekt mithilfe des Konfigurationselements `build-cmd-debug` als Buildanweisung eine Erstellung ausgeführt. Anschließend wird ein Container gestartet, von dem ein Debug-Port oder Ports wie in `container-port-map-debug` definiert verfügbar gemacht wird bzw. werden. Verbinden Sie Ihr bevorzugtes Debugging-Tool mit dem Port bzw. den Ports; danach können Sie die Anwendung wie sonst debuggen. - -**Einschränkung:** Derzeit kann für Swift-Projekte kein Debugging durchgeführt werden. - -Führen Sie den folgenden Befehl im aktuellen Projektverzeichnis aus, um die Anwendung zu debuggen: - -``` -bx dev debug -``` -{: codeblock} - -Verwenden Sie zum Beenden der Debugsitzung `CTRL-C`. - - -#### Debugbefehlsparameter -{: #debug-parameters} - -Die folgenden Parameter werden ausschließlich mit dem Befehl `debug` verwendet und dienen als Unterstützung beim Debugging einer Anwendung. - -##### `container-port-map-debug` -{: #port-map-debug} - -* Portzuordnungen für den Debugging-Port. Der erste Wert ist der Port, der im Hostbetriebssystem verwendet werden soll, der zweite ist der Port im Container (host:container). -* Syntax: `bx dev debug container-port-map-debug [7777:7777]` - -##### `build-cmd-debug` -{: #build-cmd-debug} - -* Wird zum Erstellen des Codes für das Debugging (DEBUG) verwendet. -* Syntax: `bx dev debug build-cmd-debug build.command.sh` - -##### `debug-cmd` -{: #debug-cmd} - -* Wird zum Debuggen von Code im Container für die Tools verwendet. Dies ist optional, wenn die Anwendung von `build-cmd-debug` durch Debuggen gestartet wird. -* Syntax: `bx dev debug debug-cmd /the/debug/command` - -#### Debuggen einer lokalen Anwendung: -{: #local-app-dev} - -Weitere Informationen zum Debuggen einer lokalen Anwendung finden Sie unter [Debuggen einer lokalen Anwendung](docs/cloudnative/dev_cli_local_debug.html#local-debug). - - -### Löschen -{: #delete} - -Mit diesem Befehl können Sie Projekte im {{site.data.keyword.Bluemix}}-Bereich löschen. - -Führen Sie den folgenden Befehl aus, um ein Projekt in {{site.data.keyword.Bluemix}} zu löschen: - -``` -bx dev delete -``` -{: codeblock} - - -**Hinweis:** {{site.data.keyword.Bluemix}}-Services werden **nicht** entfernt. - - -### Hilfe -{: #help} - -Wenn keine Aktionen bzw. Argumente übergeben werden oder wenn die Aktion "Hilfe" bereitgestellt wird, wird bei Verwendung dieses Befehls standardmäßig ein erweiterter Hilfetext angezeigt. Die erweiterte Hilfe umfasst eine Beschreibung der Basisargumente sowie eine Liste der verfügbaren Aktionen. - -Führen Sie den folgenden Befehl aus, um die erweiterte Hilfeinformationen anzuzeigen: - -``` -bx dev help -``` -{: codeblock} - - -### Auflisten -{: #list} - -Sie können alle {{site.data.keyword.Bluemix_notm}}-Projekte in einem Bereich auflisten. - -Führen Sie den folgenden Befehl aus, um die Projekte aufzulisten: - -``` -bx dev list -``` -{: codeblock} - - - - - -### Ausführen -{: #run} - -Sie können eine Anwendung mit dem Befehl `run` ausführen. Zunächst wird für das Projekt mithilfe des Konfigurationselements `build-cmd-run` als Buildanweisung eine Erstellung ausgeführt. Anschließend wird der Ausführungscontainer gestartet und die Ports werden wie von `container-port-map` definiert bereitgestellt. `run-cmd` kann zum Aufrufen der Anwendung verwendet werden, wenn der Ausführungscontainer nicht einen Einstiegspunkt zur Ausführung dieses Schritts enthält. - -Führen Sie den folgenden Befehl im aktuellen Projektverzeichnis aus, um die Anwendung zu starten: - -``` -bx dev run -``` -{: codeblock} - -Verwenden Sie zum Beenden der Sitzung `CTRL-C`. - - -#### Ausführungsparameter -{: #run-parameters} - -Die folgenden Parameter werden ausschließlich mit dem Befehl `run` verwendet und dienen als Unterstützung beim Verwalten der Anwendung im Ausführungscontainer. - -##### `container-name-run` -{: #container-name-run} - -* Containername für den Ausführungscontainer. -* Syntax: `bx dev run container-name-run ` - -##### `container-path-run` -{: #container-path-run} - -* Position im Container, die bei der Ausführung gemeinsam genutzt werden soll. -* Syntax: `bx dev run container-path-run [/path/to/app]` - -##### `host-path-run` -{: #host-path-run} - -* Position im Hostsystem, die im Container beim Ausführen gemeinsam genutzt werden soll. -* Syntax: `bx dev run host-path-run [/path/to/app/bin]` - -##### `dockerfile-run` -{: #dockerfile-run} - -* Dockerfile für den Ausführungscontainer. -* Syntax: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` - -##### `image-name-run` -{: #image-name-run} - -* Image, das durch die Ausführung der Dockerfile (dockerfile-run) erstellt werden soll. -* Syntax: `bx dev run image-name-run [/path/to/image-name]` - -##### `run-cmd` -{: #run-cmd} - -* Optionaler Parameter, der zum Ausführen des Codes im Container verwendet wird. Dies ist optional, wenn die Anwendung vom Image gestartet wird. -* Syntax: `bx dev run run-cmd [/the/run/command]` - -### Status -{: #status} - -Sie können den Status der von der {{site.data.keyword.dev_cli_short}} verwendeten Container wie von `container-name-run` und `container-name-tools` definiert abfragen. - -Führen Sie den folgenden Befehl im aktuellen Projektverzeichnis aus, um den Containerstatus zu überprüfen: - -``` -bx dev status -``` -{: codeblock} - - -[Statusbefehlsparameter](#command-parameters) - - -### Stoppen -{: #stop} - -Sie können einen Container mit dem Befehl `stop` stoppen. Mit dem Parameter `container-name` können Sie den Container angeben, der gestoppt werden soll. Falls dieser nicht angegeben ist, wird durch den Stoppbefehl der unter Verwendung von `container-name-run` definierte Ausführungscontainer gestoppt. - -Führen Sie den folgenden Befehl im aktuellen Projektverzeichnis aus, um einen Container zu stoppen: - -``` -bx dev stop -``` -{: codeblock} - - -#### Weitere Stoppparameter: -{: #stop-parameter} - -##### `container-name` -{: #container-name} - -* Containername für den Container mit den Tools. -* Syntax: `bx dev stop container-name ` - -### Testen -{: #test} - -Sie können eine Anwendung mit dem Befehl `test` testen. Zunächst wird für das Projekt mithilfe des Konfigurationselements `build-cmd-run` als Buildanweisung eine Erstellung ausgeführt. Anschließend wird der Container mit den Tools zum Aufrufen von `test-cmd` für die Anwendung verwendet. - -Führen Sie den folgenden Befehl aus, um die Anwendung zu testen: - -``` -bx dev test -``` -{: codeblock} - - -[Testbefehlsparameter](#command-parameters) - - -## Parameter zum Erstellen, Debuggen, Ausführen und Testen -{: #command-parameters} - -Die folgenden Parameter können zusammen mit den Befehlen `build|debug|run|test` verwendet werden und in der Befehlszeile und/oder beim direkten Aktualisieren der Datei `cli-config.yml` des Projekts angegeben werden. Für die Befehle [`debug`](#debug-parameters) und [`run`](#run-parameters) stehen weitere Parameter zur Verfügung; sie sind in den jeweiligen Abschnitten dokumentiert. - -**Hinweis:** In der Befehlszeile eingegebene Befehlsparameter haben Vorrang vor der Konfiguration in `cli-config.yml`. - -##### `container-name-tools` -{: #container-name-tools} - -* Containername für den Container mit den Tools. -* Syntax: `bx dev container-name-tools []` - -##### `host-path-tools` -{: #host-path-tools} - -* Position auf dem Host, die zum Erstellen, Debuggen und Testen gemeinsam genutzt werden soll. -* Syntax: `bx dev host-path-tools [/path/to/build/tools]` - -##### `container-path-tools` -{: #container-path-tools} - -* Position im Container, die zum Erstellen, Debuggen und Testen gemeinsam genutzt werden soll. -* Syntax: `bx dev container-path-tools [/path/for/build]` - -##### `container-port-map` -{: #container-port-map} - -* Portzuordnungen für den Container. Der erste Wert ist der Port, der im Hostbetriebssystem verwendet werden soll, der zweite ist der Port im Container (host:container). -* Syntax: `bx dev container-port-map [8090:8090,9090,9090]` - -##### `dockerfile-tools` -{: #dockerfile-tools} - -* Dockerfile für den Container mit den Tools. -* Syntax: `bx dev dockerfile-tools [path/to/dockerfile]` - -##### `image-name-tools` -{: #image-name-tools} - -* Image, das durch die Ausführung von "dockerfile-tools" erstellt werden soll. -* Syntax: `bx dev image-name-tools [path/to/image-name]` - -##### `build-cmd-run` -{: #build-cmd-run} - -* Befehl zur Erstellung für alle Verwendungen bis auf das Debugging (DEBUG). -* Syntax: `bx dev build-cmd-run [some.build.command]` - -##### `test-cmd` -{: #test-cmd} - -* Befehl zum Testen des Codes im Container mit den Tools. -* Syntax: `bx dev test-cmd [/the/test/command]` - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.dev_cli_short}} +{: #developercli} + +Das {{site.data.keyword.dev_cli_long}} bietet ein erweiterbares befehlsgesteuertes Konzept zum Erstellen, Entwickeln und Bereitstellen eines Webprojekts im Plug-in `dev`. Es ist ideal für Entwickler, die für die Entwicklung von End-to-End-Mikroservice-Anwendungen die Befehlszeilensteuerung verwenden möchten. + +{: shortdesc} + +Vom {{site.data.keyword.dev_cli_notm}} werden zwei Container zum leichteren Erstellen und Testen der Anwendung verwendet. Der erste ist der Container für die Tools, in dem die erforderlichen Dienstprogramme zum Erstellen und Testen der Anwendung enthalten sind. Die Dockerfile für diesen Container wird durch den Parameter [dockerfile-tools](#command-parameters) definiert. Er kann als Entwicklungscontainer angesehen werden, da er die Tools enthält, die normalerweise für Entwicklung einer bestimmten Laufzeit nützlich sind. + +Der zweite Container ist der Ausführungscontainer. Dieser Container ist so konzipiert, dass er sich zur Bereitstellung für die Verwendung eignet, zum Beispiel in {{site.data.keyword.Bluemix}}. Aus diesem Grund ist für diesen Container in der Regel ein Einstiegspunkt definiert, über den die Anwendung gestartet wird. Wenn Sie auswählen, dass die Anwendung über die {{site.data.keyword.dev_cli_short}} gestartet werden soll, wird hierfür dieser Container verwendet. Die Dockerfile für diesen Container wird durch den Parameter [dockerfile-run](#run-parameters) definiert. + + +## Ein {{site.data.keyword.dev_cli_notm}} hinzufügen +{: #add-cli} + + +### Voraussetzungen +{: #prereq} + +Zum vollständigen Kennenlernen und ordnungsgemäßen Verwenden der {{site.data.keyword.dev_cli_short}} müssen einige Voraussetzungen erfüllt sein, da es sehr erweiterbar ist und die Nutzung weiterer komplementärer Technologien ermöglicht. + +1. Installieren Sie die [Cloud Foundry CLI ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/cloudfoundry/cli#getting-started). + +2. Installieren Sie die [{{site.data.keyword.Bluemix}} CLI ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://clis.ng.bluemix.net/ui/home.html). + +3. Rufen Sie eine [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net)-ID ab. + +4. Optional: Wenn Sie beabsichtigen, Anwendungen lokal auszuführen und lokal für sie eine Fehlerbehebung auszuführen, müssen Sie auch [Docker ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.docker.com/get-docker) installieren. Dies ist nur für nicht mobile Projekt erforderlich. + + +### Installieren +{: #installation} + +1. Installieren Sie die [{{site.data.keyword.dev_cli_short}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} durch Ausführen des folgenden Befehls: + + ``` + bx plugin install dev -r Bluemix + ``` + {: codeblock} + +2. Überprüfen Sie durch die Ausführung des folgenden Befehls, ob die Installation erfolgreich war: + + ``` + bx dev + ``` + {: codeblock} + + +### Vorbemerkungen +{: #before-install} + +1. Melden Sie sich an {{site.data.keyword.Bluemix_notm}} an. + + ``` + bx login + ``` + {: codeblock} + + **Hinweis:** Wenn Ihre Berechtigungsnachweise abgelehnt werden, kann es sein, dass Sie eine föderierte ID verwenden. Führen Sie die folgenden Schritte aus, um sich mit einer föderierten ID zu authentifizieren. + + + + 1. Melden Sie sich an [{{site.data.keyword.iamshort}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.bluemix.net/iam/#/apikeys){: new_window} an. + 2. Wählen Sie **API-Schlüssel erstellen** aus. + * Geben Sie einen Namen und eine Beschreibung für den API-Schlüssel ein. + 3. Laden Sie den API-Schlüssel herunter. + 4. Öffnen Sie die Datei und kopieren Sie den Wert aus dem Feld `apiKey`. + 5. Melden Sie sich unter Verwendung des folgenden Befehls an: + + ``` + bx login --apikey + ``` + {: codeblock} + + +## Befehle +{: #commands} + +Verwenden Sie die folgenden Befehle, um ein Projekt zu erstellen, es bereitzustellen, eine Fehlerbehebung dafür auszuführen und es zu testen. + +### Erstellen +{: #build} + +Sie können eine Anwendung mit dem Befehl `build` erstellen. Das Konfigurationselement `build-cmd-run` wird zum Erstellen der Anwendung verwendet. Mit den Befehlen `test`, `debug` und `run` wird die Erstellung immer auf dieselbe Art wie mit diesem Befehl als Bestandteil der normalen Operation ausgeführt; somit ist die Ausführung vor diesen nicht erforderlich. + +Führen Sie den folgenden Befehl im aktuellen Projektverzeichnis aus, um die Anwendung zu erstellen: + +``` +bx dev build +``` +{: codeblock} + + +[Befehlsparameter erstellen](#command-parameters) + + +### Code +{: #code} + +Mit dem Befehl `code` können Sie nach der Bereitstellung Anwendungscode herunterladen, sodass Sie lokale Überprüfungen oder weitere Änderungen vornehmen können. + +Führen Sie den folgenden Befehl aus, um den Code von einem bestimmten Projekt herunterzuladen. + +``` +bx dev code +``` +{: codeblock} + + +### Erstellen +{: #create} + +Erstellen Sie ein neues Projekt, für das zum Angeben aller erforderlichen Informationen einschließlich Sprache, Projektname und Appmustertyp aufgefordert wird. Das Projekt wird im aktuellen Verzeichnis erstellt. + +Führen Sie den folgenden Befehl aus, um ein neues Projekt im aktuellen Projektverzeichnis zu erstellen und ihm Services zuzuordnen: + +``` +bx dev create +``` +{: codeblock} + + +### Debuggen +{: #debug} + +Sie können eine Anwendung mit dem Befehl `debug` debuggen. Zunächst wird für das Projekt mithilfe des Konfigurationselements `build-cmd-debug` als Buildanweisung eine Erstellung ausgeführt. Anschließend wird ein Container gestartet, von dem ein Debug-Port oder Ports wie in `container-port-map-debug` definiert verfügbar gemacht wird bzw. werden. Verbinden Sie Ihr bevorzugtes Debugging-Tool mit dem Port bzw. den Ports; danach können Sie die Anwendung wie sonst debuggen. + +**Einschränkung:** Derzeit kann für Swift-Projekte kein Debugging durchgeführt werden. + +Führen Sie den folgenden Befehl im aktuellen Projektverzeichnis aus, um die Anwendung zu debuggen: + +``` +bx dev debug +``` +{: codeblock} + +Verwenden Sie zum Beenden der Debugsitzung `CTRL-C`. + + +#### Debugbefehlsparameter +{: #debug-parameters} + +Die folgenden Parameter werden ausschließlich mit dem Befehl `debug` verwendet und dienen als Unterstützung beim Debugging einer Anwendung. + +##### `container-port-map-debug` +{: #port-map-debug} + +* Portzuordnungen für den Debugging-Port. Der erste Wert ist der Port, der im Hostbetriebssystem verwendet werden soll, der zweite ist der Port im Container (host:container). +* Syntax: `bx dev debug container-port-map-debug [7777:7777]` + +##### `build-cmd-debug` +{: #build-cmd-debug} + +* Wird zum Erstellen des Codes für das Debugging (DEBUG) verwendet. +* Syntax: `bx dev debug build-cmd-debug build.command.sh` + +##### `debug-cmd` +{: #debug-cmd} + +* Wird zum Debuggen von Code im Container für die Tools verwendet. Dies ist optional, wenn die Anwendung von `build-cmd-debug` durch Debuggen gestartet wird. +* Syntax: `bx dev debug debug-cmd /the/debug/command` + +#### Debuggen einer lokalen Anwendung: +{: #local-app-dev} + +Weitere Informationen zum Debuggen einer lokalen Anwendung finden Sie unter [Debuggen einer lokalen Anwendung](docs/cloudnative/dev_cli_local_debug.html#local-debug). + + +### Löschen +{: #delete} + +Mit diesem Befehl können Sie Projekte im {{site.data.keyword.Bluemix}}-Bereich löschen. + +Führen Sie den folgenden Befehl aus, um ein Projekt in {{site.data.keyword.Bluemix}} zu löschen: + +``` +bx dev delete +``` +{: codeblock} + + +**Hinweis:** {{site.data.keyword.Bluemix}}-Services werden **nicht** entfernt. + + +### Hilfe +{: #help} + +Wenn keine Aktionen bzw. Argumente übergeben werden oder wenn die Aktion "Hilfe" bereitgestellt wird, wird bei Verwendung dieses Befehls standardmäßig ein erweiterter Hilfetext angezeigt. Die erweiterte Hilfe umfasst eine Beschreibung der Basisargumente sowie eine Liste der verfügbaren Aktionen. + +Führen Sie den folgenden Befehl aus, um die erweiterte Hilfeinformationen anzuzeigen: + +``` +bx dev help +``` +{: codeblock} + + +### Auflisten +{: #list} + +Sie können alle {{site.data.keyword.Bluemix_notm}}-Projekte in einem Bereich auflisten. + +Führen Sie den folgenden Befehl aus, um die Projekte aufzulisten: + +``` +bx dev list +``` +{: codeblock} + + + + + +### Ausführen +{: #run} + +Sie können eine Anwendung mit dem Befehl `run` ausführen. Zunächst wird für das Projekt mithilfe des Konfigurationselements `build-cmd-run` als Buildanweisung eine Erstellung ausgeführt. Anschließend wird der Ausführungscontainer gestartet und die Ports werden wie von `container-port-map` definiert bereitgestellt. `run-cmd` kann zum Aufrufen der Anwendung verwendet werden, wenn der Ausführungscontainer nicht einen Einstiegspunkt zur Ausführung dieses Schritts enthält. + +Führen Sie den folgenden Befehl im aktuellen Projektverzeichnis aus, um die Anwendung zu starten: + +``` +bx dev run +``` +{: codeblock} + +Verwenden Sie zum Beenden der Sitzung `CTRL-C`. + + +#### Ausführungsparameter +{: #run-parameters} + +Die folgenden Parameter werden ausschließlich mit dem Befehl `run` verwendet und dienen als Unterstützung beim Verwalten der Anwendung im Ausführungscontainer. + +##### `container-name-run` +{: #container-name-run} + +* Containername für den Ausführungscontainer. +* Syntax: `bx dev run container-name-run ` + +##### `container-path-run` +{: #container-path-run} + +* Position im Container, die bei der Ausführung gemeinsam genutzt werden soll. +* Syntax: `bx dev run container-path-run [/path/to/app]` + +##### `host-path-run` +{: #host-path-run} + +* Position im Hostsystem, die im Container beim Ausführen gemeinsam genutzt werden soll. +* Syntax: `bx dev run host-path-run [/path/to/app/bin]` + +##### `dockerfile-run` +{: #dockerfile-run} + +* Dockerfile für den Ausführungscontainer. +* Syntax: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` + +##### `image-name-run` +{: #image-name-run} + +* Image, das durch die Ausführung der Dockerfile (dockerfile-run) erstellt werden soll. +* Syntax: `bx dev run image-name-run [/path/to/image-name]` + +##### `run-cmd` +{: #run-cmd} + +* Optionaler Parameter, der zum Ausführen des Codes im Container verwendet wird. Dies ist optional, wenn die Anwendung vom Image gestartet wird. +* Syntax: `bx dev run run-cmd [/the/run/command]` + +### Status +{: #status} + +Sie können den Status der von der {{site.data.keyword.dev_cli_short}} verwendeten Container wie von `container-name-run` und `container-name-tools` definiert abfragen. + +Führen Sie den folgenden Befehl im aktuellen Projektverzeichnis aus, um den Containerstatus zu überprüfen: + +``` +bx dev status +``` +{: codeblock} + + +[Statusbefehlsparameter](#command-parameters) + + +### Stoppen +{: #stop} + +Sie können einen Container mit dem Befehl `stop` stoppen. Mit dem Parameter `container-name` können Sie den Container angeben, der gestoppt werden soll. Falls dieser nicht angegeben ist, wird durch den Stoppbefehl der unter Verwendung von `container-name-run` definierte Ausführungscontainer gestoppt. + +Führen Sie den folgenden Befehl im aktuellen Projektverzeichnis aus, um einen Container zu stoppen: + +``` +bx dev stop +``` +{: codeblock} + + +#### Weitere Stoppparameter: +{: #stop-parameter} + +##### `container-name` +{: #container-name} + +* Containername für den Container mit den Tools. +* Syntax: `bx dev stop container-name ` + +### Testen +{: #test} + +Sie können eine Anwendung mit dem Befehl `test` testen. Zunächst wird für das Projekt mithilfe des Konfigurationselements `build-cmd-run` als Buildanweisung eine Erstellung ausgeführt. Anschließend wird der Container mit den Tools zum Aufrufen von `test-cmd` für die Anwendung verwendet. + +Führen Sie den folgenden Befehl aus, um die Anwendung zu testen: + +``` +bx dev test +``` +{: codeblock} + + +[Testbefehlsparameter](#command-parameters) + + +## Parameter zum Erstellen, Debuggen, Ausführen und Testen +{: #command-parameters} + +Die folgenden Parameter können zusammen mit den Befehlen `build|debug|run|test` verwendet werden und in der Befehlszeile und/oder beim direkten Aktualisieren der Datei `cli-config.yml` des Projekts angegeben werden. Für die Befehle [`debug`](#debug-parameters) und [`run`](#run-parameters) stehen weitere Parameter zur Verfügung; sie sind in den jeweiligen Abschnitten dokumentiert. + +**Hinweis:** In der Befehlszeile eingegebene Befehlsparameter haben Vorrang vor der Konfiguration in `cli-config.yml`. + +##### `container-name-tools` +{: #container-name-tools} + +* Containername für den Container mit den Tools. +* Syntax: `bx dev container-name-tools []` + +##### `host-path-tools` +{: #host-path-tools} + +* Position auf dem Host, die zum Erstellen, Debuggen und Testen gemeinsam genutzt werden soll. +* Syntax: `bx dev host-path-tools [/path/to/build/tools]` + +##### `container-path-tools` +{: #container-path-tools} + +* Position im Container, die zum Erstellen, Debuggen und Testen gemeinsam genutzt werden soll. +* Syntax: `bx dev container-path-tools [/path/for/build]` + +##### `container-port-map` +{: #container-port-map} + +* Portzuordnungen für den Container. Der erste Wert ist der Port, der im Hostbetriebssystem verwendet werden soll, der zweite ist der Port im Container (host:container). +* Syntax: `bx dev container-port-map [8090:8090,9090,9090]` + +##### `dockerfile-tools` +{: #dockerfile-tools} + +* Dockerfile für den Container mit den Tools. +* Syntax: `bx dev dockerfile-tools [path/to/dockerfile]` + +##### `image-name-tools` +{: #image-name-tools} + +* Image, das durch die Ausführung von "dockerfile-tools" erstellt werden soll. +* Syntax: `bx dev image-name-tools [path/to/image-name]` + +##### `build-cmd-run` +{: #build-cmd-run} + +* Befehl zur Erstellung für alle Verwendungen bis auf das Debugging (DEBUG). +* Syntax: `bx dev build-cmd-run [some.build.command]` + +##### `test-cmd` +{: #test-cmd} + +* Befehl zum Testen des Codes im Container mit den Tools. +* Syntax: `bx dev test-cmd [/the/test/command]` + diff --git a/cloudnative/nl/de/dev_cli_local_debug.md b/cloudnative/nl/de/dev_cli_local_debug.md index 53d2a88c9..5382d846e 100644 --- a/cloudnative/nl/de/dev_cli_local_debug.md +++ b/cloudnative/nl/de/dev_cli_local_debug.md @@ -1,76 +1,76 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Debuggen einer lokalen Anwendung -{: #local-debug} - -Nachfolgend werden die Anweisungen zum Debuggen einer lokalen Anwendung für die folgenden Sprachen aufgeführt: - -* [Java](#java) -* [Node.js](#node) - -**Hinweis:** Das Debugging von Swift-Anwendungen wird derzeit nicht unterstützt. - -## Debuggen einer Java-Anwendung -{: #java} - -Schritte zur Aktivierung eines Debuggings für eine Java-Anwendung: - -1. Führen Sie im Stammverzeichnis des Anwendungsprojekts den folgenden Befehl aus: - - `bx dev debug` - -2. Verbinden Sie den Debugger mit der Anwendung: - - * [Eclipse ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) - * [IntelliJ ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) - * [VSCode ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) - * JDK-Befehlszeile: `jdb -attach ` - -## Debuggen einer Node.js-Anwendung - -{: #node} - -Schritte zur Aktivierung eines Debuggings für eine Node.js-Anwendung: - -1. Führen Sie im Stammverzeichnis des Anwendungsprojekts den folgenden Befehl aus: - - `bx dev debug` - -2. Verbinden Sie den Debugger mit der Anwendung: - * [VSCode ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://blog.docker.com/2016/07/live-debugging-docker/). - * [WebStorm ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Debuggen einer lokalen Anwendung +{: #local-debug} + +Nachfolgend werden die Anweisungen zum Debuggen einer lokalen Anwendung für die folgenden Sprachen aufgeführt: + +* [Java](#java) +* [Node.js](#node) + +**Hinweis:** Das Debugging von Swift-Anwendungen wird derzeit nicht unterstützt. + +## Debuggen einer Java-Anwendung +{: #java} + +Schritte zur Aktivierung eines Debuggings für eine Java-Anwendung: + +1. Führen Sie im Stammverzeichnis des Anwendungsprojekts den folgenden Befehl aus: + + `bx dev debug` + +2. Verbinden Sie den Debugger mit der Anwendung: + + * [Eclipse ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) + * [IntelliJ ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) + * [VSCode ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) + * JDK-Befehlszeile: `jdb -attach ` + +## Debuggen einer Node.js-Anwendung + +{: #node} + +Schritte zur Aktivierung eines Debuggings für eine Node.js-Anwendung: + +1. Führen Sie im Stammverzeichnis des Anwendungsprojekts den folgenden Befehl aus: + + `bx dev debug` + +2. Verbinden Sie den Debugger mit der Anwendung: + * [VSCode ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://blog.docker.com/2016/07/live-debugging-docker/). + * [WebStorm ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) + + + + + diff --git a/cloudnative/nl/de/devex.md b/cloudnative/nl/de/devex.md index b9c73fb3f..23fd5c3e8 100644 --- a/cloudnative/nl/de/devex.md +++ b/cloudnative/nl/de/devex.md @@ -1,31 +1,31 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.dev_console}} -{: #devex} - -Klicken Sie zum Starten der [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://console.{DomainName}/developer/getting-started) auf die Kategorie **Web and Mobile** in der {{site.data.keyword.Bluemix_notm}}-Konsole. - - -## Einführung -{: getting-started} - -Erstellen Sie auf der Seite **Einführung** ein Projekt, indem Sie auf **Projekt erstellen** klicken. Daraufhin werden Optionen für [Muster](patterns.html), [Starter](starters.html) und [Sprache](patterns.html#languages) angezeigt, mit denen Sie schnell eine App erstellen können. - -Durch Auswahl der Seite [Projekte ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://console.{DomainName}/developer/projects) können Sie alle Projekte an einer zentralen Stelle anzeigen und verwalten. Das Projekt enthält die Informationen für alle Leistungsmerkmale, die in Ihre App integriert sind und in diese integriert werden können. Sie können die mobilen Push-, Analytics-, Authentication- und Data-Services leicht in das Projekt integrieren und dort verwalten (sofern verfügbar). In naher Zukunft werden noch weitere Leistungsmerkmale hinzukommen. - -Auf der Seite [Services](services.html) wird eine Betriebsansicht Ihrer vorhandenen Serviceinstanzen angezeigt. Von der {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} werden ein für die Cloud nativer Entwickler und ein für die Cloud nativer Appverwaltungsbenutzer unterstützt. - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.dev_console}} +{: #devex} + +Klicken Sie zum Starten der [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://console.{DomainName}/developer/getting-started) auf die Kategorie **Web and Mobile** in der {{site.data.keyword.Bluemix_notm}}-Konsole. + + +## Einführung +{: getting-started} + +Erstellen Sie auf der Seite **Einführung** ein Projekt, indem Sie auf **Projekt erstellen** klicken. Daraufhin werden Optionen für [Muster](patterns.html), [Starter](starters.html) und [Sprache](patterns.html#languages) angezeigt, mit denen Sie schnell eine App erstellen können. + +Durch Auswahl der Seite [Projekte ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://console.{DomainName}/developer/projects) können Sie alle Projekte an einer zentralen Stelle anzeigen und verwalten. Das Projekt enthält die Informationen für alle Leistungsmerkmale, die in Ihre App integriert sind und in diese integriert werden können. Sie können die mobilen Push-, Analytics-, Authentication- und Data-Services leicht in das Projekt integrieren und dort verwalten (sofern verfügbar). In naher Zukunft werden noch weitere Leistungsmerkmale hinzukommen. + +Auf der Seite [Services](services.html) wird eine Betriebsansicht Ihrer vorhandenen Serviceinstanzen angezeigt. Von der {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} werden ein für die Cloud nativer Entwickler und ein für die Cloud nativer Appverwaltungsbenutzer unterstützt. + + + diff --git a/cloudnative/nl/de/get_code.md b/cloudnative/nl/de/get_code.md index b5c88044d..7fb86639b 100644 --- a/cloudnative/nl/de/get_code.md +++ b/cloudnative/nl/de/get_code.md @@ -1,80 +1,80 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-18" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# Code abrufen -{: #Get_Code} - -Wenn Sie die Konfiguration und die Einrichtung Ihres Projekts mit Ihren ausgewählten Funktionen abgeschlossen haben, können Sie den Code herunterladen, mit dem Sie den Code ausführen können. Ihr heruntergeladenes Projekt ist mit den erforderlichen SDK-Abhängigkeiten und Berechtigungsnachweisen für jede von Ihnen konfigurierte Funktion vorkonfiguriert. - -Für Services in Ihrem heruntergeladenen Projekt, die nicht konfigurierbar sind, müssen Sie die Berechtigungsnachweise für Services ausfüllen. Die `README.md`-Datei für das Starter-Projekt enthält entsprechende Anweisungen. Zeigen Sie die `README.md`-Datei in einem Markdown-Viewer an und vervollständigen Sie die Einrichtung. - -## Vorausgesetzte Entwicklertools -{: #prereq-dev-tools} - -Für die Arbeit mit generiertem Code über die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} sind folgende Entwicklertools erforderlich: - - -### Allgemein -{: #general notoc} - -* [Homebrew ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://brew.sh/) - * Befehlszeilentool zur Unterstützung der Installation anderer Tools und Laufzeiten, z. B. CocoaPods und Carthage, für Apple-Entwickler. - -* [Docker ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.docker.com/get-docker) - * Open-Source-Projekt zur Unterstützung bei der Ausführung und beim Debugging von Anwendungen in Containern. Nur für nicht mobile Projekte erforderlich. - -### {{site.data.keyword.Bluemix_notm}} -{: #bluemix notoc} - -* Node.js (Node- und NPM-Laufzeiten) zur Unterstützung des aktiven {{site.data.keyword.apiconnect_short}}-Loopback und anderer {{site.data.keyword.Bluemix_notm}}-Produktivitätstools. - - Zur lokalen Ausführung von {{site.data.keyword.apiconnect_short}}-Tools verwenden Sie Node 5.x: - - ``` - $ brew install Node5 - ``` - -* [Bluemix CLI-Tools ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://clis.ng.bluemix.net/ui/home.html) - - Befehlszeilentools für die Bereitstellung von Cloud Foundry-Laufzeiten über eine Befehlszeilenschnittstelle mit {{site.data.keyword.Bluemix_notm}}. - -* [{{site.data.keyword.dev_cli_notm}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](dev_cli.html) - - {{site.data.keyword.Bluemix_notm}} CLI-Plug-in zum Erstellen, Ausführen, Testen und Bereitstellen von Webprojekten und mobilen Projekten. - -* [SDK Generator-Plug-in ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](sdk_cli.html) - - {{site.data.keyword.Bluemix_notm}} CLI-Plug-in zum Generieren von SDKs aus der REST-API-Definition, die mit der [Open API-Spezifikation ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.openapis.org/) kompatibel ist. - -### Android -{: #android notoc} - -* [Android Studio 2.2 oder aktueller![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.android.com/studio) - * Installieren Sie die aktuelle [Android 7.0 ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.android.com/versions/nougat-7-0/)-Laufzeit. - -### iOS -{: #ios notoc} - -* [Xcode 8 ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com/xcode/) (empfohlen) - - -* [CocoaPods ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://cocoapods.org/)-Abhängigkeitsmanager zum Installieren von iOS-SDK-Abhängigkeiten. Verwenden Sie die aktuelle Version: - - ``` - $ sudo gem install cocoapods --pre - ``` -* [Carthage ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/Carthage/Carthage)-Abhängigkeitsmanager zum Installieren der {{site.data.keyword.watson}} Developer Cloud-SDKs. - - ``` - $ brew install carthage - ``` +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-18" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# Code abrufen +{: #Get_Code} + +Wenn Sie die Konfiguration und die Einrichtung Ihres Projekts mit Ihren ausgewählten Funktionen abgeschlossen haben, können Sie den Code herunterladen, mit dem Sie den Code ausführen können. Ihr heruntergeladenes Projekt ist mit den erforderlichen SDK-Abhängigkeiten und Berechtigungsnachweisen für jede von Ihnen konfigurierte Funktion vorkonfiguriert. + +Für Services in Ihrem heruntergeladenen Projekt, die nicht konfigurierbar sind, müssen Sie die Berechtigungsnachweise für Services ausfüllen. Die `README.md`-Datei für das Starter-Projekt enthält entsprechende Anweisungen. Zeigen Sie die `README.md`-Datei in einem Markdown-Viewer an und vervollständigen Sie die Einrichtung. + +## Vorausgesetzte Entwicklertools +{: #prereq-dev-tools} + +Für die Arbeit mit generiertem Code über die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} sind folgende Entwicklertools erforderlich: + + +### Allgemein +{: #general notoc} + +* [Homebrew ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://brew.sh/) + * Befehlszeilentool zur Unterstützung der Installation anderer Tools und Laufzeiten, z. B. CocoaPods und Carthage, für Apple-Entwickler. + +* [Docker ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.docker.com/get-docker) + * Open-Source-Projekt zur Unterstützung bei der Ausführung und beim Debugging von Anwendungen in Containern. Nur für nicht mobile Projekte erforderlich. + +### {{site.data.keyword.Bluemix_notm}} +{: #bluemix notoc} + +* Node.js (Node- und NPM-Laufzeiten) zur Unterstützung des aktiven {{site.data.keyword.apiconnect_short}}-Loopback und anderer {{site.data.keyword.Bluemix_notm}}-Produktivitätstools. + + Zur lokalen Ausführung von {{site.data.keyword.apiconnect_short}}-Tools verwenden Sie Node 5.x: + + ``` + $ brew install Node5 + ``` + +* [Bluemix CLI-Tools ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://clis.ng.bluemix.net/ui/home.html) + + Befehlszeilentools für die Bereitstellung von Cloud Foundry-Laufzeiten über eine Befehlszeilenschnittstelle mit {{site.data.keyword.Bluemix_notm}}. + +* [{{site.data.keyword.dev_cli_notm}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](dev_cli.html) + + {{site.data.keyword.Bluemix_notm}} CLI-Plug-in zum Erstellen, Ausführen, Testen und Bereitstellen von Webprojekten und mobilen Projekten. + +* [SDK Generator-Plug-in ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](sdk_cli.html) + + {{site.data.keyword.Bluemix_notm}} CLI-Plug-in zum Generieren von SDKs aus der REST-API-Definition, die mit der [Open API-Spezifikation ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.openapis.org/) kompatibel ist. + +### Android +{: #android notoc} + +* [Android Studio 2.2 oder aktueller![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.android.com/studio) + * Installieren Sie die aktuelle [Android 7.0 ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.android.com/versions/nougat-7-0/)-Laufzeit. + +### iOS +{: #ios notoc} + +* [Xcode 8 ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com/xcode/) (empfohlen) + + +* [CocoaPods ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://cocoapods.org/)-Abhängigkeitsmanager zum Installieren von iOS-SDK-Abhängigkeiten. Verwenden Sie die aktuelle Version: + + ``` + $ sudo gem install cocoapods --pre + ``` +* [Carthage ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/Carthage/Carthage)-Abhängigkeitsmanager zum Installieren der {{site.data.keyword.watson}} Developer Cloud-SDKs. + + ``` + $ brew install carthage + ``` diff --git a/cloudnative/nl/de/index.md b/cloudnative/nl/de/index.md index ca990324d..495a6b5d2 100644 --- a/cloudnative/nl/de/index.md +++ b/cloudnative/nl/de/index.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2016-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Cloudorientierte Projekte erstellen -{: #web-mobile} - -Sie können cloudorientierte Apps unter Verwendung des Konzepts der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}-[Projekte](projects.html) verwalten. Sie können ein Projekt mit der [{{site.data.keyword.dev_console}}](devex.html) oder dem [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) für die {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI verwalten. Die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} stellt die am meisten gebräuchlichen Servicefunktionen, die für einen cloudorientierten Anwendungsentwickler erforderlich sind, in einer einzigen übergreifenden Umgebung bereit, die für Entwickler optimiert wurde. - -Die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ermöglicht einem cloudorientierten Anwendungsentwickler die Erstellung eines Projekts über eine Vielzahl von [Mustertypen](patterns.html) und [Startern](starters.html), die Erstellung wichtiger {{site.data.keyword.Bluemix_notm}}-optimierter Services und deren Verbindung mit Ihrem Projekt sowie das schnelle Herunterladen von Code mithilfe von SDKs. Die SDKs sind vollständig mit den Funktionsberechtigungsnachweisen oder Abhängigkeiten integriert, um Ihnen die Ausführung innerhalb weniger Minuten zu ermöglichen. Wenn Ihre Anwendung aktiv ist und Sie die Funktionen eingerichtet und konfiguriert haben, können Sie zu Ihrem Projekt zurückkehren, um die Aktivitäten Ihrer Anwendungsbenutzer zu überwachen und zu verwalten. Sie können die Services auch über die {{site.data.keyword.dev_console}} konfigurieren und verwalten. - - - - - - -# Zugehörige Links -{: #rellinks notoc} - -## Lernprogramme und Beispiele -{: #samples notoc} - -* [Beispiel: Mobiles Back-End für Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} -* [Schulungsvideos](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2016-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Cloudorientierte Projekte erstellen +{: #web-mobile} + +Sie können cloudorientierte Apps unter Verwendung des Konzepts der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}-[Projekte](projects.html) verwalten. Sie können ein Projekt mit der [{{site.data.keyword.dev_console}}](devex.html) oder dem [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) für die {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI verwalten. Die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} stellt die am meisten gebräuchlichen Servicefunktionen, die für einen cloudorientierten Anwendungsentwickler erforderlich sind, in einer einzigen übergreifenden Umgebung bereit, die für Entwickler optimiert wurde. + +Die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ermöglicht einem cloudorientierten Anwendungsentwickler die Erstellung eines Projekts über eine Vielzahl von [Mustertypen](patterns.html) und [Startern](starters.html), die Erstellung wichtiger {{site.data.keyword.Bluemix_notm}}-optimierter Services und deren Verbindung mit Ihrem Projekt sowie das schnelle Herunterladen von Code mithilfe von SDKs. Die SDKs sind vollständig mit den Funktionsberechtigungsnachweisen oder Abhängigkeiten integriert, um Ihnen die Ausführung innerhalb weniger Minuten zu ermöglichen. Wenn Ihre Anwendung aktiv ist und Sie die Funktionen eingerichtet und konfiguriert haben, können Sie zu Ihrem Projekt zurückkehren, um die Aktivitäten Ihrer Anwendungsbenutzer zu überwachen und zu verwalten. Sie können die Services auch über die {{site.data.keyword.dev_console}} konfigurieren und verwalten. + + + + + + +# Zugehörige Links +{: #rellinks notoc} + +## Lernprogramme und Beispiele +{: #samples notoc} + +* [Beispiel: Mobiles Back-End für Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} +* [Schulungsvideos](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} diff --git a/cloudnative/nl/de/patterns.md b/cloudnative/nl/de/patterns.md index d84364e47..8e795c838 100644 --- a/cloudnative/nl/de/patterns.md +++ b/cloudnative/nl/de/patterns.md @@ -1,99 +1,99 @@ - ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Mustertypen -{: #patterns} - -Cloudorientierte Muster sind bewährte Designs, die dazu beitragen, eine konsistente, skalierbare und zuverlässige Topologie für die Anwendungen sicherzustellen. Wenn Sie ein Projekt erstellen, können Sie aus verschiedenen Mustertypen einen auswählen. Sie wählen einfach Mustertyp und Funktionen aus, die im Projekt enthalten sein sollen. Nachdem Sie die Projektvorgaben definiert haben, wird ein Starter-Projekt generiert, das Sie bearbeiten, ausführen oder debuggen und lokal oder in {{site.data.keyword.Bluemix}} bereitstellen können. - -## Web-App -{: #web} - -Webprojekte ermöglichen das Bereitstellen von Inhalt in Form von HTML, JavaScript und Style-Sheets auf einem Web-Server. - -Die folgenden Web-Starter sind verfügbar: - -* Basic Web: Stellt die statische Datei `index.html`, ein Standard-Style-Sheet und ein leeres Style-Sheet und eine JavaScript-Datei bereit. -* WebPack: Erstellt ein Projekt, in dem sich die ECMAScript 6-Quellendateien (ES6-Quellendateien) in `src/client` befinden und mit WebPack kompiliert werden, um sie zu verkleinern und für die Verwendung im Browser umzuwandeln. -* WebPack + React: Eine umfassende Umgebung zum Erstellen von Benutzerschnittstellen. Die Quellendateien befinden sich in `src/client/app`, werden mit WebPack kompiliert und im öffentlichen Verzeichnis bereitgestellt. - - -## Mobile App -{: #mobile} - -Die Muster für mobile Apps erleichtern das Erstellen mobiler Apps, die direkt eine Verbindung zu Back-End-Services aufbauen, zum Beispiel zu {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, {{site.data.keyword.appid_short}}, etc. Die Projekte können auch über sdkGen, wie BFFs, und Microservices hinzufügt werden. - -Sie können einen Starter aus einer Starterliste auswählen, zum Beispiel {{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, {{site.data.keyword.openwhisk_short}}, etc. - -Sie können die mobilen Apps in Swift, Android oder Cordova generieren. - - -## Backend for Frontend (BFF) -{: #bff} - -BFF-Muster, die auch als BFFs bezeichnet werden, unterstützen Sie bei der Bereitstellung von Geschäftsdaten und Services in einer Form, die mit den Anforderungen für die Benutzerinteraktion übereinstimmt. Um die User Journey zu Ihrer Cloudlösung optimieren zu können, benötigen Sie für mobile Anwendungen möglicherweise eine separate User Journey sowie eine User Journey für Webanwendungen, die normalerweise umfangreicher und detaillierter gestaltet ist. Durch die Einführung sprachgesteuerter Einheiten wie z. B. den [{{site.data.keyword.conversationfull}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.ibm.com/watson/developercloud/conversation.html)-Service kann die Interaktion mit einem Benutzer sprachlich gesteuert werden. Dieser digitale Vertriebskanal erfordert ein grundlegend anderes BFF zur Verwaltung dieser absichtsbasierten Sprachinteraktionen. - -Mit {{site.data.keyword.Bluemix_notm}} können Sie ein BFF erstellen, indem Sie einen polyglotten Programmieransatz zum Definieren des BFF anwenden. IBM empfiehlt die Verwendung von Node.js, Swift oder Java und die Ausführung dieser Komponenten in einem cloudorientierten nativen Muster entweder mit Cloud Foundry, Container-Services oder ohne Server. - -Das BFF verwaltet die Integration mit Services für die Datenpersistenz, das Caching und die Integration mit hochwertigen Services wie {{site.data.keyword.ibmwatson}}, {{site.data.keyword.iot_short_notm}}, {{site.data.keyword.weather_short}} sowie mit Datenanalyseprodukten wie {{site.data.keyword.sparks}}. - -Das BFF stellt eine API bereit, die im Normalfall ein REST-Muster verwendet. Sie können das BFF jedoch auch so entwerfen, dass es über eine Nachrichtenarchitektur mit {{site.data.keyword.messagehub}} arbeitet. - -Ein Basic-Starter für BFF steht bei Verwendung von Node.js oder Swift zur Verfügung. - - -## Microservice -{: #microservice} - -Microservice-Projekte bieten die Basis zum Erstellen von Back-End-Microservices, einschließlich eines Basiszustandsendpunkts und einer REST-API. Generierte Projekte enthalten alle Abhängigkeiten, die für den Microservice selbst und alle zugeordneten Cloud-Services erforderlich sind. - -Ein Basic-Starter für Microservice steht bei Verwendung von Java zur Verfügung. - - - - -## Sprachen -{: #languages notoc} - -Folgende Sprachen werden unterstützt: - - * [Java ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](../runtimes/liberty/getting-started.html){: new_window} - * [Node.js ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](../runtimes/nodejs/getting-started.html){: new_window} - * [Swift ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](../runtimes/swift/getting-started.html){: new_window} - - -### Java -{: #java notoc} - -Java verfügt über bewährte Funktionen zum Erstellen von auf Unternehmen abgestimmten Anwendungen. Aber aufgrund der neuen Funktionen in Java 8, kombiniert mit einfacheren Laufzeiten wie Liberty und Umgebungen wie Spring Boot, ist Java auch perfekt zum Erstellen von Microservices geeignet. - - -### Node.js -{: #node notoc} - -Node.js ist eine JavaScript-Laufzeit, von der ein ereignisgesteuertes, nicht blockierendes E/A-Modell verwendet wird, das sie einfach und effizient macht und einen außergewöhnlichen Durchsatz und eine hervorragende Skalierbarkeit für Webanwendungen, BFF-Muster und Microservices ermöglicht. Das direkte Geschäftsumfeld des Node.js-Pakets, NPM, bietet Zugriff auf eine große Auswahl an Open-Source-Modulen und somit ein großes Angebot an Funktionen zum Beschleunigen der Anwendungsentwicklung. - - -### Swift -{: #swift notoc} - -Swift ist eine moderne Programmiersprache, die 2014 von Apple geschaffen wurde, um Objective C und Open-Source-Programmen im Dezember 2015 zu ersetzen. Heute wird sie zum Erstellen von iOS-, macOS-, Web-Services- und Systemsoftware auf den Betriebssystemen Linux und macOS unter Verwendung der x86-, ARM- oder Z-Architektur verwendet. Sie wird wie eine Scripting-Sprache geschrieben, wird aber kompiliert, um mit wenig Aufwand eine hohe Leistung zu erreichen, die C ähnelt, und sich somit ideal für Cloudlaufzeiten eignet. Sie verwendet ein starkes und statisches Typsystem, das auch in Java vorhanden ist, aber auch den funktionalen Stil und die asynchronen Routinen, die in JavaScript üblich sind. Sie ist sehr leistungsfähig und die Quelle wird mit dem LLVM-Compiler Toolchain in nativen Code kompiliert; außerdem kann sie problemlos Fremdsystembibliotheken nutzen, die in C geschrieben sind. + +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Mustertypen +{: #patterns} + +Cloudorientierte Muster sind bewährte Designs, die dazu beitragen, eine konsistente, skalierbare und zuverlässige Topologie für die Anwendungen sicherzustellen. Wenn Sie ein Projekt erstellen, können Sie aus verschiedenen Mustertypen einen auswählen. Sie wählen einfach Mustertyp und Funktionen aus, die im Projekt enthalten sein sollen. Nachdem Sie die Projektvorgaben definiert haben, wird ein Starter-Projekt generiert, das Sie bearbeiten, ausführen oder debuggen und lokal oder in {{site.data.keyword.Bluemix}} bereitstellen können. + +## Web-App +{: #web} + +Webprojekte ermöglichen das Bereitstellen von Inhalt in Form von HTML, JavaScript und Style-Sheets auf einem Web-Server. + +Die folgenden Web-Starter sind verfügbar: + +* Basic Web: Stellt die statische Datei `index.html`, ein Standard-Style-Sheet und ein leeres Style-Sheet und eine JavaScript-Datei bereit. +* WebPack: Erstellt ein Projekt, in dem sich die ECMAScript 6-Quellendateien (ES6-Quellendateien) in `src/client` befinden und mit WebPack kompiliert werden, um sie zu verkleinern und für die Verwendung im Browser umzuwandeln. +* WebPack + React: Eine umfassende Umgebung zum Erstellen von Benutzerschnittstellen. Die Quellendateien befinden sich in `src/client/app`, werden mit WebPack kompiliert und im öffentlichen Verzeichnis bereitgestellt. + + +## Mobile App +{: #mobile} + +Die Muster für mobile Apps erleichtern das Erstellen mobiler Apps, die direkt eine Verbindung zu Back-End-Services aufbauen, zum Beispiel zu {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, {{site.data.keyword.appid_short}}, etc. Die Projekte können auch über sdkGen, wie BFFs, und Microservices hinzufügt werden. + +Sie können einen Starter aus einer Starterliste auswählen, zum Beispiel {{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, {{site.data.keyword.openwhisk_short}}, etc. + +Sie können die mobilen Apps in Swift, Android oder Cordova generieren. + + +## Backend for Frontend (BFF) +{: #bff} + +BFF-Muster, die auch als BFFs bezeichnet werden, unterstützen Sie bei der Bereitstellung von Geschäftsdaten und Services in einer Form, die mit den Anforderungen für die Benutzerinteraktion übereinstimmt. Um die User Journey zu Ihrer Cloudlösung optimieren zu können, benötigen Sie für mobile Anwendungen möglicherweise eine separate User Journey sowie eine User Journey für Webanwendungen, die normalerweise umfangreicher und detaillierter gestaltet ist. Durch die Einführung sprachgesteuerter Einheiten wie z. B. den [{{site.data.keyword.conversationfull}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.ibm.com/watson/developercloud/conversation.html)-Service kann die Interaktion mit einem Benutzer sprachlich gesteuert werden. Dieser digitale Vertriebskanal erfordert ein grundlegend anderes BFF zur Verwaltung dieser absichtsbasierten Sprachinteraktionen. + +Mit {{site.data.keyword.Bluemix_notm}} können Sie ein BFF erstellen, indem Sie einen polyglotten Programmieransatz zum Definieren des BFF anwenden. IBM empfiehlt die Verwendung von Node.js, Swift oder Java und die Ausführung dieser Komponenten in einem cloudorientierten nativen Muster entweder mit Cloud Foundry, Container-Services oder ohne Server. + +Das BFF verwaltet die Integration mit Services für die Datenpersistenz, das Caching und die Integration mit hochwertigen Services wie {{site.data.keyword.ibmwatson}}, {{site.data.keyword.iot_short_notm}}, {{site.data.keyword.weather_short}} sowie mit Datenanalyseprodukten wie {{site.data.keyword.sparks}}. + +Das BFF stellt eine API bereit, die im Normalfall ein REST-Muster verwendet. Sie können das BFF jedoch auch so entwerfen, dass es über eine Nachrichtenarchitektur mit {{site.data.keyword.messagehub}} arbeitet. + +Ein Basic-Starter für BFF steht bei Verwendung von Node.js oder Swift zur Verfügung. + + +## Microservice +{: #microservice} + +Microservice-Projekte bieten die Basis zum Erstellen von Back-End-Microservices, einschließlich eines Basiszustandsendpunkts und einer REST-API. Generierte Projekte enthalten alle Abhängigkeiten, die für den Microservice selbst und alle zugeordneten Cloud-Services erforderlich sind. + +Ein Basic-Starter für Microservice steht bei Verwendung von Java zur Verfügung. + + + + +## Sprachen +{: #languages notoc} + +Folgende Sprachen werden unterstützt: + + * [Java ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](../runtimes/liberty/getting-started.html){: new_window} + * [Node.js ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](../runtimes/nodejs/getting-started.html){: new_window} + * [Swift ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](../runtimes/swift/getting-started.html){: new_window} + + +### Java +{: #java notoc} + +Java verfügt über bewährte Funktionen zum Erstellen von auf Unternehmen abgestimmten Anwendungen. Aber aufgrund der neuen Funktionen in Java 8, kombiniert mit einfacheren Laufzeiten wie Liberty und Umgebungen wie Spring Boot, ist Java auch perfekt zum Erstellen von Microservices geeignet. + + +### Node.js +{: #node notoc} + +Node.js ist eine JavaScript-Laufzeit, von der ein ereignisgesteuertes, nicht blockierendes E/A-Modell verwendet wird, das sie einfach und effizient macht und einen außergewöhnlichen Durchsatz und eine hervorragende Skalierbarkeit für Webanwendungen, BFF-Muster und Microservices ermöglicht. Das direkte Geschäftsumfeld des Node.js-Pakets, NPM, bietet Zugriff auf eine große Auswahl an Open-Source-Modulen und somit ein großes Angebot an Funktionen zum Beschleunigen der Anwendungsentwicklung. + + +### Swift +{: #swift notoc} + +Swift ist eine moderne Programmiersprache, die 2014 von Apple geschaffen wurde, um Objective C und Open-Source-Programmen im Dezember 2015 zu ersetzen. Heute wird sie zum Erstellen von iOS-, macOS-, Web-Services- und Systemsoftware auf den Betriebssystemen Linux und macOS unter Verwendung der x86-, ARM- oder Z-Architektur verwendet. Sie wird wie eine Scripting-Sprache geschrieben, wird aber kompiliert, um mit wenig Aufwand eine hohe Leistung zu erreichen, die C ähnelt, und sich somit ideal für Cloudlaufzeiten eignet. Sie verwendet ein starkes und statisches Typsystem, das auch in Java vorhanden ist, aber auch den funktionalen Stil und die asynchronen Routinen, die in JavaScript üblich sind. Sie ist sehr leistungsfähig und die Quelle wird mit dem LLVM-Compiler Toolchain in nativen Code kompiliert; außerdem kann sie problemlos Fremdsystembibliotheken nutzen, die in C geschrieben sind. diff --git a/cloudnative/nl/de/projects.md b/cloudnative/nl/de/projects.md index ad2e1ce2d..fbb3b692d 100644 --- a/cloudnative/nl/de/projects.md +++ b/cloudnative/nl/de/projects.md @@ -1,57 +1,57 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Projekte -{: #projects} - -Die {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} kombiniert die App-Benutzerschnittstelle, die Daten und Services zu einem vollständigen Projekt (*project*). Indem Sie ein Projekt erstellen, werden alle erforderlichen Teile Ihrer App und die hinzugefügten Funktionen auf dem {{site.data.keyword.Bluemix_notm}}-Server beibehalten. Sie können den App-Code und die erforderlichen Berechtigungsnachweise und Initialisierungsoperatoren herunterladen, wenn die Services im Projekt konfiguriert sind. Durch Auswahl von **Projekte** können Sie alle Projekte anzeigen. - -Sie können zusätzliche Informationen zu einem einzelnen Projekt anzeigen; hierfür müssen Sie es auf der Seite **Projekte** auswählen. Dadurch wird die Seite **Projektübersicht** angezeigt; dort sind die Services aufgeführt, die konfiguriert und für das Projekt verfügbar sind. Services sind separate Funktionen, die Ihre App durch Hinzufügen einer Funktion erweitern. Da sie einzeln hinzugefügt werden, können Sie sich auf die Services beschränken, die Sie benötigen, wie zum Beispiel Push-, Authentication-, Data- und Storage-Services oder andere Services. Wenn Sie auf der Seite **Projektübersicht** einen Service zu Ihrem Projekt hinzufügen und die Anweisungen zum Konfigurieren des Service befolgen, wird der Service automatisch Ihrer App zugeordnet. Weitere Informationen zur Seite 'Projektübersicht' finden Sie im Abschnitt [Seite 'Projektübersicht'](project_overview_page.html). - -Zum Erstellen eines Projekts müssen Sie ein [Muster](patterns.html) und danach einen [Starter](starters.html) auswählen. - - -## Seite 'Projektübersicht' -{: #project_overview} - -Sie können ein einzelnes Projekt in der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} anzeigen und verwenden, indem Sie das Projekt auf der Seite **Projekte** auswählen. Durch diese Aktion wird die Seite 'Projektübersicht' geöffnet. -{: shortdesc} - -Auf der Seite **Projektübersicht** wird eine Kachel für jede Funktion angezeigt, die für das ausgewählte Projekt konfiguriert oder zum Konfigurieren verfügbar ist. In der Kachel werden der Funktionstyp und die Schaltfläche *Aktionen* mit drei vertikal ausgerichteten Punkten angezeigt. Zu den verfügbaren bzw. konfigurierten Funktionen können beispielsweise {{site.data.keyword.mobilepushshort}}, Analytics oder Data und Storage gehören. Welche Funktionen kompatibel sind, hängt vom Typ des Projekts und von den Funktionen ab, die in der jeweiligen Region verfügbar sind (d. h. nicht alle Funktionen können allen Projekten zugeordnet werden). - -Wenn ein Funktionstyp noch nicht dem Projekt zugeordnet ist, wird auf der Kachel die Schaltfläche **Erstellen** angezeigt. Die verfügbaren Optionen der Schaltfläche für Aktionen ermöglichen das Erstellen einer Serviceinstanz oder das Hinzufügen einer vorhandenen Serviceinstanz, falls die betreffende Funktion noch nicht zugeordnet ist. Nach dem Auswählen der Option **Vorhandene hinzufügen** wird eine Liste der Serviceinstanzen des betreffenden Typs im Bereich angezeigt. - -Wenn die Funktion bereits diesem Projekt zugeordnet ist, wird der Name der zugehörigen Serviceinstanz auf der Kachel nach dem Funktionstyp angezeigt. Dies vereinfacht das Auffinden der zugehörigen Serviceinstanz für dieses Projekt in der {{site.data.keyword.dev_console}}. Über die Aktionsschaltfläche stehen die Aktionen **Anzeigen** und **Entfernen** zur Verfügung, wenn die Funktion bereits dem Projekt zugeordnet ist. Beim Entfernen einer Serviceinstanz wird lediglich die Zuordnung zu diesem Projekt aufgehoben. Die Serviceinstanz in der {{site.data.keyword.dev_console}} wird nicht gelöscht. Klicken Sie zum Löschen einer Serviceinstanz auf die Seite **Web and Mobile > Services**, um die Serviceinstanzen anzuzeigen und zu löschen. - -Wählen Sie **Code abrufen** in der Kachel **Code** aus, um den Code für Ihr Projekt herunterzuladen. Weitere Informationen zum Herunterladen von Code finden Sie unter [Code abrufen](get_code.html). - - -## Projekt zur Verwendung eines neuen Starters aktualisieren -{: #update-starter} - -1. Klicken Sie auf der Seite **Projekte** oder **Projektübersicht** auf das Symbol **Überlaufmenü** und wählen Sie **Starter aktualisieren** aus. - -2. Wählen Sie einen neuen Starter aus und klicken Sie auf **Aktualisieren**. - -3. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. - - Alternativ können Sie auf die Seite **Code** klicken. - - -## Projekt zum Generieren einer neuen Sprache aktualisieren -{: #update-language} - -1. Klicken Sie auf der Seite **Projekte** oder **Projektübersicht** auf das Symbol **Überlaufmenü** und wählen Sie **Starter aktualisieren** aus. - -2. Wählen Sie eine neue Sprache aus und klicken Sie auf **Aktualisieren**. - -3. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Projekte +{: #projects} + +Die {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} kombiniert die App-Benutzerschnittstelle, die Daten und Services zu einem vollständigen Projekt (*project*). Indem Sie ein Projekt erstellen, werden alle erforderlichen Teile Ihrer App und die hinzugefügten Funktionen auf dem {{site.data.keyword.Bluemix_notm}}-Server beibehalten. Sie können den App-Code und die erforderlichen Berechtigungsnachweise und Initialisierungsoperatoren herunterladen, wenn die Services im Projekt konfiguriert sind. Durch Auswahl von **Projekte** können Sie alle Projekte anzeigen. + +Sie können zusätzliche Informationen zu einem einzelnen Projekt anzeigen; hierfür müssen Sie es auf der Seite **Projekte** auswählen. Dadurch wird die Seite **Projektübersicht** angezeigt; dort sind die Services aufgeführt, die konfiguriert und für das Projekt verfügbar sind. Services sind separate Funktionen, die Ihre App durch Hinzufügen einer Funktion erweitern. Da sie einzeln hinzugefügt werden, können Sie sich auf die Services beschränken, die Sie benötigen, wie zum Beispiel Push-, Authentication-, Data- und Storage-Services oder andere Services. Wenn Sie auf der Seite **Projektübersicht** einen Service zu Ihrem Projekt hinzufügen und die Anweisungen zum Konfigurieren des Service befolgen, wird der Service automatisch Ihrer App zugeordnet. Weitere Informationen zur Seite 'Projektübersicht' finden Sie im Abschnitt [Seite 'Projektübersicht'](project_overview_page.html). + +Zum Erstellen eines Projekts müssen Sie ein [Muster](patterns.html) und danach einen [Starter](starters.html) auswählen. + + +## Seite 'Projektübersicht' +{: #project_overview} + +Sie können ein einzelnes Projekt in der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} anzeigen und verwenden, indem Sie das Projekt auf der Seite **Projekte** auswählen. Durch diese Aktion wird die Seite 'Projektübersicht' geöffnet. +{: shortdesc} + +Auf der Seite **Projektübersicht** wird eine Kachel für jede Funktion angezeigt, die für das ausgewählte Projekt konfiguriert oder zum Konfigurieren verfügbar ist. In der Kachel werden der Funktionstyp und die Schaltfläche *Aktionen* mit drei vertikal ausgerichteten Punkten angezeigt. Zu den verfügbaren bzw. konfigurierten Funktionen können beispielsweise {{site.data.keyword.mobilepushshort}}, Analytics oder Data und Storage gehören. Welche Funktionen kompatibel sind, hängt vom Typ des Projekts und von den Funktionen ab, die in der jeweiligen Region verfügbar sind (d. h. nicht alle Funktionen können allen Projekten zugeordnet werden). + +Wenn ein Funktionstyp noch nicht dem Projekt zugeordnet ist, wird auf der Kachel die Schaltfläche **Erstellen** angezeigt. Die verfügbaren Optionen der Schaltfläche für Aktionen ermöglichen das Erstellen einer Serviceinstanz oder das Hinzufügen einer vorhandenen Serviceinstanz, falls die betreffende Funktion noch nicht zugeordnet ist. Nach dem Auswählen der Option **Vorhandene hinzufügen** wird eine Liste der Serviceinstanzen des betreffenden Typs im Bereich angezeigt. + +Wenn die Funktion bereits diesem Projekt zugeordnet ist, wird der Name der zugehörigen Serviceinstanz auf der Kachel nach dem Funktionstyp angezeigt. Dies vereinfacht das Auffinden der zugehörigen Serviceinstanz für dieses Projekt in der {{site.data.keyword.dev_console}}. Über die Aktionsschaltfläche stehen die Aktionen **Anzeigen** und **Entfernen** zur Verfügung, wenn die Funktion bereits dem Projekt zugeordnet ist. Beim Entfernen einer Serviceinstanz wird lediglich die Zuordnung zu diesem Projekt aufgehoben. Die Serviceinstanz in der {{site.data.keyword.dev_console}} wird nicht gelöscht. Klicken Sie zum Löschen einer Serviceinstanz auf die Seite **Web and Mobile > Services**, um die Serviceinstanzen anzuzeigen und zu löschen. + +Wählen Sie **Code abrufen** in der Kachel **Code** aus, um den Code für Ihr Projekt herunterzuladen. Weitere Informationen zum Herunterladen von Code finden Sie unter [Code abrufen](get_code.html). + + +## Projekt zur Verwendung eines neuen Starters aktualisieren +{: #update-starter} + +1. Klicken Sie auf der Seite **Projekte** oder **Projektübersicht** auf das Symbol **Überlaufmenü** und wählen Sie **Starter aktualisieren** aus. + +2. Wählen Sie einen neuen Starter aus und klicken Sie auf **Aktualisieren**. + +3. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. + + Alternativ können Sie auf die Seite **Code** klicken. + + +## Projekt zum Generieren einer neuen Sprache aktualisieren +{: #update-language} + +1. Klicken Sie auf der Seite **Projekte** oder **Projektübersicht** auf das Symbol **Überlaufmenü** und wählen Sie **Starter aktualisieren** aus. + +2. Wählen Sie eine neue Sprache aus und klicken Sie auf **Aktualisieren**. + +3. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. diff --git a/cloudnative/nl/de/sdk.md b/cloudnative/nl/de/sdk.md index 7a24274d8..b81baffa2 100644 --- a/cloudnative/nl/de/sdk.md +++ b/cloudnative/nl/de/sdk.md @@ -1,67 +1,67 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-17" - ---- -# SDKs -{: #sdk} - -Um {{site.data.keyword.Bluemix}} Mobile Services-SDKs zu Ihrer App hinzuzufügen, wählen Sie die SDKs aus, die Sie verwenden möchten, und konfigurieren Sie Ihren Abhängigkeitsmanager so, dass die SDKs in Ihre App übertragen werden. - - -## Client-SDKs -{: #client_sdk} - -Folgende SDKs können Sie in Ihrer mobilen Anwendung verwenden, um die jeweiligen Leistungsmerkmale zu nutzen. - - -### Android-SDKs -{: #android_sdk} - -- [Kern-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) -- [{{site.data.keyword.mobileanalytics_short}}-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) -- [{{site.data.keyword.mobilepushshort}}-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) -- [SDK für die Facebook-Authentifizierung ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) -- [SDK für die Google-Authentifizierung ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) - - -### iOS-SDKs -{: #ios_sdk} - -- [Kern-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) -- [{{site.data.keyword.mobileanalytics_short}}-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) -- [{{site.data.keyword.mobilepushshort}}-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) -- [SDK für die Facebook-Authentifizierung ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) -- [SDK für die Google-Authentifizierung ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) -- [{{site.data.keyword.amashort}}-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) - - -### Cordova-Plug-ins -{: #cordova_plugin} - -- [Core-Plug-in ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) -- [{{site.data.keyword.mobilepushshort}}-Plug-in ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## Server-SDKs -{: #server_sdk} - -Wenn Sie über eine Java-, NodeJS- oder Swift-Serveranwendung verfügen, können Sie für die Kommunikation mit den entsprechenden Services folgende SDKs verwenden. - - -### {{site.data.keyword.mobilepushshort}}-Server-SDKs -{: #push_sdk} - -- [{{site.data.keyword.mobilepushshort}}-Java-Server-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) -- [{{site.data.keyword.mobilepushshort}}-Swift-Server-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) -- [{{site.data.keyword.mobilepushshort}}-NodeJS-Server-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) - - -### {{site.data.keyword.amashort}}-Server-SDK -{: #mca_sdk} - -- [{{site.data.keyword.amashort}}-Swift-Server-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) - - +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-17" + +--- +# SDKs +{: #sdk} + +Um {{site.data.keyword.Bluemix}} Mobile Services-SDKs zu Ihrer App hinzuzufügen, wählen Sie die SDKs aus, die Sie verwenden möchten, und konfigurieren Sie Ihren Abhängigkeitsmanager so, dass die SDKs in Ihre App übertragen werden. + + +## Client-SDKs +{: #client_sdk} + +Folgende SDKs können Sie in Ihrer mobilen Anwendung verwenden, um die jeweiligen Leistungsmerkmale zu nutzen. + + +### Android-SDKs +{: #android_sdk} + +- [Kern-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) +- [{{site.data.keyword.mobileanalytics_short}}-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) +- [{{site.data.keyword.mobilepushshort}}-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) +- [SDK für die Facebook-Authentifizierung ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) +- [SDK für die Google-Authentifizierung ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) + + +### iOS-SDKs +{: #ios_sdk} + +- [Kern-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) +- [{{site.data.keyword.mobileanalytics_short}}-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) +- [{{site.data.keyword.mobilepushshort}}-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) +- [SDK für die Facebook-Authentifizierung ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) +- [SDK für die Google-Authentifizierung ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) +- [{{site.data.keyword.amashort}}-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) + + +### Cordova-Plug-ins +{: #cordova_plugin} + +- [Core-Plug-in ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) +- [{{site.data.keyword.mobilepushshort}}-Plug-in ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## Server-SDKs +{: #server_sdk} + +Wenn Sie über eine Java-, NodeJS- oder Swift-Serveranwendung verfügen, können Sie für die Kommunikation mit den entsprechenden Services folgende SDKs verwenden. + + +### {{site.data.keyword.mobilepushshort}}-Server-SDKs +{: #push_sdk} + +- [{{site.data.keyword.mobilepushshort}}-Java-Server-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) +- [{{site.data.keyword.mobilepushshort}}-Swift-Server-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) +- [{{site.data.keyword.mobilepushshort}}-NodeJS-Server-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) + + +### {{site.data.keyword.amashort}}-Server-SDK +{: #mca_sdk} + +- [{{site.data.keyword.amashort}}-Swift-Server-SDK ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) + + diff --git a/cloudnative/nl/de/sdk_BMSClient.md b/cloudnative/nl/de/sdk_BMSClient.md index 59523cd77..21efb757e 100644 --- a/cloudnative/nl/de/sdk_BMSClient.md +++ b/cloudnative/nl/de/sdk_BMSClient.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# BMSClient initialisieren -{: #sdk_BMSClient} - -`BMSCore` stellt die HTTP-Infrastruktur bereit, die die anderen {{site.data.keyword.Bluemix}} Mobile-Services-Client-SDKs zur Kommunikation mit ihren entsprechenden {{site.data.keyword.Bluemix_notm}}-Services verwenden. - - -## Eigene Android-Anwendung initialisieren -{: #init-BMSClient-android} - -Sie können das `BMSCore`-Paket entweder in Ihr Android Studio-Projekt herunterladen und importieren oder Gradle verwenden. - -1. Importieren Sie das Client-SDK durch Hinzufügen der folgenden Anweisung des Typs `import` an den Anfang Ihrer Projektdatei: - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; - ``` - {: codeblock} - -2. Initialisieren Sie das `BMSClient`-SDK in Ihrer Android-Anwendung, indem Sie den Initialisierungscode in der Methode `onCreate` der Hauptaktivität in Ihrer Android-Anwendung oder an einer Position hinzufügen, die für Ihr Projekt am geeignetsten ist. - - ```Java - BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region - ``` - {: codeblock} - - Sie müssen `BMSClient` mit dem Parameter **bluemixRegion** initialisieren. Im Initialisierungsoperator gibt der Wert **bluemixRegion** an, welche {{site.data.keyword.Bluemix_notm}}-Bereitstellung Sie verwenden, z. B. `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` oder `BMSClient.REGION_SYDNEY`. - - -## Eigene iOS-Anwendung initialisieren -{: #init-BMSClient-ios} - -Sie können mithilfe von [CocoaPods](https://cocoapods.org){: new_window} oder [Carthage](https://github.com/Carthage/Carthage){: new_window} das `BMSCore`-Paket abrufen. - -1. Fügen Sie zur Installation von `BMSCore` mithilfe von CocoaPods die folgenden Zeilen zu Ihrer Podfile hinzu. Wenn Ihr Projekt noch keine Podfile aufweist, verwenden Sie den Befehl `pod init`. - - ```Swift - use_frameworks! - - target 'MyApp' do - pod 'BMSCore' - end - ``` - {: codeblock} - - Führen Sie anschließend den Befehl `pod install` aus und öffnen Sie die generierte Datei des Typs `.xcworkspace`. Zur Aktualisierung auf ein neueres Release von `BMSCore` müssen Sie den Befehl `pod update BMSCore` verwenden. - - Weitere Informationen zur Verwendung von CocoaPods finden Sie auf der Seite [CocoaPods Guides ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://guides.cocoapods.org/using/index.html){: new_window}. - -2. Befolgen Sie zur Installation von `BMSCore` mithilfe von Carthage diese [Anweisungen ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/Carthage/Carthage#getting-started){: new_window}. - - 1. Fügen Sie die folgende Zeile zu Ihrer Cartfile hinzu: - - ``` - github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" - ``` - {: codeblock} - - 2. Führen Sie den Befehl `carthage update` aus. - - 3. Fügen Sie nach Fertigstellung des Builds `BMSCore.framework` zu Ihrem Projekt hinzu. Führen Sie dazu [Schritt 3 ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/Carthage/Carthage#getting-started) in den Carthage-Anweisungen durch. - - Verwenden Sie für Anwendungen, die mit Swift 2.3 aufgebaut sind, den Befehl `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3`. Verwenden Sie andernfalls den Befehl `carthage update`. - -3. Importieren Sie das Modul. - - ```Swift - import BMSCore - ``` - {: codeblock} - -4. Initialisieren Sie mithilfe des folgenden Codes die Klasse `BMSClient`. - - Platzieren Sie den Initialisierungscode in der Methode `application(_:didFinishLaunchingWithOptions:)` Ihres Anwendungsbeauftragten oder an einer Position, die für Ihr Projekt am geeignetsten ist. - - ```Swift - BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region - ``` - {: codeblock} - - Sie müssen `BMSClient` mit dem Parameter **bluemixRegion** initialisieren. Im Initialisierungsoperator gibt der Wert **bluemixRegion** an, welche {{site.data.keyword.Bluemix_notm}}-Bereitstellung Sie verwenden, z. B. `BMSClient.Region.usSouth`, `BMSClient.Region.unitedKingdom` oder `BMSClient.Region.sydney`. - - -## Eigene Cordova-Anwendung initialisieren -{: #init-BMSClient-cordova} - -1. Fügen Sie das Cordova-Plug-in hinzu, indem Sie den folgenden Befehl im Stammverzeichnis Ihrer Cordova-Anwendung ausführen: - - ``` - cordova plugin add bms-core - ``` - {: codeblock} - -2. Initialisieren Sie die Klasse `BMSClient` in Ihrer Cordova-Anwendung, indem Sie den Initialisierungscode in der Haupt-JavaScript-Datei oder an einer Position hinzufügen, die für Ihr Projekt am geeignetsten ist. - - ``` - BMSClient.initialize(BMSClient.REGION_US_SOUTH); - ``` - {: codeblock} - - Sie müssen `BMSClient` mit dem Parameter **bluemixRegion** initialisieren. Im Initialisierungsoperator gibt der Wert **bluemixRegion** an, welche {{site.data.keyword.Bluemix_notm}}-Bereitstellung Sie verwenden, z. B. `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` oder `BMSClient.REGION_SYDNEY`. - - -# Zugehörige Links -{: #rellinks notoc} - -## Zugehörige Links -{: #general notoc} - -* [BMSCore-Android-SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore-iOS-SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore-Cordova-Plug-in](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# BMSClient initialisieren +{: #sdk_BMSClient} + +`BMSCore` stellt die HTTP-Infrastruktur bereit, die die anderen {{site.data.keyword.Bluemix}} Mobile-Services-Client-SDKs zur Kommunikation mit ihren entsprechenden {{site.data.keyword.Bluemix_notm}}-Services verwenden. + + +## Eigene Android-Anwendung initialisieren +{: #init-BMSClient-android} + +Sie können das `BMSCore`-Paket entweder in Ihr Android Studio-Projekt herunterladen und importieren oder Gradle verwenden. + +1. Importieren Sie das Client-SDK durch Hinzufügen der folgenden Anweisung des Typs `import` an den Anfang Ihrer Projektdatei: + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; + ``` + {: codeblock} + +2. Initialisieren Sie das `BMSClient`-SDK in Ihrer Android-Anwendung, indem Sie den Initialisierungscode in der Methode `onCreate` der Hauptaktivität in Ihrer Android-Anwendung oder an einer Position hinzufügen, die für Ihr Projekt am geeignetsten ist. + + ```Java + BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region + ``` + {: codeblock} + + Sie müssen `BMSClient` mit dem Parameter **bluemixRegion** initialisieren. Im Initialisierungsoperator gibt der Wert **bluemixRegion** an, welche {{site.data.keyword.Bluemix_notm}}-Bereitstellung Sie verwenden, z. B. `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` oder `BMSClient.REGION_SYDNEY`. + + +## Eigene iOS-Anwendung initialisieren +{: #init-BMSClient-ios} + +Sie können mithilfe von [CocoaPods](https://cocoapods.org){: new_window} oder [Carthage](https://github.com/Carthage/Carthage){: new_window} das `BMSCore`-Paket abrufen. + +1. Fügen Sie zur Installation von `BMSCore` mithilfe von CocoaPods die folgenden Zeilen zu Ihrer Podfile hinzu. Wenn Ihr Projekt noch keine Podfile aufweist, verwenden Sie den Befehl `pod init`. + + ```Swift + use_frameworks! + + target 'MyApp' do + pod 'BMSCore' + end + ``` + {: codeblock} + + Führen Sie anschließend den Befehl `pod install` aus und öffnen Sie die generierte Datei des Typs `.xcworkspace`. Zur Aktualisierung auf ein neueres Release von `BMSCore` müssen Sie den Befehl `pod update BMSCore` verwenden. + + Weitere Informationen zur Verwendung von CocoaPods finden Sie auf der Seite [CocoaPods Guides ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://guides.cocoapods.org/using/index.html){: new_window}. + +2. Befolgen Sie zur Installation von `BMSCore` mithilfe von Carthage diese [Anweisungen ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/Carthage/Carthage#getting-started){: new_window}. + + 1. Fügen Sie die folgende Zeile zu Ihrer Cartfile hinzu: + + ``` + github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" + ``` + {: codeblock} + + 2. Führen Sie den Befehl `carthage update` aus. + + 3. Fügen Sie nach Fertigstellung des Builds `BMSCore.framework` zu Ihrem Projekt hinzu. Führen Sie dazu [Schritt 3 ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/Carthage/Carthage#getting-started) in den Carthage-Anweisungen durch. + + Verwenden Sie für Anwendungen, die mit Swift 2.3 aufgebaut sind, den Befehl `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3`. Verwenden Sie andernfalls den Befehl `carthage update`. + +3. Importieren Sie das Modul. + + ```Swift + import BMSCore + ``` + {: codeblock} + +4. Initialisieren Sie mithilfe des folgenden Codes die Klasse `BMSClient`. + + Platzieren Sie den Initialisierungscode in der Methode `application(_:didFinishLaunchingWithOptions:)` Ihres Anwendungsbeauftragten oder an einer Position, die für Ihr Projekt am geeignetsten ist. + + ```Swift + BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region + ``` + {: codeblock} + + Sie müssen `BMSClient` mit dem Parameter **bluemixRegion** initialisieren. Im Initialisierungsoperator gibt der Wert **bluemixRegion** an, welche {{site.data.keyword.Bluemix_notm}}-Bereitstellung Sie verwenden, z. B. `BMSClient.Region.usSouth`, `BMSClient.Region.unitedKingdom` oder `BMSClient.Region.sydney`. + + +## Eigene Cordova-Anwendung initialisieren +{: #init-BMSClient-cordova} + +1. Fügen Sie das Cordova-Plug-in hinzu, indem Sie den folgenden Befehl im Stammverzeichnis Ihrer Cordova-Anwendung ausführen: + + ``` + cordova plugin add bms-core + ``` + {: codeblock} + +2. Initialisieren Sie die Klasse `BMSClient` in Ihrer Cordova-Anwendung, indem Sie den Initialisierungscode in der Haupt-JavaScript-Datei oder an einer Position hinzufügen, die für Ihr Projekt am geeignetsten ist. + + ``` + BMSClient.initialize(BMSClient.REGION_US_SOUTH); + ``` + {: codeblock} + + Sie müssen `BMSClient` mit dem Parameter **bluemixRegion** initialisieren. Im Initialisierungsoperator gibt der Wert **bluemixRegion** an, welche {{site.data.keyword.Bluemix_notm}}-Bereitstellung Sie verwenden, z. B. `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` oder `BMSClient.REGION_SYDNEY`. + + +# Zugehörige Links +{: #rellinks notoc} + +## Zugehörige Links +{: #general notoc} + +* [BMSCore-Android-SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore-iOS-SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore-Cordova-Plug-in](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/de/sdk_cli.md b/cloudnative/nl/de/sdk_cli.md index f9dfe00da..6ab87db1c 100644 --- a/cloudnative/nl/de/sdk_cli.md +++ b/cloudnative/nl/de/sdk_cli.md @@ -1,178 +1,178 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# SDK Generator-Plug-in -{: #sdk-cli} - -Das {{site.data.keyword.IBM}} SDK Generator-Plug-in kann in der [{{site.data.keyword.Bluemix_notm}}-CLI ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/cli/reference/bluemix_cli/index.html) installiert werden. - -Als Entwickler unter {{site.data.keyword.Bluemix_notm}} können Sie dieses Plug-in verwenden, um SDKs auf Basis der mit der [Open API-Spezifikation ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.openapis.org/) konformen REST-API-Definition zu generieren. Wenn Sie Änderungen an der REST-API-Definition vornehmen, dann können Sie dieses Plug-in verwenden, um nur das SDK und nicht das gesamte Projekt neu zu generieren. - -Außerdem können Sie ersehen, ob Ihre Cloud Foundry-Apps in einem bestimmten Bereich über REST-API-Definitionen verfügen, die für die SDK-Generierung gültig sind. Abschließend können Sie das {{site.data.keyword.IBM_notm}} SDK Generator-Plug-in verwenden, um alle REST-API-Definitionen zu überprüfen und um sicherzustellen, dass sie mit den SDK Generator-Anforderungen übereinstimmen. - -Dieses {{site.data.keyword.IBM_notm}} SDK Generator-Plug-in ermöglicht Ihnen die einfache Integration der Back-End-Services für Ihre App mit einem generierten SDK. Wenn eine Änderung an einer REST-API auftritt, dann können Sie das SDK neu generieren und das alte SDK zur reibungslosen Durchführung des SDK-Upgrades ersetzen. Außerdem können Sie die CLI in eine DevOps-Pipeline integrieren und so sicherstellen, dass das SDK immer mit der API-Spezifikation übereinstimmt, wenn die App erstellt wird. - -Die REST-API-Definition muss gültig sein und entweder auf einem Live-Serverendpunkt gehostet oder in einer lokalen Datei auf Ihrem System vorhanden sein. Wenn die REST-API-Definition gehostet wird, dann muss die relative URL in der Umgebungsvariablen `OPENAPI_SPEC` definiert sein. - - -## Voraussetzungen -{: #prereqs} - -Vergewissern Sie sich, dass die folgenden Anforderungen erfüllt sind. - -* Sie verfügen über ein [{{site.data.keyword.Bluemix_notm}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://bluemix.net)-Konto. -* Sie verfügen über eine gültige API-Definition, die der [Open API ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.openapis.org/)-Spezifikation entspricht. - - -## Installation -{: #installation} - -1. [Installieren Sie die {{site.data.keyword.Bluemix}}-CLI ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://clis.ng.bluemix.net/ui/home.html). - -2. [Installieren Sie das Plug-in ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in). - - ``` - bx plugin install sdk-gen -r Bluemix - ``` - {: codeblock} - - -## Befehle -{: #commands} - -Verwenden Sie die folgenden Befehle, um ein SDK zu generieren, die Open API-Definitionsdateien zu überprüfen oder die Cloud Foundry-Apps aufzulisten. - - -### SDK generieren -{: #gen} - -Verwenden Sie `bluemix sdk generate [arguments...][command options]`. - - -#### Argumente -{: #gen-args} - -* `APP_NAME` - Der Name der Cloud Foundry-App in Ihrem aktuellen Bereich. -* `OPENAPI_DOC_LOCATION` - Eine URL oder ein relativer Dateipfad zur JSON- oder Yaml-Komponente der unaufbereiteten REST-API-Definition. -* `GENERATED_SDK_NAME` (optional) - Der Name des generierten SDK. - - -#### Optionen -{: #gen-options} - -* `PLATFORM` (erforderlich) - * `--android` - Generiert ein Android-SDK. - * `--ios` - Generiert ein iOS Swift-SDK - * `--swift` - Generiert ein Swift-Server-SDK -* `--output "YOUR_RELATIVE_PATH"` (optional) - Platziert das generierte SDK in dem Verzeichnis, das in `YOUR_RELATIVE_PATH` angegeben wird (bereits vorhandene SDKs werden dabei überschrieben). -* `--unzip` (optional) - Extrahiert das generierte SDK (bereits vorhandene SDK-Artefakte werden dabei überschrieben). - - -#### Syntax -{: #gen-usage} - -Zum Generieren eines SDK auf Basis einer Cloud Foundry-App, die unter {{site.data.keyword.Bluemix_notm}} ausgeführt wird, können Sie den Namen der App als Parameter für die CLI verwenden. Im folgenden Befehl wird der Name der App im Parameter `SDK_Name` benutzt. - -``` -bluemix sdk generate [APP_NAME] [PLATFORM] -``` -{: codeblock} - -Zum Generieren eines SDK auf Basis einer URL zu einer Open API-Definitionsdatei oder einer lokalen JSON- oder Yaml-Datei verwenden Sie den folgenden Befehl. - -``` -bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] -``` -{: codeblock} - - -### Open API-Definitionen überprüfen -{: #validating} - -Verwenden Sie `bluemix sdk validate [argument]`. - - -#### Argumente -{: #val-args} - -* `APP_NAME` - Der Name der Cloud Foundry-App in Ihrem aktuellen Bereich. -* `OPENAPI_DOC_LOCATION` - Eine URL oder ein relativer Dateipfad zur JSON- oder Yaml-Komponente der unaufbereiteten REST-API-Definition. - - -#### Syntax -{: #val-usage} - -Zum Überprüfen der API-Spezifikation einer Cloud Foundry-App, die unter {{site.data.keyword.Bluemix_notm}} ausgeführt wird, können Sie den Namen der App als Parameter für die CLI verwenden. - -``` -bluemix sdk validate [APP_NAME] -``` -{: codeblock} - -Zum Überprüfen eines SDK auf Basis der URL zu einem Dokument mit API-Spezifikationen oder einer lokalen JSON- oder Yaml-Datei verwenden Sie den folgenden Befehl. - -``` -bluemix sdk validate [OPENAPI_DOC_LOCATION] -``` -{: codeblock} - - - -### Apps (Cloud Foundry) auflisten -{: #list-apps} - -Verwenden Sie `bluemix sdk list [argument][option]`, um Apps aufzulisten und API-Spezifikationen zu überprüfen. In der Umgebungsvariablen `OPENAPI_SPEC` muss der relative URL-Pfad angegeben werden, über den Ihre Spezifikation gehostet wird. - - -#### Argumente -{: #list-args} - -* `SPACE_NAME` (optional) - Der Name des Cloud Foundry-Bereichs in Ihrer aktuellen Organisation, der nach Apps durchsucht werden soll. Wird hier nichts angegeben, dann durchsucht das System den aktuellen Bereich. - - -#### Optionen -{: #list-options} - -* `--url` (optional) - Zeigt eine vollständig formatierte URL zur Open API-Definition jeder App in der Liste an. - - -#### Syntax -{: #list-usage} - -Verwenden Sie den folgenden Befehl, um Apps im aktuellen Bereich aufzulisten. - -``` -bluemix sdk list -``` -{: codeblock} - -Verwenden Sie den folgenden Befehl, um Apps im aktuellen Bereich aufzulisten und die URL zur API-Spezifikation anzuzeigen. - -``` -bluemix sdk list --url -``` -{: codeblock} - -Verwenden Sie den folgenden Befehl, um Apps in einem bestimmten Bereich aufzulisten. - -``` -bluemix sdk list [SPACE_NAME] -``` -{: codeblock} - -Verwenden Sie den folgenden Befehl, um Apps in einem bestimmten Bereich aufzulisten und die URL der API-Spezifikation anzuzeigen. - -``` -bluemix sdk list [SPACE_NAME] --url -``` -{: codeblock} +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# SDK Generator-Plug-in +{: #sdk-cli} + +Das {{site.data.keyword.IBM}} SDK Generator-Plug-in kann in der [{{site.data.keyword.Bluemix_notm}}-CLI ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/cli/reference/bluemix_cli/index.html) installiert werden. + +Als Entwickler unter {{site.data.keyword.Bluemix_notm}} können Sie dieses Plug-in verwenden, um SDKs auf Basis der mit der [Open API-Spezifikation ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.openapis.org/) konformen REST-API-Definition zu generieren. Wenn Sie Änderungen an der REST-API-Definition vornehmen, dann können Sie dieses Plug-in verwenden, um nur das SDK und nicht das gesamte Projekt neu zu generieren. + +Außerdem können Sie ersehen, ob Ihre Cloud Foundry-Apps in einem bestimmten Bereich über REST-API-Definitionen verfügen, die für die SDK-Generierung gültig sind. Abschließend können Sie das {{site.data.keyword.IBM_notm}} SDK Generator-Plug-in verwenden, um alle REST-API-Definitionen zu überprüfen und um sicherzustellen, dass sie mit den SDK Generator-Anforderungen übereinstimmen. + +Dieses {{site.data.keyword.IBM_notm}} SDK Generator-Plug-in ermöglicht Ihnen die einfache Integration der Back-End-Services für Ihre App mit einem generierten SDK. Wenn eine Änderung an einer REST-API auftritt, dann können Sie das SDK neu generieren und das alte SDK zur reibungslosen Durchführung des SDK-Upgrades ersetzen. Außerdem können Sie die CLI in eine DevOps-Pipeline integrieren und so sicherstellen, dass das SDK immer mit der API-Spezifikation übereinstimmt, wenn die App erstellt wird. + +Die REST-API-Definition muss gültig sein und entweder auf einem Live-Serverendpunkt gehostet oder in einer lokalen Datei auf Ihrem System vorhanden sein. Wenn die REST-API-Definition gehostet wird, dann muss die relative URL in der Umgebungsvariablen `OPENAPI_SPEC` definiert sein. + + +## Voraussetzungen +{: #prereqs} + +Vergewissern Sie sich, dass die folgenden Anforderungen erfüllt sind. + +* Sie verfügen über ein [{{site.data.keyword.Bluemix_notm}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://bluemix.net)-Konto. +* Sie verfügen über eine gültige API-Definition, die der [Open API ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.openapis.org/)-Spezifikation entspricht. + + +## Installation +{: #installation} + +1. [Installieren Sie die {{site.data.keyword.Bluemix}}-CLI ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://clis.ng.bluemix.net/ui/home.html). + +2. [Installieren Sie das Plug-in ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in). + + ``` + bx plugin install sdk-gen -r Bluemix + ``` + {: codeblock} + + +## Befehle +{: #commands} + +Verwenden Sie die folgenden Befehle, um ein SDK zu generieren, die Open API-Definitionsdateien zu überprüfen oder die Cloud Foundry-Apps aufzulisten. + + +### SDK generieren +{: #gen} + +Verwenden Sie `bluemix sdk generate [arguments...][command options]`. + + +#### Argumente +{: #gen-args} + +* `APP_NAME` - Der Name der Cloud Foundry-App in Ihrem aktuellen Bereich. +* `OPENAPI_DOC_LOCATION` - Eine URL oder ein relativer Dateipfad zur JSON- oder Yaml-Komponente der unaufbereiteten REST-API-Definition. +* `GENERATED_SDK_NAME` (optional) - Der Name des generierten SDK. + + +#### Optionen +{: #gen-options} + +* `PLATFORM` (erforderlich) + * `--android` - Generiert ein Android-SDK. + * `--ios` - Generiert ein iOS Swift-SDK + * `--swift` - Generiert ein Swift-Server-SDK +* `--output "YOUR_RELATIVE_PATH"` (optional) - Platziert das generierte SDK in dem Verzeichnis, das in `YOUR_RELATIVE_PATH` angegeben wird (bereits vorhandene SDKs werden dabei überschrieben). +* `--unzip` (optional) - Extrahiert das generierte SDK (bereits vorhandene SDK-Artefakte werden dabei überschrieben). + + +#### Syntax +{: #gen-usage} + +Zum Generieren eines SDK auf Basis einer Cloud Foundry-App, die unter {{site.data.keyword.Bluemix_notm}} ausgeführt wird, können Sie den Namen der App als Parameter für die CLI verwenden. Im folgenden Befehl wird der Name der App im Parameter `SDK_Name` benutzt. + +``` +bluemix sdk generate [APP_NAME] [PLATFORM] +``` +{: codeblock} + +Zum Generieren eines SDK auf Basis einer URL zu einer Open API-Definitionsdatei oder einer lokalen JSON- oder Yaml-Datei verwenden Sie den folgenden Befehl. + +``` +bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] +``` +{: codeblock} + + +### Open API-Definitionen überprüfen +{: #validating} + +Verwenden Sie `bluemix sdk validate [argument]`. + + +#### Argumente +{: #val-args} + +* `APP_NAME` - Der Name der Cloud Foundry-App in Ihrem aktuellen Bereich. +* `OPENAPI_DOC_LOCATION` - Eine URL oder ein relativer Dateipfad zur JSON- oder Yaml-Komponente der unaufbereiteten REST-API-Definition. + + +#### Syntax +{: #val-usage} + +Zum Überprüfen der API-Spezifikation einer Cloud Foundry-App, die unter {{site.data.keyword.Bluemix_notm}} ausgeführt wird, können Sie den Namen der App als Parameter für die CLI verwenden. + +``` +bluemix sdk validate [APP_NAME] +``` +{: codeblock} + +Zum Überprüfen eines SDK auf Basis der URL zu einem Dokument mit API-Spezifikationen oder einer lokalen JSON- oder Yaml-Datei verwenden Sie den folgenden Befehl. + +``` +bluemix sdk validate [OPENAPI_DOC_LOCATION] +``` +{: codeblock} + + + +### Apps (Cloud Foundry) auflisten +{: #list-apps} + +Verwenden Sie `bluemix sdk list [argument][option]`, um Apps aufzulisten und API-Spezifikationen zu überprüfen. In der Umgebungsvariablen `OPENAPI_SPEC` muss der relative URL-Pfad angegeben werden, über den Ihre Spezifikation gehostet wird. + + +#### Argumente +{: #list-args} + +* `SPACE_NAME` (optional) - Der Name des Cloud Foundry-Bereichs in Ihrer aktuellen Organisation, der nach Apps durchsucht werden soll. Wird hier nichts angegeben, dann durchsucht das System den aktuellen Bereich. + + +#### Optionen +{: #list-options} + +* `--url` (optional) - Zeigt eine vollständig formatierte URL zur Open API-Definition jeder App in der Liste an. + + +#### Syntax +{: #list-usage} + +Verwenden Sie den folgenden Befehl, um Apps im aktuellen Bereich aufzulisten. + +``` +bluemix sdk list +``` +{: codeblock} + +Verwenden Sie den folgenden Befehl, um Apps im aktuellen Bereich aufzulisten und die URL zur API-Spezifikation anzuzeigen. + +``` +bluemix sdk list --url +``` +{: codeblock} + +Verwenden Sie den folgenden Befehl, um Apps in einem bestimmten Bereich aufzulisten. + +``` +bluemix sdk list [SPACE_NAME] +``` +{: codeblock} + +Verwenden Sie den folgenden Befehl, um Apps in einem bestimmten Bereich aufzulisten und die URL der API-Spezifikation anzuzeigen. + +``` +bluemix sdk list [SPACE_NAME] --url +``` +{: codeblock} diff --git a/cloudnative/nl/de/sdk_network_request.md b/cloudnative/nl/de/sdk_network_request.md index 11ba73329..79db952fd 100644 --- a/cloudnative/nl/de/sdk_network_request.md +++ b/cloudnative/nl/de/sdk_network_request.md @@ -1,121 +1,121 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Netzanforderung erstellen -{: #sdk-network-request} - -Sie können auch das `BMSCore`-SDK zum Erstellen von Netzanforderungen an beliebige Ressourcen verwenden. - -## Android -{: #request-android} - -1. Stellen Sie sicher, dass Sie in Ihrer Android-Anwendung [das Client-SDK importiert und initialisiert haben](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android). - -2. Erstellen Sie eine Netzanforderung. - - ``` - public void makeGetCall() { - Thread thread = new Thread(new Runnable() { - @Override - public void run() { - try { - Request request = new Request("http://httpbin.org/get", "GET"); - request.send(null, null); - } catch (Exception e) { - // Handle failure here. - } - } - }); - thread.start(); - } - ``` - {: codeblock} - -## iOS -{: #request-ios} - -1. Stellen Sie sicher, dass Sie in Ihrer iOS-Anwendung [das Client-SDK importiert und initialisiert haben](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios). - -2. Erstellen Sie eine Netzanforderung. - - ### Swift 3.0 - {: #ios-swift3 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - - ### Swift 2.2 - {: #ios-swift22 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - -Die Klasse `Request` ist eine einfache Möglichkeit zum Erstellen einer HTTP-Anforderung und zum Erhalten der Antwort nach der Durchführung der Anforderung. Wenn Sie größere Flexibilität und mehr Steuerungsmöglichkeiten wünschen als mit der Klasse `Request`, können Sie die Klasse `BMSURLSession` verwenden. Funktionen der Klasse `BMSURLSession` sind unter anderem das Überwachen des Verarbeitungsfortschritts beim Hochladen und das Anhalten oder Abbrechen von Anforderungen. Um die Antworten zu erhalten, können Sie entweder Completion-Handler oder Delegierte (Delegates) auswählen. - -Die Klasse `BMSURLSession` ist nur für iOS verfügbar. Weitere Informationen zu `BMSURLSession` finden Sie in der `BMSCore`-SDK-[README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core). - - -## Cordova -{: #request-cordova} - -1. Stellen Sie sicher, dass Sie in Ihrer Cordova-Anwendung [das Client-SDK importiert und initialisiert haben](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova). - -2. Erstellen Sie eine Netzanforderung. - - ``` - var success = function(data) { - console.log("success", data); - } - var failure = function(error) - {console.log("failure", error); - } - var request = new BMSRequest("", BMSRequest.GET); - request.send(success, failure); - ``` - {: codeblock} - - -# Zugehörige Links -{: #rellinks notoc} - -## Zugehörige Links -{: #general notoc} - -* [BMSCore-Android-SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore-iOS-SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore-Cordova-Plug-in](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Netzanforderung erstellen +{: #sdk-network-request} + +Sie können auch das `BMSCore`-SDK zum Erstellen von Netzanforderungen an beliebige Ressourcen verwenden. + +## Android +{: #request-android} + +1. Stellen Sie sicher, dass Sie in Ihrer Android-Anwendung [das Client-SDK importiert und initialisiert haben](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android). + +2. Erstellen Sie eine Netzanforderung. + + ``` + public void makeGetCall() { + Thread thread = new Thread(new Runnable() { + @Override + public void run() { + try { + Request request = new Request("http://httpbin.org/get", "GET"); + request.send(null, null); + } catch (Exception e) { + // Handle failure here. + } + } + }); + thread.start(); + } + ``` + {: codeblock} + +## iOS +{: #request-ios} + +1. Stellen Sie sicher, dass Sie in Ihrer iOS-Anwendung [das Client-SDK importiert und initialisiert haben](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios). + +2. Erstellen Sie eine Netzanforderung. + + ### Swift 3.0 + {: #ios-swift3 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + + ### Swift 2.2 + {: #ios-swift22 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + +Die Klasse `Request` ist eine einfache Möglichkeit zum Erstellen einer HTTP-Anforderung und zum Erhalten der Antwort nach der Durchführung der Anforderung. Wenn Sie größere Flexibilität und mehr Steuerungsmöglichkeiten wünschen als mit der Klasse `Request`, können Sie die Klasse `BMSURLSession` verwenden. Funktionen der Klasse `BMSURLSession` sind unter anderem das Überwachen des Verarbeitungsfortschritts beim Hochladen und das Anhalten oder Abbrechen von Anforderungen. Um die Antworten zu erhalten, können Sie entweder Completion-Handler oder Delegierte (Delegates) auswählen. + +Die Klasse `BMSURLSession` ist nur für iOS verfügbar. Weitere Informationen zu `BMSURLSession` finden Sie in der `BMSCore`-SDK-[README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core). + + +## Cordova +{: #request-cordova} + +1. Stellen Sie sicher, dass Sie in Ihrer Cordova-Anwendung [das Client-SDK importiert und initialisiert haben](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova). + +2. Erstellen Sie eine Netzanforderung. + + ``` + var success = function(data) { + console.log("success", data); + } + var failure = function(error) + {console.log("failure", error); + } + var request = new BMSRequest("", BMSRequest.GET); + request.send(success, failure); + ``` + {: codeblock} + + +# Zugehörige Links +{: #rellinks notoc} + +## Zugehörige Links +{: #general notoc} + +* [BMSCore-Android-SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore-iOS-SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore-Cordova-Plug-in](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/de/services.md b/cloudnative/nl/de/services.md index fe5f42b72..7a219559b 100644 --- a/cloudnative/nl/de/services.md +++ b/cloudnative/nl/de/services.md @@ -1,53 +1,53 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# Services -{: #services} - -Über die Seite **Services** der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} können Sie Ihre vorhandenen Web and Mobile-Services anzeigen oder neue Services erstellen. Die Konsole bietet einen einzigen Punkt zum Anzeigen aller {{site.data.keyword.Bluemix_notm}} Web and Mobile-Services, die aktuell von Projekten verwaltet werden. - -Wenn Sie Services aus der Ansicht **Services** löschen, trennen Sie den Service von dem Projekt, dem er zugeordnet ist. Wenn Sie den Service wieder mit dem Projekt verbinden möchten, erstellen Sie eine neue Serviceinstanz. - -## Übersicht über {{site.data.keyword.Bluemix_notm}} Web and Mobile-Services -{: #mobile_services_overview} - -In der folgenden Tabelle werden die {{site.data.keyword.Bluemix_notm}} Web and Mobile-Services dargestellt. Sie können einzelne Services aus dem {{site.data.keyword.Bluemix_notm}}-Katalog nutzen oder diese Services in Ihr Projekt integrieren. - - - - - - - - - - - - - - - - - - - -
Tabelle 1. {{site.data.keyword.Bluemix_notm}} Web and Mobile-Services
{{site.data.keyword.Bluemix_notm}} Web and Mobile-ServiceBeschreibung
Symbol für {{site.data.keyword.mobileanalytics_short}}
{{site.data.keyword.mobileanalytics_short}}		Mithilfe des Service '{{site.data.keyword.mobileanalytics_full}}' erhalten Sie Einblick in die Leistung und die Art der Nutzung Ihrer mobilen Apps.

-Weitere Informationen zum Betrieb dieses Service finden Sie in der {{site.data.keyword.mobileanalytics_short}}-Dokumentation.
{{site.data.keyword.mobilefoundation_short}} - Servicesymbol
{{site.data.keyword.mobilefoundation_short}}		Mithilfe des Service '{{site.data.keyword.mobilefoundation_long}}' können Sie die Einrichtung einer {{site.data.keyword.mfp_full}}-Umgebung für Entwicklung, Test und Betrieb mobiler Unternehmens-Apps beschleunigen.

-Weitere Informationen zum Betrieb dieses Service finden Sie in der {{site.data.keyword.mobilefoundation_short}}-Dokumentation.
{{site.data.keyword.mobilepushshort}} - Servicesymbol
{{site.data.keyword.mobilepushshort}}		Der Service '{{site.data.keyword.mobilepushfull}}' bietet eine einheitliche Plattform zum Senden und Verwalten von mobilen Benachrichtigungen und Web-Push-Benachrichtigungen, die verschiedene Plattformen als Ziel haben. -

-{{site.data.keyword.mobilepushshort}} verwaltet die Zuordnung Ihrer Anwendungsbenutzer zu den zugehörigen Geräten, zur Geräteplattform sowie zu den Web-Browsern und führt das Senden von Push-Benachrichtigungen an die Geräte aus. Sie können Rundsendungen, Unicasts (auf der Basis von Geräte-ID und Benutzer-ID) sowie Tags (oder Themen) als Push-Benachrichtigungen an die Benutzer Ihrer mobilen Anwendungen und Web-Browser-Anwendungen senden. Außerdem können Sie ein SDK und REST-APIs verwenden, um Ihre Clientanwendungen weiter zu entwickeln. -

-Weitere Informationen zum Betrieb dieses Service finden Sie in der {{site.data.keyword.mobilepushshort}}-Dokumentation.
+--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# Services +{: #services} + +Über die Seite **Services** der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} können Sie Ihre vorhandenen Web and Mobile-Services anzeigen oder neue Services erstellen. Die Konsole bietet einen einzigen Punkt zum Anzeigen aller {{site.data.keyword.Bluemix_notm}} Web and Mobile-Services, die aktuell von Projekten verwaltet werden. + +Wenn Sie Services aus der Ansicht **Services** löschen, trennen Sie den Service von dem Projekt, dem er zugeordnet ist. Wenn Sie den Service wieder mit dem Projekt verbinden möchten, erstellen Sie eine neue Serviceinstanz. + +## Übersicht über {{site.data.keyword.Bluemix_notm}} Web and Mobile-Services +{: #mobile_services_overview} + +In der folgenden Tabelle werden die {{site.data.keyword.Bluemix_notm}} Web and Mobile-Services dargestellt. Sie können einzelne Services aus dem {{site.data.keyword.Bluemix_notm}}-Katalog nutzen oder diese Services in Ihr Projekt integrieren. + + + + + + + + + + + + + + + + + + + +
Tabelle 1. {{site.data.keyword.Bluemix_notm}} Web and Mobile-Services
{{site.data.keyword.Bluemix_notm}} Web and Mobile-ServiceBeschreibung
Symbol für {{site.data.keyword.mobileanalytics_short}}
{{site.data.keyword.mobileanalytics_short}}		Mithilfe des Service '{{site.data.keyword.mobileanalytics_full}}' erhalten Sie Einblick in die Leistung und die Art der Nutzung Ihrer mobilen Apps.

+Weitere Informationen zum Betrieb dieses Service finden Sie in der {{site.data.keyword.mobileanalytics_short}}-Dokumentation.
{{site.data.keyword.mobilefoundation_short}} - Servicesymbol
{{site.data.keyword.mobilefoundation_short}}		Mithilfe des Service '{{site.data.keyword.mobilefoundation_long}}' können Sie die Einrichtung einer {{site.data.keyword.mfp_full}}-Umgebung für Entwicklung, Test und Betrieb mobiler Unternehmens-Apps beschleunigen.

+Weitere Informationen zum Betrieb dieses Service finden Sie in der {{site.data.keyword.mobilefoundation_short}}-Dokumentation.
{{site.data.keyword.mobilepushshort}} - Servicesymbol
{{site.data.keyword.mobilepushshort}}		Der Service '{{site.data.keyword.mobilepushfull}}' bietet eine einheitliche Plattform zum Senden und Verwalten von mobilen Benachrichtigungen und Web-Push-Benachrichtigungen, die verschiedene Plattformen als Ziel haben. +

+{{site.data.keyword.mobilepushshort}} verwaltet die Zuordnung Ihrer Anwendungsbenutzer zu den zugehörigen Geräten, zur Geräteplattform sowie zu den Web-Browsern und führt das Senden von Push-Benachrichtigungen an die Geräte aus. Sie können Rundsendungen, Unicasts (auf der Basis von Geräte-ID und Benutzer-ID) sowie Tags (oder Themen) als Push-Benachrichtigungen an die Benutzer Ihrer mobilen Anwendungen und Web-Browser-Anwendungen senden. Außerdem können Sie ein SDK und REST-APIs verwenden, um Ihre Clientanwendungen weiter zu entwickeln. +

+Weitere Informationen zum Betrieb dieses Service finden Sie in der {{site.data.keyword.mobilepushshort}}-Dokumentation.
diff --git a/cloudnative/nl/de/starters.md b/cloudnative/nl/de/starters.md index 937488c1c..a43bf952f 100644 --- a/cloudnative/nl/de/starters.md +++ b/cloudnative/nl/de/starters.md @@ -1,26 +1,26 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Starter -{: #starters} - -In der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} können Sie für jeden Mustertyp einen Starter aus einer Vielzahl an Startern auswählen. - -Starter werden als produktionsbereiter Startercode mit Fokus auf der Veranschaulichung einer wichtigen {{site.data.keyword.Bluemix_notm}}-Integration mit einem hochwertigen Service optimiert. Jeder Starter konzentriert sich auf einen Service und zeigt die Integration der Service-SDKs in den Code. In einigen Fällen bieten Starter eine einfache Benutzerumgebung, in der die Integration der Servicedaten oder Interaktionen mit dem Benutzer besser sichtbar wird. Jeder Starter ist für die Aktivierung mit der Authentication-Funktion, Data-Funktion und möglicherweise weiteren Leistungsmerkmalen konfiguriert, falls Sie beschließen, diese für Ihr Projekt zu konfigurieren. - - -## Lernprogramme -{: #tutorials notoc} - -Detailliertere Anweisungen zur Erstellung von Apps mit Startern finden Sie in den umfassenden [Lernprogrammen](tutorials.html). +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Starter +{: #starters} + +In der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} können Sie für jeden Mustertyp einen Starter aus einer Vielzahl an Startern auswählen. + +Starter werden als produktionsbereiter Startercode mit Fokus auf der Veranschaulichung einer wichtigen {{site.data.keyword.Bluemix_notm}}-Integration mit einem hochwertigen Service optimiert. Jeder Starter konzentriert sich auf einen Service und zeigt die Integration der Service-SDKs in den Code. In einigen Fällen bieten Starter eine einfache Benutzerumgebung, in der die Integration der Servicedaten oder Interaktionen mit dem Benutzer besser sichtbar wird. Jeder Starter ist für die Aktivierung mit der Authentication-Funktion, Data-Funktion und möglicherweise weiteren Leistungsmerkmalen konfiguriert, falls Sie beschließen, diese für Ihr Projekt zu konfigurieren. + + +## Lernprogramme +{: #tutorials notoc} + +Detailliertere Anweisungen zur Erstellung von Apps mit Startern finden Sie in den umfassenden [Lernprogrammen](tutorials.html). diff --git a/cloudnative/nl/de/troubleshoot.md b/cloudnative/nl/de/troubleshoot.md index 5a76d2a6b..2bf4c4c83 100644 --- a/cloudnative/nl/de/troubleshoot.md +++ b/cloudnative/nl/de/troubleshoot.md @@ -1,223 +1,223 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Fehlerbehebung -{: #ts} - -Manche bekannte Probleme mit dem {{site.data.keyword.dev_cli_notm}} sind zusammen mit den entsprechenden Problemumgehungen dokumentiert. -{:shortdesc} - - - -## Bekannte Probleme -{: #knownissues} - -In den folgenden Abschnitten werden bekannte Probleme und mögliche Lösungen beschrieben. - - -### Fehler im Hostnamen beim Erstellen eines Projekts mit nicht mobilem Muster -{: #hostname} - -Es wird der folgende Fehler angezeigt, wenn Sie mit dem {{site.data.keyword.dev_cli_short}} unter Verwendung von Web-App-, BFF- oder Microservice-Mustern ein Projekt erstellen: - -``` -The hostname is taken. -``` -{: codeblock} - - -#### Ursache -{: #hostname-cause} - -Dieser Fehler tritt aufgrund einer abgelaufenen Anmeldung auf. - - -#### Lösung -{: #hostname-resolution} - -Erneute Anmeldung. - -``` -bx login -``` -{: codeblock} - - -### Allgemeine Fehler mit dem {{site.data.keyword.dev_cli_short}} -{: #general} - -Es wird eventuell der folgende Fehler angezeigt, wenn Sie mit dem {{site.data.keyword.dev_cli_short}} Befehle erstellen, löschen, auflisten oder codieren: - -``` -Failed to project. -``` -{: codeblock} - - -#### Ursache -{: #hostname-cause} - -Dieser Fehler tritt aufgrund einer abgelaufenen Anmeldung auf. - - -#### Lösung -{: #hostname-resolution} - -Erneute Anmeldung. - -``` -bx login -``` -{: codeblock} - - -### Service-Broker-Fehler während Hinzufügen einer {{site.data.keyword.objectstorageshort}}-Funktion -{: #os} - -Es wird eventuell der folgende Fehler angezeigt, wenn Sie das {{site.data.keyword.dev_cli_short}} zum Erstellen von zwei Projekten mit der {{site.data.keyword.objectstorageshort}}-Funktion verwenden. - -``` -FAILED -Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} -``` -{: codeblock} - - -#### Ursache -{: #os-cause} - -Dieser Fehler tritt auf, weil der Service {{site.data.keyword.objectstorageshort}} nur eine Instanz des kostenlosen {{site.data.keyword.objectstorageshort}}-Plans zulässt. - - -#### Lösung -{: #os-resolution} - -Sie werden aufgefordert, einen anderen Plan zum Vermeiden dieses Fehlers auszuwählen. - - -### Fehler beim Abrufen des Code während der Projekterstellung -{: #code} - -Es wird eventuell der folgende Fehler angezeigt, wenn Sie das {{site.data.keyword.dev_cli_short}} zum Erstellen eines Projekts verwenden: - -``` -FAILED -Project created, but could not get code -https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code -``` -{: codeblock} - - -#### Ursache -{: #code-cause} - -Dieser Fehler tritt aufgrund einer internen Zeitlimitüberschreitung auf. - - -#### Lösung -{: #code-resolution} - -Sie können den Code auf eine der folgenden Arten abrufen: - -* Führen Sie den folgenden Befehl in der Befehlszeilenschnittstelle aus: - - ``` - bx dev code - ``` - {: codeblock} - - `` muss durch den Projektnamen ersetzt werden, den Sie während der Projekterstellung verwendet haben. - -* Verwenden Sie die {{site.data.keyword.dev_console}}. - - 1. Verwenden Sie Ihr [Projekt ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://console.{DomainName}/developer/projects) in der {{site.data.keyword.dev_console}} und klicken Sie auf **Code abrufen**. - - 2. Klicken Sie auf **Code generieren**. - - 3. Klicken Sie nach der Generierung des Codes auf **Code herunterladen**. - - -### Fehler beim Ausführen von `bx dev run` für Node.js-Projekte -{: #node} - -Es wird eventuell der folgende Fehler angezeigt, wenn Sie `bx dev run` mit dem {{site.data.keyword.dev_cli_short}} für Node.js-Web- oder BFF-Projekte ausführen: - -``` -module.js:597 - return process.dlopen(module, path._makeLong(filename)); - ^ - -Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header - at Error (native) - at Object.Module._extensions..node (module.js:597:18) - at Module.load (module.js:487:32) - at tryModuleLoad (module.js:446:12) - - at Function.Module._load (module.js:438:3) - at Module.require (module.js:497:17) - at require (internal/module.js:20:19) - at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) - at Module._compile (module.js:570:32) - at Object.Module._extensions..js (module.js:579:10) -``` -{: codeblock} - - -#### Ursache -{: #node-cause} - -Dieser Fehler tritt auf, weil das Modul `appmetrics` in einer anderen Architektur installiert ist. Native NPM-Module, die in einer Architektur installiert sind, funktionieren nicht in einer anderen. Die im Lieferumfang enthaltenen Docker-Images basieren auf einem Linux-Kernel. - - -#### Lösung -{: #node-resolution} - -Löschen Sie den Ordner `node_modules` und führen Sie den Befehl `bx dev run` erneut aus. - - - - - - - -## Hilfe und Unterstützung abrufen -{: #gettinghelp} - -Falls Sie Probleme oder Fragen haben, wenn Sie die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} oder das {{site.data.keyword.dev_cli_notm}} verwenden, können Sie Hilfe abrufen, indem Sie in einem Forum nach Informationen suchen oder Fragen stellen. Sie können auch ein Support-Ticket öffnen. - -Wenn Sie in einem Forum eine Frage stellen, versehen Sie diese Frage mit einem Tag, damit Sie von den {{site.data.keyword.Bluemix_notm}}-Entwicklerteam angezeigt werden kann. - - - -Wenn Sie technische Fragen zum Entwickeln oder Bereitstellen einer App mit der {{site.data.keyword.dev_console}} oder dem {{site.data.keyword.dev_cli_notm}} haben: - -* Senden Sie Ihre Frage an [Stacküberlauf ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) und markieren Sie Ihre Frage mit `bluemix-dev-services` und `ibm-bluemix`. -* Senden Sie Ihre Frage an [Slack ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://ibm-cloud-tech.slack.com/) im `bluemix-dev-services`-Kanal. [Melden Sie sich heute an ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://ibm.biz/IBMCloudNativeSlack) an. - - - - - -Weitere Information zur Nutzung der Foren finden Sie unter [Hilfe abrufen ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/support/index.html#getting-help). - -Informationen zum Öffnen eines {{site.data.keyword.IBM}} Support-Tickets oder zu den Support-Leveln und der Dringlichkeit von Tickets finden Sie unter [Unterstützung anfordern ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/support/index.html#contacting-support). - - - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Fehlerbehebung +{: #ts} + +Manche bekannte Probleme mit dem {{site.data.keyword.dev_cli_notm}} sind zusammen mit den entsprechenden Problemumgehungen dokumentiert. +{:shortdesc} + + + +## Bekannte Probleme +{: #knownissues} + +In den folgenden Abschnitten werden bekannte Probleme und mögliche Lösungen beschrieben. + + +### Fehler im Hostnamen beim Erstellen eines Projekts mit nicht mobilem Muster +{: #hostname} + +Es wird der folgende Fehler angezeigt, wenn Sie mit dem {{site.data.keyword.dev_cli_short}} unter Verwendung von Web-App-, BFF- oder Microservice-Mustern ein Projekt erstellen: + +``` +The hostname is taken. +``` +{: codeblock} + + +#### Ursache +{: #hostname-cause} + +Dieser Fehler tritt aufgrund einer abgelaufenen Anmeldung auf. + + +#### Lösung +{: #hostname-resolution} + +Erneute Anmeldung. + +``` +bx login +``` +{: codeblock} + + +### Allgemeine Fehler mit dem {{site.data.keyword.dev_cli_short}} +{: #general} + +Es wird eventuell der folgende Fehler angezeigt, wenn Sie mit dem {{site.data.keyword.dev_cli_short}} Befehle erstellen, löschen, auflisten oder codieren: + +``` +Failed to project. +``` +{: codeblock} + + +#### Ursache +{: #hostname-cause} + +Dieser Fehler tritt aufgrund einer abgelaufenen Anmeldung auf. + + +#### Lösung +{: #hostname-resolution} + +Erneute Anmeldung. + +``` +bx login +``` +{: codeblock} + + +### Service-Broker-Fehler während Hinzufügen einer {{site.data.keyword.objectstorageshort}}-Funktion +{: #os} + +Es wird eventuell der folgende Fehler angezeigt, wenn Sie das {{site.data.keyword.dev_cli_short}} zum Erstellen von zwei Projekten mit der {{site.data.keyword.objectstorageshort}}-Funktion verwenden. + +``` +FAILED +Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} +``` +{: codeblock} + + +#### Ursache +{: #os-cause} + +Dieser Fehler tritt auf, weil der Service {{site.data.keyword.objectstorageshort}} nur eine Instanz des kostenlosen {{site.data.keyword.objectstorageshort}}-Plans zulässt. + + +#### Lösung +{: #os-resolution} + +Sie werden aufgefordert, einen anderen Plan zum Vermeiden dieses Fehlers auszuwählen. + + +### Fehler beim Abrufen des Code während der Projekterstellung +{: #code} + +Es wird eventuell der folgende Fehler angezeigt, wenn Sie das {{site.data.keyword.dev_cli_short}} zum Erstellen eines Projekts verwenden: + +``` +FAILED +Project created, but could not get code +https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code +``` +{: codeblock} + + +#### Ursache +{: #code-cause} + +Dieser Fehler tritt aufgrund einer internen Zeitlimitüberschreitung auf. + + +#### Lösung +{: #code-resolution} + +Sie können den Code auf eine der folgenden Arten abrufen: + +* Führen Sie den folgenden Befehl in der Befehlszeilenschnittstelle aus: + + ``` + bx dev code + ``` + {: codeblock} + + `` muss durch den Projektnamen ersetzt werden, den Sie während der Projekterstellung verwendet haben. + +* Verwenden Sie die {{site.data.keyword.dev_console}}. + + 1. Verwenden Sie Ihr [Projekt ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://console.{DomainName}/developer/projects) in der {{site.data.keyword.dev_console}} und klicken Sie auf **Code abrufen**. + + 2. Klicken Sie auf **Code generieren**. + + 3. Klicken Sie nach der Generierung des Codes auf **Code herunterladen**. + + +### Fehler beim Ausführen von `bx dev run` für Node.js-Projekte +{: #node} + +Es wird eventuell der folgende Fehler angezeigt, wenn Sie `bx dev run` mit dem {{site.data.keyword.dev_cli_short}} für Node.js-Web- oder BFF-Projekte ausführen: + +``` +module.js:597 + return process.dlopen(module, path._makeLong(filename)); + ^ + +Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header + at Error (native) + at Object.Module._extensions..node (module.js:597:18) + at Module.load (module.js:487:32) + at tryModuleLoad (module.js:446:12) + + at Function.Module._load (module.js:438:3) + at Module.require (module.js:497:17) + at require (internal/module.js:20:19) + at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) + at Module._compile (module.js:570:32) + at Object.Module._extensions..js (module.js:579:10) +``` +{: codeblock} + + +#### Ursache +{: #node-cause} + +Dieser Fehler tritt auf, weil das Modul `appmetrics` in einer anderen Architektur installiert ist. Native NPM-Module, die in einer Architektur installiert sind, funktionieren nicht in einer anderen. Die im Lieferumfang enthaltenen Docker-Images basieren auf einem Linux-Kernel. + + +#### Lösung +{: #node-resolution} + +Löschen Sie den Ordner `node_modules` und führen Sie den Befehl `bx dev run` erneut aus. + + + + + + + +## Hilfe und Unterstützung abrufen +{: #gettinghelp} + +Falls Sie Probleme oder Fragen haben, wenn Sie die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} oder das {{site.data.keyword.dev_cli_notm}} verwenden, können Sie Hilfe abrufen, indem Sie in einem Forum nach Informationen suchen oder Fragen stellen. Sie können auch ein Support-Ticket öffnen. + +Wenn Sie in einem Forum eine Frage stellen, versehen Sie diese Frage mit einem Tag, damit Sie von den {{site.data.keyword.Bluemix_notm}}-Entwicklerteam angezeigt werden kann. + + + +Wenn Sie technische Fragen zum Entwickeln oder Bereitstellen einer App mit der {{site.data.keyword.dev_console}} oder dem {{site.data.keyword.dev_cli_notm}} haben: + +* Senden Sie Ihre Frage an [Stacküberlauf ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) und markieren Sie Ihre Frage mit `bluemix-dev-services` und `ibm-bluemix`. +* Senden Sie Ihre Frage an [Slack ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://ibm-cloud-tech.slack.com/) im `bluemix-dev-services`-Kanal. [Melden Sie sich heute an ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](http://ibm.biz/IBMCloudNativeSlack) an. + + + + + +Weitere Information zur Nutzung der Foren finden Sie unter [Hilfe abrufen ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/support/index.html#getting-help). + +Informationen zum Öffnen eines {{site.data.keyword.IBM}} Support-Tickets oder zu den Support-Leveln und der Dringlichkeit von Tickets finden Sie unter [Unterstützung anfordern ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/support/index.html#contacting-support). + + + diff --git a/cloudnative/nl/de/tutorial_bff.md b/cloudnative/nl/de/tutorial_bff.md index 88a131e0b..6160e759c 100644 --- a/cloudnative/nl/de/tutorial_bff.md +++ b/cloudnative/nl/de/tutorial_bff.md @@ -1,147 +1,147 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Umfassendes Lernprogramm zum BFF-Basis-Starter (BFF Basic Starter) -{: #tutorial} - -Das folgende umfassende Lernprogramm führt Sie durch die Schritte zur Erstellung eines Projekts aus dem BFF-Basis-Starter, inklusive der Tools, die Sie installiert haben müssen, sowie durch die Schritte zum Ausführen des Projektcodes. - -## Entwicklertools installieren -{: #dev_tools} - -Stellen Sie sicher, dass die [vorausgesetzten Entwicklertools ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](get_code.html#prereq-dev-tools){: new_window} installiert sind. - - -## Projekt mit der {{site.data.keyword.dev_console}} erstellen -{: #create-devex} - -1. Erstellen Sie ein Projekt in der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Klicken Sie auf der Seite **Einführung** in der {{site.data.keyword.dev_console}} auf **Projekt erstellen**. - - Alternativ können Sie auf der Seite **Projekte** auf **Projekt erstellen** klicken. - - 2. Wählen Sie **Backend for Frontend** aus und klicken Sie auf **Weiter**. - - 3. Wählen Sie die Auswahlmöglichkeit für ein Basis-Backend**** aus und klicken Sie auf **Weiter**. - - 4. Geben Sie Ihren Projektnamen ein. Verwenden Sie für dieses Lernprogramm `BFFProject`. - - 5. Geben Sie einen Hostnamen ein. Verwenden Sie für dieses Lernprogramm `devhost`. - - 6. Wählen Sie Ihre Sprachplattform aus. Verwenden Sie für dieses Lernprogramm `Node`. - - 7. Klicken Sie auf **Erstellen**. - -2. Optional: Fügen Sie die Data-Funktion hinzu. - - 1. Klicken Sie auf der Seite **Projektübersicht** für **Data** auf **Anzeigen**. - - Alternativ können Sie **Erstellen** oder **Vorhandenen hinzufügen** auf der Seite **Funktionen > Data** aus. - - 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. - - -3. Generieren Sie den Projektcode. - - 1. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. - - Alternativ können Sie auf die Seite **Code** klicken. - - 2. Klicken Sie auf **Code generieren**. - - 3. Wenn die Projektcodegenerierung fertig ist, klicken Sie auf **Code herunterladen**, um Ihr Projektarchiv herunterzuladen. - -4. Optional: [Aktualisieren Sie das Projekt](project_overview_page.html#update_language), um eine neue Sprache zu generieren. - - -## Projekt mit dem {{site.data.keyword.dev_cli_notm}} erstellen -{: #create-cli} - -1. Stellen Sie sicher, dass das [{{site.data.keyword.dev_cli_short}}](dev_cli.html) installiert ist. - -2. Navigieren Sie in der Eingabeaufforderung des Terminals zu einem lokalen Verzeichnis Ihrer Wahl und führen Sie den folgenden Befehl aus. - - ``` - bx dev create - ``` - {: codeblock} - -3. Geben Sie bei Aufforderung die folgenden Werte an: - - * Wählen Sie ein Muster aus: 3 (für Backend for Frontend) - * Wählen Sie einen Starter aus: 1 (für Basis-Backend) - * Wählen Sie eine Sprache aus: 1 (für Node) - * Geben Sie einen Namen für Ihr Projekt ein: `BFFProjectCLI` - * Geben Sie einen Hostnamen für Ihr Projekt ein: `myhost` - -4. Wenn Sie Services zu Ihrem Projekt hinzufügen möchten, geben Sie `y` ein, wenn Sie in der Eingabeaufforderung danach gefragt werden, und beantworten Sie die restlichen Fragen. - -5. Navigieren Sie nach dem erfolgreichen Speichern des Projekts `BFFProjectCLI` zum Ordner `BFFProjectCLI`. - -6. Zu diesem Zeitpunkt können Sie eigenen Code zum Projekt hinzufügen oder das Projekt erstellen bzw. ausführen. - - 1. Erstellen Sie das Projekt mit dem folgenden Befehl: - - ``` - bx dev build - ``` - {: codeblock} - - 2. Führen Sie das Projekt mit dem folgenden Befehl aus: - - ``` - bx dev run - ``` - {: codeblock} - - -## Ein BFF-Projekt ausführen -{: #running-bff} - -### Lokal -{: #bff-local} - -1. Kompilieren Sie den Server: - - ``` - swift build - ``` - {: codeblock} - -2. Führen Sie die Anwendung aus. Beispiel: Die Anwendung weist den Namen `MyServer` auf: - - ``` - .build/debug/MyServer - ``` - {: codeblock} - -3. Sie können curl auf dem Server mit `curl http://localhost:8080` ausführen. - - -### Bluemix Plug-in verwenden -{: #using-blumix} - -1. Führen Sie die Kompilierung aus. - - ``` - bx dev run - ``` - {: codeblock} - -2. Sie können curl auf dem Server mit dem folgenden Befehl ausführen: - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Umfassendes Lernprogramm zum BFF-Basis-Starter (BFF Basic Starter) +{: #tutorial} + +Das folgende umfassende Lernprogramm führt Sie durch die Schritte zur Erstellung eines Projekts aus dem BFF-Basis-Starter, inklusive der Tools, die Sie installiert haben müssen, sowie durch die Schritte zum Ausführen des Projektcodes. + +## Entwicklertools installieren +{: #dev_tools} + +Stellen Sie sicher, dass die [vorausgesetzten Entwicklertools ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](get_code.html#prereq-dev-tools){: new_window} installiert sind. + + +## Projekt mit der {{site.data.keyword.dev_console}} erstellen +{: #create-devex} + +1. Erstellen Sie ein Projekt in der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Klicken Sie auf der Seite **Einführung** in der {{site.data.keyword.dev_console}} auf **Projekt erstellen**. + + Alternativ können Sie auf der Seite **Projekte** auf **Projekt erstellen** klicken. + + 2. Wählen Sie **Backend for Frontend** aus und klicken Sie auf **Weiter**. + + 3. Wählen Sie die Auswahlmöglichkeit für ein Basis-Backend**** aus und klicken Sie auf **Weiter**. + + 4. Geben Sie Ihren Projektnamen ein. Verwenden Sie für dieses Lernprogramm `BFFProject`. + + 5. Geben Sie einen Hostnamen ein. Verwenden Sie für dieses Lernprogramm `devhost`. + + 6. Wählen Sie Ihre Sprachplattform aus. Verwenden Sie für dieses Lernprogramm `Node`. + + 7. Klicken Sie auf **Erstellen**. + +2. Optional: Fügen Sie die Data-Funktion hinzu. + + 1. Klicken Sie auf der Seite **Projektübersicht** für **Data** auf **Anzeigen**. + + Alternativ können Sie **Erstellen** oder **Vorhandenen hinzufügen** auf der Seite **Funktionen > Data** aus. + + 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. + + +3. Generieren Sie den Projektcode. + + 1. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. + + Alternativ können Sie auf die Seite **Code** klicken. + + 2. Klicken Sie auf **Code generieren**. + + 3. Wenn die Projektcodegenerierung fertig ist, klicken Sie auf **Code herunterladen**, um Ihr Projektarchiv herunterzuladen. + +4. Optional: [Aktualisieren Sie das Projekt](project_overview_page.html#update_language), um eine neue Sprache zu generieren. + + +## Projekt mit dem {{site.data.keyword.dev_cli_notm}} erstellen +{: #create-cli} + +1. Stellen Sie sicher, dass das [{{site.data.keyword.dev_cli_short}}](dev_cli.html) installiert ist. + +2. Navigieren Sie in der Eingabeaufforderung des Terminals zu einem lokalen Verzeichnis Ihrer Wahl und führen Sie den folgenden Befehl aus. + + ``` + bx dev create + ``` + {: codeblock} + +3. Geben Sie bei Aufforderung die folgenden Werte an: + + * Wählen Sie ein Muster aus: 3 (für Backend for Frontend) + * Wählen Sie einen Starter aus: 1 (für Basis-Backend) + * Wählen Sie eine Sprache aus: 1 (für Node) + * Geben Sie einen Namen für Ihr Projekt ein: `BFFProjectCLI` + * Geben Sie einen Hostnamen für Ihr Projekt ein: `myhost` + +4. Wenn Sie Services zu Ihrem Projekt hinzufügen möchten, geben Sie `y` ein, wenn Sie in der Eingabeaufforderung danach gefragt werden, und beantworten Sie die restlichen Fragen. + +5. Navigieren Sie nach dem erfolgreichen Speichern des Projekts `BFFProjectCLI` zum Ordner `BFFProjectCLI`. + +6. Zu diesem Zeitpunkt können Sie eigenen Code zum Projekt hinzufügen oder das Projekt erstellen bzw. ausführen. + + 1. Erstellen Sie das Projekt mit dem folgenden Befehl: + + ``` + bx dev build + ``` + {: codeblock} + + 2. Führen Sie das Projekt mit dem folgenden Befehl aus: + + ``` + bx dev run + ``` + {: codeblock} + + +## Ein BFF-Projekt ausführen +{: #running-bff} + +### Lokal +{: #bff-local} + +1. Kompilieren Sie den Server: + + ``` + swift build + ``` + {: codeblock} + +2. Führen Sie die Anwendung aus. Beispiel: Die Anwendung weist den Namen `MyServer` auf: + + ``` + .build/debug/MyServer + ``` + {: codeblock} + +3. Sie können curl auf dem Server mit `curl http://localhost:8080` ausführen. + + +### Bluemix Plug-in verwenden +{: #using-blumix} + +1. Führen Sie die Kompilierung aus. + + ``` + bx dev run + ``` + {: codeblock} + +2. Sie können curl auf dem Server mit dem folgenden Befehl ausführen: + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/de/tutorial_microservice.md b/cloudnative/nl/de/tutorial_microservice.md index 3273dca79..bd541e7df 100644 --- a/cloudnative/nl/de/tutorial_microservice.md +++ b/cloudnative/nl/de/tutorial_microservice.md @@ -1,113 +1,113 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Umfassendes Lernprogramm zum Microservice-Basis-Starter (Microservice Basic Starter) -{: #tutorial} - -Das folgende umfassende Lernprogramm führt Sie durch die Schritte zur Erstellung eines Projekts aus dem Microservice-Basis-Starter, inklusive der Tools, die Sie installiert haben müssen, sowie durch die Schritte zum Ausführen des Projektcodes. - -## Entwicklertools installieren -{: #dev_tools} - -Stellen Sie sicher, dass die [vorausgesetzten Entwicklertools ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](get_code.html#prereq-dev-tools){: new_window} installiert sind. - - -## Projekt mit der {{site.data.keyword.dev_console}} erstellen -{: #create-devex} - -1. Erstellen Sie ein Projekt in der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Klicken Sie auf der Seite **Einführung** in der {{site.data.keyword.dev_console}} auf **Projekt erstellen**. - - Alternativ können Sie auf der Seite **Projekte** auf **Projekt erstellen** klicken. - - 2. Wählen Sie **Microservice** aus und klicken Sie auf **Weiter**. - - 3. Wählen Sie **Basis** aus und klicken Sie auf **Weiter**. - - 4. Geben Sie Ihren Projektnamen ein. Verwenden Sie für dieses Lernprogramm `MicroserviceProject`. - - 5. Geben Sie einen Hostnamen ein. Verwenden Sie für dieses Lernprogramm `devhost`. - - 6. Klicken Sie auf **Erstellen**. - -2. Optional: Fügen Sie die Data-Funktion hinzu. - - 1. Klicken Sie auf der Seite **Projektübersicht** für **Data** auf **Anzeigen**. - - Alternativ können Sie **Erstellen** oder **Vorhandenen hinzufügen** auf der Seite **Funktionen > Data** aus. - - 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. - -3. Generieren Sie den Projektcode. - - 1. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. - - Alternativ können Sie auf die Seite **Code** klicken. - - 2. Klicken Sie auf **Code generieren**. - - 3. Wenn die Projektcodegenerierung fertig ist, klicken Sie auf **Code herunterladen**, um Ihr Projektarchiv herunterzuladen. - -4. Optional: [Aktualisieren Sie das Projekt](project_overview_page.html#update_language), um eine neue Sprache zu generieren. - - -## Projekt mit dem {{site.data.keyword.dev_cli_notm}} erstellen -{: #create-cli} - -1. Stellen Sie sicher, dass das [{{site.data.keyword.dev_cli_short}}](dev_cli.html) installiert ist. - -2. Navigieren Sie in der Eingabeaufforderung des Terminals zu einem lokalen Verzeichnis Ihrer Wahl und führen Sie den folgenden Befehl aus. - - ``` - bx dev create - ``` - {: codeblock} - -3. Geben Sie bei Aufforderung die folgenden Werte an: - - * Wählen Sie ein Muster aus: 4 (für Microservices) - * Wählen Sie einen Starter aus: 1 (für Basis) - * Wählen Sie eine Plattform aus: 3 (für Java) - * Geben Sie einen Namen für Ihr Projekt ein: `MicroserviceProjectCLI` - -4. Wenn Sie Services zu Ihrem Projekt hinzufügen möchten, geben Sie `y` ein, wenn Sie in der Eingabeaufforderung danach gefragt werden, und beantworten Sie die restlichen Fragen. - -5. Navigieren Sie nach dem erfolgreichen Speichern des Projekts `MicroserviceProjectCLI` zum Ordner `MicroserviceProjectCLI`. - -6. Zu diesem Zeitpunkt können Sie eigenen Code zum Projekt hinzufügen oder das Projekt erstellen bzw. ausführen. - - -## Projekt mit dem {{site.data.keyword.dev_cli_notm}} ausführen -{: #running-dev-plugin} - -1. Geben Sie zum Erstellen des Projekts im aktuellen Projektverzeichnis den folgenden Befehl ein: - - ``` - bx dev build - ``` - {: codeblock} - -2. Geben Sie zum Erstellen und Ausführen des Projekts im aktuellen Projektverzeichnis den folgenden Befehl ein: - - ``` - bx dev run - ``` - {: codeblock} - -3. Sie können mithilfe von curl auf die Anwendung auf dem Server zugreifen: - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Umfassendes Lernprogramm zum Microservice-Basis-Starter (Microservice Basic Starter) +{: #tutorial} + +Das folgende umfassende Lernprogramm führt Sie durch die Schritte zur Erstellung eines Projekts aus dem Microservice-Basis-Starter, inklusive der Tools, die Sie installiert haben müssen, sowie durch die Schritte zum Ausführen des Projektcodes. + +## Entwicklertools installieren +{: #dev_tools} + +Stellen Sie sicher, dass die [vorausgesetzten Entwicklertools ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](get_code.html#prereq-dev-tools){: new_window} installiert sind. + + +## Projekt mit der {{site.data.keyword.dev_console}} erstellen +{: #create-devex} + +1. Erstellen Sie ein Projekt in der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Klicken Sie auf der Seite **Einführung** in der {{site.data.keyword.dev_console}} auf **Projekt erstellen**. + + Alternativ können Sie auf der Seite **Projekte** auf **Projekt erstellen** klicken. + + 2. Wählen Sie **Microservice** aus und klicken Sie auf **Weiter**. + + 3. Wählen Sie **Basis** aus und klicken Sie auf **Weiter**. + + 4. Geben Sie Ihren Projektnamen ein. Verwenden Sie für dieses Lernprogramm `MicroserviceProject`. + + 5. Geben Sie einen Hostnamen ein. Verwenden Sie für dieses Lernprogramm `devhost`. + + 6. Klicken Sie auf **Erstellen**. + +2. Optional: Fügen Sie die Data-Funktion hinzu. + + 1. Klicken Sie auf der Seite **Projektübersicht** für **Data** auf **Anzeigen**. + + Alternativ können Sie **Erstellen** oder **Vorhandenen hinzufügen** auf der Seite **Funktionen > Data** aus. + + 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. + +3. Generieren Sie den Projektcode. + + 1. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. + + Alternativ können Sie auf die Seite **Code** klicken. + + 2. Klicken Sie auf **Code generieren**. + + 3. Wenn die Projektcodegenerierung fertig ist, klicken Sie auf **Code herunterladen**, um Ihr Projektarchiv herunterzuladen. + +4. Optional: [Aktualisieren Sie das Projekt](project_overview_page.html#update_language), um eine neue Sprache zu generieren. + + +## Projekt mit dem {{site.data.keyword.dev_cli_notm}} erstellen +{: #create-cli} + +1. Stellen Sie sicher, dass das [{{site.data.keyword.dev_cli_short}}](dev_cli.html) installiert ist. + +2. Navigieren Sie in der Eingabeaufforderung des Terminals zu einem lokalen Verzeichnis Ihrer Wahl und führen Sie den folgenden Befehl aus. + + ``` + bx dev create + ``` + {: codeblock} + +3. Geben Sie bei Aufforderung die folgenden Werte an: + + * Wählen Sie ein Muster aus: 4 (für Microservices) + * Wählen Sie einen Starter aus: 1 (für Basis) + * Wählen Sie eine Plattform aus: 3 (für Java) + * Geben Sie einen Namen für Ihr Projekt ein: `MicroserviceProjectCLI` + +4. Wenn Sie Services zu Ihrem Projekt hinzufügen möchten, geben Sie `y` ein, wenn Sie in der Eingabeaufforderung danach gefragt werden, und beantworten Sie die restlichen Fragen. + +5. Navigieren Sie nach dem erfolgreichen Speichern des Projekts `MicroserviceProjectCLI` zum Ordner `MicroserviceProjectCLI`. + +6. Zu diesem Zeitpunkt können Sie eigenen Code zum Projekt hinzufügen oder das Projekt erstellen bzw. ausführen. + + +## Projekt mit dem {{site.data.keyword.dev_cli_notm}} ausführen +{: #running-dev-plugin} + +1. Geben Sie zum Erstellen des Projekts im aktuellen Projektverzeichnis den folgenden Befehl ein: + + ``` + bx dev build + ``` + {: codeblock} + +2. Geben Sie zum Erstellen und Ausführen des Projekts im aktuellen Projektverzeichnis den folgenden Befehl ein: + + ``` + bx dev run + ``` + {: codeblock} + +3. Sie können mithilfe von curl auf die Anwendung auf dem Server zugreifen: + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/de/tutorial_mobile.md b/cloudnative/nl/de/tutorial_mobile.md index fa2d2f2f5..c361eb368 100644 --- a/cloudnative/nl/de/tutorial_mobile.md +++ b/cloudnative/nl/de/tutorial_mobile.md @@ -1,187 +1,187 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Umfassendes Lernprogramm zum mobilen Basis-Starter (Mobile Basic Starter) -{: #tutorial} - -Das folgende umfassende Lernprogramm führt Sie durch die Schritte zur Erstellung eines Projekts aus dem mobilen Basis-Starter (Mobile Basic Starter), inklusive der Tools, die Sie installiert haben müssen, sowie durch die Schritte zum Ausführen des Projekts in Xcode und Android Studio. - - -## Entwicklertools installieren -{: #dev_tools} - -Stellen Sie sicher, dass die [vorausgesetzten Entwicklertools ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](get_code.html#prereq-dev-tools){: new_window} installiert sind. - - -## Projekt mit der {{site.data.keyword.dev_console}} erstellen -{: #create-devex} - -1. Erstellen Sie ein {{site.data.keyword.dev_console}}-Projekt in {{site.data.keyword.Bluemix}}. - - 1. Klicken Sie auf der Seite **Einführung** in der {{site.data.keyword.dev_console}} auf **Projekt erstellen**. - - Alternativ können Sie auf der Seite **Projekte** auf **Projekt erstellen** klicken. - - 2. Wählen Sie **Mobile App** aus und klicken Sie auf **Weiter**. - - 3. Wählen Sie **Basis** aus und klicken Sie auf **Weiter**. - - 4. Geben Sie Ihren Projektnamen ein. Verwenden Sie für dieses Lernprogramm `MobileBasicProject`. - - 5. Wählen Sie Ihre Plattform aus. Verwenden Sie für dieses Lernprogramm `Swift`. - - 6. Klicken Sie auf **Erstellen**. - -2. Optional: Fügen Sie die Authentication-Funktion hinzu. - - 1. Klicken Sie auf der Seite **Projektübersicht** für **Authentication** auf **Hinzufügen**. - - Alternativ können Sie **Erstellen** oder **Vorhandenen hinzufügen** auf der Seite **Funktionen > Authentication** aus. - - 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. - - 3. Wechseln Sie zu **Authentication**. - - 4. Wählen Sie Ihren Identitätsprovider aus und geben Sie für dessen Konfiguration die erforderlichen Informationen ein. Sie können nur einen einzigen Identitätsprovider aktivieren. - - 5. Weitere Informationen zum Konfigurieren von Authentication finden Sie unter [Identitätsprovider konfigurieren} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/appid/identity-providers.html){: new_window}. - -3. Optional: Fügen Sie die Analytics-Funktion hinzu. - - 1. Klicken Sie auf der Seite **Projektübersicht** für **Analytics** auf **Hinzufügen**. - - Alternativ können Sie auf der Seite **Funktionen > Analytics** auf **Erstellen** oder **Vorhandenen hinzufügen** klicken. - - 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. - - 3. Inaktivieren Sie den Demo-Modus, um Ihre Analysedaten nach Ausführung der App anzuzeigen. - - 4. Weitere Informationen zum Konfigurieren von Analytics finden Sie unter [Einführung in {{site.data.keyword.mobileanalytics_short}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobileanalytics/index.html){: new_window}. - -4. Optional: Fügen Sie die {{site.data.keyword.mobilepushshort}}-Funktion hinzu. - - 1. Klicken Sie auf der Seite **Projektübersicht** für **{{site.data.keyword.mobilepushshort}}** auf **Hinzufügen**. - - Alternativ können Sie auf der Seite **Funktionen > {{site.data.keyword.mobilepushshort}}** auf **Erstellen** oder **Vorhandenen hinzufügen** klicken. - - 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. - - 3. Für iOS: [Apple Push Notification Service konfigurieren ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}. - - 4. Für Android: [Firebase Cloud Messaging konfigurieren ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}. - -5. Optional: Fügen Sie die Data-Funktion hinzu. - - 1. Klicken Sie auf der Seite **Projektübersicht** für **Data** auf **Anzeigen**. - - Alternativ können Sie auf der Seite **Data** die Option **Erstellen** auswählen. - - 2. Wählen Sie **{{site.data.keyword.cloudant_short_notm}}** oder **{{site.data.keyword.objectstorageshort}}** aus. - - 3. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. - - 4. Weitere Informationen zum Konfigurieren von {{site.data.keyword.cloudant_short_notm}} finden Sie unter [Einführung in {{site.data.keyword.cloudant_short_notm}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/Cloudant/index.html){: new_window}. - - 5. Weitere Informationen zum Konfigurieren von {{site.data.keyword.objectstorageshort}} finden Sie unter [Einführung in {{site.data.keyword.objectstorageshort}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/ObjectStorage/index.html){: new_window}. - -6. Generieren Sie den Projektcode. - - 1. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. - - Alternativ können Sie auf die Seite **Code** klicken. - - 2. Klicken Sie auf **Swift generieren**. - - 3. Wenn die Projektcodegenerierung fertig ist, klicken Sie auf **Swift herunterladen**, um Ihr Projektarchiv herunterzuladen. - -7. Optional: [Aktualisieren Sie das Projekt](project_overview_page.html#update_language), um eine neue Sprache zu generieren. - - -## Projekt mit dem {{site.data.keyword.dev_cli_notm}} erstellen -{: #create-cli} - -1. Stellen Sie sicher, dass das [{{site.data.keyword.dev_cli_short}}](dev_cli.html) installiert ist. - -2. Navigieren Sie in der Eingabeaufforderung des Terminals zu einem lokalen Verzeichnis Ihrer Wahl und führen Sie den folgenden Befehl aus. - - ``` - bx dev create - ``` - {: codeblock} - -3. Geben Sie bei Aufforderung die folgenden Werte an: - - * Wählen Sie ein Muster aus: 2 (für Mobil) - * Wählen Sie einen Starter aus: 1 (für Basis) - * Wählen Sie eine Plattform aus: 3 (für iOS Swift) - * Geben Sie einen Namen für Ihr Projekt ein: `MobileBasicProjectCLI` - -4. Wenn Sie Services zu Ihrem Projekt hinzufügen möchten, geben Sie `y` ein, wenn Sie in der Eingabeaufforderung danach gefragt werden, und beantworten Sie die restlichen Fragen. - -5. Navigieren Sie nach dem erfolgreichen Speichern des Projekts `MobileBasicProjectCLI` zum Ordner `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift`. - - -## Swift-Projekt in Xcode ausführen -{: #run_swift} - -1. Extrahieren Sie die Datei `MobileBasicProject-Swift.zip`. - -2. Öffnen Sie die Datei `README.md` in einem Markdown-Viewer, um die Schritte zur Konfiguration Ihres Projekts zu überprüfen. - - 1. Öffnen Sie Ihr Terminal und navigieren Sie zu Ihrem Projektordner. - - 1. Führen Sie `pod setup` aus, wenn Sie Ihr CocoaPods-Repository einrichten müssen. - - 2. Führen Sie `pod update` aus, wenn Sie Ihre bereits vorhandenen Pods aktualisieren müssen. - - 3. Führen Sie `pod install` aus, um die Pods zu installieren, die für Ihr Projekt erforderlich sind. - - 3. Öffnen Sie Ihren Xcode-Arbeitsbereich `BasicProject.xcworkspace`. - -3. Führen Sie Ihre App aus. - - -## Cordova-Projekt in Xcode ausführen -{: #run_cordova_xcode} - -1. Extrahieren Sie die Datei `MobileBasicProject-Cordova.zip`. - -2. Öffnen Sie die Datei `README.md` in einem Markdown-Viewer, um Ihr Projekt zu konfigurieren. - - 1. Öffnen Sie Ihr `platforms/ios`-Projekt in Xcode. - -3. Führen Sie Ihre App aus. - - -## Cordova-Projekt in Android Studio ausführen -{: #run_cordova_studio} - -1. Extrahieren Sie die Datei `BasicProject-Cordova.zip`. - -2. Öffnen Sie die Datei `README.md` in einem Markdown-Viewer, um Ihr Projekt zu konfigurieren. - - 1. Öffnen Sie Ihr `platforms/android`-Projekt in Android Studio. - -3. Führen Sie Ihre App aus. - - -## Android-Projekt in Android Studio ausführen -{: #run_android} - -1. Extrahieren Sie die Datei `MobileBasicProject-Android.zip`. - -2. Öffnen Sie die Datei `README.md` in einem Markdown-Viewer, um Ihr Projekt zu konfigurieren. - - 1. Öffnen Sie Ihr `BasicProject-Android`-Projekt in Android Studio. - -3. Führen Sie Ihre App aus. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Umfassendes Lernprogramm zum mobilen Basis-Starter (Mobile Basic Starter) +{: #tutorial} + +Das folgende umfassende Lernprogramm führt Sie durch die Schritte zur Erstellung eines Projekts aus dem mobilen Basis-Starter (Mobile Basic Starter), inklusive der Tools, die Sie installiert haben müssen, sowie durch die Schritte zum Ausführen des Projekts in Xcode und Android Studio. + + +## Entwicklertools installieren +{: #dev_tools} + +Stellen Sie sicher, dass die [vorausgesetzten Entwicklertools ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](get_code.html#prereq-dev-tools){: new_window} installiert sind. + + +## Projekt mit der {{site.data.keyword.dev_console}} erstellen +{: #create-devex} + +1. Erstellen Sie ein {{site.data.keyword.dev_console}}-Projekt in {{site.data.keyword.Bluemix}}. + + 1. Klicken Sie auf der Seite **Einführung** in der {{site.data.keyword.dev_console}} auf **Projekt erstellen**. + + Alternativ können Sie auf der Seite **Projekte** auf **Projekt erstellen** klicken. + + 2. Wählen Sie **Mobile App** aus und klicken Sie auf **Weiter**. + + 3. Wählen Sie **Basis** aus und klicken Sie auf **Weiter**. + + 4. Geben Sie Ihren Projektnamen ein. Verwenden Sie für dieses Lernprogramm `MobileBasicProject`. + + 5. Wählen Sie Ihre Plattform aus. Verwenden Sie für dieses Lernprogramm `Swift`. + + 6. Klicken Sie auf **Erstellen**. + +2. Optional: Fügen Sie die Authentication-Funktion hinzu. + + 1. Klicken Sie auf der Seite **Projektübersicht** für **Authentication** auf **Hinzufügen**. + + Alternativ können Sie **Erstellen** oder **Vorhandenen hinzufügen** auf der Seite **Funktionen > Authentication** aus. + + 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. + + 3. Wechseln Sie zu **Authentication**. + + 4. Wählen Sie Ihren Identitätsprovider aus und geben Sie für dessen Konfiguration die erforderlichen Informationen ein. Sie können nur einen einzigen Identitätsprovider aktivieren. + + 5. Weitere Informationen zum Konfigurieren von Authentication finden Sie unter [Identitätsprovider konfigurieren} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/appid/identity-providers.html){: new_window}. + +3. Optional: Fügen Sie die Analytics-Funktion hinzu. + + 1. Klicken Sie auf der Seite **Projektübersicht** für **Analytics** auf **Hinzufügen**. + + Alternativ können Sie auf der Seite **Funktionen > Analytics** auf **Erstellen** oder **Vorhandenen hinzufügen** klicken. + + 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. + + 3. Inaktivieren Sie den Demo-Modus, um Ihre Analysedaten nach Ausführung der App anzuzeigen. + + 4. Weitere Informationen zum Konfigurieren von Analytics finden Sie unter [Einführung in {{site.data.keyword.mobileanalytics_short}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobileanalytics/index.html){: new_window}. + +4. Optional: Fügen Sie die {{site.data.keyword.mobilepushshort}}-Funktion hinzu. + + 1. Klicken Sie auf der Seite **Projektübersicht** für **{{site.data.keyword.mobilepushshort}}** auf **Hinzufügen**. + + Alternativ können Sie auf der Seite **Funktionen > {{site.data.keyword.mobilepushshort}}** auf **Erstellen** oder **Vorhandenen hinzufügen** klicken. + + 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. + + 3. Für iOS: [Apple Push Notification Service konfigurieren ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}. + + 4. Für Android: [Firebase Cloud Messaging konfigurieren ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}. + +5. Optional: Fügen Sie die Data-Funktion hinzu. + + 1. Klicken Sie auf der Seite **Projektübersicht** für **Data** auf **Anzeigen**. + + Alternativ können Sie auf der Seite **Data** die Option **Erstellen** auswählen. + + 2. Wählen Sie **{{site.data.keyword.cloudant_short_notm}}** oder **{{site.data.keyword.objectstorageshort}}** aus. + + 3. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. + + 4. Weitere Informationen zum Konfigurieren von {{site.data.keyword.cloudant_short_notm}} finden Sie unter [Einführung in {{site.data.keyword.cloudant_short_notm}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/Cloudant/index.html){: new_window}. + + 5. Weitere Informationen zum Konfigurieren von {{site.data.keyword.objectstorageshort}} finden Sie unter [Einführung in {{site.data.keyword.objectstorageshort}} ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/ObjectStorage/index.html){: new_window}. + +6. Generieren Sie den Projektcode. + + 1. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. + + Alternativ können Sie auf die Seite **Code** klicken. + + 2. Klicken Sie auf **Swift generieren**. + + 3. Wenn die Projektcodegenerierung fertig ist, klicken Sie auf **Swift herunterladen**, um Ihr Projektarchiv herunterzuladen. + +7. Optional: [Aktualisieren Sie das Projekt](project_overview_page.html#update_language), um eine neue Sprache zu generieren. + + +## Projekt mit dem {{site.data.keyword.dev_cli_notm}} erstellen +{: #create-cli} + +1. Stellen Sie sicher, dass das [{{site.data.keyword.dev_cli_short}}](dev_cli.html) installiert ist. + +2. Navigieren Sie in der Eingabeaufforderung des Terminals zu einem lokalen Verzeichnis Ihrer Wahl und führen Sie den folgenden Befehl aus. + + ``` + bx dev create + ``` + {: codeblock} + +3. Geben Sie bei Aufforderung die folgenden Werte an: + + * Wählen Sie ein Muster aus: 2 (für Mobil) + * Wählen Sie einen Starter aus: 1 (für Basis) + * Wählen Sie eine Plattform aus: 3 (für iOS Swift) + * Geben Sie einen Namen für Ihr Projekt ein: `MobileBasicProjectCLI` + +4. Wenn Sie Services zu Ihrem Projekt hinzufügen möchten, geben Sie `y` ein, wenn Sie in der Eingabeaufforderung danach gefragt werden, und beantworten Sie die restlichen Fragen. + +5. Navigieren Sie nach dem erfolgreichen Speichern des Projekts `MobileBasicProjectCLI` zum Ordner `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift`. + + +## Swift-Projekt in Xcode ausführen +{: #run_swift} + +1. Extrahieren Sie die Datei `MobileBasicProject-Swift.zip`. + +2. Öffnen Sie die Datei `README.md` in einem Markdown-Viewer, um die Schritte zur Konfiguration Ihres Projekts zu überprüfen. + + 1. Öffnen Sie Ihr Terminal und navigieren Sie zu Ihrem Projektordner. + + 1. Führen Sie `pod setup` aus, wenn Sie Ihr CocoaPods-Repository einrichten müssen. + + 2. Führen Sie `pod update` aus, wenn Sie Ihre bereits vorhandenen Pods aktualisieren müssen. + + 3. Führen Sie `pod install` aus, um die Pods zu installieren, die für Ihr Projekt erforderlich sind. + + 3. Öffnen Sie Ihren Xcode-Arbeitsbereich `BasicProject.xcworkspace`. + +3. Führen Sie Ihre App aus. + + +## Cordova-Projekt in Xcode ausführen +{: #run_cordova_xcode} + +1. Extrahieren Sie die Datei `MobileBasicProject-Cordova.zip`. + +2. Öffnen Sie die Datei `README.md` in einem Markdown-Viewer, um Ihr Projekt zu konfigurieren. + + 1. Öffnen Sie Ihr `platforms/ios`-Projekt in Xcode. + +3. Führen Sie Ihre App aus. + + +## Cordova-Projekt in Android Studio ausführen +{: #run_cordova_studio} + +1. Extrahieren Sie die Datei `BasicProject-Cordova.zip`. + +2. Öffnen Sie die Datei `README.md` in einem Markdown-Viewer, um Ihr Projekt zu konfigurieren. + + 1. Öffnen Sie Ihr `platforms/android`-Projekt in Android Studio. + +3. Führen Sie Ihre App aus. + + +## Android-Projekt in Android Studio ausführen +{: #run_android} + +1. Extrahieren Sie die Datei `MobileBasicProject-Android.zip`. + +2. Öffnen Sie die Datei `README.md` in einem Markdown-Viewer, um Ihr Projekt zu konfigurieren. + + 1. Öffnen Sie Ihr `BasicProject-Android`-Projekt in Android Studio. + +3. Führen Sie Ihre App aus. diff --git a/cloudnative/nl/de/tutorial_web.md b/cloudnative/nl/de/tutorial_web.md index ba6d0c532..18b8fa5ff 100644 --- a/cloudnative/nl/de/tutorial_web.md +++ b/cloudnative/nl/de/tutorial_web.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Umfassendes Lernprogramm zum Web-Basis-Starter (Web Basic Starter) -{: #tutorial} - -Das folgende umfassende Lernprogramm führt Sie durch die Schritte zur Erstellung eines Projekts aus dem Web-Basis-Starter, inklusive der Tools, die Sie installiert haben müssen, sowie durch die Schritte zum Ausführen des Projektcodes. - -## Entwicklertools installieren -{: #dev_tools} - -Stellen Sie sicher, dass die [vorausgesetzten Entwicklertools ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](get_code.html#prereq-dev-tools){: new_window} installiert sind. - - -## Projekt mit der {{site.data.keyword.dev_console}} erstellen -{: #create-devex} - -1. Erstellen Sie ein Projekt in der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Klicken Sie auf der Seite **Einführung** in der {{site.data.keyword.dev_console}} auf **Projekt erstellen**. - - Alternativ können Sie auf der Seite **Projekte** auf **Projekt erstellen** klicken. - - 2. Wählen Sie **Web-App** aus und klicken Sie auf **Weiter**. - - 3. Wählen Sie **Basic Web** aus und klicken Sie auf **Weiter**. - - 4. Geben Sie Ihren Projektnamen ein. Verwenden Sie für dieses Lernprogramm `WebBasicProject`. - - 5. Geben Sie einen Hostnamen ein. Verwenden Sie für dieses Lernprogramm `devhost`. - - 6. Wählen Sie Ihre Sprachplattform aus. Verwenden Sie für dieses Lernprogramm `Swift`. - - 7. Klicken Sie auf **Erstellen**. - -2. Optional: Fügen Sie die Data-Funktion hinzu. - - 1. Klicken Sie auf der Seite **Projektübersicht** für **Data** auf **Anzeigen**. - - Alternativ können Sie **Erstellen** oder **Vorhandenen hinzufügen** auf der Seite **Funktionen > Data** aus. - - 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. - - -3. Generieren Sie den Projektcode. - - 1. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. - - Alternativ können Sie auf die Seite **Code** klicken. - - 2. Klicken Sie auf **Code generieren**. - - 3. Wenn die Projektcodegenerierung fertig ist, klicken Sie auf **Code herunterladen**, um Ihr Projektarchiv herunterzuladen. - -4. Optional: [Aktualisieren Sie das Projekt](project_overview_page.html#update_language), um eine neue Sprache zu generieren. - - -## Projekt mit dem {{site.data.keyword.dev_cli_notm}} erstellen -{: #create-cli} - -1. Stellen Sie sicher, dass das [{{site.data.keyword.dev_cli_short}}](dev_cli.html) installiert ist. - -2. Navigieren Sie in der Eingabeaufforderung des Terminals zu einem lokalen Verzeichnis Ihrer Wahl und führen Sie den folgenden Befehl aus. - - ``` - bx dev create - ``` - {: codeblock} - - -3. Geben Sie bei Aufforderung die folgenden Werte an: - - * Wählen Sie ein Muster aus: 1 (für Web) - * Wählen Sie einen Starter aus: 1 (für Basic Web) - * Wählen Sie eine Sprache aus: 2 (für Swift) - * Geben Sie einen Namen für Ihr Projekt ein: `WebBasicProjectCLI` - * Geben Sie einen Hostnamen für Ihr Projekt ein: `myhost` - -4. Wenn Sie Services zu Ihrem Projekt hinzufügen möchten, geben Sie `y` ein, wenn Sie in der Eingabeaufforderung danach gefragt werden, und beantworten Sie die restlichen Fragen. - -5. Navigieren Sie nach dem erfolgreichen Speichern des Projekts `WebBasicProjectCLI` zum Ordner `WebBasicProjectCLI`. - -6. Fügen Sie eigenen Code hinzu, erstellen Sie das Projekt und führen Sie es aus. - - 1. Erstellen Sie das Projekt mit dem folgenden Befehl: - - ``` - bx dev build - ``` - {: codeblock} - - 2. Führen Sie das Projekt mit dem folgenden Befehl aus: - - ``` - bx dev run - ``` - {: codeblock} - - -## Ein Webprojekt ausführen -{: #run} - -### Lokal -{: #local notoc} - -1. Installieren Sie Ihre Knotenabhängigkeiten: - - ``` - npm install - ``` - {: codeblock} - -2. Bündeln Sie den Front-End-Code in einem Modul: - - ``` - node_modules/.bin/gulp - ``` - {: codeblock} - -3. Kompilieren Sie den Server: - - ``` - swift build - ``` - {: codeblock} - -4. Führen Sie die Anwendung aus: - - ``` - .build/debug/WebBasicProjectCLI - ``` - {: codeblock} - -5. Öffnen Sie im Browser `http://localhost:8080`. - - -### {{site.data.keyword.dev_cli_short}} verwenden -{: #dev notoc} - -1. Installieren Sie die Knotenabhängigkeiten: - - ``` - npm install - ``` - {: codeblock} - -2. Bündeln Sie den Front-End-Code in einem Modul: - - ``` - gulp - ``` - {: codeblock} - -3. Führen Sie die Kompilierung aus: - - ``` - bx dev run - ``` - {: codeblock} - -4. Öffnen Sie im Browser `http://localhost:8080`. - - -## Eigenes Projekt in Xcode ausführen -{: #Xcode} - -1. Erstellen Sie ein Xcode-Projekt. - - Damit Sie mit der Entwicklung in Xcode beginnen können, müssen Sie mit dem Paketmanager für Swift ein Xcode-Projekt erstellen. - - ``` - swift project generate-xcodeproj - ``` - {: codeblock} - -2. Ändern Sie das aktive Ziel in die ausführbare Datei: - - Öffnen Sie anschließend das Projekt in Xcode und stellen Sie sicher, dass das aktuelle Ziel die ausführbare Datei ist. Sie können die Optionstaste gedrückt halten, während Sie auf das Dropdown-Menü klicken, um die gewünschte ausführbare Datei auszuwählen. - -3. Klicken Sie auf **Ausführen**. - -4. Öffnen Sie im Browser `http://localhost:8080`. - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Umfassendes Lernprogramm zum Web-Basis-Starter (Web Basic Starter) +{: #tutorial} + +Das folgende umfassende Lernprogramm führt Sie durch die Schritte zur Erstellung eines Projekts aus dem Web-Basis-Starter, inklusive der Tools, die Sie installiert haben müssen, sowie durch die Schritte zum Ausführen des Projektcodes. + +## Entwicklertools installieren +{: #dev_tools} + +Stellen Sie sicher, dass die [vorausgesetzten Entwicklertools ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](get_code.html#prereq-dev-tools){: new_window} installiert sind. + + +## Projekt mit der {{site.data.keyword.dev_console}} erstellen +{: #create-devex} + +1. Erstellen Sie ein Projekt in der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Klicken Sie auf der Seite **Einführung** in der {{site.data.keyword.dev_console}} auf **Projekt erstellen**. + + Alternativ können Sie auf der Seite **Projekte** auf **Projekt erstellen** klicken. + + 2. Wählen Sie **Web-App** aus und klicken Sie auf **Weiter**. + + 3. Wählen Sie **Basic Web** aus und klicken Sie auf **Weiter**. + + 4. Geben Sie Ihren Projektnamen ein. Verwenden Sie für dieses Lernprogramm `WebBasicProject`. + + 5. Geben Sie einen Hostnamen ein. Verwenden Sie für dieses Lernprogramm `devhost`. + + 6. Wählen Sie Ihre Sprachplattform aus. Verwenden Sie für dieses Lernprogramm `Swift`. + + 7. Klicken Sie auf **Erstellen**. + +2. Optional: Fügen Sie die Data-Funktion hinzu. + + 1. Klicken Sie auf der Seite **Projektübersicht** für **Data** auf **Anzeigen**. + + Alternativ können Sie **Erstellen** oder **Vorhandenen hinzufügen** auf der Seite **Funktionen > Data** aus. + + 2. Geben Sie Ihren Servicenamen ein und klicken Sie auf **Erstellen**. + + +3. Generieren Sie den Projektcode. + + 1. Klicken Sie auf der Seite **Projektübersicht** auf **Code abrufen**, um Ihre Sprache auszuwählen. + + Alternativ können Sie auf die Seite **Code** klicken. + + 2. Klicken Sie auf **Code generieren**. + + 3. Wenn die Projektcodegenerierung fertig ist, klicken Sie auf **Code herunterladen**, um Ihr Projektarchiv herunterzuladen. + +4. Optional: [Aktualisieren Sie das Projekt](project_overview_page.html#update_language), um eine neue Sprache zu generieren. + + +## Projekt mit dem {{site.data.keyword.dev_cli_notm}} erstellen +{: #create-cli} + +1. Stellen Sie sicher, dass das [{{site.data.keyword.dev_cli_short}}](dev_cli.html) installiert ist. + +2. Navigieren Sie in der Eingabeaufforderung des Terminals zu einem lokalen Verzeichnis Ihrer Wahl und führen Sie den folgenden Befehl aus. + + ``` + bx dev create + ``` + {: codeblock} + + +3. Geben Sie bei Aufforderung die folgenden Werte an: + + * Wählen Sie ein Muster aus: 1 (für Web) + * Wählen Sie einen Starter aus: 1 (für Basic Web) + * Wählen Sie eine Sprache aus: 2 (für Swift) + * Geben Sie einen Namen für Ihr Projekt ein: `WebBasicProjectCLI` + * Geben Sie einen Hostnamen für Ihr Projekt ein: `myhost` + +4. Wenn Sie Services zu Ihrem Projekt hinzufügen möchten, geben Sie `y` ein, wenn Sie in der Eingabeaufforderung danach gefragt werden, und beantworten Sie die restlichen Fragen. + +5. Navigieren Sie nach dem erfolgreichen Speichern des Projekts `WebBasicProjectCLI` zum Ordner `WebBasicProjectCLI`. + +6. Fügen Sie eigenen Code hinzu, erstellen Sie das Projekt und führen Sie es aus. + + 1. Erstellen Sie das Projekt mit dem folgenden Befehl: + + ``` + bx dev build + ``` + {: codeblock} + + 2. Führen Sie das Projekt mit dem folgenden Befehl aus: + + ``` + bx dev run + ``` + {: codeblock} + + +## Ein Webprojekt ausführen +{: #run} + +### Lokal +{: #local notoc} + +1. Installieren Sie Ihre Knotenabhängigkeiten: + + ``` + npm install + ``` + {: codeblock} + +2. Bündeln Sie den Front-End-Code in einem Modul: + + ``` + node_modules/.bin/gulp + ``` + {: codeblock} + +3. Kompilieren Sie den Server: + + ``` + swift build + ``` + {: codeblock} + +4. Führen Sie die Anwendung aus: + + ``` + .build/debug/WebBasicProjectCLI + ``` + {: codeblock} + +5. Öffnen Sie im Browser `http://localhost:8080`. + + +### {{site.data.keyword.dev_cli_short}} verwenden +{: #dev notoc} + +1. Installieren Sie die Knotenabhängigkeiten: + + ``` + npm install + ``` + {: codeblock} + +2. Bündeln Sie den Front-End-Code in einem Modul: + + ``` + gulp + ``` + {: codeblock} + +3. Führen Sie die Kompilierung aus: + + ``` + bx dev run + ``` + {: codeblock} + +4. Öffnen Sie im Browser `http://localhost:8080`. + + +## Eigenes Projekt in Xcode ausführen +{: #Xcode} + +1. Erstellen Sie ein Xcode-Projekt. + + Damit Sie mit der Entwicklung in Xcode beginnen können, müssen Sie mit dem Paketmanager für Swift ein Xcode-Projekt erstellen. + + ``` + swift project generate-xcodeproj + ``` + {: codeblock} + +2. Ändern Sie das aktive Ziel in die ausführbare Datei: + + Öffnen Sie anschließend das Projekt in Xcode und stellen Sie sicher, dass das aktuelle Ziel die ausführbare Datei ist. Sie können die Optionstaste gedrückt halten, während Sie auf das Dropdown-Menü klicken, um die gewünschte ausführbare Datei auszuwählen. + +3. Klicken Sie auf **Ausführen**. + +4. Öffnen Sie im Browser `http://localhost:8080`. + diff --git a/cloudnative/nl/de/tutorials.md b/cloudnative/nl/de/tutorials.md index 6e5d6b269..8e161e5a7 100644 --- a/cloudnative/nl/de/tutorials.md +++ b/cloudnative/nl/de/tutorials.md @@ -1,49 +1,49 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Umfassende Lernprogramme -{: #tutorial} - -Die folgenden umfassenden Lernprogramme führen Sie durch die Schritte zur Erstellung eines Projekts aus der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, inklusive der Tools, die Sie installiert haben müssen, sowie durch die Schritte zum Ausführen des Projektcodes. - -## Web -{: #web notoc} - -* [Web-Basis-Lernprogramm](tutorial_web.html) - - -## Mobile -{: #mobile notoc} - -* [Mobiles Basis-Lernprogramm](tutorial_mobile.html) - - - - -## BFF -{: #bff notoc} - -* [BFF-Basis-Lernprogramm](tutorial_bff.html) - - -## Microservice -{: #microservice notoc} - -* [Microservice-Basis-Lernprogramm](tutorial_microservice.html) +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Umfassende Lernprogramme +{: #tutorial} + +Die folgenden umfassenden Lernprogramme führen Sie durch die Schritte zur Erstellung eines Projekts aus der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, inklusive der Tools, die Sie installiert haben müssen, sowie durch die Schritte zum Ausführen des Projektcodes. + +## Web +{: #web notoc} + +* [Web-Basis-Lernprogramm](tutorial_web.html) + + +## Mobile +{: #mobile notoc} + +* [Mobiles Basis-Lernprogramm](tutorial_mobile.html) + + + + +## BFF +{: #bff notoc} + +* [BFF-Basis-Lernprogramm](tutorial_bff.html) + + +## Microservice +{: #microservice notoc} + +* [Microservice-Basis-Lernprogramm](tutorial_microservice.html) diff --git a/cloudnative/nl/de/what_is_new.md b/cloudnative/nl/de/what_is_new.md index 9fa08e3aa..bbf21de46 100644 --- a/cloudnative/nl/de/what_is_new.md +++ b/cloudnative/nl/de/what_is_new.md @@ -1,97 +1,97 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Neuerungen in der {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} -{: #what-is-new} - - -## Neu ab März 2017 -{: #mar-2017} - -Mit der Aktualisierung der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} im März 2017 wurden folgende Änderungen eingeführt: - - * Das {{site.data.keyword.Bluemix_notm}} Mobile-Dashboard ist jetzt die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}. - * Die Projekterstellung wurde überarbeitet und schließt jetzt Mustertypen für Web-App-, BFF- und Microservice-Server mit Unterstützung für Node.js, Java und Swift ein. - * Die Integration in den neuen und verbesserten {{site.data.keyword.appid_full}}-Service ermöglicht die Authentifizierung für Mobile and Web-Projekte. - * Jetzt können Sie zusätzlich SDKs für Ihre Projekte mit dem [SDK Generator-Plug-in](sdk_cli.html) generieren. Die SDK-Generierung in der {{site.data.keyword.dev_console}} ist nur für mobile Projekte verfügbar. - * Jetzt können Sie zusätzlich Projekte mit dem [{{site.data.keyword.dev_cli_short}}](dev_cli.html) erstellen. - - -## Neu ab Januar 2017 -{: #jan-2017} - -Mit der Aktualisierung des {{site.data.keyword.Bluemix_notm}} Mobile-Dashboards im Januar 2017 wurden folgende Änderungen eingeführt: - - * Ab dem 31. Januar gelten Benutzerschnittstellenstarter als veraltet. Vorhandene Projekte, die mit einem Benutzerschnittstellenstarter erstellt wurden, können bis 30. April 2017 verwendet werden. Weitere Informationen zu den Migrationsschritten und zum Entfernungsdatum finden Sie im [Blogbeitrag mit den Ankündigungen für die Einstellung der Unterstützung ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/). -{: deprecated} - * Sie können den Startertyp Ihres Projekts jetzt aktualisieren, anstatt das Projekt zu löschen und ein neues Projekt zu erstellen. - * Sie können jetzt ein Projekt mit einem [Watson Conversation](tutorial_conversation.html)-Code-Starter erstellen. - * Falls dies unterstützt wird, können Sie jetzt ein SDK für Ihr Projekt erstellen. - * Sie können jetzt Ihre vorhandenen [Compute](sdk_compute.html)-Instanzen hinzufügen und Client-SDKs generieren, die dann zu Ihrem Projekt hinzugefügt werden. - - -## Neu ab Dezember 2016 -{: #dec-2016} - -Mit der Aktualisierung des {{site.data.keyword.Bluemix_notm}} Mobile-Dashboards im Dezember 2016 wurden die folgenden Änderungen eingeführt: - - * Sie können jetzt einen verbundenen Service aus einem Projekt entfernen, um ihn zu löschen oder mit einem anderen Projekt wiederzuverwenden. - * Sie können jetzt einen vorhandenen Service zu einem Projekt hinzufügen. - * Sie können jetzt einen CloudantNoSQL-Service als Datenquelle erstellen oder einen vorhandenen Service verbinden, wenn Sie einen Code-Starter verwenden. - * Falls dies unterstützt wird, können Sie jetzt einen Object Storage-Service als Datenquelle für Ihr Projekt erstellen oder einen vorhandenen Service verbinden. - * Sie können jetzt das Navigationsdesign der App, die Sie erstellen, mit einem Benutzerschnittstellenstarter anpassen. - - -## Neu ab November 2016 -{: #nov-2016} - -Mit der November-Aktualisierung des {{site.data.keyword.Bluemix_notm}} Mobile-Dashboards wurden folgende Änderungen eingeführt: - - * Sie können jetzt SDK-Artefakte für Ihre Projekte auf der Seite **Code** generieren. - * Cordova wird jetzt für den Basis-Code-Starter (Basic Code Starter) unterstützt. - * Sie können jetzt [Netzwerkereignisse auflisten ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} und [Netzanforderungen überwachen ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} (auf der Seite **Netzanforderungen** der {{site.data.keyword.mobileanalytics_short}}-Konsole). - * Sie können jetzt [Daten in dashDB exportieren ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} (in der {{site.data.keyword.mobileanalytics_short}}-Konsole). - - -## Neu ab Oktober 2016 -{: #oct-2016} - -Mit der Aktualisierung des {{site.data.keyword.Bluemix_notm}} Mobile-Dashboards im Oktober 2016 wurden folgende Änderungen eingeführt: - - * Sie können Ihrem Projekt jetzt {{site.data.keyword.mobilepushshort}}- und Analytics-Funktionen direkt über das Dashboard hinzufügen. - * Es stehen jetzt [Code-Starter](starters.html#Code_Starter) zur Verfügung. - * Sie können Ihren Projekten, die Sie mit einem Code-Starter erstellt haben, die Funktion 'Authentication' hinzufügen. - * Swift wird jetzt unterstützt. - - -### Analytics -{: #analytics notoc} - - * Der Demo-Modus ist standardmäßig aktiviert, wenn Sie die Analytics-Funktion hinzufügen. Sie können den Demo-Modus ausschalten, um Ihre Analyse anzuzeigen, nachdem Sie Ihre App ausgeführt haben. - - -### Benutzerschnittstellenbuilder -{: #ui_builder notoc} - - * Auf die Funktion für **{{site.data.keyword.mobilepushshort}}** wird jetzt über das Projekt zugegriffen. - * Die Registerkarte **Projekteinstellungen** wurde in **Einstellungen** umbenannt. - * Die Registerkarte **Authentifizierung** wurde in **Benutzerzugriff** umbenannt. - - -### Code -{: #code notoc} - - * Der generierte Objective-C- und Swift-Code für iOS verwendet für die Verwaltung von Abhängigkeiten jetzt CocoaPods. Das bedeutet, dass Sie CocoaPods installieren müssen. Für die Installation führen Sie `sudo gem install cocoapods` aus. Nach der Installation von CocoaPods führen Sie `pod setup` aus, um es zu konfigurieren (wenn es nicht bereits konfiguriert ist). Zum Schluss führen Sie `pod install` aus, um die erforderlichen Projektabhängigkeiten vor dem Öffnen Ihrer `.xcworkspace`-Datei in Xcode herunterzuladen und zu installieren. Weitere Einzelheiten stehen in der `README.md`-Datei im heruntergeladenen Code-Archiv zur Verfügung. Weitere Informationen erhalten Sie unter [Vorausgesetzte Entwicklertools](get_code.html#prereq-dev-tools). - -Prüfen Sie regelmäßig nach, ob neue Aktualisierungen zur Verfügung stehen. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Neuerungen in der {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} +{: #what-is-new} + + +## Neu ab März 2017 +{: #mar-2017} + +Mit der Aktualisierung der {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} im März 2017 wurden folgende Änderungen eingeführt: + + * Das {{site.data.keyword.Bluemix_notm}} Mobile-Dashboard ist jetzt die {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}. + * Die Projekterstellung wurde überarbeitet und schließt jetzt Mustertypen für Web-App-, BFF- und Microservice-Server mit Unterstützung für Node.js, Java und Swift ein. + * Die Integration in den neuen und verbesserten {{site.data.keyword.appid_full}}-Service ermöglicht die Authentifizierung für Mobile and Web-Projekte. + * Jetzt können Sie zusätzlich SDKs für Ihre Projekte mit dem [SDK Generator-Plug-in](sdk_cli.html) generieren. Die SDK-Generierung in der {{site.data.keyword.dev_console}} ist nur für mobile Projekte verfügbar. + * Jetzt können Sie zusätzlich Projekte mit dem [{{site.data.keyword.dev_cli_short}}](dev_cli.html) erstellen. + + +## Neu ab Januar 2017 +{: #jan-2017} + +Mit der Aktualisierung des {{site.data.keyword.Bluemix_notm}} Mobile-Dashboards im Januar 2017 wurden folgende Änderungen eingeführt: + + * Ab dem 31. Januar gelten Benutzerschnittstellenstarter als veraltet. Vorhandene Projekte, die mit einem Benutzerschnittstellenstarter erstellt wurden, können bis 30. April 2017 verwendet werden. Weitere Informationen zu den Migrationsschritten und zum Entfernungsdatum finden Sie im [Blogbeitrag mit den Ankündigungen für die Einstellung der Unterstützung ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/). +{: deprecated} + * Sie können den Startertyp Ihres Projekts jetzt aktualisieren, anstatt das Projekt zu löschen und ein neues Projekt zu erstellen. + * Sie können jetzt ein Projekt mit einem [Watson Conversation](tutorial_conversation.html)-Code-Starter erstellen. + * Falls dies unterstützt wird, können Sie jetzt ein SDK für Ihr Projekt erstellen. + * Sie können jetzt Ihre vorhandenen [Compute](sdk_compute.html)-Instanzen hinzufügen und Client-SDKs generieren, die dann zu Ihrem Projekt hinzugefügt werden. + + +## Neu ab Dezember 2016 +{: #dec-2016} + +Mit der Aktualisierung des {{site.data.keyword.Bluemix_notm}} Mobile-Dashboards im Dezember 2016 wurden die folgenden Änderungen eingeführt: + + * Sie können jetzt einen verbundenen Service aus einem Projekt entfernen, um ihn zu löschen oder mit einem anderen Projekt wiederzuverwenden. + * Sie können jetzt einen vorhandenen Service zu einem Projekt hinzufügen. + * Sie können jetzt einen CloudantNoSQL-Service als Datenquelle erstellen oder einen vorhandenen Service verbinden, wenn Sie einen Code-Starter verwenden. + * Falls dies unterstützt wird, können Sie jetzt einen Object Storage-Service als Datenquelle für Ihr Projekt erstellen oder einen vorhandenen Service verbinden. + * Sie können jetzt das Navigationsdesign der App, die Sie erstellen, mit einem Benutzerschnittstellenstarter anpassen. + + +## Neu ab November 2016 +{: #nov-2016} + +Mit der November-Aktualisierung des {{site.data.keyword.Bluemix_notm}} Mobile-Dashboards wurden folgende Änderungen eingeführt: + + * Sie können jetzt SDK-Artefakte für Ihre Projekte auf der Seite **Code** generieren. + * Cordova wird jetzt für den Basis-Code-Starter (Basic Code Starter) unterstützt. + * Sie können jetzt [Netzwerkereignisse auflisten ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} und [Netzanforderungen überwachen ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} (auf der Seite **Netzanforderungen** der {{site.data.keyword.mobileanalytics_short}}-Konsole). + * Sie können jetzt [Daten in dashDB exportieren ![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} (in der {{site.data.keyword.mobileanalytics_short}}-Konsole). + + +## Neu ab Oktober 2016 +{: #oct-2016} + +Mit der Aktualisierung des {{site.data.keyword.Bluemix_notm}} Mobile-Dashboards im Oktober 2016 wurden folgende Änderungen eingeführt: + + * Sie können Ihrem Projekt jetzt {{site.data.keyword.mobilepushshort}}- und Analytics-Funktionen direkt über das Dashboard hinzufügen. + * Es stehen jetzt [Code-Starter](starters.html#Code_Starter) zur Verfügung. + * Sie können Ihren Projekten, die Sie mit einem Code-Starter erstellt haben, die Funktion 'Authentication' hinzufügen. + * Swift wird jetzt unterstützt. + + +### Analytics +{: #analytics notoc} + + * Der Demo-Modus ist standardmäßig aktiviert, wenn Sie die Analytics-Funktion hinzufügen. Sie können den Demo-Modus ausschalten, um Ihre Analyse anzuzeigen, nachdem Sie Ihre App ausgeführt haben. + + +### Benutzerschnittstellenbuilder +{: #ui_builder notoc} + + * Auf die Funktion für **{{site.data.keyword.mobilepushshort}}** wird jetzt über das Projekt zugegriffen. + * Die Registerkarte **Projekteinstellungen** wurde in **Einstellungen** umbenannt. + * Die Registerkarte **Authentifizierung** wurde in **Benutzerzugriff** umbenannt. + + +### Code +{: #code notoc} + + * Der generierte Objective-C- und Swift-Code für iOS verwendet für die Verwaltung von Abhängigkeiten jetzt CocoaPods. Das bedeutet, dass Sie CocoaPods installieren müssen. Für die Installation führen Sie `sudo gem install cocoapods` aus. Nach der Installation von CocoaPods führen Sie `pod setup` aus, um es zu konfigurieren (wenn es nicht bereits konfiguriert ist). Zum Schluss führen Sie `pod install` aus, um die erforderlichen Projektabhängigkeiten vor dem Öffnen Ihrer `.xcworkspace`-Datei in Xcode herunterzuladen und zu installieren. Weitere Einzelheiten stehen in der `README.md`-Datei im heruntergeladenen Code-Archiv zur Verfügung. Weitere Informationen erhalten Sie unter [Vorausgesetzte Entwicklertools](get_code.html#prereq-dev-tools). + +Prüfen Sie regelmäßig nach, ob neue Aktualisierungen zur Verfügung stehen. diff --git a/cloudnative/nl/es/cli.md b/cloudnative/nl/es/cli.md index c3b8bedbd..6cc44fd49 100644 --- a/cloudnative/nl/es/cli.md +++ b/cloudnative/nl/es/cli.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Plugins para la CLI de {{site.data.keyword.Bluemix_notm}} -{: #cli} - -Se pueden añadir los siguientes plugins a la CLI de {{site.data.keyword.Bluemix}}. Puede utilizar estos plugins para crear sus proyectos de {{site.data.keyword.dev_console}}. - -* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) -* [Plugin del Generador de SDK de {{site.data.keyword.IBM_notm}}](sdk_cli.html) +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Plugins para la CLI de {{site.data.keyword.Bluemix_notm}} +{: #cli} + +Se pueden añadir los siguientes plugins a la CLI de {{site.data.keyword.Bluemix}}. Puede utilizar estos plugins para crear sus proyectos de {{site.data.keyword.dev_console}}. + +* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) +* [Plugin del Generador de SDK de {{site.data.keyword.IBM_notm}}](sdk_cli.html) diff --git a/cloudnative/nl/es/compute.md b/cloudnative/nl/es/compute.md index ddfeb1256..6967b842f 100644 --- a/cloudnative/nl/es/compute.md +++ b/cloudnative/nl/es/compute.md @@ -1,181 +1,181 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Cálculo -{: #compute} - -Al crear una aplicación de canal digital nativo de la nube para móvil y mobile, la práctica recomendada es tener un BFF (Backend for Frontend, Programa de fondo para programa de usuario) que esté dedicado a su canal digital o que ofrezca el mismo soporte de integración lógica y de datos para las apps de clientes móviles y web. Para obtener más información sobre esta arquitectura, consulte [Microservicios para web y móvil ![icono de enlace externo](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture). - -El siguiente diagrama muestra una visión general de la arquitectura de BFF. - -![Arquitectura de BFF](images/bff-arch.png) - -Figura 1: Arquitectura de BFF - -El concepto de un BFF es omitir la lógica empresarial y de integración común de los servicios en la nube de {{site.data.keyword.Bluemix}} de microservicios o de alto valor. - -Con esta arquitectura, puede desplegar y lanzar actualizaciones en su aplicación Web o móvil y desplegar versiones nuevas de su BFF utilizando Delivery Pipelines continuos con el servicio de devops. - -Si tiene un BFF para iOS y un BFF independiente para Android, los equipos de ingeniería que entregan la función para estas apps no se restringen a características de release mediante una planificación de release de API centralizada. Este es un objetivo común para las arquitecturas de canal digital y de microservicio: permitir a los equipos que lancen funciones y características con frecuencia, sin estar completamente ligados a la planificación de release de otro equipo. - - - - -## Integración de un cliente móvil con un Programa de fondo para programa de usuario -{: #integration} - -Para habilitar la integración sencilla entre un cliente móvil y un BFF, {{site.data.keyword.Bluemix_notm}} da soporte a la generación de SDK del cliente móvil para iOS y Android en los lenguajes Swift y Java, respectivamente. Para habilitar esta característica, debe exponer la integración de BFF con un documento de especificación de Open API (Swagger). Este documento puede estar en la forma de JSON o YAML. - -El generador de SDK del cliente utiliza el archivo de definición de Open API para definir un SDK de desarrollador optimizado por el cliente que sea sencillo de consumir en la aplicación móvil nativa. Acelerará la integración del BFF en la aplicación móvil. - - -## Definición de una API -{: #definition} - -El BFF debe exponer un archivo de definición de API que se ajuste a la especificación de Open API que se está ejecutando en un punto final de servidor activo. Para habilitar la Experiencia de desarrollador de {{site.data.keyword.Bluemix_notm}} y la CLI (Command Line Interface, Interfaz de línea de mandatos) de SDK de {{site.data.keyword.Bluemix_notm}} para descubrir este punto final, debe añadir una variable de entorno a la aplicación de Cloud Foundry denominada `OPENAPI_SPEC`. Esta variable de entorno debe hacer referencia a la especificación utilizando una vía de acceso relativa. - -Para añadir la variable de entorno `OPENAPI_SPEC` en {{site.data.keyword.Bluemix_notm}}, siga estos pasos: - -1. Inicie sesión en [{{site.data.keyword.Bluemix_notm}} ![icono de enlace externo](../icons/launch-glyph.svg)](http://bluemix.net). -2. Seleccione una app de Cloud Foundry. -3. Seleccione **Tiempo de ejecución**. -4. Seleccione **Variables de entorno**. -5. Pulse **Añadir** en la sección **Definido por el usuario**. -6. Especifique `OPENAPI_SPEC` para **NAME** y una vía de acceso de URL relativo en su archivo de definición de Open API. -7. Pulse **Guardar**. - - - -Por ejemplo: - -``` -OPENAPI_SPEC='/explorer/swagger.json' -``` -{: codeblock} - -{{site.data.keyword.apiconnect_long}} y las aplicaciones Loopback funcionan particularmente bien utilizando este enfoque. Puede utilizar Loopback y {{site.data.keyword.apiconnect_short}} para definir un modelo persistente y exponer la operación CRUD (Create, Read, Update, and Delete - crear, recuperar, actualizar y suprimir) mediante el archivo de definición de Open API. - -También puede definir operaciones de lógica empresarial. - - -### Elementos soportados de la especificación de Open API -{: #supported-elements notoc} - -La única parte de la especificación de Open API que no está completamente soportada en la estructura de archivos. La especificación permite que se dividan partes de la definición en distintos archivos y que se haga referencia a ellas mediante el archivo `$ref` de json. Toda su definición debe estar contenida en un único archivo. - - -## Programa de fondo para programa de usuario de ejemplo utilizando Bluegen -{: #bff-bluegen} - -{{site.data.keyword.Bluemix_notm}} ha creado un BFF de referencia utilizando {{site.data.keyword.apiconnect_short}} y Strongloop, que correlaciona un modelo de producto en un {{site.data.keyword.cloudant}} y una API de imagen para hacer referencia a imágenes en {{site.data.keyword.objectstorageshort}}. - -Puede utilizar este patrón de BFF para iniciarse rápidamente con el suministro de un BFF que funcione completamente en {{site.data.keyword.Bluemix_notm}} y utilizarlo para ayudar a comprender la facilidad con que se integra un BFF en un proyecto móvil y se generan SDK nativos para iOS y Android en Swift y Java, respectivamente. - -Siga las instrucciones de [README ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) para crear un proyecto e instalarlo. - - -## Uso de Programa de fondo para programa de usuario con un proyecto de experiencia de desarrollador -{: #bff-devex} - -La experiencia de desarrollador móvil de {{site.data.keyword.Bluemix_notm}} está diseñada para simplificar la definición de un proyecto móvil con varios servicios en la nube asociados. Puede añadir de forma sencilla [{{site.data.keyword.mobilepushshort}} ![icono de enlace externo](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [Analytics ![icono de enlace externo](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html), y servicios de Datos o Almacenamiento. - -La {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} ha introducido la capacidad de integrar un BFF en un proyecto móvil en la página **Cálculo**. Puede añadir instancias de servicio de Cálculo existentes en su proyecto móvil. Una vez que se añadan, puede generar un SDK nativo para su elección de idioma o puede generar el proyecto completo y el SDK se integrará en el paquete de origen del proyecto en la página **Código**. Esto es particularmente útil cuando se integra con BFF que ya están bien definidas. - -Una vez que haya descargado el proyecto, podrá abrirlo con Xcode o Android Studio y compilar el proyecto con el SDK de cliente. - - -## Utilización de la CLI -{: #cli} - -A medida que desarrolle su BFF, la especificación de la API podría cambiar. Para admitir estos cambios, tiene las dos siguientes opciones. - -* Volver a generar todo el proyecto en una rama nueva de GitHub y fusionar los cambios en la rama de desarrollo. -* Volver a generar el SDK directamente utilizando la herramienta de línea de mandatos (CLI) y actualizar sólo la parte del SDK del proyecto móvil. - -Para utilizar la CLI, debe [instalarla](sdk_cli.html#installation). - -Utilice el siguiente mandato para listar las acciones que puede realizar. - -``` -bluemix sdk -``` -{: codeblock} - -Utilice el siguiente mandato para listar las instancias de Cloud Foundry en ejecución en el espacio actual de {{site.data.keyword.Bluemix_notm}}. - -``` -bluemix sdk list -``` -{: codeblock} - -Cada app está listada y la API se validará si está establecida la variable de entorno `OPENAPI_SPEC`. En la columna `VALID`, verá una marca de selección verde o una `X` roja. Una marca de selección en la columna `VALID` para la aplicación significa que hay una definición de Open API válida. Una `X` en la columna `VALID` para la aplicación significa una de dos cosas: - -* una variable de entorno `OPENAPI_SPEC` no está definida para su aplicación O -* la definición de la API no es válida con respecto a la especificación de Open API - -Utilice el siguiente mandato para ver el URL completamente formado para la API. Se lista la ruta y el URI completamente formados en la especificación de la API. Puede ver la especificación sin procesar en un navegador, consumirla directamente en la CLI, o verificar que la variable de entorno de `OPENAPI_SPEC` de BFF se haya establecido correctamente. - -``` -bluemix sdk list --url -``` -{: codeblock} - -Utilice el siguiente mandato para validar el archivo de definición de Open API del `` para determinar si se puede utilizar para generar un SDK. El mandato busca `` en el espacio actual y utiliza la vía de acceso relativa en la variable de entorno `OPENAPI_SPEC` para localizar la especificación para la validación. - -``` -bluemix sdk validate -``` -{: codeblock} - -Utilice el siguiente mandato para generar un SDK para la `` nativa que elija y coloque un archivo comprimido en el directorio de trabajo actual. - -``` -bluemix sdk generate -- -``` -{: codeblock} - -El uso de la opción `--unzip` extraerá automáticamente el SDK en el directorio de trabajo actual. Opcionalmente, puede especificar la ubicación en la que se extraerá el SDK utilizando la opción `--output`. Puede gestionar su código fuente con GitHub y crear una rama nueva específicamente para actualizar el SDK. El uso de este enfoque facilita la visualización de los cambios y la fusión en el SDK actualizado en la rama de desarrollo. - - -## Cómo trabajar con modelos generados por SDK y API -{: #models-apis} - -Ahora que BFF está integrado en la app móvil utilizando un SDK generado, puede empezar a trabajar con él. - -El SDK se proporciona con documentación totalmente generada en los directorios `docs` y `source`. Puede abrir el archivo `README.html` para una vista web de los documentos o puede abrir el archivo `README.md` para una vista Markdown de los documentos. Los documentos de Markdown son útiles al publicar el SDK en Cocoapods o en Maven Central. - -En la documentación, podrá ver una lista de API generadas. Puede pulsar en la API para ver un fragmento de código que pueda pegar directamente en la app para móvil. +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Cálculo +{: #compute} + +Al crear una aplicación de canal digital nativo de la nube para móvil y mobile, la práctica recomendada es tener un BFF (Backend for Frontend, Programa de fondo para programa de usuario) que esté dedicado a su canal digital o que ofrezca el mismo soporte de integración lógica y de datos para las apps de clientes móviles y web. Para obtener más información sobre esta arquitectura, consulte [Microservicios para web y móvil ![icono de enlace externo](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture). + +El siguiente diagrama muestra una visión general de la arquitectura de BFF. + +![Arquitectura de BFF](images/bff-arch.png) + +Figura 1: Arquitectura de BFF + +El concepto de un BFF es omitir la lógica empresarial y de integración común de los servicios en la nube de {{site.data.keyword.Bluemix}} de microservicios o de alto valor. + +Con esta arquitectura, puede desplegar y lanzar actualizaciones en su aplicación Web o móvil y desplegar versiones nuevas de su BFF utilizando Delivery Pipelines continuos con el servicio de devops. + +Si tiene un BFF para iOS y un BFF independiente para Android, los equipos de ingeniería que entregan la función para estas apps no se restringen a características de release mediante una planificación de release de API centralizada. Este es un objetivo común para las arquitecturas de canal digital y de microservicio: permitir a los equipos que lancen funciones y características con frecuencia, sin estar completamente ligados a la planificación de release de otro equipo. + + + + +## Integración de un cliente móvil con un Programa de fondo para programa de usuario +{: #integration} + +Para habilitar la integración sencilla entre un cliente móvil y un BFF, {{site.data.keyword.Bluemix_notm}} da soporte a la generación de SDK del cliente móvil para iOS y Android en los lenguajes Swift y Java, respectivamente. Para habilitar esta característica, debe exponer la integración de BFF con un documento de especificación de Open API (Swagger). Este documento puede estar en la forma de JSON o YAML. + +El generador de SDK del cliente utiliza el archivo de definición de Open API para definir un SDK de desarrollador optimizado por el cliente que sea sencillo de consumir en la aplicación móvil nativa. Acelerará la integración del BFF en la aplicación móvil. + + +## Definición de una API +{: #definition} + +El BFF debe exponer un archivo de definición de API que se ajuste a la especificación de Open API que se está ejecutando en un punto final de servidor activo. Para habilitar la Experiencia de desarrollador de {{site.data.keyword.Bluemix_notm}} y la CLI (Command Line Interface, Interfaz de línea de mandatos) de SDK de {{site.data.keyword.Bluemix_notm}} para descubrir este punto final, debe añadir una variable de entorno a la aplicación de Cloud Foundry denominada `OPENAPI_SPEC`. Esta variable de entorno debe hacer referencia a la especificación utilizando una vía de acceso relativa. + +Para añadir la variable de entorno `OPENAPI_SPEC` en {{site.data.keyword.Bluemix_notm}}, siga estos pasos: + +1. Inicie sesión en [{{site.data.keyword.Bluemix_notm}} ![icono de enlace externo](../icons/launch-glyph.svg)](http://bluemix.net). +2. Seleccione una app de Cloud Foundry. +3. Seleccione **Tiempo de ejecución**. +4. Seleccione **Variables de entorno**. +5. Pulse **Añadir** en la sección **Definido por el usuario**. +6. Especifique `OPENAPI_SPEC` para **NAME** y una vía de acceso de URL relativo en su archivo de definición de Open API. +7. Pulse **Guardar**. + + + +Por ejemplo: + +``` +OPENAPI_SPEC='/explorer/swagger.json' +``` +{: codeblock} + +{{site.data.keyword.apiconnect_long}} y las aplicaciones Loopback funcionan particularmente bien utilizando este enfoque. Puede utilizar Loopback y {{site.data.keyword.apiconnect_short}} para definir un modelo persistente y exponer la operación CRUD (Create, Read, Update, and Delete - crear, recuperar, actualizar y suprimir) mediante el archivo de definición de Open API. + +También puede definir operaciones de lógica empresarial. + + +### Elementos soportados de la especificación de Open API +{: #supported-elements notoc} + +La única parte de la especificación de Open API que no está completamente soportada en la estructura de archivos. La especificación permite que se dividan partes de la definición en distintos archivos y que se haga referencia a ellas mediante el archivo `$ref` de json. Toda su definición debe estar contenida en un único archivo. + + +## Programa de fondo para programa de usuario de ejemplo utilizando Bluegen +{: #bff-bluegen} + +{{site.data.keyword.Bluemix_notm}} ha creado un BFF de referencia utilizando {{site.data.keyword.apiconnect_short}} y Strongloop, que correlaciona un modelo de producto en un {{site.data.keyword.cloudant}} y una API de imagen para hacer referencia a imágenes en {{site.data.keyword.objectstorageshort}}. + +Puede utilizar este patrón de BFF para iniciarse rápidamente con el suministro de un BFF que funcione completamente en {{site.data.keyword.Bluemix_notm}} y utilizarlo para ayudar a comprender la facilidad con que se integra un BFF en un proyecto móvil y se generan SDK nativos para iOS y Android en Swift y Java, respectivamente. + +Siga las instrucciones de [README ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) para crear un proyecto e instalarlo. + + +## Uso de Programa de fondo para programa de usuario con un proyecto de experiencia de desarrollador +{: #bff-devex} + +La experiencia de desarrollador móvil de {{site.data.keyword.Bluemix_notm}} está diseñada para simplificar la definición de un proyecto móvil con varios servicios en la nube asociados. Puede añadir de forma sencilla [{{site.data.keyword.mobilepushshort}} ![icono de enlace externo](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [Analytics ![icono de enlace externo](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html), y servicios de Datos o Almacenamiento. + +La {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} ha introducido la capacidad de integrar un BFF en un proyecto móvil en la página **Cálculo**. Puede añadir instancias de servicio de Cálculo existentes en su proyecto móvil. Una vez que se añadan, puede generar un SDK nativo para su elección de idioma o puede generar el proyecto completo y el SDK se integrará en el paquete de origen del proyecto en la página **Código**. Esto es particularmente útil cuando se integra con BFF que ya están bien definidas. + +Una vez que haya descargado el proyecto, podrá abrirlo con Xcode o Android Studio y compilar el proyecto con el SDK de cliente. + + +## Utilización de la CLI +{: #cli} + +A medida que desarrolle su BFF, la especificación de la API podría cambiar. Para admitir estos cambios, tiene las dos siguientes opciones. + +* Volver a generar todo el proyecto en una rama nueva de GitHub y fusionar los cambios en la rama de desarrollo. +* Volver a generar el SDK directamente utilizando la herramienta de línea de mandatos (CLI) y actualizar sólo la parte del SDK del proyecto móvil. + +Para utilizar la CLI, debe [instalarla](sdk_cli.html#installation). + +Utilice el siguiente mandato para listar las acciones que puede realizar. + +``` +bluemix sdk +``` +{: codeblock} + +Utilice el siguiente mandato para listar las instancias de Cloud Foundry en ejecución en el espacio actual de {{site.data.keyword.Bluemix_notm}}. + +``` +bluemix sdk list +``` +{: codeblock} + +Cada app está listada y la API se validará si está establecida la variable de entorno `OPENAPI_SPEC`. En la columna `VALID`, verá una marca de selección verde o una `X` roja. Una marca de selección en la columna `VALID` para la aplicación significa que hay una definición de Open API válida. Una `X` en la columna `VALID` para la aplicación significa una de dos cosas: + +* una variable de entorno `OPENAPI_SPEC` no está definida para su aplicación O +* la definición de la API no es válida con respecto a la especificación de Open API + +Utilice el siguiente mandato para ver el URL completamente formado para la API. Se lista la ruta y el URI completamente formados en la especificación de la API. Puede ver la especificación sin procesar en un navegador, consumirla directamente en la CLI, o verificar que la variable de entorno de `OPENAPI_SPEC` de BFF se haya establecido correctamente. + +``` +bluemix sdk list --url +``` +{: codeblock} + +Utilice el siguiente mandato para validar el archivo de definición de Open API del `` para determinar si se puede utilizar para generar un SDK. El mandato busca `` en el espacio actual y utiliza la vía de acceso relativa en la variable de entorno `OPENAPI_SPEC` para localizar la especificación para la validación. + +``` +bluemix sdk validate +``` +{: codeblock} + +Utilice el siguiente mandato para generar un SDK para la `` nativa que elija y coloque un archivo comprimido en el directorio de trabajo actual. + +``` +bluemix sdk generate -- +``` +{: codeblock} + +El uso de la opción `--unzip` extraerá automáticamente el SDK en el directorio de trabajo actual. Opcionalmente, puede especificar la ubicación en la que se extraerá el SDK utilizando la opción `--output`. Puede gestionar su código fuente con GitHub y crear una rama nueva específicamente para actualizar el SDK. El uso de este enfoque facilita la visualización de los cambios y la fusión en el SDK actualizado en la rama de desarrollo. + + +## Cómo trabajar con modelos generados por SDK y API +{: #models-apis} + +Ahora que BFF está integrado en la app móvil utilizando un SDK generado, puede empezar a trabajar con él. + +El SDK se proporciona con documentación totalmente generada en los directorios `docs` y `source`. Puede abrir el archivo `README.html` para una vista web de los documentos o puede abrir el archivo `README.md` para una vista Markdown de los documentos. Los documentos de Markdown son útiles al publicar el SDK en Cocoapods o en Maven Central. + +En la documentación, podrá ver una lista de API generadas. Puede pulsar en la API para ver un fragmento de código que pueda pegar directamente en la app para móvil. diff --git a/cloudnative/nl/es/dev_cli.md b/cloudnative/nl/es/dev_cli.md index 9bb56e353..e2d3eca51 100644 --- a/cloudnative/nl/es/dev_cli.md +++ b/cloudnative/nl/es/dev_cli.md @@ -1,404 +1,404 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.dev_cli_short}} -{: #developercli} - -El {{site.data.keyword.dev_cli_long}} proporciona un enfoque basado en mandatos extensibles para crear, desarrollar y desplegar un proyecto web con el plugin `dev`. Ideal para desarrolladores que prefieren utilizar el control de línea de mandatos para desarrollar aplicaciones de microservicios completas. - -{: shortdesc} - -El {{site.data.keyword.dev_cli_notm}} utiliza dos contenedores para facilitar la creación y la realización de pruebas de su aplicación. El primero es el contenedor de herramientas que contiene las utilidades necesarias para crear y probar la aplicación. El Dockerfile para este contenedor está definido por el parámetro [dockerfile-tools](#command-parameters). Puede considerarlo como un contenedor de desarrollo, ya que contiene las herramientas que suelen utilizarse para el desarrollo de un tiempo de ejecución determinado. - -El segundo contenedor es el contenedor de ejecución. El formato de este contenedor es adecuado para desplegarlo y utilizarlo en, por ejemplo, {{site.data.keyword.Bluemix}}. Como resultado, este contenedor normalmente tendrá un punto de entrada definido que inicia su aplicación. Al seleccionar ejecutar la aplicación a través de {{site.data.keyword.dev_cli_short}}, utiliza este contenedor. El Dockerfile para este contenedor está definido por el parámetro [dockerfile-run](#run-parameters). - - -## Adición de {{site.data.keyword.dev_cli_notm}} -{: #add-cli} - - -### Requisitos previos -{: #prereq} - -Se exigen algunos requisitos previos para explorar completamente y utilizar correctamente el {{site.data.keyword.dev_cli_short}}, ya que es muy ampliable y le permite utilizar tecnologías complementarias adicionales. - -1. Instale [Cloud Foundry CLI ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://github.com/cloudfoundry/cli#getting-started). - -2. Instale la [CLI de {{site.data.keyword.Bluemix}} ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://clis.ng.bluemix.net/ui/home.html). - -3. Obtenga un [ID de {{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net). - -4. Opcional: Si planea ejecutar y depurar aplicaciones a nivel local, deberá instalar también [Docker ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://www.docker.com/get-docker). Esto solo es necesario para proyectos que no sean móviles. - - -### Instalación -{: #installation} - -1. Instale el [{{site.data.keyword.dev_cli_short}} ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} ejecutando el siguiente mandato: - - ``` - bx plugin install dev -r Bluemix - ``` - {: codeblock} - -2. Valide la correcta instalación ejecutando el siguiente mandato: - - ``` - bx dev - ``` - {: codeblock} - - -### Antes de empezar -{: #before-install} - -1. Inicie sesión en {{site.data.keyword.Bluemix_notm}}. - - ``` - bx login - ``` - {: codeblock} - - **Nota:** si se rechazan sus credenciales, puede que esté utilizando un ID federado. Siga estos pasos para autenticarse mediante un ID federado. - - - - 1. Inicie sesión en [{{site.data.keyword.iamshort}} ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://www.bluemix.net/iam/#/apikeys){: new_window}. - 2. Seleccione **Crear clave de API**. - * Especifique un nombre y descripción para la clave de API - 3. Descargue su clave de API. - 4. Abra el archivo y copie el valor del campo `apiKey`. - 5. Inicie sesión utilizando el siguiente mandato: - - ``` - bx login --apikey - ``` - {: codeblock} - - -## Mandatos -{: #commands} - -Utilice los siguientes mandatos para crear un proyecto, desplegarlo, depurarlo y probarlo. - -### Build -{: #build} - -Puede crear su aplicación mediante el mandato `build`. El elemento de configuración `build-cmd-run` se utiliza para crear la aplicación. Los mandatos `test`, `debug` y `run` ejecutan una compilación del mismo modo que este mandato como parte de su funcionamiento normal, por lo que no es necesario ejecutar este mandato antes que estos. - -Ejecute el siguiente mandato en el directorio del proyecto actual para crear la aplicación: - -``` -bx dev build -``` -{: codeblock} - - -[Parámetros del mandato de compilación](#command-parameters) - - -### Code -{: #code} - -El mandato `code` le permite descargar el código de aplicación después del despliegue, para que pueda revisar de forma local o realizar cambios adicionales. - -Ejecute el siguiente mandato para descargar el código de un proyecto específico. - -``` -bx dev code -``` -{: codeblock} - - -### Create -{: #create} - -Cree un proyecto nuevo, solicitando toda la información necesaria, incluyendo el idioma, el nombre del proyecto y el tipo de patrón de aplicación. El proyecto se creará en el directorio actual. - -Para crear un proyecto nuevo en el directorio del proyecto actual y asociarle servicios, ejecute el siguiente mandato: - -``` -bx dev create -``` -{: codeblock} - - -### Debug -{: #debug} - -Puede depurar la aplicación a través del mandato `debug`. Primero se completa una compilación contra el proyecto utilizando el elemento de configuración `build-cmd-debug` como la instrucción de compilación. A continuación, se inicia un contenedor que expone un puerto o puertos de depuración tal y como se define en `container-port-map-debug`. Conecte su herramienta de depuración preferida al puerto o puertos y podrá depurar su aplicación de modo normal. - -**Limitación**: actualmente los proyectos Swift no están disponibles para depuración. - -Ejecute el siguiente mandato en el directorio del proyecto actual para depurar la aplicación: - -``` -bx dev debug -``` -{: codeblock} - -Para salir de la sesión de depuración, utilice `CTRL-C`. - - -#### Parámetros del mandato de depuración -{: #debug-parameters} - -Los siguientes parámetros son exclusivos del mandato `debug` y ayudan a depurar una aplicación. - -##### `container-port-map-debug` -{: #port-map-debug} - -* Correlaciones de puertos para el puerto de depuración. El primer valor es el puerto que se utilizará en el sistema operativo del host, el segundo es el puerto del contenedor (host:container). -* Uso: `bx dev debug container-port-map-debug [7777:7777]` - -##### `build-cmd-debug` -{: #build-cmd-debug} - -* Utilizado para generar código para DEBUG. -* Uso: `bx dev debug build-cmd-debug build.command.sh` - -##### `debug-cmd` -{: #debug-cmd} - -* Utilizado para depurar código en el contenedor de herramientas. Esto es opcional si su `build-cmd-debug` iniciará la aplicación en depuración. -* Uso: `bx dev debug debug-cmd /the/debug/command` - -#### Depuración de aplicaciones locales: -{: #local-app-dev} - -Para obtener más información sobre la depuración de aplicaciones locales, consulte [Depuración de aplicaciones locales](docs/cloudnative/dev_cli_local_debug.html#local-debug). - - -### Delete -{: #delete} - -Este mandato le permite eliminar proyectos de su espacio {{site.data.keyword.Bluemix}}. - -Ejecute el siguiente mandato para suprimir su proyecto de {{site.data.keyword.Bluemix}}: - -``` -bx dev delete -``` -{: codeblock} - - -**Nota** los servicios {{site.data.keyword.Bluemix}} **no** se eliminan. - - -### Help -{: #help} - -De forma predeterminada, si no se pasa ninguna acción ni argumento, o si se proporciona la acción 'help', este mandato mostrará un texto "Help" general. La ayuda general mostrada incluye una descripción de los argumentos base, así como una lista de las acciones disponibles. - -Ejecute el siguiente mandato para visualizar la información de ayuda general: - -``` -bx dev help -``` -{: codeblock} - - -### List -{: #list} - -Puede listar todos sus proyectos {{site.data.keyword.Bluemix_notm}} en un espacio. - -Ejecute el siguiente mandato para listar sus proyectos: - -``` -bx dev list -``` -{: codeblock} - - - - - -### Run -{: #run} - -Puede ejecutar la aplicación mediante el mandato `run`. Primero se completa una compilación contra el proyecto utilizando el elemento de configuración `build-cmd-run` como la instrucción de compilación. A continuación, se inicia el contenedor de ejecución y expone los puertos tal y como se define en `container-port-map`. `run-cmd` se puede utilizar para invocar la aplicación si el contenedor de ejecución no contiene un punto de entrada para completar este paso. - -Ejecute el siguiente mandato en el directorio del proyecto actual para iniciar la aplicación: - -``` -bx dev run -``` -{: codeblock} - -Para salir de la sesión, utilice `CTRL-C`. - - -#### Parámetros de ejecución -{: #run-parameters} - -Los siguientes parámetros son exclusivos del mandato `run` y ayudan a gestionar la aplicación dentro del contenedor de ejecución. - -##### `container-name-run` -{: #container-name-run} - -* Nombre del contenedor para el contenedor de ejecución. -* Uso: `bx dev run container-name-run ` - -##### `container-path-run` -{: #container-path-run} - -* Ubicación en el contenedor para compartir en ejecución. -* Uso: `bx dev run container-path-run [/path/to/app]` - -##### `host-path-run` -{: #host-path-run} - -* Ubicación en el sistema host para compartir en el contenedor en ejecución. -* Uso: `bx dev run host-path-run [/path/to/app/bin]` - -##### `dockerfile-run` -{: #dockerfile-run} - -* Archivo Docker para el contenedor en ejecución. -* Uso: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` - -##### `image-name-run` -{: #image-name-run} - -* Imagen para crear desde dockerfile-run. -* Uso: `bx dev run image-name-run [/path/to/image-name]` - -##### `run-cmd` -{: #run-cmd} - -* Parámetro opcional utilizado para ejecutar código en el contenedor de ejecución. Este es opcional si su imagen iniciará la aplicación. -* Uso: `bx dev run run-cmd [/the/run/command]` - -### Status -{: #status} - -Puede consultar el estado de los contenedores utilizados por {{site.data.keyword.dev_cli_short}} tal y como se definen en `container-name-run` y `container-name-tools`. - -Ejecute el siguiente mandato en el directorio del proyecto actual para comprobar el estado de los contenedores: - -``` -bx dev status -``` -{: codeblock} - - -[Parámetros del mandato de estado](#command-parameters) - - -### Stop -{: #stop} - -Puede detener un contenedor mediante el mandato `stop`. El parámetro `container-name` le permite especificar el contenedor que se debe detener. Si no se especifica, el mandato stop detiene el contenedor de ejecución definido por `container-name-run`. - -Ejecute el siguiente mandato en el directorio del proyecto actual para detener un contenedor: - -``` -bx dev stop -``` -{: codeblock} - - -#### Parámetro de detención adicional: -{: #stop-parameter} - -##### `container-name` -{: #container-name} - -* Nombre del contenedor para el contenedor de herramientas. -* Uso: `bx dev stop container-name ` - -### Test -{: #test} - -Puede probar la aplicación a través del mandato `test`. Primero se completa una compilación contra el proyecto utilizando el elemento de configuración `build-cmd-run` como la instrucción de compilación. A continuación, el contenedor de herramientas se utiliza para invocar `test-cmd` para la aplicación. - -Ejecute el siguiente mandato para probar la aplicación: - -``` -bx dev test -``` -{: codeblock} - - -[Parámetros del mandato de prueba](#command-parameters) - - -## Parámetros para crear, depurar, ejecutar y probar -{: #command-parameters} - -Los siguientes parámetros se pueden utilizar junto con los mandatos `build|debug|run|test` y se pueden especificar a través de línea de mandatos y/o actualizando directamente el archivo `cli-config.yml` del proyecto. Hay disponibles parámetros adicionales para los mandatos [`debug`](#debug-parameters) y [`run`](#run-parameters), y están documentados en sus respectivos apartados. - -**Nota**: los parámetros de mandato especificados en la línea de mandatos tienen prioridad sobre la configuración `cli-config.yml`. - -##### `container-name-tools` -{: #container-name-tools} - -* Nombre del contenedor para el contenedor de herramientas. -* Uso: `bx dev container-name-tools []` - -##### `host-path-tools` -{: #host-path-tools} - -* Ubicación en el host para compartir para la compilación, depuración, pruebas. -* Uso: `bx dev host-path-tools [/path/to/build/tools]` - -##### `container-path-tools` -{: #container-path-tools} - -* Ubicación en el contenedor para compartir para la compilación, depuración, pruebas. -* Uso: `bx dev container-path-tools [/path/for/build]` - -##### `container-port-map` -{: #container-port-map} - -* Correlaciones de puertos para el contenedor. El primer valor es el puerto que se utilizará en el sistema operativo del host, el segundo es el puerto del contenedor (host:container). -* Uso: `bx dev container-port-map [8090:8090,9090,9090]` - -##### `dockerfile-tools` -{: #dockerfile-tools} - -* Archivo Docker para el contenedor de herramientas. -* Uso: `bx dev dockerfile-tools [path/to/dockerfile]` - -##### `image-name-tools` -{: #image-name-tools} - -* Imagen para crear desde dockerfile-tools. -* Uso: `bx dev image-name-tools [path/to/image-name]` - -##### `build-cmd-run` -{: #build-cmd-run} - -* Mandato para generar código para todos los usos menos DEBUG. -* Uso: `bx dev build-cmd-run [some.build.command]` - -##### `test-cmd` -{: #test-cmd} - -* Mandato para probar código en el contenedor de herramientas. -* Uso: `bx dev test-cmd [/the/test/command]` - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.dev_cli_short}} +{: #developercli} + +El {{site.data.keyword.dev_cli_long}} proporciona un enfoque basado en mandatos extensibles para crear, desarrollar y desplegar un proyecto web con el plugin `dev`. Ideal para desarrolladores que prefieren utilizar el control de línea de mandatos para desarrollar aplicaciones de microservicios completas. + +{: shortdesc} + +El {{site.data.keyword.dev_cli_notm}} utiliza dos contenedores para facilitar la creación y la realización de pruebas de su aplicación. El primero es el contenedor de herramientas que contiene las utilidades necesarias para crear y probar la aplicación. El Dockerfile para este contenedor está definido por el parámetro [dockerfile-tools](#command-parameters). Puede considerarlo como un contenedor de desarrollo, ya que contiene las herramientas que suelen utilizarse para el desarrollo de un tiempo de ejecución determinado. + +El segundo contenedor es el contenedor de ejecución. El formato de este contenedor es adecuado para desplegarlo y utilizarlo en, por ejemplo, {{site.data.keyword.Bluemix}}. Como resultado, este contenedor normalmente tendrá un punto de entrada definido que inicia su aplicación. Al seleccionar ejecutar la aplicación a través de {{site.data.keyword.dev_cli_short}}, utiliza este contenedor. El Dockerfile para este contenedor está definido por el parámetro [dockerfile-run](#run-parameters). + + +## Adición de {{site.data.keyword.dev_cli_notm}} +{: #add-cli} + + +### Requisitos previos +{: #prereq} + +Se exigen algunos requisitos previos para explorar completamente y utilizar correctamente el {{site.data.keyword.dev_cli_short}}, ya que es muy ampliable y le permite utilizar tecnologías complementarias adicionales. + +1. Instale [Cloud Foundry CLI ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://github.com/cloudfoundry/cli#getting-started). + +2. Instale la [CLI de {{site.data.keyword.Bluemix}} ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://clis.ng.bluemix.net/ui/home.html). + +3. Obtenga un [ID de {{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net). + +4. Opcional: Si planea ejecutar y depurar aplicaciones a nivel local, deberá instalar también [Docker ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://www.docker.com/get-docker). Esto solo es necesario para proyectos que no sean móviles. + + +### Instalación +{: #installation} + +1. Instale el [{{site.data.keyword.dev_cli_short}} ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} ejecutando el siguiente mandato: + + ``` + bx plugin install dev -r Bluemix + ``` + {: codeblock} + +2. Valide la correcta instalación ejecutando el siguiente mandato: + + ``` + bx dev + ``` + {: codeblock} + + +### Antes de empezar +{: #before-install} + +1. Inicie sesión en {{site.data.keyword.Bluemix_notm}}. + + ``` + bx login + ``` + {: codeblock} + + **Nota:** si se rechazan sus credenciales, puede que esté utilizando un ID federado. Siga estos pasos para autenticarse mediante un ID federado. + + + + 1. Inicie sesión en [{{site.data.keyword.iamshort}} ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://www.bluemix.net/iam/#/apikeys){: new_window}. + 2. Seleccione **Crear clave de API**. + * Especifique un nombre y descripción para la clave de API + 3. Descargue su clave de API. + 4. Abra el archivo y copie el valor del campo `apiKey`. + 5. Inicie sesión utilizando el siguiente mandato: + + ``` + bx login --apikey + ``` + {: codeblock} + + +## Mandatos +{: #commands} + +Utilice los siguientes mandatos para crear un proyecto, desplegarlo, depurarlo y probarlo. + +### Build +{: #build} + +Puede crear su aplicación mediante el mandato `build`. El elemento de configuración `build-cmd-run` se utiliza para crear la aplicación. Los mandatos `test`, `debug` y `run` ejecutan una compilación del mismo modo que este mandato como parte de su funcionamiento normal, por lo que no es necesario ejecutar este mandato antes que estos. + +Ejecute el siguiente mandato en el directorio del proyecto actual para crear la aplicación: + +``` +bx dev build +``` +{: codeblock} + + +[Parámetros del mandato de compilación](#command-parameters) + + +### Code +{: #code} + +El mandato `code` le permite descargar el código de aplicación después del despliegue, para que pueda revisar de forma local o realizar cambios adicionales. + +Ejecute el siguiente mandato para descargar el código de un proyecto específico. + +``` +bx dev code +``` +{: codeblock} + + +### Create +{: #create} + +Cree un proyecto nuevo, solicitando toda la información necesaria, incluyendo el idioma, el nombre del proyecto y el tipo de patrón de aplicación. El proyecto se creará en el directorio actual. + +Para crear un proyecto nuevo en el directorio del proyecto actual y asociarle servicios, ejecute el siguiente mandato: + +``` +bx dev create +``` +{: codeblock} + + +### Debug +{: #debug} + +Puede depurar la aplicación a través del mandato `debug`. Primero se completa una compilación contra el proyecto utilizando el elemento de configuración `build-cmd-debug` como la instrucción de compilación. A continuación, se inicia un contenedor que expone un puerto o puertos de depuración tal y como se define en `container-port-map-debug`. Conecte su herramienta de depuración preferida al puerto o puertos y podrá depurar su aplicación de modo normal. + +**Limitación**: actualmente los proyectos Swift no están disponibles para depuración. + +Ejecute el siguiente mandato en el directorio del proyecto actual para depurar la aplicación: + +``` +bx dev debug +``` +{: codeblock} + +Para salir de la sesión de depuración, utilice `CTRL-C`. + + +#### Parámetros del mandato de depuración +{: #debug-parameters} + +Los siguientes parámetros son exclusivos del mandato `debug` y ayudan a depurar una aplicación. + +##### `container-port-map-debug` +{: #port-map-debug} + +* Correlaciones de puertos para el puerto de depuración. El primer valor es el puerto que se utilizará en el sistema operativo del host, el segundo es el puerto del contenedor (host:container). +* Uso: `bx dev debug container-port-map-debug [7777:7777]` + +##### `build-cmd-debug` +{: #build-cmd-debug} + +* Utilizado para generar código para DEBUG. +* Uso: `bx dev debug build-cmd-debug build.command.sh` + +##### `debug-cmd` +{: #debug-cmd} + +* Utilizado para depurar código en el contenedor de herramientas. Esto es opcional si su `build-cmd-debug` iniciará la aplicación en depuración. +* Uso: `bx dev debug debug-cmd /the/debug/command` + +#### Depuración de aplicaciones locales: +{: #local-app-dev} + +Para obtener más información sobre la depuración de aplicaciones locales, consulte [Depuración de aplicaciones locales](docs/cloudnative/dev_cli_local_debug.html#local-debug). + + +### Delete +{: #delete} + +Este mandato le permite eliminar proyectos de su espacio {{site.data.keyword.Bluemix}}. + +Ejecute el siguiente mandato para suprimir su proyecto de {{site.data.keyword.Bluemix}}: + +``` +bx dev delete +``` +{: codeblock} + + +**Nota** los servicios {{site.data.keyword.Bluemix}} **no** se eliminan. + + +### Help +{: #help} + +De forma predeterminada, si no se pasa ninguna acción ni argumento, o si se proporciona la acción 'help', este mandato mostrará un texto "Help" general. La ayuda general mostrada incluye una descripción de los argumentos base, así como una lista de las acciones disponibles. + +Ejecute el siguiente mandato para visualizar la información de ayuda general: + +``` +bx dev help +``` +{: codeblock} + + +### List +{: #list} + +Puede listar todos sus proyectos {{site.data.keyword.Bluemix_notm}} en un espacio. + +Ejecute el siguiente mandato para listar sus proyectos: + +``` +bx dev list +``` +{: codeblock} + + + + + +### Run +{: #run} + +Puede ejecutar la aplicación mediante el mandato `run`. Primero se completa una compilación contra el proyecto utilizando el elemento de configuración `build-cmd-run` como la instrucción de compilación. A continuación, se inicia el contenedor de ejecución y expone los puertos tal y como se define en `container-port-map`. `run-cmd` se puede utilizar para invocar la aplicación si el contenedor de ejecución no contiene un punto de entrada para completar este paso. + +Ejecute el siguiente mandato en el directorio del proyecto actual para iniciar la aplicación: + +``` +bx dev run +``` +{: codeblock} + +Para salir de la sesión, utilice `CTRL-C`. + + +#### Parámetros de ejecución +{: #run-parameters} + +Los siguientes parámetros son exclusivos del mandato `run` y ayudan a gestionar la aplicación dentro del contenedor de ejecución. + +##### `container-name-run` +{: #container-name-run} + +* Nombre del contenedor para el contenedor de ejecución. +* Uso: `bx dev run container-name-run ` + +##### `container-path-run` +{: #container-path-run} + +* Ubicación en el contenedor para compartir en ejecución. +* Uso: `bx dev run container-path-run [/path/to/app]` + +##### `host-path-run` +{: #host-path-run} + +* Ubicación en el sistema host para compartir en el contenedor en ejecución. +* Uso: `bx dev run host-path-run [/path/to/app/bin]` + +##### `dockerfile-run` +{: #dockerfile-run} + +* Archivo Docker para el contenedor en ejecución. +* Uso: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` + +##### `image-name-run` +{: #image-name-run} + +* Imagen para crear desde dockerfile-run. +* Uso: `bx dev run image-name-run [/path/to/image-name]` + +##### `run-cmd` +{: #run-cmd} + +* Parámetro opcional utilizado para ejecutar código en el contenedor de ejecución. Este es opcional si su imagen iniciará la aplicación. +* Uso: `bx dev run run-cmd [/the/run/command]` + +### Status +{: #status} + +Puede consultar el estado de los contenedores utilizados por {{site.data.keyword.dev_cli_short}} tal y como se definen en `container-name-run` y `container-name-tools`. + +Ejecute el siguiente mandato en el directorio del proyecto actual para comprobar el estado de los contenedores: + +``` +bx dev status +``` +{: codeblock} + + +[Parámetros del mandato de estado](#command-parameters) + + +### Stop +{: #stop} + +Puede detener un contenedor mediante el mandato `stop`. El parámetro `container-name` le permite especificar el contenedor que se debe detener. Si no se especifica, el mandato stop detiene el contenedor de ejecución definido por `container-name-run`. + +Ejecute el siguiente mandato en el directorio del proyecto actual para detener un contenedor: + +``` +bx dev stop +``` +{: codeblock} + + +#### Parámetro de detención adicional: +{: #stop-parameter} + +##### `container-name` +{: #container-name} + +* Nombre del contenedor para el contenedor de herramientas. +* Uso: `bx dev stop container-name ` + +### Test +{: #test} + +Puede probar la aplicación a través del mandato `test`. Primero se completa una compilación contra el proyecto utilizando el elemento de configuración `build-cmd-run` como la instrucción de compilación. A continuación, el contenedor de herramientas se utiliza para invocar `test-cmd` para la aplicación. + +Ejecute el siguiente mandato para probar la aplicación: + +``` +bx dev test +``` +{: codeblock} + + +[Parámetros del mandato de prueba](#command-parameters) + + +## Parámetros para crear, depurar, ejecutar y probar +{: #command-parameters} + +Los siguientes parámetros se pueden utilizar junto con los mandatos `build|debug|run|test` y se pueden especificar a través de línea de mandatos y/o actualizando directamente el archivo `cli-config.yml` del proyecto. Hay disponibles parámetros adicionales para los mandatos [`debug`](#debug-parameters) y [`run`](#run-parameters), y están documentados en sus respectivos apartados. + +**Nota**: los parámetros de mandato especificados en la línea de mandatos tienen prioridad sobre la configuración `cli-config.yml`. + +##### `container-name-tools` +{: #container-name-tools} + +* Nombre del contenedor para el contenedor de herramientas. +* Uso: `bx dev container-name-tools []` + +##### `host-path-tools` +{: #host-path-tools} + +* Ubicación en el host para compartir para la compilación, depuración, pruebas. +* Uso: `bx dev host-path-tools [/path/to/build/tools]` + +##### `container-path-tools` +{: #container-path-tools} + +* Ubicación en el contenedor para compartir para la compilación, depuración, pruebas. +* Uso: `bx dev container-path-tools [/path/for/build]` + +##### `container-port-map` +{: #container-port-map} + +* Correlaciones de puertos para el contenedor. El primer valor es el puerto que se utilizará en el sistema operativo del host, el segundo es el puerto del contenedor (host:container). +* Uso: `bx dev container-port-map [8090:8090,9090,9090]` + +##### `dockerfile-tools` +{: #dockerfile-tools} + +* Archivo Docker para el contenedor de herramientas. +* Uso: `bx dev dockerfile-tools [path/to/dockerfile]` + +##### `image-name-tools` +{: #image-name-tools} + +* Imagen para crear desde dockerfile-tools. +* Uso: `bx dev image-name-tools [path/to/image-name]` + +##### `build-cmd-run` +{: #build-cmd-run} + +* Mandato para generar código para todos los usos menos DEBUG. +* Uso: `bx dev build-cmd-run [some.build.command]` + +##### `test-cmd` +{: #test-cmd} + +* Mandato para probar código en el contenedor de herramientas. +* Uso: `bx dev test-cmd [/the/test/command]` + diff --git a/cloudnative/nl/es/dev_cli_local_debug.md b/cloudnative/nl/es/dev_cli_local_debug.md index 658a58cfb..d32005684 100644 --- a/cloudnative/nl/es/dev_cli_local_debug.md +++ b/cloudnative/nl/es/dev_cli_local_debug.md @@ -1,76 +1,76 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Depuración de aplicaciones locales -{: #local-debug} - -Las instrucciones para la depuración de aplicaciones locales se proporcionan a continuación para los siguientes lenguajes: - -* [Java](#java) -* [Node.js](#node) - -**Nota**: actualmente no se soporta la depuración de aplicaciones Swift. - -## Depuración de aplicaciones Java -{: #java} - -Pasos para habilitar la depuración para una aplicación Java: - -1. Desde el directorio raíz del proyecto de aplicación ejecute el siguiente mandato: - - `bx dev debug` - -2. Conexión del depurador a su aplicación: - - * [Eclipse ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) - * [IntelliJ ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) - * [VSCode ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) - * Línea de mandatos JDK: `jdb -attach ` - -## Depuración de aplicaciones Node.js - -{: #node} - -Pasos para habilitar la depuración para una aplicación Node.js: - -1. Desde el directorio raíz del proyecto de aplicación ejecute el siguiente mandato: - - `bx dev debug` - -2. Conexión del depurador a su aplicación: - * [VSCode ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://blog.docker.com/2016/07/live-debugging-docker/). - * [WebStorm ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Depuración de aplicaciones locales +{: #local-debug} + +Las instrucciones para la depuración de aplicaciones locales se proporcionan a continuación para los siguientes lenguajes: + +* [Java](#java) +* [Node.js](#node) + +**Nota**: actualmente no se soporta la depuración de aplicaciones Swift. + +## Depuración de aplicaciones Java +{: #java} + +Pasos para habilitar la depuración para una aplicación Java: + +1. Desde el directorio raíz del proyecto de aplicación ejecute el siguiente mandato: + + `bx dev debug` + +2. Conexión del depurador a su aplicación: + + * [Eclipse ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) + * [IntelliJ ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) + * [VSCode ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) + * Línea de mandatos JDK: `jdb -attach ` + +## Depuración de aplicaciones Node.js + +{: #node} + +Pasos para habilitar la depuración para una aplicación Node.js: + +1. Desde el directorio raíz del proyecto de aplicación ejecute el siguiente mandato: + + `bx dev debug` + +2. Conexión del depurador a su aplicación: + * [VSCode ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://blog.docker.com/2016/07/live-debugging-docker/). + * [WebStorm ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) + + + + + diff --git a/cloudnative/nl/es/devex.md b/cloudnative/nl/es/devex.md index 36063379f..c53a2b848 100644 --- a/cloudnative/nl/es/devex.md +++ b/cloudnative/nl/es/devex.md @@ -1,31 +1,31 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.dev_console}} -{: #devex} - -Para empezar con el [{{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://console.{DomainName}/developer/getting-started), pulse la categoría **Web y móvil** desde la consola de {{site.data.keyword.Bluemix_notm}}. - - -## Guía de inicio -{: getting-started} - -Cree un proyecto en la página **Guía de inicio** pulsando **Crear proyecto**. Se le presentarán las opciones de [patrón](patterns.html), [iniciador](starters.html) y [lenguaje](patterns.html#languages), que le permiten crear la app rápidamente. - -Puede ver y gestionar todos sus proyectos desde un lugar seleccionando la página [Proyectos ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://console.{DomainName}/developer/projects). El proyecto alberga información correspondiente a todas las funciones integradas (y que se pueden integrar) en la app. Si está disponible, puede integrar y gestionar fácilmente los servicios Push, Analytics, Authentication y Data en el proyecto, con más prestaciones para seguir en el futuro próximo. - -La página [Servicios](services.html) muestra una vista operativa de las instancias de servicio existentes. La {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} da soporte a un desarrollador nativo en la nube y un usuario de gestión de aplicaciones nativas en la nube. - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.dev_console}} +{: #devex} + +Para empezar con el [{{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://console.{DomainName}/developer/getting-started), pulse la categoría **Web y móvil** desde la consola de {{site.data.keyword.Bluemix_notm}}. + + +## Guía de inicio +{: getting-started} + +Cree un proyecto en la página **Guía de inicio** pulsando **Crear proyecto**. Se le presentarán las opciones de [patrón](patterns.html), [iniciador](starters.html) y [lenguaje](patterns.html#languages), que le permiten crear la app rápidamente. + +Puede ver y gestionar todos sus proyectos desde un lugar seleccionando la página [Proyectos ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://console.{DomainName}/developer/projects). El proyecto alberga información correspondiente a todas las funciones integradas (y que se pueden integrar) en la app. Si está disponible, puede integrar y gestionar fácilmente los servicios Push, Analytics, Authentication y Data en el proyecto, con más prestaciones para seguir en el futuro próximo. + +La página [Servicios](services.html) muestra una vista operativa de las instancias de servicio existentes. La {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} da soporte a un desarrollador nativo en la nube y un usuario de gestión de aplicaciones nativas en la nube. + + + diff --git a/cloudnative/nl/es/get_code.md b/cloudnative/nl/es/get_code.md index 1121a5976..f8d30bf27 100644 --- a/cloudnative/nl/es/get_code.md +++ b/cloudnative/nl/es/get_code.md @@ -1,80 +1,80 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-18" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# Obtener código -{: #Get_Code} - -Cuando haya completado la configuración del proyecto con las funciones, podrá descargar el código que le permite ejecutarlo. El proyecto descargado está preconfigurado con las dependencias y las credenciales requeridas de SDK para cada función que configure. - -Tendrá que completar las credenciales para servicios que no sean configurables en el proyecto descargado. El archivo `README.md` para el proyecto iniciador contiene instrucciones. Visualice el archivo `README.md` en un visor Markdown para completar la configuración. - -## Herramientas necesarias del desarrollador -{: #prereq-dev-tools} - -Las siguientes herramientas de desarrollador son necesarias cuando trabaja con código generado desde la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}}: - - -### General -{: #general notoc} - -* [Homebrew ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](http://brew.sh/) - * Herramienta de línea de mandatos para ayudar en la instalación de otras herramientas y tiempos de ejecución, como por ejemplo CocoaPods y Carthage, para desarrolladores de Apple. - -* [Docker ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://www.docker.com/get-docker) - * Proyecto de código abierto para ayudar en la ejecución y depuración de aplicaciones en contenedores. Esto solo es necesario para proyectos que no sean móviles. - -### {{site.data.keyword.Bluemix_notm}} -{: #bluemix notoc} - -* Node.js (tiempos de ejecución Node y npm) para ayudar con la ejecución de {{site.data.keyword.apiconnect_short}} Loopback y otras herramientas de {{site.data.keyword.Bluemix_notm}} Productivity. - - Para ejecutar herramientas {{site.data.keyword.apiconnect_short}} de forma local, utilice 5.x: - - ``` - $ brew install Node5 - ``` - -* [Herramientas de CLI de Bluemix ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://clis.ng.bluemix.net/ui/home.html) - - Herramientas de líneas de mandatos para desplegar los tiempos de ejecución de Cloud Foundry desde una interfaz de línea de mandatos con {{site.data.keyword.Bluemix_notm}}. - -* [{{site.data.keyword.dev_cli_notm}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](dev_cli.html) - - Plugin de CLI de {{site.data.keyword.Bluemix_notm}} para crear, probar y desplegar proyectos web y móviles. - -* [Plugin de generador de SDK ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](sdk_cli.html) - - {{site.data.keyword.Bluemix_notm}} Plugin de CLI para generar SDK desde una definición de la API REST compatible con la [Especificación de Open API ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://www.openapis.org/). - -### Android -{: #android notoc} - -* [Android Studio 2.2 o superior ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://developer.android.com/studio) - * Instale el último tiempo de ejecución de [Android 7.0 ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://www.android.com/versions/nougat-7-0/). - -### iOS -{: #ios notoc} - -* [Xcode 8 ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://developer.apple.com/xcode/) (recomendado) - - -* Gestor de dependencia de [CocoaPods ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://cocoapods.org/) para instalar dependencias del SDK de iOS. Utilice la versión más reciente: - - ``` - $ sudo gem install cocoapods --pre - ``` -* [Gestor de dependencias de Carthage ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://github.com/Carthage/Carthage) para instalar los SDK de {{site.data.keyword.watson}} Developer Cloud. - - ``` - $ brew install carthage - ``` +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-18" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# Obtener código +{: #Get_Code} + +Cuando haya completado la configuración del proyecto con las funciones, podrá descargar el código que le permite ejecutarlo. El proyecto descargado está preconfigurado con las dependencias y las credenciales requeridas de SDK para cada función que configure. + +Tendrá que completar las credenciales para servicios que no sean configurables en el proyecto descargado. El archivo `README.md` para el proyecto iniciador contiene instrucciones. Visualice el archivo `README.md` en un visor Markdown para completar la configuración. + +## Herramientas necesarias del desarrollador +{: #prereq-dev-tools} + +Las siguientes herramientas de desarrollador son necesarias cuando trabaja con código generado desde la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}}: + + +### General +{: #general notoc} + +* [Homebrew ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](http://brew.sh/) + * Herramienta de línea de mandatos para ayudar en la instalación de otras herramientas y tiempos de ejecución, como por ejemplo CocoaPods y Carthage, para desarrolladores de Apple. + +* [Docker ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://www.docker.com/get-docker) + * Proyecto de código abierto para ayudar en la ejecución y depuración de aplicaciones en contenedores. Esto solo es necesario para proyectos que no sean móviles. + +### {{site.data.keyword.Bluemix_notm}} +{: #bluemix notoc} + +* Node.js (tiempos de ejecución Node y npm) para ayudar con la ejecución de {{site.data.keyword.apiconnect_short}} Loopback y otras herramientas de {{site.data.keyword.Bluemix_notm}} Productivity. + + Para ejecutar herramientas {{site.data.keyword.apiconnect_short}} de forma local, utilice 5.x: + + ``` + $ brew install Node5 + ``` + +* [Herramientas de CLI de Bluemix ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://clis.ng.bluemix.net/ui/home.html) + + Herramientas de líneas de mandatos para desplegar los tiempos de ejecución de Cloud Foundry desde una interfaz de línea de mandatos con {{site.data.keyword.Bluemix_notm}}. + +* [{{site.data.keyword.dev_cli_notm}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](dev_cli.html) + + Plugin de CLI de {{site.data.keyword.Bluemix_notm}} para crear, probar y desplegar proyectos web y móviles. + +* [Plugin de generador de SDK ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](sdk_cli.html) + + {{site.data.keyword.Bluemix_notm}} Plugin de CLI para generar SDK desde una definición de la API REST compatible con la [Especificación de Open API ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://www.openapis.org/). + +### Android +{: #android notoc} + +* [Android Studio 2.2 o superior ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://developer.android.com/studio) + * Instale el último tiempo de ejecución de [Android 7.0 ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://www.android.com/versions/nougat-7-0/). + +### iOS +{: #ios notoc} + +* [Xcode 8 ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://developer.apple.com/xcode/) (recomendado) + + +* Gestor de dependencia de [CocoaPods ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://cocoapods.org/) para instalar dependencias del SDK de iOS. Utilice la versión más reciente: + + ``` + $ sudo gem install cocoapods --pre + ``` +* [Gestor de dependencias de Carthage ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://github.com/Carthage/Carthage) para instalar los SDK de {{site.data.keyword.watson}} Developer Cloud. + + ``` + $ brew install carthage + ``` diff --git a/cloudnative/nl/es/index.md b/cloudnative/nl/es/index.md index e78af234a..f783f9dbd 100644 --- a/cloudnative/nl/es/index.md +++ b/cloudnative/nl/es/index.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2016-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Creación de proyectos nativos en la nube -{: #web-mobile} - -Puede gestionar aplicaciones nativas en cloud a través del concepto de [Proyectos](projects.html) de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}. Puede crear un proyecto utilizando el [{{site.data.keyword.dev_console}}](devex.html) o [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) para la CLI de {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}}. La {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} ofrece las funcionalidades de servicio más comunes que son necesarias para un desarrollador móvil en una experiencia única y conectada que se ha optimizado para el desarrollador. - -La {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} permite a un desarrollador de aplicaciones nativas en cloud crear un proyecto a partir de diversos [tipos de patrones](patterns.html) e [Iniciadores](starters.html), crear y conectar servicios optimizados clave de {{site.data.keyword.Bluemix_notm}} al proyecto, y descargar rápidamente código que funciona con los SDK. Los SDK se integran totalmente con las dependencias o credenciales de la prestación, que le permiten ejecutarla en unos minutos. Cuando la aplicación se esté ejecutando y haya configurado las funciones, puede volver al proyecto para supervisar y gestionar la colaboración con los usuarios de la aplicación. También puede configurar y gestionar los servicios a través de la {{site.data.keyword.dev_console}}. - - - - - - -# Enlaces relacionados -{: #rellinks notoc} - -## Guías de aprendizaje y ejemplos -{: #samples notoc} - -* [Ejemplo: Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} -* [Guías de aprendizaje en vídeo](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2016-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Creación de proyectos nativos en la nube +{: #web-mobile} + +Puede gestionar aplicaciones nativas en cloud a través del concepto de [Proyectos](projects.html) de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}. Puede crear un proyecto utilizando el [{{site.data.keyword.dev_console}}](devex.html) o [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) para la CLI de {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}}. La {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} ofrece las funcionalidades de servicio más comunes que son necesarias para un desarrollador móvil en una experiencia única y conectada que se ha optimizado para el desarrollador. + +La {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} permite a un desarrollador de aplicaciones nativas en cloud crear un proyecto a partir de diversos [tipos de patrones](patterns.html) e [Iniciadores](starters.html), crear y conectar servicios optimizados clave de {{site.data.keyword.Bluemix_notm}} al proyecto, y descargar rápidamente código que funciona con los SDK. Los SDK se integran totalmente con las dependencias o credenciales de la prestación, que le permiten ejecutarla en unos minutos. Cuando la aplicación se esté ejecutando y haya configurado las funciones, puede volver al proyecto para supervisar y gestionar la colaboración con los usuarios de la aplicación. También puede configurar y gestionar los servicios a través de la {{site.data.keyword.dev_console}}. + + + + + + +# Enlaces relacionados +{: #rellinks notoc} + +## Guías de aprendizaje y ejemplos +{: #samples notoc} + +* [Ejemplo: Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} +* [Guías de aprendizaje en vídeo](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} diff --git a/cloudnative/nl/es/patterns.md b/cloudnative/nl/es/patterns.md index ba2b82cb6..aced24e8e 100644 --- a/cloudnative/nl/es/patterns.md +++ b/cloudnative/nl/es/patterns.md @@ -1,100 +1,100 @@ - ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Tipos de patrón -{: #patterns} - -Los patrones nativos en la nube son diseños probados que ayudan a garantizar una topología coherente, escalable y fiable para sus aplicaciones. Al crear un proyecto, se le presentan distintos tipos de patrón entre los que puede elegir. Seleccione el tipo de patrón y prestaciones que desea incorporar al proyecto. Después de definir las preferencias del proyecto, se genera un proyecto de iniciación para que edite, ejecute o depure y despliegue localmente o en {{site.data.keyword.Bluemix}}. - -## Aplicación web -{: #web} - -Los proyectos web añaden la capacidad de prestar contenido web, como HTML, JavaScript y hojas de estilo, al servidor web. - -Están disponibles los siguientes iniciadores web: - -* Basic Web: proporciona un archivo `index.html` estático, una hoja de estilo predeterminada y vacía y un archivo JavaScript. -* Webpack: crea un proyecto donde los archivos de origen de ECMAScript 6 (ES6) están en `src/client` y se compilan con WebPack para minificarlos y convertirlos para su uso en el navegador. -* Webpack + React: una infraestructura completa para crear interfaces de usuario. Los archivos de origen están en `src/client/app` y se compilarán con WebPack y se proporcionarán en el directorio público. - - -## App móvil -{: #mobile} - -Los patrones de app móvil le ayudan a crear aplicaciones móviles que se conecten directamente a los servicios de fondo, como por ejemplo {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, -{{site.data.keyword.appid_short}}, etc. Los proyectos también se pueden añadir mediante sdkGen, como BFF y Microservicios. - -Puede elegir entre una lista de iniciadores, como {{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, {{site.data.keyword.openwhisk_short}}, etc. - -Puede generar las apps móviles en Swift, Android o Cordova. - - -## Programa de fondo para programa de usuario (BFF) -{: #bff} - -Los patrones de Programa de fondo para programa de usuario, normalmente conocidos como BFF, le ayudan a centrarse en exponer datos de negocio y servicios de una forma que coincida con los requisitos de interacción del usuario. Para optimizar un trayecto del usuario en su solución en la nube, puede que necesite un trayecto del usuario distinto para la aplicación móvil y un trayecto más rico y detallado para la aplicación web. Con la introducción de dispositivos controlados por voz como el servicio de [{{site.data.keyword.conversationfull}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://www.ibm.com/watson/developercloud/conversation.html), la interacción con un usuario se podría controlar mediante voz. Este canal digital necesitará un BFF muy distinto para gestionar estas interacciones basadas en intentos de voz. - -Con {{site.data.keyword.Bluemix_notm}}, puede crear un BFF mediante un enfoque de programación políglota para definir el BFF. IBM recomienda utilizar Node.js, Swift, o Java y ejecutarlos en un patrón nativo de nube con Cloud Foundry, servicios de contenedor o sin servidor. - -El BFF gestionará la integración con servicios para la persistencia, el almacenamiento en memoria caché y la integración de datos con servicios de alto valor como {{site.data.keyword.ibmwatson}}, {{site.data.keyword.iot_short_notm}}, {{site.data.keyword.weather_short}}, y análisis de datos como {{site.data.keyword.sparks}}. - -El BFF expondrá una API más comúnmente utilizando un patrón REST, pero puede diseñar el BFF para que funcione a partir de una arquitectura de mensajería utilizando {{site.data.keyword.messagehub}}. - -Hay disponible un iniciador BFF Basic utilizando Node.js o Swift. - - -## Microservicio -{: #microservice} - -Los proyectos de microservicio proporcionan la base para crear microservicios de fondo, incluyendo una terminal de estado básica y una API REST. Los proyectos generados contendrán todas las dependencias necesarias para el propio microservicio, así como para cualquier servicio en la nube adjunto. - -Hay disponible un iniciador Microservice Basic utilizando Java. - - - - -## Lenguajes -{: #languages notoc} - -Los lenguajes soportados son: - - * [Java ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](../runtimes/liberty/getting-started.html){: new_window} - * [Node.js ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](../runtimes/nodejs/getting-started.html){: new_window} - * [Swift ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](../runtimes/swift/getting-started.html){: new_window} - - -### Java -{: #java notoc} - -Java cuenta con prestaciones demostradas para crear aplicaciones empresariales. Pero las nuevas prestaciones de Java 8, combinadas con tiempos de ejecución más ligeros como Liberty e infraestructuras como Spring Boot, hacen que Java sea perfecto también para crear microservicios. - - -### Node.js -{: #node notoc} - -Node.js es un tiempo de ejecución de JavaScript que utiliza un modelo de E/S sin bloqueo y dirigido por sucesos, que lo hace ligero y eficiente, proporcionando un gran rendimiento y escalabilidad para aplicaciones web, patrones de programa de fondo para programa de usuario y microservicios. El ecosistema de paquetes de Node.js', npm, proporciona acceso a una gran recopilación de módulos de código abierto, con una amplia variedad de prestaciones para acelerar el desarrollo de las aplicaciones. - - -### Swift -{: #swift notoc} - -Swift es un lenguaje de programación moderno creado por Apple en 2014, que se ha diseñado para sustituir el uso de Objective C y el código abierto en diciembre de 2015. Actualmente, se utiliza para crear iOS, macOS, servicios web y software de sistemas en sistemas operativos Linux y macOS, que utilizan la arquitectura x86, ARM o Z. Escribe como un lenguaje de script pero se compila para obtener el alto rendimiento de C con una sobrecarga baja, lo que la convierte en la opción ideal para tiempos de ejecución en la nube. Utiliza un sistema de tipos estático y sólido que ve en Java, pero el estilo funcional y las rutinas asíncronas que ve en JavaScript. Ofrece un alto rendimiento, y el origen se compila en código nativo utilizando la cadena de herramientas del compilador LLVM y puede utilizar bibliotecas de sistemas externos escritas en C fácilmente. + +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Tipos de patrón +{: #patterns} + +Los patrones nativos en la nube son diseños probados que ayudan a garantizar una topología coherente, escalable y fiable para sus aplicaciones. Al crear un proyecto, se le presentan distintos tipos de patrón entre los que puede elegir. Seleccione el tipo de patrón y prestaciones que desea incorporar al proyecto. Después de definir las preferencias del proyecto, se genera un proyecto de iniciación para que edite, ejecute o depure y despliegue localmente o en {{site.data.keyword.Bluemix}}. + +## Aplicación web +{: #web} + +Los proyectos web añaden la capacidad de prestar contenido web, como HTML, JavaScript y hojas de estilo, al servidor web. + +Están disponibles los siguientes iniciadores web: + +* Basic Web: proporciona un archivo `index.html` estático, una hoja de estilo predeterminada y vacía y un archivo JavaScript. +* Webpack: crea un proyecto donde los archivos de origen de ECMAScript 6 (ES6) están en `src/client` y se compilan con WebPack para minificarlos y convertirlos para su uso en el navegador. +* Webpack + React: una infraestructura completa para crear interfaces de usuario. Los archivos de origen están en `src/client/app` y se compilarán con WebPack y se proporcionarán en el directorio público. + + +## App móvil +{: #mobile} + +Los patrones de app móvil le ayudan a crear aplicaciones móviles que se conecten directamente a los servicios de fondo, como por ejemplo {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, +{{site.data.keyword.appid_short}}, etc. Los proyectos también se pueden añadir mediante sdkGen, como BFF y Microservicios. + +Puede elegir entre una lista de iniciadores, como {{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, {{site.data.keyword.openwhisk_short}}, etc. + +Puede generar las apps móviles en Swift, Android o Cordova. + + +## Programa de fondo para programa de usuario (BFF) +{: #bff} + +Los patrones de Programa de fondo para programa de usuario, normalmente conocidos como BFF, le ayudan a centrarse en exponer datos de negocio y servicios de una forma que coincida con los requisitos de interacción del usuario. Para optimizar un trayecto del usuario en su solución en la nube, puede que necesite un trayecto del usuario distinto para la aplicación móvil y un trayecto más rico y detallado para la aplicación web. Con la introducción de dispositivos controlados por voz como el servicio de [{{site.data.keyword.conversationfull}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://www.ibm.com/watson/developercloud/conversation.html), la interacción con un usuario se podría controlar mediante voz. Este canal digital necesitará un BFF muy distinto para gestionar estas interacciones basadas en intentos de voz. + +Con {{site.data.keyword.Bluemix_notm}}, puede crear un BFF mediante un enfoque de programación políglota para definir el BFF. IBM recomienda utilizar Node.js, Swift, o Java y ejecutarlos en un patrón nativo de nube con Cloud Foundry, servicios de contenedor o sin servidor. + +El BFF gestionará la integración con servicios para la persistencia, el almacenamiento en memoria caché y la integración de datos con servicios de alto valor como {{site.data.keyword.ibmwatson}}, {{site.data.keyword.iot_short_notm}}, {{site.data.keyword.weather_short}}, y análisis de datos como {{site.data.keyword.sparks}}. + +El BFF expondrá una API más comúnmente utilizando un patrón REST, pero puede diseñar el BFF para que funcione a partir de una arquitectura de mensajería utilizando {{site.data.keyword.messagehub}}. + +Hay disponible un iniciador BFF Basic utilizando Node.js o Swift. + + +## Microservicio +{: #microservice} + +Los proyectos de microservicio proporcionan la base para crear microservicios de fondo, incluyendo una terminal de estado básica y una API REST. Los proyectos generados contendrán todas las dependencias necesarias para el propio microservicio, así como para cualquier servicio en la nube adjunto. + +Hay disponible un iniciador Microservice Basic utilizando Java. + + + + +## Lenguajes +{: #languages notoc} + +Los lenguajes soportados son: + + * [Java ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](../runtimes/liberty/getting-started.html){: new_window} + * [Node.js ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](../runtimes/nodejs/getting-started.html){: new_window} + * [Swift ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](../runtimes/swift/getting-started.html){: new_window} + + +### Java +{: #java notoc} + +Java cuenta con prestaciones demostradas para crear aplicaciones empresariales. Pero las nuevas prestaciones de Java 8, combinadas con tiempos de ejecución más ligeros como Liberty e infraestructuras como Spring Boot, hacen que Java sea perfecto también para crear microservicios. + + +### Node.js +{: #node notoc} + +Node.js es un tiempo de ejecución de JavaScript que utiliza un modelo de E/S sin bloqueo y dirigido por sucesos, que lo hace ligero y eficiente, proporcionando un gran rendimiento y escalabilidad para aplicaciones web, patrones de programa de fondo para programa de usuario y microservicios. El ecosistema de paquetes de Node.js', npm, proporciona acceso a una gran recopilación de módulos de código abierto, con una amplia variedad de prestaciones para acelerar el desarrollo de las aplicaciones. + + +### Swift +{: #swift notoc} + +Swift es un lenguaje de programación moderno creado por Apple en 2014, que se ha diseñado para sustituir el uso de Objective C y el código abierto en diciembre de 2015. Actualmente, se utiliza para crear iOS, macOS, servicios web y software de sistemas en sistemas operativos Linux y macOS, que utilizan la arquitectura x86, ARM o Z. Escribe como un lenguaje de script pero se compila para obtener el alto rendimiento de C con una sobrecarga baja, lo que la convierte en la opción ideal para tiempos de ejecución en la nube. Utiliza un sistema de tipos estático y sólido que ve en Java, pero el estilo funcional y las rutinas asíncronas que ve en JavaScript. Ofrece un alto rendimiento, y el origen se compila en código nativo utilizando la cadena de herramientas del compilador LLVM y puede utilizar bibliotecas de sistemas externos escritas en C fácilmente. diff --git a/cloudnative/nl/es/projects.md b/cloudnative/nl/es/projects.md index 17a0bc979..47c6c90ec 100644 --- a/cloudnative/nl/es/projects.md +++ b/cloudnative/nl/es/projects.md @@ -1,57 +1,57 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Proyectos -{: #projects} - -La {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}} combina la interfaz de usuario, los datos y los servicios de la aplicación en un *proyecto* completo. Al crear un proyecto, se mantienen todas las partes necesarias de la aplicación y las prestaciones añadidas en el servidor de {{site.data.keyword.Bluemix_notm}}. Puede descargar el código de la app y las credenciales e iniciadores necesarios si los servicios están configurados en su proyecto. Puede ver todos sus proyectos seleccionando **Proyectos**. - -Para ver más información sobre un determinado proyecto, selecciónelo en la página **Proyectos**. Se abrirá la página **Visión general del proyecto**, que incluye los servicios configurados y disponibles para el proyecto. Los servicios son prestaciones independientes que amplían la aplicación añadiendo una función. Debido a que se añaden individualmente, puede añadir los servicios que necesite, como los servicios push, de autenticación, datos y almacenamiento, entre otros. Cuando añade un servicio al proyecto en la página **Visión general del proyecto** y sigue las instrucciones para configurarlo, se asocia automáticamente a la app. Para obtener más información sobre la página Visión general del proyecto, consulte la [página Visión general del proyecto](project_overview_page.html). - -Para crear el proyecto, debe seleccionar un [patrón](patterns.html), seguido por un [iniciador](starters.html). - - -## Página Visión general del proyecto -{: #project_overview} - -Puede ver y trabajar con un único proyecto de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}} seleccionando el proyecto en la página **Proyectos**, que abre la página Visión general del proyecto. -{: shortdesc} - -La página **Visión general del proyecto** muestra un mosaico de cada prestación configurada o disponible para que se configure con el proyecto seleccionado. El mosaico muestra el tipo de prestación y un botón *acciones* con tres puntos alineados en vertical. Ejemplos de prestaciones que podrían estar disponibles o configuradas son {{site.data.keyword.mobilepushshort}}, Analytics, o Data and Storage. Las prestaciones compatibles dependen del tipo de proyecto y de las prestaciones disponibles en la región, de modo que no todas las prestaciones estarán disponibles para que se asocien con todos los proyectos. - -Cuando un tipo de prestación aún no está asociada al proyecto, se muestra el botón **Crear** en el mosaico. Las opciones del botón de acciones sirven para crear una instancia del servicio o para añadir una instancia de servicio existente cuando la prestación aún no está asociada. Si se selecciona **Añadir existentes**, se muestra una lista de instancias de servicio de dicho tipo en su espacio. - -Si la prestación ya está asociada a este proyecto, el nombre de la instancia del servicio asociado se muestra en el mosaico tras el tipo de prestación. Esto facilita la búsqueda de la instancia de servicio relacionada con el proyecto en la {{site.data.keyword.dev_console}}. Las acciones que están disponibles en el botón de acciones son **Ver** y **Eliminar** cuando el servicio ya está asociado al proyecto. Cuando se elimina una instancia de servicio solo se elimina la asociación a este proyecto; no se suprime la instancia del servicio de la {{site.data.keyword.dev_console}}. Para suprimir una instancia de servicio, pulse la página **Web y móvil > Servicios** para ver y suprimir las instancias de servicio. - -Seleccione **Obtener el código** en el mosaico **Código** para descargar el código correspondiente al proyecto. Para obtener más información sobre cómo descargar el código, consulte [Obtener código](get_code.html). - - -## Actualización del proyecto para utilizar un nuevo Iniciador -{: #update-starter} - -1. Desde la página **Proyectos** o **Visión general del proyecto**, pulse el icono **Menú de desbordamiento** y seleccione **Actualizar iniciador**. - -2. Elija un nuevo iniciador y pulse **Actualizar**. - -3. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. - - Como alternativa, pulse la página **Código**. - - -## Actualización del proyecto para generar un nuevo lenguaje -{: #update-language} - -1. Desde las páginas **Proyectos** o **Visión general del proyecto**, pulse el icono **Menú de desbordamiento** y seleccione **Actualizar iniciador**. - -2. Seleccione un nuevo lenguaje y pulse **Actualizar**. - -3. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Proyectos +{: #projects} + +La {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}} combina la interfaz de usuario, los datos y los servicios de la aplicación en un *proyecto* completo. Al crear un proyecto, se mantienen todas las partes necesarias de la aplicación y las prestaciones añadidas en el servidor de {{site.data.keyword.Bluemix_notm}}. Puede descargar el código de la app y las credenciales e iniciadores necesarios si los servicios están configurados en su proyecto. Puede ver todos sus proyectos seleccionando **Proyectos**. + +Para ver más información sobre un determinado proyecto, selecciónelo en la página **Proyectos**. Se abrirá la página **Visión general del proyecto**, que incluye los servicios configurados y disponibles para el proyecto. Los servicios son prestaciones independientes que amplían la aplicación añadiendo una función. Debido a que se añaden individualmente, puede añadir los servicios que necesite, como los servicios push, de autenticación, datos y almacenamiento, entre otros. Cuando añade un servicio al proyecto en la página **Visión general del proyecto** y sigue las instrucciones para configurarlo, se asocia automáticamente a la app. Para obtener más información sobre la página Visión general del proyecto, consulte la [página Visión general del proyecto](project_overview_page.html). + +Para crear el proyecto, debe seleccionar un [patrón](patterns.html), seguido por un [iniciador](starters.html). + + +## Página Visión general del proyecto +{: #project_overview} + +Puede ver y trabajar con un único proyecto de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}} seleccionando el proyecto en la página **Proyectos**, que abre la página Visión general del proyecto. +{: shortdesc} + +La página **Visión general del proyecto** muestra un mosaico de cada prestación configurada o disponible para que se configure con el proyecto seleccionado. El mosaico muestra el tipo de prestación y un botón *acciones* con tres puntos alineados en vertical. Ejemplos de prestaciones que podrían estar disponibles o configuradas son {{site.data.keyword.mobilepushshort}}, Analytics, o Data and Storage. Las prestaciones compatibles dependen del tipo de proyecto y de las prestaciones disponibles en la región, de modo que no todas las prestaciones estarán disponibles para que se asocien con todos los proyectos. + +Cuando un tipo de prestación aún no está asociada al proyecto, se muestra el botón **Crear** en el mosaico. Las opciones del botón de acciones sirven para crear una instancia del servicio o para añadir una instancia de servicio existente cuando la prestación aún no está asociada. Si se selecciona **Añadir existentes**, se muestra una lista de instancias de servicio de dicho tipo en su espacio. + +Si la prestación ya está asociada a este proyecto, el nombre de la instancia del servicio asociado se muestra en el mosaico tras el tipo de prestación. Esto facilita la búsqueda de la instancia de servicio relacionada con el proyecto en la {{site.data.keyword.dev_console}}. Las acciones que están disponibles en el botón de acciones son **Ver** y **Eliminar** cuando el servicio ya está asociado al proyecto. Cuando se elimina una instancia de servicio solo se elimina la asociación a este proyecto; no se suprime la instancia del servicio de la {{site.data.keyword.dev_console}}. Para suprimir una instancia de servicio, pulse la página **Web y móvil > Servicios** para ver y suprimir las instancias de servicio. + +Seleccione **Obtener el código** en el mosaico **Código** para descargar el código correspondiente al proyecto. Para obtener más información sobre cómo descargar el código, consulte [Obtener código](get_code.html). + + +## Actualización del proyecto para utilizar un nuevo Iniciador +{: #update-starter} + +1. Desde la página **Proyectos** o **Visión general del proyecto**, pulse el icono **Menú de desbordamiento** y seleccione **Actualizar iniciador**. + +2. Elija un nuevo iniciador y pulse **Actualizar**. + +3. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. + + Como alternativa, pulse la página **Código**. + + +## Actualización del proyecto para generar un nuevo lenguaje +{: #update-language} + +1. Desde las páginas **Proyectos** o **Visión general del proyecto**, pulse el icono **Menú de desbordamiento** y seleccione **Actualizar iniciador**. + +2. Seleccione un nuevo lenguaje y pulse **Actualizar**. + +3. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. diff --git a/cloudnative/nl/es/sdk.md b/cloudnative/nl/es/sdk.md index d35a0680c..6ef49349d 100644 --- a/cloudnative/nl/es/sdk.md +++ b/cloudnative/nl/es/sdk.md @@ -1,67 +1,67 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-17" - ---- -# SDK -{: #sdk} - -Para añadir SDK de {{site.data.keyword.Bluemix}} Mobile Services a su app, elija los SDK que desee utilizar y, a continuación, configure el gestor de dependencia para extraer los SDK en la app. - - -## SDK de cliente -{: #client_sdk} - -Puede utilizar los siguientes SDK en la aplicación móvil para optimizar las prestaciones respectivas. - - -### SDK de Android -{: #android_sdk} - -- [Core SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) -- [{{site.data.keyword.mobileanalytics_short}} SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) -- [SDK de autenticación de Facebook ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) -- [SDK de autenticación de Google ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) - - -### SDK de iOS -{: #ios_sdk} - -- [Core SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) -- [{{site.data.keyword.mobileanalytics_short}} SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) -- [SDK de autenticación de Facebook ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) -- [SDK de autenticación de Google ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) -- [{{site.data.keyword.amashort}} SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) - - -### Plugins de Cordova -{: #cordova_plugin} - -- [Plugin de Core ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) -- [Plugin de {{site.data.keyword.mobilepushshort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## SDK de servidor -{: #server_sdk} - -Si tiene una aplicación de servidor de Java, NodeJS o Swift, puede utilizar los siguientes SDK para comunicarse con los servicios respectivos. - - -### SDK de servidor de {{site.data.keyword.mobilepushshort}} -{: #push_sdk} - -- [SDK del servidor Java de {{site.data.keyword.mobilepushshort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) -- [SDK del servidor Swift de {{site.data.keyword.mobilepushshort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) -- [SDK del servidor NodeJS de {{site.data.keyword.mobilepushshort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) - - -### SDK de servidor de {{site.data.keyword.amashort}} -{: #mca_sdk} - -- [SDK del servidor Swift de {{site.data.keyword.amashort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) - - +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-17" + +--- +# SDK +{: #sdk} + +Para añadir SDK de {{site.data.keyword.Bluemix}} Mobile Services a su app, elija los SDK que desee utilizar y, a continuación, configure el gestor de dependencia para extraer los SDK en la app. + + +## SDK de cliente +{: #client_sdk} + +Puede utilizar los siguientes SDK en la aplicación móvil para optimizar las prestaciones respectivas. + + +### SDK de Android +{: #android_sdk} + +- [Core SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) +- [{{site.data.keyword.mobileanalytics_short}} SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) +- [SDK de autenticación de Facebook ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) +- [SDK de autenticación de Google ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) + + +### SDK de iOS +{: #ios_sdk} + +- [Core SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) +- [{{site.data.keyword.mobileanalytics_short}} SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) +- [SDK de autenticación de Facebook ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) +- [SDK de autenticación de Google ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) +- [{{site.data.keyword.amashort}} SDK ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) + + +### Plugins de Cordova +{: #cordova_plugin} + +- [Plugin de Core ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) +- [Plugin de {{site.data.keyword.mobilepushshort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## SDK de servidor +{: #server_sdk} + +Si tiene una aplicación de servidor de Java, NodeJS o Swift, puede utilizar los siguientes SDK para comunicarse con los servicios respectivos. + + +### SDK de servidor de {{site.data.keyword.mobilepushshort}} +{: #push_sdk} + +- [SDK del servidor Java de {{site.data.keyword.mobilepushshort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) +- [SDK del servidor Swift de {{site.data.keyword.mobilepushshort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) +- [SDK del servidor NodeJS de {{site.data.keyword.mobilepushshort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) + + +### SDK de servidor de {{site.data.keyword.amashort}} +{: #mca_sdk} + +- [SDK del servidor Swift de {{site.data.keyword.amashort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) + + diff --git a/cloudnative/nl/es/sdk_BMSClient.md b/cloudnative/nl/es/sdk_BMSClient.md index e812e2246..fb558e52c 100644 --- a/cloudnative/nl/es/sdk_BMSClient.md +++ b/cloudnative/nl/es/sdk_BMSClient.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Inicialización de BMSClient -{: #sdk_BMSClient} - -`BMSCore` proporciona la infraestructura HTTP que utilizan los otros SDK de cliente de servicios de {{site.data.keyword.Bluemix}} Mobile con sus correspondientes servicios de {{site.data.keyword.Bluemix_notm}}. - - -## Inicialización de la aplicación Android -{: #init-BMSClient-android} - -Puede descargar e importar el paquete `BMSCore` en su proyecto Android Studio o puede utilizar Gradle. - -1. Importe el SDK de cliente añadiendo la siguiente sentencia `import` al principio del archivo del proyecto: - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; - ``` - {: codeblock} - -2. Inicialice el SDK `BMSClient` en la aplicación Android añadiendo el código de inicialización del método `onCreate` de la actividad principal a la aplicación Android o en la ubicación que mejor se ajuste a su proyecto. - - ```Java - BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Asegúrese de apuntar a su región - ``` - {: codeblock} - - Debe inicializar `BMSClient` con el parámetro **bluemixRegion**. En el inicializador, el valor **bluemixRegion** especifica el despliegue de {{site.data.keyword.Bluemix_notm}} que está utilizando, por ejemplo `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` o `BMSClient.REGION_SYDNEY`. - - -## Inicialización de la aplicación iOS -{: #init-BMSClient-ios} - -Puede utilizar [CocoaPods](https://cocoapods.org){: new_window} o [Carthage](https://github.com/Carthage/Carthage){: new_window} para obtener el paquete `BMSCore`. - -1. Para instalar `BMSCore` mediante CocoaPods, añada las siguientes líneas a Podfile. Si el proyecto aún no tiene un Podfile, utilice el mandato `pod init`. - - ```Swift - use_frameworks! - - target 'MyApp' do - pod 'BMSCore' - end - ``` - {: codeblock} - - Luego ejecute el mandato `pod install` y abra el archivo `.xcworkspace` generado. Para actualizar a un release posterior de `BMSCore`, utilice `pod update BMSCore`. - - Para obtener más información sobre cómo utilizar CocoaPods, consulte las [Guías de CocoaPods ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://guides.cocoapods.org/using/index.html){: new_window}. - -2. Para instalar `BMSCore` mediante Carthage, siga estas [instrucciones ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/Carthage/Carthage#getting-started){: new_window}. - - 1. Añada la siguiente línea a Cartfile: - - ``` - github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" - ``` - {: codeblock} - - 2. Ejecute el mandato `carthage update`. - - 3. Una vez finalizada la compilación, añada `BMSCore.framework` al proyecto siguiendo el [Paso 3 ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/Carthage/Carthage#getting-started) en las instrucciones de Carthage. - - Para aplicaciones compiladas con Swift 2.3, utilice el mandato `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3`. De lo contrario, utilice el mandato `carthage update`. - -3. Importe el módulo. - - ```Swift - import BMSCore - ``` - {: codeblock} - -4. Inicialice la clase `BMSClient` con el código siguiente. - - Coloque el código de inicialización en el método `application(_:didFinishLaunchingWithOptions:)` de delegado de la aplicación o en la ubicación que mejor se ajuste a su proyecto. - - ```Swift - BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Asegúrese de apuntar a su región - ``` - {: codeblock} - - Debe inicializar `BMSClient` con el parámetro **bluemixRegion**. En el inicializador, el valor **bluemixRegion** especifica el despliegue de {{site.data.keyword.Bluemix_notm}} que está utilizando, por ejemplo `BMSClient.Region.usSouth`, `BMSClient.Region.unitedKingdom` o `BMSClient.Region.sydney`. - - -## Inicialización de la aplicación Cordova -{: #init-BMSClient-cordova} - -1. Añada el plugin de Cordova ejecutando el siguiente mandato desde el directorio raíz de la aplicación Cordova: - - ``` - cordova plugin add bms-core - ``` - {: codeblock} - -2. Inicialice la clase `BMSClient` en la aplicación Cordova añadiendo el código de inicialización en el archivo principal de JavaScript o en la ubicación que mejor se ajuste al proyecto. - - ``` - BMSClient.initialize(BMSClient.REGION_US_SOUTH); - ``` - {: codeblock} - - Debe inicializar `BMSClient` con el parámetro **bluemixRegion**. En el inicializador, el valor **bluemixRegion** especifica el despliegue de {{site.data.keyword.Bluemix_notm}} que está utilizando, por ejemplo `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` o `BMSClient.REGION_SYDNEY`. - - -# Enlaces relacionados -{: #rellinks notoc} - -## Enlaces relacionados -{: #general notoc} - -* [SDK de Android de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [SDK de iOS de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [SDK de Cordova de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Inicialización de BMSClient +{: #sdk_BMSClient} + +`BMSCore` proporciona la infraestructura HTTP que utilizan los otros SDK de cliente de servicios de {{site.data.keyword.Bluemix}} Mobile con sus correspondientes servicios de {{site.data.keyword.Bluemix_notm}}. + + +## Inicialización de la aplicación Android +{: #init-BMSClient-android} + +Puede descargar e importar el paquete `BMSCore` en su proyecto Android Studio o puede utilizar Gradle. + +1. Importe el SDK de cliente añadiendo la siguiente sentencia `import` al principio del archivo del proyecto: + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; + ``` + {: codeblock} + +2. Inicialice el SDK `BMSClient` en la aplicación Android añadiendo el código de inicialización del método `onCreate` de la actividad principal a la aplicación Android o en la ubicación que mejor se ajuste a su proyecto. + + ```Java + BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Asegúrese de apuntar a su región + ``` + {: codeblock} + + Debe inicializar `BMSClient` con el parámetro **bluemixRegion**. En el inicializador, el valor **bluemixRegion** especifica el despliegue de {{site.data.keyword.Bluemix_notm}} que está utilizando, por ejemplo `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` o `BMSClient.REGION_SYDNEY`. + + +## Inicialización de la aplicación iOS +{: #init-BMSClient-ios} + +Puede utilizar [CocoaPods](https://cocoapods.org){: new_window} o [Carthage](https://github.com/Carthage/Carthage){: new_window} para obtener el paquete `BMSCore`. + +1. Para instalar `BMSCore` mediante CocoaPods, añada las siguientes líneas a Podfile. Si el proyecto aún no tiene un Podfile, utilice el mandato `pod init`. + + ```Swift + use_frameworks! + + target 'MyApp' do + pod 'BMSCore' + end + ``` + {: codeblock} + + Luego ejecute el mandato `pod install` y abra el archivo `.xcworkspace` generado. Para actualizar a un release posterior de `BMSCore`, utilice `pod update BMSCore`. + + Para obtener más información sobre cómo utilizar CocoaPods, consulte las [Guías de CocoaPods ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://guides.cocoapods.org/using/index.html){: new_window}. + +2. Para instalar `BMSCore` mediante Carthage, siga estas [instrucciones ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/Carthage/Carthage#getting-started){: new_window}. + + 1. Añada la siguiente línea a Cartfile: + + ``` + github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" + ``` + {: codeblock} + + 2. Ejecute el mandato `carthage update`. + + 3. Una vez finalizada la compilación, añada `BMSCore.framework` al proyecto siguiendo el [Paso 3 ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/Carthage/Carthage#getting-started) en las instrucciones de Carthage. + + Para aplicaciones compiladas con Swift 2.3, utilice el mandato `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3`. De lo contrario, utilice el mandato `carthage update`. + +3. Importe el módulo. + + ```Swift + import BMSCore + ``` + {: codeblock} + +4. Inicialice la clase `BMSClient` con el código siguiente. + + Coloque el código de inicialización en el método `application(_:didFinishLaunchingWithOptions:)` de delegado de la aplicación o en la ubicación que mejor se ajuste a su proyecto. + + ```Swift + BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Asegúrese de apuntar a su región + ``` + {: codeblock} + + Debe inicializar `BMSClient` con el parámetro **bluemixRegion**. En el inicializador, el valor **bluemixRegion** especifica el despliegue de {{site.data.keyword.Bluemix_notm}} que está utilizando, por ejemplo `BMSClient.Region.usSouth`, `BMSClient.Region.unitedKingdom` o `BMSClient.Region.sydney`. + + +## Inicialización de la aplicación Cordova +{: #init-BMSClient-cordova} + +1. Añada el plugin de Cordova ejecutando el siguiente mandato desde el directorio raíz de la aplicación Cordova: + + ``` + cordova plugin add bms-core + ``` + {: codeblock} + +2. Inicialice la clase `BMSClient` en la aplicación Cordova añadiendo el código de inicialización en el archivo principal de JavaScript o en la ubicación que mejor se ajuste al proyecto. + + ``` + BMSClient.initialize(BMSClient.REGION_US_SOUTH); + ``` + {: codeblock} + + Debe inicializar `BMSClient` con el parámetro **bluemixRegion**. En el inicializador, el valor **bluemixRegion** especifica el despliegue de {{site.data.keyword.Bluemix_notm}} que está utilizando, por ejemplo `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` o `BMSClient.REGION_SYDNEY`. + + +# Enlaces relacionados +{: #rellinks notoc} + +## Enlaces relacionados +{: #general notoc} + +* [SDK de Android de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [SDK de iOS de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [SDK de Cordova de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/es/sdk_cli.md b/cloudnative/nl/es/sdk_cli.md index d93ead992..a6b4517e2 100644 --- a/cloudnative/nl/es/sdk_cli.md +++ b/cloudnative/nl/es/sdk_cli.md @@ -1,178 +1,178 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Plugin del generador de SDK -{: #sdk-cli} - -El plugin del Generador de SDK de {{site.data.keyword.IBM}} se puede instalar en la CLI de [{{site.data.keyword.Bluemix_notm}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/cli/reference/bluemix_cli/index.html). - -Como desarrollador en {{site.data.keyword.Bluemix_notm}}, puede utilizar este plug-in para generar SDK desde su definición de la API REST compatible con la [Especificación de Open API ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://www.openapis.org/). A medida que realice cambios a su definición de API REST, podrá utilizar este plug-in para volver a generar sólo el SDK, en lugar de volver a generar todo el proyecto. - -También puede ver si las apps de Cloud Foundry en un espacio determinado tienen definiciones de API REST válidas para la generación de SDK. Finalmente, puede utilizar el plugin del Generador de SDK de {{site.data.keyword.IBM_notm}} para validar cualquier definición de API REST para garantizar que cumpla con los requisitos del generador de SDK. - -Este plug-in del Generador de SDK de {{site.data.keyword.IBM_notm}} le permite integrar con facilidad los servicios de fondo con la app con un SDK generado. Cuando se produzca un cambio en una API REST, puede volver a generar el SDK y sustituir el antiguo por una actualización de SDK integrada. También puede integrar la CLI en un conducto de devops y garantizar que el SDK sea siempre coherente con la especificación de la API cada vez que se cree la app. - -La definición de la API REST debe ser válida y estar alojada en un punto final de servidor activo o en un archivo local en el sistema. Si la definición de la API REST está alojada, el URL relativo debe estar definido en la variable de entorno `OPENAPI_SPEC`. - - -## Requisitos -{: #prereqs} - -Asegúrese de haber satisfecho los siguientes requisitos. - -* Tiene una [cuenta de {{site.data.keyword.Bluemix_notm}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](http://bluemix.net) -* Una definición de API válida que se ajusta a la [especificación de Open API ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://www.openapis.org/) - - -## Instalación -{: #installation} - -1. [Instale la CLI de {{site.data.keyword.Bluemix}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](http://clis.ng.bluemix.net/ui/home.html). - -2. [Instale el plug-in ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in). - - ``` - bx plugin install sdk-gen -r Bluemix - ``` - {: codeblock} - - -## Mandatos -{: #commands} - -Utilice los siguientes mandatos para generar un SDK, validar los archivos de definición de Open API o listar las apps de Cloud Foundry. - - -### Generación de un SDK -{: #gen} - -Utilice `bluemix sdk generate [argumentos...][command options]`. - - -#### Argumentos -{: #gen-args} - -* `APP_NAME`: el nombre de la app de Cloud Foundry en el espacio actual -* `OPENAPI_DOC_LOCATION`: un URL o una vía de acceso de archivos relativa al JSON o Yaml de la definición de la API REST sin formato -* `GENERATED_SDK_NAME` (opcional): el nombre del SDK generado - - -#### Opciones -{: #gen-options} - -* `PLATFORM` (necesario) - * `--android`: generar un SDK de Android - * `--ios` - generar un SDK de Swift de iOS - * `--swift` - generar un SDK de servidor de Swift -* `--output "YOUR_RELATIVE_PATH"` (opcional): coloca el SDK generado en el directorio especificado por `YOUR_RELATIVE_PATH` (se sobrescribe si hay un SDK existente) -* `--unzip` (opcional): extrae el SDK generado (se sobrescribe si hay artefactos SDK existentes) - - -#### Uso -{: #gen-usage} - -Para generar un SDK desde una app de Cloud Foundry que se está ejecutando en {{site.data.keyword.Bluemix_notm}}, puede utilizar el nombre de la app como un parámetro para la CLI. El mandato siguiente utiliza el nombre de la app como el `SDK_Name`. - -``` -bluemix sdk generate [APP_NAME] [PLATFORM] -``` -{: codeblock} - -Para generar un SDK desde un URL a un archivo de definición de Open API o un archivo JSON o Yaml local, utilice el siguiente mandato. - -``` -bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] -``` -{: codeblock} - - -### Validación de definiciones de Open API -{: #validating} - -Utilice `bluemix sdk validate [argument]`. - - -#### Argumentos -{: #val-args} - -* `APP_NAME`: el nombre de la app de Cloud Foundry en el espacio actual -* `OPENAPI_DOC_LOCATION`: un URL o una vía de acceso de archivos relativa al JSON o Yaml de la definición de la API REST sin formato - - -#### Uso -{: #val-usage} - -Para validar una especificación de API de la app Cloud Foundry que se está ejecutando en {{site.data.keyword.Bluemix_notm}}, puede utilizar el nombre de la app como un parámetro para la CLI. - -``` -bluemix sdk validate [APP_NAME] -``` -{: codeblock} - -Para validar un SDK desde el URL a un documento de especificación de la API o un archivo JSON o Yaml local, utilice el siguiente mandato. - -``` -bluemix sdk validate [OPENAPI_DOC_LOCATION] -``` -{: codeblock} - - - -### List Apps (Cloud Foundry) -{: #list-apps} - -Utilice `bluemix sdk list [argumento][option]` para listar apps y validar especificaciones de la API. Debe tener la variable de entorno `OPENAPI_SPEC` establecida en la vía de acceso de URL relativo que aloja su especificación. - - -#### Argumentos -{: #list-args} - -* `SPACE_NAME` (opcional): el nombre del espacio de Cloud Foundry dentro de la organización actual en la que desea buscar apps. Si no se proporciona, se buscará en el espacio actual. - - -#### Opciones -{: #list-options} - -* `--url` (opcional): para mostrar un URL completamente formado en la definición de Open API para cada app de la lista - - -#### Uso -{: #list-usage} - -Para listar apps en el espacio actual, utilice el siguiente mandato. - -``` -bluemix sdk list -``` -{: codeblock} - -Para listar apps en el espacio actual y mostrar el URL de especificación de API, utilice el siguiente mandato. - -``` -bluemix sdk list --url -``` -{: codeblock} - -Para listar apps en un espacio específico, utilice el siguiente mandato. - -``` -bluemix sdk list [SPACE_NAME] -``` -{: codeblock} - -Para listar apps en un espacio específico y mostrar el URL de especificación de API, utilice el siguiente mandato. - -``` -bluemix sdk list [SPACE_NAME] --url -``` -{: codeblock} +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Plugin del generador de SDK +{: #sdk-cli} + +El plugin del Generador de SDK de {{site.data.keyword.IBM}} se puede instalar en la CLI de [{{site.data.keyword.Bluemix_notm}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/cli/reference/bluemix_cli/index.html). + +Como desarrollador en {{site.data.keyword.Bluemix_notm}}, puede utilizar este plug-in para generar SDK desde su definición de la API REST compatible con la [Especificación de Open API ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://www.openapis.org/). A medida que realice cambios a su definición de API REST, podrá utilizar este plug-in para volver a generar sólo el SDK, en lugar de volver a generar todo el proyecto. + +También puede ver si las apps de Cloud Foundry en un espacio determinado tienen definiciones de API REST válidas para la generación de SDK. Finalmente, puede utilizar el plugin del Generador de SDK de {{site.data.keyword.IBM_notm}} para validar cualquier definición de API REST para garantizar que cumpla con los requisitos del generador de SDK. + +Este plug-in del Generador de SDK de {{site.data.keyword.IBM_notm}} le permite integrar con facilidad los servicios de fondo con la app con un SDK generado. Cuando se produzca un cambio en una API REST, puede volver a generar el SDK y sustituir el antiguo por una actualización de SDK integrada. También puede integrar la CLI en un conducto de devops y garantizar que el SDK sea siempre coherente con la especificación de la API cada vez que se cree la app. + +La definición de la API REST debe ser válida y estar alojada en un punto final de servidor activo o en un archivo local en el sistema. Si la definición de la API REST está alojada, el URL relativo debe estar definido en la variable de entorno `OPENAPI_SPEC`. + + +## Requisitos +{: #prereqs} + +Asegúrese de haber satisfecho los siguientes requisitos. + +* Tiene una [cuenta de {{site.data.keyword.Bluemix_notm}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](http://bluemix.net) +* Una definición de API válida que se ajusta a la [especificación de Open API ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://www.openapis.org/) + + +## Instalación +{: #installation} + +1. [Instale la CLI de {{site.data.keyword.Bluemix}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](http://clis.ng.bluemix.net/ui/home.html). + +2. [Instale el plug-in ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in). + + ``` + bx plugin install sdk-gen -r Bluemix + ``` + {: codeblock} + + +## Mandatos +{: #commands} + +Utilice los siguientes mandatos para generar un SDK, validar los archivos de definición de Open API o listar las apps de Cloud Foundry. + + +### Generación de un SDK +{: #gen} + +Utilice `bluemix sdk generate [argumentos...][command options]`. + + +#### Argumentos +{: #gen-args} + +* `APP_NAME`: el nombre de la app de Cloud Foundry en el espacio actual +* `OPENAPI_DOC_LOCATION`: un URL o una vía de acceso de archivos relativa al JSON o Yaml de la definición de la API REST sin formato +* `GENERATED_SDK_NAME` (opcional): el nombre del SDK generado + + +#### Opciones +{: #gen-options} + +* `PLATFORM` (necesario) + * `--android`: generar un SDK de Android + * `--ios` - generar un SDK de Swift de iOS + * `--swift` - generar un SDK de servidor de Swift +* `--output "YOUR_RELATIVE_PATH"` (opcional): coloca el SDK generado en el directorio especificado por `YOUR_RELATIVE_PATH` (se sobrescribe si hay un SDK existente) +* `--unzip` (opcional): extrae el SDK generado (se sobrescribe si hay artefactos SDK existentes) + + +#### Uso +{: #gen-usage} + +Para generar un SDK desde una app de Cloud Foundry que se está ejecutando en {{site.data.keyword.Bluemix_notm}}, puede utilizar el nombre de la app como un parámetro para la CLI. El mandato siguiente utiliza el nombre de la app como el `SDK_Name`. + +``` +bluemix sdk generate [APP_NAME] [PLATFORM] +``` +{: codeblock} + +Para generar un SDK desde un URL a un archivo de definición de Open API o un archivo JSON o Yaml local, utilice el siguiente mandato. + +``` +bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] +``` +{: codeblock} + + +### Validación de definiciones de Open API +{: #validating} + +Utilice `bluemix sdk validate [argument]`. + + +#### Argumentos +{: #val-args} + +* `APP_NAME`: el nombre de la app de Cloud Foundry en el espacio actual +* `OPENAPI_DOC_LOCATION`: un URL o una vía de acceso de archivos relativa al JSON o Yaml de la definición de la API REST sin formato + + +#### Uso +{: #val-usage} + +Para validar una especificación de API de la app Cloud Foundry que se está ejecutando en {{site.data.keyword.Bluemix_notm}}, puede utilizar el nombre de la app como un parámetro para la CLI. + +``` +bluemix sdk validate [APP_NAME] +``` +{: codeblock} + +Para validar un SDK desde el URL a un documento de especificación de la API o un archivo JSON o Yaml local, utilice el siguiente mandato. + +``` +bluemix sdk validate [OPENAPI_DOC_LOCATION] +``` +{: codeblock} + + + +### List Apps (Cloud Foundry) +{: #list-apps} + +Utilice `bluemix sdk list [argumento][option]` para listar apps y validar especificaciones de la API. Debe tener la variable de entorno `OPENAPI_SPEC` establecida en la vía de acceso de URL relativo que aloja su especificación. + + +#### Argumentos +{: #list-args} + +* `SPACE_NAME` (opcional): el nombre del espacio de Cloud Foundry dentro de la organización actual en la que desea buscar apps. Si no se proporciona, se buscará en el espacio actual. + + +#### Opciones +{: #list-options} + +* `--url` (opcional): para mostrar un URL completamente formado en la definición de Open API para cada app de la lista + + +#### Uso +{: #list-usage} + +Para listar apps en el espacio actual, utilice el siguiente mandato. + +``` +bluemix sdk list +``` +{: codeblock} + +Para listar apps en el espacio actual y mostrar el URL de especificación de API, utilice el siguiente mandato. + +``` +bluemix sdk list --url +``` +{: codeblock} + +Para listar apps en un espacio específico, utilice el siguiente mandato. + +``` +bluemix sdk list [SPACE_NAME] +``` +{: codeblock} + +Para listar apps en un espacio específico y mostrar el URL de especificación de API, utilice el siguiente mandato. + +``` +bluemix sdk list [SPACE_NAME] --url +``` +{: codeblock} diff --git a/cloudnative/nl/es/sdk_network_request.md b/cloudnative/nl/es/sdk_network_request.md index 03c7f6d2e..49272f082 100644 --- a/cloudnative/nl/es/sdk_network_request.md +++ b/cloudnative/nl/es/sdk_network_request.md @@ -1,121 +1,121 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Realización de una solicitud de red -{: #sdk-network-request} - -También puede utilizar el SDK `BMSCore` para realizar solicitudes de red a cualquier recurso. - -## Android -{: #request-android} - -1. Asegúrese de haber [importado e inicializado el SDK del cliente](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android) en la aplicación Android. - -2. Realice una solicitud de red. - - ``` - public void makeGetCall() { - Thread thread = new Thread(new Runnable() { - @Override - public void run() { - try { - Request request = new Request("http://httpbin.org/get", "GET"); - request.send(null, null); - } catch (Exception e) { - // Manejar aquí los errores. - } - } - }); - thread.start(); - } - ``` - {: codeblock} - -## iOS -{: #request-ios} - -1. Asegúrese de haber [importado e inicializado el SDK de cliente](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios) en la aplicación iOS. - -2. Cree una solicitud de red. - - ### Swift 3.0 - {: #ios-swift3 notoc} - - ```Swift - // Realizar una solicitud de red - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - - ### Swift 2.2 - {: #ios-swift22 notoc} - - ```Swift - // Realizar una solicitud de red - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - -La clase `Request` ofrece un método sencillo para realizar una solicitud HTTP y obtener la respuesta una vez completada la solicitud. Si desea más flexibilidad y control del que puede obtener de la clase `Request`, puede utilizar la clase `BMSURLSession`. Algunas de las características de la clase `BMSURLSession` incluyen el progreso de supervisión de las cargas y la colocación en pausa o cancelación de solicitudes. Para obtener las respuestas, puede elegir manejadores de terminación o delegados. - -La clase `BMSURLSession` solo está disponible para iOS. Para obtener más información sobre `BMSURLSession`, consulte los archivos [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) del SDK de `BMSCore`. - - -## Cordova -{: #request-cordova} - -1. Asegúrese de haber [importado e inicializado el SDK del cliente](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova) en la aplicación Cordova. - -2. Cree una solicitud de red. - - ``` - var success = function(data) { - console.log("success", data); - } - var failure = function(error) - {console.log("failure", error); - } - var request = new BMSRequest("", BMSRequest.GET); - request.send(success, failure); - ``` - {: codeblock} - - -# Enlaces relacionados -{: #rellinks notoc} - -## Enlaces relacionados -{: #general notoc} - -* [SDK de Android de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [SDK de iOS de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [SDK de Cordova de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Realización de una solicitud de red +{: #sdk-network-request} + +También puede utilizar el SDK `BMSCore` para realizar solicitudes de red a cualquier recurso. + +## Android +{: #request-android} + +1. Asegúrese de haber [importado e inicializado el SDK del cliente](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android) en la aplicación Android. + +2. Realice una solicitud de red. + + ``` + public void makeGetCall() { + Thread thread = new Thread(new Runnable() { + @Override + public void run() { + try { + Request request = new Request("http://httpbin.org/get", "GET"); + request.send(null, null); + } catch (Exception e) { + // Manejar aquí los errores. + } + } + }); + thread.start(); + } + ``` + {: codeblock} + +## iOS +{: #request-ios} + +1. Asegúrese de haber [importado e inicializado el SDK de cliente](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios) en la aplicación iOS. + +2. Cree una solicitud de red. + + ### Swift 3.0 + {: #ios-swift3 notoc} + + ```Swift + // Realizar una solicitud de red + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + + ### Swift 2.2 + {: #ios-swift22 notoc} + + ```Swift + // Realizar una solicitud de red + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + +La clase `Request` ofrece un método sencillo para realizar una solicitud HTTP y obtener la respuesta una vez completada la solicitud. Si desea más flexibilidad y control del que puede obtener de la clase `Request`, puede utilizar la clase `BMSURLSession`. Algunas de las características de la clase `BMSURLSession` incluyen el progreso de supervisión de las cargas y la colocación en pausa o cancelación de solicitudes. Para obtener las respuestas, puede elegir manejadores de terminación o delegados. + +La clase `BMSURLSession` solo está disponible para iOS. Para obtener más información sobre `BMSURLSession`, consulte los archivos [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) del SDK de `BMSCore`. + + +## Cordova +{: #request-cordova} + +1. Asegúrese de haber [importado e inicializado el SDK del cliente](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova) en la aplicación Cordova. + +2. Cree una solicitud de red. + + ``` + var success = function(data) { + console.log("success", data); + } + var failure = function(error) + {console.log("failure", error); + } + var request = new BMSRequest("", BMSRequest.GET); + request.send(success, failure); + ``` + {: codeblock} + + +# Enlaces relacionados +{: #rellinks notoc} + +## Enlaces relacionados +{: #general notoc} + +* [SDK de Android de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [SDK de iOS de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [SDK de Cordova de BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/es/services.md b/cloudnative/nl/es/services.md index 12a69e90a..193384b78 100644 --- a/cloudnative/nl/es/services.md +++ b/cloudnative/nl/es/services.md @@ -1,54 +1,54 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# Servicios -{: #services} - -Desde la página **Servicios** de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}, puede ver los servicios web y móviles existentes o crear nuevos servicios. La consola proporciona una única ubicación para ver todos los servicios web y móvil de {{site.data.keyword.Bluemix_notm}} gestionados por proyectos. - -Si suprime servicios desde la vista **Servicios**, desconectará el servicio del proyecto con el que está asociado. Cree una nueva instancia de servicio si desea volver a conectar el servicio al proyecto. - -## Visión general de los servicios web y móvil de {{site.data.keyword.Bluemix_notm}} -{: #mobile_services_overview} - -En la tabla siguiente se describen los servicios web y móvil de {{site.data.keyword.Bluemix_notm}}. Puede utilizar los servicios individuales desde el catálogo de {{site.data.keyword.Bluemix_notm}}, o puede integrarlos en el proyecto. - - - - - - - - - - - - - - - - - - - -
Tabla 1. Servicios web y móvil de {{site.data.keyword.Bluemix_notm}}
Servicio web y móvil de {{site.data.keyword.Bluemix_notm}}Descripción
icono de {{site.data.keyword.mobileanalytics_short}}
{{site.data.keyword.mobileanalytics_short}}		Utilice el servicio de {{site.data.keyword.mobileanalytics_full}} para ver información sobre el funcionamiento de las apps para móvil y cómo se utilizan.

-Encontrará más información sobre el funcionamiento de este servicio en la documentación de {{site.data.keyword.mobileanalytics_short}}. -
icono de servicio de {{site.data.keyword.mobilefoundation_short}}
{{site.data.keyword.mobilefoundation_short}}		Utilice el servicio {{site.data.keyword.mobilefoundation_long}} para configurar de forma rápida un entorno de {{site.data.keyword.mfp_full}} en el que pueda desarrollar, probar y trabajar con apps para móvil de la empresa.

-Encontrará más información sobre el funcionamiento de este servicio en la documentación de {{site.data.keyword.mobilefoundation_short}}.
icono de servicio de {{site.data.keyword.mobilepushshort}}
{{site.data.keyword.mobilepushshort}}		El servicio {{site.data.keyword.mobilepushfull}} proporciona una plataforma unificada para enviar y gestionar notificaciones push móviles y de web que están pensadas para varias plataformas. -

-{{site.data.keyword.mobilepushshort}} gestiona la correlación de los usuarios de aplicaciones en sus dispositivos, plataforma de dispositivos y navegadores web, y maneja la asignación de notificaciones push a las mismas. Puede enviar difusiones, difusiones únicas (en función del ID de dispositivo y del ID de usuario) y etiquetas (o temas) como notificaciones push a sus usuarios de aplicaciones móviles y de navegador web. También puede utilizar las API SDK y REST para desarrollar aplicaciones de cliente. -

-Encontrará más información sobre el funcionamiento de este servicio en la documentación de {{site.data.keyword.mobilepushshort}}.
+--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# Servicios +{: #services} + +Desde la página **Servicios** de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}, puede ver los servicios web y móviles existentes o crear nuevos servicios. La consola proporciona una única ubicación para ver todos los servicios web y móvil de {{site.data.keyword.Bluemix_notm}} gestionados por proyectos. + +Si suprime servicios desde la vista **Servicios**, desconectará el servicio del proyecto con el que está asociado. Cree una nueva instancia de servicio si desea volver a conectar el servicio al proyecto. + +## Visión general de los servicios web y móvil de {{site.data.keyword.Bluemix_notm}} +{: #mobile_services_overview} + +En la tabla siguiente se describen los servicios web y móvil de {{site.data.keyword.Bluemix_notm}}. Puede utilizar los servicios individuales desde el catálogo de {{site.data.keyword.Bluemix_notm}}, o puede integrarlos en el proyecto. + + + + + + + + + + + + + + + + + + + +
Tabla 1. Servicios web y móvil de {{site.data.keyword.Bluemix_notm}}
Servicio web y móvil de {{site.data.keyword.Bluemix_notm}}Descripción
icono de {{site.data.keyword.mobileanalytics_short}}
{{site.data.keyword.mobileanalytics_short}}		Utilice el servicio de {{site.data.keyword.mobileanalytics_full}} para ver información sobre el funcionamiento de las apps para móvil y cómo se utilizan.

+Encontrará más información sobre el funcionamiento de este servicio en la documentación de {{site.data.keyword.mobileanalytics_short}}. +
icono de servicio de {{site.data.keyword.mobilefoundation_short}}
{{site.data.keyword.mobilefoundation_short}}		Utilice el servicio {{site.data.keyword.mobilefoundation_long}} para configurar de forma rápida un entorno de {{site.data.keyword.mfp_full}} en el que pueda desarrollar, probar y trabajar con apps para móvil de la empresa.

+Encontrará más información sobre el funcionamiento de este servicio en la documentación de {{site.data.keyword.mobilefoundation_short}}.
icono de servicio de {{site.data.keyword.mobilepushshort}}
{{site.data.keyword.mobilepushshort}}		El servicio {{site.data.keyword.mobilepushfull}} proporciona una plataforma unificada para enviar y gestionar notificaciones push móviles y de web que están pensadas para varias plataformas. +

+{{site.data.keyword.mobilepushshort}} gestiona la correlación de los usuarios de aplicaciones en sus dispositivos, plataforma de dispositivos y navegadores web, y maneja la asignación de notificaciones push a las mismas. Puede enviar difusiones, difusiones únicas (en función del ID de dispositivo y del ID de usuario) y etiquetas (o temas) como notificaciones push a sus usuarios de aplicaciones móviles y de navegador web. También puede utilizar las API SDK y REST para desarrollar aplicaciones de cliente. +

+Encontrará más información sobre el funcionamiento de este servicio en la documentación de {{site.data.keyword.mobilepushshort}}.
diff --git a/cloudnative/nl/es/starters.md b/cloudnative/nl/es/starters.md index 994d7d55f..8b1440645 100644 --- a/cloudnative/nl/es/starters.md +++ b/cloudnative/nl/es/starters.md @@ -1,26 +1,26 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Iniciadores -{: #starters} - -Con la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}, puede elegir entre una variedad de iniciadores para cada tipo de patrón. - -Los iniciadores están optimizados para ser código del iniciador listo para la producción que se centra en demostrar una integración de {{site.data.keyword.Bluemix_notm}} clave con un servicio de alto valor. Cada iniciador se centra en un servicio y muestra la integración de los SDK del servicio en el código. En algunos casos, los iniciadores ofrecen una experiencia de usuario simple para resaltar la integración de los datos del servicio o de las interacciones con el usuario. Cada iniciador está configurado para habilitarse con Authentication, Data y posiblemente otras prestaciones, si decide configurarlas para el proyecto. - - -## Guías de aprendizaje -{: #tutorials notoc} - -Para ver instrucciones detalladas sobre cómo crear apps con iniciadores, puede utilizar las [guías de aprendizaje](tutorials.html). +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Iniciadores +{: #starters} + +Con la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}, puede elegir entre una variedad de iniciadores para cada tipo de patrón. + +Los iniciadores están optimizados para ser código del iniciador listo para la producción que se centra en demostrar una integración de {{site.data.keyword.Bluemix_notm}} clave con un servicio de alto valor. Cada iniciador se centra en un servicio y muestra la integración de los SDK del servicio en el código. En algunos casos, los iniciadores ofrecen una experiencia de usuario simple para resaltar la integración de los datos del servicio o de las interacciones con el usuario. Cada iniciador está configurado para habilitarse con Authentication, Data y posiblemente otras prestaciones, si decide configurarlas para el proyecto. + + +## Guías de aprendizaje +{: #tutorials notoc} + +Para ver instrucciones detalladas sobre cómo crear apps con iniciadores, puede utilizar las [guías de aprendizaje](tutorials.html). diff --git a/cloudnative/nl/es/troubleshoot.md b/cloudnative/nl/es/troubleshoot.md index 69ac89d0e..d70f17a39 100644 --- a/cloudnative/nl/es/troubleshoot.md +++ b/cloudnative/nl/es/troubleshoot.md @@ -1,223 +1,223 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Resolución de problemas -{: #ts} - -Se documentan algunos problemas conocidos con el {{site.data.keyword.dev_cli_notm}}, junto con sus soluciones temporales. -{:shortdesc} - - - -## Problemas conocidos -{: #knownissues} - -En las secciones siguientes se describen problemas conocidos y posibles soluciones. - - -### El nombre de host da un error al crear un proyecto con un patrón no móvil -{: #hostname} - -Es posible que le aparezca el siguiente error si utiliza {{site.data.keyword.dev_cli_short}} para crear un proyecto desde los patrones de app web, BFF o microservicio: - -``` -El nombre de host ya se ha utilizado. -``` -{: codeblock} - - -#### Motivo -{: #hostname-cause} - -Este error se debe a una señal de inicio de sesión caducada. - - -#### Resolución -{: #hostname-resolution} - -Vuelva a iniciar la sesión. - -``` -bx login -``` -{: codeblock} - - -### Fallos generales con el {{site.data.keyword.dev_cli_short}} -{: #general} - -Es posible que le aparezca el siguiente error si utiliza los mandatos crear, suprimir, listar o codificar de {{site.data.keyword.dev_cli_short}}: - -``` -No se ha podido el proyecto. -``` -{: codeblock} - - -#### Motivo -{: #hostname-cause} - -Este error se debe a una señal de inicio de sesión caducada. - - -#### Resolución -{: #hostname-resolution} - -Vuelva a iniciar la sesión. - -``` -bx login -``` -{: codeblock} - - -### Error de intermediario de servicio al añadir la prestación de {{site.data.keyword.objectstorageshort}} -{: #os} - -Es posible que le aparezca el siguiente error si utiliza {{site.data.keyword.dev_cli_short}} para crear dos proyectos con la prestación {{site.data.keyword.objectstorageshort}}: - -``` -FALLIDO -Error de intermediario de servicio: {"description"=>"No puede crear esta instancia de Object Storage. Todas las organizaciones que utilicen el servicio de Object Storage están limitadas a unan instancia del plan gratuito."} -``` -{: codeblock} - - -#### Motivo -{: #os-cause} - -Este error se debe al servicio de {{site.data.keyword.objectstorageshort}} que permite solo una instancia del plan de {{site.data.keyword.objectstorageshort}} gratuito. - - -#### Resolución -{: #os-resolution} - -Se le solicitará que elija otro plan para evitar este error. - - -### Erro al obtener el código durante la creación del proyecto -{: #code} - -Es posible que le aparezca el siguiente error si utiliza {{site.data.keyword.dev_cli_short}} para crear un proyecto: - -``` -FALLIDO -Se ha creado el proyecto, pero no se ha podido obtener el código -https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code -``` -{: codeblock} - - -#### Motivo -{: #code-cause} - -Este error se debe a un tiempo de espera interno excedido. - - -#### Resolución -{: #code-resolution} - -Puede obtener el código de una de las siguientes formas: - -* Ejecute el siguiente mandato utilizando la CLI: - - ``` - bx dev code - ``` - {: codeblock} - - `` debe sustituirse por el nombre de proyecto que ha utilizado durante la creación del proyecto. - -* Utilice la {{site.data.keyword.dev_console}}. - - 1. Seleccione el [proyecto ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://console.{DomainName}/developer/projects) en la {{site.data.keyword.dev_console}} y pulse **Obtener el código**. - - 2. Pulse **Generar código**. - - 3. Después de generar el código, pulse **Descargar código**. - - -### Error al ejecutar `bx dev run` para proyectos de Node.js -{: #node} - -Es posible que le aparezca el siguiente error si ejecuta `bx dev run` con {{site.data.keyword.dev_cli_short}} para proyectos web o BFF de Node.js: - -``` -module.js:597 - return process.dlopen(module, path._makeLong(filename)); - ^ - -Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header - at Error (native) - at Object.Module._extensions..node (module.js:597:18) - at Module.load (module.js:487:32) - at tryModuleLoad (module.js:446:12) - - at Function.Module._load (module.js:438:3) - at Module.require (module.js:497:17) - at require (internal/module.js:20:19) - at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) - at Module._compile (module.js:570:32) - at Object.Module._extensions..js (module.js:579:10) -``` -{: codeblock} - - -#### Motivo -{: #node-cause} - -Este error se debe a que el módulo `appmetrics` se ha instalado en otra arquitectura. Los módulos npm nativos instalados en una arquitectura no funcionarán en otra. Las imágenes de Docker incluidas se basan en el kernel de Linux. - - -#### Resolución -{: #node-resolution} - -Suprima la carpeta `node_modules` y vuelva a ejecutar `bx dev run`. - - - - - - - -## Obtención de ayuda y soporte -{: #gettinghelp} - -Si tiene problemas o preguntas sobre el uso de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} o {{site.data.keyword.dev_cli_notm}}, puede obtener ayuda buscando información o formulando preguntas a través de un foro. También puede abrir una incidencia de soporte. - -Cuando utilice los foros para formular preguntas, etiquete la pregunta de modo que los equipos de desarrollo de {{site.data.keyword.Bluemix_notm}} la vean. - - - -Si tiene preguntas técnicas sobre el desarrollo o el despliegue de una aplicación con la {{site.data.keyword.dev_console}} o {{site.data.keyword.dev_cli_notm}}: - -* Publique la pregunta en [Stack Overflow ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) y etiquete la pregunta con `bluemix-dev-services` e `ibm-bluemix`. -* Publique la pregunta en [Slack ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://ibm-cloud-tech.slack.com/) en el canal `bluemix-dev-services`. [Inicie sesión en ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://ibm.biz/IBMCloudNativeSlack) hoy mismo. - - - - - -Consulte [Obtención de ayuda ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/support/index.html#getting-help) para obtener más información detallada sobre el uso de los foros. - -Para obtener información sobre cómo abrir una incidencia de soporte de {{site.data.keyword.IBM}}, o sobre los niveles de soporte y gravedades de las incidencias, consulte [Cómo obtener soporte ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/support/index.html#contacting-support). - - - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Resolución de problemas +{: #ts} + +Se documentan algunos problemas conocidos con el {{site.data.keyword.dev_cli_notm}}, junto con sus soluciones temporales. +{:shortdesc} + + + +## Problemas conocidos +{: #knownissues} + +En las secciones siguientes se describen problemas conocidos y posibles soluciones. + + +### El nombre de host da un error al crear un proyecto con un patrón no móvil +{: #hostname} + +Es posible que le aparezca el siguiente error si utiliza {{site.data.keyword.dev_cli_short}} para crear un proyecto desde los patrones de app web, BFF o microservicio: + +``` +El nombre de host ya se ha utilizado. +``` +{: codeblock} + + +#### Motivo +{: #hostname-cause} + +Este error se debe a una señal de inicio de sesión caducada. + + +#### Resolución +{: #hostname-resolution} + +Vuelva a iniciar la sesión. + +``` +bx login +``` +{: codeblock} + + +### Fallos generales con el {{site.data.keyword.dev_cli_short}} +{: #general} + +Es posible que le aparezca el siguiente error si utiliza los mandatos crear, suprimir, listar o codificar de {{site.data.keyword.dev_cli_short}}: + +``` +No se ha podido el proyecto. +``` +{: codeblock} + + +#### Motivo +{: #hostname-cause} + +Este error se debe a una señal de inicio de sesión caducada. + + +#### Resolución +{: #hostname-resolution} + +Vuelva a iniciar la sesión. + +``` +bx login +``` +{: codeblock} + + +### Error de intermediario de servicio al añadir la prestación de {{site.data.keyword.objectstorageshort}} +{: #os} + +Es posible que le aparezca el siguiente error si utiliza {{site.data.keyword.dev_cli_short}} para crear dos proyectos con la prestación {{site.data.keyword.objectstorageshort}}: + +``` +FALLIDO +Error de intermediario de servicio: {"description"=>"No puede crear esta instancia de Object Storage. Todas las organizaciones que utilicen el servicio de Object Storage están limitadas a unan instancia del plan gratuito."} +``` +{: codeblock} + + +#### Motivo +{: #os-cause} + +Este error se debe al servicio de {{site.data.keyword.objectstorageshort}} que permite solo una instancia del plan de {{site.data.keyword.objectstorageshort}} gratuito. + + +#### Resolución +{: #os-resolution} + +Se le solicitará que elija otro plan para evitar este error. + + +### Erro al obtener el código durante la creación del proyecto +{: #code} + +Es posible que le aparezca el siguiente error si utiliza {{site.data.keyword.dev_cli_short}} para crear un proyecto: + +``` +FALLIDO +Se ha creado el proyecto, pero no se ha podido obtener el código +https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code +``` +{: codeblock} + + +#### Motivo +{: #code-cause} + +Este error se debe a un tiempo de espera interno excedido. + + +#### Resolución +{: #code-resolution} + +Puede obtener el código de una de las siguientes formas: + +* Ejecute el siguiente mandato utilizando la CLI: + + ``` + bx dev code + ``` + {: codeblock} + + `` debe sustituirse por el nombre de proyecto que ha utilizado durante la creación del proyecto. + +* Utilice la {{site.data.keyword.dev_console}}. + + 1. Seleccione el [proyecto ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](https://console.{DomainName}/developer/projects) en la {{site.data.keyword.dev_console}} y pulse **Obtener el código**. + + 2. Pulse **Generar código**. + + 3. Después de generar el código, pulse **Descargar código**. + + +### Error al ejecutar `bx dev run` para proyectos de Node.js +{: #node} + +Es posible que le aparezca el siguiente error si ejecuta `bx dev run` con {{site.data.keyword.dev_cli_short}} para proyectos web o BFF de Node.js: + +``` +module.js:597 + return process.dlopen(module, path._makeLong(filename)); + ^ + +Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header + at Error (native) + at Object.Module._extensions..node (module.js:597:18) + at Module.load (module.js:487:32) + at tryModuleLoad (module.js:446:12) + + at Function.Module._load (module.js:438:3) + at Module.require (module.js:497:17) + at require (internal/module.js:20:19) + at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) + at Module._compile (module.js:570:32) + at Object.Module._extensions..js (module.js:579:10) +``` +{: codeblock} + + +#### Motivo +{: #node-cause} + +Este error se debe a que el módulo `appmetrics` se ha instalado en otra arquitectura. Los módulos npm nativos instalados en una arquitectura no funcionarán en otra. Las imágenes de Docker incluidas se basan en el kernel de Linux. + + +#### Resolución +{: #node-resolution} + +Suprima la carpeta `node_modules` y vuelva a ejecutar `bx dev run`. + + + + + + + +## Obtención de ayuda y soporte +{: #gettinghelp} + +Si tiene problemas o preguntas sobre el uso de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} o {{site.data.keyword.dev_cli_notm}}, puede obtener ayuda buscando información o formulando preguntas a través de un foro. También puede abrir una incidencia de soporte. + +Cuando utilice los foros para formular preguntas, etiquete la pregunta de modo que los equipos de desarrollo de {{site.data.keyword.Bluemix_notm}} la vean. + + + +Si tiene preguntas técnicas sobre el desarrollo o el despliegue de una aplicación con la {{site.data.keyword.dev_console}} o {{site.data.keyword.dev_cli_notm}}: + +* Publique la pregunta en [Stack Overflow ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) y etiquete la pregunta con `bluemix-dev-services` e `ibm-bluemix`. +* Publique la pregunta en [Slack ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://ibm-cloud-tech.slack.com/) en el canal `bluemix-dev-services`. [Inicie sesión en ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](http://ibm.biz/IBMCloudNativeSlack) hoy mismo. + + + + + +Consulte [Obtención de ayuda ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/support/index.html#getting-help) para obtener más información detallada sobre el uso de los foros. + +Para obtener información sobre cómo abrir una incidencia de soporte de {{site.data.keyword.IBM}}, o sobre los niveles de soporte y gravedades de las incidencias, consulte [Cómo obtener soporte ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/support/index.html#contacting-support). + + + diff --git a/cloudnative/nl/es/tutorial_bff.md b/cloudnative/nl/es/tutorial_bff.md index a3975f789..a836d11a6 100644 --- a/cloudnative/nl/es/tutorial_bff.md +++ b/cloudnative/nl/es/tutorial_bff.md @@ -1,147 +1,147 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Guía de aprendizaje del iniciador BFF Basic -{: #tutorial} - -En la siguiente guía de aprendizaje encontrará los pasos a seguir para crear un proyecto desde el iniciador BFF Basic Starter, incluidas las herramientas que debe tener instaladas y, por lo tanto, los pasos para ejecutar el código del proyecto. - -## Instalación de herramientas del desarrollador -{: #dev_tools} - -Asegúrese de haber instalado las [herramientas de desarrollador necesarias ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](get_code.html#prereq-dev-tools){: new_window}. - - -## Creación de un proyecto mediante la {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Cree un proyecto en la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}. - - 1. Desde la página **Cómo empezar** en la {{site.data.keyword.dev_console}}, pulse **Crear proyecto**. - - De forma alternativa, puede pulsar **Crear proyecto** desde la página **Proyectos**. - - 2. Seleccione **Programa de fondo para programa de usuario** y pulse **Siguiente**. - - 3. Seleccione **Programa de fondo básico** y pulse **Siguiente**. - - 4. Especifique el nombre del proyecto. En esta guía de aprendizaje, utilizaremos `BFFProject`. - - 5. Especifique un nombre de host. En esta guía de aprendizaje, utilizaremos `devhost` - - 6. Seleccione el lenguaje de la plataforma. En esta guía de aprendizaje, utilizaremos `Node`. - - 7. Pulse **Crear**. - -2. Opcional: Añada la capacidad de Datos. - - 1. Pulse **Ver** para **Datos** en la página **Visión general del proyecto**. - - De forma alternativa, puede seleccionar **Crear** o **Añadir existente** en la página **Prestaciones > Data**. - - 2. Especifique el nombre del servicio y pulse **Crear**. - - -3. Genere el código del proyecto. - - 1. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. - - Como alternativa, pulse la página **Código**. - - 2. Pulse **Generar código**. - - 3. Cuando se haya generado el código, pulse **Descargar código** para descargar el archivo del proyecto. - -4. Opcional: [Actualización del proyecto](project_overview_page.html#update_language) para generar un nuevo lenguaje. - - -## Creación de un proyecto mediante {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Asegúrese de haber instalado [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. En la solicitud de terminal, vaya al directorio local que prefiera y ejecute el siguiente mandato. - - ``` - bx dev create - ``` - {: codeblock} - -3. Proporcione los siguientes valores cuando se le solicite: - - * Seleccione un patrón: 3 (para Programa de fondo para programa de usuario) - * Seleccione un iniciador: 1 (para Programa de fondo básico) - * Seleccione un lenguaje: 1 (para Node) - * Especifique un nombre para el proyecto: `BFFProjectCLI` - * Especifique un nombre de host para el proyecto: `myhost` - -4. Si desea añadir servicios al proyecto, escriba `y` en la solicitud de preguntas y responda el resto de las preguntas. - -5. Cuando `BFFProjectCLI` se haya guardado correctamente, vaya a la carpeta `BFFProjectCLI`. - -6. En este punto, puede añadir su propio código, crear o ejecutar el proyecto. - - 1. Cree el proyecto con el siguiente mandato: - - ``` - bx dev build - ``` - {: codeblock} - - 2. Ejecute el proyecto con el siguiente mandato: - - ``` - bx dev run - ``` - {: codeblock} - - -## Ejecución de un proyecto de BFF -{: #running-bff} - -### Localmente -{: #bff-local} - -1. Compile el servidor: - - ``` - swift build - ``` - {: codeblock} - -2. Ejecute la aplicación. Por ejemplo, suponiendo que su aplicación se llama `MyServer`: - - ``` - .build/debug/MyServer - ``` - {: codeblock} - -3. Puede ejecutar curl en el servidor con `curl http://localhost:8080` - - -### Utilización del plugin de Bluemix -{: #using-blumix} - -1. Ejecute la compilación - - ``` - bx dev run - ``` - {: codeblock} - -2. Puede ejecutar curl en el servidor con - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Guía de aprendizaje del iniciador BFF Basic +{: #tutorial} + +En la siguiente guía de aprendizaje encontrará los pasos a seguir para crear un proyecto desde el iniciador BFF Basic Starter, incluidas las herramientas que debe tener instaladas y, por lo tanto, los pasos para ejecutar el código del proyecto. + +## Instalación de herramientas del desarrollador +{: #dev_tools} + +Asegúrese de haber instalado las [herramientas de desarrollador necesarias ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](get_code.html#prereq-dev-tools){: new_window}. + + +## Creación de un proyecto mediante la {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Cree un proyecto en la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}. + + 1. Desde la página **Cómo empezar** en la {{site.data.keyword.dev_console}}, pulse **Crear proyecto**. + + De forma alternativa, puede pulsar **Crear proyecto** desde la página **Proyectos**. + + 2. Seleccione **Programa de fondo para programa de usuario** y pulse **Siguiente**. + + 3. Seleccione **Programa de fondo básico** y pulse **Siguiente**. + + 4. Especifique el nombre del proyecto. En esta guía de aprendizaje, utilizaremos `BFFProject`. + + 5. Especifique un nombre de host. En esta guía de aprendizaje, utilizaremos `devhost` + + 6. Seleccione el lenguaje de la plataforma. En esta guía de aprendizaje, utilizaremos `Node`. + + 7. Pulse **Crear**. + +2. Opcional: Añada la capacidad de Datos. + + 1. Pulse **Ver** para **Datos** en la página **Visión general del proyecto**. + + De forma alternativa, puede seleccionar **Crear** o **Añadir existente** en la página **Prestaciones > Data**. + + 2. Especifique el nombre del servicio y pulse **Crear**. + + +3. Genere el código del proyecto. + + 1. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. + + Como alternativa, pulse la página **Código**. + + 2. Pulse **Generar código**. + + 3. Cuando se haya generado el código, pulse **Descargar código** para descargar el archivo del proyecto. + +4. Opcional: [Actualización del proyecto](project_overview_page.html#update_language) para generar un nuevo lenguaje. + + +## Creación de un proyecto mediante {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Asegúrese de haber instalado [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. En la solicitud de terminal, vaya al directorio local que prefiera y ejecute el siguiente mandato. + + ``` + bx dev create + ``` + {: codeblock} + +3. Proporcione los siguientes valores cuando se le solicite: + + * Seleccione un patrón: 3 (para Programa de fondo para programa de usuario) + * Seleccione un iniciador: 1 (para Programa de fondo básico) + * Seleccione un lenguaje: 1 (para Node) + * Especifique un nombre para el proyecto: `BFFProjectCLI` + * Especifique un nombre de host para el proyecto: `myhost` + +4. Si desea añadir servicios al proyecto, escriba `y` en la solicitud de preguntas y responda el resto de las preguntas. + +5. Cuando `BFFProjectCLI` se haya guardado correctamente, vaya a la carpeta `BFFProjectCLI`. + +6. En este punto, puede añadir su propio código, crear o ejecutar el proyecto. + + 1. Cree el proyecto con el siguiente mandato: + + ``` + bx dev build + ``` + {: codeblock} + + 2. Ejecute el proyecto con el siguiente mandato: + + ``` + bx dev run + ``` + {: codeblock} + + +## Ejecución de un proyecto de BFF +{: #running-bff} + +### Localmente +{: #bff-local} + +1. Compile el servidor: + + ``` + swift build + ``` + {: codeblock} + +2. Ejecute la aplicación. Por ejemplo, suponiendo que su aplicación se llama `MyServer`: + + ``` + .build/debug/MyServer + ``` + {: codeblock} + +3. Puede ejecutar curl en el servidor con `curl http://localhost:8080` + + +### Utilización del plugin de Bluemix +{: #using-blumix} + +1. Ejecute la compilación + + ``` + bx dev run + ``` + {: codeblock} + +2. Puede ejecutar curl en el servidor con + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/es/tutorial_microservice.md b/cloudnative/nl/es/tutorial_microservice.md index 0f84eaad8..3e3edf0ed 100644 --- a/cloudnative/nl/es/tutorial_microservice.md +++ b/cloudnative/nl/es/tutorial_microservice.md @@ -1,113 +1,113 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Guía de aprendizaje del iniciador Microservice Basic -{: #tutorial} - -En la siguiente guía de aprendizaje encontrará los pasos a seguir para crear un proyecto desde el iniciador Microservice Basic, incluidas las herramientas que debe tener instaladas y, por lo tanto, los pasos para ejecutar el código del proyecto. - -## Instalación de herramientas del desarrollador -{: #dev_tools} - -Asegúrese de haber instalado las [herramientas de desarrollador necesarias ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](get_code.html#prereq-dev-tools){: new_window}. - - -## Creación de un proyecto mediante la {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Cree un proyecto en la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}. - - 1. Desde la página **Cómo empezar** en la {{site.data.keyword.dev_console}}, pulse **Crear proyecto**. - - De forma alternativa, puede pulsar **Crear proyecto** desde la página **Proyectos**. - - 2. Seleccione **Microservicio** y pulse **Siguiente**. - - 3. Seleccione **Basic** y pulse **Siguiente**. - - 4. Especifique el nombre del proyecto. En esta guía de aprendizaje, utilizaremos `MicroserviceProject`. - - 5. Especifique un nombre de host. En esta guía de aprendizaje, utilizaremos `devhost` - - 6. Pulse **Crear**. - -2. Opcional: Añada la capacidad de Datos. - - 1. Pulse **Ver** para **Datos** en la página **Visión general del proyecto**. - - De forma alternativa, puede seleccionar **Crear** o **Añadir existente** en la página **Prestaciones > Data**. - - 2. Especifique el nombre del servicio y pulse **Crear**. - -3. Genere el código del proyecto. - - 1. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. - - Como alternativa, pulse la página **Código**. - - 2. Pulse **Generar código**. - - 3. Cuando se haya generado el código, pulse **Descargar código** para descargar el archivo del proyecto. - -4. Opcional: [Actualización del proyecto](project_overview_page.html#update_language) para generar un nuevo lenguaje. - - -## Creación de un proyecto mediante {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Asegúrese de haber instalado [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. En la solicitud de terminal, vaya al directorio local que prefiera y ejecute el siguiente mandato. - - ``` - bx dev create - ``` - {: codeblock} - -3. Proporcione los siguientes valores cuando se le solicite: - - * Seleccione un patrón: 4 (para Microservicios) - * Seleccione un iniciador: 1 (para Basic) - * Seleccione una plataforma: 3 (para Java) - * Especifique un nombre para el proyecto: `MicroserviceProjectCLI` - -4. Si desea añadir servicios al proyecto, escriba `y` en la solicitud de preguntas y responda el resto de las preguntas. - -5. Cuando `MicroserviceProjectCLI` se haya guardado correctamente, vaya a la carpeta `MicroserviceProjectCLI`. - -6. En este punto, puede añadir su propio código, crear o ejecutar el proyecto. - - -## Ejecución del proyecto utilizando {{site.data.keyword.dev_cli_notm}} -{: #running-dev-plugin} - -1. Para crear el proyecto en el directorio de proyecto actual, escriba el siguiente mandato: - - ``` - bx dev build - ``` - {: codeblock} - -2. Para crear y ejecutar el proyecto en el directorio de proyecto actual, escriba el siguiente mandato: - - ``` - bx dev run - ``` - {: codeblock} - -3. Puede acceder a la aplicación utilizando curl en el servidor: - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Guía de aprendizaje del iniciador Microservice Basic +{: #tutorial} + +En la siguiente guía de aprendizaje encontrará los pasos a seguir para crear un proyecto desde el iniciador Microservice Basic, incluidas las herramientas que debe tener instaladas y, por lo tanto, los pasos para ejecutar el código del proyecto. + +## Instalación de herramientas del desarrollador +{: #dev_tools} + +Asegúrese de haber instalado las [herramientas de desarrollador necesarias ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](get_code.html#prereq-dev-tools){: new_window}. + + +## Creación de un proyecto mediante la {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Cree un proyecto en la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}. + + 1. Desde la página **Cómo empezar** en la {{site.data.keyword.dev_console}}, pulse **Crear proyecto**. + + De forma alternativa, puede pulsar **Crear proyecto** desde la página **Proyectos**. + + 2. Seleccione **Microservicio** y pulse **Siguiente**. + + 3. Seleccione **Basic** y pulse **Siguiente**. + + 4. Especifique el nombre del proyecto. En esta guía de aprendizaje, utilizaremos `MicroserviceProject`. + + 5. Especifique un nombre de host. En esta guía de aprendizaje, utilizaremos `devhost` + + 6. Pulse **Crear**. + +2. Opcional: Añada la capacidad de Datos. + + 1. Pulse **Ver** para **Datos** en la página **Visión general del proyecto**. + + De forma alternativa, puede seleccionar **Crear** o **Añadir existente** en la página **Prestaciones > Data**. + + 2. Especifique el nombre del servicio y pulse **Crear**. + +3. Genere el código del proyecto. + + 1. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. + + Como alternativa, pulse la página **Código**. + + 2. Pulse **Generar código**. + + 3. Cuando se haya generado el código, pulse **Descargar código** para descargar el archivo del proyecto. + +4. Opcional: [Actualización del proyecto](project_overview_page.html#update_language) para generar un nuevo lenguaje. + + +## Creación de un proyecto mediante {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Asegúrese de haber instalado [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. En la solicitud de terminal, vaya al directorio local que prefiera y ejecute el siguiente mandato. + + ``` + bx dev create + ``` + {: codeblock} + +3. Proporcione los siguientes valores cuando se le solicite: + + * Seleccione un patrón: 4 (para Microservicios) + * Seleccione un iniciador: 1 (para Basic) + * Seleccione una plataforma: 3 (para Java) + * Especifique un nombre para el proyecto: `MicroserviceProjectCLI` + +4. Si desea añadir servicios al proyecto, escriba `y` en la solicitud de preguntas y responda el resto de las preguntas. + +5. Cuando `MicroserviceProjectCLI` se haya guardado correctamente, vaya a la carpeta `MicroserviceProjectCLI`. + +6. En este punto, puede añadir su propio código, crear o ejecutar el proyecto. + + +## Ejecución del proyecto utilizando {{site.data.keyword.dev_cli_notm}} +{: #running-dev-plugin} + +1. Para crear el proyecto en el directorio de proyecto actual, escriba el siguiente mandato: + + ``` + bx dev build + ``` + {: codeblock} + +2. Para crear y ejecutar el proyecto en el directorio de proyecto actual, escriba el siguiente mandato: + + ``` + bx dev run + ``` + {: codeblock} + +3. Puede acceder a la aplicación utilizando curl en el servidor: + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/es/tutorial_mobile.md b/cloudnative/nl/es/tutorial_mobile.md index 860c5f37b..3665b512f 100644 --- a/cloudnative/nl/es/tutorial_mobile.md +++ b/cloudnative/nl/es/tutorial_mobile.md @@ -1,187 +1,187 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Guía de aprendizaje del iniciador Mobile Basic -{: #tutorial} - -En la siguiente guía de aprendizaje encontrará los pasos a seguir para crear un proyecto desde el iniciador Mobile Basic, incluidas las herramientas que debe tener instaladas y, por lo tanto, los pasos para ejecutar el proyecto en Xcode y Android Studio. - - -## Instalación de herramientas del desarrollador -{: #dev_tools} - -Asegúrese de haber instalado las [herramientas de desarrollador necesarias ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](get_code.html#prereq-dev-tools){: new_window}. - - -## Creación de un proyecto mediante la {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Cree un proyecto de {{site.data.keyword.dev_console}} en {{site.data.keyword.Bluemix}}. - - 1. Desde la página **Cómo empezar** en la {{site.data.keyword.dev_console}}, pulse **Crear proyecto**. - - De forma alternativa, puede pulsar **Crear proyecto** desde la página **Proyectos**. - - 2. Seleccione **Aplicación móvil** y pulse **Siguiente**. - - 3. Seleccione **Basic** y pulse **Siguiente**. - - 4. Especifique el nombre del proyecto. En esta guía de aprendizaje, utilizaremos `MobileBasicProject`. - - 5. Seleccione su plataforma. En esta guía de aprendizaje, utilizaremos `Swift`. - - 6. Pulse **Crear**. - -2. Opcional: Añada capacidad de autenticación. - - 1. Pulse **Añadir** para **Autenticación** en la página **Visión general del proyecto**. - - De forma alternativa, puede seleccionar **Crear** o **Añadir existente** en la página **Prestaciones > Authentication**. - - 2. Especifique el nombre del servicio y pulse **Crear**. - - 3. Active **Autenticación**. - - 4. Seleccione su proveedor de identidad y especifique la información necesaria para configurarlo. Solo puede habilitar un proveedor de identidad. - - 5. Consulte [Configuración de los proveedores de identidad} ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/services/appid/identity-providers.html){: new_window} para obtener más información sobre cómo configurar Authentication. - -3. Opcional: Añada capacidad de análisis. - - 1. Pulse **Añadir** para **Análisis** en la página **Visión general del proyecto**. - - De forma alternativa, pulse **Crear** o **Añadir existente** desde la página **Prestaciones > Analytics**. - - 2. Especifique el nombre del servicio y pulse **Crear**. - - 3. Desactive la **Modalidad de demostración** para ver los datos del análisis después de ejecutar la app. - - 4. Consulte [Iniciación a {{site.data.keyword.mobileanalytics_short}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/services/mobileanalytics/index.html){: new_window} para obtener más información sobre cómo configurar Analytics. - -4. Opcional: Añada la función de {{site.data.keyword.mobilepushshort}}. - - 1. Pulse **Añadir** para **{{site.data.keyword.mobilepushshort}}** en la página **Visión general del proyecto**. - - De forma alternativa, pulse **Crear** o **Añadir existente** desde la página **Prestaciones > {{site.data.keyword.mobilepushshort}}**. - - 2. Especifique el nombre del servicio y pulse **Crear**. - - 3. Para iOS, [configure el servicio de notificación Push de Apple ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}. - - 4. Para Android, [configure Firebase Cloud Messaging ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}. - -5. Opcional: Añada la capacidad de Datos. - - 1. Pulse **Ver** para **Datos** en la página **Visión general del proyecto**. - - De forma alternativa, puede seleccionar **Crear** en la página **Datos**. - - 2. Elija **{{site.data.keyword.cloudant_short_notm}}** o **{{site.data.keyword.objectstorageshort}}**. - - 3. Especifique el nombre del servicio y pulse **Crear**. - - 4. Consulte [Iniciación a {{site.data.keyword.cloudant_short_notm}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/services/Cloudant/index.html){: new_window} para obtener más información sobre cómo configurar {{site.data.keyword.cloudant_short_notm}}. - - 5. Consulte [Iniciación a {{site.data.keyword.objectstorageshort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/services/ObjectStorage/index.html){: new_window} para obtener más información sobre cómo configurar {{site.data.keyword.objectstorageshort}}. - -6. Genere el código del proyecto. - - 1. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. - - Como alternativa, pulse la página **Código**. - - 2. Pulse **Generar Swift**. - - 3. Cuando se haya generado el código, pulse **Descargar Swift** para descargar el archivo del proyecto. - -7. Opcional: [Actualización del proyecto](project_overview_page.html#update_language) para generar un nuevo lenguaje. - - -## Creación de un proyecto mediante {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Asegúrese de haber instalado [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. En la solicitud de terminal, vaya al directorio local que prefiera y ejecute el siguiente mandato. - - ``` - bx dev create - ``` - {: codeblock} - -3. Proporcione los siguientes valores cuando se le solicite: - - * Seleccione un patrón: 2 (para Móvil) - * Seleccione un iniciador: 1 (para Basic) - * Seleccione una plataforma: 3 (para iOS Swift) - * Especifique un nombre para el proyecto: `MobileBasicProjectCLI` - -4. Si desea añadir servicios al proyecto, escriba `y` en la solicitud de preguntas y responda el resto de las preguntas. - -5. Cuando `MobileBasicProjectCLI` se haya guardado correctamente, vaya a la carpeta `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift`. - - -## Ejecución del proyecto Swift en Xcode -{: #run_swift} - -1. Extraiga el archivo `MobileBasicProject-Swift.zip`. - -2. Abra el archivo `README.md` en un visor Markdown para ver los pasos a seguir para configurar el proyecto. - - 1. Abra el terminar y vaya a la carpeta del proyecto. - - 1. Ejecute `pod setup` si tiene que configurar el repositorio de CocoaPods. - - 2. Ejecute `pod update` si tiene que actualizar los pods existentes. - - 3. Ejecute `pod install` para instalar los pods necesarios para el proyecto. - - 3. Abra el espacio de trabajo Xcode `BasicProject.xcworkspace`. - -3. Ejecute la app. - - -## Ejecución del proyecto Cordova en Xcode -{: #run_cordova_xcode} - -1. Extraiga el archivo `MobileBasicProject-Cordova.zip`. - -2. Abra el archivo `README.md` en un visor Markdown para configurar el proyecto. - - 1. Abra el proyecto `platforms/ios` en Xcode. - -3. Ejecute la app. - - -## Ejecución del proyecto Cordova en Android Studio -{: #run_cordova_studio} - -1. Extraiga el archivo `BasicProject-Cordova.zip`. - -2. Abra el archivo `README.md` en un visor Markdown para configurar el proyecto. - - 1. Abra el proyecto `platforms/android` en Android Studio. - -3. Ejecute la app. - - -## Ejecución del proyecto Android en Android Studio -{: #run_android} - -1. Extraiga el archivo `MobileBasicProject-Android.zip`. - -2. Abra el archivo `README.md` en un visor Markdown para configurar el proyecto. - - 1. Abra el proyecto `BasicProject-Android` en Android Studio. - -3. Ejecute la app. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Guía de aprendizaje del iniciador Mobile Basic +{: #tutorial} + +En la siguiente guía de aprendizaje encontrará los pasos a seguir para crear un proyecto desde el iniciador Mobile Basic, incluidas las herramientas que debe tener instaladas y, por lo tanto, los pasos para ejecutar el proyecto en Xcode y Android Studio. + + +## Instalación de herramientas del desarrollador +{: #dev_tools} + +Asegúrese de haber instalado las [herramientas de desarrollador necesarias ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](get_code.html#prereq-dev-tools){: new_window}. + + +## Creación de un proyecto mediante la {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Cree un proyecto de {{site.data.keyword.dev_console}} en {{site.data.keyword.Bluemix}}. + + 1. Desde la página **Cómo empezar** en la {{site.data.keyword.dev_console}}, pulse **Crear proyecto**. + + De forma alternativa, puede pulsar **Crear proyecto** desde la página **Proyectos**. + + 2. Seleccione **Aplicación móvil** y pulse **Siguiente**. + + 3. Seleccione **Basic** y pulse **Siguiente**. + + 4. Especifique el nombre del proyecto. En esta guía de aprendizaje, utilizaremos `MobileBasicProject`. + + 5. Seleccione su plataforma. En esta guía de aprendizaje, utilizaremos `Swift`. + + 6. Pulse **Crear**. + +2. Opcional: Añada capacidad de autenticación. + + 1. Pulse **Añadir** para **Autenticación** en la página **Visión general del proyecto**. + + De forma alternativa, puede seleccionar **Crear** o **Añadir existente** en la página **Prestaciones > Authentication**. + + 2. Especifique el nombre del servicio y pulse **Crear**. + + 3. Active **Autenticación**. + + 4. Seleccione su proveedor de identidad y especifique la información necesaria para configurarlo. Solo puede habilitar un proveedor de identidad. + + 5. Consulte [Configuración de los proveedores de identidad} ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/services/appid/identity-providers.html){: new_window} para obtener más información sobre cómo configurar Authentication. + +3. Opcional: Añada capacidad de análisis. + + 1. Pulse **Añadir** para **Análisis** en la página **Visión general del proyecto**. + + De forma alternativa, pulse **Crear** o **Añadir existente** desde la página **Prestaciones > Analytics**. + + 2. Especifique el nombre del servicio y pulse **Crear**. + + 3. Desactive la **Modalidad de demostración** para ver los datos del análisis después de ejecutar la app. + + 4. Consulte [Iniciación a {{site.data.keyword.mobileanalytics_short}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/services/mobileanalytics/index.html){: new_window} para obtener más información sobre cómo configurar Analytics. + +4. Opcional: Añada la función de {{site.data.keyword.mobilepushshort}}. + + 1. Pulse **Añadir** para **{{site.data.keyword.mobilepushshort}}** en la página **Visión general del proyecto**. + + De forma alternativa, pulse **Crear** o **Añadir existente** desde la página **Prestaciones > {{site.data.keyword.mobilepushshort}}**. + + 2. Especifique el nombre del servicio y pulse **Crear**. + + 3. Para iOS, [configure el servicio de notificación Push de Apple ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}. + + 4. Para Android, [configure Firebase Cloud Messaging ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}. + +5. Opcional: Añada la capacidad de Datos. + + 1. Pulse **Ver** para **Datos** en la página **Visión general del proyecto**. + + De forma alternativa, puede seleccionar **Crear** en la página **Datos**. + + 2. Elija **{{site.data.keyword.cloudant_short_notm}}** o **{{site.data.keyword.objectstorageshort}}**. + + 3. Especifique el nombre del servicio y pulse **Crear**. + + 4. Consulte [Iniciación a {{site.data.keyword.cloudant_short_notm}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/services/Cloudant/index.html){: new_window} para obtener más información sobre cómo configurar {{site.data.keyword.cloudant_short_notm}}. + + 5. Consulte [Iniciación a {{site.data.keyword.objectstorageshort}} ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](/docs/services/ObjectStorage/index.html){: new_window} para obtener más información sobre cómo configurar {{site.data.keyword.objectstorageshort}}. + +6. Genere el código del proyecto. + + 1. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. + + Como alternativa, pulse la página **Código**. + + 2. Pulse **Generar Swift**. + + 3. Cuando se haya generado el código, pulse **Descargar Swift** para descargar el archivo del proyecto. + +7. Opcional: [Actualización del proyecto](project_overview_page.html#update_language) para generar un nuevo lenguaje. + + +## Creación de un proyecto mediante {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Asegúrese de haber instalado [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. En la solicitud de terminal, vaya al directorio local que prefiera y ejecute el siguiente mandato. + + ``` + bx dev create + ``` + {: codeblock} + +3. Proporcione los siguientes valores cuando se le solicite: + + * Seleccione un patrón: 2 (para Móvil) + * Seleccione un iniciador: 1 (para Basic) + * Seleccione una plataforma: 3 (para iOS Swift) + * Especifique un nombre para el proyecto: `MobileBasicProjectCLI` + +4. Si desea añadir servicios al proyecto, escriba `y` en la solicitud de preguntas y responda el resto de las preguntas. + +5. Cuando `MobileBasicProjectCLI` se haya guardado correctamente, vaya a la carpeta `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift`. + + +## Ejecución del proyecto Swift en Xcode +{: #run_swift} + +1. Extraiga el archivo `MobileBasicProject-Swift.zip`. + +2. Abra el archivo `README.md` en un visor Markdown para ver los pasos a seguir para configurar el proyecto. + + 1. Abra el terminar y vaya a la carpeta del proyecto. + + 1. Ejecute `pod setup` si tiene que configurar el repositorio de CocoaPods. + + 2. Ejecute `pod update` si tiene que actualizar los pods existentes. + + 3. Ejecute `pod install` para instalar los pods necesarios para el proyecto. + + 3. Abra el espacio de trabajo Xcode `BasicProject.xcworkspace`. + +3. Ejecute la app. + + +## Ejecución del proyecto Cordova en Xcode +{: #run_cordova_xcode} + +1. Extraiga el archivo `MobileBasicProject-Cordova.zip`. + +2. Abra el archivo `README.md` en un visor Markdown para configurar el proyecto. + + 1. Abra el proyecto `platforms/ios` en Xcode. + +3. Ejecute la app. + + +## Ejecución del proyecto Cordova en Android Studio +{: #run_cordova_studio} + +1. Extraiga el archivo `BasicProject-Cordova.zip`. + +2. Abra el archivo `README.md` en un visor Markdown para configurar el proyecto. + + 1. Abra el proyecto `platforms/android` en Android Studio. + +3. Ejecute la app. + + +## Ejecución del proyecto Android en Android Studio +{: #run_android} + +1. Extraiga el archivo `MobileBasicProject-Android.zip`. + +2. Abra el archivo `README.md` en un visor Markdown para configurar el proyecto. + + 1. Abra el proyecto `BasicProject-Android` en Android Studio. + +3. Ejecute la app. diff --git a/cloudnative/nl/es/tutorial_web.md b/cloudnative/nl/es/tutorial_web.md index 579f9c71c..fa456b194 100644 --- a/cloudnative/nl/es/tutorial_web.md +++ b/cloudnative/nl/es/tutorial_web.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Guía de aprendizaje del iniciador Web Basic -{: #tutorial} - -En la siguiente guía de aprendizaje encontrará los pasos a seguir para crear un proyecto desde el iniciador Web Basic, incluidas las herramientas que debe tener instaladas y, por lo tanto, los pasos para ejecutar el código del proyecto. - -## Instalación de herramientas del desarrollador -{: #dev_tools} - -Asegúrese de haber instalado las [herramientas de desarrollador necesarias ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](get_code.html#prereq-dev-tools){: new_window}. - - -## Creación de un proyecto mediante la {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Cree un proyecto en la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}. - - 1. Desde la página **Cómo empezar** en la {{site.data.keyword.dev_console}}, pulse **Crear proyecto**. - - De forma alternativa, puede pulsar **Crear proyecto** desde la página **Proyectos**. - - 2. Seleccione **Aplicación web** y pulse **Siguiente**. - - 3. Seleccione **Basic Web** y pulse **Siguiente**. - - 4. Especifique el nombre del proyecto. En esta guía de aprendizaje, utilizaremos `WebBasicProject`. - - 5. Especifique un nombre de host. En esta guía de aprendizaje, utilizaremos `devhost` - - 6. Seleccione el lenguaje de la plataforma. En esta guía de aprendizaje, utilizaremos `Swift`. - - 7. Pulse **Crear**. - -2. Opcional: Añada la capacidad de Datos. - - 1. Pulse **Ver** para **Datos** en la página **Visión general del proyecto**. - - De forma alternativa, puede seleccionar **Crear** o **Añadir existente** en la página **Prestaciones > Data**. - - 2. Especifique el nombre del servicio y pulse **Crear**. - - -3. Genere el código del proyecto. - - 1. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. - - Como alternativa, pulse la página **Código**. - - 2. Pulse **Generar código**. - - 3. Cuando se haya generado el código, pulse **Descargar código** para descargar el archivo del proyecto. - -4. Opcional: [Actualización del proyecto](project_overview_page.html#update_language) para generar un nuevo lenguaje. - - -## Creación de un proyecto mediante {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Asegúrese de haber instalado [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. En la solicitud de terminal, vaya al directorio local que prefiera y ejecute el siguiente mandato. - - ``` - bx dev create - ``` - {: codeblock} - - -3. Proporcione los siguientes valores cuando se le solicite: - - * Seleccione un patrón: 1 (para web) - * Seleccione un iniciador: 1 (para Basic Web) - * Seleccione un lenguaje: 2 (para Swift) - * Especifique un nombre para el proyecto: `WebBasicProjectCLI` - * Especifique un nombre de host para el proyecto: `myhost` - -4. Si desea añadir servicios al proyecto, escriba `y` en la solicitud de preguntas y responda el resto de las preguntas. - -5. Cuando `WebBasicProjectCLI` se haya guardado correctamente, vaya a la carpeta `WebBasicProjectCLI`. - -6. Añada su propio código, cree el proyecto o ejecute el proyecto. - - 1. Cree el proyecto con el siguiente mandato: - - ``` - bx dev build - ``` - {: codeblock} - - 2. Ejecute el proyecto con el siguiente mandato: - - ``` - bx dev run - ``` - {: codeblock} - - -## Ejecución de un proyecto web -{: #run} - -### Localmente -{: #local notoc} - -1. Instale las dependencias del nodo: - - ``` - npm install - ``` - {: codeblock} - -2. Empaquete el código frontal en un módulo: - - ``` - node_modules/.bin/gulp - ``` - {: codeblock} - -3. Compile el servidor: - - ``` - swift build - ``` - {: codeblock} - -4. Ejecute la aplicación: - - ``` - .build/debug/WebBasicProjectCLI - ``` - {: codeblock} - -5. Abra el navegador en `http://localhost:8080`. - - -### Utilización de {{site.data.keyword.dev_cli_short}} -{: #dev notoc} - -1. Instale las dependencias del nodo: - - ``` - npm install - ``` - {: codeblock} - -2. Empaquete el código frontal en un módulo: - - ``` - gulp - ``` - {: codeblock} - -3. Ejecute la compilación: - - ``` - bx dev run - ``` - {: codeblock} - -4. Abra el navegador en `http://localhost:8080`. - - -## Ejecución del proyecto en Xcode -{: #Xcode} - -1. Cree un proyecto Xcode. - - Antes de poder desarrollar en Xcode, necesitará utilizar el gestor de paquetes de Swift para crear un proyecto Xcode. - - ``` - swift project generate-xcodeproj - ``` - {: codeblock} - -2. Cambie el destino activo por el ejecutable: - - A continuación, abra el proyecto en Xcode y asegúrese de que el destino activo sea el ejecutable. Puede mantener pulsada la tecla de opción mientras pulsa el menú desplegable para seleccionar el ejecutable activo deseado. - -3. Pulse **ejecutar**. - -4. Abra el navegador en `http://localhost:8080`. - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Guía de aprendizaje del iniciador Web Basic +{: #tutorial} + +En la siguiente guía de aprendizaje encontrará los pasos a seguir para crear un proyecto desde el iniciador Web Basic, incluidas las herramientas que debe tener instaladas y, por lo tanto, los pasos para ejecutar el código del proyecto. + +## Instalación de herramientas del desarrollador +{: #dev_tools} + +Asegúrese de haber instalado las [herramientas de desarrollador necesarias ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](get_code.html#prereq-dev-tools){: new_window}. + + +## Creación de un proyecto mediante la {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Cree un proyecto en la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}. + + 1. Desde la página **Cómo empezar** en la {{site.data.keyword.dev_console}}, pulse **Crear proyecto**. + + De forma alternativa, puede pulsar **Crear proyecto** desde la página **Proyectos**. + + 2. Seleccione **Aplicación web** y pulse **Siguiente**. + + 3. Seleccione **Basic Web** y pulse **Siguiente**. + + 4. Especifique el nombre del proyecto. En esta guía de aprendizaje, utilizaremos `WebBasicProject`. + + 5. Especifique un nombre de host. En esta guía de aprendizaje, utilizaremos `devhost` + + 6. Seleccione el lenguaje de la plataforma. En esta guía de aprendizaje, utilizaremos `Swift`. + + 7. Pulse **Crear**. + +2. Opcional: Añada la capacidad de Datos. + + 1. Pulse **Ver** para **Datos** en la página **Visión general del proyecto**. + + De forma alternativa, puede seleccionar **Crear** o **Añadir existente** en la página **Prestaciones > Data**. + + 2. Especifique el nombre del servicio y pulse **Crear**. + + +3. Genere el código del proyecto. + + 1. Pulse **Obtener el código** en la página **Visión general del proyecto** para seleccionar el lenguaje. + + Como alternativa, pulse la página **Código**. + + 2. Pulse **Generar código**. + + 3. Cuando se haya generado el código, pulse **Descargar código** para descargar el archivo del proyecto. + +4. Opcional: [Actualización del proyecto](project_overview_page.html#update_language) para generar un nuevo lenguaje. + + +## Creación de un proyecto mediante {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Asegúrese de haber instalado [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. En la solicitud de terminal, vaya al directorio local que prefiera y ejecute el siguiente mandato. + + ``` + bx dev create + ``` + {: codeblock} + + +3. Proporcione los siguientes valores cuando se le solicite: + + * Seleccione un patrón: 1 (para web) + * Seleccione un iniciador: 1 (para Basic Web) + * Seleccione un lenguaje: 2 (para Swift) + * Especifique un nombre para el proyecto: `WebBasicProjectCLI` + * Especifique un nombre de host para el proyecto: `myhost` + +4. Si desea añadir servicios al proyecto, escriba `y` en la solicitud de preguntas y responda el resto de las preguntas. + +5. Cuando `WebBasicProjectCLI` se haya guardado correctamente, vaya a la carpeta `WebBasicProjectCLI`. + +6. Añada su propio código, cree el proyecto o ejecute el proyecto. + + 1. Cree el proyecto con el siguiente mandato: + + ``` + bx dev build + ``` + {: codeblock} + + 2. Ejecute el proyecto con el siguiente mandato: + + ``` + bx dev run + ``` + {: codeblock} + + +## Ejecución de un proyecto web +{: #run} + +### Localmente +{: #local notoc} + +1. Instale las dependencias del nodo: + + ``` + npm install + ``` + {: codeblock} + +2. Empaquete el código frontal en un módulo: + + ``` + node_modules/.bin/gulp + ``` + {: codeblock} + +3. Compile el servidor: + + ``` + swift build + ``` + {: codeblock} + +4. Ejecute la aplicación: + + ``` + .build/debug/WebBasicProjectCLI + ``` + {: codeblock} + +5. Abra el navegador en `http://localhost:8080`. + + +### Utilización de {{site.data.keyword.dev_cli_short}} +{: #dev notoc} + +1. Instale las dependencias del nodo: + + ``` + npm install + ``` + {: codeblock} + +2. Empaquete el código frontal en un módulo: + + ``` + gulp + ``` + {: codeblock} + +3. Ejecute la compilación: + + ``` + bx dev run + ``` + {: codeblock} + +4. Abra el navegador en `http://localhost:8080`. + + +## Ejecución del proyecto en Xcode +{: #Xcode} + +1. Cree un proyecto Xcode. + + Antes de poder desarrollar en Xcode, necesitará utilizar el gestor de paquetes de Swift para crear un proyecto Xcode. + + ``` + swift project generate-xcodeproj + ``` + {: codeblock} + +2. Cambie el destino activo por el ejecutable: + + A continuación, abra el proyecto en Xcode y asegúrese de que el destino activo sea el ejecutable. Puede mantener pulsada la tecla de opción mientras pulsa el menú desplegable para seleccionar el ejecutable activo deseado. + +3. Pulse **ejecutar**. + +4. Abra el navegador en `http://localhost:8080`. + diff --git a/cloudnative/nl/es/tutorials.md b/cloudnative/nl/es/tutorials.md index d681c1afe..374d939d9 100644 --- a/cloudnative/nl/es/tutorials.md +++ b/cloudnative/nl/es/tutorials.md @@ -1,49 +1,49 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Guías de aprendizaje -{: #tutorial} - -En las siguientes guías de aprendizaje encontrará los pasos a seguir para crear un proyecto desde la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}, incluidas las herramientas que debe tener instaladas y, por lo tanto, los pasos para ejecutar el código del proyecto. - -## Web -{: #web notoc} - -* [Guía de aprendizaje de Web Basic](tutorial_web.html) - - -## Móvil -{: #mobile notoc} - -* [Guía de aprendizaje de Mobile Basic](tutorial_mobile.html) - - - - -## BFF -{: #bff notoc} - -* [Guía de aprendizaje de BFF Basic](tutorial_bff.html) - - -## Microservicio -{: #microservice notoc} - -* [Guía de aprendizaje de Microservice Basic](tutorial_microservice.html) +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Guías de aprendizaje +{: #tutorial} + +En las siguientes guías de aprendizaje encontrará los pasos a seguir para crear un proyecto desde la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}}, incluidas las herramientas que debe tener instaladas y, por lo tanto, los pasos para ejecutar el código del proyecto. + +## Web +{: #web notoc} + +* [Guía de aprendizaje de Web Basic](tutorial_web.html) + + +## Móvil +{: #mobile notoc} + +* [Guía de aprendizaje de Mobile Basic](tutorial_mobile.html) + + + + +## BFF +{: #bff notoc} + +* [Guía de aprendizaje de BFF Basic](tutorial_bff.html) + + +## Microservicio +{: #microservice notoc} + +* [Guía de aprendizaje de Microservice Basic](tutorial_microservice.html) diff --git a/cloudnative/nl/es/what_is_new.md b/cloudnative/nl/es/what_is_new.md index 48220741b..b2e83d438 100644 --- a/cloudnative/nl/es/what_is_new.md +++ b/cloudnative/nl/es/what_is_new.md @@ -1,97 +1,97 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Novedades de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} -{: #what-is-new} - - -## Novedades de marzo de 2017 -{: #mar-2017} - -La actualización de marzo de 2017 de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}} ha introducido los siguientes cambios: - - * El panel de control de Mobile en {{site.data.keyword.Bluemix_notm}} ahora es la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}}. - * Se ha rediseñado la creación de proyectos para incluir los tipos de patrón de servidor de aplicación web, BFF y microservicio con soporte para Node.js, Java y Swift. - * La integración con el nuevo y mejorado servicio de {{site.data.keyword.appid_full}} proporciona autenticación para proyectos web y móvil. - * Ahora puede generar SDK adicionales para sus proyectos utilizando el [plugin del generador de SDK](sdk_cli.html). La generación de SDK en la {{site.data.keyword.dev_console}} solo está disponible para proyectos móviles. - * Ahora puede crear proyectos adicionales mediante [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - - -## Novedades de enero de 2017 -{: #jan-2017} - -La actualización de enero de 2017 del panel de control de {{site.data.keyword.Bluemix_notm}} Mobile ha introducido los cambios siguientes: - - * A partir del 31 de enero, los Iniciadores de la IU estarán en desuso. Los proyectos existentes creados a partir de un Iniciador de IU se pueden utilizar hasta el 30 de abril de 2017. Para obtener más información sobre los pasos de migración y las fechas de eliminación, consulte la [publicación de blog del anuncio en desuso ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/). -{: deprecated} - * Ahora puede actualizar el tipo de iniciador del proyecto en lugar de suprimir el proyecto y crear uno nuevo. - * Ahora puede crear el proyecto con un Iniciador de código [Conversation de Watson](tutorial_conversation.html). - * Si se admite, ahora puede generar un SDK para el proyecto. - * Ahora puede añadir las instancias existentes de [Cálculo](sdk_compute.html) y generar SDK de clientes para añadir al proyecto. - - -## Novedades de diciembre de 2016 -{: #dec-2016} - -La actualización de diciembre de 2016 del panel de control de {{site.data.keyword.Bluemix_notm}} Mobile ha introducido los cambios siguientes: - - * Ahora puede eliminar un servicio conectado de un proyecto para que se pueda suprimir y reutilizar con otro proyecto. - * Ahora puede añadir un servicio existente a un proyecto. - * Ahora puede crear o conectar un servicio CloudantNoSQL existente como origen de datos cuando utilice un Iniciador de código. - * Si se admite, ahora puede crear o conectar un servicio Object Storage existente como origen de datos para el proyecto. - * Ahora puede personalizar el diseño de navegación de la app que cree con un Iniciador de IU. - - -## Novedades de noviembre de 2016 -{: #nov-2016} - -La actualización de noviembre de 2016 del panel de control de {{site.data.keyword.Bluemix_notm}} Mobile ha introducido los cambios siguientes: - - * Ahora puede generar artefactos SDK para proyectos desde la página **Código**. - * Ahora se admite Cordova para el iniciador de código de Basic. - * Ahora puede [notificar sucesos de red ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} y [supervisar solicitudes de red ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} en la página **Solicitudes de red** de la consola de {{site.data.keyword.mobileanalytics_short}}. - * Ahora puede [exportar datos a dashDB ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} en la consola de {{site.data.keyword.mobileanalytics_short}}. - - -## Novedad de octubre de 2016 -{: #oct-2016} - -La actualización de octubre de 2016 del panel de control de {{site.data.keyword.Bluemix_notm}} Mobile ha introducido los cambios siguientes: - - * Ahora puede añadir prestaciones de {{site.data.keyword.mobilepushshort}} y Analytics al proyecto directamente desde el panel de control. - * Ahora están disponibles los [Iniciadores de código](starters.html#Code_Starter). - * Puede añadir autenticación a sus proyectos que ha creado a partir de un iniciador de código. - * Ahora se da soporte a Swift. - - -### Analítica -{: #analytics notoc} - - * La modalidad de demostración está habilitada de forma predeterminada al añadir la prestación Analytics. Puede desactivar la modalidad de demostración para ver las analíticas tras ejecutar la aplicación. - - -### Creador de IU -{: #ui_builder notoc} - - * Ahora se accede a la prestación **{{site.data.keyword.mobilepushshort}}** desde el proyecto. - * El separador **Valores del proyecto** se ha redenominado al separador **Valores**. - * El separador **Autenticación** se ha redenominado al separador **Acceso de usuarios**. - - -### Código -{: #code notoc} - - * El código generado de Objective-C y Swift para iOS utiliza ahora CocoaPods para gestionar las dependencias. Esto significa que tiene que instalar CocoaPods. Para instalarlo, ejecute `sudo gem install cocoapods`. Una vez que CocoaPods se haya instalado, ejecute `pod setup` para configurarlo (si aún no se ha configurado). Finalmente, ejecute `pod install` para descargar e instalar las dependencias del proyecto necesarias antes de abrir el archivo `.xcworkspace` en Xcode. Hay detalles adicionales disponibles en el archivo `README.md` en el archivado de código descargado. Consulte sobre las [Herramientas necesarias del desarrollador](get_code.html#prereq-dev-tools) para obtener más información. - -Consulte con frecuencia para estar al corriente de las nuevas actualizaciones. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Novedades de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}} +{: #what-is-new} + + +## Novedades de marzo de 2017 +{: #mar-2017} + +La actualización de marzo de 2017 de la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix}} ha introducido los siguientes cambios: + + * El panel de control de Mobile en {{site.data.keyword.Bluemix_notm}} ahora es la {{site.data.keyword.dev_console}} de {{site.data.keyword.Bluemix_notm}}. + * Se ha rediseñado la creación de proyectos para incluir los tipos de patrón de servidor de aplicación web, BFF y microservicio con soporte para Node.js, Java y Swift. + * La integración con el nuevo y mejorado servicio de {{site.data.keyword.appid_full}} proporciona autenticación para proyectos web y móvil. + * Ahora puede generar SDK adicionales para sus proyectos utilizando el [plugin del generador de SDK](sdk_cli.html). La generación de SDK en la {{site.data.keyword.dev_console}} solo está disponible para proyectos móviles. + * Ahora puede crear proyectos adicionales mediante [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + + +## Novedades de enero de 2017 +{: #jan-2017} + +La actualización de enero de 2017 del panel de control de {{site.data.keyword.Bluemix_notm}} Mobile ha introducido los cambios siguientes: + + * A partir del 31 de enero, los Iniciadores de la IU estarán en desuso. Los proyectos existentes creados a partir de un Iniciador de IU se pueden utilizar hasta el 30 de abril de 2017. Para obtener más información sobre los pasos de migración y las fechas de eliminación, consulte la [publicación de blog del anuncio en desuso ![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/). +{: deprecated} + * Ahora puede actualizar el tipo de iniciador del proyecto en lugar de suprimir el proyecto y crear uno nuevo. + * Ahora puede crear el proyecto con un Iniciador de código [Conversation de Watson](tutorial_conversation.html). + * Si se admite, ahora puede generar un SDK para el proyecto. + * Ahora puede añadir las instancias existentes de [Cálculo](sdk_compute.html) y generar SDK de clientes para añadir al proyecto. + + +## Novedades de diciembre de 2016 +{: #dec-2016} + +La actualización de diciembre de 2016 del panel de control de {{site.data.keyword.Bluemix_notm}} Mobile ha introducido los cambios siguientes: + + * Ahora puede eliminar un servicio conectado de un proyecto para que se pueda suprimir y reutilizar con otro proyecto. + * Ahora puede añadir un servicio existente a un proyecto. + * Ahora puede crear o conectar un servicio CloudantNoSQL existente como origen de datos cuando utilice un Iniciador de código. + * Si se admite, ahora puede crear o conectar un servicio Object Storage existente como origen de datos para el proyecto. + * Ahora puede personalizar el diseño de navegación de la app que cree con un Iniciador de IU. + + +## Novedades de noviembre de 2016 +{: #nov-2016} + +La actualización de noviembre de 2016 del panel de control de {{site.data.keyword.Bluemix_notm}} Mobile ha introducido los cambios siguientes: + + * Ahora puede generar artefactos SDK para proyectos desde la página **Código**. + * Ahora se admite Cordova para el iniciador de código de Basic. + * Ahora puede [notificar sucesos de red ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} y [supervisar solicitudes de red ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} en la página **Solicitudes de red** de la consola de {{site.data.keyword.mobileanalytics_short}}. + * Ahora puede [exportar datos a dashDB ![Icono de enlace externo](../icons/launch-glyph.svg "Icono de enlace externo")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} en la consola de {{site.data.keyword.mobileanalytics_short}}. + + +## Novedad de octubre de 2016 +{: #oct-2016} + +La actualización de octubre de 2016 del panel de control de {{site.data.keyword.Bluemix_notm}} Mobile ha introducido los cambios siguientes: + + * Ahora puede añadir prestaciones de {{site.data.keyword.mobilepushshort}} y Analytics al proyecto directamente desde el panel de control. + * Ahora están disponibles los [Iniciadores de código](starters.html#Code_Starter). + * Puede añadir autenticación a sus proyectos que ha creado a partir de un iniciador de código. + * Ahora se da soporte a Swift. + + +### Analítica +{: #analytics notoc} + + * La modalidad de demostración está habilitada de forma predeterminada al añadir la prestación Analytics. Puede desactivar la modalidad de demostración para ver las analíticas tras ejecutar la aplicación. + + +### Creador de IU +{: #ui_builder notoc} + + * Ahora se accede a la prestación **{{site.data.keyword.mobilepushshort}}** desde el proyecto. + * El separador **Valores del proyecto** se ha redenominado al separador **Valores**. + * El separador **Autenticación** se ha redenominado al separador **Acceso de usuarios**. + + +### Código +{: #code notoc} + + * El código generado de Objective-C y Swift para iOS utiliza ahora CocoaPods para gestionar las dependencias. Esto significa que tiene que instalar CocoaPods. Para instalarlo, ejecute `sudo gem install cocoapods`. Una vez que CocoaPods se haya instalado, ejecute `pod setup` para configurarlo (si aún no se ha configurado). Finalmente, ejecute `pod install` para descargar e instalar las dependencias del proyecto necesarias antes de abrir el archivo `.xcworkspace` en Xcode. Hay detalles adicionales disponibles en el archivo `README.md` en el archivado de código descargado. Consulte sobre las [Herramientas necesarias del desarrollador](get_code.html#prereq-dev-tools) para obtener más información. + +Consulte con frecuencia para estar al corriente de las nuevas actualizaciones. diff --git a/cloudnative/nl/fr/cli.md b/cloudnative/nl/fr/cli.md index 65347cf48..2fadea65a 100644 --- a/cloudnative/nl/fr/cli.md +++ b/cloudnative/nl/fr/cli.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Plug-ins pour l'interface de ligne de commande {{site.data.keyword.Bluemix_notm}} -{: #cli} - -Les plug-ins suivants peuvent être ajoutés à l'interface de ligne de commande {{site.data.keyword.Bluemix}}. Vous pouvez utiliser ces plug-ins pour créer vos propres projets {{site.data.keyword.dev_console}}. - -* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) -* Plug-in de générateur SDK [{{site.data.keyword.IBM_notm}}](sdk_cli.html) +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Plug-ins pour l'interface de ligne de commande {{site.data.keyword.Bluemix_notm}} +{: #cli} + +Les plug-ins suivants peuvent être ajoutés à l'interface de ligne de commande {{site.data.keyword.Bluemix}}. Vous pouvez utiliser ces plug-ins pour créer vos propres projets {{site.data.keyword.dev_console}}. + +* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) +* Plug-in de générateur SDK [{{site.data.keyword.IBM_notm}}](sdk_cli.html) diff --git a/cloudnative/nl/fr/compute.md b/cloudnative/nl/fr/compute.md index 7cc7773bb..e70a37de6 100644 --- a/cloudnative/nl/fr/compute.md +++ b/cloudnative/nl/fr/compute.md @@ -1,181 +1,181 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Compute -{: #compute} - -Quand vous générez une application de canal numérique de cloud native pour web et mobile, la meilleure façon de procéder est d'avoir une architecture BFF (Backend for Frontend) qui est dédiée à votre canal numérique ou offre la même prise en charge de données et d'intégration logique pour les applications client mobiles et web. Pour plus d'informations sur cette architecture, voir [Microservices for web and mobile ![Icône de lien externe](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture). - -Le diagramme suivant présente une architecture BFF. - -![Architecture BFF](images/bff-arch.png) - -Figure 1 : Architecture BFF - -Le concept à la base d'une architecture BFF est de faire abstraction de la logique applicative et de la logique d'intégration depuis vos microservices ou vos services cloud {{site.data.keyword.Bluemix}} à forte valeur. - -Avec cette architecture, vous pouvez déployer et publier des mises à jour sur votre application mobile ou Web et déployer de nouvelles versions de votre architecture BFF en utilisant des pipelines de livraison continue avec le service DevOps. - -Si vous avez une architecture BFF pour iOS et une architecture BFF séparée pour Android, les équipes d’ingénierie qui distribuent les options pour cette application ne sont pas contraintes d'en publier les fonctionnalités selon un planning de publication d'API centralisé. Les architectures de canaux numériques et de microservices poursuivent un but commun, celui d'éviter aux équipes d'avoir à publier souvent les nouvelles options et fonctionnalités, en étant tenues de respecter strictement le planning des autres équipes. - - - - -## Intégration d'un client mobile avec BFF -{: #integration} - -Pour faciliter l'intégration entre un client mobile et une architecture BFF, {{site.data.keyword.Bluemix_notm}} prend en charge une génération SDK de client mobile pour iOS et Android en langage Swift et Java, respectivement. Pour activer cette fonction, vous devez exposer votre intégration BFF en utilisant un document de spécification Open API (Swagger), qui peut être au format JSON ou YAML. - -Le générateur SDK client se sert du fichier de définition Open API pour définir un SDK développeur optimisé client qui est facile à consommer dans votre application mobile native. Il accélérera l'intégration de votre architecture BFF dans votre application mobile. - - -## Définition d'une API -{: #definition} - -L'architecture BFF doit exposer un fichier de définition d'API conforme à la spécification Open API qui s'exécute sur un noeud final de serveur opérationnel. Pour activer {{site.data.keyword.Bluemix_notm}} Developer Experience et l'interface de ligne de commande du SDK {{site.data.keyword.Bluemix_notm}} afin de découvrir ce noeud final, vous devez ajouter une variable d'environnement à votre application Cloud Foundry, intitulée `OPENAPI_SPEC`. Cette variable d'environnement doit se référer à la spécification en utilisant un chemin relatif. - -Pour ajouter la variable d'environnement `OPENAPI_SPEC` dans {{site.data.keyword.Bluemix_notm}}, procédez comme suit : - -1. Connectez-vous à [{{site.data.keyword.Bluemix_notm}} ![Icône de lien externe](../icons/launch-glyph.svg)](http://bluemix.net). -2. Sélectionnez une application Cloud Foundry. -3. Sélectionnez **Exécution**. -4. Sélectionnez **Variables d'environnement**. -5. Cliquez sur **Ajouter** dans la section **Défini par l'utilisateur**. -6. Spécifiez `OPENAPI_SPEC` pour **NOM** et un chemin d'URL relatif dans votre fichier de définition Open API. -7. Cliquez sur **Enregistrer**. - - - -Exemple : - -``` -OPENAPI_SPEC='/explorer/swagger.json' -``` -{: codeblock} - -Les applications {{site.data.keyword.apiconnect_long}} et Loopback fonctionnent particulièrement bien en utilisant cette approche. Vous pouvez vous servir de Loopback et {{site.data.keyword.apiconnect_short}} pour définir un modèle persistant et exposer l'opération CRUD (Create, Read, Update et Delete) en utilisant le fichier de définition Open API. - -Vous pouvez également définir des opérations de logique applicative. - - -### Eléments de la spécification Open API pris en charge -{: #supported-elements notoc} - -La seule portion de la spécification Open API qui n'est complètement prise en charge est la structure de fichier. La spécification autorise le fractionnement en différents fichiers de portions de la définition et leur référencement en utilisant la zone json `$ref`. L'ensemble de votre définition doit être contenu dans un fichier. - - -## Exemple de BFF (Backend for Frontend) utilisant Bluegen -{: #bff-bluegen} - -{{site.data.keyword.Bluemix_notm}} a créé une architecture BFF de référence utilisant {{site.data.keyword.apiconnect_short}} et Strongloop, qui mappe un modèle de produit à {{site.data.keyword.cloudant}} et une API d'images pour le référencement des images dans {{site.data.keyword.objectstorageshort}}. - -Vous pouvez utiliser cette architecture BFF pour vous lancer rapidement dans le provisionnement d'une architecture BFF totalement opérationnelle dans {{site.data.keyword.Bluemix_notm}} et vous en servir pour comprendre comme il est facile d'intégrer une architecture BFF dans un projet mobile et générer des SDK natifs pour iOS et Android sous Swift et Java, respectivement. - -Suivez les instructions du fichier [README ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) pour créer un projet et l'installer. - - -## Utilisation de BFF (Backend for Frontend) avec un projet Developer Experience -{: #bff-devex} - -L'expérience {{site.data.keyword.Bluemix_notm}} Mobile Developer Experience est conçue pour simplifier la définition d'un projet mobile avec un certain nombre de services de cloud associés. Vous pouvez facilement ajouter des services [{{site.data.keyword.mobilepushshort}} ![Icône de lien externe](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [Analytics ![Icône de lien externe](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html) et Data ou Storage. - -La console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} introduit la possibilité d'intégrer une infrastructure BFF dans un projet mobile, dans la page **Compute**. Vous pouvez ajouter des instances de service de calcul existantes à votre projet mobile. Une fois cet ajout effectué, vous pouvez générer un SDK natif pour votre choix de langue ou générer le projet complet et le SDK sera intégré dans le package source du projet de la page **Code**, ce qui est particulièrement utile quand vous procédez à une intégration à des architectures BFF qui sont déjà bien définies. - -Une fois que vous avez téléchargé votre projet, vous pouvez l'ouvrir avec Xcode ou Android et le compiler avec le SDK client. - - -## Utilisation de l'interface de ligne de commande -{: #cli} - -Pendant que vous développez votre infrastructure BFF, votre spécification API peut changer. Pour prendre en charge ces changements, vous disposez des deux options ci-après. - -* Régénérez l'ensemble du projet dans une nouvelle branche GitHub et fusionnez les changements dans votre branche de développement. -* Régénérez le SDK directement en utilisant l'outil de ligne de commande et n'actualisez que la partie SDK du projet mobile. - -Pour utiliser l'outil de ligne de commande, vous devez l'[installer](sdk_cli.html#installation). - -Utilisez la commande suivante pour répertorier les actions que vous pouvez exécuter. - -``` -bluemix sdk -``` -{: codeblock} - -Utilisez la commande suivante pour répertorier les instances Cloud Foundry en cours d'exécution dans votre espace {{site.data.keyword.Bluemix_notm}} actuel. - -``` -bluemix sdk list -``` -{: codeblock} - -Chaque application est répertoriée et l'API est validée si la variable d'environnement `OPENAPI_SPEC` est définie. Dans la colonne `VALID`, vous voyez une coche verte ou un `X` rouge. Une coche dans la colonne `VALID` de l'application signifie qu'une définition Open API ouverte valide est présente. Un `X` dans la colonne `VALID` de l'application peut indiquer l'une des situations suivantes : - -* aucune variable d'environnement `OPENAPI_SPEC` n'est définie pour votre application OU -* la définition d'API n'est pas valide par rapport à la spécification Open API - -Utilisez la commande suivante pour afficher l'URL complète pour l'API. L'URI et la route complète de la spécification d'API est répertoriée. Vous pouvez afficher la spécification brute dans un navigateur, la consommer directement dans l'outil de ligne de commande ou vérifier que la variable BFF `OPENAPI_SPEC` est correctement définie. - -``` -bluemix sdk list --url -``` -{: codeblock} - -Utilisez la commande suivante pour valider le fichier de définition Open API d'`` afin de déterminer s'il peut être utilisé pour générer un SDK. La commande trouve `` dans votre espace actuel et utilise le chemin relatif de la variable d'environnement `OPENAPI_SPEC` pour localiser la spécification pour la validation. - -``` -bluemix sdk validate -``` -{: codeblock} - -Utilisez la commande suivante pour générer un SDK pour la `` native de votre choix et placer un fichier compressé dans votre répertoire de travail actuel. - -``` -bluemix sdk generate -- -``` -{: codeblock} - -L'utilisation de l'option `--unzip` extrait automatiquement le SDK dans votre répertoire de travail actuel. Vous pouvez, si vous le souhaitez, spécifier l'emplacement où extraire le SDK en utilisant l'option `--output`. Vous pouvez gérer votre code source avec GitHub et créer une nouvelle branche spécifiquement pour la mise à jour du SDK. L'utilisation de cette approche facilite la visualisation des changements et la fusion de votre SDK mis à jour dans votre branche de développement. - - -## Utilisation de modèles de SDK générés et d'API -{: #models-apis} - -Maintenant que votre architecture BFF est intégrée dans votre application mobile en utilisant un SDK généré, vous pouvez commencer à l'utiliser. - -Le SDK est livré avec une documentation complète dans les répertoires `docs` et `source`. Vous pouvez ouvrir le fichier `README.html` pour une vue Web des documents ou ouvrir le fichier `README.md` pour une vue Markdown. Les documents Markdown sont utiles quand vous publiez le SDK dans Cocoapods ou Maven Central. - -Dans la documentation, vous pouvez voir une liste des API qui sont générées. Vous pouvez cliquer sur une API pour afficher un fragment de code que vous pouvez directement coller dans votre application mobile. +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Compute +{: #compute} + +Quand vous générez une application de canal numérique de cloud native pour web et mobile, la meilleure façon de procéder est d'avoir une architecture BFF (Backend for Frontend) qui est dédiée à votre canal numérique ou offre la même prise en charge de données et d'intégration logique pour les applications client mobiles et web. Pour plus d'informations sur cette architecture, voir [Microservices for web and mobile ![Icône de lien externe](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture). + +Le diagramme suivant présente une architecture BFF. + +![Architecture BFF](images/bff-arch.png) + +Figure 1 : Architecture BFF + +Le concept à la base d'une architecture BFF est de faire abstraction de la logique applicative et de la logique d'intégration depuis vos microservices ou vos services cloud {{site.data.keyword.Bluemix}} à forte valeur. + +Avec cette architecture, vous pouvez déployer et publier des mises à jour sur votre application mobile ou Web et déployer de nouvelles versions de votre architecture BFF en utilisant des pipelines de livraison continue avec le service DevOps. + +Si vous avez une architecture BFF pour iOS et une architecture BFF séparée pour Android, les équipes d’ingénierie qui distribuent les options pour cette application ne sont pas contraintes d'en publier les fonctionnalités selon un planning de publication d'API centralisé. Les architectures de canaux numériques et de microservices poursuivent un but commun, celui d'éviter aux équipes d'avoir à publier souvent les nouvelles options et fonctionnalités, en étant tenues de respecter strictement le planning des autres équipes. + + + + +## Intégration d'un client mobile avec BFF +{: #integration} + +Pour faciliter l'intégration entre un client mobile et une architecture BFF, {{site.data.keyword.Bluemix_notm}} prend en charge une génération SDK de client mobile pour iOS et Android en langage Swift et Java, respectivement. Pour activer cette fonction, vous devez exposer votre intégration BFF en utilisant un document de spécification Open API (Swagger), qui peut être au format JSON ou YAML. + +Le générateur SDK client se sert du fichier de définition Open API pour définir un SDK développeur optimisé client qui est facile à consommer dans votre application mobile native. Il accélérera l'intégration de votre architecture BFF dans votre application mobile. + + +## Définition d'une API +{: #definition} + +L'architecture BFF doit exposer un fichier de définition d'API conforme à la spécification Open API qui s'exécute sur un noeud final de serveur opérationnel. Pour activer {{site.data.keyword.Bluemix_notm}} Developer Experience et l'interface de ligne de commande du SDK {{site.data.keyword.Bluemix_notm}} afin de découvrir ce noeud final, vous devez ajouter une variable d'environnement à votre application Cloud Foundry, intitulée `OPENAPI_SPEC`. Cette variable d'environnement doit se référer à la spécification en utilisant un chemin relatif. + +Pour ajouter la variable d'environnement `OPENAPI_SPEC` dans {{site.data.keyword.Bluemix_notm}}, procédez comme suit : + +1. Connectez-vous à [{{site.data.keyword.Bluemix_notm}} ![Icône de lien externe](../icons/launch-glyph.svg)](http://bluemix.net). +2. Sélectionnez une application Cloud Foundry. +3. Sélectionnez **Exécution**. +4. Sélectionnez **Variables d'environnement**. +5. Cliquez sur **Ajouter** dans la section **Défini par l'utilisateur**. +6. Spécifiez `OPENAPI_SPEC` pour **NOM** et un chemin d'URL relatif dans votre fichier de définition Open API. +7. Cliquez sur **Enregistrer**. + + + +Exemple : + +``` +OPENAPI_SPEC='/explorer/swagger.json' +``` +{: codeblock} + +Les applications {{site.data.keyword.apiconnect_long}} et Loopback fonctionnent particulièrement bien en utilisant cette approche. Vous pouvez vous servir de Loopback et {{site.data.keyword.apiconnect_short}} pour définir un modèle persistant et exposer l'opération CRUD (Create, Read, Update et Delete) en utilisant le fichier de définition Open API. + +Vous pouvez également définir des opérations de logique applicative. + + +### Eléments de la spécification Open API pris en charge +{: #supported-elements notoc} + +La seule portion de la spécification Open API qui n'est complètement prise en charge est la structure de fichier. La spécification autorise le fractionnement en différents fichiers de portions de la définition et leur référencement en utilisant la zone json `$ref`. L'ensemble de votre définition doit être contenu dans un fichier. + + +## Exemple de BFF (Backend for Frontend) utilisant Bluegen +{: #bff-bluegen} + +{{site.data.keyword.Bluemix_notm}} a créé une architecture BFF de référence utilisant {{site.data.keyword.apiconnect_short}} et Strongloop, qui mappe un modèle de produit à {{site.data.keyword.cloudant}} et une API d'images pour le référencement des images dans {{site.data.keyword.objectstorageshort}}. + +Vous pouvez utiliser cette architecture BFF pour vous lancer rapidement dans le provisionnement d'une architecture BFF totalement opérationnelle dans {{site.data.keyword.Bluemix_notm}} et vous en servir pour comprendre comme il est facile d'intégrer une architecture BFF dans un projet mobile et générer des SDK natifs pour iOS et Android sous Swift et Java, respectivement. + +Suivez les instructions du fichier [README ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) pour créer un projet et l'installer. + + +## Utilisation de BFF (Backend for Frontend) avec un projet Developer Experience +{: #bff-devex} + +L'expérience {{site.data.keyword.Bluemix_notm}} Mobile Developer Experience est conçue pour simplifier la définition d'un projet mobile avec un certain nombre de services de cloud associés. Vous pouvez facilement ajouter des services [{{site.data.keyword.mobilepushshort}} ![Icône de lien externe](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [Analytics ![Icône de lien externe](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html) et Data ou Storage. + +La console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} introduit la possibilité d'intégrer une infrastructure BFF dans un projet mobile, dans la page **Compute**. Vous pouvez ajouter des instances de service de calcul existantes à votre projet mobile. Une fois cet ajout effectué, vous pouvez générer un SDK natif pour votre choix de langue ou générer le projet complet et le SDK sera intégré dans le package source du projet de la page **Code**, ce qui est particulièrement utile quand vous procédez à une intégration à des architectures BFF qui sont déjà bien définies. + +Une fois que vous avez téléchargé votre projet, vous pouvez l'ouvrir avec Xcode ou Android et le compiler avec le SDK client. + + +## Utilisation de l'interface de ligne de commande +{: #cli} + +Pendant que vous développez votre infrastructure BFF, votre spécification API peut changer. Pour prendre en charge ces changements, vous disposez des deux options ci-après. + +* Régénérez l'ensemble du projet dans une nouvelle branche GitHub et fusionnez les changements dans votre branche de développement. +* Régénérez le SDK directement en utilisant l'outil de ligne de commande et n'actualisez que la partie SDK du projet mobile. + +Pour utiliser l'outil de ligne de commande, vous devez l'[installer](sdk_cli.html#installation). + +Utilisez la commande suivante pour répertorier les actions que vous pouvez exécuter. + +``` +bluemix sdk +``` +{: codeblock} + +Utilisez la commande suivante pour répertorier les instances Cloud Foundry en cours d'exécution dans votre espace {{site.data.keyword.Bluemix_notm}} actuel. + +``` +bluemix sdk list +``` +{: codeblock} + +Chaque application est répertoriée et l'API est validée si la variable d'environnement `OPENAPI_SPEC` est définie. Dans la colonne `VALID`, vous voyez une coche verte ou un `X` rouge. Une coche dans la colonne `VALID` de l'application signifie qu'une définition Open API ouverte valide est présente. Un `X` dans la colonne `VALID` de l'application peut indiquer l'une des situations suivantes : + +* aucune variable d'environnement `OPENAPI_SPEC` n'est définie pour votre application OU +* la définition d'API n'est pas valide par rapport à la spécification Open API + +Utilisez la commande suivante pour afficher l'URL complète pour l'API. L'URI et la route complète de la spécification d'API est répertoriée. Vous pouvez afficher la spécification brute dans un navigateur, la consommer directement dans l'outil de ligne de commande ou vérifier que la variable BFF `OPENAPI_SPEC` est correctement définie. + +``` +bluemix sdk list --url +``` +{: codeblock} + +Utilisez la commande suivante pour valider le fichier de définition Open API d'`` afin de déterminer s'il peut être utilisé pour générer un SDK. La commande trouve `` dans votre espace actuel et utilise le chemin relatif de la variable d'environnement `OPENAPI_SPEC` pour localiser la spécification pour la validation. + +``` +bluemix sdk validate +``` +{: codeblock} + +Utilisez la commande suivante pour générer un SDK pour la `` native de votre choix et placer un fichier compressé dans votre répertoire de travail actuel. + +``` +bluemix sdk generate -- +``` +{: codeblock} + +L'utilisation de l'option `--unzip` extrait automatiquement le SDK dans votre répertoire de travail actuel. Vous pouvez, si vous le souhaitez, spécifier l'emplacement où extraire le SDK en utilisant l'option `--output`. Vous pouvez gérer votre code source avec GitHub et créer une nouvelle branche spécifiquement pour la mise à jour du SDK. L'utilisation de cette approche facilite la visualisation des changements et la fusion de votre SDK mis à jour dans votre branche de développement. + + +## Utilisation de modèles de SDK générés et d'API +{: #models-apis} + +Maintenant que votre architecture BFF est intégrée dans votre application mobile en utilisant un SDK généré, vous pouvez commencer à l'utiliser. + +Le SDK est livré avec une documentation complète dans les répertoires `docs` et `source`. Vous pouvez ouvrir le fichier `README.html` pour une vue Web des documents ou ouvrir le fichier `README.md` pour une vue Markdown. Les documents Markdown sont utiles quand vous publiez le SDK dans Cocoapods ou Maven Central. + +Dans la documentation, vous pouvez voir une liste des API qui sont générées. Vous pouvez cliquer sur une API pour afficher un fragment de code que vous pouvez directement coller dans votre application mobile. diff --git a/cloudnative/nl/fr/dev_cli.md b/cloudnative/nl/fr/dev_cli.md index d7159ea02..1bd849099 100644 --- a/cloudnative/nl/fr/dev_cli.md +++ b/cloudnative/nl/fr/dev_cli.md @@ -1,404 +1,404 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.dev_cli_short}} -{: #developercli} - -Le plug-in {{site.data.keyword.dev_cli_long}} fournit une approche pilotée par commande extensible pour créer, développer et déployer un projet Web avec le plug-in `dev`. Il est idéal pour les développeurs qui souhaitent utiliser un contrôle par ligne de commande tout en développant des applications de microservice de bout en bout. - -{: shortdesc} - -Le plug-in {{site.data.keyword.dev_cli_notm}} utilise deux conteneurs pour faciliter la génération et le test de votre application. Le premier est le conteneur tools qui contient les utilitaires nécessaires pour générer et tester votre application. Le fichier Dockerfile pour ce conteneur est défini par le paramètre [dockerfile-tools](#command-parameters). Considérez-le comme un conteneur de développement puisqu'il contient les outils normalement utilisés pour le développement d'un environnement d'exécution particulier. - -Le second conteneur est le conteneur run. La forme de ce conteneur permet un déploiement pour utilisation, dans {{site.data.keyword.Bluemix}}, par exemple. En conséquence, ce conteneur dispose généralement d'un point d'entrée défini qui démarre votre application. Quand vous choisissez d'exécuter votre application via le plug-in {{site.data.keyword.dev_cli_short}}, ce conteneur est utilisé.Le fichier Dockerfile pour ce conteneur est défini par le paramètre [dockerfile-run](#run-parameters). - - -## Ajout du plug-in {{site.data.keyword.dev_cli_notm}} -{: #add-cli} - - -### Prérequis -{: #prereq} - -Quelques prérequis sont nécessaires pour explorer complètement et utiliser correctement le plug-in {{site.data.keyword.dev_cli_short}}, puisqu'il est hautement extensible et vous permet de tirer parti de technologies complémentaires gratuites. - -1. Installez l'[interface de ligne de commande Cloud Foundry![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/cloudfoundry/cli#getting-started). - -2. Installez l'interface de ligne de commande [{{site.data.keyword.Bluemix}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://clis.ng.bluemix.net/ui/home.html). - -3. Obtenez un ID [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net). - -4. Facultatif : si vous prévoyez d'exécuter et de déboguer des applications localement, vous devez aussi installer [Docker ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.docker.com/get-docker) (requis uniquement pour les projets non mobiles). - - -### Installation -{: #installation} - -1. Installez le plug-in [{{site.data.keyword.dev_cli_short}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} en exécutant la commande suivante : - - ``` - bx plugin install dev -r Bluemix - ``` - {: codeblock} - -2. Validez l'aboutissement de l'installation en exécutant la commande suivante : - - ``` - bx dev - ``` - {: codeblock} - - -### Avant de commencer -{: #before-install} - -1. Connectez-vous à {{site.data.keyword.Bluemix_notm}}. - - ``` - bx login - ``` - {: codeblock} - - **Remarque :** si vos données d'identification sont rejetées, vous utilisez peut-être un ID fédéré. Procédez comme suit pour vous authentifier via un ID fédéré. - - - - 1. Connectez-vous à [{{site.data.keyword.iamshort}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.bluemix.net/iam/#/apikeys){: new_window}. - 2. Sélectionnez la commande de création d'une clé d'API. - * Entrez une description et un nom apiKey. - 3. Téléchargez votre clé apiKey. - 4. Ouvrez le fichier et copiez la valeur depuis la zone `apiKey`. - 5. Connectez-vous en utilisant la commande suivante : - - ``` - bx login --apikey - ``` - {: codeblock} - - -## Commandes -{: #commands} - -Utilisez les commandes décrites ci-après pour créer un projet, le déployer, le déboguer et le tester. - -### Commande build -{: #build} - -Vous pouvez générer votre application en utilisant la commande `build`. L'élément de configuration `build-cmd-run` est utilisé pour générer l'application. Les commandes `test`, `debug` et `run` s'exécutent toutes de la même façon que cette commande dans leur fonctionnement normal, l'exécution de cette dernière avant ces commandes n'est pas donc pas nécessaire. - -Exécutez la commande suivante dans votre répertoire de projet actuel pour générer votre application : - -``` -bx dev build -``` -{: codeblock} - - -[Paramètres de la commande build](#command-parameters) - - -### Commande code -{: #code} - -La commande `code` vous permet de télécharger le code d'application après le déploiement, afin de vous permettre de le réviser localement ou d'y apporter des modifications supplémentaires. - -Exécutez la commande suivante pour télécharger le code à partir du projet spécifié. - -``` -bx dev code -``` -{: codeblock} - - -### Commande create -{: #create} - -La commande create crée un nouveau projet, vous invitant à entrer toutes les informations requises, dont la langue, le nom du projet et le type de modèle d'application. Le projet sera créé dans le répertoire actuel. - -Pour créer un projet dans le répertoire de projet actuel et y associer des services, exécutez la commande suivante : - -``` -bx dev create -``` -{: codeblock} - - -### Commande debug -{: #debug} - -Vous pouvez déboguer votre application via la commande `debug`. Une génération est d'abord effectuée à partir du projet en utilisant l'élément de configuration `build-cmd-debug` comme instruction de génération. Un conteneur est ensuite démarré en exposant un ou plusieurs ports de débogage comme défini dans `container-port-map-debug`. Connectez votre outil de débogage favori au(x) port(s) puis déboguez votre application comme vous le faites normalement. - -**Limite** : les projets Swift ne sont pas actuellement disponibles pour le débogage. - -Exécutez la commande suivante dans votre répertoire de projet actuel pour déboguer votre application. - -``` -bx dev debug -``` -{: codeblock} - -Pour quitter la session de débogage, utilisez `CTRL-C`. - - -#### Paramètres de la commande debug -{: #debug-parameters} - -Les paramètres suivants, qui sont réservés à la commande `debug`, facilitent le débogage d'une application. - -##### `container-port-map-debug` -{: #port-map-debug} - -* Mappages de port pour le port de débogage. La première valeur est le port à utiliser dans le système d'exploitation hôte, la seconde est le port dans le conteneur (host:container). -* Syntaxe : `bx dev debug container-port-map-debug [7777:7777]` - -##### `build-cmd-debug` -{: #build-cmd-debug} - -* Utilisé pour générer du code pour DEBUG. -* Syntaxe : `bx dev debug build-cmd-debug build.command.sh` - -##### `debug-cmd` -{: #debug-cmd} - -* Utilisé pour déboguer le code du conteneur tools. L'utilisation de ce paramètre est facultative si le paramètre `build-cmd-debug` démarre votre application en mode débogage. -* Syntaxe : `bx dev debug debug-cmd /the/debug/command` - -#### Débogage d'une application locale -{: #local-app-dev} - -Pour plus d'informations sur le débogage d'une application locale, voir [Débogage d'une application locale](docs/cloudnative/dev_cli_local_debug.html#local-debug). - - -### Commande delete -{: #delete} - -Cette commande vous permet de supprimer des projets de votre espace {{site.data.keyword.Bluemix}}. - -Exécutez la commande suivante pour supprimer votre projet depuis {{site.data.keyword.Bluemix}} : - -``` -bx dev delete -``` -{: codeblock} - - -**Remarque** : les services {{site.data.keyword.Bluemix}} ne sont **pas** retirés. - - -### Commande help -{: #help} - -Par défaut, si aucune action ou arguments ne sont transmis, ou si l'action help est fournie, cette commande affiche un texte d'aide général. L'aide générale affichée inclut une description des arguments de base ainsi qu'une liste des actions disponibles. - -Exécutez la commande suivante pour afficher des informations d'aide générales : - -``` -bx dev help -``` -{: codeblock} - - -### Commande list -{: #list} - -Vous pouvez répertorier tous les projets {{site.data.keyword.Bluemix_notm}} d'un espace. - -Exécutez la commande suivante pour répertorier vos projets : - -``` -bx dev list -``` -{: codeblock} - - - - - -### Commande run -{: #run} - -Vous pouvez exécuter votre application via la commande `run`. Une génération est d'abord effectuée à partir du projet en utilisant l'élément de configuration `build-cmd-run` comme instruction de génération. Le conteneur run qui est ensuite démarré expose les ports comme défini dans `container-port-map`. Le paramètre `run-cmd` peut être utilisé pour invoquer l'application si le conteneur run ne contient pas de point d'entrée pour terminer cette procédure. - -Exécutez la commande suivante dans votre répertoire de projet actuel pour démarrer votre application : - -``` -bx dev run -``` -{: codeblock} - -Pour quitter la session, utilisez `CTRL-C`. - - -#### Paramètres de la commande run -{: #run-parameters} - -Les paramètres suivants, qui sont réservés à la commande `run`, facilitent la gestion de votre application avec le conteneur run. - -##### `container-name-run` -{: #container-name-run} - -* Nom de conteneur pour le conteneur run. -* Syntaxe : `bx dev run container-name-run ` - -##### `container-path-run` -{: #container-path-run} - -* Emplacement dans le conteneur à partager à l'exécution. -* Syntaxe : `bx dev run container-path-run [/path/to/app]` - -##### `host-path-run` -{: #host-path-run} - -* Emplacement sur le système hôte à partager dans le conteneur à l'exécution. -* Syntaxe : `bx dev run host-path-run [/path/to/app/bin]` - -##### `dockerfile-run` -{: #dockerfile-run} - -* Fichier Docker pour le conteneur run. -* Syntaxe : `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` - -##### `image-name-run` -{: #image-name-run} - -* Image à créer depuis dockerfile-run. -* Syntaxe : `bx dev run image-name-run [/path/to/image-name]` - -##### `run-cmd` -{: #run-cmd} - -* Paramètre facultatif utilisé pour exécuter le code dans le conteneur run. L'utilisation de ce paramètre est facultative si votre image démarre votre application. -* Syntaxe : `bx dev run run-cmd [/the/run/command]` - -### Commande status -{: #status} - -Vous pouvez effectuer une requête relative au statut des conteneurs utilisés par {{site.data.keyword.dev_cli_short}}, comme défini par `container-name-run` et `container-name-tools`. - -Exécutez la commande suivante dans votre répertoire de projet actuel pour vérifier le statut du conteneur : - -``` -bx dev status -``` -{: codeblock} - - -[Paramètres de la commande status](#command-parameters) - - -### Commande stop -{: #stop} - -Vous pouvez arrêter un conteneur via la commande `stop`. Le paramètre `container-name` vous permet de spécifier le conteneur à arrêter. Si rien n'est spécifié, la commande stop arrête le conteneur run comme défini par `container-name-run`. - -Exécutez la commande suivante dans votre répertoire de projet actuel pour arrêter un conteneur : - -``` -bx dev stop -``` -{: codeblock} - - -#### Paramètre stop supplémentaire : -{: #stop-parameter} - -##### `container-name` -{: #container-name} - -* Nom de conteneur pour le conteneur tools. -* Syntaxe : `bx dev stop container-name ` - -### Commande Test -{: #test} - -Vous pouvez tester votre application via la commande `test`. Une génération est d'abord effectuée à partir du projet en utilisant l'élément de configuration `build-cmd-run` comme instruction de génération. Le conteneur tools est ensuite utilisé pour invoquer `test-cmd` pour l'application. - -Exécutez la commande suivante pour tester votre application : - -``` -bx dev test -``` -{: codeblock} - - -[Paramètres de la commande test](#command-parameters) - - -## Paramètres pour les commandes build, debug, run et test -{: #command-parameters} - -Les paramètres suivants, qui peuvent être associés aux commandes `build|debug|run|test`, sont spécifiables via une ligne de commande et/ou en mettant à jour directement le fichier `cli-config.yml` du projet. Des paramètres supplémentaires, disponibles pour les commandes [`debug`](#debug-parameters) et [`run`](#run-parameters), sont documentés dans leurs sections respectives. - -**Remarque** : les paramètres de commande entrés dans la ligne de commande sont prioritaires sur ceux du fichier de configuration `cli-config.yml`. - -##### `container-name-tools` -{: #container-name-tools} - -* Nom de conteneur pour le conteneur tools. -* Syntaxe : `bx dev container-name-tools []` - -##### `host-path-tools` -{: #host-path-tools} - -* Emplacement sur l'hôte à partager pour les commandes build, debug, test. -* Syntaxe : `bx dev host-path-tools [/path/to/build/tools]` - -##### `container-path-tools` -{: #container-path-tools} - -* Emplacement sur le conteneur pour les commandes build, debug, test. -* Syntaxe : `bx dev container-path-tools [/path/for/build]` - -##### `container-port-map` -{: #container-port-map} - -* Mappages de port pour le conteneur. La première valeur est le port à utiliser dans le système d'exploitation hôte, la seconde est le port dans le conteneur (host:container). -* Syntaxe : `bx dev container-port-map [8090:8090,9090,9090]` - -##### `dockerfile-tools` -{: #dockerfile-tools} - -* Fichier Docker pour le conteneur tools. -* Syntaxe : `bx dev dockerfile-tools [path/to/dockerfile]` - -##### `image-name-tools` -{: #image-name-tools} - -* Image à créer depuis dockerfile-tools. -* Syntaxe : `bx dev image-name-tools [path/to/image-name]` - -##### `build-cmd-run` -{: #build-cmd-run} - -* Commande pour générer du code pour toute utilisation sauf DEBUG. -* Syntaxe : `bx dev build-cmd-run [some.build.command]` - -##### `test-cmd` -{: #test-cmd} - -* Commande pour tester le code du conteneur tools. -* Syntaxe : `bx dev test-cmd [/the/test/command]` - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.dev_cli_short}} +{: #developercli} + +Le plug-in {{site.data.keyword.dev_cli_long}} fournit une approche pilotée par commande extensible pour créer, développer et déployer un projet Web avec le plug-in `dev`. Il est idéal pour les développeurs qui souhaitent utiliser un contrôle par ligne de commande tout en développant des applications de microservice de bout en bout. + +{: shortdesc} + +Le plug-in {{site.data.keyword.dev_cli_notm}} utilise deux conteneurs pour faciliter la génération et le test de votre application. Le premier est le conteneur tools qui contient les utilitaires nécessaires pour générer et tester votre application. Le fichier Dockerfile pour ce conteneur est défini par le paramètre [dockerfile-tools](#command-parameters). Considérez-le comme un conteneur de développement puisqu'il contient les outils normalement utilisés pour le développement d'un environnement d'exécution particulier. + +Le second conteneur est le conteneur run. La forme de ce conteneur permet un déploiement pour utilisation, dans {{site.data.keyword.Bluemix}}, par exemple. En conséquence, ce conteneur dispose généralement d'un point d'entrée défini qui démarre votre application. Quand vous choisissez d'exécuter votre application via le plug-in {{site.data.keyword.dev_cli_short}}, ce conteneur est utilisé.Le fichier Dockerfile pour ce conteneur est défini par le paramètre [dockerfile-run](#run-parameters). + + +## Ajout du plug-in {{site.data.keyword.dev_cli_notm}} +{: #add-cli} + + +### Prérequis +{: #prereq} + +Quelques prérequis sont nécessaires pour explorer complètement et utiliser correctement le plug-in {{site.data.keyword.dev_cli_short}}, puisqu'il est hautement extensible et vous permet de tirer parti de technologies complémentaires gratuites. + +1. Installez l'[interface de ligne de commande Cloud Foundry![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/cloudfoundry/cli#getting-started). + +2. Installez l'interface de ligne de commande [{{site.data.keyword.Bluemix}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://clis.ng.bluemix.net/ui/home.html). + +3. Obtenez un ID [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net). + +4. Facultatif : si vous prévoyez d'exécuter et de déboguer des applications localement, vous devez aussi installer [Docker ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.docker.com/get-docker) (requis uniquement pour les projets non mobiles). + + +### Installation +{: #installation} + +1. Installez le plug-in [{{site.data.keyword.dev_cli_short}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} en exécutant la commande suivante : + + ``` + bx plugin install dev -r Bluemix + ``` + {: codeblock} + +2. Validez l'aboutissement de l'installation en exécutant la commande suivante : + + ``` + bx dev + ``` + {: codeblock} + + +### Avant de commencer +{: #before-install} + +1. Connectez-vous à {{site.data.keyword.Bluemix_notm}}. + + ``` + bx login + ``` + {: codeblock} + + **Remarque :** si vos données d'identification sont rejetées, vous utilisez peut-être un ID fédéré. Procédez comme suit pour vous authentifier via un ID fédéré. + + + + 1. Connectez-vous à [{{site.data.keyword.iamshort}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.bluemix.net/iam/#/apikeys){: new_window}. + 2. Sélectionnez la commande de création d'une clé d'API. + * Entrez une description et un nom apiKey. + 3. Téléchargez votre clé apiKey. + 4. Ouvrez le fichier et copiez la valeur depuis la zone `apiKey`. + 5. Connectez-vous en utilisant la commande suivante : + + ``` + bx login --apikey + ``` + {: codeblock} + + +## Commandes +{: #commands} + +Utilisez les commandes décrites ci-après pour créer un projet, le déployer, le déboguer et le tester. + +### Commande build +{: #build} + +Vous pouvez générer votre application en utilisant la commande `build`. L'élément de configuration `build-cmd-run` est utilisé pour générer l'application. Les commandes `test`, `debug` et `run` s'exécutent toutes de la même façon que cette commande dans leur fonctionnement normal, l'exécution de cette dernière avant ces commandes n'est pas donc pas nécessaire. + +Exécutez la commande suivante dans votre répertoire de projet actuel pour générer votre application : + +``` +bx dev build +``` +{: codeblock} + + +[Paramètres de la commande build](#command-parameters) + + +### Commande code +{: #code} + +La commande `code` vous permet de télécharger le code d'application après le déploiement, afin de vous permettre de le réviser localement ou d'y apporter des modifications supplémentaires. + +Exécutez la commande suivante pour télécharger le code à partir du projet spécifié. + +``` +bx dev code +``` +{: codeblock} + + +### Commande create +{: #create} + +La commande create crée un nouveau projet, vous invitant à entrer toutes les informations requises, dont la langue, le nom du projet et le type de modèle d'application. Le projet sera créé dans le répertoire actuel. + +Pour créer un projet dans le répertoire de projet actuel et y associer des services, exécutez la commande suivante : + +``` +bx dev create +``` +{: codeblock} + + +### Commande debug +{: #debug} + +Vous pouvez déboguer votre application via la commande `debug`. Une génération est d'abord effectuée à partir du projet en utilisant l'élément de configuration `build-cmd-debug` comme instruction de génération. Un conteneur est ensuite démarré en exposant un ou plusieurs ports de débogage comme défini dans `container-port-map-debug`. Connectez votre outil de débogage favori au(x) port(s) puis déboguez votre application comme vous le faites normalement. + +**Limite** : les projets Swift ne sont pas actuellement disponibles pour le débogage. + +Exécutez la commande suivante dans votre répertoire de projet actuel pour déboguer votre application. + +``` +bx dev debug +``` +{: codeblock} + +Pour quitter la session de débogage, utilisez `CTRL-C`. + + +#### Paramètres de la commande debug +{: #debug-parameters} + +Les paramètres suivants, qui sont réservés à la commande `debug`, facilitent le débogage d'une application. + +##### `container-port-map-debug` +{: #port-map-debug} + +* Mappages de port pour le port de débogage. La première valeur est le port à utiliser dans le système d'exploitation hôte, la seconde est le port dans le conteneur (host:container). +* Syntaxe : `bx dev debug container-port-map-debug [7777:7777]` + +##### `build-cmd-debug` +{: #build-cmd-debug} + +* Utilisé pour générer du code pour DEBUG. +* Syntaxe : `bx dev debug build-cmd-debug build.command.sh` + +##### `debug-cmd` +{: #debug-cmd} + +* Utilisé pour déboguer le code du conteneur tools. L'utilisation de ce paramètre est facultative si le paramètre `build-cmd-debug` démarre votre application en mode débogage. +* Syntaxe : `bx dev debug debug-cmd /the/debug/command` + +#### Débogage d'une application locale +{: #local-app-dev} + +Pour plus d'informations sur le débogage d'une application locale, voir [Débogage d'une application locale](docs/cloudnative/dev_cli_local_debug.html#local-debug). + + +### Commande delete +{: #delete} + +Cette commande vous permet de supprimer des projets de votre espace {{site.data.keyword.Bluemix}}. + +Exécutez la commande suivante pour supprimer votre projet depuis {{site.data.keyword.Bluemix}} : + +``` +bx dev delete +``` +{: codeblock} + + +**Remarque** : les services {{site.data.keyword.Bluemix}} ne sont **pas** retirés. + + +### Commande help +{: #help} + +Par défaut, si aucune action ou arguments ne sont transmis, ou si l'action help est fournie, cette commande affiche un texte d'aide général. L'aide générale affichée inclut une description des arguments de base ainsi qu'une liste des actions disponibles. + +Exécutez la commande suivante pour afficher des informations d'aide générales : + +``` +bx dev help +``` +{: codeblock} + + +### Commande list +{: #list} + +Vous pouvez répertorier tous les projets {{site.data.keyword.Bluemix_notm}} d'un espace. + +Exécutez la commande suivante pour répertorier vos projets : + +``` +bx dev list +``` +{: codeblock} + + + + + +### Commande run +{: #run} + +Vous pouvez exécuter votre application via la commande `run`. Une génération est d'abord effectuée à partir du projet en utilisant l'élément de configuration `build-cmd-run` comme instruction de génération. Le conteneur run qui est ensuite démarré expose les ports comme défini dans `container-port-map`. Le paramètre `run-cmd` peut être utilisé pour invoquer l'application si le conteneur run ne contient pas de point d'entrée pour terminer cette procédure. + +Exécutez la commande suivante dans votre répertoire de projet actuel pour démarrer votre application : + +``` +bx dev run +``` +{: codeblock} + +Pour quitter la session, utilisez `CTRL-C`. + + +#### Paramètres de la commande run +{: #run-parameters} + +Les paramètres suivants, qui sont réservés à la commande `run`, facilitent la gestion de votre application avec le conteneur run. + +##### `container-name-run` +{: #container-name-run} + +* Nom de conteneur pour le conteneur run. +* Syntaxe : `bx dev run container-name-run ` + +##### `container-path-run` +{: #container-path-run} + +* Emplacement dans le conteneur à partager à l'exécution. +* Syntaxe : `bx dev run container-path-run [/path/to/app]` + +##### `host-path-run` +{: #host-path-run} + +* Emplacement sur le système hôte à partager dans le conteneur à l'exécution. +* Syntaxe : `bx dev run host-path-run [/path/to/app/bin]` + +##### `dockerfile-run` +{: #dockerfile-run} + +* Fichier Docker pour le conteneur run. +* Syntaxe : `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` + +##### `image-name-run` +{: #image-name-run} + +* Image à créer depuis dockerfile-run. +* Syntaxe : `bx dev run image-name-run [/path/to/image-name]` + +##### `run-cmd` +{: #run-cmd} + +* Paramètre facultatif utilisé pour exécuter le code dans le conteneur run. L'utilisation de ce paramètre est facultative si votre image démarre votre application. +* Syntaxe : `bx dev run run-cmd [/the/run/command]` + +### Commande status +{: #status} + +Vous pouvez effectuer une requête relative au statut des conteneurs utilisés par {{site.data.keyword.dev_cli_short}}, comme défini par `container-name-run` et `container-name-tools`. + +Exécutez la commande suivante dans votre répertoire de projet actuel pour vérifier le statut du conteneur : + +``` +bx dev status +``` +{: codeblock} + + +[Paramètres de la commande status](#command-parameters) + + +### Commande stop +{: #stop} + +Vous pouvez arrêter un conteneur via la commande `stop`. Le paramètre `container-name` vous permet de spécifier le conteneur à arrêter. Si rien n'est spécifié, la commande stop arrête le conteneur run comme défini par `container-name-run`. + +Exécutez la commande suivante dans votre répertoire de projet actuel pour arrêter un conteneur : + +``` +bx dev stop +``` +{: codeblock} + + +#### Paramètre stop supplémentaire : +{: #stop-parameter} + +##### `container-name` +{: #container-name} + +* Nom de conteneur pour le conteneur tools. +* Syntaxe : `bx dev stop container-name ` + +### Commande Test +{: #test} + +Vous pouvez tester votre application via la commande `test`. Une génération est d'abord effectuée à partir du projet en utilisant l'élément de configuration `build-cmd-run` comme instruction de génération. Le conteneur tools est ensuite utilisé pour invoquer `test-cmd` pour l'application. + +Exécutez la commande suivante pour tester votre application : + +``` +bx dev test +``` +{: codeblock} + + +[Paramètres de la commande test](#command-parameters) + + +## Paramètres pour les commandes build, debug, run et test +{: #command-parameters} + +Les paramètres suivants, qui peuvent être associés aux commandes `build|debug|run|test`, sont spécifiables via une ligne de commande et/ou en mettant à jour directement le fichier `cli-config.yml` du projet. Des paramètres supplémentaires, disponibles pour les commandes [`debug`](#debug-parameters) et [`run`](#run-parameters), sont documentés dans leurs sections respectives. + +**Remarque** : les paramètres de commande entrés dans la ligne de commande sont prioritaires sur ceux du fichier de configuration `cli-config.yml`. + +##### `container-name-tools` +{: #container-name-tools} + +* Nom de conteneur pour le conteneur tools. +* Syntaxe : `bx dev container-name-tools []` + +##### `host-path-tools` +{: #host-path-tools} + +* Emplacement sur l'hôte à partager pour les commandes build, debug, test. +* Syntaxe : `bx dev host-path-tools [/path/to/build/tools]` + +##### `container-path-tools` +{: #container-path-tools} + +* Emplacement sur le conteneur pour les commandes build, debug, test. +* Syntaxe : `bx dev container-path-tools [/path/for/build]` + +##### `container-port-map` +{: #container-port-map} + +* Mappages de port pour le conteneur. La première valeur est le port à utiliser dans le système d'exploitation hôte, la seconde est le port dans le conteneur (host:container). +* Syntaxe : `bx dev container-port-map [8090:8090,9090,9090]` + +##### `dockerfile-tools` +{: #dockerfile-tools} + +* Fichier Docker pour le conteneur tools. +* Syntaxe : `bx dev dockerfile-tools [path/to/dockerfile]` + +##### `image-name-tools` +{: #image-name-tools} + +* Image à créer depuis dockerfile-tools. +* Syntaxe : `bx dev image-name-tools [path/to/image-name]` + +##### `build-cmd-run` +{: #build-cmd-run} + +* Commande pour générer du code pour toute utilisation sauf DEBUG. +* Syntaxe : `bx dev build-cmd-run [some.build.command]` + +##### `test-cmd` +{: #test-cmd} + +* Commande pour tester le code du conteneur tools. +* Syntaxe : `bx dev test-cmd [/the/test/command]` + diff --git a/cloudnative/nl/fr/dev_cli_local_debug.md b/cloudnative/nl/fr/dev_cli_local_debug.md index 13913db14..0aff826e9 100644 --- a/cloudnative/nl/fr/dev_cli_local_debug.md +++ b/cloudnative/nl/fr/dev_cli_local_debug.md @@ -1,78 +1,78 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Débogage d'une application locale -{: #local-debug} - -Les instructions de débogage d'une application locale sont fournies ci-après pour les langages suivants : - -* [Java](#java) -* [Node.js](#node) - -**Remarque** : le débogage des applications Swift n'est pas actuellement pris en charge. - -## Débogage d'une application Java -{: #java} - -Procédez comme suit pour activer le débogage pour une application Java : - -1. Depuis le répertoire racine de votre projet d'application, exécutez la commande suivante : - - `bx dev debug -` - -2. Connectez le débogueur à votre application : - - * [Eclipse ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) - * [IntelliJ ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) - * [VSCode ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) - * Ligne de commande JDK : `jdb -attach ` - -## Débogage d'une application Node.js - -{: #node} - -Procédez comme suit pour activer le débogage pour une application Node.js : - -1. Depuis le répertoire racine de votre projet d'application, exécutez la commande suivante : - - `bx dev debug -` - -2. Connectez le débogueur à votre application : - * [VSCode ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://blog.docker.com/2016/07/live-debugging-docker/). - * [WebStorm ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Débogage d'une application locale +{: #local-debug} + +Les instructions de débogage d'une application locale sont fournies ci-après pour les langages suivants : + +* [Java](#java) +* [Node.js](#node) + +**Remarque** : le débogage des applications Swift n'est pas actuellement pris en charge. + +## Débogage d'une application Java +{: #java} + +Procédez comme suit pour activer le débogage pour une application Java : + +1. Depuis le répertoire racine de votre projet d'application, exécutez la commande suivante : + + `bx dev debug +` + +2. Connectez le débogueur à votre application : + + * [Eclipse ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) + * [IntelliJ ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) + * [VSCode ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) + * Ligne de commande JDK : `jdb -attach ` + +## Débogage d'une application Node.js + +{: #node} + +Procédez comme suit pour activer le débogage pour une application Node.js : + +1. Depuis le répertoire racine de votre projet d'application, exécutez la commande suivante : + + `bx dev debug +` + +2. Connectez le débogueur à votre application : + * [VSCode ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://blog.docker.com/2016/07/live-debugging-docker/). + * [WebStorm ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) + + + + + diff --git a/cloudnative/nl/fr/devex.md b/cloudnative/nl/fr/devex.md index 8df6719ed..205ef9933 100644 --- a/cloudnative/nl/fr/devex.md +++ b/cloudnative/nl/fr/devex.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.dev_console}} -{: #devex} - -Pour commencer à utiliser la console [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://console.{DomainName}/developer/getting-started), cliquez sur la catégorie relative aux services web et mobiles de votre console {{site.data.keyword.Bluemix_notm}}. - - -## Initiation -{: getting-started} - -Créez un projet sur la page -**Initiation** en cliquant sur **Créer un projet**. Les options de [modèle](patterns.html), de [démarrage](starters.html) et de [langue](patterns.html#languages) qui vous sont proposées vous permettent de créer rapidement votre application. - -Vous pouvez afficher et gérer tous vos projets en un seul endroit en sélectionnant la page [Projets ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://console.{DomainName}/developer/projects) page. Le projet contient les informations relatives à toutes les fonctionnalités qui sont (et peuvent être) intégrées à votre application. S'ils sont disponibles, vous pouvez facilement intégrer et gérer les services de push, d'analyse, d'authentification et de données dans le projet (d'autres fonctionnalités seront bientôt accessibles). - -La page [Services](services.html) propose une vue opérationnelle de vos instances de services existantes. La console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} prend en charge un développeur de cloud natif et un utilisateur de gestion d'application de cloud natif. - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.dev_console}} +{: #devex} + +Pour commencer à utiliser la console [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://console.{DomainName}/developer/getting-started), cliquez sur la catégorie relative aux services web et mobiles de votre console {{site.data.keyword.Bluemix_notm}}. + + +## Initiation +{: getting-started} + +Créez un projet sur la page +**Initiation** en cliquant sur **Créer un projet**. Les options de [modèle](patterns.html), de [démarrage](starters.html) et de [langue](patterns.html#languages) qui vous sont proposées vous permettent de créer rapidement votre application. + +Vous pouvez afficher et gérer tous vos projets en un seul endroit en sélectionnant la page [Projets ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://console.{DomainName}/developer/projects) page. Le projet contient les informations relatives à toutes les fonctionnalités qui sont (et peuvent être) intégrées à votre application. S'ils sont disponibles, vous pouvez facilement intégrer et gérer les services de push, d'analyse, d'authentification et de données dans le projet (d'autres fonctionnalités seront bientôt accessibles). + +La page [Services](services.html) propose une vue opérationnelle de vos instances de services existantes. La console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} prend en charge un développeur de cloud natif et un utilisateur de gestion d'application de cloud natif. + + + diff --git a/cloudnative/nl/fr/get_code.md b/cloudnative/nl/fr/get_code.md index a6948f00a..e85a89807 100644 --- a/cloudnative/nl/fr/get_code.md +++ b/cloudnative/nl/fr/get_code.md @@ -1,83 +1,83 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-18" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# Obtention du code -{: #Get_Code} - -Une fois que vous avez terminé la configuration et l'installation de votre projet avec les fonctionnalités sélectionnées, vous pouvez télécharger le code permettant l'exécution. Le -projet téléchargé est préconfiguré avec les dépendances aux logiciels SDK -requises et les données d'identification de chaque fonction configurée. - -Vous devez terminer les données d'identification des services qui ne sont pas configurables dans le projet téléchargé. Le fichier `README.md` du projet du module de démarrage contient les instructions associées. Consultez le fichier `README.md` dans un afficheur Markdown afin de terminer la configuration. - -## Outils prérequis pour le développeur -{: #prereq-dev-tools} - -Les outils de développement suivants sont nécessaires quand vous utilisez le code généré depuis la console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} : - - -### Général -{: #general notoc} - -* [Homebrew ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://brew.sh/) - * Outil de ligne de commande facilitant l'installation d'autres outils, tels que CocoaPods et Carthage, destiné aux développeurs Apple. - -* [Docker ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.docker.com/get-docker) - * Projet open-source offrant une assistance à l'exécution et au débogage des applications dans des conteneurs. Requis uniquement pour les projets non mobiles. - -### {{site.data.keyword.Bluemix_notm}} -{: #bluemix notoc} - -* Node.js (modules d'exécution Node et npm) facilitant l'exécution d'{{site.data.keyword.apiconnect_short}} Loopback et d'autres outils de productivité {{site.data.keyword.Bluemix_notm}}. - - Pour exécuter les outils {{site.data.keyword.apiconnect_short}}, utilisez Node 5.x : - - ``` - $ brew install Node5 - ``` - -* [Outils de l'interface de ligne de commande Bluemix ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://clis.ng.bluemix.net/ui/home.html) - - Outils de ligne de commande pour déployer des modules d'exécution Cloud Foundry à partir d'une interface de ligne de commande avec {{site.data.keyword.Bluemix_notm}}. - -* [{{site.data.keyword.dev_cli_notm}} ![Icône de lien externe](../icons/launch-glyph.svg "Icônede lien externe")](dev_cli.html) - - - Plug-in d'interface de ligne de commande {{site.data.keyword.Bluemix_notm}} pour créer, exécuter, tester et déployer des projets Web et mobiles. - -* [Plug-in de générateur SDK![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](sdk_cli.html) - - Plug-in d'interface de ligne de commande {{site.data.keyword.Bluemix_notm}} pour générer des SDK depuis votre définition d'API REST conforme à la [spécification Open API ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.openapis.org/). - -### Android -{: #android notoc} - -* [Android Studio 2.2 ou supérieur![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://developer.android.com/studio) - * Installez le dernier environnement d'exécution [Android 7.0 ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.android.com/versions/nougat-7-0/). - -### iOS -{: #ios notoc} - -* [Xcode 8 ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com/xcode/) (recommandé) - - -* [Gestionnaire de dépendances CocoaPods ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://cocoapods.org/) pour l'installation des dépendances du SDK iOS. Utilisez la version la plus récente : - - ``` - $ sudo gem install cocoapods --pre - ``` -* [Gestionnaire de dépendances Carthage ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/Carthage/Carthage) pour l'installation des SDK de {{site.data.keyword.watson}} Developer Cloud. - - ``` - $ brew install carthage - ``` +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-18" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# Obtention du code +{: #Get_Code} + +Une fois que vous avez terminé la configuration et l'installation de votre projet avec les fonctionnalités sélectionnées, vous pouvez télécharger le code permettant l'exécution. Le +projet téléchargé est préconfiguré avec les dépendances aux logiciels SDK +requises et les données d'identification de chaque fonction configurée. + +Vous devez terminer les données d'identification des services qui ne sont pas configurables dans le projet téléchargé. Le fichier `README.md` du projet du module de démarrage contient les instructions associées. Consultez le fichier `README.md` dans un afficheur Markdown afin de terminer la configuration. + +## Outils prérequis pour le développeur +{: #prereq-dev-tools} + +Les outils de développement suivants sont nécessaires quand vous utilisez le code généré depuis la console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} : + + +### Général +{: #general notoc} + +* [Homebrew ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://brew.sh/) + * Outil de ligne de commande facilitant l'installation d'autres outils, tels que CocoaPods et Carthage, destiné aux développeurs Apple. + +* [Docker ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.docker.com/get-docker) + * Projet open-source offrant une assistance à l'exécution et au débogage des applications dans des conteneurs. Requis uniquement pour les projets non mobiles. + +### {{site.data.keyword.Bluemix_notm}} +{: #bluemix notoc} + +* Node.js (modules d'exécution Node et npm) facilitant l'exécution d'{{site.data.keyword.apiconnect_short}} Loopback et d'autres outils de productivité {{site.data.keyword.Bluemix_notm}}. + + Pour exécuter les outils {{site.data.keyword.apiconnect_short}}, utilisez Node 5.x : + + ``` + $ brew install Node5 + ``` + +* [Outils de l'interface de ligne de commande Bluemix ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://clis.ng.bluemix.net/ui/home.html) + + Outils de ligne de commande pour déployer des modules d'exécution Cloud Foundry à partir d'une interface de ligne de commande avec {{site.data.keyword.Bluemix_notm}}. + +* [{{site.data.keyword.dev_cli_notm}} ![Icône de lien externe](../icons/launch-glyph.svg "Icônede lien externe")](dev_cli.html) + + + Plug-in d'interface de ligne de commande {{site.data.keyword.Bluemix_notm}} pour créer, exécuter, tester et déployer des projets Web et mobiles. + +* [Plug-in de générateur SDK![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](sdk_cli.html) + + Plug-in d'interface de ligne de commande {{site.data.keyword.Bluemix_notm}} pour générer des SDK depuis votre définition d'API REST conforme à la [spécification Open API ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.openapis.org/). + +### Android +{: #android notoc} + +* [Android Studio 2.2 ou supérieur![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://developer.android.com/studio) + * Installez le dernier environnement d'exécution [Android 7.0 ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.android.com/versions/nougat-7-0/). + +### iOS +{: #ios notoc} + +* [Xcode 8 ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com/xcode/) (recommandé) + + +* [Gestionnaire de dépendances CocoaPods ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://cocoapods.org/) pour l'installation des dépendances du SDK iOS. Utilisez la version la plus récente : + + ``` + $ sudo gem install cocoapods --pre + ``` +* [Gestionnaire de dépendances Carthage ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/Carthage/Carthage) pour l'installation des SDK de {{site.data.keyword.watson}} Developer Cloud. + + ``` + $ brew install carthage + ``` diff --git a/cloudnative/nl/fr/index.md b/cloudnative/nl/fr/index.md index 31c1d5d70..852114118 100644 --- a/cloudnative/nl/fr/index.md +++ b/cloudnative/nl/fr/index.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2016-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Génération de projets de cloud natifs -{: #web-mobile} - -Vous pouvez gérer des applications de cloud natives via le concept des [projets](projects.html) {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. La création d'un projet est possible en utilisant la console [{{site.data.keyword.dev_console}}](devex.html) ou le plug-in [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) pour l'interface de ligne de commande {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}}. La console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} regroupe les fonctionnalités de service les plus courantes nécessaires à un développeur d'applications de cloud natives, dans un endroit unique et connecté, qui a été optimisé pour ce développeur. - -La console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} permet à un développeur d'applications de cloud natives de créer un projet à partir de différents [types de modèle](patterns.html) et [modules de démarrage](starters.html), de créer et de connecter des services clé {{site.data.keyword.Bluemix_notm}} optimisés dans votre projet et de télécharger rapidement du code d'exécution avec des SDK. Ces derniers sont complètement intégrés avec des données d'identification de fonctionnalités ou des dépendances qui vous permettent d'activer la fonction correspondante sur votre périphérique en quelques minutes. Quand votre application s'exécute et que vous avez défini et configuré les fonctionnalités, vous pouvez revenir à votre projet pour surveiller et gérer l'engagement des utilisateurs de l'application. Vous pouvez aussi configurer et gérer vos services via la console {{site.data.keyword.dev_console}}. - - - - - - -# Liens connexes -{: #rellinks notoc} - -## Tutoriels et exemples -{: #samples notoc} - -* [Exemple : Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} -* [Tutoriels vidéos](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2016-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Génération de projets de cloud natifs +{: #web-mobile} + +Vous pouvez gérer des applications de cloud natives via le concept des [projets](projects.html) {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. La création d'un projet est possible en utilisant la console [{{site.data.keyword.dev_console}}](devex.html) ou le plug-in [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) pour l'interface de ligne de commande {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}}. La console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} regroupe les fonctionnalités de service les plus courantes nécessaires à un développeur d'applications de cloud natives, dans un endroit unique et connecté, qui a été optimisé pour ce développeur. + +La console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} permet à un développeur d'applications de cloud natives de créer un projet à partir de différents [types de modèle](patterns.html) et [modules de démarrage](starters.html), de créer et de connecter des services clé {{site.data.keyword.Bluemix_notm}} optimisés dans votre projet et de télécharger rapidement du code d'exécution avec des SDK. Ces derniers sont complètement intégrés avec des données d'identification de fonctionnalités ou des dépendances qui vous permettent d'activer la fonction correspondante sur votre périphérique en quelques minutes. Quand votre application s'exécute et que vous avez défini et configuré les fonctionnalités, vous pouvez revenir à votre projet pour surveiller et gérer l'engagement des utilisateurs de l'application. Vous pouvez aussi configurer et gérer vos services via la console {{site.data.keyword.dev_console}}. + + + + + + +# Liens connexes +{: #rellinks notoc} + +## Tutoriels et exemples +{: #samples notoc} + +* [Exemple : Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} +* [Tutoriels vidéos](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} diff --git a/cloudnative/nl/fr/patterns.md b/cloudnative/nl/fr/patterns.md index 62e13a583..e5879d451 100644 --- a/cloudnative/nl/fr/patterns.md +++ b/cloudnative/nl/fr/patterns.md @@ -1,100 +1,100 @@ - ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Types de modèle -{: #patterns} - -Les modèles de cloud natifs sont des structures qui ont fait leur preuve et dont l'utilisation permet de garantir une topologie fiable, évolutive et cohérente pour vos applications. Quand vous créez un projet, il vous est proposé différents types de modèle parmi lesquels vous pouvez choisir. Vous sélectionnez simplement le type de modèle et les fonctionnalités que vous voulez incorporer dans votre projet. Une fois vos préférences de projet définies, un projet de démarrage est généré que vous pouvez éditer, exécuter ou déboguer, et déployer localement ou dans {{site.data.keyword.Bluemix}}. - -## Application Web -{: #web} - -Les projets Web donnent la possibilité de servir du contenu Web (HTML, JavaScript et feuilles de style, par exemple) sur le serveur Web. - -Les modules de démarrage Web suivants sont disponibles : - -* Basic Web : sert un fichier `index.html` statique, une feuille de style vide et par défaut et un fichier JavaScript. -* Webpack : crée un projet dans lequel les fichiers source ES6 (ECMAScript 6) se trouvent dans `src/client` et sont compilés avec WebPack, pour en retirer les caractères non essentiels, puis convertis pour utilisation dans le navigateur. -* Webpack + React : infrastructure riche pour générer des interfaces utilisateur. Les fichiers source, qui se trouvent dans `src/client/app`, seront compilés avec WebPack et servis dans l'annuaire public. - - -## Application mobile -{: #mobile} - -Les modèles d'application mobile vous aident à gérer des applications mobiles qui se connectent directement aux services de backend, comme {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, -{{site.data.keyword.appid_short}}, etc. Des projets peuvent également être ajoutés via sdkGen, comme BFF, et Microservices. - -Vous pouvez choisir dans une liste de modules de démarrage, comme {{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, {{site.data.keyword.openwhisk_short}}, etc. - -Vous pouvez générer des applications mobiles dans Swift, Android ou Cordova. - - -## BFF (Backend for Frontend) -{: #bff} - -Les modèles BFF vous permettent de vous concentrer efficacement sur l'exposition des données et services métier sous une forme qui répond aux besoins d'interaction de l'utilisateur. Pour optimiser la démarche utilisateur vers votre solution de cloud, il peut s'avérer nécessaire de mettre en place une démarche utilisateur différente pour l'application mobile et une démarche plus détaillée et plus riche pour l'application Web. Avec l'introduction de périphériques pilotés par la voix comme le service [{{site.data.keyword.conversationfull}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.ibm.com/watson/developercloud/conversation.html), l'interaction avec l'utilisateur peut être contrôlée par la voix. Ce canal numérique nécessite une architecture BFF très différente pour gérer ces interactions vocales. - -Avec {{site.data.keyword.Bluemix_notm}}, vous pouvez générer une architecture BFF en mettant en oeuvre une approche de programmation polyglotte pour procéder à sa définition. IBM recommande d'utiliser Node.js, Swift ou Java, en les exécutant dans un environnement de cloud natif, avec les services Cloud Foundry, Container ou sans serveur. - -L'architecture BFF gère l'intégration avec les services pour la persistance des données, la mise en cache et l'intégration à des services à haute valeur comme {{site.data.keyword.ibmwatson}}, {{site.data.keyword.iot_short_notm}}, {{site.data.keyword.weather_short}}, et l'analyse de données, tel {{site.data.keyword.sparks}}. - -L'architecture BFF expose une API se servant le plus souvent d'un modèle REST mais vous pouvez concevoir votre architecture BFF afin qu'elle fonctionne depuis une architecture de messagerie utilisant {{site.data.keyword.messagehub}}. - -Un module de démarrage BFF Basic est disponible via Node.js ou Swift. - - -## Microservice -{: #microservice} - -Les projets Microservice constituent le fondement de la génération de microservices de backend, incluant un noeud final de santé de base, une API REST. Les projets générés contiendront toutes les dépendances requises pour les microservices eux-mêmes ainsi que pour tout service de cloud attaché. - -Un module de démarrage Microservice Basic est disponible en utilisant Java. - - - - -## Langages -{: #languages notoc} - -Les langages pris en charge sont : - - * [Java ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](../runtimes/liberty/getting-started.html){: new_window} - * [Node.js ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](../runtimes/nodejs/getting-started.html){: new_window} - * [Swift ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](../runtimes/swift/getting-started.html){: new_window} - - -### Java -{: #java notoc} - -Java dispose de fonctionnalités qui ont fait leur preuve pour générer des applications destinées aux entreprises, mais les nouvelles fonctionnalités de Java 8, associées à des temps d'exécution de poids plus réduit comme ceux assurés par Liberty et les infrastructures telles Spring Boot, font de Java un outil également parfaitement adapté à la génération des microservices. - - -### Node.js -{: #node notoc} - -Node.js est un environnement d'exécution JavaScript qui utilise un modèle d'entrée/sortie non bloquant, géré par événement, qui le rend léger, efficace et extrêmement performant au niveau de la capacité de traitement et de l'évolutivité pour les applications Web, les modèles BFF et les microservices. L'écosystème de package Node.js, npm, permet d'accéder à une large collection de modules open source, fournissant une large gamme de fonctionnalités pour accélérer le développement de votre application. - - -### Swift -{: #swift notoc} - -Swift est un langage de programmation moderne créé par Apple en 2014 qui a été conçu pour remplacer Objective C, en open source, en décembre 2015. Il sert aujourd'hui à générer iOS, macOS, des services Web et des logiciels système sous les systèmes d'exploitation Linux et macOS via l'architecture x86, ARM ou Z. Il écrit comme un langage de script mais est compilé pour obtenir des performances élevées similaires à C avec de faibles temps de traitement, ce qui le rend idéal pour les environnements d'exécution de cloud. Il se sert d'un système de type statique et fort que vous retrouvez dans Java alors que le style fonctionnel et les routines asynchrones correspondent à ce que vous voyez dans JavaScript. Swift est donc très performant, la source compile en code natif en utilisant la chaîne d'outils du compilateur LLVM et il est capable d'optimiser facilement des bibliothèques de systèmes externes écrites en C. + +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Types de modèle +{: #patterns} + +Les modèles de cloud natifs sont des structures qui ont fait leur preuve et dont l'utilisation permet de garantir une topologie fiable, évolutive et cohérente pour vos applications. Quand vous créez un projet, il vous est proposé différents types de modèle parmi lesquels vous pouvez choisir. Vous sélectionnez simplement le type de modèle et les fonctionnalités que vous voulez incorporer dans votre projet. Une fois vos préférences de projet définies, un projet de démarrage est généré que vous pouvez éditer, exécuter ou déboguer, et déployer localement ou dans {{site.data.keyword.Bluemix}}. + +## Application Web +{: #web} + +Les projets Web donnent la possibilité de servir du contenu Web (HTML, JavaScript et feuilles de style, par exemple) sur le serveur Web. + +Les modules de démarrage Web suivants sont disponibles : + +* Basic Web : sert un fichier `index.html` statique, une feuille de style vide et par défaut et un fichier JavaScript. +* Webpack : crée un projet dans lequel les fichiers source ES6 (ECMAScript 6) se trouvent dans `src/client` et sont compilés avec WebPack, pour en retirer les caractères non essentiels, puis convertis pour utilisation dans le navigateur. +* Webpack + React : infrastructure riche pour générer des interfaces utilisateur. Les fichiers source, qui se trouvent dans `src/client/app`, seront compilés avec WebPack et servis dans l'annuaire public. + + +## Application mobile +{: #mobile} + +Les modèles d'application mobile vous aident à gérer des applications mobiles qui se connectent directement aux services de backend, comme {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, +{{site.data.keyword.appid_short}}, etc. Des projets peuvent également être ajoutés via sdkGen, comme BFF, et Microservices. + +Vous pouvez choisir dans une liste de modules de démarrage, comme {{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, {{site.data.keyword.openwhisk_short}}, etc. + +Vous pouvez générer des applications mobiles dans Swift, Android ou Cordova. + + +## BFF (Backend for Frontend) +{: #bff} + +Les modèles BFF vous permettent de vous concentrer efficacement sur l'exposition des données et services métier sous une forme qui répond aux besoins d'interaction de l'utilisateur. Pour optimiser la démarche utilisateur vers votre solution de cloud, il peut s'avérer nécessaire de mettre en place une démarche utilisateur différente pour l'application mobile et une démarche plus détaillée et plus riche pour l'application Web. Avec l'introduction de périphériques pilotés par la voix comme le service [{{site.data.keyword.conversationfull}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.ibm.com/watson/developercloud/conversation.html), l'interaction avec l'utilisateur peut être contrôlée par la voix. Ce canal numérique nécessite une architecture BFF très différente pour gérer ces interactions vocales. + +Avec {{site.data.keyword.Bluemix_notm}}, vous pouvez générer une architecture BFF en mettant en oeuvre une approche de programmation polyglotte pour procéder à sa définition. IBM recommande d'utiliser Node.js, Swift ou Java, en les exécutant dans un environnement de cloud natif, avec les services Cloud Foundry, Container ou sans serveur. + +L'architecture BFF gère l'intégration avec les services pour la persistance des données, la mise en cache et l'intégration à des services à haute valeur comme {{site.data.keyword.ibmwatson}}, {{site.data.keyword.iot_short_notm}}, {{site.data.keyword.weather_short}}, et l'analyse de données, tel {{site.data.keyword.sparks}}. + +L'architecture BFF expose une API se servant le plus souvent d'un modèle REST mais vous pouvez concevoir votre architecture BFF afin qu'elle fonctionne depuis une architecture de messagerie utilisant {{site.data.keyword.messagehub}}. + +Un module de démarrage BFF Basic est disponible via Node.js ou Swift. + + +## Microservice +{: #microservice} + +Les projets Microservice constituent le fondement de la génération de microservices de backend, incluant un noeud final de santé de base, une API REST. Les projets générés contiendront toutes les dépendances requises pour les microservices eux-mêmes ainsi que pour tout service de cloud attaché. + +Un module de démarrage Microservice Basic est disponible en utilisant Java. + + + + +## Langages +{: #languages notoc} + +Les langages pris en charge sont : + + * [Java ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](../runtimes/liberty/getting-started.html){: new_window} + * [Node.js ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](../runtimes/nodejs/getting-started.html){: new_window} + * [Swift ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](../runtimes/swift/getting-started.html){: new_window} + + +### Java +{: #java notoc} + +Java dispose de fonctionnalités qui ont fait leur preuve pour générer des applications destinées aux entreprises, mais les nouvelles fonctionnalités de Java 8, associées à des temps d'exécution de poids plus réduit comme ceux assurés par Liberty et les infrastructures telles Spring Boot, font de Java un outil également parfaitement adapté à la génération des microservices. + + +### Node.js +{: #node notoc} + +Node.js est un environnement d'exécution JavaScript qui utilise un modèle d'entrée/sortie non bloquant, géré par événement, qui le rend léger, efficace et extrêmement performant au niveau de la capacité de traitement et de l'évolutivité pour les applications Web, les modèles BFF et les microservices. L'écosystème de package Node.js, npm, permet d'accéder à une large collection de modules open source, fournissant une large gamme de fonctionnalités pour accélérer le développement de votre application. + + +### Swift +{: #swift notoc} + +Swift est un langage de programmation moderne créé par Apple en 2014 qui a été conçu pour remplacer Objective C, en open source, en décembre 2015. Il sert aujourd'hui à générer iOS, macOS, des services Web et des logiciels système sous les systèmes d'exploitation Linux et macOS via l'architecture x86, ARM ou Z. Il écrit comme un langage de script mais est compilé pour obtenir des performances élevées similaires à C avec de faibles temps de traitement, ce qui le rend idéal pour les environnements d'exécution de cloud. Il se sert d'un système de type statique et fort que vous retrouvez dans Java alors que le style fonctionnel et les routines asynchrones correspondent à ce que vous voyez dans JavaScript. Swift est donc très performant, la source compile en code natif en utilisant la chaîne d'outils du compilateur LLVM et il est capable d'optimiser facilement des bibliothèques de systèmes externes écrites en C. diff --git a/cloudnative/nl/fr/projects.md b/cloudnative/nl/fr/projects.md index 1e8cc99bf..0c52070e6 100644 --- a/cloudnative/nl/fr/projects.md +++ b/cloudnative/nl/fr/projects.md @@ -1,61 +1,61 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Projets -{: #projects} - -La console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} combine l'interface utilisateur, les données et les services d'une application au sein d'un *projet* complet. Lorsque vous créez un projet, tous les composants requis de votre application, ainsi que les fonctions ajoutées sont gérées sur le serveur {{site.data.keyword.Bluemix_notm}}. Vous pouvez télécharger le code de votre application ainsi que les données d'identification et les initialiseurs requis si les services sont configurés dans votre projet. Vous pouvez afficher tous vos projets en sélectionnant **Projets**. - -Vous pouvez afficher des informations supplémentaires sur un projet unique en le sélectionnant dans la page **Projets**. La page relative à la présentation du projet qui s'affiche comprend les services configurés et disponibles pour le projet. Les services sont des fonctions distinctes qui étendent la fonctionnalité de votre application. Etant donné qu'il s'agit d'un ajout individuel, vous pouvez ajouter les services dont vous avez besoin, comme les services de notifications push, d'authentification, de données et de stockage ou d'autres services. Quand vous ajoutez un service à votre projet sur la page relative à la présentation du projet puis suivez les instructions pour le configurer, il est automatiquement associé à votre application. Pour plus d'informations sur la page de présentation du projet, voir la rubrique traitant de cette [page](project_overview_page.html). - -Pour créer votre projet, vous devez sélectionner un [modèle](patterns.html) puis un [module de démarrage](starters.html). - - -## Page de présentation du projet -{: #project_overview} - -Vous pouvez afficher et utiliser un seul projet {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} en sélectionnant ce projet sur la page **Projets**, ce qui ouvre la page relative à la présentation du projet. -{: shortdesc} - -La page relative à la présentation du projet affiche une vignette pour chaque fonctionnalité qui est configurée ou disponible pour configuration avec le projet sélectionné. La vignette, qui indique le type de fonctionnalité, comporte un bouton *actions* avec trois boutons verticaux. Les fonctionnalités disponibles incluent, par exemple, les services {{site.data.keyword.mobilepushshort}}, Analytics ou Data et Storage. Les fonctionnalités compatibles dépendant du type de projet et des fonctionnalités disponibles dans la région concernée, il est possible que toutes les fonctionnalités ne soient pas disponibles avec tous les projets. - -Quand un type de fonctionnalité n'est pas encore associé au projet, un bouton **Créer** est affiché sur la vignette. Les options du bouton -d'actions permettent de créer une instance du service ou d'ajouter une instance de service existante si la fonctionnalité n'est pas encore associée. La sélection de l'option d'ajout d'une instance de service existante fournit une liste des instances de service de ce type au sein de votre espace. - -Si la fonctionnalité est déjà associée à ce projet, le nom de l'instance de service associée est affiché sur la vignette après le type de -fonctionnalité, ce qui facilite l'identification de l'instance de service associée à votre projet sur votre console {{site.data.keyword.dev_console}}. Les -actions disponibles sur le bouton d'action sont les suivantes : **Afficher** et **Retirer** quand la fonctionnalité est déjà associée au projet. Le retrait d'une instance de service efface seulement l'association à ce projet et ne supprime pas l'instance de service de votre console {{site.data.keyword.dev_console}}. Pour supprimer une instance de service, cliquez sur la page accessible en sélectionnant les options relatives aux services Web et mobiles pour afficher et supprimer les instances de service voulues. - -Sélectionnez la commande relative à l'obtention du code sur la vignette **Code** pour télécharger le code pour votre projet. Pour plus d'informations sur le -téléchargement du code, voir [Obtention du code](get_code.html). - - -## Mise à jour de votre projet pour utiliser un nouveau module de démarrage -{: #update-starter} - -1. Depuis la page relative aux projets ou à la présentation du projet, cliquez sur l'icône du menu déroulant dynamique et sélectionnez le module de démarrage de la mise à jour. - -2. Choisissez un nouveau module de démarrage puis cliquez sur **Mettre à jour**. - -3. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. - - Vous pouvez également cliquer sur la page **Code**. - - -## Mise à jour de votre projet pour générer un nouveau langage -{: #update-language} - -1. Depuis la page relative au projet ou à la présentation du projet, cliquez sur l'icône du menu déroulant dynamique et sélectionnez le module de démarrage de la mise à jour. - -2. Sélectionnez un nouveau langage et cliquez sur **Mettre à jour**. - -3. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Projets +{: #projects} + +La console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} combine l'interface utilisateur, les données et les services d'une application au sein d'un *projet* complet. Lorsque vous créez un projet, tous les composants requis de votre application, ainsi que les fonctions ajoutées sont gérées sur le serveur {{site.data.keyword.Bluemix_notm}}. Vous pouvez télécharger le code de votre application ainsi que les données d'identification et les initialiseurs requis si les services sont configurés dans votre projet. Vous pouvez afficher tous vos projets en sélectionnant **Projets**. + +Vous pouvez afficher des informations supplémentaires sur un projet unique en le sélectionnant dans la page **Projets**. La page relative à la présentation du projet qui s'affiche comprend les services configurés et disponibles pour le projet. Les services sont des fonctions distinctes qui étendent la fonctionnalité de votre application. Etant donné qu'il s'agit d'un ajout individuel, vous pouvez ajouter les services dont vous avez besoin, comme les services de notifications push, d'authentification, de données et de stockage ou d'autres services. Quand vous ajoutez un service à votre projet sur la page relative à la présentation du projet puis suivez les instructions pour le configurer, il est automatiquement associé à votre application. Pour plus d'informations sur la page de présentation du projet, voir la rubrique traitant de cette [page](project_overview_page.html). + +Pour créer votre projet, vous devez sélectionner un [modèle](patterns.html) puis un [module de démarrage](starters.html). + + +## Page de présentation du projet +{: #project_overview} + +Vous pouvez afficher et utiliser un seul projet {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} en sélectionnant ce projet sur la page **Projets**, ce qui ouvre la page relative à la présentation du projet. +{: shortdesc} + +La page relative à la présentation du projet affiche une vignette pour chaque fonctionnalité qui est configurée ou disponible pour configuration avec le projet sélectionné. La vignette, qui indique le type de fonctionnalité, comporte un bouton *actions* avec trois boutons verticaux. Les fonctionnalités disponibles incluent, par exemple, les services {{site.data.keyword.mobilepushshort}}, Analytics ou Data et Storage. Les fonctionnalités compatibles dépendant du type de projet et des fonctionnalités disponibles dans la région concernée, il est possible que toutes les fonctionnalités ne soient pas disponibles avec tous les projets. + +Quand un type de fonctionnalité n'est pas encore associé au projet, un bouton **Créer** est affiché sur la vignette. Les options du bouton +d'actions permettent de créer une instance du service ou d'ajouter une instance de service existante si la fonctionnalité n'est pas encore associée. La sélection de l'option d'ajout d'une instance de service existante fournit une liste des instances de service de ce type au sein de votre espace. + +Si la fonctionnalité est déjà associée à ce projet, le nom de l'instance de service associée est affiché sur la vignette après le type de +fonctionnalité, ce qui facilite l'identification de l'instance de service associée à votre projet sur votre console {{site.data.keyword.dev_console}}. Les +actions disponibles sur le bouton d'action sont les suivantes : **Afficher** et **Retirer** quand la fonctionnalité est déjà associée au projet. Le retrait d'une instance de service efface seulement l'association à ce projet et ne supprime pas l'instance de service de votre console {{site.data.keyword.dev_console}}. Pour supprimer une instance de service, cliquez sur la page accessible en sélectionnant les options relatives aux services Web et mobiles pour afficher et supprimer les instances de service voulues. + +Sélectionnez la commande relative à l'obtention du code sur la vignette **Code** pour télécharger le code pour votre projet. Pour plus d'informations sur le +téléchargement du code, voir [Obtention du code](get_code.html). + + +## Mise à jour de votre projet pour utiliser un nouveau module de démarrage +{: #update-starter} + +1. Depuis la page relative aux projets ou à la présentation du projet, cliquez sur l'icône du menu déroulant dynamique et sélectionnez le module de démarrage de la mise à jour. + +2. Choisissez un nouveau module de démarrage puis cliquez sur **Mettre à jour**. + +3. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. + + Vous pouvez également cliquer sur la page **Code**. + + +## Mise à jour de votre projet pour générer un nouveau langage +{: #update-language} + +1. Depuis la page relative au projet ou à la présentation du projet, cliquez sur l'icône du menu déroulant dynamique et sélectionnez le module de démarrage de la mise à jour. + +2. Sélectionnez un nouveau langage et cliquez sur **Mettre à jour**. + +3. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. diff --git a/cloudnative/nl/fr/sdk.md b/cloudnative/nl/fr/sdk.md index e388757d3..a848336c2 100644 --- a/cloudnative/nl/fr/sdk.md +++ b/cloudnative/nl/fr/sdk.md @@ -1,70 +1,70 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-17" - ---- -# Kits de développement de logiciels (SDK) -{: #sdk} - -Afin d'ajouter des logiciels SDK pour les services {{site.data.keyword.Bluemix}} Mobile à votre application, choisissez les logiciels SDK à utiliser et configurez votre gestionnaire de dépendances afin d'extraire les logiciels SDK dans votre application. - - -## Kits de développement de logiciels (SDK) client -{: #client_sdk} - -Vous pouvez utiliser les kits de développement de logiciels suivants dans -votre application mobile afin d'optimiser leurs fonctions respectives : - - -### Kits de développement de logiciels Android -{: #android_sdk} - -- [SDK Core ![Icône de lien externe](../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) -- [{{site.data.keyword.mobileanalytics_short}} SDK ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) -- [SDK d'authentification Facebook![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) -- [SDK d'authentification Google ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) - - -### Kits de développement de logiciels iOS -{: #ios_sdk} - -- [SDK Core ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) -- [{{site.data.keyword.mobileanalytics_short}} SDK ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) -- [SDK d'authentification Facebook![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) -- [SDK d'authentification Google ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) -- [{{site.data.keyword.amashort}} SDK ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) - - -### Plug-ins Cordova -{: #cordova_plugin} - -- [Module d'extension de base![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) -- [Module d'extension {{site.data.keyword.mobilepushshort}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## Kits de développement de logiciels de serveur -{: #server_sdk} - -Si vous disposez d'une application serveur Java, NodeJS ou Swift, vous -pouvez utiliser les kits de développement de logiciels suivants pour -communiquer avec les services respectifs. - - -### {{site.data.keyword.mobilepushshort}} Kits de développement de logiciels de serveur -{: #push_sdk} - -- [{{site.data.keyword.mobilepushshort}} SDK de serveur Java ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) -- [{{site.data.keyword.mobilepushshort}} SDK de serveur Swift ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) -- [{{site.data.keyword.mobilepushshort}} SDK de serveur NodeJS ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) - - -### SDK du serveur {{site.data.keyword.amashort}} -{: #mca_sdk} - -- [{{site.data.keyword.amashort}} SDK de serveur Swift ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) - - +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-17" + +--- +# Kits de développement de logiciels (SDK) +{: #sdk} + +Afin d'ajouter des logiciels SDK pour les services {{site.data.keyword.Bluemix}} Mobile à votre application, choisissez les logiciels SDK à utiliser et configurez votre gestionnaire de dépendances afin d'extraire les logiciels SDK dans votre application. + + +## Kits de développement de logiciels (SDK) client +{: #client_sdk} + +Vous pouvez utiliser les kits de développement de logiciels suivants dans +votre application mobile afin d'optimiser leurs fonctions respectives : + + +### Kits de développement de logiciels Android +{: #android_sdk} + +- [SDK Core ![Icône de lien externe](../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) +- [{{site.data.keyword.mobileanalytics_short}} SDK ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) +- [SDK d'authentification Facebook![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) +- [SDK d'authentification Google ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) + + +### Kits de développement de logiciels iOS +{: #ios_sdk} + +- [SDK Core ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) +- [{{site.data.keyword.mobileanalytics_short}} SDK ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) +- [SDK d'authentification Facebook![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) +- [SDK d'authentification Google ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) +- [{{site.data.keyword.amashort}} SDK ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) + + +### Plug-ins Cordova +{: #cordova_plugin} + +- [Module d'extension de base![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) +- [Module d'extension {{site.data.keyword.mobilepushshort}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## Kits de développement de logiciels de serveur +{: #server_sdk} + +Si vous disposez d'une application serveur Java, NodeJS ou Swift, vous +pouvez utiliser les kits de développement de logiciels suivants pour +communiquer avec les services respectifs. + + +### {{site.data.keyword.mobilepushshort}} Kits de développement de logiciels de serveur +{: #push_sdk} + +- [{{site.data.keyword.mobilepushshort}} SDK de serveur Java ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) +- [{{site.data.keyword.mobilepushshort}} SDK de serveur Swift ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) +- [{{site.data.keyword.mobilepushshort}} SDK de serveur NodeJS ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) + + +### SDK du serveur {{site.data.keyword.amashort}} +{: #mca_sdk} + +- [{{site.data.keyword.amashort}} SDK de serveur Swift ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) + + diff --git a/cloudnative/nl/fr/sdk_BMSClient.md b/cloudnative/nl/fr/sdk_BMSClient.md index 104a305f6..91e6b99e9 100644 --- a/cloudnative/nl/fr/sdk_BMSClient.md +++ b/cloudnative/nl/fr/sdk_BMSClient.md @@ -1,131 +1,131 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Initialisation de BMSClient -{: #sdk_BMSClient} - -`BMSCore` fournit l'infrastructure HTTP que les autres logiciels SDK client des services {{site.data.keyword.Bluemix}} Mobile utilisent pour communiquer avec leurs services {{site.data.keyword.Bluemix_notm}} correspondants. - - -## Initialisation de votre application Android -{: #init-BMSClient-android} - -Vous pouvez télécharger et importer le module `BMSCore` dans votre projet Android Studio ou utiliser Gradle. - -1. Importez le logiciel SDK du client en ajoutant l'instruction `import` suivante au début de votre fichier de projet : - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; - ``` - {: codeblock} - -2. Initialisez le SDK `BMSClient` dans votre application Android en ajoutant le code d'initialisation dans la méthode -`onCreate` de l'activité principale dans votre application Android ou à l'emplacement le plus approprié pour votre projet. - - ```Java - BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region - ``` - {: codeblock} - - Vous devez initialiser la classe `BMSClient` à l'aide du paramètre **bluemixRegion**. Dans -l'initialiseur, la valeur **bluemixRegion** spécifie le déploiement {{site.data.keyword.Bluemix_notm}} que vous utilisez, par -exemple `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` ou `BMSClient.REGION_SYDNEY`. - - -## Initialisation de votre application iOS -{: #init-BMSClient-ios} - -Vous pouvez utiliser [CocoaPods](https://cocoapods.org){: new_window} ou [Carthage](https://github.com/Carthage/Carthage){: new_window} pour obtenir le module `BMSCore`. - -1. Pour installer `BMSCore` en utilisant CocoaPods, ajoutez les lignes suivantes à votre Podfile. Si votre projet n'a pas encore de Podfile, utilisez la commande `pod init`. - - ```Swift - use_frameworks! - - target 'MyApp' do - pod 'BMSCore' - end - ``` - {: codeblock} - - Ensuite, exécutez la commande `pod install` et ouvrez le fichier `.xcworkspace` généré. Pour mettre à jour vers une version plus récente de `BMSCore`, utilisez `pod update BMSCore`. - - Pour plus d'informations sur l'utilisation de CocoaPods, voir les [guides CocoaPods![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://guides.cocoapods.org/using/index.html){: new_window}. - -2. Pour installer `BMSCore` en utilisant Carthage, suivez ces [instructions ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/Carthage/Carthage#getting-started){: new_window}. - - 1. Ajoutez la ligne suivante à votre Cartfile : - - ``` - github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" - ``` - {: codeblock} - - 2. Exécutez la commande `carthage update`. - - 3. Une fois la génération terminée, ajoutez `BMSCore.framework` à votre projet en suivant l'[étape 3 ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/Carthage/Carthage#getting-started) des instructions Carthage. - - Pour les applications construites avec Swift 2.3, utilisez la commande `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3`. Sinon, utilisez la commande `carthage update`. - -3. Importez le module. - - ```Swift - import BMSCore - ``` - {: codeblock} - -4. Initialisez la classe `BMSClient` à l'aide du code suivant : - - Placez le code d'initialisation dans la méthode `application(_:didFinishLaunchingWithOptions:)` de votre délégué d'application ou à l'emplacement le plus approprié pour votre projet. - - ```Swift - BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Prenez soin de pointer sur votre région - ``` - {: codeblock} - - Vous devez initialiser la classe `BMSClient` à l'aide du paramètre **bluemixRegion**. Dans -l'initialiseur, la valeur **bluemixRegion** spécifie le déploiement {{site.data.keyword.Bluemix_notm}} que vous utilisez, par -exemple `BMSClient.Region.usSouth`, `BMSClient.Region.unitedKingdom` ou `BMSClient.Region.sydney`. - - -## Initialisation de votre application Cordova -{: #init-BMSClient-cordova} - -1. Ajoutez le plug-in Cordova en exécutant la commande suivante depuis le répertoire racine de votre application Cordova : - - ``` - cordova plugin add bms-core - ``` - {: codeblock} - -2. Initialisez la classe `BMSClient` dans votre application Cordova en ajoutant le code d'initialisation -dans le fichier JavaScript principal ou à l'emplacement le plus approprié pour votre projet. - - ``` - BMSClient.initialize(BMSClient.REGION_US_SOUTH); - ``` - {: codeblock} - - Vous devez initialiser la classe `BMSClient` à l'aide du paramètre **bluemixRegion**. Dans -l'initialiseur, la valeur **bluemixRegion** spécifie le déploiement {{site.data.keyword.Bluemix_notm}} que vous utilisez, par -exemple `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` ou `BMSClient.REGION_SYDNEY`. - - -# Liens connexes -{: #rellinks notoc} - -## Liens connexes -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Initialisation de BMSClient +{: #sdk_BMSClient} + +`BMSCore` fournit l'infrastructure HTTP que les autres logiciels SDK client des services {{site.data.keyword.Bluemix}} Mobile utilisent pour communiquer avec leurs services {{site.data.keyword.Bluemix_notm}} correspondants. + + +## Initialisation de votre application Android +{: #init-BMSClient-android} + +Vous pouvez télécharger et importer le module `BMSCore` dans votre projet Android Studio ou utiliser Gradle. + +1. Importez le logiciel SDK du client en ajoutant l'instruction `import` suivante au début de votre fichier de projet : + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; + ``` + {: codeblock} + +2. Initialisez le SDK `BMSClient` dans votre application Android en ajoutant le code d'initialisation dans la méthode +`onCreate` de l'activité principale dans votre application Android ou à l'emplacement le plus approprié pour votre projet. + + ```Java + BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region + ``` + {: codeblock} + + Vous devez initialiser la classe `BMSClient` à l'aide du paramètre **bluemixRegion**. Dans +l'initialiseur, la valeur **bluemixRegion** spécifie le déploiement {{site.data.keyword.Bluemix_notm}} que vous utilisez, par +exemple `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` ou `BMSClient.REGION_SYDNEY`. + + +## Initialisation de votre application iOS +{: #init-BMSClient-ios} + +Vous pouvez utiliser [CocoaPods](https://cocoapods.org){: new_window} ou [Carthage](https://github.com/Carthage/Carthage){: new_window} pour obtenir le module `BMSCore`. + +1. Pour installer `BMSCore` en utilisant CocoaPods, ajoutez les lignes suivantes à votre Podfile. Si votre projet n'a pas encore de Podfile, utilisez la commande `pod init`. + + ```Swift + use_frameworks! + + target 'MyApp' do + pod 'BMSCore' + end + ``` + {: codeblock} + + Ensuite, exécutez la commande `pod install` et ouvrez le fichier `.xcworkspace` généré. Pour mettre à jour vers une version plus récente de `BMSCore`, utilisez `pod update BMSCore`. + + Pour plus d'informations sur l'utilisation de CocoaPods, voir les [guides CocoaPods![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://guides.cocoapods.org/using/index.html){: new_window}. + +2. Pour installer `BMSCore` en utilisant Carthage, suivez ces [instructions ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/Carthage/Carthage#getting-started){: new_window}. + + 1. Ajoutez la ligne suivante à votre Cartfile : + + ``` + github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" + ``` + {: codeblock} + + 2. Exécutez la commande `carthage update`. + + 3. Une fois la génération terminée, ajoutez `BMSCore.framework` à votre projet en suivant l'[étape 3 ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/Carthage/Carthage#getting-started) des instructions Carthage. + + Pour les applications construites avec Swift 2.3, utilisez la commande `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3`. Sinon, utilisez la commande `carthage update`. + +3. Importez le module. + + ```Swift + import BMSCore + ``` + {: codeblock} + +4. Initialisez la classe `BMSClient` à l'aide du code suivant : + + Placez le code d'initialisation dans la méthode `application(_:didFinishLaunchingWithOptions:)` de votre délégué d'application ou à l'emplacement le plus approprié pour votre projet. + + ```Swift + BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Prenez soin de pointer sur votre région + ``` + {: codeblock} + + Vous devez initialiser la classe `BMSClient` à l'aide du paramètre **bluemixRegion**. Dans +l'initialiseur, la valeur **bluemixRegion** spécifie le déploiement {{site.data.keyword.Bluemix_notm}} que vous utilisez, par +exemple `BMSClient.Region.usSouth`, `BMSClient.Region.unitedKingdom` ou `BMSClient.Region.sydney`. + + +## Initialisation de votre application Cordova +{: #init-BMSClient-cordova} + +1. Ajoutez le plug-in Cordova en exécutant la commande suivante depuis le répertoire racine de votre application Cordova : + + ``` + cordova plugin add bms-core + ``` + {: codeblock} + +2. Initialisez la classe `BMSClient` dans votre application Cordova en ajoutant le code d'initialisation +dans le fichier JavaScript principal ou à l'emplacement le plus approprié pour votre projet. + + ``` + BMSClient.initialize(BMSClient.REGION_US_SOUTH); + ``` + {: codeblock} + + Vous devez initialiser la classe `BMSClient` à l'aide du paramètre **bluemixRegion**. Dans +l'initialiseur, la valeur **bluemixRegion** spécifie le déploiement {{site.data.keyword.Bluemix_notm}} que vous utilisez, par +exemple `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` ou `BMSClient.REGION_SYDNEY`. + + +# Liens connexes +{: #rellinks notoc} + +## Liens connexes +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/fr/sdk_cli.md b/cloudnative/nl/fr/sdk_cli.md index 9525aa143..1ef5ded73 100644 --- a/cloudnative/nl/fr/sdk_cli.md +++ b/cloudnative/nl/fr/sdk_cli.md @@ -1,178 +1,178 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Plug-in de générateur SDK -{: #sdk-cli} - -Le plug-in de générateur SDK {{site.data.keyword.IBM}} peut être installé dans l'interface de ligne de commande [{{site.data.keyword.Bluemix_notm}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/cli/reference/bluemix_cli/index.html). - -En tant que développeur sous {{site.data.keyword.Bluemix_notm}}, vous pouvez utiliser ce plug-in pour générer des SDK depuis votre définition d'API REST conforme à la [spécification Open API ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.openapis.org/). Quand vous apportez des modifications à votre définition d'API REST, vous pouvez utiliser ce plug-in pour ne régénérer que le SDK au lieu de régénérer l'ensemble du projet. - -Vous pouvez aussi voir si vos applications Cloud Foundry d'espace donné disposent de définitions d'API REST valides pour la génération SDK. Enfin, vous pouvez utiliser le plug-in de générateur SDK {{site.data.keyword.IBM_notm}} pour valider toutes définitions d'API REST afin de vous assurer qu'elles sont conformes aux exigences du générateur SDK. - -Ce plug-in de générateur SDK {{site.data.keyword.IBM_notm}} vous permet d'intégrer facilement vos services de backend à votre application avec un SDK généré. Quand un changement se produit dans une API REST, vous pouvez générer à nouveau le SDK et remplacer l'ancien pour une mise à niveau transparente du SDK. Vous pouvez aussi intégrer l'interface de ligne de commande dans un pipeline DevOps et vous assurer que le SDK est toujours cohérent avec la spécification d'API chaque fois que l'application est générée. - -La définition d'API REST doit être valide et hébergée sur un noeud final de serveur opérationnel de votre système. Si la définition d'API REST est hébergée, l'URL relative doit être définie dans la variable d'environnement `OPENAPI_SPEC`. - - -## Configuration requise -{: #prereqs} - -Vérifiez que vous répondez bien aux exigences suivantes. - -* Vous disposez d'un compte [{{site.data.keyword.Bluemix_notm}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://bluemix.net) -* Vous disposez d'une définition d'API valide conforme à la spécification [Open API ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.openapis.org/) - - -## Installation -{: #installation} - -1. [Installez l'interface de ligne de commande {{site.data.keyword.Bluemix}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://clis.ng.bluemix.net/ui/home.html). - -2. [Installez le plug-in ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in). - - ``` - bx plugin install sdk-gen -r Bluemix - ``` - {: codeblock} - - -## Commandes -{: #commands} - -Utilisez les commandes ci-après pour générer un SDK, valider des fichiers de définition Open API ou répertorier les applications Cloud Foundry. - - -### Génération d'un SDK -{: #gen} - -Utilisez `bluemix sdk generate [arguments...][command options]`. - - -#### Arguments -{: #gen-args} - -* `NOM_APP` - nom de l'application Cloud Foundry dans votre espace actuel -* `EMPLACEMENT_DOC_OPENAPI` - URL ou chemin d'accès relatif au fichier de définition d'API REST brut JSON ou Yaml -* `NOM_SDK_GENERE` (facultatif) - nom du SDK généré - - -#### Options -{: #gen-options} - -* `PLATEFORME` (requis) - * `--android` - génère un SDK Android - * `--ios` - generate an iOS Swift SDK - * `--swift` - generate a Swift server SDK -* `--output "VOTRE_CHEMIN_RELATIF"` (facultatif) - place le SDK généré dans le répertoire qui est spécifié par `VOTRE_CHEMIN_RELATIF` (remplace le SDK existant, le cas échéant) -* `--unzip` (facultatif) - extrait le SDK généré (remplace les artefacts de SDK existants, le cas échéant) - - -#### Utilisation -{: #gen-usage} - -Pour générer un SDK depuis une application Cloud Foundry qui s'exécute dans {{site.data.keyword.Bluemix_notm}}, vous pouvez utiliser le nom de l'application en tant que paramètre dans l'interface de ligne de commande de l'application. La commande suivante utilise le nom de l'application comme `Nom_SDK`. - -``` -bluemix sdk generate [NOM_APP] [PLATEFORME] -``` -{: codeblock} - -Pour générer un SDK depuis une URL dans un fichier de définition Open API ou un fichier Yaml ou JSON local, utilisez la commande suivante. - -``` -bluemix sdk generate [EMPLACEMENT_DOC_OPENAPI] [Nom_SDK] [Plateforme] -``` -{: codeblock} - - -### Validation des définitions Open API -{: #validating} - -Utilisez `bluemix sdk validate [argument]`. - - -#### Arguments -{: #val-args} - -* `NOM_APP` - nom de l'application Cloud Foundry dans votre espace actuel -* `EMPLACEMENT_DOC_OPENAPI` - URL ou chemin d'accès relatif au fichier de définition d'API REST brut JSON ou Yaml - - -#### Utilisation -{: #val-usage} - -Pour valider une spécification d'API d'une application Cloud Foundry qui s'exécute dans {{site.data.keyword.Bluemix_notm}}, vous pouvez utiliser le nom de l'application en tant que paramètre dans l'interface de ligne de commande de l'application. - -``` -bluemix sdk validate [NOM_APP] -``` -{: codeblock} - -Pour valider un SDK depuis l'URL dans un document de spécification d'API ou un fichier Yaml ou JSON local, utilisez la commande suivante. - -``` -bluemix sdk validate [EMPLACEMENT_DOC_OPENAPI] -``` -{: codeblock} - - - -### Liste des applications (Cloud Foundry) -{: #list-apps} - -Utilisez `bluemix sdk list [argument][option]` pour répertorier les applications et valider les spécifications d'API. La variable d'environnement `OPENAPI_SPEC` doit être définie par rapport au chemin d'URL relatif qui héberge votre spécification. - - -#### Arguments -{: #list-args} - -* `NOM_ESPACE` (facultatif) - nom de l'espace Cloud Foundry au sein de votre organisation actuelle dans lequel vous voulez rechercher des applications. Si aucune valeur n'est fournie, l'espace actuel est exploré. - - -#### Options -{: #list-options} - -* `--url` (facultatif) - pour afficher une URL complète dans la définition Open API pour chaque application de la liste. - - -#### Utilisation -{: #list-usage} - -Pour répertorier les applications de l'espace actuel, utilisez la commande suivante. - -``` -bluemix sdk list -``` -{: codeblock} - -Pour répertorier les applications de l'espace actuel et afficher L'URL de spécification d'API, utilisez la commande suivante. - -``` -bluemix sdk list --url -``` -{: codeblock} - -Pour répertorier les applications d'un espace spécifique, utilisez la commande suivante. - -``` -bluemix sdk list [NOM_ESPACE] -``` -{: codeblock} - -Pour répertorier les applications d'un espace spécifique et afficher L'URL de spécification d'API, utilisez la commande suivante. - -``` -bluemix sdk list [NOM_ESPACE] --url -``` -{: codeblock} +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Plug-in de générateur SDK +{: #sdk-cli} + +Le plug-in de générateur SDK {{site.data.keyword.IBM}} peut être installé dans l'interface de ligne de commande [{{site.data.keyword.Bluemix_notm}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/cli/reference/bluemix_cli/index.html). + +En tant que développeur sous {{site.data.keyword.Bluemix_notm}}, vous pouvez utiliser ce plug-in pour générer des SDK depuis votre définition d'API REST conforme à la [spécification Open API ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.openapis.org/). Quand vous apportez des modifications à votre définition d'API REST, vous pouvez utiliser ce plug-in pour ne régénérer que le SDK au lieu de régénérer l'ensemble du projet. + +Vous pouvez aussi voir si vos applications Cloud Foundry d'espace donné disposent de définitions d'API REST valides pour la génération SDK. Enfin, vous pouvez utiliser le plug-in de générateur SDK {{site.data.keyword.IBM_notm}} pour valider toutes définitions d'API REST afin de vous assurer qu'elles sont conformes aux exigences du générateur SDK. + +Ce plug-in de générateur SDK {{site.data.keyword.IBM_notm}} vous permet d'intégrer facilement vos services de backend à votre application avec un SDK généré. Quand un changement se produit dans une API REST, vous pouvez générer à nouveau le SDK et remplacer l'ancien pour une mise à niveau transparente du SDK. Vous pouvez aussi intégrer l'interface de ligne de commande dans un pipeline DevOps et vous assurer que le SDK est toujours cohérent avec la spécification d'API chaque fois que l'application est générée. + +La définition d'API REST doit être valide et hébergée sur un noeud final de serveur opérationnel de votre système. Si la définition d'API REST est hébergée, l'URL relative doit être définie dans la variable d'environnement `OPENAPI_SPEC`. + + +## Configuration requise +{: #prereqs} + +Vérifiez que vous répondez bien aux exigences suivantes. + +* Vous disposez d'un compte [{{site.data.keyword.Bluemix_notm}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://bluemix.net) +* Vous disposez d'une définition d'API valide conforme à la spécification [Open API ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://www.openapis.org/) + + +## Installation +{: #installation} + +1. [Installez l'interface de ligne de commande {{site.data.keyword.Bluemix}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://clis.ng.bluemix.net/ui/home.html). + +2. [Installez le plug-in ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in). + + ``` + bx plugin install sdk-gen -r Bluemix + ``` + {: codeblock} + + +## Commandes +{: #commands} + +Utilisez les commandes ci-après pour générer un SDK, valider des fichiers de définition Open API ou répertorier les applications Cloud Foundry. + + +### Génération d'un SDK +{: #gen} + +Utilisez `bluemix sdk generate [arguments...][command options]`. + + +#### Arguments +{: #gen-args} + +* `NOM_APP` - nom de l'application Cloud Foundry dans votre espace actuel +* `EMPLACEMENT_DOC_OPENAPI` - URL ou chemin d'accès relatif au fichier de définition d'API REST brut JSON ou Yaml +* `NOM_SDK_GENERE` (facultatif) - nom du SDK généré + + +#### Options +{: #gen-options} + +* `PLATEFORME` (requis) + * `--android` - génère un SDK Android + * `--ios` - generate an iOS Swift SDK + * `--swift` - generate a Swift server SDK +* `--output "VOTRE_CHEMIN_RELATIF"` (facultatif) - place le SDK généré dans le répertoire qui est spécifié par `VOTRE_CHEMIN_RELATIF` (remplace le SDK existant, le cas échéant) +* `--unzip` (facultatif) - extrait le SDK généré (remplace les artefacts de SDK existants, le cas échéant) + + +#### Utilisation +{: #gen-usage} + +Pour générer un SDK depuis une application Cloud Foundry qui s'exécute dans {{site.data.keyword.Bluemix_notm}}, vous pouvez utiliser le nom de l'application en tant que paramètre dans l'interface de ligne de commande de l'application. La commande suivante utilise le nom de l'application comme `Nom_SDK`. + +``` +bluemix sdk generate [NOM_APP] [PLATEFORME] +``` +{: codeblock} + +Pour générer un SDK depuis une URL dans un fichier de définition Open API ou un fichier Yaml ou JSON local, utilisez la commande suivante. + +``` +bluemix sdk generate [EMPLACEMENT_DOC_OPENAPI] [Nom_SDK] [Plateforme] +``` +{: codeblock} + + +### Validation des définitions Open API +{: #validating} + +Utilisez `bluemix sdk validate [argument]`. + + +#### Arguments +{: #val-args} + +* `NOM_APP` - nom de l'application Cloud Foundry dans votre espace actuel +* `EMPLACEMENT_DOC_OPENAPI` - URL ou chemin d'accès relatif au fichier de définition d'API REST brut JSON ou Yaml + + +#### Utilisation +{: #val-usage} + +Pour valider une spécification d'API d'une application Cloud Foundry qui s'exécute dans {{site.data.keyword.Bluemix_notm}}, vous pouvez utiliser le nom de l'application en tant que paramètre dans l'interface de ligne de commande de l'application. + +``` +bluemix sdk validate [NOM_APP] +``` +{: codeblock} + +Pour valider un SDK depuis l'URL dans un document de spécification d'API ou un fichier Yaml ou JSON local, utilisez la commande suivante. + +``` +bluemix sdk validate [EMPLACEMENT_DOC_OPENAPI] +``` +{: codeblock} + + + +### Liste des applications (Cloud Foundry) +{: #list-apps} + +Utilisez `bluemix sdk list [argument][option]` pour répertorier les applications et valider les spécifications d'API. La variable d'environnement `OPENAPI_SPEC` doit être définie par rapport au chemin d'URL relatif qui héberge votre spécification. + + +#### Arguments +{: #list-args} + +* `NOM_ESPACE` (facultatif) - nom de l'espace Cloud Foundry au sein de votre organisation actuelle dans lequel vous voulez rechercher des applications. Si aucune valeur n'est fournie, l'espace actuel est exploré. + + +#### Options +{: #list-options} + +* `--url` (facultatif) - pour afficher une URL complète dans la définition Open API pour chaque application de la liste. + + +#### Utilisation +{: #list-usage} + +Pour répertorier les applications de l'espace actuel, utilisez la commande suivante. + +``` +bluemix sdk list +``` +{: codeblock} + +Pour répertorier les applications de l'espace actuel et afficher L'URL de spécification d'API, utilisez la commande suivante. + +``` +bluemix sdk list --url +``` +{: codeblock} + +Pour répertorier les applications d'un espace spécifique, utilisez la commande suivante. + +``` +bluemix sdk list [NOM_ESPACE] +``` +{: codeblock} + +Pour répertorier les applications d'un espace spécifique et afficher L'URL de spécification d'API, utilisez la commande suivante. + +``` +bluemix sdk list [NOM_ESPACE] --url +``` +{: codeblock} diff --git a/cloudnative/nl/fr/sdk_network_request.md b/cloudnative/nl/fr/sdk_network_request.md index ce2fa1a78..2f27cb6f2 100644 --- a/cloudnative/nl/fr/sdk_network_request.md +++ b/cloudnative/nl/fr/sdk_network_request.md @@ -1,128 +1,128 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Soumission d'une demande réseau -{: #sdk-network-request} - -Vous pouvez également utiliser le SDK `BMSCore` pour effectuer des demandes réseau à n'importe quelle ressource. - -## Android -{: #request-android} - -1. Vérifiez que vous avez bien [importé et initialisé le SDK client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android) dans votre application Android. - -2. Effectuez une demande réseau. - - ``` - public void makeGetCall() { - Thread thread = new Thread(new Runnable() { - @Override - public void run() { - try { - Request request = new Request("http://httpbin.org/get", "GET"); - request.send(null, null); - } catch (Exception e) { - // Handle failure here. - } - } - }); - thread.start(); - } - ``` - {: codeblock} - -## iOS -{: #request-ios} - -1. Vérifiez que vous avez bien [importé et initialisé le SDK client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios) dans votre -application iOS. - -2. Créez une demande réseau. - - ### Swift 3.0 - {: #ios-swift3 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - - ### Swift 2.2 - {: #ios-swift22 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - -La classe `Request` est un moyen simple d'effectuer une demande HTTP et d'obtenir une réponse une fois la demande effectuée. Si vous avez -besoin de plus de souplesse et de contrôle que ceux offerts par la classe `Request`, vous pouvez utiliser la classe `BMSURLSession`. Parmi -les fonctionnalités de la classe `BMSURLSession`, on dénote le suivi de la progression des téléchargements et la mise en pause ou l'annulation des -demandes. Pour obtenir les réponses, vous pouvez choisir des gestionnaires d'exécution ou des délégués. - -La classe `BMSURLSession` n'est disponible que pour iOS. Pour plus d'informations -sur `BMSURLSession`, reportez-vous au fichier [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) du -SDK `BMSCore`. - - -## Cordova -{: #request-cordova} - -1. Vérifiez que vous avez bien [importé et initialisé le SDK client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova) dans votre -application Cordova. - -2. Créez une demande réseau. - - ``` - var success = function(data) { - console.log("success", data); - } - var failure = function(error) - {console.log("failure", error); - } - var request = new BMSRequest("", BMSRequest.GET); - request.send(success, failure); - ``` - {: codeblock} - - -# Liens connexes -{: #rellinks notoc} - -## Liens connexes -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Soumission d'une demande réseau +{: #sdk-network-request} + +Vous pouvez également utiliser le SDK `BMSCore` pour effectuer des demandes réseau à n'importe quelle ressource. + +## Android +{: #request-android} + +1. Vérifiez que vous avez bien [importé et initialisé le SDK client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android) dans votre application Android. + +2. Effectuez une demande réseau. + + ``` + public void makeGetCall() { + Thread thread = new Thread(new Runnable() { + @Override + public void run() { + try { + Request request = new Request("http://httpbin.org/get", "GET"); + request.send(null, null); + } catch (Exception e) { + // Handle failure here. + } + } + }); + thread.start(); + } + ``` + {: codeblock} + +## iOS +{: #request-ios} + +1. Vérifiez que vous avez bien [importé et initialisé le SDK client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios) dans votre +application iOS. + +2. Créez une demande réseau. + + ### Swift 3.0 + {: #ios-swift3 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + + ### Swift 2.2 + {: #ios-swift22 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + +La classe `Request` est un moyen simple d'effectuer une demande HTTP et d'obtenir une réponse une fois la demande effectuée. Si vous avez +besoin de plus de souplesse et de contrôle que ceux offerts par la classe `Request`, vous pouvez utiliser la classe `BMSURLSession`. Parmi +les fonctionnalités de la classe `BMSURLSession`, on dénote le suivi de la progression des téléchargements et la mise en pause ou l'annulation des +demandes. Pour obtenir les réponses, vous pouvez choisir des gestionnaires d'exécution ou des délégués. + +La classe `BMSURLSession` n'est disponible que pour iOS. Pour plus d'informations +sur `BMSURLSession`, reportez-vous au fichier [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) du +SDK `BMSCore`. + + +## Cordova +{: #request-cordova} + +1. Vérifiez que vous avez bien [importé et initialisé le SDK client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova) dans votre +application Cordova. + +2. Créez une demande réseau. + + ``` + var success = function(data) { + console.log("success", data); + } + var failure = function(error) + {console.log("failure", error); + } + var request = new BMSRequest("", BMSRequest.GET); + request.send(success, failure); + ``` + {: codeblock} + + +# Liens connexes +{: #rellinks notoc} + +## Liens connexes +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/fr/services.md b/cloudnative/nl/fr/services.md index 4c5d25947..7a65e6981 100644 --- a/cloudnative/nl/fr/services.md +++ b/cloudnative/nl/fr/services.md @@ -1,54 +1,54 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# Services -{: #services} - -La page **Services** d'{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} vous permet de visualiser vos services Web et mobiles existants ou de créer de nouveaux services. La console fournit un emplacement unique qui permet d'afficher tous les services Web et mobiles {{site.data.keyword.Bluemix_notm}} gérés par les projets. - -Si vous supprimez des services de la vue **Services**, ces derniers sont déconnectés du projet qui leur est associé. Vous devez alors créer une nouvelle instance de service si vous voulez reconnecter le service au projet. - -## Présentation des services Web et mobiles {{site.data.keyword.Bluemix_notm}} -{: #mobile_services_overview} - -Le tableau suivant décrit les services Web et mobiles {{site.data.keyword.Bluemix_notm}}. Vous pouvez utiliser des services individuels depuis le catalogue {{site.data.keyword.Bluemix_notm}} ou les intégrer dans votre projet. - - - - - - - - - - - - - - - - - - - -
Tableau 1. Services Web et mobiles {{site.data.keyword.Bluemix_notm}}
Service Web et mobile {{site.data.keyword.Bluemix_notm}}Description
icône {{site.data.keyword.mobileanalytics_short}}
{{site.data.keyword.mobileanalytics_short}}		Le service {{site.data.keyword.mobileanalytics_full}} permet d'obtenir plus de détails sur les performances et l'utilisation de vos applications mobiles.

-Pour plus d'informations sur le fonctionnement de ce service, reportez-vous à la documentation {{site.data.keyword.mobileanalytics_short}}. -
icône du service {{site.data.keyword.mobilefoundation_short}}
{{site.data.keyword.mobilefoundation_short}}		Utilisez le service {{site.data.keyword.mobilefoundation_long}} pour accélérer la configuration d'un environnement {{site.data.keyword.mfp_full}} depuis lequel vous pouvez développer, tester et utiliser des applications mobiles d'entreprises.

-Pour plus d'informations sur le fonctionnement de ce service, reportez-vous à la documentation {{site.data.keyword.mobilefoundation_short}}.
icône du service {{site.data.keyword.mobilepushshort}}
{{site.data.keyword.mobilepushshort}}		Le service {{site.data.keyword.mobilepushfull}} fournit une plateforme unifiée pour envoyer et gérer des notifications push aux applications mobiles et de navigateur Web et ciblant plusieurs plateformes. -

-Le service {{site.data.keyword.mobilepushshort}} gère le mappage des utilisateurs de votre application à leurs périphériques, à la plateforme du périphérique, aux navigateurs Web et gère la distribution des notifications push à ceux-ci. Vous pouvez envoyer des diffusions, des monodiffusions (basées sur l'ID du périphérique et de l'utilisateur) et également sur des balises (ou des rubriques) sous forme de notifications push aux utilisateurs de votre application mobile et du navigateur Web. Vous pouvez également utiliser un SDK et des API REST pour développer davantage vos applications client. -

-Pour plus d'informations sur le fonctionnement de ce service, reportez-vous à la documentation {{site.data.keyword.mobilepushshort}}.
+--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# Services +{: #services} + +La page **Services** d'{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} vous permet de visualiser vos services Web et mobiles existants ou de créer de nouveaux services. La console fournit un emplacement unique qui permet d'afficher tous les services Web et mobiles {{site.data.keyword.Bluemix_notm}} gérés par les projets. + +Si vous supprimez des services de la vue **Services**, ces derniers sont déconnectés du projet qui leur est associé. Vous devez alors créer une nouvelle instance de service si vous voulez reconnecter le service au projet. + +## Présentation des services Web et mobiles {{site.data.keyword.Bluemix_notm}} +{: #mobile_services_overview} + +Le tableau suivant décrit les services Web et mobiles {{site.data.keyword.Bluemix_notm}}. Vous pouvez utiliser des services individuels depuis le catalogue {{site.data.keyword.Bluemix_notm}} ou les intégrer dans votre projet. + + + + + + + + + + + + + + + + + + + +
Tableau 1. Services Web et mobiles {{site.data.keyword.Bluemix_notm}}
Service Web et mobile {{site.data.keyword.Bluemix_notm}}Description
icône {{site.data.keyword.mobileanalytics_short}}
{{site.data.keyword.mobileanalytics_short}}		Le service {{site.data.keyword.mobileanalytics_full}} permet d'obtenir plus de détails sur les performances et l'utilisation de vos applications mobiles.

+Pour plus d'informations sur le fonctionnement de ce service, reportez-vous à la documentation {{site.data.keyword.mobileanalytics_short}}. +
icône du service {{site.data.keyword.mobilefoundation_short}}
{{site.data.keyword.mobilefoundation_short}}		Utilisez le service {{site.data.keyword.mobilefoundation_long}} pour accélérer la configuration d'un environnement {{site.data.keyword.mfp_full}} depuis lequel vous pouvez développer, tester et utiliser des applications mobiles d'entreprises.

+Pour plus d'informations sur le fonctionnement de ce service, reportez-vous à la documentation {{site.data.keyword.mobilefoundation_short}}.
icône du service {{site.data.keyword.mobilepushshort}}
{{site.data.keyword.mobilepushshort}}		Le service {{site.data.keyword.mobilepushfull}} fournit une plateforme unifiée pour envoyer et gérer des notifications push aux applications mobiles et de navigateur Web et ciblant plusieurs plateformes. +

+Le service {{site.data.keyword.mobilepushshort}} gère le mappage des utilisateurs de votre application à leurs périphériques, à la plateforme du périphérique, aux navigateurs Web et gère la distribution des notifications push à ceux-ci. Vous pouvez envoyer des diffusions, des monodiffusions (basées sur l'ID du périphérique et de l'utilisateur) et également sur des balises (ou des rubriques) sous forme de notifications push aux utilisateurs de votre application mobile et du navigateur Web. Vous pouvez également utiliser un SDK et des API REST pour développer davantage vos applications client. +

+Pour plus d'informations sur le fonctionnement de ce service, reportez-vous à la documentation {{site.data.keyword.mobilepushshort}}.
diff --git a/cloudnative/nl/fr/starters.md b/cloudnative/nl/fr/starters.md index 6c99fb84c..1a0cfd86e 100644 --- a/cloudnative/nl/fr/starters.md +++ b/cloudnative/nl/fr/starters.md @@ -1,30 +1,30 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Modules de démarrage -{: #starters} - -Avec la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, vous pouvez choisir parmi différents modules de démarrage pour chaque type de modèle. - -Les modules de démarrage sont optimisés pour constituer du code de démarrage prêt pour la production présentant une intégration {{site.data.keyword.Bluemix_notm}} clé avec un service à valeur élevée. Chaque module de démarrage se concentre sur un service et illustre -l'intégration des logiciels SDK de ce service dans le code. Dans certains cas, -les modules de démarrage proposent une expérience -utilisateur simple qui met en évidence l'intégration des données du service ou les -interactions avec l'utilisateur. Chaque module de démarrage est configuré pour être activé avec les services d'authentification ou de données et éventuellement d'autres fonctionnalités, si vous décidez de les configurer pour votre projet. - - -## Tutoriels -{: #tutorials notoc} - -Pour des instructions plus détaillées sur la façon de créer des applications avec des modules de démarrage, vous pouvez utiliser les [tutoriels](tutorials.html) de bout en bout. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Modules de démarrage +{: #starters} + +Avec la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, vous pouvez choisir parmi différents modules de démarrage pour chaque type de modèle. + +Les modules de démarrage sont optimisés pour constituer du code de démarrage prêt pour la production présentant une intégration {{site.data.keyword.Bluemix_notm}} clé avec un service à valeur élevée. Chaque module de démarrage se concentre sur un service et illustre +l'intégration des logiciels SDK de ce service dans le code. Dans certains cas, +les modules de démarrage proposent une expérience +utilisateur simple qui met en évidence l'intégration des données du service ou les +interactions avec l'utilisateur. Chaque module de démarrage est configuré pour être activé avec les services d'authentification ou de données et éventuellement d'autres fonctionnalités, si vous décidez de les configurer pour votre projet. + + +## Tutoriels +{: #tutorials notoc} + +Pour des instructions plus détaillées sur la façon de créer des applications avec des modules de démarrage, vous pouvez utiliser les [tutoriels](tutorials.html) de bout en bout. diff --git a/cloudnative/nl/fr/troubleshoot.md b/cloudnative/nl/fr/troubleshoot.md index aee0d8963..20687dc77 100644 --- a/cloudnative/nl/fr/troubleshoot.md +++ b/cloudnative/nl/fr/troubleshoot.md @@ -1,223 +1,223 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Traitement des incidents -{: #ts} - -Certains problèmes connus rencontrés avec le plug-in {{site.data.keyword.dev_cli_notm}} sont documentés, et des solutions sont proposées. -{:shortdesc} - - - -## Problèmes connus -{: #knownissues} - -Les sections suivantes décrivent les problèmes connus et la façon dont ils peuvent être résolus. - - -### Erreur de nom d'hôte pris lors de la création d'un projet avec un modèle non mobile -{: #hostname} - -L'erreur suivante peut s'afficher si vous utilisez le plug-in {{site.data.keyword.dev_cli_short}} pour créer un projet depuis les modèles Application Web, BFF ou Microservice : - -``` -The hostname is taken. -``` -{: codeblock} - - -#### Cause -{: #hostname-cause} - -Cette erreur est due à un jeton de connexion expiré. - - -#### Résolution -{: #hostname-resolution} - -Connectez-vous à nouveau. - -``` -bx login -``` -{: codeblock} - - -### Défaillances générales au niveau du plug-in {{site.data.keyword.dev_cli_short}} -{: #general} - -L'erreur suivante peut s'afficher si vous utilisez les commandes create, delete, list ou code de {{site.data.keyword.dev_cli_short}} : - -``` -Failed to project. -``` -{: codeblock} - - -#### Cause -{: #hostname-cause} - -Cette erreur est due à un jeton de connexion expiré. - - -#### Résolution -{: #hostname-resolution} - -Connectez-vous à nouveau. - -``` -bx login -``` -{: codeblock} - - -### Erreur du courtier de service lors de l'ajout d'une fonctionnalité {{site.data.keyword.objectstorageshort}} -{: #os} - -L'erreur suivante peut s'afficher si vous utilisez le plug-in {{site.data.keyword.dev_cli_short}} pour créer deux projets avec la fonctionnalité {{site.data.keyword.objectstorageshort}} : - -``` -FAILED -Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} -``` -{: codeblock} - - -#### Cause -{: #os-cause} - -Cette erreur est due au fait que le service {{site.data.keyword.objectstorageshort}} n'autorise qu'une instance du plan {{site.data.keyword.objectstorageshort}} gratuit. - - -#### Résolution -{: #os-resolution} - -Choisissez un autre plan pour éviter cette erreur. - - -### Echec lors de l'obtention du code lors de la création d'un projet -{: #code} - -L'erreur suivante peut s'afficher si vous utilisez le plug-in {{site.data.keyword.dev_cli_short}} pour créer un projet : - -``` -FAILED -Project created, but could not get code -https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code -``` -{: codeblock} - - -#### Cause -{: #code-cause} - -Cette erreur est due à un dépassement de délai interne. - - -#### Résolution -{: #code-resolution} - -Vous pouvez obtenir le code de l'une des façons suivantes : - -* Exécutez la commande ci-après en utilisant l'interface de ligne de commande : - - ``` - bx dev code - ``` - {: codeblock} - - `` doit être remplacé par le nom du projet que vous avez utilisé durant la création du projet. - -* Utilisez la console {{site.data.keyword.dev_console}}. - - 1. Sélectionnez votre [projet ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://console.{DomainName}/developer/projects) dans la console {{site.data.keyword.dev_console}} et cliquez sur la commande relative à l'obtention du code. - - 2. Cliquez sur la commande de génération de code. - - 3. Une fois le code généré, cliquez sur la commande de téléchargement du code. - - -### Erreur lors de l'exécution de `bx dev run` pour les projets Node.js -{: #node} - -L'erreur suivante peut s'afficher si vous exécutez `bx dev run` avec des projets Web or BFF du plug-in {{site.data.keyword.dev_cli_short}} for Node.js : - -``` -module.js:597 - return process.dlopen(module, path._makeLong(filename)); - ^ - -Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header - at Error (native) - at Object.Module._extensions..node (module.js:597:18) - at Module.load (module.js:487:32) - at tryModuleLoad (module.js:446:12) - - at Function.Module._load (module.js:438:3) - at Module.require (module.js:497:17) - at require (internal/module.js:20:19) - at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) - at Module._compile (module.js:570:32) - at Object.Module._extensions..js (module.js:579:10) -``` -{: codeblock} - - -#### Cause -{: #node-cause} - -Cette erreur est due au fait que le module `appmetrics` est installé dans une architecture différente. Les modules npm natifs installés sur une architecture ne fonctionneront pas sur une autre architecture. Les images Docker incluses sont basées sur le noyau Linux. - - -#### Résolution -{: #node-resolution} - -Supprimez le dossier `node_modules` et exécutez à nouveau `bx dev run`. - - - - - - - -## Aide et support -{: #gettinghelp} - -Si vous avez des problèmes ou des questions quand vous utilisez la console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ou le plug-in {{site.data.keyword.dev_cli_notm}}, vous pouvez obtenir de l'aide en recherchant des informations précises ou en posant des questions via un forum. Vous pouvez aussi ouvrir un ticket de demande de service. - -Quand vous utilisez les forums pour poser une question, prenez soin d'étiqueter cette dernière de façon à ce qu'elle soit vue par les équipes de développement {{site.data.keyword.Bluemix_notm}}. - - - -Si vous avez des questions techniques sur le développement ou le déploiement d'une application avec la console {{site.data.keyword.dev_console}} ou le plug-in {{site.data.keyword.dev_cli_notm}} : - -* Postez votre question sur [stackoverflow![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) et marquez votre question avec les étiquettes `bluemix-dev-services` et `ibm-bluemix`. -* Postez votre question sur [Slack ![Icône de lien externe](../icons/launch-glyph.svg "External link icon")](http://ibm-cloud-tech.slack.com/) sur le canal `bluemix-dev-services`. [Inscrivez-vous ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://ibm.biz/IBMCloudNativeSlack) maintenant. - - - - - -Pour plus d'informations sur l'utilisation des forums, voir la rubrique décrivant [Comment obtenir de l'aide ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/support/index.html#getting-help). - -Pour plus d'informations sur l'ouverture d'un ticket de demande de service {{site.data.keyword.IBM}}, sur les niveaux de support disponibles ou les niveaux de gravité des tickets, voir la rubrique décrivant [comment contacter le support![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/support/index.html#contacting-support). - - - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Traitement des incidents +{: #ts} + +Certains problèmes connus rencontrés avec le plug-in {{site.data.keyword.dev_cli_notm}} sont documentés, et des solutions sont proposées. +{:shortdesc} + + + +## Problèmes connus +{: #knownissues} + +Les sections suivantes décrivent les problèmes connus et la façon dont ils peuvent être résolus. + + +### Erreur de nom d'hôte pris lors de la création d'un projet avec un modèle non mobile +{: #hostname} + +L'erreur suivante peut s'afficher si vous utilisez le plug-in {{site.data.keyword.dev_cli_short}} pour créer un projet depuis les modèles Application Web, BFF ou Microservice : + +``` +The hostname is taken. +``` +{: codeblock} + + +#### Cause +{: #hostname-cause} + +Cette erreur est due à un jeton de connexion expiré. + + +#### Résolution +{: #hostname-resolution} + +Connectez-vous à nouveau. + +``` +bx login +``` +{: codeblock} + + +### Défaillances générales au niveau du plug-in {{site.data.keyword.dev_cli_short}} +{: #general} + +L'erreur suivante peut s'afficher si vous utilisez les commandes create, delete, list ou code de {{site.data.keyword.dev_cli_short}} : + +``` +Failed to project. +``` +{: codeblock} + + +#### Cause +{: #hostname-cause} + +Cette erreur est due à un jeton de connexion expiré. + + +#### Résolution +{: #hostname-resolution} + +Connectez-vous à nouveau. + +``` +bx login +``` +{: codeblock} + + +### Erreur du courtier de service lors de l'ajout d'une fonctionnalité {{site.data.keyword.objectstorageshort}} +{: #os} + +L'erreur suivante peut s'afficher si vous utilisez le plug-in {{site.data.keyword.dev_cli_short}} pour créer deux projets avec la fonctionnalité {{site.data.keyword.objectstorageshort}} : + +``` +FAILED +Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} +``` +{: codeblock} + + +#### Cause +{: #os-cause} + +Cette erreur est due au fait que le service {{site.data.keyword.objectstorageshort}} n'autorise qu'une instance du plan {{site.data.keyword.objectstorageshort}} gratuit. + + +#### Résolution +{: #os-resolution} + +Choisissez un autre plan pour éviter cette erreur. + + +### Echec lors de l'obtention du code lors de la création d'un projet +{: #code} + +L'erreur suivante peut s'afficher si vous utilisez le plug-in {{site.data.keyword.dev_cli_short}} pour créer un projet : + +``` +FAILED +Project created, but could not get code +https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code +``` +{: codeblock} + + +#### Cause +{: #code-cause} + +Cette erreur est due à un dépassement de délai interne. + + +#### Résolution +{: #code-resolution} + +Vous pouvez obtenir le code de l'une des façons suivantes : + +* Exécutez la commande ci-après en utilisant l'interface de ligne de commande : + + ``` + bx dev code + ``` + {: codeblock} + + `` doit être remplacé par le nom du projet que vous avez utilisé durant la création du projet. + +* Utilisez la console {{site.data.keyword.dev_console}}. + + 1. Sélectionnez votre [projet ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](https://console.{DomainName}/developer/projects) dans la console {{site.data.keyword.dev_console}} et cliquez sur la commande relative à l'obtention du code. + + 2. Cliquez sur la commande de génération de code. + + 3. Une fois le code généré, cliquez sur la commande de téléchargement du code. + + +### Erreur lors de l'exécution de `bx dev run` pour les projets Node.js +{: #node} + +L'erreur suivante peut s'afficher si vous exécutez `bx dev run` avec des projets Web or BFF du plug-in {{site.data.keyword.dev_cli_short}} for Node.js : + +``` +module.js:597 + return process.dlopen(module, path._makeLong(filename)); + ^ + +Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header + at Error (native) + at Object.Module._extensions..node (module.js:597:18) + at Module.load (module.js:487:32) + at tryModuleLoad (module.js:446:12) + + at Function.Module._load (module.js:438:3) + at Module.require (module.js:497:17) + at require (internal/module.js:20:19) + at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) + at Module._compile (module.js:570:32) + at Object.Module._extensions..js (module.js:579:10) +``` +{: codeblock} + + +#### Cause +{: #node-cause} + +Cette erreur est due au fait que le module `appmetrics` est installé dans une architecture différente. Les modules npm natifs installés sur une architecture ne fonctionneront pas sur une autre architecture. Les images Docker incluses sont basées sur le noyau Linux. + + +#### Résolution +{: #node-resolution} + +Supprimez le dossier `node_modules` et exécutez à nouveau `bx dev run`. + + + + + + + +## Aide et support +{: #gettinghelp} + +Si vous avez des problèmes ou des questions quand vous utilisez la console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ou le plug-in {{site.data.keyword.dev_cli_notm}}, vous pouvez obtenir de l'aide en recherchant des informations précises ou en posant des questions via un forum. Vous pouvez aussi ouvrir un ticket de demande de service. + +Quand vous utilisez les forums pour poser une question, prenez soin d'étiqueter cette dernière de façon à ce qu'elle soit vue par les équipes de développement {{site.data.keyword.Bluemix_notm}}. + + + +Si vous avez des questions techniques sur le développement ou le déploiement d'une application avec la console {{site.data.keyword.dev_console}} ou le plug-in {{site.data.keyword.dev_cli_notm}} : + +* Postez votre question sur [stackoverflow![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) et marquez votre question avec les étiquettes `bluemix-dev-services` et `ibm-bluemix`. +* Postez votre question sur [Slack ![Icône de lien externe](../icons/launch-glyph.svg "External link icon")](http://ibm-cloud-tech.slack.com/) sur le canal `bluemix-dev-services`. [Inscrivez-vous ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](http://ibm.biz/IBMCloudNativeSlack) maintenant. + + + + + +Pour plus d'informations sur l'utilisation des forums, voir la rubrique décrivant [Comment obtenir de l'aide ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/support/index.html#getting-help). + +Pour plus d'informations sur l'ouverture d'un ticket de demande de service {{site.data.keyword.IBM}}, sur les niveaux de support disponibles ou les niveaux de gravité des tickets, voir la rubrique décrivant [comment contacter le support![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/support/index.html#contacting-support). + + + diff --git a/cloudnative/nl/fr/tutorial_bff.md b/cloudnative/nl/fr/tutorial_bff.md index ff41d9fd8..951ed7a4d 100644 --- a/cloudnative/nl/fr/tutorial_bff.md +++ b/cloudnative/nl/fr/tutorial_bff.md @@ -1,148 +1,148 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Tutoriel de bout en bout du module de démarrage BFF Basic -{: #tutorial} - -Le tutoriel de bout en bout suivant couvre les étapes de création d'un projet depuis le module de démarrage BFF Basic, y compris les outils que vous devez avoir installés et, par la suite, les étapes pour exécuter le code du projet. - -## Installation des outils de développement -{: #dev_tools} - -Vérifiez que vous avez installé les [outils prérequis pour le développeur![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](get_code.html#prereq-dev-tools){: new_window}. - - -## Création d'un projet en utilisant la console {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Créez un projet dans la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Dans la page de mise en route de la console {{site.data.keyword.dev_console}}, cliquez sur la commande de création de projet. - - Vous pouvez également cliquer sur la commande de création de projet dans la page des projets. - - 2. Sélectionnez l'option relative à BFF (Backend for Frontend puis cliquez sur **Suivant**. - - 3. Sélectionnez l'option relative à Basic Backend puis cliquez sur **Suivant**. - - 4. Entrez le nom de votre projet. Pour ce tutoriel, utilisez `BFFProject`. - - 5. Entrez un nom d'hôte. Pour ce tutoriel, utilisez `devhost` - - 6. Sélectionnez votre plateforme de langage. Pour ce tutoriel, utilisez `Node`. - - 7. Cliquez sur **Créer**. - -2. Facultatif : ajoutez la fonctionnalité Données. - - 1. Cliquez sur **Afficher** pour **Données** sur la page **Présentation du projet**. - - Vous pouvez aussi sélectionner les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives aux données. - - 2. Entrez le nom de votre service et cliquez sur -**Créer**. - - -3. Générez votre code de projet. - - 1. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. - - Vous pouvez également cliquer sur la page **Code**. - - 2. Cliquez sur la commande de génération de code. - - 3. Lorsque la génération du code du projet est terminée, cliquez sur **Télécharger le code** pour télécharger l'archive du projet. - -4. Facultatif : [mettez à jour votre projet](project_overview_page.html#update_language) pour générer un nouveau langage. - - -## Création d'un projet en utilisant le plug-in {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assurez-vous que vous avez bien installé le plug-in [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. Dans votre invite de terminal, accédez au répertoire local de votre choix et exécutez la commande suivante. - - ``` - bx dev create - ``` - {: codeblock} - -3. Fournissez les valeurs suivantes, quand vous y êtes invité : - - * Sélectionnez un modèle : 3 (pour Backend for Frontend) - * Sélectionnez un module de démarrage : 1 (pour Basic Backend) - * Sélectionnez un langage : 1 (pour Node) - * Entrez le nom de votre projet : `BFFProjectCLI` - * Entrez un nom d'hôte pour votre projet : `myhost` - -4. Si vous voulez ajouter des services à votre projet, répondez par l'affirmative à la question qui vous est posée puis répondez aux questions suivantes. - -5. Une fois votre projet `BFFProjectCLI` correctement sauvegardé, accédez au dossier `BFFProjectCLI`. - -6. A ce stade, vous pouvez ajouter votre propre code et générer ou exécuter le projet. - - 1. Générez votre projet avec la commande suivante : - - ``` - bx dev build - ``` - {: codeblock} - - 2. Exécutez votre projet avec la commande suivante : - - ``` - bx dev run - ``` - {: codeblock} - - -## Exécution d'un projet BFF -{: #running-bff} - -### Localement -{: #bff-local} - -1. Compilez votre serveur : - - ``` - swift build - ``` - {: codeblock} - -2. Lancez votre application. En supposant que votre application s'appelle `MyServer`, exécutez la commande suivante : - - ``` - .build/debug/MyServer - ``` - {: codeblock} - -3. Vous pouvez exécuter la commande curl sur votre serveur, via `curl http://localhost:8080` - - -### Utilisation du plug-in Bluemix -{: #using-blumix} - -1. Lancez la compilation - - ``` - bx dev run - ``` - {: codeblock} - -2. Vous pouvez exécuter la commande curl sur votre serveur, via : - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Tutoriel de bout en bout du module de démarrage BFF Basic +{: #tutorial} + +Le tutoriel de bout en bout suivant couvre les étapes de création d'un projet depuis le module de démarrage BFF Basic, y compris les outils que vous devez avoir installés et, par la suite, les étapes pour exécuter le code du projet. + +## Installation des outils de développement +{: #dev_tools} + +Vérifiez que vous avez installé les [outils prérequis pour le développeur![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](get_code.html#prereq-dev-tools){: new_window}. + + +## Création d'un projet en utilisant la console {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Créez un projet dans la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Dans la page de mise en route de la console {{site.data.keyword.dev_console}}, cliquez sur la commande de création de projet. + + Vous pouvez également cliquer sur la commande de création de projet dans la page des projets. + + 2. Sélectionnez l'option relative à BFF (Backend for Frontend puis cliquez sur **Suivant**. + + 3. Sélectionnez l'option relative à Basic Backend puis cliquez sur **Suivant**. + + 4. Entrez le nom de votre projet. Pour ce tutoriel, utilisez `BFFProject`. + + 5. Entrez un nom d'hôte. Pour ce tutoriel, utilisez `devhost` + + 6. Sélectionnez votre plateforme de langage. Pour ce tutoriel, utilisez `Node`. + + 7. Cliquez sur **Créer**. + +2. Facultatif : ajoutez la fonctionnalité Données. + + 1. Cliquez sur **Afficher** pour **Données** sur la page **Présentation du projet**. + + Vous pouvez aussi sélectionner les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives aux données. + + 2. Entrez le nom de votre service et cliquez sur +**Créer**. + + +3. Générez votre code de projet. + + 1. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. + + Vous pouvez également cliquer sur la page **Code**. + + 2. Cliquez sur la commande de génération de code. + + 3. Lorsque la génération du code du projet est terminée, cliquez sur **Télécharger le code** pour télécharger l'archive du projet. + +4. Facultatif : [mettez à jour votre projet](project_overview_page.html#update_language) pour générer un nouveau langage. + + +## Création d'un projet en utilisant le plug-in {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assurez-vous que vous avez bien installé le plug-in [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. Dans votre invite de terminal, accédez au répertoire local de votre choix et exécutez la commande suivante. + + ``` + bx dev create + ``` + {: codeblock} + +3. Fournissez les valeurs suivantes, quand vous y êtes invité : + + * Sélectionnez un modèle : 3 (pour Backend for Frontend) + * Sélectionnez un module de démarrage : 1 (pour Basic Backend) + * Sélectionnez un langage : 1 (pour Node) + * Entrez le nom de votre projet : `BFFProjectCLI` + * Entrez un nom d'hôte pour votre projet : `myhost` + +4. Si vous voulez ajouter des services à votre projet, répondez par l'affirmative à la question qui vous est posée puis répondez aux questions suivantes. + +5. Une fois votre projet `BFFProjectCLI` correctement sauvegardé, accédez au dossier `BFFProjectCLI`. + +6. A ce stade, vous pouvez ajouter votre propre code et générer ou exécuter le projet. + + 1. Générez votre projet avec la commande suivante : + + ``` + bx dev build + ``` + {: codeblock} + + 2. Exécutez votre projet avec la commande suivante : + + ``` + bx dev run + ``` + {: codeblock} + + +## Exécution d'un projet BFF +{: #running-bff} + +### Localement +{: #bff-local} + +1. Compilez votre serveur : + + ``` + swift build + ``` + {: codeblock} + +2. Lancez votre application. En supposant que votre application s'appelle `MyServer`, exécutez la commande suivante : + + ``` + .build/debug/MyServer + ``` + {: codeblock} + +3. Vous pouvez exécuter la commande curl sur votre serveur, via `curl http://localhost:8080` + + +### Utilisation du plug-in Bluemix +{: #using-blumix} + +1. Lancez la compilation + + ``` + bx dev run + ``` + {: codeblock} + +2. Vous pouvez exécuter la commande curl sur votre serveur, via : + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/fr/tutorial_microservice.md b/cloudnative/nl/fr/tutorial_microservice.md index f19d5565f..735eb8ca3 100644 --- a/cloudnative/nl/fr/tutorial_microservice.md +++ b/cloudnative/nl/fr/tutorial_microservice.md @@ -1,114 +1,114 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Tutoriel de bout en bout du module de démarrage Microservice Basic -{: #tutorial} - -Le tutoriel de bout en bout suivant couvre les étapes de création d'un projet depuis le module de démarrage Microservice Basic, y compris les outils que vous devez avoir installés et, par la suite, les étapes pour exécuter le code du projet. - -## Installation des outils de développement -{: #dev_tools} - -Vérifiez que vous avez installé les [outils prérequis pour le développeur![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](get_code.html#prereq-dev-tools){: new_window}. - - -## Création d'un projet en utilisant la console {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Créez un projet dans la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Dans la page de mise en route de la console {{site.data.keyword.dev_console}}, cliquez sur la commande de création de projet. - - Vous pouvez également cliquer sur la commande de création de projet dans la page des projets. - - 2. Sélectionnez l'option relative au microservice puis cliquez sur **Suivant**. - - 3. Sélectionnez l'option relative à **Basic** puis cliquez sur **Suivant**. - - 4. Entrez le nom de votre projet. Pour ce tutoriel, utilisez `MicroserviceProject`. - - 5. Entrez un nom d'hôte. Pour ce tutoriel, utilisez `devhost` - - 6. Cliquez sur **Créer**. - -2. Facultatif : ajoutez la fonctionnalité Données. - - 1. Cliquez sur **Afficher** pour **Données** sur la page **Présentation du projet**. - - Vous pouvez aussi sélectionner les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives aux données. - - 2. Entrez le nom de votre service et cliquez sur -**Créer**. - -3. Générez votre code de projet. - - 1. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. - - Vous pouvez également cliquer sur la page **Code**. - - 2. Cliquez sur la commande de génération de code. - - 3. Lorsque la génération du code du projet est terminée, cliquez sur **Télécharger le code** pour télécharger l'archive du projet. - -4. Facultatif : [mettez à jour votre projet](project_overview_page.html#update_language) pour générer un nouveau langage. - - -## Création d'un projet en utilisant le plug-in {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assurez-vous que vous avez bien installé le plug-in [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. Dans votre invite de terminal, accédez au répertoire local de votre choix et exécutez la commande suivante. - - ``` - bx dev create - ``` - {: codeblock} - -3. Fournissez les valeurs suivantes, quand vous y êtes invité : - - * Sélectionnez un modèle : 4 (pour Microservices) - * Sélectionnez un module de démarrage : 1 (pour Basic) - * Sélectionnez une plateforme : 3 (pour Java) - * Entrez le nom de votre projet : `MicroserviceProjectCLI` - -4. Si vous voulez ajouter des services à votre projet, répondez par l'affirmative à la question qui vous est posée puis répondez aux questions suivantes. - -5. Une fois votre projet `MicroserviceProjectCLI` correctement sauvegardé, accédez au dossier `MicroserviceProjectCLI`. - -6. A ce stade, vous pouvez ajouter votre propre code et générer ou exécuter le projet. - - -## Exécution du projet en utilisant le plug-in {{site.data.keyword.dev_cli_notm}} -{: #running-dev-plugin} - -1. Pour générer le projet dans votre répertoire de projet actuel, entrez la commande suivante : - - ``` - bx dev build - ``` - {: codeblock} - -2. Pour générer et exécuter le projet dans votre répertoire de projet actuel, entrez la commande suivante : - - ``` - bx dev run - ``` - {: codeblock} - -3. Vous pouvez accéder à l'application en utilisant curl sur votre serveur : - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Tutoriel de bout en bout du module de démarrage Microservice Basic +{: #tutorial} + +Le tutoriel de bout en bout suivant couvre les étapes de création d'un projet depuis le module de démarrage Microservice Basic, y compris les outils que vous devez avoir installés et, par la suite, les étapes pour exécuter le code du projet. + +## Installation des outils de développement +{: #dev_tools} + +Vérifiez que vous avez installé les [outils prérequis pour le développeur![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](get_code.html#prereq-dev-tools){: new_window}. + + +## Création d'un projet en utilisant la console {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Créez un projet dans la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Dans la page de mise en route de la console {{site.data.keyword.dev_console}}, cliquez sur la commande de création de projet. + + Vous pouvez également cliquer sur la commande de création de projet dans la page des projets. + + 2. Sélectionnez l'option relative au microservice puis cliquez sur **Suivant**. + + 3. Sélectionnez l'option relative à **Basic** puis cliquez sur **Suivant**. + + 4. Entrez le nom de votre projet. Pour ce tutoriel, utilisez `MicroserviceProject`. + + 5. Entrez un nom d'hôte. Pour ce tutoriel, utilisez `devhost` + + 6. Cliquez sur **Créer**. + +2. Facultatif : ajoutez la fonctionnalité Données. + + 1. Cliquez sur **Afficher** pour **Données** sur la page **Présentation du projet**. + + Vous pouvez aussi sélectionner les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives aux données. + + 2. Entrez le nom de votre service et cliquez sur +**Créer**. + +3. Générez votre code de projet. + + 1. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. + + Vous pouvez également cliquer sur la page **Code**. + + 2. Cliquez sur la commande de génération de code. + + 3. Lorsque la génération du code du projet est terminée, cliquez sur **Télécharger le code** pour télécharger l'archive du projet. + +4. Facultatif : [mettez à jour votre projet](project_overview_page.html#update_language) pour générer un nouveau langage. + + +## Création d'un projet en utilisant le plug-in {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assurez-vous que vous avez bien installé le plug-in [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. Dans votre invite de terminal, accédez au répertoire local de votre choix et exécutez la commande suivante. + + ``` + bx dev create + ``` + {: codeblock} + +3. Fournissez les valeurs suivantes, quand vous y êtes invité : + + * Sélectionnez un modèle : 4 (pour Microservices) + * Sélectionnez un module de démarrage : 1 (pour Basic) + * Sélectionnez une plateforme : 3 (pour Java) + * Entrez le nom de votre projet : `MicroserviceProjectCLI` + +4. Si vous voulez ajouter des services à votre projet, répondez par l'affirmative à la question qui vous est posée puis répondez aux questions suivantes. + +5. Une fois votre projet `MicroserviceProjectCLI` correctement sauvegardé, accédez au dossier `MicroserviceProjectCLI`. + +6. A ce stade, vous pouvez ajouter votre propre code et générer ou exécuter le projet. + + +## Exécution du projet en utilisant le plug-in {{site.data.keyword.dev_cli_notm}} +{: #running-dev-plugin} + +1. Pour générer le projet dans votre répertoire de projet actuel, entrez la commande suivante : + + ``` + bx dev build + ``` + {: codeblock} + +2. Pour générer et exécuter le projet dans votre répertoire de projet actuel, entrez la commande suivante : + + ``` + bx dev run + ``` + {: codeblock} + +3. Vous pouvez accéder à l'application en utilisant curl sur votre serveur : + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/fr/tutorial_mobile.md b/cloudnative/nl/fr/tutorial_mobile.md index 6d55aa834..341908b4a 100644 --- a/cloudnative/nl/fr/tutorial_mobile.md +++ b/cloudnative/nl/fr/tutorial_mobile.md @@ -1,192 +1,192 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Tutoriel de bout en bout du module de démarrage Mobile Basic -{: #tutorial} - -Le tutoriel de bout en bout suivant couvre les étapes de création d'un projet depuis le module de démarrage Mobile Basic, y compris les outils que vous devez avoir installés et, par la suite, les étapes pour exécuter le projet sous Xcode et Android Studio. - - -## Installation des outils de développement -{: #dev_tools} - -Vérifiez que vous avez installé les [outils prérequis pour le développeur![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](get_code.html#prereq-dev-tools){: new_window}. - - -## Création d'un projet en utilisant la console {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Créez un projet {{site.data.keyword.dev_console}} dans {{site.data.keyword.Bluemix}}. - - 1. Dans la page de mise en route de la console {{site.data.keyword.dev_console}}, cliquez sur la commande de création de projet. - - Vous pouvez également cliquer sur la commande de création de projet dans la page des projets. - - 2. Sélectionnez l'option relative à l'application mobile puis cliquez sur **Suivant**. - - 3. Sélectionnez l'option relative à **Basic** puis cliquez sur **Suivant**. - - 4. Entrez le nom de votre projet. Pour ce tutoriel, utilisez `MobileBasicProject`. - - 5. Sélectionnez votre plateforme. Pour ce tutoriel, utilisez `Swift`. - - 6. Cliquez sur **Créer**. - -2. Facultatif : ajoutez la fonction Authentification. - - 1. Cliquez sur **Ajouter** pour **Authentification** dans la page **Présentation du projet**. - - Vous pouvez aussi sélectionner les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives à l'authentification. - - 2. Entrez le nom de votre service et cliquez sur -**Créer**. - - 3. Activez **Authentification**. - - 4. Sélectionnez votre fournisseur d'identité et saisissez les informations requises pour le configurer. Vous pouvez activer un seul fournisseur d'identité. - - 5. Voir la rubrique relative à la [configuration des fournisseurs d'identité} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/appid/identity-providers.html){: new_window} pour plus d'informations sur la configuration de l'authentification. - -3. Facultatif : ajoutez la fonction Analyse. - - 1. Cliquez sur **Ajouter** pour **Analyse** dans la page **Présentation du projet**. - - Vous pouvez aussi sélectionner les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives à l'analyse. - - 2. Entrez le nom de votre service et cliquez sur -**Créer**. - - 3. Désactivez le **Mode démonstration** pour afficher vos données analytiques après avoir exécuté votre application. - - 4. Voir [Initiation à {{site.data.keyword.mobileanalytics_short}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/mobileanalytics/index.html){: new_window} pour plus d'informations sur la configuration du service Analytics. - -4. Facultatif : Ajoutez la fonctionnalité {{site.data.keyword.mobilepushshort}}. - - 1. Cliquez sur **Ajouter** pour **{{site.data.keyword.mobilepushshort}}** sur la page -**Présentation du projet**. - - Vous pouvez aussi cliquer sur les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives à {{site.data.keyword.mobilepushshort}}. - - 2. Entrez le nom de votre service et cliquez sur -**Créer**. - - 3. Pour iOS, [configurez Apple Push Notification Service ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}. - - 4. Pour Android, [configurez Firebase Cloud Messaging ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}. - -5. Facultatif : ajoutez la fonctionnalité Données. - - 1. Cliquez sur **Afficher** pour **Données** sur la page **Présentation du projet**. - - Vous pouvez également sélectionner **Créer** sur la page **Données**. - - 2. Choisissez **{{site.data.keyword.cloudant_short_notm}}** ou **{{site.data.keyword.objectstorageshort}}**. - - 3. Entrez le nom de votre service et cliquez sur -**Créer**. - - 4. Voir [Initiation à {{site.data.keyword.cloudant_short_notm}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/Cloudant/index.html){: new_window} pour plus d'informations sur la configuration de {{site.data.keyword.cloudant_short_notm}}. - - 5. Voir [Initiation à {{site.data.keyword.objectstorageshort}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/ObjectStorage/index.html){: new_window} pour plus d'informations sur la configuration d'{{site.data.keyword.objectstorageshort}}. - -6. Générez votre code de projet. - - 1. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. - - Vous pouvez également cliquer sur la page **Code**. - - 2. Cliquez sur la commande relative à la génération Swift. - - 3. Quand la génération du code du projet est terminée, cliquez sur la commande de téléchargement Swift pour télécharger l'archive du projet. - -7. Facultatif : [mettez à jour votre projet](project_overview_page.html#update_language) pour générer un nouveau langage. - - -## Création d'un projet en utilisant le plug-in {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assurez-vous que vous avez bien installé le plug-in [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. Dans votre invite de terminal, accédez au répertoire local de votre choix et exécutez la commande suivante. - - ``` - bx dev create - ``` - {: codeblock} - -3. Fournissez les valeurs suivantes, quand vous y êtes invité : - - * Sélectionnez un modèle : 2 (pour Mobile) - * Sélectionnez un module de démarrage : 1 (pour Basic) - * Sélectionnez une plateforme : 3 (pour iOS Swift) - * Entrez le nom de votre projet : `MobileBasicProjectCLI` - -4. Si vous voulez ajouter des services à votre projet, répondez par l'affirmative à la question qui vous est posée puis répondez aux questions suivantes. - -5. Une fois votre projet `MobileBasicProjectCLI` correctement sauvegardé, accédez au dossier `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift`. - - -## Exécution de votre projet Swift dans Xcode -{: #run_swift} - -1. Extrayez le fichier `MobileBasicProject-Swift.zip`. - -2. Ouvrez le fichier `README.md` dans un lecteur Markdown pour examiner les étapes de configuration de votre projet. - - 1. Ouvrez votre Terminal et accédez à votre dossier de projet. - - 1. Exécutez `pod setup` si vous devez configurer votre référentiel CocoaPods. - - 2. Exécutez `pod update` si vous devez mettre à jour les nacelles existantes. - - 3. Exécutez `pod install` pour installer les nacelles requises pour votre projet. - - 3. Ouvrez votre espace de travail Xcode `BasicProject.xcworkspace`. - -3. Exécutez votre application. - - -## Exécution de votre projet Cordova dans Xcode -{: #run_cordova_xcode} - -1. Extrayez le fichier `MobileBasicProject-Cordova.zip`. - -2. Ouvrez le fichier `README.md` dans un lecteur Markdown pour configurer votre projet. - - 1. Ouvrez votre projet `platforms/ios` dans Xcode. - -3. Exécutez votre application. - - -## Exécution de votre projet Cordova dans Android Studio -{: #run_cordova_studio} - -1. Décompressez le fichier `BasicProject-Cordova.zip`. - -2. Ouvrez le fichier `README.md` dans un lecteur Markdown pour configurer votre projet. - - 1. Ouvrez votre projet `platforms/android` dans Android Studio. - -3. Exécutez votre application. - - -## Exécution de votre projet Android dans Android Studio -{: #run_android} - -1. Extrayez le fichier `MobileBasicProject-Android.zip`. - -2. Ouvrez le fichier `README.md` dans un lecteur Markdown pour configurer votre projet. - - 1. Ouvrez votre projet `BasicProject-Android` dans Android Studio. - -3. Exécutez votre application. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Tutoriel de bout en bout du module de démarrage Mobile Basic +{: #tutorial} + +Le tutoriel de bout en bout suivant couvre les étapes de création d'un projet depuis le module de démarrage Mobile Basic, y compris les outils que vous devez avoir installés et, par la suite, les étapes pour exécuter le projet sous Xcode et Android Studio. + + +## Installation des outils de développement +{: #dev_tools} + +Vérifiez que vous avez installé les [outils prérequis pour le développeur![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](get_code.html#prereq-dev-tools){: new_window}. + + +## Création d'un projet en utilisant la console {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Créez un projet {{site.data.keyword.dev_console}} dans {{site.data.keyword.Bluemix}}. + + 1. Dans la page de mise en route de la console {{site.data.keyword.dev_console}}, cliquez sur la commande de création de projet. + + Vous pouvez également cliquer sur la commande de création de projet dans la page des projets. + + 2. Sélectionnez l'option relative à l'application mobile puis cliquez sur **Suivant**. + + 3. Sélectionnez l'option relative à **Basic** puis cliquez sur **Suivant**. + + 4. Entrez le nom de votre projet. Pour ce tutoriel, utilisez `MobileBasicProject`. + + 5. Sélectionnez votre plateforme. Pour ce tutoriel, utilisez `Swift`. + + 6. Cliquez sur **Créer**. + +2. Facultatif : ajoutez la fonction Authentification. + + 1. Cliquez sur **Ajouter** pour **Authentification** dans la page **Présentation du projet**. + + Vous pouvez aussi sélectionner les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives à l'authentification. + + 2. Entrez le nom de votre service et cliquez sur +**Créer**. + + 3. Activez **Authentification**. + + 4. Sélectionnez votre fournisseur d'identité et saisissez les informations requises pour le configurer. Vous pouvez activer un seul fournisseur d'identité. + + 5. Voir la rubrique relative à la [configuration des fournisseurs d'identité} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/appid/identity-providers.html){: new_window} pour plus d'informations sur la configuration de l'authentification. + +3. Facultatif : ajoutez la fonction Analyse. + + 1. Cliquez sur **Ajouter** pour **Analyse** dans la page **Présentation du projet**. + + Vous pouvez aussi sélectionner les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives à l'analyse. + + 2. Entrez le nom de votre service et cliquez sur +**Créer**. + + 3. Désactivez le **Mode démonstration** pour afficher vos données analytiques après avoir exécuté votre application. + + 4. Voir [Initiation à {{site.data.keyword.mobileanalytics_short}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/mobileanalytics/index.html){: new_window} pour plus d'informations sur la configuration du service Analytics. + +4. Facultatif : Ajoutez la fonctionnalité {{site.data.keyword.mobilepushshort}}. + + 1. Cliquez sur **Ajouter** pour **{{site.data.keyword.mobilepushshort}}** sur la page +**Présentation du projet**. + + Vous pouvez aussi cliquer sur les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives à {{site.data.keyword.mobilepushshort}}. + + 2. Entrez le nom de votre service et cliquez sur +**Créer**. + + 3. Pour iOS, [configurez Apple Push Notification Service ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}. + + 4. Pour Android, [configurez Firebase Cloud Messaging ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}. + +5. Facultatif : ajoutez la fonctionnalité Données. + + 1. Cliquez sur **Afficher** pour **Données** sur la page **Présentation du projet**. + + Vous pouvez également sélectionner **Créer** sur la page **Données**. + + 2. Choisissez **{{site.data.keyword.cloudant_short_notm}}** ou **{{site.data.keyword.objectstorageshort}}**. + + 3. Entrez le nom de votre service et cliquez sur +**Créer**. + + 4. Voir [Initiation à {{site.data.keyword.cloudant_short_notm}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/Cloudant/index.html){: new_window} pour plus d'informations sur la configuration de {{site.data.keyword.cloudant_short_notm}}. + + 5. Voir [Initiation à {{site.data.keyword.objectstorageshort}} ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/ObjectStorage/index.html){: new_window} pour plus d'informations sur la configuration d'{{site.data.keyword.objectstorageshort}}. + +6. Générez votre code de projet. + + 1. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. + + Vous pouvez également cliquer sur la page **Code**. + + 2. Cliquez sur la commande relative à la génération Swift. + + 3. Quand la génération du code du projet est terminée, cliquez sur la commande de téléchargement Swift pour télécharger l'archive du projet. + +7. Facultatif : [mettez à jour votre projet](project_overview_page.html#update_language) pour générer un nouveau langage. + + +## Création d'un projet en utilisant le plug-in {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assurez-vous que vous avez bien installé le plug-in [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. Dans votre invite de terminal, accédez au répertoire local de votre choix et exécutez la commande suivante. + + ``` + bx dev create + ``` + {: codeblock} + +3. Fournissez les valeurs suivantes, quand vous y êtes invité : + + * Sélectionnez un modèle : 2 (pour Mobile) + * Sélectionnez un module de démarrage : 1 (pour Basic) + * Sélectionnez une plateforme : 3 (pour iOS Swift) + * Entrez le nom de votre projet : `MobileBasicProjectCLI` + +4. Si vous voulez ajouter des services à votre projet, répondez par l'affirmative à la question qui vous est posée puis répondez aux questions suivantes. + +5. Une fois votre projet `MobileBasicProjectCLI` correctement sauvegardé, accédez au dossier `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift`. + + +## Exécution de votre projet Swift dans Xcode +{: #run_swift} + +1. Extrayez le fichier `MobileBasicProject-Swift.zip`. + +2. Ouvrez le fichier `README.md` dans un lecteur Markdown pour examiner les étapes de configuration de votre projet. + + 1. Ouvrez votre Terminal et accédez à votre dossier de projet. + + 1. Exécutez `pod setup` si vous devez configurer votre référentiel CocoaPods. + + 2. Exécutez `pod update` si vous devez mettre à jour les nacelles existantes. + + 3. Exécutez `pod install` pour installer les nacelles requises pour votre projet. + + 3. Ouvrez votre espace de travail Xcode `BasicProject.xcworkspace`. + +3. Exécutez votre application. + + +## Exécution de votre projet Cordova dans Xcode +{: #run_cordova_xcode} + +1. Extrayez le fichier `MobileBasicProject-Cordova.zip`. + +2. Ouvrez le fichier `README.md` dans un lecteur Markdown pour configurer votre projet. + + 1. Ouvrez votre projet `platforms/ios` dans Xcode. + +3. Exécutez votre application. + + +## Exécution de votre projet Cordova dans Android Studio +{: #run_cordova_studio} + +1. Décompressez le fichier `BasicProject-Cordova.zip`. + +2. Ouvrez le fichier `README.md` dans un lecteur Markdown pour configurer votre projet. + + 1. Ouvrez votre projet `platforms/android` dans Android Studio. + +3. Exécutez votre application. + + +## Exécution de votre projet Android dans Android Studio +{: #run_android} + +1. Extrayez le fichier `MobileBasicProject-Android.zip`. + +2. Ouvrez le fichier `README.md` dans un lecteur Markdown pour configurer votre projet. + + 1. Ouvrez votre projet `BasicProject-Android` dans Android Studio. + +3. Exécutez votre application. diff --git a/cloudnative/nl/fr/tutorial_web.md b/cloudnative/nl/fr/tutorial_web.md index 50843c5c1..7349fdde0 100644 --- a/cloudnative/nl/fr/tutorial_web.md +++ b/cloudnative/nl/fr/tutorial_web.md @@ -1,194 +1,194 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Tutoriel de bout en bout du module de démarrage Web Basic -{: #tutorial} - -Le tutoriel de bout en bout suivant couvre les étapes de création d'un projet depuis le module de démarrage Web Basic, y compris les outils que vous devez avoir installés et, par la suite, les étapes pour exécuter le code du projet. - -## Installation des outils de développement -{: #dev_tools} - -Vérifiez que vous avez installé les [outils prérequis pour le développeur![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](get_code.html#prereq-dev-tools){: new_window}. - - -## Création d'un projet en utilisant la console {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Créez un projet dans la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Dans la page de mise en route de la console {{site.data.keyword.dev_console}}, cliquez sur la commande de création de projet. - - Vous pouvez également cliquer sur la commande de création de projet dans la page des projets. - - 2. Sélectionnez l'option relative à l'application Web puis cliquez sur **Suivant**. - - 3. Sélectionnez l'option relative à **Basic Web** puis cliquez sur **Suivant**. - - 4. Entrez le nom de votre projet. Pour ce tutoriel, utilisez `WebBasicProject`. - - 5. Entrez un nom d'hôte. Pour ce tutoriel, utilisez `devhost` - - 6. Sélectionnez votre plateforme de langage. Pour ce tutoriel, utilisez `Swift`. - - 7. Cliquez sur **Créer**. - -2. Facultatif : ajoutez la fonctionnalité Données. - - 1. Cliquez sur **Afficher** pour **Données** sur la page **Présentation du projet**. - - Vous pouvez aussi sélectionner les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives aux données. - - 2. Entrez le nom de votre service et cliquez sur -**Créer**. - - -3. Générez votre code de projet. - - 1. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. - - Vous pouvez également cliquer sur la page **Code**. - - 2. Cliquez sur la commande de génération de code. - - 3. Lorsque la génération du code du projet est terminée, cliquez sur **Télécharger le code** pour télécharger l'archive du projet. - -4. Facultatif : [mettez à jour votre projet](project_overview_page.html#update_language) pour générer un nouveau langage. - - -## Création d'un projet en utilisant le plug-in {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assurez-vous que vous avez bien installé le plug-in [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. Dans votre invite de terminal, accédez au répertoire local de votre choix et exécutez la commande suivante. - - ``` - bx dev create - ``` - {: codeblock} - - -3. Fournissez les valeurs suivantes, quand vous y êtes invité : - - * Sélectionnez un modèle : 1 (pour Web) - * Sélectionnez un module de démarrage : 1 (pour Basic Web) - * Sélectionnez un langage : 2 (pour Swift) - * Entrez le nom de votre projet : `WebBasicProjectCLI` - * Entrez un nom d'hôte pour votre projet : `myhost` - -4. Si vous voulez ajouter des services à votre projet, répondez par l'affirmative à la question qui vous est posée puis répondez aux questions suivantes. - -5. Une fois votre projet `WebBasicProjectCLI` correctement sauvegardé, accédez au dossier `WebBasicProjectCLI`. - -6. Ajoutez votre propre code, générez le projet ou exécutez-le. - - 1. Générez le projet avec la commande suivante : - - ``` - bx dev build - ``` - {: codeblock} - - 2. Exécutez le projet avec la commande suivante : - - ``` - bx dev run - ``` - {: codeblock} - - -## Exécution d'un projet Web -{: #run} - -### Localement -{: #local notoc} - -1. Installez vos dépendances de noeud : - - ``` - npm install - ``` - {: codeblock} - -2. Incluez votre code frontend dans un module : - - ``` - node_modules/.bin/gulp - ``` - {: codeblock} - -3. Compilez votre serveur : - - ``` - swift build - ``` - {: codeblock} - -4. Exécutez votre application : - - ``` - .build/debug/WebBasicProjectCLI - ``` - {: codeblock} - -5. Accédez, dans votre navigateur, à l'URL `http://localhost:8080`. - - -### Utilisation du plug-in {{site.data.keyword.dev_cli_short}} -{: #dev notoc} - -1. Installez les dépendances de noeud : - - ``` - npm install - ``` - {: codeblock} - -2. Incluez votre code frontend dans un module : - - ``` - gulp - ``` - {: codeblock} - -3. Lancez la compilation : - - ``` - bx dev run - ``` - {: codeblock} - -4. Accédez, dans votre navigateur, à l'URL `http://localhost:8080`. - - -## Exécution de votre projet dans Xcode -{: #Xcode} - -1. Créez un projet Xcode. - - Avant de pouvoir développer dans Xcode, vous devez utiliser le gestionnaire de package Swift pour générer un projet Xcode. - - ``` - swift project generate-xcodeproj - ``` - {: codeblock} - -2. Rendez exécutable votre cible active : - - Ouvrez votre projet sous Xcode et assurez-vous que votre cible active est exécutable. Vous pouvez maintenir enfoncée la touche d'option tout en cliquant sur le menu déroulant pour sélectionner l'exécutable actif voulu. - -3. Appuyez sur **run**. - -4. Accédez, dans votre navigateur, à l'URL `http://localhost:8080`. - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Tutoriel de bout en bout du module de démarrage Web Basic +{: #tutorial} + +Le tutoriel de bout en bout suivant couvre les étapes de création d'un projet depuis le module de démarrage Web Basic, y compris les outils que vous devez avoir installés et, par la suite, les étapes pour exécuter le code du projet. + +## Installation des outils de développement +{: #dev_tools} + +Vérifiez que vous avez installé les [outils prérequis pour le développeur![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](get_code.html#prereq-dev-tools){: new_window}. + + +## Création d'un projet en utilisant la console {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Créez un projet dans la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Dans la page de mise en route de la console {{site.data.keyword.dev_console}}, cliquez sur la commande de création de projet. + + Vous pouvez également cliquer sur la commande de création de projet dans la page des projets. + + 2. Sélectionnez l'option relative à l'application Web puis cliquez sur **Suivant**. + + 3. Sélectionnez l'option relative à **Basic Web** puis cliquez sur **Suivant**. + + 4. Entrez le nom de votre projet. Pour ce tutoriel, utilisez `WebBasicProject`. + + 5. Entrez un nom d'hôte. Pour ce tutoriel, utilisez `devhost` + + 6. Sélectionnez votre plateforme de langage. Pour ce tutoriel, utilisez `Swift`. + + 7. Cliquez sur **Créer**. + +2. Facultatif : ajoutez la fonctionnalité Données. + + 1. Cliquez sur **Afficher** pour **Données** sur la page **Présentation du projet**. + + Vous pouvez aussi sélectionner les commandes de création ou d'ajout d'une fonctionnalité existante sur la page des fonctionnalités relatives aux données. + + 2. Entrez le nom de votre service et cliquez sur +**Créer**. + + +3. Générez votre code de projet. + + 1. Cliquez sur la commande relative à l'obtention du code sur la page de présentation du projet pour sélectionner votre langue. + + Vous pouvez également cliquer sur la page **Code**. + + 2. Cliquez sur la commande de génération de code. + + 3. Lorsque la génération du code du projet est terminée, cliquez sur **Télécharger le code** pour télécharger l'archive du projet. + +4. Facultatif : [mettez à jour votre projet](project_overview_page.html#update_language) pour générer un nouveau langage. + + +## Création d'un projet en utilisant le plug-in {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assurez-vous que vous avez bien installé le plug-in [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. Dans votre invite de terminal, accédez au répertoire local de votre choix et exécutez la commande suivante. + + ``` + bx dev create + ``` + {: codeblock} + + +3. Fournissez les valeurs suivantes, quand vous y êtes invité : + + * Sélectionnez un modèle : 1 (pour Web) + * Sélectionnez un module de démarrage : 1 (pour Basic Web) + * Sélectionnez un langage : 2 (pour Swift) + * Entrez le nom de votre projet : `WebBasicProjectCLI` + * Entrez un nom d'hôte pour votre projet : `myhost` + +4. Si vous voulez ajouter des services à votre projet, répondez par l'affirmative à la question qui vous est posée puis répondez aux questions suivantes. + +5. Une fois votre projet `WebBasicProjectCLI` correctement sauvegardé, accédez au dossier `WebBasicProjectCLI`. + +6. Ajoutez votre propre code, générez le projet ou exécutez-le. + + 1. Générez le projet avec la commande suivante : + + ``` + bx dev build + ``` + {: codeblock} + + 2. Exécutez le projet avec la commande suivante : + + ``` + bx dev run + ``` + {: codeblock} + + +## Exécution d'un projet Web +{: #run} + +### Localement +{: #local notoc} + +1. Installez vos dépendances de noeud : + + ``` + npm install + ``` + {: codeblock} + +2. Incluez votre code frontend dans un module : + + ``` + node_modules/.bin/gulp + ``` + {: codeblock} + +3. Compilez votre serveur : + + ``` + swift build + ``` + {: codeblock} + +4. Exécutez votre application : + + ``` + .build/debug/WebBasicProjectCLI + ``` + {: codeblock} + +5. Accédez, dans votre navigateur, à l'URL `http://localhost:8080`. + + +### Utilisation du plug-in {{site.data.keyword.dev_cli_short}} +{: #dev notoc} + +1. Installez les dépendances de noeud : + + ``` + npm install + ``` + {: codeblock} + +2. Incluez votre code frontend dans un module : + + ``` + gulp + ``` + {: codeblock} + +3. Lancez la compilation : + + ``` + bx dev run + ``` + {: codeblock} + +4. Accédez, dans votre navigateur, à l'URL `http://localhost:8080`. + + +## Exécution de votre projet dans Xcode +{: #Xcode} + +1. Créez un projet Xcode. + + Avant de pouvoir développer dans Xcode, vous devez utiliser le gestionnaire de package Swift pour générer un projet Xcode. + + ``` + swift project generate-xcodeproj + ``` + {: codeblock} + +2. Rendez exécutable votre cible active : + + Ouvrez votre projet sous Xcode et assurez-vous que votre cible active est exécutable. Vous pouvez maintenir enfoncée la touche d'option tout en cliquant sur le menu déroulant pour sélectionner l'exécutable actif voulu. + +3. Appuyez sur **run**. + +4. Accédez, dans votre navigateur, à l'URL `http://localhost:8080`. + diff --git a/cloudnative/nl/fr/tutorials.md b/cloudnative/nl/fr/tutorials.md index 2156368bb..ce3d079b8 100644 --- a/cloudnative/nl/fr/tutorials.md +++ b/cloudnative/nl/fr/tutorials.md @@ -1,49 +1,49 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Tutoriels de bout en bout -{: #tutorial} - -Les tutoriels de bout en bout ci-après couvrent les étapes de création d'un projet depuis la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, y compris les outils que vous devez avoir installés et, par la suite, les étapes pour exécuter votre code de projet. - -## Web -{: #web notoc} - -* [Tutoriel Web Basic](tutorial_web.html) - - -## Mobile -{: #mobile notoc} - -* [Tutoriel Mobile Basic](tutorial_mobile.html) - - - - -## BFF -{: #bff notoc} - -* [Tutoriel BFF Basic](tutorial_bff.html) - - -## Microservice -{: #microservice notoc} - -* [Tutoriel Microservice Basic](tutorial_microservice.html) +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Tutoriels de bout en bout +{: #tutorial} + +Les tutoriels de bout en bout ci-après couvrent les étapes de création d'un projet depuis la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, y compris les outils que vous devez avoir installés et, par la suite, les étapes pour exécuter votre code de projet. + +## Web +{: #web notoc} + +* [Tutoriel Web Basic](tutorial_web.html) + + +## Mobile +{: #mobile notoc} + +* [Tutoriel Mobile Basic](tutorial_mobile.html) + + + + +## BFF +{: #bff notoc} + +* [Tutoriel BFF Basic](tutorial_bff.html) + + +## Microservice +{: #microservice notoc} + +* [Tutoriel Microservice Basic](tutorial_microservice.html) diff --git a/cloudnative/nl/fr/what_is_new.md b/cloudnative/nl/fr/what_is_new.md index 7a8f3d7ac..42025d9dc 100644 --- a/cloudnative/nl/fr/what_is_new.md +++ b/cloudnative/nl/fr/what_is_new.md @@ -1,110 +1,110 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Nouveautés de la console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} -{: #what-is-new} - - -## Mise à jour de mars 2017 -{: #mar-2017} - -La mise à jour de mars 2017 de la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} comprend les modifications suivantes : - - * Le tableau de bord {{site.data.keyword.Bluemix_notm}} Mobile est devenu la console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}. - * La procédure de création de projets a été modifiée pour inclure les types de modèle de serveur Application Web, BFF et Microservice avec prise en charge de Node.js, Java et Swift. - * L'intégration au nouveau service optimisé {{site.data.keyword.appid_full}} fournit une authentification pour les projets Web et mobiles. - * Vous pouvez maintenant générer des SDK pour vos projets en utilisant le [plug-in de générateur SDK](sdk_cli.html). La génération de SDK dans la console {{site.data.keyword.dev_console}} n'est disponible que pour les projets mobiles. - * Il vous est désormais possible de créer des projets en utilisant le plug-in [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - - -## Mise à jour de janvier 2017 -{: #jan-2017} - -La mise à jour de janvier 2017 du tableau de bord {{site.data.keyword.Bluemix_notm}} Mobile comprend les modifications suivantes : - - * Au 31 janvier, les modules de démarrage pour l'interface utilisateur deviennent obsolètes. Les projets existants qui ont été crées depuis un module de démarrage pour l'interface utilisateur peuvent être utilisés jusqu'au 30 avril 2017. Pour plus d'informations sur les étapes de migration et les dates de retrait, voir l'[article de blogue de l'annonce de dépréciation![Icône de lien externe](../icons/launch-glyph.svg "External link icon")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/). -{: deprecated} - * Vous pouvez maintenant mettre à jour votre type de module de démarrage de projet au lieu de supprimer votre projet et d'en créer un nouveau. - * Vous pouvez désormais créer votre projet avec un module de démarrage pour le code [Watson Conversation](tutorial_conversation.html). - * Là où il est pris en charge, vous pouvez maintenant générer un SDK pour votre projet. - * Vous pouvez désormais ajouter vos instances de calcul et générer des SDK client à ajouter à votre projet. - - -## Mise à jour de décembre 2016 -{: #dec-2016} - -La mise à jour de novembre 2016 du tableau de bord {{site.data.keyword.Bluemix_notm}} Mobile comprend les modifications suivantes : - - * Vous pouvez maintenant retirer d'un projet un service connecté de façon à pouvoir le supprimer ou le réutiliser avec un autre projet. - * Vous pouvez désormais ajouter un service existant à un projet. - * Vous pouvez maintenant créer ou connecter un service CloudantNoSQL existant en tant que source de données quand vous utilisez un module de démarrage pour le code. - * Là où il est pris en charge, vous pouvez désormais créer ou connecter un service Object Storage existant comme source de données pour votre projet. - * Vous pouvez maintenant personnaliser la conception de la navigation de l'application que vous créez avec un module de démarrage pour l'interface utilisateur. - - -## Mise à jour de novembre 2016 -{: #nov-2016} - -La mise à jour de novembre 2016 du tableau de bord {{site.data.keyword.Bluemix_notm}} Mobile comprend les modifications suivantes : - - * Vous pouvez à présent générer des artefacts SDK pour vos projets depuis la page **Code**. - * Cordova est à présent pris en charge pour le module de démarrage Basic. - * Vous pouvez dorénavant [créer un rapport des événements réseau ![Icône de lien externe](../icons/launch-glyph.svg "External link icon")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} et [suivre les demandes réseau ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} sur la page relative aux demandes réseau de la console {{site.data.keyword.mobileanalytics_short}}. - * Vous pouvez désormais [exporter des données dans dashDB ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} dans la console {{site.data.keyword.mobileanalytics_short}}. - - -## Mise à jour de novembre 2016 -{: #oct-2016} - -La mise à jour d'octobre 2016 du tableau de bord {{site.data.keyword.Bluemix_notm}} Mobile comprend les modifications suivantes : - - * Vous pouvez désormais ajouter directement des fonctionnalités {{site.data.keyword.mobilepushshort}} et Analytics à votre projet -depuis le tableau de bord. - * Des [modules de démarrage pour le code](starters.html#Code_Starter) sont maintenant disponibles. - * Vous pouvez ajouter l'authentification aux projets que vous avez créés à partir d'un module de démarrage de code. - * Swift est désormais pris en charge. - - -### L'analyse -{: #analytics notoc} - - * Le mode démonstration est activé par défaut lorsque vous ajoutez la -fonction Analyse. Vous pouvez désactiver le mode démonstration pour visualiser -l'analyse après l'exécution de votre application. - - -### Générateur d'interface graphique -{: #ui_builder notoc} - - * La fonctionnalité **{{site.data.keyword.mobilepushshort}}** est désormais accessible depuis le projet. - * L'onglet **Paramètres du projet** a été renommé -en **Paramètres**. - * L'onglet **Authentification** a été renommé en **Accès utilisateur**. - - -### Code -{: #code notoc} - - * Le code Objective-C et Swift généré pour iOS utilise désormais -CocoaPods pour la gestion des dépendances. Cela signifie que vous devez -installer CocoaPods. Pour ce faire, exécutez `sudo gem install cocoapods`. Une -fois CocoaPods installé, exécutez `pod setup` pour le -configurer (si ne l'est pas déjà). Exécutez ensuite `pod -install` pour télécharger et installer les dépendances de projet -requises avant d'ouvrir votre fichier `.xcworkspace` dans Xcode. Vous -trouverez plus de détails dans le fichier `README.md`, dans -l'archive du code téléchargé. Pour plus d'informations, voir -[Outils prérequis pour le développeur](get_code.html#prereq-dev-tools). - -Revenez vérifier fréquemment pour être tenu au courant des nouvelles mises à jour. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Nouveautés de la console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} +{: #what-is-new} + + +## Mise à jour de mars 2017 +{: #mar-2017} + +La mise à jour de mars 2017 de la console {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} comprend les modifications suivantes : + + * Le tableau de bord {{site.data.keyword.Bluemix_notm}} Mobile est devenu la console {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}. + * La procédure de création de projets a été modifiée pour inclure les types de modèle de serveur Application Web, BFF et Microservice avec prise en charge de Node.js, Java et Swift. + * L'intégration au nouveau service optimisé {{site.data.keyword.appid_full}} fournit une authentification pour les projets Web et mobiles. + * Vous pouvez maintenant générer des SDK pour vos projets en utilisant le [plug-in de générateur SDK](sdk_cli.html). La génération de SDK dans la console {{site.data.keyword.dev_console}} n'est disponible que pour les projets mobiles. + * Il vous est désormais possible de créer des projets en utilisant le plug-in [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + + +## Mise à jour de janvier 2017 +{: #jan-2017} + +La mise à jour de janvier 2017 du tableau de bord {{site.data.keyword.Bluemix_notm}} Mobile comprend les modifications suivantes : + + * Au 31 janvier, les modules de démarrage pour l'interface utilisateur deviennent obsolètes. Les projets existants qui ont été crées depuis un module de démarrage pour l'interface utilisateur peuvent être utilisés jusqu'au 30 avril 2017. Pour plus d'informations sur les étapes de migration et les dates de retrait, voir l'[article de blogue de l'annonce de dépréciation![Icône de lien externe](../icons/launch-glyph.svg "External link icon")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/). +{: deprecated} + * Vous pouvez maintenant mettre à jour votre type de module de démarrage de projet au lieu de supprimer votre projet et d'en créer un nouveau. + * Vous pouvez désormais créer votre projet avec un module de démarrage pour le code [Watson Conversation](tutorial_conversation.html). + * Là où il est pris en charge, vous pouvez maintenant générer un SDK pour votre projet. + * Vous pouvez désormais ajouter vos instances de calcul et générer des SDK client à ajouter à votre projet. + + +## Mise à jour de décembre 2016 +{: #dec-2016} + +La mise à jour de novembre 2016 du tableau de bord {{site.data.keyword.Bluemix_notm}} Mobile comprend les modifications suivantes : + + * Vous pouvez maintenant retirer d'un projet un service connecté de façon à pouvoir le supprimer ou le réutiliser avec un autre projet. + * Vous pouvez désormais ajouter un service existant à un projet. + * Vous pouvez maintenant créer ou connecter un service CloudantNoSQL existant en tant que source de données quand vous utilisez un module de démarrage pour le code. + * Là où il est pris en charge, vous pouvez désormais créer ou connecter un service Object Storage existant comme source de données pour votre projet. + * Vous pouvez maintenant personnaliser la conception de la navigation de l'application que vous créez avec un module de démarrage pour l'interface utilisateur. + + +## Mise à jour de novembre 2016 +{: #nov-2016} + +La mise à jour de novembre 2016 du tableau de bord {{site.data.keyword.Bluemix_notm}} Mobile comprend les modifications suivantes : + + * Vous pouvez à présent générer des artefacts SDK pour vos projets depuis la page **Code**. + * Cordova est à présent pris en charge pour le module de démarrage Basic. + * Vous pouvez dorénavant [créer un rapport des événements réseau ![Icône de lien externe](../icons/launch-glyph.svg "External link icon")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} et [suivre les demandes réseau ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} sur la page relative aux demandes réseau de la console {{site.data.keyword.mobileanalytics_short}}. + * Vous pouvez désormais [exporter des données dans dashDB ![Icône de lien externe](../icons/launch-glyph.svg "Icône de lien externe")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} dans la console {{site.data.keyword.mobileanalytics_short}}. + + +## Mise à jour de novembre 2016 +{: #oct-2016} + +La mise à jour d'octobre 2016 du tableau de bord {{site.data.keyword.Bluemix_notm}} Mobile comprend les modifications suivantes : + + * Vous pouvez désormais ajouter directement des fonctionnalités {{site.data.keyword.mobilepushshort}} et Analytics à votre projet +depuis le tableau de bord. + * Des [modules de démarrage pour le code](starters.html#Code_Starter) sont maintenant disponibles. + * Vous pouvez ajouter l'authentification aux projets que vous avez créés à partir d'un module de démarrage de code. + * Swift est désormais pris en charge. + + +### L'analyse +{: #analytics notoc} + + * Le mode démonstration est activé par défaut lorsque vous ajoutez la +fonction Analyse. Vous pouvez désactiver le mode démonstration pour visualiser +l'analyse après l'exécution de votre application. + + +### Générateur d'interface graphique +{: #ui_builder notoc} + + * La fonctionnalité **{{site.data.keyword.mobilepushshort}}** est désormais accessible depuis le projet. + * L'onglet **Paramètres du projet** a été renommé +en **Paramètres**. + * L'onglet **Authentification** a été renommé en **Accès utilisateur**. + + +### Code +{: #code notoc} + + * Le code Objective-C et Swift généré pour iOS utilise désormais +CocoaPods pour la gestion des dépendances. Cela signifie que vous devez +installer CocoaPods. Pour ce faire, exécutez `sudo gem install cocoapods`. Une +fois CocoaPods installé, exécutez `pod setup` pour le +configurer (si ne l'est pas déjà). Exécutez ensuite `pod +install` pour télécharger et installer les dépendances de projet +requises avant d'ouvrir votre fichier `.xcworkspace` dans Xcode. Vous +trouverez plus de détails dans le fichier `README.md`, dans +l'archive du code téléchargé. Pour plus d'informations, voir +[Outils prérequis pour le développeur](get_code.html#prereq-dev-tools). + +Revenez vérifier fréquemment pour être tenu au courant des nouvelles mises à jour. diff --git a/cloudnative/nl/it/cli.md b/cloudnative/nl/it/cli.md index e0af34785..4616b43f2 100644 --- a/cloudnative/nl/it/cli.md +++ b/cloudnative/nl/it/cli.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Plugin per la CLI {{site.data.keyword.Bluemix_notm}} -{: #cli} - -I seguenti plugin possono essere aggiunti alla CLI {{site.data.keyword.Bluemix}}. Puoi utilizzare questi plugin per creare i tuoi progetti {{site.data.keyword.dev_console}}. - -* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) -* [Plugin {{site.data.keyword.IBM_notm}} SDK Generator](sdk_cli.html) +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Plugin per la CLI {{site.data.keyword.Bluemix_notm}} +{: #cli} + +I seguenti plugin possono essere aggiunti alla CLI {{site.data.keyword.Bluemix}}. Puoi utilizzare questi plugin per creare i tuoi progetti {{site.data.keyword.dev_console}}. + +* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) +* [Plugin {{site.data.keyword.IBM_notm}} SDK Generator](sdk_cli.html) diff --git a/cloudnative/nl/it/compute.md b/cloudnative/nl/it/compute.md index ddbefdb53..dec3afc0b 100644 --- a/cloudnative/nl/it/compute.md +++ b/cloudnative/nl/it/compute.md @@ -1,182 +1,182 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Calcolo -{: #compute} - -Quando crei un'applicazione di canale digitale nativa del cloud per web e mobile, la procedura consigliata consiste nell'avere un BFF (Backend for Frontend) che sia dedicato al tuo canale digitale o che offra lo stesso supporto di integrazione di dati e logica sia per le applicazioni client Web che mobili. Per ulteriori informazioni su questa architettura, vedi [Microservices for web and mobile ![Icona link esterno](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture). - -Il seguente diagramma mostra una panoramica dell'architettura. - -![Architettura BFF](images/bff-arch.png) - -Figura 1: architettura BFF - -Il concetto di un BFF è quello di astrarre la logica di business e la logica di integrazione comune dai tuoi microservizi o dai servizi cloud {{site.data.keyword.Bluemix}} di alto valore. - -Con questa architettura, puoi distribuire e rilasciare aggiornamenti alla tua applicazione mobile o Web e distribuire nuove versioni del BFF utilizzando pipeline di fornitura continua con il servizio DevOps. - -Se hai un BFF per iOS e un altro BFF per Android, i team di progettazione che forniscono la funzione per queste applicazioni non sono vincolati a rilasciare le funzioni con una pianificazione di rilascio API centralizzata. Questo è un obiettivo comune per le architetture di microservizi e canali digitali, ossia permettere ai team di rilasciare spesso le funzioni senza essere condizionati dalla pianificazione di rilascio di altri team. - - - - -## Integrazione di un client mobile con un Backend for Frontend -{: #integration} - -Per consentire una facile integrazione tra un client mobile e un BFF, {{site.data.keyword.Bluemix_notm}} supporta la generazione dell'SDK client mobile per iOS e Android rispettivamente nei linguaggi Swift e Java. Per abilitare questa funzione, devi esporre la tua integrazione BFF utilizzando un documento di specifiche Open API (Swagger). Questo documento può essere in formato JSON o YAML. - -Il generatore dell'SDK client utilizza il file di definizione Open API per definire un SDK per sviluppatori ottimizzato per il client che sia facile da utilizzare nella tua applicazione mobile nativa. Questo permetterà di accelerare l'integrazione del BFF nella tua applicazione mobile. - - -## Definizione di una API -{: #definition} - -Il BFF deve esporre un file di definizione API che sia conforme alla specifica Open API in esecuzione su un endpoint server live. Per consentire a {{site.data.keyword.Bluemix_notm}} Developer Experience e {{site.data.keyword.Bluemix_notm}} SDK CLI (Command Line Interface) di rilevare questo endpoint, devi aggiungere una variabile di ambiente denominata `OPENAPI_SPEC` alla tua applicazione Cloud Foundry. Questa variabile di ambiente deve fare riferimento alla specifica utilizzando un percorso relativo. - -Per aggiungere la variabile di ambiente `OPENAPI_SPEC` in {{site.data.keyword.Bluemix_notm}}, completa questa procedura: - -1. Accedi a [{{site.data.keyword.Bluemix_notm}} ![Icona link esterno](../icons/launch-glyph.svg)](http://bluemix.net). -2. Seleziona un'applicazione Cloud Foundry. -3. Seleziona **Runtime**. -4. Seleziona **Variabili di ambiente**. -5. Fai clic su **Aggiungi** nella sezione **Definito dall'utente**. -6. Specifica `OPENAPI_SPEC` per **NAME** e un percorso URL relativo del tuo file di definizione Open API. -7. Fai clic su **Salva**. - - - -Ad -esempio: - -``` -OPENAPI_SPEC='/explorer/swagger.json' -``` -{: codeblock} - -{{site.data.keyword.apiconnect_long}} e le applicazioni Loopback funzionano particolarmente bene con questo approccio. Puoi utilizzare Loopback e {{site.data.keyword.apiconnect_short}} per definire un modello persistente ed esporre l'operazione CRUD (Create, Read, Update e Delete) utilizzando il file di definizione Open API. - -Puoi definire anche operazioni logiche di business. - - -### Elementi supportati della specifica Open API -{: #supported-elements notoc} - -L'unica parte della specifica Open API che non è completamente supportata è la struttura dei file. La specifica consente di suddividere le parti della definizione in file diversi e di farvi riferimento utilizzando il campo json `$ref`. L'intera definizione deve essere contenuta all'interno di un unico file. - - -## Esempio di Backend for Frontend che utilizza Bluegen -{: #bff-bluegen} - -{{site.data.keyword.Bluemix_notm}} ha creato un BFF di riferimento utilizzando {{site.data.keyword.apiconnect_short}} e Strongloop, che associa un modello di prodotto a un {{site.data.keyword.cloudant}} e un'API di immagine per fare riferimento alle immagini in {{site.data.keyword.objectstorageshort}}. - -Puoi utilizzare questo modello BFF per iniziare rapidamente con il provisioning di un BFF completamente funzionante in {{site.data.keyword.Bluemix_notm}} e utilizzarlo per capire come sia facile integrare un BFF in un progetto mobile e generare SDK nativi per iOS e Android in Swift e Java. - -Segui le istruzioni riportate in [README ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) per creare un progetto e installarlo. - - -## Utilizzo di Backend for Frontend con un progetto Developer Experience -{: #bff-devex} - -{{site.data.keyword.Bluemix_notm}} Mobile Developer Experience è progettato per semplificare la definizione di un progetto mobile con una serie di servizi cloud associati. Puoi aggiungere facilmente i servizi [{{site.data.keyword.mobilepushshort}} ![Icona link esterno](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [Analytics ![Icona link esterno](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html), Data o Storage. - -{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ha introdotto la possibilità di integrare un BFF in un progetto mobile nella pagina **Calcolo**. Puoi aggiungere istanze del servizio Calcolo esistenti al tuo progetto mobile. Una volta aggiunte, puoi generare un SDK nativo per il linguaggio che hai scelto o puoi generare il progetto completo e l'SDK verrà integrato nel pacchetto di origine del progetto nella pagina **Codice**. Ciò è particolarmente utile per l'integrazione con BFF già ben definiti. - -Dopo aver scaricato il progetto, puoi aprirlo con Xcode o Android Studio e compilarlo con l'SDK client. - - -## Utilizzo della CLI -{: #cli} - -Mentre sviluppi il tuo BFF, la specifica API potrebbe cambiare. Per supportare queste modifiche, hai le due seguenti opzioni: - -* Rigenera l'intero progetto in un nuovo ramo GitHub e unisci le modifiche nel tuo ramo di sviluppo. -* Rigenera direttamente l'SDK utilizzando lo strumento della riga comandi (CLI) e aggiorna solo la parte SDK del progetto mobile. - -Per utilizzare la CLI, devi [installarla](sdk_cli.html#installation). - -Utilizza il seguente comando per elencare le azioni che puoi effettuare. - -``` -bluemix sdk -``` -{: codeblock} - -Utilizza il seguente comando per elencare le istanze Cloud Foundry in esecuzione nel tuo spazio {{site.data.keyword.Bluemix_notm}} corrente. - -``` -bluemix sdk list -``` -{: codeblock} - -Vengono elencate tutte le applicazioni e l'API viene convalidata se la variabile di ambiente `OPENAPI_SPEC` è impostata. Nella colonna `VALID`, visualizzerai un segno di spunta verde o una `X` rossa. Il segno di spunta nella colonna `VALID` per l'applicazione significa che è presente una definizione Open API valida. Una `X` nella colonna `VALID` per l'applicazione può significare due cose: - -* una variabile di ambiente `OPENAPI_SPEC` non è definita per la tua applicazione OPPURE -* la definizione API non è valida in relazione alla specifica Open API - -Utilizza il seguente comando per visualizzare l'URL completamente formato per l'API. Vengono elencate la rotta e l'URI completamente formati della specifica API. Puoi visualizzare la specifica non elaborata in un browser, utilizzarla direttamente nella CLI o verificare che la variabile di ambiente del BFF `OPENAPI_SPEC` sia impostata correttamente. - -``` -bluemix sdk list --url -``` -{: codeblock} - -Utilizza il seguente comando per convalidare il file di definizione Open API di `` per determinare se può essere utilizzato per generare un SDK. Il comando trova `` nel tuo spazio corrente e utilizza il percorso relativo nella variabile di ambiente `OPENAPI_SPEC` per individuare la specifica per la convalida. - -``` -bluemix sdk validate -``` -{: codeblock} - -Utilizza il seguente comando per generare un SDK per la `` nativa da te scelta e per inserire un file compresso nella tua directory di lavoro corrente. - -``` -bluemix sdk generate -- -``` -{: codeblock} - -L'utilizzo dell'opzione `--unzip` estrae automaticamente l'SDK nella tua directory di lavoro corrente. Puoi anche specificare la posizione in cui estrarre l'SDK utilizzando l'opzione `--output`. Puoi gestire il tuo codice sorgente con GitHub e creare un nuovo ramo specifico per l'aggiornamento dell'SDK. Mediante questo approccio sarà più semplice visualizzare le modifiche e unire l'SDK aggiornato al tuo ramo di sviluppo. - - -## Utilizzo di API e modelli generati dell'SDK -{: #models-apis} - -Ora che il tuo BFF è stato integrato alla tua applicazione mobile mediante un SDK generato, puoi iniziare a utilizzarlo. - -L'SDK viene fornito con la documentazione completa nella directory `docs` e nella directory `source`. Puoi aprire il file `README.html` per visualizzare la documentazione nel web o aprire il file `README.md` per visualizzarla in formato Markdown. La documentazione in formato Markdown è utile per la pubblicazione dell'SDK in Cocoapods o Maven Central. - -All'interno della documentazione, puoi visualizzare un elenco delle API generate. Fai clic sull'API per visualizzare un frammento di codice che puoi incollare direttamente nella tua applicazione mobile. +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Calcolo +{: #compute} + +Quando crei un'applicazione di canale digitale nativa del cloud per web e mobile, la procedura consigliata consiste nell'avere un BFF (Backend for Frontend) che sia dedicato al tuo canale digitale o che offra lo stesso supporto di integrazione di dati e logica sia per le applicazioni client Web che mobili. Per ulteriori informazioni su questa architettura, vedi [Microservices for web and mobile ![Icona link esterno](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture). + +Il seguente diagramma mostra una panoramica dell'architettura. + +![Architettura BFF](images/bff-arch.png) + +Figura 1: architettura BFF + +Il concetto di un BFF è quello di astrarre la logica di business e la logica di integrazione comune dai tuoi microservizi o dai servizi cloud {{site.data.keyword.Bluemix}} di alto valore. + +Con questa architettura, puoi distribuire e rilasciare aggiornamenti alla tua applicazione mobile o Web e distribuire nuove versioni del BFF utilizzando pipeline di fornitura continua con il servizio DevOps. + +Se hai un BFF per iOS e un altro BFF per Android, i team di progettazione che forniscono la funzione per queste applicazioni non sono vincolati a rilasciare le funzioni con una pianificazione di rilascio API centralizzata. Questo è un obiettivo comune per le architetture di microservizi e canali digitali, ossia permettere ai team di rilasciare spesso le funzioni senza essere condizionati dalla pianificazione di rilascio di altri team. + + + + +## Integrazione di un client mobile con un Backend for Frontend +{: #integration} + +Per consentire una facile integrazione tra un client mobile e un BFF, {{site.data.keyword.Bluemix_notm}} supporta la generazione dell'SDK client mobile per iOS e Android rispettivamente nei linguaggi Swift e Java. Per abilitare questa funzione, devi esporre la tua integrazione BFF utilizzando un documento di specifiche Open API (Swagger). Questo documento può essere in formato JSON o YAML. + +Il generatore dell'SDK client utilizza il file di definizione Open API per definire un SDK per sviluppatori ottimizzato per il client che sia facile da utilizzare nella tua applicazione mobile nativa. Questo permetterà di accelerare l'integrazione del BFF nella tua applicazione mobile. + + +## Definizione di una API +{: #definition} + +Il BFF deve esporre un file di definizione API che sia conforme alla specifica Open API in esecuzione su un endpoint server live. Per consentire a {{site.data.keyword.Bluemix_notm}} Developer Experience e {{site.data.keyword.Bluemix_notm}} SDK CLI (Command Line Interface) di rilevare questo endpoint, devi aggiungere una variabile di ambiente denominata `OPENAPI_SPEC` alla tua applicazione Cloud Foundry. Questa variabile di ambiente deve fare riferimento alla specifica utilizzando un percorso relativo. + +Per aggiungere la variabile di ambiente `OPENAPI_SPEC` in {{site.data.keyword.Bluemix_notm}}, completa questa procedura: + +1. Accedi a [{{site.data.keyword.Bluemix_notm}} ![Icona link esterno](../icons/launch-glyph.svg)](http://bluemix.net). +2. Seleziona un'applicazione Cloud Foundry. +3. Seleziona **Runtime**. +4. Seleziona **Variabili di ambiente**. +5. Fai clic su **Aggiungi** nella sezione **Definito dall'utente**. +6. Specifica `OPENAPI_SPEC` per **NAME** e un percorso URL relativo del tuo file di definizione Open API. +7. Fai clic su **Salva**. + + + +Ad +esempio: + +``` +OPENAPI_SPEC='/explorer/swagger.json' +``` +{: codeblock} + +{{site.data.keyword.apiconnect_long}} e le applicazioni Loopback funzionano particolarmente bene con questo approccio. Puoi utilizzare Loopback e {{site.data.keyword.apiconnect_short}} per definire un modello persistente ed esporre l'operazione CRUD (Create, Read, Update e Delete) utilizzando il file di definizione Open API. + +Puoi definire anche operazioni logiche di business. + + +### Elementi supportati della specifica Open API +{: #supported-elements notoc} + +L'unica parte della specifica Open API che non è completamente supportata è la struttura dei file. La specifica consente di suddividere le parti della definizione in file diversi e di farvi riferimento utilizzando il campo json `$ref`. L'intera definizione deve essere contenuta all'interno di un unico file. + + +## Esempio di Backend for Frontend che utilizza Bluegen +{: #bff-bluegen} + +{{site.data.keyword.Bluemix_notm}} ha creato un BFF di riferimento utilizzando {{site.data.keyword.apiconnect_short}} e Strongloop, che associa un modello di prodotto a un {{site.data.keyword.cloudant}} e un'API di immagine per fare riferimento alle immagini in {{site.data.keyword.objectstorageshort}}. + +Puoi utilizzare questo modello BFF per iniziare rapidamente con il provisioning di un BFF completamente funzionante in {{site.data.keyword.Bluemix_notm}} e utilizzarlo per capire come sia facile integrare un BFF in un progetto mobile e generare SDK nativi per iOS e Android in Swift e Java. + +Segui le istruzioni riportate in [README ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) per creare un progetto e installarlo. + + +## Utilizzo di Backend for Frontend con un progetto Developer Experience +{: #bff-devex} + +{{site.data.keyword.Bluemix_notm}} Mobile Developer Experience è progettato per semplificare la definizione di un progetto mobile con una serie di servizi cloud associati. Puoi aggiungere facilmente i servizi [{{site.data.keyword.mobilepushshort}} ![Icona link esterno](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [Analytics ![Icona link esterno](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html), Data o Storage. + +{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ha introdotto la possibilità di integrare un BFF in un progetto mobile nella pagina **Calcolo**. Puoi aggiungere istanze del servizio Calcolo esistenti al tuo progetto mobile. Una volta aggiunte, puoi generare un SDK nativo per il linguaggio che hai scelto o puoi generare il progetto completo e l'SDK verrà integrato nel pacchetto di origine del progetto nella pagina **Codice**. Ciò è particolarmente utile per l'integrazione con BFF già ben definiti. + +Dopo aver scaricato il progetto, puoi aprirlo con Xcode o Android Studio e compilarlo con l'SDK client. + + +## Utilizzo della CLI +{: #cli} + +Mentre sviluppi il tuo BFF, la specifica API potrebbe cambiare. Per supportare queste modifiche, hai le due seguenti opzioni: + +* Rigenera l'intero progetto in un nuovo ramo GitHub e unisci le modifiche nel tuo ramo di sviluppo. +* Rigenera direttamente l'SDK utilizzando lo strumento della riga comandi (CLI) e aggiorna solo la parte SDK del progetto mobile. + +Per utilizzare la CLI, devi [installarla](sdk_cli.html#installation). + +Utilizza il seguente comando per elencare le azioni che puoi effettuare. + +``` +bluemix sdk +``` +{: codeblock} + +Utilizza il seguente comando per elencare le istanze Cloud Foundry in esecuzione nel tuo spazio {{site.data.keyword.Bluemix_notm}} corrente. + +``` +bluemix sdk list +``` +{: codeblock} + +Vengono elencate tutte le applicazioni e l'API viene convalidata se la variabile di ambiente `OPENAPI_SPEC` è impostata. Nella colonna `VALID`, visualizzerai un segno di spunta verde o una `X` rossa. Il segno di spunta nella colonna `VALID` per l'applicazione significa che è presente una definizione Open API valida. Una `X` nella colonna `VALID` per l'applicazione può significare due cose: + +* una variabile di ambiente `OPENAPI_SPEC` non è definita per la tua applicazione OPPURE +* la definizione API non è valida in relazione alla specifica Open API + +Utilizza il seguente comando per visualizzare l'URL completamente formato per l'API. Vengono elencate la rotta e l'URI completamente formati della specifica API. Puoi visualizzare la specifica non elaborata in un browser, utilizzarla direttamente nella CLI o verificare che la variabile di ambiente del BFF `OPENAPI_SPEC` sia impostata correttamente. + +``` +bluemix sdk list --url +``` +{: codeblock} + +Utilizza il seguente comando per convalidare il file di definizione Open API di `` per determinare se può essere utilizzato per generare un SDK. Il comando trova `` nel tuo spazio corrente e utilizza il percorso relativo nella variabile di ambiente `OPENAPI_SPEC` per individuare la specifica per la convalida. + +``` +bluemix sdk validate +``` +{: codeblock} + +Utilizza il seguente comando per generare un SDK per la `` nativa da te scelta e per inserire un file compresso nella tua directory di lavoro corrente. + +``` +bluemix sdk generate -- +``` +{: codeblock} + +L'utilizzo dell'opzione `--unzip` estrae automaticamente l'SDK nella tua directory di lavoro corrente. Puoi anche specificare la posizione in cui estrarre l'SDK utilizzando l'opzione `--output`. Puoi gestire il tuo codice sorgente con GitHub e creare un nuovo ramo specifico per l'aggiornamento dell'SDK. Mediante questo approccio sarà più semplice visualizzare le modifiche e unire l'SDK aggiornato al tuo ramo di sviluppo. + + +## Utilizzo di API e modelli generati dell'SDK +{: #models-apis} + +Ora che il tuo BFF è stato integrato alla tua applicazione mobile mediante un SDK generato, puoi iniziare a utilizzarlo. + +L'SDK viene fornito con la documentazione completa nella directory `docs` e nella directory `source`. Puoi aprire il file `README.html` per visualizzare la documentazione nel web o aprire il file `README.md` per visualizzarla in formato Markdown. La documentazione in formato Markdown è utile per la pubblicazione dell'SDK in Cocoapods o Maven Central. + +All'interno della documentazione, puoi visualizzare un elenco delle API generate. Fai clic sull'API per visualizzare un frammento di codice che puoi incollare direttamente nella tua applicazione mobile. diff --git a/cloudnative/nl/it/dev_cli.md b/cloudnative/nl/it/dev_cli.md index 296662b83..987066f4e 100644 --- a/cloudnative/nl/it/dev_cli.md +++ b/cloudnative/nl/it/dev_cli.md @@ -1,406 +1,406 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.dev_cli_short}} -{: #developercli} - -{{site.data.keyword.dev_cli_long}} fornisce un approccio guidato al comando estensibile per la creazione, lo sviluppo e la distribuzione di un progetto web con il plugin `dev`. Ideale per gli sviluppatori che desiderano utilizzare il controllo della riga di comando mentre sviluppano le applicazioni del microservizio end-to-end. - -{: shortdesc} - -{{site.data.keyword.dev_cli_notm}} utilizza due contenitori per facilitare la creazione e la verifica della tua applicazione. Il primo è il contenitore degli strumenti che contiene i programmi di utilità necessari per creare e verificare la tua applicazione. Il Dockerfile per questo contenitore è definito dal parametro [dockerfile-tools](#command-parameters). Puoi pensare ad esso come a un contenitore di sviluppo poiché contiene gli strumenti normalmente utili per lo sviluppo di uno specifico runtime. - -Il secondo contenitore è il contenitore di esecuzione. Questo contenitore è di un formato adeguato per essere distribuito per l'utilizzo, ad esempio, in {{site.data.keyword.Bluemix}}. Di conseguenza, questo contenitore generalmente disporrà di un punto di ingresso definito che avvia la tua applicazione. Quando selezioni di eseguire la tua applicazione tramite {{site.data.keyword.dev_cli_short}}, utilizza questo contenitore. Il Dockerfile per questo contenitore è definito dal parametro [dockerfile-run](#run-parameters). - - -## Aggiunta di {{site.data.keyword.dev_cli_notm}} -{: #add-cli} - - -### Prerequisiti -{: #prereq} - -Sono necessari pochi prerequisiti per esplorare completamente e correttamente l'utilizzo di {{site.data.keyword.dev_cli_short}}, poiché è altamente estendibile e ti consente di utilizzare ulteriori tecnologie complementari. - -1. Installa la CLI [Cloud Foundry ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/cloudfoundry/cli#getting-started). - -2. Installa la CLI [{{site.data.keyword.Bluemix}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://clis.ng.bluemix.net/ui/home.html). - -3. Ottieni un ID [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net). - -4. Facoltativo: se stai pianificando l'esecuzione e il debug delle applicazioni localmente, devi installare anche [Docker ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.docker.com/get-docker). Questo è obbligatorio solo per i progetti non mobili. - - -### installazione -{: #installation} - -1. Installa la [{{site.data.keyword.dev_cli_short}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} eseguendo il seguente comando: - - ``` - bx plugin install dev -r Bluemix - ``` - {: codeblock} - -2. Convalida la validità dell'installazione eseguendo il seguente comando: - - ``` - bx dev - ``` - {: codeblock} - - -### Prima di iniziare -{: #before-install} - -1. Accedi a {{site.data.keyword.Bluemix_notm}}. - - ``` - bx login - ``` - {: codeblock} - - **Nota:** se le tue credenziali vengono rifiutate potresti stare utilizzando un ID federato. Utilizza queste istruzioni per l'autenticazione con un ID federato. - - - - 1. Accedi a [{{site.data.keyword.iamshort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.bluemix.net/iam/#/apikeys){: new_window}. - 2. Seleziona **Crea chiave API**. - * Immetti un nome e una descrizione per apiKey - 3. Scarica la tua apiKey. - 4. Apri il file e copia il valore dal campo `apiKey`. - 5. Accedi utilizzando il seguente comando: - - ``` - bx login --apikey - ``` - {: codeblock} - - -## Comandi -{: #commands} - -Utilizzare i seguenti comandi per creare un progetto, distribuirlo, eseguirne il debug, e verificarlo. - -### Creazione -{: #build} - -Puoi creare la tua applicazione utilizzando il comando `build`. L'elemento di configurazione `build-cmd-run` viene utilizzato per creare l'applicazione. I comandi `test`, `debug` e `run` eseguono tutti una build perché questo comando è parte delle loro operazioni normali per cui eseguire questo comando prima non è necessario. - -Esegui il seguente comando nella tua directory del progetto corrente per creare la tua applicazione: - -``` -bx dev build -``` -{: codeblock} - - -[Crea parametri del comando](#command-parameters) - - -### Codice -{: #code} - -Il comando `code` ti consente di scaricare il codice dell'applicazione dopo la distribuzione, in modo che puoi eseguire la verifica localmente o effettuare ulteriori modifiche. - -Esegui il seguente comando per scaricare il codice da un progetto specificato. - -``` -bx dev code -``` -{: codeblock} - - -### Creazione -{: #create} - -Crea un nuovo progetto, fornendo tutte le informazioni necessarie, inclusi lingua, nome progetto e tipo di modello dell'applicazione. Il progetto sarà creato nella directory corrente. - -Per creare un nuovo progetto nella directory corrente e associare dei servizi ad esso, esegui il seguente comando: - -``` -bx dev create -``` -{: codeblock} - - -### Debug -{: #debug} - -Puoi eseguire il debug della tua applicazione tramite il comando `debug`. Viene prima completata una build per il progetto utilizzando l'elemento di configurazione `build-cmd-debug` come istruzioni di build. Un contenitore inizia quindi ad esporre una porta o più porte di debug come definito in `container-port-map-debug`. Collegando il tuo strumento di debug preferito alla porta o alle porte puoi eseguire il debug della tua applicazione come normale. - -**Limitazione**: al momento i progetti Swift non sono disponibili per il debug. - -Esegui il seguente comando nella tua directory del progetto corrente per eseguire il debug della tua applicazione: - -``` -bx dev debug -``` -{: codeblock} - -Per uscire dalla sessione di debug utilizza `CTRL-C`. - - -#### Debug dei parametri del comando -{: #debug-parameters} - -I seguenti parametri sono esclusivi del comando `debug` e forniscono supporto -con il debug di un'applicazione. - -##### `container-port-map-debug` -{: #port-map-debug} - -* Le associazioni di porta per la porta di debug. Il primo valore è la porta da utilizzare nel SO host, il secondo è la porta nel contenitore (host:container). -* Utilizzo: `bx dev debug container-port-map-debug [7777:7777]` - -##### `build-cmd-debug` -{: #build-cmd-debug} - -* Utilizzato per creare il codice per DEBUG. -* Utilizzo: `bx dev debug build-cmd-debug build.command.sh` - -##### `debug-cmd` -{: #debug-cmd} - -* Utilizzato per eseguire il debug del codice nel contenitore degli strumenti. Questo è facoltativo se `build-cmd-debug` avvierà la tua applicazione in debug. -* Utilizzo: `bx dev debug debug-cmd /the/debug/command` - -#### Debug dell'applicazione locale: -{: #local-app-dev} - -Per ulteriori informazioni sul debug dell'applicazione locale, vedi [Debug dell'applicazione locale](docs/cloudnative/dev_cli_local_debug.html#local-debug). - - -### Eliminazione -{: #delete} - -Questo comando ti consente di rimuovere i progetti dal tuo spazio {{site.data.keyword.Bluemix}}. - -Esegui il seguente comando per eliminare il tuo progetto da {{site.data.keyword.Bluemix}}: - -``` -bx dev delete -``` -{: codeblock} - - -**Nota** i servizi {{site.data.keyword.Bluemix}} **non** vengono rimossi. - - -### Guida -{: #help} - -Per impostazione predefinita, se non viene trasmesso alcun argomento o azione o se viene fornita l'azione 'help', questo comando mostrerà un testo generale "Help". La guida generale visualizzata include una descrizione degli argomenti di base così come un elenco di azioni disponibili. - -Esegui il seguente comando per visualizzare le informazioni sulla guida generali: - -``` -bx dev help -``` -{: codeblock} - - -### Elenco -{: #list} - -Puoi elencare tutti i progetti {{site.data.keyword.Bluemix_notm}} in uno spazio. - -Esegui il seguente comando per elencare i tuoi progetti: - -``` -bx dev list -``` -{: codeblock} - - - - - -### Esecuzione -{: #run} - -Puoi eseguire la tua applicazione tramite il comando `run`. Viene prima completata una build per il progetto utilizzando l'elemento di configurazione `build-cmd-run` come istruzioni di build. Il contenitore di esecuzione viene quindi avviato ed espone le porte come definite in `container-port-map`. `run-cmd` può essere utilizzato per richiamare l'applicazione se il contenitore di esecuzione non contiene un punto di ingresso per completare questa fase. - -Esegui il seguente comando nella tua directory del progetto corrente per avviare la tua applicazione: - -``` -bx dev run -``` -{: codeblock} - -Per uscire dalla sessione utilizza `CTRL-C`. - - -#### Eseguire i parametri -{: #run-parameters} - -I seguenti parametri sono esclusivi del comando `run` e forniscono supporto -nella gestione della tua applicazione nel contenitore di esecuzione. - -##### `container-name-run` -{: #container-name-run} - -* Il nome del contenitore per il tuo contenitore di esecuzione. -* Utilizzo: `bx dev run container-name-run ` - -##### `container-path-run` -{: #container-path-run} - -* L'ubicazione nel contenitore da condividere nell'esecuzione. -* Utilizzo: `bx dev run container-path-run [/path/to/app]` - -##### `host-path-run` -{: #host-path-run} - -* L'ubicazione del sistema host da condividere nel contenitore nell'esecuzione. -* Utilizzo: `bx dev run host-path-run [/path/to/app/bin]` - -##### `dockerfile-run` -{: #dockerfile-run} - -* Il Dockerfile per il contenitore di esecuzione. -* Utilizzo: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` - -##### `image-name-run` -{: #image-name-run} - -* L'immagine da creare da dockerfile-run. -* Utilizzo: `bx dev run image-name-run [/path/to/image-name]` - -##### `run-cmd` -{: #run-cmd} - -* Parametro facoltativo utilizzato per eseguire il codice nel contenitore di esecuzione. Questo è facoltativo se la tua immagine avvierà la tua applicazione. -* Utilizzo: `bx dev run run-cmd [/the/run/command]` - -### Stato -{: #status} - -Puoi eseguire la query dello stato dei contenitori utilizzati dalla {{site.data.keyword.dev_cli_short}} come definito da `container-name-run` e `container-name-tools`. - -Esegui il seguente comando nella tua directory del progetto corrente per controllare lo stato del contenitore: - -``` -bx dev status -``` -{: codeblock} - - -[Stato dei parametri del comando](#command-parameters) - - -### Arresto -{: #stop} - -Puoi arrestare un contenitore tramite il comando `stop`. Il parametro `container-name` ti consente di specificare il contenitore da arrestare. Se non viene specificato, il comando stop arresta il contenitore di esecuzione come definito da `container-name-run`. - -Esegui il seguente comando nella tua directory del progetto corrente per arrestare un contenitore: - -``` -bx dev stop -``` -{: codeblock} - - -#### Ulteriori parametri di arresto: -{: #stop-parameter} - -##### `container-name` -{: #container-name} - -* Il nome del contenitore per il tuo contenitore degli strumenti. -* Utilizzo: `bx dev stop container-name ` - -### Verifica -{: #test} - -Puoi verificare la tua applicazione tramite il comando `test`. Viene prima completata una build per il progetto utilizzando l'elemento di configurazione `build-cmd-run` come istruzioni di build. Il contenitore degli strumenti viene quindi utilizzato per richiamare `test-cmd` per l'applicazione. - -Esegui il seguente comando per verificare la tua applicazione: - -``` -bx dev test -``` -{: codeblock} - - -[Verifica dei parametri del comando](#command-parameters) - - -## I parametri per la creazione, il debug, l'esecuzione e la verifica -{: #command-parameters} - -I seguenti parametri possono essere utilizzati insieme ai comandi `build|debug|run|test` e possono essere specificati tramite la riga di comando e/o aggiornando la directory del file `cli-config.yml` del progetto. Sono disponibili ulteriori parametri per i comandi [`debug`](#debug-parameters) e [`run`](#run-parameters) e sono illustrati nelle rispettive sezioni. - -**Nota**: i parametri del comando immessi nella riga di comando hanno la precedenza sulla configurazione `cli-config.yml`. - -##### `container-name-tools` -{: #container-name-tools} - -* Il nome del contenitore per il tuo contenitore degli strumenti. -* Utilizzo: `bx dev container-name-tools []` - -##### `host-path-tools` -{: #host-path-tools} - -* L'ubicazione sull'host da condividere per la creazione, il debug e la verifica. -* Utilizzo: `bx dev host-path-tools [/path/to/build/tools]` - -##### `container-path-tools` -{: #container-path-tools} - -* L'ubicazione nel contenitore da condividere per la creazione, il debug e la verifica. -* Utilizzo: `bx dev container-path-tools [/path/for/build]` - -##### `container-port-map` -{: #container-port-map} - -* Le associazioni di porta per il contenitore. Il primo valore è la porta da utilizzare nel SO host, il secondo è la porta nel contenitore (host:container). -* Utilizzo: `bx dev container-port-map [8090:8090,9090,9090]` - -##### `dockerfile-tools` -{: #dockerfile-tools} - -* Il Dockerfile per il contenitore degli strumenti. -* Utilizzo: `bx dev dockerfile-tools [path/to/dockerfile]` - -##### `image-name-tools` -{: #image-name-tools} - -* L'immagine da creare da dockerfile-tools. -* Utilizzo: `bx dev image-name-tools [path/to/image-name]` - -##### `build-cmd-run` -{: #build-cmd-run} - -* Il comando per creare il codice per tutti gli utilizzi di DEBUG. -* Utilizzo: `bx dev build-cmd-run [some.build.command]` - -##### `test-cmd` -{: #test-cmd} - -* Il comando per verificare il codice nel contenitore degli strumenti. -* Utilizzo: `bx dev test-cmd [/the/test/command]` - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.dev_cli_short}} +{: #developercli} + +{{site.data.keyword.dev_cli_long}} fornisce un approccio guidato al comando estensibile per la creazione, lo sviluppo e la distribuzione di un progetto web con il plugin `dev`. Ideale per gli sviluppatori che desiderano utilizzare il controllo della riga di comando mentre sviluppano le applicazioni del microservizio end-to-end. + +{: shortdesc} + +{{site.data.keyword.dev_cli_notm}} utilizza due contenitori per facilitare la creazione e la verifica della tua applicazione. Il primo è il contenitore degli strumenti che contiene i programmi di utilità necessari per creare e verificare la tua applicazione. Il Dockerfile per questo contenitore è definito dal parametro [dockerfile-tools](#command-parameters). Puoi pensare ad esso come a un contenitore di sviluppo poiché contiene gli strumenti normalmente utili per lo sviluppo di uno specifico runtime. + +Il secondo contenitore è il contenitore di esecuzione. Questo contenitore è di un formato adeguato per essere distribuito per l'utilizzo, ad esempio, in {{site.data.keyword.Bluemix}}. Di conseguenza, questo contenitore generalmente disporrà di un punto di ingresso definito che avvia la tua applicazione. Quando selezioni di eseguire la tua applicazione tramite {{site.data.keyword.dev_cli_short}}, utilizza questo contenitore. Il Dockerfile per questo contenitore è definito dal parametro [dockerfile-run](#run-parameters). + + +## Aggiunta di {{site.data.keyword.dev_cli_notm}} +{: #add-cli} + + +### Prerequisiti +{: #prereq} + +Sono necessari pochi prerequisiti per esplorare completamente e correttamente l'utilizzo di {{site.data.keyword.dev_cli_short}}, poiché è altamente estendibile e ti consente di utilizzare ulteriori tecnologie complementari. + +1. Installa la CLI [Cloud Foundry ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/cloudfoundry/cli#getting-started). + +2. Installa la CLI [{{site.data.keyword.Bluemix}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://clis.ng.bluemix.net/ui/home.html). + +3. Ottieni un ID [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net). + +4. Facoltativo: se stai pianificando l'esecuzione e il debug delle applicazioni localmente, devi installare anche [Docker ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.docker.com/get-docker). Questo è obbligatorio solo per i progetti non mobili. + + +### installazione +{: #installation} + +1. Installa la [{{site.data.keyword.dev_cli_short}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} eseguendo il seguente comando: + + ``` + bx plugin install dev -r Bluemix + ``` + {: codeblock} + +2. Convalida la validità dell'installazione eseguendo il seguente comando: + + ``` + bx dev + ``` + {: codeblock} + + +### Prima di iniziare +{: #before-install} + +1. Accedi a {{site.data.keyword.Bluemix_notm}}. + + ``` + bx login + ``` + {: codeblock} + + **Nota:** se le tue credenziali vengono rifiutate potresti stare utilizzando un ID federato. Utilizza queste istruzioni per l'autenticazione con un ID federato. + + + + 1. Accedi a [{{site.data.keyword.iamshort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.bluemix.net/iam/#/apikeys){: new_window}. + 2. Seleziona **Crea chiave API**. + * Immetti un nome e una descrizione per apiKey + 3. Scarica la tua apiKey. + 4. Apri il file e copia il valore dal campo `apiKey`. + 5. Accedi utilizzando il seguente comando: + + ``` + bx login --apikey + ``` + {: codeblock} + + +## Comandi +{: #commands} + +Utilizzare i seguenti comandi per creare un progetto, distribuirlo, eseguirne il debug, e verificarlo. + +### Creazione +{: #build} + +Puoi creare la tua applicazione utilizzando il comando `build`. L'elemento di configurazione `build-cmd-run` viene utilizzato per creare l'applicazione. I comandi `test`, `debug` e `run` eseguono tutti una build perché questo comando è parte delle loro operazioni normali per cui eseguire questo comando prima non è necessario. + +Esegui il seguente comando nella tua directory del progetto corrente per creare la tua applicazione: + +``` +bx dev build +``` +{: codeblock} + + +[Crea parametri del comando](#command-parameters) + + +### Codice +{: #code} + +Il comando `code` ti consente di scaricare il codice dell'applicazione dopo la distribuzione, in modo che puoi eseguire la verifica localmente o effettuare ulteriori modifiche. + +Esegui il seguente comando per scaricare il codice da un progetto specificato. + +``` +bx dev code +``` +{: codeblock} + + +### Creazione +{: #create} + +Crea un nuovo progetto, fornendo tutte le informazioni necessarie, inclusi lingua, nome progetto e tipo di modello dell'applicazione. Il progetto sarà creato nella directory corrente. + +Per creare un nuovo progetto nella directory corrente e associare dei servizi ad esso, esegui il seguente comando: + +``` +bx dev create +``` +{: codeblock} + + +### Debug +{: #debug} + +Puoi eseguire il debug della tua applicazione tramite il comando `debug`. Viene prima completata una build per il progetto utilizzando l'elemento di configurazione `build-cmd-debug` come istruzioni di build. Un contenitore inizia quindi ad esporre una porta o più porte di debug come definito in `container-port-map-debug`. Collegando il tuo strumento di debug preferito alla porta o alle porte puoi eseguire il debug della tua applicazione come normale. + +**Limitazione**: al momento i progetti Swift non sono disponibili per il debug. + +Esegui il seguente comando nella tua directory del progetto corrente per eseguire il debug della tua applicazione: + +``` +bx dev debug +``` +{: codeblock} + +Per uscire dalla sessione di debug utilizza `CTRL-C`. + + +#### Debug dei parametri del comando +{: #debug-parameters} + +I seguenti parametri sono esclusivi del comando `debug` e forniscono supporto +con il debug di un'applicazione. + +##### `container-port-map-debug` +{: #port-map-debug} + +* Le associazioni di porta per la porta di debug. Il primo valore è la porta da utilizzare nel SO host, il secondo è la porta nel contenitore (host:container). +* Utilizzo: `bx dev debug container-port-map-debug [7777:7777]` + +##### `build-cmd-debug` +{: #build-cmd-debug} + +* Utilizzato per creare il codice per DEBUG. +* Utilizzo: `bx dev debug build-cmd-debug build.command.sh` + +##### `debug-cmd` +{: #debug-cmd} + +* Utilizzato per eseguire il debug del codice nel contenitore degli strumenti. Questo è facoltativo se `build-cmd-debug` avvierà la tua applicazione in debug. +* Utilizzo: `bx dev debug debug-cmd /the/debug/command` + +#### Debug dell'applicazione locale: +{: #local-app-dev} + +Per ulteriori informazioni sul debug dell'applicazione locale, vedi [Debug dell'applicazione locale](docs/cloudnative/dev_cli_local_debug.html#local-debug). + + +### Eliminazione +{: #delete} + +Questo comando ti consente di rimuovere i progetti dal tuo spazio {{site.data.keyword.Bluemix}}. + +Esegui il seguente comando per eliminare il tuo progetto da {{site.data.keyword.Bluemix}}: + +``` +bx dev delete +``` +{: codeblock} + + +**Nota** i servizi {{site.data.keyword.Bluemix}} **non** vengono rimossi. + + +### Guida +{: #help} + +Per impostazione predefinita, se non viene trasmesso alcun argomento o azione o se viene fornita l'azione 'help', questo comando mostrerà un testo generale "Help". La guida generale visualizzata include una descrizione degli argomenti di base così come un elenco di azioni disponibili. + +Esegui il seguente comando per visualizzare le informazioni sulla guida generali: + +``` +bx dev help +``` +{: codeblock} + + +### Elenco +{: #list} + +Puoi elencare tutti i progetti {{site.data.keyword.Bluemix_notm}} in uno spazio. + +Esegui il seguente comando per elencare i tuoi progetti: + +``` +bx dev list +``` +{: codeblock} + + + + + +### Esecuzione +{: #run} + +Puoi eseguire la tua applicazione tramite il comando `run`. Viene prima completata una build per il progetto utilizzando l'elemento di configurazione `build-cmd-run` come istruzioni di build. Il contenitore di esecuzione viene quindi avviato ed espone le porte come definite in `container-port-map`. `run-cmd` può essere utilizzato per richiamare l'applicazione se il contenitore di esecuzione non contiene un punto di ingresso per completare questa fase. + +Esegui il seguente comando nella tua directory del progetto corrente per avviare la tua applicazione: + +``` +bx dev run +``` +{: codeblock} + +Per uscire dalla sessione utilizza `CTRL-C`. + + +#### Eseguire i parametri +{: #run-parameters} + +I seguenti parametri sono esclusivi del comando `run` e forniscono supporto +nella gestione della tua applicazione nel contenitore di esecuzione. + +##### `container-name-run` +{: #container-name-run} + +* Il nome del contenitore per il tuo contenitore di esecuzione. +* Utilizzo: `bx dev run container-name-run ` + +##### `container-path-run` +{: #container-path-run} + +* L'ubicazione nel contenitore da condividere nell'esecuzione. +* Utilizzo: `bx dev run container-path-run [/path/to/app]` + +##### `host-path-run` +{: #host-path-run} + +* L'ubicazione del sistema host da condividere nel contenitore nell'esecuzione. +* Utilizzo: `bx dev run host-path-run [/path/to/app/bin]` + +##### `dockerfile-run` +{: #dockerfile-run} + +* Il Dockerfile per il contenitore di esecuzione. +* Utilizzo: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` + +##### `image-name-run` +{: #image-name-run} + +* L'immagine da creare da dockerfile-run. +* Utilizzo: `bx dev run image-name-run [/path/to/image-name]` + +##### `run-cmd` +{: #run-cmd} + +* Parametro facoltativo utilizzato per eseguire il codice nel contenitore di esecuzione. Questo è facoltativo se la tua immagine avvierà la tua applicazione. +* Utilizzo: `bx dev run run-cmd [/the/run/command]` + +### Stato +{: #status} + +Puoi eseguire la query dello stato dei contenitori utilizzati dalla {{site.data.keyword.dev_cli_short}} come definito da `container-name-run` e `container-name-tools`. + +Esegui il seguente comando nella tua directory del progetto corrente per controllare lo stato del contenitore: + +``` +bx dev status +``` +{: codeblock} + + +[Stato dei parametri del comando](#command-parameters) + + +### Arresto +{: #stop} + +Puoi arrestare un contenitore tramite il comando `stop`. Il parametro `container-name` ti consente di specificare il contenitore da arrestare. Se non viene specificato, il comando stop arresta il contenitore di esecuzione come definito da `container-name-run`. + +Esegui il seguente comando nella tua directory del progetto corrente per arrestare un contenitore: + +``` +bx dev stop +``` +{: codeblock} + + +#### Ulteriori parametri di arresto: +{: #stop-parameter} + +##### `container-name` +{: #container-name} + +* Il nome del contenitore per il tuo contenitore degli strumenti. +* Utilizzo: `bx dev stop container-name ` + +### Verifica +{: #test} + +Puoi verificare la tua applicazione tramite il comando `test`. Viene prima completata una build per il progetto utilizzando l'elemento di configurazione `build-cmd-run` come istruzioni di build. Il contenitore degli strumenti viene quindi utilizzato per richiamare `test-cmd` per l'applicazione. + +Esegui il seguente comando per verificare la tua applicazione: + +``` +bx dev test +``` +{: codeblock} + + +[Verifica dei parametri del comando](#command-parameters) + + +## I parametri per la creazione, il debug, l'esecuzione e la verifica +{: #command-parameters} + +I seguenti parametri possono essere utilizzati insieme ai comandi `build|debug|run|test` e possono essere specificati tramite la riga di comando e/o aggiornando la directory del file `cli-config.yml` del progetto. Sono disponibili ulteriori parametri per i comandi [`debug`](#debug-parameters) e [`run`](#run-parameters) e sono illustrati nelle rispettive sezioni. + +**Nota**: i parametri del comando immessi nella riga di comando hanno la precedenza sulla configurazione `cli-config.yml`. + +##### `container-name-tools` +{: #container-name-tools} + +* Il nome del contenitore per il tuo contenitore degli strumenti. +* Utilizzo: `bx dev container-name-tools []` + +##### `host-path-tools` +{: #host-path-tools} + +* L'ubicazione sull'host da condividere per la creazione, il debug e la verifica. +* Utilizzo: `bx dev host-path-tools [/path/to/build/tools]` + +##### `container-path-tools` +{: #container-path-tools} + +* L'ubicazione nel contenitore da condividere per la creazione, il debug e la verifica. +* Utilizzo: `bx dev container-path-tools [/path/for/build]` + +##### `container-port-map` +{: #container-port-map} + +* Le associazioni di porta per il contenitore. Il primo valore è la porta da utilizzare nel SO host, il secondo è la porta nel contenitore (host:container). +* Utilizzo: `bx dev container-port-map [8090:8090,9090,9090]` + +##### `dockerfile-tools` +{: #dockerfile-tools} + +* Il Dockerfile per il contenitore degli strumenti. +* Utilizzo: `bx dev dockerfile-tools [path/to/dockerfile]` + +##### `image-name-tools` +{: #image-name-tools} + +* L'immagine da creare da dockerfile-tools. +* Utilizzo: `bx dev image-name-tools [path/to/image-name]` + +##### `build-cmd-run` +{: #build-cmd-run} + +* Il comando per creare il codice per tutti gli utilizzi di DEBUG. +* Utilizzo: `bx dev build-cmd-run [some.build.command]` + +##### `test-cmd` +{: #test-cmd} + +* Il comando per verificare il codice nel contenitore degli strumenti. +* Utilizzo: `bx dev test-cmd [/the/test/command]` + diff --git a/cloudnative/nl/it/dev_cli_local_debug.md b/cloudnative/nl/it/dev_cli_local_debug.md index 97b2a9c08..3f1ebbfcb 100644 --- a/cloudnative/nl/it/dev_cli_local_debug.md +++ b/cloudnative/nl/it/dev_cli_local_debug.md @@ -1,76 +1,76 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Debug dell'applicazione locale -{: #local-debug} - -Le istruzioni per il debug dell'applicazione locale sono fornite di seguito per i seguenti linguaggi: - -* [Java](#java) -* [Node.js](#node) - -**Nota**: il debug dell'applicazione Swift al momento non è supportato. - -## Debug dell'applicazione Java -{: #java} - -Passi per abilitare il debug per un'applicazione Java: - -1. Dalla tua directry root del progetto dell'applicazione esegui il seguente comando: - - `bx dev debug` - -2. Collegamento del programma di debug alla tua applicazione: - - * [Eclipse ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) - * [IntelliJ ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) - * [VSCode ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) - * Riga di comando JDK: `jdb -attach ` - -## Debug dell'applicazione Node.js - -{: #node} - -Passi per abilitare il debug per un'applicazione Node.js: - -1. Dalla tua directry root del progetto dell'applicazione esegui il seguente comando: - - `bx dev debug` - -2. Collegamento del programma di debug alla tua applicazione: - * [VSCode ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://blog.docker.com/2016/07/live-debugging-docker/). - * [WebStorm ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Debug dell'applicazione locale +{: #local-debug} + +Le istruzioni per il debug dell'applicazione locale sono fornite di seguito per i seguenti linguaggi: + +* [Java](#java) +* [Node.js](#node) + +**Nota**: il debug dell'applicazione Swift al momento non è supportato. + +## Debug dell'applicazione Java +{: #java} + +Passi per abilitare il debug per un'applicazione Java: + +1. Dalla tua directry root del progetto dell'applicazione esegui il seguente comando: + + `bx dev debug` + +2. Collegamento del programma di debug alla tua applicazione: + + * [Eclipse ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) + * [IntelliJ ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) + * [VSCode ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) + * Riga di comando JDK: `jdb -attach ` + +## Debug dell'applicazione Node.js + +{: #node} + +Passi per abilitare il debug per un'applicazione Node.js: + +1. Dalla tua directry root del progetto dell'applicazione esegui il seguente comando: + + `bx dev debug` + +2. Collegamento del programma di debug alla tua applicazione: + * [VSCode ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://blog.docker.com/2016/07/live-debugging-docker/). + * [WebStorm ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) + + + + + diff --git a/cloudnative/nl/it/devex.md b/cloudnative/nl/it/devex.md index 538cca8b7..3dd475fda 100644 --- a/cloudnative/nl/it/devex.md +++ b/cloudnative/nl/it/devex.md @@ -1,31 +1,31 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.dev_console}} -{: #devex} - -Per iniziare ad utilizzare [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://console.{DomainName}/developer/getting-started), fai clic sulla categoria **Web e mobile** dalla tua console {{site.data.keyword.Bluemix_notm}}. - - -## Introduzione -{: getting-started} - -Crea un progetto nella pagina **Introduzione** facendo clic su **Crea progetto**. Saranno visualizzate le opzioni [pattern](patterns.html), [starter](starters.html) e [language](patterns.html#languages) che ti abilitano a creare velocemente la tua applicazione. - -Puoi visualizzare e gestire tutti i tuoi progetti in un solo posto selezionando la pagina [Progetti ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://console.{DomainName}/developer/projects). Il progetto contiene le informazioni per tutte le funzionalità che sono (e possono essere) integrate con la tua applicazione. Se disponibili, puoi facilmente integrare e gestire i servizi Push, Analytics, Authentication e Data nel progetto, con ulteriori funzionalità disponibili nel prossimo futuro. - -La pagina [Servizi](services.html) mostra una vista operativa delle tue istanze del servizio esistenti. {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} supporta un programma di sviluppo nativo cloud e un utente di gestione dell'applicazione nativo cloud. - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.dev_console}} +{: #devex} + +Per iniziare ad utilizzare [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://console.{DomainName}/developer/getting-started), fai clic sulla categoria **Web e mobile** dalla tua console {{site.data.keyword.Bluemix_notm}}. + + +## Introduzione +{: getting-started} + +Crea un progetto nella pagina **Introduzione** facendo clic su **Crea progetto**. Saranno visualizzate le opzioni [pattern](patterns.html), [starter](starters.html) e [language](patterns.html#languages) che ti abilitano a creare velocemente la tua applicazione. + +Puoi visualizzare e gestire tutti i tuoi progetti in un solo posto selezionando la pagina [Progetti ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://console.{DomainName}/developer/projects). Il progetto contiene le informazioni per tutte le funzionalità che sono (e possono essere) integrate con la tua applicazione. Se disponibili, puoi facilmente integrare e gestire i servizi Push, Analytics, Authentication e Data nel progetto, con ulteriori funzionalità disponibili nel prossimo futuro. + +La pagina [Servizi](services.html) mostra una vista operativa delle tue istanze del servizio esistenti. {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} supporta un programma di sviluppo nativo cloud e un utente di gestione dell'applicazione nativo cloud. + + + diff --git a/cloudnative/nl/it/get_code.md b/cloudnative/nl/it/get_code.md index 01a0241ed..0364ca656 100644 --- a/cloudnative/nl/it/get_code.md +++ b/cloudnative/nl/it/get_code.md @@ -1,80 +1,80 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-18" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# Richiama codice -{: #Get_Code} - -Dopo aver completato la configurazione del tuo progetto con le funzionalità selezionate puoi scaricare il codice che ti abilita ad eseguire il codice. Il progetto scaricato è preconfigurato con le credenziali e le dipendenze SDK richieste per ogni funzionalità che hai configurato. - -Avrai bisogno di completare le credenziali per i servizi che non sono configurabili nel tuo progetto scaricato. Il file `README.md` per il progetto starter contiene le istruzioni. Visualizza il file `README.md` in un visualizzatore Markdown per completare la configurazione. - -## Strumenti per sviluppatori prerequisiti -{: #prereq-dev-tools} - -I seguenti strumenti per sviluppatori sono necessari quando stai lavorando con il codice generato dalla {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}: - - -### Generale -{: #general notoc} - -* [Homebrew ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://brew.sh/) - * Uno strumento di riga di comando per assisterti durante l'installazione di altri runtime e strumenti, come CocoaPods e Carthage, per gli sviluppatori Apple. - -* [Docker ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.docker.com/get-docker) - * Un progetto open source per il supporto nell'esecuzione e nel debug delle applicazioni nei contenitori. Necessario solo per i progetti non mobili. - -### {{site.data.keyword.Bluemix_notm}} -{: #bluemix notoc} - -* Node.js (runtime Node e npm) per assisterti durante l'esecuzione di {{site.data.keyword.apiconnect_short}} e di altri strumenti {{site.data.keyword.Bluemix_notm}} Productivity. - - Per eseguire gli strumenti {{site.data.keyword.apiconnect_short}} localmente, utilizza Node 5.x: - - ``` - $ brew install Node5 - ``` - -* [Strumenti CLI Bluemix ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://clis.ng.bluemix.net/ui/home.html) - - Strumenti della riga di comando per distribuire i runtime Cloud Foundry da una CLI (command line interface) con {{site.data.keyword.Bluemix_notm}}. - -* [{{site.data.keyword.dev_cli_notm}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](dev_cli.html) - - Plugin della CLI {{site.data.keyword.Bluemix_notm}} per creare, eseguire, verificare e distribuire i progetti mobili e web. - -* Plugin [SDK Generator ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](sdk_cli.html) - - Plugin della CLI {{site.data.keyword.Bluemix_notm}} per generare le SDK dalla tua definizione API REST conforme alla [Specifica Open API ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.openapis.org/). - -### Android -{: #android notoc} - -* [Android Studio 2.2 o superiore![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://developer.android.com/studio) - * Installa la versione più recente del runtime [Android 7.0 ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.android.com/versions/nougat-7-0/). - -### iOS -{: #ios notoc} - -* [Xcode 8 ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com/xcode/) (raccomandato) - - -* Gestore dipendenze [CocoaPods ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://cocoapods.org/) per l'installazione delle dipendenze SDK iOS. Utilizza l'ultima versione: - - ``` - $ sudo gem install cocoapods --pre - ``` -* Gestore dipendenze [Carthage ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/Carthage/Carthage) per l'installazione delle SDK {{site.data.keyword.watson}} Developer Cloud. - - ``` - $ brew install carthage - ``` +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-18" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# Richiama codice +{: #Get_Code} + +Dopo aver completato la configurazione del tuo progetto con le funzionalità selezionate puoi scaricare il codice che ti abilita ad eseguire il codice. Il progetto scaricato è preconfigurato con le credenziali e le dipendenze SDK richieste per ogni funzionalità che hai configurato. + +Avrai bisogno di completare le credenziali per i servizi che non sono configurabili nel tuo progetto scaricato. Il file `README.md` per il progetto starter contiene le istruzioni. Visualizza il file `README.md` in un visualizzatore Markdown per completare la configurazione. + +## Strumenti per sviluppatori prerequisiti +{: #prereq-dev-tools} + +I seguenti strumenti per sviluppatori sono necessari quando stai lavorando con il codice generato dalla {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}: + + +### Generale +{: #general notoc} + +* [Homebrew ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://brew.sh/) + * Uno strumento di riga di comando per assisterti durante l'installazione di altri runtime e strumenti, come CocoaPods e Carthage, per gli sviluppatori Apple. + +* [Docker ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.docker.com/get-docker) + * Un progetto open source per il supporto nell'esecuzione e nel debug delle applicazioni nei contenitori. Necessario solo per i progetti non mobili. + +### {{site.data.keyword.Bluemix_notm}} +{: #bluemix notoc} + +* Node.js (runtime Node e npm) per assisterti durante l'esecuzione di {{site.data.keyword.apiconnect_short}} e di altri strumenti {{site.data.keyword.Bluemix_notm}} Productivity. + + Per eseguire gli strumenti {{site.data.keyword.apiconnect_short}} localmente, utilizza Node 5.x: + + ``` + $ brew install Node5 + ``` + +* [Strumenti CLI Bluemix ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://clis.ng.bluemix.net/ui/home.html) + + Strumenti della riga di comando per distribuire i runtime Cloud Foundry da una CLI (command line interface) con {{site.data.keyword.Bluemix_notm}}. + +* [{{site.data.keyword.dev_cli_notm}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](dev_cli.html) + + Plugin della CLI {{site.data.keyword.Bluemix_notm}} per creare, eseguire, verificare e distribuire i progetti mobili e web. + +* Plugin [SDK Generator ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](sdk_cli.html) + + Plugin della CLI {{site.data.keyword.Bluemix_notm}} per generare le SDK dalla tua definizione API REST conforme alla [Specifica Open API ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.openapis.org/). + +### Android +{: #android notoc} + +* [Android Studio 2.2 o superiore![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://developer.android.com/studio) + * Installa la versione più recente del runtime [Android 7.0 ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.android.com/versions/nougat-7-0/). + +### iOS +{: #ios notoc} + +* [Xcode 8 ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com/xcode/) (raccomandato) + + +* Gestore dipendenze [CocoaPods ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://cocoapods.org/) per l'installazione delle dipendenze SDK iOS. Utilizza l'ultima versione: + + ``` + $ sudo gem install cocoapods --pre + ``` +* Gestore dipendenze [Carthage ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/Carthage/Carthage) per l'installazione delle SDK {{site.data.keyword.watson}} Developer Cloud. + + ``` + $ brew install carthage + ``` diff --git a/cloudnative/nl/it/index.md b/cloudnative/nl/it/index.md index 4b4a0a300..1634d3445 100644 --- a/cloudnative/nl/it/index.md +++ b/cloudnative/nl/it/index.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2016-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Creazione dei progetti nativi cloud -{: #web-mobile} - -Puoi gestire le applicazioni native cloud tramite il concetto di {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} [Progetti](projects.html). Puoi creare un progetto utilizzando la [{{site.data.keyword.dev_console}}](devex.html) o la [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) per la CLI {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}}. La {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} offre le funzionalità del servizio più comuni necessarie allo sviluppatore dell'applicazione cloud in una sola esperienza collegata che è stata ottimizzata per lo sviluppatore. - -La {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} abilita uno sviluppatore dell'applicazione nativa cloud a creare un progetto da molti [tipi di modello](patterns.html) e [starter](starters.html), a creare e collegare i servizi ottimizzati {{site.data.keyword.Bluemix_notm}} chiave al tuo progetto e a scaricare velocemente il codice di lavoro con le SDK. Le SDK sono completamente integrate con le credenziali o le dipendenze della funzionalità, questo ti abilita ad averle in esecuzione in pochi minuti. Quando la tua applicazione è in esecuzione e hai configurato le funzionalità configurate, puoi tornare al tuo progetto per monitorare e gestire il coinvolgimento dei tuoi utenti dell'applicazione. Puoi anche configurare e gestire i tuoi servizi tramite la {{site.data.keyword.dev_console}}. - - - - - - -# Link correlati -{: #rellinks notoc} - -## Esercitazioni ed esempi -{: #samples notoc} - -* [Sample: Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} -* [Video dei supporti didattici](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2016-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Creazione dei progetti nativi cloud +{: #web-mobile} + +Puoi gestire le applicazioni native cloud tramite il concetto di {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} [Progetti](projects.html). Puoi creare un progetto utilizzando la [{{site.data.keyword.dev_console}}](devex.html) o la [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) per la CLI {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}}. La {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} offre le funzionalità del servizio più comuni necessarie allo sviluppatore dell'applicazione cloud in una sola esperienza collegata che è stata ottimizzata per lo sviluppatore. + +La {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} abilita uno sviluppatore dell'applicazione nativa cloud a creare un progetto da molti [tipi di modello](patterns.html) e [starter](starters.html), a creare e collegare i servizi ottimizzati {{site.data.keyword.Bluemix_notm}} chiave al tuo progetto e a scaricare velocemente il codice di lavoro con le SDK. Le SDK sono completamente integrate con le credenziali o le dipendenze della funzionalità, questo ti abilita ad averle in esecuzione in pochi minuti. Quando la tua applicazione è in esecuzione e hai configurato le funzionalità configurate, puoi tornare al tuo progetto per monitorare e gestire il coinvolgimento dei tuoi utenti dell'applicazione. Puoi anche configurare e gestire i tuoi servizi tramite la {{site.data.keyword.dev_console}}. + + + + + + +# Link correlati +{: #rellinks notoc} + +## Esercitazioni ed esempi +{: #samples notoc} + +* [Sample: Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} +* [Video dei supporti didattici](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} diff --git a/cloudnative/nl/it/patterns.md b/cloudnative/nl/it/patterns.md index e67bff35c..c14f5411d 100644 --- a/cloudnative/nl/it/patterns.md +++ b/cloudnative/nl/it/patterns.md @@ -1,101 +1,101 @@ - ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Tipi di modello -{: #patterns} - -I modelli nativi cloud sono progetti verificati che ti supportano nel garantire una topologia affidabile, scalabile e coerente per le tue applicazioni. Quando crei un progetto, ti vengono offerti diversi tipi di modello tra cui puoi scegliere. Semplicemente seleziona il tipo di modello e le funzionalità che desideri incorporare nel tuo progetto. Dopo aver definito le tue preferenze del progetto, ti viene generato un progetto starter per la modifica, l'esecuzione o il debug e la distribuzione locale o in {{site.data.keyword.Bluemix}}. - -## Applicazione web -{: #web} - -I progetti web aggiungono la capacità di servire il contenuto web come HTML, JavaScript e i fogli di calcolo al server web. - -Sono disponibili i seguenti starter web: - -* Web di base: serve un file `index.html` statico, un foglio di calcolo vuoto e predefinito e un file JavaScript. -* WebPack: crea un progetto in cui i file di origine ECMAScript 6 (ES6) si trovano in `src/client` e vengono compilati con WebPack per renderli più piccoli e convertiti per l'utilizzo nel browser. -* Webpack + React: un framework avanzato per creare le interfacce utente. I file di origine sono in `src/client/app` e saranno compilati con WebPack e serviti nella directory pubblica. - - -## Applicazione mobile -{: #mobile} - -I modelli dell'applicazione mobile ti supportano nella creazione delle applicazioni mobili che si collegano direttamente ai servizi di backend, come ad esempio {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, -{{site.data.keyword.appid_short}} e altri ancora. I progetti possono venire aggiunti tramite sdkGen, come i BFF e i microservizi. - -Puoi scegliere da un elenco di starter, come ad esempio {{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, -{{site.data.keyword.openwhisk_short}} e altri ancora. - -Puoi generare le tue applicazioni mobili in Swift, Android o Cordova. - - -## Backend for Frontend (BFF) -{: #bff} - -I modelli Backend for Frontend, comunemente noti come BFF, ti aiutano a concentrarti sull'esposizione dei dati e dei servizi di business in modo da soddisfare i requisiti di interazione con gli utenti. Per ottimizzare l'esperienza dell'utente nella tua soluzione cloud, potrebbe essere necessaria un'esperienza utente distinta per l'applicazione mobile e un'esperienza più ricca e dettagliata per l'applicazione Web. Con l'introduzione dei dispositivi a controllo vocale come il servizio [{{site.data.keyword.conversationfull}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.ibm.com/watson/developercloud/conversation.html), l'interazione con un utente potrebbe essere controllata tramite voce. Questo canale digitale richiederà un BFF molto diverso per gestire tali interazioni basate sulla voce. - -Con {{site.data.keyword.Bluemix_notm}}, puoi creare un BFF utilizzando l'approccio di programmazione poliglotta per definire il BFF. IBM consiglia di utilizzare Node.js, Swift o Java e di eseguirli in un modello nativo del cloud con Cloud Foundry, servizi Container o senza il server. - -Il BFF gestirà l'integrazione con i servizi per la persistenza, la memorizzazione nella cache e l'integrazione dei dati con servizi di alto valore come {{site.data.keyword.ibmwatson}}, {{site.data.keyword.iot_short_notm}}, {{site.data.keyword.weather_short}} e analisi dei dati come {{site.data.keyword.sparks}}. - -Il BFF esporrà un'API utilizzando soprattutto un modello REST, ma puoi progettare il tuo BFF per lavorare da un'architettura di messaggistica mediante {{site.data.keyword.messagehub}}. - -È disponibile uno starter di base BFF utilizzando Node.js o Swift. - - -## Microservizio -{: #microservice} - -I progetti del microservizio forniscono le fondamenta per la creazione dei microservizi di backend, incluso un endpoint di integrità di base, un'API REST. I progetti generati conterranno tutte le dipendenze necessarie per lo stesso microservizio, così come per ogni servizio cloud collegato. - -È disponibile uno starter di base del microservizio utilizzando Java. - - - - -## Linguaggi -{: #languages notoc} - -I linguaggi supportati sono: - - * [Java ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](../runtimes/liberty/getting-started.html){: new_window} - * [Node.js ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](../runtimes/nodejs/getting-started.html){: new_window} - * [Swift ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](../runtimes/swift/getting-started.html){: new_window} - - -### Java -{: #java notoc} - -Java dispone di funzionalità comprovate per la creazione delle applicazioni enterprise-grade. Ma le nuove funzionalità in Java 8, combinate con runtime più leggeri come Liberty e framework come Spring Boot, rendono anche Java perfettamente adatto alla creazione dei microservizi. - - -### Node.js -{: #node notoc} - -Node.js è un runtime JavaScript che utilizza event-driven, un modello non bloccante, rendendolo più leggero ed efficiente, eccellendo per velocità effettiva e scalabilità per le applicazioni web, i modelli di backend-for-front-end e i microservizi. L'ecosistema di pacchetti Node.js, npm, fornisce l'accesso a una grande raccolta di moduli open source, fornendo un'ampia gamma di funzionalità per velocizzare lo sviluppo della tua applicazione. - - -### Swift -{: #swift notoc} - -Swift è un linguaggio di programmazione moderno creato da Apple nel 2014 progettato per sostituire l'utilizzo di Objective C ed è open source da dicembre 2015. Oggi, viene utilizzato per creare software iOS, macOS, servizi web e sistemi su sistemi operativi Linux e macOS utilizzando l'architettura x86, ARM o Z. Scrive come un linguaggio di script ma è compilato per ottenere elevate prestazioni come C- con minore sovraccarico rendendolo ideale per i runtime cloud. Utilizza un sistema del tipo statico e sicuro che visualizzi in Java ma lo stile funzionale e le routine asincrone in JavaScript. È molto performante e l'origine compila il codice nativo utilizzando la toolchain del compilatore LLVM e può facilmente utilizzare le librerie di sistema esterne scritte in C. + +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Tipi di modello +{: #patterns} + +I modelli nativi cloud sono progetti verificati che ti supportano nel garantire una topologia affidabile, scalabile e coerente per le tue applicazioni. Quando crei un progetto, ti vengono offerti diversi tipi di modello tra cui puoi scegliere. Semplicemente seleziona il tipo di modello e le funzionalità che desideri incorporare nel tuo progetto. Dopo aver definito le tue preferenze del progetto, ti viene generato un progetto starter per la modifica, l'esecuzione o il debug e la distribuzione locale o in {{site.data.keyword.Bluemix}}. + +## Applicazione web +{: #web} + +I progetti web aggiungono la capacità di servire il contenuto web come HTML, JavaScript e i fogli di calcolo al server web. + +Sono disponibili i seguenti starter web: + +* Web di base: serve un file `index.html` statico, un foglio di calcolo vuoto e predefinito e un file JavaScript. +* WebPack: crea un progetto in cui i file di origine ECMAScript 6 (ES6) si trovano in `src/client` e vengono compilati con WebPack per renderli più piccoli e convertiti per l'utilizzo nel browser. +* Webpack + React: un framework avanzato per creare le interfacce utente. I file di origine sono in `src/client/app` e saranno compilati con WebPack e serviti nella directory pubblica. + + +## Applicazione mobile +{: #mobile} + +I modelli dell'applicazione mobile ti supportano nella creazione delle applicazioni mobili che si collegano direttamente ai servizi di backend, come ad esempio {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, +{{site.data.keyword.appid_short}} e altri ancora. I progetti possono venire aggiunti tramite sdkGen, come i BFF e i microservizi. + +Puoi scegliere da un elenco di starter, come ad esempio {{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, +{{site.data.keyword.openwhisk_short}} e altri ancora. + +Puoi generare le tue applicazioni mobili in Swift, Android o Cordova. + + +## Backend for Frontend (BFF) +{: #bff} + +I modelli Backend for Frontend, comunemente noti come BFF, ti aiutano a concentrarti sull'esposizione dei dati e dei servizi di business in modo da soddisfare i requisiti di interazione con gli utenti. Per ottimizzare l'esperienza dell'utente nella tua soluzione cloud, potrebbe essere necessaria un'esperienza utente distinta per l'applicazione mobile e un'esperienza più ricca e dettagliata per l'applicazione Web. Con l'introduzione dei dispositivi a controllo vocale come il servizio [{{site.data.keyword.conversationfull}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.ibm.com/watson/developercloud/conversation.html), l'interazione con un utente potrebbe essere controllata tramite voce. Questo canale digitale richiederà un BFF molto diverso per gestire tali interazioni basate sulla voce. + +Con {{site.data.keyword.Bluemix_notm}}, puoi creare un BFF utilizzando l'approccio di programmazione poliglotta per definire il BFF. IBM consiglia di utilizzare Node.js, Swift o Java e di eseguirli in un modello nativo del cloud con Cloud Foundry, servizi Container o senza il server. + +Il BFF gestirà l'integrazione con i servizi per la persistenza, la memorizzazione nella cache e l'integrazione dei dati con servizi di alto valore come {{site.data.keyword.ibmwatson}}, {{site.data.keyword.iot_short_notm}}, {{site.data.keyword.weather_short}} e analisi dei dati come {{site.data.keyword.sparks}}. + +Il BFF esporrà un'API utilizzando soprattutto un modello REST, ma puoi progettare il tuo BFF per lavorare da un'architettura di messaggistica mediante {{site.data.keyword.messagehub}}. + +È disponibile uno starter di base BFF utilizzando Node.js o Swift. + + +## Microservizio +{: #microservice} + +I progetti del microservizio forniscono le fondamenta per la creazione dei microservizi di backend, incluso un endpoint di integrità di base, un'API REST. I progetti generati conterranno tutte le dipendenze necessarie per lo stesso microservizio, così come per ogni servizio cloud collegato. + +È disponibile uno starter di base del microservizio utilizzando Java. + + + + +## Linguaggi +{: #languages notoc} + +I linguaggi supportati sono: + + * [Java ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](../runtimes/liberty/getting-started.html){: new_window} + * [Node.js ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](../runtimes/nodejs/getting-started.html){: new_window} + * [Swift ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](../runtimes/swift/getting-started.html){: new_window} + + +### Java +{: #java notoc} + +Java dispone di funzionalità comprovate per la creazione delle applicazioni enterprise-grade. Ma le nuove funzionalità in Java 8, combinate con runtime più leggeri come Liberty e framework come Spring Boot, rendono anche Java perfettamente adatto alla creazione dei microservizi. + + +### Node.js +{: #node notoc} + +Node.js è un runtime JavaScript che utilizza event-driven, un modello non bloccante, rendendolo più leggero ed efficiente, eccellendo per velocità effettiva e scalabilità per le applicazioni web, i modelli di backend-for-front-end e i microservizi. L'ecosistema di pacchetti Node.js, npm, fornisce l'accesso a una grande raccolta di moduli open source, fornendo un'ampia gamma di funzionalità per velocizzare lo sviluppo della tua applicazione. + + +### Swift +{: #swift notoc} + +Swift è un linguaggio di programmazione moderno creato da Apple nel 2014 progettato per sostituire l'utilizzo di Objective C ed è open source da dicembre 2015. Oggi, viene utilizzato per creare software iOS, macOS, servizi web e sistemi su sistemi operativi Linux e macOS utilizzando l'architettura x86, ARM o Z. Scrive come un linguaggio di script ma è compilato per ottenere elevate prestazioni come C- con minore sovraccarico rendendolo ideale per i runtime cloud. Utilizza un sistema del tipo statico e sicuro che visualizzi in Java ma lo stile funzionale e le routine asincrone in JavaScript. È molto performante e l'origine compila il codice nativo utilizzando la toolchain del compilatore LLVM e può facilmente utilizzare le librerie di sistema esterne scritte in C. diff --git a/cloudnative/nl/it/projects.md b/cloudnative/nl/it/projects.md index 8c780d45a..a00a3189b 100644 --- a/cloudnative/nl/it/projects.md +++ b/cloudnative/nl/it/projects.md @@ -1,57 +1,57 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Progetti -{: #projects} - -La {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} combina l'interfaccia utente dell'applicazione, i dati e i servizi in un *progetto* completo. Creando un progetto, tutte le parti necessarie della tua applicazione e le funzionalità aggiunte sono conservate nel server {{site.data.keyword.Bluemix_notm}}. Puoi scaricare il tuo codice dell'applicazione e le credenziali e i programmi di inizializzazione necessari se i servizi sono configurati nel tuo progetto. Puoi visualizzare tutti i tuoi progetti selezionando **Progetti**. - -Puoi visualizzare le informazioni aggiuntive su un solo progetto selezionandolo nella pagina **Progetti**. Questa visualizza la pagina **Panoramica del progetto**, che include i servizi che sono configurati e disponibili per il progetto. I servizi sono funzionalità separate che estendono la tua applicazione aggiungendo una funzione. Poiché vengono aggiunte individualmente, puoi aggiungere i servizi di cui hai bisogno, come i servizi push, di autenticazione, dei dati e di archiviazione o altri servizi. Quando aggiungi un servizio al tuo progetto nella pagina **Panoramica progetto** e segui le istruzioni per configurarlo, viene automaticamente associato alla tua applicazione. Per ulteriori informazioni sulla Pagina progetto, vedi [Pagina Panoramica progetto](project_overview_page.html). - -Per creare il tuo progetto, devi selezionare un [modello](patterns.html), seguito da uno [starter](starters.html). - - -## Pagina Panoramica progetto -{: #project_overview} - -Puoi visualizzare e lavorare con un unico progetto {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} selezionandolo dalla pagina **Progetti**, che aprirà la pagina Panoramica progetto. -{: shortdesc} - -La pagina **Panoramica progetto** visualizza un tile per ogni funzionalità configurata o disponibile per la configurazione con il progetto selezionato. Il tile visualizza il tipo di funzionalità e un pulsante *azioni* con tre punti allineati verticalmente. Le funzionalità che potrebbero essere disponibili o configurate includono, ad esempio, {{site.data.keyword.mobilepushshort}}, Analytics o Data e Storage. Le funzionalità compatibili dipendono dal tipo di progetto e dalle funzionalità che sono disponibili in quella regione, pertanto non tutte le funzionalità potranno essere associate a ogni progetto. - -Quando un tipo di funzionalità non è ancora associata al progetto, sul tile viene visualizzato un pulsante **Crea**. Le opzioni del pulsante delle azioni comprendono la creazione di un'istanza del servizio o di aggiungerne una esistente quando la funzionalità non è ancora associata. La selezione di **Aggiungi esistente** fornisce un elenco di istanze del servizio di quel tipo nel tuo spazio. - -Se la funzionalità è già associata a questo progetto, il nome dell'istanza del servizio associato viene visualizzato sul tile dopo il tipo di funzionalità. Questo rende più facile individuare l'istanza del servizio correlata a questo progetto sulla tua {{site.data.keyword.dev_console}}. Se la funzionalità è già associata al progetto, le azioni disponibili sul relativo pulsante sono **Visualizza** e **Rimuovi**. La rimozione di un'istanza del servizio rimuove solo l'associazione a tale progetto e non elimina l'istanza del servizio dalla tua {{site.data.keyword.dev_console}}. Per eliminare un'istanza del servizio, fai clic sulla pagina **Web e mobile > Servizi** per visualizzare ed eliminare le tue istanze del servizio. - -Seleziona **Richiama codice** sul tile **Codice** per scaricare il codice per il tuo progetto. Per ulteriori informazioni sul download del codice, vedi [Richiama codice](get_code.html). - - -## Aggiornamento del tuo progetto per utilizzare un nuovo starter -{: #update-starter} - -1. Dalla pagina **Progetti** o **Panoramica progetto**, fai clic sull'icona **Menu overflow** e seleziona **Aggiorna starter**. - -2. Scegli un nuovo starter e fai clic su **Aggiorna**. - -3. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. - - In alternativa puoi fare clic sulla pagina **Codice**. - - -## Aggiornamento del tuo progetto per generare un nuovo linguaggio -{: #update-language} - -1. Dalle pagine **Progetti** o **Panoramica progetto**, fai clic sull'icona **Menu overflow** e seleziona **Aggiorna starter**. - -2. Seleziona un nuovo linguaggio e fai clic su **Aggiorna**. - -3. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Progetti +{: #projects} + +La {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} combina l'interfaccia utente dell'applicazione, i dati e i servizi in un *progetto* completo. Creando un progetto, tutte le parti necessarie della tua applicazione e le funzionalità aggiunte sono conservate nel server {{site.data.keyword.Bluemix_notm}}. Puoi scaricare il tuo codice dell'applicazione e le credenziali e i programmi di inizializzazione necessari se i servizi sono configurati nel tuo progetto. Puoi visualizzare tutti i tuoi progetti selezionando **Progetti**. + +Puoi visualizzare le informazioni aggiuntive su un solo progetto selezionandolo nella pagina **Progetti**. Questa visualizza la pagina **Panoramica del progetto**, che include i servizi che sono configurati e disponibili per il progetto. I servizi sono funzionalità separate che estendono la tua applicazione aggiungendo una funzione. Poiché vengono aggiunte individualmente, puoi aggiungere i servizi di cui hai bisogno, come i servizi push, di autenticazione, dei dati e di archiviazione o altri servizi. Quando aggiungi un servizio al tuo progetto nella pagina **Panoramica progetto** e segui le istruzioni per configurarlo, viene automaticamente associato alla tua applicazione. Per ulteriori informazioni sulla Pagina progetto, vedi [Pagina Panoramica progetto](project_overview_page.html). + +Per creare il tuo progetto, devi selezionare un [modello](patterns.html), seguito da uno [starter](starters.html). + + +## Pagina Panoramica progetto +{: #project_overview} + +Puoi visualizzare e lavorare con un unico progetto {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} selezionandolo dalla pagina **Progetti**, che aprirà la pagina Panoramica progetto. +{: shortdesc} + +La pagina **Panoramica progetto** visualizza un tile per ogni funzionalità configurata o disponibile per la configurazione con il progetto selezionato. Il tile visualizza il tipo di funzionalità e un pulsante *azioni* con tre punti allineati verticalmente. Le funzionalità che potrebbero essere disponibili o configurate includono, ad esempio, {{site.data.keyword.mobilepushshort}}, Analytics o Data e Storage. Le funzionalità compatibili dipendono dal tipo di progetto e dalle funzionalità che sono disponibili in quella regione, pertanto non tutte le funzionalità potranno essere associate a ogni progetto. + +Quando un tipo di funzionalità non è ancora associata al progetto, sul tile viene visualizzato un pulsante **Crea**. Le opzioni del pulsante delle azioni comprendono la creazione di un'istanza del servizio o di aggiungerne una esistente quando la funzionalità non è ancora associata. La selezione di **Aggiungi esistente** fornisce un elenco di istanze del servizio di quel tipo nel tuo spazio. + +Se la funzionalità è già associata a questo progetto, il nome dell'istanza del servizio associato viene visualizzato sul tile dopo il tipo di funzionalità. Questo rende più facile individuare l'istanza del servizio correlata a questo progetto sulla tua {{site.data.keyword.dev_console}}. Se la funzionalità è già associata al progetto, le azioni disponibili sul relativo pulsante sono **Visualizza** e **Rimuovi**. La rimozione di un'istanza del servizio rimuove solo l'associazione a tale progetto e non elimina l'istanza del servizio dalla tua {{site.data.keyword.dev_console}}. Per eliminare un'istanza del servizio, fai clic sulla pagina **Web e mobile > Servizi** per visualizzare ed eliminare le tue istanze del servizio. + +Seleziona **Richiama codice** sul tile **Codice** per scaricare il codice per il tuo progetto. Per ulteriori informazioni sul download del codice, vedi [Richiama codice](get_code.html). + + +## Aggiornamento del tuo progetto per utilizzare un nuovo starter +{: #update-starter} + +1. Dalla pagina **Progetti** o **Panoramica progetto**, fai clic sull'icona **Menu overflow** e seleziona **Aggiorna starter**. + +2. Scegli un nuovo starter e fai clic su **Aggiorna**. + +3. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. + + In alternativa puoi fare clic sulla pagina **Codice**. + + +## Aggiornamento del tuo progetto per generare un nuovo linguaggio +{: #update-language} + +1. Dalle pagine **Progetti** o **Panoramica progetto**, fai clic sull'icona **Menu overflow** e seleziona **Aggiorna starter**. + +2. Seleziona un nuovo linguaggio e fai clic su **Aggiorna**. + +3. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. diff --git a/cloudnative/nl/it/sdk.md b/cloudnative/nl/it/sdk.md index e63274678..7d86a7c0e 100644 --- a/cloudnative/nl/it/sdk.md +++ b/cloudnative/nl/it/sdk.md @@ -1,67 +1,67 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-17" - ---- -# SDK -{: #sdk} - -Per aggiungere gli SDK di {{site.data.keyword.Bluemix}} Mobile Services alla tua applicazione, scegli gli SDK che vuoi utilizzare e configura quindi il gestore dipendenze per introdurre gli SDK nella tua applicazione. - - -## SDK client -{: #client_sdk} - -Puoi utilizzare le seguenti SDK nella tua applicazione mobile per sfruttare le rispettive funzionalità. - - -### SDK Android -{: #android_sdk} - -- [SDK Core ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) -- [SDK {{site.data.keyword.mobileanalytics_short}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) -- [SDK {{site.data.keyword.mobilepushshort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) -- [SDK autenticazione Facebook ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) -- [SDK autenticazione Google ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) - - -### SDK iOS -{: #ios_sdk} - -- [SDK Core ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) -- [SDK {{site.data.keyword.mobileanalytics_short}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) -- [SDK {{site.data.keyword.mobilepushshort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) -- [SDK autenticazione Facebook ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) -- [SDK autenticazione Google ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) -- [SDK {{site.data.keyword.amashort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) - - -### Plug-in Cordova -{: #cordova_plugin} - -- [Plug-in Core ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) -- [Plug-in {{site.data.keyword.mobilepushshort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## SDK server -{: #server_sdk} - -Se hai un'applicaizone server Java, NodeJS o Swift, puoi utilizzare le seguenti SDK per comunicare con i rispettivi servizi. - - -### {{site.data.keyword.mobilepushshort}} SDK server -{: #push_sdk} - -- [{{site.data.keyword.mobilepushshort}} SDK server Java ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) -- [{{site.data.keyword.mobilepushshort}}SDK server Swift ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) -- [{{site.data.keyword.mobilepushshort}}SDK server NodeJS ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) - - -### SDK server {{site.data.keyword.amashort}} -{: #mca_sdk} - -- [{{site.data.keyword.amashort}}SDK server Swift ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) - - +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-17" + +--- +# SDK +{: #sdk} + +Per aggiungere gli SDK di {{site.data.keyword.Bluemix}} Mobile Services alla tua applicazione, scegli gli SDK che vuoi utilizzare e configura quindi il gestore dipendenze per introdurre gli SDK nella tua applicazione. + + +## SDK client +{: #client_sdk} + +Puoi utilizzare le seguenti SDK nella tua applicazione mobile per sfruttare le rispettive funzionalità. + + +### SDK Android +{: #android_sdk} + +- [SDK Core ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) +- [SDK {{site.data.keyword.mobileanalytics_short}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) +- [SDK {{site.data.keyword.mobilepushshort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) +- [SDK autenticazione Facebook ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) +- [SDK autenticazione Google ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) + + +### SDK iOS +{: #ios_sdk} + +- [SDK Core ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) +- [SDK {{site.data.keyword.mobileanalytics_short}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) +- [SDK {{site.data.keyword.mobilepushshort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) +- [SDK autenticazione Facebook ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) +- [SDK autenticazione Google ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) +- [SDK {{site.data.keyword.amashort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) + + +### Plug-in Cordova +{: #cordova_plugin} + +- [Plug-in Core ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) +- [Plug-in {{site.data.keyword.mobilepushshort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## SDK server +{: #server_sdk} + +Se hai un'applicaizone server Java, NodeJS o Swift, puoi utilizzare le seguenti SDK per comunicare con i rispettivi servizi. + + +### {{site.data.keyword.mobilepushshort}} SDK server +{: #push_sdk} + +- [{{site.data.keyword.mobilepushshort}} SDK server Java ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) +- [{{site.data.keyword.mobilepushshort}}SDK server Swift ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) +- [{{site.data.keyword.mobilepushshort}}SDK server NodeJS ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) + + +### SDK server {{site.data.keyword.amashort}} +{: #mca_sdk} + +- [{{site.data.keyword.amashort}}SDK server Swift ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) + + diff --git a/cloudnative/nl/it/sdk_BMSClient.md b/cloudnative/nl/it/sdk_BMSClient.md index 6c8779178..277bb6e58 100644 --- a/cloudnative/nl/it/sdk_BMSClient.md +++ b/cloudnative/nl/it/sdk_BMSClient.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Inizializzazione di BMSClient -{: #sdk_BMSClient} - -`BMSCore` fornisce l'infrastruttura HTTP che le altre SDK client dei servizi {{site.data.keyword.Bluemix}} Mobile utilizzano per comunicare con i loro servizi {{site.data.keyword.Bluemix_notm}} corrispondenti. - - -## Inizializzazione della tua applicazione Android -{: #init-BMSClient-android} - -Puoi sia scaricare che importare il pacchetto `BMSCore` del tuo progetto Android Studio o utilizzare Gradle. - -1. Importa l'SDK client aggiungendo la seguente istruzione `import` all'inizio del file del progetto: - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; - ``` - {: codeblock} - -2. Inizializza l'SDK `BMSClient` nella tua applicazione Android aggiungendo il codice di inizializzazione nel metodo `onCreate` dell'attività principale nell'applicazione Android o in un'ubicazione che ritieni più adatta per il tuo progetto. - - ```Java - BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Assicurati che punti alla tua regione - ``` - {: codeblock} - - Devi inizializzare il `BMSClient` con il parametro **bluemixRegion**. Nel programma di inizializzazione, il valore **bluemixRegion** specifica quale distribuzione {{site.data.keyword.Bluemix_notm}} stai utilizzando, ad esempio `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` o `BMSClient.REGION_SYDNEY`. - - -## Inizializzazione della tua applicazione iOS -{: #init-BMSClient-ios} - -Puoi utilizzare [CocoaPods](https://cocoapods.org){: new_window} o [Carthage](https://github.com/Carthage/Carthage){: new_window} per ottenere il pacchetto `BMSCore`. - -1. Per installare `BMSCore` utilizzando CocoaPods, aggiungi le seguenti linee al tuo Podfile. Se il tuo progetto non dispone ancora di un Podfile, utilizza il comando `pod init`. - - ```Swift - use_frameworks! - - target 'MyApp' do - pod 'BMSCore' - end - ``` - {: codeblock} - - Quindi esegui il comando `pod install` e apri il file `.xcworkspace` generato. Per l'aggiornamento a una release più recente di `BMSCore`, utilizza `pod update BMSCore`. - - Per ulteriori informazioni sull'utilizzo di CocoaPods, consulta [CocoaPods Guides ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://guides.cocoapods.org/using/index.html){: new_window}. - -2. Per installare `BMSCore` utilizzando Carthage, segui queste [istruzioni ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/Carthage/Carthage#getting-started){: new_window}. - - 1. Aggiungi la seguente linea al tuo Cartfile: - - ``` - github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" - ``` - {: codeblock} - - 2. Esegui il comando `carthage update`. - - 3. Dopo aver terminato la build, aggiungi `BMSCore.framework` al tuo progetto seguendo il [Passo 3 ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/Carthage/Carthage#getting-started) nelle istruzioni Carthage. - - Per le applicazioni che sono generate con Swift 2.3, utilizza il comando `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3`. Altrimenti, utilizza il comando `carthage update`. - -3. Importa il modulo. - - ```Swift - import BMSCore - ``` - {: codeblock} - -4. Inizializza la classe `BMSClient`, utilizzando il seguente codice. - - Posiziona il codice di inizializzazione nel metodo `application(_:didFinishLaunchingWithOptions:)` nel tuo delegato dell'applicazione o in un'ubicazione che ritieni più adatta per il tuo progetto. - - ```Swift - BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Assicurati che punti alla tua regione - ``` - {: codeblock} - - Devi inizializzare il `BMSClient` con il parametro **bluemixRegion**. Nel programma di inizializzazione, il valore **bluemixRegion** specifica quale distribuzione {{site.data.keyword.Bluemix_notm}} stai utilizzando, ad esempio `BMSClient.Region.usSouth`, `BMSClient.Region.unitedKingdom` o `BMSClient.Region.sydney`. - - -## Inizializzazione della tua applicazione Cordova -{: #init-BMSClient-cordova} - -1. Aggiungi il plugin Cordova eseguendo questo comando dalla directory root della tua applicazione Cordova: - - ``` - cordova plugin add bms-core - ``` - {: codeblock} - -2. Inizializza la classe `BMSClient` nella tua applicazione Cordova aggiungendo il codice di inizializzazione nel file JavaScript principale o in un'ubicazione che ritieni più adatta per il tuo progetto. - - ``` - BMSClient.initialize(BMSClient.REGION_US_SOUTH); - ``` - {: codeblock} - - Devi inizializzare il `BMSClient` con il parametro **bluemixRegion**. Nel programma di inizializzazione, il valore **bluemixRegion** specifica quale distribuzione {{site.data.keyword.Bluemix_notm}} stai utilizzando, ad esempio `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` o `BMSClient.REGION_SYDNEY`. - - -# Link correlati -{: #rellinks notoc} - -## Link correlati -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Inizializzazione di BMSClient +{: #sdk_BMSClient} + +`BMSCore` fornisce l'infrastruttura HTTP che le altre SDK client dei servizi {{site.data.keyword.Bluemix}} Mobile utilizzano per comunicare con i loro servizi {{site.data.keyword.Bluemix_notm}} corrispondenti. + + +## Inizializzazione della tua applicazione Android +{: #init-BMSClient-android} + +Puoi sia scaricare che importare il pacchetto `BMSCore` del tuo progetto Android Studio o utilizzare Gradle. + +1. Importa l'SDK client aggiungendo la seguente istruzione `import` all'inizio del file del progetto: + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; + ``` + {: codeblock} + +2. Inizializza l'SDK `BMSClient` nella tua applicazione Android aggiungendo il codice di inizializzazione nel metodo `onCreate` dell'attività principale nell'applicazione Android o in un'ubicazione che ritieni più adatta per il tuo progetto. + + ```Java + BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Assicurati che punti alla tua regione + ``` + {: codeblock} + + Devi inizializzare il `BMSClient` con il parametro **bluemixRegion**. Nel programma di inizializzazione, il valore **bluemixRegion** specifica quale distribuzione {{site.data.keyword.Bluemix_notm}} stai utilizzando, ad esempio `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` o `BMSClient.REGION_SYDNEY`. + + +## Inizializzazione della tua applicazione iOS +{: #init-BMSClient-ios} + +Puoi utilizzare [CocoaPods](https://cocoapods.org){: new_window} o [Carthage](https://github.com/Carthage/Carthage){: new_window} per ottenere il pacchetto `BMSCore`. + +1. Per installare `BMSCore` utilizzando CocoaPods, aggiungi le seguenti linee al tuo Podfile. Se il tuo progetto non dispone ancora di un Podfile, utilizza il comando `pod init`. + + ```Swift + use_frameworks! + + target 'MyApp' do + pod 'BMSCore' + end + ``` + {: codeblock} + + Quindi esegui il comando `pod install` e apri il file `.xcworkspace` generato. Per l'aggiornamento a una release più recente di `BMSCore`, utilizza `pod update BMSCore`. + + Per ulteriori informazioni sull'utilizzo di CocoaPods, consulta [CocoaPods Guides ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://guides.cocoapods.org/using/index.html){: new_window}. + +2. Per installare `BMSCore` utilizzando Carthage, segui queste [istruzioni ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/Carthage/Carthage#getting-started){: new_window}. + + 1. Aggiungi la seguente linea al tuo Cartfile: + + ``` + github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" + ``` + {: codeblock} + + 2. Esegui il comando `carthage update`. + + 3. Dopo aver terminato la build, aggiungi `BMSCore.framework` al tuo progetto seguendo il [Passo 3 ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://github.com/Carthage/Carthage#getting-started) nelle istruzioni Carthage. + + Per le applicazioni che sono generate con Swift 2.3, utilizza il comando `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3`. Altrimenti, utilizza il comando `carthage update`. + +3. Importa il modulo. + + ```Swift + import BMSCore + ``` + {: codeblock} + +4. Inizializza la classe `BMSClient`, utilizzando il seguente codice. + + Posiziona il codice di inizializzazione nel metodo `application(_:didFinishLaunchingWithOptions:)` nel tuo delegato dell'applicazione o in un'ubicazione che ritieni più adatta per il tuo progetto. + + ```Swift + BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Assicurati che punti alla tua regione + ``` + {: codeblock} + + Devi inizializzare il `BMSClient` con il parametro **bluemixRegion**. Nel programma di inizializzazione, il valore **bluemixRegion** specifica quale distribuzione {{site.data.keyword.Bluemix_notm}} stai utilizzando, ad esempio `BMSClient.Region.usSouth`, `BMSClient.Region.unitedKingdom` o `BMSClient.Region.sydney`. + + +## Inizializzazione della tua applicazione Cordova +{: #init-BMSClient-cordova} + +1. Aggiungi il plugin Cordova eseguendo questo comando dalla directory root della tua applicazione Cordova: + + ``` + cordova plugin add bms-core + ``` + {: codeblock} + +2. Inizializza la classe `BMSClient` nella tua applicazione Cordova aggiungendo il codice di inizializzazione nel file JavaScript principale o in un'ubicazione che ritieni più adatta per il tuo progetto. + + ``` + BMSClient.initialize(BMSClient.REGION_US_SOUTH); + ``` + {: codeblock} + + Devi inizializzare il `BMSClient` con il parametro **bluemixRegion**. Nel programma di inizializzazione, il valore **bluemixRegion** specifica quale distribuzione {{site.data.keyword.Bluemix_notm}} stai utilizzando, ad esempio `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` o `BMSClient.REGION_SYDNEY`. + + +# Link correlati +{: #rellinks notoc} + +## Link correlati +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/it/sdk_cli.md b/cloudnative/nl/it/sdk_cli.md index c7e8bbf37..a1f03cb32 100644 --- a/cloudnative/nl/it/sdk_cli.md +++ b/cloudnative/nl/it/sdk_cli.md @@ -1,178 +1,178 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Plugin SDK Generator -{: #sdk-cli} - -Il plug-in {{site.data.keyword.IBM}} SDK Generator può essere installato nella CLI [{{site.data.keyword.Bluemix_notm}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/cli/reference/bluemix_cli/index.html). - -In qualità di sviluppatore in {{site.data.keyword.Bluemix_notm}}, puoi utilizzare questo plug-in per generare gli SDK dalla tua definizione API REST conforme alla [Specifica Open API ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.openapis.org/). Quando apporti modifiche alla tua definizione API REST, puoi utilizzare il plug-in per rigenerare solo l'SDK anziché rigenerare l'intero progetto. - -Puoi anche vedere se le tue applicazioni Cloud Foundry in un determinato spazio hanno definizioni API REST valide per la generazione dell'SDK. Infine, puoi utilizzare il plug-in {{site.data.keyword.IBM_notm}} SDK Generator per convalidare qualsiasi definizione API REST al fine di garantire che siano conformi ai requisiti del generatore SDK. - -Questo plug-in {{site.data.keyword.IBM_notm}} SDK Generator ti consente di integrare facilmente i tuoi servizi di backend alla tua applicazione con un SDK generato. Quando viene apportata una modifica a un'API REST, puoi rigenerare l'SDK e sostituire quello vecchio per un aggiornamento SDK senza interruzioni. Puoi anche integrare la CLI in una pipeline DevOps e garantire che l'SDK sia sempre conforme alla specifica API ogni volta che l'applicazione viene creata. - -La definizione API REST deve essere valida e deve essere ospitata su un endpoint server live o in un file locale sul tuo sistema. Se la definizione API REST è ospitata, l'URL relativo deve essere definito nella variabile di ambiente `OPENAPI_SPEC`. - - -## Requisiti -{: #prereqs} - -Assicurati di soddisfare i seguenti requisiti. - -* Disponi di un account [{{site.data.keyword.Bluemix_notm}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://bluemix.net) -* Hai una definizione API valida conforme alla specifica [Open API ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.openapis.org/) - - -## Installazione -{: #installation} - -1. [Installa la CLI {{site.data.keyword.Bluemix}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://clis.ng.bluemix.net/ui/home.html). - -2. [Installa il plug-in ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in). - - ``` - bx plugin install sdk-gen -r Bluemix - ``` - {: codeblock} - - -## Comandi -{: #commands} - -Utilizza i seguenti comandi per generare un SDK, per convalidare i file di definizione Open API o per elencare le applicazioni Cloud Foundry. - - -### Generazione di un SDK -{: #gen} - -Use `bluemix sdk generate [arguments...][command options]`. - - -#### Argomenti -{: #gen-args} - -* `APP_NAME` - il nome dell'applicazione Cloud Foundry nel tuo spazio corrente -* `OPENAPI_DOC_LOCATION` - un URL o percorso file relativo al JSON o Yaml della definizione API REST non elaborata -* `GENERATED_SDK_NAME` (facoltativo) - il nome dell'SDK generato - - -#### Opzioni -{: #gen-options} - -* `PLATFORM` (obbligatorio) - * `--android` - genera un SDK Android - * `--ios` - genera un SDK iOS Swift - * `--swift` - genera un SDK server Swift -* `--output "YOUR_RELATIVE_PATH"` (facoltativo) - inserisce l'SDK generato nella directory specificata da `YOUR_RELATIVE_PATH` (sovrascrive l'SDK esistente, se presente) -* `--unzip` (facoltativo) - estrae l'SDK generato (sovrascrive le risorse SDK esistenti, se presenti) - - -#### Utilizzo -{: #gen-usage} - -Per generare un SDK da un'applicazione Cloud Foundry in esecuzione in {{site.data.keyword.Bluemix_notm}}, puoi utilizzare il nome dell'applicazione come parametro nella CLI. Il seguente comando utilizza il nome dell'applicazione come `SDK_Name`. - -``` -bluemix sdk generate [APP_NAME] [PLATFORM] -``` -{: codeblock} - -Per generare un SDK da un URL di un file di definizione Open API o un file JSON o Yaml locale, utilizza il seguente comando. - -``` -bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] -``` -{: codeblock} - - -### Convalida delle definizioni API Open -{: #validating} - -Utilizza `bluemix sdk validate [argument]`. - - -#### Argomenti -{: #val-args} - -* `APP_NAME` - il nome dell'applicazione Cloud Foundry nel tuo spazio corrente -* `OPENAPI_DOC_LOCATION` - un URL o percorso file relativo al JSON o Yaml della definizione API REST non elaborata - - -#### Utilizzo -{: #val-usage} - -Per convalidare la specifica API di un'applicazione Cloud Foundry in esecuzione in {{site.data.keyword.Bluemix_notm}}, puoi utilizzare il nome dell'applicazione come parametro nella CLI. - -``` -bluemix sdk validate [APP_NAME] -``` -{: codeblock} - -Per convalidare un SDK dall'URL di un documento di specifiche API o un file JSON o Yaml locale, utilizza il seguente comando. - -``` -bluemix sdk validate [OPENAPI_DOC_LOCATION] -``` -{: codeblock} - - - -### Elenca applicazioni (Cloud Foundry) -{: #list-apps} - -Utilizza `bluemix sdk list [argument][option]` per elencare le applicazioni e convalidare le specifiche API. Devi impostare la variabile di ambiente `OPENAPI_SPEC` sul percorso URL relativo che ospita la tua specifica. - - -#### Argomenti -{: #list-args} - -* `SPACE_NAME` (facoltativo) - il nome dello spazio Cloud Foundry all'interno della tua organizzazione in cui ricercare le applicazioni. Se non viene fornito, la ricerca avviene nello spazio corrente. - - -#### Opzioni -{: #list-options} - -* `--url` (facoltativo) - visualizza un URL completamente formato della definizione Open API per ogni applicazione nell'elenco - - -#### Utilizzo -{: #list-usage} - -Per elencare le applicazioni nello spazio corrente, utilizza il seguente comando. - -``` -bluemix sdk list -``` -{: codeblock} - -Per elencare le applicazioni nello spazio corrente e visualizzare l'URL della specifica API, utilizza il seguente comando. - -``` -bluemix sdk list --url -``` -{: codeblock} - -Per elencare le applicazioni in uno specifico spazio, utilizza il seguente comando. - -``` -bluemix sdk list [SPACE_NAME] -``` -{: codeblock} - -Per elencare le applicazioni in uno specifico spazio e visualizzare l'URL della specifica API, utilizza il seguente comando. - -``` -bluemix sdk list [SPACE_NAME] --url -``` -{: codeblock} +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Plugin SDK Generator +{: #sdk-cli} + +Il plug-in {{site.data.keyword.IBM}} SDK Generator può essere installato nella CLI [{{site.data.keyword.Bluemix_notm}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/cli/reference/bluemix_cli/index.html). + +In qualità di sviluppatore in {{site.data.keyword.Bluemix_notm}}, puoi utilizzare questo plug-in per generare gli SDK dalla tua definizione API REST conforme alla [Specifica Open API ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.openapis.org/). Quando apporti modifiche alla tua definizione API REST, puoi utilizzare il plug-in per rigenerare solo l'SDK anziché rigenerare l'intero progetto. + +Puoi anche vedere se le tue applicazioni Cloud Foundry in un determinato spazio hanno definizioni API REST valide per la generazione dell'SDK. Infine, puoi utilizzare il plug-in {{site.data.keyword.IBM_notm}} SDK Generator per convalidare qualsiasi definizione API REST al fine di garantire che siano conformi ai requisiti del generatore SDK. + +Questo plug-in {{site.data.keyword.IBM_notm}} SDK Generator ti consente di integrare facilmente i tuoi servizi di backend alla tua applicazione con un SDK generato. Quando viene apportata una modifica a un'API REST, puoi rigenerare l'SDK e sostituire quello vecchio per un aggiornamento SDK senza interruzioni. Puoi anche integrare la CLI in una pipeline DevOps e garantire che l'SDK sia sempre conforme alla specifica API ogni volta che l'applicazione viene creata. + +La definizione API REST deve essere valida e deve essere ospitata su un endpoint server live o in un file locale sul tuo sistema. Se la definizione API REST è ospitata, l'URL relativo deve essere definito nella variabile di ambiente `OPENAPI_SPEC`. + + +## Requisiti +{: #prereqs} + +Assicurati di soddisfare i seguenti requisiti. + +* Disponi di un account [{{site.data.keyword.Bluemix_notm}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://bluemix.net) +* Hai una definizione API valida conforme alla specifica [Open API ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.openapis.org/) + + +## Installazione +{: #installation} + +1. [Installa la CLI {{site.data.keyword.Bluemix}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://clis.ng.bluemix.net/ui/home.html). + +2. [Installa il plug-in ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in). + + ``` + bx plugin install sdk-gen -r Bluemix + ``` + {: codeblock} + + +## Comandi +{: #commands} + +Utilizza i seguenti comandi per generare un SDK, per convalidare i file di definizione Open API o per elencare le applicazioni Cloud Foundry. + + +### Generazione di un SDK +{: #gen} + +Use `bluemix sdk generate [arguments...][command options]`. + + +#### Argomenti +{: #gen-args} + +* `APP_NAME` - il nome dell'applicazione Cloud Foundry nel tuo spazio corrente +* `OPENAPI_DOC_LOCATION` - un URL o percorso file relativo al JSON o Yaml della definizione API REST non elaborata +* `GENERATED_SDK_NAME` (facoltativo) - il nome dell'SDK generato + + +#### Opzioni +{: #gen-options} + +* `PLATFORM` (obbligatorio) + * `--android` - genera un SDK Android + * `--ios` - genera un SDK iOS Swift + * `--swift` - genera un SDK server Swift +* `--output "YOUR_RELATIVE_PATH"` (facoltativo) - inserisce l'SDK generato nella directory specificata da `YOUR_RELATIVE_PATH` (sovrascrive l'SDK esistente, se presente) +* `--unzip` (facoltativo) - estrae l'SDK generato (sovrascrive le risorse SDK esistenti, se presenti) + + +#### Utilizzo +{: #gen-usage} + +Per generare un SDK da un'applicazione Cloud Foundry in esecuzione in {{site.data.keyword.Bluemix_notm}}, puoi utilizzare il nome dell'applicazione come parametro nella CLI. Il seguente comando utilizza il nome dell'applicazione come `SDK_Name`. + +``` +bluemix sdk generate [APP_NAME] [PLATFORM] +``` +{: codeblock} + +Per generare un SDK da un URL di un file di definizione Open API o un file JSON o Yaml locale, utilizza il seguente comando. + +``` +bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] +``` +{: codeblock} + + +### Convalida delle definizioni API Open +{: #validating} + +Utilizza `bluemix sdk validate [argument]`. + + +#### Argomenti +{: #val-args} + +* `APP_NAME` - il nome dell'applicazione Cloud Foundry nel tuo spazio corrente +* `OPENAPI_DOC_LOCATION` - un URL o percorso file relativo al JSON o Yaml della definizione API REST non elaborata + + +#### Utilizzo +{: #val-usage} + +Per convalidare la specifica API di un'applicazione Cloud Foundry in esecuzione in {{site.data.keyword.Bluemix_notm}}, puoi utilizzare il nome dell'applicazione come parametro nella CLI. + +``` +bluemix sdk validate [APP_NAME] +``` +{: codeblock} + +Per convalidare un SDK dall'URL di un documento di specifiche API o un file JSON o Yaml locale, utilizza il seguente comando. + +``` +bluemix sdk validate [OPENAPI_DOC_LOCATION] +``` +{: codeblock} + + + +### Elenca applicazioni (Cloud Foundry) +{: #list-apps} + +Utilizza `bluemix sdk list [argument][option]` per elencare le applicazioni e convalidare le specifiche API. Devi impostare la variabile di ambiente `OPENAPI_SPEC` sul percorso URL relativo che ospita la tua specifica. + + +#### Argomenti +{: #list-args} + +* `SPACE_NAME` (facoltativo) - il nome dello spazio Cloud Foundry all'interno della tua organizzazione in cui ricercare le applicazioni. Se non viene fornito, la ricerca avviene nello spazio corrente. + + +#### Opzioni +{: #list-options} + +* `--url` (facoltativo) - visualizza un URL completamente formato della definizione Open API per ogni applicazione nell'elenco + + +#### Utilizzo +{: #list-usage} + +Per elencare le applicazioni nello spazio corrente, utilizza il seguente comando. + +``` +bluemix sdk list +``` +{: codeblock} + +Per elencare le applicazioni nello spazio corrente e visualizzare l'URL della specifica API, utilizza il seguente comando. + +``` +bluemix sdk list --url +``` +{: codeblock} + +Per elencare le applicazioni in uno specifico spazio, utilizza il seguente comando. + +``` +bluemix sdk list [SPACE_NAME] +``` +{: codeblock} + +Per elencare le applicazioni in uno specifico spazio e visualizzare l'URL della specifica API, utilizza il seguente comando. + +``` +bluemix sdk list [SPACE_NAME] --url +``` +{: codeblock} diff --git a/cloudnative/nl/it/sdk_network_request.md b/cloudnative/nl/it/sdk_network_request.md index 26c76635b..92a4132b0 100644 --- a/cloudnative/nl/it/sdk_network_request.md +++ b/cloudnative/nl/it/sdk_network_request.md @@ -1,121 +1,121 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Effettuazione di una richiesta di rete -{: #sdk-network-request} - -Puoi utilizzare l'SDK `BMSCore` per effettuare richieste di rete a qualsiasi risorsa. - -## Android -{: #request-android} - -1. Assicurati di aver [importato e inizializzato l'SDK Client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android) nella tua applicazione Android. - -2. Effettua una richiesta di rete. - - ``` - public void makeGetCall() { - Thread thread = new Thread(new Runnable() { - @Override - public void run() { - try { - Request request = new Request("http://httpbin.org/get", "GET"); - request.send(null, null); - } catch (Exception e) { - // Handle failure here. - } - } - }); - thread.start(); - } - ``` - {: codeblock} - -## iOS -{: #request-ios} - -1. Assicurati di aver [importato e inizializzato l'SDK Client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios) nella tua applicazione iOS. - -2. Crea una richiesta di rete. - - ### Swift 3.0 - {: #ios-swift3 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - - ### Swift 2.2 - {: #ios-swift22 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - -La classe `Request` rappresenta un metodo semplice per effettuare una richiesta HTTP e ottenere la risposta al completamento della richiesta. Se vuoi più flessibilità e controllo rispetto a quello ottenuto con `Request`, puoi utilizzare la classe `BMSURLSession`. Alcune funzioni della classe `BMSURLSession` comprendono il monitoraggio dell'avanzamento dei caricamenti e la messa in pausa o l'annullamento delle richieste. Per ottenere le risposte, hai la possibilità di scegliere i gestori o i delegati di completamento. - -La classe `BMSURLSession` è disponibile solo per iOS. Per ulteriori informazioni su `BMSURLSession`, consulta il [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) dell'SDK `BMSCore`. - - -## Cordova -{: #request-cordova} - -1. Assicurati di aver [importato e inizializzato l'SDK Client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova) nella tua applicazione Cordova. - -2. Crea una richiesta di rete. - - ``` - var success = function(data) { - console.log("success", data); - } - var failure = function(error) - {console.log("failure", error); - } - var request = new BMSRequest("", BMSRequest.GET); - request.send(success, failure); - ``` - {: codeblock} - - -# Link correlati -{: #rellinks notoc} - -## Link correlati -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Effettuazione di una richiesta di rete +{: #sdk-network-request} + +Puoi utilizzare l'SDK `BMSCore` per effettuare richieste di rete a qualsiasi risorsa. + +## Android +{: #request-android} + +1. Assicurati di aver [importato e inizializzato l'SDK Client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android) nella tua applicazione Android. + +2. Effettua una richiesta di rete. + + ``` + public void makeGetCall() { + Thread thread = new Thread(new Runnable() { + @Override + public void run() { + try { + Request request = new Request("http://httpbin.org/get", "GET"); + request.send(null, null); + } catch (Exception e) { + // Handle failure here. + } + } + }); + thread.start(); + } + ``` + {: codeblock} + +## iOS +{: #request-ios} + +1. Assicurati di aver [importato e inizializzato l'SDK Client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios) nella tua applicazione iOS. + +2. Crea una richiesta di rete. + + ### Swift 3.0 + {: #ios-swift3 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + + ### Swift 2.2 + {: #ios-swift22 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + +La classe `Request` rappresenta un metodo semplice per effettuare una richiesta HTTP e ottenere la risposta al completamento della richiesta. Se vuoi più flessibilità e controllo rispetto a quello ottenuto con `Request`, puoi utilizzare la classe `BMSURLSession`. Alcune funzioni della classe `BMSURLSession` comprendono il monitoraggio dell'avanzamento dei caricamenti e la messa in pausa o l'annullamento delle richieste. Per ottenere le risposte, hai la possibilità di scegliere i gestori o i delegati di completamento. + +La classe `BMSURLSession` è disponibile solo per iOS. Per ulteriori informazioni su `BMSURLSession`, consulta il [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) dell'SDK `BMSCore`. + + +## Cordova +{: #request-cordova} + +1. Assicurati di aver [importato e inizializzato l'SDK Client](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova) nella tua applicazione Cordova. + +2. Crea una richiesta di rete. + + ``` + var success = function(data) { + console.log("success", data); + } + var failure = function(error) + {console.log("failure", error); + } + var request = new BMSRequest("", BMSRequest.GET); + request.send(success, failure); + ``` + {: codeblock} + + +# Link correlati +{: #rellinks notoc} + +## Link correlati +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/it/services.md b/cloudnative/nl/it/services.md index 0e12cf501..dcc5a8592 100644 --- a/cloudnative/nl/it/services.md +++ b/cloudnative/nl/it/services.md @@ -1,54 +1,54 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# Servizi -{: #services} - -Dalla pagina {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} **Servizi**, puoi visualizzare i servizi mobili e web esistenti o crearne di nuovi. La console fornisce una sola ubicazione per visualizzare tutti i servizi web e mobili {{site.data.keyword.Bluemix_notm}} che stanno venendo gestiti dai progetti. - -Se elimini dei servizi dalla vista **Servizi**, scollegherai il servizio dal progetto a cui è associato. Crea una nuova istanza del servizio se desideri ricollegare il servizio al progetto. - -## Panoramica dei servizi mobili e web {{site.data.keyword.Bluemix_notm}} -{: #mobile_services_overview} - -La seguente tabella contiene descrizioni dei servizi mobili e web {{site.data.keyword.Bluemix_notm}}. Puoi utilizzare i servizi individuali dal catalogo {{site.data.keyword.Bluemix_notm}} o puoi integrarli nel tuo progetto. - - - - - - - - - - - - - - - - - - - -
Tabella 1. Servizi mobili e web {{site.data.keyword.Bluemix_notm}}
Servizi mobili e web {{site.data.keyword.Bluemix_notm}}Descrizione
{{site.data.keyword.mobileanalytics_short}} icon
{{site.data.keyword.mobileanalytics_short}}		Utilizza il servizio {{site.data.keyword.mobileanalytics_full}} per acquisire informazioni su come vengono eseguite e utilizzate le tue applicazioni mobili.

-Leggi ulteriori informazioni sull'utilizzo di questo servizio nella documentazione {{site.data.keyword.mobileanalytics_short}}. -
{{site.data.keyword.mobilefoundation_short}} service icon
{{site.data.keyword.mobilefoundation_short}}		Utilizza il servizio {{site.data.keyword.mobilefoundation_long}} per velocizzare la configurazione di un ambiente {{site.data.keyword.mfp_full}} da cui puoi sviluppare, testare e operare applicazioni mobili aziendali.

-Leggi ulteriori informazioni sull'utilizzo di questo servizio nella documentazione {{site.data.keyword.mobilefoundation_short}}.
{{site.data.keyword.mobilepushshort}} service icon
{{site.data.keyword.mobilepushshort}}		Il servizio {{site.data.keyword.mobilepushfull}} fornisce una piattaforma unificata per inviare e gestire le notifiche di push mobili e web destinate a più piattaforme. -

-{{site.data.keyword.mobilepushshort}} gestisce l'associazione dei tuoi utenti delle applicazioni ai loro dispositivi, alla loro piattaforma del dispositivo e ai browser web e ne gestisce l'invio delle notifiche di push. Puoi inviare broadcast, unicast (basati su ID dispositivo e ID utente) e le tag (o argomenti) come notifiche di push ai tuoi utenti delle applicazioni mobili e browser web. Puoi anche utilizzare un SDK e API REST per sviluppare ulteriormente le tue applicazioni client. -

-Leggi ulteriori informazioni sull'utilizzo di questo servizio nella documentazione {{site.data.keyword.mobilepushshort}}.
+--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# Servizi +{: #services} + +Dalla pagina {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} **Servizi**, puoi visualizzare i servizi mobili e web esistenti o crearne di nuovi. La console fornisce una sola ubicazione per visualizzare tutti i servizi web e mobili {{site.data.keyword.Bluemix_notm}} che stanno venendo gestiti dai progetti. + +Se elimini dei servizi dalla vista **Servizi**, scollegherai il servizio dal progetto a cui è associato. Crea una nuova istanza del servizio se desideri ricollegare il servizio al progetto. + +## Panoramica dei servizi mobili e web {{site.data.keyword.Bluemix_notm}} +{: #mobile_services_overview} + +La seguente tabella contiene descrizioni dei servizi mobili e web {{site.data.keyword.Bluemix_notm}}. Puoi utilizzare i servizi individuali dal catalogo {{site.data.keyword.Bluemix_notm}} o puoi integrarli nel tuo progetto. + + + + + + + + + + + + + + + + + + + +
Tabella 1. Servizi mobili e web {{site.data.keyword.Bluemix_notm}}
Servizi mobili e web {{site.data.keyword.Bluemix_notm}}Descrizione
{{site.data.keyword.mobileanalytics_short}} icon
{{site.data.keyword.mobileanalytics_short}}		Utilizza il servizio {{site.data.keyword.mobileanalytics_full}} per acquisire informazioni su come vengono eseguite e utilizzate le tue applicazioni mobili.

+Leggi ulteriori informazioni sull'utilizzo di questo servizio nella documentazione {{site.data.keyword.mobileanalytics_short}}. +
{{site.data.keyword.mobilefoundation_short}} service icon
{{site.data.keyword.mobilefoundation_short}}		Utilizza il servizio {{site.data.keyword.mobilefoundation_long}} per velocizzare la configurazione di un ambiente {{site.data.keyword.mfp_full}} da cui puoi sviluppare, testare e operare applicazioni mobili aziendali.

+Leggi ulteriori informazioni sull'utilizzo di questo servizio nella documentazione {{site.data.keyword.mobilefoundation_short}}.
{{site.data.keyword.mobilepushshort}} service icon
{{site.data.keyword.mobilepushshort}}		Il servizio {{site.data.keyword.mobilepushfull}} fornisce una piattaforma unificata per inviare e gestire le notifiche di push mobili e web destinate a più piattaforme. +

+{{site.data.keyword.mobilepushshort}} gestisce l'associazione dei tuoi utenti delle applicazioni ai loro dispositivi, alla loro piattaforma del dispositivo e ai browser web e ne gestisce l'invio delle notifiche di push. Puoi inviare broadcast, unicast (basati su ID dispositivo e ID utente) e le tag (o argomenti) come notifiche di push ai tuoi utenti delle applicazioni mobili e browser web. Puoi anche utilizzare un SDK e API REST per sviluppare ulteriormente le tue applicazioni client. +

+Leggi ulteriori informazioni sull'utilizzo di questo servizio nella documentazione {{site.data.keyword.mobilepushshort}}.
diff --git a/cloudnative/nl/it/starters.md b/cloudnative/nl/it/starters.md index 452b40e37..2e4e40738 100644 --- a/cloudnative/nl/it/starters.md +++ b/cloudnative/nl/it/starters.md @@ -1,26 +1,26 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Starter -{: #starters} - -Con la {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, puoi scegliere tra diversi starter per ogni tipo di modello. - -Gli starter sono ottimizzati per essere codice di partenza pronto per la produzione che si focalizzano sulla dimostrazione di un'integrazione {{site.data.keyword.Bluemix_notm}} chiave con un servizio di elevato valore. Ogni starter si focalizza su un servizio e mostra l'integrazione delle SDK del servizio nel codice. In alcuni casi, gli starter offrono un'esperienza utente semplice per sottolineare l'integrazione dei dati del servizio o le interazioni con l'utente. Ogni starter codice è configurato per essere abilitato con le funzionalità Authentication, Data e possibilmente altre funzionalità, se decidi di configurarle per il tuo progetto. - - -## Esercitazioni -{: #tutorials notoc} - -Per istruzioni più dettagliate su come creare le applicazioni con gli starter, puoi utilizzare le [esercitazioni](tutorials.html) end-to-end. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Starter +{: #starters} + +Con la {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, puoi scegliere tra diversi starter per ogni tipo di modello. + +Gli starter sono ottimizzati per essere codice di partenza pronto per la produzione che si focalizzano sulla dimostrazione di un'integrazione {{site.data.keyword.Bluemix_notm}} chiave con un servizio di elevato valore. Ogni starter si focalizza su un servizio e mostra l'integrazione delle SDK del servizio nel codice. In alcuni casi, gli starter offrono un'esperienza utente semplice per sottolineare l'integrazione dei dati del servizio o le interazioni con l'utente. Ogni starter codice è configurato per essere abilitato con le funzionalità Authentication, Data e possibilmente altre funzionalità, se decidi di configurarle per il tuo progetto. + + +## Esercitazioni +{: #tutorials notoc} + +Per istruzioni più dettagliate su come creare le applicazioni con gli starter, puoi utilizzare le [esercitazioni](tutorials.html) end-to-end. diff --git a/cloudnative/nl/it/troubleshoot.md b/cloudnative/nl/it/troubleshoot.md index c4869e10e..ca1a7bcd4 100644 --- a/cloudnative/nl/it/troubleshoot.md +++ b/cloudnative/nl/it/troubleshoot.md @@ -1,226 +1,226 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Risoluzione dei problemi -{: #ts} - -Alcuni problemi noti con la {{site.data.keyword.dev_cli_notm}} sono documentati insieme alle rispettive soluzioni alternative. -{:shortdesc} - - - -## Problemi noti -{: #knownissues} - -Le seguenti sezioni descrivono problemi noti e risoluzioni possibili. - - -### Nome host già preso durante la creazione di un progetto con un modello non mobile -{: #hostname} - -Potresti visualizzare il seguente errore se utilizzi la {{site.data.keyword.dev_cli_short}} per creare un progetto dai modelli applicazione web, BFF, o microservizio: - -``` -Il nome host è preso. -``` -{: codeblock} - - -#### Causa -{: #hostname-cause} - -Questo errore è dovuto ad un token di accesso scaduto. - - -#### Soluzione -{: #hostname-resolution} - -Riaccedi. - -``` -bx login -``` -{: codeblock} - - -### Errori generali con la {{site.data.keyword.dev_cli_short}} -{: #general} - -Potresti visualizzare il seguente errore se utilizzi la {{site.data.keyword.dev_cli_short}} con i comandi create, delete, list o code: - -``` -Errore nel progetto. -``` -{: codeblock} - - -#### Causa -{: #hostname-cause} - -Questo errore è dovuto ad un token di accesso scaduto. - - -#### Soluzione -{: #hostname-resolution} - -Riaccedi. - -``` -bx login -``` -{: codeblock} - - -### Errore con il broker di servizi durante l'aggiunta della funzionalità {{site.data.keyword.objectstorageshort}} -{: #os} - -Potresti visualizzare il seguente errore se utilizzi la {{site.data.keyword.dev_cli_short}} per creare due progetti con la funzionalità {{site.data.keyword.objectstorageshort}}: - -``` -NON RIUSCITO -Errore broker di servizi: {"description"=>"Non puoi creare questa istanza Object Storage. Ogni organizzazione che utilizza il servizio Object Storage è limitata a un'istanza del piano gratuito."} -``` -{: codeblock} - - -#### Causa -{: #os-cause} - -Questo errore è dovuto al servizio {{site.data.keyword.objectstorageshort}} che consente solo un'istanza del piano {{site.data.keyword.objectstorageshort}} gratuito. - - -#### Soluzione -{: #os-resolution} - -Ti sarà chiesto di scegliere un piano differente per evitare questo errore. - - -### Errore durante l'ottenimento del codice durante la creazione del progetto -{: #code} - -Potresti visualizzare il seguente errore se utilizzi la {{site.data.keyword.dev_cli_short}} per creare un progetto: - -``` -NON RIUSCITO -Progetto creato, ma non è possibile ottenere il codice -https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code -``` -{: codeblock} - - -#### Causa -{: #code-cause} - -Questo errore è dovuto a un timeout interno. - - -#### Soluzione -{: #code-resolution} - -Puoi ottenere il codice in uno dei seguenti modi: - -* Esegui il seguente comando utilizzando la CLI: - - ``` - bx dev code - ``` - {: codeblock} - - `` deve essere sostituito con il nome del progetto che hai utilizzato durante la creazione del progetto. - -* Utilizza la {{site.data.keyword.dev_console}}. - - 1. Seleziona il tuo progetto [ ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://console.{DomainName}/developer/projects) nella {{site.data.keyword.dev_console}} e fai clic su **Ottieni codice**. - - 2. Fai clic su **Genera codice**. - - 3. Dopo aver generato il codice, fai clic su **Scarica codice**. - - -### Errore durante l'esecuzione di `bx dev run` per i progetti Node.js -{: #node} - -Potresti visualizzare il seguente errore se stai eseguendo `bx dev run` con la {{site.data.keyword.dev_cli_short}} per i progetti Node.js Web o BFF: - -``` -module.js:597 - return process.dlopen(module, path._makeLong(filename)); - ^ - -Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header - at Error (native) - at Object.Module._extensions..node (module.js:597:18) - at Module.load (module.js:487:32) - at tryModuleLoad (module.js:446:12) - - at Function.Module._load (module.js:438:3) - at Module.require (module.js:497:17) - at require (internal/module.js:20:19) - at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) - at Module._compile (module.js:570:32) - at Object.Module._extensions..js (module.js:579:10) -``` -{: codeblock} - - -#### Causa -{: #node-cause} - -Questo errore è dovuto al modulo `appmetrics` che sta venendo installato in una differente architettura. I moduli npm nativi installati su un'architettura non funzioneranno su di un'altra. Le immagini Docker incluse si basano sul kernel Linux. - - -#### Soluzione -{: #node-resolution} - -Elimina la cartella `node_modules` ed esegui nuovamente `bx dev run`. - - - - - - - -## Come ottenere aiuto e supporto -{: #gettinghelp} - -Se hai problemi o domande sull'utilizzo della {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} o della {{site.data.keyword.dev_cli_notm}}, puoi ottenere aiuto ricercando le informazioni o facendo delle domande in un forum. Puoi anche aprire un ticket di supporto. - -Quando utilizzi il forum per fare delle domande, contrassegna con una tag la tua domanda in modo che sia vista dai team di sviluppo {{site.data.keyword.Bluemix_notm}}. - - - -Se hai domande tecniche sullo sviluppo o la distribuzione di un'applicazione con {{site.data.keyword.dev_console}} o {{site.data.keyword.dev_cli_notm}}: - -* Inserisci la tua domanda in [Stack Overflow ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) e contrassegnala con le tag `bluemix-dev-services` e `ibm-bluemix`. -* Inserisci la tua domanda in [Slack -![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://ibm-cloud-tech.slack.com/) nel canale bluemix-dev-services. [Registrati a ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://ibm.biz/IBMCloudNativeSlack) oggi. - - - - - -Consulta [Come ottenere supporto -![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/support/index.html#getting-help) per ulteriori dettagli sull'utilizzo dei forum. - -Per informazioni su come aprire un ticket di supporto {{site.data.keyword.IBM}} o sui livelli di supporto e sulla gravità dei ticket, consulta -[Come contattare il supporto ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/support/index.html#contacting-support). - - - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Risoluzione dei problemi +{: #ts} + +Alcuni problemi noti con la {{site.data.keyword.dev_cli_notm}} sono documentati insieme alle rispettive soluzioni alternative. +{:shortdesc} + + + +## Problemi noti +{: #knownissues} + +Le seguenti sezioni descrivono problemi noti e risoluzioni possibili. + + +### Nome host già preso durante la creazione di un progetto con un modello non mobile +{: #hostname} + +Potresti visualizzare il seguente errore se utilizzi la {{site.data.keyword.dev_cli_short}} per creare un progetto dai modelli applicazione web, BFF, o microservizio: + +``` +Il nome host è preso. +``` +{: codeblock} + + +#### Causa +{: #hostname-cause} + +Questo errore è dovuto ad un token di accesso scaduto. + + +#### Soluzione +{: #hostname-resolution} + +Riaccedi. + +``` +bx login +``` +{: codeblock} + + +### Errori generali con la {{site.data.keyword.dev_cli_short}} +{: #general} + +Potresti visualizzare il seguente errore se utilizzi la {{site.data.keyword.dev_cli_short}} con i comandi create, delete, list o code: + +``` +Errore nel progetto. +``` +{: codeblock} + + +#### Causa +{: #hostname-cause} + +Questo errore è dovuto ad un token di accesso scaduto. + + +#### Soluzione +{: #hostname-resolution} + +Riaccedi. + +``` +bx login +``` +{: codeblock} + + +### Errore con il broker di servizi durante l'aggiunta della funzionalità {{site.data.keyword.objectstorageshort}} +{: #os} + +Potresti visualizzare il seguente errore se utilizzi la {{site.data.keyword.dev_cli_short}} per creare due progetti con la funzionalità {{site.data.keyword.objectstorageshort}}: + +``` +NON RIUSCITO +Errore broker di servizi: {"description"=>"Non puoi creare questa istanza Object Storage. Ogni organizzazione che utilizza il servizio Object Storage è limitata a un'istanza del piano gratuito."} +``` +{: codeblock} + + +#### Causa +{: #os-cause} + +Questo errore è dovuto al servizio {{site.data.keyword.objectstorageshort}} che consente solo un'istanza del piano {{site.data.keyword.objectstorageshort}} gratuito. + + +#### Soluzione +{: #os-resolution} + +Ti sarà chiesto di scegliere un piano differente per evitare questo errore. + + +### Errore durante l'ottenimento del codice durante la creazione del progetto +{: #code} + +Potresti visualizzare il seguente errore se utilizzi la {{site.data.keyword.dev_cli_short}} per creare un progetto: + +``` +NON RIUSCITO +Progetto creato, ma non è possibile ottenere il codice +https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code +``` +{: codeblock} + + +#### Causa +{: #code-cause} + +Questo errore è dovuto a un timeout interno. + + +#### Soluzione +{: #code-resolution} + +Puoi ottenere il codice in uno dei seguenti modi: + +* Esegui il seguente comando utilizzando la CLI: + + ``` + bx dev code + ``` + {: codeblock} + + `` deve essere sostituito con il nome del progetto che hai utilizzato durante la creazione del progetto. + +* Utilizza la {{site.data.keyword.dev_console}}. + + 1. Seleziona il tuo progetto [ ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://console.{DomainName}/developer/projects) nella {{site.data.keyword.dev_console}} e fai clic su **Ottieni codice**. + + 2. Fai clic su **Genera codice**. + + 3. Dopo aver generato il codice, fai clic su **Scarica codice**. + + +### Errore durante l'esecuzione di `bx dev run` per i progetti Node.js +{: #node} + +Potresti visualizzare il seguente errore se stai eseguendo `bx dev run` con la {{site.data.keyword.dev_cli_short}} per i progetti Node.js Web o BFF: + +``` +module.js:597 + return process.dlopen(module, path._makeLong(filename)); + ^ + +Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header + at Error (native) + at Object.Module._extensions..node (module.js:597:18) + at Module.load (module.js:487:32) + at tryModuleLoad (module.js:446:12) + + at Function.Module._load (module.js:438:3) + at Module.require (module.js:497:17) + at require (internal/module.js:20:19) + at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) + at Module._compile (module.js:570:32) + at Object.Module._extensions..js (module.js:579:10) +``` +{: codeblock} + + +#### Causa +{: #node-cause} + +Questo errore è dovuto al modulo `appmetrics` che sta venendo installato in una differente architettura. I moduli npm nativi installati su un'architettura non funzioneranno su di un'altra. Le immagini Docker incluse si basano sul kernel Linux. + + +#### Soluzione +{: #node-resolution} + +Elimina la cartella `node_modules` ed esegui nuovamente `bx dev run`. + + + + + + + +## Come ottenere aiuto e supporto +{: #gettinghelp} + +Se hai problemi o domande sull'utilizzo della {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} o della {{site.data.keyword.dev_cli_notm}}, puoi ottenere aiuto ricercando le informazioni o facendo delle domande in un forum. Puoi anche aprire un ticket di supporto. + +Quando utilizzi il forum per fare delle domande, contrassegna con una tag la tua domanda in modo che sia vista dai team di sviluppo {{site.data.keyword.Bluemix_notm}}. + + + +Se hai domande tecniche sullo sviluppo o la distribuzione di un'applicazione con {{site.data.keyword.dev_console}} o {{site.data.keyword.dev_cli_notm}}: + +* Inserisci la tua domanda in [Stack Overflow ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) e contrassegnala con le tag `bluemix-dev-services` e `ibm-bluemix`. +* Inserisci la tua domanda in [Slack +![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://ibm-cloud-tech.slack.com/) nel canale bluemix-dev-services. [Registrati a ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](http://ibm.biz/IBMCloudNativeSlack) oggi. + + + + + +Consulta [Come ottenere supporto +![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/support/index.html#getting-help) per ulteriori dettagli sull'utilizzo dei forum. + +Per informazioni su come aprire un ticket di supporto {{site.data.keyword.IBM}} o sui livelli di supporto e sulla gravità dei ticket, consulta +[Come contattare il supporto ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/support/index.html#contacting-support). + + + diff --git a/cloudnative/nl/it/tutorial_bff.md b/cloudnative/nl/it/tutorial_bff.md index 177f659ea..30a512b53 100644 --- a/cloudnative/nl/it/tutorial_bff.md +++ b/cloudnative/nl/it/tutorial_bff.md @@ -1,147 +1,147 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Esercitazione end-to-end dello starter di base BFF -{: #tutorial} - -La seguente esercitazione end-to-end spiega i passi per creare un progetto da uno starter di base BFF, inclusi gli strumenti che devi avere installato e, successivamente, i passi per eseguire il codice del progetto. - -## Installazione degli strumenti per sviluppatori -{: #dev_tools} - -Assicurati di aver installato gli [strumenti per sviluppatori prerequisiti ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](get_code.html#prereq-dev-tools){: new_window}. - - -## Creazione di un progetto utilizzando la {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Crea un progetto nella {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Dalla pagina **Introduzione** nella {{site.data.keyword.dev_console}}, fai clic su **Crea progetto**. - - In alternativa puoi fare clic su **Crea progetto** dalla pagina **Progetti**. - - 2. Seleziona **Backend for Frontend** e fai cli su **Avanti**. - - 3. Seleziona **Backend di base** e fai clic su **Avanti**. - - 4. Immetti il nome del tuo progetto. Per questa esercitazione, utilizza `BFFProject`. - - 5. Immetti un nome host. Per questa esercitazione, utilizza `devhost` - - 6. Seleziona la tua piattaforma di linguaggio. Per questa esercitazione, utilizza `Node`. - - 7. Fai clic su **Crea**. - -2. Facoltativo: aggiungi la funzionalità Data. - - 1. Fai clic su **Visualizza** per **Data** nella pagina **Panoramica progetto**. - - In alternativa, puoi fare selezionare **Crea** o **Aggiungi esistente** nella pagina **Funzionalità > Data**. - - 2. Immetti il nome del tuo servizio e fai clic su **Crea**. - - -3. Genera il tuo codice del progetto. - - 1. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. - - In alternativa puoi fare clic sulla pagina **Codice**. - - 2. Fai clic su **Genera codice**. - - 3. Quando il codice del progetto ha terminato la generazione, fai clic su **Scarica codice** per scaricare il tuo archivio del progetto. - -4. Facoltativo: [Aggiorna il tuo progetto](project_overview_page.html#update_language) per generare un nuovo linguaggio. - - -## Creazione di un progetto utilizzando la {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assicurati di aver installato la [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. Nella tua finestra del terminale, passa a una directory locale di tua scelta ed esegui il seguente comando. - - ``` - bx dev create - ``` - {: codeblock} - -3. Fornisci i seguenti valori quando richiesto: - - * Seleziona un modello: 3 (per Backend for Frontend) - * Seleziona uno starter: 1 (per Backend di base) - * Seleziona un linguaggio: 1 (per Node) - * Immetti un nome per il tuo progetto: `BFFProjectCLI` - * Immetti un nome host per il tuo progetto: `myhost` - -4. Se desideri aggiungere servizi al tuo progetto, immetti `y` quando ti viene domandato e rispondi alle rimanenti domande. - -5. Quando `BFFProjectCLI` è stato correttamente salvato, passa alla cartella `BFFProjectCLI`. - -6. A questo punto potresti aggiungere il tuo proprio codice, creare o eseguire il progetto. - - 1. Crea il tuo progetto con il seguente comando: - - ``` - bx dev build - ``` - {: codeblock} - - 2. Esegui il tuo progetto con il seguente comando: - - ``` - bx dev run - ``` - {: codeblock} - - -## Esecuzione di un progetto BFF -{: #running-bff} - -### Localmente -{: #bff-local} - -1. Compila il tuo server: - - ``` - swift build - ``` - {: codeblock} - -2. Esegui la tua applicazione. Ad esempio, assumendo che la tua applicazione di chiama `MyServer`: - - ``` - .build/debug/MyServer - ``` - {: codeblock} - -3. Puoi eseguire curl sul tuo server con `curl http://localhost:8080` - - -### Utilizzo del plugin Bluemix -{: #using-blumix} - -1. Esegui la compilazione - - ``` - bx dev run - ``` - {: codeblock} - -2. Puoi eseguire curl sul tuo server con - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Esercitazione end-to-end dello starter di base BFF +{: #tutorial} + +La seguente esercitazione end-to-end spiega i passi per creare un progetto da uno starter di base BFF, inclusi gli strumenti che devi avere installato e, successivamente, i passi per eseguire il codice del progetto. + +## Installazione degli strumenti per sviluppatori +{: #dev_tools} + +Assicurati di aver installato gli [strumenti per sviluppatori prerequisiti ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](get_code.html#prereq-dev-tools){: new_window}. + + +## Creazione di un progetto utilizzando la {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Crea un progetto nella {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Dalla pagina **Introduzione** nella {{site.data.keyword.dev_console}}, fai clic su **Crea progetto**. + + In alternativa puoi fare clic su **Crea progetto** dalla pagina **Progetti**. + + 2. Seleziona **Backend for Frontend** e fai cli su **Avanti**. + + 3. Seleziona **Backend di base** e fai clic su **Avanti**. + + 4. Immetti il nome del tuo progetto. Per questa esercitazione, utilizza `BFFProject`. + + 5. Immetti un nome host. Per questa esercitazione, utilizza `devhost` + + 6. Seleziona la tua piattaforma di linguaggio. Per questa esercitazione, utilizza `Node`. + + 7. Fai clic su **Crea**. + +2. Facoltativo: aggiungi la funzionalità Data. + + 1. Fai clic su **Visualizza** per **Data** nella pagina **Panoramica progetto**. + + In alternativa, puoi fare selezionare **Crea** o **Aggiungi esistente** nella pagina **Funzionalità > Data**. + + 2. Immetti il nome del tuo servizio e fai clic su **Crea**. + + +3. Genera il tuo codice del progetto. + + 1. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. + + In alternativa puoi fare clic sulla pagina **Codice**. + + 2. Fai clic su **Genera codice**. + + 3. Quando il codice del progetto ha terminato la generazione, fai clic su **Scarica codice** per scaricare il tuo archivio del progetto. + +4. Facoltativo: [Aggiorna il tuo progetto](project_overview_page.html#update_language) per generare un nuovo linguaggio. + + +## Creazione di un progetto utilizzando la {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assicurati di aver installato la [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. Nella tua finestra del terminale, passa a una directory locale di tua scelta ed esegui il seguente comando. + + ``` + bx dev create + ``` + {: codeblock} + +3. Fornisci i seguenti valori quando richiesto: + + * Seleziona un modello: 3 (per Backend for Frontend) + * Seleziona uno starter: 1 (per Backend di base) + * Seleziona un linguaggio: 1 (per Node) + * Immetti un nome per il tuo progetto: `BFFProjectCLI` + * Immetti un nome host per il tuo progetto: `myhost` + +4. Se desideri aggiungere servizi al tuo progetto, immetti `y` quando ti viene domandato e rispondi alle rimanenti domande. + +5. Quando `BFFProjectCLI` è stato correttamente salvato, passa alla cartella `BFFProjectCLI`. + +6. A questo punto potresti aggiungere il tuo proprio codice, creare o eseguire il progetto. + + 1. Crea il tuo progetto con il seguente comando: + + ``` + bx dev build + ``` + {: codeblock} + + 2. Esegui il tuo progetto con il seguente comando: + + ``` + bx dev run + ``` + {: codeblock} + + +## Esecuzione di un progetto BFF +{: #running-bff} + +### Localmente +{: #bff-local} + +1. Compila il tuo server: + + ``` + swift build + ``` + {: codeblock} + +2. Esegui la tua applicazione. Ad esempio, assumendo che la tua applicazione di chiama `MyServer`: + + ``` + .build/debug/MyServer + ``` + {: codeblock} + +3. Puoi eseguire curl sul tuo server con `curl http://localhost:8080` + + +### Utilizzo del plugin Bluemix +{: #using-blumix} + +1. Esegui la compilazione + + ``` + bx dev run + ``` + {: codeblock} + +2. Puoi eseguire curl sul tuo server con + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/it/tutorial_microservice.md b/cloudnative/nl/it/tutorial_microservice.md index fe9fecedc..4f127f934 100644 --- a/cloudnative/nl/it/tutorial_microservice.md +++ b/cloudnative/nl/it/tutorial_microservice.md @@ -1,113 +1,113 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Esercitazione end-to-end dello starter di base del microservizio -{: #tutorial} - -La seguente esercitazione end-to-end spiega i passi per creare un progetto da uno starter di base del microservizio, inclusi gli strumenti che devi avere installato e, successivamente, i passi per eseguire il codice del progetto. - -## Installazione degli strumenti per sviluppatori -{: #dev_tools} - -Assicurati di aver installato gli [strumenti per sviluppatori prerequisiti ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](get_code.html#prereq-dev-tools){: new_window}. - - -## Creazione di un progetto utilizzando la {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Crea un progetto nella {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Dalla pagina **Introduzione** nella {{site.data.keyword.dev_console}}, fai clic su **Crea progetto**. - - In alternativa puoi fare clic su **Crea progetto** dalla pagina **Progetti**. - - 2. Seleziona **Microservizio** e fai clic su **Avanti**. - - 3. Seleziona **Di base** e fai clic su **Avanti**. - - 4. Immetti il nome del tuo progetto. Per questa esercitazione, utilizza `MicroserviceProject`. - - 5. Immetti un nome host. Per questa esercitazione, utilizza `devhost` - - 6. Fai clic su **Crea**. - -2. Facoltativo: aggiungi la funzionalità Data. - - 1. Fai clic su **Visualizza** per **Data** nella pagina **Panoramica progetto**. - - In alternativa, puoi fare selezionare **Crea** o **Aggiungi esistente** nella pagina **Funzionalità > Data**. - - 2. Immetti il nome del tuo servizio e fai clic su **Crea**. - -3. Genera il tuo codice del progetto. - - 1. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. - - In alternativa puoi fare clic sulla pagina **Codice**. - - 2. Fai clic su **Genera codice**. - - 3. Quando il codice del progetto ha terminato la generazione, fai clic su **Scarica codice** per scaricare il tuo archivio del progetto. - -4. Facoltativo: [Aggiorna il tuo progetto](project_overview_page.html#update_language) per generare un nuovo linguaggio. - - -## Creazione di un progetto utilizzando la {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assicurati di aver installato la [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. Nella tua finestra del terminale, passa a una directory locale di tua scelta ed esegui il seguente comando. - - ``` - bx dev create - ``` - {: codeblock} - -3. Fornisci i seguenti valori quando richiesto: - - * Seleziona un modello: 4 (per i microservizi) - * Seleziona uno starter: 1 (di base) - * Seleziona una piattaforma: 3 (per Java) - * Immetti un nome per il tuo progetto: `MicroserviceProjectCLI` - -4. Se desideri aggiungere servizi al tuo progetto, immetti `y` quando ti viene domandato e rispondi alle rimanenti domande. - -5. Quando `MicroserviceProjectCLI` è stato correttamente salvato, passa alla cartella `MicroserviceProjectCLI`. - -6. A questo punto potresti aggiungere il tuo proprio codice, creare o eseguire il progetto. - - -## Esecuzione di un progetto utilizzando la {{site.data.keyword.dev_cli_notm}} -{: #running-dev-plugin} - -1. Per creare il progetto nella tua directory del progetto corrente immetti il seguente comando: - - ``` - bx dev build - ``` - {: codeblock} - -2. Per creare ed eseguire il progetto nella tua directory del progetto corrente immetti il seguente comando: - - ``` - bx dev run - ``` - {: codeblock} - -3. Puoi accedere all'applicazione utilizzando curl sul tuo server: - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Esercitazione end-to-end dello starter di base del microservizio +{: #tutorial} + +La seguente esercitazione end-to-end spiega i passi per creare un progetto da uno starter di base del microservizio, inclusi gli strumenti che devi avere installato e, successivamente, i passi per eseguire il codice del progetto. + +## Installazione degli strumenti per sviluppatori +{: #dev_tools} + +Assicurati di aver installato gli [strumenti per sviluppatori prerequisiti ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](get_code.html#prereq-dev-tools){: new_window}. + + +## Creazione di un progetto utilizzando la {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Crea un progetto nella {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Dalla pagina **Introduzione** nella {{site.data.keyword.dev_console}}, fai clic su **Crea progetto**. + + In alternativa puoi fare clic su **Crea progetto** dalla pagina **Progetti**. + + 2. Seleziona **Microservizio** e fai clic su **Avanti**. + + 3. Seleziona **Di base** e fai clic su **Avanti**. + + 4. Immetti il nome del tuo progetto. Per questa esercitazione, utilizza `MicroserviceProject`. + + 5. Immetti un nome host. Per questa esercitazione, utilizza `devhost` + + 6. Fai clic su **Crea**. + +2. Facoltativo: aggiungi la funzionalità Data. + + 1. Fai clic su **Visualizza** per **Data** nella pagina **Panoramica progetto**. + + In alternativa, puoi fare selezionare **Crea** o **Aggiungi esistente** nella pagina **Funzionalità > Data**. + + 2. Immetti il nome del tuo servizio e fai clic su **Crea**. + +3. Genera il tuo codice del progetto. + + 1. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. + + In alternativa puoi fare clic sulla pagina **Codice**. + + 2. Fai clic su **Genera codice**. + + 3. Quando il codice del progetto ha terminato la generazione, fai clic su **Scarica codice** per scaricare il tuo archivio del progetto. + +4. Facoltativo: [Aggiorna il tuo progetto](project_overview_page.html#update_language) per generare un nuovo linguaggio. + + +## Creazione di un progetto utilizzando la {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assicurati di aver installato la [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. Nella tua finestra del terminale, passa a una directory locale di tua scelta ed esegui il seguente comando. + + ``` + bx dev create + ``` + {: codeblock} + +3. Fornisci i seguenti valori quando richiesto: + + * Seleziona un modello: 4 (per i microservizi) + * Seleziona uno starter: 1 (di base) + * Seleziona una piattaforma: 3 (per Java) + * Immetti un nome per il tuo progetto: `MicroserviceProjectCLI` + +4. Se desideri aggiungere servizi al tuo progetto, immetti `y` quando ti viene domandato e rispondi alle rimanenti domande. + +5. Quando `MicroserviceProjectCLI` è stato correttamente salvato, passa alla cartella `MicroserviceProjectCLI`. + +6. A questo punto potresti aggiungere il tuo proprio codice, creare o eseguire il progetto. + + +## Esecuzione di un progetto utilizzando la {{site.data.keyword.dev_cli_notm}} +{: #running-dev-plugin} + +1. Per creare il progetto nella tua directory del progetto corrente immetti il seguente comando: + + ``` + bx dev build + ``` + {: codeblock} + +2. Per creare ed eseguire il progetto nella tua directory del progetto corrente immetti il seguente comando: + + ``` + bx dev run + ``` + {: codeblock} + +3. Puoi accedere all'applicazione utilizzando curl sul tuo server: + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/it/tutorial_mobile.md b/cloudnative/nl/it/tutorial_mobile.md index e6608700a..c96845741 100644 --- a/cloudnative/nl/it/tutorial_mobile.md +++ b/cloudnative/nl/it/tutorial_mobile.md @@ -1,187 +1,187 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Esercitazione end-to-end dello starter di base mobile -{: #tutorial} - -La seguente esercitazione end-to-end spiega i passi per creare un progetto da uno starter di base mobile, inclusi gli strumenti che devi avere installato e, successivamente, i passi per eseguire il progetto in Xcode e Android Studio. - - -## Installazione degli strumenti per sviluppatori -{: #dev_tools} - -Assicurati di aver installato gli [strumenti per sviluppatori prerequisiti ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](get_code.html#prereq-dev-tools){: new_window}. - - -## Creazione di un progetto utilizzando la {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Crea un progetto {{site.data.keyword.dev_console}} in {{site.data.keyword.Bluemix}}. - - 1. Dalla pagina **Introduzione** nella {{site.data.keyword.dev_console}}, fai clic su **Crea progetto**. - - In alternativa puoi fare clic su **Crea progetto** dalla pagina **Progetti**. - - 2. Seleziona **Applicazione mobile** e fai clic su **Avanti**. - - 3. Seleziona **Di base** e fai clic su **Avanti**. - - 4. Immetti il nome del tuo progetto. Per questa esercitazione, utilizza `MobileBasicProject`. - - 5. Seleziona la tua piattaforma. Per questa esercitazione, utilizza `Swift`. - - 6. Fai clic su **Crea**. - -2. Facoltativo: aggiungi la funzionalità Authentication. - - 1. Fai clic su **Aggiungi** per **Authentication** nella pagina **Panoramica progetto**. - - In alternativa, puoi fare selezionare **Crea** o **Aggiungi esistente** nella pagina **Funzionalità > Authentication**. - - 2. Immetti il nome del tuo servizio e fai clic su **Crea**. - - 3. Attiva **Authentication**. - - 4. Seleziona il tuo provider di identità ed immetti le informazioni richieste per configurarlo. Puoi abilitare solo un provider di identità. - - 5. Consulta [Configurazione dei provider di identità} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/appid/identity-providers.html){: new_window} per ulteriori informazioni sulla configurazione di Authentication. - -3. Facoltativo: aggiungi la funzionalità Analytics. - - 1. Fai clic su **Aggiungi** per **Analytics** dalla pagina **Panoramica progetto**. - - In alternativa, puoi fare clic su **Crea** o **Aggiungi esistente** dalla pagina **Funzionalità > Analytics**. - - 2. Immetti il nome del tuo servizio e fai clic su **Crea**. - - 3. Disattiva la **Modalità demo** per visualizzare i tuoi dati di analisi dopo l'esecuzione della tua applicazione. - - 4. Vedi [Introduzione a {{site.data.keyword.mobileanalytics_short}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobileanalytics/index.html){: new_window} per ulteriori informazioni sulla configurazione di Analytics. - -4. Facoltativo: aggiungi la funzionalità {{site.data.keyword.mobilepushshort}}. - - 1. Fai clic su **Aggiungi** per **{{site.data.keyword.mobilepushshort}}** nella pagina **Panoramica progetto**. - - In alternativa, puoi fare clic su **Crea** o **Aggiungi esistente** dalla pagina **Funzionalità > {{site.data.keyword.mobilepushshort}}**. - - 2. Immetti il nome del tuo servizio e fai clic su **Crea**. - - 3. Per iOS, [configura il servizio Apple Push Notification ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}. - - 4. Per Android, [configura Firebase Cloud Messaging ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}. - -5. Facoltativo: aggiungi la funzionalità Data. - - 1. Fai clic su **Visualizza** per **Data** nella pagina **Panoramica progetto**. - - In alternativa puoi selezionare **Crea** nella pagina **Data**. - - 2. Scegli **{{site.data.keyword.cloudant_short_notm}}** o **{{site.data.keyword.objectstorageshort}}**. - - 3. Immetti il nome del tuo servizio e fai clic su **Crea**. - - 4. Vedi [Introduzione a {{site.data.keyword.cloudant_short_notm}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/Cloudant/index.html){: new_window} per ulteriori informazioni sulla configurazione di {{site.data.keyword.cloudant_short_notm}}. - - 5. Vedi [Introduzione a {{site.data.keyword.objectstorageshort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/ObjectStorage/index.html){: new_window} per ulteriori informazioni sulla configurazione di {{site.data.keyword.objectstorageshort}}. - -6. Genera il tuo codice del progetto. - - 1. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. - - In alternativa puoi fare clic sulla pagina **Codice**. - - 2. Fai clic su **Genera Swift**. - - 3. Quando il codice del progetto ha terminato la generazione, fai clic su **Scarica Swift** per scaricare il tuo archivio del progetto. - -7. Facoltativo: [Aggiorna il tuo progetto](project_overview_page.html#update_language) per generare un nuovo linguaggio. - - -## Creazione di un progetto utilizzando la {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assicurati di aver installato la [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. Nella tua finestra del terminale, passa a una directory locale di tua scelta ed esegui il seguente comando. - - ``` - bx dev create - ``` - {: codeblock} - -3. Fornisci i seguenti valori quando richiesto: - - * Seleziona un modello: 2 (per mobile) - * Seleziona uno starter: 1 (di base) - * Seleziona una piattaforma: 3 (per iOS Swift) - * Immetti un nome per il tuo progetto: `MobileBasicProjectCLI` - -4. Se desideri aggiungere servizi al tuo progetto, immetti `y` quando ti viene domandato e rispondi alle rimanenti domande. - -5. Quando `MobileBasicProjectCLI` è stato correttamente salvato, passa alla cartella `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift`. - - -## Esecuzione del tuo progetto Swift in Xcode -{: #run_swift} - -1. Estrai il file `MobileBasicProject-Swift.zip`. - -2. Apri il file `README.md` in un visualizzatore Markdown per rivedere i passi di configurazione del progetto. - - 1. Apri il tuo terminale e passa alla tua cartella del progetto. - - 1. Esegui `pod setup` se hai bisogno di configurare il repository CocoaPods. - - 2. Esegui `pod update` se hai bisogno di aggiornare i tuoi pod esistenti. - - 3. Esegui `pod install` per installare i pod obbligatori per il tuo progetto. - - 3. Apri il tuo spazio di lavoro `BasicProject.xcworkspace` Xcode. - -3. Esegui la tua applicazione. - - -## Esecuzione del tuo progetto Cordova in Xcode -{: #run_cordova_xcode} - -1. Estrai il file `MobileBasicProject-Cordova.zip`. - -2. Apri il file `README.md` in un visualizzatore Markdown per configurare il tuo progetto. - - 1. Apri il tuo progetto `platforms/ios` in Xcode. - -3. Esegui la tua applicazione. - - -## Esecuzione del tuo progetto Cordova in Android Studio -{: #run_cordova_studio} - -1. Estrai il file `BasicProject-Cordova.zip`. - -2. Apri il file `README.md` in un visualizzatore Markdown per configurare il tuo progetto. - - 1. Apri il tuo progetto `platforms/android` in Android Studio. - -3. Esegui la tua applicazione. - - -## Esecuzione del tuo progetto Android in Android Studio -{: #run_android} - -1. Estrai il file `MobileBasicProject-Android.zip`. - -2. Apri il file `README.md` in un visualizzatore Markdown per configurare il tuo progetto. - - 1. Apri il tuo progetto `BasicProject-Android` in Android Studio. - -3. Esegui la tua applicazione. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Esercitazione end-to-end dello starter di base mobile +{: #tutorial} + +La seguente esercitazione end-to-end spiega i passi per creare un progetto da uno starter di base mobile, inclusi gli strumenti che devi avere installato e, successivamente, i passi per eseguire il progetto in Xcode e Android Studio. + + +## Installazione degli strumenti per sviluppatori +{: #dev_tools} + +Assicurati di aver installato gli [strumenti per sviluppatori prerequisiti ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](get_code.html#prereq-dev-tools){: new_window}. + + +## Creazione di un progetto utilizzando la {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Crea un progetto {{site.data.keyword.dev_console}} in {{site.data.keyword.Bluemix}}. + + 1. Dalla pagina **Introduzione** nella {{site.data.keyword.dev_console}}, fai clic su **Crea progetto**. + + In alternativa puoi fare clic su **Crea progetto** dalla pagina **Progetti**. + + 2. Seleziona **Applicazione mobile** e fai clic su **Avanti**. + + 3. Seleziona **Di base** e fai clic su **Avanti**. + + 4. Immetti il nome del tuo progetto. Per questa esercitazione, utilizza `MobileBasicProject`. + + 5. Seleziona la tua piattaforma. Per questa esercitazione, utilizza `Swift`. + + 6. Fai clic su **Crea**. + +2. Facoltativo: aggiungi la funzionalità Authentication. + + 1. Fai clic su **Aggiungi** per **Authentication** nella pagina **Panoramica progetto**. + + In alternativa, puoi fare selezionare **Crea** o **Aggiungi esistente** nella pagina **Funzionalità > Authentication**. + + 2. Immetti il nome del tuo servizio e fai clic su **Crea**. + + 3. Attiva **Authentication**. + + 4. Seleziona il tuo provider di identità ed immetti le informazioni richieste per configurarlo. Puoi abilitare solo un provider di identità. + + 5. Consulta [Configurazione dei provider di identità} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/appid/identity-providers.html){: new_window} per ulteriori informazioni sulla configurazione di Authentication. + +3. Facoltativo: aggiungi la funzionalità Analytics. + + 1. Fai clic su **Aggiungi** per **Analytics** dalla pagina **Panoramica progetto**. + + In alternativa, puoi fare clic su **Crea** o **Aggiungi esistente** dalla pagina **Funzionalità > Analytics**. + + 2. Immetti il nome del tuo servizio e fai clic su **Crea**. + + 3. Disattiva la **Modalità demo** per visualizzare i tuoi dati di analisi dopo l'esecuzione della tua applicazione. + + 4. Vedi [Introduzione a {{site.data.keyword.mobileanalytics_short}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobileanalytics/index.html){: new_window} per ulteriori informazioni sulla configurazione di Analytics. + +4. Facoltativo: aggiungi la funzionalità {{site.data.keyword.mobilepushshort}}. + + 1. Fai clic su **Aggiungi** per **{{site.data.keyword.mobilepushshort}}** nella pagina **Panoramica progetto**. + + In alternativa, puoi fare clic su **Crea** o **Aggiungi esistente** dalla pagina **Funzionalità > {{site.data.keyword.mobilepushshort}}**. + + 2. Immetti il nome del tuo servizio e fai clic su **Crea**. + + 3. Per iOS, [configura il servizio Apple Push Notification ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}. + + 4. Per Android, [configura Firebase Cloud Messaging ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}. + +5. Facoltativo: aggiungi la funzionalità Data. + + 1. Fai clic su **Visualizza** per **Data** nella pagina **Panoramica progetto**. + + In alternativa puoi selezionare **Crea** nella pagina **Data**. + + 2. Scegli **{{site.data.keyword.cloudant_short_notm}}** o **{{site.data.keyword.objectstorageshort}}**. + + 3. Immetti il nome del tuo servizio e fai clic su **Crea**. + + 4. Vedi [Introduzione a {{site.data.keyword.cloudant_short_notm}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/Cloudant/index.html){: new_window} per ulteriori informazioni sulla configurazione di {{site.data.keyword.cloudant_short_notm}}. + + 5. Vedi [Introduzione a {{site.data.keyword.objectstorageshort}} ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/ObjectStorage/index.html){: new_window} per ulteriori informazioni sulla configurazione di {{site.data.keyword.objectstorageshort}}. + +6. Genera il tuo codice del progetto. + + 1. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. + + In alternativa puoi fare clic sulla pagina **Codice**. + + 2. Fai clic su **Genera Swift**. + + 3. Quando il codice del progetto ha terminato la generazione, fai clic su **Scarica Swift** per scaricare il tuo archivio del progetto. + +7. Facoltativo: [Aggiorna il tuo progetto](project_overview_page.html#update_language) per generare un nuovo linguaggio. + + +## Creazione di un progetto utilizzando la {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assicurati di aver installato la [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. Nella tua finestra del terminale, passa a una directory locale di tua scelta ed esegui il seguente comando. + + ``` + bx dev create + ``` + {: codeblock} + +3. Fornisci i seguenti valori quando richiesto: + + * Seleziona un modello: 2 (per mobile) + * Seleziona uno starter: 1 (di base) + * Seleziona una piattaforma: 3 (per iOS Swift) + * Immetti un nome per il tuo progetto: `MobileBasicProjectCLI` + +4. Se desideri aggiungere servizi al tuo progetto, immetti `y` quando ti viene domandato e rispondi alle rimanenti domande. + +5. Quando `MobileBasicProjectCLI` è stato correttamente salvato, passa alla cartella `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift`. + + +## Esecuzione del tuo progetto Swift in Xcode +{: #run_swift} + +1. Estrai il file `MobileBasicProject-Swift.zip`. + +2. Apri il file `README.md` in un visualizzatore Markdown per rivedere i passi di configurazione del progetto. + + 1. Apri il tuo terminale e passa alla tua cartella del progetto. + + 1. Esegui `pod setup` se hai bisogno di configurare il repository CocoaPods. + + 2. Esegui `pod update` se hai bisogno di aggiornare i tuoi pod esistenti. + + 3. Esegui `pod install` per installare i pod obbligatori per il tuo progetto. + + 3. Apri il tuo spazio di lavoro `BasicProject.xcworkspace` Xcode. + +3. Esegui la tua applicazione. + + +## Esecuzione del tuo progetto Cordova in Xcode +{: #run_cordova_xcode} + +1. Estrai il file `MobileBasicProject-Cordova.zip`. + +2. Apri il file `README.md` in un visualizzatore Markdown per configurare il tuo progetto. + + 1. Apri il tuo progetto `platforms/ios` in Xcode. + +3. Esegui la tua applicazione. + + +## Esecuzione del tuo progetto Cordova in Android Studio +{: #run_cordova_studio} + +1. Estrai il file `BasicProject-Cordova.zip`. + +2. Apri il file `README.md` in un visualizzatore Markdown per configurare il tuo progetto. + + 1. Apri il tuo progetto `platforms/android` in Android Studio. + +3. Esegui la tua applicazione. + + +## Esecuzione del tuo progetto Android in Android Studio +{: #run_android} + +1. Estrai il file `MobileBasicProject-Android.zip`. + +2. Apri il file `README.md` in un visualizzatore Markdown per configurare il tuo progetto. + + 1. Apri il tuo progetto `BasicProject-Android` in Android Studio. + +3. Esegui la tua applicazione. diff --git a/cloudnative/nl/it/tutorial_web.md b/cloudnative/nl/it/tutorial_web.md index 6c58bf403..a4de78916 100644 --- a/cloudnative/nl/it/tutorial_web.md +++ b/cloudnative/nl/it/tutorial_web.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Esercitazione end-to-end dello starter di base web -{: #tutorial} - -La seguente esercitazione end-to-end spiega i passi per creare un progetto da uno starter di base web, inclusi gli strumenti che devi avere installato e, successivamente, i passi per eseguire il codice del progetto. - -## Installazione degli strumenti per sviluppatori -{: #dev_tools} - -Assicurati di aver installato gli [strumenti per sviluppatori prerequisiti ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](get_code.html#prereq-dev-tools){: new_window}. - - -## Creazione di un progetto utilizzando la {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Crea un progetto nella {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Dalla pagina **Introduzione** nella {{site.data.keyword.dev_console}}, fai clic su **Crea progetto**. - - In alternativa puoi fare clic su **Crea progetto** dalla pagina **Progetti**. - - 2. Seleziona **Applicazione web** e fai clic su **Avanti**. - - 3. Seleziona **Web di base** e fai clic su **Avanti**. - - 4. Immetti il nome del tuo progetto. Per questa esercitazione, utilizza `WebBasicProject`. - - 5. Immetti un nome host. Per questa esercitazione, utilizza `devhost` - - 6. Selezionare la tua piattaforma di linguaggio. Per questa esercitazione, utilizza `Swift`. - - 7. Fai clic su **Crea**. - -2. Facoltativo: aggiungi la funzionalità Data. - - 1. Fai clic su **Visualizza** per **Data** nella pagina **Panoramica progetto**. - - In alternativa, puoi fare selezionare **Crea** o **Aggiungi esistente** nella pagina **Funzionalità > Dati**. - - 2. Immetti il nome del tuo servizio e fai clic su **Crea**. - - -3. Genera il tuo codice del progetto. - - 1. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. - - In alternativa puoi fare clic sulla pagina **Codice**. - - 2. Fai clic su **Genera codice**. - - 3. Quando il codice del progetto ha terminato la generazione, fai clic su **Scarica codice** per scaricare il tuo archivio del progetto. - -4. Facoltativo: [Aggiorna il tuo progetto](project_overview_page.html#update_language) per generare un nuovo linguaggio. - - -## Creazione di un progetto utilizzando la {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assicurati di aver installato la [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. Nella tua finestra del terminale, passa a una directory locale di tua scelta ed esegui il seguente comando. - - ``` - bx dev create - ``` - {: codeblock} - - -3. Fornisci i seguenti valori quando richiesto: - - * Seleziona un modello: 1 (per Web) - * Seleziona uno starter: 1 (per Web di base) - * Seleziona un linguaggio: 2 (per Swift) - * Immetti un nome per il tuo progetto: `WebBasicProjectCLI` - * Immetti un nome host per il tuo progetto: `myhost` - -4. Se desideri aggiungere servizi al tuo progetto, immetti `y` quando ti viene domandato e rispondi alle rimanenti domande. - -5. Quando il tuo progetto `WebBasicProjectCLI` è stato correttamente salvato, passa alla cartella `WebBasicProjectCLI`. - -6. Aggiungi il tuo proprio codice, crea o esegui il progetto. - - 1. Crea il progetto con il seguente comando: - - ``` - bx dev build - ``` - {: codeblock} - - 2. Esegui il progetto con il seguente comando: - - ``` - bx dev run - ``` - {: codeblock} - - -## Esecuzione di un progetto web -{: #run} - -### Localmente -{: #local notoc} - -1. Installa le tue dipendenze del nodo: - - ``` - npm install - ``` - {: codeblock} - -2. Integra il tuo codice di frontend in un modulo: - - ``` - node_modules/.bin/gulp - ``` - {: codeblock} - -3. Compila il tuo server: - - ``` - swift build - ``` - {: codeblock} - -4. Esegui la tua applicazione: - - ``` - .build/debug/WebBasicProjectCLI - ``` - {: codeblock} - -5. Apri il tuo browser in `http://localhost:8080`. - - -### Utilizzo della {{site.data.keyword.dev_cli_short}} -{: #dev notoc} - -1. Installa le dipendenze del nodo: - - ``` - npm install - ``` - {: codeblock} - -2. Integra il tuo codice di frontend in un modulo: - - ``` - gulp - ``` - {: codeblock} - -3. Esegui la compilazione: - - ``` - bx dev run - ``` - {: codeblock} - -4. Apri il tuo browser in `http://localhost:8080`. - - -## Esecuzione del tuo progetto in Xcode -{: #Xcode} - -1. Crea un progetto Xcode. - - Prima di poter sviluppare in Xcode, devi utilizzare il gestore del pacchetto Swift per creare un progetto Xcode. - - ``` - swift project generate-xcodeproj - ``` - {: codeblock} - -2. Modifica la tua destinazione attiva con l'eseguibile: - - Successivamente, apri il tuo progetto in Xcode e assicurati che la tua destinazione attiva sia l'eseguibile. Puoi tenere premuto il tasto dell'opzione mentre fai clic sul menu a discesa per selezionare l'eseguibile attivo desiderato. - -3. Premi **run**. - -4. Apri il tuo browser in `http://localhost:8080`. - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Esercitazione end-to-end dello starter di base web +{: #tutorial} + +La seguente esercitazione end-to-end spiega i passi per creare un progetto da uno starter di base web, inclusi gli strumenti che devi avere installato e, successivamente, i passi per eseguire il codice del progetto. + +## Installazione degli strumenti per sviluppatori +{: #dev_tools} + +Assicurati di aver installato gli [strumenti per sviluppatori prerequisiti ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](get_code.html#prereq-dev-tools){: new_window}. + + +## Creazione di un progetto utilizzando la {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Crea un progetto nella {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Dalla pagina **Introduzione** nella {{site.data.keyword.dev_console}}, fai clic su **Crea progetto**. + + In alternativa puoi fare clic su **Crea progetto** dalla pagina **Progetti**. + + 2. Seleziona **Applicazione web** e fai clic su **Avanti**. + + 3. Seleziona **Web di base** e fai clic su **Avanti**. + + 4. Immetti il nome del tuo progetto. Per questa esercitazione, utilizza `WebBasicProject`. + + 5. Immetti un nome host. Per questa esercitazione, utilizza `devhost` + + 6. Selezionare la tua piattaforma di linguaggio. Per questa esercitazione, utilizza `Swift`. + + 7. Fai clic su **Crea**. + +2. Facoltativo: aggiungi la funzionalità Data. + + 1. Fai clic su **Visualizza** per **Data** nella pagina **Panoramica progetto**. + + In alternativa, puoi fare selezionare **Crea** o **Aggiungi esistente** nella pagina **Funzionalità > Dati**. + + 2. Immetti il nome del tuo servizio e fai clic su **Crea**. + + +3. Genera il tuo codice del progetto. + + 1. Fai clic su **Richiama codice** nella pagina **Panoramica progetto** per selezionare il tuo linguaggio. + + In alternativa puoi fare clic sulla pagina **Codice**. + + 2. Fai clic su **Genera codice**. + + 3. Quando il codice del progetto ha terminato la generazione, fai clic su **Scarica codice** per scaricare il tuo archivio del progetto. + +4. Facoltativo: [Aggiorna il tuo progetto](project_overview_page.html#update_language) per generare un nuovo linguaggio. + + +## Creazione di un progetto utilizzando la {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assicurati di aver installato la [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. Nella tua finestra del terminale, passa a una directory locale di tua scelta ed esegui il seguente comando. + + ``` + bx dev create + ``` + {: codeblock} + + +3. Fornisci i seguenti valori quando richiesto: + + * Seleziona un modello: 1 (per Web) + * Seleziona uno starter: 1 (per Web di base) + * Seleziona un linguaggio: 2 (per Swift) + * Immetti un nome per il tuo progetto: `WebBasicProjectCLI` + * Immetti un nome host per il tuo progetto: `myhost` + +4. Se desideri aggiungere servizi al tuo progetto, immetti `y` quando ti viene domandato e rispondi alle rimanenti domande. + +5. Quando il tuo progetto `WebBasicProjectCLI` è stato correttamente salvato, passa alla cartella `WebBasicProjectCLI`. + +6. Aggiungi il tuo proprio codice, crea o esegui il progetto. + + 1. Crea il progetto con il seguente comando: + + ``` + bx dev build + ``` + {: codeblock} + + 2. Esegui il progetto con il seguente comando: + + ``` + bx dev run + ``` + {: codeblock} + + +## Esecuzione di un progetto web +{: #run} + +### Localmente +{: #local notoc} + +1. Installa le tue dipendenze del nodo: + + ``` + npm install + ``` + {: codeblock} + +2. Integra il tuo codice di frontend in un modulo: + + ``` + node_modules/.bin/gulp + ``` + {: codeblock} + +3. Compila il tuo server: + + ``` + swift build + ``` + {: codeblock} + +4. Esegui la tua applicazione: + + ``` + .build/debug/WebBasicProjectCLI + ``` + {: codeblock} + +5. Apri il tuo browser in `http://localhost:8080`. + + +### Utilizzo della {{site.data.keyword.dev_cli_short}} +{: #dev notoc} + +1. Installa le dipendenze del nodo: + + ``` + npm install + ``` + {: codeblock} + +2. Integra il tuo codice di frontend in un modulo: + + ``` + gulp + ``` + {: codeblock} + +3. Esegui la compilazione: + + ``` + bx dev run + ``` + {: codeblock} + +4. Apri il tuo browser in `http://localhost:8080`. + + +## Esecuzione del tuo progetto in Xcode +{: #Xcode} + +1. Crea un progetto Xcode. + + Prima di poter sviluppare in Xcode, devi utilizzare il gestore del pacchetto Swift per creare un progetto Xcode. + + ``` + swift project generate-xcodeproj + ``` + {: codeblock} + +2. Modifica la tua destinazione attiva con l'eseguibile: + + Successivamente, apri il tuo progetto in Xcode e assicurati che la tua destinazione attiva sia l'eseguibile. Puoi tenere premuto il tasto dell'opzione mentre fai clic sul menu a discesa per selezionare l'eseguibile attivo desiderato. + +3. Premi **run**. + +4. Apri il tuo browser in `http://localhost:8080`. + diff --git a/cloudnative/nl/it/tutorials.md b/cloudnative/nl/it/tutorials.md index 096abd134..515fe4005 100644 --- a/cloudnative/nl/it/tutorials.md +++ b/cloudnative/nl/it/tutorials.md @@ -1,49 +1,49 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Esercitazioni end-to-end -{: #tutorial} - -Le seguenti esercitazioni end-to-end spiegano i passi per creare un progetto da {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, inclusi gli strumenti che devi avere installato e, successivamente, i passi per eseguire il codice del tuo progetto. - -## Web -{: #web notoc} - -* [Esercitazione di base web](tutorial_web.html) - - -## Mobile -{: #mobile notoc} - -* [Esercitazione di base mobile](tutorial_mobile.html) - - - - -## BFF -{: #bff notoc} - -* [Esercitazione di base BFF](tutorial_bff.html) - - -## Microservizio -{: #microservice notoc} - -* [Esercitazione di base microservizio](tutorial_microservice.html) +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Esercitazioni end-to-end +{: #tutorial} + +Le seguenti esercitazioni end-to-end spiegano i passi per creare un progetto da {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, inclusi gli strumenti che devi avere installato e, successivamente, i passi per eseguire il codice del tuo progetto. + +## Web +{: #web notoc} + +* [Esercitazione di base web](tutorial_web.html) + + +## Mobile +{: #mobile notoc} + +* [Esercitazione di base mobile](tutorial_mobile.html) + + + + +## BFF +{: #bff notoc} + +* [Esercitazione di base BFF](tutorial_bff.html) + + +## Microservizio +{: #microservice notoc} + +* [Esercitazione di base microservizio](tutorial_microservice.html) diff --git a/cloudnative/nl/it/what_is_new.md b/cloudnative/nl/it/what_is_new.md index ced8eb106..0af05fe5d 100644 --- a/cloudnative/nl/it/what_is_new.md +++ b/cloudnative/nl/it/what_is_new.md @@ -1,97 +1,97 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Novità in {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} -{: #what-is-new} - - -## Novità a partire da marzo 2017 -{: #mar-2017} - -L'aggiornamento di marzo 2017 della {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} introduce le seguenti modifiche: - - * Il dashboard mobile {{site.data.keyword.Bluemix_notm}} è ora la {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}. - * La creazione del progetto è stata riprogettata per includere i tipi di modello del server Applicazione web, BFF e Microservizio con il supporto per Node.js, Java e Swift. - * L'integrazione con il nuovo e migliorato servizio {{site.data.keyword.appid_full}} fornisce l'autenticazione per i progetti mobili e web. - * Puoi ora anche generare SDK per i tuoi progetti utilizzando il [Plugin SDK Generator](sdk_cli.html). SDK generation nella {{site.data.keyword.dev_console}} è disponibile solo per i progetti mobili. - * Puoi ora anche creare i progetti utilizzando la [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - - -## Novità a partire da gennaio 2017 -{: #jan-2017} - -L'aggiornamento di gennaio 2017 del dashboard {{site.data.keyword.Bluemix_notm}} Mobile introduce le seguenti modifiche: - - * A partire dal 31 gennaio, gli Starter IU sono obsoleti. I progetti esistenti creati da uno Starter IU possono essere utilizzati fino al 30 aprile 2017. Per ulteriori informazioni sulla procedura di migrazione e sulle date di rimozione, vedi il [post del blog relativo agli annunci di deprecazione ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/). -{: deprecated} - * Puoi ora aggiornare il tipo di starter del progetto invece di eliminare il progetto e crearne uno nuovo. - * Puoi ora creare il tuo progetto con uno starter codice [Watson Conversation](tutorial_conversation.html). - * Laddove supportato, puoi ora generare un SDK per il tuo progetto. - * Puoi ora aggiungere le tue istanze [Calcolo](sdk_compute.html) esistenti e generare SDK client da aggiungere al tuo progetto. - - -## Novità a partire da dicembre 2016 -{: #dec-2016} - -L'aggiornamento di dicembre 2016 del dashboard {{site.data.keyword.Bluemix_notm}} Mobile introduce le seguenti modifiche: - - * Puoi ora rimuovere un servizio connesso da un progetto in modo da poterlo eliminare o riutilizzare con un altro progetto. - * Puoi ora aggiungere un servizio esistente a un progetto. - * Puoi ora creare o connettere un servizio CloudantNoSQL esistente come origine dati quando utilizzi uno Starter codice. - * Laddove supportato, puoi ora creare o connettere un servizio Object Storage esistente come origine dati per il tuo progetto. - * Puoi ora personalizzare il progetto di navigazione dell'applicazione che crei con uno Starter IU. - - -## Novità a partire da novembre 2016 -{: #nov-2016} - -L'aggiornamento di novembre 2016 del dashboard {{site.data.keyword.Bluemix_notm}} Mobile introduce le seguenti modifiche: - - * Puoi ora generare le risorse SDK per i tuoi progetti dalla pagina **Codice**. - * Cordova è ora supportato per lo starter codice di base. - * Puoi ora [segnalare gli eventi di rete ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} e [monitorare le richieste di rete ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} nella pagina **Richieste di rete** della console {{site.data.keyword.mobileanalytics_short}}. - * Puoi ora [esportare i dati in dashDB ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} nella console {{site.data.keyword.mobileanalytics_short}}. - - -## Novità a partire da ottobre 2016 -{: #oct-2016} - -L'aggiornamento di ottobre 2016 del dashboard {{site.data.keyword.Bluemix_notm}} Mobile introduce le seguenti modifiche: - - * Puoi ora aggiungere le funzionalità {{site.data.keyword.mobilepushshort}} e Analytics al tuo progetto direttamente dal dashboard. - * Gli [Starter codice](starters.html#Code_Starter) sono ora disponibili. - * Puoi aggiungere Authentication ai tuoi progetti creati da uno starter codice. - * Swift è ora supportato. - - -### Analisi -{: #analytics notoc} - - * La modalità demo è abilitata per impostazione predefinita quando aggiungi la funzionalità Analytics. Puoi disattivare la modalità demo per visualizzare le analisi dopo l'esecuzione della tua applicazione. - - -### Builder IU -{: #ui_builder notoc} - - * È ora possibile accedere alla funzionalità **{{site.data.keyword.mobilepushshort}}** dal progetto. - * La scheda **Impostazioni progetto** è stata ridenominata in **Impostazioni**. - * La scheda **Autenticazione** è stata ridenominata in **Accesso utente**. - - -### Codice -{: #code notoc} - - * Il codice Objective-C e Swift generato per iOS utilizza ora CocoaPods per gestire le dipendenze. Questo significa che devi installare CocoaPods. Per installarlo, esegui `sudo gem install cocoapods`. Dopo aver installato CocoaPods, esegui `pod setup` per configurarlo se non è già configurato). Infine, esegui `pod install` per scaricare e installare le dipendenze del progetto necessarie prima di aprire il tuo file `.xcworkspace` in Xcode. Ulteriori dettagli sono disponibili nel file `README.md` nell'archivio del codice scaricato. Per ulteriori informazioni, vedi [Strumenti per sviluppatori prerequisiti](get_code.html#prereq-dev-tools). - -Controlla frequentemente di essere al passo con i nuovi aggiornamenti. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Novità in {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} +{: #what-is-new} + + +## Novità a partire da marzo 2017 +{: #mar-2017} + +L'aggiornamento di marzo 2017 della {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} introduce le seguenti modifiche: + + * Il dashboard mobile {{site.data.keyword.Bluemix_notm}} è ora la {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}. + * La creazione del progetto è stata riprogettata per includere i tipi di modello del server Applicazione web, BFF e Microservizio con il supporto per Node.js, Java e Swift. + * L'integrazione con il nuovo e migliorato servizio {{site.data.keyword.appid_full}} fornisce l'autenticazione per i progetti mobili e web. + * Puoi ora anche generare SDK per i tuoi progetti utilizzando il [Plugin SDK Generator](sdk_cli.html). SDK generation nella {{site.data.keyword.dev_console}} è disponibile solo per i progetti mobili. + * Puoi ora anche creare i progetti utilizzando la [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + + +## Novità a partire da gennaio 2017 +{: #jan-2017} + +L'aggiornamento di gennaio 2017 del dashboard {{site.data.keyword.Bluemix_notm}} Mobile introduce le seguenti modifiche: + + * A partire dal 31 gennaio, gli Starter IU sono obsoleti. I progetti esistenti creati da uno Starter IU possono essere utilizzati fino al 30 aprile 2017. Per ulteriori informazioni sulla procedura di migrazione e sulle date di rimozione, vedi il [post del blog relativo agli annunci di deprecazione ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/). +{: deprecated} + * Puoi ora aggiornare il tipo di starter del progetto invece di eliminare il progetto e crearne uno nuovo. + * Puoi ora creare il tuo progetto con uno starter codice [Watson Conversation](tutorial_conversation.html). + * Laddove supportato, puoi ora generare un SDK per il tuo progetto. + * Puoi ora aggiungere le tue istanze [Calcolo](sdk_compute.html) esistenti e generare SDK client da aggiungere al tuo progetto. + + +## Novità a partire da dicembre 2016 +{: #dec-2016} + +L'aggiornamento di dicembre 2016 del dashboard {{site.data.keyword.Bluemix_notm}} Mobile introduce le seguenti modifiche: + + * Puoi ora rimuovere un servizio connesso da un progetto in modo da poterlo eliminare o riutilizzare con un altro progetto. + * Puoi ora aggiungere un servizio esistente a un progetto. + * Puoi ora creare o connettere un servizio CloudantNoSQL esistente come origine dati quando utilizzi uno Starter codice. + * Laddove supportato, puoi ora creare o connettere un servizio Object Storage esistente come origine dati per il tuo progetto. + * Puoi ora personalizzare il progetto di navigazione dell'applicazione che crei con uno Starter IU. + + +## Novità a partire da novembre 2016 +{: #nov-2016} + +L'aggiornamento di novembre 2016 del dashboard {{site.data.keyword.Bluemix_notm}} Mobile introduce le seguenti modifiche: + + * Puoi ora generare le risorse SDK per i tuoi progetti dalla pagina **Codice**. + * Cordova è ora supportato per lo starter codice di base. + * Puoi ora [segnalare gli eventi di rete ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} e [monitorare le richieste di rete ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} nella pagina **Richieste di rete** della console {{site.data.keyword.mobileanalytics_short}}. + * Puoi ora [esportare i dati in dashDB ![Icona link esterno](../icons/launch-glyph.svg "Icona link esterno")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} nella console {{site.data.keyword.mobileanalytics_short}}. + + +## Novità a partire da ottobre 2016 +{: #oct-2016} + +L'aggiornamento di ottobre 2016 del dashboard {{site.data.keyword.Bluemix_notm}} Mobile introduce le seguenti modifiche: + + * Puoi ora aggiungere le funzionalità {{site.data.keyword.mobilepushshort}} e Analytics al tuo progetto direttamente dal dashboard. + * Gli [Starter codice](starters.html#Code_Starter) sono ora disponibili. + * Puoi aggiungere Authentication ai tuoi progetti creati da uno starter codice. + * Swift è ora supportato. + + +### Analisi +{: #analytics notoc} + + * La modalità demo è abilitata per impostazione predefinita quando aggiungi la funzionalità Analytics. Puoi disattivare la modalità demo per visualizzare le analisi dopo l'esecuzione della tua applicazione. + + +### Builder IU +{: #ui_builder notoc} + + * È ora possibile accedere alla funzionalità **{{site.data.keyword.mobilepushshort}}** dal progetto. + * La scheda **Impostazioni progetto** è stata ridenominata in **Impostazioni**. + * La scheda **Autenticazione** è stata ridenominata in **Accesso utente**. + + +### Codice +{: #code notoc} + + * Il codice Objective-C e Swift generato per iOS utilizza ora CocoaPods per gestire le dipendenze. Questo significa che devi installare CocoaPods. Per installarlo, esegui `sudo gem install cocoapods`. Dopo aver installato CocoaPods, esegui `pod setup` per configurarlo se non è già configurato). Infine, esegui `pod install` per scaricare e installare le dipendenze del progetto necessarie prima di aprire il tuo file `.xcworkspace` in Xcode. Ulteriori dettagli sono disponibili nel file `README.md` nell'archivio del codice scaricato. Per ulteriori informazioni, vedi [Strumenti per sviluppatori prerequisiti](get_code.html#prereq-dev-tools). + +Controlla frequentemente di essere al passo con i nuovi aggiornamenti. diff --git a/cloudnative/nl/ja/cli.md b/cloudnative/nl/ja/cli.md index 4feb86ce1..f73464591 100644 --- a/cloudnative/nl/ja/cli.md +++ b/cloudnative/nl/ja/cli.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.Bluemix_notm}} CLI のプラグイン -{: #cli} - -{{site.data.keyword.Bluemix}} CLI に以下のプラグインを追加できます。これらのプラグインを使用して、{{site.data.keyword.dev_console}} プロジェクトを作成することができます。 - -* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) -* [{{site.data.keyword.IBM_notm}} SDK Generator プラグイン](sdk_cli.html) +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.Bluemix_notm}} CLI のプラグイン +{: #cli} + +{{site.data.keyword.Bluemix}} CLI に以下のプラグインを追加できます。これらのプラグインを使用して、{{site.data.keyword.dev_console}} プロジェクトを作成することができます。 + +* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) +* [{{site.data.keyword.IBM_notm}} SDK Generator プラグイン](sdk_cli.html) diff --git a/cloudnative/nl/ja/compute.md b/cloudnative/nl/ja/compute.md index 130629ad7..7362bb860 100644 --- a/cloudnative/nl/ja/compute.md +++ b/cloudnative/nl/ja/compute.md @@ -1,181 +1,181 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# コンピュート -{: #compute} - -Web およびモバイル用のクラウド・ネイティブ・デジタル・チャネル・アプリケーションを作成している時のベスト・プラクティスは、デジタル・チャネル専用であるか、または Web とモバイル両方のクライアント・アプリに対して同じデータおよびロジックの統合サポートを提供する Backend for Frontend (BFF) を用意することです。このアーキテクチャーについて詳しくは、[Microservices for web and mobile ![外部リンク・アイコン](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture) を参照してください。 - -以下の図は、BFF アーキテクチャーの概要を示しています。 - -![BFF アーキテクチャー](images/bff-arch.png) - -図 1: BFF アーキテクチャー - -BFF の概念は、共通のビジネス・ロジックと統合ロジックをマイクロサービスまたは高価値の {{site.data.keyword.Bluemix}} クラウド・サービスから取り除くことです。 - -このアーキテクチャーでは、DevOps Services で継続的デリバリー・パイプラインを使用することにより、モバイル・アプリケーションおよび Web アプリケーションに更新をデプロイおよびリリースし、BFF の新しいバージョンをデプロイすることができます。 - -iOS 用の BFF があり、それとは別個の Android 用の BFF がある場合、これらのアプリの機能を配信しているエンジニアリング・チームは、集中管理された API リリース・スケジュールによるフィーチャーのリリースに制約されません。別のチームのリリース・スケジュールに縛られることなく、機能およびフィーチャーを頻繁にリリースできるようにチームを解放することが、マイクロサービス・アーキテクチャーとデジタル・チャネル・アーキテクチャーの共通の目標です。 - - - - -## モバイル・クライアントと Backend for Frontend との統合 -{: #integration} - -モバイル・クライアントと BFF の間の容易な統合を可能にするために、{{site.data.keyword.Bluemix_notm}} は、iOS 用と Android 用のモバイル・クライアント SDK の生成を、それぞれ Swift 言語と Java 言語でサポートしています。このフィーチャーを有効にするには、Open API 仕様 (Swagger) 文書を使用して BFF 統合を公開する必要があります。この資料は、JSON または YAML の形式の場合があります。 - -クライアント SDK 生成プログラムは、Open API 定義ファイルを使用して、ネイティブ・モバイル・アプリケーションに容易に取り込むことができる、クライアント用に最適化された Developer SDK を定義します。これにより、モバイル・アプリケーションへの BFF の統合が加速されます。 - - -## API の定義 -{: #definition} - -BFF は、稼働中のサーバー・エンドポイントで実行されている Open API 仕様に準拠した API 定義ファイルを公開する必要があります。{{site.data.keyword.Bluemix_notm}} Developer Experience と {{site.data.keyword.Bluemix_notm}} SDK CLI (コマンド・ライン・インターフェース) がこのエンドポイントを検出できるようにするには、`OPENAPI_SPEC` と呼ばれる環境変数を Cloud Foundry アプリケーションに追加する必要があります。この環境変数は、相対パスを使用して仕様を参照している必要があります。 - -`OPENAPI_SPEC` 環境変数を {{site.data.keyword.Bluemix_notm}} に追加するには、以下のステップを実行してください。 - -1. [{{site.data.keyword.Bluemix_notm}} ![外部リンク・アイコン](../icons/launch-glyph.svg)](http://bluemix.net) にログインします。 -2. Cloud Foundry アプリを選択します。 -3. **「ランタイム」**を選択します。 -4. **「環境変数」**を選択します。 -5. **「ユーザー定義」**セクションで**「追加」**をクリックします。 -6. **「名前」**に `OPENAPI_SPEC` を指定し、Open API 定義ファイルの相対 URL パスを指定します。 -7. **「保存」**をクリックします。 - - - -以下に例を示します。 - -``` -OPENAPI_SPEC='/explorer/swagger.json' -``` -{: codeblock} - -{{site.data.keyword.apiconnect_long}} および Loopback アプリケーションは、このアプローチを使用すると特によく機能します。Loopback と {{site.data.keyword.apiconnect_short}} を使用してパーシスタント・モデルを定義し、Open API 定義ファイルを使用して CRUD (Create、Read、Update、および Delete) の各操作を公開できます。 - -また、ビジネス・ロジック操作も定義することができます。 - - -### Open API 仕様のサポートされる要素 -{: #supported-elements notoc} - -Open API 仕様において、ファイル構造のみが完全にサポートされていません。この仕様は、定義の部分がさまざまなファイルに分割されること、および JSON の `$ref` フィールドを使用して参照されることを許可しています。定義全体を、1 つのファイル内に含める必要があります。 - - -## Bluegen を使用した Backend for Frontend の例 -{: #bff-bluegen} - -{{site.data.keyword.Bluemix_notm}} は、{{site.data.keyword.apiconnect_short}} と Strongloop を使用して参照 BFF を作成しました。この参照 BFF は、{{site.data.keyword.objectstorageshort}} でイメージを参照するために、製品モデルを {{site.data.keyword.cloudant}} およびイメージ API にマップします。 - -この BFF パターンを使用して、完全に機能する BFF の {{site.data.keyword.Bluemix_notm}} へのプロビジョニングを素早く開始し、それを使用して、BFF をモバイル・プロジェクトに統合し、iOS 用と Android 用のネイティブ SDK をそれぞれ Swift と Java で生成することがどれほど簡単かを理解するのに役立てることができます。 - -プロジェクトを作成してインストールするための、[README ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) の説明に従ってください。 - - -## Developer Experience プロジェクトでの Backend for Frontend の使用 -{: #bff-devex} - -{{site.data.keyword.Bluemix_notm}} Mobile Developer Experience は、多くのクラウド・サービスが関連付けられたモバイル・プロジェクトの定義をシンプルにするように設計されています。[{{site.data.keyword.mobilepushshort}} ![外部リンク・アイコン](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html)、[Analytics ![外部リンク・アイコン](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html)、および Data サービスまたは Storage サービスを容易に追加することができます。 - -{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} では、**「コンピュート」**ページで BFF をモバイル・プロジェクトに統合する機能が導入されました。既存のコンピュート・サービス・インスタンスをモバイル・プロジェクトに追加することができます。それらが追加された後は、選択した言語用のネイティブ SDK を生成するか、フル・プロジェクトを生成できます。SDK は、**「コード」**ページでプロジェクトのソース・パッケージに統合されます。これは、既に適切に定義されている BFF と統合する際に特に役立ちます。 - -プロジェクトをダウンロードしたら、それを Xcode または Android Studio で開き、クライアント SDK を使用してプロジェクトをコンパイルすることができます。 - - -## CLI の使用 -{: #cli} - -BFF を開発している時に、API 仕様が変更される場合があります。これらの変更をサポートするために、以下の 2 つのオプションがあります。 - -* プロジェクト全体を再生成して新しい GitHub ブランチを作成し、変更を開発ブランチにマージする。 -* コマンド・ライン (CLI) ツールを使用して SDK を直接再生成し、モバイル・プロジェクトの SDK 部分だけを更新する。 - -CLI を使用するには、CLI を[インストール](sdk_cli.html#installation)する必要があります。 - -以下のコマンドを使用すると、実行できるアクションがリストされます。 - -``` -bluemix sdk -``` -{: codeblock} - -以下のコマンドを使用して、現行の {{site.data.keyword.Bluemix_notm}} スペース内で実行中の Cloud Foundry インスタンスをリストします。 - -``` -bluemix sdk list -``` -{: codeblock} - -各アプリがリストされ、`OPENAPI_SPEC` 環境変数が設定されているかどうか、API が検証されます。`VALID` 列に、緑色のチェック・マークまたは赤色の `X` が表示されます。アプリケーションの `VALID` 列内のチェック・マークは、有効な Open API 定義があることを意味しています。アプリケーションの `VALID` 列内に `X` がある場合は、次の 2 つのうちのいずれかを意味しています。 - -* アプリケーションに対して `OPENAPI_SPEC` 環境変数が定義されていない -* Open API 仕様に関して API 定義が無効である - -以下のコマンドを使用して、API の完全形式の URL を表示します。API 仕様の完全形式の経路と URI がリストされます。そのロー仕様をブラウザーで表示したり、CLI に直接取り込んだり、BFF の `OPENAPI_SPEC` 環境変数が正しく設定されているかどうかを確認したりできます。 - -``` -bluemix sdk list --url -``` -{: codeblock} - -以下のコマンドを使用して、`` の Open API 定義ファイルを検証し、それを使用して SDK を生成できるかどうかを判別します。このコマンドは、現行スペース内の `` を検出し、`OPENAPI_SPEC` 環境変数内の相対パスを使用して、検証する仕様を見つけます。 - -``` -bluemix sdk validate -``` -{: codeblock} - -以下のコマンドを使用して、選択したネイティブ `` 用の SDK を生成し、圧縮ファイルを現行作業ディレクトリーに入れます。 - -``` -bluemix sdk generate -- -``` -{: codeblock} - -`--unzip` オプションを使用すると、SDK が自動的に現行作業ディレクトリーに抽出されます。`--output` オプションを使用して、SDK の抽出場所をオプションで指定できます。GitHub でソース・コードを管理し、SDK の更新専用の新しいブランチを作成することができます。このアプローチを使用すると、変更を表示し、更新された SDK を開発ブランチにマージすることが容易になります。 - - -## SDK の生成されたモデルおよび API を使用した作業 -{: #models-apis} - -これで、生成された SDK を使用して BFF がモバイル・アプリに統合されたので、それを使用した作業を開始することができます。 - -SDK には、`docs` ディレクトリーと `source` ディレクトリー内に、完全に生成された資料が付いてきます。資料の Web ビュー用に `README.html` ファイルを開くか、資料の Markdown ビュー用に `README.md` ファイルを開くことができます。Markdown 資料は、SDK を Cocoapods または Maven Central に公開する際に役立ちます。 - -資料内で、生成された API のリストを表示できます。API をクリックすると、モバイル・アプリに直接貼り付けることができるコード・スニペットが表示されます。 +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# コンピュート +{: #compute} + +Web およびモバイル用のクラウド・ネイティブ・デジタル・チャネル・アプリケーションを作成している時のベスト・プラクティスは、デジタル・チャネル専用であるか、または Web とモバイル両方のクライアント・アプリに対して同じデータおよびロジックの統合サポートを提供する Backend for Frontend (BFF) を用意することです。このアーキテクチャーについて詳しくは、[Microservices for web and mobile ![外部リンク・アイコン](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture) を参照してください。 + +以下の図は、BFF アーキテクチャーの概要を示しています。 + +![BFF アーキテクチャー](images/bff-arch.png) + +図 1: BFF アーキテクチャー + +BFF の概念は、共通のビジネス・ロジックと統合ロジックをマイクロサービスまたは高価値の {{site.data.keyword.Bluemix}} クラウド・サービスから取り除くことです。 + +このアーキテクチャーでは、DevOps Services で継続的デリバリー・パイプラインを使用することにより、モバイル・アプリケーションおよび Web アプリケーションに更新をデプロイおよびリリースし、BFF の新しいバージョンをデプロイすることができます。 + +iOS 用の BFF があり、それとは別個の Android 用の BFF がある場合、これらのアプリの機能を配信しているエンジニアリング・チームは、集中管理された API リリース・スケジュールによるフィーチャーのリリースに制約されません。別のチームのリリース・スケジュールに縛られることなく、機能およびフィーチャーを頻繁にリリースできるようにチームを解放することが、マイクロサービス・アーキテクチャーとデジタル・チャネル・アーキテクチャーの共通の目標です。 + + + + +## モバイル・クライアントと Backend for Frontend との統合 +{: #integration} + +モバイル・クライアントと BFF の間の容易な統合を可能にするために、{{site.data.keyword.Bluemix_notm}} は、iOS 用と Android 用のモバイル・クライアント SDK の生成を、それぞれ Swift 言語と Java 言語でサポートしています。このフィーチャーを有効にするには、Open API 仕様 (Swagger) 文書を使用して BFF 統合を公開する必要があります。この資料は、JSON または YAML の形式の場合があります。 + +クライアント SDK 生成プログラムは、Open API 定義ファイルを使用して、ネイティブ・モバイル・アプリケーションに容易に取り込むことができる、クライアント用に最適化された Developer SDK を定義します。これにより、モバイル・アプリケーションへの BFF の統合が加速されます。 + + +## API の定義 +{: #definition} + +BFF は、稼働中のサーバー・エンドポイントで実行されている Open API 仕様に準拠した API 定義ファイルを公開する必要があります。{{site.data.keyword.Bluemix_notm}} Developer Experience と {{site.data.keyword.Bluemix_notm}} SDK CLI (コマンド・ライン・インターフェース) がこのエンドポイントを検出できるようにするには、`OPENAPI_SPEC` と呼ばれる環境変数を Cloud Foundry アプリケーションに追加する必要があります。この環境変数は、相対パスを使用して仕様を参照している必要があります。 + +`OPENAPI_SPEC` 環境変数を {{site.data.keyword.Bluemix_notm}} に追加するには、以下のステップを実行してください。 + +1. [{{site.data.keyword.Bluemix_notm}} ![外部リンク・アイコン](../icons/launch-glyph.svg)](http://bluemix.net) にログインします。 +2. Cloud Foundry アプリを選択します。 +3. **「ランタイム」**を選択します。 +4. **「環境変数」**を選択します。 +5. **「ユーザー定義」**セクションで**「追加」**をクリックします。 +6. **「名前」**に `OPENAPI_SPEC` を指定し、Open API 定義ファイルの相対 URL パスを指定します。 +7. **「保存」**をクリックします。 + + + +以下に例を示します。 + +``` +OPENAPI_SPEC='/explorer/swagger.json' +``` +{: codeblock} + +{{site.data.keyword.apiconnect_long}} および Loopback アプリケーションは、このアプローチを使用すると特によく機能します。Loopback と {{site.data.keyword.apiconnect_short}} を使用してパーシスタント・モデルを定義し、Open API 定義ファイルを使用して CRUD (Create、Read、Update、および Delete) の各操作を公開できます。 + +また、ビジネス・ロジック操作も定義することができます。 + + +### Open API 仕様のサポートされる要素 +{: #supported-elements notoc} + +Open API 仕様において、ファイル構造のみが完全にサポートされていません。この仕様は、定義の部分がさまざまなファイルに分割されること、および JSON の `$ref` フィールドを使用して参照されることを許可しています。定義全体を、1 つのファイル内に含める必要があります。 + + +## Bluegen を使用した Backend for Frontend の例 +{: #bff-bluegen} + +{{site.data.keyword.Bluemix_notm}} は、{{site.data.keyword.apiconnect_short}} と Strongloop を使用して参照 BFF を作成しました。この参照 BFF は、{{site.data.keyword.objectstorageshort}} でイメージを参照するために、製品モデルを {{site.data.keyword.cloudant}} およびイメージ API にマップします。 + +この BFF パターンを使用して、完全に機能する BFF の {{site.data.keyword.Bluemix_notm}} へのプロビジョニングを素早く開始し、それを使用して、BFF をモバイル・プロジェクトに統合し、iOS 用と Android 用のネイティブ SDK をそれぞれ Swift と Java で生成することがどれほど簡単かを理解するのに役立てることができます。 + +プロジェクトを作成してインストールするための、[README ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) の説明に従ってください。 + + +## Developer Experience プロジェクトでの Backend for Frontend の使用 +{: #bff-devex} + +{{site.data.keyword.Bluemix_notm}} Mobile Developer Experience は、多くのクラウド・サービスが関連付けられたモバイル・プロジェクトの定義をシンプルにするように設計されています。[{{site.data.keyword.mobilepushshort}} ![外部リンク・アイコン](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html)、[Analytics ![外部リンク・アイコン](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html)、および Data サービスまたは Storage サービスを容易に追加することができます。 + +{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} では、**「コンピュート」**ページで BFF をモバイル・プロジェクトに統合する機能が導入されました。既存のコンピュート・サービス・インスタンスをモバイル・プロジェクトに追加することができます。それらが追加された後は、選択した言語用のネイティブ SDK を生成するか、フル・プロジェクトを生成できます。SDK は、**「コード」**ページでプロジェクトのソース・パッケージに統合されます。これは、既に適切に定義されている BFF と統合する際に特に役立ちます。 + +プロジェクトをダウンロードしたら、それを Xcode または Android Studio で開き、クライアント SDK を使用してプロジェクトをコンパイルすることができます。 + + +## CLI の使用 +{: #cli} + +BFF を開発している時に、API 仕様が変更される場合があります。これらの変更をサポートするために、以下の 2 つのオプションがあります。 + +* プロジェクト全体を再生成して新しい GitHub ブランチを作成し、変更を開発ブランチにマージする。 +* コマンド・ライン (CLI) ツールを使用して SDK を直接再生成し、モバイル・プロジェクトの SDK 部分だけを更新する。 + +CLI を使用するには、CLI を[インストール](sdk_cli.html#installation)する必要があります。 + +以下のコマンドを使用すると、実行できるアクションがリストされます。 + +``` +bluemix sdk +``` +{: codeblock} + +以下のコマンドを使用して、現行の {{site.data.keyword.Bluemix_notm}} スペース内で実行中の Cloud Foundry インスタンスをリストします。 + +``` +bluemix sdk list +``` +{: codeblock} + +各アプリがリストされ、`OPENAPI_SPEC` 環境変数が設定されているかどうか、API が検証されます。`VALID` 列に、緑色のチェック・マークまたは赤色の `X` が表示されます。アプリケーションの `VALID` 列内のチェック・マークは、有効な Open API 定義があることを意味しています。アプリケーションの `VALID` 列内に `X` がある場合は、次の 2 つのうちのいずれかを意味しています。 + +* アプリケーションに対して `OPENAPI_SPEC` 環境変数が定義されていない +* Open API 仕様に関して API 定義が無効である + +以下のコマンドを使用して、API の完全形式の URL を表示します。API 仕様の完全形式の経路と URI がリストされます。そのロー仕様をブラウザーで表示したり、CLI に直接取り込んだり、BFF の `OPENAPI_SPEC` 環境変数が正しく設定されているかどうかを確認したりできます。 + +``` +bluemix sdk list --url +``` +{: codeblock} + +以下のコマンドを使用して、`` の Open API 定義ファイルを検証し、それを使用して SDK を生成できるかどうかを判別します。このコマンドは、現行スペース内の `` を検出し、`OPENAPI_SPEC` 環境変数内の相対パスを使用して、検証する仕様を見つけます。 + +``` +bluemix sdk validate +``` +{: codeblock} + +以下のコマンドを使用して、選択したネイティブ `` 用の SDK を生成し、圧縮ファイルを現行作業ディレクトリーに入れます。 + +``` +bluemix sdk generate -- +``` +{: codeblock} + +`--unzip` オプションを使用すると、SDK が自動的に現行作業ディレクトリーに抽出されます。`--output` オプションを使用して、SDK の抽出場所をオプションで指定できます。GitHub でソース・コードを管理し、SDK の更新専用の新しいブランチを作成することができます。このアプローチを使用すると、変更を表示し、更新された SDK を開発ブランチにマージすることが容易になります。 + + +## SDK の生成されたモデルおよび API を使用した作業 +{: #models-apis} + +これで、生成された SDK を使用して BFF がモバイル・アプリに統合されたので、それを使用した作業を開始することができます。 + +SDK には、`docs` ディレクトリーと `source` ディレクトリー内に、完全に生成された資料が付いてきます。資料の Web ビュー用に `README.html` ファイルを開くか、資料の Markdown ビュー用に `README.md` ファイルを開くことができます。Markdown 資料は、SDK を Cocoapods または Maven Central に公開する際に役立ちます。 + +資料内で、生成された API のリストを表示できます。API をクリックすると、モバイル・アプリに直接貼り付けることができるコード・スニペットが表示されます。 diff --git a/cloudnative/nl/ja/dev_cli.md b/cloudnative/nl/ja/dev_cli.md index 95c5790cb..5eb7c5c9f 100644 --- a/cloudnative/nl/ja/dev_cli.md +++ b/cloudnative/nl/ja/dev_cli.md @@ -1,404 +1,404 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.dev_cli_short}} -{: #developercli} - -{{site.data.keyword.dev_cli_long}} では、`dev` プラグインで Web プロジェクトを作成、開発、デプロイするための拡張可能なコマンド駆動型アプローチを提供します。エンドツーエンドのマイクロサービス・アプリケーションを開発しながらコマンド・ライン制御を使用したい開発者に理想的です。 - -{: shortdesc} - -{{site.data.keyword.dev_cli_notm}} では、アプリケーションのビルドおよびテストを容易にするために、2 つのコンテナーを使用します。1 つ目は、アプリケーションのビルドとテストに必要なユーティリティーを含むツール・コンテナーです。このコンテナーの Dockerfile は、[dockerfile-tools](#command-parameters) パラメーターで定義されます。これは、特定のランタイムの開発に通常役立つツールを含むため、開発コンテナーとして考えることもできます。 - -2 つ目のコンテナーは実行コンテナーです。このコンテナーは、例えば {{site.data.keyword.Bluemix}} などで使用するためにデプロイされるのに適した形式のものです。結果として、このコンテナーには一般的に、アプリケーションを開始するエントリー・ポイントが定義されます。{{site.data.keyword.dev_cli_short}} でアプリケーションを実行することを選択すると、このコンテナーが使用されます。このコンテナーの Dockerfile は、[dockerfile-run](#run-parameters) パラメーターで定義されます。 - - -## {{site.data.keyword.dev_cli_notm}} の追加 -{: #add-cli} - - -### 前提条件 -{: #prereq} - -{{site.data.keyword.dev_cli_short}} は高度に拡張可能であり、追加の無料テクノロジーを活用できるようにするものであるため、これをフルに探索して適切に使用するにはいくつかの必要な前提条件があります。 - -1. [Cloud Foundry CLI ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/cloudfoundry/cli#getting-started) をインストールします。 - -2. [{{site.data.keyword.Bluemix}} CLI ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://clis.ng.bluemix.net/ui/home.html) をインストールします。 - -3. [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net) ID を入手します。 - -4. オプション: ローカルでのアプリケーションの実行およびデバッグを予定している場合は、[Docker ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.docker.com/get-docker) のインストールも必要です。これは、非モバイル・プロジェクトにのみ必要です。 - - -### インストール -{: #installation} - -1. 以下のコマンドを実行して、[{{site.data.keyword.dev_cli_short}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} をインストールします。 - - ``` - bx plugin install dev -r Bluemix - ``` - {: codeblock} - -2. 以下のコマンドを実行して、インストールが成功したことを確認します。 - - ``` - bx dev - ``` - {: codeblock} - - -### 始めに -{: #before-install} - -1. {{site.data.keyword.Bluemix_notm}} にログインします。 - - ``` - bx login - ``` - {: codeblock} - - **注:** 資格情報が拒否された場合、フェデレーテッド ID を使用している可能性があります。フェデレーテッド ID を使用して認証するには、以下のステップに従ってください。 - - - - 1. [{{site.data.keyword.iamshort}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.bluemix.net/iam/#/apikeys){: new_window} にログインします。 - 2. **「API キーの作成」**を選択します。 - * apiKey の名前と説明を入力します。 - 3. apiKey をダウンロードします。 - 4. ファイルを開いて、`apiKey` フィールドから値をコピーします。 - 5. 以下のコマンドを使用してログインします。 - - ``` - bx login --apikey - ``` - {: codeblock} - - -## コマンド -{: #commands} - -プロジェクトの作成、デプロイ、デバッグ、およびテストには、以下のコマンドを使用します。 - -### build -{: #build} - -`build` コマンドを使用してアプリケーションをビルドすることができます。アプリケーションのビルドには、`build-cmd-run` 構成エレメントが使用されます。`test`、`debug`、および `run` の各コマンドもすべて、通常操作の中でこのコマンドと同様にビルドを実行します。そのため、これらの前に build コマンドを実行する必要はありません。 - -アプリケーションをビルドするには、現行プロジェクト・ディレクトリーで以下のコマンドを実行します。 - -``` -bx dev build -``` -{: codeblock} - - -[build コマンドのパラメーター](#command-parameters) - - -### code -{: #code} - -`code` コマンドを使用して、デプロイ後にアプリケーション・コードをダウンロードできます。これにより、ローカルで確認したり、追加の変更を行ったりすることができます。 - -指定されたプロジェクトからコードをダウンロードするには、以下のコマンドを実行します。 - -``` -bx dev code -``` -{: codeblock} - - -### create -{: #create} - -新規プロジェクトを作成します。言語、プロジェクト名、アプリ・パターン・タイプなど、必要な情報がすべて求められます。プロジェクトは現行ディレクトリーに作成されます。 - -現行プロジェクト・ディレクトリーに新規プロジェクトを作成して、それにサービスを関連付けるには、以下のコマンドを実行します。 - -``` -bx dev create -``` -{: codeblock} - - -### debug -{: #debug} - -`debug` コマンドを使用してアプリケーションをデバッグすることができます。まず、ビルド命令として `build-cmd-debug` 構成エレメントを使用してプロジェクトに対してビルドが実行されます。その後、`container-port-map-debug` で定義されたデバッグ・ポート (複数可) を公開してコンテナーが開始されます。任意のデバッグ・ツールをポートに接続して、アプリケーションを通常どおりデバッグできます。 - -**制限事項**: 現在、Swift プロジェクトはデバッグに使用できません。 - -アプリケーションをデバッグするには、現行プロジェクト・ディレクトリーで以下のコマンドを実行します。 - -``` -bx dev debug -``` -{: codeblock} - -デバッグ・セッションを終了するには、`CTRL-C` を使用します。 - - -#### debug コマンドのパラメーター -{: #debug-parameters} - -以下のパラメーターは `debug` コマンド専用で、アプリケーションのデバッグを支援します。 - -##### `container-port-map-debug` -{: #port-map-debug} - -* デバッグ・ポートのポート・マッピング。最初の値は、ホスト OS で使用するポートで、2 つ目の値はコンテナー内のポートです (host:container)。 -* 使用法: `bx dev debug container-port-map-debug [7777:7777]` - -##### `build-cmd-debug` -{: #build-cmd-debug} - -* デバッグのためにコードをビルドするのに使用されます。 -* 使用法: `bx dev debug build-cmd-debug build.command.sh` - -##### `debug-cmd` -{: #debug-cmd} - -* ツール・コンテナーでコードをデバッグするのに使用されます。`build-cmd-debug` がデバッグでアプリケーションを開始する場合、これはオプションです。 -* 使用法: `bx dev debug debug-cmd /the/debug/command` - -#### ローカル・アプリケーション・デバッグ: -{: #local-app-dev} - -ローカル・アプリケーション・デバッグについて詳しくは、[ローカル・アプリケーション・デバッグ](docs/cloudnative/dev_cli_local_debug.html#local-debug)を参照してください。 - - -### delete -{: #delete} - -このコマンドを使用して、{{site.data.keyword.Bluemix}} スペースからプロジェクトを削除することができます。 - -{{site.data.keyword.Bluemix}} からプロジェクトを削除するには、以下のコマンドを実行します。 - -``` -bx dev delete -``` -{: codeblock} - - -**注** {{site.data.keyword.Bluemix}} サービスは**削除されません**。 - - -### help -{: #help} - -デフォルトでは、アクションも引数も渡されない場合や、「help」アクションが指定された場合、このコマンドでは一般の「ヘルプ」テキストが表示されます。表示される一般ヘルプには、基本引数の説明と、使用可能なアクションのリストが含まれます。 - -一般ヘルプ情報を表示するには、以下のコマンドを実行します。 - -``` -bx dev help -``` -{: codeblock} - - -### list -{: #list} - -スペース内のすべての {{site.data.keyword.Bluemix_notm}} プロジェクトをリストできます。 - -プロジェクトをリストするには、以下のコマンドを実行します。 - -``` -bx dev list -``` -{: codeblock} - - - - - -### run -{: #run} - -`run` コマンドを使用してアプリケーションを実行することができます。まず、ビルド命令として `build-cmd-run` 構成エレメントを使用してプロジェクトに対してビルドが実行されます。その後、実行コンテナーが開始され、`container-port-map` で定義されたポートを公開します。このステップを完了するためのエントリー・ポイントが実行コンテナーに含まれない場合は、`run-cmd` を使用してアプリケーションを呼び出すことができます。 - -アプリケーションを開始するには、現行プロジェクト・ディレクトリーで以下のコマンドを実行します。 - -``` -bx dev run -``` -{: codeblock} - -セッションを終了するには、`CTRL-C` を使用します。 - - -#### run のパラメーター -{: #run-parameters} - -以下のパラメーターは `run` コマンド専用で、実行コンテナー内でのアプリケーションの管理を支援します。 - -##### `container-name-run` -{: #container-name-run} - -* 実行コンテナーのコンテナー名。 -* 使用法: `bx dev run container-name-run ` - -##### `container-path-run` -{: #container-path-run} - -* 実行に関して共有するコンテナー内の場所。 -* 使用法: `bx dev run container-path-run [/path/to/app]` - -##### `host-path-run` -{: #host-path-run} - -* 実行に関してコンテナーで共有するホスト・システム上の場所。 -* 使用法: `bx dev run host-path-run [/path/to/app/bin]` - -##### `dockerfile-run` -{: #dockerfile-run} - -* 実行コンテナーの Docker ファイル。 -* 使用法: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` - -##### `image-name-run` -{: #image-name-run} - -* dockerfile-run から作成するイメージ。 -* 使用法: `bx dev run image-name-run [/path/to/image-name]` - -##### `run-cmd` -{: #run-cmd} - -* 実行コンテナーでコードを実行するのに使用されるオプション・パラメーター。イメージによってアプリケーションが開始される場合、これはオプションです。 -* 使用法: `bx dev run run-cmd [/the/run/command]` - -### status -{: #status} - -`container-name-run` と `container-name-tools` で定義された、{{site.data.keyword.dev_cli_short}} で使用されるコンテナーの状況を照会できます。 - -コンテナーの状況を確認するには、現行プロジェクト・ディレクトリーで以下のコマンドを実行します。 - -``` -bx dev status -``` -{: codeblock} - - -[status コマンドのパラメーター](#command-parameters) - - -### stop -{: #stop} - -`stop` コマンドを使用してコンテナーを停止することができます。`container-name` パラメーターにより、停止するコンテナーを指定できます。これを指定しないと、stop コマンドは `container-name-run` で定義された実行コンテナーを停止します。 - -コンテナーを停止するには、現行プロジェクト・ディレクトリーで以下のコマンドを実行します。 - -``` -bx dev stop -``` -{: codeblock} - - -#### 追加の stop パラメーター: -{: #stop-parameter} - -##### `container-name` -{: #container-name} - -* ツール・コンテナーのコンテナー名。 -* 使用法: `bx dev stop container-name ` - -### test -{: #test} - -`test` コマンドを使用してアプリケーションをテストすることができます。まず、ビルド命令として `build-cmd-run` 構成エレメントを使用してプロジェクトに対してビルドが実行されます。その後、ツール・コンテナーを使用して、アプリケーションの `test-cmd` を呼び出します。 - -アプリケーションをテストするには、以下のコマンドを実行します。 - -``` -bx dev test -``` -{: codeblock} - - -[test コマンドのパラメーター](#command-parameters) - - -## build、debug、run、および test のパラメーター -{: #command-parameters} - -`build|debug|run|test` コマンドと一緒に、以下のパラメーターを使用できます。これらは、コマンド・ライン、またはプロジェクトの `cli-config.yml` ファイルの直接更新、あるいはその両方で指定可能です。[`debug`](#debug-parameters) コマンドと [`run`](#run-parameters) コマンドには追加のパラメーターが使用可能です。それらについては、個々のセクションに文書化されています。 - -**注**: コマンド・ラインで入力されたコマンド・パラメーターのほうが、`cli-config.yml` の構成より優先されます。 - -##### `container-name-tools` -{: #container-name-tools} - -* ツール・コンテナーのコンテナー名。 -* 使用法: `bx dev container-name-tools []` - -##### `host-path-tools` -{: #host-path-tools} - -* build、debug、test の場合に共有するホスト上の場所。 -* 使用法: `bx dev host-path-tools [/path/to/build/tools]` - -##### `container-path-tools` -{: #container-path-tools} - -* build、debug、test の場合に共有するコンテナー内の場所。 -* 使用法: `bx dev container-path-tools [/path/for/build]` - -##### `container-port-map` -{: #container-port-map} - -* コンテナーのポート・マッピング。最初の値は、ホスト OS で使用するポートで、2 つ目の値はコンテナー内のポートです (host:container)。 -* 使用法: `bx dev container-port-map [8090:8090,9090,9090]` - -##### `dockerfile-tools` -{: #dockerfile-tools} - -* ツール・コンテナーの Docker ファイル。 -* 使用法: `bx dev dockerfile-tools [path/to/dockerfile]` - -##### `image-name-tools` -{: #image-name-tools} - -* dockerfile-tools から作成するイメージ。 -* 使用法: `bx dev image-name-tools [path/to/image-name]` - -##### `build-cmd-run` -{: #build-cmd-run} - -* デバッグ以外のすべての使用で、コードをビルドするコマンド。 -* 使用法: `bx dev build-cmd-run [some.build.command]` - -##### `test-cmd` -{: #test-cmd} - -* ツール・コンテナーでコードをテストするコマンド。 -* 使用法: `bx dev test-cmd [/the/test/command]` - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.dev_cli_short}} +{: #developercli} + +{{site.data.keyword.dev_cli_long}} では、`dev` プラグインで Web プロジェクトを作成、開発、デプロイするための拡張可能なコマンド駆動型アプローチを提供します。エンドツーエンドのマイクロサービス・アプリケーションを開発しながらコマンド・ライン制御を使用したい開発者に理想的です。 + +{: shortdesc} + +{{site.data.keyword.dev_cli_notm}} では、アプリケーションのビルドおよびテストを容易にするために、2 つのコンテナーを使用します。1 つ目は、アプリケーションのビルドとテストに必要なユーティリティーを含むツール・コンテナーです。このコンテナーの Dockerfile は、[dockerfile-tools](#command-parameters) パラメーターで定義されます。これは、特定のランタイムの開発に通常役立つツールを含むため、開発コンテナーとして考えることもできます。 + +2 つ目のコンテナーは実行コンテナーです。このコンテナーは、例えば {{site.data.keyword.Bluemix}} などで使用するためにデプロイされるのに適した形式のものです。結果として、このコンテナーには一般的に、アプリケーションを開始するエントリー・ポイントが定義されます。{{site.data.keyword.dev_cli_short}} でアプリケーションを実行することを選択すると、このコンテナーが使用されます。このコンテナーの Dockerfile は、[dockerfile-run](#run-parameters) パラメーターで定義されます。 + + +## {{site.data.keyword.dev_cli_notm}} の追加 +{: #add-cli} + + +### 前提条件 +{: #prereq} + +{{site.data.keyword.dev_cli_short}} は高度に拡張可能であり、追加の無料テクノロジーを活用できるようにするものであるため、これをフルに探索して適切に使用するにはいくつかの必要な前提条件があります。 + +1. [Cloud Foundry CLI ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/cloudfoundry/cli#getting-started) をインストールします。 + +2. [{{site.data.keyword.Bluemix}} CLI ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://clis.ng.bluemix.net/ui/home.html) をインストールします。 + +3. [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net) ID を入手します。 + +4. オプション: ローカルでのアプリケーションの実行およびデバッグを予定している場合は、[Docker ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.docker.com/get-docker) のインストールも必要です。これは、非モバイル・プロジェクトにのみ必要です。 + + +### インストール +{: #installation} + +1. 以下のコマンドを実行して、[{{site.data.keyword.dev_cli_short}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} をインストールします。 + + ``` + bx plugin install dev -r Bluemix + ``` + {: codeblock} + +2. 以下のコマンドを実行して、インストールが成功したことを確認します。 + + ``` + bx dev + ``` + {: codeblock} + + +### 始めに +{: #before-install} + +1. {{site.data.keyword.Bluemix_notm}} にログインします。 + + ``` + bx login + ``` + {: codeblock} + + **注:** 資格情報が拒否された場合、フェデレーテッド ID を使用している可能性があります。フェデレーテッド ID を使用して認証するには、以下のステップに従ってください。 + + + + 1. [{{site.data.keyword.iamshort}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.bluemix.net/iam/#/apikeys){: new_window} にログインします。 + 2. **「API キーの作成」**を選択します。 + * apiKey の名前と説明を入力します。 + 3. apiKey をダウンロードします。 + 4. ファイルを開いて、`apiKey` フィールドから値をコピーします。 + 5. 以下のコマンドを使用してログインします。 + + ``` + bx login --apikey + ``` + {: codeblock} + + +## コマンド +{: #commands} + +プロジェクトの作成、デプロイ、デバッグ、およびテストには、以下のコマンドを使用します。 + +### build +{: #build} + +`build` コマンドを使用してアプリケーションをビルドすることができます。アプリケーションのビルドには、`build-cmd-run` 構成エレメントが使用されます。`test`、`debug`、および `run` の各コマンドもすべて、通常操作の中でこのコマンドと同様にビルドを実行します。そのため、これらの前に build コマンドを実行する必要はありません。 + +アプリケーションをビルドするには、現行プロジェクト・ディレクトリーで以下のコマンドを実行します。 + +``` +bx dev build +``` +{: codeblock} + + +[build コマンドのパラメーター](#command-parameters) + + +### code +{: #code} + +`code` コマンドを使用して、デプロイ後にアプリケーション・コードをダウンロードできます。これにより、ローカルで確認したり、追加の変更を行ったりすることができます。 + +指定されたプロジェクトからコードをダウンロードするには、以下のコマンドを実行します。 + +``` +bx dev code +``` +{: codeblock} + + +### create +{: #create} + +新規プロジェクトを作成します。言語、プロジェクト名、アプリ・パターン・タイプなど、必要な情報がすべて求められます。プロジェクトは現行ディレクトリーに作成されます。 + +現行プロジェクト・ディレクトリーに新規プロジェクトを作成して、それにサービスを関連付けるには、以下のコマンドを実行します。 + +``` +bx dev create +``` +{: codeblock} + + +### debug +{: #debug} + +`debug` コマンドを使用してアプリケーションをデバッグすることができます。まず、ビルド命令として `build-cmd-debug` 構成エレメントを使用してプロジェクトに対してビルドが実行されます。その後、`container-port-map-debug` で定義されたデバッグ・ポート (複数可) を公開してコンテナーが開始されます。任意のデバッグ・ツールをポートに接続して、アプリケーションを通常どおりデバッグできます。 + +**制限事項**: 現在、Swift プロジェクトはデバッグに使用できません。 + +アプリケーションをデバッグするには、現行プロジェクト・ディレクトリーで以下のコマンドを実行します。 + +``` +bx dev debug +``` +{: codeblock} + +デバッグ・セッションを終了するには、`CTRL-C` を使用します。 + + +#### debug コマンドのパラメーター +{: #debug-parameters} + +以下のパラメーターは `debug` コマンド専用で、アプリケーションのデバッグを支援します。 + +##### `container-port-map-debug` +{: #port-map-debug} + +* デバッグ・ポートのポート・マッピング。最初の値は、ホスト OS で使用するポートで、2 つ目の値はコンテナー内のポートです (host:container)。 +* 使用法: `bx dev debug container-port-map-debug [7777:7777]` + +##### `build-cmd-debug` +{: #build-cmd-debug} + +* デバッグのためにコードをビルドするのに使用されます。 +* 使用法: `bx dev debug build-cmd-debug build.command.sh` + +##### `debug-cmd` +{: #debug-cmd} + +* ツール・コンテナーでコードをデバッグするのに使用されます。`build-cmd-debug` がデバッグでアプリケーションを開始する場合、これはオプションです。 +* 使用法: `bx dev debug debug-cmd /the/debug/command` + +#### ローカル・アプリケーション・デバッグ: +{: #local-app-dev} + +ローカル・アプリケーション・デバッグについて詳しくは、[ローカル・アプリケーション・デバッグ](docs/cloudnative/dev_cli_local_debug.html#local-debug)を参照してください。 + + +### delete +{: #delete} + +このコマンドを使用して、{{site.data.keyword.Bluemix}} スペースからプロジェクトを削除することができます。 + +{{site.data.keyword.Bluemix}} からプロジェクトを削除するには、以下のコマンドを実行します。 + +``` +bx dev delete +``` +{: codeblock} + + +**注** {{site.data.keyword.Bluemix}} サービスは**削除されません**。 + + +### help +{: #help} + +デフォルトでは、アクションも引数も渡されない場合や、「help」アクションが指定された場合、このコマンドでは一般の「ヘルプ」テキストが表示されます。表示される一般ヘルプには、基本引数の説明と、使用可能なアクションのリストが含まれます。 + +一般ヘルプ情報を表示するには、以下のコマンドを実行します。 + +``` +bx dev help +``` +{: codeblock} + + +### list +{: #list} + +スペース内のすべての {{site.data.keyword.Bluemix_notm}} プロジェクトをリストできます。 + +プロジェクトをリストするには、以下のコマンドを実行します。 + +``` +bx dev list +``` +{: codeblock} + + + + + +### run +{: #run} + +`run` コマンドを使用してアプリケーションを実行することができます。まず、ビルド命令として `build-cmd-run` 構成エレメントを使用してプロジェクトに対してビルドが実行されます。その後、実行コンテナーが開始され、`container-port-map` で定義されたポートを公開します。このステップを完了するためのエントリー・ポイントが実行コンテナーに含まれない場合は、`run-cmd` を使用してアプリケーションを呼び出すことができます。 + +アプリケーションを開始するには、現行プロジェクト・ディレクトリーで以下のコマンドを実行します。 + +``` +bx dev run +``` +{: codeblock} + +セッションを終了するには、`CTRL-C` を使用します。 + + +#### run のパラメーター +{: #run-parameters} + +以下のパラメーターは `run` コマンド専用で、実行コンテナー内でのアプリケーションの管理を支援します。 + +##### `container-name-run` +{: #container-name-run} + +* 実行コンテナーのコンテナー名。 +* 使用法: `bx dev run container-name-run ` + +##### `container-path-run` +{: #container-path-run} + +* 実行に関して共有するコンテナー内の場所。 +* 使用法: `bx dev run container-path-run [/path/to/app]` + +##### `host-path-run` +{: #host-path-run} + +* 実行に関してコンテナーで共有するホスト・システム上の場所。 +* 使用法: `bx dev run host-path-run [/path/to/app/bin]` + +##### `dockerfile-run` +{: #dockerfile-run} + +* 実行コンテナーの Docker ファイル。 +* 使用法: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` + +##### `image-name-run` +{: #image-name-run} + +* dockerfile-run から作成するイメージ。 +* 使用法: `bx dev run image-name-run [/path/to/image-name]` + +##### `run-cmd` +{: #run-cmd} + +* 実行コンテナーでコードを実行するのに使用されるオプション・パラメーター。イメージによってアプリケーションが開始される場合、これはオプションです。 +* 使用法: `bx dev run run-cmd [/the/run/command]` + +### status +{: #status} + +`container-name-run` と `container-name-tools` で定義された、{{site.data.keyword.dev_cli_short}} で使用されるコンテナーの状況を照会できます。 + +コンテナーの状況を確認するには、現行プロジェクト・ディレクトリーで以下のコマンドを実行します。 + +``` +bx dev status +``` +{: codeblock} + + +[status コマンドのパラメーター](#command-parameters) + + +### stop +{: #stop} + +`stop` コマンドを使用してコンテナーを停止することができます。`container-name` パラメーターにより、停止するコンテナーを指定できます。これを指定しないと、stop コマンドは `container-name-run` で定義された実行コンテナーを停止します。 + +コンテナーを停止するには、現行プロジェクト・ディレクトリーで以下のコマンドを実行します。 + +``` +bx dev stop +``` +{: codeblock} + + +#### 追加の stop パラメーター: +{: #stop-parameter} + +##### `container-name` +{: #container-name} + +* ツール・コンテナーのコンテナー名。 +* 使用法: `bx dev stop container-name ` + +### test +{: #test} + +`test` コマンドを使用してアプリケーションをテストすることができます。まず、ビルド命令として `build-cmd-run` 構成エレメントを使用してプロジェクトに対してビルドが実行されます。その後、ツール・コンテナーを使用して、アプリケーションの `test-cmd` を呼び出します。 + +アプリケーションをテストするには、以下のコマンドを実行します。 + +``` +bx dev test +``` +{: codeblock} + + +[test コマンドのパラメーター](#command-parameters) + + +## build、debug、run、および test のパラメーター +{: #command-parameters} + +`build|debug|run|test` コマンドと一緒に、以下のパラメーターを使用できます。これらは、コマンド・ライン、またはプロジェクトの `cli-config.yml` ファイルの直接更新、あるいはその両方で指定可能です。[`debug`](#debug-parameters) コマンドと [`run`](#run-parameters) コマンドには追加のパラメーターが使用可能です。それらについては、個々のセクションに文書化されています。 + +**注**: コマンド・ラインで入力されたコマンド・パラメーターのほうが、`cli-config.yml` の構成より優先されます。 + +##### `container-name-tools` +{: #container-name-tools} + +* ツール・コンテナーのコンテナー名。 +* 使用法: `bx dev container-name-tools []` + +##### `host-path-tools` +{: #host-path-tools} + +* build、debug、test の場合に共有するホスト上の場所。 +* 使用法: `bx dev host-path-tools [/path/to/build/tools]` + +##### `container-path-tools` +{: #container-path-tools} + +* build、debug、test の場合に共有するコンテナー内の場所。 +* 使用法: `bx dev container-path-tools [/path/for/build]` + +##### `container-port-map` +{: #container-port-map} + +* コンテナーのポート・マッピング。最初の値は、ホスト OS で使用するポートで、2 つ目の値はコンテナー内のポートです (host:container)。 +* 使用法: `bx dev container-port-map [8090:8090,9090,9090]` + +##### `dockerfile-tools` +{: #dockerfile-tools} + +* ツール・コンテナーの Docker ファイル。 +* 使用法: `bx dev dockerfile-tools [path/to/dockerfile]` + +##### `image-name-tools` +{: #image-name-tools} + +* dockerfile-tools から作成するイメージ。 +* 使用法: `bx dev image-name-tools [path/to/image-name]` + +##### `build-cmd-run` +{: #build-cmd-run} + +* デバッグ以外のすべての使用で、コードをビルドするコマンド。 +* 使用法: `bx dev build-cmd-run [some.build.command]` + +##### `test-cmd` +{: #test-cmd} + +* ツール・コンテナーでコードをテストするコマンド。 +* 使用法: `bx dev test-cmd [/the/test/command]` + diff --git a/cloudnative/nl/ja/dev_cli_local_debug.md b/cloudnative/nl/ja/dev_cli_local_debug.md index 0dd0c74c7..3caae57e9 100644 --- a/cloudnative/nl/ja/dev_cli_local_debug.md +++ b/cloudnative/nl/ja/dev_cli_local_debug.md @@ -1,76 +1,76 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# ローカル・アプリケーション・デバッグ -{: #local-debug} - -次の言語について、ローカル・アプリケーション・デバッグ手順が下に示されています。 - -* [Java](#java) -* [Node.js](#node) - -**注**: Swift アプリケーションのデバッグは現在サポートされていません。 - -## Java アプリケーションのデバッグ -{: #java} - -Java アプリケーションのデバッグを有効にするステップ - -1. アプリケーション・プロジェクトのルート・ディレクトリーから、以下のコマンドを実行します。 - - `bx dev debug` - -2. デバッガーをアプリケーションに接続します。 - - * [Eclipse ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) - * [IntelliJ ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) - * [VSCode ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) - * JDK コマンド・ライン: `jdb -attach ` - -## Node.js アプリケーションのデバッグ - -{: #node} - -Node.js アプリケーションのデバッグを有効にするステップ - -1. アプリケーション・プロジェクトのルート・ディレクトリーから、以下のコマンドを実行します。 - - `bx dev debug` - -2. デバッガーをアプリケーションに接続します。 - * [VSCode ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://blog.docker.com/2016/07/live-debugging-docker/) - * [WebStorm ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# ローカル・アプリケーション・デバッグ +{: #local-debug} + +次の言語について、ローカル・アプリケーション・デバッグ手順が下に示されています。 + +* [Java](#java) +* [Node.js](#node) + +**注**: Swift アプリケーションのデバッグは現在サポートされていません。 + +## Java アプリケーションのデバッグ +{: #java} + +Java アプリケーションのデバッグを有効にするステップ + +1. アプリケーション・プロジェクトのルート・ディレクトリーから、以下のコマンドを実行します。 + + `bx dev debug` + +2. デバッガーをアプリケーションに接続します。 + + * [Eclipse ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) + * [IntelliJ ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) + * [VSCode ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) + * JDK コマンド・ライン: `jdb -attach ` + +## Node.js アプリケーションのデバッグ + +{: #node} + +Node.js アプリケーションのデバッグを有効にするステップ + +1. アプリケーション・プロジェクトのルート・ディレクトリーから、以下のコマンドを実行します。 + + `bx dev debug` + +2. デバッガーをアプリケーションに接続します。 + * [VSCode ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://blog.docker.com/2016/07/live-debugging-docker/) + * [WebStorm ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) + + + + + diff --git a/cloudnative/nl/ja/devex.md b/cloudnative/nl/ja/devex.md index bf5f19d5b..3d10bd627 100644 --- a/cloudnative/nl/ja/devex.md +++ b/cloudnative/nl/ja/devex.md @@ -1,31 +1,31 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.dev_console}} -{: #devex} - -[{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.{DomainName}/developer/getting-started) を使用し始めるには、{{site.data.keyword.Bluemix_notm}} コンソールから**「Web およびモバイル (Web and Mobile)」**カテゴリーをクリックします。 - - -## 開始 -{: getting-started} - -プロジェクトの作成は**「開始」**ページで**「プロジェクトの作成」**をクリックすることによって行います。[パターン](patterns.html)、[スターター](starters.html)、および[言語](patterns.html#languages)のオプションが提示され、それらを使用することによってアプリを迅速に作成できます。 - -[「プロジェクト」![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.{DomainName}/developer/projects) ページを選択することにより、所有するすべてのプロジェクトを 1 カ所で表示および管理できます。プロジェクトには、アプリに統合されている機能および統合が可能なすべての機能に関する情報が収められています。使用可能であれば、Push (プッシュ)、Analytics (分析)、Authentication (認証)、および Data (データ) サービスをプロジェクトに簡単に統合して管理できます。近い将来、さらに多くの機能がこれらに続く予定です。 - -[「サービス」](services.html)ページには、既存のサービス・インスタンスの操作ビューが表示されます。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} では、クラウド・ネイティブの開発者およびクラウド・ネイティブのアプリ管理ユーザーをサポートします。 - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.dev_console}} +{: #devex} + +[{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.{DomainName}/developer/getting-started) を使用し始めるには、{{site.data.keyword.Bluemix_notm}} コンソールから**「Web およびモバイル (Web and Mobile)」**カテゴリーをクリックします。 + + +## 開始 +{: getting-started} + +プロジェクトの作成は**「開始」**ページで**「プロジェクトの作成」**をクリックすることによって行います。[パターン](patterns.html)、[スターター](starters.html)、および[言語](patterns.html#languages)のオプションが提示され、それらを使用することによってアプリを迅速に作成できます。 + +[「プロジェクト」![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.{DomainName}/developer/projects) ページを選択することにより、所有するすべてのプロジェクトを 1 カ所で表示および管理できます。プロジェクトには、アプリに統合されている機能および統合が可能なすべての機能に関する情報が収められています。使用可能であれば、Push (プッシュ)、Analytics (分析)、Authentication (認証)、および Data (データ) サービスをプロジェクトに簡単に統合して管理できます。近い将来、さらに多くの機能がこれらに続く予定です。 + +[「サービス」](services.html)ページには、既存のサービス・インスタンスの操作ビューが表示されます。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} では、クラウド・ネイティブの開発者およびクラウド・ネイティブのアプリ管理ユーザーをサポートします。 + + + diff --git a/cloudnative/nl/ja/get_code.md b/cloudnative/nl/ja/get_code.md index 47fd8846d..01db7abd9 100644 --- a/cloudnative/nl/ja/get_code.md +++ b/cloudnative/nl/ja/get_code.md @@ -1,80 +1,80 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-18" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# コードの取得 -{: #Get_Code} - -選択された機能でプロジェクトの構成とセットアップを完了したら、実行できるコードをダウンロードできます。ダウンロードしたプロジェクトは、構成した各機能に必要な SDK 依存関係と資格情報で事前構成済みです。 - -ダウンロードしたプロジェクト内で構成可能ではないサービスについては、資格情報の入力が必要になります。スターター・プロジェクトの `README.md` ファイルに指示が含まれています。`README.md` ファイルを Markdown ビューアーで表示して確認し、セットアップを完了してください。 - -## 前提条件開発者ツール -{: #prereq-dev-tools} - -生成されたコードについての作業を {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} から行うときには、以下の開発者ツールが必要です。 - - -### 一般 -{: #general notoc} - -* [Homebrew ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://brew.sh/) - * 他のツールおよびランタイム (CocoaPods や Carthage など) のインストールを支援する、Apple 開発者向けのコマンド・ライン・ツール。 - -* [Docker ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.docker.com/get-docker) - * コンテナーでのアプリケーションの実行およびデバッグを支援するオープン・ソース・プロジェクト。非モバイル・プロジェクトの場合にのみ必要です。 - -### {{site.data.keyword.Bluemix_notm}} -{: #bluemix notoc} - -* {{site.data.keyword.apiconnect_short}} Loopback およびその他の {{site.data.keyword.Bluemix_notm}} 生産性向上ツールの実行を支援する Node.js (Node および npm のランタイム)。 - - {{site.data.keyword.apiconnect_short}} ツールをローカルで実行するには、Node 5.x を使用します。 - - ``` - $ brew install Node5 - ``` - -* [Bluemix CLI ツール ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://clis.ng.bluemix.net/ui/home.html) - - {{site.data.keyword.Bluemix_notm}} とのコマンド・ライン・インターフェースから Cloud Foundry ランタイムをデプロイするためのコマンド・ライン・ツール。 - -* [{{site.data.keyword.dev_cli_notm}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](dev_cli.html) - - Web およびモバイルのプロジェクトを作成、実行、テスト、およびデプロイするための {{site.data.keyword.Bluemix_notm}} CLI プラグイン。 - -* [SDK Generator プラグイン ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](sdk_cli.html) - - [Open API 仕様 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.openapis.org/) 準拠の REST API 定義から SDK を生成する {{site.data.keyword.Bluemix_notm}} CLI プラグイン。 - -### Android -{: #android notoc} - -* [Android Studio 2.2 以上![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.android.com/studio) - * 最新の [Android 7.0 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.android.com/versions/nougat-7-0/) ランタイムをインストールします。 - -### iOS -{: #ios notoc} - -* [Xcode 8 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com/xcode/) (推奨) - - -* iOS SDK 依存関係をインストールするための [CocoaPods ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://cocoapods.org/) の依存関係マネージャー。最新バージョンを使用してください。 - - ``` - $ sudo gem install cocoapods --pre - ``` -* {{site.data.keyword.watson}} Developer Cloud SDK をインストールするための [Carthage ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/Carthage/Carthage) の依存関係マネージャー。 - - ``` - $ brew install carthage - ``` +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-18" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# コードの取得 +{: #Get_Code} + +選択された機能でプロジェクトの構成とセットアップを完了したら、実行できるコードをダウンロードできます。ダウンロードしたプロジェクトは、構成した各機能に必要な SDK 依存関係と資格情報で事前構成済みです。 + +ダウンロードしたプロジェクト内で構成可能ではないサービスについては、資格情報の入力が必要になります。スターター・プロジェクトの `README.md` ファイルに指示が含まれています。`README.md` ファイルを Markdown ビューアーで表示して確認し、セットアップを完了してください。 + +## 前提条件開発者ツール +{: #prereq-dev-tools} + +生成されたコードについての作業を {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} から行うときには、以下の開発者ツールが必要です。 + + +### 一般 +{: #general notoc} + +* [Homebrew ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://brew.sh/) + * 他のツールおよびランタイム (CocoaPods や Carthage など) のインストールを支援する、Apple 開発者向けのコマンド・ライン・ツール。 + +* [Docker ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.docker.com/get-docker) + * コンテナーでのアプリケーションの実行およびデバッグを支援するオープン・ソース・プロジェクト。非モバイル・プロジェクトの場合にのみ必要です。 + +### {{site.data.keyword.Bluemix_notm}} +{: #bluemix notoc} + +* {{site.data.keyword.apiconnect_short}} Loopback およびその他の {{site.data.keyword.Bluemix_notm}} 生産性向上ツールの実行を支援する Node.js (Node および npm のランタイム)。 + + {{site.data.keyword.apiconnect_short}} ツールをローカルで実行するには、Node 5.x を使用します。 + + ``` + $ brew install Node5 + ``` + +* [Bluemix CLI ツール ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://clis.ng.bluemix.net/ui/home.html) + + {{site.data.keyword.Bluemix_notm}} とのコマンド・ライン・インターフェースから Cloud Foundry ランタイムをデプロイするためのコマンド・ライン・ツール。 + +* [{{site.data.keyword.dev_cli_notm}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](dev_cli.html) + + Web およびモバイルのプロジェクトを作成、実行、テスト、およびデプロイするための {{site.data.keyword.Bluemix_notm}} CLI プラグイン。 + +* [SDK Generator プラグイン ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](sdk_cli.html) + + [Open API 仕様 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.openapis.org/) 準拠の REST API 定義から SDK を生成する {{site.data.keyword.Bluemix_notm}} CLI プラグイン。 + +### Android +{: #android notoc} + +* [Android Studio 2.2 以上![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.android.com/studio) + * 最新の [Android 7.0 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.android.com/versions/nougat-7-0/) ランタイムをインストールします。 + +### iOS +{: #ios notoc} + +* [Xcode 8 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com/xcode/) (推奨) + + +* iOS SDK 依存関係をインストールするための [CocoaPods ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://cocoapods.org/) の依存関係マネージャー。最新バージョンを使用してください。 + + ``` + $ sudo gem install cocoapods --pre + ``` +* {{site.data.keyword.watson}} Developer Cloud SDK をインストールするための [Carthage ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/Carthage/Carthage) の依存関係マネージャー。 + + ``` + $ brew install carthage + ``` diff --git a/cloudnative/nl/ja/index.md b/cloudnative/nl/ja/index.md index 802d6ccd9..07ac25465 100644 --- a/cloudnative/nl/ja/index.md +++ b/cloudnative/nl/ja/index.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2016-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# クラウド・ネイティブ・プロジェクトの構築 -{: #web-mobile} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} [プロジェクト](projects.html)の概念を通じて、クラウド・ネイティブ・アプリを管理できます。プロジェクトを作成するには、[{{site.data.keyword.dev_console}}](devex.html) を使用するか、{{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI のために [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) を使用することができます。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} は、クラウド・ネイティブ・アプリケーション開発者に必要な最も一般的なサービス機能を、その開発者用に最適化された単一のエクスペリエンスに結合します。 - -{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} を使用して、クラウド・ネイティブ・アプリケーション開発者は、さまざまな[パターン・タイプ](patterns.html)および[スターター](starters.html)からプロジェクトを作成し、{{site.data.keyword.Bluemix_notm}} 向けに最適化された主要サービスを作成してプロジェクトに接続し、機能するコードを SDK と共に迅速にダウンロードすることができます。それらの SDK には機能の資格情報や依存関係が完全に組み込まれているため、数分のうちに実行することが可能です。アプリケーションが実行中で、機能のセットアップおよび構成を完了したら、プロジェクトに戻って、アプリケーション・ユーザーとの関わりをモニターおよび管理することができます。また、{{site.data.keyword.dev_console}} でサービスを構成および管理することも可能です。 - - - - - - -# 関連リンク -{: #rellinks notoc} - -## チュートリアルおよびサンプル -{: #samples notoc} - -* [サンプル: Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} -* [ビデオ・チュートリアル](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2016-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# クラウド・ネイティブ・プロジェクトの構築 +{: #web-mobile} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} [プロジェクト](projects.html)の概念を通じて、クラウド・ネイティブ・アプリを管理できます。プロジェクトを作成するには、[{{site.data.keyword.dev_console}}](devex.html) を使用するか、{{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI のために [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) を使用することができます。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} は、クラウド・ネイティブ・アプリケーション開発者に必要な最も一般的なサービス機能を、その開発者用に最適化された単一のエクスペリエンスに結合します。 + +{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} を使用して、クラウド・ネイティブ・アプリケーション開発者は、さまざまな[パターン・タイプ](patterns.html)および[スターター](starters.html)からプロジェクトを作成し、{{site.data.keyword.Bluemix_notm}} 向けに最適化された主要サービスを作成してプロジェクトに接続し、機能するコードを SDK と共に迅速にダウンロードすることができます。それらの SDK には機能の資格情報や依存関係が完全に組み込まれているため、数分のうちに実行することが可能です。アプリケーションが実行中で、機能のセットアップおよび構成を完了したら、プロジェクトに戻って、アプリケーション・ユーザーとの関わりをモニターおよび管理することができます。また、{{site.data.keyword.dev_console}} でサービスを構成および管理することも可能です。 + + + + + + +# 関連リンク +{: #rellinks notoc} + +## チュートリアルおよびサンプル +{: #samples notoc} + +* [サンプル: Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} +* [ビデオ・チュートリアル](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} diff --git a/cloudnative/nl/ja/patterns.md b/cloudnative/nl/ja/patterns.md index 5f8fd436b..bdeda884c 100644 --- a/cloudnative/nl/ja/patterns.md +++ b/cloudnative/nl/ja/patterns.md @@ -1,99 +1,99 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# パターン・タイプ -{: #patterns} - -クラウド・ネイティブ・パターンは、整合性、拡張性、信頼性のあるアプリケーション・トポロジーにするための実証された設計になっています。プロジェクトの作成時に、各種パターン・タイプが提示され、その中から選択することができます。プロジェクトに取り込みたいパターン・タイプと機能を選択するだけです。プロジェクト設定を定義すると、スターター・プロジェクトが生成されます。それを編集、実行、またはデバッグし、ローカルまたは {{site.data.keyword.Bluemix}} にデプロイできます。 - -## Web アプリ -{: #web} - -Web プロジェクトでは、HTML、JavaScript、スタイルシートなどの Web コンテンツを処理する機能を Web サーバーに追加します。 - -以下の Web スターターが使用可能です。 - -* ベーシック Web: 静的 `index.html` ファイル、デフォルトおよび空のスタイルシート、JavaScript ファイルを処理します。 -* Webpack: ECMAScript 6 (ES6) ソース・ファイルが `src/client` 内にあって、ブラウザーで使用するために縮小と変換が行われるように WebPack でコンパイルされるプロジェクトを作成します。 -* Webpack + React: ユーザー・インターフェースをビルドするためのリッチ・フレームワーク。ソース・ファイルは `src/client/app` 内にあり、WebPack でコンパイルされて、パブリック・ディレクトリーで処理されます。 - - -## モバイル・アプリ -{: #mobile} - -モバイル・アプリ・パターンを利用して、{{site.data.keyword.mobilepushshort}}、{{site.data.keyword.mobileanalytics_short}}、 -{{site.data.keyword.appid_short}}、その他のバックエンド・サービスに直接接続するモバイル・アプリを構築できます。プロジェクトは、sdkGen (BFF など) やマイクロサービスでも追加可能です。 - -{{site.data.keyword.watson}} Conversation、{{site.data.keyword.visualrecognitionshort}}、{{site.data.keyword.openwhisk_short}}、その他のスターターのリストから選択できます。 - -モバイル・アプリは、Swift、Android、または Cordova で生成できます。 - - -## Backend for Frontend (BFF) -{: #bff} - -Backend for Frontend パターン (通常 BFF と呼ばれる) は、ユーザー・インタラクションの要件に一致する形式でビジネス・データおよびサービスを公開することに重点を置く上で役立ちます。クラウド・ソリューションへのユーザー・ジャーニーを最適化するには、モバイル・アプリケーション用の別のユーザー・ジャーニーと、Web アプリケーション用のよりリッチで詳細なジャーニーが必要な可能性があります。[{{site.data.keyword.conversationfull}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.ibm.com/watson/developercloud/conversation.html) サービスのような音声制御デバイスの導入により、ユーザーとのインタラクションは音声で制御される可能性があります。このデジタル・チャネルには、これらの音声インテント・ベースのインタラクションを管理するための、非常に異なる BFF が必要になります。 - -{{site.data.keyword.Bluemix_notm}} では、BFF を定義するための Polyglot プログラミング・アプローチを使用して BFF を作成することができます。Node.js、Swift、または Java を使用すること、および Cloud Foundry、Container サービス、またはサーバーレスのいずれかを使用してクラウド・ネイティブ・パターンでそれらを実行することを IBM は推奨しています。 - -BFF は、データ・パーシスタンスおよびキャッシング用のサービスとの統合、および {{site.data.keyword.ibmwatson}}、{{site.data.keyword.iot_short_notm}}、{{site.data.keyword.weather_short}} のような高価値サービス、および {{site.data.keyword.sparks}} のようなデータ分析との統合を管理します。 - -BFF は、最も一般的には REST パターンを使用して API を公開しますが、{{site.data.keyword.messagehub}} を使用してメッセージング・アーキテクチャーから BFF が機能するように設計することができます。 - -BFF ベーシック・スターターは、Node.js または Swift で使用可能です。 - - -## マイクロサービス -{: #microservice} - -マイクロサービス・プロジェクトは、基本ヘルス・エンドポイント、REST API などのバックエンド・マイクロサービスを構築するための基盤を提供します。生成されるプロジェクトには、マイクロサービス自体と、接続されたクラウド・サービスの両方に必要なすべての依存関係が含まれます。 - -マイクロサービス・ベーシック・スターターは、Java で使用可能です。 - - - - -## 言語 -{: #languages notoc} - -サポートされる言語は、以下のとおりです。 - - * [Java ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](../runtimes/liberty/getting-started.html){: new_window} - * [Node.js ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](../runtimes/nodejs/getting-started.html){: new_window} - * [Swift ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](../runtimes/swift/getting-started.html){: new_window} - - -### Java -{: #java notoc} - -Java には、エンタープライズ規模のアプリケーションを構築するための実証された機能があります。しかし、Java 8 の新機能では、Liberty のような軽量のランタイムと Spring Boot のようなフレームワークと組み合わせて、Java をマイクロサービスの構築にも最適なものにしています。 - - -### Node.js -{: #node notoc} - -Node.js は、イベント・ドリブンの非ブロッキング入出力モデルを使用し、軽量化と効率化を図った JavaScript ランタイムで、Web アプリケーション、Backend for Frontends (BFF) パターン、およびマイクロサービスのスループットと拡張性に優れています。Node.js のパッケージ・エコシステムである npm により、非常に数多くのオープン・ソース・モジュールにアクセス可能になり、アプリケーション開発を加速する幅広い機能が提供されます。 - - -### Swift -{: #swift notoc} - -Swift は、2014 年に Apple によって作成された最新のプログラミング言語です。Objective C の使用に置き換わるものとして設計され、2015 年 12 月にオープン・ソース化されました。今日では、x86、ARM、または Z アーキテクチャーを使用した Linux および macOS のオペレーティング・システムで、iOS、macOS、Web サービス、およびシステム・ソフトウェアを構築するために使用されます。スクリプト言語のように記述しますが、コンパイルされるとオーバーヘッドが少なく C のようなハイパフォーマンスを実現し、クラウド・ランタイムに理想的です。Java で見られる強力で静的なタイプのシステムを使用しながら、JavaScript で見られる機能スタイルおよび非同期ルーチンを使用しています。非常に高性能で、ソースは LLVM コンパイラー・ツールチェーンを使用してネイティブ・コードにコンパイルされ、C で記述された外部システム・ライブラリーを簡単に利用できます。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# パターン・タイプ +{: #patterns} + +クラウド・ネイティブ・パターンは、整合性、拡張性、信頼性のあるアプリケーション・トポロジーにするための実証された設計になっています。プロジェクトの作成時に、各種パターン・タイプが提示され、その中から選択することができます。プロジェクトに取り込みたいパターン・タイプと機能を選択するだけです。プロジェクト設定を定義すると、スターター・プロジェクトが生成されます。それを編集、実行、またはデバッグし、ローカルまたは {{site.data.keyword.Bluemix}} にデプロイできます。 + +## Web アプリ +{: #web} + +Web プロジェクトでは、HTML、JavaScript、スタイルシートなどの Web コンテンツを処理する機能を Web サーバーに追加します。 + +以下の Web スターターが使用可能です。 + +* ベーシック Web: 静的 `index.html` ファイル、デフォルトおよび空のスタイルシート、JavaScript ファイルを処理します。 +* Webpack: ECMAScript 6 (ES6) ソース・ファイルが `src/client` 内にあって、ブラウザーで使用するために縮小と変換が行われるように WebPack でコンパイルされるプロジェクトを作成します。 +* Webpack + React: ユーザー・インターフェースをビルドするためのリッチ・フレームワーク。ソース・ファイルは `src/client/app` 内にあり、WebPack でコンパイルされて、パブリック・ディレクトリーで処理されます。 + + +## モバイル・アプリ +{: #mobile} + +モバイル・アプリ・パターンを利用して、{{site.data.keyword.mobilepushshort}}、{{site.data.keyword.mobileanalytics_short}}、 +{{site.data.keyword.appid_short}}、その他のバックエンド・サービスに直接接続するモバイル・アプリを構築できます。プロジェクトは、sdkGen (BFF など) やマイクロサービスでも追加可能です。 + +{{site.data.keyword.watson}} Conversation、{{site.data.keyword.visualrecognitionshort}}、{{site.data.keyword.openwhisk_short}}、その他のスターターのリストから選択できます。 + +モバイル・アプリは、Swift、Android、または Cordova で生成できます。 + + +## Backend for Frontend (BFF) +{: #bff} + +Backend for Frontend パターン (通常 BFF と呼ばれる) は、ユーザー・インタラクションの要件に一致する形式でビジネス・データおよびサービスを公開することに重点を置く上で役立ちます。クラウド・ソリューションへのユーザー・ジャーニーを最適化するには、モバイル・アプリケーション用の別のユーザー・ジャーニーと、Web アプリケーション用のよりリッチで詳細なジャーニーが必要な可能性があります。[{{site.data.keyword.conversationfull}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.ibm.com/watson/developercloud/conversation.html) サービスのような音声制御デバイスの導入により、ユーザーとのインタラクションは音声で制御される可能性があります。このデジタル・チャネルには、これらの音声インテント・ベースのインタラクションを管理するための、非常に異なる BFF が必要になります。 + +{{site.data.keyword.Bluemix_notm}} では、BFF を定義するための Polyglot プログラミング・アプローチを使用して BFF を作成することができます。Node.js、Swift、または Java を使用すること、および Cloud Foundry、Container サービス、またはサーバーレスのいずれかを使用してクラウド・ネイティブ・パターンでそれらを実行することを IBM は推奨しています。 + +BFF は、データ・パーシスタンスおよびキャッシング用のサービスとの統合、および {{site.data.keyword.ibmwatson}}、{{site.data.keyword.iot_short_notm}}、{{site.data.keyword.weather_short}} のような高価値サービス、および {{site.data.keyword.sparks}} のようなデータ分析との統合を管理します。 + +BFF は、最も一般的には REST パターンを使用して API を公開しますが、{{site.data.keyword.messagehub}} を使用してメッセージング・アーキテクチャーから BFF が機能するように設計することができます。 + +BFF ベーシック・スターターは、Node.js または Swift で使用可能です。 + + +## マイクロサービス +{: #microservice} + +マイクロサービス・プロジェクトは、基本ヘルス・エンドポイント、REST API などのバックエンド・マイクロサービスを構築するための基盤を提供します。生成されるプロジェクトには、マイクロサービス自体と、接続されたクラウド・サービスの両方に必要なすべての依存関係が含まれます。 + +マイクロサービス・ベーシック・スターターは、Java で使用可能です。 + + + + +## 言語 +{: #languages notoc} + +サポートされる言語は、以下のとおりです。 + + * [Java ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](../runtimes/liberty/getting-started.html){: new_window} + * [Node.js ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](../runtimes/nodejs/getting-started.html){: new_window} + * [Swift ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](../runtimes/swift/getting-started.html){: new_window} + + +### Java +{: #java notoc} + +Java には、エンタープライズ規模のアプリケーションを構築するための実証された機能があります。しかし、Java 8 の新機能では、Liberty のような軽量のランタイムと Spring Boot のようなフレームワークと組み合わせて、Java をマイクロサービスの構築にも最適なものにしています。 + + +### Node.js +{: #node notoc} + +Node.js は、イベント・ドリブンの非ブロッキング入出力モデルを使用し、軽量化と効率化を図った JavaScript ランタイムで、Web アプリケーション、Backend for Frontends (BFF) パターン、およびマイクロサービスのスループットと拡張性に優れています。Node.js のパッケージ・エコシステムである npm により、非常に数多くのオープン・ソース・モジュールにアクセス可能になり、アプリケーション開発を加速する幅広い機能が提供されます。 + + +### Swift +{: #swift notoc} + +Swift は、2014 年に Apple によって作成された最新のプログラミング言語です。Objective C の使用に置き換わるものとして設計され、2015 年 12 月にオープン・ソース化されました。今日では、x86、ARM、または Z アーキテクチャーを使用した Linux および macOS のオペレーティング・システムで、iOS、macOS、Web サービス、およびシステム・ソフトウェアを構築するために使用されます。スクリプト言語のように記述しますが、コンパイルされるとオーバーヘッドが少なく C のようなハイパフォーマンスを実現し、クラウド・ランタイムに理想的です。Java で見られる強力で静的なタイプのシステムを使用しながら、JavaScript で見られる機能スタイルおよび非同期ルーチンを使用しています。非常に高性能で、ソースは LLVM コンパイラー・ツールチェーンを使用してネイティブ・コードにコンパイルされ、C で記述された外部システム・ライブラリーを簡単に利用できます。 diff --git a/cloudnative/nl/ja/projects.md b/cloudnative/nl/ja/projects.md index ac389405c..89d09398f 100644 --- a/cloudnative/nl/ja/projects.md +++ b/cloudnative/nl/ja/projects.md @@ -1,57 +1,57 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# プロジェクト -{: #projects} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} は、アプリのユーザー・インターフェース、データ、およびサービスを結合して 1 つの完全な*プロジェクト* にします。プロジェクトを作成することによって、アプリのすべての必要なパーツおよび追加された機能が {{site.data.keyword.Bluemix_notm}} サーバー上で保守されます。サービスがプロジェクトに構成されている場合に、アプリ・コードや、必要な資格情報および初期化指定子をダウンロードできます。**「プロジェクト」**を選択すると、すべてのプロジェクトを表示できます。 - -**「プロジェクト」**ページで単一プロジェクトを選択すると、それに関する追加情報を表示できます。これにより、プロジェクトの構成済みの使用可能なサービスを示した**「プロジェクト概要」**ページが表示されます。サービスは分離した機能であり、アプリの機能を拡充します。サービスは個別に追加されるため、必要なサービス (プッシュ・サービス、認証サービス、データおよびストレージ、またはその他のサービス) を追加できます。**「プロジェクト概要」**ページでサービスをプロジェクトに追加し、手順に従ってサービスを構成すると、サービスは自動的にアプリに関連付けられます。「プロジェクト概要」ページについて詳しくは、[「プロジェクト概要」ページ](project_overview_page.html)を参照してください。 - -プロジェクトを作成するには、[パターン](patterns.html)を選択し、その後に[スターター](starters.html)を選択する必要があります。 - - -## プロジェクト概要ページ -{: #project_overview} - -**「プロジェクト」**ページでプロジェクトを選択して「プロジェクト概要」ページを開くことにより、単一の {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} プロジェクトを表示および処理することができます。 -{: shortdesc} - -**「プロジェクト概要」**ページには、選択したプロジェクトで構成されている、または構成が可能な各機能のタイルが表示されています。このタイルには、機能のタイプと、垂直に並んだ 3 つのドットが付いた*「アクション」* ボタンが表示されています。使用可能または構成済みの可能性のある機能の例としては、{{site.data.keyword.mobilepushshort}}、Analytics (分析)、または Data and Storage (データおよびストレージ) があります。互換性のある機能は、プロジェクトのタイプおよびその地域で利用可能な機能によって異なるため、すべての機能がすべてのプロジェクトに関連付けできるわけではありません。 - -機能のタイプがまだプロジェクトに関連付けられていない場合は、タイルに**「作成」**ボタンが表示されます。アクション・ボタンのオプションは、サービスのインスタンスを作成すること、または機能がまだ関連付けられていない場合に既存のサービス・インスタンスを追加することです。**「既存の追加 (Add Existing)」**を選択すると、スペース内にあるそのタイプのサービス・インスタンスのリストが表示されます。 - -機能が既にこのプロジェクトに関連付けられている場合、関連付けられているサービス・インスタンスの名前が、タイル上の機能タイプの後に表示されます。これにより、{{site.data.keyword.dev_console}} 上でどのサービス・インスタンスがこのプロジェクトに関連しているかを見つけるのが容易になります。機能が既にプロジェクトに関連付けられている場合、アクション・ボタンで使用可能なアクションは** 「表示」**と **「削除」**です。サービス・インスタンスを削除しても、このプロジェクトへの関連付けが削除されるだけで、{{site.data.keyword.dev_console}} からサービス・インスタンスが削除されるわけではありません。サービス・インスタンスを削除するには、**「Web およびモバイル (Web and Mobile)」>「サービス」**ページをクリックし、サービス・インスタンスを表示して削除します。 - -プロジェクトのコードをダウンロードするには、**「コード」**タイルで**「コードの取得 (Get the Code)」**を選択します。コードのダウンロードについて詳しくは、[コードの取得](get_code.html)を参照してください。 - - -## 新しいスターターを使用するためのプロジェクトの更新 -{: #update-starter} - -1. **「プロジェクト」**または**「プロジェクト概要」**ページから、**「オーバーフロー・メニュー (Overflow Menu)」**アイコンをクリックして**「スターターの更新 (Update Starter)」**を選択します。 - -2. 新しいスターターを選択して、**「更新」**をクリックします。 - -3. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 - - 代替方法として、**「コード」**ページで以下をクリックすることもできます。 - - -## 新しい言語を生成するためのプロジェクトの更新 -{: #update-language} - -1. **「プロジェクト」**または**「プロジェクト概要」**ページから、**「オーバーフロー・メニュー (Overflow Menu)」**アイコンをクリックして**「スターターの更新 (Update Starter)」**を選択します。 - -2. 新しい言語を選択して**「更新」**をクリックします。 - -3. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# プロジェクト +{: #projects} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} は、アプリのユーザー・インターフェース、データ、およびサービスを結合して 1 つの完全な*プロジェクト* にします。プロジェクトを作成することによって、アプリのすべての必要なパーツおよび追加された機能が {{site.data.keyword.Bluemix_notm}} サーバー上で保守されます。サービスがプロジェクトに構成されている場合に、アプリ・コードや、必要な資格情報および初期化指定子をダウンロードできます。**「プロジェクト」**を選択すると、すべてのプロジェクトを表示できます。 + +**「プロジェクト」**ページで単一プロジェクトを選択すると、それに関する追加情報を表示できます。これにより、プロジェクトの構成済みの使用可能なサービスを示した**「プロジェクト概要」**ページが表示されます。サービスは分離した機能であり、アプリの機能を拡充します。サービスは個別に追加されるため、必要なサービス (プッシュ・サービス、認証サービス、データおよびストレージ、またはその他のサービス) を追加できます。**「プロジェクト概要」**ページでサービスをプロジェクトに追加し、手順に従ってサービスを構成すると、サービスは自動的にアプリに関連付けられます。「プロジェクト概要」ページについて詳しくは、[「プロジェクト概要」ページ](project_overview_page.html)を参照してください。 + +プロジェクトを作成するには、[パターン](patterns.html)を選択し、その後に[スターター](starters.html)を選択する必要があります。 + + +## プロジェクト概要ページ +{: #project_overview} + +**「プロジェクト」**ページでプロジェクトを選択して「プロジェクト概要」ページを開くことにより、単一の {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} プロジェクトを表示および処理することができます。 +{: shortdesc} + +**「プロジェクト概要」**ページには、選択したプロジェクトで構成されている、または構成が可能な各機能のタイルが表示されています。このタイルには、機能のタイプと、垂直に並んだ 3 つのドットが付いた*「アクション」* ボタンが表示されています。使用可能または構成済みの可能性のある機能の例としては、{{site.data.keyword.mobilepushshort}}、Analytics (分析)、または Data and Storage (データおよびストレージ) があります。互換性のある機能は、プロジェクトのタイプおよびその地域で利用可能な機能によって異なるため、すべての機能がすべてのプロジェクトに関連付けできるわけではありません。 + +機能のタイプがまだプロジェクトに関連付けられていない場合は、タイルに**「作成」**ボタンが表示されます。アクション・ボタンのオプションは、サービスのインスタンスを作成すること、または機能がまだ関連付けられていない場合に既存のサービス・インスタンスを追加することです。**「既存の追加 (Add Existing)」**を選択すると、スペース内にあるそのタイプのサービス・インスタンスのリストが表示されます。 + +機能が既にこのプロジェクトに関連付けられている場合、関連付けられているサービス・インスタンスの名前が、タイル上の機能タイプの後に表示されます。これにより、{{site.data.keyword.dev_console}} 上でどのサービス・インスタンスがこのプロジェクトに関連しているかを見つけるのが容易になります。機能が既にプロジェクトに関連付けられている場合、アクション・ボタンで使用可能なアクションは** 「表示」**と **「削除」**です。サービス・インスタンスを削除しても、このプロジェクトへの関連付けが削除されるだけで、{{site.data.keyword.dev_console}} からサービス・インスタンスが削除されるわけではありません。サービス・インスタンスを削除するには、**「Web およびモバイル (Web and Mobile)」>「サービス」**ページをクリックし、サービス・インスタンスを表示して削除します。 + +プロジェクトのコードをダウンロードするには、**「コード」**タイルで**「コードの取得 (Get the Code)」**を選択します。コードのダウンロードについて詳しくは、[コードの取得](get_code.html)を参照してください。 + + +## 新しいスターターを使用するためのプロジェクトの更新 +{: #update-starter} + +1. **「プロジェクト」**または**「プロジェクト概要」**ページから、**「オーバーフロー・メニュー (Overflow Menu)」**アイコンをクリックして**「スターターの更新 (Update Starter)」**を選択します。 + +2. 新しいスターターを選択して、**「更新」**をクリックします。 + +3. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 + + 代替方法として、**「コード」**ページで以下をクリックすることもできます。 + + +## 新しい言語を生成するためのプロジェクトの更新 +{: #update-language} + +1. **「プロジェクト」**または**「プロジェクト概要」**ページから、**「オーバーフロー・メニュー (Overflow Menu)」**アイコンをクリックして**「スターターの更新 (Update Starter)」**を選択します。 + +2. 新しい言語を選択して**「更新」**をクリックします。 + +3. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 diff --git a/cloudnative/nl/ja/sdk.md b/cloudnative/nl/ja/sdk.md index d81ac8864..1115aa94d 100644 --- a/cloudnative/nl/ja/sdk.md +++ b/cloudnative/nl/ja/sdk.md @@ -1,67 +1,67 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-17" - ---- -# SDK -{: #sdk} - -{{site.data.keyword.Bluemix}} Mobile Services SDK をアプリに追加するには、使用する SDK を選択し、依存関係マネージャーを構成して SDK をアプリにプルします。 - - -## クライアント SDK -{: #client_sdk} - -以下の SDK をモバイル・アプリケーション内で使用して、それぞれの機能を活用できます。 - - -### Android SDK -{: #android_sdk} - -- [Core SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) -- [{{site.data.keyword.mobileanalytics_short}} SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) -- [Facebook Authentication SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) -- [Google Authentication SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) - - -### iOS SDK -{: #ios_sdk} - -- [Core SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) -- [{{site.data.keyword.mobileanalytics_short}} SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) -- [Facebook Authentication SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) -- [Google Authentication SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) -- [{{site.data.keyword.amashort}} SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) - - -### Cordova プラグイン -{: #cordova_plugin} - -- [Core プラグイン ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) -- [{{site.data.keyword.mobilepushshort}} プラグイン![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## サーバー SDK -{: #server_sdk} - -Java、NodeJS、または Swift のサーバー・アプリケーションがある場合、以下の SDK を使用してそれぞれのサービスと通信することができます。 - - -### {{site.data.keyword.mobilepushshort}} サーバー SDK -{: #push_sdk} - -- [{{site.data.keyword.mobilepushshort}} Java サーバー SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) -- [{{site.data.keyword.mobilepushshort}} Swift サーバー SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) -- [{{site.data.keyword.mobilepushshort}} NodeJS サーバー SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) - - -### {{site.data.keyword.amashort}} サーバー SDK -{: #mca_sdk} - -- [{{site.data.keyword.amashort}} Swift サーバー SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) - - +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-17" + +--- +# SDK +{: #sdk} + +{{site.data.keyword.Bluemix}} Mobile Services SDK をアプリに追加するには、使用する SDK を選択し、依存関係マネージャーを構成して SDK をアプリにプルします。 + + +## クライアント SDK +{: #client_sdk} + +以下の SDK をモバイル・アプリケーション内で使用して、それぞれの機能を活用できます。 + + +### Android SDK +{: #android_sdk} + +- [Core SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) +- [{{site.data.keyword.mobileanalytics_short}} SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) +- [Facebook Authentication SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) +- [Google Authentication SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) + + +### iOS SDK +{: #ios_sdk} + +- [Core SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) +- [{{site.data.keyword.mobileanalytics_short}} SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) +- [Facebook Authentication SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) +- [Google Authentication SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) +- [{{site.data.keyword.amashort}} SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) + + +### Cordova プラグイン +{: #cordova_plugin} + +- [Core プラグイン ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) +- [{{site.data.keyword.mobilepushshort}} プラグイン![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## サーバー SDK +{: #server_sdk} + +Java、NodeJS、または Swift のサーバー・アプリケーションがある場合、以下の SDK を使用してそれぞれのサービスと通信することができます。 + + +### {{site.data.keyword.mobilepushshort}} サーバー SDK +{: #push_sdk} + +- [{{site.data.keyword.mobilepushshort}} Java サーバー SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) +- [{{site.data.keyword.mobilepushshort}} Swift サーバー SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) +- [{{site.data.keyword.mobilepushshort}} NodeJS サーバー SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) + + +### {{site.data.keyword.amashort}} サーバー SDK +{: #mca_sdk} + +- [{{site.data.keyword.amashort}} Swift サーバー SDK ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) + + diff --git a/cloudnative/nl/ja/sdk_BMSClient.md b/cloudnative/nl/ja/sdk_BMSClient.md index 4b8705380..0fb41a100 100644 --- a/cloudnative/nl/ja/sdk_BMSClient.md +++ b/cloudnative/nl/ja/sdk_BMSClient.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# BMSClient の初期化 -{: #sdk_BMSClient} - -`BMSCore` は、他の {{site.data.keyword.Bluemix}} モバイル・サービス・クライアント SDK が、それぞれに対応する {{site.data.keyword.Bluemix_notm}} サービスと通信するために使用する HTTP インフラストラクチャーを提供します。 - - -## Android アプリケーションの初期化 -{: #init-BMSClient-android} - -`BMSCore` パッケージをダウンロードして Android Studio プロジェクトにインポートするか、または Gradle を使用します。 - -1. プロジェクト・ファイルの先頭に以下の `import` ステートメントを追加して、クライアント SDK をインポートします。 - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; - ``` - {: codeblock} - -2. Android アプリケーション内のメイン・アクティビティーの `onCreate` メソッド、またはプロジェクトの最適な動作位置に初期化コードを追加して、Android アプリケーションで `BMSClient` SDK を初期化します。 - - ```Java - BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region - ``` - {: codeblock} - - **bluemixRegion** パラメーターを指定して `BMSClient` を初期化する必要があります。初期化指定子では、**bluemixRegion** 値は、どの {{site.data.keyword.Bluemix_notm}} デプロイメントを使用するか (例えば、`BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK`、または `BMSClient.REGION_SYDNEY`) を指定します。 - - -## iOS アプリケーションの初期化 -{: #init-BMSClient-ios} - -[CocoaPods](https://cocoapods.org){: new_window} または [Carthage](https://github.com/Carthage/Carthage){: new_window} を使用して、`BMSCore` パッケージを取得できます。 - -1. CocoaPods を使用して `BMSCore` をインストールするには、以下の行を Podfile に追加します。プロジェクトにまだ Podfile がない場合は、`pod init` コマンドを使用してください。 - - ```Swift - use_frameworks! - - target 'MyApp' do - pod 'BMSCore' - end - ``` - {: codeblock} - - 次に、`pod install` コマンドを実行し、生成された `.xcworkspace` ファイルを開きます。新しいリリースの `BMSCore` に更新するには、`pod update BMSCore` を使用します。 - - CocoaPods の使用方法について詳しくは、[「CocoaPods Guides」 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://guides.cocoapods.org/using/index.html){: new_window} を参照してください。 - -2. Carthage を使用して `BMSCore` をインストールするには、次の[手順 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/Carthage/Carthage#getting-started){: new_window} を参照してください。 - - 1. 次の行を Cartfile に追加します。 - - ``` - github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" - ``` - {: codeblock} - - 2. `carthage update` コマンドを実行します。 - - 3. ビルドが終了したら、Carthage の手順の[ステップ 3 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/Carthage/Carthage#getting-started) に従って `BMSCore.framework` をプロジェクトに追加します。 - - Swift 2.3 でビルドされているアプリケーションの場合は、`carthage update --toolchain com.apple.dt.toolchain.Swift_2_3` コマンドを使用します。その他の場合は、`carthage update` コマンドを使用します。 - -3. モジュールをインポートします。 - - ```Swift - import BMSCore - ``` - {: codeblock} - -4. 以下のコードを使用して、`BMSClient` クラスを初期化します。 - - アプリケーション代行の `application(_:didFinishLaunchingWithOptions:)` メソッド、またはプロジェクトの最適な動作位置に、初期化コードを挿入します。 - - ```Swift - BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region - ``` - {: codeblock} - - **bluemixRegion** パラメーターを指定して `BMSClient` を初期化する必要があります。初期化指定子では、**bluemixRegion** 値は、どの {{site.data.keyword.Bluemix_notm}} デプロイメントを使用するか (例えば、`BMSClient.Region.usSouth`、 `BMSClient.Region.unitedKingdom`、または `BMSClient.Region.sydney`) を指定します。 - - -## Cordova アプリケーションの初期化 -{: #init-BMSClient-cordova} - -1. Cordova アプリケーションのルート・ディレクトリーから以下のコマンドを実行して、Cordova プラグインを追加します。 - - ``` - cordova plugin add bms-core - ``` - {: codeblock} - -2. メイン JavaScript ファイル、またはプロジェクトの最適な動作位置に初期化コードを追加して、Cordova アプリケーションで `BMSClient` クラスを初期化します。 - - ``` - BMSClient.initialize(BMSClient.REGION_US_SOUTH); - ``` - {: codeblock} - - **bluemixRegion** パラメーターを指定して `BMSClient` を初期化する必要があります。初期化指定子では、**bluemixRegion** 値は、どの {{site.data.keyword.Bluemix_notm}} デプロイメントを使用するか (例えば、`BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK`、または `BMSClient.REGION_SYDNEY`) を指定します。 - - -# 関連リンク -{: #rellinks notoc} - -## 関連リンク -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# BMSClient の初期化 +{: #sdk_BMSClient} + +`BMSCore` は、他の {{site.data.keyword.Bluemix}} モバイル・サービス・クライアント SDK が、それぞれに対応する {{site.data.keyword.Bluemix_notm}} サービスと通信するために使用する HTTP インフラストラクチャーを提供します。 + + +## Android アプリケーションの初期化 +{: #init-BMSClient-android} + +`BMSCore` パッケージをダウンロードして Android Studio プロジェクトにインポートするか、または Gradle を使用します。 + +1. プロジェクト・ファイルの先頭に以下の `import` ステートメントを追加して、クライアント SDK をインポートします。 + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; + ``` + {: codeblock} + +2. Android アプリケーション内のメイン・アクティビティーの `onCreate` メソッド、またはプロジェクトの最適な動作位置に初期化コードを追加して、Android アプリケーションで `BMSClient` SDK を初期化します。 + + ```Java + BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region + ``` + {: codeblock} + + **bluemixRegion** パラメーターを指定して `BMSClient` を初期化する必要があります。初期化指定子では、**bluemixRegion** 値は、どの {{site.data.keyword.Bluemix_notm}} デプロイメントを使用するか (例えば、`BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK`、または `BMSClient.REGION_SYDNEY`) を指定します。 + + +## iOS アプリケーションの初期化 +{: #init-BMSClient-ios} + +[CocoaPods](https://cocoapods.org){: new_window} または [Carthage](https://github.com/Carthage/Carthage){: new_window} を使用して、`BMSCore` パッケージを取得できます。 + +1. CocoaPods を使用して `BMSCore` をインストールするには、以下の行を Podfile に追加します。プロジェクトにまだ Podfile がない場合は、`pod init` コマンドを使用してください。 + + ```Swift + use_frameworks! + + target 'MyApp' do + pod 'BMSCore' + end + ``` + {: codeblock} + + 次に、`pod install` コマンドを実行し、生成された `.xcworkspace` ファイルを開きます。新しいリリースの `BMSCore` に更新するには、`pod update BMSCore` を使用します。 + + CocoaPods の使用方法について詳しくは、[「CocoaPods Guides」 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://guides.cocoapods.org/using/index.html){: new_window} を参照してください。 + +2. Carthage を使用して `BMSCore` をインストールするには、次の[手順 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/Carthage/Carthage#getting-started){: new_window} を参照してください。 + + 1. 次の行を Cartfile に追加します。 + + ``` + github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" + ``` + {: codeblock} + + 2. `carthage update` コマンドを実行します。 + + 3. ビルドが終了したら、Carthage の手順の[ステップ 3 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/Carthage/Carthage#getting-started) に従って `BMSCore.framework` をプロジェクトに追加します。 + + Swift 2.3 でビルドされているアプリケーションの場合は、`carthage update --toolchain com.apple.dt.toolchain.Swift_2_3` コマンドを使用します。その他の場合は、`carthage update` コマンドを使用します。 + +3. モジュールをインポートします。 + + ```Swift + import BMSCore + ``` + {: codeblock} + +4. 以下のコードを使用して、`BMSClient` クラスを初期化します。 + + アプリケーション代行の `application(_:didFinishLaunchingWithOptions:)` メソッド、またはプロジェクトの最適な動作位置に、初期化コードを挿入します。 + + ```Swift + BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region + ``` + {: codeblock} + + **bluemixRegion** パラメーターを指定して `BMSClient` を初期化する必要があります。初期化指定子では、**bluemixRegion** 値は、どの {{site.data.keyword.Bluemix_notm}} デプロイメントを使用するか (例えば、`BMSClient.Region.usSouth`、 `BMSClient.Region.unitedKingdom`、または `BMSClient.Region.sydney`) を指定します。 + + +## Cordova アプリケーションの初期化 +{: #init-BMSClient-cordova} + +1. Cordova アプリケーションのルート・ディレクトリーから以下のコマンドを実行して、Cordova プラグインを追加します。 + + ``` + cordova plugin add bms-core + ``` + {: codeblock} + +2. メイン JavaScript ファイル、またはプロジェクトの最適な動作位置に初期化コードを追加して、Cordova アプリケーションで `BMSClient` クラスを初期化します。 + + ``` + BMSClient.initialize(BMSClient.REGION_US_SOUTH); + ``` + {: codeblock} + + **bluemixRegion** パラメーターを指定して `BMSClient` を初期化する必要があります。初期化指定子では、**bluemixRegion** 値は、どの {{site.data.keyword.Bluemix_notm}} デプロイメントを使用するか (例えば、`BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK`、または `BMSClient.REGION_SYDNEY`) を指定します。 + + +# 関連リンク +{: #rellinks notoc} + +## 関連リンク +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/ja/sdk_cli.md b/cloudnative/nl/ja/sdk_cli.md index b1c892f0a..2a9208fde 100644 --- a/cloudnative/nl/ja/sdk_cli.md +++ b/cloudnative/nl/ja/sdk_cli.md @@ -1,178 +1,178 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# SDK Generator プラグイン -{: #sdk-cli} - -{{site.data.keyword.IBM}} SDK Generator プラグインは、[{{site.data.keyword.Bluemix_notm}} CLI ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/cli/reference/bluemix_cli/index.html) にインストールできます。 - -{{site.data.keyword.Bluemix_notm}} の開発者は、このプラグインを使用して [Open API 仕様 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.openapis.org/) 準拠の REST API 定義から SDK を生成することができます。REST API 定義を変更する際は、プロジェクト全体を再生成するのではなく、このプラグインを使用して SDK だけを再生成することができます。 - -また、特定のスペース内の Cloud Foundry アプリが、SDK 生成に有効な REST API 定義を持っているかどうかも確認することができます。最後に、{{site.data.keyword.IBM_notm}} SDK Generator プラグインを使用して REST API 定義を検証し、それらが SDK 生成プログラムの要件に従っていることを確認できます。 - -この {{site.data.keyword.IBM_notm}} SDK Generator プラグインにより、生成された SDK を使用してバックエンド・サービスをアプリに容易に統合することができます。REST API に対する変更が行われた場合は、SDK を再生成し、古い SDK を置換してシームレスな SDK アップグレードを行うことができます。また、CLI を devops パイプラインに統合し、アプリをビルドするたびに SDK が API 仕様と常に整合されるようにすることができます。 - -REST API 定義は、有効でなければならず、稼働中のサーバー・エンドポイントでホストされているか、またはシステム上のローカル・ファイルでなければなりません。REST API 定義がホストされている場合は、`OPENAPI_SPEC` 環境変数に相対 URL が定義されている必要があります。 - - -## 必要条件 -{: #prereqs} - -以下の要件を満たしていることを確認してください。 - -* [{{site.data.keyword.Bluemix_notm}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://bluemix.net) アカウントを持っている -* [Open API ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.openapis.org/) 仕様に準拠した有効な API 定義 - - -## インストール -{: #installation} - -1. [{{site.data.keyword.Bluemix}} CLI ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://clis.ng.bluemix.net/ui/home.html) をインストールします。 - -2. [プラグイン ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in) をインストールします。 - - ``` - bx plugin install sdk-gen -r Bluemix - ``` - {: codeblock} - - -## コマンド -{: #commands} - -以下のコマンドを使用して、SDK を生成したり、Open API 定義ファイルを検証したり、Cloud Foundry アプリをリストしたりします。 - - -### SDK の生成 -{: #gen} - -`bluemix sdk generate [arguments...][command options]` を使用します。 - - -#### 引数 -{: #gen-args} - -* `APP_NAME` - 現在のスペース内の Cloud Foundry アプリの名前 -* `OPENAPI_DOC_LOCATION` - ロー REST API 定義 JSON または Yaml の URL または相対ファイル・パス -* `GENERATED_SDK_NAME` (オプション) - 生成済み SDK の名前 - - -#### オプション -{: #gen-options} - -* `PLATFORM` (必要) - * `--android` - Android SDK を生成する - * `--ios` - iOS Swift SDK を生成する - * `--swift` - Swift サーバー SDK を生成する -* `--output "YOUR_RELATIVE_PATH"` (オプション) - 生成された SDK を、`YOUR_RELATIVE_PATH` によって指定されたディレクトリー内に配置する (既存の SDK がある場合は上書きする) -* `--unzip` (オプション) - 生成された SDK を解凍する (既存の SDK 成果物がある場合は上書きする) - - -#### 使用法 -{: #gen-usage} - -{{site.data.keyword.Bluemix_notm}} で稼働中の Cloud Foundry アプリから SDK を生成するには、そのアプリの名前を CLI のパラメーターとして使用することができます。以下のコマンドは、アプリの名前を `SDK_Name` として使用しています。 - -``` -bluemix sdk generate [APP_NAME] [PLATFORM] -``` -{: codeblock} - -Open API 定義ファイルの URL、あるいはローカルの JSON ファイルまたは Yaml ファイルから SDK を生成するには、以下のコマンドを使用します。 - -``` -bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] -``` -{: codeblock} - - -### Open API 定義の検証 -{: #validating} - -`bluemix sdk validate [argument]` を使用します。 - - -#### 引数 -{: #val-args} - -* `APP_NAME` - 現在のスペース内の Cloud Foundry アプリの名前 -* `OPENAPI_DOC_LOCATION` - ロー REST API 定義 JSON または Yaml の URL または相対ファイル・パス - - -#### 使用法 -{: #val-usage} - -{{site.data.keyword.Bluemix_notm}} で稼働中の Cloud Foundry アプリの API 仕様を検証するには、そのアプリの名前を CLI のパラメーターとして使用することができます。 - -``` -bluemix sdk validate [APP_NAME] -``` -{: codeblock} - -API 仕様文書の URL、あるいはローカルの JSON ファイルまたは Yaml ファイルから SDK を検証するには、以下のコマンドを使用します。 - -``` -bluemix sdk validate [OPENAPI_DOC_LOCATION] -``` -{: codeblock} - - - -### アプリのリスト (Cloud Foundry) -{: #list-apps} - -`bluemix sdk list [argument][option]` を使用して、アプリをリストし、API 仕様を検証します。`OPENAPI_SPEC` 環境変数を、仕様をホストしている相対 URL パスに設定する必要があります。 - - -#### 引数 -{: #list-args} - -* `SPACE_NAME` (オプション) - アプリを検索する現行組織内の Cloud Foundry スペースの名前。指定されない場合、現行スペースが検索されます。 - - -#### オプション -{: #list-options} - -* `--url` (オプション) - リスト内の各アプリの Open API 定義の完全形式の URL を表示します。 - - -#### 使用法 -{: #list-usage} - -現行スペース内のアプリをリストするには、以下のコマンドを使用します。 - -``` -bluemix sdk list -``` -{: codeblock} - -現行スペース内のアプリをリストし、API 仕様の URL を表示するには、以下のコマンドを使用します。 - -``` -bluemix sdk list --url -``` -{: codeblock} - -特定スペース内のアプリをリストするには、以下のコマンドを使用します。 - -``` -bluemix sdk list [SPACE_NAME] -``` -{: codeblock} - -特定スペース内のアプリをリストし、API 仕様の URL を表示するには、以下のコマンドを使用します。 - -``` -bluemix sdk list [SPACE_NAME] --url -``` -{: codeblock} +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# SDK Generator プラグイン +{: #sdk-cli} + +{{site.data.keyword.IBM}} SDK Generator プラグインは、[{{site.data.keyword.Bluemix_notm}} CLI ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/cli/reference/bluemix_cli/index.html) にインストールできます。 + +{{site.data.keyword.Bluemix_notm}} の開発者は、このプラグインを使用して [Open API 仕様 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.openapis.org/) 準拠の REST API 定義から SDK を生成することができます。REST API 定義を変更する際は、プロジェクト全体を再生成するのではなく、このプラグインを使用して SDK だけを再生成することができます。 + +また、特定のスペース内の Cloud Foundry アプリが、SDK 生成に有効な REST API 定義を持っているかどうかも確認することができます。最後に、{{site.data.keyword.IBM_notm}} SDK Generator プラグインを使用して REST API 定義を検証し、それらが SDK 生成プログラムの要件に従っていることを確認できます。 + +この {{site.data.keyword.IBM_notm}} SDK Generator プラグインにより、生成された SDK を使用してバックエンド・サービスをアプリに容易に統合することができます。REST API に対する変更が行われた場合は、SDK を再生成し、古い SDK を置換してシームレスな SDK アップグレードを行うことができます。また、CLI を devops パイプラインに統合し、アプリをビルドするたびに SDK が API 仕様と常に整合されるようにすることができます。 + +REST API 定義は、有効でなければならず、稼働中のサーバー・エンドポイントでホストされているか、またはシステム上のローカル・ファイルでなければなりません。REST API 定義がホストされている場合は、`OPENAPI_SPEC` 環境変数に相対 URL が定義されている必要があります。 + + +## 必要条件 +{: #prereqs} + +以下の要件を満たしていることを確認してください。 + +* [{{site.data.keyword.Bluemix_notm}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://bluemix.net) アカウントを持っている +* [Open API ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.openapis.org/) 仕様に準拠した有効な API 定義 + + +## インストール +{: #installation} + +1. [{{site.data.keyword.Bluemix}} CLI ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://clis.ng.bluemix.net/ui/home.html) をインストールします。 + +2. [プラグイン ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in) をインストールします。 + + ``` + bx plugin install sdk-gen -r Bluemix + ``` + {: codeblock} + + +## コマンド +{: #commands} + +以下のコマンドを使用して、SDK を生成したり、Open API 定義ファイルを検証したり、Cloud Foundry アプリをリストしたりします。 + + +### SDK の生成 +{: #gen} + +`bluemix sdk generate [arguments...][command options]` を使用します。 + + +#### 引数 +{: #gen-args} + +* `APP_NAME` - 現在のスペース内の Cloud Foundry アプリの名前 +* `OPENAPI_DOC_LOCATION` - ロー REST API 定義 JSON または Yaml の URL または相対ファイル・パス +* `GENERATED_SDK_NAME` (オプション) - 生成済み SDK の名前 + + +#### オプション +{: #gen-options} + +* `PLATFORM` (必要) + * `--android` - Android SDK を生成する + * `--ios` - iOS Swift SDK を生成する + * `--swift` - Swift サーバー SDK を生成する +* `--output "YOUR_RELATIVE_PATH"` (オプション) - 生成された SDK を、`YOUR_RELATIVE_PATH` によって指定されたディレクトリー内に配置する (既存の SDK がある場合は上書きする) +* `--unzip` (オプション) - 生成された SDK を解凍する (既存の SDK 成果物がある場合は上書きする) + + +#### 使用法 +{: #gen-usage} + +{{site.data.keyword.Bluemix_notm}} で稼働中の Cloud Foundry アプリから SDK を生成するには、そのアプリの名前を CLI のパラメーターとして使用することができます。以下のコマンドは、アプリの名前を `SDK_Name` として使用しています。 + +``` +bluemix sdk generate [APP_NAME] [PLATFORM] +``` +{: codeblock} + +Open API 定義ファイルの URL、あるいはローカルの JSON ファイルまたは Yaml ファイルから SDK を生成するには、以下のコマンドを使用します。 + +``` +bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] +``` +{: codeblock} + + +### Open API 定義の検証 +{: #validating} + +`bluemix sdk validate [argument]` を使用します。 + + +#### 引数 +{: #val-args} + +* `APP_NAME` - 現在のスペース内の Cloud Foundry アプリの名前 +* `OPENAPI_DOC_LOCATION` - ロー REST API 定義 JSON または Yaml の URL または相対ファイル・パス + + +#### 使用法 +{: #val-usage} + +{{site.data.keyword.Bluemix_notm}} で稼働中の Cloud Foundry アプリの API 仕様を検証するには、そのアプリの名前を CLI のパラメーターとして使用することができます。 + +``` +bluemix sdk validate [APP_NAME] +``` +{: codeblock} + +API 仕様文書の URL、あるいはローカルの JSON ファイルまたは Yaml ファイルから SDK を検証するには、以下のコマンドを使用します。 + +``` +bluemix sdk validate [OPENAPI_DOC_LOCATION] +``` +{: codeblock} + + + +### アプリのリスト (Cloud Foundry) +{: #list-apps} + +`bluemix sdk list [argument][option]` を使用して、アプリをリストし、API 仕様を検証します。`OPENAPI_SPEC` 環境変数を、仕様をホストしている相対 URL パスに設定する必要があります。 + + +#### 引数 +{: #list-args} + +* `SPACE_NAME` (オプション) - アプリを検索する現行組織内の Cloud Foundry スペースの名前。指定されない場合、現行スペースが検索されます。 + + +#### オプション +{: #list-options} + +* `--url` (オプション) - リスト内の各アプリの Open API 定義の完全形式の URL を表示します。 + + +#### 使用法 +{: #list-usage} + +現行スペース内のアプリをリストするには、以下のコマンドを使用します。 + +``` +bluemix sdk list +``` +{: codeblock} + +現行スペース内のアプリをリストし、API 仕様の URL を表示するには、以下のコマンドを使用します。 + +``` +bluemix sdk list --url +``` +{: codeblock} + +特定スペース内のアプリをリストするには、以下のコマンドを使用します。 + +``` +bluemix sdk list [SPACE_NAME] +``` +{: codeblock} + +特定スペース内のアプリをリストし、API 仕様の URL を表示するには、以下のコマンドを使用します。 + +``` +bluemix sdk list [SPACE_NAME] --url +``` +{: codeblock} diff --git a/cloudnative/nl/ja/sdk_network_request.md b/cloudnative/nl/ja/sdk_network_request.md index c596bbae8..386189338 100644 --- a/cloudnative/nl/ja/sdk_network_request.md +++ b/cloudnative/nl/ja/sdk_network_request.md @@ -1,121 +1,121 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# ネットワーク要求を行う -{: #sdk-network-request} - -`BMSCore` SDK を使用して、任意のリソースにネットワーク要求を行うこともできます。 - -## Android -{: #request-android} - -1. Android アプリケーションに [Client SDK をインポートして初期化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android)しておくようにしてください。 - -2. ネットワーク要求を行います。 - - ``` - public void makeGetCall() { - Thread thread = new Thread(new Runnable() { - @Override - public void run() { - try { - Request request = new Request("http://httpbin.org/get", "GET"); - request.send(null, null); - } catch (Exception e) { - // Handle failure here. - } - } - }); - thread.start(); - } - ``` - {: codeblock} - -## iOS -{: #request-ios} - -1. iOS アプリケーションに [Client SDK をインポートして初期化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios)しておくようにしてください。 - -2. ネットワーク要求を作成します。 - - ### Swift 3.0 - {: #ios-swift3 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - - ### Swift 2.2 - {: #ios-swift22 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - -`Request` クラスは、HTTP 要求を行い、要求が完了した後に応答を取得するためのシンプルな方法です。`Request` クラスよりも高い柔軟性と制御性が必要な場合は、`BMSURLSession` クラスを使用できます。`BMSURLSession` クラスのフィーチャーとしては、アップロードの進行状態のモニター、および要求の一時停止やキャンセルなどがあります。応答を取得するには、完了ハンドラーか代行のいずれかを選択するというオプションがあります。 - -`BMSURLSession` クラスは iOS でのみ使用可能です。`BMSURLSession` について詳しくは、`BMSCore` SDK の [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) を参照してください。 - - -## Cordova -{: #request-cordova} - -1. Cordova アプリケーションに [Client SDK をインポートして初期化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova)しておくようにしてください。 - -2. ネットワーク要求を作成します。 - - ``` - var success = function(data) { - console.log("success", data); - } - var failure = function(error) - {console.log("failure", error); - } - var request = new BMSRequest("", BMSRequest.GET); - request.send(success, failure); - ``` - {: codeblock} - - -# 関連リンク -{: #rellinks notoc} - -## 関連リンク -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# ネットワーク要求を行う +{: #sdk-network-request} + +`BMSCore` SDK を使用して、任意のリソースにネットワーク要求を行うこともできます。 + +## Android +{: #request-android} + +1. Android アプリケーションに [Client SDK をインポートして初期化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android)しておくようにしてください。 + +2. ネットワーク要求を行います。 + + ``` + public void makeGetCall() { + Thread thread = new Thread(new Runnable() { + @Override + public void run() { + try { + Request request = new Request("http://httpbin.org/get", "GET"); + request.send(null, null); + } catch (Exception e) { + // Handle failure here. + } + } + }); + thread.start(); + } + ``` + {: codeblock} + +## iOS +{: #request-ios} + +1. iOS アプリケーションに [Client SDK をインポートして初期化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios)しておくようにしてください。 + +2. ネットワーク要求を作成します。 + + ### Swift 3.0 + {: #ios-swift3 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + + ### Swift 2.2 + {: #ios-swift22 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + +`Request` クラスは、HTTP 要求を行い、要求が完了した後に応答を取得するためのシンプルな方法です。`Request` クラスよりも高い柔軟性と制御性が必要な場合は、`BMSURLSession` クラスを使用できます。`BMSURLSession` クラスのフィーチャーとしては、アップロードの進行状態のモニター、および要求の一時停止やキャンセルなどがあります。応答を取得するには、完了ハンドラーか代行のいずれかを選択するというオプションがあります。 + +`BMSURLSession` クラスは iOS でのみ使用可能です。`BMSURLSession` について詳しくは、`BMSCore` SDK の [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) を参照してください。 + + +## Cordova +{: #request-cordova} + +1. Cordova アプリケーションに [Client SDK をインポートして初期化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova)しておくようにしてください。 + +2. ネットワーク要求を作成します。 + + ``` + var success = function(data) { + console.log("success", data); + } + var failure = function(error) + {console.log("failure", error); + } + var request = new BMSRequest("", BMSRequest.GET); + request.send(success, failure); + ``` + {: codeblock} + + +# 関連リンク +{: #rellinks notoc} + +## 関連リンク +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova Plugin](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/ja/services.md b/cloudnative/nl/ja/services.md index d4c04c023..4a31c9606 100644 --- a/cloudnative/nl/ja/services.md +++ b/cloudnative/nl/ja/services.md @@ -1,54 +1,54 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# サービス -{: #services} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} **「サービス」**ページから、既存の Web および Mobile サービスを表示したり、新しいサービスを作成したりできます。コンソールにより、プロジェクトで管理されているすべての {{site.data.keyword.Bluemix_notm}} Web およびモバイル・サービスを 1 カ所で表示できます。 - -**「サービス」**ビューからサービスを削除すると、そのサービスが関連付けられているプロジェクトからそのサービスを切断することになります。そのサービスをプロジェクトに再接続したい場合は、新しいサービス・インスタンスを作成してください。 - -## {{site.data.keyword.Bluemix_notm}} Web およびモバイル・サービスの概要 -{: #mobile_services_overview} - -以下の表で、{{site.data.keyword.Bluemix_notm}} Web およびモバイル・サービスを説明します。個々のサービスを {{site.data.keyword.Bluemix_notm}} カタログから使用することも、これらのサービスを統合してプロジェクトに入れることもできます。 - - - - - - - - - - - - - - - - - - - -
表 1. {{site.data.keyword.Bluemix_notm}} Web およびモバイル・サービス
{{site.data.keyword.Bluemix_notm}} Web およびモバイル・サービス説明
{{site.data.keyword.mobileanalytics_short}} アイコン
{{site.data.keyword.mobileanalytics_short}}		{{site.data.keyword.mobileanalytics_full}} サービスを使用して、モバイル・アプリがどのように実行され、使用されているのかについての洞察を得ることができます。

-このサービスの操作について詳しくは、{{site.data.keyword.mobileanalytics_short}} の資料をお読みください。 -
{{site.data.keyword.mobilefoundation_short}} サービス・アイコン
{{site.data.keyword.mobilefoundation_short}}		{{site.data.keyword.mobilefoundation_long}} サービスを使用して、エンタープライズ・モバイル・アプリの開発、テスト、操作を行うことのできる {{site.data.keyword.mfp_full}} 環境のセットアップを迅速に行います。

-このサービスの操作について詳しくは、{{site.data.keyword.mobilefoundation_short}} の資料をお読みください。
{{site.data.keyword.mobilepushshort}} サービス・アイコン
{{site.data.keyword.mobilepushshort}}		{{site.data.keyword.mobilepushfull}} サービスは、複数のプラットフォームをターゲットとするモバイル・プッシュ通知と Web のプッシュ通知を送信および管理するための統合プラットフォームを提供します。 -

-{{site.data.keyword.mobilepushshort}} は、アプリケーション・ユーザーとそれらのユーザーが使用するデバイス、デバイス・プラットフォーム、Web ブラウザーとの間のマッピングを管理し、プッシュ通知のディスパッチを処理します。ブロードキャスト、ユニキャスト (ユーザー ID とデバイス ID に基づく)、およびタグ (またはトピック) をプッシュ通知としてモバイル・アプリケーション・ユーザーと Web ブラウザー・アプリケーション・ユーザーに送信することができます。また、SDK および REST API を使用してクライアント・アプリケーションをさらに開発することもできます。 -

-このサービスの操作について詳しくは、{{site.data.keyword.mobilepushshort}} の資料をお読みください。
+--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# サービス +{: #services} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} **「サービス」**ページから、既存の Web および Mobile サービスを表示したり、新しいサービスを作成したりできます。コンソールにより、プロジェクトで管理されているすべての {{site.data.keyword.Bluemix_notm}} Web およびモバイル・サービスを 1 カ所で表示できます。 + +**「サービス」**ビューからサービスを削除すると、そのサービスが関連付けられているプロジェクトからそのサービスを切断することになります。そのサービスをプロジェクトに再接続したい場合は、新しいサービス・インスタンスを作成してください。 + +## {{site.data.keyword.Bluemix_notm}} Web およびモバイル・サービスの概要 +{: #mobile_services_overview} + +以下の表で、{{site.data.keyword.Bluemix_notm}} Web およびモバイル・サービスを説明します。個々のサービスを {{site.data.keyword.Bluemix_notm}} カタログから使用することも、これらのサービスを統合してプロジェクトに入れることもできます。 + + + + + + + + + + + + + + + + + + + +
表 1. {{site.data.keyword.Bluemix_notm}} Web およびモバイル・サービス
{{site.data.keyword.Bluemix_notm}} Web およびモバイル・サービス説明
{{site.data.keyword.mobileanalytics_short}} アイコン
{{site.data.keyword.mobileanalytics_short}}		{{site.data.keyword.mobileanalytics_full}} サービスを使用して、モバイル・アプリがどのように実行され、使用されているのかについての洞察を得ることができます。

+このサービスの操作について詳しくは、{{site.data.keyword.mobileanalytics_short}} の資料をお読みください。 +
{{site.data.keyword.mobilefoundation_short}} サービス・アイコン
{{site.data.keyword.mobilefoundation_short}}		{{site.data.keyword.mobilefoundation_long}} サービスを使用して、エンタープライズ・モバイル・アプリの開発、テスト、操作を行うことのできる {{site.data.keyword.mfp_full}} 環境のセットアップを迅速に行います。

+このサービスの操作について詳しくは、{{site.data.keyword.mobilefoundation_short}} の資料をお読みください。
{{site.data.keyword.mobilepushshort}} サービス・アイコン
{{site.data.keyword.mobilepushshort}}		{{site.data.keyword.mobilepushfull}} サービスは、複数のプラットフォームをターゲットとするモバイル・プッシュ通知と Web のプッシュ通知を送信および管理するための統合プラットフォームを提供します。 +

+{{site.data.keyword.mobilepushshort}} は、アプリケーション・ユーザーとそれらのユーザーが使用するデバイス、デバイス・プラットフォーム、Web ブラウザーとの間のマッピングを管理し、プッシュ通知のディスパッチを処理します。ブロードキャスト、ユニキャスト (ユーザー ID とデバイス ID に基づく)、およびタグ (またはトピック) をプッシュ通知としてモバイル・アプリケーション・ユーザーと Web ブラウザー・アプリケーション・ユーザーに送信することができます。また、SDK および REST API を使用してクライアント・アプリケーションをさらに開発することもできます。 +

+このサービスの操作について詳しくは、{{site.data.keyword.mobilepushshort}} の資料をお読みください。
diff --git a/cloudnative/nl/ja/starters.md b/cloudnative/nl/ja/starters.md index e6be6fe34..aefa406fb 100644 --- a/cloudnative/nl/ja/starters.md +++ b/cloudnative/nl/ja/starters.md @@ -1,26 +1,26 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# スターター -{: #starters} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} で、各パターン・タイプに対応したさまざまなスターターから選択することができます。 - -スターターは、主要な {{site.data.keyword.Bluemix_notm}} と高価値サービスとの統合を示すことに焦点を当てた、実動準備の完了したスターター・コードになるように最適化されています。各スターターが 1 つのサービスに焦点を合わせていて、コードへのサービス SDK の統合を示します。場合によっては、スターターは、シンプルなユーザー・エクスペリエンスを提供してサービス・データの統合やユーザーとの対話を特長とします。プロジェクト用に Authentication (認証)、Data (データ)、およびその他の機能を構成すると決めた場合、各スターターはそれらの機能を有効にするように構成されます。 - - -## チュートリアル -{: #tutorials notoc} - -スターターでのアプリの作成方法についての詳しい説明が必要な場合は、エンドツーエンドの[チュートリアル](tutorials.html)を使用できます。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# スターター +{: #starters} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} で、各パターン・タイプに対応したさまざまなスターターから選択することができます。 + +スターターは、主要な {{site.data.keyword.Bluemix_notm}} と高価値サービスとの統合を示すことに焦点を当てた、実動準備の完了したスターター・コードになるように最適化されています。各スターターが 1 つのサービスに焦点を合わせていて、コードへのサービス SDK の統合を示します。場合によっては、スターターは、シンプルなユーザー・エクスペリエンスを提供してサービス・データの統合やユーザーとの対話を特長とします。プロジェクト用に Authentication (認証)、Data (データ)、およびその他の機能を構成すると決めた場合、各スターターはそれらの機能を有効にするように構成されます。 + + +## チュートリアル +{: #tutorials notoc} + +スターターでのアプリの作成方法についての詳しい説明が必要な場合は、エンドツーエンドの[チュートリアル](tutorials.html)を使用できます。 diff --git a/cloudnative/nl/ja/troubleshoot.md b/cloudnative/nl/ja/troubleshoot.md index f6d267701..050c776f5 100644 --- a/cloudnative/nl/ja/troubleshoot.md +++ b/cloudnative/nl/ja/troubleshoot.md @@ -1,223 +1,223 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# トラブルシューティング -{: #ts} - -{{site.data.keyword.dev_cli_notm}} に関するいくつかの既知の問題を回避策とともに示します。 -{:shortdesc} - - - -## 既知の問題 -{: #knownissues} - -以下のセクションでは、既知の問題と、考えられる解決策について説明します。 - - -### 非モバイル・パターンでプロジェクトを作成中に、ホスト名が使用されているというエラーが発生する -{: #hostname} - -{{site.data.keyword.dev_cli_short}} を使用して Web アプリ、BFF、またはマイクロサービスのパターンからプロジェクトを作成する場合に、以下のエラーが発生することがあります。 - -``` -The hostname is taken. -``` -{: codeblock} - - -#### 原因 -{: #hostname-cause} - -このエラーは、期限切れのログイン・トークンが原因です。 - - -#### 解決策 -{: #hostname-resolution} - -もう一度ログインしてください。 - -``` -bx login -``` -{: codeblock} - - -### {{site.data.keyword.dev_cli_short}} での一般障害 -{: #general} - -{{site.data.keyword.dev_cli_short}} の create、delete、list、または code のコマンドを使用した場合に、以下のエラーが発生することがあります。 - -``` -Failed to project. -``` -{: codeblock} - - -#### 原因 -{: #hostname-cause} - -このエラーは、期限切れのログイン・トークンが原因です。 - - -#### 解決策 -{: #hostname-resolution} - -もう一度ログインしてください。 - -``` -bx login -``` -{: codeblock} - - -### {{site.data.keyword.objectstorageshort}} 機能を追加する際にサービス・ブローカー・エラーが発生する -{: #os} - -{{site.data.keyword.dev_cli_short}} を使用して {{site.data.keyword.objectstorageshort}} 機能で 2 つのプロジェクトを作成する場合に、以下のエラーが発生することがあります。 - -``` -FAILED -Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} -``` -{: codeblock} - - -#### 原因 -{: #os-cause} - -このエラーは、{{site.data.keyword.objectstorageshort}} サービスが、無料 {{site.data.keyword.objectstorageshort}} プランのインスタンスを 1 つしか許可しないことが原因です。 - - -#### 解決策 -{: #os-resolution} - -このエラーを回避するために、別のプランを選択するよう求められます。 - - -### プロジェクト作成中にコード取得に失敗する -{: #code} - -{{site.data.keyword.dev_cli_short}} を使用してプロジェクトを作成する場合に、以下のエラーが発生することがあります。 - -``` -FAILED -Project created, but could not get code -https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code -``` -{: codeblock} - - -#### 原因 -{: #code-cause} - -このエラーは、内部タイムアウトが原因です。 - - -#### 解決策 -{: #code-resolution} - -コードは、以下のいずれかの方法で取得できます。 - -* CLI で次のコマンドを実行します。 - - ``` - bx dev code - ``` - {: codeblock} - - `` は、プロジェクト作成中に使用したプロジェクト名に置き換えてください。 - -* {{site.data.keyword.dev_console}} を使用します。 - - 1. {{site.data.keyword.dev_console}} で[プロジェクト ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.{DomainName}/developer/projects) を選択して、**「コードの取得 (Get the Code)」**をクリックします。 - - 2. **「コードの生成 (Generate Code)」**をクリックします。 - - 3. コードが生成されたら、**「コードのダウンロード」**をクリックします。 - - -### Node.js プロジェクトで `bx dev run` を実行中にエラーが発生する -{: #node} - -Node.js Web または BFF プロジェクトについて {{site.data.keyword.dev_cli_short}} で `bx dev run` を実行中に、次のエラーが発生することがあります。 - -``` -module.js:597 - return process.dlopen(module, path._makeLong(filename)); - ^ - -Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header - at Error (native) - at Object.Module._extensions..node (module.js:597:18) - at Module.load (module.js:487:32) - at tryModuleLoad (module.js:446:12) - - at Function.Module._load (module.js:438:3) - at Module.require (module.js:497:17) - at require (internal/module.js:20:19) - at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) - at Module._compile (module.js:570:32) - at Object.Module._extensions..js (module.js:579:10) -``` -{: codeblock} - - -#### 原因 -{: #node-cause} - -このエラーは、`appmetrics` モジュールが別のアーキテクチャーでインストールされていることが原因です。1 つのアーキテクチャーでインストールされたネイティブ npm モジュールは、別のアーキテクチャーで動作しません。組み込まれた Docker イメージは、Linux カーネルをベースとしています。 - - -#### 解決策 -{: #node-resolution} - -`node_modules` フォルダーを削除して、`bx dev run` をもう一度実行してください。 - - - - - - - -## ヘルプおよびサポートの利用 -{: #gettinghelp} - -{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} または {{site.data.keyword.dev_cli_notm}} の使用時に問題または質問がある場合、情報を検索するか、フォーラムを通して質問することによって、ヘルプを利用できます。また、サポート・チケットをオープンすることも可能です。 - -フォーラムを使用して質問するときは、{{site.data.keyword.Bluemix_notm}} 開発チームの目に止まるように、質問にタグを付けてください。 - - - -{{site.data.keyword.dev_console}} または {{site.data.keyword.dev_cli_notm}} でのアプリの開発またはデプロイについて技術的な質問がある場合は、以下を行ってください。 - -* [スタック・オーバーフロー ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) で質問を投稿し、`bluemix-dev-services` と `ibm-bluemix` のタグを付けます。 -* [Slack ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://ibm-cloud-tech.slack.com/) の `bluemix-dev-services` チャネルで質問を投稿します。今すぐ[ご登録ください![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://ibm.biz/IBMCloudNativeSlack)。 - - - - - -フォーラムの使用について詳しくは、[ヘルプの利用 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/support/index.html#getting-help) を参照してください。 - -{{site.data.keyword.IBM}} サポート・チケットのオープン、またはサポート・レベルとチケットの重大度については、[サポートへのお問い合わせ ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/support/index.html#contacting-support) を参照してください。 - - - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# トラブルシューティング +{: #ts} + +{{site.data.keyword.dev_cli_notm}} に関するいくつかの既知の問題を回避策とともに示します。 +{:shortdesc} + + + +## 既知の問題 +{: #knownissues} + +以下のセクションでは、既知の問題と、考えられる解決策について説明します。 + + +### 非モバイル・パターンでプロジェクトを作成中に、ホスト名が使用されているというエラーが発生する +{: #hostname} + +{{site.data.keyword.dev_cli_short}} を使用して Web アプリ、BFF、またはマイクロサービスのパターンからプロジェクトを作成する場合に、以下のエラーが発生することがあります。 + +``` +The hostname is taken. +``` +{: codeblock} + + +#### 原因 +{: #hostname-cause} + +このエラーは、期限切れのログイン・トークンが原因です。 + + +#### 解決策 +{: #hostname-resolution} + +もう一度ログインしてください。 + +``` +bx login +``` +{: codeblock} + + +### {{site.data.keyword.dev_cli_short}} での一般障害 +{: #general} + +{{site.data.keyword.dev_cli_short}} の create、delete、list、または code のコマンドを使用した場合に、以下のエラーが発生することがあります。 + +``` +Failed to project. +``` +{: codeblock} + + +#### 原因 +{: #hostname-cause} + +このエラーは、期限切れのログイン・トークンが原因です。 + + +#### 解決策 +{: #hostname-resolution} + +もう一度ログインしてください。 + +``` +bx login +``` +{: codeblock} + + +### {{site.data.keyword.objectstorageshort}} 機能を追加する際にサービス・ブローカー・エラーが発生する +{: #os} + +{{site.data.keyword.dev_cli_short}} を使用して {{site.data.keyword.objectstorageshort}} 機能で 2 つのプロジェクトを作成する場合に、以下のエラーが発生することがあります。 + +``` +FAILED +Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} +``` +{: codeblock} + + +#### 原因 +{: #os-cause} + +このエラーは、{{site.data.keyword.objectstorageshort}} サービスが、無料 {{site.data.keyword.objectstorageshort}} プランのインスタンスを 1 つしか許可しないことが原因です。 + + +#### 解決策 +{: #os-resolution} + +このエラーを回避するために、別のプランを選択するよう求められます。 + + +### プロジェクト作成中にコード取得に失敗する +{: #code} + +{{site.data.keyword.dev_cli_short}} を使用してプロジェクトを作成する場合に、以下のエラーが発生することがあります。 + +``` +FAILED +Project created, but could not get code +https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code +``` +{: codeblock} + + +#### 原因 +{: #code-cause} + +このエラーは、内部タイムアウトが原因です。 + + +#### 解決策 +{: #code-resolution} + +コードは、以下のいずれかの方法で取得できます。 + +* CLI で次のコマンドを実行します。 + + ``` + bx dev code + ``` + {: codeblock} + + `` は、プロジェクト作成中に使用したプロジェクト名に置き換えてください。 + +* {{site.data.keyword.dev_console}} を使用します。 + + 1. {{site.data.keyword.dev_console}} で[プロジェクト ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.{DomainName}/developer/projects) を選択して、**「コードの取得 (Get the Code)」**をクリックします。 + + 2. **「コードの生成 (Generate Code)」**をクリックします。 + + 3. コードが生成されたら、**「コードのダウンロード」**をクリックします。 + + +### Node.js プロジェクトで `bx dev run` を実行中にエラーが発生する +{: #node} + +Node.js Web または BFF プロジェクトについて {{site.data.keyword.dev_cli_short}} で `bx dev run` を実行中に、次のエラーが発生することがあります。 + +``` +module.js:597 + return process.dlopen(module, path._makeLong(filename)); + ^ + +Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header + at Error (native) + at Object.Module._extensions..node (module.js:597:18) + at Module.load (module.js:487:32) + at tryModuleLoad (module.js:446:12) + + at Function.Module._load (module.js:438:3) + at Module.require (module.js:497:17) + at require (internal/module.js:20:19) + at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) + at Module._compile (module.js:570:32) + at Object.Module._extensions..js (module.js:579:10) +``` +{: codeblock} + + +#### 原因 +{: #node-cause} + +このエラーは、`appmetrics` モジュールが別のアーキテクチャーでインストールされていることが原因です。1 つのアーキテクチャーでインストールされたネイティブ npm モジュールは、別のアーキテクチャーで動作しません。組み込まれた Docker イメージは、Linux カーネルをベースとしています。 + + +#### 解決策 +{: #node-resolution} + +`node_modules` フォルダーを削除して、`bx dev run` をもう一度実行してください。 + + + + + + + +## ヘルプおよびサポートの利用 +{: #gettinghelp} + +{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} または {{site.data.keyword.dev_cli_notm}} の使用時に問題または質問がある場合、情報を検索するか、フォーラムを通して質問することによって、ヘルプを利用できます。また、サポート・チケットをオープンすることも可能です。 + +フォーラムを使用して質問するときは、{{site.data.keyword.Bluemix_notm}} 開発チームの目に止まるように、質問にタグを付けてください。 + + + +{{site.data.keyword.dev_console}} または {{site.data.keyword.dev_cli_notm}} でのアプリの開発またはデプロイについて技術的な質問がある場合は、以下を行ってください。 + +* [スタック・オーバーフロー ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) で質問を投稿し、`bluemix-dev-services` と `ibm-bluemix` のタグを付けます。 +* [Slack ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://ibm-cloud-tech.slack.com/) の `bluemix-dev-services` チャネルで質問を投稿します。今すぐ[ご登録ください![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](http://ibm.biz/IBMCloudNativeSlack)。 + + + + + +フォーラムの使用について詳しくは、[ヘルプの利用 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/support/index.html#getting-help) を参照してください。 + +{{site.data.keyword.IBM}} サポート・チケットのオープン、またはサポート・レベルとチケットの重大度については、[サポートへのお問い合わせ ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/support/index.html#contacting-support) を参照してください。 + + + diff --git a/cloudnative/nl/ja/tutorial_bff.md b/cloudnative/nl/ja/tutorial_bff.md index 38dc79768..27826d53c 100644 --- a/cloudnative/nl/ja/tutorial_bff.md +++ b/cloudnative/nl/ja/tutorial_bff.md @@ -1,147 +1,147 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# BFF ベーシック・スターターのエンドツーエンド・チュートリアル -{: #tutorial} - -以下のエンドツーエンド・チュートリアルでは、インストールしておく必要があるツールを含め、BFF ベーシック・スターターからプロジェクトを作成するための手順を段階的に説明し、その後に、プロジェクト・コードの実行手順を説明します。 - -## 開発者ツールのインストール -{: #dev_tools} - -[前提条件の開発者ツール ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](get_code.html#prereq-dev-tools){: new_window} をインストール済みであることを確認します。 - - -## {{site.data.keyword.dev_console}} を使用したプロジェクトの作成 -{: #create-devex} - -1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} でプロジェクトを作成します。 - - 1. {{site.data.keyword.dev_console}} の**「開始」**ページで**「プロジェクトの作成」**をクリックします。 - - 代替方法として、**「プロジェクト」**ページから**「プロジェクトの作成」**をクリックすることもできます。 - - 2. **「Backend for Frontend」**を選択して**「次へ」**をクリックします。 - - 3. **「ベーシック・バックエンド (Basic Backend)」**を選択し、**「次へ」**をクリックします。 - - 4. プロジェクト名を入力します。このチュートリアルでは、`BFFProject` を使用します。 - - 5. ホスト名を入力します。このチュートリアルでは、`devhost` を使用します。 - - 6. 言語プラットフォームを選択します。このチュートリアルでは、`Node` を使用します。 - - 7. **「作成」**をクリックします。 - -2. オプション: Data (データ) 機能を追加します。 - - 1. **「プロジェクト概要 (Project Overview)」**ページで、**「Data (データ)」**に対して**「表示」**をクリックします。 - - 代替方法として、**「機能 (Capabilities)」>「Data (データ)」**ページで**「作成」**または**「既存の追加 (Add Existing)」**を選択することもできます。 - - 2. サービス名を入力し、**「作成」**をクリックします。 - - -3. プロジェクト・コードを生成します。 - - 1. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 - - 代替方法として、**「コード」**ページで以下をクリックすることもできます。 - - 2. **「コードの生成 (Generate Code)」**をクリックします。 - - 3. プロジェクト・コードの生成が完了したら、**「コードのダウンロード」**をクリックして、プロジェクトのアーカイブをダウンロードします。 - -4. オプション: 新しい言語を生成するために[プロジェクトを更新します](project_overview_page.html#update_language)。 - - -## {{site.data.keyword.dev_cli_notm}} を使用したプロジェクトの作成 -{: #create-cli} - -1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html) がインストールされていることを確認します。 - -2. 端末のプロンプトで、使用するローカル・ディレクトリーにナビゲートし、以下のコマンドを実行します。 - - ``` - bx dev create - ``` - {: codeblock} - -3. プロンプトが出されたら、以下の値を入力します。 - - * パターンの選択: 3 (Backend for Frontend) - * スターターの選択: 1 (ベーシック・バックエンド) - * 言語の選択: 1 (Node) - * プロジェクト名の入力: `BFFProjectCLI` - * プロジェクトのホスト名の入力: `myhost` - -4. プロジェクトにサービスを追加する場合は、該当の質問のプロンプトで `y` を入力し、残りの質問に答えます。 - -5. `BFFProjectCLI` が正常に保存されたら、`BFFProjectCLI` フォルダーにナビゲートします。 - -6. この時点で、独自コードを追加することや、プロジェクトをビルドまたは実行することができます。 - - 1. 以下のコマンドを使用してプロジェクトをビルドします。 - - ``` - bx dev build - ``` - {: codeblock} - - 2. 以下のコマンドを使用してプロジェクトを実行します。 - - ``` - bx dev run - ``` - {: codeblock} - - -## BFF プロジェクトの実行 -{: #running-bff} - -### ローカルの場合 -{: #bff-local} - -1. サーバーをコンパイルします。 - - ``` - swift build - ``` - {: codeblock} - -2. アプリケーションを実行します。例えば、アプリケーションの名前が `MyServer` の場合、以下のようにします。 - - ``` - .build/debug/MyServer - ``` - {: codeblock} - -3. `curl http://localhost:8080` により、サーバーで curl を実行できます。 - - -### Bluemix プラグインを使用する場合 -{: #using-blumix} - -1. コンパイルを実行します。 - - ``` - bx dev run - ``` - {: codeblock} - -2. 以下により、サーバーで curl を実行できます。 - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# BFF ベーシック・スターターのエンドツーエンド・チュートリアル +{: #tutorial} + +以下のエンドツーエンド・チュートリアルでは、インストールしておく必要があるツールを含め、BFF ベーシック・スターターからプロジェクトを作成するための手順を段階的に説明し、その後に、プロジェクト・コードの実行手順を説明します。 + +## 開発者ツールのインストール +{: #dev_tools} + +[前提条件の開発者ツール ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](get_code.html#prereq-dev-tools){: new_window} をインストール済みであることを確認します。 + + +## {{site.data.keyword.dev_console}} を使用したプロジェクトの作成 +{: #create-devex} + +1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} でプロジェクトを作成します。 + + 1. {{site.data.keyword.dev_console}} の**「開始」**ページで**「プロジェクトの作成」**をクリックします。 + + 代替方法として、**「プロジェクト」**ページから**「プロジェクトの作成」**をクリックすることもできます。 + + 2. **「Backend for Frontend」**を選択して**「次へ」**をクリックします。 + + 3. **「ベーシック・バックエンド (Basic Backend)」**を選択し、**「次へ」**をクリックします。 + + 4. プロジェクト名を入力します。このチュートリアルでは、`BFFProject` を使用します。 + + 5. ホスト名を入力します。このチュートリアルでは、`devhost` を使用します。 + + 6. 言語プラットフォームを選択します。このチュートリアルでは、`Node` を使用します。 + + 7. **「作成」**をクリックします。 + +2. オプション: Data (データ) 機能を追加します。 + + 1. **「プロジェクト概要 (Project Overview)」**ページで、**「Data (データ)」**に対して**「表示」**をクリックします。 + + 代替方法として、**「機能 (Capabilities)」>「Data (データ)」**ページで**「作成」**または**「既存の追加 (Add Existing)」**を選択することもできます。 + + 2. サービス名を入力し、**「作成」**をクリックします。 + + +3. プロジェクト・コードを生成します。 + + 1. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 + + 代替方法として、**「コード」**ページで以下をクリックすることもできます。 + + 2. **「コードの生成 (Generate Code)」**をクリックします。 + + 3. プロジェクト・コードの生成が完了したら、**「コードのダウンロード」**をクリックして、プロジェクトのアーカイブをダウンロードします。 + +4. オプション: 新しい言語を生成するために[プロジェクトを更新します](project_overview_page.html#update_language)。 + + +## {{site.data.keyword.dev_cli_notm}} を使用したプロジェクトの作成 +{: #create-cli} + +1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html) がインストールされていることを確認します。 + +2. 端末のプロンプトで、使用するローカル・ディレクトリーにナビゲートし、以下のコマンドを実行します。 + + ``` + bx dev create + ``` + {: codeblock} + +3. プロンプトが出されたら、以下の値を入力します。 + + * パターンの選択: 3 (Backend for Frontend) + * スターターの選択: 1 (ベーシック・バックエンド) + * 言語の選択: 1 (Node) + * プロジェクト名の入力: `BFFProjectCLI` + * プロジェクトのホスト名の入力: `myhost` + +4. プロジェクトにサービスを追加する場合は、該当の質問のプロンプトで `y` を入力し、残りの質問に答えます。 + +5. `BFFProjectCLI` が正常に保存されたら、`BFFProjectCLI` フォルダーにナビゲートします。 + +6. この時点で、独自コードを追加することや、プロジェクトをビルドまたは実行することができます。 + + 1. 以下のコマンドを使用してプロジェクトをビルドします。 + + ``` + bx dev build + ``` + {: codeblock} + + 2. 以下のコマンドを使用してプロジェクトを実行します。 + + ``` + bx dev run + ``` + {: codeblock} + + +## BFF プロジェクトの実行 +{: #running-bff} + +### ローカルの場合 +{: #bff-local} + +1. サーバーをコンパイルします。 + + ``` + swift build + ``` + {: codeblock} + +2. アプリケーションを実行します。例えば、アプリケーションの名前が `MyServer` の場合、以下のようにします。 + + ``` + .build/debug/MyServer + ``` + {: codeblock} + +3. `curl http://localhost:8080` により、サーバーで curl を実行できます。 + + +### Bluemix プラグインを使用する場合 +{: #using-blumix} + +1. コンパイルを実行します。 + + ``` + bx dev run + ``` + {: codeblock} + +2. 以下により、サーバーで curl を実行できます。 + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/ja/tutorial_microservice.md b/cloudnative/nl/ja/tutorial_microservice.md index d555cd7d4..14ea24031 100644 --- a/cloudnative/nl/ja/tutorial_microservice.md +++ b/cloudnative/nl/ja/tutorial_microservice.md @@ -1,113 +1,113 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# マイクロサービス・ベーシック・スターターのエンドツーエンド・チュートリアル -{: #tutorial} - -以下のエンドツーエンド・チュートリアルでは、インストールしておく必要があるツールを含め、マイクロサービス・ベーシック・スターターからプロジェクトを作成するための手順を段階的に説明し、その後に、プロジェクト・コードの実行手順を説明します。 - -## 開発者ツールのインストール -{: #dev_tools} - -[前提条件の開発者ツール ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](get_code.html#prereq-dev-tools){: new_window} をインストール済みであることを確認します。 - - -## {{site.data.keyword.dev_console}} を使用したプロジェクトの作成 -{: #create-devex} - -1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} でプロジェクトを作成します。 - - 1. {{site.data.keyword.dev_console}} の**「開始」**ページで**「プロジェクトの作成」**をクリックします。 - - 代替方法として、**「プロジェクト」**ページから**「プロジェクトの作成」**をクリックすることもできます。 - - 2. **「マイクロサービス (Microservice)」**を選択し、**「次へ」**をクリックします。 - - 3. **「ベーシック (Basic)」**を選択し、**「次へ」**をクリックします。 - - 4. プロジェクト名を入力します。このチュートリアルでは、`MicroserviceProject` を使用します。 - - 5. ホスト名を入力します。このチュートリアルでは、`devhost` を使用します。 - - 6. **「作成」**をクリックします。 - -2. オプション: Data (データ) 機能を追加します。 - - 1. **「プロジェクト概要 (Project Overview)」**ページで、**「Data (データ)」**に対して**「表示」**をクリックします。 - - 代替方法として、**「機能 (Capabilities)」>「Data (データ)」**ページで**「作成」**または**「既存の追加 (Add Existing)」**を選択することもできます。 - - 2. サービス名を入力し、**「作成」**をクリックします。 - -3. プロジェクト・コードを生成します。 - - 1. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 - - 代替方法として、**「コード」**ページで以下をクリックすることもできます。 - - 2. **「コードの生成 (Generate Code)」**をクリックします。 - - 3. プロジェクト・コードの生成が完了したら、**「コードのダウンロード」**をクリックして、プロジェクトのアーカイブをダウンロードします。 - -4. オプション: 新しい言語を生成するために[プロジェクトを更新します](project_overview_page.html#update_language)。 - - -## {{site.data.keyword.dev_cli_notm}} を使用したプロジェクトの作成 -{: #create-cli} - -1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html) がインストールされていることを確認します。 - -2. 端末のプロンプトで、使用するローカル・ディレクトリーにナビゲートし、以下のコマンドを実行します。 - - ``` - bx dev create - ``` - {: codeblock} - -3. プロンプトが出されたら、以下の値を入力します。 - - * パターンの選択: 4 (マイクロサービス) - * スターターの選択: 1 (ベーシック) - * プラットフォームの選択: 3 (Java) - * プロジェクト名の入力: `MicroserviceProjectCLI` - -4. プロジェクトにサービスを追加する場合は、該当の質問のプロンプトで `y` を入力し、残りの質問に答えます。 - -5. `MicroserviceProjectCLI` が正常に保存されたら、`MicroserviceProjectCLI` フォルダーにナビゲートします。 - -6. この時点で、独自コードを追加することや、プロジェクトをビルドまたは実行することができます。 - - -## {{site.data.keyword.dev_cli_notm}} を使用したプロジェクトの実行 -{: #running-dev-plugin} - -1. 現行プロジェクト・ディレクトリーでプロジェクトをビルドするには、以下のコマンドを入力します。 - - ``` - bx dev build - ``` - {: codeblock} - -2. 現行プロジェクト・ディレクトリーでプロジェクトをビルドして実行するには、以下のコマンドを入力します。 - - ``` - bx dev run - ``` - {: codeblock} - -3. 以下のようにして、サーバーで curl を使用してアプリケーションにアクセスすることができます。 - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# マイクロサービス・ベーシック・スターターのエンドツーエンド・チュートリアル +{: #tutorial} + +以下のエンドツーエンド・チュートリアルでは、インストールしておく必要があるツールを含め、マイクロサービス・ベーシック・スターターからプロジェクトを作成するための手順を段階的に説明し、その後に、プロジェクト・コードの実行手順を説明します。 + +## 開発者ツールのインストール +{: #dev_tools} + +[前提条件の開発者ツール ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](get_code.html#prereq-dev-tools){: new_window} をインストール済みであることを確認します。 + + +## {{site.data.keyword.dev_console}} を使用したプロジェクトの作成 +{: #create-devex} + +1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} でプロジェクトを作成します。 + + 1. {{site.data.keyword.dev_console}} の**「開始」**ページで**「プロジェクトの作成」**をクリックします。 + + 代替方法として、**「プロジェクト」**ページから**「プロジェクトの作成」**をクリックすることもできます。 + + 2. **「マイクロサービス (Microservice)」**を選択し、**「次へ」**をクリックします。 + + 3. **「ベーシック (Basic)」**を選択し、**「次へ」**をクリックします。 + + 4. プロジェクト名を入力します。このチュートリアルでは、`MicroserviceProject` を使用します。 + + 5. ホスト名を入力します。このチュートリアルでは、`devhost` を使用します。 + + 6. **「作成」**をクリックします。 + +2. オプション: Data (データ) 機能を追加します。 + + 1. **「プロジェクト概要 (Project Overview)」**ページで、**「Data (データ)」**に対して**「表示」**をクリックします。 + + 代替方法として、**「機能 (Capabilities)」>「Data (データ)」**ページで**「作成」**または**「既存の追加 (Add Existing)」**を選択することもできます。 + + 2. サービス名を入力し、**「作成」**をクリックします。 + +3. プロジェクト・コードを生成します。 + + 1. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 + + 代替方法として、**「コード」**ページで以下をクリックすることもできます。 + + 2. **「コードの生成 (Generate Code)」**をクリックします。 + + 3. プロジェクト・コードの生成が完了したら、**「コードのダウンロード」**をクリックして、プロジェクトのアーカイブをダウンロードします。 + +4. オプション: 新しい言語を生成するために[プロジェクトを更新します](project_overview_page.html#update_language)。 + + +## {{site.data.keyword.dev_cli_notm}} を使用したプロジェクトの作成 +{: #create-cli} + +1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html) がインストールされていることを確認します。 + +2. 端末のプロンプトで、使用するローカル・ディレクトリーにナビゲートし、以下のコマンドを実行します。 + + ``` + bx dev create + ``` + {: codeblock} + +3. プロンプトが出されたら、以下の値を入力します。 + + * パターンの選択: 4 (マイクロサービス) + * スターターの選択: 1 (ベーシック) + * プラットフォームの選択: 3 (Java) + * プロジェクト名の入力: `MicroserviceProjectCLI` + +4. プロジェクトにサービスを追加する場合は、該当の質問のプロンプトで `y` を入力し、残りの質問に答えます。 + +5. `MicroserviceProjectCLI` が正常に保存されたら、`MicroserviceProjectCLI` フォルダーにナビゲートします。 + +6. この時点で、独自コードを追加することや、プロジェクトをビルドまたは実行することができます。 + + +## {{site.data.keyword.dev_cli_notm}} を使用したプロジェクトの実行 +{: #running-dev-plugin} + +1. 現行プロジェクト・ディレクトリーでプロジェクトをビルドするには、以下のコマンドを入力します。 + + ``` + bx dev build + ``` + {: codeblock} + +2. 現行プロジェクト・ディレクトリーでプロジェクトをビルドして実行するには、以下のコマンドを入力します。 + + ``` + bx dev run + ``` + {: codeblock} + +3. 以下のようにして、サーバーで curl を使用してアプリケーションにアクセスすることができます。 + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/ja/tutorial_mobile.md b/cloudnative/nl/ja/tutorial_mobile.md index 8044312bb..cdffc0cb0 100644 --- a/cloudnative/nl/ja/tutorial_mobile.md +++ b/cloudnative/nl/ja/tutorial_mobile.md @@ -1,187 +1,187 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# モバイル・ベーシック・スターターのエンドツーエンド・チュートリアル -{: #tutorial} - -以下のエンドツーエンド・チュートリアルでは、インストールしておく必要があるツールを含め、モバイル・ベーシック・スターターからプロジェクトを作成するための手順を段階的に説明し、その後に、Xcode および Android Studio でのプロジェクトの実行手順を説明します。 - - -## 開発者ツールのインストール -{: #dev_tools} - -[前提条件の開発者ツール ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](get_code.html#prereq-dev-tools){: new_window} をインストール済みであることを確認します。 - - -## {{site.data.keyword.dev_console}} を使用したプロジェクトの作成 -{: #create-devex} - -1. {{site.data.keyword.Bluemix}} で {{site.data.keyword.dev_console}} プロジェクトを作成します。 - - 1. {{site.data.keyword.dev_console}} の**「開始」**ページで**「プロジェクトの作成」**をクリックします。 - - 代替方法として、**「プロジェクト」**ページから**「プロジェクトの作成」**をクリックすることもできます。 - - 2. **「モバイル・アプリ (Mobile App)」**を選択し、**「次へ」**をクリックします。 - - 3. **「ベーシック (Basic)」**を選択し、**「次へ」**をクリックします。 - - 4. プロジェクト名を入力します。このチュートリアルでは、`MobileBasicProject` を使用します。 - - 5. プラットフォームを選択します。このチュートリアルでは、`Swift` を使用します。 - - 6. **「作成」**をクリックします。 - -2. オプション: Authentication (認証) 機能を追加します。 - - 1. **「プロジェクト概要 (Project Overview)」** ページで、**「Authentication (認証)」**に対して**「追加」**をクリックします。 - - 代替方法として、**「機能 (Capabilities)」>「Authentication (認証)」**ページで**「作成」**または**「既存の追加 (Add Existing)」**を選択することもできます。 - - 2. サービス名を入力し、**「作成」**をクリックします。 - - 3. **「Authentication (認証)」**をオンに切り替えます。 - - 4. ID プロバイダーを選択し、必要な情報を入力して構成します。ID プロバイダーは 1 つだけ有効にすることができます。 - - 5. Authentication (認証) の構成について詳しくは、[ID プロバイダーの構成 (Configuring identity providers) ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/services/appid/identity-providers.html){: new_window} を参照してください。 - -3. オプション: Analytics (分析) 機能を追加します。 - - 1. **「プロジェクト概要 (Project Overview)」** ページで、**「Analytics (分析)」**に対して**「追加」**をクリックします。 - - 代替方法として、**「機能 (Capabilities)」>「Analytics (分析)」**ページから**「作成」**または**「既存の追加 (Add Existing)」**をクリックすることもできます。 - - 2. サービス名を入力し、**「作成」**をクリックします。 - - 3. アプリを実行した後、**「デモ・モード」**をオフに切り替えて、分析データを確認できます。 - - 4. Analytics の構成について詳しくは、[「{{site.data.keyword.mobileanalytics_short}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン") の開始」](/docs/services/mobileanalytics/index.html){: new_window}を参照してください。 - -4. オプション: {{site.data.keyword.mobilepushshort}} 機能を追加します。 - - 1. **「プロジェクト概要 (Project Overview)」**ページで**「{{site.data.keyword.mobilepushshort}}」**に対して**「追加」**をクリックします。 - - 代替方法として、**「機能 (Capabilities)」>「{{site.data.keyword.mobilepushshort}}」**ページから**「作成」**または**「既存の追加 (Add Existing)」**をクリックすることもできます。 - - 2. サービス名を入力し、**「作成」**をクリックします。 - - 3. iOS の場合、[Apple Push Notification Service ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン") を構成します](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}。 - - 4. Android　の場合、[Firebase Cloud Messaging ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン") を構成します](/docs/services/mobilepush/t_push_provider_android.html){: new_window}。 - -5. オプション: Data (データ) 機能を追加します。 - - 1. **「プロジェクト概要 (Project Overview)」**ページで、**「Data (データ)」**に対して**「表示」**をクリックします。 - - 代替方法として、**「データ (Data)」**ページで**「作成」**を選択することもできます。 - - 2. **「{{site.data.keyword.cloudant_short_notm}}」**または**「{{site.data.keyword.objectstorageshort}}」**を選択します。 - - 3. サービス名を入力し、**「作成」**をクリックします。 - - 4. {{site.data.keyword.cloudant_short_notm}} の構成について詳しくは、[「{{site.data.keyword.cloudant_short_notm}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン") の概要」](/docs/services/Cloudant/index.html){: new_window}を参照してください。 - - 5. {{site.data.keyword.objectstorageshort}} の構成について詳しくは、[「{{site.data.keyword.objectstorageshort}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン") 入門」](/docs/services/ObjectStorage/index.html){: new_window}を参照してください。 - -6. プロジェクト・コードを生成します。 - - 1. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 - - 代替方法として、**「コード」**ページで以下をクリックすることもできます。 - - 2. **「Swift の生成 (Generate Swift)」**をクリックします。 - - 3. プロジェクト・コードの生成が完了したら、**「Swift のダウンロード (Download Swift)」**をクリックして、プロジェクトのアーカイブをダウンロードします。 - -7. オプション: 新しい言語を生成するために[プロジェクトを更新します](project_overview_page.html#update_language)。 - - -## {{site.data.keyword.dev_cli_notm}} を使用したプロジェクトの作成 -{: #create-cli} - -1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html) がインストールされていることを確認します。 - -2. 端末のプロンプトで、使用するローカル・ディレクトリーにナビゲートし、以下のコマンドを実行します。 - - ``` - bx dev create - ``` - {: codeblock} - -3. プロンプトが出されたら、以下の値を入力します。 - - * パターンの選択: 2 (モバイル) - * スターターの選択: 1 (ベーシック) - * プラットフォームの選択: 3 (iOS Swift) - * プロジェクト名の入力: `MobileBasicProjectCLI` - -4. プロジェクトにサービスを追加する場合は、該当の質問のプロンプトで `y` を入力し、残りの質問に答えます。 - -5. `MobileBasicProjectCLI` が正常に保存されたら、`MobileBasicProjectCLI/MobileBasicProjectCLI-Swift` フォルダーにナビゲートします。 - - -## Xcode での Swift プロジェクトの実行 -{: #run_swift} - -1. `MobileBasicProject-Swift.zip` ファイルを解凍します。 - -2. Markdown ビューアーで `README.md` ファイルを開き、プロジェクトを構成する手順を確認します。 - - 1. ターミナルを開き、プロジェクト・フォルダーに移動します。 - - 1. CocoaPods リポジトリーをセットアップする必要がある場合は、`pod setup` を実行します。 - - 2. 既存の Pods を更新する必要がある場合は、`pod update` を実行します。 - - 3. プロジェクトに必要な Pods をインストールするには、`pod install` を実行します。 - - 3. `BasicProject.xcworkspace` Xcode ワークスペースを開きます。 - -3. アプリを実行します。 - - -## Xcode での Cordova プロジェクトの実行 -{: #run_cordova_xcode} - -1. `MobileBasicProject-Cordova.zip` ファイルを解凍します。 - -2. Markdown ビューアーで `README.md` ファイルを開き、プロジェクトを構成します。 - - 1. Xcode で `platforms/ios` プロジェクトを開きます。 - -3. アプリを実行します。 - - -## Android Studio での Cordova プロジェクトの実行 -{: #run_cordova_studio} - -1. `BasicProject-Cordova.zip` ファイルを解凍します。 - -2. Markdown ビューアーで `README.md` ファイルを開き、プロジェクトを構成します。 - - 1. Android Studio で `platforms/android` プロジェクトを開きます。 - -3. アプリを実行します。 - - -## Android Studio での Android プロジェクトの実行 -{: #run_android} - -1. `MobileBasicProject-Android.zip` ファイルを解凍します。 - -2. Markdown ビューアーで `README.md` ファイルを開き、プロジェクトを構成します。 - - 1. Android Studio で `BasicProject-Android` プロジェクトを開きます。 - -3. アプリを実行します。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# モバイル・ベーシック・スターターのエンドツーエンド・チュートリアル +{: #tutorial} + +以下のエンドツーエンド・チュートリアルでは、インストールしておく必要があるツールを含め、モバイル・ベーシック・スターターからプロジェクトを作成するための手順を段階的に説明し、その後に、Xcode および Android Studio でのプロジェクトの実行手順を説明します。 + + +## 開発者ツールのインストール +{: #dev_tools} + +[前提条件の開発者ツール ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](get_code.html#prereq-dev-tools){: new_window} をインストール済みであることを確認します。 + + +## {{site.data.keyword.dev_console}} を使用したプロジェクトの作成 +{: #create-devex} + +1. {{site.data.keyword.Bluemix}} で {{site.data.keyword.dev_console}} プロジェクトを作成します。 + + 1. {{site.data.keyword.dev_console}} の**「開始」**ページで**「プロジェクトの作成」**をクリックします。 + + 代替方法として、**「プロジェクト」**ページから**「プロジェクトの作成」**をクリックすることもできます。 + + 2. **「モバイル・アプリ (Mobile App)」**を選択し、**「次へ」**をクリックします。 + + 3. **「ベーシック (Basic)」**を選択し、**「次へ」**をクリックします。 + + 4. プロジェクト名を入力します。このチュートリアルでは、`MobileBasicProject` を使用します。 + + 5. プラットフォームを選択します。このチュートリアルでは、`Swift` を使用します。 + + 6. **「作成」**をクリックします。 + +2. オプション: Authentication (認証) 機能を追加します。 + + 1. **「プロジェクト概要 (Project Overview)」** ページで、**「Authentication (認証)」**に対して**「追加」**をクリックします。 + + 代替方法として、**「機能 (Capabilities)」>「Authentication (認証)」**ページで**「作成」**または**「既存の追加 (Add Existing)」**を選択することもできます。 + + 2. サービス名を入力し、**「作成」**をクリックします。 + + 3. **「Authentication (認証)」**をオンに切り替えます。 + + 4. ID プロバイダーを選択し、必要な情報を入力して構成します。ID プロバイダーは 1 つだけ有効にすることができます。 + + 5. Authentication (認証) の構成について詳しくは、[ID プロバイダーの構成 (Configuring identity providers) ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/services/appid/identity-providers.html){: new_window} を参照してください。 + +3. オプション: Analytics (分析) 機能を追加します。 + + 1. **「プロジェクト概要 (Project Overview)」** ページで、**「Analytics (分析)」**に対して**「追加」**をクリックします。 + + 代替方法として、**「機能 (Capabilities)」>「Analytics (分析)」**ページから**「作成」**または**「既存の追加 (Add Existing)」**をクリックすることもできます。 + + 2. サービス名を入力し、**「作成」**をクリックします。 + + 3. アプリを実行した後、**「デモ・モード」**をオフに切り替えて、分析データを確認できます。 + + 4. Analytics の構成について詳しくは、[「{{site.data.keyword.mobileanalytics_short}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン") の開始」](/docs/services/mobileanalytics/index.html){: new_window}を参照してください。 + +4. オプション: {{site.data.keyword.mobilepushshort}} 機能を追加します。 + + 1. **「プロジェクト概要 (Project Overview)」**ページで**「{{site.data.keyword.mobilepushshort}}」**に対して**「追加」**をクリックします。 + + 代替方法として、**「機能 (Capabilities)」>「{{site.data.keyword.mobilepushshort}}」**ページから**「作成」**または**「既存の追加 (Add Existing)」**をクリックすることもできます。 + + 2. サービス名を入力し、**「作成」**をクリックします。 + + 3. iOS の場合、[Apple Push Notification Service ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン") を構成します](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}。 + + 4. Android　の場合、[Firebase Cloud Messaging ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン") を構成します](/docs/services/mobilepush/t_push_provider_android.html){: new_window}。 + +5. オプション: Data (データ) 機能を追加します。 + + 1. **「プロジェクト概要 (Project Overview)」**ページで、**「Data (データ)」**に対して**「表示」**をクリックします。 + + 代替方法として、**「データ (Data)」**ページで**「作成」**を選択することもできます。 + + 2. **「{{site.data.keyword.cloudant_short_notm}}」**または**「{{site.data.keyword.objectstorageshort}}」**を選択します。 + + 3. サービス名を入力し、**「作成」**をクリックします。 + + 4. {{site.data.keyword.cloudant_short_notm}} の構成について詳しくは、[「{{site.data.keyword.cloudant_short_notm}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン") の概要」](/docs/services/Cloudant/index.html){: new_window}を参照してください。 + + 5. {{site.data.keyword.objectstorageshort}} の構成について詳しくは、[「{{site.data.keyword.objectstorageshort}} ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン") 入門」](/docs/services/ObjectStorage/index.html){: new_window}を参照してください。 + +6. プロジェクト・コードを生成します。 + + 1. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 + + 代替方法として、**「コード」**ページで以下をクリックすることもできます。 + + 2. **「Swift の生成 (Generate Swift)」**をクリックします。 + + 3. プロジェクト・コードの生成が完了したら、**「Swift のダウンロード (Download Swift)」**をクリックして、プロジェクトのアーカイブをダウンロードします。 + +7. オプション: 新しい言語を生成するために[プロジェクトを更新します](project_overview_page.html#update_language)。 + + +## {{site.data.keyword.dev_cli_notm}} を使用したプロジェクトの作成 +{: #create-cli} + +1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html) がインストールされていることを確認します。 + +2. 端末のプロンプトで、使用するローカル・ディレクトリーにナビゲートし、以下のコマンドを実行します。 + + ``` + bx dev create + ``` + {: codeblock} + +3. プロンプトが出されたら、以下の値を入力します。 + + * パターンの選択: 2 (モバイル) + * スターターの選択: 1 (ベーシック) + * プラットフォームの選択: 3 (iOS Swift) + * プロジェクト名の入力: `MobileBasicProjectCLI` + +4. プロジェクトにサービスを追加する場合は、該当の質問のプロンプトで `y` を入力し、残りの質問に答えます。 + +5. `MobileBasicProjectCLI` が正常に保存されたら、`MobileBasicProjectCLI/MobileBasicProjectCLI-Swift` フォルダーにナビゲートします。 + + +## Xcode での Swift プロジェクトの実行 +{: #run_swift} + +1. `MobileBasicProject-Swift.zip` ファイルを解凍します。 + +2. Markdown ビューアーで `README.md` ファイルを開き、プロジェクトを構成する手順を確認します。 + + 1. ターミナルを開き、プロジェクト・フォルダーに移動します。 + + 1. CocoaPods リポジトリーをセットアップする必要がある場合は、`pod setup` を実行します。 + + 2. 既存の Pods を更新する必要がある場合は、`pod update` を実行します。 + + 3. プロジェクトに必要な Pods をインストールするには、`pod install` を実行します。 + + 3. `BasicProject.xcworkspace` Xcode ワークスペースを開きます。 + +3. アプリを実行します。 + + +## Xcode での Cordova プロジェクトの実行 +{: #run_cordova_xcode} + +1. `MobileBasicProject-Cordova.zip` ファイルを解凍します。 + +2. Markdown ビューアーで `README.md` ファイルを開き、プロジェクトを構成します。 + + 1. Xcode で `platforms/ios` プロジェクトを開きます。 + +3. アプリを実行します。 + + +## Android Studio での Cordova プロジェクトの実行 +{: #run_cordova_studio} + +1. `BasicProject-Cordova.zip` ファイルを解凍します。 + +2. Markdown ビューアーで `README.md` ファイルを開き、プロジェクトを構成します。 + + 1. Android Studio で `platforms/android` プロジェクトを開きます。 + +3. アプリを実行します。 + + +## Android Studio での Android プロジェクトの実行 +{: #run_android} + +1. `MobileBasicProject-Android.zip` ファイルを解凍します。 + +2. Markdown ビューアーで `README.md` ファイルを開き、プロジェクトを構成します。 + + 1. Android Studio で `BasicProject-Android` プロジェクトを開きます。 + +3. アプリを実行します。 diff --git a/cloudnative/nl/ja/tutorial_web.md b/cloudnative/nl/ja/tutorial_web.md index a1d5f63d2..d32c9ad44 100644 --- a/cloudnative/nl/ja/tutorial_web.md +++ b/cloudnative/nl/ja/tutorial_web.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Web ベーシック・スターターのエンドツーエンド・チュートリアル -{: #tutorial} - -以下のエンドツーエンド・チュートリアルでは、インストールしておく必要があるツールを含め、Web ベーシック・スターターからプロジェクトを作成するための手順を段階的に説明し、その後に、プロジェクト・コードの実行手順を説明します。 - -## 開発者ツールのインストール -{: #dev_tools} - -[前提条件の開発者ツール ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](get_code.html#prereq-dev-tools){: new_window} をインストール済みであることを確認します。 - - -## {{site.data.keyword.dev_console}} を使用したプロジェクトの作成 -{: #create-devex} - -1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} でプロジェクトを作成します。 - - 1. {{site.data.keyword.dev_console}} の**「開始」**ページで**「プロジェクトの作成」**をクリックします。 - - 代替方法として、**「プロジェクト」**ページから**「プロジェクトの作成」**をクリックすることもできます。 - - 2. **「Web アプリ (Web App)」**を選択し、**「次へ」**をクリックします。 - - 3. **「ベーシック Web (Basic Web)」**を選択し、**「次へ」**をクリックします。 - - 4. プロジェクト名を入力します。このチュートリアルでは、`WebBasicProject` を使用します。 - - 5. ホスト名を入力します。このチュートリアルでは、`devhost` を使用します。 - - 6. 言語プラットフォームを選択します。このチュートリアルでは、`Swift` を使用します。 - - 7. **「作成」**をクリックします。 - -2. オプション: Data (データ) 機能を追加します。 - - 1. **「プロジェクト概要 (Project Overview)」**ページで、**「Data (データ)」**に対して**「表示」**をクリックします。 - - 代替方法として、**「機能 (Capabilities)」>「Data (データ)」**ページで**「作成」**または**「既存の追加 (Add Existing)」**を選択することもできます。 - - 2. サービス名を入力し、**「作成」**をクリックします。 - - -3. プロジェクト・コードを生成します。 - - 1. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 - - 代替方法として、**「コード」**ページで以下をクリックすることもできます。 - - 2. **「コードの生成 (Generate Code)」**をクリックします。 - - 3. プロジェクト・コードの生成が完了したら、**「コードのダウンロード」**をクリックして、プロジェクトのアーカイブをダウンロードします。 - -4. オプション: 新しい言語を生成するために[プロジェクトを更新します](project_overview_page.html#update_language)。 - - -## {{site.data.keyword.dev_cli_notm}} を使用したプロジェクトの作成 -{: #create-cli} - -1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html) がインストールされていることを確認します。 - -2. 端末のプロンプトで、使用するローカル・ディレクトリーにナビゲートし、以下のコマンドを実行します。 - - ``` - bx dev create - ``` - {: codeblock} - - -3. プロンプトが出されたら、以下の値を入力します。 - - * パターンの選択: 1 (Web) - * スターターの選択: 1 (ベーシック Web) - * 言語の選択: 2 (Swift) - * プロジェクト名の入力: `WebBasicProjectCLI` - * プロジェクトのホスト名の入力: `myhost` - -4. プロジェクトにサービスを追加する場合は、該当の質問のプロンプトで `y` を入力し、残りの質問に答えます。 - -5. `WebBasicProjectCLI` プロジェクトが正常に保存されたら、`WebBasicProjectCLI` フォルダーにナビゲートします。 - -6. 独自コードの追加、プロジェクトのビルド、またはプロジェクトの実行を行います。 - - 1. 以下のコマンドを使用してプロジェクトをビルドします。 - - ``` - bx dev build - ``` - {: codeblock} - - 2. 以下のコマンドを使用してプロジェクトを実行します。 - - ``` - bx dev run - ``` - {: codeblock} - - -## Web プロジェクトの実行 -{: #run} - -### ローカルの場合 -{: #local notoc} - -1. ノードの依存関係をインストールします。 - - ``` - npm install - ``` - {: codeblock} - -2. フロントエンド・コードをモジュールにバンドルします。 - - ``` - node_modules/.bin/gulp - ``` - {: codeblock} - -3. サーバーをコンパイルします。 - - ``` - swift build - ``` - {: codeblock} - -4. アプリケーションを実行します。 - - ``` - .build/debug/WebBasicProjectCLI - ``` - {: codeblock} - -5. ブラウザーで `http://localhost:8080` を開きます。 - - -### {{site.data.keyword.dev_cli_short}} の使用 -{: #dev notoc} - -1. ノードの依存関係をインストールします。 - - ``` - npm install - ``` - {: codeblock} - -2. フロントエンド・コードをモジュールにバンドルします。 - - ``` - gulp - ``` - {: codeblock} - -3. コンパイルを実行します。 - - ``` - bx dev run - ``` - {: codeblock} - -4. ブラウザーで `http://localhost:8080` を開きます。 - - -## Xcode でのプロジェクトの実行 -{: #Xcode} - -1. Xcode プロジェクトを作成します。 - - Xcode で開発するには、その前に、Swift パッケージ・マネージャーを使用して Xcode プロジェクトをビルドする必要があります。 - - ``` - swift project generate-xcodeproj - ``` - {: codeblock} - -2. アクティブ・ターゲットを該当の実行可能ファイルに変更します。 - - 次に、Xcode でプロジェクトを開き、アクティブ・ターゲットが該当の実行可能ファイルであることを確認します。オプション・キーを押したままドロップダウン・メニューをクリックすることで、目的のアクティブ実行可能ファイルを選択できます。 - -3. **「実行 (run)」**を押します。 - -4. ブラウザーで `http://localhost:8080` を開きます。 - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Web ベーシック・スターターのエンドツーエンド・チュートリアル +{: #tutorial} + +以下のエンドツーエンド・チュートリアルでは、インストールしておく必要があるツールを含め、Web ベーシック・スターターからプロジェクトを作成するための手順を段階的に説明し、その後に、プロジェクト・コードの実行手順を説明します。 + +## 開発者ツールのインストール +{: #dev_tools} + +[前提条件の開発者ツール ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](get_code.html#prereq-dev-tools){: new_window} をインストール済みであることを確認します。 + + +## {{site.data.keyword.dev_console}} を使用したプロジェクトの作成 +{: #create-devex} + +1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} でプロジェクトを作成します。 + + 1. {{site.data.keyword.dev_console}} の**「開始」**ページで**「プロジェクトの作成」**をクリックします。 + + 代替方法として、**「プロジェクト」**ページから**「プロジェクトの作成」**をクリックすることもできます。 + + 2. **「Web アプリ (Web App)」**を選択し、**「次へ」**をクリックします。 + + 3. **「ベーシック Web (Basic Web)」**を選択し、**「次へ」**をクリックします。 + + 4. プロジェクト名を入力します。このチュートリアルでは、`WebBasicProject` を使用します。 + + 5. ホスト名を入力します。このチュートリアルでは、`devhost` を使用します。 + + 6. 言語プラットフォームを選択します。このチュートリアルでは、`Swift` を使用します。 + + 7. **「作成」**をクリックします。 + +2. オプション: Data (データ) 機能を追加します。 + + 1. **「プロジェクト概要 (Project Overview)」**ページで、**「Data (データ)」**に対して**「表示」**をクリックします。 + + 代替方法として、**「機能 (Capabilities)」>「Data (データ)」**ページで**「作成」**または**「既存の追加 (Add Existing)」**を選択することもできます。 + + 2. サービス名を入力し、**「作成」**をクリックします。 + + +3. プロジェクト・コードを生成します。 + + 1. **「プロジェクト概要 (Project Overview)」**ページで**「コードの取得 (Get the Code)」**をクリックして、言語を選択します。 + + 代替方法として、**「コード」**ページで以下をクリックすることもできます。 + + 2. **「コードの生成 (Generate Code)」**をクリックします。 + + 3. プロジェクト・コードの生成が完了したら、**「コードのダウンロード」**をクリックして、プロジェクトのアーカイブをダウンロードします。 + +4. オプション: 新しい言語を生成するために[プロジェクトを更新します](project_overview_page.html#update_language)。 + + +## {{site.data.keyword.dev_cli_notm}} を使用したプロジェクトの作成 +{: #create-cli} + +1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html) がインストールされていることを確認します。 + +2. 端末のプロンプトで、使用するローカル・ディレクトリーにナビゲートし、以下のコマンドを実行します。 + + ``` + bx dev create + ``` + {: codeblock} + + +3. プロンプトが出されたら、以下の値を入力します。 + + * パターンの選択: 1 (Web) + * スターターの選択: 1 (ベーシック Web) + * 言語の選択: 2 (Swift) + * プロジェクト名の入力: `WebBasicProjectCLI` + * プロジェクトのホスト名の入力: `myhost` + +4. プロジェクトにサービスを追加する場合は、該当の質問のプロンプトで `y` を入力し、残りの質問に答えます。 + +5. `WebBasicProjectCLI` プロジェクトが正常に保存されたら、`WebBasicProjectCLI` フォルダーにナビゲートします。 + +6. 独自コードの追加、プロジェクトのビルド、またはプロジェクトの実行を行います。 + + 1. 以下のコマンドを使用してプロジェクトをビルドします。 + + ``` + bx dev build + ``` + {: codeblock} + + 2. 以下のコマンドを使用してプロジェクトを実行します。 + + ``` + bx dev run + ``` + {: codeblock} + + +## Web プロジェクトの実行 +{: #run} + +### ローカルの場合 +{: #local notoc} + +1. ノードの依存関係をインストールします。 + + ``` + npm install + ``` + {: codeblock} + +2. フロントエンド・コードをモジュールにバンドルします。 + + ``` + node_modules/.bin/gulp + ``` + {: codeblock} + +3. サーバーをコンパイルします。 + + ``` + swift build + ``` + {: codeblock} + +4. アプリケーションを実行します。 + + ``` + .build/debug/WebBasicProjectCLI + ``` + {: codeblock} + +5. ブラウザーで `http://localhost:8080` を開きます。 + + +### {{site.data.keyword.dev_cli_short}} の使用 +{: #dev notoc} + +1. ノードの依存関係をインストールします。 + + ``` + npm install + ``` + {: codeblock} + +2. フロントエンド・コードをモジュールにバンドルします。 + + ``` + gulp + ``` + {: codeblock} + +3. コンパイルを実行します。 + + ``` + bx dev run + ``` + {: codeblock} + +4. ブラウザーで `http://localhost:8080` を開きます。 + + +## Xcode でのプロジェクトの実行 +{: #Xcode} + +1. Xcode プロジェクトを作成します。 + + Xcode で開発するには、その前に、Swift パッケージ・マネージャーを使用して Xcode プロジェクトをビルドする必要があります。 + + ``` + swift project generate-xcodeproj + ``` + {: codeblock} + +2. アクティブ・ターゲットを該当の実行可能ファイルに変更します。 + + 次に、Xcode でプロジェクトを開き、アクティブ・ターゲットが該当の実行可能ファイルであることを確認します。オプション・キーを押したままドロップダウン・メニューをクリックすることで、目的のアクティブ実行可能ファイルを選択できます。 + +3. **「実行 (run)」**を押します。 + +4. ブラウザーで `http://localhost:8080` を開きます。 + diff --git a/cloudnative/nl/ja/tutorials.md b/cloudnative/nl/ja/tutorials.md index f283f1994..fa3c289a2 100644 --- a/cloudnative/nl/ja/tutorials.md +++ b/cloudnative/nl/ja/tutorials.md @@ -1,49 +1,49 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# エンドツーエンド・チュートリアル -{: #tutorial} - -以下のエンドツーエンド・チュートリアルでは、インストールしておく必要があるツールを含め、{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} からプロジェクトを作成するための手順を段階的に説明し、その後に、プロジェクト・コードの実行手順を説明します。 - -## Web -{: #web notoc} - -* [Web ベーシックのチュートリアル](tutorial_web.html) - - -## モバイル -{: #mobile notoc} - -* [モバイル・ベーシックのチュートリアル](tutorial_mobile.html) - - - - -## BFF -{: #bff notoc} - -* [BFF ベーシックのチュートリアル](tutorial_bff.html) - - -## マイクロサービス -{: #microservice notoc} - -* [マイクロサービス・ベーシックのチュートリアル](tutorial_microservice.html) +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# エンドツーエンド・チュートリアル +{: #tutorial} + +以下のエンドツーエンド・チュートリアルでは、インストールしておく必要があるツールを含め、{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} からプロジェクトを作成するための手順を段階的に説明し、その後に、プロジェクト・コードの実行手順を説明します。 + +## Web +{: #web notoc} + +* [Web ベーシックのチュートリアル](tutorial_web.html) + + +## モバイル +{: #mobile notoc} + +* [モバイル・ベーシックのチュートリアル](tutorial_mobile.html) + + + + +## BFF +{: #bff notoc} + +* [BFF ベーシックのチュートリアル](tutorial_bff.html) + + +## マイクロサービス +{: #microservice notoc} + +* [マイクロサービス・ベーシックのチュートリアル](tutorial_microservice.html) diff --git a/cloudnative/nl/ja/what_is_new.md b/cloudnative/nl/ja/what_is_new.md index 0a62bbf0e..467687b8e 100644 --- a/cloudnative/nl/ja/what_is_new.md +++ b/cloudnative/nl/ja/what_is_new.md @@ -1,97 +1,97 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} の新機能 -{: #what-is-new} - - -## 最新情報: 2017 年 3 月 -{: #mar-2017} - -2017 年 3 月の {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} の更新で、以下の変更が導入されました。 - - * {{site.data.keyword.Bluemix_notm}} モバイル・ダッシュボードが {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} になりました。 - * プロジェクト作成の設計が変更され、Node.js、Java、および Swift のサポートとともに、Web アプリ、BFF、およびマイクロサービスのサーバー・パターン・タイプが組み込まれました。 - * 新規および改良された {{site.data.keyword.appid_full}} サービスとの統合により、モバイルおよび Web プロジェクトの認証が行われます。 - * [SDK Generator プラグイン](sdk_cli.html)を使用して、プロジェクトに SDK を追加で生成できるようになりました。{{site.data.keyword.dev_console}} での SDK の生成は、モバイル・プロジェクトにのみ可能です。 - * [{{site.data.keyword.dev_cli_short}}](dev_cli.html) を使用してプロジェクトを追加で作成できるようになりました。 - - -## 最新情報: 2017 年 1 月 -{: #jan-2017} - -2017 年 1 月の {{site.data.keyword.Bluemix_notm}} モバイル・ダッシュボードの更新で、以下の変更が導入されました。 - - * 1 月 31 日時点で、UI スターターは非推奨になりました。UI スターターから作成された既存のプロジェクトは、2017 年 4 月 30 日まで使用できます。マイグレーション・ステップと削除の日付について詳しくは、[非推奨の告知に関するブログ投稿![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/) を参照してください。 -{: deprecated} - * プロジェクトを削除して新しいプロジェクトを作成する代わりに、プロジェクト・スターター・タイプを更新できるようになりました。 - * [Watson Conversation](tutorial_conversation.html) コード・スターターを使用してプロジェクトを作成できるようになりました。 - * サポートされている場合、プロジェクトの SDK を生成できるようになりました。 - * 既存の[コンピュート](sdk_compute.html)・インスタンスを追加し、クライアント SDK を生成してプロジェクトに追加できるようになりました。 - - -## 最新情報: 2016 年 12 月 -{: #dec-2016} - -2016 年 12 月の {{site.data.keyword.Bluemix_notm}} モバイル・ダッシュボードの更新で、以下の変更が導入されました。 - - * 接続済みサービスをプロジェクトから削除できるようになりました。これにより、そのサービスを削除したり別のプロジェクトで再使用したりすることが可能になりました。 - * 既存のサービスをプロジェクトに追加できるようになりました。 - * コード・スターターを使用する時に、既存の Cloudant NoSQL サービスをデータ・ソースとして作成したり接続したりできるようになりました。 - * サポートされている場合、既存の Object Storage サービスをプロジェクトのデータ・ソースとして作成したり接続したりできるようになりました。 - * UI スターターを使用して作成しているアプリのナビゲーション設計をカスタマイズできるようになりました。 - - -## 最新情報: 2016 年 11 月 -{: #nov-2016} - -2016 年 11 月の {{site.data.keyword.Bluemix_notm}} モバイル・ダッシュボードの更新で、以下の変更が導入されました。 - - * **「コード」**ページからプロジェクトの SDK 成果物を生成できるようになりました。 - * ベーシック・コード・スターターで Cordova がサポートされるようになりました。 - * {{site.data.keyword.mobileanalytics_short}} コンソールの**「ネットワーク要求」**ページで[ネットワーク・イベントの報告 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} と[ネットワーク要求のモニター ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} を行えるようになりました。 - * {{site.data.keyword.mobileanalytics_short}} コンソールで[データを dashDB にエクスポート ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} できるようになりました。 - - -## 最新情報: 2016 年 10 月 -{: #oct-2016} - -2016 年 10 月の {{site.data.keyword.Bluemix_notm}} モバイル・ダッシュボードの更新で、以下の変更が導入されました。 - - * {{site.data.keyword.mobilepushshort}} 機能と Analytics 機能をダッシュボードから直接プロジェクトに追加できるようになりました。 - * [コード・スターター](starters.html#Code_Starter)が使用可能になりました。 - * コード・スターターから作成したプロジェクトに Authentication (認証) を追加できます。 - * Swift がサポートされるようになりました。 - - -### 分析 -{: #analytics notoc} - - * Analytics (分析) 機能を追加すると、デフォルトでデモ・モードが有効になります。デモ・モードをオフに切り替えることによって、アプリを実行した後に分析を表示できます。 - - -### UI ビルダー -{: #ui_builder notoc} - - * **{{site.data.keyword.mobilepushshort}}** 機能には、プロジェクトからアクセスするようになりました。 - * **「プロジェクト設定」**タブは**「設定」**タブに名前変更されました。 - * **「認証」**タブは**「ユーザー・アクセス (User Access)」**タブに名前変更されました。 - - -### コード -{: #code notoc} - - * iOS 向けの生成された Objective-C コードおよび Swift コードは、依存関係を管理するために CocoaPods を使用するようになりました。これは、CocoaPods をインストールする必要があることを意味します。インストールするには、`sudo gem install cocoapods` を実行します。CocoaPods がインストールされた後、`pod setup` を実行して構成します (まだ構成されていない場合)。最後に、`.xcworkspace` ファイルを Xcode で開く前に、`pod install` を実行して、必要なプロジェクト依存関係のダウンロードとインストールを行います。詳しい追加情報は、ダウンロードされたコード・アーカイブ内の `README.md` ファイルに入っています。詳しくは、[前提条件開発者ツール](get_code.html#prereq-dev-tools)をお読みください。 - -絶えず新しい更新を適用できるように、たびたび確認し直してください。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} の新機能 +{: #what-is-new} + + +## 最新情報: 2017 年 3 月 +{: #mar-2017} + +2017 年 3 月の {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} の更新で、以下の変更が導入されました。 + + * {{site.data.keyword.Bluemix_notm}} モバイル・ダッシュボードが {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} になりました。 + * プロジェクト作成の設計が変更され、Node.js、Java、および Swift のサポートとともに、Web アプリ、BFF、およびマイクロサービスのサーバー・パターン・タイプが組み込まれました。 + * 新規および改良された {{site.data.keyword.appid_full}} サービスとの統合により、モバイルおよび Web プロジェクトの認証が行われます。 + * [SDK Generator プラグイン](sdk_cli.html)を使用して、プロジェクトに SDK を追加で生成できるようになりました。{{site.data.keyword.dev_console}} での SDK の生成は、モバイル・プロジェクトにのみ可能です。 + * [{{site.data.keyword.dev_cli_short}}](dev_cli.html) を使用してプロジェクトを追加で作成できるようになりました。 + + +## 最新情報: 2017 年 1 月 +{: #jan-2017} + +2017 年 1 月の {{site.data.keyword.Bluemix_notm}} モバイル・ダッシュボードの更新で、以下の変更が導入されました。 + + * 1 月 31 日時点で、UI スターターは非推奨になりました。UI スターターから作成された既存のプロジェクトは、2017 年 4 月 30 日まで使用できます。マイグレーション・ステップと削除の日付について詳しくは、[非推奨の告知に関するブログ投稿![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/) を参照してください。 +{: deprecated} + * プロジェクトを削除して新しいプロジェクトを作成する代わりに、プロジェクト・スターター・タイプを更新できるようになりました。 + * [Watson Conversation](tutorial_conversation.html) コード・スターターを使用してプロジェクトを作成できるようになりました。 + * サポートされている場合、プロジェクトの SDK を生成できるようになりました。 + * 既存の[コンピュート](sdk_compute.html)・インスタンスを追加し、クライアント SDK を生成してプロジェクトに追加できるようになりました。 + + +## 最新情報: 2016 年 12 月 +{: #dec-2016} + +2016 年 12 月の {{site.data.keyword.Bluemix_notm}} モバイル・ダッシュボードの更新で、以下の変更が導入されました。 + + * 接続済みサービスをプロジェクトから削除できるようになりました。これにより、そのサービスを削除したり別のプロジェクトで再使用したりすることが可能になりました。 + * 既存のサービスをプロジェクトに追加できるようになりました。 + * コード・スターターを使用する時に、既存の Cloudant NoSQL サービスをデータ・ソースとして作成したり接続したりできるようになりました。 + * サポートされている場合、既存の Object Storage サービスをプロジェクトのデータ・ソースとして作成したり接続したりできるようになりました。 + * UI スターターを使用して作成しているアプリのナビゲーション設計をカスタマイズできるようになりました。 + + +## 最新情報: 2016 年 11 月 +{: #nov-2016} + +2016 年 11 月の {{site.data.keyword.Bluemix_notm}} モバイル・ダッシュボードの更新で、以下の変更が導入されました。 + + * **「コード」**ページからプロジェクトの SDK 成果物を生成できるようになりました。 + * ベーシック・コード・スターターで Cordova がサポートされるようになりました。 + * {{site.data.keyword.mobileanalytics_short}} コンソールの**「ネットワーク要求」**ページで[ネットワーク・イベントの報告 ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} と[ネットワーク要求のモニター ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} を行えるようになりました。 + * {{site.data.keyword.mobileanalytics_short}} コンソールで[データを dashDB にエクスポート ![外部リンク・アイコン](../icons/launch-glyph.svg "外部リンク・アイコン")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} できるようになりました。 + + +## 最新情報: 2016 年 10 月 +{: #oct-2016} + +2016 年 10 月の {{site.data.keyword.Bluemix_notm}} モバイル・ダッシュボードの更新で、以下の変更が導入されました。 + + * {{site.data.keyword.mobilepushshort}} 機能と Analytics 機能をダッシュボードから直接プロジェクトに追加できるようになりました。 + * [コード・スターター](starters.html#Code_Starter)が使用可能になりました。 + * コード・スターターから作成したプロジェクトに Authentication (認証) を追加できます。 + * Swift がサポートされるようになりました。 + + +### 分析 +{: #analytics notoc} + + * Analytics (分析) 機能を追加すると、デフォルトでデモ・モードが有効になります。デモ・モードをオフに切り替えることによって、アプリを実行した後に分析を表示できます。 + + +### UI ビルダー +{: #ui_builder notoc} + + * **{{site.data.keyword.mobilepushshort}}** 機能には、プロジェクトからアクセスするようになりました。 + * **「プロジェクト設定」**タブは**「設定」**タブに名前変更されました。 + * **「認証」**タブは**「ユーザー・アクセス (User Access)」**タブに名前変更されました。 + + +### コード +{: #code notoc} + + * iOS 向けの生成された Objective-C コードおよび Swift コードは、依存関係を管理するために CocoaPods を使用するようになりました。これは、CocoaPods をインストールする必要があることを意味します。インストールするには、`sudo gem install cocoapods` を実行します。CocoaPods がインストールされた後、`pod setup` を実行して構成します (まだ構成されていない場合)。最後に、`.xcworkspace` ファイルを Xcode で開く前に、`pod install` を実行して、必要なプロジェクト依存関係のダウンロードとインストールを行います。詳しい追加情報は、ダウンロードされたコード・アーカイブ内の `README.md` ファイルに入っています。詳しくは、[前提条件開発者ツール](get_code.html#prereq-dev-tools)をお読みください。 + +絶えず新しい更新を適用できるように、たびたび確認し直してください。 diff --git a/cloudnative/nl/ko/cli.md b/cloudnative/nl/ko/cli.md index d6740dcbd..84a336aef 100644 --- a/cloudnative/nl/ko/cli.md +++ b/cloudnative/nl/ko/cli.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.Bluemix_notm}} CLI용 플러그인 -{: #cli} - -다음 플러그인을 {{site.data.keyword.Bluemix}} CLI에 추가할 수 있습니다. 이러한 플러그인을 사용하여 {{site.data.keyword.dev_console}} 프로젝트를 작성할 수 있습니다. - -* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) -* [{{site.data.keyword.IBM_notm}} SDK Generator 플러그인](sdk_cli.html) +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.Bluemix_notm}} CLI용 플러그인 +{: #cli} + +다음 플러그인을 {{site.data.keyword.Bluemix}} CLI에 추가할 수 있습니다. 이러한 플러그인을 사용하여 {{site.data.keyword.dev_console}} 프로젝트를 작성할 수 있습니다. + +* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) +* [{{site.data.keyword.IBM_notm}} SDK Generator 플러그인](sdk_cli.html) diff --git a/cloudnative/nl/ko/compute.md b/cloudnative/nl/ko/compute.md index ea89d2413..6dce62682 100644 --- a/cloudnative/nl/ko/compute.md +++ b/cloudnative/nl/ko/compute.md @@ -1,181 +1,181 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 컴퓨팅 -{: #compute} - -모바일 및 웹에 대한 클라우드 네이티브 디지털 채널 애플리케이션을 빌드하는 경우, 디지털 채널 전용이거나 웹 및 모바일 클라이언트 앱 둘 다에 동일한 데이터 및 로직 통합 지원을 제공하는 BFF(Backend for Frontend)를 보유하는 것이 좋습니다. 이 아키텍처에 대한 자세한 정보는 [Microservices for web and mobile ![외부 링크 아이콘](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture)을 참조하십시오. - -다음 다이어그램은 BFF 아키텍처의 개요를 표시합니다. - -![BFF 아키텍처](images/bff-arch.png) - -그림 1: BFF 아키텍처 - -BFF의 개념은 마이크로서비스 또는 고가치 {{site.data.keyword.Bluemix}} 클라우드 서비스에서 공통 비즈니스 로직 및 통합 로직을 추출하는 것입니다. - -이 아키텍처를 사용하여 모바일 또는 웹 애플리케이션에 업데이트를 배치 및 릴리스하고 DevOps 서비스가 포함된 지속적 딜리버리 파이프라인을 사용하여 BFF의 새 버전을 배치할 수 있습니다. - -iOS에 대해 하나의 BFF가 있고 Android용으로 별도의 BFF가 있는 경우 이 앱에 대한 기능을 제공하는 엔지니어링 팀은 중앙 API 릴리스 스케줄에 의해 기능을 릴리스하도록 제한되지 않습니다. 이는 마이크로서비스 및 디지털 채널 아키텍처의 공통 목표입니다. 다른 팀의 릴리스 스케줄과 관계없이 팀에서 기능을 원하는 만큼 자유롭게 릴리스할 수 있습니다. - - - - -## 모바일 클라이언트를 BFF(Backend for Frontend)와 통합 -{: #integration} - -모바일 클라이언트와 BFF를 쉽게 통합할 수 있도록 {{site.data.keyword.Bluemix_notm}}는 Swift 및 Java 언어로 각각 iOS 및 Android용 모바일 클라이언트 SDK를 생성하도록 지원합니다. 이 기능을 사용하려면 Open API 스펙(Swagger) 문서를 사용하여 BFF 통합을 노출시켜야 합니다. 이 문서는 JSON 또는 YAML 양식일 수 있습니다. - -클라이언트 SDK 생성기는 Open API 정의 파일을 사용하여 네이티브 모바일 애플리케이션에서 이용하기 쉬운 클라이언트에 최적화된 개발자 SDK를 정의합니다. 이를 통해 BFF를 모바일 애플리케이션에 빠르게 통합할 수 있습니다. - - -## API 정의 -{: #definition} - -BFF는 라이브 서버 엔드포인트에서 실행 중인 Open API 스펙을 준수하는 API 정의 파일을 노출시켜야 합니다. 이 엔드포인트를 검색하는 데 {{site.data.keyword.Bluemix_notm}} 개발자 경험 및 {{site.data.keyword.Bluemix_notm}} SDK CLI(Command Line Interface)를 사용하려면, 환경 변수를 `OPENAPI_SPEC`이라는 Cloud Foundry 애플리케이션에 추가해야 합니다. 이 환경 변수는 상대 경로를 사용하여 스펙을 참조해야 합니다. - -{{site.data.keyword.Bluemix_notm}}에서 `OPENAPI_SPEC` 환경 변수를 추가하려면 다음 단계를 따르십시오. - -1. [{{site.data.keyword.Bluemix_notm}} ![외부 링크 아이콘](../icons/launch-glyph.svg)](http://bluemix.net)에 로그인하십시오. -2. Cloud Foundry 앱을 선택하십시오. -3. **런타임**을 선택하십시오. -4. **환경 변수**를 선택하십시오. -5. **사용자 정의** 섹션에서 **추가**를 클릭하십시오. -6. **NAME**에 대해 `OPENAPI_SPEC` 및 Open API 정의 파일에 대한 상대 URL 경로를 지정하십시오. -7. **저장**을 클릭하십시오. - - - -예를 들어, - -``` -OPENAPI_SPEC='/explorer/swagger.json' -``` -{: codeblock} - -{{site.data.keyword.apiconnect_long}} 및 Loopback 애플리케이션은 특히 이 접근 방식을 사용할 때 잘 작동합니다. Loopback 및 {{site.data.keyword.apiconnect_short}}를 사용하여 지속적 모델을 정의하고 Open API 정의 파일을 사용하는 CRUD(작성, 읽기, 업데이트 및 삭제) 오퍼레이션을 노출시킬 수 있습니다. - -또한 비즈니스 로직 오퍼레이션도 정의할 수 있습니다. - - -### Open API 스펙의 지원되는 요소 -{: #supported-elements notoc} - -Open API 스펙에서 완전히 지원되지 않는 유일한 부분은 파일 구조입니다. 스펙을 통해 정의의 부분이 서로 다른 파일로 분할되고 json `$ref` 필드를 사용하여 참조될 수 있습니다. 전체 정의는 한 파일 내에 포함되어야 합니다. - - -## Bluegen을 사용하는 예제 BFF(Backen for Frontend) -{: #bff-bluegen} - -{{site.data.keyword.Bluemix_notm}}는 {{site.data.keyword.apiconnect_short}} 및 Strongloop를 사용하여 참조 BFF를 작성했습니다. 이는 {{site.data.keyword.objectstorageshort}}의 이미지를 참조하도록 제품 모델을 {{site.data.keyword.cloudant}} 및 이미지 API에 맵핑합니다. - -이 BFF 패턴을 사용하여 완전히 작동하는 BFF를 {{site.data.keyword.Bluemix_notm}}에 신속하게 프로비저닝하기 시작할 수 있으며, 이를 통해 BFF를 모바일 프로젝트에 통합하고 iOS 및 Android용 네이티브 SDK를 각각 Swift 및 Java로 생성하는 것이 얼마나 쉬운지 이해할 수 있습니다. - -프로젝트 작성 및 설치에 대해서는 [README ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) 지시사항을 따르십시오. - - -## 개발자 경험 프로젝트에서 BFF(Backend for Frontend) 사용 -{: #bff-devex} - -{{site.data.keyword.Bluemix_notm}} 모바일 개발자 경험은 연관된 클라우드 서비스가 많은 모바일 프로젝트의 정의를 간소화하도록 디자인되었습니다. [{{site.data.keyword.mobilepushshort}} ![외부 링크 아이콘](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [분석 ![외부 링크 아이콘](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html) 및 데이터 또는 스토리지 서비스를 쉽게 추가할 수 있습니다. - -{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}은 **컴퓨팅** 페이지에서 모바일 프로젝트에 BFF를 통합하는 기능을 도입했습니다. 기존의 컴퓨팅 서비스 인스턴스를 모바일 프로젝트에 추가할 수 있습니다. 추가되고 나면 언어 선택사항에 대한 네이티브 SDK를 생성하거나 전체 프로젝트를 생성할 수 있으며 **코드** 페이지에서 프로젝트의 소스 패키지에 SDK가 통합됩니다. 이미 올바르게 정의된 BFF와 통합하는 경우에 특히 유용합니다. - -프로젝트를 다운로드한 후 Xcode 또는 Android Studio에서 프로젝트를 열 수 있으며 클라이언트 SDK를 사용하여 프로젝트를 컴파일할 수 있습니다. - - -## CLI 사용 -{: #cli} - -BFF를 개발함에 따라 API 스펙도 변경될 수 있습니다. 이러한 변경사항을 지원하기 위해 다음 두 가지 옵션이 있습니다. - -* 전체 프로젝트를 새로운 GitHub 분기에 재생성하고 변경사항을 개발 분기로 병합합니다. -* 명령행(CLI) 도구를 사용하여 SDK를 직접 재생성하고 모바일 프로젝트의 SDK 부분만 업데이트합니다. - -CLI를 사용하려면, CLI를 [설치](sdk_cli.html#installation)해야 합니다. - -수행할 수 있는 조치를 나열하려면 다음 명령을 사용하십시오. - -``` -bluemix sdk -``` -{: codeblock} - -현재 {{site.data.keyword.Bluemix_notm}} 영역에서 실행 중인 Cloud Foundry 인스턴스를 나열하려면 다음 명령을 사용하십시오. - -``` -bluemix sdk list -``` -{: codeblock} - -각 앱이 나열되고 `OPENAPI_SPEC` 환경 변수가 설정되어 있는 경우 API의 유효성이 검증됩니다. `VALID` 열에 초록색 확인 표시 또는 빨간색 `X`가 표시됩니다. 애플리케이션의 `VALID` 열에 있는 확인 표시는 올바른 Open API 정의가 있음을 의미합니다. 애플리케이션의 `VALID` 열에 있는 `X`는 다음 두 가지를 의미합니다. - -* `OPENAPI_SPEC` 환경 변수가 애플리케이션에 대해 정의되어 있지 않음 또는 -* API 정의가 Open API 스펙에 대해 올바르지 않음 - -API에 대한 완전한 URL을 보려면 다음 명령을 사용하십시오. API 스펙에 대한 완전한 라우트 및 URI가 나열됩니다. 브라우저에서 원시 스펙을 보고, CLI에서 직접 이용하거나 BFF `OPENAPI_SPEC` 환경 변수가 올바르게 설정되어 있는지 확인할 수 있습니다. - -``` -bluemix sdk list --url -``` -{: codeblock} - -SDK를 생성하는 데 사용될 수 있는지 판별하기 위해 ``의 Open API 정의 파일의 유효성을 검증하려면 다음 명령을 사용하십시오. 명령은 현재 영역에서 ``을 찾고 유효성 검증에 대한 스펙을 찾는 데 `OPENAPI_SPEC` 환경 변수의 상대 경로를 사용합니다. - -``` -bluemix sdk validate -``` -{: codeblock} - -선택한 네이티브 ``에 대한 SDK를 생성하고 압축 파일을 현재 작업 디렉토리에 배치하려면 다음 명령을 사용하십시오. - -``` -bluemix sdk generate -- -``` -{: codeblock} - -`--unzip` 옵션을 사용하면 자동으로 SDK가 현재 작업 디렉토리에 추출됩니다. 또는 `--output` 옵션을 사용하여 SDK를 추출할 위치를 선택적으로 지정할 수 있습니다. GitHub를 사용하여 소스 코드를 관리하고 특히 SDK 업데이트를 위한 새로운 분기를 작성할 수 있습니다. 이 접근 방식을 사용하면 변경사항을 쉽게 확인하고 업데이트된 SDK를 개발 분기에 병합할 수 있습니다. - - -## SDK 생성 모델 및 API 관련 작업 -{: #models-apis} - -이제 생성된 SDK를 사용하여 BFF가 모바일 앱에 통합되었으므로 이와 관련된 작업을 시작할 수 있습니다. - -SDK는 `docs` 디렉토리 및 `source` 디렉토리에서 완전히 생성된 문서를 제공됩니다. 문서의 웹 보기를 위해 `README.html` 파일을 열거나 문서의 Markdown 보기를 위해 `README.md` 파일을 열 수 있습니다. Markdown 문서는 SDK를 Cocoapods 또는 Maven Central에 공개하는 경우 유용합니다. - -문서 내에서 생성된 API의 목록을 확인할 수 있습니다. API를 클릭하여 모바일 앱에 직접 붙여넣을 수 있는 코드 스니펫을 볼 수 있습니다. +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 컴퓨팅 +{: #compute} + +모바일 및 웹에 대한 클라우드 네이티브 디지털 채널 애플리케이션을 빌드하는 경우, 디지털 채널 전용이거나 웹 및 모바일 클라이언트 앱 둘 다에 동일한 데이터 및 로직 통합 지원을 제공하는 BFF(Backend for Frontend)를 보유하는 것이 좋습니다. 이 아키텍처에 대한 자세한 정보는 [Microservices for web and mobile ![외부 링크 아이콘](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture)을 참조하십시오. + +다음 다이어그램은 BFF 아키텍처의 개요를 표시합니다. + +![BFF 아키텍처](images/bff-arch.png) + +그림 1: BFF 아키텍처 + +BFF의 개념은 마이크로서비스 또는 고가치 {{site.data.keyword.Bluemix}} 클라우드 서비스에서 공통 비즈니스 로직 및 통합 로직을 추출하는 것입니다. + +이 아키텍처를 사용하여 모바일 또는 웹 애플리케이션에 업데이트를 배치 및 릴리스하고 DevOps 서비스가 포함된 지속적 딜리버리 파이프라인을 사용하여 BFF의 새 버전을 배치할 수 있습니다. + +iOS에 대해 하나의 BFF가 있고 Android용으로 별도의 BFF가 있는 경우 이 앱에 대한 기능을 제공하는 엔지니어링 팀은 중앙 API 릴리스 스케줄에 의해 기능을 릴리스하도록 제한되지 않습니다. 이는 마이크로서비스 및 디지털 채널 아키텍처의 공통 목표입니다. 다른 팀의 릴리스 스케줄과 관계없이 팀에서 기능을 원하는 만큼 자유롭게 릴리스할 수 있습니다. + + + + +## 모바일 클라이언트를 BFF(Backend for Frontend)와 통합 +{: #integration} + +모바일 클라이언트와 BFF를 쉽게 통합할 수 있도록 {{site.data.keyword.Bluemix_notm}}는 Swift 및 Java 언어로 각각 iOS 및 Android용 모바일 클라이언트 SDK를 생성하도록 지원합니다. 이 기능을 사용하려면 Open API 스펙(Swagger) 문서를 사용하여 BFF 통합을 노출시켜야 합니다. 이 문서는 JSON 또는 YAML 양식일 수 있습니다. + +클라이언트 SDK 생성기는 Open API 정의 파일을 사용하여 네이티브 모바일 애플리케이션에서 이용하기 쉬운 클라이언트에 최적화된 개발자 SDK를 정의합니다. 이를 통해 BFF를 모바일 애플리케이션에 빠르게 통합할 수 있습니다. + + +## API 정의 +{: #definition} + +BFF는 라이브 서버 엔드포인트에서 실행 중인 Open API 스펙을 준수하는 API 정의 파일을 노출시켜야 합니다. 이 엔드포인트를 검색하는 데 {{site.data.keyword.Bluemix_notm}} 개발자 경험 및 {{site.data.keyword.Bluemix_notm}} SDK CLI(Command Line Interface)를 사용하려면, 환경 변수를 `OPENAPI_SPEC`이라는 Cloud Foundry 애플리케이션에 추가해야 합니다. 이 환경 변수는 상대 경로를 사용하여 스펙을 참조해야 합니다. + +{{site.data.keyword.Bluemix_notm}}에서 `OPENAPI_SPEC` 환경 변수를 추가하려면 다음 단계를 따르십시오. + +1. [{{site.data.keyword.Bluemix_notm}} ![외부 링크 아이콘](../icons/launch-glyph.svg)](http://bluemix.net)에 로그인하십시오. +2. Cloud Foundry 앱을 선택하십시오. +3. **런타임**을 선택하십시오. +4. **환경 변수**를 선택하십시오. +5. **사용자 정의** 섹션에서 **추가**를 클릭하십시오. +6. **NAME**에 대해 `OPENAPI_SPEC` 및 Open API 정의 파일에 대한 상대 URL 경로를 지정하십시오. +7. **저장**을 클릭하십시오. + + + +예를 들어, + +``` +OPENAPI_SPEC='/explorer/swagger.json' +``` +{: codeblock} + +{{site.data.keyword.apiconnect_long}} 및 Loopback 애플리케이션은 특히 이 접근 방식을 사용할 때 잘 작동합니다. Loopback 및 {{site.data.keyword.apiconnect_short}}를 사용하여 지속적 모델을 정의하고 Open API 정의 파일을 사용하는 CRUD(작성, 읽기, 업데이트 및 삭제) 오퍼레이션을 노출시킬 수 있습니다. + +또한 비즈니스 로직 오퍼레이션도 정의할 수 있습니다. + + +### Open API 스펙의 지원되는 요소 +{: #supported-elements notoc} + +Open API 스펙에서 완전히 지원되지 않는 유일한 부분은 파일 구조입니다. 스펙을 통해 정의의 부분이 서로 다른 파일로 분할되고 json `$ref` 필드를 사용하여 참조될 수 있습니다. 전체 정의는 한 파일 내에 포함되어야 합니다. + + +## Bluegen을 사용하는 예제 BFF(Backen for Frontend) +{: #bff-bluegen} + +{{site.data.keyword.Bluemix_notm}}는 {{site.data.keyword.apiconnect_short}} 및 Strongloop를 사용하여 참조 BFF를 작성했습니다. 이는 {{site.data.keyword.objectstorageshort}}의 이미지를 참조하도록 제품 모델을 {{site.data.keyword.cloudant}} 및 이미지 API에 맵핑합니다. + +이 BFF 패턴을 사용하여 완전히 작동하는 BFF를 {{site.data.keyword.Bluemix_notm}}에 신속하게 프로비저닝하기 시작할 수 있으며, 이를 통해 BFF를 모바일 프로젝트에 통합하고 iOS 및 Android용 네이티브 SDK를 각각 Swift 및 Java로 생성하는 것이 얼마나 쉬운지 이해할 수 있습니다. + +프로젝트 작성 및 설치에 대해서는 [README ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) 지시사항을 따르십시오. + + +## 개발자 경험 프로젝트에서 BFF(Backend for Frontend) 사용 +{: #bff-devex} + +{{site.data.keyword.Bluemix_notm}} 모바일 개발자 경험은 연관된 클라우드 서비스가 많은 모바일 프로젝트의 정의를 간소화하도록 디자인되었습니다. [{{site.data.keyword.mobilepushshort}} ![외부 링크 아이콘](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [분석 ![외부 링크 아이콘](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html) 및 데이터 또는 스토리지 서비스를 쉽게 추가할 수 있습니다. + +{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}은 **컴퓨팅** 페이지에서 모바일 프로젝트에 BFF를 통합하는 기능을 도입했습니다. 기존의 컴퓨팅 서비스 인스턴스를 모바일 프로젝트에 추가할 수 있습니다. 추가되고 나면 언어 선택사항에 대한 네이티브 SDK를 생성하거나 전체 프로젝트를 생성할 수 있으며 **코드** 페이지에서 프로젝트의 소스 패키지에 SDK가 통합됩니다. 이미 올바르게 정의된 BFF와 통합하는 경우에 특히 유용합니다. + +프로젝트를 다운로드한 후 Xcode 또는 Android Studio에서 프로젝트를 열 수 있으며 클라이언트 SDK를 사용하여 프로젝트를 컴파일할 수 있습니다. + + +## CLI 사용 +{: #cli} + +BFF를 개발함에 따라 API 스펙도 변경될 수 있습니다. 이러한 변경사항을 지원하기 위해 다음 두 가지 옵션이 있습니다. + +* 전체 프로젝트를 새로운 GitHub 분기에 재생성하고 변경사항을 개발 분기로 병합합니다. +* 명령행(CLI) 도구를 사용하여 SDK를 직접 재생성하고 모바일 프로젝트의 SDK 부분만 업데이트합니다. + +CLI를 사용하려면, CLI를 [설치](sdk_cli.html#installation)해야 합니다. + +수행할 수 있는 조치를 나열하려면 다음 명령을 사용하십시오. + +``` +bluemix sdk +``` +{: codeblock} + +현재 {{site.data.keyword.Bluemix_notm}} 영역에서 실행 중인 Cloud Foundry 인스턴스를 나열하려면 다음 명령을 사용하십시오. + +``` +bluemix sdk list +``` +{: codeblock} + +각 앱이 나열되고 `OPENAPI_SPEC` 환경 변수가 설정되어 있는 경우 API의 유효성이 검증됩니다. `VALID` 열에 초록색 확인 표시 또는 빨간색 `X`가 표시됩니다. 애플리케이션의 `VALID` 열에 있는 확인 표시는 올바른 Open API 정의가 있음을 의미합니다. 애플리케이션의 `VALID` 열에 있는 `X`는 다음 두 가지를 의미합니다. + +* `OPENAPI_SPEC` 환경 변수가 애플리케이션에 대해 정의되어 있지 않음 또는 +* API 정의가 Open API 스펙에 대해 올바르지 않음 + +API에 대한 완전한 URL을 보려면 다음 명령을 사용하십시오. API 스펙에 대한 완전한 라우트 및 URI가 나열됩니다. 브라우저에서 원시 스펙을 보고, CLI에서 직접 이용하거나 BFF `OPENAPI_SPEC` 환경 변수가 올바르게 설정되어 있는지 확인할 수 있습니다. + +``` +bluemix sdk list --url +``` +{: codeblock} + +SDK를 생성하는 데 사용될 수 있는지 판별하기 위해 ``의 Open API 정의 파일의 유효성을 검증하려면 다음 명령을 사용하십시오. 명령은 현재 영역에서 ``을 찾고 유효성 검증에 대한 스펙을 찾는 데 `OPENAPI_SPEC` 환경 변수의 상대 경로를 사용합니다. + +``` +bluemix sdk validate +``` +{: codeblock} + +선택한 네이티브 ``에 대한 SDK를 생성하고 압축 파일을 현재 작업 디렉토리에 배치하려면 다음 명령을 사용하십시오. + +``` +bluemix sdk generate -- +``` +{: codeblock} + +`--unzip` 옵션을 사용하면 자동으로 SDK가 현재 작업 디렉토리에 추출됩니다. 또는 `--output` 옵션을 사용하여 SDK를 추출할 위치를 선택적으로 지정할 수 있습니다. GitHub를 사용하여 소스 코드를 관리하고 특히 SDK 업데이트를 위한 새로운 분기를 작성할 수 있습니다. 이 접근 방식을 사용하면 변경사항을 쉽게 확인하고 업데이트된 SDK를 개발 분기에 병합할 수 있습니다. + + +## SDK 생성 모델 및 API 관련 작업 +{: #models-apis} + +이제 생성된 SDK를 사용하여 BFF가 모바일 앱에 통합되었으므로 이와 관련된 작업을 시작할 수 있습니다. + +SDK는 `docs` 디렉토리 및 `source` 디렉토리에서 완전히 생성된 문서를 제공됩니다. 문서의 웹 보기를 위해 `README.html` 파일을 열거나 문서의 Markdown 보기를 위해 `README.md` 파일을 열 수 있습니다. Markdown 문서는 SDK를 Cocoapods 또는 Maven Central에 공개하는 경우 유용합니다. + +문서 내에서 생성된 API의 목록을 확인할 수 있습니다. API를 클릭하여 모바일 앱에 직접 붙여넣을 수 있는 코드 스니펫을 볼 수 있습니다. diff --git a/cloudnative/nl/ko/dev_cli.md b/cloudnative/nl/ko/dev_cli.md index f757aa516..780336ef2 100644 --- a/cloudnative/nl/ko/dev_cli.md +++ b/cloudnative/nl/ko/dev_cli.md @@ -1,404 +1,404 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.dev_cli_short}} -{: #developercli} - -{{site.data.keyword.dev_cli_long}}은 `dev` 플러그인을 사용하여 웹 프로젝트를 작성하고 개발하고 배치할 수 있는 확장 가능한 명령 중심 접근법을 제공합니다. 이는 엔드-투-엔드 마이크로서비스 애플리케이션을 개발할 때 명령행 제어를 사용하고자 하는 개발자에게 적합합니다. - -{: shortdesc} - -{{site.data.keyword.dev_cli_notm}}은 애플리케이션 빌드 및 테스트를 위해 두 개의 컨테이너를 사용합니다. 첫 번째는 애플리케이션을 빌드하고 테스트하는 데 필요한 유틸리티를 포함하는 도구 컨테이너입니다. 이 컨테이너에 대한 Dockerfile은 [dockerfile-tools](#command-parameters) 매개변수에 의해 정의됩니다. 이는 일반적으로 특정 런타임의 개발에 유용한 도구를 포함하고 있으므로 개발 컨테이너라 생각할 수도 있습니다. - -두 번째 컨테이너는 실행 컨테이너입니다. 이 컨테이너는 {{site.data.keyword.Bluemix}} 등에서 사용할 수 있도록 배치하는 데 적합한 양식입니다. 따라서 이 컨테이너에는 일반적으로 애플리케이션을 시작하는 시작점이 정의됩니다. {{site.data.keyword.dev_cli_short}}을 통해 애플리케이션을 실행하도록 선택하면 이 플러그인은 이 컨테이너를 사용합니다. 이 컨테이너에 대한 Dockerfile은 [dockerfile-run](#run-parameters) 매개변수에 의해 정의됩니다. - - -## {{site.data.keyword.dev_cli_notm}} 추가 -{: #add-cli} - - -### 전제조건 -{: #prereq} - -{{site.data.keyword.dev_cli_short}}은 확장성이 높으며 추가 보완 기술을 이용할 수 있게 해 주므로, 이를 완전히 활용하고 적절하게 이용하려면 몇 가지 전제조건을 만족해야 합니다. - -1. [Cloud Foundry CLI ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/cloudfoundry/cli#getting-started)를 설치하십시오. - -2. [{{site.data.keyword.Bluemix}} CLI ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://clis.ng.bluemix.net/ui/home.html)를 설치하십시오. - -3. [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net) ID를 확보하십시오. - -4. 선택사항: 로컬에서 애플리케이션을 실행하고 디버그하려는 경우에는 [Docker ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.docker.com/get-docker) 또한 설치해야 합니다. 이는 비모바일 프로젝트의 경우에만 필수입니다. - - -### 설치 -{: #installation} - -1. 다음 명령을 실행하여 [{{site.data.keyword.dev_cli_short}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window}을 설치하십시오. - - ``` - bx plugin install dev -r Bluemix - ``` - {: codeblock} - -2. 다음 명령을 실행하여 설치가 완료되었는지 유효성 검증하십시오. - - ``` - bx dev - ``` - {: codeblock} - - -### 시작하기 전에 -{: #before-install} - -1. {{site.data.keyword.Bluemix_notm}}에 로그인하십시오. - - ``` - bx login - ``` - {: codeblock} - - **참고:** 신임 정보가 거부된 경우에는 연합 ID를 사용하고 있을 수 있습니다. 연합 ID를 사용하여 인증하려면 다음 단계를 따르십시오. - - - - 1. [{{site.data.keyword.iamshort}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.bluemix.net/iam/#/apikeys){: new_window}에 로그인하십시오. - 2. **API 키 작성**을 선택하십시오. - * apiKey 이름 및 설명을 입력하십시오. - 3. apiKey를 다운로드하십시오. - 4. 파일을 열고 `apiKey` 필드에서 값을 복사하십시오. - 5. 다음 명령을 사용하여 로그인하십시오. - - ``` - bx login --apikey - ``` - {: codeblock} - - -## 명령 -{: #commands} - -다음 명령을 사용하여 프로젝트를 작성하고, 배치하고, 디버그하고, 테스트하십시오. - -### build -{: #build} - -`build` 명령을 사용하여 애플리케이션을 빌드할 수 있습니다. 애플리케이션을 빌드하는 데 `build-cmd-run` 구성 요소가 사용됩니다. `test`, `debug` 및 `run` 명령은 정상 조작의 일환으로 이 명령과 동일한 방식의 빌드를 실행하므로 이러한 명령을 실행하기 전에 이 명령을 실행할 필요는 없습니다. - -애플리케이션을 빌드하려면 현재 프로젝트 디렉토리에서 다음 명령을 실행하십시오. - -``` -bx dev build -``` -{: codeblock} - - -[build 명령 매개변수](#command-parameters) - - -### code -{: #code} - -`code` 명령은 로컬에서 검토하거나 추가 변경을 수행할 수 있도록 애플리케이션 코드를 배치 후 다운로드할 수 있게 해 줍니다. - -지정된 프로젝트에서 코드를 다운로드하려면 다음 명령을 실행하십시오. - -``` -bx dev code -``` -{: codeblock} - - -### create -{: #create} - -언어, 프로젝트 이름 및 앱 패턴 유형을 포함한 모든 필수 정보에 대한 프롬프트를 표시하며 새 프로젝트를 작성합니다. 프로젝트는 현재 디렉토리에 작성됩니다. - -현재 프로젝트 디렉토리에 새 프로젝트를 작성하고 여기에 서비스를 연관시키려면 다음 명령을 실행하십시오. - -``` -bx dev create -``` -{: codeblock} - - -### debug -{: #debug} - -`debug` 명령을 통해 애플리케이션을 디버그할 수 있습니다. 먼저 `build-cmd-debug` 구성 요소를 빌드 지시사항으로 사용하여 프로젝트에 대한 빌드가 완료됩니다. 그 후 컨테이너가 시작되고 `container-port-map-debug`에 정의되어 있는 바와 같이 디버그 포트가 노출됩니다. 원하는 디버그 도구를 포트에 연결하면 여느 때와 같이 애플리케이션을 디버그할 수 있습니다. - -**제한사항**: 현재 Swift 프로젝트는 디버그할 수 없습니다. - -애플리케이션을 디버그하려면 현재 프로젝트 디렉토리에서 다음 명령을 실행하십시오. - -``` -bx dev debug -``` -{: codeblock} - -디버그 세션을 종료하려면 `CTRL-C`를 사용하십시오. - - -#### debug 명령 매개변수 -{: #debug-parameters} - -다음 매개변수는 `debug` 명령 전용이며 애플리케이션 디버깅에 도움을 줍니다. - -##### `container-port-map-debug` -{: #port-map-debug} - -* 디버그 포트의 포트 맵핑입니다. 첫 번째 값은 호스트 OS에서 사용할 포트이며 두 번째 값은 컨테이너의 포트입니다(호스트:컨테이너). -* 사용법: `bx dev debug container-port-map-debug [7777:7777]` - -##### `build-cmd-debug` -{: #build-cmd-debug} - -* DEBUG용 코드를 빌드하는 데 사용됩니다. -* 사용법: `bx dev debug build-cmd-debug build.command.sh` - -##### `debug-cmd` -{: #debug-cmd} - -* 도구 컨테이너 내의 코드를 디버그하는 데 사용됩니다. 이는 `build-cmd-debug`가 애플리케이션을 디버그 모드로 시작하는 경우 선택사항입니다. -* 사용법: `bx dev debug debug-cmd /the/debug/command` - -#### 로컬 애플리케이션 디버깅 -{: #local-app-dev} - -로컬 애플리케이션 디버깅에 대한 자세한 정보는 [로컬 애플리케이션 디버깅](docs/cloudnative/dev_cli_local_debug.html#local-debug)을 참조하십시오. - - -### delete -{: #delete} - -이 명령은 {{site.data.keyword.Bluemix}} 영역에서 프로젝트를 제거할 수 있게 해 줍니다. - -{{site.data.keyword.Bluemix}}에서 프로젝트를 삭제하려면 다음 명령을 실행하십시오. - -``` -bx dev delete -``` -{: codeblock} - - -**참고**: {{site.data.keyword.Bluemix}} 서비스는 제거되지 **않습니다**. - - -### help -{: #help} - -기본적으로 조치 또는 인수가 전달되지 않거나 'help' 조치가 제공된 경우 이 명령은 일반 "도움말" 텍스트를 표시합니다. 표시되는 일반 도움말에는 기본 인수와 사용 가능한 조치 목록이 포함됩니다. - -일반 도움말 정보를 표시하려면 다음 명령을 실행하십시오. - -``` -bx dev help -``` -{: codeblock} - - -### list -{: #list} - -영역의 모든 {{site.data.keyword.Bluemix_notm}} 프로젝트를 나열할 수 있습니다. - -프로젝트를 나열하려면 다음 명령을 실행하십시오. - -``` -bx dev list -``` -{: codeblock} - - - - - -### run -{: #run} - -`run` 명령을 통해 애플리케이션을 실행할 수 있습니다. 먼저 `build-cmd-run` 구성 요소를 빌드 지시사항으로 사용하여 프로젝트에 대한 빌드가 완료됩니다. 그 후 실행 컨테이너가 시작되며 `container-port-map`에 정의되어 있는 바와 같이 포트를 노출합니다. 실행 컨테이너에 이 단계를 완료하는 데 필요한 시작점이 포함되지 않은 경우에는 애플리케이션을 호출하기 위해 `run-cmd`를 사용할 수 있습니다. - -애플리케이션을 시작하려면 현재 프로젝트 디렉토리에서 다음 명령을 실행하십시오. - -``` -bx dev run -``` -{: codeblock} - -세션을 종료하려면 `CTRL-C`를 사용하십시오. - - -#### run 매개변수 -{: #run-parameters} - -다음 매개변수는 `run` 명령 전용이며 실행 컨테이너 내의 애플리케이션을 관리하는 데 도움을 줍니다. - -##### `container-name-run` -{: #container-name-run} - -* 실행 컨테이너의 컨테이너 이름입니다. -* 사용법: `bx dev run container-name-run ` - -##### `container-path-run` -{: #container-path-run} - -* 실행 시 공유할 컨테이너 내의 위치입니다. -* 사용법: `bx dev run container-path-run [/path/to/app]` - -##### `host-path-run` -{: #host-path-run} - -* 실행 시 컨테이너 내에서 공유할 호스트 시스템 내의 위치입니다. -* 사용법: `bx dev run host-path-run [/path/to/app/bin]` - -##### `dockerfile-run` -{: #dockerfile-run} - -* 실행 컨테이너에 대한 Docker 파일입니다. -* 사용법: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` - -##### `image-name-run` -{: #image-name-run} - -* dockerfile-run으로부터 작성할 이미지입니다. -* 사용법: `bx dev run image-name-run [/path/to/image-name]` - -##### `run-cmd` -{: #run-cmd} - -* 실행 컨테이너 내의 코드를 실행하는 데 사용되는 선택적 매개변수입니다. 이미지가 애플리케이션을 시작하는 경우에는 선택사항입니다. -* 사용법: `bx dev run run-cmd [/the/run/command]` - -### status -{: #status} - -`container-name-run` 및 `container-name-tools`로 정의된, {{site.data.keyword.dev_cli_short}}에서 사용하는 컨테이너의 상태를 조회할 수 있습니다. - -컨테이너 상태를 확인하려면 현재 프로젝트 디렉토리에서 다음 명령을 실행하십시오. - -``` -bx dev status -``` -{: codeblock} - - -[status 명령 매개변수](#command-parameters) - - -### stop -{: #stop} - -`stop` 명령을 통해 컨테이너를 중지할 수 있습니다. `container-name` 매개변수는 중지할 컨테이너를 지정할 수 있게 해 줍니다. 이 매개변수가 지정되지 않은 경우 stop 명령은 `container-name-run`으로 정의된 실행 컨테이너를 중지합니다. - -컨테이너를 중지하려면 현재 프로젝트 디렉토리에서 다음 명령을 실행하십시오. - -``` -bx dev stop -``` -{: codeblock} - - -#### 추가 stop 매개변수: -{: #stop-parameter} - -##### `container-name` -{: #container-name} - -* 도구 컨테이너의 컨테이너 이름입니다. -* 사용법: `bx dev stop container-name ` - -### test -{: #test} - -`test` 명령을 통해 애플리케이션을 테스트할 수 있습니다. 먼저 `build-cmd-run` 구성 요소를 빌드 지시사항으로 사용하여 프로젝트에 대한 빌드가 완료됩니다. 그 후 애플리케이션에 대해 `test-cmd`를 호출하기 위해 도구 컨테이너가 사용됩니다. - -애플리케이션을 테스트하려면 다음 명령을 실행하십시오. - -``` -bx dev test -``` -{: codeblock} - - -[test 명령 매개변수](#command-parameters) - - -## build, debug, run 및 test의 매개변수 -{: #command-parameters} - -다음 매개변수는 `build|debug|run|test` 명령과 함께 사용할 수 있으며 명령행을 통해 지정하거나 프로젝트의 `cli-config.yml` 파일을 직접 업데이트하여 지정할 수 있습니다. [`debug`](#debug-parameters) 및 [`run`](#run-parameters) 명령에는 추가 매개변수가 사용 가능하며 이는 해당 절에 기록되어 있습니다. - -**참고**: 명령행에 입력된 명령 매개변수는 `cli-config.yml` 구성보다 우선합니다. - -##### `container-name-tools` -{: #container-name-tools} - -* 도구 컨테이너의 컨테이너 이름입니다. -* 사용법: `bx dev container-name-tools []` - -##### `host-path-tools` -{: #host-path-tools} - -* build, debug, test에 대해 공유할 호스트 내의 위치입니다. -* 사용법: `bx dev host-path-tools [/path/to/build/tools]` - -##### `container-path-tools` -{: #container-path-tools} - -* build, debug, test에 대해 공유할 컨테이너 내의 위치입니다. -* 사용법: `bx dev container-path-tools [/path/for/build]` - -##### `container-port-map` -{: #container-port-map} - -* 컨테이너의 포트 맵핑입니다. 첫 번째 값은 호스트 OS에서 사용할 포트이며 두 번째 값은 컨테이너의 포트입니다(호스트:컨테이너). -* 사용법: `bx dev container-port-map [8090:8090,9090,9090]` - -##### `dockerfile-tools` -{: #dockerfile-tools} - -* 도구 컨테이너에 대한 Docker 파일입니다. -* 사용법: `bx dev dockerfile-tools [path/to/dockerfile]` - -##### `image-name-tools` -{: #image-name-tools} - -* dockerfile-tools로부터 작성할 이미지입니다. -* 사용법: `bx dev image-name-tools [path/to/image-name]` - -##### `build-cmd-run` -{: #build-cmd-run} - -* DEBUG 외의 모든 용도를 위한 코드를 빌드하는 명령입니다. -* 사용법: `bx dev build-cmd-run [some.build.command]` - -##### `test-cmd` -{: #test-cmd} - -* 도구 컨테이너 내의 코드를 테스트하는 명령입니다. -* 사용법: `bx dev test-cmd [/the/test/command]` - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.dev_cli_short}} +{: #developercli} + +{{site.data.keyword.dev_cli_long}}은 `dev` 플러그인을 사용하여 웹 프로젝트를 작성하고 개발하고 배치할 수 있는 확장 가능한 명령 중심 접근법을 제공합니다. 이는 엔드-투-엔드 마이크로서비스 애플리케이션을 개발할 때 명령행 제어를 사용하고자 하는 개발자에게 적합합니다. + +{: shortdesc} + +{{site.data.keyword.dev_cli_notm}}은 애플리케이션 빌드 및 테스트를 위해 두 개의 컨테이너를 사용합니다. 첫 번째는 애플리케이션을 빌드하고 테스트하는 데 필요한 유틸리티를 포함하는 도구 컨테이너입니다. 이 컨테이너에 대한 Dockerfile은 [dockerfile-tools](#command-parameters) 매개변수에 의해 정의됩니다. 이는 일반적으로 특정 런타임의 개발에 유용한 도구를 포함하고 있으므로 개발 컨테이너라 생각할 수도 있습니다. + +두 번째 컨테이너는 실행 컨테이너입니다. 이 컨테이너는 {{site.data.keyword.Bluemix}} 등에서 사용할 수 있도록 배치하는 데 적합한 양식입니다. 따라서 이 컨테이너에는 일반적으로 애플리케이션을 시작하는 시작점이 정의됩니다. {{site.data.keyword.dev_cli_short}}을 통해 애플리케이션을 실행하도록 선택하면 이 플러그인은 이 컨테이너를 사용합니다. 이 컨테이너에 대한 Dockerfile은 [dockerfile-run](#run-parameters) 매개변수에 의해 정의됩니다. + + +## {{site.data.keyword.dev_cli_notm}} 추가 +{: #add-cli} + + +### 전제조건 +{: #prereq} + +{{site.data.keyword.dev_cli_short}}은 확장성이 높으며 추가 보완 기술을 이용할 수 있게 해 주므로, 이를 완전히 활용하고 적절하게 이용하려면 몇 가지 전제조건을 만족해야 합니다. + +1. [Cloud Foundry CLI ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/cloudfoundry/cli#getting-started)를 설치하십시오. + +2. [{{site.data.keyword.Bluemix}} CLI ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://clis.ng.bluemix.net/ui/home.html)를 설치하십시오. + +3. [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net) ID를 확보하십시오. + +4. 선택사항: 로컬에서 애플리케이션을 실행하고 디버그하려는 경우에는 [Docker ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.docker.com/get-docker) 또한 설치해야 합니다. 이는 비모바일 프로젝트의 경우에만 필수입니다. + + +### 설치 +{: #installation} + +1. 다음 명령을 실행하여 [{{site.data.keyword.dev_cli_short}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window}을 설치하십시오. + + ``` + bx plugin install dev -r Bluemix + ``` + {: codeblock} + +2. 다음 명령을 실행하여 설치가 완료되었는지 유효성 검증하십시오. + + ``` + bx dev + ``` + {: codeblock} + + +### 시작하기 전에 +{: #before-install} + +1. {{site.data.keyword.Bluemix_notm}}에 로그인하십시오. + + ``` + bx login + ``` + {: codeblock} + + **참고:** 신임 정보가 거부된 경우에는 연합 ID를 사용하고 있을 수 있습니다. 연합 ID를 사용하여 인증하려면 다음 단계를 따르십시오. + + + + 1. [{{site.data.keyword.iamshort}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.bluemix.net/iam/#/apikeys){: new_window}에 로그인하십시오. + 2. **API 키 작성**을 선택하십시오. + * apiKey 이름 및 설명을 입력하십시오. + 3. apiKey를 다운로드하십시오. + 4. 파일을 열고 `apiKey` 필드에서 값을 복사하십시오. + 5. 다음 명령을 사용하여 로그인하십시오. + + ``` + bx login --apikey + ``` + {: codeblock} + + +## 명령 +{: #commands} + +다음 명령을 사용하여 프로젝트를 작성하고, 배치하고, 디버그하고, 테스트하십시오. + +### build +{: #build} + +`build` 명령을 사용하여 애플리케이션을 빌드할 수 있습니다. 애플리케이션을 빌드하는 데 `build-cmd-run` 구성 요소가 사용됩니다. `test`, `debug` 및 `run` 명령은 정상 조작의 일환으로 이 명령과 동일한 방식의 빌드를 실행하므로 이러한 명령을 실행하기 전에 이 명령을 실행할 필요는 없습니다. + +애플리케이션을 빌드하려면 현재 프로젝트 디렉토리에서 다음 명령을 실행하십시오. + +``` +bx dev build +``` +{: codeblock} + + +[build 명령 매개변수](#command-parameters) + + +### code +{: #code} + +`code` 명령은 로컬에서 검토하거나 추가 변경을 수행할 수 있도록 애플리케이션 코드를 배치 후 다운로드할 수 있게 해 줍니다. + +지정된 프로젝트에서 코드를 다운로드하려면 다음 명령을 실행하십시오. + +``` +bx dev code +``` +{: codeblock} + + +### create +{: #create} + +언어, 프로젝트 이름 및 앱 패턴 유형을 포함한 모든 필수 정보에 대한 프롬프트를 표시하며 새 프로젝트를 작성합니다. 프로젝트는 현재 디렉토리에 작성됩니다. + +현재 프로젝트 디렉토리에 새 프로젝트를 작성하고 여기에 서비스를 연관시키려면 다음 명령을 실행하십시오. + +``` +bx dev create +``` +{: codeblock} + + +### debug +{: #debug} + +`debug` 명령을 통해 애플리케이션을 디버그할 수 있습니다. 먼저 `build-cmd-debug` 구성 요소를 빌드 지시사항으로 사용하여 프로젝트에 대한 빌드가 완료됩니다. 그 후 컨테이너가 시작되고 `container-port-map-debug`에 정의되어 있는 바와 같이 디버그 포트가 노출됩니다. 원하는 디버그 도구를 포트에 연결하면 여느 때와 같이 애플리케이션을 디버그할 수 있습니다. + +**제한사항**: 현재 Swift 프로젝트는 디버그할 수 없습니다. + +애플리케이션을 디버그하려면 현재 프로젝트 디렉토리에서 다음 명령을 실행하십시오. + +``` +bx dev debug +``` +{: codeblock} + +디버그 세션을 종료하려면 `CTRL-C`를 사용하십시오. + + +#### debug 명령 매개변수 +{: #debug-parameters} + +다음 매개변수는 `debug` 명령 전용이며 애플리케이션 디버깅에 도움을 줍니다. + +##### `container-port-map-debug` +{: #port-map-debug} + +* 디버그 포트의 포트 맵핑입니다. 첫 번째 값은 호스트 OS에서 사용할 포트이며 두 번째 값은 컨테이너의 포트입니다(호스트:컨테이너). +* 사용법: `bx dev debug container-port-map-debug [7777:7777]` + +##### `build-cmd-debug` +{: #build-cmd-debug} + +* DEBUG용 코드를 빌드하는 데 사용됩니다. +* 사용법: `bx dev debug build-cmd-debug build.command.sh` + +##### `debug-cmd` +{: #debug-cmd} + +* 도구 컨테이너 내의 코드를 디버그하는 데 사용됩니다. 이는 `build-cmd-debug`가 애플리케이션을 디버그 모드로 시작하는 경우 선택사항입니다. +* 사용법: `bx dev debug debug-cmd /the/debug/command` + +#### 로컬 애플리케이션 디버깅 +{: #local-app-dev} + +로컬 애플리케이션 디버깅에 대한 자세한 정보는 [로컬 애플리케이션 디버깅](docs/cloudnative/dev_cli_local_debug.html#local-debug)을 참조하십시오. + + +### delete +{: #delete} + +이 명령은 {{site.data.keyword.Bluemix}} 영역에서 프로젝트를 제거할 수 있게 해 줍니다. + +{{site.data.keyword.Bluemix}}에서 프로젝트를 삭제하려면 다음 명령을 실행하십시오. + +``` +bx dev delete +``` +{: codeblock} + + +**참고**: {{site.data.keyword.Bluemix}} 서비스는 제거되지 **않습니다**. + + +### help +{: #help} + +기본적으로 조치 또는 인수가 전달되지 않거나 'help' 조치가 제공된 경우 이 명령은 일반 "도움말" 텍스트를 표시합니다. 표시되는 일반 도움말에는 기본 인수와 사용 가능한 조치 목록이 포함됩니다. + +일반 도움말 정보를 표시하려면 다음 명령을 실행하십시오. + +``` +bx dev help +``` +{: codeblock} + + +### list +{: #list} + +영역의 모든 {{site.data.keyword.Bluemix_notm}} 프로젝트를 나열할 수 있습니다. + +프로젝트를 나열하려면 다음 명령을 실행하십시오. + +``` +bx dev list +``` +{: codeblock} + + + + + +### run +{: #run} + +`run` 명령을 통해 애플리케이션을 실행할 수 있습니다. 먼저 `build-cmd-run` 구성 요소를 빌드 지시사항으로 사용하여 프로젝트에 대한 빌드가 완료됩니다. 그 후 실행 컨테이너가 시작되며 `container-port-map`에 정의되어 있는 바와 같이 포트를 노출합니다. 실행 컨테이너에 이 단계를 완료하는 데 필요한 시작점이 포함되지 않은 경우에는 애플리케이션을 호출하기 위해 `run-cmd`를 사용할 수 있습니다. + +애플리케이션을 시작하려면 현재 프로젝트 디렉토리에서 다음 명령을 실행하십시오. + +``` +bx dev run +``` +{: codeblock} + +세션을 종료하려면 `CTRL-C`를 사용하십시오. + + +#### run 매개변수 +{: #run-parameters} + +다음 매개변수는 `run` 명령 전용이며 실행 컨테이너 내의 애플리케이션을 관리하는 데 도움을 줍니다. + +##### `container-name-run` +{: #container-name-run} + +* 실행 컨테이너의 컨테이너 이름입니다. +* 사용법: `bx dev run container-name-run ` + +##### `container-path-run` +{: #container-path-run} + +* 실행 시 공유할 컨테이너 내의 위치입니다. +* 사용법: `bx dev run container-path-run [/path/to/app]` + +##### `host-path-run` +{: #host-path-run} + +* 실행 시 컨테이너 내에서 공유할 호스트 시스템 내의 위치입니다. +* 사용법: `bx dev run host-path-run [/path/to/app/bin]` + +##### `dockerfile-run` +{: #dockerfile-run} + +* 실행 컨테이너에 대한 Docker 파일입니다. +* 사용법: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` + +##### `image-name-run` +{: #image-name-run} + +* dockerfile-run으로부터 작성할 이미지입니다. +* 사용법: `bx dev run image-name-run [/path/to/image-name]` + +##### `run-cmd` +{: #run-cmd} + +* 실행 컨테이너 내의 코드를 실행하는 데 사용되는 선택적 매개변수입니다. 이미지가 애플리케이션을 시작하는 경우에는 선택사항입니다. +* 사용법: `bx dev run run-cmd [/the/run/command]` + +### status +{: #status} + +`container-name-run` 및 `container-name-tools`로 정의된, {{site.data.keyword.dev_cli_short}}에서 사용하는 컨테이너의 상태를 조회할 수 있습니다. + +컨테이너 상태를 확인하려면 현재 프로젝트 디렉토리에서 다음 명령을 실행하십시오. + +``` +bx dev status +``` +{: codeblock} + + +[status 명령 매개변수](#command-parameters) + + +### stop +{: #stop} + +`stop` 명령을 통해 컨테이너를 중지할 수 있습니다. `container-name` 매개변수는 중지할 컨테이너를 지정할 수 있게 해 줍니다. 이 매개변수가 지정되지 않은 경우 stop 명령은 `container-name-run`으로 정의된 실행 컨테이너를 중지합니다. + +컨테이너를 중지하려면 현재 프로젝트 디렉토리에서 다음 명령을 실행하십시오. + +``` +bx dev stop +``` +{: codeblock} + + +#### 추가 stop 매개변수: +{: #stop-parameter} + +##### `container-name` +{: #container-name} + +* 도구 컨테이너의 컨테이너 이름입니다. +* 사용법: `bx dev stop container-name ` + +### test +{: #test} + +`test` 명령을 통해 애플리케이션을 테스트할 수 있습니다. 먼저 `build-cmd-run` 구성 요소를 빌드 지시사항으로 사용하여 프로젝트에 대한 빌드가 완료됩니다. 그 후 애플리케이션에 대해 `test-cmd`를 호출하기 위해 도구 컨테이너가 사용됩니다. + +애플리케이션을 테스트하려면 다음 명령을 실행하십시오. + +``` +bx dev test +``` +{: codeblock} + + +[test 명령 매개변수](#command-parameters) + + +## build, debug, run 및 test의 매개변수 +{: #command-parameters} + +다음 매개변수는 `build|debug|run|test` 명령과 함께 사용할 수 있으며 명령행을 통해 지정하거나 프로젝트의 `cli-config.yml` 파일을 직접 업데이트하여 지정할 수 있습니다. [`debug`](#debug-parameters) 및 [`run`](#run-parameters) 명령에는 추가 매개변수가 사용 가능하며 이는 해당 절에 기록되어 있습니다. + +**참고**: 명령행에 입력된 명령 매개변수는 `cli-config.yml` 구성보다 우선합니다. + +##### `container-name-tools` +{: #container-name-tools} + +* 도구 컨테이너의 컨테이너 이름입니다. +* 사용법: `bx dev container-name-tools []` + +##### `host-path-tools` +{: #host-path-tools} + +* build, debug, test에 대해 공유할 호스트 내의 위치입니다. +* 사용법: `bx dev host-path-tools [/path/to/build/tools]` + +##### `container-path-tools` +{: #container-path-tools} + +* build, debug, test에 대해 공유할 컨테이너 내의 위치입니다. +* 사용법: `bx dev container-path-tools [/path/for/build]` + +##### `container-port-map` +{: #container-port-map} + +* 컨테이너의 포트 맵핑입니다. 첫 번째 값은 호스트 OS에서 사용할 포트이며 두 번째 값은 컨테이너의 포트입니다(호스트:컨테이너). +* 사용법: `bx dev container-port-map [8090:8090,9090,9090]` + +##### `dockerfile-tools` +{: #dockerfile-tools} + +* 도구 컨테이너에 대한 Docker 파일입니다. +* 사용법: `bx dev dockerfile-tools [path/to/dockerfile]` + +##### `image-name-tools` +{: #image-name-tools} + +* dockerfile-tools로부터 작성할 이미지입니다. +* 사용법: `bx dev image-name-tools [path/to/image-name]` + +##### `build-cmd-run` +{: #build-cmd-run} + +* DEBUG 외의 모든 용도를 위한 코드를 빌드하는 명령입니다. +* 사용법: `bx dev build-cmd-run [some.build.command]` + +##### `test-cmd` +{: #test-cmd} + +* 도구 컨테이너 내의 코드를 테스트하는 명령입니다. +* 사용법: `bx dev test-cmd [/the/test/command]` + diff --git a/cloudnative/nl/ko/dev_cli_local_debug.md b/cloudnative/nl/ko/dev_cli_local_debug.md index 353165243..78f4335f7 100644 --- a/cloudnative/nl/ko/dev_cli_local_debug.md +++ b/cloudnative/nl/ko/dev_cli_local_debug.md @@ -1,76 +1,76 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 로컬 애플리케이션 디버깅 -{: #local-debug} - -다음 언어에 대한 로컬 애플리케이션 디버깅 지시사항을 아래에서 제공합니다. - -* [Java](#java) -* [Node.js](#node) - -**참고**: Swift 애플리케이션 디버깅은 현재 지원되지 않습니다. - -## Java 애플리케이션 디버깅 -{: #java} - -Java 애플리케이션 디버깅을 사용하기 위한 단계: - -1. 애플리케이션 프로젝트의 루트 디렉토리에서 다음 명령을 실행하십시오. - - `bx dev debug` - -2. 디버거를 애플리케이션에 연결하십시오. - - * [Eclipse ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) - * [IntelliJ ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) - * [VSCode ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) - * JDK 명령행: `jdb -attach ` - -## Node.js 애플리케이션 디버깅 - -{: #node} - -Node.js 애플리케이션 디버깅을 사용하기 위한 단계: - -1. 애플리케이션 프로젝트의 루트 디렉토리에서 다음 명령을 실행하십시오. - - `bx dev debug` - -2. 디버거를 애플리케이션에 연결하십시오. - * [VSCode ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://blog.docker.com/2016/07/live-debugging-docker/) - * [WebStorm ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 로컬 애플리케이션 디버깅 +{: #local-debug} + +다음 언어에 대한 로컬 애플리케이션 디버깅 지시사항을 아래에서 제공합니다. + +* [Java](#java) +* [Node.js](#node) + +**참고**: Swift 애플리케이션 디버깅은 현재 지원되지 않습니다. + +## Java 애플리케이션 디버깅 +{: #java} + +Java 애플리케이션 디버깅을 사용하기 위한 단계: + +1. 애플리케이션 프로젝트의 루트 디렉토리에서 다음 명령을 실행하십시오. + + `bx dev debug` + +2. 디버거를 애플리케이션에 연결하십시오. + + * [Eclipse ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) + * [IntelliJ ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) + * [VSCode ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) + * JDK 명령행: `jdb -attach ` + +## Node.js 애플리케이션 디버깅 + +{: #node} + +Node.js 애플리케이션 디버깅을 사용하기 위한 단계: + +1. 애플리케이션 프로젝트의 루트 디렉토리에서 다음 명령을 실행하십시오. + + `bx dev debug` + +2. 디버거를 애플리케이션에 연결하십시오. + * [VSCode ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://blog.docker.com/2016/07/live-debugging-docker/) + * [WebStorm ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) + + + + + diff --git a/cloudnative/nl/ko/devex.md b/cloudnative/nl/ko/devex.md index 70b8f23fe..8af7c5248 100644 --- a/cloudnative/nl/ko/devex.md +++ b/cloudnative/nl/ko/devex.md @@ -1,31 +1,31 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.dev_console}} -{: #devex} - -[{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.{DomainName}/developer/getting-started)을 시작하려면 {{site.data.keyword.Bluemix_notm}} 콘솔에서 **웹 및 모바일** 카테고리를 클릭하십시오. - - -## 시작하기 -{: getting-started} - -**프로젝트 작성**을 클릭하여 **시작하기** 페이지에서 프로젝트를 작성하십시오. 앱을 빠르게 작성할 수 있게 해 주는 [패턴](patterns.html), [스타터](starters.html) 및 [언어](patterns.html#languages) 옵션이 제공됩니다. - -[프로젝트 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.{DomainName}/developer/projects) 페이지를 선택하여 한 곳에서 모든 프로젝트를 보고 관리할 수 있습니다. 프로젝트는 앱과 통합된 기능 및 통합 가능한 기능에 대한 정보를 포함합니다. 푸시, 분석, 인증 및 데이터 서비스가 사용 가능한 경우 이를 손쉽게 프로젝트에 통합하고 관리할 수 있으며, 곧 더 많은 기능이 추가될 예정입니다. - -[서비스](services.html) 페이지는 기존 서비스 인스턴스의 운영 뷰를 표시합니다. {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}은 클라우드 네이티브 개발자 및 클라우드 네이티브 앱 관리 사용자를 지원합니다. - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.dev_console}} +{: #devex} + +[{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.{DomainName}/developer/getting-started)을 시작하려면 {{site.data.keyword.Bluemix_notm}} 콘솔에서 **웹 및 모바일** 카테고리를 클릭하십시오. + + +## 시작하기 +{: getting-started} + +**프로젝트 작성**을 클릭하여 **시작하기** 페이지에서 프로젝트를 작성하십시오. 앱을 빠르게 작성할 수 있게 해 주는 [패턴](patterns.html), [스타터](starters.html) 및 [언어](patterns.html#languages) 옵션이 제공됩니다. + +[프로젝트 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.{DomainName}/developer/projects) 페이지를 선택하여 한 곳에서 모든 프로젝트를 보고 관리할 수 있습니다. 프로젝트는 앱과 통합된 기능 및 통합 가능한 기능에 대한 정보를 포함합니다. 푸시, 분석, 인증 및 데이터 서비스가 사용 가능한 경우 이를 손쉽게 프로젝트에 통합하고 관리할 수 있으며, 곧 더 많은 기능이 추가될 예정입니다. + +[서비스](services.html) 페이지는 기존 서비스 인스턴스의 운영 뷰를 표시합니다. {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}은 클라우드 네이티브 개발자 및 클라우드 네이티브 앱 관리 사용자를 지원합니다. + + + diff --git a/cloudnative/nl/ko/get_code.md b/cloudnative/nl/ko/get_code.md index fc82fc2b1..47883a2ce 100644 --- a/cloudnative/nl/ko/get_code.md +++ b/cloudnative/nl/ko/get_code.md @@ -1,80 +1,80 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-18" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# 코드 가져오기 -{: #Get_Code} - -선택한 기능을 사용하여 프로젝트의 구성 및 설정을 완료하면 코드를 다운로드하여 실행할 수 있습니다. 다운로드한 프로젝트는 사용자가 구성한 각 기능의 신임 정보와 필수 SDK 종속 항목을 사용하여 사전 구성됩니다. - -다운로드한 프로젝트에서 구성할 수 없는 서비스의 신임 정보를 완료해야 합니다. 스타터 프로젝트의 `README.md` 파일에 지시사항이 포함되어 있습니다. Markdown 뷰어에서 `README.md` 파일을 보고 설정을 완료하십시오. - -## 전제조건 개발자 도구 -{: #prereq-dev-tools} - -{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}에서 생성된 코드에 대한 작업을 수행할 경우 다음 개발자 도구가 필요합니다. - - -### 일반 -{: #general notoc} - -* [Homebrew ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://brew.sh/) - * Apple 개발자가 기타 도구와 런타임(예: CocoaPods, Carthage)을 설치할 수 있도록 지원하는 명령행 도구입니다. - -* [Docker ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.docker.com/get-docker) - * 컨테이너 내 애플리케이션의 실행 및 디버깅을 지원하는 오픈 소스 프로젝트입니다. 비모바일 프로젝트의 경우에만 필수입니다. - -### {{site.data.keyword.Bluemix_notm}} -{: #bluemix notoc} - -* {{site.data.keyword.apiconnect_short}} Loopback 및 기타 {{site.data.keyword.Bluemix_notm}} Productivity 도구 실행을 지원하는 Node.js(Node 및 npm 런타임). - - {{site.data.keyword.apiconnect_short}} 도구를 로컬로 실행하려면 Node 5.x를 사용하십시오. - - ``` - $ brew install Node5 - ``` - -* [Bluemix CLI 도구 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://clis.ng.bluemix.net/ui/home.html) - - {{site.data.keyword.Bluemix_notm}}에 대한 명령행 인터페이스에서 Cloud Foundry 런타임을 배치하는 데 필요한 명령행 도구입니다. - -* [{{site.data.keyword.dev_cli_notm}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](dev_cli.html) - - 웹 및 모바일 프로젝트를 작성하고, 실행하고, 테스트하고, 배치하는 데 필요한 {{site.data.keyword.Bluemix_notm}} CLI 플러그인입니다. - -* [SDK Generator 플러그인 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](sdk_cli.html) - - [Open API 스펙 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.openapis.org/) 준수 REST API 정의로부터 SDK를 생성하는 데 필요한 {{site.data.keyword.Bluemix_notm}} CLI 플러그인입니다. - -### Android -{: #android notoc} - -* [Android Studio 2.2 이상![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.android.com/studio) - * 최신 [Android 7.0 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.android.com/versions/nougat-7-0/) 런타임을 설치하십시오. - -### iOS -{: #ios notoc} - -* [Xcode 8 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com/xcode/)(권장) - - -* iOS SDK 종속 항목 설치를 위한 [CocoaPods ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://cocoapods.org/) 종속 항목 관리자. 최신 버전을 사용하십시오. - - ``` - $ sudo gem install cocoapods --pre - ``` -* {{site.data.keyword.watson}} Developer Cloud SDK를 설치하는 데 사용되는 [Carthage ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/Carthage/Carthage) 종속 항목 관리자. - - ``` - $ brew install carthage - ``` +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-18" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# 코드 가져오기 +{: #Get_Code} + +선택한 기능을 사용하여 프로젝트의 구성 및 설정을 완료하면 코드를 다운로드하여 실행할 수 있습니다. 다운로드한 프로젝트는 사용자가 구성한 각 기능의 신임 정보와 필수 SDK 종속 항목을 사용하여 사전 구성됩니다. + +다운로드한 프로젝트에서 구성할 수 없는 서비스의 신임 정보를 완료해야 합니다. 스타터 프로젝트의 `README.md` 파일에 지시사항이 포함되어 있습니다. Markdown 뷰어에서 `README.md` 파일을 보고 설정을 완료하십시오. + +## 전제조건 개발자 도구 +{: #prereq-dev-tools} + +{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}에서 생성된 코드에 대한 작업을 수행할 경우 다음 개발자 도구가 필요합니다. + + +### 일반 +{: #general notoc} + +* [Homebrew ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://brew.sh/) + * Apple 개발자가 기타 도구와 런타임(예: CocoaPods, Carthage)을 설치할 수 있도록 지원하는 명령행 도구입니다. + +* [Docker ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.docker.com/get-docker) + * 컨테이너 내 애플리케이션의 실행 및 디버깅을 지원하는 오픈 소스 프로젝트입니다. 비모바일 프로젝트의 경우에만 필수입니다. + +### {{site.data.keyword.Bluemix_notm}} +{: #bluemix notoc} + +* {{site.data.keyword.apiconnect_short}} Loopback 및 기타 {{site.data.keyword.Bluemix_notm}} Productivity 도구 실행을 지원하는 Node.js(Node 및 npm 런타임). + + {{site.data.keyword.apiconnect_short}} 도구를 로컬로 실행하려면 Node 5.x를 사용하십시오. + + ``` + $ brew install Node5 + ``` + +* [Bluemix CLI 도구 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://clis.ng.bluemix.net/ui/home.html) + + {{site.data.keyword.Bluemix_notm}}에 대한 명령행 인터페이스에서 Cloud Foundry 런타임을 배치하는 데 필요한 명령행 도구입니다. + +* [{{site.data.keyword.dev_cli_notm}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](dev_cli.html) + + 웹 및 모바일 프로젝트를 작성하고, 실행하고, 테스트하고, 배치하는 데 필요한 {{site.data.keyword.Bluemix_notm}} CLI 플러그인입니다. + +* [SDK Generator 플러그인 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](sdk_cli.html) + + [Open API 스펙 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.openapis.org/) 준수 REST API 정의로부터 SDK를 생성하는 데 필요한 {{site.data.keyword.Bluemix_notm}} CLI 플러그인입니다. + +### Android +{: #android notoc} + +* [Android Studio 2.2 이상![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.android.com/studio) + * 최신 [Android 7.0 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.android.com/versions/nougat-7-0/) 런타임을 설치하십시오. + +### iOS +{: #ios notoc} + +* [Xcode 8 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com/xcode/)(권장) + + +* iOS SDK 종속 항목 설치를 위한 [CocoaPods ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://cocoapods.org/) 종속 항목 관리자. 최신 버전을 사용하십시오. + + ``` + $ sudo gem install cocoapods --pre + ``` +* {{site.data.keyword.watson}} Developer Cloud SDK를 설치하는 데 사용되는 [Carthage ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/Carthage/Carthage) 종속 항목 관리자. + + ``` + $ brew install carthage + ``` diff --git a/cloudnative/nl/ko/index.md b/cloudnative/nl/ko/index.md index 069d65aa3..24f75735d 100644 --- a/cloudnative/nl/ko/index.md +++ b/cloudnative/nl/ko/index.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2016-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 클라우드 네이티브 프로젝트 빌드 -{: #web-mobile} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} [프로젝트](projects.html) 개념을 통해 클라우드 네이티브 앱을 관리할 수 있습니다. [{{site.data.keyword.dev_console}}](devex.html) 또는 {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI의 [{{site.data.keyword.dev_cli_notm}}](dev_cli.html)을 사용하여 프로젝트를 작성할 수 있습니다. {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}은 클라우드 네이티브 애플리케이션 개발자가 필요로 하는 대부분의 일반적 서비스 기능을 개발자에게 최적화된 하나의 연결된 경험으로 제공합니다. - -{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}은 클라우드 네이티브 애플리케이션 개발자가 다양한 [패턴 유형](patterns.html) 및 [스타터](starters.html)로부터 프로젝트를 작성하고, 주요 {{site.data.keyword.Bluemix_notm}} 최적화 서비스를 작성하여 프로젝트에 연결하고, SDK를 사용하여 작동하는 코드를 빠르게 다운로드할 수 있게 해 줍니다. SDK는 이를 신속히 실행할 수 있게 해 주는 기능 신임 정보 및 종속 항목과 완전히 통합되어 있습니다. 애플리케이션이 실행 중이며 기능을 구성한 경우에는 프로젝트로 돌아가 애플리케이션 사용자와의 상호관계를 모니터하고 관리할 수 있습니다. {{site.data.keyword.dev_console}}을 통해 서비스를 구성하고 관리할 수도 있습니다. - - - - - - -# 관련 링크 -{: #rellinks notoc} - -## 튜토리얼 및 샘플 -{: #samples notoc} - -* [샘플: Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} -* [동영상 튜토리얼](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2016-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 클라우드 네이티브 프로젝트 빌드 +{: #web-mobile} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} [프로젝트](projects.html) 개념을 통해 클라우드 네이티브 앱을 관리할 수 있습니다. [{{site.data.keyword.dev_console}}](devex.html) 또는 {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI의 [{{site.data.keyword.dev_cli_notm}}](dev_cli.html)을 사용하여 프로젝트를 작성할 수 있습니다. {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}은 클라우드 네이티브 애플리케이션 개발자가 필요로 하는 대부분의 일반적 서비스 기능을 개발자에게 최적화된 하나의 연결된 경험으로 제공합니다. + +{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}은 클라우드 네이티브 애플리케이션 개발자가 다양한 [패턴 유형](patterns.html) 및 [스타터](starters.html)로부터 프로젝트를 작성하고, 주요 {{site.data.keyword.Bluemix_notm}} 최적화 서비스를 작성하여 프로젝트에 연결하고, SDK를 사용하여 작동하는 코드를 빠르게 다운로드할 수 있게 해 줍니다. SDK는 이를 신속히 실행할 수 있게 해 주는 기능 신임 정보 및 종속 항목과 완전히 통합되어 있습니다. 애플리케이션이 실행 중이며 기능을 구성한 경우에는 프로젝트로 돌아가 애플리케이션 사용자와의 상호관계를 모니터하고 관리할 수 있습니다. {{site.data.keyword.dev_console}}을 통해 서비스를 구성하고 관리할 수도 있습니다. + + + + + + +# 관련 링크 +{: #rellinks notoc} + +## 튜토리얼 및 샘플 +{: #samples notoc} + +* [샘플: Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} +* [동영상 튜토리얼](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} diff --git a/cloudnative/nl/ko/patterns.md b/cloudnative/nl/ko/patterns.md index b69f95cb6..6a78d876a 100644 --- a/cloudnative/nl/ko/patterns.md +++ b/cloudnative/nl/ko/patterns.md @@ -1,99 +1,99 @@ - ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 패턴 유형 -{: #patterns} - -클라우드 네이티브 패턴은 애플리케이션의 일관성 있고, 확장 가능하며 신뢰할 수 있는 토폴로지를 확보하는 데 도움을 주는 검증된 디자인입니다. 프로젝트를 작성할 때는 선택할 수 있는 다양한 패턴 유형이 제공됩니다. 사용자는 프로젝트에 포함시킬 패턴 유형 및 기능을 선택하기만 하면 됩니다. 프로젝트 환경 설정을 정의하고 나면 편집하거나, 실행 또는 디버그하거나, 로컬 또는 {{site.data.keyword.Bluemix}}에 배치할 수 있는 스타터 프로젝트가 생성됩니다. - -## 웹 앱 -{: #web} - -웹 프로젝트는 HTML, JavaScript 및 스타일시트와 같은 웹 컨텐츠를 웹 서버에 제공하는 기능을 추가합니다. - -다음 웹 스타터가 사용 가능합니다. - -* 기본 웹: 정적 `index.html` 파일, 기본 스타일시트(비어 있음) 및 JavaScript 파일을 제공합니다. -* Webpack: ES6(ECMAScript 6) 소스 파일이 `src/client`에 있으며 이러한 파일을 브라우저에서 사용할 수 있도록 축소하고 변환하기 위해 WebPack을 사용하여 컴파일하는 프로젝트를 작성합니다. -* Webpack + React: 사용자 인터페이스 빌드에 사용되는 리치 프레임워크입니다. 소스 파일은 `src/client/app`에 있으며 WebPack을 사용해 컴파일되어 공용 디렉토리에서 제공됩니다. - - -## 모바일 앱 -{: #mobile} - -모바일 앱 패턴은 {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, {{site.data.keyword.appid_short}} 등과 같은 백엔드 서비스와 직접 연결하는 모바일 앱을 빌드하는 데 도움을 줍니다. 프로젝트는 sdkGen(BFF 등) 및 마이크로서비스를 통해 추가될 수도 있습니다. - -{{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, {{site.data.keyword.openwhisk_short}} 등과 같은 스타터 목록에서 선택할 수 있습니다. - -Swift, Android 또는 Cordova를 사용하여 모바일 앱을 생성할 수 있습니다. - - -## BFF(Backend for Frontend) -{: #bff} - -BFF(Backend for Frontend) 패턴은 실제로 사용자 상호작용 요구사항과 일치하는 양식으로 비즈니스 데이터 및 서비스를 노출하는 데 집중할 수 있도록 도움을 줍니다. 클라우드 솔루션에 대한 사용자의 경험을 최적화하려면, 모바일 애플리케이션에 대한 색다른 사용자 경험과 웹 애플리케이션에 대한 더 풍부하고 자세한 경험이 필요할 수 있습니다. [{{site.data.keyword.conversationfull}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.ibm.com/watson/developercloud/conversation.html) 서비스와 같은 음성 제어 디바이스를 사용하면 사용자와의 상호작용이 음성으로 제어될 수 있습니다. 이 디지털 채널은 음성 집중 기반 상호작용을 관리하기 위해 매우 다양한 BFF가 필요할 것입니다. - -{{site.data.keyword.Bluemix_notm}}를 사용하면, 여러 언어를 사용하는 프로그래밍 접근 방식을 통해 BFF를 빌드하여 BFF를 정의할 수 있습니다. IBM에서는 Node.js, Swift 또는 Java를 사용하고, 이를 Cloud Foundry, 컨테이너 서비스 또는 서버리스(serverless)로 클라우드 네이티브 패턴에서 실행하는 것을 권장합니다. - -BFF는 데이터 지속성, 캐싱을 위한 서비스와의 통합 및 {{site.data.keyword.ibmwatson}}, {{site.data.keyword.iot_short_notm}}, {{site.data.keyword.weather_short}}와 같은 높은 가치를 제공하는 서비스 및 {{site.data.keyword.sparks}}와 같은 데이터 분석과의 통합을 관리합니다. - -BFF는 가장 일반적으로 REST 패턴을 사용하여 API를 노출하게 되지만, {{site.data.keyword.messagehub}}를 사용하여 메시징 아키텍처에서 작동하도록 BFF를 디자인할 수 있습니다. - -BFF 기본 스타터는 Node.js 또는 Swift를 사용하여 사용 가능합니다. - - -## 마이크로서비스 -{: #microservice} - -마이크로서비스 프로젝트는 기본 상태 엔드포인트인 REST API를 포함한 백엔드 마이크로서비스를 빌드하기 위한 기초를 제공합니다. 생성되는 프로젝트는 마이크로서비스 자체 및 연결된 클라우드 서비스에서 필요로 하는 모든 종속 항목을 포함합니다. - -마이크로서비스 기본 스타터는 Java를 사용하여 이용 가능합니다. - - - - -## 언어 -{: #languages notoc} - -지원되는 언어는 다음과 같습니다. - - * [Java ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](../runtimes/liberty/getting-started.html){: new_window} - * [Node.js ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](../runtimes/nodejs/getting-started.html){: new_window} - * [Swift ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](../runtimes/swift/getting-started.html){: new_window} - - -### Java -{: #java notoc} - -Java에는 엔터프라이즈급 애플리케이션을 빌드할 수 있는 검증된 기능이 있습니다. 그러나 Java 8의 새 기능을 통해, Java는 Liberty 등의 경량 런타임이나 Spring Boot와 같은 프레임워크와 함께 마이크로서비스를 빌드하는 경우에도 사용하기 적절한 언어가 되었습니다. - - -### Node.js -{: #node notoc} - -Node.js는 이벤트 중심의 비차단 I/O 모델을 사용하는 JavaScript 런타임으로, 경량이고 효율적이며 웹 애플리케이션, BFF 패턴 및 마이크로서비스의 처리량 및 확장성 측면에서 탁월합니다. Node.js의 패키지 에코시스템인 npm은 많은 오픈 소스 모듈에 대한 액세스를 제공함으로써 애플리케이션 개발 속도를 높일 수 있는 다양한 기능을 제공합니다. - - -### Swift -{: #swift notoc} - -Swift는 2014년에 Apple에서 만든 최신 프로그래밍 언어로, Objective C 사용을 대체하기 위해 디자인되었으며 2015년 12월 오픈 소스로 전환되었습니다. 현재는 x86, ARM 또는 Z 아키텍처를 사용하는 Linux 및 macOS 운영 체제의 iOS, macOS, 웹 서비스 및 시스템 소프트웨어를 빌드하는 데 사용됩니다. 이 언어는 스크립팅 언어처럼 작성되지만 낮은 오버헤드로 C와 유사한 고성능을 달성할 수 있도록 컴파일되어 클라우드 런타임에 적합합니다. 이 언어는 Java에서 볼 수 있는 강력하고 정적인 유형의 시스템을 사용하는 동시에 JavaScript에서 볼 수 있는 기능 스타일 및 비동기 루틴을 사용합니다. 이 언어는 성능이 뛰어나며, 소스는 LLVM 컴파일러 도구 체인을 사용하여 네이티브 코드로 컴파일되고 C로 작성된 외부 시스템 라이브러리를 쉽게 이용할 수 있습니다. + +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 패턴 유형 +{: #patterns} + +클라우드 네이티브 패턴은 애플리케이션의 일관성 있고, 확장 가능하며 신뢰할 수 있는 토폴로지를 확보하는 데 도움을 주는 검증된 디자인입니다. 프로젝트를 작성할 때는 선택할 수 있는 다양한 패턴 유형이 제공됩니다. 사용자는 프로젝트에 포함시킬 패턴 유형 및 기능을 선택하기만 하면 됩니다. 프로젝트 환경 설정을 정의하고 나면 편집하거나, 실행 또는 디버그하거나, 로컬 또는 {{site.data.keyword.Bluemix}}에 배치할 수 있는 스타터 프로젝트가 생성됩니다. + +## 웹 앱 +{: #web} + +웹 프로젝트는 HTML, JavaScript 및 스타일시트와 같은 웹 컨텐츠를 웹 서버에 제공하는 기능을 추가합니다. + +다음 웹 스타터가 사용 가능합니다. + +* 기본 웹: 정적 `index.html` 파일, 기본 스타일시트(비어 있음) 및 JavaScript 파일을 제공합니다. +* Webpack: ES6(ECMAScript 6) 소스 파일이 `src/client`에 있으며 이러한 파일을 브라우저에서 사용할 수 있도록 축소하고 변환하기 위해 WebPack을 사용하여 컴파일하는 프로젝트를 작성합니다. +* Webpack + React: 사용자 인터페이스 빌드에 사용되는 리치 프레임워크입니다. 소스 파일은 `src/client/app`에 있으며 WebPack을 사용해 컴파일되어 공용 디렉토리에서 제공됩니다. + + +## 모바일 앱 +{: #mobile} + +모바일 앱 패턴은 {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, {{site.data.keyword.appid_short}} 등과 같은 백엔드 서비스와 직접 연결하는 모바일 앱을 빌드하는 데 도움을 줍니다. 프로젝트는 sdkGen(BFF 등) 및 마이크로서비스를 통해 추가될 수도 있습니다. + +{{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, {{site.data.keyword.openwhisk_short}} 등과 같은 스타터 목록에서 선택할 수 있습니다. + +Swift, Android 또는 Cordova를 사용하여 모바일 앱을 생성할 수 있습니다. + + +## BFF(Backend for Frontend) +{: #bff} + +BFF(Backend for Frontend) 패턴은 실제로 사용자 상호작용 요구사항과 일치하는 양식으로 비즈니스 데이터 및 서비스를 노출하는 데 집중할 수 있도록 도움을 줍니다. 클라우드 솔루션에 대한 사용자의 경험을 최적화하려면, 모바일 애플리케이션에 대한 색다른 사용자 경험과 웹 애플리케이션에 대한 더 풍부하고 자세한 경험이 필요할 수 있습니다. [{{site.data.keyword.conversationfull}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.ibm.com/watson/developercloud/conversation.html) 서비스와 같은 음성 제어 디바이스를 사용하면 사용자와의 상호작용이 음성으로 제어될 수 있습니다. 이 디지털 채널은 음성 집중 기반 상호작용을 관리하기 위해 매우 다양한 BFF가 필요할 것입니다. + +{{site.data.keyword.Bluemix_notm}}를 사용하면, 여러 언어를 사용하는 프로그래밍 접근 방식을 통해 BFF를 빌드하여 BFF를 정의할 수 있습니다. IBM에서는 Node.js, Swift 또는 Java를 사용하고, 이를 Cloud Foundry, 컨테이너 서비스 또는 서버리스(serverless)로 클라우드 네이티브 패턴에서 실행하는 것을 권장합니다. + +BFF는 데이터 지속성, 캐싱을 위한 서비스와의 통합 및 {{site.data.keyword.ibmwatson}}, {{site.data.keyword.iot_short_notm}}, {{site.data.keyword.weather_short}}와 같은 높은 가치를 제공하는 서비스 및 {{site.data.keyword.sparks}}와 같은 데이터 분석과의 통합을 관리합니다. + +BFF는 가장 일반적으로 REST 패턴을 사용하여 API를 노출하게 되지만, {{site.data.keyword.messagehub}}를 사용하여 메시징 아키텍처에서 작동하도록 BFF를 디자인할 수 있습니다. + +BFF 기본 스타터는 Node.js 또는 Swift를 사용하여 사용 가능합니다. + + +## 마이크로서비스 +{: #microservice} + +마이크로서비스 프로젝트는 기본 상태 엔드포인트인 REST API를 포함한 백엔드 마이크로서비스를 빌드하기 위한 기초를 제공합니다. 생성되는 프로젝트는 마이크로서비스 자체 및 연결된 클라우드 서비스에서 필요로 하는 모든 종속 항목을 포함합니다. + +마이크로서비스 기본 스타터는 Java를 사용하여 이용 가능합니다. + + + + +## 언어 +{: #languages notoc} + +지원되는 언어는 다음과 같습니다. + + * [Java ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](../runtimes/liberty/getting-started.html){: new_window} + * [Node.js ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](../runtimes/nodejs/getting-started.html){: new_window} + * [Swift ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](../runtimes/swift/getting-started.html){: new_window} + + +### Java +{: #java notoc} + +Java에는 엔터프라이즈급 애플리케이션을 빌드할 수 있는 검증된 기능이 있습니다. 그러나 Java 8의 새 기능을 통해, Java는 Liberty 등의 경량 런타임이나 Spring Boot와 같은 프레임워크와 함께 마이크로서비스를 빌드하는 경우에도 사용하기 적절한 언어가 되었습니다. + + +### Node.js +{: #node notoc} + +Node.js는 이벤트 중심의 비차단 I/O 모델을 사용하는 JavaScript 런타임으로, 경량이고 효율적이며 웹 애플리케이션, BFF 패턴 및 마이크로서비스의 처리량 및 확장성 측면에서 탁월합니다. Node.js의 패키지 에코시스템인 npm은 많은 오픈 소스 모듈에 대한 액세스를 제공함으로써 애플리케이션 개발 속도를 높일 수 있는 다양한 기능을 제공합니다. + + +### Swift +{: #swift notoc} + +Swift는 2014년에 Apple에서 만든 최신 프로그래밍 언어로, Objective C 사용을 대체하기 위해 디자인되었으며 2015년 12월 오픈 소스로 전환되었습니다. 현재는 x86, ARM 또는 Z 아키텍처를 사용하는 Linux 및 macOS 운영 체제의 iOS, macOS, 웹 서비스 및 시스템 소프트웨어를 빌드하는 데 사용됩니다. 이 언어는 스크립팅 언어처럼 작성되지만 낮은 오버헤드로 C와 유사한 고성능을 달성할 수 있도록 컴파일되어 클라우드 런타임에 적합합니다. 이 언어는 Java에서 볼 수 있는 강력하고 정적인 유형의 시스템을 사용하는 동시에 JavaScript에서 볼 수 있는 기능 스타일 및 비동기 루틴을 사용합니다. 이 언어는 성능이 뛰어나며, 소스는 LLVM 컴파일러 도구 체인을 사용하여 네이티브 코드로 컴파일되고 C로 작성된 외부 시스템 라이브러리를 쉽게 이용할 수 있습니다. diff --git a/cloudnative/nl/ko/projects.md b/cloudnative/nl/ko/projects.md index 0198a4677..ff6b10e4c 100644 --- a/cloudnative/nl/ko/projects.md +++ b/cloudnative/nl/ko/projects.md @@ -1,57 +1,57 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 프로젝트 -{: #projects} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}은 앱 사용자 인터페이스, 데이터 및 서비스를 하나의 완전한 *프로젝트*로 결합합니다. 프로젝트를 작성하여 앱의 모든 필수 파트와 추가된 기능을 {{site.data.keyword.Bluemix_notm}} 서버에서 유지보수합니다. 사용자는 앱 코드를 다운로드할 수 있으며 서비스가 프로젝트 내에 구성된 경우에는 필수 신임 정보 및 초기자(initializer)도 다운로드할 수 있습니다. **프로젝트**를 선택하여 모든 프로젝트를 볼 수 있습니다. - -**프로젝트** 페이지에서 프로젝트를 선택하여 하나의 프로젝트에 대한 추가 정보를 볼 수 있습니다. 이를 수행하면 **프로젝트 개요** 페이지가 표시되며, 이 페이지는 해당 프로젝트용으로 구성되고 사용 가능한 서비스를 포함합니다. 서비스는 기능을 추가하여 앱을 확장하는 별도의 기능입니다. 서비스는 개별적으로 추가되므로 푸시 서비스, 인증, 데이터 및 스토리지 또는 기타 서비스 등 필요한 서비스를 추가할 수 있습니다. **프로젝트 개요** 페이지에서 프로젝트에 서비스를 추가하고 지시사항에 따라 이를 구성하면 해당 서비스가 자동으로 앱과 연관됩니다. 프로젝트 개요 페이지에 대한 자세한 정보는 [프로젝트 개요 페이지](project_overview_page.html)를 참조하십시오. - -프로젝트를 작성하려면 [패턴](patterns.html) 및 [스타터](starters.html)를 선택해야 합니다. - - -## 프로젝트 개요 페이지 -{: #project_overview} - -**프로젝트** 페이지에서 프로젝트를 선택하여 하나의 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 프로젝트를 보고 이에 대한 작업을 수행할 수 있으며, 이렇게 선택하면 프로젝트 개요 페이지가 열립니다. -{: shortdesc} - -**프로젝트 개요** 페이지는 선택한 프로젝트에 대해 구성되거나 구성하는 데 사용 가능한 각 기능에 대해 하나의 타일을 표시합니다. 타일은 기능의 유형과 3개의 수직 정렬된 점이 있는 *조치* 단추를 표시합니다. 사용 가능하거나 구성된 서비스의 예에는 {{site.data.keyword.mobilepushshort}}, 분석 또는 데이터 및 스토리지가 포함됩니다. 호환 가능한 기능은 프로젝트 유형 및 해당 지역에서 사용 가능한 기능에 따라 달라지므로, 모든 기능을 모든 프로젝트와 연관시킬 수는 없습니다. - -기능 유형이 아직 프로젝트와 연관되지 않은 경우에는 **작성** 단추가 타일에 표시됩니다. 이 조치 단추 옵션은 기능이 아직 연관되지 않은 경우 서비스의 인스턴스를 작성하거나 기존 서비스 인스턴스를 추가하는 용도로 사용됩니다. **기존 추가**를 선택하면 사용자의 영역에 있는 해당 유형의 서비스 인스턴스 목록이 제공됩니다. - -기능이 이 프로젝트와 이미 연관된 경우에는 기능 유형 뒤에, 연관된 서비스 인스턴스의 이름이 타일에 표시됩니다. 이를 통해 {{site.data.keyword.dev_console}}에서 이 프로젝트와 관련된 서비스 인스턴스를 쉽게 찾을 수 있습니다. 기능이 이미 프로젝트와 연관된 경우, 조치 단추에서 사용 가능한 조치는 **보기** 및 **제거**입니다. 서비스 인스턴스를 제거하면 이 프로젝트에 대한 연관만 제거되며 {{site.data.keyword.dev_console}}에서 서비스 인스턴스가 삭제되지는 않습니다. 서비스 인스턴스를 삭제하려면, 서비스 인스턴스를 보고 삭제할 수 있도록 **웹 및 모바일 > 서비스** 페이지를 클릭하십시오. - -**코드** 타일에서 **코드 가져오기**를 선택하여 프로젝트의 코드를 다운로드하십시오. 코드 다운로드에 대한 자세한 정보는 [코드 가져오기](get_code.html)를 참조하십시오. - - -## 새 스타터를 사용하도록 프로젝트 업데이트 -{: #update-starter} - -1. **프로젝트** 또는 **프로젝트 개요** 페이지에서 **오버플로우 메뉴** 아이콘을 클릭하고 **스타터 업데이트**를 선택하십시오. - -2. 새 스타터를 선택하고 **업데이트**를 클릭하십시오. - -3. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. - - 또는 **코드** 페이지를 클릭할 수 있습니다. - - -## 새 언어를 생성하도록 프로젝트 업데이트 -{: #update-language} - -1. **프로젝트** 또는 **프로젝트 개요** 페이지에서 **오버플로우 메뉴** 아이콘을 클릭하고 **스타터 업데이트**를 선택하십시오. - -2. 새 언어를 선택하고 **업데이트**를 클릭하십시오. - -3. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 프로젝트 +{: #projects} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}은 앱 사용자 인터페이스, 데이터 및 서비스를 하나의 완전한 *프로젝트*로 결합합니다. 프로젝트를 작성하여 앱의 모든 필수 파트와 추가된 기능을 {{site.data.keyword.Bluemix_notm}} 서버에서 유지보수합니다. 사용자는 앱 코드를 다운로드할 수 있으며 서비스가 프로젝트 내에 구성된 경우에는 필수 신임 정보 및 초기자(initializer)도 다운로드할 수 있습니다. **프로젝트**를 선택하여 모든 프로젝트를 볼 수 있습니다. + +**프로젝트** 페이지에서 프로젝트를 선택하여 하나의 프로젝트에 대한 추가 정보를 볼 수 있습니다. 이를 수행하면 **프로젝트 개요** 페이지가 표시되며, 이 페이지는 해당 프로젝트용으로 구성되고 사용 가능한 서비스를 포함합니다. 서비스는 기능을 추가하여 앱을 확장하는 별도의 기능입니다. 서비스는 개별적으로 추가되므로 푸시 서비스, 인증, 데이터 및 스토리지 또는 기타 서비스 등 필요한 서비스를 추가할 수 있습니다. **프로젝트 개요** 페이지에서 프로젝트에 서비스를 추가하고 지시사항에 따라 이를 구성하면 해당 서비스가 자동으로 앱과 연관됩니다. 프로젝트 개요 페이지에 대한 자세한 정보는 [프로젝트 개요 페이지](project_overview_page.html)를 참조하십시오. + +프로젝트를 작성하려면 [패턴](patterns.html) 및 [스타터](starters.html)를 선택해야 합니다. + + +## 프로젝트 개요 페이지 +{: #project_overview} + +**프로젝트** 페이지에서 프로젝트를 선택하여 하나의 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 프로젝트를 보고 이에 대한 작업을 수행할 수 있으며, 이렇게 선택하면 프로젝트 개요 페이지가 열립니다. +{: shortdesc} + +**프로젝트 개요** 페이지는 선택한 프로젝트에 대해 구성되거나 구성하는 데 사용 가능한 각 기능에 대해 하나의 타일을 표시합니다. 타일은 기능의 유형과 3개의 수직 정렬된 점이 있는 *조치* 단추를 표시합니다. 사용 가능하거나 구성된 서비스의 예에는 {{site.data.keyword.mobilepushshort}}, 분석 또는 데이터 및 스토리지가 포함됩니다. 호환 가능한 기능은 프로젝트 유형 및 해당 지역에서 사용 가능한 기능에 따라 달라지므로, 모든 기능을 모든 프로젝트와 연관시킬 수는 없습니다. + +기능 유형이 아직 프로젝트와 연관되지 않은 경우에는 **작성** 단추가 타일에 표시됩니다. 이 조치 단추 옵션은 기능이 아직 연관되지 않은 경우 서비스의 인스턴스를 작성하거나 기존 서비스 인스턴스를 추가하는 용도로 사용됩니다. **기존 추가**를 선택하면 사용자의 영역에 있는 해당 유형의 서비스 인스턴스 목록이 제공됩니다. + +기능이 이 프로젝트와 이미 연관된 경우에는 기능 유형 뒤에, 연관된 서비스 인스턴스의 이름이 타일에 표시됩니다. 이를 통해 {{site.data.keyword.dev_console}}에서 이 프로젝트와 관련된 서비스 인스턴스를 쉽게 찾을 수 있습니다. 기능이 이미 프로젝트와 연관된 경우, 조치 단추에서 사용 가능한 조치는 **보기** 및 **제거**입니다. 서비스 인스턴스를 제거하면 이 프로젝트에 대한 연관만 제거되며 {{site.data.keyword.dev_console}}에서 서비스 인스턴스가 삭제되지는 않습니다. 서비스 인스턴스를 삭제하려면, 서비스 인스턴스를 보고 삭제할 수 있도록 **웹 및 모바일 > 서비스** 페이지를 클릭하십시오. + +**코드** 타일에서 **코드 가져오기**를 선택하여 프로젝트의 코드를 다운로드하십시오. 코드 다운로드에 대한 자세한 정보는 [코드 가져오기](get_code.html)를 참조하십시오. + + +## 새 스타터를 사용하도록 프로젝트 업데이트 +{: #update-starter} + +1. **프로젝트** 또는 **프로젝트 개요** 페이지에서 **오버플로우 메뉴** 아이콘을 클릭하고 **스타터 업데이트**를 선택하십시오. + +2. 새 스타터를 선택하고 **업데이트**를 클릭하십시오. + +3. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. + + 또는 **코드** 페이지를 클릭할 수 있습니다. + + +## 새 언어를 생성하도록 프로젝트 업데이트 +{: #update-language} + +1. **프로젝트** 또는 **프로젝트 개요** 페이지에서 **오버플로우 메뉴** 아이콘을 클릭하고 **스타터 업데이트**를 선택하십시오. + +2. 새 언어를 선택하고 **업데이트**를 클릭하십시오. + +3. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. diff --git a/cloudnative/nl/ko/sdk.md b/cloudnative/nl/ko/sdk.md index 6fa7d6edd..3578d363f 100644 --- a/cloudnative/nl/ko/sdk.md +++ b/cloudnative/nl/ko/sdk.md @@ -1,67 +1,67 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-17" - ---- -# SDK -{: #sdk} - -앱에 {{site.data.keyword.Bluemix}} 모바일 서비스 SDK를 추가하려면 사용할 SDK를 선택한 후 앱에 SDK를 가져오도록 종속 항목 관리자를 구성하십시오. - - -## 클라이언트 SDK -{: #client_sdk} - -모바일 애플리케이션에서 다음 SDK를 사용하여 각 기능을 이용할 수 있습니다. - - -### Android SDK -{: #android_sdk} - -- [코어 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) -- [{{site.data.keyword.mobileanalytics_short}} SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) -- [Facebook 인증 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) -- [Google 인증 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) - - -### iOS SDK -{: #ios_sdk} - -- [코어 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) -- [{{site.data.keyword.mobileanalytics_short}} SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) -- [Facebook 인증 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) -- [Google 인증 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) -- [{{site.data.keyword.amashort}} SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) - - -### Cordova 플러그인 -{: #cordova_plugin} - -- [코어 플러그인 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) -- [{{site.data.keyword.mobilepushshort}} 플러그인 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## 서버 SDK -{: #server_sdk} - -Java, NodeJS 또는 Swift 서버 애플리케이션이 있는 경우 다음 SDK를 사용하여 각 서비스와 통신할 수 있습니다. - - -### {{site.data.keyword.mobilepushshort}} 서버 SDK -{: #push_sdk} - -- [{{site.data.keyword.mobilepushshort}} Java 서버 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) -- [{{site.data.keyword.mobilepushshort}} Swift 서버 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) -- [{{site.data.keyword.mobilepushshort}} NodeJS 서버 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) - - -### {{site.data.keyword.amashort}} 서버 SDK -{: #mca_sdk} - -- [{{site.data.keyword.amashort}} Swift 서버 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) - - +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-17" + +--- +# SDK +{: #sdk} + +앱에 {{site.data.keyword.Bluemix}} 모바일 서비스 SDK를 추가하려면 사용할 SDK를 선택한 후 앱에 SDK를 가져오도록 종속 항목 관리자를 구성하십시오. + + +## 클라이언트 SDK +{: #client_sdk} + +모바일 애플리케이션에서 다음 SDK를 사용하여 각 기능을 이용할 수 있습니다. + + +### Android SDK +{: #android_sdk} + +- [코어 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) +- [{{site.data.keyword.mobileanalytics_short}} SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) +- [Facebook 인증 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) +- [Google 인증 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) + + +### iOS SDK +{: #ios_sdk} + +- [코어 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) +- [{{site.data.keyword.mobileanalytics_short}} SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) +- [Facebook 인증 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) +- [Google 인증 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) +- [{{site.data.keyword.amashort}} SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) + + +### Cordova 플러그인 +{: #cordova_plugin} + +- [코어 플러그인 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) +- [{{site.data.keyword.mobilepushshort}} 플러그인 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## 서버 SDK +{: #server_sdk} + +Java, NodeJS 또는 Swift 서버 애플리케이션이 있는 경우 다음 SDK를 사용하여 각 서비스와 통신할 수 있습니다. + + +### {{site.data.keyword.mobilepushshort}} 서버 SDK +{: #push_sdk} + +- [{{site.data.keyword.mobilepushshort}} Java 서버 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) +- [{{site.data.keyword.mobilepushshort}} Swift 서버 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) +- [{{site.data.keyword.mobilepushshort}} NodeJS 서버 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) + + +### {{site.data.keyword.amashort}} 서버 SDK +{: #mca_sdk} + +- [{{site.data.keyword.amashort}} Swift 서버 SDK ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) + + diff --git a/cloudnative/nl/ko/sdk_BMSClient.md b/cloudnative/nl/ko/sdk_BMSClient.md index acfaaeaf2..206566369 100644 --- a/cloudnative/nl/ko/sdk_BMSClient.md +++ b/cloudnative/nl/ko/sdk_BMSClient.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# BMSClient 초기화 -{: #sdk_BMSClient} - -`BMSCore`에서는 다른 {{site.data.keyword.Bluemix}} 모바일 서비스 클라이언트 SDK가 이와 연관된 {{site.data.keyword.Bluemix_notm}} 서비스와 통신하는 데 사용하는 HTTP 인프라를 제공합니다. - - -## Android 애플리케이션 초기화 -{: #init-BMSClient-android} - -`BMSCore` 패키지를 다운로드하여 Android Studio 프로젝트로 가져오거나 Gradle을 사용할 수 있습니다. - -1. 다음 `import` 문을 프로젝트 파일의 시작 부분에 추가하여 클라이언트 SDK를 가져오십시오. - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; - ``` - {: codeblock} - -2. Android 애플리케이션의 기본 활동의 `onCreate` 메소드 내 또는 프로젝트에 가장 적합한 위치에 초기화 코드를 추가하여 Android 애플리케이션에서 `BMSClient` SDK를 초기화하십시오. - - ```Java - BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region - ``` - {: codeblock} - - **bluemixRegion** 매개변수를 사용하여 `BMSClient`를 초기화해야 합니다. 초기자(initializer)에서 **bluemixRegion** 값은 사용 중인 {{site.data.keyword.Bluemix_notm}} 배치를 지정합니다(예: `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` 또는 `BMSClient.REGION_SYDNEY`). - - -## iOS 애플리케이션 초기화 -{: #init-BMSClient-ios} - -[CocoaPods](https://cocoapods.org){: new_window} 또는 [Carthage](https://github.com/Carthage/Carthage){: new_window}를 사용하여 `BMSCore` 패키지를 가져올 수 있습니다. - -1. CocoaPods를 사용하여 `BMSCore`를 설치하려면 Podfile에 다음 행을 추가하십시오. 프로젝트에 아직 Podfile이 없으면 `pod init` 명령을 사용하십시오. - - ```Swift - use_frameworks! - - target 'MyApp' do - pod 'BMSCore' - end - ``` - {: codeblock} - - 그런 다음 `pod install` 명령을 실행하고 생성된 `.xcworkspace` 파일을 여십시오. `BMSCore`의 새 릴리스로 업데이트하려면 `pod update BMSCore`를 사용하십시오. - - CocoaPods 사용에 대한 자세한 정보는 [CocoaPods 안내서 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://guides.cocoapods.org/using/index.html){: new_window}를 참조하십시오. - -2. Carthage를 사용하여 `BMSCore`를 설치하려면 다음 [지시사항 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/Carthage/Carthage#getting-started){: new_window}을 따르십시오. - - 1. Cartfile에 다음 행을 추가하십시오. - - ``` - github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" - ``` - {: codeblock} - - 2. `carthage update` 명령을 실행하십시오. - - 3. 빌드가 완료되면 Carthage 지시사항의 [3단계 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/Carthage/Carthage#getting-started)에 따라 `BMSCore.framework`를 프로젝트에 추가하십시오. - - Swift 2.3으로 빌드된 애플리케이션의 경우 `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3` 명령을 사용하십시오. 그 외의 경우에는 `carthage update` 명령을 사용하십시오. - -3. 모듈을 가져오십시오. - - ```Swift - import BMSCore - ``` - {: codeblock} - -4. 다음 코드를 사용하여 `BMSClient` 클래스를 초기화하십시오. - - 애플리케이션 위임의 `application(_:didFinishLaunchingWithOptions:)` 메소드 또는 프로젝트에 가장 적합한 위치에 초기화 코드를 배치하십시오. - - ```Swift - BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region - ``` - {: codeblock} - - **bluemixRegion** 매개변수를 사용하여 `BMSClient`를 초기화해야 합니다. 초기자(initializer)에서 **bluemixRegion** 값은 사용 중인 {{site.data.keyword.Bluemix_notm}} 배치를 지정합니다(예: `BMSClient.Region.usSouth`, `BMSClient.Region.unitedKingdom` 또는 `BMSClient.Region.sydney`). - - -## Cordova 애플리케이션 초기화 -{: #init-BMSClient-cordova} - -1. Cordova 애플리케이션 루트 디렉토리에서 다음 명령을 실행하여 Cordova 플러그인을 추가하십시오. - - ``` - cordova plugin add bms-core - ``` - {: codeblock} - -2. 기본 JavaScript 파일에서나 프로젝트에 대해 최적으로 작동하는 위치에서 초기화 코드를 추가하여 Cordova 애플리케이션에서 `BMSClient` 클래스를 초기화하십시오. - - ``` - BMSClient.initialize(BMSClient.REGION_US_SOUTH); - ``` - {: codeblock} - - **bluemixRegion** 매개변수를 사용하여 `BMSClient`를 초기화해야 합니다. 초기자(initializer)에서 **bluemixRegion** 값은 사용 중인 {{site.data.keyword.Bluemix_notm}} 배치를 지정합니다(예: `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` 또는 `BMSClient.REGION_SYDNEY`). - - -# 관련 링크 -{: #rellinks notoc} - -## 관련 링크 -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova 플러그인](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# BMSClient 초기화 +{: #sdk_BMSClient} + +`BMSCore`에서는 다른 {{site.data.keyword.Bluemix}} 모바일 서비스 클라이언트 SDK가 이와 연관된 {{site.data.keyword.Bluemix_notm}} 서비스와 통신하는 데 사용하는 HTTP 인프라를 제공합니다. + + +## Android 애플리케이션 초기화 +{: #init-BMSClient-android} + +`BMSCore` 패키지를 다운로드하여 Android Studio 프로젝트로 가져오거나 Gradle을 사용할 수 있습니다. + +1. 다음 `import` 문을 프로젝트 파일의 시작 부분에 추가하여 클라이언트 SDK를 가져오십시오. + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; + ``` + {: codeblock} + +2. Android 애플리케이션의 기본 활동의 `onCreate` 메소드 내 또는 프로젝트에 가장 적합한 위치에 초기화 코드를 추가하여 Android 애플리케이션에서 `BMSClient` SDK를 초기화하십시오. + + ```Java + BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region + ``` + {: codeblock} + + **bluemixRegion** 매개변수를 사용하여 `BMSClient`를 초기화해야 합니다. 초기자(initializer)에서 **bluemixRegion** 값은 사용 중인 {{site.data.keyword.Bluemix_notm}} 배치를 지정합니다(예: `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` 또는 `BMSClient.REGION_SYDNEY`). + + +## iOS 애플리케이션 초기화 +{: #init-BMSClient-ios} + +[CocoaPods](https://cocoapods.org){: new_window} 또는 [Carthage](https://github.com/Carthage/Carthage){: new_window}를 사용하여 `BMSCore` 패키지를 가져올 수 있습니다. + +1. CocoaPods를 사용하여 `BMSCore`를 설치하려면 Podfile에 다음 행을 추가하십시오. 프로젝트에 아직 Podfile이 없으면 `pod init` 명령을 사용하십시오. + + ```Swift + use_frameworks! + + target 'MyApp' do + pod 'BMSCore' + end + ``` + {: codeblock} + + 그런 다음 `pod install` 명령을 실행하고 생성된 `.xcworkspace` 파일을 여십시오. `BMSCore`의 새 릴리스로 업데이트하려면 `pod update BMSCore`를 사용하십시오. + + CocoaPods 사용에 대한 자세한 정보는 [CocoaPods 안내서 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://guides.cocoapods.org/using/index.html){: new_window}를 참조하십시오. + +2. Carthage를 사용하여 `BMSCore`를 설치하려면 다음 [지시사항 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/Carthage/Carthage#getting-started){: new_window}을 따르십시오. + + 1. Cartfile에 다음 행을 추가하십시오. + + ``` + github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" + ``` + {: codeblock} + + 2. `carthage update` 명령을 실행하십시오. + + 3. 빌드가 완료되면 Carthage 지시사항의 [3단계 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/Carthage/Carthage#getting-started)에 따라 `BMSCore.framework`를 프로젝트에 추가하십시오. + + Swift 2.3으로 빌드된 애플리케이션의 경우 `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3` 명령을 사용하십시오. 그 외의 경우에는 `carthage update` 명령을 사용하십시오. + +3. 모듈을 가져오십시오. + + ```Swift + import BMSCore + ``` + {: codeblock} + +4. 다음 코드를 사용하여 `BMSClient` 클래스를 초기화하십시오. + + 애플리케이션 위임의 `application(_:didFinishLaunchingWithOptions:)` 메소드 또는 프로젝트에 가장 적합한 위치에 초기화 코드를 배치하십시오. + + ```Swift + BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region + ``` + {: codeblock} + + **bluemixRegion** 매개변수를 사용하여 `BMSClient`를 초기화해야 합니다. 초기자(initializer)에서 **bluemixRegion** 값은 사용 중인 {{site.data.keyword.Bluemix_notm}} 배치를 지정합니다(예: `BMSClient.Region.usSouth`, `BMSClient.Region.unitedKingdom` 또는 `BMSClient.Region.sydney`). + + +## Cordova 애플리케이션 초기화 +{: #init-BMSClient-cordova} + +1. Cordova 애플리케이션 루트 디렉토리에서 다음 명령을 실행하여 Cordova 플러그인을 추가하십시오. + + ``` + cordova plugin add bms-core + ``` + {: codeblock} + +2. 기본 JavaScript 파일에서나 프로젝트에 대해 최적으로 작동하는 위치에서 초기화 코드를 추가하여 Cordova 애플리케이션에서 `BMSClient` 클래스를 초기화하십시오. + + ``` + BMSClient.initialize(BMSClient.REGION_US_SOUTH); + ``` + {: codeblock} + + **bluemixRegion** 매개변수를 사용하여 `BMSClient`를 초기화해야 합니다. 초기자(initializer)에서 **bluemixRegion** 값은 사용 중인 {{site.data.keyword.Bluemix_notm}} 배치를 지정합니다(예: `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` 또는 `BMSClient.REGION_SYDNEY`). + + +# 관련 링크 +{: #rellinks notoc} + +## 관련 링크 +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova 플러그인](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/ko/sdk_cli.md b/cloudnative/nl/ko/sdk_cli.md index 160363641..9e59519f6 100644 --- a/cloudnative/nl/ko/sdk_cli.md +++ b/cloudnative/nl/ko/sdk_cli.md @@ -1,178 +1,178 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# SDK Generator 플러그인 -{: #sdk-cli} - -{{site.data.keyword.IBM}} SDK Generator 플러그인은 [{{site.data.keyword.Bluemix_notm}} CLI ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/cli/reference/bluemix_cli/index.html)에서 설치할 수 있습니다. - -{{site.data.keyword.Bluemix_notm}}의 개발자는 이 플러그인을 사용하여 [Open API 스펙 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.openapis.org/)을 준수하는 REST API 정의에서 SDK를 생성할 수 있습니다. REST API 정의에 대한 변경사항을 작성하는 경우, 전체 프로젝트를 재생성하는 대신 이 플러그인을 사용하여 SDK만 재생성할 수 있습니다. - -또한 지정된 영역의 Cloud Foundry 앱에 SDK 생성에 유효한 REST API 정의가 있는지도 확인할 수 있습니다. 마지막으로, {{site.data.keyword.IBM_notm}} SDK Generator 플러그인으로 REST API 정의의 유효성을 검증하여 해당 REST API가 SDK 생성기의 요구사항에 부합하는지 확인할 수 있습니다. - -이 {{site.data.keyword.IBM_notm}} SDK Generator 플러그인을 사용할 경우, 생성된 SDK를 통해 백엔드 서비스를 앱으로 쉽게 통합할 수 있습니다. REST API에 대한 변경사항이 발생하면 SDK를 재생성하고 이를 이전 SDK와 대체하여 원할하게 SDK를 업그레이드할 수 있습니다. 또한 CLI를 DevOps 파이프라인에 통합할 수 있으며 앱이 빌드될 때마다 SDK가 항상 API 스펙과 일치하도록 할 수 있습니다. - -REST API 정의는 유효해야 하며 라이브 서버 엔드포인트에서 호스팅되거나 사용자 시스템의 로컬 파일이어야 합니다. REST API 정의가 호스팅되는 경우 상대 URL은 `OPENAPI_SPEC` 환경 변수에 정의되어야 합니다. - - -## 요구사항 -{: #prereqs} - -다음 요구사항을 충족하는지 확인하십시오. - -* [{{site.data.keyword.Bluemix_notm}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://bluemix.net) 계정 소유 -* [Open API ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.openapis.org/) 스펙을 준수하는 유효한 API 정의 - - -## 설치 -{: #installation} - -1. [{{site.data.keyword.Bluemix}} CLI ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://clis.ng.bluemix.net/ui/home.html)를 설치하십시오. - -2. [플러그인 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in)을 설치하십시오. - - ``` - bx plugin install sdk-gen -r Bluemix - ``` - {: codeblock} - - -## 명령 -{: #commands} - -다음 명령을 사용하여 SDK를 생성하거나 Open API 정의 파일의 유효성을 검증하거나 Cloud Foundry 앱을 나열하십시오. - - -### SDK 생성 -{: #gen} - -`bluemix sdk generate [arguments...][command options]`를 사용하십시오. - - -#### 인수 -{: #gen-args} - -* `APP_NAME` - 현재 영역에 있는 Cloud Foundry 앱의 이름 -* `OPENAPI_DOC_LOCATION` - 원시 REST API 정의 JSON 또는 Yaml에 대한 URL 또는 상대 파일 경로 -* `GENERATED_SDK_NAME`(선택사항) - 생성된 SDK의 이름 - - -#### 옵션 -{: #gen-options} - -* `PLATFORM`(필수) - * `--android` - Android SDK 생성 - * `--ios` - iOS Swift SDK 생성 - * `--swift` - Swift 서버 SDK 생성 -* `--output "YOUR_RELATIVE_PATH"`(선택사항) - 생성된 SDK를 `YOUR_RELATIVE_PATH`에서 지정한 디렉토리에 배치(기존의 SDK가 있는 경우 겹쳐씀) -* `--unzip`(선택사항) - 생성된 SDK 추출(기존의 SDK 아티팩트가 있는 경우 겹쳐씀) - - -#### 사용법 -{: #gen-usage} - -{{site.data.keyword.Bluemix_notm}}에서 실행 중인 Cloud Foundry에서 SDK를 생성하기 위해 CLI에 대한 매개변수로 앱의 이름을 사용할 수 있습니다. 다음 명령은 앱의 이름을 `SDK_Name`으로 사용합니다. - -``` -bluemix sdk generate [APP_NAME] [PLATFORM] -``` -{: codeblock} - -로컬 JSON 또는 Yaml 파일이나 Open API 정의 파일에 대한 URL에서 SDK를 생성하려면 다음 명령을 사용하십시오. - -``` -bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] -``` -{: codeblock} - - -### Open API 정의 유효성 검증 -{: #validating} - -`bluemix sdk validate [argument]`를 사용하십시오. - - -#### 인수 -{: #val-args} - -* `APP_NAME` - 현재 영역에 있는 Cloud Foundry 앱의 이름 -* `OPENAPI_DOC_LOCATION` - 원시 REST API 정의 JSON 또는 Yaml에 대한 URL 또는 상대 파일 경로 - - -#### 사용법 -{: #val-usage} - -{{site.data.keyword.Bluemix_notm}}에서 실행 중인 Cloud Foundry 앱의 API 스펙의 유효성을 검증하기 위해 CLI에 대한 매개변수로 앱의 이름을 사용할 수 있습니다. - -``` -bluemix sdk validate [APP_NAME] -``` -{: codeblock} - -로컬 JSON 또는 Yaml 파일이나 API 스펙 문서에 대한 URL의 SDK 유효성을 검증하려면 다음 명령을 사용하십시오. - -``` -bluemix sdk validate [OPENAPI_DOC_LOCATION] -``` -{: codeblock} - - - -### 앱 나열(Cloud Foundry) -{: #list-apps} - -`bluemix sdk list [argument][option]`를 사용하여 앱을 나열하고 API 스펙의 유효성을 검증하십시오. `OPENAPI_SPEC` 환경 변수가 스펙을 호스팅하는 상대 URL로 설정되어 있어야 합니다. - - -#### 인수 -{: #list-args} - -* `SPACE_NAME`(선택사항) - 앱을 검색하려는 현재 조직 내에 있는 Cloud Foundry 영역의 이름. 제공되지 않는 경우 현재 영역이 검색됩니다. - - -#### 옵션 -{: #list-options} - -* `--url`(선택사항) - 목록에서 각 앱의 Open API 정의에 대한 완전한 URL을 표시 - - -#### 사용법 -{: #list-usage} - -현재 영역에 있는 앱을 나열하려면 다음 명령을 사용하십시오. - -``` -bluemix sdk list -``` -{: codeblock} - -현재 영역에 있는 앱을 나열하고 API 스펙 URL을 표시하려면 다음 명령을 사용하십시오. - -``` -bluemix sdk list --url -``` -{: codeblock} - -특정 영역에 있는 앱을 나열하려면 다음 명령을 사용하십시오. - -``` -bluemix sdk list [SPACE_NAME] -``` -{: codeblock} - -특정 영역에 있는 앱을 나열하고 API 스펙 URL을 표시하려면 다음 명령을 사용하십시오. - -``` -bluemix sdk list [SPACE_NAME] --url -``` -{: codeblock} +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# SDK Generator 플러그인 +{: #sdk-cli} + +{{site.data.keyword.IBM}} SDK Generator 플러그인은 [{{site.data.keyword.Bluemix_notm}} CLI ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/cli/reference/bluemix_cli/index.html)에서 설치할 수 있습니다. + +{{site.data.keyword.Bluemix_notm}}의 개발자는 이 플러그인을 사용하여 [Open API 스펙 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.openapis.org/)을 준수하는 REST API 정의에서 SDK를 생성할 수 있습니다. REST API 정의에 대한 변경사항을 작성하는 경우, 전체 프로젝트를 재생성하는 대신 이 플러그인을 사용하여 SDK만 재생성할 수 있습니다. + +또한 지정된 영역의 Cloud Foundry 앱에 SDK 생성에 유효한 REST API 정의가 있는지도 확인할 수 있습니다. 마지막으로, {{site.data.keyword.IBM_notm}} SDK Generator 플러그인으로 REST API 정의의 유효성을 검증하여 해당 REST API가 SDK 생성기의 요구사항에 부합하는지 확인할 수 있습니다. + +이 {{site.data.keyword.IBM_notm}} SDK Generator 플러그인을 사용할 경우, 생성된 SDK를 통해 백엔드 서비스를 앱으로 쉽게 통합할 수 있습니다. REST API에 대한 변경사항이 발생하면 SDK를 재생성하고 이를 이전 SDK와 대체하여 원할하게 SDK를 업그레이드할 수 있습니다. 또한 CLI를 DevOps 파이프라인에 통합할 수 있으며 앱이 빌드될 때마다 SDK가 항상 API 스펙과 일치하도록 할 수 있습니다. + +REST API 정의는 유효해야 하며 라이브 서버 엔드포인트에서 호스팅되거나 사용자 시스템의 로컬 파일이어야 합니다. REST API 정의가 호스팅되는 경우 상대 URL은 `OPENAPI_SPEC` 환경 변수에 정의되어야 합니다. + + +## 요구사항 +{: #prereqs} + +다음 요구사항을 충족하는지 확인하십시오. + +* [{{site.data.keyword.Bluemix_notm}} ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://bluemix.net) 계정 소유 +* [Open API ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.openapis.org/) 스펙을 준수하는 유효한 API 정의 + + +## 설치 +{: #installation} + +1. [{{site.data.keyword.Bluemix}} CLI ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://clis.ng.bluemix.net/ui/home.html)를 설치하십시오. + +2. [플러그인 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in)을 설치하십시오. + + ``` + bx plugin install sdk-gen -r Bluemix + ``` + {: codeblock} + + +## 명령 +{: #commands} + +다음 명령을 사용하여 SDK를 생성하거나 Open API 정의 파일의 유효성을 검증하거나 Cloud Foundry 앱을 나열하십시오. + + +### SDK 생성 +{: #gen} + +`bluemix sdk generate [arguments...][command options]`를 사용하십시오. + + +#### 인수 +{: #gen-args} + +* `APP_NAME` - 현재 영역에 있는 Cloud Foundry 앱의 이름 +* `OPENAPI_DOC_LOCATION` - 원시 REST API 정의 JSON 또는 Yaml에 대한 URL 또는 상대 파일 경로 +* `GENERATED_SDK_NAME`(선택사항) - 생성된 SDK의 이름 + + +#### 옵션 +{: #gen-options} + +* `PLATFORM`(필수) + * `--android` - Android SDK 생성 + * `--ios` - iOS Swift SDK 생성 + * `--swift` - Swift 서버 SDK 생성 +* `--output "YOUR_RELATIVE_PATH"`(선택사항) - 생성된 SDK를 `YOUR_RELATIVE_PATH`에서 지정한 디렉토리에 배치(기존의 SDK가 있는 경우 겹쳐씀) +* `--unzip`(선택사항) - 생성된 SDK 추출(기존의 SDK 아티팩트가 있는 경우 겹쳐씀) + + +#### 사용법 +{: #gen-usage} + +{{site.data.keyword.Bluemix_notm}}에서 실행 중인 Cloud Foundry에서 SDK를 생성하기 위해 CLI에 대한 매개변수로 앱의 이름을 사용할 수 있습니다. 다음 명령은 앱의 이름을 `SDK_Name`으로 사용합니다. + +``` +bluemix sdk generate [APP_NAME] [PLATFORM] +``` +{: codeblock} + +로컬 JSON 또는 Yaml 파일이나 Open API 정의 파일에 대한 URL에서 SDK를 생성하려면 다음 명령을 사용하십시오. + +``` +bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] +``` +{: codeblock} + + +### Open API 정의 유효성 검증 +{: #validating} + +`bluemix sdk validate [argument]`를 사용하십시오. + + +#### 인수 +{: #val-args} + +* `APP_NAME` - 현재 영역에 있는 Cloud Foundry 앱의 이름 +* `OPENAPI_DOC_LOCATION` - 원시 REST API 정의 JSON 또는 Yaml에 대한 URL 또는 상대 파일 경로 + + +#### 사용법 +{: #val-usage} + +{{site.data.keyword.Bluemix_notm}}에서 실행 중인 Cloud Foundry 앱의 API 스펙의 유효성을 검증하기 위해 CLI에 대한 매개변수로 앱의 이름을 사용할 수 있습니다. + +``` +bluemix sdk validate [APP_NAME] +``` +{: codeblock} + +로컬 JSON 또는 Yaml 파일이나 API 스펙 문서에 대한 URL의 SDK 유효성을 검증하려면 다음 명령을 사용하십시오. + +``` +bluemix sdk validate [OPENAPI_DOC_LOCATION] +``` +{: codeblock} + + + +### 앱 나열(Cloud Foundry) +{: #list-apps} + +`bluemix sdk list [argument][option]`를 사용하여 앱을 나열하고 API 스펙의 유효성을 검증하십시오. `OPENAPI_SPEC` 환경 변수가 스펙을 호스팅하는 상대 URL로 설정되어 있어야 합니다. + + +#### 인수 +{: #list-args} + +* `SPACE_NAME`(선택사항) - 앱을 검색하려는 현재 조직 내에 있는 Cloud Foundry 영역의 이름. 제공되지 않는 경우 현재 영역이 검색됩니다. + + +#### 옵션 +{: #list-options} + +* `--url`(선택사항) - 목록에서 각 앱의 Open API 정의에 대한 완전한 URL을 표시 + + +#### 사용법 +{: #list-usage} + +현재 영역에 있는 앱을 나열하려면 다음 명령을 사용하십시오. + +``` +bluemix sdk list +``` +{: codeblock} + +현재 영역에 있는 앱을 나열하고 API 스펙 URL을 표시하려면 다음 명령을 사용하십시오. + +``` +bluemix sdk list --url +``` +{: codeblock} + +특정 영역에 있는 앱을 나열하려면 다음 명령을 사용하십시오. + +``` +bluemix sdk list [SPACE_NAME] +``` +{: codeblock} + +특정 영역에 있는 앱을 나열하고 API 스펙 URL을 표시하려면 다음 명령을 사용하십시오. + +``` +bluemix sdk list [SPACE_NAME] --url +``` +{: codeblock} diff --git a/cloudnative/nl/ko/sdk_network_request.md b/cloudnative/nl/ko/sdk_network_request.md index c6d4f515b..c0a5ac8ec 100644 --- a/cloudnative/nl/ko/sdk_network_request.md +++ b/cloudnative/nl/ko/sdk_network_request.md @@ -1,121 +1,121 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 네트워크 요청 작성 -{: #sdk-network-request} - -또한 자원에 대한 네트워크 요청을 작성하기 위해 `BMSCore` SDK를 사용할 수도 있습니다. - -## Android -{: #request-android} - -1. Android 애플리케이션에서 [클라이언트 SDK를 가져오고 이를 초기화](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android)했는지 확인하십시오. - -2. 네트워크 요청을 작성하십시오. - - ``` - public void makeGetCall() { - Thread thread = new Thread(new Runnable() { - @Override - public void run() { - try { - Request request = new Request("http://httpbin.org/get", "GET"); - request.send(null, null); - } catch (Exception e) { - // Handle failure here. - } - } - }); - thread.start(); - } - ``` - {: codeblock} - -## iOS -{: #request-ios} - -1. iOS 애플리케이션에서 [클라이언트 SDK를 가져오고 이를 초기화](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios)했는지 확인하십시오. - -2. 네트워크 요청을 작성하십시오. - - ### Swift 3.0 - {: #ios-swift3 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - - ### Swift 2.2 - {: #ios-swift22 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - -`Request` 클래스는 요청을 작성하고 요청이 완료된 후에 응답을 가져오는 간단한 방법입니다. `Request` 클래스보다 더 많은 유연성과 제어 기능을 원하는 경우, `BMSURLSession` 클래스를 사용할 수 있습니다. `BMSURLSession` 클래스의 일부 기능으로는 업로드 프로세스 모니터링과 요청 일시정지 또는 취소가 있습니다. 응답을 가져오는 옵션으로 완료 핸들러 또는 위임 중 하나를 선택할 수 있습니다. - -`BMSURLSession` 클래스는 iOS용으로만 사용 가능합니다. `BMSURLSession`에 대한 자세한 정보는 `BMSCore` SDK [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core)를 참조하십시오. - - -## Cordova -{: #request-cordova} - -1. Cordova 애플리케이션에서 [클라이언트 SDK를 가져오고 이를 초기화](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova)했는지 확인하십시오. - -2. 네트워크 요청을 작성하십시오. - - ``` - var success = function(data) { - console.log("success", data); - } - var failure = function(error) - {console.log("failure", error); - } - var request = new BMSRequest("", BMSRequest.GET); - request.send(success, failure); - ``` - {: codeblock} - - -# 관련 링크 -{: #rellinks notoc} - -## 관련 링크 -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova 플러그인](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 네트워크 요청 작성 +{: #sdk-network-request} + +또한 자원에 대한 네트워크 요청을 작성하기 위해 `BMSCore` SDK를 사용할 수도 있습니다. + +## Android +{: #request-android} + +1. Android 애플리케이션에서 [클라이언트 SDK를 가져오고 이를 초기화](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android)했는지 확인하십시오. + +2. 네트워크 요청을 작성하십시오. + + ``` + public void makeGetCall() { + Thread thread = new Thread(new Runnable() { + @Override + public void run() { + try { + Request request = new Request("http://httpbin.org/get", "GET"); + request.send(null, null); + } catch (Exception e) { + // Handle failure here. + } + } + }); + thread.start(); + } + ``` + {: codeblock} + +## iOS +{: #request-ios} + +1. iOS 애플리케이션에서 [클라이언트 SDK를 가져오고 이를 초기화](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios)했는지 확인하십시오. + +2. 네트워크 요청을 작성하십시오. + + ### Swift 3.0 + {: #ios-swift3 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + + ### Swift 2.2 + {: #ios-swift22 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + +`Request` 클래스는 요청을 작성하고 요청이 완료된 후에 응답을 가져오는 간단한 방법입니다. `Request` 클래스보다 더 많은 유연성과 제어 기능을 원하는 경우, `BMSURLSession` 클래스를 사용할 수 있습니다. `BMSURLSession` 클래스의 일부 기능으로는 업로드 프로세스 모니터링과 요청 일시정지 또는 취소가 있습니다. 응답을 가져오는 옵션으로 완료 핸들러 또는 위임 중 하나를 선택할 수 있습니다. + +`BMSURLSession` 클래스는 iOS용으로만 사용 가능합니다. `BMSURLSession`에 대한 자세한 정보는 `BMSCore` SDK [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core)를 참조하십시오. + + +## Cordova +{: #request-cordova} + +1. Cordova 애플리케이션에서 [클라이언트 SDK를 가져오고 이를 초기화](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova)했는지 확인하십시오. + +2. 네트워크 요청을 작성하십시오. + + ``` + var success = function(data) { + console.log("success", data); + } + var failure = function(error) + {console.log("failure", error); + } + var request = new BMSRequest("", BMSRequest.GET); + request.send(success, failure); + ``` + {: codeblock} + + +# 관련 링크 +{: #rellinks notoc} + +## 관련 링크 +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova 플러그인](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/ko/services.md b/cloudnative/nl/ko/services.md index ed54d2406..b00825d61 100644 --- a/cloudnative/nl/ko/services.md +++ b/cloudnative/nl/ko/services.md @@ -1,54 +1,54 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# 서비스 -{: #services} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} **서비스** 페이지에서 기존 웹 및 모바일 서비스를 보거나 새 서비스를 작성할 수 있습니다. 콘솔은 프로젝트에서 관리 중인 모든 {{site.data.keyword.Bluemix_notm}} 웹 및 모바일 서비스를 한 곳에서 볼 수 있게 해 줍니다. - -**서비스** 보기에서 서비스를 삭제하는 경우 서비스와 연관된 프로젝트에서 서비스 연결을 끊습니다. 프로젝트에 서비스를 다시 연결하려면 새 서비스 인스턴스를 작성하십시오. - -## {{site.data.keyword.Bluemix_notm}} 웹 및 모바일 서비스 개요 -{: #mobile_services_overview} - -다음 표는 {{site.data.keyword.Bluemix_notm}} 웹 및 모바일 서비스를 나타냅니다. {{site.data.keyword.Bluemix_notm}} 카탈로그에서 개별 서비스를 사용하거나, 서비스를 프로젝트에 통합할 수 있습니다. - - - - - - - - - - - - - - - - - - - -
표 1. {{site.data.keyword.Bluemix_notm}} 웹 및 모바일 서비스
{{site.data.keyword.Bluemix_notm}} 웹 및 모바일 서비스설명
{{site.data.keyword.mobileanalytics_short}} 아이콘
{{site.data.keyword.mobileanalytics_short}}		{{site.data.keyword.mobileanalytics_full}} 서비스를 사용하여 모바일 앱의 성능과 사용 방법에 대한 인사이트를 얻을 수 있습니다.

-이 서비스 운영에 대한 자세한 정보는 {{site.data.keyword.mobileanalytics_short}} 문서를 살펴보십시오. -
{{site.data.keyword.mobilefoundation_short}} 서비스 아이콘
{{site.data.keyword.mobilefoundation_short}}		{{site.data.keyword.mobilefoundation_long}} 서비스를 사용하여 엔터프라이즈 모바일 앱을 개발하고, 테스트하고, 운영할 수 있는 {{site.data.keyword.mfp_full}} 환경을 신속하게 설정할 수 있습니다.

-이 서비스 운영에 대한 자세한 정보는 {{site.data.keyword.mobilefoundation_short}} 문서를 살펴보십시오.
{{site.data.keyword.mobilepushshort}} 서비스 아이콘
{{site.data.keyword.mobilepushshort}}		{{site.data.keyword.mobilepushfull}} 서비스는 플랫폼 간에 대상 지정된 모바일 및 웹 푸시 알림을 전송하고 관리하기 위한 통합 플랫폼을 제공합니다. -

-{{site.data.keyword.mobilepushshort}}에서는 디바이스, 디바이스 플랫폼, 웹 브라우저에 대한 애플리케이션 사용자의 맵핑을 관리하고, 이에 대한 푸시 알림을 디스패치하는 작업을 처리합니다. 모바일 및 웹 브라우저 애플리케이션 사용자에게 브로드캐스트, 유니캐스트(디바이스 ID 및 사용자 ID 기반), 태그(또는 주제)를 푸시 알림으로 보낼 수 있습니다. 또한 SDK 및 REST API를 사용하여 클라이언트 애플리케이션을 추가로 개발할 수도 있습니다. -

-이 서비스 운영에 대한 자세한 정보는 {{site.data.keyword.mobilepushshort}} 문서를 살펴보십시오.
+--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# 서비스 +{: #services} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} **서비스** 페이지에서 기존 웹 및 모바일 서비스를 보거나 새 서비스를 작성할 수 있습니다. 콘솔은 프로젝트에서 관리 중인 모든 {{site.data.keyword.Bluemix_notm}} 웹 및 모바일 서비스를 한 곳에서 볼 수 있게 해 줍니다. + +**서비스** 보기에서 서비스를 삭제하는 경우 서비스와 연관된 프로젝트에서 서비스 연결을 끊습니다. 프로젝트에 서비스를 다시 연결하려면 새 서비스 인스턴스를 작성하십시오. + +## {{site.data.keyword.Bluemix_notm}} 웹 및 모바일 서비스 개요 +{: #mobile_services_overview} + +다음 표는 {{site.data.keyword.Bluemix_notm}} 웹 및 모바일 서비스를 나타냅니다. {{site.data.keyword.Bluemix_notm}} 카탈로그에서 개별 서비스를 사용하거나, 서비스를 프로젝트에 통합할 수 있습니다. + + + + + + + + + + + + + + + + + + + +
표 1. {{site.data.keyword.Bluemix_notm}} 웹 및 모바일 서비스
{{site.data.keyword.Bluemix_notm}} 웹 및 모바일 서비스설명
{{site.data.keyword.mobileanalytics_short}} 아이콘
{{site.data.keyword.mobileanalytics_short}}		{{site.data.keyword.mobileanalytics_full}} 서비스를 사용하여 모바일 앱의 성능과 사용 방법에 대한 인사이트를 얻을 수 있습니다.

+이 서비스 운영에 대한 자세한 정보는 {{site.data.keyword.mobileanalytics_short}} 문서를 살펴보십시오. +
{{site.data.keyword.mobilefoundation_short}} 서비스 아이콘
{{site.data.keyword.mobilefoundation_short}}		{{site.data.keyword.mobilefoundation_long}} 서비스를 사용하여 엔터프라이즈 모바일 앱을 개발하고, 테스트하고, 운영할 수 있는 {{site.data.keyword.mfp_full}} 환경을 신속하게 설정할 수 있습니다.

+이 서비스 운영에 대한 자세한 정보는 {{site.data.keyword.mobilefoundation_short}} 문서를 살펴보십시오.
{{site.data.keyword.mobilepushshort}} 서비스 아이콘
{{site.data.keyword.mobilepushshort}}		{{site.data.keyword.mobilepushfull}} 서비스는 플랫폼 간에 대상 지정된 모바일 및 웹 푸시 알림을 전송하고 관리하기 위한 통합 플랫폼을 제공합니다. +

+{{site.data.keyword.mobilepushshort}}에서는 디바이스, 디바이스 플랫폼, 웹 브라우저에 대한 애플리케이션 사용자의 맵핑을 관리하고, 이에 대한 푸시 알림을 디스패치하는 작업을 처리합니다. 모바일 및 웹 브라우저 애플리케이션 사용자에게 브로드캐스트, 유니캐스트(디바이스 ID 및 사용자 ID 기반), 태그(또는 주제)를 푸시 알림으로 보낼 수 있습니다. 또한 SDK 및 REST API를 사용하여 클라이언트 애플리케이션을 추가로 개발할 수도 있습니다. +

+이 서비스 운영에 대한 자세한 정보는 {{site.data.keyword.mobilepushshort}} 문서를 살펴보십시오.
diff --git a/cloudnative/nl/ko/starters.md b/cloudnative/nl/ko/starters.md index 2b894d5e1..75519f0c9 100644 --- a/cloudnative/nl/ko/starters.md +++ b/cloudnative/nl/ko/starters.md @@ -1,26 +1,26 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 스타터 -{: #starters} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}을 사용하면 각 패턴 유형에 대해 다양한 스타터를 선택할 수 있습니다. - -스타터는 고가치 서비스와 {{site.data.keyword.Bluemix_notm}}의 주요 통합을 보여주는 데 초점을 맞춘, 프로덕션 준비가 완료된 스타터 코드로서 최적화되어 있습니다. 각 스타터는 하나의 서비스에 초점을 맞추고 코드에 대한 서비스 SDK의 통합을 표시합니다. 스타터에서 서비스 데이터의 통합 또는 사용자와의 상호작용을 강조하는 단순 사용자 경험을 제공하는 경우도 있습니다. 각 스타터는 사용자가 인증, 데이터 및 기타 기능을 프로젝트에 구성하고자 하는 경우 이를 사용할 수 있도록 구성됩니다. - - -## 튜토리얼 -{: #tutorials notoc} - -스타터를 사용하여 앱을 작성하는 방법에 대한 자세한 지시사항을 알아보려는 경우에는 엔드-투-엔드 [튜토리얼](tutorials.html)을 참조할 수 있습니다. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 스타터 +{: #starters} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}을 사용하면 각 패턴 유형에 대해 다양한 스타터를 선택할 수 있습니다. + +스타터는 고가치 서비스와 {{site.data.keyword.Bluemix_notm}}의 주요 통합을 보여주는 데 초점을 맞춘, 프로덕션 준비가 완료된 스타터 코드로서 최적화되어 있습니다. 각 스타터는 하나의 서비스에 초점을 맞추고 코드에 대한 서비스 SDK의 통합을 표시합니다. 스타터에서 서비스 데이터의 통합 또는 사용자와의 상호작용을 강조하는 단순 사용자 경험을 제공하는 경우도 있습니다. 각 스타터는 사용자가 인증, 데이터 및 기타 기능을 프로젝트에 구성하고자 하는 경우 이를 사용할 수 있도록 구성됩니다. + + +## 튜토리얼 +{: #tutorials notoc} + +스타터를 사용하여 앱을 작성하는 방법에 대한 자세한 지시사항을 알아보려는 경우에는 엔드-투-엔드 [튜토리얼](tutorials.html)을 참조할 수 있습니다. diff --git a/cloudnative/nl/ko/troubleshoot.md b/cloudnative/nl/ko/troubleshoot.md index 65992b35c..763fe9688 100644 --- a/cloudnative/nl/ko/troubleshoot.md +++ b/cloudnative/nl/ko/troubleshoot.md @@ -1,223 +1,223 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 문제점 해결 -{: #ts} - -{{site.data.keyword.dev_cli_notm}}의 몇 가지 알려진 문제가 임시 해결책과 함께 기록되어 있습니다. -{:shortdesc} - - - -## 알려진 문제 -{: #knownissues} - -다음 절에는 알려진 문제와 가능한 해결책이 설명되어 있습니다. - - -### 비모바일 패턴을 사용하여 프로젝트를 작성하는 중에 hostname is taken 오류 발생 -{: #hostname} - -웹 앱, BFF 또는 마이크로서비스 패턴으로부터 프로젝트를 작성하는 데 {{site.data.keyword.dev_cli_short}}을 사용하는 경우 다음 오류가 표시될 수 있습니다. - -``` -The hostname is taken. -``` -{: codeblock} - - -#### 원인 -{: #hostname-cause} - -이 오류는 만료된 로그인 토큰으로 인해 발생합니다. - - -#### 해결 -{: #hostname-resolution} - -다시 로그인하십시오. - -``` -bx login -``` -{: codeblock} - - -### {{site.data.keyword.dev_cli_short}}의 일반적 실패 -{: #general} - -{{site.data.keyword.dev_cli_short}} create, delete, list 또는 code 명령을 사용하는 경우 다음 오류가 표시될 수 있습니다. - -``` -Failed to project. -``` -{: codeblock} - - -#### 원인 -{: #hostname-cause} - -이 오류는 만료된 로그인 토큰으로 인해 발생합니다. - - -#### 해결 -{: #hostname-resolution} - -다시 로그인하십시오. - -``` -bx login -``` -{: codeblock} - - -### {{site.data.keyword.objectstorageshort}} 기능 추가 중 서비스 브로커 오류 발생 -{: #os} - -{{site.data.keyword.objectstorageshort}} 기능이 있는 두 프로젝트를 작성하는 데 {{site.data.keyword.dev_cli_short}}을 사용하는 경우 다음 오류가 표시될 수 있습니다. - -``` -FAILED -Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} -``` -{: codeblock} - - -#### 원인 -{: #os-cause} - -이 오류는 하나의 {{site.data.keyword.objectstorageshort}} 무료 플랜 인스턴스만을 허용하는 {{site.data.keyword.objectstorageshort}} 서비스로 인해 발생합니다. - - -#### 해결 -{: #os-resolution} - -이 오류를 방지하기 위해 다른 플랜을 선택하라는 프롬프트가 표시됩니다. - - -### 프로젝트 작성 중 코드 가져오기 실패 -{: #code} - -프로젝트를 작성하는 데 {{site.data.keyword.dev_cli_short}}을 사용하는 경우 다음 오류가 표시될 수 있습니다. - -``` -FAILED -Project created, but could not get code -https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code -``` -{: codeblock} - - -#### 원인 -{: #code-cause} - -이 오류는 내부 제한시간 초과로 인해 발생합니다. - - -#### 해결 -{: #code-resolution} - -다음 방법 중 하나를 사용하여 코드를 가져올 수 있습니다. - -* CLI를 사용하여 다음 명령을 실행합니다. - - ``` - bx dev code - ``` - {: codeblock} - - ``은 프로젝트 작성 중에 사용한 프로젝트 이름으로 대체해야 합니다. - -* {{site.data.keyword.dev_console}}을 사용합니다. - - 1. {{site.data.keyword.dev_console}}에서 [프로젝트 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.{DomainName}/developer/projects)를 선택하고 **코드 가져오기**를 클릭하십시오. - - 2. **코드 생성**을 클릭하십시오. - - 3. 코드가 생성되면 **코드 다운로드**를 클릭하십시오. - - -### Node.js 프로젝트에 대한 `bx dev run` 실행 오류 -{: #node} - -Node.js Web 또는 BFF 프로젝트의 {{site.data.keyword.dev_cli_short}}에 대해 `bx dev run`을 실행하는 경우 다음 오류가 표시될 수 있습니다. - -``` -module.js:597 - return process.dlopen(module, path._makeLong(filename)); - ^ - -Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header - at Error (native) - at Object.Module._extensions..node (module.js:597:18) - at Module.load (module.js:487:32) - at tryModuleLoad (module.js:446:12) - - at Function.Module._load (module.js:438:3) - at Module.require (module.js:497:17) - at require (internal/module.js:20:19) - at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) - at Module._compile (module.js:570:32) - at Object.Module._extensions..js (module.js:579:10) -``` -{: codeblock} - - -#### 원인 -{: #node-cause} - -이 오류는 `appmetrics` 모듈이 다른 아키텍처에 설치되어 발생합니다. 한 아키텍처에 설치된 네이티브 npm 모듈은 다른 아키텍처에서 작동하지 않습니다. 포함된 Docker 이미지는 Linux 커널을 기반으로 합니다. - - -#### 해결 -{: #node-resolution} - -`node_modules` 폴더를 삭제하고 `bx dev run`을 다시 실행하십시오. - - - - - - - -## 도움 및 지원 받기 -{: #gettinghelp} - -{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 또는 {{site.data.keyword.dev_cli_notm}} 사용 중에 문제점이 있거나 질문이 있는 경우에는 정보를 검색하거나 포럼에 질문하여 도움을 받을 수 있습니다. 또는 지원 티켓을 열 수도 있습니다. - -포럼을 통해 질문하는 경우 {{site.data.keyword.Bluemix_notm}} 개발 팀이 볼 수 있도록 질문에 태그를 지정하십시오. - - - -{{site.data.keyword.dev_console}} 또는 {{site.data.keyword.dev_cli_notm}}을 사용하여 앱을 개발하거나 배치하는 데 대한 기술 관련 질문이 있는 경우: - -* 질문을 [Stack Overflow ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix)에 게시하고 질문에 `bluemix-dev-services` 및 `ibm-bluemix` 태그를 지정하십시오. -* 질문을 [Slack ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://ibm-cloud-tech.slack.com/)의 `bluemix-dev-services` 채널에 게시하십시오. [지금 등록 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://ibm.biz/IBMCloudNativeSlack)하십시오. - - - - - -포럼 사용에 대한 세부사항은 [도움 받기 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/support/index.html#getting-help)를 참조하십시오. - -{{site.data.keyword.IBM}} 지원 티켓 열기, 또는 지원 레벨 및 티켓 심각도에 대한 정보는 [지원 문의 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/support/index.html#contacting-support)를 참조하십시오. - - - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 문제점 해결 +{: #ts} + +{{site.data.keyword.dev_cli_notm}}의 몇 가지 알려진 문제가 임시 해결책과 함께 기록되어 있습니다. +{:shortdesc} + + + +## 알려진 문제 +{: #knownissues} + +다음 절에는 알려진 문제와 가능한 해결책이 설명되어 있습니다. + + +### 비모바일 패턴을 사용하여 프로젝트를 작성하는 중에 hostname is taken 오류 발생 +{: #hostname} + +웹 앱, BFF 또는 마이크로서비스 패턴으로부터 프로젝트를 작성하는 데 {{site.data.keyword.dev_cli_short}}을 사용하는 경우 다음 오류가 표시될 수 있습니다. + +``` +The hostname is taken. +``` +{: codeblock} + + +#### 원인 +{: #hostname-cause} + +이 오류는 만료된 로그인 토큰으로 인해 발생합니다. + + +#### 해결 +{: #hostname-resolution} + +다시 로그인하십시오. + +``` +bx login +``` +{: codeblock} + + +### {{site.data.keyword.dev_cli_short}}의 일반적 실패 +{: #general} + +{{site.data.keyword.dev_cli_short}} create, delete, list 또는 code 명령을 사용하는 경우 다음 오류가 표시될 수 있습니다. + +``` +Failed to project. +``` +{: codeblock} + + +#### 원인 +{: #hostname-cause} + +이 오류는 만료된 로그인 토큰으로 인해 발생합니다. + + +#### 해결 +{: #hostname-resolution} + +다시 로그인하십시오. + +``` +bx login +``` +{: codeblock} + + +### {{site.data.keyword.objectstorageshort}} 기능 추가 중 서비스 브로커 오류 발생 +{: #os} + +{{site.data.keyword.objectstorageshort}} 기능이 있는 두 프로젝트를 작성하는 데 {{site.data.keyword.dev_cli_short}}을 사용하는 경우 다음 오류가 표시될 수 있습니다. + +``` +FAILED +Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} +``` +{: codeblock} + + +#### 원인 +{: #os-cause} + +이 오류는 하나의 {{site.data.keyword.objectstorageshort}} 무료 플랜 인스턴스만을 허용하는 {{site.data.keyword.objectstorageshort}} 서비스로 인해 발생합니다. + + +#### 해결 +{: #os-resolution} + +이 오류를 방지하기 위해 다른 플랜을 선택하라는 프롬프트가 표시됩니다. + + +### 프로젝트 작성 중 코드 가져오기 실패 +{: #code} + +프로젝트를 작성하는 데 {{site.data.keyword.dev_cli_short}}을 사용하는 경우 다음 오류가 표시될 수 있습니다. + +``` +FAILED +Project created, but could not get code +https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code +``` +{: codeblock} + + +#### 원인 +{: #code-cause} + +이 오류는 내부 제한시간 초과로 인해 발생합니다. + + +#### 해결 +{: #code-resolution} + +다음 방법 중 하나를 사용하여 코드를 가져올 수 있습니다. + +* CLI를 사용하여 다음 명령을 실행합니다. + + ``` + bx dev code + ``` + {: codeblock} + + ``은 프로젝트 작성 중에 사용한 프로젝트 이름으로 대체해야 합니다. + +* {{site.data.keyword.dev_console}}을 사용합니다. + + 1. {{site.data.keyword.dev_console}}에서 [프로젝트 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.{DomainName}/developer/projects)를 선택하고 **코드 가져오기**를 클릭하십시오. + + 2. **코드 생성**을 클릭하십시오. + + 3. 코드가 생성되면 **코드 다운로드**를 클릭하십시오. + + +### Node.js 프로젝트에 대한 `bx dev run` 실행 오류 +{: #node} + +Node.js Web 또는 BFF 프로젝트의 {{site.data.keyword.dev_cli_short}}에 대해 `bx dev run`을 실행하는 경우 다음 오류가 표시될 수 있습니다. + +``` +module.js:597 + return process.dlopen(module, path._makeLong(filename)); + ^ + +Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header + at Error (native) + at Object.Module._extensions..node (module.js:597:18) + at Module.load (module.js:487:32) + at tryModuleLoad (module.js:446:12) + + at Function.Module._load (module.js:438:3) + at Module.require (module.js:497:17) + at require (internal/module.js:20:19) + at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) + at Module._compile (module.js:570:32) + at Object.Module._extensions..js (module.js:579:10) +``` +{: codeblock} + + +#### 원인 +{: #node-cause} + +이 오류는 `appmetrics` 모듈이 다른 아키텍처에 설치되어 발생합니다. 한 아키텍처에 설치된 네이티브 npm 모듈은 다른 아키텍처에서 작동하지 않습니다. 포함된 Docker 이미지는 Linux 커널을 기반으로 합니다. + + +#### 해결 +{: #node-resolution} + +`node_modules` 폴더를 삭제하고 `bx dev run`을 다시 실행하십시오. + + + + + + + +## 도움 및 지원 받기 +{: #gettinghelp} + +{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 또는 {{site.data.keyword.dev_cli_notm}} 사용 중에 문제점이 있거나 질문이 있는 경우에는 정보를 검색하거나 포럼에 질문하여 도움을 받을 수 있습니다. 또는 지원 티켓을 열 수도 있습니다. + +포럼을 통해 질문하는 경우 {{site.data.keyword.Bluemix_notm}} 개발 팀이 볼 수 있도록 질문에 태그를 지정하십시오. + + + +{{site.data.keyword.dev_console}} 또는 {{site.data.keyword.dev_cli_notm}}을 사용하여 앱을 개발하거나 배치하는 데 대한 기술 관련 질문이 있는 경우: + +* 질문을 [Stack Overflow ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix)에 게시하고 질문에 `bluemix-dev-services` 및 `ibm-bluemix` 태그를 지정하십시오. +* 질문을 [Slack ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://ibm-cloud-tech.slack.com/)의 `bluemix-dev-services` 채널에 게시하십시오. [지금 등록 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](http://ibm.biz/IBMCloudNativeSlack)하십시오. + + + + + +포럼 사용에 대한 세부사항은 [도움 받기 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/support/index.html#getting-help)를 참조하십시오. + +{{site.data.keyword.IBM}} 지원 티켓 열기, 또는 지원 레벨 및 티켓 심각도에 대한 정보는 [지원 문의 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/support/index.html#contacting-support)를 참조하십시오. + + + diff --git a/cloudnative/nl/ko/tutorial_bff.md b/cloudnative/nl/ko/tutorial_bff.md index c02e0bc94..d1b4f4266 100644 --- a/cloudnative/nl/ko/tutorial_bff.md +++ b/cloudnative/nl/ko/tutorial_bff.md @@ -1,147 +1,147 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# BFF 기본 스타터의 엔드-투-엔드 튜토리얼 -{: #tutorial} - -다음 엔드-투-엔드 튜토리얼은 설치해야 하는 도구를 포함하여 BFF 기본 스타터에서 프로젝트를 작성하는 단계를 안내하고, 이어서 프로젝트 코드를 실행하는 단계를 안내합니다. - -## 개발자 도구 설치 -{: #dev_tools} - -[전제 조건 개발자 도구 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](get_code.html#prereq-dev-tools){: new_window}를 설치했는지 확인하십시오. - - -## {{site.data.keyword.dev_console}}을 사용하여 프로젝트 작성 -{: #create-devex} - -1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}에서 프로젝트를 작성하십시오. - - 1. {{site.data.keyword.dev_console}}의 **시작하기** 페이지에서 **프로젝트 작성**을 클릭하십시오. - - 또는 **프로젝트** 페이지에서 **프로젝트 작성**을 클릭할 수 있습니다. - - 2. **BFF(Backend for Frontend)**를 선택하고 **다음**을 클릭하십시오. - - 3. **기본 백엔드**를 선택하고 **다음**을 클릭하십시오. - - 4. 프로젝트 이름을 입력하십시오. 이 튜토리얼의 경우 `BFFProject`를 사용하십시오. - - 5. 호스트 이름을 입력하십시오. 이 튜토리얼의 경우 `devhost`를 사용하십시오. - - 6. 언어 플랫폼을 선택하십시오. 이 튜토리얼의 경우 `Node`를 사용하십시오. - - 7. **작성**을 클릭하십시오. - -2. 선택사항: 데이터 기능을 추가하십시오. - - 1. **프로젝트 개요** 페이지에서 **데이터**에 대한 **보기**를 클릭하십시오. - - **기능 > 데이터** 페이지에서 **작성** 또는 **기존 추가**를 선택할 수도 있습니다. - - 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. - - -3. 프로젝트 코드를 생성하십시오. - - 1. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. - - 또는 **코드** 페이지를 클릭할 수 있습니다. - - 2. **코드 생성**을 클릭하십시오. - - 3. 프로젝트 코드 생성이 완료되면 **코드 다운로드**를 클릭하여 프로젝트 아카이브를 다운로드하십시오. - -4. 선택사항: 새 언어를 생성하도록 [프로젝트를 업데이트하십시오](project_overview_page.html#update_language). - - -## {{site.data.keyword.dev_cli_notm}}을 사용하여 프로젝트 작성 -{: #create-cli} - -1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html)을 설치했는지 확인하십시오. - -2. 터미널 프롬프트에서 원하는 로컬 디렉토리로 이동하여 다음 명령을 실행하십시오. - - ``` - bx dev create - ``` - {: codeblock} - -3. 프롬프트가 표시되면 다음 값을 제공하십시오. - - * 패턴 선택: 3(BFF(Backend for Frontend)) - * 스타터 선택: 1(기본 백엔드) - * 언어 선택: 1(Node) - * 프로젝트의 이름 입력: `BFFProjectCLI` - * 프로젝트의 호스트 이름 입력: `myhost` - -4. 프로젝트에 서비스를 추가하려면 질문 프롬프트에서 `y`를 입력하고 나머지 질문에 응답하십시오. - -5. `BFFProjectCLI`가 저장되면 `BFFProjectCLI` 폴더로 이동하십시오. - -6. 이 시점에서 고유 코드를 추가하거나, 프로젝트를 빌드하거나, 프로젝트를 실행할 수 있습니다. - - 1. 다음 명령을 사용하여 프로젝트를 빌드하십시오. - - ``` - bx dev build - ``` - {: codeblock} - - 2. 다음 명령을 사용하여 프로젝트를 실행하십시오. - - ``` - bx dev run - ``` - {: codeblock} - - -## BFF 프로젝트 실행 -{: #running-bff} - -### 로컬 -{: #bff-local} - -1. 서버를 컴파일하십시오. - - ``` - swift build - ``` - {: codeblock} - -2. 애플리케이션을 실행하십시오. 예를 들어, 애플리케이션 이름이 `MyServer`인 경우에는 다음과 같이 실행하십시오. - - ``` - .build/debug/MyServer - ``` - {: codeblock} - -3. `curl http://localhost:8080`을 사용하여 서버에서 curl을 실행할 수 있습니다. - - -### Bluemix 플러그인 사용 -{: #using-blumix} - -1. 컴파일을 실행하십시오. - - ``` - bx dev run - ``` - {: codeblock} - -2. 다음 항목을 사용하여 서버에서 curl을 실행할 수 있습니다. - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# BFF 기본 스타터의 엔드-투-엔드 튜토리얼 +{: #tutorial} + +다음 엔드-투-엔드 튜토리얼은 설치해야 하는 도구를 포함하여 BFF 기본 스타터에서 프로젝트를 작성하는 단계를 안내하고, 이어서 프로젝트 코드를 실행하는 단계를 안내합니다. + +## 개발자 도구 설치 +{: #dev_tools} + +[전제 조건 개발자 도구 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](get_code.html#prereq-dev-tools){: new_window}를 설치했는지 확인하십시오. + + +## {{site.data.keyword.dev_console}}을 사용하여 프로젝트 작성 +{: #create-devex} + +1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}에서 프로젝트를 작성하십시오. + + 1. {{site.data.keyword.dev_console}}의 **시작하기** 페이지에서 **프로젝트 작성**을 클릭하십시오. + + 또는 **프로젝트** 페이지에서 **프로젝트 작성**을 클릭할 수 있습니다. + + 2. **BFF(Backend for Frontend)**를 선택하고 **다음**을 클릭하십시오. + + 3. **기본 백엔드**를 선택하고 **다음**을 클릭하십시오. + + 4. 프로젝트 이름을 입력하십시오. 이 튜토리얼의 경우 `BFFProject`를 사용하십시오. + + 5. 호스트 이름을 입력하십시오. 이 튜토리얼의 경우 `devhost`를 사용하십시오. + + 6. 언어 플랫폼을 선택하십시오. 이 튜토리얼의 경우 `Node`를 사용하십시오. + + 7. **작성**을 클릭하십시오. + +2. 선택사항: 데이터 기능을 추가하십시오. + + 1. **프로젝트 개요** 페이지에서 **데이터**에 대한 **보기**를 클릭하십시오. + + **기능 > 데이터** 페이지에서 **작성** 또는 **기존 추가**를 선택할 수도 있습니다. + + 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. + + +3. 프로젝트 코드를 생성하십시오. + + 1. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. + + 또는 **코드** 페이지를 클릭할 수 있습니다. + + 2. **코드 생성**을 클릭하십시오. + + 3. 프로젝트 코드 생성이 완료되면 **코드 다운로드**를 클릭하여 프로젝트 아카이브를 다운로드하십시오. + +4. 선택사항: 새 언어를 생성하도록 [프로젝트를 업데이트하십시오](project_overview_page.html#update_language). + + +## {{site.data.keyword.dev_cli_notm}}을 사용하여 프로젝트 작성 +{: #create-cli} + +1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html)을 설치했는지 확인하십시오. + +2. 터미널 프롬프트에서 원하는 로컬 디렉토리로 이동하여 다음 명령을 실행하십시오. + + ``` + bx dev create + ``` + {: codeblock} + +3. 프롬프트가 표시되면 다음 값을 제공하십시오. + + * 패턴 선택: 3(BFF(Backend for Frontend)) + * 스타터 선택: 1(기본 백엔드) + * 언어 선택: 1(Node) + * 프로젝트의 이름 입력: `BFFProjectCLI` + * 프로젝트의 호스트 이름 입력: `myhost` + +4. 프로젝트에 서비스를 추가하려면 질문 프롬프트에서 `y`를 입력하고 나머지 질문에 응답하십시오. + +5. `BFFProjectCLI`가 저장되면 `BFFProjectCLI` 폴더로 이동하십시오. + +6. 이 시점에서 고유 코드를 추가하거나, 프로젝트를 빌드하거나, 프로젝트를 실행할 수 있습니다. + + 1. 다음 명령을 사용하여 프로젝트를 빌드하십시오. + + ``` + bx dev build + ``` + {: codeblock} + + 2. 다음 명령을 사용하여 프로젝트를 실행하십시오. + + ``` + bx dev run + ``` + {: codeblock} + + +## BFF 프로젝트 실행 +{: #running-bff} + +### 로컬 +{: #bff-local} + +1. 서버를 컴파일하십시오. + + ``` + swift build + ``` + {: codeblock} + +2. 애플리케이션을 실행하십시오. 예를 들어, 애플리케이션 이름이 `MyServer`인 경우에는 다음과 같이 실행하십시오. + + ``` + .build/debug/MyServer + ``` + {: codeblock} + +3. `curl http://localhost:8080`을 사용하여 서버에서 curl을 실행할 수 있습니다. + + +### Bluemix 플러그인 사용 +{: #using-blumix} + +1. 컴파일을 실행하십시오. + + ``` + bx dev run + ``` + {: codeblock} + +2. 다음 항목을 사용하여 서버에서 curl을 실행할 수 있습니다. + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/ko/tutorial_microservice.md b/cloudnative/nl/ko/tutorial_microservice.md index 652c3c089..8c57f45b6 100644 --- a/cloudnative/nl/ko/tutorial_microservice.md +++ b/cloudnative/nl/ko/tutorial_microservice.md @@ -1,113 +1,113 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 마이크로서비스 기본 스타터의 엔드-투-엔드 튜토리얼 -{: #tutorial} - -다음 엔드-투-엔드 튜토리얼은 설치해야 하는 도구를 포함하여 마이크로서비스 기본 스타터에서 프로젝트를 작성하는 단계를 안내하고, 이어서 프로젝트 코드를 실행하는 단계를 안내합니다. - -## 개발자 도구 설치 -{: #dev_tools} - -[전제 조건 개발자 도구 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](get_code.html#prereq-dev-tools){: new_window}를 설치했는지 확인하십시오. - - -## {{site.data.keyword.dev_console}}을 사용하여 프로젝트 작성 -{: #create-devex} - -1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}에서 프로젝트를 작성하십시오. - - 1. {{site.data.keyword.dev_console}}의 **시작하기** 페이지에서 **프로젝트 작성**을 클릭하십시오. - - 또는 **프로젝트** 페이지에서 **프로젝트 작성**을 클릭할 수 있습니다. - - 2. **마이크로서비스**를 선택하고 **다음**을 클릭하십시오. - - 3. **기본**을 선택하고 **다음**을 클릭하십시오. - - 4. 프로젝트 이름을 입력하십시오. 이 튜토리얼의 경우 `MicroserviceProject`를 사용하십시오. - - 5. 호스트 이름을 입력하십시오. 이 튜토리얼의 경우 `devhost`를 사용하십시오. - - 6. **작성**을 클릭하십시오. - -2. 선택사항: 데이터 기능을 추가하십시오. - - 1. **프로젝트 개요** 페이지에서 **데이터**에 대한 **보기**를 클릭하십시오. - - **기능 > 데이터** 페이지에서 **작성** 또는 **기존 추가**를 선택할 수도 있습니다. - - 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. - -3. 프로젝트 코드를 생성하십시오. - - 1. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. - - 또는 **코드** 페이지를 클릭할 수 있습니다. - - 2. **코드 생성**을 클릭하십시오. - - 3. 프로젝트 코드 생성이 완료되면 **코드 다운로드**를 클릭하여 프로젝트 아카이브를 다운로드하십시오. - -4. 선택사항: 새 언어를 생성하도록 [프로젝트를 업데이트하십시오](project_overview_page.html#update_language). - - -## {{site.data.keyword.dev_cli_notm}}을 사용하여 프로젝트 작성 -{: #create-cli} - -1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html)을 설치했는지 확인하십시오. - -2. 터미널 프롬프트에서 원하는 로컬 디렉토리로 이동하여 다음 명령을 실행하십시오. - - ``` - bx dev create - ``` - {: codeblock} - -3. 프롬프트가 표시되면 다음 값을 제공하십시오. - - * 패턴 선택: 4(마이크로서비스) - * 스타터 선택: 1(기본) - * 플랫폼 선택: 3(Java) - * 프로젝트의 이름 입력: `MicroserviceProjectCLI` - -4. 프로젝트에 서비스를 추가하려면 질문 프롬프트에서 `y`를 입력하고 나머지 질문에 응답하십시오. - -5. `MicroserviceProjectCLI`가 저장되면 `MicroserviceProjectCLI` 폴더로 이동하십시오. - -6. 이 시점에서 고유 코드를 추가하거나, 프로젝트를 빌드하거나, 프로젝트를 실행할 수 있습니다. - - -## {{site.data.keyword.dev_cli_notm}}을 사용하여 프로젝트 실행 -{: #running-dev-plugin} - -1. 현재 프로젝트 디렉토리에서 프로젝트를 빌드하려면 다음 명령을 입력하십시오. - - ``` - bx dev build - ``` - {: codeblock} - -2. 현재 프로젝트 디렉토리에서 프로젝트를 빌드하고 실행하려면 다음 명령을 입력하십시오. - - ``` - bx dev run - ``` - {: codeblock} - -3. 서버에서 curl을 사용하여 애플리케이션에 액세스할 수 있습니다. - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 마이크로서비스 기본 스타터의 엔드-투-엔드 튜토리얼 +{: #tutorial} + +다음 엔드-투-엔드 튜토리얼은 설치해야 하는 도구를 포함하여 마이크로서비스 기본 스타터에서 프로젝트를 작성하는 단계를 안내하고, 이어서 프로젝트 코드를 실행하는 단계를 안내합니다. + +## 개발자 도구 설치 +{: #dev_tools} + +[전제 조건 개발자 도구 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](get_code.html#prereq-dev-tools){: new_window}를 설치했는지 확인하십시오. + + +## {{site.data.keyword.dev_console}}을 사용하여 프로젝트 작성 +{: #create-devex} + +1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}에서 프로젝트를 작성하십시오. + + 1. {{site.data.keyword.dev_console}}의 **시작하기** 페이지에서 **프로젝트 작성**을 클릭하십시오. + + 또는 **프로젝트** 페이지에서 **프로젝트 작성**을 클릭할 수 있습니다. + + 2. **마이크로서비스**를 선택하고 **다음**을 클릭하십시오. + + 3. **기본**을 선택하고 **다음**을 클릭하십시오. + + 4. 프로젝트 이름을 입력하십시오. 이 튜토리얼의 경우 `MicroserviceProject`를 사용하십시오. + + 5. 호스트 이름을 입력하십시오. 이 튜토리얼의 경우 `devhost`를 사용하십시오. + + 6. **작성**을 클릭하십시오. + +2. 선택사항: 데이터 기능을 추가하십시오. + + 1. **프로젝트 개요** 페이지에서 **데이터**에 대한 **보기**를 클릭하십시오. + + **기능 > 데이터** 페이지에서 **작성** 또는 **기존 추가**를 선택할 수도 있습니다. + + 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. + +3. 프로젝트 코드를 생성하십시오. + + 1. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. + + 또는 **코드** 페이지를 클릭할 수 있습니다. + + 2. **코드 생성**을 클릭하십시오. + + 3. 프로젝트 코드 생성이 완료되면 **코드 다운로드**를 클릭하여 프로젝트 아카이브를 다운로드하십시오. + +4. 선택사항: 새 언어를 생성하도록 [프로젝트를 업데이트하십시오](project_overview_page.html#update_language). + + +## {{site.data.keyword.dev_cli_notm}}을 사용하여 프로젝트 작성 +{: #create-cli} + +1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html)을 설치했는지 확인하십시오. + +2. 터미널 프롬프트에서 원하는 로컬 디렉토리로 이동하여 다음 명령을 실행하십시오. + + ``` + bx dev create + ``` + {: codeblock} + +3. 프롬프트가 표시되면 다음 값을 제공하십시오. + + * 패턴 선택: 4(마이크로서비스) + * 스타터 선택: 1(기본) + * 플랫폼 선택: 3(Java) + * 프로젝트의 이름 입력: `MicroserviceProjectCLI` + +4. 프로젝트에 서비스를 추가하려면 질문 프롬프트에서 `y`를 입력하고 나머지 질문에 응답하십시오. + +5. `MicroserviceProjectCLI`가 저장되면 `MicroserviceProjectCLI` 폴더로 이동하십시오. + +6. 이 시점에서 고유 코드를 추가하거나, 프로젝트를 빌드하거나, 프로젝트를 실행할 수 있습니다. + + +## {{site.data.keyword.dev_cli_notm}}을 사용하여 프로젝트 실행 +{: #running-dev-plugin} + +1. 현재 프로젝트 디렉토리에서 프로젝트를 빌드하려면 다음 명령을 입력하십시오. + + ``` + bx dev build + ``` + {: codeblock} + +2. 현재 프로젝트 디렉토리에서 프로젝트를 빌드하고 실행하려면 다음 명령을 입력하십시오. + + ``` + bx dev run + ``` + {: codeblock} + +3. 서버에서 curl을 사용하여 애플리케이션에 액세스할 수 있습니다. + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/ko/tutorial_mobile.md b/cloudnative/nl/ko/tutorial_mobile.md index 5dafab711..3f4784052 100644 --- a/cloudnative/nl/ko/tutorial_mobile.md +++ b/cloudnative/nl/ko/tutorial_mobile.md @@ -1,187 +1,187 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 모바일 기본 스타터의 엔드-투-엔드 튜토리얼 -{: #tutorial} - -다음 엔드-투-엔드 튜토리얼은 설치해야 하는 도구를 포함하여 모바일 기본 스타터에서 프로젝트를 작성하는 단계를 안내하고, 이어서 Xcode 및 Android Studio에서 프로젝트를 실행하는 단계를 안내합니다. - - -## 개발자 도구 설치 -{: #dev_tools} - -[전제 조건 개발자 도구 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](get_code.html#prereq-dev-tools){: new_window}를 설치했는지 확인하십시오. - - -## {{site.data.keyword.dev_console}}을 사용하여 프로젝트 작성 -{: #create-devex} - -1. {{site.data.keyword.Bluemix}}에서 {{site.data.keyword.dev_console}} 프로젝트를 작성하십시오. - - 1. {{site.data.keyword.dev_console}}의 **시작하기** 페이지에서 **프로젝트 작성**을 클릭하십시오. - - 또는 **프로젝트** 페이지에서 **프로젝트 작성**을 클릭할 수 있습니다. - - 2. **모바일 앱**을 선택하고 **다음**을 클릭하십시오. - - 3. **기본**을 선택하고 **다음**을 클릭하십시오. - - 4. 프로젝트 이름을 입력하십시오. 이 튜토리얼의 경우 `MobileBasicProject`를 사용하십시오. - - 5. 플랫폼을 선택하십시오. 이 튜토리얼의 경우 `Swift`를 사용하십시오. - - 6. **작성**을 클릭하십시오. - -2. 선택사항: 인증 기능을 추가하십시오. - - 1. **프로젝트 개요** 페이지에서 **인증**에 대해 **추가**를 클릭하십시오. - - **기능 > 인증** 페이지에서 **작성** 또는 **기존 추가**를 선택할 수도 있습니다. - - 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. - - 3. **인증**을 토글하여 켜십시오. - - 4. ID 제공자를 선택하고 필요한 정보를 입력하여 이를 구성하십시오. 하나의 ID 제공자만 사용 가능하게 설정할 수 있습니다. - - 5. 인증 구성에 대한 자세한 정보는 [ID 제공자 구성 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/appid/identity-providers.html){: new_window}을 참조하십시오. - -3. 선택사항: 분석 기능을 추가하십시오. - - 1. **프로젝트 개요** 페이지에서 **분석**에 대해 **추가**를 클릭하십시오. - - **기능 > 분석** 페이지에서 **작성** 또는 **기존 추가**를 클릭할 수도 있습니다. - - 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. - - 3. 앱을 실행한 후 분석 데이터를 보려면 **데모 모드**를 토글하여 끄십시오. - - 4. 분석 구성에 대한 자세한 정보는 [{{site.data.keyword.mobileanalytics_short}} 시작하기 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobileanalytics/index.html){: new_window}를 참조하십시오. - -4. 선택사항: {{site.data.keyword.mobilepushshort}} 기능을 추가하십시오. - - 1. **프로젝트 개요** 페이지에서 **{{site.data.keyword.mobilepushshort}}**에 대해 **추가**를 클릭하십시오. - - **기능 > {{site.data.keyword.mobilepushshort}}** 페이지에서 **작성** 또는 **기존 추가**를 클릭할 수도 있습니다. - - 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. - - 3. iOS의 경우, [Apple Push Notification Service 구성 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}을 수행하십시오. - - 4. Android의 경우, [FCM(Firebase Cloud Messaging) 구성 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}을 수행하십시오. - -5. 선택사항: 데이터 기능을 추가하십시오. - - 1. **프로젝트 개요** 페이지에서 **데이터**에 대한 **보기**를 클릭하십시오. - - 또는 **데이터** 페이지에서 **작성**을 선택할 수 있습니다. - - 2. **{{site.data.keyword.cloudant_short_notm}}** 또는 **{{site.data.keyword.objectstorageshort}}**를 선택하십시오. - - 3. 서비스 이름을 입력하고 **작성**을 클릭하십시오. - - 4. {{site.data.keyword.cloudant_short_notm}} 구성에 대한 자세한 정보는 [{{site.data.keyword.cloudant_short_notm}} 시작하기 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/Cloudant/index.html){: new_window}를 참조하십시오. - - 5. {{site.data.keyword.objectstorageshort}} 구성에 대한 자세한 정보는 [{{site.data.keyword.objectstorageshort}} 시작하기 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/ObjectStorage/index.html){: new_window}를 참조하십시오. - -6. 프로젝트 코드를 생성하십시오. - - 1. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. - - 또는 **코드** 페이지를 클릭할 수 있습니다. - - 2. **Swift 생성**을 클릭하십시오. - - 3. 프로젝트 코드 생성이 완료되면 **Swift 다운로드**를 클릭하여 프로젝트 아카이브를 다운로드하십시오. - -7. 선택사항: 새 언어를 생성하도록 [프로젝트를 업데이트하십시오](project_overview_page.html#update_language). - - -## {{site.data.keyword.dev_cli_notm}}을 사용하여 프로젝트 작성 -{: #create-cli} - -1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html)을 설치했는지 확인하십시오. - -2. 터미널 프롬프트에서 원하는 로컬 디렉토리로 이동하여 다음 명령을 실행하십시오. - - ``` - bx dev create - ``` - {: codeblock} - -3. 프롬프트가 표시되면 다음 값을 제공하십시오. - - * 패턴 선택: 2(모바일) - * 스타터 선택: 1(기본) - * 플랫폼 선택: 3(iOS Swift) - * 프로젝트의 이름 입력: `MobileBasicProjectCLI` - -4. 프로젝트에 서비스를 추가하려면 질문 프롬프트에서 `y`를 입력하고 나머지 질문에 응답하십시오. - -5. `MobileBasicProjectCLI`가 저장되면 `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift` 폴더로 이동하십시오. - - -## Xcode에서 Swift 프로젝트 실행 -{: #run_swift} - -1. `MobileBasicProject-Swift.zip` 파일의 압축을 푸십시오. - -2. Markdown 뷰어에서 `README.md` 파일을 열어 프로젝트를 구성하는 단계를 검토하십시오. - - 1. 터미널을 열고 프로젝트 폴더로 이동하십시오. - - 1. CocoaPods 저장소를 설정해야 하는 경우 `pod setup`을 실행하십시오. - - 2. 기존 pod를 업데이트해야 하는 경우 `pod update`를 실행하십시오. - - 3. 프로젝트에 필요한 pod를 설치하려면 `pod install`을 실행하십시오. - - 3. `BasicProject.xcworkspace` Xcode 작업공간을 여십시오. - -3. 앱을 실행하십시오. - - -## Xcode에서 Cordova 프로젝트 실행 -{: #run_cordova_xcode} - -1. `MobileBasicProject-Cordova.zip` 파일의 압축을 푸십시오. - -2. Markdown 뷰어에서 `README.md` 파일을 열어 프로젝트를 구성하십시오. - - 1. Xcode에서 `platforms/ios` 프로젝트를 여십시오. - -3. 앱을 실행하십시오. - - -## Android Studio에서 Cordova 프로젝트 실행 -{: #run_cordova_studio} - -1. `BasicProject-Cordova.zip` 파일의 압축을 푸십시오. - -2. Markdown 뷰어에서 `README.md` 파일을 열어 프로젝트를 구성하십시오. - - 1. Android Studio에서 `platforms/android` 프로젝트를 여십시오. - -3. 앱을 실행하십시오. - - -## Android Studio에서 Android 프로젝트 실행 -{: #run_android} - -1. `MobileBasicProject-Android.zip` 파일의 압축을 푸십시오. - -2. Markdown 뷰어에서 `README.md` 파일을 열어 프로젝트를 구성하십시오. - - 1. Android Studio에서 `BasicProject-Android` 프로젝트를 여십시오. - -3. 앱을 실행하십시오. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 모바일 기본 스타터의 엔드-투-엔드 튜토리얼 +{: #tutorial} + +다음 엔드-투-엔드 튜토리얼은 설치해야 하는 도구를 포함하여 모바일 기본 스타터에서 프로젝트를 작성하는 단계를 안내하고, 이어서 Xcode 및 Android Studio에서 프로젝트를 실행하는 단계를 안내합니다. + + +## 개발자 도구 설치 +{: #dev_tools} + +[전제 조건 개발자 도구 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](get_code.html#prereq-dev-tools){: new_window}를 설치했는지 확인하십시오. + + +## {{site.data.keyword.dev_console}}을 사용하여 프로젝트 작성 +{: #create-devex} + +1. {{site.data.keyword.Bluemix}}에서 {{site.data.keyword.dev_console}} 프로젝트를 작성하십시오. + + 1. {{site.data.keyword.dev_console}}의 **시작하기** 페이지에서 **프로젝트 작성**을 클릭하십시오. + + 또는 **프로젝트** 페이지에서 **프로젝트 작성**을 클릭할 수 있습니다. + + 2. **모바일 앱**을 선택하고 **다음**을 클릭하십시오. + + 3. **기본**을 선택하고 **다음**을 클릭하십시오. + + 4. 프로젝트 이름을 입력하십시오. 이 튜토리얼의 경우 `MobileBasicProject`를 사용하십시오. + + 5. 플랫폼을 선택하십시오. 이 튜토리얼의 경우 `Swift`를 사용하십시오. + + 6. **작성**을 클릭하십시오. + +2. 선택사항: 인증 기능을 추가하십시오. + + 1. **프로젝트 개요** 페이지에서 **인증**에 대해 **추가**를 클릭하십시오. + + **기능 > 인증** 페이지에서 **작성** 또는 **기존 추가**를 선택할 수도 있습니다. + + 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. + + 3. **인증**을 토글하여 켜십시오. + + 4. ID 제공자를 선택하고 필요한 정보를 입력하여 이를 구성하십시오. 하나의 ID 제공자만 사용 가능하게 설정할 수 있습니다. + + 5. 인증 구성에 대한 자세한 정보는 [ID 제공자 구성 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/appid/identity-providers.html){: new_window}을 참조하십시오. + +3. 선택사항: 분석 기능을 추가하십시오. + + 1. **프로젝트 개요** 페이지에서 **분석**에 대해 **추가**를 클릭하십시오. + + **기능 > 분석** 페이지에서 **작성** 또는 **기존 추가**를 클릭할 수도 있습니다. + + 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. + + 3. 앱을 실행한 후 분석 데이터를 보려면 **데모 모드**를 토글하여 끄십시오. + + 4. 분석 구성에 대한 자세한 정보는 [{{site.data.keyword.mobileanalytics_short}} 시작하기 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobileanalytics/index.html){: new_window}를 참조하십시오. + +4. 선택사항: {{site.data.keyword.mobilepushshort}} 기능을 추가하십시오. + + 1. **프로젝트 개요** 페이지에서 **{{site.data.keyword.mobilepushshort}}**에 대해 **추가**를 클릭하십시오. + + **기능 > {{site.data.keyword.mobilepushshort}}** 페이지에서 **작성** 또는 **기존 추가**를 클릭할 수도 있습니다. + + 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. + + 3. iOS의 경우, [Apple Push Notification Service 구성 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}을 수행하십시오. + + 4. Android의 경우, [FCM(Firebase Cloud Messaging) 구성 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}을 수행하십시오. + +5. 선택사항: 데이터 기능을 추가하십시오. + + 1. **프로젝트 개요** 페이지에서 **데이터**에 대한 **보기**를 클릭하십시오. + + 또는 **데이터** 페이지에서 **작성**을 선택할 수 있습니다. + + 2. **{{site.data.keyword.cloudant_short_notm}}** 또는 **{{site.data.keyword.objectstorageshort}}**를 선택하십시오. + + 3. 서비스 이름을 입력하고 **작성**을 클릭하십시오. + + 4. {{site.data.keyword.cloudant_short_notm}} 구성에 대한 자세한 정보는 [{{site.data.keyword.cloudant_short_notm}} 시작하기 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/Cloudant/index.html){: new_window}를 참조하십시오. + + 5. {{site.data.keyword.objectstorageshort}} 구성에 대한 자세한 정보는 [{{site.data.keyword.objectstorageshort}} 시작하기 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/ObjectStorage/index.html){: new_window}를 참조하십시오. + +6. 프로젝트 코드를 생성하십시오. + + 1. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. + + 또는 **코드** 페이지를 클릭할 수 있습니다. + + 2. **Swift 생성**을 클릭하십시오. + + 3. 프로젝트 코드 생성이 완료되면 **Swift 다운로드**를 클릭하여 프로젝트 아카이브를 다운로드하십시오. + +7. 선택사항: 새 언어를 생성하도록 [프로젝트를 업데이트하십시오](project_overview_page.html#update_language). + + +## {{site.data.keyword.dev_cli_notm}}을 사용하여 프로젝트 작성 +{: #create-cli} + +1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html)을 설치했는지 확인하십시오. + +2. 터미널 프롬프트에서 원하는 로컬 디렉토리로 이동하여 다음 명령을 실행하십시오. + + ``` + bx dev create + ``` + {: codeblock} + +3. 프롬프트가 표시되면 다음 값을 제공하십시오. + + * 패턴 선택: 2(모바일) + * 스타터 선택: 1(기본) + * 플랫폼 선택: 3(iOS Swift) + * 프로젝트의 이름 입력: `MobileBasicProjectCLI` + +4. 프로젝트에 서비스를 추가하려면 질문 프롬프트에서 `y`를 입력하고 나머지 질문에 응답하십시오. + +5. `MobileBasicProjectCLI`가 저장되면 `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift` 폴더로 이동하십시오. + + +## Xcode에서 Swift 프로젝트 실행 +{: #run_swift} + +1. `MobileBasicProject-Swift.zip` 파일의 압축을 푸십시오. + +2. Markdown 뷰어에서 `README.md` 파일을 열어 프로젝트를 구성하는 단계를 검토하십시오. + + 1. 터미널을 열고 프로젝트 폴더로 이동하십시오. + + 1. CocoaPods 저장소를 설정해야 하는 경우 `pod setup`을 실행하십시오. + + 2. 기존 pod를 업데이트해야 하는 경우 `pod update`를 실행하십시오. + + 3. 프로젝트에 필요한 pod를 설치하려면 `pod install`을 실행하십시오. + + 3. `BasicProject.xcworkspace` Xcode 작업공간을 여십시오. + +3. 앱을 실행하십시오. + + +## Xcode에서 Cordova 프로젝트 실행 +{: #run_cordova_xcode} + +1. `MobileBasicProject-Cordova.zip` 파일의 압축을 푸십시오. + +2. Markdown 뷰어에서 `README.md` 파일을 열어 프로젝트를 구성하십시오. + + 1. Xcode에서 `platforms/ios` 프로젝트를 여십시오. + +3. 앱을 실행하십시오. + + +## Android Studio에서 Cordova 프로젝트 실행 +{: #run_cordova_studio} + +1. `BasicProject-Cordova.zip` 파일의 압축을 푸십시오. + +2. Markdown 뷰어에서 `README.md` 파일을 열어 프로젝트를 구성하십시오. + + 1. Android Studio에서 `platforms/android` 프로젝트를 여십시오. + +3. 앱을 실행하십시오. + + +## Android Studio에서 Android 프로젝트 실행 +{: #run_android} + +1. `MobileBasicProject-Android.zip` 파일의 압축을 푸십시오. + +2. Markdown 뷰어에서 `README.md` 파일을 열어 프로젝트를 구성하십시오. + + 1. Android Studio에서 `BasicProject-Android` 프로젝트를 여십시오. + +3. 앱을 실행하십시오. diff --git a/cloudnative/nl/ko/tutorial_web.md b/cloudnative/nl/ko/tutorial_web.md index 358e6767f..155f5fba4 100644 --- a/cloudnative/nl/ko/tutorial_web.md +++ b/cloudnative/nl/ko/tutorial_web.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 웹 기본 스타터의 엔드-투-엔드 튜토리얼 -{: #tutorial} - -다음 엔드-투-엔드 튜토리얼은 설치해야 하는 도구를 포함하여 웹 기본 스타터에서 프로젝트를 작성하는 단계를 안내하고, 이어서 프로젝트 코드를 실행하는 단계를 안내합니다. - -## 개발자 도구 설치 -{: #dev_tools} - -[전제 조건 개발자 도구 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](get_code.html#prereq-dev-tools){: new_window}를 설치했는지 확인하십시오. - - -## {{site.data.keyword.dev_console}}을 사용하여 프로젝트 작성 -{: #create-devex} - -1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}에서 프로젝트를 작성하십시오. - - 1. {{site.data.keyword.dev_console}}의 **시작하기** 페이지에서 **프로젝트 작성**을 클릭하십시오. - - 또는 **프로젝트** 페이지에서 **프로젝트 작성**을 클릭할 수 있습니다. - - 2. **웹 앱**을 선택하고 **다음**을 클릭하십시오. - - 3. **기본 웹**을 선택하고 **다음**을 클릭하십시오. - - 4. 프로젝트 이름을 입력하십시오. 이 튜토리얼의 경우 `WebBasicProject`를 사용하십시오. - - 5. 호스트 이름을 입력하십시오. 이 튜토리얼의 경우 `devhost`를 사용하십시오. - - 6. 언어 플랫폼을 선택하십시오. 이 튜토리얼의 경우 `Swift`를 사용하십시오. - - 7. **작성**을 클릭하십시오. - -2. 선택사항: 데이터 기능을 추가하십시오. - - 1. **프로젝트 개요** 페이지에서 **데이터**에 대한 **보기**를 클릭하십시오. - - **기능 > 데이터** 페이지에서 **작성** 또는 **기존 추가**를 선택할 수도 있습니다. - - 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. - - -3. 프로젝트 코드를 생성하십시오. - - 1. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. - - 또는 **코드** 페이지를 클릭할 수 있습니다. - - 2. **코드 생성**을 클릭하십시오. - - 3. 프로젝트 코드 생성이 완료되면 **코드 다운로드**를 클릭하여 프로젝트 아카이브를 다운로드하십시오. - -4. 선택사항: 새 언어를 생성하도록 [프로젝트를 업데이트하십시오](project_overview_page.html#update_language). - - -## {{site.data.keyword.dev_cli_notm}}을 사용하여 프로젝트 작성 -{: #create-cli} - -1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html)을 설치했는지 확인하십시오. - -2. 터미널 프롬프트에서 원하는 로컬 디렉토리로 이동하여 다음 명령을 실행하십시오. - - ``` - bx dev create - ``` - {: codeblock} - - -3. 프롬프트가 표시되면 다음 값을 제공하십시오. - - * 패턴 선택: 1(웹) - * 스타터 선택: 1(기본 웹) - * 언어 선택: 2(Swift) - * 프로젝트의 이름 입력: `WebBasicProjectCLI` - * 프로젝트의 호스트 이름 입력: `myhost` - -4. 프로젝트에 서비스를 추가하려면 질문 프롬프트에서 `y`를 입력하고 나머지 질문에 응답하십시오. - -5. `WebBasicProjectCLI` 프로젝트가 저장되면 `WebBasicProjectCLI` 폴더로 이동하십시오. - -6. 고유 코드를 추가하거나, 프로젝트를 빌드하거나, 프로젝트를 실행하십시오. - - 1. 다음 명령을 사용하여 프로젝트를 빌드하십시오. - - ``` - bx dev build - ``` - {: codeblock} - - 2. 다음 명령을 사용하여 프로젝트를 실행하십시오. - - ``` - bx dev run - ``` - {: codeblock} - - -## 웹 프로젝트 실행 -{: #run} - -### 로컬 -{: #local notoc} - -1. 노드 종속 항목을 설치하십시오. - - ``` - npm install - ``` - {: codeblock} - -2. 프론트 엔드 코드를 모듈에 포함시키십시오. - - ``` - node_modules/.bin/gulp - ``` - {: codeblock} - -3. 서버를 컴파일하십시오. - - ``` - swift build - ``` - {: codeblock} - -4. 애플리케이션을 실행하십시오. - - ``` - .build/debug/WebBasicProjectCLI - ``` - {: codeblock} - -5. 브라우저에서 `http://localhost:8080`을 여십시오. - - -### {{site.data.keyword.dev_cli_short}} 사용 -{: #dev notoc} - -1. 노드 종속 항목을 설치하십시오. - - ``` - npm install - ``` - {: codeblock} - -2. 프론트 엔드 코드를 모듈에 포함시키십시오. - - ``` - gulp - ``` - {: codeblock} - -3. 컴파일을 실행하십시오. - - ``` - bx dev run - ``` - {: codeblock} - -4. 브라우저에서 `http://localhost:8080`을 여십시오. - - -## Xcode에서 프로젝트 실행 -{: #Xcode} - -1. Xcode 프로젝트를 작성하십시오. - - Xcode로 개발하려면 먼저 Swift 패키지 관리자를 사용하여 Xcode 프로젝트를 빌드해야 합니다. - - ``` - swift project generate-xcodeproj - ``` - {: codeblock} - -2. 활성 대상을 실행 파일로 변경하십시오. - - 다음, 프로젝트를 Xcode로 열고 활성 대상이 실행 파일인지 확인하십시오. 옵션 키를 누른 상태로 드롭 다운 메뉴를 클릭하여 원하는 활성 실행 파일을 선택할 수 있습니다. - -3. **실행**을 누르십시오. - -4. 브라우저에서 `http://localhost:8080`을 여십시오. - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 웹 기본 스타터의 엔드-투-엔드 튜토리얼 +{: #tutorial} + +다음 엔드-투-엔드 튜토리얼은 설치해야 하는 도구를 포함하여 웹 기본 스타터에서 프로젝트를 작성하는 단계를 안내하고, 이어서 프로젝트 코드를 실행하는 단계를 안내합니다. + +## 개발자 도구 설치 +{: #dev_tools} + +[전제 조건 개발자 도구 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](get_code.html#prereq-dev-tools){: new_window}를 설치했는지 확인하십시오. + + +## {{site.data.keyword.dev_console}}을 사용하여 프로젝트 작성 +{: #create-devex} + +1. {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}에서 프로젝트를 작성하십시오. + + 1. {{site.data.keyword.dev_console}}의 **시작하기** 페이지에서 **프로젝트 작성**을 클릭하십시오. + + 또는 **프로젝트** 페이지에서 **프로젝트 작성**을 클릭할 수 있습니다. + + 2. **웹 앱**을 선택하고 **다음**을 클릭하십시오. + + 3. **기본 웹**을 선택하고 **다음**을 클릭하십시오. + + 4. 프로젝트 이름을 입력하십시오. 이 튜토리얼의 경우 `WebBasicProject`를 사용하십시오. + + 5. 호스트 이름을 입력하십시오. 이 튜토리얼의 경우 `devhost`를 사용하십시오. + + 6. 언어 플랫폼을 선택하십시오. 이 튜토리얼의 경우 `Swift`를 사용하십시오. + + 7. **작성**을 클릭하십시오. + +2. 선택사항: 데이터 기능을 추가하십시오. + + 1. **프로젝트 개요** 페이지에서 **데이터**에 대한 **보기**를 클릭하십시오. + + **기능 > 데이터** 페이지에서 **작성** 또는 **기존 추가**를 선택할 수도 있습니다. + + 2. 서비스 이름을 입력하고 **작성**을 클릭하십시오. + + +3. 프로젝트 코드를 생성하십시오. + + 1. **프로젝트 개요** 페이지에서 **코드 가져오기**를 클릭하여 언어를 선택하십시오. + + 또는 **코드** 페이지를 클릭할 수 있습니다. + + 2. **코드 생성**을 클릭하십시오. + + 3. 프로젝트 코드 생성이 완료되면 **코드 다운로드**를 클릭하여 프로젝트 아카이브를 다운로드하십시오. + +4. 선택사항: 새 언어를 생성하도록 [프로젝트를 업데이트하십시오](project_overview_page.html#update_language). + + +## {{site.data.keyword.dev_cli_notm}}을 사용하여 프로젝트 작성 +{: #create-cli} + +1. [{{site.data.keyword.dev_cli_short}}](dev_cli.html)을 설치했는지 확인하십시오. + +2. 터미널 프롬프트에서 원하는 로컬 디렉토리로 이동하여 다음 명령을 실행하십시오. + + ``` + bx dev create + ``` + {: codeblock} + + +3. 프롬프트가 표시되면 다음 값을 제공하십시오. + + * 패턴 선택: 1(웹) + * 스타터 선택: 1(기본 웹) + * 언어 선택: 2(Swift) + * 프로젝트의 이름 입력: `WebBasicProjectCLI` + * 프로젝트의 호스트 이름 입력: `myhost` + +4. 프로젝트에 서비스를 추가하려면 질문 프롬프트에서 `y`를 입력하고 나머지 질문에 응답하십시오. + +5. `WebBasicProjectCLI` 프로젝트가 저장되면 `WebBasicProjectCLI` 폴더로 이동하십시오. + +6. 고유 코드를 추가하거나, 프로젝트를 빌드하거나, 프로젝트를 실행하십시오. + + 1. 다음 명령을 사용하여 프로젝트를 빌드하십시오. + + ``` + bx dev build + ``` + {: codeblock} + + 2. 다음 명령을 사용하여 프로젝트를 실행하십시오. + + ``` + bx dev run + ``` + {: codeblock} + + +## 웹 프로젝트 실행 +{: #run} + +### 로컬 +{: #local notoc} + +1. 노드 종속 항목을 설치하십시오. + + ``` + npm install + ``` + {: codeblock} + +2. 프론트 엔드 코드를 모듈에 포함시키십시오. + + ``` + node_modules/.bin/gulp + ``` + {: codeblock} + +3. 서버를 컴파일하십시오. + + ``` + swift build + ``` + {: codeblock} + +4. 애플리케이션을 실행하십시오. + + ``` + .build/debug/WebBasicProjectCLI + ``` + {: codeblock} + +5. 브라우저에서 `http://localhost:8080`을 여십시오. + + +### {{site.data.keyword.dev_cli_short}} 사용 +{: #dev notoc} + +1. 노드 종속 항목을 설치하십시오. + + ``` + npm install + ``` + {: codeblock} + +2. 프론트 엔드 코드를 모듈에 포함시키십시오. + + ``` + gulp + ``` + {: codeblock} + +3. 컴파일을 실행하십시오. + + ``` + bx dev run + ``` + {: codeblock} + +4. 브라우저에서 `http://localhost:8080`을 여십시오. + + +## Xcode에서 프로젝트 실행 +{: #Xcode} + +1. Xcode 프로젝트를 작성하십시오. + + Xcode로 개발하려면 먼저 Swift 패키지 관리자를 사용하여 Xcode 프로젝트를 빌드해야 합니다. + + ``` + swift project generate-xcodeproj + ``` + {: codeblock} + +2. 활성 대상을 실행 파일로 변경하십시오. + + 다음, 프로젝트를 Xcode로 열고 활성 대상이 실행 파일인지 확인하십시오. 옵션 키를 누른 상태로 드롭 다운 메뉴를 클릭하여 원하는 활성 실행 파일을 선택할 수 있습니다. + +3. **실행**을 누르십시오. + +4. 브라우저에서 `http://localhost:8080`을 여십시오. + diff --git a/cloudnative/nl/ko/tutorials.md b/cloudnative/nl/ko/tutorials.md index ac64b5c7e..0966cdb8d 100644 --- a/cloudnative/nl/ko/tutorials.md +++ b/cloudnative/nl/ko/tutorials.md @@ -1,49 +1,49 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 엔드-투-엔드 튜토리얼 -{: #tutorial} - -다음 엔드-투-엔드 튜토리얼은 설치해야 하는 도구를 포함하여 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}에서 프로젝트를 작성하는 단계를 안내하고, 이어서 프로젝트 코드를 실행하는 단계를 안내합니다. - -## 웹 -{: #web notoc} - -* [웹 기본 튜토리얼](tutorial_web.html) - - -## 모바일 -{: #mobile notoc} - -* [모바일 기본 튜토리얼](tutorial_mobile.html) - - - - -## BFF -{: #bff notoc} - -* [BFF 기본 튜토리얼](tutorial_bff.html) - - -## 마이크로서비스 -{: #microservice notoc} - -* [마이크로서비스 기본 튜토리얼](tutorial_microservice.html) +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 엔드-투-엔드 튜토리얼 +{: #tutorial} + +다음 엔드-투-엔드 튜토리얼은 설치해야 하는 도구를 포함하여 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}에서 프로젝트를 작성하는 단계를 안내하고, 이어서 프로젝트 코드를 실행하는 단계를 안내합니다. + +## 웹 +{: #web notoc} + +* [웹 기본 튜토리얼](tutorial_web.html) + + +## 모바일 +{: #mobile notoc} + +* [모바일 기본 튜토리얼](tutorial_mobile.html) + + + + +## BFF +{: #bff notoc} + +* [BFF 기본 튜토리얼](tutorial_bff.html) + + +## 마이크로서비스 +{: #microservice notoc} + +* [마이크로서비스 기본 튜토리얼](tutorial_microservice.html) diff --git a/cloudnative/nl/ko/what_is_new.md b/cloudnative/nl/ko/what_is_new.md index 13959f841..10ee6f725 100644 --- a/cloudnative/nl/ko/what_is_new.md +++ b/cloudnative/nl/ko/what_is_new.md @@ -1,97 +1,97 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}의 새로운 기능 -{: #what-is-new} - - -## 새로운 기능: 2017년 3월 -{: #mar-2017} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}의 2017년 3월 업데이트에서 다음 변경사항이 도입되었습니다. - - * {{site.data.keyword.Bluemix_notm}} 모바일 대시보드가 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}로 변경되었습니다. - * 프로젝트 작성이 웹 앱, BFF 및 마이크로서비스 서버 패턴 유형을 포함하고 Node.js, Java 및 Swift를 지원하도록 다시 디자인되었습니다. - * 개선된 새 {{site.data.keyword.appid_full}} 서비스와의 통합을 통해 모바일 및 웹 프로젝트에 대한 인증을 제공합니다. - * 이제 [SDK Generator 플러그인](sdk_cli.html)을 사용하여 프로젝트에 대한 SDK를 추가로 생성할 수 있습니다. {{site.data.keyword.dev_console}}에서의 SDK 생성은 모바일 프로젝트의 경우에만 사용 가능합니다. - * 이제 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)을 사용하여 프로젝트를 추가로 작성할 수 있습니다. - - -## 새로운 기능: 2017년 1월 -{: #jan-2017} - -{{site.data.keyword.Bluemix_notm}} 모바일 대시보드의 2017년 1월 업데이트에서 다음 변경사항이 도입되었습니다. - - * 1월 31일을 기준으로 UI 스타터는 더 이상 사용되지 않습니다. UI 스타터에서 작성된 기존의 프로젝트는 2017년 4월 30일까지 사용할 수 있습니다. 마이그레이션 단계 및 제거 날짜에 대한 자세한 정보는 [지원 중단 공지사항 블로그 게시물 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/)을 참조하십시오. -{: deprecated} - * 이제 프로젝트를 삭제하고 새 프로젝트를 작성하는 대신 프로젝트 스타터 유형을 업데이트할 수 있습니다. - * 이제 [Watson Conversation](tutorial_conversation.html) 코드 스타터를 사용하여 프로젝트를 작성할 수 있습니다. - * 지원되는 경우 이제 프로젝트에 대한 SDK를 생성할 수 있습니다. - * 이제 기존의 [컴퓨팅](sdk_compute.html) 인스턴스를 추가하고 프로젝트에 추가할 클라이언트 SDK를 생성할 수 있습니다. - - -## 새로운 기능: 2016년 12월 -{: #dec-2016} - -{{site.data.keyword.Bluemix_notm}} 모바일 대시보드의 2016년 12월 업데이트에서 다음 변경사항이 도입되었습니다. - - * 이제 연결된 서비스를 프로젝트에서 제거함으로써 이를 삭제하거나 다른 프로젝트에서 다시 사용할 수 있습니다. - * 이제 기존의 서비스를 프로젝트에 추가할 수 있습니다. - * 이제 코드 스타터를 사용하는 경우 기존 CloudantNoSQL 서비스를 데이터 소스로 작성하거나 연결할 수 있습니다. - * 지원되는 경우 이제 기존 Object Storage 서비스를 프로젝트에 대한 데이터 소스로 작성하거나 연결할 수 있습니다. - * 이제 UI 스타터를 사용하여 작성 중인 앱의 탐색 디자인을 사용자 정의할 수 있습니다. - - -## 새로운 기능: 2016년 11월 -{: #nov-2016} - -{{site.data.keyword.Bluemix_notm}} 모바일 대시보드의 2016년 10월 업데이트에서 다음 변경사항이 도입되었습니다. - - * 이제 **코드** 페이지에서 프로젝트에 대해 SDK 아티팩트를 생성할 수 있습니다. - * 이제 기본 코드 스타터에서 Cordova가 지원됩니다. - * 이제 [네트워크 이벤트 보고 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} 및 [네트워크 요청 모니터 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} 작업을 {{site.data.keyword.mobileanalytics_short}} 콘솔의 **네트워크 요청** 페이지에서 수행할 수 있습니다. - * 이제 [dashDB로 데이터 내보내기 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} 작업을 {{site.data.keyword.mobileanalytics_short}} 콘솔에서 수행할 수 있습니다. - - -## 새로운 기능: 2016년 10월 -{: #oct-2016} - -{{site.data.keyword.Bluemix_notm}} 모바일 대시보드의 2016년 10월 업데이트에서 다음 변경사항이 도입되었습니다. - - * 이제 대시보드에서 직접 {{site.data.keyword.mobilepushshort}} 및 분석 기능을 프로젝트에 추가할 수 있습니다. - * [코드 스타터](starters.html#Code_Starter)를 사용할 수 있습니다. - * 코드 스타터에서 작성한 프로젝트에 인증을 추가할 수 있습니다. - * Swift가 지원됩니다. - - -### 분석 -{: #analytics notoc} - - * 분석 기능을 추가하면 기본적으로 데모 모드가 사용됩니다. 앱을 실행한 후 분석을 보기 위해 데모 모드를 토글하여 끌 수 있습니다. - - -### UI 빌더 -{: #ui_builder notoc} - - * 이제 프로젝트에서 **{{site.data.keyword.mobilepushshort}}** 기능에 액세스할 수 있습니다. - * **프로젝트 설정** 탭의 이름이 **설정** 탭으로 바뀌었습니다. - * **인증** 탭의 이름이 **사용자 액세스** 탭으로 바뀌었습니다. - - -### 코드 -{: #code notoc} - - * 생성된 iOS용 Objective-C 코드와 Swift 코드에서 CocoaPods를 사용하여 종속 항목을 관리합니다. 이는 CocoaPods를 설치해야 함을 의미합니다. 이를 설치하려면 `sudo gem install cocoapods`를 실행하십시오. CocoaPods 설치 후 `pod setup`을 실행하여 구성하십시오(아직 구성되지 않은 경우). 마지막으로 Xcode에서 `.xcworkspace` 파일을 열기 전에 `pod install`을 실행하여 필수 프로젝트 종속 항목을 다운로드하고 설치하십시오. 추가 세부사항은 다운로드된 코드 아카이브의 `README.md` 파일에 있습니다. 자세한 정보는 [전제조건 개발자 도구](get_code.html#prereq-dev-tools)를 살펴보십시오. - -자주 방문하여 추가되는 새 업데이트를 확인하십시오. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}의 새로운 기능 +{: #what-is-new} + + +## 새로운 기능: 2017년 3월 +{: #mar-2017} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}의 2017년 3월 업데이트에서 다음 변경사항이 도입되었습니다. + + * {{site.data.keyword.Bluemix_notm}} 모바일 대시보드가 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}로 변경되었습니다. + * 프로젝트 작성이 웹 앱, BFF 및 마이크로서비스 서버 패턴 유형을 포함하고 Node.js, Java 및 Swift를 지원하도록 다시 디자인되었습니다. + * 개선된 새 {{site.data.keyword.appid_full}} 서비스와의 통합을 통해 모바일 및 웹 프로젝트에 대한 인증을 제공합니다. + * 이제 [SDK Generator 플러그인](sdk_cli.html)을 사용하여 프로젝트에 대한 SDK를 추가로 생성할 수 있습니다. {{site.data.keyword.dev_console}}에서의 SDK 생성은 모바일 프로젝트의 경우에만 사용 가능합니다. + * 이제 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)을 사용하여 프로젝트를 추가로 작성할 수 있습니다. + + +## 새로운 기능: 2017년 1월 +{: #jan-2017} + +{{site.data.keyword.Bluemix_notm}} 모바일 대시보드의 2017년 1월 업데이트에서 다음 변경사항이 도입되었습니다. + + * 1월 31일을 기준으로 UI 스타터는 더 이상 사용되지 않습니다. UI 스타터에서 작성된 기존의 프로젝트는 2017년 4월 30일까지 사용할 수 있습니다. 마이그레이션 단계 및 제거 날짜에 대한 자세한 정보는 [지원 중단 공지사항 블로그 게시물 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/)을 참조하십시오. +{: deprecated} + * 이제 프로젝트를 삭제하고 새 프로젝트를 작성하는 대신 프로젝트 스타터 유형을 업데이트할 수 있습니다. + * 이제 [Watson Conversation](tutorial_conversation.html) 코드 스타터를 사용하여 프로젝트를 작성할 수 있습니다. + * 지원되는 경우 이제 프로젝트에 대한 SDK를 생성할 수 있습니다. + * 이제 기존의 [컴퓨팅](sdk_compute.html) 인스턴스를 추가하고 프로젝트에 추가할 클라이언트 SDK를 생성할 수 있습니다. + + +## 새로운 기능: 2016년 12월 +{: #dec-2016} + +{{site.data.keyword.Bluemix_notm}} 모바일 대시보드의 2016년 12월 업데이트에서 다음 변경사항이 도입되었습니다. + + * 이제 연결된 서비스를 프로젝트에서 제거함으로써 이를 삭제하거나 다른 프로젝트에서 다시 사용할 수 있습니다. + * 이제 기존의 서비스를 프로젝트에 추가할 수 있습니다. + * 이제 코드 스타터를 사용하는 경우 기존 CloudantNoSQL 서비스를 데이터 소스로 작성하거나 연결할 수 있습니다. + * 지원되는 경우 이제 기존 Object Storage 서비스를 프로젝트에 대한 데이터 소스로 작성하거나 연결할 수 있습니다. + * 이제 UI 스타터를 사용하여 작성 중인 앱의 탐색 디자인을 사용자 정의할 수 있습니다. + + +## 새로운 기능: 2016년 11월 +{: #nov-2016} + +{{site.data.keyword.Bluemix_notm}} 모바일 대시보드의 2016년 10월 업데이트에서 다음 변경사항이 도입되었습니다. + + * 이제 **코드** 페이지에서 프로젝트에 대해 SDK 아티팩트를 생성할 수 있습니다. + * 이제 기본 코드 스타터에서 Cordova가 지원됩니다. + * 이제 [네트워크 이벤트 보고 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} 및 [네트워크 요청 모니터 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} 작업을 {{site.data.keyword.mobileanalytics_short}} 콘솔의 **네트워크 요청** 페이지에서 수행할 수 있습니다. + * 이제 [dashDB로 데이터 내보내기 ![외부 링크 아이콘](../icons/launch-glyph.svg "외부 링크 아이콘")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} 작업을 {{site.data.keyword.mobileanalytics_short}} 콘솔에서 수행할 수 있습니다. + + +## 새로운 기능: 2016년 10월 +{: #oct-2016} + +{{site.data.keyword.Bluemix_notm}} 모바일 대시보드의 2016년 10월 업데이트에서 다음 변경사항이 도입되었습니다. + + * 이제 대시보드에서 직접 {{site.data.keyword.mobilepushshort}} 및 분석 기능을 프로젝트에 추가할 수 있습니다. + * [코드 스타터](starters.html#Code_Starter)를 사용할 수 있습니다. + * 코드 스타터에서 작성한 프로젝트에 인증을 추가할 수 있습니다. + * Swift가 지원됩니다. + + +### 분석 +{: #analytics notoc} + + * 분석 기능을 추가하면 기본적으로 데모 모드가 사용됩니다. 앱을 실행한 후 분석을 보기 위해 데모 모드를 토글하여 끌 수 있습니다. + + +### UI 빌더 +{: #ui_builder notoc} + + * 이제 프로젝트에서 **{{site.data.keyword.mobilepushshort}}** 기능에 액세스할 수 있습니다. + * **프로젝트 설정** 탭의 이름이 **설정** 탭으로 바뀌었습니다. + * **인증** 탭의 이름이 **사용자 액세스** 탭으로 바뀌었습니다. + + +### 코드 +{: #code notoc} + + * 생성된 iOS용 Objective-C 코드와 Swift 코드에서 CocoaPods를 사용하여 종속 항목을 관리합니다. 이는 CocoaPods를 설치해야 함을 의미합니다. 이를 설치하려면 `sudo gem install cocoapods`를 실행하십시오. CocoaPods 설치 후 `pod setup`을 실행하여 구성하십시오(아직 구성되지 않은 경우). 마지막으로 Xcode에서 `.xcworkspace` 파일을 열기 전에 `pod install`을 실행하여 필수 프로젝트 종속 항목을 다운로드하고 설치하십시오. 추가 세부사항은 다운로드된 코드 아카이브의 `README.md` 파일에 있습니다. 자세한 정보는 [전제조건 개발자 도구](get_code.html#prereq-dev-tools)를 살펴보십시오. + +자주 방문하여 추가되는 새 업데이트를 확인하십시오. diff --git a/cloudnative/nl/pt/BR/cli.md b/cloudnative/nl/pt/BR/cli.md index 48b3b51d7..2ec62cf38 100644 --- a/cloudnative/nl/pt/BR/cli.md +++ b/cloudnative/nl/pt/BR/cli.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Plug-ins para o {{site.data.keyword.Bluemix_notm}} CLI -{: #cli} - -Os plug-ins a seguir podem ser incluídos no {{site.data.keyword.Bluemix}} CLI. É possível usar esses plug-ins para criar os projetos do {{site.data.keyword.dev_console}}. - -* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) -* [Plug-in do {{site.data.keyword.IBM_notm}} SDK Generator](sdk_cli.html) +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Plug-ins para o {{site.data.keyword.Bluemix_notm}} CLI +{: #cli} + +Os plug-ins a seguir podem ser incluídos no {{site.data.keyword.Bluemix}} CLI. É possível usar esses plug-ins para criar os projetos do {{site.data.keyword.dev_console}}. + +* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) +* [Plug-in do {{site.data.keyword.IBM_notm}} SDK Generator](sdk_cli.html) diff --git a/cloudnative/nl/pt/BR/compute.md b/cloudnative/nl/pt/BR/compute.md index 77d11c410..e93b0526b 100644 --- a/cloudnative/nl/pt/BR/compute.md +++ b/cloudnative/nl/pt/BR/compute.md @@ -1,181 +1,181 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Cálculo -{: #compute} - -Quando você estiver construindo um aplicativo de canal digital nativo de nuvem para web e dispositivo móvel, a melhor prática será ter um Backend for Frontend (BFF) que seja dedicado ao canal digital ou que ofereça o mesmo suporte de integração de dados e lógico para os apps da web e do cliente móvel. Para obter mais informações sobre essa arquitetura, veja [Microsserviços para web e dispositivo móvel ![Ícone de link externo](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture). - -O diagrama a seguir mostra uma visão geral da arquitetura do BFF. - -![Arquitetura do BFF](images/bff-arch.png) - -Figura 1: Arquitetura do BFF - -O conceito de um BFF é separar a lógica de negócios comum e a lógica de integração dos microsserviços ou dos serviços de nuvem de alto valor do {{site.data.keyword.Bluemix}}. - -Com essa arquitetura, é possível implementar e liberar atualizações para seu aplicativo móvel ou da web e implementar novas versões do BFF usando pipelines de entrega contínua com o serviço dev ops. - -Se você tiver um BFF para iOS e um BFF separado para Android, as equipes de engenharia que estarão entregando a função para esses apps não serão restringidas a liberar recursos por um planejamento de liberação de API centralizado. Esse é um objetivo comum para arquiteturas de canal de microsserviço e digital - liberar as equipes para liberar função e recursos com frequência, sem estarem fortemente acopladas ao planejamento de liberação de outra equipe. - - - - -## Integrando um cliente móvel a um Backend for Frontend -{: #integration} - -Para ativar a fácil integração entre um cliente móvel e um BFF, o {{site.data.keyword.Bluemix_notm}} suportará a geração de SDK do cliente móvel para iOS e Android nas linguagens Swift e Java, respectivamente. Para ativar esse recurso, deve-se expor a integração do BFF usando um documento de especificação de Open API (Swagger). Esse documento poderá estar no formato de JSON ou YAML. - -O gerador de SDK do cliente usa o arquivo de definição de Open API para definir um SDK do desenvolver otimizado pelo cliente que seja fácil de consumir no aplicativo móvel nativo. Ele acelerará a integração de seu BFF para o aplicativo móvel. - - -## Definindo uma API -{: #definition} - -O BFF precisa expor um arquivo de definição de API que seja adequado à especificação de Open API que está em execução em um end point do servidor em tempo real. Para ativar o {{site.data.keyword.Bluemix_notm}} Developer Experience e o {{site.data.keyword.Bluemix_notm}} SDK CLI (Interface da linha de comandos) para descobrir esse terminal, deve-se incluir uma variável de ambiente no aplicativo Cloud Foundry chamada `OPENAPI_SPEC`. Essa variável de ambiente deve referenciar a especificação usando um caminho relativo. - -Para incluir a variável de ambiente `OPENAPI_SPEC` no {{site.data.keyword.Bluemix_notm}}, siga estas etapas: - -1. Efetue login no [{{site.data.keyword.Bluemix_notm}} ![Ícone de link externo](../icons/launch-glyph.svg)](http://bluemix.net). -2. Selecione um app Cloud Foundry. -3. Selecione **Tempo de execução**. -4. Selecione **Variáveis de ambiente**. -5. Clique em **Incluir** na seção **Definido pelo usuário**. -6. Especifique `OPENAPI_SPEC` para **NOME** e um caminho de URL relativa para seu arquivo de definição de Open API. -7. Clique em **Salvar**. - - - -Por exemplo: - -``` -OPENAPI_SPEC='/explorer/swagger.json' -``` -{: codeblock} - -Os aplicativos {{site.data.keyword.apiconnect_long}} e Loopback funcionam especialmente bem ao usar essa abordagem. É possível usar o Loopback e o {{site.data.keyword.apiconnect_short}} para definir um modelo persistente e expor a operação CRUD (Create, Read, Update, and Delete) usando o arquivo de definição de Open API. - -Também é possível definir operações de lógica de negócios. - - -### Elementos suportados da especificação de Open API -{: #supported-elements notoc} - -A única parte da especificação de Open API que não é totalmente suportada é a estrutura do arquivo. A especificação permite que partes da definição sejam divididas em arquivos diferentes e referenciadas usando o campo json `$ref`. Sua definição inteira deve estar contida em um arquivo. - - -## Exemplo de Backend for Frontend usando Bluegen -{: #bff-bluegen} - -O {{site.data.keyword.Bluemix_notm}} criou um BFF de referência usando o {{site.data.keyword.apiconnect_short}} e o Strongloop, que mapeiam um modelo de produto para um {{site.data.keyword.cloudant}} e uma API de imagem para referenciar imagens no {{site.data.keyword.objectstorageshort}}. - -É possível usar esse padrão de BFF para iniciar rapidamente o fornecimento de um BFF totalmente funcional para o {{site.data.keyword.Bluemix_notm}} e usá-lo para ajudar a entender como é fácil integrar um BFF a um projeto móvel e gerar SDKs nativos para iOS e Android no Swift e Java, respectivamente. - -Siga as instruções do [LEIA-ME ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) para criar e instalar um projeto. - - -## Usando o Backend for Frontend com um projeto do Developer Experience -{: #bff-devex} - -O {{site.data.keyword.Bluemix_notm}} Mobile Developer Experience foi projetado para simplificar a definição de um projeto móvel com vários serviços de nuvem associados. É possível incluir facilmente os serviços [{{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [Analytics ![Ícone de link externo](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html) e Data ou Storage. - -O {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} introduziu a capacidade de integrar um BFF a um projeto móvel na página **Cálculo**. É possível incluir instâncias de serviço de Cálculo existentes em seu projeto móvel. Depois se serem incluídas, será possível gerar um SDK nativo para sua opção de linguagem ou gerar o projeto completo e o SDK será integrado ao pacote de origem do projeto na página **Código**. Isso será especialmente útil quando você estiver integrando a BFFs já bem definidos. - -Depois de ter transferido seu projeto por download, será possível abri-lo com Xcode ou Android Studio e compilá-lo com o SDK do cliente. - - -## Utilizando o CLI -{: #cli} - -Conforme o BFF estiver sendo desenvolvido, a especificação de API poderá mudar. Para suportar essas mudanças, você tem as duas opções a seguir. - -* Gerar novamente o projeto inteiro em uma nova ramificação de GitHub e mesclar as mudanças na ramificação de desenvolvimento. -* Gerar novamente o SDK diretamente usando a ferramenta de linha de comandos (CLI) e atualizar apenas a parte de SDK do projeto móvel. - -Para usar a CLI, deve-se [instalá-la](sdk_cli.html#installation). - -Use o comando a seguir para listar as ações que podem ser executadas. - -``` -bluemix sdk -``` -{: codeblock} - -Use o comando a seguir para listar as instâncias em execução do Cloud Foundry no espaço atual do {{site.data.keyword.Bluemix_notm}}. - -``` -bluemix sdk list -``` -{: codeblock} - -Cada app é listado e a API será validada se a variável de ambiente `OPENAPI_SPEC` estiver configurada. Na coluna `VALID`, você verá um visto verde ou um `X` vermelho. Um visto na coluna `VALID` do aplicativo significa que uma definição válida de Open API está presente. Um `X` na coluna `VALID` do aplicativo significa uma de duas coisas: - -* uma variável de ambiente `OPENAPI_SPEC` não está definida para o aplicativo OU -* a definição de API não é válida com relação à especificação de Open API - -Use o comando a seguir para visualizar a URL completamente formada para a API. A rota e o URI completamente formados para a especificação de API são listados. É possível visualizar a especificação bruta em um navegador, consumi-la diretamente na CLI ou verificar se a variável de ambiente `OPENAPI_SPEC` do BFF está configurada corretamente. - -``` -bluemix sdk list --url -``` -{: codeblock} - -Use o comando a seguir para validar o arquivo de definição de Open API do `` para determinar se ele pode ser usado para gerar um SDK. O comando localiza `` no espaço atual e usa o caminho relativo na variável de ambiente `OPENAPI_SPEC` para localizar a especificação para validação. - -``` -bluemix sdk validate -``` -{: codeblock} - -Use o comando a seguir para gerar um SDK para a `< Platform>` nativa de sua preferência e colocar um arquivo compactado no diretório atualmente em funcionamento. - -``` -bluemix sdk generate -- -``` -{: codeblock} - -O uso da opção `--unzip` extrairá automaticamente o SDK no diretório atualmente em funcionamento. Opcionalmente, será possível especificar o local para extrair o SDK usando a opção `--output`. É possível gerenciar o código-fonte com GitHub e criar uma nova ramificação especificamente para atualizar o SDK. O uso dessa abordagem facilita a visualização das mudanças e a mesclagem no SDK atualizado na ramificação de desenvolvimento. - - -## Trabalhando com modelos e APIs gerados pelo SDK -{: #models-apis} - -Agora que o BFF foi integrado ao app móvel usando um SDK gerado, será possível iniciar o trabalho com ele. - -O SDK vem com documentação totalmente gerada nos diretórios `docs` e `source`. É possível abrir o arquivo `README.html` para uma visualização na web dos docs ou abrir o arquivo `README.md` para uma visualização de Redução de preço dos docs. Os docs de Redução de preço são úteis quando você está publicando o SDK no Cocoapods ou no Maven Central. - -Na documentação, é possível ver uma lista das APIs geradas. É possível clicar na API para ver um fragmento de código que pode ser colado diretamente no app móvel. +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Cálculo +{: #compute} + +Quando você estiver construindo um aplicativo de canal digital nativo de nuvem para web e dispositivo móvel, a melhor prática será ter um Backend for Frontend (BFF) que seja dedicado ao canal digital ou que ofereça o mesmo suporte de integração de dados e lógico para os apps da web e do cliente móvel. Para obter mais informações sobre essa arquitetura, veja [Microsserviços para web e dispositivo móvel ![Ícone de link externo](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture). + +O diagrama a seguir mostra uma visão geral da arquitetura do BFF. + +![Arquitetura do BFF](images/bff-arch.png) + +Figura 1: Arquitetura do BFF + +O conceito de um BFF é separar a lógica de negócios comum e a lógica de integração dos microsserviços ou dos serviços de nuvem de alto valor do {{site.data.keyword.Bluemix}}. + +Com essa arquitetura, é possível implementar e liberar atualizações para seu aplicativo móvel ou da web e implementar novas versões do BFF usando pipelines de entrega contínua com o serviço dev ops. + +Se você tiver um BFF para iOS e um BFF separado para Android, as equipes de engenharia que estarão entregando a função para esses apps não serão restringidas a liberar recursos por um planejamento de liberação de API centralizado. Esse é um objetivo comum para arquiteturas de canal de microsserviço e digital - liberar as equipes para liberar função e recursos com frequência, sem estarem fortemente acopladas ao planejamento de liberação de outra equipe. + + + + +## Integrando um cliente móvel a um Backend for Frontend +{: #integration} + +Para ativar a fácil integração entre um cliente móvel e um BFF, o {{site.data.keyword.Bluemix_notm}} suportará a geração de SDK do cliente móvel para iOS e Android nas linguagens Swift e Java, respectivamente. Para ativar esse recurso, deve-se expor a integração do BFF usando um documento de especificação de Open API (Swagger). Esse documento poderá estar no formato de JSON ou YAML. + +O gerador de SDK do cliente usa o arquivo de definição de Open API para definir um SDK do desenvolver otimizado pelo cliente que seja fácil de consumir no aplicativo móvel nativo. Ele acelerará a integração de seu BFF para o aplicativo móvel. + + +## Definindo uma API +{: #definition} + +O BFF precisa expor um arquivo de definição de API que seja adequado à especificação de Open API que está em execução em um end point do servidor em tempo real. Para ativar o {{site.data.keyword.Bluemix_notm}} Developer Experience e o {{site.data.keyword.Bluemix_notm}} SDK CLI (Interface da linha de comandos) para descobrir esse terminal, deve-se incluir uma variável de ambiente no aplicativo Cloud Foundry chamada `OPENAPI_SPEC`. Essa variável de ambiente deve referenciar a especificação usando um caminho relativo. + +Para incluir a variável de ambiente `OPENAPI_SPEC` no {{site.data.keyword.Bluemix_notm}}, siga estas etapas: + +1. Efetue login no [{{site.data.keyword.Bluemix_notm}} ![Ícone de link externo](../icons/launch-glyph.svg)](http://bluemix.net). +2. Selecione um app Cloud Foundry. +3. Selecione **Tempo de execução**. +4. Selecione **Variáveis de ambiente**. +5. Clique em **Incluir** na seção **Definido pelo usuário**. +6. Especifique `OPENAPI_SPEC` para **NOME** e um caminho de URL relativa para seu arquivo de definição de Open API. +7. Clique em **Salvar**. + + + +Por exemplo: + +``` +OPENAPI_SPEC='/explorer/swagger.json' +``` +{: codeblock} + +Os aplicativos {{site.data.keyword.apiconnect_long}} e Loopback funcionam especialmente bem ao usar essa abordagem. É possível usar o Loopback e o {{site.data.keyword.apiconnect_short}} para definir um modelo persistente e expor a operação CRUD (Create, Read, Update, and Delete) usando o arquivo de definição de Open API. + +Também é possível definir operações de lógica de negócios. + + +### Elementos suportados da especificação de Open API +{: #supported-elements notoc} + +A única parte da especificação de Open API que não é totalmente suportada é a estrutura do arquivo. A especificação permite que partes da definição sejam divididas em arquivos diferentes e referenciadas usando o campo json `$ref`. Sua definição inteira deve estar contida em um arquivo. + + +## Exemplo de Backend for Frontend usando Bluegen +{: #bff-bluegen} + +O {{site.data.keyword.Bluemix_notm}} criou um BFF de referência usando o {{site.data.keyword.apiconnect_short}} e o Strongloop, que mapeiam um modelo de produto para um {{site.data.keyword.cloudant}} e uma API de imagem para referenciar imagens no {{site.data.keyword.objectstorageshort}}. + +É possível usar esse padrão de BFF para iniciar rapidamente o fornecimento de um BFF totalmente funcional para o {{site.data.keyword.Bluemix_notm}} e usá-lo para ajudar a entender como é fácil integrar um BFF a um projeto móvel e gerar SDKs nativos para iOS e Android no Swift e Java, respectivamente. + +Siga as instruções do [LEIA-ME ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) para criar e instalar um projeto. + + +## Usando o Backend for Frontend com um projeto do Developer Experience +{: #bff-devex} + +O {{site.data.keyword.Bluemix_notm}} Mobile Developer Experience foi projetado para simplificar a definição de um projeto móvel com vários serviços de nuvem associados. É possível incluir facilmente os serviços [{{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html), [Analytics ![Ícone de link externo](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html) e Data ou Storage. + +O {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} introduziu a capacidade de integrar um BFF a um projeto móvel na página **Cálculo**. É possível incluir instâncias de serviço de Cálculo existentes em seu projeto móvel. Depois se serem incluídas, será possível gerar um SDK nativo para sua opção de linguagem ou gerar o projeto completo e o SDK será integrado ao pacote de origem do projeto na página **Código**. Isso será especialmente útil quando você estiver integrando a BFFs já bem definidos. + +Depois de ter transferido seu projeto por download, será possível abri-lo com Xcode ou Android Studio e compilá-lo com o SDK do cliente. + + +## Utilizando o CLI +{: #cli} + +Conforme o BFF estiver sendo desenvolvido, a especificação de API poderá mudar. Para suportar essas mudanças, você tem as duas opções a seguir. + +* Gerar novamente o projeto inteiro em uma nova ramificação de GitHub e mesclar as mudanças na ramificação de desenvolvimento. +* Gerar novamente o SDK diretamente usando a ferramenta de linha de comandos (CLI) e atualizar apenas a parte de SDK do projeto móvel. + +Para usar a CLI, deve-se [instalá-la](sdk_cli.html#installation). + +Use o comando a seguir para listar as ações que podem ser executadas. + +``` +bluemix sdk +``` +{: codeblock} + +Use o comando a seguir para listar as instâncias em execução do Cloud Foundry no espaço atual do {{site.data.keyword.Bluemix_notm}}. + +``` +bluemix sdk list +``` +{: codeblock} + +Cada app é listado e a API será validada se a variável de ambiente `OPENAPI_SPEC` estiver configurada. Na coluna `VALID`, você verá um visto verde ou um `X` vermelho. Um visto na coluna `VALID` do aplicativo significa que uma definição válida de Open API está presente. Um `X` na coluna `VALID` do aplicativo significa uma de duas coisas: + +* uma variável de ambiente `OPENAPI_SPEC` não está definida para o aplicativo OU +* a definição de API não é válida com relação à especificação de Open API + +Use o comando a seguir para visualizar a URL completamente formada para a API. A rota e o URI completamente formados para a especificação de API são listados. É possível visualizar a especificação bruta em um navegador, consumi-la diretamente na CLI ou verificar se a variável de ambiente `OPENAPI_SPEC` do BFF está configurada corretamente. + +``` +bluemix sdk list --url +``` +{: codeblock} + +Use o comando a seguir para validar o arquivo de definição de Open API do `` para determinar se ele pode ser usado para gerar um SDK. O comando localiza `` no espaço atual e usa o caminho relativo na variável de ambiente `OPENAPI_SPEC` para localizar a especificação para validação. + +``` +bluemix sdk validate +``` +{: codeblock} + +Use o comando a seguir para gerar um SDK para a `< Platform>` nativa de sua preferência e colocar um arquivo compactado no diretório atualmente em funcionamento. + +``` +bluemix sdk generate -- +``` +{: codeblock} + +O uso da opção `--unzip` extrairá automaticamente o SDK no diretório atualmente em funcionamento. Opcionalmente, será possível especificar o local para extrair o SDK usando a opção `--output`. É possível gerenciar o código-fonte com GitHub e criar uma nova ramificação especificamente para atualizar o SDK. O uso dessa abordagem facilita a visualização das mudanças e a mesclagem no SDK atualizado na ramificação de desenvolvimento. + + +## Trabalhando com modelos e APIs gerados pelo SDK +{: #models-apis} + +Agora que o BFF foi integrado ao app móvel usando um SDK gerado, será possível iniciar o trabalho com ele. + +O SDK vem com documentação totalmente gerada nos diretórios `docs` e `source`. É possível abrir o arquivo `README.html` para uma visualização na web dos docs ou abrir o arquivo `README.md` para uma visualização de Redução de preço dos docs. Os docs de Redução de preço são úteis quando você está publicando o SDK no Cocoapods ou no Maven Central. + +Na documentação, é possível ver uma lista das APIs geradas. É possível clicar na API para ver um fragmento de código que pode ser colado diretamente no app móvel. diff --git a/cloudnative/nl/pt/BR/dev_cli.md b/cloudnative/nl/pt/BR/dev_cli.md index 156988309..df8d93f7d 100644 --- a/cloudnative/nl/pt/BR/dev_cli.md +++ b/cloudnative/nl/pt/BR/dev_cli.md @@ -1,406 +1,406 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.dev_cli_short}} -{: #developercli} - -O {{site.data.keyword.dev_cli_long}} fornece uma abordagem extensível orientada por comandos para criar, desenvolver e implementar um projeto da web com o plug-in `dev`. Ideal para desenvolvedores que gostariam de usar o controle da linha de comandos ao desenvolver aplicativos de microsserviço de ponta a ponta. - -{: shortdesc} - -A {{site.data.keyword.dev_cli_notm}} usa dois contêineres para facilitar a construção e o teste do aplicativo. O primeiro é o contêiner de ferramentas que contém os utilitários necessários para construir e testar o aplicativo. O Dockerfile para esse contêiner é definido pelo parâmetro [dockerfile-tools](#command-parameters). Talvez você o considere um contêiner de desenvolvimento, pois contém as ferramentas normalmente úteis para o desenvolvimento de um tempo de execução específico. - -O segundo contêiner é o contêiner de execução. Esse contêiner tem um formato adequado para ser implementado para uso, por exemplo, no {{site.data.keyword.Bluemix}}. Como resultado, esse contêiner geralmente terá um ponto de entrada definido que inicia o aplicativo. Quando você selecionar para executar o aplicativo por meio da {{site.data.keyword.dev_cli_short}}, ele usará esse contêiner. O Dockerfile para esse contêiner é definido pelo parâmetro [dockerfile-run](#run-parameters). - - -## Incluindo a {{site.data.keyword.dev_cli_notm}} -{: #add-cli} - - -### Pré-requisitos -{: #prereq} - -São necessários alguns pré-requisitos para explorar totalmente e usar corretamente a {{site.data.keyword.dev_cli_short}}, uma vez que é altamente extensível e permite aproveitar tecnologias complementares adicionais. - -1. Instale o [Cloud Foundry CLI ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/cloudfoundry/cli#getting-started). - -2. Instale o [{{site.data.keyword.Bluemix}} CLI ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://clis.ng.bluemix.net/ui/home.html). - -3. Obtenha um ID do [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net). - -4. Opcional: se planeja executar e depurar aplicativos localmente, deve-se também instalar o [Docker ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.docker.com/get-docker). Isso é necessário apenas para projetos não móveis. - - -### Installing -{: #installation} - -1. Instale a [{{site.data.keyword.dev_cli_short}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} executando o comando a seguir: - - ``` - bx plugin install dev -r Bluemix - ``` - {: codeblock} - -2. Valide a instalação bem-sucedida executando o comando a seguir: - - ``` - bx dev - ``` - {: codeblock} - - -### Antes de Come╬ar -{: #before-install} - -1. Efetue login no {{site.data.keyword.Bluemix_notm}}. - - ``` - bx login - ``` - {: codeblock} - - **Nota:** se as suas credenciais forem rejeitadas, é possível que você esteja usando um ID federado. Siga estas etapas para se autenticar usando um ID federado: - - - - 1. Efetue login no [{{site.data.keyword.iamshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.bluemix.net/iam/#/apikeys){: new_window}. - 2. Selecione **Criar chave API**. - * Insira um nome e uma descrição da apiKey - 3. Faça download da apiKey. - 4. Abra o arquivo e copie o valor do campo `apiKey`. - 5. Efetue login usando o seguinte comando: - - ``` - bx login --apikey - ``` - {: codeblock} - - -## Comandos -{: #commands} - -Use os comandos a seguir para criar, implementar, depurar e testar um projeto. - -### Compilação -{: #build} - -É possível construir o aplicativo usando o comando `build`. O elemento de configuração `build-cmd-run` é usado para construir o aplicativo. Os comandos `test`, `debug` e `run` executam uma construção da mesma maneira que esse comando como parte de sua operação normal e, assim, executar esse comando antes deles não é necessário. - -Execute o comando a seguir no diretório de projeto atual para construir seu aplicativo: - -``` -bx dev build -``` -{: codeblock} - - -[Parâmetros do comando de construção](#command-parameters) - - -### Código -{: #code} - -O comando `code` permite fazer download do código do aplicativo após a implementação para que você possa revisar localmente ou fazer mudanças adicionais. - -Execute o comando a seguir para fazer download do código de um projeto especificado. - -``` -bx dev code -``` -{: codeblock} - - -### criar -{: #create} - -Crie um novo projeto, solicitando todas as informações necessárias, incluindo a linguagem, o nome do projeto e o tipo padrão de app. O projeto será criado no diretório atual. - -Para criar um novo projeto no diretório de projeto atual e associar serviços a ele, execute o comando a seguir: - -``` -bx dev create -``` -{: codeblock} - - -### Debug -{: #debug} - -É possível depurar o aplicativo por meio do comando `debug`. Uma construção é concluída primeiramente no projeto usando o elemento de configuração `build-cmd-debug` como a instrução de construção. Um contêiner é então iniciado expondo uma porta ou portas de depuração, conforme definido no `container-port-map-debug`. Conecte sua ferramenta de depuração favorita à porta ou portas e será possível depurar seu aplicativo normalmente. - -**Limitação**: atualmente, os projetos Swift não estão disponíveis para depuração. - -Execute o comando a seguir no diretório de projeto atual para depurar seu aplicativo: - -``` -bx dev debug -``` -{: codeblock} - -Para sair da sessão de depuração, use `CTRL-C`. - - -#### Parâmetros do comando de depuração -{: #debug-parameters} - -Os parâmetros a seguir são exclusivos para o comando `debug` e -ajudam na depuração de um aplicativo. - -##### `container-port-map-debug` -{: #port-map-debug} - -* Mapeamentos de porta para a porta de depuração. O primeiro valor é a porta a ser usada no OS do host, a segunda é a porta no contêiner (host:container). -* Uso: `bx dev debug container-port-map-debug [7777:7777]` - -##### `build-cmd-debug` -{: #build-cmd-debug} - -* Usado para construir código para DEBUG. -* Uso: `bx dev debug build-cmd-debug build.command.sh` - -##### `debug-cmd` -{: #debug-cmd} - -* Usado para depurar código no contêiner de ferramentas. Isso será opcional se o `build-cmd-debug` for iniciar seu aplicativo na depuração. -* Uso: `bx dev debug debug-cmd /the/debug/command` - -#### Depuração de aplicativo local: -{: #local-app-dev} - -Para obter mais informações sobre a depuração de aplicativo local, veja [Depuração de aplicativo local](docs/cloudnative/dev_cli_local_debug.html#local-debug). - - -### Apagar -{: #delete} - -Esse comando permite remover projetos do espaço do {{site.data.keyword.Bluemix}}. - -Execute o comando a seguir para excluir seu projeto do {{site.data.keyword.Bluemix}}: - -``` -bx dev delete -``` -{: codeblock} - - -**Nota** os serviços do {{site.data.keyword.Bluemix}} **não** são removidos. - - -### Help -{: #help} - -Por padrão, se nenhuma ação ou argumento for passado ou se a ação 'ajuda' for fornecida, esse comando mostrará um texto "Ajuda" geral. A ajuda geral exibida inclui uma descrição dos argumentos de base, bem como uma listagem das ações disponíveis. - -Execute o comando a seguir para exibir informações da ajuda Geral: - -``` -bx dev help -``` -{: codeblock} - - -### Listar -{: #list} - -É possível listar todos os projetos do {{site.data.keyword.Bluemix_notm}} em um espaço. - -Execute o comando a seguir para listar seus projetos: - -``` -bx dev list -``` -{: codeblock} - - - - - -### Run -{: #run} - -É possível executar seu aplicativo por meio do comando `run`. Uma construção é concluída primeiramente no projeto usando o elemento de configuração `build-cmd-run` como a instrução de construção. O contêiner de execução é então iniciado e expõe as portas, conforme definido no `container-port-map`. O `run-cmd` poderá ser usado para chamar o aplicativo se o contêiner de execução não contiver um ponto de entrada para concluir essa etapa. - -Execute o comando a seguir no diretório de projeto atual para iniciar seu aplicativo: - -``` -bx dev run -``` -{: codeblock} - -Para sair da sessão, use `CTRL-C`. - - -#### Parâmetros de Execução -{: #run-parameters} - -Os parâmetros a seguir são exclusivos para o comando `run` e -ajudam no gerenciamento do aplicativo dentro do contêiner de execução. - -##### `container-name-run` -{: #container-name-run} - -* Nome do contêiner para o contêiner de execução. -* Uso: `bx dev run container-name-run ` - -##### `container-path-run` -{: #container-path-run} - -* Local no contêiner para compartilhar na execução. -* Uso: `bx dev run container-path-run [/path/to/app]` - -##### `host-path-run` -{: #host-path-run} - -* Local no sistema host para compartilhar no contêiner na execução. -* Uso: `bx dev run host-path-run [/path/to/app/bin]` - -##### `dockerfile-run` -{: #dockerfile-run} - -* Arquivo Docker para o contêiner de execução. -* Uso: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` - -##### `image-name-run` -{: #image-name-run} - -* Imagem a ser criada do dockerfile-run. -* Uso: `bx dev run image-name-run [/path/to/image-name]` - -##### `run-cmd` -{: #run-cmd} - -* Parâmetro opcional usado para executar código no contêiner de execução. Isso será opcional se a imagem for iniciar seu aplicativo. -* Uso: `bx dev run run-cmd [/the/run/command]` - -### Status do -{: #status} - -É possível consultar o status dos contêineres usados pela {{site.data.keyword.dev_cli_short}}, conforme definido por `container-name-run` e `container-name-tools`. - -Execute o comando a seguir no diretório de projeto atual para verificar o status do contêiner: - -``` -bx dev status -``` -{: codeblock} - - -[Parâmetros do comando de status](#command-parameters) - - -### Stop -{: #stop} - -É possível parar um contêiner por meio do comando `stop`. O parâmetro `container-name` permite especificar o contêiner a ser parado. Se isso não for especificado, o comando stop parará o contêiner de execução, conforme definido por `container-name-run`. - -Execute o comando a seguir no diretório de projeto atual para parar um contêiner: - -``` -bx dev stop -``` -{: codeblock} - - -#### Parâmetro de parada adicional: -{: #stop-parameter} - -##### `container-name` -{: #container-name} - -* O nome do contêiner para o contêiner de ferramentas. -* Uso: `bx dev stop container-name ` - -### Testar (Test) -{: #test} - -É possível testar o aplicativo por meio do comando `test`. Uma construção é concluída primeiramente no projeto usando o elemento de configuração `build-cmd-run` como a instrução de construção. O contêiner de ferramentas é então usado para chamar o `test-cmd` para o aplicativo. - -Execute o comando a seguir para testar seu aplicativo: - -``` -bx dev test -``` -{: codeblock} - - -[Parâmetros do comando de teste](#command-parameters) - - -## Parâmetros para construir, depurar, executar e testar -{: #command-parameters} - -Os parâmetros a seguir podem ser usados junto aos comandos `build|debug|run|test` e podem ser especificados por meio da linha de comandos e/ou atualizando o arquivo `cli-config.yml` do projeto diretamente. Há parâmetros adicionais disponíveis para os comandos [`debug`](#debug-parameters) e [`run`](#run-parameters) e estão documentados em suas respectivas seções. - -**Nota**: os parâmetros de comando inseridos na linha de comandos têm precedência sobre a configuração de `cli-config.yml`. - -##### `container-name-tools` -{: #container-name-tools} - -* O nome do contêiner para o contêiner de ferramentas. -* Uso: `bx dev container-name-tools []` - -##### `host-path-tools` -{: #host-path-tools} - -* Local no host a ser compartilhado para construção, depuração, teste. -* Uso: `bx dev host-path-tools [/path/to/build/tools]` - -##### `container-path-tools` -{: #container-path-tools} - -* Local no contêiner a ser compartilhado para construção, depuração, teste. -* Uso: `bx dev container-path-tools [/path/for/build]` - -##### `container-port-map` -{: #container-port-map} - -* Mapeamentos de porta para o contêiner. O primeiro valor é a porta a ser usada no OS do host, a segunda é a porta no contêiner (host:container). -* Uso: `bx dev container-port-map [8090:8090,9090,9090]` - -##### `dockerfile-tools` -{: #dockerfile-tools} - -* Arquivo Docker para o contêiner de ferramentas. -* Uso: `bx dev dockerfile-tools [path/to/dockerfile]` - -##### `image-name-tools` -{: #image-name-tools} - -* Imagem a ser criada do dockerfile-tools. -* Uso: `bx dev image-name-tools [path/to/image-name]` - -##### `build-cmd-run` -{: #build-cmd-run} - -* Comando para construir código para todos os usos, exceto DEBUG. -* Uso: `bx dev build-cmd-run [some.build.command]` - -##### `test-cmd` -{: #test-cmd} - -* Comando para testar código no contêiner de ferramentas. -* Uso: `bx dev test-cmd [/the/test/command]` - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.dev_cli_short}} +{: #developercli} + +O {{site.data.keyword.dev_cli_long}} fornece uma abordagem extensível orientada por comandos para criar, desenvolver e implementar um projeto da web com o plug-in `dev`. Ideal para desenvolvedores que gostariam de usar o controle da linha de comandos ao desenvolver aplicativos de microsserviço de ponta a ponta. + +{: shortdesc} + +A {{site.data.keyword.dev_cli_notm}} usa dois contêineres para facilitar a construção e o teste do aplicativo. O primeiro é o contêiner de ferramentas que contém os utilitários necessários para construir e testar o aplicativo. O Dockerfile para esse contêiner é definido pelo parâmetro [dockerfile-tools](#command-parameters). Talvez você o considere um contêiner de desenvolvimento, pois contém as ferramentas normalmente úteis para o desenvolvimento de um tempo de execução específico. + +O segundo contêiner é o contêiner de execução. Esse contêiner tem um formato adequado para ser implementado para uso, por exemplo, no {{site.data.keyword.Bluemix}}. Como resultado, esse contêiner geralmente terá um ponto de entrada definido que inicia o aplicativo. Quando você selecionar para executar o aplicativo por meio da {{site.data.keyword.dev_cli_short}}, ele usará esse contêiner. O Dockerfile para esse contêiner é definido pelo parâmetro [dockerfile-run](#run-parameters). + + +## Incluindo a {{site.data.keyword.dev_cli_notm}} +{: #add-cli} + + +### Pré-requisitos +{: #prereq} + +São necessários alguns pré-requisitos para explorar totalmente e usar corretamente a {{site.data.keyword.dev_cli_short}}, uma vez que é altamente extensível e permite aproveitar tecnologias complementares adicionais. + +1. Instale o [Cloud Foundry CLI ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/cloudfoundry/cli#getting-started). + +2. Instale o [{{site.data.keyword.Bluemix}} CLI ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://clis.ng.bluemix.net/ui/home.html). + +3. Obtenha um ID do [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net). + +4. Opcional: se planeja executar e depurar aplicativos localmente, deve-se também instalar o [Docker ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.docker.com/get-docker). Isso é necessário apenas para projetos não móveis. + + +### Installing +{: #installation} + +1. Instale a [{{site.data.keyword.dev_cli_short}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window} executando o comando a seguir: + + ``` + bx plugin install dev -r Bluemix + ``` + {: codeblock} + +2. Valide a instalação bem-sucedida executando o comando a seguir: + + ``` + bx dev + ``` + {: codeblock} + + +### Antes de Come╬ar +{: #before-install} + +1. Efetue login no {{site.data.keyword.Bluemix_notm}}. + + ``` + bx login + ``` + {: codeblock} + + **Nota:** se as suas credenciais forem rejeitadas, é possível que você esteja usando um ID federado. Siga estas etapas para se autenticar usando um ID federado: + + + + 1. Efetue login no [{{site.data.keyword.iamshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.bluemix.net/iam/#/apikeys){: new_window}. + 2. Selecione **Criar chave API**. + * Insira um nome e uma descrição da apiKey + 3. Faça download da apiKey. + 4. Abra o arquivo e copie o valor do campo `apiKey`. + 5. Efetue login usando o seguinte comando: + + ``` + bx login --apikey + ``` + {: codeblock} + + +## Comandos +{: #commands} + +Use os comandos a seguir para criar, implementar, depurar e testar um projeto. + +### Compilação +{: #build} + +É possível construir o aplicativo usando o comando `build`. O elemento de configuração `build-cmd-run` é usado para construir o aplicativo. Os comandos `test`, `debug` e `run` executam uma construção da mesma maneira que esse comando como parte de sua operação normal e, assim, executar esse comando antes deles não é necessário. + +Execute o comando a seguir no diretório de projeto atual para construir seu aplicativo: + +``` +bx dev build +``` +{: codeblock} + + +[Parâmetros do comando de construção](#command-parameters) + + +### Código +{: #code} + +O comando `code` permite fazer download do código do aplicativo após a implementação para que você possa revisar localmente ou fazer mudanças adicionais. + +Execute o comando a seguir para fazer download do código de um projeto especificado. + +``` +bx dev code +``` +{: codeblock} + + +### criar +{: #create} + +Crie um novo projeto, solicitando todas as informações necessárias, incluindo a linguagem, o nome do projeto e o tipo padrão de app. O projeto será criado no diretório atual. + +Para criar um novo projeto no diretório de projeto atual e associar serviços a ele, execute o comando a seguir: + +``` +bx dev create +``` +{: codeblock} + + +### Debug +{: #debug} + +É possível depurar o aplicativo por meio do comando `debug`. Uma construção é concluída primeiramente no projeto usando o elemento de configuração `build-cmd-debug` como a instrução de construção. Um contêiner é então iniciado expondo uma porta ou portas de depuração, conforme definido no `container-port-map-debug`. Conecte sua ferramenta de depuração favorita à porta ou portas e será possível depurar seu aplicativo normalmente. + +**Limitação**: atualmente, os projetos Swift não estão disponíveis para depuração. + +Execute o comando a seguir no diretório de projeto atual para depurar seu aplicativo: + +``` +bx dev debug +``` +{: codeblock} + +Para sair da sessão de depuração, use `CTRL-C`. + + +#### Parâmetros do comando de depuração +{: #debug-parameters} + +Os parâmetros a seguir são exclusivos para o comando `debug` e +ajudam na depuração de um aplicativo. + +##### `container-port-map-debug` +{: #port-map-debug} + +* Mapeamentos de porta para a porta de depuração. O primeiro valor é a porta a ser usada no OS do host, a segunda é a porta no contêiner (host:container). +* Uso: `bx dev debug container-port-map-debug [7777:7777]` + +##### `build-cmd-debug` +{: #build-cmd-debug} + +* Usado para construir código para DEBUG. +* Uso: `bx dev debug build-cmd-debug build.command.sh` + +##### `debug-cmd` +{: #debug-cmd} + +* Usado para depurar código no contêiner de ferramentas. Isso será opcional se o `build-cmd-debug` for iniciar seu aplicativo na depuração. +* Uso: `bx dev debug debug-cmd /the/debug/command` + +#### Depuração de aplicativo local: +{: #local-app-dev} + +Para obter mais informações sobre a depuração de aplicativo local, veja [Depuração de aplicativo local](docs/cloudnative/dev_cli_local_debug.html#local-debug). + + +### Apagar +{: #delete} + +Esse comando permite remover projetos do espaço do {{site.data.keyword.Bluemix}}. + +Execute o comando a seguir para excluir seu projeto do {{site.data.keyword.Bluemix}}: + +``` +bx dev delete +``` +{: codeblock} + + +**Nota** os serviços do {{site.data.keyword.Bluemix}} **não** são removidos. + + +### Help +{: #help} + +Por padrão, se nenhuma ação ou argumento for passado ou se a ação 'ajuda' for fornecida, esse comando mostrará um texto "Ajuda" geral. A ajuda geral exibida inclui uma descrição dos argumentos de base, bem como uma listagem das ações disponíveis. + +Execute o comando a seguir para exibir informações da ajuda Geral: + +``` +bx dev help +``` +{: codeblock} + + +### Listar +{: #list} + +É possível listar todos os projetos do {{site.data.keyword.Bluemix_notm}} em um espaço. + +Execute o comando a seguir para listar seus projetos: + +``` +bx dev list +``` +{: codeblock} + + + + + +### Run +{: #run} + +É possível executar seu aplicativo por meio do comando `run`. Uma construção é concluída primeiramente no projeto usando o elemento de configuração `build-cmd-run` como a instrução de construção. O contêiner de execução é então iniciado e expõe as portas, conforme definido no `container-port-map`. O `run-cmd` poderá ser usado para chamar o aplicativo se o contêiner de execução não contiver um ponto de entrada para concluir essa etapa. + +Execute o comando a seguir no diretório de projeto atual para iniciar seu aplicativo: + +``` +bx dev run +``` +{: codeblock} + +Para sair da sessão, use `CTRL-C`. + + +#### Parâmetros de Execução +{: #run-parameters} + +Os parâmetros a seguir são exclusivos para o comando `run` e +ajudam no gerenciamento do aplicativo dentro do contêiner de execução. + +##### `container-name-run` +{: #container-name-run} + +* Nome do contêiner para o contêiner de execução. +* Uso: `bx dev run container-name-run ` + +##### `container-path-run` +{: #container-path-run} + +* Local no contêiner para compartilhar na execução. +* Uso: `bx dev run container-path-run [/path/to/app]` + +##### `host-path-run` +{: #host-path-run} + +* Local no sistema host para compartilhar no contêiner na execução. +* Uso: `bx dev run host-path-run [/path/to/app/bin]` + +##### `dockerfile-run` +{: #dockerfile-run} + +* Arquivo Docker para o contêiner de execução. +* Uso: `bx dev run dockerfile-run [/path/to/Dockerfile.yml]` + +##### `image-name-run` +{: #image-name-run} + +* Imagem a ser criada do dockerfile-run. +* Uso: `bx dev run image-name-run [/path/to/image-name]` + +##### `run-cmd` +{: #run-cmd} + +* Parâmetro opcional usado para executar código no contêiner de execução. Isso será opcional se a imagem for iniciar seu aplicativo. +* Uso: `bx dev run run-cmd [/the/run/command]` + +### Status do +{: #status} + +É possível consultar o status dos contêineres usados pela {{site.data.keyword.dev_cli_short}}, conforme definido por `container-name-run` e `container-name-tools`. + +Execute o comando a seguir no diretório de projeto atual para verificar o status do contêiner: + +``` +bx dev status +``` +{: codeblock} + + +[Parâmetros do comando de status](#command-parameters) + + +### Stop +{: #stop} + +É possível parar um contêiner por meio do comando `stop`. O parâmetro `container-name` permite especificar o contêiner a ser parado. Se isso não for especificado, o comando stop parará o contêiner de execução, conforme definido por `container-name-run`. + +Execute o comando a seguir no diretório de projeto atual para parar um contêiner: + +``` +bx dev stop +``` +{: codeblock} + + +#### Parâmetro de parada adicional: +{: #stop-parameter} + +##### `container-name` +{: #container-name} + +* O nome do contêiner para o contêiner de ferramentas. +* Uso: `bx dev stop container-name ` + +### Testar (Test) +{: #test} + +É possível testar o aplicativo por meio do comando `test`. Uma construção é concluída primeiramente no projeto usando o elemento de configuração `build-cmd-run` como a instrução de construção. O contêiner de ferramentas é então usado para chamar o `test-cmd` para o aplicativo. + +Execute o comando a seguir para testar seu aplicativo: + +``` +bx dev test +``` +{: codeblock} + + +[Parâmetros do comando de teste](#command-parameters) + + +## Parâmetros para construir, depurar, executar e testar +{: #command-parameters} + +Os parâmetros a seguir podem ser usados junto aos comandos `build|debug|run|test` e podem ser especificados por meio da linha de comandos e/ou atualizando o arquivo `cli-config.yml` do projeto diretamente. Há parâmetros adicionais disponíveis para os comandos [`debug`](#debug-parameters) e [`run`](#run-parameters) e estão documentados em suas respectivas seções. + +**Nota**: os parâmetros de comando inseridos na linha de comandos têm precedência sobre a configuração de `cli-config.yml`. + +##### `container-name-tools` +{: #container-name-tools} + +* O nome do contêiner para o contêiner de ferramentas. +* Uso: `bx dev container-name-tools []` + +##### `host-path-tools` +{: #host-path-tools} + +* Local no host a ser compartilhado para construção, depuração, teste. +* Uso: `bx dev host-path-tools [/path/to/build/tools]` + +##### `container-path-tools` +{: #container-path-tools} + +* Local no contêiner a ser compartilhado para construção, depuração, teste. +* Uso: `bx dev container-path-tools [/path/for/build]` + +##### `container-port-map` +{: #container-port-map} + +* Mapeamentos de porta para o contêiner. O primeiro valor é a porta a ser usada no OS do host, a segunda é a porta no contêiner (host:container). +* Uso: `bx dev container-port-map [8090:8090,9090,9090]` + +##### `dockerfile-tools` +{: #dockerfile-tools} + +* Arquivo Docker para o contêiner de ferramentas. +* Uso: `bx dev dockerfile-tools [path/to/dockerfile]` + +##### `image-name-tools` +{: #image-name-tools} + +* Imagem a ser criada do dockerfile-tools. +* Uso: `bx dev image-name-tools [path/to/image-name]` + +##### `build-cmd-run` +{: #build-cmd-run} + +* Comando para construir código para todos os usos, exceto DEBUG. +* Uso: `bx dev build-cmd-run [some.build.command]` + +##### `test-cmd` +{: #test-cmd} + +* Comando para testar código no contêiner de ferramentas. +* Uso: `bx dev test-cmd [/the/test/command]` + diff --git a/cloudnative/nl/pt/BR/dev_cli_local_debug.md b/cloudnative/nl/pt/BR/dev_cli_local_debug.md index 1561a0bc3..04c4364d3 100644 --- a/cloudnative/nl/pt/BR/dev_cli_local_debug.md +++ b/cloudnative/nl/pt/BR/dev_cli_local_debug.md @@ -1,76 +1,76 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Depuração do aplicativo local -{: #local-debug} - -As instruções para a depuração do aplicativo local são fornecidas abaixo para as linguagens a seguir: - -* [Java](#java) -* [Node.js](#node) - -**Nota**: a depuração do aplicativo Swift não é suportada atualmente. - -## Depuração do aplicativo Java -{: #java} - -Etapas para ativar a depuração de um aplicativo Java: - -1. No diretório raiz do projeto do aplicativo, execute o comando a seguir: - - `bx dev debug` - -2. Conectando o depurador a seu aplicativo: - - * [Eclipse ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) - * [IntelliJ ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) - * [VSCode ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) - * Linha de comandos JDK: `jdb -attach ` - -## Depuração do aplicativo Node.js - -{: #node} - -Etapas para ativar a depuração de um aplicativo Node.js: - -1. No diretório raiz do projeto do aplicativo, execute o comando a seguir: - - `bx dev debug` - -2. Conectando o depurador a seu aplicativo: - * [VSCode ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://blog.docker.com/2016/07/live-debugging-docker/). - * [WebStorm ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Depuração do aplicativo local +{: #local-debug} + +As instruções para a depuração do aplicativo local são fornecidas abaixo para as linguagens a seguir: + +* [Java](#java) +* [Node.js](#node) + +**Nota**: a depuração do aplicativo Swift não é suportada atualmente. + +## Depuração do aplicativo Java +{: #java} + +Etapas para ativar a depuração de um aplicativo Java: + +1. No diretório raiz do projeto do aplicativo, execute o comando a seguir: + + `bx dev debug` + +2. Conectando o depurador a seu aplicativo: + + * [Eclipse ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) + * [IntelliJ ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) + * [VSCode ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) + * Linha de comandos JDK: `jdb -attach ` + +## Depuração do aplicativo Node.js + +{: #node} + +Etapas para ativar a depuração de um aplicativo Node.js: + +1. No diretório raiz do projeto do aplicativo, execute o comando a seguir: + + `bx dev debug` + +2. Conectando o depurador a seu aplicativo: + * [VSCode ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://blog.docker.com/2016/07/live-debugging-docker/). + * [WebStorm ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) + + + + + diff --git a/cloudnative/nl/pt/BR/devex.md b/cloudnative/nl/pt/BR/devex.md index 02198e134..c8eaf1389 100644 --- a/cloudnative/nl/pt/BR/devex.md +++ b/cloudnative/nl/pt/BR/devex.md @@ -1,31 +1,31 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.dev_console}} -{: #devex} - -Para uma introdução ao [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://console.{DomainName}/developer/getting-started), clique na categoria **Web e Mobile** no console do {{site.data.keyword.Bluemix_notm}}. - - -## Guia de Introdução -{: getting-started} - -Crie um projeto na página **Introdução** clicando em **Criar projeto**. Serão apresentadas as opções [padrão](patterns.html), [iniciador](starters.html) e [idioma](patterns.html#languages) que permitem criar rapidamente seu app. - -É possível visualizar e gerenciar todos os seus projetos em um local selecionando a página [Projetos ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://console.{DomainName}/developer/projects). O projeto mantém as informações de todos os recursos que estão (e podem ser) integrados ao app. Se ele estiver disponível, será possível integrar e gerenciar facilmente os serviços Push, Analytics, Authentication e Data no projeto, com mais recursos para seguir no futuro próximo. - -A página [Serviços](services.html) mostra uma visão operacional das instâncias de serviço existentes. O {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} suporta um desenvolvedor nativo de nuvem e um usuário de gerenciamento de app nativo de nuvem. - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.dev_console}} +{: #devex} + +Para uma introdução ao [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://console.{DomainName}/developer/getting-started), clique na categoria **Web e Mobile** no console do {{site.data.keyword.Bluemix_notm}}. + + +## Guia de Introdução +{: getting-started} + +Crie um projeto na página **Introdução** clicando em **Criar projeto**. Serão apresentadas as opções [padrão](patterns.html), [iniciador](starters.html) e [idioma](patterns.html#languages) que permitem criar rapidamente seu app. + +É possível visualizar e gerenciar todos os seus projetos em um local selecionando a página [Projetos ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://console.{DomainName}/developer/projects). O projeto mantém as informações de todos os recursos que estão (e podem ser) integrados ao app. Se ele estiver disponível, será possível integrar e gerenciar facilmente os serviços Push, Analytics, Authentication e Data no projeto, com mais recursos para seguir no futuro próximo. + +A página [Serviços](services.html) mostra uma visão operacional das instâncias de serviço existentes. O {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} suporta um desenvolvedor nativo de nuvem e um usuário de gerenciamento de app nativo de nuvem. + + + diff --git a/cloudnative/nl/pt/BR/get_code.md b/cloudnative/nl/pt/BR/get_code.md index faaa09d59..5db68370f 100644 --- a/cloudnative/nl/pt/BR/get_code.md +++ b/cloudnative/nl/pt/BR/get_code.md @@ -1,86 +1,86 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-18" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# Obter código -{: #Get_Code} - -Ao concluir a configuração e a instalação de seu projeto com os recursos selecionados, será possível fazer download do código que permitirá executá-lo. Seu projeto transferido por -download é pré-configurado com as dependências e credenciais do SDK necessárias para -cada recurso que você configurou. - -Você precisará concluir as credenciais dos serviços que não são configuráveis em seu -projeto transferido por download. O arquivo `README.md` para o projeto -iniciador contém instruções. Visualize o arquivo `README.md` em um -visualizador de Redução de preço para concluir a configuração. - -## Ferramentas do desenvolvedor de pré-requisito -{: #prereq-dev-tools} - -As ferramentas do desenvolvedor a seguir são necessárias quando você está trabalhando com código gerado do {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}: - - -### Consultas -{: #general notoc} - -* [Homebrew ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://brew.sh/) - * Ferramenta de linha de comandos para ajudar na instalação de outras ferramentas -e tempos de execução, como CocoaPods e Carthage, para desenvolvedores da Apple. - -* [Docker ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.docker.com/get-docker) - * O projeto de software livre para ajudar na execução e depuração de aplicativos em contêineres. Necessário apenas para projetos não móveis. - -### {{site.data.keyword.Bluemix_notm}} -{: #bluemix notoc} - -* Node.js (Tempos de execução do Node e npm) para ajudar na execução do {{site.data.keyword.apiconnect_short}} Loopback e outras ferramentas de produtividade do {{site.data.keyword.Bluemix_notm}}. - - Para executar as ferramentas do {{site.data.keyword.apiconnect_short}} localmente, use Node 5.x: - - ``` - $ brew install Node5 - ``` - -* [Ferramentas do Bluemix CLI ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://clis.ng.bluemix.net/ui/home.html) - - Ferramentas de linha de comandos para implementar tempos de execução do Cloud Foundry de uma interface da linha de comandos com o {{site.data.keyword.Bluemix_notm}}. - -* [{{site.data.keyword.dev_cli_notm}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](dev_cli.html) - - Plug-in do {{site.data.keyword.Bluemix_notm}} CLI para criar, executar, testar e implementar projetos da web e móveis. - -* [Plug-in do SDK Generator ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](sdk_cli.html) - - Plug-in do {{site.data.keyword.Bluemix_notm}} CLI para gerar SDKs de sua definição de API de REST compatível com a [Especificação de Open API ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.openapis.org/). - -### Android -{: #android notoc} - -* [Android Studio 2.2 ou superior![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://developer.android.com/studio) - * Instale o tempo de execução mais recente do [Android 7.0 ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.android.com/versions/nougat-7-0/). - -### iOS -{: #ios notoc} - -* [Xcode 8 ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://developer.apple.com/xcode/) (recomendado) - - -* [Gerenciador de dependência do CocoaPods ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://cocoapods.org/) para instalar dependências do SDK iOS. Use a versão mais recente: - - ``` - $ sudo gem install cocoapods --pre - ``` -* [Gerenciador de dependência do Carthage ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/Carthage/Carthage) para instalar SDKs do {{site.data.keyword.watson}} Developer Cloud. - - ``` - $ brew install carthage - ``` +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-18" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# Obter código +{: #Get_Code} + +Ao concluir a configuração e a instalação de seu projeto com os recursos selecionados, será possível fazer download do código que permitirá executá-lo. Seu projeto transferido por +download é pré-configurado com as dependências e credenciais do SDK necessárias para +cada recurso que você configurou. + +Você precisará concluir as credenciais dos serviços que não são configuráveis em seu +projeto transferido por download. O arquivo `README.md` para o projeto +iniciador contém instruções. Visualize o arquivo `README.md` em um +visualizador de Redução de preço para concluir a configuração. + +## Ferramentas do desenvolvedor de pré-requisito +{: #prereq-dev-tools} + +As ferramentas do desenvolvedor a seguir são necessárias quando você está trabalhando com código gerado do {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}: + + +### Consultas +{: #general notoc} + +* [Homebrew ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://brew.sh/) + * Ferramenta de linha de comandos para ajudar na instalação de outras ferramentas +e tempos de execução, como CocoaPods e Carthage, para desenvolvedores da Apple. + +* [Docker ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.docker.com/get-docker) + * O projeto de software livre para ajudar na execução e depuração de aplicativos em contêineres. Necessário apenas para projetos não móveis. + +### {{site.data.keyword.Bluemix_notm}} +{: #bluemix notoc} + +* Node.js (Tempos de execução do Node e npm) para ajudar na execução do {{site.data.keyword.apiconnect_short}} Loopback e outras ferramentas de produtividade do {{site.data.keyword.Bluemix_notm}}. + + Para executar as ferramentas do {{site.data.keyword.apiconnect_short}} localmente, use Node 5.x: + + ``` + $ brew install Node5 + ``` + +* [Ferramentas do Bluemix CLI ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://clis.ng.bluemix.net/ui/home.html) + + Ferramentas de linha de comandos para implementar tempos de execução do Cloud Foundry de uma interface da linha de comandos com o {{site.data.keyword.Bluemix_notm}}. + +* [{{site.data.keyword.dev_cli_notm}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](dev_cli.html) + + Plug-in do {{site.data.keyword.Bluemix_notm}} CLI para criar, executar, testar e implementar projetos da web e móveis. + +* [Plug-in do SDK Generator ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](sdk_cli.html) + + Plug-in do {{site.data.keyword.Bluemix_notm}} CLI para gerar SDKs de sua definição de API de REST compatível com a [Especificação de Open API ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.openapis.org/). + +### Android +{: #android notoc} + +* [Android Studio 2.2 ou superior![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://developer.android.com/studio) + * Instale o tempo de execução mais recente do [Android 7.0 ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.android.com/versions/nougat-7-0/). + +### iOS +{: #ios notoc} + +* [Xcode 8 ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://developer.apple.com/xcode/) (recomendado) + + +* [Gerenciador de dependência do CocoaPods ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://cocoapods.org/) para instalar dependências do SDK iOS. Use a versão mais recente: + + ``` + $ sudo gem install cocoapods --pre + ``` +* [Gerenciador de dependência do Carthage ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/Carthage/Carthage) para instalar SDKs do {{site.data.keyword.watson}} Developer Cloud. + + ``` + $ brew install carthage + ``` diff --git a/cloudnative/nl/pt/BR/index.md b/cloudnative/nl/pt/BR/index.md index 5ab8fe84e..4ba3ebf0b 100644 --- a/cloudnative/nl/pt/BR/index.md +++ b/cloudnative/nl/pt/BR/index.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2016-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Construindo projetos nativos de nuvem -{: #web-mobile} - -É possível gerenciar apps nativos de nuvem por meio do conceito de [Projetos](projects.html) do {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. É possível criar um projeto usando o [{{site.data.keyword.dev_console}}](devex.html) ou a [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) para o {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI. O {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} traz as competências de serviços mais comuns que são necessárias a um desenvolvedor de aplicativo nativo de nuvem para uma experiência única e conectada que foi otimizada para o desenvolvedor. - -O {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} permite que um desenvolvedor de aplicativo nativo de nuvem crie um projeto usando uma variedade de [tipos padrão](patterns.html) e [Iniciadores](starters.html), crie e conecte os principais serviços otimizados pelo {{site.data.keyword.Bluemix_notm}} ao projeto e faça download rapidamente do código de trabalho com SDKs. Os SDKs estão totalmente integrados a credenciais ou dependências de recurso que permitem tê-los em execução em minutos. Quando seu aplicativo está em execução e você instalou e configurou recursos, é possível retornar ao projeto para monitorar e gerenciar engajamento com os usuários do aplicativo. Também é possível configurar e gerenciar os serviços por meio do {{site.data.keyword.dev_console}}. - - - - - - -# Links relacionados -{: #rellinks notoc} - -## Tutoriais e amostras -{: #samples notoc} - -* [Amostra: Backend móvel para Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} -* [Tutoriais em vídeo](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2016-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Construindo projetos nativos de nuvem +{: #web-mobile} + +É possível gerenciar apps nativos de nuvem por meio do conceito de [Projetos](projects.html) do {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. É possível criar um projeto usando o [{{site.data.keyword.dev_console}}](devex.html) ou a [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) para o {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI. O {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} traz as competências de serviços mais comuns que são necessárias a um desenvolvedor de aplicativo nativo de nuvem para uma experiência única e conectada que foi otimizada para o desenvolvedor. + +O {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} permite que um desenvolvedor de aplicativo nativo de nuvem crie um projeto usando uma variedade de [tipos padrão](patterns.html) e [Iniciadores](starters.html), crie e conecte os principais serviços otimizados pelo {{site.data.keyword.Bluemix_notm}} ao projeto e faça download rapidamente do código de trabalho com SDKs. Os SDKs estão totalmente integrados a credenciais ou dependências de recurso que permitem tê-los em execução em minutos. Quando seu aplicativo está em execução e você instalou e configurou recursos, é possível retornar ao projeto para monitorar e gerenciar engajamento com os usuários do aplicativo. Também é possível configurar e gerenciar os serviços por meio do {{site.data.keyword.dev_console}}. + + + + + + +# Links relacionados +{: #rellinks notoc} + +## Tutoriais e amostras +{: #samples notoc} + +* [Amostra: Backend móvel para Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} +* [Tutoriais em vídeo](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} diff --git a/cloudnative/nl/pt/BR/patterns.md b/cloudnative/nl/pt/BR/patterns.md index b6f189f16..f6e90fe94 100644 --- a/cloudnative/nl/pt/BR/patterns.md +++ b/cloudnative/nl/pt/BR/patterns.md @@ -1,100 +1,100 @@ - ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Tipos de Padrões -{: #patterns} - -Padrões nativos da nuvem são designs comprovados que ajudam a assegurar uma topologia consistente, escalável e confiável para seus aplicativos. Ao criar um projeto, serão apresentados diferentes tipos padrão dos quais é possível escolher. Basta selecionar o tipo padrão e os recursos que você deseja incorporar ao projeto. Depois de definir as preferências do projeto, um projeto iniciador é gerado para você editar, executar ou depurar e implementar localmente ou no {{site.data.keyword.Bluemix}}. - -## Aplicativo Web -{: #web} - -Os projetos da web incluem a capacidade de entregar conteúdo da web, como HTML, JavaScript e folhas de estilo para o servidor da web. - -Os iniciadores da web a seguir estão disponíveis: - -* Basic Web: entrega um arquivo `index.html` estático, folha de estilo padrão e vazia, além do arquivo JavaScript. -* Webpack: cria um projeto em que os arquivos de origem ECMAScript 6 (ES6) estão em `src/client` e são compilados com o WebPack para torná-los reduzidos e convertidos para uso no navegador. -* Webpack + React: uma estrutura avançada para construir interfaces com o usuário. Os arquivos de origem estão em `src/client/app` e serão compilados com o WebPack e entregues no diretório público. - - -## Aplicativo Remoto -{: #mobile} - -Os padrões de app móvel ajudam a construir apps móveis que se conectam diretamente aos serviços de backend, como {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, -{{site.data.keyword.appid_short}} e muito mais. Os projetos também podem ser incluídos por meio de sdkGen, como BFFs e Microsserviços. - -É possível escolher em uma lista de iniciadores, como {{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, {{site.data.keyword.openwhisk_short}} e muito mais. - -É possível gerar os apps móveis em Swift, Android ou Cordova. - - -## Backend for Frontend (BFF) -{: #bff} - -Os padrões de Backend for Frontend, comumente conhecidos como BFFs, ajudam a focar na exposição de dados de negócios e serviços em um formato que corresponde aos requisitos de interação com o usuário. Para otimizar uma jornada do usuário para sua solução de nuvem, pode ser necessária uma jornada de usuário diferente para o aplicativo móvel e uma jornada mais detalhada e mais rica para o aplicativo da web. Com a introdução de dispositivos controlados por voz, como o serviço [{{site.data.keyword.conversationfull}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.ibm.com/watson/developercloud/conversation.html), a interação com um usuário poderia ser controlada por voz. Esse canal digital requererá um BFF muito diferente para gerenciar essas interações baseadas em intenção de voz. - -Com o {{site.data.keyword.Bluemix_notm}}, é possível construir um BFF usando abordagem de programação poliglota para definir o BFF. A IBM recomenda usar Node.js, Swift ou Java e executá-los em um padrão nativo de nuvem com o Cloud Foundry, serviços de Contêiner ou sem servidor. - -O BFF gerenciará a integração com serviços para persistência de dados, armazenamento em cache e integração com serviços de alto valor, como o {{site.data.keyword.ibmwatson}}, o {{site.data.keyword.iot_short_notm}}, o {{site.data.keyword.weather_short}} e de análise de dados, como o {{site.data.keyword.sparks}}. - -O BFF exporá uma API mais comumente usando um padrão de REST, mas será possível projetar o BFF para trabalhar de uma arquitetura de sistema de mensagens usando o {{site.data.keyword.messagehub}}. - -Um iniciador BFF Basic está disponível usando Node.js ou Swift. - - -## Microsserviço -{: #microservice} - -Os projetos de microsserviço fornecem a base para construir microsserviços de backend, incluindo um terminal básico de funcionamento, uma API de REST. Os projetos gerados conterão todas as dependências necessárias tanto para o próprio microsserviço quanto para qualquer serviço de nuvem anexado. - -Um iniciador Microservice Basic está disponível usando Java. - - - - -## Linguagens -{: #languages notoc} - -As linguagens suportadas são: - - * [Java ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](../runtimes/liberty/getting-started.html){: new_window} - * [Node.js ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](../runtimes/nodejs/getting-started.html){: new_window} - * [Swift ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](../runtimes/swift/getting-started.html){: new_window} - - -### Compilador Java -{: #java notoc} - -O Java possui recursos comprovados para construir aplicativos de nível corporativo. Mas os novos recursos em Java 8, combinados com os tempos de execução mais leves, como o Liberty e estruturas, como o Spring Boot, tornam o Java perfeitamente adequado para a construção de microsserviços também. - - -### Node.js -{: #node notoc} - -O Node.js é um tempo de execução JavaScript que usa um modelo de E/S não bloqueador orientado a eventos, tornando-o leve e eficiente, destacando-se no rendimento e na escalabilidade para aplicativos da web, padrões backend-for-front-end e microsserviços. O ecossistema de pacote do Node.js, npm, fornece acesso a uma grande coleção de módulos de software livre, fornecendo uma ampla gama de recursos para acelerar o desenvolvimento de seu aplicativo. - - -### Swift -{: #swift notoc} - -Swift é uma linguagem de programação moderna criada pela Apple em 2014, que foi projetada para substituir o uso de Objective C e tornou-se software livre em dezembro de 2015. Hoje, ela é usada para construir iOS, macOS, serviços da web e software de sistemas nos sistemas operacionais Linux e macOS usando a arquitetura x86, ARM ou Z. É escrita como uma linguagem de script, mas é compilada para obter alto desempenho como C, com baixa sobrecarga, tornando-a ideal para tempos de execução de nuvem. Usa um sistema de tipo forte e estático visto em Java, mas o estilo funcional e as rotinas assíncronas vistos em JavaScript. Tem um excelente aproveitamento e a origem é compilada em código nativo usando a cadeia de ferramentas do compilador LLVM e pode usar as bibliotecas de sistema estrangeiras escritas em C facilmente. + +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Tipos de Padrões +{: #patterns} + +Padrões nativos da nuvem são designs comprovados que ajudam a assegurar uma topologia consistente, escalável e confiável para seus aplicativos. Ao criar um projeto, serão apresentados diferentes tipos padrão dos quais é possível escolher. Basta selecionar o tipo padrão e os recursos que você deseja incorporar ao projeto. Depois de definir as preferências do projeto, um projeto iniciador é gerado para você editar, executar ou depurar e implementar localmente ou no {{site.data.keyword.Bluemix}}. + +## Aplicativo Web +{: #web} + +Os projetos da web incluem a capacidade de entregar conteúdo da web, como HTML, JavaScript e folhas de estilo para o servidor da web. + +Os iniciadores da web a seguir estão disponíveis: + +* Basic Web: entrega um arquivo `index.html` estático, folha de estilo padrão e vazia, além do arquivo JavaScript. +* Webpack: cria um projeto em que os arquivos de origem ECMAScript 6 (ES6) estão em `src/client` e são compilados com o WebPack para torná-los reduzidos e convertidos para uso no navegador. +* Webpack + React: uma estrutura avançada para construir interfaces com o usuário. Os arquivos de origem estão em `src/client/app` e serão compilados com o WebPack e entregues no diretório público. + + +## Aplicativo Remoto +{: #mobile} + +Os padrões de app móvel ajudam a construir apps móveis que se conectam diretamente aos serviços de backend, como {{site.data.keyword.mobilepushshort}}, {{site.data.keyword.mobileanalytics_short}}, +{{site.data.keyword.appid_short}} e muito mais. Os projetos também podem ser incluídos por meio de sdkGen, como BFFs e Microsserviços. + +É possível escolher em uma lista de iniciadores, como {{site.data.keyword.watson}} Conversation, {{site.data.keyword.visualrecognitionshort}}, {{site.data.keyword.openwhisk_short}} e muito mais. + +É possível gerar os apps móveis em Swift, Android ou Cordova. + + +## Backend for Frontend (BFF) +{: #bff} + +Os padrões de Backend for Frontend, comumente conhecidos como BFFs, ajudam a focar na exposição de dados de negócios e serviços em um formato que corresponde aos requisitos de interação com o usuário. Para otimizar uma jornada do usuário para sua solução de nuvem, pode ser necessária uma jornada de usuário diferente para o aplicativo móvel e uma jornada mais detalhada e mais rica para o aplicativo da web. Com a introdução de dispositivos controlados por voz, como o serviço [{{site.data.keyword.conversationfull}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.ibm.com/watson/developercloud/conversation.html), a interação com um usuário poderia ser controlada por voz. Esse canal digital requererá um BFF muito diferente para gerenciar essas interações baseadas em intenção de voz. + +Com o {{site.data.keyword.Bluemix_notm}}, é possível construir um BFF usando abordagem de programação poliglota para definir o BFF. A IBM recomenda usar Node.js, Swift ou Java e executá-los em um padrão nativo de nuvem com o Cloud Foundry, serviços de Contêiner ou sem servidor. + +O BFF gerenciará a integração com serviços para persistência de dados, armazenamento em cache e integração com serviços de alto valor, como o {{site.data.keyword.ibmwatson}}, o {{site.data.keyword.iot_short_notm}}, o {{site.data.keyword.weather_short}} e de análise de dados, como o {{site.data.keyword.sparks}}. + +O BFF exporá uma API mais comumente usando um padrão de REST, mas será possível projetar o BFF para trabalhar de uma arquitetura de sistema de mensagens usando o {{site.data.keyword.messagehub}}. + +Um iniciador BFF Basic está disponível usando Node.js ou Swift. + + +## Microsserviço +{: #microservice} + +Os projetos de microsserviço fornecem a base para construir microsserviços de backend, incluindo um terminal básico de funcionamento, uma API de REST. Os projetos gerados conterão todas as dependências necessárias tanto para o próprio microsserviço quanto para qualquer serviço de nuvem anexado. + +Um iniciador Microservice Basic está disponível usando Java. + + + + +## Linguagens +{: #languages notoc} + +As linguagens suportadas são: + + * [Java ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](../runtimes/liberty/getting-started.html){: new_window} + * [Node.js ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](../runtimes/nodejs/getting-started.html){: new_window} + * [Swift ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](../runtimes/swift/getting-started.html){: new_window} + + +### Compilador Java +{: #java notoc} + +O Java possui recursos comprovados para construir aplicativos de nível corporativo. Mas os novos recursos em Java 8, combinados com os tempos de execução mais leves, como o Liberty e estruturas, como o Spring Boot, tornam o Java perfeitamente adequado para a construção de microsserviços também. + + +### Node.js +{: #node notoc} + +O Node.js é um tempo de execução JavaScript que usa um modelo de E/S não bloqueador orientado a eventos, tornando-o leve e eficiente, destacando-se no rendimento e na escalabilidade para aplicativos da web, padrões backend-for-front-end e microsserviços. O ecossistema de pacote do Node.js, npm, fornece acesso a uma grande coleção de módulos de software livre, fornecendo uma ampla gama de recursos para acelerar o desenvolvimento de seu aplicativo. + + +### Swift +{: #swift notoc} + +Swift é uma linguagem de programação moderna criada pela Apple em 2014, que foi projetada para substituir o uso de Objective C e tornou-se software livre em dezembro de 2015. Hoje, ela é usada para construir iOS, macOS, serviços da web e software de sistemas nos sistemas operacionais Linux e macOS usando a arquitetura x86, ARM ou Z. É escrita como uma linguagem de script, mas é compilada para obter alto desempenho como C, com baixa sobrecarga, tornando-a ideal para tempos de execução de nuvem. Usa um sistema de tipo forte e estático visto em Java, mas o estilo funcional e as rotinas assíncronas vistos em JavaScript. Tem um excelente aproveitamento e a origem é compilada em código nativo usando a cadeia de ferramentas do compilador LLVM e pode usar as bibliotecas de sistema estrangeiras escritas em C facilmente. diff --git a/cloudnative/nl/pt/BR/projects.md b/cloudnative/nl/pt/BR/projects.md index 9f9bf35a1..cc8d5ce7d 100644 --- a/cloudnative/nl/pt/BR/projects.md +++ b/cloudnative/nl/pt/BR/projects.md @@ -1,60 +1,60 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Projects -{: #projects} - -O {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} combina a interface com o usuário do app, dados e serviços em um *projeto* completo. Ao criar um -projeto, todas as partes necessárias de seu app e os recursos incluídos são mantidos no -servidor {{site.data.keyword.Bluemix_notm}}. Será possível fazer download do código de app e das credenciais e inicializadores necessários, se os serviços estiverem configurados em seu projeto. É possível visualizar todos os seus projetos selecionando **Projetos**. - -É possível visualizar informações adicionais sobre um único projeto, selecionando-o na página **Projetos**. Isso exibe a página **Visão geral do projeto**, que inclui os serviços que estão configurados e disponíveis para o projeto. Serviços são recursos -separados que estendem seu app incluindo uma função. Como são incluídos individualmente, é possível incluir os serviços necessários, como serviços de push, autenticação, dados e armazenamento ou outros serviços. Ao incluir um serviço em seu projeto na página **Visão geral do projeto** e seguir as instruções para configurá-lo, ele será associado automaticamente ao app. Para obter mais informações sobre a página Visão geral do projeto, veja [Página Visão geral do projeto](project_overview_page.html). - -Para criar seu projeto, deve-se selecionar um [padrão](patterns.html), seguido por um [iniciador](starters.html). - - -## Página Visão geral do projeto -{: #project_overview} - -É possível visualizar e trabalhar com um único projeto do {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, selecionando o projeto na página **Projetos**, que abre a página Visão geral do projeto. -{: shortdesc} - -A página **Visão geral do projeto** exibe um quadro para cada recurso que está configurado ou disponível para configuração com o projeto selecionado. O quadro exibe o tipo do recurso e um botão *ações* com três pontos alinhados verticalmente. Exemplos de recursos que podem estar disponíveis ou configurados incluem {{site.data.keyword.mobilepushshort}}, Analítica ou Dados e armazenamento. Os recursos compatíveis dependem do tipo de projeto e dos recursos que estão disponíveis nessa região, portanto, nem todos eles estarão disponíveis para serem associados a todos os projetos. - -Quando um tipo de recurso ainda não está associado ao projeto, um botão **Criar** é exibido no quadro. As opções do botão de ações são para criar uma instância do serviço ou para incluir uma instância de serviço existente quando o recurso ainda não estiver associado. Selecionar **Incluir existente** fornece uma lista das instâncias de serviço desse tipo em seu espaço. - -Se o recurso já estiver associado a esse projeto, o nome da instância de serviço associada será exibido no quadro depois do tipo de recurso. Isso facilita localizar qual instância de serviço está relacionada a esse projeto no {{site.data.keyword.dev_console}}. As ações que estão disponíveis no botão de ações são **Visualizar** e **Remover** quando o recurso já está associado ao projeto. A remoção de uma instância de serviço remove apenas a associação a esse projeto e não exclui a instância de serviço do {{site.data.keyword.dev_console}}. Para excluir uma instância de serviço, clique na página **Web e Dispositivo móvel > Serviços** para visualizar e excluir as instâncias de serviço. - -Selecione **Obter o código** no quadro **Código** para fazer download do código para seu projeto. Para obter mais informações sobre como fazer download do código, veja [Obter código](get_code.html). - - -## Atualizando seu projeto para usar um novo Iniciador -{: #update-starter} - -1. Na página **Projetos** ou **Visão geral do projeto**, clique no ícone do **Menu overflow** e selecione **Atualizar Iniciador**. - -2. Escolha um novo Iniciador e clique em **Atualizar**. - -3. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. - - Como alternativa, é possível clicar na página **Código**. - - -## Atualizando seu projeto para gerar uma nova linguagem -{: #update-language} - -1. Nas páginas **Projetos** ou **Visão geral do projeto**, clique no ícone do **Menu overflow** e selecione **Atualizar Iniciador**. - -2. Selecione uma nova linguagem e clique em **Atualizar**. - -3. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Projects +{: #projects} + +O {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} combina a interface com o usuário do app, dados e serviços em um *projeto* completo. Ao criar um +projeto, todas as partes necessárias de seu app e os recursos incluídos são mantidos no +servidor {{site.data.keyword.Bluemix_notm}}. Será possível fazer download do código de app e das credenciais e inicializadores necessários, se os serviços estiverem configurados em seu projeto. É possível visualizar todos os seus projetos selecionando **Projetos**. + +É possível visualizar informações adicionais sobre um único projeto, selecionando-o na página **Projetos**. Isso exibe a página **Visão geral do projeto**, que inclui os serviços que estão configurados e disponíveis para o projeto. Serviços são recursos +separados que estendem seu app incluindo uma função. Como são incluídos individualmente, é possível incluir os serviços necessários, como serviços de push, autenticação, dados e armazenamento ou outros serviços. Ao incluir um serviço em seu projeto na página **Visão geral do projeto** e seguir as instruções para configurá-lo, ele será associado automaticamente ao app. Para obter mais informações sobre a página Visão geral do projeto, veja [Página Visão geral do projeto](project_overview_page.html). + +Para criar seu projeto, deve-se selecionar um [padrão](patterns.html), seguido por um [iniciador](starters.html). + + +## Página Visão geral do projeto +{: #project_overview} + +É possível visualizar e trabalhar com um único projeto do {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, selecionando o projeto na página **Projetos**, que abre a página Visão geral do projeto. +{: shortdesc} + +A página **Visão geral do projeto** exibe um quadro para cada recurso que está configurado ou disponível para configuração com o projeto selecionado. O quadro exibe o tipo do recurso e um botão *ações* com três pontos alinhados verticalmente. Exemplos de recursos que podem estar disponíveis ou configurados incluem {{site.data.keyword.mobilepushshort}}, Analítica ou Dados e armazenamento. Os recursos compatíveis dependem do tipo de projeto e dos recursos que estão disponíveis nessa região, portanto, nem todos eles estarão disponíveis para serem associados a todos os projetos. + +Quando um tipo de recurso ainda não está associado ao projeto, um botão **Criar** é exibido no quadro. As opções do botão de ações são para criar uma instância do serviço ou para incluir uma instância de serviço existente quando o recurso ainda não estiver associado. Selecionar **Incluir existente** fornece uma lista das instâncias de serviço desse tipo em seu espaço. + +Se o recurso já estiver associado a esse projeto, o nome da instância de serviço associada será exibido no quadro depois do tipo de recurso. Isso facilita localizar qual instância de serviço está relacionada a esse projeto no {{site.data.keyword.dev_console}}. As ações que estão disponíveis no botão de ações são **Visualizar** e **Remover** quando o recurso já está associado ao projeto. A remoção de uma instância de serviço remove apenas a associação a esse projeto e não exclui a instância de serviço do {{site.data.keyword.dev_console}}. Para excluir uma instância de serviço, clique na página **Web e Dispositivo móvel > Serviços** para visualizar e excluir as instâncias de serviço. + +Selecione **Obter o código** no quadro **Código** para fazer download do código para seu projeto. Para obter mais informações sobre como fazer download do código, veja [Obter código](get_code.html). + + +## Atualizando seu projeto para usar um novo Iniciador +{: #update-starter} + +1. Na página **Projetos** ou **Visão geral do projeto**, clique no ícone do **Menu overflow** e selecione **Atualizar Iniciador**. + +2. Escolha um novo Iniciador e clique em **Atualizar**. + +3. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. + + Como alternativa, é possível clicar na página **Código**. + + +## Atualizando seu projeto para gerar uma nova linguagem +{: #update-language} + +1. Nas páginas **Projetos** ou **Visão geral do projeto**, clique no ícone do **Menu overflow** e selecione **Atualizar Iniciador**. + +2. Selecione uma nova linguagem e clique em **Atualizar**. + +3. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. diff --git a/cloudnative/nl/pt/BR/sdk.md b/cloudnative/nl/pt/BR/sdk.md index ad57e3624..68c5e1382 100644 --- a/cloudnative/nl/pt/BR/sdk.md +++ b/cloudnative/nl/pt/BR/sdk.md @@ -1,71 +1,71 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-17" - ---- -# SDKs -{: #sdk} - -Para adicionar os SDKs do {{site.data.keyword.Bluemix}} -Mobile Services ao seu aplicativo, escolha os SDKs que deseja usar e -configure o -gerenciador de dependência para enviar os SDKs por pull para o seu -aplicativo. - - -## SDKs Clientes -{: #client_sdk} - -É possível usar os SDKs a seguir em seu aplicativo móvel para alavancar os respectivos recursos. - - -### SDKs Android -{: #android_sdk} - -- [SDK principal ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) -- [SDK do {{site.data.keyword.mobileanalytics_short}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) -- [SDK do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) -- [SDK de autenticação do Facebook ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) -- [SDK de autenticação do Google ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) - - -### SDKs iOS -{: #ios_sdk} - -- [SDK principal ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) -- [SDK do {{site.data.keyword.mobileanalytics_short}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) -- [SDK do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) -- [SDK de autenticação do Facebook ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) -- [SDK de autenticação do Google ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) -- [SDK do {{site.data.keyword.amashort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) - - -### Plug-ins do Cordova -{: #cordova_plugin} - -- [Plug-in principal ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) -- [Plug-in do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## SDKs de servidor -{: #server_sdk} - -Se você tiver um aplicativo do servidor Java, NodeJS ou Swift, poderá usar os SDKs a seguir para se comunicar com os respectivos serviços. - - -### {{site.data.keyword.mobilepushshort}} SDKs de servidor -{: #push_sdk} - -- [SDK do servidor Java do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) -- [SDK do servidor Swift do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) -- [SDK do servidor NodeJS do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) - - -### {{site.data.keyword.amashort}} SDK do servidor -{: #mca_sdk} - -- [SDK do servidor Swift do {{site.data.keyword.amashort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) - - +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-17" + +--- +# SDKs +{: #sdk} + +Para adicionar os SDKs do {{site.data.keyword.Bluemix}} +Mobile Services ao seu aplicativo, escolha os SDKs que deseja usar e +configure o +gerenciador de dependência para enviar os SDKs por pull para o seu +aplicativo. + + +## SDKs Clientes +{: #client_sdk} + +É possível usar os SDKs a seguir em seu aplicativo móvel para alavancar os respectivos recursos. + + +### SDKs Android +{: #android_sdk} + +- [SDK principal ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) +- [SDK do {{site.data.keyword.mobileanalytics_short}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) +- [SDK do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) +- [SDK de autenticação do Facebook ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) +- [SDK de autenticação do Google ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) + + +### SDKs iOS +{: #ios_sdk} + +- [SDK principal ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) +- [SDK do {{site.data.keyword.mobileanalytics_short}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) +- [SDK do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) +- [SDK de autenticação do Facebook ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) +- [SDK de autenticação do Google ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) +- [SDK do {{site.data.keyword.amashort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) + + +### Plug-ins do Cordova +{: #cordova_plugin} + +- [Plug-in principal ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) +- [Plug-in do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## SDKs de servidor +{: #server_sdk} + +Se você tiver um aplicativo do servidor Java, NodeJS ou Swift, poderá usar os SDKs a seguir para se comunicar com os respectivos serviços. + + +### {{site.data.keyword.mobilepushshort}} SDKs de servidor +{: #push_sdk} + +- [SDK do servidor Java do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) +- [SDK do servidor Swift do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) +- [SDK do servidor NodeJS do {{site.data.keyword.mobilepushshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) + + +### {{site.data.keyword.amashort}} SDK do servidor +{: #mca_sdk} + +- [SDK do servidor Swift do {{site.data.keyword.amashort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) + + diff --git a/cloudnative/nl/pt/BR/sdk_BMSClient.md b/cloudnative/nl/pt/BR/sdk_BMSClient.md index 04cef4af7..f555c2379 100644 --- a/cloudnative/nl/pt/BR/sdk_BMSClient.md +++ b/cloudnative/nl/pt/BR/sdk_BMSClient.md @@ -1,134 +1,134 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Inicializando BMSClient -{: #sdk_BMSClient} - -O `BMSCore` fornece a infraestrutura HTTP que os outros SDKs do cliente de serviços móveis do {{site.data.keyword.Bluemix}} usam para se comunicarem com os seus serviços do {{site.data.keyword.Bluemix_notm}} correspondentes. - - -## Inicializando seu aplicativo Android -{: #init-BMSClient-android} - -É possível fazer download e importar o -pacote `BMSCore` em seu projeto Android Studio ou usar o Gradle. - -1. Importe o Client SDK incluindo a instrução `import` a seguir no início do seu arquivo de projeto: - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; - ``` - {: codeblock} - -2. Inicialize o SDK `BMSClient` em seu aplicativo Android incluindo o código de -inicialização no método `onCreate` da atividade principal ou em um local que funcione melhor -para seu projeto. - - ```Java - BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region - ``` - {: codeblock} - - Deve-se inicializar o `BMSClient` com o parâmetro **bluemixRegion**. No inicializador, o valor **bluemixRegion** especifica qual implementação do {{site.data.keyword.Bluemix_notm}} está sendo usada, por exemplo, `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` ou `BMSClient.REGION_SYDNEY`. - - -## Inicializando seu aplicativo iOS -{: #init-BMSClient-ios} - -É possível usar o [CocoaPods](https://cocoapods.org){: new_window} ou o [Carthage](https://github.com/Carthage/Carthage){: new_window} para obter o pacote `BMSCore`. - -1. Para instalar o `BMSCore` usando o -CocoaPods, inclua as linhas a seguir em seu Podfile. Se seu projeto -ainda não tiver um Podfile, use o comando `pod init`. - - ```Swift - use_frameworks! - - target 'MyApp' do - pod 'BMSCore' - end - ``` - {: codeblock} - - Em seguida, execute o comando `pod install` -e abra o arquivo `.xcworkspace` gerado. Para -atualizar para uma liberação mais recente do -`BMSCore`, use `pod update BMSCore`. - - Para obter mais informações sobre como usar o CocoaPods, veja os [Guias do CocoaPods ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://guides.cocoapods.org/using/index.html){: new_window}. - -2. Para instalar o `BMSCore` usando o Carthage, siga estas [instruções ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/Carthage/Carthage#getting-started){: new_window}. - - 1. Inclua a linha a seguir em seu Cartfile: - - ``` - github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" - ``` - {: codeblock} - - 2. Execute o comando `carthage update`. - - 3. Após a conclusão da construção, inclua `BMSCore.framework` no projeto seguindo a [Etapa 3 ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/Carthage/Carthage#getting-started) nas instruções do Carthage. - - Para aplicativos que são construídos com o Swift 2.3, use o comando `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3`. Caso contrário, use o comando `carthage update`. - -3. Importe o módulo. - - ```Swift - import BMSCore - ``` - {: codeblock} - -4. Inicialize a classe `BMSClient`, usando o código a seguir. - - Coloque o código de inicialização no método `application(_:didFinishLaunchingWithOptions:)` de seu delegado do aplicativo ou em um local que funcione melhor para seu projeto. - - ```Swift - BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region - ``` - {: codeblock} - - Deve-se inicializar o `BMSClient` com o -parâmetro **bluemixRegion**. No inicializador, o valor **bluemixRegion** especifica qual implementação {{site.data.keyword.Bluemix_notm}} você está usando, por exemplo, `BMSClient.Region.usSouth`, -`BMSClient.Region.unitedKingdom` ou `BMSClient.Region.sydney`. - - -## Inicializando seu aplicativo Cordova -{: #init-BMSClient-cordova} - -1. Inclua o plug-in do Cordova executando o comando a seguir no diretório-raiz de seu aplicativo Cordova: - - ``` - cordova plugin add bms-core - ``` - {: codeblock} - -2. Inicialize a classe `BMSClient` em seu aplicativo Cordova incluindo o código de inicialização no arquivo JavaScript principal ou em um local que funcione melhor para seu projeto. - - ``` - BMSClient.initialize(BMSClient.REGION_US_SOUTH); - ``` - {: codeblock} - - Deve-se inicializar o `BMSClient` com o -parâmetro **bluemixRegion**. No inicializador, o valor **bluemixRegion** especifica qual implementação do {{site.data.keyword.Bluemix_notm}} está sendo usada, por exemplo, `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` ou `BMSClient.REGION_SYDNEY`. - - -# Links relacionados -{: #rellinks notoc} - -## Links relacionados -{: #general notoc} - -* [SDK Android BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [SDK iOS BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [Plug-in do Cordova BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Inicializando BMSClient +{: #sdk_BMSClient} + +O `BMSCore` fornece a infraestrutura HTTP que os outros SDKs do cliente de serviços móveis do {{site.data.keyword.Bluemix}} usam para se comunicarem com os seus serviços do {{site.data.keyword.Bluemix_notm}} correspondentes. + + +## Inicializando seu aplicativo Android +{: #init-BMSClient-android} + +É possível fazer download e importar o +pacote `BMSCore` em seu projeto Android Studio ou usar o Gradle. + +1. Importe o Client SDK incluindo a instrução `import` a seguir no início do seu arquivo de projeto: + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; + ``` + {: codeblock} + +2. Inicialize o SDK `BMSClient` em seu aplicativo Android incluindo o código de +inicialização no método `onCreate` da atividade principal ou em um local que funcione melhor +para seu projeto. + + ```Java + BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region + ``` + {: codeblock} + + Deve-se inicializar o `BMSClient` com o parâmetro **bluemixRegion**. No inicializador, o valor **bluemixRegion** especifica qual implementação do {{site.data.keyword.Bluemix_notm}} está sendo usada, por exemplo, `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` ou `BMSClient.REGION_SYDNEY`. + + +## Inicializando seu aplicativo iOS +{: #init-BMSClient-ios} + +É possível usar o [CocoaPods](https://cocoapods.org){: new_window} ou o [Carthage](https://github.com/Carthage/Carthage){: new_window} para obter o pacote `BMSCore`. + +1. Para instalar o `BMSCore` usando o +CocoaPods, inclua as linhas a seguir em seu Podfile. Se seu projeto +ainda não tiver um Podfile, use o comando `pod init`. + + ```Swift + use_frameworks! + + target 'MyApp' do + pod 'BMSCore' + end + ``` + {: codeblock} + + Em seguida, execute o comando `pod install` +e abra o arquivo `.xcworkspace` gerado. Para +atualizar para uma liberação mais recente do +`BMSCore`, use `pod update BMSCore`. + + Para obter mais informações sobre como usar o CocoaPods, veja os [Guias do CocoaPods ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://guides.cocoapods.org/using/index.html){: new_window}. + +2. Para instalar o `BMSCore` usando o Carthage, siga estas [instruções ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/Carthage/Carthage#getting-started){: new_window}. + + 1. Inclua a linha a seguir em seu Cartfile: + + ``` + github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" + ``` + {: codeblock} + + 2. Execute o comando `carthage update`. + + 3. Após a conclusão da construção, inclua `BMSCore.framework` no projeto seguindo a [Etapa 3 ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://github.com/Carthage/Carthage#getting-started) nas instruções do Carthage. + + Para aplicativos que são construídos com o Swift 2.3, use o comando `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3`. Caso contrário, use o comando `carthage update`. + +3. Importe o módulo. + + ```Swift + import BMSCore + ``` + {: codeblock} + +4. Inicialize a classe `BMSClient`, usando o código a seguir. + + Coloque o código de inicialização no método `application(_:didFinishLaunchingWithOptions:)` de seu delegado do aplicativo ou em um local que funcione melhor para seu projeto. + + ```Swift + BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region + ``` + {: codeblock} + + Deve-se inicializar o `BMSClient` com o +parâmetro **bluemixRegion**. No inicializador, o valor **bluemixRegion** especifica qual implementação {{site.data.keyword.Bluemix_notm}} você está usando, por exemplo, `BMSClient.Region.usSouth`, +`BMSClient.Region.unitedKingdom` ou `BMSClient.Region.sydney`. + + +## Inicializando seu aplicativo Cordova +{: #init-BMSClient-cordova} + +1. Inclua o plug-in do Cordova executando o comando a seguir no diretório-raiz de seu aplicativo Cordova: + + ``` + cordova plugin add bms-core + ``` + {: codeblock} + +2. Inicialize a classe `BMSClient` em seu aplicativo Cordova incluindo o código de inicialização no arquivo JavaScript principal ou em um local que funcione melhor para seu projeto. + + ``` + BMSClient.initialize(BMSClient.REGION_US_SOUTH); + ``` + {: codeblock} + + Deve-se inicializar o `BMSClient` com o +parâmetro **bluemixRegion**. No inicializador, o valor **bluemixRegion** especifica qual implementação do {{site.data.keyword.Bluemix_notm}} está sendo usada, por exemplo, `BMSClient.REGION_US_SOUTH`, `BMSClient.REGION_UK` ou `BMSClient.REGION_SYDNEY`. + + +# Links relacionados +{: #rellinks notoc} + +## Links relacionados +{: #general notoc} + +* [SDK Android BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [SDK iOS BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [Plug-in do Cordova BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/pt/BR/sdk_cli.md b/cloudnative/nl/pt/BR/sdk_cli.md index 5ce219133..c79c22601 100644 --- a/cloudnative/nl/pt/BR/sdk_cli.md +++ b/cloudnative/nl/pt/BR/sdk_cli.md @@ -1,178 +1,178 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Plug-in do SDK Generator -{: #sdk-cli} - -O plug-in do {{site.data.keyword.IBM}} SDK Generator pode ser instalado no [{{site.data.keyword.Bluemix_notm}} CLI ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/cli/reference/bluemix_cli/index.html). - -Como um desenvolvedor no {{site.data.keyword.Bluemix_notm}}, é possível usar esse plug-in para gerar os SDKs de sua definição de API de REST compatível com a [Especificação da Open API ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.openapis.org/). À medida que você faz mudanças na definição de API de REST, é possível usar esse plug-in para gerar novamente apenas o SDK, em vez de gerar novamente o projeto inteiro. - -Também será possível ver se os apps Cloud Foundry em um determinado espaço possuírem definições de API de REST que são válidas para geração de SDK. Finalmente, é possível usar o plug-in do {{site.data.keyword.IBM_notm}} SDK Generator para validar quaisquer definições de API de REST para assegurar-se de que obedeçam aos requisitos do gerador de SDK. - -Esse plug-in do {{site.data.keyword.IBM_notm}} SDK Generator permite integrar facilmente seus serviços de backend ao app com um SDK gerado. Quando ocorrer uma mudança em uma API de REST, será possível gerar novamente o SDK e substituir o antigo para um upgrade ininterrupto de SDK. Também será possível integrar a CLI a um pipeline devops e assegurar-se de que o SDK esteja sempre consistente com a especificação de API sempre que o app for construído. - -A definição de API de REST deve ser válida e hospedada em um end point do servidor em tempo real ou em um arquivo local no sistema. Se a definição de API de REST for hospedada, a URL relativa deverá ser definida na variável de ambiente `OPENAPI_SPEC`. - - -## Requisitos -{: #prereqs} - -Assegure-se de satisfazer os requisitos a seguir. - -* Você tem uma conta do [{{site.data.keyword.Bluemix_notm}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://bluemix.net) -* Uma definição de API válida que é adequada à especificação de [Open API ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.openapis.org/) - - -## Instalação -{: #installation} - -1. [Instale o {{site.data.keyword.Bluemix}} CLI ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://clis.ng.bluemix.net/ui/home.html). - -2. [Instale o plug-in ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in). - - ``` - bx plugin install sdk-gen -r Bluemix - ``` - {: codeblock} - - -## Comandos -{: #commands} - -Use os comandos a seguir para gerar um SDK, validar os arquivos de definição da Open API ou listar apps do Cloud Foundry. - - -### Gerando um SDK -{: #gen} - -Use `bluemix sdk generate [arguments...][command options]`. - - -#### Argumentos -{: #gen-args} - -* `APP_NAME` - o nome do app Cloud Foundry em seu espaço atual -* `OPENAPI_DOC_LOCATION` - uma URL ou um caminho de arquivo relativo para a definição de API de REST bruta JSON ou Yaml -* `GENERATED_SDK_NAME` (opcional) - o nome do SDK gerado - - -#### opções -{: #gen-options} - -* `PLATFORM` (necessário) - * `--android` - gerar um SDK do Android - * `--ios` - gerar um SDK do iOS Swift - * `--swift` - gerar um SDK do servidor Swift -* `--output "YOUR_RELATIVE_PATH"` (opcional) - coloca o SDK gerado no diretório especificado por `YOUR_RELATIVE_PATH` (será sobrescrito se o SDK existente estiver presente) -* `--unzip` (opcional) - extrai o SDK gerado (será sobrescrito se artefatos SDK existentes estiverem presentes) - - -#### Uso -{: #gen-usage} - -Para gerar um SDK de um app Cloud Foundry que está em execução no {{site.data.keyword.Bluemix_notm}}, é possível usar o nome do app como um parâmetro para a CLI. O comando a seguir usa o nome do app como o `SDK_Name`. - -``` -bluemix sdk generate [APP_NAME] [PLATFORM] -``` -{: codeblock} - -Para gerar um SDK de uma URL para um arquivo de definição de Open API ou um arquivo JSON ou Yaml local, use o comando a seguir. - -``` -bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] -``` -{: codeblock} - - -### Validando definições da Open API -{: #validating} - -Use `bluemix sdk validate [argument]`. - - -#### Argumentos -{: #val-args} - -* `APP_NAME` - o nome do app Cloud Foundry em seu espaço atual -* `OPENAPI_DOC_LOCATION` - uma URL ou um caminho de arquivo relativo para a definição de API de REST bruta JSON ou Yaml - - -#### Uso -{: #val-usage} - -Para validar uma especificação de API do app Cloud Foundry que está em execução no {{site.data.keyword.Bluemix_notm}}, é possível usar o nome do app como um parâmetro para a CLI. - -``` -bluemix sdk validate [APP_NAME] -``` -{: codeblock} - -Para validar um SDK da URL para um documento de especificação de API ou um arquivo JSON ou Yaml local, use o comando a seguir. - -``` -bluemix sdk validate [OPENAPI_DOC_LOCATION] -``` -{: codeblock} - - - -### Listar apps (Cloud Foundry) -{: #list-apps} - -Use `bluemix sdk list [argument][option]` para listar apps e validar especificações de API. Deve-se ter a variável de ambiente `OPENAPI_SPEC` configurada para o caminho da URL relativa que hospeda sua especificação. - - -#### Argumentos -{: #list-args} - -* `SPACE_NAME` (opcional) - o nome do espaço do Cloud Foundry em sua organização atual na qual você deseja procurar apps. Se não fornecido, o espaço atual será procurado. - - -#### opções -{: #list-options} - -* `--url` (opcional) - para exibir uma URL completamente formada para a definição de Open API para cada app na lista - - -#### Uso -{: #list-usage} - -Para listar apps no espaço atual, use o comando a seguir. - -``` -bluemix sdk list -``` -{: codeblock} - -Para listar apps no espaço atual e exibir a URL de especificação de API, use o comando a seguir. - -``` -bluemix sdk list --url -``` -{: codeblock} - -Para listar apps em um espaço específico, use o comando a seguir. - -``` -bluemix sdk list [SPACE_NAME] -``` -{: codeblock} - -Para listar apps em um espaço específico e exibir a URL de especificação de API, use o comando a seguir. - -``` -bluemix sdk list [SPACE_NAME] --url -``` -{: codeblock} +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Plug-in do SDK Generator +{: #sdk-cli} + +O plug-in do {{site.data.keyword.IBM}} SDK Generator pode ser instalado no [{{site.data.keyword.Bluemix_notm}} CLI ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/cli/reference/bluemix_cli/index.html). + +Como um desenvolvedor no {{site.data.keyword.Bluemix_notm}}, é possível usar esse plug-in para gerar os SDKs de sua definição de API de REST compatível com a [Especificação da Open API ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.openapis.org/). À medida que você faz mudanças na definição de API de REST, é possível usar esse plug-in para gerar novamente apenas o SDK, em vez de gerar novamente o projeto inteiro. + +Também será possível ver se os apps Cloud Foundry em um determinado espaço possuírem definições de API de REST que são válidas para geração de SDK. Finalmente, é possível usar o plug-in do {{site.data.keyword.IBM_notm}} SDK Generator para validar quaisquer definições de API de REST para assegurar-se de que obedeçam aos requisitos do gerador de SDK. + +Esse plug-in do {{site.data.keyword.IBM_notm}} SDK Generator permite integrar facilmente seus serviços de backend ao app com um SDK gerado. Quando ocorrer uma mudança em uma API de REST, será possível gerar novamente o SDK e substituir o antigo para um upgrade ininterrupto de SDK. Também será possível integrar a CLI a um pipeline devops e assegurar-se de que o SDK esteja sempre consistente com a especificação de API sempre que o app for construído. + +A definição de API de REST deve ser válida e hospedada em um end point do servidor em tempo real ou em um arquivo local no sistema. Se a definição de API de REST for hospedada, a URL relativa deverá ser definida na variável de ambiente `OPENAPI_SPEC`. + + +## Requisitos +{: #prereqs} + +Assegure-se de satisfazer os requisitos a seguir. + +* Você tem uma conta do [{{site.data.keyword.Bluemix_notm}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://bluemix.net) +* Uma definição de API válida que é adequada à especificação de [Open API ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.openapis.org/) + + +## Instalação +{: #installation} + +1. [Instale o {{site.data.keyword.Bluemix}} CLI ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://clis.ng.bluemix.net/ui/home.html). + +2. [Instale o plug-in ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in). + + ``` + bx plugin install sdk-gen -r Bluemix + ``` + {: codeblock} + + +## Comandos +{: #commands} + +Use os comandos a seguir para gerar um SDK, validar os arquivos de definição da Open API ou listar apps do Cloud Foundry. + + +### Gerando um SDK +{: #gen} + +Use `bluemix sdk generate [arguments...][command options]`. + + +#### Argumentos +{: #gen-args} + +* `APP_NAME` - o nome do app Cloud Foundry em seu espaço atual +* `OPENAPI_DOC_LOCATION` - uma URL ou um caminho de arquivo relativo para a definição de API de REST bruta JSON ou Yaml +* `GENERATED_SDK_NAME` (opcional) - o nome do SDK gerado + + +#### opções +{: #gen-options} + +* `PLATFORM` (necessário) + * `--android` - gerar um SDK do Android + * `--ios` - gerar um SDK do iOS Swift + * `--swift` - gerar um SDK do servidor Swift +* `--output "YOUR_RELATIVE_PATH"` (opcional) - coloca o SDK gerado no diretório especificado por `YOUR_RELATIVE_PATH` (será sobrescrito se o SDK existente estiver presente) +* `--unzip` (opcional) - extrai o SDK gerado (será sobrescrito se artefatos SDK existentes estiverem presentes) + + +#### Uso +{: #gen-usage} + +Para gerar um SDK de um app Cloud Foundry que está em execução no {{site.data.keyword.Bluemix_notm}}, é possível usar o nome do app como um parâmetro para a CLI. O comando a seguir usa o nome do app como o `SDK_Name`. + +``` +bluemix sdk generate [APP_NAME] [PLATFORM] +``` +{: codeblock} + +Para gerar um SDK de uma URL para um arquivo de definição de Open API ou um arquivo JSON ou Yaml local, use o comando a seguir. + +``` +bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] +``` +{: codeblock} + + +### Validando definições da Open API +{: #validating} + +Use `bluemix sdk validate [argument]`. + + +#### Argumentos +{: #val-args} + +* `APP_NAME` - o nome do app Cloud Foundry em seu espaço atual +* `OPENAPI_DOC_LOCATION` - uma URL ou um caminho de arquivo relativo para a definição de API de REST bruta JSON ou Yaml + + +#### Uso +{: #val-usage} + +Para validar uma especificação de API do app Cloud Foundry que está em execução no {{site.data.keyword.Bluemix_notm}}, é possível usar o nome do app como um parâmetro para a CLI. + +``` +bluemix sdk validate [APP_NAME] +``` +{: codeblock} + +Para validar um SDK da URL para um documento de especificação de API ou um arquivo JSON ou Yaml local, use o comando a seguir. + +``` +bluemix sdk validate [OPENAPI_DOC_LOCATION] +``` +{: codeblock} + + + +### Listar apps (Cloud Foundry) +{: #list-apps} + +Use `bluemix sdk list [argument][option]` para listar apps e validar especificações de API. Deve-se ter a variável de ambiente `OPENAPI_SPEC` configurada para o caminho da URL relativa que hospeda sua especificação. + + +#### Argumentos +{: #list-args} + +* `SPACE_NAME` (opcional) - o nome do espaço do Cloud Foundry em sua organização atual na qual você deseja procurar apps. Se não fornecido, o espaço atual será procurado. + + +#### opções +{: #list-options} + +* `--url` (opcional) - para exibir uma URL completamente formada para a definição de Open API para cada app na lista + + +#### Uso +{: #list-usage} + +Para listar apps no espaço atual, use o comando a seguir. + +``` +bluemix sdk list +``` +{: codeblock} + +Para listar apps no espaço atual e exibir a URL de especificação de API, use o comando a seguir. + +``` +bluemix sdk list --url +``` +{: codeblock} + +Para listar apps em um espaço específico, use o comando a seguir. + +``` +bluemix sdk list [SPACE_NAME] +``` +{: codeblock} + +Para listar apps em um espaço específico e exibir a URL de especificação de API, use o comando a seguir. + +``` +bluemix sdk list [SPACE_NAME] --url +``` +{: codeblock} diff --git a/cloudnative/nl/pt/BR/sdk_network_request.md b/cloudnative/nl/pt/BR/sdk_network_request.md index 3f9d437db..ee057ea34 100644 --- a/cloudnative/nl/pt/BR/sdk_network_request.md +++ b/cloudnative/nl/pt/BR/sdk_network_request.md @@ -1,130 +1,130 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Fazendo uma solicitação de rede -{: #sdk-network-request} - -Também é possível usar o kit de desenvolvimento de software (SDK) `BMSCore` para fazer -solicitações de rede para qualquer recurso. - -## Android -{: #request-android} - -1. Certifique-se de ter [importado o SDK do Cliente e de tê-lo inicializado](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android) em seu aplicativo Android. - -2. Faça uma solicitação de rede. - - ``` - public void makeGetCall() { - Thread thread = new Thread(new Runnable() { - @Override - public void run() { - try { - Request request = new Request("http://httpbin.org/get", "GET"); - request.send(null, null); - } catch (Exception e) { - // Handle failure here. - } - } - }); - thread.start(); - } - ``` - {: codeblock} - -## iOS -{: #request-ios} - -1. Certifique-se de ter [importado o SDK do Cliente e de tê-lo inicializado](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios) em seu aplicativo iOS. - -2. Crie uma solicitação de rede. - - ### Swift 3.0 - {: #ios-swift3 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - - ### Swift 2.2 - {: #ios-swift22 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - -A classe `Request` é uma maneira simples de fazer uma solicitação de HTTP e -de obter a resposta após a solicitação ser concluída. Se deseja mais flexibilidade e controle do que é -possível obter com a classe `Request`, a classe `BMSURLSession` -pode ser usada. Alguns recursos da classe `BMSURLSession` incluem monitoramento do -progresso de uploads e pausa ou cancelamento de solicitações. Para obter as respostas, há a opção de -escolher manipuladores ou delegados de conclusão. - -A classe `BMSURLSession` está disponível somente para iOS. Para obter mais informações -sobre `BMSURLSession`, consulte o -[LEIA-ME](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) do SDK -`BMSCore`. - - -## Cordova -{: #request-cordova} - -1. Certifique-se de ter [importado o SDK do Cliente e de tê-lo inicializado](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova) em seu aplicativo Cordova. - -2. Crie uma solicitação de rede. - - ``` - var success = function(data) { - console.log("success", data); - } - var failure = function(error) - {console.log("failure", error); - } - var request = new BMSRequest("", BMSRequest.GET); - request.send(success, failure); - ``` - {: codeblock} - - -# Links relacionados -{: #rellinks notoc} - -## Links relacionados -{: #general notoc} - -* [SDK Android BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [SDK iOS BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [Plug-in do Cordova BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Fazendo uma solicitação de rede +{: #sdk-network-request} + +Também é possível usar o kit de desenvolvimento de software (SDK) `BMSCore` para fazer +solicitações de rede para qualquer recurso. + +## Android +{: #request-android} + +1. Certifique-se de ter [importado o SDK do Cliente e de tê-lo inicializado](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android) em seu aplicativo Android. + +2. Faça uma solicitação de rede. + + ``` + public void makeGetCall() { + Thread thread = new Thread(new Runnable() { + @Override + public void run() { + try { + Request request = new Request("http://httpbin.org/get", "GET"); + request.send(null, null); + } catch (Exception e) { + // Handle failure here. + } + } + }); + thread.start(); + } + ``` + {: codeblock} + +## iOS +{: #request-ios} + +1. Certifique-se de ter [importado o SDK do Cliente e de tê-lo inicializado](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios) em seu aplicativo iOS. + +2. Crie uma solicitação de rede. + + ### Swift 3.0 + {: #ios-swift3 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + + ### Swift 2.2 + {: #ios-swift22 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + +A classe `Request` é uma maneira simples de fazer uma solicitação de HTTP e +de obter a resposta após a solicitação ser concluída. Se deseja mais flexibilidade e controle do que é +possível obter com a classe `Request`, a classe `BMSURLSession` +pode ser usada. Alguns recursos da classe `BMSURLSession` incluem monitoramento do +progresso de uploads e pausa ou cancelamento de solicitações. Para obter as respostas, há a opção de +escolher manipuladores ou delegados de conclusão. + +A classe `BMSURLSession` está disponível somente para iOS. Para obter mais informações +sobre `BMSURLSession`, consulte o +[LEIA-ME](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) do SDK +`BMSCore`. + + +## Cordova +{: #request-cordova} + +1. Certifique-se de ter [importado o SDK do Cliente e de tê-lo inicializado](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova) em seu aplicativo Cordova. + +2. Crie uma solicitação de rede. + + ``` + var success = function(data) { + console.log("success", data); + } + var failure = function(error) + {console.log("failure", error); + } + var request = new BMSRequest("", BMSRequest.GET); + request.send(success, failure); + ``` + {: codeblock} + + +# Links relacionados +{: #rellinks notoc} + +## Links relacionados +{: #general notoc} + +* [SDK Android BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [SDK iOS BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [Plug-in do Cordova BMSCore](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/pt/BR/services.md b/cloudnative/nl/pt/BR/services.md index 982895b95..002b254b5 100644 --- a/cloudnative/nl/pt/BR/services.md +++ b/cloudnative/nl/pt/BR/services.md @@ -1,54 +1,54 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# Serviços -{: #services} - -Na página **Serviços** do {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, é possível visualizar seus serviços Web e Mobile existentes ou criar novos serviços. O console fornece um único local para visualizar todos os serviços Web e Mobile do {{site.data.keyword.Bluemix_notm}} que estão sendo gerenciados pelos projetos. - -Se você excluir serviços da visualização **Serviços**, irá desconectar o serviço do projeto ao qual ele está associado. Crie uma nova instância de serviço se quiser reconectar o serviço ao projeto. - -## Visão geral dos serviços Web e Mobile do {{site.data.keyword.Bluemix_notm}} -{: #mobile_services_overview} - -A tabela a seguir representa os serviços Web e Mobile do {{site.data.keyword.Bluemix_notm}}. É possível usar serviços individuais do catálogo do {{site.data.keyword.Bluemix_notm}} ou integrá-los a seu projeto. - - - - - - - - - - - - - - - - - - - -
Tabela 1. Serviços Web e Mobile do {{site.data.keyword.Bluemix_notm}}
Serviços Web e Mobile do {{site.data.keyword.Bluemix_notm}}Descrição
Ícone {{site.data.keyword.mobileanalytics_short}}
{{site.data.keyword.mobileanalytics_short}}		Use o serviço {{site.data.keyword.mobileanalytics_full}} para obter insight sobre como seus apps móveis estão sendo executados e como estão sendo usados.

-Leia mais sobre como operar esse serviço na documentação do {{site.data.keyword.mobileanalytics_short}}. -
Ícone de serviço {{site.data.keyword.mobilefoundation_short}}
{{site.data.keyword.mobilefoundation_short}}		Use o serviço {{site.data.keyword.mobilefoundation_long}} para expedir a configuração de um ambiente do {{site.data.keyword.mfp_full}} do qual seja possível desenvolver, testar e operar apps móveis corporativos.

-Leia mais sobre como operar esse serviço na documentação do {{site.data.keyword.mobilefoundation_short}}.
Ícone de serviço {{site.data.keyword.mobilepushshort}}
{{site.data.keyword.mobilepushshort}}		O serviço {{site.data.keyword.mobilepushfull}} fornece uma plataforma unificada para enviar e gerenciar notificações push móveis e da web que são destinadas entre plataformas. -

-O {{site.data.keyword.mobilepushshort}} gerencia o mapeamento dos usuários do aplicativo para seus dispositivos, plataforma de dispositivo, navegadores da web e manipula o despacho de notificações push para eles. É possível enviar transmissões, unicasts (com base em deviceID e userID) e também tags (ou tópicos) como notificações push para os usuários do aplicativo do dispositivo móvel e do navegador da web. Também é possível usar o SDK e as APIs de REST para desenvolver melhor os aplicativos cliente. -

-Leia mais sobre como operar esse serviço na documentação do {{site.data.keyword.mobilepushshort}}.
+--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# Serviços +{: #services} + +Na página **Serviços** do {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, é possível visualizar seus serviços Web e Mobile existentes ou criar novos serviços. O console fornece um único local para visualizar todos os serviços Web e Mobile do {{site.data.keyword.Bluemix_notm}} que estão sendo gerenciados pelos projetos. + +Se você excluir serviços da visualização **Serviços**, irá desconectar o serviço do projeto ao qual ele está associado. Crie uma nova instância de serviço se quiser reconectar o serviço ao projeto. + +## Visão geral dos serviços Web e Mobile do {{site.data.keyword.Bluemix_notm}} +{: #mobile_services_overview} + +A tabela a seguir representa os serviços Web e Mobile do {{site.data.keyword.Bluemix_notm}}. É possível usar serviços individuais do catálogo do {{site.data.keyword.Bluemix_notm}} ou integrá-los a seu projeto. + + + + + + + + + + + + + + + + + + + +
Tabela 1. Serviços Web e Mobile do {{site.data.keyword.Bluemix_notm}}
Serviços Web e Mobile do {{site.data.keyword.Bluemix_notm}}Descrição
Ícone {{site.data.keyword.mobileanalytics_short}}
{{site.data.keyword.mobileanalytics_short}}		Use o serviço {{site.data.keyword.mobileanalytics_full}} para obter insight sobre como seus apps móveis estão sendo executados e como estão sendo usados.

+Leia mais sobre como operar esse serviço na documentação do {{site.data.keyword.mobileanalytics_short}}. +
Ícone de serviço {{site.data.keyword.mobilefoundation_short}}
{{site.data.keyword.mobilefoundation_short}}		Use o serviço {{site.data.keyword.mobilefoundation_long}} para expedir a configuração de um ambiente do {{site.data.keyword.mfp_full}} do qual seja possível desenvolver, testar e operar apps móveis corporativos.

+Leia mais sobre como operar esse serviço na documentação do {{site.data.keyword.mobilefoundation_short}}.
Ícone de serviço {{site.data.keyword.mobilepushshort}}
{{site.data.keyword.mobilepushshort}}		O serviço {{site.data.keyword.mobilepushfull}} fornece uma plataforma unificada para enviar e gerenciar notificações push móveis e da web que são destinadas entre plataformas. +

+O {{site.data.keyword.mobilepushshort}} gerencia o mapeamento dos usuários do aplicativo para seus dispositivos, plataforma de dispositivo, navegadores da web e manipula o despacho de notificações push para eles. É possível enviar transmissões, unicasts (com base em deviceID e userID) e também tags (ou tópicos) como notificações push para os usuários do aplicativo do dispositivo móvel e do navegador da web. Também é possível usar o SDK e as APIs de REST para desenvolver melhor os aplicativos cliente. +

+Leia mais sobre como operar esse serviço na documentação do {{site.data.keyword.mobilepushshort}}.
diff --git a/cloudnative/nl/pt/BR/starters.md b/cloudnative/nl/pt/BR/starters.md index d0da0cc33..9a5569685 100644 --- a/cloudnative/nl/pt/BR/starters.md +++ b/cloudnative/nl/pt/BR/starters.md @@ -1,27 +1,27 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Dispositivos de Arranque -{: #starters} - -Com o {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, é possível escolher entre uma variedade de iniciadores para cada tipo padrão. - -Os iniciadores são otimizados para ser o código iniciador pronto para produção que foca na demonstração de uma integração principal do {{site.data.keyword.Bluemix_notm}} a um serviço de alto valor. Cada iniciador -foca em um serviço e mostra a integração dos SDKs de serviço no código. Em alguns casos, os iniciadores oferecem uma experiência de usuário simples para destacar a integração dos dados de serviço ou as interações com o usuário. Cada iniciador será configurado para ser ativado com Autenticação, Dados e, possivelmente, outros recursos, se você decidir configurá-los para seu projeto. - - -## Tutorials -{: #tutorials notoc} - -Para obter instruções mais detalhadas sobre como criar apps com iniciadores, é possível usar os [tutoriais](tutorials.html) de ponta a ponta. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Dispositivos de Arranque +{: #starters} + +Com o {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, é possível escolher entre uma variedade de iniciadores para cada tipo padrão. + +Os iniciadores são otimizados para ser o código iniciador pronto para produção que foca na demonstração de uma integração principal do {{site.data.keyword.Bluemix_notm}} a um serviço de alto valor. Cada iniciador +foca em um serviço e mostra a integração dos SDKs de serviço no código. Em alguns casos, os iniciadores oferecem uma experiência de usuário simples para destacar a integração dos dados de serviço ou as interações com o usuário. Cada iniciador será configurado para ser ativado com Autenticação, Dados e, possivelmente, outros recursos, se você decidir configurá-los para seu projeto. + + +## Tutorials +{: #tutorials notoc} + +Para obter instruções mais detalhadas sobre como criar apps com iniciadores, é possível usar os [tutoriais](tutorials.html) de ponta a ponta. diff --git a/cloudnative/nl/pt/BR/troubleshoot.md b/cloudnative/nl/pt/BR/troubleshoot.md index 6a413bc7e..c0ff16a83 100644 --- a/cloudnative/nl/pt/BR/troubleshoot.md +++ b/cloudnative/nl/pt/BR/troubleshoot.md @@ -1,223 +1,223 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# Resolução de problema -{: #ts} - -Alguns problemas conhecidos com a {{site.data.keyword.dev_cli_notm}} são documentados, junto a suas soluções alternativas. -{:shortdesc} - - - -## Problemas conhecidos -{: #knownissues} - -As seções a seguir descrevem os problemas conhecidos e as possíveis resoluções. - - -### Erro "Hostname is taken" ao criar um projeto com um padrão não móvel -{: #hostname} - -Será possível ver o erro a seguir se você usar a {{site.data.keyword.dev_cli_short}} para criar um projeto por meio dos padrões Web App, BFF ou Microservice: - -``` -The hostname is taken. -``` -{: codeblock} - - -#### Causa -{: #hostname-cause} - -Esse erro deve-se a um token de login expirado. - - -#### Resolução -{: #hostname-resolution} - -Efetue login novamente. - -``` -bx login -``` -{: codeblock} - - -### Falhas gerais com a {{site.data.keyword.dev_cli_short}} -{: #general} - -Será possível ver o erro a seguir se você usar os comandos create, delete, list ou code da {{site.data.keyword.dev_cli_short}}: - -``` -Failed to project. -``` -{: codeblock} - - -#### Causa -{: #hostname-cause} - -Esse erro deve-se a um token de login expirado. - - -#### Resolução -{: #hostname-resolution} - -Efetue login novamente. - -``` -bx login -``` -{: codeblock} - - -### Erro do broker de serviço ao incluir o recurso {{site.data.keyword.objectstorageshort}} -{: #os} - -Será possível ver o erro a seguir se você usar a {{site.data.keyword.dev_cli_short}} para criar dois projetos com o recurso {{site.data.keyword.objectstorageshort}}: - -``` -FAILED -Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} -``` -{: codeblock} - - -#### Causa -{: #os-cause} - -Esse erro deve-se ao serviço {{site.data.keyword.objectstorageshort}}, que permite apenas uma instância do plano grátis do {{site.data.keyword.objectstorageshort}}. - - -#### Resolução -{: #os-resolution} - -Você será solicitado a escolher um plano diferente para evitar esse erro. - - -### Falha ao obter o código durante a criação do projeto -{: #code} - -Será possível ver o erro a seguir se você usar a {{site.data.keyword.dev_cli_short}} para criar um projeto: - -``` -FAILED -Project created, but could not get code -https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code -``` -{: codeblock} - - -#### Causa -{: #code-cause} - -Esse erro deve-se a um tempo limite interno. - - -#### Resolução -{: #code-resolution} - -É possível obter o código de uma das maneiras a seguir: - -* Execute o comando a seguir usando a CLI: - - ``` - bx dev code - ``` - {: codeblock} - - `` deve ser substituído pelo nome do projeto usado durante a criação do projeto. - -* Use o {{site.data.keyword.dev_console}}. - - 1. Selecione seu [projeto ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://console.{DomainName}/developer/projects) no {{site.data.keyword.dev_console}} e clique em **Obter o código**. - - 2. Clique em **Gerar código**. - - 3. Depois que o código for gerado, clique em **Fazer download do código**. - - -### Erro ao executar `bx dev run` para projetos Node.js -{: #node} - -Será possível ver o erro a seguir se você estiver executando `bx dev run` com a {{site.data.keyword.dev_cli_short}} para projetos Node.js Web ou BFF: - -``` -module.js:597 - return process.dlopen(module, path._makeLong(filename)); - ^ - -Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header - at Error (native) - at Object.Module._extensions..node (module.js:597:18) - at Module.load (module.js:487:32) - at tryModuleLoad (module.js:446:12) - - at Function.Module._load (module.js:438:3) - at Module.require (module.js:497:17) - at require (internal/module.js:20:19) - at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) - at Module._compile (module.js:570:32) - at Object.Module._extensions..js (module.js:579:10) -``` -{: codeblock} - - -#### Causa -{: #node-cause} - -Esse erro deve-se ao módulo `appmetrics` que está sendo instalado em uma arquitetura diferente. Os módulos npm nativos instalados em uma arquitetura não funcionarão em outra. As imagens incluídas do Docker baseiam-se no kernel Linux. - - -#### Resolução -{: #node-resolution} - -Exclua a pasta `node_modules` e execute `bx dev run` novamente. - - - - - - - -## Obtendo Ajuda e Suporte -{: #gettinghelp} - -Se você tiver problemas ou perguntas ao usar o {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ou a {{site.data.keyword.dev_cli_notm}}, poderá obter ajuda procurando informações ou fazendo perguntas por meio de um fórum. Também é possível abrir um chamado de suporte. - -Ao usar os fóruns para fazer uma pergunta, marque a sua pergunta para que ela possa ser vista pelas equipes de desenvolvimento do {{site.data.keyword.Bluemix_notm}}. - - - -Se tiver questões técnicas sobre como desenvolver ou implementar um app com o {{site.data.keyword.dev_console}} ou a {{site.data.keyword.dev_cli_notm}}: - -* Poste sua pergunta no [Stack Overflow ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) e marque-a com `bluemix-dev-services` e `ibm-bluemix`. -* Poste sua pergunta no [Slack ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://ibm-cloud-tech.slack.com/) no canal `bluemix-dev-services`. [Inscreva-se ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://ibm.biz/IBMCloudNativeSlack) hoje. - - - - - -Consulte [Obtendo ajuda![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/support/index.html#getting-help) para obter mais detalhes sobre o uso dos fóruns. - -Para obter informações sobre como abrir um chamado de suporte da {{site.data.keyword.IBM}} ou sobre os níveis de suporte e as severidades dos chamados, veja [Entrando em contato com o suporte ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/support/index.html#contacting-support). - - - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# Resolução de problema +{: #ts} + +Alguns problemas conhecidos com a {{site.data.keyword.dev_cli_notm}} são documentados, junto a suas soluções alternativas. +{:shortdesc} + + + +## Problemas conhecidos +{: #knownissues} + +As seções a seguir descrevem os problemas conhecidos e as possíveis resoluções. + + +### Erro "Hostname is taken" ao criar um projeto com um padrão não móvel +{: #hostname} + +Será possível ver o erro a seguir se você usar a {{site.data.keyword.dev_cli_short}} para criar um projeto por meio dos padrões Web App, BFF ou Microservice: + +``` +The hostname is taken. +``` +{: codeblock} + + +#### Causa +{: #hostname-cause} + +Esse erro deve-se a um token de login expirado. + + +#### Resolução +{: #hostname-resolution} + +Efetue login novamente. + +``` +bx login +``` +{: codeblock} + + +### Falhas gerais com a {{site.data.keyword.dev_cli_short}} +{: #general} + +Será possível ver o erro a seguir se você usar os comandos create, delete, list ou code da {{site.data.keyword.dev_cli_short}}: + +``` +Failed to project. +``` +{: codeblock} + + +#### Causa +{: #hostname-cause} + +Esse erro deve-se a um token de login expirado. + + +#### Resolução +{: #hostname-resolution} + +Efetue login novamente. + +``` +bx login +``` +{: codeblock} + + +### Erro do broker de serviço ao incluir o recurso {{site.data.keyword.objectstorageshort}} +{: #os} + +Será possível ver o erro a seguir se você usar a {{site.data.keyword.dev_cli_short}} para criar dois projetos com o recurso {{site.data.keyword.objectstorageshort}}: + +``` +FAILED +Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} +``` +{: codeblock} + + +#### Causa +{: #os-cause} + +Esse erro deve-se ao serviço {{site.data.keyword.objectstorageshort}}, que permite apenas uma instância do plano grátis do {{site.data.keyword.objectstorageshort}}. + + +#### Resolução +{: #os-resolution} + +Você será solicitado a escolher um plano diferente para evitar esse erro. + + +### Falha ao obter o código durante a criação do projeto +{: #code} + +Será possível ver o erro a seguir se você usar a {{site.data.keyword.dev_cli_short}} para criar um projeto: + +``` +FAILED +Project created, but could not get code +https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code +``` +{: codeblock} + + +#### Causa +{: #code-cause} + +Esse erro deve-se a um tempo limite interno. + + +#### Resolução +{: #code-resolution} + +É possível obter o código de uma das maneiras a seguir: + +* Execute o comando a seguir usando a CLI: + + ``` + bx dev code + ``` + {: codeblock} + + `` deve ser substituído pelo nome do projeto usado durante a criação do projeto. + +* Use o {{site.data.keyword.dev_console}}. + + 1. Selecione seu [projeto ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://console.{DomainName}/developer/projects) no {{site.data.keyword.dev_console}} e clique em **Obter o código**. + + 2. Clique em **Gerar código**. + + 3. Depois que o código for gerado, clique em **Fazer download do código**. + + +### Erro ao executar `bx dev run` para projetos Node.js +{: #node} + +Será possível ver o erro a seguir se você estiver executando `bx dev run` com a {{site.data.keyword.dev_cli_short}} para projetos Node.js Web ou BFF: + +``` +module.js:597 + return process.dlopen(module, path._makeLong(filename)); + ^ + +Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header + at Error (native) + at Object.Module._extensions..node (module.js:597:18) + at Module.load (module.js:487:32) + at tryModuleLoad (module.js:446:12) + + at Function.Module._load (module.js:438:3) + at Module.require (module.js:497:17) + at require (internal/module.js:20:19) + at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) + at Module._compile (module.js:570:32) + at Object.Module._extensions..js (module.js:579:10) +``` +{: codeblock} + + +#### Causa +{: #node-cause} + +Esse erro deve-se ao módulo `appmetrics` que está sendo instalado em uma arquitetura diferente. Os módulos npm nativos instalados em uma arquitetura não funcionarão em outra. As imagens incluídas do Docker baseiam-se no kernel Linux. + + +#### Resolução +{: #node-resolution} + +Exclua a pasta `node_modules` e execute `bx dev run` novamente. + + + + + + + +## Obtendo Ajuda e Suporte +{: #gettinghelp} + +Se você tiver problemas ou perguntas ao usar o {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ou a {{site.data.keyword.dev_cli_notm}}, poderá obter ajuda procurando informações ou fazendo perguntas por meio de um fórum. Também é possível abrir um chamado de suporte. + +Ao usar os fóruns para fazer uma pergunta, marque a sua pergunta para que ela possa ser vista pelas equipes de desenvolvimento do {{site.data.keyword.Bluemix_notm}}. + + + +Se tiver questões técnicas sobre como desenvolver ou implementar um app com o {{site.data.keyword.dev_console}} ou a {{site.data.keyword.dev_cli_notm}}: + +* Poste sua pergunta no [Stack Overflow ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix) e marque-a com `bluemix-dev-services` e `ibm-bluemix`. +* Poste sua pergunta no [Slack ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://ibm-cloud-tech.slack.com/) no canal `bluemix-dev-services`. [Inscreva-se ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](http://ibm.biz/IBMCloudNativeSlack) hoje. + + + + + +Consulte [Obtendo ajuda![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/support/index.html#getting-help) para obter mais detalhes sobre o uso dos fóruns. + +Para obter informações sobre como abrir um chamado de suporte da {{site.data.keyword.IBM}} ou sobre os níveis de suporte e as severidades dos chamados, veja [Entrando em contato com o suporte ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/support/index.html#contacting-support). + + + diff --git a/cloudnative/nl/pt/BR/tutorial_bff.md b/cloudnative/nl/pt/BR/tutorial_bff.md index 9540fae95..75fa80359 100644 --- a/cloudnative/nl/pt/BR/tutorial_bff.md +++ b/cloudnative/nl/pt/BR/tutorial_bff.md @@ -1,149 +1,149 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Tutorial de ponta a ponta do Iniciador BFF Basic -{: #tutorial} - -O tutorial de ponta a ponta a seguir percorre as etapas para criar um projeto por meio do Iniciador BFF Basic, incluindo as ferramentas que devem ser instaladas e, subsequentemente, as etapas para executar o código do projeto. - -## Instalando ferramentas do desenvolvedor -{: #dev_tools} - -Assegure-se de que você tenha instalado as [ferramentas do desenvolvedor de pré-requisito ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](get_code.html#prereq-dev-tools){: new_window}. - - -## Criando um projeto usando o {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Crie um projeto no {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Na página **Introdução** no {{site.data.keyword.dev_console}}, clique em **Criar projeto**. - - Como alternativa, clique em **Criar projeto** na página **Projetos**. - - 2. Selecione **Backend for Frontend** e clique em **Avançar**. - - 3. Selecione **Basic Backend** e clique em **Avançar**. - - 4. Insira o nome do projeto. Para este tutorial, use `BFFProject`. - - 5. Insira um nome do host. Para este tutorial, use `devhost`. - - 6. Selecione a plataforma da linguagem. Para este tutorial, use `Node`. - - 7. Clique em **Criar**. - -2. Opcional: inclua o recurso Dados. - - 1. Clique em **Visualizar** para **Dados** na página **Visão geral do projeto**. - - Como alternativa, é possível selecionar **Criar** ou **Incluir existente** na página **Recursos > Dados**. - - 2. Insira o nome do serviço e clique em **Criar**. - - -3. Gere seu código do projeto. - - 1. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. - - Como alternativa, é possível clicar na página **Código**. - - 2. Clique em **Gerar código**. - - 3. Quando o código do projeto concluir a geração, clique -em **Fazer download do código** para fazer -download do seu archive de projeto. - -4. Opcional: [atualize seu projeto](project_overview_page.html#update_language) para gerar uma nova linguagem. - - -## Criando um projeto usando a {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assegure-se de que tenha instalado a [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. No prompt do Terminal, navegue para um diretório local de sua preferência e execute o comando a seguir. - - ``` - bx dev create - ``` - {: codeblock} - -3. Forneça os valores a seguir quando solicitado: - - * Selecione um padrão: 3 (para Backend for Frontend) - * Selecione um iniciador: 1 (para Basic Backend) - * Selecione uma linguagem: 1 (para Node) - * Insira um nome para seu projeto: `BFFProjectCLI` - * Insira um nome de host para seu projeto: `myhost` - -4. Se desejar incluir serviços no projeto, digite `y` no prompt de pergunta e responda às perguntas restantes. - -5. Quando o `BFFProjectCLI` tiver sido salvo com sucesso, navegue para a pasta `BFFProjectCLI`. - -6. Nesse ponto será possível incluir seu próprio código, construir ou executar o projeto. - - 1. Construa seu projeto com o comando a seguir: - - ``` - bx dev build - ``` - {: codeblock} - - 2. Execute seu projeto com o comando a seguir: - - ``` - bx dev run - ``` - {: codeblock} - - -## Executando um projeto BFF -{: #running-bff} - -### Localmente -{: #bff-local} - -1. Compile seu servidor: - - ``` - swift build - ``` - {: codeblock} - -2. Execute o aplicativo. Por exemplo, supondo que o nome do aplicativo seja `MyServer`: - - ``` - .build/debug/MyServer - ``` - {: codeblock} - -3. É possível executar curl no servidor com `curl http://localhost:8080` - - -### Usando o plug-in do Bluemix -{: #using-blumix} - -1. Execute a compilação - - ``` - bx dev run - ``` - {: codeblock} - -2. É possível executar curl no servidor com - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Tutorial de ponta a ponta do Iniciador BFF Basic +{: #tutorial} + +O tutorial de ponta a ponta a seguir percorre as etapas para criar um projeto por meio do Iniciador BFF Basic, incluindo as ferramentas que devem ser instaladas e, subsequentemente, as etapas para executar o código do projeto. + +## Instalando ferramentas do desenvolvedor +{: #dev_tools} + +Assegure-se de que você tenha instalado as [ferramentas do desenvolvedor de pré-requisito ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](get_code.html#prereq-dev-tools){: new_window}. + + +## Criando um projeto usando o {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Crie um projeto no {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Na página **Introdução** no {{site.data.keyword.dev_console}}, clique em **Criar projeto**. + + Como alternativa, clique em **Criar projeto** na página **Projetos**. + + 2. Selecione **Backend for Frontend** e clique em **Avançar**. + + 3. Selecione **Basic Backend** e clique em **Avançar**. + + 4. Insira o nome do projeto. Para este tutorial, use `BFFProject`. + + 5. Insira um nome do host. Para este tutorial, use `devhost`. + + 6. Selecione a plataforma da linguagem. Para este tutorial, use `Node`. + + 7. Clique em **Criar**. + +2. Opcional: inclua o recurso Dados. + + 1. Clique em **Visualizar** para **Dados** na página **Visão geral do projeto**. + + Como alternativa, é possível selecionar **Criar** ou **Incluir existente** na página **Recursos > Dados**. + + 2. Insira o nome do serviço e clique em **Criar**. + + +3. Gere seu código do projeto. + + 1. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. + + Como alternativa, é possível clicar na página **Código**. + + 2. Clique em **Gerar código**. + + 3. Quando o código do projeto concluir a geração, clique +em **Fazer download do código** para fazer +download do seu archive de projeto. + +4. Opcional: [atualize seu projeto](project_overview_page.html#update_language) para gerar uma nova linguagem. + + +## Criando um projeto usando a {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assegure-se de que tenha instalado a [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. No prompt do Terminal, navegue para um diretório local de sua preferência e execute o comando a seguir. + + ``` + bx dev create + ``` + {: codeblock} + +3. Forneça os valores a seguir quando solicitado: + + * Selecione um padrão: 3 (para Backend for Frontend) + * Selecione um iniciador: 1 (para Basic Backend) + * Selecione uma linguagem: 1 (para Node) + * Insira um nome para seu projeto: `BFFProjectCLI` + * Insira um nome de host para seu projeto: `myhost` + +4. Se desejar incluir serviços no projeto, digite `y` no prompt de pergunta e responda às perguntas restantes. + +5. Quando o `BFFProjectCLI` tiver sido salvo com sucesso, navegue para a pasta `BFFProjectCLI`. + +6. Nesse ponto será possível incluir seu próprio código, construir ou executar o projeto. + + 1. Construa seu projeto com o comando a seguir: + + ``` + bx dev build + ``` + {: codeblock} + + 2. Execute seu projeto com o comando a seguir: + + ``` + bx dev run + ``` + {: codeblock} + + +## Executando um projeto BFF +{: #running-bff} + +### Localmente +{: #bff-local} + +1. Compile seu servidor: + + ``` + swift build + ``` + {: codeblock} + +2. Execute o aplicativo. Por exemplo, supondo que o nome do aplicativo seja `MyServer`: + + ``` + .build/debug/MyServer + ``` + {: codeblock} + +3. É possível executar curl no servidor com `curl http://localhost:8080` + + +### Usando o plug-in do Bluemix +{: #using-blumix} + +1. Execute a compilação + + ``` + bx dev run + ``` + {: codeblock} + +2. É possível executar curl no servidor com + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/pt/BR/tutorial_microservice.md b/cloudnative/nl/pt/BR/tutorial_microservice.md index b48593e14..5b7e5a3a6 100644 --- a/cloudnative/nl/pt/BR/tutorial_microservice.md +++ b/cloudnative/nl/pt/BR/tutorial_microservice.md @@ -1,115 +1,115 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Tutorial de ponta a ponta do Iniciador Microservice Basic -{: #tutorial} - -O tutorial de ponta a ponta a seguir percorre as etapas para criar um projeto por meio do Iniciador Microservice Basic, incluindo as ferramentas que devem ser instaladas e, subsequentemente, as etapas para executar o código do projeto. - -## Instalando ferramentas do desenvolvedor -{: #dev_tools} - -Assegure-se de que você tenha instalado as [ferramentas do desenvolvedor de pré-requisito ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](get_code.html#prereq-dev-tools){: new_window}. - - -## Criando um projeto usando o {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Crie um projeto no {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Na página **Introdução** no {{site.data.keyword.dev_console}}, clique em **Criar projeto**. - - Como alternativa, clique em **Criar projeto** na página **Projetos**. - - 2. Selecione **Microservice** e clique em **Avançar**. - - 3. Selecione **Basic** e clique em **Avançar**. - - 4. Insira o nome do projeto. Para este tutorial, use `MicroserviceProject`. - - 5. Insira um nome do host. Para este tutorial, use `devhost`. - - 6. Clique em **Criar**. - -2. Opcional: inclua o recurso Dados. - - 1. Clique em **Visualizar** para **Dados** na página **Visão geral do projeto**. - - Como alternativa, é possível selecionar **Criar** ou **Incluir existente** na página **Recursos > Dados**. - - 2. Insira o nome do serviço e clique em **Criar**. - -3. Gere seu código do projeto. - - 1. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. - - Como alternativa, é possível clicar na página **Código**. - - 2. Clique em **Gerar código**. - - 3. Quando o código do projeto concluir a geração, clique -em **Fazer download do código** para fazer -download do seu archive de projeto. - -4. Opcional: [atualize seu projeto](project_overview_page.html#update_language) para gerar uma nova linguagem. - - -## Criando um projeto usando a {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assegure-se de que tenha instalado a [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. No prompt do Terminal, navegue para um diretório local de sua preferência e execute o comando a seguir. - - ``` - bx dev create - ``` - {: codeblock} - -3. Forneça os valores a seguir quando solicitado: - - * Selecione um padrão: 4 (para Microservices) - * Selecione um iniciador: 1 (para Basic) - * Selecione uma plataforma: 3 (para Java) - * Insira um nome para seu projeto: `MicroserviceProjectCLI` - -4. Se desejar incluir serviços no projeto, digite `y` no prompt de pergunta e responda às perguntas restantes. - -5. Quando o `MicroserviceProjectCLI` tiver sido salvo com sucesso, navegue para a pasta `MicroserviceProjectCLI`. - -6. Nesse ponto será possível incluir seu próprio código, construir ou executar o projeto. - - -## Executando o projeto usando a {{site.data.keyword.dev_cli_notm}} -{: #running-dev-plugin} - -1. Para construir o projeto no diretório de projeto atual, insira o comando a seguir: - - ``` - bx dev build - ``` - {: codeblock} - -2. Para construir e executar o projeto no diretório de projeto atual, insira o comando a seguir: - - ``` - bx dev run - ``` - {: codeblock} - -3. É possível acessar o aplicativo usando curl no servidor: - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Tutorial de ponta a ponta do Iniciador Microservice Basic +{: #tutorial} + +O tutorial de ponta a ponta a seguir percorre as etapas para criar um projeto por meio do Iniciador Microservice Basic, incluindo as ferramentas que devem ser instaladas e, subsequentemente, as etapas para executar o código do projeto. + +## Instalando ferramentas do desenvolvedor +{: #dev_tools} + +Assegure-se de que você tenha instalado as [ferramentas do desenvolvedor de pré-requisito ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](get_code.html#prereq-dev-tools){: new_window}. + + +## Criando um projeto usando o {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Crie um projeto no {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Na página **Introdução** no {{site.data.keyword.dev_console}}, clique em **Criar projeto**. + + Como alternativa, clique em **Criar projeto** na página **Projetos**. + + 2. Selecione **Microservice** e clique em **Avançar**. + + 3. Selecione **Basic** e clique em **Avançar**. + + 4. Insira o nome do projeto. Para este tutorial, use `MicroserviceProject`. + + 5. Insira um nome do host. Para este tutorial, use `devhost`. + + 6. Clique em **Criar**. + +2. Opcional: inclua o recurso Dados. + + 1. Clique em **Visualizar** para **Dados** na página **Visão geral do projeto**. + + Como alternativa, é possível selecionar **Criar** ou **Incluir existente** na página **Recursos > Dados**. + + 2. Insira o nome do serviço e clique em **Criar**. + +3. Gere seu código do projeto. + + 1. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. + + Como alternativa, é possível clicar na página **Código**. + + 2. Clique em **Gerar código**. + + 3. Quando o código do projeto concluir a geração, clique +em **Fazer download do código** para fazer +download do seu archive de projeto. + +4. Opcional: [atualize seu projeto](project_overview_page.html#update_language) para gerar uma nova linguagem. + + +## Criando um projeto usando a {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assegure-se de que tenha instalado a [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. No prompt do Terminal, navegue para um diretório local de sua preferência e execute o comando a seguir. + + ``` + bx dev create + ``` + {: codeblock} + +3. Forneça os valores a seguir quando solicitado: + + * Selecione um padrão: 4 (para Microservices) + * Selecione um iniciador: 1 (para Basic) + * Selecione uma plataforma: 3 (para Java) + * Insira um nome para seu projeto: `MicroserviceProjectCLI` + +4. Se desejar incluir serviços no projeto, digite `y` no prompt de pergunta e responda às perguntas restantes. + +5. Quando o `MicroserviceProjectCLI` tiver sido salvo com sucesso, navegue para a pasta `MicroserviceProjectCLI`. + +6. Nesse ponto será possível incluir seu próprio código, construir ou executar o projeto. + + +## Executando o projeto usando a {{site.data.keyword.dev_cli_notm}} +{: #running-dev-plugin} + +1. Para construir o projeto no diretório de projeto atual, insira o comando a seguir: + + ``` + bx dev build + ``` + {: codeblock} + +2. Para construir e executar o projeto no diretório de projeto atual, insira o comando a seguir: + + ``` + bx dev run + ``` + {: codeblock} + +3. É possível acessar o aplicativo usando curl no servidor: + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/pt/BR/tutorial_mobile.md b/cloudnative/nl/pt/BR/tutorial_mobile.md index 36bacbbf6..945aa451b 100644 --- a/cloudnative/nl/pt/BR/tutorial_mobile.md +++ b/cloudnative/nl/pt/BR/tutorial_mobile.md @@ -1,196 +1,196 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Tutorial de ponta a ponta do Iniciador Mobile Basic -{: #tutorial} - -O tutorial de ponta a ponta a seguir percorre as etapas para criar um projeto por meio do Iniciador Mobile Basic, incluindo as ferramentas que devem ser instaladas e, subsequentemente, as etapas para executar o projeto no Xcode e Android Studio. - - -## Instalando ferramentas do desenvolvedor -{: #dev_tools} - -Assegure-se de que você tenha instalado as [ferramentas do desenvolvedor de pré-requisito ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](get_code.html#prereq-dev-tools){: new_window}. - - -## Criando um projeto usando o {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Crie um projeto {{site.data.keyword.dev_console}} no {{site.data.keyword.Bluemix}}. - - 1. Na página **Introdução** no {{site.data.keyword.dev_console}}, clique em **Criar projeto**. - - Como alternativa, clique em **Criar projeto** na página **Projetos**. - - 2. Selecione **Mobile App** e clique em **Avançar**. - - 3. Selecione **Basic** e clique em **Avançar**. - - 4. Insira o nome do projeto. Para este tutorial, use `MobileBasicProject`. - - 5. Selecione sua plataforma. Para este tutorial, use `Swift`. - - 6. Clique em **Criar**. - -2. Opcional: inclua o recurso Autenticação. - - 1. Clique em **Incluir** para **Autenticação** na página **Visão geral do projeto**. - - Como alternativa, é possível selecionar **Criar** ou **Incluir existente** na página **Recursos > Autenticação**. - - 2. Insira o nome do serviço e clique em **Criar**. - - 3. Alterne em **Autenticação**. - - 4. Selecione seu provedor de identidade e insira as informações requeridas para configurá-lo. É possível ativar apenas um provedor de identidade. - - 5. Veja [Configurando provedores de identidade} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/appid/identity-providers.html){: new_window} para obter mais informações sobre como configurar a Autenticação. - -3. Opcional: inclua o recurso de Analítica. - - 1. Clique em **Incluir** para **Analítica** na página **Visão geral do projeto**. - - Como alternativa, clique em **Criar** ou **Incluir existente** na página **Recursos > Analítica**. - - 2. Insira o nome do serviço e clique em **Criar**. - - 3. Desligue o **Modo demo** para ver os seus lados de analítica após executar o seu aplicativo. - - 4. Veja [Introdução ao {{site.data.keyword.mobileanalytics_short}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobileanalytics/index.html){: new_window} para obter mais informações sobre como configurar o Analytics. - -4. Opcional: inclua o recurso {{site.data.keyword.mobilepushshort}}. - - 1. Clique em **Incluir** para o **{{site.data.keyword.mobilepushshort}}** na página **Visão geral do projeto**. - - Como alternativa, clique em **Criar** ou **Incluir existente** na página **Recursos > {{site.data.keyword.mobilepushshort}}**. - - 2. Insira o nome do serviço e clique em **Criar**. - - 3. Para iOS, [configure o Apple Push Notification Service ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}. - - 4. Para Android, [configure o Firebase Cloud Messaging ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}. - -5. Opcional: inclua o recurso Dados. - - 1. Clique em **Visualizar** para **Dados** na página **Visão geral do projeto**. - - Como alternativa, é possível selecionar **Criar** na página **Dados**. - - 2. Escolha **{{site.data.keyword.cloudant_short_notm}}** ou **{{site.data.keyword.objectstorageshort}}**. - - 3. Insira o nome do serviço e clique em **Criar**. - - 4. Veja [Introdução ao {{site.data.keyword.cloudant_short_notm}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/Cloudant/index.html){: new_window} para obter mais informações sobre como configurar o {{site.data.keyword.cloudant_short_notm}}. - - 5. Veja [Introdução ao {{site.data.keyword.objectstorageshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/ObjectStorage/index.html){: new_window} para obter mais informações sobre como configurar o {{site.data.keyword.objectstorageshort}}. - -6. Gere seu código do projeto. - - 1. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. - - Como alternativa, é possível clicar na página **Código**. - - 2. Clique em **Gerar Swift**. - - 3. Quando o código do projeto concluir a geração, clique em **Fazer download do Swift** para fazer download de seu archive de projeto. - -7. Opcional: [atualize seu projeto](project_overview_page.html#update_language) para gerar uma nova linguagem. - - -## Criando um projeto usando a {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assegure-se de que tenha instalado a [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. No prompt do Terminal, navegue para um diretório local de sua preferência e execute o comando a seguir. - - ``` - bx dev create - ``` - {: codeblock} - -3. Forneça os valores a seguir quando solicitado: - - * Selecione um padrão: 2 (para Mobile) - * Selecione um iniciador: 1 (para Basic) - * Selecione uma plataforma: 3 (para iOS Swift) - * Insira um nome para seu projeto: `MobileBasicProjectCLI` - -4. Se desejar incluir serviços no projeto, digite `y` no prompt de pergunta e responda às perguntas restantes. - -5. Quando o `MobileBasicProjectCLI` tiver sido salvo com sucesso, navegue para a pasta `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift`. - - -## Executando seu projeto do Swift no Xcode -{: #run_swift} - -1. Extraia o arquivo `MobileBasicProject-Swift.zip`. - -2. Abra o arquivo `README.md` em um -visualizador Redução para revisar as etapas para configurar seu -projeto. - - 1. Abra seu Terminal e navegue para sua pasta de -projeto. - - 1. Execute `pod setup` se precisar -configurar seu repositório CocoaPods. - - 2. Execute `pod update` se precisar -atualizar os seus módulos existentes. - - 3. Execute `pod install` para instalar -os módulos requeridos para seu projeto. - - 3. Abra sua área de trabalho do Xcode `BasicProject.xcworkspace`. - -3. Execute seu app. - - -## Executando seu projeto do Cordova no Xcode -{: #run_cordova_xcode} - -1. Extraia o arquivo `MobileBasicProject-Cordova.zip`. - -2. Abra o arquivo `README.md` no -visualizador Redução para configurar seu projeto. - - 1. Abra seu projeto `platforms/ios` no Xcode. - -3. Execute seu app. - - -## Executando seu projeto do Cordova no Android Studio -{: #run_cordova_studio} - -1. Extraia o arquivo `BasicProject-Cordova.zip`. - -2. Abra o arquivo `README.md` no -visualizador Redução para configurar seu projeto. - - 1. Abra seu projeto `platforms/android` no Android Studio. - -3. Execute seu app. - - -## Executando seu projeto do Android no Android Studio -{: #run_android} - -1. Extraia o arquivo `MobileBasicProject-Android.zip`. - -2. Abra o arquivo `README.md` no -visualizador Redução para configurar seu projeto. - - 1. Abra seu projeto `BasicProject-Android` no Android Studio. - -3. Execute seu app. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Tutorial de ponta a ponta do Iniciador Mobile Basic +{: #tutorial} + +O tutorial de ponta a ponta a seguir percorre as etapas para criar um projeto por meio do Iniciador Mobile Basic, incluindo as ferramentas que devem ser instaladas e, subsequentemente, as etapas para executar o projeto no Xcode e Android Studio. + + +## Instalando ferramentas do desenvolvedor +{: #dev_tools} + +Assegure-se de que você tenha instalado as [ferramentas do desenvolvedor de pré-requisito ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](get_code.html#prereq-dev-tools){: new_window}. + + +## Criando um projeto usando o {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Crie um projeto {{site.data.keyword.dev_console}} no {{site.data.keyword.Bluemix}}. + + 1. Na página **Introdução** no {{site.data.keyword.dev_console}}, clique em **Criar projeto**. + + Como alternativa, clique em **Criar projeto** na página **Projetos**. + + 2. Selecione **Mobile App** e clique em **Avançar**. + + 3. Selecione **Basic** e clique em **Avançar**. + + 4. Insira o nome do projeto. Para este tutorial, use `MobileBasicProject`. + + 5. Selecione sua plataforma. Para este tutorial, use `Swift`. + + 6. Clique em **Criar**. + +2. Opcional: inclua o recurso Autenticação. + + 1. Clique em **Incluir** para **Autenticação** na página **Visão geral do projeto**. + + Como alternativa, é possível selecionar **Criar** ou **Incluir existente** na página **Recursos > Autenticação**. + + 2. Insira o nome do serviço e clique em **Criar**. + + 3. Alterne em **Autenticação**. + + 4. Selecione seu provedor de identidade e insira as informações requeridas para configurá-lo. É possível ativar apenas um provedor de identidade. + + 5. Veja [Configurando provedores de identidade} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/appid/identity-providers.html){: new_window} para obter mais informações sobre como configurar a Autenticação. + +3. Opcional: inclua o recurso de Analítica. + + 1. Clique em **Incluir** para **Analítica** na página **Visão geral do projeto**. + + Como alternativa, clique em **Criar** ou **Incluir existente** na página **Recursos > Analítica**. + + 2. Insira o nome do serviço e clique em **Criar**. + + 3. Desligue o **Modo demo** para ver os seus lados de analítica após executar o seu aplicativo. + + 4. Veja [Introdução ao {{site.data.keyword.mobileanalytics_short}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobileanalytics/index.html){: new_window} para obter mais informações sobre como configurar o Analytics. + +4. Opcional: inclua o recurso {{site.data.keyword.mobilepushshort}}. + + 1. Clique em **Incluir** para o **{{site.data.keyword.mobilepushshort}}** na página **Visão geral do projeto**. + + Como alternativa, clique em **Criar** ou **Incluir existente** na página **Recursos > {{site.data.keyword.mobilepushshort}}**. + + 2. Insira o nome do serviço e clique em **Criar**. + + 3. Para iOS, [configure o Apple Push Notification Service ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}. + + 4. Para Android, [configure o Firebase Cloud Messaging ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}. + +5. Opcional: inclua o recurso Dados. + + 1. Clique em **Visualizar** para **Dados** na página **Visão geral do projeto**. + + Como alternativa, é possível selecionar **Criar** na página **Dados**. + + 2. Escolha **{{site.data.keyword.cloudant_short_notm}}** ou **{{site.data.keyword.objectstorageshort}}**. + + 3. Insira o nome do serviço e clique em **Criar**. + + 4. Veja [Introdução ao {{site.data.keyword.cloudant_short_notm}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/Cloudant/index.html){: new_window} para obter mais informações sobre como configurar o {{site.data.keyword.cloudant_short_notm}}. + + 5. Veja [Introdução ao {{site.data.keyword.objectstorageshort}} ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/ObjectStorage/index.html){: new_window} para obter mais informações sobre como configurar o {{site.data.keyword.objectstorageshort}}. + +6. Gere seu código do projeto. + + 1. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. + + Como alternativa, é possível clicar na página **Código**. + + 2. Clique em **Gerar Swift**. + + 3. Quando o código do projeto concluir a geração, clique em **Fazer download do Swift** para fazer download de seu archive de projeto. + +7. Opcional: [atualize seu projeto](project_overview_page.html#update_language) para gerar uma nova linguagem. + + +## Criando um projeto usando a {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assegure-se de que tenha instalado a [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. No prompt do Terminal, navegue para um diretório local de sua preferência e execute o comando a seguir. + + ``` + bx dev create + ``` + {: codeblock} + +3. Forneça os valores a seguir quando solicitado: + + * Selecione um padrão: 2 (para Mobile) + * Selecione um iniciador: 1 (para Basic) + * Selecione uma plataforma: 3 (para iOS Swift) + * Insira um nome para seu projeto: `MobileBasicProjectCLI` + +4. Se desejar incluir serviços no projeto, digite `y` no prompt de pergunta e responda às perguntas restantes. + +5. Quando o `MobileBasicProjectCLI` tiver sido salvo com sucesso, navegue para a pasta `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift`. + + +## Executando seu projeto do Swift no Xcode +{: #run_swift} + +1. Extraia o arquivo `MobileBasicProject-Swift.zip`. + +2. Abra o arquivo `README.md` em um +visualizador Redução para revisar as etapas para configurar seu +projeto. + + 1. Abra seu Terminal e navegue para sua pasta de +projeto. + + 1. Execute `pod setup` se precisar +configurar seu repositório CocoaPods. + + 2. Execute `pod update` se precisar +atualizar os seus módulos existentes. + + 3. Execute `pod install` para instalar +os módulos requeridos para seu projeto. + + 3. Abra sua área de trabalho do Xcode `BasicProject.xcworkspace`. + +3. Execute seu app. + + +## Executando seu projeto do Cordova no Xcode +{: #run_cordova_xcode} + +1. Extraia o arquivo `MobileBasicProject-Cordova.zip`. + +2. Abra o arquivo `README.md` no +visualizador Redução para configurar seu projeto. + + 1. Abra seu projeto `platforms/ios` no Xcode. + +3. Execute seu app. + + +## Executando seu projeto do Cordova no Android Studio +{: #run_cordova_studio} + +1. Extraia o arquivo `BasicProject-Cordova.zip`. + +2. Abra o arquivo `README.md` no +visualizador Redução para configurar seu projeto. + + 1. Abra seu projeto `platforms/android` no Android Studio. + +3. Execute seu app. + + +## Executando seu projeto do Android no Android Studio +{: #run_android} + +1. Extraia o arquivo `MobileBasicProject-Android.zip`. + +2. Abra o arquivo `README.md` no +visualizador Redução para configurar seu projeto. + + 1. Abra seu projeto `BasicProject-Android` no Android Studio. + +3. Execute seu app. diff --git a/cloudnative/nl/pt/BR/tutorial_web.md b/cloudnative/nl/pt/BR/tutorial_web.md index 3c3ae21e1..d1705044e 100644 --- a/cloudnative/nl/pt/BR/tutorial_web.md +++ b/cloudnative/nl/pt/BR/tutorial_web.md @@ -1,195 +1,195 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Tutorial de ponta a ponta do Iniciador Web Basic -{: #tutorial} - -O tutorial de ponta a ponta a seguir percorre as etapas para criar um projeto por meio do Iniciador Web Basic, incluindo as ferramentas que devem ser instaladas e, subsequentemente, as etapas para executar o código do projeto. - -## Instalando ferramentas do desenvolvedor -{: #dev_tools} - -Assegure-se de que você tenha instalado as [ferramentas do desenvolvedor de pré-requisito ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](get_code.html#prereq-dev-tools){: new_window}. - - -## Criando um projeto usando o {{site.data.keyword.dev_console}} -{: #create-devex} - -1. Crie um projeto no {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. - - 1. Na página **Introdução** no {{site.data.keyword.dev_console}}, clique em **Criar projeto**. - - Como alternativa, clique em **Criar projeto** na página **Projetos**. - - 2. Selecione **Web App** e clique em **Avançar**. - - 3. Selecione **Basic Web** e clique em **Avançar**. - - 4. Insira o nome do projeto. Para este tutorial, use `WebBasicProject`. - - 5. Insira um nome do host. Para este tutorial, use `devhost`. - - 6. Selecione a plataforma da linguagem. Para este tutorial, use `Swift`. - - 7. Clique em **Criar**. - -2. Opcional: inclua o recurso Dados. - - 1. Clique em **Visualizar** para **Dados** na página **Visão geral do projeto**. - - Como alternativa, é possível selecionar **Criar** ou **Incluir existente** na página **Recursos > Dados**. - - 2. Insira o nome do serviço e clique em **Criar**. - - -3. Gere seu código do projeto. - - 1. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. - - Como alternativa, é possível clicar na página **Código**. - - 2. Clique em **Gerar código**. - - 3. Quando o código do projeto concluir a geração, clique -em **Fazer download do código** para fazer -download do seu archive de projeto. - -4. Opcional: [atualize seu projeto](project_overview_page.html#update_language) para gerar uma nova linguagem. - - -## Criando um projeto usando a {{site.data.keyword.dev_cli_notm}} -{: #create-cli} - -1. Assegure-se de que tenha instalado a [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - -2. No prompt do Terminal, navegue para um diretório local de sua preferência e execute o comando a seguir. - - ``` - bx dev create - ``` - {: codeblock} - - -3. Forneça os valores a seguir quando solicitado: - - * Selecione um padrão: 1 (para Web) - * Selecione um iniciador: 1 (para Basic Web) - * Selecione uma linguagem: 2 (para Swift) - * Insira um nome para seu projeto: `WebBasicProjectCLI` - * Insira um nome de host para seu projeto: `myhost` - -4. Se desejar incluir serviços no projeto, digite `y` no prompt de pergunta e responda às perguntas restantes. - -5. Quando seu projeto `WebBasicProjectCLI` tiver sido salvo com sucesso, navegue para a pasta `WebBasicProjectCLI`. - -6. Inclua seu próprio código, construa o projeto ou execute o projeto. - - 1. Construa o projeto com o comando a seguir: - - ``` - bx dev build - ``` - {: codeblock} - - 2. Execute o projeto com o comando a seguir: - - ``` - bx dev run - ``` - {: codeblock} - - -## Executando um projeto da web -{: #run} - -### Localmente -{: #local notoc} - -1. Instale as dependências do nó: - - ``` - npm install - ``` - {: codeblock} - -2. Empacote seu código de front-end em um módulo: - - ``` - node_modules/.bin/gulp - ``` - {: codeblock} - -3. Compile seu servidor: - - ``` - swift build - ``` - {: codeblock} - -4. Execute seu aplicativo: - - ``` - .build/debug/WebBasicProjectCLI - ``` - {: codeblock} - -5. Abra seu navegador em `http://localhost:8080`. - - -### Usando a {{site.data.keyword.dev_cli_short}} -{: #dev notoc} - -1. Instale as dependências do nó: - - ``` - npm install - ``` - {: codeblock} - -2. Empacote seu código de front-end em um módulo: - - ``` - gulp - ``` - {: codeblock} - -3. Execute a compilação: - - ``` - bx dev run - ``` - {: codeblock} - -4. Abra seu navegador em `http://localhost:8080`. - - -## Executando o seu projeto do Xcode -{: #Xcode} - -1. Crie um projeto Xcode. - - Antes de ser possível desenvolver em Xcode, é necessário usar o gerenciador de pacotes Swift para construir um projeto Xcode. - - ``` - swift project generate-xcodeproj - ``` - {: codeblock} - -2. Mude seu destino ativo para o executável: - - Em seguida, abra seu projeto em Xcode e certifique-se de que seu destino ativo seja o executável. É possível manter pressionada a chave de opção ao clicar no menu suspenso para selecionar o executável ativo desejado. - -3. Pressione **executar**. - -4. Abra seu navegador em `http://localhost:8080`. - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Tutorial de ponta a ponta do Iniciador Web Basic +{: #tutorial} + +O tutorial de ponta a ponta a seguir percorre as etapas para criar um projeto por meio do Iniciador Web Basic, incluindo as ferramentas que devem ser instaladas e, subsequentemente, as etapas para executar o código do projeto. + +## Instalando ferramentas do desenvolvedor +{: #dev_tools} + +Assegure-se de que você tenha instalado as [ferramentas do desenvolvedor de pré-requisito ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](get_code.html#prereq-dev-tools){: new_window}. + + +## Criando um projeto usando o {{site.data.keyword.dev_console}} +{: #create-devex} + +1. Crie um projeto no {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}. + + 1. Na página **Introdução** no {{site.data.keyword.dev_console}}, clique em **Criar projeto**. + + Como alternativa, clique em **Criar projeto** na página **Projetos**. + + 2. Selecione **Web App** e clique em **Avançar**. + + 3. Selecione **Basic Web** e clique em **Avançar**. + + 4. Insira o nome do projeto. Para este tutorial, use `WebBasicProject`. + + 5. Insira um nome do host. Para este tutorial, use `devhost`. + + 6. Selecione a plataforma da linguagem. Para este tutorial, use `Swift`. + + 7. Clique em **Criar**. + +2. Opcional: inclua o recurso Dados. + + 1. Clique em **Visualizar** para **Dados** na página **Visão geral do projeto**. + + Como alternativa, é possível selecionar **Criar** ou **Incluir existente** na página **Recursos > Dados**. + + 2. Insira o nome do serviço e clique em **Criar**. + + +3. Gere seu código do projeto. + + 1. Clique em **Obter o código** na página **Visão geral do projeto** para selecionar sua linguagem. + + Como alternativa, é possível clicar na página **Código**. + + 2. Clique em **Gerar código**. + + 3. Quando o código do projeto concluir a geração, clique +em **Fazer download do código** para fazer +download do seu archive de projeto. + +4. Opcional: [atualize seu projeto](project_overview_page.html#update_language) para gerar uma nova linguagem. + + +## Criando um projeto usando a {{site.data.keyword.dev_cli_notm}} +{: #create-cli} + +1. Assegure-se de que tenha instalado a [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + +2. No prompt do Terminal, navegue para um diretório local de sua preferência e execute o comando a seguir. + + ``` + bx dev create + ``` + {: codeblock} + + +3. Forneça os valores a seguir quando solicitado: + + * Selecione um padrão: 1 (para Web) + * Selecione um iniciador: 1 (para Basic Web) + * Selecione uma linguagem: 2 (para Swift) + * Insira um nome para seu projeto: `WebBasicProjectCLI` + * Insira um nome de host para seu projeto: `myhost` + +4. Se desejar incluir serviços no projeto, digite `y` no prompt de pergunta e responda às perguntas restantes. + +5. Quando seu projeto `WebBasicProjectCLI` tiver sido salvo com sucesso, navegue para a pasta `WebBasicProjectCLI`. + +6. Inclua seu próprio código, construa o projeto ou execute o projeto. + + 1. Construa o projeto com o comando a seguir: + + ``` + bx dev build + ``` + {: codeblock} + + 2. Execute o projeto com o comando a seguir: + + ``` + bx dev run + ``` + {: codeblock} + + +## Executando um projeto da web +{: #run} + +### Localmente +{: #local notoc} + +1. Instale as dependências do nó: + + ``` + npm install + ``` + {: codeblock} + +2. Empacote seu código de front-end em um módulo: + + ``` + node_modules/.bin/gulp + ``` + {: codeblock} + +3. Compile seu servidor: + + ``` + swift build + ``` + {: codeblock} + +4. Execute seu aplicativo: + + ``` + .build/debug/WebBasicProjectCLI + ``` + {: codeblock} + +5. Abra seu navegador em `http://localhost:8080`. + + +### Usando a {{site.data.keyword.dev_cli_short}} +{: #dev notoc} + +1. Instale as dependências do nó: + + ``` + npm install + ``` + {: codeblock} + +2. Empacote seu código de front-end em um módulo: + + ``` + gulp + ``` + {: codeblock} + +3. Execute a compilação: + + ``` + bx dev run + ``` + {: codeblock} + +4. Abra seu navegador em `http://localhost:8080`. + + +## Executando o seu projeto do Xcode +{: #Xcode} + +1. Crie um projeto Xcode. + + Antes de ser possível desenvolver em Xcode, é necessário usar o gerenciador de pacotes Swift para construir um projeto Xcode. + + ``` + swift project generate-xcodeproj + ``` + {: codeblock} + +2. Mude seu destino ativo para o executável: + + Em seguida, abra seu projeto em Xcode e certifique-se de que seu destino ativo seja o executável. É possível manter pressionada a chave de opção ao clicar no menu suspenso para selecionar o executável ativo desejado. + +3. Pressione **executar**. + +4. Abra seu navegador em `http://localhost:8080`. + diff --git a/cloudnative/nl/pt/BR/tutorials.md b/cloudnative/nl/pt/BR/tutorials.md index 849f97476..22b3f348c 100644 --- a/cloudnative/nl/pt/BR/tutorials.md +++ b/cloudnative/nl/pt/BR/tutorials.md @@ -1,49 +1,49 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Tutoriais de ponta a ponta -{: #tutorial} - -Os tutoriais de ponta a ponta a seguir percorrem as etapas para criar um projeto por meio do {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, incluindo as ferramentas que devem ser instaladas e, subsequentemente, as etapas para executar o código do projeto. - -## Web -{: #web notoc} - -* [Tutorial básico da Web](tutorial_web.html) - - -## Móvel -{: #mobile notoc} - -* [Tutorial básico do Mobile](tutorial_mobile.html) - - - - -## BFF -{: #bff notoc} - -* [Tutorial básico do BFF](tutorial_bff.html) - - -## Microsserviço -{: #microservice notoc} - -* [Tutorial básico do Microservice](tutorial_microservice.html) +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Tutoriais de ponta a ponta +{: #tutorial} + +Os tutoriais de ponta a ponta a seguir percorrem as etapas para criar um projeto por meio do {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}, incluindo as ferramentas que devem ser instaladas e, subsequentemente, as etapas para executar o código do projeto. + +## Web +{: #web notoc} + +* [Tutorial básico da Web](tutorial_web.html) + + +## Móvel +{: #mobile notoc} + +* [Tutorial básico do Mobile](tutorial_mobile.html) + + + + +## BFF +{: #bff notoc} + +* [Tutorial básico do BFF](tutorial_bff.html) + + +## Microsserviço +{: #microservice notoc} + +* [Tutorial básico do Microservice](tutorial_microservice.html) diff --git a/cloudnative/nl/pt/BR/what_is_new.md b/cloudnative/nl/pt/BR/what_is_new.md index 665aa8d29..4b9818929 100644 --- a/cloudnative/nl/pt/BR/what_is_new.md +++ b/cloudnative/nl/pt/BR/what_is_new.md @@ -1,98 +1,98 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# O que há de novo no {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} -{: #what-is-new} - - -## Novo a partir de março de 2017 -{: #mar-2017} - -A atualização de março de 2017 do {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} introduziu as mudanças a seguir: - - * O painel do {{site.data.keyword.Bluemix_notm}} Mobile é agora o {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}. - * A criação do projeto foi projetada novamente para incluir tipos padrão de servidor de Web App, BFF e Microservice com suporte para Node.js, Java e Swift. - * A integração com o serviço {{site.data.keyword.appid_full}} novo e melhorado fornece autenticação para projetos Móveis e da Web. - * Agora também é possível gerar SDKs para seus projetos usando o [plug-in do SDK Generator](sdk_cli.html). A geração de SDK no {{site.data.keyword.dev_console}} está disponível apenas para projetos móveis. - * Agora também é possível criar projetos usando a [{{site.data.keyword.dev_cli_short}}](dev_cli.html). - - -## Novo a partir de janeiro de 2017 -{: #jan-2017} - -A atualização de janeiro de 2017 do painel do {{site.data.keyword.Bluemix_notm}} Mobile introduziu as mudanças a seguir: - - * A partir de 31 de janeiro, os Iniciadores de UI foram descontinuados. Os projetos existentes que foram criados por meio de um Iniciador de UI podem ser usados até 30 de abril de 2017. Para obter mais informações sobre as etapas de migração e as datas de remoção, veja a [postagem do blog de anúncio de descontinuação ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/). -{: deprecated} - * Agora é possível atualizar seu tipo de iniciador de projeto, em vez de excluir o projeto e criar um novo. - * Agora é possível criar seu projeto com um Iniciador de código [Watson Conversation](tutorial_conversation.html). - * Quando for suportado, agora será possível gerar um SDK para seu projeto. - * Agora é possível incluir suas instâncias de [Cálculo](sdk_compute.html) existentes e gerar SDKs do cliente para incluir em seu projeto. - - -## Novo a partir de dezembro de 2016 -{: #dec-2016} - -A atualização de dezembro de 2016 do painel do {{site.data.keyword.Bluemix_notm}} Mobile introduziu as mudanças a seguir: - - * Agora é possível remover um serviço conectado de um projeto para que ele possa ser excluído ou reutilizado com outro projeto. - * Agora é possível incluir um serviço existente em um projeto. - * Agora é possível criar ou conectar um serviço CloudantNoSQL existente como uma origem de dados quando você usa um Iniciador de código. - * Quando for suportado, agora será possível criar ou conectar um serviço Object Storage existente como uma origem de dados para seu projeto. - * Agora é possível customizar o design de navegação do app que você está criando com um Iniciador de UI. - - -## Novo a partir de novembro de 2016 -{: #nov-2016} - -A atualização de novembro de 2016 do painel do {{site.data.keyword.Bluemix_notm}} Mobile introduziu as -mudanças a seguir: - - * Agora é possível gerar artefatos do SDK (kit de desenvolvimento de software) para seus projetos na página **Código**. - * Agora o Cordova é suportado para o Iniciador de código Basic. - * Agora é possível [relatar eventos de rede ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} e [monitorar solicitações de rede ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} na página **Solicitações de rede** do console do {{site.data.keyword.mobileanalytics_short}}. - * Agora é possível [exportar dados para o dashDB ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} no console do {{site.data.keyword.mobileanalytics_short}}. - - -## Novo a partir de outubro de 2016 -{: #oct-2016} - -A atualização de outubro de 2016 do painel do {{site.data.keyword.Bluemix_notm}} Mobile introduziu as mudanças a seguir: - - * Agora é possível incluir os recursos {{site.data.keyword.mobilepushshort}} e Analytics em seu projeto diretamente do painel. - * [Iniciadores de código](starters.html#Code_Starter) agora estão disponíveis. - * É possível incluir Autenticação nos projetos que você criou a partir de um Iniciador de código. - * Swift agora é suportado. - - -### Analytics -{: #analytics notoc} - - * O modo demo é ativado por padrão quando você inclui o recurso de Analítica. É possível desativar o modo demo para visualizar a analítica depois de executar o app. - - -### UI Builder -{: #ui_builder notoc} - - * O recurso **{{site.data.keyword.mobilepushshort}}** é agora acessado a partir do projeto. - * A guia **Configurações do projeto** foi renomeada para a guia **Configurações**. - * A guia **Autenticação** foi renomeada para a guia **Acesso do usuário**. - - -### Código -{: #code notoc} - - * O código gerado Objective-C e Swift para iOS agora usa CocoaPods para gerenciar dependências. Isso significa que você precisa instalar o CocoaPods. Para instalá-lo, execute `sudo gem install cocoapods`. Após a instalação do CocoaPods, execute `pod setup` para configurá-lo (se não estiver ainda). Por último, execute `pod install` para fazer download e instalar as dependências necessárias do projeto antes de abrir o arquivo `.xcworkspace` no Xcode. Detalhes adicionais estão disponíveis no arquivo `README.md` no archive de código transferido por download. Leia sobre [Ferramentas de pré-requisito do desenvolvedor](get_code.html#prereq-dev-tools) para obter mais informações. - -Verifique novamente várias vezes para se manter em dia com novas atualizações. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# O que há de novo no {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} +{: #what-is-new} + + +## Novo a partir de março de 2017 +{: #mar-2017} + +A atualização de março de 2017 do {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} introduziu as mudanças a seguir: + + * O painel do {{site.data.keyword.Bluemix_notm}} Mobile é agora o {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}. + * A criação do projeto foi projetada novamente para incluir tipos padrão de servidor de Web App, BFF e Microservice com suporte para Node.js, Java e Swift. + * A integração com o serviço {{site.data.keyword.appid_full}} novo e melhorado fornece autenticação para projetos Móveis e da Web. + * Agora também é possível gerar SDKs para seus projetos usando o [plug-in do SDK Generator](sdk_cli.html). A geração de SDK no {{site.data.keyword.dev_console}} está disponível apenas para projetos móveis. + * Agora também é possível criar projetos usando a [{{site.data.keyword.dev_cli_short}}](dev_cli.html). + + +## Novo a partir de janeiro de 2017 +{: #jan-2017} + +A atualização de janeiro de 2017 do painel do {{site.data.keyword.Bluemix_notm}} Mobile introduziu as mudanças a seguir: + + * A partir de 31 de janeiro, os Iniciadores de UI foram descontinuados. Os projetos existentes que foram criados por meio de um Iniciador de UI podem ser usados até 30 de abril de 2017. Para obter mais informações sobre as etapas de migração e as datas de remoção, veja a [postagem do blog de anúncio de descontinuação ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/). +{: deprecated} + * Agora é possível atualizar seu tipo de iniciador de projeto, em vez de excluir o projeto e criar um novo. + * Agora é possível criar seu projeto com um Iniciador de código [Watson Conversation](tutorial_conversation.html). + * Quando for suportado, agora será possível gerar um SDK para seu projeto. + * Agora é possível incluir suas instâncias de [Cálculo](sdk_compute.html) existentes e gerar SDKs do cliente para incluir em seu projeto. + + +## Novo a partir de dezembro de 2016 +{: #dec-2016} + +A atualização de dezembro de 2016 do painel do {{site.data.keyword.Bluemix_notm}} Mobile introduziu as mudanças a seguir: + + * Agora é possível remover um serviço conectado de um projeto para que ele possa ser excluído ou reutilizado com outro projeto. + * Agora é possível incluir um serviço existente em um projeto. + * Agora é possível criar ou conectar um serviço CloudantNoSQL existente como uma origem de dados quando você usa um Iniciador de código. + * Quando for suportado, agora será possível criar ou conectar um serviço Object Storage existente como uma origem de dados para seu projeto. + * Agora é possível customizar o design de navegação do app que você está criando com um Iniciador de UI. + + +## Novo a partir de novembro de 2016 +{: #nov-2016} + +A atualização de novembro de 2016 do painel do {{site.data.keyword.Bluemix_notm}} Mobile introduziu as +mudanças a seguir: + + * Agora é possível gerar artefatos do SDK (kit de desenvolvimento de software) para seus projetos na página **Código**. + * Agora o Cordova é suportado para o Iniciador de código Basic. + * Agora é possível [relatar eventos de rede ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} e [monitorar solicitações de rede ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window} na página **Solicitações de rede** do console do {{site.data.keyword.mobileanalytics_short}}. + * Agora é possível [exportar dados para o dashDB ![Ícone de link externo](../icons/launch-glyph.svg "Ícone de link externo")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window} no console do {{site.data.keyword.mobileanalytics_short}}. + + +## Novo a partir de outubro de 2016 +{: #oct-2016} + +A atualização de outubro de 2016 do painel do {{site.data.keyword.Bluemix_notm}} Mobile introduziu as mudanças a seguir: + + * Agora é possível incluir os recursos {{site.data.keyword.mobilepushshort}} e Analytics em seu projeto diretamente do painel. + * [Iniciadores de código](starters.html#Code_Starter) agora estão disponíveis. + * É possível incluir Autenticação nos projetos que você criou a partir de um Iniciador de código. + * Swift agora é suportado. + + +### Analytics +{: #analytics notoc} + + * O modo demo é ativado por padrão quando você inclui o recurso de Analítica. É possível desativar o modo demo para visualizar a analítica depois de executar o app. + + +### UI Builder +{: #ui_builder notoc} + + * O recurso **{{site.data.keyword.mobilepushshort}}** é agora acessado a partir do projeto. + * A guia **Configurações do projeto** foi renomeada para a guia **Configurações**. + * A guia **Autenticação** foi renomeada para a guia **Acesso do usuário**. + + +### Código +{: #code notoc} + + * O código gerado Objective-C e Swift para iOS agora usa CocoaPods para gerenciar dependências. Isso significa que você precisa instalar o CocoaPods. Para instalá-lo, execute `sudo gem install cocoapods`. Após a instalação do CocoaPods, execute `pod setup` para configurá-lo (se não estiver ainda). Por último, execute `pod install` para fazer download e instalar as dependências necessárias do projeto antes de abrir o arquivo `.xcworkspace` no Xcode. Detalhes adicionais estão disponíveis no arquivo `README.md` no archive de código transferido por download. Leia sobre [Ferramentas de pré-requisito do desenvolvedor](get_code.html#prereq-dev-tools) para obter mais informações. + +Verifique novamente várias vezes para se manter em dia com novas atualizações. diff --git a/cloudnative/nl/zh/CN/cli.md b/cloudnative/nl/zh/CN/cli.md index 5a8d5a387..e78194697 100644 --- a/cloudnative/nl/zh/CN/cli.md +++ b/cloudnative/nl/zh/CN/cli.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 适用于 {{site.data.keyword.Bluemix_notm}} CLI 的插件 -{: #cli} - -可以将以下插件添加到 {{site.data.keyword.Bluemix}} CLI。可以使用这些插件创建 {{site.data.keyword.dev_console}} 项目。 - -* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) -* [{{site.data.keyword.IBM_notm}} SDK Generator 插件](sdk_cli.html) +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 适用于 {{site.data.keyword.Bluemix_notm}} CLI 的插件 +{: #cli} + +可以将以下插件添加到 {{site.data.keyword.Bluemix}} CLI。可以使用这些插件创建 {{site.data.keyword.dev_console}} 项目。 + +* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) +* [{{site.data.keyword.IBM_notm}} SDK Generator 插件](sdk_cli.html) diff --git a/cloudnative/nl/zh/CN/compute.md b/cloudnative/nl/zh/CN/compute.md index 7d6ced16a..90bb54baa 100644 --- a/cloudnative/nl/zh/CN/compute.md +++ b/cloudnative/nl/zh/CN/compute.md @@ -1,181 +1,181 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 计算 -{: #compute} - -当您为 Web 和移动构建云本机数字通道应用程序时，最好的做法是采用服务于前端的后端 (BFF)，将其专门用于数字通道，或者为 Web 和移动客户端应用程序提供相同的数据和逻辑集成支持。有关此体系结构的更多信息，请参阅 [Web 和移动的微服务 ![外部链接图标](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture)。 - -下图显示 BFF 体系结构的概述。 - -![BFF 体系结构](images/bff-arch.png) - -图 1：BFF 体系结构 - -BFF 的概念是从微服务或高价值的 {{site.data.keyword.Bluemix}} 云服务中抽象出常用的业务逻辑和集成逻辑。 - -有了此体系结构，可以使用持续 Delivery Pipeline 搭配开发运营服务，来部署并发布移动或 Web 应用程序的更新，以及部署 BFF 的新版本。 - -如果您对 iOS 使用一个 BFF，而对 Android 使用另一个 BFF，则为这些应用程序提供功能的工程团队不会局限于通过集中 API 发布安排来发布功能。这是微服务和数字通道体系结构的常见目标 - 让团队能够自由地经常发布功能和特性，而无需与另一个团队的发布计划紧密结合。 - - - - -## 将移动客户端与服务于前端的后端集成 -{: #integration} - -为了在移动客户端与 BFF 之间实现轻松集成，{{site.data.keyword.Bluemix_notm}} 支持分别以 Swift 和 Java 语言，为 iOS 和 Android 生成移动客户端 SDK。要启用此功能，您必须使用开放 API 规范 (Swagger) 文档，公开 BFF 集成。此文档可以是 JSON 或 YAML 形式。 - -客户端 SDK 生成器使用开放 API 定义文件，来定义可轻松在本机移动应用程序中使用的客户端优化开发者 SDK。这会加快将 BFF 与移动应用程序的集成的速度。 - - -## 定义 API -{: #definition} - -BFF 需要公开 API 定义文件，该文件符合在活动服务器端点上运行的开放 API 规范。要启用 {{site.data.keyword.Bluemix_notm}} Developer Experience 和 {{site.data.keyword.Bluemix_notm}} SDK CLI（命令行界面）以探索此端点，您必须向名为 `OPENAPI_SPEC` 的 Cloud Foundry 应用程序中添加环境变量。此环境变量必须使用相对路径参考规范。 - -要在 {{site.data.keyword.Bluemix_notm}} 中添加 `OPENAPI_SPEC` 环境变量，请遵循以下步骤： - -1. 登录到 [{{site.data.keyword.Bluemix_notm}} ![外部链接图标](../icons/launch-glyph.svg)](http://bluemix.net)。 -2. 选择 Cloud Foundry 应用程序。 -3. 选择**运行时**。 -4. 选择**环境变量**。 -5. 在**用户定义**部分中单击**添加**。 -6. 为 **NAME** 指定 `OPENAPI_SPEC`，并指定开放 API 定义文件的相对 URL 路径。 -7. 单击**保存**。 - - - -例如： - -``` -OPENAPI_SPEC='/explorer/swagger.json' -``` -{: codeblock} - -使用此方法，{{site.data.keyword.apiconnect_long}} 和 Loopback 应用程序运作得非常好。您可以使用 Loopback 和 {{site.data.keyword.apiconnect_short}} 来定义持久性模型，并使用开放 API 定义文件公开 CRUD（创建、读取、更新和删除）操作。 - -您还可以定义业务逻辑操作。 - - -### 开放 API 规范的支持元素 -{: #supported-elements notoc} - -开放 API 规范中唯一不受完全支持的部分是文件结构。规范允许定义部分分成几个不同的文件，并使用 `$ref` 字段进行参考。整个定义必须包含在一个文件中。 - - -## 使用 Bluegen 的前端服务于后端示例 -{: #bff-bluegen} - -{{site.data.keyword.Bluemix_notm}} 使用 {{site.data.keyword.apiconnect_short}} 和 Strongloop 创建了参考 BFF，其将产品模型与 {{site.data.keyword.cloudant}} 和图像 API 相映射，以参考 {{site.data.keyword.objectstorageshort}} 中的图形。 - -您可以使用此 BFF 模式快速熟悉将完整工作 BFF 供应到 {{site.data.keyword.Bluemix_notm}}，并使用它来帮助理解将 BFF 集成到移动项目，并分别以 Swift 和 Java 为 iOS 和 Android 生成本机 SDK 是多么轻松的一件事。 - -遵循[自述文件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) 指示信息，以创建项目并对其进行安装。 - - -## 使用前端服务于后端与 Developer Experience 项目 -{: #bff-devex} - -{{site.data.keyword.Bluemix_notm}} Mobile Developer Experience 设计用来以一种更简单的方法，来定义与若干云服务相关联的移动项目。您可以轻松地添加 [{{site.data.keyword.mobilepushshort}} ![外部链接图标](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html)、[Analytics ![外部链接图标](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html) 和 Data 或 Storage 服务。 - -{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 在**计算**页面中引入了将 BFF 与移动项目集成的功能。您可以将现有的计算服务实例添加到移动项目。添加之后，您可以为您的语言选择生成本地 SDK，或者您可以生成完整的项目，SDK 将集成到**代码**页面中项目的源程序包中。当您与已很好定义的 BFF 相集成时，这非常有用。 - -在您下载项目之后，可以使用 Xcode 或 Android Studio 打开该项目，并使用客户端 SDK 对项目进行编译。 - - -## 使用 CLI -{: #cli} - -当您开发 BFF 时，API 规范可能会更改。要支持这些更改，您必须具有以下两个选项： - -* 在全新 GitHub 分支中重新生成整个项目并将更改合并至开发分支。 -* 直接使用命令行 (CLI) 工具重新生成 SDK，并仅更新移动项目的 SDK 部分。 - -要使用 CLI，您必须对其进行[安装](sdk_cli.html#installation)。 - -使用以下命令列出您可以执行的操作。 - -``` -bluemix sdk -``` -{: codeblock} - -使用以下命令，列出当前 {{site.data.keyword.Bluemix_notm}} 空间中正在运行的 Cloud Foundry 实例。 - -``` -bluemix sdk list -``` -{: codeblock} - -如果已设置 `OPENAPI_SPEC` 环境变量，则会列出每一个应用程序并验证 API。在 `VALID` 列中，您将看到绿色的勾号或红色的 `X`。应用程序中 `VALID` 列的勾号表示存在有效的开放 API 定义。应用程序的 `VALID` 列中的 `X` 表示以下其中一项： - -* 未对应用程序定义 `OPENAPI_SPEC` 环境变量，或者 -* 对于开放 API 规范，API 定义无效 - -使用以下命令来查看 API 的完整 URL。列出 API 规范的完整路径和 URI。您可以在浏览器中查看原始规范，直接在 CLI 中使用，或者验证 BFF `OPENAPI_SPEC` 环境变量是否设置正确。 - -``` -bluemix sdk list --url -``` -{: codeblock} - -使用以下命令来验证 `` 的开放 API 定义文件，以确定其是否可用于生成 SDK。该命令会在当前空间中查找 ``，并在 `OPENAPI_SPEC` 环境变量中使用相对路径，查找要验证的规范。 - -``` -bluemix sdk validate -``` -{: codeblock} - -使用以下命令，为您所选择的本机 `` 生成 SDK，并将压缩文件置于当前工作目录中。 - -``` -bluemix sdk generate -- -``` -{: codeblock} - -使用 `--unzip` 选项会自动将 SDK 解压缩至当前工作目录。您可以使用 `--output` 选项，选择性地指定要将 SDK 解压缩的位置。您可以使用 GitHub 管理源代码，并创建新分支，专门用于更新 SDK。使用此方法，可更加轻松地查看更改，并将更新的 SDK 合并到开发分支。 - - -## 使用 SDK 生成的模型和 API -{: #models-apis} - -既然您的 BFF 已使用生成的 SDK 集成到移动应用程序中，那么您可以开始使用它。 - -SDK 在 `docs` 目录和 `source` 目录中随附有完整生成的文档。您可以打开 `README.html` 文件以启动文档的 Web 视图，或者打开 `README.md` 文件以启动文档的 Markdown 视图。当您将 SDK 发布到 Cocoapods 或 Maven Central 时，Markdown 文档非常有用。 - -在文档中，可以查看所生成的 API 列表。您可以单击 API，以查看您可以直接粘贴到移动应用程序中的代码片段。 +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 计算 +{: #compute} + +当您为 Web 和移动构建云本机数字通道应用程序时，最好的做法是采用服务于前端的后端 (BFF)，将其专门用于数字通道，或者为 Web 和移动客户端应用程序提供相同的数据和逻辑集成支持。有关此体系结构的更多信息，请参阅 [Web 和移动的微服务 ![外部链接图标](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture)。 + +下图显示 BFF 体系结构的概述。 + +![BFF 体系结构](images/bff-arch.png) + +图 1：BFF 体系结构 + +BFF 的概念是从微服务或高价值的 {{site.data.keyword.Bluemix}} 云服务中抽象出常用的业务逻辑和集成逻辑。 + +有了此体系结构，可以使用持续 Delivery Pipeline 搭配开发运营服务，来部署并发布移动或 Web 应用程序的更新，以及部署 BFF 的新版本。 + +如果您对 iOS 使用一个 BFF，而对 Android 使用另一个 BFF，则为这些应用程序提供功能的工程团队不会局限于通过集中 API 发布安排来发布功能。这是微服务和数字通道体系结构的常见目标 - 让团队能够自由地经常发布功能和特性，而无需与另一个团队的发布计划紧密结合。 + + + + +## 将移动客户端与服务于前端的后端集成 +{: #integration} + +为了在移动客户端与 BFF 之间实现轻松集成，{{site.data.keyword.Bluemix_notm}} 支持分别以 Swift 和 Java 语言，为 iOS 和 Android 生成移动客户端 SDK。要启用此功能，您必须使用开放 API 规范 (Swagger) 文档，公开 BFF 集成。此文档可以是 JSON 或 YAML 形式。 + +客户端 SDK 生成器使用开放 API 定义文件，来定义可轻松在本机移动应用程序中使用的客户端优化开发者 SDK。这会加快将 BFF 与移动应用程序的集成的速度。 + + +## 定义 API +{: #definition} + +BFF 需要公开 API 定义文件，该文件符合在活动服务器端点上运行的开放 API 规范。要启用 {{site.data.keyword.Bluemix_notm}} Developer Experience 和 {{site.data.keyword.Bluemix_notm}} SDK CLI（命令行界面）以探索此端点，您必须向名为 `OPENAPI_SPEC` 的 Cloud Foundry 应用程序中添加环境变量。此环境变量必须使用相对路径参考规范。 + +要在 {{site.data.keyword.Bluemix_notm}} 中添加 `OPENAPI_SPEC` 环境变量，请遵循以下步骤： + +1. 登录到 [{{site.data.keyword.Bluemix_notm}} ![外部链接图标](../icons/launch-glyph.svg)](http://bluemix.net)。 +2. 选择 Cloud Foundry 应用程序。 +3. 选择**运行时**。 +4. 选择**环境变量**。 +5. 在**用户定义**部分中单击**添加**。 +6. 为 **NAME** 指定 `OPENAPI_SPEC`，并指定开放 API 定义文件的相对 URL 路径。 +7. 单击**保存**。 + + + +例如： + +``` +OPENAPI_SPEC='/explorer/swagger.json' +``` +{: codeblock} + +使用此方法，{{site.data.keyword.apiconnect_long}} 和 Loopback 应用程序运作得非常好。您可以使用 Loopback 和 {{site.data.keyword.apiconnect_short}} 来定义持久性模型，并使用开放 API 定义文件公开 CRUD（创建、读取、更新和删除）操作。 + +您还可以定义业务逻辑操作。 + + +### 开放 API 规范的支持元素 +{: #supported-elements notoc} + +开放 API 规范中唯一不受完全支持的部分是文件结构。规范允许定义部分分成几个不同的文件，并使用 `$ref` 字段进行参考。整个定义必须包含在一个文件中。 + + +## 使用 Bluegen 的前端服务于后端示例 +{: #bff-bluegen} + +{{site.data.keyword.Bluemix_notm}} 使用 {{site.data.keyword.apiconnect_short}} 和 Strongloop 创建了参考 BFF，其将产品模型与 {{site.data.keyword.cloudant}} 和图像 API 相映射，以参考 {{site.data.keyword.objectstorageshort}} 中的图形。 + +您可以使用此 BFF 模式快速熟悉将完整工作 BFF 供应到 {{site.data.keyword.Bluemix_notm}}，并使用它来帮助理解将 BFF 集成到移动项目，并分别以 Swift 和 Java 为 iOS 和 Android 生成本机 SDK 是多么轻松的一件事。 + +遵循[自述文件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) 指示信息，以创建项目并对其进行安装。 + + +## 使用前端服务于后端与 Developer Experience 项目 +{: #bff-devex} + +{{site.data.keyword.Bluemix_notm}} Mobile Developer Experience 设计用来以一种更简单的方法，来定义与若干云服务相关联的移动项目。您可以轻松地添加 [{{site.data.keyword.mobilepushshort}} ![外部链接图标](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html)、[Analytics ![外部链接图标](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html) 和 Data 或 Storage 服务。 + +{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 在**计算**页面中引入了将 BFF 与移动项目集成的功能。您可以将现有的计算服务实例添加到移动项目。添加之后，您可以为您的语言选择生成本地 SDK，或者您可以生成完整的项目，SDK 将集成到**代码**页面中项目的源程序包中。当您与已很好定义的 BFF 相集成时，这非常有用。 + +在您下载项目之后，可以使用 Xcode 或 Android Studio 打开该项目，并使用客户端 SDK 对项目进行编译。 + + +## 使用 CLI +{: #cli} + +当您开发 BFF 时，API 规范可能会更改。要支持这些更改，您必须具有以下两个选项： + +* 在全新 GitHub 分支中重新生成整个项目并将更改合并至开发分支。 +* 直接使用命令行 (CLI) 工具重新生成 SDK，并仅更新移动项目的 SDK 部分。 + +要使用 CLI，您必须对其进行[安装](sdk_cli.html#installation)。 + +使用以下命令列出您可以执行的操作。 + +``` +bluemix sdk +``` +{: codeblock} + +使用以下命令，列出当前 {{site.data.keyword.Bluemix_notm}} 空间中正在运行的 Cloud Foundry 实例。 + +``` +bluemix sdk list +``` +{: codeblock} + +如果已设置 `OPENAPI_SPEC` 环境变量，则会列出每一个应用程序并验证 API。在 `VALID` 列中，您将看到绿色的勾号或红色的 `X`。应用程序中 `VALID` 列的勾号表示存在有效的开放 API 定义。应用程序的 `VALID` 列中的 `X` 表示以下其中一项： + +* 未对应用程序定义 `OPENAPI_SPEC` 环境变量，或者 +* 对于开放 API 规范，API 定义无效 + +使用以下命令来查看 API 的完整 URL。列出 API 规范的完整路径和 URI。您可以在浏览器中查看原始规范，直接在 CLI 中使用，或者验证 BFF `OPENAPI_SPEC` 环境变量是否设置正确。 + +``` +bluemix sdk list --url +``` +{: codeblock} + +使用以下命令来验证 `` 的开放 API 定义文件，以确定其是否可用于生成 SDK。该命令会在当前空间中查找 ``，并在 `OPENAPI_SPEC` 环境变量中使用相对路径，查找要验证的规范。 + +``` +bluemix sdk validate +``` +{: codeblock} + +使用以下命令，为您所选择的本机 `` 生成 SDK，并将压缩文件置于当前工作目录中。 + +``` +bluemix sdk generate -- +``` +{: codeblock} + +使用 `--unzip` 选项会自动将 SDK 解压缩至当前工作目录。您可以使用 `--output` 选项，选择性地指定要将 SDK 解压缩的位置。您可以使用 GitHub 管理源代码，并创建新分支，专门用于更新 SDK。使用此方法，可更加轻松地查看更改，并将更新的 SDK 合并到开发分支。 + + +## 使用 SDK 生成的模型和 API +{: #models-apis} + +既然您的 BFF 已使用生成的 SDK 集成到移动应用程序中，那么您可以开始使用它。 + +SDK 在 `docs` 目录和 `source` 目录中随附有完整生成的文档。您可以打开 `README.html` 文件以启动文档的 Web 视图，或者打开 `README.md` 文件以启动文档的 Markdown 视图。当您将 SDK 发布到 Cocoapods 或 Maven Central 时，Markdown 文档非常有用。 + +在文档中，可以查看所生成的 API 列表。您可以单击 API，以查看您可以直接粘贴到移动应用程序中的代码片段。 diff --git a/cloudnative/nl/zh/CN/dev_cli.md b/cloudnative/nl/zh/CN/dev_cli.md index 47c46deea..f0090677c 100644 --- a/cloudnative/nl/zh/CN/dev_cli.md +++ b/cloudnative/nl/zh/CN/dev_cli.md @@ -1,404 +1,404 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.dev_cli_short}} -{: #developercli} - -{{site.data.keyword.dev_cli_long}} 提供了可扩展的命令驱动方法，通过使用 `dev` 插件创建、开发和部署 Web 项目。对于想要在开发端到端微服务应用程序时使用命令行控件的开发者来说是理想的选择。 - -{: shortdesc} - -{{site.data.keyword.dev_cli_notm}} 使用两个容器，便于构建和测试应用程序。第一个容器是工具容器，包含用于构建和测试应用程序所必需的实用程序。此容器的 Docker 文件通过 [dockerfile-tools](#command-parameters) 参数定义。您可以将其视为一个开发容器，因为它包含通常用于开发特定运行时的工具。 - -第二个容器是运行容器。此容器的形式适合部署在如 {{site.data.keyword.Bluemix}} 等产品中使用。因此，此容器一般会定义一个入口点，用于启动应用程序。选择通过 {{site.data.keyword.dev_cli_short}} 运行应用程序时，会使用此容器。此容器的 Docker 文件通过 [dockerfile-run](#run-parameters) 参数定义。 - - -## 添加 {{site.data.keyword.dev_cli_notm}} -{: #add-cli} - - -### 先决条件 -{: #prereq} - -因为 {{site.data.keyword.dev_cli_short}} 不但可扩展性高，而且支持利用其他补充技术，所以必须满足一些先决条件，才能充分开发并正确利用其功能。 - -1. 安装 [Cloud Foundry CLI ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/cloudfoundry/cli#getting-started)。 - -2. 安装 [{{site.data.keyword.Bluemix}} CLI ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://clis.ng.bluemix.net/ui/home.html)。 - -3. 获取 [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net) 标识。 - -4. 可选：如果计划在本地运行和调试应用程序，那么还必须安装 [Docker ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.docker.com/get-docker)。只有非移动项目需要执行此操作。 - - -### 安装 -{: #installation} - -1. 通过运行以下命令安装 [{{site.data.keyword.dev_cli_short}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window}： - - ``` - bx plugin install dev -r Bluemix - ``` - {: codeblock} - -2. 通过运行以下命令验证安装是否成功： - - ``` - bx dev - ``` - {: codeblock} - - -### 开始之前 -{: #before-install} - -1. 登录到 {{site.data.keyword.Bluemix_notm}}。 - - ``` - bx login - ``` - {: codeblock} - - **注：**如果凭证被拒绝，那么使用的可能是联合标识。执行下列步骤以使用联合标识进行认证。 - - - - 1. 登录到 [{{site.data.keyword.iamshort}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.bluemix.net/iam/#/apikeys){: new_window}。 - 2. 选择**创建 API 键**。 - * 输入 apiKey 名称和描述 - 3. 下载 apiKey。 - 4. 打开文件并从 `apiKey` 字段复制值。 - 5. 使用以下命令登录： - - ``` - bx login --apikey - ``` - {: codeblock} - - -## 命令 -{: #commands} - -使用以下命令创建、部署、调试和测试项目。 - -### Build -{: #build} - -您可以使用 `build` 命令构建应用程序。`build-cmd-run` 配置元素用于构建应用程序。`test`、`debug` 和 `run` 命令都会将构建作为正常操作的一部分来运行，其运行方式与 build 命令相同，因此不需要在执行这些命令之前执行 build 命令。 - -在当前项目目录中运行以下命令以构建应用程序： - -``` -bx dev build -``` -{: codeblock} - - -[Build 命令参数](#command-parameters) - - -### Code -{: #code} - -`code` 命令用于在部署后下载应用程序代码，以便可在本地查看或执行其他更改。 - -运行以下命令以从指定项目下载代码。 - -``` -bx dev code -``` -{: codeblock} - - -### Create -{: #create} - -创建新项目，提示所有必需信息，包括语言、项目名称和应用程序模式类型。将在当前目录中创建项目。 - -要在当前项目目录中创建新项目并将服务与其关联，请运行以下命令： - -``` -bx dev create -``` -{: codeblock} - - -### Debug -{: #debug} - -您可以通过 `debug` 命令调试应用程序。通过将 `build-cmd-debug` 配置元素用作构建指令，先针对项目完成构建。然后，容器开始公开 `container-port-map-debug` 中定义的调试端口。将偏好的调试工具连接到端口，可照常调试应用程序。 - -**限制：**：目前 Swift 项目不可用于调试。 - -在当前项目目录中运行以下命令以调试应用程序： - -``` -bx dev debug -``` -{: codeblock} - -要退出调试会话，请使用 `CTRL-C`。 - - -#### Debug 命令参数 -{: #debug-parameters} - -以下参数专用于 `debug` 命令，可帮助调试应用程序。 - -##### `container-port-map-debug` -{: #port-map-debug} - -* 调试端口的端口映射。第一个值为要在主机操作系统中使用的端口，第二个值为容器中的端口 (host:container)。 -* 用法：`bx dev debug container-port-map-debug [7777:7777]` - -##### `build-cmd-debug` -{: #build-cmd-debug} - -* 用于为 DEBUG 构建代码。 -* 用法：`bx dev debug build-cmd-debug build.command.sh` - -##### `debug-cmd` -{: #debug-cmd} - -* 用于在工具容器中调试代码。如果 `build-cmd-debug` 将以调试方式启动应用程序，那么这是可选的。 -* 用法：`bx dev debug debug-cmd /the/debug/command` - -#### 本地应用程序调试： -{: #local-app-dev} - -有关本地应用程序调试的更多信息，请参阅[本地应用程序调试](docs/cloudnative/dev_cli_local_debug.html#local-debug)。 - - -### Delete -{: #delete} - -此命令用于从 {{site.data.keyword.Bluemix}} 空间除去项目。 - -运行以下命令可从 {{site.data.keyword.Bluemix}} 删除项目： - -``` -bx dev delete -``` -{: codeblock} - - -**注** **不会**除去 {{site.data.keyword.Bluemix}} 服务。 - - -### Help -{: #help} - -缺省情况下，如果未传入任何操作或自变量，或者，如果提供了“help”操作，那么此命令会显示常规“帮助”文本。显示的常规帮助包含基本自变量的描述以及可用操作的列表。 - -运行以下命令以显示常规帮助信息： - -``` -bx dev help -``` -{: codeblock} - - -### 列表 -{: #list} - -您可以列出空间中所有 {{site.data.keyword.Bluemix_notm}} 项目。 - -运行以下命令以列出项目： - -``` -bx dev list -``` -{: codeblock} - - - - - -### Run -{: #run} - -您可以通过 `run` 命令运行应用程序。通过将 `build-cmd-run` 配置元素用作构建指令，先针对项目完成构建。然后，会启动运行容器，并公开 `container-port-map` 中定义的端口。如果运行容器不包含完成此步骤的入口点，那么可以使用 `run-cmd` 调用应用程序。 - -在当前项目目录中运行以下命令以启动应用程序： - -``` -bx dev run -``` -{: codeblock} - -要退出会话，请使用 `CTRL-C`。 - - -#### 运行参数 -{: #run-parameters} - -以下参数专用于 `run` 命令，可帮助管理运行容器中的应用程序。 - -##### `container-name-run` -{: #container-name-run} - -* 运行容器的容器名称。 -* 用法：`bx dev run container-name-run ` - -##### `container-path-run` -{: #container-path-run} - -* 容器中要在运行时共享的位置。 -* 用法：`bx dev run container-path-run [/path/to/app]` - -##### `host-path-run` -{: #host-path-run} - -* 容器中要针对运行共享的主机系统上的位置。 -* 用法：`bx dev run host-path-run [/path/to/app/bin]` - -##### `dockerfile-run` -{: #dockerfile-run} - -* 运行容器的 Docker 文件。 -* 用法：`bx dev run dockerfile-run [/path/to/Dockerfile.yml]` - -##### `image-name-run` -{: #image-name-run} - -* 要从 dockerfile-run 创建的映像。 -* 用法：`bx dev run image-name-run [/path/to/image-name]` - -##### `run-cmd` -{: #run-cmd} - -* 用于在运行容器中运行代码的可选参数。如果您的映像将启动应用程序，那么这是可选的。 -* 用法：`bx dev run run-cmd [/the/run/command]` - -### Status -{: #status} - -您可以查询 `container-name-run` 和 `container-name-tools` 所定义的 {{site.data.keyword.dev_cli_short}} 使用的容器的状态。 - -在当前项目目录中运行以下命令以检查容器状态： - -``` -bx dev status -``` -{: codeblock} - - -[Status 命令参数](#command-parameters) - - -### Stop -{: #stop} - -您可以通过 `stop` 命令停止容器。使用 `container-name` 参数可指定要停止的容器。如果未指定此参数，那么 stop 命令将停止 `container-name-run` 所定义的运行容器。 - -在当前项目目录中运行以下命令以停止容器： - -``` -bx dev stop -``` -{: codeblock} - - -#### 其他 stop 参数： -{: #stop-parameter} - -##### `container-name` -{: #container-name} - -* 工具容器的容器名称。 -* 用法：`bx dev stop container-name ` - -### Test -{: #test} - -您可以通过 `test` 命令测试应用程序。通过将 `build-cmd-run` 配置元素用作构建指令，先针对项目完成构建。然后，使用工具容器针对应用程序调用 `test-cmd`。 - -运行以下命令以测试应用程序： - -``` -bx dev test -``` -{: codeblock} - - -[Test 命令参数](#command-parameters) - - -## Build、debug、run 和 test 的参数 -{: #command-parameters} - -既可以将以下参数与 `build|debug|run|test` 命令配合使用，也可以通过命令行和/或直接更新项目的 `cli-config.yml` 文件来指定这些参数。其他参数可用于 [`debug`](#debug-parameters) 和 [`run`](#run-parameters) 命令，并且会记录在其各自的部分中。 - -**注**：在命令行上输入的命令参数优先于 `cli-config.yml` 配置。 - -##### `container-name-tools` -{: #container-name-tools} - -* 工具容器的容器名称。 -* 用法：`bx dev container-name-tools []` - -##### `host-path-tools` -{: #host-path-tools} - -* 主机上要针对 build、debug 和 test 共享的位置。 -* 用法：`bx dev host-path-tools [/path/to/build/tools]` - -##### `container-path-tools` -{: #container-path-tools} - -* 容器中要针对 build、debug 和 test 共享的位置。 -* 用法：`bx dev container-path-tools [/path/for/build]` - -##### `container-port-map` -{: #container-port-map} - -* 容器的端口映射。第一个值为要在主机操作系统中使用的端口，第二个值为容器中的端口 (host:container)。 -* 用法：`bx dev container-port-map [8090:8090,9090,9090]` - -##### `dockerfile-tools` -{: #dockerfile-tools} - -* 工具容器的 Docker 文件。 -* 用法：`bx dev dockerfile-tools [path/to/dockerfile]` - -##### `image-name-tools` -{: #image-name-tools} - -* 要从 dockerfile-tools 创建的映像。 -* 用法：`bx dev image-name-tools [path/to/image-name]` - -##### `build-cmd-run` -{: #build-cmd-run} - -* 用于针对除 DEBUG 之外的所有用法构建代码的命令。 -* 用法：`bx dev build-cmd-run [some.build.command]` - -##### `test-cmd` -{: #test-cmd} - -* 用于在工具容器中测试代码的命令。 -* 用法：`bx dev test-cmd [/the/test/command]` - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.dev_cli_short}} +{: #developercli} + +{{site.data.keyword.dev_cli_long}} 提供了可扩展的命令驱动方法，通过使用 `dev` 插件创建、开发和部署 Web 项目。对于想要在开发端到端微服务应用程序时使用命令行控件的开发者来说是理想的选择。 + +{: shortdesc} + +{{site.data.keyword.dev_cli_notm}} 使用两个容器，便于构建和测试应用程序。第一个容器是工具容器，包含用于构建和测试应用程序所必需的实用程序。此容器的 Docker 文件通过 [dockerfile-tools](#command-parameters) 参数定义。您可以将其视为一个开发容器，因为它包含通常用于开发特定运行时的工具。 + +第二个容器是运行容器。此容器的形式适合部署在如 {{site.data.keyword.Bluemix}} 等产品中使用。因此，此容器一般会定义一个入口点，用于启动应用程序。选择通过 {{site.data.keyword.dev_cli_short}} 运行应用程序时，会使用此容器。此容器的 Docker 文件通过 [dockerfile-run](#run-parameters) 参数定义。 + + +## 添加 {{site.data.keyword.dev_cli_notm}} +{: #add-cli} + + +### 先决条件 +{: #prereq} + +因为 {{site.data.keyword.dev_cli_short}} 不但可扩展性高，而且支持利用其他补充技术，所以必须满足一些先决条件，才能充分开发并正确利用其功能。 + +1. 安装 [Cloud Foundry CLI ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/cloudfoundry/cli#getting-started)。 + +2. 安装 [{{site.data.keyword.Bluemix}} CLI ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://clis.ng.bluemix.net/ui/home.html)。 + +3. 获取 [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net) 标识。 + +4. 可选：如果计划在本地运行和调试应用程序，那么还必须安装 [Docker ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.docker.com/get-docker)。只有非移动项目需要执行此操作。 + + +### 安装 +{: #installation} + +1. 通过运行以下命令安装 [{{site.data.keyword.dev_cli_short}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window}： + + ``` + bx plugin install dev -r Bluemix + ``` + {: codeblock} + +2. 通过运行以下命令验证安装是否成功： + + ``` + bx dev + ``` + {: codeblock} + + +### 开始之前 +{: #before-install} + +1. 登录到 {{site.data.keyword.Bluemix_notm}}。 + + ``` + bx login + ``` + {: codeblock} + + **注：**如果凭证被拒绝，那么使用的可能是联合标识。执行下列步骤以使用联合标识进行认证。 + + + + 1. 登录到 [{{site.data.keyword.iamshort}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.bluemix.net/iam/#/apikeys){: new_window}。 + 2. 选择**创建 API 键**。 + * 输入 apiKey 名称和描述 + 3. 下载 apiKey。 + 4. 打开文件并从 `apiKey` 字段复制值。 + 5. 使用以下命令登录： + + ``` + bx login --apikey + ``` + {: codeblock} + + +## 命令 +{: #commands} + +使用以下命令创建、部署、调试和测试项目。 + +### Build +{: #build} + +您可以使用 `build` 命令构建应用程序。`build-cmd-run` 配置元素用于构建应用程序。`test`、`debug` 和 `run` 命令都会将构建作为正常操作的一部分来运行，其运行方式与 build 命令相同，因此不需要在执行这些命令之前执行 build 命令。 + +在当前项目目录中运行以下命令以构建应用程序： + +``` +bx dev build +``` +{: codeblock} + + +[Build 命令参数](#command-parameters) + + +### Code +{: #code} + +`code` 命令用于在部署后下载应用程序代码，以便可在本地查看或执行其他更改。 + +运行以下命令以从指定项目下载代码。 + +``` +bx dev code +``` +{: codeblock} + + +### Create +{: #create} + +创建新项目，提示所有必需信息，包括语言、项目名称和应用程序模式类型。将在当前目录中创建项目。 + +要在当前项目目录中创建新项目并将服务与其关联，请运行以下命令： + +``` +bx dev create +``` +{: codeblock} + + +### Debug +{: #debug} + +您可以通过 `debug` 命令调试应用程序。通过将 `build-cmd-debug` 配置元素用作构建指令，先针对项目完成构建。然后，容器开始公开 `container-port-map-debug` 中定义的调试端口。将偏好的调试工具连接到端口，可照常调试应用程序。 + +**限制：**：目前 Swift 项目不可用于调试。 + +在当前项目目录中运行以下命令以调试应用程序： + +``` +bx dev debug +``` +{: codeblock} + +要退出调试会话，请使用 `CTRL-C`。 + + +#### Debug 命令参数 +{: #debug-parameters} + +以下参数专用于 `debug` 命令，可帮助调试应用程序。 + +##### `container-port-map-debug` +{: #port-map-debug} + +* 调试端口的端口映射。第一个值为要在主机操作系统中使用的端口，第二个值为容器中的端口 (host:container)。 +* 用法：`bx dev debug container-port-map-debug [7777:7777]` + +##### `build-cmd-debug` +{: #build-cmd-debug} + +* 用于为 DEBUG 构建代码。 +* 用法：`bx dev debug build-cmd-debug build.command.sh` + +##### `debug-cmd` +{: #debug-cmd} + +* 用于在工具容器中调试代码。如果 `build-cmd-debug` 将以调试方式启动应用程序，那么这是可选的。 +* 用法：`bx dev debug debug-cmd /the/debug/command` + +#### 本地应用程序调试： +{: #local-app-dev} + +有关本地应用程序调试的更多信息，请参阅[本地应用程序调试](docs/cloudnative/dev_cli_local_debug.html#local-debug)。 + + +### Delete +{: #delete} + +此命令用于从 {{site.data.keyword.Bluemix}} 空间除去项目。 + +运行以下命令可从 {{site.data.keyword.Bluemix}} 删除项目： + +``` +bx dev delete +``` +{: codeblock} + + +**注** **不会**除去 {{site.data.keyword.Bluemix}} 服务。 + + +### Help +{: #help} + +缺省情况下，如果未传入任何操作或自变量，或者，如果提供了“help”操作，那么此命令会显示常规“帮助”文本。显示的常规帮助包含基本自变量的描述以及可用操作的列表。 + +运行以下命令以显示常规帮助信息： + +``` +bx dev help +``` +{: codeblock} + + +### 列表 +{: #list} + +您可以列出空间中所有 {{site.data.keyword.Bluemix_notm}} 项目。 + +运行以下命令以列出项目： + +``` +bx dev list +``` +{: codeblock} + + + + + +### Run +{: #run} + +您可以通过 `run` 命令运行应用程序。通过将 `build-cmd-run` 配置元素用作构建指令，先针对项目完成构建。然后，会启动运行容器，并公开 `container-port-map` 中定义的端口。如果运行容器不包含完成此步骤的入口点，那么可以使用 `run-cmd` 调用应用程序。 + +在当前项目目录中运行以下命令以启动应用程序： + +``` +bx dev run +``` +{: codeblock} + +要退出会话，请使用 `CTRL-C`。 + + +#### 运行参数 +{: #run-parameters} + +以下参数专用于 `run` 命令，可帮助管理运行容器中的应用程序。 + +##### `container-name-run` +{: #container-name-run} + +* 运行容器的容器名称。 +* 用法：`bx dev run container-name-run ` + +##### `container-path-run` +{: #container-path-run} + +* 容器中要在运行时共享的位置。 +* 用法：`bx dev run container-path-run [/path/to/app]` + +##### `host-path-run` +{: #host-path-run} + +* 容器中要针对运行共享的主机系统上的位置。 +* 用法：`bx dev run host-path-run [/path/to/app/bin]` + +##### `dockerfile-run` +{: #dockerfile-run} + +* 运行容器的 Docker 文件。 +* 用法：`bx dev run dockerfile-run [/path/to/Dockerfile.yml]` + +##### `image-name-run` +{: #image-name-run} + +* 要从 dockerfile-run 创建的映像。 +* 用法：`bx dev run image-name-run [/path/to/image-name]` + +##### `run-cmd` +{: #run-cmd} + +* 用于在运行容器中运行代码的可选参数。如果您的映像将启动应用程序，那么这是可选的。 +* 用法：`bx dev run run-cmd [/the/run/command]` + +### Status +{: #status} + +您可以查询 `container-name-run` 和 `container-name-tools` 所定义的 {{site.data.keyword.dev_cli_short}} 使用的容器的状态。 + +在当前项目目录中运行以下命令以检查容器状态： + +``` +bx dev status +``` +{: codeblock} + + +[Status 命令参数](#command-parameters) + + +### Stop +{: #stop} + +您可以通过 `stop` 命令停止容器。使用 `container-name` 参数可指定要停止的容器。如果未指定此参数，那么 stop 命令将停止 `container-name-run` 所定义的运行容器。 + +在当前项目目录中运行以下命令以停止容器： + +``` +bx dev stop +``` +{: codeblock} + + +#### 其他 stop 参数： +{: #stop-parameter} + +##### `container-name` +{: #container-name} + +* 工具容器的容器名称。 +* 用法：`bx dev stop container-name ` + +### Test +{: #test} + +您可以通过 `test` 命令测试应用程序。通过将 `build-cmd-run` 配置元素用作构建指令，先针对项目完成构建。然后，使用工具容器针对应用程序调用 `test-cmd`。 + +运行以下命令以测试应用程序： + +``` +bx dev test +``` +{: codeblock} + + +[Test 命令参数](#command-parameters) + + +## Build、debug、run 和 test 的参数 +{: #command-parameters} + +既可以将以下参数与 `build|debug|run|test` 命令配合使用，也可以通过命令行和/或直接更新项目的 `cli-config.yml` 文件来指定这些参数。其他参数可用于 [`debug`](#debug-parameters) 和 [`run`](#run-parameters) 命令，并且会记录在其各自的部分中。 + +**注**：在命令行上输入的命令参数优先于 `cli-config.yml` 配置。 + +##### `container-name-tools` +{: #container-name-tools} + +* 工具容器的容器名称。 +* 用法：`bx dev container-name-tools []` + +##### `host-path-tools` +{: #host-path-tools} + +* 主机上要针对 build、debug 和 test 共享的位置。 +* 用法：`bx dev host-path-tools [/path/to/build/tools]` + +##### `container-path-tools` +{: #container-path-tools} + +* 容器中要针对 build、debug 和 test 共享的位置。 +* 用法：`bx dev container-path-tools [/path/for/build]` + +##### `container-port-map` +{: #container-port-map} + +* 容器的端口映射。第一个值为要在主机操作系统中使用的端口，第二个值为容器中的端口 (host:container)。 +* 用法：`bx dev container-port-map [8090:8090,9090,9090]` + +##### `dockerfile-tools` +{: #dockerfile-tools} + +* 工具容器的 Docker 文件。 +* 用法：`bx dev dockerfile-tools [path/to/dockerfile]` + +##### `image-name-tools` +{: #image-name-tools} + +* 要从 dockerfile-tools 创建的映像。 +* 用法：`bx dev image-name-tools [path/to/image-name]` + +##### `build-cmd-run` +{: #build-cmd-run} + +* 用于针对除 DEBUG 之外的所有用法构建代码的命令。 +* 用法：`bx dev build-cmd-run [some.build.command]` + +##### `test-cmd` +{: #test-cmd} + +* 用于在工具容器中测试代码的命令。 +* 用法：`bx dev test-cmd [/the/test/command]` + diff --git a/cloudnative/nl/zh/CN/dev_cli_local_debug.md b/cloudnative/nl/zh/CN/dev_cli_local_debug.md index 8885c6bd7..97f341f2c 100644 --- a/cloudnative/nl/zh/CN/dev_cli_local_debug.md +++ b/cloudnative/nl/zh/CN/dev_cli_local_debug.md @@ -1,76 +1,76 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 本地应用程序调试 -{: #local-debug} - -下面提供了下列语言的本地应用程序调试指示信息： - -* [Java](#java) -* [Node.js](#node) - -**注**：当前不支持 Swift 应用程序调试。 - -## Java 应用程序调试 -{: #java} - -启用 Java 应用程序调试的步骤： - -1. 从应用程序项目的根目录运行以下命令： - - `bx dev debug` - -2. 将调试器连接到应用程序： - - * [Eclipse ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) - * [IntelliJ ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) - * [VSCode ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) - * JDK 命令行：`jdb -attach ` - -## Node.js 应用程序调试 - -{: #node} - -启用 Node.js 应用程序调试的步骤： - -1. 从应用程序项目的根目录运行以下命令： - - `bx dev debug` - -2. 将调试器连接到应用程序： - * [VSCode ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://blog.docker.com/2016/07/live-debugging-docker/)。 - * [WebStorm ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 本地应用程序调试 +{: #local-debug} + +下面提供了下列语言的本地应用程序调试指示信息： + +* [Java](#java) +* [Node.js](#node) + +**注**：当前不支持 Swift 应用程序调试。 + +## Java 应用程序调试 +{: #java} + +启用 Java 应用程序调试的步骤： + +1. 从应用程序项目的根目录运行以下命令： + + `bx dev debug` + +2. 将调试器连接到应用程序： + + * [Eclipse ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) + * [IntelliJ ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) + * [VSCode ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) + * JDK 命令行：`jdb -attach ` + +## Node.js 应用程序调试 + +{: #node} + +启用 Node.js 应用程序调试的步骤： + +1. 从应用程序项目的根目录运行以下命令： + + `bx dev debug` + +2. 将调试器连接到应用程序： + * [VSCode ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://blog.docker.com/2016/07/live-debugging-docker/)。 + * [WebStorm ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) + + + + + diff --git a/cloudnative/nl/zh/CN/devex.md b/cloudnative/nl/zh/CN/devex.md index 58721dd52..9e9c388a6 100644 --- a/cloudnative/nl/zh/CN/devex.md +++ b/cloudnative/nl/zh/CN/devex.md @@ -1,31 +1,31 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.dev_console}} -{: #devex} - -要开始使用 [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://console.{DomainName}/developer/getting-started)，请从 {{site.data.keyword.Bluemix_notm}} 控制台单击 **Web 和移动**类别。 - - -## 入门 -{: getting-started} - -通过单击**创建项目**，在**入门**页面上创建项目。将显示[模式](patterns.html)、[入门模板](starters.html)和[语言](patterns.html#languages)选项，通过这些选项，您可以快速创建应用程序。 - -通过选择[项目 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://console.{DomainName}/developer/projects) 页面，可以在一个位置中查看和管理所有项目。项目会保留已经（和可以）与应用程序相集成的所有功能的信息。如果项目可用，您就可以在项目中轻松地集成和管理推送、分析、认证以及数据服务，而且在不久的将来还会推出更多功能。 - -[服务](services.html)页面显示现有服务实例的操作视图。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 支持云本机开发者和云本机应用程序管理用户。 - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.dev_console}} +{: #devex} + +要开始使用 [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://console.{DomainName}/developer/getting-started)，请从 {{site.data.keyword.Bluemix_notm}} 控制台单击 **Web 和移动**类别。 + + +## 入门 +{: getting-started} + +通过单击**创建项目**，在**入门**页面上创建项目。将显示[模式](patterns.html)、[入门模板](starters.html)和[语言](patterns.html#languages)选项，通过这些选项，您可以快速创建应用程序。 + +通过选择[项目 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://console.{DomainName}/developer/projects) 页面，可以在一个位置中查看和管理所有项目。项目会保留已经（和可以）与应用程序相集成的所有功能的信息。如果项目可用，您就可以在项目中轻松地集成和管理推送、分析、认证以及数据服务，而且在不久的将来还会推出更多功能。 + +[服务](services.html)页面显示现有服务实例的操作视图。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 支持云本机开发者和云本机应用程序管理用户。 + + + diff --git a/cloudnative/nl/zh/CN/get_code.md b/cloudnative/nl/zh/CN/get_code.md index a2a8e862f..ce0768084 100644 --- a/cloudnative/nl/zh/CN/get_code.md +++ b/cloudnative/nl/zh/CN/get_code.md @@ -1,80 +1,80 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-18" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# 获取代码 -{: #Get_Code} - -当您使用所选功能完成项目的配置和设置时，您可以下载支持运行的代码。您所下载的项目已使用您所配置的每一个功能所需的 SDK 依赖关系和凭证进行了预配置。 - -对于无法在已下载项目中配置的服务，您需要完成凭证。入门模板项目的 `README.md` 文件包含指示信息。请在 Markdown 查看器中查看 `README.md` 文件，以完成设置。 - -## 必备开发者工具 -{: #prereq-dev-tools} - -当您从 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 使用生成的代码时，需要下列开发者工具： - - -### 常规 -{: #general notoc} - -* [Homebrew ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://brew.sh/) - * 命令行工具，用于帮助安装其他工具和运行时，如 CocoaPods 和 Carthage（对于 Apple 开发者）。 - -* [Docker ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.docker.com/get-docker) - * 开放式源代码项目，用于帮助运行和调试容器中的应用程序。只有非移动项目需要它。 - -### {{site.data.keyword.Bluemix_notm}} -{: #bluemix notoc} - -* Node.js（Node 和 npm 运行时），用于帮助运行 {{site.data.keyword.apiconnect_short}} Lopback 和其他 {{site.data.keyword.Bluemix_notm}} Productivity 工具。 - - 要在本地运行 {{site.data.keyword.apiconnect_short}} 工具，请使用 Node 5.x： - - ``` - $ brew install Node5 - ``` - -* [Bluemix CLI 工具 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://clis.ng.bluemix.net/ui/home.html) - - 命令行工具，用于使用 {{site.data.keyword.Bluemix_notm}} 从命令行界面部署 Cloud Foundry 运行时。 - -* [{{site.data.keyword.dev_cli_notm}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](dev_cli.html) - - {{site.data.keyword.Bluemix_notm}} CLI 插件，用于创建、运行、测试和部署 Web 和移动项目。 - -* [SDK Generator 插件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](sdk_cli.html) - - {{site.data.keyword.Bluemix_notm}} CLI 插件，用于从符合[开放 API 规范 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.openapis.org/) 的 REST API 定义中生成 SDK。 - -### Android -{: #android notoc} - -* [Android Studio 2.2 或更高版本 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://developer.android.com/studio) - * 安装最新的 [Android 7.0 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.android.com/versions/nougat-7-0/) 运行时。 - -### iOS -{: #ios notoc} - -* [Xcode 8 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com/xcode/)（建议） - - -* [CocoaPods ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://cocoapods.org/) 依赖关系管理器，用于安装 iOS SDK 依赖关系。请使用最新的版本： - - ``` - $ sudo gem install cocoapods --pre - ``` -* [Carthage ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/Carthage/Carthage) 依赖关系管理器，用于安装 {{site.data.keyword.watson}} Developer Cloud SDK。 - - ``` - $ brew install carthage - ``` +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-18" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# 获取代码 +{: #Get_Code} + +当您使用所选功能完成项目的配置和设置时，您可以下载支持运行的代码。您所下载的项目已使用您所配置的每一个功能所需的 SDK 依赖关系和凭证进行了预配置。 + +对于无法在已下载项目中配置的服务，您需要完成凭证。入门模板项目的 `README.md` 文件包含指示信息。请在 Markdown 查看器中查看 `README.md` 文件，以完成设置。 + +## 必备开发者工具 +{: #prereq-dev-tools} + +当您从 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 使用生成的代码时，需要下列开发者工具： + + +### 常规 +{: #general notoc} + +* [Homebrew ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://brew.sh/) + * 命令行工具，用于帮助安装其他工具和运行时，如 CocoaPods 和 Carthage（对于 Apple 开发者）。 + +* [Docker ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.docker.com/get-docker) + * 开放式源代码项目，用于帮助运行和调试容器中的应用程序。只有非移动项目需要它。 + +### {{site.data.keyword.Bluemix_notm}} +{: #bluemix notoc} + +* Node.js（Node 和 npm 运行时），用于帮助运行 {{site.data.keyword.apiconnect_short}} Lopback 和其他 {{site.data.keyword.Bluemix_notm}} Productivity 工具。 + + 要在本地运行 {{site.data.keyword.apiconnect_short}} 工具，请使用 Node 5.x： + + ``` + $ brew install Node5 + ``` + +* [Bluemix CLI 工具 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://clis.ng.bluemix.net/ui/home.html) + + 命令行工具，用于使用 {{site.data.keyword.Bluemix_notm}} 从命令行界面部署 Cloud Foundry 运行时。 + +* [{{site.data.keyword.dev_cli_notm}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](dev_cli.html) + + {{site.data.keyword.Bluemix_notm}} CLI 插件，用于创建、运行、测试和部署 Web 和移动项目。 + +* [SDK Generator 插件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](sdk_cli.html) + + {{site.data.keyword.Bluemix_notm}} CLI 插件，用于从符合[开放 API 规范 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.openapis.org/) 的 REST API 定义中生成 SDK。 + +### Android +{: #android notoc} + +* [Android Studio 2.2 或更高版本 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://developer.android.com/studio) + * 安装最新的 [Android 7.0 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.android.com/versions/nougat-7-0/) 运行时。 + +### iOS +{: #ios notoc} + +* [Xcode 8 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com/xcode/)（建议） + + +* [CocoaPods ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://cocoapods.org/) 依赖关系管理器，用于安装 iOS SDK 依赖关系。请使用最新的版本： + + ``` + $ sudo gem install cocoapods --pre + ``` +* [Carthage ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/Carthage/Carthage) 依赖关系管理器，用于安装 {{site.data.keyword.watson}} Developer Cloud SDK。 + + ``` + $ brew install carthage + ``` diff --git a/cloudnative/nl/zh/CN/index.md b/cloudnative/nl/zh/CN/index.md index 1c85f6944..259f9f51b 100644 --- a/cloudnative/nl/zh/CN/index.md +++ b/cloudnative/nl/zh/CN/index.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2016-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 构建云本机项目 -{: #web-mobile} - -您可以通过 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} [项目](projects.html)的概念来管理云本机应用程序。您可以通过使用 [{{site.data.keyword.dev_console}}](devex.html) 或使用适用于 {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI 的 [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) 来创建项目。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 将云本机应用程序开发者所需的最常用服务集中到单一位置，为开发者提供优化的连接体验。 - -通过 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}，云本机应用程序开发者可以利用 SDK，从各种[模式类型](patterns.html)和[入门模板](starters.html)创建项目、创建关键 {{site.data.keyword.Bluemix_notm}} 优化服务并将其连接到项目，以及快速下载工作代码。SDK 完全与功能凭证或依赖关系相集成，使您能够几分钟内就让其运行起来。当应用程序处于运行状态时，如果已经设置并配置了功能，那么您可以返回到项目，监视并管理应用程序用户的参与情况。还可以通过 {{site.data.keyword.dev_console}} 配置和管理服务。 - - - - - - -# 相关链接 -{: #rellinks notoc} - -## 教程和样本 -{: #samples notoc} - -* [样本：Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} -* [视频教程](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2016-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 构建云本机项目 +{: #web-mobile} + +您可以通过 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} [项目](projects.html)的概念来管理云本机应用程序。您可以通过使用 [{{site.data.keyword.dev_console}}](devex.html) 或使用适用于 {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI 的 [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) 来创建项目。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 将云本机应用程序开发者所需的最常用服务集中到单一位置，为开发者提供优化的连接体验。 + +通过 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}，云本机应用程序开发者可以利用 SDK，从各种[模式类型](patterns.html)和[入门模板](starters.html)创建项目、创建关键 {{site.data.keyword.Bluemix_notm}} 优化服务并将其连接到项目，以及快速下载工作代码。SDK 完全与功能凭证或依赖关系相集成，使您能够几分钟内就让其运行起来。当应用程序处于运行状态时，如果已经设置并配置了功能，那么您可以返回到项目，监视并管理应用程序用户的参与情况。还可以通过 {{site.data.keyword.dev_console}} 配置和管理服务。 + + + + + + +# 相关链接 +{: #rellinks notoc} + +## 教程和样本 +{: #samples notoc} + +* [样本：Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} +* [视频教程](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} diff --git a/cloudnative/nl/zh/CN/patterns.md b/cloudnative/nl/zh/CN/patterns.md index 4563d6743..59c7ae524 100644 --- a/cloudnative/nl/zh/CN/patterns.md +++ b/cloudnative/nl/zh/CN/patterns.md @@ -1,99 +1,99 @@ - ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 模式类型 -{: #patterns} - -云本机模式的设计经过验证，有助于确保实现具有一致性、可扩展性和可靠性的应用程序拓扑。创建项目时，为您提供了各种模式类型，供您选择。只需选择要合并到项目中的模式类型和功能即可。定义项目首选项后，将为您生成入门模板项目，以编辑、运行或调试以及在本地部署或部署到 {{site.data.keyword.Bluemix}}。 - -## Web 应用程序 -{: #web} - -Web 项目添加了新功能，可为 Web 服务器处理诸如 HTML、JavaScript 和样式表等 Web 内容。 - -提供了以下 Web 入门模板： - -* 基本 Web：处理静态 `index.html` 文件、缺省和空样式表以及 JavaScript 文件。 -* Webpack：创建项目，在此项目中，ECMAScript 6 (ES6) 源文件位于 `src/client` 中且使用 WebPack 进行编译以实现合并压缩和转换，以便在浏览器中使用。 -* Webpack + React：用于构建用户接口的富框架。源文件位于 `src/client/app` 中，且使用 WebPack 进行编译并在公共目录中处理。 - - -## 移动应用程序 -{: #mobile} - -移动应用程序模式可帮助您构建移动应用程序，这些应用程序直接连接到后端服务，例如 {{site.data.keyword.mobilepushshort}}、{{site.data.keyword.mobileanalytics_short}} 和 {{site.data.keyword.appid_short}} 等。还可以通过 sdkGen（例如 BFF 和微服务）添加项目。 - -可以从入门模板列表中进行选择（例如，{{site.data.keyword.watson}} Conversation、{{site.data.keyword.visualrecognitionshort}} 和 {{site.data.keyword.openwhisk_short}} 等）。 - -您可以在 Swift、Android 或 Cordova 中生成移动应用程序。 - - -## 服务于前端的后端 (BFF) -{: #bff} - -服务于前端的后端模式通常称为 BFF，让您可以重点关注公开业务数据和服务的方式要能够满足用户的交互需求。要优化云解决方案的用户旅程，可能需要对移动应用程序具有不同的用户旅程，而对 Web 应用程序具有更丰富、更详细的旅程。随着语音控制设备（如 [{{site.data.keyword.conversationfull}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.ibm.com/watson/developercloud/conversation.html) 服务）的引入，与用户的交互可以是由语音控制。这个数字通道需要截然不同的 BFF，以管理这些基于语音意图的交互。 - -有了 {{site.data.keyword.Bluemix_notm}}，可以通过使用混合编程方法来定义 BFF，从而构建 BFF。IBM 建议使用 Node.js、Swift 或 Java，以具有 Cloud Foundry、Container 服务或无服务器的方式，在云本机模式下运行。 - -BFF 将管理与数据持久性、高速缓存等服务的集成，与高价值服务（如 {{site.data.keyword.ibmwatson}}、{{site.data.keyword.iot_short_notm}}、{{site.data.keyword.weather_short}}）的集成，以及数据分析（如 {{site.data.keyword.sparks}}）。 - -BFF 将公开最常使用 REST 模式的 API，但是您可以使用 {{site.data.keyword.messagehub}} 来设计 BFF 以通过消息传递体系结构进行工作。 - -BFF 基本入门模板通过使用 Node.js 或 Swift 提供。 - - -## 微服务 -{: #microservice} - -微服务项目为构建后端微服务（包括基本运行状况端点这一 REST API）提供基础。生成的项目将包含微服务本身以及所有相关云服务所需的所有依赖关系。 - -微服务基本入门模板通过使用 Java 提供。 - - - - -## 语言 -{: #languages notoc} - -以下为受支持的语言： - - * [Java ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](../runtimes/liberty/getting-started.html){: new_window} - * [Node.js ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](../runtimes/nodejs/getting-started.html){: new_window} - * [Swift ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](../runtimes/swift/getting-started.html){: new_window} - - -### Java -{: #java notoc} - -Java 具有强大的功能，用于构建企业级应用程序。同时，Java 8 中提供的新功能以及较轻量级运行时（例如，Liberty）和框架（例如，Spring Boot）使 Java 也非常适合构建微服务。 - - -### Node.js -{: #node notoc} - -Node.js 是使用事件驱动的非阻塞 I/O 模型的 JavaScript 运行时，使其轻量且高效，为 Web 应用程序、服务于前端的后端模式和微服务实现强大吞吐量和可扩展性。Node.js 的软件包生态系统 npm 提供了对大量开放式源代码模块的访问，同时提供很多功能以加速应用程序开发。 - - -### Swift -{: #swift notoc} - -Swift 是 Apple 在 2014 年开发的一种现代编程语言，旨在替换 Objective C，于 2015 年 12 月成为开放式源代码语言。目前，此编程语言用于使用 x86、ARM 或 Z 体系结构在 Linux 和 macOS 操作系统上构建 iOS、macOS、Web Service 和系统软件。此语言编写方式类似脚本语言，但编译后可获得与 C 语言类似的高性能和低开销，适合云运行时。它使用 Java 中所使用的强大和静态类型系统，以及 JavaScript 中所使用的功能样式和异步例程。此语言具有高性能，源代码使用 LLVM 编译器工具链编译为本机代码，且可轻松利用使用 C 语言编写的外部系统库。 + +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 模式类型 +{: #patterns} + +云本机模式的设计经过验证，有助于确保实现具有一致性、可扩展性和可靠性的应用程序拓扑。创建项目时，为您提供了各种模式类型，供您选择。只需选择要合并到项目中的模式类型和功能即可。定义项目首选项后，将为您生成入门模板项目，以编辑、运行或调试以及在本地部署或部署到 {{site.data.keyword.Bluemix}}。 + +## Web 应用程序 +{: #web} + +Web 项目添加了新功能，可为 Web 服务器处理诸如 HTML、JavaScript 和样式表等 Web 内容。 + +提供了以下 Web 入门模板： + +* 基本 Web：处理静态 `index.html` 文件、缺省和空样式表以及 JavaScript 文件。 +* Webpack：创建项目，在此项目中，ECMAScript 6 (ES6) 源文件位于 `src/client` 中且使用 WebPack 进行编译以实现合并压缩和转换，以便在浏览器中使用。 +* Webpack + React：用于构建用户接口的富框架。源文件位于 `src/client/app` 中，且使用 WebPack 进行编译并在公共目录中处理。 + + +## 移动应用程序 +{: #mobile} + +移动应用程序模式可帮助您构建移动应用程序，这些应用程序直接连接到后端服务，例如 {{site.data.keyword.mobilepushshort}}、{{site.data.keyword.mobileanalytics_short}} 和 {{site.data.keyword.appid_short}} 等。还可以通过 sdkGen（例如 BFF 和微服务）添加项目。 + +可以从入门模板列表中进行选择（例如，{{site.data.keyword.watson}} Conversation、{{site.data.keyword.visualrecognitionshort}} 和 {{site.data.keyword.openwhisk_short}} 等）。 + +您可以在 Swift、Android 或 Cordova 中生成移动应用程序。 + + +## 服务于前端的后端 (BFF) +{: #bff} + +服务于前端的后端模式通常称为 BFF，让您可以重点关注公开业务数据和服务的方式要能够满足用户的交互需求。要优化云解决方案的用户旅程，可能需要对移动应用程序具有不同的用户旅程，而对 Web 应用程序具有更丰富、更详细的旅程。随着语音控制设备（如 [{{site.data.keyword.conversationfull}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.ibm.com/watson/developercloud/conversation.html) 服务）的引入，与用户的交互可以是由语音控制。这个数字通道需要截然不同的 BFF，以管理这些基于语音意图的交互。 + +有了 {{site.data.keyword.Bluemix_notm}}，可以通过使用混合编程方法来定义 BFF，从而构建 BFF。IBM 建议使用 Node.js、Swift 或 Java，以具有 Cloud Foundry、Container 服务或无服务器的方式，在云本机模式下运行。 + +BFF 将管理与数据持久性、高速缓存等服务的集成，与高价值服务（如 {{site.data.keyword.ibmwatson}}、{{site.data.keyword.iot_short_notm}}、{{site.data.keyword.weather_short}}）的集成，以及数据分析（如 {{site.data.keyword.sparks}}）。 + +BFF 将公开最常使用 REST 模式的 API，但是您可以使用 {{site.data.keyword.messagehub}} 来设计 BFF 以通过消息传递体系结构进行工作。 + +BFF 基本入门模板通过使用 Node.js 或 Swift 提供。 + + +## 微服务 +{: #microservice} + +微服务项目为构建后端微服务（包括基本运行状况端点这一 REST API）提供基础。生成的项目将包含微服务本身以及所有相关云服务所需的所有依赖关系。 + +微服务基本入门模板通过使用 Java 提供。 + + + + +## 语言 +{: #languages notoc} + +以下为受支持的语言： + + * [Java ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](../runtimes/liberty/getting-started.html){: new_window} + * [Node.js ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](../runtimes/nodejs/getting-started.html){: new_window} + * [Swift ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](../runtimes/swift/getting-started.html){: new_window} + + +### Java +{: #java notoc} + +Java 具有强大的功能，用于构建企业级应用程序。同时，Java 8 中提供的新功能以及较轻量级运行时（例如，Liberty）和框架（例如，Spring Boot）使 Java 也非常适合构建微服务。 + + +### Node.js +{: #node notoc} + +Node.js 是使用事件驱动的非阻塞 I/O 模型的 JavaScript 运行时，使其轻量且高效，为 Web 应用程序、服务于前端的后端模式和微服务实现强大吞吐量和可扩展性。Node.js 的软件包生态系统 npm 提供了对大量开放式源代码模块的访问，同时提供很多功能以加速应用程序开发。 + + +### Swift +{: #swift notoc} + +Swift 是 Apple 在 2014 年开发的一种现代编程语言，旨在替换 Objective C，于 2015 年 12 月成为开放式源代码语言。目前，此编程语言用于使用 x86、ARM 或 Z 体系结构在 Linux 和 macOS 操作系统上构建 iOS、macOS、Web Service 和系统软件。此语言编写方式类似脚本语言，但编译后可获得与 C 语言类似的高性能和低开销，适合云运行时。它使用 Java 中所使用的强大和静态类型系统，以及 JavaScript 中所使用的功能样式和异步例程。此语言具有高性能，源代码使用 LLVM 编译器工具链编译为本机代码，且可轻松利用使用 C 语言编写的外部系统库。 diff --git a/cloudnative/nl/zh/CN/projects.md b/cloudnative/nl/zh/CN/projects.md index 1c234d010..b02603701 100644 --- a/cloudnative/nl/zh/CN/projects.md +++ b/cloudnative/nl/zh/CN/projects.md @@ -1,57 +1,57 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 项目 -{: #projects} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 将应用程序用户界面、数据和服务结合到完整的*项目*中。通过创建项目，您应用程序所需的所有组件和已添加的功能会保留在 {{site.data.keyword.Bluemix_notm}} 服务器上。如果在项目中配置了这些服务，那么可以下载应用程序代码以及所需凭证和初始化程序。您可以通过选择**项目**来查看所有项目。 - -您可以通过在**项目**页面上选择单个项目，查看该项目的其他信息。这将显示**项目概述**页面，其中包含已配置并可用于项目的服务。服务是不同的功能，可通过添加函数来扩展您的应用程序。由于服务是单独添加的，因此您可以添加所需服务，如推送、认证、数据和存储服务以及其他服务。向**项目概述**页面上的项目添加服务并遵循指示信息对其进行配置后，该服务会自动与应用程序相关联。有关“项目概述”页面的更多信息，请参阅[项目概述页面](project_overview_page.html)。 - -要创建项目，必须选择[模式](patterns.html)，后跟[入门模板](starters.html)。 - - -## 项目概述页面 -{: #project_overview} - -通过在**项目**页面上选择项目，打开“项目概述”页面，可以查看和使用单个 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 项目。 -{: shortdesc} - -**项目概述**页面显示已使用所选项目配置的或可使用该项目配置的每个功能的磁贴。磁贴显示功能的类型以及有三个垂直对齐点的*操作*按钮。可能可用或已配置的功能示例包括 {{site.data.keyword.mobilepushshort}}、分析或数据和存储。哪些功能可兼容取决于项目的类型以及在该区域可以使用哪些功能，因此并非所有服务都可以与所有项目相关联。 - -当某个功能类型尚未与项目相关联时，磁贴上会显示**创建**按钮。操作按钮选项用于创建服务的实例，或者在未关联功能时添加现有服务实例。选择**添加现有项**可提供空间中该类型的服务实例列表。 - -如果功能已经与此项目相关联，那么相关联的服务实例的名称会显示在该功能类型后面的磁贴上。这样就能在 {{site.data.keyword.dev_console}} 上轻松查找哪个服务实例与此项目相关。当功能已经与项目相关联时，操作按钮上可用的操作是**查看**和**除去**。除去服务实例仅会除去与此项目的关联，而不会从 {{site.data.keyword.dev_console}} 删除该服务实例。要删除服务实例，请单击 **Web 和移动 > 服务**页面，以查看和删除服务实例。 - -在**代码**磁贴上选择**获取代码**，以下载项目的代码。有关下载代码的更多信息，请参阅[获取代码](get_code.html)。 - - -## 更新项目以使用新的入门模板 -{: #update-starter} - -1. 从**项目**或**项目概述**页面，单击**溢出菜单**图标并选择**更新入门模板**。 - -2. 选择新的入门模板并单击**更新**。 - -3. 单击**项目概述**页面上的**获取代码**，以选择语言。 - - 或者，您可以在**代码**页面上单击。 - - -## 更新项目以生成新的语言 -{: #update-language} - -1. 从**项目**或**项目概述**页面，单击**溢出菜单**图标并选择**更新入门模板**。 - -2. 选择新的语言并单击**更新**。 - -3. 单击**项目概述**页面上的**获取代码**，以选择语言。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 项目 +{: #projects} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 将应用程序用户界面、数据和服务结合到完整的*项目*中。通过创建项目，您应用程序所需的所有组件和已添加的功能会保留在 {{site.data.keyword.Bluemix_notm}} 服务器上。如果在项目中配置了这些服务，那么可以下载应用程序代码以及所需凭证和初始化程序。您可以通过选择**项目**来查看所有项目。 + +您可以通过在**项目**页面上选择单个项目，查看该项目的其他信息。这将显示**项目概述**页面，其中包含已配置并可用于项目的服务。服务是不同的功能，可通过添加函数来扩展您的应用程序。由于服务是单独添加的，因此您可以添加所需服务，如推送、认证、数据和存储服务以及其他服务。向**项目概述**页面上的项目添加服务并遵循指示信息对其进行配置后，该服务会自动与应用程序相关联。有关“项目概述”页面的更多信息，请参阅[项目概述页面](project_overview_page.html)。 + +要创建项目，必须选择[模式](patterns.html)，后跟[入门模板](starters.html)。 + + +## 项目概述页面 +{: #project_overview} + +通过在**项目**页面上选择项目，打开“项目概述”页面，可以查看和使用单个 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 项目。 +{: shortdesc} + +**项目概述**页面显示已使用所选项目配置的或可使用该项目配置的每个功能的磁贴。磁贴显示功能的类型以及有三个垂直对齐点的*操作*按钮。可能可用或已配置的功能示例包括 {{site.data.keyword.mobilepushshort}}、分析或数据和存储。哪些功能可兼容取决于项目的类型以及在该区域可以使用哪些功能，因此并非所有服务都可以与所有项目相关联。 + +当某个功能类型尚未与项目相关联时，磁贴上会显示**创建**按钮。操作按钮选项用于创建服务的实例，或者在未关联功能时添加现有服务实例。选择**添加现有项**可提供空间中该类型的服务实例列表。 + +如果功能已经与此项目相关联，那么相关联的服务实例的名称会显示在该功能类型后面的磁贴上。这样就能在 {{site.data.keyword.dev_console}} 上轻松查找哪个服务实例与此项目相关。当功能已经与项目相关联时，操作按钮上可用的操作是**查看**和**除去**。除去服务实例仅会除去与此项目的关联，而不会从 {{site.data.keyword.dev_console}} 删除该服务实例。要删除服务实例，请单击 **Web 和移动 > 服务**页面，以查看和删除服务实例。 + +在**代码**磁贴上选择**获取代码**，以下载项目的代码。有关下载代码的更多信息，请参阅[获取代码](get_code.html)。 + + +## 更新项目以使用新的入门模板 +{: #update-starter} + +1. 从**项目**或**项目概述**页面，单击**溢出菜单**图标并选择**更新入门模板**。 + +2. 选择新的入门模板并单击**更新**。 + +3. 单击**项目概述**页面上的**获取代码**，以选择语言。 + + 或者，您可以在**代码**页面上单击。 + + +## 更新项目以生成新的语言 +{: #update-language} + +1. 从**项目**或**项目概述**页面，单击**溢出菜单**图标并选择**更新入门模板**。 + +2. 选择新的语言并单击**更新**。 + +3. 单击**项目概述**页面上的**获取代码**，以选择语言。 diff --git a/cloudnative/nl/zh/CN/sdk.md b/cloudnative/nl/zh/CN/sdk.md index c230c182c..ac5c48441 100644 --- a/cloudnative/nl/zh/CN/sdk.md +++ b/cloudnative/nl/zh/CN/sdk.md @@ -1,67 +1,67 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-17" - ---- -# SDK -{: #sdk} - -要将 {{site.data.keyword.Bluemix}} Mobile Services SDK 添加到您的应用程序中，请选择要使用的 SDK，然后配置您的依赖关系管理器，以将 SDK 拉入您的应用程序中。 - - -## 客户机 SDK -{: #client_sdk} - -您可以在移动应用程序中使用以下 SDK，来利用各自的功能。 - - -### Android SDK -{: #android_sdk} - -- [核心 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) -- [{{site.data.keyword.mobileanalytics_short}}SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) -- [Facebook 认证 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) -- [Google 认证 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) - - -### iOS SDK -{: #ios_sdk} - -- [核心 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) -- [{{site.data.keyword.mobileanalytics_short}} SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) -- [Facebook 认证 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) -- [Google 认证 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) -- [{{site.data.keyword.amashort}} SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) - - -### Cordova 插件 -{: #cordova_plugin} - -- [核心插件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) -- [{{site.data.keyword.mobilepushshort}} 插件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## 服务器 SDK -{: #server_sdk} - -如果您具有 Java、NodeJS 或 Swift 服务器应用程序，那么您可以使用以下 SDK，以与各自的服务进行通信。 - - -### {{site.data.keyword.mobilepushshort}} 服务器 SDK -{: #push_sdk} - -- [{{site.data.keyword.mobilepushshort}} Java 服务器 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) -- [{{site.data.keyword.mobilepushshort}} Swift 服务器 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) -- [{{site.data.keyword.mobilepushshort}} NodeJS 服务器 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) - - -### {{site.data.keyword.amashort}} 服务器 SDK -{: #mca_sdk} - -- [{{site.data.keyword.amashort}} Swift 服务器 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) - - +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-17" + +--- +# SDK +{: #sdk} + +要将 {{site.data.keyword.Bluemix}} Mobile Services SDK 添加到您的应用程序中，请选择要使用的 SDK，然后配置您的依赖关系管理器，以将 SDK 拉入您的应用程序中。 + + +## 客户机 SDK +{: #client_sdk} + +您可以在移动应用程序中使用以下 SDK，来利用各自的功能。 + + +### Android SDK +{: #android_sdk} + +- [核心 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) +- [{{site.data.keyword.mobileanalytics_short}}SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) +- [Facebook 认证 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) +- [Google 认证 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) + + +### iOS SDK +{: #ios_sdk} + +- [核心 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) +- [{{site.data.keyword.mobileanalytics_short}} SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) +- [Facebook 认证 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) +- [Google 认证 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) +- [{{site.data.keyword.amashort}} SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) + + +### Cordova 插件 +{: #cordova_plugin} + +- [核心插件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) +- [{{site.data.keyword.mobilepushshort}} 插件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## 服务器 SDK +{: #server_sdk} + +如果您具有 Java、NodeJS 或 Swift 服务器应用程序，那么您可以使用以下 SDK，以与各自的服务进行通信。 + + +### {{site.data.keyword.mobilepushshort}} 服务器 SDK +{: #push_sdk} + +- [{{site.data.keyword.mobilepushshort}} Java 服务器 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) +- [{{site.data.keyword.mobilepushshort}} Swift 服务器 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) +- [{{site.data.keyword.mobilepushshort}} NodeJS 服务器 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) + + +### {{site.data.keyword.amashort}} 服务器 SDK +{: #mca_sdk} + +- [{{site.data.keyword.amashort}} Swift 服务器 SDK ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) + + diff --git a/cloudnative/nl/zh/CN/sdk_BMSClient.md b/cloudnative/nl/zh/CN/sdk_BMSClient.md index 22f5187f2..7d2b554b9 100644 --- a/cloudnative/nl/zh/CN/sdk_BMSClient.md +++ b/cloudnative/nl/zh/CN/sdk_BMSClient.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 初始化 BMSClient -{: #sdk_BMSClient} - -`BMSCore` 提供了其他 {{site.data.keyword.Bluemix}} Mobile Services 客户机 SDK 用于与其对应的 {{site.data.keyword.Bluemix_notm}} 服务进行通信的 HTTP 基础架构。 - - -## 初始化 Android 应用程序 -{: #init-BMSClient-android} - -您可以将 `BMSCore` 包下载并导入到 Android Studio 项目，或者使用 Gradle。 - -1. 通过在项目文件开始处添加以下 `import` 语句以导入客户机 SDK。 - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; - ``` - {: codeblock} - -2. 通过在 Android 应用程序中主活动的 `onCreate` 方法中添加初始化代码，或在最适合运行项目的位置中添加初始化代码，以初始化 Android 应用程序中的 `BMSClient` SDK。 - - ```Java - BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region - ``` - {: codeblock} - - 必须使用 **bluemixRegion** 参数来初始化 `BMSClient`。在初始化程序中，**bluemixRegion** 值指定您使用的 {{site.data.keyword.Bluemix_notm}} 部署，例如 `BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK` 或 `BMSClient.REGION_SYDNEY`。 - - -## 初始化 iOS 应用程序 -{: #init-BMSClient-ios} - -可以使用 [CocoaPods](https://cocoapods.org){: new_window} 或 [Carthage](https://github.com/Carthage/Carthage){: new_window} 来获取 `BMSCore` 包。 - -1. 要使用 CocoaPods 安装 `BMSCore`，请将以下行添加到 Podfile。如果项目尚未具有 Podfile，请使用 `pod init` 命令。 - - ```Swift - use_frameworks! - - target 'MyApp' do - pod 'BMSCore' - end - ``` - {: codeblock} - - 然后运行 `pod install` 命令，并打开生成的 `.xcworkspace` 文件。要更新为较新的 `BMSCore` 发行版，请使用 `pod update BMSCore`。 - - 有关使用 CocoaPods 的更多信息，请参阅 [CocoaPods 指南 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://guides.cocoapods.org/using/index.html){: new_window}。 - -2. 要使用 Carthage 安装 `BMSCore`，请遵循以下[指示信息 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/Carthage/Carthage#getting-started){: new_window}。 - - 1. 将以下行添加到 Cartfile： - - ``` - github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" - ``` - {: codeblock} - - 2. 运行 `carthage update` 命令。 - - 3. 构建完成后，通过遵循 Carthage 指示信息中的[第 3 步 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/Carthage/Carthage#getting-started)，将 `BMSCore.framework` 添加到项目。 - - 对于使用 Swift 2.3 构建的应用程序，请使用 `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3` 命令。否则，请使用 `carthage update` 命令。 - -3. 导入模块。 - - ```Swift - import BMSCore - ``` - {: codeblock} - -4. 使用以下代码初始化 `BMSClient` 类。 - - 将初始化代码放入应用程序代表的 `application(_:didFinishLaunchingWithOptions:)` 方法中，或放入最适合运行项目的位置中。 - - ```Swift - BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region - ``` - {: codeblock} - - 必须使用 **bluemixRegion** 参数来初始化 `BMSClient`。在初始化程序中，**bluemixRegion** 值指定您使用的 {{site.data.keyword.Bluemix_notm}} 部署，例如 `BMSClient.Region.usSouth`、`BMSClient.Region.unitedKingdom` 或 `BMSClient.Region.sydney`。 - - -## 初始化 Cordova 应用程序 -{: #init-BMSClient-cordova} - -1. 从 Cordova 应用程序根目录运行以下命令来添加 Cordova 插件： - - ``` - cordova plugin add bms-core - ``` - {: codeblock} - -2. 通过在主 JavaScript 文件中添加初始化代码，或在最适合运行项目的位置中添加初始化代码，以初始化 Cordova 应用程序中的 `BMSClient` 类。 - - ``` - BMSClient.initialize(BMSClient.REGION_US_SOUTH); - ``` - {: codeblock} - - 必须使用 **bluemixRegion** 参数来初始化 `BMSClient`。在初始化程序中，**bluemixRegion** 值指定您使用的 {{site.data.keyword.Bluemix_notm}} 部署，例如 `BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK` 或 `BMSClient.REGION_SYDNEY`。 - - -# 相关链接 -{: #rellinks notoc} - -## 相关链接 -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova 插件](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 初始化 BMSClient +{: #sdk_BMSClient} + +`BMSCore` 提供了其他 {{site.data.keyword.Bluemix}} Mobile Services 客户机 SDK 用于与其对应的 {{site.data.keyword.Bluemix_notm}} 服务进行通信的 HTTP 基础架构。 + + +## 初始化 Android 应用程序 +{: #init-BMSClient-android} + +您可以将 `BMSCore` 包下载并导入到 Android Studio 项目，或者使用 Gradle。 + +1. 通过在项目文件开始处添加以下 `import` 语句以导入客户机 SDK。 + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; + ``` + {: codeblock} + +2. 通过在 Android 应用程序中主活动的 `onCreate` 方法中添加初始化代码，或在最适合运行项目的位置中添加初始化代码，以初始化 Android 应用程序中的 `BMSClient` SDK。 + + ```Java + BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region + ``` + {: codeblock} + + 必须使用 **bluemixRegion** 参数来初始化 `BMSClient`。在初始化程序中，**bluemixRegion** 值指定您使用的 {{site.data.keyword.Bluemix_notm}} 部署，例如 `BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK` 或 `BMSClient.REGION_SYDNEY`。 + + +## 初始化 iOS 应用程序 +{: #init-BMSClient-ios} + +可以使用 [CocoaPods](https://cocoapods.org){: new_window} 或 [Carthage](https://github.com/Carthage/Carthage){: new_window} 来获取 `BMSCore` 包。 + +1. 要使用 CocoaPods 安装 `BMSCore`，请将以下行添加到 Podfile。如果项目尚未具有 Podfile，请使用 `pod init` 命令。 + + ```Swift + use_frameworks! + + target 'MyApp' do + pod 'BMSCore' + end + ``` + {: codeblock} + + 然后运行 `pod install` 命令，并打开生成的 `.xcworkspace` 文件。要更新为较新的 `BMSCore` 发行版，请使用 `pod update BMSCore`。 + + 有关使用 CocoaPods 的更多信息，请参阅 [CocoaPods 指南 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://guides.cocoapods.org/using/index.html){: new_window}。 + +2. 要使用 Carthage 安装 `BMSCore`，请遵循以下[指示信息 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/Carthage/Carthage#getting-started){: new_window}。 + + 1. 将以下行添加到 Cartfile： + + ``` + github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" + ``` + {: codeblock} + + 2. 运行 `carthage update` 命令。 + + 3. 构建完成后，通过遵循 Carthage 指示信息中的[第 3 步 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://github.com/Carthage/Carthage#getting-started)，将 `BMSCore.framework` 添加到项目。 + + 对于使用 Swift 2.3 构建的应用程序，请使用 `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3` 命令。否则，请使用 `carthage update` 命令。 + +3. 导入模块。 + + ```Swift + import BMSCore + ``` + {: codeblock} + +4. 使用以下代码初始化 `BMSClient` 类。 + + 将初始化代码放入应用程序代表的 `application(_:didFinishLaunchingWithOptions:)` 方法中，或放入最适合运行项目的位置中。 + + ```Swift + BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region + ``` + {: codeblock} + + 必须使用 **bluemixRegion** 参数来初始化 `BMSClient`。在初始化程序中，**bluemixRegion** 值指定您使用的 {{site.data.keyword.Bluemix_notm}} 部署，例如 `BMSClient.Region.usSouth`、`BMSClient.Region.unitedKingdom` 或 `BMSClient.Region.sydney`。 + + +## 初始化 Cordova 应用程序 +{: #init-BMSClient-cordova} + +1. 从 Cordova 应用程序根目录运行以下命令来添加 Cordova 插件： + + ``` + cordova plugin add bms-core + ``` + {: codeblock} + +2. 通过在主 JavaScript 文件中添加初始化代码，或在最适合运行项目的位置中添加初始化代码，以初始化 Cordova 应用程序中的 `BMSClient` 类。 + + ``` + BMSClient.initialize(BMSClient.REGION_US_SOUTH); + ``` + {: codeblock} + + 必须使用 **bluemixRegion** 参数来初始化 `BMSClient`。在初始化程序中，**bluemixRegion** 值指定您使用的 {{site.data.keyword.Bluemix_notm}} 部署，例如 `BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK` 或 `BMSClient.REGION_SYDNEY`。 + + +# 相关链接 +{: #rellinks notoc} + +## 相关链接 +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova 插件](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/zh/CN/sdk_cli.md b/cloudnative/nl/zh/CN/sdk_cli.md index ce0262333..eec374249 100644 --- a/cloudnative/nl/zh/CN/sdk_cli.md +++ b/cloudnative/nl/zh/CN/sdk_cli.md @@ -1,178 +1,178 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# SDK Generator 插件 -{: #sdk-cli} - -{{site.data.keyword.IBM}} SDK Generator 插件可安装在 [{{site.data.keyword.Bluemix_notm}} CLI ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/cli/reference/bluemix_cli/index.html) 中。 - -作为 {{site.data.keyword.Bluemix_notm}} 上的开发者，您可以使用此插件，从符合[开放 API 规范 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.openapis.org/) 的 REST API 定义中生成 SDK。当您对 REST API 定义进行更改时，可以使用此插件，仅重新生成 SDK 而非重新生成整个项目。 - -您还可以查看给定空间中的 Cloud Foundry 应用程序是否具有对生成 SDK 有效的 REST API 定义。最后，您可以使用 {{site.data.keyword.IBM_notm}} SDK Generator 插件，来验证任何 REST API 定义，以确保它们符合 SDK 生成器需求。 - -通过此 {{site.data.keyword.IBM_notm}} SDK Generator 插件，您可以轻松地将应用程序的后端服务与所生成的 SDK 相集成。当 REST API 发生更改时，可以重新生成 SDK 并替换旧的 SDK 以进行无缝 SDK 升级。您还可以将 CLI 集成到 DevOps 管道，并确保每次构建应用程序时，SDK 始终与 API 规范保持一致。 - -REST API 定义必须有效，或者在活动服务器端点上托管，或者是您系统上的本地文件。如果托管 REST API 定义，则必须在 `OPENAPI_SPEC` 环境变量中定义相对 URL。 - - -## 需求 -{: #prereqs} - -确保满足以下需求。 - -* 具有 [{{site.data.keyword.Bluemix_notm}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://bluemix.net) 帐户 -* 具有符合[开放 API ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.openapis.org/) 规范的有效 API 定义 - - -## 安装 -{: #installation} - -1. [安装 {{site.data.keyword.Bluemix}} CLI ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://clis.ng.bluemix.net/ui/home.html)。 - -2. [安装插件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in)。 - - ``` - bx plugin install sdk-gen -r Bluemix - ``` - {: codeblock} - - -## 命令 -{: #commands} - -使用以下命令，生成 SDK、验证开放 API 定义文件或列出 Cloud Foundry 应用程序。 - - -### 生成 SDK -{: #gen} - -使用 `bluemix sdk generate [arguments...][command options]`。 - - -#### 自变量 -{: #gen-args} - -* `APP_NAME` - 当前空间中 Cloud Foundry 应用程序的名称 -* `OPENAPI_DOC_LOCATION` - 原始 REST API 定义 JSON 或 Yaml 的 URL 或相对文件路径 -* `GENERATED_SDK_NAME`（可选）- 所生成 SDK 的名称 - - -#### 选项 -{: #gen-options} - -* `PLATFORM`（必要） - * `--android` - 生成 Android SDK - * `--ios` - 生成 iOS Swift SDK - * `--swift` - 生成 Swift 服务器 SDK -* `--output "YOUR_RELATIVE_PATH"`（可选）- 将所生成的 SDK 置于 `YOUR_RELATIVE_PATH` 所指定的目录中（如果存在现有的 SDK 则覆盖） -* `--unzip`（可选）- 解压缩所生成的 SDK（如果存在现有的 SDK 工件则覆盖） - - -#### 用法 -{: #gen-usage} - -要通过在 {{site.data.keyword.Bluemix_notm}} 中运行的 Cloud Foundry 应用程序生成 SDK，可以使用应用程序的名称作为 CLI 的参数。以下命令使用应用程序的名称作为 `SDK_Name`。 - -``` -bluemix sdk generate [APP_NAME] [PLATFORM] -``` -{: codeblock} - -要从开放 API 定义文件或本地 JSON 或 Yaml 文件的 URL 生成 SDK，请使用以下命令。 - -``` -bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] -``` -{: codeblock} - - -### 验证开放 API 定义 -{: #validating} - -使用 `bluemix sdk validate [argument]`。 - - -#### 自变量 -{: #val-args} - -* `APP_NAME` - 当前空间中 Cloud Foundry 应用程序的名称 -* `OPENAPI_DOC_LOCATION` - 原始 REST API 定义 JSON 或 Yaml 的 URL 或相对文件路径 - - -#### 用法 -{: #val-usage} - -要验证在 {{site.data.keyword.Bluemix_notm}} 中运行的 Cloud Foundry 应用程序 API 规范，可以使用应用程序的名称作为 CLI 的参数。 - -``` -bluemix sdk validate [APP_NAME] -``` -{: codeblock} - -要从 API 规范文档或本地 JSON 或 Yaml 文件的 URL 验证 SDK，请使用以下命令。 - -``` -bluemix sdk validate [OPENAPI_DOC_LOCATION] -``` -{: codeblock} - - - -### 列出应用程序 (Cloud Foundry) -{: #list-apps} - -使用 `bluemix sdk list [argument][option]` 可以列出应用程序并验证 API 规范。您必须已将 `OPENAPI_SPEC` 环境变量设置为托管规范的相对 URL 路径。 - - -#### 自变量 -{: #list-args} - -* `SPACE_NAME`（可选）当前组织中您要搜索应用程序的 Cloud Foundry 空间的名称。如果未提供，则会搜索当前空间。 - - -#### 选项 -{: #list-options} - -* `--url`（可选）- 为列表中的每个应用程序，显示开放 API 定义的完整 URL - - -#### 用法 -{: #list-usage} - -要列出当前空间中的应用程序，请使用以下命令。 - -``` -bluemix sdk list -``` -{: codeblock} - -要列出当前空间中的应用程序并显示 API 规范 URL，请使用以下命令。 - -``` -bluemix sdk list --url -``` -{: codeblock} - -要列出特定空间中的应用程序，请使用以下命令。 - -``` -bluemix sdk list [SPACE_NAME] -``` -{: codeblock} - -要列出特定空间中的应用程序并显示 API 规范 URL，请使用以下命令。 - -``` -bluemix sdk list [SPACE_NAME] --url -``` -{: codeblock} +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# SDK Generator 插件 +{: #sdk-cli} + +{{site.data.keyword.IBM}} SDK Generator 插件可安装在 [{{site.data.keyword.Bluemix_notm}} CLI ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/cli/reference/bluemix_cli/index.html) 中。 + +作为 {{site.data.keyword.Bluemix_notm}} 上的开发者，您可以使用此插件，从符合[开放 API 规范 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.openapis.org/) 的 REST API 定义中生成 SDK。当您对 REST API 定义进行更改时，可以使用此插件，仅重新生成 SDK 而非重新生成整个项目。 + +您还可以查看给定空间中的 Cloud Foundry 应用程序是否具有对生成 SDK 有效的 REST API 定义。最后，您可以使用 {{site.data.keyword.IBM_notm}} SDK Generator 插件，来验证任何 REST API 定义，以确保它们符合 SDK 生成器需求。 + +通过此 {{site.data.keyword.IBM_notm}} SDK Generator 插件，您可以轻松地将应用程序的后端服务与所生成的 SDK 相集成。当 REST API 发生更改时，可以重新生成 SDK 并替换旧的 SDK 以进行无缝 SDK 升级。您还可以将 CLI 集成到 DevOps 管道，并确保每次构建应用程序时，SDK 始终与 API 规范保持一致。 + +REST API 定义必须有效，或者在活动服务器端点上托管，或者是您系统上的本地文件。如果托管 REST API 定义，则必须在 `OPENAPI_SPEC` 环境变量中定义相对 URL。 + + +## 需求 +{: #prereqs} + +确保满足以下需求。 + +* 具有 [{{site.data.keyword.Bluemix_notm}} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://bluemix.net) 帐户 +* 具有符合[开放 API ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.openapis.org/) 规范的有效 API 定义 + + +## 安装 +{: #installation} + +1. [安装 {{site.data.keyword.Bluemix}} CLI ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://clis.ng.bluemix.net/ui/home.html)。 + +2. [安装插件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in)。 + + ``` + bx plugin install sdk-gen -r Bluemix + ``` + {: codeblock} + + +## 命令 +{: #commands} + +使用以下命令，生成 SDK、验证开放 API 定义文件或列出 Cloud Foundry 应用程序。 + + +### 生成 SDK +{: #gen} + +使用 `bluemix sdk generate [arguments...][command options]`。 + + +#### 自变量 +{: #gen-args} + +* `APP_NAME` - 当前空间中 Cloud Foundry 应用程序的名称 +* `OPENAPI_DOC_LOCATION` - 原始 REST API 定义 JSON 或 Yaml 的 URL 或相对文件路径 +* `GENERATED_SDK_NAME`（可选）- 所生成 SDK 的名称 + + +#### 选项 +{: #gen-options} + +* `PLATFORM`（必要） + * `--android` - 生成 Android SDK + * `--ios` - 生成 iOS Swift SDK + * `--swift` - 生成 Swift 服务器 SDK +* `--output "YOUR_RELATIVE_PATH"`（可选）- 将所生成的 SDK 置于 `YOUR_RELATIVE_PATH` 所指定的目录中（如果存在现有的 SDK 则覆盖） +* `--unzip`（可选）- 解压缩所生成的 SDK（如果存在现有的 SDK 工件则覆盖） + + +#### 用法 +{: #gen-usage} + +要通过在 {{site.data.keyword.Bluemix_notm}} 中运行的 Cloud Foundry 应用程序生成 SDK，可以使用应用程序的名称作为 CLI 的参数。以下命令使用应用程序的名称作为 `SDK_Name`。 + +``` +bluemix sdk generate [APP_NAME] [PLATFORM] +``` +{: codeblock} + +要从开放 API 定义文件或本地 JSON 或 Yaml 文件的 URL 生成 SDK，请使用以下命令。 + +``` +bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] +``` +{: codeblock} + + +### 验证开放 API 定义 +{: #validating} + +使用 `bluemix sdk validate [argument]`。 + + +#### 自变量 +{: #val-args} + +* `APP_NAME` - 当前空间中 Cloud Foundry 应用程序的名称 +* `OPENAPI_DOC_LOCATION` - 原始 REST API 定义 JSON 或 Yaml 的 URL 或相对文件路径 + + +#### 用法 +{: #val-usage} + +要验证在 {{site.data.keyword.Bluemix_notm}} 中运行的 Cloud Foundry 应用程序 API 规范，可以使用应用程序的名称作为 CLI 的参数。 + +``` +bluemix sdk validate [APP_NAME] +``` +{: codeblock} + +要从 API 规范文档或本地 JSON 或 Yaml 文件的 URL 验证 SDK，请使用以下命令。 + +``` +bluemix sdk validate [OPENAPI_DOC_LOCATION] +``` +{: codeblock} + + + +### 列出应用程序 (Cloud Foundry) +{: #list-apps} + +使用 `bluemix sdk list [argument][option]` 可以列出应用程序并验证 API 规范。您必须已将 `OPENAPI_SPEC` 环境变量设置为托管规范的相对 URL 路径。 + + +#### 自变量 +{: #list-args} + +* `SPACE_NAME`（可选）当前组织中您要搜索应用程序的 Cloud Foundry 空间的名称。如果未提供，则会搜索当前空间。 + + +#### 选项 +{: #list-options} + +* `--url`（可选）- 为列表中的每个应用程序，显示开放 API 定义的完整 URL + + +#### 用法 +{: #list-usage} + +要列出当前空间中的应用程序，请使用以下命令。 + +``` +bluemix sdk list +``` +{: codeblock} + +要列出当前空间中的应用程序并显示 API 规范 URL，请使用以下命令。 + +``` +bluemix sdk list --url +``` +{: codeblock} + +要列出特定空间中的应用程序，请使用以下命令。 + +``` +bluemix sdk list [SPACE_NAME] +``` +{: codeblock} + +要列出特定空间中的应用程序并显示 API 规范 URL，请使用以下命令。 + +``` +bluemix sdk list [SPACE_NAME] --url +``` +{: codeblock} diff --git a/cloudnative/nl/zh/CN/sdk_network_request.md b/cloudnative/nl/zh/CN/sdk_network_request.md index cd3a1374a..888d21409 100644 --- a/cloudnative/nl/zh/CN/sdk_network_request.md +++ b/cloudnative/nl/zh/CN/sdk_network_request.md @@ -1,121 +1,121 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 发起网络请求 -{: #sdk-network-request} - -您还可以使用 `BMSCore` SDK 向任何资源发起网络请求。 - -## Android -{: #request-android} - -1. 确保您在 Android 应用程序中已[导入客户机 SDK 并对其进行初始化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android)。 - -2. 发起网络请求。 - - ``` - public void makeGetCall() { - Thread thread = new Thread(new Runnable() { - @Override - public void run() { - try { - Request request = new Request("http://httpbin.org/get", "GET"); - request.send(null, null); - } catch (Exception e) { - // Handle failure here. - } - } - }); - thread.start(); - } - ``` - {: codeblock} - -## iOS -{: #request-ios} - -1. 确保您在 iOS 应用程序中已[导入客户机 SDK 并对其进行初始化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios)。 - -2. 创建网络请求。 - - ### Swift 3.0 - {: #ios-swift3 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - - ### Swift 2.2 - {: #ios-swift22 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - -`Request` 类是发起 HTTP 请求的简单方法，在请求完成之后可获得响应。如果想要采用比 `Request` 类更灵活且更具有控制性的方法，您可以使用 `BMSURLSession` 类。`BMSURLSession` 类的部分功能包括监视上传进度以及暂停或取消请求。要获得响应，您可以选择使用完成处理程序或代理。 - -`BMSURLSession` 类仅可用于 iOS。有关 `BMSURLSession` 的更多信息，请参阅 `BMSCore` SDK [自述文件](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core)。 - - -## Cordova -{: #request-cordova} - -1. 确保您在 Cordova 应用程序中已[导入客户机 SDK 并对其进行初始化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova)。 - -2. 创建网络请求。 - - ``` - var success = function(data) { - console.log("success", data); - } - var failure = function(error) - {console.log("failure", error); - } - var request = new BMSRequest("", BMSRequest.GET); - request.send(success, failure); - ``` - {: codeblock} - - -# 相关链接 -{: #rellinks notoc} - -## 相关链接 -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova 插件](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 发起网络请求 +{: #sdk-network-request} + +您还可以使用 `BMSCore` SDK 向任何资源发起网络请求。 + +## Android +{: #request-android} + +1. 确保您在 Android 应用程序中已[导入客户机 SDK 并对其进行初始化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android)。 + +2. 发起网络请求。 + + ``` + public void makeGetCall() { + Thread thread = new Thread(new Runnable() { + @Override + public void run() { + try { + Request request = new Request("http://httpbin.org/get", "GET"); + request.send(null, null); + } catch (Exception e) { + // Handle failure here. + } + } + }); + thread.start(); + } + ``` + {: codeblock} + +## iOS +{: #request-ios} + +1. 确保您在 iOS 应用程序中已[导入客户机 SDK 并对其进行初始化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios)。 + +2. 创建网络请求。 + + ### Swift 3.0 + {: #ios-swift3 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + + ### Swift 2.2 + {: #ios-swift22 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + +`Request` 类是发起 HTTP 请求的简单方法，在请求完成之后可获得响应。如果想要采用比 `Request` 类更灵活且更具有控制性的方法，您可以使用 `BMSURLSession` 类。`BMSURLSession` 类的部分功能包括监视上传进度以及暂停或取消请求。要获得响应，您可以选择使用完成处理程序或代理。 + +`BMSURLSession` 类仅可用于 iOS。有关 `BMSURLSession` 的更多信息，请参阅 `BMSCore` SDK [自述文件](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core)。 + + +## Cordova +{: #request-cordova} + +1. 确保您在 Cordova 应用程序中已[导入客户机 SDK 并对其进行初始化](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova)。 + +2. 创建网络请求。 + + ``` + var success = function(data) { + console.log("success", data); + } + var failure = function(error) + {console.log("failure", error); + } + var request = new BMSRequest("", BMSRequest.GET); + request.send(success, failure); + ``` + {: codeblock} + + +# 相关链接 +{: #rellinks notoc} + +## 相关链接 +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova 插件](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/zh/CN/services.md b/cloudnative/nl/zh/CN/services.md index fc3324b16..36e01c90e 100644 --- a/cloudnative/nl/zh/CN/services.md +++ b/cloudnative/nl/zh/CN/services.md @@ -1,53 +1,53 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# 服务 -{: #services} - -从 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} **服务**页面中，您可以查看现有的 Web 和移动服务或创建新服务。利用控制台，可以在一个位置查看项目所管理的所有 {{site.data.keyword.Bluemix_notm}} Web 和移动服务。 - -如果从**服务**视图删除服务，那么您将从与之相关联的项目断开服务连接。如果您想要将服务重新连接到项目，请创建新服务实例。 - -## {{site.data.keyword.Bluemix_notm}} Web 和移动服务概述 -{: #mobile_services_overview} - -下表描述了 {{site.data.keyword.Bluemix_notm}} Web 和移动服务。您可以使用 {{site.data.keyword.Bluemix_notm}}“目录”中的单个服务，也可以将这些服务集成到您的项目中。 - - - - - - - - - - - - - - - - - - - -
表 1. {{site.data.keyword.Bluemix_notm}} Web 和移动服务
{{site.data.keyword.Bluemix_notm}} Web 和移动服务描述
{{site.data.keyword.mobileanalytics_short}} 图标
{{site.data.keyword.mobileanalytics_short}}		使用 {{site.data.keyword.mobileanalytics_full}} 服务，可深入了解您的移动应用程序的性能如何，以及如何使用它们。

-在 {{site.data.keyword.mobileanalytics_short}} 文档中阅读有关操作此服务的更多信息。
{{site.data.keyword.mobilefoundation_short}} 服务图标
{{site.data.keyword.mobilefoundation_short}}		使用 {{site.data.keyword.mobilefoundation_long}} 服务可加快设置 {{site.data.keyword.mfp_full}} 环境，在该环境中，可以开发、测试和使用企业移动应用程序。 -

-在 {{site.data.keyword.mobilefoundation_short}} 文档中阅读有关操作此服务的更多信息。
{{site.data.keyword.mobilepushshort}} 服务图标
{{site.data.keyword.mobilepushshort}}		{{site.data.keyword.mobilepushfull}} 服务提供一个统一平台来发送和管理针对平台的移动和 Web 推送通知。 -

-{{site.data.keyword.mobilepushshort}} 会管理您的应用程序用户与其设备、设备平台、Web 浏览器之间的映射，还会处理将推送通知派送给他们。您可以作为推送通知，向移动和Web 浏览器应用程序用户发送广播、单点广播（基于设备标识和用户标识）和标记（或主题）。还可以使用 SDK 和 REST API 来进一步开发您的客户机应用程序。

-在 {{site.data.keyword.mobilepushshort}} 文档中阅读有关操作此服务的更多信息。
+--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# 服务 +{: #services} + +从 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} **服务**页面中，您可以查看现有的 Web 和移动服务或创建新服务。利用控制台，可以在一个位置查看项目所管理的所有 {{site.data.keyword.Bluemix_notm}} Web 和移动服务。 + +如果从**服务**视图删除服务，那么您将从与之相关联的项目断开服务连接。如果您想要将服务重新连接到项目，请创建新服务实例。 + +## {{site.data.keyword.Bluemix_notm}} Web 和移动服务概述 +{: #mobile_services_overview} + +下表描述了 {{site.data.keyword.Bluemix_notm}} Web 和移动服务。您可以使用 {{site.data.keyword.Bluemix_notm}}“目录”中的单个服务，也可以将这些服务集成到您的项目中。 + + + + + + + + + + + + + + + + + + + +
表 1. {{site.data.keyword.Bluemix_notm}} Web 和移动服务
{{site.data.keyword.Bluemix_notm}} Web 和移动服务描述
{{site.data.keyword.mobileanalytics_short}} 图标
{{site.data.keyword.mobileanalytics_short}}		使用 {{site.data.keyword.mobileanalytics_full}} 服务，可深入了解您的移动应用程序的性能如何，以及如何使用它们。

+在 {{site.data.keyword.mobileanalytics_short}} 文档中阅读有关操作此服务的更多信息。
{{site.data.keyword.mobilefoundation_short}} 服务图标
{{site.data.keyword.mobilefoundation_short}}		使用 {{site.data.keyword.mobilefoundation_long}} 服务可加快设置 {{site.data.keyword.mfp_full}} 环境，在该环境中，可以开发、测试和使用企业移动应用程序。 +

+在 {{site.data.keyword.mobilefoundation_short}} 文档中阅读有关操作此服务的更多信息。
{{site.data.keyword.mobilepushshort}} 服务图标
{{site.data.keyword.mobilepushshort}}		{{site.data.keyword.mobilepushfull}} 服务提供一个统一平台来发送和管理针对平台的移动和 Web 推送通知。 +

+{{site.data.keyword.mobilepushshort}} 会管理您的应用程序用户与其设备、设备平台、Web 浏览器之间的映射，还会处理将推送通知派送给他们。您可以作为推送通知，向移动和Web 浏览器应用程序用户发送广播、单点广播（基于设备标识和用户标识）和标记（或主题）。还可以使用 SDK 和 REST API 来进一步开发您的客户机应用程序。

+在 {{site.data.keyword.mobilepushshort}} 文档中阅读有关操作此服务的更多信息。
diff --git a/cloudnative/nl/zh/CN/starters.md b/cloudnative/nl/zh/CN/starters.md index dd68c89e7..9f42abcea 100644 --- a/cloudnative/nl/zh/CN/starters.md +++ b/cloudnative/nl/zh/CN/starters.md @@ -1,26 +1,26 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 入门模板 -{: #starters} - -使用 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}，可以从多个入门模板中为每种模式类型做出选择。 - -入门模板已经过优化，是可用于生产的入门模板代码，重点在于演示 {{site.data.keyword.Bluemix_notm}} 与高价值服务的重要集成。每一个入门模板都注重一个服务，并显示服务 SDK 与代码的集成。在某些情况下，入门模板提供简单的用户体验，以突出显示与服务数据或用户交互的集成。每个入门模板都配置为可以通过认证、数据以及其他可能的功能来启用，所以如果您决定为项目配置这些功能，也便于使用。 - - -## 教程 -{: #tutorials notoc} - -有关如何使用入门模板创建应用程序的详细指示信息，可以使用端到端[教程](tutorials.html)。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 入门模板 +{: #starters} + +使用 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}，可以从多个入门模板中为每种模式类型做出选择。 + +入门模板已经过优化，是可用于生产的入门模板代码，重点在于演示 {{site.data.keyword.Bluemix_notm}} 与高价值服务的重要集成。每一个入门模板都注重一个服务，并显示服务 SDK 与代码的集成。在某些情况下，入门模板提供简单的用户体验，以突出显示与服务数据或用户交互的集成。每个入门模板都配置为可以通过认证、数据以及其他可能的功能来启用，所以如果您决定为项目配置这些功能，也便于使用。 + + +## 教程 +{: #tutorials notoc} + +有关如何使用入门模板创建应用程序的详细指示信息，可以使用端到端[教程](tutorials.html)。 diff --git a/cloudnative/nl/zh/CN/troubleshoot.md b/cloudnative/nl/zh/CN/troubleshoot.md index af7537a30..4c5cc031b 100644 --- a/cloudnative/nl/zh/CN/troubleshoot.md +++ b/cloudnative/nl/zh/CN/troubleshoot.md @@ -1,223 +1,223 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 故障诊断 -{: #ts} - -{{site.data.keyword.dev_cli_notm}} 的一些已知问题已经记录在文档中，并且提供了变通方法。 -{:shortdesc} - - - -## 已知问题 -{: #knownissues} - -以下各部分介绍了已知问题以及可能的解决方案。 - - -### 使用非移动模式创建项目时，发生主机名被占用错误 -{: #hostname} - -如果使用 {{site.data.keyword.dev_cli_short}} 从 Web 应用程序、BFF 或微服务模式创建项目，那么可能会看到以下错误： - -``` -The hostname is taken. -``` -{: codeblock} - - -#### 原因 -{: #hostname-cause} - -此错误是由于登录令牌到期导致的。 - - -#### 解决方案 -{: #hostname-resolution} - -重新登录。 - -``` -bx login -``` -{: codeblock} - - -### {{site.data.keyword.dev_cli_short}} 发生一般故障 -{: #general} - -如果使用 {{site.data.keyword.dev_cli_short}} 创建、删除或列出命令或者对其进行编码，那么可能会看到以下错误： - -``` -Failed to project. -``` -{: codeblock} - - -#### 原因 -{: #hostname-cause} - -此错误是由于登录令牌到期导致的。 - - -#### 解决方案 -{: #hostname-resolution} - -重新登录。 - -``` -bx login -``` -{: codeblock} - - -### 添加 {{site.data.keyword.objectstorageshort}} 功能时发生服务代理错误 -{: #os} - -如果使用 {{site.data.keyword.dev_cli_short}} 通过 {{site.data.keyword.objectstorageshort}} 功能创建两个项目，那么可能会看到以下错误： - -``` -FAILED -Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} -``` -{: codeblock} - - -#### 原因 -{: #os-cause} - -此错误是由于 {{site.data.keyword.objectstorageshort}} 服务仅允许免费 {{site.data.keyword.objectstorageshort}} 套餐的一个实例导致的。 - - -#### 解决方案 -{: #os-resolution} - -系统将提示您选择其他套餐以避免此错误。 - - -### 创建项目期间获取代码失败 -{: #code} - -如果使用 {{site.data.keyword.dev_cli_short}} 创建项目，那么可能会看到以下错误： - -``` -FAILED -Project created, but could not get code -https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code -``` -{: codeblock} - - -#### 原因 -{: #code-cause} - -此错误是由于内部超时导致的。 - - -#### 解决方案 -{: #code-resolution} - -可以通过以下任一方式获得代码： - -* 使用 CLI 运行以下命令： - - ``` - bx dev code - ``` - {: codeblock} - - 应该将 `` 替换为创建项目期间使用的项目名称。 - -* 使用 {{site.data.keyword.dev_console}}。 - - 1. 在 {{site.data.keyword.dev_console}} 中选择您的[项目 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://console.{DomainName}/developer/projects)，并单击**获取代码**。 - - 2. 单击**生成代码**。 - - 3. 生成代码后，单击**下载代码**。 - - -### 针对 Node.js 项目运行 `bx dev run` 时出错 -{: #node} - -如果使用 {{site.data.keyword.dev_cli_short}} 针对 Node.js Web 或 BFF 项目运行 `bx dev run`，那么可能会看到以下错误： - -``` -module.js:597 - return process.dlopen(module, path._makeLong(filename)); - ^ - -Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header - at Error (native) - at Object.Module._extensions..node (module.js:597:18) - at Module.load (module.js:487:32) - at tryModuleLoad (module.js:446:12) - - at Function.Module._load (module.js:438:3) - at Module.require (module.js:497:17) - at require (internal/module.js:20:19) - at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) - at Module._compile (module.js:570:32) - at Object.Module._extensions..js (module.js:579:10) -``` -{: codeblock} - - -#### 原因 -{: #node-cause} - -此错误是由于将 `appmetrics` 模块安装到其他体系结构中导致的。在一个体系结构上安装的本机 npm 模块无法在其他体系结构上使用。包含的 Docker 映像基于 Linux 内核。 - - -#### 解决方案 -{: #node-resolution} - -删除 `node_modules` 文件夹并再次运行 `bx dev run`。 - - - - - - - -## 获取帮助与支持 -{: #gettinghelp} - -如果使用 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 或 {{site.data.keyword.dev_cli_notm}} 时遇到问题或者有任何疑问，可通过搜索信息或在论坛中提问获取帮助。您还可以提交支持凭单。 - -使用论坛进行提问时，请对问题进行标记，以便 {{site.data.keyword.Bluemix_notm}} 开发团队能看到您的问题。 - - - -如果在使用 {{site.data.keyword.dev_console}} 或 {{site.data.keyword.dev_cli_notm}} 开发或部署应用程序时遇到技术问题： - -* 请将问题发布到 [Stack Overflow ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix)，并以 `bluemix-dev-services` 和 `ibm-bluemix` 来标记问题。 -* 请将问题发布到 `bluemix-dev-services` 通道中的 [Slack ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://ibm-cloud-tech.slack.com/)。立即[注册 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://ibm.biz/IBMCloudNativeSlack)。 - - - - - -请参阅[获取帮助 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/support/index.html#getting-help)，以获取有关使用论坛的更多详细信息。 - -有关提交 {{site.data.keyword.IBM}} 支持凭单或者有关支持级别和凭单严重性的信息，请参阅[联系支持人员 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/support/index.html#contacting-support)。 - - - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 故障诊断 +{: #ts} + +{{site.data.keyword.dev_cli_notm}} 的一些已知问题已经记录在文档中，并且提供了变通方法。 +{:shortdesc} + + + +## 已知问题 +{: #knownissues} + +以下各部分介绍了已知问题以及可能的解决方案。 + + +### 使用非移动模式创建项目时，发生主机名被占用错误 +{: #hostname} + +如果使用 {{site.data.keyword.dev_cli_short}} 从 Web 应用程序、BFF 或微服务模式创建项目，那么可能会看到以下错误： + +``` +The hostname is taken. +``` +{: codeblock} + + +#### 原因 +{: #hostname-cause} + +此错误是由于登录令牌到期导致的。 + + +#### 解决方案 +{: #hostname-resolution} + +重新登录。 + +``` +bx login +``` +{: codeblock} + + +### {{site.data.keyword.dev_cli_short}} 发生一般故障 +{: #general} + +如果使用 {{site.data.keyword.dev_cli_short}} 创建、删除或列出命令或者对其进行编码，那么可能会看到以下错误： + +``` +Failed to project. +``` +{: codeblock} + + +#### 原因 +{: #hostname-cause} + +此错误是由于登录令牌到期导致的。 + + +#### 解决方案 +{: #hostname-resolution} + +重新登录。 + +``` +bx login +``` +{: codeblock} + + +### 添加 {{site.data.keyword.objectstorageshort}} 功能时发生服务代理错误 +{: #os} + +如果使用 {{site.data.keyword.dev_cli_short}} 通过 {{site.data.keyword.objectstorageshort}} 功能创建两个项目，那么可能会看到以下错误： + +``` +FAILED +Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} +``` +{: codeblock} + + +#### 原因 +{: #os-cause} + +此错误是由于 {{site.data.keyword.objectstorageshort}} 服务仅允许免费 {{site.data.keyword.objectstorageshort}} 套餐的一个实例导致的。 + + +#### 解决方案 +{: #os-resolution} + +系统将提示您选择其他套餐以避免此错误。 + + +### 创建项目期间获取代码失败 +{: #code} + +如果使用 {{site.data.keyword.dev_cli_short}} 创建项目，那么可能会看到以下错误： + +``` +FAILED +Project created, but could not get code +https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code +``` +{: codeblock} + + +#### 原因 +{: #code-cause} + +此错误是由于内部超时导致的。 + + +#### 解决方案 +{: #code-resolution} + +可以通过以下任一方式获得代码： + +* 使用 CLI 运行以下命令： + + ``` + bx dev code + ``` + {: codeblock} + + 应该将 `` 替换为创建项目期间使用的项目名称。 + +* 使用 {{site.data.keyword.dev_console}}。 + + 1. 在 {{site.data.keyword.dev_console}} 中选择您的[项目 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://console.{DomainName}/developer/projects)，并单击**获取代码**。 + + 2. 单击**生成代码**。 + + 3. 生成代码后，单击**下载代码**。 + + +### 针对 Node.js 项目运行 `bx dev run` 时出错 +{: #node} + +如果使用 {{site.data.keyword.dev_cli_short}} 针对 Node.js Web 或 BFF 项目运行 `bx dev run`，那么可能会看到以下错误： + +``` +module.js:597 + return process.dlopen(module, path._makeLong(filename)); + ^ + +Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header + at Error (native) + at Object.Module._extensions..node (module.js:597:18) + at Module.load (module.js:487:32) + at tryModuleLoad (module.js:446:12) + + at Function.Module._load (module.js:438:3) + at Module.require (module.js:497:17) + at require (internal/module.js:20:19) + at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) + at Module._compile (module.js:570:32) + at Object.Module._extensions..js (module.js:579:10) +``` +{: codeblock} + + +#### 原因 +{: #node-cause} + +此错误是由于将 `appmetrics` 模块安装到其他体系结构中导致的。在一个体系结构上安装的本机 npm 模块无法在其他体系结构上使用。包含的 Docker 映像基于 Linux 内核。 + + +#### 解决方案 +{: #node-resolution} + +删除 `node_modules` 文件夹并再次运行 `bx dev run`。 + + + + + + + +## 获取帮助与支持 +{: #gettinghelp} + +如果使用 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 或 {{site.data.keyword.dev_cli_notm}} 时遇到问题或者有任何疑问，可通过搜索信息或在论坛中提问获取帮助。您还可以提交支持凭单。 + +使用论坛进行提问时，请对问题进行标记，以便 {{site.data.keyword.Bluemix_notm}} 开发团队能看到您的问题。 + + + +如果在使用 {{site.data.keyword.dev_console}} 或 {{site.data.keyword.dev_cli_notm}} 开发或部署应用程序时遇到技术问题： + +* 请将问题发布到 [Stack Overflow ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix)，并以 `bluemix-dev-services` 和 `ibm-bluemix` 来标记问题。 +* 请将问题发布到 `bluemix-dev-services` 通道中的 [Slack ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://ibm-cloud-tech.slack.com/)。立即[注册 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](http://ibm.biz/IBMCloudNativeSlack)。 + + + + + +请参阅[获取帮助 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/support/index.html#getting-help)，以获取有关使用论坛的更多详细信息。 + +有关提交 {{site.data.keyword.IBM}} 支持凭单或者有关支持级别和凭单严重性的信息，请参阅[联系支持人员 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/support/index.html#contacting-support)。 + + + diff --git a/cloudnative/nl/zh/CN/tutorial_bff.md b/cloudnative/nl/zh/CN/tutorial_bff.md index ec52afec9..4bd94ea73 100644 --- a/cloudnative/nl/zh/CN/tutorial_bff.md +++ b/cloudnative/nl/zh/CN/tutorial_bff.md @@ -1,147 +1,147 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# BFF 基本入门模板端到端教程 -{: #tutorial} - -以下端到端教程将引导您完成通过“BFF 基本入门模板”创建项目的步骤（包括必须安装的工具）以及接下来运行项目代码的步骤。 - -## 安装开发者工具 -{: #dev_tools} - -请确保您已安装[必备开发者工具 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](get_code.html#prereq-dev-tools){: new_window}。 - - -## 使用 {{site.data.keyword.dev_console}} 创建项目 -{: #create-devex} - -1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中创建项目。 - - 1. 从 {{site.data.keyword.dev_console}} 中的**入门**页面，单击**创建项目**。 - - 或者，您可以从**项目**页面单击**创建项目**。 - - 2. 选择**服务于前端的后端**并单击**下一步**。 - - 3. 选择**基本后端**并单击**下一步**。 - - 4. 输入项目名称。对于本教程，请使用 `BFFProject`。 - - 5. 输入主机名。对于本教程，请使用 `devhost` - - 6. 选择语言平台。对于本教程，请使用 `Node`。 - - 7. 单击**创建**。 - -2. 可选：添加数据功能。 - - 1. 在**项目概述**页面上，针对**数据**单击**查看**。 - - 或者，可在**功能 > 数据**页面上选择**创建**或**添加现有项**。 - - 2. 输入服务名称并单击**创建**。 - - -3. 生成项目代码。 - - 1. 单击**项目概述**页面上的**获取代码**，以选择语言。 - - 或者，您可以在**代码**页面上单击。 - - 2. 单击**生成代码**。 - - 3. 项目代码完成生成后，单击**下载代码**以下载项目归档。 - -4. 可选：[更新项目](project_overview_page.html#update_language)以生成新语言。 - - -## 使用 {{site.data.keyword.dev_cli_notm}} 创建项目 -{: #create-cli} - -1. 确保您已安装 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 - -2. 在“终端”提示符处，浏览到所选的本地目录并运行以下命令。 - - ``` - bx dev create - ``` - {: codeblock} - -3. 在系统提示时提供以下值： - - * 选择模式：3（“服务于前端的后端”） - * 选择入门模板：1（“基本后端”） - * 选择语言：1 (Node) - * 输入项目的名称：`BFFProjectCLI` - * 输入项目的主机名：`myhost` - -4. 如果要向项目添加服务，请在问题提示处输入 `y` 并回答其余问题。 - -5. 成功保存 `BFFProjectCLI` 后，浏览到 `BFFProjectCLI` 文件夹。 - -6. 此时，可添加您自己的代码，构建或运行项目。 - - 1. 使用以下命令构建项目： - - ``` - bx dev build - ``` - {: codeblock} - - 2. 使用以下命令运行项目： - - ``` - bx dev run - ``` - {: codeblock} - - -## 运行 BFF 项目 -{: #running-bff} - -### 本地 -{: #bff-local} - -1. 编译服务器： - - ``` - swift build - ``` - {: codeblock} - -2. 运行应用程序。例如，假设应用程序名为 `MyServer`： - - ``` - .build/debug/MyServer - ``` - {: codeblock} - -3. 您可以使用 `curl http://localhost:8080` 在服务器上运行 curl - - -### 使用 Bluemix 插件 -{: #using-blumix} - -1. 运行编译 - - ``` - bx dev run - ``` - {: codeblock} - -2. 您可以使用以下代码在服务器上运行 curl - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# BFF 基本入门模板端到端教程 +{: #tutorial} + +以下端到端教程将引导您完成通过“BFF 基本入门模板”创建项目的步骤（包括必须安装的工具）以及接下来运行项目代码的步骤。 + +## 安装开发者工具 +{: #dev_tools} + +请确保您已安装[必备开发者工具 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](get_code.html#prereq-dev-tools){: new_window}。 + + +## 使用 {{site.data.keyword.dev_console}} 创建项目 +{: #create-devex} + +1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中创建项目。 + + 1. 从 {{site.data.keyword.dev_console}} 中的**入门**页面，单击**创建项目**。 + + 或者，您可以从**项目**页面单击**创建项目**。 + + 2. 选择**服务于前端的后端**并单击**下一步**。 + + 3. 选择**基本后端**并单击**下一步**。 + + 4. 输入项目名称。对于本教程，请使用 `BFFProject`。 + + 5. 输入主机名。对于本教程，请使用 `devhost` + + 6. 选择语言平台。对于本教程，请使用 `Node`。 + + 7. 单击**创建**。 + +2. 可选：添加数据功能。 + + 1. 在**项目概述**页面上，针对**数据**单击**查看**。 + + 或者，可在**功能 > 数据**页面上选择**创建**或**添加现有项**。 + + 2. 输入服务名称并单击**创建**。 + + +3. 生成项目代码。 + + 1. 单击**项目概述**页面上的**获取代码**，以选择语言。 + + 或者，您可以在**代码**页面上单击。 + + 2. 单击**生成代码**。 + + 3. 项目代码完成生成后，单击**下载代码**以下载项目归档。 + +4. 可选：[更新项目](project_overview_page.html#update_language)以生成新语言。 + + +## 使用 {{site.data.keyword.dev_cli_notm}} 创建项目 +{: #create-cli} + +1. 确保您已安装 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 + +2. 在“终端”提示符处，浏览到所选的本地目录并运行以下命令。 + + ``` + bx dev create + ``` + {: codeblock} + +3. 在系统提示时提供以下值： + + * 选择模式：3（“服务于前端的后端”） + * 选择入门模板：1（“基本后端”） + * 选择语言：1 (Node) + * 输入项目的名称：`BFFProjectCLI` + * 输入项目的主机名：`myhost` + +4. 如果要向项目添加服务，请在问题提示处输入 `y` 并回答其余问题。 + +5. 成功保存 `BFFProjectCLI` 后，浏览到 `BFFProjectCLI` 文件夹。 + +6. 此时，可添加您自己的代码，构建或运行项目。 + + 1. 使用以下命令构建项目： + + ``` + bx dev build + ``` + {: codeblock} + + 2. 使用以下命令运行项目： + + ``` + bx dev run + ``` + {: codeblock} + + +## 运行 BFF 项目 +{: #running-bff} + +### 本地 +{: #bff-local} + +1. 编译服务器： + + ``` + swift build + ``` + {: codeblock} + +2. 运行应用程序。例如，假设应用程序名为 `MyServer`： + + ``` + .build/debug/MyServer + ``` + {: codeblock} + +3. 您可以使用 `curl http://localhost:8080` 在服务器上运行 curl + + +### 使用 Bluemix 插件 +{: #using-blumix} + +1. 运行编译 + + ``` + bx dev run + ``` + {: codeblock} + +2. 您可以使用以下代码在服务器上运行 curl + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/zh/CN/tutorial_microservice.md b/cloudnative/nl/zh/CN/tutorial_microservice.md index 53aa99564..d97ae967c 100644 --- a/cloudnative/nl/zh/CN/tutorial_microservice.md +++ b/cloudnative/nl/zh/CN/tutorial_microservice.md @@ -1,113 +1,113 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 微服务基本入门模板端到端教程 -{: #tutorial} - -以下端到端教程将引导您完成通过“微服务基本入门模板”创建项目的步骤（包括必须安装的工具）以及接下来运行项目代码的步骤。 - -## 安装开发者工具 -{: #dev_tools} - -请确保您已安装[必备开发者工具 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](get_code.html#prereq-dev-tools){: new_window}。 - - -## 使用 {{site.data.keyword.dev_console}} 创建项目 -{: #create-devex} - -1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中创建项目。 - - 1. 从 {{site.data.keyword.dev_console}} 中的**入门**页面，单击**创建项目**。 - - 或者，您可以从**项目**页面单击**创建项目**。 - - 2. 选择**微服务**并单击**下一步**。 - - 3. 选择**基本**并单击**下一步**。 - - 4. 输入项目名称。对于本教程，请使用 `MicroserviceProject`。 - - 5. 输入主机名。对于本教程，请使用 `devhost` - - 6. 单击**创建**。 - -2. 可选：添加数据功能。 - - 1. 在**项目概述**页面上，针对**数据**单击**查看**。 - - 或者，可在**功能 > 数据**页面上选择**创建**或**添加现有项**。 - - 2. 输入服务名称并单击**创建**。 - -3. 生成项目代码。 - - 1. 单击**项目概述**页面上的**获取代码**，以选择语言。 - - 或者，您可以在**代码**页面上单击。 - - 2. 单击**生成代码**。 - - 3. 项目代码完成生成后，单击**下载代码**以下载项目归档。 - -4. 可选：[更新项目](project_overview_page.html#update_language)以生成新语言。 - - -## 使用 {{site.data.keyword.dev_cli_notm}} 创建项目 -{: #create-cli} - -1. 确保您已安装 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 - -2. 在“终端”提示符处，浏览到所选的本地目录并运行以下命令。 - - ``` - bx dev create - ``` - {: codeblock} - -3. 在系统提示时提供以下值： - - * 选择模式：4（“微服务”） - * 选择入门模板：1（“基本”） - * 选择平台：3 (Java) - * 输入项目的名称：`MicroserviceProjectCLI` - -4. 如果要向项目添加服务，请在问题提示处输入 `y` 并回答其余问题。 - -5. 成功保存 `MicroserviceProjectCLI` 后，浏览到 `MicroserviceProjectCLI` 文件夹。 - -6. 此时，可添加您自己的代码，构建或运行项目。 - - -## 使用 {{site.data.keyword.dev_cli_notm}} 运行项目 -{: #running-dev-plugin} - -1. 要在当前项目目录中构建项目，请输入以下命令： - - ``` - bx dev build - ``` - {: codeblock} - -2. 要在当前项目目录中构建和运行项目，请输入以下命令： - - ``` - bx dev run - ``` - {: codeblock} - -3. 您可以使用 curl 在服务器上访问应用程序： - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 微服务基本入门模板端到端教程 +{: #tutorial} + +以下端到端教程将引导您完成通过“微服务基本入门模板”创建项目的步骤（包括必须安装的工具）以及接下来运行项目代码的步骤。 + +## 安装开发者工具 +{: #dev_tools} + +请确保您已安装[必备开发者工具 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](get_code.html#prereq-dev-tools){: new_window}。 + + +## 使用 {{site.data.keyword.dev_console}} 创建项目 +{: #create-devex} + +1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中创建项目。 + + 1. 从 {{site.data.keyword.dev_console}} 中的**入门**页面，单击**创建项目**。 + + 或者，您可以从**项目**页面单击**创建项目**。 + + 2. 选择**微服务**并单击**下一步**。 + + 3. 选择**基本**并单击**下一步**。 + + 4. 输入项目名称。对于本教程，请使用 `MicroserviceProject`。 + + 5. 输入主机名。对于本教程，请使用 `devhost` + + 6. 单击**创建**。 + +2. 可选：添加数据功能。 + + 1. 在**项目概述**页面上，针对**数据**单击**查看**。 + + 或者，可在**功能 > 数据**页面上选择**创建**或**添加现有项**。 + + 2. 输入服务名称并单击**创建**。 + +3. 生成项目代码。 + + 1. 单击**项目概述**页面上的**获取代码**，以选择语言。 + + 或者，您可以在**代码**页面上单击。 + + 2. 单击**生成代码**。 + + 3. 项目代码完成生成后，单击**下载代码**以下载项目归档。 + +4. 可选：[更新项目](project_overview_page.html#update_language)以生成新语言。 + + +## 使用 {{site.data.keyword.dev_cli_notm}} 创建项目 +{: #create-cli} + +1. 确保您已安装 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 + +2. 在“终端”提示符处，浏览到所选的本地目录并运行以下命令。 + + ``` + bx dev create + ``` + {: codeblock} + +3. 在系统提示时提供以下值： + + * 选择模式：4（“微服务”） + * 选择入门模板：1（“基本”） + * 选择平台：3 (Java) + * 输入项目的名称：`MicroserviceProjectCLI` + +4. 如果要向项目添加服务，请在问题提示处输入 `y` 并回答其余问题。 + +5. 成功保存 `MicroserviceProjectCLI` 后，浏览到 `MicroserviceProjectCLI` 文件夹。 + +6. 此时，可添加您自己的代码，构建或运行项目。 + + +## 使用 {{site.data.keyword.dev_cli_notm}} 运行项目 +{: #running-dev-plugin} + +1. 要在当前项目目录中构建项目，请输入以下命令： + + ``` + bx dev build + ``` + {: codeblock} + +2. 要在当前项目目录中构建和运行项目，请输入以下命令： + + ``` + bx dev run + ``` + {: codeblock} + +3. 您可以使用 curl 在服务器上访问应用程序： + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/zh/CN/tutorial_mobile.md b/cloudnative/nl/zh/CN/tutorial_mobile.md index 9a9bbe9a8..1e7427441 100644 --- a/cloudnative/nl/zh/CN/tutorial_mobile.md +++ b/cloudnative/nl/zh/CN/tutorial_mobile.md @@ -1,187 +1,187 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 移动基本入门模板端到端教程 -{: #tutorial} - -以下端到端教程将引导您完成通过“移动基本入门模板”创建项目的步骤（包括必须安装的工具）以及接下来在 Xcode 和 Android Studio 中运行项目的步骤。 - - -## 安装开发者工具 -{: #dev_tools} - -请确保您已安装[必备开发者工具 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](get_code.html#prereq-dev-tools){: new_window}。 - - -## 使用 {{site.data.keyword.dev_console}} 创建项目 -{: #create-devex} - -1. 在 {{site.data.keyword.Bluemix}} 中创建 {{site.data.keyword.dev_console}} 项目。 - - 1. 从 {{site.data.keyword.dev_console}} 中的**入门**页面，单击**创建项目**。 - - 或者，您可以从**项目**页面单击**创建项目**。 - - 2. 选择**移动应用程序**并单击**下一步**。 - - 3. 选择**基本**并单击**下一步**。 - - 4. 输入项目名称。对于本教程，请使用 `MobileBasicProject`。 - - 5. 选择平台。对于本教程，请使用 `Swift`。 - - 6. 单击**创建**。 - -2. 可选：添加 Authentication 功能。 - - 1. 在**项目概述**页面上，针对 **Authentication** 单击**添加**。 - - 或者，可在**功能 > 认证**页面上选择**创建**或**添加现有项**。 - - 2. 输入服务名称并单击**创建**。 - - 3. 打开 **Authentication**。 - - 4. 选择身份提供者，并输入必需的信息以对其进行配置。只能启用一个身份提供者。 - - 5. 请参阅[配置身份提供者} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/appid/identity-providers.html){: new_window}，以获取有关配置认证的更多信息。 - -3. 可选：添加 Analytics 功能。 - - 1. 在**项目概述**页面上，针对 **Analytics** 单击**添加**。 - - 或者，您可以从**功能 > 分析**页面单击**创建**或**添加现有项**。 - - 2. 输入服务名称并单击**创建**。 - - 3. 您可以在运行应用程序后关闭**演示模式**，以查看您的分析数据。 - - 4. 查看 [{{site.data.keyword.mobileanalytics_short}} 入门 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobileanalytics/index.html){: new_window}，以获取配置 Analytics 的更多信息。 - -4. 可选：添加 {{site.data.keyword.mobilepushshort}} 功能。 - - 1. 在**项目概述**页面中，针对 **{{site.data.keyword.mobilepushshort}}** 单击**添加**。 - - 或者，您可以从**功能 > {{site.data.keyword.mobilepushshort}}** 页面单击**创建**或**添加现有项**。 - - 2. 输入服务名称并单击**创建**。 - - 3. 对于 iOS，[配置 Apple PushNotification Service ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}。 - - 4. 对于 Android，[配置 Firebase 云消息传递 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}。 - -5. 可选：添加数据功能。 - - 1. 在**项目概述**页面上，针对**数据**单击**查看**。 - - 或者，可以在**数据**页面上选择**创建**。 - - 2. 选择 **{{site.data.keyword.cloudant_short_notm}}** 或 **{{site.data.keyword.objectstorageshort}}**。 - - 3. 输入服务名称并单击**创建**。 - - 4. 请参阅 [{{site.data.keyword.cloudant_short_notm}} 入门 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/Cloudant/index.html){: new_window}，以获取配置 {{site.data.keyword.cloudant_short_notm}} 的更多信息。 - - 5. 请参阅 [{{site.data.keyword.objectstorageshort}} 入门 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/ObjectStorage/index.html){: new_window}，以获取配置 {{site.data.keyword.objectstorageshort}} 的更多信息。 - -6. 生成项目代码。 - - 1. 单击**项目概述**页面上的**获取代码**，以选择语言。 - - 或者，您可以在**代码**页面上单击。 - - 2. 单击**生成 Swift**。 - - 3. 生成项目代码完成后，单击**下载 Swift** 以下载项目归档。 - -7. 可选：[更新项目](project_overview_page.html#update_language)以生成新语言。 - - -## 使用 {{site.data.keyword.dev_cli_notm}} 创建项目 -{: #create-cli} - -1. 确保您已安装 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 - -2. 在“终端”提示符处，浏览到所选的本地目录并运行以下命令。 - - ``` - bx dev create - ``` - {: codeblock} - -3. 在系统提示时提供以下值： - - * 选择模式：2（“移动”） - * 选择入门模板：1（“基本”） - * 选择平台：3 (iOS Swift) - * 输入项目的名称：`MobileBasicProjectCLI` - -4. 如果要向项目添加服务，请在问题提示处输入 `y` 并回答其余问题。 - -5. 成功保存 `MobileBasicProjectCLI` 后，浏览到 `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift` 文件夹。 - - -## 在 Xcode 中运行 Swift 项目 -{: #run_swift} - -1. 解压缩 `MobileBasicProject-Swift.zip` 文件。 - -2. 在 Markdown 查看器中打开 `README.md` 文件，以查看配置项目的步骤。 - - 1. 打开“终端”并浏览到项目文件夹。 - - 1. 如果需要设置 CocoaPods 存储库，请运行 `pod setup`。 - - 2. 如果需要更新现有 Pods，请运行 `pod update`。 - - 3. 运行 `pod install` 以安装项目所需的 Pods。 - - 3. 打开 `BasicProject.xcworkspace` Xcode 工作空间。 - -3. 运行应用程序。 - - -## 在 Xcode 中运行 Cordova 项目 -{: #run_cordova_xcode} - -1. 解压缩 `MobileBasicProject-Cordova.zip` 文件。 - -2. 在 Markdown 查看器中打开 `README.md` 文件，以配置项目。 - - 1. 在 Xcode 中打开 `platforms/ios` 项目。 - -3. 运行应用程序。 - - -## 在 Android Studio 中运行 Cordova 项目 -{: #run_cordova_studio} - -1. 解压缩 `BasicProject-Cordova.zip` 文件。 - -2. 在 Markdown 查看器中打开 `README.md` 文件，以配置项目。 - - 1. 在 Android Studio 中打开 `platforms/android` 项目。 - -3. 运行应用程序。 - - -## 在 Android Studio 中运行 Android 项目 -{: #run_android} - -1. 解压缩 `MobileBasicProject-Android.zip` 文件。 - -2. 在 Markdown 查看器中打开 `README.md` 文件，以配置项目。 - - 1. 在 Android Studio 中打开 `BasicProject-Android` 项目。 - -3. 运行应用程序。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 移动基本入门模板端到端教程 +{: #tutorial} + +以下端到端教程将引导您完成通过“移动基本入门模板”创建项目的步骤（包括必须安装的工具）以及接下来在 Xcode 和 Android Studio 中运行项目的步骤。 + + +## 安装开发者工具 +{: #dev_tools} + +请确保您已安装[必备开发者工具 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](get_code.html#prereq-dev-tools){: new_window}。 + + +## 使用 {{site.data.keyword.dev_console}} 创建项目 +{: #create-devex} + +1. 在 {{site.data.keyword.Bluemix}} 中创建 {{site.data.keyword.dev_console}} 项目。 + + 1. 从 {{site.data.keyword.dev_console}} 中的**入门**页面，单击**创建项目**。 + + 或者，您可以从**项目**页面单击**创建项目**。 + + 2. 选择**移动应用程序**并单击**下一步**。 + + 3. 选择**基本**并单击**下一步**。 + + 4. 输入项目名称。对于本教程，请使用 `MobileBasicProject`。 + + 5. 选择平台。对于本教程，请使用 `Swift`。 + + 6. 单击**创建**。 + +2. 可选：添加 Authentication 功能。 + + 1. 在**项目概述**页面上，针对 **Authentication** 单击**添加**。 + + 或者，可在**功能 > 认证**页面上选择**创建**或**添加现有项**。 + + 2. 输入服务名称并单击**创建**。 + + 3. 打开 **Authentication**。 + + 4. 选择身份提供者，并输入必需的信息以对其进行配置。只能启用一个身份提供者。 + + 5. 请参阅[配置身份提供者} ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/appid/identity-providers.html){: new_window}，以获取有关配置认证的更多信息。 + +3. 可选：添加 Analytics 功能。 + + 1. 在**项目概述**页面上，针对 **Analytics** 单击**添加**。 + + 或者，您可以从**功能 > 分析**页面单击**创建**或**添加现有项**。 + + 2. 输入服务名称并单击**创建**。 + + 3. 您可以在运行应用程序后关闭**演示模式**，以查看您的分析数据。 + + 4. 查看 [{{site.data.keyword.mobileanalytics_short}} 入门 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobileanalytics/index.html){: new_window}，以获取配置 Analytics 的更多信息。 + +4. 可选：添加 {{site.data.keyword.mobilepushshort}} 功能。 + + 1. 在**项目概述**页面中，针对 **{{site.data.keyword.mobilepushshort}}** 单击**添加**。 + + 或者，您可以从**功能 > {{site.data.keyword.mobilepushshort}}** 页面单击**创建**或**添加现有项**。 + + 2. 输入服务名称并单击**创建**。 + + 3. 对于 iOS，[配置 Apple PushNotification Service ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}。 + + 4. 对于 Android，[配置 Firebase 云消息传递 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}。 + +5. 可选：添加数据功能。 + + 1. 在**项目概述**页面上，针对**数据**单击**查看**。 + + 或者，可以在**数据**页面上选择**创建**。 + + 2. 选择 **{{site.data.keyword.cloudant_short_notm}}** 或 **{{site.data.keyword.objectstorageshort}}**。 + + 3. 输入服务名称并单击**创建**。 + + 4. 请参阅 [{{site.data.keyword.cloudant_short_notm}} 入门 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/Cloudant/index.html){: new_window}，以获取配置 {{site.data.keyword.cloudant_short_notm}} 的更多信息。 + + 5. 请参阅 [{{site.data.keyword.objectstorageshort}} 入门 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/ObjectStorage/index.html){: new_window}，以获取配置 {{site.data.keyword.objectstorageshort}} 的更多信息。 + +6. 生成项目代码。 + + 1. 单击**项目概述**页面上的**获取代码**，以选择语言。 + + 或者，您可以在**代码**页面上单击。 + + 2. 单击**生成 Swift**。 + + 3. 生成项目代码完成后，单击**下载 Swift** 以下载项目归档。 + +7. 可选：[更新项目](project_overview_page.html#update_language)以生成新语言。 + + +## 使用 {{site.data.keyword.dev_cli_notm}} 创建项目 +{: #create-cli} + +1. 确保您已安装 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 + +2. 在“终端”提示符处，浏览到所选的本地目录并运行以下命令。 + + ``` + bx dev create + ``` + {: codeblock} + +3. 在系统提示时提供以下值： + + * 选择模式：2（“移动”） + * 选择入门模板：1（“基本”） + * 选择平台：3 (iOS Swift) + * 输入项目的名称：`MobileBasicProjectCLI` + +4. 如果要向项目添加服务，请在问题提示处输入 `y` 并回答其余问题。 + +5. 成功保存 `MobileBasicProjectCLI` 后，浏览到 `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift` 文件夹。 + + +## 在 Xcode 中运行 Swift 项目 +{: #run_swift} + +1. 解压缩 `MobileBasicProject-Swift.zip` 文件。 + +2. 在 Markdown 查看器中打开 `README.md` 文件，以查看配置项目的步骤。 + + 1. 打开“终端”并浏览到项目文件夹。 + + 1. 如果需要设置 CocoaPods 存储库，请运行 `pod setup`。 + + 2. 如果需要更新现有 Pods，请运行 `pod update`。 + + 3. 运行 `pod install` 以安装项目所需的 Pods。 + + 3. 打开 `BasicProject.xcworkspace` Xcode 工作空间。 + +3. 运行应用程序。 + + +## 在 Xcode 中运行 Cordova 项目 +{: #run_cordova_xcode} + +1. 解压缩 `MobileBasicProject-Cordova.zip` 文件。 + +2. 在 Markdown 查看器中打开 `README.md` 文件，以配置项目。 + + 1. 在 Xcode 中打开 `platforms/ios` 项目。 + +3. 运行应用程序。 + + +## 在 Android Studio 中运行 Cordova 项目 +{: #run_cordova_studio} + +1. 解压缩 `BasicProject-Cordova.zip` 文件。 + +2. 在 Markdown 查看器中打开 `README.md` 文件，以配置项目。 + + 1. 在 Android Studio 中打开 `platforms/android` 项目。 + +3. 运行应用程序。 + + +## 在 Android Studio 中运行 Android 项目 +{: #run_android} + +1. 解压缩 `MobileBasicProject-Android.zip` 文件。 + +2. 在 Markdown 查看器中打开 `README.md` 文件，以配置项目。 + + 1. 在 Android Studio 中打开 `BasicProject-Android` 项目。 + +3. 运行应用程序。 diff --git a/cloudnative/nl/zh/CN/tutorial_web.md b/cloudnative/nl/zh/CN/tutorial_web.md index 76f9ecb32..aed86b652 100644 --- a/cloudnative/nl/zh/CN/tutorial_web.md +++ b/cloudnative/nl/zh/CN/tutorial_web.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Web 基本入门模板端到端教程 -{: #tutorial} - -以下端到端教程将引导您完成通过“Web 基本入门模板”创建项目的步骤（包括必须安装的工具）以及接下来运行项目代码的步骤。 - -## 安装开发者工具 -{: #dev_tools} - -请确保您已安装[必备开发者工具 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](get_code.html#prereq-dev-tools){: new_window}。 - - -## 使用 {{site.data.keyword.dev_console}} 创建项目 -{: #create-devex} - -1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中创建项目。 - - 1. 从 {{site.data.keyword.dev_console}} 中的**入门**页面，单击**创建项目**。 - - 或者，您可以从**项目**页面单击**创建项目**。 - - 2. 选择 **Web 应用程序**并单击**下一步**。 - - 3. 选择**基本 Web** 并单击**下一步**。 - - 4. 输入项目名称。对于本教程，请使用 `WebBasicProject`。 - - 5. 输入主机名。对于本教程，请使用 `devhost` - - 6. 选择语言平台。对于本教程，请使用 `Swift`。 - - 7. 单击**创建**。 - -2. 可选：添加数据功能。 - - 1. 在**项目概述**页面上，针对**数据**单击**查看**。 - - 或者，可在**功能 > 数据**页面上选择**创建**或**添加现有项**。 - - 2. 输入服务名称并单击**创建**。 - - -3. 生成项目代码。 - - 1. 单击**项目概述**页面上的**获取代码**，以选择语言。 - - 或者，您可以在**代码**页面上单击。 - - 2. 单击**生成代码**。 - - 3. 项目代码完成生成后，单击**下载代码**以下载项目归档。 - -4. 可选：[更新项目](project_overview_page.html#update_language)以生成新语言。 - - -## 使用 {{site.data.keyword.dev_cli_notm}} 创建项目 -{: #create-cli} - -1. 确保您已安装 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 - -2. 在“终端”提示符处，浏览到所选的本地目录并运行以下命令。 - - ``` - bx dev create - ``` - {: codeblock} - - -3. 在系统提示时提供以下值： - - * 选择模式：1 (Web) - * 选择入门模板：1（“基本 Web”） - * 选择语言：2 (Swift) - * 输入项目的名称：`WebBasicProjectCLI` - * 输入项目的主机名：`myhost` - -4. 如果要向项目添加服务，请在问题提示处输入 `y` 并回答其余问题。 - -5. 成功保存 `WebBasicProjectCLI` 项目后，浏览到 `WebBasicProjectCLI` 文件夹。 - -6. 添加您自己的代码，构建项目或运行项目。 - - 1. 使用以下命令构建项目： - - ``` - bx dev build - ``` - {: codeblock} - - 2. 使用以下命令运行项目： - - ``` - bx dev run - ``` - {: codeblock} - - -## 运行 Web 项目 -{: #run} - -### 本地 -{: #local notoc} - -1. 安装节点依赖关系： - - ``` - npm install - ``` - {: codeblock} - -2. 将前端代码绑定到模块： - - ``` - node_modules/.bin/gulp - ``` - {: codeblock} - -3. 编译服务器： - - ``` - swift build - ``` - {: codeblock} - -4. 运行应用程序： - - ``` - .build/debug/WebBasicProjectCLI - ``` - {: codeblock} - -5. 在浏览器中打开 `http://localhost:8080`。 - - -### 使用 {{site.data.keyword.dev_cli_short}} -{: #dev notoc} - -1. 安装节点依赖关系： - - ``` - npm install - ``` - {: codeblock} - -2. 将前端代码绑定到模块： - - ``` - gulp - ``` - {: codeblock} - -3. 运行编译： - - ``` - bx dev run - ``` - {: codeblock} - -4. 在浏览器中打开 `http://localhost:8080`。 - - -## 在 Xcode 中运行项目 -{: #Xcode} - -1. 创建 Xcode 项目。 - - 需要先使用 Swift 软件包管理器构建 Xcode 项目，然后才能使用 Xcode 进行开发。 - - ``` - swift project generate-xcodeproj - ``` - {: codeblock} - -2. 将活动目标更改为可执行对象： - - 然后，在 Xcode 中打开项目，确保活动目标可执行。您可以在单击下拉菜单时按住选项键，以选择所需的活动可执行对象。 - -3. 按**运行**。 - -4. 在浏览器中打开 `http://localhost:8080`。 - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Web 基本入门模板端到端教程 +{: #tutorial} + +以下端到端教程将引导您完成通过“Web 基本入门模板”创建项目的步骤（包括必须安装的工具）以及接下来运行项目代码的步骤。 + +## 安装开发者工具 +{: #dev_tools} + +请确保您已安装[必备开发者工具 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](get_code.html#prereq-dev-tools){: new_window}。 + + +## 使用 {{site.data.keyword.dev_console}} 创建项目 +{: #create-devex} + +1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中创建项目。 + + 1. 从 {{site.data.keyword.dev_console}} 中的**入门**页面，单击**创建项目**。 + + 或者，您可以从**项目**页面单击**创建项目**。 + + 2. 选择 **Web 应用程序**并单击**下一步**。 + + 3. 选择**基本 Web** 并单击**下一步**。 + + 4. 输入项目名称。对于本教程，请使用 `WebBasicProject`。 + + 5. 输入主机名。对于本教程，请使用 `devhost` + + 6. 选择语言平台。对于本教程，请使用 `Swift`。 + + 7. 单击**创建**。 + +2. 可选：添加数据功能。 + + 1. 在**项目概述**页面上，针对**数据**单击**查看**。 + + 或者，可在**功能 > 数据**页面上选择**创建**或**添加现有项**。 + + 2. 输入服务名称并单击**创建**。 + + +3. 生成项目代码。 + + 1. 单击**项目概述**页面上的**获取代码**，以选择语言。 + + 或者，您可以在**代码**页面上单击。 + + 2. 单击**生成代码**。 + + 3. 项目代码完成生成后，单击**下载代码**以下载项目归档。 + +4. 可选：[更新项目](project_overview_page.html#update_language)以生成新语言。 + + +## 使用 {{site.data.keyword.dev_cli_notm}} 创建项目 +{: #create-cli} + +1. 确保您已安装 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 + +2. 在“终端”提示符处，浏览到所选的本地目录并运行以下命令。 + + ``` + bx dev create + ``` + {: codeblock} + + +3. 在系统提示时提供以下值： + + * 选择模式：1 (Web) + * 选择入门模板：1（“基本 Web”） + * 选择语言：2 (Swift) + * 输入项目的名称：`WebBasicProjectCLI` + * 输入项目的主机名：`myhost` + +4. 如果要向项目添加服务，请在问题提示处输入 `y` 并回答其余问题。 + +5. 成功保存 `WebBasicProjectCLI` 项目后，浏览到 `WebBasicProjectCLI` 文件夹。 + +6. 添加您自己的代码，构建项目或运行项目。 + + 1. 使用以下命令构建项目： + + ``` + bx dev build + ``` + {: codeblock} + + 2. 使用以下命令运行项目： + + ``` + bx dev run + ``` + {: codeblock} + + +## 运行 Web 项目 +{: #run} + +### 本地 +{: #local notoc} + +1. 安装节点依赖关系： + + ``` + npm install + ``` + {: codeblock} + +2. 将前端代码绑定到模块： + + ``` + node_modules/.bin/gulp + ``` + {: codeblock} + +3. 编译服务器： + + ``` + swift build + ``` + {: codeblock} + +4. 运行应用程序： + + ``` + .build/debug/WebBasicProjectCLI + ``` + {: codeblock} + +5. 在浏览器中打开 `http://localhost:8080`。 + + +### 使用 {{site.data.keyword.dev_cli_short}} +{: #dev notoc} + +1. 安装节点依赖关系： + + ``` + npm install + ``` + {: codeblock} + +2. 将前端代码绑定到模块： + + ``` + gulp + ``` + {: codeblock} + +3. 运行编译： + + ``` + bx dev run + ``` + {: codeblock} + +4. 在浏览器中打开 `http://localhost:8080`。 + + +## 在 Xcode 中运行项目 +{: #Xcode} + +1. 创建 Xcode 项目。 + + 需要先使用 Swift 软件包管理器构建 Xcode 项目，然后才能使用 Xcode 进行开发。 + + ``` + swift project generate-xcodeproj + ``` + {: codeblock} + +2. 将活动目标更改为可执行对象： + + 然后，在 Xcode 中打开项目，确保活动目标可执行。您可以在单击下拉菜单时按住选项键，以选择所需的活动可执行对象。 + +3. 按**运行**。 + +4. 在浏览器中打开 `http://localhost:8080`。 + diff --git a/cloudnative/nl/zh/CN/tutorials.md b/cloudnative/nl/zh/CN/tutorials.md index aacb08031..63a458e3b 100644 --- a/cloudnative/nl/zh/CN/tutorials.md +++ b/cloudnative/nl/zh/CN/tutorials.md @@ -1,49 +1,49 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 端到端教程 -{: #tutorial} - -以下端到端教程将引导您完成通过 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 创建项目的步骤（包括必须安装的工具）以及接下来运行项目代码的步骤。 - -## Web -{: #web notoc} - -* [Web 基本教程](tutorial_web.html) - - -## Mobile -{: #mobile notoc} - -* [移动基本教程](tutorial_mobile.html) - - - - -## BFF -{: #bff notoc} - -* [BFF 基本教程](tutorial_bff.html) - - -## 微服务 -{: #microservice notoc} - -* [微服务基本教程](tutorial_microservice.html) +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 端到端教程 +{: #tutorial} + +以下端到端教程将引导您完成通过 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 创建项目的步骤（包括必须安装的工具）以及接下来运行项目代码的步骤。 + +## Web +{: #web notoc} + +* [Web 基本教程](tutorial_web.html) + + +## Mobile +{: #mobile notoc} + +* [移动基本教程](tutorial_mobile.html) + + + + +## BFF +{: #bff notoc} + +* [BFF 基本教程](tutorial_bff.html) + + +## 微服务 +{: #microservice notoc} + +* [微服务基本教程](tutorial_microservice.html) diff --git a/cloudnative/nl/zh/CN/what_is_new.md b/cloudnative/nl/zh/CN/what_is_new.md index 8a699cb39..95ce05cf4 100644 --- a/cloudnative/nl/zh/CN/what_is_new.md +++ b/cloudnative/nl/zh/CN/what_is_new.md @@ -1,97 +1,97 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 中的新增功能 -{: #what-is-new} - - -## 最新更新时间：2017 年 3 月 -{: #mar-2017} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 2017 年 3 月的更新引入了以下更改： - - * {{site.data.keyword.Bluemix_notm}} 移动仪表板现在为 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}。 - * 已重新设计项目创建，以便包含支持 Node.js、Java 和 Swift 的 Web 应用程序、BFF 和微服务服务器模式类型。 - * 与新的和改进的 {{site.data.keyword.appid_full}} 服务集成，为移动和 Web 项目提供认证。 - * 目前，还可以使用 [SDK Generator 插件](sdk_cli.html)生成项目的 SDK。仅可针对移动项目在 {{site.data.keyword.dev_console}} 中生成 SDK。 - * 现在，还可以使用 [{{site.data.keyword.dev_cli_short}}](dev_cli.html) 创建项目。 - - -## 最新更新时间：2017 年 1 月 -{: #jan-2017} - -{{site.data.keyword.Bluemix_notm}} Mobile 仪表板 2017 年 1 月的更新引进以下更改： - - * 从 1 月 31 开始，已废弃使用 UI 入门模板。通过 UI 入门模板创建的现有项目可以使用到 2017 年 4 月 30 日。有关迁移步骤和删除日期的更多信息，请参阅[废弃声明博客帖子 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/)。 -{: deprecated} - * 现在，可以更新项目入门模板类型而不是删除项目并创建新项目。 - * 现在，可以使用 [Watson Conversation](tutorial_conversation.html) 代码入门模板创建项目。 - * 支持时，现在可以为项目生成 SDK。 - * 现在，可以添加现有的[计算](sdk_compute.html)实例并生成客户端 SDK，以添加到您的项目。 - - -## 最新更新时间：2016 年 12 月 -{: #dec-2016} - -{{site.data.keyword.Bluemix_notm}} Mobile 仪表板 2016 年 12 月的更新引进以下更改： - - * 现在，可以从项目除去已连接的服务，以便其可删除或在其他项目中复用。 - * 现在，可以将现有服务添加到项目。 - * 现在，可以在使用代码入门模板时，作为数据源来创建或连接现有 CloudantNoSQL 服务。 - * 支持时，现在可以作为项目的数据源来创建或连接现有 Object Storage 服务。 - * 现在，可以定制您要使用 UI 入门模板创建的应用程序的导航设计。 - - -## 最新更新时间：2016 年 11 月 -{: #nov-2016} - -{{site.data.keyword.Bluemix_notm}} Mobile 仪表板 2016 年 11 月的更新引进以下更改： - - * 现在，您可以从**代码**页面生成项目的 SDK 工件。 - * Cordova 现在支持“基本代码入门模板”。 - * 现在，您可以在 {{site.data.keyword.mobileanalytics_short}} 的**网络请求**页面中，[报告网络事件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} 并[监视网络请求 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window}。 - * 现在，您可以在 {{site.data.keyword.mobileanalytics_short}} 控制台中，[将数据导出到 dashDB ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window}。 - - -## 最新更新时间：2016 年 10 月 -{: #oct-2016} - -{{site.data.keyword.Bluemix_notm}} Mobile 仪表板 2016 年 10 月的更新引进以下更改： - - * 现在，您可以直接从仪表板，向项目添加 {{site.data.keyword.mobilepushshort}} 和 Analytics 功能。 - * [代码入门模板](starters.html#Code_Starter)现在可用。 - * 可以向通过“代码入门模板”创建的项目添加 Authentication。 - * 现在支持 Swift。 - - -### Analytics -{: #analytics notoc} - - * 当您添加 Analytics 功能时，默认情况下会启用演示模式。您可以在运行应用程序后关闭演示模式，以查看您的分析。 - - -### UI 构建器 -{: #ui_builder notoc} - - * 现在，从项目可以访问 **{{site.data.keyword.mobilepushshort}}** 功能。 - * **项目设置**选项卡已重命名为**设置**选项卡。 - * **认证**选项卡已重命名为**用户访问权**选项卡。 - - -### 代码 -{: #code notoc} - - * 生成的适用于 iOS 的 Objective-C 和 Swift 代码现在使用 CocoaPods 来管理依赖关系。这表示您需要安装 CocoaPods。要安装它，请运行 `sudo gem install cocoapods`。安装 CocoaPods 之后，请运行 `pod setup` 以对其进行配置（如果尚未配置的话）。最后，运行 `pod install` 以下载并安装所需的项目依赖关系，然后在 Xcode 中打开 `.xcworkspace` 文件。在已下载代码归档的 `README.md` 文件中，可以找到其他详细信息。有关更多信息，请阅读[必备开发者工具](get_code.html#prereq-dev-tools)。 - -经常回顾以及时了解新更新。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 中的新增功能 +{: #what-is-new} + + +## 最新更新时间：2017 年 3 月 +{: #mar-2017} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 2017 年 3 月的更新引入了以下更改： + + * {{site.data.keyword.Bluemix_notm}} 移动仪表板现在为 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}。 + * 已重新设计项目创建，以便包含支持 Node.js、Java 和 Swift 的 Web 应用程序、BFF 和微服务服务器模式类型。 + * 与新的和改进的 {{site.data.keyword.appid_full}} 服务集成，为移动和 Web 项目提供认证。 + * 目前，还可以使用 [SDK Generator 插件](sdk_cli.html)生成项目的 SDK。仅可针对移动项目在 {{site.data.keyword.dev_console}} 中生成 SDK。 + * 现在，还可以使用 [{{site.data.keyword.dev_cli_short}}](dev_cli.html) 创建项目。 + + +## 最新更新时间：2017 年 1 月 +{: #jan-2017} + +{{site.data.keyword.Bluemix_notm}} Mobile 仪表板 2017 年 1 月的更新引进以下更改： + + * 从 1 月 31 开始，已废弃使用 UI 入门模板。通过 UI 入门模板创建的现有项目可以使用到 2017 年 4 月 30 日。有关迁移步骤和删除日期的更多信息，请参阅[废弃声明博客帖子 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/)。 +{: deprecated} + * 现在，可以更新项目入门模板类型而不是删除项目并创建新项目。 + * 现在，可以使用 [Watson Conversation](tutorial_conversation.html) 代码入门模板创建项目。 + * 支持时，现在可以为项目生成 SDK。 + * 现在，可以添加现有的[计算](sdk_compute.html)实例并生成客户端 SDK，以添加到您的项目。 + + +## 最新更新时间：2016 年 12 月 +{: #dec-2016} + +{{site.data.keyword.Bluemix_notm}} Mobile 仪表板 2016 年 12 月的更新引进以下更改： + + * 现在，可以从项目除去已连接的服务，以便其可删除或在其他项目中复用。 + * 现在，可以将现有服务添加到项目。 + * 现在，可以在使用代码入门模板时，作为数据源来创建或连接现有 CloudantNoSQL 服务。 + * 支持时，现在可以作为项目的数据源来创建或连接现有 Object Storage 服务。 + * 现在，可以定制您要使用 UI 入门模板创建的应用程序的导航设计。 + + +## 最新更新时间：2016 年 11 月 +{: #nov-2016} + +{{site.data.keyword.Bluemix_notm}} Mobile 仪表板 2016 年 11 月的更新引进以下更改： + + * 现在，您可以从**代码**页面生成项目的 SDK 工件。 + * Cordova 现在支持“基本代码入门模板”。 + * 现在，您可以在 {{site.data.keyword.mobileanalytics_short}} 的**网络请求**页面中，[报告网络事件 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} 并[监视网络请求 ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window}。 + * 现在，您可以在 {{site.data.keyword.mobileanalytics_short}} 控制台中，[将数据导出到 dashDB ![外部链接图标](../icons/launch-glyph.svg "外部链接图标")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window}。 + + +## 最新更新时间：2016 年 10 月 +{: #oct-2016} + +{{site.data.keyword.Bluemix_notm}} Mobile 仪表板 2016 年 10 月的更新引进以下更改： + + * 现在，您可以直接从仪表板，向项目添加 {{site.data.keyword.mobilepushshort}} 和 Analytics 功能。 + * [代码入门模板](starters.html#Code_Starter)现在可用。 + * 可以向通过“代码入门模板”创建的项目添加 Authentication。 + * 现在支持 Swift。 + + +### Analytics +{: #analytics notoc} + + * 当您添加 Analytics 功能时，默认情况下会启用演示模式。您可以在运行应用程序后关闭演示模式，以查看您的分析。 + + +### UI 构建器 +{: #ui_builder notoc} + + * 现在，从项目可以访问 **{{site.data.keyword.mobilepushshort}}** 功能。 + * **项目设置**选项卡已重命名为**设置**选项卡。 + * **认证**选项卡已重命名为**用户访问权**选项卡。 + + +### 代码 +{: #code notoc} + + * 生成的适用于 iOS 的 Objective-C 和 Swift 代码现在使用 CocoaPods 来管理依赖关系。这表示您需要安装 CocoaPods。要安装它，请运行 `sudo gem install cocoapods`。安装 CocoaPods 之后，请运行 `pod setup` 以对其进行配置（如果尚未配置的话）。最后，运行 `pod install` 以下载并安装所需的项目依赖关系，然后在 Xcode 中打开 `.xcworkspace` 文件。在已下载代码归档的 `README.md` 文件中，可以找到其他详细信息。有关更多信息，请阅读[必备开发者工具](get_code.html#prereq-dev-tools)。 + +经常回顾以及时了解新更新。 diff --git a/cloudnative/nl/zh/TW/cli.md b/cloudnative/nl/zh/TW/cli.md index 68f4ec9c6..21fc456a8 100644 --- a/cloudnative/nl/zh/TW/cli.md +++ b/cloudnative/nl/zh/TW/cli.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.Bluemix_notm}} CLI 的外掛程式 -{: #cli} - -下列外掛程式可以新增至 {{site.data.keyword.Bluemix}} CLI。您可以使用這些外掛程式來建立 {{site.data.keyword.dev_console}} 專案。 - -* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) -* [{{site.data.keyword.IBM_notm}} SDK 產生器外掛程式](sdk_cli.html) +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.Bluemix_notm}} CLI 的外掛程式 +{: #cli} + +下列外掛程式可以新增至 {{site.data.keyword.Bluemix}} CLI。您可以使用這些外掛程式來建立 {{site.data.keyword.dev_console}} 專案。 + +* [{{site.data.keyword.dev_cli_long}}](dev_cli.html) +* [{{site.data.keyword.IBM_notm}} SDK 產生器外掛程式](sdk_cli.html) diff --git a/cloudnative/nl/zh/TW/compute.md b/cloudnative/nl/zh/TW/compute.md index d2e8e40e7..5bfc041e8 100644 --- a/cloudnative/nl/zh/TW/compute.md +++ b/cloudnative/nl/zh/TW/compute.md @@ -1,181 +1,181 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 運算 -{: #compute} - -當您針對 Web 及行動建置雲端原生數位通道應用程式時，最佳作法是具備 Backend for Frontend (BFF)，其專用於數位通道，或針對 Web 及行動用戶端應用程式提供相同的資料及邏輯整合支援。如需此架構的相關資訊，請參閱[適用於 Web 及行動的微服務 ![外部鏈結圖示](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture)。 - -下圖顯示 BFF 架構概觀。 - -![BFF 架構](images/bff-arch.png) - -圖 1：BFF 架構 - -BFF 的概念是摘錄自微服務或高價值 {{site.data.keyword.Bluemix}} 雲端服務的一般商業邏輯及整合邏輯。 - -使用此架構，您可以部署及釋放行動或 Web 應用程式的更新，以及搭配使用持續交付管線與開發作業服務來部署新版本的 BFF。 - -如果您有一個適用於 iOS 的 BFF 以及另一個適用於 Android 的 BFF，交付這些應用程式的功能的工程團隊不會受限於集中化 API 釋放排程的釋放特性。這是微服務及數位通道架構的一般目標 - 讓團隊經常釋放功能及特性，而不需要緊密連結另一個團隊的釋放排程。 - - - - -## 整合行動用戶端與 Backend for Frontend -{: #integration} - -為了啟用行動用戶端與 BFF 之間的輕鬆整合，{{site.data.keyword.Bluemix_notm}} 分別以 Swift 及 Java 語言支援適用於 iOS 及 Android 的行動用戶端 SDK 產生。若要啟用此特性，您必須使用 Open API 規格 (Swagger) 文件來公開 BFF 整合。此文件可以採用 JSON 或 YAML 格式。 - -用戶端 SDK 產生器使用 Open API 定義檔，來定義在原生行動應用程式中輕鬆使用的用戶端最佳化的開發人員 SDK。它將加速 BFF 與行動應用程式的整合。 - - -## 定義 API -{: #definition} - -BFF 需要公開符合即時伺服器端點上所執行之 Open API 規格的 API 定義檔。若要啟用「{{site.data.keyword.Bluemix_notm}} 開發人員體驗」及 {{site.data.keyword.Bluemix_notm}} SDK CLI（指令行介面）來探索此端點，您必須將環境變數新增至稱為 `OPENAPI_SPEC` 的 Cloud Foundry 應用程式。此環境變數必須參照使用相對路徑的規格。 - -若要在 {{site.data.keyword.Bluemix_notm}} 中新增 `OPENAPI_SPEC` 環境變數，請遵循下列步驟： - -1. 登入 [{{site.data.keyword.Bluemix_notm}} ![外部鏈結圖示](../icons/launch-glyph.svg)](http://bluemix.net)。 -2. 選取 Cloud Foundry 應用程式。 -3. 選取**運行環境**。 -4. 選取**環境變數**。 -5. 按一下**使用者定義**區段中的**新增**。 -6. 在**名稱**中指定 `OPENAPI_SPEC`，並指定 Open API 定義檔的相對 URL 路徑。 -7. 按一下**儲存**。 - - - -例如： - -``` -OPENAPI_SPEC='/explorer/swagger.json' -``` -{: codeblock} - -{{site.data.keyword.apiconnect_long}} 及 Loopback 應用程式特別適合使用此方式。您可以使用 Loopback 及 {{site.data.keyword.apiconnect_short}} 來定義持續性模型，以及使用 Open API 定義檔來公開 CRUD（建立、讀取、更新及刪除）作業。 - -您也可以定義商業邏輯作業。 - - -### Open API 規格的支援元素 -{: #supported-elements notoc} - -Open API 規格中唯一未完全支援的部分是檔案結構。此規格容許將定義的各部分分割為不同檔案，並使用 json `$ref` 欄位予以參照。您的整個定義必須包含在一個檔案內。 - - -## 使用 Bluegen 的 Backend for Frontend 範例 -{: #bff-bluegen} - -{{site.data.keyword.Bluemix_notm}} 已使用 {{site.data.keyword.apiconnect_short}} 及 Strongloop 來建立參照 BFF（這會將產品模型對映至 {{site.data.keyword.cloudant}}），以及建立用於參照 {{site.data.keyword.objectstorageshort}} 中映像檔的映像檔 API。 - -您可以使用此 BFF 型樣，快速開始將完全運作的 BFF 佈建至 {{site.data.keyword.Bluemix_notm}}，以及使用它協助瞭解將 BFF 整合至行動專案並分別以 Swift 及 Java 產生適用於 iOS 及 Android 的原生 SDK 是多麼簡單。 - -請遵循 [README ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) 指示來建立並安裝專案。 - - -## 搭配使用 Backend for Frontend 與開發人員體驗專案 -{: #bff-devex} - -「{{site.data.keyword.Bluemix_notm}} 行動開發人員體驗」的設計目的是要簡化定義具有許多相關聯雲端服務的行動專案。您可以輕鬆地新增 [{{site.data.keyword.mobilepushshort}} ![外部鏈結圖示](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html)、[分析 ![外部鏈結圖示](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html)，以及資料或儲存空間服務。 - -{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 引進在**運算**頁面中將 BFF 整合至行動專案的能力。您可以將現有「運算」服務實例新增至行動專案。新增之後，即可針對您選擇的語言來產生原生 SDK，也可以產生完整專案，以及在**程式碼**頁面中，將 SDK 整合至專案的來源套件。這特別適用於與已明確定義之 BFF 的整合。 - -下載專案之後，即可使用 Xcode 或 Android Studio 來開啟它，以及使用用戶端 SDK 來編譯專案。 - - -## 使用 CLI -{: #cli} - -開發 BFF 時，API 規格可能會變更。若要支援這些變更，您有下列兩個選項。 - -* 將整個專案重新產生成新的 GitHub 分支，並將變更合併為開發分支。 -* 使用指令行 (CLI) 工具直接重新產生 SDK，並且只更新行動專案的 SDK 部分。 - -若要使用 CLI，您必須予以[安裝](sdk_cli.html#installation)。 - -使用下列指令，以列出您可執行的動作。 - -``` -bluemix sdk -``` -{: codeblock} - -使用下列指令，以列出現行 {{site.data.keyword.Bluemix_notm}} 空間中的執行中 Cloud Foundry 實例。 - -``` -bluemix sdk list -``` -{: codeblock} - -如果設定 `OPENAPI_SPEC` 環境變數，則會列出每一個應用程式，並驗證 API。在 `VALID` 直欄中，您會看到綠色勾號或紅色 `X`。應用程式之 `VALID` 直欄中的勾號表示具有有效的 Open API 定義。應用程式之 `VALID` 直欄中的 `X` 表示下列兩個事項之一： - -* 未定義應用程式的 `OPENAPI_SPEC` 環境變數，或者 -* 對於 Open API 規格，API 定義無效 - -使用下列指令，以檢視 API 的形式完整 URL。會列出 API 規格的形式完整路徑及 URI。您可以在瀏覽器中檢視原始規格、在 CLI 中直接使用它，或驗證已正確地設定 BFF `OPENAPI_SPEC` 環境變數。 - -``` -bluemix sdk list --url -``` -{: codeblock} - -使用下列指令，以驗證 `` 的 Open API 定義檔來判斷是否可以使用它來產生 SDK。此指令會在您的現行空間中尋找 ``，並在 `OPENAPI_SPEC` 環境變數中使用相對路徑來尋找進行驗證的規格。 - -``` -bluemix sdk validate -``` -{: codeblock} - -使用下列指令，以產生適用於您所選擇之原生 `` 的 SDK，並將壓縮檔放入現行工作目錄。 - -``` -bluemix sdk generate -- -``` -{: codeblock} - -使用 `--unzip` 選項會將 SDK 自動解壓縮至現行工作目錄。您可以選擇性地使用 `--output` 選項指定用來解壓縮 SDK 的位置。您可以使用 GitHub 管理原始碼，並建立專門用來更新 SDK 的新分支。使用此方式可以更輕鬆地檢視已更新 SDK 中的變更，並將其合併至開發分支。 - - -## 使用 SDK 產生的模型及 API -{: #models-apis} - -既然已使用產生的 SDK 將您的 BFF 整合至行動應用程式，您就可以開始使用。 - -SDK 在 `docs` 目錄及 `source` 目錄中隨附完整的產生文件。您可以開啟 `README.html` 檔案以取得文件的 Web 視圖，或開啟 `README.md` 檔案以取得文件的 Markdown 視圖。將 SDK 發佈至 Cocoapods 或 Maven Central 時，Markdown 文件十分有用。 - -在本文件內，您可以看到產生的 API 清單。您可以按一下 API 來查看可直接貼入行動應用程式的程式碼 Snippet。 +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 運算 +{: #compute} + +當您針對 Web 及行動建置雲端原生數位通道應用程式時，最佳作法是具備 Backend for Frontend (BFF)，其專用於數位通道，或針對 Web 及行動用戶端應用程式提供相同的資料及邏輯整合支援。如需此架構的相關資訊，請參閱[適用於 Web 及行動的微服務 ![外部鏈結圖示](../icons/launch-glyph.svg)](https://www.ibm.com/devops/method/content/architecture/omnichannelArchitecture)。 + +下圖顯示 BFF 架構概觀。 + +![BFF 架構](images/bff-arch.png) + +圖 1：BFF 架構 + +BFF 的概念是摘錄自微服務或高價值 {{site.data.keyword.Bluemix}} 雲端服務的一般商業邏輯及整合邏輯。 + +使用此架構，您可以部署及釋放行動或 Web 應用程式的更新，以及搭配使用持續交付管線與開發作業服務來部署新版本的 BFF。 + +如果您有一個適用於 iOS 的 BFF 以及另一個適用於 Android 的 BFF，交付這些應用程式的功能的工程團隊不會受限於集中化 API 釋放排程的釋放特性。這是微服務及數位通道架構的一般目標 - 讓團隊經常釋放功能及特性，而不需要緊密連結另一個團隊的釋放排程。 + + + + +## 整合行動用戶端與 Backend for Frontend +{: #integration} + +為了啟用行動用戶端與 BFF 之間的輕鬆整合，{{site.data.keyword.Bluemix_notm}} 分別以 Swift 及 Java 語言支援適用於 iOS 及 Android 的行動用戶端 SDK 產生。若要啟用此特性，您必須使用 Open API 規格 (Swagger) 文件來公開 BFF 整合。此文件可以採用 JSON 或 YAML 格式。 + +用戶端 SDK 產生器使用 Open API 定義檔，來定義在原生行動應用程式中輕鬆使用的用戶端最佳化的開發人員 SDK。它將加速 BFF 與行動應用程式的整合。 + + +## 定義 API +{: #definition} + +BFF 需要公開符合即時伺服器端點上所執行之 Open API 規格的 API 定義檔。若要啟用「{{site.data.keyword.Bluemix_notm}} 開發人員體驗」及 {{site.data.keyword.Bluemix_notm}} SDK CLI（指令行介面）來探索此端點，您必須將環境變數新增至稱為 `OPENAPI_SPEC` 的 Cloud Foundry 應用程式。此環境變數必須參照使用相對路徑的規格。 + +若要在 {{site.data.keyword.Bluemix_notm}} 中新增 `OPENAPI_SPEC` 環境變數，請遵循下列步驟： + +1. 登入 [{{site.data.keyword.Bluemix_notm}} ![外部鏈結圖示](../icons/launch-glyph.svg)](http://bluemix.net)。 +2. 選取 Cloud Foundry 應用程式。 +3. 選取**運行環境**。 +4. 選取**環境變數**。 +5. 按一下**使用者定義**區段中的**新增**。 +6. 在**名稱**中指定 `OPENAPI_SPEC`，並指定 Open API 定義檔的相對 URL 路徑。 +7. 按一下**儲存**。 + + + +例如： + +``` +OPENAPI_SPEC='/explorer/swagger.json' +``` +{: codeblock} + +{{site.data.keyword.apiconnect_long}} 及 Loopback 應用程式特別適合使用此方式。您可以使用 Loopback 及 {{site.data.keyword.apiconnect_short}} 來定義持續性模型，以及使用 Open API 定義檔來公開 CRUD（建立、讀取、更新及刪除）作業。 + +您也可以定義商業邏輯作業。 + + +### Open API 規格的支援元素 +{: #supported-elements notoc} + +Open API 規格中唯一未完全支援的部分是檔案結構。此規格容許將定義的各部分分割為不同檔案，並使用 json `$ref` 欄位予以參照。您的整個定義必須包含在一個檔案內。 + + +## 使用 Bluegen 的 Backend for Frontend 範例 +{: #bff-bluegen} + +{{site.data.keyword.Bluemix_notm}} 已使用 {{site.data.keyword.apiconnect_short}} 及 Strongloop 來建立參照 BFF（這會將產品模型對映至 {{site.data.keyword.cloudant}}），以及建立用於參照 {{site.data.keyword.objectstorageshort}} 中映像檔的映像檔 API。 + +您可以使用此 BFF 型樣，快速開始將完全運作的 BFF 佈建至 {{site.data.keyword.Bluemix_notm}}，以及使用它協助瞭解將 BFF 整合至行動專案並分別以 Swift 及 Java 產生適用於 iOS 及 Android 的原生 SDK 是多麼簡單。 + +請遵循 [README ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/backend-for-frontend-node) 指示來建立並安裝專案。 + + +## 搭配使用 Backend for Frontend 與開發人員體驗專案 +{: #bff-devex} + +「{{site.data.keyword.Bluemix_notm}} 行動開發人員體驗」的設計目的是要簡化定義具有許多相關聯雲端服務的行動專案。您可以輕鬆地新增 [{{site.data.keyword.mobilepushshort}} ![外部鏈結圖示](../icons/launch-glyph.svg)](/docs/services/mobilepush/index.html)、[分析 ![外部鏈結圖示](../icons/launch-glyph.svg)](/docs/services/mobileanalytics/index.html)，以及資料或儲存空間服務。 + +{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 引進在**運算**頁面中將 BFF 整合至行動專案的能力。您可以將現有「運算」服務實例新增至行動專案。新增之後，即可針對您選擇的語言來產生原生 SDK，也可以產生完整專案，以及在**程式碼**頁面中，將 SDK 整合至專案的來源套件。這特別適用於與已明確定義之 BFF 的整合。 + +下載專案之後，即可使用 Xcode 或 Android Studio 來開啟它，以及使用用戶端 SDK 來編譯專案。 + + +## 使用 CLI +{: #cli} + +開發 BFF 時，API 規格可能會變更。若要支援這些變更，您有下列兩個選項。 + +* 將整個專案重新產生成新的 GitHub 分支，並將變更合併為開發分支。 +* 使用指令行 (CLI) 工具直接重新產生 SDK，並且只更新行動專案的 SDK 部分。 + +若要使用 CLI，您必須予以[安裝](sdk_cli.html#installation)。 + +使用下列指令，以列出您可執行的動作。 + +``` +bluemix sdk +``` +{: codeblock} + +使用下列指令，以列出現行 {{site.data.keyword.Bluemix_notm}} 空間中的執行中 Cloud Foundry 實例。 + +``` +bluemix sdk list +``` +{: codeblock} + +如果設定 `OPENAPI_SPEC` 環境變數，則會列出每一個應用程式，並驗證 API。在 `VALID` 直欄中，您會看到綠色勾號或紅色 `X`。應用程式之 `VALID` 直欄中的勾號表示具有有效的 Open API 定義。應用程式之 `VALID` 直欄中的 `X` 表示下列兩個事項之一： + +* 未定義應用程式的 `OPENAPI_SPEC` 環境變數，或者 +* 對於 Open API 規格，API 定義無效 + +使用下列指令，以檢視 API 的形式完整 URL。會列出 API 規格的形式完整路徑及 URI。您可以在瀏覽器中檢視原始規格、在 CLI 中直接使用它，或驗證已正確地設定 BFF `OPENAPI_SPEC` 環境變數。 + +``` +bluemix sdk list --url +``` +{: codeblock} + +使用下列指令，以驗證 `` 的 Open API 定義檔來判斷是否可以使用它來產生 SDK。此指令會在您的現行空間中尋找 ``，並在 `OPENAPI_SPEC` 環境變數中使用相對路徑來尋找進行驗證的規格。 + +``` +bluemix sdk validate +``` +{: codeblock} + +使用下列指令，以產生適用於您所選擇之原生 `` 的 SDK，並將壓縮檔放入現行工作目錄。 + +``` +bluemix sdk generate -- +``` +{: codeblock} + +使用 `--unzip` 選項會將 SDK 自動解壓縮至現行工作目錄。您可以選擇性地使用 `--output` 選項指定用來解壓縮 SDK 的位置。您可以使用 GitHub 管理原始碼，並建立專門用來更新 SDK 的新分支。使用此方式可以更輕鬆地檢視已更新 SDK 中的變更，並將其合併至開發分支。 + + +## 使用 SDK 產生的模型及 API +{: #models-apis} + +既然已使用產生的 SDK 將您的 BFF 整合至行動應用程式，您就可以開始使用。 + +SDK 在 `docs` 目錄及 `source` 目錄中隨附完整的產生文件。您可以開啟 `README.html` 檔案以取得文件的 Web 視圖，或開啟 `README.md` 檔案以取得文件的 Markdown 視圖。將 SDK 發佈至 Cocoapods 或 Maven Central 時，Markdown 文件十分有用。 + +在本文件內，您可以看到產生的 API 清單。您可以按一下 API 來查看可直接貼入行動應用程式的程式碼 Snippet。 diff --git a/cloudnative/nl/zh/TW/dev_cli.md b/cloudnative/nl/zh/TW/dev_cli.md index 1e26a1e31..49e2ade7e 100644 --- a/cloudnative/nl/zh/TW/dev_cli.md +++ b/cloudnative/nl/zh/TW/dev_cli.md @@ -1,404 +1,404 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# {{site.data.keyword.dev_cli_short}} -{: #developercli} - -{{site.data.keyword.dev_cli_long}} 提供一種可延伸的指令驅動方式，以使用 `dev` 外掛程式來建立、開發及部署 Web 專案。最理想的狀況是，開發人員在開發端對端微服務應用程式的同時使用指令行控制。 - -{: shortdesc} - -{{site.data.keyword.dev_cli_notm}} 使用兩個容器來協助建置及測試應用程式。第一個是 tools 容器，內含建置及測試應用程式的必要公用程式。此容器的 Dockerfile 是透過 [dockerfile-tools](#command-parameters) 參數所定義。您可以將它視為開發容器，因為它包含的工具一般適用於開發特定運行環境。 - -第二個容器是 run 容器。例如，此容器的形式適用於部署在 {{site.data.keyword.Bluemix}} 中使用。因此，此容器一般會定義可啟動您應用程式的進入點。當您選擇透過 {{site.data.keyword.dev_cli_short}} 來執行應用程式時，它會使用此容器。此容器的 Dockerfile 是透過 [dockerfile-run](#run-parameters) 參數所定義。 - - -## 新增 {{site.data.keyword.dev_cli_notm}} -{: #add-cli} - - -### 必要條件 -{: #prereq} - -需要有一些必要條件才能完整地探索及適當地利用 {{site.data.keyword.dev_cli_short}}，因為它可高度延伸，並可讓您運用其他增補技術。 - -1. 安裝 [Cloud Foundry CLI ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/cloudfoundry/cli#getting-started)。 - -2. 安裝 [{{site.data.keyword.Bluemix}} CLI ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://clis.ng.bluemix.net/ui/home.html)。 - -3. 取得 [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net) ID。 - -4. 選用項目：如果您打算在本端執行及除錯應用程式，則也必須安裝 [Docker ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.docker.com/get-docker)。 只有針對非行動專案，這才是必要項目。 - - -### 安裝 -{: #installation} - -1. 執行下列指令，以安裝 [{{site.data.keyword.dev_cli_short}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window}： - - ``` - bx plugin install dev -r Bluemix - ``` - {: codeblock} - -2. 執行下列指令，以驗證安裝成功： - - ``` - bx dev - ``` - {: codeblock} - - -### 開始之前 -{: #before-install} - -1. 登入 {{site.data.keyword.Bluemix_notm}}。 - - ``` - bx login - ``` - {: codeblock} - - **附註：**如果您的認證遭到拒絕，則可以使用「聯合 ID」。請遵循下列步驟，以使用「聯合 ID」來進行鑑別。 - - - - 1. 登入 [{{site.data.keyword.iamshort}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.bluemix.net/iam/#/apikeys){: new_window}。 - 2. 選取**建立 API 金鑰**。 - * 輸入 apiKey 名稱及說明 - 3. 下載 apiKey。 - 4. 開啟檔案，並複製 `apiKey` 欄位中的值。 - 5. 使用下列指令來登入： - - ``` - bx login --apikey - ``` - {: codeblock} - - -## 指令 -{: #commands} - -使用下列指令，以建立、部署、除錯及測試專案。 - -### Build -{: #build} - -您可以使用 `build` 指令來建置應用程式。`build-cmd-run` 配置元素是用來建置應用程式。在正常作業期間，`test`、`debug` 及 `run` 指令都會使用與此指令相同的方式來執行建置，因此不需要在這些指令之前執行該指令。 - -在現行專案目錄中執行下列指令，以建置您的應用程式： - -``` -bx dev build -``` -{: codeblock} - - -[Build 指令參數](#command-parameters) - - -### Code -{: #code} - -`code` 指令可讓您在部署之後下載應用程式碼，因此，您可以在本端進行檢閱或進行其他變更。 - -執行下列指令，以從指定的專案下載程式碼。 - -``` -bx dev code -``` -{: codeblock} - - -### Create -{: #create} - -提示輸入所有必要資訊（包括語言、專案名稱及應用程式型樣類型），以建立新的專案。將會在現行目錄中建立專案。 - -若要在現行專案目錄中建立新專案，並建立服務與它的關聯，請執行下列指令： - -``` -bx dev create -``` -{: codeblock} - - -### Debug -{: #debug} - -您可以透過 `debug` 指令來除錯應用程式。會先使用與建置指示相同的 `build-cmd-debug` 配置元素，來完成專案的建置。接著會啟動容器，公開 `container-port-map-debug` 中所定義的除錯埠。請將最愛的除錯工具連接至埠，以如常除錯應用程式。 - -**限制**：目前無法對 Swift 專案進行除錯。 - -在現行專案目錄中執行下列指令，以除錯您的應用程式： - -``` -bx dev debug -``` -{: codeblock} - -若要結束除錯階段作業，請使用 `CTRL-C`。 - - -#### Debug 指令參數 -{: #debug-parameters} - -下列參數是 `debug` 指令特有的，可協助除錯應用程式。 - -##### `container-port-map-debug` -{: #port-map-debug} - -* 除錯埠的埠對映。第一個值是在主機 OS 中使用的埠，第二個則是容器 (host:container) 中的埠。 -* 用法：`bx dev debug container-port-map-debug [7777:7777]` - -##### `build-cmd-debug` -{: #build-cmd-debug} - -* 用來建置程式碼，以進行除錯。 -* 用法：`bx dev debug build-cmd-debug build.command.sh` - -##### `debug-cmd` -{: #debug-cmd} - -* 用來除錯 tools 容器中的程式碼。如果您的 `build-cmd-debug` 將以除錯模式啟動應用程式，則這是選用項目。 -* 用法：`bx dev debug debug-cmd /the/debug/command` - -#### 本端應用程式除錯： -{: #local-app-dev} - -如需本端應用程式除錯的相關資訊，請參閱[本端應用程式除錯](docs/cloudnative/dev_cli_local_debug.html#local-debug)。 - - -### Delete -{: #delete} - -此指令可讓您移除 {{site.data.keyword.Bluemix}} 空間中的專案。 - -執行下列指令，以刪除 {{site.data.keyword.Bluemix}} 中的專案： - -``` -bx dev delete -``` -{: codeblock} - - -**附註**：**不會**移除 {{site.data.keyword.Bluemix}} 服務。 - - -### Help -{: #help} - -依預設，如果未傳入動作或引數，或是提供 'help' 動作，則此指令將會顯示一般「說明」文字。所顯示的一般說明會包括基礎引數的說明，以及可用動作清單。 - -執行下列指令，以顯示一般說明資訊： - -``` -bx dev help -``` -{: codeblock} - - -### List -{: #list} - -您可以列出空間中的所有 {{site.data.keyword.Bluemix_notm}} 專案。 - -執行下列指令，以列出您的專案： - -``` -bx dev list -``` -{: codeblock} - - - - - -### Run -{: #run} - -您可以透過 `run` 指令來執行應用程式。會先使用與建置指示相同的 `build-cmd-run` 配置元素，來完成專案的建置。接著會啟動 run 容器，公開 `container-port-map` 中所定義的埠。如果 run 容器未包含完成此步驟的進入點，則可以使用 `run-cmd` 來呼叫應用程式。 - -在現行專案目錄中執行下列指令，以啟動您的應用程式： - -``` -bx dev run -``` -{: codeblock} - -若要結束階段作業，請使用 `CTRL-C`。 - - -#### Run 參數 -{: #run-parameters} - -下列參數是 `run` 指令特有的，可協助管理 run 容器內的應用程式。 - -##### `container-name-run` -{: #container-name-run} - -* run 容器的容器名稱。 -* 用法：`bx dev run container-name-run ` - -##### `container-path-run` -{: #container-path-run} - -* 執行時，容器中要共用的位置。 -* 用法：`bx dev run container-path-run [/path/to/app]` - -##### `host-path-run` -{: #host-path-run} - -* 執行時，主機系統上容器中要共用的位置。 -* 用法：`bx dev run host-path-run [/path/to/app/bin]` - -##### `dockerfile-run` -{: #dockerfile-run} - -* run 容器的 Docker 檔案。 -* 用法：`bx dev run dockerfile-run [/path/to/Dockerfile.yml]` - -##### `image-name-run` -{: #image-name-run} - -* 要從 dockerfile-run 建立的映像檔。 -* 用法：`bx dev run image-name-run [/path/to/image-name]` - -##### `run-cmd` -{: #run-cmd} - -* 用來在 run 容器中執行程式碼的選用參數。如果您的映像檔將會啟動應用程式，則這是選用項目。 -* 用法：`bx dev run run-cmd [/the/run/command]` - -### Status -{: #status} - -您可以查詢 `container-name-run` 及 `container-name-tools` 所定義之 {{site.data.keyword.dev_cli_short}} 使用的容器的狀態。 - -在現行專案目錄中執行下列指令，以檢查容器狀態： - -``` -bx dev status -``` -{: codeblock} - - -[Status 指令參數](#command-parameters) - - -### Stop -{: #stop} - -您可以透過 `stop` 指令來停止容器。`container-name` 參數可讓您指定要停止的容器。如果未指定這個項目，則 stop 指令會停止 `container-name-run` 所定義的 run 容器。 - -在現行專案目錄中執行下列指令，以停止容器： - -``` -bx dev stop -``` -{: codeblock} - - -#### 其他 stop 參數： -{: #stop-parameter} - -##### `container-name` -{: #container-name} - -* tools 容器的容器名稱。 -* 用法：`bx dev stop container-name ` - -### Test -{: #test} - -您可以透過 `test` 指令來測試應用程式。會先使用與建置指示相同的 `build-cmd-run` 配置元素，來完成專案的建置。接著會使用 tools 容器，針對應用程式呼叫 `test-cmd`。 - -執行下列指令，以測試應用程式： - -``` -bx dev test -``` -{: codeblock} - - -[Test 指令參數](#command-parameters) - - -## build、debug、run 及 test 的參數 -{: #command-parameters} - -下列參數可以與 `build|debug|run|test` 指令搭配使用，並且可以透過指令行以及（或）直接更新專案的 `cli-config.yml` 檔案來指定。其他參數適用於 [`debug`](#debug-parameters) 及 [`run`](#run-parameters) 指令，並且記載於其個別小節中。 - -**附註**：在指令行上輸入的指令參數，其優先順序高於 `cli-config.yml` 配置。 - -##### `container-name-tools` -{: #container-name-tools} - -* tools 容器的容器名稱。 -* 用法：`bx dev container-name-tools []` - -##### `host-path-tools` -{: #host-path-tools} - -* 主機上基於建置、除錯、測試而共用的位置。 -* 用法：`bx dev host-path-tools [/path/to/build/tools]` - -##### `container-path-tools` -{: #container-path-tools} - -* 容器中基於建置、除錯、測試而共用的位置。 -* 用法：`bx dev container-path-tools [/path/for/build]` - -##### `container-port-map` -{: #container-port-map} - -* 容器的埠對映。第一個值是在主機 OS 中使用的埠，第二個則是容器 (host:container) 中的埠。 -* 用法：`bx dev container-port-map [8090:8090,9090,9090]` - -##### `dockerfile-tools` -{: #dockerfile-tools} - -* tools 容器的 Docker 檔案。 -* 用法：`bx dev dockerfile-tools [path/to/dockerfile]` - -##### `image-name-tools` -{: #image-name-tools} - -* 要從 dockerfile-tools 建立的映像檔。 -* 用法：`bx dev image-name-tools [path/to/image-name]` - -##### `build-cmd-run` -{: #build-cmd-run} - -* 基於所有使用而建置程式碼的指令，但「除錯」除外。 -* 用法：`bx dev build-cmd-run [some.build.command]` - -##### `test-cmd` -{: #test-cmd} - -* 測試 tools 容器中程式碼的指令。 -* 用法：`bx dev test-cmd [/the/test/command]` - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# {{site.data.keyword.dev_cli_short}} +{: #developercli} + +{{site.data.keyword.dev_cli_long}} 提供一種可延伸的指令驅動方式，以使用 `dev` 外掛程式來建立、開發及部署 Web 專案。最理想的狀況是，開發人員在開發端對端微服務應用程式的同時使用指令行控制。 + +{: shortdesc} + +{{site.data.keyword.dev_cli_notm}} 使用兩個容器來協助建置及測試應用程式。第一個是 tools 容器，內含建置及測試應用程式的必要公用程式。此容器的 Dockerfile 是透過 [dockerfile-tools](#command-parameters) 參數所定義。您可以將它視為開發容器，因為它包含的工具一般適用於開發特定運行環境。 + +第二個容器是 run 容器。例如，此容器的形式適用於部署在 {{site.data.keyword.Bluemix}} 中使用。因此，此容器一般會定義可啟動您應用程式的進入點。當您選擇透過 {{site.data.keyword.dev_cli_short}} 來執行應用程式時，它會使用此容器。此容器的 Dockerfile 是透過 [dockerfile-run](#run-parameters) 參數所定義。 + + +## 新增 {{site.data.keyword.dev_cli_notm}} +{: #add-cli} + + +### 必要條件 +{: #prereq} + +需要有一些必要條件才能完整地探索及適當地利用 {{site.data.keyword.dev_cli_short}}，因為它可高度延伸，並可讓您運用其他增補技術。 + +1. 安裝 [Cloud Foundry CLI ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/cloudfoundry/cli#getting-started)。 + +2. 安裝 [{{site.data.keyword.Bluemix}} CLI ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://clis.ng.bluemix.net/ui/home.html)。 + +3. 取得 [{{site.data.keyword.Bluemix_notm}}](https://www.bluemix.net) ID。 + +4. 選用項目：如果您打算在本端執行及除錯應用程式，則也必須安裝 [Docker ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.docker.com/get-docker)。 只有針對非行動專案，這才是必要項目。 + + +### 安裝 +{: #installation} + +1. 執行下列指令，以安裝 [{{site.data.keyword.dev_cli_short}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in){: new_window}： + + ``` + bx plugin install dev -r Bluemix + ``` + {: codeblock} + +2. 執行下列指令，以驗證安裝成功： + + ``` + bx dev + ``` + {: codeblock} + + +### 開始之前 +{: #before-install} + +1. 登入 {{site.data.keyword.Bluemix_notm}}。 + + ``` + bx login + ``` + {: codeblock} + + **附註：**如果您的認證遭到拒絕，則可以使用「聯合 ID」。請遵循下列步驟，以使用「聯合 ID」來進行鑑別。 + + + + 1. 登入 [{{site.data.keyword.iamshort}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.bluemix.net/iam/#/apikeys){: new_window}。 + 2. 選取**建立 API 金鑰**。 + * 輸入 apiKey 名稱及說明 + 3. 下載 apiKey。 + 4. 開啟檔案，並複製 `apiKey` 欄位中的值。 + 5. 使用下列指令來登入： + + ``` + bx login --apikey + ``` + {: codeblock} + + +## 指令 +{: #commands} + +使用下列指令，以建立、部署、除錯及測試專案。 + +### Build +{: #build} + +您可以使用 `build` 指令來建置應用程式。`build-cmd-run` 配置元素是用來建置應用程式。在正常作業期間，`test`、`debug` 及 `run` 指令都會使用與此指令相同的方式來執行建置，因此不需要在這些指令之前執行該指令。 + +在現行專案目錄中執行下列指令，以建置您的應用程式： + +``` +bx dev build +``` +{: codeblock} + + +[Build 指令參數](#command-parameters) + + +### Code +{: #code} + +`code` 指令可讓您在部署之後下載應用程式碼，因此，您可以在本端進行檢閱或進行其他變更。 + +執行下列指令，以從指定的專案下載程式碼。 + +``` +bx dev code +``` +{: codeblock} + + +### Create +{: #create} + +提示輸入所有必要資訊（包括語言、專案名稱及應用程式型樣類型），以建立新的專案。將會在現行目錄中建立專案。 + +若要在現行專案目錄中建立新專案，並建立服務與它的關聯，請執行下列指令： + +``` +bx dev create +``` +{: codeblock} + + +### Debug +{: #debug} + +您可以透過 `debug` 指令來除錯應用程式。會先使用與建置指示相同的 `build-cmd-debug` 配置元素，來完成專案的建置。接著會啟動容器，公開 `container-port-map-debug` 中所定義的除錯埠。請將最愛的除錯工具連接至埠，以如常除錯應用程式。 + +**限制**：目前無法對 Swift 專案進行除錯。 + +在現行專案目錄中執行下列指令，以除錯您的應用程式： + +``` +bx dev debug +``` +{: codeblock} + +若要結束除錯階段作業，請使用 `CTRL-C`。 + + +#### Debug 指令參數 +{: #debug-parameters} + +下列參數是 `debug` 指令特有的，可協助除錯應用程式。 + +##### `container-port-map-debug` +{: #port-map-debug} + +* 除錯埠的埠對映。第一個值是在主機 OS 中使用的埠，第二個則是容器 (host:container) 中的埠。 +* 用法：`bx dev debug container-port-map-debug [7777:7777]` + +##### `build-cmd-debug` +{: #build-cmd-debug} + +* 用來建置程式碼，以進行除錯。 +* 用法：`bx dev debug build-cmd-debug build.command.sh` + +##### `debug-cmd` +{: #debug-cmd} + +* 用來除錯 tools 容器中的程式碼。如果您的 `build-cmd-debug` 將以除錯模式啟動應用程式，則這是選用項目。 +* 用法：`bx dev debug debug-cmd /the/debug/command` + +#### 本端應用程式除錯： +{: #local-app-dev} + +如需本端應用程式除錯的相關資訊，請參閱[本端應用程式除錯](docs/cloudnative/dev_cli_local_debug.html#local-debug)。 + + +### Delete +{: #delete} + +此指令可讓您移除 {{site.data.keyword.Bluemix}} 空間中的專案。 + +執行下列指令，以刪除 {{site.data.keyword.Bluemix}} 中的專案： + +``` +bx dev delete +``` +{: codeblock} + + +**附註**：**不會**移除 {{site.data.keyword.Bluemix}} 服務。 + + +### Help +{: #help} + +依預設，如果未傳入動作或引數，或是提供 'help' 動作，則此指令將會顯示一般「說明」文字。所顯示的一般說明會包括基礎引數的說明，以及可用動作清單。 + +執行下列指令，以顯示一般說明資訊： + +``` +bx dev help +``` +{: codeblock} + + +### List +{: #list} + +您可以列出空間中的所有 {{site.data.keyword.Bluemix_notm}} 專案。 + +執行下列指令，以列出您的專案： + +``` +bx dev list +``` +{: codeblock} + + + + + +### Run +{: #run} + +您可以透過 `run` 指令來執行應用程式。會先使用與建置指示相同的 `build-cmd-run` 配置元素，來完成專案的建置。接著會啟動 run 容器，公開 `container-port-map` 中所定義的埠。如果 run 容器未包含完成此步驟的進入點，則可以使用 `run-cmd` 來呼叫應用程式。 + +在現行專案目錄中執行下列指令，以啟動您的應用程式： + +``` +bx dev run +``` +{: codeblock} + +若要結束階段作業，請使用 `CTRL-C`。 + + +#### Run 參數 +{: #run-parameters} + +下列參數是 `run` 指令特有的，可協助管理 run 容器內的應用程式。 + +##### `container-name-run` +{: #container-name-run} + +* run 容器的容器名稱。 +* 用法：`bx dev run container-name-run ` + +##### `container-path-run` +{: #container-path-run} + +* 執行時，容器中要共用的位置。 +* 用法：`bx dev run container-path-run [/path/to/app]` + +##### `host-path-run` +{: #host-path-run} + +* 執行時，主機系統上容器中要共用的位置。 +* 用法：`bx dev run host-path-run [/path/to/app/bin]` + +##### `dockerfile-run` +{: #dockerfile-run} + +* run 容器的 Docker 檔案。 +* 用法：`bx dev run dockerfile-run [/path/to/Dockerfile.yml]` + +##### `image-name-run` +{: #image-name-run} + +* 要從 dockerfile-run 建立的映像檔。 +* 用法：`bx dev run image-name-run [/path/to/image-name]` + +##### `run-cmd` +{: #run-cmd} + +* 用來在 run 容器中執行程式碼的選用參數。如果您的映像檔將會啟動應用程式，則這是選用項目。 +* 用法：`bx dev run run-cmd [/the/run/command]` + +### Status +{: #status} + +您可以查詢 `container-name-run` 及 `container-name-tools` 所定義之 {{site.data.keyword.dev_cli_short}} 使用的容器的狀態。 + +在現行專案目錄中執行下列指令，以檢查容器狀態： + +``` +bx dev status +``` +{: codeblock} + + +[Status 指令參數](#command-parameters) + + +### Stop +{: #stop} + +您可以透過 `stop` 指令來停止容器。`container-name` 參數可讓您指定要停止的容器。如果未指定這個項目，則 stop 指令會停止 `container-name-run` 所定義的 run 容器。 + +在現行專案目錄中執行下列指令，以停止容器： + +``` +bx dev stop +``` +{: codeblock} + + +#### 其他 stop 參數： +{: #stop-parameter} + +##### `container-name` +{: #container-name} + +* tools 容器的容器名稱。 +* 用法：`bx dev stop container-name ` + +### Test +{: #test} + +您可以透過 `test` 指令來測試應用程式。會先使用與建置指示相同的 `build-cmd-run` 配置元素，來完成專案的建置。接著會使用 tools 容器，針對應用程式呼叫 `test-cmd`。 + +執行下列指令，以測試應用程式： + +``` +bx dev test +``` +{: codeblock} + + +[Test 指令參數](#command-parameters) + + +## build、debug、run 及 test 的參數 +{: #command-parameters} + +下列參數可以與 `build|debug|run|test` 指令搭配使用，並且可以透過指令行以及（或）直接更新專案的 `cli-config.yml` 檔案來指定。其他參數適用於 [`debug`](#debug-parameters) 及 [`run`](#run-parameters) 指令，並且記載於其個別小節中。 + +**附註**：在指令行上輸入的指令參數，其優先順序高於 `cli-config.yml` 配置。 + +##### `container-name-tools` +{: #container-name-tools} + +* tools 容器的容器名稱。 +* 用法：`bx dev container-name-tools []` + +##### `host-path-tools` +{: #host-path-tools} + +* 主機上基於建置、除錯、測試而共用的位置。 +* 用法：`bx dev host-path-tools [/path/to/build/tools]` + +##### `container-path-tools` +{: #container-path-tools} + +* 容器中基於建置、除錯、測試而共用的位置。 +* 用法：`bx dev container-path-tools [/path/for/build]` + +##### `container-port-map` +{: #container-port-map} + +* 容器的埠對映。第一個值是在主機 OS 中使用的埠，第二個則是容器 (host:container) 中的埠。 +* 用法：`bx dev container-port-map [8090:8090,9090,9090]` + +##### `dockerfile-tools` +{: #dockerfile-tools} + +* tools 容器的 Docker 檔案。 +* 用法：`bx dev dockerfile-tools [path/to/dockerfile]` + +##### `image-name-tools` +{: #image-name-tools} + +* 要從 dockerfile-tools 建立的映像檔。 +* 用法：`bx dev image-name-tools [path/to/image-name]` + +##### `build-cmd-run` +{: #build-cmd-run} + +* 基於所有使用而建置程式碼的指令，但「除錯」除外。 +* 用法：`bx dev build-cmd-run [some.build.command]` + +##### `test-cmd` +{: #test-cmd} + +* 測試 tools 容器中程式碼的指令。 +* 用法：`bx dev test-cmd [/the/test/command]` + diff --git a/cloudnative/nl/zh/TW/dev_cli_local_debug.md b/cloudnative/nl/zh/TW/dev_cli_local_debug.md index 8b3ca137c..311ed1ec8 100644 --- a/cloudnative/nl/zh/TW/dev_cli_local_debug.md +++ b/cloudnative/nl/zh/TW/dev_cli_local_debug.md @@ -1,76 +1,76 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 本端應用程式除錯 -{: #local-debug} - -下列語言的本端應用程式除錯指示提供如下： - -* [Java](#java) -* [Node.js](#node) - -**附註**：目前不支援 Swift 應用程式除錯。 - -## Java 應用程式除錯 -{: #java} - -針對 Java 應用程式啟用除錯的步驟： - -1. 從應用程式專案的根目錄中，執行下列指令： - - `bx dev debug` - -2. 將除錯器連接至應用程式： - - * [Eclipse ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) - * [IntelliJ ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) - * [VSCode ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) - * JDK 指令行：`jdb -attach ` - -## Node.js 應用程式除錯 - -{: #node} - -針對 Node.js 應用程式啟用除錯的步驟： - -1. 從應用程式專案的根目錄中，執行下列指令： - - `bx dev debug` - -2. 將除錯器連接至應用程式： - * [VSCode ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://blog.docker.com/2016/07/live-debugging-docker/). - * [WebStorm ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 本端應用程式除錯 +{: #local-debug} + +下列語言的本端應用程式除錯指示提供如下： + +* [Java](#java) +* [Node.js](#node) + +**附註**：目前不支援 Swift 應用程式除錯。 + +## Java 應用程式除錯 +{: #java} + +針對 Java 應用程式啟用除錯的步驟： + +1. 從應用程式專案的根目錄中，執行下列指令： + + `bx dev debug` + +2. 將除錯器連接至應用程式： + + * [Eclipse ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-remotejava_launch_config.htm) + * [IntelliJ ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.jetbrains.com/help/idea/2016.3/run-debug-configuration-remote.html) + * [VSCode ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://marketplace.visualstudio.com/items?itemName=donjayamanne.javadebugge) + * JDK 指令行：`jdb -attach ` + +## Node.js 應用程式除錯 + +{: #node} + +針對 Node.js 應用程式啟用除錯的步驟： + +1. 從應用程式專案的根目錄中，執行下列指令： + + `bx dev debug` + +2. 將除錯器連接至應用程式： + * [VSCode ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://blog.docker.com/2016/07/live-debugging-docker/). + * [WebStorm ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://blog.alexseifert.com/2016/10/25/debugging-node-js-in-a-docker-container-with-webstorm/) + + + + + diff --git a/cloudnative/nl/zh/TW/devex.md b/cloudnative/nl/zh/TW/devex.md index b7b0fd300..757b9cd1c 100644 --- a/cloudnative/nl/zh/TW/devex.md +++ b/cloudnative/nl/zh/TW/devex.md @@ -1,31 +1,31 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.dev_console}} -{: #devex} - -若要開始使用 [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://console.{DomainName}/developer/getting-started)，請按一下 {{site.data.keyword.Bluemix_notm}} 主控台中的 **Web 及行動**種類。 - - -## 開始使用 -{: getting-started} - -按一下**建立專案**，以在**開始使用**頁面上建立專案。您會看到[型樣](patterns.html)、[入門範本](starters.html)及[語言](patterns.html#languages)選項，讓您可以快速建立應用程式。 - -您可以選取[專案 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://console.{DomainName}/developer/projects) 頁面，來檢視及管理某個工作區中的所有專案。專案會保留所有（可以）與應用程式整合之功能的資訊。如果可供使用，您可以在專案中輕鬆地整合及管理推送、分析、鑑別及資料服務，而且近期將會有更多功能。 - -[服務](services.html)頁面顯示現有服務實例的作業視圖。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 支援雲端原生開發人員及雲端原生應用程式管理使用者。 - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.dev_console}} +{: #devex} + +若要開始使用 [{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://console.{DomainName}/developer/getting-started)，請按一下 {{site.data.keyword.Bluemix_notm}} 主控台中的 **Web 及行動**種類。 + + +## 開始使用 +{: getting-started} + +按一下**建立專案**，以在**開始使用**頁面上建立專案。您會看到[型樣](patterns.html)、[入門範本](starters.html)及[語言](patterns.html#languages)選項，讓您可以快速建立應用程式。 + +您可以選取[專案 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://console.{DomainName}/developer/projects) 頁面，來檢視及管理某個工作區中的所有專案。專案會保留所有（可以）與應用程式整合之功能的資訊。如果可供使用，您可以在專案中輕鬆地整合及管理推送、分析、鑑別及資料服務，而且近期將會有更多功能。 + +[服務](services.html)頁面顯示現有服務實例的作業視圖。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 支援雲端原生開發人員及雲端原生應用程式管理使用者。 + + + diff --git a/cloudnative/nl/zh/TW/get_code.md b/cloudnative/nl/zh/TW/get_code.md index 1a94cabe6..cfd1032d1 100644 --- a/cloudnative/nl/zh/TW/get_code.md +++ b/cloudnative/nl/zh/TW/get_code.md @@ -1,80 +1,80 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-18" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# 取得程式碼 -{: #Get_Code} - -當您使用選取的功能完成配置及設定專案時，即可下載可讓您執行程式碼的程式碼。您的已下載專案已預先配置您所配置的每一個功能的必要 SDK 相依關係及認證。 - -您需要完成無法在已下載專案中配置之服務的認證。入門範本專案的 `README.md` 檔案包含這些指示。請使用 Markdown 檢視器檢視 `README.md` 檔案，以完成設定。 - -## 必備開發人員工具 -{: #prereq-dev-tools} - -當您從 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 使用產生的程式碼時，需要下列開發人員工具： - - -### 一般 -{: #general notoc} - -* [Homebrew ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://brew.sh/) - * 協助 Apple 開發人員安裝其他工具及運行環境（例如 CocoaPods 及 Carthage）的指令行工具。 - -* [Docker ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.docker.com/get-docker) - * 開放程式碼專案，協助在容器中執行及除錯應用程式。只有針對非行動專案，這才是必要項目。 - -### {{site.data.keyword.Bluemix_notm}} -{: #bluemix notoc} - -* Node.js（Node 及 npm 運行環境），協助執行 {{site.data.keyword.apiconnect_short}} Loopback 及其他 {{site.data.keyword.Bluemix_notm}} Productivity 工具。 - - 若要在本端執行 {{site.data.keyword.apiconnect_short}} 工具，請使用 Node 5.x： - - ``` - $ brew install Node5 - ``` - -* [Bluemix CLI 工具 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://clis.ng.bluemix.net/ui/home.html) - - 使用 {{site.data.keyword.Bluemix_notm}}，從指令行介面部署 Cloud Foundry 運行環境的指令行工具。 - -* [{{site.data.keyword.dev_cli_notm}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](dev_cli.html) - - 建立、執行、測試與部署 Web 及行動專案的 {{site.data.keyword.Bluemix_notm}} CLI 外掛程式。 - -* [SDK 產生器外掛程式 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](sdk_cli.html) - - 從 [Open API 規格 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.openapis.org/) 相容的 REST API 定義產生 SDK 的 {{site.data.keyword.Bluemix_notm}} CLI 外掛程式。 - -### Android -{: #android notoc} - -* [Android Studio 2.2 或更新版本![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.android.com/studio) - * 安裝最新的 [Android 7.0 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.android.com/versions/nougat-7-0/) 運行環境。 - -### iOS -{: #ios notoc} - -* [Xcode 8 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com/xcode/)（建議） - - -* [CocoaPods ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://cocoapods.org/) 相依關係管理程式，用於安裝 iOS SDK 相依關係。請使用最新版本： - - ``` - $ sudo gem install cocoapods --pre - ``` -* 安裝 {{site.data.keyword.watson}} Developer Cloud SDK 的 [Carthage ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/Carthage/Carthage) 相依關係管理員。 - - ``` - $ brew install carthage - ``` +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-18" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# 取得程式碼 +{: #Get_Code} + +當您使用選取的功能完成配置及設定專案時，即可下載可讓您執行程式碼的程式碼。您的已下載專案已預先配置您所配置的每一個功能的必要 SDK 相依關係及認證。 + +您需要完成無法在已下載專案中配置之服務的認證。入門範本專案的 `README.md` 檔案包含這些指示。請使用 Markdown 檢視器檢視 `README.md` 檔案，以完成設定。 + +## 必備開發人員工具 +{: #prereq-dev-tools} + +當您從 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 使用產生的程式碼時，需要下列開發人員工具： + + +### 一般 +{: #general notoc} + +* [Homebrew ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://brew.sh/) + * 協助 Apple 開發人員安裝其他工具及運行環境（例如 CocoaPods 及 Carthage）的指令行工具。 + +* [Docker ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.docker.com/get-docker) + * 開放程式碼專案，協助在容器中執行及除錯應用程式。只有針對非行動專案，這才是必要項目。 + +### {{site.data.keyword.Bluemix_notm}} +{: #bluemix notoc} + +* Node.js（Node 及 npm 運行環境），協助執行 {{site.data.keyword.apiconnect_short}} Loopback 及其他 {{site.data.keyword.Bluemix_notm}} Productivity 工具。 + + 若要在本端執行 {{site.data.keyword.apiconnect_short}} 工具，請使用 Node 5.x： + + ``` + $ brew install Node5 + ``` + +* [Bluemix CLI 工具 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://clis.ng.bluemix.net/ui/home.html) + + 使用 {{site.data.keyword.Bluemix_notm}}，從指令行介面部署 Cloud Foundry 運行環境的指令行工具。 + +* [{{site.data.keyword.dev_cli_notm}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](dev_cli.html) + + 建立、執行、測試與部署 Web 及行動專案的 {{site.data.keyword.Bluemix_notm}} CLI 外掛程式。 + +* [SDK 產生器外掛程式 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](sdk_cli.html) + + 從 [Open API 規格 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.openapis.org/) 相容的 REST API 定義產生 SDK 的 {{site.data.keyword.Bluemix_notm}} CLI 外掛程式。 + +### Android +{: #android notoc} + +* [Android Studio 2.2 或更新版本![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.android.com/studio) + * 安裝最新的 [Android 7.0 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.android.com/versions/nougat-7-0/) 運行環境。 + +### iOS +{: #ios notoc} + +* [Xcode 8 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com/xcode/)（建議） + + +* [CocoaPods ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://cocoapods.org/) 相依關係管理程式，用於安裝 iOS SDK 相依關係。請使用最新版本： + + ``` + $ sudo gem install cocoapods --pre + ``` +* 安裝 {{site.data.keyword.watson}} Developer Cloud SDK 的 [Carthage ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/Carthage/Carthage) 相依關係管理員。 + + ``` + $ brew install carthage + ``` diff --git a/cloudnative/nl/zh/TW/index.md b/cloudnative/nl/zh/TW/index.md index 8372922dc..29a0d7ab8 100644 --- a/cloudnative/nl/zh/TW/index.md +++ b/cloudnative/nl/zh/TW/index.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2016-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 建置雲端原生專案 -{: #web-mobile} - -您可以透過 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} [專案](projects.html)的概念來管理雲端原生應用程式。您可以針對 {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI，使用 [{{site.data.keyword.dev_console}}](devex.html) 或 [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) 來建立專案。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 會將雲端原生應用程式開發人員所需的最常用服務功能帶入已針對開發人員最佳化的單一已連接體驗。 - -{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 可讓雲端原生應用程式開發人員透過各種[型樣類型](patterns.html)及[入門範本](starters.html)建立專案、建立主要 {{site.data.keyword.Bluemix_notm}} 最佳化服務並將其連接至專案，以及使用 SDK 快速下載工作中程式碼。SDK 已與功能認證或相依關係完全整合，可讓您立即執行。如果您的應用程式正在執行，並且您已設定及配置功能，則可以回到專案以監視及管理與應用程式使用者的互動。您也可以透過 {{site.data.keyword.dev_console}} 配置及管理服務。 - - - - - - -# 相關鏈結 -{: #rellinks notoc} - -## 指導教學及範例 -{: #samples notoc} - -* [範例：Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} -* [視訊指導教學](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2016-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 建置雲端原生專案 +{: #web-mobile} + +您可以透過 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} [專案](projects.html)的概念來管理雲端原生應用程式。您可以針對 {{site.data.keyword.IBM_notm}} {{site.data.keyword.Bluemix_notm}} CLI，使用 [{{site.data.keyword.dev_console}}](devex.html) 或 [{{site.data.keyword.dev_cli_notm}}](dev_cli.html) 來建立專案。{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 會將雲端原生應用程式開發人員所需的最常用服務功能帶入已針對開發人員最佳化的單一已連接體驗。 + +{{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 可讓雲端原生應用程式開發人員透過各種[型樣類型](patterns.html)及[入門範本](starters.html)建立專案、建立主要 {{site.data.keyword.Bluemix_notm}} 最佳化服務並將其連接至專案，以及使用 SDK 快速下載工作中程式碼。SDK 已與功能認證或相依關係完全整合，可讓您立即執行。如果您的應用程式正在執行，並且您已設定及配置功能，則可以回到專案以監視及管理與應用程式使用者的互動。您也可以透過 {{site.data.keyword.dev_console}} 配置及管理服務。 + + + + + + +# 相關鏈結 +{: #rellinks notoc} + +## 指導教學及範例 +{: #samples notoc} + +* [範例：Mobile Backend for Bluemix](https://github.com/ibm-bluemix-mobile-services/mobiledashboard-storecatalog-backend){: new_window} +* [視訊指導教學](https://www.youtube.com/channel/UCRW4t4Hzm9gzuiq5naERkCw){: new_window} diff --git a/cloudnative/nl/zh/TW/patterns.md b/cloudnative/nl/zh/TW/patterns.md index ac6c63d1e..4ab85d398 100644 --- a/cloudnative/nl/zh/TW/patterns.md +++ b/cloudnative/nl/zh/TW/patterns.md @@ -1,99 +1,99 @@ - ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 型樣類型 -{: #patterns} - -雲端原生型樣是經過驗證的設計，有助於確保應用程式的一致、可擴充及可靠的拓蹼。當您建立專案時，會呈現可讓您從中選擇的不同型樣類型。您只要選取要併入專案的型樣類型及功能即可。定義專案喜好設定之後，會產生要編輯、執行或除錯並在本端部署或部署至 {{site.data.keyword.Bluemix}} 的入門範本專案。 - -## Web 應用程式 -{: #web} - -Web 專案會將提供 Web 內容（例如 HTML、JavaScript 及樣式表）的能力新增至 Web 伺服器。 - -下列是可用的 Web 入門範本： - -* Basic Web：提供靜態 `index.html` 檔案、預設和空的樣式表，以及 JavaScript 檔案。 -* Webpack：建立專案，其中，ECMAScript 6 (ES6) 原始檔位於 `src/client` 且使用 WebPack 進行編譯，讓它們變小並轉換以在瀏覽器中使用。 -* Webpack + React：建置使用者介面的豐富架構。原始檔位於 `src/client/app`，並且將使用 WebPack 進行編譯並提供於公用目錄中。 - - -## 行動應用程式 -{: #mobile} - -行動應用程式型樣可協助您建置直接連接至後端服務（例如 {{site.data.keyword.mobilepushshort}}、{{site.data.keyword.mobileanalytics_short}}、{{site.data.keyword.appid_short}} 等等）的行動應用程式。專案也可以透過 sdkGen（例如 BFF 及 Microservice）予以新增。 - -您可以從入門範本清單中選擇（例如 {{site.data.keyword.watson}} Conversation、{{site.data.keyword.visualrecognitionshort}}、{{site.data.keyword.openwhisk_short}} 等等）。 - -您可以在 Swift、Android 或 Cordova 中產生行動應用程式。 - - -## Backend for Frontend (BFF) -{: #bff} - -Backend for Frontend 型樣（通稱為 BFF）可協助您聚焦於以符合使用者互動需求的形式公開商業資料及服務。若要最佳化雲端解決方案的使用者行程，則行動應用程式可能需要不同的使用者行程，而 Web 應用程式可能需要更豐富且更詳細的行程。引進 [{{site.data.keyword.conversationfull}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.ibm.com/watson/developercloud/conversation.html) 服務這類語音控制裝置，即可透過語音控制與使用者的互動。此數位通道需要極為不同的 BFF 來管理這些語音目的互動。 - -搭配 {{site.data.keyword.Bluemix_notm}}，您可以使用多國語言進行程式設計方式定義 BFF 來建置 BFF。IBM 建議使用 Node.js、Swift 或 Java，並搭配 Cloud Foundry、Container 服務或無伺服器以雲端原生型樣執行。 - -BFF 將管理與進行資料持續性、快取之服務的整合，以及與高價值服務（例如 {{site.data.keyword.ibmwatson}}、{{site.data.keyword.iot_short_notm}}、{{site.data.keyword.weather_short}} 以及 {{site.data.keyword.sparks}} 這類資料分析）的整合。 - -BFF 將公開最常使用 REST 型樣的 API，但您可以使用 {{site.data.keyword.messagehub}} 設計 BFF 來運用傳訊架構。 - -使用 Node.js 或 Swift 可以使用 BFF Basic 入門範本。 - - -## Microservice -{: #microservice} - -Microservice 專案提供用於建置後端微服務（包括基本性能端點：REST API）的基礎。產生的專案將包含微服務本身以及任何連接的雲端服務所需的所有相依關係。 - -使用 Java 可以使用 Microservice Basic 入門範本。 - - - - -## 語言 -{: #languages notoc} - -支援的語言為： - - * [Java ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](../runtimes/liberty/getting-started.html){: new_window} - * [Node.js ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](../runtimes/nodejs/getting-started.html){: new_window} - * [Swift ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](../runtimes/swift/getting-started.html){: new_window} - - -### Java -{: #java notoc} - -Java 具有經過驗證的功能可建置企業級應用程式。但是，Java 8 中的新功能與更輕量型的運行環境（例如 Liberty）及架構（例如 Spring Boot）搭配使用，也可讓 Java 更完美地適用於建置微服務。 - - -### Node.js -{: #node notoc} - -Node.js 是一種 JavaScript 運行環境，使用事件驅動、非封鎖 I/O 模型讓它更為輕量且更具效率，對於 Web 應用程式、Backend for Frontend 型樣及微服務的產量及可擴充性最有幫助。Node.js 的套件生態系統 npm 可存取大量的開放程式碼模組，並提供廣泛的功能來加速應用程式開發。 - - -### Swift -{: #swift notoc} - -Swift 是 Apple 在 2014 所建立的現代化程式設計語言，其設計目的是要取代 Objective C 的使用，並在 2015 年 12 月公開開放程式碼。現在，它是用來在使用 x86、ARM 或 Z 架構的 Linux 及 macOS 作業系統上建置 iOS、macOS、Web 服務及系統軟體。它的撰寫方式類似 Scripting 語言，但會進行編譯以獲得類似 C 語言的低額外負擔與高效能，讓它更適用於雲端運行環境。它會使用您在 Java 中看到的強式及靜態類型系統，而不是您在 JavaScript 中看到的功能性樣式及非同步常式。它的效能極高，而且原始檔會使用 LLVM 編譯器工具鏈編譯成原生程式碼，並且可以輕鬆地運用使用 C 所撰寫的外部系統程式庫。 + +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 型樣類型 +{: #patterns} + +雲端原生型樣是經過驗證的設計，有助於確保應用程式的一致、可擴充及可靠的拓蹼。當您建立專案時，會呈現可讓您從中選擇的不同型樣類型。您只要選取要併入專案的型樣類型及功能即可。定義專案喜好設定之後，會產生要編輯、執行或除錯並在本端部署或部署至 {{site.data.keyword.Bluemix}} 的入門範本專案。 + +## Web 應用程式 +{: #web} + +Web 專案會將提供 Web 內容（例如 HTML、JavaScript 及樣式表）的能力新增至 Web 伺服器。 + +下列是可用的 Web 入門範本： + +* Basic Web：提供靜態 `index.html` 檔案、預設和空的樣式表，以及 JavaScript 檔案。 +* Webpack：建立專案，其中，ECMAScript 6 (ES6) 原始檔位於 `src/client` 且使用 WebPack 進行編譯，讓它們變小並轉換以在瀏覽器中使用。 +* Webpack + React：建置使用者介面的豐富架構。原始檔位於 `src/client/app`，並且將使用 WebPack 進行編譯並提供於公用目錄中。 + + +## 行動應用程式 +{: #mobile} + +行動應用程式型樣可協助您建置直接連接至後端服務（例如 {{site.data.keyword.mobilepushshort}}、{{site.data.keyword.mobileanalytics_short}}、{{site.data.keyword.appid_short}} 等等）的行動應用程式。專案也可以透過 sdkGen（例如 BFF 及 Microservice）予以新增。 + +您可以從入門範本清單中選擇（例如 {{site.data.keyword.watson}} Conversation、{{site.data.keyword.visualrecognitionshort}}、{{site.data.keyword.openwhisk_short}} 等等）。 + +您可以在 Swift、Android 或 Cordova 中產生行動應用程式。 + + +## Backend for Frontend (BFF) +{: #bff} + +Backend for Frontend 型樣（通稱為 BFF）可協助您聚焦於以符合使用者互動需求的形式公開商業資料及服務。若要最佳化雲端解決方案的使用者行程，則行動應用程式可能需要不同的使用者行程，而 Web 應用程式可能需要更豐富且更詳細的行程。引進 [{{site.data.keyword.conversationfull}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.ibm.com/watson/developercloud/conversation.html) 服務這類語音控制裝置，即可透過語音控制與使用者的互動。此數位通道需要極為不同的 BFF 來管理這些語音目的互動。 + +搭配 {{site.data.keyword.Bluemix_notm}}，您可以使用多國語言進行程式設計方式定義 BFF 來建置 BFF。IBM 建議使用 Node.js、Swift 或 Java，並搭配 Cloud Foundry、Container 服務或無伺服器以雲端原生型樣執行。 + +BFF 將管理與進行資料持續性、快取之服務的整合，以及與高價值服務（例如 {{site.data.keyword.ibmwatson}}、{{site.data.keyword.iot_short_notm}}、{{site.data.keyword.weather_short}} 以及 {{site.data.keyword.sparks}} 這類資料分析）的整合。 + +BFF 將公開最常使用 REST 型樣的 API，但您可以使用 {{site.data.keyword.messagehub}} 設計 BFF 來運用傳訊架構。 + +使用 Node.js 或 Swift 可以使用 BFF Basic 入門範本。 + + +## Microservice +{: #microservice} + +Microservice 專案提供用於建置後端微服務（包括基本性能端點：REST API）的基礎。產生的專案將包含微服務本身以及任何連接的雲端服務所需的所有相依關係。 + +使用 Java 可以使用 Microservice Basic 入門範本。 + + + + +## 語言 +{: #languages notoc} + +支援的語言為： + + * [Java ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](../runtimes/liberty/getting-started.html){: new_window} + * [Node.js ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](../runtimes/nodejs/getting-started.html){: new_window} + * [Swift ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](../runtimes/swift/getting-started.html){: new_window} + + +### Java +{: #java notoc} + +Java 具有經過驗證的功能可建置企業級應用程式。但是，Java 8 中的新功能與更輕量型的運行環境（例如 Liberty）及架構（例如 Spring Boot）搭配使用，也可讓 Java 更完美地適用於建置微服務。 + + +### Node.js +{: #node notoc} + +Node.js 是一種 JavaScript 運行環境，使用事件驅動、非封鎖 I/O 模型讓它更為輕量且更具效率，對於 Web 應用程式、Backend for Frontend 型樣及微服務的產量及可擴充性最有幫助。Node.js 的套件生態系統 npm 可存取大量的開放程式碼模組，並提供廣泛的功能來加速應用程式開發。 + + +### Swift +{: #swift notoc} + +Swift 是 Apple 在 2014 所建立的現代化程式設計語言，其設計目的是要取代 Objective C 的使用，並在 2015 年 12 月公開開放程式碼。現在，它是用來在使用 x86、ARM 或 Z 架構的 Linux 及 macOS 作業系統上建置 iOS、macOS、Web 服務及系統軟體。它的撰寫方式類似 Scripting 語言，但會進行編譯以獲得類似 C 語言的低額外負擔與高效能，讓它更適用於雲端運行環境。它會使用您在 Java 中看到的強式及靜態類型系統，而不是您在 JavaScript 中看到的功能性樣式及非同步常式。它的效能極高，而且原始檔會使用 LLVM 編譯器工具鏈編譯成原生程式碼，並且可以輕鬆地運用使用 C 所撰寫的外部系統程式庫。 diff --git a/cloudnative/nl/zh/TW/projects.md b/cloudnative/nl/zh/TW/projects.md index 64171a3db..faeb1bddc 100644 --- a/cloudnative/nl/zh/TW/projects.md +++ b/cloudnative/nl/zh/TW/projects.md @@ -1,57 +1,57 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 專案 -{: #projects} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 會將應用程式使用者介面、資料及服務結合在一個完整的*專案* 中。透過建立專案，應用程式的所有必要部分及已新增功能都會在 {{site.data.keyword.Bluemix_notm}} 伺服器上進行維護。如果服務已配置到專案，您就可以下載應用程式碼以及必要認證和起始設定程式。您可以選取**專案**來檢視所有專案。 - -您可以在**專案**頁面上選取專案，來檢視單一專案的其他資訊。這會顯示**專案概觀**頁面，其中包括針對專案所配置及提供的服務。服務是透過新增功能來擴充應用程式的個別功能。因為它們是個別新增的，所以您可以新增所需的服務，例如推送服務、鑑別、資料和儲存空間或其他服務。若您在**專案概觀**頁面上將服務新增至專案、並且遵循指示進行配置，服務就會自動與您的應用程式相關聯。如需「專案概觀」頁面的相關資訊，請參閱[專案概觀頁面](project_overview_page.html)。 - -若要建立專案，您必須選取後面接著一個[入門範本](starters.html)的[型樣](patterns.html)。 - - -## 專案概觀頁面 -{: #project_overview} - -您可以檢視及使用單一 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 專案，方法是在**專案**頁面上選取專案，這會開啟「專案概觀」頁面。 -{: shortdesc} - -**專案概觀**頁面會為每一個配置的功能或每一個可用於使用選取的專案來配置的功能顯示一個磚。這個磚會顯示功能的類型，以及一個具有三個垂直對齊點的*動作* 按鈕。可以使用或配置的功能範例包括 {{site.data.keyword.mobilepushshort}}、分析、資料及儲存空間。相容的功能取決於專案類型以及可在該地區使用的功能，因此並非所有功能都可用來與所有專案產生關聯。 - -當功能類型尚未與專案相關聯時，磚上會顯示一個**建立**按鈕。動作按鈕選項為建立服務的實例，或在功能尚未關聯時新增現有服務實例。選取**新增現有項目**會提供空間內該類型之服務實例的清單。 - -如果功能已與此專案相關聯，則相關聯之服務實例的名稱會顯示在磚上，位於功能類型後面。這讓您可在 {{site.data.keyword.dev_console}} 上輕鬆發現哪個服務實例與此專案相關。當功能已與專案相關聯時，可在動作按鈕上使用的動作為**檢視**及**移除**。移除服務實例只會移除與此專案的關聯，並不會從 {{site.data.keyword.dev_console}} 中刪除服務實例。若要刪除服務實例，請按一下 **Web 及行動 > 服務**頁面來檢視及刪除服務實例。 - -在**程式碼**磚上選取**取得程式碼**，為您的專案下載程式碼。如需下載程式碼的相關資訊，請參閱[取得程式碼](get_code.html)。 - - -## 更新專案以使用新的入門範本 -{: #update-starter} - -1. 從**專案**或**專案概觀**頁面中，按一下**溢位功能表**圖示，然後選取**更新入門範本**。 - -2. 選擇新的「入門範本」，然後按一下**更新**。 - -3. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 - - 您也可以按一下**程式碼**頁面。 - - -## 更新專案以產生新語言 -{: #update-language} - -1. 從**專案**或**專案概觀**頁面中，按一下**溢位功能表**圖示，然後選取**更新入門範本**。 - -2. 選取新的語言，然後按一下**更新**。 - -3. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 專案 +{: #projects} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 會將應用程式使用者介面、資料及服務結合在一個完整的*專案* 中。透過建立專案，應用程式的所有必要部分及已新增功能都會在 {{site.data.keyword.Bluemix_notm}} 伺服器上進行維護。如果服務已配置到專案，您就可以下載應用程式碼以及必要認證和起始設定程式。您可以選取**專案**來檢視所有專案。 + +您可以在**專案**頁面上選取專案，來檢視單一專案的其他資訊。這會顯示**專案概觀**頁面，其中包括針對專案所配置及提供的服務。服務是透過新增功能來擴充應用程式的個別功能。因為它們是個別新增的，所以您可以新增所需的服務，例如推送服務、鑑別、資料和儲存空間或其他服務。若您在**專案概觀**頁面上將服務新增至專案、並且遵循指示進行配置，服務就會自動與您的應用程式相關聯。如需「專案概觀」頁面的相關資訊，請參閱[專案概觀頁面](project_overview_page.html)。 + +若要建立專案，您必須選取後面接著一個[入門範本](starters.html)的[型樣](patterns.html)。 + + +## 專案概觀頁面 +{: #project_overview} + +您可以檢視及使用單一 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 專案，方法是在**專案**頁面上選取專案，這會開啟「專案概觀」頁面。 +{: shortdesc} + +**專案概觀**頁面會為每一個配置的功能或每一個可用於使用選取的專案來配置的功能顯示一個磚。這個磚會顯示功能的類型，以及一個具有三個垂直對齊點的*動作* 按鈕。可以使用或配置的功能範例包括 {{site.data.keyword.mobilepushshort}}、分析、資料及儲存空間。相容的功能取決於專案類型以及可在該地區使用的功能，因此並非所有功能都可用來與所有專案產生關聯。 + +當功能類型尚未與專案相關聯時，磚上會顯示一個**建立**按鈕。動作按鈕選項為建立服務的實例，或在功能尚未關聯時新增現有服務實例。選取**新增現有項目**會提供空間內該類型之服務實例的清單。 + +如果功能已與此專案相關聯，則相關聯之服務實例的名稱會顯示在磚上，位於功能類型後面。這讓您可在 {{site.data.keyword.dev_console}} 上輕鬆發現哪個服務實例與此專案相關。當功能已與專案相關聯時，可在動作按鈕上使用的動作為**檢視**及**移除**。移除服務實例只會移除與此專案的關聯，並不會從 {{site.data.keyword.dev_console}} 中刪除服務實例。若要刪除服務實例，請按一下 **Web 及行動 > 服務**頁面來檢視及刪除服務實例。 + +在**程式碼**磚上選取**取得程式碼**，為您的專案下載程式碼。如需下載程式碼的相關資訊，請參閱[取得程式碼](get_code.html)。 + + +## 更新專案以使用新的入門範本 +{: #update-starter} + +1. 從**專案**或**專案概觀**頁面中，按一下**溢位功能表**圖示，然後選取**更新入門範本**。 + +2. 選擇新的「入門範本」，然後按一下**更新**。 + +3. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 + + 您也可以按一下**程式碼**頁面。 + + +## 更新專案以產生新語言 +{: #update-language} + +1. 從**專案**或**專案概觀**頁面中，按一下**溢位功能表**圖示，然後選取**更新入門範本**。 + +2. 選取新的語言，然後按一下**更新**。 + +3. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 diff --git a/cloudnative/nl/zh/TW/sdk.md b/cloudnative/nl/zh/TW/sdk.md index bfe93c427..6e7dea3b9 100644 --- a/cloudnative/nl/zh/TW/sdk.md +++ b/cloudnative/nl/zh/TW/sdk.md @@ -1,67 +1,67 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-17" - ---- -# SDK -{: #sdk} - -若要將 {{site.data.keyword.Bluemix}} Mobile Services SDK 新增至應用程式，請選擇您要使用的 SDK，並配置相依關係管理程式以將 SDK 取回至應用程式。 - - -## 用戶端 SDK -{: #client_sdk} - -您可以在行動應用程式中使用下列 SDK，以運用個別功能。 - - -### Android SDK -{: #android_sdk} - -- [Core SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) -- [{{site.data.keyword.mobileanalytics_short}} SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) -- [Facebook 鑑別 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) -- [Google 鑑別 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) - - -### iOS SDK -{: #ios_sdk} - -- [Core SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) -- [{{site.data.keyword.mobileanalytics_short}} SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) -- [{{site.data.keyword.mobilepushshort}} SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) -- [Facebook 鑑別 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) -- [Google 鑑別 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) -- [{{site.data.keyword.amashort}} SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) - - -### Cordova 外掛程式 -{: #cordova_plugin} - -- [Core 外掛程式 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) -- [{{site.data.keyword.mobilepushshort}} 外掛程式 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## 伺服器 SDK -{: #server_sdk} - -如果您有 Java、NodeJS 或 Swift 伺服器應用程式，則可以使用下列 SDK 與個別服務進行通訊。 - - -### {{site.data.keyword.mobilepushshort}} 伺服器 SDK -{: #push_sdk} - -- [{{site.data.keyword.mobilepushshort}} Java 伺服器 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) -- [{{site.data.keyword.mobilepushshort}} Swift 伺服器 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) -- [{{site.data.keyword.mobilepushshort}} NodeJS 伺服器 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) - - -### {{site.data.keyword.amashort}} 伺服器 SDK -{: #mca_sdk} - -- [{{site.data.keyword.amashort}} Swift 伺服器 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) - - +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-17" + +--- +# SDK +{: #sdk} + +若要將 {{site.data.keyword.Bluemix}} Mobile Services SDK 新增至應用程式，請選擇您要使用的 SDK，並配置相依關係管理程式以將 SDK 取回至應用程式。 + + +## 用戶端 SDK +{: #client_sdk} + +您可以在行動應用程式中使用下列 SDK，以運用個別功能。 + + +### Android SDK +{: #android_sdk} + +- [Core SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core) +- [{{site.data.keyword.mobileanalytics_short}} SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push) +- [Facebook 鑑別 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-facebookauthentication) +- [Google 鑑別 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-security-googleauthentication) + + +### iOS SDK +{: #ios_sdk} + +- [Core SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core) +- [{{site.data.keyword.mobileanalytics_short}} SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-analytics) +- [{{site.data.keyword.mobilepushshort}} SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push) +- [Facebook 鑑別 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-facebookauthentication) +- [Google 鑑別 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security-googleauthentication) +- [{{site.data.keyword.amashort}} SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-security) + + +### Cordova 外掛程式 +{: #cordova_plugin} + +- [Core 外掛程式 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core) +- [{{site.data.keyword.mobilepushshort}} 外掛程式 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## 伺服器 SDK +{: #server_sdk} + +如果您有 Java、NodeJS 或 Swift 伺服器應用程式，則可以使用下列 SDK 與個別服務進行通訊。 + + +### {{site.data.keyword.mobilepushshort}} 伺服器 SDK +{: #push_sdk} + +- [{{site.data.keyword.mobilepushshort}} Java 伺服器 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-java) +- [{{site.data.keyword.mobilepushshort}} Swift 伺服器 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-swift) +- [{{site.data.keyword.mobilepushshort}} NodeJS 伺服器 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-pushnotifications-serversdk-nodejs) + + +### {{site.data.keyword.amashort}} 伺服器 SDK +{: #mca_sdk} + +- [{{site.data.keyword.amashort}} Swift 伺服器 SDK ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-mca-serversdk-swift) + + diff --git a/cloudnative/nl/zh/TW/sdk_BMSClient.md b/cloudnative/nl/zh/TW/sdk_BMSClient.md index c5d586d21..a8a6f0b2b 100644 --- a/cloudnative/nl/zh/TW/sdk_BMSClient.md +++ b/cloudnative/nl/zh/TW/sdk_BMSClient.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 起始設定 BMSClient -{: #sdk_BMSClient} - -`BMSCore` 提供 HTTP 基礎架構，供其他 {{site.data.keyword.Bluemix}} 行動服務用戶端 SDK 用來與其對應的 {{site.data.keyword.Bluemix_notm}} 服務進行通訊。 - - -## 起始設定 Android 應用程式 -{: #init-BMSClient-android} - -您可以下載及匯入 `BMSCore` 套件至 Android Studio 專案，或使用 Gradle。 - -1. 在專案檔開頭新增下列 `import` 陳述式，以匯入用戶端 SDK。 - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; - ``` - {: codeblock} - -2. 在 Android 應用程式中主要活動的 `onCreate` 方法中或在最適合您專案的位置中新增起始設定碼，以在 Android 應用程式中起始設定 `BMSClient` SDK。 - - ```Java - BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region - ``` - {: codeblock} - - 您必須起始設定 `BMSClient` 與 **bluemixRegion** 參數。在起始設定程式中，**bluemixRegion** 值指定您所使用的 {{site.data.keyword.Bluemix_notm}} 部署（例如，`BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK` 或 `BMSClient.REGION_SYDNEY`）。 - - -## 起始設定 iOS 應用程式 -{: #init-BMSClient-ios} - -您可以使用 [CocoaPods](https://cocoapods.org){: new_window} 或 [Carthage](https://github.com/Carthage/Carthage){: new_window} 來取得 `BMSCore` 套件。 - -1. 若要使用 CocoaPods 來安裝 `BMSCore`，請將下列這幾行新增至 Podfile 中。如果您的專案還沒有 Podfile，請使用 `pod init` 指令。 - - ```Swift - use_frameworks! - - target 'MyApp' do - pod 'BMSCore' - end - ``` - {: codeblock} - - 然後，執行 `pod install` 指令，並且開啟產生的 `.xcworkspace` 檔案。若要更新至 `BMSCore` 的較新版次，請使用 `pod update BMSCore`。 - - 如需使用 CocoaPods 的相關資訊，請參閱 [CocoaPods 手冊 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://guides.cocoapods.org/using/index.html){: new_window}。 - -2. 若要使用 Carthage 來安裝 `BMSCore`，請遵循下列[指示 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/Carthage/Carthage#getting-started){: new_window}。 - - 1. 將下列這一行新增至您的 Cartfile： - - ``` - github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" - ``` - {: codeblock} - - 2. 執行 `carthage update` 指令。 - - 3. 建置完成之後，請遵循 Carthage 指示中的[步驟 3 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/Carthage/Carthage#getting-started)，將 `BMSCore.framework` 新增至專案。 - - 若為使用 Swift 2.3 建置的應用程式，請使用 `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3` 指令。否則，請使用 `carthage update` 指令。 - -3. 匯入模組。 - - ```Swift - import BMSCore - ``` - {: codeblock} - -4. 起始設定 `BMSClient` 類別，使用下列程式碼。 - - 將起始設定碼放在應用程式委派的 `application(_:didFinishLaunchingWithOptions:)` 方法中，或放在最適合您專案的位置中。 - - ```Swift - BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region - ``` - {: codeblock} - - 您必須起始設定 `BMSClient` 與 **bluemixRegion** 參數。在起始設定程式中，**bluemixRegion** 值指定您所使用的 {{site.data.keyword.Bluemix_notm}} 部署（例如，`BMSClient.Region.usSouth`、`BMSClient.Region.unitedKingdom` 或 `BMSClient.Region.sydney`）。 - - -## 起始設定 Cordova 應用程式 -{: #init-BMSClient-cordova} - -1. 從您的 Cordova 應用程式根目錄執行下列指令，以新增 Cordova 外掛程式： - - ``` - cordova plugin add bms-core - ``` - {: codeblock} - -2. 在主要 JavaScript 檔案或在最適合您專案的位置中新增起始設定碼，以在 Cordova 應用程式中起始設定 `BMSClient` 類別。 - - ``` - BMSClient.initialize(BMSClient.REGION_US_SOUTH); - ``` - {: codeblock} - - 您必須起始設定 `BMSClient` 與 **bluemixRegion** 參數。在起始設定程式中，**bluemixRegion** 值指定您所使用的 {{site.data.keyword.Bluemix_notm}} 部署（例如，`BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK` 或 `BMSClient.REGION_SYDNEY`）。 - - -# 相關鏈結 -{: #rellinks notoc} - -## 相關鏈結 -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova 外掛程式](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 起始設定 BMSClient +{: #sdk_BMSClient} + +`BMSCore` 提供 HTTP 基礎架構，供其他 {{site.data.keyword.Bluemix}} 行動服務用戶端 SDK 用來與其對應的 {{site.data.keyword.Bluemix_notm}} 服務進行通訊。 + + +## 起始設定 Android 應用程式 +{: #init-BMSClient-android} + +您可以下載及匯入 `BMSCore` 套件至 Android Studio 專案，或使用 Gradle。 + +1. 在專案檔開頭新增下列 `import` 陳述式，以匯入用戶端 SDK。 + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.*; + ``` + {: codeblock} + +2. 在 Android 應用程式中主要活動的 `onCreate` 方法中或在最適合您專案的位置中新增起始設定碼，以在 Android 應用程式中起始設定 `BMSClient` SDK。 + + ```Java + BMSClient.getInstance().initialize(getApplicationContext(), BMSClient.REGION_US_SOUTH); // Make sure that you point to your region + ``` + {: codeblock} + + 您必須起始設定 `BMSClient` 與 **bluemixRegion** 參數。在起始設定程式中，**bluemixRegion** 值指定您所使用的 {{site.data.keyword.Bluemix_notm}} 部署（例如，`BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK` 或 `BMSClient.REGION_SYDNEY`）。 + + +## 起始設定 iOS 應用程式 +{: #init-BMSClient-ios} + +您可以使用 [CocoaPods](https://cocoapods.org){: new_window} 或 [Carthage](https://github.com/Carthage/Carthage){: new_window} 來取得 `BMSCore` 套件。 + +1. 若要使用 CocoaPods 來安裝 `BMSCore`，請將下列這幾行新增至 Podfile 中。如果您的專案還沒有 Podfile，請使用 `pod init` 指令。 + + ```Swift + use_frameworks! + + target 'MyApp' do + pod 'BMSCore' + end + ``` + {: codeblock} + + 然後，執行 `pod install` 指令，並且開啟產生的 `.xcworkspace` 檔案。若要更新至 `BMSCore` 的較新版次，請使用 `pod update BMSCore`。 + + 如需使用 CocoaPods 的相關資訊，請參閱 [CocoaPods 手冊 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://guides.cocoapods.org/using/index.html){: new_window}。 + +2. 若要使用 Carthage 來安裝 `BMSCore`，請遵循下列[指示 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/Carthage/Carthage#getting-started){: new_window}。 + + 1. 將下列這一行新增至您的 Cartfile： + + ``` + github "ibm-bluemix-mobile-services/bms-clientsdk-swift-core" + ``` + {: codeblock} + + 2. 執行 `carthage update` 指令。 + + 3. 建置完成之後，請遵循 Carthage 指示中的[步驟 3 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/Carthage/Carthage#getting-started)，將 `BMSCore.framework` 新增至專案。 + + 若為使用 Swift 2.3 建置的應用程式，請使用 `carthage update --toolchain com.apple.dt.toolchain.Swift_2_3` 指令。否則，請使用 `carthage update` 指令。 + +3. 匯入模組。 + + ```Swift + import BMSCore + ``` + {: codeblock} + +4. 起始設定 `BMSClient` 類別，使用下列程式碼。 + + 將起始設定碼放在應用程式委派的 `application(_:didFinishLaunchingWithOptions:)` 方法中，或放在最適合您專案的位置中。 + + ```Swift + BMSClient.sharedInstance.initialize(bluemixRegion: BMSClient.Region.usSouth) // Make sure that you point to your region + ``` + {: codeblock} + + 您必須起始設定 `BMSClient` 與 **bluemixRegion** 參數。在起始設定程式中，**bluemixRegion** 值指定您所使用的 {{site.data.keyword.Bluemix_notm}} 部署（例如，`BMSClient.Region.usSouth`、`BMSClient.Region.unitedKingdom` 或 `BMSClient.Region.sydney`）。 + + +## 起始設定 Cordova 應用程式 +{: #init-BMSClient-cordova} + +1. 從您的 Cordova 應用程式根目錄執行下列指令，以新增 Cordova 外掛程式： + + ``` + cordova plugin add bms-core + ``` + {: codeblock} + +2. 在主要 JavaScript 檔案或在最適合您專案的位置中新增起始設定碼，以在 Cordova 應用程式中起始設定 `BMSClient` 類別。 + + ``` + BMSClient.initialize(BMSClient.REGION_US_SOUTH); + ``` + {: codeblock} + + 您必須起始設定 `BMSClient` 與 **bluemixRegion** 參數。在起始設定程式中，**bluemixRegion** 值指定您所使用的 {{site.data.keyword.Bluemix_notm}} 部署（例如，`BMSClient.REGION_US_SOUTH`、`BMSClient.REGION_UK` 或 `BMSClient.REGION_SYDNEY`）。 + + +# 相關鏈結 +{: #rellinks notoc} + +## 相關鏈結 +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova 外掛程式](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/zh/TW/sdk_cli.md b/cloudnative/nl/zh/TW/sdk_cli.md index 9f59df780..5c377415a 100644 --- a/cloudnative/nl/zh/TW/sdk_cli.md +++ b/cloudnative/nl/zh/TW/sdk_cli.md @@ -1,178 +1,178 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# SDK 產生器外掛程式 -{: #sdk-cli} - -「{{site.data.keyword.IBM}} SDK 產生器」外掛程式可以安裝於 [{{site.data.keyword.Bluemix_notm}} CLI ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/cli/reference/bluemix_cli/index.html)。 - -身為 {{site.data.keyword.Bluemix_notm}} 上的開發人員，您可以使用此外掛程式，從 [Open API 規格 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.openapis.org/) 相容的 REST API 定義產生 SDK。變更 REST API 定義時，可以使用此外掛程式僅重新產生 SDK，而不是重新產生整個專案。 - -您也可以查看給定空間中的 Cloud Foundry 應用程式是否有適用於產生 SDK 的 REST API 定義。最終，您可以使用「{{site.data.keyword.IBM_notm}} SDK 產生器」外掛程式來驗證任何 REST API 定義，確定它們符合 SDK 產生器需求。 - -此「{{site.data.keyword.IBM_notm}} SDK 產生器」外掛程式可讓您使用產生的 SDK 將後端服務輕鬆地整合至應用程式。REST API 變更時，您可以重新產生 SDK，並取代舊的 SDK 以進行無縫式 SDK 升級。您也可以將 CLI 整合至 DevOps 管線，並確定 SDK 在每次建置應用程式時一律與 API 規格一致。 - -REST API 定義必須有效，並且在即時伺服器端點上或您系統的本端檔案上進行管理。如果管理 REST API 定義，則相對 URL 必須定義於 `OPENAPI_SPEC` 環境變數。 - - -## 需求 -{: #prereqs} - -請確定您滿足下列需求。 - -* 您具有 [{{site.data.keyword.Bluemix_notm}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://bluemix.net) 帳戶 -* 符合 [Open API ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.openapis.org/) 規格的有效 API 定義 - - -## 安裝 -{: #installation} - -1. [安裝 {{site.data.keyword.Bluemix}} CLI ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://clis.ng.bluemix.net/ui/home.html)。 - -2. [安裝外掛程式 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in)。 - - ``` - bx plugin install sdk-gen -r Bluemix - ``` - {: codeblock} - - -## 指令 -{: #commands} - -使用下列指令以產生 SDK、驗證 Open API 定義檔，或列出 Cloud Foundry 應用程式。 - - -### 產生 SDK -{: #gen} - -使用 `bluemix sdk generate [arguments...][command options]`。 - - -#### 引數 -{: #gen-args} - -* `APP_NAME` - 現行空間中 Cloud Foundry 應用程式的名稱 -* `OPENAPI_DOC_LOCATION` - 原始 REST API 定義 JSON 或 Yaml 的 URL 或相對檔案路徑 -* `GENERATED_SDK_NAME`（選用）- 所產生 SDK 的名稱 - - -#### 選項 -{: #gen-options} - -* `PLATFORM`（必要） - * `--android` - 產生 Android SDK - * `--ios` - 產生 iOS Swift SDK - * `--swift` - 產生 Swift 伺服器 SDK -* `--output "YOUR_RELATIVE_PATH"`（選用）- 將產生的 SDK 放入 `YOUR_RELATIVE_PATH` 所指定的目錄（如果有現有的 SDK，則會進行覆寫） -* `--unzip`（選用）- 解壓縮產生的 SDK（如果有現有的 SDK 構件，則會進行覆寫） - - -#### 用法 -{: #gen-usage} - -若要從 {{site.data.keyword.Bluemix_notm}} 中執行的 Cloud Foundry 應用程式產生 SDK，您可以使用應用程式的名稱作為 CLI 的參數。下列指令使用應用程式的名稱作為 `SDK_Name`。 - -``` -bluemix sdk generate [APP_NAME] [PLATFORM] -``` -{: codeblock} - -若要從 Open API 定義檔或者本端 JSON 或 Yaml 檔案的 URL 產生 SDK，請使用下列指令。 - -``` -bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] -``` -{: codeblock} - - -### 驗證 Open API 定義 -{: #validating} - -使用 `bluemix sdk validate [argument]`。 - - -#### 引數 -{: #val-args} - -* `APP_NAME` - 現行空間中 Cloud Foundry 應用程式的名稱 -* `OPENAPI_DOC_LOCATION` - 原始 REST API 定義 JSON 或 Yaml 的 URL 或相對檔案路徑 - - -#### 用法 -{: #val-usage} - -若要驗證 {{site.data.keyword.Bluemix_notm}} 中執行之 Cloud Foundry 應用程式的 API 規格，您可以使用應用程式的名稱作為 CLI 的參數。 - -``` -bluemix sdk validate [APP_NAME] -``` -{: codeblock} - -若要從 API 規格文件或者本端 JSON 或 Yaml 檔案的 URL 驗證 SDK，請使用下列指令。 - -``` -bluemix sdk validate [OPENAPI_DOC_LOCATION] -``` -{: codeblock} - - - -### 列出應用程式 (Cloud Foundry) -{: #list-apps} - -使用 `bluemix sdk list [argument][option]` 列出應用程式以及驗證 API 規格。您必須將 `OPENAPI_SPEC` 環境變數設為管理您規格的相對 URL 路徑。 - - -#### 引數 -{: #list-args} - -* `SPACE_NAME`（選用）- 現行組織內您要搜尋應用程式的 Cloud Foundry 空間名稱。如果未提供，則會搜尋現行空間。 - - -#### 選項 -{: #list-options} - -* `--url`（選用）- 顯示清單中每一個應用程式之 Open API 定義的形式完整的 URL - - -#### 用法 -{: #list-usage} - -若要列出現行空間中的應用程式，請使用下列指令。 - -``` -bluemix sdk list -``` -{: codeblock} - -若要列出現行空間中的應用程式，並顯示 API 規格 URL，請使用下列指令。 - -``` -bluemix sdk list --url -``` -{: codeblock} - -若要列出特定空間中的應用程式，請使用下列指令。 - -``` -bluemix sdk list [SPACE_NAME] -``` -{: codeblock} - -若要列出特定空間中的應用程式，並顯示 API 規格 URL，請使用下列指令。 - -``` -bluemix sdk list [SPACE_NAME] --url -``` -{: codeblock} +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# SDK 產生器外掛程式 +{: #sdk-cli} + +「{{site.data.keyword.IBM}} SDK 產生器」外掛程式可以安裝於 [{{site.data.keyword.Bluemix_notm}} CLI ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/cli/reference/bluemix_cli/index.html)。 + +身為 {{site.data.keyword.Bluemix_notm}} 上的開發人員，您可以使用此外掛程式，從 [Open API 規格 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.openapis.org/) 相容的 REST API 定義產生 SDK。變更 REST API 定義時，可以使用此外掛程式僅重新產生 SDK，而不是重新產生整個專案。 + +您也可以查看給定空間中的 Cloud Foundry 應用程式是否有適用於產生 SDK 的 REST API 定義。最終，您可以使用「{{site.data.keyword.IBM_notm}} SDK 產生器」外掛程式來驗證任何 REST API 定義，確定它們符合 SDK 產生器需求。 + +此「{{site.data.keyword.IBM_notm}} SDK 產生器」外掛程式可讓您使用產生的 SDK 將後端服務輕鬆地整合至應用程式。REST API 變更時，您可以重新產生 SDK，並取代舊的 SDK 以進行無縫式 SDK 升級。您也可以將 CLI 整合至 DevOps 管線，並確定 SDK 在每次建置應用程式時一律與 API 規格一致。 + +REST API 定義必須有效，並且在即時伺服器端點上或您系統的本端檔案上進行管理。如果管理 REST API 定義，則相對 URL 必須定義於 `OPENAPI_SPEC` 環境變數。 + + +## 需求 +{: #prereqs} + +請確定您滿足下列需求。 + +* 您具有 [{{site.data.keyword.Bluemix_notm}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://bluemix.net) 帳戶 +* 符合 [Open API ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.openapis.org/) 規格的有效 API 定義 + + +## 安裝 +{: #installation} + +1. [安裝 {{site.data.keyword.Bluemix}} CLI ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://clis.ng.bluemix.net/ui/home.html)。 + +2. [安裝外掛程式 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/cli/reference/bluemix_cli/index.html#install_plug-in)。 + + ``` + bx plugin install sdk-gen -r Bluemix + ``` + {: codeblock} + + +## 指令 +{: #commands} + +使用下列指令以產生 SDK、驗證 Open API 定義檔，或列出 Cloud Foundry 應用程式。 + + +### 產生 SDK +{: #gen} + +使用 `bluemix sdk generate [arguments...][command options]`。 + + +#### 引數 +{: #gen-args} + +* `APP_NAME` - 現行空間中 Cloud Foundry 應用程式的名稱 +* `OPENAPI_DOC_LOCATION` - 原始 REST API 定義 JSON 或 Yaml 的 URL 或相對檔案路徑 +* `GENERATED_SDK_NAME`（選用）- 所產生 SDK 的名稱 + + +#### 選項 +{: #gen-options} + +* `PLATFORM`（必要） + * `--android` - 產生 Android SDK + * `--ios` - 產生 iOS Swift SDK + * `--swift` - 產生 Swift 伺服器 SDK +* `--output "YOUR_RELATIVE_PATH"`（選用）- 將產生的 SDK 放入 `YOUR_RELATIVE_PATH` 所指定的目錄（如果有現有的 SDK，則會進行覆寫） +* `--unzip`（選用）- 解壓縮產生的 SDK（如果有現有的 SDK 構件，則會進行覆寫） + + +#### 用法 +{: #gen-usage} + +若要從 {{site.data.keyword.Bluemix_notm}} 中執行的 Cloud Foundry 應用程式產生 SDK，您可以使用應用程式的名稱作為 CLI 的參數。下列指令使用應用程式的名稱作為 `SDK_Name`。 + +``` +bluemix sdk generate [APP_NAME] [PLATFORM] +``` +{: codeblock} + +若要從 Open API 定義檔或者本端 JSON 或 Yaml 檔案的 URL 產生 SDK，請使用下列指令。 + +``` +bluemix sdk generate [OPENAPI_DOC_LOCATION] [SDK_Name] [Platform] +``` +{: codeblock} + + +### 驗證 Open API 定義 +{: #validating} + +使用 `bluemix sdk validate [argument]`。 + + +#### 引數 +{: #val-args} + +* `APP_NAME` - 現行空間中 Cloud Foundry 應用程式的名稱 +* `OPENAPI_DOC_LOCATION` - 原始 REST API 定義 JSON 或 Yaml 的 URL 或相對檔案路徑 + + +#### 用法 +{: #val-usage} + +若要驗證 {{site.data.keyword.Bluemix_notm}} 中執行之 Cloud Foundry 應用程式的 API 規格，您可以使用應用程式的名稱作為 CLI 的參數。 + +``` +bluemix sdk validate [APP_NAME] +``` +{: codeblock} + +若要從 API 規格文件或者本端 JSON 或 Yaml 檔案的 URL 驗證 SDK，請使用下列指令。 + +``` +bluemix sdk validate [OPENAPI_DOC_LOCATION] +``` +{: codeblock} + + + +### 列出應用程式 (Cloud Foundry) +{: #list-apps} + +使用 `bluemix sdk list [argument][option]` 列出應用程式以及驗證 API 規格。您必須將 `OPENAPI_SPEC` 環境變數設為管理您規格的相對 URL 路徑。 + + +#### 引數 +{: #list-args} + +* `SPACE_NAME`（選用）- 現行組織內您要搜尋應用程式的 Cloud Foundry 空間名稱。如果未提供，則會搜尋現行空間。 + + +#### 選項 +{: #list-options} + +* `--url`（選用）- 顯示清單中每一個應用程式之 Open API 定義的形式完整的 URL + + +#### 用法 +{: #list-usage} + +若要列出現行空間中的應用程式，請使用下列指令。 + +``` +bluemix sdk list +``` +{: codeblock} + +若要列出現行空間中的應用程式，並顯示 API 規格 URL，請使用下列指令。 + +``` +bluemix sdk list --url +``` +{: codeblock} + +若要列出特定空間中的應用程式，請使用下列指令。 + +``` +bluemix sdk list [SPACE_NAME] +``` +{: codeblock} + +若要列出特定空間中的應用程式，並顯示 API 規格 URL，請使用下列指令。 + +``` +bluemix sdk list [SPACE_NAME] --url +``` +{: codeblock} diff --git a/cloudnative/nl/zh/TW/sdk_network_request.md b/cloudnative/nl/zh/TW/sdk_network_request.md index 54e1fe01b..d622e4494 100644 --- a/cloudnative/nl/zh/TW/sdk_network_request.md +++ b/cloudnative/nl/zh/TW/sdk_network_request.md @@ -1,121 +1,121 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 提出網路要求 -{: #sdk-network-request} - -您也可以使用 `BMSCore` SDK 對任何資源提出網路要求。 - -## Android -{: #request-android} - -1. 確定您已在 Android 應用程式中[匯入用戶端 SDK 並起始設定它](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android)。 - -2. 提出網路要求。 - - ``` - public void makeGetCall() { - Thread thread = new Thread(new Runnable() { - @Override - public void run() { - try { - Request request = new Request("http://httpbin.org/get", "GET"); - request.send(null, null); - } catch (Exception e) { - // Handle failure here. - } - } - }); - thread.start(); - } - ``` - {: codeblock} - -## iOS -{: #request-ios} - -1. 確定您已在 iOS 應用程式中[匯入用戶端 SDK 並起始設定它](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios)。 - -2. 建立網路要求。 - - ### Swift 3.0 - {: #ios-swift3 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - - ### Swift 2.2 - {: #ios-swift22 notoc} - - ```Swift - // Make a network request - let customResourceURL = "" - let request = Request(url: customResourceURL, method: HttpMethod.GET) - - let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in - if error == nil { - print ("response:\(response?.responseText), no error") - } else { - print ("error: \(error)") - } - } - request.send(completionHandler: callBack) - ``` - {: codeblock} - -`Request` 類別是提出 HTTP 要求並在要求完成後取得回應的簡單方法。如果您想要得到比 `Request` 類別更多的彈性與控制，可以使用 `BMSURLSession` 類別。`BMSURLSession` 類別部分特性包括監視上傳的進度，以及暫停或取消要求。若要取得回應，您可以選擇完成處理程式或委派。 - -`BMSURLSession` 類別僅適用於 iOS。如需 `BMSURLSession` 的相關資訊，請參閱 `BMSCore` SDK [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core)。 - - -## Cordova -{: #request-cordova} - -1. 確定您已在 Cordova 應用程式中[匯入用戶端 SDK 並起始設定它](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova)。 - -2. 建立網路要求。 - - ``` - var success = function(data) { - console.log("success", data); - } - var failure = function(error) - {console.log("failure", error); - } - var request = new BMSRequest("", BMSRequest.GET); - request.send(success, failure); - ``` - {: codeblock} - - -# 相關鏈結 -{: #rellinks notoc} - -## 相關鏈結 -{: #general notoc} - -* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} -* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} -* [BMSCore Cordova 外掛程式](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 提出網路要求 +{: #sdk-network-request} + +您也可以使用 `BMSCore` SDK 對任何資源提出網路要求。 + +## Android +{: #request-android} + +1. 確定您已在 Android 應用程式中[匯入用戶端 SDK 並起始設定它](/docs/mobile/sdk_BMSClient.html#init-BMSClient-android)。 + +2. 提出網路要求。 + + ``` + public void makeGetCall() { + Thread thread = new Thread(new Runnable() { + @Override + public void run() { + try { + Request request = new Request("http://httpbin.org/get", "GET"); + request.send(null, null); + } catch (Exception e) { + // Handle failure here. + } + } + }); + thread.start(); + } + ``` + {: codeblock} + +## iOS +{: #request-ios} + +1. 確定您已在 iOS 應用程式中[匯入用戶端 SDK 並起始設定它](/docs/mobile/sdk_BMSClient.html#init-BMSClient-ios)。 + +2. 建立網路要求。 + + ### Swift 3.0 + {: #ios-swift3 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: Error?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + + ### Swift 2.2 + {: #ios-swift22 notoc} + + ```Swift + // Make a network request + let customResourceURL = "" + let request = Request(url: customResourceURL, method: HttpMethod.GET) + + let callBack:BMSCompletionHandler = {(response: Response?, error: NSError?) in + if error == nil { + print ("response:\(response?.responseText), no error") + } else { + print ("error: \(error)") + } + } + request.send(completionHandler: callBack) + ``` + {: codeblock} + +`Request` 類別是提出 HTTP 要求並在要求完成後取得回應的簡單方法。如果您想要得到比 `Request` 類別更多的彈性與控制，可以使用 `BMSURLSession` 類別。`BMSURLSession` 類別部分特性包括監視上傳的進度，以及暫停或取消要求。若要取得回應，您可以選擇完成處理程式或委派。 + +`BMSURLSession` 類別僅適用於 iOS。如需 `BMSURLSession` 的相關資訊，請參閱 `BMSCore` SDK [README](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core)。 + + +## Cordova +{: #request-cordova} + +1. 確定您已在 Cordova 應用程式中[匯入用戶端 SDK 並起始設定它](/docs/mobile/sdk_BMSClient.html#init-BMSClient-cordova)。 + +2. 建立網路要求。 + + ``` + var success = function(data) { + console.log("success", data); + } + var failure = function(error) + {console.log("failure", error); + } + var request = new BMSRequest("", BMSRequest.GET); + request.send(success, failure); + ``` + {: codeblock} + + +# 相關鏈結 +{: #rellinks notoc} + +## 相關鏈結 +{: #general notoc} + +* [BMSCore Android SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-core){: new_window} +* [BMSCore iOS SDK](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-core){: new_window} +* [BMSCore Cordova 外掛程式](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-core){: new_window} diff --git a/cloudnative/nl/zh/TW/services.md b/cloudnative/nl/zh/TW/services.md index b269fc33f..6abb42e42 100644 --- a/cloudnative/nl/zh/TW/services.md +++ b/cloudnative/nl/zh/TW/services.md @@ -1,54 +1,54 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} - -# 服務 -{: #services} - -從 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} **服務**頁面中，您可以檢視現有 Web 及行動服務，或建立新服務。主控台提供單一位置，來檢視專案所管理的所有 {{site.data.keyword.Bluemix_notm}} Web 及行動服務。 - -如果您從**服務**視圖中刪除服務，則會中斷服務與相關聯專案的連線。如果您要將服務重新連接至專案，請建立新的服務實例。 - -## {{site.data.keyword.Bluemix_notm}} Web 及行動服務概觀 -{: #mobile_services_overview} - -下表說明 {{site.data.keyword.Bluemix_notm}} Web 及行動服務。您可以使用 {{site.data.keyword.Bluemix_notm}} 型錄中的個別服務，或者可以將它們整合至專案。 - - - - - - - - - - - - - - - - - - - -
表格 1. {{site.data.keyword.Bluemix_notm}} Web 及行動服務
{{site.data.keyword.Bluemix_notm}} Web 及行動服務說明
{{site.data.keyword.mobileanalytics_short}} 圖示
{{site.data.keyword.mobileanalytics_short}}		使用 {{site.data.keyword.mobileanalytics_full}} 服務來瞭解行動應用程式的執行方式及其使用方式。

-深入閱讀 {{site.data.keyword.mobileanalytics_short}} 文件中操作此服務的相關資訊。 -
{{site.data.keyword.mobilefoundation_short}} 服務圖示
{{site.data.keyword.mobilefoundation_short}}		使用 {{site.data.keyword.mobilefoundation_long}} 服務來加快設定 {{site.data.keyword.mfp_full}} 環境，您可以從中開發、測試及操作企業行動應用程式。

-深入閱讀 {{site.data.keyword.mobilefoundation_short}} 文件中操作此服務的相關資訊。
{{site.data.keyword.mobilepushshort}} 服務圖示
{{site.data.keyword.mobilepushshort}}		{{site.data.keyword.mobilepushfull}} 服務服務提供一個統一平台，來傳送及管理目標設為各種平台的行動及 Web 推送通知。 -

-{{site.data.keyword.mobilepushshort}} 可管理應用程式使用者與其裝置、裝置平台、Web 瀏覽器的對映，並處理如何將推送通知分派給他們。您可以將播送、單點播送（根據 userID、deviceID），以及標籤（或主題）當作推送通知傳送給行動及 Web 瀏覽器應用程式使用者。您也可以使用 SDK 及 REST API，進一步開發用戶端應用程式。 -

-深入閱讀 {{site.data.keyword.mobilepushshort}} 文件中操作此服務的相關資訊。
+--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} + +# 服務 +{: #services} + +從 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} **服務**頁面中，您可以檢視現有 Web 及行動服務，或建立新服務。主控台提供單一位置，來檢視專案所管理的所有 {{site.data.keyword.Bluemix_notm}} Web 及行動服務。 + +如果您從**服務**視圖中刪除服務，則會中斷服務與相關聯專案的連線。如果您要將服務重新連接至專案，請建立新的服務實例。 + +## {{site.data.keyword.Bluemix_notm}} Web 及行動服務概觀 +{: #mobile_services_overview} + +下表說明 {{site.data.keyword.Bluemix_notm}} Web 及行動服務。您可以使用 {{site.data.keyword.Bluemix_notm}} 型錄中的個別服務，或者可以將它們整合至專案。 + + + + + + + + + + + + + + + + + + + +
表格 1. {{site.data.keyword.Bluemix_notm}} Web 及行動服務
{{site.data.keyword.Bluemix_notm}} Web 及行動服務說明
{{site.data.keyword.mobileanalytics_short}} 圖示
{{site.data.keyword.mobileanalytics_short}}		使用 {{site.data.keyword.mobileanalytics_full}} 服務來瞭解行動應用程式的執行方式及其使用方式。

+深入閱讀 {{site.data.keyword.mobileanalytics_short}} 文件中操作此服務的相關資訊。 +
{{site.data.keyword.mobilefoundation_short}} 服務圖示
{{site.data.keyword.mobilefoundation_short}}		使用 {{site.data.keyword.mobilefoundation_long}} 服務來加快設定 {{site.data.keyword.mfp_full}} 環境，您可以從中開發、測試及操作企業行動應用程式。

+深入閱讀 {{site.data.keyword.mobilefoundation_short}} 文件中操作此服務的相關資訊。
{{site.data.keyword.mobilepushshort}} 服務圖示
{{site.data.keyword.mobilepushshort}}		{{site.data.keyword.mobilepushfull}} 服務服務提供一個統一平台，來傳送及管理目標設為各種平台的行動及 Web 推送通知。 +

+{{site.data.keyword.mobilepushshort}} 可管理應用程式使用者與其裝置、裝置平台、Web 瀏覽器的對映，並處理如何將推送通知分派給他們。您可以將播送、單點播送（根據 userID、deviceID），以及標籤（或主題）當作推送通知傳送給行動及 Web 瀏覽器應用程式使用者。您也可以使用 SDK 及 REST API，進一步開發用戶端應用程式。 +

+深入閱讀 {{site.data.keyword.mobilepushshort}} 文件中操作此服務的相關資訊。
diff --git a/cloudnative/nl/zh/TW/starters.md b/cloudnative/nl/zh/TW/starters.md index 2d9de248e..a978918b4 100644 --- a/cloudnative/nl/zh/TW/starters.md +++ b/cloudnative/nl/zh/TW/starters.md @@ -1,26 +1,26 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 入門範本 -{: #starters} - -使用 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}，您可以選擇每一個型樣類型的各種入門範本。 - -「入門範本」已最佳化成可進入正式作業的入門範本程式碼，其著重於示範主要 {{site.data.keyword.Bluemix_notm}} 與高價值服務的整合。每一個入門範本都著重於一項服務，並顯示如何將服務 SDK 整合至程式碼。在某些情況下，入門範本提供簡單的使用者體驗，強調顯示如何整合服務資料或與使用者的互動。每一個入門範本都已配置成啟用鑑別、資料及可能的其他功能（如果您決定為專案配置這些功能）。 - - -## 指導教學 -{: #tutorials notoc} - -如需其他如何使用入門範本建立應用程式的深度指示，您可以使用完整[指導教學](tutorials.html)。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 入門範本 +{: #starters} + +使用 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}}，您可以選擇每一個型樣類型的各種入門範本。 + +「入門範本」已最佳化成可進入正式作業的入門範本程式碼，其著重於示範主要 {{site.data.keyword.Bluemix_notm}} 與高價值服務的整合。每一個入門範本都著重於一項服務，並顯示如何將服務 SDK 整合至程式碼。在某些情況下，入門範本提供簡單的使用者體驗，強調顯示如何整合服務資料或與使用者的互動。每一個入門範本都已配置成啟用鑑別、資料及可能的其他功能（如果您決定為專案配置這些功能）。 + + +## 指導教學 +{: #tutorials notoc} + +如需其他如何使用入門範本建立應用程式的深度指示，您可以使用完整[指導教學](tutorials.html)。 diff --git a/cloudnative/nl/zh/TW/troubleshoot.md b/cloudnative/nl/zh/TW/troubleshoot.md index 270fc41ac..547e079a8 100644 --- a/cloudnative/nl/zh/TW/troubleshoot.md +++ b/cloudnative/nl/zh/TW/troubleshoot.md @@ -1,223 +1,223 @@ ---- - -copyright: - years: 2017 -lastupdated: "2017-03-17" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# 疑難排解 -{: #ts} - -記載 {{site.data.keyword.dev_cli_notm}} 的部分已知問題及其暫行解決方法。 -{:shortdesc} - - - -## 已知問題 -{: #knownissues} - -下列各節說明已知問題及可能的解決方法。 - - -### 在建立具有非行動型樣的專案時發生主機名稱採用錯誤 -{: #hostname} - -如果您使用 {{site.data.keyword.dev_cli_short}} 以從「Web 應用程式」、BFF 或 Microservice 型樣建立專案，則可能會看到下列錯誤： - -``` -The hostname is taken. -``` -{: codeblock} - - -#### 原因 -{: #hostname-cause} - -此錯誤是由於登入記號過期所造成。 - - -#### 解決方法 -{: #hostname-resolution} - -請重新登入。 - -``` -bx login -``` -{: codeblock} - - -### {{site.data.keyword.dev_cli_short}} 的一般性失敗 -{: #general} - -如果您使用 {{site.data.keyword.dev_cli_short}} 來建立、刪除、列出或編寫指令，則可能會看到下列錯誤： - -``` -Failed to project. -``` -{: codeblock} - - -#### 原因 -{: #hostname-cause} - -此錯誤是由於登入記號過期所造成。 - - -#### 解決方法 -{: #hostname-resolution} - -請重新登入。 - -``` -bx login -``` -{: codeblock} - - -### 新增 {{site.data.keyword.objectstorageshort}} 功能時發生服務分配管理系統錯誤 -{: #os} - -如果您使用 {{site.data.keyword.dev_cli_short}} 來建立具有 {{site.data.keyword.objectstorageshort}} 功能的兩個專案，則可能會看到下列錯誤： - -``` -FAILED -Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} -``` -{: codeblock} - - -#### 原因 -{: #os-cause} - -此錯誤是由於 {{site.data.keyword.objectstorageshort}} 服務只容許一個「免費 {{site.data.keyword.objectstorageshort}}」方案實例所造成。 - - -#### 解決方法 -{: #os-resolution} - -系統會提示您選擇不同方案來避免此錯誤。 - - -### 在建立專案期間取得程式碼失敗 -{: #code} - -如果您使用 {{site.data.keyword.dev_cli_short}} 來建立專案，則可能會看到下列錯誤： - -``` -FAILED -Project created, but could not get code -https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code -``` -{: codeblock} - - -#### 原因 -{: #code-cause} - -此錯誤是由於內部逾時所造成。 - - -#### 解決方法 -{: #code-resolution} - -您可以使用下列一種方式來取得程式碼： - -* 使用 CLI 執行下列指令: - - ``` - bx dev code - ``` - {: codeblock} - - `` 應該取代為建立專案期間所使用的專案名稱。 - -* 使用 {{site.data.keyword.dev_console}}。 - - 1. 在 {{site.data.keyword.dev_console}} 中選取[專案 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://console.{DomainName}/developer/projects)，然後按一下**取得程式碼**。 - - 2. 按一下**產生程式碼**。 - - 3. 產生程式碼之後，請按一下**下載程式碼**。 - - -### 針對 Node.js 專案執行 `bx dev run` 時發生錯誤 -{: #node} - -如果您是針對 Node.js Web 或 BFF 專案搭配執行 `bx dev run` 與 {{site.data.keyword.dev_cli_short}}，則可能會看到下列錯誤： - -``` -module.js:597 - return process.dlopen(module, path._makeLong(filename)); - ^ - -Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header - at Error (native) - at Object.Module._extensions..node (module.js:597:18) - at Module.load (module.js:487:32) - at tryModuleLoad (module.js:446:12) - - at Function.Module._load (module.js:438:3) - at Module.require (module.js:497:17) - at require (internal/module.js:20:19) - at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) - at Module._compile (module.js:570:32) - at Object.Module._extensions..js (module.js:579:10) -``` -{: codeblock} - - -#### 原因 -{: #node-cause} - -此錯誤是由於將 `appmetrics` 模組安裝在不同架構中所造成。安裝在某個架構上的原生 npm 模組，不能在另一個架構上運作。包括的 Docker 映像檔是以 Linux Kernel 為依據。 - - -#### 解決方法 -{: #node-resolution} - -刪除 `node_modules` 資料夾，並再次執行 `bx dev run`。 - - - - - - - -## 取得協助及支援 -{: #gettinghelp} - -如果您在使用 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 或 {{site.data.keyword.dev_cli_notm}} 時發生問題或有疑問，可以搜尋資訊或透過討論區提問來取得協助。您也可以開啟支援問題單。 - -使用討論區提問時，請標記您的問題，讓 {{site.data.keyword.Bluemix_notm}} 開發團隊可以看到它。 - - - -如果您有使用 {{site.data.keyword.dev_console}} 或 {{site.data.keyword.dev_cli_notm}} 開發或部署應用程式的技術問題，請執行下列動作： - -* 將問題張貼在 [Stack Overflow ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix)，並且使用 `bluemix-dev-services` 及 `ibm-bluemix` 來標記您的問題。 -* 將問題張貼在 `bluemix-dev-services` 通道中的 [Slack ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://ibm-cloud-tech.slack.com/) 上。請馬上[註冊 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://ibm.biz/IBMCloudNativeSlack)。 - - - - - -如需使用討論區的詳細資料，請參閱[取得協助 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/support/index.html#getting-help)。 - -如需開啟 {{site.data.keyword.IBM}} 支援問題單或是支援層次及問題單嚴重性的相關資訊，請參閱[與支援中心聯絡 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/support/index.html#contacting-support)。 - - - +--- + +copyright: + years: 2017 +lastupdated: "2017-03-17" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# 疑難排解 +{: #ts} + +記載 {{site.data.keyword.dev_cli_notm}} 的部分已知問題及其暫行解決方法。 +{:shortdesc} + + + +## 已知問題 +{: #knownissues} + +下列各節說明已知問題及可能的解決方法。 + + +### 在建立具有非行動型樣的專案時發生主機名稱採用錯誤 +{: #hostname} + +如果您使用 {{site.data.keyword.dev_cli_short}} 以從「Web 應用程式」、BFF 或 Microservice 型樣建立專案，則可能會看到下列錯誤： + +``` +The hostname is taken. +``` +{: codeblock} + + +#### 原因 +{: #hostname-cause} + +此錯誤是由於登入記號過期所造成。 + + +#### 解決方法 +{: #hostname-resolution} + +請重新登入。 + +``` +bx login +``` +{: codeblock} + + +### {{site.data.keyword.dev_cli_short}} 的一般性失敗 +{: #general} + +如果您使用 {{site.data.keyword.dev_cli_short}} 來建立、刪除、列出或編寫指令，則可能會看到下列錯誤： + +``` +Failed to project. +``` +{: codeblock} + + +#### 原因 +{: #hostname-cause} + +此錯誤是由於登入記號過期所造成。 + + +#### 解決方法 +{: #hostname-resolution} + +請重新登入。 + +``` +bx login +``` +{: codeblock} + + +### 新增 {{site.data.keyword.objectstorageshort}} 功能時發生服務分配管理系統錯誤 +{: #os} + +如果您使用 {{site.data.keyword.dev_cli_short}} 來建立具有 {{site.data.keyword.objectstorageshort}} 功能的兩個專案，則可能會看到下列錯誤： + +``` +FAILED +Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."} +``` +{: codeblock} + + +#### 原因 +{: #os-cause} + +此錯誤是由於 {{site.data.keyword.objectstorageshort}} 服務只容許一個「免費 {{site.data.keyword.objectstorageshort}}」方案實例所造成。 + + +#### 解決方法 +{: #os-resolution} + +系統會提示您選擇不同方案來避免此錯誤。 + + +### 在建立專案期間取得程式碼失敗 +{: #code} + +如果您使用 {{site.data.keyword.dev_cli_short}} 來建立專案，則可能會看到下列錯誤： + +``` +FAILED +Project created, but could not get code +https://console.ng.bluemix.net/developer/projects/b22165f3-cbc6-4f73-876f-e33cbec199d4/code +``` +{: codeblock} + + +#### 原因 +{: #code-cause} + +此錯誤是由於內部逾時所造成。 + + +#### 解決方法 +{: #code-resolution} + +您可以使用下列一種方式來取得程式碼： + +* 使用 CLI 執行下列指令: + + ``` + bx dev code + ``` + {: codeblock} + + `` 應該取代為建立專案期間所使用的專案名稱。 + +* 使用 {{site.data.keyword.dev_console}}。 + + 1. 在 {{site.data.keyword.dev_console}} 中選取[專案 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://console.{DomainName}/developer/projects)，然後按一下**取得程式碼**。 + + 2. 按一下**產生程式碼**。 + + 3. 產生程式碼之後，請按一下**下載程式碼**。 + + +### 針對 Node.js 專案執行 `bx dev run` 時發生錯誤 +{: #node} + +如果您是針對 Node.js Web 或 BFF 專案搭配執行 `bx dev run` 與 {{site.data.keyword.dev_cli_short}}，則可能會看到下列錯誤： + +``` +module.js:597 + return process.dlopen(module, path._makeLong(filename)); + ^ + +Error: /app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/appmetrics.node: invalid ELF header + at Error (native) + at Object.Module._extensions..node (module.js:597:18) + at Module.load (module.js:487:32) + at tryModuleLoad (module.js:446:12) + + at Function.Module._load (module.js:438:3) + at Module.require (module.js:497:17) + at require (internal/module.js:20:19) + at Object. (/app/node_modules/bluemix-autoscaling-agent/node_modules/appmetrics/index.js:25:13) + at Module._compile (module.js:570:32) + at Object.Module._extensions..js (module.js:579:10) +``` +{: codeblock} + + +#### 原因 +{: #node-cause} + +此錯誤是由於將 `appmetrics` 模組安裝在不同架構中所造成。安裝在某個架構上的原生 npm 模組，不能在另一個架構上運作。包括的 Docker 映像檔是以 Linux Kernel 為依據。 + + +#### 解決方法 +{: #node-resolution} + +刪除 `node_modules` 資料夾，並再次執行 `bx dev run`。 + + + + + + + +## 取得協助及支援 +{: #gettinghelp} + +如果您在使用 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 或 {{site.data.keyword.dev_cli_notm}} 時發生問題或有疑問，可以搜尋資訊或透過討論區提問來取得協助。您也可以開啟支援問題單。 + +使用討論區提問時，請標記您的問題，讓 {{site.data.keyword.Bluemix_notm}} 開發團隊可以看到它。 + + + +如果您有使用 {{site.data.keyword.dev_console}} 或 {{site.data.keyword.dev_cli_notm}} 開發或部署應用程式的技術問題，請執行下列動作： + +* 將問題張貼在 [Stack Overflow ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://stackoverflow.com/search?q=bluemix-dev-services+ibm-bluemix)，並且使用 `bluemix-dev-services` 及 `ibm-bluemix` 來標記您的問題。 +* 將問題張貼在 `bluemix-dev-services` 通道中的 [Slack ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://ibm-cloud-tech.slack.com/) 上。請馬上[註冊 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](http://ibm.biz/IBMCloudNativeSlack)。 + + + + + +如需使用討論區的詳細資料，請參閱[取得協助 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/support/index.html#getting-help)。 + +如需開啟 {{site.data.keyword.IBM}} 支援問題單或是支援層次及問題單嚴重性的相關資訊，請參閱[與支援中心聯絡 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/support/index.html#contacting-support)。 + + + diff --git a/cloudnative/nl/zh/TW/tutorial_bff.md b/cloudnative/nl/zh/TW/tutorial_bff.md index 1d7b341fd..24b11ae1b 100644 --- a/cloudnative/nl/zh/TW/tutorial_bff.md +++ b/cloudnative/nl/zh/TW/tutorial_bff.md @@ -1,147 +1,147 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# BFF Basic Starter 的完整指導教學 -{: #tutorial} - -下列完整指導教學逐步執行從 BFF Basic Starter 建立專案的步驟，包括您必須安裝的工具，以及執行專案程式碼的步驟。 - -## 安裝開發人員工具 -{: #dev_tools} - -請確定您已安裝[必備開發人員工具 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](get_code.html#prereq-dev-tools){: new_window}。 - - -## 使用 {{site.data.keyword.dev_console}} 建立專案 -{: #create-devex} - -1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中建立專案。 - - 1. 從 {{site.data.keyword.dev_console}} 的**開始使用**頁面中，按一下**建立專案**。 - - 您也可以按一下**專案**頁面中的**建立專案**。 - - 2. 選取 **Backend for Frontend**，然後按**下一步**。 - - 3. 選取 **Basic Backend**，然後按**下一步**。 - - 4. 輸入專案名稱。對於此指導教學，使用 `BFFProject`。 - - 5. 輸入主機名稱。對於此指導教學，使用 `devhost`。 - - 6. 選取語言平台。對於此指導教學，使用 `Node`。 - - 7. 按一下**建立**。 - -2. 選用項目：新增「資料」功能。 - - 1. 在**專案概觀**頁面上，針對**資料**按一下**檢視**。 - - 您也可以選取**功能 > 資料**頁面上的**建立**或**新增現有項目**。 - - 2. 輸入服務名稱，然後按一下**建立**。 - - -3. 產生專案程式碼。 - - 1. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 - - 您也可以按一下**程式碼**頁面。 - - 2. 按一下**產生程式碼**。 - - 3. 當專案程式碼生成完成時，請按一下**下載程式碼**來下載專案保存檔。 - -4. 選用項目：[更新專案](project_overview_page.html#update_language)以產生新語言。 - - -## 使用 {{site.data.keyword.dev_cli_notm}} 建立專案 -{: #create-cli} - -1. 確定您已安裝 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 - -2. 在「終端機」提示字元中，導覽至您選擇的本端目錄，然後執行下列指令。 - - ``` - bx dev create - ``` - {: codeblock} - -3. 系統提示時，提供下列值： - - * 選取型樣：3（適用於 Backend for Frontend） - * 選取入門範本：1（適用於 Basic Backend） - * 選取語言：1（適用於 Node） - * 輸入專案的名稱：`BFFProjectCLI` - * 輸入專案的主機名稱：`myhost` - -4. 如果您要將服務新增至專案，請在問題提示字元中鍵入 `y`，並回答其餘的問題。 - -5. 順利儲存 `BFFProjectCLI` 後，請導覽至 `BFFProjectCLI` 資料夾。 - -6. 此時，您可能會新增自己的程式碼、建置或執行專案。 - - 1. 使用下列指令來建置專案： - - ``` - bx dev build - ``` - {: codeblock} - - 2. 使用下列指令來執行專案： - - ``` - bx dev run - ``` - {: codeblock} - - -## 執行 BFF 專案 -{: #running-bff} - -### 本端 -{: #bff-local} - -1. 編譯伺服器： - - ``` - swift build - ``` - {: codeblock} - -2. 執行應用程式。例如，假設您的應用程式稱為 `MyServer`： - - ``` - .build/debug/MyServer - ``` - {: codeblock} - -3. 您可以使用 `curl http://localhost:8080`，在伺服器上執行 curl。 - - -### 使用 Bluemix 外掛程式 -{: #using-blumix} - -1. 執行編譯 - - ``` - bx dev run - ``` - {: codeblock} - -2. 您可以使用下列項目在伺服器上執行 curl： - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# BFF Basic Starter 的完整指導教學 +{: #tutorial} + +下列完整指導教學逐步執行從 BFF Basic Starter 建立專案的步驟，包括您必須安裝的工具，以及執行專案程式碼的步驟。 + +## 安裝開發人員工具 +{: #dev_tools} + +請確定您已安裝[必備開發人員工具 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](get_code.html#prereq-dev-tools){: new_window}。 + + +## 使用 {{site.data.keyword.dev_console}} 建立專案 +{: #create-devex} + +1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中建立專案。 + + 1. 從 {{site.data.keyword.dev_console}} 的**開始使用**頁面中，按一下**建立專案**。 + + 您也可以按一下**專案**頁面中的**建立專案**。 + + 2. 選取 **Backend for Frontend**，然後按**下一步**。 + + 3. 選取 **Basic Backend**，然後按**下一步**。 + + 4. 輸入專案名稱。對於此指導教學，使用 `BFFProject`。 + + 5. 輸入主機名稱。對於此指導教學，使用 `devhost`。 + + 6. 選取語言平台。對於此指導教學，使用 `Node`。 + + 7. 按一下**建立**。 + +2. 選用項目：新增「資料」功能。 + + 1. 在**專案概觀**頁面上，針對**資料**按一下**檢視**。 + + 您也可以選取**功能 > 資料**頁面上的**建立**或**新增現有項目**。 + + 2. 輸入服務名稱，然後按一下**建立**。 + + +3. 產生專案程式碼。 + + 1. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 + + 您也可以按一下**程式碼**頁面。 + + 2. 按一下**產生程式碼**。 + + 3. 當專案程式碼生成完成時，請按一下**下載程式碼**來下載專案保存檔。 + +4. 選用項目：[更新專案](project_overview_page.html#update_language)以產生新語言。 + + +## 使用 {{site.data.keyword.dev_cli_notm}} 建立專案 +{: #create-cli} + +1. 確定您已安裝 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 + +2. 在「終端機」提示字元中，導覽至您選擇的本端目錄，然後執行下列指令。 + + ``` + bx dev create + ``` + {: codeblock} + +3. 系統提示時，提供下列值： + + * 選取型樣：3（適用於 Backend for Frontend） + * 選取入門範本：1（適用於 Basic Backend） + * 選取語言：1（適用於 Node） + * 輸入專案的名稱：`BFFProjectCLI` + * 輸入專案的主機名稱：`myhost` + +4. 如果您要將服務新增至專案，請在問題提示字元中鍵入 `y`，並回答其餘的問題。 + +5. 順利儲存 `BFFProjectCLI` 後，請導覽至 `BFFProjectCLI` 資料夾。 + +6. 此時，您可能會新增自己的程式碼、建置或執行專案。 + + 1. 使用下列指令來建置專案： + + ``` + bx dev build + ``` + {: codeblock} + + 2. 使用下列指令來執行專案： + + ``` + bx dev run + ``` + {: codeblock} + + +## 執行 BFF 專案 +{: #running-bff} + +### 本端 +{: #bff-local} + +1. 編譯伺服器： + + ``` + swift build + ``` + {: codeblock} + +2. 執行應用程式。例如，假設您的應用程式稱為 `MyServer`： + + ``` + .build/debug/MyServer + ``` + {: codeblock} + +3. 您可以使用 `curl http://localhost:8080`，在伺服器上執行 curl。 + + +### 使用 Bluemix 外掛程式 +{: #using-blumix} + +1. 執行編譯 + + ``` + bx dev run + ``` + {: codeblock} + +2. 您可以使用下列項目在伺服器上執行 curl： + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/zh/TW/tutorial_microservice.md b/cloudnative/nl/zh/TW/tutorial_microservice.md index 4528e2e11..7e5116b6e 100644 --- a/cloudnative/nl/zh/TW/tutorial_microservice.md +++ b/cloudnative/nl/zh/TW/tutorial_microservice.md @@ -1,113 +1,113 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Microservice Basic Starter 的完整指導教學 -{: #tutorial} - -下列完整指導教學逐步執行從 Microservice Basic Starter 建立專案的步驟，包括您必須安裝的工具，以及執行專案程式碼的步驟。 - -## 安裝開發人員工具 -{: #dev_tools} - -請確定您已安裝[必備開發人員工具 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](get_code.html#prereq-dev-tools){: new_window}。 - - -## 使用 {{site.data.keyword.dev_console}} 建立專案 -{: #create-devex} - -1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中建立專案。 - - 1. 從 {{site.data.keyword.dev_console}} 的**開始使用**頁面中，按一下**建立專案**。 - - 您也可以按一下**專案**頁面中的**建立專案**。 - - 2. 選取 **Microservice**，然後按**下一步**。 - - 3. 選取 **Basic**，然後按**下一步**。 - - 4. 輸入專案名稱。對於此指導教學，使用 `MicroserviceProject`。 - - 5. 輸入主機名稱。對於此指導教學，使用 `devhost`。 - - 6. 按一下**建立**。 - -2. 選用項目：新增「資料」功能。 - - 1. 在**專案概觀**頁面上，針對**資料**按一下**檢視**。 - - 您也可以選取**功能 > 資料**頁面上的**建立**或**新增現有項目**。 - - 2. 輸入服務名稱，然後按一下**建立**。 - -3. 產生專案程式碼。 - - 1. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 - - 您也可以按一下**程式碼**頁面。 - - 2. 按一下**產生程式碼**。 - - 3. 當專案程式碼生成完成時，請按一下**下載程式碼**來下載專案保存檔。 - -4. 選用項目：[更新專案](project_overview_page.html#update_language)以產生新語言。 - - -## 使用 {{site.data.keyword.dev_cli_notm}} 建立專案 -{: #create-cli} - -1. 確定您已安裝 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 - -2. 在「終端機」提示字元中，導覽至您選擇的本端目錄，然後執行下列指令。 - - ``` - bx dev create - ``` - {: codeblock} - -3. 系統提示時，提供下列值： - - * 選取型樣：4（適用於 Microservice） - * 選取入門範本：1（適用於 Basic） - * 選取平台：3（適用於 Java） - * 輸入專案的名稱：`MicroserviceProjectCLI` - -4. 如果您要將服務新增至專案，請在問題提示字元中鍵入 `y`，並回答其餘的問題。 - -5. 順利儲存 `MicroserviceProjectCLI` 後，請導覽至 `MicroserviceProjectCLI` 資料夾。 - -6. 此時，您可能會新增自己的程式碼、建置或執行專案。 - - -## 使用 {{site.data.keyword.dev_cli_notm}} 執行專案 -{: #running-dev-plugin} - -1. 若要在現行專案目錄中建置專案，請輸入下列指令： - - ``` - bx dev build - ``` - {: codeblock} - -2. 若要在現行專案目錄中建置及執行專案，請輸入下列指令： - - ``` - bx dev run - ``` - {: codeblock} - -3. 您可以在伺服器上使用 curl 來存取應用程式： - - ``` - curl http://localhost:8080 - ``` - {: codeblock} +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Microservice Basic Starter 的完整指導教學 +{: #tutorial} + +下列完整指導教學逐步執行從 Microservice Basic Starter 建立專案的步驟，包括您必須安裝的工具，以及執行專案程式碼的步驟。 + +## 安裝開發人員工具 +{: #dev_tools} + +請確定您已安裝[必備開發人員工具 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](get_code.html#prereq-dev-tools){: new_window}。 + + +## 使用 {{site.data.keyword.dev_console}} 建立專案 +{: #create-devex} + +1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中建立專案。 + + 1. 從 {{site.data.keyword.dev_console}} 的**開始使用**頁面中，按一下**建立專案**。 + + 您也可以按一下**專案**頁面中的**建立專案**。 + + 2. 選取 **Microservice**，然後按**下一步**。 + + 3. 選取 **Basic**，然後按**下一步**。 + + 4. 輸入專案名稱。對於此指導教學，使用 `MicroserviceProject`。 + + 5. 輸入主機名稱。對於此指導教學，使用 `devhost`。 + + 6. 按一下**建立**。 + +2. 選用項目：新增「資料」功能。 + + 1. 在**專案概觀**頁面上，針對**資料**按一下**檢視**。 + + 您也可以選取**功能 > 資料**頁面上的**建立**或**新增現有項目**。 + + 2. 輸入服務名稱，然後按一下**建立**。 + +3. 產生專案程式碼。 + + 1. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 + + 您也可以按一下**程式碼**頁面。 + + 2. 按一下**產生程式碼**。 + + 3. 當專案程式碼生成完成時，請按一下**下載程式碼**來下載專案保存檔。 + +4. 選用項目：[更新專案](project_overview_page.html#update_language)以產生新語言。 + + +## 使用 {{site.data.keyword.dev_cli_notm}} 建立專案 +{: #create-cli} + +1. 確定您已安裝 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 + +2. 在「終端機」提示字元中，導覽至您選擇的本端目錄，然後執行下列指令。 + + ``` + bx dev create + ``` + {: codeblock} + +3. 系統提示時，提供下列值： + + * 選取型樣：4（適用於 Microservice） + * 選取入門範本：1（適用於 Basic） + * 選取平台：3（適用於 Java） + * 輸入專案的名稱：`MicroserviceProjectCLI` + +4. 如果您要將服務新增至專案，請在問題提示字元中鍵入 `y`，並回答其餘的問題。 + +5. 順利儲存 `MicroserviceProjectCLI` 後，請導覽至 `MicroserviceProjectCLI` 資料夾。 + +6. 此時，您可能會新增自己的程式碼、建置或執行專案。 + + +## 使用 {{site.data.keyword.dev_cli_notm}} 執行專案 +{: #running-dev-plugin} + +1. 若要在現行專案目錄中建置專案，請輸入下列指令： + + ``` + bx dev build + ``` + {: codeblock} + +2. 若要在現行專案目錄中建置及執行專案，請輸入下列指令： + + ``` + bx dev run + ``` + {: codeblock} + +3. 您可以在伺服器上使用 curl 來存取應用程式： + + ``` + curl http://localhost:8080 + ``` + {: codeblock} diff --git a/cloudnative/nl/zh/TW/tutorial_mobile.md b/cloudnative/nl/zh/TW/tutorial_mobile.md index 595323d26..8555ed236 100644 --- a/cloudnative/nl/zh/TW/tutorial_mobile.md +++ b/cloudnative/nl/zh/TW/tutorial_mobile.md @@ -1,187 +1,187 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Mobile Basic Starter 的完整指導教學 -{: #tutorial} - -下列完整指導教學逐步執行從 Mobile Basic Starter 建立專案的步驟，包括您必須安裝的工具，以及在 Xcode 及 Android Studio 中執行專案的步驟。 - - -## 安裝開發人員工具 -{: #dev_tools} - -請確定您已安裝[必備開發人員工具 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](get_code.html#prereq-dev-tools){: new_window}。 - - -## 使用 {{site.data.keyword.dev_console}} 建立專案 -{: #create-devex} - -1. 在 {{site.data.keyword.Bluemix}} 中，建立 {{site.data.keyword.dev_console}} 專案。 - - 1. 從 {{site.data.keyword.dev_console}} 的**開始使用**頁面中，按一下**建立專案**。 - - 您也可以按一下**專案**頁面中的**建立專案**。 - - 2. 選取 **Mobile App**，然後按**下一步**。 - - 3. 選取 **Basic**，然後按**下一步**。 - - 4. 輸入專案名稱。對於此指導教學，使用 `MobileBasicProject`。 - - 5. 選取平台。對於此指導教學，使用 `Swift`。 - - 6. 按一下**建立**。 - -2. 選用項目：新增「鑑別」功能。 - - 1. 在**專案概觀**頁面上，針對**鑑別**按一下**新增**。 - - 您也可以選取**功能 > 鑑別**頁面上的**建立**或**新增現有項目**。 - - 2. 輸入服務名稱，然後按一下**建立**。 - - 3. 開啟**鑑別**。 - - 4. 選取您的身分提供者，並且輸入必要資訊以進行配置。您只能啟用一個身分提供者。 - - 5. 如需配置「鑑別」的相關資訊，請參閱[配置身分提供者 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/appid/identity-providers.html){: new_window}。 - -3. 選用項目：新增分析功能。 - - 1. 在**專案概觀**頁面中，針對**分析**按一下**新增**。 - - 您也可以按一下**功能 > 分析**頁面中的**建立**或**新增現有項目**。 - - 2. 輸入服務名稱，然後按一下**建立**。 - - 3. 在您執行應用程式之後，即可關閉**展示模式**來查看分析資料。 - - 4. 如需配置分析的相關資訊，請參閱[開始使用 {{site.data.keyword.mobileanalytics_short}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobileanalytics/index.html){: new_window}。 - -4. 選用項目：新增 {{site.data.keyword.mobilepushshort}} 功能。 - - 1. 在**專案概觀**頁面中，對 **{{site.data.keyword.mobilepushshort}}** 按一下**新增**。 - - 您也可以按一下**功能 > {{site.data.keyword.mobilepushshort}}** 頁面中的**建立**或**新增現有項目**。 - - 2. 輸入服務名稱，然後按一下**建立**。 - - 3. 若為 iOS，請[配置 Apple Push Notification Service ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}。 - - 4. 若為 Android，請[配置 Firebase Cloud Messaging ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}。 - -5. 選用項目：新增資料功能。 - - 1. 在**專案概觀**頁面上，針對**資料**按一下**檢視**。 - - 您也可以選取**資料**頁面上的**建立**。 - - 2. 選擇 **{{site.data.keyword.cloudant_short_notm}}** 或 **{{site.data.keyword.objectstorageshort}}**。 - - 3. 輸入服務名稱，然後按一下**建立**。 - - 4. 如需配置 {{site.data.keyword.cloudant_short_notm}} 的相關資訊，請參閱[開始使用 {{site.data.keyword.cloudant_short_notm}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/Cloudant/index.html){: new_window}。 - - 5. 如需配置 {{site.data.keyword.objectstorageshort}} 的相關資訊，請參閱[開始使用 {{site.data.keyword.objectstorageshort}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/ObjectStorage/index.html){: new_window}。 - -6. 產生專案程式碼。 - - 1. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 - - 您也可以按一下**程式碼**頁面。 - - 2. 按一下**產生 Swift**。 - - 3. 專案程式碼產生完成後，請按一下**下載 Swift** 來下載專案保存檔。 - -7. 選用項目：[更新專案](project_overview_page.html#update_language)以產生新語言。 - - -## 使用 {{site.data.keyword.dev_cli_notm}} 建立專案 -{: #create-cli} - -1. 確定您已安裝 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 - -2. 在「終端機」提示字元中，導覽至您選擇的本端目錄，然後執行下列指令。 - - ``` - bx dev create - ``` - {: codeblock} - -3. 系統提示時，提供下列值： - - * 選取型樣：2（適用於 Mobile） - * 選取入門範本：1（適用於 Basic） - * 選取平台：3（適用於 iOS Swift） - * 輸入專案的名稱：`MobileBasicProjectCLI` - -4. 如果您要將服務新增至專案，請在問題提示字元中鍵入 `y`，並回答其餘的問題。 - -5. 順利儲存 `MobileBasicProjectCLI` 後，請導覽至 `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift` 資料夾。 - - -## 在 Xcode 中執行 Swift 專案 -{: #run_swift} - -1. 解壓縮 `MobileBasicProject-Swift.zip` 檔案。 - -2. 在 Markdown 檢視器中開啟 `README.md` 檔案，以檢閱配置專案的步驟。 - - 1. 開啟終端機，然後導覽至您的專案資料夾。 - - 1. 如果您需要設定 CocoaPods 儲存庫，請執行 `pod setup`。 - - 2. 如果您需要更新現有 Pods，請執行 `pod update`。 - - 3. 執行 `pod install`，以安裝您專案所需的 Pods。 - - 3. 開啟 `BasicProject.xcworkspace` Xcode 工作區。 - -3. 執行應用程式。 - - -## 在 Xcode 中執行 Cordova 專案 -{: #run_cordova_xcode} - -1. 解壓縮 `MobileBasicProject-Cordova.zip` 檔案。 - -2. 在 Markdown 檢視器中開啟 `README.md` 檔案，以配置專案。 - - 1. 在 Xcode 中開啟 `platforms/ios` 專案。 - -3. 執行應用程式。 - - -## 在 Android Studio 中執行 Cordova 專案 -{: #run_cordova_studio} - -1. 解壓縮 `BasicProject-Cordova.zip` 檔案。 - -2. 在 Markdown 檢視器中開啟 `README.md` 檔案，以配置專案。 - - 1. 在 Android Studio 中開啟 `platforms/android` 專案。 - -3. 執行應用程式。 - - -## 在 Android Studio 中執行 Android 專案 -{: #run_android} - -1. 解壓縮 `MobileBasicProject-Android.zip` 檔案。 - -2. 在 Markdown 檢視器中開啟 `README.md` 檔案，以配置專案。 - - 1. 在 Android Studio 中開啟 `BasicProject-Android` 專案。 - -3. 執行應用程式。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Mobile Basic Starter 的完整指導教學 +{: #tutorial} + +下列完整指導教學逐步執行從 Mobile Basic Starter 建立專案的步驟，包括您必須安裝的工具，以及在 Xcode 及 Android Studio 中執行專案的步驟。 + + +## 安裝開發人員工具 +{: #dev_tools} + +請確定您已安裝[必備開發人員工具 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](get_code.html#prereq-dev-tools){: new_window}。 + + +## 使用 {{site.data.keyword.dev_console}} 建立專案 +{: #create-devex} + +1. 在 {{site.data.keyword.Bluemix}} 中，建立 {{site.data.keyword.dev_console}} 專案。 + + 1. 從 {{site.data.keyword.dev_console}} 的**開始使用**頁面中，按一下**建立專案**。 + + 您也可以按一下**專案**頁面中的**建立專案**。 + + 2. 選取 **Mobile App**，然後按**下一步**。 + + 3. 選取 **Basic**，然後按**下一步**。 + + 4. 輸入專案名稱。對於此指導教學，使用 `MobileBasicProject`。 + + 5. 選取平台。對於此指導教學，使用 `Swift`。 + + 6. 按一下**建立**。 + +2. 選用項目：新增「鑑別」功能。 + + 1. 在**專案概觀**頁面上，針對**鑑別**按一下**新增**。 + + 您也可以選取**功能 > 鑑別**頁面上的**建立**或**新增現有項目**。 + + 2. 輸入服務名稱，然後按一下**建立**。 + + 3. 開啟**鑑別**。 + + 4. 選取您的身分提供者，並且輸入必要資訊以進行配置。您只能啟用一個身分提供者。 + + 5. 如需配置「鑑別」的相關資訊，請參閱[配置身分提供者 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/appid/identity-providers.html){: new_window}。 + +3. 選用項目：新增分析功能。 + + 1. 在**專案概觀**頁面中，針對**分析**按一下**新增**。 + + 您也可以按一下**功能 > 分析**頁面中的**建立**或**新增現有項目**。 + + 2. 輸入服務名稱，然後按一下**建立**。 + + 3. 在您執行應用程式之後，即可關閉**展示模式**來查看分析資料。 + + 4. 如需配置分析的相關資訊，請參閱[開始使用 {{site.data.keyword.mobileanalytics_short}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobileanalytics/index.html){: new_window}。 + +4. 選用項目：新增 {{site.data.keyword.mobilepushshort}} 功能。 + + 1. 在**專案概觀**頁面中，對 **{{site.data.keyword.mobilepushshort}}** 按一下**新增**。 + + 您也可以按一下**功能 > {{site.data.keyword.mobilepushshort}}** 頁面中的**建立**或**新增現有項目**。 + + 2. 輸入服務名稱，然後按一下**建立**。 + + 3. 若為 iOS，請[配置 Apple Push Notification Service ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobilepush/t_push_provider_ios.html){: new_window}。 + + 4. 若為 Android，請[配置 Firebase Cloud Messaging ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobilepush/t_push_provider_android.html){: new_window}。 + +5. 選用項目：新增資料功能。 + + 1. 在**專案概觀**頁面上，針對**資料**按一下**檢視**。 + + 您也可以選取**資料**頁面上的**建立**。 + + 2. 選擇 **{{site.data.keyword.cloudant_short_notm}}** 或 **{{site.data.keyword.objectstorageshort}}**。 + + 3. 輸入服務名稱，然後按一下**建立**。 + + 4. 如需配置 {{site.data.keyword.cloudant_short_notm}} 的相關資訊，請參閱[開始使用 {{site.data.keyword.cloudant_short_notm}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/Cloudant/index.html){: new_window}。 + + 5. 如需配置 {{site.data.keyword.objectstorageshort}} 的相關資訊，請參閱[開始使用 {{site.data.keyword.objectstorageshort}} ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/ObjectStorage/index.html){: new_window}。 + +6. 產生專案程式碼。 + + 1. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 + + 您也可以按一下**程式碼**頁面。 + + 2. 按一下**產生 Swift**。 + + 3. 專案程式碼產生完成後，請按一下**下載 Swift** 來下載專案保存檔。 + +7. 選用項目：[更新專案](project_overview_page.html#update_language)以產生新語言。 + + +## 使用 {{site.data.keyword.dev_cli_notm}} 建立專案 +{: #create-cli} + +1. 確定您已安裝 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 + +2. 在「終端機」提示字元中，導覽至您選擇的本端目錄，然後執行下列指令。 + + ``` + bx dev create + ``` + {: codeblock} + +3. 系統提示時，提供下列值： + + * 選取型樣：2（適用於 Mobile） + * 選取入門範本：1（適用於 Basic） + * 選取平台：3（適用於 iOS Swift） + * 輸入專案的名稱：`MobileBasicProjectCLI` + +4. 如果您要將服務新增至專案，請在問題提示字元中鍵入 `y`，並回答其餘的問題。 + +5. 順利儲存 `MobileBasicProjectCLI` 後，請導覽至 `MobileBasicProjectCLI/MobileBasicProjectCLI-Swift` 資料夾。 + + +## 在 Xcode 中執行 Swift 專案 +{: #run_swift} + +1. 解壓縮 `MobileBasicProject-Swift.zip` 檔案。 + +2. 在 Markdown 檢視器中開啟 `README.md` 檔案，以檢閱配置專案的步驟。 + + 1. 開啟終端機，然後導覽至您的專案資料夾。 + + 1. 如果您需要設定 CocoaPods 儲存庫，請執行 `pod setup`。 + + 2. 如果您需要更新現有 Pods，請執行 `pod update`。 + + 3. 執行 `pod install`，以安裝您專案所需的 Pods。 + + 3. 開啟 `BasicProject.xcworkspace` Xcode 工作區。 + +3. 執行應用程式。 + + +## 在 Xcode 中執行 Cordova 專案 +{: #run_cordova_xcode} + +1. 解壓縮 `MobileBasicProject-Cordova.zip` 檔案。 + +2. 在 Markdown 檢視器中開啟 `README.md` 檔案，以配置專案。 + + 1. 在 Xcode 中開啟 `platforms/ios` 專案。 + +3. 執行應用程式。 + + +## 在 Android Studio 中執行 Cordova 專案 +{: #run_cordova_studio} + +1. 解壓縮 `BasicProject-Cordova.zip` 檔案。 + +2. 在 Markdown 檢視器中開啟 `README.md` 檔案，以配置專案。 + + 1. 在 Android Studio 中開啟 `platforms/android` 專案。 + +3. 執行應用程式。 + + +## 在 Android Studio 中執行 Android 專案 +{: #run_android} + +1. 解壓縮 `MobileBasicProject-Android.zip` 檔案。 + +2. 在 Markdown 檢視器中開啟 `README.md` 檔案，以配置專案。 + + 1. 在 Android Studio 中開啟 `BasicProject-Android` 專案。 + +3. 執行應用程式。 diff --git a/cloudnative/nl/zh/TW/tutorial_web.md b/cloudnative/nl/zh/TW/tutorial_web.md index ed45cad71..6142b9888 100644 --- a/cloudnative/nl/zh/TW/tutorial_web.md +++ b/cloudnative/nl/zh/TW/tutorial_web.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# Web Basic Starter 的完整指導教學 -{: #tutorial} - -下列完整指導教學逐步執行從 Web Basic Starter 建立專案的步驟，包括您必須安裝的工具，以及執行專案程式碼的步驟。 - -## 安裝開發人員工具 -{: #dev_tools} - -請確定您已安裝[必備開發人員工具 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](get_code.html#prereq-dev-tools){: new_window}。 - - -## 使用 {{site.data.keyword.dev_console}} 建立專案 -{: #create-devex} - -1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中建立專案。 - - 1. 從 {{site.data.keyword.dev_console}} 的**開始使用**頁面中，按一下**建立專案**。 - - 您也可以按一下**專案**頁面中的**建立專案**。 - - 2. 選取 **Web 應用程式**，然後按**下一步**。 - - 3. 選取 **Basic Web**，然後按**下一步**。 - - 4. 輸入專案名稱。對於此指導教學，使用 `WebBasicProject`。 - - 5. 輸入主機名稱。對於此指導教學，使用 `devhost`。 - - 6. 選取語言平台。對於此指導教學，使用 `Swift`。 - - 7. 按一下**建立**。 - -2. 選用項目：新增「資料」功能。 - - 1. 在**專案概觀**頁面上，針對**資料**按一下**檢視**。 - - 您也可以選取**功能 > 資料**頁面上的**建立**或**新增現有項目**。 - - 2. 輸入服務名稱，然後按一下**建立**。 - - -3. 產生專案程式碼。 - - 1. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 - - 您也可以按一下**程式碼**頁面。 - - 2. 按一下**產生程式碼**。 - - 3. 當專案程式碼生成完成時，請按一下**下載程式碼**來下載專案保存檔。 - -4. 選用項目：[更新專案](project_overview_page.html#update_language)以產生新語言。 - - -## 使用 {{site.data.keyword.dev_cli_notm}} 建立專案 -{: #create-cli} - -1. 確定您已安裝 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 - -2. 在「終端機」提示字元中，導覽至您選擇的本端目錄，然後執行下列指令。 - - ``` - bx dev create - ``` - {: codeblock} - - -3. 系統提示時，提供下列值： - - * 選取型樣：1（適用於 Web） - * 選取入門範本：1（適用於 Basic Web） - * 選取語言：2（適用於 Swift） - * 輸入專案的名稱：`WebBasicProjectCLI` - * 輸入專案的主機名稱：`myhost` - -4. 如果您要將服務新增至專案，請在問題提示字元中鍵入 `y`，並回答其餘的問題。 - -5. 順利儲存 `WebBasicProjectCLI` 專案後，請導覽至 `WebBasicProjectCLI` 資料夾。 - -6. 新增自己的程式碼、建置專案，或執行專案。 - - 1. 使用下列指令來建置專案： - - ``` - bx dev build - ``` - {: codeblock} - - 2. 使用下列指令來執行專案： - - ``` - bx dev run - ``` - {: codeblock} - - -## 執行 Web 專案 -{: #run} - -### 本端 -{: #local notoc} - -1. 安裝節點相依關係： - - ``` - npm install - ``` - {: codeblock} - -2. 將前端程式碼組合到模組： - - ``` - node_modules/.bin/gulp - ``` - {: codeblock} - -3. 編譯伺服器： - - ``` - swift build - ``` - {: codeblock} - -4. 執行應用程式： - - ``` - .build/debug/WebBasicProjectCLI - ``` - {: codeblock} - -5. 將瀏覽器開啟至 `http://localhost:8080`。 - - -### 使用 {{site.data.keyword.dev_cli_short}} -{: #dev notoc} - -1. 安裝節點相依關係： - - ``` - npm install - ``` - {: codeblock} - -2. 將前端程式碼組合到模組： - - ``` - gulp - ``` - {: codeblock} - -3. 執行編譯： - - ``` - bx dev run - ``` - {: codeblock} - -4. 將瀏覽器開啟至 `http://localhost:8080`。 - - -## 在 Xcode 中執行專案 -{: #Xcode} - -1. 建立 Xcode 專案。 - - 您需要使用 Swift 套件管理程式來建置 Xcode 專案，才能在 Xcode 中進行開發。 - - ``` - swift project generate-xcodeproj - ``` - {: codeblock} - -2. 將作用中目標變更為執行檔： - - 接下來，在 Xcode 中開啟專案，並確定作用中目標是執行檔。您可以按住 Option 鍵，同時按一下下拉功能表，來選取所需的作用中執行檔。 - -3. 按 **run**。 - -4. 將瀏覽器開啟至 `http://localhost:8080`。 - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# Web Basic Starter 的完整指導教學 +{: #tutorial} + +下列完整指導教學逐步執行從 Web Basic Starter 建立專案的步驟，包括您必須安裝的工具，以及執行專案程式碼的步驟。 + +## 安裝開發人員工具 +{: #dev_tools} + +請確定您已安裝[必備開發人員工具 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](get_code.html#prereq-dev-tools){: new_window}。 + + +## 使用 {{site.data.keyword.dev_console}} 建立專案 +{: #create-devex} + +1. 在 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 中建立專案。 + + 1. 從 {{site.data.keyword.dev_console}} 的**開始使用**頁面中，按一下**建立專案**。 + + 您也可以按一下**專案**頁面中的**建立專案**。 + + 2. 選取 **Web 應用程式**，然後按**下一步**。 + + 3. 選取 **Basic Web**，然後按**下一步**。 + + 4. 輸入專案名稱。對於此指導教學，使用 `WebBasicProject`。 + + 5. 輸入主機名稱。對於此指導教學，使用 `devhost`。 + + 6. 選取語言平台。對於此指導教學，使用 `Swift`。 + + 7. 按一下**建立**。 + +2. 選用項目：新增「資料」功能。 + + 1. 在**專案概觀**頁面上，針對**資料**按一下**檢視**。 + + 您也可以選取**功能 > 資料**頁面上的**建立**或**新增現有項目**。 + + 2. 輸入服務名稱，然後按一下**建立**。 + + +3. 產生專案程式碼。 + + 1. 按一下**專案概觀**頁面上的**取得程式碼**，以選取您的語言。 + + 您也可以按一下**程式碼**頁面。 + + 2. 按一下**產生程式碼**。 + + 3. 當專案程式碼生成完成時，請按一下**下載程式碼**來下載專案保存檔。 + +4. 選用項目：[更新專案](project_overview_page.html#update_language)以產生新語言。 + + +## 使用 {{site.data.keyword.dev_cli_notm}} 建立專案 +{: #create-cli} + +1. 確定您已安裝 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)。 + +2. 在「終端機」提示字元中，導覽至您選擇的本端目錄，然後執行下列指令。 + + ``` + bx dev create + ``` + {: codeblock} + + +3. 系統提示時，提供下列值： + + * 選取型樣：1（適用於 Web） + * 選取入門範本：1（適用於 Basic Web） + * 選取語言：2（適用於 Swift） + * 輸入專案的名稱：`WebBasicProjectCLI` + * 輸入專案的主機名稱：`myhost` + +4. 如果您要將服務新增至專案，請在問題提示字元中鍵入 `y`，並回答其餘的問題。 + +5. 順利儲存 `WebBasicProjectCLI` 專案後，請導覽至 `WebBasicProjectCLI` 資料夾。 + +6. 新增自己的程式碼、建置專案，或執行專案。 + + 1. 使用下列指令來建置專案： + + ``` + bx dev build + ``` + {: codeblock} + + 2. 使用下列指令來執行專案： + + ``` + bx dev run + ``` + {: codeblock} + + +## 執行 Web 專案 +{: #run} + +### 本端 +{: #local notoc} + +1. 安裝節點相依關係： + + ``` + npm install + ``` + {: codeblock} + +2. 將前端程式碼組合到模組： + + ``` + node_modules/.bin/gulp + ``` + {: codeblock} + +3. 編譯伺服器： + + ``` + swift build + ``` + {: codeblock} + +4. 執行應用程式： + + ``` + .build/debug/WebBasicProjectCLI + ``` + {: codeblock} + +5. 將瀏覽器開啟至 `http://localhost:8080`。 + + +### 使用 {{site.data.keyword.dev_cli_short}} +{: #dev notoc} + +1. 安裝節點相依關係： + + ``` + npm install + ``` + {: codeblock} + +2. 將前端程式碼組合到模組： + + ``` + gulp + ``` + {: codeblock} + +3. 執行編譯： + + ``` + bx dev run + ``` + {: codeblock} + +4. 將瀏覽器開啟至 `http://localhost:8080`。 + + +## 在 Xcode 中執行專案 +{: #Xcode} + +1. 建立 Xcode 專案。 + + 您需要使用 Swift 套件管理程式來建置 Xcode 專案，才能在 Xcode 中進行開發。 + + ``` + swift project generate-xcodeproj + ``` + {: codeblock} + +2. 將作用中目標變更為執行檔： + + 接下來，在 Xcode 中開啟專案，並確定作用中目標是執行檔。您可以按住 Option 鍵，同時按一下下拉功能表，來選取所需的作用中執行檔。 + +3. 按 **run**。 + +4. 將瀏覽器開啟至 `http://localhost:8080`。 + diff --git a/cloudnative/nl/zh/TW/tutorials.md b/cloudnative/nl/zh/TW/tutorials.md index 44d0e1547..2fb5577c2 100644 --- a/cloudnative/nl/zh/TW/tutorials.md +++ b/cloudnative/nl/zh/TW/tutorials.md @@ -1,49 +1,49 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} - -# 完整指導教學 -{: #tutorial} - -下列完整指導教學逐步執行從 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 建立專案的步驟，包括您必須安裝的工具，以及執行專案程式碼的步驟。 - -## Web -{: #web notoc} - -* [Web Basic 指導教學](tutorial_web.html) - - -## Mobile -{: #mobile notoc} - -* [Mobile Basic 指導教學](tutorial_mobile.html) - - - - -## BFF -{: #bff notoc} - -* [BFF Basic 指導教學](tutorial_bff.html) - - -## Microservice -{: #microservice notoc} - -* [Microservice Basic 指導教學](tutorial_microservice.html) +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} + +# 完整指導教學 +{: #tutorial} + +下列完整指導教學逐步執行從 {{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 建立專案的步驟，包括您必須安裝的工具，以及執行專案程式碼的步驟。 + +## Web +{: #web notoc} + +* [Web Basic 指導教學](tutorial_web.html) + + +## Mobile +{: #mobile notoc} + +* [Mobile Basic 指導教學](tutorial_mobile.html) + + + + +## BFF +{: #bff notoc} + +* [BFF Basic 指導教學](tutorial_bff.html) + + +## Microservice +{: #microservice notoc} + +* [Microservice Basic 指導教學](tutorial_microservice.html) diff --git a/cloudnative/nl/zh/TW/what_is_new.md b/cloudnative/nl/zh/TW/what_is_new.md index df6cbad80..6a8a0c4a8 100644 --- a/cloudnative/nl/zh/TW/what_is_new.md +++ b/cloudnative/nl/zh/TW/what_is_new.md @@ -1,97 +1,97 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-03-17" - ---- -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} -{:pre: .pre} -{:note:.deprecated} - -# {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 的新增功能 -{: #what-is-new} - - -## 文件日期：2017 年 3 月 -{: #mar-2017} - -{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 的 2017 年 3 月更新引進下列變更： - - * 「{{site.data.keyword.Bluemix_notm}} 行動」儀表板現在是 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}。 - * 專案建立已經過重新設計，併入了支援 Node.js、Java 及 Swift 的「Web 應用程式」、BFF 及 Microservice 伺服器型樣類型。 - * 與新增及改良的 {{site.data.keyword.appid_full}} 服務的整合，可鑑別行動及 Web 專案。 - * 您現在可以使用 [SDK 產生器外掛程式](sdk_cli.html)，額外產生專案的 SDK。只有針對 Mobile 專案，才能在 {{site.data.keyword.dev_console}} 中產生 SDK。 - * 您現在可以使用 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)，額外建立專案。 - - -## 文件日期：2017 年 1 月 -{: #jan-2017} - -「{{site.data.keyword.Bluemix_notm}} 行動」儀表板的 2017 年 1 月更新引進下列變更： - - * 自 1 月 31 日開始，「使用者介面入門範本」已淘汰。在 2017 年 4 月 30 日之前，可以使用從「使用者介面入門範本」建立的現有專案。如需移轉步驟及移除日期的相關資訊，請參閱[淘汰公告部落格文章 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/)。 -{: deprecated} - * 您現在可以更新專案入門範本類型，而不是刪除專案並建立新的專案。 - * 您現在可以使用「[Watson Conversation](tutorial_conversation.html) 程式碼入門範本」建立專案。 - * 支援時，您現在可以產生專案的 SDK。 - * 您現在可以新增現有[運算](sdk_compute.html)實例，並產生要新增至專案的用戶端 SDK。 - - -## 文件日期：2016 年 12 月 -{: #dec-2016} - -{{site.data.keyword.Bluemix_notm}} 行動儀表板的 2016 年 12 月更新引進了下列變更： - - * 您現在可以從專案中移除已連接的服務，以將它刪除，或搭配另一個專案重複使用。 - * 您現在可以將現有服務新增至專案。 - * 現在，使用「程式碼入門範本」時，您可以建立或連接現有 CloudantNoSQL 服務，作為資料來源。 - * 一旦支援，您就可以建立或連接現有「物件儲存空間」服務，作為您專案的資料來源。 - * 您現在可以自訂您將利用「使用者介面入門範本」建立之應用程式的導覽設計。 - - -## 文件日期：2016 年 11 月 -{: #nov-2016} - -{{site.data.keyword.Bluemix_notm}} 行動儀表板的十一月更新引進了下列變更： - - * 您現在可以從**程式碼**頁面產生專案的 SDK 構件。 - * Basic Code Starter 現在支援 Cordova。 - * 您現在可以在 {{site.data.keyword.mobileanalytics_short}} 主控台的**網路要求**頁面中[報告網路事件 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} 及[監視網路要求 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window}。 - * 您現在可以在 {{site.data.keyword.mobileanalytics_short}} 主控台中[將資料匯出至 dashDB ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window}。 - - -## 文件日期：2016 年 10 月 -{: #oct-2016} - -{{site.data.keyword.Bluemix_notm}} 行動儀表板的 2016 年十月更新引進了下列變更： - - * 您現在可以直接從儀表板中將 {{site.data.keyword.mobilepushshort}} 及分析功能新增至專案。 - * 現在已提供[程式碼入門範本](starters.html#Code_Starter)。 - * 您可以將「鑑別」新增至從「程式碼入門範本」建立的專案。 - * 現在支援 Swift。 - - -### 分析 -{: #analytics notoc} - - * 當您新增分析功能時，預設會啟用展示模式。在您執行應用程式之後，即可關閉展示模式來檢視分析。 - - -### 使用者介面建置器 -{: #ui_builder notoc} - - * 現在可以從專案存取 **{{site.data.keyword.mobilepushshort}}** 功能。 - * **專案設定**標籤已重新命名為**設定**標籤。 - * **鑑別**標籤已重新命名為**使用者存取**標籤。 - - -### 程式碼 -{: #code notoc} - - * 針對 iOS 產生的 Objective-C 及 Swift 程式碼現在使用 CocoaPods 來管理相依關係。這表示您需要安裝 CocoaPods。若要安裝它，請執行 `sudo gem install cocoapods`。安裝 CocoaPods 之後，請執行 `pod setup` 來進行配置（如果尚未配置）。最後，執行 `pod install` 來下載及安裝必要的專案相依關係，之後再於 Xcode 中開啟 `.xcworkspace` 檔案。在所下載程式碼保存檔的 `README.md` 檔案中提供其他詳細資料。如需相關資訊，請閱讀[必備開發人員工具](get_code.html#prereq-dev-tools)。 - -請經常檢查，以保有最新的更新項目。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-03-17" + +--- +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} +{:pre: .pre} +{:note:.deprecated} + +# {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}} 的新增功能 +{: #what-is-new} + + +## 文件日期：2017 年 3 月 +{: #mar-2017} + +{{site.data.keyword.Bluemix}} {{site.data.keyword.dev_console}} 的 2017 年 3 月更新引進下列變更： + + * 「{{site.data.keyword.Bluemix_notm}} 行動」儀表板現在是 {{site.data.keyword.Bluemix_notm}} {{site.data.keyword.dev_console}}。 + * 專案建立已經過重新設計，併入了支援 Node.js、Java 及 Swift 的「Web 應用程式」、BFF 及 Microservice 伺服器型樣類型。 + * 與新增及改良的 {{site.data.keyword.appid_full}} 服務的整合，可鑑別行動及 Web 專案。 + * 您現在可以使用 [SDK 產生器外掛程式](sdk_cli.html)，額外產生專案的 SDK。只有針對 Mobile 專案，才能在 {{site.data.keyword.dev_console}} 中產生 SDK。 + * 您現在可以使用 [{{site.data.keyword.dev_cli_short}}](dev_cli.html)，額外建立專案。 + + +## 文件日期：2017 年 1 月 +{: #jan-2017} + +「{{site.data.keyword.Bluemix_notm}} 行動」儀表板的 2017 年 1 月更新引進下列變更： + + * 自 1 月 31 日開始，「使用者介面入門範本」已淘汰。在 2017 年 4 月 30 日之前，可以使用從「使用者介面入門範本」建立的現有專案。如需移轉步驟及移除日期的相關資訊，請參閱[淘汰公告部落格文章 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](https://www.ibm.com/blogs/bluemix/2017/01/bluemix-mobile-dashboard-update/)。 +{: deprecated} + * 您現在可以更新專案入門範本類型，而不是刪除專案並建立新的專案。 + * 您現在可以使用「[Watson Conversation](tutorial_conversation.html) 程式碼入門範本」建立專案。 + * 支援時，您現在可以產生專案的 SDK。 + * 您現在可以新增現有[運算](sdk_compute.html)實例，並產生要新增至專案的用戶端 SDK。 + + +## 文件日期：2016 年 12 月 +{: #dec-2016} + +{{site.data.keyword.Bluemix_notm}} 行動儀表板的 2016 年 12 月更新引進了下列變更： + + * 您現在可以從專案中移除已連接的服務，以將它刪除，或搭配另一個專案重複使用。 + * 您現在可以將現有服務新增至專案。 + * 現在，使用「程式碼入門範本」時，您可以建立或連接現有 CloudantNoSQL 服務，作為資料來源。 + * 一旦支援，您就可以建立或連接現有「物件儲存空間」服務，作為您專案的資料來源。 + * 您現在可以自訂您將利用「使用者介面入門範本」建立之應用程式的導覽設計。 + + +## 文件日期：2016 年 11 月 +{: #nov-2016} + +{{site.data.keyword.Bluemix_notm}} 行動儀表板的十一月更新引進了下列變更： + + * 您現在可以從**程式碼**頁面產生專案的 SDK 構件。 + * Basic Code Starter 現在支援 Cordova。 + * 您現在可以在 {{site.data.keyword.mobileanalytics_short}} 主控台的**網路要求**頁面中[報告網路事件 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobileanalytics/sdk.html#network-requests){: new_window} 及[監視網路要求 ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobileanalytics/app-monitoring.html#monitor-network-requests){: new_window}。 + * 您現在可以在 {{site.data.keyword.mobileanalytics_short}} 主控台中[將資料匯出至 dashDB ![外部鏈結圖示](../icons/launch-glyph.svg "外部鏈結圖示")](/docs/services/mobileanalytics/app-monitoring.html#dashdb){: new_window}。 + + +## 文件日期：2016 年 10 月 +{: #oct-2016} + +{{site.data.keyword.Bluemix_notm}} 行動儀表板的 2016 年十月更新引進了下列變更： + + * 您現在可以直接從儀表板中將 {{site.data.keyword.mobilepushshort}} 及分析功能新增至專案。 + * 現在已提供[程式碼入門範本](starters.html#Code_Starter)。 + * 您可以將「鑑別」新增至從「程式碼入門範本」建立的專案。 + * 現在支援 Swift。 + + +### 分析 +{: #analytics notoc} + + * 當您新增分析功能時，預設會啟用展示模式。在您執行應用程式之後，即可關閉展示模式來檢視分析。 + + +### 使用者介面建置器 +{: #ui_builder notoc} + + * 現在可以從專案存取 **{{site.data.keyword.mobilepushshort}}** 功能。 + * **專案設定**標籤已重新命名為**設定**標籤。 + * **鑑別**標籤已重新命名為**使用者存取**標籤。 + + +### 程式碼 +{: #code notoc} + + * 針對 iOS 產生的 Objective-C 及 Swift 程式碼現在使用 CocoaPods 來管理相依關係。這表示您需要安裝 CocoaPods。若要安裝它，請執行 `sudo gem install cocoapods`。安裝 CocoaPods 之後，請執行 `pod setup` 來進行配置（如果尚未配置）。最後，執行 `pod install` 來下載及安裝必要的專案相依關係，之後再於 Xcode 中開啟 `.xcworkspace` 檔案。在所下載程式碼保存檔的 `README.md` 檔案中提供其他詳細資料。如需相關資訊，請閱讀[必備開發人員工具](get_code.html#prereq-dev-tools)。 + +請經常檢查，以保有最新的更新項目。 diff --git a/compute/nl/it/index.md b/compute/nl/it/index.md index e9a9a4f25..b435d40ba 100644 --- a/compute/nl/it/index.md +++ b/compute/nl/it/index.md @@ -1,23 +1,23 @@ ---- - - - -copyright: - - years: 2015, 2017 - - - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Calcolo -*Ultimo aggiornamento: 24 giugno 2016* -{: .last-updated} - -La funzione Calcolo include l'infrastruttura e le risorse da cui puoi scegliere per creare applicazioni {{site.data.keyword.Bluemix}}. Le risorse di calcolo comprendono {{site.data.keyword.openwhisk_short}}, applicazioni Cloud Foundry, contenitori {{site.data.keyword.IBM_notm}} e {{site.data.keyword.virtualmachinesshort}} {{site.data.keyword.IBM_notm}}. -{:shortdesc} - -Per ulteriori informazioni sulle differenze tra queste opzioni di calcolo, leggi l'articolo [Bluemix OpenWhisk, Instant Runtimes, Containers or Virtual Servers](https://developer.ibm.com/bluemix/2015/08/05/bluemix-instant-runtimes-containers-or-virtual-machines/). +--- + + + +copyright: + + years: 2015, 2017 + + + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Calcolo +*Ultimo aggiornamento: 24 giugno 2016* +{: .last-updated} + +La funzione Calcolo include l'infrastruttura e le risorse da cui puoi scegliere per creare applicazioni {{site.data.keyword.Bluemix}}. Le risorse di calcolo comprendono {{site.data.keyword.openwhisk_short}}, applicazioni Cloud Foundry, contenitori {{site.data.keyword.IBM_notm}} e {{site.data.keyword.virtualmachinesshort}} {{site.data.keyword.IBM_notm}}. +{:shortdesc} + +Per ulteriori informazioni sulle differenze tra queste opzioni di calcolo, leggi l'articolo [Bluemix OpenWhisk, Instant Runtimes, Containers or Virtual Servers](https://developer.ibm.com/bluemix/2015/08/05/bluemix-instant-runtimes-containers-or-virtual-machines/). diff --git a/debug/nl/it/index.md b/debug/nl/it/index.md index a19deb14b..99be70b81 100644 --- a/debug/nl/it/index.md +++ b/debug/nl/it/index.md @@ -1,185 +1,185 @@ ---- - -copyright: - years: 2015, 2017 - -lastupdated: "2017-01-11" - ---- - - - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:screen: .screen} - - -# Debug -{: #debugging} - -Se si verificano problemi con {{site.data.keyword.Bluemix}}, puoi visualizzare i file di log per analizzare i problemi ed eseguire il debug degli errori. -{:shortdesc} - -I log forniscono informazioni quali la corretta esecuzione di un lavoro o la sua mancata riuscita. Forniscono anche informazioni pertinenti che possono essere utilizzate per eseguire il debug e determinare la causa di un problema. - -I log sono in un formato fisso. Per i log dettagliati, puoi filtrarli o utilizzare degli host di registrazione esterni per memorizzare ed elaborare i log. Per ulteriori informazioni su formati dei log, visualizzazione e filtraggio dei log e configurazione della registrazione esterna, vedi [Registrazione per le applicazioni in esecuzione su Cloud Foundry](/docs/monitor_log/monitoringandlogging.html#logging_for_bluemix_apps). - - -## Debug degli errori di preparazione -{: #debugging-staging-errors} -Potrebbero verificarsi dei problemi durante la preparazione delle tue applicazioni su {{site.data.keyword.Bluemix_notm}}. Se la preparazione della tua applicazione non viene eseguita correttamente, puoi visualizzare ed effettuare ricerche nei log di preparazione (STG) al fine di scoprire cosa è accaduto durante la distribuzione dell'applicazione e risolvere il problema. Per ulteriori informazioni sui metodi di visualizzazione dei log per le applicazioni Bluemix, vedi [visualizzazione dei log](/docs/monitor_log/monitoringandlogging.html#viewing_logs). - -Per comprendere il motivo per cui la tua applicazione potrebbe provocare errori in {{site.data.keyword.Bluemix_notm}}, devi sapere come vengono distribuite ed eseguite le applicazioni in {{site.data.keyword.Bluemix_notm}}. Per informazioni dettagliate, vedi [Distribuzione -delle applicazioni](/docs/manageapps/depapps.html#appdeploy). - - -La seguente procedura mostra come puoi utilizzare il comando `cf logs` per eseguire il debug degli errori di preparazione. Prima di iniziare -la procedura, assicurati di aver installato l'interfaccia riga di comando cf. Per ulteriori informazioni sull'installazione dell'interfaccia -riga di comando cf, vedi [Installing the cf -command line interface](/docs/starters/install_cli.html). - - 1. Connettiti a {{site.data.keyword.Bluemix_notm}} immettendo il seguente codice nell'interfaccia riga di comando cf: - ``` - cf api https://api.ng.bluemix.net - ``` - - 2. Accedi a {{site.data.keyword.Bluemix_notm}} immettendo `cf login`. - - 3. Recupera i log recenti immettendo `cf logs appname --recent`. Se vuoi filtrare un log dettagliato, utilizza l'opzione `grep`. Ad esempio, puoi immettere il seguente codice per visualizzare solo i log [STG]: - ``` - cf logs appname --recent | grep '\[STG\]' - ``` - 4. Visualizza il primo errore mostrato nel log. - -Se utilizzi distribuisci le applicazioni attraverso gli strumenti IBM Eclipse per il plug-in {{site.data.keyword.Bluemix_notm}}, nella scheda **Console** dello strumento Eclipse puoi visualizzare dei log simili all'output di cf logs. Puoi anche aprire una finestra di Eclipse separata per tracciare `i log` quando distribuisci l'applicazione. - -Oltre al comando `cf logs`, in {{site.data.keyword.Bluemix_notm}} puoi utilizzare anche il servizio Monitoring and Analytics per raccogliere i dettagli del log. Inoltre, il servizio Monitoring and Analytics monitora le prestazioni, l'integrità e la disponibilità delle tue applicazioni. Fornisce anche analisi di log per le applicazioni di runtime Node.js e Liberty. - -### Debug degli errori di preparazione per un'applicazione Node.js - -Il seguente esempio mostra un log che viene visualizzato dopo che immetti `cf logs nomeapplicazione --recent`. Nell'esempio -si suppone che si siano verificati errori di preparazione per un'applicazione Node.js: -``` -2014-08-11T14:19:36.17+0100 [API] OUT Updated app with guid 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 ({name"=>"SampleExpressApp"} -2014-08-11T14:20:44.17+0100 [API] OUT Updated app with guid 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 ({"state"=>"STOPPED"}) -2014-08-11T14:20:44.19+0100 [App/0] ERR -2014-08-11T14:20:44.43+0100 [DEA] OUT Stopping app instance (index 0) with guid 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 -2014-08-11T14:20:44.44+0100 [DEA] OUT Stopped app instance (index 0) with guid 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 -2014-08-11T14:20:48.97+0100 [DEA] OUT Got staging request for app with id 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 -2014-08-11T14:20:50.94+0100 [API] OUT Updated app with guid 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 ({"state"=>"STARTED"}) -2014-08-11T14:20:51.66+0100 [STG] OUT -----> Download app package (4.1M) -2014-08-11T14:20:51.90+0100 [STG] OUT -----> Download app buildpack cache (1.1M) -2014-08-11T14:20:52.78+0100 [STG] OUT -----> Buildpack Version: v1.1-20140717-1447 -2014-08-11T14:20:52.78+0100 [STG] ERR parse error: Expected another key-value pair at line 18, column 3 -2014-08-11T14:20:52.79+0100 [STG] OUT 0 info it worked if it ends with ok -``` -{: screen} - - -Il primo errore nel log mostra il motivo per cui la preparazione non riesce. Nell'esempio, il primo errore è un output del componente DEA -durante la fase di preparazione. -``` -2014-08-11T14:20:52.78+0100 [STG] ERR parse error: expected another key-value pair at line 18, column 3 -``` -{: screen} - - -Per un'applicazione Node.js, il DEA utilizza le informazioni contenute nel file `package.json` per scaricare i moduli. Da questo errore, puoi vedere -che l'errore si verifica per il modulo. Pertanto, potresti dover riesaminare la riga 18 del file `package.json`. - -``` -15 "jade": "~1.3.0", -16 "mongodb": "*", -17 "monk":"*", -18 } -``` -{: screen} - - -Puoi notare che viene inserita una virgola alla fine della riga 17 e quindi è prevista una coppia chiave-valore alla riga 18. Per correggere il problema, rimuovi la virgola: - -``` -15 "jade": "~1.3.0", -16 "mongodb": "*", -17 "monk":"*" -18 } -``` -{: screen} - - -## Debug degli errori di runtime -{: #debugging-runtime-errors} -Se durante il runtime riscontri dei problemi con la tua applicazione, i log dell'applicazione possono aiutarti a individuare la causa dell'errore e a risolvere il problema. - -In particolare, è possibile abilitare la registrazione in stdout e stderr. Per ulteriori informazioni su come configurare i file di log per le applicazioni -che vengono distribuite tramite i pacchetti di build integrati {{site.data.keyword.Bluemix_notm}}, consulta il seguente elenco: - - * Per le applicazioni Liberty for Java™, consulta [Liberty Profile: Logging and Trace ![icona link esterno](../icons/launch-glyph.svg)](http://www-01.ibm.com/support/knowledgecenter/was_beta_liberty/com.ibm.websphere.wlp.nd.multiplatform.doc/ae/rwlp_logging.html){: new_window}. - * Per le applicazioni Node.js, vedi [How to log in node.js ![icona link esterno](../icons/launch-glyph.svg)](http://docs.nodejitsu.com/articles/intermediate/how-to-log){: new_window}. - * Per le applicazioni PHP, vedi [error_log ![icona link esterno](../icons/launch-glyph.svg)](http://php.net/manual/en/function.error-log.php){: new_window}. - * Per le applicazioni Python, vedi [Logging HOWTO ![icona link esterno](../icons/launch-glyph.svg)](https://docs.python.org/2/howto/logging.html){: new_window}. - * Per le applicazioni Ruby on Rails, vedi [The Logger ![icona link esterno](../icons/launch-glyph.svg)](http://guides.rubyonrails.org/debugging_rails_applications.html#the-logger){: new_window}. - * Per le applicazioni Ruby Sinatra, vedi [Logging ![icona link esterno](../icons/launch-glyph.svg)](http://www.sinatrarb.com/intro.html#Logging){: new_window}. - -Quando immetti `cf logs nomeapplicazione --recent` nell'interfaccia riga di comando cf, vengono visualizzati solo i log più recenti. Per visualizzare i log con gli errori che si sono verificati in precedenza, devi recuperare tutti i log e ricercare gli errori. Per recuperare tutti i log per la tua applicazione, utilizza uno dei seguenti metodi: -
-
Servizio {{site.data.keyword.Bluemix_notm}} Monitoring and Analytics
-
La capacità di ricerca e analisi dei file di log del servizio Monitoring and Analytics possono aiutarti a identificare rapidamente gli errori. Per ulteriori informazioni, vedi Monitoring and Analytics.
-
Strumenti di terze parti
-
Puoi raccogliere ed esportare i log dalla tua applicazione a un host di log esterno. Per ulteriori informazioni, vedi Configurazione della registrazione esterna.
-
Script per la raccolta e l'esportazione dei log
-
Per utilizzare uno script per la raccolta e l'esportazione automatica dei log in un file esterno, devi connetterti alla console {{site.data.keyword.Bluemix_notm}} dal tuo computer in cui deve essere disponibile spazio sufficiente per scaricare i log. Per ulteriori informazioni, vedi Raccolta delle informazioni di diagnostica.
-
- -I file `stdout.log` e `stderr.log` erano precedentemente accessibili, per impostazione predefinita, tramite la vista dell'applicazione nella console {{site.data.keyword.Bluemix_notm}} sotto **File** > **log**. Tuttavia, tale registrazione dell'applicazione non è più disponibile -con la versione corrente di Cloud Foundry in cui è ospitato {{site.data.keyword.Bluemix_notm}}. Per fare in modo che la registrazione dell'applicazione stdout e stderr continui a essere accessibile tramite la console {{site.data.keyword.Bluemix_notm}} sotto **File** > **log**, puoi reindirizzare la registrazione ad altri file nel file system {{site.data.keyword.Bluemix_notm}}, a seconda del runtime che stai utilizzando. - - * Per le applicazioni Liberty for Java, l'output indirizzato a stdout e stderr è già contenuto nel file `messages.log` nella directory logs. Ricerca le voci con prefisso SystemOut e SystemErr. - * Per le applicazioni Node.js, puoi sovrascrivere la funzione console.log per scrivere esplicitamente in un file nella directory logs. - * Per le applicazioni PHP, puoi utilizzare la funzione error_log per scrivere in un file nella directory logs. - * Per le applicazioni Python, puoi fare in modo che il logger scriva in un file nella directory logs: `logging.basicConfig(filename='/docs/logs/example.log',level=logging.DEBUG)` - * Per le applicazioni Ruby, puoi fare in modo che il logger scriva in un file nella directory logs. - - -### Debug delle modifiche al codice -{: #debug_code_changes} - -Se stai apportando modifiche al codice in un'applicazione già distribuita e funzionante, ma le modifiche non vengono rispecchiate in {{site.data.keyword.Bluemix_notm}}, puoi eseguire il debug utilizzando i log. A prescindere che la tua applicazione sia o no in esecuzione, puoi controllare i log generati durante la distribuzione dell'applicazione o il runtime per scoprire il motivo per cui il nuovo codice non funziona. - -A seconda del modo in cui il nuovo codice viene distribuito, scegli uno dei seguenti metodi per eseguire il debug delle modifiche al codice: - - * In caso di nuovo codice distribuito dalla riga di comando cf, controlla l'output del comando *cf push*. Inoltre, puoi utilizzare il comando *cf logs* per trovare ulteriori indizi utili per la risoluzione del problema. Per ulteriori informazioni su come utilizzare il comando *cf logs*, vedi [visualizzazione dei log dall'interfaccia riga di comando](/docs/monitor_log/monitoringandlogging.html#viewing_logs_cli). - - * In caso di nuovo codice distribuito da una GUI, quale ad esempio la console {{site.data.keyword.Bluemix_notm}}, DevOps Delivery Pipeline o l'IC di Travis, puoi controllare i log dall'interfaccia. Ad esempio, se distribuisci il nuovo codice dalla console {{site.data.keyword.Bluemix_notm}}, puoi passare al dashboard, trovare la tua applicazione e visualizzare i log per trovare degli indizi. Per ulteriori informazioni su come visualizzare i log dalla console {{site.data.keyword.Bluemix_notm}}, vedi [Visualizzazione dei log dal dashboard Bluemix](/docs/monitor_log/monitoringandlogging.html#viewing_logs_UI). - - -# rellinks -{: #rellinks} - -## general -{: #general} - - * [DEA (Droplet Execution Agent) ![icona link esterno](../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/concepts/architecture/execution-agent.html){: new_window} - * [Introduzione al servizio IBM Monitoring and Analytics per Bluemix](/docs/services/monana/index.html#gettingstartedtemplate) - * [Come funziona Bluemix](/docs/overview/whatisbluemix.html#howwork) - * [Installazione dello strumento di comando cf](/docs/starters/install_cli.html) - * [Visualizzazione dei log](/docs/monitor_log/monitoringandlogging.html#viewing_logs) - - - - - - - - - - - - - - - - - - +--- + +copyright: + years: 2015, 2017 + +lastupdated: "2017-01-11" + +--- + + + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:screen: .screen} + + +# Debug +{: #debugging} + +Se si verificano problemi con {{site.data.keyword.Bluemix}}, puoi visualizzare i file di log per analizzare i problemi ed eseguire il debug degli errori. +{:shortdesc} + +I log forniscono informazioni quali la corretta esecuzione di un lavoro o la sua mancata riuscita. Forniscono anche informazioni pertinenti che possono essere utilizzate per eseguire il debug e determinare la causa di un problema. + +I log sono in un formato fisso. Per i log dettagliati, puoi filtrarli o utilizzare degli host di registrazione esterni per memorizzare ed elaborare i log. Per ulteriori informazioni su formati dei log, visualizzazione e filtraggio dei log e configurazione della registrazione esterna, vedi [Registrazione per le applicazioni in esecuzione su Cloud Foundry](/docs/monitor_log/monitoringandlogging.html#logging_for_bluemix_apps). + + +## Debug degli errori di preparazione +{: #debugging-staging-errors} +Potrebbero verificarsi dei problemi durante la preparazione delle tue applicazioni su {{site.data.keyword.Bluemix_notm}}. Se la preparazione della tua applicazione non viene eseguita correttamente, puoi visualizzare ed effettuare ricerche nei log di preparazione (STG) al fine di scoprire cosa è accaduto durante la distribuzione dell'applicazione e risolvere il problema. Per ulteriori informazioni sui metodi di visualizzazione dei log per le applicazioni Bluemix, vedi [visualizzazione dei log](/docs/monitor_log/monitoringandlogging.html#viewing_logs). + +Per comprendere il motivo per cui la tua applicazione potrebbe provocare errori in {{site.data.keyword.Bluemix_notm}}, devi sapere come vengono distribuite ed eseguite le applicazioni in {{site.data.keyword.Bluemix_notm}}. Per informazioni dettagliate, vedi [Distribuzione +delle applicazioni](/docs/manageapps/depapps.html#appdeploy). + + +La seguente procedura mostra come puoi utilizzare il comando `cf logs` per eseguire il debug degli errori di preparazione. Prima di iniziare +la procedura, assicurati di aver installato l'interfaccia riga di comando cf. Per ulteriori informazioni sull'installazione dell'interfaccia +riga di comando cf, vedi [Installing the cf +command line interface](/docs/starters/install_cli.html). + + 1. Connettiti a {{site.data.keyword.Bluemix_notm}} immettendo il seguente codice nell'interfaccia riga di comando cf: + ``` + cf api https://api.ng.bluemix.net + ``` + + 2. Accedi a {{site.data.keyword.Bluemix_notm}} immettendo `cf login`. + + 3. Recupera i log recenti immettendo `cf logs appname --recent`. Se vuoi filtrare un log dettagliato, utilizza l'opzione `grep`. Ad esempio, puoi immettere il seguente codice per visualizzare solo i log [STG]: + ``` + cf logs appname --recent | grep '\[STG\]' + ``` + 4. Visualizza il primo errore mostrato nel log. + +Se utilizzi distribuisci le applicazioni attraverso gli strumenti IBM Eclipse per il plug-in {{site.data.keyword.Bluemix_notm}}, nella scheda **Console** dello strumento Eclipse puoi visualizzare dei log simili all'output di cf logs. Puoi anche aprire una finestra di Eclipse separata per tracciare `i log` quando distribuisci l'applicazione. + +Oltre al comando `cf logs`, in {{site.data.keyword.Bluemix_notm}} puoi utilizzare anche il servizio Monitoring and Analytics per raccogliere i dettagli del log. Inoltre, il servizio Monitoring and Analytics monitora le prestazioni, l'integrità e la disponibilità delle tue applicazioni. Fornisce anche analisi di log per le applicazioni di runtime Node.js e Liberty. + +### Debug degli errori di preparazione per un'applicazione Node.js + +Il seguente esempio mostra un log che viene visualizzato dopo che immetti `cf logs nomeapplicazione --recent`. Nell'esempio +si suppone che si siano verificati errori di preparazione per un'applicazione Node.js: +``` +2014-08-11T14:19:36.17+0100 [API] OUT Updated app with guid 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 ({name"=>"SampleExpressApp"} +2014-08-11T14:20:44.17+0100 [API] OUT Updated app with guid 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 ({"state"=>"STOPPED"}) +2014-08-11T14:20:44.19+0100 [App/0] ERR +2014-08-11T14:20:44.43+0100 [DEA] OUT Stopping app instance (index 0) with guid 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 +2014-08-11T14:20:44.44+0100 [DEA] OUT Stopped app instance (index 0) with guid 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 +2014-08-11T14:20:48.97+0100 [DEA] OUT Got staging request for app with id 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 +2014-08-11T14:20:50.94+0100 [API] OUT Updated app with guid 6d80051d-eb56-4fc5-b499-e43d6fb87bc2 ({"state"=>"STARTED"}) +2014-08-11T14:20:51.66+0100 [STG] OUT -----> Download app package (4.1M) +2014-08-11T14:20:51.90+0100 [STG] OUT -----> Download app buildpack cache (1.1M) +2014-08-11T14:20:52.78+0100 [STG] OUT -----> Buildpack Version: v1.1-20140717-1447 +2014-08-11T14:20:52.78+0100 [STG] ERR parse error: Expected another key-value pair at line 18, column 3 +2014-08-11T14:20:52.79+0100 [STG] OUT 0 info it worked if it ends with ok +``` +{: screen} + + +Il primo errore nel log mostra il motivo per cui la preparazione non riesce. Nell'esempio, il primo errore è un output del componente DEA +durante la fase di preparazione. +``` +2014-08-11T14:20:52.78+0100 [STG] ERR parse error: expected another key-value pair at line 18, column 3 +``` +{: screen} + + +Per un'applicazione Node.js, il DEA utilizza le informazioni contenute nel file `package.json` per scaricare i moduli. Da questo errore, puoi vedere +che l'errore si verifica per il modulo. Pertanto, potresti dover riesaminare la riga 18 del file `package.json`. + +``` +15 "jade": "~1.3.0", +16 "mongodb": "*", +17 "monk":"*", +18 } +``` +{: screen} + + +Puoi notare che viene inserita una virgola alla fine della riga 17 e quindi è prevista una coppia chiave-valore alla riga 18. Per correggere il problema, rimuovi la virgola: + +``` +15 "jade": "~1.3.0", +16 "mongodb": "*", +17 "monk":"*" +18 } +``` +{: screen} + + +## Debug degli errori di runtime +{: #debugging-runtime-errors} +Se durante il runtime riscontri dei problemi con la tua applicazione, i log dell'applicazione possono aiutarti a individuare la causa dell'errore e a risolvere il problema. + +In particolare, è possibile abilitare la registrazione in stdout e stderr. Per ulteriori informazioni su come configurare i file di log per le applicazioni +che vengono distribuite tramite i pacchetti di build integrati {{site.data.keyword.Bluemix_notm}}, consulta il seguente elenco: + + * Per le applicazioni Liberty for Java™, consulta [Liberty Profile: Logging and Trace ![icona link esterno](../icons/launch-glyph.svg)](http://www-01.ibm.com/support/knowledgecenter/was_beta_liberty/com.ibm.websphere.wlp.nd.multiplatform.doc/ae/rwlp_logging.html){: new_window}. + * Per le applicazioni Node.js, vedi [How to log in node.js ![icona link esterno](../icons/launch-glyph.svg)](http://docs.nodejitsu.com/articles/intermediate/how-to-log){: new_window}. + * Per le applicazioni PHP, vedi [error_log ![icona link esterno](../icons/launch-glyph.svg)](http://php.net/manual/en/function.error-log.php){: new_window}. + * Per le applicazioni Python, vedi [Logging HOWTO ![icona link esterno](../icons/launch-glyph.svg)](https://docs.python.org/2/howto/logging.html){: new_window}. + * Per le applicazioni Ruby on Rails, vedi [The Logger ![icona link esterno](../icons/launch-glyph.svg)](http://guides.rubyonrails.org/debugging_rails_applications.html#the-logger){: new_window}. + * Per le applicazioni Ruby Sinatra, vedi [Logging ![icona link esterno](../icons/launch-glyph.svg)](http://www.sinatrarb.com/intro.html#Logging){: new_window}. + +Quando immetti `cf logs nomeapplicazione --recent` nell'interfaccia riga di comando cf, vengono visualizzati solo i log più recenti. Per visualizzare i log con gli errori che si sono verificati in precedenza, devi recuperare tutti i log e ricercare gli errori. Per recuperare tutti i log per la tua applicazione, utilizza uno dei seguenti metodi: +
+
Servizio {{site.data.keyword.Bluemix_notm}} Monitoring and Analytics
+
La capacità di ricerca e analisi dei file di log del servizio Monitoring and Analytics possono aiutarti a identificare rapidamente gli errori. Per ulteriori informazioni, vedi Monitoring and Analytics.
+
Strumenti di terze parti
+
Puoi raccogliere ed esportare i log dalla tua applicazione a un host di log esterno. Per ulteriori informazioni, vedi Configurazione della registrazione esterna.
+
Script per la raccolta e l'esportazione dei log
+
Per utilizzare uno script per la raccolta e l'esportazione automatica dei log in un file esterno, devi connetterti alla console {{site.data.keyword.Bluemix_notm}} dal tuo computer in cui deve essere disponibile spazio sufficiente per scaricare i log. Per ulteriori informazioni, vedi Raccolta delle informazioni di diagnostica.
+
+ +I file `stdout.log` e `stderr.log` erano precedentemente accessibili, per impostazione predefinita, tramite la vista dell'applicazione nella console {{site.data.keyword.Bluemix_notm}} sotto **File** > **log**. Tuttavia, tale registrazione dell'applicazione non è più disponibile +con la versione corrente di Cloud Foundry in cui è ospitato {{site.data.keyword.Bluemix_notm}}. Per fare in modo che la registrazione dell'applicazione stdout e stderr continui a essere accessibile tramite la console {{site.data.keyword.Bluemix_notm}} sotto **File** > **log**, puoi reindirizzare la registrazione ad altri file nel file system {{site.data.keyword.Bluemix_notm}}, a seconda del runtime che stai utilizzando. + + * Per le applicazioni Liberty for Java, l'output indirizzato a stdout e stderr è già contenuto nel file `messages.log` nella directory logs. Ricerca le voci con prefisso SystemOut e SystemErr. + * Per le applicazioni Node.js, puoi sovrascrivere la funzione console.log per scrivere esplicitamente in un file nella directory logs. + * Per le applicazioni PHP, puoi utilizzare la funzione error_log per scrivere in un file nella directory logs. + * Per le applicazioni Python, puoi fare in modo che il logger scriva in un file nella directory logs: `logging.basicConfig(filename='/docs/logs/example.log',level=logging.DEBUG)` + * Per le applicazioni Ruby, puoi fare in modo che il logger scriva in un file nella directory logs. + + +### Debug delle modifiche al codice +{: #debug_code_changes} + +Se stai apportando modifiche al codice in un'applicazione già distribuita e funzionante, ma le modifiche non vengono rispecchiate in {{site.data.keyword.Bluemix_notm}}, puoi eseguire il debug utilizzando i log. A prescindere che la tua applicazione sia o no in esecuzione, puoi controllare i log generati durante la distribuzione dell'applicazione o il runtime per scoprire il motivo per cui il nuovo codice non funziona. + +A seconda del modo in cui il nuovo codice viene distribuito, scegli uno dei seguenti metodi per eseguire il debug delle modifiche al codice: + + * In caso di nuovo codice distribuito dalla riga di comando cf, controlla l'output del comando *cf push*. Inoltre, puoi utilizzare il comando *cf logs* per trovare ulteriori indizi utili per la risoluzione del problema. Per ulteriori informazioni su come utilizzare il comando *cf logs*, vedi [visualizzazione dei log dall'interfaccia riga di comando](/docs/monitor_log/monitoringandlogging.html#viewing_logs_cli). + + * In caso di nuovo codice distribuito da una GUI, quale ad esempio la console {{site.data.keyword.Bluemix_notm}}, DevOps Delivery Pipeline o l'IC di Travis, puoi controllare i log dall'interfaccia. Ad esempio, se distribuisci il nuovo codice dalla console {{site.data.keyword.Bluemix_notm}}, puoi passare al dashboard, trovare la tua applicazione e visualizzare i log per trovare degli indizi. Per ulteriori informazioni su come visualizzare i log dalla console {{site.data.keyword.Bluemix_notm}}, vedi [Visualizzazione dei log dal dashboard Bluemix](/docs/monitor_log/monitoringandlogging.html#viewing_logs_UI). + + +# rellinks +{: #rellinks} + +## general +{: #general} + + * [DEA (Droplet Execution Agent) ![icona link esterno](../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/concepts/architecture/execution-agent.html){: new_window} + * [Introduzione al servizio IBM Monitoring and Analytics per Bluemix](/docs/services/monana/index.html#gettingstartedtemplate) + * [Come funziona Bluemix](/docs/overview/whatisbluemix.html#howwork) + * [Installazione dello strumento di comando cf](/docs/starters/install_cli.html) + * [Visualizzazione dei log](/docs/monitor_log/monitoringandlogging.html#viewing_logs) + + + + + + + + + + + + + + + + + + diff --git a/dedicated/index.md b/dedicated/index.md index b4bcbc179..3cc7bd836 100755 --- a/dedicated/index.md +++ b/dedicated/index.md @@ -1,518 +1,518 @@ ---- - - - -copyright: - - years: 2015, 2017 - -lastupdated: "2017-01-11" - ---- - -{:shortdesc: .shortdesc} - -# {{site.data.keyword.Bluemix_dedicated_notm}} -{: #dedicated} - - -{{site.data.keyword.Bluemix}} is an open-standards, cloud-based platform for building, running, and managing applications. With {{site.data.keyword.Bluemix_dedicated_notm}}, you get the power and simplicity of {{site.data.keyword.Bluemix_notm}}—in your own dedicated SoftLayer environment that is securely connected to both the {{site.data.keyword.Bluemix_notm}} Public environment and your own network. -{:shortdesc} - -All dedicated deployments of {{site.data.keyword.Bluemix_notm}} include the following benefits and features at no additional cost: VPN, private virtual local area network (VLAN), firewall, connectivity with your LDAP, ability to leverage existing on-premises databases and apps, 24/7 on-site security, dedicated hardware, and standard support. - -By default, access to your private {{site.data.keyword.Bluemix_notm}} instance is only accessible from your corporate network. If you need the {{site.data.keyword.Bluemix_notm}} environment to be accessible directly from the internet, a mobile device, or a dedicated database, for example, then an additional network security component is required at additional cost. - -{{site.data.keyword.Bluemix_dedicated_notm}} comes with all included {{site.data.keyword.Bluemix_notm}} runtimes and 64 GB of compute resources memory. - -In addition, there is a set of services and components that are included or optional for purchase. Review the following table to see what is included and what you can purchase optionally. - -| **Type** | **Name** | **Description** | -|-----------------|-------------------|-------------------| -|Included | [{{site.data.keyword.Bluemix_notm}} runtimes](/docs/cfapps/runtimes.html) | Use runtimes to get your app up and running quickly, with no need to set up and manage machines and operating systems. All {{site.data.keyword.Bluemix_notm}} runtimes are available for you to use in your {{site.data.keyword.Bluemix_dedicated_notm}} instance.| -| Included | [{{site.data.keyword.autoscaling}}](/docs/services/Auto-Scaling/index.html) | Dynamically increase or decrease the compute capacity of your application based on policies. With this service, you have unlimited use in your {{site.data.keyword.Bluemix_dedicated_notm}} environment. Note: Auto-scaling currently only works with Cloud Foundry runtimes | -|Optional | [{{site.data.keyword.apiconnect_short}}](/docs/services/apiconnect/index.html) | {{site.data.keyword.apiconnect_long}} integrates {{site.data.keyword.APIM}} and IBM StrongLoop into a single offering that provides a comprehensive solution to create, run, manage, and enforce APIs and microservices. | -|Optional | [{{site.data.keyword.rules_short}}](/docs/services/rules/rules.html) | {{site.data.keyword.rules_short}} offers a comprehensive environment to automate and execute frequently occurring, repeatable rules-based business decisions. It also enables business users or developers to quickly model decisions and test them at lower costs by reducing the need for IT skills. | -|Optional | [{{site.data.keyword.cloudant}}](/docs/services/Cloudant/index.html#Cloudant) | {{site.data.keyword.cloudant}} provides access to a fully managed NoSQL JSON data layer that's always on. This service is compatible with CouchDB, and accessible through a simple to use HTTP interface for mobile and web application models. | -|Optional | [{{site.data.keyword.containershort}}](/docs/containers/container_index.html) | Run Docker containers on {{site.data.keyword.Bluemix_dedicated_notm}}. Containers are virtual software objects that include all of the elements that an app needs to run. A container has the benefits of resource isolation and allocation, but is more portable and efficient than, for example, a virtual machine. For information about the hardware requirements, see [IBM {{site.data.keyword.containershort}} in {{site.data.keyword.Bluemix_dedicated_notm}} and Bluemix Local](/docs/containers/container_dl.html).| -| Optional | [{{site.data.keyword.contdelivery_short}}](/docs/services/ContinuousDelivery/index.html) | Use {{site.data.keyword.contdelivery_short}} Dedicated to automate builds, unit tests, deployments, and more. Edit and push code through the rich web based IDE. Create toolchains to enable tool integrations that support development, deployment, and operations tasks. | -| Optional | [{{site.data.keyword.dashdbshort}}](/docs/services/dashDB/dashDB.html) | IBM {{site.data.keyword.dashdbshort}} for Analytics is a fully managed SQL cloud database service, optimized for data warehouse and analytics workloads. IBM {{site.data.keyword.dashdbshort}} for Transactions is a fully managed SQL cloud database service, optimized for general purpose, web apps, and transactional workloads. | -| Optional | [{{site.data.keyword.datacshort}}](/docs/services/DataCache/index.html#data_cache) | This service provides an in-memory data grid that supports distributed caching scenarios for your apps. Includes 50 GB of in-memory Cache. | -| Optional | [Dedicated GitHub Enterprise](/docs/services/ghededicated/index.html) | {{site.data.keyword.ghe_long}} is the IBM Cloud-hosted and fully managed version of GitHub Enterprise that provides the social experience that developers love. This service is currently available exclusively to {{site.data.keyword.Bluemix_dedicated_notm}} environments. | -| Optional (Beta) | [Logging](/docs/monitoringandlogging/cfapps_ml_logs_dedicated_ov.html#container_ml_logs_dedicated_ov) | Provides logs for your Cloud Foundry apps in your {{site.data.keyword.Bluemix_notm}} user interface and searchable logs and dashboards in Kibana. | -| Optional | [{{site.data.keyword.messagehub}}](/docs/services/MessageHub/index.html#messagehub) | {{site.data.keyword.messagehub}} is a scalable, distributed, high throughput message bus to unite your on-premises and off-premises technologies. {{site.data.keyword.messagehub}} is based on Apache Kafka, which is a fast, scalable, and durable real-time messaging engine. | -|Optional | [{{site.data.keyword.mobilepush}}](/docs/services/mobilepush/index.html) | {{site.data.keyword.mobilepush}} is a service that you can use to send notifications to iOS and Android device. Notifications can be targeted to all application users or to a specific set of users and devices using tags. You can administer devices, tags, and subscriptions. You can also use an SDK (software development kit) and Representational State Transfer (REST) application program interface (APIs) to further develop your client applications.| -|Optional | [{{site.data.keyword.SecureGateway}}](/docs/services/SecureGateway/secure_gateway.html) | The {{site.data.keyword.SecureGateway}} service provides a secure way to connect {{site.data.keyword.Bluemix_notm}} applications to remote locations on-premises or in the cloud. | -|Optional | [{{site.data.keyword.sescashort}}](/docs/services/SessionCache/index.html#session_cache) | For increased redundancy, {{site.data.keyword.sescashort}} provides a replica of a session stored in the cache. Therefore, in the event of a brownout or outage, your client application maintains access to the session in the cache. The service supports session caching scenarios for web and mobile applications. | -| Optional | [{{site.data.keyword.iot_short}}](/docs/services/IoT/index.html) | This service lets your apps communicate with and consume data collected by your connected devices, sensors and gateways. The base offering permits running a private version of the {{site.data.keyword.iot_short}} within the dedicated environment with a capacity of 100,000 concurrently connected devices or applications and 1.6 TB of data exchange. | -| Optional | [{{site.data.keyword.appserver_short}}](/docs/services/ApplicationServeronCloud/index.html) | IBM {{site.data.keyword.appserver_short}} for IBM {{site.data.keyword.Bluemix_notm}} is a service that facilitates quick setup on a pre-configured {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment, or Traditional WebSphere Java EE instance in a hosted cloud environment on {{site.data.keyword.Bluemix_notm}}. | -{: caption="Table 1. Dedicated Services" caption-side="top"} -{: #table01} - - - -There are optional components that are available for you to purchase to scale and extend the capacity of your resources and services. You can purchase any of these components by contacting the sales team; go to [Contact us](https://console.ng.bluemix.net/?direct=classic/#/contactUs/cloudOEPaneId=contactUs) for information about contacting a sales representative. To increase your plan for a service, you can select the plan from the service tile in your catalog. - -| **Name** | **Description** | -|-------------------|-------------------| -|Dedicated {{site.data.keyword.apiconnect_short}} Professional 5 Million API Calls | An environment that permits running a private version of {{site.data.keyword.apiconnect_short}} within the dedicated environment with a capacity of 5 million API Calls a month targeted towards departmental API projects. | -|Dedicated {{site.data.keyword.apiconnect_short}} Professional 100 thousand API Calls increase | An extension of the {{site.data.keyword.apiconnect_short}} Professional environment to provide additional capacity of 100 thousand API Calls a month. | -|Dedicated {{site.data.keyword.apiconnect_short}} Enterprise 25 Million API Calls | An environment that permits running a private version of {{site.data.keyword.apiconnect_short}} within the dedicated environment with a capacity of 25 million API Calls a month targeted towards enterprise wide API projects. | -|Dedicated {{site.data.keyword.apiconnect_short}} Enterprise 100 thousand API Calls increase | An extension of the {{site.data.keyword.apiconnect_short}} Enterprise environment to provide additional capacity of 100 thousand API Calls a month. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.rules_short}} 1 Million Rules Decisions | A Rules Decision is the outcome of invoking a ruleset from a rule execution server. Sufficient entitlements must be obtained to cover the total number of Rules Decisions, rounded up to the nearest Million, executed or processed, during the billing period. The Rules Decisions measured by this Cloud Service are the calls made to the rule execution server to get a decision. Dedicated deployments of the Cloud Service have an agreed capacity measured by the relevant charge metric. The {{site.data.keyword.rules_short}} service default space allocation on the {{site.data.keyword.Bluemix_dedicated_notm}} platform is 16 GB, from which up to ten instances of 1 GB each can be invoked to execute entitled Rules Decisions. If you exceed that usage limitation, you must purchase additional capacity to cover that usage. | -|Dedicated {{site.data.keyword.cloudant}} 1.6 TB capacity increase | Includes running a private version of the {{site.data.keyword.cloudantfull}} within the dedicated environment with a design capacity of 1.6 terabytes. | -|Dedicated {{site.data.keyword.datacshort}} and {{site.data.keyword.sescashort}} 50 GB capacity increase | An environment that permits deploying and running {{site.data.keyword.datacshort}} and {{site.data.keyword.sescashort}} instances up to a cumulative capacity of 50 GB. | -|{{site.data.keyword.contdelivery_short}} Dedicated Instance | A private version of {{site.data.keyword.contdelivery_short}} running within a dedicated environment. The capacity is determined by {{site.data.keyword.contdelivery_short}} Dedicated Authorized User entitlements. | -|{{site.data.keyword.contdelivery_short}} Dedicated Authorized User | Grants an Authorized User access to and for the use of a designated {{site.data.keyword.contdelivery_short}} Dedicated environment. Every user belonging to a {{site.data.keyword.Bluemix_notm}} Organization containing a {{site.data.keyword.contdelivery_short}} service instance must be authorized. | -|Dedicated {{site.data.keyword.dashdbshort}} Enterprise 64.1 | One database per service instance on a dedicated server with 64 GB RAM, 16 vCPUs. Recommended for up to 1 TB of pre-load data, based on typical compression. | -|Dedicated {{site.data.keyword.dashdbshort}} Enterprise 256.4 | One database per service instance on a dedicated bare metal server with 256 GB RAM, 32 cores. Recommended for up to 4 TB of pre-load data, based on typical compression. | -|Dedicated {{site.data.keyword.dashdbshort}} Enterprise 256.12 | One database per service instance on a dedicated bare metal server with 256 GB RAM, 32 Cores. Recommended for up to 12 TB of pre-load data, based on typical compression. This is a storage dense plan suitable for environments where data volumes are higher and queries do not need to run at in-memory speeds. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions 2.8.500 | Dedicated instance supporting Online Transaction Processing (OLTP) workloads with 8GB RAM and 500 GB of space for data and logs. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions 12.128.1400 | Dedicated instance supporting Online Transaction Processing (OLTP) workloads with 128GB RAM and 1.4 TB SSD storage for data and logs. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions High Availability 2.8.500 | Dedicated instance supporting Online Transaction Processing (OLTP) workloads with 8GB RAM and 500 GB of space for data and logs, and it includes an additional Standby server for high availability. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions High Availability 12.128.1400 | Dedicated instance supporting Online Transaction Processing (OLTP) workloads with 128GB RAM and 1.4 TB SSD storage for data and logs, and it includes an additional Standby server for high availability. | -|{{site.data.keyword.Bluemix_dedicated_notm}} community services | An environment that permits deploying and running community services up to a total of 50 instances for each community service. | -|{{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.cloudant}} Cluster Instance | This optional component includes a 3-node cluster for which you are responsible for providing the infrastructure, and the storage and compute capacity can be determined based on your specific needs. {{site.data.keyword.cloudant}} provides access to a fully managed NoSQL JSON data layer that's always on. This service is compatible with CouchDB, and accessible through a simple to use HTTP interface for mobile and web application models. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.messagehub}} | An environment that provides publish and subscribe messaging of up to 10 GB per partition. Messages are retained and available for consumption for a maximum of 24 hours. | -|IBM Bluemix Dedicated {{site.data.keyword.mobilepushshort}} | An environment that permits deployment and execution of {{site.data.keyword.mobilepushshort}} instances with ability to accept 300 requests per second. | -|{{site.data.keyword.iot_short}} Dedicated incremental increase | An environment increase that permits running a private version of the {{site.data.keyword.iot_short}} within the dedicated environment with a capacity of 100,000 concurrently connected devices or applications and 0.5 TB of data exchange. | -|IBM {{site.data.keyword.appserver_short}} for {{site.data.keyword.Bluemix_notm}} - Dedicated Small| A pre-configured {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment, or Traditional WebSphere Java EE instance in a hosted cloud environment on {{site.data.keyword.Bluemix_notm}} with 64 vCores, 128GB RAM and 1TB HDD per month. | -|IBM {{site.data.keyword.appserver_short}} for {{site.data.keyword.Bluemix_notm}} - Dedicated Medium| A pre-configured {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment, or Traditional WebSphere Java EE instance in a hosted cloud environment on {{site.data.keyword.Bluemix_notm}} with 128 vCores, 256GB RAM and 2TB HDD per month. | -|IBM {{site.data.keyword.appserver_short}} for {{site.data.keyword.Bluemix_notm}} - Dedicated Large| A pre-configured {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment, or Traditional WebSphere Java EE instance in a hosted cloud environment on {{site.data.keyword.Bluemix_notm}} with 256 vCores, 512GB RAM and 4TB HDD per month. | -|IBM {{site.data.keyword.appserver_short}} for {{site.data.keyword.Bluemix_notm}} - Dedicated| A pre-configured {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment, or Traditional WebSphere Java EE instance in a hosted cloud environment on {{site.data.keyword.Bluemix_notm}} with HDD Expansion and 1TB per month. | -{: caption="Table 2. Optional service components for purchase" caption-side="top"} -{: #table02} - - - -| **Name** | **Description** | -|-------------------|-------------------| -|Dedicated runtimes 16 GB capacity increase | An extension of the runtimes environment to provide an extra 16 GB of runtime capacity. | -|Dedicated Direct Link 1 Gbps capacity | A dedicated network link that connects directly to the appropriate {{site.data.keyword.BluSoftlayer}} network point of presence designed for data transfers of up to 1 Gbps. | -|Dedicated Direct Link 10 Gbps capacity | A dedicated network link that connects directly to the appropriate {{site.data.keyword.BluSoftlayer}} network point of presence designed for data transfers of up to 10 Gbps. | -|IBM Bluemix Dedicated Hardware Firewall - High Availability | A redundant 1 Gbps hardware firewall configured for protection for single, multiple, or all servers on same VLAN within the Dedicated environment. | -{: caption="Table 3. Optional platform add-on components for purchase" caption-side="top"} -{: #table03} - -**Note**: {{site.data.keyword.Bluemix_dedicated_notm}} components might indicate a specific configured capacity, such as gigabytes or transactions per second. Because actual capacity in practice for any configuration of the cloud service varies depending on many factors, the actual capacity in practice might be more or less than the configured capacity. - -### Syndicated catalog -{: #catalogdedicated} - -{{site.data.keyword.Bluemix_dedicated_notm}} includes a private catalog that brings together approved services across your public, dedicated and local deployments. You can even publish and manage access to your own services through the {{site.data.keyword.Bluemix_notm}} catalog. You have the option to decide which public services meet the requirements for your business based on your data privacy and security criteria. - -If you have a private instance of the service for your dedicated environment, you see a "Dedicated" tag with the service names in your catalog. Similarly, if it is a custom service, meaning you used a service broker to create it, you see "Custom" listed with the service name. All other services listed that do not have a "dedicated" or "custom" tag are available by using syndication from {{site.data.keyword.Bluemix_notm}} Public. Syndicated services provide the function to create hybrid applications that consist of public and private services. - -|Service |Available in US South region |Available in Europe United Kingdom region |Available in Australian Sydney region| -|:----------|:------------------------------|:------------------|:------------------| -|{{site.data.keyword.alchemyapishort}} |Yes |Yes |Yes| -|{{site.data.keyword.alertnotificationshort}} |Yes |Yes |Yes | -|{{site.data.keyword.apiconnect_short}} |Yes |Yes |Yes | -|{{site.data.keyword.appseccloudshort}} |Yes |Yes |Yes | -|{{site.data.keyword.apiconnect_short}} |Yes |Yes |Yes | -|Automated Accessibility Checker |Yes |Yes |Yes | -|{{site.data.keyword.rules_short}} |Yes |Yes |Yes | -|{{site.data.keyword.cloudant}} |Yes |Yes |Yes | -|{{site.data.keyword.iotmapinsights_short}} |Yes |Yes |Yes | -|{{site.data.keyword.conversationshort}} |Yes |Yes |Yes | -|{{site.data.keyword.dashdbshort}} |Yes |Yes |Yes | -|{{site.data.keyword.dataworks_short}} |Yes |Yes |No| -|{{site.data.keyword.DB2OnCloud_short}} |Yes |Yes |Yes | -|Digital Content Checker |Yes |Yes |Yes | -|{{site.data.keyword.documentconversionshort}} |Yes |Yes |Yes| -|{{site.data.keyword.iotdriverinsights_short}} |Yes |Yes |Yes | -|{{site.data.keyword.geospatialshort_Geospatial}} |Yes |Yes |Yes | -|{{site.data.keyword.GlobalizationPipeline_short}} |Yes | Yes | Yes | -|{{site.data.keyword.identitymixershort}} |Yes |Yes |Yes| -|{{site.data.keyword.iot4auto_short}} |Yes |Yes |Yes | -|{{site.data.keyword.iotelectronics}} |Yes |Yes |No | -|{{site.data.keyword.iotinsurance_short}} |No |No |Yes | -|{{site.data.keyword.twittershort}} |Yes |Yes |Yes| -|{{site.data.keyword.languagetranslationshort}} |Yes |Yes |Yes | -|{{site.data.keyword.languagetranslatorshort}} |Yes |Yes |Yes | -|{{site.data.keyword.dwl_short}} |Yes |Yes |No | -|{{site.data.keyword.eventhubshort}} |Yes |No |No| -|{{site.data.keyword.messagehub}} |Yes |Yes |No| -|{{site.data.keyword.manda}} |Yes |Yes |Yes | -|{{site.data.keyword.amashort}} |Yes |Yes |Yes | -|{{site.data.keyword.mqa}} |Yes |Yes |Yes | -|{{site.data.keyword.mql}} |No |No |Yes | -|{{site.data.keyword.nlclassifierlshort}} |Yes |Yes |Yes| -|{{site.data.keyword.personalityinsightsshort}} |Yes |Yes |Yes| -|{{site.data.keyword.pm_short}} |Yes |Yes |No | -|{{site.data.keyword.mobilepush}} |Yes |Yes |Yes | -|{{site.data.keyword.retrieveandrankshort}} |Yes |Yes |Yes| -|{{site.data.keyword.runbook_short}} |Yes |Yes |Yes| -|{{site.data.keyword.SecureGateway}} |Yes |Yes |Yes | -|{{site.data.keyword.ssofull}} |Yes |No |No| -|{{site.data.keyword.speechtotextshort}} |Yes |Yes |Yes| -|{{site.data.keyword.streaminganalyticsshort}} |Yes |Yes |Yes | -|{{site.data.keyword.texttospeechshort}} |Yes |Yes |Yes| -|{{site.data.keyword.toneanalyzershort}} |Yes |Yes |Yes| -|{{site.data.keyword.tradeoffanalyticsshort}} |Yes |Yes |Yes| -|{{site.data.keyword.visualrecognitionshort}} |Yes |Yes |Yes| -|{{site.data.keyword.iot_short}} |Yes |Yes |No| -|{{site.data.keyword.weather_short}} |Yes |Yes |Yes| -|{{site.data.keyword.workloadscheduler}} |Yes |Yes |Yes | -{: caption="Table 4. Services available for syndication from {{site.data.keyword.Bluemix_notm}} Public by region" caption-side="top"} -{: #table04} - -**Note**: Third-party services are not included in the table. Check your dedicated catalog for third-party service options. - - - -## {{site.data.keyword.Bluemix_dedicated_notm}} architecture -{: #dedicatedarch} - -{{site.data.keyword.Bluemix_dedicated_notm}} can be deployed in any [{{site.data.keyword.IBM_notm}} SoftLayer data center ![External link icon](../icons/launch-glyph.svg)](http://www.softlayer.com/data-centers){: new_window} around the world. {{site.data.keyword.IBM_notm}} SoftLayer provides the highest performing cloud infrastructure. Each data center has 24 hour, 7 days a week security, and rigorous controls. - -Each {{site.data.keyword.Bluemix_dedicated_notm}} deployment is dedicated to a single enterprise on {{site.data.keyword.IBM_notm}} SoftLayer dedicated hardware in it's own private network. {{site.data.keyword.Bluemix_dedicated_notm}} environments have the same security standards as the public {{site.data.keyword.Bluemix_notm}} in terms of infrastructure, operational, and physical security. However, developer access to the dedicated {{site.data.keyword.Bluemix_notm}} is controlled by your LDAP policies, which can be configured by the {{site.data.keyword.Bluemix_notm}} team when they set up your environment. Within the dedicated environment, you can manage user roles and permissions. See [Managing users and permissions](/docs/admin/index.html#oc_useradmin) for details. The following figure depicts the logical architecture of a default {{site.data.keyword.Bluemix_dedicated_notm}} deployment. - -![{{site.data.keyword.Bluemix_dedicated_notm}}](images/bm_dedicated_arch.png "{{site.data.keyword.Bluemix_dedicated_notm}} default architecture") - -Figure 1. Detailed {{site.data.keyword.Bluemix_dedicated_notm}} diagram default architecture -{: #figure01} - -The significant architectureal components depicted in the previous architecture diagram include the following: - -
-
{{site.data.keyword.IBM_notm}} Cloud
-
-The {{site.data.keyword.IBM_notm}} Cloud environment as a whole includes the following significant networking environments: -
    -
  • {{site.data.keyword.Bluemix_dedicated_notm}}
    • -
  • {{site.data.keyword.Bluemix_notm}} Public
    • -
  • {{site.data.keyword.IBM_notm}} Operations
    • -
-
-
{{site.data.keyword.Bluemix_dedicated_notm}}
-
-At a minimum, this contains the Cloud Foundry components and some dedicated application services. {{site.data.keyword.Bluemix_notm}} provides both Cloud Foundry and {{site.data.keyword.containerlong}}-based compute environments. An enterprise might have one or both of these compute environments configured.
-An enterprise might add additional dedicated application services.
-Please refer to [table 2](#table02) for additional services and compute capabilities that may be added. -
-
{{site.data.keyword.Bluemix_notm}} Public
-
-An {{site.data.keyword.Bluemix_dedicated_notm}} might include an outbound connection to an {{site.data.keyword.Bluemix_notm}} Public region. This provides syndication of public services onto the dedicated catalog. {{site.data.keyword.Bluemix_notm}} Public service syndication provides a convenient method for developers to build applications hosted on their enterprise's {{site.data.keyword.Bluemix_dedicated_notm}} and accessing services running in {{site.data.keyword.Bluemix_notm}} Public. The list of services that can be syndicated from {{site.data.keyword.Bluemix_notm}} Public shown on [table 4 of the Syndicated catalog section](#catalogdedicated). -
-
{{site.data.keyword.IBM_notm}} Operations
-
-{{site.data.keyword.IBM_notm}} manages, monitors, and maintains the dedicated platform and dedicated services so you can focus on building innovative applications. The {{site.data.keyword.IBM_notm}} Operations Support Services (OSS) team performs operations by using a VPN tunnel connection from {{site.data.keyword.IBM_notm}}'s Operations network. -
-
Enterprise
-
-The enterprise network environment may have a secured private bi-directional network link to {{site.data.keyword.Bluemix_dedicated_notm}}. This allows applications hosted in {{site.data.keyword.Bluemix_dedicated_notm}} to access services and resources in the enterprise, including data sources and enterprise services. This network link also allows {{site.data.keyword.Bluemix_dedicated_notm}} to use your LDAP for authentication of your enterprise's developers and administrators.
-
-There are several options for creating the secured private network link. Talk to your IBM technical specialist about the best networking option for your enterprise.
-
-The default connection from {{site.data.keyword.Bluemix_dedicated_notm}} to your enterprise network uses a Virtual Private Network (VPN). {{site.data.keyword.Bluemix_dedicated_notm}} has a Dedicated 1 Gbps Vyatta VPN termination configured for high availability. -
-In the default architecture for {{site.data.keyword.Bluemix_dedicated_notm}} as shown in [figure 1](#figure01), there is no inbound network traffic directly from the Internet. If your enterprise wishes to allow Internet access to applications hosted on {{site.data.keyword.Bluemix_dedicated_notm}}, the access must be configured through your Enterprise network. -
-
- - -## Setting up {{site.data.keyword.Bluemix_dedicated_notm}} -{: #setupdedicated} - -{{site.data.keyword.Bluemix_dedicated_notm}} is designed to provide a private version of the {{site.data.keyword.Bluemix_notm}} Public offering. You can use {{site.data.keyword.Bluemix_notm}} services and runtimes to support your computing needs in an IBM-hosted {{site.data.keyword.BluSoftlayer}} account. - -IBM provides you access to {{site.data.keyword.Bluemix_dedicated_notm}} by using a password-secured login. You can access the services, runtimes, and associated resources, and deploy and remove {{site.data.keyword.Bluemix_notm}} apps. IBM takes advantage of multiple {{site.data.keyword.BluSoftlayer}} locations to deliver {{site.data.keyword.Bluemix_dedicated_notm}}, so you can get your private version in a location close to you. - -To set up your private version of {{site.data.keyword.Bluemix_notm}}: - -
    -
  1. Contact your IBM designated account representative or contact {{site.data.keyword.Bluemix_notm}} External link icon to get started.
    2. -
  2. Work with IBM on your fee for your {{site.data.keyword.Bluemix_dedicated_notm}} instance. The monthly recurring fee is based on the dedicated services that you want to use, plus a subscription to all {{site.data.keyword.Bluemix_notm}} public services. You then receive an invoice for anything that you use beyond that subscription agreement.
    3. -
  3. Identify the deadlines for each phase of setting up your {{site.data.keyword.Bluemix_dedicated_notm}} instance. For information about each phase and the tasks involved, see {{site.data.keyword.Bluemix_dedicated_notm}} roles and responsibilities.
    4. -
  4. You select the {{site.data.keyword.BluSoftlayer}} data center location External link icon for your dedicated instance. Then, your dedicated platform and account are created. For your account, you identify the people in your organization for the roles that are needed to get your dedicated instance up and running. For information about the roles that you assign, see {{site.data.keyword.Bluemix_dedicated_notm}} roles and responsibilities. -
    5. -
  5. Define and establish network connectivity between your corporate network and your {{site.data.keyword.Bluemix_dedicated_notm}} instance. There is a mandatory network security appliance that includes firewall and intrusion prevention capabilities with an associated cost for this option. -
      -
    1. IBM installs monitoring and security infrastructure for the dedicated instance.
      2. -
    2. IBM installs the single-tenant dedicated services that you selected.
      3. -
    3. You provide network configuration and endpoints for things such as IP addresses or firewalls and access to your LDAP for integration into {{site.data.keyword.Bluemix_notm}}.
      4. -
    -
    6. -
  6. Identify and assign roles for your administrative team for the environment. -
      -
    1. IBM configures network access and LDAP based on what you provided. Administrative access is given to the contacts that you designate. You must also designate a contact for support and billing.
      2. -
    2. IBM sets up a syndicated catalog in your dedicated environment to show your dedicated services. The syndicated catalog includes additional services that are syndicated from and available for you to use from {{site.data.keyword.Bluemix_notm}} Public. You have the option to decide which public services meet the requirements for your business based on your data privacy and security criteria.
      3. -
    3. You validate network and firewall configuration and the LDAP endpoint and access.
      4. -
    -
    7. -
- -You can expect a process similar to the following list for the initial deployment and configuration for your environment. For details about who is responsible for each task, see [Roles and responsibilities](index.html#rolesresponsibilities). - -
    -
  1. You select which data center to use to host your dedicated instance. For information about data center options, see {{site.data.keyword.BluSoftlayer}} data center location External link icon.
    2. -
  2. You specify the domain names for the deployment, and the IDs that you want to use. You get three domains when you set up your {{site.data.keyword.Bluemix_notm}} instance. You pick the prefix for the *mycompany*.*region*.bluemix.net and *mycompany*.*region*.mybluemix.net. And, you choose the full name for the third domain.
    -

    You can choose as many custom domains as you want. However, you are responsible for the certificates for the custom domains. For information about creating your custom domain, see Creating and using a custom domain.

    3. -
  3. You identify an owner for the public account that is used to represent your company in {{site.data.keyword.Bluemix_notm}} Public. IBM uses this account for tracking syndicated services usage.
    4. -
  4. You select the type of secure connection to your data center. You can select from {{site.data.keyword.Bluemix_notm}} VPN, {{site.data.keyword.Bluemix_notm}} Direct Link, and AT&T Net Bond.
    5. -
  5. You decide whether there will be any access to your dedicated environment from the public Internet.
    6. -
  6. You select the type of authentication that will be used. You can select from IBMid or Active Directory. For information about using and registering for an IBMid, see the Help and FAQ page. -
    7. -
  7. You identify and assign roles for your administrative team for the environment. For information about the roles that you must assign, see {{site.data.keyword.Bluemix_dedicated_notm}} roles and responsibilities.
    8. -
  8. IBM deploys the core platform that includes the elastic runtimes, console, administration feature, and monitoring.
    9. -
  9. IBM configures your administrative access to the environment.
    10. -
  10. You can start using your dedicated instance that is monitored by the IBM operations team in order to respond to alerts.
    11. -
- -After your {{site.data.keyword.Bluemix_notm}} instance is set up, you can monitor and manage your {{site.data.keyword.Bluemix_notm}} instance by using the Administration page. For more information, see [Managing {{site.data.keyword.Bluemix_notm}} Local and Dedicated](../admin/index.html#mng). For information about upgrades and maintenance, see [Maintaining your dedicated instance](index.html#maintaindedicated). - -##Roles and responsibilities -{: #rolesresponsibilities} - -If you set up a {{site.data.keyword.Bluemix_dedicated_notm}} account, you identify the people in your organization for the roles that are needed to get your instance up and running. - -###Roles - -The following list shows the customer roles and responsibilities that you assign: - -
-
**Procurement focal**
-
Works with the IBM representative on establishing your {{site.data.keyword.Bluemix_dedicated_notm}} environment, including identifying the right people in your organization to work on any aspect of the project. The person assigned to this role takes on a project management role and oversees pattern selection, commercial arrangements, and arrangement of access to customer resources. The procurement focal is the overall contact for setting up the dedicated instance and tracking the process of the deployment.
-
**Compliance officer**
-
Works with the IBM representative to select a topology and deployment option that meets your security requirements. The person assigned to this role works with the IBM compliance consultant to determine which deployment patterns achieve the compliance goals.
-
**Network specialist**
-
Works with the IBM representative on the network plans for the {{site.data.keyword.Bluemix_notm}} deployment. The person assigned to this role reviews the required networking specifications required by IBM and works together with IBM on an implementation plan. At the end of the installation and verification phase, the person assigned to this role approves that the network configuration is in compliance with corporate standards.
-
**DevOps focal**
-
Works with the IBM representative to plan and apply the maintenance updates that are needed for the {{site.data.keyword.Bluemix_notm}} platform, services, and runtimes. The person assigned to this role also works with the IBM representative on the configuration of your {{site.data.keyword.Bluemix_dedicated_notm}} instance.
-
Operations focal
-
Works with the IBM support team as needed once the environment is up and running. This is someone with Superuser access to the Administration console who can approve and schedule maintenance updates for the Bluemix environment and be available at all times in the event of a critical incident. The person assigned to this role must have technical knowledge of the Bluemix environment and be in a position to reach others within company that have expert skills in an area that might be affected including networking or security, for example.
-
- -Your customer representatives work with IBM specialists that work together to ensure that you always have the support that you need. You can upgrade to the Premium support tier to work with a dedicated Client Success Manager (CSM) for your account. For more information about the different support tiers, see [Contacting support](../support/index.html#contacting-support).The CSM completes the following types of tasks: - -
    -
  • Enables rapid adoption of your {{site.data.keyword.Bluemix_dedicated_notm}} environment.
    • -
  • Delivers valuable education and enablement materials to improve your self-sufficiency.
    • -
  • Cultivates a long-term relationship between you and {{site.data.keyword.Bluemix_notm}} development, support, and services that you use.
    • -
- -The {{site.data.keyword.Bluemix_notm}} support and operations team that works with you on your {{site.data.keyword.Bluemix_notm}} instance might access your local environment, but does so only for the following reasons. - -
    -
  • To respond to alerts and perform operational maintenance
    • -
  • To attempt to reproduce a problem that is reported on a support ticket
    • -
- -### Responsibilities - -From setting up your environment to continued maintenance, a variety of tasks must be completed. The following table outlines the required tasks and the owner for completing the task throughout the inception, progression, and completion phases. - -The inception phase is used to establish the {{site.data.keyword.Bluemix_dedicated_notm}} environment. The primary goals of this phase include the following: - -- Review the financial agreement, and establish the milestone dates for delivery. -- Create the {{site.data.keyword.Bluemix_notm}} platform, and provide access to runtimes and services. -- Define and establish network connectivity between your corporate network and {{site.data.keyword.Bluemix_notm}} operations. -- Identify and assign roles for your administrative team. - -| **Task** | **Task details** | **Responsible party** | -|----------|------------------|-----------------------| -|Set compliance standards | Identify government, industry, and proprietary corporate standards that are required for the environment. | Customer | -|Create security and compliance integration plan | Create security and integration plan that includes costs, scheduling, and resources that are required to achieve security compliance. | IBM | -|Compliance plan approval | Approve the compliance plan. | Customer | -|Create sizing for environment | Create environment sizing based on predefined choices that take into consideration the high availability and disaster recovery goals, as well as initial DEA and service provisioning that is necessary to support the apps created with the platform. You and IBM work together to define, for example, what databases are needed, what services are offered in the customer's syndicated catalog, and more. | IBM and customer share responsibility | -|Select architecture | Select architecture based on predefined choices that take into account high availability and disaster recovery requirements. | IBM | -|Define disaster recovery goals | Define the disaster recovery requirements for the environment. | Customer | -|Create disaster recovery plan | Consult and define the disaster recovery plan. IBM creates a disaster recovery model, and consults with you where you provide feedback and approve the plan. | IBM and customer share responsibility | -|Create backup and recovery plan | Create a backup and recovery plan that defines the frequency and the requirements for on-and-off site distribution of the backup. IBM backs up fabric components, IBM services, service metadata including user roles, and more. You back up any application-specific data that you are responsible for. | IBM and customer share responsibility | -|Identify tools for event detection and problem determination | Identify IBM and third-party tools used for event detection and problem determination at the {{site.data.keyword.Bluemix_notm}} platform level. | IBM | -|Define escalation plan | Define the escalation plan to triage and resolve events detected from the monitoring components. | IBM | -|Sign infrastructure, platform, and support agreements | Sign the subscription agreement including the financial terms and conditions for the environment. Sign support subscription. | Customer | -|Procure environment | Procure compute resources, network, and storage including core and Services VLAN to host {{site.data.keyword.Bluemix_notm}}, bare metal services to host Data Power, and {{site.data.keyword.Bluemix_notm}} Firewall. Provide infrastructure to allow for VPN tunnel. | IBM | -|Install fabric, application, and monitoring and management components | Install, configure, and verify fabric components, such as BOSH Director, Cloud Controller, Health Manager, messaging, routers, DEAs and Service providers, and the monitoring components that are defined in the escalation and problem detection plan. | IBM | -|Install and configure security components | Install and configure security components that are tied into the monitoring and escalation plan including IBM QRadar, credential vault, intrusion prevention system, IBM BigFix, and IBM Security Privileged Identity Management. | IBM | -|Install and configure custom components | Install and configure custom components that reside outside the scope of the {{site.data.keyword.Bluemix_notm}} product and services. | Customer | -|Establish initial network configuration | Establish initial network configuration including firewalls, DataPower, Fortigate, and DNS. | IBM | -|Connect {{site.data.keyword.Bluemix_notm}} pipeline | Connect {{site.data.keyword.Bluemix_notm}} continuous integration and continuous delivery pipeline with IBM repositories. | IBM | -|Customize external solution components | Customize load balancers for disaster recovery scenarios. | Customer | -|Install VPN solution | Install bidirectional VPN solution. | IBM | -|Configure login server | Configure the login server for use with the corporate LDAP. | IBM | -|Track status for security, compliance, and audit controls | Track status up to the point where all tools and processes are in place to achieve identified compliance. | Customer | -|Review physical infrastructure | Review physical premises that host the solution components for threats and review of security controls to protect the data center. | Customer | -|Inspect monitoring software | Inspect monitoring and management components as defined in the escalation and problem determination plan. | Customer | -|Inspect OS | Inspect to ensure that the operating system image meets compliance standards. IBM provides access to the OS image. | IBM and customer share responsibility | -{: caption="Table 5. Inception phase tasks" caption-side="top"} - - -Next is the progression phase. The progression phase describes the on-going, collaborative relationship between you and IBM Cloud. The primary goals for this phase include the following: - -- Review capacity and coordinate necessary adjustments. -- Review maintenance and platform improvements. -- Coordinate the activities for problem resolution and root cause analysis. - -| **Task** | **Task details** | **Responsible party** | -|----------|------------------|-----------------------| -|Review weekly capacity reports | Review the weekly capacity reports and take corrective action, if needed. | Customer | -|Create month-to-month projections | Collect information and create a month-to-month projection of capacity and consumption. | IBM and customer share responsibility | -|Review capacity projections | Review the capacity projections as they relate to external events that might impact capacity as well as anticipated new deployments of apps. Work with IBM to review the projections and plan accordingly. | IBM and customer share responsibility | -|Review projections | Review the capacity projections as it relates to external events that might impact capacity. | Customer | -|Adjust capacity | Add or remove capacity as your needs change. | IBM | -|Publish upcoming updates and maintenance | Create documentation for the required maintenance of IBM components. | IBM | -|Perform maintenance | Work with IBM to schedule required maintenance within a 21-day window. You can provide dates that might not work for you in the 21-day window, and IBM works to schedule the maintenance accordingly. | IBM and customer share responsibility | -|Address provisioning failures | Fix provisioning failures, if they occur, for customer-created services that are deployed to the Catalog. | IBM | -|Perform network and IP scans | Perform daily and monthly network and IP scans. | IBM and customer share responsibility | -|Provide access to audit logs | Provide access to all security and administrative audit logs. | IBM and customer share responsibility | -|Conduct testing | Conduct periodic Key Controls over Operations testing and third-party penetration testing. | IBM and customer share responsibility | -|Status reporting, audit coordination, and compliance meetings | Complete status reporting, external audit coordination, and representation at compliance review status meetings. | IBM | -|Employment and business need verification | Complete quarterly employment verification and verification of continued business need for IBM representatives that have access to the customer environment. | IBM | -|Resolution of security vulnerabilities | Resolve reported security vulnerabilities in the platform. | IBM | -{: caption="Table 6. Progression phase tasks" caption-side="top"} - -The final stage of completion represents the end of the relationship between you and IBM {{site.data.keyword.Bluemix_notm}}. The primary tasks for this phase include the following: - -* Ending of the financial agreement -* Removing all network connections -* Recycling infrastructure - - -| **Task** | **Task details** | **Responsible party** | -|----------|------------------|-----------------------| -|End financial agreement | Discuss and agree to an end to the financial agreement contract. | IBM and customer share responsibility | -|Decommission environment | Shut down access to and credentials for the environment. | IBM and customer share responsibility | -|Remove customer network connections | Remove network connections between IBM and the customer environment. | IBM and customer share responsibility | -|Recycle infrastructure | Your environment is recycled based on the {{site.data.keyword.BluSoftlayer}}-defined processes. | IBM | -{: caption="Table 7. Completion phase tasks" caption-side="top"} - -##Maintaining your dedicated instance -{: #maintaindedicated} - -IBM maintains and installs updates and fixes as IBM deems appropriate to the {{site.data.keyword.Bluemix_notm}} runtimes and services. Services might not be available during maintenance windows. In addition, IBM works with you to schedule maintenance updates for the {{site.data.keyword.Bluemix_notm}} platform. - -The following types of maintenance are required for {{site.data.keyword.Bluemix_dedicated_notm}}: -
-
**Standard maintenance for services**
-
The services utilize pre-defined, standard maintenance windows, which might cause the services to be unavailable. IBM does not require customer approval to perform service maintenance, but attempts to minimize impact to your services.
-
-IBM sends broadcast messages of the changes that are planned for each maintenance window on the Status page.
-
-**Important**: Some service might not be available to you during the maintenance period.
- -
**Standard maintenance for the {{site.data.keyword.Bluemix_notm}} platform**
-
Maintenance updates are applied based on coordination between you and IBM within a 21-day window. You provide IBM with preapproved maintenance windows and specific dates or times that might not work for you, and IBM works to schedule updates during or around the dates that you selected. -

-

Go to **ADMINISTRATION > SYSTEM INFORMATION** to view scheduled and pending maintenance updates. For more information about setting your preapproved windows, unavailable dates, and viewing or approving scheduled maintenance updates, see Maintenance updates.

-
- -**Important**: IBM reserves the right to interrupt services to apply emergency maintenance as needed. IBM might change scheduled maintenance hours, but will notify you of any such changes, as well as any emergency maintenance information. - -If there is a reported issue following a maintenance update, you agree with {{site.data.keyword.Bluemix_notm}} Support if it is in your best interest to allow IBM to roll back the update. Upon agreement, IBM rolls back the update to restore the environment to the previous state. - -## Incident response and support for {{site.data.keyword.Bluemix_dedicated_notm}} -{: #incidentresponse} - -### Customer-detected issues - -If you identify an issue that needs attention from IBM support and operations, you can contact support by using a few different methods. For information about how to contact support, see [Contacting support](../support/index.html#contacting-bluemix-support-local). Depending on the issue, you, IBM, or both work together to fix the issue. - -### IBM-detected critical incidents - -Critical incidents are urgent, unexpected service outages, and stability issues that affect your environment or your users. If IBM detects a critical incident within your environment, you are notified by a notification on the **Status** page. You can also check the Status page for any known issues for the platform or your services. For more information about the Status page, see [Viewing status](../admin/index.html#oc_status). - -If you want to integrate your notifications with a web service that supports web hooks, see [Notifications and event subscriptions](../admin/index.html#oc_eventsubscription) for information about how to extend your notification capabilities. - -![Incident response process](../local/images/incidentresponseprocess.png "Incident response process") - -Figure 2. Incident response process - -Depending on the issue, you, IBM, or both of you work together to fix the issue. If you have a question regarding the incident, or if you need an IBM representative to help you resolve the issue, then you can open a support ticket. For information about how to contact support, see [Contacting support](/docs/support/index.html#contacting-bluemix-support-local). - -**Note**: Severity 1 support tickets are monitored 24 hours a day, 7 days a week. Other tickets are processed from Sunday 10:00 pm GMT through Saturday 12:00 am GMT. For more information about severity of support tickets and working with support, see Contacting support. - - -## Disaster recovery for {{site.data.keyword.Bluemix_dedicated_notm}} -{: #dr} - -Disaster recovery for {{site.data.keyword.Bluemix_short}} Dedicated can be set up similarly to the way that it works when you use {{site.data.keyword.Bluemix_short}} Public. {{site.data.keyword.Bluemix_short}} Public provides a continuously available platform for innovation with multiple fail-safe measures to ensure that your orgs, spaces, and apps are always available. Deploying apps to multiple geographic regions enables continuous availability that protects against unplanned, simultaneous loss of multiple hardware or software components, or the loss of an entire data center, so that even in the event of a natural disaster in one geographic location, your distributed {{site.data.keyword.Bluemix_notm}} Public app instances in alternate geographic locations will be available. -{: shortdesc} - -Disaster recovery for {{site.data.keyword.Bluemix_short}} Dedicated is made possible through continuous availability for your apps, the inherent high availability of the platform, and the ability to restore your instance in the event of a failure. You are responsible for enabling continuous availability of your apps by deploying to multiple regions. High availability is built in at the platform level through technologies included in Cloud Foundry and other components. And, you can work together with IBM to ensure your data is properly backed up in the case that you need to restore your instance at any time. - -### Enabling continuous availability for {{site.data.keyword.Bluemix_dedicated_notm}} -{: #enabling} - -By default, {{site.data.keyword.Bluemix_notm}} Public deploys to multiple geographic locations. However, you must do the following to enable globally distributed {{site.data.keyword.Bluemix_dedicated_notm}} instances: - -* Ensure that your developers are deploying apps in more than one region, either through a manual or automated process. Regions should be more than 200 km apart from each other to ensure that a natural disaster cannot affect both geographic locations. -* Configure a global load balancer, like Akamai or Dyn, to point to apps in at least two different regions. - -**Note**: Not all {{site.data.keyword.Bluemix_notm}} services support regional distribution. When you construct an application, if you want to achieve geographic distribution, then you must also make sure that the services that are used by that application have data synchronization as a key feature. - -#### Deploying {{site.data.keyword.Bluemix_dedicated_notm}} apps to multiple geographic locations -{: #deploying} - -To deploy into a second location or multiple locations, you must follow a process similar to the one you took to enable your primary geographic location: - -1. Enable a new dedicated environment to host additional instances of your applications. To create a new environment, contact your IBM sales team to initiate the process. For more information about setting up a dedicated instance, see [Setting up {{site.data.keyword.Bluemix_dedicated_notm}}](/docs/dedicated/index.html#setupdedicated). You must log in separately to access each environment. Each physical location for the hosted environments should be a minimum of 200 km away from the original location to ensure availability. -2. Obtain the unique domain name where your new deployed app will be hosted. For example, if your original domain is *mycompany.caeast.bluemix.net*, then you can create a new local environment with a new domain such as *mycompany.cawest.bluemix.net*, and deploy to the new domain. -3. Each time you deploy your original app, also deploy to the new location. For more information about deploying, see [Uploading your app](/docs/starters/upload_app.html). - - -#### Enabling a global load balancer for {{site.data.keyword.Bluemix_dedicated_notm}} -{: #glb} - -A global load balancer not only ensures continuous availability and is required for disaster recovery, but it also has several additional benefits: - -* Routes users to the closest {{site.data.keyword.Bluemix_notm}} region by default -* Routes based on performance -* Selectively directs a percentage of traffic to a new application version -* Provides site failover based on region health check -* Provides site failover based on application health check -* Uses weighted routing between endpoints - -You can choose a global load balancer such as Akamai or Dyn. For more about using Akamai as a global load balancer, see [Global traffic management ![External link icon](../icons/launch-glyph.svg)](https://www.akamai.com/us/en/solutions/products/web-performance/global-traffic-management.jsp "Opens in new window"){: new_window}. For more about using Dyn as a global load balancer, see [4 Reasons Businesses Are Taking Global Load Balancing to the Cloud ![External link icon](../icons/launch-glyph.svg)](http://dyn.com/blog/4-reasons-businesses-are-taking-global-load-balancing-to-the-cloud/){: new_window}. - -### High availability -{: #ha} - -In addition to enabling continuous availability, {{site.data.keyword.Bluemix_notm}} also provides high availability across the platform by using technologies built into Cloud Foundry and other components. - -These technologies include the following: - -
-
DEA Scalability in Cloud Foundry
-
A Cloud Foundry Droplet Execution Agent (DEA) External link icon performs health checks on the apps running within it. If there is a problem with the app or the DEA itself, it deploys additional instances of the app to an alternate DEA to address the issue. For more information, see Configuring CF for High Availability with Redundancy External link icon. -

To ensure high availability for your applications, you need enough compute resources to balance the load, and you might also require additional compute resources to support a possible failure. If you need to scale your environment by increasing your DEA pool to be prepared for a failure or address a spike in the load for your app instances, you can work with your IBM representative to order additional DEAs and ensure that you have the appropriate hardware to support the added resources. -

-
-
{{site.data.keyword.BluSoftlayer}} redundancy
-
With {{site.data.keyword.BluSoftlayer}} in dedicated environments, data in each cloud storage cluster is written multiple times, and storage clusters are configured with auto-healing capabilities in case of drive failure. If there is a problem with a virtual server, {{site.data.keyword.BluSoftlayer}} tries to restart the virtual server on another host.
-
Metadata backup
-
Metadata is backed up using {{site.data.keyword.BluSoftlayer}} EVault Backup to a location that is a minimum of 200 km away.
-
- -##Restoring your dedicated instance -{: #restorededicated} - -{{site.data.keyword.Bluemix_dedicated_notm}} settings, metadata, and configurations are backed up regularly to prepare for any unplanned outages in the environment. Your data that you are responsible for backing up includes application data, cloud database services data, and object stores. - -As part of the data backup, which includes system metadata and configurations, IBM completes the following tasks: - -
    -
  • Encrypts all backup copies and manages encryption keys
    • -
  • Monitors and manages backup activity
    • -
  • Provides the encrypted backup files
    • -
  • Restores the requested data
    • -
  • Manages scheduling conflicts between backup and fix management operations
    • -
- -Because protection of private data is critical, IBM needs your collaboration when dealing with backup file management, so that the files are not moved outside of your data centers. Specifically, IBM asks that you complete the following tasks: - -
    -
  • Move a copy of your encrypted backup data off-site, just as you would for any other backup data that you manage.
    • -
  • Provide the backup files for the IBM operator in case of any need to restore.
    • -
- -# rellinks -{: rellinks} -## general -{: general} -* [Discover: {{site.data.keyword.Bluemix_dedicated_notm}}](http://www.ibm.com/cloud-computing/bluemix/hybrid/dedicated/) -* [What's new in {{site.data.keyword.Bluemix_notm}}](/docs/whatsnew/index.html) -* [{{site.data.keyword.Bluemix_notm}} glossary](/docs/overview/glossary/index.html) -* [Managing {{site.data.keyword.Bluemix_notm}} Local and {{site.data.keyword.Bluemix_dedicated_notm}}](/docs/admin/index.html#mng) -* [Contacting support](/docs/support/index.html#getting-customer-support) +--- + + + +copyright: + + years: 2015, 2017 + +lastupdated: "2017-01-11" + +--- + +{:shortdesc: .shortdesc} + +# {{site.data.keyword.Bluemix_dedicated_notm}} +{: #dedicated} + + +{{site.data.keyword.Bluemix}} is an open-standards, cloud-based platform for building, running, and managing applications. With {{site.data.keyword.Bluemix_dedicated_notm}}, you get the power and simplicity of {{site.data.keyword.Bluemix_notm}}—in your own dedicated SoftLayer environment that is securely connected to both the {{site.data.keyword.Bluemix_notm}} Public environment and your own network. +{:shortdesc} + +All dedicated deployments of {{site.data.keyword.Bluemix_notm}} include the following benefits and features at no additional cost: VPN, private virtual local area network (VLAN), firewall, connectivity with your LDAP, ability to leverage existing on-premises databases and apps, 24/7 on-site security, dedicated hardware, and standard support. + +By default, access to your private {{site.data.keyword.Bluemix_notm}} instance is only accessible from your corporate network. If you need the {{site.data.keyword.Bluemix_notm}} environment to be accessible directly from the internet, a mobile device, or a dedicated database, for example, then an additional network security component is required at additional cost. + +{{site.data.keyword.Bluemix_dedicated_notm}} comes with all included {{site.data.keyword.Bluemix_notm}} runtimes and 64 GB of compute resources memory. + +In addition, there is a set of services and components that are included or optional for purchase. Review the following table to see what is included and what you can purchase optionally. + +| **Type** | **Name** | **Description** | +|-----------------|-------------------|-------------------| +|Included | [{{site.data.keyword.Bluemix_notm}} runtimes](/docs/cfapps/runtimes.html) | Use runtimes to get your app up and running quickly, with no need to set up and manage machines and operating systems. All {{site.data.keyword.Bluemix_notm}} runtimes are available for you to use in your {{site.data.keyword.Bluemix_dedicated_notm}} instance.| +| Included | [{{site.data.keyword.autoscaling}}](/docs/services/Auto-Scaling/index.html) | Dynamically increase or decrease the compute capacity of your application based on policies. With this service, you have unlimited use in your {{site.data.keyword.Bluemix_dedicated_notm}} environment. Note: Auto-scaling currently only works with Cloud Foundry runtimes | +|Optional | [{{site.data.keyword.apiconnect_short}}](/docs/services/apiconnect/index.html) | {{site.data.keyword.apiconnect_long}} integrates {{site.data.keyword.APIM}} and IBM StrongLoop into a single offering that provides a comprehensive solution to create, run, manage, and enforce APIs and microservices. | +|Optional | [{{site.data.keyword.rules_short}}](/docs/services/rules/rules.html) | {{site.data.keyword.rules_short}} offers a comprehensive environment to automate and execute frequently occurring, repeatable rules-based business decisions. It also enables business users or developers to quickly model decisions and test them at lower costs by reducing the need for IT skills. | +|Optional | [{{site.data.keyword.cloudant}}](/docs/services/Cloudant/index.html#Cloudant) | {{site.data.keyword.cloudant}} provides access to a fully managed NoSQL JSON data layer that's always on. This service is compatible with CouchDB, and accessible through a simple to use HTTP interface for mobile and web application models. | +|Optional | [{{site.data.keyword.containershort}}](/docs/containers/container_index.html) | Run Docker containers on {{site.data.keyword.Bluemix_dedicated_notm}}. Containers are virtual software objects that include all of the elements that an app needs to run. A container has the benefits of resource isolation and allocation, but is more portable and efficient than, for example, a virtual machine. For information about the hardware requirements, see [IBM {{site.data.keyword.containershort}} in {{site.data.keyword.Bluemix_dedicated_notm}} and Bluemix Local](/docs/containers/container_dl.html).| +| Optional | [{{site.data.keyword.contdelivery_short}}](/docs/services/ContinuousDelivery/index.html) | Use {{site.data.keyword.contdelivery_short}} Dedicated to automate builds, unit tests, deployments, and more. Edit and push code through the rich web based IDE. Create toolchains to enable tool integrations that support development, deployment, and operations tasks. | +| Optional | [{{site.data.keyword.dashdbshort}}](/docs/services/dashDB/dashDB.html) | IBM {{site.data.keyword.dashdbshort}} for Analytics is a fully managed SQL cloud database service, optimized for data warehouse and analytics workloads. IBM {{site.data.keyword.dashdbshort}} for Transactions is a fully managed SQL cloud database service, optimized for general purpose, web apps, and transactional workloads. | +| Optional | [{{site.data.keyword.datacshort}}](/docs/services/DataCache/index.html#data_cache) | This service provides an in-memory data grid that supports distributed caching scenarios for your apps. Includes 50 GB of in-memory Cache. | +| Optional | [Dedicated GitHub Enterprise](/docs/services/ghededicated/index.html) | {{site.data.keyword.ghe_long}} is the IBM Cloud-hosted and fully managed version of GitHub Enterprise that provides the social experience that developers love. This service is currently available exclusively to {{site.data.keyword.Bluemix_dedicated_notm}} environments. | +| Optional (Beta) | [Logging](/docs/monitoringandlogging/cfapps_ml_logs_dedicated_ov.html#container_ml_logs_dedicated_ov) | Provides logs for your Cloud Foundry apps in your {{site.data.keyword.Bluemix_notm}} user interface and searchable logs and dashboards in Kibana. | +| Optional | [{{site.data.keyword.messagehub}}](/docs/services/MessageHub/index.html#messagehub) | {{site.data.keyword.messagehub}} is a scalable, distributed, high throughput message bus to unite your on-premises and off-premises technologies. {{site.data.keyword.messagehub}} is based on Apache Kafka, which is a fast, scalable, and durable real-time messaging engine. | +|Optional | [{{site.data.keyword.mobilepush}}](/docs/services/mobilepush/index.html) | {{site.data.keyword.mobilepush}} is a service that you can use to send notifications to iOS and Android device. Notifications can be targeted to all application users or to a specific set of users and devices using tags. You can administer devices, tags, and subscriptions. You can also use an SDK (software development kit) and Representational State Transfer (REST) application program interface (APIs) to further develop your client applications.| +|Optional | [{{site.data.keyword.SecureGateway}}](/docs/services/SecureGateway/secure_gateway.html) | The {{site.data.keyword.SecureGateway}} service provides a secure way to connect {{site.data.keyword.Bluemix_notm}} applications to remote locations on-premises or in the cloud. | +|Optional | [{{site.data.keyword.sescashort}}](/docs/services/SessionCache/index.html#session_cache) | For increased redundancy, {{site.data.keyword.sescashort}} provides a replica of a session stored in the cache. Therefore, in the event of a brownout or outage, your client application maintains access to the session in the cache. The service supports session caching scenarios for web and mobile applications. | +| Optional | [{{site.data.keyword.iot_short}}](/docs/services/IoT/index.html) | This service lets your apps communicate with and consume data collected by your connected devices, sensors and gateways. The base offering permits running a private version of the {{site.data.keyword.iot_short}} within the dedicated environment with a capacity of 100,000 concurrently connected devices or applications and 1.6 TB of data exchange. | +| Optional | [{{site.data.keyword.appserver_short}}](/docs/services/ApplicationServeronCloud/index.html) | IBM {{site.data.keyword.appserver_short}} for IBM {{site.data.keyword.Bluemix_notm}} is a service that facilitates quick setup on a pre-configured {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment, or Traditional WebSphere Java EE instance in a hosted cloud environment on {{site.data.keyword.Bluemix_notm}}. | +{: caption="Table 1. Dedicated Services" caption-side="top"} +{: #table01} + + + +There are optional components that are available for you to purchase to scale and extend the capacity of your resources and services. You can purchase any of these components by contacting the sales team; go to [Contact us](https://console.ng.bluemix.net/?direct=classic/#/contactUs/cloudOEPaneId=contactUs) for information about contacting a sales representative. To increase your plan for a service, you can select the plan from the service tile in your catalog. + +| **Name** | **Description** | +|-------------------|-------------------| +|Dedicated {{site.data.keyword.apiconnect_short}} Professional 5 Million API Calls | An environment that permits running a private version of {{site.data.keyword.apiconnect_short}} within the dedicated environment with a capacity of 5 million API Calls a month targeted towards departmental API projects. | +|Dedicated {{site.data.keyword.apiconnect_short}} Professional 100 thousand API Calls increase | An extension of the {{site.data.keyword.apiconnect_short}} Professional environment to provide additional capacity of 100 thousand API Calls a month. | +|Dedicated {{site.data.keyword.apiconnect_short}} Enterprise 25 Million API Calls | An environment that permits running a private version of {{site.data.keyword.apiconnect_short}} within the dedicated environment with a capacity of 25 million API Calls a month targeted towards enterprise wide API projects. | +|Dedicated {{site.data.keyword.apiconnect_short}} Enterprise 100 thousand API Calls increase | An extension of the {{site.data.keyword.apiconnect_short}} Enterprise environment to provide additional capacity of 100 thousand API Calls a month. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.rules_short}} 1 Million Rules Decisions | A Rules Decision is the outcome of invoking a ruleset from a rule execution server. Sufficient entitlements must be obtained to cover the total number of Rules Decisions, rounded up to the nearest Million, executed or processed, during the billing period. The Rules Decisions measured by this Cloud Service are the calls made to the rule execution server to get a decision. Dedicated deployments of the Cloud Service have an agreed capacity measured by the relevant charge metric. The {{site.data.keyword.rules_short}} service default space allocation on the {{site.data.keyword.Bluemix_dedicated_notm}} platform is 16 GB, from which up to ten instances of 1 GB each can be invoked to execute entitled Rules Decisions. If you exceed that usage limitation, you must purchase additional capacity to cover that usage. | +|Dedicated {{site.data.keyword.cloudant}} 1.6 TB capacity increase | Includes running a private version of the {{site.data.keyword.cloudantfull}} within the dedicated environment with a design capacity of 1.6 terabytes. | +|Dedicated {{site.data.keyword.datacshort}} and {{site.data.keyword.sescashort}} 50 GB capacity increase | An environment that permits deploying and running {{site.data.keyword.datacshort}} and {{site.data.keyword.sescashort}} instances up to a cumulative capacity of 50 GB. | +|{{site.data.keyword.contdelivery_short}} Dedicated Instance | A private version of {{site.data.keyword.contdelivery_short}} running within a dedicated environment. The capacity is determined by {{site.data.keyword.contdelivery_short}} Dedicated Authorized User entitlements. | +|{{site.data.keyword.contdelivery_short}} Dedicated Authorized User | Grants an Authorized User access to and for the use of a designated {{site.data.keyword.contdelivery_short}} Dedicated environment. Every user belonging to a {{site.data.keyword.Bluemix_notm}} Organization containing a {{site.data.keyword.contdelivery_short}} service instance must be authorized. | +|Dedicated {{site.data.keyword.dashdbshort}} Enterprise 64.1 | One database per service instance on a dedicated server with 64 GB RAM, 16 vCPUs. Recommended for up to 1 TB of pre-load data, based on typical compression. | +|Dedicated {{site.data.keyword.dashdbshort}} Enterprise 256.4 | One database per service instance on a dedicated bare metal server with 256 GB RAM, 32 cores. Recommended for up to 4 TB of pre-load data, based on typical compression. | +|Dedicated {{site.data.keyword.dashdbshort}} Enterprise 256.12 | One database per service instance on a dedicated bare metal server with 256 GB RAM, 32 Cores. Recommended for up to 12 TB of pre-load data, based on typical compression. This is a storage dense plan suitable for environments where data volumes are higher and queries do not need to run at in-memory speeds. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions 2.8.500 | Dedicated instance supporting Online Transaction Processing (OLTP) workloads with 8GB RAM and 500 GB of space for data and logs. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions 12.128.1400 | Dedicated instance supporting Online Transaction Processing (OLTP) workloads with 128GB RAM and 1.4 TB SSD storage for data and logs. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions High Availability 2.8.500 | Dedicated instance supporting Online Transaction Processing (OLTP) workloads with 8GB RAM and 500 GB of space for data and logs, and it includes an additional Standby server for high availability. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions High Availability 12.128.1400 | Dedicated instance supporting Online Transaction Processing (OLTP) workloads with 128GB RAM and 1.4 TB SSD storage for data and logs, and it includes an additional Standby server for high availability. | +|{{site.data.keyword.Bluemix_dedicated_notm}} community services | An environment that permits deploying and running community services up to a total of 50 instances for each community service. | +|{{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.cloudant}} Cluster Instance | This optional component includes a 3-node cluster for which you are responsible for providing the infrastructure, and the storage and compute capacity can be determined based on your specific needs. {{site.data.keyword.cloudant}} provides access to a fully managed NoSQL JSON data layer that's always on. This service is compatible with CouchDB, and accessible through a simple to use HTTP interface for mobile and web application models. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.messagehub}} | An environment that provides publish and subscribe messaging of up to 10 GB per partition. Messages are retained and available for consumption for a maximum of 24 hours. | +|IBM Bluemix Dedicated {{site.data.keyword.mobilepushshort}} | An environment that permits deployment and execution of {{site.data.keyword.mobilepushshort}} instances with ability to accept 300 requests per second. | +|{{site.data.keyword.iot_short}} Dedicated incremental increase | An environment increase that permits running a private version of the {{site.data.keyword.iot_short}} within the dedicated environment with a capacity of 100,000 concurrently connected devices or applications and 0.5 TB of data exchange. | +|IBM {{site.data.keyword.appserver_short}} for {{site.data.keyword.Bluemix_notm}} - Dedicated Small| A pre-configured {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment, or Traditional WebSphere Java EE instance in a hosted cloud environment on {{site.data.keyword.Bluemix_notm}} with 64 vCores, 128GB RAM and 1TB HDD per month. | +|IBM {{site.data.keyword.appserver_short}} for {{site.data.keyword.Bluemix_notm}} - Dedicated Medium| A pre-configured {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment, or Traditional WebSphere Java EE instance in a hosted cloud environment on {{site.data.keyword.Bluemix_notm}} with 128 vCores, 256GB RAM and 2TB HDD per month. | +|IBM {{site.data.keyword.appserver_short}} for {{site.data.keyword.Bluemix_notm}} - Dedicated Large| A pre-configured {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment, or Traditional WebSphere Java EE instance in a hosted cloud environment on {{site.data.keyword.Bluemix_notm}} with 256 vCores, 512GB RAM and 4TB HDD per month. | +|IBM {{site.data.keyword.appserver_short}} for {{site.data.keyword.Bluemix_notm}} - Dedicated| A pre-configured {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment, or Traditional WebSphere Java EE instance in a hosted cloud environment on {{site.data.keyword.Bluemix_notm}} with HDD Expansion and 1TB per month. | +{: caption="Table 2. Optional service components for purchase" caption-side="top"} +{: #table02} + + + +| **Name** | **Description** | +|-------------------|-------------------| +|Dedicated runtimes 16 GB capacity increase | An extension of the runtimes environment to provide an extra 16 GB of runtime capacity. | +|Dedicated Direct Link 1 Gbps capacity | A dedicated network link that connects directly to the appropriate {{site.data.keyword.BluSoftlayer}} network point of presence designed for data transfers of up to 1 Gbps. | +|Dedicated Direct Link 10 Gbps capacity | A dedicated network link that connects directly to the appropriate {{site.data.keyword.BluSoftlayer}} network point of presence designed for data transfers of up to 10 Gbps. | +|IBM Bluemix Dedicated Hardware Firewall - High Availability | A redundant 1 Gbps hardware firewall configured for protection for single, multiple, or all servers on same VLAN within the Dedicated environment. | +{: caption="Table 3. Optional platform add-on components for purchase" caption-side="top"} +{: #table03} + +**Note**: {{site.data.keyword.Bluemix_dedicated_notm}} components might indicate a specific configured capacity, such as gigabytes or transactions per second. Because actual capacity in practice for any configuration of the cloud service varies depending on many factors, the actual capacity in practice might be more or less than the configured capacity. + +### Syndicated catalog +{: #catalogdedicated} + +{{site.data.keyword.Bluemix_dedicated_notm}} includes a private catalog that brings together approved services across your public, dedicated and local deployments. You can even publish and manage access to your own services through the {{site.data.keyword.Bluemix_notm}} catalog. You have the option to decide which public services meet the requirements for your business based on your data privacy and security criteria. + +If you have a private instance of the service for your dedicated environment, you see a "Dedicated" tag with the service names in your catalog. Similarly, if it is a custom service, meaning you used a service broker to create it, you see "Custom" listed with the service name. All other services listed that do not have a "dedicated" or "custom" tag are available by using syndication from {{site.data.keyword.Bluemix_notm}} Public. Syndicated services provide the function to create hybrid applications that consist of public and private services. + +|Service |Available in US South region |Available in Europe United Kingdom region |Available in Australian Sydney region| +|:----------|:------------------------------|:------------------|:------------------| +|{{site.data.keyword.alchemyapishort}} |Yes |Yes |Yes| +|{{site.data.keyword.alertnotificationshort}} |Yes |Yes |Yes | +|{{site.data.keyword.apiconnect_short}} |Yes |Yes |Yes | +|{{site.data.keyword.appseccloudshort}} |Yes |Yes |Yes | +|{{site.data.keyword.apiconnect_short}} |Yes |Yes |Yes | +|Automated Accessibility Checker |Yes |Yes |Yes | +|{{site.data.keyword.rules_short}} |Yes |Yes |Yes | +|{{site.data.keyword.cloudant}} |Yes |Yes |Yes | +|{{site.data.keyword.iotmapinsights_short}} |Yes |Yes |Yes | +|{{site.data.keyword.conversationshort}} |Yes |Yes |Yes | +|{{site.data.keyword.dashdbshort}} |Yes |Yes |Yes | +|{{site.data.keyword.dataworks_short}} |Yes |Yes |No| +|{{site.data.keyword.DB2OnCloud_short}} |Yes |Yes |Yes | +|Digital Content Checker |Yes |Yes |Yes | +|{{site.data.keyword.documentconversionshort}} |Yes |Yes |Yes| +|{{site.data.keyword.iotdriverinsights_short}} |Yes |Yes |Yes | +|{{site.data.keyword.geospatialshort_Geospatial}} |Yes |Yes |Yes | +|{{site.data.keyword.GlobalizationPipeline_short}} |Yes | Yes | Yes | +|{{site.data.keyword.identitymixershort}} |Yes |Yes |Yes| +|{{site.data.keyword.iot4auto_short}} |Yes |Yes |Yes | +|{{site.data.keyword.iotelectronics}} |Yes |Yes |No | +|{{site.data.keyword.iotinsurance_short}} |No |No |Yes | +|{{site.data.keyword.twittershort}} |Yes |Yes |Yes| +|{{site.data.keyword.languagetranslationshort}} |Yes |Yes |Yes | +|{{site.data.keyword.languagetranslatorshort}} |Yes |Yes |Yes | +|{{site.data.keyword.dwl_short}} |Yes |Yes |No | +|{{site.data.keyword.eventhubshort}} |Yes |No |No| +|{{site.data.keyword.messagehub}} |Yes |Yes |No| +|{{site.data.keyword.manda}} |Yes |Yes |Yes | +|{{site.data.keyword.amashort}} |Yes |Yes |Yes | +|{{site.data.keyword.mqa}} |Yes |Yes |Yes | +|{{site.data.keyword.mql}} |No |No |Yes | +|{{site.data.keyword.nlclassifierlshort}} |Yes |Yes |Yes| +|{{site.data.keyword.personalityinsightsshort}} |Yes |Yes |Yes| +|{{site.data.keyword.pm_short}} |Yes |Yes |No | +|{{site.data.keyword.mobilepush}} |Yes |Yes |Yes | +|{{site.data.keyword.retrieveandrankshort}} |Yes |Yes |Yes| +|{{site.data.keyword.runbook_short}} |Yes |Yes |Yes| +|{{site.data.keyword.SecureGateway}} |Yes |Yes |Yes | +|{{site.data.keyword.ssofull}} |Yes |No |No| +|{{site.data.keyword.speechtotextshort}} |Yes |Yes |Yes| +|{{site.data.keyword.streaminganalyticsshort}} |Yes |Yes |Yes | +|{{site.data.keyword.texttospeechshort}} |Yes |Yes |Yes| +|{{site.data.keyword.toneanalyzershort}} |Yes |Yes |Yes| +|{{site.data.keyword.tradeoffanalyticsshort}} |Yes |Yes |Yes| +|{{site.data.keyword.visualrecognitionshort}} |Yes |Yes |Yes| +|{{site.data.keyword.iot_short}} |Yes |Yes |No| +|{{site.data.keyword.weather_short}} |Yes |Yes |Yes| +|{{site.data.keyword.workloadscheduler}} |Yes |Yes |Yes | +{: caption="Table 4. Services available for syndication from {{site.data.keyword.Bluemix_notm}} Public by region" caption-side="top"} +{: #table04} + +**Note**: Third-party services are not included in the table. Check your dedicated catalog for third-party service options. + + + +## {{site.data.keyword.Bluemix_dedicated_notm}} architecture +{: #dedicatedarch} + +{{site.data.keyword.Bluemix_dedicated_notm}} can be deployed in any [{{site.data.keyword.IBM_notm}} SoftLayer data center ![External link icon](../icons/launch-glyph.svg)](http://www.softlayer.com/data-centers){: new_window} around the world. {{site.data.keyword.IBM_notm}} SoftLayer provides the highest performing cloud infrastructure. Each data center has 24 hour, 7 days a week security, and rigorous controls. + +Each {{site.data.keyword.Bluemix_dedicated_notm}} deployment is dedicated to a single enterprise on {{site.data.keyword.IBM_notm}} SoftLayer dedicated hardware in it's own private network. {{site.data.keyword.Bluemix_dedicated_notm}} environments have the same security standards as the public {{site.data.keyword.Bluemix_notm}} in terms of infrastructure, operational, and physical security. However, developer access to the dedicated {{site.data.keyword.Bluemix_notm}} is controlled by your LDAP policies, which can be configured by the {{site.data.keyword.Bluemix_notm}} team when they set up your environment. Within the dedicated environment, you can manage user roles and permissions. See [Managing users and permissions](/docs/admin/index.html#oc_useradmin) for details. The following figure depicts the logical architecture of a default {{site.data.keyword.Bluemix_dedicated_notm}} deployment. + +![{{site.data.keyword.Bluemix_dedicated_notm}}](images/bm_dedicated_arch.png "{{site.data.keyword.Bluemix_dedicated_notm}} default architecture") + +Figure 1. Detailed {{site.data.keyword.Bluemix_dedicated_notm}} diagram default architecture +{: #figure01} + +The significant architectureal components depicted in the previous architecture diagram include the following: + +
+
{{site.data.keyword.IBM_notm}} Cloud
+
+The {{site.data.keyword.IBM_notm}} Cloud environment as a whole includes the following significant networking environments: +
    +
  • {{site.data.keyword.Bluemix_dedicated_notm}}
    • +
  • {{site.data.keyword.Bluemix_notm}} Public
    • +
  • {{site.data.keyword.IBM_notm}} Operations
    • +
+
+
{{site.data.keyword.Bluemix_dedicated_notm}}
+
+At a minimum, this contains the Cloud Foundry components and some dedicated application services. {{site.data.keyword.Bluemix_notm}} provides both Cloud Foundry and {{site.data.keyword.containerlong}}-based compute environments. An enterprise might have one or both of these compute environments configured.
+An enterprise might add additional dedicated application services.
+Please refer to [table 2](#table02) for additional services and compute capabilities that may be added. +
+
{{site.data.keyword.Bluemix_notm}} Public
+
+An {{site.data.keyword.Bluemix_dedicated_notm}} might include an outbound connection to an {{site.data.keyword.Bluemix_notm}} Public region. This provides syndication of public services onto the dedicated catalog. {{site.data.keyword.Bluemix_notm}} Public service syndication provides a convenient method for developers to build applications hosted on their enterprise's {{site.data.keyword.Bluemix_dedicated_notm}} and accessing services running in {{site.data.keyword.Bluemix_notm}} Public. The list of services that can be syndicated from {{site.data.keyword.Bluemix_notm}} Public shown on [table 4 of the Syndicated catalog section](#catalogdedicated). +
+
{{site.data.keyword.IBM_notm}} Operations
+
+{{site.data.keyword.IBM_notm}} manages, monitors, and maintains the dedicated platform and dedicated services so you can focus on building innovative applications. The {{site.data.keyword.IBM_notm}} Operations Support Services (OSS) team performs operations by using a VPN tunnel connection from {{site.data.keyword.IBM_notm}}'s Operations network. +
+
Enterprise
+
+The enterprise network environment may have a secured private bi-directional network link to {{site.data.keyword.Bluemix_dedicated_notm}}. This allows applications hosted in {{site.data.keyword.Bluemix_dedicated_notm}} to access services and resources in the enterprise, including data sources and enterprise services. This network link also allows {{site.data.keyword.Bluemix_dedicated_notm}} to use your LDAP for authentication of your enterprise's developers and administrators.
+
+There are several options for creating the secured private network link. Talk to your IBM technical specialist about the best networking option for your enterprise.
+
+The default connection from {{site.data.keyword.Bluemix_dedicated_notm}} to your enterprise network uses a Virtual Private Network (VPN). {{site.data.keyword.Bluemix_dedicated_notm}} has a Dedicated 1 Gbps Vyatta VPN termination configured for high availability. +
+In the default architecture for {{site.data.keyword.Bluemix_dedicated_notm}} as shown in [figure 1](#figure01), there is no inbound network traffic directly from the Internet. If your enterprise wishes to allow Internet access to applications hosted on {{site.data.keyword.Bluemix_dedicated_notm}}, the access must be configured through your Enterprise network. +
+
+ + +## Setting up {{site.data.keyword.Bluemix_dedicated_notm}} +{: #setupdedicated} + +{{site.data.keyword.Bluemix_dedicated_notm}} is designed to provide a private version of the {{site.data.keyword.Bluemix_notm}} Public offering. You can use {{site.data.keyword.Bluemix_notm}} services and runtimes to support your computing needs in an IBM-hosted {{site.data.keyword.BluSoftlayer}} account. + +IBM provides you access to {{site.data.keyword.Bluemix_dedicated_notm}} by using a password-secured login. You can access the services, runtimes, and associated resources, and deploy and remove {{site.data.keyword.Bluemix_notm}} apps. IBM takes advantage of multiple {{site.data.keyword.BluSoftlayer}} locations to deliver {{site.data.keyword.Bluemix_dedicated_notm}}, so you can get your private version in a location close to you. + +To set up your private version of {{site.data.keyword.Bluemix_notm}}: + +
    +
  1. Contact your IBM designated account representative or contact {{site.data.keyword.Bluemix_notm}} External link icon to get started.
    2. +
  2. Work with IBM on your fee for your {{site.data.keyword.Bluemix_dedicated_notm}} instance. The monthly recurring fee is based on the dedicated services that you want to use, plus a subscription to all {{site.data.keyword.Bluemix_notm}} public services. You then receive an invoice for anything that you use beyond that subscription agreement.
    3. +
  3. Identify the deadlines for each phase of setting up your {{site.data.keyword.Bluemix_dedicated_notm}} instance. For information about each phase and the tasks involved, see {{site.data.keyword.Bluemix_dedicated_notm}} roles and responsibilities.
    4. +
  4. You select the {{site.data.keyword.BluSoftlayer}} data center location External link icon for your dedicated instance. Then, your dedicated platform and account are created. For your account, you identify the people in your organization for the roles that are needed to get your dedicated instance up and running. For information about the roles that you assign, see {{site.data.keyword.Bluemix_dedicated_notm}} roles and responsibilities. +
    5. +
  5. Define and establish network connectivity between your corporate network and your {{site.data.keyword.Bluemix_dedicated_notm}} instance. There is a mandatory network security appliance that includes firewall and intrusion prevention capabilities with an associated cost for this option. +
      +
    1. IBM installs monitoring and security infrastructure for the dedicated instance.
      2. +
    2. IBM installs the single-tenant dedicated services that you selected.
      3. +
    3. You provide network configuration and endpoints for things such as IP addresses or firewalls and access to your LDAP for integration into {{site.data.keyword.Bluemix_notm}}.
      4. +
    +
    6. +
  6. Identify and assign roles for your administrative team for the environment. +
      +
    1. IBM configures network access and LDAP based on what you provided. Administrative access is given to the contacts that you designate. You must also designate a contact for support and billing.
      2. +
    2. IBM sets up a syndicated catalog in your dedicated environment to show your dedicated services. The syndicated catalog includes additional services that are syndicated from and available for you to use from {{site.data.keyword.Bluemix_notm}} Public. You have the option to decide which public services meet the requirements for your business based on your data privacy and security criteria.
      3. +
    3. You validate network and firewall configuration and the LDAP endpoint and access.
      4. +
    +
    7. +
+ +You can expect a process similar to the following list for the initial deployment and configuration for your environment. For details about who is responsible for each task, see [Roles and responsibilities](index.html#rolesresponsibilities). + +
    +
  1. You select which data center to use to host your dedicated instance. For information about data center options, see {{site.data.keyword.BluSoftlayer}} data center location External link icon.
    2. +
  2. You specify the domain names for the deployment, and the IDs that you want to use. You get three domains when you set up your {{site.data.keyword.Bluemix_notm}} instance. You pick the prefix for the *mycompany*.*region*.bluemix.net and *mycompany*.*region*.mybluemix.net. And, you choose the full name for the third domain.
    +

    You can choose as many custom domains as you want. However, you are responsible for the certificates for the custom domains. For information about creating your custom domain, see Creating and using a custom domain.

    3. +
  3. You identify an owner for the public account that is used to represent your company in {{site.data.keyword.Bluemix_notm}} Public. IBM uses this account for tracking syndicated services usage.
    4. +
  4. You select the type of secure connection to your data center. You can select from {{site.data.keyword.Bluemix_notm}} VPN, {{site.data.keyword.Bluemix_notm}} Direct Link, and AT&T Net Bond.
    5. +
  5. You decide whether there will be any access to your dedicated environment from the public Internet.
    6. +
  6. You select the type of authentication that will be used. You can select from IBMid or Active Directory. For information about using and registering for an IBMid, see the Help and FAQ page. +
    7. +
  7. You identify and assign roles for your administrative team for the environment. For information about the roles that you must assign, see {{site.data.keyword.Bluemix_dedicated_notm}} roles and responsibilities.
    8. +
  8. IBM deploys the core platform that includes the elastic runtimes, console, administration feature, and monitoring.
    9. +
  9. IBM configures your administrative access to the environment.
    10. +
  10. You can start using your dedicated instance that is monitored by the IBM operations team in order to respond to alerts.
    11. +
+ +After your {{site.data.keyword.Bluemix_notm}} instance is set up, you can monitor and manage your {{site.data.keyword.Bluemix_notm}} instance by using the Administration page. For more information, see [Managing {{site.data.keyword.Bluemix_notm}} Local and Dedicated](../admin/index.html#mng). For information about upgrades and maintenance, see [Maintaining your dedicated instance](index.html#maintaindedicated). + +##Roles and responsibilities +{: #rolesresponsibilities} + +If you set up a {{site.data.keyword.Bluemix_dedicated_notm}} account, you identify the people in your organization for the roles that are needed to get your instance up and running. + +###Roles + +The following list shows the customer roles and responsibilities that you assign: + +
+
**Procurement focal**
+
Works with the IBM representative on establishing your {{site.data.keyword.Bluemix_dedicated_notm}} environment, including identifying the right people in your organization to work on any aspect of the project. The person assigned to this role takes on a project management role and oversees pattern selection, commercial arrangements, and arrangement of access to customer resources. The procurement focal is the overall contact for setting up the dedicated instance and tracking the process of the deployment.
+
**Compliance officer**
+
Works with the IBM representative to select a topology and deployment option that meets your security requirements. The person assigned to this role works with the IBM compliance consultant to determine which deployment patterns achieve the compliance goals.
+
**Network specialist**
+
Works with the IBM representative on the network plans for the {{site.data.keyword.Bluemix_notm}} deployment. The person assigned to this role reviews the required networking specifications required by IBM and works together with IBM on an implementation plan. At the end of the installation and verification phase, the person assigned to this role approves that the network configuration is in compliance with corporate standards.
+
**DevOps focal**
+
Works with the IBM representative to plan and apply the maintenance updates that are needed for the {{site.data.keyword.Bluemix_notm}} platform, services, and runtimes. The person assigned to this role also works with the IBM representative on the configuration of your {{site.data.keyword.Bluemix_dedicated_notm}} instance.
+
Operations focal
+
Works with the IBM support team as needed once the environment is up and running. This is someone with Superuser access to the Administration console who can approve and schedule maintenance updates for the Bluemix environment and be available at all times in the event of a critical incident. The person assigned to this role must have technical knowledge of the Bluemix environment and be in a position to reach others within company that have expert skills in an area that might be affected including networking or security, for example.
+
+ +Your customer representatives work with IBM specialists that work together to ensure that you always have the support that you need. You can upgrade to the Premium support tier to work with a dedicated Client Success Manager (CSM) for your account. For more information about the different support tiers, see [Contacting support](../support/index.html#contacting-support).The CSM completes the following types of tasks: + +
    +
  • Enables rapid adoption of your {{site.data.keyword.Bluemix_dedicated_notm}} environment.
    • +
  • Delivers valuable education and enablement materials to improve your self-sufficiency.
    • +
  • Cultivates a long-term relationship between you and {{site.data.keyword.Bluemix_notm}} development, support, and services that you use.
    • +
+ +The {{site.data.keyword.Bluemix_notm}} support and operations team that works with you on your {{site.data.keyword.Bluemix_notm}} instance might access your local environment, but does so only for the following reasons. + +
    +
  • To respond to alerts and perform operational maintenance
    • +
  • To attempt to reproduce a problem that is reported on a support ticket
    • +
+ +### Responsibilities + +From setting up your environment to continued maintenance, a variety of tasks must be completed. The following table outlines the required tasks and the owner for completing the task throughout the inception, progression, and completion phases. + +The inception phase is used to establish the {{site.data.keyword.Bluemix_dedicated_notm}} environment. The primary goals of this phase include the following: + +- Review the financial agreement, and establish the milestone dates for delivery. +- Create the {{site.data.keyword.Bluemix_notm}} platform, and provide access to runtimes and services. +- Define and establish network connectivity between your corporate network and {{site.data.keyword.Bluemix_notm}} operations. +- Identify and assign roles for your administrative team. + +| **Task** | **Task details** | **Responsible party** | +|----------|------------------|-----------------------| +|Set compliance standards | Identify government, industry, and proprietary corporate standards that are required for the environment. | Customer | +|Create security and compliance integration plan | Create security and integration plan that includes costs, scheduling, and resources that are required to achieve security compliance. | IBM | +|Compliance plan approval | Approve the compliance plan. | Customer | +|Create sizing for environment | Create environment sizing based on predefined choices that take into consideration the high availability and disaster recovery goals, as well as initial DEA and service provisioning that is necessary to support the apps created with the platform. You and IBM work together to define, for example, what databases are needed, what services are offered in the customer's syndicated catalog, and more. | IBM and customer share responsibility | +|Select architecture | Select architecture based on predefined choices that take into account high availability and disaster recovery requirements. | IBM | +|Define disaster recovery goals | Define the disaster recovery requirements for the environment. | Customer | +|Create disaster recovery plan | Consult and define the disaster recovery plan. IBM creates a disaster recovery model, and consults with you where you provide feedback and approve the plan. | IBM and customer share responsibility | +|Create backup and recovery plan | Create a backup and recovery plan that defines the frequency and the requirements for on-and-off site distribution of the backup. IBM backs up fabric components, IBM services, service metadata including user roles, and more. You back up any application-specific data that you are responsible for. | IBM and customer share responsibility | +|Identify tools for event detection and problem determination | Identify IBM and third-party tools used for event detection and problem determination at the {{site.data.keyword.Bluemix_notm}} platform level. | IBM | +|Define escalation plan | Define the escalation plan to triage and resolve events detected from the monitoring components. | IBM | +|Sign infrastructure, platform, and support agreements | Sign the subscription agreement including the financial terms and conditions for the environment. Sign support subscription. | Customer | +|Procure environment | Procure compute resources, network, and storage including core and Services VLAN to host {{site.data.keyword.Bluemix_notm}}, bare metal services to host Data Power, and {{site.data.keyword.Bluemix_notm}} Firewall. Provide infrastructure to allow for VPN tunnel. | IBM | +|Install fabric, application, and monitoring and management components | Install, configure, and verify fabric components, such as BOSH Director, Cloud Controller, Health Manager, messaging, routers, DEAs and Service providers, and the monitoring components that are defined in the escalation and problem detection plan. | IBM | +|Install and configure security components | Install and configure security components that are tied into the monitoring and escalation plan including IBM QRadar, credential vault, intrusion prevention system, IBM BigFix, and IBM Security Privileged Identity Management. | IBM | +|Install and configure custom components | Install and configure custom components that reside outside the scope of the {{site.data.keyword.Bluemix_notm}} product and services. | Customer | +|Establish initial network configuration | Establish initial network configuration including firewalls, DataPower, Fortigate, and DNS. | IBM | +|Connect {{site.data.keyword.Bluemix_notm}} pipeline | Connect {{site.data.keyword.Bluemix_notm}} continuous integration and continuous delivery pipeline with IBM repositories. | IBM | +|Customize external solution components | Customize load balancers for disaster recovery scenarios. | Customer | +|Install VPN solution | Install bidirectional VPN solution. | IBM | +|Configure login server | Configure the login server for use with the corporate LDAP. | IBM | +|Track status for security, compliance, and audit controls | Track status up to the point where all tools and processes are in place to achieve identified compliance. | Customer | +|Review physical infrastructure | Review physical premises that host the solution components for threats and review of security controls to protect the data center. | Customer | +|Inspect monitoring software | Inspect monitoring and management components as defined in the escalation and problem determination plan. | Customer | +|Inspect OS | Inspect to ensure that the operating system image meets compliance standards. IBM provides access to the OS image. | IBM and customer share responsibility | +{: caption="Table 5. Inception phase tasks" caption-side="top"} + + +Next is the progression phase. The progression phase describes the on-going, collaborative relationship between you and IBM Cloud. The primary goals for this phase include the following: + +- Review capacity and coordinate necessary adjustments. +- Review maintenance and platform improvements. +- Coordinate the activities for problem resolution and root cause analysis. + +| **Task** | **Task details** | **Responsible party** | +|----------|------------------|-----------------------| +|Review weekly capacity reports | Review the weekly capacity reports and take corrective action, if needed. | Customer | +|Create month-to-month projections | Collect information and create a month-to-month projection of capacity and consumption. | IBM and customer share responsibility | +|Review capacity projections | Review the capacity projections as they relate to external events that might impact capacity as well as anticipated new deployments of apps. Work with IBM to review the projections and plan accordingly. | IBM and customer share responsibility | +|Review projections | Review the capacity projections as it relates to external events that might impact capacity. | Customer | +|Adjust capacity | Add or remove capacity as your needs change. | IBM | +|Publish upcoming updates and maintenance | Create documentation for the required maintenance of IBM components. | IBM | +|Perform maintenance | Work with IBM to schedule required maintenance within a 21-day window. You can provide dates that might not work for you in the 21-day window, and IBM works to schedule the maintenance accordingly. | IBM and customer share responsibility | +|Address provisioning failures | Fix provisioning failures, if they occur, for customer-created services that are deployed to the Catalog. | IBM | +|Perform network and IP scans | Perform daily and monthly network and IP scans. | IBM and customer share responsibility | +|Provide access to audit logs | Provide access to all security and administrative audit logs. | IBM and customer share responsibility | +|Conduct testing | Conduct periodic Key Controls over Operations testing and third-party penetration testing. | IBM and customer share responsibility | +|Status reporting, audit coordination, and compliance meetings | Complete status reporting, external audit coordination, and representation at compliance review status meetings. | IBM | +|Employment and business need verification | Complete quarterly employment verification and verification of continued business need for IBM representatives that have access to the customer environment. | IBM | +|Resolution of security vulnerabilities | Resolve reported security vulnerabilities in the platform. | IBM | +{: caption="Table 6. Progression phase tasks" caption-side="top"} + +The final stage of completion represents the end of the relationship between you and IBM {{site.data.keyword.Bluemix_notm}}. The primary tasks for this phase include the following: + +* Ending of the financial agreement +* Removing all network connections +* Recycling infrastructure + + +| **Task** | **Task details** | **Responsible party** | +|----------|------------------|-----------------------| +|End financial agreement | Discuss and agree to an end to the financial agreement contract. | IBM and customer share responsibility | +|Decommission environment | Shut down access to and credentials for the environment. | IBM and customer share responsibility | +|Remove customer network connections | Remove network connections between IBM and the customer environment. | IBM and customer share responsibility | +|Recycle infrastructure | Your environment is recycled based on the {{site.data.keyword.BluSoftlayer}}-defined processes. | IBM | +{: caption="Table 7. Completion phase tasks" caption-side="top"} + +##Maintaining your dedicated instance +{: #maintaindedicated} + +IBM maintains and installs updates and fixes as IBM deems appropriate to the {{site.data.keyword.Bluemix_notm}} runtimes and services. Services might not be available during maintenance windows. In addition, IBM works with you to schedule maintenance updates for the {{site.data.keyword.Bluemix_notm}} platform. + +The following types of maintenance are required for {{site.data.keyword.Bluemix_dedicated_notm}}: +
+
**Standard maintenance for services**
+
The services utilize pre-defined, standard maintenance windows, which might cause the services to be unavailable. IBM does not require customer approval to perform service maintenance, but attempts to minimize impact to your services.
+
+IBM sends broadcast messages of the changes that are planned for each maintenance window on the Status page.
+
+**Important**: Some service might not be available to you during the maintenance period.
+ +
**Standard maintenance for the {{site.data.keyword.Bluemix_notm}} platform**
+
Maintenance updates are applied based on coordination between you and IBM within a 21-day window. You provide IBM with preapproved maintenance windows and specific dates or times that might not work for you, and IBM works to schedule updates during or around the dates that you selected. +

+

Go to **ADMINISTRATION > SYSTEM INFORMATION** to view scheduled and pending maintenance updates. For more information about setting your preapproved windows, unavailable dates, and viewing or approving scheduled maintenance updates, see Maintenance updates.

+
+ +**Important**: IBM reserves the right to interrupt services to apply emergency maintenance as needed. IBM might change scheduled maintenance hours, but will notify you of any such changes, as well as any emergency maintenance information. + +If there is a reported issue following a maintenance update, you agree with {{site.data.keyword.Bluemix_notm}} Support if it is in your best interest to allow IBM to roll back the update. Upon agreement, IBM rolls back the update to restore the environment to the previous state. + +## Incident response and support for {{site.data.keyword.Bluemix_dedicated_notm}} +{: #incidentresponse} + +### Customer-detected issues + +If you identify an issue that needs attention from IBM support and operations, you can contact support by using a few different methods. For information about how to contact support, see [Contacting support](../support/index.html#contacting-bluemix-support-local). Depending on the issue, you, IBM, or both work together to fix the issue. + +### IBM-detected critical incidents + +Critical incidents are urgent, unexpected service outages, and stability issues that affect your environment or your users. If IBM detects a critical incident within your environment, you are notified by a notification on the **Status** page. You can also check the Status page for any known issues for the platform or your services. For more information about the Status page, see [Viewing status](../admin/index.html#oc_status). + +If you want to integrate your notifications with a web service that supports web hooks, see [Notifications and event subscriptions](../admin/index.html#oc_eventsubscription) for information about how to extend your notification capabilities. + +![Incident response process](../local/images/incidentresponseprocess.png "Incident response process") + +Figure 2. Incident response process + +Depending on the issue, you, IBM, or both of you work together to fix the issue. If you have a question regarding the incident, or if you need an IBM representative to help you resolve the issue, then you can open a support ticket. For information about how to contact support, see [Contacting support](/docs/support/index.html#contacting-bluemix-support-local). + +**Note**: Severity 1 support tickets are monitored 24 hours a day, 7 days a week. Other tickets are processed from Sunday 10:00 pm GMT through Saturday 12:00 am GMT. For more information about severity of support tickets and working with support, see Contacting support. + + +## Disaster recovery for {{site.data.keyword.Bluemix_dedicated_notm}} +{: #dr} + +Disaster recovery for {{site.data.keyword.Bluemix_short}} Dedicated can be set up similarly to the way that it works when you use {{site.data.keyword.Bluemix_short}} Public. {{site.data.keyword.Bluemix_short}} Public provides a continuously available platform for innovation with multiple fail-safe measures to ensure that your orgs, spaces, and apps are always available. Deploying apps to multiple geographic regions enables continuous availability that protects against unplanned, simultaneous loss of multiple hardware or software components, or the loss of an entire data center, so that even in the event of a natural disaster in one geographic location, your distributed {{site.data.keyword.Bluemix_notm}} Public app instances in alternate geographic locations will be available. +{: shortdesc} + +Disaster recovery for {{site.data.keyword.Bluemix_short}} Dedicated is made possible through continuous availability for your apps, the inherent high availability of the platform, and the ability to restore your instance in the event of a failure. You are responsible for enabling continuous availability of your apps by deploying to multiple regions. High availability is built in at the platform level through technologies included in Cloud Foundry and other components. And, you can work together with IBM to ensure your data is properly backed up in the case that you need to restore your instance at any time. + +### Enabling continuous availability for {{site.data.keyword.Bluemix_dedicated_notm}} +{: #enabling} + +By default, {{site.data.keyword.Bluemix_notm}} Public deploys to multiple geographic locations. However, you must do the following to enable globally distributed {{site.data.keyword.Bluemix_dedicated_notm}} instances: + +* Ensure that your developers are deploying apps in more than one region, either through a manual or automated process. Regions should be more than 200 km apart from each other to ensure that a natural disaster cannot affect both geographic locations. +* Configure a global load balancer, like Akamai or Dyn, to point to apps in at least two different regions. + +**Note**: Not all {{site.data.keyword.Bluemix_notm}} services support regional distribution. When you construct an application, if you want to achieve geographic distribution, then you must also make sure that the services that are used by that application have data synchronization as a key feature. + +#### Deploying {{site.data.keyword.Bluemix_dedicated_notm}} apps to multiple geographic locations +{: #deploying} + +To deploy into a second location or multiple locations, you must follow a process similar to the one you took to enable your primary geographic location: + +1. Enable a new dedicated environment to host additional instances of your applications. To create a new environment, contact your IBM sales team to initiate the process. For more information about setting up a dedicated instance, see [Setting up {{site.data.keyword.Bluemix_dedicated_notm}}](/docs/dedicated/index.html#setupdedicated). You must log in separately to access each environment. Each physical location for the hosted environments should be a minimum of 200 km away from the original location to ensure availability. +2. Obtain the unique domain name where your new deployed app will be hosted. For example, if your original domain is *mycompany.caeast.bluemix.net*, then you can create a new local environment with a new domain such as *mycompany.cawest.bluemix.net*, and deploy to the new domain. +3. Each time you deploy your original app, also deploy to the new location. For more information about deploying, see [Uploading your app](/docs/starters/upload_app.html). + + +#### Enabling a global load balancer for {{site.data.keyword.Bluemix_dedicated_notm}} +{: #glb} + +A global load balancer not only ensures continuous availability and is required for disaster recovery, but it also has several additional benefits: + +* Routes users to the closest {{site.data.keyword.Bluemix_notm}} region by default +* Routes based on performance +* Selectively directs a percentage of traffic to a new application version +* Provides site failover based on region health check +* Provides site failover based on application health check +* Uses weighted routing between endpoints + +You can choose a global load balancer such as Akamai or Dyn. For more about using Akamai as a global load balancer, see [Global traffic management ![External link icon](../icons/launch-glyph.svg)](https://www.akamai.com/us/en/solutions/products/web-performance/global-traffic-management.jsp "Opens in new window"){: new_window}. For more about using Dyn as a global load balancer, see [4 Reasons Businesses Are Taking Global Load Balancing to the Cloud ![External link icon](../icons/launch-glyph.svg)](http://dyn.com/blog/4-reasons-businesses-are-taking-global-load-balancing-to-the-cloud/){: new_window}. + +### High availability +{: #ha} + +In addition to enabling continuous availability, {{site.data.keyword.Bluemix_notm}} also provides high availability across the platform by using technologies built into Cloud Foundry and other components. + +These technologies include the following: + +
+
DEA Scalability in Cloud Foundry
+
A Cloud Foundry Droplet Execution Agent (DEA) External link icon performs health checks on the apps running within it. If there is a problem with the app or the DEA itself, it deploys additional instances of the app to an alternate DEA to address the issue. For more information, see Configuring CF for High Availability with Redundancy External link icon. +

To ensure high availability for your applications, you need enough compute resources to balance the load, and you might also require additional compute resources to support a possible failure. If you need to scale your environment by increasing your DEA pool to be prepared for a failure or address a spike in the load for your app instances, you can work with your IBM representative to order additional DEAs and ensure that you have the appropriate hardware to support the added resources. +

+
+
{{site.data.keyword.BluSoftlayer}} redundancy
+
With {{site.data.keyword.BluSoftlayer}} in dedicated environments, data in each cloud storage cluster is written multiple times, and storage clusters are configured with auto-healing capabilities in case of drive failure. If there is a problem with a virtual server, {{site.data.keyword.BluSoftlayer}} tries to restart the virtual server on another host.
+
Metadata backup
+
Metadata is backed up using {{site.data.keyword.BluSoftlayer}} EVault Backup to a location that is a minimum of 200 km away.
+
+ +##Restoring your dedicated instance +{: #restorededicated} + +{{site.data.keyword.Bluemix_dedicated_notm}} settings, metadata, and configurations are backed up regularly to prepare for any unplanned outages in the environment. Your data that you are responsible for backing up includes application data, cloud database services data, and object stores. + +As part of the data backup, which includes system metadata and configurations, IBM completes the following tasks: + +
    +
  • Encrypts all backup copies and manages encryption keys
    • +
  • Monitors and manages backup activity
    • +
  • Provides the encrypted backup files
    • +
  • Restores the requested data
    • +
  • Manages scheduling conflicts between backup and fix management operations
    • +
+ +Because protection of private data is critical, IBM needs your collaboration when dealing with backup file management, so that the files are not moved outside of your data centers. Specifically, IBM asks that you complete the following tasks: + +
    +
  • Move a copy of your encrypted backup data off-site, just as you would for any other backup data that you manage.
    • +
  • Provide the backup files for the IBM operator in case of any need to restore.
    • +
+ +# rellinks +{: rellinks} +## general +{: general} +* [Discover: {{site.data.keyword.Bluemix_dedicated_notm}}](http://www.ibm.com/cloud-computing/bluemix/hybrid/dedicated/) +* [What's new in {{site.data.keyword.Bluemix_notm}}](/docs/whatsnew/index.html) +* [{{site.data.keyword.Bluemix_notm}} glossary](/docs/overview/glossary/index.html) +* [Managing {{site.data.keyword.Bluemix_notm}} Local and {{site.data.keyword.Bluemix_dedicated_notm}}](/docs/admin/index.html#mng) +* [Contacting support](/docs/support/index.html#getting-customer-support) diff --git a/dedicated/nl/fr/index.md b/dedicated/nl/fr/index.md index c75154759..3ac710e6f 100644 --- a/dedicated/nl/fr/index.md +++ b/dedicated/nl/fr/index.md @@ -343,12 +343,12 @@ Vous pouvez vous attendre à obtenir un processus similaire à la liste suivante Une fois votre instance {{site.data.keyword.Bluemix_notm}} configurée, vous pouvez surveiller et gérer votre instance {{site.data.keyword.Bluemix_notm}} via la page Administration. Pour plus d'informations, voir [Gestion de l'environnement {{site.data.keyword.Bluemix_notm}} local et de l'environnement Bluemix dédié](../admin/index.html#mng). Pour plus d'informations sur les mises à niveau et la maintenance, voir [Gestion de votre instance dédiée](index.html#maintaindedicated). -##Rôles et responsabilités +## Rôles et responsabilités {: #rolesresponsibilities} Si vous configurez un compte {{site.data.keyword.Bluemix_dedicated_notm}}, vous identifiez les personnes de votre organisation à affecter aux rôles nécessaires à la configuration et à l'exécution de votre instance. -###Rôles +### Rôles La liste suivante répertorie les rôles et les responsabilités des clients que vous attribuez : @@ -466,7 +466,7 @@ cette phase sont les suivantes : |Recycler l'infrastructure | Votre environnement est recyclé selon les processus définis par {{site.data.keyword.BluSoftlayer}}. | IBM | {: caption="Table 7. Completion phase tasks" caption-side="top"} -##Gestion de votre instance dédiée +## Gestion de votre instance dédiée {: #maintaindedicated} IBM gère et installe les mises à jour et les correctifs qu'elle juge nécessaires pour les contextes d'exécution et les services @@ -611,7 +611,7 @@ stockage sont configurés avec des capacités de rétablissement automatique en
Les métadonnées sont sauvegardées avec {{site.data.keyword.BluSoftlayer}} EVault Backup dans une zone qui se trouve à au moins 200 kilomètres.
-##Restauration de votre instance dédiée +## Restauration de votre instance dédiée {: #restorededicated} Les paramètres, les métadonnées et les configurations de l'environnement diff --git a/dedicated/nl/it/index.md b/dedicated/nl/it/index.md index 142e75a9b..76141c0d4 100644 --- a/dedicated/nl/it/index.md +++ b/dedicated/nl/it/index.md @@ -1,539 +1,539 @@ ---- - - - -copyright: - - years: 2015, 2017 - -lastupdated: "2017-01-11" - ---- - -{:shortdesc: .shortdesc} - -# {{site.data.keyword.Bluemix_dedicated_notm}} -{: #dedicated} - - -{{site.data.keyword.Bluemix}} è -una piattaforma basata su cloud open standard per la creazione, esecuzione e -gestione delle applicazioni. Con {{site.data.keyword.Bluemix_dedicated_notm}}, ottieni la potenza unita alla semplicità di {{site.data.keyword.Bluemix_notm}}— nel tuo ambiente SoftLayer dedicato che è connesso in modo protetto sia all'ambiente {{site.data.keyword.Bluemix_notm}} pubblico sia alla tua rete. -{:shortdesc} - -Tutte le distribuzioni dedicate di {{site.data.keyword.Bluemix_notm}} includono i seguenti vantaggi e le seguenti funzioni senza alcun costo aggiuntivo: VPN, VLAN (virtual local area network) privata, firewall, connettività al tuo LDAP, possibilità di avvalerti dei database e delle applicazioni installati in loco già esistenti, sicurezza in loco 24 ore al giorno, 7 giorni su 7, hardware dedicato e supporto standard. - -Per impostazione predefinita, l'accesso alla tua istanza privata di {{site.data.keyword.Bluemix_notm}} è possibile solo dalla tua rete aziendale. Se hai bisogno che il tuo ambiente {{site.data.keyword.Bluemix_notm}} sia accessibile direttamente da Internet, da un dispositivo mobile o da un database dedicato, è richiesto un ulteriore componente per la sicurezza di rete disponibile a un costo aggiuntivo. - -{{site.data.keyword.Bluemix_dedicated_notm}} viene fornito con tutti i runtime {{site.data.keyword.Bluemix_notm}} inclusi e 64 GB di memoria per le risorse di calcolo. - -Inoltre, è presente una serie di servizi e componenti inclusi oppure facoltativi che è possibile acquistare. Consulta la seguente tabella per vedere cosa è incluso e cosa puoi, facoltativamente, acquistare. - -| **Tipo** | **Nome** | **Descrizione** | -|-----------------|-------------------|-------------------| -|Incluso | [Runtime {{site.data.keyword.Bluemix_notm}}](/docs/cfapps/runtimes.html) | Utilizza i runtime per avere un'applicazione subito operativa, senza dover impostare e gestire macchine e sistemi operativi. Tutti i runtime {{site.data.keyword.Bluemix_notm}} sono a tua disposizione per utilizzarli nella tua istanza di {{site.data.keyword.Bluemix_dedicated_notm}}.| -| Incluso | [{{site.data.keyword.autoscaling}}](/docs/services/Auto-Scaling/index.html) | Ti permette di aumentare o ridurre dinamicamente la capacità -di elaborazione della tua applicazione in base alle politiche. Con questo servizio, hai un uso illimitato nel tuo ambiente {{site.data.keyword.Bluemix_dedicated_notm}}. Nota: Auto-scaling attualmente funziona solo con i runtime Cloud Foundry | -|Facoltativo | [{{site.data.keyword.apiconnect_short}}](/docs/services/apiconnect/index.html) | {{site.data.keyword.apiconnect_long}} integra {{site.data.keyword.APIM}} e IBM StrongLoop in una singola offerta che fornisce una soluzione completa per creare, eseguire, gestire e implementare API e microservizi. | -|Facoltativo | [{{site.data.keyword.rules_short}}](/docs/services/rules/rules.html) | {{site.data.keyword.rules_short}} offre un ambiente completo per automatizzare ed eseguire le frequenti decisioni di business basate su regole ripetibili. Consente inoltre agli utenti o sviluppatori di business di modellare rapidamente le decisioni e di testarle a costi più bassi, riducendo la necessità di competenze IT. | -|Facoltativo | [{{site.data.keyword.cloudant}}](/docs/services/Cloudant/index.html#Cloudant) | {{site.data.keyword.cloudant}} fornisce l'accesso a un livello di dati JSON NoSQL interamente gestito sempre attivo. Questo servizio è compatibile con CouchDB e accessibile mediante un'interfaccia HTTP di facile utilizzo per i modelli di applicazione web e mobile. | -|Facoltativo | [{{site.data.keyword.containershort}}](/docs/containers/container_index.html) | Esegui i contenitori Docker su {{site.data.keyword.Bluemix_dedicated_notm}}. I contenitori sono oggetti software virtuali che includono tutti gli elementi che un'applicazione deve eseguire. Un contenitore presenta i vantaggi dell'isolamento e dell'assegnazione delle risorse, ma offre una maggiore portabilità ed efficienza rispetto, ad esempio, a una macchina virtuale. Per informazioni sui requisiti hardware, vedi [IBM {{site.data.keyword.containershort}} in {{site.data.keyword.Bluemix_dedicated_notm}} e Bluemix locale](/docs/containers/container_dl.html).| -| Facoltativo | [{{site.data.keyword.contdelivery_short}}](/docs/services/ContinuousDelivery/index.html) | Utilizza {{site.data.keyword.contdelivery_short}} dedicato per automatizzare le build, i test di unità, le distribuzioni e altro. Modifica e trasmetti il codice tramite la IDE basata sul web avanzato. Crea le toolchain per abilitare le integrazioni dello strumento che supportano attività di sviluppo, distribuzione e operative. | -| Facoltativo | [{{site.data.keyword.dashdbshort}}](/docs/services/dashDB/dashDB.html) | IBM {{site.data.keyword.dashdbshort}} for Analytics è un servizio di database cloud SQL interamente gestito, ottimizzato per i carichi di lavoro di data warehouse e analisi. IBM {{site.data.keyword.dashdbshort}} for Transactions è un servizio di database cloud SQL interamente gestito, ottimizzato per l'uso generale, le applicazioni Web e i carichi di lavoro transazionali. | -| Facoltativo | [{{site.data.keyword.datacshort}}](/docs/services/DataCache/index.html#data_cache) | Questo servizio fornisce una griglia di dati in memoria -che supporta scenari di cache distribuita per le tue applicazioni. Include -50 GB di cache in memoria. | -| Facoltativo | [Dedicated GitHub Enterprise](/docs/services/ghededicated/index.html) | {{site.data.keyword.ghe_long}} è la versione di GitHub Enterprise completamente gestita e ospitata da IBM Cloud che fornisce l'esperienza di social networking che piace agli sviluppatori. Questo servizio è al momento disponibile solo per gli ambienti di {{site.data.keyword.Bluemix_dedicated_notm}}. | -| Facoltativo (beta) | [Registrazione](/docs/monitoringandlogging/cfapps_ml_logs_dedicated_ov.html#container_ml_logs_dedicated_ov) | Fornisce log per le tue applicazioni Cloud Foundry nella tua interfaccia utente {{site.data.keyword.Bluemix_notm}} e nei tuoi dashboard e log con funzione di ricerca in Kibana. | -| Facoltativo | [{{site.data.keyword.messagehub}}](/docs/services/MessageHub/index.html#messagehub) | {{site.data.keyword.messagehub}} è un bus di messaggi a velocità elevata scalabile e distribuito per unire le tue tecnologie installate in loco con quelle installate invece altrove. {{site.data.keyword.messagehub}} è basato su Apache Kafka, che è un motore di messaggistica in tempo reale rapido, scalabile e durevole. | -|Facoltativo | [{{site.data.keyword.mobilepush}}](/docs/services/mobilepush/index.html) | {{site.data.keyword.mobilepush}} è un servizio che puoi utilizzare per inviare notifiche a dispositivi iOS e Android. Le notifiche possono essere destinate a tutti gli utenti dell'applicazione oppure a uno specifico insieme di utenti e dispositivi facendo uso delle tag. Puoi amministrare i dispositivi, le tag e le sottoscrizioni. Puoi anche utilizzare API (application program interface) REST (Representational State Transfer) e SDK (software development kit) per sviluppare ulteriormente le tue applicazioni client.| -|Facoltativo | [{{site.data.keyword.SecureGateway}}](/docs/services/SecureGateway/secure_gateway.html) | Il servizio {{site.data.keyword.SecureGateway}} fornisce un modo sicuro per connettere le applicazioni {{site.data.keyword.Bluemix_notm}} da posizioni remote installate in loco o nel cloud. | -|Facoltativo | [{{site.data.keyword.sescashort}}](/docs/services/SessionCache/index.html#session_cache) | Per aumentare la ridondanza, {{site.data.keyword.sescashort}} fornisce una replica di una sessione memorizzata nella cache. Pertanto, nel caso di un'interruzione o di un calo di tensione, la tua applicazione client mantiene l'accesso alla sessione nella cache. Il servizio supporta scenari di memorizzazione di sessioni nella cache per applicazioni Web e mobili. | -| Facoltativo | [{{site.data.keyword.iot_short}}](/docs/services/IoT/index.html) | Questo servizio consente alle tue applicazioni di comunicare tra loro e utilizzare i dati raccolti dai tuoi dispositivi, sensori e gateway connessi. L'offerta di base consente l'esecuzione di una versione privata di {{site.data.keyword.iot_short}} nell'ambiente dedicato con una capacità di 100,000 applicazioni o dispositivi connessi contemporaneamente e 1.6 TB di scambio dati. | -| Facoltativo | [{{site.data.keyword.appserver_short}}](/docs/services/ApplicationServeronCloud/index.html) | IBM {{site.data.keyword.appserver_short}} per IBM {{site.data.keyword.Bluemix_notm}} è un servizio che aiuta nella configurazione rapida di un'istanza {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment o Traditional WebSphere Java EE preconfigurata in un ambiente cloud ospitato su {{site.data.keyword.Bluemix_notm}}. | -{: caption="Table 1. Dedicated Services" caption-side="top"} -{: #table01} - - - -Sono presenti dei componenti facoltativi disponibili per te da acquistare per ridimensionare e estendere la capacità dei tuoi servizi o risorse. Puoi acquistare tutti questi componenti contattando il team di vendite; vai all'indirizzo [Contattaci](https://console.ng.bluemix.net/?direct=classic/#/contactUs/cloudOEPaneId=contactUs) per informazioni su come contattare un rappresentante delle vendite. Per incrementare il tuo piano per un servizio, puoi selezionare il piano dal tile del servizio nel tuo catalogo. - -| **Nome** | **Descrizione** | -|-------------------|-------------------| -|5 milioni di chiamate API dedicate per {{site.data.keyword.apiconnect_short}} Professional | Un ambiente che consente l'esecuzione di una versione privata di {{site.data.keyword.apiconnect_short}} all'interno dell'ambiente dedicato con una capacità di 5 milioni di chiamate API al mese, destinate a progetti API del reparto. | -|Incremento di 100.000 chiamate API dedicate per {{site.data.keyword.apiconnect_short}} Professional | Un'estensione dell'ambiente {{site.data.keyword.apiconnect_short}} Professional che fornisce una capacità supplementare di 100.000 chiamate API al mese. | -|25 milioni di chiamate API dedicate per {{site.data.keyword.apiconnect_short}} Enterprise | Un ambiente che consente l'esecuzione di una versione privata di {{site.data.keyword.apiconnect_short}} all'interno dell'ambiente dedicato con una capacità di 25 milioni di chiamate API al mese, destinate a progetti API di tutta l'azienda. | -|Incremento di 100.000 chiamate API dedicate per {{site.data.keyword.apiconnect_short}} Enterprise | Un'estensione dell'ambiente {{site.data.keyword.apiconnect_short}} Enterprise che fornisce una capacità supplementare di 100.000 chiamate API al mese. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.rules_short}} 1 Million Rules Decisions | Una decisione di regole è il risultato della chiamata di una serie di regole da un Rule Execution Server. È necessario ottenere i diritti sufficienti per ricoprire il numero totale di decisioni di regole, arrotondato al milione, eseguite o elaborate, durante il periodo di fatturazione. Le decisioni di regole misurate da questo servizio cloud sono le chiamate effettuate al Rule Execution Server per ottenere una decisione. | -|Incremento della capacità di 16 TB dedicato per {{site.data.keyword.cloudant}} | Include l'esecuzione di una versione privata di {{site.data.keyword.cloudantfull}} nell'ambiente dedicato con una capacità di 1.6 terabyte. | -|Incremento della capacità di 50 GB dedicato per {{site.data.keyword.datacshort}} e {{site.data.keyword.sescashort}} | Un ambiente che consente la distribuzione e l'esecuzione di istanze {{site.data.keyword.datacshort}} e {{site.data.keyword.sescashort}} fino a una capacità cumulativa di 50 GB. | -|Istanza di {{site.data.keyword.contdelivery_short}} dedicato | Una versione privata di {{site.data.keyword.contdelivery_short}} in esecuzione all'interno di un ambiente dedicato. La capacità è determinata dai diritti dell'utente autorizzato di {{site.data.keyword.contdelivery_short}} dedicato. | -|Utente autorizzato di {{site.data.keyword.contdelivery_short}} dedicato | Concede l'accesso e l'utilizzo di un ambiente {{site.data.keyword.contdelivery_short}} dedicato designato a un utente autorizzato. Ogni utente appartenente a un'organizzazione {{site.data.keyword.Bluemix_notm}} che contiene un'istanza del servizio {{site.data.keyword.contdelivery_short}} deve essere autorizzato. | -|Dedicato per {{site.data.keyword.dashdbshort}} Enterprise 64.1 | Un database per istanza del servizio su un server dedicato con 64 GB RAM e 16 vCPU. Raccomandato fino a un 1 TB di precaricamento dati, in base alla compressione standard. | -|Dedicato per {{site.data.keyword.dashdbshort}} Enterprise 256.4 | Un database per istanza del servizio su un server dedicato 256 GB RAM e 32 core. Raccomandato fino a un 4 TB di precaricamento dati, in base alla compressione standard. | -|Dedicato per {{site.data.keyword.dashdbshort}} Enterprise 256.12 | Un database per istanza del servizio su un server dedicato 256 GB RAM e 32 core. Raccomandato fino a un 12 TB di precaricamento dati, in base alla compressione standard. Questo è un piano ad alta densità di memorizzazione per gli ambienti in cui i volumi di dati sono elevati e non è necessario eseguire le query alle velocità in memoria. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions 2.8.500 | Istanza dedicata che supporta carichi di lavoro OLTP (Online Transaction Processing) con 8 GB di RAM e 500 GB di spazio per dati e log. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions 12.128.1400 | Istanza dedicata che supporta carichi di lavoro OLTP (Online Transaction Processing) con 128 GB di RAM e 1,4 TB di archiviazione SSD per dati e log. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions High Availability 2.8.500 | Istanza dedicata che supporta carichi di lavoro OLTP (Online Transaction Processing) con 8 GB di RAM e 500 GB di spazio per dati e log e che include un ulteriore server di standby per l'alta disponibilità. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions High Availability 12.128.1400 | Istanza dedicata che supporta carichi di lavoro OLTP (Online Transaction Processing) con 128 GB di RAM e 1,4 TB di archiviazione SSD per dati e log e che include un ulteriore server di standby per l'alta disponibilità. | -|Servizi di community {{site.data.keyword.Bluemix_dedicated_notm}} | Un ambiente che consente la distribuzione e l'esecuzione di servizi di community fino a un totale di 50 istanze per ogni servizio di community. | -|Istanza cluster {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.cloudant}} | Questo componente facoltativo include un cluster a 3 nodi per il quale sei responsabile di fornire l'infrastruttura e dove la capacità di archiviazione e di calcolo può essere determinata sulla base delle tue specifiche esigenze. {{site.data.keyword.cloudant}} fornisce l'accesso a un livello di dati JSON NoSQL interamente gestito sempre attivo. Questo servizio è compatibile con CouchDB e accessibile mediante un'interfaccia HTTP di facile utilizzo per i modelli di applicazione web e mobile. | -|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.messagehub}} | Un ambiente che fornisce messaggistica di sottoscrizione e pubblica fino a 10 GB per partizione. I messaggi vengono conservati e sono disponibili per l'utilizzo per un massimo di 24 ore. | -|IBM Bluemix Dedicated {{site.data.keyword.mobilepushshort}} | Un ambiente che consente la distribuzione e l'esecuzione di istanze {{site.data.keyword.mobilepushshort}} con la capacità di accettare 300 richieste al secondo. | -|Aumento incrementale dedicato per {{site.data.keyword.iot_short}} | Un incremento dell'ambiente che consente l'esecuzione di una versione privata di {{site.data.keyword.iot_short}} nell'ambiente dedicato con una capacità di 100,000 applicazioni o dispositivi connessi contemporaneamente e 0.5 TB di scambio dati. | -|IBM {{site.data.keyword.appserver_short}} per {{site.data.keyword.Bluemix_notm}} - Dedicato Small| Un'istanza {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment o Traditional WebSphere Java EE preconfigurata in un ambiente cloud ospitato su {{site.data.keyword.Bluemix_notm}} con 64 vCore, 128GB RAM e 1TB HDD al mese. | -|IBM {{site.data.keyword.appserver_short}} per {{site.data.keyword.Bluemix_notm}} - Dedicato Medium| Un'istanza {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment o Traditional WebSphere Java EE preconfigurata in un ambiente cloud ospitato su {{site.data.keyword.Bluemix_notm}} con 128 vCore, 256GB RAM e 2TB HDD al mese. | -|IBM {{site.data.keyword.appserver_short}} per {{site.data.keyword.Bluemix_notm}} - Dedicato Large| Un'istanza {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment o Traditional WebSphere Java EE preconfigurata in un ambiente cloud ospitato su {{site.data.keyword.Bluemix_notm}} con 256 vCore, 512GB RAM e 4TB HDD al mese. | -|IBM {{site.data.keyword.appserver_short}} for {{site.data.keyword.Bluemix_notm}} - Dedicato| Un'istanza {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment o Traditional WebSphere Java EE preconfigurata in un ambiente cloud ospitato su {{site.data.keyword.Bluemix_notm}} con HDD Expansion e 1TB al mese. | -{: caption="Table 2. Optional service components for purchase" caption-side="top"} -{: #table02} - - - -| **Nome** | **Descrizione** | -|-------------------|-------------------| -|Incremento della capacità di 16 GB dedicato per i runtime | Un'estensione dell'ambiente dei runtime che fornisce una capacità di runtime extra di 16 GB. | -|Capacità di 1 Gbps dedicata per Direct Link | Un link di rete dedicato che si connette direttamente al POP (point of presence) di rete {{site.data.keyword.BluSoftlayer}} designato per i trasferimenti dati fino a 1 Gbps. | -|Capacità di 10 Gbps dedicata per Direct Link | Un link di rete dedicato che si connette direttamente al POP (point of presence) di rete {{site.data.keyword.BluSoftlayer}} designato per i trasferimenti dati fino a 10 Gbps. | -|Firewall hardware per IBM Bluemix dedicato - elevata disponibilità | Un firewall hardware di 1 Gbps ridondante configurato per la protezione di uno, alcuni o tutti i server nella stessa VLAN nell'ambiente dedicato. | -{: caption="Table 3. Optional platform add-on components for purchase" caption-side="top"} -{: #table03} - -**Nota**: i componenti di {{site.data.keyword.Bluemix_dedicated_notm}} possono indicare una capacità configurata specifica, come ad esempio gigabyte o transazioni al secondo. Poiché la capacità attuale messa in pratica per ogni configurazione del servizio cloud varia in base a molti fattori, la capacità attuale messa in pratica può essere maggiore o inferiore alla capacità configurata. - -### Catalogo diffuso -{: #catalogdedicated} - -{{site.data.keyword.Bluemix_dedicated_notm}} include un catalogo privato che riunisce i servizi approvati tra le tue distribuzioni pubbliche, dedicate e locali. Puoi anche pubblicare e gestire l'accesso ai tuoi servizi tramite il catalogo {{site.data.keyword.Bluemix_notm}}. Hai la possibilità di decidere quali servizi pubblici rispondono ai tuoi requisiti aziendali, sulla base di criteri di sicurezza e privacy dei dati. - -Se disponi di un'istanza privata del servizio per il tuo ambiente dedicato, vedi una tag "Dedicato" con i nomi del servizio nel tuo catalogo. Allo stesso modo, se si tratta di un servizio personalizzato, il che significa che hai utilizzato un broker dei servizi per crearlo, vedi "Personalizzato" elencato insieme al nome del servizio. Tutti gli altri servizi elencati che non presentano una tag "dedicato" o "personalizzato" sono disponibili tramite la diffusione da {{site.data.keyword.Bluemix_notm}} pubblico. I servizi diffusi forniscono la funzione per creare applicazioni ibride composte da servizi pubblici e privati. - -|Servizio |Disponibile nella regione Stati Uniti Sud |Disponibile nella regione Europa Regno Unito |Disponibile nella regione di Sydney in Australia| -|:----------|:------------------------------|:------------------|:------------------| -|{{site.data.keyword.alchemyapishort}} |Sì |Sì |Sì| -|{{site.data.keyword.alertnotificationshort}} |Sì |Sì |Sì | -|{{site.data.keyword.apiconnect_short}} |Sì |Sì |Sì | -|{{site.data.keyword.appseccloudshort}} |Sì |Sì |Sì | -|{{site.data.keyword.apiconnect_short}} |Sì |Sì |Sì | -|Automated Accessibility Checker |Sì |Sì |Sì | -|{{site.data.keyword.rules_short}} |Sì |Sì |Sì | -|{{site.data.keyword.cloudant}} |Sì |Sì |Sì | -|{{site.data.keyword.iotmapinsights_short}} |Sì |Sì |Sì | -|{{site.data.keyword.conversationshort}} |Sì |Sì |Sì | -|{{site.data.keyword.dashdbshort}} |Sì |Sì |Sì | -|{{site.data.keyword.dataworks_short}} |Sì |Sì |No| -|{{site.data.keyword.DB2OnCloud_short}} |Sì |Sì |Sì | -|Digital Content Checker |Sì |Sì |Sì | -|{{site.data.keyword.documentconversionshort}} |Sì |Sì |Sì| -|{{site.data.keyword.iotdriverinsights_short}} |Sì |Sì |Sì | -|{{site.data.keyword.geospatialshort_Geospatial}} |Sì |Sì |Sì | -|{{site.data.keyword.GlobalizationPipeline_short}} |Sì | Sì | Sì | -|{{site.data.keyword.identitymixershort}} |Sì |Sì |Sì| -|{{site.data.keyword.iot4auto_short}} |Sì |Sì |Sì | -|{{site.data.keyword.iotelectronics}} |Sì |Sì |No | -|{{site.data.keyword.iotinsurance_short}} |No |No |Sì | -|{{site.data.keyword.twittershort}} |Sì |Sì |Sì| -|{{site.data.keyword.languagetranslationshort}} |Sì |Sì |Sì | -|{{site.data.keyword.languagetranslatorshort}} |Sì |Sì |Sì | -|{{site.data.keyword.dwl_short}} |Sì |Sì |No | -|{{site.data.keyword.eventhubshort}} |Sì |No |No| -|{{site.data.keyword.messagehub}} |Sì |Sì |No| -|{{site.data.keyword.manda}} |Sì |Sì |Sì | -|{{site.data.keyword.amashort}} |Sì |Sì |Sì | -|{{site.data.keyword.mqa}} |Sì |Sì |Sì | -|{{site.data.keyword.mql}} |No |No |Sì | -|{{site.data.keyword.nlclassifierlshort}} |Sì |Sì |Sì| -|{{site.data.keyword.personalityinsightsshort}} |Sì |Sì |Sì| -|{{site.data.keyword.pm_short}} |Sì |Sì |No | -|{{site.data.keyword.mobilepush}} |Sì |Sì |Sì | -|{{site.data.keyword.retrieveandrankshort}} |Sì |Sì |Sì| -|{{site.data.keyword.runbook_short}} |Sì |Sì |Sì| -|{{site.data.keyword.SecureGateway}} |Sì |Sì |Sì | -|{{site.data.keyword.ssofull}} |Sì |No |No| -|{{site.data.keyword.speechtotextshort}} |Sì |Sì |Sì| -|{{site.data.keyword.streaminganalyticsshort}} |Sì |Sì |Sì | -|{{site.data.keyword.texttospeechshort}} |Sì |Sì |Sì| -|{{site.data.keyword.toneanalyzershort}} |Sì |Sì |Sì| -|{{site.data.keyword.tradeoffanalyticsshort}} |Sì |Sì |Sì| -|{{site.data.keyword.visualrecognitionshort}} |Sì |Sì |Sì| -|{{site.data.keyword.iot_short}} |Sì |Sì |No| -|{{site.data.keyword.weather_short}} |Sì |Sì |Sì| -|{{site.data.keyword.workloadscheduler}} |Sì |Sì |Sì | -{: caption="Table 4. Services available for syndication from {{site.data.keyword.Bluemix_notm}} Public by region" caption-side="top"} -{: #table04} - -**Nota**: i servizi di terze parti non sono inclusi nella tabella. Controlla il tuo catalogo dedicato per le opzioni dei servizi di terze parti. - - - -## Architettura di {{site.data.keyword.Bluemix_dedicated_notm}} -{: #dedicatedarch} - -{{site.data.keyword.Bluemix_dedicated_notm}} può essere distribuito in qualsiasi [data center {{site.data.keyword.IBM_notm}} SoftLayer ![icona link esterno](../icons/launch-glyph.svg)](http://www.softlayer.com/data-centers){: new_window} in tutto il mondo. {{site.data.keyword.IBM_notm}} SoftLayer fornisce l'infrastruttura cloud dalle prestazioni più elevate. Ciascun data center fornisce rigorosi controlli di sicurezza 24 ore al giorno, 7 -giorni a settimana. - -Ogni distribuzione di {{site.data.keyword.Bluemix_dedicated_notm}} è dedicata a una singola azienda sull'hardware dedicato di {{site.data.keyword.IBM_notm}} SoftLayer nella sua propria rete privata. Gli ambienti di {{site.data.keyword.Bluemix_dedicated_notm}} hanno gli stessi standard di sicurezza di {{site.data.keyword.Bluemix_notm}} pubblico in termini di sicurezza fisica, operativa e di infrastruttura. Tuttavia, -l'accesso degli sviluppatori a {{site.data.keyword.Bluemix_notm}} dedicato è -controllato dalle tue politiche LDAP, che possono essere configurate dal team di {{site.data.keyword.Bluemix_notm}} -nel momento in cui configurano il tuo ambiente. All'interno dell'ambiente dedicato, -puoi gestire i ruoli e le autorizzazioni degli utenti. Per i dettagli, vedi [Gestione di utenti e autorizzazioni](/docs/admin/index.html#oc_useradmin). La seguente figura mostra l'architettura logica di una distribuzione {{site.data.keyword.Bluemix_dedicated_notm}} predefinita. - -![{{site.data.keyword.Bluemix_dedicated_notm}}](images/bm_dedicated_arch.png "Architettura predefinita {{site.data.keyword.Bluemix_dedicated_notm}}") - -Figura 1. Diagramma dettagliato dell'architettura predefinita di {{site.data.keyword.Bluemix_dedicated_notm}} -{: #figure01} - -I componenti architetturali importanti mostrati nel precedente diagramma dell'architettura sono i seguenti: - -
-
{{site.data.keyword.IBM_notm}} Cloud
-
-L'ambiente cloud {{site.data.keyword.IBM_notm}} nel suo insieme include i seguenti ambienti di rete importanti: -
    -
  • {{site.data.keyword.Bluemix_dedicated_notm}}
    • -
  • {{site.data.keyword.Bluemix_notm}} pubblico
    • -
  • Operazioni {{site.data.keyword.IBM_notm}}
    • -
-
-
{{site.data.keyword.Bluemix_dedicated_notm}}
-
-Come minimo, contiene i componenti Cloud Foundry e alcuni servizi di applicazione dedicati. {{site.data.keyword.Bluemix_notm}} fornisce gli ambienti di calcolo Cloud Foundry e basati su {{site.data.keyword.containerlong}}. Un'azienda può avere uno o entrambi questi ambienti di calcolo configurati.
-Un'azienda può aggiungere ulteriori servizi di applicazione dedicati.
-Consulta la [tabella 2](#table02) per informazioni sugli ulteriori servizi e capacità di calcolo che puoi aggiungere. -
-
{{site.data.keyword.Bluemix_notm}} pubblico
-
-{{site.data.keyword.Bluemix_dedicated_notm}} può includere una connessione in uscita a una regione di {{site.data.keyword.Bluemix_notm}} pubblico. Ciò fornisce la diffusione dei servizi pubblico sul catalogo dedicato. La diffusione del servizio {{site.data.keyword.Bluemix_notm}} pubblico offre agli sviluppatori un metodo pratico per creare applicazioni ospitate nel {{site.data.keyword.Bluemix_dedicated_notm}} della propria azienda e accedere ai servizi in esecuzione in {{site.data.keyword.Bluemix_notm}} pubblico. L'elenco dei servizi che possono essere diffusi da {{site.data.keyword.Bluemix_notm}} pubblico sono mostrati nella [tabella 4 della sezione Catalogo diffuso](#catalogdedicated). -
-
Operazioni {{site.data.keyword.IBM_notm}}
-
-{{site.data.keyword.IBM_notm}} gestisce, monitora e mantiene la piattaforma dedicata e i servizi dedicati, così tu puoi concentrarti sulla creazione di applicazioni innovative. Il team OSS (Operations Support Services) {{site.data.keyword.IBM_notm}} esegue le operazioni utilizzando una connessione tunnel VPN dalla rete delle operazioni {{site.data.keyword.IBM_notm}}. -
-
Azienda
-
-L'ambiente di rete aziendale può avere un collegamento di rete bidirezionale privato a {{site.data.keyword.Bluemix_dedicated_notm}}. Ciò consente alle applicazioni ospitate in {{site.data.keyword.Bluemix_dedicated_notm}} di accedere ai servizi e alle risorse all'interno dell'azienda, tra cui le origini dati e i servizi aziendali. Questo collegamento di rete consente inoltre a {{site.data.keyword.Bluemix_dedicated_notm}} di utilizzare il tuo LDAP per l'autenticazione degli sviluppatori e amministratori della tua azienda.
-
-Esistono diverse opzioni per la creazione di link di rete privata sicuri. Parla con il tuo specialista tecnico IBM su quale è la migliore opzione di rete per il tuo ambiente.
-
-La connessione predefinita da {{site.data.keyword.Bluemix_dedicated_notm}} alla tua rete aziendale utilizzare una VPN (Virtual Private Network). {{site.data.keyword.Bluemix_dedicated_notm}} ha una terminazione VPN Vyatta di 1 Gbps dedicata configurata per l'elevata disponibilità. -
-Nell'architettura predefinita per {{site.data.keyword.Bluemix_dedicated_notm}} come mostrato nella [figura 1](#figure01), non c'è traffico di rete in entrata direttamente da internet. Se la tua azienda desidera consentire l'accesso Internet alle applicazioni ospitate in {{site.data.keyword.Bluemix_dedicated_notm}}, è necessario configurare l'accesso tramite la rete aziendale. -
-
- - -## Configurazione di {{site.data.keyword.Bluemix_dedicated_notm}} -{: #setupdedicated} - -{{site.data.keyword.Bluemix_dedicated_notm}} è progettato per fornire una versione privata dell'offerta {{site.data.keyword.Bluemix_notm}} pubblico. Puoi utilizzare i servizi e i runtime {{site.data.keyword.Bluemix_notm}} per supportare le tue esigenze di elaborazione in un account {{site.data.keyword.BluSoftlayer}} ospitato da IBM. - -IBM ti fornisce l'accesso a {{site.data.keyword.Bluemix_dedicated_notm}} utilizzando un accesso protetto da password. Puoi accedere a servizi, runtime -e risorse associate nonché distribuire e rimuovere applicazioni {{site.data.keyword.Bluemix_notm}}. IBM si avvale di più sedi {{site.data.keyword.BluSoftlayer}} per la distribuzione di {{site.data.keyword.Bluemix_dedicated_notm}} il che ti permette di ottenere la tua versione privata in una sede a te vicina. - -Per configurare la tua versione privata di {{site.data.keyword.Bluemix_notm}}: - -
    -
  1. Per iniziare, contatta il tuo rappresentante dell'account designato IBM oppure contatta {{site.data.keyword.Bluemix_notm}} icona link esterno.
    2. -
  2. Determina insieme a IBM la quota per la tua istanza {{site.data.keyword.Bluemix_dedicated_notm}}. La quota mensile ricorrente si basa sui servizi dedicati -che desideri utilizzare, oltre a una sottoscrizione a tutti i servizi pubblici -{{site.data.keyword.Bluemix_notm}}. Riceverai quindi una fattura per tutto ciò che scegli di utilizzare -al di fuori di tale accordo di sottoscrizione.
    3. -
  3. Identifica le scadenze per ogni fase di configurazione della tua istanza di {{site.data.keyword.Bluemix_dedicated_notm}}. Per informazioni su ciascuna fase e sulle attività coinvolte, vedi Ruoli e responsabilità {{site.data.keyword.Bluemix_dedicated_notm}}.
    4. -
  4. Seleziona la sede data center {{site.data.keyword.BluSoftlayer}} icona link esterno per la tua istanza dedicata. Vengono creati quindi la tua piattaforma dedicata e il tuo account. Per l'account, devi identificare le persone all'interno della tua organizzazione -a cui assegnare i ruoli necessari per rendere operativa la tua istanza -dedicata. Per informazioni sui ruoli che puoi assegnare, vedi Ruoli e responsabilità {{site.data.keyword.Bluemix_dedicated_notm}}. -
    5. -
  5. Definisci e stabilisci la connettività di rete tra la tua rete aziendale e la tua istanza {{site.data.keyword.Bluemix_dedicated_notm}}. Esiste un'applicazione per la sicurezza di rete obbligatoria che include le funzionalità di firewall e prevenzione delle intrusioni con un costo associato per questa opzione. -
      -
    1. IBM installa l'infrastruttura di monitoraggio e di sicurezza per l'istanza dedicata.
      2. -
    2. IBM installa i servizi dedicati a singolo tenant che hai selezionato.
      3. -
    3. Fornisci gli endpoint e la configurazione di rete -per cose come indirizzi IP o firewall e accedi al tuo LDAP per -l'integrazione in {{site.data.keyword.Bluemix_notm}}.
      4. -
    -
    6. -
  6. Identifica e assegna i ruoli del tuo team amministrativo per l'ambiente. -
      -
    1. IBM configura l'accesso alla rete e il LDAP in base alle informazioni che hai fornito. L'accesso amministrativo -viene fornito ai contatti da te designati. Devi designare un -contatto anche per il supporto e la fatturazione.
      2. -
    2. IBM configura un catalogo diffuso nell'ambiente dedicato per visualizzare i tuoi servizi dedicati. Il catalogo diffuso include dei servizi aggiuntivi che vengono diffusi e messi a tua disposizione da {{site.data.keyword.Bluemix_notm}} pubblico. Hai la possibilità di decidere quali servizi pubblici rispondono ai tuoi requisiti aziendali, sulla base di criteri di sicurezza e privacy dei dati.
      3. -
    3. Convalidi la configurazione di rete e del firewall e l'accesso e l'endpoint LDAP.
      4. -
    -
    7. -
- -Per la distribuzione e configurazione iniziale del tuo ambiente puoi prevedere un processo simile a quello elencato di seguito. Per i dettagli sui responsabili di ciascuna attività, vedi [Ruoli e responsabilità](index.html#rolesresponsibilities). - -
    -
  1. Seleziona il data center che verrà utilizzato per ospitare l'istanza dedicata. Per informazioni sulle opzioni dei data center, vedi Sede data center {{site.data.keyword.BluSoftlayer}} icona link esterno.
    2. -
  2. Specifica i nomi di dominio per la distribuzione e gli ID che desideri utilizzare. Quando configuri l'istanza {{site.data.keyword.Bluemix_notm}}, ottieni tre domini. Puoi scegliere il prefisso per *mycompany*.*region*.bluemix.net e *mycompany*.*region*.mybluemix.net. Inoltre, puoi scegliere il nome completo per il terzo dominio.
    -

    Puoi scegliere il numero di domini personalizzati desiderato. Tuttavia, sarai responsabile dei certificati dei domini personalizzati. Per ulteriori informazioni sulla creazione del dominio personalizzato, consulta Creazione e utilizzo di un dominio personalizzato.

    3. -
  3. Identifica un proprietario per l'account pubblico che viene utilizzato per rappresentare la tua azienda in {{site.data.keyword.Bluemix_notm}} pubblico. IBM utilizza questo account per tracciare l'utilizzo dei servizi diffusi.
    4. -
  4. Seleziona il tipo di connessione sicura al tuo data center. Puoi selezionare tra {{site.data.keyword.Bluemix_notm}} VPN, {{site.data.keyword.Bluemix_notm}} Direct Link e AT&T Net Bond.
    5. -
  5. Decidi se consentire l'accesso al tuo ambiente dedicato dall'Internet pubblico.
    6. -
  6. Seleziona il tipo di autenticazione che verrà utilizzato. Puoi selezionare ID IBM o Active Directory. Per informazioni sull'utilizzo e la registrazione di un ID IBM, consulta la pagina Help and FAQ. -
    7. -
  7. Identifica e assegna i ruoli del tuo team amministrativo per l'ambiente. Per informazioni sui ruoli che devi assegnare, vedi Ruoli e responsabilità {{site.data.keyword.Bluemix_dedicated_notm}}.
    8. -
  8. IBM distribuisce la piattaforma di base che include i runtime elastici, la console, la funzione di amministrazione e il monitoraggio.
    9. -
  9. IBM configura il tuo accesso amministrativo all'ambiente.
    10. -
  10. Puoi iniziare a utilizzare la tua istanza dedicata, monitorata dal team operativo IBM, al fine di rispondere agli avvisi.
    11. -
- -Una volta configurata la tua istanza {{site.data.keyword.Bluemix_notm}}, puoi monitorare e gestire l'istanza {{site.data.keyword.Bluemix_notm}} utilizzando la pagina Amministrazione. Per ulteriori informazioni, vedi [Gestione di {{site.data.keyword.Bluemix_notm}} locale e dedicato](../admin/index.html#mng). Per informazioni su aggiornamenti e manutenzione, vedi [Manutenzione dell'istanza dedicata](index.html#maintaindedicated). - -##Ruoli e responsabilità -{: #rolesresponsibilities} - -Se hai configurato un account {{site.data.keyword.Bluemix_dedicated_notm}}, devi identificare le persone all'interno della tua organizzazione a cui assegnare i ruoli necessari per rendere operativa la tua istanza. - -###Ruoli - -Il seguente elenco mostra i ruoli e le responsabilità dei clienti che puoi assegnare: - -
-
**Procurement focal**
-
Lavora con il rappresentante IBM per organizzare il tuo ambiente {{site.data.keyword.Bluemix_dedicated_notm}}, occupandosi inoltre dell'identificazione delle persone adeguate a gestire ogni aspetto del progetto all'interno della tua organizzazione. La persona assegnata a questo ruolo assume un ruolo di gestione dei progetti e controlla la selezione del modello, gli accordi commerciali e la disposizione dell'accesso alle risorse dei clienti. Il Procurement focal è il contatto generale per la configurazione dell'istanza dedicata e la traccia del processo di distribuzione.
-
**Responsabile della conformità**
-
Lavora con il rappresentante IBM per selezionare un'opzione di topologia e distribuzione che risponda ai tuoi requisiti di sicurezza. La persona assegnata a questo ruolo collabora con i consulenti di conformità IBM per determinare quali modelli di distribuzione raggiungono gli obiettivi di conformità.
-
**Network specialist**
-
Lavora con il rappresentante IBM per identificare i piani di rete per la distribuzione di {{site.data.keyword.Bluemix_notm}}. La persona assegnata a questo ruolo riesamina le specifiche di rete richieste da IBM e lavora con IBM su un piano di implementazione. Al termine della fase di installazione e verifica, la persona assegnata a questo ruolo conferma che la configurazione di rete è in conformità con gli standard aziendali.
-
**DevOps focal**
-
Lavora con il rappresentante IBM per pianificare e applicare gli aggiornamenti di manutenzione necessari per la piattaforma, i servizi e i runtime {{site.data.keyword.Bluemix_notm}}. La persona assegnata a questo ruolo lavora anche con il rappresentante IBM sulla configurazione della tua istanza {{site.data.keyword.Bluemix_dedicated_notm}}.
-
Operations focal
-
Lavora con il team di supporto come necessario quando l'ambiente è attivo e in esecuzione. In genere si tratta di qualcuno con l'accesso Superuser alla console di gestione che può approvare gli aggiornamenti di manutenzione pianificati per l'ambiente Bluemix ed essere disponibile tutte le volte che si verifica un incidente critico. La persona assegnata a questo ruolo deve avere una conoscenza tecnica dell'ambiente Bluemix ed essere nella posizione di raggiungere le altre persone nell'azienda con competenze avanzate in un'area che potrebbe essere influenzata inclusi ad esempio la rete e la sicurezza.
-
- -I tuoi rappresentanti dei clienti collaborano con gli specialisti IBM che lavorano insieme per garantirti tutto il supporto di cui hai bisogno. Puoi eseguire l'upgrade al livello di supporto Premium per lavorare con un CSM (Client Success Manager) dedicato per il tuo account. Per ulteriori informazioni sui diversi livelli di supporto, -vedi [Come contattare il supporto](../support/index.html#contacting-support). Il CSM completa i seguenti tipi di attività: - -
    -
  • Consente una rapida adozione del tuo ambiente {{site.data.keyword.Bluemix_dedicated_notm}}.
    • -
  • Offre utili materiali didattici e di abilitazione per migliorare la tua autosufficienza.
    • -
  • Promuove una relazione a lungo termine tra te e lo sviluppo, il supporto e i servizi {{site.data.keyword.Bluemix_notm}} che utilizzi.
    • -
- -Il team operativo e di supporto {{site.data.keyword.Bluemix_notm}} che insieme a te gestisce l'istanza {{site.data.keyword.Bluemix_notm}} potrebbe accedere al tuo ambiente locale, ma lo fa solo per i seguenti motivi. - -
    -
  • Per rispondere agli avvisi ed eseguire la manutenzione operativa
    • -
  • Per tentare di riprodurre un problema riportato su un ticket di supporto
    • -
- -### Responsabilità - -Dalla configurazione del tuo ambiente alla manutenzione continua, è necessario completare una serie di attività. La seguente tabella illustra le attività richieste e il proprietario per lo svolgimento delle attività attraverso le fasi di inizio, avanzamento e completamento. - -La fase di inizio è utilizzata per organizzare l'ambiente {{site.data.keyword.Bluemix_dedicated_notm}}. Gli obiettivi principali di questa fase sono i seguenti: - -- Esaminare l'accordo finanziario e stabilire le date cardine per la distribuzione. -- Creare la piattaforma {{site.data.keyword.Bluemix_notm}} e fornire accesso a runtime e servizi. -- Definire e stabilire la connettività di rete tra la tua rete aziendale e le operazioni {{site.data.keyword.Bluemix_notm}}. -- Identificare e assegnare i ruoli per il team amministrativo. - -| **Attività** | **Dettagli attività** | **Parte responsabile** | -|----------|------------------|-----------------------| -|Impostare gli standard di conformità | Identificare gli standard governativi, di settore e aziendali richiesti per l'ambiente. | Cliente | -|Creare un piano di integrazione di sicurezza e conformità | Creare un piano di sicurezza e di integrazione che includa i costi, la pianificazione e le risorse necessarie per garantire la conformità di sicurezza. | IBM | -|Approvazione del piano di conformità | Approvare il piano di conformità. | Cliente | -|Creare il dimensionamento per l'ambiente | Creare il dimensionamento dell'ambiente sulla base di scelte predefinite che tengono in considerazione gli obiettivi di alta disponibilità e ripristino di emergenza, così come il provisioning iniziale di DEA e servizi necessario per supportare le applicazioni create con la piattaforma. Lavora insieme a IBM per definire, ad esempio, quali database sono necessari, quali servizi vengono offerti nel catalogo diffuso del cliente e altro ancora. | Responsabilità condivisa tra IBM e il cliente | -|Selezionare l'architettura | Selezionare l'architettura sulla base di scelte predefinite che tengono in considerazione i requisiti di alta disponibilità e ripristino di emergenza. | IBM | -|Definire gli obiettivi del ripristino di emergenza | Definire i requisiti di ripristino di emergenza per l'ambiente. | Cliente | -|Creare il piano di ripristino di emergenza | Consultare e definire il piano di ripristino di emergenza. IBM crea un modello di ripristino di emergenza e con te stabilisce dove fornire il feedback e approvare il piano. | Responsabilità condivisa tra IBM e il cliente | -|Creare il piano di backup e ripristino | Creare un piano di backup e ripristino che definisce la frequenza e i requisiti per la distribuzione interna ed esterna del backup. IBM esegue il backup dei componenti dell'infrastruttura, dei servizi IBM, dei metadati dei servizi inclusi i ruoli utente e altro ancora. Tu esegui il backup dei dati specifici dell'applicazione di cui sei responsabile. | Responsabilità condivisa tra IBM e il cliente | -|Identificare gli strumenti per il rilevamento degli eventi e la determinazione dei problemi | Identificare gli strumenti IBM e di terze parti utilizzati per il rilevamento degli eventi e la determinazione dei problemi a livello della piattaforma {{site.data.keyword.Bluemix_notm}}. | IBM | -|Definire il piano di escalation | Definire il piano di escalation per valutare e risolvere gli eventi rilevati dai componenti di monitoraggio. | IBM | -|Firmare gli accordi relativi a infrastruttura, piattaforma e supporto | Firmare l'accordo di sottoscrizione che include i termini e le condizioni finanziarie per l'ambiente. Firmare la sottoscrizione di supporto. | Cliente | -|Disporre l'ambiente | Disporre le risorse di calcolo, la rete e la memoria incluso la VLAN core e dei servizi per ospitare {{site.data.keyword.Bluemix_notm}}, e i servizi bare metal per ospitare Data Power e {{site.data.keyword.Bluemix_notm}}. Fornire l'infrastruttura per consentire il tunnel VPN. | IBM | -|Installare i componenti dell'infrastruttura, dell'applicazione e di monitoraggio e gestione | Installare, configurare e verificare i componenti dell'infrastruttura, come ad esempio BOSH Director, Cloud Controller, Health Manager, messaggistica, router, DEA e provider di servizi e i componenti di monitoraggio definiti nel piano di escalation e rilevamento dei problemi. | IBM | -|Installare e configurare i componenti di sicurezza | Installare e configurare i componenti di sicurezza vincolati nel piano di monitoraggio e di escalation, tra cui IBM QRadar, archivio credenziali, sistema di prevenzione delle intrusioni, IBM BigFix e IBM Security Privileged Identity Management. | IBM | -|Installare e configurare i componenti personalizzati | Installare e configurare i componenti personalizzati che si trovano al di fuori del campo di applicazione del prodotto e dei servizi {{site.data.keyword.Bluemix_notm}}. | Cliente | -|Stabilire la configurazione di rete iniziale | Stabilire la configurazione di rete iniziale inclusi i firewall, DataPower, Fortigate e DNS. | IBM | -|Connettere la pipeline {{site.data.keyword.Bluemix_notm}} | Connettere la pipeline di fornitura e di integrazione continua {{site.data.keyword.Bluemix_notm}} ai repository IBM. | IBM | -|Personalizzare i componenti della soluzione esterni | Personalizzare i servizi di bilanciamento del carico per gli scenari di ripristino di emergenza. | Cliente | -|Installare la soluzione VPN | Installare la soluzione VPN bidirezionale. | IBM | -|Configurare il server di accesso | Configurare il server di accesso per l'utilizzo del LDAP aziendale. | IBM | -|Tracciare lo stato per le verifiche di sicurezza, conformità e controllo | Tracciare lo stato fino al punto in cui vengono osservati tutti gli strumenti e processi per raggiungere la conformità identificata. | Cliente | -|Controllare l'infrastruttura fisica | Controllare le sedi fisiche che ospitano i componenti della soluzione per individuare eventuali minacce e riesaminare i controlli di sicurezza per proteggere il data center. | Cliente | -|Ispezionare il software di monitoraggio | Ispezionare i componenti di monitoraggio e gestione, come definito nel piano di escalation e determinazione dei problemi. | Cliente | -|Ispezionare il sistema operativo | Verificare che l'immagine del sistema operativo rispetti gli standard di conformità. IBM fornisce l'accesso all'immagine del sistema operativo. | Responsabilità condivisa tra IBM e il cliente | -{: caption="Table 5. Inception phase tasks" caption-side="top"} - - -La fase successiva è quella di avanzamento. La fase di avanzamento descrive il rapporto di collaborazione in corso tra te e IBM Cloud. Gli obiettivi principali per questa fase sono i seguenti: - -- Esaminare le capacità e coordinare le modifiche necessarie. -- Esaminare i miglioramenti di manutenzione e piattaforma. -- Coordinare le attività per la risoluzione dei problemi e l'analisi delle cause principali. - -| **Attività** | **Dettagli attività** | **Parte responsabile** | -|----------|------------------|-----------------------| -|Esaminare i report sulle capacità settimanali | Esaminare i report sulle capacità settimanali e adottare misure correttive laddove necessario. | Cliente | -|Creare proiezioni mensili | Raccogliere informazioni e creare una proiezione mensile della capacità e del consumo. | Responsabilità condivisa tra IBM e il cliente | -|Esaminare le proiezioni della capacità | Esaminare le proiezioni della capacità relative ad eventi esterni che potrebbero influire sulle capacità così come sulle nuove distribuzioni previste per le applicazioni. Lavorare con IBM per esaminare le proiezioni e creare un piano adeguato. | Responsabilità condivisa tra IBM e il cliente | -|Esaminare le proiezioni | Esaminare le proiezioni della capacità relative ad eventi esterni che potrebbero influire sulle capacità. | Cliente | -|Regolare la capacità | Aggiungere o rimuovere capacità al mutare delle esigenze. | IBM | -|Pubblicare gli aggiornamenti e la manutenzione previsti | Creare la documentazione per la manutenzione richiesta dei componenti IBM. | IBM | -|Effettuare la manutenzione | Lavorare con IBM per pianificare la manutenzione richiesta all'interno di una finestra di 21 giorni. Puoi fornire le date che per te potrebbero non andare bene all'interno della finestra di 21 giorni; IBM provvederà a pianificare la manutenzione di conseguenza. | Responsabilità condivisa tra IBM e il cliente | -|Rilevamento di errori di provisioning | Correggere gli errori di provisioning, se presenti, per i servizi creati dal cliente che vengono distribuiti nel catalogo. | IBM | -|Eseguire scansioni di rete e IP | Eseguire scansioni di rete e IP giornaliere e mensili. | Responsabilità condivisa tra IBM e il cliente | -|Fornire accesso ai log di controllo | Fornire accesso a tutti i log di controllo amministrativo e della sicurezza. | Responsabilità condivisa tra IBM e il cliente | -|Effettuare dei test | Effettuare periodicamente il test dei controlli chiave sulle operazioni e il test di penetrazione di terze parti. | Responsabilità condivisa tra IBM e il cliente | -|Segnalazione dello stato, coordinamento dei controlli e incontri di conformità | Completare la segnalazione dello stato, il coordinamento del controllo esterno e la rappresentazione negli incontri sullo stato di revisione della conformità. | IBM | -|Verifica dell'occupazione lavorativa e delle esigenze aziendali | Completare la verifica trimestrale dell'occupazione lavorativa e la verifica delle continue esigenze aziendali per i rappresentanti IBM che hanno accesso all'ambiente del cliente. | IBM | -|Risoluzione delle vulnerabilità di sicurezza | Risolvere le vulnerabilità di sicurezza segnalate nella piattaforma. | IBM | -{: caption="Table 6. Progression phase tasks" caption-side="top"} - -La fase finale di completamento rappresenta la fine del rapporto tra te e IBM {{site.data.keyword.Bluemix_notm}}. Le attività principali per questa fase sono le seguenti: - -* Termine dell'accordo finanziario -* Rimozione di tutte le connessioni di rete -* Riciclaggio dell'infrastruttura - - -| **Attività** | **Dettagli attività** | **Parte responsabile** | -|----------|------------------|-----------------------| -|Terminare l'accordo finanziario | Discutere e concordare un termine per il contratto dell'accordo finanziario. | Responsabilità condivisa tra IBM e il cliente | -|Rimuovere le autorizzazioni per l'ambiente | Disattivare l'accesso e le credenziali per l'ambiente. | Responsabilità condivisa tra IBM e il cliente | -|Rimuovere le connessioni di rete del cliente | Rimuovere le connessioni di rete tra IBM e l'ambiente del cliente. | Responsabilità condivisa tra IBM e il cliente | -|Riciclare l'infrastruttura | Il tuo ambiente viene riciclato in base ai processi definiti da {{site.data.keyword.BluSoftlayer}}. | IBM | -{: caption="Table 7. Completion phase tasks" caption-side="top"} - -##Gestione della tua istanza dedicata -{: #maintaindedicated} - -IBM effettua la manutenzione e l'installazione di aggiornamenti e correzioni ogni qualvolta lo ritenta appropriato per i runtime e i servizi {{site.data.keyword.Bluemix_notm}}. I servizi potrebbero non essere disponibili durante le finestre di manutenzione. Inoltre, IBM collabora con te per pianificare gli aggiornamenti di manutenzione per la piattaforma {{site.data.keyword.Bluemix_notm}}. - -Per {{site.data.keyword.Bluemix_dedicated_notm}} sono richiesti i seguenti tipi di manutenzione: -
-
**Manutenzione standard per i servizi**
-
I servizi utilizzano delle finestre di manutenzione standard predefinite, che potrebbero causare la non disponibilità del servizi. IBM non richiede l'approvazione dei clienti per eseguire la manutenzione dei servizi, ma prova a ridurre al minimo l'impatto sui tuoi servizi.
-
-IBM invia dei messaggi di broadcast relativi alle modifiche pianificate per ciascuna finestra di manutenzione nella pagina Stato.
-
-**Importante**: alcuni servizi potrebbero non essere a tua disposizione durante il periodo di manutenzione.
- -
**Manutenzione standard per la piattaforma {{site.data.keyword.Bluemix_notm}}**
-
Gli aggiornamenti di manutenzione vengono applicati in base al coordinamento tra te e IBM entro una finestra di 21 giorni. Fornisci a IBM le finestre di manutenzione preapprovate e le date o gli orari specifici che potrebbero non andare bene per te; IBM cercherà di pianificare gli aggiornamenti durante o intorno alle date da te selezionate. -

-

Vai a **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA** per visualizzare gli aggiornamenti di manutenzione pianificati e in sospeso. Per ulteriori informazioni sull'impostazione delle tue finestre preapprovate, e la visualizzazione o l'approvazione degli aggiornamenti di manutenzione pianificati, vai a Aggiornamenti di manutenzione.

-
- -**Importante**: IBM si riserva il diritto di interrompere i servizi per applicare la manutenzione di emergenza a seconda delle necessità. IBM potrebbe modificare le ore di manutenzione pianificate, ma verrai avvisato di tali modifiche nonché di tutte le informazioni relative alla manutenzione di emergenza. - -Se viene segnalato un problema dopo l'aggiornamento di manutenzione, insieme al rappresentante del supporto {{site.data.keyword.Bluemix_notm}} puoi stabilire se ti è utile consentire a IBM di eseguire il rollback dell'aggiornamento. Previo accordo, IBM esegue il rollback dell'aggiornamento per ripristinare l'ambiente allo stato precedente. - -## Risposta e supporto agli incidenti per {{site.data.keyword.Bluemix_dedicated_notm}} -{: #incidentresponse} - -### Problemi rilevati dal cliente - -Se identifichi un problema che richiede un intervento e attenzione da parte del supporto IBM, puoi contattarlo in vari modi. Per informazioni su come contattare il supporto, vedi [Come contattare il supporto](../support/index.html#contacting-bluemix-support-local). A seconda del problema, dovrà essere risolto da te e/o da IBM. - -### Incidenti critici rilevati da IBM - -Gli incidenti critici sono interruzioni dei servizi impreviste con carattere d'urgenza e problemi di stabilità che colpiscono il tuo ambiente o i tuoi utenti. Se IBM individua un incidente critico nel proprio ambiente, te lo comunica tramite notifica nella pagina **Stato**. Puoi consultare la pagina Stato anche per eventuali problemi noti relativi alla piattaforma o ai tuoi servizi. Per ulteriori informazioni sulla pagina Stato, consulta [Visualizzazione dello stato](../admin/index.html#oc_status). - -Se desideri integrare le tue notifiche con un servizio Web che supporti gli hook Web, vedi [Notifiche e sottoscrizioni di eventi](../admin/index.html#oc_eventsubscription) per informazioni su come estendere le funzioni di notifica. - -![Processo di risposta agli eventi incidenti](../local/images/incidentresponseprocess.png "Processo di risposta agli incidenti") - -Figura 2. Processo di risposta agli incidenti - -A seconda del problema, dovrà essere risolto da te e/o da IBM. Se hai domande sull'incidente o se hai bisogno che un rappresentante IBM ti aiuti a risolvere il problema, puoi aprire un ticket di supporto. Per informazioni su come contattare il supporto, vedi [Come contattare il supporto](/docs/support/index.html#contacting-bluemix-support-local). - -**Nota**: i ticket di supporto con severità 1 vengono monitorati 24 ore al giorno, 7 giorni a settimana. Gli altri ticket vengono elaborati dalle 22:00 GMT di domenica alle 12:00 GMT di sabato. Per ulteriori informazioni sulla severità dei ticket di supporto e sull'utilizzo del supporto, vedi Come contattare il supporto. - - -## Ripristino di emergenza per {{site.data.keyword.Bluemix_dedicated_notm}} -{: #dr} - -Il ripristino di emergenza per {{site.data.keyword.Bluemix_short}} dedicato può essere configurato in modo analogo a quello valido quando si utilizza {{site.data.keyword.Bluemix_short}} pubblico. {{site.data.keyword.Bluemix_short}} pubblico fornisce una piattaforma costantemente disponibile per l'innovazione con più misure di sicurezza per garantire che le tue organizzazioni, i tuoi spazi e le tue applicazioni siano sempre disponibili. La distribuzione delle applicazioni in più regioni geografiche consente una disponibilità continua che protegge contro l'imprevista perdita simultanea di più componenti hardware o software o la perdita di un intero data center; in tal modo, anche in caso di catastrofe naturale in una posizione geografica, le istanze distribuite della tua applicazione {{site.data.keyword.Bluemix_notm}} pubblico saranno disponibili in posizioni geografiche alternative. -{: shortdesc} - -Il ripristino di emergenza per {{site.data.keyword.Bluemix_short}} dedicato è reso possibile grazie alla disponibilità continua per le tue applicazioni, all'alta disponibilità intrinseca della piattaforma e alla possibilità di ripristinare l'istanza in caso di errore. Sei responsabile dell'abilitazione della disponibilità continua delle tue applicazioni mediante la distribuzione a più regioni. L'alta disponibilità viene integrata a livello della piattaforma tramite le tecnologie incluse in Cloud Foundry e altri componenti. Inoltre, puoi collaborare con IBM per assicurarti che il backup dei tuoi dati venga eseguito correttamente nel caso in cui sia necessario ripristinare la tua istanza. - -### Abilitazione della disponibilità continua per {{site.data.keyword.Bluemix_dedicated_notm}} -{: #enabling} - -Per impostazione predefinita, {{site.data.keyword.Bluemix_notm}} pubblico viene distribuito in più posizioni geografiche. Tuttavia, per abilitare le istanze {{site.data.keyword.Bluemix_dedicated_notm}} distribuite a livello globale, devi effettuare le seguenti attività: - -* Assicurati che gli sviluppatori stiano distribuendo le applicazioni in più di una regione, mediante un processo manuale o automatico. Le regioni dovrebbero trovarsi a più di 200 km di distanza l'una dall'altra per garantire che, in caso di catastrofe naturale, non vengano colpite entrambe le posizioni geografiche. -* Configurare un programma di bilanciamento del carico globale, come Akamai o Dyn, per puntare ad applicazioni in almeno due regioni diverse. - -**Nota**: non tutti i servizi {{site.data.keyword.Bluemix_notm}} supportano la distribuzione regionale. Quando crei un'applicazione, se vuoi garantire una distribuzione geografica, devi fare in modo che i servizi utilizzati dall'applicazione abbiano come funzione fondamentale la sincronizzazione dei dati. - -#### Distribuzione di applicazioni {{site.data.keyword.Bluemix_dedicated_notm}} in più posizioni geografiche -{: #deploying} - -Per eseguire la distribuzione in una seconda posizione o in più posizioni, devi seguire un processo simile a quello effettuato per abilitare la posizione geografica primaria: - -1. Abilita un nuovo ambiente dedicato per ospitare istanze aggiuntive delle tue applicazioni. Per creare un nuovo ambiente, contatta il team del settore vendite IBM per avviare il processo. Per ulteriori informazioni sulla configurazione di un'istanza dedicata, vedi [Configurazione di {{site.data.keyword.Bluemix_dedicated_notm}}](/docs/dedicated/index.html#setupdedicated). Devi effettuare un accesso distinto per ogni ambiente. Ciascuna posizione fisica degli ambienti host deve trovarsi ad almeno 200 km di distanza dalla posizione originale per garantire la disponibilità. -2. Ottieni il nome di dominio univoco in cui verrà ospitata la tua nuova applicazione distribuita. Ad esempio, se il dominio originale è *mycompany.caeast.bluemix.net*, puoi creare un nuovo ambiente locale con un nuovo dominio come, ad esempio, *mycompany.cawest.bluemix.net* e distribuire al nuovo dominio. -3. Ogni volta che distribuisci l'applicazione originale, esegui anche la distribuzione nella nuova posizione. Per ulteriori informazioni sulla distribuzione, vedi [Caricamento della tua applicazione](/docs/starters/upload_app.html). - - -#### Abilitazione di un programma di bilanciamento del carico globale per {{site.data.keyword.Bluemix_dedicated_notm}} -{: #glb} - -Un programma di bilanciamento del carico globale non solo garantisce la disponibilità continua ed è richiesto per il ripristino di emergenza, ma presenta anche diversi vantaggi aggiuntivi: - -* Indirizza gli utenti alla regione {{site.data.keyword.Bluemix_notm}} più vicina per impostazione predefinita -* Indirizza in base alle prestazioni -* Instrada selettivamente una percentuale di traffico a una nuova versione dell'applicazione -* Fornisce il failover del sito in base alla verifica dell'integrità della regione -* Fornisce il failover del sito in base alla verifica dell'integrità dell'applicazione -* Utilizza un instradamento ponderato tra gli endpoint - -Puoi scegliere un programma di bilanciamento del carico globale come Akamai o Dyn. Per ulteriori informazioni sull'utilizzo di Akamai come programma di bilanciamento del carico globale, vedi [Global traffic management ![icona link esterno](../icons/launch-glyph.svg)](https://www.akamai.com/us/en/solutions/products/web-performance/global-traffic-management.jsp "Opens in new window"){: new_window}. Per ulteriori informazioni sull'utilizzo di Dyn come programma di bilanciamento del carico globale, vedi [4 Reasons Businesses Are Taking Global Load Balancing to the Cloud ![icona link esterno](../icons/launch-glyph.svg)](http://dyn.com/blog/4-reasons-businesses-are-taking-global-load-balancing-to-the-cloud/){: new_window}. - -### Alta disponibilità -{: #ha} - -Oltre a consentire la disponibilità continua, {{site.data.keyword.Bluemix_notm}} fornisce anche l'alta disponibilità in tutta la piattaforma utilizzando le tecnologie integrate in Cloud Foundry e altri componenti. - -Queste tecnologie includono: - -
-
Scalabilità in Cloud Foundry DEA
-
Un DEA (Droplet Execution Agent) icona link esterno Cloud Foundry effettua verifiche dell'integrità nelle applicazioni eseguite al suo interno. Se si verifica un problema con l'applicazione o con lo stesso DEA, distribuisce ulteriori istanze dell'applicazione a un DEA alternativo per risolvere il problema. Per ulteriori informazioni, vedi Configuring CF for High Availability with Redundancy icona link esterno. -

Per garantire l'elevata disponibilità per le tue applicazioni, hai bisogno di abbastanza risorse di elaborazione per bilanciare il carico e puoi inoltre richiederne ulteriori per supportare un possibile malfunzionamento. Se hai bisogno di ridimensionare il tuo ambiente incrementando il tuo pool DEA in modo da essere preparato a un malfunzionamento o per affrontare un'anomalia durante il caricamento delle tue istanze dell'applicazione, puoi collaborare con il tuo rappresentante IBM per ordinare ulteriori DEA e per verificare di avere l'hardware appropriato per supportare le risorse aggiunte. -

-
-
Ridondanza {{site.data.keyword.BluSoftlayer}}
-
Con {{site.data.keyword.BluSoftlayer}} negli ambienti dedicati, i dati presenti in ciascun cluster di archiviazione cloud vengono scritti più volte e i cluster di archiviazione sono configurati con capacità di riparazione automatica in caso di guasto dell'unità. Se si verifica un problema con un server virtuale, {{site.data.keyword.BluSoftlayer}} prova a riavviarlo in un altro host.
-
Backup dei metadati
-
I metadati vengono sottoposti a backup mediante il sistema {{site.data.keyword.BluSoftlayer}} EVault Backup in una posizione che si trova ad almeno 200 km di distanza.
-
- -##Ripristino della tua istanza dedicata -{: #restorededicated} - -Il backup di impostazioni, metadati e configurazioni di {{site.data.keyword.Bluemix_dedicated_notm}} viene eseguito periodicamente come tutela in caso di eventuali interruzioni non pianificate nell'ambiente. I dati per i quali sei responsabile del backup includono i dati dell'applicazione, i dati dei servizi del database cloud e gli archivi oggetti. - -Come parte del backup dei dati, che include i metadati del sistema e le configurazioni, IBM completa le seguenti attività: - -
    -
  • Crittografa tutte le copie di backup e gestisce le chiavi di crittografia
    • -
  • Monitora e gestisce l'attività di backup
    • -
  • Fornisce i file di backup crittografati
    • -
  • Ripristina i dati richiesti
    • -
  • Gestisce i conflitti di pianificazione tra le operazioni di gestione dei backup e delle correzioni
    • -
- -Poiché la protezione dei dati privati è di importanza critica, IBM ha bisogno della tua collaborazione quando si occupa della gestione dei file di backup in modo che i file non vengano spostati all'esterno dei tuoi data center. Nello specifico, IBM richiede che tu completi le seguenti attività: - -
    -
  • Spostare una copia dei tuoi dati di backup crittografati fuori sede, proprio come faresti per qualsiasi altro dato di backup da te gestito.
    • -
  • Fornire i file di backup per l'operatore IBM nel caso occorra eseguire un ripristino.
    • -
- -# rellinks -{: rellinks} -## general -{: general} -* [Scopri: {{site.data.keyword.Bluemix_dedicated_notm}}](http://www.ibm.com/cloud-computing/bluemix/hybrid/dedicated/) -* [Novità in {{site.data.keyword.Bluemix_notm}}](/docs/whatsnew/index.html) -* [{{site.data.keyword.Bluemix_notm}} glossario](/docs/overview/glossary/index.html) -* [Gestione di {{site.data.keyword.Bluemix_notm}} locale e {{site.data.keyword.Bluemix_dedicated_notm}}](/docs/admin/index.html#mng) -* [Come contattare il supporto](/docs/support/index.html#getting-customer-support) +--- + + + +copyright: + + years: 2015, 2017 + +lastupdated: "2017-01-11" + +--- + +{:shortdesc: .shortdesc} + +# {{site.data.keyword.Bluemix_dedicated_notm}} +{: #dedicated} + + +{{site.data.keyword.Bluemix}} è +una piattaforma basata su cloud open standard per la creazione, esecuzione e +gestione delle applicazioni. Con {{site.data.keyword.Bluemix_dedicated_notm}}, ottieni la potenza unita alla semplicità di {{site.data.keyword.Bluemix_notm}}— nel tuo ambiente SoftLayer dedicato che è connesso in modo protetto sia all'ambiente {{site.data.keyword.Bluemix_notm}} pubblico sia alla tua rete. +{:shortdesc} + +Tutte le distribuzioni dedicate di {{site.data.keyword.Bluemix_notm}} includono i seguenti vantaggi e le seguenti funzioni senza alcun costo aggiuntivo: VPN, VLAN (virtual local area network) privata, firewall, connettività al tuo LDAP, possibilità di avvalerti dei database e delle applicazioni installati in loco già esistenti, sicurezza in loco 24 ore al giorno, 7 giorni su 7, hardware dedicato e supporto standard. + +Per impostazione predefinita, l'accesso alla tua istanza privata di {{site.data.keyword.Bluemix_notm}} è possibile solo dalla tua rete aziendale. Se hai bisogno che il tuo ambiente {{site.data.keyword.Bluemix_notm}} sia accessibile direttamente da Internet, da un dispositivo mobile o da un database dedicato, è richiesto un ulteriore componente per la sicurezza di rete disponibile a un costo aggiuntivo. + +{{site.data.keyword.Bluemix_dedicated_notm}} viene fornito con tutti i runtime {{site.data.keyword.Bluemix_notm}} inclusi e 64 GB di memoria per le risorse di calcolo. + +Inoltre, è presente una serie di servizi e componenti inclusi oppure facoltativi che è possibile acquistare. Consulta la seguente tabella per vedere cosa è incluso e cosa puoi, facoltativamente, acquistare. + +| **Tipo** | **Nome** | **Descrizione** | +|-----------------|-------------------|-------------------| +|Incluso | [Runtime {{site.data.keyword.Bluemix_notm}}](/docs/cfapps/runtimes.html) | Utilizza i runtime per avere un'applicazione subito operativa, senza dover impostare e gestire macchine e sistemi operativi. Tutti i runtime {{site.data.keyword.Bluemix_notm}} sono a tua disposizione per utilizzarli nella tua istanza di {{site.data.keyword.Bluemix_dedicated_notm}}.| +| Incluso | [{{site.data.keyword.autoscaling}}](/docs/services/Auto-Scaling/index.html) | Ti permette di aumentare o ridurre dinamicamente la capacità +di elaborazione della tua applicazione in base alle politiche. Con questo servizio, hai un uso illimitato nel tuo ambiente {{site.data.keyword.Bluemix_dedicated_notm}}. Nota: Auto-scaling attualmente funziona solo con i runtime Cloud Foundry | +|Facoltativo | [{{site.data.keyword.apiconnect_short}}](/docs/services/apiconnect/index.html) | {{site.data.keyword.apiconnect_long}} integra {{site.data.keyword.APIM}} e IBM StrongLoop in una singola offerta che fornisce una soluzione completa per creare, eseguire, gestire e implementare API e microservizi. | +|Facoltativo | [{{site.data.keyword.rules_short}}](/docs/services/rules/rules.html) | {{site.data.keyword.rules_short}} offre un ambiente completo per automatizzare ed eseguire le frequenti decisioni di business basate su regole ripetibili. Consente inoltre agli utenti o sviluppatori di business di modellare rapidamente le decisioni e di testarle a costi più bassi, riducendo la necessità di competenze IT. | +|Facoltativo | [{{site.data.keyword.cloudant}}](/docs/services/Cloudant/index.html#Cloudant) | {{site.data.keyword.cloudant}} fornisce l'accesso a un livello di dati JSON NoSQL interamente gestito sempre attivo. Questo servizio è compatibile con CouchDB e accessibile mediante un'interfaccia HTTP di facile utilizzo per i modelli di applicazione web e mobile. | +|Facoltativo | [{{site.data.keyword.containershort}}](/docs/containers/container_index.html) | Esegui i contenitori Docker su {{site.data.keyword.Bluemix_dedicated_notm}}. I contenitori sono oggetti software virtuali che includono tutti gli elementi che un'applicazione deve eseguire. Un contenitore presenta i vantaggi dell'isolamento e dell'assegnazione delle risorse, ma offre una maggiore portabilità ed efficienza rispetto, ad esempio, a una macchina virtuale. Per informazioni sui requisiti hardware, vedi [IBM {{site.data.keyword.containershort}} in {{site.data.keyword.Bluemix_dedicated_notm}} e Bluemix locale](/docs/containers/container_dl.html).| +| Facoltativo | [{{site.data.keyword.contdelivery_short}}](/docs/services/ContinuousDelivery/index.html) | Utilizza {{site.data.keyword.contdelivery_short}} dedicato per automatizzare le build, i test di unità, le distribuzioni e altro. Modifica e trasmetti il codice tramite la IDE basata sul web avanzato. Crea le toolchain per abilitare le integrazioni dello strumento che supportano attività di sviluppo, distribuzione e operative. | +| Facoltativo | [{{site.data.keyword.dashdbshort}}](/docs/services/dashDB/dashDB.html) | IBM {{site.data.keyword.dashdbshort}} for Analytics è un servizio di database cloud SQL interamente gestito, ottimizzato per i carichi di lavoro di data warehouse e analisi. IBM {{site.data.keyword.dashdbshort}} for Transactions è un servizio di database cloud SQL interamente gestito, ottimizzato per l'uso generale, le applicazioni Web e i carichi di lavoro transazionali. | +| Facoltativo | [{{site.data.keyword.datacshort}}](/docs/services/DataCache/index.html#data_cache) | Questo servizio fornisce una griglia di dati in memoria +che supporta scenari di cache distribuita per le tue applicazioni. Include +50 GB di cache in memoria. | +| Facoltativo | [Dedicated GitHub Enterprise](/docs/services/ghededicated/index.html) | {{site.data.keyword.ghe_long}} è la versione di GitHub Enterprise completamente gestita e ospitata da IBM Cloud che fornisce l'esperienza di social networking che piace agli sviluppatori. Questo servizio è al momento disponibile solo per gli ambienti di {{site.data.keyword.Bluemix_dedicated_notm}}. | +| Facoltativo (beta) | [Registrazione](/docs/monitoringandlogging/cfapps_ml_logs_dedicated_ov.html#container_ml_logs_dedicated_ov) | Fornisce log per le tue applicazioni Cloud Foundry nella tua interfaccia utente {{site.data.keyword.Bluemix_notm}} e nei tuoi dashboard e log con funzione di ricerca in Kibana. | +| Facoltativo | [{{site.data.keyword.messagehub}}](/docs/services/MessageHub/index.html#messagehub) | {{site.data.keyword.messagehub}} è un bus di messaggi a velocità elevata scalabile e distribuito per unire le tue tecnologie installate in loco con quelle installate invece altrove. {{site.data.keyword.messagehub}} è basato su Apache Kafka, che è un motore di messaggistica in tempo reale rapido, scalabile e durevole. | +|Facoltativo | [{{site.data.keyword.mobilepush}}](/docs/services/mobilepush/index.html) | {{site.data.keyword.mobilepush}} è un servizio che puoi utilizzare per inviare notifiche a dispositivi iOS e Android. Le notifiche possono essere destinate a tutti gli utenti dell'applicazione oppure a uno specifico insieme di utenti e dispositivi facendo uso delle tag. Puoi amministrare i dispositivi, le tag e le sottoscrizioni. Puoi anche utilizzare API (application program interface) REST (Representational State Transfer) e SDK (software development kit) per sviluppare ulteriormente le tue applicazioni client.| +|Facoltativo | [{{site.data.keyword.SecureGateway}}](/docs/services/SecureGateway/secure_gateway.html) | Il servizio {{site.data.keyword.SecureGateway}} fornisce un modo sicuro per connettere le applicazioni {{site.data.keyword.Bluemix_notm}} da posizioni remote installate in loco o nel cloud. | +|Facoltativo | [{{site.data.keyword.sescashort}}](/docs/services/SessionCache/index.html#session_cache) | Per aumentare la ridondanza, {{site.data.keyword.sescashort}} fornisce una replica di una sessione memorizzata nella cache. Pertanto, nel caso di un'interruzione o di un calo di tensione, la tua applicazione client mantiene l'accesso alla sessione nella cache. Il servizio supporta scenari di memorizzazione di sessioni nella cache per applicazioni Web e mobili. | +| Facoltativo | [{{site.data.keyword.iot_short}}](/docs/services/IoT/index.html) | Questo servizio consente alle tue applicazioni di comunicare tra loro e utilizzare i dati raccolti dai tuoi dispositivi, sensori e gateway connessi. L'offerta di base consente l'esecuzione di una versione privata di {{site.data.keyword.iot_short}} nell'ambiente dedicato con una capacità di 100,000 applicazioni o dispositivi connessi contemporaneamente e 1.6 TB di scambio dati. | +| Facoltativo | [{{site.data.keyword.appserver_short}}](/docs/services/ApplicationServeronCloud/index.html) | IBM {{site.data.keyword.appserver_short}} per IBM {{site.data.keyword.Bluemix_notm}} è un servizio che aiuta nella configurazione rapida di un'istanza {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment o Traditional WebSphere Java EE preconfigurata in un ambiente cloud ospitato su {{site.data.keyword.Bluemix_notm}}. | +{: caption="Table 1. Dedicated Services" caption-side="top"} +{: #table01} + + + +Sono presenti dei componenti facoltativi disponibili per te da acquistare per ridimensionare e estendere la capacità dei tuoi servizi o risorse. Puoi acquistare tutti questi componenti contattando il team di vendite; vai all'indirizzo [Contattaci](https://console.ng.bluemix.net/?direct=classic/#/contactUs/cloudOEPaneId=contactUs) per informazioni su come contattare un rappresentante delle vendite. Per incrementare il tuo piano per un servizio, puoi selezionare il piano dal tile del servizio nel tuo catalogo. + +| **Nome** | **Descrizione** | +|-------------------|-------------------| +|5 milioni di chiamate API dedicate per {{site.data.keyword.apiconnect_short}} Professional | Un ambiente che consente l'esecuzione di una versione privata di {{site.data.keyword.apiconnect_short}} all'interno dell'ambiente dedicato con una capacità di 5 milioni di chiamate API al mese, destinate a progetti API del reparto. | +|Incremento di 100.000 chiamate API dedicate per {{site.data.keyword.apiconnect_short}} Professional | Un'estensione dell'ambiente {{site.data.keyword.apiconnect_short}} Professional che fornisce una capacità supplementare di 100.000 chiamate API al mese. | +|25 milioni di chiamate API dedicate per {{site.data.keyword.apiconnect_short}} Enterprise | Un ambiente che consente l'esecuzione di una versione privata di {{site.data.keyword.apiconnect_short}} all'interno dell'ambiente dedicato con una capacità di 25 milioni di chiamate API al mese, destinate a progetti API di tutta l'azienda. | +|Incremento di 100.000 chiamate API dedicate per {{site.data.keyword.apiconnect_short}} Enterprise | Un'estensione dell'ambiente {{site.data.keyword.apiconnect_short}} Enterprise che fornisce una capacità supplementare di 100.000 chiamate API al mese. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.rules_short}} 1 Million Rules Decisions | Una decisione di regole è il risultato della chiamata di una serie di regole da un Rule Execution Server. È necessario ottenere i diritti sufficienti per ricoprire il numero totale di decisioni di regole, arrotondato al milione, eseguite o elaborate, durante il periodo di fatturazione. Le decisioni di regole misurate da questo servizio cloud sono le chiamate effettuate al Rule Execution Server per ottenere una decisione. | +|Incremento della capacità di 16 TB dedicato per {{site.data.keyword.cloudant}} | Include l'esecuzione di una versione privata di {{site.data.keyword.cloudantfull}} nell'ambiente dedicato con una capacità di 1.6 terabyte. | +|Incremento della capacità di 50 GB dedicato per {{site.data.keyword.datacshort}} e {{site.data.keyword.sescashort}} | Un ambiente che consente la distribuzione e l'esecuzione di istanze {{site.data.keyword.datacshort}} e {{site.data.keyword.sescashort}} fino a una capacità cumulativa di 50 GB. | +|Istanza di {{site.data.keyword.contdelivery_short}} dedicato | Una versione privata di {{site.data.keyword.contdelivery_short}} in esecuzione all'interno di un ambiente dedicato. La capacità è determinata dai diritti dell'utente autorizzato di {{site.data.keyword.contdelivery_short}} dedicato. | +|Utente autorizzato di {{site.data.keyword.contdelivery_short}} dedicato | Concede l'accesso e l'utilizzo di un ambiente {{site.data.keyword.contdelivery_short}} dedicato designato a un utente autorizzato. Ogni utente appartenente a un'organizzazione {{site.data.keyword.Bluemix_notm}} che contiene un'istanza del servizio {{site.data.keyword.contdelivery_short}} deve essere autorizzato. | +|Dedicato per {{site.data.keyword.dashdbshort}} Enterprise 64.1 | Un database per istanza del servizio su un server dedicato con 64 GB RAM e 16 vCPU. Raccomandato fino a un 1 TB di precaricamento dati, in base alla compressione standard. | +|Dedicato per {{site.data.keyword.dashdbshort}} Enterprise 256.4 | Un database per istanza del servizio su un server dedicato 256 GB RAM e 32 core. Raccomandato fino a un 4 TB di precaricamento dati, in base alla compressione standard. | +|Dedicato per {{site.data.keyword.dashdbshort}} Enterprise 256.12 | Un database per istanza del servizio su un server dedicato 256 GB RAM e 32 core. Raccomandato fino a un 12 TB di precaricamento dati, in base alla compressione standard. Questo è un piano ad alta densità di memorizzazione per gli ambienti in cui i volumi di dati sono elevati e non è necessario eseguire le query alle velocità in memoria. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions 2.8.500 | Istanza dedicata che supporta carichi di lavoro OLTP (Online Transaction Processing) con 8 GB di RAM e 500 GB di spazio per dati e log. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions 12.128.1400 | Istanza dedicata che supporta carichi di lavoro OLTP (Online Transaction Processing) con 128 GB di RAM e 1,4 TB di archiviazione SSD per dati e log. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions High Availability 2.8.500 | Istanza dedicata che supporta carichi di lavoro OLTP (Online Transaction Processing) con 8 GB di RAM e 500 GB di spazio per dati e log e che include un ulteriore server di standby per l'alta disponibilità. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.dashdbshort}} Enterprise for Transactions High Availability 12.128.1400 | Istanza dedicata che supporta carichi di lavoro OLTP (Online Transaction Processing) con 128 GB di RAM e 1,4 TB di archiviazione SSD per dati e log e che include un ulteriore server di standby per l'alta disponibilità. | +|Servizi di community {{site.data.keyword.Bluemix_dedicated_notm}} | Un ambiente che consente la distribuzione e l'esecuzione di servizi di community fino a un totale di 50 istanze per ogni servizio di community. | +|Istanza cluster {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.cloudant}} | Questo componente facoltativo include un cluster a 3 nodi per il quale sei responsabile di fornire l'infrastruttura e dove la capacità di archiviazione e di calcolo può essere determinata sulla base delle tue specifiche esigenze. {{site.data.keyword.cloudant}} fornisce l'accesso a un livello di dati JSON NoSQL interamente gestito sempre attivo. Questo servizio è compatibile con CouchDB e accessibile mediante un'interfaccia HTTP di facile utilizzo per i modelli di applicazione web e mobile. | +|IBM {{site.data.keyword.Bluemix_dedicated_notm}} {{site.data.keyword.messagehub}} | Un ambiente che fornisce messaggistica di sottoscrizione e pubblica fino a 10 GB per partizione. I messaggi vengono conservati e sono disponibili per l'utilizzo per un massimo di 24 ore. | +|IBM Bluemix Dedicated {{site.data.keyword.mobilepushshort}} | Un ambiente che consente la distribuzione e l'esecuzione di istanze {{site.data.keyword.mobilepushshort}} con la capacità di accettare 300 richieste al secondo. | +|Aumento incrementale dedicato per {{site.data.keyword.iot_short}} | Un incremento dell'ambiente che consente l'esecuzione di una versione privata di {{site.data.keyword.iot_short}} nell'ambiente dedicato con una capacità di 100,000 applicazioni o dispositivi connessi contemporaneamente e 0.5 TB di scambio dati. | +|IBM {{site.data.keyword.appserver_short}} per {{site.data.keyword.Bluemix_notm}} - Dedicato Small| Un'istanza {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment o Traditional WebSphere Java EE preconfigurata in un ambiente cloud ospitato su {{site.data.keyword.Bluemix_notm}} con 64 vCore, 128GB RAM e 1TB HDD al mese. | +|IBM {{site.data.keyword.appserver_short}} per {{site.data.keyword.Bluemix_notm}} - Dedicato Medium| Un'istanza {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment o Traditional WebSphere Java EE preconfigurata in un ambiente cloud ospitato su {{site.data.keyword.Bluemix_notm}} con 128 vCore, 256GB RAM e 2TB HDD al mese. | +|IBM {{site.data.keyword.appserver_short}} per {{site.data.keyword.Bluemix_notm}} - Dedicato Large| Un'istanza {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment o Traditional WebSphere Java EE preconfigurata in un ambiente cloud ospitato su {{site.data.keyword.Bluemix_notm}} con 256 vCore, 512GB RAM e 4TB HDD al mese. | +|IBM {{site.data.keyword.appserver_short}} for {{site.data.keyword.Bluemix_notm}} - Dedicato| Un'istanza {{site.data.keyword.appserver_short}} Liberty, Traditional Network Deployment o Traditional WebSphere Java EE preconfigurata in un ambiente cloud ospitato su {{site.data.keyword.Bluemix_notm}} con HDD Expansion e 1TB al mese. | +{: caption="Table 2. Optional service components for purchase" caption-side="top"} +{: #table02} + + + +| **Nome** | **Descrizione** | +|-------------------|-------------------| +|Incremento della capacità di 16 GB dedicato per i runtime | Un'estensione dell'ambiente dei runtime che fornisce una capacità di runtime extra di 16 GB. | +|Capacità di 1 Gbps dedicata per Direct Link | Un link di rete dedicato che si connette direttamente al POP (point of presence) di rete {{site.data.keyword.BluSoftlayer}} designato per i trasferimenti dati fino a 1 Gbps. | +|Capacità di 10 Gbps dedicata per Direct Link | Un link di rete dedicato che si connette direttamente al POP (point of presence) di rete {{site.data.keyword.BluSoftlayer}} designato per i trasferimenti dati fino a 10 Gbps. | +|Firewall hardware per IBM Bluemix dedicato - elevata disponibilità | Un firewall hardware di 1 Gbps ridondante configurato per la protezione di uno, alcuni o tutti i server nella stessa VLAN nell'ambiente dedicato. | +{: caption="Table 3. Optional platform add-on components for purchase" caption-side="top"} +{: #table03} + +**Nota**: i componenti di {{site.data.keyword.Bluemix_dedicated_notm}} possono indicare una capacità configurata specifica, come ad esempio gigabyte o transazioni al secondo. Poiché la capacità attuale messa in pratica per ogni configurazione del servizio cloud varia in base a molti fattori, la capacità attuale messa in pratica può essere maggiore o inferiore alla capacità configurata. + +### Catalogo diffuso +{: #catalogdedicated} + +{{site.data.keyword.Bluemix_dedicated_notm}} include un catalogo privato che riunisce i servizi approvati tra le tue distribuzioni pubbliche, dedicate e locali. Puoi anche pubblicare e gestire l'accesso ai tuoi servizi tramite il catalogo {{site.data.keyword.Bluemix_notm}}. Hai la possibilità di decidere quali servizi pubblici rispondono ai tuoi requisiti aziendali, sulla base di criteri di sicurezza e privacy dei dati. + +Se disponi di un'istanza privata del servizio per il tuo ambiente dedicato, vedi una tag "Dedicato" con i nomi del servizio nel tuo catalogo. Allo stesso modo, se si tratta di un servizio personalizzato, il che significa che hai utilizzato un broker dei servizi per crearlo, vedi "Personalizzato" elencato insieme al nome del servizio. Tutti gli altri servizi elencati che non presentano una tag "dedicato" o "personalizzato" sono disponibili tramite la diffusione da {{site.data.keyword.Bluemix_notm}} pubblico. I servizi diffusi forniscono la funzione per creare applicazioni ibride composte da servizi pubblici e privati. + +|Servizio |Disponibile nella regione Stati Uniti Sud |Disponibile nella regione Europa Regno Unito |Disponibile nella regione di Sydney in Australia| +|:----------|:------------------------------|:------------------|:------------------| +|{{site.data.keyword.alchemyapishort}} |Sì |Sì |Sì| +|{{site.data.keyword.alertnotificationshort}} |Sì |Sì |Sì | +|{{site.data.keyword.apiconnect_short}} |Sì |Sì |Sì | +|{{site.data.keyword.appseccloudshort}} |Sì |Sì |Sì | +|{{site.data.keyword.apiconnect_short}} |Sì |Sì |Sì | +|Automated Accessibility Checker |Sì |Sì |Sì | +|{{site.data.keyword.rules_short}} |Sì |Sì |Sì | +|{{site.data.keyword.cloudant}} |Sì |Sì |Sì | +|{{site.data.keyword.iotmapinsights_short}} |Sì |Sì |Sì | +|{{site.data.keyword.conversationshort}} |Sì |Sì |Sì | +|{{site.data.keyword.dashdbshort}} |Sì |Sì |Sì | +|{{site.data.keyword.dataworks_short}} |Sì |Sì |No| +|{{site.data.keyword.DB2OnCloud_short}} |Sì |Sì |Sì | +|Digital Content Checker |Sì |Sì |Sì | +|{{site.data.keyword.documentconversionshort}} |Sì |Sì |Sì| +|{{site.data.keyword.iotdriverinsights_short}} |Sì |Sì |Sì | +|{{site.data.keyword.geospatialshort_Geospatial}} |Sì |Sì |Sì | +|{{site.data.keyword.GlobalizationPipeline_short}} |Sì | Sì | Sì | +|{{site.data.keyword.identitymixershort}} |Sì |Sì |Sì| +|{{site.data.keyword.iot4auto_short}} |Sì |Sì |Sì | +|{{site.data.keyword.iotelectronics}} |Sì |Sì |No | +|{{site.data.keyword.iotinsurance_short}} |No |No |Sì | +|{{site.data.keyword.twittershort}} |Sì |Sì |Sì| +|{{site.data.keyword.languagetranslationshort}} |Sì |Sì |Sì | +|{{site.data.keyword.languagetranslatorshort}} |Sì |Sì |Sì | +|{{site.data.keyword.dwl_short}} |Sì |Sì |No | +|{{site.data.keyword.eventhubshort}} |Sì |No |No| +|{{site.data.keyword.messagehub}} |Sì |Sì |No| +|{{site.data.keyword.manda}} |Sì |Sì |Sì | +|{{site.data.keyword.amashort}} |Sì |Sì |Sì | +|{{site.data.keyword.mqa}} |Sì |Sì |Sì | +|{{site.data.keyword.mql}} |No |No |Sì | +|{{site.data.keyword.nlclassifierlshort}} |Sì |Sì |Sì| +|{{site.data.keyword.personalityinsightsshort}} |Sì |Sì |Sì| +|{{site.data.keyword.pm_short}} |Sì |Sì |No | +|{{site.data.keyword.mobilepush}} |Sì |Sì |Sì | +|{{site.data.keyword.retrieveandrankshort}} |Sì |Sì |Sì| +|{{site.data.keyword.runbook_short}} |Sì |Sì |Sì| +|{{site.data.keyword.SecureGateway}} |Sì |Sì |Sì | +|{{site.data.keyword.ssofull}} |Sì |No |No| +|{{site.data.keyword.speechtotextshort}} |Sì |Sì |Sì| +|{{site.data.keyword.streaminganalyticsshort}} |Sì |Sì |Sì | +|{{site.data.keyword.texttospeechshort}} |Sì |Sì |Sì| +|{{site.data.keyword.toneanalyzershort}} |Sì |Sì |Sì| +|{{site.data.keyword.tradeoffanalyticsshort}} |Sì |Sì |Sì| +|{{site.data.keyword.visualrecognitionshort}} |Sì |Sì |Sì| +|{{site.data.keyword.iot_short}} |Sì |Sì |No| +|{{site.data.keyword.weather_short}} |Sì |Sì |Sì| +|{{site.data.keyword.workloadscheduler}} |Sì |Sì |Sì | +{: caption="Table 4. Services available for syndication from {{site.data.keyword.Bluemix_notm}} Public by region" caption-side="top"} +{: #table04} + +**Nota**: i servizi di terze parti non sono inclusi nella tabella. Controlla il tuo catalogo dedicato per le opzioni dei servizi di terze parti. + + + +## Architettura di {{site.data.keyword.Bluemix_dedicated_notm}} +{: #dedicatedarch} + +{{site.data.keyword.Bluemix_dedicated_notm}} può essere distribuito in qualsiasi [data center {{site.data.keyword.IBM_notm}} SoftLayer ![icona link esterno](../icons/launch-glyph.svg)](http://www.softlayer.com/data-centers){: new_window} in tutto il mondo. {{site.data.keyword.IBM_notm}} SoftLayer fornisce l'infrastruttura cloud dalle prestazioni più elevate. Ciascun data center fornisce rigorosi controlli di sicurezza 24 ore al giorno, 7 +giorni a settimana. + +Ogni distribuzione di {{site.data.keyword.Bluemix_dedicated_notm}} è dedicata a una singola azienda sull'hardware dedicato di {{site.data.keyword.IBM_notm}} SoftLayer nella sua propria rete privata. Gli ambienti di {{site.data.keyword.Bluemix_dedicated_notm}} hanno gli stessi standard di sicurezza di {{site.data.keyword.Bluemix_notm}} pubblico in termini di sicurezza fisica, operativa e di infrastruttura. Tuttavia, +l'accesso degli sviluppatori a {{site.data.keyword.Bluemix_notm}} dedicato è +controllato dalle tue politiche LDAP, che possono essere configurate dal team di {{site.data.keyword.Bluemix_notm}} +nel momento in cui configurano il tuo ambiente. All'interno dell'ambiente dedicato, +puoi gestire i ruoli e le autorizzazioni degli utenti. Per i dettagli, vedi [Gestione di utenti e autorizzazioni](/docs/admin/index.html#oc_useradmin). La seguente figura mostra l'architettura logica di una distribuzione {{site.data.keyword.Bluemix_dedicated_notm}} predefinita. + +![{{site.data.keyword.Bluemix_dedicated_notm}}](images/bm_dedicated_arch.png "Architettura predefinita {{site.data.keyword.Bluemix_dedicated_notm}}") + +Figura 1. Diagramma dettagliato dell'architettura predefinita di {{site.data.keyword.Bluemix_dedicated_notm}} +{: #figure01} + +I componenti architetturali importanti mostrati nel precedente diagramma dell'architettura sono i seguenti: + +
+
{{site.data.keyword.IBM_notm}} Cloud
+
+L'ambiente cloud {{site.data.keyword.IBM_notm}} nel suo insieme include i seguenti ambienti di rete importanti: +
    +
  • {{site.data.keyword.Bluemix_dedicated_notm}}
    • +
  • {{site.data.keyword.Bluemix_notm}} pubblico
    • +
  • Operazioni {{site.data.keyword.IBM_notm}}
    • +
+
+
{{site.data.keyword.Bluemix_dedicated_notm}}
+
+Come minimo, contiene i componenti Cloud Foundry e alcuni servizi di applicazione dedicati. {{site.data.keyword.Bluemix_notm}} fornisce gli ambienti di calcolo Cloud Foundry e basati su {{site.data.keyword.containerlong}}. Un'azienda può avere uno o entrambi questi ambienti di calcolo configurati.
+Un'azienda può aggiungere ulteriori servizi di applicazione dedicati.
+Consulta la [tabella 2](#table02) per informazioni sugli ulteriori servizi e capacità di calcolo che puoi aggiungere. +
+
{{site.data.keyword.Bluemix_notm}} pubblico
+
+{{site.data.keyword.Bluemix_dedicated_notm}} può includere una connessione in uscita a una regione di {{site.data.keyword.Bluemix_notm}} pubblico. Ciò fornisce la diffusione dei servizi pubblico sul catalogo dedicato. La diffusione del servizio {{site.data.keyword.Bluemix_notm}} pubblico offre agli sviluppatori un metodo pratico per creare applicazioni ospitate nel {{site.data.keyword.Bluemix_dedicated_notm}} della propria azienda e accedere ai servizi in esecuzione in {{site.data.keyword.Bluemix_notm}} pubblico. L'elenco dei servizi che possono essere diffusi da {{site.data.keyword.Bluemix_notm}} pubblico sono mostrati nella [tabella 4 della sezione Catalogo diffuso](#catalogdedicated). +
+
Operazioni {{site.data.keyword.IBM_notm}}
+
+{{site.data.keyword.IBM_notm}} gestisce, monitora e mantiene la piattaforma dedicata e i servizi dedicati, così tu puoi concentrarti sulla creazione di applicazioni innovative. Il team OSS (Operations Support Services) {{site.data.keyword.IBM_notm}} esegue le operazioni utilizzando una connessione tunnel VPN dalla rete delle operazioni {{site.data.keyword.IBM_notm}}. +
+
Azienda
+
+L'ambiente di rete aziendale può avere un collegamento di rete bidirezionale privato a {{site.data.keyword.Bluemix_dedicated_notm}}. Ciò consente alle applicazioni ospitate in {{site.data.keyword.Bluemix_dedicated_notm}} di accedere ai servizi e alle risorse all'interno dell'azienda, tra cui le origini dati e i servizi aziendali. Questo collegamento di rete consente inoltre a {{site.data.keyword.Bluemix_dedicated_notm}} di utilizzare il tuo LDAP per l'autenticazione degli sviluppatori e amministratori della tua azienda.
+
+Esistono diverse opzioni per la creazione di link di rete privata sicuri. Parla con il tuo specialista tecnico IBM su quale è la migliore opzione di rete per il tuo ambiente.
+
+La connessione predefinita da {{site.data.keyword.Bluemix_dedicated_notm}} alla tua rete aziendale utilizzare una VPN (Virtual Private Network). {{site.data.keyword.Bluemix_dedicated_notm}} ha una terminazione VPN Vyatta di 1 Gbps dedicata configurata per l'elevata disponibilità. +
+Nell'architettura predefinita per {{site.data.keyword.Bluemix_dedicated_notm}} come mostrato nella [figura 1](#figure01), non c'è traffico di rete in entrata direttamente da internet. Se la tua azienda desidera consentire l'accesso Internet alle applicazioni ospitate in {{site.data.keyword.Bluemix_dedicated_notm}}, è necessario configurare l'accesso tramite la rete aziendale. +
+
+ + +## Configurazione di {{site.data.keyword.Bluemix_dedicated_notm}} +{: #setupdedicated} + +{{site.data.keyword.Bluemix_dedicated_notm}} è progettato per fornire una versione privata dell'offerta {{site.data.keyword.Bluemix_notm}} pubblico. Puoi utilizzare i servizi e i runtime {{site.data.keyword.Bluemix_notm}} per supportare le tue esigenze di elaborazione in un account {{site.data.keyword.BluSoftlayer}} ospitato da IBM. + +IBM ti fornisce l'accesso a {{site.data.keyword.Bluemix_dedicated_notm}} utilizzando un accesso protetto da password. Puoi accedere a servizi, runtime +e risorse associate nonché distribuire e rimuovere applicazioni {{site.data.keyword.Bluemix_notm}}. IBM si avvale di più sedi {{site.data.keyword.BluSoftlayer}} per la distribuzione di {{site.data.keyword.Bluemix_dedicated_notm}} il che ti permette di ottenere la tua versione privata in una sede a te vicina. + +Per configurare la tua versione privata di {{site.data.keyword.Bluemix_notm}}: + +
    +
  1. Per iniziare, contatta il tuo rappresentante dell'account designato IBM oppure contatta {{site.data.keyword.Bluemix_notm}} icona link esterno.
    2. +
  2. Determina insieme a IBM la quota per la tua istanza {{site.data.keyword.Bluemix_dedicated_notm}}. La quota mensile ricorrente si basa sui servizi dedicati +che desideri utilizzare, oltre a una sottoscrizione a tutti i servizi pubblici +{{site.data.keyword.Bluemix_notm}}. Riceverai quindi una fattura per tutto ciò che scegli di utilizzare +al di fuori di tale accordo di sottoscrizione.
    3. +
  3. Identifica le scadenze per ogni fase di configurazione della tua istanza di {{site.data.keyword.Bluemix_dedicated_notm}}. Per informazioni su ciascuna fase e sulle attività coinvolte, vedi Ruoli e responsabilità {{site.data.keyword.Bluemix_dedicated_notm}}.
    4. +
  4. Seleziona la sede data center {{site.data.keyword.BluSoftlayer}} icona link esterno per la tua istanza dedicata. Vengono creati quindi la tua piattaforma dedicata e il tuo account. Per l'account, devi identificare le persone all'interno della tua organizzazione +a cui assegnare i ruoli necessari per rendere operativa la tua istanza +dedicata. Per informazioni sui ruoli che puoi assegnare, vedi Ruoli e responsabilità {{site.data.keyword.Bluemix_dedicated_notm}}. +
    5. +
  5. Definisci e stabilisci la connettività di rete tra la tua rete aziendale e la tua istanza {{site.data.keyword.Bluemix_dedicated_notm}}. Esiste un'applicazione per la sicurezza di rete obbligatoria che include le funzionalità di firewall e prevenzione delle intrusioni con un costo associato per questa opzione. +
      +
    1. IBM installa l'infrastruttura di monitoraggio e di sicurezza per l'istanza dedicata.
      2. +
    2. IBM installa i servizi dedicati a singolo tenant che hai selezionato.
      3. +
    3. Fornisci gli endpoint e la configurazione di rete +per cose come indirizzi IP o firewall e accedi al tuo LDAP per +l'integrazione in {{site.data.keyword.Bluemix_notm}}.
      4. +
    +
    6. +
  6. Identifica e assegna i ruoli del tuo team amministrativo per l'ambiente. +
      +
    1. IBM configura l'accesso alla rete e il LDAP in base alle informazioni che hai fornito. L'accesso amministrativo +viene fornito ai contatti da te designati. Devi designare un +contatto anche per il supporto e la fatturazione.
      2. +
    2. IBM configura un catalogo diffuso nell'ambiente dedicato per visualizzare i tuoi servizi dedicati. Il catalogo diffuso include dei servizi aggiuntivi che vengono diffusi e messi a tua disposizione da {{site.data.keyword.Bluemix_notm}} pubblico. Hai la possibilità di decidere quali servizi pubblici rispondono ai tuoi requisiti aziendali, sulla base di criteri di sicurezza e privacy dei dati.
      3. +
    3. Convalidi la configurazione di rete e del firewall e l'accesso e l'endpoint LDAP.
      4. +
    +
    7. +
+ +Per la distribuzione e configurazione iniziale del tuo ambiente puoi prevedere un processo simile a quello elencato di seguito. Per i dettagli sui responsabili di ciascuna attività, vedi [Ruoli e responsabilità](index.html#rolesresponsibilities). + +
    +
  1. Seleziona il data center che verrà utilizzato per ospitare l'istanza dedicata. Per informazioni sulle opzioni dei data center, vedi Sede data center {{site.data.keyword.BluSoftlayer}} icona link esterno.
    2. +
  2. Specifica i nomi di dominio per la distribuzione e gli ID che desideri utilizzare. Quando configuri l'istanza {{site.data.keyword.Bluemix_notm}}, ottieni tre domini. Puoi scegliere il prefisso per *mycompany*.*region*.bluemix.net e *mycompany*.*region*.mybluemix.net. Inoltre, puoi scegliere il nome completo per il terzo dominio.
    +

    Puoi scegliere il numero di domini personalizzati desiderato. Tuttavia, sarai responsabile dei certificati dei domini personalizzati. Per ulteriori informazioni sulla creazione del dominio personalizzato, consulta Creazione e utilizzo di un dominio personalizzato.

    3. +
  3. Identifica un proprietario per l'account pubblico che viene utilizzato per rappresentare la tua azienda in {{site.data.keyword.Bluemix_notm}} pubblico. IBM utilizza questo account per tracciare l'utilizzo dei servizi diffusi.
    4. +
  4. Seleziona il tipo di connessione sicura al tuo data center. Puoi selezionare tra {{site.data.keyword.Bluemix_notm}} VPN, {{site.data.keyword.Bluemix_notm}} Direct Link e AT&T Net Bond.
    5. +
  5. Decidi se consentire l'accesso al tuo ambiente dedicato dall'Internet pubblico.
    6. +
  6. Seleziona il tipo di autenticazione che verrà utilizzato. Puoi selezionare ID IBM o Active Directory. Per informazioni sull'utilizzo e la registrazione di un ID IBM, consulta la pagina Help and FAQ. +
    7. +
  7. Identifica e assegna i ruoli del tuo team amministrativo per l'ambiente. Per informazioni sui ruoli che devi assegnare, vedi Ruoli e responsabilità {{site.data.keyword.Bluemix_dedicated_notm}}.
    8. +
  8. IBM distribuisce la piattaforma di base che include i runtime elastici, la console, la funzione di amministrazione e il monitoraggio.
    9. +
  9. IBM configura il tuo accesso amministrativo all'ambiente.
    10. +
  10. Puoi iniziare a utilizzare la tua istanza dedicata, monitorata dal team operativo IBM, al fine di rispondere agli avvisi.
    11. +
+ +Una volta configurata la tua istanza {{site.data.keyword.Bluemix_notm}}, puoi monitorare e gestire l'istanza {{site.data.keyword.Bluemix_notm}} utilizzando la pagina Amministrazione. Per ulteriori informazioni, vedi [Gestione di {{site.data.keyword.Bluemix_notm}} locale e dedicato](../admin/index.html#mng). Per informazioni su aggiornamenti e manutenzione, vedi [Manutenzione dell'istanza dedicata](index.html#maintaindedicated). + +## Ruoli e responsabilità +{: #rolesresponsibilities} + +Se hai configurato un account {{site.data.keyword.Bluemix_dedicated_notm}}, devi identificare le persone all'interno della tua organizzazione a cui assegnare i ruoli necessari per rendere operativa la tua istanza. + +### Ruoli + +Il seguente elenco mostra i ruoli e le responsabilità dei clienti che puoi assegnare: + +
+
**Procurement focal**
+
Lavora con il rappresentante IBM per organizzare il tuo ambiente {{site.data.keyword.Bluemix_dedicated_notm}}, occupandosi inoltre dell'identificazione delle persone adeguate a gestire ogni aspetto del progetto all'interno della tua organizzazione. La persona assegnata a questo ruolo assume un ruolo di gestione dei progetti e controlla la selezione del modello, gli accordi commerciali e la disposizione dell'accesso alle risorse dei clienti. Il Procurement focal è il contatto generale per la configurazione dell'istanza dedicata e la traccia del processo di distribuzione.
+
**Responsabile della conformità**
+
Lavora con il rappresentante IBM per selezionare un'opzione di topologia e distribuzione che risponda ai tuoi requisiti di sicurezza. La persona assegnata a questo ruolo collabora con i consulenti di conformità IBM per determinare quali modelli di distribuzione raggiungono gli obiettivi di conformità.
+
**Network specialist**
+
Lavora con il rappresentante IBM per identificare i piani di rete per la distribuzione di {{site.data.keyword.Bluemix_notm}}. La persona assegnata a questo ruolo riesamina le specifiche di rete richieste da IBM e lavora con IBM su un piano di implementazione. Al termine della fase di installazione e verifica, la persona assegnata a questo ruolo conferma che la configurazione di rete è in conformità con gli standard aziendali.
+
**DevOps focal**
+
Lavora con il rappresentante IBM per pianificare e applicare gli aggiornamenti di manutenzione necessari per la piattaforma, i servizi e i runtime {{site.data.keyword.Bluemix_notm}}. La persona assegnata a questo ruolo lavora anche con il rappresentante IBM sulla configurazione della tua istanza {{site.data.keyword.Bluemix_dedicated_notm}}.
+
Operations focal
+
Lavora con il team di supporto come necessario quando l'ambiente è attivo e in esecuzione. In genere si tratta di qualcuno con l'accesso Superuser alla console di gestione che può approvare gli aggiornamenti di manutenzione pianificati per l'ambiente Bluemix ed essere disponibile tutte le volte che si verifica un incidente critico. La persona assegnata a questo ruolo deve avere una conoscenza tecnica dell'ambiente Bluemix ed essere nella posizione di raggiungere le altre persone nell'azienda con competenze avanzate in un'area che potrebbe essere influenzata inclusi ad esempio la rete e la sicurezza.
+
+ +I tuoi rappresentanti dei clienti collaborano con gli specialisti IBM che lavorano insieme per garantirti tutto il supporto di cui hai bisogno. Puoi eseguire l'upgrade al livello di supporto Premium per lavorare con un CSM (Client Success Manager) dedicato per il tuo account. Per ulteriori informazioni sui diversi livelli di supporto, +vedi [Come contattare il supporto](../support/index.html#contacting-support). Il CSM completa i seguenti tipi di attività: + +
    +
  • Consente una rapida adozione del tuo ambiente {{site.data.keyword.Bluemix_dedicated_notm}}.
    • +
  • Offre utili materiali didattici e di abilitazione per migliorare la tua autosufficienza.
    • +
  • Promuove una relazione a lungo termine tra te e lo sviluppo, il supporto e i servizi {{site.data.keyword.Bluemix_notm}} che utilizzi.
    • +
+ +Il team operativo e di supporto {{site.data.keyword.Bluemix_notm}} che insieme a te gestisce l'istanza {{site.data.keyword.Bluemix_notm}} potrebbe accedere al tuo ambiente locale, ma lo fa solo per i seguenti motivi. + +
    +
  • Per rispondere agli avvisi ed eseguire la manutenzione operativa
    • +
  • Per tentare di riprodurre un problema riportato su un ticket di supporto
    • +
+ +### Responsabilità + +Dalla configurazione del tuo ambiente alla manutenzione continua, è necessario completare una serie di attività. La seguente tabella illustra le attività richieste e il proprietario per lo svolgimento delle attività attraverso le fasi di inizio, avanzamento e completamento. + +La fase di inizio è utilizzata per organizzare l'ambiente {{site.data.keyword.Bluemix_dedicated_notm}}. Gli obiettivi principali di questa fase sono i seguenti: + +- Esaminare l'accordo finanziario e stabilire le date cardine per la distribuzione. +- Creare la piattaforma {{site.data.keyword.Bluemix_notm}} e fornire accesso a runtime e servizi. +- Definire e stabilire la connettività di rete tra la tua rete aziendale e le operazioni {{site.data.keyword.Bluemix_notm}}. +- Identificare e assegnare i ruoli per il team amministrativo. + +| **Attività** | **Dettagli attività** | **Parte responsabile** | +|----------|------------------|-----------------------| +|Impostare gli standard di conformità | Identificare gli standard governativi, di settore e aziendali richiesti per l'ambiente. | Cliente | +|Creare un piano di integrazione di sicurezza e conformità | Creare un piano di sicurezza e di integrazione che includa i costi, la pianificazione e le risorse necessarie per garantire la conformità di sicurezza. | IBM | +|Approvazione del piano di conformità | Approvare il piano di conformità. | Cliente | +|Creare il dimensionamento per l'ambiente | Creare il dimensionamento dell'ambiente sulla base di scelte predefinite che tengono in considerazione gli obiettivi di alta disponibilità e ripristino di emergenza, così come il provisioning iniziale di DEA e servizi necessario per supportare le applicazioni create con la piattaforma. Lavora insieme a IBM per definire, ad esempio, quali database sono necessari, quali servizi vengono offerti nel catalogo diffuso del cliente e altro ancora. | Responsabilità condivisa tra IBM e il cliente | +|Selezionare l'architettura | Selezionare l'architettura sulla base di scelte predefinite che tengono in considerazione i requisiti di alta disponibilità e ripristino di emergenza. | IBM | +|Definire gli obiettivi del ripristino di emergenza | Definire i requisiti di ripristino di emergenza per l'ambiente. | Cliente | +|Creare il piano di ripristino di emergenza | Consultare e definire il piano di ripristino di emergenza. IBM crea un modello di ripristino di emergenza e con te stabilisce dove fornire il feedback e approvare il piano. | Responsabilità condivisa tra IBM e il cliente | +|Creare il piano di backup e ripristino | Creare un piano di backup e ripristino che definisce la frequenza e i requisiti per la distribuzione interna ed esterna del backup. IBM esegue il backup dei componenti dell'infrastruttura, dei servizi IBM, dei metadati dei servizi inclusi i ruoli utente e altro ancora. Tu esegui il backup dei dati specifici dell'applicazione di cui sei responsabile. | Responsabilità condivisa tra IBM e il cliente | +|Identificare gli strumenti per il rilevamento degli eventi e la determinazione dei problemi | Identificare gli strumenti IBM e di terze parti utilizzati per il rilevamento degli eventi e la determinazione dei problemi a livello della piattaforma {{site.data.keyword.Bluemix_notm}}. | IBM | +|Definire il piano di escalation | Definire il piano di escalation per valutare e risolvere gli eventi rilevati dai componenti di monitoraggio. | IBM | +|Firmare gli accordi relativi a infrastruttura, piattaforma e supporto | Firmare l'accordo di sottoscrizione che include i termini e le condizioni finanziarie per l'ambiente. Firmare la sottoscrizione di supporto. | Cliente | +|Disporre l'ambiente | Disporre le risorse di calcolo, la rete e la memoria incluso la VLAN core e dei servizi per ospitare {{site.data.keyword.Bluemix_notm}}, e i servizi bare metal per ospitare Data Power e {{site.data.keyword.Bluemix_notm}}. Fornire l'infrastruttura per consentire il tunnel VPN. | IBM | +|Installare i componenti dell'infrastruttura, dell'applicazione e di monitoraggio e gestione | Installare, configurare e verificare i componenti dell'infrastruttura, come ad esempio BOSH Director, Cloud Controller, Health Manager, messaggistica, router, DEA e provider di servizi e i componenti di monitoraggio definiti nel piano di escalation e rilevamento dei problemi. | IBM | +|Installare e configurare i componenti di sicurezza | Installare e configurare i componenti di sicurezza vincolati nel piano di monitoraggio e di escalation, tra cui IBM QRadar, archivio credenziali, sistema di prevenzione delle intrusioni, IBM BigFix e IBM Security Privileged Identity Management. | IBM | +|Installare e configurare i componenti personalizzati | Installare e configurare i componenti personalizzati che si trovano al di fuori del campo di applicazione del prodotto e dei servizi {{site.data.keyword.Bluemix_notm}}. | Cliente | +|Stabilire la configurazione di rete iniziale | Stabilire la configurazione di rete iniziale inclusi i firewall, DataPower, Fortigate e DNS. | IBM | +|Connettere la pipeline {{site.data.keyword.Bluemix_notm}} | Connettere la pipeline di fornitura e di integrazione continua {{site.data.keyword.Bluemix_notm}} ai repository IBM. | IBM | +|Personalizzare i componenti della soluzione esterni | Personalizzare i servizi di bilanciamento del carico per gli scenari di ripristino di emergenza. | Cliente | +|Installare la soluzione VPN | Installare la soluzione VPN bidirezionale. | IBM | +|Configurare il server di accesso | Configurare il server di accesso per l'utilizzo del LDAP aziendale. | IBM | +|Tracciare lo stato per le verifiche di sicurezza, conformità e controllo | Tracciare lo stato fino al punto in cui vengono osservati tutti gli strumenti e processi per raggiungere la conformità identificata. | Cliente | +|Controllare l'infrastruttura fisica | Controllare le sedi fisiche che ospitano i componenti della soluzione per individuare eventuali minacce e riesaminare i controlli di sicurezza per proteggere il data center. | Cliente | +|Ispezionare il software di monitoraggio | Ispezionare i componenti di monitoraggio e gestione, come definito nel piano di escalation e determinazione dei problemi. | Cliente | +|Ispezionare il sistema operativo | Verificare che l'immagine del sistema operativo rispetti gli standard di conformità. IBM fornisce l'accesso all'immagine del sistema operativo. | Responsabilità condivisa tra IBM e il cliente | +{: caption="Table 5. Inception phase tasks" caption-side="top"} + + +La fase successiva è quella di avanzamento. La fase di avanzamento descrive il rapporto di collaborazione in corso tra te e IBM Cloud. Gli obiettivi principali per questa fase sono i seguenti: + +- Esaminare le capacità e coordinare le modifiche necessarie. +- Esaminare i miglioramenti di manutenzione e piattaforma. +- Coordinare le attività per la risoluzione dei problemi e l'analisi delle cause principali. + +| **Attività** | **Dettagli attività** | **Parte responsabile** | +|----------|------------------|-----------------------| +|Esaminare i report sulle capacità settimanali | Esaminare i report sulle capacità settimanali e adottare misure correttive laddove necessario. | Cliente | +|Creare proiezioni mensili | Raccogliere informazioni e creare una proiezione mensile della capacità e del consumo. | Responsabilità condivisa tra IBM e il cliente | +|Esaminare le proiezioni della capacità | Esaminare le proiezioni della capacità relative ad eventi esterni che potrebbero influire sulle capacità così come sulle nuove distribuzioni previste per le applicazioni. Lavorare con IBM per esaminare le proiezioni e creare un piano adeguato. | Responsabilità condivisa tra IBM e il cliente | +|Esaminare le proiezioni | Esaminare le proiezioni della capacità relative ad eventi esterni che potrebbero influire sulle capacità. | Cliente | +|Regolare la capacità | Aggiungere o rimuovere capacità al mutare delle esigenze. | IBM | +|Pubblicare gli aggiornamenti e la manutenzione previsti | Creare la documentazione per la manutenzione richiesta dei componenti IBM. | IBM | +|Effettuare la manutenzione | Lavorare con IBM per pianificare la manutenzione richiesta all'interno di una finestra di 21 giorni. Puoi fornire le date che per te potrebbero non andare bene all'interno della finestra di 21 giorni; IBM provvederà a pianificare la manutenzione di conseguenza. | Responsabilità condivisa tra IBM e il cliente | +|Rilevamento di errori di provisioning | Correggere gli errori di provisioning, se presenti, per i servizi creati dal cliente che vengono distribuiti nel catalogo. | IBM | +|Eseguire scansioni di rete e IP | Eseguire scansioni di rete e IP giornaliere e mensili. | Responsabilità condivisa tra IBM e il cliente | +|Fornire accesso ai log di controllo | Fornire accesso a tutti i log di controllo amministrativo e della sicurezza. | Responsabilità condivisa tra IBM e il cliente | +|Effettuare dei test | Effettuare periodicamente il test dei controlli chiave sulle operazioni e il test di penetrazione di terze parti. | Responsabilità condivisa tra IBM e il cliente | +|Segnalazione dello stato, coordinamento dei controlli e incontri di conformità | Completare la segnalazione dello stato, il coordinamento del controllo esterno e la rappresentazione negli incontri sullo stato di revisione della conformità. | IBM | +|Verifica dell'occupazione lavorativa e delle esigenze aziendali | Completare la verifica trimestrale dell'occupazione lavorativa e la verifica delle continue esigenze aziendali per i rappresentanti IBM che hanno accesso all'ambiente del cliente. | IBM | +|Risoluzione delle vulnerabilità di sicurezza | Risolvere le vulnerabilità di sicurezza segnalate nella piattaforma. | IBM | +{: caption="Table 6. Progression phase tasks" caption-side="top"} + +La fase finale di completamento rappresenta la fine del rapporto tra te e IBM {{site.data.keyword.Bluemix_notm}}. Le attività principali per questa fase sono le seguenti: + +* Termine dell'accordo finanziario +* Rimozione di tutte le connessioni di rete +* Riciclaggio dell'infrastruttura + + +| **Attività** | **Dettagli attività** | **Parte responsabile** | +|----------|------------------|-----------------------| +|Terminare l'accordo finanziario | Discutere e concordare un termine per il contratto dell'accordo finanziario. | Responsabilità condivisa tra IBM e il cliente | +|Rimuovere le autorizzazioni per l'ambiente | Disattivare l'accesso e le credenziali per l'ambiente. | Responsabilità condivisa tra IBM e il cliente | +|Rimuovere le connessioni di rete del cliente | Rimuovere le connessioni di rete tra IBM e l'ambiente del cliente. | Responsabilità condivisa tra IBM e il cliente | +|Riciclare l'infrastruttura | Il tuo ambiente viene riciclato in base ai processi definiti da {{site.data.keyword.BluSoftlayer}}. | IBM | +{: caption="Table 7. Completion phase tasks" caption-side="top"} + +## Gestione della tua istanza dedicata +{: #maintaindedicated} + +IBM effettua la manutenzione e l'installazione di aggiornamenti e correzioni ogni qualvolta lo ritenta appropriato per i runtime e i servizi {{site.data.keyword.Bluemix_notm}}. I servizi potrebbero non essere disponibili durante le finestre di manutenzione. Inoltre, IBM collabora con te per pianificare gli aggiornamenti di manutenzione per la piattaforma {{site.data.keyword.Bluemix_notm}}. + +Per {{site.data.keyword.Bluemix_dedicated_notm}} sono richiesti i seguenti tipi di manutenzione: +
+
**Manutenzione standard per i servizi**
+
I servizi utilizzano delle finestre di manutenzione standard predefinite, che potrebbero causare la non disponibilità del servizi. IBM non richiede l'approvazione dei clienti per eseguire la manutenzione dei servizi, ma prova a ridurre al minimo l'impatto sui tuoi servizi.
+
+IBM invia dei messaggi di broadcast relativi alle modifiche pianificate per ciascuna finestra di manutenzione nella pagina Stato.
+
+**Importante**: alcuni servizi potrebbero non essere a tua disposizione durante il periodo di manutenzione.
+ +
**Manutenzione standard per la piattaforma {{site.data.keyword.Bluemix_notm}}**
+
Gli aggiornamenti di manutenzione vengono applicati in base al coordinamento tra te e IBM entro una finestra di 21 giorni. Fornisci a IBM le finestre di manutenzione preapprovate e le date o gli orari specifici che potrebbero non andare bene per te; IBM cercherà di pianificare gli aggiornamenti durante o intorno alle date da te selezionate. +

+

Vai a **AMMINISTRAZIONE > INFORMAZIONI DI SISTEMA** per visualizzare gli aggiornamenti di manutenzione pianificati e in sospeso. Per ulteriori informazioni sull'impostazione delle tue finestre preapprovate, e la visualizzazione o l'approvazione degli aggiornamenti di manutenzione pianificati, vai a Aggiornamenti di manutenzione.

+
+ +**Importante**: IBM si riserva il diritto di interrompere i servizi per applicare la manutenzione di emergenza a seconda delle necessità. IBM potrebbe modificare le ore di manutenzione pianificate, ma verrai avvisato di tali modifiche nonché di tutte le informazioni relative alla manutenzione di emergenza. + +Se viene segnalato un problema dopo l'aggiornamento di manutenzione, insieme al rappresentante del supporto {{site.data.keyword.Bluemix_notm}} puoi stabilire se ti è utile consentire a IBM di eseguire il rollback dell'aggiornamento. Previo accordo, IBM esegue il rollback dell'aggiornamento per ripristinare l'ambiente allo stato precedente. + +## Risposta e supporto agli incidenti per {{site.data.keyword.Bluemix_dedicated_notm}} +{: #incidentresponse} + +### Problemi rilevati dal cliente + +Se identifichi un problema che richiede un intervento e attenzione da parte del supporto IBM, puoi contattarlo in vari modi. Per informazioni su come contattare il supporto, vedi [Come contattare il supporto](../support/index.html#contacting-bluemix-support-local). A seconda del problema, dovrà essere risolto da te e/o da IBM. + +### Incidenti critici rilevati da IBM + +Gli incidenti critici sono interruzioni dei servizi impreviste con carattere d'urgenza e problemi di stabilità che colpiscono il tuo ambiente o i tuoi utenti. Se IBM individua un incidente critico nel proprio ambiente, te lo comunica tramite notifica nella pagina **Stato**. Puoi consultare la pagina Stato anche per eventuali problemi noti relativi alla piattaforma o ai tuoi servizi. Per ulteriori informazioni sulla pagina Stato, consulta [Visualizzazione dello stato](../admin/index.html#oc_status). + +Se desideri integrare le tue notifiche con un servizio Web che supporti gli hook Web, vedi [Notifiche e sottoscrizioni di eventi](../admin/index.html#oc_eventsubscription) per informazioni su come estendere le funzioni di notifica. + +![Processo di risposta agli eventi incidenti](../local/images/incidentresponseprocess.png "Processo di risposta agli incidenti") + +Figura 2. Processo di risposta agli incidenti + +A seconda del problema, dovrà essere risolto da te e/o da IBM. Se hai domande sull'incidente o se hai bisogno che un rappresentante IBM ti aiuti a risolvere il problema, puoi aprire un ticket di supporto. Per informazioni su come contattare il supporto, vedi [Come contattare il supporto](/docs/support/index.html#contacting-bluemix-support-local). + +**Nota**: i ticket di supporto con severità 1 vengono monitorati 24 ore al giorno, 7 giorni a settimana. Gli altri ticket vengono elaborati dalle 22:00 GMT di domenica alle 12:00 GMT di sabato. Per ulteriori informazioni sulla severità dei ticket di supporto e sull'utilizzo del supporto, vedi Come contattare il supporto. + + +## Ripristino di emergenza per {{site.data.keyword.Bluemix_dedicated_notm}} +{: #dr} + +Il ripristino di emergenza per {{site.data.keyword.Bluemix_short}} dedicato può essere configurato in modo analogo a quello valido quando si utilizza {{site.data.keyword.Bluemix_short}} pubblico. {{site.data.keyword.Bluemix_short}} pubblico fornisce una piattaforma costantemente disponibile per l'innovazione con più misure di sicurezza per garantire che le tue organizzazioni, i tuoi spazi e le tue applicazioni siano sempre disponibili. La distribuzione delle applicazioni in più regioni geografiche consente una disponibilità continua che protegge contro l'imprevista perdita simultanea di più componenti hardware o software o la perdita di un intero data center; in tal modo, anche in caso di catastrofe naturale in una posizione geografica, le istanze distribuite della tua applicazione {{site.data.keyword.Bluemix_notm}} pubblico saranno disponibili in posizioni geografiche alternative. +{: shortdesc} + +Il ripristino di emergenza per {{site.data.keyword.Bluemix_short}} dedicato è reso possibile grazie alla disponibilità continua per le tue applicazioni, all'alta disponibilità intrinseca della piattaforma e alla possibilità di ripristinare l'istanza in caso di errore. Sei responsabile dell'abilitazione della disponibilità continua delle tue applicazioni mediante la distribuzione a più regioni. L'alta disponibilità viene integrata a livello della piattaforma tramite le tecnologie incluse in Cloud Foundry e altri componenti. Inoltre, puoi collaborare con IBM per assicurarti che il backup dei tuoi dati venga eseguito correttamente nel caso in cui sia necessario ripristinare la tua istanza. + +### Abilitazione della disponibilità continua per {{site.data.keyword.Bluemix_dedicated_notm}} +{: #enabling} + +Per impostazione predefinita, {{site.data.keyword.Bluemix_notm}} pubblico viene distribuito in più posizioni geografiche. Tuttavia, per abilitare le istanze {{site.data.keyword.Bluemix_dedicated_notm}} distribuite a livello globale, devi effettuare le seguenti attività: + +* Assicurati che gli sviluppatori stiano distribuendo le applicazioni in più di una regione, mediante un processo manuale o automatico. Le regioni dovrebbero trovarsi a più di 200 km di distanza l'una dall'altra per garantire che, in caso di catastrofe naturale, non vengano colpite entrambe le posizioni geografiche. +* Configurare un programma di bilanciamento del carico globale, come Akamai o Dyn, per puntare ad applicazioni in almeno due regioni diverse. + +**Nota**: non tutti i servizi {{site.data.keyword.Bluemix_notm}} supportano la distribuzione regionale. Quando crei un'applicazione, se vuoi garantire una distribuzione geografica, devi fare in modo che i servizi utilizzati dall'applicazione abbiano come funzione fondamentale la sincronizzazione dei dati. + +#### Distribuzione di applicazioni {{site.data.keyword.Bluemix_dedicated_notm}} in più posizioni geografiche +{: #deploying} + +Per eseguire la distribuzione in una seconda posizione o in più posizioni, devi seguire un processo simile a quello effettuato per abilitare la posizione geografica primaria: + +1. Abilita un nuovo ambiente dedicato per ospitare istanze aggiuntive delle tue applicazioni. Per creare un nuovo ambiente, contatta il team del settore vendite IBM per avviare il processo. Per ulteriori informazioni sulla configurazione di un'istanza dedicata, vedi [Configurazione di {{site.data.keyword.Bluemix_dedicated_notm}}](/docs/dedicated/index.html#setupdedicated). Devi effettuare un accesso distinto per ogni ambiente. Ciascuna posizione fisica degli ambienti host deve trovarsi ad almeno 200 km di distanza dalla posizione originale per garantire la disponibilità. +2. Ottieni il nome di dominio univoco in cui verrà ospitata la tua nuova applicazione distribuita. Ad esempio, se il dominio originale è *mycompany.caeast.bluemix.net*, puoi creare un nuovo ambiente locale con un nuovo dominio come, ad esempio, *mycompany.cawest.bluemix.net* e distribuire al nuovo dominio. +3. Ogni volta che distribuisci l'applicazione originale, esegui anche la distribuzione nella nuova posizione. Per ulteriori informazioni sulla distribuzione, vedi [Caricamento della tua applicazione](/docs/starters/upload_app.html). + + +#### Abilitazione di un programma di bilanciamento del carico globale per {{site.data.keyword.Bluemix_dedicated_notm}} +{: #glb} + +Un programma di bilanciamento del carico globale non solo garantisce la disponibilità continua ed è richiesto per il ripristino di emergenza, ma presenta anche diversi vantaggi aggiuntivi: + +* Indirizza gli utenti alla regione {{site.data.keyword.Bluemix_notm}} più vicina per impostazione predefinita +* Indirizza in base alle prestazioni +* Instrada selettivamente una percentuale di traffico a una nuova versione dell'applicazione +* Fornisce il failover del sito in base alla verifica dell'integrità della regione +* Fornisce il failover del sito in base alla verifica dell'integrità dell'applicazione +* Utilizza un instradamento ponderato tra gli endpoint + +Puoi scegliere un programma di bilanciamento del carico globale come Akamai o Dyn. Per ulteriori informazioni sull'utilizzo di Akamai come programma di bilanciamento del carico globale, vedi [Global traffic management ![icona link esterno](../icons/launch-glyph.svg)](https://www.akamai.com/us/en/solutions/products/web-performance/global-traffic-management.jsp "Opens in new window"){: new_window}. Per ulteriori informazioni sull'utilizzo di Dyn come programma di bilanciamento del carico globale, vedi [4 Reasons Businesses Are Taking Global Load Balancing to the Cloud ![icona link esterno](../icons/launch-glyph.svg)](http://dyn.com/blog/4-reasons-businesses-are-taking-global-load-balancing-to-the-cloud/){: new_window}. + +### Alta disponibilità +{: #ha} + +Oltre a consentire la disponibilità continua, {{site.data.keyword.Bluemix_notm}} fornisce anche l'alta disponibilità in tutta la piattaforma utilizzando le tecnologie integrate in Cloud Foundry e altri componenti. + +Queste tecnologie includono: + +
+
Scalabilità in Cloud Foundry DEA
+
Un DEA (Droplet Execution Agent) icona link esterno Cloud Foundry effettua verifiche dell'integrità nelle applicazioni eseguite al suo interno. Se si verifica un problema con l'applicazione o con lo stesso DEA, distribuisce ulteriori istanze dell'applicazione a un DEA alternativo per risolvere il problema. Per ulteriori informazioni, vedi Configuring CF for High Availability with Redundancy icona link esterno. +

Per garantire l'elevata disponibilità per le tue applicazioni, hai bisogno di abbastanza risorse di elaborazione per bilanciare il carico e puoi inoltre richiederne ulteriori per supportare un possibile malfunzionamento. Se hai bisogno di ridimensionare il tuo ambiente incrementando il tuo pool DEA in modo da essere preparato a un malfunzionamento o per affrontare un'anomalia durante il caricamento delle tue istanze dell'applicazione, puoi collaborare con il tuo rappresentante IBM per ordinare ulteriori DEA e per verificare di avere l'hardware appropriato per supportare le risorse aggiunte. +

+
+
Ridondanza {{site.data.keyword.BluSoftlayer}}
+
Con {{site.data.keyword.BluSoftlayer}} negli ambienti dedicati, i dati presenti in ciascun cluster di archiviazione cloud vengono scritti più volte e i cluster di archiviazione sono configurati con capacità di riparazione automatica in caso di guasto dell'unità. Se si verifica un problema con un server virtuale, {{site.data.keyword.BluSoftlayer}} prova a riavviarlo in un altro host.
+
Backup dei metadati
+
I metadati vengono sottoposti a backup mediante il sistema {{site.data.keyword.BluSoftlayer}} EVault Backup in una posizione che si trova ad almeno 200 km di distanza.
+
+ +## Ripristino della tua istanza dedicata +{: #restorededicated} + +Il backup di impostazioni, metadati e configurazioni di {{site.data.keyword.Bluemix_dedicated_notm}} viene eseguito periodicamente come tutela in caso di eventuali interruzioni non pianificate nell'ambiente. I dati per i quali sei responsabile del backup includono i dati dell'applicazione, i dati dei servizi del database cloud e gli archivi oggetti. + +Come parte del backup dei dati, che include i metadati del sistema e le configurazioni, IBM completa le seguenti attività: + +
    +
  • Crittografa tutte le copie di backup e gestisce le chiavi di crittografia
    • +
  • Monitora e gestisce l'attività di backup
    • +
  • Fornisce i file di backup crittografati
    • +
  • Ripristina i dati richiesti
    • +
  • Gestisce i conflitti di pianificazione tra le operazioni di gestione dei backup e delle correzioni
    • +
+ +Poiché la protezione dei dati privati è di importanza critica, IBM ha bisogno della tua collaborazione quando si occupa della gestione dei file di backup in modo che i file non vengano spostati all'esterno dei tuoi data center. Nello specifico, IBM richiede che tu completi le seguenti attività: + +
    +
  • Spostare una copia dei tuoi dati di backup crittografati fuori sede, proprio come faresti per qualsiasi altro dato di backup da te gestito.
    • +
  • Fornire i file di backup per l'operatore IBM nel caso occorra eseguire un ripristino.
    • +
+ +# rellinks +{: rellinks} +## general +{: general} +* [Scopri: {{site.data.keyword.Bluemix_dedicated_notm}}](http://www.ibm.com/cloud-computing/bluemix/hybrid/dedicated/) +* [Novità in {{site.data.keyword.Bluemix_notm}}](/docs/whatsnew/index.html) +* [{{site.data.keyword.Bluemix_notm}} glossario](/docs/overview/glossary/index.html) +* [Gestione di {{site.data.keyword.Bluemix_notm}} locale e {{site.data.keyword.Bluemix_dedicated_notm}}](/docs/admin/index.html#mng) +* [Come contattare il supporto](/docs/support/index.html#getting-customer-support) diff --git a/dedicated/nl/ja/index.md b/dedicated/nl/ja/index.md index aa78b0541..01e97dc56 100644 --- a/dedicated/nl/ja/index.md +++ b/dedicated/nl/ja/index.md @@ -260,12 +260,12 @@ IBM は、お客様がパスワードで保護されたログインを使用し {{site.data.keyword.Bluemix_notm}} インスタンスがセットアップされた後は、「管理」ページを使用して {{site.data.keyword.Bluemix_notm}} インスタンスをモニターおよび管理することができます。詳しくは、[ 『{{site.data.keyword.Bluemix_notm}} Local および Dedicated の管理』](../admin/index.html#mng)を参照してください。アップグレードおよび保守については、『[専用インスタンスの保守](index.html#maintaindedicated)』を参照してください。 -##役割および責任 +## 役割および責任 {: #rolesresponsibilities} {{site.data.keyword.Bluemix_dedicated_notm}} アカウントをセットアップした場合、インスタンスを稼働するために必要な役割の組織内のユーザーを特定します。 -###役割 +### 役割 以下のリストでは、割り当てる顧客の役割および責任を示します。 @@ -380,7 +380,7 @@ Success Manager (CSM) と連携できます。異なるサポート層につい |インフラストラクチャーのリサイクル | お客様の環境は {{site.data.keyword.BluSoftlayer}} 定義のプロセスに基づいてリサイクルされます。 | IBM | {: caption="Table 7. Completion phase tasks" caption-side="top"} -##専用インスタンスの保守 +## 専用インスタンスの保守 {: #maintaindedicated} IBM は、{{site.data.keyword.Bluemix_notm}} ランタ @@ -505,7 +505,7 @@ Akamai や Dyn などのグローバル・ロード・バランサーを選択
{{site.data.keyword.BluSoftlayer}} EVault Backup を使用して、メタデータは最低でも 200 km 離れた場所にバックアップされます。
-##専用インスタンスのリストア +## 専用インスタンスのリストア {: #restorededicated} {{site.data.keyword.Bluemix_dedicated_notm}} の設定、メタデータ、および構成は、環境における計画外停止に備えるために定期的にバックアップされます。お客様の責任でバックアップする必要があるデータには、アプリケーション・データ、クラウド・データベース・サービス・データ、およびオブジェクト・ストアがあります。 diff --git a/dedicated/nl/zh/CN/index.md b/dedicated/nl/zh/CN/index.md index 7a1d04593..e19311ff0 100644 --- a/dedicated/nl/zh/CN/index.md +++ b/dedicated/nl/zh/CN/index.md @@ -260,12 +260,12 @@ IBM 为您提供了使用受密码保护的登录来访问 {{site.data.keyword.B {{site.data.keyword.Bluemix_notm}} 实例设置完成后，您可以使用“管理”页面来监视和管理 {{site.data.keyword.Bluemix_notm}} 实例。有关更多信息，请参阅[管理 {{site.data.keyword.Bluemix_notm}} Local 和 Dedicated](../admin/index.html#mng)。有关升级和维护的信息，请参阅[维护专用实例](index.html#maintaindedicated)。 -##角色和责任 +## 角色和责任 {: #rolesresponsibilities} 如果设置了 {{site.data.keyword.Bluemix_dedicated_notm}} 帐户，请为组织中需要启动并运行实例的人员分配必要的角色。 -###角色 +### 角色 以下列表显示了分配的客户角色和责任： @@ -377,7 +377,7 @@ IBM 为您提供了使用受密码保护的登录来访问 {{site.data.keyword.B |回收基础架构 | 您的环境将基于 {{site.data.keyword.BluSoftlayer}} 定义的流程进行回收。 | IBM | {: caption="表 7. 完成阶段任务" caption-side="top"} -##维护专用实例 +## 维护专用实例 {: #maintaindedicated} IBM 会在 IBM 认为适当的时候，为 {{site.data.keyword.Bluemix_notm}} 运行时和服务维护并安装更新与修订。在维护时段内，服务可能会不可用。此外，IBM 会与您合作安排对 {{site.data.keyword.Bluemix_notm}} 平台的维护更新。 @@ -482,7 +482,7 @@ IBM 会发送有关在“状态”页面上针对每个维护时段计划进行
元数据会使用 {{site.data.keyword.BluSoftlayer}} EVault Backup 来备份到至少 200 公里远的位置。
-##复原专用实例 +## 复原专用实例 {: #restorededicated} 系统会定期备份 {{site.data.keyword.Bluemix_dedicated_notm}} 设置、元数据和配置，以做好准备来应对环境中的任何意外中断。您负责备份的数据包括应用程序数据、云数据库服务数据和对象存储。 diff --git a/dedicated/nl/zh/TW/index.md b/dedicated/nl/zh/TW/index.md index be3b4cea5..8929f452c 100644 --- a/dedicated/nl/zh/TW/index.md +++ b/dedicated/nl/zh/TW/index.md @@ -261,12 +261,12 @@ IBM 讓您能使用受到密碼保護的登入方式來存取 {{site.data.keywor 在設定 {{site.data.keyword.Bluemix_notm}} 實例之後，您可以使用「管理」頁面來監視和管理 {{site.data.keyword.Bluemix_notm}} 實例。如需相關資訊，請參閱[管理 {{site.data.keyword.Bluemix_notm}} 本端及專用](../admin/index.html#mng)。如需升級和維護的相關資訊，請參閱[維護專用實例](index.html#maintaindedicated)。 -##角色及責任 +## 角色及責任 {: #rolesresponsibilities} 如果您設定 {{site.data.keyword.Bluemix_dedicated_notm}} 帳戶，請識別組織中負責維持實例運作所需角色的人員。 -###角色 +### 角色 下列清單顯示您可指派的客戶角色及責任： @@ -377,7 +377,7 @@ IBM 讓您能使用受到密碼保護的登入方式來存取 {{site.data.keywor |回收基礎架構 | 根據 {{site.data.keyword.BluSoftlayer}} 定義的處理程序，回收您的環境。 | IBM | {: caption="表 7. 完成階段作業" caption-side="top"} -##維護您的專用實例 +## 維護您的專用實例 {: #maintaindedicated} 當 IBM 認為適當時，即會維護並安裝 {{site.data.keyword.Bluemix_notm}} 運行環境和服務的更新及修正程式。在維護時間範圍期間，可能無法使用服務。此外，IBM 會與您一起合作來排定 {{site.data.keyword.Bluemix_notm}} 平台的維護更新。 @@ -484,7 +484,7 @@ IBM 會針對「狀態」頁面上每一個維護時間範圍所計劃的變更
使用 {{site.data.keyword.BluSoftlayer}} EVault Backup，將 meta 資料備份至最少距離 200 公里的位置。
-##還原您的專用實例 +## 還原您的專用實例 {: #restorededicated} {{site.data.keyword.Bluemix_dedicated_notm}} 設定、meta 資料及配置會定期備份，以為環境中發生的任何非計劃性的運作中斷作好準備。您負責備份的資料包括應用程式資料、雲端資料庫服務資料及物件儲存庫。 diff --git a/develop/bluemixlive.md b/develop/bluemixlive.md index a554d4363..3100a2abb 100644 --- a/develop/bluemixlive.md +++ b/develop/bluemixlive.md @@ -13,7 +13,7 @@ lastupdated: "2017-4-7" {:new_window: target="_blank"} {:pre: .pre} -#{{site.data.keyword.Bluemix_notm}} Live Sync +# {{site.data.keyword.Bluemix_notm}} Live Sync {: #live-sync} @@ -57,7 +57,7 @@ Figure 1. The Bluemix Live Sync process If you are developing a Java application that is running on Liberty, you can debug remotely by using the [Eclipse Tools for Bluemix](/docs/manageapps/eclipsetools/eclipsetools.html#eclipsetools). -##Live Edit {: #live-edit} +## Live Edit {: #live-edit} If you are building a Node.js application, when you make changes to your project using the Web IDE, the Live Edit feature of the {{site.data.keyword.Bluemix_notm}} Live Sync can quickly update the application instance running on {{site.data.keyword.Bluemix_notm}}. Live Edit allows you to develop as you would on the desktop without redeploying. @@ -126,7 +126,7 @@ When you change the files in your Web IDE, they are automatically redeployed to **NOTE:** For a more consistent experience when using the Live Edit feature of {{site.data.keyword.Bluemix_notm}} Live Sync, 256MB of additional memory is required and will be added. -##{{site.data.keyword.Bluemix_notm}} Live Debug {: #live-debug} +## {{site.data.keyword.Bluemix_notm}} Live Debug {: #live-debug} You can access {{site.data.keyword.Bluemix_notm}} Live Sync Debug feature when {{site.data.keyword.Bluemix_notm}} Live Sync is enabled for your Node.js app. @@ -138,7 +138,7 @@ With debug, you can dynamically edit code, insert breakpoints, step through code * Debug by using [node-inspector ![External link icon](../icons/launch-glyph.svg "External link icon")](https://github.com/node-inspector/node-inspector){:new_window} * Shell access -###Application runtime control {: #app-runtime} +### Application runtime control {: #app-runtime} With the application runtime control, you can use Debug to inspect the app's state at start time. This capability is useful when you are troubleshooting an app that crashes on start. @@ -147,7 +147,7 @@ While you are developing your app, you can select from the following actions: * Perform a quick restart of the app * Suspend the app before any app code runs -###Debug {: #debug} +### Debug {: #debug} Debug includes the following capabilities: @@ -159,13 +159,13 @@ Debug includes the following capabilities: * View debug output from `console.log()` calls immediately. This action is faster than monitoring cf logs. * Use the built-in source code editor to make immediate, yet temporary, changes to the running app code. -###Shell {: #shell} +### Shell {: #shell} This tool gives you shell access to the container in which your app is running. By using this terminal, you can remotely run diagnostic shell commands to administer your app. Monitor memory and CPU usage within the instance that uses standard Linux commands, such as **top**, **ps**, and **kill**. -###Configuring an app to enable {{site.data.keyword.Bluemix_notm}} Live Debug {: #configure_app_debug} +### Configuring an app to enable {{site.data.keyword.Bluemix_notm}} Live Debug {: #configure_app_debug} The app must use the IBM SDK for Node.js buildpack. Custom buildpacks are not supported. @@ -194,7 +194,7 @@ Push the app and then browse to `https://app-host.mybluemix.net/bluemix-debug/ma **Note**: Your user ID for DevOps Services can be either an IBMid or a federated ID (corporate ID). If you use federated authentication, to log in to your Bluemix Live Sync command-line client, you must use a personal access token instead of a password. If you don't use federated authentication, your IBMid and password work with all clients. For more information about creating a personal access token, see [What's federated authentication and how does it affect me?![External link icon](../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/devops-services/2016/06/23/whats-federated-authentication-and-how-does-it-affect-me/){:new_window} --> -###Restoring app configurations and disabling Bluemix Live Debug {: #restore_live_debug} +### Restoring app configurations and disabling Bluemix Live Debug {: #restore_live_debug} 1. Remove the ENABLE_BLUEMIX_DEV_MODE environment variable from the app `manifest.yml` file. diff --git a/develop/deploy_button.md b/develop/deploy_button.md index e8d629904..effe2559a 100644 --- a/develop/deploy_button.md +++ b/develop/deploy_button.md @@ -12,7 +12,7 @@ lastupdated: "2017-4-7" {:codeblock: .codeblock} -#Creating a Deploy to {{site.data.keyword.Bluemix_notm}} button {: #deploy-button} +# Creating a Deploy to {{site.data.keyword.Bluemix_notm}} button {: #deploy-button} The Deploy to {{site.data.keyword.Bluemix}} button is an efficient way to share your public Git-sourced app so that other people can experiment with the code and deploy it to IBM {{site.data.keyword.Bluemix_notm}}. The button requires minimal configuration and you can insert it anywhere that supports markup. Anyone who clicks the button creates a cloned copy of the code in a new Git repository so that your original app remains unaffected. {: shortdesc} @@ -37,7 +37,7 @@ When someone clicks your button, these actions occur: 7. The app is deployed to the person's {{site.data.keyword.Bluemix_notm}} organization. -##Examples of the button {: #button-examples} +## Examples of the button {: #button-examples} See an app button example for a public {{site.data.keyword.jazzhub_short}} repository: @@ -57,7 +57,7 @@ See a button example for an app that is deployed in a {{site.data.keyword.Bluemi Deploy to Bluemix

-##Creating a button {: #create-button} +## Creating a button {: #create-button} To create a Deploy to {{site.data.keyword.Bluemix_notm}} button: @@ -101,7 +101,7 @@ Default master branch: -##Snippet considerations for the button {: #button-snippet} +## Snippet considerations for the button {: #button-snippet} Review these considerations when you are customizing the snippet for your Deploy to Bluemix button. @@ -115,7 +115,7 @@ Review these considerations when you are customizing the snippet for your Deploy * If you want to use a translated version of the button, you can reference it remotely or download it from [ftp://public.dhe.ibm.com/cloud/bluemix/deploy_button ![External link icon](../icons/launch-glyph.svg "External link icon")](ftp://public.dhe.ibm.com/cloud/bluemix/deploy_button){:new_window}. -##Repository considerations for the button {: #button-repo} +## Repository considerations for the button {: #button-repo} Review these considerations for the project repository that you will use in your Deploy to Bluemix button. diff --git a/develop/nl/de/deploy_button.md b/develop/nl/de/deploy_button.md index 672ee92cb..26849e964 100644 --- a/develop/nl/de/deploy_button.md +++ b/develop/nl/de/deploy_button.md @@ -12,7 +12,7 @@ lastupdated: "2017-2-21" {:codeblock: .codeblock} -#Schaltfläche für die Bereitstellung in {{site.data.keyword.Bluemix_notm}} erstellen {: #deploy-button} +# Schaltfläche für die Bereitstellung in {{site.data.keyword.Bluemix_notm}} erstellen {: #deploy-button} Die Schaltfläche für die Bereitstellung in {{site.data.keyword.Bluemix}} bietet eine effiziente Möglichkeit, die auf Git basierende öffentliche App zu teilen, sodass andere Personen mit dem Code experimentieren und diesen in IBM {{site.data.keyword.Bluemix_notm}} bereitstellen können. Die Schaltfläche erfordert nur minimalen Konfigurationsaufwand und kann überall dort eingefügt werden, wo Markupunterstützung bereitsteht. Jeder, der auf diese Schaltfläche klickt, erstellt eine geklonte Kopie des Codes in einem neuen Git-Repository, sodass die ursprüngliche App unverändert bleibt. {: shortdesc} @@ -37,7 +37,7 @@ Wenn eine Person auf die Schaltfläche klickt, werden folgende Aktionen ausgefü 7. Die App wird in der {{site.data.keyword.Bluemix_notm}}-Organisation der Person bereitgestellt. -##Beispiele für die Schaltfläche {: #button-examples} +## Beispiele für die Schaltfläche {: #button-examples} Beispiel für eine App-Schaltfläche für ein öffentliches {{site.data.keyword.jazzhub_short}}-Repository: @@ -57,7 +57,7 @@ Im Folgenden sehen Sie ein Beispiel für eine Schaltfläche für eine in einem { In Bluemix bereitstellen

-##Schaltfläche erstellen {: #create-button} +## Schaltfläche erstellen {: #create-button} Gehen Sie wie folgt vor, um eine Schaltfläche für die Bereitstellung in {{site.data.keyword.Bluemix_notm}} zu erstellen: @@ -101,7 +101,7 @@ Standard-Master-Zweig: -##Aspekte zu Snippets für die Schaltfläche {: #button-snippet} +## Aspekte zu Snippets für die Schaltfläche {: #button-snippet} Ziehen Sie diese Aspekte bei der Anpassung des Snippets für Ihre Schaltfläche 'In Bluemix bereitstellen' zurate. @@ -115,7 +115,7 @@ Ziehen Sie diese Aspekte bei der Anpassung des Snippets für Ihre Schaltfläche * Wenn Sie eine übersetzte Version der Schaltfläche verwenden möchten, können Sie sie über [ftp://public.dhe.ibm.com/cloud/bluemix/deploy_button![Symbol für externen Link](../icons/launch-glyph.svg "Symbol für externen Link")](ftp://public.dhe.ibm.com/cloud/bluemix/deploy_button){:new_window} fern referenzieren oder von dort herunterladen. -##Aspekte zu Repositorys für die Schaltfläche {: #button-repo} +## Aspekte zu Repositorys für die Schaltfläche {: #button-repo} Ziehen Sie diese Aspekte für das Projektrepository zurate, das Sie für Ihre Schaltfläche 'In Bluemix bereitstellen' verwenden. diff --git a/develop/nl/es/bluemixlive.md b/develop/nl/es/bluemixlive.md index 85441bf74..93154a4a0 100644 --- a/develop/nl/es/bluemixlive.md +++ b/develop/nl/es/bluemixlive.md @@ -13,7 +13,7 @@ lastupdated: "2017-3-10" {:new_window: target="_blank"} {:pre: .pre} -#{{site.data.keyword.Bluemix_notm}} Live Sync +# {{site.data.keyword.Bluemix_notm}} Live Sync {: #live-sync} @@ -59,7 +59,7 @@ Si está desarrollando una app Java que se ejecuta en Liberty, puede depurarla de forma remota mediante [Eclipse Tools for Bluemix](/docs/manageapps/eclipsetools/eclipsetools.html#eclipsetools). -##Edición en directo {: #live-edit} +## Edición en directo {: #live-edit} Si está creando una app Node.js, al efectuar cambios en el proyecto mediante Web IDE, la característica de edición en directo de {{site.data.keyword.Bluemix_notm}} Live Sync puede actualizar rápidamente la instancia de app que se ejecuta en {{site.data.keyword.Bluemix_notm}}. La edición en directo le permite desarrollar como lo haría en el escritorio sin tener que volver a desplegar. @@ -84,7 +84,7 @@ de la barra de ejecución. **NOTA:** Para obtener una experiencia más coherente al utilizar la característica Edición en directo de {{site.data.keyword.Bluemix_notm}}, son necesarios 256 MB de memoria adicional y se añadirán. -##{{site.data.keyword.Bluemix_notm}} Live +## {{site.data.keyword.Bluemix_notm}} Live Debug {: #live-debug} Puede acceder a la característica de {{site.data.keyword.Bluemix_notm}} Live Sync Debug cuando {{site.data.keyword.Bluemix_notm}} Live Sync esté habilitado para la app Node.js. @@ -99,7 +99,7 @@ Debug incluye las siguientes características: * Depurar utilizando [node-inspector![icono de enlace externo](../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/node-inspector/node-inspector){:new_window} * Acceso a shell -###Control del tiempo de ejecución de la aplicación {: #app-runtime} +### Control del tiempo de ejecución de la aplicación {: #app-runtime} Con el control del tiempo de ejecución de la app, puede utilizar Debug para inspeccionar el estado de la app en el momento inicial. Esta función resulta útil para solucionar los problemas de una app que falla al iniciarse. @@ -109,7 +109,7 @@ Mientras esté desarrollando la app, puede elegir entre las siguientes acciones: * Realizar un reinicio rápido de la app * Suspender la app antes de que se ejecute ningún código de la app -###Depurar {: #debug} +### Depurar {: #debug} Debug incluye las siguientes funciones: @@ -121,13 +121,13 @@ Debug incluye las siguientes funciones: * Visualizar la salida de la depuración de manera inmediata desde las llamadas `console.log()`. Esta opción es más rápida que la supervisión de registros cf. * Utilizar el editor de código fuente incorporado para introducir cambios inmediatos (aunque temporales) al código de la app en ejecución. -###Shell {: #shell} +### Shell {: #shell} Esta herramienta le da acceso de shell al contenedor en el que se ejecuta la app. Con el uso de este terminal puede ejecutar, de manera remota, mandatos de diagnóstico de shell para administrar la app. Supervise el uso de la memoria y de la CPU en la instancia que utiliza mandatos estándares de Linux, como por ejemplo **top**, **ps** y **kill**. -###Configuración de una app para habilitar {{site.data.keyword.Bluemix_notm}} Live +### Configuración de una app para habilitar {{site.data.keyword.Bluemix_notm}} Live Debug {: #configure_app_debug} La app debe usar el paquete de compilación IBM SDK for Node.js. No se da soporte a los paquetes de compilación personalizados. @@ -159,7 +159,7 @@ Envíe la app y luego vaya a `https://app-host.mybluemix.net/bluemix-debug/manag **Note**: Your user ID for DevOps Services can be either an IBMid or a federated ID (corporate ID). If you use federated authentication, to log in to your Bluemix Live Sync command-line client, you must use a personal access token instead of a password. If you don't use federated authentication, your IBMid and password work with all clients. For more information about creating a personal access token, see [What's federated authentication and how does it affect me?![External link icon](../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/devops-services/2016/06/23/whats-federated-authentication-and-how-does-it-affect-me/){:new_window} --> -###Restauración de configuraciones de app e inhabilitación de Bluemix Live +### Restauración de configuraciones de app e inhabilitación de Bluemix Live Debug {: #restore_live_debug} 1. Elimine la variable de entorno ENABLE_BLUEMIX_DEV_MODE del archivo `manifest.yml` de la app. diff --git a/develop/nl/es/deploy_button_embed.md b/develop/nl/es/deploy_button_embed.md index 5a709332a..0e131ac78 100644 --- a/develop/nl/es/deploy_button_embed.md +++ b/develop/nl/es/deploy_button_embed.md @@ -11,7 +11,7 @@ lastupdated: "2017-2-21" {:new_window: target="_blank"} {:codeblock: .codeblock} -#Incluir un Desplegar en flujo {{site.data.keyword.Bluemix_notm}} iFrame +# Incluir un Desplegar en flujo {{site.data.keyword.Bluemix_notm}} iFrame {: #embed-d2bm-iframe} @@ -25,7 +25,7 @@ El flujo iFrame es útil cuando quiere mantener la estrategia de marca de la empresa. Si los usuarios pulsan el iFrame incluido, se quedan en el contenido en lugar de redirigirse al sitio web de bluemix.net. Si no le preocupa la estrategia de marca de la empresa, puede insertar un botón estándar [Desplegar en {{site.data.keyword.Bluemix_notm}}](/docs/develop/deploy_button.html) en el contenido en lugar del iFrame. -##Pasos en el flujo de iFrame {: #iframe-steps} +## Pasos en el flujo de iFrame {: #iframe-steps} 1. Si no dispone de una cuenta activa de {{site.data.keyword.Bluemix_notm}}, cree una cuenta de prueba. @@ -40,7 +40,7 @@ con un repositorio Git nuevo. 5. Se desplegará la app en su organización de {{site.data.keyword.Bluemix_notm}}. -##Ejemplo de flujo de iFrame {: #iframe-example} +## Ejemplo de flujo de iFrame {: #iframe-example}

El ejemplo de IBM @@ -51,7 +51,7 @@ Bluemix D2BM iFrameicono Para ver el origen de este ejemplo, pulse <a class=origenicono de enlace externo.

-##Incluir el flujo de iFrame {: #embed-iframe} +## Incluir el flujo de iFrame {: #embed-iframe}
  1. Cargue el programa de utilidad de JavaScript desde https://bluemix.net/deploy/embed.jsicono de enlace externo. Este diff --git a/develop/nl/fr/deploy_button_embed.md b/develop/nl/fr/deploy_button_embed.md index 8b9764b58..ee2970f33 100644 --- a/develop/nl/fr/deploy_button_embed.md +++ b/develop/nl/fr/deploy_button_embed.md @@ -11,7 +11,7 @@ lastupdated: "2017-2-21" {:new_window: target="_blank"} {:codeblock: .codeblock} -#Incorporation d'un flux de trame d'information Déployer dans {{site.data.keyword.Bluemix_notm}} +# Incorporation d'un flux de trame d'information Déployer dans {{site.data.keyword.Bluemix_notm}} {: #embed-d2bm-iframe} @@ -26,7 +26,7 @@ pouvez insérer un bouton [Déployer dans {{site.data.keyword.Bluemix_notm}}](/docs/develop/deploy_button.html) standard dans votre contenu à la place de la trame d'information. -##Etapes du flux de trame d'information {: #iframe-steps} +## Etapes du flux de trame d'information {: #iframe-steps} 1. Si vous ne disposez pas d'un compte {{site.data.keyword.Bluemix_notm}} actif, créez un compte d'essai. @@ -41,7 +41,7 @@ nom d'application précédent, de votre nom d'utilisateur et de l'heure. 5. L'application est déployée dans votre organisation {{site.data.keyword.Bluemix_notm}}. -##Exemple de flux de trame d'information {: #iframe-example} +## Exemple de flux de trame d'information {: #iframe-example}

    L'exemple IBM Bluemix D2BM iFrameExternal link icon fournit un exemple de flux de trame d'information pour un référentiel Git public.

    Exemple de flux de trame d'information Déployer dans Bluemix
    @@ -51,7 +51,7 @@ L'sourceExternal link icon.

    -##Incorporation du flux de trame d'information {: #embed-iframe} +## Incorporation du flux de trame d'information {: #embed-iframe}
    1. Chargez l'utilitaire JavaScript depuis https://bluemix.net/deploy/embed.jsExternal link icon. Cet utilitaire dépend de jQuery. Pour le charger, ajoutez la balise de script suivante à votre document : diff --git a/develop/nl/fr/index.md b/develop/nl/fr/index.md index 48f4d175c..5faf45989 100644 --- a/develop/nl/fr/index.md +++ b/develop/nl/fr/index.md @@ -16,7 +16,7 @@ copyright: {:screen: .screen} {:new_window: target="_blank"} -#Développement d'applications +# Développement d'applications {: #develop-apps-IDS} *Dernière mise à jour : 07 décembre 2015* @@ -24,7 +24,7 @@ copyright: Vous pouvez développer des applications dans un environnement de développement intégré (IDE) ou un éditeur de texte, ou avec {{site.data.keyword.jazzhub}}. {: shortdesc} -##Développement d'applications avec Bluemix DevOps Services +## Développement d'applications avec Bluemix DevOps Services {: #dev_ops} Vous pouvez utiliser {{site.data.keyword.jazzhub_short}} pour développer une application, en effectuer le suivi et la planifier dans le cloud, puis la déployer dans {{site.data.keyword.Bluemix_notm}}. Vous pouvez passer du code source à une application opérationnelle en quelques minutes. diff --git a/develop/nl/fr/sharetextpipelines.md b/develop/nl/fr/sharetextpipelines.md index 4a5de3517..412779c72 100644 --- a/develop/nl/fr/sharetextpipelines.md +++ b/develop/nl/fr/sharetextpipelines.md @@ -11,7 +11,7 @@ lastupdated: "2016-12-21" {:new_window: target="_blank"} {:codeblock: .codeblock} -#Partage de pipelines reposant sur du texte dans les exemples de projet {{site.data.keyword.jazzhub_short}} {: #share-pipeline} +# Partage de pipelines reposant sur du texte dans les exemples de projet {{site.data.keyword.jazzhub_short}} {: #share-pipeline} Dans le cas d'exemples de projet déployés dans {{site.data.keyword.Bluemix_notm}} via le bouton Déployer dans {{site.data.keyword.Bluemix_notm}}, vous pouvez définir des configurations de pipeline {{site.data.keyword.jazzhub_short}} sous forme de fichiers YAML. Les pipelines définis sous forme de texte peuvent être partagés pour que les personnes qui dévient votre projet n'aient pas à configurer leurs propres pipelines. Cette fonction est en cours de développement : le format YAML et son implémentation peuvent changer à tout moment. Actuellement, cette fonction n'est disponible que pour les projets avec Git et les référentiels GitHub qui ciblent {{site.data.keyword.Bluemix_notm}}. {: shortdesc} @@ -76,7 +76,7 @@ stages: ``` {: codeblock} -##Syntaxe du fichier YAML {: #yaml-syntax} +## Syntaxe du fichier YAML {: #yaml-syntax} N'importe quel pipeline peut être représenté textuellement avec la syntaxe ci-dessous. @@ -153,13 +153,13 @@ space: ``` {: codeblock} -##Travaux d'extension et définitions d'extension {: #extension-jobs} +## Travaux d'extension et définitions d'extension {: #extension-jobs} Les définitions d'extension définissent l'ensemble de propriétés disponibles pour les travaux d'extension. Un travail est traité comme un travail d'extension lorsque la propriété `extension_id` est spécifiée. Pour identifier les propriétés disponibles pour une extension, consultez la documentation associée à l'extension. -##Interaction avec des pipelines à l'aide d'un fichier YAML {: #pipeline-yaml} +## Interaction avec des pipelines à l'aide d'un fichier YAML {: #pipeline-yaml} **VARIABLES D'ENVIRONNEMENT ET RESOLUTION** diff --git a/develop/nl/it/bluemixlive.md b/develop/nl/it/bluemixlive.md index 200af1126..bc1f3bfcf 100644 --- a/develop/nl/it/bluemixlive.md +++ b/develop/nl/it/bluemixlive.md @@ -1,184 +1,184 @@ ---- - - - -copyright: - years: 2015，2017 -lastupdated: "2017-3-10" - ---- - -{:shortdesc: .shortdesc} -{:screen: .screen} -{:new_window: target="_blank"} -{:pre: .pre} - -#{{site.data.keyword.Bluemix_notm}} Live Sync -{: #live-sync} - - -Se stai creando un'applicazione Node.js, puoi utilizzare {{site.data.keyword.Bluemix}} Live Sync per aggiornare rapidamente l'istanza dell'applicazione su {{site.data.keyword.Bluemix_notm}} e sviluppare senza la ridistribuzione manuale. -{: shortdesc} - -Quando apporti una modifica, -puoi vedere tale modifica nell'applicazione {{site.data.keyword.Bluemix_notm}} in esecuzione -immediatamente. {{site.data.keyword.Bluemix_notm}} Live Sync funziona - -in Eclipse Orion Web IDE (Web IDE). Puoi eseguire il debug delle applicazioni scritte in Node.js utilizzando {{site.data.keyword.Bluemix_notm}} Live Sync. - -{{site.data.keyword.Bluemix_notm}} Live Sync si articola in due funzioni. - - - - -**Live Edit** - -Puoi apportare modifiche a un'applicazione Node.js in esecuzione in {{site.data.keyword.Bluemix_notm}} e verificarla subito nel tuo browser. Qualsiasi modifica da te apportata nel Web IDE viene propagata immediatamente al file system dell'applicazione. - -**Debug** - -Mentre un'applicazione Node.js è in modalità Live Edit, puoi accedere a essa mediante shell ed -eseguirne il debug. Puoi modificare il codice in modo dinamico, inserire dei punti -di interruzione, analizzare in dettaglio il codice, riavviare il runtime e altro ancora, -utilizzando il programma di debug Node Inspector. - - - -Puoi utilizzare Live Edit per propagare le modifiche nello spazio di lavoro del progetto basato sul cloud alla tua -applicazione in esecuzione. - -Se utilizzi Live Edit per passare la tua applicazione alla modalità Live Edit, puoi eseguire il debug della tua applicazione in esecuzione. - - -Il processo Bluemix Live Sync è illustrato nel seguente diagramma. - -Figura 1. Processo Bluemix Live Sync - - -![Immagine del processo Bluemix Live Sync](images/bluemix-live-sync.png) - -Se stai sviluppando un'applicazione Java in esecuzione su Liberty, puoi eseguire il debug in remoto utilizzando [Eclipse Tools for Bluemix](/docs/manageapps/eclipsetools/eclipsetools.html#eclipsetools). - - -##Live Edit {: #live-edit} - -Se stai creando un'applicazione Node.js, quando apporti modifiche al tuo progetto utilizzando Web IDE, la funzione Live Edit di {{site.data.keyword.Bluemix_notm}} Live Sync può aggiornare rapidamente l'istanza dell'applicazione in esecuzione su {{site.data.keyword.Bluemix_notm}}. Live Edit ti consente di effettuare attività di sviluppo come faresti sul desktop senza eseguire nuovamente la distribuzione. - -Live Edit è supportato solo per le applicazioni Node.js. - -In Eclipse Orion Web IDE (Web IDE), nella barra di esecuzione, fai clic su **Live Edit**. - -![Immagine della barra di esecuzione con Live Edit](images/bluemix-live-sync-light.png) - -Live Edit ti consente di visualizzare rapidamente in anteprima le modifiche alle applicazioni Node.js in esecuzione su {{site.data.keyword.Bluemix_notm}}. Quando aggiorni -il tuo codice con Live Edit attivato, puoi aggiornare la finestra del browser -della tua applicazione web per vedere tali modifiche riflesse entro pochi secondi -da quando le hai apportate. - - - -Quando modifichi i file nel tuo Web IDE, ne viene eseguita automaticamente la ridistribuzione alla tua applicazione in esecuzione su {{site.data.keyword.Bluemix_notm}}. Se devi riavviare l'applicazione Node, puoi utilizzare il pulsante **Riavvia** nella barra di esecuzione. - -**NOTA:** per un'esperienza più congruente durante l'utilizzo della funzione Live Edit di {{site.data.keyword.Bluemix_notm}} Live Sync, sono richiesti 256MB di ulteriore memoria e saranno aggiunti. - -##Debug di {{site.data.keyword.Bluemix_notm}} -Live {: #live-debug} - -Puoi accedere alla funzione Debug di {{site.data.keyword.Bluemix_notm}} Live Sync se {{site.data.keyword.Bluemix_notm}} Live Sync è abilitato per la tua applicazione Node.js. - -Con la funzione di debug, puoi modificare il codice in modo dinamico, inserire dei punti di interruzione, analizzare in dettaglio il codice, riavviare il runtime e altro ancora, e tutto questo mentre la tua applicazione viene servita da {{site.data.keyword.Bluemix_notm}}. Puoi sviluppare in modo incrementale la tua applicazione in modo agile, grazie alla possibilità di scegliere -da un ampio elenco di servizi {{site.data.keyword.Bluemix_notm}}. - -Debug di {{site.data.keyword.Bluemix_notm}} Live -include le seguenti funzioni: - -* Controllo del runtime dell'applicazione -* Debug utilizzando [node-inspector![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://github.com/node-inspector/node-inspector){:new_window} -* Accesso shell - -###Controllo del runtime dell'applicazione {: #app-runtime} - -Con il controllo del runtime dell'applicazione, puoi utilizzare Debug -per ispezionare lo stato dell'applicazione in fase di avvio. Questa funzionalità è utile -quando cerchi di risolvere il problema di un'applicazione che si arresta in modo anomalo all'avvio. - -Mentre sviluppi la tua applicazione, puoi scegliere tra le seguenti -azioni: - -* Eseguire un rapido riavvio dell'applicazione -* Sospendere l'applicazione prima di eventuali esecuzioni di codice - -###Debug {: #debug} - -Debug include le seguenti funzionalità: - -**Limitazione:** è richiesto Google Chrome. - -* Impostare dei punti di interruzione nel codice applicativo per mettere in pausa l'esecuzione a una specifica -riga. -* Modificare le condizioni del punto di interruzione per mettere in pausa l'esecuzione -sono quando sono soddisfatti degli specifici criteri. -* Controllare lo stato di campi e variabili locali. -* Visualizzare l'output di debug dalle chiamate `console.log()` immediatamente. Quest'azione -è più rapida del monitoraggio dei log cf. -* Utilizzare l'editor di codice sorgente integrato per apportare delle modifiche -immediate, seppur temporanee, al codice applicativo in esecuzione. - -###Shell {: #shell} - -Questo strumento ti dà l'accesso shell al contenitore in cui -è in esecuzione la tua applicazione. Usando questo terminale, puoi eseguire in remoto -dei comandi shell di diagnostica per amministrare la tua applicazione. - -Esegui il monitoraggio della memoria e dell'utilizzo della CPU all'interno dell'istanza che utilizza i comandi Linux standard, come **top**, **ps** e **kill**. - -###Configurazione di un'applicazione per abilitare Debug di {{site.data.keyword.Bluemix_notm}} -Live {: #configure_app_debug} - -L'applicazione deve utilizzare il pacchetto di build IBM SDK for Node.js. I pacchetti di build personalizzati non sono supportati. - -1. Consenti al pacchetto di build di rilevare il comando di avvio applicazione. Il comando start deve essere rilevato automaticamente dal pacchetto di build, non impostato nel file `manifest.yml`. - - a. Assicurati che il file `package.json` contenga uno script start che include un comando start per l'applicazione. - b. Se il file `manifest.yml` dell'applicazione contiene un comando, impostalo su null. - -2. Imposta la variabile di ambiente. - - a. Nel file `manifest.yml`, aggiungi questa variabile: - ``` - env: - ENABLE_BLUEMIX_DEV_MODE: "true" - ``` - -3. Aumenta la memoria. - - a. Nel file `manifest.yml` dell'applicazione, aggiungi 128 M o più al valore specificato per l'attributo memoria. - -Una volta installato Debug di {{site.data.keyword.Bluemix_notm}} Live, -puoi utilizzare gli strumenti debug. - -Distribuisci l'applicazione e vai quindi a `https://app-host.mybluemix.net/bluemix-debug/manage` per accedere all'interfaccia utente di debug {{site.data.keyword.Bluemix_notm}}. Quando ti viene richiesto di autenticarti, immetti il tuo ID utente e il token di accesso personale o la password dell'ID IBM. - - - -###Ripristino delle configurazioni dell'applicazione e disabilitazione di Debug di Bluemix Live {: #restore_live_debug} - -1. Rimuovi la variabile di ambiente ENABLE_BLUEMIX_DEV_MODE dal file `manifest.yml` dell'applicazione. - -2. Ripristina il comando di avvio originale e il valore di memoria dell'applicazione. - -3. Distribuisci l'applicazione. - - -## Link correlati -{: #general} - -* [Eclipse tools for Bluemix![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://www.ng.bluemix.net/docs/manageapps/eclipsetools/eclipsetools.html){:new_window} +--- + + + +copyright: + years: 2015，2017 +lastupdated: "2017-3-10" + +--- + +{:shortdesc: .shortdesc} +{:screen: .screen} +{:new_window: target="_blank"} +{:pre: .pre} + +# {{site.data.keyword.Bluemix_notm}} Live Sync +{: #live-sync} + + +Se stai creando un'applicazione Node.js, puoi utilizzare {{site.data.keyword.Bluemix}} Live Sync per aggiornare rapidamente l'istanza dell'applicazione su {{site.data.keyword.Bluemix_notm}} e sviluppare senza la ridistribuzione manuale. +{: shortdesc} + +Quando apporti una modifica, +puoi vedere tale modifica nell'applicazione {{site.data.keyword.Bluemix_notm}} in esecuzione +immediatamente. {{site.data.keyword.Bluemix_notm}} Live Sync funziona + +in Eclipse Orion Web IDE (Web IDE). Puoi eseguire il debug delle applicazioni scritte in Node.js utilizzando {{site.data.keyword.Bluemix_notm}} Live Sync. + +{{site.data.keyword.Bluemix_notm}} Live Sync si articola in due funzioni. + + + + +**Live Edit** + +Puoi apportare modifiche a un'applicazione Node.js in esecuzione in {{site.data.keyword.Bluemix_notm}} e verificarla subito nel tuo browser. Qualsiasi modifica da te apportata nel Web IDE viene propagata immediatamente al file system dell'applicazione. + +**Debug** + +Mentre un'applicazione Node.js è in modalità Live Edit, puoi accedere a essa mediante shell ed +eseguirne il debug. Puoi modificare il codice in modo dinamico, inserire dei punti +di interruzione, analizzare in dettaglio il codice, riavviare il runtime e altro ancora, +utilizzando il programma di debug Node Inspector. + + + +Puoi utilizzare Live Edit per propagare le modifiche nello spazio di lavoro del progetto basato sul cloud alla tua +applicazione in esecuzione. + +Se utilizzi Live Edit per passare la tua applicazione alla modalità Live Edit, puoi eseguire il debug della tua applicazione in esecuzione. + + +Il processo Bluemix Live Sync è illustrato nel seguente diagramma. + +Figura 1. Processo Bluemix Live Sync + + +![Immagine del processo Bluemix Live Sync](images/bluemix-live-sync.png) + +Se stai sviluppando un'applicazione Java in esecuzione su Liberty, puoi eseguire il debug in remoto utilizzando [Eclipse Tools for Bluemix](/docs/manageapps/eclipsetools/eclipsetools.html#eclipsetools). + + +## Live Edit {: #live-edit} + +Se stai creando un'applicazione Node.js, quando apporti modifiche al tuo progetto utilizzando Web IDE, la funzione Live Edit di {{site.data.keyword.Bluemix_notm}} Live Sync può aggiornare rapidamente l'istanza dell'applicazione in esecuzione su {{site.data.keyword.Bluemix_notm}}. Live Edit ti consente di effettuare attività di sviluppo come faresti sul desktop senza eseguire nuovamente la distribuzione. + +Live Edit è supportato solo per le applicazioni Node.js. + +In Eclipse Orion Web IDE (Web IDE), nella barra di esecuzione, fai clic su **Live Edit**. + +![Immagine della barra di esecuzione con Live Edit](images/bluemix-live-sync-light.png) + +Live Edit ti consente di visualizzare rapidamente in anteprima le modifiche alle applicazioni Node.js in esecuzione su {{site.data.keyword.Bluemix_notm}}. Quando aggiorni +il tuo codice con Live Edit attivato, puoi aggiornare la finestra del browser +della tua applicazione web per vedere tali modifiche riflesse entro pochi secondi +da quando le hai apportate. + + + +Quando modifichi i file nel tuo Web IDE, ne viene eseguita automaticamente la ridistribuzione alla tua applicazione in esecuzione su {{site.data.keyword.Bluemix_notm}}. Se devi riavviare l'applicazione Node, puoi utilizzare il pulsante **Riavvia** nella barra di esecuzione. + +**NOTA:** per un'esperienza più congruente durante l'utilizzo della funzione Live Edit di {{site.data.keyword.Bluemix_notm}} Live Sync, sono richiesti 256MB di ulteriore memoria e saranno aggiunti. + +## Debug di {{site.data.keyword.Bluemix_notm}} +Live {: #live-debug} + +Puoi accedere alla funzione Debug di {{site.data.keyword.Bluemix_notm}} Live Sync se {{site.data.keyword.Bluemix_notm}} Live Sync è abilitato per la tua applicazione Node.js. + +Con la funzione di debug, puoi modificare il codice in modo dinamico, inserire dei punti di interruzione, analizzare in dettaglio il codice, riavviare il runtime e altro ancora, e tutto questo mentre la tua applicazione viene servita da {{site.data.keyword.Bluemix_notm}}. Puoi sviluppare in modo incrementale la tua applicazione in modo agile, grazie alla possibilità di scegliere +da un ampio elenco di servizi {{site.data.keyword.Bluemix_notm}}. + +Debug di {{site.data.keyword.Bluemix_notm}} Live +include le seguenti funzioni: + +* Controllo del runtime dell'applicazione +* Debug utilizzando [node-inspector![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://github.com/node-inspector/node-inspector){:new_window} +* Accesso shell + +### Controllo del runtime dell'applicazione {: #app-runtime} + +Con il controllo del runtime dell'applicazione, puoi utilizzare Debug +per ispezionare lo stato dell'applicazione in fase di avvio. Questa funzionalità è utile +quando cerchi di risolvere il problema di un'applicazione che si arresta in modo anomalo all'avvio. + +Mentre sviluppi la tua applicazione, puoi scegliere tra le seguenti +azioni: + +* Eseguire un rapido riavvio dell'applicazione +* Sospendere l'applicazione prima di eventuali esecuzioni di codice + +### Debug {: #debug} + +Debug include le seguenti funzionalità: + +**Limitazione:** è richiesto Google Chrome. + +* Impostare dei punti di interruzione nel codice applicativo per mettere in pausa l'esecuzione a una specifica +riga. +* Modificare le condizioni del punto di interruzione per mettere in pausa l'esecuzione +sono quando sono soddisfatti degli specifici criteri. +* Controllare lo stato di campi e variabili locali. +* Visualizzare l'output di debug dalle chiamate `console.log()` immediatamente. Quest'azione +è più rapida del monitoraggio dei log cf. +* Utilizzare l'editor di codice sorgente integrato per apportare delle modifiche +immediate, seppur temporanee, al codice applicativo in esecuzione. + +### Shell {: #shell} + +Questo strumento ti dà l'accesso shell al contenitore in cui +è in esecuzione la tua applicazione. Usando questo terminale, puoi eseguire in remoto +dei comandi shell di diagnostica per amministrare la tua applicazione. + +Esegui il monitoraggio della memoria e dell'utilizzo della CPU all'interno dell'istanza che utilizza i comandi Linux standard, come **top**, **ps** e **kill**. + +### Configurazione di un'applicazione per abilitare Debug di {{site.data.keyword.Bluemix_notm}} +Live {: #configure_app_debug} + +L'applicazione deve utilizzare il pacchetto di build IBM SDK for Node.js. I pacchetti di build personalizzati non sono supportati. + +1. Consenti al pacchetto di build di rilevare il comando di avvio applicazione. Il comando start deve essere rilevato automaticamente dal pacchetto di build, non impostato nel file `manifest.yml`. + + a. Assicurati che il file `package.json` contenga uno script start che include un comando start per l'applicazione. + b. Se il file `manifest.yml` dell'applicazione contiene un comando, impostalo su null. + +2. Imposta la variabile di ambiente. + + a. Nel file `manifest.yml`, aggiungi questa variabile: + ``` + env: + ENABLE_BLUEMIX_DEV_MODE: "true" + ``` + +3. Aumenta la memoria. + + a. Nel file `manifest.yml` dell'applicazione, aggiungi 128 M o più al valore specificato per l'attributo memoria. + +Una volta installato Debug di {{site.data.keyword.Bluemix_notm}} Live, +puoi utilizzare gli strumenti debug. + +Distribuisci l'applicazione e vai quindi a `https://app-host.mybluemix.net/bluemix-debug/manage` per accedere all'interfaccia utente di debug {{site.data.keyword.Bluemix_notm}}. Quando ti viene richiesto di autenticarti, immetti il tuo ID utente e il token di accesso personale o la password dell'ID IBM. + + + +### Ripristino delle configurazioni dell'applicazione e disabilitazione di Debug di Bluemix Live {: #restore_live_debug} + +1. Rimuovi la variabile di ambiente ENABLE_BLUEMIX_DEV_MODE dal file `manifest.yml` dell'applicazione. + +2. Ripristina il comando di avvio originale e il valore di memoria dell'applicazione. + +3. Distribuisci l'applicazione. + + +## Link correlati +{: #general} + +* [Eclipse tools for Bluemix![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://www.ng.bluemix.net/docs/manageapps/eclipsetools/eclipsetools.html){:new_window} diff --git a/develop/nl/it/deploy_button.md b/develop/nl/it/deploy_button.md index 80c66fcf3..5ea9f6570 100644 --- a/develop/nl/it/deploy_button.md +++ b/develop/nl/it/deploy_button.md @@ -1,210 +1,210 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-2-21" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:codeblock: .codeblock} - - -#Creazione di un pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}} {: #deploy-button} - -Il pulsante Distribuisci a {{site.data.keyword.Bluemix}} è un modo efficiente per condividere la tua applicazione originata da Git pubblica in modo che altri utenti possano sperimentarne il codice ed eseguirne la distribuzione a IBM {{site.data.keyword.Bluemix_notm}}. Il pulsante -richiede una configurazione minima e puoi inserirlo dovunque siano supportate le markup. Un utente che fa clic sul pulsante crea -una copia clonata del codice in un nuovo repository Git in modo che la tua applicazione originale rimanga invariata. -{: shortdesc} - -**Suggerimento:** se il branding dell'azienda è importante, puoi [incorporare un flusso iFrame Distribuisci a {{site.data.keyword.Bluemix_notm}}](/docs/develop/deploy_button_embed.html) nel tuo contenuto invece di inserire un pulsante. Quando le persone creano una copia clonata della tua applicazione -originata da Git pubblica, restano nel tuo contenuto invece di essere reindirizzati al sito web di bluemix.net. - -**Nota**: è ora disponibile la funzione toolchain. Chiunque faccia clic sul pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}}, può selezionare il link nel banner per provare a distribuire la propria applicazione utilizzando una toolchain. - -Quando qualcuno fa clic sul tuo pulsante, si verificano le seguenti azioni: - -1. Se la persona non ha un account {{site.data.keyword.Bluemix_notm}} attivo, -è necessario che venga creato un account di prova. - -2. La persona può selezionare una regione, organizzazione, spazio e nome applicazione. Il nome applicazione consigliato viene creato in base al nome applicazione precedente, -al nome utente della persona e all'ora. - -3. Il ramo master del repository Git pubblico originale viene clonato in un nuovo progetto {{site.data.keyword.jazzhub_title}} privato con un nuovo repository Git. - -4. Se l'applicazione richiede un file di build, esso viene rilevato automaticamente e l'applicazione viene creata. - -5. Se per il processo di creazione e distribuzione è stata configurata una pipeline, l'applicazione viene distribuita con un file `pipeline.yml`. - -6. Se l'applicazione richiede un contenitore, per distribuire l'applicazione in un contenitore {{site.data.keyword.Bluemix_notm}} vengono utilizzati un file `pipeline.yml`, che definisce il servizio **IBM Containers**, e un Dockerfile, che definisce un'immagine. - -7. L'applicazione viene distribuita all'organizzazione {{site.data.keyword.Bluemix_notm}} della persona. - -##Esempi del pulsante {: #button-examples} - -Vedi un esempio di pulsante dell'applicazione per un repository {{site.data.keyword.jazzhub_short}} pubblico: - -

      -Distribuisci a Bluemix -

      - -Vedi -un esempio di pulsante dell'applicazione per un repository GitHub pubblico: - -

      -Distribuisci a Bluemix -

      - -Vedi un esempio -di pulsante per un'applicazione distribuita in un contenitore {{site.data.keyword.Bluemix_notm}}: - -

      -Distribuisci a Bluemix -

      - -##Creazione di un pulsante {: #create-button} - -Per creare un pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}}: - -
        -
      1. Copia e modifica uno dei seguenti template di frammento e includi un repository Git pubblico. -

        -

        -Suggerimento: se vuoi specificare l'input di build per un progetto DevOps Services, aggiungi un parametro di ramo all'URL Git. Quando aggiungi un parametro di ramo, il repository Git pubblico originale, inclusi tutti i sui rami, viene clonato in un nuovo progetto DevOps Services privato con un nuovo repository Git. Il ramo Git specificato viene impostato come input per il lavoro di build. Se non specifichi un ramo, l'input per il lavoro di build viene impostato sul ramo master per impostazione predefinita. -

        -
          -
        • HTML: -

          -Ramo master predefinito: -

          -
          -<a href="https://bluemix.net/deploy?repository=<git_repository_URL>" # [required]><img src="https://bluemix.net/deploy/button.png" alt="Deploy to Bluemix"></a>
-
          -

          -Ramo Git specificato: -

          -
          -<a href="https://bluemix.net/deploy?repository=<git_repository_URL>&branch=<git_branch>" # [required]><img src="https://bluemix.net/deploy/button.png" alt="Deploy to Bluemix"></a>
-
          -
          • -
        • Markdown: -

          -Ramo master predefinito: -

          -
          -[![Deploy to Bluemix](https://bluemix.net/deploy/button.png)](https://bluemix.net/deploy?repository=<git_repository_URL> # [required])
-
          -

          Ramo Git specificato: -

          -
          -[![Deploy to Bluemix](https://bluemix.net/deploy/button.png)](https://bluemix.net/deploy?repository=<git_repository_URL> &branch=<git_branch> # [required])
-
          -
          • -
        -
        2. -
      2. Inserisci il frammento in blog, articoli, wiki, file readme o dovunque tu desideri -promuovere la tua applicazione. -
        3. -
      - -##Considerazione sul frammento per il pulsante {: #button-snippet} - -Consulta queste considerazioni quando personalizzi il frammento per il pulsante Distribuisci a Bluemix. - -* Entrambi i template utilizzano un percorso predefinito a un'immagine pulsante esterna in formato PNG e in inglese. - - * Se preferisci utilizzare un'immagine SVG per il pulsante invece di un PNG, è disponibile una versione SVG. Puoi modificare il -percorso all'immagine pulsante esterna utilizzata nel frammento impostandolo come `https://bluemix.net/deploy/button.svg`. - - * Se preferisci utilizzare un'immagine più grande per il pulsante, è disponibile un'immagine PNG la cui dimensione è il doppio di quella originale. Puoi -modificare il percorso dell'immagine pulsante esterna utilizzata nel frammento impostandolo come `https://bluemix.net/deploy/button_x2.png`. - - * Se preferisci memorizzare l'immagine localmente, puoi scaricare l'immagine e memorizzarla nel repository Git. Regola il percorso per utilizzare l'ubicazione relativa dell'immagine. - - * Se vuoi utilizzare una versione tradotta del pulsante, puoi fare riferimento a esso in remoto oppure scaricarlo da [ftp://public.dhe.ibm.com/cloud/bluemix/deploy_button![icona link esterno](../icons/launch-glyph.svg "External link icon")](ftp://public.dhe.ibm.com/cloud/bluemix/deploy_button){:new_window}. - -##Considerazione sul repository per il pulsante {: #button-repo} - -Consulta queste considerazioni per il repository del progetto che utilizzerai nel pulsante Distribuisci a Bluemix. - -
        -
      • Non è necessario che un manifest.yml sia presente nel -tuo repository. Tuttavia, se la tua applicazione richiede che siano eseguiti degli altri servizi, devi -fornire un file manifest che dichiara tali servizi. - -Con il file manifest, puoi specificare: -
          -
        • Un nome applicazioni univoco.
          • -
        • Declared services: un'estensione manifest, che crea o cerca i servizi obbligatori o facoltativi -di cui è prevista la configurazione prima che venga distribuita l'applicazione, come ad esempio -il servizio di memorizzazione nella cache dei dati. Puoi trovare un elenco dei piani, delle etichette e dei servizi {{site.data.keyword.Bluemix_notm}} idonei utilizzando l'interfaccia riga di comando CFicona link esterno per eseguire il comando cf marketplace oppure sfogliando il catalogo {{site.data.keyword.Bluemix_notm}} icona link esterno. - - - Nota: è un'estensione IBM del formato manifest Cloud Foundry standard. Questa estensione potrebbe essere modificata in una futura release man mano che la funzione si evolve e viene migliorata. - - Impara come creare un file manifest.yml icona link esterno. -
          -	---
-    #Template manifest.yml
-
-  declared-services:
-    <`nome_istanza_servizio_arbitrario`>:  # [obbligatorio]
-      label: <`nome_servizio_effettivo`> # [obbligatorio] Il nome servizio effettivo dal marketplace
-      plan: Shared # [facoltativo] Se fornito, utilizzato per richiamare il servizio dichiarato. Altrimenti, assume come valore predefinito 'Free' o 'free'.
-  applications:
-  - services
-    - <`nome_istanza_servizio_arbitrario`>
-    name: <`appname`>
-    host: <`apphostname`>
-
          - -
          -	---
-    #Esempio di manifest.yml
-
-  declared-services: 
-      sample-java-cloudant-cloudantNoSQLDB:
-        label: cloudantNoSQLDB
-        plan: Shared
-  applications:
-  - services
-    - sample-java-cloudant-cloudantNoSQLDB
-    name: My app
-    host: myapp
-
          -
          • -
        -
      • Se occorre creare l'applicazione prima che possa essere distribuita, devi includere un file di build nel tuo repository. Se viene rilevato un file script di build nella directory root del repository, viene attivato un build automatico del codice prima della distribuzione. - - Builder supportati: -
          -
        • Ant:icona link esterno /build.xml, che crea l'output nella cartella ./output/
          • -
        • Gradle:icona link esterno /build.gradle, che crea l'output in .
          • -
        • Grunt:icona link esterno /Gruntfile.js, che crea l'output in .
          • -
        • Maven:icona link esterno /pom.xml, che crea l'output nella cartella ./target/
          • -
        -
        • -
      • Per configurare la pipeline per il progetto, includi un file pipeline.yml in una directory .bluemix. Puoi creare un file pipeline.yml manualmente oppure puoi generarne uno da un progetto DevOps Services esistente. Per creare un file pipeline.yml da un progetto {{site.data.keyword.jazzhub_short}} e aggiungerlo al tuo repository, completa questa procedura. -
          -
        1. Apri il progetto DevOps Services in un browser e fai clic su Crea e distribuisci.
          2. -
        2. Configura la tua pipeline con i lavori di creazione e distribuzione.
          3. -
        3. Nel tuo browser, aggiungi /yaml all'URL del pipeline del progetto e premi Invio. -
          Esempio: https://hub.jazz.net/pipeline///yaml
          4. -
        4. Salva il file pipeline.yml risultante.
          5. -
        5. Nella directory root del tuo progetto, crea una directory .bluemix.
          6. -
        6. Carica il file pipeline.yml nel repository .bluemix.
          7. -
        • -
      • Per distribuire un'applicazione in un contenitore tramite IBM Containers, devi includere Dockerfile nella directory root del repository e un file pipeline.yml in una directory .bluemix. -
          -
        • Il Dockerfile agisce come una sorta di script di build per l'applicazione. Se un Dockerfile viene rilevato nel repository, l'applicazione viene integrata automaticamente in un'immagine prima che venga distribuita in un contenitore. Se la stessa applicazione deve essere creata prima di essere integrata in un'immagine, includi uno script di build per l'applicazione insieme a un Dockerfile, come descritto in precedenza.
          • -
        • Per saperne di più sulla creazione dei Dockerfile, vedi la documentazione di Dockericona link esterno.
          • -
        • Puoi creare un file pipeline.yml manualmente oppure puoi generarne uno da un progetto DevOps Services esistente. Per creare manualmente un file pipeline.yml specifico per i contenitori, vedi gli esempi in GitHubicona link esterno.
          • -
        - -
        • -
      - - -Per un aiuto nella risoluzione dei problemi, vedi [Il pulsante Distribuisci a Bluemix non distribuisce un'applicazione](/docs/troubleshoot/index.html#deploytobluemixbuttondoesntdeployanapp){:new_window}. +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-2-21" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:codeblock: .codeblock} + + +# Creazione di un pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}} {: #deploy-button} + +Il pulsante Distribuisci a {{site.data.keyword.Bluemix}} è un modo efficiente per condividere la tua applicazione originata da Git pubblica in modo che altri utenti possano sperimentarne il codice ed eseguirne la distribuzione a IBM {{site.data.keyword.Bluemix_notm}}. Il pulsante +richiede una configurazione minima e puoi inserirlo dovunque siano supportate le markup. Un utente che fa clic sul pulsante crea +una copia clonata del codice in un nuovo repository Git in modo che la tua applicazione originale rimanga invariata. +{: shortdesc} + +**Suggerimento:** se il branding dell'azienda è importante, puoi [incorporare un flusso iFrame Distribuisci a {{site.data.keyword.Bluemix_notm}}](/docs/develop/deploy_button_embed.html) nel tuo contenuto invece di inserire un pulsante. Quando le persone creano una copia clonata della tua applicazione +originata da Git pubblica, restano nel tuo contenuto invece di essere reindirizzati al sito web di bluemix.net. + +**Nota**: è ora disponibile la funzione toolchain. Chiunque faccia clic sul pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}}, può selezionare il link nel banner per provare a distribuire la propria applicazione utilizzando una toolchain. + +Quando qualcuno fa clic sul tuo pulsante, si verificano le seguenti azioni: + +1. Se la persona non ha un account {{site.data.keyword.Bluemix_notm}} attivo, +è necessario che venga creato un account di prova. + +2. La persona può selezionare una regione, organizzazione, spazio e nome applicazione. Il nome applicazione consigliato viene creato in base al nome applicazione precedente, +al nome utente della persona e all'ora. + +3. Il ramo master del repository Git pubblico originale viene clonato in un nuovo progetto {{site.data.keyword.jazzhub_title}} privato con un nuovo repository Git. + +4. Se l'applicazione richiede un file di build, esso viene rilevato automaticamente e l'applicazione viene creata. + +5. Se per il processo di creazione e distribuzione è stata configurata una pipeline, l'applicazione viene distribuita con un file `pipeline.yml`. + +6. Se l'applicazione richiede un contenitore, per distribuire l'applicazione in un contenitore {{site.data.keyword.Bluemix_notm}} vengono utilizzati un file `pipeline.yml`, che definisce il servizio **IBM Containers**, e un Dockerfile, che definisce un'immagine. + +7. L'applicazione viene distribuita all'organizzazione {{site.data.keyword.Bluemix_notm}} della persona. + +## Esempi del pulsante {: #button-examples} + +Vedi un esempio di pulsante dell'applicazione per un repository {{site.data.keyword.jazzhub_short}} pubblico: + +

      +Distribuisci a Bluemix +

      + +Vedi +un esempio di pulsante dell'applicazione per un repository GitHub pubblico: + +

      +Distribuisci a Bluemix +

      + +Vedi un esempio +di pulsante per un'applicazione distribuita in un contenitore {{site.data.keyword.Bluemix_notm}}: + +

      +Distribuisci a Bluemix +

      + +## Creazione di un pulsante {: #create-button} + +Per creare un pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}}: + +
        +
      1. Copia e modifica uno dei seguenti template di frammento e includi un repository Git pubblico. +

        +

        +Suggerimento: se vuoi specificare l'input di build per un progetto DevOps Services, aggiungi un parametro di ramo all'URL Git. Quando aggiungi un parametro di ramo, il repository Git pubblico originale, inclusi tutti i sui rami, viene clonato in un nuovo progetto DevOps Services privato con un nuovo repository Git. Il ramo Git specificato viene impostato come input per il lavoro di build. Se non specifichi un ramo, l'input per il lavoro di build viene impostato sul ramo master per impostazione predefinita. +

        +
          +
        • HTML: +

          +Ramo master predefinito: +

          +
          +<a href="https://bluemix.net/deploy?repository=<git_repository_URL>" # [required]><img src="https://bluemix.net/deploy/button.png" alt="Deploy to Bluemix"></a>
+
          +

          +Ramo Git specificato: +

          +
          +<a href="https://bluemix.net/deploy?repository=<git_repository_URL>&branch=<git_branch>" # [required]><img src="https://bluemix.net/deploy/button.png" alt="Deploy to Bluemix"></a>
+
          +
          • +
        • Markdown: +

          +Ramo master predefinito: +

          +
          +[![Deploy to Bluemix](https://bluemix.net/deploy/button.png)](https://bluemix.net/deploy?repository=<git_repository_URL> # [required])
+
          +

          Ramo Git specificato: +

          +
          +[![Deploy to Bluemix](https://bluemix.net/deploy/button.png)](https://bluemix.net/deploy?repository=<git_repository_URL> &branch=<git_branch> # [required])
+
          +
          • +
        +
        2. +
      2. Inserisci il frammento in blog, articoli, wiki, file readme o dovunque tu desideri +promuovere la tua applicazione. +
        3. +
      + +## Considerazione sul frammento per il pulsante {: #button-snippet} + +Consulta queste considerazioni quando personalizzi il frammento per il pulsante Distribuisci a Bluemix. + +* Entrambi i template utilizzano un percorso predefinito a un'immagine pulsante esterna in formato PNG e in inglese. + + * Se preferisci utilizzare un'immagine SVG per il pulsante invece di un PNG, è disponibile una versione SVG. Puoi modificare il +percorso all'immagine pulsante esterna utilizzata nel frammento impostandolo come `https://bluemix.net/deploy/button.svg`. + + * Se preferisci utilizzare un'immagine più grande per il pulsante, è disponibile un'immagine PNG la cui dimensione è il doppio di quella originale. Puoi +modificare il percorso dell'immagine pulsante esterna utilizzata nel frammento impostandolo come `https://bluemix.net/deploy/button_x2.png`. + + * Se preferisci memorizzare l'immagine localmente, puoi scaricare l'immagine e memorizzarla nel repository Git. Regola il percorso per utilizzare l'ubicazione relativa dell'immagine. + + * Se vuoi utilizzare una versione tradotta del pulsante, puoi fare riferimento a esso in remoto oppure scaricarlo da [ftp://public.dhe.ibm.com/cloud/bluemix/deploy_button![icona link esterno](../icons/launch-glyph.svg "External link icon")](ftp://public.dhe.ibm.com/cloud/bluemix/deploy_button){:new_window}. + +## Considerazione sul repository per il pulsante {: #button-repo} + +Consulta queste considerazioni per il repository del progetto che utilizzerai nel pulsante Distribuisci a Bluemix. + +
        +
      • Non è necessario che un manifest.yml sia presente nel +tuo repository. Tuttavia, se la tua applicazione richiede che siano eseguiti degli altri servizi, devi +fornire un file manifest che dichiara tali servizi. + +Con il file manifest, puoi specificare: +
          +
        • Un nome applicazioni univoco.
          • +
        • Declared services: un'estensione manifest, che crea o cerca i servizi obbligatori o facoltativi +di cui è prevista la configurazione prima che venga distribuita l'applicazione, come ad esempio +il servizio di memorizzazione nella cache dei dati. Puoi trovare un elenco dei piani, delle etichette e dei servizi {{site.data.keyword.Bluemix_notm}} idonei utilizzando l'interfaccia riga di comando CFicona link esterno per eseguire il comando cf marketplace oppure sfogliando il catalogo {{site.data.keyword.Bluemix_notm}} icona link esterno. + + + Nota: è un'estensione IBM del formato manifest Cloud Foundry standard. Questa estensione potrebbe essere modificata in una futura release man mano che la funzione si evolve e viene migliorata. + + Impara come creare un file manifest.yml icona link esterno. +
          +	---
+    #Template manifest.yml
+
+  declared-services:
+    <`nome_istanza_servizio_arbitrario`>:  # [obbligatorio]
+      label: <`nome_servizio_effettivo`> # [obbligatorio] Il nome servizio effettivo dal marketplace
+      plan: Shared # [facoltativo] Se fornito, utilizzato per richiamare il servizio dichiarato. Altrimenti, assume come valore predefinito 'Free' o 'free'.
+  applications:
+  - services
+    - <`nome_istanza_servizio_arbitrario`>
+    name: <`appname`>
+    host: <`apphostname`>
+
          + +
          +	---
+    #Esempio di manifest.yml
+
+  declared-services: 
+      sample-java-cloudant-cloudantNoSQLDB:
+        label: cloudantNoSQLDB
+        plan: Shared
+  applications:
+  - services
+    - sample-java-cloudant-cloudantNoSQLDB
+    name: My app
+    host: myapp
+
          +
          • +
        +
      • Se occorre creare l'applicazione prima che possa essere distribuita, devi includere un file di build nel tuo repository. Se viene rilevato un file script di build nella directory root del repository, viene attivato un build automatico del codice prima della distribuzione. + + Builder supportati: +
          +
        • Ant:icona link esterno /build.xml, che crea l'output nella cartella ./output/
          • +
        • Gradle:icona link esterno /build.gradle, che crea l'output in .
          • +
        • Grunt:icona link esterno /Gruntfile.js, che crea l'output in .
          • +
        • Maven:icona link esterno /pom.xml, che crea l'output nella cartella ./target/
          • +
        +
        • +
      • Per configurare la pipeline per il progetto, includi un file pipeline.yml in una directory .bluemix. Puoi creare un file pipeline.yml manualmente oppure puoi generarne uno da un progetto DevOps Services esistente. Per creare un file pipeline.yml da un progetto {{site.data.keyword.jazzhub_short}} e aggiungerlo al tuo repository, completa questa procedura. +
          +
        1. Apri il progetto DevOps Services in un browser e fai clic su Crea e distribuisci.
          2. +
        2. Configura la tua pipeline con i lavori di creazione e distribuzione.
          3. +
        3. Nel tuo browser, aggiungi /yaml all'URL del pipeline del progetto e premi Invio. +
          Esempio: https://hub.jazz.net/pipeline///yaml
          4. +
        4. Salva il file pipeline.yml risultante.
          5. +
        5. Nella directory root del tuo progetto, crea una directory .bluemix.
          6. +
        6. Carica il file pipeline.yml nel repository .bluemix.
          7. +
        • +
      • Per distribuire un'applicazione in un contenitore tramite IBM Containers, devi includere Dockerfile nella directory root del repository e un file pipeline.yml in una directory .bluemix. +
          +
        • Il Dockerfile agisce come una sorta di script di build per l'applicazione. Se un Dockerfile viene rilevato nel repository, l'applicazione viene integrata automaticamente in un'immagine prima che venga distribuita in un contenitore. Se la stessa applicazione deve essere creata prima di essere integrata in un'immagine, includi uno script di build per l'applicazione insieme a un Dockerfile, come descritto in precedenza.
          • +
        • Per saperne di più sulla creazione dei Dockerfile, vedi la documentazione di Dockericona link esterno.
          • +
        • Puoi creare un file pipeline.yml manualmente oppure puoi generarne uno da un progetto DevOps Services esistente. Per creare manualmente un file pipeline.yml specifico per i contenitori, vedi gli esempi in GitHubicona link esterno.
          • +
        + +
        • +
      + + +Per un aiuto nella risoluzione dei problemi, vedi [Il pulsante Distribuisci a Bluemix non distribuisce un'applicazione](/docs/troubleshoot/index.html#deploytobluemixbuttondoesntdeployanapp){:new_window}. diff --git a/develop/nl/it/deploy_button_embed.md b/develop/nl/it/deploy_button_embed.md index 8ffd86588..dbcd36756 100644 --- a/develop/nl/it/deploy_button_embed.md +++ b/develop/nl/it/deploy_button_embed.md @@ -1,109 +1,109 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-2-21" - ---- - -{:shortdesc: .shortdesc} -{:screen: .screen} -{:new_window: target="_blank"} -{:codeblock: .codeblock} - -#Incorporazione di una distribuzione nel flusso iFrame {{site.data.keyword.Bluemix_notm}} -{: #embed-d2bm-iframe} - - -Puoi incorporare la distribuzione nel flusso {{site.data.keyword.Bluemix_notm}} come -un iFrame in molti tipi di contenuto che supportano le markup. Ad esempio, puoi incorporare l'iFrame nei file readme, nei blog, negli articoli e nelle pagine web. - -{: shortdesc} - -Il flusso iFrame è utile quando desideri mantenere il branding della tua azienda. Quando le persone fanno clic sul tuo iFrame incorporato, restano nel -tuo contenuto invece di essere reindirizzati al sito web di bluemix.net. Se non sei interessato al branding dell'azienda, puoi inserire un [pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}}](/docs/develop/deploy_button.html) standard nel contenuto invece dell'iFrame. - -##Passi nel flusso iFrame {: #iframe-steps} - -1. Se non hai un account {{site.data.keyword.Bluemix_notm}} attivo, -procedi alla creazione di un account di prova. - -2. Puoi selezionare una regione, un'organizzazione (org), uno spazio e un nome applicazione. Il nome applicazione consigliato viene creato dal nome applicazione precedente, dal tuo nome utente e dalla data/ora. - -3. Il ramo master del repository Git pubblico originale viene clonato in un nuovo progetto {{site.data.keyword.jazzhub_short}} privato con un nuovo repository Git. - -4. Se l'applicazione richiede un file di build, esso viene rilevato automaticamente e l'applicazione viene creata. - -5. L'applicazione viene distribuita alla tua organizzazione {{site.data.keyword.Bluemix_notm}}. - -##Esempi del flusso iFrame {: #iframe-example} - -

      -IBM -Bluemix D2BM iFrame Sampleicona link esterno fornisce un esempio di flusso iFrame per un repository Git pubblico.

      Esempio di flusso iFrame Distribuisci a Bluemix
      -

      - -

      -Per visualizzare l'origine per questo esempio, fai clic su origineicona link esterno. -

      - -##Incorporazione del flusso iFrame {: #embed-iframe} - -
        -
      1. Carica il programma di utilità JavaScript da https://bluemix.net/deploy/embed.jsicona link esterno. Questo programma di utilità dipende da jQuery e viene caricato aggiungendo la seguente tag di script al tuo documento: -
        -<script type="text/javascript" src="https://bluemix.net/deploy/embed.js"></script>
-
        -
        2. -
      2. Istanzia il constructor DeployToBluemixIFrame utilizzando questi argomenti: - -
        -
        domNodeId
        -
        L'ID del domNode in cui desideri inserire l'iFrame nel tuo contenuto.
        - -
        callback
        -
        Questo argomento viene richiamato quando il flusso iFrame viene completato oppure -se si verifica un errore. L'argomento risponde con il risultato. Il seguente frammento di -codice mostra un callback del risultato che ha avuto esito positivo:
        - -
        args
        -
        L'oggetto che contiene i parametri di input al widget. Sono disponibili i seguenti parametri: - -
        - -
        repository
        -
        Il repository Git da utilizzare come origine per la clonazione e la distribuzione. Questo valore è obbligatorio.
        - -
        app_name
        -
        Il nome applicazione predefinito da utilizzare come valore specifico nel campo app_name all'interno -dell'iFrame. Questo valore è facoltativo.
        - - -
        region_id
        -
        L'ID della regione di destinazione predefinita. Ad esempio: ibm:yp:us-south. Questo valore è facoltativo.
        - -
        organization_guid
        -
        Il guid dell'organizzazione di destinazione predefinita. Per trovare questo valore, fai clic su Gestisci organizzazioni > nome_organizzazione. L'URL per l'organizzazione contiene il guid per tale organizzazione. Questo valore è facoltativo.
        - -
        space_guid
        -
        Il guid dello spazio di destinazione predefinito. Per trovare questo valore, fai clic su Gestisci organizzazioni > nome_spazio. L'URL per lo spazio -contiene il guid per tale spazio. Questo valore è facoltativo.
        - -
        auto_login
        -
        Specifica se l'iFrame effettua automaticamente l'accesso dell'utente. Il -valore predefinito è true. Questo valore è facoltativo.
        - -
        width
        -
        La larghezza dell'iFrame. Questo valore è facoltativo. Il valore predefinito è 620.
        - -
        height
        -
        L'altezza dell'iFrame. Questo valore è facoltativo. Il -valore predefinito è 470.
        -
        - -
        -
        -
        3. -
      - -**Suggerimento:** per ridurre al minimo l'interazione con l'iFrame, puoi precompilare i campi **app_name**, **region_id**, **organization_guid**, **space_guid** e **auto_login**. +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-2-21" + +--- + +{:shortdesc: .shortdesc} +{:screen: .screen} +{:new_window: target="_blank"} +{:codeblock: .codeblock} + +# Incorporazione di una distribuzione nel flusso iFrame {{site.data.keyword.Bluemix_notm}} +{: #embed-d2bm-iframe} + + +Puoi incorporare la distribuzione nel flusso {{site.data.keyword.Bluemix_notm}} come +un iFrame in molti tipi di contenuto che supportano le markup. Ad esempio, puoi incorporare l'iFrame nei file readme, nei blog, negli articoli e nelle pagine web. + +{: shortdesc} + +Il flusso iFrame è utile quando desideri mantenere il branding della tua azienda. Quando le persone fanno clic sul tuo iFrame incorporato, restano nel +tuo contenuto invece di essere reindirizzati al sito web di bluemix.net. Se non sei interessato al branding dell'azienda, puoi inserire un [pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}}](/docs/develop/deploy_button.html) standard nel contenuto invece dell'iFrame. + +## Passi nel flusso iFrame {: #iframe-steps} + +1. Se non hai un account {{site.data.keyword.Bluemix_notm}} attivo, +procedi alla creazione di un account di prova. + +2. Puoi selezionare una regione, un'organizzazione (org), uno spazio e un nome applicazione. Il nome applicazione consigliato viene creato dal nome applicazione precedente, dal tuo nome utente e dalla data/ora. + +3. Il ramo master del repository Git pubblico originale viene clonato in un nuovo progetto {{site.data.keyword.jazzhub_short}} privato con un nuovo repository Git. + +4. Se l'applicazione richiede un file di build, esso viene rilevato automaticamente e l'applicazione viene creata. + +5. L'applicazione viene distribuita alla tua organizzazione {{site.data.keyword.Bluemix_notm}}. + +## Esempi del flusso iFrame {: #iframe-example} + +

      +IBM +Bluemix D2BM iFrame Sampleicona link esterno fornisce un esempio di flusso iFrame per un repository Git pubblico.

      Esempio di flusso iFrame Distribuisci a Bluemix
      +

      + +

      +Per visualizzare l'origine per questo esempio, fai clic su origineicona link esterno. +

      + +## Incorporazione del flusso iFrame {: #embed-iframe} + +
        +
      1. Carica il programma di utilità JavaScript da https://bluemix.net/deploy/embed.jsicona link esterno. Questo programma di utilità dipende da jQuery e viene caricato aggiungendo la seguente tag di script al tuo documento: +
        +<script type="text/javascript" src="https://bluemix.net/deploy/embed.js"></script>
+
        +
        2. +
      2. Istanzia il constructor DeployToBluemixIFrame utilizzando questi argomenti: + +
        +
        domNodeId
        +
        L'ID del domNode in cui desideri inserire l'iFrame nel tuo contenuto.
        + +
        callback
        +
        Questo argomento viene richiamato quando il flusso iFrame viene completato oppure +se si verifica un errore. L'argomento risponde con il risultato. Il seguente frammento di +codice mostra un callback del risultato che ha avuto esito positivo:
        + +
        args
        +
        L'oggetto che contiene i parametri di input al widget. Sono disponibili i seguenti parametri: + +
        + +
        repository
        +
        Il repository Git da utilizzare come origine per la clonazione e la distribuzione. Questo valore è obbligatorio.
        + +
        app_name
        +
        Il nome applicazione predefinito da utilizzare come valore specifico nel campo app_name all'interno +dell'iFrame. Questo valore è facoltativo.
        + + +
        region_id
        +
        L'ID della regione di destinazione predefinita. Ad esempio: ibm:yp:us-south. Questo valore è facoltativo.
        + +
        organization_guid
        +
        Il guid dell'organizzazione di destinazione predefinita. Per trovare questo valore, fai clic su Gestisci organizzazioni > nome_organizzazione. L'URL per l'organizzazione contiene il guid per tale organizzazione. Questo valore è facoltativo.
        + +
        space_guid
        +
        Il guid dello spazio di destinazione predefinito. Per trovare questo valore, fai clic su Gestisci organizzazioni > nome_spazio. L'URL per lo spazio +contiene il guid per tale spazio. Questo valore è facoltativo.
        + +
        auto_login
        +
        Specifica se l'iFrame effettua automaticamente l'accesso dell'utente. Il +valore predefinito è true. Questo valore è facoltativo.
        + +
        width
        +
        La larghezza dell'iFrame. Questo valore è facoltativo. Il valore predefinito è 620.
        + +
        height
        +
        L'altezza dell'iFrame. Questo valore è facoltativo. Il +valore predefinito è 470.
        +
        + +
        +
        +
        3. +
      + +**Suggerimento:** per ridurre al minimo l'interazione con l'iFrame, puoi precompilare i campi **app_name**, **region_id**, **organization_guid**, **space_guid** e **auto_login**. diff --git a/develop/nl/it/index.md b/develop/nl/it/index.md index 773105061..10f19b750 100644 --- a/develop/nl/it/index.md +++ b/develop/nl/it/index.md @@ -1,44 +1,44 @@ ---- - - - -copyright: - - years: 2015, 2016 - - - ---- - -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} -{:pre: .pre} -{:screen: .screen} -{:new_window: target="_blank"} - -#Sviluppo di applicazioni -{: #develop-apps-IDS} - -*Ultimo aggiornamento: 07 dicembre 2015* - -Puoi sviluppare applicazioni utilizzando un ambiente di sviluppo integrato (o IDE, integrated development -environment) o un editor di testo oppure puoi utilizzare {{site.data.keyword.jazzhub}}. -{: shortdesc} - -##Sviluppo di applicazioni con Bluemix DevOps Services -{: #dev_ops} - -Puoi utilizzare {{site.data.keyword.jazzhub_short}} per -sviluppare, tracciare e pianificare un'applicazione nel cloud e puoi quindi eseguirne la distribuzione a {{site.data.keyword.Bluemix_notm}}. Puoi passare dal codice sorgente a un'applicazione in esecuzione nel giro di pochi minuti. - -{{site.data.keyword.jazzhub_short}} -fornisce due servizi: {{site.data.keyword.trackplan}} e {{site.data.keyword.deliverypipeline}}. Il servizio {{site.data.keyword.trackplan}} -viene utilizzato per un'agile pianificazione. Il servizio {{site.data.keyword.deliverypipeline}} automatizza build e distribuzioni. Puoi trovare questi servizi nel catalogo {{site.data.keyword.Bluemix_notm}}. Per ulteriori informazioni sulla loro modalità di utilizzo, consulta [Introduzione a Track & Plan](../services/TrackPlan/index.html#gettingstartedtemplate) e [Introduzione a Delivery Pipeline](../services/DeliveryPipeline/index.html#getstartwithCD). - -{{site.data.keyword.jazzhub_short}} fornisce inoltre l'hosting Git per il controllo dell'origine e un IDE Web dove puoi modificare, gestire e distribuire il tuo codice. In un'applicazione, abiliti l'hosting Git facendo clic sul link **AGGIUNGI GIT**, che si trova nell'angolo superiore destro della pagina Panoramica dell'applicazione. Puoi quindi modificare il codice dell'applicazione nell'IDE Web facendo clic su **MODIFICA CODE**. Dalla shell IDE Web, puoi eseguire i comandi cf con content assist. Ad esempio, puoi -ricevere un elenco di tutti i comandi Cloud Foundry immettendo il seguente -comando: -``` -help cfo -``` -{:pre} +--- + + + +copyright: + + years: 2015, 2016 + + + +--- + +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} +{:pre: .pre} +{:screen: .screen} +{:new_window: target="_blank"} + +# Sviluppo di applicazioni +{: #develop-apps-IDS} + +*Ultimo aggiornamento: 07 dicembre 2015* + +Puoi sviluppare applicazioni utilizzando un ambiente di sviluppo integrato (o IDE, integrated development +environment) o un editor di testo oppure puoi utilizzare {{site.data.keyword.jazzhub}}. +{: shortdesc} + +## Sviluppo di applicazioni con Bluemix DevOps Services +{: #dev_ops} + +Puoi utilizzare {{site.data.keyword.jazzhub_short}} per +sviluppare, tracciare e pianificare un'applicazione nel cloud e puoi quindi eseguirne la distribuzione a {{site.data.keyword.Bluemix_notm}}. Puoi passare dal codice sorgente a un'applicazione in esecuzione nel giro di pochi minuti. + +{{site.data.keyword.jazzhub_short}} +fornisce due servizi: {{site.data.keyword.trackplan}} e {{site.data.keyword.deliverypipeline}}. Il servizio {{site.data.keyword.trackplan}} +viene utilizzato per un'agile pianificazione. Il servizio {{site.data.keyword.deliverypipeline}} automatizza build e distribuzioni. Puoi trovare questi servizi nel catalogo {{site.data.keyword.Bluemix_notm}}. Per ulteriori informazioni sulla loro modalità di utilizzo, consulta [Introduzione a Track & Plan](../services/TrackPlan/index.html#gettingstartedtemplate) e [Introduzione a Delivery Pipeline](../services/DeliveryPipeline/index.html#getstartwithCD). + +{{site.data.keyword.jazzhub_short}} fornisce inoltre l'hosting Git per il controllo dell'origine e un IDE Web dove puoi modificare, gestire e distribuire il tuo codice. In un'applicazione, abiliti l'hosting Git facendo clic sul link **AGGIUNGI GIT**, che si trova nell'angolo superiore destro della pagina Panoramica dell'applicazione. Puoi quindi modificare il codice dell'applicazione nell'IDE Web facendo clic su **MODIFICA CODE**. Dalla shell IDE Web, puoi eseguire i comandi cf con content assist. Ad esempio, puoi +ricevere un elenco di tutti i comandi Cloud Foundry immettendo il seguente +comando: +``` +help cfo +``` +{:pre} diff --git a/develop/nl/it/sharetextpipelines.md b/develop/nl/it/sharetextpipelines.md index e15f7be80..442ac2266 100644 --- a/develop/nl/it/sharetextpipelines.md +++ b/develop/nl/it/sharetextpipelines.md @@ -1,235 +1,235 @@ ---- - -copyright: - years: 2015, 2016 -lastupdated: "2016-12-21" - ---- - -{:shortdesc: .shortdesc} -{:screen: .screen} -{:new_window: target="_blank"} -{:codeblock: .codeblock} - -#Condivisione di pipeline basate sul testo nei progetti di esempio {{site.data.keyword.jazzhub_short}} {: #share-pipeline} - -Per i progetti di esempio distribuiti a {{site.data.keyword.Bluemix_notm}} mediante -il pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}}, -puoi definire delle configurazioni pipeline {{site.data.keyword.jazzhub_short}} come -file YAML. Le pipeline definite come testo possono essere condivise; in questo modo, gli utenti che -biforcano il tuo progetto non devono configurare le loro pipeline. Questa funzione è in fase di sviluppo: il formato e l'implementazione YAML -potrebbero subire modifiche in qualsiasi momento. Attualmente, questa funzione è disponibile solo per i -progetti con repository Git e GitHub mirati a {{site.data.keyword.Bluemix_notm}}. -{: shortdesc} - -Nella directory root del progetto di esempio, devi avere una cartella denominata -`.bluemix` che contiene un file `pipeline.yml`. - -Quando un progetto viene clonato utilizzando il pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}}, {{site.data.keyword.jazzhub_short}} crea una pipeline basata sul file `pipeline.yml`. - -Esempio: -``` - - .bluemix - pipeline.yml - -``` -{: codeblock} - -Il formato file YAML è un singolo documento YAML che contiene una -specifica di pipeline. La seguente pipeline {{site.data.keyword.jazzhub_short}} di esempio crea un'applicazione Java con Ant in una singola fase. Quindi, in un'altra fase, la pipeline distribuisce l'applicazione a {{site.data.keyword.Bluemix_notm}}. - -``` ---- -stages: -- name: Build Stage - inputs: - - type: git - branch: master - triggers: - - type: commit - properties: - - name: APP_VERSION - value: '1.0' - type: text - jobs: - - name: Build - type: builder - artifact_dir: output - build_type: ant - script: |- - #!/bin/bash - ant - enable_tests: true - test_file_pattern: tests/TEST-*.xml -- name: Deploy Stage - inputs: - - type: job - stage: Build Stage - job: Build - triggers: - - type: stage - jobs: - - name: Deploy to dev - type: deployer - target: - url: https://api.ng.bluemix.net - organization: uateam@ca.ibm.com - space: dev - application: JavaSampleUnitTest - script: | - cf push "${CF_APP}" - # View logs - #cf logs "${CF_APP}" --recent -``` -{: codeblock} - -##Sintassi del file YAML {: #yaml-syntax} - -Qualsiasi pipeline può essere rappresentata testualmente utilizzando la seguente sintassi. - -Pipeline: -``` ---- -stages: - -``` -{: codeblock} - -Fase: -``` ---- -name: -[inputs: - ] -[triggers: - ] -[properties: - ] -[jobs: - ] -``` -{: codeblock} - -Input: -``` -type: 'git' | 'job' -[branch: ] ;only for Git inputs -stage: ;only for job inputs -job: ;only for job inputs -``` -{: codeblock} - -Trigger: -``` -type: 'commit' | 'stage' -[enabled: 'true | 'false'] ;true is assumed if not specified -``` -{: codeblock} - -Proprietà: -``` -name: -value: -[type: 'text' | 'secure' | 'text_area' | 'file'] ;text is assumed if not specified -``` -{: codeblock} - -Lavoro: -``` -[name: ] -type: 'builder' | 'deployer' | 'tester' -fail_stage: 'true' | 'false' -[extension_id: ] ;extension jobs only -[working_dir: ] ;builder and tester only -[artifact_dir: artifact path>] ;builder only -[build_type: ] ;builder only -[script: - ``` - {: codeblock} - -**Hinweis**: Stellen Sie sicher, dass der Code bereitgestellt wurde und dass auf den Beispiellink mit `https` und nicht mit `http` zugegriffen wird. - -## Das Web-Push-SDK initialisieren -{: #web_initialize} - -Initialisieren Sie das Push-SDK mit den Bluemix {{site.data.keyword.mobilepushshort}}-Services `app GUID` und `app Region`. - -Zum Abrufen Ihrer App-GUID wählen Sie die Option **Konfiguration** für Ihre initialisierten Push-Services im Navigationsbereich aus und klicken auf **Mobile Systemerweiterungen**. Ändern Sie das Code-Snippet so, dass Ihre Parameter für die appGUID des Push Notifications Service von Bluemix verwendet werden. - -Die `App Region` gibt den Standort an, an dem der {{site.data.keyword.mobilepushshort}}-Service gehostet ist. Sie können einen der folgenden drei Werte verwendet: - - - Für USA Dallas: `.ng.bluemix.net` - - Für Großbritannien: `.eu-gb.bluemix.net` - - Für Sydney: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(initParams, callback) -``` - {: codeblock} - -**Anmerkung**: Wenn Ihre FCM-Berechtigungsnachweise für das Web-Push-SDK geändert werden, kann die Nachrichtenübermittlung für den Browser Chrome fehlschlagen. Um ein Fehlschlagen zu vermeiden, stellen Sie sicher, dass Sie `bmsPush.unRegisterDevice` aufrufen. - -Wenn Sie einen falschen Parameter angeben, wird möglicherweise ein Konfigurationsfehler ausgegeben. Weitere Informationen finden Sie im Abschnitt [Web Push-Konfigurationsfehler beheben](troubleshooting_config_errors.html). - -## Webanwendung registrieren -{: #web_register} - -Verwenden Sie die API **register()**, um das Gerät beim {{site.data.keyword.mobilepushshort}}-Service zu registrieren. Verwenden Sie in Abhängigkeit von Ihrem Browser eine oder mehrere der folgenden Optionen. - -- Für die Registrierung von Google Chrome aus fügen Sie den API-Schlüssel für Firebase Cloud Messaging (FCM) bzw. Google Cloud Messaging (GCM) sowie die URL der Website im Bluemix-Dashboard für die Webkonfiguration des {{site.data.keyword.mobilepushshort}}-Service hinzu. Weitere Informationen finden Sie im Abschnitt [Berechtigungsnachweise für Google Cloud Messaging (GCM) konfigurieren](t_push_provider_android.html) unter dem Thema Chrome-Konfiguration. - -- Für die Registrierung von Mozilla Firefox fügen Sie die URL der Website im Dashboard für die Webkonfiguration von Bluemix {{site.data.keyword.mobilepushshort}}-Service unter der Firefox-Konfiguration hinzu. - -Verwenden Sie folgendes Code-Snippet, um sich beim Bluemix {{site.data.keyword.mobilepushshort}}-Service zu registrieren. - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Webanwendungen für den Empfang von Push-Benachrichtigungen aktivieren +{: #web_notifications} +Letzte Aktualisierung: 16. Februar 2017 +{: .last-updated} + +Sie können Google Chrome-, Mozilla Firefox- und Safari-Webanwendungen für den Empfang von Push-Benachrichtigungen aktivieren. Stellen Sie sicher, dass die im Abschnitt [Berechtigungsnachweise für einen Benachrichtigungsprovider konfigurieren](t__main_push_config_provider.html) angegebenen Schritte durchgeführt wurden. + +## Web-Browser-Client-SDK für {{site.data.keyword.mobilepushshort}} installieren +{: #web_install} + +Dieses Thema beschreibt die Vorgehensweise zum Installieren und Verwenden des Client-JavaScript-Push-SDKs für die weitere Entwicklung Ihrer Web-Anwendungen. + +### Webanwendung initialisieren + +Führen Sie folgende Schritte für die Installation des JavaScript SDK in der Google Chrome-Webanwendung aus: + +Laden Sie die Dateien `BMSPushSDK.js`, `BMSPushServiceWorker.js` und `manifest_Website.json` vom [Bluemix-Web-Push-SDK](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window} herunter. + +1. Bearbeiten Sie die Datei `manifest_Website.json`. + - Beim Google Chrome-Browser ändern Sie `name` in den Namen Ihrer Site. Beispiel: `www.dailynewsupdates.com`. Ändern Sie `gcm_sender_id` in Ihre Absender-ID von Firebase Cloud Messaging (FCM) bzw. Google Cloud Messaging (GCM). Weitere Informationen finden Sie in [Absender-ID und API-Schlüssel abrufen](t_push_provider_android.html). Der Wert für gcm_sender_id enthält nur Ziffern. + + ``` + { + "name": "YOUR_WEBSITE_NAME", + "gcm_sender_id": "GCM_Sender_Id" + } + ``` + {: codeblock} + + - Fügen Sie für den Mozilla Firefox-Browser die folgenden Werte in der Datei `manifest_Website.json` hinzu. Geben Sie einen entsprechenden Namen (`name`) an. Dies kann der Name Ihrer Website sein. + + ``` + { + "name": "YOUR_WEBSITE_NAME" + } + ``` + {: codeblock} + +2. Ändern Sie den Namen der Datei `manifest_Website.json` in `manifest.json`. +3. Fügen Sie die Dateien `BMSPushSDK.js`, `BMSPushServiceWorker.js` und `manifest.json` zum Stammverzeichnis Ihrer Website hinzu. +3. Schließen Sie die Datei `manifest.json` in den Tag `` Ihrer HTML-Datei ein. + ``` + + ``` + {: codeblock} +4. Nehmen Sie das Web-Push-SDK von Bluemix in Ihre Webanwendung auf. + ``` + + ``` + {: codeblock} + +**Hinweis**: Stellen Sie sicher, dass der Code bereitgestellt wurde und dass auf den Beispiellink mit `https` und nicht mit `http` zugegriffen wird. + +## Das Web-Push-SDK initialisieren +{: #web_initialize} + +Initialisieren Sie das Push-SDK mit den Bluemix {{site.data.keyword.mobilepushshort}}-Services `app GUID` und `app Region`. + +Zum Abrufen Ihrer App-GUID wählen Sie die Option **Konfiguration** für Ihre initialisierten Push-Services im Navigationsbereich aus und klicken auf **Mobile Systemerweiterungen**. Ändern Sie das Code-Snippet so, dass Ihre Parameter für die appGUID des Push Notifications Service von Bluemix verwendet werden. + +Die `App Region` gibt den Standort an, an dem der {{site.data.keyword.mobilepushshort}}-Service gehostet ist. Sie können einen der folgenden drei Werte verwendet: + + - Für USA Dallas: `.ng.bluemix.net` + - Für Großbritannien: `.eu-gb.bluemix.net` + - Für Sydney: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(initParams, callback) +``` + {: codeblock} + +**Anmerkung**: Wenn Ihre FCM-Berechtigungsnachweise für das Web-Push-SDK geändert werden, kann die Nachrichtenübermittlung für den Browser Chrome fehlschlagen. Um ein Fehlschlagen zu vermeiden, stellen Sie sicher, dass Sie `bmsPush.unRegisterDevice` aufrufen. + +Wenn Sie einen falschen Parameter angeben, wird möglicherweise ein Konfigurationsfehler ausgegeben. Weitere Informationen finden Sie im Abschnitt [Web Push-Konfigurationsfehler beheben](troubleshooting_config_errors.html). + +## Webanwendung registrieren +{: #web_register} + +Verwenden Sie die API **register()**, um das Gerät beim {{site.data.keyword.mobilepushshort}}-Service zu registrieren. Verwenden Sie in Abhängigkeit von Ihrem Browser eine oder mehrere der folgenden Optionen. + +- Für die Registrierung von Google Chrome aus fügen Sie den API-Schlüssel für Firebase Cloud Messaging (FCM) bzw. Google Cloud Messaging (GCM) sowie die URL der Website im Bluemix-Dashboard für die Webkonfiguration des {{site.data.keyword.mobilepushshort}}-Service hinzu. Weitere Informationen finden Sie im Abschnitt [Berechtigungsnachweise für Google Cloud Messaging (GCM) konfigurieren](t_push_provider_android.html) unter dem Thema Chrome-Konfiguration. + +- Für die Registrierung von Mozilla Firefox fügen Sie die URL der Website im Dashboard für die Webkonfiguration von Bluemix {{site.data.keyword.mobilepushshort}}-Service unter der Firefox-Konfiguration hinzu. + +Verwenden Sie folgendes Code-Snippet, um sich beim Bluemix {{site.data.keyword.mobilepushshort}}-Service zu registrieren. + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + + + diff --git a/services/mobilepush/nl/de/c_chrome_firefox_enable_send.md b/services/mobilepush/nl/de/c_chrome_firefox_enable_send.md index 462dc5d5a..11ad80869 100644 --- a/services/mobilepush/nl/de/c_chrome_firefox_enable_send.md +++ b/services/mobilepush/nl/de/c_chrome_firefox_enable_send.md @@ -1,43 +1,43 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Einfache Benachrichtigungen an Web-Browser senden -{: #web_notifications} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - -Nach dem Entwickeln Ihrer Anwendungen können Sie Push-Benachrichtigungen senden. - -1. Wählen Sie **Benachrichtigungen senden** aus und erstellen Sie eine Nachricht, indem Sie **Webbenachrichtigungen** als Option für **Senden an** auswählen. -2. Geben Sie im Feld **Nachricht** die Nachricht an, die gesendet werden soll. -3. Sie können auswählen, optionale Einstellungen anzugeben: - - **Benachrichtigungstitel**: Dies ist der Text, der als Kopfzeile des Nachrichtenalerts angezeigt würde. - - **URL des Benachrichtigungssymbols**: Falls Ihre Nachricht mit einem App-Benachrichtigungssymbol gesendet werden muss, stellen Sie den Link zu Ihrem Symbol in dem Feld zur Verfügung. - - **Lebensdauer**: Teilt dem Server die Gültigkeit der Nachrichten mit. -4. Für Web-Benachrichtigungen, die an den Browser Safari gesendet werden, sind zusätzliche Informationen erforderlich: - - **Aktion**: Dies ist die Bezeichnung der Aktionsschaltfläche. - - **URL-Argumente**: Die URL-Argumente, die mit dieser Benachrichtigung verwendet werden müssen. Stellen Sie sicher, dass dies in Form eines JSON-Arrays geschieht. - -Die folgende Abbildung zeigt die Webbenachrichtigungsoptionen im Dashboard an. - - ![Anzeige 'Benachrichtigungen'](images/DashboardWebpush.jpg) - - -## Nächste Schritte - {: #next_steps_tags} - -Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. - -Fügen Sie diese Funktionen des {{site.data.keyword.mobilepushshort}}-Service Ihrer App hinzu. Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). Informationen zur Verwendung erweiterter Benachrichtigungsoptionen finden Sie in [Erweiterte Benachrichtigungen](t_advance_badge_sound_payload.html). - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Einfache Benachrichtigungen an Web-Browser senden +{: #web_notifications} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + +Nach dem Entwickeln Ihrer Anwendungen können Sie Push-Benachrichtigungen senden. + +1. Wählen Sie **Benachrichtigungen senden** aus und erstellen Sie eine Nachricht, indem Sie **Webbenachrichtigungen** als Option für **Senden an** auswählen. +2. Geben Sie im Feld **Nachricht** die Nachricht an, die gesendet werden soll. +3. Sie können auswählen, optionale Einstellungen anzugeben: + - **Benachrichtigungstitel**: Dies ist der Text, der als Kopfzeile des Nachrichtenalerts angezeigt würde. + - **URL des Benachrichtigungssymbols**: Falls Ihre Nachricht mit einem App-Benachrichtigungssymbol gesendet werden muss, stellen Sie den Link zu Ihrem Symbol in dem Feld zur Verfügung. + - **Lebensdauer**: Teilt dem Server die Gültigkeit der Nachrichten mit. +4. Für Web-Benachrichtigungen, die an den Browser Safari gesendet werden, sind zusätzliche Informationen erforderlich: + - **Aktion**: Dies ist die Bezeichnung der Aktionsschaltfläche. + - **URL-Argumente**: Die URL-Argumente, die mit dieser Benachrichtigung verwendet werden müssen. Stellen Sie sicher, dass dies in Form eines JSON-Arrays geschieht. + +Die folgende Abbildung zeigt die Webbenachrichtigungsoptionen im Dashboard an. + + ![Anzeige 'Benachrichtigungen'](images/DashboardWebpush.jpg) + + +## Nächste Schritte + {: #next_steps_tags} + +Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. + +Fügen Sie diese Funktionen des {{site.data.keyword.mobilepushshort}}-Service Ihrer App hinzu. Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). Informationen zur Verwendung erweiterter Benachrichtigungsoptionen finden Sie in [Erweiterte Benachrichtigungen](t_advance_badge_sound_payload.html). + + + diff --git a/services/mobilepush/nl/de/c_cordova_enable.md b/services/mobilepush/nl/de/c_cordova_enable.md index 4d346ca07..b29cfcbc3 100644 --- a/services/mobilepush/nl/de/c_cordova_enable.md +++ b/services/mobilepush/nl/de/c_cordova_enable.md @@ -1,316 +1,316 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Cordova-Anwendungen für den Empfang von Push-Benachrichtigungen aktivieren -{: #cordova_enable} -Letzte Aktualisierung: 18. Januar 2017 -{: .last-updated} - -Cordova ist eine Plattform zum Erstellen von Hybridanwendungen mit JavaScript, CSS und HTML. Der {{site.data.keyword.mobilepushshort}}-Service unterstützt die Entwicklung von iOS- und Android-Anwendungen, die auf Cordova basieren. - -Sie können Cordova-Anwendungen für den Empfang von Push-Benachrichtigungen auf Ihren Geräten aktivieren. - -## Cordova-Push-Plug-in installieren -{: #cordova_install} - -Installieren und verwenden Sie das Client-Push-Plug-in für die weitere Entwicklung Ihrer Cordova-Anwendungen. Dabei wird auch das Cordova Core-Plug-in installiert, das Ihre Verbindung zu Bluemix initialisiert. - -### Vorbemerkungen - -1. Laden Sie die aktuelle Version für das Android Studio-SDK und Xcode herunter. -1. Richten Sie den Emulator ein. Verwenden Sie für Android Studio einen Emulator, der die Google Play-API unterstützt. -1. Installieren Sie das Git-Befehlszeilentool. Stellen Sie unter Windows sicher, dass Sie die Option zum Ausführen von Git über die Windows-Eingabeaufforderung auswählen. Informationen zum Herunterladen und Installieren dieses Tools finden Sie unter [Git ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://git-scm.com/downloads){: new_window}. -1. Installieren Sie Node.js und das NPM-Tool (NPM = Node Package Manager). Das NPM-Befehlszeilentool wird als Produktpaket mit Node.js bereitgestellt. Informationen zum Herunterladen und Installieren von Node.js finden Sie unter [Node.js ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://nodejs.org/en/download/){: new_window}. -1. Installieren Sie über die Befehlszeile die Cordova-Befehlszeilentools mithilfe des Befehls **npm install -g cordova**. Dies ist eine Voraussetzung für die Verwendung des Cordova-Push-Plug-ins. Informationen zum Installieren von Cordova und zum Einrichten Ihrer Cordova-App finden Sie unter [Cordova Apache ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://cordova.apache.org/#getstarted){: new_window}. Weitere Informationen finden Sie in der [Readme-Datei ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} für das Cordova-Push-Plug-in. -1. Wechseln Sie in den Ordner, in dem Sie Ihre Cordova-App erstellen möchten, und führen Sie den folgenden Befehl aus, um eine Cordova-Anwendung zu erstellen. Wenn Sie bereits über eine Cordova-App verfügen, fahren Sie mit Schritt 3 fort. -```cordova create your_app_name - cd your_app_name -``` - {: codeblock} -- Optional: Sie können die Datei **config.xml** bearbeiten und den Anwendungsnamen im Element in einen von Ihnen gewählten Namen statt des Standardnamens 'HelloCordova' ändern. - -Stellen Sie sicher, dass Sie die richtige Bundle-ID angegeben haben. Folgende Fehlernachrichten können zu einem Ergebnis in Xcode führen, wenn die falsche Bundle-ID angegeben wird. - -* The executable was signed with invalid entitlements (Die ausführbare Funktion ist mit ungültigen Berechtigungen signiert). -* The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile (Die in der Berechtigungsdatei für die Codeunterzeichnung Ihrer Anwendung angegebenen Berechtigungen stimmen nicht mit den angegebenen Berechtigungen in Ihrem Bereitstellungsprofil überein). Um dieses Problem zu beheben, geben Sie korrekte Bundle-ID in Xcode oder in der Datei **config.xml** Ihrer Cordova-App an. - -1. Fügen Sie die Mindestversion der unterstützten API oder die Bereitstellungszieldeklaration zur Datei 'config.xml' Ihrer Cordova-Anwendung hinzu: Der Wert für 'minSdkVersion' muss größer als 15 sein. Der Wert für 'targetSdkVersion' muss immer das neueste Android-SDK angeben, das bei Google verfügbar ist. - - * Android - Öffnen Sie die Datei **config.xml** mit dem Editor und aktualisieren -das Element `` mit der SDK-Mindestversion und -Zielversion: - - ``` - - - - - - ``` - {: codeblock} - - * iOS - Aktualisieren Sie das Element mit einer Bereitstellungszieldeklaration: - - ``` - - - - - ``` - {: codeblock} - -1. Fügen Sie über die Cordova-Befehlszeilenschnittstelle (CLI) mit einem oder beiden der folgenden Befehle Ihre Plattform (iOS und/oder Android) hinzu: -``` -cordova platform add ios - cordova platform add android -``` - {: codeblock} - -1. Geben Sie im Stammverzeichnis Ihrer Cordova-Anwendung den folgenden Befehl ein, um das Cordova-Push-Plug-in zu installieren: **cordova plugin add bms-push**. Je nachdem, welche Plattformen Sie hinzugefügt haben, wird Folgendes angezeigt: -``` -Installing "bms-push" for android -Installing "bms-push" for ios -``` - {: codeblock} - -1. Überprüfen Sie in Ihrem App-Stammverzeichnis mit dem Befehl **cordova plugin list**, dass das Cordova Core- und das Cordova Push-Plug-in erfolgreich installiert wurden. Je nachdem, welche Plattformen Sie hinzugefügt haben, wird Folgendes angezeigt: -``` -bms-core "BMSCore" -bms-push "BMSPush" -``` - {: codeblock} - -1. Konfigurieren Sie Ihre iOS-Entwicklungsumgebung. -2. Erstellen Sie die Anwendung und führen Sie sie aus mit Xcode. -1. Laden Sie Ihre Firebase-Datei `google-services.json` für Android herunter und speichern Sie sie im Stammordner Ihres Cordova-Projekts in `[name-ihrer-anwendung]/platforms/android. - 1. Wechseln Sie in das Verzeichnis `[name-ihrer-anwendung]/platforms/android`. - 2. Öffnen Sie die Datei `build.gradle` (Pfad: plattform > android > build.gradle). - 3. Suchen Sie die Zeichenfolge `buildscript` in der Datei `build.gradle`. - 4. Fügen Sie nach der Zeile für den Klassenpfad (classpath) die folgende Zeile hinzu: classpath 'com.google.gms:google-services:3.0.0' - 5. Suchen Sie nach "dependencies" (Abhängigkeiten). Wählen Sie Abhängigkeiten aus, die den Text `compile` enthalten, und fügen Sie unmittelbar nach dem Ende dieser Abhängigkeiten die folgende Zeile hinzu: :apply plugin: 'com.google.gms.google-services'. - 6. Bereiten Sie Ihr Cordova-Android-Projekt vor und erstellen Sie es. - ``` - cordova prepare android - cordova build android - ``` - {: codeblock} - **Hinweis**: Erstellen Sie zuerst die Cordova-Anwendung über die Cordova-Befehlszeilenschnittstelle, bevor Sie das Projekt in Android Studio öffnen. Dies hilft bei der Vermeidung von Buildfehlern. - -## Cordova-Plug-in -{: #cordova_initialize} - -Bevor Sie das Cordova-Plug-in für den {{site.data.keyword.mobilepushshort}}-Service verwenden können, müssen Sie es initialisieren, indem Sie die Anwendungsroute und die Anwendungs-GUID übergeben. Nach der Initialisierung des Plug-ins können Sie die Verbindung zu der Serveranwendung herstellen, die Sie im Bluemix-Dashboard erstellt haben. Das Cordova-Plug-in ist die Oberfläche für die Android- und iOS-Client-SDKs zum Aktivieren einer Cordova-Anwendung für die Kommunikation mit Bluemix-Services. - -1. Initialisieren Sie 'BMSClient', indem Sie das folgende Code-Snippet kopieren und in Ihre Haupt-JavaScript-Datei (die für gewöhnlich im Verzeichnis **www/js** gespeichert ist) einfügen. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("YOUR APP REGION"); - var category = {}; - BMSPush.initialize(appGUID,clientSecret,category); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); - } -``` - {: codeblock} - -Fügen Sie für 'YOUR APP REGION' die Region für Ihre Anwendung ein. Die folgenden Konstanten stehen zur Verfügung: - -``` -REGION_US_SOUTH // ".ng.bluemix.net"; -REGION_UK //".eu-gb.bluemix.net"; -REGION_SYDNEY // ".au-syd.bluemix.net"; -``` - -Beispiel: - -``` -BMSClient.initialize(BMSClient.REGION_US_SOUTH); -``` - -**Anmerkung**: Wenn Sie unter Verwendung der Cordova-Befehlszeilenschnittstelle eine Cordova-App erstellt haben, beispielsweise mit dem Befehl Cordova create app-name, übernehmen Sie diesen JavaScript-Code in die Datei index.js hinter der Funktion app.receivedEvent innerhalb der Funktion onDeviceReady: function(), um `BMSClient` zu initialisieren. - - -## Geräte registrieren -{: #cordova_register} - - -Rufen Sie die Registrierungsfunktion auf, um ein Gerät für den {{site.data.keyword.mobilepushshort}}-Service zu registrieren. Kopieren Sie das folgende Code-Snippet in Ihre Cordova-Anwendung, um ein Gerät zu registrieren. - -``` -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); -``` - {: codeblock} - -Das folgende JavaScript-Code-Snippet zeigt, wie Sie das Bluemix Mobile Services-Client-SDK initialisieren, ein Gerät für den {{site.data.keyword.mobilepushshort}}-Service registrieren und Push-Benachrichtigungen überwachen. Schließen Sie diesen Code in Ihre Javascript-Datei ein. - -Innerhalb der Funktion **onDeviceReady: function()**. - -``` -onDeviceReady: function() { -app.receivedEvent('deviceready'); -BMSClient.initialize("YOUR APP REGION"); -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; -BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -Fügen Sie das folgende Swift-Code-Snippet zur Klasse 'delegate' Ihrer Anwendung hinzu. - -``` -// Register the device token with Bluemix Push Notification Service -func application(application: UIApplication, - didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { - CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) -} -// Handle error when failed to register device token with APNs -func application(application: UIApplication, - didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) -} -``` - {: codeblock} - -##Nächste Schritte - -{: #cordova_register_next} - -Erstellen Sie das Projekt und führen Sie es mit den folgenden Befehlen aus: - -####Android -{: android-next-steps} - -``` -cordova build android -``` - {: codeblock} - -``` -cordova run android -``` - {: codeblock} - -####iOS -{: ios-next-steps} - -``` -cordova build ios -``` - {: codeblock} - -``` -cordova run ios -``` - {: codeblock} - -## Push-Benachrichtigungen in Geräten empfangen -{: #cordova_receive} - -Kopieren Sie das folgende Code-Snippet, um Push-Benachrichtigungen auf Geräten zu empfangen. - -###JavaScript - -Fügen Sie das folgende JavaScript-Code-Snippet in die Webkomponente Ihrer Cordova-Anwendung ein. -``` -var showNotification = function(notif) { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -###Eigenschaften für Android-Benachrichtigungen - -Im folgenden Abschnitt sind die Eigenschaften für Android-Benachrichtigungen aufgelistet: - -* **message** - Push-Benachrichtigung -* **payload** - JSON-Objekt mit den Nutzdaten einer Benachrichtigung - - -###Eigenschaften für iOS-Benachrichtigungen - -Im folgenden Abschnitt sind die Eigenschaften für iOS-Benachrichtigungen aufgelistet: - -* **message** - Push-Benachrichtigung -* **payload** - JSON-Objekt, das die Nutzdaten einer Benachrichtigung enthält -action-loc-key - Diese Zeichenfolge dient als Schlüssel zum Abrufen einer lokalisierten Zeichenfolge in der aktuellen Lokalisierung, die anstelle von `View` als Titel für die entsprechende Schaltfläche verwendet werden soll. -* **badge** - Die Nummer, die als Badge des App-Symbols angezeigt werden soll. Wenn diese Eigenschaft fehlt, wird das Badge nicht geändert. Um das Badge zu entfernen, legen Sie für diese Eigenschaft den Wert 0 fest. -* **sound** - Der Name einer Audiodatei im App-Bundle oder im Ordner 'Library/Sounds' des Datencontainers der App. - - -Fügen Sie die folgenden Swift-Code-Snippets zur Klasse 'delegate' Ihrer Anwendung hinzu. -``` -// Handle receiving a remote notification -func application(application: UIApplication, - didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) -} -``` - {: codeblock} - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary - if remoteNotif != nil { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) - } -} -``` - {: codeblock} - -## Einfache Push-Benachrichtigungen senden -{: #push-send-notifications} - -Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen senden. - -Führen Sie die Schritte aus, um einfache Push-Benachrichtigungen zu senden: - -1. Wählen Sie **Benachrichtigungen senden** aus und erstellen Sie eine Nachricht, indem Sie eine Option für **Senden an** auswählen. Die unterstützten Optionen sind **Gerät nach Tag**, **Geräte-ID**, **Benutzer-ID**, **Android-Geräte**, **iOS-Geräte**, **Webbenachrichtigungen** und **Alle Geräte**. -**Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Benachrichtigungen. -![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) - -2. Erstellen Sie Ihre Nachricht im Feld **Nachricht**. Treffen Sie Ihre Auswahl, um die optionalen Einstellungen wie erforderlich zu konfigurieren. -3. Klicken Sie auf **Senden**. -3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. - -Der folgende Screenshot zeigt ein Alertfeld bei der Verarbeitung einer Push-Benachrichtigung im Vordergrund eines Android- bzw. iOS-Geräts. - -![Push-Benachrichtigung im Vordergrund auf einem Android-Gerät](images/Android_Screenshot.jpg) - -![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) - - Die folgende Abbildung zeigt eine Push-Benachrichtigung im Hintergrund auf einem Android-Gerät. -![Push-Benachrichtigung im Hintergrund auf einem Android-Gerät](images/background.jpg) - -## Nächste Schritte -{: #next_steps_tags} - -Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. - -Fügen Sie die Funktionen des {{site.data.keyword.mobilepushshort}}-Service Ihrer App hinzu. -Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). -Informationen zur Verwendung erweiterter Benachrichtigungsoptionen finden Sie in [Erweiterte Push-Benachrichtigungen aktivieren](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Cordova-Anwendungen für den Empfang von Push-Benachrichtigungen aktivieren +{: #cordova_enable} +Letzte Aktualisierung: 18. Januar 2017 +{: .last-updated} + +Cordova ist eine Plattform zum Erstellen von Hybridanwendungen mit JavaScript, CSS und HTML. Der {{site.data.keyword.mobilepushshort}}-Service unterstützt die Entwicklung von iOS- und Android-Anwendungen, die auf Cordova basieren. + +Sie können Cordova-Anwendungen für den Empfang von Push-Benachrichtigungen auf Ihren Geräten aktivieren. + +## Cordova-Push-Plug-in installieren +{: #cordova_install} + +Installieren und verwenden Sie das Client-Push-Plug-in für die weitere Entwicklung Ihrer Cordova-Anwendungen. Dabei wird auch das Cordova Core-Plug-in installiert, das Ihre Verbindung zu Bluemix initialisiert. + +### Vorbemerkungen + +1. Laden Sie die aktuelle Version für das Android Studio-SDK und Xcode herunter. +1. Richten Sie den Emulator ein. Verwenden Sie für Android Studio einen Emulator, der die Google Play-API unterstützt. +1. Installieren Sie das Git-Befehlszeilentool. Stellen Sie unter Windows sicher, dass Sie die Option zum Ausführen von Git über die Windows-Eingabeaufforderung auswählen. Informationen zum Herunterladen und Installieren dieses Tools finden Sie unter [Git ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://git-scm.com/downloads){: new_window}. +1. Installieren Sie Node.js und das NPM-Tool (NPM = Node Package Manager). Das NPM-Befehlszeilentool wird als Produktpaket mit Node.js bereitgestellt. Informationen zum Herunterladen und Installieren von Node.js finden Sie unter [Node.js ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://nodejs.org/en/download/){: new_window}. +1. Installieren Sie über die Befehlszeile die Cordova-Befehlszeilentools mithilfe des Befehls **npm install -g cordova**. Dies ist eine Voraussetzung für die Verwendung des Cordova-Push-Plug-ins. Informationen zum Installieren von Cordova und zum Einrichten Ihrer Cordova-App finden Sie unter [Cordova Apache ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://cordova.apache.org/#getstarted){: new_window}. Weitere Informationen finden Sie in der [Readme-Datei ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} für das Cordova-Push-Plug-in. +1. Wechseln Sie in den Ordner, in dem Sie Ihre Cordova-App erstellen möchten, und führen Sie den folgenden Befehl aus, um eine Cordova-Anwendung zu erstellen. Wenn Sie bereits über eine Cordova-App verfügen, fahren Sie mit Schritt 3 fort. +```cordova create your_app_name + cd your_app_name +``` + {: codeblock} +- Optional: Sie können die Datei **config.xml** bearbeiten und den Anwendungsnamen im Element in einen von Ihnen gewählten Namen statt des Standardnamens 'HelloCordova' ändern. + +Stellen Sie sicher, dass Sie die richtige Bundle-ID angegeben haben. Folgende Fehlernachrichten können zu einem Ergebnis in Xcode führen, wenn die falsche Bundle-ID angegeben wird. + +* The executable was signed with invalid entitlements (Die ausführbare Funktion ist mit ungültigen Berechtigungen signiert). +* The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile (Die in der Berechtigungsdatei für die Codeunterzeichnung Ihrer Anwendung angegebenen Berechtigungen stimmen nicht mit den angegebenen Berechtigungen in Ihrem Bereitstellungsprofil überein). Um dieses Problem zu beheben, geben Sie korrekte Bundle-ID in Xcode oder in der Datei **config.xml** Ihrer Cordova-App an. + +1. Fügen Sie die Mindestversion der unterstützten API oder die Bereitstellungszieldeklaration zur Datei 'config.xml' Ihrer Cordova-Anwendung hinzu: Der Wert für 'minSdkVersion' muss größer als 15 sein. Der Wert für 'targetSdkVersion' muss immer das neueste Android-SDK angeben, das bei Google verfügbar ist. + + * Android - Öffnen Sie die Datei **config.xml** mit dem Editor und aktualisieren +das Element `` mit der SDK-Mindestversion und -Zielversion: + + ``` + + + + + + ``` + {: codeblock} + + * iOS - Aktualisieren Sie das Element mit einer Bereitstellungszieldeklaration: + + ``` + + + + + ``` + {: codeblock} + +1. Fügen Sie über die Cordova-Befehlszeilenschnittstelle (CLI) mit einem oder beiden der folgenden Befehle Ihre Plattform (iOS und/oder Android) hinzu: +``` +cordova platform add ios + cordova platform add android +``` + {: codeblock} + +1. Geben Sie im Stammverzeichnis Ihrer Cordova-Anwendung den folgenden Befehl ein, um das Cordova-Push-Plug-in zu installieren: **cordova plugin add bms-push**. Je nachdem, welche Plattformen Sie hinzugefügt haben, wird Folgendes angezeigt: +``` +Installing "bms-push" for android +Installing "bms-push" for ios +``` + {: codeblock} + +1. Überprüfen Sie in Ihrem App-Stammverzeichnis mit dem Befehl **cordova plugin list**, dass das Cordova Core- und das Cordova Push-Plug-in erfolgreich installiert wurden. Je nachdem, welche Plattformen Sie hinzugefügt haben, wird Folgendes angezeigt: +``` +bms-core "BMSCore" +bms-push "BMSPush" +``` + {: codeblock} + +1. Konfigurieren Sie Ihre iOS-Entwicklungsumgebung. +2. Erstellen Sie die Anwendung und führen Sie sie aus mit Xcode. +1. Laden Sie Ihre Firebase-Datei `google-services.json` für Android herunter und speichern Sie sie im Stammordner Ihres Cordova-Projekts in `[name-ihrer-anwendung]/platforms/android. + 1. Wechseln Sie in das Verzeichnis `[name-ihrer-anwendung]/platforms/android`. + 2. Öffnen Sie die Datei `build.gradle` (Pfad: plattform > android > build.gradle). + 3. Suchen Sie die Zeichenfolge `buildscript` in der Datei `build.gradle`. + 4. Fügen Sie nach der Zeile für den Klassenpfad (classpath) die folgende Zeile hinzu: classpath 'com.google.gms:google-services:3.0.0' + 5. Suchen Sie nach "dependencies" (Abhängigkeiten). Wählen Sie Abhängigkeiten aus, die den Text `compile` enthalten, und fügen Sie unmittelbar nach dem Ende dieser Abhängigkeiten die folgende Zeile hinzu: :apply plugin: 'com.google.gms.google-services'. + 6. Bereiten Sie Ihr Cordova-Android-Projekt vor und erstellen Sie es. + ``` + cordova prepare android + cordova build android + ``` + {: codeblock} + **Hinweis**: Erstellen Sie zuerst die Cordova-Anwendung über die Cordova-Befehlszeilenschnittstelle, bevor Sie das Projekt in Android Studio öffnen. Dies hilft bei der Vermeidung von Buildfehlern. + +## Cordova-Plug-in +{: #cordova_initialize} + +Bevor Sie das Cordova-Plug-in für den {{site.data.keyword.mobilepushshort}}-Service verwenden können, müssen Sie es initialisieren, indem Sie die Anwendungsroute und die Anwendungs-GUID übergeben. Nach der Initialisierung des Plug-ins können Sie die Verbindung zu der Serveranwendung herstellen, die Sie im Bluemix-Dashboard erstellt haben. Das Cordova-Plug-in ist die Oberfläche für die Android- und iOS-Client-SDKs zum Aktivieren einer Cordova-Anwendung für die Kommunikation mit Bluemix-Services. + +1. Initialisieren Sie 'BMSClient', indem Sie das folgende Code-Snippet kopieren und in Ihre Haupt-JavaScript-Datei (die für gewöhnlich im Verzeichnis **www/js** gespeichert ist) einfügen. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("YOUR APP REGION"); + var category = {}; + BMSPush.initialize(appGUID,clientSecret,category); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); + } +``` + {: codeblock} + +Fügen Sie für 'YOUR APP REGION' die Region für Ihre Anwendung ein. Die folgenden Konstanten stehen zur Verfügung: + +``` +REGION_US_SOUTH // ".ng.bluemix.net"; +REGION_UK //".eu-gb.bluemix.net"; +REGION_SYDNEY // ".au-syd.bluemix.net"; +``` + +Beispiel: + +``` +BMSClient.initialize(BMSClient.REGION_US_SOUTH); +``` + +**Anmerkung**: Wenn Sie unter Verwendung der Cordova-Befehlszeilenschnittstelle eine Cordova-App erstellt haben, beispielsweise mit dem Befehl Cordova create app-name, übernehmen Sie diesen JavaScript-Code in die Datei index.js hinter der Funktion app.receivedEvent innerhalb der Funktion onDeviceReady: function(), um `BMSClient` zu initialisieren. + + +## Geräte registrieren +{: #cordova_register} + + +Rufen Sie die Registrierungsfunktion auf, um ein Gerät für den {{site.data.keyword.mobilepushshort}}-Service zu registrieren. Kopieren Sie das folgende Code-Snippet in Ihre Cordova-Anwendung, um ein Gerät zu registrieren. + +``` +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); +``` + {: codeblock} + +Das folgende JavaScript-Code-Snippet zeigt, wie Sie das Bluemix Mobile Services-Client-SDK initialisieren, ein Gerät für den {{site.data.keyword.mobilepushshort}}-Service registrieren und Push-Benachrichtigungen überwachen. Schließen Sie diesen Code in Ihre Javascript-Datei ein. + +Innerhalb der Funktion **onDeviceReady: function()**. + +``` +onDeviceReady: function() { +app.receivedEvent('deviceready'); +BMSClient.initialize("YOUR APP REGION"); +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; +BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +Fügen Sie das folgende Swift-Code-Snippet zur Klasse 'delegate' Ihrer Anwendung hinzu. + +``` +// Register the device token with Bluemix Push Notification Service +func application(application: UIApplication, + didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { + CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) +} +// Handle error when failed to register device token with APNs +func application(application: UIApplication, + didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) +} +``` + {: codeblock} + +##Nächste Schritte + +{: #cordova_register_next} + +Erstellen Sie das Projekt und führen Sie es mit den folgenden Befehlen aus: + +####Android +{: android-next-steps} + +``` +cordova build android +``` + {: codeblock} + +``` +cordova run android +``` + {: codeblock} + +####iOS +{: ios-next-steps} + +``` +cordova build ios +``` + {: codeblock} + +``` +cordova run ios +``` + {: codeblock} + +## Push-Benachrichtigungen in Geräten empfangen +{: #cordova_receive} + +Kopieren Sie das folgende Code-Snippet, um Push-Benachrichtigungen auf Geräten zu empfangen. + +###JavaScript + +Fügen Sie das folgende JavaScript-Code-Snippet in die Webkomponente Ihrer Cordova-Anwendung ein. +``` +var showNotification = function(notif) { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +###Eigenschaften für Android-Benachrichtigungen + +Im folgenden Abschnitt sind die Eigenschaften für Android-Benachrichtigungen aufgelistet: + +* **message** - Push-Benachrichtigung +* **payload** - JSON-Objekt mit den Nutzdaten einer Benachrichtigung + + +###Eigenschaften für iOS-Benachrichtigungen + +Im folgenden Abschnitt sind die Eigenschaften für iOS-Benachrichtigungen aufgelistet: + +* **message** - Push-Benachrichtigung +* **payload** - JSON-Objekt, das die Nutzdaten einer Benachrichtigung enthält +action-loc-key - Diese Zeichenfolge dient als Schlüssel zum Abrufen einer lokalisierten Zeichenfolge in der aktuellen Lokalisierung, die anstelle von `View` als Titel für die entsprechende Schaltfläche verwendet werden soll. +* **badge** - Die Nummer, die als Badge des App-Symbols angezeigt werden soll. Wenn diese Eigenschaft fehlt, wird das Badge nicht geändert. Um das Badge zu entfernen, legen Sie für diese Eigenschaft den Wert 0 fest. +* **sound** - Der Name einer Audiodatei im App-Bundle oder im Ordner 'Library/Sounds' des Datencontainers der App. + + +Fügen Sie die folgenden Swift-Code-Snippets zur Klasse 'delegate' Ihrer Anwendung hinzu. +``` +// Handle receiving a remote notification +func application(application: UIApplication, + didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) +} +``` + {: codeblock} + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary + if remoteNotif != nil { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) + } +} +``` + {: codeblock} + +## Einfache Push-Benachrichtigungen senden +{: #push-send-notifications} + +Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen senden. + +Führen Sie die Schritte aus, um einfache Push-Benachrichtigungen zu senden: + +1. Wählen Sie **Benachrichtigungen senden** aus und erstellen Sie eine Nachricht, indem Sie eine Option für **Senden an** auswählen. Die unterstützten Optionen sind **Gerät nach Tag**, **Geräte-ID**, **Benutzer-ID**, **Android-Geräte**, **iOS-Geräte**, **Webbenachrichtigungen** und **Alle Geräte**. +**Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Benachrichtigungen. +![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) + +2. Erstellen Sie Ihre Nachricht im Feld **Nachricht**. Treffen Sie Ihre Auswahl, um die optionalen Einstellungen wie erforderlich zu konfigurieren. +3. Klicken Sie auf **Senden**. +3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. + +Der folgende Screenshot zeigt ein Alertfeld bei der Verarbeitung einer Push-Benachrichtigung im Vordergrund eines Android- bzw. iOS-Geräts. + +![Push-Benachrichtigung im Vordergrund auf einem Android-Gerät](images/Android_Screenshot.jpg) + +![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) + + Die folgende Abbildung zeigt eine Push-Benachrichtigung im Hintergrund auf einem Android-Gerät. +![Push-Benachrichtigung im Hintergrund auf einem Android-Gerät](images/background.jpg) + +## Nächste Schritte +{: #next_steps_tags} + +Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. + +Fügen Sie die Funktionen des {{site.data.keyword.mobilepushshort}}-Service Ihrer App hinzu. +Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). +Informationen zur Verwendung erweiterter Benachrichtigungsoptionen finden Sie in [Erweiterte Push-Benachrichtigungen aktivieren](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/de/c_enable_push.md b/services/mobilepush/nl/de/c_enable_push.md index a8f06779c..cae1ac4a6 100644 --- a/services/mobilepush/nl/de/c_enable_push.md +++ b/services/mobilepush/nl/de/c_enable_push.md @@ -1,25 +1,25 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Benachrichtigungen für mobile Geräte aktivieren -{: #c_enable_push-notifications} -Letzte Aktualisierung: 18. Januar 2017 -{: .last-updated} - -Stellen Sie sicher, dass die im Abschnitt [Berechtigungsnachweise für einen Benachrichtigungsprovider konfigurieren](t__main_push_config_provider.html) angegebenen Schritte durchgeführt wurden. - -In diesem Abschnitt wird beschrieben, wie Sie Ihre Clientanwendungen - mobile oder Web-Browser-Anwendungen und auch Chrome-Apps und Erweiterungen - für den Empfang von Push-Benachrichtigungen aktivieren, wie Sie grundlegende Benachrichtigungen erstellen, wie Sie das SDK oder Plug-in abrufen und initialisieren und wie Sie Ihr Gerät oder Ihren Browser für den Empfang von Push-Benachrichtigungen registrieren. Sie können auch die [REST-API](t_restapi.html) verwenden, um Ihre mobilen Anwendungen und Web-Browser-Anwendungen für den Empfang von Push-Benachrichtigungen zu aktivieren. - -**Hinweis**: Für Registrierungen von Geräten, Browsern, Chrome-Apps und Erweiterungen pflegt der {{site.data.keyword.mobilepushshort}}-Service eine eindeutige Referenz auf Tokens, die von Benachrichtigungsprovidern ausgegeben werden -(APNs für Apple bzw. FCM für Google). Der Benachrichtigungsprovider des {{site.data.keyword.mobilepushshort}}-Service kann diese Tokens aus diversen Gründen inaktivieren. - -Ein Beispiel wäre die Inaktivierung bei der Deinstallation einer App auf dem Gerät. Bei einem Szenario, bei dem der Versuch unternommen wird, eine Benachrichtigung auf Grundlage der Providerantwort über die Inaktivierung des Geräts zuzustellen, entfernt der {{site.data.keyword.mobilepushshort}}-Service die Geräte- oder Web-Browserregistrierungen. Dadurch werden wiederum nachfolgende Versuche, die Benachrichtigung an diese inaktivierten Geräte zu senden, blockiert. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Benachrichtigungen für mobile Geräte aktivieren +{: #c_enable_push-notifications} +Letzte Aktualisierung: 18. Januar 2017 +{: .last-updated} + +Stellen Sie sicher, dass die im Abschnitt [Berechtigungsnachweise für einen Benachrichtigungsprovider konfigurieren](t__main_push_config_provider.html) angegebenen Schritte durchgeführt wurden. + +In diesem Abschnitt wird beschrieben, wie Sie Ihre Clientanwendungen - mobile oder Web-Browser-Anwendungen und auch Chrome-Apps und Erweiterungen - für den Empfang von Push-Benachrichtigungen aktivieren, wie Sie grundlegende Benachrichtigungen erstellen, wie Sie das SDK oder Plug-in abrufen und initialisieren und wie Sie Ihr Gerät oder Ihren Browser für den Empfang von Push-Benachrichtigungen registrieren. Sie können auch die [REST-API](t_restapi.html) verwenden, um Ihre mobilen Anwendungen und Web-Browser-Anwendungen für den Empfang von Push-Benachrichtigungen zu aktivieren. + +**Hinweis**: Für Registrierungen von Geräten, Browsern, Chrome-Apps und Erweiterungen pflegt der {{site.data.keyword.mobilepushshort}}-Service eine eindeutige Referenz auf Tokens, die von Benachrichtigungsprovidern ausgegeben werden +(APNs für Apple bzw. FCM für Google). Der Benachrichtigungsprovider des {{site.data.keyword.mobilepushshort}}-Service kann diese Tokens aus diversen Gründen inaktivieren. + +Ein Beispiel wäre die Inaktivierung bei der Deinstallation einer App auf dem Gerät. Bei einem Szenario, bei dem der Versuch unternommen wird, eine Benachrichtigung auf Grundlage der Providerantwort über die Inaktivierung des Geräts zuzustellen, entfernt der {{site.data.keyword.mobilepushshort}}-Service die Geräte- oder Web-Browserregistrierungen. Dadurch werden wiederum nachfolgende Versuche, die Benachrichtigung an diese inaktivierten Geräte zu senden, blockiert. diff --git a/services/mobilepush/nl/de/c_enable_push_webhook.md b/services/mobilepush/nl/de/c_enable_push_webhook.md index c20bb47f8..968881946 100644 --- a/services/mobilepush/nl/de/c_enable_push_webhook.md +++ b/services/mobilepush/nl/de/c_enable_push_webhook.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Webhooks aktivieren -{: #tag_based_notifications} -Letzte Aktualisierung: 23. Januar 2017 -{: .last-updated} - - -Mit dem {{site.data.keyword.mobilepushshort}}-Service können Sie sich für das Empfangen von Alerts zu Informationen, die sich geändert haben, entscheiden. Änderungen an Unternehmensinformationen erzeugen Ereignisse, zu denen Sie Benachrichtigungen erhalten können, indem Sie sie als Webhook-Ereignisse registrieren. Diese Webhook-Ereignisse lösen einen Alert aus. - -Webhooks sind benutzerdefinierte Callbacks, die durch ein Ereignis ausgelöst werden, beispielsweise das Registrieren eines Geräts oder das Subskribieren eines Tags. Mit dem {{site.data.keyword.mobilepushshort}}-Service können Sie sich für die folgenden Webhook-Ereignisse registrieren: - -- **onDeviceRegister**: Ein Webhook-Ereignis wird für Geräte ausgelöst, die für Push-Operationen registriert werden. -- **onDeviceUpdate**: Ein Webhook-Ereignis wird ausgelöst, wenn Informationen zu einem registrierten Gerät aktualisiert werden. -- **onDeviceUnregister**: Ein Webhook-Ereignis wird ausgelöst, wenn die Registrierung eines Geräts aufgehoben wird. -- **onSubscribe**: Ein Webhook-Ereignis wird ausgelöst, wenn ein Benutzer einen Tag subskribiert. -- **onUnsubscribe**: Ein Webhook-Ereignis wird ausgelöst, wenn ein Benutzer die Subskription eines Tags aufhebt. -- **onNotificationSend**: Ein Webhook-Ereignis wird für eine Benachrichtigung ausgelöst, die versandt wurde. -- **onNotificationFailure**: Ein Webhook-Ereignis wird für fehlgeschlagene Benachrichtigungen ausgelöst. - - -**Anmerkung**: Das Versenden von Benachrichtigungen erfolgt in Stapeln. Dieselbe Nachrichtenversendung kann mehrere Webhook-Ereignisse umfassen, wobei es sich sowohl um fehlgeschlagene als auch um erfolgreiche handeln kann. -Die Webhook-Ereignisse haben dieselbe Nachrichten-ID (messageID) wie die versandte Nachricht. - -Weitere Informationen zu Webhooks finden Sie in der [IBM Push Notifications-REST-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Webhooks aktivieren +{: #tag_based_notifications} +Letzte Aktualisierung: 23. Januar 2017 +{: .last-updated} + + +Mit dem {{site.data.keyword.mobilepushshort}}-Service können Sie sich für das Empfangen von Alerts zu Informationen, die sich geändert haben, entscheiden. Änderungen an Unternehmensinformationen erzeugen Ereignisse, zu denen Sie Benachrichtigungen erhalten können, indem Sie sie als Webhook-Ereignisse registrieren. Diese Webhook-Ereignisse lösen einen Alert aus. + +Webhooks sind benutzerdefinierte Callbacks, die durch ein Ereignis ausgelöst werden, beispielsweise das Registrieren eines Geräts oder das Subskribieren eines Tags. Mit dem {{site.data.keyword.mobilepushshort}}-Service können Sie sich für die folgenden Webhook-Ereignisse registrieren: + +- **onDeviceRegister**: Ein Webhook-Ereignis wird für Geräte ausgelöst, die für Push-Operationen registriert werden. +- **onDeviceUpdate**: Ein Webhook-Ereignis wird ausgelöst, wenn Informationen zu einem registrierten Gerät aktualisiert werden. +- **onDeviceUnregister**: Ein Webhook-Ereignis wird ausgelöst, wenn die Registrierung eines Geräts aufgehoben wird. +- **onSubscribe**: Ein Webhook-Ereignis wird ausgelöst, wenn ein Benutzer einen Tag subskribiert. +- **onUnsubscribe**: Ein Webhook-Ereignis wird ausgelöst, wenn ein Benutzer die Subskription eines Tags aufhebt. +- **onNotificationSend**: Ein Webhook-Ereignis wird für eine Benachrichtigung ausgelöst, die versandt wurde. +- **onNotificationFailure**: Ein Webhook-Ereignis wird für fehlgeschlagene Benachrichtigungen ausgelöst. + + +**Anmerkung**: Das Versenden von Benachrichtigungen erfolgt in Stapeln. Dieselbe Nachrichtenversendung kann mehrere Webhook-Ereignisse umfassen, wobei es sich sowohl um fehlgeschlagene als auch um erfolgreiche handeln kann. +Die Webhook-Ereignisse haben dieselbe Nachrichten-ID (messageID) wie die versandte Nachricht. + +Weitere Informationen zu Webhooks finden Sie in der [IBM Push Notifications-REST-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}. diff --git a/services/mobilepush/nl/de/c_ios_enable.md b/services/mobilepush/nl/de/c_ios_enable.md index 7e1a0fc7a..7f9e6a56e 100644 --- a/services/mobilepush/nl/de/c_ios_enable.md +++ b/services/mobilepush/nl/de/c_ios_enable.md @@ -1,332 +1,332 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#iOS-Anwendungen für das Senden von Push-Benachrichtigungen aktivieren -{: #enable-push-ios-notifications} -Letzte Aktualisierung: 14. Februar 2017 -{: .last-updated} - -Sie können iOS-Anwendungen für das Senden von Push-Benachrichtigungen an Ihre Geräte aktivieren. - - -##CocoaPods installieren -{: #enable-push-ios-notifications-install} - -Für ein vorhandenes Xcode-Projekt können Sie das Bluemix Mobile Services-Client-SDK mithilfe des Abhängigkeitsmanagementtools CocoaPods einrichten. Als Alternative dazu können Sie das Software-Development-Kit (SDK) manuell installieren. - -Informationen zu Swift Push finden Sie in der [Readme-Datei ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. - - - -1. Installieren Sie CocoaPods, indem Sie in Ihrem Mac-Terminal folgenden Befehl verwenden. -```$ sudo gem install cocoapods -``` - {: codeblock} -2. Geben Sie den Befehl `pod init` in das Terminal ein, um CocoaPods zu initialisieren. Führen Sie den Befehl unbedingt aus dem Verzeichnis aus, in dem sich Ihr Xcode-Projekt befindet. Mit dem Befehl `pod init` wird eine Datei 'Podfile' erstellt. -3. Fügen Sie in der generierten Datei 'Podfile' die erforderlichen SDK-Abhängigkeiten hinzu. Kopieren Sie die folgende Datei 'Podfile'. - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - pod 'BMSAnalyticsAPI' - end - ``` - {: codeblock} - -3. Wechseln Sie am Terminal in Ihren Projektordner und installieren Sie die Abhängigkeiten mithilfe des Befehls `pod update`. - -Mit diesem Befehl werden Ihre Abhängigkeiten installiert und es wird ein neuer Xcode-Arbeitsbereich erstellt. -**Hinweis**: Stellen Sie sicher, dass Sie immer den neuen Xcode-Arbeitsbereich öffnen und nicht die ursprüngliche Xcode-Projektdatei: -``` - $ open App.xcworkspace -``` - {: codeblock} - -Der Arbeitsbereich enthält Ihr ursprüngliches Projekt und das Projekt 'Pods', das Ihre Abhängigkeiten enthält. Wenn Sie den Bluemix mobile Services-Quellenordner ändern möchten, finden Sie diesen in Ihrem Projekt 'Pods' unter `Pods/yourImportedSourceFolder`, zum Beispiel: `Pods/BMSPush`. - -##Frameworks mit Carthage hinzufügen -{: #carthage} - -Fügen Sie mithilfe von [Carthage ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} Frameworks zu Ihrem Projekt hinzu. Beachten Sie, dass Carthage in Xcode8 nicht unterstützt wird. - -1. Fügen Sie `BMSPush`-Frameworks zur Cartfile hinzu: -``` - github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" -``` - {: codeblock} -2. Führen Sie den Befehl `carthage update` aus. Wenn der Build abgeschlossen ist, ziehen Sie `BMSPush.framework`, `BMSCore.framework` und `BMSAnalyticsAPI.framework` in das Xcode-Projekt. -3. Befolgen Sie die Anweisungen auf der [Carthage-Website ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}, um die Integration abzuschließen. - -##iOS-SDK einrichten -{: ios-sdk} - -Richten Sie das iOS-SDK ein. Fügen Sie den folgenden Code der Datei **AppDelegate.swift** in Ihrer Anwendung hinzu. Beachten Sie, dass dies auch bei APNs registriert wird. -``` - func application(_ application: UIApplication, -didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") - } -``` - {: codeblock} - -##Importierte Frameworks und Quellenordner verwenden -{: using-imported-frameworks} - -Referenzieren Sie das SDK in Ihrem Code. Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind. - -- iOS 8.0 oder höher -- Xcode 7 - -Schreiben Sie `#import`-Anweisungen für die entsprechenden Header, zum Beispiel: -``` -//swift -import BMSCore -import BMSPush -``` - {: codeblock} - -Die Push-Readme-Datei für Swift finden Sie in der [Readme-Datei ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. - -**Hinweis**: Durch Aktualisieren Ihres Projekts 'Pods' mithilfe der CocoaPods-Befehle `pod install` oder `pod update` werden die Bluemix Mobile Services-Quellenorder möglicherweise überschrieben. Wenn Sie Ihre angepassten Versionen der ursprünglichen Dateien aufbewahren möchten, müssen Sie sicherstellen, dass für sie ein Backup durchgeführt wird, bevor Sie einen dieser Befehle absetzen. - - -##Buildeinstellungen -{: build-settings} - -Rufen Sie **Xcode > Build Settings > Build Options** auf und setzen Sie **Enable Bitcode** auf **No**. - -**Achtung**: Ab iOS 9 können sich Änderungen an der Komponente 'App Transport Security' (ATS) auf die Verarbeitung des Authentifizierungsprozesses auswirken. Die folgenden Blogbeiträge enthalten weitere Informationen zu den Änderungen: [ATS and Bitcode in iOS 9 ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} und [Connect your iOS 9 app to Bluemix today ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. - -## Push-SDK für iOS-Apps initialisieren -{: #enable-push-ios-notifications-initialize} - -Das Anwendungs-Delegat für die iOS-Anwendung ist eine übliche Position für den Initialisierungscode. Klicken Sie in Ihrem Push-Dashboard auf den Link **Mobile Systemerweiterungen**, um die Anwendungsroute und die GUID abzurufen. - -###Core-SDK initialisieren -{: Initializing-the-core-sdk} - - -``` -// Core-SDK für Swift mit IBM Bluemix-GUID, Route und Region initialisieren -let myBMSClient = BMSClient.sharedInstance -myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") -``` - {: codeblock} - -### Route, GUID und Bluemix-Region -{: route-guid-bluemix-region} - -####appRoute -{: ios-approute} - -Gibt die Route an, die der Serveranwendung zugewiesen ist, die Sie in Bluemix erstellt haben. - -####GUID -{: ios-guid} - -Gibt den eindeutigen Schlüssel an, der der Anwendung zugewiesen wird, die Sie in Bluemix erstellt haben. Bei diesem Wert muss die Groß-/Kleinschreibung beachtet werden. - -####bluemixRegionSuffix -{: ios-bluemixRegionSuffix} - -Gibt den Standort an, an dem die App gehostet ist. Der Parameter `bluemixRegion` gibt an, welche Bluemix-Bereitstellung verwendet wird. Sie können diesen Wert mit der statischen Eigenschaft `BMSClient.REGION` angeben und einen von drei Werten verwenden: - -- BMSClient.Region.usSouth -- BMSClient.Region.unitedKingdom -- BMSClient.Region.sydney - -####AppGUID -{: ios-AppGUID} - -Gibt den eindeutigen 'AppGUID'-Schlüssel an, der dem von Ihnen in Bluemix erstellten {{site.data.keyword.mobilepushshort}}-Service zugewiesen wird. - -###Client-Push-SDK initialisieren -{: initializing-the-client-Push-SDK} - -``` - //Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -## iOS-Anwendungen und -Geräte registrieren -{: #enable-push-ios-notifications-register} - - -Nach der Installation auf einem Gerät muss eine Anwendung bei APNs registriert werden, um ferne Benachrichtigungen empfangen zu können. Nachdem das von APNs generierte Gerätetoken von der App empfangen worden ist, muss es zurück an den {{site.data.keyword.mobilepushshort}}-Service geleitet werden. - -Führen Sie zum Registrieren von iOS-Anwendungen und -Geräten die folgenden Schritte aus: - -1. Erstellen Sie eine Back-End-Anwendung. -2. Übergeben Sie das Token an {{site.data.keyword.mobilepushshort}}. - - -###Back-End-Anwendung erstellen -{: create-a-backend-app} - -Erstellen Sie im Bluemix®-Katalog im Abschnitt 'Boilerplates' eine Back-End-Anwendung, mit der der {{site.data.keyword.mobilepushshort}}-Service automatisch an diese Anwendung gebunden wird. Wenn Sie bereits eine Back-End-App erstellt haben, stellen Sie sicher, dass Sie diese App an den {{site.data.keyword.mobilepushshort}} Service binden. - - -###Tokens an {{site.data.keyword.mobilepushshort}} übergeben -{: pass-token-push-notifications} - -Nachdem das Token von APNs empfangen worden ist, leiten Sie es als Teil der Methode `registerDevice:withDeviceToken` an {{site.data.keyword.mobilepushshort}} weiter. - -Nachdem das Token von APNs empfangen worden ist, leiten Sie es als Teil der Methode `didRegisterForRemoteNotificationsWithDeviceToken` an Push Notifications weiter. - -``` - func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ - let push = BMSPushClient.sharedInstance - push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - } -``` - {: codeblock} - - -## Push-Benachrichtigungen in iOS-Geräten empfangen -{: #enable-push-ios-notifications-receiving} - - -Um Push-Benachrichtigungen in iOS-Geräten zu empfangen, fügen Sie die folgende Swift-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. - -``` - // For Swift -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) - { //UserInfo dictionary will contain data sent from the server } -``` - {: codeblock} - -## Push-Benachrichtigungen in iOS-Geräten überwachen -{: ios-monitoring} - -Um den aktuellen Status der Benachrichtigung zu überwachen, fügen Sie die folgende Swift-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. - -``` - // Send notification status when app is opened by clicking the notifications -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - print("Send message status to the Push server") - } -} -``` - {: codeblock} - -``` - // Send notification status when the app is in background mode. - func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { - let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) - self.showAlert(title: "Recieved Push notifications", message: payLoad) - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - completionHandler(UIBackgroundFetchResult.newData) - } -} -``` - {: codeblock} - - -## Einfache Push-Benachrichtigungen senden -{: #send} - -Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen senden. - -Führen Sie die Schritte aus, um einfache Push-Benachrichtigungen zu senden: - -1. Wählen Sie **Benachrichtigungen senden** aus und erstellen Sie eine Nachricht, indem Sie eine Option für **Senden an** auswählen. Die unterstützten Optionen sind **Gerät nach Tag**, **Geräte-ID**, **Benutzer-ID**, **Android-Geräte**, **iOS-Geräte**, **Webbenachrichtigungen** und **Alle Geräte**. -**Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Benachrichtigungen. -![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) - -2. Erstellen Sie Ihre Nachricht im Feld **Nachricht**. Treffen Sie Ihre Auswahl, um die optionalen Einstellungen wie erforderlich zu konfigurieren. -3. Klicken Sie auf **Senden**. -3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. - -Die folgende Abbildung zeigt ein Alertfeld bei der Verarbeitung einer {{site.data.keyword.mobilepushshort}} eines iOS-Geräts. - -![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) - -### Optionale Einstellungen beim Senden von Benachrichtigungen -{: #send_ios_otpional_setting} - -Sie können die {{site.data.keyword.mobilepushshort}}-Einstellungen zum Senden von Benachrichtigung an iOS-Geräte anpassen. Die folgenden optionalen Anpassungsoptionen werden unterstützt: - -- **Badge** (Badge): Gibt die Zahl an, die auf dem Anwendungsbadge angezeigt wird. Der Standardwert lautet Null (0) und führt dazu, dass kein Badge angezeigt wird. -- **Sound** (Audio): Gibt einen Soundclip an, der beim Empfang einer Benachrichtigung abgespielt wird. Unterstützt den Standard oder den Namen einer Soundressource, die in der App gebündelt ist. -- **Additional payload** (Zusätzliche Nutzdaten): Gibt die angepassten Werte für Nutzdaten für Ihre Benachrichtigungen an. - -##Interaktive Benachrichtigungen aktivieren - -Sie können jetzt Ihre iOS-Benachrichtigungen durch zusätzliche Details wie das Hinzufügen eines Bildes, einer Karte oder einer Antwortschaltfläche attraktiver gestalten, indem Sie interaktive Benachrichtigungen aktivieren. Dadurch wird den Kunden mehr Kontext geboten, verbunden mit der Möglichkeit sofortiger Maßnahmen ohne Verlassen des aktuellen Kontexts. - -Verwenden Sie den folgenden Code zum Aktivieren interaktiver Benachrichtigungen: - -``` - // This defines the button action. - let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) -``` - {: codeblock} -``` - // This defines category for the buttons -let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) -``` - {: codeblock} -``` - // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions -let notificationOptions = BMSPushClientOptions(categoryName: [category]) -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) -``` - {: codeblock} - -Führen Sie die folgenden Schritte aus, um eine interaktive Benachrichtigung zu senden: - -1. Wählen Sie im Abschnitt zum Erstellen für die Dropdown-Liste 'Senden an' **iOS-Geräte** aus. -2. Geben Sie die Benachrichtigungsnachricht ein, die Sie senden möchten. -3. Wählen Sie im Abschnitt mit den optionalen Einstellungen **Mobile** aus und klicken Sie auf **iOS**. -4. Wählen Sie in der Dropdown-Liste 'Typ' **Gemischt** aus. -5. Geben Sie im Feld 'Kategorie' den Benachrichtigungstyp an, den Sie in Ihrer App definiert haben. - -![Interaktive Benachrichtigung für iOS](images/push_ios_notification_interactive.jpg) - -## Nächste Schritte -{: #next_steps_tags} - -Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. - -Fügen Sie diese Funktionen des Push Notifications-Service Ihrer App hinzu. -Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). -Informationen zur Verwendung erweiterter Benachrichtigungsoptionen finden Sie in [Erweiterte Push-Benachrichtigungen aktivieren](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# iOS-Anwendungen für das Senden von Push-Benachrichtigungen aktivieren +{: #enable-push-ios-notifications} +Letzte Aktualisierung: 14. Februar 2017 +{: .last-updated} + +Sie können iOS-Anwendungen für das Senden von Push-Benachrichtigungen an Ihre Geräte aktivieren. + + +## CocoaPods installieren +{: #enable-push-ios-notifications-install} + +Für ein vorhandenes Xcode-Projekt können Sie das Bluemix Mobile Services-Client-SDK mithilfe des Abhängigkeitsmanagementtools CocoaPods einrichten. Als Alternative dazu können Sie das Software-Development-Kit (SDK) manuell installieren. + +Informationen zu Swift Push finden Sie in der [Readme-Datei ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. + + + +1. Installieren Sie CocoaPods, indem Sie in Ihrem Mac-Terminal folgenden Befehl verwenden. +```$ sudo gem install cocoapods +``` + {: codeblock} +2. Geben Sie den Befehl `pod init` in das Terminal ein, um CocoaPods zu initialisieren. Führen Sie den Befehl unbedingt aus dem Verzeichnis aus, in dem sich Ihr Xcode-Projekt befindet. Mit dem Befehl `pod init` wird eine Datei 'Podfile' erstellt. +3. Fügen Sie in der generierten Datei 'Podfile' die erforderlichen SDK-Abhängigkeiten hinzu. Kopieren Sie die folgende Datei 'Podfile'. + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + pod 'BMSAnalyticsAPI' + end + ``` + {: codeblock} + +3. Wechseln Sie am Terminal in Ihren Projektordner und installieren Sie die Abhängigkeiten mithilfe des Befehls `pod update`. + +Mit diesem Befehl werden Ihre Abhängigkeiten installiert und es wird ein neuer Xcode-Arbeitsbereich erstellt. +**Hinweis**: Stellen Sie sicher, dass Sie immer den neuen Xcode-Arbeitsbereich öffnen und nicht die ursprüngliche Xcode-Projektdatei: +``` + $ open App.xcworkspace +``` + {: codeblock} + +Der Arbeitsbereich enthält Ihr ursprüngliches Projekt und das Projekt 'Pods', das Ihre Abhängigkeiten enthält. Wenn Sie den Bluemix mobile Services-Quellenordner ändern möchten, finden Sie diesen in Ihrem Projekt 'Pods' unter `Pods/yourImportedSourceFolder`, zum Beispiel: `Pods/BMSPush`. + +## Frameworks mit Carthage hinzufügen +{: #carthage} + +Fügen Sie mithilfe von [Carthage ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} Frameworks zu Ihrem Projekt hinzu. Beachten Sie, dass Carthage in Xcode8 nicht unterstützt wird. + +1. Fügen Sie `BMSPush`-Frameworks zur Cartfile hinzu: +``` + github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" +``` + {: codeblock} +2. Führen Sie den Befehl `carthage update` aus. Wenn der Build abgeschlossen ist, ziehen Sie `BMSPush.framework`, `BMSCore.framework` und `BMSAnalyticsAPI.framework` in das Xcode-Projekt. +3. Befolgen Sie die Anweisungen auf der [Carthage-Website ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}, um die Integration abzuschließen. + +## iOS-SDK einrichten +{: ios-sdk} + +Richten Sie das iOS-SDK ein. Fügen Sie den folgenden Code der Datei **AppDelegate.swift** in Ihrer Anwendung hinzu. Beachten Sie, dass dies auch bei APNs registriert wird. +``` + func application(_ application: UIApplication, +didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") + } +``` + {: codeblock} + +## Importierte Frameworks und Quellenordner verwenden +{: using-imported-frameworks} + +Referenzieren Sie das SDK in Ihrem Code. Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind. + +- iOS 8.0 oder höher +- Xcode 7 + +Schreiben Sie `#import`-Anweisungen für die entsprechenden Header, zum Beispiel: +``` +//swift +import BMSCore +import BMSPush +``` + {: codeblock} + +Die Push-Readme-Datei für Swift finden Sie in der [Readme-Datei ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. + +**Hinweis**: Durch Aktualisieren Ihres Projekts 'Pods' mithilfe der CocoaPods-Befehle `pod install` oder `pod update` werden die Bluemix Mobile Services-Quellenorder möglicherweise überschrieben. Wenn Sie Ihre angepassten Versionen der ursprünglichen Dateien aufbewahren möchten, müssen Sie sicherstellen, dass für sie ein Backup durchgeführt wird, bevor Sie einen dieser Befehle absetzen. + + +## Buildeinstellungen +{: build-settings} + +Rufen Sie **Xcode > Build Settings > Build Options** auf und setzen Sie **Enable Bitcode** auf **No**. + +**Achtung**: Ab iOS 9 können sich Änderungen an der Komponente 'App Transport Security' (ATS) auf die Verarbeitung des Authentifizierungsprozesses auswirken. Die folgenden Blogbeiträge enthalten weitere Informationen zu den Änderungen: [ATS and Bitcode in iOS 9 ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} und [Connect your iOS 9 app to Bluemix today ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. + +## Push-SDK für iOS-Apps initialisieren +{: #enable-push-ios-notifications-initialize} + +Das Anwendungs-Delegat für die iOS-Anwendung ist eine übliche Position für den Initialisierungscode. Klicken Sie in Ihrem Push-Dashboard auf den Link **Mobile Systemerweiterungen**, um die Anwendungsroute und die GUID abzurufen. + +### Core-SDK initialisieren +{: Initializing-the-core-sdk} + + +``` +// Core-SDK für Swift mit IBM Bluemix-GUID, Route und Region initialisieren +let myBMSClient = BMSClient.sharedInstance +myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") +``` + {: codeblock} + +### Route, GUID und Bluemix-Region +{: route-guid-bluemix-region} + +#### appRoute +{: ios-approute} + +Gibt die Route an, die der Serveranwendung zugewiesen ist, die Sie in Bluemix erstellt haben. + +#### GUID +{: ios-guid} + +Gibt den eindeutigen Schlüssel an, der der Anwendung zugewiesen wird, die Sie in Bluemix erstellt haben. Bei diesem Wert muss die Groß-/Kleinschreibung beachtet werden. + +#### bluemixRegionSuffix +{: ios-bluemixRegionSuffix} + +Gibt den Standort an, an dem die App gehostet ist. Der Parameter `bluemixRegion` gibt an, welche Bluemix-Bereitstellung verwendet wird. Sie können diesen Wert mit der statischen Eigenschaft `BMSClient.REGION` angeben und einen von drei Werten verwenden: + +- BMSClient.Region.usSouth +- BMSClient.Region.unitedKingdom +- BMSClient.Region.sydney + +#### AppGUID +{: ios-AppGUID} + +Gibt den eindeutigen 'AppGUID'-Schlüssel an, der dem von Ihnen in Bluemix erstellten {{site.data.keyword.mobilepushshort}}-Service zugewiesen wird. + +### Client-Push-SDK initialisieren +{: initializing-the-client-Push-SDK} + +``` + //Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +## iOS-Anwendungen und -Geräte registrieren +{: #enable-push-ios-notifications-register} + + +Nach der Installation auf einem Gerät muss eine Anwendung bei APNs registriert werden, um ferne Benachrichtigungen empfangen zu können. Nachdem das von APNs generierte Gerätetoken von der App empfangen worden ist, muss es zurück an den {{site.data.keyword.mobilepushshort}}-Service geleitet werden. + +Führen Sie zum Registrieren von iOS-Anwendungen und -Geräten die folgenden Schritte aus: + +1. Erstellen Sie eine Back-End-Anwendung. +2. Übergeben Sie das Token an {{site.data.keyword.mobilepushshort}}. + + +### Back-End-Anwendung erstellen +{: create-a-backend-app} + +Erstellen Sie im Bluemix®-Katalog im Abschnitt 'Boilerplates' eine Back-End-Anwendung, mit der der {{site.data.keyword.mobilepushshort}}-Service automatisch an diese Anwendung gebunden wird. Wenn Sie bereits eine Back-End-App erstellt haben, stellen Sie sicher, dass Sie diese App an den {{site.data.keyword.mobilepushshort}} Service binden. + + +### Tokens an {{site.data.keyword.mobilepushshort}} übergeben +{: pass-token-push-notifications} + +Nachdem das Token von APNs empfangen worden ist, leiten Sie es als Teil der Methode `registerDevice:withDeviceToken` an {{site.data.keyword.mobilepushshort}} weiter. + +Nachdem das Token von APNs empfangen worden ist, leiten Sie es als Teil der Methode `didRegisterForRemoteNotificationsWithDeviceToken` an Push Notifications weiter. + +``` + func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ + let push = BMSPushClient.sharedInstance + push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + } +``` + {: codeblock} + + +## Push-Benachrichtigungen in iOS-Geräten empfangen +{: #enable-push-ios-notifications-receiving} + + +Um Push-Benachrichtigungen in iOS-Geräten zu empfangen, fügen Sie die folgende Swift-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. + +``` + // For Swift +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) + { //UserInfo dictionary will contain data sent from the server } +``` + {: codeblock} + +## Push-Benachrichtigungen in iOS-Geräten überwachen +{: ios-monitoring} + +Um den aktuellen Status der Benachrichtigung zu überwachen, fügen Sie die folgende Swift-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. + +``` + // Send notification status when app is opened by clicking the notifications +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + print("Send message status to the Push server") + } +} +``` + {: codeblock} + +``` + // Send notification status when the app is in background mode. + func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { + let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) + self.showAlert(title: "Recieved Push notifications", message: payLoad) + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + completionHandler(UIBackgroundFetchResult.newData) + } +} +``` + {: codeblock} + + +## Einfache Push-Benachrichtigungen senden +{: #send} + +Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen senden. + +Führen Sie die Schritte aus, um einfache Push-Benachrichtigungen zu senden: + +1. Wählen Sie **Benachrichtigungen senden** aus und erstellen Sie eine Nachricht, indem Sie eine Option für **Senden an** auswählen. Die unterstützten Optionen sind **Gerät nach Tag**, **Geräte-ID**, **Benutzer-ID**, **Android-Geräte**, **iOS-Geräte**, **Webbenachrichtigungen** und **Alle Geräte**. +**Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Benachrichtigungen. +![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) + +2. Erstellen Sie Ihre Nachricht im Feld **Nachricht**. Treffen Sie Ihre Auswahl, um die optionalen Einstellungen wie erforderlich zu konfigurieren. +3. Klicken Sie auf **Senden**. +3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. + +Die folgende Abbildung zeigt ein Alertfeld bei der Verarbeitung einer {{site.data.keyword.mobilepushshort}} eines iOS-Geräts. + +![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) + +### Optionale Einstellungen beim Senden von Benachrichtigungen +{: #send_ios_otpional_setting} + +Sie können die {{site.data.keyword.mobilepushshort}}-Einstellungen zum Senden von Benachrichtigung an iOS-Geräte anpassen. Die folgenden optionalen Anpassungsoptionen werden unterstützt: + +- **Badge** (Badge): Gibt die Zahl an, die auf dem Anwendungsbadge angezeigt wird. Der Standardwert lautet Null (0) und führt dazu, dass kein Badge angezeigt wird. +- **Sound** (Audio): Gibt einen Soundclip an, der beim Empfang einer Benachrichtigung abgespielt wird. Unterstützt den Standard oder den Namen einer Soundressource, die in der App gebündelt ist. +- **Additional payload** (Zusätzliche Nutzdaten): Gibt die angepassten Werte für Nutzdaten für Ihre Benachrichtigungen an. + +## Interaktive Benachrichtigungen aktivieren + +Sie können jetzt Ihre iOS-Benachrichtigungen durch zusätzliche Details wie das Hinzufügen eines Bildes, einer Karte oder einer Antwortschaltfläche attraktiver gestalten, indem Sie interaktive Benachrichtigungen aktivieren. Dadurch wird den Kunden mehr Kontext geboten, verbunden mit der Möglichkeit sofortiger Maßnahmen ohne Verlassen des aktuellen Kontexts. + +Verwenden Sie den folgenden Code zum Aktivieren interaktiver Benachrichtigungen: + +``` + // This defines the button action. + let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) +``` + {: codeblock} +``` + // This defines category for the buttons +let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) +``` + {: codeblock} +``` + // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions +let notificationOptions = BMSPushClientOptions(categoryName: [category]) +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) +``` + {: codeblock} + +Führen Sie die folgenden Schritte aus, um eine interaktive Benachrichtigung zu senden: + +1. Wählen Sie im Abschnitt zum Erstellen für die Dropdown-Liste 'Senden an' **iOS-Geräte** aus. +2. Geben Sie die Benachrichtigungsnachricht ein, die Sie senden möchten. +3. Wählen Sie im Abschnitt mit den optionalen Einstellungen **Mobile** aus und klicken Sie auf **iOS**. +4. Wählen Sie in der Dropdown-Liste 'Typ' **Gemischt** aus. +5. Geben Sie im Feld 'Kategorie' den Benachrichtigungstyp an, den Sie in Ihrer App definiert haben. + +![Interaktive Benachrichtigung für iOS](images/push_ios_notification_interactive.jpg) + +## Nächste Schritte +{: #next_steps_tags} + +Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. + +Fügen Sie diese Funktionen des Push Notifications-Service Ihrer App hinzu. +Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). +Informationen zur Verwendung erweiterter Benachrichtigungsoptionen finden Sie in [Erweiterte Push-Benachrichtigungen aktivieren](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/de/c_overview_push.md b/services/mobilepush/nl/de/c_overview_push.md index da84717fe..476c3e9f9 100644 --- a/services/mobilepush/nl/de/c_overview_push.md +++ b/services/mobilepush/nl/de/c_overview_push.md @@ -1,128 +1,128 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Informationen zu {{site.data.keyword.mobilepushshort}} -{: #overview-push} -Letzte Aktualisierung: 18. Januar 2017 -{: .last-updated} - -Mit dem IBM Service {{site.data.keyword.mobilepushshort}} können Sie Benachrichtigungen an Geräte und Plattformen senden. Benachrichtigungen können zielgruppenspezifisch an alle Anwendungsbenutzer und an bestimmte Benutzergruppen und Geräte mithilfe von Tags gesendet werden. Sie können Geräte, Tags und Subskriptionen verwalten. - -Zum Erstellen eines gebundenen oder nicht gebundenen Service können Sie eine der folgenden Optionen verwenden: - -- Durch Erstellen einer Bluemix-Anwendung mithilfe der Boilerplate 'MobileFirst Services Starter' aus dem Katalog. Diese Option erstellt einen Push-Benachrichtigungsservice, der an eine Bluemix-Back-End-Anwendung gebunden ist. -- Durch Erstellen eines nicht gebundenen Push-Benachrichtigungsservice direkt aus dem Mobile-Katalog. Sie können die Anwendung später binden oder als nicht gebundene Anwendung verwenden. -- Mit dem [Mobile-Dashboard ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}. - -Beachten Sie, dass auf der Registerkarte zur Überwachung von Push-Benachrichtigungen keine Analysedaten angezeigt werden. - -Der {{site.data.keyword.mobilepushshort}}-Service ist nun OpenWhisk-fähig. Weitere Informationen finden Sie unter [OpenWhisk](/docs/openwhisk/index.html). - - -## Prozess für den {{site.data.keyword.mobilepushshort}}-Service -{: #overview_push_process} - -Mobile Clients, Web-Browser-Clients und Google Chrome-Apps und Erweiterungen können den {{site.data.keyword.mobilepushshort}}-Service subskribieren und sich bei ihm registrieren. Beim Start registrieren sich die Clientanwendungen beim {{site.data.keyword.mobilepushshort}}-Service und subskribieren ihn. Die Benachrichtigungen werden dem Server von Apple Push Notification Service (APNs) oder von Google Cloud Messaging (GCM) zugeteilt und anschließend an registrierte mobile oder Browser-Clients gesendet. - -![Überblick über den Push-Service](images/overview.jpg) - - -###Mobile Anwendungen und Browseranwendungen -{: mobile-applications} - -Beim Start registrieren sich Clientanwendungen beim {{site.data.keyword.mobilepushshort}}-Service und subskribieren ihn, um Benachrichtigungen empfangen zu können. - -###Back-End-Anwendungen -{: backend-applications} - -Back-End-Anwendungen können sich vor Ort oder in einer öffentlichen Cloud befinden. Back-End-Anwendungen verwenden den {{site.data.keyword.mobilepushshort}}-Service zum Senden kontextabhängiger Benachrichtigungen an Benutzer von mobilen Geräten und Browseranwendungen. Die Back-End-Anwendungen sind für die Verwaltung und Wartung von mobilen Geräten, Browseragenten und von Benutzerinformationen zum Senden von Push-Benachrichtigungen nicht erforderlich. Stattdessen können Back-End-Anwendungen den {{site.data.keyword.mobilepushshort}}-Service verwenden, der Sie verwaltet und wartet. - -###Eigner der Back-End-App -{: app-backend-owner} - -Der Eigner der Back-End-App erstellt die mobile Back-End-Anwendung, die eine Instanz des {{site.data.keyword.mobilepushshort}}-Service bündelt. Der Eigner der Back-End-App konfiguriert außerdem den {{site.data.keyword.mobilepushshort}}-Service und richtet ihn so ein, dass er sich für die Back-End-Anwendungen eignet, die den Service verwenden, sowie für mobile Anwendungen und Browseranwendungen, die als Ziel für Push-Nachrichten fungieren. - -###{{site.data.keyword.mobilepushshort}}-Service -{: push-notification-service} - -Der {{site.data.keyword.mobilepushshort}}-Service ist für die Verwaltung aller Informationen im Zusammenhang mit mobilen Geräten und Web-Browser-Clients zuständig, die für Benachrichtigungen registriert sind. Der Service sorgt dafür, dass Ihre Anwendungen transparent gegenüber den Technologiedetails beim Senden von Benachrichtigungen an heterogene mobile Plattformen und Browserplattformen bleiben, und verarbeitet dies alles innerhalb seiner Tätigkeit. - -###Gateways -{: gateways} - -Plattformspezifische Cloud-Services für Push-Benachrichtigungen wie FCM/GCM oder Apple Push Notification Service (APNs), die vom IBM {{site.data.keyword.mobilepushshort}}-Service verwendet werden, um Benachrichtigungen an mobile und Browseranwendungen zu verteilen. - -###Sicherheit von Push-Benachrichtigungen -{: push-security} - -{{site.data.keyword.mobilepushshort}}-APIs sind durch zwei geheime Schlüssel geschützt. - -- Der geheime Schlüssel **appSecret** schützt APIs, die normalerweise von Back-End-Anwendungen wie der API zum Senden von Push-Benachrichtigungen oder der API zum Konfigurieren von Einstellungen aufgerufen werden. -- Der geheime Schlüssel **clientSecret** schützt APIs, die normalerweise von mobilen Clientanwendungen aufgerufen werden. Es gibt im Zusammenhang mit der Registrierung von Geräten nur eine API mit zugeordneter Benutzer-ID, die diesen geheimen Clientschlüssel erfordert. Keine der anderen APIs, die von mobilen Clients aufgerufen werden, erfordert den geheimen Clientschlüssel. - -Die geheimen Schlüssel 'appSecret' und 'clientSecret' werden jeder Serviceinstanz beim Binden einer Anwendung mit dem {{site.data.keyword.mobilepushshort}}-Service zugeordnet. Weitere Informationen dazu, auf welche Weise und für welche APIs die geheimen Schlüssel übergeben werden sollen, finden Sie in der Dokumentation für [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/). - -**Hinweis**: Frühere Anwendungen mussten den geheimen Clientschlüssel (clientSecret) nur bei der Registrierung oder Aktualisierung von Geräten mit dem Feld für die Benutzer-ID (userId) übergeben. Alle anderen APIs, die von mobilen oder Browserclients aufgerufen wurden, benötigten den geheimen Clientschlüssel nicht. Diese früheren Anwendungen können den geheimen Clientschlüssel auch weiterhin optional für Geräteregistrierungen oder Aktualisierungsaufrufe verwenden. Es wird jedoch dringend empfohlen, dass die Prüfung des geheimen Clientschlüssels für alle Aufrufe der Client-API zwingend durchgeführt wird. Um dies in vorhandenen Anwendungen durchzusetzen, wurde eine neue API mit dem Namen 'verifyClientSecret' veröffentlicht. Für neue Anwendungen wird die Überprüfung des geheimen Clientschlüssels bei allen Aufrufen der Client-API erzwungen. Dieses Verhalten kann auch durch die API 'verifyClientSecret' nicht verändert werden. - -Standardmäßig wird die Verifizierung des geheimen Clientschlüssels nur bei neuen Apps erzwungen. Sowohl vorhandene als auch neue Apps können die Verifizierung des geheimen Clientschlüssels mithilfe der REST-API 'verifyClientSecret' aktivieren oder inaktivieren. Es wird empfohlen, die Verifizierung des geheimen Clientschlüssels zu erzwingen, um zu verhindern, dass Benutzer mit Kenntnis der Anwendungs-ID und der Geräte-ID Zugang zu Geräten erhalten. - -Stellen Sie sicher, dass der geheime Clientschlüsel vertraulich behandelt wird und zu keinem Zeitpunkt in der mobilen App fest codiert ist. Es gibt verschiedene Muster für die Anwendungsinitialisierung, mit denen der geheime Clientschlüssel zur Anwendungslaufzeit dynamisch extrahiert werden kann. Das Ablaufdiagramm stellt solche möglichen Muster dar. -![Push-Aktivierung](images/init_client_secret.jpg) - -## Typen von Push-Benachrichtigungen -{: #overview-push-types} - -###Broadcast -{: broadcast} - -Wenn sich eine Clientanwendung beim {{site.data.keyword.mobilepushshort}}-Service registriert, kann sie Rundsendungen (Broadcasts) empfangen. Broadcast-Benachrichtigungen sind Benachrichtigungen mit all jenen Anwendungsinstanzen als Ziel, die in verschiedenen Mobilgeräten oder Browsern installiert oder als Instanzen von Chrome-Apps oder Erweiterungen implementiert sind und für den {{site.data.keyword.mobilepushshort}}-Service konfiguriert wurden. Broadcast-Benachrichtigungen sind standardmäßig für jede beliebige Anwendung aktiviert, die Push-Benachrichtigungen empfangen kann. Alle Anwendungen, die für den {{site.data.keyword.mobilepushshort}}-Service aktiviert sind, verfügen über eine vordefinierte Subskription für den Tag 'Push.ALL', der vom Server zum Übertragen von Broadcast-Benachrichtigungen an alle Geräte verwendet wird. Zum Senden einer Broadcast-Benachrichtigung mithilfe der REST-API von Push müssen Sie während der Übergabe an die Ressource der Nachrichten sicherstellen, dass als 'Ziel' eine leere JSON-Datei angegeben ist. - -###Tagbasierte Benachrichtigungen -{: tag-based-notifications} - -Tag-Benachrichtigungen sind Benachrichtigungen, die all diejenigen Geräte zum Ziel haben, die einen bestimmten Tag subskribiert haben. Tagbasierte Benachrichtigungen ermöglichen die Segmentierung von Benachrichtigungen auf der Basis von Subjektbereichen oder Themen. Benachrichtigungsempfänger können wählen, dass sie Benachrichtigungen nur empfangen, wenn deren Inhalt ein Thema hat, das von Interesse ist. Daher bieten tagbasierte Benachrichtigungen die Möglichkeit, Empfänger zu segmentieren. Diese Funktion ermöglicht es, dass Tags definiert werden und anschließend Nachrichten geordnet nach Tags gesendet und empfangen werden. Eine Nachricht wird zielgruppenspezifisch nur an die Instanzen einer Clientanwendung (in Mobilgeräten, Browsern oder als App oder Erweiterungen) gesendet, die den Tag subskribiert haben. Sie müssen zunächst Tags für die Anwendung erstellen, die Tagsubskriptionen einrichten und anschließend die tagbasierten Benachrichtigungen starten. Zum Senden einer tagbasierten Benachrichtigung mithilfe der REST-API müssen Sie sicherstellen, dass während der Übergabe an die Ressource der Nachricht die Tagnamen ('tagNames') angegeben werden. - -###Unicast-Benachrichtigungen -{: unicast-notifications} - -Unicast-Benachrichtigungen sind Nachrichten, die ein bestimmtes Gerät oder einen bestimmten Benutzer zum Ziel haben. Unicast-Benachrichtigungen, die auf Geräte abzielen, benötigen keine zusätzliche Konfiguration und werden standardmäßig aktiviert, wenn die Anwendung für Push-Benachrichtigungen aktiviert wird. - -Unicast-Benachrichtigungen an spezifische Benutzer erfordern zum Zeitpunkt der Registrierung des mobilen Clientgeräts oder Web-Browsers oder von Chrome-Apps und Erweiterungen bei {{site.data.keyword.mobilepushshort}} die Zuordnung einer Benutzer-ID zum Gerät. - -Normalerweise führt eine Clientanwendung zuerst einen Authentifizierungszyklus aus, bei dem der Benutzer der mobilen App bei einem Authentifizierungsservice wie [Mobile Client Access](docs/services/mobileaccess/index.html) authentifiziert wird. Nach der erfolgreichen Authentifizierung wird die ID des authentifizierten Benutzers dann an die API für Push-Geräteregistrierungen übergeben. -Zum Senden einer Unicast-Benachrichtigung über die REST-API müssen Sie sicherstellen, dass während der Übergabe an die Ressource der Nachricht die Geräte- oder Benutzer-IDs ('deviceId' bzw. 'userId') angegeben werden. - -###Plattformbasierte Benachrichtigungen -{: platform-based-notifications} - -Benachrichtigungen können zielgruppenspezifisch an eine bestimmte Geräteplattform gerichtet werden. Eine Benachrichtigung kann beispielsweise nur an alle Android-Benutzer oder an alle Google Chrome-Benutzer gesendet werden. Stellen Sie zum Senden einer plattformbasierten Benachrichtigung mithilfe der REST-API sicher, dass die Zielplattformen während der Übergabe an eine Nachrichtenressource bereitgestellt werden. Geben Sie die Plattformen als Array an. Folgende Plattformen werden unterstützt: -* A (Apple) -* G (Google) -* WEB_CHROME (Google Chrome-Browser Web Push) -* WEB_FIREFOX (Mozilla Firefox-Browser Web Push) -* WEB_SAFARI (Safari-Browser Web Push) -* APPEXT_CHROME (Google Chrome-Apps & Erweiterungen) - -## Größe von {{site.data.keyword.mobilepushshort}}-Nachrichten -{: #push-message-size} - -Die Größe der {{site.data.keyword.mobilepushshort}}-Nachrichtennutzdaten hängt von den Einschränkungen ab, die durch die Gateways (FCM/GCM, APNs) und Clientplattformen festgelegt sind. - -### iOS und Safari -{: ios-message-size} - -Ab iOS 8 beträgt die zulässige maximale Größe 2 Kilobyte. Der Push Notification-Service für Apple sendet keine Benachrichtigungen, die dieses Limit überschreiten. - -###Android, Firefox-Browser, Chrome-Browser und Chrome Apps & Erweiterungen -{: android-message-size} - -Es gibt eine Einschränkung von 4 Kilobyte als maximal zulässige Nachrichtennutzdatengröße. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Informationen zu {{site.data.keyword.mobilepushshort}} +{: #overview-push} +Letzte Aktualisierung: 18. Januar 2017 +{: .last-updated} + +Mit dem IBM Service {{site.data.keyword.mobilepushshort}} können Sie Benachrichtigungen an Geräte und Plattformen senden. Benachrichtigungen können zielgruppenspezifisch an alle Anwendungsbenutzer und an bestimmte Benutzergruppen und Geräte mithilfe von Tags gesendet werden. Sie können Geräte, Tags und Subskriptionen verwalten. + +Zum Erstellen eines gebundenen oder nicht gebundenen Service können Sie eine der folgenden Optionen verwenden: + +- Durch Erstellen einer Bluemix-Anwendung mithilfe der Boilerplate 'MobileFirst Services Starter' aus dem Katalog. Diese Option erstellt einen Push-Benachrichtigungsservice, der an eine Bluemix-Back-End-Anwendung gebunden ist. +- Durch Erstellen eines nicht gebundenen Push-Benachrichtigungsservice direkt aus dem Mobile-Katalog. Sie können die Anwendung später binden oder als nicht gebundene Anwendung verwenden. +- Mit dem [Mobile-Dashboard ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}. + +Beachten Sie, dass auf der Registerkarte zur Überwachung von Push-Benachrichtigungen keine Analysedaten angezeigt werden. + +Der {{site.data.keyword.mobilepushshort}}-Service ist nun OpenWhisk-fähig. Weitere Informationen finden Sie unter [OpenWhisk](/docs/openwhisk/index.html). + + +## Prozess für den {{site.data.keyword.mobilepushshort}}-Service +{: #overview_push_process} + +Mobile Clients, Web-Browser-Clients und Google Chrome-Apps und Erweiterungen können den {{site.data.keyword.mobilepushshort}}-Service subskribieren und sich bei ihm registrieren. Beim Start registrieren sich die Clientanwendungen beim {{site.data.keyword.mobilepushshort}}-Service und subskribieren ihn. Die Benachrichtigungen werden dem Server von Apple Push Notification Service (APNs) oder von Google Cloud Messaging (GCM) zugeteilt und anschließend an registrierte mobile oder Browser-Clients gesendet. + +![Überblick über den Push-Service](images/overview.jpg) + + +###Mobile Anwendungen und Browseranwendungen +{: mobile-applications} + +Beim Start registrieren sich Clientanwendungen beim {{site.data.keyword.mobilepushshort}}-Service und subskribieren ihn, um Benachrichtigungen empfangen zu können. + +###Back-End-Anwendungen +{: backend-applications} + +Back-End-Anwendungen können sich vor Ort oder in einer öffentlichen Cloud befinden. Back-End-Anwendungen verwenden den {{site.data.keyword.mobilepushshort}}-Service zum Senden kontextabhängiger Benachrichtigungen an Benutzer von mobilen Geräten und Browseranwendungen. Die Back-End-Anwendungen sind für die Verwaltung und Wartung von mobilen Geräten, Browseragenten und von Benutzerinformationen zum Senden von Push-Benachrichtigungen nicht erforderlich. Stattdessen können Back-End-Anwendungen den {{site.data.keyword.mobilepushshort}}-Service verwenden, der Sie verwaltet und wartet. + +###Eigner der Back-End-App +{: app-backend-owner} + +Der Eigner der Back-End-App erstellt die mobile Back-End-Anwendung, die eine Instanz des {{site.data.keyword.mobilepushshort}}-Service bündelt. Der Eigner der Back-End-App konfiguriert außerdem den {{site.data.keyword.mobilepushshort}}-Service und richtet ihn so ein, dass er sich für die Back-End-Anwendungen eignet, die den Service verwenden, sowie für mobile Anwendungen und Browseranwendungen, die als Ziel für Push-Nachrichten fungieren. + +###{{site.data.keyword.mobilepushshort}}-Service +{: push-notification-service} + +Der {{site.data.keyword.mobilepushshort}}-Service ist für die Verwaltung aller Informationen im Zusammenhang mit mobilen Geräten und Web-Browser-Clients zuständig, die für Benachrichtigungen registriert sind. Der Service sorgt dafür, dass Ihre Anwendungen transparent gegenüber den Technologiedetails beim Senden von Benachrichtigungen an heterogene mobile Plattformen und Browserplattformen bleiben, und verarbeitet dies alles innerhalb seiner Tätigkeit. + +###Gateways +{: gateways} + +Plattformspezifische Cloud-Services für Push-Benachrichtigungen wie FCM/GCM oder Apple Push Notification Service (APNs), die vom IBM {{site.data.keyword.mobilepushshort}}-Service verwendet werden, um Benachrichtigungen an mobile und Browseranwendungen zu verteilen. + +###Sicherheit von Push-Benachrichtigungen +{: push-security} + +{{site.data.keyword.mobilepushshort}}-APIs sind durch zwei geheime Schlüssel geschützt. + +- Der geheime Schlüssel **appSecret** schützt APIs, die normalerweise von Back-End-Anwendungen wie der API zum Senden von Push-Benachrichtigungen oder der API zum Konfigurieren von Einstellungen aufgerufen werden. +- Der geheime Schlüssel **clientSecret** schützt APIs, die normalerweise von mobilen Clientanwendungen aufgerufen werden. Es gibt im Zusammenhang mit der Registrierung von Geräten nur eine API mit zugeordneter Benutzer-ID, die diesen geheimen Clientschlüssel erfordert. Keine der anderen APIs, die von mobilen Clients aufgerufen werden, erfordert den geheimen Clientschlüssel. + +Die geheimen Schlüssel 'appSecret' und 'clientSecret' werden jeder Serviceinstanz beim Binden einer Anwendung mit dem {{site.data.keyword.mobilepushshort}}-Service zugeordnet. Weitere Informationen dazu, auf welche Weise und für welche APIs die geheimen Schlüssel übergeben werden sollen, finden Sie in der Dokumentation für [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/). + +**Hinweis**: Frühere Anwendungen mussten den geheimen Clientschlüssel (clientSecret) nur bei der Registrierung oder Aktualisierung von Geräten mit dem Feld für die Benutzer-ID (userId) übergeben. Alle anderen APIs, die von mobilen oder Browserclients aufgerufen wurden, benötigten den geheimen Clientschlüssel nicht. Diese früheren Anwendungen können den geheimen Clientschlüssel auch weiterhin optional für Geräteregistrierungen oder Aktualisierungsaufrufe verwenden. Es wird jedoch dringend empfohlen, dass die Prüfung des geheimen Clientschlüssels für alle Aufrufe der Client-API zwingend durchgeführt wird. Um dies in vorhandenen Anwendungen durchzusetzen, wurde eine neue API mit dem Namen 'verifyClientSecret' veröffentlicht. Für neue Anwendungen wird die Überprüfung des geheimen Clientschlüssels bei allen Aufrufen der Client-API erzwungen. Dieses Verhalten kann auch durch die API 'verifyClientSecret' nicht verändert werden. + +Standardmäßig wird die Verifizierung des geheimen Clientschlüssels nur bei neuen Apps erzwungen. Sowohl vorhandene als auch neue Apps können die Verifizierung des geheimen Clientschlüssels mithilfe der REST-API 'verifyClientSecret' aktivieren oder inaktivieren. Es wird empfohlen, die Verifizierung des geheimen Clientschlüssels zu erzwingen, um zu verhindern, dass Benutzer mit Kenntnis der Anwendungs-ID und der Geräte-ID Zugang zu Geräten erhalten. + +Stellen Sie sicher, dass der geheime Clientschlüsel vertraulich behandelt wird und zu keinem Zeitpunkt in der mobilen App fest codiert ist. Es gibt verschiedene Muster für die Anwendungsinitialisierung, mit denen der geheime Clientschlüssel zur Anwendungslaufzeit dynamisch extrahiert werden kann. Das Ablaufdiagramm stellt solche möglichen Muster dar. +![Push-Aktivierung](images/init_client_secret.jpg) + +## Typen von Push-Benachrichtigungen +{: #overview-push-types} + +###Broadcast +{: broadcast} + +Wenn sich eine Clientanwendung beim {{site.data.keyword.mobilepushshort}}-Service registriert, kann sie Rundsendungen (Broadcasts) empfangen. Broadcast-Benachrichtigungen sind Benachrichtigungen mit all jenen Anwendungsinstanzen als Ziel, die in verschiedenen Mobilgeräten oder Browsern installiert oder als Instanzen von Chrome-Apps oder Erweiterungen implementiert sind und für den {{site.data.keyword.mobilepushshort}}-Service konfiguriert wurden. Broadcast-Benachrichtigungen sind standardmäßig für jede beliebige Anwendung aktiviert, die Push-Benachrichtigungen empfangen kann. Alle Anwendungen, die für den {{site.data.keyword.mobilepushshort}}-Service aktiviert sind, verfügen über eine vordefinierte Subskription für den Tag 'Push.ALL', der vom Server zum Übertragen von Broadcast-Benachrichtigungen an alle Geräte verwendet wird. Zum Senden einer Broadcast-Benachrichtigung mithilfe der REST-API von Push müssen Sie während der Übergabe an die Ressource der Nachrichten sicherstellen, dass als 'Ziel' eine leere JSON-Datei angegeben ist. + +###Tagbasierte Benachrichtigungen +{: tag-based-notifications} + +Tag-Benachrichtigungen sind Benachrichtigungen, die all diejenigen Geräte zum Ziel haben, die einen bestimmten Tag subskribiert haben. Tagbasierte Benachrichtigungen ermöglichen die Segmentierung von Benachrichtigungen auf der Basis von Subjektbereichen oder Themen. Benachrichtigungsempfänger können wählen, dass sie Benachrichtigungen nur empfangen, wenn deren Inhalt ein Thema hat, das von Interesse ist. Daher bieten tagbasierte Benachrichtigungen die Möglichkeit, Empfänger zu segmentieren. Diese Funktion ermöglicht es, dass Tags definiert werden und anschließend Nachrichten geordnet nach Tags gesendet und empfangen werden. Eine Nachricht wird zielgruppenspezifisch nur an die Instanzen einer Clientanwendung (in Mobilgeräten, Browsern oder als App oder Erweiterungen) gesendet, die den Tag subskribiert haben. Sie müssen zunächst Tags für die Anwendung erstellen, die Tagsubskriptionen einrichten und anschließend die tagbasierten Benachrichtigungen starten. Zum Senden einer tagbasierten Benachrichtigung mithilfe der REST-API müssen Sie sicherstellen, dass während der Übergabe an die Ressource der Nachricht die Tagnamen ('tagNames') angegeben werden. + +###Unicast-Benachrichtigungen +{: unicast-notifications} + +Unicast-Benachrichtigungen sind Nachrichten, die ein bestimmtes Gerät oder einen bestimmten Benutzer zum Ziel haben. Unicast-Benachrichtigungen, die auf Geräte abzielen, benötigen keine zusätzliche Konfiguration und werden standardmäßig aktiviert, wenn die Anwendung für Push-Benachrichtigungen aktiviert wird. + +Unicast-Benachrichtigungen an spezifische Benutzer erfordern zum Zeitpunkt der Registrierung des mobilen Clientgeräts oder Web-Browsers oder von Chrome-Apps und Erweiterungen bei {{site.data.keyword.mobilepushshort}} die Zuordnung einer Benutzer-ID zum Gerät. + +Normalerweise führt eine Clientanwendung zuerst einen Authentifizierungszyklus aus, bei dem der Benutzer der mobilen App bei einem Authentifizierungsservice wie [Mobile Client Access](docs/services/mobileaccess/index.html) authentifiziert wird. Nach der erfolgreichen Authentifizierung wird die ID des authentifizierten Benutzers dann an die API für Push-Geräteregistrierungen übergeben. +Zum Senden einer Unicast-Benachrichtigung über die REST-API müssen Sie sicherstellen, dass während der Übergabe an die Ressource der Nachricht die Geräte- oder Benutzer-IDs ('deviceId' bzw. 'userId') angegeben werden. + +###Plattformbasierte Benachrichtigungen +{: platform-based-notifications} + +Benachrichtigungen können zielgruppenspezifisch an eine bestimmte Geräteplattform gerichtet werden. Eine Benachrichtigung kann beispielsweise nur an alle Android-Benutzer oder an alle Google Chrome-Benutzer gesendet werden. Stellen Sie zum Senden einer plattformbasierten Benachrichtigung mithilfe der REST-API sicher, dass die Zielplattformen während der Übergabe an eine Nachrichtenressource bereitgestellt werden. Geben Sie die Plattformen als Array an. Folgende Plattformen werden unterstützt: +* A (Apple) +* G (Google) +* WEB_CHROME (Google Chrome-Browser Web Push) +* WEB_FIREFOX (Mozilla Firefox-Browser Web Push) +* WEB_SAFARI (Safari-Browser Web Push) +* APPEXT_CHROME (Google Chrome-Apps & Erweiterungen) + +## Größe von {{site.data.keyword.mobilepushshort}}-Nachrichten +{: #push-message-size} + +Die Größe der {{site.data.keyword.mobilepushshort}}-Nachrichtennutzdaten hängt von den Einschränkungen ab, die durch die Gateways (FCM/GCM, APNs) und Clientplattformen festgelegt sind. + +### iOS und Safari +{: ios-message-size} + +Ab iOS 8 beträgt die zulässige maximale Größe 2 Kilobyte. Der Push Notification-Service für Apple sendet keine Benachrichtigungen, die dieses Limit überschreiten. + +###Android, Firefox-Browser, Chrome-Browser und Chrome Apps & Erweiterungen +{: android-message-size} + +Es gibt eine Einschränkung von 4 Kilobyte als maximal zulässige Nachrichtennutzdatengröße. diff --git a/services/mobilepush/nl/de/c_rich_media_notifications.md b/services/mobilepush/nl/de/c_rich_media_notifications.md index 22514cb95..9e80bff14 100644 --- a/services/mobilepush/nl/de/c_rich_media_notifications.md +++ b/services/mobilepush/nl/de/c_rich_media_notifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Rich Media-Benachrichtigungen aktivieren -{: #interactive-notifications} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - - -Sie können Rich Media {{site.data.keyword.mobilepushshort}} iOS 10 und höher aktivieren. Push-Benachrichtigungen können mit Audio, Video, GIFs und Bildern gesendet werden. - -Führen Sie die folgenden Schritte aus, um Ihre Anwendungen unter iOS 10 für den Empfang von Rich Push-Benachrichtigungen einzurichten: - -1. Wählen Sie in Xcode **File** > **New** > **Target** > **Notification Service Extension** aus. -2. Fügen Sie in der Methode `didReceive()` in `UNNotificationServiceExtension` den folgenden Code hinzu. -``` -BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) -``` - -Geben Sie zum Senden einer Rich Media-Push-Benachrichtigung über das Push-Dashboard unbedingt Daten in die Felder für Nachricht, Titel, Untertitel und attachmentURL ein. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Rich Media-Benachrichtigungen aktivieren +{: #interactive-notifications} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + + +Sie können Rich Media {{site.data.keyword.mobilepushshort}} iOS 10 und höher aktivieren. Push-Benachrichtigungen können mit Audio, Video, GIFs und Bildern gesendet werden. + +Führen Sie die folgenden Schritte aus, um Ihre Anwendungen unter iOS 10 für den Empfang von Rich Push-Benachrichtigungen einzurichten: + +1. Wählen Sie in Xcode **File** > **New** > **Target** > **Notification Service Extension** aus. +2. Fügen Sie in der Methode `didReceive()` in `UNNotificationServiceExtension` den folgenden Code hinzu. +``` +BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) +``` + +Geben Sie zum Senden einer Rich Media-Push-Benachrichtigung über das Push-Dashboard unbedingt Daten in die Felder für Nachricht, Titel, Untertitel und attachmentURL ein. diff --git a/services/mobilepush/nl/de/c_tag_basednotifications.md b/services/mobilepush/nl/de/c_tag_basednotifications.md index 9a4996ddc..8bb528d41 100644 --- a/services/mobilepush/nl/de/c_tag_basednotifications.md +++ b/services/mobilepush/nl/de/c_tag_basednotifications.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Tagbasierte Benachrichtigungen aktivieren -{: #tag_based_notifications} -Letzte Aktualisierung: 16. Januar 2017 -{: .last-updated} - -Tagbasierte Benachrichtigungen haben alle diejenigen Geräte zum Ziel, die einen bestimmten Tag subskribiert haben. - -Sie können Tags definieren und anschließend mithilfe der Tags Nachrichten senden und empfangen. Sie müssen zunächst die Tags für die Anwendung erstellen, die Tagsubskriptionen einrichten und anschließend die tagbasierten Benachrichtigungen starten. Zum Senden einer tagbasierten Benachrichtigung mithilfe der [REST-API](https://mobile.{DomainName}/imfpush/){: new_window} müssen Sie sicherstellen, dass bei der Übergabe an die Nachrichtenressource die Tagnamen ('tagNames') angegeben werden. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Tagbasierte Benachrichtigungen aktivieren +{: #tag_based_notifications} +Letzte Aktualisierung: 16. Januar 2017 +{: .last-updated} + +Tagbasierte Benachrichtigungen haben alle diejenigen Geräte zum Ziel, die einen bestimmten Tag subskribiert haben. + +Sie können Tags definieren und anschließend mithilfe der Tags Nachrichten senden und empfangen. Sie müssen zunächst die Tags für die Anwendung erstellen, die Tagsubskriptionen einrichten und anschließend die tagbasierten Benachrichtigungen starten. Zum Senden einer tagbasierten Benachrichtigung mithilfe der [REST-API](https://mobile.{DomainName}/imfpush/){: new_window} müssen Sie sicherstellen, dass bei der Übergabe an die Nachrichtenressource die Tagnamen ('tagNames') angegeben werden. diff --git a/services/mobilepush/nl/de/c_user_basednotifications.md b/services/mobilepush/nl/de/c_user_basednotifications.md index 03125cafb..b5140d029 100644 --- a/services/mobilepush/nl/de/c_user_basednotifications.md +++ b/services/mobilepush/nl/de/c_user_basednotifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Benutzerbasierte Benachrichtigungen aktivieren -{: #user_based_notifications} -Letzte Aktualisierung: 16. Januar 2017 -{: .last-updated} - -Auf Benutzer-ID basierte Push-Benachrichtigungen zielen mit angepassten Nachrichten auf Benutzer mobiler Apps ab. Bei benutzerbasierten Benachrichtigungen können Sie auswählen, dass bestimmte Personen auf Grundlage Ihrer Vorgaben benachrichtigt werden. - -## Gerät mit Benutzer-ID registrieren -Um Push-Benachrichtigungen zu aktivieren, die auf einer Benutzer-ID basieren, müssen Sie sicherstellen, dass Sie das Gerät mit einer Benutzer-ID registrieren. - -Die Benutzer-ID kann eine beliebige Zeichenfolge sein, die die Anwendung gegenüber der API für die Geräteregistrierung bereitstellt. Normalerweise führt eine mobile Anwendung zuerst einen Authentifizierungszyklus aus, in dessen Verlauf der Benutzer mobiler Apps bei einem Authentifizierungsservice wie [{{site.data.keyword.amafull}} ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window} authentifiziert wird. Nach der erfolgreichen Authentifizierung wird die ID des authentifizierten Benutzers dann an die API für Push-Geräteregistrierungen übergeben. - -## Benutzeranmeldung/-abmeldung synchronisieren - -Sie können festlegen, dass Benachrichtigungen nur gesendet werden, wenn der Benutzer angemeldet ist. - -Beispiel: Ein Gerät wird von mehreren Familienmitgliedern oder Teammitgliedern an der Arbeit gemeinsam genutzt und es müssen bestimmte Benutzer angesprochen werden. In einem derartigen Anwendungsfall würde eine entsprechende Benutzeranmelde- und -abmeldesequenz zum Einsatz kommen. Dieser Authentifizierungsmechanismus ermöglicht es der Anwendung, die Identität des aktuellen Benutzer der Anwendung zu ermitteln. So wird sichergestellt, dass Benachrichtigungen, die einen bestimmten Benutzer zum Ziel haben, auch stets nur von diesem Benutzer empfangen werden. Rufen Sie nach einer erfolgreichen Anmeldung die API für die Geräteregistrierung auf, indem Sie die Benutzer-ID des angemeldeten Benutzers übergeben. Ebenso müssen Sie vor dem Abmelden die API für die Rücknahme der Registrierung aufrufen. Durch die Reihenfolgeplanung für diese Push-APIs in Verbindung mit der An- und Abmeldung wird sichergestellt, dass Benachrichtigungen für einen bestimmten Benutzer wirklich nur an diesen Benutzer gesendet werden. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Benutzerbasierte Benachrichtigungen aktivieren +{: #user_based_notifications} +Letzte Aktualisierung: 16. Januar 2017 +{: .last-updated} + +Auf Benutzer-ID basierte Push-Benachrichtigungen zielen mit angepassten Nachrichten auf Benutzer mobiler Apps ab. Bei benutzerbasierten Benachrichtigungen können Sie auswählen, dass bestimmte Personen auf Grundlage Ihrer Vorgaben benachrichtigt werden. + +## Gerät mit Benutzer-ID registrieren +Um Push-Benachrichtigungen zu aktivieren, die auf einer Benutzer-ID basieren, müssen Sie sicherstellen, dass Sie das Gerät mit einer Benutzer-ID registrieren. + +Die Benutzer-ID kann eine beliebige Zeichenfolge sein, die die Anwendung gegenüber der API für die Geräteregistrierung bereitstellt. Normalerweise führt eine mobile Anwendung zuerst einen Authentifizierungszyklus aus, in dessen Verlauf der Benutzer mobiler Apps bei einem Authentifizierungsservice wie [{{site.data.keyword.amafull}} ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window} authentifiziert wird. Nach der erfolgreichen Authentifizierung wird die ID des authentifizierten Benutzers dann an die API für Push-Geräteregistrierungen übergeben. + +## Benutzeranmeldung/-abmeldung synchronisieren + +Sie können festlegen, dass Benachrichtigungen nur gesendet werden, wenn der Benutzer angemeldet ist. + +Beispiel: Ein Gerät wird von mehreren Familienmitgliedern oder Teammitgliedern an der Arbeit gemeinsam genutzt und es müssen bestimmte Benutzer angesprochen werden. In einem derartigen Anwendungsfall würde eine entsprechende Benutzeranmelde- und -abmeldesequenz zum Einsatz kommen. Dieser Authentifizierungsmechanismus ermöglicht es der Anwendung, die Identität des aktuellen Benutzer der Anwendung zu ermitteln. So wird sichergestellt, dass Benachrichtigungen, die einen bestimmten Benutzer zum Ziel haben, auch stets nur von diesem Benutzer empfangen werden. Rufen Sie nach einer erfolgreichen Anmeldung die API für die Geräteregistrierung auf, indem Sie die Benutzer-ID des angemeldeten Benutzers übergeben. Ebenso müssen Sie vor dem Abmelden die API für die Rücknahme der Registrierung aufrufen. Durch die Reihenfolgeplanung für diese Push-APIs in Verbindung mit der An- und Abmeldung wird sichergestellt, dass Benachrichtigungen für einen bestimmten Benutzer wirklich nur an diesen Benutzer gesendet werden. diff --git a/services/mobilepush/nl/de/c_web_extensions.md b/services/mobilepush/nl/de/c_web_extensions.md index 800239546..3e4b12ee3 100644 --- a/services/mobilepush/nl/de/c_web_extensions.md +++ b/services/mobilepush/nl/de/c_web_extensions.md @@ -1,107 +1,107 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Chrome-Apps und Erweiterungen für den Empfang von {{site.data.keyword.mobilepushshort}} aktivieren -{: #web_notifications} -Letzte Aktualisierung: 18. Januar 2017 -{: .last-updated} - -Sie können Google Chrome-Apps und Erweiterungen für den Empfang von {{site.data.keyword.mobilepushshort}} aktivieren. Stellen Sie sicher, dass die im Abschnitt [Berechtigungsnachweise für einen Benachrichtigungsprovider konfigurieren](t__main_push_config_provider.html) angegebenen Schritte durchgeführt wurden. - -## Client-SDK für {{site.data.keyword.mobilepushshort}} installieren -{: #web_install} - -In diesem Thema wird die Vorgehensweise zum Installieren und Verwenden des Client-JavaScript-Push-SDK für die weitere Entwicklung Ihrer Chrome-Apps und Erweiterungen beschrieben. - -### Initialisierung in Google Chrome-Apps und Erweiterungen - -Führen Sie folgende Schritte für die Installation des Javascript-SDK in Chrome-Apps und Erweiterungen aus: - -Laden Sie `BMSPushSDK.js` und `manifest_Chrome_Ext.json` (für Chrome-Erweiterungen) oder `manifest_Chrome_App.json` (für Chrome-Apps) vom [Bluemix-Web-Push-SDK ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window} herunter. - - - -- Für Chrome-Apps konfigurieren Sie die Manifestdatei: - 1. Geben Sie in der Datei `manifest_Chrome_App.json` den Namen, die Beschreibung und die Symbole an. - 2. Fügen Sie die Datei `BMSPushSDK.js` in den `app.background.scripts` hinzu. - 3. Ändern Sie die Datei `manifest_Chrome_App.json` in `manifest.json`. - -- Für Chrome-Erweiterungen konfigurieren Sie die Manifestdatei: - 1. Geben Sie in der Datei `manifest_Chrome_Ext.json` den Namen, die Beschreibung und die Symbole an. - 2. Fügen Sie die Datei `BMSPushSDK.js` in den `background.scripts` hinzu. - 3. Ändern Sie die Datei `manifest_Chrome_Ext.json` in `manifest.json`. - -Fügen Sie in der Datei `background.js` Folgendes hinzu, um Push-Benachrichtigungen empfangen zu können. -``` -chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) -chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); -chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); -``` - {: codeblock} - - - -## Push-SDK initialisieren -{: #web_initialize} - -Initialisieren Sie das Push-SDK mit den Bluemix {{site.data.keyword.mobilepushshort}}-Services `app GUID` und `app Region`. - -Zum Abrufen Ihrer App-GUID wählen Sie die Option **Konfiguration** für Ihre initialisierten Push-Services im Navigationsbereich aus und klicken auf **Mobile Systemerweiterungen**. Ändern Sie das Code-Snippet so, dass Ihre Parameter für die appGUID des Push Notifications Service von Bluemix verwendet werden. - -Die `App Region` gibt den Standort an, an dem der {{site.data.keyword.mobilepushshort}}-Service gehostet ist. Sie können einen der folgenden drei Werte verwendet: - - - Für USA Dallas: `.ng.bluemix.net` - - Für Großbritannien: `.eu-gb.bluemix.net` - - Für Sydney: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) -``` - {: codeblock} - -## Chrome-Apps und Erweiterungen registrieren -{: #web_register} - -Verwenden Sie die API `register()`, um das Gerät beim {{site.data.keyword.mobilepushshort}}-Service zu registrieren. Für die Registrierung von Google Chrome aus fügen Sie den API-Schlüssel für Firebase Cloud Messaging (FCM) bzw. Google Cloud Messaging (GCM) sowie die URL der Website im Bluemix-Dashboard für die Webkonfiguration des {{site.data.keyword.mobilepushshort}}-Service hinzu. Weitere Informationen finden Sie im Abschnitt [Berechtigungsnachweise für Google Cloud Messaging (GCM) konfigurieren](t_push_provider_android.html) unter dem Thema Chrome-Konfiguration. - -Für die Registrierung von Mozilla Firefox fügen Sie die URL der Website im Dashboard für die Webkonfiguration von Bluemix {{site.data.keyword.mobilepushshort}}-Service unter der Firefox-Konfiguration hinzu. - -Verwenden Sie folgendes Code-Snippet, um sich beim Bluemix {{site.data.keyword.mobilepushshort}}-Service zu registrieren. -``` -var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Chrome-Apps und Erweiterungen für den Empfang von {{site.data.keyword.mobilepushshort}} aktivieren +{: #web_notifications} +Letzte Aktualisierung: 18. Januar 2017 +{: .last-updated} + +Sie können Google Chrome-Apps und Erweiterungen für den Empfang von {{site.data.keyword.mobilepushshort}} aktivieren. Stellen Sie sicher, dass die im Abschnitt [Berechtigungsnachweise für einen Benachrichtigungsprovider konfigurieren](t__main_push_config_provider.html) angegebenen Schritte durchgeführt wurden. + +## Client-SDK für {{site.data.keyword.mobilepushshort}} installieren +{: #web_install} + +In diesem Thema wird die Vorgehensweise zum Installieren und Verwenden des Client-JavaScript-Push-SDK für die weitere Entwicklung Ihrer Chrome-Apps und Erweiterungen beschrieben. + +### Initialisierung in Google Chrome-Apps und Erweiterungen + +Führen Sie folgende Schritte für die Installation des Javascript-SDK in Chrome-Apps und Erweiterungen aus: + +Laden Sie `BMSPushSDK.js` und `manifest_Chrome_Ext.json` (für Chrome-Erweiterungen) oder `manifest_Chrome_App.json` (für Chrome-Apps) vom [Bluemix-Web-Push-SDK ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window} herunter. + + + +- Für Chrome-Apps konfigurieren Sie die Manifestdatei: + 1. Geben Sie in der Datei `manifest_Chrome_App.json` den Namen, die Beschreibung und die Symbole an. + 2. Fügen Sie die Datei `BMSPushSDK.js` in den `app.background.scripts` hinzu. + 3. Ändern Sie die Datei `manifest_Chrome_App.json` in `manifest.json`. + +- Für Chrome-Erweiterungen konfigurieren Sie die Manifestdatei: + 1. Geben Sie in der Datei `manifest_Chrome_Ext.json` den Namen, die Beschreibung und die Symbole an. + 2. Fügen Sie die Datei `BMSPushSDK.js` in den `background.scripts` hinzu. + 3. Ändern Sie die Datei `manifest_Chrome_Ext.json` in `manifest.json`. + +Fügen Sie in der Datei `background.js` Folgendes hinzu, um Push-Benachrichtigungen empfangen zu können. +``` +chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) +chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); +chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); +``` + {: codeblock} + + + +## Push-SDK initialisieren +{: #web_initialize} + +Initialisieren Sie das Push-SDK mit den Bluemix {{site.data.keyword.mobilepushshort}}-Services `app GUID` und `app Region`. + +Zum Abrufen Ihrer App-GUID wählen Sie die Option **Konfiguration** für Ihre initialisierten Push-Services im Navigationsbereich aus und klicken auf **Mobile Systemerweiterungen**. Ändern Sie das Code-Snippet so, dass Ihre Parameter für die appGUID des Push Notifications Service von Bluemix verwendet werden. + +Die `App Region` gibt den Standort an, an dem der {{site.data.keyword.mobilepushshort}}-Service gehostet ist. Sie können einen der folgenden drei Werte verwendet: + + - Für USA Dallas: `.ng.bluemix.net` + - Für Großbritannien: `.eu-gb.bluemix.net` + - Für Sydney: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) +``` + {: codeblock} + +## Chrome-Apps und Erweiterungen registrieren +{: #web_register} + +Verwenden Sie die API `register()`, um das Gerät beim {{site.data.keyword.mobilepushshort}}-Service zu registrieren. Für die Registrierung von Google Chrome aus fügen Sie den API-Schlüssel für Firebase Cloud Messaging (FCM) bzw. Google Cloud Messaging (GCM) sowie die URL der Website im Bluemix-Dashboard für die Webkonfiguration des {{site.data.keyword.mobilepushshort}}-Service hinzu. Weitere Informationen finden Sie im Abschnitt [Berechtigungsnachweise für Google Cloud Messaging (GCM) konfigurieren](t_push_provider_android.html) unter dem Thema Chrome-Konfiguration. + +Für die Registrierung von Mozilla Firefox fügen Sie die URL der Website im Dashboard für die Webkonfiguration von Bluemix {{site.data.keyword.mobilepushshort}}-Service unter der Firefox-Konfiguration hinzu. + +Verwenden Sie folgendes Code-Snippet, um sich beim Bluemix {{site.data.keyword.mobilepushshort}}-Service zu registrieren. +``` +var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + diff --git a/services/mobilepush/nl/de/c_web_extensions_send.md b/services/mobilepush/nl/de/c_web_extensions_send.md index 7618c1c05..68ab39215 100644 --- a/services/mobilepush/nl/de/c_web_extensions_send.md +++ b/services/mobilepush/nl/de/c_web_extensions_send.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Einfache Benachrichtigungen an Chrome Apps and Extensions senden -{: #web_extensions_notifications} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - -Nach dem Entwickeln Ihrer Anwendungen können Sie Push-Benachrichtigungen senden. - -1. Wählen Sie **Benachrichtigungen senden** aus und erstellen Sie eine Nachricht, indem Sie **Webbenachrichtigungen** als Option für **Senden an** auswählen. -2. Geben Sie im Feld **Nachricht** die Nachricht an, die gesendet werden soll. -3. Sie können auswählen, optionale Einstellungen anzugeben: - - **Benachrichtigungstitel**: Dies ist der Text, der als Kopfzeile des Nachrichtenalerts angezeigt würde. - - **URL des Benachrichtigungssymbols**: Falls Ihre Nachricht mit einem App-Benachrichtigungssymbol gesendet werden muss, stellen Sie den Link zu Ihrem Symbol in dem Feld zur Verfügung. - - **Collapse key** (Schlüssel ausblenden): Ausgeblendete Schlüssel sind den Benachrichtigungen angehängt. Wenn mehrere Benachrichtigungen nacheinander mit demselben ausgeblendeten Schlüssel eintreffen, während das Gerät offline ist, werden die Benachrichtigungen ausgeblendet. Wenn ein Gerät wieder online ist, empfängt es Benachrichtigungen vom FCM/GCM-Server und zeigt nur die aktuellste Benachrichtigung an, die denselben ausgeblendeten Schlüssel aufweist. Falls der ausgeblendete Schlüssel nicht definiert ist, werden sowohl die neuen als auch die alten Nachrichten für die künftige Bereitstellung gespeichert. - - **Time to live** (Lebensdauer): Dieser Wert wird in Sekunden angegeben. Falls dieser Parameter nicht angegeben ist, speichert der FCM/GCM-Server die Nachricht für vier Wochen und versucht, diese zu übermitteln. Die Gültigkeit läuft nach vier Wochen ab. Der mögliche Wertebereich liegt zwischen 0 und 2.419.200 Sekunden. - - **Delay when idle**: (Verzögerung bei Inaktivität): Durch das Festlegen dieses Werts auf `true` wird der FCM/GCM-Server angewiesen, die Benachrichtigung nicht auszuliefern, wenn das Gerät inaktiv ist. Legen Sie für diesen Wert `false` fest, um die Übermittlung der Benachrichtigung sicherzustellen, auch wenn das Gerät inaktiv ist. - - **Additional payload** (Zusätzliche Nutzdaten): Gibt die angepassten Werte für Nutzdaten für Ihre Benachrichtigungen an. - -Die folgende Abbildung zeigt die Chrome Apps and Extensions-Benachrichtigungsoptionen im Dashboard an. - - ![Anzeige 'Benachrichtigungen'](images/push_chrome_extns.jpg) - -## Nächste Schritte - {: #next_steps_tags} - -Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. - -Fügen Sie diese Funktionen des {{site.data.keyword.mobilepushshort}}-Service Ihrer App hinzu. Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). Informationen zur Verwendung erweiterter Benachrichtigungsoptionen finden Sie in [Erweiterte Benachrichtigungen](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Einfache Benachrichtigungen an Chrome Apps and Extensions senden +{: #web_extensions_notifications} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + +Nach dem Entwickeln Ihrer Anwendungen können Sie Push-Benachrichtigungen senden. + +1. Wählen Sie **Benachrichtigungen senden** aus und erstellen Sie eine Nachricht, indem Sie **Webbenachrichtigungen** als Option für **Senden an** auswählen. +2. Geben Sie im Feld **Nachricht** die Nachricht an, die gesendet werden soll. +3. Sie können auswählen, optionale Einstellungen anzugeben: + - **Benachrichtigungstitel**: Dies ist der Text, der als Kopfzeile des Nachrichtenalerts angezeigt würde. + - **URL des Benachrichtigungssymbols**: Falls Ihre Nachricht mit einem App-Benachrichtigungssymbol gesendet werden muss, stellen Sie den Link zu Ihrem Symbol in dem Feld zur Verfügung. + - **Collapse key** (Schlüssel ausblenden): Ausgeblendete Schlüssel sind den Benachrichtigungen angehängt. Wenn mehrere Benachrichtigungen nacheinander mit demselben ausgeblendeten Schlüssel eintreffen, während das Gerät offline ist, werden die Benachrichtigungen ausgeblendet. Wenn ein Gerät wieder online ist, empfängt es Benachrichtigungen vom FCM/GCM-Server und zeigt nur die aktuellste Benachrichtigung an, die denselben ausgeblendeten Schlüssel aufweist. Falls der ausgeblendete Schlüssel nicht definiert ist, werden sowohl die neuen als auch die alten Nachrichten für die künftige Bereitstellung gespeichert. + - **Time to live** (Lebensdauer): Dieser Wert wird in Sekunden angegeben. Falls dieser Parameter nicht angegeben ist, speichert der FCM/GCM-Server die Nachricht für vier Wochen und versucht, diese zu übermitteln. Die Gültigkeit läuft nach vier Wochen ab. Der mögliche Wertebereich liegt zwischen 0 und 2.419.200 Sekunden. + - **Delay when idle**: (Verzögerung bei Inaktivität): Durch das Festlegen dieses Werts auf `true` wird der FCM/GCM-Server angewiesen, die Benachrichtigung nicht auszuliefern, wenn das Gerät inaktiv ist. Legen Sie für diesen Wert `false` fest, um die Übermittlung der Benachrichtigung sicherzustellen, auch wenn das Gerät inaktiv ist. + - **Additional payload** (Zusätzliche Nutzdaten): Gibt die angepassten Werte für Nutzdaten für Ihre Benachrichtigungen an. + +Die folgende Abbildung zeigt die Chrome Apps and Extensions-Benachrichtigungsoptionen im Dashboard an. + + ![Anzeige 'Benachrichtigungen'](images/push_chrome_extns.jpg) + +## Nächste Schritte + {: #next_steps_tags} + +Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. + +Fügen Sie diese Funktionen des {{site.data.keyword.mobilepushshort}}-Service Ihrer App hinzu. Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). Informationen zur Verwendung erweiterter Benachrichtigungsoptionen finden Sie in [Erweiterte Benachrichtigungen](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/de/images/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/de/images/t_enable_actionable_notifications_ios.md index bb5e3112b..a365f2a00 100644 --- a/services/mobilepush/nl/de/images/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/de/images/t_enable_actionable_notifications_ios.md @@ -1,103 +1,103 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Umsetzbare Benachrichtigungen für iOS aktivieren -{: #enable-actionable-notifications-ios} - -Im Unterschied zu konventionellen Push-Benachrichtigungen werden Benutzer bei umsetzbaren Benachrichtigungen dazu aufgefordert, bei Erhalt der Benachrichtigungsalerts eine Auswahl zu treffen, ohne die App zu öffnen. Gehen Sie nach den folgenden Anweisungen vor, um umsetzbare Push-Benachrichtigungen in Ihrer Anwendung zu aktivieren. - -1. Erstellen Sie eine Benutzeraktion. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. Erstellen Sie die Benachrichtigungskategorie und legen Sie eine Aktion fest. Gültige Kontexte sind **UIUserNotificationActionContextDefault** oder **UIUserNotificationActionContextMinimal**. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. Erstellen Sie die Benachrichtigungseinstellung und weisen Sie die Kategorien aus dem vorherigen Schritt zu. - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. Erstellen Sie die lokale oder ferne Benachrichtigung und weisen Sie ihr die Identität der Kategorie zu. - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Umsetzbare Benachrichtigungen für iOS aktivieren +{: #enable-actionable-notifications-ios} + +Im Unterschied zu konventionellen Push-Benachrichtigungen werden Benutzer bei umsetzbaren Benachrichtigungen dazu aufgefordert, bei Erhalt der Benachrichtigungsalerts eine Auswahl zu treffen, ohne die App zu öffnen. Gehen Sie nach den folgenden Anweisungen vor, um umsetzbare Push-Benachrichtigungen in Ihrer Anwendung zu aktivieren. + +1. Erstellen Sie eine Benutzeraktion. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. Erstellen Sie die Benachrichtigungskategorie und legen Sie eine Aktion fest. Gültige Kontexte sind **UIUserNotificationActionContextDefault** oder **UIUserNotificationActionContextMinimal**. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. Erstellen Sie die Benachrichtigungseinstellung und weisen Sie die Kategorien aus dem vorherigen Schritt zu. + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. Erstellen Sie die lokale oder ferne Benachrichtigung und weisen Sie ihr die Identität der Kategorie zu. + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/de/index.md b/services/mobilepush/nl/de/index.md index f91e8e16f..90993d00f 100644 --- a/services/mobilepush/nl/de/index.md +++ b/services/mobilepush/nl/de/index.md @@ -1,54 +1,54 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Einführung in {{site.data.keyword.mobilepushshort}} -{: #gettingstartedtemplate} -Letzte Aktualisierung: 19. Januar 2017 -{: .last-updated} - -{:shortdesc} - -{{site.data.keyword.mobilepushshort}} ist als Bluemix Catalog-Service in der Kategorie 'Mobile' verfügbar und ermöglicht das Senden und Verwalten von Push-Benachrichtigungen im Web und für mobile Endgeräte. Dieser Service verwaltet die Zuordnung Ihrer Anwendungsbenutzer zu den zugehörigen Geräten, zur Geräteplattform und zu Web-Browsern und verarbeitet das Senden von Benachrichtigungen an die Benutzer. - - {{site.data.keyword.mobilepushshort}} ist als Teil von MobileFirst Services Starter Boilerplate und in [Dedizierte Services](/docs/dedicated/index.html) von Bluemix verfügbar. Mit diesem Service können Sie Rundsendungen und Unicasts (auf der Basis von 'deviceID' und 'userID') sowie tagbasierte Benachrichtigung, ereignisgesteuerte Webhook-Benachrichtigung und Rich Media-Benachrichtigungen sowie interaktive Benachrichtigungen an Ihre Benutzer mobiler Anwendungen und Web-Browser-Anwendungen senden. Sie können auch ein SDK (Software-Development-Kit) und [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} verwenden, um Ihre Clientanwendungen weiter zu entwickeln. - -Darüber hinaus stellt der Service hilfreiche Funktionen zur Unterstützung der Leistungsüberwachung für Push-Benachrichtigungen bereit (z. B. das Generieren von Grafiken und Berichten aus Ihren Benutzerdaten). Siehe [Überwachung für Push-Benachrichtigungen](/docs/services/mobilepush/t_push_monitoring.html). - -Der {{site.data.keyword.mobilepushshort}}-Service wird jetzt auf den folgenden Plattformen unterstützt: - -- [Mobile Geräte mit iOS und Android](/docs/services/mobilepush/c_enable_push.html) -- [Google Chrome-, Mozilla Firefox- und Safari-Web-Browser](/docs/services/mobilepush/c_chrome_firefox_enable.html) -- [Google Chrome-Apps und Erweiterungen](/docs/services/mobilepush/c_web_extensions.html) - - -# Zugehörige Links -{: #rellinks} - -* [Übersicht ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](c_overview_push.html){: new_window} - -## Lernprogramme und Beispiele {:id="samples"} -{: #samples} -* [Android-Beispielanwendung 'helloPush' ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} -- [Cordova-Beispielanwendung ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} -* [iOS-Beispielanwendung 'helloPush' (Swift) ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} - -## Software-Development-Kit (SDK) -{: #sdk} -* [Android-SDK ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} -* [Cordova-SDK ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} -* [iOS-SDK (Swift) ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} - -## API-Referenz -{: #api} -* [Push-API-Referenz (Android) ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} -* [BMSPush-API-Referenz für iOS (Swift) ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} -* [REST-API-Referenz ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Einführung in {{site.data.keyword.mobilepushshort}} +{: #gettingstartedtemplate} +Letzte Aktualisierung: 19. Januar 2017 +{: .last-updated} + +{:shortdesc} + +{{site.data.keyword.mobilepushshort}} ist als Bluemix Catalog-Service in der Kategorie 'Mobile' verfügbar und ermöglicht das Senden und Verwalten von Push-Benachrichtigungen im Web und für mobile Endgeräte. Dieser Service verwaltet die Zuordnung Ihrer Anwendungsbenutzer zu den zugehörigen Geräten, zur Geräteplattform und zu Web-Browsern und verarbeitet das Senden von Benachrichtigungen an die Benutzer. + + {{site.data.keyword.mobilepushshort}} ist als Teil von MobileFirst Services Starter Boilerplate und in [Dedizierte Services](/docs/dedicated/index.html) von Bluemix verfügbar. Mit diesem Service können Sie Rundsendungen und Unicasts (auf der Basis von 'deviceID' und 'userID') sowie tagbasierte Benachrichtigung, ereignisgesteuerte Webhook-Benachrichtigung und Rich Media-Benachrichtigungen sowie interaktive Benachrichtigungen an Ihre Benutzer mobiler Anwendungen und Web-Browser-Anwendungen senden. Sie können auch ein SDK (Software-Development-Kit) und [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} verwenden, um Ihre Clientanwendungen weiter zu entwickeln. + +Darüber hinaus stellt der Service hilfreiche Funktionen zur Unterstützung der Leistungsüberwachung für Push-Benachrichtigungen bereit (z. B. das Generieren von Grafiken und Berichten aus Ihren Benutzerdaten). Siehe [Überwachung für Push-Benachrichtigungen](/docs/services/mobilepush/t_push_monitoring.html). + +Der {{site.data.keyword.mobilepushshort}}-Service wird jetzt auf den folgenden Plattformen unterstützt: + +- [Mobile Geräte mit iOS und Android](/docs/services/mobilepush/c_enable_push.html) +- [Google Chrome-, Mozilla Firefox- und Safari-Web-Browser](/docs/services/mobilepush/c_chrome_firefox_enable.html) +- [Google Chrome-Apps und Erweiterungen](/docs/services/mobilepush/c_web_extensions.html) + + +# Zugehörige Links +{: #rellinks} + +* [Übersicht ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](c_overview_push.html){: new_window} + +## Lernprogramme und Beispiele {:id="samples"} +{: #samples} +* [Android-Beispielanwendung 'helloPush' ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} +- [Cordova-Beispielanwendung ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} +* [iOS-Beispielanwendung 'helloPush' (Swift) ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} + +## Software-Development-Kit (SDK) +{: #sdk} +* [Android-SDK ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} +* [Cordova-SDK ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} +* [iOS-SDK (Swift) ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} + +## API-Referenz +{: #api} +* [Push-API-Referenz (Android) ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} +* [BMSPush-API-Referenz für iOS (Swift) ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} +* [REST-API-Referenz ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} diff --git a/services/mobilepush/nl/de/interactive_notifications.md b/services/mobilepush/nl/de/interactive_notifications.md index aaa204fbc..a42919086 100644 --- a/services/mobilepush/nl/de/interactive_notifications.md +++ b/services/mobilepush/nl/de/interactive_notifications.md @@ -1,83 +1,83 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Interaktive Benachrichtigungen -{: #interactive-notifications} -Letzte Aktualisierung: 23. Januar 2017 -{: .last-updated} - -Interaktive Benachrichtigungen ermöglichen den Benutzern das Beantworten einer Benachrichtigung, ohne die Anwendung zu öffnen. Wenn eine interaktive Benachrichtigung eingeht, zeigt das Gerät die Aktionsschaltflächen zusammen mit der Benachrichtigung an. Interaktive Benachrichtigungen werden für iOS-Geräte mit Version 8 oder einer neueren Version unterstützt. Wenn interaktive Benachrichtigungen an iOS-Geräte gesendet werden, die mit einer älteren Version als Version 8 ausgeführt werden, werden die Benachrichtigungsaktionen nicht angezeigt. - -##Interaktive Push-Benachrichtigungen senden - - -Interaktive Benachrichtigungen können über das Push-Dashboard oder mithilfe der REST-API (siehe [REST-API-Dokumentation](t_restapi.html)) gesendet werden. - -Gehen Sie in der {{site.data.keyword.mobilepushshort}}-Konsole wie folgt vor: - -1. Klicken Sie auf der Registerkarte 'Benachrichtigungen' im Push-Dashboard auf **Benachrichtigung senden**. -2. Wählen Sie die Benachrichtigungsempfänger aus und klicken Sie auf **Weiter**. -3. Auf der Seite für die Benachrichtigungserstellung können Sie beim Senden von interaktiven Push-Benachrichtigungen den Typ 'Standard' oder 'Gemischt' festlegen und auf der Registerkarte mit den erweiterten Optionen den Kategoriewert angeben. Informationen zum Konfigurieren des Kategoriewerts auf dem Client finden Sie im Abschnitt zur Verarbeitung interaktiver Push-Benachrichtigungen in nativen iOS-Anwendungen. - -## Interaktive Push-Benachrichtigungen in einer iOS-Anwendung verarbeiten - - -### Swift - -Führen Sie die folgenden Schritte aus, um interaktive Benachrichtigungen zu erhalten: - -1. Aktivieren Sie die Anwendungsfunktion zum Durchführen von Hintergrundtasks beim Empfang der fernen Benachrichtigungen. -1. Initialisieren Sie das `BMSPush`-SDK mit Ihrer Aktionskategorie. - ``` - let myBMSClient = BMSClient.sharedInstance - myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) - let push = BMSPushClient.sharedInstance - let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) - let notifOptions = BMSPushClientOptions(categoryName: [category]) - push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) - ``` - {: codeblock} - -1. Implementieren Sie die neue Callback-Methode in AppDelegate: - ``` - func userNotificationCenter(_ center: UNUserNotificationCenter, - didReceive response: UNNotificationResponse, - withCompletionHandler completionHandler: @escaping () -> Void) { - switch response.actionIdentifier { - case "FIRST": - print("FIRST") - case "SECOND": - print("SECOND") - default: - print("Unknown action") - } - completionHandler - } - ``` - {: codeblock} -5. Diese neue Callback-Methode wird aufgerufen, wenn der Benutzer auf die Aktionsschaltfläche klickt. Die Implementierung dieser Methode muss die Aufgaben durchführen, die der angegebenen ID zugeordnet sind, und den Block im Parameter `completionHandler` ausführen. - - -### Cordova - -Führen Sie die folgenden Schritte aus, um umsetzbare Benachrichtigungen in einer Cordova-iOS-Anwendung zu empfangen: - -1. Fügen Sie das Kategoriefeld in der Methode `BMSPush.initialize` hinzu. - ``` - var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} - BMSPush.initialize(appGUID,clientSecret,category); - ``` - {: codeblock} -2. Implementieren Sie die neue Callback-Methode in AppDelegate. -3. Diese neue Callback-Methode wird aufgerufen, wenn der Benutzer auf die Aktionsschaltfläche klickt. Die Implementierung dieser Methode muss die Aufgaben durchführen, die der angegebenen ID zugeordnet sind, und den Block im Parameter 'completionHandler' ausführen. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Interaktive Benachrichtigungen +{: #interactive-notifications} +Letzte Aktualisierung: 23. Januar 2017 +{: .last-updated} + +Interaktive Benachrichtigungen ermöglichen den Benutzern das Beantworten einer Benachrichtigung, ohne die Anwendung zu öffnen. Wenn eine interaktive Benachrichtigung eingeht, zeigt das Gerät die Aktionsschaltflächen zusammen mit der Benachrichtigung an. Interaktive Benachrichtigungen werden für iOS-Geräte mit Version 8 oder einer neueren Version unterstützt. Wenn interaktive Benachrichtigungen an iOS-Geräte gesendet werden, die mit einer älteren Version als Version 8 ausgeführt werden, werden die Benachrichtigungsaktionen nicht angezeigt. + +## Interaktive Push-Benachrichtigungen senden + + +Interaktive Benachrichtigungen können über das Push-Dashboard oder mithilfe der REST-API (siehe [REST-API-Dokumentation](t_restapi.html)) gesendet werden. + +Gehen Sie in der {{site.data.keyword.mobilepushshort}}-Konsole wie folgt vor: + +1. Klicken Sie auf der Registerkarte 'Benachrichtigungen' im Push-Dashboard auf **Benachrichtigung senden**. +2. Wählen Sie die Benachrichtigungsempfänger aus und klicken Sie auf **Weiter**. +3. Auf der Seite für die Benachrichtigungserstellung können Sie beim Senden von interaktiven Push-Benachrichtigungen den Typ 'Standard' oder 'Gemischt' festlegen und auf der Registerkarte mit den erweiterten Optionen den Kategoriewert angeben. Informationen zum Konfigurieren des Kategoriewerts auf dem Client finden Sie im Abschnitt zur Verarbeitung interaktiver Push-Benachrichtigungen in nativen iOS-Anwendungen. + +## Interaktive Push-Benachrichtigungen in einer iOS-Anwendung verarbeiten + + +### Swift + +Führen Sie die folgenden Schritte aus, um interaktive Benachrichtigungen zu erhalten: + +1. Aktivieren Sie die Anwendungsfunktion zum Durchführen von Hintergrundtasks beim Empfang der fernen Benachrichtigungen. +1. Initialisieren Sie das `BMSPush`-SDK mit Ihrer Aktionskategorie. + ``` + let myBMSClient = BMSClient.sharedInstance + myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) + let push = BMSPushClient.sharedInstance + let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) + let notifOptions = BMSPushClientOptions(categoryName: [category]) + push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) + ``` + {: codeblock} + +1. Implementieren Sie die neue Callback-Methode in AppDelegate: + ``` + func userNotificationCenter(_ center: UNUserNotificationCenter, + didReceive response: UNNotificationResponse, + withCompletionHandler completionHandler: @escaping () -> Void) { + switch response.actionIdentifier { + case "FIRST": + print("FIRST") + case "SECOND": + print("SECOND") + default: + print("Unknown action") + } + completionHandler + } + ``` + {: codeblock} +5. Diese neue Callback-Methode wird aufgerufen, wenn der Benutzer auf die Aktionsschaltfläche klickt. Die Implementierung dieser Methode muss die Aufgaben durchführen, die der angegebenen ID zugeordnet sind, und den Block im Parameter `completionHandler` ausführen. + + +### Cordova + +Führen Sie die folgenden Schritte aus, um umsetzbare Benachrichtigungen in einer Cordova-iOS-Anwendung zu empfangen: + +1. Fügen Sie das Kategoriefeld in der Methode `BMSPush.initialize` hinzu. + ``` + var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} + BMSPush.initialize(appGUID,clientSecret,category); + ``` + {: codeblock} +2. Implementieren Sie die neue Callback-Methode in AppDelegate. +3. Diese neue Callback-Methode wird aufgerufen, wenn der Benutzer auf die Aktionsschaltfläche klickt. Die Implementierung dieser Methode muss die Aufgaben durchführen, die der angegebenen ID zugeordnet sind, und den Block im Parameter 'completionHandler' ausführen. diff --git a/services/mobilepush/nl/de/next_steps_tags.md b/services/mobilepush/nl/de/next_steps_tags.md index 2d1b0f3d5..61d35d3ac 100644 --- a/services/mobilepush/nl/de/next_steps_tags.md +++ b/services/mobilepush/nl/de/next_steps_tags.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Nächste Schritte -{: #next_steps_tags} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - -Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. - -Fügen Sie diese Funktionen des {{site.data.keyword.mobilepushshort}}-Service Ihrer App hinzu. -Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). -Informationen zur Verwendung erweiterter Benachrichtigungen finden Sie in [Erweiterte Push-Benachrichtigungen](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Nächste Schritte +{: #next_steps_tags} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + +Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. + +Fügen Sie diese Funktionen des {{site.data.keyword.mobilepushshort}}-Service Ihrer App hinzu. +Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). +Informationen zur Verwendung erweiterter Benachrichtigungen finden Sie in [Erweiterte Push-Benachrichtigungen](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/de/silent_notifications.md b/services/mobilepush/nl/de/silent_notifications.md index 390f931fb..fddeae247 100644 --- a/services/mobilepush/nl/de/silent_notifications.md +++ b/services/mobilepush/nl/de/silent_notifications.md @@ -1,39 +1,39 @@ ------- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Hintergrundbenachrichtigungen für iOS verarbeiten -{: #silent-notifications} -Letzte Aktualisierung: 16. Januar 2017 -{: .last-updated} - -Hintergrundbenachrichtigungen werden nicht auf dem Gerät angezeigt. Diese Benachrichtigungen werden von der Anwendung im Hintergrund empfangen; dadurch wird die Anwendung für maximal 30 Sekunden aktiviert, um die angegebene Hintergrundtask auszuführen. Der Eingang der Benachrichtigung wird vom Benutzer möglicherweise nicht bemerkt. Verwenden Sie zum Senden von Hintergrundbenachrichtigungen für iOS die [REST-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window}. - -1. Wenn Sie Push-Hintergrundbenachrichtigungen senden möchten, implementieren Sie die folgende Methode in der Datei `appDelegate.m` in Ihrem Projekt. In Swift ist der Wert für `contentAvailable` , der vom Server für Hintergrundbenachrichtigungen gesendet wird, gleich 1. -``` -// For Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - let contentAPS = userInfo["aps"] as [NSObject : AnyObject] - if let contentAvailable = contentAPS["content-available"] as? Int { - //silent or mixed push - if contentAvailable == 1 { - completionHandler(UIBackgroundFetchResult.NewData) - } else { - completionHandler(UIBackgroundFetchResult.NoData) - } - } else { - //Default notification - completionHandler(UIBackgroundFetchResult.NoData) - } - } -``` - {: codeblock} - +------ + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Hintergrundbenachrichtigungen für iOS verarbeiten +{: #silent-notifications} +Letzte Aktualisierung: 16. Januar 2017 +{: .last-updated} + +Hintergrundbenachrichtigungen werden nicht auf dem Gerät angezeigt. Diese Benachrichtigungen werden von der Anwendung im Hintergrund empfangen; dadurch wird die Anwendung für maximal 30 Sekunden aktiviert, um die angegebene Hintergrundtask auszuführen. Der Eingang der Benachrichtigung wird vom Benutzer möglicherweise nicht bemerkt. Verwenden Sie zum Senden von Hintergrundbenachrichtigungen für iOS die [REST-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window}. + +1. Wenn Sie Push-Hintergrundbenachrichtigungen senden möchten, implementieren Sie die folgende Methode in der Datei `appDelegate.m` in Ihrem Projekt. In Swift ist der Wert für `contentAvailable` , der vom Server für Hintergrundbenachrichtigungen gesendet wird, gleich 1. +``` +// For Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + let contentAPS = userInfo["aps"] as [NSObject : AnyObject] + if let contentAvailable = contentAPS["content-available"] as? Int { + //silent or mixed push + if contentAvailable == 1 { + completionHandler(UIBackgroundFetchResult.NewData) + } else { + completionHandler(UIBackgroundFetchResult.NoData) + } + } else { + //Default notification + completionHandler(UIBackgroundFetchResult.NoData) + } + } +``` + {: codeblock} + diff --git a/services/mobilepush/nl/de/t__main_push_config_provider.md b/services/mobilepush/nl/de/t__main_push_config_provider.md index 67773a84f..93592cd1e 100644 --- a/services/mobilepush/nl/de/t__main_push_config_provider.md +++ b/services/mobilepush/nl/de/t__main_push_config_provider.md @@ -1,21 +1,21 @@ - ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Berechtigungsnachweise für einen Benachrichtigungsprovider konfigurieren -{: #create-push-credentials} -Letzte Aktualisierung: 18. Januar 2017 -{: .last-updated} - -Rufen Sie die erforderlichen Berechtigungsnachweise zum Einrichten des {{site.data.keyword.mobilepushshort}}-Service bei Ihrem Push-Benachrichtigungsprovider für mobile Geräte, entweder Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) oder Apple Push Notification service ([APNs](t_push_provider_ios.html)), ab. Informationen zu Web-Browsern finden Sie im Abschnitt [Berechtigungsnachweise für Web-Browser konfigurieren](t_push_provider_safari.html). - -Sie können {{site.data.keyword.mobilepushshort}} entweder über das **IBM Bluemix Services**-Dashboard oder mithilfe der [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} einrichten. + +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Berechtigungsnachweise für einen Benachrichtigungsprovider konfigurieren +{: #create-push-credentials} +Letzte Aktualisierung: 18. Januar 2017 +{: .last-updated} + +Rufen Sie die erforderlichen Berechtigungsnachweise zum Einrichten des {{site.data.keyword.mobilepushshort}}-Service bei Ihrem Push-Benachrichtigungsprovider für mobile Geräte, entweder Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) oder Apple Push Notification service ([APNs](t_push_provider_ios.html)), ab. Informationen zu Web-Browsern finden Sie im Abschnitt [Berechtigungsnachweise für Web-Browser konfigurieren](t_push_provider_safari.html). + +Sie können {{site.data.keyword.mobilepushshort}} entweder über das **IBM Bluemix Services**-Dashboard oder mithilfe der [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} einrichten. diff --git a/services/mobilepush/nl/de/t_advance_badge_sound_payload.md b/services/mobilepush/nl/de/t_advance_badge_sound_payload.md index ed8379163..f65662363 100644 --- a/services/mobilepush/nl/de/t_advance_badge_sound_payload.md +++ b/services/mobilepush/nl/de/t_advance_badge_sound_payload.md @@ -1,77 +1,77 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#Erweitertes {{site.data.keyword.mobilepushshort}} aktivieren -Letzte Aktualisierung: 23. Januar 2017 -{: .last-updated} - -Konfigurieren Sie ein iOS Badge, zusätzliche JSON-Nutzdaten, umsetzbare Benachrichtigungen und Blockierungsnachrichten. - -## Audio, Nutzdaten und iOS Badge konfigurieren -{: #badge-sound-payload} - -Konfigurieren Sie ein iOS Badge, eine Audiodatei und zusätzliche JSON-Nutzdaten. - -1. Navigieren Sie im Dashboard für Push-Benachrichtigungen zur Registerkarte **Benachrichtigungen**. -2. Konfigurieren Sie im Abschnitt **Optionale Felder** die folgenden Komponenten für Push-Benachrichtigungen. - - **Sound File** (Audiodatei) - Geben Sie eine Zeichenfolge ein, die auf die Audiodatei in Ihrer mobilen App verweist. Geben Sie den Zeichenfolgenamen der zu verwendenden Audiodatei in den Nutzdaten an. - - **iOS Badge**: Für iOS-Geräte die Nummer, die als Badge für das App-Symbol angezeigt werden soll. Wenn diese Eigenschaft fehlt, wird das Badge nicht geändert. Um das Badge zu entfernen, legen Sie für diese Eigenschaft den Wert 0 fest. - -###Android - -Fügen Sie die Audiodatei zum Verzeichnis `res/raw` der Android-Anwendung hinzu. Fügen Sie beim Senden einer Benachrichtigung den Namen der Audiodatei zum entsprechenden Feld für {{site.data.keyword.mobilepushshort}} hinzu. - -``` -"settings": { - "gcm" : { - "sound":"tt.wav", - } - } -``` - {: codeblock} - -###iOS - -``` -"settings": { - "apns" : { - "badge": 10, - "sound": "tt.wav", - } -} -``` - {: codeblock} - -**Zusätzliche Nutzdaten** - Diese Nutzdaten können ein beliebiges Schlüssel/Wert-Paar sein; es muss sich jedoch um ein JSON-Objekt handeln, das Sie mit der Push-Benachrichtigung senden möchten. - -``` -{"key":"value", "key2":"value2"} -``` - {: codeblock} - -## Android-Benachrichtigungen blockieren -{: #hold-notifications-android} - -Wenn Ihre Anwendung in den Hintergrund wechselt, ist es möglicherweise wünschenswert, dass {{site.data.keyword.mobilepushshort}} solche Benachrichtigungen vorübergehend blockiert, die an Ihre Anwendung gesendet wurden. Rufen Sie zum Blockieren von Benachrichtigungen die Methode 'hold()' in der Methode 'onPause()' der Aktivität auf, die Push-Benachrichtigungen verarbeitet. - -``` -@Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Erweitertes {{site.data.keyword.mobilepushshort}} aktivieren +Letzte Aktualisierung: 23. Januar 2017 +{: .last-updated} + +Konfigurieren Sie ein iOS Badge, zusätzliche JSON-Nutzdaten, umsetzbare Benachrichtigungen und Blockierungsnachrichten. + +## Audio, Nutzdaten und iOS Badge konfigurieren +{: #badge-sound-payload} + +Konfigurieren Sie ein iOS Badge, eine Audiodatei und zusätzliche JSON-Nutzdaten. + +1. Navigieren Sie im Dashboard für Push-Benachrichtigungen zur Registerkarte **Benachrichtigungen**. +2. Konfigurieren Sie im Abschnitt **Optionale Felder** die folgenden Komponenten für Push-Benachrichtigungen. + - **Sound File** (Audiodatei) - Geben Sie eine Zeichenfolge ein, die auf die Audiodatei in Ihrer mobilen App verweist. Geben Sie den Zeichenfolgenamen der zu verwendenden Audiodatei in den Nutzdaten an. + - **iOS Badge**: Für iOS-Geräte die Nummer, die als Badge für das App-Symbol angezeigt werden soll. Wenn diese Eigenschaft fehlt, wird das Badge nicht geändert. Um das Badge zu entfernen, legen Sie für diese Eigenschaft den Wert 0 fest. + +### Android + +Fügen Sie die Audiodatei zum Verzeichnis `res/raw` der Android-Anwendung hinzu. Fügen Sie beim Senden einer Benachrichtigung den Namen der Audiodatei zum entsprechenden Feld für {{site.data.keyword.mobilepushshort}} hinzu. + +``` +"settings": { + "gcm" : { + "sound":"tt.wav", + } + } +``` + {: codeblock} + +### iOS + +``` +"settings": { + "apns" : { + "badge": 10, + "sound": "tt.wav", + } +} +``` + {: codeblock} + +**Zusätzliche Nutzdaten** - Diese Nutzdaten können ein beliebiges Schlüssel/Wert-Paar sein; es muss sich jedoch um ein JSON-Objekt handeln, das Sie mit der Push-Benachrichtigung senden möchten. + +``` +{"key":"value", "key2":"value2"} +``` + {: codeblock} + +## Android-Benachrichtigungen blockieren +{: #hold-notifications-android} + +Wenn Ihre Anwendung in den Hintergrund wechselt, ist es möglicherweise wünschenswert, dass {{site.data.keyword.mobilepushshort}} solche Benachrichtigungen vorübergehend blockiert, die an Ihre Anwendung gesendet wurden. Rufen Sie zum Blockieren von Benachrichtigungen die Methode 'hold()' in der Methode 'onPause()' der Aktivität auf, die Push-Benachrichtigungen verarbeitet. + +``` +@Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} + + diff --git a/services/mobilepush/nl/de/t_android_create_unbound_service.md b/services/mobilepush/nl/de/t_android_create_unbound_service.md index 4aa882448..b217408a9 100644 --- a/services/mobilepush/nl/de/t_android_create_unbound_service.md +++ b/services/mobilepush/nl/de/t_android_create_unbound_service.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Nicht gebundenen {{site.data.keyword.mobilepushshort}}-Service für Android erstellen -{: #create_android_unbound} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - -Erstellen Sie eine Instanz des {{site.data.keyword.mobilepushshort}}-Service. Sie können die Instanz des {{site.data.keyword.mobilepushshort}}-Service ohne Bindung an jegliche Back-End-Anwendung verwenden. - -1. Binden Sie die Instanz des {{site.data.keyword.mobilepushshort}}-Service an eine Bluemix-Anwendung. Durch das Binden werden alle Details im Zusammenhang mit dem Service, die in JSON-Format in der Umgebungsvariablen 'VCAP_SERVICES' gespeichert sind, sichtbar. - -![Binden eines Service für Push-Benachrichtigungen](images/unbound_1.jpg) - 2. Klicken Sie auf **Binden** und wählen Sie die Instanz des {{site.data.keyword.mobilepushshort}}-Service aus, die gebunden werden soll. Nachdem Ihre Anwendung an den {{site.data.keyword.mobilepushshort}}-Service gebunden worden ist, werden Informationen zum Service im JSON-Format in der Umgebungsvariablen 'VCAP_SERVICES' für Ihre App gespeichert. Beispiel: -``` - { - "imfpush_Dev": [ - { - "name": "myname_sampleUnbound", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": null - } - ] - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Nicht gebundenen {{site.data.keyword.mobilepushshort}}-Service für Android erstellen +{: #create_android_unbound} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + +Erstellen Sie eine Instanz des {{site.data.keyword.mobilepushshort}}-Service. Sie können die Instanz des {{site.data.keyword.mobilepushshort}}-Service ohne Bindung an jegliche Back-End-Anwendung verwenden. + +1. Binden Sie die Instanz des {{site.data.keyword.mobilepushshort}}-Service an eine Bluemix-Anwendung. Durch das Binden werden alle Details im Zusammenhang mit dem Service, die in JSON-Format in der Umgebungsvariablen 'VCAP_SERVICES' gespeichert sind, sichtbar. + +![Binden eines Service für Push-Benachrichtigungen](images/unbound_1.jpg) + 2. Klicken Sie auf **Binden** und wählen Sie die Instanz des {{site.data.keyword.mobilepushshort}}-Service aus, die gebunden werden soll. Nachdem Ihre Anwendung an den {{site.data.keyword.mobilepushshort}}-Service gebunden worden ist, werden Informationen zum Service im JSON-Format in der Umgebungsvariablen 'VCAP_SERVICES' für Ihre App gespeichert. Beispiel: +``` + { + "imfpush_Dev": [ + { + "name": "myname_sampleUnbound", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": null + } + ] + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/de/t_android_initialize.md b/services/mobilepush/nl/de/t_android_initialize.md index c7c888bc0..f820cfaca 100644 --- a/services/mobilepush/nl/de/t_android_initialize.md +++ b/services/mobilepush/nl/de/t_android_initialize.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Push-SDK für Android-Apps initialisieren -{: #android_initialize} - -Die Methode 'onCreate' der Hauptaktivität in Ihrer Android-Anwendung ist eine übliche Position für den Initialisierungscode. - -Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um -die Anwendungsroute und die Anwendungs-GUID abzurufen. Verwenden Sie diese Werte für Ihre Route und App-GUID. Ändern Sie das Code-Snippet so, dass die Parameter 'appRoute' und 'appGUID' der Bluemix-App verwendet werden. - - -##Core-SDK initialisieren - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -Gibt die Route an, die der Serveranwendung zugewiesen ist, die Sie in Bluemix erstellt haben. - -**AppGUID** - -Gibt den eindeutigen Schlüssel an, der der Anwendung zugewiesen wird, die Sie in Bluemix erstellt haben. Bei diesem Wert muss die Groß-/Kleinschreibung beachtet werden. - -**bluemixRegionSuffix** - -Gibt den Standort an, an dem die App gehostet ist. Sie können einen von drei Werten verwenden: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##Client-Push-SDK initialisieren - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Push-SDK für Android-Apps initialisieren +{: #android_initialize} + +Die Methode 'onCreate' der Hauptaktivität in Ihrer Android-Anwendung ist eine übliche Position für den Initialisierungscode. + +Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um +die Anwendungsroute und die Anwendungs-GUID abzurufen. Verwenden Sie diese Werte für Ihre Route und App-GUID. Ändern Sie das Code-Snippet so, dass die Parameter 'appRoute' und 'appGUID' der Bluemix-App verwendet werden. + + +## Core-SDK initialisieren + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +Gibt die Route an, die der Serveranwendung zugewiesen ist, die Sie in Bluemix erstellt haben. + +**AppGUID** + +Gibt den eindeutigen Schlüssel an, der der Anwendung zugewiesen wird, die Sie in Bluemix erstellt haben. Bei diesem Wert muss die Groß-/Kleinschreibung beachtet werden. + +**bluemixRegionSuffix** + +Gibt den Standort an, an dem die App gehostet ist. Sie können einen von drei Werten verwenden: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +## Client-Push-SDK initialisieren + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` diff --git a/services/mobilepush/nl/de/t_android_install_sdk.md b/services/mobilepush/nl/de/t_android_install_sdk.md index 4ac6ab665..f57dba8bc 100644 --- a/services/mobilepush/nl/de/t_android_install_sdk.md +++ b/services/mobilepush/nl/de/t_android_install_sdk.md @@ -1,223 +1,223 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Client-Push-SDK mit Gradle installieren -{: #android_install} - -In diesem Abschnitt wird die Vorgehensweise zum Installieren und Verwenden des Client-Push-SDK für die weitere Entwicklung Ihrer Android-Anwendungen beschrieben. - -Das Push-SDK für mobile Bluemix®-Services kann mithilfe von Gradle hinzugefügt werden. Gradle lädt automatisch Artefakte aus Repositorys herunter und stellt Sie in Ihrer Android-Anwendung zur Verfügung. Stellen Sie sicher, dass Sie Android Studio und das Android Studio-SDK ordnungsgemäß einrichten. Weitere Informationen zum Einrichten Ihres Systems finden Sie unter [Android Studio Overview](https://developer.android.com/tools/studio/index.html). Informationen zu Gradle finden Sie in [Configuring Gradle Builds](http://developer.android.com/tools/building/configuring-gradle.html). - -1. Öffnen Sie in Android Studio nach dem Erstellen und Öffnen der mobilen Anwendung die Anwendungsdatei **build.gradle**. Fügen Sie dann die folgenden Abhängigkeiten zu Ihrer mobilen Anwendung hinzu. Diese Importanweisungen sind für die folgenden Code-Snippets erforderlich: - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - - -1. Fügen Sie die folgenden Abhängigkeiten zu Ihrer mobilen Anwendung hinzu. Mit den folgenden -Zeilen wird das Push-Client-SDK von Bluemix™ Mobile Services und das Google Play Services-SDK zu Ihren Abhängigkeiten für den Kompilierungsbereich hinzugefügt. - - ``` - dependencies { - compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' - compile 'com.google.android.gms:play-services:7.8.0' - } - ``` -1. Fügen Sie die folgenden Berechtigungen in der Datei **AndroidManifest.xml** hinzu. Ein Beispielmanifest -finden Sie in [Android helloPush Sample Application](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml). Eine Gradle-Beispieldatei finden Sie unter [Sample Build Gradle file](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle). - - ``` - - - - - - - - - ``` - - Weitere Informationen zu Android-Berechtigungen finden Sie [hier](http://developer.android.com/guide/topics/security/permissions.html). - -1. Fügen Sie die Einstellungen für die Benachrichtigungsabsicht für die Aktivität hinzu. Mit dieser Einstellung wird die Anwendung gestartet, wenn der Benutzer im Benachrichtigungsbereich auf die empfangene Benachrichtigung klickt. - - ``` - - - - - ``` - **Hinweis**: Ersetzen Sie *Your_Android_Package_Name* in der obigen Aktion durch den Namen des Anwendungspakets, der in Ihrer Anwendung verwendet wird. - -1. Fügen Sie den Absichtsservice und Absichtsfilter von Google Cloud Messaging (GCM) für die Ereignisbenachrichtigungen des Typs RECEIVE hinzu. - - ``` - service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> - - - - - - - - - - - - - - ``` - - - -# Push-SDK für Android-Apps initialisieren -{: #android_initialize} - -Die Methode 'onCreate' der Hauptaktivität in Ihrer Android-Anwendung ist eine übliche Position für den Initialisierungscode. - -Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um -die Anwendungsroute und die Anwendungs-GUID abzurufen. Verwenden Sie diese Werte für Ihre Route und App-GUID. Ändern Sie das Code-Snippet so, dass die Parameter 'appRoute' und 'appGUID' der Bluemix-App verwendet werden. - - -##Core-SDK initialisieren - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -Gibt die Route an, die der Serveranwendung zugewiesen ist, die Sie in Bluemix erstellt haben. - -**AppGUID** - -Gibt den eindeutigen Schlüssel an, der der Anwendung zugewiesen wird, die Sie in Bluemix erstellt haben. Bei diesem Wert muss die Groß-/Kleinschreibung beachtet werden. - -**bluemixRegionSuffix** - -Gibt den Standort an, an dem die App gehostet ist. Sie können einen von drei Werten verwenden: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##Client-Push-SDK initialisieren - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` - - - -# Android-Geräte registrieren -{: #android_register} - -Verwenden Sie die API `IMFPush.register()`, um das Gerät beim Service 'Push Notifications' zu registrieren. Für die Registrierung bei Android-Geräten müssen Sie zunächst die GCM-Angaben (Google Cloud Messaging) im Bluemix-Dashboard für die Konfiguration des Push-Service hinzufügen. Weitere Informationen finden Sie im Abschnitt zur [Konfiguration von Berechtigungsnachweisen für Google Cloud Messaging](t_push_provider_android.html). - -Kopieren Sie die folgenden Code-Snippets und fügen Sie sie in Ihre mobile Android-Anwendung ein. - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` - - - -# Push-Benachrichtigungen in Android-Geräten empfangen -{: #android_receive} - -Rufen Sie die Methode **MFPPush.listen()** auf, um das Objekt 'notificationListener' für Push zu registrieren. Diese Methode wird in der Regel über die Methode **onResume()** der Aktivität aufgerufen, die Push-Benachrichtigungen verarbeitet. - -1. Rufen Sie die Methode **listen()** auf, um das Objekt 'notificationListener' für Push zu registrieren. Diese Methode wird in der Regel über die Methode **onResume()** der Aktivität aufgerufen, die Push-Benachrichtigungen verarbeitet. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } - ``` -2. Erstellen Sie einen Build für das Projekt und führen Sie ihn in dem Gerät oder im Emulator aus. Wenn die Methode -onSuccess() für den Antwortlistener in der Methode register() aufgerufen wird, wird bestätigt, dass das Gerät erfolgreich für Push Notifications Service registriert wurde. An diesem Punkt können Sie gemäß der in 'Einfache Push-Benachrichtigungen senden' beschriebenen Anleitung eine Nachricht senden. -3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. Wenn die Anwendung im Vordergrund ausgeführt wird, wird die Benachrichtigung von **MFPPushNotificationListener** verarbeitet. Wenn die Anwendung im Hintergrund ausgeführt wird, wird eine Nachricht in der Benachrichtigungsleiste angezeigt. - - - - -# Einfache Push-Benachrichtigungen senden - -{: #push-send-notifications} - -Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen (ohne Tags, Badges, zusätzliche Nutzdaten oder Audiodateien) senden. - - -Einfache Push-Benachrichtigungen senden - -1. Wählen Sie unter **Zielgruppe auswählen** eine der folgenden Zielgruppen aus: -**Alle Geräte** oder die Plattform **Nur iOS-Geräte** oder -**Nur Android-Geräte**. - - **Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Ihre Benachrichtigung. - - ![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) - -2. Geben Sie in das Feld **Eigene Benachrichtigung erstellen** Ihre Nachricht ein und klicken Sie dann auf **Senden**. -3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. - - Der folgende Screenshot zeigt ein Alertfeld bei der Verarbeitung einer Push-Benachrichtigung -im Vordergrund auf einem Android- und auf einem iOS-Gerät. - - ![Push-Benachrichtigung im Vordergrund auf einem Android-Gerät](images/Android_Screenshot.jpg) - - ![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) - - Der folgende Screenshot zeigt eine Push-Benachrichtigung im Hintergrund auf einem Android-Gerät. - ![Push-Benachrichtigung im Hintergrund auf einem Android-Gerät](images/background.jpg) - - - -# Nächste Schritte -{: #next_steps_tags} - -Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. - -Fügen Sie diese Funktionen des Push Notifications-Service Ihrer App hinzu. -Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). -Informationen zur Verwendung erweiterter Benachrichtigungen finden Sie in [Erweiterte Push-Benachrichtigungen](t_advance_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Client-Push-SDK mit Gradle installieren +{: #android_install} + +In diesem Abschnitt wird die Vorgehensweise zum Installieren und Verwenden des Client-Push-SDK für die weitere Entwicklung Ihrer Android-Anwendungen beschrieben. + +Das Push-SDK für mobile Bluemix®-Services kann mithilfe von Gradle hinzugefügt werden. Gradle lädt automatisch Artefakte aus Repositorys herunter und stellt Sie in Ihrer Android-Anwendung zur Verfügung. Stellen Sie sicher, dass Sie Android Studio und das Android Studio-SDK ordnungsgemäß einrichten. Weitere Informationen zum Einrichten Ihres Systems finden Sie unter [Android Studio Overview](https://developer.android.com/tools/studio/index.html). Informationen zu Gradle finden Sie in [Configuring Gradle Builds](http://developer.android.com/tools/building/configuring-gradle.html). + +1. Öffnen Sie in Android Studio nach dem Erstellen und Öffnen der mobilen Anwendung die Anwendungsdatei **build.gradle**. Fügen Sie dann die folgenden Abhängigkeiten zu Ihrer mobilen Anwendung hinzu. Diese Importanweisungen sind für die folgenden Code-Snippets erforderlich: + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + + +1. Fügen Sie die folgenden Abhängigkeiten zu Ihrer mobilen Anwendung hinzu. Mit den folgenden +Zeilen wird das Push-Client-SDK von Bluemix™ Mobile Services und das Google Play Services-SDK zu Ihren Abhängigkeiten für den Kompilierungsbereich hinzugefügt. + + ``` + dependencies { + compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' + compile 'com.google.android.gms:play-services:7.8.0' + } + ``` +1. Fügen Sie die folgenden Berechtigungen in der Datei **AndroidManifest.xml** hinzu. Ein Beispielmanifest +finden Sie in [Android helloPush Sample Application](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml). Eine Gradle-Beispieldatei finden Sie unter [Sample Build Gradle file](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle). + + ``` + + + + + + + + + ``` + + Weitere Informationen zu Android-Berechtigungen finden Sie [hier](http://developer.android.com/guide/topics/security/permissions.html). + +1. Fügen Sie die Einstellungen für die Benachrichtigungsabsicht für die Aktivität hinzu. Mit dieser Einstellung wird die Anwendung gestartet, wenn der Benutzer im Benachrichtigungsbereich auf die empfangene Benachrichtigung klickt. + + ``` + + + + + ``` + **Hinweis**: Ersetzen Sie *Your_Android_Package_Name* in der obigen Aktion durch den Namen des Anwendungspakets, der in Ihrer Anwendung verwendet wird. + +1. Fügen Sie den Absichtsservice und Absichtsfilter von Google Cloud Messaging (GCM) für die Ereignisbenachrichtigungen des Typs RECEIVE hinzu. + + ``` + service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> + + + + + + + + + + + + + + ``` + + + +# Push-SDK für Android-Apps initialisieren +{: #android_initialize} + +Die Methode 'onCreate' der Hauptaktivität in Ihrer Android-Anwendung ist eine übliche Position für den Initialisierungscode. + +Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um +die Anwendungsroute und die Anwendungs-GUID abzurufen. Verwenden Sie diese Werte für Ihre Route und App-GUID. Ändern Sie das Code-Snippet so, dass die Parameter 'appRoute' und 'appGUID' der Bluemix-App verwendet werden. + + +##Core-SDK initialisieren + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +Gibt die Route an, die der Serveranwendung zugewiesen ist, die Sie in Bluemix erstellt haben. + +**AppGUID** + +Gibt den eindeutigen Schlüssel an, der der Anwendung zugewiesen wird, die Sie in Bluemix erstellt haben. Bei diesem Wert muss die Groß-/Kleinschreibung beachtet werden. + +**bluemixRegionSuffix** + +Gibt den Standort an, an dem die App gehostet ist. Sie können einen von drei Werten verwenden: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +##Client-Push-SDK initialisieren + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` + + + +# Android-Geräte registrieren +{: #android_register} + +Verwenden Sie die API `IMFPush.register()`, um das Gerät beim Service 'Push Notifications' zu registrieren. Für die Registrierung bei Android-Geräten müssen Sie zunächst die GCM-Angaben (Google Cloud Messaging) im Bluemix-Dashboard für die Konfiguration des Push-Service hinzufügen. Weitere Informationen finden Sie im Abschnitt zur [Konfiguration von Berechtigungsnachweisen für Google Cloud Messaging](t_push_provider_android.html). + +Kopieren Sie die folgenden Code-Snippets und fügen Sie sie in Ihre mobile Android-Anwendung ein. + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` + + + +# Push-Benachrichtigungen in Android-Geräten empfangen +{: #android_receive} + +Rufen Sie die Methode **MFPPush.listen()** auf, um das Objekt 'notificationListener' für Push zu registrieren. Diese Methode wird in der Regel über die Methode **onResume()** der Aktivität aufgerufen, die Push-Benachrichtigungen verarbeitet. + +1. Rufen Sie die Methode **listen()** auf, um das Objekt 'notificationListener' für Push zu registrieren. Diese Methode wird in der Regel über die Methode **onResume()** der Aktivität aufgerufen, die Push-Benachrichtigungen verarbeitet. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } + ``` +2. Erstellen Sie einen Build für das Projekt und führen Sie ihn in dem Gerät oder im Emulator aus. Wenn die Methode +onSuccess() für den Antwortlistener in der Methode register() aufgerufen wird, wird bestätigt, dass das Gerät erfolgreich für Push Notifications Service registriert wurde. An diesem Punkt können Sie gemäß der in 'Einfache Push-Benachrichtigungen senden' beschriebenen Anleitung eine Nachricht senden. +3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. Wenn die Anwendung im Vordergrund ausgeführt wird, wird die Benachrichtigung von **MFPPushNotificationListener** verarbeitet. Wenn die Anwendung im Hintergrund ausgeführt wird, wird eine Nachricht in der Benachrichtigungsleiste angezeigt. + + + + +# Einfache Push-Benachrichtigungen senden + +{: #push-send-notifications} + +Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen (ohne Tags, Badges, zusätzliche Nutzdaten oder Audiodateien) senden. + + +Einfache Push-Benachrichtigungen senden + +1. Wählen Sie unter **Zielgruppe auswählen** eine der folgenden Zielgruppen aus: +**Alle Geräte** oder die Plattform **Nur iOS-Geräte** oder +**Nur Android-Geräte**. + + **Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Ihre Benachrichtigung. + + ![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) + +2. Geben Sie in das Feld **Eigene Benachrichtigung erstellen** Ihre Nachricht ein und klicken Sie dann auf **Senden**. +3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. + + Der folgende Screenshot zeigt ein Alertfeld bei der Verarbeitung einer Push-Benachrichtigung +im Vordergrund auf einem Android- und auf einem iOS-Gerät. + + ![Push-Benachrichtigung im Vordergrund auf einem Android-Gerät](images/Android_Screenshot.jpg) + + ![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) + + Der folgende Screenshot zeigt eine Push-Benachrichtigung im Hintergrund auf einem Android-Gerät. + ![Push-Benachrichtigung im Hintergrund auf einem Android-Gerät](images/background.jpg) + + + +# Nächste Schritte +{: #next_steps_tags} + +Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. + +Fügen Sie diese Funktionen des Push Notifications-Service Ihrer App hinzu. +Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). +Informationen zur Verwendung erweiterter Benachrichtigungen finden Sie in [Erweiterte Push-Benachrichtigungen](t_advance_notifications.html). diff --git a/services/mobilepush/nl/de/t_android_receive.md b/services/mobilepush/nl/de/t_android_receive.md index fd346d9f4..89a6fabf1 100644 --- a/services/mobilepush/nl/de/t_android_receive.md +++ b/services/mobilepush/nl/de/t_android_receive.md @@ -1,27 +1,27 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Push-Benachrichtigungen in Android-Geräten empfangen -{: #android_receive} - -Rufen Sie die Methode **MFPPush.listen()** auf, um das Objekt 'notificationListener' für Push zu registrieren. Diese Methode wird in der Regel über die Methode **onResume()** der Aktivität aufgerufen, die Push-Benachrichtigungen verarbeitet. - -1. Rufen Sie die Methode **listen()** auf, um das Objekt 'notificationListener' für Push zu registrieren. Diese Methode wird in der Regel über die Methode **onResume()** der Aktivität aufgerufen, die Push-Benachrichtigungen verarbeitet. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` -2. Erstellen Sie einen Build für das Projekt und führen Sie ihn in dem Gerät oder im Emulator aus. Wenn die Methode -onSuccess() für den Antwortlistener in der Methode register() aufgerufen wird, wird bestätigt, dass das Gerät erfolgreich für Push Notifications Service registriert wurde. An diesem Punkt können Sie gemäß der in 'Einfache Push-Benachrichtigungen senden' beschriebenen Anleitung eine Nachricht senden. -3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. Wenn die Anwendung im Vordergrund -ausgeführt wird, wird die Benachrichtigung von **MFPPushNotificationListener** verarbeitet. Wenn die Anwendung im Hintergrund ausgeführt wird, wird eine Nachricht in der Benachrichtigungsleiste angezeigt. +--- + +copyright: + years: 2015, 2016 + +--- + +# Push-Benachrichtigungen in Android-Geräten empfangen +{: #android_receive} + +Rufen Sie die Methode **MFPPush.listen()** auf, um das Objekt 'notificationListener' für Push zu registrieren. Diese Methode wird in der Regel über die Methode **onResume()** der Aktivität aufgerufen, die Push-Benachrichtigungen verarbeitet. + +1. Rufen Sie die Methode **listen()** auf, um das Objekt 'notificationListener' für Push zu registrieren. Diese Methode wird in der Regel über die Methode **onResume()** der Aktivität aufgerufen, die Push-Benachrichtigungen verarbeitet. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` +2. Erstellen Sie einen Build für das Projekt und führen Sie ihn in dem Gerät oder im Emulator aus. Wenn die Methode +onSuccess() für den Antwortlistener in der Methode register() aufgerufen wird, wird bestätigt, dass das Gerät erfolgreich für Push Notifications Service registriert wurde. An diesem Punkt können Sie gemäß der in 'Einfache Push-Benachrichtigungen senden' beschriebenen Anleitung eine Nachricht senden. +3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. Wenn die Anwendung im Vordergrund +ausgeführt wird, wird die Benachrichtigung von **MFPPushNotificationListener** verarbeitet. Wenn die Anwendung im Hintergrund ausgeführt wird, wird eine Nachricht in der Benachrichtigungsleiste angezeigt. diff --git a/services/mobilepush/nl/de/t_android_register.md b/services/mobilepush/nl/de/t_android_register.md index fe2936f62..9ac88a068 100644 --- a/services/mobilepush/nl/de/t_android_register.md +++ b/services/mobilepush/nl/de/t_android_register.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Android-Geräte registrieren -{: #android_register} - -Verwenden Sie die API `IMFPush.register()`, um das Gerät beim Service 'Push Notifications' zu registrieren. Für die Registrierung bei Android-Geräten müssen Sie zunächst die GCM-Angaben (Google Cloud Messaging) im Bluemix-Dashboard für die Konfiguration des Push-Service hinzufügen. Weitere Informationen finden Sie im Abschnitt zur [Konfiguration von Berechtigungsnachweisen für Google Cloud Messaging](t_push_provider_android.html). - -Kopieren Sie die folgenden Code-Snippets und fügen Sie sie in Ihre mobile Android-Anwendung ein. - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Android-Geräte registrieren +{: #android_register} + +Verwenden Sie die API `IMFPush.register()`, um das Gerät beim Service 'Push Notifications' zu registrieren. Für die Registrierung bei Android-Geräten müssen Sie zunächst die GCM-Angaben (Google Cloud Messaging) im Bluemix-Dashboard für die Konfiguration des Push-Service hinzufügen. Weitere Informationen finden Sie im Abschnitt zur [Konfiguration von Berechtigungsnachweisen für Google Cloud Messaging](t_push_provider_android.html). + +Kopieren Sie die folgenden Code-Snippets und fügen Sie sie in Ihre mobile Android-Anwendung ein. + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` diff --git a/services/mobilepush/nl/de/t_cordova_initialize.md b/services/mobilepush/nl/de/t_cordova_initialize.md index 736f10817..f365fffab 100644 --- a/services/mobilepush/nl/de/t_cordova_initialize.md +++ b/services/mobilepush/nl/de/t_cordova_initialize.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} - -# Cordova-Plug-in -{: #cordova_enable} - -Bevor Sie das Cordova-Plug-in für Push Notifications Service verwenden können, müssen Sie -es initialisieren, indem Sie die Anwendungsroute und die Anwendungs-GUID übergeben. Nach der Initialisierung des -Plug-ins können Sie die Verbindung zu der Serveranwendung herstellen, die Sie im Bluemix-Dashboard -erstellt haben. Das Cordova-Plug-in ist die Oberfläche für die Android- und iOS-Client-SDKs zum Aktivieren einer Cordova-Anwendung für die Kommunikation mit Bluemix-Services. - -1. Initialisieren Sie 'BMSClient', indem Sie das folgende Code-Snippet kopieren und in Ihre Haupt-JavaScript-Datei (die für gewöhnlich im Verzeichnis **www/js** gespeichert ist) einfügen. - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Ändern Sie das Code-Snippet so, dass die Parameter für die Routen und Anwendungs-GUID von Bluemix verwendet werden. Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um -die Anwendungsroute und die App-GUID abzurufen. Verwenden Sie die Werte für die Route und die App-GUID als Parameter in Ihrem Code-Snippet des Typs `BMSClient.initialize`. - - - **Hinweis**: Wenn Sie beispielsweise mit der Cordova-CLI eine Cordova-App erstellt haben, erstellt Cordova den Befehl 'app-name', speichert diesen JavaScript-Code in der Datei **index.js** hinter der Funktion `app.receivedEvent` in der Funktion `onDeviceReady: function()` zum Initialisieren des BMS-Clients. - - ``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` -1. Nächster Schritt: [Geräte registrieren](t_cordova_register.html) +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} + +# Cordova-Plug-in +{: #cordova_enable} + +Bevor Sie das Cordova-Plug-in für Push Notifications Service verwenden können, müssen Sie +es initialisieren, indem Sie die Anwendungsroute und die Anwendungs-GUID übergeben. Nach der Initialisierung des +Plug-ins können Sie die Verbindung zu der Serveranwendung herstellen, die Sie im Bluemix-Dashboard +erstellt haben. Das Cordova-Plug-in ist die Oberfläche für die Android- und iOS-Client-SDKs zum Aktivieren einer Cordova-Anwendung für die Kommunikation mit Bluemix-Services. + +1. Initialisieren Sie 'BMSClient', indem Sie das folgende Code-Snippet kopieren und in Ihre Haupt-JavaScript-Datei (die für gewöhnlich im Verzeichnis **www/js** gespeichert ist) einfügen. + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Ändern Sie das Code-Snippet so, dass die Parameter für die Routen und Anwendungs-GUID von Bluemix verwendet werden. Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um +die Anwendungsroute und die App-GUID abzurufen. Verwenden Sie die Werte für die Route und die App-GUID als Parameter in Ihrem Code-Snippet des Typs `BMSClient.initialize`. + + + **Hinweis**: Wenn Sie beispielsweise mit der Cordova-CLI eine Cordova-App erstellt haben, erstellt Cordova den Befehl 'app-name', speichert diesen JavaScript-Code in der Datei **index.js** hinter der Funktion `app.receivedEvent` in der Funktion `onDeviceReady: function()` zum Initialisieren des BMS-Clients. + + ``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` +1. Nächster Schritt: [Geräte registrieren](t_cordova_register.html) diff --git a/services/mobilepush/nl/de/t_cordova_install.md b/services/mobilepush/nl/de/t_cordova_install.md index bfba08f26..59757c500 100644 --- a/services/mobilepush/nl/de/t_cordova_install.md +++ b/services/mobilepush/nl/de/t_cordova_install.md @@ -1,390 +1,390 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Cordova Push-Plug-in installieren -{: #cordova_install} - -Installieren und verwenden Sie das Client-Push-Plug-in für die weitere Entwicklung Ihrer Cordova-Anwendungen. Dabei wird auch das Cordova Core-Plug-in installiert, das Ihre Verbindung zu Bluemix initialisiert. - -### Vorbemerkungen - -1. Laden Sie die aktuelle Version für das Android Studio-SDK und Xcode herunter. -1. Richten Sie den Emulator ein. Verwenden Sie für Android Studio einen Emulator, der die Google Play-API unterstützt. -1. Installieren Sie das Git-Befehlszeilentool. Stellen Sie unter Windows sicher, dass Sie die Option zum Ausführen von Git über die Windows-Eingabeaufforderung auswählen. Informationen zum Herunterladen und Installieren dieses Tools finden Sie unter [Git](https://git-scm.com/downloads). - -1. Installieren Sie Node.js und das NPM-Tool (NPM = Node Package Manager). Das NPM-Befehlszeilentool wird als Produktpaket mit Node.js bereitgestellt. Informationen zum Herunterladen und Installieren von Node.js finden Sie unter [Node.js](https://nodejs.org/en/download/). -1. Installieren Sie über die Befehlszeile die Cordova-Befehlszeilentools mithilfe des Befehls **npm install -g cordova**. Dies ist eine Voraussetzung für die Verwendung -des Cordova-Plug-ins. Informationen zum Installieren von Cordova und zum Einrichten Ihrer Cordova-App finden Sie unter [Cordova Apache](https://cordova.apache.org/#getstarted). - - **Hinweis**: Die Readme-Datei für das Cordova Push-Plug-in finden Sie unter [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push). - - -## Cordova Push-Plug-in installieren -1. Wechseln Sie in den Ordner, in dem Sie Ihre Cordova-App erstellen möchten, und führen -Sie den folgenden Befehl aus, um eine Cordova-Anwendung zu erstellen. Wenn Sie bereits über eine -Cordova-App verfügen, fahren Sie mit Schritt 3 fort. - -``` -cordova create your_app_name - cd your_app_name -``` -1. Optional: Bearbeiten Sie die Datei **config.xml** und ersetzen Sie im Element den Standardnamen 'HelloCordova' durch einen eigenen Namen. - - **Hinweis**: Stellen Sie sicher, dass Sie die richtige Bundle-ID angeben. Falls Sie dies nicht tun, werden in Xcode die folgenden Fehlernachrichten angezeigt. - * The executable was signed with invalid entitlements (Die ausführbare Funktion ist mit ungültigen Berechtigungen signiert). - * The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile (Die in der Berechtigungsdatei für die Codeunterzeichnung Ihrer Anwendung angegebenen Berechtigungen stimmen nicht mit den angegebenen Berechtigungen in Ihrem Bereitstellungsprofil überein). - - Um dieses Problem zu beheben, geben Sie korrekte Bundle-ID in Xcode oder in der Datei **config.xml** Ihrer Cordova-App an. - -1. Fügen Sie die Mindestversion der unterstützten API oder die Bereitstellungszieldeklaration zur Datei 'config.xml' Ihrer Cordova-Anwendung hinzu: Der Wert für 'minSdkVersion' muss größer als 15 sein. Der Wert für 'targetSdkVersion' muss immer das neueste Android-SDK angeben, das bei Google verfügbar ist. - * **Android** - Öffnen Sie die Datei 'config.xml' mit dem Editor und aktualisieren Sie das Element -`` mit der SDK-Mindestversion und -Zielversion: - - ``` - - - - - - ``` - * **iOS**: Aktualisieren Sie das Element mit einer Bereitstellungszieldeklaration: - - ``` - - - - - ``` - -1. Fügen Sie über die Cordova-Befehlszeilenschnittstelle (CLI) mit einem oder beiden der folgenden Befehle Ihre Plattform (iOS und/oder Android) hinzu: - - ``` - cordova platform add ios@3.9.0 - cordova platform add android - ``` -1. Geben Sie im Stammverzeichnis Ihrer Cordova-Anwendung den folgenden Befehl ein, um das Cordova Push-Plug-in **cordova plugin add ibm-mfp-push** zu installieren. - - Je nachdem, welche Plattformen Sie hinzugefügt haben, sehen Sie eine Anzeige -ähnlich der folgenden: - - ``` - Installing "ibm-mfp-push" for android - Installing "ibm-mfp-push" for ios - ``` -1. Überprüfen Sie in *eigenes_app-stammverzeichnis* mit dem Befehl **cordova plugin list**, dass die Plug-ins Cordova Core und Cordova Push erfolgreich installiert wurden. - - Je nachdem, welche Plattformen Sie hinzugefügt haben, sehen Sie eine Anzeige -ähnlich der folgenden: - - ``` - ibm-mfp-core 1.0.0 "MFPCore" - ibm-mfp-push 1.0.0 “MFPPush" - ``` -1. (nur iOS): Konfigurieren Sie Ihre iOS-Entwicklungsumgebung. - a. Öffnen Sie die Datei 'ihr_app-name.xcodeproj' im Verzeichnis *ihr_app-name***/platforms/ios** mit Xcode. - - b. Fügen Sie den Bridging-Header hinzu. Rufen Sie **Build settings > Swift Compiler - Code Generation > Objective-C Bridging Header** auf und fügen Sie den folgenden Pfad hinzu: *ihr_projektname***/Plugins/ibm-mfp-core/Bridging-Header.h**. - - c. Fügen Sie die Frameworks-Parameter hinzu. Rufen Sie **Build Settings > Linking > Runpath Search Paths** auf und fügen Sie den folgenden Parameter hinzu: - ``` - @executable_path/Frameworks - ``` - d. Entfernen Sie die Kommentarzeichen aus den folgenden Push-Importanweisungen im Bridging-Header. Wechseln Sie in das Verzeichnis *Ihr Projektname***/Plugins/ibm-mfp-core/Bridging-Header.h** - - ``` - //#import - //#import - //#import - ``` - e. Erstellen Sie die Anwendung und führen Sie sie mit Xcode aus. -1. (Nur Android): Erstellen Sie Ihr Android-Projekt mit dem folgenden Befehl: -**cordova build android**. - - **Hinweis**: Bevor Sie das Projekt in Android Studio öffnen, müssen Sie zuerst die Cordova-Anwendung über die Cordova-Befehlszeilenschnittstellen erstellen. Andernfalls kann es zu Buildfehlern kommen. - - -# Cordova-Plug-in -{: #cordova_initialize} - -Bevor Sie das Cordova-Plug-in für Push Notifications Service verwenden können, müssen Sie -es initialisieren, indem Sie die Anwendungsroute und die Anwendungs-GUID übergeben. Nach der Initialisierung des Plug-ins können Sie die Verbindung zu der Serveranwendung herstellen, die Sie im Bluemix-Dashboard erstellt haben. Das Cordova-Plug-in ist die Oberfläche für die Android- und iOS-Client-SDKs zum Aktivieren einer Cordova-Anwendung für die Kommunikation mit Bluemix-Services. - -1. Initialisieren Sie 'BMSClient', indem Sie das folgende Code-Snippet kopieren und in Ihre Haupt-JavaScript-Datei (die für gewöhnlich im Verzeichnis **www/js** gespeichert ist) einfügen. - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Ändern Sie das Code-Snippet so, dass die Parameter für die Routen und Anwendungs-GUID von Bluemix verwendet werden. Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um -die Anwendungsroute und die App-GUID abzurufen. Verwenden Sie die Werte für die Route und die App-GUID als Parameter in Ihrem Code-Snippet des Typs `BMSClient.initialize`. - - **Hinweis**: Wenn Sie beispielsweise mit der Cordova-CLI eine Cordova-App erstellt haben, erstellt Cordova den Befehl 'app-name', speichert diesen JavaScript-Code in der Datei **index.js** hinter der Funktion `app.receivedEvent` in der Funktion `onDeviceReady: function()` zum Initialisieren des BMS-Clients. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, -``` - -# Geräte registrieren - -{: #cordova_register} - -Rufen Sie die Registrierungsfunktion auf, um ein Gerät für Push Notifications Service zu registrieren. - -Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre Cordova-Anwendung -ein, um ein Gerät zu registrieren. - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android verwendet den Einstellungsparameter nicht. Wenn Sie nur eine Android-App erstellen, übergeben Sie ein leeres Objekt. Beispiel: - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -Wenn Sie die Eigenschaften für Alert, Badge und Audio anpassen möchten, fügen Sie -das folgende JavaScript-Code-Snippet zur Webkomponente Ihrer Cordova-Anwendung hinzu. - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -Sie können mit JSON.parse auf den Inhalt des Antwortparameters mit der Funktion 'success' in Javascript using JSON.parse: -**var token = JSON.parse(response).token** - - -Es sind folgende Schlüssel verfügbar: `token`, `userId` und `deviceId`. - -Das folgende JavaScript-Code-Snippet zeigt, wie Sie das Bluemix Mobile Services-Client-SDK initialisieren, ein Gerät für den Push Notifications Service registrieren und Push-Benachrichtigungen überwachen können. Sie fügen diesen Code in Ihre Javascript-Datei ein. - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -in **onDeviceReady: function()**. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -Fügen Sie das folgende Objective-C-Code-Snippet zur Klasse 'delegate' Ihrer Anwendung hinzu. - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -Fügen Sie das folgende Swift-Code-Snippet zur Klasse 'delegate' Ihrer Anwendung hinzu. - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##Nächste Schritte - -{: #cordova_register_next} - -1. Erstellen Sie das Projekt und führen Sie es mit den folgenden Befehlen aus: - - * Android: **cordova build android** und anschließend **cordova run android** - - * iOS: **cordova build ios** und anschließend **cordova run ios** - - - -# Push-Benachrichtigungen in Geräten empfangen -{: #cordova_receive} - -Kopieren Sie die folgenden Code-Snippets und fügen Sie sie ein, um Push-Benachrichtigungen -auf Geräten zu empfangen. - -##JavaScript - -Fügen Sie das folgende JavaScript-Code-Snippet in die Webkomponente Ihrer Cordova-Anwendung ein. - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Eigenschaften für Android-Benachrichtigungen - -Im folgenden Abschnitt sind die Eigenschaften für Android-Benachrichtigungen aufgelistet: - -* message - Push-Benachrichtigung. -* payload - JSON-Objekt mit den Nutzdaten einer Benachrichtigung. - - -##Eigenschaften für iOS-Benachrichtigungen - -Im folgenden Abschnitt sind die Eigenschaften für iOS-Benachrichtigungen aufgelistet: - -* message - Push-Benachrichtigung. -* payload - JSON-Objekt mit den Nutzdaten einer Benachrichtigung. -action-loc-key - Diese Zeichenfolge dient als Schlüssel zum Abrufen einer lokalisierten Zeichenfolge in der aktuellen Lokalisierung, die anstelle von 'View' als Titel für die rechte Schaltfläche verwendet werden soll. -* badge - Die Nummer, die als Badge des App-Symbols angezeigt werden soll. Wenn diese Eigenschaft fehlt, wird das Badge nicht geändert. Um das Badge zu entfernen, legen Sie für diese Eigenschaft den Wert 0 fest. -* sound - Der Name einer Audiodatei im App-Bundle oder im Ordner 'Library/Sounds' -des Datencontainers der App. - -##Objective-C - -Fügen Sie die folgenden Objective-C-Code-Snippets zur Klasse 'delegate' Ihrer Anwendung hinzu. - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -Fügen Sie die folgenden Swift-Code-Snippets zur Klasse 'delegate' Ihrer Anwendung hinzu. - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` - - - -# Einfache Push-Benachrichtigungen senden -{: #push-send-notifications} - -Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen (ohne Tags, Badges, zusätzliche Nutzdaten oder Audiodateien) senden. - - -Einfache Push-Benachrichtigungen senden - -1. Wählen Sie unter **Zielgruppe auswählen** eine der folgenden Zielgruppen aus: -**Alle Geräte** oder die Plattform **Nur iOS-Geräte** oder -**Nur Android-Geräte**. - - **Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Ihre Benachrichtigung. - - ![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) - -2. Geben Sie in das Feld **Eigene Benachrichtigung erstellen** Ihre Nachricht ein und klicken Sie dann auf **Senden**. -3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. - - Der folgende Screenshot zeigt ein Alertfeld bei der Verarbeitung einer Push-Benachrichtigung -im Vordergrund auf einem Android- und auf einem iOS-Gerät. - - ![Push-Benachrichtigung im Vordergrund auf einem Android-Gerät](images/Android_Screenshot.jpg) - - ![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) - - Der folgende Screenshot zeigt eine Push-Benachrichtigung im Hintergrund auf einem Android-Gerät. - ![Push-Benachrichtigung im Hintergrund auf einem Android-Gerät](images/background.jpg) - - - -# Nächste Schritte -{: #next_steps_tags} - -Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. - -Fügen Sie diese Funktionen des Push Notifications-Service Ihrer App hinzu. -Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). -Informationen zur Verwendung erweiterter Benachrichtigungen finden Sie in [Erweiterte Push-Benachrichtigungen](t_advance_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Cordova Push-Plug-in installieren +{: #cordova_install} + +Installieren und verwenden Sie das Client-Push-Plug-in für die weitere Entwicklung Ihrer Cordova-Anwendungen. Dabei wird auch das Cordova Core-Plug-in installiert, das Ihre Verbindung zu Bluemix initialisiert. + +### Vorbemerkungen + +1. Laden Sie die aktuelle Version für das Android Studio-SDK und Xcode herunter. +1. Richten Sie den Emulator ein. Verwenden Sie für Android Studio einen Emulator, der die Google Play-API unterstützt. +1. Installieren Sie das Git-Befehlszeilentool. Stellen Sie unter Windows sicher, dass Sie die Option zum Ausführen von Git über die Windows-Eingabeaufforderung auswählen. Informationen zum Herunterladen und Installieren dieses Tools finden Sie unter [Git](https://git-scm.com/downloads). + +1. Installieren Sie Node.js und das NPM-Tool (NPM = Node Package Manager). Das NPM-Befehlszeilentool wird als Produktpaket mit Node.js bereitgestellt. Informationen zum Herunterladen und Installieren von Node.js finden Sie unter [Node.js](https://nodejs.org/en/download/). +1. Installieren Sie über die Befehlszeile die Cordova-Befehlszeilentools mithilfe des Befehls **npm install -g cordova**. Dies ist eine Voraussetzung für die Verwendung +des Cordova-Plug-ins. Informationen zum Installieren von Cordova und zum Einrichten Ihrer Cordova-App finden Sie unter [Cordova Apache](https://cordova.apache.org/#getstarted). + + **Hinweis**: Die Readme-Datei für das Cordova Push-Plug-in finden Sie unter [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push). + + +## Cordova Push-Plug-in installieren +1. Wechseln Sie in den Ordner, in dem Sie Ihre Cordova-App erstellen möchten, und führen +Sie den folgenden Befehl aus, um eine Cordova-Anwendung zu erstellen. Wenn Sie bereits über eine +Cordova-App verfügen, fahren Sie mit Schritt 3 fort. + +``` +cordova create your_app_name + cd your_app_name +``` +1. Optional: Bearbeiten Sie die Datei **config.xml** und ersetzen Sie im Element den Standardnamen 'HelloCordova' durch einen eigenen Namen. + + **Hinweis**: Stellen Sie sicher, dass Sie die richtige Bundle-ID angeben. Falls Sie dies nicht tun, werden in Xcode die folgenden Fehlernachrichten angezeigt. + * The executable was signed with invalid entitlements (Die ausführbare Funktion ist mit ungültigen Berechtigungen signiert). + * The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile (Die in der Berechtigungsdatei für die Codeunterzeichnung Ihrer Anwendung angegebenen Berechtigungen stimmen nicht mit den angegebenen Berechtigungen in Ihrem Bereitstellungsprofil überein). + + Um dieses Problem zu beheben, geben Sie korrekte Bundle-ID in Xcode oder in der Datei **config.xml** Ihrer Cordova-App an. + +1. Fügen Sie die Mindestversion der unterstützten API oder die Bereitstellungszieldeklaration zur Datei 'config.xml' Ihrer Cordova-Anwendung hinzu: Der Wert für 'minSdkVersion' muss größer als 15 sein. Der Wert für 'targetSdkVersion' muss immer das neueste Android-SDK angeben, das bei Google verfügbar ist. + * **Android** - Öffnen Sie die Datei 'config.xml' mit dem Editor und aktualisieren Sie das Element +`` mit der SDK-Mindestversion und -Zielversion: + + ``` + + + + + + ``` + * **iOS**: Aktualisieren Sie das Element mit einer Bereitstellungszieldeklaration: + + ``` + + + + + ``` + +1. Fügen Sie über die Cordova-Befehlszeilenschnittstelle (CLI) mit einem oder beiden der folgenden Befehle Ihre Plattform (iOS und/oder Android) hinzu: + + ``` + cordova platform add ios@3.9.0 + cordova platform add android + ``` +1. Geben Sie im Stammverzeichnis Ihrer Cordova-Anwendung den folgenden Befehl ein, um das Cordova Push-Plug-in **cordova plugin add ibm-mfp-push** zu installieren. + + Je nachdem, welche Plattformen Sie hinzugefügt haben, sehen Sie eine Anzeige +ähnlich der folgenden: + + ``` + Installing "ibm-mfp-push" for android + Installing "ibm-mfp-push" for ios + ``` +1. Überprüfen Sie in *eigenes_app-stammverzeichnis* mit dem Befehl **cordova plugin list**, dass die Plug-ins Cordova Core und Cordova Push erfolgreich installiert wurden. + + Je nachdem, welche Plattformen Sie hinzugefügt haben, sehen Sie eine Anzeige +ähnlich der folgenden: + + ``` + ibm-mfp-core 1.0.0 "MFPCore" + ibm-mfp-push 1.0.0 “MFPPush" + ``` +1. (nur iOS): Konfigurieren Sie Ihre iOS-Entwicklungsumgebung. + a. Öffnen Sie die Datei 'ihr_app-name.xcodeproj' im Verzeichnis *ihr_app-name***/platforms/ios** mit Xcode. + + b. Fügen Sie den Bridging-Header hinzu. Rufen Sie **Build settings > Swift Compiler - Code Generation > Objective-C Bridging Header** auf und fügen Sie den folgenden Pfad hinzu: *ihr_projektname***/Plugins/ibm-mfp-core/Bridging-Header.h**. + + c. Fügen Sie die Frameworks-Parameter hinzu. Rufen Sie **Build Settings > Linking > Runpath Search Paths** auf und fügen Sie den folgenden Parameter hinzu: + ``` + @executable_path/Frameworks + ``` + d. Entfernen Sie die Kommentarzeichen aus den folgenden Push-Importanweisungen im Bridging-Header. Wechseln Sie in das Verzeichnis *Ihr Projektname***/Plugins/ibm-mfp-core/Bridging-Header.h** + + ``` + //#import + //#import + //#import + ``` + e. Erstellen Sie die Anwendung und führen Sie sie mit Xcode aus. +1. (Nur Android): Erstellen Sie Ihr Android-Projekt mit dem folgenden Befehl: +**cordova build android**. + + **Hinweis**: Bevor Sie das Projekt in Android Studio öffnen, müssen Sie zuerst die Cordova-Anwendung über die Cordova-Befehlszeilenschnittstellen erstellen. Andernfalls kann es zu Buildfehlern kommen. + + +# Cordova-Plug-in +{: #cordova_initialize} + +Bevor Sie das Cordova-Plug-in für Push Notifications Service verwenden können, müssen Sie +es initialisieren, indem Sie die Anwendungsroute und die Anwendungs-GUID übergeben. Nach der Initialisierung des Plug-ins können Sie die Verbindung zu der Serveranwendung herstellen, die Sie im Bluemix-Dashboard erstellt haben. Das Cordova-Plug-in ist die Oberfläche für die Android- und iOS-Client-SDKs zum Aktivieren einer Cordova-Anwendung für die Kommunikation mit Bluemix-Services. + +1. Initialisieren Sie 'BMSClient', indem Sie das folgende Code-Snippet kopieren und in Ihre Haupt-JavaScript-Datei (die für gewöhnlich im Verzeichnis **www/js** gespeichert ist) einfügen. + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Ändern Sie das Code-Snippet so, dass die Parameter für die Routen und Anwendungs-GUID von Bluemix verwendet werden. Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um +die Anwendungsroute und die App-GUID abzurufen. Verwenden Sie die Werte für die Route und die App-GUID als Parameter in Ihrem Code-Snippet des Typs `BMSClient.initialize`. + + **Hinweis**: Wenn Sie beispielsweise mit der Cordova-CLI eine Cordova-App erstellt haben, erstellt Cordova den Befehl 'app-name', speichert diesen JavaScript-Code in der Datei **index.js** hinter der Funktion `app.receivedEvent` in der Funktion `onDeviceReady: function()` zum Initialisieren des BMS-Clients. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, +``` + +# Geräte registrieren + +{: #cordova_register} + +Rufen Sie die Registrierungsfunktion auf, um ein Gerät für Push Notifications Service zu registrieren. + +Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre Cordova-Anwendung +ein, um ein Gerät zu registrieren. + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android verwendet den Einstellungsparameter nicht. Wenn Sie nur eine Android-App erstellen, übergeben Sie ein leeres Objekt. Beispiel: + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +Wenn Sie die Eigenschaften für Alert, Badge und Audio anpassen möchten, fügen Sie +das folgende JavaScript-Code-Snippet zur Webkomponente Ihrer Cordova-Anwendung hinzu. + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +##JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +Sie können mit JSON.parse auf den Inhalt des Antwortparameters mit der Funktion 'success' in Javascript using JSON.parse: +**var token = JSON.parse(response).token** + + +Es sind folgende Schlüssel verfügbar: `token`, `userId` und `deviceId`. + +Das folgende JavaScript-Code-Snippet zeigt, wie Sie das Bluemix Mobile Services-Client-SDK initialisieren, ein Gerät für den Push Notifications Service registrieren und Push-Benachrichtigungen überwachen können. Sie fügen diesen Code in Ihre Javascript-Datei ein. + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +in **onDeviceReady: function()**. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +Fügen Sie das folgende Objective-C-Code-Snippet zur Klasse 'delegate' Ihrer Anwendung hinzu. + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +##Swift +{: #cordova_register_swift} +Fügen Sie das folgende Swift-Code-Snippet zur Klasse 'delegate' Ihrer Anwendung hinzu. + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +##Nächste Schritte + +{: #cordova_register_next} + +1. Erstellen Sie das Projekt und führen Sie es mit den folgenden Befehlen aus: + + * Android: **cordova build android** und anschließend **cordova run android** + + * iOS: **cordova build ios** und anschließend **cordova run ios** + + + +# Push-Benachrichtigungen in Geräten empfangen +{: #cordova_receive} + +Kopieren Sie die folgenden Code-Snippets und fügen Sie sie ein, um Push-Benachrichtigungen +auf Geräten zu empfangen. + +##JavaScript + +Fügen Sie das folgende JavaScript-Code-Snippet in die Webkomponente Ihrer Cordova-Anwendung ein. + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +##Eigenschaften für Android-Benachrichtigungen + +Im folgenden Abschnitt sind die Eigenschaften für Android-Benachrichtigungen aufgelistet: + +* message - Push-Benachrichtigung. +* payload - JSON-Objekt mit den Nutzdaten einer Benachrichtigung. + + +##Eigenschaften für iOS-Benachrichtigungen + +Im folgenden Abschnitt sind die Eigenschaften für iOS-Benachrichtigungen aufgelistet: + +* message - Push-Benachrichtigung. +* payload - JSON-Objekt mit den Nutzdaten einer Benachrichtigung. +action-loc-key - Diese Zeichenfolge dient als Schlüssel zum Abrufen einer lokalisierten Zeichenfolge in der aktuellen Lokalisierung, die anstelle von 'View' als Titel für die rechte Schaltfläche verwendet werden soll. +* badge - Die Nummer, die als Badge des App-Symbols angezeigt werden soll. Wenn diese Eigenschaft fehlt, wird das Badge nicht geändert. Um das Badge zu entfernen, legen Sie für diese Eigenschaft den Wert 0 fest. +* sound - Der Name einer Audiodatei im App-Bundle oder im Ordner 'Library/Sounds' +des Datencontainers der App. + +##Objective-C + +Fügen Sie die folgenden Objective-C-Code-Snippets zur Klasse 'delegate' Ihrer Anwendung hinzu. + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +##Swift + +Fügen Sie die folgenden Swift-Code-Snippets zur Klasse 'delegate' Ihrer Anwendung hinzu. + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` + + + +# Einfache Push-Benachrichtigungen senden +{: #push-send-notifications} + +Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen (ohne Tags, Badges, zusätzliche Nutzdaten oder Audiodateien) senden. + + +Einfache Push-Benachrichtigungen senden + +1. Wählen Sie unter **Zielgruppe auswählen** eine der folgenden Zielgruppen aus: +**Alle Geräte** oder die Plattform **Nur iOS-Geräte** oder +**Nur Android-Geräte**. + + **Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Ihre Benachrichtigung. + + ![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) + +2. Geben Sie in das Feld **Eigene Benachrichtigung erstellen** Ihre Nachricht ein und klicken Sie dann auf **Senden**. +3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. + + Der folgende Screenshot zeigt ein Alertfeld bei der Verarbeitung einer Push-Benachrichtigung +im Vordergrund auf einem Android- und auf einem iOS-Gerät. + + ![Push-Benachrichtigung im Vordergrund auf einem Android-Gerät](images/Android_Screenshot.jpg) + + ![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) + + Der folgende Screenshot zeigt eine Push-Benachrichtigung im Hintergrund auf einem Android-Gerät. + ![Push-Benachrichtigung im Hintergrund auf einem Android-Gerät](images/background.jpg) + + + +# Nächste Schritte +{: #next_steps_tags} + +Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. + +Fügen Sie diese Funktionen des Push Notifications-Service Ihrer App hinzu. +Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). +Informationen zur Verwendung erweiterter Benachrichtigungen finden Sie in [Erweiterte Push-Benachrichtigungen](t_advance_notifications.html). diff --git a/services/mobilepush/nl/de/t_cordova_receive.md b/services/mobilepush/nl/de/t_cordova_receive.md index fe48b51ba..560bdace4 100644 --- a/services/mobilepush/nl/de/t_cordova_receive.md +++ b/services/mobilepush/nl/de/t_cordova_receive.md @@ -1,87 +1,87 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Push-Benachrichtigungen in Geräten empfangen -{: #cordova_receive} - -Kopieren Sie die folgenden Code-Snippets und fügen Sie sie ein, um Push-Benachrichtigungen -auf Geräten zu empfangen. - -##JavaScript - -Fügen Sie das folgende JavaScript-Code-Snippet in die Webkomponente Ihrer Cordova-Anwendung ein. - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Eigenschaften für Android-Benachrichtigungen - -Im folgenden Abschnitt sind die Eigenschaften für Android-Benachrichtigungen aufgelistet: - -* message - Push-Benachrichtigung. -* payload - JSON-Objekt mit den Nutzdaten einer Benachrichtigung. - - -##Eigenschaften für iOS-Benachrichtigungen - -Im folgenden Abschnitt sind die Eigenschaften für iOS-Benachrichtigungen aufgelistet: - -* message - Push-Benachrichtigung. -* payload - JSON-Objekt mit den Nutzdaten einer Benachrichtigung. -action-loc-key - Diese Zeichenfolge dient als Schlüssel zum Abrufen einer lokalisierten Zeichenfolge in der aktuellen Lokalisierung, die anstelle von 'View' als Titel für die rechte Schaltfläche verwendet werden soll. -* badge - Die Nummer, die als Badge des App-Symbols angezeigt werden soll. Wenn diese Eigenschaft fehlt, wird das Badge nicht geändert. Um das Badge zu entfernen, -legen Sie für diese Eigenschaft den Wert 0 fest. -* sound - Der Name einer Audiodatei im App-Bundle oder im Ordner 'Library/Sounds' -des Datencontainers der App. - -##Objective-C - -Fügen Sie die folgenden Objective-C-Code-Snippets zur Klasse 'delegate' Ihrer Anwendung hinzu. - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -Fügen Sie die folgenden Swift-Code-Snippets zur Klasse 'delegate' Ihrer Anwendung hinzu. - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` -Nächster Schritt: [Einfache Push-Benachrichtigungen senden](t_send_push_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Push-Benachrichtigungen in Geräten empfangen +{: #cordova_receive} + +Kopieren Sie die folgenden Code-Snippets und fügen Sie sie ein, um Push-Benachrichtigungen +auf Geräten zu empfangen. + +##JavaScript + +Fügen Sie das folgende JavaScript-Code-Snippet in die Webkomponente Ihrer Cordova-Anwendung ein. + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +##Eigenschaften für Android-Benachrichtigungen + +Im folgenden Abschnitt sind die Eigenschaften für Android-Benachrichtigungen aufgelistet: + +* message - Push-Benachrichtigung. +* payload - JSON-Objekt mit den Nutzdaten einer Benachrichtigung. + + +##Eigenschaften für iOS-Benachrichtigungen + +Im folgenden Abschnitt sind die Eigenschaften für iOS-Benachrichtigungen aufgelistet: + +* message - Push-Benachrichtigung. +* payload - JSON-Objekt mit den Nutzdaten einer Benachrichtigung. +action-loc-key - Diese Zeichenfolge dient als Schlüssel zum Abrufen einer lokalisierten Zeichenfolge in der aktuellen Lokalisierung, die anstelle von 'View' als Titel für die rechte Schaltfläche verwendet werden soll. +* badge - Die Nummer, die als Badge des App-Symbols angezeigt werden soll. Wenn diese Eigenschaft fehlt, wird das Badge nicht geändert. Um das Badge zu entfernen, +legen Sie für diese Eigenschaft den Wert 0 fest. +* sound - Der Name einer Audiodatei im App-Bundle oder im Ordner 'Library/Sounds' +des Datencontainers der App. + +##Objective-C + +Fügen Sie die folgenden Objective-C-Code-Snippets zur Klasse 'delegate' Ihrer Anwendung hinzu. + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +##Swift + +Fügen Sie die folgenden Swift-Code-Snippets zur Klasse 'delegate' Ihrer Anwendung hinzu. + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` +Nächster Schritt: [Einfache Push-Benachrichtigungen senden](t_send_push_notifications.html). diff --git a/services/mobilepush/nl/de/t_cordova_register.md b/services/mobilepush/nl/de/t_cordova_register.md index 486fc3016..fc171d4b6 100644 --- a/services/mobilepush/nl/de/t_cordova_register.md +++ b/services/mobilepush/nl/de/t_cordova_register.md @@ -1,143 +1,143 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Geräte registrieren - -{: #cordova_register} - -Rufen Sie die Registrierungsfunktion auf, um ein Gerät für Push Notifications Service zu registrieren. - -Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre Cordova-Anwendung -ein, um ein Gerät zu registrieren. - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android verwendet den Einstellungsparameter nicht. Wenn Sie nur eine Android-App erstellen, übergeben Sie ein leeres Objekt. Beispiel: - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -Wenn Sie die Eigenschaften für Alert, Badge und Audio anpassen möchten, fügen Sie -das folgende JavaScript-Code-Snippet zur Webkomponente Ihrer Cordova-Anwendung hinzu. - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -Sie können mit JSON.parse auf den Inhalt des Antwortparameters mit der Funktion 'success' in Javascript using JSON.parse: -**var token = JSON.parse(response).token** - - -Es sind folgende Schlüssel verfügbar: `token`, `userId` und `deviceId`. - -Das folgende JavaScript-Code-Snippet zeigt, wie Sie das Bluemix Mobile Services-Client-SDK initialisieren, ein Gerät für den Push Notifications Service registrieren und Push-Benachrichtigungen überwachen können. Sie fügen diesen Code in Ihre Javascript-Datei ein. - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -in **onDeviceReady: function()**. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -Fügen Sie das folgende Objective-C-Code-Snippet zur Klasse 'delegate' Ihrer Anwendung hinzu. - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -Fügen Sie das folgende Swift-Code-Snippet zur Klasse 'delegate' Ihrer Anwendung hinzu. - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##Nächste Schritte -{: #cordova_register_next} - -1. Erstellen Sie das Projekt und führen Sie es mit den folgenden Befehlen aus: - - * Android: **cordova build android** und anschließend **cordova run android** - - * iOS: **cordova build ios** und anschließend **cordova run ios** -1. [Push-Benachrichtigungen -in Geräten empfangen](t_cordova_receive.html) +--- + +copyright: + years: 2015, 2016 + +--- + +# Geräte registrieren + +{: #cordova_register} + +Rufen Sie die Registrierungsfunktion auf, um ein Gerät für Push Notifications Service zu registrieren. + +Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre Cordova-Anwendung +ein, um ein Gerät zu registrieren. + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android verwendet den Einstellungsparameter nicht. Wenn Sie nur eine Android-App erstellen, übergeben Sie ein leeres Objekt. Beispiel: + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +Wenn Sie die Eigenschaften für Alert, Badge und Audio anpassen möchten, fügen Sie +das folgende JavaScript-Code-Snippet zur Webkomponente Ihrer Cordova-Anwendung hinzu. + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +##JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +Sie können mit JSON.parse auf den Inhalt des Antwortparameters mit der Funktion 'success' in Javascript using JSON.parse: +**var token = JSON.parse(response).token** + + +Es sind folgende Schlüssel verfügbar: `token`, `userId` und `deviceId`. + +Das folgende JavaScript-Code-Snippet zeigt, wie Sie das Bluemix Mobile Services-Client-SDK initialisieren, ein Gerät für den Push Notifications Service registrieren und Push-Benachrichtigungen überwachen können. Sie fügen diesen Code in Ihre Javascript-Datei ein. + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +in **onDeviceReady: function()**. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +Fügen Sie das folgende Objective-C-Code-Snippet zur Klasse 'delegate' Ihrer Anwendung hinzu. + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +##Swift +{: #cordova_register_swift} +Fügen Sie das folgende Swift-Code-Snippet zur Klasse 'delegate' Ihrer Anwendung hinzu. + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +##Nächste Schritte +{: #cordova_register_next} + +1. Erstellen Sie das Projekt und führen Sie es mit den folgenden Befehlen aus: + + * Android: **cordova build android** und anschließend **cordova run android** + + * iOS: **cordova build ios** und anschließend **cordova run ios** +1. [Push-Benachrichtigungen +in Geräten empfangen](t_cordova_receive.html) diff --git a/services/mobilepush/nl/de/t_create_push_instance.md b/services/mobilepush/nl/de/t_create_push_instance.md index c05355b48..9b0e64fbc 100644 --- a/services/mobilepush/nl/de/t_create_push_instance.md +++ b/services/mobilepush/nl/de/t_create_push_instance.md @@ -1,36 +1,36 @@ -# Push-Serviceinstanz erstellen -{: #create-push-instance} - -Um mit {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}} arbeiten zu können, müssen Sie zunächst eine {{site.data.keyword.Bluemix}}-Anwendung erstellen (z. B. eine Node.js-App). Anschließend erstellen Sie eine Instanz des Push-Service {{site.data.keyword.mobilepushfull}}, die an diese Bluemix-Anwendung gebunden werden muss. Zu diesem Zweck können Sie auch den Abschnitt 'Boilerplate' im Bluemix-Katalog aufrufen und auf 'MobileFirst Services Starter' klicken. - -**Hinweis**: Wenn Sie Organisationen konfiguriert haben, um Ihre Umgebung zu verwalten, wählen Sie die Organisation aus, in der Sie die Laufzeit und die Services für Ihre mobile App erstellen möchten. - - -1. Wenn Sie nicht über eine Bluemix-Anwendung verfügen, müssen Sie eine erstellen (z. B. eine Node.js-App). Um eine Bluemix-Anwendung zu erstellen, rufen Sie das Bluemix-Dashboard auf und klicken Sie auf **Anwendung erstellen**. - - **Hinweis**: Wenn Sie bereits über eine Anwendung verfügen, fahren Sie mit Schritt 7 fort, um einen Service hinzuzufügen.![Serviceinstanz erstellen](images/create_service_instance1.jpg "Serviceinstanz erstellen") - -1. Klicken Sie unter **Eigene Anwendungsvorlage auswählen** auf **WEB**. - -3. Wählen Sie im Bereich **Ausgangspunkt auswählen** die Option **SDK for Node.js** aus und klicken Sie auf **Weiter**.![Ausgangspunkt](images/create_service_nodejs2.jpg) - -4. Wählen Sie im Pulldown-Menü **Bereich** den Bereich Ihrer Organisation aus.![Bereich für Organisation auswählen](images/create_a_service3.jpg) -1. Geben Sie in das Feld **Name** den Namen für Ihre App ein und -in das Feld 'Host' den Namen des Hosts. - -1. Wählen Sie im Pulldown-Menü **Ausgewählter Plan** einen Plan aus -und klicken Sie anschließend auf die Schaltfläche **ERSTELLEN**. Warten Sie, -bis die Anwendung bereitgestellt ist. - -1. Klicken Sie auf den Link **Übersicht**.![Service hinzufügen](images/create_service_add4.jpg) -1. Klicken Sie auf **Service hinzufügen**. Die Anzeige 'Katalog' wird geöffnet. - -1. Wählen Sie **IBM Push Notifications:** und anschließend im Pulldown-Menü **Bereich** Ihre Organisation aus.![Pulldown-Menü 'Bereich' für Organisation](images/create_service_org.jpg) -1. Geben Sie in das Feld **Service** den Push Notifications Service-Name ein. - -1. Wählen Sie unter **Ausgewählter Plan** einen Plan aus und -klicken Sie auf die Schaltfläche **ERSTELLEN**. - -1. Klicken Sie auf **Ja**, um die Anwendung erneut bereitzustellen.![IBM Push Notifications Service](images/create_service_notification5.jpg) - -1. Klicken Sie auf **Push-Benachrichtigungen**, um das Dashboard für Push-Benachrichtigungen anzuzeigen. +# Push-Serviceinstanz erstellen +{: #create-push-instance} + +Um mit {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}} arbeiten zu können, müssen Sie zunächst eine {{site.data.keyword.Bluemix}}-Anwendung erstellen (z. B. eine Node.js-App). Anschließend erstellen Sie eine Instanz des Push-Service {{site.data.keyword.mobilepushfull}}, die an diese Bluemix-Anwendung gebunden werden muss. Zu diesem Zweck können Sie auch den Abschnitt 'Boilerplate' im Bluemix-Katalog aufrufen und auf 'MobileFirst Services Starter' klicken. + +**Hinweis**: Wenn Sie Organisationen konfiguriert haben, um Ihre Umgebung zu verwalten, wählen Sie die Organisation aus, in der Sie die Laufzeit und die Services für Ihre mobile App erstellen möchten. + + +1. Wenn Sie nicht über eine Bluemix-Anwendung verfügen, müssen Sie eine erstellen (z. B. eine Node.js-App). Um eine Bluemix-Anwendung zu erstellen, rufen Sie das Bluemix-Dashboard auf und klicken Sie auf **Anwendung erstellen**. + + **Hinweis**: Wenn Sie bereits über eine Anwendung verfügen, fahren Sie mit Schritt 7 fort, um einen Service hinzuzufügen.![Serviceinstanz erstellen](images/create_service_instance1.jpg "Serviceinstanz erstellen") + +1. Klicken Sie unter **Eigene Anwendungsvorlage auswählen** auf **WEB**. + +3. Wählen Sie im Bereich **Ausgangspunkt auswählen** die Option **SDK for Node.js** aus und klicken Sie auf **Weiter**.![Ausgangspunkt](images/create_service_nodejs2.jpg) + +4. Wählen Sie im Pulldown-Menü **Bereich** den Bereich Ihrer Organisation aus.![Bereich für Organisation auswählen](images/create_a_service3.jpg) +1. Geben Sie in das Feld **Name** den Namen für Ihre App ein und +in das Feld 'Host' den Namen des Hosts. + +1. Wählen Sie im Pulldown-Menü **Ausgewählter Plan** einen Plan aus +und klicken Sie anschließend auf die Schaltfläche **ERSTELLEN**. Warten Sie, +bis die Anwendung bereitgestellt ist. + +1. Klicken Sie auf den Link **Übersicht**.![Service hinzufügen](images/create_service_add4.jpg) +1. Klicken Sie auf **Service hinzufügen**. Die Anzeige 'Katalog' wird geöffnet. + +1. Wählen Sie **IBM Push Notifications:** und anschließend im Pulldown-Menü **Bereich** Ihre Organisation aus.![Pulldown-Menü 'Bereich' für Organisation](images/create_service_org.jpg) +1. Geben Sie in das Feld **Service** den Push Notifications Service-Name ein. + +1. Wählen Sie unter **Ausgewählter Plan** einen Plan aus und +klicken Sie auf die Schaltfläche **ERSTELLEN**. + +1. Klicken Sie auf **Ja**, um die Anwendung erneut bereitzustellen.![IBM Push Notifications Service](images/create_service_notification5.jpg) + +1. Klicken Sie auf **Push-Benachrichtigungen**, um das Dashboard für Push-Benachrichtigungen anzuzeigen. diff --git a/services/mobilepush/nl/de/t_enable-ios-notifications-receive.md b/services/mobilepush/nl/de/t_enable-ios-notifications-receive.md index ed2b508af..f87152099 100644 --- a/services/mobilepush/nl/de/t_enable-ios-notifications-receive.md +++ b/services/mobilepush/nl/de/t_enable-ios-notifications-receive.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Push-Benachrichtigungen in iOS-Geräten empfangen -{: #enable-push-ios-notifications-receiving} - -Empfangen Sie Push-Benachrichtigungen in iOS-Geräten. - -##Objective-C -Um Push-Benachrichtigungen in iOS-Geräten zu empfangen, fügen Sie die folgende Objective-C-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. - -``` -// Für Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -Um Push-Benachrichtigungen in iOS-Geräten zu empfangen, fügen Sie die folgende Swift-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. - -``` - // Für Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the server - } -``` - +--- + +copyright: + years: 2015, 2016 + +--- + +# Push-Benachrichtigungen in iOS-Geräten empfangen +{: #enable-push-ios-notifications-receiving} + +Empfangen Sie Push-Benachrichtigungen in iOS-Geräten. + +## Objective-C +Um Push-Benachrichtigungen in iOS-Geräten zu empfangen, fügen Sie die folgende Objective-C-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. + +``` +// Für Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +## Swift +Um Push-Benachrichtigungen in iOS-Geräten zu empfangen, fügen Sie die folgende Swift-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. + +``` + // Für Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the server + } +``` + diff --git a/services/mobilepush/nl/de/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/de/t_enable_actionable_notifications_ios.md index bb5e3112b..a365f2a00 100644 --- a/services/mobilepush/nl/de/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/de/t_enable_actionable_notifications_ios.md @@ -1,103 +1,103 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Umsetzbare Benachrichtigungen für iOS aktivieren -{: #enable-actionable-notifications-ios} - -Im Unterschied zu konventionellen Push-Benachrichtigungen werden Benutzer bei umsetzbaren Benachrichtigungen dazu aufgefordert, bei Erhalt der Benachrichtigungsalerts eine Auswahl zu treffen, ohne die App zu öffnen. Gehen Sie nach den folgenden Anweisungen vor, um umsetzbare Push-Benachrichtigungen in Ihrer Anwendung zu aktivieren. - -1. Erstellen Sie eine Benutzeraktion. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. Erstellen Sie die Benachrichtigungskategorie und legen Sie eine Aktion fest. Gültige Kontexte sind **UIUserNotificationActionContextDefault** oder **UIUserNotificationActionContextMinimal**. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. Erstellen Sie die Benachrichtigungseinstellung und weisen Sie die Kategorien aus dem vorherigen Schritt zu. - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. Erstellen Sie die lokale oder ferne Benachrichtigung und weisen Sie ihr die Identität der Kategorie zu. - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Umsetzbare Benachrichtigungen für iOS aktivieren +{: #enable-actionable-notifications-ios} + +Im Unterschied zu konventionellen Push-Benachrichtigungen werden Benutzer bei umsetzbaren Benachrichtigungen dazu aufgefordert, bei Erhalt der Benachrichtigungsalerts eine Auswahl zu treffen, ohne die App zu öffnen. Gehen Sie nach den folgenden Anweisungen vor, um umsetzbare Push-Benachrichtigungen in Ihrer Anwendung zu aktivieren. + +1. Erstellen Sie eine Benutzeraktion. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. Erstellen Sie die Benachrichtigungskategorie und legen Sie eine Aktion fest. Gültige Kontexte sind **UIUserNotificationActionContextDefault** oder **UIUserNotificationActionContextMinimal**. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. Erstellen Sie die Benachrichtigungseinstellung und weisen Sie die Kategorien aus dem vorherigen Schritt zu. + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. Erstellen Sie die lokale oder ferne Benachrichtigung und weisen Sie ihr die Identität der Kategorie zu. + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/de/t_enable_ios_notifications_initialize.md b/services/mobilepush/nl/de/t_enable_ios_notifications_initialize.md index faf617d0c..f3bcd41f2 100644 --- a/services/mobilepush/nl/de/t_enable_ios_notifications_initialize.md +++ b/services/mobilepush/nl/de/t_enable_ios_notifications_initialize.md @@ -1,68 +1,68 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Push-SDK für iOS-Apps initialisieren -{: #enable-push-ios-notifications-initialize} - -Das Anwendungs-Delegat für die iOS-Anwendung ist eine übliche Position für den -Initialisierungscode. -Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um -die Anwendungsroute und die GUID abzurufen. - -##Core-SDK initialisieren - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timeout in seconds -``` - -##Client-Push-SDK initialisieren - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## Route, GUID und Bluemix-Region - -**appRoute** - -Gibt die Route an, die der Serveranwendung zugewiesen ist, die Sie in Bluemix erstellt haben. - -**GUID** - -Gibt den eindeutigen Schlüssel an, der der Anwendung zugewiesen wird, die Sie in Bluemix erstellt haben. Bei diesem Wert muss die Groß-/Kleinschreibung beachtet werden. - -**bluemixRegionSuffix** - -Gibt den Standort an, an dem die App gehostet ist. Der Parameter `bluemixRegion` gibt an, welche Bluemix-Bereitstellung verwendet wird. Sie können diesen Wert mit der statischen Eigenschaft `BMSClient.REGION` angeben und einen von drei Werten verwenden: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY +--- + +copyright: + years: 2015, 2016 + +--- + +# Push-SDK für iOS-Apps initialisieren +{: #enable-push-ios-notifications-initialize} + +Das Anwendungs-Delegat für die iOS-Anwendung ist eine übliche Position für den +Initialisierungscode. +Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um +die Anwendungsroute und die GUID abzurufen. + +##Core-SDK initialisieren + +###Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +###Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timeout in seconds +``` + +##Client-Push-SDK initialisieren + +###Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +###Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## Route, GUID und Bluemix-Region + +**appRoute** + +Gibt die Route an, die der Serveranwendung zugewiesen ist, die Sie in Bluemix erstellt haben. + +**GUID** + +Gibt den eindeutigen Schlüssel an, der der Anwendung zugewiesen wird, die Sie in Bluemix erstellt haben. Bei diesem Wert muss die Groß-/Kleinschreibung beachtet werden. + +**bluemixRegionSuffix** + +Gibt den Standort an, an dem die App gehostet ist. Der Parameter `bluemixRegion` gibt an, welche Bluemix-Bereitstellung verwendet wird. Sie können diesen Wert mit der statischen Eigenschaft `BMSClient.REGION` angeben und einen von drei Werten verwenden: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY diff --git a/services/mobilepush/nl/de/t_enable_ios_notifications_install.md b/services/mobilepush/nl/de/t_enable_ios_notifications_install.md index 2fdb9532f..ebf68cbd8 100644 --- a/services/mobilepush/nl/de/t_enable_ios_notifications_install.md +++ b/services/mobilepush/nl/de/t_enable_ios_notifications_install.md @@ -1,328 +1,328 @@ -# Push-SDK für iOS-Apps initialisieren -{: #enable-push-ios-notifications-install} - -Für ein vorhandenes Xcode-Projekt können Sie das Bluemix Mobile Services-Client-SDK mithilfe des Abhängigkeitsmanagementtools CocoaPods einrichten. Als Alternative dazu können Sie das Software-Development-Kit (SDK) manuell installieren. - -**Hinweis**: Die Push-Readme-Datei für Swift finden Sie unter https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master. - -##CocoaPods installieren - -1. Installieren Sie CocoaPods, indem Sie in Ihrem Mac-Terminal folgenden Befehl verwenden. -``` -$ sudo gem install cocoapods -``` -2. Geben Sie den folgenden Befehl in das Terminal ein, um CocoaPods zu initialisieren. Stellen Sie beim Absetzen des Befehls sicher, dass Sie ihn in dem Verzeichnis ausführen, in dem sich Ihr Xcode-Projekt befindet. Mit dem Befehl `pod init` wird eine Dateibezeichnung erstellt. -``` -$ pod init -``` -3. Fügen Sie in der generierten Datei 'Podfile' die von Ihnen benötigten SDK-Abhängigkeiten hinzu. Kopieren Sie die folgende Datei 'Podfile'. - - Objective-C - - ``` - source 'https://github.com/CocoaPods/Specs.git' - Copy the following list as is and remove the dependencies you do not need - pod 'IMFCore' - pod 'IMFPush' - ``` - - Swift - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - end - ``` -3. Wechseln Sie am Terminal in Ihren Projektordner und installieren Sie die -Abhängigkeiten mithilfe des folgenden Befehls: -``` -$ pod update -``` -Mit diesem Befehl werden Ihre Abhängigkeiten installiert und es wird ein neuer Xcode-Arbeitsbereich erstellt. **Hinweis**: Stellen Sie sicher, dass Sie immer den neuen Xcode-Arbeitsbereich öffnen und nicht die ursprüngliche Xcode-Projektdatei: - - ``` - $ open App.xcworkspace - ``` -Der Arbeitsbereich enthält Ihr ursprüngliches Projekt und das Projekt 'Pods', das Ihre Abhängigkeiten enthält. Wenn Sie einen Bluemix Mobile Services-Quellenordner ändern möchten, finden Sie diesen in Ihrem Projekt 'Pods' unter `Pods/yourImportedSourceFolder`, zum Beispiel: `Pods/IMFGoogleAuthentication`. - -##Importierte Frameworks und Quellenordner verwenden - -Referenzieren Sie das SDK in Ihrem Code. - - -### Objective-C - -Schreiben Sie #import-Anweisungen für die entsprechenden Header, zum Beispiel: - -``` -//Objective-C -#import -#import -``` - -**Hinweis**: Durch Aktualisieren Ihres Projekts 'Pods' mithilfe der CocoaPods-Befehle `pod install` oder `pod update` werden die Bluemix Mobile Services-Quellenorder möglicherweise überschrieben. Wenn Sie Ihre angepassten Versionen der ursprünglichen Dateien aufbewahren möchten, müssen Sie sicherstellen, dass für sie ein Backup durchgeführt wird, bevor Sie einen dieser Befehle absetzen. - -###Swift - -**Voraussetzungen** - -- iOS 8.0 oder höher -- Xcode 7 - - -Schreiben Sie #import-Anweisungen für die entsprechenden Header, zum Beispiel: - -``` -//swift -import BMSCore -import BMSPush -``` - - -##Buildeinstellungen - -Rufen Sie **Xcode > Build Settings > Build Options** auf und setzen Sie **Enable Bitcode** auf **No**. - -**Achtung**: Ab iOS 9 können sich Änderungen an der Komponente 'App Transport Security' (ATS) auf -die Verarbeitung des Authentifizierungsprozesses auswirken. Die folgenden Blogeinträge liefern weitere Informationen zu den Änderungen: [ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) und [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/). - - - - -# Push-SDK für iOS-Apps initialisieren -{: #enable-push-ios-notifications-initialize} - -Das Anwendungs-Delegat für die iOS-Anwendung ist eine übliche Position für den -Initialisierungscode. -Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um -die Anwendungsroute und die GUID abzurufen. - -##Core-SDK initialisieren - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timeout in seconds -``` - - -##Client-Push-SDK initialisieren - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## Route, GUID und Bluemix-Region - -**appRoute** - -Gibt die Route an, die der Serveranwendung zugewiesen ist, die Sie in Bluemix erstellt haben. - -**GUID** - -Gibt den eindeutigen Schlüssel an, der der Anwendung zugewiesen wird, die Sie in Bluemix erstellt haben. Bei diesem Wert muss die Groß-/Kleinschreibung beachtet werden. - -**bluemixRegionSuffix** - -Gibt den Standort an, an dem die App gehostet ist. Der Parameter `bluemixRegion` gibt an, welche Bluemix-Bereitstellung verwendet wird. Sie können diesen Wert mit der statischen Eigenschaft `BMSClient.REGION` angeben und einen von drei Werten verwenden: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - - - - -# iOS-Anwendungen und -Geräte registrieren -{: #enable-push-ios-notifications-register} - - -Eine Anwendung (App) muss bei APNs registriert werden, um ferne Benachrichtigungen zu -empfangen. Dieser Schritt erfolgt meistens nach der Installation der App auf einem Gerät. Nachdem -das von APNs generierte Gerätetoken von der App empfangen wurde, muss es zurück an -Push Notifications Service geleitet werden. - -Führen Sie zum Registrieren von iOs-Anwendungen und -Geräten die folgenden Schritte aus: - -1. Back-End-Anwendung erstellen -2. Token an Push Notifications übergeben - - -##Back-End-Anwendung erstellen - -Erstellen Sie eine Back-End-Anwendung im Abschnitt 'Boilerplates' des Bluemix®-Katalogs, mit der der Push-Service automatisch an diese Anwendung gebunden wird. Wenn Sie bereits eine Back-End-App erstellt haben, stellen Sie sicher, dass Sie die App an Push Notifications Service binden. - -###Objective-C - -``` - //For Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##Token an Push Notifications übergeben - -Nachdem das Token von APNs empfangen worden ist, leiten Sie es als Teil der Methode `registerDevice:withDeviceToken` an Push Notifications weiter. - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -Nachdem das Token von APNS empfangen worden ist, leiten Sie es als Teil der Methode `didRegisterForRemoteNotificationsWithDeviceToken` an Push Notifications weiter. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` - - - -# Push-Benachrichtigungen in iOS-Geräten empfangen -{: #enable-push-ios-notifications-receiving} - -Empfangen Sie Push-Benachrichtigungen in iOS-Geräten. - -##Objective-C -Um Push-Benachrichtigungen in iOS-Geräten zu empfangen, fügen Sie die folgende Objective-C-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. - -``` -// Für Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -Um Push-Benachrichtigungen in iOS-Geräten zu empfangen, fügen Sie die folgende Swift-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. - -``` - // Für Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the server - } - -``` - - - -# Einfache Push-Benachrichtigungen senden -{: #push-send-notifications} - -Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen (ohne Tags, Badges, zusätzliche Nutzdaten oder Audiodateien) senden. - - -Einfache Push-Benachrichtigungen senden - -1. Wählen Sie unter **Zielgruppe auswählen** eine der folgenden Zielgruppen aus: -**Alle Geräte** oder die Plattform **Nur iOS-Geräte** oder -**Nur Android-Geräte**. - - **Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Ihre Benachrichtigung. - - ![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) - -2. Geben Sie in das Feld **Eigene Benachrichtigung erstellen** Ihre Nachricht ein und klicken Sie dann auf **Senden**. -3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. - - Der folgende Screenshot zeigt ein Alertfeld bei der Verarbeitung einer Push-Benachrichtigung -im Vordergrund auf einem Android- und auf einem iOS-Gerät. - - ![Push-Benachrichtigung im Vordergrund auf einem Android-Gerät](images/Android_Screenshot.jpg) - - ![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) - - Der folgende Screenshot zeigt eine Push-Benachrichtigung im Hintergrund auf einem Android-Gerät. - ![Push-Benachrichtigung im Hintergrund auf einem Android-Gerät](images/background.jpg) - - - - -# Nächste Schritte -{: #next_steps_tags} - -Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. - -Fügen Sie diese Funktionen des Push Notifications-Service Ihrer App hinzu. -Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). -Informationen zur Verwendung erweiterter Benachrichtigungen finden Sie in [Erweiterte Push-Benachrichtigungen](t_advance_notifications.html). +# Push-SDK für iOS-Apps initialisieren +{: #enable-push-ios-notifications-install} + +Für ein vorhandenes Xcode-Projekt können Sie das Bluemix Mobile Services-Client-SDK mithilfe des Abhängigkeitsmanagementtools CocoaPods einrichten. Als Alternative dazu können Sie das Software-Development-Kit (SDK) manuell installieren. + +**Hinweis**: Die Push-Readme-Datei für Swift finden Sie unter https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master. + +## CocoaPods installieren + +1. Installieren Sie CocoaPods, indem Sie in Ihrem Mac-Terminal folgenden Befehl verwenden. +``` +$ sudo gem install cocoapods +``` +2. Geben Sie den folgenden Befehl in das Terminal ein, um CocoaPods zu initialisieren. Stellen Sie beim Absetzen des Befehls sicher, dass Sie ihn in dem Verzeichnis ausführen, in dem sich Ihr Xcode-Projekt befindet. Mit dem Befehl `pod init` wird eine Dateibezeichnung erstellt. +``` +$ pod init +``` +3. Fügen Sie in der generierten Datei 'Podfile' die von Ihnen benötigten SDK-Abhängigkeiten hinzu. Kopieren Sie die folgende Datei 'Podfile'. + + Objective-C + + ``` + source 'https://github.com/CocoaPods/Specs.git' + Copy the following list as is and remove the dependencies you do not need + pod 'IMFCore' + pod 'IMFPush' + ``` + + Swift + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + end + ``` +3. Wechseln Sie am Terminal in Ihren Projektordner und installieren Sie die +Abhängigkeiten mithilfe des folgenden Befehls: +``` +$ pod update +``` +Mit diesem Befehl werden Ihre Abhängigkeiten installiert und es wird ein neuer Xcode-Arbeitsbereich erstellt. **Hinweis**: Stellen Sie sicher, dass Sie immer den neuen Xcode-Arbeitsbereich öffnen und nicht die ursprüngliche Xcode-Projektdatei: + + ``` + $ open App.xcworkspace + ``` +Der Arbeitsbereich enthält Ihr ursprüngliches Projekt und das Projekt 'Pods', das Ihre Abhängigkeiten enthält. Wenn Sie einen Bluemix Mobile Services-Quellenordner ändern möchten, finden Sie diesen in Ihrem Projekt 'Pods' unter `Pods/yourImportedSourceFolder`, zum Beispiel: `Pods/IMFGoogleAuthentication`. + +## Importierte Frameworks und Quellenordner verwenden + +Referenzieren Sie das SDK in Ihrem Code. + + +### Objective-C + +Schreiben Sie #import-Anweisungen für die entsprechenden Header, zum Beispiel: + +``` +//Objective-C +#import +#import +``` + +**Hinweis**: Durch Aktualisieren Ihres Projekts 'Pods' mithilfe der CocoaPods-Befehle `pod install` oder `pod update` werden die Bluemix Mobile Services-Quellenorder möglicherweise überschrieben. Wenn Sie Ihre angepassten Versionen der ursprünglichen Dateien aufbewahren möchten, müssen Sie sicherstellen, dass für sie ein Backup durchgeführt wird, bevor Sie einen dieser Befehle absetzen. + +### Swift + +**Voraussetzungen** + +- iOS 8.0 oder höher +- Xcode 7 + + +Schreiben Sie #import-Anweisungen für die entsprechenden Header, zum Beispiel: + +``` +//swift +import BMSCore +import BMSPush +``` + + +## Buildeinstellungen + +Rufen Sie **Xcode > Build Settings > Build Options** auf und setzen Sie **Enable Bitcode** auf **No**. + +**Achtung**: Ab iOS 9 können sich Änderungen an der Komponente 'App Transport Security' (ATS) auf +die Verarbeitung des Authentifizierungsprozesses auswirken. Die folgenden Blogeinträge liefern weitere Informationen zu den Änderungen: [ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) und [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/). + + + + +# Push-SDK für iOS-Apps initialisieren +{: #enable-push-ios-notifications-initialize} + +Das Anwendungs-Delegat für die iOS-Anwendung ist eine übliche Position für den +Initialisierungscode. +Klicken Sie auf den Link **Mobile Systemerweiterungen** in Ihrem Bluemix-Anwendungsdashboard, um +die Anwendungsroute und die GUID abzurufen. + +## Core-SDK initialisieren + +### Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +### Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timeout in seconds +``` + + +## Client-Push-SDK initialisieren + +### Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +### Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## Route, GUID und Bluemix-Region + +**appRoute** + +Gibt die Route an, die der Serveranwendung zugewiesen ist, die Sie in Bluemix erstellt haben. + +**GUID** + +Gibt den eindeutigen Schlüssel an, der der Anwendung zugewiesen wird, die Sie in Bluemix erstellt haben. Bei diesem Wert muss die Groß-/Kleinschreibung beachtet werden. + +**bluemixRegionSuffix** + +Gibt den Standort an, an dem die App gehostet ist. Der Parameter `bluemixRegion` gibt an, welche Bluemix-Bereitstellung verwendet wird. Sie können diesen Wert mit der statischen Eigenschaft `BMSClient.REGION` angeben und einen von drei Werten verwenden: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + + + + +# iOS-Anwendungen und -Geräte registrieren +{: #enable-push-ios-notifications-register} + + +Eine Anwendung (App) muss bei APNs registriert werden, um ferne Benachrichtigungen zu +empfangen. Dieser Schritt erfolgt meistens nach der Installation der App auf einem Gerät. Nachdem +das von APNs generierte Gerätetoken von der App empfangen wurde, muss es zurück an +Push Notifications Service geleitet werden. + +Führen Sie zum Registrieren von iOs-Anwendungen und -Geräten die folgenden Schritte aus: + +1. Back-End-Anwendung erstellen +2. Token an Push Notifications übergeben + + +## Back-End-Anwendung erstellen + +Erstellen Sie eine Back-End-Anwendung im Abschnitt 'Boilerplates' des Bluemix®-Katalogs, mit der der Push-Service automatisch an diese Anwendung gebunden wird. Wenn Sie bereits eine Back-End-App erstellt haben, stellen Sie sicher, dass Sie die App an Push Notifications Service binden. + +### Objective-C + +``` + //For Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +### Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +## Token an Push Notifications übergeben + +Nachdem das Token von APNs empfangen worden ist, leiten Sie es als Teil der Methode `registerDevice:withDeviceToken` an Push Notifications weiter. + +### Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +### Swift + +Nachdem das Token von APNS empfangen worden ist, leiten Sie es als Teil der Methode `didRegisterForRemoteNotificationsWithDeviceToken` an Push Notifications weiter. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` + + + +# Push-Benachrichtigungen in iOS-Geräten empfangen +{: #enable-push-ios-notifications-receiving} + +Empfangen Sie Push-Benachrichtigungen in iOS-Geräten. + +## Objective-C +Um Push-Benachrichtigungen in iOS-Geräten zu empfangen, fügen Sie die folgende Objective-C-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. + +``` +// Für Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +## Swift +Um Push-Benachrichtigungen in iOS-Geräten zu empfangen, fügen Sie die folgende Swift-Methode zum Anwendungs-Delegat Ihrer Anwendung hinzu. + +``` + // Für Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the server + } + +``` + + + +# Einfache Push-Benachrichtigungen senden +{: #push-send-notifications} + +Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen (ohne Tags, Badges, zusätzliche Nutzdaten oder Audiodateien) senden. + + +Einfache Push-Benachrichtigungen senden + +1. Wählen Sie unter **Zielgruppe auswählen** eine der folgenden Zielgruppen aus: +**Alle Geräte** oder die Plattform **Nur iOS-Geräte** oder +**Nur Android-Geräte**. + + **Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Ihre Benachrichtigung. + + ![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) + +2. Geben Sie in das Feld **Eigene Benachrichtigung erstellen** Ihre Nachricht ein und klicken Sie dann auf **Senden**. +3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. + + Der folgende Screenshot zeigt ein Alertfeld bei der Verarbeitung einer Push-Benachrichtigung +im Vordergrund auf einem Android- und auf einem iOS-Gerät. + + ![Push-Benachrichtigung im Vordergrund auf einem Android-Gerät](images/Android_Screenshot.jpg) + + ![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) + + Der folgende Screenshot zeigt eine Push-Benachrichtigung im Hintergrund auf einem Android-Gerät. + ![Push-Benachrichtigung im Hintergrund auf einem Android-Gerät](images/background.jpg) + + + + +# Nächste Schritte +{: #next_steps_tags} + +Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte Benachrichtigungen und erweiterte Optionen konfigurieren. + +Fügen Sie diese Funktionen des Push Notifications-Service Ihrer App hinzu. +Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](c_tag_basednotifications.html). +Informationen zur Verwendung erweiterter Benachrichtigungen finden Sie in [Erweiterte Push-Benachrichtigungen](t_advance_notifications.html). diff --git a/services/mobilepush/nl/de/t_enable_ios_notifications_register.md b/services/mobilepush/nl/de/t_enable_ios_notifications_register.md index 144eb8863..826089896 100644 --- a/services/mobilepush/nl/de/t_enable_ios_notifications_register.md +++ b/services/mobilepush/nl/de/t_enable_ios_notifications_register.md @@ -1,94 +1,94 @@ -# iOS-Anwendungen und -Geräte registrieren -{: #enable-push-ios-notifications-register} - - -Eine Anwendung (App) muss bei APNs registriert werden, um ferne Benachrichtigungen zu -empfangen. Dieser Schritt erfolgt meistens nach der Installation der App auf einem Gerät. Nachdem -das von APNs generierte Gerätetoken von der App empfangen wurde, muss es zurück an -Push Notifications Service geleitet werden. - -Führen Sie zum Registrieren von iOs-Anwendungen und -Geräten die folgenden Schritte aus: - -1. Back-End-Anwendung erstellen -2. Token an Push Notifications übergeben - - -##Back-End-Anwendung erstellen - -Erstellen Sie eine Back-End-Anwendung im Abschnitt 'Boilerplates' des Bluemix®-Katalogs, mit der der Push-Service automatisch an diese Anwendung gebunden wird. Wenn Sie bereits eine Back-End-App erstellt haben, stellen Sie sicher, dass Sie die App an Push Notifications Service binden. - -###Objective-C - -``` - //For Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##Token an Push Notifications übergeben - -Nachdem das Token von APNs empfangen worden ist, leiten Sie es als Teil der Methode `registerDevice:withDeviceToken` an Push Notifications weiter. - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -Nachdem das Token von APNS empfangen worden ist, leiten Sie es als Teil der Methode `didRegisterForRemoteNotificationsWithDeviceToken` an Push Notifications weiter. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` +# iOS-Anwendungen und -Geräte registrieren +{: #enable-push-ios-notifications-register} + + +Eine Anwendung (App) muss bei APNs registriert werden, um ferne Benachrichtigungen zu +empfangen. Dieser Schritt erfolgt meistens nach der Installation der App auf einem Gerät. Nachdem +das von APNs generierte Gerätetoken von der App empfangen wurde, muss es zurück an +Push Notifications Service geleitet werden. + +Führen Sie zum Registrieren von iOs-Anwendungen und -Geräten die folgenden Schritte aus: + +1. Back-End-Anwendung erstellen +2. Token an Push Notifications übergeben + + +##Back-End-Anwendung erstellen + +Erstellen Sie eine Back-End-Anwendung im Abschnitt 'Boilerplates' des Bluemix®-Katalogs, mit der der Push-Service automatisch an diese Anwendung gebunden wird. Wenn Sie bereits eine Back-End-App erstellt haben, stellen Sie sicher, dass Sie die App an Push Notifications Service binden. + +###Objective-C + +``` + //For Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +###Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +##Token an Push Notifications übergeben + +Nachdem das Token von APNs empfangen worden ist, leiten Sie es als Teil der Methode `registerDevice:withDeviceToken` an Push Notifications weiter. + +###Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +###Swift + +Nachdem das Token von APNS empfangen worden ist, leiten Sie es als Teil der Methode `didRegisterForRemoteNotificationsWithDeviceToken` an Push Notifications weiter. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` diff --git a/services/mobilepush/nl/de/t_get_tags.md b/services/mobilepush/nl/de/t_get_tags.md index e77ca1b0f..3cb0e0ff8 100644 --- a/services/mobilepush/nl/de/t_get_tags.md +++ b/services/mobilepush/nl/de/t_get_tags.md @@ -1,157 +1,157 @@ -# Tags abrufen -{: #get_tags} - -Mit Tags können im Gegensatz zu allgemeinen Rundsendungen, die an alle Anwendungen gesendet werden, Benachrichtigungen auf der Grundlage eines Interessenbereichs zielgruppenspezifisch an Benutzer gesendet werden. Sie können Tags erstellen und verwalten, indem Sie die Registerkarte 'Tag' im Push-Dashboard oder REST-APIs verwenden. Sie können die Code-Snippets in den folgenden Abschnitten verwenden, um Ihre Tag-Subskriptionen für Ihre mobile Anwendung zu verwalten und abzufragen. Sie können diese Code-Snippets verwenden, um Subskriptionen abzurufen, eine Subskription für einen Tag einzurichten, -eine Subskription für einen Tag aufzuheben und eine Liste der verfügbaren Tags abzurufen. Sie kopieren diese Code-Snippets und fügen Sie in Ihre mobile Anwendung ein. - -## Android - -Die API **getTags** gibt die Liste mit den verfügbaren Tags zurück, die das Gerät subskribieren kann. Nachdem -das Gerät einen bestimmten Tag subskribiert hat, kann es alle Push-Benachrichtigungen empfangen, die für -diesen Tag gesendet werden. - -Kopieren Sie die folgenden Code-Snippets in Ihre mobile Android-Anwendung, um eine Liste -der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags. - -Verwenden Sie die API **getTags**, um eine Liste der verfügbaren Tags abzurufen, die das Gerät subskribieren kann. - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - -Verwenden Sie die API **getSubscriptions**, um eine Liste der Tags abzurufen, die das -Gerät subskribiert hat. - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) -``` - -## Cordova - -Kopieren Sie die folgenden Code-Snippets in Ihre mobile Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags, die das Gerät subskribieren kann. - -Rufen Sie einen Array der Tags ab, die zum Subskribieren verfügbar sind. - -``` -//Get a list of available tags to which the device can subscribe -MFPPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, null); - -``` - -``` -//Get a list of available tags to which the device is subscribed. -MFPPush.getSubscriptionStatus(function(tags) { - alert(tags); -}, null); -``` - -## Objective-C - -Kopieren Sie die folgenden Code-Snippets in Ihre mit Objective-C entwickelte iOS-Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags, die das Gerät subskribieren kann. - -Verwenden Sie die API **retrieveAvailableTags**, um eine Liste der verfügbaren Tags abzurufen, die das Gerät subskribieren kann. - -``` -//Get a list of available tags to which the device can subscribe -[push retrieveAvailableTagsWithCompletionHandler: -^(IMFResponse *response, NSError *error){ - if (error){[ self updateMessage:error.description];} else { - [self updateMessage:@"Successfully retrieved available tags."]; - NSDictionary *availableTags = [[NSDictionary alloc]init]; - availableTags = [response tags]; -[self.appDelegateVC updateMessage:availableTags.description]; -} -}]; -``` - -Verwenden Sie die API **retrieveSubscriptions**, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat. - - -``` -// Get a list of tags that to which the device is subscribed. -[push retrieveSubscriptionsWithCompletionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved subscriptions."]; - NSDictionary *subscribedTags = [[NSDictionary alloc]init]; -subscribedTags = [response subscriptions]; -[self.appDelegateVC updateMessage:subscribedTags.description]; -} -}]; -``` - -## Swift - -Die API **retrieveAvailableTagsWithCompletionHandler** gibt die Liste mit den verfügbaren Tags zurück, die das Gerät subskribieren kann. Nachdem -das Gerät einen bestimmten Tag subskribiert hat, kann es alle Push-Benachrichtigungen empfangen, die für -diesen Tag gesendet werden. - -Rufen Sie den Push-Service auf, um die Subskriptionen für einen Tag abzurufen. - -Kopieren Sie die folgenden Code-Snippets in Ihre mobile Swift-Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags, die das Gerät subskribieren kann. - - -``` -//Get a list of available tags to which the device can subscribe -push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - - if error.isEmpty { - - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else{ - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - -``` -//Get a list of available tags to which the device is subscribed - push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty - { - - print( "Response during retrieving subscribed tags : \(response.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - - - +# Tags abrufen +{: #get_tags} + +Mit Tags können im Gegensatz zu allgemeinen Rundsendungen, die an alle Anwendungen gesendet werden, Benachrichtigungen auf der Grundlage eines Interessenbereichs zielgruppenspezifisch an Benutzer gesendet werden. Sie können Tags erstellen und verwalten, indem Sie die Registerkarte 'Tag' im Push-Dashboard oder REST-APIs verwenden. Sie können die Code-Snippets in den folgenden Abschnitten verwenden, um Ihre Tag-Subskriptionen für Ihre mobile Anwendung zu verwalten und abzufragen. Sie können diese Code-Snippets verwenden, um Subskriptionen abzurufen, eine Subskription für einen Tag einzurichten, +eine Subskription für einen Tag aufzuheben und eine Liste der verfügbaren Tags abzurufen. Sie kopieren diese Code-Snippets und fügen Sie in Ihre mobile Anwendung ein. + +## Android + +Die API **getTags** gibt die Liste mit den verfügbaren Tags zurück, die das Gerät subskribieren kann. Nachdem +das Gerät einen bestimmten Tag subskribiert hat, kann es alle Push-Benachrichtigungen empfangen, die für +diesen Tag gesendet werden. + +Kopieren Sie die folgenden Code-Snippets in Ihre mobile Android-Anwendung, um eine Liste +der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags. + +Verwenden Sie die API **getTags**, um eine Liste der verfügbaren Tags abzurufen, die das Gerät subskribieren kann. + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + +Verwenden Sie die API **getSubscriptions**, um eine Liste der Tags abzurufen, die das +Gerät subskribiert hat. + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) +``` + +## Cordova + +Kopieren Sie die folgenden Code-Snippets in Ihre mobile Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags, die das Gerät subskribieren kann. + +Rufen Sie einen Array der Tags ab, die zum Subskribieren verfügbar sind. + +``` +//Get a list of available tags to which the device can subscribe +MFPPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, null); + +``` + +``` +//Get a list of available tags to which the device is subscribed. +MFPPush.getSubscriptionStatus(function(tags) { + alert(tags); +}, null); +``` + +## Objective-C + +Kopieren Sie die folgenden Code-Snippets in Ihre mit Objective-C entwickelte iOS-Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags, die das Gerät subskribieren kann. + +Verwenden Sie die API **retrieveAvailableTags**, um eine Liste der verfügbaren Tags abzurufen, die das Gerät subskribieren kann. + +``` +//Get a list of available tags to which the device can subscribe +[push retrieveAvailableTagsWithCompletionHandler: +^(IMFResponse *response, NSError *error){ + if (error){[ self updateMessage:error.description];} else { + [self updateMessage:@"Successfully retrieved available tags."]; + NSDictionary *availableTags = [[NSDictionary alloc]init]; + availableTags = [response tags]; +[self.appDelegateVC updateMessage:availableTags.description]; +} +}]; +``` + +Verwenden Sie die API **retrieveSubscriptions**, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat. + + +``` +// Get a list of tags that to which the device is subscribed. +[push retrieveSubscriptionsWithCompletionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved subscriptions."]; + NSDictionary *subscribedTags = [[NSDictionary alloc]init]; +subscribedTags = [response subscriptions]; +[self.appDelegateVC updateMessage:subscribedTags.description]; +} +}]; +``` + +## Swift + +Die API **retrieveAvailableTagsWithCompletionHandler** gibt die Liste mit den verfügbaren Tags zurück, die das Gerät subskribieren kann. Nachdem +das Gerät einen bestimmten Tag subskribiert hat, kann es alle Push-Benachrichtigungen empfangen, die für +diesen Tag gesendet werden. + +Rufen Sie den Push-Service auf, um die Subskriptionen für einen Tag abzurufen. + +Kopieren Sie die folgenden Code-Snippets in Ihre mobile Swift-Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags, die das Gerät subskribieren kann. + + +``` +//Get a list of available tags to which the device can subscribe +push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + + if error.isEmpty { + + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else{ + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + +``` +//Get a list of available tags to which the device is subscribed + push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty + { + + print( "Response during retrieving subscribed tags : \(response.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + + + diff --git a/services/mobilepush/nl/de/t_handle_actionable_notifications_ios.md b/services/mobilepush/nl/de/t_handle_actionable_notifications_ios.md index eb7849c37..5baad9feb 100644 --- a/services/mobilepush/nl/de/t_handle_actionable_notifications_ios.md +++ b/services/mobilepush/nl/de/t_handle_actionable_notifications_ios.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Umsetzbare Benachrichtigungen für iOS verarbeiten -{: #actionable-notifications} - - -Wenn eine umsetzbare Benachrichtigung empfangen wird, wird die Steuerung basierend auf der ausgewählten Kennung an die folgende Methode weitergeleitet. - -###Objective-C - -``` -(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: -(UILocalNotification *)notification completionHandler:(void (^)())completionHandler -{ - NSLog(@"actionable notification received."); - //must call completion handler when finished - completionHandler(); -} -``` - -###Swift - -``` -func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { - //must call completion handler when finished - completionHandler() - } -``` - - +--- + +copyright: + years: 2015, 2016 + +--- + +# Umsetzbare Benachrichtigungen für iOS verarbeiten +{: #actionable-notifications} + + +Wenn eine umsetzbare Benachrichtigung empfangen wird, wird die Steuerung basierend auf der ausgewählten Kennung an die folgende Methode weitergeleitet. + +### Objective-C + +``` +(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: +(UILocalNotification *)notification completionHandler:(void (^)())completionHandler +{ + NSLog(@"actionable notification received."); + //must call completion handler when finished + completionHandler(); +} +``` + +### Swift + +``` +func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { + //must call completion handler when finished + completionHandler() + } +``` + + diff --git a/services/mobilepush/nl/de/t_holding_notifications_android.md b/services/mobilepush/nl/de/t_holding_notifications_android.md index d106bd0ba..21163dab9 100644 --- a/services/mobilepush/nl/de/t_holding_notifications_android.md +++ b/services/mobilepush/nl/de/t_holding_notifications_android.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Benachrichtigungen für Android blockieren -{: #hold-notifications-android} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - -Wenn Ihre Anwendung in den Hintergrund wechselt, ist es gegebenenfalls wünschenswert, dass der {{site.data.keyword.mobilepushshort}}-Service die Benachrichtigungen aufbewahrt, die an Ihre Anwendung gesendet werden. Rufen Sie zum Blockieren von Benachrichtigungen die Methode 'hold()' in der Methode 'onPause()' der Aktivität auf, die Push-Benachrichtigungen verarbeitet. - -``` - @Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Benachrichtigungen für Android blockieren +{: #hold-notifications-android} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + +Wenn Ihre Anwendung in den Hintergrund wechselt, ist es gegebenenfalls wünschenswert, dass der {{site.data.keyword.mobilepushshort}}-Service die Benachrichtigungen aufbewahrt, die an Ihre Anwendung gesendet werden. Rufen Sie zum Blockieren von Benachrichtigungen die Methode 'hold()' in der Methode 'onPause()' der Aktivität auf, die Push-Benachrichtigungen verarbeitet. + +``` + @Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/de/t_manage_tags.md b/services/mobilepush/nl/de/t_manage_tags.md index 267cbd477..0bf34524e 100644 --- a/services/mobilepush/nl/de/t_manage_tags.md +++ b/services/mobilepush/nl/de/t_manage_tags.md @@ -1,348 +1,348 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Tags verwalten -{: #manage_tags} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - -Verwenden Sie das {{site.data.keyword.mobilepushshort}}-Dashboard, um Tags für Ihre Anwendung zu erstellen und zu löschen und anschließend tagbasierte Benachrichtigungen zu initiieren. Die tagbasierte Benachrichtigung wird auf Geräten empfangen, von denen Tags subskribiert wurden. - - -## Tags erstellen -{: #create_tags} - -Tagbasierte Benachrichtigungen sind Benachrichtigungen, die all diejenigen Geräte als Ziel haben, die einen -bestimmten Tag subskribiert haben. Jedes Gerät kann beliebig viele Tags subskribieren. Wenn ein Tag gelöscht wird, werden die Informationen diesem Tag zugeordneten Informationen (einschließlich Subskribenten und Geräte) gelöscht. Es ist erforderlich, die automatische Subskription aufzuheben, wenn der Tag nicht mehr vorhanden ist. Es ist keine weitere Aktion von der Clientseite erforderlich. - -1. Wählen Sie im {{site.data.keyword.mobilepushshort}}-Dashboard die Registerkarte **Tags** aus. -1. Klicken Sie auf die Schaltfläche **Tag erstellen**. - 1. Geben Sie in das Feld **Name** den Namen für den Tag ein. Beispiel: "Coupons". - 1. Geben Sie in das Feld **Beschreibung** eine Beschreibung für den Tag ein. - 1. Klicken Sie auf **Speichern**. - -1. Wählen Sie im Bereich **Code-Snippets** die Plattform für Ihre mobile Anwendung aus. -1. Ändern Sie die Code-Snippets so, dass Fehler verarbeitet werden, und kopieren Sie anschließend die Code-Snippets für jeden Tag in Ihre mobile Anwendung. - -## Tags löschen -{: #delete_tags} - -1. Wählen Sie auf der Registerkarte **Tag** den Tag aus, den Sie löschen möchten, und klicken Sie auf das Symbol **Löschen**. -1. Klicken Sie auf **OK**. - -## Tagbeschreibung bearbeiten -{: #edit_tags} - -1. Wählen Sie in der Registerkarte **Tag** den Tag aus, den Sie bearbeiten möchten. -1. Klicken Sie auf das Symbol **Bearbeiten**. -1. Bearbeiten Sie die Tagbeschreibung und klicken Sie anschließend auf die Schaltfläche **Speichern**. - -# Tags abrufen -{: #get_tags} - -Mit Tags können im Gegensatz zu allgemeinen Rundsendungen, die an alle Anwendungen gesendet werden, Benachrichtigungen auf der Grundlage eines Interessenbereichs zielgruppenspezifisch an Benutzer gesendet werden. Sie können Tags erstellen und verwalten, indem Sie die Registerkarte 'Tag' im {{site.data.keyword.mobilepushshort}}-Dashboard oder REST-APIs verwenden. Sie können Code-Snippets verwenden, um Ihre Tag-Subskriptionen für Ihre mobile Anwendung zu verwalten und abzufragen. Sie können diese Code-Snippets verwenden, um Subskriptionen abzurufen, eine Subskription für einen Tag einzurichten, eine Subskription für einen Tag aufzuheben oder eine Liste der verfügbaren Tags abzurufen. Kopieren Sie diese Code-Snippets in Ihre mobile Anwendung. - -## Tags mit Android abrufen -{: android-get-tags} - -Die API **getTags** gibt die Liste mit den verfügbaren Tags zurück, die das Gerät subskribieren kann. Nachdem das Gerät einen bestimmten Tag subskribiert hat, kann es die Push-Benachrichtigungen empfangen, die für diesen Tag gesendet werden. - -Kopieren Sie die folgenden Code-Snippets in Ihre mobile Android-Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags. - -Verwenden Sie die API **getTags**, um eine Liste der verfügbaren Tags abzurufen, die das Gerät subskribieren kann. - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } - }) -``` - {: codeblock} - -Verwenden Sie die API **getSubscriptions**, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat. - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) - ``` - {: codeblock} - -## Tags mit Cordova abrufen -{: cordova-get-tags} - -Kopieren Sie die folgenden Code-Snippets in Ihre mobile Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags, die das Gerät subskribieren kann. - -Rufen Sie einen Array der Tags ab, die zum Subskribieren verfügbar sind. - -``` -//Get a list of available tags to which the device can subscribe -BMSPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed. -BMSPush.retrieveSubscriptions(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - - -## Tags mit Swift abrufen -{: swift-get-tags} - -Die API **retrieveAvailableTagsWithCompletionHandler** gibt die Liste mit den verfügbaren Tags zurück, die das Gerät subskribieren kann. Nachdem das Gerät einen bestimmten Tag subskribiert hat, kann es Push-Benachrichtigungen empfangen, die für diesen Tag gesendet werden. - -Rufen Sie die Push-Benachrichtigungen auf, um die Subskriptionen für einen Tag abzurufen. - -Kopieren Sie die folgenden Code-Snippets in Ihre mobile Swift-Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags, die das Gerät subskribieren kann. -``` -//Get a list of available tags to which the device can subscribe - push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - if error.isEmpty - { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else - { - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed - push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty - { - print( "Response during retrieving subscribed tags : \(response?.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else - { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -## Google Chrome, Safari und Mozilla Firefox -{: web-get-tags} - -Zum Abrufen der Liste verfügbarer Tags, die von Kunden subskribiert werden können, verwenden Sie folgenden Code. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - - -## Google Chrome-Apps und Erweiterungen -{: web-get-tags} - -Zum Abrufen der Liste verfügbarer Tags, die von Kunden subskribiert werden können, verwenden Sie folgenden Code. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - -Kopieren Sie die folgenden Code-Snippets in Ihre Google Chrome-Apps und Erweiterungen, um eine Liste von Tags abzurufen, die von Kunden subskribiert wurden. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveSubscriptions(function(response) - { - alert(response.response) - }) -``` - {: codeblock} - - -# Tags subskribieren und die Subskription aufheben -{: #Subscribe_tags} - -Verwenden Sie die folgenden Code-Snippets, um Ihren Geräten das Abrufen von Subskriptionen und das Subskribieren und das Aufheben der Subskription von Tags zu ermöglichen. - -## Tags mit Android subskribieren und die Subskription aufheben -{: android-subscribe-tags} - -Kopieren Sie dieses Code-Snippet und fügen Sie es in Ihre mobile Android-Anwendung ein. - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } - }); -``` - {: codeblock} - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } - }); -``` - {: codeblock} - -## Tags mit Cordova subskribieren und die Subskription aufheben -{: cordova-subscribe-tags} - -Kopieren Sie dieses Code-Snippet und fügen Sie es in Ihre mobile Cordova-Anwendung ein. - -``` -var tag = "YourTag"; -BMSPush.subscribe(tag, success, failure); -BMSPush.unsubscribe(tag, success, failure); -``` - {: codeblock} - - -## Tags mit Swift subskribieren und die Subskription aufheben -{: swift-subscribe-tags} - -Kopieren Sie dieses Code-Snippet und fügen Sie es in Ihre mobile Swift-Anwendung ein. - -Verwenden Sie die API **subscribeToTags** zum Subskribieren eines Tags. - -``` -push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print("Response when subscribing to tags: \(response?.description)") - print("Status code when subscribing to tags: \(statusCode)") - } else { - print("Error when subscribing to tags: \(error) ") - print("Error status code when subscribing to tags: \(statusCode)") - } -}) -``` - {: codeblock} - -Verwenden Sie die API **unsubscribeFromTags** zum Aufheben der Subskription eines Tags. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during unsubscribed tags : \(response?.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - {: codeblock} - -## Google Chrome und Mozilla Firefox -{: web-subscribe-tags} - -Um Tags von Webanwendungen zu subskribieren, verwenden Sie das folgende Code-Snippet: - -``` -var tagsArray = ["tag1", "Tag2"] -bmsPush.subscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -Um die Subskription von Tags aufzuheben, verwenden Sie die Methode **unSubscribe**. - -``` -var tagsArray = ["tag1", "Tag2"] - bmsPush.unSubscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -# Tagbasierte Benachrichtigungen verwenden -{: #using_tags} - -Tagbasierte Benachrichtigungen sind Benachrichtigungen, die alle diejenigen Geräte zum Ziel haben, die einen bestimmten Tag subskribiert haben. Jedes Gerät kann beliebig viele Tags subskribieren. Dieses Thema beschreibt, wie tagbasierte Benachrichtigungen gesendet werden. Subskriptionen werden von der Bluemix-Instanz des {{site.data.keyword.mobilepushshort}}-Service verwaltet. Wenn ein Tag gelöscht wird, werden alle diesem Tag zugeordneten Informationen (einschließlich Subskribenten und Geräte) gelöscht. Für diesen Tag ist keine automatische Aufhebung der Subskription erforderlich, da er nicht mehr vorhanden ist und daher clientseitig keine weiteren Aktionen nötig sind. - -Erstellen Sie Tags in der Anzeige **Tag**. Informationen zum Erstellen von Tags finden Sie in [Tags erstellen](t_manage_tags.html). - -1. Klicken Sie im **Push Notification**-Dashboard auf **Benachrichtigungen senden**. -1. Wählen Sie in der Dropdown-Liste **Senden an** die Option **Gerät nach Tag** aus. -1. Suchen Sie nach den Tags, die Sie verwenden möchten, und wählen Sie sie aus. -![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) -1. Geben Sie im Feld **Nachrichtentext** den Text ein, der als Benachrichtigung an die subskribierte Benutzergruppe gesendet werden soll. -1. Klicken Sie auf **Senden**. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Tags verwalten +{: #manage_tags} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + +Verwenden Sie das {{site.data.keyword.mobilepushshort}}-Dashboard, um Tags für Ihre Anwendung zu erstellen und zu löschen und anschließend tagbasierte Benachrichtigungen zu initiieren. Die tagbasierte Benachrichtigung wird auf Geräten empfangen, von denen Tags subskribiert wurden. + + +## Tags erstellen +{: #create_tags} + +Tagbasierte Benachrichtigungen sind Benachrichtigungen, die all diejenigen Geräte als Ziel haben, die einen +bestimmten Tag subskribiert haben. Jedes Gerät kann beliebig viele Tags subskribieren. Wenn ein Tag gelöscht wird, werden die Informationen diesem Tag zugeordneten Informationen (einschließlich Subskribenten und Geräte) gelöscht. Es ist erforderlich, die automatische Subskription aufzuheben, wenn der Tag nicht mehr vorhanden ist. Es ist keine weitere Aktion von der Clientseite erforderlich. + +1. Wählen Sie im {{site.data.keyword.mobilepushshort}}-Dashboard die Registerkarte **Tags** aus. +1. Klicken Sie auf die Schaltfläche **Tag erstellen**. + 1. Geben Sie in das Feld **Name** den Namen für den Tag ein. Beispiel: "Coupons". + 1. Geben Sie in das Feld **Beschreibung** eine Beschreibung für den Tag ein. + 1. Klicken Sie auf **Speichern**. + +1. Wählen Sie im Bereich **Code-Snippets** die Plattform für Ihre mobile Anwendung aus. +1. Ändern Sie die Code-Snippets so, dass Fehler verarbeitet werden, und kopieren Sie anschließend die Code-Snippets für jeden Tag in Ihre mobile Anwendung. + +## Tags löschen +{: #delete_tags} + +1. Wählen Sie auf der Registerkarte **Tag** den Tag aus, den Sie löschen möchten, und klicken Sie auf das Symbol **Löschen**. +1. Klicken Sie auf **OK**. + +## Tagbeschreibung bearbeiten +{: #edit_tags} + +1. Wählen Sie in der Registerkarte **Tag** den Tag aus, den Sie bearbeiten möchten. +1. Klicken Sie auf das Symbol **Bearbeiten**. +1. Bearbeiten Sie die Tagbeschreibung und klicken Sie anschließend auf die Schaltfläche **Speichern**. + +# Tags abrufen +{: #get_tags} + +Mit Tags können im Gegensatz zu allgemeinen Rundsendungen, die an alle Anwendungen gesendet werden, Benachrichtigungen auf der Grundlage eines Interessenbereichs zielgruppenspezifisch an Benutzer gesendet werden. Sie können Tags erstellen und verwalten, indem Sie die Registerkarte 'Tag' im {{site.data.keyword.mobilepushshort}}-Dashboard oder REST-APIs verwenden. Sie können Code-Snippets verwenden, um Ihre Tag-Subskriptionen für Ihre mobile Anwendung zu verwalten und abzufragen. Sie können diese Code-Snippets verwenden, um Subskriptionen abzurufen, eine Subskription für einen Tag einzurichten, eine Subskription für einen Tag aufzuheben oder eine Liste der verfügbaren Tags abzurufen. Kopieren Sie diese Code-Snippets in Ihre mobile Anwendung. + +## Tags mit Android abrufen +{: android-get-tags} + +Die API **getTags** gibt die Liste mit den verfügbaren Tags zurück, die das Gerät subskribieren kann. Nachdem das Gerät einen bestimmten Tag subskribiert hat, kann es die Push-Benachrichtigungen empfangen, die für diesen Tag gesendet werden. + +Kopieren Sie die folgenden Code-Snippets in Ihre mobile Android-Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags. + +Verwenden Sie die API **getTags**, um eine Liste der verfügbaren Tags abzurufen, die das Gerät subskribieren kann. + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } + }) +``` + {: codeblock} + +Verwenden Sie die API **getSubscriptions**, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat. + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) + ``` + {: codeblock} + +## Tags mit Cordova abrufen +{: cordova-get-tags} + +Kopieren Sie die folgenden Code-Snippets in Ihre mobile Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags, die das Gerät subskribieren kann. + +Rufen Sie einen Array der Tags ab, die zum Subskribieren verfügbar sind. + +``` +//Get a list of available tags to which the device can subscribe +BMSPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed. +BMSPush.retrieveSubscriptions(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + + +## Tags mit Swift abrufen +{: swift-get-tags} + +Die API **retrieveAvailableTagsWithCompletionHandler** gibt die Liste mit den verfügbaren Tags zurück, die das Gerät subskribieren kann. Nachdem das Gerät einen bestimmten Tag subskribiert hat, kann es Push-Benachrichtigungen empfangen, die für diesen Tag gesendet werden. + +Rufen Sie die Push-Benachrichtigungen auf, um die Subskriptionen für einen Tag abzurufen. + +Kopieren Sie die folgenden Code-Snippets in Ihre mobile Swift-Anwendung, um eine Liste der Tags abzurufen, die das Gerät subskribiert hat, und eine Liste der verfügbaren Tags, die das Gerät subskribieren kann. +``` +//Get a list of available tags to which the device can subscribe + push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + if error.isEmpty + { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else + { + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed + push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty + { + print( "Response during retrieving subscribed tags : \(response?.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else + { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +## Google Chrome, Safari und Mozilla Firefox +{: web-get-tags} + +Zum Abrufen der Liste verfügbarer Tags, die von Kunden subskribiert werden können, verwenden Sie folgenden Code. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + + +## Google Chrome-Apps und Erweiterungen +{: web-get-tags} + +Zum Abrufen der Liste verfügbarer Tags, die von Kunden subskribiert werden können, verwenden Sie folgenden Code. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + +Kopieren Sie die folgenden Code-Snippets in Ihre Google Chrome-Apps und Erweiterungen, um eine Liste von Tags abzurufen, die von Kunden subskribiert wurden. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveSubscriptions(function(response) + { + alert(response.response) + }) +``` + {: codeblock} + + +# Tags subskribieren und die Subskription aufheben +{: #Subscribe_tags} + +Verwenden Sie die folgenden Code-Snippets, um Ihren Geräten das Abrufen von Subskriptionen und das Subskribieren und das Aufheben der Subskription von Tags zu ermöglichen. + +## Tags mit Android subskribieren und die Subskription aufheben +{: android-subscribe-tags} + +Kopieren Sie dieses Code-Snippet und fügen Sie es in Ihre mobile Android-Anwendung ein. + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } + }); +``` + {: codeblock} + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } + }); +``` + {: codeblock} + +## Tags mit Cordova subskribieren und die Subskription aufheben +{: cordova-subscribe-tags} + +Kopieren Sie dieses Code-Snippet und fügen Sie es in Ihre mobile Cordova-Anwendung ein. + +``` +var tag = "YourTag"; +BMSPush.subscribe(tag, success, failure); +BMSPush.unsubscribe(tag, success, failure); +``` + {: codeblock} + + +## Tags mit Swift subskribieren und die Subskription aufheben +{: swift-subscribe-tags} + +Kopieren Sie dieses Code-Snippet und fügen Sie es in Ihre mobile Swift-Anwendung ein. + +Verwenden Sie die API **subscribeToTags** zum Subskribieren eines Tags. + +``` +push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print("Response when subscribing to tags: \(response?.description)") + print("Status code when subscribing to tags: \(statusCode)") + } else { + print("Error when subscribing to tags: \(error) ") + print("Error status code when subscribing to tags: \(statusCode)") + } +}) +``` + {: codeblock} + +Verwenden Sie die API **unsubscribeFromTags** zum Aufheben der Subskription eines Tags. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during unsubscribed tags : \(response?.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + {: codeblock} + +## Google Chrome und Mozilla Firefox +{: web-subscribe-tags} + +Um Tags von Webanwendungen zu subskribieren, verwenden Sie das folgende Code-Snippet: + +``` +var tagsArray = ["tag1", "Tag2"] +bmsPush.subscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +Um die Subskription von Tags aufzuheben, verwenden Sie die Methode **unSubscribe**. + +``` +var tagsArray = ["tag1", "Tag2"] + bmsPush.unSubscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +# Tagbasierte Benachrichtigungen verwenden +{: #using_tags} + +Tagbasierte Benachrichtigungen sind Benachrichtigungen, die alle diejenigen Geräte zum Ziel haben, die einen bestimmten Tag subskribiert haben. Jedes Gerät kann beliebig viele Tags subskribieren. Dieses Thema beschreibt, wie tagbasierte Benachrichtigungen gesendet werden. Subskriptionen werden von der Bluemix-Instanz des {{site.data.keyword.mobilepushshort}}-Service verwaltet. Wenn ein Tag gelöscht wird, werden alle diesem Tag zugeordneten Informationen (einschließlich Subskribenten und Geräte) gelöscht. Für diesen Tag ist keine automatische Aufhebung der Subskription erforderlich, da er nicht mehr vorhanden ist und daher clientseitig keine weiteren Aktionen nötig sind. + +Erstellen Sie Tags in der Anzeige **Tag**. Informationen zum Erstellen von Tags finden Sie in [Tags erstellen](t_manage_tags.html). + +1. Klicken Sie im **Push Notification**-Dashboard auf **Benachrichtigungen senden**. +1. Wählen Sie in der Dropdown-Liste **Senden an** die Option **Gerät nach Tag** aus. +1. Suchen Sie nach den Tags, die Sie verwenden möchten, und wählen Sie sie aus. +![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) +1. Geben Sie im Feld **Nachrichtentext** den Text ein, der als Benachrichtigung an die subskribierte Benutzergruppe gesendet werden soll. +1. Klicken Sie auf **Senden**. diff --git a/services/mobilepush/nl/de/t_manage_user.md b/services/mobilepush/nl/de/t_manage_user.md index 768680c58..abb801ee9 100644 --- a/services/mobilepush/nl/de/t_manage_user.md +++ b/services/mobilepush/nl/de/t_manage_user.md @@ -1,166 +1,166 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Ein Gerät mit einer Benutzer-ID registrieren -{: #register_device_with_userId} -Letzte Aktualisierung: 06. Februar 2017 -{: .last-updated} - -Führen Sie die folgenden Schritte aus, um eine Registrierung für die Benachrichtigung auf Benutzer-ID-Basis durchzuführen: - -## Android -{: android-register} - -Initialisieren Sie die Klasse 'MFPPush' mit dem Schlüssel `AppGUID` und dem Schlüssel `clientSecret` des {{site.data.keyword.mobilepushshort}}-Service. -``` -// Initialize the Push Notifications service -push = MFPPush.getInstance(); -push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); -``` - {: codeblock} - - -- **AppGUID**: Dies ist der 'AppGUID'-Schlüssel des {{site.data.keyword.mobilepushshort}}-Service. -- **clientSecret**: Dies ist der 'clientSecret'-Schlüssel des {{site.data.keyword.mobilepushshort}}-Service. - - Verwenden Sie die API **registerDeviceWithUserId**, um das Gerät für Push-Benachrichtigungen zu registrieren. - -``` -// Register the device to Push Notifications -push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - Log.d("Device is registered with Push Service.");} - @Override - public void onFailure(MFPPushException ex) { - Log.d("Error registering with Push Service...\n" - + "Push notifications will not be received."); - } - }); -``` - {: codeblock} - -- **userId**: Übergeben Sie die eindeutige Benutzer-ID für die Registrierung bei {{site.data.keyword.mobilepushshort}}. - -**Hinweis:** Um {{site.data.keyword.mobilepushshort}} zu aktivieren, die auf einer Benutzer-ID basieren, müssen Sie sicherstellen, dass Sie das Gerät mit einer Benutzer-ID registrieren und außerdem den geheimen Clientschlüssel ('clientSecret') übergeben, der bei der Bereitstellung der {{site.data.keyword.mobilepushshort}}-Services zugeordnet wird. Die Geräteregistrierung schlägt ohne einen gültigen geheimen Clientschlüssel fehl. - -## Cordova -{: cordova} - -Verwenden Sie die folgenden APIs für die Registrierung von Push-Benachrichtigungen auf Benutzer-ID-Basis. - -``` -// Register device for Push Notification with UserId -var options = {"userId": "Your User Id value"}; -BMSPush.registerDevice(options,success, failure); -``` - {: codeblock} - - -- **userId**: Übergeben Sie die eindeutige Benutzer-ID für die Registrierung bei {{site.data.keyword.mobilepushshort}}. - - -## Swift -{: swift-register} - -``` -// Initialize the BMSPushClient -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -- **AppGUID**: Dies ist der 'AppGUID'-Schlüssel des {{site.data.keyword.mobilepushshort}}-Service. -- **clientSecret**: Dies ist der 'clientSecret'-Schlüssel des {{site.data.keyword.mobilepushshort}}-Service. - -Verwenden Sie die API **registerWithUserId**, um das Gerät für Push-Benachrichtigungen zu registrieren. - -``` -// Register the device to Push Notifications service -push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in -if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } else { - print( "Error during device registration \(error) ") - } - } -``` - {: codeblock} - -- **userId**: Übergeben Sie die eindeutige Benutzer-ID für die Registrierung bei {{site.data.keyword.mobilepushshort}}. - -## Google Chrome, Safari und Mozilla Firefox -{: web-register} - -Verwenden Sie die folgenden APIs, um die Registrierung für Benachrichtigungen durchzuführen, die auf einer Benutzer-ID basieren. Initialisieren Sie das SDK mit `app GUID`, `app Region` und `Client Secret`. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -Nach der erfolgreichen Registrierung registrieren Sie die Webanwendung bei der Benutzer-ID. - -``` -bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -## Google Chrome-Apps und Erweiterungen -{: web-register-new} - -Verwenden Sie die folgenden APIs, um die Registrierung für Benachrichtigungen durchzuführen, die auf einer Benutzer-ID basieren. Initialisieren Sie das SDK mit `app GUID`, `app Region` und `Client Secret`. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -Nach der erfolgreichen Initialisierung müssen Sie die Webanwendung mit der Benutzer-ID registrieren. - -``` -bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -# Benachrichtigungen, die auf einer Benutzer-ID basieren -{: #using_userid} - -Die Benachrichtigungen, die auf einer Benutzer-ID basieren, sind Benachrichtigungsnachrichten, deren Ziel ein bestimmter Benutzer ist. Viele Geräte können mit einem einzigen Benutzer registriert werden. In den folgenden Schritten wird beschrieben, wie Benachrichtigungen auf Benutzer-ID-Basis gesendet werden. - -1. Wählen Sie im Dashboard **Push-Benachrichtigungen** die Option **Benachrichtigung senden** aus. -1. Wählen Sie die **Benutzer-ID** in der Liste der Optionen **Senden an** aus. -1. Suchen Sie im Feld **Benutzer-ID** nach der Benutzer-ID, die Sie verwenden möchten, und klicken Sie anschließend auf **Hinzufügen**.![Notifications Screen](images/user_notification.jpg) -1. Geben Sie im Feld **Nachricht** den Text ein, den Sie in Ihrer Benachrichtigung senden möchten. -1. Klicken Sie auf **Senden**. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ein Gerät mit einer Benutzer-ID registrieren +{: #register_device_with_userId} +Letzte Aktualisierung: 06. Februar 2017 +{: .last-updated} + +Führen Sie die folgenden Schritte aus, um eine Registrierung für die Benachrichtigung auf Benutzer-ID-Basis durchzuführen: + +## Android +{: android-register} + +Initialisieren Sie die Klasse 'MFPPush' mit dem Schlüssel `AppGUID` und dem Schlüssel `clientSecret` des {{site.data.keyword.mobilepushshort}}-Service. +``` +// Initialize the Push Notifications service +push = MFPPush.getInstance(); +push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); +``` + {: codeblock} + + +- **AppGUID**: Dies ist der 'AppGUID'-Schlüssel des {{site.data.keyword.mobilepushshort}}-Service. +- **clientSecret**: Dies ist der 'clientSecret'-Schlüssel des {{site.data.keyword.mobilepushshort}}-Service. + + Verwenden Sie die API **registerDeviceWithUserId**, um das Gerät für Push-Benachrichtigungen zu registrieren. + +``` +// Register the device to Push Notifications +push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + Log.d("Device is registered with Push Service.");} + @Override + public void onFailure(MFPPushException ex) { + Log.d("Error registering with Push Service...\n" + + "Push notifications will not be received."); + } + }); +``` + {: codeblock} + +- **userId**: Übergeben Sie die eindeutige Benutzer-ID für die Registrierung bei {{site.data.keyword.mobilepushshort}}. + +**Hinweis:** Um {{site.data.keyword.mobilepushshort}} zu aktivieren, die auf einer Benutzer-ID basieren, müssen Sie sicherstellen, dass Sie das Gerät mit einer Benutzer-ID registrieren und außerdem den geheimen Clientschlüssel ('clientSecret') übergeben, der bei der Bereitstellung der {{site.data.keyword.mobilepushshort}}-Services zugeordnet wird. Die Geräteregistrierung schlägt ohne einen gültigen geheimen Clientschlüssel fehl. + +## Cordova +{: cordova} + +Verwenden Sie die folgenden APIs für die Registrierung von Push-Benachrichtigungen auf Benutzer-ID-Basis. + +``` +// Register device for Push Notification with UserId +var options = {"userId": "Your User Id value"}; +BMSPush.registerDevice(options,success, failure); +``` + {: codeblock} + + +- **userId**: Übergeben Sie die eindeutige Benutzer-ID für die Registrierung bei {{site.data.keyword.mobilepushshort}}. + + +## Swift +{: swift-register} + +``` +// Initialize the BMSPushClient +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +- **AppGUID**: Dies ist der 'AppGUID'-Schlüssel des {{site.data.keyword.mobilepushshort}}-Service. +- **clientSecret**: Dies ist der 'clientSecret'-Schlüssel des {{site.data.keyword.mobilepushshort}}-Service. + +Verwenden Sie die API **registerWithUserId**, um das Gerät für Push-Benachrichtigungen zu registrieren. + +``` +// Register the device to Push Notifications service +push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in +if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } else { + print( "Error during device registration \(error) ") + } + } +``` + {: codeblock} + +- **userId**: Übergeben Sie die eindeutige Benutzer-ID für die Registrierung bei {{site.data.keyword.mobilepushshort}}. + +## Google Chrome, Safari und Mozilla Firefox +{: web-register} + +Verwenden Sie die folgenden APIs, um die Registrierung für Benachrichtigungen durchzuführen, die auf einer Benutzer-ID basieren. Initialisieren Sie das SDK mit `app GUID`, `app Region` und `Client Secret`. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +Nach der erfolgreichen Registrierung registrieren Sie die Webanwendung bei der Benutzer-ID. + +``` +bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +## Google Chrome-Apps und Erweiterungen +{: web-register-new} + +Verwenden Sie die folgenden APIs, um die Registrierung für Benachrichtigungen durchzuführen, die auf einer Benutzer-ID basieren. Initialisieren Sie das SDK mit `app GUID`, `app Region` und `Client Secret`. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +Nach der erfolgreichen Initialisierung müssen Sie die Webanwendung mit der Benutzer-ID registrieren. + +``` +bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +# Benachrichtigungen, die auf einer Benutzer-ID basieren +{: #using_userid} + +Die Benachrichtigungen, die auf einer Benutzer-ID basieren, sind Benachrichtigungsnachrichten, deren Ziel ein bestimmter Benutzer ist. Viele Geräte können mit einem einzigen Benutzer registriert werden. In den folgenden Schritten wird beschrieben, wie Benachrichtigungen auf Benutzer-ID-Basis gesendet werden. + +1. Wählen Sie im Dashboard **Push-Benachrichtigungen** die Option **Benachrichtigung senden** aus. +1. Wählen Sie die **Benutzer-ID** in der Liste der Optionen **Senden an** aus. +1. Suchen Sie im Feld **Benutzer-ID** nach der Benutzer-ID, die Sie verwenden möchten, und klicken Sie anschließend auf **Hinzufügen**.![Notifications Screen](images/user_notification.jpg) +1. Geben Sie im Feld **Nachricht** den Text ein, den Sie in Ihrer Benachrichtigung senden möchten. +1. Klicken Sie auf **Senden**. diff --git a/services/mobilepush/nl/de/t_push_ios_nextsteps.md b/services/mobilepush/nl/de/t_push_ios_nextsteps.md index 9b5181500..ab89e669b 100644 --- a/services/mobilepush/nl/de/t_push_ios_nextsteps.md +++ b/services/mobilepush/nl/de/t_push_ios_nextsteps.md @@ -1,22 +1,22 @@ - ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# Nächste Schritte - -{: #push-ios-nextsteps} - -Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte -Benachrichtigungen und erweiterte Optionen konfigurieren. - -Fügen Sie die folgenden Funktionen von Push Notifications Service zu Ihrer App hinzu. - - - -- Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](t_push_tagsmain.md). -- Informationen zur Verwendung erweiterter Benachrichtigungen finden Sie in [Erweiterte Push-Benachrichtigungen](t_advance_notifications.md). + +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# Nächste Schritte + +{: #push-ios-nextsteps} + +Nachdem Sie einfache Benachrichtigungen erfolgreich eingerichtet haben, können Sie tagbasierte +Benachrichtigungen und erweiterte Optionen konfigurieren. + +Fügen Sie die folgenden Funktionen von Push Notifications Service zu Ihrer App hinzu. + + + +- Informationen zur Verwendung tagbasierter Benachrichtigungen finden Sie in [Tagbasierte Benachrichtigungen](t_push_tagsmain.md). +- Informationen zur Verwendung erweiterter Benachrichtigungen finden Sie in [Erweiterte Push-Benachrichtigungen](t_advance_notifications.md). diff --git a/services/mobilepush/nl/de/t_push_monitoring.md b/services/mobilepush/nl/de/t_push_monitoring.md index d9299c896..46eeeca02 100644 --- a/services/mobilepush/nl/de/t_push_monitoring.md +++ b/services/mobilepush/nl/de/t_push_monitoring.md @@ -1,33 +1,33 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Push-Benachrichtigungen überwachen -{: #monitor-notifications} -Letzte Aktualisierung: 16. Januar 2017 -{: .last-updated} - - -Der IBM {{site.data.keyword.mobilepushshort}}-Service verfügt nun über erweiterte Funktionen zum Überwachen des Durchsatzes von Push-Operationen, indem aus Ihren Benutzerdaten Diagramme generiert werden. Sie können das Dienstprogramm zum Auflisten aller gesendeten Push-Benachrichtigungen oder aller registrierten Geräte sowie für die tägliche, wöchentliche oder monatliche Analyse der Informationen verwenden. - -Verwenden Sie zum Generieren von Berichten für alle Ihre gesendeten Benachrichtigungen die in [REST-APIs](https://mobile.{DomainName}/imfpush/){: new_window} beschriebene Berichtsmethode 'GET report' für Push-Nachrichten. - -![Bericht über gesendete Benachrichtigungen](images/monitoring_messages.jpg) - - -Verwenden Sie zum Generieren von Berichten für alle Ihre registrierten Geräte die in [REST-APIs](https://mobile.{DomainName}/imfpush/){: new_window} beschriebene Berichtsmethode 'GET report' für Push-Geräteregistrierungen. - -![Bericht über registrierte Geräte](images/monitoring_devices.jpg) - -Informationen zum Aktualisieren Ihres Android-SDK für die Überwachung Ihrer Benachrichtigungsinformationen finden Sie in [Push-Benachrichtigungen in Android-Geräten überwachen](c_android_enable.html#android_monitor). - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Push-Benachrichtigungen überwachen +{: #monitor-notifications} +Letzte Aktualisierung: 16. Januar 2017 +{: .last-updated} + + +Der IBM {{site.data.keyword.mobilepushshort}}-Service verfügt nun über erweiterte Funktionen zum Überwachen des Durchsatzes von Push-Operationen, indem aus Ihren Benutzerdaten Diagramme generiert werden. Sie können das Dienstprogramm zum Auflisten aller gesendeten Push-Benachrichtigungen oder aller registrierten Geräte sowie für die tägliche, wöchentliche oder monatliche Analyse der Informationen verwenden. + +Verwenden Sie zum Generieren von Berichten für alle Ihre gesendeten Benachrichtigungen die in [REST-APIs](https://mobile.{DomainName}/imfpush/){: new_window} beschriebene Berichtsmethode 'GET report' für Push-Nachrichten. + +![Bericht über gesendete Benachrichtigungen](images/monitoring_messages.jpg) + + +Verwenden Sie zum Generieren von Berichten für alle Ihre registrierten Geräte die in [REST-APIs](https://mobile.{DomainName}/imfpush/){: new_window} beschriebene Berichtsmethode 'GET report' für Push-Geräteregistrierungen. + +![Bericht über registrierte Geräte](images/monitoring_devices.jpg) + +Informationen zum Aktualisieren Ihres Android-SDK für die Überwachung Ihrer Benachrichtigungsinformationen finden Sie in [Push-Benachrichtigungen in Android-Geräten überwachen](c_android_enable.html#android_monitor). + + + diff --git a/services/mobilepush/nl/de/t_push_provider_android.md b/services/mobilepush/nl/de/t_push_provider_android.md index 9067eed75..6918eaa6c 100644 --- a/services/mobilepush/nl/de/t_push_provider_android.md +++ b/services/mobilepush/nl/de/t_push_provider_android.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Berechtigungsnachweise für FCM generieren -{: #create-push-enable-gcm} -Letzte Aktualisierung: 16. Januar 2017 -{: .last-updated} - -Firebase Cloud Messaging (FCM) ist das Gateway, das für die Übermittlung von Push-Benachrichtigungen an Android-Geräte sowie an Google Chrome verwendet wird. FCM ist die neue Version von Google Cloud Messaging (GCM). Sie müssen Ihre FCM-Berechtigungsnachweise abrufen, um den {{site.data.keyword.mobilepushshort}}-Service im Dashboard einzurichen. Achten Sie darauf, für neue Apps FCM-Konfigurationen zu verwenden. Vorhandene Apps können mit GCM-Konfigurationen weiterhin betrieben werden. - -##Absender-ID und API-Schlüssel abrufen -{: #android-senderid-apikey} - -Der API-Schlüssel wird geschützt gespeichert und vom {{site.data.keyword.mobilepushshort}}-Service für die Verbindungsherstellung zum FCM-Server verwendet. Die Absender-ID (Projektnummer) wird vom Android-SDK und dem JS-SDK für Google Chrome und Mozilla Firefox auf der Clientseite verwendet. - -Zum Einrichten von FCM generieren Sie den API-Schlüssel und die Absender-ID und führen Sie folgende Schritte aus: - -1. Rufen Sie die [Firebase-Konsole ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://console.firebase.google.com/?pli=1){: new_window} auf. -2. Wählen Sie **Neues Projekt erstellen** aus. -3. Geben Sie im Fenster 'Projekt erstellen' einen Projektnamen ein, wählen Sie ein Land/eine Region aus und klicken Sie auf **Projekt erstellen**. -3. Klicken Sie im Navigationsfenster auf das Symbol 'Einstellungen' und wählen Sie **Projekteinstellungen** aus. -4. Wählen Sie die Registerkarte 'Cloud Messaging' aus, um einen Server-API-Schlüssel und eine Absender-ID zu generieren. - -##{{site.data.keyword.mobilepushshort}}-Service für Android und Chrome Apps und Erweiterungen einrichten -{: #setup-push-android} - -**Hinweis:** Sie benötigen Ihren FCM/GCM-API-Schlüssel und die Absender-ID (Projektnummer). - -1. Öffnen Sie Ihr Bluemix-Dashboard und klicken Sie anschließend auf die von Ihnen erstellte Serviceinstanz von {{site.data.keyword.mobilepushfull}}, um das Dashboard zu öffnen. Das Push-Dashboard wird angezeigt. Um einen nicht gebundenen {{site.data.keyword.mobilepushshort}}-Service für Android einzurichten, wählen Sie das Symbol für 'Nicht gebundenen {{site.data.keyword.mobilepushshort}}-Service' aus, um das {{site.data.keyword.mobilepushshort}}-Servicedashboard anzuzeigen. - -![Push-Dashboard](images/push_unbound.jpg) - -2. Klicken Sie auf die Schaltfläche **Push einrichten**, um die FCM/GCM-Berechtigungsnachweise für Android-Anwendungen und Google Chrome-Apps und Erweiterungen zu konfigurieren. -3. Für Android öffnen Sie auf der Seite **Konfiguration** die Registerkarte **Mobile** und konfigurieren Sie die Absender-ID (GCM-Projektnummer) und den API-Schlüssel. Für Google Chrome Apps und Erweiterungen öffnen Sie die Registerkarte **Web** und konfigurieren Sie die Absender-ID (FCM/GCM-Projektnummer) und den API-Schlüssel entsprechend. -4. Klicken Sie auf **Speichern**. -5. Nächste Schritte: [Benachrichtigungen für Android aktivieren](c_enable_push.html) oder [Benachrichtigungen für Google Chrome-Apps & Erweiterungen aktivieren](c_enable_push.html). - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Berechtigungsnachweise für FCM generieren +{: #create-push-enable-gcm} +Letzte Aktualisierung: 16. Januar 2017 +{: .last-updated} + +Firebase Cloud Messaging (FCM) ist das Gateway, das für die Übermittlung von Push-Benachrichtigungen an Android-Geräte sowie an Google Chrome verwendet wird. FCM ist die neue Version von Google Cloud Messaging (GCM). Sie müssen Ihre FCM-Berechtigungsnachweise abrufen, um den {{site.data.keyword.mobilepushshort}}-Service im Dashboard einzurichen. Achten Sie darauf, für neue Apps FCM-Konfigurationen zu verwenden. Vorhandene Apps können mit GCM-Konfigurationen weiterhin betrieben werden. + +##Absender-ID und API-Schlüssel abrufen +{: #android-senderid-apikey} + +Der API-Schlüssel wird geschützt gespeichert und vom {{site.data.keyword.mobilepushshort}}-Service für die Verbindungsherstellung zum FCM-Server verwendet. Die Absender-ID (Projektnummer) wird vom Android-SDK und dem JS-SDK für Google Chrome und Mozilla Firefox auf der Clientseite verwendet. + +Zum Einrichten von FCM generieren Sie den API-Schlüssel und die Absender-ID und führen Sie folgende Schritte aus: + +1. Rufen Sie die [Firebase-Konsole ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://console.firebase.google.com/?pli=1){: new_window} auf. +2. Wählen Sie **Neues Projekt erstellen** aus. +3. Geben Sie im Fenster 'Projekt erstellen' einen Projektnamen ein, wählen Sie ein Land/eine Region aus und klicken Sie auf **Projekt erstellen**. +3. Klicken Sie im Navigationsfenster auf das Symbol 'Einstellungen' und wählen Sie **Projekteinstellungen** aus. +4. Wählen Sie die Registerkarte 'Cloud Messaging' aus, um einen Server-API-Schlüssel und eine Absender-ID zu generieren. + +##{{site.data.keyword.mobilepushshort}}-Service für Android und Chrome Apps und Erweiterungen einrichten +{: #setup-push-android} + +**Hinweis:** Sie benötigen Ihren FCM/GCM-API-Schlüssel und die Absender-ID (Projektnummer). + +1. Öffnen Sie Ihr Bluemix-Dashboard und klicken Sie anschließend auf die von Ihnen erstellte Serviceinstanz von {{site.data.keyword.mobilepushfull}}, um das Dashboard zu öffnen. Das Push-Dashboard wird angezeigt. Um einen nicht gebundenen {{site.data.keyword.mobilepushshort}}-Service für Android einzurichten, wählen Sie das Symbol für 'Nicht gebundenen {{site.data.keyword.mobilepushshort}}-Service' aus, um das {{site.data.keyword.mobilepushshort}}-Servicedashboard anzuzeigen. + +![Push-Dashboard](images/push_unbound.jpg) + +2. Klicken Sie auf die Schaltfläche **Push einrichten**, um die FCM/GCM-Berechtigungsnachweise für Android-Anwendungen und Google Chrome-Apps und Erweiterungen zu konfigurieren. +3. Für Android öffnen Sie auf der Seite **Konfiguration** die Registerkarte **Mobile** und konfigurieren Sie die Absender-ID (GCM-Projektnummer) und den API-Schlüssel. Für Google Chrome Apps und Erweiterungen öffnen Sie die Registerkarte **Web** und konfigurieren Sie die Absender-ID (FCM/GCM-Projektnummer) und den API-Schlüssel entsprechend. +4. Klicken Sie auf **Speichern**. +5. Nächste Schritte: [Benachrichtigungen für Android aktivieren](c_enable_push.html) oder [Benachrichtigungen für Google Chrome-Apps & Erweiterungen aktivieren](c_enable_push.html). + + diff --git a/services/mobilepush/nl/de/t_push_provider_ios.md b/services/mobilepush/nl/de/t_push_provider_ios.md index 3dee2c464..add5586af 100644 --- a/services/mobilepush/nl/de/t_push_provider_ios.md +++ b/services/mobilepush/nl/de/t_push_provider_ios.md @@ -1,148 +1,148 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Berechtigungsnachweise für APNs generieren -{: #create-push-credentials-apns} -Letzte Aktualisierung: 16. Januar 2017 -{: .last-updated} - -Apple Push Notification Service (APNs) ermöglicht Anwendungsentwicklern das Senden ferner Benachrichtigungen aus der Bluemix-Instanz des {{site.data.keyword.mobilepushshort}}-Service (d. h. dem Provider) an iOS-Geräte und -Anwendungen. Die Nachrichten werden an eine Zielanwendung auf dem Gerät gesendet. - -Rufen Sie Ihre APNs-Berechtigungsnachweise ab und konfigurieren Sie sie. Die APNs-Zertifikate werden vom {{site.data.keyword.mobilepushshort}}-Service sicher verwaltet und zum Herstellen einer Verbindung zum APNs-Server als Provider verwendet. - - - - - - -##App-IDs registrieren -{: #create-push-credentials-apns-register} - - -Die App-ID (Bundle-ID) ist eine eindeutige Kennung für eine bestimmte Anwendung. Für jede Anwendung ist eine App-ID erforderlich. Services wie der {{site.data.keyword.mobilepushshort}}-Service werden für die App-ID konfiguriert. - -1. Stellen Sie sicher, dass Sie über ein [Apple Developers-Konto ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com/){: new_window} verfügen. -2. Rufen Sie das [Apple Developer-Portal ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com){: new_window} auf, klicken Sie auf **Member Center** und wählen Sie **Certificates, Identifiers & Profiles** aus. -3. Navigieren Sie zum Abschnitt **Registering App IDs** der [Apple Developer Library ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window} und befolgen Sie die Anweisungen zum Registrieren der App-ID. - -Wählen Sie beim Registrieren einer App-ID die folgenden Optionen aus: - -* Push Notifications -![App Services](images/appID_appservices_enablepush.jpg) -* Explicit ID Suffix -![Explicit ID](images/appID_bundleID.jpg) -4. Erstellen Sie ein SSL-Zertifikat zum Entwickeln und Verteilen von APNs. - -##SSL-Zertifikat zum Entwickeln und Verteilen von APNs erstellen -{: #create-push-credentials-apns-ssl} - -Bevor Sie ein APNs-Zertifikat anfordern, müssen Sie zunächst eine Zertifikatssignieranforderung (Certificate Signing Request, CSR) generieren und an die Zertifizierungsstelle (Certificate Authority, CA) von Apple schicken. Die CSR enthält Informationen zum Identifizieren Ihres Unternehmens und beinhaltet Ihren öffentlichen sowie Ihren privaten Schlüssel, den Sie zum Signieren Ihrer Apple-Push-Benachrichtigungen verwenden. Generieren Sie anschließend das SSL-Zertifikat in iOS Developer Portal. Das Zertifikat mit dem zugehörigen öffentlichen und privaten Schlüssel wird in Keychain Access gespeichert. - - - - - - -Sie können APNs auf zwei Weisen verwenden: - -* Sandboxmodus zum Entwickeln und Testen. -* Produktionsmodus zum Verteilen von Anwendungen über den App -Store (oder über die Verteilungsmechanismen anderer Unternehmen. - -Sie müssen separate Zertifikate für Ihre Entwicklungs- und Verteilungsumgebungen anfordern. Die Zertifikate werden einer App-ID für die App zugeordnet, die der Empfänger für ferne Benachrichtigungen ist. Für die Produktion können Sie bis zu zwei Zertifikate erstellen. Bluemix verwendet diese Zertifikate, um eine SSL-Verbindung mit APNs herzustellen. - - - -1. Rufen Sie die [Apple Developer-Website ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com){: new_window} auf, klicken Sie auf **Member Center** und wählen Sie **Certificates, Identifiers & Profiles** aus. -2. Klicken Sie im Bereich **Identifiers** auf **App IDs**. -3. Wählen Sie in der Liste Ihrer App-IDs zunächst die App-ID und anschließend **Einstellungen** aus. -4. Erstellen Sie im Bereich **Push Notifications** zunächst ein SSL-Zertifikat für Entwicklung und anschließend ein SSL-Zertifikat für Produktion. - - ![SSL-Zertifikate für Push Notifications](images/certificate_createssl.jpg) - -5. Wenn die Anzeige zur Erstellung einer Zertifikatssignieranforderung (CSR) **About Creating a Certificate Siging Request (CSR)** angezeigt wird, starten Sie auf Ihrem Mac-Computer die Anwendung **Keychain Access**, um eine Zertifikatssignieranforderung (Certificate Signing Request, CSR) zu erstellen. -6. Wählen Sie im Menü **Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority…** aus. -7. Geben Sie unter **Certificate Information** die E-Mail-Adresse ein, die Ihrem App Developer-Konto zugeordnet ist, sowie einen allgemeinen Namen. Verwenden Sie einen aussagefähigen Namen, der erkennen lässt, ob es sich um ein Zertifikat für die Entwicklung (Sandbox) oder für die Verteilung (Produktion) handelt (z. B. *sandbox-apns-certificate* oder *production-apns-certificate*). -8. Wählen Sie die Option **Save to disk** aus, um die Datei `.certSigningRequest` auf Ihren Desktop herunterzuladen, und klicken Sie anschließend auf **Continue**. -9. Geben Sie in der Menüoption **Save As** einen Namen für die Datei `.certSigningRequest` an und klicken Sie anschließend auf **Save**. -10. Klicken Sie auf **Done**. Sie haben eine CSR erstellt. -11. Kehren Sie zum Fenster **About Creating a Certificate Siging Request (CSR)** zurück und klicken Sie auf **Continue**. -12. Klicken Sie in der Anzeige **Generate** auf die Option **Choose File ... ** und wählen Sie die CSR-Datei aus, die Sie auf Ihrem Desktop gespeichert haben. Klicken Sie anschließend auf **Generate**. - ![Zertifikat generieren](images/generate_certificate.jpg) -13. Nachdem das Zertifikat erstellt wurde, klicken Sie auf **Done**. -14. Klicken Sie in der Anzeige **Push Notifications** auf **Download**, um Ihr Zertifikat herunterzuladen, und klicken Sie anschließend auf **Done**. - ![Download certificate](images/certificate_download.jpg) -15. Navigieren Sie auf Ihrem Mac-Computer zu **Keychain Access > My Certificates** und suchen Sie nach dem neu installierten Zertifikat. Doppelklicken Sie auf das Zertifikat, damit es in Keychain Access installiert wird. -16. Wählen Sie das Zertifikat und den privaten Schlüssel aus und klicken Sie anschließend auf **Export**, um das Zertifikat in das Format zum Austauschen personenbezogener Daten (`.p12`) umzuwandeln. - ![Zertifikat und Schlüssel exportieren](images/keychain_export_key.jpg) -17. Geben Sie im Feld **Save As** einen aussagefähigen Namen für das Zertifikat an. Zum Beispiel `sandbox_apns.p12_certifcate` oder `production_apns.p12` und klicken Sie anschließend auf **Save**. - ![Zertifikat und Schlüssel exportieren](images/certificate_p12v2.jpg) -18. Geben Sie im Feld **Enter a password** ein Kennwort zum Schützen der exportierten Elemente ein und klicken Sie anschließend auf **OK**. Dieses Kennwort können Sie später verwenden, um Ihre APNs-Einstellungen im Push-Dashboard zu konfigurieren.{: #step18} - ![Zertifikat und Schlüssel exportieren](images/export_p12.jpg) -19. **Key Access.app** fordert Sie zum Exportieren Ihres Schlüssels aus der Anzeige **Keychain** auf. Geben Sie Ihr Administratorkennwort für Ihren Mac-Computer ein, um den Export dieser Elemente zuzulassen, und wählen Sie anschließend die Option **Always Allow** aus. Auf Ihrem Desktop wird ein `.p12`-Zertifikat erstellt. - - -##Entwicklungsbereitstellungsprofil erstellen -{: #create-push-credentials-dev-profile} - -Das Bereitstellungsprofil ermittelt anhand der App-ID, auf welchen Geräten Ihre App installiert und ausgeführt werden kann und auf welche Services die App zugreifen kann. Sie erstellen für jede App-ID zwei Bereitstellungsprofile, eines für die Entwicklung und das zweite für die Verteilung. Xcode ermittelt anhand des Entwicklungsbereitstellungsprofils, welche Entwickler den Build für die App durchführen dürfen und welche Geräte in der Anwendung -getestet werden dürfen. - -Stellen Sie sicher, dass die App-ID registriert, für den {{site.data.keyword.mobilepushshort}}-Service aktiviert und für die Verwendung eines SSL-Zertifikats für APNs im Entwicklungs- sowie im Produktionsmodus konfiguriert wurde. - -Erstellen Sie ein Entwicklungsbereitstellungsprofil wie folgt: - -1. Rufen Sie das [Apple Developer-Portal ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com){: new_window} auf, klicken Sie auf **Member Center** und wählen Sie **Certificates, Identifiers & Profiles** aus. -2. Rufen Sie die [Mac Developer Library ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window} auf, navigieren Sie zum Abschnitt **Creating Development Provisioning Profiles** und befolgen Sie die Anweisungen zum Erstellen eines Entwicklungsprofils. -**Hinweis**: Wählen Sie beim Konfigurieren eines Entwicklungsbereitstellungsprofils die folgenden Optionen aus: - * **iOS App Development** - * **For iOS and watchOS apps ** - - - -##Bereitstellungsprofil für Store-Verteilung erstellen -{: #create-push-credentials-apns-distribute_profile} - -Mithilfe des Store-Bereitstellungsprofils können Sie Ihre App für die Verteilung -an den App-Store übergeben. - -1. Rufen Sie das [Apple Developer-Portal ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com){: new_window} auf, klicken Sie auf **Member Center** und wählen Sie **Certificates, Identifiers & Profiles** aus. -2. Doppelklicken Sie auf das heruntergeladene Bereitstellungsprofil, um das Profil in Xcode zu installieren. - -##APNs im {{site.data.keyword.mobilepushshort}}-Dashboard einrichten -{: #create-push-credentials-apns-dashboard} - -Um den {{site.data.keyword.mobilepushshort}}-Service zum Senden von Benachrichtigungen verwenden zu können, laden Sie die SSL-Zertifikate hoch, die für Apple Push Notification Service (APNs) erforderlich sind. Sie können auch die REST-API verwenden, um ein APNs-Zertifikat hochzuladen. - - - -Die für APNs erforderlichen Zertifikate sind `.p12`-Zertifikate. Diese Zertifikate enthalten den privaten Schlüssel und SSL-Zertifikate, die zum Erstellen und Veröffentlichen Ihrer Anwendung erforderlich sind. Sie müssen die Zertifikate über das Member Center der Apple Developer-Website (wofür Sie ein gültiges Apple Developer-Konto benötigen) generieren. Für die Entwicklungsumgebung (Sandbox) und die Produktionsumgebung (Verteilung) sind unterschiedliche Zertifikate erforderlich. - -**Hinweis**: Nachdem sich die `.cer`-Datei in Ihrem Key Chain-Zugriff befindet, exportieren Sie sie auf Ihrem Computer, um ein `.p12`-Zertifikat zu erstellen. - -Weitere Informationen zur Verwendung der APNs finden Sie in der Veröffentlichung [iOS Developer Library: Local and Push Notification Programming Guide ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}. - -Führen Sie die folgenden Schritte aus, um APNs im Push Notification-Services-Dashboard einzurichten: - -1. Wählen Sie im Push Notification-Services-Dashboard die Option **Konfigurieren** aus. -2. Wählen Sie die Option **Mobile** aus, um die Informationen im Formular mit den APNs-Push-Berechtigungsnachweisen zu aktualisieren. -3. Wählen Sie je nach Bedarf **Sandbox** (Entwicklung) oder **Produktion** (Verteilung) aus und laden Sie dann das `p.12`-Zertifikat hoch, das Sie im vorherigen [Schritt](#step18) erstellt haben. - ![Dashboard zum Festlegen von Push-Benachrichtigungen](images/wizard.jpg) -3. Geben Sie in das Feld **Kennwort** das zugehörige Kennwort für die `.p12`-Zertifikatsdatei ein und klicken Sie anschließend auf **Speichern**. - -Nachdem die Zertifikate erfolgreich mit einem gültigen Kennwort hochgeladen wurden, können Sie mit dem Senden von Benachrichtigungen beginnen. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Berechtigungsnachweise für APNs generieren +{: #create-push-credentials-apns} +Letzte Aktualisierung: 16. Januar 2017 +{: .last-updated} + +Apple Push Notification Service (APNs) ermöglicht Anwendungsentwicklern das Senden ferner Benachrichtigungen aus der Bluemix-Instanz des {{site.data.keyword.mobilepushshort}}-Service (d. h. dem Provider) an iOS-Geräte und -Anwendungen. Die Nachrichten werden an eine Zielanwendung auf dem Gerät gesendet. + +Rufen Sie Ihre APNs-Berechtigungsnachweise ab und konfigurieren Sie sie. Die APNs-Zertifikate werden vom {{site.data.keyword.mobilepushshort}}-Service sicher verwaltet und zum Herstellen einer Verbindung zum APNs-Server als Provider verwendet. + + + + + + +##App-IDs registrieren +{: #create-push-credentials-apns-register} + + +Die App-ID (Bundle-ID) ist eine eindeutige Kennung für eine bestimmte Anwendung. Für jede Anwendung ist eine App-ID erforderlich. Services wie der {{site.data.keyword.mobilepushshort}}-Service werden für die App-ID konfiguriert. + +1. Stellen Sie sicher, dass Sie über ein [Apple Developers-Konto ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com/){: new_window} verfügen. +2. Rufen Sie das [Apple Developer-Portal ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com){: new_window} auf, klicken Sie auf **Member Center** und wählen Sie **Certificates, Identifiers & Profiles** aus. +3. Navigieren Sie zum Abschnitt **Registering App IDs** der [Apple Developer Library ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window} und befolgen Sie die Anweisungen zum Registrieren der App-ID. + +Wählen Sie beim Registrieren einer App-ID die folgenden Optionen aus: + +* Push Notifications +![App Services](images/appID_appservices_enablepush.jpg) +* Explicit ID Suffix +![Explicit ID](images/appID_bundleID.jpg) +4. Erstellen Sie ein SSL-Zertifikat zum Entwickeln und Verteilen von APNs. + +##SSL-Zertifikat zum Entwickeln und Verteilen von APNs erstellen +{: #create-push-credentials-apns-ssl} + +Bevor Sie ein APNs-Zertifikat anfordern, müssen Sie zunächst eine Zertifikatssignieranforderung (Certificate Signing Request, CSR) generieren und an die Zertifizierungsstelle (Certificate Authority, CA) von Apple schicken. Die CSR enthält Informationen zum Identifizieren Ihres Unternehmens und beinhaltet Ihren öffentlichen sowie Ihren privaten Schlüssel, den Sie zum Signieren Ihrer Apple-Push-Benachrichtigungen verwenden. Generieren Sie anschließend das SSL-Zertifikat in iOS Developer Portal. Das Zertifikat mit dem zugehörigen öffentlichen und privaten Schlüssel wird in Keychain Access gespeichert. + + + + + + +Sie können APNs auf zwei Weisen verwenden: + +* Sandboxmodus zum Entwickeln und Testen. +* Produktionsmodus zum Verteilen von Anwendungen über den App +Store (oder über die Verteilungsmechanismen anderer Unternehmen. + +Sie müssen separate Zertifikate für Ihre Entwicklungs- und Verteilungsumgebungen anfordern. Die Zertifikate werden einer App-ID für die App zugeordnet, die der Empfänger für ferne Benachrichtigungen ist. Für die Produktion können Sie bis zu zwei Zertifikate erstellen. Bluemix verwendet diese Zertifikate, um eine SSL-Verbindung mit APNs herzustellen. + + + +1. Rufen Sie die [Apple Developer-Website ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com){: new_window} auf, klicken Sie auf **Member Center** und wählen Sie **Certificates, Identifiers & Profiles** aus. +2. Klicken Sie im Bereich **Identifiers** auf **App IDs**. +3. Wählen Sie in der Liste Ihrer App-IDs zunächst die App-ID und anschließend **Einstellungen** aus. +4. Erstellen Sie im Bereich **Push Notifications** zunächst ein SSL-Zertifikat für Entwicklung und anschließend ein SSL-Zertifikat für Produktion. + + ![SSL-Zertifikate für Push Notifications](images/certificate_createssl.jpg) + +5. Wenn die Anzeige zur Erstellung einer Zertifikatssignieranforderung (CSR) **About Creating a Certificate Siging Request (CSR)** angezeigt wird, starten Sie auf Ihrem Mac-Computer die Anwendung **Keychain Access**, um eine Zertifikatssignieranforderung (Certificate Signing Request, CSR) zu erstellen. +6. Wählen Sie im Menü **Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority…** aus. +7. Geben Sie unter **Certificate Information** die E-Mail-Adresse ein, die Ihrem App Developer-Konto zugeordnet ist, sowie einen allgemeinen Namen. Verwenden Sie einen aussagefähigen Namen, der erkennen lässt, ob es sich um ein Zertifikat für die Entwicklung (Sandbox) oder für die Verteilung (Produktion) handelt (z. B. *sandbox-apns-certificate* oder *production-apns-certificate*). +8. Wählen Sie die Option **Save to disk** aus, um die Datei `.certSigningRequest` auf Ihren Desktop herunterzuladen, und klicken Sie anschließend auf **Continue**. +9. Geben Sie in der Menüoption **Save As** einen Namen für die Datei `.certSigningRequest` an und klicken Sie anschließend auf **Save**. +10. Klicken Sie auf **Done**. Sie haben eine CSR erstellt. +11. Kehren Sie zum Fenster **About Creating a Certificate Siging Request (CSR)** zurück und klicken Sie auf **Continue**. +12. Klicken Sie in der Anzeige **Generate** auf die Option **Choose File ... ** und wählen Sie die CSR-Datei aus, die Sie auf Ihrem Desktop gespeichert haben. Klicken Sie anschließend auf **Generate**. + ![Zertifikat generieren](images/generate_certificate.jpg) +13. Nachdem das Zertifikat erstellt wurde, klicken Sie auf **Done**. +14. Klicken Sie in der Anzeige **Push Notifications** auf **Download**, um Ihr Zertifikat herunterzuladen, und klicken Sie anschließend auf **Done**. + ![Download certificate](images/certificate_download.jpg) +15. Navigieren Sie auf Ihrem Mac-Computer zu **Keychain Access > My Certificates** und suchen Sie nach dem neu installierten Zertifikat. Doppelklicken Sie auf das Zertifikat, damit es in Keychain Access installiert wird. +16. Wählen Sie das Zertifikat und den privaten Schlüssel aus und klicken Sie anschließend auf **Export**, um das Zertifikat in das Format zum Austauschen personenbezogener Daten (`.p12`) umzuwandeln. + ![Zertifikat und Schlüssel exportieren](images/keychain_export_key.jpg) +17. Geben Sie im Feld **Save As** einen aussagefähigen Namen für das Zertifikat an. Zum Beispiel `sandbox_apns.p12_certifcate` oder `production_apns.p12` und klicken Sie anschließend auf **Save**. + ![Zertifikat und Schlüssel exportieren](images/certificate_p12v2.jpg) +18. Geben Sie im Feld **Enter a password** ein Kennwort zum Schützen der exportierten Elemente ein und klicken Sie anschließend auf **OK**. Dieses Kennwort können Sie später verwenden, um Ihre APNs-Einstellungen im Push-Dashboard zu konfigurieren.{: #step18} + ![Zertifikat und Schlüssel exportieren](images/export_p12.jpg) +19. **Key Access.app** fordert Sie zum Exportieren Ihres Schlüssels aus der Anzeige **Keychain** auf. Geben Sie Ihr Administratorkennwort für Ihren Mac-Computer ein, um den Export dieser Elemente zuzulassen, und wählen Sie anschließend die Option **Always Allow** aus. Auf Ihrem Desktop wird ein `.p12`-Zertifikat erstellt. + + +##Entwicklungsbereitstellungsprofil erstellen +{: #create-push-credentials-dev-profile} + +Das Bereitstellungsprofil ermittelt anhand der App-ID, auf welchen Geräten Ihre App installiert und ausgeführt werden kann und auf welche Services die App zugreifen kann. Sie erstellen für jede App-ID zwei Bereitstellungsprofile, eines für die Entwicklung und das zweite für die Verteilung. Xcode ermittelt anhand des Entwicklungsbereitstellungsprofils, welche Entwickler den Build für die App durchführen dürfen und welche Geräte in der Anwendung +getestet werden dürfen. + +Stellen Sie sicher, dass die App-ID registriert, für den {{site.data.keyword.mobilepushshort}}-Service aktiviert und für die Verwendung eines SSL-Zertifikats für APNs im Entwicklungs- sowie im Produktionsmodus konfiguriert wurde. + +Erstellen Sie ein Entwicklungsbereitstellungsprofil wie folgt: + +1. Rufen Sie das [Apple Developer-Portal ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com){: new_window} auf, klicken Sie auf **Member Center** und wählen Sie **Certificates, Identifiers & Profiles** aus. +2. Rufen Sie die [Mac Developer Library ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window} auf, navigieren Sie zum Abschnitt **Creating Development Provisioning Profiles** und befolgen Sie die Anweisungen zum Erstellen eines Entwicklungsprofils. +**Hinweis**: Wählen Sie beim Konfigurieren eines Entwicklungsbereitstellungsprofils die folgenden Optionen aus: + * **iOS App Development** + * **For iOS and watchOS apps ** + + + +##Bereitstellungsprofil für Store-Verteilung erstellen +{: #create-push-credentials-apns-distribute_profile} + +Mithilfe des Store-Bereitstellungsprofils können Sie Ihre App für die Verteilung +an den App-Store übergeben. + +1. Rufen Sie das [Apple Developer-Portal ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com){: new_window} auf, klicken Sie auf **Member Center** und wählen Sie **Certificates, Identifiers & Profiles** aus. +2. Doppelklicken Sie auf das heruntergeladene Bereitstellungsprofil, um das Profil in Xcode zu installieren. + +##APNs im {{site.data.keyword.mobilepushshort}}-Dashboard einrichten +{: #create-push-credentials-apns-dashboard} + +Um den {{site.data.keyword.mobilepushshort}}-Service zum Senden von Benachrichtigungen verwenden zu können, laden Sie die SSL-Zertifikate hoch, die für Apple Push Notification Service (APNs) erforderlich sind. Sie können auch die REST-API verwenden, um ein APNs-Zertifikat hochzuladen. + + + +Die für APNs erforderlichen Zertifikate sind `.p12`-Zertifikate. Diese Zertifikate enthalten den privaten Schlüssel und SSL-Zertifikate, die zum Erstellen und Veröffentlichen Ihrer Anwendung erforderlich sind. Sie müssen die Zertifikate über das Member Center der Apple Developer-Website (wofür Sie ein gültiges Apple Developer-Konto benötigen) generieren. Für die Entwicklungsumgebung (Sandbox) und die Produktionsumgebung (Verteilung) sind unterschiedliche Zertifikate erforderlich. + +**Hinweis**: Nachdem sich die `.cer`-Datei in Ihrem Key Chain-Zugriff befindet, exportieren Sie sie auf Ihrem Computer, um ein `.p12`-Zertifikat zu erstellen. + +Weitere Informationen zur Verwendung der APNs finden Sie in der Veröffentlichung [iOS Developer Library: Local and Push Notification Programming Guide ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}. + +Führen Sie die folgenden Schritte aus, um APNs im Push Notification-Services-Dashboard einzurichten: + +1. Wählen Sie im Push Notification-Services-Dashboard die Option **Konfigurieren** aus. +2. Wählen Sie die Option **Mobile** aus, um die Informationen im Formular mit den APNs-Push-Berechtigungsnachweisen zu aktualisieren. +3. Wählen Sie je nach Bedarf **Sandbox** (Entwicklung) oder **Produktion** (Verteilung) aus und laden Sie dann das `p.12`-Zertifikat hoch, das Sie im vorherigen [Schritt](#step18) erstellt haben. + ![Dashboard zum Festlegen von Push-Benachrichtigungen](images/wizard.jpg) +3. Geben Sie in das Feld **Kennwort** das zugehörige Kennwort für die `.p12`-Zertifikatsdatei ein und klicken Sie anschließend auf **Speichern**. + +Nachdem die Zertifikate erfolgreich mit einem gültigen Kennwort hochgeladen wurden, können Sie mit dem Senden von Benachrichtigungen beginnen. diff --git a/services/mobilepush/nl/de/t_push_provider_safari.md b/services/mobilepush/nl/de/t_push_provider_safari.md index 3c9dca20f..a57250a46 100644 --- a/services/mobilepush/nl/de/t_push_provider_safari.md +++ b/services/mobilepush/nl/de/t_push_provider_safari.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Berechtigungsnachweise für Web-Browser konfigurieren -{: #configure-credential-for-browsers} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - -Der IBM Service {{site.data.keyword.mobilepushshort}} verfügt nun über erweiterte Funktionen zum Senden von Benachrichtigungen an Ihren Browser. - -Die Website-URL oder der Domänenname Ihrer Website wird vom {{site.data.keyword.mobilepushshort}}-Service benötigt, um die Anforderungen zu identifizieren, die zugelassen werden müssen. Jede Instanz des {{site.data.keyword.mobilepushshort}}-Service unterstützt nur einen Domänennamen. Stellen Sie daher sicher, dass für Chrome, Firefox und Safari der gleiche Wert festgelegt ist. - -In Chrome- und Safari-Browsern sind zusätzliche Konfigurationsschritte für Web-Push erforderlich. Sie benötigen einen FCM-API-Schlüssel, da Nachrichten in Chrome über einen FCM-Endpunkt gesendet werden. Informationen zum Abrufen Ihres FCM-API-Schlüssels finden Sie im Abschnitt [Berechtigungsnachweise für FCM generieren](t_push_provider_android.html). - - - -##Web-Push für Chrome und Firefox konfigurieren -{: #config-chrome-firefox} - -1. Wählen Sie in der Push-Dashboardanzeige **Konfigurieren** aus. -2. Wählen Sie die Webregisterkarte aus. - ![WebPush-Konfigurationen](images/webpush_configure.jpg) -3. Konfigurieren Sie den FCM/GCM-API-Schlüssel und die URL Ihrer Webseite, die für den Empfang von Push-Benachrichtigungen registriert wird. -4. Klicken Sie auf **Speichern**. -5. Nächste Schritte: [Benachrichtigungen für Google Chrome- und Mozilla Firefox-Browser aktivieren](c_enable_push.html). - - -## Web-Push für Safari konfigurieren -{: #configure-safari} - -Für den {{site.data.keyword.mobilepushshort}}-Service wird die Version Safari 10.0 unterstützt. Sie müssen zunächst über Ihr Apple Developer-Konto ein Zertifikat generieren, bevor Sie Ihren Browser für den Empfang von Benachrichtigungen konfigurieren. - -### Zertifikat generieren -{: #certificate-generation} - -Stellen Sie sicher, dass Sie über ein Apple Developer-Konto verfügen. Sie müssen eine 'Website Push ID' registrieren und ein Zertifikat generieren, um Ihren Safari-Browser für den Empfang von Benachrichtigungen zu konfigurieren. Führen Sie zur Einführung die folgenden Schritte aus. - -1. Klicken Sie im Apple Developer Member Center auf **Certificates, ID & Profiles**. -2. Klicken Sie auf **Identifiers** und anschließend auf **Website Push IDs**. -3. Erstellen Sie durch Auswahl des Plussymbols einen neuen Eintrag. - ![Push-Dashboard](images/safari_1.jpg) - -4. Geben Sie in der Anzeige 'Register Website Push ID' eine entsprechende Beschreibung der Website Push ID sowie eine ID an. Es ist empfehlenswert, das Namensformat für reverse Domänen zu verwenden, das mit 'web' beginnt. Beispiel: web.com.example.dailyweatherreports. -5. Registrieren Sie die 'Website Push ID'. Sie haben jetzt Ihre Website Push ID -6. Wählen Sie **Edit** aus, um ein Zertifikat für die Verwendung für die Website Push ID zu erstellen. -7. Geben Sie im Fenster 'Certificate Assistant' als Zertifikatsinformationen Ihre E-Mail-ID und einen allgemeinen Namen an. Lassen Sie das Feld für die E-Mail-Adresse der Zertifizierungsstelle leer. -8. Klicken Sie auf **Save to disk** und wählen Sie **Continue** aus. -9. Wählen Sie für die Speicherung des Zertifikats einen entsprechenden Ordner aus. -10. Wählen Sie die auf der Platte erstellte Datei `.certSigningRequest` aus, wenn Sie vom Assistenten zum Generieren des Zertifikats aufgefordert werden. Stellen Sie sicher, dass Sie das im `.cer`-Format erstellte Website-Push-Zertifikat herunterladen. -11. Öffnen Sie das Zertifikat im Tool KeyChain Access. Klicken Sie mit der rechten Maustaste und exportieren Sie es als p12-Zertifikat. Beachten Sie das während der Generierung des p12-Zertifikats bereitgestellte Kennwort. - - -### Für Benachrichtigungen konfigurieren - {: #configuration-notification} - -Nach dem Generieren des Zertifikats können Sie den Service für das Senden von Benachrichtigungen an Safari konfigurieren. - -Führen Sie die folgenden Schritte aus: - -1. Klicken Sie im Dashboard des Push Notifications-Service auf **Configure**. -2. Wählen Sie die Webregisterkarte aus. -3. Aktualisieren Sie im Abschnitt 'Safari Push' das Formular mit den erforderlichen Informationen. - - **Website Name**: Dies ist der Name, den Sie im Benachrichtigungscenter angegeben haben. - - **Website Push ID**: Aktualisieren Sie den Wert durch die umgekehrte Zeichenfolge der Domäne für Ihre Website Push ID. Beispiel: web.com.example.www. - - **Website URL**: Geben Sie die URL der Website für die Subskription von Push-Benachrichtigungen an. Beispiel: https://www.example.com. - - **Allowed Domains**: Dies ist ein optionaler Parameter. Dies ist die Liste der Websites, die eine Berechtigung vom Benutzer anfordern. Stellen Sie sicher, dass es sich bei den URLs um durch Kommas getrennte Werte handelt. Beachten Sie, dass der Wert für die Website-URL verwendet wird, wenn an dieser Stelle nichts angegeben wird. - - **URL Format String**: Die URL für die Auflösung, wenn die Benachrichtigung angeklickt wird. Beispiel: ["https://www.example.com"]. Stellen Sie sicher, dass die URL das Schema http oder https verwendet. - - **Safari web push certificate**: Laden Sie das .p12-Zertifikat hoch und geben Sie ein Kennwort an. -4. Klicken Sie auf **Speichern**. - -![Push-Dashboard](images/push_configure_safari.jpg) - -Sie können jetzt Push-Benachrichtigungen an den Safari-Browser senden. - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Berechtigungsnachweise für Web-Browser konfigurieren +{: #configure-credential-for-browsers} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + +Der IBM Service {{site.data.keyword.mobilepushshort}} verfügt nun über erweiterte Funktionen zum Senden von Benachrichtigungen an Ihren Browser. + +Die Website-URL oder der Domänenname Ihrer Website wird vom {{site.data.keyword.mobilepushshort}}-Service benötigt, um die Anforderungen zu identifizieren, die zugelassen werden müssen. Jede Instanz des {{site.data.keyword.mobilepushshort}}-Service unterstützt nur einen Domänennamen. Stellen Sie daher sicher, dass für Chrome, Firefox und Safari der gleiche Wert festgelegt ist. + +In Chrome- und Safari-Browsern sind zusätzliche Konfigurationsschritte für Web-Push erforderlich. Sie benötigen einen FCM-API-Schlüssel, da Nachrichten in Chrome über einen FCM-Endpunkt gesendet werden. Informationen zum Abrufen Ihres FCM-API-Schlüssels finden Sie im Abschnitt [Berechtigungsnachweise für FCM generieren](t_push_provider_android.html). + + + +## Web-Push für Chrome und Firefox konfigurieren +{: #config-chrome-firefox} + +1. Wählen Sie in der Push-Dashboardanzeige **Konfigurieren** aus. +2. Wählen Sie die Webregisterkarte aus. + ![WebPush-Konfigurationen](images/webpush_configure.jpg) +3. Konfigurieren Sie den FCM/GCM-API-Schlüssel und die URL Ihrer Webseite, die für den Empfang von Push-Benachrichtigungen registriert wird. +4. Klicken Sie auf **Speichern**. +5. Nächste Schritte: [Benachrichtigungen für Google Chrome- und Mozilla Firefox-Browser aktivieren](c_enable_push.html). + + +## Web-Push für Safari konfigurieren +{: #configure-safari} + +Für den {{site.data.keyword.mobilepushshort}}-Service wird die Version Safari 10.0 unterstützt. Sie müssen zunächst über Ihr Apple Developer-Konto ein Zertifikat generieren, bevor Sie Ihren Browser für den Empfang von Benachrichtigungen konfigurieren. + +### Zertifikat generieren +{: #certificate-generation} + +Stellen Sie sicher, dass Sie über ein Apple Developer-Konto verfügen. Sie müssen eine 'Website Push ID' registrieren und ein Zertifikat generieren, um Ihren Safari-Browser für den Empfang von Benachrichtigungen zu konfigurieren. Führen Sie zur Einführung die folgenden Schritte aus. + +1. Klicken Sie im Apple Developer Member Center auf **Certificates, ID & Profiles**. +2. Klicken Sie auf **Identifiers** und anschließend auf **Website Push IDs**. +3. Erstellen Sie durch Auswahl des Plussymbols einen neuen Eintrag. + ![Push-Dashboard](images/safari_1.jpg) + +4. Geben Sie in der Anzeige 'Register Website Push ID' eine entsprechende Beschreibung der Website Push ID sowie eine ID an. Es ist empfehlenswert, das Namensformat für reverse Domänen zu verwenden, das mit 'web' beginnt. Beispiel: web.com.example.dailyweatherreports. +5. Registrieren Sie die 'Website Push ID'. Sie haben jetzt Ihre Website Push ID +6. Wählen Sie **Edit** aus, um ein Zertifikat für die Verwendung für die Website Push ID zu erstellen. +7. Geben Sie im Fenster 'Certificate Assistant' als Zertifikatsinformationen Ihre E-Mail-ID und einen allgemeinen Namen an. Lassen Sie das Feld für die E-Mail-Adresse der Zertifizierungsstelle leer. +8. Klicken Sie auf **Save to disk** und wählen Sie **Continue** aus. +9. Wählen Sie für die Speicherung des Zertifikats einen entsprechenden Ordner aus. +10. Wählen Sie die auf der Platte erstellte Datei `.certSigningRequest` aus, wenn Sie vom Assistenten zum Generieren des Zertifikats aufgefordert werden. Stellen Sie sicher, dass Sie das im `.cer`-Format erstellte Website-Push-Zertifikat herunterladen. +11. Öffnen Sie das Zertifikat im Tool KeyChain Access. Klicken Sie mit der rechten Maustaste und exportieren Sie es als p12-Zertifikat. Beachten Sie das während der Generierung des p12-Zertifikats bereitgestellte Kennwort. + + +### Für Benachrichtigungen konfigurieren + {: #configuration-notification} + +Nach dem Generieren des Zertifikats können Sie den Service für das Senden von Benachrichtigungen an Safari konfigurieren. + +Führen Sie die folgenden Schritte aus: + +1. Klicken Sie im Dashboard des Push Notifications-Service auf **Configure**. +2. Wählen Sie die Webregisterkarte aus. +3. Aktualisieren Sie im Abschnitt 'Safari Push' das Formular mit den erforderlichen Informationen. + - **Website Name**: Dies ist der Name, den Sie im Benachrichtigungscenter angegeben haben. + - **Website Push ID**: Aktualisieren Sie den Wert durch die umgekehrte Zeichenfolge der Domäne für Ihre Website Push ID. Beispiel: web.com.example.www. + - **Website URL**: Geben Sie die URL der Website für die Subskription von Push-Benachrichtigungen an. Beispiel: https://www.example.com. + - **Allowed Domains**: Dies ist ein optionaler Parameter. Dies ist die Liste der Websites, die eine Berechtigung vom Benutzer anfordern. Stellen Sie sicher, dass es sich bei den URLs um durch Kommas getrennte Werte handelt. Beachten Sie, dass der Wert für die Website-URL verwendet wird, wenn an dieser Stelle nichts angegeben wird. + - **URL Format String**: Die URL für die Auflösung, wenn die Benachrichtigung angeklickt wird. Beispiel: ["https://www.example.com"]. Stellen Sie sicher, dass die URL das Schema http oder https verwendet. + - **Safari web push certificate**: Laden Sie das .p12-Zertifikat hoch und geben Sie ein Kennwort an. +4. Klicken Sie auf **Speichern**. + +![Push-Dashboard](images/push_configure_safari.jpg) + +Sie können jetzt Push-Benachrichtigungen an den Safari-Browser senden. + + diff --git a/services/mobilepush/nl/de/t_push_tagsmain.md b/services/mobilepush/nl/de/t_push_tagsmain.md index bfd86798b..d382656a4 100644 --- a/services/mobilepush/nl/de/t_push_tagsmain.md +++ b/services/mobilepush/nl/de/t_push_tagsmain.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Tagbasierte Benachrichtigungen -{: #push-ios-main-tags} -Letzte Aktualisierung: 16. Januar 2017 -{: .last-updated} - -Tagbasierte Benachrichtigungen haben all diejenigen Geräte zum Ziel, die einen bestimmten Tag subskribiert haben. Sie können Tags definieren und anschließend mithilfe der Tags Nachrichten senden und empfangen. - -Sie müssen zunächst die Tags für die Anwendung erstellen, die Tagsubskriptionen einrichten und anschließend die tagbasierten Benachrichtigungen starten. Zum Senden einer tagbasierten Benachrichtigung mithilfe der [REST-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} müssen Sie sicherstellen, dass während der Übergabe an die Ressource der Nachricht die Tagnamen (tagNames) angegeben werden. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Tagbasierte Benachrichtigungen +{: #push-ios-main-tags} +Letzte Aktualisierung: 16. Januar 2017 +{: .last-updated} + +Tagbasierte Benachrichtigungen haben all diejenigen Geräte zum Ziel, die einen bestimmten Tag subskribiert haben. Sie können Tags definieren und anschließend mithilfe der Tags Nachrichten senden und empfangen. + +Sie müssen zunächst die Tags für die Anwendung erstellen, die Tagsubskriptionen einrichten und anschließend die tagbasierten Benachrichtigungen starten. Zum Senden einer tagbasierten Benachrichtigung mithilfe der [REST-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} müssen Sie sicherstellen, dass während der Übergabe an die Ressource der Nachricht die Tagnamen (tagNames) angegeben werden. diff --git a/services/mobilepush/nl/de/t_restapi.md b/services/mobilepush/nl/de/t_restapi.md index 9e47448c7..87efa3e86 100644 --- a/services/mobilepush/nl/de/t_restapi.md +++ b/services/mobilepush/nl/de/t_restapi.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# REST-APIs verwenden -{: #push-api-rest} -Letzte Aktualisierung: 16. Januar 2017 -{: .last-updated} - -Sie können eine REST-API (REST = Representational State Transfer; API = Application Program Interface) für Push-Benachrichtigungen verwenden. Sie können auch das SDK und die [Push-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} verwenden, um Ihre Clientanwendungen weiter zu entwickeln. - -Mit der Push-REST-API können Back-End-Serveranwendungen und -Clients auf Funktionen für Push-Benachrichtigungen zugreifen. - -- Geräteregistrierungen -- Registrierungen -- Nachrichten -- Subskriptionen -- Tags -- Webhooks - -Führen Sie die folgenden Schritte aus, um die Basis-URL für die REST-API abzurufen: - -1. Erstellen Sie im Bluemix®-Katalog im Abschnitt 'Boilerplates' eine Back-End-Anwendung. Wählen Sie dazu 'MobileFirst Services Starter' aus. Hierdurch wird der {{site.data.keyword.mobilepushshort}}-Service an die Anwendung gebunden. Sie können auch eine Serviceinstanz von Push erstellen und diese ungebunden lassen. -1. Navigieren Sie auf der Hauptseite des Bluemix-Dashboards zum Bereich **Anwendungen** und wählen Sie dort Ihre App aus. -3. Klicken Sie auf **Mobile Systemerweiterungen**. Die Werte für die Route und für die App-GUID werden am Anfang der Detailseite für Ihre App angezeigt. In der Anzeige 'Berechtigungsnachweise anzeigen' werden Informationen über 'AppSecret' angezeigt. Für manche APIs können Sie den geheimen Anwendungsschlüssel sowie den geheimen Clientschlüssel über 'Mobile Systemerweiterungen' abrufen. - -Sie können auch die Befehlszeile verwenden, um die Serviceberechtigungsnachweise abzurufen: - -``` - cf create-service-key {push_instance_name} {key_name} - - cf service-key {push_instance_name} {key_name} -``` - {: codeblock} - -## Sprachenheader akzeptieren -{: #push-api-rest-accept} - -Der Header für das Akzeptieren der Sprache ("Accept-Language") gibt an, welche Sprache für die Fehlernachrichten verwendet werden soll, die die Ausgabe der [Push-REST-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} bilden. Folgende Sprachen werden für die Fehlernachrichten unterstützt: vereinfachtes Chinesisch, traditionelles Chinesisch, Englisch (US), Deutsch, Französisch, Italienisch, Japanisch, Koreanisch, Portugiesisch und Spanisch. - -## appSecret -{: #push-api-rest-secret} - -Beim Binden einer Anwendung an {{site.data.keyword.mobilepushshort}} generiert der Service den eindeutigen Schlüssel 'appSecret' und übergibt diesen mit dem Antwortheader. Wenn Sie die REST-API von IBM {{site.data.keyword.mobilepushshort}} for Bluemix verwenden, finden Sie in der Referenz für die REST-API Informationen dazu, welche APIs geschützt werden müssen. Weitere Informationen finden Sie in der [Push-REST-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window}. - -Der Anforderungsheader muss 'appSecret' enthalten. Andernfalls gibt der Server den Fehlercode 401 ('Unauthorized Error') zurück. Beim Hinzufügen von {{site.data.keyword.mobilepushshort}} zu einer Anwendung wird eine spezifische App-ID erstellt. Sie erhalten als Teil der Antwort einen Header mit dem Namen 'appSecret', der für die Erstellung von Tags oder das Senden von Nachrichten verwendet wird. Diese Operation erfolgt über Services im Katalog oder in der Boilerplate. - -Gehen Sie wie folgt vor, um den Wert 'appSecret' abzurufen: - -1. Klicken Sie auf den *App-Namen*, der an den Push-Service gebunden ist. -2. Klicken Sie auf den Link **Berechtigungsnachweise anzeigen**, um 'appSecret' (App-ID) anzuzeigen. - -In der Anzeige **Berechtigungsnachweise anzeigen** werden Informationen zu 'appSecret' angezeigt: -``` - { - "imfpush_Dev": [ - { - "name": "testapp1", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": { - "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", - "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", - "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", - } - } - ] - } -``` - {: codeblock} - - -##Filter für Push-REST-APIs -{: #push-api-rest-filters} - -Anhand von Filtern wird ein Suchkriterium definiert, mit dem der Umfang der Daten beschränkt wird, die von einer GET-API von {{site.data.keyword.mobilepushshort}} zurückgegeben werden. Wenden Sie die Filter auf das Ergebnis der Abrufoperation (Get) an, die Sie filtern möchten. Der Filter beschränkt die Anzahl der Einträge im Ergebnis. Sie können beispielsweise einen Filter verwenden, um Tags zu suchen, deren Name mit 'test' beginnt. - -Filter können unter Verwendung der folgenden Syntax generiert werden: - -**name**: Der Name des Felds, auf das der Filter angewendet wird. - -**operator**: Entweder == (Exakte Übereinstimmung) oder =@ (Enthält Teilzeichenfolge); dadurch wird die zu verwendende Filterübereinstimmung beschrieben. - -**expression**: Die Werte, die in das Ergebnis einzuschließen sind. - -Wenn ein Komma und ein Backslash in einem Ausdruck (expression) angezeigt werden, muss der Backslash mit Escapezeichen verwendet werden. - -Bei der Verwendung mehrerer Filter können diese mithilfe der Logik AND bzw. OR miteinander kombiniert werden. - -- Verwenden Sie bei der Logik AND mehrere Filter in der Abfrage. -- Verwenden Sie bei der Logik OR innerhalb des Filterausdrucks ein Komma (,). -- Bei Verwendung beider Logiken (AND und OR) kann eine einzelne Abfrage beide Logiken aufweisen. Jeder Filter wird jedoch einzeln ausgewertet, bevor eine Kombination der Filter im Ausdruck AND erfolgt. - -Für die GET-API des Geräts werden folgende Kombinationen unterstützt: --Der Name ist das Feld 'platform'. -- Der Operator (außer für 'platform') kann == oder =@ lauten. -- Für 'platform' muss der Operator == lauten. Wird der Operator =@ verwendet, kann es sich bei dem Wert um eine Teilzeichenfolge handeln. -- Wenn == verwendet wird, muss es sich bei dem Wert um eine Zeichenfolge handeln, die genau übereinstimmt. - -Für die GET-API der Subskription werden folgende Kombinationen unterstützt: - -- Bei dem Namen kann es sich um das Feld 'tagName' oder das Feld 'deviceId' handeln. -- Der Operator (außer für 'platform') kann == oder =@ lauten. -- Für 'platform' muss der Operator == lauten. -- Wird der Operator =@ verwendet, kann es sich bei dem Wert um eine Teilzeichenfolge handeln. Wenn der Operator == verwendet wird, muss es sich bei dem Wert um eine Zeichenfolge handeln, die genau übereinstimmt. -- Für die GET-API des Tags werden folgende Kombinationen unterstützt: -- Der Name kann das Feld 'name' oder 'description' sein. -- Wird der Operator =@ verwendet, kann es sich bei dem Wert um eine Teilzeichenfolge handeln. -- Wenn == verwendet wird, muss es sich bei dem Wert um eine Zeichenfolge handeln, die genau übereinstimmt. - - -##{{site.data.keyword.mobilepushshort}} - Antwortcodes -{: #push-api-response-codes} - -Status: 405 Method Not Allowed - Es wird die passende Methode erwartet. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# REST-APIs verwenden +{: #push-api-rest} +Letzte Aktualisierung: 16. Januar 2017 +{: .last-updated} + +Sie können eine REST-API (REST = Representational State Transfer; API = Application Program Interface) für Push-Benachrichtigungen verwenden. Sie können auch das SDK und die [Push-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} verwenden, um Ihre Clientanwendungen weiter zu entwickeln. + +Mit der Push-REST-API können Back-End-Serveranwendungen und -Clients auf Funktionen für Push-Benachrichtigungen zugreifen. + +- Geräteregistrierungen +- Registrierungen +- Nachrichten +- Subskriptionen +- Tags +- Webhooks + +Führen Sie die folgenden Schritte aus, um die Basis-URL für die REST-API abzurufen: + +1. Erstellen Sie im Bluemix®-Katalog im Abschnitt 'Boilerplates' eine Back-End-Anwendung. Wählen Sie dazu 'MobileFirst Services Starter' aus. Hierdurch wird der {{site.data.keyword.mobilepushshort}}-Service an die Anwendung gebunden. Sie können auch eine Serviceinstanz von Push erstellen und diese ungebunden lassen. +1. Navigieren Sie auf der Hauptseite des Bluemix-Dashboards zum Bereich **Anwendungen** und wählen Sie dort Ihre App aus. +3. Klicken Sie auf **Mobile Systemerweiterungen**. Die Werte für die Route und für die App-GUID werden am Anfang der Detailseite für Ihre App angezeigt. In der Anzeige 'Berechtigungsnachweise anzeigen' werden Informationen über 'AppSecret' angezeigt. Für manche APIs können Sie den geheimen Anwendungsschlüssel sowie den geheimen Clientschlüssel über 'Mobile Systemerweiterungen' abrufen. + +Sie können auch die Befehlszeile verwenden, um die Serviceberechtigungsnachweise abzurufen: + +``` + cf create-service-key {push_instance_name} {key_name} + + cf service-key {push_instance_name} {key_name} +``` + {: codeblock} + +## Sprachenheader akzeptieren +{: #push-api-rest-accept} + +Der Header für das Akzeptieren der Sprache ("Accept-Language") gibt an, welche Sprache für die Fehlernachrichten verwendet werden soll, die die Ausgabe der [Push-REST-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window} bilden. Folgende Sprachen werden für die Fehlernachrichten unterstützt: vereinfachtes Chinesisch, traditionelles Chinesisch, Englisch (US), Deutsch, Französisch, Italienisch, Japanisch, Koreanisch, Portugiesisch und Spanisch. + +## appSecret +{: #push-api-rest-secret} + +Beim Binden einer Anwendung an {{site.data.keyword.mobilepushshort}} generiert der Service den eindeutigen Schlüssel 'appSecret' und übergibt diesen mit dem Antwortheader. Wenn Sie die REST-API von IBM {{site.data.keyword.mobilepushshort}} for Bluemix verwenden, finden Sie in der Referenz für die REST-API Informationen dazu, welche APIs geschützt werden müssen. Weitere Informationen finden Sie in der [Push-REST-API ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window}. + +Der Anforderungsheader muss 'appSecret' enthalten. Andernfalls gibt der Server den Fehlercode 401 ('Unauthorized Error') zurück. Beim Hinzufügen von {{site.data.keyword.mobilepushshort}} zu einer Anwendung wird eine spezifische App-ID erstellt. Sie erhalten als Teil der Antwort einen Header mit dem Namen 'appSecret', der für die Erstellung von Tags oder das Senden von Nachrichten verwendet wird. Diese Operation erfolgt über Services im Katalog oder in der Boilerplate. + +Gehen Sie wie folgt vor, um den Wert 'appSecret' abzurufen: + +1. Klicken Sie auf den *App-Namen*, der an den Push-Service gebunden ist. +2. Klicken Sie auf den Link **Berechtigungsnachweise anzeigen**, um 'appSecret' (App-ID) anzuzeigen. + +In der Anzeige **Berechtigungsnachweise anzeigen** werden Informationen zu 'appSecret' angezeigt: +``` + { + "imfpush_Dev": [ + { + "name": "testapp1", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": { + "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", + "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", + "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", + } + } + ] + } +``` + {: codeblock} + + +##Filter für Push-REST-APIs +{: #push-api-rest-filters} + +Anhand von Filtern wird ein Suchkriterium definiert, mit dem der Umfang der Daten beschränkt wird, die von einer GET-API von {{site.data.keyword.mobilepushshort}} zurückgegeben werden. Wenden Sie die Filter auf das Ergebnis der Abrufoperation (Get) an, die Sie filtern möchten. Der Filter beschränkt die Anzahl der Einträge im Ergebnis. Sie können beispielsweise einen Filter verwenden, um Tags zu suchen, deren Name mit 'test' beginnt. + +Filter können unter Verwendung der folgenden Syntax generiert werden: + +**name**: Der Name des Felds, auf das der Filter angewendet wird. + +**operator**: Entweder == (Exakte Übereinstimmung) oder =@ (Enthält Teilzeichenfolge); dadurch wird die zu verwendende Filterübereinstimmung beschrieben. + +**expression**: Die Werte, die in das Ergebnis einzuschließen sind. + +Wenn ein Komma und ein Backslash in einem Ausdruck (expression) angezeigt werden, muss der Backslash mit Escapezeichen verwendet werden. + +Bei der Verwendung mehrerer Filter können diese mithilfe der Logik AND bzw. OR miteinander kombiniert werden. + +- Verwenden Sie bei der Logik AND mehrere Filter in der Abfrage. +- Verwenden Sie bei der Logik OR innerhalb des Filterausdrucks ein Komma (,). +- Bei Verwendung beider Logiken (AND und OR) kann eine einzelne Abfrage beide Logiken aufweisen. Jeder Filter wird jedoch einzeln ausgewertet, bevor eine Kombination der Filter im Ausdruck AND erfolgt. + +Für die GET-API des Geräts werden folgende Kombinationen unterstützt: +-Der Name ist das Feld 'platform'. +- Der Operator (außer für 'platform') kann == oder =@ lauten. +- Für 'platform' muss der Operator == lauten. Wird der Operator =@ verwendet, kann es sich bei dem Wert um eine Teilzeichenfolge handeln. +- Wenn == verwendet wird, muss es sich bei dem Wert um eine Zeichenfolge handeln, die genau übereinstimmt. + +Für die GET-API der Subskription werden folgende Kombinationen unterstützt: + +- Bei dem Namen kann es sich um das Feld 'tagName' oder das Feld 'deviceId' handeln. +- Der Operator (außer für 'platform') kann == oder =@ lauten. +- Für 'platform' muss der Operator == lauten. +- Wird der Operator =@ verwendet, kann es sich bei dem Wert um eine Teilzeichenfolge handeln. Wenn der Operator == verwendet wird, muss es sich bei dem Wert um eine Zeichenfolge handeln, die genau übereinstimmt. +- Für die GET-API des Tags werden folgende Kombinationen unterstützt: +- Der Name kann das Feld 'name' oder 'description' sein. +- Wird der Operator =@ verwendet, kann es sich bei dem Wert um eine Teilzeichenfolge handeln. +- Wenn == verwendet wird, muss es sich bei dem Wert um eine Zeichenfolge handeln, die genau übereinstimmt. + + +##{{site.data.keyword.mobilepushshort}} - Antwortcodes +{: #push-api-response-codes} + +Status: 405 Method Not Allowed - Es wird die passende Methode erwartet. diff --git a/services/mobilepush/nl/de/t_sandbox.md b/services/mobilepush/nl/de/t_sandbox.md index 9b60a45f2..93da9c28f 100644 --- a/services/mobilepush/nl/de/t_sandbox.md +++ b/services/mobilepush/nl/de/t_sandbox.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Sandboxmodus und Produktionsmodus -{: #push-sandboxandproduction-modes} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - -Sie können {{site.data.keyword.mobilepushshort}} in jedem der beiden folgenden Modi ausführen: 'Sandbox' oder 'Produktion'. 'Sandbox' ist eine eigenständige Testumgebung für die Entwicklung und das Testen der Integration der Push-API mit dem Push-Service der Serveranwendung. - -Konfigurieren Sie die Modi 'Sandbox' und 'Produktion' über das Push-Dashboard. Sie können bei der Betriebsart des Push-Service mithilfe der [Push-REST-API](https://mobile.{DomainName}/imfpush/){: new_window} zwischen dem Sandbox- und dem Produktionsmodus wechseln. Standardmäßig ist der Sandboxmodus aktiviert. Auch wenn Sie zwischen den Modi wechseln können, werden die Tags, Geräte und Subskriptionen nicht von den Modi gemeinsam genutzt. - -Wenn Sie für die Bereitstellung der Anwendung in einer Liveumgebung bereit sind, wählen Sie mit der [Push-REST-API](https://mobile.{DomainName}/imfpush/){: new_window} den Produktionsmodus aus. - -Führen Sie die folgenden Schritte durch, um beim Betriebsmodus des Push-Service vom Sandboxmodus in den Produktionsmodus zu wechseln: - -1. Verwenden Sie den REST-API-Aufruf 'PUT' zum Festlegen der Einstellungen für die Anwendungs-ID (ApplicationID). -2. Überprüfen Sie im JSON-Hauptteil, dass der Modus gewechselt wurde, indem Sie den REST-API-Aufruf ['GET' zum Abrufen der Einstellungen der Anwendungs-ID (ApplicationID)](https://mobile.{DomainName}/imfpush/){: new_window} verwenden. Die erwartete Antwort ist "mode": "PRODUCTION". -```{ - "mode": "PRODUCTION" - } -``` - {: codeblock} -1. Nachdem der Umgebungsmodus gewechselt wurde, führen Sie den Client-Code erneut aus, um Ihr Gerät für den Produktionsmodus zu registrieren. - -Informationen zur REST-API finden Sie in [REST-APIs verwenden](t_restapi.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Sandboxmodus und Produktionsmodus +{: #push-sandboxandproduction-modes} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + +Sie können {{site.data.keyword.mobilepushshort}} in jedem der beiden folgenden Modi ausführen: 'Sandbox' oder 'Produktion'. 'Sandbox' ist eine eigenständige Testumgebung für die Entwicklung und das Testen der Integration der Push-API mit dem Push-Service der Serveranwendung. + +Konfigurieren Sie die Modi 'Sandbox' und 'Produktion' über das Push-Dashboard. Sie können bei der Betriebsart des Push-Service mithilfe der [Push-REST-API](https://mobile.{DomainName}/imfpush/){: new_window} zwischen dem Sandbox- und dem Produktionsmodus wechseln. Standardmäßig ist der Sandboxmodus aktiviert. Auch wenn Sie zwischen den Modi wechseln können, werden die Tags, Geräte und Subskriptionen nicht von den Modi gemeinsam genutzt. + +Wenn Sie für die Bereitstellung der Anwendung in einer Liveumgebung bereit sind, wählen Sie mit der [Push-REST-API](https://mobile.{DomainName}/imfpush/){: new_window} den Produktionsmodus aus. + +Führen Sie die folgenden Schritte durch, um beim Betriebsmodus des Push-Service vom Sandboxmodus in den Produktionsmodus zu wechseln: + +1. Verwenden Sie den REST-API-Aufruf 'PUT' zum Festlegen der Einstellungen für die Anwendungs-ID (ApplicationID). +2. Überprüfen Sie im JSON-Hauptteil, dass der Modus gewechselt wurde, indem Sie den REST-API-Aufruf ['GET' zum Abrufen der Einstellungen der Anwendungs-ID (ApplicationID)](https://mobile.{DomainName}/imfpush/){: new_window} verwenden. Die erwartete Antwort ist "mode": "PRODUCTION". +```{ + "mode": "PRODUCTION" + } +``` + {: codeblock} +1. Nachdem der Umgebungsmodus gewechselt wurde, führen Sie den Client-Code erneut aus, um Ihr Gerät für den Produktionsmodus zu registrieren. + +Informationen zur REST-API finden Sie in [REST-APIs verwenden](t_restapi.html). diff --git a/services/mobilepush/nl/de/t_send_push_notifications.md b/services/mobilepush/nl/de/t_send_push_notifications.md index f2d0b8c5a..c759a6253 100644 --- a/services/mobilepush/nl/de/t_send_push_notifications.md +++ b/services/mobilepush/nl/de/t_send_push_notifications.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Einfache Push-Benachrichtigungen senden -{: #push-send-notifications} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - -Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen (ohne Tags, Badges, zusätzliche Nutzdaten oder Audiodateien) senden. - -Führen Sie die hier aufgeführten Schritt aus, um einfache Push-Benachrichtigungen zu senden: - -1. Wählen Sie **Benachrichtigungen senden** aus und anschließend die entsprechende Option für **Senden an**. - -**Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Benachrichtigungen. - -![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) -2. Geben Sie in das Feld **Nachricht** Ihre Nachricht ein und klicken Sie dann auf **Senden**. - -3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. Die folgende Abbildung zeigt ein Alertfeld bei der Verarbeitung einer {{site.data.keyword.mobilepushshort}} im Vordergrund eines Android- bzw. iOS-Geräts. - -![Push-Benachrichtigung im Vordergrund auf einem Android-Gerät](images/Android_Screenshot.jpg) - -![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) - -Der folgende Screenshot zeigt eine Push-Benachrichtigung im Hintergrund auf einem Android-Gerät. - -![Push-Benachrichtigung im Hintergrund auf einem Android-Gerät](images/background.jpg) +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Einfache Push-Benachrichtigungen senden +{: #push-send-notifications} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + +Nach dem Entwickeln Ihrer Anwendungen können Sie einfache Push-Benachrichtigungen (ohne Tags, Badges, zusätzliche Nutzdaten oder Audiodateien) senden. + +Führen Sie die hier aufgeführten Schritt aus, um einfache Push-Benachrichtigungen zu senden: + +1. Wählen Sie **Benachrichtigungen senden** aus und anschließend die entsprechende Option für **Senden an**. + +**Hinweis**: Wenn Sie die Option **Alle Geräte** auswählen, erhalten alle Geräte, die Push-Benachrichtigungen subskribiert haben, Benachrichtigungen. + +![Anzeige 'Benachrichtigungen'](images/tag_notification.jpg) +2. Geben Sie in das Feld **Nachricht** Ihre Nachricht ein und klicken Sie dann auf **Senden**. + +3. Überprüfen Sie, ob die Geräte Ihre Benachrichtigung empfangen haben. Die folgende Abbildung zeigt ein Alertfeld bei der Verarbeitung einer {{site.data.keyword.mobilepushshort}} im Vordergrund eines Android- bzw. iOS-Geräts. + +![Push-Benachrichtigung im Vordergrund auf einem Android-Gerät](images/Android_Screenshot.jpg) + +![Push-Benachrichtigung im Vordergrund auf einem iOS-Gerät](images/iOS_Screenshot.jpg) + +Der folgende Screenshot zeigt eine Push-Benachrichtigung im Hintergrund auf einem Android-Gerät. + +![Push-Benachrichtigung im Hintergrund auf einem Android-Gerät](images/background.jpg) diff --git a/services/mobilepush/nl/de/t_service_instance.md b/services/mobilepush/nl/de/t_service_instance.md index dbf9b7be5..ec2b1be8f 100644 --- a/services/mobilepush/nl/de/t_service_instance.md +++ b/services/mobilepush/nl/de/t_service_instance.md @@ -1,51 +1,51 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Push-Serviceinstanz erstellen -{: #create-push-instance} - -Um mit {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}} arbeiten zu können, müssen Sie zunächst eine {{site.data.keyword.Bluemix}}-Anwendung erstellen (z. B. eine Node.js-App). Anschließend erstellen Sie eine Instanz des Push-Service {{site.data.keyword.mobilepushfull}}, die an diese Bluemix-Anwendung gebunden werden muss. Zu diesem Zweck können Sie auch den Abschnitt 'Boilerplate' im Bluemix-Katalog aufrufen und auf 'MobileFirst Services Starter' klicken. - -**Hinweis**: Wenn Sie Organisationen konfiguriert haben, um Ihre Umgebung zu verwalten, wählen Sie die Organisation aus, in der Sie die Laufzeit und die Services für Ihre mobile App erstellen möchten. - - -1. Wenn Sie nicht über eine Bluemix-Anwendung verfügen, müssen Sie eine erstellen (z. B. eine Node.js-App). Um eine Bluemix-Anwendung zu erstellen, rufen Sie das Bluemix-Dashboard auf und klicken Sie auf **Anwendung erstellen**. - - **Hinweis**: Wenn Sie bereits über eine Anwendung verfügen, fahren Sie mit Schritt 7 fort, um einen Service hinzuzufügen.![Serviceinstanz erstellen](images/create_service_instance1.jpg "Serviceinstanz erstellen") - -1. Klicken Sie unter **Eigene Anwendungsvorlage auswählen** auf **WEB**. - -3. Wählen Sie im Bereich **Ausgangspunkt auswählen** die Option **SDK for Node.js** aus und klicken Sie auf **Weiter**.![Ausgangspunkt](images/create_service_nodejs2.jpg) - -4. Wählen Sie im Pulldown-Menü **Bereich** den Bereich -Ihrer Organisation aus. - - ![ -Select organization space](images/create_a_service3.jpg) -1. Geben Sie in das Feld **Name** den Namen für Ihre App ein und -in das Feld 'Host' den Namen des Hosts. - -1. Wählen Sie im Pulldown-Menü **Ausgewählter Plan** einen Plan aus -und klicken Sie anschließend auf die Schaltfläche **ERSTELLEN**. Warten Sie, -bis die Anwendung bereitgestellt ist. - -1. Klicken Sie auf den Link **Übersicht**.![Service hinzufügen](images/create_service_add4.jpg) -1. Klicken Sie auf **Service hinzufügen**. Die Anzeige 'Katalog' wird geöffnet. - -1. Wählen Sie **IBM Push Notifications:** und anschließend im Pulldown-Menü **Bereich** Ihre Organisation aus. - - ![Pulldown-Menü 'Bereich' für Organisation](images/create_service_org.jpg) -1. Geben Sie in das Feld **Service** den Push Notifications Service-Name ein. - -1. Wählen Sie unter **Ausgewählter Plan** einen Plan aus und -klicken Sie auf die Schaltfläche **ERSTELLEN**. - -1. Klicken Sie auf **Ja**, um die Anwendung erneut bereitzustellen. - - ![IBM Push Notifications Service](images/create_service_notification5.jpg) - -1. Klicken Sie auf **Push-Benachrichtigungen**, um das Dashboard für Push-Benachrichtigungen anzuzeigen. +--- + +copyright: + years: 2015, 2016 + +--- + +# Push-Serviceinstanz erstellen +{: #create-push-instance} + +Um mit {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}} arbeiten zu können, müssen Sie zunächst eine {{site.data.keyword.Bluemix}}-Anwendung erstellen (z. B. eine Node.js-App). Anschließend erstellen Sie eine Instanz des Push-Service {{site.data.keyword.mobilepushfull}}, die an diese Bluemix-Anwendung gebunden werden muss. Zu diesem Zweck können Sie auch den Abschnitt 'Boilerplate' im Bluemix-Katalog aufrufen und auf 'MobileFirst Services Starter' klicken. + +**Hinweis**: Wenn Sie Organisationen konfiguriert haben, um Ihre Umgebung zu verwalten, wählen Sie die Organisation aus, in der Sie die Laufzeit und die Services für Ihre mobile App erstellen möchten. + + +1. Wenn Sie nicht über eine Bluemix-Anwendung verfügen, müssen Sie eine erstellen (z. B. eine Node.js-App). Um eine Bluemix-Anwendung zu erstellen, rufen Sie das Bluemix-Dashboard auf und klicken Sie auf **Anwendung erstellen**. + + **Hinweis**: Wenn Sie bereits über eine Anwendung verfügen, fahren Sie mit Schritt 7 fort, um einen Service hinzuzufügen.![Serviceinstanz erstellen](images/create_service_instance1.jpg "Serviceinstanz erstellen") + +1. Klicken Sie unter **Eigene Anwendungsvorlage auswählen** auf **WEB**. + +3. Wählen Sie im Bereich **Ausgangspunkt auswählen** die Option **SDK for Node.js** aus und klicken Sie auf **Weiter**.![Ausgangspunkt](images/create_service_nodejs2.jpg) + +4. Wählen Sie im Pulldown-Menü **Bereich** den Bereich +Ihrer Organisation aus. + + ![ +Select organization space](images/create_a_service3.jpg) +1. Geben Sie in das Feld **Name** den Namen für Ihre App ein und +in das Feld 'Host' den Namen des Hosts. + +1. Wählen Sie im Pulldown-Menü **Ausgewählter Plan** einen Plan aus +und klicken Sie anschließend auf die Schaltfläche **ERSTELLEN**. Warten Sie, +bis die Anwendung bereitgestellt ist. + +1. Klicken Sie auf den Link **Übersicht**.![Service hinzufügen](images/create_service_add4.jpg) +1. Klicken Sie auf **Service hinzufügen**. Die Anzeige 'Katalog' wird geöffnet. + +1. Wählen Sie **IBM Push Notifications:** und anschließend im Pulldown-Menü **Bereich** Ihre Organisation aus. + + ![Pulldown-Menü 'Bereich' für Organisation](images/create_service_org.jpg) +1. Geben Sie in das Feld **Service** den Push Notifications Service-Name ein. + +1. Wählen Sie unter **Ausgewählter Plan** einen Plan aus und +klicken Sie auf die Schaltfläche **ERSTELLEN**. + +1. Klicken Sie auf **Ja**, um die Anwendung erneut bereitzustellen. + + ![IBM Push Notifications Service](images/create_service_notification5.jpg) + +1. Klicken Sie auf **Push-Benachrichtigungen**, um das Dashboard für Push-Benachrichtigungen anzuzeigen. diff --git a/services/mobilepush/nl/de/t_subscribe_tags.md b/services/mobilepush/nl/de/t_subscribe_tags.md index cc066ef0d..75e37b0c6 100644 --- a/services/mobilepush/nl/de/t_subscribe_tags.md +++ b/services/mobilepush/nl/de/t_subscribe_tags.md @@ -1,126 +1,126 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Tags subskribieren und die Subskription aufheben -{: #Subscribe_tags} - -Verwenden Sie die folgenden Code-Snippets, um Ihren Geräten das Abrufen von Subskriptionen und das Subskribieren und das Aufheben der Subskription von Tags zu ermöglichen. - -## Android - -Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre mobile Android-Anwendung ein. - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - -## Cordova - -Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre mobile Cordova-Anwendung ein. - -``` -var tag = "YourTag"; -MFPPush.subscribe(tag, success, failure); -MFPPush.unsubscribe(tag, success, failure); -``` - -## Objective-C - -Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre mobile Objective-C-Anwendung ein. - -Verwenden Sie die API **subscribeToTags** zum Subskribieren eines Tags. - -``` -[push subscribeToTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - }else{ - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response subscribeStatus]; - [self updateMessage:@"Parsed subscribe status is:"]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -Verwenden Sie die API **unsubscribeFromTags** zum Aufheben der Subskription eines Tags. - -``` -[push unsubscribeFromTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if (error){ - [self updateMessage:error.description]; - } else { - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response unsubscribeStatus]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -## Swift - -Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre mobile Swift-Anwendung ein. - -**Verfügbare Tags subskribieren** - -Verwenden Sie die API **subscribeToTags** zum Subskribieren eines Tags. - -``` -push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in - if (error != nil) { - //error while subscribing to tags - } else { - //successfully subscribed to tags var subStatus = response.subscribeStatus(); - } -} -``` - -**Subskription von Tags aufheben** - -Verwenden Sie die API **unsubscribeFromTags** zum Aufheben der Subskription eines Tags. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - - if error.isEmpty { - print( "Response during unsubscribed tags : \(response.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Tags subskribieren und die Subskription aufheben +{: #Subscribe_tags} + +Verwenden Sie die folgenden Code-Snippets, um Ihren Geräten das Abrufen von Subskriptionen und das Subskribieren und das Aufheben der Subskription von Tags zu ermöglichen. + +## Android + +Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre mobile Android-Anwendung ein. + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + +## Cordova + +Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre mobile Cordova-Anwendung ein. + +``` +var tag = "YourTag"; +MFPPush.subscribe(tag, success, failure); +MFPPush.unsubscribe(tag, success, failure); +``` + +## Objective-C + +Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre mobile Objective-C-Anwendung ein. + +Verwenden Sie die API **subscribeToTags** zum Subskribieren eines Tags. + +``` +[push subscribeToTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + }else{ + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response subscribeStatus]; + [self updateMessage:@"Parsed subscribe status is:"]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +Verwenden Sie die API **unsubscribeFromTags** zum Aufheben der Subskription eines Tags. + +``` +[push unsubscribeFromTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if (error){ + [self updateMessage:error.description]; + } else { + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response unsubscribeStatus]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +## Swift + +Kopieren Sie das folgende Code-Snippet und fügen Sie es in Ihre mobile Swift-Anwendung ein. + +**Verfügbare Tags subskribieren** + +Verwenden Sie die API **subscribeToTags** zum Subskribieren eines Tags. + +``` +push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in + if (error != nil) { + //error while subscribing to tags + } else { + //successfully subscribed to tags var subStatus = response.subscribeStatus(); + } +} +``` + +**Subskription von Tags aufheben** + +Verwenden Sie die API **unsubscribeFromTags** zum Aufheben der Subskription eines Tags. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + + if error.isEmpty { + print( "Response during unsubscribed tags : \(response.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` diff --git a/services/mobilepush/nl/de/t_use_tags.md b/services/mobilepush/nl/de/t_use_tags.md index de620e23e..4d6932929 100644 --- a/services/mobilepush/nl/de/t_use_tags.md +++ b/services/mobilepush/nl/de/t_use_tags.md @@ -1,25 +1,25 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Tagbasierte Benachrichtigungen verwenden -{: #using_tags} - - -Tagbasierte Benachrichtigungen sind Benachrichtigungen, die all diejenigen Geräte zum Ziel haben, die einen -bestimmten Tag subskribiert haben. Jedes Gerät kann beliebig viele Tags subskribieren. In diesem Abschnitt wird beschrieben, wie tagbasierte Benachrichtigungen gesendet werden. Subskriptionen werden von der Bluemix-Instanz von Push Notifications Service verwaltet. Wenn ein Tag gelöscht wird, werden alle diesem Tag zugeordneten Informationen (einschließlich Subskribenten und Geräte) gelöscht. Für diesen Tag ist keine automatische Aufhebung der Subskription erforderlich, da er nicht mehr vorhanden ist und daher clientseitig keine weiteren Aktionen nötig sind. - -**Vorbemerkungen** - -Erstellen Sie Tags in der Anzeige **Tag**. Informationen zum Erstellen von Tags finden Sie -in [Tags erstellen](t_manage_tags.html). - -1. Klicken Sie im Push Notifications-Dashboard auf die Registerkarte **Benachrichtigungen**. -1. Wählen Sie die Option **Tags** aus, um tagbasierte Benachrichtigungen zu senden. -1. Suchen Sie mithilfe des Felds **Tags suchen** nach den Tags, die Sie verwenden möchten, -und klicken Sie anschließend auf die Schaltfläche **Hinzufügen**.![Anzeige 'Benachrichtigungen](images/tag_notification.jpg) -1. Navigieren Sie zum Bereich **Eigene Benachrichtigungen erstellen** und geben Sie in das Feld **Nachrichtentext** den Text ein, den Sie in Ihrer Benachrichtigung senden möchten. -1. Klicken Sie auf die Schaltfläche **Senden**. +--- + +copyright: + years: 2015, 2016 + +--- + +# Tagbasierte Benachrichtigungen verwenden +{: #using_tags} + + +Tagbasierte Benachrichtigungen sind Benachrichtigungen, die all diejenigen Geräte zum Ziel haben, die einen +bestimmten Tag subskribiert haben. Jedes Gerät kann beliebig viele Tags subskribieren. In diesem Abschnitt wird beschrieben, wie tagbasierte Benachrichtigungen gesendet werden. Subskriptionen werden von der Bluemix-Instanz von Push Notifications Service verwaltet. Wenn ein Tag gelöscht wird, werden alle diesem Tag zugeordneten Informationen (einschließlich Subskribenten und Geräte) gelöscht. Für diesen Tag ist keine automatische Aufhebung der Subskription erforderlich, da er nicht mehr vorhanden ist und daher clientseitig keine weiteren Aktionen nötig sind. + +**Vorbemerkungen** + +Erstellen Sie Tags in der Anzeige **Tag**. Informationen zum Erstellen von Tags finden Sie +in [Tags erstellen](t_manage_tags.html). + +1. Klicken Sie im Push Notifications-Dashboard auf die Registerkarte **Benachrichtigungen**. +1. Wählen Sie die Option **Tags** aus, um tagbasierte Benachrichtigungen zu senden. +1. Suchen Sie mithilfe des Felds **Tags suchen** nach den Tags, die Sie verwenden möchten, +und klicken Sie anschließend auf die Schaltfläche **Hinzufügen**.![Anzeige 'Benachrichtigungen](images/tag_notification.jpg) +1. Navigieren Sie zum Bereich **Eigene Benachrichtigungen erstellen** und geben Sie in das Feld **Nachrichtentext** den Text ein, den Sie in Ihrer Benachrichtigung senden möchten. +1. Klicken Sie auf die Schaltfläche **Senden**. diff --git a/services/mobilepush/nl/de/tr_error_push.md b/services/mobilepush/nl/de/tr_error_push.md index 2f7f0eca5..df7dba162 100644 --- a/services/mobilepush/nl/de/tr_error_push.md +++ b/services/mobilepush/nl/de/tr_error_push.md @@ -1,192 +1,192 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Fehlernachrichten für den Service {{site.data.keyword.mobilepushshort}} -{: #errors} -Letzte Aktualisierung: 13. Februar 2017 -{: .last-updated} - - -Als Antwort auf REST-API-Anforderungen werden die folgenden {{site.data.keyword.mobilepushshort}}-Fehlernachrichten zurückgegeben. - -Beispiele für Fehlerantworten: -``` - { - "message": "Missing APNs credentials", - "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", - "code": "FPWSE0003E" - } -``` - {: codeblock} - -Weitere Informationen zu einem Fehler finden Sie in der Dokumentation zu dem jeweiligen Fehlercode. - -## FPWSE0001E -{: #error_fpwse0001e} - -**Erläuterung**: Die Ressource, die Sie versuchen abzurufen, z. B. einen Tag oder eine Subskription, ist auf dem Server nicht verfügbar. - -**Benutzeraktion**: Erstellen Sie die Ressource, die in der Nachricht aufgeführt wurde. Sie können alternativ die richtige ID für die Abfrage der Ressource bereitstellen. - - -## FPWSE0002E -{: #error_fpwse0002e} - -**Erläuterung**: Die Ressource, die Sie zu erstellen versuchen, ist auf dem Server bereits verfügbar. Bei der Ressource kann es sich um einen Tag, eine Subskription usw. handeln. - -**Benutzeraktion**: Erstellen Sie die Ressource mit einer anderen ID. - - -## FPWSE0003E -{: #error_fpwse0003e} - -**Erläuterung**: Die vorausgesetzte Konfiguration für den {{site.data.keyword.mobilepushshort}}-Service ist unvollständig. Sie versuchen möglicherweise, APNs-Berechtigungsnachweise abzurufen, bevor sie konfiguriert sind. - -**Benutzeraktion**: Stellen Sie sicher, dass der {{site.data.keyword.mobilepushshort}}-Service mit gültigen Sicherheitszertifikaten für APNs konfiguriert wurde. Weitere Informationen finden Sie im Abschnitt [Berechtigungsnachweise für APNs konfigurieren ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](t_push_provider_ios.html){: new_window}. - - -## FPWSE0004E -{: #error_fpwse0004e} - -**Erläuterung**: Der in der Anforderung enthaltene JSON-Hauptteil ist nicht gültig. - - -**Benutzeraktion**: Stellen Sie sicher, dass Sie in der Anforderung eine gültige JSON-Syntax verwenden. - - - -## FPWSE0005E -{: #error_fpwse0005e} - -**Erläuterung**: Die Anforderung an den {{site.data.keyword.mobilepushshort}}-Server ist falsch oder unvollständig, da der JSON-Hauptteil nicht die Eigenschaftswerte enthält, die für die Ausführung der API-Anforderung erforderlich sind. So ist beispielsweise ein Kennwort nicht gültig oder ein Gerätetoken fehlt. - - -**Benutzeraktion**: Lesen Sie die Nachricht, um zu erfahren, welcher Eigenschaftswert fehlt oder nicht gültig ist, und geben Sie dann die erforderlichen Informationen an. - - - -## FPWSE0006E -{: #error_fpwse0006e} - -**Erläuterung**: Der JSON-Hauptteil der Anforderung weist Parameter auf, die vom {{site.data.keyword.mobilepushshort}}-Server nicht interpretiert werden können. - - -**Benutzeraktion**: Stellen Sie sicher, dass für den JSON-Hauptteil in der Anforderung das Format der Anforderung beachtet wird, das der {{site.data.keyword.mobilepushshort}}-Server erwartet. Weitere Informationen finden Sie im Abschnitt [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0007E -{: #error_fpwse0007e} - -**Erläuterung**: Die Anforderungs-URL weist eine Abfragezeichenfolge mit nicht erkannten Parametern auf. Beispiel: Wenn die Anforderung zum Löschen der Subskription andere Parameter als deviceId und tagName aufweist, kann es zu diesem Fehler kommen. - - -**Benutzeraktion**: Stellen Sie sicher, dass für den JSON-Hauptteil in der Anforderung das Format der Anforderung beachtet wird, das der {{site.data.keyword.mobilepushshort}}-Server erwartet. Weitere Informationen finden Sie im Abschnitt [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0008E -{: #error_fpwse0008e} - -**Erläuterung**: Die Anforderungs-URL weist eine Abfragezeichenfolge mit fehlenden erforderlichen Parametern auf. Beispiel: Möglicherweise fehlen die Parameter deviceId und tagName in der Anforderung zum Löschen der Subskription. - - -**Benutzeraktion**: Stellen Sie sicher, dass für den JSON-Hauptteil in der Anforderung das Format der Anforderung beachtet wird, das der {{site.data.keyword.mobilepushshort}}-Server erwartet. Weitere Informationen finden Sie im Abschnitt [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0009E -{: #error_fpwse0009e} - -**Erläuterung**: Es wurde versucht, Benachrichtigungen zu senden, doch bei der Anwendung sind keine Geräte registriert. - -**Benutzeraktion**: Stellen Sie sicher, dass Geräte bei der Anwendung registriert wurden, bevor versucht wird, Benachrichtigungen zu senden. - - - -## FPWSE0010E -{: #error_fpwse0010e} - -**Erläuterung**: Die an den Server übergebene Anforderung führte zu einer Ausnahmebedingung. Eine der folgenden Bedingungen hat diesen Fehler möglicherweise verursacht: - -- Ein von {{site.data.keyword.mobilepushshort}} genutztes internes Subsystem antwortet nicht. -- Die Anforderung führte zu einer Fehlerbedingung, die von {{site.data.keyword.mobilepushshort}} möglicherweise nicht verarbeitet werden kann. -- Für den Service {{site.data.keyword.mobilepushshort}} ist die Bearbeitung durch einen Administrator erforderlich. - -**Benutzeraktion**: Wiederholen Sie die Anforderung. Wenn das Problem bestehen bleibt, wenden Sie sich an den IBM Software Support. - - - -## FPWSE0011E -{: #error_fpwse0011e} - -**Erläuterung**: Die Subskription für den Tag ist auf dem Server bereits vorhanden. Ein Beispiel wäre die Erstellung einer Subskription, die bereits existiert. - -**Benutzeraktion**: Erstellen Sie eine Subskription mit einem eindeutigen Tagnamen. - - - -## FPWSE0012E -{: #error_fpwse0012e} - -**Erläuterung**: Die Subskription für den Tag ist auf dem Server nicht vorhanden. Dieser Fehler tritt auf, wenn eine Anforderung zum Abrufen oder Löschen einer nicht vorhandenen Subskription übergeben wird. - - -**Benutzeraktion**: Verwenden Sie in der Anforderung den richtigen Tagnamen und die richtige Geräte-ID. - - - -## FPWSE0013E -{: #error_fpwse0013e} - -**Erläuterung**: Die in der Anforderung enthaltenen JSON-Nutzdaten sind nicht gültig. - - -**Benutzeraktion**: Stellen Sie sicher, dass die JSON-Nutzdaten gültig sind. - - -## FPWSE0025E -{: #error_fpwse0025e} - -**Erläuterung**: Der Server kann die Anforderung momentan nicht verarbeiten. - -**Benutzeraktion**: Reichen Sie die Anforderung zu einem späteren Zeitpunkt erneut ein. - - -## FPWSE1007E -{: #error_fpwse1007e} - -**Erläuterung**: Der {{site.data.keyword.mobilepushshort}}-Service wurde für diese Anwendung inaktiviert. Dies kann aus abrechnungstechnischen Gründen geschehen oder die App wurde vom Administrator inaktiviert. - - -**Benutzeraktion**: Zum Überprüfen des Servicestatus, zum Abrufen von Fehlerbehebungsinformationen oder für Informationen zum Anfordern von Hilfe ziehen Sie die Themen zur Fehlerbehebung in der Bluemix-Dokumentation zurate. - - - -## FPWSE1079E -{: #error_fpwse1079e} - -**Erläuterung**: Der für die Abfrageoperation angegebene Offsetwert ist nicht gültig. - -**Benutzeraktion**: Stellen Sie sicher, dass der Offsetwert größer-gleich null ist. - - - -## FPWSE1080E -{: #error_fpwse1080e} - -**Erläuterung**: Der für die Abfrageoperation angegebene Größenwert ist nicht gültig. - -**Benutzeraktion**: Stellen Sie sicher, dass der Größenwert über null liegt. - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Fehlernachrichten für den Service {{site.data.keyword.mobilepushshort}} +{: #errors} +Letzte Aktualisierung: 13. Februar 2017 +{: .last-updated} + + +Als Antwort auf REST-API-Anforderungen werden die folgenden {{site.data.keyword.mobilepushshort}}-Fehlernachrichten zurückgegeben. + +Beispiele für Fehlerantworten: +``` + { + "message": "Missing APNs credentials", + "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", + "code": "FPWSE0003E" + } +``` + {: codeblock} + +Weitere Informationen zu einem Fehler finden Sie in der Dokumentation zu dem jeweiligen Fehlercode. + +## FPWSE0001E +{: #error_fpwse0001e} + +**Erläuterung**: Die Ressource, die Sie versuchen abzurufen, z. B. einen Tag oder eine Subskription, ist auf dem Server nicht verfügbar. + +**Benutzeraktion**: Erstellen Sie die Ressource, die in der Nachricht aufgeführt wurde. Sie können alternativ die richtige ID für die Abfrage der Ressource bereitstellen. + + +## FPWSE0002E +{: #error_fpwse0002e} + +**Erläuterung**: Die Ressource, die Sie zu erstellen versuchen, ist auf dem Server bereits verfügbar. Bei der Ressource kann es sich um einen Tag, eine Subskription usw. handeln. + +**Benutzeraktion**: Erstellen Sie die Ressource mit einer anderen ID. + + +## FPWSE0003E +{: #error_fpwse0003e} + +**Erläuterung**: Die vorausgesetzte Konfiguration für den {{site.data.keyword.mobilepushshort}}-Service ist unvollständig. Sie versuchen möglicherweise, APNs-Berechtigungsnachweise abzurufen, bevor sie konfiguriert sind. + +**Benutzeraktion**: Stellen Sie sicher, dass der {{site.data.keyword.mobilepushshort}}-Service mit gültigen Sicherheitszertifikaten für APNs konfiguriert wurde. Weitere Informationen finden Sie im Abschnitt [Berechtigungsnachweise für APNs konfigurieren ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](t_push_provider_ios.html){: new_window}. + + +## FPWSE0004E +{: #error_fpwse0004e} + +**Erläuterung**: Der in der Anforderung enthaltene JSON-Hauptteil ist nicht gültig. + + +**Benutzeraktion**: Stellen Sie sicher, dass Sie in der Anforderung eine gültige JSON-Syntax verwenden. + + + +## FPWSE0005E +{: #error_fpwse0005e} + +**Erläuterung**: Die Anforderung an den {{site.data.keyword.mobilepushshort}}-Server ist falsch oder unvollständig, da der JSON-Hauptteil nicht die Eigenschaftswerte enthält, die für die Ausführung der API-Anforderung erforderlich sind. So ist beispielsweise ein Kennwort nicht gültig oder ein Gerätetoken fehlt. + + +**Benutzeraktion**: Lesen Sie die Nachricht, um zu erfahren, welcher Eigenschaftswert fehlt oder nicht gültig ist, und geben Sie dann die erforderlichen Informationen an. + + + +## FPWSE0006E +{: #error_fpwse0006e} + +**Erläuterung**: Der JSON-Hauptteil der Anforderung weist Parameter auf, die vom {{site.data.keyword.mobilepushshort}}-Server nicht interpretiert werden können. + + +**Benutzeraktion**: Stellen Sie sicher, dass für den JSON-Hauptteil in der Anforderung das Format der Anforderung beachtet wird, das der {{site.data.keyword.mobilepushshort}}-Server erwartet. Weitere Informationen finden Sie im Abschnitt [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0007E +{: #error_fpwse0007e} + +**Erläuterung**: Die Anforderungs-URL weist eine Abfragezeichenfolge mit nicht erkannten Parametern auf. Beispiel: Wenn die Anforderung zum Löschen der Subskription andere Parameter als deviceId und tagName aufweist, kann es zu diesem Fehler kommen. + + +**Benutzeraktion**: Stellen Sie sicher, dass für den JSON-Hauptteil in der Anforderung das Format der Anforderung beachtet wird, das der {{site.data.keyword.mobilepushshort}}-Server erwartet. Weitere Informationen finden Sie im Abschnitt [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0008E +{: #error_fpwse0008e} + +**Erläuterung**: Die Anforderungs-URL weist eine Abfragezeichenfolge mit fehlenden erforderlichen Parametern auf. Beispiel: Möglicherweise fehlen die Parameter deviceId und tagName in der Anforderung zum Löschen der Subskription. + + +**Benutzeraktion**: Stellen Sie sicher, dass für den JSON-Hauptteil in der Anforderung das Format der Anforderung beachtet wird, das der {{site.data.keyword.mobilepushshort}}-Server erwartet. Weitere Informationen finden Sie im Abschnitt [REST-APIs ![Symbol für externen Link](../../icons/launch-glyph.svg "Symbol für externen Link")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0009E +{: #error_fpwse0009e} + +**Erläuterung**: Es wurde versucht, Benachrichtigungen zu senden, doch bei der Anwendung sind keine Geräte registriert. + +**Benutzeraktion**: Stellen Sie sicher, dass Geräte bei der Anwendung registriert wurden, bevor versucht wird, Benachrichtigungen zu senden. + + + +## FPWSE0010E +{: #error_fpwse0010e} + +**Erläuterung**: Die an den Server übergebene Anforderung führte zu einer Ausnahmebedingung. Eine der folgenden Bedingungen hat diesen Fehler möglicherweise verursacht: + +- Ein von {{site.data.keyword.mobilepushshort}} genutztes internes Subsystem antwortet nicht. +- Die Anforderung führte zu einer Fehlerbedingung, die von {{site.data.keyword.mobilepushshort}} möglicherweise nicht verarbeitet werden kann. +- Für den Service {{site.data.keyword.mobilepushshort}} ist die Bearbeitung durch einen Administrator erforderlich. + +**Benutzeraktion**: Wiederholen Sie die Anforderung. Wenn das Problem bestehen bleibt, wenden Sie sich an den IBM Software Support. + + + +## FPWSE0011E +{: #error_fpwse0011e} + +**Erläuterung**: Die Subskription für den Tag ist auf dem Server bereits vorhanden. Ein Beispiel wäre die Erstellung einer Subskription, die bereits existiert. + +**Benutzeraktion**: Erstellen Sie eine Subskription mit einem eindeutigen Tagnamen. + + + +## FPWSE0012E +{: #error_fpwse0012e} + +**Erläuterung**: Die Subskription für den Tag ist auf dem Server nicht vorhanden. Dieser Fehler tritt auf, wenn eine Anforderung zum Abrufen oder Löschen einer nicht vorhandenen Subskription übergeben wird. + + +**Benutzeraktion**: Verwenden Sie in der Anforderung den richtigen Tagnamen und die richtige Geräte-ID. + + + +## FPWSE0013E +{: #error_fpwse0013e} + +**Erläuterung**: Die in der Anforderung enthaltenen JSON-Nutzdaten sind nicht gültig. + + +**Benutzeraktion**: Stellen Sie sicher, dass die JSON-Nutzdaten gültig sind. + + +## FPWSE0025E +{: #error_fpwse0025e} + +**Erläuterung**: Der Server kann die Anforderung momentan nicht verarbeiten. + +**Benutzeraktion**: Reichen Sie die Anforderung zu einem späteren Zeitpunkt erneut ein. + + +## FPWSE1007E +{: #error_fpwse1007e} + +**Erläuterung**: Der {{site.data.keyword.mobilepushshort}}-Service wurde für diese Anwendung inaktiviert. Dies kann aus abrechnungstechnischen Gründen geschehen oder die App wurde vom Administrator inaktiviert. + + +**Benutzeraktion**: Zum Überprüfen des Servicestatus, zum Abrufen von Fehlerbehebungsinformationen oder für Informationen zum Anfordern von Hilfe ziehen Sie die Themen zur Fehlerbehebung in der Bluemix-Dokumentation zurate. + + + +## FPWSE1079E +{: #error_fpwse1079e} + +**Erläuterung**: Der für die Abfrageoperation angegebene Offsetwert ist nicht gültig. + +**Benutzeraktion**: Stellen Sie sicher, dass der Offsetwert größer-gleich null ist. + + + +## FPWSE1080E +{: #error_fpwse1080e} + +**Erläuterung**: Der für die Abfrageoperation angegebene Größenwert ist nicht gültig. + +**Benutzeraktion**: Stellen Sie sicher, dass der Größenwert über null liegt. + + + diff --git a/services/mobilepush/nl/de/troubleshooting.md b/services/mobilepush/nl/de/troubleshooting.md index 408fd4826..e499f4e20 100644 --- a/services/mobilepush/nl/de/troubleshooting.md +++ b/services/mobilepush/nl/de/troubleshooting.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Fehlerbehebung -{: #errors} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - -In diesem Abschnitt finden Sie Anweisungen für die Behebung von allgemeinen Fehlern bei {{site.data.keyword.mobilepushshort}}. - - -### Internal server error occurred. Please contact admin. (Internal error code: PUSHD102E) - -**Erläuterung**: Dieser Fehler kann auftreten, wenn Sie eine Push-Instanz vor November 2015 erstellt haben. - -**Benutzeraktion**: Um das Problem zu lösen, müssen Sie die Push-Instanz löschen und eine neue erstellen. Beachten Sie, dass Ihre Tags nicht beibehalten werden, wenn Sie die Push-Instanz löschen. - - -### UnauthorizedRegistration - -**Erläuterung**: Chrome Web Push funktioniert mit FCM-Schlüsseln (Firebase Cloud Messaging) nicht. Wenn Sie nach dem Umzug von FCM auf GCM unter Chrome keine Web-Push-Benachrichtigung erhalten, ist der Grund hierfür, dass die Website vorher für die Funktion mit dem GCM-Projekt konfiguriert war und das neue Projekt mit FCM erstellt wurde. Die generierten Tokens, die den Browser angeben, werden vom Chrome-Browser im Cache gespeichert. - -**Benutzeraktion**: Sie können dieses Problem durch Entfernen der Cookies und Zurücksetzen der Berechtigungen des Browsers lösen. Hierfür wären Berechtigungen für die Aktivierung von Push Notifications erforderlich. - - -### Service workers are not supported in this browser - -**Erläuterung**: Das als Teil von `BMSPushSDK.js` eingeschlossene SDK, das den Servicebearbeiter verwendet, ist nicht verfügbar. - -**Benutzeraktion**: Es wird empfohlen, einen Browser zu verwenden, der den Servicebearbeiter unterstützt. Die unterstützten Browserversionen sind Firefox ab Version 49 und Chrome ab Version 53 (64-Bit). - - -### SecurityError: The operation is insecure - -**Erläuterung**: Dieser Fehler wird gegebenenfalls beim Aktivieren der Webkonsole in Firefox ausgegeben. Die Unterstützung für Web-Push-Benachrichtigungen im Push-Benachrichtigungsservice setzt voraus, dass die Website über das `https`-Protokoll aufgerufen wird und nicht über das `http`-Protokoll. - -**Benutzeraktion**: Es wird empfohlen, beim Herstellen der Verbindung zu der Website das `https`-Protokoll im Browser anzugeben. - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Fehlerbehebung +{: #errors} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + +In diesem Abschnitt finden Sie Anweisungen für die Behebung von allgemeinen Fehlern bei {{site.data.keyword.mobilepushshort}}. + + +### Internal server error occurred. Please contact admin. (Internal error code: PUSHD102E) + +**Erläuterung**: Dieser Fehler kann auftreten, wenn Sie eine Push-Instanz vor November 2015 erstellt haben. + +**Benutzeraktion**: Um das Problem zu lösen, müssen Sie die Push-Instanz löschen und eine neue erstellen. Beachten Sie, dass Ihre Tags nicht beibehalten werden, wenn Sie die Push-Instanz löschen. + + +### UnauthorizedRegistration + +**Erläuterung**: Chrome Web Push funktioniert mit FCM-Schlüsseln (Firebase Cloud Messaging) nicht. Wenn Sie nach dem Umzug von FCM auf GCM unter Chrome keine Web-Push-Benachrichtigung erhalten, ist der Grund hierfür, dass die Website vorher für die Funktion mit dem GCM-Projekt konfiguriert war und das neue Projekt mit FCM erstellt wurde. Die generierten Tokens, die den Browser angeben, werden vom Chrome-Browser im Cache gespeichert. + +**Benutzeraktion**: Sie können dieses Problem durch Entfernen der Cookies und Zurücksetzen der Berechtigungen des Browsers lösen. Hierfür wären Berechtigungen für die Aktivierung von Push Notifications erforderlich. + + +### Service workers are not supported in this browser + +**Erläuterung**: Das als Teil von `BMSPushSDK.js` eingeschlossene SDK, das den Servicebearbeiter verwendet, ist nicht verfügbar. + +**Benutzeraktion**: Es wird empfohlen, einen Browser zu verwenden, der den Servicebearbeiter unterstützt. Die unterstützten Browserversionen sind Firefox ab Version 49 und Chrome ab Version 53 (64-Bit). + + +### SecurityError: The operation is insecure + +**Erläuterung**: Dieser Fehler wird gegebenenfalls beim Aktivieren der Webkonsole in Firefox ausgegeben. Die Unterstützung für Web-Push-Benachrichtigungen im Push-Benachrichtigungsservice setzt voraus, dass die Website über das `https`-Protokoll aufgerufen wird und nicht über das `http`-Protokoll. + +**Benutzeraktion**: Es wird empfohlen, beim Herstellen der Verbindung zu der Website das `https`-Protokoll im Browser anzugeben. + diff --git a/services/mobilepush/nl/de/troubleshooting_config_errors.md b/services/mobilepush/nl/de/troubleshooting_config_errors.md index 519468b6a..43b4ecc0c 100644 --- a/services/mobilepush/nl/de/troubleshooting_config_errors.md +++ b/services/mobilepush/nl/de/troubleshooting_config_errors.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Fehler in der Web-Push-Konfiguration beheben -{: #errors} -Letzte Aktualisierung: 11. Januar 2017 -{: .last-updated} - -In diesem Abschnitt finden Sie Anweisungen für die Behebung von allgemeinen Fehlern in der Web-Push-Konfiguration. Web-Push-Fehler aus der Datei `BMSPushSDK.js` enthalten Informationen zu dem Fehler. - -Das folgende Codebeispiel veranschaulicht das Analysieren eines Fehlers im Callback: - -``` -function showStatus(response) { - if(response.statusCode == 200 || response.statusCode == 201) { - document.getElementById("status").innerHTML = "Response is " + response.response; - } - else if(response.statusCode == 0) { - if(response.response) { - document.getElementById("status").innerHTML = response.response; - } - else { - document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; - } - } - else { - document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " - + response.error + " and the status code " + response.statusCode; - } - } -``` - {: codeblock} - - -- Wenn `applicationId` nicht ordnungsgemäß konfiguriert ist, schlägt die ursprüngliche Anforderung an den {{site.data.keyword.mobilepushshort}}-Service fehl, da 'statusCode' auf Null (0) gesetzt wird. -- Der Statuscode 200 oder 201 bezeichnet eine erfolgreiche Antwort. -- Wenn `clientSecret` ungültig ist, wird für 'statusCode' ein Antwortcode 401 festgelegt. Das Element `response.reponse` enthält eine Beschreibung des Fehlers. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Fehler in der Web-Push-Konfiguration beheben +{: #errors} +Letzte Aktualisierung: 11. Januar 2017 +{: .last-updated} + +In diesem Abschnitt finden Sie Anweisungen für die Behebung von allgemeinen Fehlern in der Web-Push-Konfiguration. Web-Push-Fehler aus der Datei `BMSPushSDK.js` enthalten Informationen zu dem Fehler. + +Das folgende Codebeispiel veranschaulicht das Analysieren eines Fehlers im Callback: + +``` +function showStatus(response) { + if(response.statusCode == 200 || response.statusCode == 201) { + document.getElementById("status").innerHTML = "Response is " + response.response; + } + else if(response.statusCode == 0) { + if(response.response) { + document.getElementById("status").innerHTML = response.response; + } + else { + document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; + } + } + else { + document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " + + response.error + " and the status code " + response.statusCode; + } + } +``` + {: codeblock} + + +- Wenn `applicationId` nicht ordnungsgemäß konfiguriert ist, schlägt die ursprüngliche Anforderung an den {{site.data.keyword.mobilepushshort}}-Service fehl, da 'statusCode' auf Null (0) gesetzt wird. +- Der Statuscode 200 oder 201 bezeichnet eine erfolgreiche Antwort. +- Wenn `clientSecret` ungültig ist, wird für 'statusCode' ein Antwortcode 401 festgelegt. Das Element `response.reponse` enthält eine Beschreibung des Fehlers. diff --git a/services/mobilepush/nl/es/c_advance_notifications.md b/services/mobilepush/nl/es/c_advance_notifications.md index 25c7e848f..44cb0e4d9 100644 --- a/services/mobilepush/nl/es/c_advance_notifications.md +++ b/services/mobilepush/nl/es/c_advance_notifications.md @@ -1,12 +1,12 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# Habilitación de notificaciones push avanzadas -{: #push-advanced-notifications-main} - -Configure un identificador de iOS, un sonido, una carga útil de JSON adicional, notificaciones accionables y notificaciones retenidas. +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# Habilitación de notificaciones push avanzadas +{: #push-advanced-notifications-main} + +Configure un identificador de iOS, un sonido, una carga útil de JSON adicional, notificaciones accionables y notificaciones retenidas. diff --git a/services/mobilepush/nl/es/c_android_enable.md b/services/mobilepush/nl/es/c_android_enable.md index 29d67ed70..b1d76e38b 100755 --- a/services/mobilepush/nl/es/c_android_enable.md +++ b/services/mobilepush/nl/es/c_android_enable.md @@ -1,360 +1,360 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Habilitación de aplicaciones Android para recibir {{site.data.keyword.mobilepushshort}} -{: #tag_based_notifications} -Última actualización: 14 de febrero de 2017 -{: .last-updated} - -Puede habilitar las aplicaciones de Android para recibir notificaciones push en sus dispositivos. Android Studio es un requisito previo y es el método recomendado para crear proyectos de Android. Es esencial tener un conocimiento básico de Android Studio. - -## Instalación del SDK Push del cliente con Gradle -{: #android_install} - -En esta sección se describe cómo instalar y utilizar el SDK Push del cliente para seguir desarrollando sus aplicaciones Android. - -El SDK push de servicios móviles de Bluemix® se puede añadir mediante Gradle. Gradle descarga automáticamente artefactos desde los repositorios y los deja a disposición de su aplicación Android. Asegúrese de que ha configurado correctamente Android Studio y el SDK de Android Studio. Para obtener más información sobre cómo configurar el sistema, consulte [Visión general de Android Studio ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.android.com/tools/studio/index.html){: new_window}. Para obtener información sobre Gradle, consulte [Configuración de compilaciones Gradle ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}. - -Tras crear y abrir la aplicación para móvil, siga estos pasos utilizando Android Studio. - -1. Añada dependencias al archivo **build.gradle** a nivel de módulo. - - - Añada la siguiente dependencia para incluir el SDK de cliente push de Bluemix™ Mobile Services y el SDK de Google Play Services a las dependencias de ámbito de compilación. - ``` - com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ - ``` - {: codeblock} - - - Añada las siguientes dependencias para importar las sentencias necesarias para el fragmento de código. - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - {: codeblock} - - - Añada la siguiente dependencia al archivo **build.gradle** a nivel de módulo. - ``` - apply plugin: 'com.google.gms.google-services' - ``` - {: codeblock} -3. Añada las siguientes dependencias al archivo **build.gradle** a nivel de proyecto. -``` -dependencies { - classpath 'com.android.tools.build:gradle:2.2.3' - classpath 'com.google.gms:google-services:3.0.0' -} -``` - {: codeblock} -5. En el archivo **AndroidManifest.xml**, añada los permisos siguientes. Para ver un manifiesto de ejemplo, consulte la [Aplicación de ejemplo helloPush de Android ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}. Para ver un archivo de ejemplo de Gradle, consulte el [Archivo de compilación de ejemplo de Gradle ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}. -``` - - - - - -``` - {: codeblock} -Aquí encontrará más información sobre [permisos de Android ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](http://developer.android.com/guide/topics/security/permissions.html){: new_window}. - -4. Añade los valores de intención de notificación para la actividad. Este valor inicia la aplicación cuando el usuario pulsa la notificación recibida desde el área de notificación. -``` - - - - -``` - {: codeblock} -**Nota**: sustituya *Your_Android_Package_Name* en la acción anterior por el nombre del paquete de aplicaciones utilizado en la aplicación. - -5. Añada el servicio de intento de Firebase Cloud Messaging (FCM) o Google Cloud Messaging (GCM) y los filtros de intento para las notificaciones de sucesos RECEIVE y REGISTRATION. -``` - - - - - - - - - - -``` - {: codeblock} - -6. El servicio de {{site.data.keyword.mobilepushshort}} da soporte a la recuperación de notificaciones individuales desde la bandeja de notificaciones. Para las notificaciones a las que se accede desde la bandeja de notificaciones, se le proporcionará un controlador sólo para la notificación que se ha pulsado. Todas las notificaciones se mostrarán cuando la aplicación se abra normalmente. Actualice el archivo **AndroidManifest.xml** con el siguiente fragmento de código para utilizar esta funcionalidad: - -``` - -``` - {: codeblock} - -Para configura el proyecto FCM y obtener las credenciales, consulte [Cómo obtener el ID de remitente y la clave de la API](t_push_provider_android.html). Siga estos pasos en la consola de Firebase Cloud Messaging (FCM). - -1. En la consola de Firebase, pulse el icono **Configuración del proyecto**. - ![Configuración del proyecto Firebase](images/FCM_4.jpg) - -3. Seleccione **AÑADIR APP** o el **icono Añadir Firebase a la app Android** en el separador General del panel Sus apps. - ![Adición de Firebase a Android](images/FCM_5.jpg) - -4. En la ventana Añadir Firebase a la app Android, añada **com.ibm.mobilefirstplatform.clientsdk.android.push** como Nombre de paquete. El campo Apodo de app es opcional. Pulse **AÑADIR APP**. - ![Ventana Adición de Firebase a Android](images/FCM_1.jpg) - -5. Incluya el nombre de paquete de la aplicación, especificando el nombre de paquete en la ventana Añadir Firebase a la app Android. El campo Apodo de app es opcional. Pulse **AÑADIR APP**. - - ![Adición del nombre de paquete de la aplicación](images/FCM_2.jpg) - -6. Se generará el archivo `google-services.json`. Copie el archivo `google-services.json` al directorio raíz del módulo de aplicación de Android. Tenga en cuenta que el archivo `google-service.json` incluye los nombres de paquete añadidos. - - ![Adición del archivo json al directorio raíz de la aplicación](images/FCM_7.jpg) - -5. En la ventana Añadir Firebase a la app Android, pulse **Continuar** y, a continuación, **Finalizar**. - - - -Cree y ejecute la aplicación. - -## Inicialización del SDK push para aplicaciones Android -{: #android_initialize} - -Un lugar común para colocar el código de inicialización se encuentra en el método onCreate de la actividad principal en su aplicación Android. Hay dos componentes del SDK que deben inicializarse. Uno es el SDK principal y el otro es el SDK push creado en la parte superior del SDK principal. - -###Inicializar el SDK principal - -``` -// Inicializar el SDK para Android - BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); -``` - {: codeblock} - -####bluemixRegionSuffix -{: bluemixRegionSuffix} - -Especifica la ubicación en la que se aloja la aplicación. Puede utilizar uno de estos tres valores: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -###Inicializar el SDK push del cliente - -``` -//Inicializar SDK de cliente Push para Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext(), "appGUID", "clientSecret"); -``` - {: codeblock} - -####AppGUID -{: appguid_initialize_client_push_sdk} - -Esta es la clave AppGUID del servicio {{site.data.keyword.mobilepushshort}}. Este valor distingue entre mayúsculas y minúsculas. Abra el panel de control Notificación Push y seleccione el separador Configurar. Puede obtener este valor en Opciones móviles, en el separador Configurar del panel de control Servicio de notificaciones Push. - -## Registro de dispositivos Android -{: #android_register} - -Utilice la API `MFPPush.register()` para registrar el dispositivo con el servicio {{site.data.keyword.mobilepushshort}}. Para efectuar el registro para dispositivos Android, añada la información de Firebase Cloud Messaging (FCM) o Google Cloud Messaging (GCM) en el panel de control de configuración del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. Para obtener más información, consulte [Configuración de credenciales para Google Cloud Messaging](t_push_provider_android.html). - -Copie los siguientes fragmentos de código en la aplicación para móviles de Android. - -``` - //Registre dispositivos Android - push.registerDevice(new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - //maneje el éxito aquí - } - @Override - public void onFailure(MFPPushException ex) { - //maneje la anomalía aquí - } - }); -``` - {: codeblock} - - -``` - //Maneja la notificación cuando llega - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Manejar la notificación push - } - }; -``` - {: codeblock} - -## Recepción de notificaciones push en dispositivos Android -{: #android_receive} - -Para registrar el objeto notificationListener con push, invoque el método **MFPPush.listen()**. Este método normalmente se llama desde el método **onResume()** de la actividad que maneja las notificaciones push. - -1. Para registrar el objeto notificationListener con push, invoque el método **listen()**. Se suele llamar a este método desde los métodos **onResume()** y **onPause** de la actividad que gestiona las notificaciones push. - - -``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` - {: codeblock} - - - -``` - @Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} - -2. Cree el proyecto y ejecútelo en el dispositivo o en el emulador. Cuando se invoque el método onSuccess() para la escucha de respuestas en el método register(), confirmará que el dispositivo se ha registrado correctamente con el servicio {{site.data.keyword.mobilepushshort}}. En este momento puede enviar un mensaje tal como se describe en Envío de notificaciones push básicas. -3. Verifique que los dispositivos hayan recibido la notificación. Si la aplicación se encuentra en segundo plano, la notificación se manejará mediante el **MFPPushNotificationListener**. Si la aplicación se encuentra en segundo plano, se mostrará un mensaje en la barra de notificaciones. - -## Supervisión de las notificaciones push en dispositivos Android -{: #android_monitor} - -Para supervisar el estado actual de la notificación en la aplicación, puede implementar la interfaz `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` y definir el método onStatusChange(String messageId, MFPPushNotificationStatus status). - -El **messageId** es el identificador del mensaje enviado desde el servidor. **MFPPushNotificationStatus** define el estado de las notificaciones como valores: - -- **RECEIVED**: La app ha recibido la notificación. -- **QUEUED**: La app pone en cola la notificación para invocar la escucha de notificación. -- **OPENED**: El usuario abre la notificación pulsando la notificación de la bandeja o iniciándola desde el icono de la app o cuando la app está en primer plano. -- **DISMISSED**: El usuario borra/descarta la notificación de la bandeja. - -Debe registrar la clase **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** con MFPPush. - -``` - push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { - @Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { - // Handle status change -} - }); -``` - {: codeblock} - - -### Escucha del estado DISMISSED - -Puede elegir escuchar en el estado DISMISSED en cualquiera de las siguientes condiciones: - -- Cuando la app está activa (se ejecuta en primer o segundo plano) - - Añada el fragmento de código al archivo `AndroidManifest.xml`: - -``` - - - - - -``` - {: codeblock} - -- Cuando la app está activa (se ejecuta en primer o segundo plano) y no se ejecuta (cerrada) - -Debe extender el receptor de difusión **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** y sustituir el método **onReceive()**, donde el **MFPPushNotificationStatusListener** debe estar registrado antes de invocar el método **onReceive()** de la clase base. - -``` - public class MyDismissHandler extends MFPPushNotificationDismissHandler { - @Override -public void onReceive(Context context, Intent intent) { - MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { - @Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { - // Handle status change -} - }); -super.onReceive(context, intent); -} - } -``` - {: codeblock} - - -Añada el fragmento de código siguiente al archivo `AndroidManifest.xml`: - -``` - - - - - -``` - {: codeblock} - -## Envío de {{site.data.keyword.mobilepushshort}} básicas -{: #send} - -Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas. - -Para ello, realice estos pasos: - -1. Seleccione **Enviar notificaciones** y para redactar un mensaje seleccione la opción **Enviar a**. Las opciones admitidas son **Dispositivo por etiqueta**, **ID de dispositivo**, **ID de usuario**, **Dispositivos Android**, **Dispositivos iOS**, **Notificaciones web** y **Todos los dispositivos**. -**Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos suscritos a {{site.data.keyword.mobilepushshort}} recibirán notificaciones. -![pantalla Notificaciones](images/tag_notification.jpg) - -2. En el campo **Mensaje**, redacte el mensaje. Elija configurar los valores opcionales según sea necesario. -3. Pulse **Enviar**. -3. Verifique que los dispositivos hayan recibido la notificación. - -La captura de pantalla siguiente muestra un recuadro de alerta que maneja una notificación push -en el primer plano en un dispositivo Android. - -![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) - -La captura de pantalla siguiente muestra una notificación push en segundo plano para Android. - -![Notificación push en el fondo en Android](images/background.jpg) - -### Valores opcionales de Android para el envío de notificaciones -{: #send_otpional_setting} - -Puede personalizar aún más los valores de {{site.data.keyword.mobilepushshort}} para el envío de notificaciones a dispositivos Android. Se admiten las siguientes opciones de personalización. -![Valores personalizados de Android](images/android_custom_settings.jpg) - -- **Contraer clave**: las claves contraídas se adjuntan a las notificaciones. Si llegan varias notificaciones de forma secuencias con la misma clave contraída cuando el dispositivo está desconectado, estas se contraerán. Cuando el dispositivo vuelva a conectarse, recibirá las notificaciones del servidor FCM/GCM y mostrará solo la última notificación transportada con la misma clave contraída. Si no se establece esta clave contraída, se almacenarán los mensajes nuevos y antiguos para entregarlos más adelante. -- **Sonido**: indica un fragmento de sonido que se reproducirá al recibir una notificación. Da soporte a la opción predeterminada o al nombre de un recurso de sonido incorporado en la aplicación. -- **Icono**: Especifique el nombre del icono que se mostrará para la notificación. Asegúrese de que haya empaquetado el icono en la carpeta res/drawable, con la aplicación cliente. -- **Prioridad**: especifica las opciones para asignar la prioridad de entrega a los mensajes. Una prioridad `high` o `max` dará como resultado una notificación de aviso, mientras que los mensajes con prioridad `low` o `default` no establecerán conexiones de red en un dispositivo en modo suspendido. Para los mensajes con la opción definida en `min`, se enviará una notificación silenciosa. -- **Visibilidad**: puede optar por definir la opción de visibilidad de notificación en `public` o `private`. La opción `private` limita la visualización pública y puede habilitarla si el dispositivo está protegido mediante pin o un patrón y si el valor de notificación está definido para ocultar contenido privado de las notificaciones. Cuando la visibilidad se establece como `private`, debe mencionarse algún campo de "redacción". Solo se mostrará el contenido especificado en el campo de redacción en la pantalla bloqueada del dispositivo. Si se elige `public` se entregarán notificaciones que se pueden leer libremente. -- **Tiempo de duración**: este valor se establece en segundos. Si no se especifica este parámetro, el servidor FCM/GCM almacenará el mensaje cuatro semanas e intentará entregarlo. La validez caduca transcurridas cuatro semanas. El intervalo de valores posible es de 0 a 2.419.200 segundos. -- **Retrasar cuando esté desocupado**: si se define como `true`, el servidor FCM/GCM no entregará la notificación cuando el dispositivo esté desocupado. Establezca este valor en `false` para garantizar que se entregan notificaciones aunque el dispositivo esté desocupado. -- **Sync**: al definir esta opción como `true`, se sincronizan las notificaciones de todos los dispositivos registrados. Si un usuario dispone de varios dispositivos con la misma aplicación instalada, al leer la notificación en un dispositivo se suprimirán las notificaciones del resto de los dispositivos. Debe asegurarse que está registrado al servicio {{site.data.keyword.mobilepushshort}} con userId para que esta opción funcione. -- **Carga útil adicional**: permite especificar valores personalizados de carga útil para las notificaciones. - - -## Pasos siguientes -{: #next_steps_tags} - -Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. - -Añada estas características de servicio de notificaciones push a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). -Para utilizar opciones de notificaciones avanzadas, consulte [Habilitación de notificaciones push avanzadas](t_advance_badge_sound_payload.html). +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Habilitación de aplicaciones Android para recibir {{site.data.keyword.mobilepushshort}} +{: #tag_based_notifications} +Última actualización: 14 de febrero de 2017 +{: .last-updated} + +Puede habilitar las aplicaciones de Android para recibir notificaciones push en sus dispositivos. Android Studio es un requisito previo y es el método recomendado para crear proyectos de Android. Es esencial tener un conocimiento básico de Android Studio. + +## Instalación del SDK Push del cliente con Gradle +{: #android_install} + +En esta sección se describe cómo instalar y utilizar el SDK Push del cliente para seguir desarrollando sus aplicaciones Android. + +El SDK push de servicios móviles de Bluemix® se puede añadir mediante Gradle. Gradle descarga automáticamente artefactos desde los repositorios y los deja a disposición de su aplicación Android. Asegúrese de que ha configurado correctamente Android Studio y el SDK de Android Studio. Para obtener más información sobre cómo configurar el sistema, consulte [Visión general de Android Studio ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.android.com/tools/studio/index.html){: new_window}. Para obtener información sobre Gradle, consulte [Configuración de compilaciones Gradle ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}. + +Tras crear y abrir la aplicación para móvil, siga estos pasos utilizando Android Studio. + +1. Añada dependencias al archivo **build.gradle** a nivel de módulo. + + - Añada la siguiente dependencia para incluir el SDK de cliente push de Bluemix™ Mobile Services y el SDK de Google Play Services a las dependencias de ámbito de compilación. + ``` + com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ + ``` + {: codeblock} + + - Añada las siguientes dependencias para importar las sentencias necesarias para el fragmento de código. + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + {: codeblock} + + - Añada la siguiente dependencia al archivo **build.gradle** a nivel de módulo. + ``` + apply plugin: 'com.google.gms.google-services' + ``` + {: codeblock} +3. Añada las siguientes dependencias al archivo **build.gradle** a nivel de proyecto. +``` +dependencies { + classpath 'com.android.tools.build:gradle:2.2.3' + classpath 'com.google.gms:google-services:3.0.0' +} +``` + {: codeblock} +5. En el archivo **AndroidManifest.xml**, añada los permisos siguientes. Para ver un manifiesto de ejemplo, consulte la [Aplicación de ejemplo helloPush de Android ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}. Para ver un archivo de ejemplo de Gradle, consulte el [Archivo de compilación de ejemplo de Gradle ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}. +``` + + + + + +``` + {: codeblock} +Aquí encontrará más información sobre [permisos de Android ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](http://developer.android.com/guide/topics/security/permissions.html){: new_window}. + +4. Añade los valores de intención de notificación para la actividad. Este valor inicia la aplicación cuando el usuario pulsa la notificación recibida desde el área de notificación. +``` + + + + +``` + {: codeblock} +**Nota**: sustituya *Your_Android_Package_Name* en la acción anterior por el nombre del paquete de aplicaciones utilizado en la aplicación. + +5. Añada el servicio de intento de Firebase Cloud Messaging (FCM) o Google Cloud Messaging (GCM) y los filtros de intento para las notificaciones de sucesos RECEIVE y REGISTRATION. +``` + + + + + + + + + + +``` + {: codeblock} + +6. El servicio de {{site.data.keyword.mobilepushshort}} da soporte a la recuperación de notificaciones individuales desde la bandeja de notificaciones. Para las notificaciones a las que se accede desde la bandeja de notificaciones, se le proporcionará un controlador sólo para la notificación que se ha pulsado. Todas las notificaciones se mostrarán cuando la aplicación se abra normalmente. Actualice el archivo **AndroidManifest.xml** con el siguiente fragmento de código para utilizar esta funcionalidad: + +``` + +``` + {: codeblock} + +Para configura el proyecto FCM y obtener las credenciales, consulte [Cómo obtener el ID de remitente y la clave de la API](t_push_provider_android.html). Siga estos pasos en la consola de Firebase Cloud Messaging (FCM). + +1. En la consola de Firebase, pulse el icono **Configuración del proyecto**. + ![Configuración del proyecto Firebase](images/FCM_4.jpg) + +3. Seleccione **AÑADIR APP** o el **icono Añadir Firebase a la app Android** en el separador General del panel Sus apps. + ![Adición de Firebase a Android](images/FCM_5.jpg) + +4. En la ventana Añadir Firebase a la app Android, añada **com.ibm.mobilefirstplatform.clientsdk.android.push** como Nombre de paquete. El campo Apodo de app es opcional. Pulse **AÑADIR APP**. + ![Ventana Adición de Firebase a Android](images/FCM_1.jpg) + +5. Incluya el nombre de paquete de la aplicación, especificando el nombre de paquete en la ventana Añadir Firebase a la app Android. El campo Apodo de app es opcional. Pulse **AÑADIR APP**. + + ![Adición del nombre de paquete de la aplicación](images/FCM_2.jpg) + +6. Se generará el archivo `google-services.json`. Copie el archivo `google-services.json` al directorio raíz del módulo de aplicación de Android. Tenga en cuenta que el archivo `google-service.json` incluye los nombres de paquete añadidos. + + ![Adición del archivo json al directorio raíz de la aplicación](images/FCM_7.jpg) + +5. En la ventana Añadir Firebase a la app Android, pulse **Continuar** y, a continuación, **Finalizar**. + + + +Cree y ejecute la aplicación. + +## Inicialización del SDK push para aplicaciones Android +{: #android_initialize} + +Un lugar común para colocar el código de inicialización se encuentra en el método onCreate de la actividad principal en su aplicación Android. Hay dos componentes del SDK que deben inicializarse. Uno es el SDK principal y el otro es el SDK push creado en la parte superior del SDK principal. + +### Inicializar el SDK principal + +``` +// Inicializar el SDK para Android + BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); +``` + {: codeblock} + +#### bluemixRegionSuffix +{: bluemixRegionSuffix} + +Especifica la ubicación en la que se aloja la aplicación. Puede utilizar uno de estos tres valores: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +### Inicializar el SDK push del cliente + +``` +//Inicializar SDK de cliente Push para Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext(), "appGUID", "clientSecret"); +``` + {: codeblock} + +#### AppGUID +{: appguid_initialize_client_push_sdk} + +Esta es la clave AppGUID del servicio {{site.data.keyword.mobilepushshort}}. Este valor distingue entre mayúsculas y minúsculas. Abra el panel de control Notificación Push y seleccione el separador Configurar. Puede obtener este valor en Opciones móviles, en el separador Configurar del panel de control Servicio de notificaciones Push. + +## Registro de dispositivos Android +{: #android_register} + +Utilice la API `MFPPush.register()` para registrar el dispositivo con el servicio {{site.data.keyword.mobilepushshort}}. Para efectuar el registro para dispositivos Android, añada la información de Firebase Cloud Messaging (FCM) o Google Cloud Messaging (GCM) en el panel de control de configuración del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. Para obtener más información, consulte [Configuración de credenciales para Google Cloud Messaging](t_push_provider_android.html). + +Copie los siguientes fragmentos de código en la aplicación para móviles de Android. + +``` + //Registre dispositivos Android + push.registerDevice(new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + //maneje el éxito aquí + } + @Override + public void onFailure(MFPPushException ex) { + //maneje la anomalía aquí + } + }); +``` + {: codeblock} + + +``` + //Maneja la notificación cuando llega + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Manejar la notificación push + } + }; +``` + {: codeblock} + +## Recepción de notificaciones push en dispositivos Android +{: #android_receive} + +Para registrar el objeto notificationListener con push, invoque el método **MFPPush.listen()**. Este método normalmente se llama desde el método **onResume()** de la actividad que maneja las notificaciones push. + +1. Para registrar el objeto notificationListener con push, invoque el método **listen()**. Se suele llamar a este método desde los métodos **onResume()** y **onPause** de la actividad que gestiona las notificaciones push. + + +``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` + {: codeblock} + + + +``` + @Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} + +2. Cree el proyecto y ejecútelo en el dispositivo o en el emulador. Cuando se invoque el método onSuccess() para la escucha de respuestas en el método register(), confirmará que el dispositivo se ha registrado correctamente con el servicio {{site.data.keyword.mobilepushshort}}. En este momento puede enviar un mensaje tal como se describe en Envío de notificaciones push básicas. +3. Verifique que los dispositivos hayan recibido la notificación. Si la aplicación se encuentra en segundo plano, la notificación se manejará mediante el **MFPPushNotificationListener**. Si la aplicación se encuentra en segundo plano, se mostrará un mensaje en la barra de notificaciones. + +## Supervisión de las notificaciones push en dispositivos Android +{: #android_monitor} + +Para supervisar el estado actual de la notificación en la aplicación, puede implementar la interfaz `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` y definir el método onStatusChange(String messageId, MFPPushNotificationStatus status). + +El **messageId** es el identificador del mensaje enviado desde el servidor. **MFPPushNotificationStatus** define el estado de las notificaciones como valores: + +- **RECEIVED**: La app ha recibido la notificación. +- **QUEUED**: La app pone en cola la notificación para invocar la escucha de notificación. +- **OPENED**: El usuario abre la notificación pulsando la notificación de la bandeja o iniciándola desde el icono de la app o cuando la app está en primer plano. +- **DISMISSED**: El usuario borra/descarta la notificación de la bandeja. + +Debe registrar la clase **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** con MFPPush. + +``` + push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { + @Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { + // Handle status change +} + }); +``` + {: codeblock} + + +### Escucha del estado DISMISSED + +Puede elegir escuchar en el estado DISMISSED en cualquiera de las siguientes condiciones: + +- Cuando la app está activa (se ejecuta en primer o segundo plano) + + Añada el fragmento de código al archivo `AndroidManifest.xml`: + +``` + + + + + +``` + {: codeblock} + +- Cuando la app está activa (se ejecuta en primer o segundo plano) y no se ejecuta (cerrada) + +Debe extender el receptor de difusión **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** y sustituir el método **onReceive()**, donde el **MFPPushNotificationStatusListener** debe estar registrado antes de invocar el método **onReceive()** de la clase base. + +``` + public class MyDismissHandler extends MFPPushNotificationDismissHandler { + @Override +public void onReceive(Context context, Intent intent) { + MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { + @Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { + // Handle status change +} + }); +super.onReceive(context, intent); +} + } +``` + {: codeblock} + + +Añada el fragmento de código siguiente al archivo `AndroidManifest.xml`: + +``` + + + + + +``` + {: codeblock} + +## Envío de {{site.data.keyword.mobilepushshort}} básicas +{: #send} + +Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas. + +Para ello, realice estos pasos: + +1. Seleccione **Enviar notificaciones** y para redactar un mensaje seleccione la opción **Enviar a**. Las opciones admitidas son **Dispositivo por etiqueta**, **ID de dispositivo**, **ID de usuario**, **Dispositivos Android**, **Dispositivos iOS**, **Notificaciones web** y **Todos los dispositivos**. +**Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos suscritos a {{site.data.keyword.mobilepushshort}} recibirán notificaciones. +![pantalla Notificaciones](images/tag_notification.jpg) + +2. En el campo **Mensaje**, redacte el mensaje. Elija configurar los valores opcionales según sea necesario. +3. Pulse **Enviar**. +3. Verifique que los dispositivos hayan recibido la notificación. + +La captura de pantalla siguiente muestra un recuadro de alerta que maneja una notificación push +en el primer plano en un dispositivo Android. + +![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) + +La captura de pantalla siguiente muestra una notificación push en segundo plano para Android. + +![Notificación push en el fondo en Android](images/background.jpg) + +### Valores opcionales de Android para el envío de notificaciones +{: #send_otpional_setting} + +Puede personalizar aún más los valores de {{site.data.keyword.mobilepushshort}} para el envío de notificaciones a dispositivos Android. Se admiten las siguientes opciones de personalización. +![Valores personalizados de Android](images/android_custom_settings.jpg) + +- **Contraer clave**: las claves contraídas se adjuntan a las notificaciones. Si llegan varias notificaciones de forma secuencias con la misma clave contraída cuando el dispositivo está desconectado, estas se contraerán. Cuando el dispositivo vuelva a conectarse, recibirá las notificaciones del servidor FCM/GCM y mostrará solo la última notificación transportada con la misma clave contraída. Si no se establece esta clave contraída, se almacenarán los mensajes nuevos y antiguos para entregarlos más adelante. +- **Sonido**: indica un fragmento de sonido que se reproducirá al recibir una notificación. Da soporte a la opción predeterminada o al nombre de un recurso de sonido incorporado en la aplicación. +- **Icono**: Especifique el nombre del icono que se mostrará para la notificación. Asegúrese de que haya empaquetado el icono en la carpeta res/drawable, con la aplicación cliente. +- **Prioridad**: especifica las opciones para asignar la prioridad de entrega a los mensajes. Una prioridad `high` o `max` dará como resultado una notificación de aviso, mientras que los mensajes con prioridad `low` o `default` no establecerán conexiones de red en un dispositivo en modo suspendido. Para los mensajes con la opción definida en `min`, se enviará una notificación silenciosa. +- **Visibilidad**: puede optar por definir la opción de visibilidad de notificación en `public` o `private`. La opción `private` limita la visualización pública y puede habilitarla si el dispositivo está protegido mediante pin o un patrón y si el valor de notificación está definido para ocultar contenido privado de las notificaciones. Cuando la visibilidad se establece como `private`, debe mencionarse algún campo de "redacción". Solo se mostrará el contenido especificado en el campo de redacción en la pantalla bloqueada del dispositivo. Si se elige `public` se entregarán notificaciones que se pueden leer libremente. +- **Tiempo de duración**: este valor se establece en segundos. Si no se especifica este parámetro, el servidor FCM/GCM almacenará el mensaje cuatro semanas e intentará entregarlo. La validez caduca transcurridas cuatro semanas. El intervalo de valores posible es de 0 a 2.419.200 segundos. +- **Retrasar cuando esté desocupado**: si se define como `true`, el servidor FCM/GCM no entregará la notificación cuando el dispositivo esté desocupado. Establezca este valor en `false` para garantizar que se entregan notificaciones aunque el dispositivo esté desocupado. +- **Sync**: al definir esta opción como `true`, se sincronizan las notificaciones de todos los dispositivos registrados. Si un usuario dispone de varios dispositivos con la misma aplicación instalada, al leer la notificación en un dispositivo se suprimirán las notificaciones del resto de los dispositivos. Debe asegurarse que está registrado al servicio {{site.data.keyword.mobilepushshort}} con userId para que esta opción funcione. +- **Carga útil adicional**: permite especificar valores personalizados de carga útil para las notificaciones. + + +## Pasos siguientes +{: #next_steps_tags} + +Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. + +Añada estas características de servicio de notificaciones push a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). +Para utilizar opciones de notificaciones avanzadas, consulte [Habilitación de notificaciones push avanzadas](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/es/c_chrome_firefox_enable.md b/services/mobilepush/nl/es/c_chrome_firefox_enable.md index 09e7988a6..094558336 100644 --- a/services/mobilepush/nl/es/c_chrome_firefox_enable.md +++ b/services/mobilepush/nl/es/c_chrome_firefox_enable.md @@ -1,131 +1,131 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Habilitación de aplicaciones web para recibir {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -Última actualización: 16 de febrero de 2017 -{: .last-updated} - -Puede habilitar las aplicaciones web Google Chrome, Mozilla Firefox y Safari para recibir {{site.data.keyword.mobilepushshort}}. Asegúrese de haber [configurado credenciales para un proveedor de notificaciones](t__main_push_config_provider.html) antes de continuar con estos pasos. - -## Instalación del SDK del cliente de navegador web para {{site.data.keyword.mobilepushshort}} -{: #web_install} - -En este tema se describe cómo instalar y utilizar el SDK Push de JavaScript del cliente para seguir desarrollando aplicaciones web. - -### Inicialización en la aplicación web - -Para instalar el SDK de Javascript en la aplicación web de Google Chrome, siga estos pasos: - -Descargue los archivos `BMSPushSDK.js`, `BMSPushServiceWorker.js` y `manifest_Website.json` desde el [SDK Push Web de Bluemix](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. - -1. Edite el archivo `manifest_Website.json`. - - Para el navegador Google Chrome, cambie `name` por el nombre de su sitio. Por ejemplo, `www.dailynewsupdates.com`. Cambie `gcm_sender_id` por su sender_ID de Firebase Cloud Messaging (FCM) o Google Cloud Messaging (GCM). Para obtener más información, consulte [Cómo obtener el ID de remitente y la clave de la API](t_push_provider_android.html). El valor de gcm_sender_id solo contiene números. - - ``` - { - "name": "YOUR_WEBSITE_NAME", - "gcm_sender_id": "GCM_Sender_Id" - } - ``` - {: codeblock} - - - Para el navegador Mozilla Firefox, añada los valores siguientes al archivo `manifest_Website.json`. Especifique el valor adecuado para `name`. Debe ser el nombre del sitio web. - - ``` - { - "name": "YOUR_WEBSITE_NAME" - } - ``` - {: codeblock} - -2. Cambie el nombre del archivo `manifest_Website.json` a `manifest.json`. -3. Añada `BMSPushSDK.js`, `BMSPushServiceWorker.js` y `manifest.json` al directorio raíz del sitio web. -3. Incluya `manifest.json` en la etiqueta `` del archivo html. - ``` - - ``` - {: codeblock} -4. Incluya el SDK de envío web de Bluemix en la aplicación web. - ``` - - ``` - {: codeblock} - -**Nota**: Asegúrese de que el código esté desplegado y de que se pueda acceder al enlace de muestra mediante `https`, y no `http`. - -## Inicialización del SDK Push Web -{: #web_initialize} - -Inicialice el SDK Push con `app GUID` y `app Region` del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. - -Para obtener el GUID de la aplicación, seleccione la opción **Configuración** en el panel de navegación de los servicios push inicializados y haga clic en **Opciones móviles**. Modifique el fragmento de código para que utilice el parámetro appGUID del servicio de notificaciones push de Bluemix. - -`App Region` especifica la ubicación en la que se aloja el servicio {{site.data.keyword.mobilepushshort}}. Puede utilizar uno de estos tres valores: - - - Para Dallas, EE.UU.: `.ng.bluemix.net` - - Para RU: `.eu-gb.bluemix.net` - - Para Sídney: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Región donde se aloja el servicio", - "clientSecret":"clientSecret del servicio push" - "websitePushIDSafari": "Parámetro opcional sólo para Notificaciones Push de Safari. El valor debe coincidir con el ID Push del sitio web proporcionado durante la configuración del lado del servidor". - } - bmsPush.initialize(initParams, callback) -``` - {: codeblock} - -**Nota**: Si se modifican las credenciales de FCM para el SDK Push Web, es posible que falle la entrega de mensajes para el navegador Chrome. Asegúrese de que invoca `bmsPush.unRegisterDevice` para evitar anomalías. - -Es posible que vea errores relacionados con la configuración su especifica un parámetro erróneo. Para obtener más información, consulte [Resolución de errores de configuración de push web](troubleshooting_config_errors.html). - -## Registro de la aplicación web -{: #web_register} - -Utilice la API **register()** para registrar el dispositivo con el servicio {{site.data.keyword.mobilepushshort}}. Utilice una de las siguientes opciones, según el navegador. - -- Para efectuar el registro desde Google Chrome, añada el URL del sitio web y la clave de API de Firebase Cloud Messaging (FCM) o Google Cloud Messaging (GCM) en el panel de control de configuración web del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. Para obtener más información, consulte [Configuración de credenciales para Google Cloud Messaging](t_push_provider_android.html) en la configuración de Chrome. - -- Para efectuar el registro desde Mozilla Firefox, añada el URL del sitio web en el panel de control de configuración web del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. - -Utilice el siguiente fragmento de código para realizar el registro en el servicio {{site.data.keyword.mobilepushshort}} de Bluemix. - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Región donde se aloja el servicio", - "clientSecret":"clientSecret del servicio push" - "websitePushIDSafari": "Parámetro opcional sólo para Notificaciones Push de Safari. El valor debe coincidir con el ID Push del sitio web proporcionado durante la configuración del lado del servidor". - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Habilitación de aplicaciones web para recibir {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +Última actualización: 16 de febrero de 2017 +{: .last-updated} + +Puede habilitar las aplicaciones web Google Chrome, Mozilla Firefox y Safari para recibir {{site.data.keyword.mobilepushshort}}. Asegúrese de haber [configurado credenciales para un proveedor de notificaciones](t__main_push_config_provider.html) antes de continuar con estos pasos. + +## Instalación del SDK del cliente de navegador web para {{site.data.keyword.mobilepushshort}} +{: #web_install} + +En este tema se describe cómo instalar y utilizar el SDK Push de JavaScript del cliente para seguir desarrollando aplicaciones web. + +### Inicialización en la aplicación web + +Para instalar el SDK de Javascript en la aplicación web de Google Chrome, siga estos pasos: + +Descargue los archivos `BMSPushSDK.js`, `BMSPushServiceWorker.js` y `manifest_Website.json` desde el [SDK Push Web de Bluemix](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. + +1. Edite el archivo `manifest_Website.json`. + - Para el navegador Google Chrome, cambie `name` por el nombre de su sitio. Por ejemplo, `www.dailynewsupdates.com`. Cambie `gcm_sender_id` por su sender_ID de Firebase Cloud Messaging (FCM) o Google Cloud Messaging (GCM). Para obtener más información, consulte [Cómo obtener el ID de remitente y la clave de la API](t_push_provider_android.html). El valor de gcm_sender_id solo contiene números. + + ``` + { + "name": "YOUR_WEBSITE_NAME", + "gcm_sender_id": "GCM_Sender_Id" + } + ``` + {: codeblock} + + - Para el navegador Mozilla Firefox, añada los valores siguientes al archivo `manifest_Website.json`. Especifique el valor adecuado para `name`. Debe ser el nombre del sitio web. + + ``` + { + "name": "YOUR_WEBSITE_NAME" + } + ``` + {: codeblock} + +2. Cambie el nombre del archivo `manifest_Website.json` a `manifest.json`. +3. Añada `BMSPushSDK.js`, `BMSPushServiceWorker.js` y `manifest.json` al directorio raíz del sitio web. +3. Incluya `manifest.json` en la etiqueta `` del archivo html. + ``` + + ``` + {: codeblock} +4. Incluya el SDK de envío web de Bluemix en la aplicación web. + ``` + + ``` + {: codeblock} + +**Nota**: Asegúrese de que el código esté desplegado y de que se pueda acceder al enlace de muestra mediante `https`, y no `http`. + +## Inicialización del SDK Push Web +{: #web_initialize} + +Inicialice el SDK Push con `app GUID` y `app Region` del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. + +Para obtener el GUID de la aplicación, seleccione la opción **Configuración** en el panel de navegación de los servicios push inicializados y haga clic en **Opciones móviles**. Modifique el fragmento de código para que utilice el parámetro appGUID del servicio de notificaciones push de Bluemix. + +`App Region` especifica la ubicación en la que se aloja el servicio {{site.data.keyword.mobilepushshort}}. Puede utilizar uno de estos tres valores: + + - Para Dallas, EE.UU.: `.ng.bluemix.net` + - Para RU: `.eu-gb.bluemix.net` + - Para Sídney: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Región donde se aloja el servicio", + "clientSecret":"clientSecret del servicio push" + "websitePushIDSafari": "Parámetro opcional sólo para Notificaciones Push de Safari. El valor debe coincidir con el ID Push del sitio web proporcionado durante la configuración del lado del servidor". + } + bmsPush.initialize(initParams, callback) +``` + {: codeblock} + +**Nota**: Si se modifican las credenciales de FCM para el SDK Push Web, es posible que falle la entrega de mensajes para el navegador Chrome. Asegúrese de que invoca `bmsPush.unRegisterDevice` para evitar anomalías. + +Es posible que vea errores relacionados con la configuración su especifica un parámetro erróneo. Para obtener más información, consulte [Resolución de errores de configuración de push web](troubleshooting_config_errors.html). + +## Registro de la aplicación web +{: #web_register} + +Utilice la API **register()** para registrar el dispositivo con el servicio {{site.data.keyword.mobilepushshort}}. Utilice una de las siguientes opciones, según el navegador. + +- Para efectuar el registro desde Google Chrome, añada el URL del sitio web y la clave de API de Firebase Cloud Messaging (FCM) o Google Cloud Messaging (GCM) en el panel de control de configuración web del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. Para obtener más información, consulte [Configuración de credenciales para Google Cloud Messaging](t_push_provider_android.html) en la configuración de Chrome. + +- Para efectuar el registro desde Mozilla Firefox, añada el URL del sitio web en el panel de control de configuración web del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. + +Utilice el siguiente fragmento de código para realizar el registro en el servicio {{site.data.keyword.mobilepushshort}} de Bluemix. + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Región donde se aloja el servicio", + "clientSecret":"clientSecret del servicio push" + "websitePushIDSafari": "Parámetro opcional sólo para Notificaciones Push de Safari. El valor debe coincidir con el ID Push del sitio web proporcionado durante la configuración del lado del servidor". + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + + + diff --git a/services/mobilepush/nl/es/c_chrome_firefox_enable_send.md b/services/mobilepush/nl/es/c_chrome_firefox_enable_send.md index 3f2d8c280..8e7dd29ee 100644 --- a/services/mobilepush/nl/es/c_chrome_firefox_enable_send.md +++ b/services/mobilepush/nl/es/c_chrome_firefox_enable_send.md @@ -1,43 +1,43 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Envío de notificaciones básicas a navegadores web -{: #web_notifications} -Última actualización: 11 de enero de 2017 -{: .last-updated} - -Una vez que haya desarrollado sus aplicaciones, puede enviar una notificación push. - -1. Seleccione **Enviar notificaciones** y para redactar un mensaje seleccione **Notificaciones web** como opción **Enviar a**. -2. Escriba el mensaje en el campo **Mensaje**. -3. Puede elegir que se proporcionen valores opcionales: - - **Título de notificación**: es el texto que se visualizará como mensaje en la cabecera de la alerta de mensaje. - - **URL de icono de notificación**: si el mensaje debe entregarse con un icono de notificación de la aplicación, indique el enlace al icono en este campo. - - **Tiempo de duración**: Notifica al servidor sobre la validez de los mensajes. -4. Para notificaciones web enviadas al navegador Safari, hay alguna información adicional necesaria: - - **Acción**: Esta es la etiqueta del botón de acción. - - **Argumentos URL**: Los argumentos URL que necesitan utilizarse con esta notificación. Asegúrese de que se proporciona en la forma de una matriz JSON. - -En la imagen siguiente se muestra la opción de notificaciones web en el panel de control. - - ![pantalla Notificaciones](images/DashboardWebpush.jpg) - - -## Pasos siguientes - {: #next_steps_tags} - -Una vez que haya configurado correctamente las notificaciones básicas, puede optar por configurar las notificaciones basadas en código y las opciones avanzadas. - -Añada las características de servicio de {{site.data.keyword.mobilepushshort}} a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones avanzadas](t_advance_badge_sound_payload.html). - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Envío de notificaciones básicas a navegadores web +{: #web_notifications} +Última actualización: 11 de enero de 2017 +{: .last-updated} + +Una vez que haya desarrollado sus aplicaciones, puede enviar una notificación push. + +1. Seleccione **Enviar notificaciones** y para redactar un mensaje seleccione **Notificaciones web** como opción **Enviar a**. +2. Escriba el mensaje en el campo **Mensaje**. +3. Puede elegir que se proporcionen valores opcionales: + - **Título de notificación**: es el texto que se visualizará como mensaje en la cabecera de la alerta de mensaje. + - **URL de icono de notificación**: si el mensaje debe entregarse con un icono de notificación de la aplicación, indique el enlace al icono en este campo. + - **Tiempo de duración**: Notifica al servidor sobre la validez de los mensajes. +4. Para notificaciones web enviadas al navegador Safari, hay alguna información adicional necesaria: + - **Acción**: Esta es la etiqueta del botón de acción. + - **Argumentos URL**: Los argumentos URL que necesitan utilizarse con esta notificación. Asegúrese de que se proporciona en la forma de una matriz JSON. + +En la imagen siguiente se muestra la opción de notificaciones web en el panel de control. + + ![pantalla Notificaciones](images/DashboardWebpush.jpg) + + +## Pasos siguientes + {: #next_steps_tags} + +Una vez que haya configurado correctamente las notificaciones básicas, puede optar por configurar las notificaciones basadas en código y las opciones avanzadas. + +Añada las características de servicio de {{site.data.keyword.mobilepushshort}} a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones avanzadas](t_advance_badge_sound_payload.html). + + + diff --git a/services/mobilepush/nl/es/c_cordova_enable.md b/services/mobilepush/nl/es/c_cordova_enable.md index 1ac06d1ee..26f26a22a 100755 --- a/services/mobilepush/nl/es/c_cordova_enable.md +++ b/services/mobilepush/nl/es/c_cordova_enable.md @@ -1,318 +1,318 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Habilitación de aplicaciones Cordova para recibir notificaciones push -{: #cordova_enable} -Última actualización: 18 de enero de 2017 -{: .last-updated} - -Cordova es una plataforma para crear aplicaciones híbridas con JavaScript, CSS y HTML. El servicio de {{site.data.keyword.mobilepushshort}} da soporte al desarrollo de aplicaciones para iOS y Android basadas en Cordova. - -Puede habilitar las aplicaciones de Cordova para recibir notificaciones push en sus dispositivos. - -## Instalación del plug-in push de Cordova -{: #cordova_install} - -Instale y utilice el plug-in push del cliente para seguir desarrollando sus aplicaciones Cordova. Esto también instala el plug-in Core de Cordova, que inicializa la conexión a Bluemix. - -### Antes de empezar - -1. Descargue las versiones más recientes de Android Studio SDK y Xcode. -1. Configure el emulador. Para Android Studio, utilice un emulador que dé soporte a la API de Google Play. -1. Instale la herramienta de línea de mandatos de Git. Para Windows, asegúrese de que selecciona la opción **Ejecutar Git desde la ventana del indicador de mandatos**. Para obtener información sobre cómo descargar e instalar esta herramienta, consulte [Git ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://git-scm.com/downloads){: new_window}. -1. Instale la herramienta Node.js y NPM (Node Package Manager). La herramienta de línea de mandatos NPM está empaquetada con Node.js. Para obtener información sobre cómo descargar e instalar Node.js, consulte [Node.js ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://nodejs.org/en/download/){: new_window}. -1. Desde la línea de mandatos, instale las herramientas de línea de mandatos de Cordova mediante el mandato **npm install -g cordova**. Esto es necesario para utilizar el plug-in push de Cordova. Para obtener información sobre cómo instalar Cordova y configurar la app de Cordova, consulte [Cordova Apache ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://cordova.apache.org/#getstarted){: new_window}. Para obtener más información, consulte [archivo Readme ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} del plug-in de push de Cordova. -1. Vaya a la carpeta en la que desea crear la aplicación de Cordova y ejecute el mandato siguiente para crear una aplicación de Cordova. Si ya tiene una aplicación de Cordova, vaya al paso 3. -```cordova create your_app_name -cd your_app_name -``` - {: codeblock} -- Opcional: Puede editar el archivo **config.xml** y cambiar el nombre de la aplicación en el elemento a uno de su elección, en lugar del nombre HelloCordova predeterminado. - -Asegúrese de que especifica el ID de paquete correcto. Los siguientes mensajes de error se pueden dar en Xcode, si se especifica un ID de paquete incorrecto. - -* El ejecutable se ha firmado con titularidades no válidas. -* Las titularidades especificadas en el archivo Titularidades de firmado de código de la aplicación no coinciden con las especificadas en el perfil de suministro. Para solucionar este problema, especifique el ID de paquete correcto en Xcode o en el archivo **config.xml** de la aplicación de Cordova. - -1. Añada la API soportada mínima o la declaración de destino del despliegue al archivo config.xml para la aplicación de Cordova. El valor de minSdkVersion debe ser superior a 15. El valor targetSdkVersion siempre debe reflejar el SDK de Android más reciente disponible desde Google. - - * Android: Con el editor, abra el archivo **config.xml** y actualice el elemento -`` con versiones SDK de destino y mínimas: - - ``` - - - - - - ``` - {: codeblock} - - * iOS: Actualice el elemento con una declaración de destino de despliegue: - - ``` - - - - - ``` - {: codeblock} - -1. Desde la interfaz de línea de mandatos (CLI) de Cordova, añada las plataformas iOS, Android o ambas utilizando el siguiente mandato: -``` -cordova platform add ios - cordova platform add android -``` - {: codeblock} - -1. Desde el directorio raíz de la aplicación de Cordova, especifique el mandato siguiente para instalar el plug-in push de Cordova: **cordova plugin add bms-push**. En función de las plataformas añadidas, podría ver: -``` -Installing "bms-push" for android -Installing "bms-push" for ios -``` - {: codeblock} - -1. Desde your-app-root-folder, verifique que los plug-ins Core y Push de Cordova se hayan instalado correctamente; para ello, utilice el mandato **cordova plugin list**. En función de las plataformas añadidas, podría ver: -``` -bms-core "BMSCore" -bms-push "BMSPush" -``` - {: codeblock} - -1. Configure su entorno de desarrollo de iOS. -2. Cree y ejecute la aplicación con Xcode. -1. Descargue `google-services.json` de Firebase para android y colóquelos en la carpeta raíz del proyecto Cordova, en `[your-app-name]/platforms/android. - 1. Vaya a `[your-app-name]/platforms/android`. - 2. Abra el archivo `build.gradle` (Vía de acceso : plataforma > android > build.gradle). - 3. Busque el texto `buildscript` en el archivo `build.gradle`. - 4. Después de la línea classpath, añada la línea classpath 'com.google.gms:google-services:3.0.0' - 5. Busque "dependencies". Seleccione las dependencias que contengan el texto `compile` y el fin de dichas dependencias; después de las mismas, añada esta línea:apply plugin: 'com.google.gms.google-services'. - 6. Prepare y compile el proyecto Cordova Android. - ``` - cordova prepare android - cordova build android - ``` - {: codeblock} - **Nota**: Antes de abrir el proyecto en Android Studio, cree la aplicación de Cordova mediante la CLI de Cordova. De esta forma no se producirán errores de compilación. - -## Inicialización del plug-in de Cordova -{: #cordova_initialize} - -Para poder utilizar el plug-in de Cordova del servicio {{site.data.keyword.mobilepushshort}}, debe inicializarlo -pasando la ruta de la aplicación y el GUID de aplicaciones. Tras inicializar el plug-in, puede conectarse a la aplicación del servidor que ha creado en el panel de control de Bluemix. El plug-in de Cordova es el continente para los -SDK de cliente de iOS y Android para habilitar a una aplicación de Cordova a comunicarse con los servicios de Bluemix. - -1. Inicialice el BMSClient copiando y pegando el siguiente fragmento de código en el archivo JavaScript principal (normalmente ubicado en el directorio **www/js**). - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("YOUR APP REGION"); - var category = {}; - BMSPush.initialize(appGUID,clientSecret,category); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); - } -``` - {: codeblock} - -Pase la región para la aplicación. Se proporcionan las siguientes constantes: - -``` -REGION_US_SOUTH // ".ng.bluemix.net"; -REGION_UK //".eu-gb.bluemix.net"; -REGION_SYDNEY // ".au-syd.bluemix.net"; -``` - -Por ejemplo: - -``` -BMSClient.initialize(BMSClient.REGION_US_SOUTH); -``` - -**Nota**: Si ha creado una app de Cordova utilizando la CLI de Cordova, por ejemplo, el mandato Cordova create app-name, coloque este código Javascript en el archivo index.js, después de que la función app.receivedEvent dentro de la función onDeviceReady: function() inicialice el `BMSClient`. - - -## Registro de dispositivos -{: #cordova_register} - - -Para registrar un dispositivo con el servicio {{site.data.keyword.mobilepushshort}}, llame el método de registro. Copie el siguiente fragmento de código en la aplicación de Cordova para registrar un dispositivo. - -``` -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); -``` - {: codeblock} - -En el siguiente fragmento de código JavaScript se muestra cómo inicializar el SDK del cliente de Bluemix Mobile Services, cómo registrar un dispositivo con el servicio {{site.data.keyword.mobilepushshort}} y cómo escuchar las notificaciones push. Incluya este código en el archivo Javascript. - -Dentro de la **onDeviceReady: function()**. - -``` -onDeviceReady: function() { -app.receivedEvent('deviceready'); -BMSClient.initialize("YOUR APP REGION"); -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; -BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -Añada el siguiente fragmento de código de Swift a la clase de delegado de la aplicación. - -``` -// Registre la señal del dispositivo con Bluemix Push Notification Service -func application(application: UIApplication, - didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { - CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) -} -// Maneje el error cuando no haya podido registrar la señal del dispositivo con APNs -func application(application: UIApplication, - didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) -} -``` - {: codeblock} - -##Pasos siguientes - -{: #cordova_register_next} - -Cree el proyecto y, a continuación, ejecute el proyecto utilizando los mandatos siguientes: - -####Android -{: android-next-steps} - -``` -cordova build android -``` - {: codeblock} - -``` -cordova run android -``` - {: codeblock} - -####iOS -{: ios-next-steps} - -``` -cordova build ios -``` - {: codeblock} - -``` -cordova run ios -``` - {: codeblock} - -## Recepción de notificaciones push en dispositivos -{: #cordova_receive} - -Copie el siguiente fragmento de código para recibir notificaciones push en los dispositivos. - -###JavaScript - -Añada el siguiente fragmento de código JavaScript a la parte web de la aplicación de Cordova. -``` -var showNotification = function(notif) { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -###Propiedades de notificación de Android - -En la sección siguiente se listan las propiedades de notificación de Android: - -* **message** - mensaje de notificación de Push -* **payload** - objeto JSON que contiene una carga útil de notificación - - -###Propiedades de notificación de iOS - -En la sección siguiente se listan las propiedades de notificación de iOS: - -* **message** - mensaje de notificación de Push -* **payload** - objeto JSON que contiene una carga útil de notificación -action-loc-key - la serie se utiliza como clave para obtener una serie localizada en la localización actual para que la utilice el título del botón adecuado, en lugar de `Vista`. -* **badge** - El número que se mostrará como el identificador del icono de app. Si falta esta propiedad, el identificador no se modificará. Para eliminar el identificador, establezca el valor de esta propiedad en 0. -* **sound** - El nombre de un archivo de sonido del paquete de la app de la carpeta Biblioteca/Sonidos del contenedor de datos de la aplicación. - - -Añada los siguientes fragmentos de código de Swift a la clase de delegado de la aplicación. -``` -// Maneje la recepción de una notificación remota -func application(application: UIApplication, - didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) -} -``` - {: codeblock} - -``` -// Maneje la recepción de una notificación remota al iniciar -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary - if remoteNotif != nil { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) - } -} -``` - {: codeblock} - -## Envío de notificaciones push básicas -{: #push-send-notifications} - -Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas. - -Para ello, realice estos pasos: - -1. Seleccione **Enviar notificaciones** y para redactar un mensaje seleccione la opción **Enviar a**. Las opciones admitidas son **Dispositivo por etiqueta**, **ID de dispositivo**, **ID de usuario**, **Dispositivos Android**, **Dispositivos iOS**, **Notificaciones web** y **Todos los dispositivos**. -**Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos suscritos a {{site.data.keyword.mobilepushshort}} recibirán notificaciones. -![pantalla Notificaciones](images/tag_notification.jpg) - -2. En el campo **Mensaje**, redacte el mensaje. Elija configurar los valores opcionales según sea necesario. -3. Pulse **Enviar**. -3. Verifique que los dispositivos hayan recibido la notificación. - -En la captura de pantalla siguiente se muestra un recuadro de alerta en el que se maneja una {{site.data.keyword.mobilepushshort}} -en el primer plano en un dispositivo Android e iOS. - -![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) - -![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) - - En la siguiente imagen se muestra una {{site.data.keyword.mobilepushshort}} en segundo plano para Android. -![Notificación push en el fondo en Android](images/background.jpg) - -## Pasos siguientes -{: #next_steps_tags} - -Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. - -Añada las características de servicio de {{site.data.keyword.mobilepushshort}} a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). -Para utilizar opciones de notificaciones avanzadas, consulte [Habilitación de notificaciones push avanzadas](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Habilitación de aplicaciones Cordova para recibir notificaciones push +{: #cordova_enable} +Última actualización: 18 de enero de 2017 +{: .last-updated} + +Cordova es una plataforma para crear aplicaciones híbridas con JavaScript, CSS y HTML. El servicio de {{site.data.keyword.mobilepushshort}} da soporte al desarrollo de aplicaciones para iOS y Android basadas en Cordova. + +Puede habilitar las aplicaciones de Cordova para recibir notificaciones push en sus dispositivos. + +## Instalación del plug-in push de Cordova +{: #cordova_install} + +Instale y utilice el plug-in push del cliente para seguir desarrollando sus aplicaciones Cordova. Esto también instala el plug-in Core de Cordova, que inicializa la conexión a Bluemix. + +### Antes de empezar + +1. Descargue las versiones más recientes de Android Studio SDK y Xcode. +1. Configure el emulador. Para Android Studio, utilice un emulador que dé soporte a la API de Google Play. +1. Instale la herramienta de línea de mandatos de Git. Para Windows, asegúrese de que selecciona la opción **Ejecutar Git desde la ventana del indicador de mandatos**. Para obtener información sobre cómo descargar e instalar esta herramienta, consulte [Git ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://git-scm.com/downloads){: new_window}. +1. Instale la herramienta Node.js y NPM (Node Package Manager). La herramienta de línea de mandatos NPM está empaquetada con Node.js. Para obtener información sobre cómo descargar e instalar Node.js, consulte [Node.js ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://nodejs.org/en/download/){: new_window}. +1. Desde la línea de mandatos, instale las herramientas de línea de mandatos de Cordova mediante el mandato **npm install -g cordova**. Esto es necesario para utilizar el plug-in push de Cordova. Para obtener información sobre cómo instalar Cordova y configurar la app de Cordova, consulte [Cordova Apache ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://cordova.apache.org/#getstarted){: new_window}. Para obtener más información, consulte [archivo Readme ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} del plug-in de push de Cordova. +1. Vaya a la carpeta en la que desea crear la aplicación de Cordova y ejecute el mandato siguiente para crear una aplicación de Cordova. Si ya tiene una aplicación de Cordova, vaya al paso 3. +```cordova create your_app_name +cd your_app_name +``` + {: codeblock} +- Opcional: Puede editar el archivo **config.xml** y cambiar el nombre de la aplicación en el elemento a uno de su elección, en lugar del nombre HelloCordova predeterminado. + +Asegúrese de que especifica el ID de paquete correcto. Los siguientes mensajes de error se pueden dar en Xcode, si se especifica un ID de paquete incorrecto. + +* El ejecutable se ha firmado con titularidades no válidas. +* Las titularidades especificadas en el archivo Titularidades de firmado de código de la aplicación no coinciden con las especificadas en el perfil de suministro. Para solucionar este problema, especifique el ID de paquete correcto en Xcode o en el archivo **config.xml** de la aplicación de Cordova. + +1. Añada la API soportada mínima o la declaración de destino del despliegue al archivo config.xml para la aplicación de Cordova. El valor de minSdkVersion debe ser superior a 15. El valor targetSdkVersion siempre debe reflejar el SDK de Android más reciente disponible desde Google. + + * Android: Con el editor, abra el archivo **config.xml** y actualice el elemento +`` con versiones SDK de destino y mínimas: + + ``` + + + + + + ``` + {: codeblock} + + * iOS: Actualice el elemento con una declaración de destino de despliegue: + + ``` + + + + + ``` + {: codeblock} + +1. Desde la interfaz de línea de mandatos (CLI) de Cordova, añada las plataformas iOS, Android o ambas utilizando el siguiente mandato: +``` +cordova platform add ios + cordova platform add android +``` + {: codeblock} + +1. Desde el directorio raíz de la aplicación de Cordova, especifique el mandato siguiente para instalar el plug-in push de Cordova: **cordova plugin add bms-push**. En función de las plataformas añadidas, podría ver: +``` +Installing "bms-push" for android +Installing "bms-push" for ios +``` + {: codeblock} + +1. Desde your-app-root-folder, verifique que los plug-ins Core y Push de Cordova se hayan instalado correctamente; para ello, utilice el mandato **cordova plugin list**. En función de las plataformas añadidas, podría ver: +``` +bms-core "BMSCore" +bms-push "BMSPush" +``` + {: codeblock} + +1. Configure su entorno de desarrollo de iOS. +2. Cree y ejecute la aplicación con Xcode. +1. Descargue `google-services.json` de Firebase para android y colóquelos en la carpeta raíz del proyecto Cordova, en `[your-app-name]/platforms/android. + 1. Vaya a `[your-app-name]/platforms/android`. + 2. Abra el archivo `build.gradle` (Vía de acceso : plataforma > android > build.gradle). + 3. Busque el texto `buildscript` en el archivo `build.gradle`. + 4. Después de la línea classpath, añada la línea classpath 'com.google.gms:google-services:3.0.0' + 5. Busque "dependencies". Seleccione las dependencias que contengan el texto `compile` y el fin de dichas dependencias; después de las mismas, añada esta línea:apply plugin: 'com.google.gms.google-services'. + 6. Prepare y compile el proyecto Cordova Android. + ``` + cordova prepare android + cordova build android + ``` + {: codeblock} + **Nota**: Antes de abrir el proyecto en Android Studio, cree la aplicación de Cordova mediante la CLI de Cordova. De esta forma no se producirán errores de compilación. + +## Inicialización del plug-in de Cordova +{: #cordova_initialize} + +Para poder utilizar el plug-in de Cordova del servicio {{site.data.keyword.mobilepushshort}}, debe inicializarlo +pasando la ruta de la aplicación y el GUID de aplicaciones. Tras inicializar el plug-in, puede conectarse a la aplicación del servidor que ha creado en el panel de control de Bluemix. El plug-in de Cordova es el continente para los +SDK de cliente de iOS y Android para habilitar a una aplicación de Cordova a comunicarse con los servicios de Bluemix. + +1. Inicialice el BMSClient copiando y pegando el siguiente fragmento de código en el archivo JavaScript principal (normalmente ubicado en el directorio **www/js**). + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("YOUR APP REGION"); + var category = {}; + BMSPush.initialize(appGUID,clientSecret,category); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); + } +``` + {: codeblock} + +Pase la región para la aplicación. Se proporcionan las siguientes constantes: + +``` +REGION_US_SOUTH // ".ng.bluemix.net"; +REGION_UK //".eu-gb.bluemix.net"; +REGION_SYDNEY // ".au-syd.bluemix.net"; +``` + +Por ejemplo: + +``` +BMSClient.initialize(BMSClient.REGION_US_SOUTH); +``` + +**Nota**: Si ha creado una app de Cordova utilizando la CLI de Cordova, por ejemplo, el mandato Cordova create app-name, coloque este código Javascript en el archivo index.js, después de que la función app.receivedEvent dentro de la función onDeviceReady: function() inicialice el `BMSClient`. + + +## Registro de dispositivos +{: #cordova_register} + + +Para registrar un dispositivo con el servicio {{site.data.keyword.mobilepushshort}}, llame el método de registro. Copie el siguiente fragmento de código en la aplicación de Cordova para registrar un dispositivo. + +``` +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); +``` + {: codeblock} + +En el siguiente fragmento de código JavaScript se muestra cómo inicializar el SDK del cliente de Bluemix Mobile Services, cómo registrar un dispositivo con el servicio {{site.data.keyword.mobilepushshort}} y cómo escuchar las notificaciones push. Incluya este código en el archivo Javascript. + +Dentro de la **onDeviceReady: function()**. + +``` +onDeviceReady: function() { +app.receivedEvent('deviceready'); +BMSClient.initialize("YOUR APP REGION"); +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; +BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +Añada el siguiente fragmento de código de Swift a la clase de delegado de la aplicación. + +``` +// Registre la señal del dispositivo con Bluemix Push Notification Service +func application(application: UIApplication, + didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { + CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) +} +// Maneje el error cuando no haya podido registrar la señal del dispositivo con APNs +func application(application: UIApplication, + didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) +} +``` + {: codeblock} + +## Pasos siguientes + +{: #cordova_register_next} + +Cree el proyecto y, a continuación, ejecute el proyecto utilizando los mandatos siguientes: + +#### Android +{: android-next-steps} + +``` +cordova build android +``` + {: codeblock} + +``` +cordova run android +``` + {: codeblock} + +#### iOS +{: ios-next-steps} + +``` +cordova build ios +``` + {: codeblock} + +``` +cordova run ios +``` + {: codeblock} + +## Recepción de notificaciones push en dispositivos +{: #cordova_receive} + +Copie el siguiente fragmento de código para recibir notificaciones push en los dispositivos. + +### JavaScript + +Añada el siguiente fragmento de código JavaScript a la parte web de la aplicación de Cordova. +``` +var showNotification = function(notif) { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +### Propiedades de notificación de Android + +En la sección siguiente se listan las propiedades de notificación de Android: + +* **message** - mensaje de notificación de Push +* **payload** - objeto JSON que contiene una carga útil de notificación + + +### Propiedades de notificación de iOS + +En la sección siguiente se listan las propiedades de notificación de iOS: + +* **message** - mensaje de notificación de Push +* **payload** - objeto JSON que contiene una carga útil de notificación +action-loc-key - la serie se utiliza como clave para obtener una serie localizada en la localización actual para que la utilice el título del botón adecuado, en lugar de `Vista`. +* **badge** - El número que se mostrará como el identificador del icono de app. Si falta esta propiedad, el identificador no se modificará. Para eliminar el identificador, establezca el valor de esta propiedad en 0. +* **sound** - El nombre de un archivo de sonido del paquete de la app de la carpeta Biblioteca/Sonidos del contenedor de datos de la aplicación. + + +Añada los siguientes fragmentos de código de Swift a la clase de delegado de la aplicación. +``` +// Maneje la recepción de una notificación remota +func application(application: UIApplication, + didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) +} +``` + {: codeblock} + +``` +// Maneje la recepción de una notificación remota al iniciar +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary + if remoteNotif != nil { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) + } +} +``` + {: codeblock} + +## Envío de notificaciones push básicas +{: #push-send-notifications} + +Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas. + +Para ello, realice estos pasos: + +1. Seleccione **Enviar notificaciones** y para redactar un mensaje seleccione la opción **Enviar a**. Las opciones admitidas son **Dispositivo por etiqueta**, **ID de dispositivo**, **ID de usuario**, **Dispositivos Android**, **Dispositivos iOS**, **Notificaciones web** y **Todos los dispositivos**. +**Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos suscritos a {{site.data.keyword.mobilepushshort}} recibirán notificaciones. +![pantalla Notificaciones](images/tag_notification.jpg) + +2. En el campo **Mensaje**, redacte el mensaje. Elija configurar los valores opcionales según sea necesario. +3. Pulse **Enviar**. +3. Verifique que los dispositivos hayan recibido la notificación. + +En la captura de pantalla siguiente se muestra un recuadro de alerta en el que se maneja una {{site.data.keyword.mobilepushshort}} +en el primer plano en un dispositivo Android e iOS. + +![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) + +![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) + + En la siguiente imagen se muestra una {{site.data.keyword.mobilepushshort}} en segundo plano para Android. +![Notificación push en el fondo en Android](images/background.jpg) + +## Pasos siguientes +{: #next_steps_tags} + +Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. + +Añada las características de servicio de {{site.data.keyword.mobilepushshort}} a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). +Para utilizar opciones de notificaciones avanzadas, consulte [Habilitación de notificaciones push avanzadas](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/es/c_enable_push.md b/services/mobilepush/nl/es/c_enable_push.md index 8a79da3b3..8be42ecd9 100755 --- a/services/mobilepush/nl/es/c_enable_push.md +++ b/services/mobilepush/nl/es/c_enable_push.md @@ -1,25 +1,25 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Habilitación de notificaciones para dispositivos móviles -{: #c_enable_push-notifications} -Última actualización: 18 de enero de 2017 -{: .last-updated} - -Asegúrese de haber [configurado credenciales para un proveedor de notificaciones](t__main_push_config_provider.html). - -Esta sección describe cómo habilitar las aplicaciones cliente (aplicaciones móviles y de navegador web y también aplicaciones y extensiones de Chrome) para recibir notificaciones push, cómo crear notificaciones básicas, cómo obtener e inicializar el SDK o el plug-in, y cómo registrar el dispositivo o navegador para recibir notificaciones push. También puede habilitar las aplicaciones móviles y de navegador web para recibir notificaciones push utilizando la [API REST](t_restapi.html). - -**Nota**: Para los registros de extensiones y aplicaciones de navegador o dispositivo Chrome, el servicio {{site.data.keyword.mobilepushshort}} mantiene una referencia única a las señales emitidas a partir de proveedores de notificaciones - -APNs para Apple o FCM para Google. Las señales las puede invalidar el proveedor de notificación del servicio {{site.data.keyword.mobilepushshort}} por diversos motivos. - -Por ejemplo, durante la desinstalación de una app en el dispositivo. En tal caso, cuando se intenta entregar una notificación en función de la respuesta de los proveedores que ha invalidado el dispositivo, el servicio {{site.data.keyword.mobilepushshort}} eliminará los registros de dispositivos o navegadores web. Esto a su vez podría restringir los intentos consecuentes al enviar notificación a los dispositivos invalidados. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Habilitación de notificaciones para dispositivos móviles +{: #c_enable_push-notifications} +Última actualización: 18 de enero de 2017 +{: .last-updated} + +Asegúrese de haber [configurado credenciales para un proveedor de notificaciones](t__main_push_config_provider.html). + +Esta sección describe cómo habilitar las aplicaciones cliente (aplicaciones móviles y de navegador web y también aplicaciones y extensiones de Chrome) para recibir notificaciones push, cómo crear notificaciones básicas, cómo obtener e inicializar el SDK o el plug-in, y cómo registrar el dispositivo o navegador para recibir notificaciones push. También puede habilitar las aplicaciones móviles y de navegador web para recibir notificaciones push utilizando la [API REST](t_restapi.html). + +**Nota**: Para los registros de extensiones y aplicaciones de navegador o dispositivo Chrome, el servicio {{site.data.keyword.mobilepushshort}} mantiene una referencia única a las señales emitidas a partir de proveedores de notificaciones - +APNs para Apple o FCM para Google. Las señales las puede invalidar el proveedor de notificación del servicio {{site.data.keyword.mobilepushshort}} por diversos motivos. + +Por ejemplo, durante la desinstalación de una app en el dispositivo. En tal caso, cuando se intenta entregar una notificación en función de la respuesta de los proveedores que ha invalidado el dispositivo, el servicio {{site.data.keyword.mobilepushshort}} eliminará los registros de dispositivos o navegadores web. Esto a su vez podría restringir los intentos consecuentes al enviar notificación a los dispositivos invalidados. diff --git a/services/mobilepush/nl/es/c_enable_push_webhook.md b/services/mobilepush/nl/es/c_enable_push_webhook.md index bc4242192..90110a2c8 100644 --- a/services/mobilepush/nl/es/c_enable_push_webhook.md +++ b/services/mobilepush/nl/es/c_enable_push_webhook.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Habilitación de webhooks -{: #tag_based_notifications} -Última actualización: 23 de enero de 2017 -{: .last-updated} - - -Con el servicio de {{site.data.keyword.mobilepushshort}}, puede elegir recibir alertas sobre información que se ha modificado. Los cambios en la información de la empresa crean sucesos, de los que se le puede notificar registrándolos como sucesos de webhook. Estos sucesos de webhook desencadenan una alerta. - -Los webhooks son devoluciones de llamada definidas por el usuario que desencadena un suceso, como por ejemplo el registro de un dispositivo o la suscripción a etiquetas. En el servicio de {{site.data.keyword.mobilepushshort}}, puede registrarse para los siguientes sucesos de webhook: - -- **onDeviceRegister**: Un suceso de webhook se desencadena para dispositivos registrados para push. -- **onDeviceUpdate**: Un suceso de webhook se desencadena cuando se actualiza la información en un dispositivo registrado. -- **onDeviceUnregister**: Un suceso de webhook se desencadena al eliminar el registro de un dispositivo. -- **onSubscribe**: Un suceso de webhook se desencadena cuando un usuario se suscribe a una etiqueta. -- **onUnsubscribe**: Un suceso de webhook se desencadena cuando un usuario elimina la suscripción a una etiqueta. -- **onNotificationSend**: Un suceso de webhook se desencadena para una notificación que se ha asignado. -- **onNotificationFailure**: Un suceso de webhook se desencadena para fallos de notificación. - - -**Nota**: Las asignaciones de notificación se realizan por lotes. Una asignación de mensaje puede tener varios sucesos de webhook, que pueden incluir tanto fallos como éxitos. -Los sucesos de webhook podrían tener el mismo messageID que el del mensaje asignado. - -Para obtener más información sobre webhooks, consulte [API REST de notificaciones Push de IBM ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Habilitación de webhooks +{: #tag_based_notifications} +Última actualización: 23 de enero de 2017 +{: .last-updated} + + +Con el servicio de {{site.data.keyword.mobilepushshort}}, puede elegir recibir alertas sobre información que se ha modificado. Los cambios en la información de la empresa crean sucesos, de los que se le puede notificar registrándolos como sucesos de webhook. Estos sucesos de webhook desencadenan una alerta. + +Los webhooks son devoluciones de llamada definidas por el usuario que desencadena un suceso, como por ejemplo el registro de un dispositivo o la suscripción a etiquetas. En el servicio de {{site.data.keyword.mobilepushshort}}, puede registrarse para los siguientes sucesos de webhook: + +- **onDeviceRegister**: Un suceso de webhook se desencadena para dispositivos registrados para push. +- **onDeviceUpdate**: Un suceso de webhook se desencadena cuando se actualiza la información en un dispositivo registrado. +- **onDeviceUnregister**: Un suceso de webhook se desencadena al eliminar el registro de un dispositivo. +- **onSubscribe**: Un suceso de webhook se desencadena cuando un usuario se suscribe a una etiqueta. +- **onUnsubscribe**: Un suceso de webhook se desencadena cuando un usuario elimina la suscripción a una etiqueta. +- **onNotificationSend**: Un suceso de webhook se desencadena para una notificación que se ha asignado. +- **onNotificationFailure**: Un suceso de webhook se desencadena para fallos de notificación. + + +**Nota**: Las asignaciones de notificación se realizan por lotes. Una asignación de mensaje puede tener varios sucesos de webhook, que pueden incluir tanto fallos como éxitos. +Los sucesos de webhook podrían tener el mismo messageID que el del mensaje asignado. + +Para obtener más información sobre webhooks, consulte [API REST de notificaciones Push de IBM ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}. diff --git a/services/mobilepush/nl/es/c_ios_enable.md b/services/mobilepush/nl/es/c_ios_enable.md index dc2bc4a85..344518106 100755 --- a/services/mobilepush/nl/es/c_ios_enable.md +++ b/services/mobilepush/nl/es/c_ios_enable.md @@ -1,335 +1,335 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#Habilitación de aplicaciones iOS para enviar {{site.data.keyword.mobilepushshort}} -{: #enable-push-ios-notifications} -Última actualización: 14 de febrero de 2017 -{: .last-updated} - -Puede habilitar aplicaciones iOS para enviar {{site.data.keyword.mobilepushshort}} a sus dispositivos. - - -##Instalación de CocoaPods -{: #enable-push-ios-notifications-install} - -Para un proyecto Xcode existente, puede configurar el SDK del cliente de Bluemix Mobile Services mediante la herramienta de gestión de dependencias de CocoaPods. Una alternativa es instalar el SDK manualmente. - -Para ver el archivo readme de Push de Swift, vaya a [Readme ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. - - - -1. Instale CocoaPods utilizando el siguiente mandato en su terminal Mac. -```$ sudo gem install cocoapods -``` - {: codeblock} -2. Especifique el mandato `pod init` en el terminal para inicializar CocoaPods. Asegúrese de ejecutar el mandato desde el directorio en el que se encuentra el proyecto Xcode. El mandato `pod init` crea un Podfile. -3. En el Podfile generado, añada las dependencias de SDK necesarias. Copie el siguiente Podfile. - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - pod 'BMSAnalyticsAPI' - end - ``` - {: codeblock} - -3. Desde el terminal, vaya a la carpeta del proyecto e instale las dependencias con el mandato `pod update`. - -El mandato instala las dependencias y crea un nuevo espacio de trabajo Xcode. -**Nota**: Asegúrese de abrir siempre el nuevo espacio de trabajo de Xcode, en lugar del archivo de proyecto Xcode original: -``` - $ open App.xcworkspace -``` - {: codeblock} - -El espacio de trabajo contiene el proyecto original y el proyecto Pods que contiene las dependencias. Para modificar una carpeta fuente de Bluemix mobile services, puede encontrarla en el proyecto Pods, en `Pods/yourImportedSourceFolder`, por ejemplo: `Pods/BMSPush`. - -##Adición de infraestructuras mediante Carthage -{: #carthage} - -Añada infraestructuras al proyecto utilizando [Carthage ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}. Tenga en cuenta que Carthage en Xcode8 no está soportado. - -1. Añada infraestructuras `BMSPush` a Cartfile: -``` - github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" -``` - {: codeblock} -2. Ejecute el mandato `carthage update`. Cuando la compilación finalice, arrastre `BMSPush.framework`, `BMSCore.framework` y `BMSAnalyticsAPI.framework` al proyecto Xcode. -3. Siga las instrucciones del sitio de [Carthage ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} para llevar a cabo la integración. - -##Configuración del SDK de iOS -{: ios-sdk} - -Configure el SDK de iOS, añada el código siguiente al archivo **AppDelegate.swift** de su aplicación. Tenga en cuenta que también se registra con APNs. -``` - func application(_ application: UIApplication, - didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool - { - BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") - } -``` - {: codeblock} - -##Utilización de infraestructuras importadas y carpetas fuente -{: using-imported-frameworks} - -Haga referencia al SDK del código. Asegúrese de que se cumplen los requisitos previos siguientes. - -- iOS 8.0 o superior -- Xcode 7 - -Escriba directivas `#import` para las cabeceras relevantes, por -ejemplo: -``` -//swift -import BMSCore -import BMSPush -``` - {: codeblock} - -Para leer el archivo readme de Push de Swift, consulte [Readme ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. - -**Nota**: La actualización del proyecto Pods utilizando los mandatos CocoaPods `pod install` o `pod update` puede alterar temporalmente las carpetas fuente de Bluemix Mobile services. Si desea conservar las versiones personalizadas -de los archivos originales, asegúrese de que se les ha hecho la copia de seguridad antes de emitir uno de estos -mandatos. - - -##Crear configuración -{: build-settings} - -Vaya a **Xcode > Crear configuración > Opciones de creación y Establecer la habilitación de Bitcode** en **No**. - -**Atención**: A partir de iOS 9, los cambios a la característica de App Transport Security (ATS) pueden afectar a la forma de manejar el proceso de autenticación. En las siguientes publicaciones del blog se ofrece más información sobre los cambios: [ATS y Bitcode en iOS 9 ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} y [Conecte su app iOS 9 a Bluemix hoy mismo ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. - -## Inicialización de SDK Push para aplicaciones iOS -{: #enable-push-ios-notifications-initialize} - -Un lugar común para colocar el código de inicialización se encuentra en el delegado de aplicación para la aplicación iOS. Pulse el enlace **Opciones móviles** en el panel de control Push para obtener la ruta y el GUID de la aplicación. - -###Inicialización del SDK principal -{: Initializing-the-core-sdk} - - -``` -// Inicialice el SDK principal para Swift con la GUID, la ruta y la región de IBM Bluemix -let myBMSClient = BMSClient.sharedInstance -myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") -``` - {: codeblock} - -### Ruta, GUID, y región Bluemix -{: route-guid-bluemix-region} - -####appRoute -{: ios-approute} - -Especifica la ruta que se asigna a la aplicación de servidor que ha creado en Bluemix. - -####GUID -{: ios-guid} - -Especifica la clave exclusiva asignada a la aplicación que ha creado en Bluemix. Este valor distingue entre mayúsculas y minúsculas. - -####bluemixRegionSuffix -{: ios-bluemixRegionSuffix} - -Especifica la ubicación en la que se aloja la aplicación. El parámetro `bluemixRegion` especifica qué despliegue de Bluemix está utilizando. Puede establecer este valor con una propiedad estática `BMSClient.REGION` y utilizar uno de estos tres valores: - -- BMSClient.Region.usSouth -- BMSClient.Region.unitedKingdom -- BMSClient.Region.sydney - -####AppGUID -{: ios-AppGUID} - -Especifica la clave AppGUID exclusiva asignada al servicio {{site.data.keyword.mobilepushshort}} que ha creado en Bluemix. - -###Inicialización del SDK Push del cliente -{: initializing-the-client-Push-SDK} - -``` - //Inicializar el SDK Push del cliente para Swift -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -## Registro de dispositivos y aplicaciones iOS -{: #enable-push-ios-notifications-register} - - -Se debe registrar una aplicación en APNs para recibir notificaciones remotas, después de instalarse en un dispositivo. Después de que la aplicación reciba la señal de dispositivo que APNs ha generado, debe volver a pasarse al servicio {{site.data.keyword.mobilepushshort}}. - -Para registrar las aplicaciones y los dispositivos de iOS, tiene que: - -1. Crear una aplicación de fondo. -2. Pasar la señal a {{site.data.keyword.mobilepushshort}}. - - -###Crear una aplicación de fondo -{: create-a-backend-app} - -Cree una aplicación de fondo en el catálogo Bluemix® de la sección de Contenedores modelo, que enlaza automáticamente el servicio {{site.data.keyword.mobilepushshort}} a esta aplicación. Si ya ha creado una aplicación de fondo, asegúrese de enlazarla al servicio {{site.data.keyword.mobilepushshort}}. - - -###Cómo pasar señales a {{site.data.keyword.mobilepushshort}} -{: pass-token-push-notifications} - -Una vez que APNs haya enviado la señal, pásela a {{site.data.keyword.mobilepushshort}} como parte del método `registerWithDeviceToken`. - -Después de recibir la señal desde APNs, pase la señal a Notificaciones Push como parte del método `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` - func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ - let push = BMSPushClient.sharedInstance - push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - } -``` - {: codeblock} - - -## Recepción de notificaciones push en dispositivos iOS -{: #enable-push-ios-notifications-receiving} - - -Para recibir notificaciones push en dispositivos iOS, añada el método Swift siguiente a la aplicación delegada de la aplicación. - -``` - // Para Swift -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) - { //El diccionario UserInfo contendrá datos que ha enviado el servidor } -``` - {: codeblock} - -## Supervisión de notificaciones push en dispositivos iOS -{: ios-monitoring} - -Para supervisar el estado actual de la notificación, añada el método Swift siguiente a la aplicación delegada de la aplicación. - -``` - // Enviar estado de notificación cuando se abre la app pulsando las notificaciones - func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - print("Send message status to the Push server") - } -} -``` - {: codeblock} - -``` - // Enviar estado de notificación cuando la app esté en modalidad de fondo. - func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { - let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) - self.showAlert(title: "Recieved Push notifications", message: payLoad) - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - completionHandler(UIBackgroundFetchResult.newData) - } -} -``` - {: codeblock} - - -## Envío de notificaciones push básicas -{: #send} - -Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas. - -Para ello, realice estos pasos: - -1. Seleccione **Enviar notificaciones** y para redactar un mensaje seleccione la opción **Enviar a**. Las opciones admitidas son **Dispositivo por etiqueta**, **ID de dispositivo**, **ID de usuario**, **Dispositivos Android**, **Dispositivos iOS**, **Notificaciones web** y **Todos los dispositivos**. -**Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos suscritos a {{site.data.keyword.mobilepushshort}} recibirán notificaciones. -![pantalla Notificaciones](images/tag_notification.jpg) - -2. En el campo **Mensaje**, redacte el mensaje. Elija configurar los valores opcionales según sea necesario. -3. Pulse **Enviar**. -3. Verifique que los dispositivos hayan recibido la notificación. - -En la captura de pantalla siguiente se muestra un recuadro de alerta en el que se maneja una {{site.data.keyword.mobilepushshort}} en un dispositivo iOS. - -![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) - -### Valores opcionales para el envío de notificaciones -{: #send_ios_otpional_setting} - -Puede personalizar aún más los valores de {{site.data.keyword.mobilepushshort}} para el envío de notificaciones a dispositivos iOS. Se admiten las siguientes opciones de personalización. - -- **Identificador**: Indica el número que se muestra en el identificador de la aplicación. El valor predeterminado es cero (0), que no mostraría un identificador. -- **Sonido**: indica un fragmento de sonido que se reproducirá al recibir una notificación. Da soporte a la opción predeterminada o al nombre de un recurso de sonido incorporado en la aplicación. -- **Carga útil adicional**: permite especificar valores personalizados de carga útil para las notificaciones. - -##Habilitación de notificaciones interactivas - -Ahora puede enriquecer sus notificaciones de iOS con más detalles como la adición de una imagen, mapa o un botón de respuesta mediante la habilitación de notificaciones interactivas. Ello proporciona más contexto a los clientes, junto con la capacidad para realizar una acción inmediata sin abandonar el contexto actual. - -Para habilitar las notificaciones interactivas, utilice el código siguiente: - -``` - // Esto define la acción del botón. - let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) -``` - {: codeblock} -``` - // Esto define la categoría para los botones -let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) -``` - {: codeblock} -``` - // Esto actualiza el registro para que incluya la categoría definida de buttonsPass en iOS BMSPushClientOptions -let notificationOptions = BMSPushClientOptions(categoryName: [category]) -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) -``` - {: codeblock} - -Para enviar una notificación interactiva, realice estos pasos: - -1. En la sección Componer, para la lista desplegable Enviar a, seleccione **Dispositivos iOS**. -2. Introduzca el mensaje de notificación que puede desear enviar. -3. En la sección Valores opcionales, seleccione **Móvil** y pulse **iOS**. -4. En la lista desplegable Tipo, seleccione **Mixto**. -5. En el campo Categoría, especifique el tipo de notificación que ha definido en la app. - -![Notificación interactiva para iOS](images/push_ios_notification_interactive.jpg) - -## Pasos siguientes -{: #next_steps_tags} - -Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. - -Añada estas características de servicio de notificaciones push a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). -Para utilizar opciones de notificaciones avanzadas, consulte [Habilitación de notificaciones push avanzadas](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +#Habilitación de aplicaciones iOS para enviar {{site.data.keyword.mobilepushshort}} +{: #enable-push-ios-notifications} +Última actualización: 14 de febrero de 2017 +{: .last-updated} + +Puede habilitar aplicaciones iOS para enviar {{site.data.keyword.mobilepushshort}} a sus dispositivos. + + +##Instalación de CocoaPods +{: #enable-push-ios-notifications-install} + +Para un proyecto Xcode existente, puede configurar el SDK del cliente de Bluemix Mobile Services mediante la herramienta de gestión de dependencias de CocoaPods. Una alternativa es instalar el SDK manualmente. + +Para ver el archivo readme de Push de Swift, vaya a [Readme ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. + + + +1. Instale CocoaPods utilizando el siguiente mandato en su terminal Mac. +```$ sudo gem install cocoapods +``` + {: codeblock} +2. Especifique el mandato `pod init` en el terminal para inicializar CocoaPods. Asegúrese de ejecutar el mandato desde el directorio en el que se encuentra el proyecto Xcode. El mandato `pod init` crea un Podfile. +3. En el Podfile generado, añada las dependencias de SDK necesarias. Copie el siguiente Podfile. + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + pod 'BMSAnalyticsAPI' + end + ``` + {: codeblock} + +3. Desde el terminal, vaya a la carpeta del proyecto e instale las dependencias con el mandato `pod update`. + +El mandato instala las dependencias y crea un nuevo espacio de trabajo Xcode. +**Nota**: Asegúrese de abrir siempre el nuevo espacio de trabajo de Xcode, en lugar del archivo de proyecto Xcode original: +``` + $ open App.xcworkspace +``` + {: codeblock} + +El espacio de trabajo contiene el proyecto original y el proyecto Pods que contiene las dependencias. Para modificar una carpeta fuente de Bluemix mobile services, puede encontrarla en el proyecto Pods, en `Pods/yourImportedSourceFolder`, por ejemplo: `Pods/BMSPush`. + +##Adición de infraestructuras mediante Carthage +{: #carthage} + +Añada infraestructuras al proyecto utilizando [Carthage ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}. Tenga en cuenta que Carthage en Xcode8 no está soportado. + +1. Añada infraestructuras `BMSPush` a Cartfile: +``` + github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" +``` + {: codeblock} +2. Ejecute el mandato `carthage update`. Cuando la compilación finalice, arrastre `BMSPush.framework`, `BMSCore.framework` y `BMSAnalyticsAPI.framework` al proyecto Xcode. +3. Siga las instrucciones del sitio de [Carthage ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} para llevar a cabo la integración. + +##Configuración del SDK de iOS +{: ios-sdk} + +Configure el SDK de iOS, añada el código siguiente al archivo **AppDelegate.swift** de su aplicación. Tenga en cuenta que también se registra con APNs. +``` + func application(_ application: UIApplication, + didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool + { + BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") + } +``` + {: codeblock} + +##Utilización de infraestructuras importadas y carpetas fuente +{: using-imported-frameworks} + +Haga referencia al SDK del código. Asegúrese de que se cumplen los requisitos previos siguientes. + +- iOS 8.0 o superior +- Xcode 7 + +Escriba directivas `#import` para las cabeceras relevantes, por +ejemplo: +``` +//swift +import BMSCore +import BMSPush +``` + {: codeblock} + +Para leer el archivo readme de Push de Swift, consulte [Readme ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. + +**Nota**: La actualización del proyecto Pods utilizando los mandatos CocoaPods `pod install` o `pod update` puede alterar temporalmente las carpetas fuente de Bluemix Mobile services. Si desea conservar las versiones personalizadas +de los archivos originales, asegúrese de que se les ha hecho la copia de seguridad antes de emitir uno de estos +mandatos. + + +##Crear configuración +{: build-settings} + +Vaya a **Xcode > Crear configuración > Opciones de creación y Establecer la habilitación de Bitcode** en **No**. + +**Atención**: A partir de iOS 9, los cambios a la característica de App Transport Security (ATS) pueden afectar a la forma de manejar el proceso de autenticación. En las siguientes publicaciones del blog se ofrece más información sobre los cambios: [ATS y Bitcode en iOS 9 ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} y [Conecte su app iOS 9 a Bluemix hoy mismo ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. + +## Inicialización de SDK Push para aplicaciones iOS +{: #enable-push-ios-notifications-initialize} + +Un lugar común para colocar el código de inicialización se encuentra en el delegado de aplicación para la aplicación iOS. Pulse el enlace **Opciones móviles** en el panel de control Push para obtener la ruta y el GUID de la aplicación. + +###Inicialización del SDK principal +{: Initializing-the-core-sdk} + + +``` +// Inicialice el SDK principal para Swift con la GUID, la ruta y la región de IBM Bluemix +let myBMSClient = BMSClient.sharedInstance +myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") +``` + {: codeblock} + +### Ruta, GUID, y región Bluemix +{: route-guid-bluemix-region} + +####appRoute +{: ios-approute} + +Especifica la ruta que se asigna a la aplicación de servidor que ha creado en Bluemix. + +####GUID +{: ios-guid} + +Especifica la clave exclusiva asignada a la aplicación que ha creado en Bluemix. Este valor distingue entre mayúsculas y minúsculas. + +####bluemixRegionSuffix +{: ios-bluemixRegionSuffix} + +Especifica la ubicación en la que se aloja la aplicación. El parámetro `bluemixRegion` especifica qué despliegue de Bluemix está utilizando. Puede establecer este valor con una propiedad estática `BMSClient.REGION` y utilizar uno de estos tres valores: + +- BMSClient.Region.usSouth +- BMSClient.Region.unitedKingdom +- BMSClient.Region.sydney + +####AppGUID +{: ios-AppGUID} + +Especifica la clave AppGUID exclusiva asignada al servicio {{site.data.keyword.mobilepushshort}} que ha creado en Bluemix. + +###Inicialización del SDK Push del cliente +{: initializing-the-client-Push-SDK} + +``` + //Inicializar el SDK Push del cliente para Swift +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +## Registro de dispositivos y aplicaciones iOS +{: #enable-push-ios-notifications-register} + + +Se debe registrar una aplicación en APNs para recibir notificaciones remotas, después de instalarse en un dispositivo. Después de que la aplicación reciba la señal de dispositivo que APNs ha generado, debe volver a pasarse al servicio {{site.data.keyword.mobilepushshort}}. + +Para registrar las aplicaciones y los dispositivos de iOS, tiene que: + +1. Crear una aplicación de fondo. +2. Pasar la señal a {{site.data.keyword.mobilepushshort}}. + + +###Crear una aplicación de fondo +{: create-a-backend-app} + +Cree una aplicación de fondo en el catálogo Bluemix® de la sección de Contenedores modelo, que enlaza automáticamente el servicio {{site.data.keyword.mobilepushshort}} a esta aplicación. Si ya ha creado una aplicación de fondo, asegúrese de enlazarla al servicio {{site.data.keyword.mobilepushshort}}. + + +###Cómo pasar señales a {{site.data.keyword.mobilepushshort}} +{: pass-token-push-notifications} + +Una vez que APNs haya enviado la señal, pásela a {{site.data.keyword.mobilepushshort}} como parte del método `registerWithDeviceToken`. + +Después de recibir la señal desde APNs, pase la señal a Notificaciones Push como parte del método `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` + func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ + let push = BMSPushClient.sharedInstance + push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + } +``` + {: codeblock} + + +## Recepción de notificaciones push en dispositivos iOS +{: #enable-push-ios-notifications-receiving} + + +Para recibir notificaciones push en dispositivos iOS, añada el método Swift siguiente a la aplicación delegada de la aplicación. + +``` + // Para Swift +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) + { //El diccionario UserInfo contendrá datos que ha enviado el servidor } +``` + {: codeblock} + +## Supervisión de notificaciones push en dispositivos iOS +{: ios-monitoring} + +Para supervisar el estado actual de la notificación, añada el método Swift siguiente a la aplicación delegada de la aplicación. + +``` + // Enviar estado de notificación cuando se abre la app pulsando las notificaciones + func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + print("Send message status to the Push server") + } +} +``` + {: codeblock} + +``` + // Enviar estado de notificación cuando la app esté en modalidad de fondo. + func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { + let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) + self.showAlert(title: "Recieved Push notifications", message: payLoad) + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + completionHandler(UIBackgroundFetchResult.newData) + } +} +``` + {: codeblock} + + +## Envío de notificaciones push básicas +{: #send} + +Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas. + +Para ello, realice estos pasos: + +1. Seleccione **Enviar notificaciones** y para redactar un mensaje seleccione la opción **Enviar a**. Las opciones admitidas son **Dispositivo por etiqueta**, **ID de dispositivo**, **ID de usuario**, **Dispositivos Android**, **Dispositivos iOS**, **Notificaciones web** y **Todos los dispositivos**. +**Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos suscritos a {{site.data.keyword.mobilepushshort}} recibirán notificaciones. +![pantalla Notificaciones](images/tag_notification.jpg) + +2. En el campo **Mensaje**, redacte el mensaje. Elija configurar los valores opcionales según sea necesario. +3. Pulse **Enviar**. +3. Verifique que los dispositivos hayan recibido la notificación. + +En la captura de pantalla siguiente se muestra un recuadro de alerta en el que se maneja una {{site.data.keyword.mobilepushshort}} en un dispositivo iOS. + +![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) + +### Valores opcionales para el envío de notificaciones +{: #send_ios_otpional_setting} + +Puede personalizar aún más los valores de {{site.data.keyword.mobilepushshort}} para el envío de notificaciones a dispositivos iOS. Se admiten las siguientes opciones de personalización. + +- **Identificador**: Indica el número que se muestra en el identificador de la aplicación. El valor predeterminado es cero (0), que no mostraría un identificador. +- **Sonido**: indica un fragmento de sonido que se reproducirá al recibir una notificación. Da soporte a la opción predeterminada o al nombre de un recurso de sonido incorporado en la aplicación. +- **Carga útil adicional**: permite especificar valores personalizados de carga útil para las notificaciones. + +##Habilitación de notificaciones interactivas + +Ahora puede enriquecer sus notificaciones de iOS con más detalles como la adición de una imagen, mapa o un botón de respuesta mediante la habilitación de notificaciones interactivas. Ello proporciona más contexto a los clientes, junto con la capacidad para realizar una acción inmediata sin abandonar el contexto actual. + +Para habilitar las notificaciones interactivas, utilice el código siguiente: + +``` + // Esto define la acción del botón. + let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) +``` + {: codeblock} +``` + // Esto define la categoría para los botones +let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) +``` + {: codeblock} +``` + // Esto actualiza el registro para que incluya la categoría definida de buttonsPass en iOS BMSPushClientOptions +let notificationOptions = BMSPushClientOptions(categoryName: [category]) +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) +``` + {: codeblock} + +Para enviar una notificación interactiva, realice estos pasos: + +1. En la sección Componer, para la lista desplegable Enviar a, seleccione **Dispositivos iOS**. +2. Introduzca el mensaje de notificación que puede desear enviar. +3. En la sección Valores opcionales, seleccione **Móvil** y pulse **iOS**. +4. En la lista desplegable Tipo, seleccione **Mixto**. +5. En el campo Categoría, especifique el tipo de notificación que ha definido en la app. + +![Notificación interactiva para iOS](images/push_ios_notification_interactive.jpg) + +## Pasos siguientes +{: #next_steps_tags} + +Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. + +Añada estas características de servicio de notificaciones push a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). +Para utilizar opciones de notificaciones avanzadas, consulte [Habilitación de notificaciones push avanzadas](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/es/c_overview_push.md b/services/mobilepush/nl/es/c_overview_push.md index 9fe7ed7b2..caf6dbb21 100755 --- a/services/mobilepush/nl/es/c_overview_push.md +++ b/services/mobilepush/nl/es/c_overview_push.md @@ -1,128 +1,128 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Acerca de {{site.data.keyword.mobilepushshort}} -{: #overview-push} -Última actualización: 18 de enero de 2017 -{: .last-updated} - -IBM {{site.data.keyword.mobilepushshort}} es un servicio que puede utilizar para enviar notificaciones a dispositivos y plataformas. Las notificaciones se pueden destinar a todos los usuarios de la aplicación o a un conjunto específico de usuarios y dispositivos mediante etiquetas. Puede administrar dispositivos, etiquetas y suscripciones. - -Puede utilizar cualquiera de las siguientes opciones para crear un servicio enlazado o sin enlazar: - -- Creando una aplicación Bluemix mediante el contenedor modelo del iniciador de servicios MobileFirst desde el catálogo. Se creará un servicio de notificaciones Push enlazado a una aplicación de fondo de Bluemix. -- Creando un servicio de notificaciones Push sin enlazar directamente desde el catálogo de Mobile. Luego puede enlazar una aplicación o incluso utilizarlo sin enlazar. -- Utilizando el [panel de control de Mobile ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}. - -Tenga en cuenta que el separador de supervisión de {{site.data.keyword.mobilepushshort}} no muestra los datos analíticos. - -El servicio {{site.data.keyword.mobilepushshort}} ahora está habilitado para OpenWhisk. Para obtener más información, consulte [OpenWhisk](/docs/openwhisk/index.html). - - -## Proceso del servicio {{site.data.keyword.mobilepushshort}} -{: #overview_push_process} - -Los clientes de navegadores web y móviles y las aplicaciones y extensiones de Google Chrome pueden suscribirse y registrarse para el servicio de {{site.data.keyword.mobilepushshort}}. Al arrancar, las aplicaciones móviles y de navegador se registrarán y se suscribirán al servicio {{site.data.keyword.mobilepushshort}}. Las notificaciones se asignan al servicio APNs (Apple Push Notification Service) o al servidor de Firebase Cloud Messaging (FCM)/Google Cloud Messaging (GCM) y, a continuación, se enviarán a los clientes móviles y de navegador registrados. - -![Visión general de push](images/overview.jpg) - - -###Aplicaciones móviles y de navegador -{: mobile-applications} - -Al arrancar, las aplicaciones cliente se registrarán y se suscribirán al servicio {{site.data.keyword.mobilepushshort}} para recibir notificaciones. - -###Aplicaciones de fondo -{: backend-applications} - -Las aplicaciones de fondo pueden ser locales o pueden estar en una nube pública. Las aplicaciones de fondo utilizarán el servicio {{site.data.keyword.mobilepushshort}} para enviar notificaciones según el contexto a usuarios de aplicaciones móviles y de navegador. No es necesario que las aplicaciones de fondo mantengan ni gestionen dispositivos móviles, agentes de navegador ni información de usuarios para enviar notificaciones push. En lugar de ello, pueden utilizar el servicio {{site.data.keyword.mobilepushshort}}, que los gestionará y mantendrá. - -###Propietario de back-end de app -{: app-backend-owner} - -El propietario de back-end de app crea la aplicación móvil de fondo, que agrupa una instancia del servicio {{site.data.keyword.mobilepushshort}}. El propietario también configura el servicio {{site.data.keyword.mobilepushshort}} para adaptar las aplicaciones de fondo utilizando el servicio junto con las aplicaciones móviles y de navegador destinadas para {{site.data.keyword.mobilepushshort}}. - -###Servicio {{site.data.keyword.mobilepushshort}} -{: push-notification-service} - -El servicio {{site.data.keyword.mobilepushshort}} gestiona toda la información relacionada con los dispositivos móviles y clientes de navegadores web registrados para las notificaciones. El servicio mantiene sus aplicaciones transparentes a los detalles tecnológicos del envío de notificaciones a plataformas móviles y navegadores web heterogéneas y lo maneja todo. - -###Pasarelas -{: gateways} - -Los servicios de nube específicos de plataformas para las notificaciones push, como FCM/GCM o Apple Push Notification Service (APNs), que utilizan el servicio IBM {{site.data.keyword.mobilepushshort}} para asignar notificaciones a las aplicaciones móviles y de navegador. - -###Seguridad push -{: push-security} - -Las API de {{site.data.keyword.mobilepushshort}} se protegen mediante dos tipos de secretos: - -- **appSecret**: 'appSecret' protege las API que suelen invocar las aplicaciones de fondo, como por ejemplo la API para enviar {{site.data.keyword.mobilepushshort}} y la API para configurar las opciones. -- **clientSecret**: 'clientSecret' protege las API que suelen invocar las aplicaciones de clientes móviles. Sólo hay una API relacionada con el registro de un dispositivo con un ID de usuario asociado que requiere este 'clientSecret'. Ninguna del resto de las API invocadas desde los clientes móviles requiere el clientSecret. - -'appSecret' y 'clientSecret' se asignan a todas las instancias de servicio en el momento de enlazar una aplicación con el servicio {{site.data.keyword.mobilepushshort}}. Consulte la documentación de las [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/) para obtener información sobre cómo se pasan los secretos y a qué API. - -**Nota**: Las aplicaciones anteriores requerían que se pasara clientSecret solo al registrar o actualizar dispositivos con el campo userID. Todas las otras API invocadas con clientes móviles y de navegador no necesitaban clientSecret. Estas aplicaciones antiguas pueden seguir utilizando el clientSecret de forma opcional para los registros de dispositivos o las llamadas de actualización. Sin embargo, se recomienda encarecidamente realizar la comprobación de clientSecret en todas las llamadas de API de cliente. Para imponer esto en las aplicaciones existentes, se ha publicado una nueva API 'verifyClientSecret'. En las aplicaciones nuevas, la comprobación de clientSecret se efectuará en todas las llamadas de API de cliente. Este comportamiento no puede modificarse con la API 'verfiyClientSecret'. - -De forma predeterminada, la verificación del secreto de cliente se impone sólo en las nuevas aplicaciones. Está permitido que tanto las aplicaciones existentes como las nuevas habiliten o inhabiliten la verificación del secreto de cliente mediante la API REST verifyClientSecret. Se recomienda que imponga la verificación del secreto de cliente para evitar exponer los dispositivos a los usuarios que puedan conocer el applicationId y el deviceId. - -Asegúrese de que el 'clientSecret' no se muestre nunca ni lo codifique en la aplicación. Hay varios patrones de inicialización de aplicaciones que se pueden utilizar para obtener dinámicamente el 'clientSecret' durante el tiempo de ejecución de la aplicación. El diagrama de secuencia sigue el posible patrón. -![Enable_Push](images/init_client_secret.jpg) - -## Tipos de {{site.data.keyword.mobilepushshort}} -{: #overview-push-types} - -###Difusión -{: broadcast} - -Cuando una aplicación cliente se registra en el servicio {{site.data.keyword.mobilepushshort}}, puede comenzar a recibir difusiones. Las notificaciones de difusión son mensajes destinados a todas las instancias de una aplicación instalada en dispositivos móviles, navegadores o implementadas como instancias de aplicaciones o extensiones de Chrome y configuradas para el servicio {{site.data.keyword.mobilepushshort}}. Las notificaciones de difusión están habilitadas de forma predeterminada para cualquier aplicación habilitada para {{site.data.keyword.mobilepushshort}}. Las aplicaciones habilitadas para el servicio {{site.data.keyword.mobilepushshort}} tienen una suscripción predefinida en la etiqueta Push.ALL, que utiliza el servidor para transmitir mensajes de notificación a todos los dispositivos. Para enviar una notificación de difusión que utiliza la API Push REST, asegúrese de que el "destino" sea un archivo JSON vacío al publicar en recursos de mensajes. - -###Notificaciones basadas en etiquetas -{: tag-based-notifications} - -Las notificaciones basadas en etiquetas son mensajes que están pensados para todos los dispositivos suscritos a una etiqueta determinada. Las notificaciones basadas en código permiten la segmentación de notificaciones en función de los temas o de las áreas de temas. Los destinatarios de la notificación pueden elegir recibir notificaciones sólo si es sobre un asunto o tema de su interés. Por lo tanto, la notificación basada en etiquetas proporciona un medio de segmentar destinatarios. Esta característica habilita la función de definir etiquetas y, a continuación, enviar y recibir mensajes por etiquetas. Un mensaje sólo se ha dirigido a las instancias de aplicación cliente (en móvil, navegador o como una aplicación o extensión) que están suscritas a la etiqueta. Primero debe crear las etiquetas para la aplicación, configurar las suscripciones de etiquetas y, a continuación, iniciar las notificaciones basadas en etiquetas. Para enviar una notificación basada en etiquetas que utiliza la API REST, asegúrese de que los "tagNames" se proporcionen al publicarse en el recurso de mensajes. - -###Notificaciones de difusión única -{: unicast-notifications} - -Las notificaciones de difusión única son mensajes destinados a un dispositivo o usuario específico. Dichas notificaciones destinadas a dispositivos no necesitan ninguna configuración adicional y están habilitadas de forma predeterminada cuando se habilita la aplicación para {{site.data.keyword.mobilepushshort}}. - -Sin embargo, las notificaciones de difusión única destinadas a usuarios necesitan que se asocie un ID de usuario a un dispositivo en el momento de registrar el dispositivo móvil cliente o el navegador web o las aplicaciones y extensiones de Chrome a {{site.data.keyword.mobilepushshort}}. - -Normalmente, las aplicaciones cliente primero ejecutan un ciclo de autenticación en el que el usuario de la aplicación móvil se autentica en un servicio de autenticación, como por ejemplo [Mobile Client Access](docs/services/mobileaccess/index.html). Si la autenticación es correcta, el ID de usuario autenticado se pasa a la API de registro del dispositivo push. -Para enviar una notificación de difusión única mediante la API REST, asegúrese de que se proporcionan los deviceId o los userId al publicarse en un recurso de mensajes. - -###Notificaciones basadas en plataforma -{: platform-based-notifications} - -Las notificaciones se pueden definir para alcanzar una plataforma de dispositivo determinada. Por ejemplo, se puede enviar una notificación únicamente a todos los usuarios de Android o Google Chrome. Para enviar una notificación basada en plataforma que utilice la API REST, asegúrese de que se proporcionan plataformas de destino al publicar en un recurso de mensajes. Especifique las plataformas como una matriz. Las plataformas soportadas son las siguientes: -* A (Apple) -* G (Google) -* WEB_CHROME (push web del navegador Google Chrome) -* WEB_FIREFOX (push web del navegador Mozilla Firefox) -* WEB_SAFARI (push web del navegador Safari) -* APPEXT_CHROME (aplicaciones y extensiones de Google Chrome) - -## Tamaño de los mensajes de {{site.data.keyword.mobilepushshort}} -{: #push-message-size} - -El tamaño de carga útil de los mensajes de {{site.data.keyword.mobilepushshort}} depende de las restricciones diseñadas por las pasarelas (FCM/GCM, APNs) y las plataformas cliente. - -### iOS y Safari -{: ios-message-size} - -Para iOS 8 y posterior, el tamaño máximo permitido es de 2 kilobytes. El Servicio de notificaciones Push de Apple no envía notificaciones que superen este límite. - -###Android, navegador Firefox, navegador Chrome y aplicaciones y extensiones de Chrome -{: android-message-size} - -Existe una limitación de 4 kilobytes en el tamaño máximo permitido de la carga útil de mensajes. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Acerca de {{site.data.keyword.mobilepushshort}} +{: #overview-push} +Última actualización: 18 de enero de 2017 +{: .last-updated} + +IBM {{site.data.keyword.mobilepushshort}} es un servicio que puede utilizar para enviar notificaciones a dispositivos y plataformas. Las notificaciones se pueden destinar a todos los usuarios de la aplicación o a un conjunto específico de usuarios y dispositivos mediante etiquetas. Puede administrar dispositivos, etiquetas y suscripciones. + +Puede utilizar cualquiera de las siguientes opciones para crear un servicio enlazado o sin enlazar: + +- Creando una aplicación Bluemix mediante el contenedor modelo del iniciador de servicios MobileFirst desde el catálogo. Se creará un servicio de notificaciones Push enlazado a una aplicación de fondo de Bluemix. +- Creando un servicio de notificaciones Push sin enlazar directamente desde el catálogo de Mobile. Luego puede enlazar una aplicación o incluso utilizarlo sin enlazar. +- Utilizando el [panel de control de Mobile ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}. + +Tenga en cuenta que el separador de supervisión de {{site.data.keyword.mobilepushshort}} no muestra los datos analíticos. + +El servicio {{site.data.keyword.mobilepushshort}} ahora está habilitado para OpenWhisk. Para obtener más información, consulte [OpenWhisk](/docs/openwhisk/index.html). + + +## Proceso del servicio {{site.data.keyword.mobilepushshort}} +{: #overview_push_process} + +Los clientes de navegadores web y móviles y las aplicaciones y extensiones de Google Chrome pueden suscribirse y registrarse para el servicio de {{site.data.keyword.mobilepushshort}}. Al arrancar, las aplicaciones móviles y de navegador se registrarán y se suscribirán al servicio {{site.data.keyword.mobilepushshort}}. Las notificaciones se asignan al servicio APNs (Apple Push Notification Service) o al servidor de Firebase Cloud Messaging (FCM)/Google Cloud Messaging (GCM) y, a continuación, se enviarán a los clientes móviles y de navegador registrados. + +![Visión general de push](images/overview.jpg) + + +### Aplicaciones móviles y de navegador +{: mobile-applications} + +Al arrancar, las aplicaciones cliente se registrarán y se suscribirán al servicio {{site.data.keyword.mobilepushshort}} para recibir notificaciones. + +### Aplicaciones de fondo +{: backend-applications} + +Las aplicaciones de fondo pueden ser locales o pueden estar en una nube pública. Las aplicaciones de fondo utilizarán el servicio {{site.data.keyword.mobilepushshort}} para enviar notificaciones según el contexto a usuarios de aplicaciones móviles y de navegador. No es necesario que las aplicaciones de fondo mantengan ni gestionen dispositivos móviles, agentes de navegador ni información de usuarios para enviar notificaciones push. En lugar de ello, pueden utilizar el servicio {{site.data.keyword.mobilepushshort}}, que los gestionará y mantendrá. + +### Propietario de back-end de app +{: app-backend-owner} + +El propietario de back-end de app crea la aplicación móvil de fondo, que agrupa una instancia del servicio {{site.data.keyword.mobilepushshort}}. El propietario también configura el servicio {{site.data.keyword.mobilepushshort}} para adaptar las aplicaciones de fondo utilizando el servicio junto con las aplicaciones móviles y de navegador destinadas para {{site.data.keyword.mobilepushshort}}. + +### Servicio {{site.data.keyword.mobilepushshort}} +{: push-notification-service} + +El servicio {{site.data.keyword.mobilepushshort}} gestiona toda la información relacionada con los dispositivos móviles y clientes de navegadores web registrados para las notificaciones. El servicio mantiene sus aplicaciones transparentes a los detalles tecnológicos del envío de notificaciones a plataformas móviles y navegadores web heterogéneas y lo maneja todo. + +### Pasarelas +{: gateways} + +Los servicios de nube específicos de plataformas para las notificaciones push, como FCM/GCM o Apple Push Notification Service (APNs), que utilizan el servicio IBM {{site.data.keyword.mobilepushshort}} para asignar notificaciones a las aplicaciones móviles y de navegador. + +### Seguridad push +{: push-security} + +Las API de {{site.data.keyword.mobilepushshort}} se protegen mediante dos tipos de secretos: + +- **appSecret**: 'appSecret' protege las API que suelen invocar las aplicaciones de fondo, como por ejemplo la API para enviar {{site.data.keyword.mobilepushshort}} y la API para configurar las opciones. +- **clientSecret**: 'clientSecret' protege las API que suelen invocar las aplicaciones de clientes móviles. Sólo hay una API relacionada con el registro de un dispositivo con un ID de usuario asociado que requiere este 'clientSecret'. Ninguna del resto de las API invocadas desde los clientes móviles requiere el clientSecret. + +'appSecret' y 'clientSecret' se asignan a todas las instancias de servicio en el momento de enlazar una aplicación con el servicio {{site.data.keyword.mobilepushshort}}. Consulte la documentación de las [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/) para obtener información sobre cómo se pasan los secretos y a qué API. + +**Nota**: Las aplicaciones anteriores requerían que se pasara clientSecret solo al registrar o actualizar dispositivos con el campo userID. Todas las otras API invocadas con clientes móviles y de navegador no necesitaban clientSecret. Estas aplicaciones antiguas pueden seguir utilizando el clientSecret de forma opcional para los registros de dispositivos o las llamadas de actualización. Sin embargo, se recomienda encarecidamente realizar la comprobación de clientSecret en todas las llamadas de API de cliente. Para imponer esto en las aplicaciones existentes, se ha publicado una nueva API 'verifyClientSecret'. En las aplicaciones nuevas, la comprobación de clientSecret se efectuará en todas las llamadas de API de cliente. Este comportamiento no puede modificarse con la API 'verfiyClientSecret'. + +De forma predeterminada, la verificación del secreto de cliente se impone sólo en las nuevas aplicaciones. Está permitido que tanto las aplicaciones existentes como las nuevas habiliten o inhabiliten la verificación del secreto de cliente mediante la API REST verifyClientSecret. Se recomienda que imponga la verificación del secreto de cliente para evitar exponer los dispositivos a los usuarios que puedan conocer el applicationId y el deviceId. + +Asegúrese de que el 'clientSecret' no se muestre nunca ni lo codifique en la aplicación. Hay varios patrones de inicialización de aplicaciones que se pueden utilizar para obtener dinámicamente el 'clientSecret' durante el tiempo de ejecución de la aplicación. El diagrama de secuencia sigue el posible patrón. +![Enable_Push](images/init_client_secret.jpg) + +## Tipos de {{site.data.keyword.mobilepushshort}} +{: #overview-push-types} + +### Difusión +{: broadcast} + +Cuando una aplicación cliente se registra en el servicio {{site.data.keyword.mobilepushshort}}, puede comenzar a recibir difusiones. Las notificaciones de difusión son mensajes destinados a todas las instancias de una aplicación instalada en dispositivos móviles, navegadores o implementadas como instancias de aplicaciones o extensiones de Chrome y configuradas para el servicio {{site.data.keyword.mobilepushshort}}. Las notificaciones de difusión están habilitadas de forma predeterminada para cualquier aplicación habilitada para {{site.data.keyword.mobilepushshort}}. Las aplicaciones habilitadas para el servicio {{site.data.keyword.mobilepushshort}} tienen una suscripción predefinida en la etiqueta Push.ALL, que utiliza el servidor para transmitir mensajes de notificación a todos los dispositivos. Para enviar una notificación de difusión que utiliza la API Push REST, asegúrese de que el "destino" sea un archivo JSON vacío al publicar en recursos de mensajes. + +### Notificaciones basadas en etiquetas +{: tag-based-notifications} + +Las notificaciones basadas en etiquetas son mensajes que están pensados para todos los dispositivos suscritos a una etiqueta determinada. Las notificaciones basadas en código permiten la segmentación de notificaciones en función de los temas o de las áreas de temas. Los destinatarios de la notificación pueden elegir recibir notificaciones sólo si es sobre un asunto o tema de su interés. Por lo tanto, la notificación basada en etiquetas proporciona un medio de segmentar destinatarios. Esta característica habilita la función de definir etiquetas y, a continuación, enviar y recibir mensajes por etiquetas. Un mensaje sólo se ha dirigido a las instancias de aplicación cliente (en móvil, navegador o como una aplicación o extensión) que están suscritas a la etiqueta. Primero debe crear las etiquetas para la aplicación, configurar las suscripciones de etiquetas y, a continuación, iniciar las notificaciones basadas en etiquetas. Para enviar una notificación basada en etiquetas que utiliza la API REST, asegúrese de que los "tagNames" se proporcionen al publicarse en el recurso de mensajes. + +### Notificaciones de difusión única +{: unicast-notifications} + +Las notificaciones de difusión única son mensajes destinados a un dispositivo o usuario específico. Dichas notificaciones destinadas a dispositivos no necesitan ninguna configuración adicional y están habilitadas de forma predeterminada cuando se habilita la aplicación para {{site.data.keyword.mobilepushshort}}. + +Sin embargo, las notificaciones de difusión única destinadas a usuarios necesitan que se asocie un ID de usuario a un dispositivo en el momento de registrar el dispositivo móvil cliente o el navegador web o las aplicaciones y extensiones de Chrome a {{site.data.keyword.mobilepushshort}}. + +Normalmente, las aplicaciones cliente primero ejecutan un ciclo de autenticación en el que el usuario de la aplicación móvil se autentica en un servicio de autenticación, como por ejemplo [Mobile Client Access](docs/services/mobileaccess/index.html). Si la autenticación es correcta, el ID de usuario autenticado se pasa a la API de registro del dispositivo push. +Para enviar una notificación de difusión única mediante la API REST, asegúrese de que se proporcionan los deviceId o los userId al publicarse en un recurso de mensajes. + +### Notificaciones basadas en plataforma +{: platform-based-notifications} + +Las notificaciones se pueden definir para alcanzar una plataforma de dispositivo determinada. Por ejemplo, se puede enviar una notificación únicamente a todos los usuarios de Android o Google Chrome. Para enviar una notificación basada en plataforma que utilice la API REST, asegúrese de que se proporcionan plataformas de destino al publicar en un recurso de mensajes. Especifique las plataformas como una matriz. Las plataformas soportadas son las siguientes: +* A (Apple) +* G (Google) +* WEB_CHROME (push web del navegador Google Chrome) +* WEB_FIREFOX (push web del navegador Mozilla Firefox) +* WEB_SAFARI (push web del navegador Safari) +* APPEXT_CHROME (aplicaciones y extensiones de Google Chrome) + +## Tamaño de los mensajes de {{site.data.keyword.mobilepushshort}} +{: #push-message-size} + +El tamaño de carga útil de los mensajes de {{site.data.keyword.mobilepushshort}} depende de las restricciones diseñadas por las pasarelas (FCM/GCM, APNs) y las plataformas cliente. + +### iOS y Safari +{: ios-message-size} + +Para iOS 8 y posterior, el tamaño máximo permitido es de 2 kilobytes. El Servicio de notificaciones Push de Apple no envía notificaciones que superen este límite. + +### Android, navegador Firefox, navegador Chrome y aplicaciones y extensiones de Chrome +{: android-message-size} + +Existe una limitación de 4 kilobytes en el tamaño máximo permitido de la carga útil de mensajes. diff --git a/services/mobilepush/nl/es/c_rich_media_notifications.md b/services/mobilepush/nl/es/c_rich_media_notifications.md index 2323f9c5f..65164a44a 100644 --- a/services/mobilepush/nl/es/c_rich_media_notifications.md +++ b/services/mobilepush/nl/es/c_rich_media_notifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Habilitación de notificaciones Rich Media -{: #interactive-notifications} -Última actualización: 11 de enero de 2017 -{: .last-updated} - - -Puede habilitar Rich Media {{site.data.keyword.mobilepushshort}} en iOS 10 y posteriores. Las notificaciones push se pueden enviar con audio, vídeo, GIF e imágenes. - -Para configurar la aplicación de modo que reciba push completo en iOS 10, siga estos pasos: - -1. En Xcode, seleccione **File** > **Nuevo** > **Destino** > **Extensión de servicio de notificación**. -2. En el método `didReceive()` de `UNNotificationServiceExtension`, añada el siguiente código. -``` -BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) -``` - -Para enviar Rich Media {{site.data.keyword.mobilepushshort}} desde el panel de control de Push, asegúrese de especificar los campos de mensaje, título, subtítulo y attachmentURL. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Habilitación de notificaciones Rich Media +{: #interactive-notifications} +Última actualización: 11 de enero de 2017 +{: .last-updated} + + +Puede habilitar Rich Media {{site.data.keyword.mobilepushshort}} en iOS 10 y posteriores. Las notificaciones push se pueden enviar con audio, vídeo, GIF e imágenes. + +Para configurar la aplicación de modo que reciba push completo en iOS 10, siga estos pasos: + +1. En Xcode, seleccione **File** > **Nuevo** > **Destino** > **Extensión de servicio de notificación**. +2. En el método `didReceive()` de `UNNotificationServiceExtension`, añada el siguiente código. +``` +BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) +``` + +Para enviar Rich Media {{site.data.keyword.mobilepushshort}} desde el panel de control de Push, asegúrese de especificar los campos de mensaje, título, subtítulo y attachmentURL. diff --git a/services/mobilepush/nl/es/c_tag_basednotifications.md b/services/mobilepush/nl/es/c_tag_basednotifications.md index 4b47a8f6b..9b5371e68 100755 --- a/services/mobilepush/nl/es/c_tag_basednotifications.md +++ b/services/mobilepush/nl/es/c_tag_basednotifications.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Habilitación de notificaciones basadas en etiquetas -{: #tag_based_notifications} -Última actualización: 16 de enero de 2017 -{: .last-updated} - -Los mensajes de notificación basados en etiquetas están pensados para todos los dispositivos suscritos a una etiqueta determinada. - -Puede definir etiquetas y, a continuación, enviar y recibir mensajes mediante etiquetas. Primero debe crear las etiquetas para la aplicación, configurar las suscripciones de etiquetas y, a continuación, iniciar las notificaciones basadas en etiquetas. Para enviar una notificación basada en código utilizando la [API REST](https://mobile.{DomainName}/imfpush/){: new_window}, asegúrese de que se proporcionen los "tagNames" al publicar en el recurso de mensajes. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Habilitación de notificaciones basadas en etiquetas +{: #tag_based_notifications} +Última actualización: 16 de enero de 2017 +{: .last-updated} + +Los mensajes de notificación basados en etiquetas están pensados para todos los dispositivos suscritos a una etiqueta determinada. + +Puede definir etiquetas y, a continuación, enviar y recibir mensajes mediante etiquetas. Primero debe crear las etiquetas para la aplicación, configurar las suscripciones de etiquetas y, a continuación, iniciar las notificaciones basadas en etiquetas. Para enviar una notificación basada en código utilizando la [API REST](https://mobile.{DomainName}/imfpush/){: new_window}, asegúrese de que se proporcionen los "tagNames" al publicar en el recurso de mensajes. diff --git a/services/mobilepush/nl/es/c_user_basednotifications.md b/services/mobilepush/nl/es/c_user_basednotifications.md index 442b82671..0d476c1b9 100755 --- a/services/mobilepush/nl/es/c_user_basednotifications.md +++ b/services/mobilepush/nl/es/c_user_basednotifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Habilitación de notificaciones basadas en usuarios -{: #user_based_notifications} -Última actualización: 16 de enero de 2017 -{: .last-updated} - -Las {{site.data.keyword.mobilepushshort}} basadas en ID de usuario están pensadas para los usuarios de aplicaciones móviles con mensajes personalizados. Con las notificaciones basadas en usuarios, puede elegir notificar a individuos específicos según sus preferencias. - -## Dispositivo de registro con ID de usuario -Para habilitar las notificaciones push destinadas por ID de usuario, asegúrese de registrar el dispositivo con un campo de ID de usuario definido. - -El ID de usuario puede ser cualquier serie que proporcione la aplicación a la API de registro del dispositivo. Normalmente, las aplicaciones móviles primero ejecutan un ciclo de autenticación en el que el usuario de la aplicación se autentica en un servicio de autenticación, como por ejemplo [{{site.data.keyword.amafull}} ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}. Si la autenticación es correcta, el ID de usuario autenticado se pasa a la API de registro del dispositivo push. - -## Sincronización del inicio y cierre de sesión de un usuario - -Puede elegir el envío de notificaciones únicamente si el usuario ha iniciado la sesión. - -Por ejemplo, piense en un dispositivo compartido por los miembros de una familia o por un equipo de trabajo, y habrá necesidad de dirigirse a determinados usuarios. En tal caso práctico, habría una secuencia de inicio y cierre de sesión de usuario. Este mecanismo de autenticación permite que la aplicación efectúe un seguimiento de la identidad del usuario de la aplicación en cuestión. De esta manera, se garantiza que las notificaciones destinadas a un usuario específico lleguen siempre únicamente a dicho usuario. Después de iniciar sesión, invoque la API de registro de dispositivos pasando el ID de usuario del usuario conectado. De la misma manera, antes de cerrar la sesión, invoque la API de eliminación de registro de dispositivos. La secuenciación de estas API push con el inicio y el cierre de sesión garantizará que las notificaciones destinadas a un determinado usuario se envíen únicamente a dicho usuario. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Habilitación de notificaciones basadas en usuarios +{: #user_based_notifications} +Última actualización: 16 de enero de 2017 +{: .last-updated} + +Las {{site.data.keyword.mobilepushshort}} basadas en ID de usuario están pensadas para los usuarios de aplicaciones móviles con mensajes personalizados. Con las notificaciones basadas en usuarios, puede elegir notificar a individuos específicos según sus preferencias. + +## Dispositivo de registro con ID de usuario +Para habilitar las notificaciones push destinadas por ID de usuario, asegúrese de registrar el dispositivo con un campo de ID de usuario definido. + +El ID de usuario puede ser cualquier serie que proporcione la aplicación a la API de registro del dispositivo. Normalmente, las aplicaciones móviles primero ejecutan un ciclo de autenticación en el que el usuario de la aplicación se autentica en un servicio de autenticación, como por ejemplo [{{site.data.keyword.amafull}} ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}. Si la autenticación es correcta, el ID de usuario autenticado se pasa a la API de registro del dispositivo push. + +## Sincronización del inicio y cierre de sesión de un usuario + +Puede elegir el envío de notificaciones únicamente si el usuario ha iniciado la sesión. + +Por ejemplo, piense en un dispositivo compartido por los miembros de una familia o por un equipo de trabajo, y habrá necesidad de dirigirse a determinados usuarios. En tal caso práctico, habría una secuencia de inicio y cierre de sesión de usuario. Este mecanismo de autenticación permite que la aplicación efectúe un seguimiento de la identidad del usuario de la aplicación en cuestión. De esta manera, se garantiza que las notificaciones destinadas a un usuario específico lleguen siempre únicamente a dicho usuario. Después de iniciar sesión, invoque la API de registro de dispositivos pasando el ID de usuario del usuario conectado. De la misma manera, antes de cerrar la sesión, invoque la API de eliminación de registro de dispositivos. La secuenciación de estas API push con el inicio y el cierre de sesión garantizará que las notificaciones destinadas a un determinado usuario se envíen únicamente a dicho usuario. diff --git a/services/mobilepush/nl/es/c_web_extensions.md b/services/mobilepush/nl/es/c_web_extensions.md index 0c163ac1a..53e602fc4 100644 --- a/services/mobilepush/nl/es/c_web_extensions.md +++ b/services/mobilepush/nl/es/c_web_extensions.md @@ -1,107 +1,107 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Habilitación de aplicaciones y extensiones de Chrome para recibir {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -Última actualización: 18 de enero de 2017 -{: .last-updated} - -Puede habilitar las aplicaciones y extensiones de Google Chrome para que reciban {{site.data.keyword.mobilepushshort}}. Asegúrese de haber [configurado credenciales para un proveedor de notificaciones](t__main_push_config_provider.html) antes de continuar con estos pasos. - -## Instalación del SDK del cliente para {{site.data.keyword.mobilepushshort}} -{: #web_install} - -En este tema se describe cómo instalar y utilizar el SDK Push de JavaScript del cliente para seguir desarrollando aplicaciones y extensiones de Chrome. - -### Inicialización en aplicaciones y extensiones de Google Chrome - -Para la instalación del SDK de Javascript en las aplicaciones y extensiones de Chrome, realice estos pasos: - -Descargue `BMSPushSDK.js` y `manifest_Chrome_Ext.json` (para extensiones de Chrome) o `manifest_Chrome_App.json` (para aplicaciones de Chrome) desde el [SDK de push web de Bluemix ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. - - - -- Para aplicaciones de Chrome, configure el archivo de manifiesto: - 1. En el archivo `manifest_Chrome_App.json`, proporcione el nombre, la descripción y los iconos. - 2. Añada el `BMSPushSDK.js` en el `app.background.scripts`. - 3. Cambie el `manifest_Chrome_App.json` a `manifest.json`. - -- Para las extensiones de Chrome, configure el archivo de manifiesto: - 1. En el archivo `manifest_Chrome_Ext.json`, proporcione el nombre, la descripción y los iconos. - 2. Añada el `BMSPushSDK.js` en el `background.scripts`. - 3. Cambie el `manifest_Chrome_Ext.json` a `manifest.json`. - -En el archivo `background.js`, añada lo siguiente para recibir notificaciones push -``` -chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) -chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); -chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); -``` - {: codeblock} - - - -## Inicialización del SDK Push -{: #web_initialize} - -Inicialice el SDK Push con `app GUID` y `app Region` del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. - -Para obtener el GUID de la aplicación, seleccione la opción **Configuración** en el panel de navegación de los servicios push inicializados y haga clic en **Opciones móviles**. Modifique el fragmento de código para que utilice el parámetro appGUID del servicio de notificaciones push de Bluemix. - -`App Region` especifica la ubicación en la que se aloja el servicio {{site.data.keyword.mobilepushshort}}. Puede utilizar uno de estos tres valores: - - - Para Dallas, EE.UU.: `.ng.bluemix.net` - - Para RU: `.eu-gb.bluemix.net` - - Para Sídney: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) -``` - {: codeblock} - -## Registro de las aplicaciones y extensiones de Chrome -{: #web_register} - -Utilice la API `register()` para registrar el dispositivo con el servicio {{site.data.keyword.mobilepushshort}}. Para efectuar el registro desde Google Chrome, añada el URL del sitio web y la clave de API de Firebase Cloud Messaging (FCM) o Google Cloud Messaging (GCM) en el panel de control de configuración web del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. Para obtener más información, consulte [Configuración de credenciales para Google Cloud Messaging](t_push_provider_android.html) en la configuración de Chrome. - -Para efectuar el registro desde Mozilla Firefox, añada el URL del sitio web en el panel de control de configuración web del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. - -Utilice el siguiente fragmento de código para realizar el registro en el servicio {{site.data.keyword.mobilepushshort}} de Bluemix. -``` -var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Habilitación de aplicaciones y extensiones de Chrome para recibir {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +Última actualización: 18 de enero de 2017 +{: .last-updated} + +Puede habilitar las aplicaciones y extensiones de Google Chrome para que reciban {{site.data.keyword.mobilepushshort}}. Asegúrese de haber [configurado credenciales para un proveedor de notificaciones](t__main_push_config_provider.html) antes de continuar con estos pasos. + +## Instalación del SDK del cliente para {{site.data.keyword.mobilepushshort}} +{: #web_install} + +En este tema se describe cómo instalar y utilizar el SDK Push de JavaScript del cliente para seguir desarrollando aplicaciones y extensiones de Chrome. + +### Inicialización en aplicaciones y extensiones de Google Chrome + +Para la instalación del SDK de Javascript en las aplicaciones y extensiones de Chrome, realice estos pasos: + +Descargue `BMSPushSDK.js` y `manifest_Chrome_Ext.json` (para extensiones de Chrome) o `manifest_Chrome_App.json` (para aplicaciones de Chrome) desde el [SDK de push web de Bluemix ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. + + + +- Para aplicaciones de Chrome, configure el archivo de manifiesto: + 1. En el archivo `manifest_Chrome_App.json`, proporcione el nombre, la descripción y los iconos. + 2. Añada el `BMSPushSDK.js` en el `app.background.scripts`. + 3. Cambie el `manifest_Chrome_App.json` a `manifest.json`. + +- Para las extensiones de Chrome, configure el archivo de manifiesto: + 1. En el archivo `manifest_Chrome_Ext.json`, proporcione el nombre, la descripción y los iconos. + 2. Añada el `BMSPushSDK.js` en el `background.scripts`. + 3. Cambie el `manifest_Chrome_Ext.json` a `manifest.json`. + +En el archivo `background.js`, añada lo siguiente para recibir notificaciones push +``` +chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) +chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); +chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); +``` + {: codeblock} + + + +## Inicialización del SDK Push +{: #web_initialize} + +Inicialice el SDK Push con `app GUID` y `app Region` del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. + +Para obtener el GUID de la aplicación, seleccione la opción **Configuración** en el panel de navegación de los servicios push inicializados y haga clic en **Opciones móviles**. Modifique el fragmento de código para que utilice el parámetro appGUID del servicio de notificaciones push de Bluemix. + +`App Region` especifica la ubicación en la que se aloja el servicio {{site.data.keyword.mobilepushshort}}. Puede utilizar uno de estos tres valores: + + - Para Dallas, EE.UU.: `.ng.bluemix.net` + - Para RU: `.eu-gb.bluemix.net` + - Para Sídney: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) +``` + {: codeblock} + +## Registro de las aplicaciones y extensiones de Chrome +{: #web_register} + +Utilice la API `register()` para registrar el dispositivo con el servicio {{site.data.keyword.mobilepushshort}}. Para efectuar el registro desde Google Chrome, añada el URL del sitio web y la clave de API de Firebase Cloud Messaging (FCM) o Google Cloud Messaging (GCM) en el panel de control de configuración web del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. Para obtener más información, consulte [Configuración de credenciales para Google Cloud Messaging](t_push_provider_android.html) en la configuración de Chrome. + +Para efectuar el registro desde Mozilla Firefox, añada el URL del sitio web en el panel de control de configuración web del servicio {{site.data.keyword.mobilepushshort}} de Bluemix. + +Utilice el siguiente fragmento de código para realizar el registro en el servicio {{site.data.keyword.mobilepushshort}} de Bluemix. +``` +var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + diff --git a/services/mobilepush/nl/es/c_web_extensions_send.md b/services/mobilepush/nl/es/c_web_extensions_send.md index 2142736e9..7ebab09ba 100644 --- a/services/mobilepush/nl/es/c_web_extensions_send.md +++ b/services/mobilepush/nl/es/c_web_extensions_send.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Envío de notificaciones básicas a aplicaciones y extensiones de Chrome -{: #web_extensions_notifications} -Última actualización: 11 de enero de 2017 -{: .last-updated} - -Una vez que haya desarrollado sus aplicaciones, puede enviar una notificación push. - -1. Seleccione **Enviar notificaciones** y para redactar un mensaje seleccione **Notificaciones web** como opción **Enviar a**. -2. Escriba el mensaje en el campo **Mensaje**. -3. Puede elegir que se proporcionen valores opcionales: - - **Título de notificación**: es el texto que se visualizará como mensaje en la cabecera de la alerta de mensaje. - - **URL de icono de notificación**: si el mensaje debe entregarse con un icono de notificación de la aplicación, indique el enlace al icono en este campo. - - **Contraer clave**: las claves contraídas se adjuntan a las notificaciones. Si llegan varias notificaciones de forma secuencias con la misma clave contraída cuando el dispositivo está desconectado, estas se contraerán. Cuando el dispositivo vuelva a conectarse, recibirá las notificaciones del servidor FCM/GCM y mostrará solo la última notificación transportada con la misma clave contraída. Si no se establece esta clave contraída, se almacenarán los mensajes nuevos y antiguos para entregarlos más adelante. - - **Tiempo de duración**: este valor se establece en segundos. Si no se especifica este parámetro, el servidor FCM/GCM almacenará el mensaje cuatro semanas e intentará entregarlo. La validez caduca transcurridas cuatro semanas. El intervalo de valores posible es de 0 a 2.419.200 segundos. - - **Retrasar cuando esté desocupado**: si se define como `true`, el servidor FCM/GCM no entregará la notificación cuando el dispositivo esté desocupado. Establezca este valor en `false` para garantizar que se entregan notificaciones aunque el dispositivo esté desocupado. - - **Carga útil adicional**: permite especificar valores personalizados de carga útil para las notificaciones. - -En la imagen siguiente se muestra la opción de notificaciones de apps y extensiones Chrome en el panel de control. - - ![pantalla Notificaciones](images/push_chrome_extns.jpg) - -## Pasos siguientes - {: #next_steps_tags} - -Una vez que haya configurado correctamente las notificaciones básicas, puede optar por configurar las notificaciones basadas en código y las opciones avanzadas. - -Añada las características de servicio de {{site.data.keyword.mobilepushshort}} a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones avanzadas](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Envío de notificaciones básicas a aplicaciones y extensiones de Chrome +{: #web_extensions_notifications} +Última actualización: 11 de enero de 2017 +{: .last-updated} + +Una vez que haya desarrollado sus aplicaciones, puede enviar una notificación push. + +1. Seleccione **Enviar notificaciones** y para redactar un mensaje seleccione **Notificaciones web** como opción **Enviar a**. +2. Escriba el mensaje en el campo **Mensaje**. +3. Puede elegir que se proporcionen valores opcionales: + - **Título de notificación**: es el texto que se visualizará como mensaje en la cabecera de la alerta de mensaje. + - **URL de icono de notificación**: si el mensaje debe entregarse con un icono de notificación de la aplicación, indique el enlace al icono en este campo. + - **Contraer clave**: las claves contraídas se adjuntan a las notificaciones. Si llegan varias notificaciones de forma secuencias con la misma clave contraída cuando el dispositivo está desconectado, estas se contraerán. Cuando el dispositivo vuelva a conectarse, recibirá las notificaciones del servidor FCM/GCM y mostrará solo la última notificación transportada con la misma clave contraída. Si no se establece esta clave contraída, se almacenarán los mensajes nuevos y antiguos para entregarlos más adelante. + - **Tiempo de duración**: este valor se establece en segundos. Si no se especifica este parámetro, el servidor FCM/GCM almacenará el mensaje cuatro semanas e intentará entregarlo. La validez caduca transcurridas cuatro semanas. El intervalo de valores posible es de 0 a 2.419.200 segundos. + - **Retrasar cuando esté desocupado**: si se define como `true`, el servidor FCM/GCM no entregará la notificación cuando el dispositivo esté desocupado. Establezca este valor en `false` para garantizar que se entregan notificaciones aunque el dispositivo esté desocupado. + - **Carga útil adicional**: permite especificar valores personalizados de carga útil para las notificaciones. + +En la imagen siguiente se muestra la opción de notificaciones de apps y extensiones Chrome en el panel de control. + + ![pantalla Notificaciones](images/push_chrome_extns.jpg) + +## Pasos siguientes + {: #next_steps_tags} + +Una vez que haya configurado correctamente las notificaciones básicas, puede optar por configurar las notificaciones basadas en código y las opciones avanzadas. + +Añada las características de servicio de {{site.data.keyword.mobilepushshort}} a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones avanzadas](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/es/images/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/es/images/t_enable_actionable_notifications_ios.md index 85b75c92c..225b37b2c 100755 --- a/services/mobilepush/nl/es/images/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/es/images/t_enable_actionable_notifications_ios.md @@ -1,103 +1,103 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Habilitación de notificaciones accionables para iOS -{: #enable-actionable-notifications-ios} - -A diferencia de las notificaciones push tradicionales, estas solicitan a los usuarios que realicen una selección al recibir la alerta de notificación sin abrir la app. Siga las instrucciones siguientes para habilitar notificaciones push en la aplicación. - -1. Cree una acción de respuesta del usuario. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. Cree la categoría de notificaciones y configure una acción. **UIUserNotificationActionContextDefault** o **UIUserNotificationActionContextMinimal** son contextos válidos. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. Cree el valor de notificación y asigne las categorías desde el paso anterior. - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. Cree una notificación remota o local y asígnele la identidad de la categoría. - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Habilitación de notificaciones accionables para iOS +{: #enable-actionable-notifications-ios} + +A diferencia de las notificaciones push tradicionales, estas solicitan a los usuarios que realicen una selección al recibir la alerta de notificación sin abrir la app. Siga las instrucciones siguientes para habilitar notificaciones push en la aplicación. + +1. Cree una acción de respuesta del usuario. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. Cree la categoría de notificaciones y configure una acción. **UIUserNotificationActionContextDefault** o **UIUserNotificationActionContextMinimal** son contextos válidos. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. Cree el valor de notificación y asigne las categorías desde el paso anterior. + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. Cree una notificación remota o local y asígnele la identidad de la categoría. + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/es/index.md b/services/mobilepush/nl/es/index.md index 4dfcc9ff2..33dfd415a 100644 --- a/services/mobilepush/nl/es/index.md +++ b/services/mobilepush/nl/es/index.md @@ -1,54 +1,54 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Iniciación a {{site.data.keyword.mobilepushshort}} -{: #gettingstartedtemplate} -Última actualización: 19 de enero de 2017 -{: .last-updated} - -{:shortdesc} - -{{site.data.keyword.mobilepushshort}} está disponible como servicio de catálogo de Bluemix en la categoría Móvil y le permite enviar y gestionar notificaciones push móviles y de web. El servicio gestiona la correlación de los usuarios de la aplicación con sus dispositivos, plataforma de dispositivo y navegadores web mientras gestiona el envío de notificaciones. - - {{site.data.keyword.mobilepushshort}} está disponible como parte del contenedor modelo de iniciador de servicios MobileFirst y como [servicios dedicados](/docs/dedicated/index.html) de Bluemix. Puede utilizar el servicio para enviar difusiones, difusiones únicas (en función del ID de dispositivo y del ID de usuario), notificaciones basadas en etiquetas, notificaciones webhooks basadas en sucesos y notificaciones Rich Media y notificaciones interactivas a los usuarios de la aplicación móvil y del navegador web. También puede utilizar un SDK (kit de desarrollo de software) y [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window} para desarrollar más las aplicaciones de cliente. - -El servicio también le ofrece funciones de supervisión que le ayudan a supervisar el rendimiento de las notificaciones Push mediante la generación de gráficos e informes a partir de sus datos de usuario. Consulte [Supervisión de notificaciones Push](/docs/services/mobilepush/t_push_monitoring.html). - -El servicio {{site.data.keyword.mobilepushshort}} se admite en las siguientes plataformas: - -- [Dispositivos móviles iOS y Android](/docs/services/mobilepush/c_enable_push.html) -- [Navegadores web Google Chrome, Mozilla Firefox y Safari](/docs/services/mobilepush/c_chrome_firefox_enable.html) -- [Aplicaciones y extensiones de Google Chrome](/docs/services/mobilepush/c_web_extensions.html) - - -# Enlaces relacionados -{: #rellinks} - -* [Visión general de ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](c_overview_push.html){: new_window} - -## Guías de aprendizaje y ejemplos {:id="samples"} -{: #samples} -* [Aplicación de ejemplo helloPush de Android ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} -- [Aplicación de ejemplo de Cordova ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} -* [Aplicación de ejemplo helloPush de iOS (Swift) ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} - -## SDK -{: #sdk} -* [SDK de Android ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} -* [SDK de Cordova ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} -* [SDK de iOS (Swift) ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} - -## Referencia de API -{: #api} -* [Consulta de API Push (Android) ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} -* [iOS de consulta de API BMSPush (Swift) ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} -* [Consulta de API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window} +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Iniciación a {{site.data.keyword.mobilepushshort}} +{: #gettingstartedtemplate} +Última actualización: 19 de enero de 2017 +{: .last-updated} + +{:shortdesc} + +{{site.data.keyword.mobilepushshort}} está disponible como servicio de catálogo de Bluemix en la categoría Móvil y le permite enviar y gestionar notificaciones push móviles y de web. El servicio gestiona la correlación de los usuarios de la aplicación con sus dispositivos, plataforma de dispositivo y navegadores web mientras gestiona el envío de notificaciones. + + {{site.data.keyword.mobilepushshort}} está disponible como parte del contenedor modelo de iniciador de servicios MobileFirst y como [servicios dedicados](/docs/dedicated/index.html) de Bluemix. Puede utilizar el servicio para enviar difusiones, difusiones únicas (en función del ID de dispositivo y del ID de usuario), notificaciones basadas en etiquetas, notificaciones webhooks basadas en sucesos y notificaciones Rich Media y notificaciones interactivas a los usuarios de la aplicación móvil y del navegador web. También puede utilizar un SDK (kit de desarrollo de software) y [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window} para desarrollar más las aplicaciones de cliente. + +El servicio también le ofrece funciones de supervisión que le ayudan a supervisar el rendimiento de las notificaciones Push mediante la generación de gráficos e informes a partir de sus datos de usuario. Consulte [Supervisión de notificaciones Push](/docs/services/mobilepush/t_push_monitoring.html). + +El servicio {{site.data.keyword.mobilepushshort}} se admite en las siguientes plataformas: + +- [Dispositivos móviles iOS y Android](/docs/services/mobilepush/c_enable_push.html) +- [Navegadores web Google Chrome, Mozilla Firefox y Safari](/docs/services/mobilepush/c_chrome_firefox_enable.html) +- [Aplicaciones y extensiones de Google Chrome](/docs/services/mobilepush/c_web_extensions.html) + + +# Enlaces relacionados +{: #rellinks} + +* [Visión general de ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](c_overview_push.html){: new_window} + +## Guías de aprendizaje y ejemplos {:id="samples"} +{: #samples} +* [Aplicación de ejemplo helloPush de Android ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} +- [Aplicación de ejemplo de Cordova ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} +* [Aplicación de ejemplo helloPush de iOS (Swift) ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} + +## SDK +{: #sdk} +* [SDK de Android ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} +* [SDK de Cordova ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} +* [SDK de iOS (Swift) ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} + +## Referencia de API +{: #api} +* [Consulta de API Push (Android) ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} +* [iOS de consulta de API BMSPush (Swift) ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} +* [Consulta de API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window} diff --git a/services/mobilepush/nl/es/interactive_notifications.md b/services/mobilepush/nl/es/interactive_notifications.md index 6a6a6d2cb..3fa4b9096 100755 --- a/services/mobilepush/nl/es/interactive_notifications.md +++ b/services/mobilepush/nl/es/interactive_notifications.md @@ -1,83 +1,83 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Notificaciones interactivas -{: #interactive-notifications} -Última actualización: 23 de enero de 2017 -{: .last-updated} - -Las notificaciones interactivas permiten a los usuarios responder a notificaciones sin tener que abrir la aplicación. Cuando llega una notificación interactiva, el dispositivo mostrará los botones de acción junto con el mensaje de notificación. Se admiten notificaciones interactivas en dispositivos iOS con versión 8 o posteriores. Para notificaciones interactivas enviadas a dispositivos iOS anteriores a la versión 8, no se mostrarán las acciones de notificación. - -##Envío de {{site.data.keyword.mobilepushshort}} interactivas - - -La notificación interactiva puede enviarse utilizando el panel de control de push o utilizando la [Documentación de la API REST](t_restapi.html). - -Desde la consola de {{site.data.keyword.mobilepushshort}}: - -1. En el separador de notificaciones del panel de control de Push, pulse **Enviar notificación**. -2. Elija los destinatarios de la notificación y pulse **Siguiente**. -3. En la página para crear notificaciones se puede enviar un push interactivo estableciendo Tipo en Predeterminado o Mixto y especificando Valor de categoría en el separador Opciones avanzadas. Para configurar el valor de categoría en el cliente, consulte la sección **Manejo de {{site.data.keyword.mobilepushshort}} interactivas** en aplicaciones iOS nativas. - -## Manejo de {{site.data.keyword.mobilepushshort}} interactivas en una aplicación iOS - - -### Swift - -Siga estos pasos para recibir notificaciones interactivas: - -1. Habilite la funcionalidad de la aplicación para realizar tareas en segundo plano al recibir notificaciones remotas. -1. Inicialice el SDK `BMSPush` con su categoría de acción. - ``` - let myBMSClient = BMSClient.sharedInstance - myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) - let push = BMSPushClient.sharedInstance - let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) - let notifOptions = BMSPushClientOptions(categoryName: [category]) - push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) - ``` - {: codeblock} - -1. Implemente el nuevo método callback en AppDelegate: - ``` - func userNotificationCenter(_ center: UNUserNotificationCenter, - didReceive response: UNNotificationResponse, - withCompletionHandler completionHandler: @escaping () -> Void) { - switch response.actionIdentifier { - case "FIRST": - print("FIRST") - case "SECOND": - print("SECOND") - default: - print("Unknown action") - } - completionHandler - } - ``` - {: codeblock} -5. Este nuevo método callback se invoca cuando el usuario pulsa el botón de acción. La implementación de este método debe realizar tareas asociadas con el identificador especificado y ejecutar el bloque en el parámetro `completionHandler`. - - -### Cordova - -Para recibir una notificación accionable en una aplicación de iOS Cordova, siga estos pasos: - -1. Añada el campo de categoría dentro del método `BMSPush.initialize`. - ``` - var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} - BMSPush.initialize(appGUID,clientSecret,category); - ``` - {: codeblock} -2. Implemente el nuevo método callback en AppDelegate. -3. Este nuevo método callback se invoca cuando el usuario pulsa el botón de acción. La implementación de este método debe realizar tareas asociadas con el identificador especificado y ejecutar el bloque en el parámetro completionHandler. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Notificaciones interactivas +{: #interactive-notifications} +Última actualización: 23 de enero de 2017 +{: .last-updated} + +Las notificaciones interactivas permiten a los usuarios responder a notificaciones sin tener que abrir la aplicación. Cuando llega una notificación interactiva, el dispositivo mostrará los botones de acción junto con el mensaje de notificación. Se admiten notificaciones interactivas en dispositivos iOS con versión 8 o posteriores. Para notificaciones interactivas enviadas a dispositivos iOS anteriores a la versión 8, no se mostrarán las acciones de notificación. + +## Envío de {{site.data.keyword.mobilepushshort}} interactivas + + +La notificación interactiva puede enviarse utilizando el panel de control de push o utilizando la [Documentación de la API REST](t_restapi.html). + +Desde la consola de {{site.data.keyword.mobilepushshort}}: + +1. En el separador de notificaciones del panel de control de Push, pulse **Enviar notificación**. +2. Elija los destinatarios de la notificación y pulse **Siguiente**. +3. En la página para crear notificaciones se puede enviar un push interactivo estableciendo Tipo en Predeterminado o Mixto y especificando Valor de categoría en el separador Opciones avanzadas. Para configurar el valor de categoría en el cliente, consulte la sección **Manejo de {{site.data.keyword.mobilepushshort}} interactivas** en aplicaciones iOS nativas. + +## Manejo de {{site.data.keyword.mobilepushshort}} interactivas en una aplicación iOS + + +### Swift + +Siga estos pasos para recibir notificaciones interactivas: + +1. Habilite la funcionalidad de la aplicación para realizar tareas en segundo plano al recibir notificaciones remotas. +1. Inicialice el SDK `BMSPush` con su categoría de acción. + ``` + let myBMSClient = BMSClient.sharedInstance + myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) + let push = BMSPushClient.sharedInstance + let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) + let notifOptions = BMSPushClientOptions(categoryName: [category]) + push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) + ``` + {: codeblock} + +1. Implemente el nuevo método callback en AppDelegate: + ``` + func userNotificationCenter(_ center: UNUserNotificationCenter, + didReceive response: UNNotificationResponse, + withCompletionHandler completionHandler: @escaping () -> Void) { + switch response.actionIdentifier { + case "FIRST": + print("FIRST") + case "SECOND": + print("SECOND") + default: + print("Unknown action") + } + completionHandler + } + ``` + {: codeblock} +5. Este nuevo método callback se invoca cuando el usuario pulsa el botón de acción. La implementación de este método debe realizar tareas asociadas con el identificador especificado y ejecutar el bloque en el parámetro `completionHandler`. + + +### Cordova + +Para recibir una notificación accionable en una aplicación de iOS Cordova, siga estos pasos: + +1. Añada el campo de categoría dentro del método `BMSPush.initialize`. + ``` + var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} + BMSPush.initialize(appGUID,clientSecret,category); + ``` + {: codeblock} +2. Implemente el nuevo método callback en AppDelegate. +3. Este nuevo método callback se invoca cuando el usuario pulsa el botón de acción. La implementación de este método debe realizar tareas asociadas con el identificador especificado y ejecutar el bloque en el parámetro completionHandler. diff --git a/services/mobilepush/nl/es/next_steps_tags.md b/services/mobilepush/nl/es/next_steps_tags.md index 393c70e87..bfb1e959b 100755 --- a/services/mobilepush/nl/es/next_steps_tags.md +++ b/services/mobilepush/nl/es/next_steps_tags.md @@ -1,21 +1,21 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Pasos siguientes -{: #next_steps_tags} -Última actualización: 11 de enero de 2017 -{: .last-updated} - -Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. - -Añada las características de servicio de {{site.data.keyword.mobilepushshort}} a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). -Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones push avanzadas](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Pasos siguientes +{: #next_steps_tags} +Última actualización: 11 de enero de 2017 +{: .last-updated} + +Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. + +Añada las características de servicio de {{site.data.keyword.mobilepushshort}} a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). +Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones push avanzadas](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/es/silent_notifications.md b/services/mobilepush/nl/es/silent_notifications.md index 4313a9304..f6ce2a551 100755 --- a/services/mobilepush/nl/es/silent_notifications.md +++ b/services/mobilepush/nl/es/silent_notifications.md @@ -1,39 +1,39 @@ ------- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Manejo de notificaciones silenciosas para iOS -{: #silent-notifications} -Última actualización: 16 de enero de 2017 -{: .last-updated} - -Las notificaciones silenciosas no aparecen en la pantalla del dispositivo. Estas notificaciones se reciben mediante la aplicación en segundo plano, que activa la aplicación durante 30 segundos para realizar la tarea en segundo plano. Puede que el usuario no tenga en cuenta la llegada de la notificación. Para enviar notificaciones silenciosas para iOS, utilice la [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. - -1. Para enviar notificaciones push silenciosas, implemente el siguiente método en el archivo `appDelegate.m` del proyecto. En Swift, el valor `contentAvailable` que envía el servidor para las instalaciones silenciosas es igual a 1. -``` -// Para Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - let contentAPS = userInfo["aps"] as [NSObject : AnyObject] - if let contentAvailable = contentAPS["content-available"] as? Int { - //silent or mixed push - if contentAvailable == 1 { - completionHandler(UIBackgroundFetchResult.NewData) - } else { - completionHandler(UIBackgroundFetchResult.NoData) - } - } else { - //Default notification - completionHandler(UIBackgroundFetchResult.NoData) - } - } -``` - {: codeblock} - +------ + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Manejo de notificaciones silenciosas para iOS +{: #silent-notifications} +Última actualización: 16 de enero de 2017 +{: .last-updated} + +Las notificaciones silenciosas no aparecen en la pantalla del dispositivo. Estas notificaciones se reciben mediante la aplicación en segundo plano, que activa la aplicación durante 30 segundos para realizar la tarea en segundo plano. Puede que el usuario no tenga en cuenta la llegada de la notificación. Para enviar notificaciones silenciosas para iOS, utilice la [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. + +1. Para enviar notificaciones push silenciosas, implemente el siguiente método en el archivo `appDelegate.m` del proyecto. En Swift, el valor `contentAvailable` que envía el servidor para las instalaciones silenciosas es igual a 1. +``` +// Para Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + let contentAPS = userInfo["aps"] as [NSObject : AnyObject] + if let contentAvailable = contentAPS["content-available"] as? Int { + //silent or mixed push + if contentAvailable == 1 { + completionHandler(UIBackgroundFetchResult.NewData) + } else { + completionHandler(UIBackgroundFetchResult.NoData) + } + } else { + //Default notification + completionHandler(UIBackgroundFetchResult.NoData) + } + } +``` + {: codeblock} + diff --git a/services/mobilepush/nl/es/t__main_push_config_provider.md b/services/mobilepush/nl/es/t__main_push_config_provider.md index 099805c88..09cd3406a 100755 --- a/services/mobilepush/nl/es/t__main_push_config_provider.md +++ b/services/mobilepush/nl/es/t__main_push_config_provider.md @@ -1,21 +1,21 @@ - ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configuración de credenciales para un proveedor de notificaciones -{: #create-push-credentials} -Última actualización: 18 de enero de 2017 -{: .last-updated} - -Para configurar el servicio {{site.data.keyword.mobilepushshort}}, obtenga las credenciales necesarias del proveedor de notificaciones push - Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) o el servicio de notificaciones Push de Apple ([APNs](t_push_provider_ios.html)) para dispositivos móviles. Para navegadores web, consulte [Configuración de credenciales para navegadores web](t_push_provider_safari.html). - -Puede configurar {{site.data.keyword.mobilepushshort}} mediante el panel de control de **IBM Bluemix Services** o mediante las [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. + +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configuración de credenciales para un proveedor de notificaciones +{: #create-push-credentials} +Última actualización: 18 de enero de 2017 +{: .last-updated} + +Para configurar el servicio {{site.data.keyword.mobilepushshort}}, obtenga las credenciales necesarias del proveedor de notificaciones push - Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) o el servicio de notificaciones Push de Apple ([APNs](t_push_provider_ios.html)) para dispositivos móviles. Para navegadores web, consulte [Configuración de credenciales para navegadores web](t_push_provider_safari.html). + +Puede configurar {{site.data.keyword.mobilepushshort}} mediante el panel de control de **IBM Bluemix Services** o mediante las [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. diff --git a/services/mobilepush/nl/es/t_advance_badge_sound_payload.md b/services/mobilepush/nl/es/t_advance_badge_sound_payload.md index 7e62aee5d..f32d9bdc8 100755 --- a/services/mobilepush/nl/es/t_advance_badge_sound_payload.md +++ b/services/mobilepush/nl/es/t_advance_badge_sound_payload.md @@ -1,77 +1,77 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#Habilitación de {{site.data.keyword.mobilepushshort}} avanzado -Última actualización: 23 de enero de 2017 -{: .last-updated} - -Configure un identificador de iOS, un sonido, una carga útil de JSON adicional, notificaciones accionables y notificaciones retenidas. - -## Configure un sonido y carga útil e identificador iOS -{: #badge-sound-payload} - -Configure un identificador y un sonido de iOS, y carga útil adicional de JSON. - -1. En el panel de control {{site.data.keyword.mobilepushshort}}, vaya al separador **Notificaciones**. -2. Vaya a la sección **Campos opcionales** para configurar las características de {{site.data.keyword.mobilepushshort}}. - - **Archivo de sonido**: Escriba una serie que apunte al archivo de sonido de la app móvil. En la carga útil, especifique el nombre de serie del archivo de sonido a utilizar. - - **Identificador iOS**: Para dispositivos iOS, el número que se mostrará como el identificador del icono de app. Si falta esta propiedad, el identificador no se modificará. Para eliminar el identificador, establezca el valor de esta propiedad en 0. - -###Android - -Añada el archivo de sonido en el directorio `res/raw` de la aplicación android. Al enviar la notificación, añada el nombre del archivo de sonido en el campo de sonido de {{site.data.keyword.mobilepushshort}}. - -``` -"settings": { - "gcm" : { - "sound":"tt.wav", - } - } -``` - {: codeblock} - -###iOS - -``` -"settings": { - "apns" : { - "badge": 10, - "sound": "tt.wav", - } -} -``` - {: codeblock} - -**Carga útil adicional**: Esta carga útil puede ser cualquier par de clave-valor y debe ser un objeto JSON que desee enviar con la {{site.data.keyword.mobilepushshort}}. - -``` -{"key":"value", "key2":"value2"} -``` - {: codeblock} - -## Retención de notificaciones de Android -{: #hold-notifications-android} - -Cuando su aplicación entre en segundo plano, probablemente querrá que la {{site.data.keyword.mobilepushshort}} retenga las notificaciones enviadas a la aplicación. Para retener las notificaciones, llame el método hold() en el método onPause() de la actividad que maneja las {{site.data.keyword.mobilepushshort}}. - -``` -@Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Habilitación de {{site.data.keyword.mobilepushshort}} avanzado +Última actualización: 23 de enero de 2017 +{: .last-updated} + +Configure un identificador de iOS, un sonido, una carga útil de JSON adicional, notificaciones accionables y notificaciones retenidas. + +## Configure un sonido y carga útil e identificador iOS +{: #badge-sound-payload} + +Configure un identificador y un sonido de iOS, y carga útil adicional de JSON. + +1. En el panel de control {{site.data.keyword.mobilepushshort}}, vaya al separador **Notificaciones**. +2. Vaya a la sección **Campos opcionales** para configurar las características de {{site.data.keyword.mobilepushshort}}. + - **Archivo de sonido**: Escriba una serie que apunte al archivo de sonido de la app móvil. En la carga útil, especifique el nombre de serie del archivo de sonido a utilizar. + - **Identificador iOS**: Para dispositivos iOS, el número que se mostrará como el identificador del icono de app. Si falta esta propiedad, el identificador no se modificará. Para eliminar el identificador, establezca el valor de esta propiedad en 0. + +### Android + +Añada el archivo de sonido en el directorio `res/raw` de la aplicación android. Al enviar la notificación, añada el nombre del archivo de sonido en el campo de sonido de {{site.data.keyword.mobilepushshort}}. + +``` +"settings": { + "gcm" : { + "sound":"tt.wav", + } + } +``` + {: codeblock} + +### iOS + +``` +"settings": { + "apns" : { + "badge": 10, + "sound": "tt.wav", + } +} +``` + {: codeblock} + +**Carga útil adicional**: Esta carga útil puede ser cualquier par de clave-valor y debe ser un objeto JSON que desee enviar con la {{site.data.keyword.mobilepushshort}}. + +``` +{"key":"value", "key2":"value2"} +``` + {: codeblock} + +## Retención de notificaciones de Android +{: #hold-notifications-android} + +Cuando su aplicación entre en segundo plano, probablemente querrá que la {{site.data.keyword.mobilepushshort}} retenga las notificaciones enviadas a la aplicación. Para retener las notificaciones, llame el método hold() en el método onPause() de la actividad que maneja las {{site.data.keyword.mobilepushshort}}. + +``` +@Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} + + diff --git a/services/mobilepush/nl/es/t_android_create_unbound_service.md b/services/mobilepush/nl/es/t_android_create_unbound_service.md index e0809eca3..f5757b1d4 100644 --- a/services/mobilepush/nl/es/t_android_create_unbound_service.md +++ b/services/mobilepush/nl/es/t_android_create_unbound_service.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Creación de un servicio {{site.data.keyword.mobilepushshort}} desenlazado para Android -{: #create_android_unbound} -Última actualización: 11 de enero de 2017 -{: .last-updated} - -Cree una instancia del servicio {{site.data.keyword.mobilepushshort}}. Puede utilizar la instancia del servicio {{site.data.keyword.mobilepushshort}} sin enlazar ninguna aplicación de fondo. - -1. Enlace la instancia del servicio {{site.data.keyword.mobilepushshort}} a una aplicación de Bluemix. Al hacerlo, podrá ver que todos los detalles relacionados con el servicio están almacenados en formato JSON en la variable de entorno VCAP_SERVICES. - -![Enlace de un servicio Notificación push](images/unbound_1.jpg) - 2. Pulse **Enlazar** y elija la instancia del servicio {{site.data.keyword.mobilepushshort}} que desee enlazar. Cuando la aplicación esté enlazada con el servicio {{site.data.keyword.mobilepushshort}}, la información del servicio se almacenará en formato JSON en la variable de entorno VCAP_SERVICES de su aplicación. Por ejemplo: -``` - { - "imfpush_Dev": [ - { - "name": "myname_sampleUnbound", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": null - } - ] - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Creación de un servicio {{site.data.keyword.mobilepushshort}} desenlazado para Android +{: #create_android_unbound} +Última actualización: 11 de enero de 2017 +{: .last-updated} + +Cree una instancia del servicio {{site.data.keyword.mobilepushshort}}. Puede utilizar la instancia del servicio {{site.data.keyword.mobilepushshort}} sin enlazar ninguna aplicación de fondo. + +1. Enlace la instancia del servicio {{site.data.keyword.mobilepushshort}} a una aplicación de Bluemix. Al hacerlo, podrá ver que todos los detalles relacionados con el servicio están almacenados en formato JSON en la variable de entorno VCAP_SERVICES. + +![Enlace de un servicio Notificación push](images/unbound_1.jpg) + 2. Pulse **Enlazar** y elija la instancia del servicio {{site.data.keyword.mobilepushshort}} que desee enlazar. Cuando la aplicación esté enlazada con el servicio {{site.data.keyword.mobilepushshort}}, la información del servicio se almacenará en formato JSON en la variable de entorno VCAP_SERVICES de su aplicación. Por ejemplo: +``` + { + "imfpush_Dev": [ + { + "name": "myname_sampleUnbound", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": null + } + ] + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/es/t_android_initialize.md b/services/mobilepush/nl/es/t_android_initialize.md index 9e3bbc9b7..021e32b75 100644 --- a/services/mobilepush/nl/es/t_android_initialize.md +++ b/services/mobilepush/nl/es/t_android_initialize.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Inicialización del SDK push para aplicaciones Android -{: #android_initialize} - -Un lugar común para colocar el código de inicialización se encuentra en el método onCreate de la actividad principal en su aplicación Android. - -Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y el applicationGUID. Utilice estos valores para su ruta y GUID de la app. Modifique el fragmento de código para que utilice los parámetros appRoute y appGUID de la aplicación Bluemix. - - -##Inicializar el SDK principal - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -Especifica la ruta que se asigna a la aplicación de servidor que ha creado en Bluemix. - -**AppGUID** - -Especifica la clave exclusiva asignada a la aplicación que ha creado en Bluemix. Este valor distingue entre mayúsculas y minúsculas. - -**bluemixRegionSuffix** - -Especifica la ubicación donde se ha alojado la app. Puede utilizar uno de estos tres valores: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##Inicializar el SDK push del cliente - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Inicialización del SDK push para aplicaciones Android +{: #android_initialize} + +Un lugar común para colocar el código de inicialización se encuentra en el método onCreate de la actividad principal en su aplicación Android. + +Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y el applicationGUID. Utilice estos valores para su ruta y GUID de la app. Modifique el fragmento de código para que utilice los parámetros appRoute y appGUID de la aplicación Bluemix. + + +## Inicializar el SDK principal + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +Especifica la ruta que se asigna a la aplicación de servidor que ha creado en Bluemix. + +**AppGUID** + +Especifica la clave exclusiva asignada a la aplicación que ha creado en Bluemix. Este valor distingue entre mayúsculas y minúsculas. + +**bluemixRegionSuffix** + +Especifica la ubicación donde se ha alojado la app. Puede utilizar uno de estos tres valores: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +## Inicializar el SDK push del cliente + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` diff --git a/services/mobilepush/nl/es/t_android_install_sdk.md b/services/mobilepush/nl/es/t_android_install_sdk.md index c0a42c163..c042a3bcc 100644 --- a/services/mobilepush/nl/es/t_android_install_sdk.md +++ b/services/mobilepush/nl/es/t_android_install_sdk.md @@ -1,218 +1,218 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Instalación del SDK Push del cliente con Gradle -{: #android_install} - -En esta sección se describe cómo instalar y utilizar el SDK Push del cliente para seguir desarrollando sus aplicaciones Android. - -El SDK push de servicios móviles de Bluemix® se puede añadir mediante Gradle. Gradle descarga automáticamente artefactos desde los repositorios y los deja a disposición de su aplicación Android. Asegúrese de que ha configurado correctamente Android Studio y el SDK de Android Studio. Para obtener más información sobre cómo configurar el sistema, consulte [Visión general de Android Studio](https://developer.android.com/tools/studio/index.html). Para obtener información sobre Gradle, consulte [Configuración de compilaciones de Gradle](http://developer.android.com/tools/building/configuring-gradle.html). - -1. En Android Studio, tras crear y abrir la aplicación móvil, abra el archivo **build.gradle** de la aplicación. A continuación, añada las siguientes dependencias a la aplicación móvil. Estas sentencias de importación son necesarias para los fragmentos de código: - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - - -1. Añada las dependencias siguientes a la aplicación móvil. Las líneas siguientes añaden el SDK de cliente push de Bluemix™ Mobile Services y el SDK de Google Play Services a las dependencias de ámbito de compilación. - - ``` - dependencies { - compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' - compile 'com.google.android.gms:play-services:7.8.0' - } - ``` -1. En el archivo **AndroidManifest.xml**, añada los permisos siguientes. Para ver un manifiesto de muestra, consulte [Aplicación de ejemplo helloPush de Android](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml). Para ver un archivo Gradle de muestra, consulte [Archivo Gradle de compilación de muestra](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle). - - ``` - - - - - - - - - ``` - - Puede leer más información sobre los [permisos de Android](http://developer.android.com/guide/topics/security/permissions.html) aquí. - -1. Añade los valores de intención de notificación para la actividad. Este valor inicia la aplicación cuando el usuario pulsa la notificación recibida desde el área de notificación. - - ``` - - - - - ``` - **Nota**: sustituya *Your_Android_Package_Name* en la acción anterior con el nombre del paquete de aplicaciones utilizado en la aplicación. - -1. Añade el servicio de intento de Google Cloud Messaging (GCM) y los filtros de intento para las notificaciones de sucesos RECEIVE. - - ``` - service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> - - - - - - - - - - - - - - ``` - - - -# Inicialización del SDK push para aplicaciones Android -{: #android_initialize} - -Un lugar común para colocar el código de inicialización se encuentra en el método onCreate de la actividad principal en su aplicación Android. - -Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y el applicationGUID. Utilice estos valores para su ruta y GUID de la app. Modifique el fragmento de código para que utilice los parámetros appRoute y appGUID de la aplicación Bluemix. - - -##Inicializar el SDK principal - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -Especifica la ruta que se asigna a la aplicación de servidor que ha creado en Bluemix. - -**AppGUID** - -Especifica la clave exclusiva asignada a la aplicación que ha creado en Bluemix. Este valor distingue entre mayúsculas y minúsculas. - -**bluemixRegionSuffix** - -Especifica la ubicación donde se ha alojado la app. Puede utilizar uno de estos tres valores: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##Inicializar el SDK push del cliente - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` - - - -# Registro de dispositivos Android -{: #android_register} - -Utilice la API de `IMFPush.register()` para registrar el dispositivo con un Servicio de notificaciones Push. Para el registro con dispositivos Android, primero debe añadir la información de Google Cloud Messaging (GCM) en el panel de control de configuración del servicio push de Bluemix. Para obtener más información, consulte [Configuración de credenciales para Google Cloud Messaging](t_push_provider_android.html). - -Copie y pegue los siguientes fragmentos de código en la aplicación para móviles de Android. - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //maneje el éxito aquí - } - @Override - public void onFailure(MFPPushException ex) { - //maneje la anomalía aquí - } - }); -``` - -``` - //Maneja la notificación cuando llega - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Manejar la notificación push - } - }; -``` - - - -# Recepción de notificaciones push en dispositivos Android -{: #android_receive} - -Para registrar el objeto notificationListener con Push, invoque el método **MFPPush.listen()**. Este método normalmente se llama desde el método **onResume()** de la actividad que maneja las notificaciones push. - -1. Para registrar el objeto notificationListener con Push, invoque el método **listen()**. Este método normalmente se llama desde el método **onResume()** de la actividad que maneja las notificaciones push. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } - ``` -2. Cree el proyecto y ejecútelo en el dispositivo o en el emulador. Cuando se invoque el método onSuccess() para la escucha de respuestas en el método register(), confirmará que el dispositivo se ha registrado correctamente con el Servicio de notificaciones Push. En este momento puede enviar un mensaje tal como se describe en Envío de notificaciones push básicas. -3. Verifique que los dispositivos hayan recibido la notificación. Si la aplicación se encuentra en segundo plano, la notificación se manejará mediante el **MFPPushNotificationListener**. Si la aplicación se encuentra en segundo plano, se mostrará un mensaje en la barra de notificaciones. - - - - -# Envío de notificaciones push básicas - -{: #push-send-notifications} - -Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas (sin utilizar etiquetas, identificadores, cargas útiles adicionales o archivos de sonido). - - -Enviar notificaciones push básicas. - -1. En **Elegir la audiencia**, seleccione una de las siguientes audiencias: - **Todos los dispositivos**, o por plataforma: **Sólo dispositivos iOS** o - **Sólo dispositivos Android**. - - **Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos que se hayan suscrito a las notificaciones push recibirán la notificación. - - ![pantalla Notificaciones](images/tag_notification.jpg) - -2. En **Crear la notificación**, escriba el mensaje y pulse **Enviar**. -3. Verifique que los dispositivos hayan recibido la notificación. - - La captura de pantalla siguiente muestra un recuadro de alerta que maneja una notificación push -en el primer plano en un dispositivo Android e iOS. - - ![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) - - ![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) - - La captura de pantalla siguiente muestra una notificación push en segundo plano para Android. - ![Notificación push en el fondo en Android](images/background.jpg) - - - -# Pasos siguientes -{: #next_steps_tags} - -Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. - -Añada estas características de servicio de notificaciones push a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). -Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones push avanzadas](t_advance_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Instalación del SDK Push del cliente con Gradle +{: #android_install} + +En esta sección se describe cómo instalar y utilizar el SDK Push del cliente para seguir desarrollando sus aplicaciones Android. + +El SDK push de servicios móviles de Bluemix® se puede añadir mediante Gradle. Gradle descarga automáticamente artefactos desde los repositorios y los deja a disposición de su aplicación Android. Asegúrese de que ha configurado correctamente Android Studio y el SDK de Android Studio. Para obtener más información sobre cómo configurar el sistema, consulte [Visión general de Android Studio](https://developer.android.com/tools/studio/index.html). Para obtener información sobre Gradle, consulte [Configuración de compilaciones de Gradle](http://developer.android.com/tools/building/configuring-gradle.html). + +1. En Android Studio, tras crear y abrir la aplicación móvil, abra el archivo **build.gradle** de la aplicación. A continuación, añada las siguientes dependencias a la aplicación móvil. Estas sentencias de importación son necesarias para los fragmentos de código: + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + + +1. Añada las dependencias siguientes a la aplicación móvil. Las líneas siguientes añaden el SDK de cliente push de Bluemix™ Mobile Services y el SDK de Google Play Services a las dependencias de ámbito de compilación. + + ``` + dependencies { + compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' + compile 'com.google.android.gms:play-services:7.8.0' + } + ``` +1. En el archivo **AndroidManifest.xml**, añada los permisos siguientes. Para ver un manifiesto de muestra, consulte [Aplicación de ejemplo helloPush de Android](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml). Para ver un archivo Gradle de muestra, consulte [Archivo Gradle de compilación de muestra](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle). + + ``` + + + + + + + + + ``` + + Puede leer más información sobre los [permisos de Android](http://developer.android.com/guide/topics/security/permissions.html) aquí. + +1. Añade los valores de intención de notificación para la actividad. Este valor inicia la aplicación cuando el usuario pulsa la notificación recibida desde el área de notificación. + + ``` + + + + + ``` + **Nota**: sustituya *Your_Android_Package_Name* en la acción anterior con el nombre del paquete de aplicaciones utilizado en la aplicación. + +1. Añade el servicio de intento de Google Cloud Messaging (GCM) y los filtros de intento para las notificaciones de sucesos RECEIVE. + + ``` + service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> + + + + + + + + + + + + + + ``` + + + +# Inicialización del SDK push para aplicaciones Android +{: #android_initialize} + +Un lugar común para colocar el código de inicialización se encuentra en el método onCreate de la actividad principal en su aplicación Android. + +Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y el applicationGUID. Utilice estos valores para su ruta y GUID de la app. Modifique el fragmento de código para que utilice los parámetros appRoute y appGUID de la aplicación Bluemix. + + +## Inicializar el SDK principal + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +Especifica la ruta que se asigna a la aplicación de servidor que ha creado en Bluemix. + +**AppGUID** + +Especifica la clave exclusiva asignada a la aplicación que ha creado en Bluemix. Este valor distingue entre mayúsculas y minúsculas. + +**bluemixRegionSuffix** + +Especifica la ubicación donde se ha alojado la app. Puede utilizar uno de estos tres valores: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +## Inicializar el SDK push del cliente + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` + + + +# Registro de dispositivos Android +{: #android_register} + +Utilice la API de `IMFPush.register()` para registrar el dispositivo con un Servicio de notificaciones Push. Para el registro con dispositivos Android, primero debe añadir la información de Google Cloud Messaging (GCM) en el panel de control de configuración del servicio push de Bluemix. Para obtener más información, consulte [Configuración de credenciales para Google Cloud Messaging](t_push_provider_android.html). + +Copie y pegue los siguientes fragmentos de código en la aplicación para móviles de Android. + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //maneje el éxito aquí + } + @Override + public void onFailure(MFPPushException ex) { + //maneje la anomalía aquí + } + }); +``` + +``` + //Maneja la notificación cuando llega + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Manejar la notificación push + } + }; +``` + + + +# Recepción de notificaciones push en dispositivos Android +{: #android_receive} + +Para registrar el objeto notificationListener con Push, invoque el método **MFPPush.listen()**. Este método normalmente se llama desde el método **onResume()** de la actividad que maneja las notificaciones push. + +1. Para registrar el objeto notificationListener con Push, invoque el método **listen()**. Este método normalmente se llama desde el método **onResume()** de la actividad que maneja las notificaciones push. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } + ``` +2. Cree el proyecto y ejecútelo en el dispositivo o en el emulador. Cuando se invoque el método onSuccess() para la escucha de respuestas en el método register(), confirmará que el dispositivo se ha registrado correctamente con el Servicio de notificaciones Push. En este momento puede enviar un mensaje tal como se describe en Envío de notificaciones push básicas. +3. Verifique que los dispositivos hayan recibido la notificación. Si la aplicación se encuentra en segundo plano, la notificación se manejará mediante el **MFPPushNotificationListener**. Si la aplicación se encuentra en segundo plano, se mostrará un mensaje en la barra de notificaciones. + + + + +# Envío de notificaciones push básicas + +{: #push-send-notifications} + +Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas (sin utilizar etiquetas, identificadores, cargas útiles adicionales o archivos de sonido). + + +Enviar notificaciones push básicas. + +1. En **Elegir la audiencia**, seleccione una de las siguientes audiencias: + **Todos los dispositivos**, o por plataforma: **Sólo dispositivos iOS** o + **Sólo dispositivos Android**. + + **Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos que se hayan suscrito a las notificaciones push recibirán la notificación. + + ![pantalla Notificaciones](images/tag_notification.jpg) + +2. En **Crear la notificación**, escriba el mensaje y pulse **Enviar**. +3. Verifique que los dispositivos hayan recibido la notificación. + + La captura de pantalla siguiente muestra un recuadro de alerta que maneja una notificación push +en el primer plano en un dispositivo Android e iOS. + + ![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) + + ![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) + + La captura de pantalla siguiente muestra una notificación push en segundo plano para Android. + ![Notificación push en el fondo en Android](images/background.jpg) + + + +# Pasos siguientes +{: #next_steps_tags} + +Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. + +Añada estas características de servicio de notificaciones push a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). +Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones push avanzadas](t_advance_notifications.html). diff --git a/services/mobilepush/nl/es/t_android_receive.md b/services/mobilepush/nl/es/t_android_receive.md index 7e501939b..a3be7d24e 100644 --- a/services/mobilepush/nl/es/t_android_receive.md +++ b/services/mobilepush/nl/es/t_android_receive.md @@ -1,25 +1,25 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Recepción de notificaciones push en dispositivos Android -{: #android_receive} - -Para registrar el objeto notificationListener con Push, invoque el método **MFPPush.listen()**. Este método normalmente se llama desde el método **onResume()** de la actividad que maneja las notificaciones push. - -1. Para registrar el objeto notificationListener con Push, invoque el método **listen()**. Este método normalmente se llama desde el método **onResume()** de la actividad que maneja las notificaciones push. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` -2. Cree el proyecto y ejecútelo en el dispositivo o en el emulador. Cuando se invoque el método onSuccess() para la escucha de respuestas en el método register(), confirmará que el dispositivo se ha registrado correctamente con el Servicio de notificaciones Push. En este momento puede enviar un mensaje tal como se describe en Envío de notificaciones push básicas. -3. Verifique que los dispositivos hayan recibido la notificación. Si la aplicación se encuentra en segundo plano, la notificación se manejará mediante el **MFPPushNotificationListener**. Si la aplicación se encuentra en segundo plano, se mostrará un mensaje en la barra de notificaciones. +--- + +copyright: + years: 2015, 2016 + +--- + +# Recepción de notificaciones push en dispositivos Android +{: #android_receive} + +Para registrar el objeto notificationListener con Push, invoque el método **MFPPush.listen()**. Este método normalmente se llama desde el método **onResume()** de la actividad que maneja las notificaciones push. + +1. Para registrar el objeto notificationListener con Push, invoque el método **listen()**. Este método normalmente se llama desde el método **onResume()** de la actividad que maneja las notificaciones push. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` +2. Cree el proyecto y ejecútelo en el dispositivo o en el emulador. Cuando se invoque el método onSuccess() para la escucha de respuestas en el método register(), confirmará que el dispositivo se ha registrado correctamente con el Servicio de notificaciones Push. En este momento puede enviar un mensaje tal como se describe en Envío de notificaciones push básicas. +3. Verifique que los dispositivos hayan recibido la notificación. Si la aplicación se encuentra en segundo plano, la notificación se manejará mediante el **MFPPushNotificationListener**. Si la aplicación se encuentra en segundo plano, se mostrará un mensaje en la barra de notificaciones. diff --git a/services/mobilepush/nl/es/t_android_register.md b/services/mobilepush/nl/es/t_android_register.md index 473aa0e80..c390fdc6b 100644 --- a/services/mobilepush/nl/es/t_android_register.md +++ b/services/mobilepush/nl/es/t_android_register.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Registro de dispositivos Android -{: #android_register} - -Utilice la API de `IMFPush.register()` para registrar el dispositivo con un Servicio de notificaciones Push. Para el registro con dispositivos Android, primero debe añadir la información de Google Cloud Messaging (GCM) en el panel de control de configuración del servicio push de Bluemix. Para obtener más información, consulte [Configuración de credenciales para Google Cloud Messaging](t_push_provider_android.html). - -Copie y pegue los siguientes fragmentos de código en la aplicación para móviles de Android. - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //maneje el éxito aquí - } - @Override - public void onFailure(MFPPushException ex) { - //maneje la anomalía aquí - } - }); -``` - -``` - //Maneja la notificación cuando llega - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Manejar la notificación push - } - }; -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Registro de dispositivos Android +{: #android_register} + +Utilice la API de `IMFPush.register()` para registrar el dispositivo con un Servicio de notificaciones Push. Para el registro con dispositivos Android, primero debe añadir la información de Google Cloud Messaging (GCM) en el panel de control de configuración del servicio push de Bluemix. Para obtener más información, consulte [Configuración de credenciales para Google Cloud Messaging](t_push_provider_android.html). + +Copie y pegue los siguientes fragmentos de código en la aplicación para móviles de Android. + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //maneje el éxito aquí + } + @Override + public void onFailure(MFPPushException ex) { + //maneje la anomalía aquí + } + }); +``` + +``` + //Maneja la notificación cuando llega + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Manejar la notificación push + } + }; +``` diff --git a/services/mobilepush/nl/es/t_cordova_initialize.md b/services/mobilepush/nl/es/t_cordova_initialize.md index 4b0542d13..eb8f8d5e3 100644 --- a/services/mobilepush/nl/es/t_cordova_initialize.md +++ b/services/mobilepush/nl/es/t_cordova_initialize.md @@ -1,33 +1,33 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} - -# Inicialización del plug-in de Cordova -{: #cordova_enable} - -Para poder utilizar el plug-in de Cordova del Servicio de notificaciones Push, debe inicializarlo -pasando la ruta de la aplicación y el GUID de aplicaciones. Tras inicializar el plug-in, puede conectarse a la aplicación del servidor que ha creado en el panel de control de Bluemix. El plug-in de Cordova es el continente para los -SDK de cliente de iOS y Android para habilitar a una aplicación de Cordova a comunicarse con los servicios de Bluemix. - -1. Inicialice el BMSClient copiando y pegando el siguiente fragmento de código en el archivo JavaScript principal (normalmente ubicado en el directorio **www/js**). - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Modifique el fragmento de código para que utilice los parámetros Ruta y appGUID de Bluemix. Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y la GUID de la app. Utilice los valores de Ruta y GUID de la app como parámetros en el fragmento de código `BMSClient.initialize`. - - - **Nota**: Si ha creado una app de Cordova utilizando la CLI de Cordova, por ejemplo, el mandato Cordova create app-name, coloque este código Javascript en el archivo **index.js**, después de que la función `app.receivedEvent` dentro de la función `onDeviceReady: function()` inicialice el cliente BMS. - - ``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` -1. Siguiente paso. [Registro de dispositivos](t_cordova_register.html). +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} + +# Inicialización del plug-in de Cordova +{: #cordova_enable} + +Para poder utilizar el plug-in de Cordova del Servicio de notificaciones Push, debe inicializarlo +pasando la ruta de la aplicación y el GUID de aplicaciones. Tras inicializar el plug-in, puede conectarse a la aplicación del servidor que ha creado en el panel de control de Bluemix. El plug-in de Cordova es el continente para los +SDK de cliente de iOS y Android para habilitar a una aplicación de Cordova a comunicarse con los servicios de Bluemix. + +1. Inicialice el BMSClient copiando y pegando el siguiente fragmento de código en el archivo JavaScript principal (normalmente ubicado en el directorio **www/js**). + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Modifique el fragmento de código para que utilice los parámetros Ruta y appGUID de Bluemix. Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y la GUID de la app. Utilice los valores de Ruta y GUID de la app como parámetros en el fragmento de código `BMSClient.initialize`. + + + **Nota**: Si ha creado una app de Cordova utilizando la CLI de Cordova, por ejemplo, el mandato Cordova create app-name, coloque este código Javascript en el archivo **index.js**, después de que la función `app.receivedEvent` dentro de la función `onDeviceReady: function()` inicialice el cliente BMS. + + ``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` +1. Siguiente paso. [Registro de dispositivos](t_cordova_register.html). diff --git a/services/mobilepush/nl/es/t_cordova_install.md b/services/mobilepush/nl/es/t_cordova_install.md index 42ead0ca6..aeaa6dfec 100644 --- a/services/mobilepush/nl/es/t_cordova_install.md +++ b/services/mobilepush/nl/es/t_cordova_install.md @@ -1,379 +1,379 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Instalación del plug-in Push de Cordova -{: #cordova_install} - -Instale y utilice el plug-in Push del cliente para seguir desarrollando sus aplicaciones Cordova. Esto también instala el plug-in Core de Cordova, que inicializa la conexión a Bluemix. - -### Antes de empezar - -1. Descargue las versiones más recientes de Android Studio SDK y Xcode. -1. Configure el emulador. Para Android Studio, utilice un emulador que dé soporte a la API de Google Play. -1. Instale la herramienta de línea de mandatos de Git. Para Windows, asegúrese de que selecciona la opción **Ejecutar Git desde la ventana del indicador de mandatos**. Para obtener información sobre cómo descargar e instalar esta herramienta, consulte [Git](https://git-scm.com/downloads). - -1. Instale la herramienta Node.js y NPM (Node Package Manager). La herramienta de línea de mandatos NPM está empaquetada con Node.js. Para obtener información sobre cómo descargar e instalar Node.js, consulte [Node.js](https://nodejs.org/en/download/). -1. Desde la línea de mandatos, instale las herramientas de línea de mandatos de Cordova mediante el mandato **npm install -g cordova**. Esto es necesario para utilizar el plug-in Push de Cordova. Para obtener información sobre cómo instalar Cordova y configurar la aplicación de Cordova, consulte [Cordova Apache](https://cordova.apache.org/#getstarted). - - **Nota**: Para ver el archivo readme del plug-in Push de Cordova, vaya a [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## Instalación del plug-in Push de Cordova -1. Vaya a la carpeta en la que desea crear la aplicación de Cordova y ejecute el mandato siguiente para crear una aplicación de Cordova. Si ya tiene una aplicación de Cordova, vaya al paso 3. - -``` -cordova create your_app_name -cd your_app_name -``` -1. Opcional: (Opcional) Edite el archivo **config.xml** y cambie el nombre de la aplicación en el elemento a uno de su elección, en lugar del nombre HelloCordova predeterminado. - - **Nota**: Asegúrese de especificar el ID de paquete correcto. Si no lo hace, se visualizarán los siguientes mensajes de error en Xcode. - * El ejecutable se ha firmado con titularidades no válidas. - * Las titularidades especificadas en el archivo Titularidades de firmado de código de la aplicación no coinciden con las especificadas en el perfil de suministro. - - Para solucionar este problema, especifique el ID de paquete correcto en Xcode o en el archivo **config.xml** de la aplicación de Cordova. - -1. Añada la API soportada mínima o la declaración de destino del despliegue al archivo config.xml para la aplicación de Cordova. El valor de minSdkVersion debe ser superior a 15. El valor targetSdkVersion siempre debe reflejar el SDK de Android más reciente disponible desde Google. - * **Android**: Con el editor, abra el archivo config.xml y actualice el elemento -`` con versiones SDK de destino y mínimas: - - ``` - - - - - - ``` - * **iOS**: Actualice el elemento con una declaración de destino de despliegue: - - ``` - - - - - ``` - -1. Desde la interfaz de línea de mandatos (CLI) de Cordova, añada las plataformas iOS, Android, o ambas utilizando los mandatos siguientes: - - ``` - cordova platform add ios@3.9.0 - cordova platform add android - ``` -1. Desde el directorio raíz de la aplicación de Cordova, especifique el mandato siguiente para instalar el plug-in Push de Cordova: **cordova plugin add ibm-mfp-push**. - - En función de las plataformas añadidas, verá algo similar a lo siguiente: - - ``` - Installing "ibm-mfp-push" for android - Installing "ibm-mfp-push" for ios - ``` -1. Desde *your-app-root-folder*, verifique que los plug-ins Core y Push de Cordova se hayan instalado correctamente; para ello, utilice el mandato **cordova plugin list**. - - En función de las plataformas añadidas, verá algo similar a lo siguiente: - - ``` - ibm-mfp-core 1.0.0 "MFPCore" - ibm-mfp-push 1.0.0 “MFPPush" - ``` -1. (Solo iOS): Configure su entorno de desarrollo de iOS. - a. Abra el archivo your-app-name.xcodeproj en el directorio *your-app-name***/platforms/ios** con Xcode. - - b. Añada la cabecera de puente. Vaya a **Crear configuración > Compilador de Swift - Generación de códigos > Cabecera puente de Objective-C** y añada la vía de acceso siguiente: *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - c. Añada el parámetro Frameworks. Vaya a **Crear configuración > Enlaces > Runpath Search Paths** y añada el parámetro siguiente: - ``` - @executable_path/Frameworks - ``` - d. Elimine la marca de comentario de las siguientes sentencias de importación de Push en la cabecera de enlace por puente. Vaya a *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - ``` - //#import - //#import - //#import - ``` - e. Cree y ejecute la aplicación con Xcode. -1. (Solo Android): Cree su proyecto de Android utilizando el mandato siguiente: -**cordova build android**. - - **Nota**: Antes de abrir el proyecto en Android Studio, primero debe crear la aplicación de Cordova mediante la CLI de Cordova. De lo contrario, se encontrará con errores de compilación. - - -# Inicialización del plug-in de Cordova -{: #cordova_initialize} - -Para poder utilizar el plug-in de Cordova del Servicio de notificaciones Push, debe inicializarlo -pasando la ruta de la aplicación y el GUID de aplicaciones. Tras inicializar el plug-in, puede conectarse a la aplicación del servidor que ha creado en el panel de control de Bluemix. El plug-in de Cordova es el continente para los -SDK de cliente de iOS y Android para habilitar a una aplicación de Cordova a comunicarse con los servicios de Bluemix. - -1. Inicialice el BMSClient copiando y pegando el siguiente fragmento de código en el archivo JavaScript principal (normalmente ubicado en el directorio **www/js**). - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Modifique el fragmento de código para que utilice los parámetros Ruta y appGUID de Bluemix. Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y la GUID de la app. Utilice los valores de Ruta y GUID de la app como parámetros en el fragmento de código `BMSClient.initialize`. - - **Nota**: Si ha creado una app de Cordova utilizando la CLI de Cordova, por ejemplo, el mandato Cordova create app-name, coloque este código Javascript en el archivo **index.js**, después de que la función `app.receivedEvent` dentro de la función `onDeviceReady: function()` inicialice el cliente BMS. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, -``` - -# Registro de dispositivos - -{: #cordova_register} - -Para registrar un dispositivo con el Servicio de notificaciones Push, invoque el método de registro. - -Copie y pegue el siguiente fragmento de código en la aplicación de Cordova para registrar un dispositivo. - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android no utiliza el parámetro settings. Si solo está creando una aplicación Android, pase un objeto vacío; por ejemplo: - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -Si desea personalizar la alerta, el identificador y las propiedades de sonido, añada el siguiente fragmento de código de JavaScript a la parte web de la aplicación de Cordova. - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -Puede acceder al contenido del parámetro de respuesta de éxito en Javascript utilizando JSON.parse: -**var token = JSON.parse(response).token** - - -Las claves disponibles son las siguientes: `token`, `userId` y `deviceId`. - -El siguiente fragmento de código JavaScript muestra cómo inicializar el SDK del cliente de Bluemix Mobile Services, cómo registrar un dispositivo con el servicio de notificaciones Push y cómo escuchar las notificaciones push. Coloque este código en el archivo Javascript. - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -dentro de la **onDeviceReady: function()**. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -Añada el siguiente fragmento de código Objective-C a la clase de delegado de la aplicación - -``` - // Registre la señal del dispositivo con Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Manejar el error cuando no ha podido registrar la señal del dispositivo con APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -Añada el siguiente fragmento de código de Swift a la clase de delegado de la aplicación. - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Manejar el error cuando no se pueda registrar la señal del dispositivo con APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##Pasos siguientes - -{: #cordova_register_next} - -1. Cree el proyecto y, a continuación, ejecute el proyecto utilizando los mandatos siguientes: - - * Android: **cordova build android** y, a continuación, **cordova run android** - - * iOS: **cordova build ios** y, a continuación, **cordova run ios** - - - -# Recepción de notificaciones push en dispositivos -{: #cordova_receive} - -Copie y pegue los siguientes fragmentos de código para recibir notificaciones push en dispositivos. - -##JavaScript - -Añada el siguiente fragmento de código JavaScript a la parte web de la aplicación de Cordova. - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Propiedades de notificación de Android - -En la sección siguiente se listan las propiedades de notificación de Android: - -* message - mensaje de notificación de Push -* payload - objeto JSON que contiene una carga útil de notificación - - -##Propiedades de notificación de iOS - -En la sección siguiente se listan las propiedades de notificación de iOS: - -* message - mensaje de notificación de Push -* payload - objeto de JSON que contiene una action-loc-key de carga útil de notificación - La serie se utiliza como una clave para obtener una serie localizada en la localización actual para que la utilice el título del botón derecho en lugar de “Vista". -* badge - El número que se mostrará como el identificador del icono de app. Si falta esta propiedad, el identificador no se modificará. Para eliminar el identificador, establezca el valor de esta propiedad en 0. -* sound - El nombre de un archivo de sonido del paquete de la app de la carpeta Biblioteca/Sonidos del contenedor de datos de la aplicación. - -##Objective-C - -Añada los siguientes fragmentos de código de Objective-C en la clase de delegado de la aplicación. - -``` -// Maneje la recepción de una notificación remota --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -Añada los siguientes fragmentos de código de Swift a la clase de delegado de la aplicación. - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Maneje la recepción de una notificación remota al iniciar -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` - - - -# Envío de notificaciones push básicas -{: #push-send-notifications} - -Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas (sin utilizar etiquetas, identificadores, cargas útiles adicionales o archivos de sonido). - - -Enviar notificaciones push básicas. - -1. En **Elegir la audiencia**, seleccione una de las siguientes audiencias: - **Todos los dispositivos**, o por plataforma: **Sólo dispositivos iOS** o - **Sólo dispositivos Android**. - - **Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos que se hayan suscrito a las notificaciones push recibirán la notificación. - - ![pantalla Notificaciones](images/tag_notification.jpg) - -2. En **Crear la notificación**, escriba el mensaje y pulse **Enviar**. -3. Verifique que los dispositivos hayan recibido la notificación. - - La captura de pantalla siguiente muestra un recuadro de alerta que maneja una notificación push -en el primer plano en un dispositivo Android e iOS. - - ![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) - - ![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) - - La captura de pantalla siguiente muestra una notificación push en segundo plano para Android. - ![Notificación push en el fondo en Android](images/background.jpg) - - - -# Pasos siguientes -{: #next_steps_tags} - -Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. - -Añada estas características de servicio de notificaciones push a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). -Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones push avanzadas](t_advance_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Instalación del plug-in Push de Cordova +{: #cordova_install} + +Instale y utilice el plug-in Push del cliente para seguir desarrollando sus aplicaciones Cordova. Esto también instala el plug-in Core de Cordova, que inicializa la conexión a Bluemix. + +### Antes de empezar + +1. Descargue las versiones más recientes de Android Studio SDK y Xcode. +1. Configure el emulador. Para Android Studio, utilice un emulador que dé soporte a la API de Google Play. +1. Instale la herramienta de línea de mandatos de Git. Para Windows, asegúrese de que selecciona la opción **Ejecutar Git desde la ventana del indicador de mandatos**. Para obtener información sobre cómo descargar e instalar esta herramienta, consulte [Git](https://git-scm.com/downloads). + +1. Instale la herramienta Node.js y NPM (Node Package Manager). La herramienta de línea de mandatos NPM está empaquetada con Node.js. Para obtener información sobre cómo descargar e instalar Node.js, consulte [Node.js](https://nodejs.org/en/download/). +1. Desde la línea de mandatos, instale las herramientas de línea de mandatos de Cordova mediante el mandato **npm install -g cordova**. Esto es necesario para utilizar el plug-in Push de Cordova. Para obtener información sobre cómo instalar Cordova y configurar la aplicación de Cordova, consulte [Cordova Apache](https://cordova.apache.org/#getstarted). + + **Nota**: Para ver el archivo readme del plug-in Push de Cordova, vaya a [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## Instalación del plug-in Push de Cordova +1. Vaya a la carpeta en la que desea crear la aplicación de Cordova y ejecute el mandato siguiente para crear una aplicación de Cordova. Si ya tiene una aplicación de Cordova, vaya al paso 3. + +``` +cordova create your_app_name +cd your_app_name +``` +1. Opcional: (Opcional) Edite el archivo **config.xml** y cambie el nombre de la aplicación en el elemento a uno de su elección, en lugar del nombre HelloCordova predeterminado. + + **Nota**: Asegúrese de especificar el ID de paquete correcto. Si no lo hace, se visualizarán los siguientes mensajes de error en Xcode. + * El ejecutable se ha firmado con titularidades no válidas. + * Las titularidades especificadas en el archivo Titularidades de firmado de código de la aplicación no coinciden con las especificadas en el perfil de suministro. + + Para solucionar este problema, especifique el ID de paquete correcto en Xcode o en el archivo **config.xml** de la aplicación de Cordova. + +1. Añada la API soportada mínima o la declaración de destino del despliegue al archivo config.xml para la aplicación de Cordova. El valor de minSdkVersion debe ser superior a 15. El valor targetSdkVersion siempre debe reflejar el SDK de Android más reciente disponible desde Google. + * **Android**: Con el editor, abra el archivo config.xml y actualice el elemento +`` con versiones SDK de destino y mínimas: + + ``` + + + + + + ``` + * **iOS**: Actualice el elemento con una declaración de destino de despliegue: + + ``` + + + + + ``` + +1. Desde la interfaz de línea de mandatos (CLI) de Cordova, añada las plataformas iOS, Android, o ambas utilizando los mandatos siguientes: + + ``` + cordova platform add ios@3.9.0 + cordova platform add android + ``` +1. Desde el directorio raíz de la aplicación de Cordova, especifique el mandato siguiente para instalar el plug-in Push de Cordova: **cordova plugin add ibm-mfp-push**. + + En función de las plataformas añadidas, verá algo similar a lo siguiente: + + ``` + Installing "ibm-mfp-push" for android + Installing "ibm-mfp-push" for ios + ``` +1. Desde *your-app-root-folder*, verifique que los plug-ins Core y Push de Cordova se hayan instalado correctamente; para ello, utilice el mandato **cordova plugin list**. + + En función de las plataformas añadidas, verá algo similar a lo siguiente: + + ``` + ibm-mfp-core 1.0.0 "MFPCore" + ibm-mfp-push 1.0.0 “MFPPush" + ``` +1. (Solo iOS): Configure su entorno de desarrollo de iOS. + a. Abra el archivo your-app-name.xcodeproj en el directorio *your-app-name***/platforms/ios** con Xcode. + + b. Añada la cabecera de puente. Vaya a **Crear configuración > Compilador de Swift - Generación de códigos > Cabecera puente de Objective-C** y añada la vía de acceso siguiente: *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + c. Añada el parámetro Frameworks. Vaya a **Crear configuración > Enlaces > Runpath Search Paths** y añada el parámetro siguiente: + ``` + @executable_path/Frameworks + ``` + d. Elimine la marca de comentario de las siguientes sentencias de importación de Push en la cabecera de enlace por puente. Vaya a *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + ``` + //#import + //#import + //#import + ``` + e. Cree y ejecute la aplicación con Xcode. +1. (Solo Android): Cree su proyecto de Android utilizando el mandato siguiente: +**cordova build android**. + + **Nota**: Antes de abrir el proyecto en Android Studio, primero debe crear la aplicación de Cordova mediante la CLI de Cordova. De lo contrario, se encontrará con errores de compilación. + + +# Inicialización del plug-in de Cordova +{: #cordova_initialize} + +Para poder utilizar el plug-in de Cordova del Servicio de notificaciones Push, debe inicializarlo +pasando la ruta de la aplicación y el GUID de aplicaciones. Tras inicializar el plug-in, puede conectarse a la aplicación del servidor que ha creado en el panel de control de Bluemix. El plug-in de Cordova es el continente para los +SDK de cliente de iOS y Android para habilitar a una aplicación de Cordova a comunicarse con los servicios de Bluemix. + +1. Inicialice el BMSClient copiando y pegando el siguiente fragmento de código en el archivo JavaScript principal (normalmente ubicado en el directorio **www/js**). + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Modifique el fragmento de código para que utilice los parámetros Ruta y appGUID de Bluemix. Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y la GUID de la app. Utilice los valores de Ruta y GUID de la app como parámetros en el fragmento de código `BMSClient.initialize`. + + **Nota**: Si ha creado una app de Cordova utilizando la CLI de Cordova, por ejemplo, el mandato Cordova create app-name, coloque este código Javascript en el archivo **index.js**, después de que la función `app.receivedEvent` dentro de la función `onDeviceReady: function()` inicialice el cliente BMS. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, +``` + +# Registro de dispositivos + +{: #cordova_register} + +Para registrar un dispositivo con el Servicio de notificaciones Push, invoque el método de registro. + +Copie y pegue el siguiente fragmento de código en la aplicación de Cordova para registrar un dispositivo. + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android no utiliza el parámetro settings. Si solo está creando una aplicación Android, pase un objeto vacío; por ejemplo: + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +Si desea personalizar la alerta, el identificador y las propiedades de sonido, añada el siguiente fragmento de código de JavaScript a la parte web de la aplicación de Cordova. + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +Puede acceder al contenido del parámetro de respuesta de éxito en Javascript utilizando JSON.parse: +**var token = JSON.parse(response).token** + + +Las claves disponibles son las siguientes: `token`, `userId` y `deviceId`. + +El siguiente fragmento de código JavaScript muestra cómo inicializar el SDK del cliente de Bluemix Mobile Services, cómo registrar un dispositivo con el servicio de notificaciones Push y cómo escuchar las notificaciones push. Coloque este código en el archivo Javascript. + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +dentro de la **onDeviceReady: function()**. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +Añada el siguiente fragmento de código Objective-C a la clase de delegado de la aplicación + +``` + // Registre la señal del dispositivo con Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Manejar el error cuando no ha podido registrar la señal del dispositivo con APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +Añada el siguiente fragmento de código de Swift a la clase de delegado de la aplicación. + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Manejar el error cuando no se pueda registrar la señal del dispositivo con APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## Pasos siguientes + +{: #cordova_register_next} + +1. Cree el proyecto y, a continuación, ejecute el proyecto utilizando los mandatos siguientes: + + * Android: **cordova build android** y, a continuación, **cordova run android** + + * iOS: **cordova build ios** y, a continuación, **cordova run ios** + + + +# Recepción de notificaciones push en dispositivos +{: #cordova_receive} + +Copie y pegue los siguientes fragmentos de código para recibir notificaciones push en dispositivos. + +## JavaScript + +Añada el siguiente fragmento de código JavaScript a la parte web de la aplicación de Cordova. + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +## Propiedades de notificación de Android + +En la sección siguiente se listan las propiedades de notificación de Android: + +* message - mensaje de notificación de Push +* payload - objeto JSON que contiene una carga útil de notificación + + +## Propiedades de notificación de iOS + +En la sección siguiente se listan las propiedades de notificación de iOS: + +* message - mensaje de notificación de Push +* payload - objeto de JSON que contiene una action-loc-key de carga útil de notificación - La serie se utiliza como una clave para obtener una serie localizada en la localización actual para que la utilice el título del botón derecho en lugar de “Vista". +* badge - El número que se mostrará como el identificador del icono de app. Si falta esta propiedad, el identificador no se modificará. Para eliminar el identificador, establezca el valor de esta propiedad en 0. +* sound - El nombre de un archivo de sonido del paquete de la app de la carpeta Biblioteca/Sonidos del contenedor de datos de la aplicación. + +## Objective-C + +Añada los siguientes fragmentos de código de Objective-C en la clase de delegado de la aplicación. + +``` +// Maneje la recepción de una notificación remota +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +## Swift + +Añada los siguientes fragmentos de código de Swift a la clase de delegado de la aplicación. + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Maneje la recepción de una notificación remota al iniciar +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` + + + +# Envío de notificaciones push básicas +{: #push-send-notifications} + +Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas (sin utilizar etiquetas, identificadores, cargas útiles adicionales o archivos de sonido). + + +Enviar notificaciones push básicas. + +1. En **Elegir la audiencia**, seleccione una de las siguientes audiencias: + **Todos los dispositivos**, o por plataforma: **Sólo dispositivos iOS** o + **Sólo dispositivos Android**. + + **Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos que se hayan suscrito a las notificaciones push recibirán la notificación. + + ![pantalla Notificaciones](images/tag_notification.jpg) + +2. En **Crear la notificación**, escriba el mensaje y pulse **Enviar**. +3. Verifique que los dispositivos hayan recibido la notificación. + + La captura de pantalla siguiente muestra un recuadro de alerta que maneja una notificación push +en el primer plano en un dispositivo Android e iOS. + + ![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) + + ![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) + + La captura de pantalla siguiente muestra una notificación push en segundo plano para Android. + ![Notificación push en el fondo en Android](images/background.jpg) + + + +# Pasos siguientes +{: #next_steps_tags} + +Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. + +Añada estas características de servicio de notificaciones push a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). +Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones push avanzadas](t_advance_notifications.html). diff --git a/services/mobilepush/nl/es/t_cordova_receive.md b/services/mobilepush/nl/es/t_cordova_receive.md index 083b109b6..f72fe2ffc 100644 --- a/services/mobilepush/nl/es/t_cordova_receive.md +++ b/services/mobilepush/nl/es/t_cordova_receive.md @@ -1,83 +1,83 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Recepción de notificaciones push en dispositivos -{: #cordova_receive} - -Copie y pegue los siguientes fragmentos de código para recibir notificaciones push en dispositivos. - -##JavaScript - -Añada el siguiente fragmento de código JavaScript a la parte web de la aplicación de Cordova. - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Propiedades de notificación de Android - -En la sección siguiente se listan las propiedades de notificación de Android: - -* message - mensaje de notificación de Push -* payload - objeto JSON que contiene una carga útil de notificación - - -##Propiedades de notificación de iOS - -En la sección siguiente se listan las propiedades de notificación de iOS: - -* message - mensaje de notificación de Push -* payload - objeto de JSON que contiene una action-loc-key de carga útil de notificación - La serie se utiliza como una clave para obtener una serie localizada en la localización actual para que la utilice el título del botón derecho en lugar de “Vista". -* badge - El número que se mostrará como el identificador del icono de app. Si falta esta propiedad, el identificador no se modificará. Para eliminar el identificador, establezca el valor de esta propiedad en 0. -* sound - El nombre de un archivo de sonido del paquete de la app de la carpeta Biblioteca/Sonidos del contenedor de datos de la aplicación. - -##Objective-C - -Añada los siguientes fragmentos de código de Objective-C en la clase de delegado de la aplicación. - -``` -// Maneje la recepción de una notificación remota --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -Añada los siguientes fragmentos de código de Swift a la clase de delegado de la aplicación. - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Maneje la recepción de una notificación remota al iniciar -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` -Siguiente paso. [Enviar notificaciones push básicas](t_send_push_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Recepción de notificaciones push en dispositivos +{: #cordova_receive} + +Copie y pegue los siguientes fragmentos de código para recibir notificaciones push en dispositivos. + +## JavaScript + +Añada el siguiente fragmento de código JavaScript a la parte web de la aplicación de Cordova. + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +## Propiedades de notificación de Android + +En la sección siguiente se listan las propiedades de notificación de Android: + +* message - mensaje de notificación de Push +* payload - objeto JSON que contiene una carga útil de notificación + + +## Propiedades de notificación de iOS + +En la sección siguiente se listan las propiedades de notificación de iOS: + +* message - mensaje de notificación de Push +* payload - objeto de JSON que contiene una action-loc-key de carga útil de notificación - La serie se utiliza como una clave para obtener una serie localizada en la localización actual para que la utilice el título del botón derecho en lugar de “Vista". +* badge - El número que se mostrará como el identificador del icono de app. Si falta esta propiedad, el identificador no se modificará. Para eliminar el identificador, establezca el valor de esta propiedad en 0. +* sound - El nombre de un archivo de sonido del paquete de la app de la carpeta Biblioteca/Sonidos del contenedor de datos de la aplicación. + +## Objective-C + +Añada los siguientes fragmentos de código de Objective-C en la clase de delegado de la aplicación. + +``` +// Maneje la recepción de una notificación remota +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +## Swift + +Añada los siguientes fragmentos de código de Swift a la clase de delegado de la aplicación. + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Maneje la recepción de una notificación remota al iniciar +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` +Siguiente paso. [Enviar notificaciones push básicas](t_send_push_notifications.html). diff --git a/services/mobilepush/nl/es/t_cordova_register.md b/services/mobilepush/nl/es/t_cordova_register.md index b822af626..25fccd65c 100644 --- a/services/mobilepush/nl/es/t_cordova_register.md +++ b/services/mobilepush/nl/es/t_cordova_register.md @@ -1,140 +1,140 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Registro de dispositivos - -{: #cordova_register} - -Para registrar un dispositivo con el Servicio de notificaciones Push, invoque el método de registro. - -Copie y pegue el siguiente fragmento de código en la aplicación de Cordova para registrar un dispositivo. - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android no utiliza el parámetro settings. Si solo está creando una aplicación Android, pase un objeto vacío; por ejemplo: - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -Si desea personalizar la alerta, el identificador y las propiedades de sonido, añada el siguiente fragmento de código de JavaScript a la parte web de la aplicación de Cordova. - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -Puede acceder al contenido del parámetro de respuesta de éxito en Javascript utilizando JSON.parse: -**var token = JSON.parse(response).token** - - -Las claves disponibles son las siguientes: `token`, `userId` y `deviceId`. - -El siguiente fragmento de código JavaScript muestra cómo inicializar el SDK del cliente de Bluemix Mobile Services, cómo registrar un dispositivo con el servicio de notificaciones Push y cómo escuchar las notificaciones push. Coloque este código en el archivo Javascript. - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -dentro de la **onDeviceReady: function()**. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -Añada el siguiente fragmento de código Objective-C a la clase de delegado de la aplicación - -``` - // Registre la señal del dispositivo con Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Manejar el error cuando no ha podido registrar la señal del dispositivo con APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -Añada el siguiente fragmento de código de Swift a la clase de delegado de la aplicación. - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Manejar el error cuando no se pueda registrar la señal del dispositivo con APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##Pasos siguientes -{: #cordova_register_next} - -1. Cree el proyecto y, a continuación, ejecute el proyecto utilizando los mandatos siguientes: - - * Android: **cordova build android** y, a continuación, **cordova run android** - - * iOS: **cordova build ios** y, a continuación, **cordova run ios** -1. [Recepción de notificaciones push en dispositivos](t_cordova_receive.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Registro de dispositivos + +{: #cordova_register} + +Para registrar un dispositivo con el Servicio de notificaciones Push, invoque el método de registro. + +Copie y pegue el siguiente fragmento de código en la aplicación de Cordova para registrar un dispositivo. + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android no utiliza el parámetro settings. Si solo está creando una aplicación Android, pase un objeto vacío; por ejemplo: + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +Si desea personalizar la alerta, el identificador y las propiedades de sonido, añada el siguiente fragmento de código de JavaScript a la parte web de la aplicación de Cordova. + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +Puede acceder al contenido del parámetro de respuesta de éxito en Javascript utilizando JSON.parse: +**var token = JSON.parse(response).token** + + +Las claves disponibles son las siguientes: `token`, `userId` y `deviceId`. + +El siguiente fragmento de código JavaScript muestra cómo inicializar el SDK del cliente de Bluemix Mobile Services, cómo registrar un dispositivo con el servicio de notificaciones Push y cómo escuchar las notificaciones push. Coloque este código en el archivo Javascript. + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +dentro de la **onDeviceReady: function()**. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +Añada el siguiente fragmento de código Objective-C a la clase de delegado de la aplicación + +``` + // Registre la señal del dispositivo con Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Manejar el error cuando no ha podido registrar la señal del dispositivo con APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +Añada el siguiente fragmento de código de Swift a la clase de delegado de la aplicación. + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Manejar el error cuando no se pueda registrar la señal del dispositivo con APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## Pasos siguientes +{: #cordova_register_next} + +1. Cree el proyecto y, a continuación, ejecute el proyecto utilizando los mandatos siguientes: + + * Android: **cordova build android** y, a continuación, **cordova run android** + + * iOS: **cordova build ios** y, a continuación, **cordova run ios** +1. [Recepción de notificaciones push en dispositivos](t_cordova_receive.html). diff --git a/services/mobilepush/nl/es/t_create_push_instance.md b/services/mobilepush/nl/es/t_create_push_instance.md index ccc6ef133..07effbfc1 100644 --- a/services/mobilepush/nl/es/t_create_push_instance.md +++ b/services/mobilepush/nl/es/t_create_push_instance.md @@ -1,32 +1,32 @@ -# Creación de una instancia de servicio Push -{: #create-push-instance} - -Para comenzar con {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, cree en primer lugar una aplicación {{site.data.keyword.Bluemix}}; por ejemplo, una app Node.js. A continuación, cree una instancia de un servicio Push, {{site.data.keyword.mobilepushfull}}, que debe estar enlazada a esta aplicación Bluemix. También puede hacerlo yendo a la sección de Contenedor modelo del catálogo de Bluemix y pulsando el MobileFirst Services Starter. - -**Nota**: Si ha configurado organizaciones para gestionar el entorno, seleccione la organización en la que desea crear el tiempo de ejecución y los servicios para la app de móvil. - - -1. Si no tiene una aplicación Bluemix, debe crearla; por ejemplo, la app Node.js. Para crear una aplicación Bluemix, vaya al Panel de control de Bluemix y pulse **Crear app**. - - **Nota**: Si dispone de una aplicación, vaya al paso 7 para añadir un servicio.![Crear una instancia de servicio](images/create_service_instance1.jpg "Crear una instancia de servicio") - -1. Desde **Elija su plantilla de app**, pulse **WEB** - -3. En el área **Seleccionar punto de inicio**, seleccione **SDK para Node.js** y, a continuación, pulse **CONTINUAR**.![Punto de partida](images/create_service_nodejs2.jpg) - -4. Desde el menú desplegable **Espacio**, seleccione el espacio de la organización.![Seleccione el espacio de la organización](images/create_a_service3.jpg) -1. En **Nombre**, especifique el nombre de la app y, en el host, especifique el nombre del host. - -1. Desde el menú desplegable **Plan seleccionado**, seleccione un plan y, a continuación, pulse el botón **CREATE**. Espere a que la aplicación se transfiera. - -1. Pulse el enlace **Visión general**.![Añadir un servicio](images/create_service_add4.jpg) -1. Pulse **Añadir un servicio**. Se mostrará la pantalla CATALOG. - -1. Seleccione **Notificaciones Push de IBM:** y, desde el menú desplegable **Espacio**, seleccione la organización.![Menú desplegable del espacio de la organización](images/create_service_org.jpg) -1. En el nombre **Servicio**, especifique el nombre de servicio de la Notificación Push. - -1. En el **Plan seleccionado**, seleccione un plan y pulse el botón **CREATE**. - -1. Pulse **Sí** para volver a transferir la aplicación.![Servicio de notificaciones Push de IBM](images/create_service_notification5.jpg) - -1. Pulse **Notificaciones Push** para mostrar el panel de control Notificaciones Push. +# Creación de una instancia de servicio Push +{: #create-push-instance} + +Para comenzar con {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, cree en primer lugar una aplicación {{site.data.keyword.Bluemix}}; por ejemplo, una app Node.js. A continuación, cree una instancia de un servicio Push, {{site.data.keyword.mobilepushfull}}, que debe estar enlazada a esta aplicación Bluemix. También puede hacerlo yendo a la sección de Contenedor modelo del catálogo de Bluemix y pulsando el MobileFirst Services Starter. + +**Nota**: Si ha configurado organizaciones para gestionar el entorno, seleccione la organización en la que desea crear el tiempo de ejecución y los servicios para la app de móvil. + + +1. Si no tiene una aplicación Bluemix, debe crearla; por ejemplo, la app Node.js. Para crear una aplicación Bluemix, vaya al Panel de control de Bluemix y pulse **Crear app**. + + **Nota**: Si dispone de una aplicación, vaya al paso 7 para añadir un servicio.![Crear una instancia de servicio](images/create_service_instance1.jpg "Crear una instancia de servicio") + +1. Desde **Elija su plantilla de app**, pulse **WEB** + +3. En el área **Seleccionar punto de inicio**, seleccione **SDK para Node.js** y, a continuación, pulse **CONTINUAR**.![Punto de partida](images/create_service_nodejs2.jpg) + +4. Desde el menú desplegable **Espacio**, seleccione el espacio de la organización.![Seleccione el espacio de la organización](images/create_a_service3.jpg) +1. En **Nombre**, especifique el nombre de la app y, en el host, especifique el nombre del host. + +1. Desde el menú desplegable **Plan seleccionado**, seleccione un plan y, a continuación, pulse el botón **CREATE**. Espere a que la aplicación se transfiera. + +1. Pulse el enlace **Visión general**.![Añadir un servicio](images/create_service_add4.jpg) +1. Pulse **Añadir un servicio**. Se mostrará la pantalla CATALOG. + +1. Seleccione **Notificaciones Push de IBM:** y, desde el menú desplegable **Espacio**, seleccione la organización.![Menú desplegable del espacio de la organización](images/create_service_org.jpg) +1. En el nombre **Servicio**, especifique el nombre de servicio de la Notificación Push. + +1. En el **Plan seleccionado**, seleccione un plan y pulse el botón **CREATE**. + +1. Pulse **Sí** para volver a transferir la aplicación.![Servicio de notificaciones Push de IBM](images/create_service_notification5.jpg) + +1. Pulse **Notificaciones Push** para mostrar el panel de control Notificaciones Push. diff --git a/services/mobilepush/nl/es/t_enable-ios-notifications-receive.md b/services/mobilepush/nl/es/t_enable-ios-notifications-receive.md index 436557342..ddadee3a5 100644 --- a/services/mobilepush/nl/es/t_enable-ios-notifications-receive.md +++ b/services/mobilepush/nl/es/t_enable-ios-notifications-receive.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Recepción de notificaciones push en dispositivos iOS -{: #enable-push-ios-notifications-receiving} - -Recibir notificaciones push en dispositivos iOS. - -##Objective-C -Para recibir notificaciones push en dispositivos iOS, añada el método Objective-C siguiente en la aplicación delegada de la aplicación. - -``` -// Para Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//El diccionario userInfo contendrá datos que ha enviado el servidor. -} -``` - -##Swift -Para recibir notificaciones push en dispositivos iOS, añada el método Swift siguiente a la aplicación delegada de la aplicación. - -``` - // Para Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //El diccionario UserInfo contendrá datos que ha enviado el servidor - } -``` - +--- + +copyright: + years: 2015, 2016 + +--- + +# Recepción de notificaciones push en dispositivos iOS +{: #enable-push-ios-notifications-receiving} + +Recibir notificaciones push en dispositivos iOS. + +##Objective-C +Para recibir notificaciones push en dispositivos iOS, añada el método Objective-C siguiente en la aplicación delegada de la aplicación. + +``` +// Para Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//El diccionario userInfo contendrá datos que ha enviado el servidor. +} +``` + +##Swift +Para recibir notificaciones push en dispositivos iOS, añada el método Swift siguiente a la aplicación delegada de la aplicación. + +``` + // Para Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //El diccionario UserInfo contendrá datos que ha enviado el servidor + } +``` + diff --git a/services/mobilepush/nl/es/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/es/t_enable_actionable_notifications_ios.md index 85b75c92c..225b37b2c 100644 --- a/services/mobilepush/nl/es/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/es/t_enable_actionable_notifications_ios.md @@ -1,103 +1,103 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Habilitación de notificaciones accionables para iOS -{: #enable-actionable-notifications-ios} - -A diferencia de las notificaciones push tradicionales, estas solicitan a los usuarios que realicen una selección al recibir la alerta de notificación sin abrir la app. Siga las instrucciones siguientes para habilitar notificaciones push en la aplicación. - -1. Cree una acción de respuesta del usuario. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. Cree la categoría de notificaciones y configure una acción. **UIUserNotificationActionContextDefault** o **UIUserNotificationActionContextMinimal** son contextos válidos. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. Cree el valor de notificación y asigne las categorías desde el paso anterior. - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. Cree una notificación remota o local y asígnele la identidad de la categoría. - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Habilitación de notificaciones accionables para iOS +{: #enable-actionable-notifications-ios} + +A diferencia de las notificaciones push tradicionales, estas solicitan a los usuarios que realicen una selección al recibir la alerta de notificación sin abrir la app. Siga las instrucciones siguientes para habilitar notificaciones push en la aplicación. + +1. Cree una acción de respuesta del usuario. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. Cree la categoría de notificaciones y configure una acción. **UIUserNotificationActionContextDefault** o **UIUserNotificationActionContextMinimal** son contextos válidos. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. Cree el valor de notificación y asigne las categorías desde el paso anterior. + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. Cree una notificación remota o local y asígnele la identidad de la categoría. + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/es/t_enable_ios_notifications_initialize.md b/services/mobilepush/nl/es/t_enable_ios_notifications_initialize.md index cb76962ed..191095cea 100644 --- a/services/mobilepush/nl/es/t_enable_ios_notifications_initialize.md +++ b/services/mobilepush/nl/es/t_enable_ios_notifications_initialize.md @@ -1,66 +1,66 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Inicialización de SDK Push para aplicaciones iOS -{: #enable-push-ios-notifications-initialize} - -Un lugar común para colocar el código de inicialización se encuentra en el delegado de aplicación para la aplicación iOS. -Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y el GUID. - -##Inicialización del SDK principal - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - -##Inicialización del SDK Push del cliente - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## Ruta, GUID, y región Bluemix - -**appRoute** - -Especifica la ruta que se asigna a la aplicación de servidor que ha creado en Bluemix. - -**GUID** - -Especifica la clave exclusiva asignada a la aplicación que ha creado en Bluemix. Este valor distingue entre mayúsculas y minúsculas. - -**bluemixRegionSuffix** - -Especifica la ubicación en la que se aloja la aplicación. El parámetro `bluemixRegion` especifica qué despliegue de Bluemix está utilizando. Puede establecer este valor con una propiedad estática `BMSClient.REGION` y utilizar uno de estos tres valores: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY +--- + +copyright: + years: 2015, 2016 + +--- + +# Inicialización de SDK Push para aplicaciones iOS +{: #enable-push-ios-notifications-initialize} + +Un lugar común para colocar el código de inicialización se encuentra en el delegado de aplicación para la aplicación iOS. +Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y el GUID. + +##Inicialización del SDK principal + +###Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +###Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + +##Inicialización del SDK Push del cliente + +###Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +###Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## Ruta, GUID, y región Bluemix + +**appRoute** + +Especifica la ruta que se asigna a la aplicación de servidor que ha creado en Bluemix. + +**GUID** + +Especifica la clave exclusiva asignada a la aplicación que ha creado en Bluemix. Este valor distingue entre mayúsculas y minúsculas. + +**bluemixRegionSuffix** + +Especifica la ubicación en la que se aloja la aplicación. El parámetro `bluemixRegion` especifica qué despliegue de Bluemix está utilizando. Puede establecer este valor con una propiedad estática `BMSClient.REGION` y utilizar uno de estos tres valores: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY diff --git a/services/mobilepush/nl/es/t_enable_ios_notifications_install.md b/services/mobilepush/nl/es/t_enable_ios_notifications_install.md index 7b6b942fe..243743885 100644 --- a/services/mobilepush/nl/es/t_enable_ios_notifications_install.md +++ b/services/mobilepush/nl/es/t_enable_ios_notifications_install.md @@ -1,324 +1,324 @@ -# Inicialización de SDK Push para aplicaciones iOS -{: #enable-push-ios-notifications-install} - -Para un proyecto Xcode existente, puede configurar el SDK del cliente de Bluemix Mobile Services mediante la herramienta de gestión de dependencias de CocoaPods. Una alternativa es instalar el SDK manualmente. - -**Nota**: Para ver el archivo readme Push de Swift, vaya a https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master - -##Instalación de CocoaPods - -1. Instale CocoaPods utilizando el siguiente mandato en su terminal Mac. -``` -$ sudo gem install cocoapods -``` -2. Especifique el mandato siguiente en el terminal para inicializar CocoaPods. Cuando emita este mandato, asegúrese de ejecutarlo en el directorio en el que se encuentra el proyecto de Xcode. El mandato `pod init` creará un título de archivo. -``` -$ pod init -``` -3. En el Podfile generado, añada las dependencias de SDK que necesita. Copie el siguiente Podfile. - - Objective-C - - ``` - source 'https://github.com/CocoaPods/Specs.git' - Copy the following list as is and remove the dependencies you do not need - pod 'IMFCore' - pod 'IMFPush' - ``` - - Swift - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - end - ``` -3. Desde el terminal, vaya a la carpeta del proyecto e instale las dependencias con el mandato siguiente: -``` -$ pod update -``` -Este mandato instala las dependencias y crea un nuevo espacio de trabajo Xcode. **Nota**: Asegúrese de abrir siempre el nuevo espacio de trabajo de Xcode, en lugar del archivo de proyecto Xcode original: - - ``` - $ open App.xcworkspace - ``` -El espacio de trabajo contiene el proyecto original y el proyecto Pods que contiene las dependencias. Si desea modificar una carpeta fuente de Bluemix Mobile Services, puede encontrarla en el proyecto Pods, en `Pods/yourImportedSourceFolder`, por ejemplo: `Pods/IMFGoogleAuthentication`. - -##Utilización de infraestructuras importadas y carpetas fuente - -Haga referencia al SDK del código. - - -### Objective-C - -Escriba directivas #import para las cabeceras relevantes, por -ejemplo: - -``` -//Objective-C -#import -#import -``` - -**Nota**: La actualización del proyecto Pods utilizando los mandatos CocoaPods `pod install` o `pod update` puede alterar temporalmente las carpetas fuente de Bluemix Mobile Services. Si desea conservar las versiones personalizadas -de los archivos originales, asegúrese de que se les ha hecho la copia de seguridad antes de emitir uno de estos -mandatos. - -###Swift - -**Requisitos previos** - -- iOS 8.0 o superior -- Xcode 7 - - -Escriba directivas #import para las cabeceras relevantes, por -ejemplo: - -``` -//swift -import BMSCore -import BMSPush -``` - - -##Crear configuración - -Vaya a **Xcode > Crear configuración > Opciones de creación y Establecer la habilitación de Bitcode** en **No**. - -**Atención**: A partir de iOS 9, los cambios a la característica de App Transport Security (ATS) pueden afectar a la forma de manejar el proceso de autenticación. Las siguientes publicaciones de blog describen más información sobre los cambios:[ATS y Bitcode en iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) y [Conecte la app de iOS 9 a Bluemix ahora mismo](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) - - - - -# Inicialización de SDK Push para aplicaciones iOS -{: #enable-push-ios-notifications-initialize} - -Un lugar común para colocar el código de inicialización se encuentra en el delegado de aplicación para la aplicación iOS. -Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y el GUID. - -##Inicialización del SDK principal - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - - -##Inicialización del SDK Push del cliente - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## Ruta, GUID, y región Bluemix - -**appRoute** - -Especifica la ruta que se asigna a la aplicación de servidor que ha creado en Bluemix. - -**GUID** - -Especifica la clave exclusiva asignada a la aplicación que ha creado en Bluemix. Este valor distingue entre mayúsculas y minúsculas. - -**bluemixRegionSuffix** - -Especifica la ubicación en la que se aloja la aplicación. El parámetro `bluemixRegion` especifica qué despliegue de Bluemix está utilizando. Puede establecer este valor con una propiedad estática `BMSClient.REGION` y utilizar uno de estos tres valores: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - - - - -# Registro de dispositivos y aplicaciones iOS -{: #enable-push-ios-notifications-register} - - -Debe registrar una aplicación (app) con APNs para recibir notificaciones remotas, que normalmente se producen después de instalar la app en un dispositivo. Después de que la app reciba la señal de dispositivo que ha generado APNs, debe volver a pasarse al Servicio de notificaciones Push. - -Para registrar las aplicaciones y los dispositivos de iOS: - -1. Cree una aplicación de fondo -2. Pase la señal a las Notificaciones Push - - -##Cree una aplicación de fondo - -Cree una aplicación de fondo en el catálogo Bluemix® de la sección de Contenedores modelo, que enlaza automáticamente el servicio Push a esta aplicación. Si ya ha creado una app de fondo, asegúrese de que enlace la app al Servicio de notificaciones Push. - -###Objective-C - -``` - //Para Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##Pase la señal a las Notificaciones Push - -Después de recibir la señal desde APNs, pase la señal a Notificaciones Push como parte del método `registerDevice:withDeviceToken`. - -###Objective-C - -``` -//Para Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -Después de recibir la señal desde APNS, pase la señal a Notificaciones Push como parte del método `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` - - - -# Recepción de notificaciones push en dispositivos iOS -{: #enable-push-ios-notifications-receiving} - -Recibir notificaciones push en dispositivos iOS. - -##Objective-C -Para recibir notificaciones push en dispositivos iOS, añada el método Objective-C siguiente en la aplicación delegada de la aplicación. - -``` -// Para Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//El diccionario userInfo contendrá datos que ha enviado el servidor. -} -``` - -##Swift -Para recibir notificaciones push en dispositivos iOS, añada el método Swift siguiente a la aplicación delegada de la aplicación. - -``` - // Para Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //El diccionario UserInfo contendrá datos que ha enviado el servidor - } - -``` - - - -# Envío de notificaciones push básicas -{: #push-send-notifications} - -Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas (sin utilizar etiquetas, identificadores, cargas útiles adicionales o archivos de sonido). - - -Enviar notificaciones push básicas. - -1. En **Elegir la audiencia**, seleccione una de las siguientes audiencias: - **Todos los dispositivos**, o por plataforma: **Sólo dispositivos iOS** o - **Sólo dispositivos Android**. - - **Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos que se hayan suscrito a las notificaciones push recibirán la notificación. - - ![pantalla Notificaciones](images/tag_notification.jpg) - -2. En **Crear la notificación**, escriba el mensaje y pulse **Enviar**. -3. Verifique que los dispositivos hayan recibido la notificación. - - La captura de pantalla siguiente muestra un recuadro de alerta que maneja una notificación push -en el primer plano en un dispositivo Android e iOS. - - ![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) - - ![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) - - La captura de pantalla siguiente muestra una notificación push en segundo plano para Android. - ![Notificación push en el fondo en Android](images/background.jpg) - - - - -# Pasos siguientes -{: #next_steps_tags} - -Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. - -Añada estas características de servicio de notificaciones push a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). -Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones push avanzadas](t_advance_notifications.html). +# Inicialización de SDK Push para aplicaciones iOS +{: #enable-push-ios-notifications-install} + +Para un proyecto Xcode existente, puede configurar el SDK del cliente de Bluemix Mobile Services mediante la herramienta de gestión de dependencias de CocoaPods. Una alternativa es instalar el SDK manualmente. + +**Nota**: Para ver el archivo readme Push de Swift, vaya a https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master + +##Instalación de CocoaPods + +1. Instale CocoaPods utilizando el siguiente mandato en su terminal Mac. +``` +$ sudo gem install cocoapods +``` +2. Especifique el mandato siguiente en el terminal para inicializar CocoaPods. Cuando emita este mandato, asegúrese de ejecutarlo en el directorio en el que se encuentra el proyecto de Xcode. El mandato `pod init` creará un título de archivo. +``` +$ pod init +``` +3. En el Podfile generado, añada las dependencias de SDK que necesita. Copie el siguiente Podfile. + + Objective-C + + ``` + source 'https://github.com/CocoaPods/Specs.git' + Copy the following list as is and remove the dependencies you do not need + pod 'IMFCore' + pod 'IMFPush' + ``` + + Swift + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + end + ``` +3. Desde el terminal, vaya a la carpeta del proyecto e instale las dependencias con el mandato siguiente: +``` +$ pod update +``` +Este mandato instala las dependencias y crea un nuevo espacio de trabajo Xcode. **Nota**: Asegúrese de abrir siempre el nuevo espacio de trabajo de Xcode, en lugar del archivo de proyecto Xcode original: + + ``` + $ open App.xcworkspace + ``` +El espacio de trabajo contiene el proyecto original y el proyecto Pods que contiene las dependencias. Si desea modificar una carpeta fuente de Bluemix Mobile Services, puede encontrarla en el proyecto Pods, en `Pods/yourImportedSourceFolder`, por ejemplo: `Pods/IMFGoogleAuthentication`. + +##Utilización de infraestructuras importadas y carpetas fuente + +Haga referencia al SDK del código. + + +### Objective-C + +Escriba directivas #import para las cabeceras relevantes, por +ejemplo: + +``` +//Objective-C +# import +# import +``` + +**Nota**: La actualización del proyecto Pods utilizando los mandatos CocoaPods `pod install` o `pod update` puede alterar temporalmente las carpetas fuente de Bluemix Mobile Services. Si desea conservar las versiones personalizadas +de los archivos originales, asegúrese de que se les ha hecho la copia de seguridad antes de emitir uno de estos +mandatos. + +###Swift + +**Requisitos previos** + +- iOS 8.0 o superior +- Xcode 7 + + +Escriba directivas #import para las cabeceras relevantes, por +ejemplo: + +``` +//swift +import BMSCore +import BMSPush +``` + + +##Crear configuración + +Vaya a **Xcode > Crear configuración > Opciones de creación y Establecer la habilitación de Bitcode** en **No**. + +**Atención**: A partir de iOS 9, los cambios a la característica de App Transport Security (ATS) pueden afectar a la forma de manejar el proceso de autenticación. Las siguientes publicaciones de blog describen más información sobre los cambios:[ATS y Bitcode en iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) y [Conecte la app de iOS 9 a Bluemix ahora mismo](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) + + + + +# Inicialización de SDK Push para aplicaciones iOS +{: #enable-push-ios-notifications-initialize} + +Un lugar común para colocar el código de inicialización se encuentra en el delegado de aplicación para la aplicación iOS. +Pulse el enlace **Opciones móviles** en el Panel de control de aplicaciones de Bluemix para obtener la ruta de la aplicación y el GUID. + +##Inicialización del SDK principal + +###Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +###Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + + +##Inicialización del SDK Push del cliente + +###Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +###Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## Ruta, GUID, y región Bluemix + +**appRoute** + +Especifica la ruta que se asigna a la aplicación de servidor que ha creado en Bluemix. + +**GUID** + +Especifica la clave exclusiva asignada a la aplicación que ha creado en Bluemix. Este valor distingue entre mayúsculas y minúsculas. + +**bluemixRegionSuffix** + +Especifica la ubicación en la que se aloja la aplicación. El parámetro `bluemixRegion` especifica qué despliegue de Bluemix está utilizando. Puede establecer este valor con una propiedad estática `BMSClient.REGION` y utilizar uno de estos tres valores: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + + + + +# Registro de dispositivos y aplicaciones iOS +{: #enable-push-ios-notifications-register} + + +Debe registrar una aplicación (app) con APNs para recibir notificaciones remotas, que normalmente se producen después de instalar la app en un dispositivo. Después de que la app reciba la señal de dispositivo que ha generado APNs, debe volver a pasarse al Servicio de notificaciones Push. + +Para registrar las aplicaciones y los dispositivos de iOS: + +1. Cree una aplicación de fondo +2. Pase la señal a las Notificaciones Push + + +##Cree una aplicación de fondo + +Cree una aplicación de fondo en el catálogo Bluemix® de la sección de Contenedores modelo, que enlaza automáticamente el servicio Push a esta aplicación. Si ya ha creado una app de fondo, asegúrese de que enlace la app al Servicio de notificaciones Push. + +###Objective-C + +``` + //Para Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +###Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +##Pase la señal a las Notificaciones Push + +Después de recibir la señal desde APNs, pase la señal a Notificaciones Push como parte del método `registerDevice:withDeviceToken`. + +###Objective-C + +``` +//Para Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +###Swift + +Después de recibir la señal desde APNS, pase la señal a Notificaciones Push como parte del método `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` + + + +# Recepción de notificaciones push en dispositivos iOS +{: #enable-push-ios-notifications-receiving} + +Recibir notificaciones push en dispositivos iOS. + +##Objective-C +Para recibir notificaciones push en dispositivos iOS, añada el método Objective-C siguiente en la aplicación delegada de la aplicación. + +``` +// Para Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//El diccionario userInfo contendrá datos que ha enviado el servidor. +} +``` + +##Swift +Para recibir notificaciones push en dispositivos iOS, añada el método Swift siguiente a la aplicación delegada de la aplicación. + +``` + // Para Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //El diccionario UserInfo contendrá datos que ha enviado el servidor + } + +``` + + + +# Envío de notificaciones push básicas +{: #push-send-notifications} + +Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas (sin utilizar etiquetas, identificadores, cargas útiles adicionales o archivos de sonido). + + +Enviar notificaciones push básicas. + +1. En **Elegir la audiencia**, seleccione una de las siguientes audiencias: + **Todos los dispositivos**, o por plataforma: **Sólo dispositivos iOS** o + **Sólo dispositivos Android**. + + **Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos que se hayan suscrito a las notificaciones push recibirán la notificación. + + ![pantalla Notificaciones](images/tag_notification.jpg) + +2. En **Crear la notificación**, escriba el mensaje y pulse **Enviar**. +3. Verifique que los dispositivos hayan recibido la notificación. + + La captura de pantalla siguiente muestra un recuadro de alerta que maneja una notificación push +en el primer plano en un dispositivo Android e iOS. + + ![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) + + ![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) + + La captura de pantalla siguiente muestra una notificación push en segundo plano para Android. + ![Notificación push en el fondo en Android](images/background.jpg) + + + + +# Pasos siguientes +{: #next_steps_tags} + +Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. + +Añada estas características de servicio de notificaciones push a la app. Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](c_tag_basednotifications.html). +Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones push avanzadas](t_advance_notifications.html). diff --git a/services/mobilepush/nl/es/t_enable_ios_notifications_register.md b/services/mobilepush/nl/es/t_enable_ios_notifications_register.md index b657fc791..206d387ae 100644 --- a/services/mobilepush/nl/es/t_enable_ios_notifications_register.md +++ b/services/mobilepush/nl/es/t_enable_ios_notifications_register.md @@ -1,91 +1,91 @@ -# Registro de dispositivos y aplicaciones iOS -{: #enable-push-ios-notifications-register} - - -Debe registrar una aplicación (app) con APNs para recibir notificaciones remotas, que normalmente se producen después de instalar la app en un dispositivo. Después de que la app reciba la señal de dispositivo que ha generado APNs, debe volver a pasarse al Servicio de notificaciones Push. - -Para registrar las aplicaciones y los dispositivos de iOS: - -1. Cree una aplicación de fondo -2. Pase la señal a las Notificaciones Push - - -##Cree una aplicación de fondo - -Cree una aplicación de fondo en el catálogo Bluemix® de la sección de Contenedores modelo, que enlaza automáticamente el servicio Push a esta aplicación. Si ya ha creado una app de fondo, asegúrese de que enlace la app al Servicio de notificaciones Push. - -###Objective-C - -``` - //Para Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##Pase la señal a las Notificaciones Push - -Después de recibir la señal desde APNs, pase la señal a Notificaciones Push como parte del método `registerDevice:withDeviceToken`. - -###Objective-C - -``` -//Para Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -Después de recibir la señal desde APNS, pase la señal a Notificaciones Push como parte del método `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` +# Registro de dispositivos y aplicaciones iOS +{: #enable-push-ios-notifications-register} + + +Debe registrar una aplicación (app) con APNs para recibir notificaciones remotas, que normalmente se producen después de instalar la app en un dispositivo. Después de que la app reciba la señal de dispositivo que ha generado APNs, debe volver a pasarse al Servicio de notificaciones Push. + +Para registrar las aplicaciones y los dispositivos de iOS: + +1. Cree una aplicación de fondo +2. Pase la señal a las Notificaciones Push + + +## Cree una aplicación de fondo + +Cree una aplicación de fondo en el catálogo Bluemix® de la sección de Contenedores modelo, que enlaza automáticamente el servicio Push a esta aplicación. Si ya ha creado una app de fondo, asegúrese de que enlace la app al Servicio de notificaciones Push. + +### Objective-C + +``` + //Para Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +### Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +## Pase la señal a las Notificaciones Push + +Después de recibir la señal desde APNs, pase la señal a Notificaciones Push como parte del método `registerDevice:withDeviceToken`. + +### Objective-C + +``` +//Para Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +### Swift + +Después de recibir la señal desde APNS, pase la señal a Notificaciones Push como parte del método `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` diff --git a/services/mobilepush/nl/es/t_get_tags.md b/services/mobilepush/nl/es/t_get_tags.md index 9a633f2bc..e22e8cf58 100644 --- a/services/mobilepush/nl/es/t_get_tags.md +++ b/services/mobilepush/nl/es/t_get_tags.md @@ -1,150 +1,150 @@ -# Obtención de etiquetas -{: #get_tags} - -Las etiquetas proporcionan una forma para enviar notificaciones de destino a usuarios en función de sus intereses, a diferencia de las difusiones generales que se envían a todas las aplicaciones. Puede crear y gestionar etiquetas utilizando el separador Etiqueta en el panel de control Push o utilizando las API REST. Puede utilizar fragmentos de código en las secciones siguientes para gestionar y consultar las suscripciones de etiquetas para la aplicación móvil. Puede utilizar estos fragmentos de código para obtener suscripciones, suscritas a una etiqueta, no suscritas desde una etiqueta, obtener una lista de etiquetas disponibles. Copie y pegue estos fragmentos de código en su aplicación móvil. - -## Android - -La API **getTags** devuelve la lista de etiquetas disponibles a la que el dispositivo se puede suscribir. Después de suscribir el dispositivo a una determinada etiqueta, el dispositivo podrá recibir cualquier notificación push que se haya enviado para dicha etiqueta. - -Copie los fragmentos de código siguientes en la aplicación para móviles de Android para obtener una lista de etiquetas a las que el dispositivo está suscrito y para obtener una lista de etiquetas disponibles. - -Utilice la API **getTags** siguiente para obtener una lista de etiquetas disponibles a las que el dispositivo se puede suscribir. - -``` -// Obtenga una lista de etiquetas disponibles a las que se puede suscribir el dispositivo -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - -Utilice la API **getSubscriptions** para obtener una lista de etiquetas a las que está suscrito el dispositivo. - -``` -// Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) -``` - -## Cordova - -Copie los siguientes fragmentos de código en la aplicación para móviles para obtener una lista de etiquetas a las que el dispositivo está suscrito y para obtener una lista de etiquetas disponibles a las que se puede suscribir el dispositivo. - -Recupere una matriz de etiquetas disponibles a las que suscribirse. - -``` -//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se puede suscribir MFPPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, null); - -``` - -``` -//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe. -MFPPush.getSubscriptionStatus(function(tags) { - alert(tags); -}, null); -``` - -## Objective-C - -Copie los siguientes fragmentos de código en la aplicación iOS desarrollada utilizando Objective-C para obtener una lista de etiquetas a las que el dispositivo está suscrito y para obtener una lista de etiquetas disponibles a las que se puede suscribir el dispositivo. - -Utilice la API **retrieveAvailableTags** siguiente para obtener una lista de etiquetas disponibles a las que está suscrito el dispositivo. - -``` -//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se puede suscribir -[push retrieveAvailableTagsWithCompletionHandler: -^(IMFResponse *response, NSError *error){ - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved available tags."]; - NSDictionary *availableTags = [[NSDictionary alloc]init]; - availableTags = [response tags]; -[self.appDelegateVC updateMessage:availableTags.description]; -} -}]; -``` - -Utilice la API **retrieveSubscriptions** para obtener una lista de etiquetas a las que está suscrito el dispositivo. - - -``` -// Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe. -[push retrieveSubscriptionsWithCompletionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved subscriptions."]; - NSDictionary *subscribedTags = [[NSDictionary alloc]init]; -subscribedTags = [response subscriptions]; -[self.appDelegateVC updateMessage:subscribedTags.description]; -} -}]; -``` - -## Swift - -La API **retrieveAvailableTagsWithCompletionHandler** devuelve la lista de etiquetas disponibles a la que el dispositivo se puede suscribir. Después de suscribir el dispositivo a una determinada etiqueta, el dispositivo podrá recibir cualquier notificación push que se haya enviado para dicha etiqueta. - -Invocar al servicio push para obtener suscripciones para una etiqueta. - -Copie los siguientes fragmentos de código en la aplicación para móviles Swift para obtener una lista de etiquetas disponibles a las que el dispositivo está suscrito y para obtener una lista de etiquetas disponibles a las que se puede suscribir el dispositivo. - - -``` -//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se puede suscribir -push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - - if error.isEmpty { - - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else{ - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - -``` -//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - - print( "Response during retrieving subscribed tags : \(response.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - - - +# Obtención de etiquetas +{: #get_tags} + +Las etiquetas proporcionan una forma para enviar notificaciones de destino a usuarios en función de sus intereses, a diferencia de las difusiones generales que se envían a todas las aplicaciones. Puede crear y gestionar etiquetas utilizando el separador Etiqueta en el panel de control Push o utilizando las API REST. Puede utilizar fragmentos de código en las secciones siguientes para gestionar y consultar las suscripciones de etiquetas para la aplicación móvil. Puede utilizar estos fragmentos de código para obtener suscripciones, suscritas a una etiqueta, no suscritas desde una etiqueta, obtener una lista de etiquetas disponibles. Copie y pegue estos fragmentos de código en su aplicación móvil. + +## Android + +La API **getTags** devuelve la lista de etiquetas disponibles a la que el dispositivo se puede suscribir. Después de suscribir el dispositivo a una determinada etiqueta, el dispositivo podrá recibir cualquier notificación push que se haya enviado para dicha etiqueta. + +Copie los fragmentos de código siguientes en la aplicación para móviles de Android para obtener una lista de etiquetas a las que el dispositivo está suscrito y para obtener una lista de etiquetas disponibles. + +Utilice la API **getTags** siguiente para obtener una lista de etiquetas disponibles a las que el dispositivo se puede suscribir. + +``` +// Obtenga una lista de etiquetas disponibles a las que se puede suscribir el dispositivo +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + +Utilice la API **getSubscriptions** para obtener una lista de etiquetas a las que está suscrito el dispositivo. + +``` +// Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) +``` + +## Cordova + +Copie los siguientes fragmentos de código en la aplicación para móviles para obtener una lista de etiquetas a las que el dispositivo está suscrito y para obtener una lista de etiquetas disponibles a las que se puede suscribir el dispositivo. + +Recupere una matriz de etiquetas disponibles a las que suscribirse. + +``` +//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se puede suscribir MFPPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, null); + +``` + +``` +//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe. +MFPPush.getSubscriptionStatus(function(tags) { + alert(tags); +}, null); +``` + +## Objective-C + +Copie los siguientes fragmentos de código en la aplicación iOS desarrollada utilizando Objective-C para obtener una lista de etiquetas a las que el dispositivo está suscrito y para obtener una lista de etiquetas disponibles a las que se puede suscribir el dispositivo. + +Utilice la API **retrieveAvailableTags** siguiente para obtener una lista de etiquetas disponibles a las que está suscrito el dispositivo. + +``` +//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se puede suscribir +[push retrieveAvailableTagsWithCompletionHandler: +^(IMFResponse *response, NSError *error){ + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved available tags."]; + NSDictionary *availableTags = [[NSDictionary alloc]init]; + availableTags = [response tags]; +[self.appDelegateVC updateMessage:availableTags.description]; +} +}]; +``` + +Utilice la API **retrieveSubscriptions** para obtener una lista de etiquetas a las que está suscrito el dispositivo. + + +``` +// Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe. +[push retrieveSubscriptionsWithCompletionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved subscriptions."]; + NSDictionary *subscribedTags = [[NSDictionary alloc]init]; +subscribedTags = [response subscriptions]; +[self.appDelegateVC updateMessage:subscribedTags.description]; +} +}]; +``` + +## Swift + +La API **retrieveAvailableTagsWithCompletionHandler** devuelve la lista de etiquetas disponibles a la que el dispositivo se puede suscribir. Después de suscribir el dispositivo a una determinada etiqueta, el dispositivo podrá recibir cualquier notificación push que se haya enviado para dicha etiqueta. + +Invocar al servicio push para obtener suscripciones para una etiqueta. + +Copie los siguientes fragmentos de código en la aplicación para móviles Swift para obtener una lista de etiquetas disponibles a las que el dispositivo está suscrito y para obtener una lista de etiquetas disponibles a las que se puede suscribir el dispositivo. + + +``` +//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se puede suscribir +push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + + if error.isEmpty { + + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else{ + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + +``` +//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + + print( "Response during retrieving subscribed tags : \(response.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + + + diff --git a/services/mobilepush/nl/es/t_handle_actionable_notifications_ios.md b/services/mobilepush/nl/es/t_handle_actionable_notifications_ios.md index fd2c41208..b4b45ed41 100644 --- a/services/mobilepush/nl/es/t_handle_actionable_notifications_ios.md +++ b/services/mobilepush/nl/es/t_handle_actionable_notifications_ios.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Gestión de notificaciones accionables para iOS -{: #actionable-notifications} - - -Al recibir una notificación que necesita reacciones, el control se pasa al siguiente método según el identificador seleccionado. - -###Objective-C - -``` -(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: -(UILocalNotification *)notification completionHandler:(void (^)())completionHandler -{ - NSLog(@"actionable notification received."); - //must call completion handler when finished - completionHandler(); -} -``` - -###Swift - -``` -func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { - //must call completion handler when finished - completionHandler() - } -``` - - +--- + +copyright: + years: 2015, 2016 + +--- + +# Gestión de notificaciones accionables para iOS +{: #actionable-notifications} + + +Al recibir una notificación que necesita reacciones, el control se pasa al siguiente método según el identificador seleccionado. + +### Objective-C + +``` +(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: +(UILocalNotification *)notification completionHandler:(void (^)())completionHandler +{ + NSLog(@"actionable notification received."); + //must call completion handler when finished + completionHandler(); +} +``` + +### Swift + +``` +func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { + //must call completion handler when finished + completionHandler() + } +``` + + diff --git a/services/mobilepush/nl/es/t_holding_notifications_android.md b/services/mobilepush/nl/es/t_holding_notifications_android.md index 995bfdecf..f19c0c577 100755 --- a/services/mobilepush/nl/es/t_holding_notifications_android.md +++ b/services/mobilepush/nl/es/t_holding_notifications_android.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Retención de notificaciones para Android -{: #hold-notifications-android} -Última actualización: 11 de enero de 2017 -{: .last-updated} - -Cuando su aplicación entre en segundo plano, probablemente querrá enviar por push el servicio {{site.data.keyword.mobilepushshort}} para retener notificaciones que se envían a la aplicación. Para retener las notificaciones, llame el método hold() en el método onPause() de la actividad que maneja las {{site.data.keyword.mobilepushshort}}. - -``` - @Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Retención de notificaciones para Android +{: #hold-notifications-android} +Última actualización: 11 de enero de 2017 +{: .last-updated} + +Cuando su aplicación entre en segundo plano, probablemente querrá enviar por push el servicio {{site.data.keyword.mobilepushshort}} para retener notificaciones que se envían a la aplicación. Para retener las notificaciones, llame el método hold() en el método onPause() de la actividad que maneja las {{site.data.keyword.mobilepushshort}}. + +``` + @Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/es/t_manage_tags.md b/services/mobilepush/nl/es/t_manage_tags.md index 3800d2325..e0438c15e 100755 --- a/services/mobilepush/nl/es/t_manage_tags.md +++ b/services/mobilepush/nl/es/t_manage_tags.md @@ -1,346 +1,346 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Gestión de etiquetas -{: #manage_tags} -Última actualización: 11 de enero de 2017 -{: .last-updated} - -Utilice el panel de control {{site.data.keyword.mobilepushshort}} para crear y suprimir etiquetas para la aplicación y, a continuación, iniciar las notificaciones basadas en etiquetas. La notificación basada en etiquetas se recibe en los dispositivos suscritos a las etiquetas. - - -## Creación de etiquetas -{: #create_tags} - -Las notificaciones basadas en etiquetas son mensajes que están pensados para todos los dispositivos suscritos a una etiqueta determinada. Cada dispositivo se puede suscribir a cualquier número de etiquetas. Cuando se suprime una etiqueta, también se suprime toda la información asociada a dicha etiqueta, incluidos los suscriptores y los dispositivos. No es necesaria la anulación automática de la suscripción, porque la etiqueta ya no existe. No es necesario realizar más acciones en el lado del cliente. - -1. En el panel de control {{site.data.keyword.mobilepushshort}}, seleccione el separador **Etiquetas**. -1. Pulse el botón **Crear etiqueta** +. - 1. En el campo **Nombre**, especifique el nombre de la etiqueta. Por ejemplo, "cupones". - 1. En el campo **Descripción**, especifique una descripción de las etiquetas. - 1. Pulse **Guardar**. - -1. En el área **Fragmentos de código**, seleccione la plataforma para la aplicación para móviles. -1. Modifique los fragmentos de código para manejar errores y, a continuación, copiar los fragmentos de código para cada etiqueta en la aplicación para móviles. - -## Supresión de etiquetas -{: #delete_tags} - -1. En el separador **Etiqueta**, seleccione la etiqueta que desea suprimir y pulse el icono **Suprimir**. -1. Pulse **Aceptar**. - -## Edición de una descripción de etiquetas -{: #edit_tags} - -1. Desde el separador **Etiqueta**, seleccione la etiqueta que desee editar. -1. Pulse el icono **Editar**. -1. Edite la descripción de etiquetas y, a continuación, pulse el botón **Guardar**. - -# Obtención de etiquetas -{: #get_tags} - -Las etiquetas proporcionan una forma para enviar notificaciones de destino a usuarios en función de sus intereses, a diferencia de las difusiones generales que se envían a todas las aplicaciones. Puede crear y gestionar etiquetas utilizando el separador Etiqueta en el panel de control {{site.data.keyword.mobilepushshort}} o utilizando las API REST. Puede utilizar fragmentos de código para gestionar y consultar las suscripciones de etiquetas para la aplicación móvil. Puede utilizar estos fragmentos de código para obtener suscripciones, suscribirse a una etiqueta, anular la suscripción de una etiqueta u obtener una lista de las etiquetas disponibles. Copie estos fragmentos de código en su aplicación móvil. - -## Obtención de etiquetas en Android -{: android-get-tags} - -La API **getTags** devuelve la lista de etiquetas disponibles a la que el dispositivo se puede suscribir. Después de suscribir el dispositivo a una determinada etiqueta, el dispositivo podrá recibir {{site.data.keyword.mobilepushshort}} que se hayan enviado para dicha etiqueta. - -Copie los fragmentos de código siguientes en la aplicación para móviles de Android para obtener una lista de las etiquetas a las que el dispositivo está suscrito y para obtener una lista de las etiquetas disponibles. - -Utilice la API **getTags** siguiente para obtener una lista de etiquetas disponibles a las que el dispositivo se puede suscribir. - -``` -// Obtenga una lista de etiquetas disponibles a las que se puede suscribir el dispositivo -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } - }) -``` - {: codeblock} - -Utilice la API **getSubscriptions** para obtener una lista de etiquetas a las que está suscrito el dispositivo. - -``` -// Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) - ``` - {: codeblock} - -## Obtención de etiquetas en Cordova -{: cordova-get-tags} - -Copie los siguientes fragmentos de código en la aplicación para móviles para obtener una lista de las etiquetas a las que el dispositivo está suscrito y para obtener una lista de las etiquetas disponibles. - -Recupere una matriz de etiquetas disponibles a las que suscribirse. - -``` -//Obtenga una lista de etiquetas disponibles a las que el dispositivo se puede suscribir -BMSPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - -``` -//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe. -BMSPush.retrieveSubscriptions(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - - -## Obtención de etiquetas en Swift -{: swift-get-tags} - -La API **retrieveAvailableTagsWithCompletionHandler** devuelve la lista de etiquetas disponibles a la que el dispositivo se puede suscribir. Después de suscribir el dispositivo a una determinada etiqueta, el dispositivo podrá recibir {{site.data.keyword.mobilepushshort}} que se hayan enviado para dicha etiqueta. - -Llame el servicio {{site.data.keyword.mobilepushshort}} para obtener suscripciones para una etiqueta. - -Copie los siguientes fragmentos de código en la aplicación para móviles Swift para obtener una lista de etiquetas disponibles a las que el dispositivo está suscrito y para obtener una lista de etiquetas disponibles a las que se puede suscribir el dispositivo. -``` -//Obtenga una lista de etiquetas disponibles a las que se puede suscribir el dispositivo - push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - if error.isEmpty - { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else - { - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -``` -//Obtenga una lista de etiquetas disponibles a las que está suscrito el dispositivo -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during retrieving subscribed tags : \(response?.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else - { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -## Google Chrome, Safari y Mozilla Firefox -{: web-get-tags} - -Para obtener la lista de etiquetas disponibles, a las que se pueden suscribir los clientes, utilice el código siguiente. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - - -## Aplicaciones y extensiones de Google Chrome -{: web-get-tags} - -Para obtener la lista de etiquetas disponibles, a las que se pueden suscribir los clientes, utilice el código siguiente. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - -Copie los siguientes fragmentos de código en las aplicaciones y extensiones de Google Chrome para obtener una lista de etiquetas a las que están suscritos los clientes. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveSubscriptions(function(response) - { - alert(response.response) - }) -``` - {: codeblock} - - -# Suscripción y cancelación de la suscripción a las etiquetas -{: #Subscribe_tags} - -Utilice los siguientes fragmentos de código para permitir que los dispositivos obtengan suscripciones, se suscriban a una etiqueta y cancelen la suscripción de una etiqueta. - -## Suscripción y cancelación de la suscripción a las etiquetas en Android -{: android-subscribe-tags} - -Copie y pegue este fragmento de código en la aplicación para móviles de Android. - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } - }); -``` - {: codeblock} - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } - }); -``` - {: codeblock} - -## Suscripción y cancelación de la suscripción a las etiquetas en Cordova -{: cordova-subscribe-tags} - -Copie y pegue este fragmento de código en la aplicación para móviles de Cordova. - -``` -var tag = "YourTag"; -BMSPush.subscribe(tag, success, failure); -BMSPush.unsubscribe(tag, success, failure); -``` - {: codeblock} - - -## Suscripción y cancelación de la suscripción a las etiquetas en Swift -{: swift-subscribe-tags} - -Copie y pegue este fragmento de código en la aplicación para móviles de Swift. - -Utilice la API **subscribeToTags** para suscribirse a una etiqueta. - -``` -push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print("Response when subscribing to tags: \(response?.description)") - print("Status code when subscribing to tags: \(statusCode)") - } else { - print("Error when subscribing to tags: \(error) ") - print("Error status code when subscribing to tags: \(statusCode)") - } -}) -``` - {: codeblock} - -Utilice la API **unsubscribeFromTags** para anular la suscripción a una etiqueta. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during unsubscribed tags : \(response?.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - {: codeblock} - -## Google Chrome y Mozilla Firefox -{: web-subscribe-tags} - -Para suscribirse a etiquetas de aplicaciones web, utilice el siguiente fragmento de código: - -``` -var tagsArray = ["tag1", "Tag2"] -bmsPush.subscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -La anulación de la suscripción de etiquetas utiliza el método **unSubscribe**. - -``` -var tagsArray = ["tag1", "Tag2"] - bmsPush.unSubscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -# Utilización de notificaciones basadas en etiquetas -{: #using_tags} - -Las notificaciones basadas en etiquetas son mensajes que están pensados para todos los dispositivos suscritos a una etiqueta determinada. Cada dispositivo se puede suscribir a cualquier número de etiquetas. En este tema se describe cómo enviar notificaciones basadas en etiquetas. Las suscripciones las mantiene la instancia de Bluemix del servicio {{site.data.keyword.mobilepushshort}}. Cuando se suprime una etiqueta, también se suprime toda la información asociada a dicha etiqueta, incluidos los suscriptores y los dispositivos. No es necesaria ninguna anulación de la suscripción automática para esta etiqueta porque ya no existe y no es necesaria ninguna acción desde el lado del cliente. - -Cree etiquetas en la pantalla **Etiquetas**. Para obtener más información sobre cómo crear etiquetas, consulte [Creación de etiquetas](t_manage_tags.html). - -1. Desde el panel de control **Notificación Push**, pulse **Enviar notificaciones**. -1. Seleccione la opción **Dispositivo por etiqueta** en la lista desplegable **Enviar a**. -1. Busque las etiquetas que desee utilizar y selecciónelas. -![pantalla Notificaciones](images/tag_notification.jpg) -1. En el campo **Texto del mensaje**, especifique texto que desee enviar como notificación a la audiencia suscrita. -1. Pulse **Enviar**. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Gestión de etiquetas +{: #manage_tags} +Última actualización: 11 de enero de 2017 +{: .last-updated} + +Utilice el panel de control {{site.data.keyword.mobilepushshort}} para crear y suprimir etiquetas para la aplicación y, a continuación, iniciar las notificaciones basadas en etiquetas. La notificación basada en etiquetas se recibe en los dispositivos suscritos a las etiquetas. + + +## Creación de etiquetas +{: #create_tags} + +Las notificaciones basadas en etiquetas son mensajes que están pensados para todos los dispositivos suscritos a una etiqueta determinada. Cada dispositivo se puede suscribir a cualquier número de etiquetas. Cuando se suprime una etiqueta, también se suprime toda la información asociada a dicha etiqueta, incluidos los suscriptores y los dispositivos. No es necesaria la anulación automática de la suscripción, porque la etiqueta ya no existe. No es necesario realizar más acciones en el lado del cliente. + +1. En el panel de control {{site.data.keyword.mobilepushshort}}, seleccione el separador **Etiquetas**. +1. Pulse el botón **Crear etiqueta** +. + 1. En el campo **Nombre**, especifique el nombre de la etiqueta. Por ejemplo, "cupones". + 1. En el campo **Descripción**, especifique una descripción de las etiquetas. + 1. Pulse **Guardar**. + +1. En el área **Fragmentos de código**, seleccione la plataforma para la aplicación para móviles. +1. Modifique los fragmentos de código para manejar errores y, a continuación, copiar los fragmentos de código para cada etiqueta en la aplicación para móviles. + +## Supresión de etiquetas +{: #delete_tags} + +1. En el separador **Etiqueta**, seleccione la etiqueta que desea suprimir y pulse el icono **Suprimir**. +1. Pulse **Aceptar**. + +## Edición de una descripción de etiquetas +{: #edit_tags} + +1. Desde el separador **Etiqueta**, seleccione la etiqueta que desee editar. +1. Pulse el icono **Editar**. +1. Edite la descripción de etiquetas y, a continuación, pulse el botón **Guardar**. + +# Obtención de etiquetas +{: #get_tags} + +Las etiquetas proporcionan una forma para enviar notificaciones de destino a usuarios en función de sus intereses, a diferencia de las difusiones generales que se envían a todas las aplicaciones. Puede crear y gestionar etiquetas utilizando el separador Etiqueta en el panel de control {{site.data.keyword.mobilepushshort}} o utilizando las API REST. Puede utilizar fragmentos de código para gestionar y consultar las suscripciones de etiquetas para la aplicación móvil. Puede utilizar estos fragmentos de código para obtener suscripciones, suscribirse a una etiqueta, anular la suscripción de una etiqueta u obtener una lista de las etiquetas disponibles. Copie estos fragmentos de código en su aplicación móvil. + +## Obtención de etiquetas en Android +{: android-get-tags} + +La API **getTags** devuelve la lista de etiquetas disponibles a la que el dispositivo se puede suscribir. Después de suscribir el dispositivo a una determinada etiqueta, el dispositivo podrá recibir {{site.data.keyword.mobilepushshort}} que se hayan enviado para dicha etiqueta. + +Copie los fragmentos de código siguientes en la aplicación para móviles de Android para obtener una lista de las etiquetas a las que el dispositivo está suscrito y para obtener una lista de las etiquetas disponibles. + +Utilice la API **getTags** siguiente para obtener una lista de etiquetas disponibles a las que el dispositivo se puede suscribir. + +``` +// Obtenga una lista de etiquetas disponibles a las que se puede suscribir el dispositivo +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } + }) +``` + {: codeblock} + +Utilice la API **getSubscriptions** para obtener una lista de etiquetas a las que está suscrito el dispositivo. + +``` +// Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) + ``` + {: codeblock} + +## Obtención de etiquetas en Cordova +{: cordova-get-tags} + +Copie los siguientes fragmentos de código en la aplicación para móviles para obtener una lista de las etiquetas a las que el dispositivo está suscrito y para obtener una lista de las etiquetas disponibles. + +Recupere una matriz de etiquetas disponibles a las que suscribirse. + +``` +//Obtenga una lista de etiquetas disponibles a las que el dispositivo se puede suscribir +BMSPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + +``` +//Obtenga una lista de las etiquetas disponibles a las que el dispositivo se suscribe. +BMSPush.retrieveSubscriptions(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + + +## Obtención de etiquetas en Swift +{: swift-get-tags} + +La API **retrieveAvailableTagsWithCompletionHandler** devuelve la lista de etiquetas disponibles a la que el dispositivo se puede suscribir. Después de suscribir el dispositivo a una determinada etiqueta, el dispositivo podrá recibir {{site.data.keyword.mobilepushshort}} que se hayan enviado para dicha etiqueta. + +Llame el servicio {{site.data.keyword.mobilepushshort}} para obtener suscripciones para una etiqueta. + +Copie los siguientes fragmentos de código en la aplicación para móviles Swift para obtener una lista de etiquetas disponibles a las que el dispositivo está suscrito y para obtener una lista de etiquetas disponibles a las que se puede suscribir el dispositivo. +``` +//Obtenga una lista de etiquetas disponibles a las que se puede suscribir el dispositivo + push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + if error.isEmpty + { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else + { + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +``` +//Obtenga una lista de etiquetas disponibles a las que está suscrito el dispositivo +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during retrieving subscribed tags : \(response?.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else + { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +## Google Chrome, Safari y Mozilla Firefox +{: web-get-tags} + +Para obtener la lista de etiquetas disponibles, a las que se pueden suscribir los clientes, utilice el código siguiente. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + + +## Aplicaciones y extensiones de Google Chrome +{: web-get-tags} + +Para obtener la lista de etiquetas disponibles, a las que se pueden suscribir los clientes, utilice el código siguiente. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + +Copie los siguientes fragmentos de código en las aplicaciones y extensiones de Google Chrome para obtener una lista de etiquetas a las que están suscritos los clientes. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveSubscriptions(function(response) + { + alert(response.response) + }) +``` + {: codeblock} + + +# Suscripción y cancelación de la suscripción a las etiquetas +{: #Subscribe_tags} + +Utilice los siguientes fragmentos de código para permitir que los dispositivos obtengan suscripciones, se suscriban a una etiqueta y cancelen la suscripción de una etiqueta. + +## Suscripción y cancelación de la suscripción a las etiquetas en Android +{: android-subscribe-tags} + +Copie y pegue este fragmento de código en la aplicación para móviles de Android. + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } + }); +``` + {: codeblock} + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } + }); +``` + {: codeblock} + +## Suscripción y cancelación de la suscripción a las etiquetas en Cordova +{: cordova-subscribe-tags} + +Copie y pegue este fragmento de código en la aplicación para móviles de Cordova. + +``` +var tag = "YourTag"; +BMSPush.subscribe(tag, success, failure); +BMSPush.unsubscribe(tag, success, failure); +``` + {: codeblock} + + +## Suscripción y cancelación de la suscripción a las etiquetas en Swift +{: swift-subscribe-tags} + +Copie y pegue este fragmento de código en la aplicación para móviles de Swift. + +Utilice la API **subscribeToTags** para suscribirse a una etiqueta. + +``` +push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print("Response when subscribing to tags: \(response?.description)") + print("Status code when subscribing to tags: \(statusCode)") + } else { + print("Error when subscribing to tags: \(error) ") + print("Error status code when subscribing to tags: \(statusCode)") + } +}) +``` + {: codeblock} + +Utilice la API **unsubscribeFromTags** para anular la suscripción a una etiqueta. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during unsubscribed tags : \(response?.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + {: codeblock} + +## Google Chrome y Mozilla Firefox +{: web-subscribe-tags} + +Para suscribirse a etiquetas de aplicaciones web, utilice el siguiente fragmento de código: + +``` +var tagsArray = ["tag1", "Tag2"] +bmsPush.subscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +La anulación de la suscripción de etiquetas utiliza el método **unSubscribe**. + +``` +var tagsArray = ["tag1", "Tag2"] + bmsPush.unSubscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +# Utilización de notificaciones basadas en etiquetas +{: #using_tags} + +Las notificaciones basadas en etiquetas son mensajes que están pensados para todos los dispositivos suscritos a una etiqueta determinada. Cada dispositivo se puede suscribir a cualquier número de etiquetas. En este tema se describe cómo enviar notificaciones basadas en etiquetas. Las suscripciones las mantiene la instancia de Bluemix del servicio {{site.data.keyword.mobilepushshort}}. Cuando se suprime una etiqueta, también se suprime toda la información asociada a dicha etiqueta, incluidos los suscriptores y los dispositivos. No es necesaria ninguna anulación de la suscripción automática para esta etiqueta porque ya no existe y no es necesaria ninguna acción desde el lado del cliente. + +Cree etiquetas en la pantalla **Etiquetas**. Para obtener más información sobre cómo crear etiquetas, consulte [Creación de etiquetas](t_manage_tags.html). + +1. Desde el panel de control **Notificación Push**, pulse **Enviar notificaciones**. +1. Seleccione la opción **Dispositivo por etiqueta** en la lista desplegable **Enviar a**. +1. Busque las etiquetas que desee utilizar y selecciónelas. +![pantalla Notificaciones](images/tag_notification.jpg) +1. En el campo **Texto del mensaje**, especifique texto que desee enviar como notificación a la audiencia suscrita. +1. Pulse **Enviar**. diff --git a/services/mobilepush/nl/es/t_manage_user.md b/services/mobilepush/nl/es/t_manage_user.md index 54716eb62..ec62a26ac 100755 --- a/services/mobilepush/nl/es/t_manage_user.md +++ b/services/mobilepush/nl/es/t_manage_user.md @@ -1,166 +1,166 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Registro de un dispositivo con userId -{: #register_device_with_userId} -Última actualización: 06 de febrero de 2017 -{: .last-updated} - -Para registrarse para la notificación basada en userID, complete los pasos siguientes: - -## Android -{: android-register} - -Inicialice la clase MFPPush con las claves `AppGUID` y `clientSecret` del servicio {{site.data.keyword.mobilepushshort}}. -``` -// Inicialice el servicio de Notificaciones Push -push = MFPPush.getInstance(); -push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); -``` - {: codeblock} - - -- **AppGUID**: Esta es la clave AppGUID del servicio {{site.data.keyword.mobilepushshort}}. -- **clientSecret**: Esta es la clave clientSecret del servicio {{site.data.keyword.mobilepushshort}}. - - Utilice la API **registerDeviceWithUserId** para registrar el dispositivo para {{site.data.keyword.mobilepushshort}}. - -``` -// Registre el dispositivo en Notificaciones Push -push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - Log.d("Device is registered with Push Service.");} - @Override - public void onFailure(MFPPushException ex) { - Log.d("Error registering with Push Service...\n" - + "Push notifications will not be received."); - } - }); -``` - {: codeblock} - -- **userId**: Pase el valor de userId exclusivo para registrarse para {{site.data.keyword.mobilepushshort}}. - -**Nota:** para habilitar las {{site.data.keyword.mobilepushshort}} de destino según UserId, asegúrese de que registra el dispositivo con un userId y que también pasa el 'clientSecret' que está asignado cuando se suministran los servicios {{site.data.keyword.mobilepushshort}}. El registro del dispositivo no funcionará si no se proporciona un clientSecret válido. - -## Cordova -{: cordova} - -Utilice las siguientes API para registrarse para las {{site.data.keyword.mobilepushshort}} basadas en UserId. - -``` -// Registre el dispositivo para la Notificación Push con UserId -var options = {"userId": "Your User Id value"}; -BMSPush.registerDevice(options,success, failure); -``` - {: codeblock} - - -- **userId**: Pase el valor de userId exclusivo para registrarse para {{site.data.keyword.mobilepushshort}}. - - -## Swift -{: swift-register} - -``` -// Initialize the BMSPushClient -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -- **AppGUID**: Esta es la clave AppGUID del servicio {{site.data.keyword.mobilepushshort}}. -- **clientSecret**: Esta es la clave clientSecret del servicio {{site.data.keyword.mobilepushshort}}. - -Utilice la API **registerWithUserId** para registrar el dispositivo para {{site.data.keyword.mobilepushshort}}. - -``` -// Registre el dispositivo en el servicio de Notificaciones Push -push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in -if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } else { - print( "Error during device registration \(error) ") - } - } -``` - {: codeblock} - -- **userId**: Pase el valor de userId exclusivo para registrarse para {{site.data.keyword.mobilepushshort}}. - -## Google Chrome, Safari y Mozilla Firefox -{: web-register} - -Utilice las API siguientes para registrarse para las notificaciones basadas en userID. Inicialice el SDK con `app GUID`, `app Region` y `Client Secret`. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -Una vez inicializado correctamente, registre la aplicación web con userID. - -``` -bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -## Aplicaciones y extensiones de Google Chrome -{: web-register-new} - -Utilice las API siguientes para registrarse para las notificaciones basadas en userID. Inicialice el SDK con `app GUID`, `app Region` y `Client Secret`. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -Tras la correcta inicialización, debe registrar la aplicación web con el userId. - -``` -bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -# Uso de notificaciones basadas en userId -{: #using_userid} - -Las notificaciones basadas en userID son mensajes de notificación que están pensados para un usuario específico. Muchos dispositivos pueden registrarse con un usuario. Los pasos siguientes describen cómo enviar notificaciones basadas en el ID de usuario. - -1. Desde el panel de control **Notificación Push**, seleccione la opción **Enviar notificaciones**. -1. Seleccione **UserId** en la lista de opciones **Enviar a**. -1. En el campo **ID de usuario**, busque el ID del usuario que desea utilizar y, a continuación, pulse **+Añadir**.![Pantalla de notificaciones](images/user_notification.jpg) -1. En el campo **Mensaje**, escriba el texto que desea enviar en la notificación. -1. Pulse **Enviar**. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Registro de un dispositivo con userId +{: #register_device_with_userId} +Última actualización: 06 de febrero de 2017 +{: .last-updated} + +Para registrarse para la notificación basada en userID, complete los pasos siguientes: + +## Android +{: android-register} + +Inicialice la clase MFPPush con las claves `AppGUID` y `clientSecret` del servicio {{site.data.keyword.mobilepushshort}}. +``` +// Inicialice el servicio de Notificaciones Push +push = MFPPush.getInstance(); +push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); +``` + {: codeblock} + + +- **AppGUID**: Esta es la clave AppGUID del servicio {{site.data.keyword.mobilepushshort}}. +- **clientSecret**: Esta es la clave clientSecret del servicio {{site.data.keyword.mobilepushshort}}. + + Utilice la API **registerDeviceWithUserId** para registrar el dispositivo para {{site.data.keyword.mobilepushshort}}. + +``` +// Registre el dispositivo en Notificaciones Push +push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + Log.d("Device is registered with Push Service.");} + @Override + public void onFailure(MFPPushException ex) { + Log.d("Error registering with Push Service...\n" + + "Push notifications will not be received."); + } + }); +``` + {: codeblock} + +- **userId**: Pase el valor de userId exclusivo para registrarse para {{site.data.keyword.mobilepushshort}}. + +**Nota:** para habilitar las {{site.data.keyword.mobilepushshort}} de destino según UserId, asegúrese de que registra el dispositivo con un userId y que también pasa el 'clientSecret' que está asignado cuando se suministran los servicios {{site.data.keyword.mobilepushshort}}. El registro del dispositivo no funcionará si no se proporciona un clientSecret válido. + +## Cordova +{: cordova} + +Utilice las siguientes API para registrarse para las {{site.data.keyword.mobilepushshort}} basadas en UserId. + +``` +// Registre el dispositivo para la Notificación Push con UserId +var options = {"userId": "Your User Id value"}; +BMSPush.registerDevice(options,success, failure); +``` + {: codeblock} + + +- **userId**: Pase el valor de userId exclusivo para registrarse para {{site.data.keyword.mobilepushshort}}. + + +## Swift +{: swift-register} + +``` +// Initialize the BMSPushClient +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +- **AppGUID**: Esta es la clave AppGUID del servicio {{site.data.keyword.mobilepushshort}}. +- **clientSecret**: Esta es la clave clientSecret del servicio {{site.data.keyword.mobilepushshort}}. + +Utilice la API **registerWithUserId** para registrar el dispositivo para {{site.data.keyword.mobilepushshort}}. + +``` +// Registre el dispositivo en el servicio de Notificaciones Push +push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in +if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } else { + print( "Error during device registration \(error) ") + } + } +``` + {: codeblock} + +- **userId**: Pase el valor de userId exclusivo para registrarse para {{site.data.keyword.mobilepushshort}}. + +## Google Chrome, Safari y Mozilla Firefox +{: web-register} + +Utilice las API siguientes para registrarse para las notificaciones basadas en userID. Inicialice el SDK con `app GUID`, `app Region` y `Client Secret`. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +Una vez inicializado correctamente, registre la aplicación web con userID. + +``` +bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +## Aplicaciones y extensiones de Google Chrome +{: web-register-new} + +Utilice las API siguientes para registrarse para las notificaciones basadas en userID. Inicialice el SDK con `app GUID`, `app Region` y `Client Secret`. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +Tras la correcta inicialización, debe registrar la aplicación web con el userId. + +``` +bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +# Uso de notificaciones basadas en userId +{: #using_userid} + +Las notificaciones basadas en userID son mensajes de notificación que están pensados para un usuario específico. Muchos dispositivos pueden registrarse con un usuario. Los pasos siguientes describen cómo enviar notificaciones basadas en el ID de usuario. + +1. Desde el panel de control **Notificación Push**, seleccione la opción **Enviar notificaciones**. +1. Seleccione **UserId** en la lista de opciones **Enviar a**. +1. En el campo **ID de usuario**, busque el ID del usuario que desea utilizar y, a continuación, pulse **+Añadir**.![Pantalla de notificaciones](images/user_notification.jpg) +1. En el campo **Mensaje**, escriba el texto que desea enviar en la notificación. +1. Pulse **Enviar**. diff --git a/services/mobilepush/nl/es/t_push_ios_nextsteps.md b/services/mobilepush/nl/es/t_push_ios_nextsteps.md index 816f6e3e5..2fc54e9dc 100644 --- a/services/mobilepush/nl/es/t_push_ios_nextsteps.md +++ b/services/mobilepush/nl/es/t_push_ios_nextsteps.md @@ -1,21 +1,21 @@ - ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# Pasos siguientes - -{: #push-ios-nextsteps} - -Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. - -Añada estas características de Servicio de notificaciones push a la aplicación. - - - -- Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](t_push_tagsmain.md). -- Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones push avanzadas](t_advance_notifications.md). + +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# Pasos siguientes + +{: #push-ios-nextsteps} + +Una vez que haya configurado correctamente las notificaciones básicas, puede configurar las notificaciones basadas en código y las opciones avanzadas. + +Añada estas características de Servicio de notificaciones push a la aplicación. + + + +- Para utilizar notificaciones basadas en código, consulte [Notificaciones basadas en código](t_push_tagsmain.md). +- Para utilizar opciones de notificaciones avanzadas, consulte [Notificaciones push avanzadas](t_advance_notifications.md). diff --git a/services/mobilepush/nl/es/t_push_monitoring.md b/services/mobilepush/nl/es/t_push_monitoring.md index f58e1e380..871f7c183 100644 --- a/services/mobilepush/nl/es/t_push_monitoring.md +++ b/services/mobilepush/nl/es/t_push_monitoring.md @@ -1,33 +1,33 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Supervisión para notificaciones push -{: #monitor-notifications} -Última actualización: 16 de enero de 2017 -{: .last-updated} - - -El servicio {{site.data.keyword.mobilepushshort}} de IBM ahora amplía sus funciones para supervisar el rendimiento push generando gráficos desde los datos de usuario. Puede utilizar el programa de utilidad para enumerar todas las notificaciones push enviadas, o para enumerar todos los dispositivos registrados y para analizar información de forma diaria, semanal o mensual. - -Para generar informes para todas las notificaciones enviadas, utilice el método de informes Push Messages GET en [API REST](https://mobile.{DomainName}/imfpush/){: new_window}. - -![Informe de notificaciones enviadas](images/monitoring_messages.jpg) - - -Para generar informes para todos los dispositivos registrados, utilice el método de informes Push Device Registrations GET en [API REST](https://mobile.{DomainName}/imfpush/){: new_window}. - -![Informe de dispositivos registrados](images/monitoring_devices.jpg) - -Para obtener más información sobre cómo actualizar el Android SDK para supervisar la información de las notificaciones, consulte [Supervisión de las notificaciones push en dispositivos Android](c_android_enable.html#android_monitor). - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Supervisión para notificaciones push +{: #monitor-notifications} +Última actualización: 16 de enero de 2017 +{: .last-updated} + + +El servicio {{site.data.keyword.mobilepushshort}} de IBM ahora amplía sus funciones para supervisar el rendimiento push generando gráficos desde los datos de usuario. Puede utilizar el programa de utilidad para enumerar todas las notificaciones push enviadas, o para enumerar todos los dispositivos registrados y para analizar información de forma diaria, semanal o mensual. + +Para generar informes para todas las notificaciones enviadas, utilice el método de informes Push Messages GET en [API REST](https://mobile.{DomainName}/imfpush/){: new_window}. + +![Informe de notificaciones enviadas](images/monitoring_messages.jpg) + + +Para generar informes para todos los dispositivos registrados, utilice el método de informes Push Device Registrations GET en [API REST](https://mobile.{DomainName}/imfpush/){: new_window}. + +![Informe de dispositivos registrados](images/monitoring_devices.jpg) + +Para obtener más información sobre cómo actualizar el Android SDK para supervisar la información de las notificaciones, consulte [Supervisión de las notificaciones push en dispositivos Android](c_android_enable.html#android_monitor). + + + diff --git a/services/mobilepush/nl/es/t_push_provider_android.md b/services/mobilepush/nl/es/t_push_provider_android.md index 714b45d02..decb62c18 100755 --- a/services/mobilepush/nl/es/t_push_provider_android.md +++ b/services/mobilepush/nl/es/t_push_provider_android.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configuración de credenciales para FCM -{: #create-push-enable-gcm} -Última actualización: 16 de enero de 2017 -{: .last-updated} - -Firebase Cloud Messaging (FCM) es la pasarela utilizada para entregar notificaciones push a dispositivos Android y Google Chrome. FCM es la nueva versión de Google Cloud Messaging (GCM). Para configurar el servicio {{site.data.keyword.mobilepushshort}} en el panel de control, debe obtener credenciales de FCM. Asegúrese de que utiliza las configuraciones de FCM para nuevas aplicaciones. Las aplicaciones existentes seguirán funcionando con las configuraciones de GCM. - -##Cómo obtener el ID de remitente y la clave de la API -{: #android-senderid-apikey} - -La clave de la API se almacena de forma segura y la utiliza el servicio {{site.data.keyword.mobilepushshort}} para conectarse al servidor de FCM y el ID de remitente (número de proyecto) lo utilizará el SDK de Android y el SDK de JS para Google Chrome y Mozilla Firefox en el lado de cliente. - -Para configurar el FCM, genere la clave de API y el ID de remitente y siga estos pasos: - -1. Visite la [Consola de Firebase ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://console.firebase.google.com/?pli=1){: new_window}. -2. Seleccione **Crear nuevo proyecto**. -3. En la ventana Crear un proyecto, proporcione un nombre de proyecto, elija un país/región y pulse **Crear proyecto**. -3. En el panel de navegación, pulse el icono Valores y seleccione **Valores del proyecto**. -4. Seleccione el separador Cloud Messaging para generar una Clave de API de servidor y un ID de remitente. - -##Configuración del servicio {{site.data.keyword.mobilepushshort}} para Android y las aplicaciones y extensiones de Chrome -{: #setup-push-android} - -**Nota:** Necesitará la Clave de la API de FCM/GCM y el ID del remitente (número de proyecto). - -1. Abra el panel de control de Bluemix y pulse la instancia del servicio {{site.data.keyword.mobilepushfull}} que ha creado para abrir su panel de control. Se mostrará el panel de control de Push. Para configurar un servicio {{site.data.keyword.mobilepushshort}} desenlazado para Android, seleccione el icono de Servicio {{site.data.keyword.mobilepushshort}} desenlazado para abrir el panel de control del servicio {{site.data.keyword.mobilepushshort}}. - -![Panel de control de Push](images/push_unbound.jpg) - -2. Pulse el botón **Configurar Push** para configurar las credenciales de FCM/GCM para aplicaciones de Android y aplicaciones y extensiones de Google Chrome. -3. En la página **Configuración**, para Android, vaya al separador **Mobile** y configure el ID del remitente (número de proyecto de GCM) y la Clave de la API. Para las aplicaciones y extensiones de Google Chrome, vaya al separador **Web** y configure el ID del remitente (número de proyecto de FCM/GCM) y la Clave de la API adecuadamente. -4. Pulse **Guardar**. -5. Pasos siguientes. [Habilitación de notificaciones para Android](c_enable_push.html) o [Habilitación de notificaciones para aplicaciones y extensiones de Google Chrome](c_enable_push.html). - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configuración de credenciales para FCM +{: #create-push-enable-gcm} +Última actualización: 16 de enero de 2017 +{: .last-updated} + +Firebase Cloud Messaging (FCM) es la pasarela utilizada para entregar notificaciones push a dispositivos Android y Google Chrome. FCM es la nueva versión de Google Cloud Messaging (GCM). Para configurar el servicio {{site.data.keyword.mobilepushshort}} en el panel de control, debe obtener credenciales de FCM. Asegúrese de que utiliza las configuraciones de FCM para nuevas aplicaciones. Las aplicaciones existentes seguirán funcionando con las configuraciones de GCM. + +##Cómo obtener el ID de remitente y la clave de la API +{: #android-senderid-apikey} + +La clave de la API se almacena de forma segura y la utiliza el servicio {{site.data.keyword.mobilepushshort}} para conectarse al servidor de FCM y el ID de remitente (número de proyecto) lo utilizará el SDK de Android y el SDK de JS para Google Chrome y Mozilla Firefox en el lado de cliente. + +Para configurar el FCM, genere la clave de API y el ID de remitente y siga estos pasos: + +1. Visite la [Consola de Firebase ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://console.firebase.google.com/?pli=1){: new_window}. +2. Seleccione **Crear nuevo proyecto**. +3. En la ventana Crear un proyecto, proporcione un nombre de proyecto, elija un país/región y pulse **Crear proyecto**. +3. En el panel de navegación, pulse el icono Valores y seleccione **Valores del proyecto**. +4. Seleccione el separador Cloud Messaging para generar una Clave de API de servidor y un ID de remitente. + +##Configuración del servicio {{site.data.keyword.mobilepushshort}} para Android y las aplicaciones y extensiones de Chrome +{: #setup-push-android} + +**Nota:** Necesitará la Clave de la API de FCM/GCM y el ID del remitente (número de proyecto). + +1. Abra el panel de control de Bluemix y pulse la instancia del servicio {{site.data.keyword.mobilepushfull}} que ha creado para abrir su panel de control. Se mostrará el panel de control de Push. Para configurar un servicio {{site.data.keyword.mobilepushshort}} desenlazado para Android, seleccione el icono de Servicio {{site.data.keyword.mobilepushshort}} desenlazado para abrir el panel de control del servicio {{site.data.keyword.mobilepushshort}}. + +![Panel de control de Push](images/push_unbound.jpg) + +2. Pulse el botón **Configurar Push** para configurar las credenciales de FCM/GCM para aplicaciones de Android y aplicaciones y extensiones de Google Chrome. +3. En la página **Configuración**, para Android, vaya al separador **Mobile** y configure el ID del remitente (número de proyecto de GCM) y la Clave de la API. Para las aplicaciones y extensiones de Google Chrome, vaya al separador **Web** y configure el ID del remitente (número de proyecto de FCM/GCM) y la Clave de la API adecuadamente. +4. Pulse **Guardar**. +5. Pasos siguientes. [Habilitación de notificaciones para Android](c_enable_push.html) o [Habilitación de notificaciones para aplicaciones y extensiones de Google Chrome](c_enable_push.html). + + diff --git a/services/mobilepush/nl/es/t_push_provider_ios.md b/services/mobilepush/nl/es/t_push_provider_ios.md index 65ddcd052..5e0cf8ba3 100755 --- a/services/mobilepush/nl/es/t_push_provider_ios.md +++ b/services/mobilepush/nl/es/t_push_provider_ios.md @@ -1,146 +1,146 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configuración de credenciales para APNs -{: #create-push-credentials-apns} -Última actualización: 16 de enero de 2017 -{: .last-updated} - -El servicio de notificaciones push de Apple (APNs) permite a los desarrolladores de aplicaciones enviar -notificaciones remotas desde la instancia del servicio {{site.data.keyword.mobilepushshort}} en Bluemix (el proveedor) en dispositivos y aplicaciones de iOS. Los mensajes se envían a una aplicación de destino del dispositivo. - -Obtenga y configure las credenciales de APNs. Los certificados de APNs se gestionan de forma segura mediante el servicio {{site.data.keyword.mobilepushshort}} y se utilizan para conectarse al servidor APNs como proveedor. - - - - - - -##Registrar un ID de App -{: #create-push-credentials-apns-register} - - -El ID de app (el identificador de paquete) es un identificador exclusivo que identifica una aplicación específica. Cada aplicación requiere un ID de app. Los servicios como {{site.data.keyword.mobilepushshort}} se configuran en el ID de la app. - -1. Asegúrese de tener una cuenta de [desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com/){: new_window}. -2. Vaya al portal de [desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com){: new_window}, pulse **Centro de miembros** y seleccione **Certificados, identificadores y perfiles**. -3. Vaya a la sección **Registro de ID de app** de la [Biblioteca de desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window} y siga las instrucciones para registrar el ID de la app. - -Al registrar un ID de App, seleccione las opciones siguientes: - -* Notificaciones push -![Servicios de aplicaciones](images/appID_appservices_enablepush.jpg) -* Sufijo de ID explícito -![ID explícito](images/appID_bundleID.jpg) -4. Crear un certificado SSL de APNs de desarrollo y distribución. - -##Crear un certificado SSL de APNs de desarrollo y distribución -{: #create-push-credentials-apns-ssl} - -Para poder obtener un certificado de APNs, debe generar en primer lugar una solicitud de firma de certificado (CSR) y enviarla a Apple, la entidad emisora de certificados (CA). La CSR contiene información que identifica a la empresa y a la clave pública y privada que utilice para firmar las notificaciones push de Apple. A continuación, genere el certificado SSL en el Portal de desarrollador de iOS. El certificado, junto con su clave pública y privada, se almacena en el Acceso de cadena de claves. - - - - - - -Puede utilizar APNs de dos maneras: - -* La modalidad de pruebas durante el desarrollo y la prueba. -* La modalidad de producción al distribuir aplicaciones mediante App Store (u otros mecanismos de distribución de empresa). - -Debe obtener certificados independientes para los entornos de desarrollo y de distribución. Los certificados están asociados con un ID de App para la app que es el destinatario de las notificaciones remotas. Para la producción, puede crear un máximo de dos certificados. Bluemix utiliza los certificados para establecer una conexión SSL con APNs. - - - -1. Vaya al sitio web de [desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com){: new_window}, pulse **Centro de miembros** y seleccione **Certificados, identificadores y perfiles**. -2. En el área **Identificadores**, pulse **ID de app**. -3. Desde la lista de ID de App, seleccione el ID de App y, a continuación, seleccione **Configuración**. -4. En el área **Notificaciones Push**, cree un certificado SSL de desarrollo y, a continuación, un certificado SSL de producción. - - ![Certificados SSL de notificación Push](images/certificate_createssl.jpg) - -5. Cuando se muestre la pantalla **Acerca de la creación de una solicitud de firma de certificado (CSR)**, inicie la aplicación **Acceso de cadena de claves** en el Mac para crear una Solicitud de firma de certificado (CSR). -6. En el menú, seleccione **Acceso de cadena de claves > Asistente de certificado > Solicitud de un certificado a partir de una entidad emisora de certificados…** -7. En **Información del certificado**, especifique la dirección de correo electrónico asociada con la cuenta de Desarrollador de apps y un nombre común. Otorgue un nombre significativo que le ayude a identificar si es un certificado para desarrollo (pruebas) o distribución (producción); por ejemplo, *sandbox-apns-certificate* o *production-apns-certificate*. -8. Seleccione **Guardado en disco** para descargar el archivo `.certSigningRequest` en su escritorio y, a continuación, pulse **Continuar**. -9. En la opción de menú **Guardar como**, asigne `.certSigningRequest` al archivo y pulse **Guardar**. -10. Pulse **Hecho**. Ahora tiene un CSR. -11. Vuelva a la ventana **Acerca de la creación de una solicitud de firma de certificado (CSR)** y haga clic en **Continuar**. -12. Desde la pantalla **Generar**, pulse **Elegir archivo...** y seleccione el archivo CSR que ha guardado en el escritorio. Luego, pulse **Generar**. - ![Generar certificado](images/generate_certificate.jpg) -13. Cuando el certificado esté listo, pulse **Hecho**. -14. En la pantalla **Notificaciones Push**, pulse **Descargar** para descargar el certificado y, a continuación, pulse **Hecho**. - ![Descargar certificado](images/certificate_download.jpg) -15. En el Mac, vaya a **Acceso de cadena de claves > Mis certificados**, y ubique el certificado recién instalado. Efectúe una doble pulsación en el certificado para instalarlo en el Acceso de cadena de claves. -16. Seleccione el certificado y la clave privada y, a continuación, seleccione **Exportar** para convertir el certificado en el formato de intercambio de información personal (formato `.p12`). - ![Exportar certificado y claves](images/keychain_export_key.jpg) -17. En el campo **Guardar como**, escriba un nombre significativo para el certificado. Por ejemplo, `sandbox_apns.p12_certifcate` o `production_apns.p12`; luego pulse **Guardar**. - ![Exportar certificado y claves](images/certificate_p12v2.jpg) -18. En el campo **Escriba una contraseña**, especifique una contraseña para proteger los elementos exportados y, a continuación, pulse **Aceptar**. Puede utilizar esta contraseña para configurar los valores de APNs en el panel de control de Push.{: #step18} - ![Exportar certificado y claves](images/export_p12.jpg) -19. **Key Access.app** le solicita que exporte su clave desde la pantalla **Cadena de claves**. Especifique la contraseña de administración para Mac para permitir al sistema exportar estos elementos y, a continuación, seleccione la opción **Permitir siempre**. Se generará un certificado `.p12` en el escritorio. - - -##Creación de un perfil de suministro de desarrollo -{: #create-push-credentials-dev-profile} - -El perfil de suministro funciona con el ID de App para determinar qué dispositivos pueden instalar y ejecutar la app y a qué servicios puede acceder la app. Para cada ID de App, cree dos perfiles de suministro: uno para desarrollo y otro para distribución. Xcode utiliza el perfil de suministro de desarrollo para determinar qué desarrolladores están permitidos para crear la aplicación y qué dispositivos están permitidos para probarse en la aplicación. - -Asegúrese de que ha registrado un ID de App, de que lo ha habilitado para el servicio de {{site.data.keyword.mobilepushshort}} y de que lo ha configurado para utilizar un certificado SSL de APNs de desarrollo y producción. - -Cree un perfil de suministro de desarrollo, como se indica a continuación: - -1. Vaya al portal de [desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com){: new_window}, pulse **Centro de miembros** y seleccione **Certificados, identificadores y perfiles**. -2. Vaya a la [Biblioteca de desarrolladores de Mac ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}, desplácese hasta la sección **Creación de perfiles de suministro de desarrollo** y siga las instrucciones para crear un perfil de desarrollo. -**Nota**: Al configurar un perfil de suministro de desarrollo, seleccione las opciones siguientes: - * **Desarrollo de apps de iOS** - * **Para aplicaciones iOS y watchOS** - - - -##Creación de un perfil de suministro de distribución del almacén -{: #create-push-credentials-apns-distribute_profile} - -Utilice el perfil de suministro del almacén para enviar la app para su distribución a la App Store. - -1. Vaya al portal de [desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com){: new_window}, pulse **Centro de miembros** y seleccione **Certificados, identificadores y perfiles**. -2. Efectúe una doble pulsación en el perfil de suministro descargado para instalarlo en Xcode. - -##Configuración de APNs en el panel de control de {{site.data.keyword.mobilepushshort}} -{: #create-push-credentials-apns-dashboard} - -Para utilizar el servicio {{site.data.keyword.mobilepushshort}} para enviar notificaciones, cargue los certificados SSL necesarios para el servicio de Notificaciones Push de Apple (APNs). También se puede utilizar la API REST para subir un certificado de APNs. - - - -Los certificados necesarios para APNs son los certificados `.p12`. Estos certificados contienen la clave privada y certificados SSL que son necesarios para crear y publicar la aplicación. Debe generar los certificados desde el Centro de miembros del sitio web Desarrollador de Apple (es necesaria una cuenta válida de desarrollador de Apple). Los certificados independientes son necesarios para el entorno de desarrollo (pruebas) y el entorno de producción (distribución). - -**Nota**: Después de que el archivo `.cer` se encuentre en el acceso de cadena de claves, expórtelo al sistema para crear un certificado `.p12`. - -Para obtener más información sobre cómo utilizar APNs, consulte en la [Biblioteca de desarrolladores de iOS la guía de programación de notificaciones push y locales ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}. - -Para configurar APNs en el panel de control de servicios de notificación push, siga estos pasos: - -1. Seleccione **Configurar** en el panel de control de servicios de notificación push. -2. Elija la opción **Móvil** para actualizar la información del formulario **Credenciales push de APNs**. -3. Seleccione **Recinto de seguridad** (desarrollo) o **Producción** (distribución) según convenga y cargue los certificados `p.12` que ha creado en el [paso](#step18) anterior. - ![Panel de control Establecer notificaciones push](images/wizard.jpg) -3. En el campo **Contraseña**, especifique la contraseña asociada con el archivo de certificado `.p12` y, a continuación, pulse **Guardar**. - -Después de subir los certificados satisfactoriamente con una contraseña válida, inicie el envío de notificaciones. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configuración de credenciales para APNs +{: #create-push-credentials-apns} +Última actualización: 16 de enero de 2017 +{: .last-updated} + +El servicio de notificaciones push de Apple (APNs) permite a los desarrolladores de aplicaciones enviar +notificaciones remotas desde la instancia del servicio {{site.data.keyword.mobilepushshort}} en Bluemix (el proveedor) en dispositivos y aplicaciones de iOS. Los mensajes se envían a una aplicación de destino del dispositivo. + +Obtenga y configure las credenciales de APNs. Los certificados de APNs se gestionan de forma segura mediante el servicio {{site.data.keyword.mobilepushshort}} y se utilizan para conectarse al servidor APNs como proveedor. + + + + + + +## Registrar un ID de App +{: #create-push-credentials-apns-register} + + +El ID de app (el identificador de paquete) es un identificador exclusivo que identifica una aplicación específica. Cada aplicación requiere un ID de app. Los servicios como {{site.data.keyword.mobilepushshort}} se configuran en el ID de la app. + +1. Asegúrese de tener una cuenta de [desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com/){: new_window}. +2. Vaya al portal de [desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com){: new_window}, pulse **Centro de miembros** y seleccione **Certificados, identificadores y perfiles**. +3. Vaya a la sección **Registro de ID de app** de la [Biblioteca de desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window} y siga las instrucciones para registrar el ID de la app. + +Al registrar un ID de App, seleccione las opciones siguientes: + +* Notificaciones push +![Servicios de aplicaciones](images/appID_appservices_enablepush.jpg) +* Sufijo de ID explícito +![ID explícito](images/appID_bundleID.jpg) +4. Crear un certificado SSL de APNs de desarrollo y distribución. + +## Crear un certificado SSL de APNs de desarrollo y distribución +{: #create-push-credentials-apns-ssl} + +Para poder obtener un certificado de APNs, debe generar en primer lugar una solicitud de firma de certificado (CSR) y enviarla a Apple, la entidad emisora de certificados (CA). La CSR contiene información que identifica a la empresa y a la clave pública y privada que utilice para firmar las notificaciones push de Apple. A continuación, genere el certificado SSL en el Portal de desarrollador de iOS. El certificado, junto con su clave pública y privada, se almacena en el Acceso de cadena de claves. + + + + + + +Puede utilizar APNs de dos maneras: + +* La modalidad de pruebas durante el desarrollo y la prueba. +* La modalidad de producción al distribuir aplicaciones mediante App Store (u otros mecanismos de distribución de empresa). + +Debe obtener certificados independientes para los entornos de desarrollo y de distribución. Los certificados están asociados con un ID de App para la app que es el destinatario de las notificaciones remotas. Para la producción, puede crear un máximo de dos certificados. Bluemix utiliza los certificados para establecer una conexión SSL con APNs. + + + +1. Vaya al sitio web de [desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com){: new_window}, pulse **Centro de miembros** y seleccione **Certificados, identificadores y perfiles**. +2. En el área **Identificadores**, pulse **ID de app**. +3. Desde la lista de ID de App, seleccione el ID de App y, a continuación, seleccione **Configuración**. +4. En el área **Notificaciones Push**, cree un certificado SSL de desarrollo y, a continuación, un certificado SSL de producción. + + ![Certificados SSL de notificación Push](images/certificate_createssl.jpg) + +5. Cuando se muestre la pantalla **Acerca de la creación de una solicitud de firma de certificado (CSR)**, inicie la aplicación **Acceso de cadena de claves** en el Mac para crear una Solicitud de firma de certificado (CSR). +6. En el menú, seleccione **Acceso de cadena de claves > Asistente de certificado > Solicitud de un certificado a partir de una entidad emisora de certificados…** +7. En **Información del certificado**, especifique la dirección de correo electrónico asociada con la cuenta de Desarrollador de apps y un nombre común. Otorgue un nombre significativo que le ayude a identificar si es un certificado para desarrollo (pruebas) o distribución (producción); por ejemplo, *sandbox-apns-certificate* o *production-apns-certificate*. +8. Seleccione **Guardado en disco** para descargar el archivo `.certSigningRequest` en su escritorio y, a continuación, pulse **Continuar**. +9. En la opción de menú **Guardar como**, asigne `.certSigningRequest` al archivo y pulse **Guardar**. +10. Pulse **Hecho**. Ahora tiene un CSR. +11. Vuelva a la ventana **Acerca de la creación de una solicitud de firma de certificado (CSR)** y haga clic en **Continuar**. +12. Desde la pantalla **Generar**, pulse **Elegir archivo...** y seleccione el archivo CSR que ha guardado en el escritorio. Luego, pulse **Generar**. + ![Generar certificado](images/generate_certificate.jpg) +13. Cuando el certificado esté listo, pulse **Hecho**. +14. En la pantalla **Notificaciones Push**, pulse **Descargar** para descargar el certificado y, a continuación, pulse **Hecho**. + ![Descargar certificado](images/certificate_download.jpg) +15. En el Mac, vaya a **Acceso de cadena de claves > Mis certificados**, y ubique el certificado recién instalado. Efectúe una doble pulsación en el certificado para instalarlo en el Acceso de cadena de claves. +16. Seleccione el certificado y la clave privada y, a continuación, seleccione **Exportar** para convertir el certificado en el formato de intercambio de información personal (formato `.p12`). + ![Exportar certificado y claves](images/keychain_export_key.jpg) +17. En el campo **Guardar como**, escriba un nombre significativo para el certificado. Por ejemplo, `sandbox_apns.p12_certifcate` o `production_apns.p12`; luego pulse **Guardar**. + ![Exportar certificado y claves](images/certificate_p12v2.jpg) +18. En el campo **Escriba una contraseña**, especifique una contraseña para proteger los elementos exportados y, a continuación, pulse **Aceptar**. Puede utilizar esta contraseña para configurar los valores de APNs en el panel de control de Push.{: #step18} + ![Exportar certificado y claves](images/export_p12.jpg) +19. **Key Access.app** le solicita que exporte su clave desde la pantalla **Cadena de claves**. Especifique la contraseña de administración para Mac para permitir al sistema exportar estos elementos y, a continuación, seleccione la opción **Permitir siempre**. Se generará un certificado `.p12` en el escritorio. + + +## Creación de un perfil de suministro de desarrollo +{: #create-push-credentials-dev-profile} + +El perfil de suministro funciona con el ID de App para determinar qué dispositivos pueden instalar y ejecutar la app y a qué servicios puede acceder la app. Para cada ID de App, cree dos perfiles de suministro: uno para desarrollo y otro para distribución. Xcode utiliza el perfil de suministro de desarrollo para determinar qué desarrolladores están permitidos para crear la aplicación y qué dispositivos están permitidos para probarse en la aplicación. + +Asegúrese de que ha registrado un ID de App, de que lo ha habilitado para el servicio de {{site.data.keyword.mobilepushshort}} y de que lo ha configurado para utilizar un certificado SSL de APNs de desarrollo y producción. + +Cree un perfil de suministro de desarrollo, como se indica a continuación: + +1. Vaya al portal de [desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com){: new_window}, pulse **Centro de miembros** y seleccione **Certificados, identificadores y perfiles**. +2. Vaya a la [Biblioteca de desarrolladores de Mac ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}, desplácese hasta la sección **Creación de perfiles de suministro de desarrollo** y siga las instrucciones para crear un perfil de desarrollo. +**Nota**: Al configurar un perfil de suministro de desarrollo, seleccione las opciones siguientes: + * **Desarrollo de apps de iOS** + * **Para aplicaciones iOS y watchOS** + + + +## Creación de un perfil de suministro de distribución del almacén +{: #create-push-credentials-apns-distribute_profile} + +Utilice el perfil de suministro del almacén para enviar la app para su distribución a la App Store. + +1. Vaya al portal de [desarrolladores de Apple ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com){: new_window}, pulse **Centro de miembros** y seleccione **Certificados, identificadores y perfiles**. +2. Efectúe una doble pulsación en el perfil de suministro descargado para instalarlo en Xcode. + +## Configuración de APNs en el panel de control de {{site.data.keyword.mobilepushshort}} +{: #create-push-credentials-apns-dashboard} + +Para utilizar el servicio {{site.data.keyword.mobilepushshort}} para enviar notificaciones, cargue los certificados SSL necesarios para el servicio de Notificaciones Push de Apple (APNs). También se puede utilizar la API REST para subir un certificado de APNs. + + + +Los certificados necesarios para APNs son los certificados `.p12`. Estos certificados contienen la clave privada y certificados SSL que son necesarios para crear y publicar la aplicación. Debe generar los certificados desde el Centro de miembros del sitio web Desarrollador de Apple (es necesaria una cuenta válida de desarrollador de Apple). Los certificados independientes son necesarios para el entorno de desarrollo (pruebas) y el entorno de producción (distribución). + +**Nota**: Después de que el archivo `.cer` se encuentre en el acceso de cadena de claves, expórtelo al sistema para crear un certificado `.p12`. + +Para obtener más información sobre cómo utilizar APNs, consulte en la [Biblioteca de desarrolladores de iOS la guía de programación de notificaciones push y locales ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}. + +Para configurar APNs en el panel de control de servicios de notificación push, siga estos pasos: + +1. Seleccione **Configurar** en el panel de control de servicios de notificación push. +2. Elija la opción **Móvil** para actualizar la información del formulario **Credenciales push de APNs**. +3. Seleccione **Recinto de seguridad** (desarrollo) o **Producción** (distribución) según convenga y cargue los certificados `p.12` que ha creado en el [paso](#step18) anterior. + ![Panel de control Establecer notificaciones push](images/wizard.jpg) +3. En el campo **Contraseña**, especifique la contraseña asociada con el archivo de certificado `.p12` y, a continuación, pulse **Guardar**. + +Después de subir los certificados satisfactoriamente con una contraseña válida, inicie el envío de notificaciones. diff --git a/services/mobilepush/nl/es/t_push_provider_safari.md b/services/mobilepush/nl/es/t_push_provider_safari.md index 964970651..029cb96e2 100644 --- a/services/mobilepush/nl/es/t_push_provider_safari.md +++ b/services/mobilepush/nl/es/t_push_provider_safari.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configuración de credenciales para navegadores web -{: #configure-credential-for-browsers} -Última actualización: 11 de enero de 2017 -{: .last-updated} - -El servicio IBM {{site.data.keyword.mobilepushshort}} amplía sus funciones para enviar notificaciones al navegador. - -El servicio {{site.data.keyword.mobilepushshort}} necesita el URL del sitio web o el nombre del dominio del sitio web para identificar las solicitudes que se deben permitir. Una instancia de servicio de {{site.data.keyword.mobilepushshort}} solo admite un nombre de dominio. Por lo tanto, asegúrese de que se haya establecido el mismo valor para Chrome, Firefox y Safari. - -Los navegadores Chrome y Safari necesitan configuración adicional para push we,. Necesitaría una clave de API de FCM, ya que se utiliza un punto final FCM para distribuir mensajes en Chrome. Para obtener una clave de API de FCM, consulte [Configuración de credenciales para FCM](t_push_provider_android.html). - - - -##Configuración para push web de Chrome y Firefox -{: #config-chrome-firefox} - -1. En el panel de control de Push, seleccione **Configurar**. -2. Seleccione el separador Web. - ![Configuraciones de push web](images/webpush_configure.jpg) -3. Configure la clave de la API de FCM/GCM y el URL del sitio web que se registrará para la recepción de notificaciones por push. -4. Pulse **Guardar**. -5. Pasos siguientes. [Habilitación de notificaciones para navegadores Google Chrome y Mozilla Firefox](c_enable_push.html). - - -## Configuración de push web de Safari -{: #configure-safari} - -La versión admitida para el servicio de {{site.data.keyword.mobilepushshort}} en Safari es 10.0. Debe generar un certificado a través de su cuenta de Apple Developer para poder configurar el navegador para que reciba notificaciones. - -### Generación de un certificado -{: #certificate-generation} - -Asegúrese de disponer de una cuenta de desarrollador de Apple. Tiene que registrar un Push ID del sitio web y generar un certificado para configurar Safari para que reciba notificaciones. Comience siguiendo estos pasos. - -1. En el centro Apple Developer Member, pulse **Certificados, ID y Perfiles**. -2. Pulse **Identificadores** y luego **ID Push del sitio web**. -3. Elija crear una nueva entrada seleccionando el icono del signo más. - ![Panel de control de Push](images/safari_1.jpg) - -4. En el panel Registrar ID Push del sitio web, especifique una descripción adecuada del ID Push del sitio web y un ID identificador. Se recomienda que esté en formato de nombre de dominio invertido, comenzando por 'web'. Por ejemplo: web.com.example.dailyweatherreports. -5. Registre el ID Push del sitio web. Ahora tiene el ID Push del sitio web -6. Seleccione **Editar** para crear un certificado que se utilizará para el ID Push del sitio web. -7. En la ventana Asistente de certificados para la información sobre certificados, especifique su ID de correo electrónico y un nombre común. Deje en blanco la dirección de correo electrónico de la entidad emisora de certificados. -8. Pulse **Guardar en disco** y seleccione **Continuar**. -9. Guarde el certificado en una carpeta adecuada. -10. Seleccione el `.certSigningRequest` creado en el disco cuando se le solicite en el asistente para generar el certificado. Asegúrese de que descarga el certificado push del sitio web creado en el formato `.cer`. -11. Abra el Certificado en la herramienta KeyChain Access. Pulse con el botón derecho del ratón y exporte como certificado p12. Anote la contraseña que se facilita durante la generación del certificado p12. - - -### Configuración para notificaciones - {: #configuration-notification} - -Tras generar el certificado, puede configurar el servicio para enviar notificaciones a Safari. - -Complete los pasos: - -1. En el panel de control de servicio de Notificaciones Push, **pulse Configurar**. -2. Seleccione el separador Web. -3. En la sección Push de Safari, actualice el formulario con la información necesaria. - - **Nombre del sitio web**: Este es el nombre que ha facilitado en el Centro de notificaciones. - - **ID Push del sitio web**: Actualice con la serie de dominio invertido para el ID Push del sitio web. Por ejemplo, web.com.ejemplo.www. - - **URL del sitio web**: Proporcione el URL del sitio web que debería estar suscrito a notificaciones push. Por ejemplo, https://www.ejemplo.com. - - **Dominios permitidos**: Este es un parámetro opcional. Es la lista de sitios web que solicita permiso del usuario. Asegúrese de que las URL sean valores separados por coma. Tenga en cuenta que el valor del URL del sitio web se utilizará si no se proporciona. - - **Serie de formato de URL**: El URL a resolver cuando se pulse la notificación. Por ejemplo, ["https://www.ejemplo.com"]. Asegúrese de que el URL utilice el esquema http o https. - - **Certificado Push web de Safari**: Cargue el certificado .p12 y proporcione la contraseña. -4. Pulse **Guardar**. - -![Panel de control de Push](images/push_configure_safari.jpg) - -Ya tiene configurado el envío de notificaciones push para el navegador Safari. - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configuración de credenciales para navegadores web +{: #configure-credential-for-browsers} +Última actualización: 11 de enero de 2017 +{: .last-updated} + +El servicio IBM {{site.data.keyword.mobilepushshort}} amplía sus funciones para enviar notificaciones al navegador. + +El servicio {{site.data.keyword.mobilepushshort}} necesita el URL del sitio web o el nombre del dominio del sitio web para identificar las solicitudes que se deben permitir. Una instancia de servicio de {{site.data.keyword.mobilepushshort}} solo admite un nombre de dominio. Por lo tanto, asegúrese de que se haya establecido el mismo valor para Chrome, Firefox y Safari. + +Los navegadores Chrome y Safari necesitan configuración adicional para push we,. Necesitaría una clave de API de FCM, ya que se utiliza un punto final FCM para distribuir mensajes en Chrome. Para obtener una clave de API de FCM, consulte [Configuración de credenciales para FCM](t_push_provider_android.html). + + + +##Configuración para push web de Chrome y Firefox +{: #config-chrome-firefox} + +1. En el panel de control de Push, seleccione **Configurar**. +2. Seleccione el separador Web. + ![Configuraciones de push web](images/webpush_configure.jpg) +3. Configure la clave de la API de FCM/GCM y el URL del sitio web que se registrará para la recepción de notificaciones por push. +4. Pulse **Guardar**. +5. Pasos siguientes. [Habilitación de notificaciones para navegadores Google Chrome y Mozilla Firefox](c_enable_push.html). + + +## Configuración de push web de Safari +{: #configure-safari} + +La versión admitida para el servicio de {{site.data.keyword.mobilepushshort}} en Safari es 10.0. Debe generar un certificado a través de su cuenta de Apple Developer para poder configurar el navegador para que reciba notificaciones. + +### Generación de un certificado +{: #certificate-generation} + +Asegúrese de disponer de una cuenta de desarrollador de Apple. Tiene que registrar un Push ID del sitio web y generar un certificado para configurar Safari para que reciba notificaciones. Comience siguiendo estos pasos. + +1. En el centro Apple Developer Member, pulse **Certificados, ID y Perfiles**. +2. Pulse **Identificadores** y luego **ID Push del sitio web**. +3. Elija crear una nueva entrada seleccionando el icono del signo más. + ![Panel de control de Push](images/safari_1.jpg) + +4. En el panel Registrar ID Push del sitio web, especifique una descripción adecuada del ID Push del sitio web y un ID identificador. Se recomienda que esté en formato de nombre de dominio invertido, comenzando por 'web'. Por ejemplo: web.com.example.dailyweatherreports. +5. Registre el ID Push del sitio web. Ahora tiene el ID Push del sitio web +6. Seleccione **Editar** para crear un certificado que se utilizará para el ID Push del sitio web. +7. En la ventana Asistente de certificados para la información sobre certificados, especifique su ID de correo electrónico y un nombre común. Deje en blanco la dirección de correo electrónico de la entidad emisora de certificados. +8. Pulse **Guardar en disco** y seleccione **Continuar**. +9. Guarde el certificado en una carpeta adecuada. +10. Seleccione el `.certSigningRequest` creado en el disco cuando se le solicite en el asistente para generar el certificado. Asegúrese de que descarga el certificado push del sitio web creado en el formato `.cer`. +11. Abra el Certificado en la herramienta KeyChain Access. Pulse con el botón derecho del ratón y exporte como certificado p12. Anote la contraseña que se facilita durante la generación del certificado p12. + + +### Configuración para notificaciones + {: #configuration-notification} + +Tras generar el certificado, puede configurar el servicio para enviar notificaciones a Safari. + +Complete los pasos: + +1. En el panel de control de servicio de Notificaciones Push, **pulse Configurar**. +2. Seleccione el separador Web. +3. En la sección Push de Safari, actualice el formulario con la información necesaria. + - **Nombre del sitio web**: Este es el nombre que ha facilitado en el Centro de notificaciones. + - **ID Push del sitio web**: Actualice con la serie de dominio invertido para el ID Push del sitio web. Por ejemplo, web.com.ejemplo.www. + - **URL del sitio web**: Proporcione el URL del sitio web que debería estar suscrito a notificaciones push. Por ejemplo, https://www.ejemplo.com. + - **Dominios permitidos**: Este es un parámetro opcional. Es la lista de sitios web que solicita permiso del usuario. Asegúrese de que las URL sean valores separados por coma. Tenga en cuenta que el valor del URL del sitio web se utilizará si no se proporciona. + - **Serie de formato de URL**: El URL a resolver cuando se pulse la notificación. Por ejemplo, ["https://www.ejemplo.com"]. Asegúrese de que el URL utilice el esquema http o https. + - **Certificado Push web de Safari**: Cargue el certificado .p12 y proporcione la contraseña. +4. Pulse **Guardar**. + +![Panel de control de Push](images/push_configure_safari.jpg) + +Ya tiene configurado el envío de notificaciones push para el navegador Safari. + + diff --git a/services/mobilepush/nl/es/t_push_tagsmain.md b/services/mobilepush/nl/es/t_push_tagsmain.md index b3f01c1c0..e9614b94a 100755 --- a/services/mobilepush/nl/es/t_push_tagsmain.md +++ b/services/mobilepush/nl/es/t_push_tagsmain.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Notificaciones basadas en etiquetas -{: #push-ios-main-tags} -Última actualización: 16 de enero de 2017 -{: .last-updated} - -Los mensajes de notificación basados en etiquetas están pensados para todos los dispositivos suscritos a una etiqueta determinada. Puede definir etiquetas y, a continuación, enviar y recibir mensajes mediante etiquetas. - -Primero debe crear las etiquetas para la aplicación, configurar las suscripciones de etiquetas y, a continuación, iniciar las notificaciones basadas en etiquetas. Para enviar una notificación basada en etiquetas mediante la [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}, asegúrese de que se proporcionen valores de "tagNames" al publicar en el recurso de mensajes. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Notificaciones basadas en etiquetas +{: #push-ios-main-tags} +Última actualización: 16 de enero de 2017 +{: .last-updated} + +Los mensajes de notificación basados en etiquetas están pensados para todos los dispositivos suscritos a una etiqueta determinada. Puede definir etiquetas y, a continuación, enviar y recibir mensajes mediante etiquetas. + +Primero debe crear las etiquetas para la aplicación, configurar las suscripciones de etiquetas y, a continuación, iniciar las notificaciones basadas en etiquetas. Para enviar una notificación basada en etiquetas mediante la [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}, asegúrese de que se proporcionen valores de "tagNames" al publicar en el recurso de mensajes. diff --git a/services/mobilepush/nl/es/t_restapi.md b/services/mobilepush/nl/es/t_restapi.md index e48af74b9..666696390 100755 --- a/services/mobilepush/nl/es/t_restapi.md +++ b/services/mobilepush/nl/es/t_restapi.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Utilización de API REST -{: #push-api-rest} -Última actualización: 16 de enero de 2017 -{: .last-updated} - -Puede utilizar una API (application program interface, interfaz de programa de aplicaciones) REST (Representational State Transfer) para {{site.data.keyword.mobilepushshort}}. También puede utilizar el SDK y la [API Push ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window} para seguir desarrollando aplicaciones cliente. - -Con la API REST Push, los clientes y las aplicaciones de servidor de fondo pueden acceder a las funciones {{site.data.keyword.mobilepushshort}}. - -- Registros de dispositivos -- Registros -- Mensajes -- Suscripciones -- Etiquetas -- Webhooks - -Para obtener el URL base de la API REST, siga estos pasos: - -1. Cree una aplicación back-end en el catálogo Bluemix® de la sección de contenedores modelo eligiendo MobileFirst Services Starter. De esta manera se enlaza el servicio {{site.data.keyword.mobilepushshort}} con la aplicación. También puede crear una instancia de servicio de push y dejarla desenlazada. -1. En la página principal del panel de control de Bluemix, vaya al área **Aplicaciones** y seleccione la app. -3. Pulse **OPCIONES MÓVILES**. Se mostrarán la ruta y los valores GUID de la app en la parte superior de la página de detalles de la app. La pantalla Mostrar credenciales muestra información sobre AppSecret. Puede obtener el secreto de la aplicación en Opciones móviles, así como el secreto de cliente de algunas de las API. - -También puede utilizar la línea de mandatos para obtener las credenciales del servicio: - -``` - cf create-service-key {nombre_instancia_push} {nombre_clave} - - cf service-key {nombre_instancia_push} {nombre_clave} -``` - {: codeblock} - -## Cabecera Accept Language -{: #push-api-rest-accept} - -La cabecera "Accept-Language" especifica el idioma que se utilizará para los mensajes de error que emite la [API REST de Push ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. Se da soporte a los siguientes idiomas para ver si contienen mensajes de error: chino (simplificado), chino (tradicional), inglés (EE.UU.), alemán, francés, italiano, japonés, coreano, portugués y español. - -## appSecret -{: #push-api-rest-secret} - -Cuando una aplicación se enlaza a las {{site.data.keyword.mobilepushshort}}, el servicio generará un appSecret (una clave exclusiva) y la pasa en la cabecera de respuesta. Si está utilizando IBM {{site.data.keyword.mobilepushshort}} para la API REST de Bluemix, utilice la referencia de la API REST para obtener información sobre qué API se deben proteger. Para obtener información, consulte la [API REST de Push ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. - -La cabecera de la solicitud debe contener el appSecret. Si no, el servidor devuelve un código 401 Unauthorized Error. Cuando se añade la {{site.data.keyword.mobilepushshort}} a una aplicación, se creará una AppID específica. Como parte de la respuesta, obtiene una cabecera denominada appSecret que se utiliza para crear etiquetas o para enviar mensajes. La operación sucede a través de servicios del catálogo o del contenedor modelo. - -Para obtener el valor de appSecret: - -1. Pulse el *app-name* que está enlazado al servicio push. -2. Pulse el enlace **Mostrar credenciales** para visualizar el appSecret (AppID). - -La pantalla **Mostrar credenciales** muestra información sobre el AppSecret: -``` - { - "imfpush_Dev": [ - { - "name": "testapp1", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": { - "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", - "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", - "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", - } - } - ] - } -``` - {: codeblock} - - -##Filtros API REST de Push -{: #push-api-rest-filters} - -Los filtros definen los criterios de búsqueda que restringen los datos devueltos de una API GET de {{site.data.keyword.mobilepushshort}}. Aplique los filtros con el resultado de la operación Get que desee filtrar. El filtro restringe el número de entradas incluidas en el resultado. Por ejemplo, puede utilizar un filtro para buscar etiquetas que empiecen por "test". - -Los filtros se pueden generar mediante la siguiente sintaxis: - -**name**: el nombre de campo en el que se está aplicando el filtro. - -**operator**: == (Coincidencia exacta) o =@ (Contiene subserie) que describe la coincidencia de filtro que se debe utilizar. - -**expression**: los valores que se deben incluir en el resultado. - -Cuando se visualizan en una expresión una coma y una barra inclinada invertida, se deben poder escapar con la barra inclinada invertida. - -Al utilizar varios filtros, se pueden combinar mediante la lógica AND y OR. - -- Para la lógica AND, utilice varios filtros en la consulta. -- Para la lógica OR, utilice una coma (,) dentro de la expresión de filtro. -- Para la lógica AND y OR: una única consulta puede tener la lógica AND y OR. Cada filtro se evalúa de forma individual antes de que los filtros se combinen en una expresión AND. - -Para la API GET del dispositivo, se da soporte a las siguientes combinaciones: --El nombre es el campo plataforma. -- Excepto para la plataforma, el operador puede ser == o =@ -- Para la plataforma, el operador debe ser ==. Si se utiliza el operador =@, el valor puede ser una subcadena. -- Si se utiliza ==, el valor debe ser una cadena de caracteres de coincidencia exacta. - -Para la API GET de suscripción, se da soporte a las siguientes combinaciones: - -- El nombre puede ser uno de estos campos: tagName o deviceId -- Excepto para la plataforma, el operador puede ser == o =@ -- Para la plataforma, el operador debe ser == -- Si se utiliza el operador =@, el valor puede ser una subcadena. Si se utiliza el operador ==, el valor debe ser una cadena de caracteres de coincidencia exacta. -- Para la API GET de la etiqueta, se da soporte a las siguientes combinaciones: -- El nombre puede ser uno de estos campos: “name” o “description” -- Si se utiliza el operador =@, el valor puede ser una subcadena. -- Si se utiliza ==, el valor debe ser una cadena de caracteres de coincidencia exacta. - - -##Códigos de respuesta de {{site.data.keyword.mobilepushshort}} -{: #push-api-response-codes} - -Estado: Método 405 no permitido - Se esperaba el método apropiado. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Utilización de API REST +{: #push-api-rest} +Última actualización: 16 de enero de 2017 +{: .last-updated} + +Puede utilizar una API (application program interface, interfaz de programa de aplicaciones) REST (Representational State Transfer) para {{site.data.keyword.mobilepushshort}}. También puede utilizar el SDK y la [API Push ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window} para seguir desarrollando aplicaciones cliente. + +Con la API REST Push, los clientes y las aplicaciones de servidor de fondo pueden acceder a las funciones {{site.data.keyword.mobilepushshort}}. + +- Registros de dispositivos +- Registros +- Mensajes +- Suscripciones +- Etiquetas +- Webhooks + +Para obtener el URL base de la API REST, siga estos pasos: + +1. Cree una aplicación back-end en el catálogo Bluemix® de la sección de contenedores modelo eligiendo MobileFirst Services Starter. De esta manera se enlaza el servicio {{site.data.keyword.mobilepushshort}} con la aplicación. También puede crear una instancia de servicio de push y dejarla desenlazada. +1. En la página principal del panel de control de Bluemix, vaya al área **Aplicaciones** y seleccione la app. +3. Pulse **OPCIONES MÓVILES**. Se mostrarán la ruta y los valores GUID de la app en la parte superior de la página de detalles de la app. La pantalla Mostrar credenciales muestra información sobre AppSecret. Puede obtener el secreto de la aplicación en Opciones móviles, así como el secreto de cliente de algunas de las API. + +También puede utilizar la línea de mandatos para obtener las credenciales del servicio: + +``` + cf create-service-key {nombre_instancia_push} {nombre_clave} + + cf service-key {nombre_instancia_push} {nombre_clave} +``` + {: codeblock} + +## Cabecera Accept Language +{: #push-api-rest-accept} + +La cabecera "Accept-Language" especifica el idioma que se utilizará para los mensajes de error que emite la [API REST de Push ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. Se da soporte a los siguientes idiomas para ver si contienen mensajes de error: chino (simplificado), chino (tradicional), inglés (EE.UU.), alemán, francés, italiano, japonés, coreano, portugués y español. + +## appSecret +{: #push-api-rest-secret} + +Cuando una aplicación se enlaza a las {{site.data.keyword.mobilepushshort}}, el servicio generará un appSecret (una clave exclusiva) y la pasa en la cabecera de respuesta. Si está utilizando IBM {{site.data.keyword.mobilepushshort}} para la API REST de Bluemix, utilice la referencia de la API REST para obtener información sobre qué API se deben proteger. Para obtener información, consulte la [API REST de Push ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. + +La cabecera de la solicitud debe contener el appSecret. Si no, el servidor devuelve un código 401 Unauthorized Error. Cuando se añade la {{site.data.keyword.mobilepushshort}} a una aplicación, se creará una AppID específica. Como parte de la respuesta, obtiene una cabecera denominada appSecret que se utiliza para crear etiquetas o para enviar mensajes. La operación sucede a través de servicios del catálogo o del contenedor modelo. + +Para obtener el valor de appSecret: + +1. Pulse el *app-name* que está enlazado al servicio push. +2. Pulse el enlace **Mostrar credenciales** para visualizar el appSecret (AppID). + +La pantalla **Mostrar credenciales** muestra información sobre el AppSecret: +``` + { + "imfpush_Dev": [ + { + "name": "testapp1", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": { + "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", + "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", + "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", + } + } + ] + } +``` + {: codeblock} + + +## Filtros API REST de Push +{: #push-api-rest-filters} + +Los filtros definen los criterios de búsqueda que restringen los datos devueltos de una API GET de {{site.data.keyword.mobilepushshort}}. Aplique los filtros con el resultado de la operación Get que desee filtrar. El filtro restringe el número de entradas incluidas en el resultado. Por ejemplo, puede utilizar un filtro para buscar etiquetas que empiecen por "test". + +Los filtros se pueden generar mediante la siguiente sintaxis: + +**name**: el nombre de campo en el que se está aplicando el filtro. + +**operator**: == (Coincidencia exacta) o =@ (Contiene subserie) que describe la coincidencia de filtro que se debe utilizar. + +**expression**: los valores que se deben incluir en el resultado. + +Cuando se visualizan en una expresión una coma y una barra inclinada invertida, se deben poder escapar con la barra inclinada invertida. + +Al utilizar varios filtros, se pueden combinar mediante la lógica AND y OR. + +- Para la lógica AND, utilice varios filtros en la consulta. +- Para la lógica OR, utilice una coma (,) dentro de la expresión de filtro. +- Para la lógica AND y OR: una única consulta puede tener la lógica AND y OR. Cada filtro se evalúa de forma individual antes de que los filtros se combinen en una expresión AND. + +Para la API GET del dispositivo, se da soporte a las siguientes combinaciones: +-El nombre es el campo plataforma. +- Excepto para la plataforma, el operador puede ser == o =@ +- Para la plataforma, el operador debe ser ==. Si se utiliza el operador =@, el valor puede ser una subcadena. +- Si se utiliza ==, el valor debe ser una cadena de caracteres de coincidencia exacta. + +Para la API GET de suscripción, se da soporte a las siguientes combinaciones: + +- El nombre puede ser uno de estos campos: tagName o deviceId +- Excepto para la plataforma, el operador puede ser == o =@ +- Para la plataforma, el operador debe ser == +- Si se utiliza el operador =@, el valor puede ser una subcadena. Si se utiliza el operador ==, el valor debe ser una cadena de caracteres de coincidencia exacta. +- Para la API GET de la etiqueta, se da soporte a las siguientes combinaciones: +- El nombre puede ser uno de estos campos: “name” o “description” +- Si se utiliza el operador =@, el valor puede ser una subcadena. +- Si se utiliza ==, el valor debe ser una cadena de caracteres de coincidencia exacta. + + +## Códigos de respuesta de {{site.data.keyword.mobilepushshort}} +{: #push-api-response-codes} + +Estado: Método 405 no permitido - Se esperaba el método apropiado. diff --git a/services/mobilepush/nl/es/t_sandbox.md b/services/mobilepush/nl/es/t_sandbox.md index 5f1983935..692dfefb7 100755 --- a/services/mobilepush/nl/es/t_sandbox.md +++ b/services/mobilepush/nl/es/t_sandbox.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Modalidades de pruebas y de producción -{: #push-sandboxandproduction-modes} -Última actualización: 11 de enero de 2017 -{: .last-updated} - -Puede utilizar {{site.data.keyword.mobilepushshort}} en cualquiera de las modalidades siguientes: prueba o producción. El recinto de pruebas es un entorno de prueba autocontenido para desarrollar y probar la integración de API push con el servicio push de la aplicación de servidor. - -Configure las modalidades de pruebas y de producción utilizando el Panel de instrumentos Push. Puede conmutar entre la modalidad de operaciones del servicio push - entre pruebas y producción utilizando la [API REST de Push](https://mobile.{DomainName}/imfpush/){: new_window}. De forma predeterminada, estará habilitada la modalidad de pruebas. Sin embargo, cuando se cambia entre modalidades, las etiquetas, los dispositivos y las suscripciones no se comparten entre estas modalidades. - -Cuando esté listo para desplegar la aplicación en un entorno activo, seleccione la modalidad PRODUCTION utilizando la [API REST de Push](https://mobile.{DomainName}/imfpush/){: new_window}. - -Para conmutar la modalidad de operación del servicio push de pruebas a producción: - -1. Utilice la llamada de la API PUT ApplicationID Settings REST -2. En el cuerpo de JSON, confirme que la modalidad se ha cambiado utilizando la llamada de la API [GET ApplicationID Settings REST](https://mobile.{DomainName}/imfpush/){: new_window}. La respuesta esperada es "mode": "PRODUCTION -```{ - "mode": "PRODUCTION" - } -``` - {: codeblock} -1. Una vez que se haya conmutado la modalidad del entorno, ejecute el código del cliente de nuevo para registrar el dispositivo en la modalidad de PRODUCTION. - -Para obtener información sobre la API REST, consulte [Utilización de API REST](t_restapi.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Modalidades de pruebas y de producción +{: #push-sandboxandproduction-modes} +Última actualización: 11 de enero de 2017 +{: .last-updated} + +Puede utilizar {{site.data.keyword.mobilepushshort}} en cualquiera de las modalidades siguientes: prueba o producción. El recinto de pruebas es un entorno de prueba autocontenido para desarrollar y probar la integración de API push con el servicio push de la aplicación de servidor. + +Configure las modalidades de pruebas y de producción utilizando el Panel de instrumentos Push. Puede conmutar entre la modalidad de operaciones del servicio push - entre pruebas y producción utilizando la [API REST de Push](https://mobile.{DomainName}/imfpush/){: new_window}. De forma predeterminada, estará habilitada la modalidad de pruebas. Sin embargo, cuando se cambia entre modalidades, las etiquetas, los dispositivos y las suscripciones no se comparten entre estas modalidades. + +Cuando esté listo para desplegar la aplicación en un entorno activo, seleccione la modalidad PRODUCTION utilizando la [API REST de Push](https://mobile.{DomainName}/imfpush/){: new_window}. + +Para conmutar la modalidad de operación del servicio push de pruebas a producción: + +1. Utilice la llamada de la API PUT ApplicationID Settings REST +2. En el cuerpo de JSON, confirme que la modalidad se ha cambiado utilizando la llamada de la API [GET ApplicationID Settings REST](https://mobile.{DomainName}/imfpush/){: new_window}. La respuesta esperada es "mode": "PRODUCTION +```{ + "mode": "PRODUCTION" + } +``` + {: codeblock} +1. Una vez que se haya conmutado la modalidad del entorno, ejecute el código del cliente de nuevo para registrar el dispositivo en la modalidad de PRODUCTION. + +Para obtener información sobre la API REST, consulte [Utilización de API REST](t_restapi.html). diff --git a/services/mobilepush/nl/es/t_send_push_notifications.md b/services/mobilepush/nl/es/t_send_push_notifications.md index 19092c467..b1adbb57a 100755 --- a/services/mobilepush/nl/es/t_send_push_notifications.md +++ b/services/mobilepush/nl/es/t_send_push_notifications.md @@ -1,38 +1,38 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Envío de notificaciones push básicas -{: #push-send-notifications} -Última actualización: 11 de enero de 2017 -{: .last-updated} - -Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas (sin utilizar etiquetas, identificadores, cargas útiles adicionales o archivos de sonido). - -Para enviar notificaciones push básicas, siga los pasos enumerados: - -1. Seleccione **Enviar notificaciones** y elija la opción adecuada de **Enviar a**. - -**Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos suscritos a {{site.data.keyword.mobilepushshort}} recibirán notificaciones. - -![pantalla Notificaciones](images/tag_notification.jpg) -2. En el campo **Mensaje**, escriba el mensaje y pulse **Enviar**. - -3. Verifique que los dispositivos hayan recibido la notificación. En la imagen siguiente se muestra un recuadro de alerta en el que se maneja una {{site.data.keyword.mobilepushshort}} -en el primer plano en un dispositivo Android e iOS. - -![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) - -![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) - -En la captura de pantalla siguiente se muestra una {{site.data.keyword.mobilepushshort}} en segundo plano para Android. - -![Notificación push en el fondo en Android](images/background.jpg) +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Envío de notificaciones push básicas +{: #push-send-notifications} +Última actualización: 11 de enero de 2017 +{: .last-updated} + +Una vez que haya desarrollado sus aplicaciones, puede enviar notificaciones push básicas (sin utilizar etiquetas, identificadores, cargas útiles adicionales o archivos de sonido). + +Para enviar notificaciones push básicas, siga los pasos enumerados: + +1. Seleccione **Enviar notificaciones** y elija la opción adecuada de **Enviar a**. + +**Nota**: Cuando seleccione la opción **Todos los dispositivos**, todos los dispositivos suscritos a {{site.data.keyword.mobilepushshort}} recibirán notificaciones. + +![pantalla Notificaciones](images/tag_notification.jpg) +2. En el campo **Mensaje**, escriba el mensaje y pulse **Enviar**. + +3. Verifique que los dispositivos hayan recibido la notificación. En la imagen siguiente se muestra un recuadro de alerta en el que se maneja una {{site.data.keyword.mobilepushshort}} +en el primer plano en un dispositivo Android e iOS. + +![Notificación push en primer plano en Android](images/Android_Screenshot.jpg) + +![Notificación push en primer plano en iOS](images/iOS_Screenshot.jpg) + +En la captura de pantalla siguiente se muestra una {{site.data.keyword.mobilepushshort}} en segundo plano para Android. + +![Notificación push en el fondo en Android](images/background.jpg) diff --git a/services/mobilepush/nl/es/t_service_instance.md b/services/mobilepush/nl/es/t_service_instance.md index 0d080f66d..2152d769a 100644 --- a/services/mobilepush/nl/es/t_service_instance.md +++ b/services/mobilepush/nl/es/t_service_instance.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Creación de una instancia de servicio Push -{: #create-push-instance} - -Para comenzar con {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, cree en primer lugar una aplicación {{site.data.keyword.Bluemix}}; por ejemplo, una app Node.js. A continuación, cree una instancia de un servicio Push, {{site.data.keyword.mobilepushfull}}, que debe estar enlazada a esta aplicación Bluemix. También puede hacerlo yendo a la sección de Contenedor modelo del catálogo de Bluemix y pulsando el MobileFirst Services Starter. - -**Nota**: Si ha configurado organizaciones para gestionar el entorno, seleccione la organización en la que desea crear el tiempo de ejecución y los servicios para la app de móvil. - - -1. Si no tiene una aplicación Bluemix, debe crearla; por ejemplo, la app Node.js. Para crear una aplicación Bluemix, vaya al Panel de control de Bluemix y pulse **Crear app**. - - **Nota**: Si dispone de una aplicación, vaya al paso 7 para añadir un servicio.![Crear una instancia de servicio](images/create_service_instance1.jpg "Crear una instancia de servicio") - -1. Desde **Elija su plantilla de app**, pulse **WEB** - -3. En el área **Seleccionar punto de inicio**, seleccione **SDK para Node.js** y, a continuación, pulse **CONTINUAR**.![Punto de partida](images/create_service_nodejs2.jpg) - -4. Desde el menú desplegable **Espacio**, seleccione el espacio de la organización. - - ![ -Select organization space](images/create_a_service3.jpg) -1. En **Nombre**, especifique el nombre de la app y, en el host, especifique el nombre del host. - -1. Desde el menú desplegable **Plan seleccionado**, seleccione un plan y, a continuación, pulse el botón **CREATE**. Espere a que la aplicación se transfiera. - -1. Pulse el enlace **Visión general**.![Añadir un servicio](images/create_service_add4.jpg) -1. Pulse **Añadir un servicio**. Se mostrará la pantalla CATALOG. - -1. Seleccione **Notificaciones Push de IBM:** y, desde el menú desplegable **Espacio**, seleccione la organización. - - ![Menú desplegable del espacio de organización](images/create_service_org.jpg) -1. En el nombre **Servicio**, especifique el nombre de servicio de la Notificación Push. - -1. En el **Plan seleccionado**, seleccione un plan y pulse el botón **CREATE**. - -1. Pulse **Sí** para volver a transferir la aplicación. - - ![Servicio de notificaciones Push de IBM](images/create_service_notification5.jpg) - -1. Pulse **Notificaciones Push** para mostrar el panel de control Notificaciones Push. +--- + +copyright: + years: 2015, 2016 + +--- + +# Creación de una instancia de servicio Push +{: #create-push-instance} + +Para comenzar con {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, cree en primer lugar una aplicación {{site.data.keyword.Bluemix}}; por ejemplo, una app Node.js. A continuación, cree una instancia de un servicio Push, {{site.data.keyword.mobilepushfull}}, que debe estar enlazada a esta aplicación Bluemix. También puede hacerlo yendo a la sección de Contenedor modelo del catálogo de Bluemix y pulsando el MobileFirst Services Starter. + +**Nota**: Si ha configurado organizaciones para gestionar el entorno, seleccione la organización en la que desea crear el tiempo de ejecución y los servicios para la app de móvil. + + +1. Si no tiene una aplicación Bluemix, debe crearla; por ejemplo, la app Node.js. Para crear una aplicación Bluemix, vaya al Panel de control de Bluemix y pulse **Crear app**. + + **Nota**: Si dispone de una aplicación, vaya al paso 7 para añadir un servicio.![Crear una instancia de servicio](images/create_service_instance1.jpg "Crear una instancia de servicio") + +1. Desde **Elija su plantilla de app**, pulse **WEB** + +3. En el área **Seleccionar punto de inicio**, seleccione **SDK para Node.js** y, a continuación, pulse **CONTINUAR**.![Punto de partida](images/create_service_nodejs2.jpg) + +4. Desde el menú desplegable **Espacio**, seleccione el espacio de la organización. + + ![ +Select organization space](images/create_a_service3.jpg) +1. En **Nombre**, especifique el nombre de la app y, en el host, especifique el nombre del host. + +1. Desde el menú desplegable **Plan seleccionado**, seleccione un plan y, a continuación, pulse el botón **CREATE**. Espere a que la aplicación se transfiera. + +1. Pulse el enlace **Visión general**.![Añadir un servicio](images/create_service_add4.jpg) +1. Pulse **Añadir un servicio**. Se mostrará la pantalla CATALOG. + +1. Seleccione **Notificaciones Push de IBM:** y, desde el menú desplegable **Espacio**, seleccione la organización. + + ![Menú desplegable del espacio de organización](images/create_service_org.jpg) +1. En el nombre **Servicio**, especifique el nombre de servicio de la Notificación Push. + +1. En el **Plan seleccionado**, seleccione un plan y pulse el botón **CREATE**. + +1. Pulse **Sí** para volver a transferir la aplicación. + + ![Servicio de notificaciones Push de IBM](images/create_service_notification5.jpg) + +1. Pulse **Notificaciones Push** para mostrar el panel de control Notificaciones Push. diff --git a/services/mobilepush/nl/es/t_subscribe_tags.md b/services/mobilepush/nl/es/t_subscribe_tags.md index 7bdd191fe..67234f195 100644 --- a/services/mobilepush/nl/es/t_subscribe_tags.md +++ b/services/mobilepush/nl/es/t_subscribe_tags.md @@ -1,126 +1,126 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Suscripción y cancelación de la suscripción a las etiquetas -{: #Subscribe_tags} - -Utilice los siguientes fragmentos de código para permitir que los dispositivos obtengan suscripciones, se suscriban a una etiqueta y cancelen la suscripción de una etiqueta. - -## Android - -Copie y pegue este fragmento de código en la aplicación para móviles de Android. - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - -## Cordova - -Copie y pegue este fragmento de código en la aplicación para móviles de Cordova. - -``` -var tag = "YourTag"; -MFPPush.subscribe(tag, success, failure); -MFPPush.unsubscribe(tag, success, failure); -``` - -## Objective-C - -Copie y pegue este fragmento de código en la aplicación para móviles de Objective-C. - -Utilice la API **subscribeToTags** para suscribirse a una etiqueta. - -``` -[push subscribeToTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - }else{ - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response subscribeStatus]; - [self updateMessage:@"Parsed subscribe status is:"]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -Utilice la API **unsubscribeFromTags** para anular la suscripción a una etiqueta. - -``` -[push unsubscribeFromTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if (error){ - [self updateMessage:error.description]; - } else { - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response unsubscribeStatus]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -## Swift - -Copie y pegue este fragmento de código en la aplicación para móviles de Swift. - -**Suscribirse a etiquetas disponibles** - -Utilice la API **subscribeToTags** para suscribirse a una etiqueta. - -``` -push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in - if (error != nil) { - //error while subscribing to tags - } else { - //successfully subscribed to tags var subStatus = response.subscribeStatus(); - } -} -``` - -**Eliminar suscripción a etiquetas** - -Utilice la API **unsubscribeFromTags** para anular la suscripción a una etiqueta. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - - if error.isEmpty { - print( "Response during unsubscribed tags : \(response.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Suscripción y cancelación de la suscripción a las etiquetas +{: #Subscribe_tags} + +Utilice los siguientes fragmentos de código para permitir que los dispositivos obtengan suscripciones, se suscriban a una etiqueta y cancelen la suscripción de una etiqueta. + +## Android + +Copie y pegue este fragmento de código en la aplicación para móviles de Android. + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + +## Cordova + +Copie y pegue este fragmento de código en la aplicación para móviles de Cordova. + +``` +var tag = "YourTag"; +MFPPush.subscribe(tag, success, failure); +MFPPush.unsubscribe(tag, success, failure); +``` + +## Objective-C + +Copie y pegue este fragmento de código en la aplicación para móviles de Objective-C. + +Utilice la API **subscribeToTags** para suscribirse a una etiqueta. + +``` +[push subscribeToTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + }else{ + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response subscribeStatus]; + [self updateMessage:@"Parsed subscribe status is:"]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +Utilice la API **unsubscribeFromTags** para anular la suscripción a una etiqueta. + +``` +[push unsubscribeFromTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if (error){ + [self updateMessage:error.description]; + } else { + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response unsubscribeStatus]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +## Swift + +Copie y pegue este fragmento de código en la aplicación para móviles de Swift. + +**Suscribirse a etiquetas disponibles** + +Utilice la API **subscribeToTags** para suscribirse a una etiqueta. + +``` +push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in + if (error != nil) { + //error while subscribing to tags + } else { + //successfully subscribed to tags var subStatus = response.subscribeStatus(); + } +} +``` + +**Eliminar suscripción a etiquetas** + +Utilice la API **unsubscribeFromTags** para anular la suscripción a una etiqueta. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + + if error.isEmpty { + print( "Response during unsubscribed tags : \(response.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` diff --git a/services/mobilepush/nl/es/t_use_tags.md b/services/mobilepush/nl/es/t_use_tags.md index 88db7b364..c819d0fa4 100644 --- a/services/mobilepush/nl/es/t_use_tags.md +++ b/services/mobilepush/nl/es/t_use_tags.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Utilización de notificaciones basadas en etiquetas -{: #using_tags} - - -Las notificaciones basadas en etiquetas son mensajes de notificación que están pensados para todos los dispositivos suscritos a una etiqueta determinada. Cada dispositivo se puede suscribir a cualquier número de etiquetas. Esta sección describe cómo enviar notificaciones basadas en código. Las suscripciones las mantiene la instancia de Bluemix del servicio de notificaciones Push. Cuando una etiqueta se ha suprimido, toda la información asociada con dicha etiqueta, incluidos los suscriptores y los dispositivos, se suprimirán. No es necesaria ninguna anulación de la suscripción automática para esta etiqueta porque ya no existe y no es necesaria ninguna acción desde el lado del cliente. - -**Antes de empezar** - -Cree etiquetas en la pantalla **Etiquetas**. Para obtener más información sobre cómo crear etiquetas, consulte [Creación de etiquetas](t_manage_tags.html). - -1. Desde el panel de control de **Notificación Push**, pulse el separador **Notificaciones**. -1. Seleccione la opción **Etiquetas** a enviar mediante las notificaciones basadas en etiquetas. -1. En el campo **Búsqueda** de etiquetas, busque las etiquetas que desee utilizar y, a continuación, el botón **+Añadir**.![Pantalla de notificaciones](images/tag_notification.jpg) -1. Vaya al área **Crear sus notificaciones** y, en el campo **Texto del mensaje**, especifique texto que desee enviar en la notificación. -1. Pulse el botón **Enviar**. +--- + +copyright: + years: 2015, 2016 + +--- + +# Utilización de notificaciones basadas en etiquetas +{: #using_tags} + + +Las notificaciones basadas en etiquetas son mensajes de notificación que están pensados para todos los dispositivos suscritos a una etiqueta determinada. Cada dispositivo se puede suscribir a cualquier número de etiquetas. Esta sección describe cómo enviar notificaciones basadas en código. Las suscripciones las mantiene la instancia de Bluemix del servicio de notificaciones Push. Cuando una etiqueta se ha suprimido, toda la información asociada con dicha etiqueta, incluidos los suscriptores y los dispositivos, se suprimirán. No es necesaria ninguna anulación de la suscripción automática para esta etiqueta porque ya no existe y no es necesaria ninguna acción desde el lado del cliente. + +**Antes de empezar** + +Cree etiquetas en la pantalla **Etiquetas**. Para obtener más información sobre cómo crear etiquetas, consulte [Creación de etiquetas](t_manage_tags.html). + +1. Desde el panel de control de **Notificación Push**, pulse el separador **Notificaciones**. +1. Seleccione la opción **Etiquetas** a enviar mediante las notificaciones basadas en etiquetas. +1. En el campo **Búsqueda** de etiquetas, busque las etiquetas que desee utilizar y, a continuación, el botón **+Añadir**.![Pantalla de notificaciones](images/tag_notification.jpg) +1. Vaya al área **Crear sus notificaciones** y, en el campo **Texto del mensaje**, especifique texto que desee enviar en la notificación. +1. Pulse el botón **Enviar**. diff --git a/services/mobilepush/nl/es/tr_error_push.md b/services/mobilepush/nl/es/tr_error_push.md index e3439effb..30751cc2a 100644 --- a/services/mobilepush/nl/es/tr_error_push.md +++ b/services/mobilepush/nl/es/tr_error_push.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Mensajes de error del servicio {{site.data.keyword.mobilepushshort}} -{: #errors} -Última actualización: 13 de febrero de 2017 -{: .last-updated} - - -Se han devuelto los siguientes mensajes de error de {{site.data.keyword.mobilepushshort}} como respuesta a solicitudes de la API REST. - -Ejemplo de respuesta de un error: -``` - { - "message": "Missing APNs credentials", - "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", - "code": "FPWSE0003E" - } -``` - {: codeblock} - -Para obtener información adicional sobre un error, busque el código de error relacionado en la documentación. - -## FPWSE0001E -{: #error_fpwse0001e} - -**Explicación**: El recurso que está intentando consultar, como una etiqueta o suscripción, no está disponible en el servidor. - -**Respuesta del usuario**: Cree el recurso que ha notificado en el mensaje. Como alternativa, proporcione el identificador correcto para consultar el recurso. - - -## FPWSE0002E -{: #error_fpwse0002e} - -**Explicación**: El recurso que está intentado crear ya está disponible en el servidor. Puede que el recurso sea una etiqueta, una suscripción, etc. - -**Respuesta del usuario**: Cree el recurso con otro identificador. - - -## FPWSE0003E -{: #error_fpwse0003e} - -**Explicación**: La configuración de requisito previo para el servicio {{site.data.keyword.mobilepushshort}} no se ha completado. Es posible que esté intentando obtener las credenciales del servicio de notificaciones push de Apple (APNs) antes de que se hayan configurado. - -**Respuesta del usuario**: Asegúrese de que el servicio {{site.data.keyword.mobilepushshort}} se ha configurado con certificados de seguridad válidos para APNs. Para obtener más información, consulte el tema sobre [Configuración de credenciales para APNs ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](t_push_provider_ios.html){: new_window}. - - -## FPWSE0004E -{: #error_fpwse0004e} - -**Explicación**: El cuerpo de JSON incluido en la solicitud no es válido. - - -**Respuesta del usuario**: Asegúrese de utilizar una sintaxis válida de JSON en la solicitud. - - - -## FPWSE0005E -{: #error_fpwse0005e} - -**Explicación**: La solicitud del servidor de {{site.data.keyword.mobilepushshort}} no es correcto o está incompleto porque el cuerpo de JSON no contiene los valores de propiedad que se necesitan para completar la solicitud de API. Por ejemplo, una contraseña no es válida o falta una señal de dispositivo. - - -**Respuesta del usuario**: Revise el mensaje para saber qué valor de propiedad falta o no es válido y, a continuación, proporcione la información necesaria. - - - -## FPWSE0006E -{: #error_fpwse0006e} - -**Explicación**: El cuerpo de JSON de la solicitud tiene parámetros que el servidor de {{site.data.keyword.mobilepushshort}} no conoce. - - -**Respuesta del usuario**: Verifique que el cuerpo de JSON en la solicitud sigue el formato de la solicitud que espera el servidor {{site.data.keyword.mobilepushshort}}. Para obtener más información, consulte las [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0007E -{: #error_fpwse0007e} - -**Explicación**: El URL de solicitud tiene una serie de consulta que tiene parámetros no reconocidos. Por ejemplo, si la solicitud para suprimir la suscripción tiene parámetros distintos de deviceId y de tagName, se puede producir este error. - - -**Respuesta del usuario**: Verifique que el cuerpo de JSON en la solicitud sigue el formato de la solicitud que espera el servidor {{site.data.keyword.mobilepushshort}}. Para obtener más información, consulte las [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0008E -{: #error_fpwse0008e} - -**Explicación**: El URL de solicitud tiene una serie de consulta que tiene parámetros que faltan necesarios. Por ejemplo, los parámetros deviceId y tagName no se han incluido con la solicitud para suprimir la suscripción. - - -**Respuesta del usuario**: Verifique que el cuerpo de JSON en la solicitud sigue el formato de la solicitud que espera el servidor {{site.data.keyword.mobilepushshort}}. Para obtener más información, consulte las [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0009E -{: #error_fpwse0009e} - -**Explicación**: Se ha intentado enviar notificaciones dispositivos pero no se registran dispositivos con la aplicación. - -**Respuesta del usuario**: Asegúrese de que se han registrado los dispositivos con la aplicación antes de intentar enviar notificaciones. - - - -## FPWSE0010E -{: #error_fpwse0010e} - -**Explicación**: La solicitud que se ha enviado al servidor ha dado como resultado una condición de excepción. Una de las condiciones siguientes puede haber causado este error: - -- Un subsistema interno que {{site.data.keyword.mobilepushshort}} utiliza no responde. -- La solicitud ha producido una condición de error que quizás no pueda manejar {{site.data.keyword.mobilepushshort}}. -- El servicio {{site.data.keyword.mobilepushshort}} - requiere atención por parte del administrador. - -**Respuesta del usuario**: Vuelva a intentar la solicitud. Si el problema persiste, póngase en contacto con el soporte de software de IBM. - - - -## FPWSE0011E -{: #error_fpwse0011e} - -**Explicación**: La suscripción de la etiqueta ya existe en este servidor. Por ejemplo, cuando se crea una suscripción que ya existe. - -**Respuesta del usuario**: Cree la suscripción con un nombre de etiqueta único. - - - -## FPWSE0012E -{: #error_fpwse0012e} - -**Explicación**: La suscripción de la etiqueta no está en el servidor. Este error se produce cuando se envía una solicitud para recuperar o suprimir una suscripción que no existe. - - -**Respuesta del usuario**: Utilice el nombre de etiqueta correcta y el identificador del dispositivo en la solicitud. - - - -## FPWSE0013E -{: #error_fpwse0013e} - -**Explicación**: La carga útil de JSON en la solicitud no es válida. - - -**Respuesta del usuario**: Asegúrese de que la carga útil de JSON es válida. - - -## FPWSE0025E -{: #error_fpwse0025e} - -**Explicación**: El servidor no puede manejar la solicitud en este momento. - -**Respuesta del usuario**: Vuelva a enviar la solicitud más tarde. - - -## FPWSE1007E -{: #error_fpwse1007e} - -**Explicación**: Se ha inhabilitado el servicio de {{site.data.keyword.mobilepushshort}} para esta aplicación. Esto puede ser debido a la facturación o que el administrador ha inhabilitado la app. - - -**Respuesta del usuario**: Consulte los temas Resolución de problemas de la documentación de Bluemix para comprobar el estado del servicio, revisar la información sobre cómo solucionar problemas y obtener ayuda. - - - -## FPWSE1079E -{: #error_fpwse1079e} - -**Explicación**: El valor de desplazamiento que se ha proporcionado para la operación de consulta no es válido. - -**Respuesta del usuario**: Asegúrese de que el valor de desplazamiento es igual o mayor que cero. - - - -## FPWSE1080E -{: #error_fpwse1080e} - -**Explicación**: El valor del tamaño que se ha proporcionado para la operación de consulta no es válido. - -**Respuesta del usuario**: Asegúrese de que el valor del tamaño es mayor que cero. - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Mensajes de error del servicio {{site.data.keyword.mobilepushshort}} +{: #errors} +Última actualización: 13 de febrero de 2017 +{: .last-updated} + + +Se han devuelto los siguientes mensajes de error de {{site.data.keyword.mobilepushshort}} como respuesta a solicitudes de la API REST. + +Ejemplo de respuesta de un error: +``` + { + "message": "Missing APNs credentials", + "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", + "code": "FPWSE0003E" + } +``` + {: codeblock} + +Para obtener información adicional sobre un error, busque el código de error relacionado en la documentación. + +## FPWSE0001E +{: #error_fpwse0001e} + +**Explicación**: El recurso que está intentando consultar, como una etiqueta o suscripción, no está disponible en el servidor. + +**Respuesta del usuario**: Cree el recurso que ha notificado en el mensaje. Como alternativa, proporcione el identificador correcto para consultar el recurso. + + +## FPWSE0002E +{: #error_fpwse0002e} + +**Explicación**: El recurso que está intentado crear ya está disponible en el servidor. Puede que el recurso sea una etiqueta, una suscripción, etc. + +**Respuesta del usuario**: Cree el recurso con otro identificador. + + +## FPWSE0003E +{: #error_fpwse0003e} + +**Explicación**: La configuración de requisito previo para el servicio {{site.data.keyword.mobilepushshort}} no se ha completado. Es posible que esté intentando obtener las credenciales del servicio de notificaciones push de Apple (APNs) antes de que se hayan configurado. + +**Respuesta del usuario**: Asegúrese de que el servicio {{site.data.keyword.mobilepushshort}} se ha configurado con certificados de seguridad válidos para APNs. Para obtener más información, consulte el tema sobre [Configuración de credenciales para APNs ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](t_push_provider_ios.html){: new_window}. + + +## FPWSE0004E +{: #error_fpwse0004e} + +**Explicación**: El cuerpo de JSON incluido en la solicitud no es válido. + + +**Respuesta del usuario**: Asegúrese de utilizar una sintaxis válida de JSON en la solicitud. + + + +## FPWSE0005E +{: #error_fpwse0005e} + +**Explicación**: La solicitud del servidor de {{site.data.keyword.mobilepushshort}} no es correcto o está incompleto porque el cuerpo de JSON no contiene los valores de propiedad que se necesitan para completar la solicitud de API. Por ejemplo, una contraseña no es válida o falta una señal de dispositivo. + + +**Respuesta del usuario**: Revise el mensaje para saber qué valor de propiedad falta o no es válido y, a continuación, proporcione la información necesaria. + + + +## FPWSE0006E +{: #error_fpwse0006e} + +**Explicación**: El cuerpo de JSON de la solicitud tiene parámetros que el servidor de {{site.data.keyword.mobilepushshort}} no conoce. + + +**Respuesta del usuario**: Verifique que el cuerpo de JSON en la solicitud sigue el formato de la solicitud que espera el servidor {{site.data.keyword.mobilepushshort}}. Para obtener más información, consulte las [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0007E +{: #error_fpwse0007e} + +**Explicación**: El URL de solicitud tiene una serie de consulta que tiene parámetros no reconocidos. Por ejemplo, si la solicitud para suprimir la suscripción tiene parámetros distintos de deviceId y de tagName, se puede producir este error. + + +**Respuesta del usuario**: Verifique que el cuerpo de JSON en la solicitud sigue el formato de la solicitud que espera el servidor {{site.data.keyword.mobilepushshort}}. Para obtener más información, consulte las [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0008E +{: #error_fpwse0008e} + +**Explicación**: El URL de solicitud tiene una serie de consulta que tiene parámetros que faltan necesarios. Por ejemplo, los parámetros deviceId y tagName no se han incluido con la solicitud para suprimir la suscripción. + + +**Respuesta del usuario**: Verifique que el cuerpo de JSON en la solicitud sigue el formato de la solicitud que espera el servidor {{site.data.keyword.mobilepushshort}}. Para obtener más información, consulte las [API REST ![icono de enlace externo](../../icons/launch-glyph.svg "icono de enlace externo")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0009E +{: #error_fpwse0009e} + +**Explicación**: Se ha intentado enviar notificaciones dispositivos pero no se registran dispositivos con la aplicación. + +**Respuesta del usuario**: Asegúrese de que se han registrado los dispositivos con la aplicación antes de intentar enviar notificaciones. + + + +## FPWSE0010E +{: #error_fpwse0010e} + +**Explicación**: La solicitud que se ha enviado al servidor ha dado como resultado una condición de excepción. Una de las condiciones siguientes puede haber causado este error: + +- Un subsistema interno que {{site.data.keyword.mobilepushshort}} utiliza no responde. +- La solicitud ha producido una condición de error que quizás no pueda manejar {{site.data.keyword.mobilepushshort}}. +- El servicio {{site.data.keyword.mobilepushshort}} + requiere atención por parte del administrador. + +**Respuesta del usuario**: Vuelva a intentar la solicitud. Si el problema persiste, póngase en contacto con el soporte de software de IBM. + + + +## FPWSE0011E +{: #error_fpwse0011e} + +**Explicación**: La suscripción de la etiqueta ya existe en este servidor. Por ejemplo, cuando se crea una suscripción que ya existe. + +**Respuesta del usuario**: Cree la suscripción con un nombre de etiqueta único. + + + +## FPWSE0012E +{: #error_fpwse0012e} + +**Explicación**: La suscripción de la etiqueta no está en el servidor. Este error se produce cuando se envía una solicitud para recuperar o suprimir una suscripción que no existe. + + +**Respuesta del usuario**: Utilice el nombre de etiqueta correcta y el identificador del dispositivo en la solicitud. + + + +## FPWSE0013E +{: #error_fpwse0013e} + +**Explicación**: La carga útil de JSON en la solicitud no es válida. + + +**Respuesta del usuario**: Asegúrese de que la carga útil de JSON es válida. + + +## FPWSE0025E +{: #error_fpwse0025e} + +**Explicación**: El servidor no puede manejar la solicitud en este momento. + +**Respuesta del usuario**: Vuelva a enviar la solicitud más tarde. + + +## FPWSE1007E +{: #error_fpwse1007e} + +**Explicación**: Se ha inhabilitado el servicio de {{site.data.keyword.mobilepushshort}} para esta aplicación. Esto puede ser debido a la facturación o que el administrador ha inhabilitado la app. + + +**Respuesta del usuario**: Consulte los temas Resolución de problemas de la documentación de Bluemix para comprobar el estado del servicio, revisar la información sobre cómo solucionar problemas y obtener ayuda. + + + +## FPWSE1079E +{: #error_fpwse1079e} + +**Explicación**: El valor de desplazamiento que se ha proporcionado para la operación de consulta no es válido. + +**Respuesta del usuario**: Asegúrese de que el valor de desplazamiento es igual o mayor que cero. + + + +## FPWSE1080E +{: #error_fpwse1080e} + +**Explicación**: El valor del tamaño que se ha proporcionado para la operación de consulta no es válido. + +**Respuesta del usuario**: Asegúrese de que el valor del tamaño es mayor que cero. + + + diff --git a/services/mobilepush/nl/es/troubleshooting.md b/services/mobilepush/nl/es/troubleshooting.md index 42f0d28b6..304f599a2 100755 --- a/services/mobilepush/nl/es/troubleshooting.md +++ b/services/mobilepush/nl/es/troubleshooting.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Resolución de problemas -{: #errors} -Última actualización: 11 de enero de 2017 -{: .last-updated} - -Utilice esta sección como guía para la resolución de problemas comunes de {{site.data.keyword.mobilepushshort}}. - - -### Se ha producido un error de servidor interno. Póngase en contacto con el administrador. (Código de error interno: PUSHD102E) - -**Explicación**: Este error puede producirse si ha creado una instancia de push antes de noviembre de 2015. - -**Respuesta del usuario**: Para resolver el problema, suprima la instancia push y cree una nueva. Tenga en cuenta que cuando suprima la instancia de push, sus etiquetas no se conservarán. - - -### UnauthorizedRegistration - -**Explicación**: Chrome Web Push no funciona con claves de Firebase Cloud Messaging (FCM). Si no puede recibir notificaciones push web en Chrome después de pasar de FCM a GCM, se debe a que el sitio web estaba configurado anteriormente para trabajar con el proyecto GCM y el nuevo proyecto se ha creado en FCM. El navegador Chrome coloca en la memoria caché las señales generadas que identifican el navegador. - -**Respuesta del usuario**: Para solucionar este problema, elimine las cookies y restablezca los permisos del navegador. Este solicitará permisos para habilitar las notificaciones push. - - -### No se admiten trabajadores de servicio en este navegador - -**Explicación**: El SDK incluido como parte de `BMSPushSDK.js` que utiliza el trabajador de servicio no está disponible. - -**Respuesta del usuario**: Se recomienda cambiar a un navegador que admita el trabajador de servicio. Las versiones admitidas de los navegadores son Firefox versión 49 o posteriores y Chrome versión 53 (64 bits) o posteriores. - - -### SecurityError: La operación no es segura - -**Explicación**: Es posible que aparezca un error al habilitar la consola web en Firefox. El soporte de push de web en el servicio de notificación Push requiere que se acceda al sitio web con el protocolo `https`, no con `http`. - -**Respuesta del usuario**: Se recomienda intentar conectar con el sitio web mediante `https` desde el navegador. - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Resolución de problemas +{: #errors} +Última actualización: 11 de enero de 2017 +{: .last-updated} + +Utilice esta sección como guía para la resolución de problemas comunes de {{site.data.keyword.mobilepushshort}}. + + +### Se ha producido un error de servidor interno. Póngase en contacto con el administrador. (Código de error interno: PUSHD102E) + +**Explicación**: Este error puede producirse si ha creado una instancia de push antes de noviembre de 2015. + +**Respuesta del usuario**: Para resolver el problema, suprima la instancia push y cree una nueva. Tenga en cuenta que cuando suprima la instancia de push, sus etiquetas no se conservarán. + + +### UnauthorizedRegistration + +**Explicación**: Chrome Web Push no funciona con claves de Firebase Cloud Messaging (FCM). Si no puede recibir notificaciones push web en Chrome después de pasar de FCM a GCM, se debe a que el sitio web estaba configurado anteriormente para trabajar con el proyecto GCM y el nuevo proyecto se ha creado en FCM. El navegador Chrome coloca en la memoria caché las señales generadas que identifican el navegador. + +**Respuesta del usuario**: Para solucionar este problema, elimine las cookies y restablezca los permisos del navegador. Este solicitará permisos para habilitar las notificaciones push. + + +### No se admiten trabajadores de servicio en este navegador + +**Explicación**: El SDK incluido como parte de `BMSPushSDK.js` que utiliza el trabajador de servicio no está disponible. + +**Respuesta del usuario**: Se recomienda cambiar a un navegador que admita el trabajador de servicio. Las versiones admitidas de los navegadores son Firefox versión 49 o posteriores y Chrome versión 53 (64 bits) o posteriores. + + +### SecurityError: La operación no es segura + +**Explicación**: Es posible que aparezca un error al habilitar la consola web en Firefox. El soporte de push de web en el servicio de notificación Push requiere que se acceda al sitio web con el protocolo `https`, no con `http`. + +**Respuesta del usuario**: Se recomienda intentar conectar con el sitio web mediante `https` desde el navegador. + diff --git a/services/mobilepush/nl/es/troubleshooting_config_errors.md b/services/mobilepush/nl/es/troubleshooting_config_errors.md index 80c62bec5..4ffe58088 100644 --- a/services/mobilepush/nl/es/troubleshooting_config_errors.md +++ b/services/mobilepush/nl/es/troubleshooting_config_errors.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Resolución de errores de configuración de push web -{: #errors} -Última actualización: 11 de enero de 2017 -{: .last-updated} - -Utilice esta sección como guía para la resolución de errores frecuentes relacionados con la configuración de push web. Los errores de push web procedentes de `BMSPushSDK.js` contienen información sobre el error. - -Para analizar un error devuelto en callback, observe el siguiente código de ejemplo: - -``` -function showStatus(response) { - if(response.statusCode == 200 || response.statusCode == 201) { - document.getElementById("status").innerHTML = "Response is " + response.response; - } - else if(response.statusCode == 0) { - if(response.response) { - document.getElementById("status").innerHTML = response.response; - } - else { - document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; - } - } - else { - document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " - + response.error + " and the status code " + response.statusCode; - } - } -``` - {: codeblock} - - -- Si `applicationId` no está correctamente configurado, la solicitud inicial al servicio {{site.data.keyword.mobilepushshort}} fallará, por lo que statusCode se establecerá en cero (0). -- El código de estado 200 ó 201 indica una respuesta satisfactoria. -- En el caso de que `clientSecret` no sea válido, se establecerá la respuesta 401 en statusCode. El elemento `response.reponse` contendrá la descripción del error. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Resolución de errores de configuración de push web +{: #errors} +Última actualización: 11 de enero de 2017 +{: .last-updated} + +Utilice esta sección como guía para la resolución de errores frecuentes relacionados con la configuración de push web. Los errores de push web procedentes de `BMSPushSDK.js` contienen información sobre el error. + +Para analizar un error devuelto en callback, observe el siguiente código de ejemplo: + +``` +function showStatus(response) { + if(response.statusCode == 200 || response.statusCode == 201) { + document.getElementById("status").innerHTML = "Response is " + response.response; + } + else if(response.statusCode == 0) { + if(response.response) { + document.getElementById("status").innerHTML = response.response; + } + else { + document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; + } + } + else { + document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " + + response.error + " and the status code " + response.statusCode; + } + } +``` + {: codeblock} + + +- Si `applicationId` no está correctamente configurado, la solicitud inicial al servicio {{site.data.keyword.mobilepushshort}} fallará, por lo que statusCode se establecerá en cero (0). +- El código de estado 200 ó 201 indica una respuesta satisfactoria. +- En el caso de que `clientSecret` no sea válido, se establecerá la respuesta 401 en statusCode. El elemento `response.reponse` contendrá la descripción del error. diff --git a/services/mobilepush/nl/fr/c_advance_notifications.md b/services/mobilepush/nl/fr/c_advance_notifications.md index 48dae2eb4..df11da858 100644 --- a/services/mobilepush/nl/fr/c_advance_notifications.md +++ b/services/mobilepush/nl/fr/c_advance_notifications.md @@ -1,12 +1,12 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# Activation des notifications push avancées -{: #push-advanced-notifications-main} - -Configurez un badge iOS, un son, un contenu JSON supplémentaire, des notifications interactives et la conservation des notifications. +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# Activation des notifications push avancées +{: #push-advanced-notifications-main} + +Configurez un badge iOS, un son, un contenu JSON supplémentaire, des notifications interactives et la conservation des notifications. diff --git a/services/mobilepush/nl/fr/c_android_enable.md b/services/mobilepush/nl/fr/c_android_enable.md index 1d7b393a4..26491f669 100644 --- a/services/mobilepush/nl/fr/c_android_enable.md +++ b/services/mobilepush/nl/fr/c_android_enable.md @@ -1,359 +1,359 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Activation des applications Android pour recevoir des notifications de type {{site.data.keyword.mobilepushshort}} -{: #tag_based_notifications} -Dernière mise à jour : 14 février 2017 -{: .last-updated} - -Vous pouvez activer des applications Android pour recevoir des notifications push sur vos appareils. Android Studio, qui est un prérequis, est la méthode recommandée pour générer des projets Android. Une connaissance de base d'Android Studio est essentielle. - -## Installation du logiciel SDK Push du client à l'aide de Gradle -{: #android_install} - -Cette section explique comment installer et utiliser le logiciel SDK Push du client afin de développer davantage vos applications Android. - -Le logiciel SDK Push de Bluemix® Mobile Services peut être ajouté en utilisant Gradle. Gradle télécharge automatiquement des artefacts depuis des référentiels et les met à la disposition de votre application Android. Assurez-vous de configurer correctement Android Studio et le logiciel SDK Android Studio. Pour plus d'informations sur la configuration de votre système, accédez au site [Android Studio Overview ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://developer.android.com/tools/studio/index.html){: new_window}. Pour plus d'informations sur Gradle, accédez au site [Configuring Gradle Builds ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}. - -Après avoir créé et ouvert votre application mobile, effectuez les étapes suivantes à l'aide d'Android Studio. - -1. Ajoutez des dépendances à votre fichier **build.gradle** de niveau Module. - - - Ajoutez la dépendance suivante pour inclure le logiciel SDK Push du client Bluemix™ Mobile Services et le logiciel SDK des services Google Play à vos dépendances de compilation. - ``` - com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ - ``` - {: codeblock} - - - Ajoutez les dépendances suivantes pour importer des instructions qui sont requises pour les fragments de code. - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - {: codeblock} - - - Ajoutez la dépendance suivante à la fin de votre fichier de niveau Module **build.gradle**. - ``` - apply plugin: 'com.google.gms.google-services' - ``` - {: codeblock} -3. Ajoutez les dépendances suivantes à votre fichier **build.gradle** de niveau Projet. -``` -dependencies { - classpath 'com.android.tools.build:gradle:2.2.3' - classpath 'com.google.gms:google-services:3.0.0' -} -``` - {: codeblock} -5. Dans le fichier **AndroidManifest.xml**, ajoutez les droits ci-dessous. Pour consulter un exemple de manifeste, accédez au site [Android helloPush Sample Application ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}. Pour consulter un exemple de fichier Gradle, accédez au site [Sample Build Gradle file ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}. -``` - - - - - -``` - {: codeblock} -Pour plus d'informations sur les autorisations Android, visitez le site [Android permissions ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/guide/topics/security/permissions.html){: new_window}. -4. Ajoutez les paramètres d'intention de notification pour l'activité. Ce paramètre démarre l'application lorsque l'utilisateur clique sur la notification reçue dans la zone de notification. -``` - - - - -``` - {: codeblock} -**Remarque** : remplacez *Your_Android_Package_Name* dans l'action précédente par le nom du package d'applications utilisé dans votre application. - -5. Ajoutez le service d'intention FCM (Firebase Cloud Messaging) ou GCM (Google Cloud Messaging) et des filtres d'intention pour les notifications d'événements RECEIVE et REGISTRATION. -``` - - - - - - - - - - -``` - {: codeblock} - -6. Le service {{site.data.keyword.mobilepushshort}} prend en charge l'extraction des notifications individuelles depuis la zone de notification. Pour les notifications atteintes à partir de la zone de notification, un descripteur ne vous est fourni que pour la notification sur laquelle vous cliquez. Toutes les notifications s'affichent quand l'application est ouverte normalement. Mettez à jour votre fichier **AndroidManifest.xml** avec le fragment de code ci-après pour utiliser cette fonctionnalité : - -``` - -``` - {: codeblock} - -Pour configurer le projet FCM et obtenir vos données d'identification, consultez [Obtention de votre ID d'émetteur et de la clé d'API](t_push_provider_android.html). Effectuez les étapes suivantes à l'aide de la console FCM (Firebase Cloud Messaging). - -1. Dans la console Firebase, cliquez sur l'icône **Project Settings**. - ![Paramètres du projet Firebase](images/FCM_4.jpg) - -3. Sélectionnez l'icône **ADD APP** ou **Add Firebase to your Android app** dans l'onglet General du volet Your apps. - ![Ajout de Firebase à Android](images/FCM_5.jpg) - -4. Dans la fenêtre Add Firebase to your Android app, ajoutez **com.ibm.mobilefirstplatform.clientsdk.android.push** en tant que nom du package. La zone App nickname est facultative. Cliquez sur **Ajouter une application**. - ![Ajout de Firebase à votre fenêtre Android](images/FCM_1.jpg) - -5. Incluez le nom de package de votre application en l'entrant dans la fenêtre Add Firebase to your Android app. La zone App nickname est facultative. Cliquez sur **Ajouter une application**. - - ![Ajout du nom de package de votre application](images/FCM_2.jpg) - -6. Le fichier `google-services.json` est généré. Copiez le fichier `google-services.json` dans le répertoire racine de votre module d'application Android. Vous pouvez constater que le fichier `google-service.json` inclut les noms de packages que vous avez ajouté. - - ![Ajout du fichier json au répertoire racine de votre application](images/FCM_7.jpg) - -5. Dans la fenêtre Add Firebase to your Android app, cliquez sur **Continuer**, puis sur **Terminer**. - - - -Générez et exécutez votre application. - -## Initialisation du logiciel SDK Push pour les applis Android -{: #android_initialize} - -Le code d'initialisation se trouve généralement dans la méthode onCreate de l'activité principale de votre application Android. Deux composants du logiciel SDK doivent être initialisés. Le premier est le logiciel SDK de base et l'autre, le logiciel SDK push qui repose sur le premier. - -###Initialisation du logiciel SDK de base - -``` -// Initialisation du SDK pour Android - BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); -``` - {: codeblock} - -####bluemixRegionSuffix -{: bluemixRegionSuffix} - -Indique l'emplacement où l'appli est hébergée. Vous pouvez utiliser l'une des trois valeurs suivantes : - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -###Initialisation du logiciel SDK Push du client - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext(), "appGUID", "clientSecret"); -``` - {: codeblock} - -####AppGUID -{: appguid_initialize_client_push_sdk} - -Il s'agit de la clé AppGUID du service {{site.data.keyword.mobilepushshort}}. Cette valeur est sensible à la casse. Ouvrez le tableau de bord de notification push et sélectionnez l'onglet de configuration. Vous pouvez obtenir cette valeur depuis Options pour application mobile, à partir de l'onglet de configuration du tableau de bord du service Push Notifications. - -## Enregistrement d'appareils Android -{: #android_register} - -Utilisez l'API `MFPPush.register()` pour enregistrer l'appareil auprès du service {{site.data.keyword.mobilepushshort}}. Pour enregistrer des appareils Android, ajoutez les informations FCM (Firebase Cloud Messaging) et GCM (Google Cloud Messaging (GCM) dans le tableau de bord de configuration du service {{site.data.keyword.mobilepushshort}} Bluemix. Pour plus d'informations, voir [Configuration de données d'identification pour Google Cloud Messaging](t_push_provider_android.html). - -Copiez les fragments de code suivants dans votre application mobile Android. - -``` - //Enregistrement d'appareils Android - push.registerDevice(new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - //Traitement en cas de réussite - } - @Override - public void onFailure(MFPPushException ex) { - //Traitement en cas d'échec - } - }); -``` - {: codeblock} - - -``` - //Traitement de la notification à son arrivée - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Traitement de la notification Push - } - }; -``` - {: codeblock} - -## Réception de notifications push sur des appareils Android -{: #android_receive} - -Pour enregistrer l'objet notificationListener auprès de push, appelez la méthode **MFPPush.listen()**. En général, elle est appelée depuis la méthode **onResume()** de l'activité qui traite les notifications push. - -1. Pour enregistrer l'objet notificationListener auprès de push, appelez la méthode **listen()**. En général, elle est appelée depuis les méthodes **onResume()** et **onPause** de l'activité qui traite les notifications push. - - -``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` - {: codeblock} - - - -``` - @Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} - -2. Générez le projet et exécutez-le sur l'appareil ou l'émulateur. Quand la méthode onSuccess() pour le programme d'écoute des réponses dans la méthode register() est appelée, cela signifie que l'appareil a été enregistré auprès du service {{site.data.keyword.mobilepushshort}}. A ce stade, vous pouvez envoyer un message comme décrit dans la rubrique Envoi de notifications push de base. -3. Vérifiez que vos appareils ont reçu votre notification. Si l'application se trouve au premier-plan, la notification est traitée par **MFPPushNotificationListener**. Si elle se trouve en arrière-plan, un message est affiché dans la barre de notification. - -## Suivi des notifications push sur les appareils Android -{: #android_monitor} - -Pour surveillance du statut actuel de la notification dans l'application, vous pouvez implémenter l'interface `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` et définir la méthode onStatusChange(String messageId, MFPPushNotificationStatus status). - -Le **messageId** est l'identificateur du message envoyé depuis le serveur. **MFPPushNotificationStatus** définit le statut des notifications sous forme de valeurs : - -- **RECEIVED** - L'application a reçu la notification. -- **QUEUED** - L'application place en file d'attente la notification pour appel du programme d'écoute des notifications. -- **OPENED** - L'utilisateur ouvre la notification en cliquant sur celle-ci dans le bac ou en la lançant depuis l'icône d'application ou lorsque l'application est à l'avant-plan. -- **DISMISSED** - L'utilisateur supprime/rejette la notification dans le bac. - -Vous devez enregistrer la classe **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** auprès de MFPPush. - -``` - push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { - @Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { - // Handle status change -} - }); -``` - {: codeblock} - - -### Ecoute du statut DISMISSED (rejeté) - -Vous pouvez opter d'être à l'écoute du statut DISMISSED sous l'une des conditions suivantes : - -- Lorsque l'application est active (opérant en avant ou en arrière-plan) - - Ajoutez ce fragment de code à votre fichier `AndroidManifest.xml` : - -``` - - - - - -``` - {: codeblock} - -- Lorsque l'application est à la fois active (opérant en avant ou en arrière-plan) et non en opération (fermée) - -Vous devez étendre le récepteur de diffusion **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** et redéfinir la méthode **onReceive()**, où **MFPPushNotificationStatusListener** doit être enregistré avant d'appeler la méthode **onReceive()** de la classe de base. - -``` - public class MyDismissHandler extends MFPPushNotificationDismissHandler { - @Override -public void onReceive(Context context, Intent intent) { - MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { - @Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { - // Handle status change -} - }); -super.onReceive(context, intent); -} - } -``` - {: codeblock} - - -Ajoutez le fragment de code suivant à votre fichier `AndroidManifest.xml` : - -``` - - - - - -``` - {: codeblock} - -## Envoi des notifications de type {{site.data.keyword.mobilepushshort}} de base -{: #send} - -Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base. - -Pour envoyer des notifications push de base, procédez comme suit : - -1. Sélectionnez **Envoyer des notifications** et rédigez un message en choisissant une option **Envoyer à**. Les options prises en charge sont **Appareil par étiquette**, **ID de l'appareil**, **ID utilisateur**, **Appareils Android**, **Appareils IOS**, **Notifications Web** et **Tous les appareils**. -**Remarque **: si vous sélectionnez l'option **Tous les appareils**, tous les appareils qui sont abonnés à des notifications de type {{site.data.keyword.mobilepushshort}} recevront les notifications. -![Ecran Notifications](images/tag_notification.jpg) - -2. Dans la zone **Message**, composez votre message. Configurez les paramètres facultatifs, selon les besoins. -3. Cliquez sur **Envoyer**. -3. Vérifiez que vos appareils ont reçu votre notification. - -La capture d'écran suivante présente une boîte d'alerte relative à une notification push s'exécutant au premier plan sur un appareil Android. - -![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) - -La capture d'écran suivante présente une notification push qui s'exécute en arrière-plan sur un appareil Android. - -![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) - -### Paramètres Android facultatifs pour envoi de notifications -{: #send_otpional_setting} - -Vous pouvez personnaliser les paramètres de type {{site.data.keyword.mobilepushshort}} pour l'envoi de notifications vers des appareils Android. Les options de personnalisation facultative suivantes sont prises en charge. -![Paramètres Android personnalisés](images/android_custom_settings.jpg) - -- **Touche de réduction** : des touches de réduction sont attachées aux notifications. Si plusieurs notifications arrivent séquentiellement avec la même touche de réduction quand l'appareil est hors ligne, elles sont réduites. Quand un appareil passe en ligne, il reçoit des notifications du serveur FCM/GCM et n'affiche que la dernière notification portant la même touche de réduction. Si aucune touche de réduction n'est définie, les nouveaux et les anciens messages sont stockés pour une distribution future. -- **Son** : indique le clip audio à exécuter à réception d'une notification. Prend en charge le fichier par défaut ou utilise le nom de la ressource audio intégré dans l'application. -- **Icône** : spécifie le nom de l'icône à afficher pour la notification. Assurez-vous de bien avoir placé l'icône dans le dossier res/drawable, avec l'application client. -- **Priorité** : spécifie les options d'affectation de la priorité de distribution aux messages. Une priorité `élevée` ou `max` générera des notifications d'alerte, tandis que des messages dont la priorité est à `faible` ou `par défaut` n'ouvriront pas les connexions réseau sur un appareil en veille. Pour les messages dont l'option a été définie à `min`, une notification silencieuse sera émise. -- **Visibilité** : vous pouvez choisir de définir l'option de visibilité de notification sur `public` ou `privé`. L'option `privé` limite l'affichage public ; vous pouvez choisir de l'activer si votre appareil est sécurisé avec un code ou un numéro confidentiel et que le paramètre de notification est défini sur "Masquer le contenu sensible de la notification". Quand la visibilité est configurée sur `privé`, une zone "occulter" doit être mentionnée. Seul le contenu spécifié dans la zone "occulter" s'affichera sur l'écran verrouillé et sécurisé de l'appareil. L'option `public` permet une lecture libre des notifications. -- **Durée de vie** : cette valeur est définie en secondes. Si ce paramètre n'est pas spécifié, le serveur FCM/GCM stocke le message pendant quatre semaines et tente de le distribuer. La validité expire après quatre semaines. La plage des valeurs possibles va de 0 à 2419200 secondes. -- ****Retarder si inactif : en définissant cette valeur à `true`, vous demandez au serveur FCM/GCM de ne pas distribuer de notification si le serveur est inactif. Définissez cette valeur à `false` pour garantir la distribution de la notification même si l'appareil est en veille. -- **Sync**: quand cette option est définie à `true`, les notifications figurant sur tous vos appareils enregistrés sont synchronisés. Si l'utilisateur identifié par un nom d'utilisateur qui lui est propre dispose de plusieurs appareils avec la même application installée, la lecture de la notification sur un appareil garantit une suppression des notifications sur les autres appareils. Vous devez vérifier que vous êtes enregistré auprès du service {{site.data.keyword.mobilepushshort}} avec le bon ID utilisateur pour que cette option fonctionne. -- **Contenu supplémentaire** : spécifie les valeurs de contenu personnalisées pour vos notifications. - - -## Etapes suivantes -{: #next_steps_tags} - -Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options avancées. - -Ajoutez ces fonctions de service de notifications push à votre application. -Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). -Pour utiliser des options de notification avancées, voir [Activation des notifications push avancées](t_advance_badge_sound_payload.html). +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Activation des applications Android pour recevoir des notifications de type {{site.data.keyword.mobilepushshort}} +{: #tag_based_notifications} +Dernière mise à jour : 14 février 2017 +{: .last-updated} + +Vous pouvez activer des applications Android pour recevoir des notifications push sur vos appareils. Android Studio, qui est un prérequis, est la méthode recommandée pour générer des projets Android. Une connaissance de base d'Android Studio est essentielle. + +## Installation du logiciel SDK Push du client à l'aide de Gradle +{: #android_install} + +Cette section explique comment installer et utiliser le logiciel SDK Push du client afin de développer davantage vos applications Android. + +Le logiciel SDK Push de Bluemix® Mobile Services peut être ajouté en utilisant Gradle. Gradle télécharge automatiquement des artefacts depuis des référentiels et les met à la disposition de votre application Android. Assurez-vous de configurer correctement Android Studio et le logiciel SDK Android Studio. Pour plus d'informations sur la configuration de votre système, accédez au site [Android Studio Overview ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://developer.android.com/tools/studio/index.html){: new_window}. Pour plus d'informations sur Gradle, accédez au site [Configuring Gradle Builds ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}. + +Après avoir créé et ouvert votre application mobile, effectuez les étapes suivantes à l'aide d'Android Studio. + +1. Ajoutez des dépendances à votre fichier **build.gradle** de niveau Module. + + - Ajoutez la dépendance suivante pour inclure le logiciel SDK Push du client Bluemix™ Mobile Services et le logiciel SDK des services Google Play à vos dépendances de compilation. + ``` + com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ + ``` + {: codeblock} + + - Ajoutez les dépendances suivantes pour importer des instructions qui sont requises pour les fragments de code. + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + {: codeblock} + + - Ajoutez la dépendance suivante à la fin de votre fichier de niveau Module **build.gradle**. + ``` + apply plugin: 'com.google.gms.google-services' + ``` + {: codeblock} +3. Ajoutez les dépendances suivantes à votre fichier **build.gradle** de niveau Projet. +``` +dependencies { + classpath 'com.android.tools.build:gradle:2.2.3' + classpath 'com.google.gms:google-services:3.0.0' +} +``` + {: codeblock} +5. Dans le fichier **AndroidManifest.xml**, ajoutez les droits ci-dessous. Pour consulter un exemple de manifeste, accédez au site [Android helloPush Sample Application ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}. Pour consulter un exemple de fichier Gradle, accédez au site [Sample Build Gradle file ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}. +``` + + + + + +``` + {: codeblock} +Pour plus d'informations sur les autorisations Android, visitez le site [Android permissions ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/guide/topics/security/permissions.html){: new_window}. +4. Ajoutez les paramètres d'intention de notification pour l'activité. Ce paramètre démarre l'application lorsque l'utilisateur clique sur la notification reçue dans la zone de notification. +``` + + + + +``` + {: codeblock} +**Remarque** : remplacez *Your_Android_Package_Name* dans l'action précédente par le nom du package d'applications utilisé dans votre application. + +5. Ajoutez le service d'intention FCM (Firebase Cloud Messaging) ou GCM (Google Cloud Messaging) et des filtres d'intention pour les notifications d'événements RECEIVE et REGISTRATION. +``` + + + + + + + + + + +``` + {: codeblock} + +6. Le service {{site.data.keyword.mobilepushshort}} prend en charge l'extraction des notifications individuelles depuis la zone de notification. Pour les notifications atteintes à partir de la zone de notification, un descripteur ne vous est fourni que pour la notification sur laquelle vous cliquez. Toutes les notifications s'affichent quand l'application est ouverte normalement. Mettez à jour votre fichier **AndroidManifest.xml** avec le fragment de code ci-après pour utiliser cette fonctionnalité : + +``` + +``` + {: codeblock} + +Pour configurer le projet FCM et obtenir vos données d'identification, consultez [Obtention de votre ID d'émetteur et de la clé d'API](t_push_provider_android.html). Effectuez les étapes suivantes à l'aide de la console FCM (Firebase Cloud Messaging). + +1. Dans la console Firebase, cliquez sur l'icône **Project Settings**. + ![Paramètres du projet Firebase](images/FCM_4.jpg) + +3. Sélectionnez l'icône **ADD APP** ou **Add Firebase to your Android app** dans l'onglet General du volet Your apps. + ![Ajout de Firebase à Android](images/FCM_5.jpg) + +4. Dans la fenêtre Add Firebase to your Android app, ajoutez **com.ibm.mobilefirstplatform.clientsdk.android.push** en tant que nom du package. La zone App nickname est facultative. Cliquez sur **Ajouter une application**. + ![Ajout de Firebase à votre fenêtre Android](images/FCM_1.jpg) + +5. Incluez le nom de package de votre application en l'entrant dans la fenêtre Add Firebase to your Android app. La zone App nickname est facultative. Cliquez sur **Ajouter une application**. + + ![Ajout du nom de package de votre application](images/FCM_2.jpg) + +6. Le fichier `google-services.json` est généré. Copiez le fichier `google-services.json` dans le répertoire racine de votre module d'application Android. Vous pouvez constater que le fichier `google-service.json` inclut les noms de packages que vous avez ajouté. + + ![Ajout du fichier json au répertoire racine de votre application](images/FCM_7.jpg) + +5. Dans la fenêtre Add Firebase to your Android app, cliquez sur **Continuer**, puis sur **Terminer**. + + + +Générez et exécutez votre application. + +## Initialisation du logiciel SDK Push pour les applis Android +{: #android_initialize} + +Le code d'initialisation se trouve généralement dans la méthode onCreate de l'activité principale de votre application Android. Deux composants du logiciel SDK doivent être initialisés. Le premier est le logiciel SDK de base et l'autre, le logiciel SDK push qui repose sur le premier. + +### Initialisation du logiciel SDK de base + +``` +// Initialisation du SDK pour Android + BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); +``` + {: codeblock} + +#### bluemixRegionSuffix +{: bluemixRegionSuffix} + +Indique l'emplacement où l'appli est hébergée. Vous pouvez utiliser l'une des trois valeurs suivantes : + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +### Initialisation du logiciel SDK Push du client + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext(), "appGUID", "clientSecret"); +``` + {: codeblock} + +#### AppGUID +{: appguid_initialize_client_push_sdk} + +Il s'agit de la clé AppGUID du service {{site.data.keyword.mobilepushshort}}. Cette valeur est sensible à la casse. Ouvrez le tableau de bord de notification push et sélectionnez l'onglet de configuration. Vous pouvez obtenir cette valeur depuis Options pour application mobile, à partir de l'onglet de configuration du tableau de bord du service Push Notifications. + +## Enregistrement d'appareils Android +{: #android_register} + +Utilisez l'API `MFPPush.register()` pour enregistrer l'appareil auprès du service {{site.data.keyword.mobilepushshort}}. Pour enregistrer des appareils Android, ajoutez les informations FCM (Firebase Cloud Messaging) et GCM (Google Cloud Messaging (GCM) dans le tableau de bord de configuration du service {{site.data.keyword.mobilepushshort}} Bluemix. Pour plus d'informations, voir [Configuration de données d'identification pour Google Cloud Messaging](t_push_provider_android.html). + +Copiez les fragments de code suivants dans votre application mobile Android. + +``` + //Enregistrement d'appareils Android + push.registerDevice(new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + //Traitement en cas de réussite + } + @Override + public void onFailure(MFPPushException ex) { + //Traitement en cas d'échec + } + }); +``` + {: codeblock} + + +``` + //Traitement de la notification à son arrivée + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Traitement de la notification Push + } + }; +``` + {: codeblock} + +## Réception de notifications push sur des appareils Android +{: #android_receive} + +Pour enregistrer l'objet notificationListener auprès de push, appelez la méthode **MFPPush.listen()**. En général, elle est appelée depuis la méthode **onResume()** de l'activité qui traite les notifications push. + +1. Pour enregistrer l'objet notificationListener auprès de push, appelez la méthode **listen()**. En général, elle est appelée depuis les méthodes **onResume()** et **onPause** de l'activité qui traite les notifications push. + + +``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` + {: codeblock} + + + +``` + @Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} + +2. Générez le projet et exécutez-le sur l'appareil ou l'émulateur. Quand la méthode onSuccess() pour le programme d'écoute des réponses dans la méthode register() est appelée, cela signifie que l'appareil a été enregistré auprès du service {{site.data.keyword.mobilepushshort}}. A ce stade, vous pouvez envoyer un message comme décrit dans la rubrique Envoi de notifications push de base. +3. Vérifiez que vos appareils ont reçu votre notification. Si l'application se trouve au premier-plan, la notification est traitée par **MFPPushNotificationListener**. Si elle se trouve en arrière-plan, un message est affiché dans la barre de notification. + +## Suivi des notifications push sur les appareils Android +{: #android_monitor} + +Pour surveillance du statut actuel de la notification dans l'application, vous pouvez implémenter l'interface `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` et définir la méthode onStatusChange(String messageId, MFPPushNotificationStatus status). + +Le **messageId** est l'identificateur du message envoyé depuis le serveur. **MFPPushNotificationStatus** définit le statut des notifications sous forme de valeurs : + +- **RECEIVED** - L'application a reçu la notification. +- **QUEUED** - L'application place en file d'attente la notification pour appel du programme d'écoute des notifications. +- **OPENED** - L'utilisateur ouvre la notification en cliquant sur celle-ci dans le bac ou en la lançant depuis l'icône d'application ou lorsque l'application est à l'avant-plan. +- **DISMISSED** - L'utilisateur supprime/rejette la notification dans le bac. + +Vous devez enregistrer la classe **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** auprès de MFPPush. + +``` + push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { + @Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { + // Handle status change +} + }); +``` + {: codeblock} + + +### Ecoute du statut DISMISSED (rejeté) + +Vous pouvez opter d'être à l'écoute du statut DISMISSED sous l'une des conditions suivantes : + +- Lorsque l'application est active (opérant en avant ou en arrière-plan) + + Ajoutez ce fragment de code à votre fichier `AndroidManifest.xml` : + +``` + + + + + +``` + {: codeblock} + +- Lorsque l'application est à la fois active (opérant en avant ou en arrière-plan) et non en opération (fermée) + +Vous devez étendre le récepteur de diffusion **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** et redéfinir la méthode **onReceive()**, où **MFPPushNotificationStatusListener** doit être enregistré avant d'appeler la méthode **onReceive()** de la classe de base. + +``` + public class MyDismissHandler extends MFPPushNotificationDismissHandler { + @Override +public void onReceive(Context context, Intent intent) { + MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { + @Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { + // Handle status change +} + }); +super.onReceive(context, intent); +} + } +``` + {: codeblock} + + +Ajoutez le fragment de code suivant à votre fichier `AndroidManifest.xml` : + +``` + + + + + +``` + {: codeblock} + +## Envoi des notifications de type {{site.data.keyword.mobilepushshort}} de base +{: #send} + +Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base. + +Pour envoyer des notifications push de base, procédez comme suit : + +1. Sélectionnez **Envoyer des notifications** et rédigez un message en choisissant une option **Envoyer à**. Les options prises en charge sont **Appareil par étiquette**, **ID de l'appareil**, **ID utilisateur**, **Appareils Android**, **Appareils IOS**, **Notifications Web** et **Tous les appareils**. +**Remarque **: si vous sélectionnez l'option **Tous les appareils**, tous les appareils qui sont abonnés à des notifications de type {{site.data.keyword.mobilepushshort}} recevront les notifications. +![Ecran Notifications](images/tag_notification.jpg) + +2. Dans la zone **Message**, composez votre message. Configurez les paramètres facultatifs, selon les besoins. +3. Cliquez sur **Envoyer**. +3. Vérifiez que vos appareils ont reçu votre notification. + +La capture d'écran suivante présente une boîte d'alerte relative à une notification push s'exécutant au premier plan sur un appareil Android. + +![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) + +La capture d'écran suivante présente une notification push qui s'exécute en arrière-plan sur un appareil Android. + +![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) + +### Paramètres Android facultatifs pour envoi de notifications +{: #send_otpional_setting} + +Vous pouvez personnaliser les paramètres de type {{site.data.keyword.mobilepushshort}} pour l'envoi de notifications vers des appareils Android. Les options de personnalisation facultative suivantes sont prises en charge. +![Paramètres Android personnalisés](images/android_custom_settings.jpg) + +- **Touche de réduction** : des touches de réduction sont attachées aux notifications. Si plusieurs notifications arrivent séquentiellement avec la même touche de réduction quand l'appareil est hors ligne, elles sont réduites. Quand un appareil passe en ligne, il reçoit des notifications du serveur FCM/GCM et n'affiche que la dernière notification portant la même touche de réduction. Si aucune touche de réduction n'est définie, les nouveaux et les anciens messages sont stockés pour une distribution future. +- **Son** : indique le clip audio à exécuter à réception d'une notification. Prend en charge le fichier par défaut ou utilise le nom de la ressource audio intégré dans l'application. +- **Icône** : spécifie le nom de l'icône à afficher pour la notification. Assurez-vous de bien avoir placé l'icône dans le dossier res/drawable, avec l'application client. +- **Priorité** : spécifie les options d'affectation de la priorité de distribution aux messages. Une priorité `élevée` ou `max` générera des notifications d'alerte, tandis que des messages dont la priorité est à `faible` ou `par défaut` n'ouvriront pas les connexions réseau sur un appareil en veille. Pour les messages dont l'option a été définie à `min`, une notification silencieuse sera émise. +- **Visibilité** : vous pouvez choisir de définir l'option de visibilité de notification sur `public` ou `privé`. L'option `privé` limite l'affichage public ; vous pouvez choisir de l'activer si votre appareil est sécurisé avec un code ou un numéro confidentiel et que le paramètre de notification est défini sur "Masquer le contenu sensible de la notification". Quand la visibilité est configurée sur `privé`, une zone "occulter" doit être mentionnée. Seul le contenu spécifié dans la zone "occulter" s'affichera sur l'écran verrouillé et sécurisé de l'appareil. L'option `public` permet une lecture libre des notifications. +- **Durée de vie** : cette valeur est définie en secondes. Si ce paramètre n'est pas spécifié, le serveur FCM/GCM stocke le message pendant quatre semaines et tente de le distribuer. La validité expire après quatre semaines. La plage des valeurs possibles va de 0 à 2419200 secondes. +- ****Retarder si inactif : en définissant cette valeur à `true`, vous demandez au serveur FCM/GCM de ne pas distribuer de notification si le serveur est inactif. Définissez cette valeur à `false` pour garantir la distribution de la notification même si l'appareil est en veille. +- **Sync**: quand cette option est définie à `true`, les notifications figurant sur tous vos appareils enregistrés sont synchronisés. Si l'utilisateur identifié par un nom d'utilisateur qui lui est propre dispose de plusieurs appareils avec la même application installée, la lecture de la notification sur un appareil garantit une suppression des notifications sur les autres appareils. Vous devez vérifier que vous êtes enregistré auprès du service {{site.data.keyword.mobilepushshort}} avec le bon ID utilisateur pour que cette option fonctionne. +- **Contenu supplémentaire** : spécifie les valeurs de contenu personnalisées pour vos notifications. + + +## Etapes suivantes +{: #next_steps_tags} + +Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options avancées. + +Ajoutez ces fonctions de service de notifications push à votre application. +Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). +Pour utiliser des options de notification avancées, voir [Activation des notifications push avancées](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/fr/c_chrome_firefox_enable.md b/services/mobilepush/nl/fr/c_chrome_firefox_enable.md index 5b7ed58a6..7404a8f6f 100644 --- a/services/mobilepush/nl/fr/c_chrome_firefox_enable.md +++ b/services/mobilepush/nl/fr/c_chrome_firefox_enable.md @@ -1,134 +1,134 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Activation des applications pour recevoir {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -Dernière mise à jour : 16 février 2017 -{: .last-updated} - -Vous pouvez permettre aux applications Web Google Chrome, Mozilla Firefox et Safari de recevoir des {{site.data.keyword.mobilepushshort}}. Vérifiez que -vous avez exécuté la procédure [Configuration des données d'identification pour un fournisseur de notification](t__main_push_config_provider.html) -avant de poursuivre. - -## Installation du logiciel SDK client de navigateur Web pour {{site.data.keyword.mobilepushshort}} -{: #web_install} - -Cette rubrique décrit comment installer et utiliser le logiciel SDK Push JavaScript du client afin de développer davantage vos applications Web. - -### Initialisation dans l'application Web - -Pour installer le logiciel SDK Javascript dans l'application Google Chrome Web, procédez comme suit : - -Téléchargez les fichiers `BMSPushSDK.js`, `BMSPushServiceWorker.js` et `manifest_Website.json` depuis le -[logiciel SDK Push Web Bluemix](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. - -1. Editez le fichier `manifest_Website.json`. - - Pour le navigateur Google Chrome, remplacez la valeur de `name` par le nom de votre site Web. Par exemple, `www.dailynewsupdates.com`. Changez la valeur de `gcm_sender_id` en la remplaçant par la valeur sender_ID de votre élément FCM (Firebase Cloud Messaging) ou GCM (Google Cloud Messaging). Pour plus d'informations, voir [Obtention de votre ID d'émetteur et de la clé d'API](t_push_provider_android.html). La valeur gcm_sender_id ne contient que des chiffres. - - ``` - { - "name": "Nom_de_votre_site_Web", - "gcm_sender_id": "ID_émetteur_GCM" - } - ``` - {: codeblock} - - - Dans le cas du navigateur Mozilla Firefox, ajoutez les valeurs suivantes dans le fichier `manifest_Website.json`. Indiquez un nom, `name`, approprié. Ce serait le nom de votre site Web. - - ``` - { - "name": "Nom_de_votre_site_Web" - } - ``` - {: codeblock} - -2. Changez le nom de fichier `manifest_Website.json` en `manifest.json`. -3. Ajoutez les fichiers `BMSPushSDK.js`, `BMSPushServiceWorker.js` et `manifest.json` au répertoire racine de votre site Web. -3. Incluez le fichier `manifest.json` dans la balise `` de votre fichier html. - ``` - - ``` - {: codeblock} -4. Incluez le logiciel SDK Push Web Bluemix dans l'application Web. - ``` - - ``` - {: codeblock} - -**Remarque** : Vérifiez que le code est déployé et prenez soin d'accéder au lien de l'exemple via `https` et non pas `http`. - -## Initialisation du logiciel SDK Push Web -{: #web_initialize} - -Initialisez le SDK en spécifiant le `GUID d'application` et la `Région de l'application -` du service Bluemix {{site.data.keyword.mobilepushshort}}. - -Pour obtenir votre service appGUID, sélectionnez l'option **Configuration** dans le panneau de navigation pour vos services push initialisés puis cliquez sur **Options pour application mobile**. Modifiez le fragment de code pour qu'il utilise le paramètre appGUID de votre service de notifications push Bluemix. - -La valeur de `AppRegion` spécifie l'emplacement où est hébergé le service {{site.data.keyword.mobilepushshort}}. Vous pouvez utiliser l'une des trois valeurs suivantes : - - - Pour Dallas, Etats-Unis : `.ng.bluemix.net` - - Pour le Royaume-Uni : `.eu-gb.bluemix.net` - - Pour Sydney : `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"GUID application push", - "appRegion":"Région où le service est hébergé", - "clientSecret":"clientSecret de votre service push" - "websitePushIDSafari": "Paramètre facultatif pour notifications Push Safari uniquement. Cette valeur doit correspondre à l'ID Push de site Web fourni lors de la configuration côté serveur." } - bmsPush.initialize(initParams, callback) -``` - {: codeblock} - -**Remarque **: si vos données d'identification pour le SDK Web push ont été modifiées, la remise du message risque d'échouer pour le -navigateur Chrome. Prenez soin d'appeler `bmsPush.unRegisterDevice` pour éviter un échec. - -Si vous soumettez des paramètres erronés, vous pouvez rencontrer des erreurs liées à la configuration. Pour plus d'informations, voir [Résolution des erreurs de configuration push Web](troubleshooting_config_errors.html). - -## Enregistrement de l'application Web -{: #web_register} - -Utilisez l'API **register()** pour enregistrer l'appareil auprès du service {{site.data.keyword.mobilepushshort}}. Utilisez l'une des options suivantes, selon votre navigateur. - -- Pour procéder à un enregistrement depuis Google Chrome, ajoutez la clé d'API FCM (Firebase Cloud Messaging) ou GCM (Google Cloud Messaging) et l'URL de site Web dans le tableau de bord de configuration Web du service {{site.data.keyword.mobilepushshort}} Bluemix. Pour plus d'informations, voir [Configuration de données d'identification pour Google Cloud Messaging (GCM)](t_push_provider_android.html), dans la rubrique relative à la configuration de Chrome. - -- Pour l'enregistrement depuis Mozilla Firefox, ajoutez l'URL de site Web dans le tableau de bord de configuration Web du service {{site.data.keyword.mobilepushshort}} Bluemix, dans la configuration Firefox. - -Utilisez les fragments de code ci-après pour procéder à l'enregistrement auprès du service {{site.data.keyword.mobilepushshort}} Bluemix. - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"GUID application push", - "appRegion":"Région où le service est hébergé", - "clientSecret":"clientSecret de votre service push" - "websitePushIDSafari": "Paramètre facultatif pour notifications Push Safari uniquement. Cette valeur doit correspondre à l'ID Push de site Web fourni lors de la configuration côté serveur." } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Activation des applications pour recevoir {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +Dernière mise à jour : 16 février 2017 +{: .last-updated} + +Vous pouvez permettre aux applications Web Google Chrome, Mozilla Firefox et Safari de recevoir des {{site.data.keyword.mobilepushshort}}. Vérifiez que +vous avez exécuté la procédure [Configuration des données d'identification pour un fournisseur de notification](t__main_push_config_provider.html) +avant de poursuivre. + +## Installation du logiciel SDK client de navigateur Web pour {{site.data.keyword.mobilepushshort}} +{: #web_install} + +Cette rubrique décrit comment installer et utiliser le logiciel SDK Push JavaScript du client afin de développer davantage vos applications Web. + +### Initialisation dans l'application Web + +Pour installer le logiciel SDK Javascript dans l'application Google Chrome Web, procédez comme suit : + +Téléchargez les fichiers `BMSPushSDK.js`, `BMSPushServiceWorker.js` et `manifest_Website.json` depuis le +[logiciel SDK Push Web Bluemix](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. + +1. Editez le fichier `manifest_Website.json`. + - Pour le navigateur Google Chrome, remplacez la valeur de `name` par le nom de votre site Web. Par exemple, `www.dailynewsupdates.com`. Changez la valeur de `gcm_sender_id` en la remplaçant par la valeur sender_ID de votre élément FCM (Firebase Cloud Messaging) ou GCM (Google Cloud Messaging). Pour plus d'informations, voir [Obtention de votre ID d'émetteur et de la clé d'API](t_push_provider_android.html). La valeur gcm_sender_id ne contient que des chiffres. + + ``` + { + "name": "Nom_de_votre_site_Web", + "gcm_sender_id": "ID_émetteur_GCM" + } + ``` + {: codeblock} + + - Dans le cas du navigateur Mozilla Firefox, ajoutez les valeurs suivantes dans le fichier `manifest_Website.json`. Indiquez un nom, `name`, approprié. Ce serait le nom de votre site Web. + + ``` + { + "name": "Nom_de_votre_site_Web" + } + ``` + {: codeblock} + +2. Changez le nom de fichier `manifest_Website.json` en `manifest.json`. +3. Ajoutez les fichiers `BMSPushSDK.js`, `BMSPushServiceWorker.js` et `manifest.json` au répertoire racine de votre site Web. +3. Incluez le fichier `manifest.json` dans la balise `` de votre fichier html. + ``` + + ``` + {: codeblock} +4. Incluez le logiciel SDK Push Web Bluemix dans l'application Web. + ``` + + ``` + {: codeblock} + +**Remarque** : Vérifiez que le code est déployé et prenez soin d'accéder au lien de l'exemple via `https` et non pas `http`. + +## Initialisation du logiciel SDK Push Web +{: #web_initialize} + +Initialisez le SDK en spécifiant le `GUID d'application` et la `Région de l'application +` du service Bluemix {{site.data.keyword.mobilepushshort}}. + +Pour obtenir votre service appGUID, sélectionnez l'option **Configuration** dans le panneau de navigation pour vos services push initialisés puis cliquez sur **Options pour application mobile**. Modifiez le fragment de code pour qu'il utilise le paramètre appGUID de votre service de notifications push Bluemix. + +La valeur de `AppRegion` spécifie l'emplacement où est hébergé le service {{site.data.keyword.mobilepushshort}}. Vous pouvez utiliser l'une des trois valeurs suivantes : + + - Pour Dallas, Etats-Unis : `.ng.bluemix.net` + - Pour le Royaume-Uni : `.eu-gb.bluemix.net` + - Pour Sydney : `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"GUID application push", + "appRegion":"Région où le service est hébergé", + "clientSecret":"clientSecret de votre service push" + "websitePushIDSafari": "Paramètre facultatif pour notifications Push Safari uniquement. Cette valeur doit correspondre à l'ID Push de site Web fourni lors de la configuration côté serveur." } + bmsPush.initialize(initParams, callback) +``` + {: codeblock} + +**Remarque **: si vos données d'identification pour le SDK Web push ont été modifiées, la remise du message risque d'échouer pour le +navigateur Chrome. Prenez soin d'appeler `bmsPush.unRegisterDevice` pour éviter un échec. + +Si vous soumettez des paramètres erronés, vous pouvez rencontrer des erreurs liées à la configuration. Pour plus d'informations, voir [Résolution des erreurs de configuration push Web](troubleshooting_config_errors.html). + +## Enregistrement de l'application Web +{: #web_register} + +Utilisez l'API **register()** pour enregistrer l'appareil auprès du service {{site.data.keyword.mobilepushshort}}. Utilisez l'une des options suivantes, selon votre navigateur. + +- Pour procéder à un enregistrement depuis Google Chrome, ajoutez la clé d'API FCM (Firebase Cloud Messaging) ou GCM (Google Cloud Messaging) et l'URL de site Web dans le tableau de bord de configuration Web du service {{site.data.keyword.mobilepushshort}} Bluemix. Pour plus d'informations, voir [Configuration de données d'identification pour Google Cloud Messaging (GCM)](t_push_provider_android.html), dans la rubrique relative à la configuration de Chrome. + +- Pour l'enregistrement depuis Mozilla Firefox, ajoutez l'URL de site Web dans le tableau de bord de configuration Web du service {{site.data.keyword.mobilepushshort}} Bluemix, dans la configuration Firefox. + +Utilisez les fragments de code ci-après pour procéder à l'enregistrement auprès du service {{site.data.keyword.mobilepushshort}} Bluemix. + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"GUID application push", + "appRegion":"Région où le service est hébergé", + "clientSecret":"clientSecret de votre service push" + "websitePushIDSafari": "Paramètre facultatif pour notifications Push Safari uniquement. Cette valeur doit correspondre à l'ID Push de site Web fourni lors de la configuration côté serveur." } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + + + diff --git a/services/mobilepush/nl/fr/c_chrome_firefox_enable_send.md b/services/mobilepush/nl/fr/c_chrome_firefox_enable_send.md index 2ef528bc2..09ba87939 100644 --- a/services/mobilepush/nl/fr/c_chrome_firefox_enable_send.md +++ b/services/mobilepush/nl/fr/c_chrome_firefox_enable_send.md @@ -1,44 +1,44 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Envoi de notifications de base aux navigateurs Web -{: #web_notifications} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - -Une fois que vous avez développé vos applications, vous pouvez envoyer une notification push. - -1. Sélectionnez **Envoyer des notifications** et rédigez un message en choisissant **Notifications Web** comme option **Envoyer à**. -2. Entrez le message qui doit être distribué dans la zone **Message**. -3. Vous pouvez choisir de fournir des paramètres facultatifs : - - **Titre de la notification** : il s'agit du texte qui s'affichera comme en-tête de l'alerte du message. - - **URL de l'icône de notification** : si votre message doit être distribué avec une icône de notification d'application, fournissez dans cette zone le lien à l'icône. - - **Time to live** : avise le serveur de la validité des messages. -4. Pour les notifications Web envoyées au navigateur Safari, certaines informations supplémentaires sont requises : - - **Action** : libellé du bouton d'action. - - **URL Arguments** : arguments d'URL à utiliser avec cette notification. Doivent être soumis sous forme de tableau JSON. - -L'image suivante montre l'option Notifications Web du tableau de bord. - - ![Ecran Notifications](images/DashboardWebpush.jpg) - - -## Etapes suivantes - {: #next_steps_tags} - -Une fois que vous avez configuré les notifications de base, vous pouvez choisir de configurer des notifications basées sur des balises et des options -avancées. - -Ajoutez ces fonctions de service {{site.data.keyword.mobilepushshort}} à votre application. Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). Pour utiliser des options de notification avancées, voir [Activation des notifications push avancées](t_advance_badge_sound_payload.html). - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Envoi de notifications de base aux navigateurs Web +{: #web_notifications} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + +Une fois que vous avez développé vos applications, vous pouvez envoyer une notification push. + +1. Sélectionnez **Envoyer des notifications** et rédigez un message en choisissant **Notifications Web** comme option **Envoyer à**. +2. Entrez le message qui doit être distribué dans la zone **Message**. +3. Vous pouvez choisir de fournir des paramètres facultatifs : + - **Titre de la notification** : il s'agit du texte qui s'affichera comme en-tête de l'alerte du message. + - **URL de l'icône de notification** : si votre message doit être distribué avec une icône de notification d'application, fournissez dans cette zone le lien à l'icône. + - **Time to live** : avise le serveur de la validité des messages. +4. Pour les notifications Web envoyées au navigateur Safari, certaines informations supplémentaires sont requises : + - **Action** : libellé du bouton d'action. + - **URL Arguments** : arguments d'URL à utiliser avec cette notification. Doivent être soumis sous forme de tableau JSON. + +L'image suivante montre l'option Notifications Web du tableau de bord. + + ![Ecran Notifications](images/DashboardWebpush.jpg) + + +## Etapes suivantes + {: #next_steps_tags} + +Une fois que vous avez configuré les notifications de base, vous pouvez choisir de configurer des notifications basées sur des balises et des options +avancées. + +Ajoutez ces fonctions de service {{site.data.keyword.mobilepushshort}} à votre application. Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). Pour utiliser des options de notification avancées, voir [Activation des notifications push avancées](t_advance_badge_sound_payload.html). + + + diff --git a/services/mobilepush/nl/fr/c_cordova_enable.md b/services/mobilepush/nl/fr/c_cordova_enable.md index 005a05ee5..c61637636 100644 --- a/services/mobilepush/nl/fr/c_cordova_enable.md +++ b/services/mobilepush/nl/fr/c_cordova_enable.md @@ -1,323 +1,323 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configuration des applications Cordova pour la réception de notifications push -{: #cordova_enable} -Dernière mise à jour : 18 janvier 2017 -{: .last-updated} - -Cordova est une plateforme permettant de construire des applications hybrides avec JavaScript, CSS et HTML. Le service {{site.data.keyword.mobilepushshort}} prend en charge le développement d'applications iOS et Android reposant sur Cordova. - -Vous pouvez activer les applications Cordova pour recevoir des notifications push sur vos appareils. - -## Installation du plug-in Cordova Push -{: #cordova_install} - -Installez et utilisez le plug-in push client pour développer davantage vos applications Cordova, ce qui a pour effet d'installer aussi le plug-in Cordova core, qui initialise votre connexion à Bluemix. - -### Avant de commencer - -1. Téléchargez les dernières versions d'Android Studio SDK et Xcode. -1. Configurez votre émulateur. Pour Android Studio, utilisez un émulateur qui prend en charge l'API Google Play. -1. Installez l'outil de ligne de commande Git. Pour Windows, prenez soin de sélectionner l'option **Run Git from the Window Command Prompt**. Pour plus d'informations sur le téléchargement et l'installation de cet outil, voir [Git ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://git-scm.com/downloads){: new_window}. -1. Installez Node.js et l'outil Node Package Manager (NPM). L'outil de ligne de commande NPM est intégré à Node.js. Pour plus d'informations sur le téléchargement et l'installation de Node.js, voir [Node.js ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://nodejs.org/en/download/){: new_window}. -1. A partir de la ligne de commande, installez les outils de ligne de commande Cordova à l'aide de la commande **npm install -g cordova**. Cette action est requise pour pouvoir utiliser le plug-in push Cordova. Pour plus d'informations sur l'installation de Cordova et la configuration de votre application Cordova, voir [Cordova Apache ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://cordova.apache.org/#getstarted){: new_window}. Pour plus d'informations, reportez-vous au [fichier Readme ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} du plug-in Push de Cordova. -1. Basculez vers le dossier dans lequel créer votre application Cordova et exécutez la commande ci-dessous pour créer une application Cordova. Si vous possédez déjà une application Cordova, passez à l'étape 3. -```cordova create your_app_name - cd your_app_name -``` - {: codeblock} -- Facultatif : vous pouvez éditer le fichier **config.xml** et remplacer le nom de l'application dans l'élément par le nom de votre choix, plutôt que d'utiliser le nom par défaut HelloCordova. - -Prenez soin de spécifier l'ID de bundle approprié. Les messages d'erreur suivants risquent d'être générés dans Xcode, si un ID de bundle incorrect est spécifié. - -* The executable was signed with invalid entitlements. -* The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile. Pour corriger ce problème, spécifiez l'ID de bundle approprié dans Xcode ou dans le fichier **config.xml** de votre appli Cordova. - -1. Ajoutez l'API minimale prise en charge ou la déclaration de cible de déploiement dans le fichier config.xml de votre application Cordova. La valeur de minSdkVersion doit être supérieure à 15. La valeur de targetSdkVersion doit toujours refléter le logiciel SDK Android le plus récent disponible auprès de Google. - - * Android - Ouvrez dans votre éditeur le fichier **config.xml** et mettez à jour l'élément -`` en spécifiant les versions minimum et cible du SDK : - - ``` - - - - - - ``` - {: codeblock} - - * iOS - Mettez à jour l'élément avec une déclaration cible de déploiement : - - ``` - - - - - ``` - {: codeblock} - -1. A partir de l'interface de ligne de commande Cordova, ajoutez vos plateformes iOS et/ou Android en utilisant la commande suivante : -``` -cordova platform add ios - cordova platform add android -``` - {: codeblock} - -1. Depuis le répertoire racine de votre application Cordova, entrez la commande suivante afin d'installer le plug-in push Cordova : **cordova plugin add bms-push**. Selon les plateformes que vous avez ajoutées, vous pouvez voir : -``` -Installing "bms-push" for android -Installing "bms-push" for ios -``` - {: codeblock} - -1. Depuis votre dossier répertoire_racine_application, vérifiez que les plug-in Cordova core et push ont été installés correctement en entrant la commande suivante : **cordova plugin list**. Selon les plateformes que vous avez ajoutées, vous pouvez voir : -``` -bms-core "BMSCore" -bms-push "BMSPush" -``` - {: codeblock} - -1. Configurez votre environnement de développement iOS. -2. Construisez et exécutez votre application avec Xcode. -1. Téléchargez vos fichiers Firebase `google-services.json` pour Android et placez-les sous le dossier racine de votre projet -Cordova ( `[nom_de_votre_application]/platforms/android. - 1. Accédez au dossier `[nom_de_votre_application]/platforms/android`. - 2. Ouvrez le fichier `build.gradle` (chemin : plateforme > android > build.gradle). - 3. Recherchez le texte `buildscript` dans le fichier `build.gradle`. - 4. Ajoutez la ligne 'com.google.gms:google-services:3.0.0' après celle du chemin de classes (classpath) - 5. Accédez à la section "dependencies". Sélectionnez les dépendances comportant le texte `compile` et l'endroit marquant la -fin de la -dépendance et ajoutez juste après cette ligne :apply plugin: 'com.google.gms.google-services'. - 6. Préparez et construisez votre projet Cordova Android. - ``` - cordova prepare android - cordova build android - ``` - {: codeblock} - **Remarque** : avant d'ouvrir votre projet dans Android Studio, générez votre application Cordova via l'interface CLI Cordova, afin d'éviter des erreurs de génération. - -## Initialisation du plug-in Cordova -{: #cordova_initialize} - -Pour pouvoir utiliser le plug-in Cordova du service {{site.data.keyword.mobilepushshort}}, vous devez l'initialiser en transmettant la route de l'application et -l'identificateur global unique de l'application. Une fois le plug-in initialisé, vous pouvez vous connecter à l'application serveur que vous avez créée dans le tableau de bord Bluemix. Le plug-in Cordova est l'encapsuleur pour les logiciels SDK de client Android et iOS qui permettent à une application Cordova de communiquer avec les services Bluemix. - -1. Initialisez le client BMS en copiant et en collant le fragment de code suivant dans votre fichier JavaScript principal (généralement situé sous le répertoire **www/js**). - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("YOUR APP REGION"); - var category = {}; - BMSPush.initialize(appGUID,clientSecret,category); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); - } -``` - {: codeblock} - -Indiquez la région pour votre application. Les constantes suivantes sont fournies : - -``` -REGION_US_SOUTH // ".ng.bluemix.net"; -REGION_UK //".eu-gb.bluemix.net"; -REGION_SYDNEY // ".au-syd.bluemix.net"; -``` - -Par exemple : - -``` -BMSClient.initialize(BMSClient.REGION_US_SOUTH); -``` - -**Remarque **: si vous avez créé une application Cordova à l'aide de l'interface CLI de Cordova (par exemple, avec la commande Cordova -create app-name, placez ce code Javascript dans le fichier index.js après la fonction app.receivedEvent dans la fonction onDeviceReady: function() -afin d'initialiser le client `BMSClient`. - - -## Enregistrement des appareils -{: #cordova_register} - - -Pour enregistrer un appareil auprès du service {{site.data.keyword.mobilepushshort}}, appelez la méthode d'enregistrement. Copiez le fragment de code suivant dans votre application Cordova pour enregistrer un appareil. - -``` -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); -``` - {: codeblock} - -Le fragment de code JavaScript ci-après montre comment initialiser le logiciel SDK de votre client Bluemix Mobile Services, enregistrer un appareil avec le service {{site.data.keyword.mobilepushshort}} et passer en mode écoute sur les notifications push. Incluez ce code dans votre fichier Javascript. - -Dans **onDeviceReady: function()**. - -``` -onDeviceReady: function() { -app.receivedEvent('deviceready'); -BMSClient.initialize("YOUR APP REGION"); -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; -BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -Ajoutez le fragment de code Swift suivant à la classe de votre délégué d'application : - -``` -// Register the device token with Bluemix Push Notification Service -func application(application: UIApplication, - didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { - CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) -} -// Handle error when failed to register device token with APNs -func application(application: UIApplication, - didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) -} -``` - {: codeblock} - -##Etapes suivantes - -{: #cordova_register_next} - -Générez votre projet, puis exécutez-le à l'aide des commandes suivantes : - -####Android -{: android-next-steps} - -``` -cordova build android -``` - {: codeblock} - -``` -cordova run android -``` - {: codeblock} - -####iOS -{: ios-next-steps} - -``` -cordova build ios -``` - {: codeblock} - -``` -cordova run ios -``` - {: codeblock} - -## Réception de notifications push sur les appareils -{: #cordova_receive} - -Copiez le fragment de code ci-après pour recevoir des notifications push sur les appareils. - -###JavaScript - -Ajoutez le fragment de code JavaScript suivant à la partie Web de votre application Cordova : -``` -var showNotification = function(notif) { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -###Propriétés de notification Android - -La section suivante répertorie les propriétés de notification Android : - -* **message** - Message de notification Push -* **payload** - objet JSON comportant un contenu de notification - - -###Propriétés de notification iOS - -La section suivante répertorie les propriétés de notification iOS : - -* **message** - Message de notification Push -* **payload** - Objet JSON comportant un contenu de notification -action-loc-key - La chaîne est utilisée comme clé pour obtenir une chaîne localisée à l'emplacement actuel, à utiliser comme titre de bouton approprié au lieu de `View`. -* **badge** - numéro à utiliser comme badge de l'icône d'application. Si cette propriété manque, le badge n'est pas changé. Pour supprimer le badge, associez cette propriété à la valeur 0. -* **sound** - Nom d'un fichier son dans le bundle de l'application ou dans le dossier Library/Sounds du conteneur des données d'application. - - -Ajoutez les fragments de code Swift suivants à la classe de votre délégué d'application : -``` -// Handle receiving a remote notification -func application(application: UIApplication, - didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) -} -``` - {: codeblock} - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary - if remoteNotif != nil { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) - } -} -``` - {: codeblock} - -## Envoi de notifications push de base -{: #push-send-notifications} - -Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base. - -Pour envoyer des notifications push de base, procédez comme suit : - -1. Sélectionnez **Envoyer des notifications** et rédigez un message en choisissant une option **Envoyer à**. Les options prises en charge sont **Appareil par étiquette**, **ID de l'appareil**, **ID utilisateur**, **Appareils Android**, **Appareils IOS**, **Notifications Web** et **Tous les appareils**. -**Remarque **: si vous sélectionnez l'option **Tous les appareils**, tous les appareils qui sont abonnés à des notifications de type {{site.data.keyword.mobilepushshort}} recevront les notifications. -![Ecran Notifications](images/tag_notification.jpg) - -2. Dans la zone **Message**, composez votre message. Configurez les paramètres facultatifs, selon les besoins. -3. Cliquez sur **Envoyer**. -3. Vérifiez que vos appareils ont reçu votre notification. - -Les captures d'écran suivantes présentent une boîte de dialogue d'alerte qui traite une notification de type {{site.data.keyword.mobilepushshort}} s'exécutant au premier plan sur un appareil Android et sur un appareil iOS. - -![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) - -![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) - - L'image suivante montre {{site.data.keyword.mobilepushshort}} en arrière-plan pour Android. -![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) - -## Etapes suivantes -{: #next_steps_tags} - -Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options -avancées. - -Ajoutez les fonctions du service {{site.data.keyword.mobilepushshort}} à votre application. -Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). -Pour utiliser des options de notification avancées, voir [Activation des notifications push avancées](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configuration des applications Cordova pour la réception de notifications push +{: #cordova_enable} +Dernière mise à jour : 18 janvier 2017 +{: .last-updated} + +Cordova est une plateforme permettant de construire des applications hybrides avec JavaScript, CSS et HTML. Le service {{site.data.keyword.mobilepushshort}} prend en charge le développement d'applications iOS et Android reposant sur Cordova. + +Vous pouvez activer les applications Cordova pour recevoir des notifications push sur vos appareils. + +## Installation du plug-in Cordova Push +{: #cordova_install} + +Installez et utilisez le plug-in push client pour développer davantage vos applications Cordova, ce qui a pour effet d'installer aussi le plug-in Cordova core, qui initialise votre connexion à Bluemix. + +### Avant de commencer + +1. Téléchargez les dernières versions d'Android Studio SDK et Xcode. +1. Configurez votre émulateur. Pour Android Studio, utilisez un émulateur qui prend en charge l'API Google Play. +1. Installez l'outil de ligne de commande Git. Pour Windows, prenez soin de sélectionner l'option **Run Git from the Window Command Prompt**. Pour plus d'informations sur le téléchargement et l'installation de cet outil, voir [Git ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://git-scm.com/downloads){: new_window}. +1. Installez Node.js et l'outil Node Package Manager (NPM). L'outil de ligne de commande NPM est intégré à Node.js. Pour plus d'informations sur le téléchargement et l'installation de Node.js, voir [Node.js ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://nodejs.org/en/download/){: new_window}. +1. A partir de la ligne de commande, installez les outils de ligne de commande Cordova à l'aide de la commande **npm install -g cordova**. Cette action est requise pour pouvoir utiliser le plug-in push Cordova. Pour plus d'informations sur l'installation de Cordova et la configuration de votre application Cordova, voir [Cordova Apache ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://cordova.apache.org/#getstarted){: new_window}. Pour plus d'informations, reportez-vous au [fichier Readme ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} du plug-in Push de Cordova. +1. Basculez vers le dossier dans lequel créer votre application Cordova et exécutez la commande ci-dessous pour créer une application Cordova. Si vous possédez déjà une application Cordova, passez à l'étape 3. +```cordova create your_app_name + cd your_app_name +``` + {: codeblock} +- Facultatif : vous pouvez éditer le fichier **config.xml** et remplacer le nom de l'application dans l'élément par le nom de votre choix, plutôt que d'utiliser le nom par défaut HelloCordova. + +Prenez soin de spécifier l'ID de bundle approprié. Les messages d'erreur suivants risquent d'être générés dans Xcode, si un ID de bundle incorrect est spécifié. + +* The executable was signed with invalid entitlements. +* The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile. Pour corriger ce problème, spécifiez l'ID de bundle approprié dans Xcode ou dans le fichier **config.xml** de votre appli Cordova. + +1. Ajoutez l'API minimale prise en charge ou la déclaration de cible de déploiement dans le fichier config.xml de votre application Cordova. La valeur de minSdkVersion doit être supérieure à 15. La valeur de targetSdkVersion doit toujours refléter le logiciel SDK Android le plus récent disponible auprès de Google. + + * Android - Ouvrez dans votre éditeur le fichier **config.xml** et mettez à jour l'élément +`` en spécifiant les versions minimum et cible du SDK : + + ``` + + + + + + ``` + {: codeblock} + + * iOS - Mettez à jour l'élément avec une déclaration cible de déploiement : + + ``` + + + + + ``` + {: codeblock} + +1. A partir de l'interface de ligne de commande Cordova, ajoutez vos plateformes iOS et/ou Android en utilisant la commande suivante : +``` +cordova platform add ios + cordova platform add android +``` + {: codeblock} + +1. Depuis le répertoire racine de votre application Cordova, entrez la commande suivante afin d'installer le plug-in push Cordova : **cordova plugin add bms-push**. Selon les plateformes que vous avez ajoutées, vous pouvez voir : +``` +Installing "bms-push" for android +Installing "bms-push" for ios +``` + {: codeblock} + +1. Depuis votre dossier répertoire_racine_application, vérifiez que les plug-in Cordova core et push ont été installés correctement en entrant la commande suivante : **cordova plugin list**. Selon les plateformes que vous avez ajoutées, vous pouvez voir : +``` +bms-core "BMSCore" +bms-push "BMSPush" +``` + {: codeblock} + +1. Configurez votre environnement de développement iOS. +2. Construisez et exécutez votre application avec Xcode. +1. Téléchargez vos fichiers Firebase `google-services.json` pour Android et placez-les sous le dossier racine de votre projet +Cordova ( `[nom_de_votre_application]/platforms/android. + 1. Accédez au dossier `[nom_de_votre_application]/platforms/android`. + 2. Ouvrez le fichier `build.gradle` (chemin : plateforme > android > build.gradle). + 3. Recherchez le texte `buildscript` dans le fichier `build.gradle`. + 4. Ajoutez la ligne 'com.google.gms:google-services:3.0.0' après celle du chemin de classes (classpath) + 5. Accédez à la section "dependencies". Sélectionnez les dépendances comportant le texte `compile` et l'endroit marquant la +fin de la +dépendance et ajoutez juste après cette ligne :apply plugin: 'com.google.gms.google-services'. + 6. Préparez et construisez votre projet Cordova Android. + ``` + cordova prepare android + cordova build android + ``` + {: codeblock} + **Remarque** : avant d'ouvrir votre projet dans Android Studio, générez votre application Cordova via l'interface CLI Cordova, afin d'éviter des erreurs de génération. + +## Initialisation du plug-in Cordova +{: #cordova_initialize} + +Pour pouvoir utiliser le plug-in Cordova du service {{site.data.keyword.mobilepushshort}}, vous devez l'initialiser en transmettant la route de l'application et +l'identificateur global unique de l'application. Une fois le plug-in initialisé, vous pouvez vous connecter à l'application serveur que vous avez créée dans le tableau de bord Bluemix. Le plug-in Cordova est l'encapsuleur pour les logiciels SDK de client Android et iOS qui permettent à une application Cordova de communiquer avec les services Bluemix. + +1. Initialisez le client BMS en copiant et en collant le fragment de code suivant dans votre fichier JavaScript principal (généralement situé sous le répertoire **www/js**). + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("YOUR APP REGION"); + var category = {}; + BMSPush.initialize(appGUID,clientSecret,category); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); + } +``` + {: codeblock} + +Indiquez la région pour votre application. Les constantes suivantes sont fournies : + +``` +REGION_US_SOUTH // ".ng.bluemix.net"; +REGION_UK //".eu-gb.bluemix.net"; +REGION_SYDNEY // ".au-syd.bluemix.net"; +``` + +Par exemple : + +``` +BMSClient.initialize(BMSClient.REGION_US_SOUTH); +``` + +**Remarque **: si vous avez créé une application Cordova à l'aide de l'interface CLI de Cordova (par exemple, avec la commande Cordova +create app-name, placez ce code Javascript dans le fichier index.js après la fonction app.receivedEvent dans la fonction onDeviceReady: function() +afin d'initialiser le client `BMSClient`. + + +## Enregistrement des appareils +{: #cordova_register} + + +Pour enregistrer un appareil auprès du service {{site.data.keyword.mobilepushshort}}, appelez la méthode d'enregistrement. Copiez le fragment de code suivant dans votre application Cordova pour enregistrer un appareil. + +``` +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); +``` + {: codeblock} + +Le fragment de code JavaScript ci-après montre comment initialiser le logiciel SDK de votre client Bluemix Mobile Services, enregistrer un appareil avec le service {{site.data.keyword.mobilepushshort}} et passer en mode écoute sur les notifications push. Incluez ce code dans votre fichier Javascript. + +Dans **onDeviceReady: function()**. + +``` +onDeviceReady: function() { +app.receivedEvent('deviceready'); +BMSClient.initialize("YOUR APP REGION"); +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; +BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +Ajoutez le fragment de code Swift suivant à la classe de votre délégué d'application : + +``` +// Register the device token with Bluemix Push Notification Service +func application(application: UIApplication, + didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { + CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) +} +// Handle error when failed to register device token with APNs +func application(application: UIApplication, + didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) +} +``` + {: codeblock} + +##Etapes suivantes + +{: #cordova_register_next} + +Générez votre projet, puis exécutez-le à l'aide des commandes suivantes : + +####Android +{: android-next-steps} + +``` +cordova build android +``` + {: codeblock} + +``` +cordova run android +``` + {: codeblock} + +####iOS +{: ios-next-steps} + +``` +cordova build ios +``` + {: codeblock} + +``` +cordova run ios +``` + {: codeblock} + +## Réception de notifications push sur les appareils +{: #cordova_receive} + +Copiez le fragment de code ci-après pour recevoir des notifications push sur les appareils. + +###JavaScript + +Ajoutez le fragment de code JavaScript suivant à la partie Web de votre application Cordova : +``` +var showNotification = function(notif) { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +###Propriétés de notification Android + +La section suivante répertorie les propriétés de notification Android : + +* **message** - Message de notification Push +* **payload** - objet JSON comportant un contenu de notification + + +###Propriétés de notification iOS + +La section suivante répertorie les propriétés de notification iOS : + +* **message** - Message de notification Push +* **payload** - Objet JSON comportant un contenu de notification +action-loc-key - La chaîne est utilisée comme clé pour obtenir une chaîne localisée à l'emplacement actuel, à utiliser comme titre de bouton approprié au lieu de `View`. +* **badge** - numéro à utiliser comme badge de l'icône d'application. Si cette propriété manque, le badge n'est pas changé. Pour supprimer le badge, associez cette propriété à la valeur 0. +* **sound** - Nom d'un fichier son dans le bundle de l'application ou dans le dossier Library/Sounds du conteneur des données d'application. + + +Ajoutez les fragments de code Swift suivants à la classe de votre délégué d'application : +``` +// Handle receiving a remote notification +func application(application: UIApplication, + didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) +} +``` + {: codeblock} + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary + if remoteNotif != nil { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) + } +} +``` + {: codeblock} + +## Envoi de notifications push de base +{: #push-send-notifications} + +Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base. + +Pour envoyer des notifications push de base, procédez comme suit : + +1. Sélectionnez **Envoyer des notifications** et rédigez un message en choisissant une option **Envoyer à**. Les options prises en charge sont **Appareil par étiquette**, **ID de l'appareil**, **ID utilisateur**, **Appareils Android**, **Appareils IOS**, **Notifications Web** et **Tous les appareils**. +**Remarque **: si vous sélectionnez l'option **Tous les appareils**, tous les appareils qui sont abonnés à des notifications de type {{site.data.keyword.mobilepushshort}} recevront les notifications. +![Ecran Notifications](images/tag_notification.jpg) + +2. Dans la zone **Message**, composez votre message. Configurez les paramètres facultatifs, selon les besoins. +3. Cliquez sur **Envoyer**. +3. Vérifiez que vos appareils ont reçu votre notification. + +Les captures d'écran suivantes présentent une boîte de dialogue d'alerte qui traite une notification de type {{site.data.keyword.mobilepushshort}} s'exécutant au premier plan sur un appareil Android et sur un appareil iOS. + +![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) + +![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) + + L'image suivante montre {{site.data.keyword.mobilepushshort}} en arrière-plan pour Android. +![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) + +## Etapes suivantes +{: #next_steps_tags} + +Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options +avancées. + +Ajoutez les fonctions du service {{site.data.keyword.mobilepushshort}} à votre application. +Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). +Pour utiliser des options de notification avancées, voir [Activation des notifications push avancées](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/fr/c_enable_push.md b/services/mobilepush/nl/fr/c_enable_push.md index da62cd7c5..96cbbd2c1 100644 --- a/services/mobilepush/nl/fr/c_enable_push.md +++ b/services/mobilepush/nl/fr/c_enable_push.md @@ -1,27 +1,27 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Activation des notifications pour les appareils mobiles -{: #c_enable_push-notifications} -Dernière mise à jour : 18 janvier 2017 -{: .last-updated} - -Vérifiez que vous avez exécuté la procédure [Configuration des données d'identification pour un fournisseur de -notification](t__main_push_config_provider.html). - -Cette section décrit comment configurer vos applications - mobiles, Web et applications et extensions Chrome - pour qu'elles reçoivent des notifications push, comment créer des notifications de base, obtenir et initialiser le logiciel SDK ou le plug-in et comment enregistrer votre appareil ou votre navigateur pour qu'il reçoive des notifications push. Vous pouvez également activer vos applications mobiles et de navigateur Web pour la réception de notifications push en utilisant l'[API REST](t_restapi.html). - -**Remarque **: Dans le cas d'enregistrement d'un appareil, d'un navigateur, d'applications et d'extensions Chrome, le service -{{site.data.keyword.mobilepushshort}} conserve une référence unique pour les jetons issus des fournisseurs de notification - -des APN pour Apple ou FCM pour Google. Les jetons peuvent être invalidés par le fournisseur de service {{site.data.keyword.mobilepushshort}} pour un certain nombre de raisons. - -Ceci peut survenir, par exemple, lors de la désinstallation d'une application sur l'appareil. Dans un tel scénario, quand une tentative de distribution d'une notification est effectuée et reçoit une réponse des fournisseurs indiquant que l'appareil est invalidé, le service {{site.data.keyword.mobilepushshort}} retire les enregistrements de l'appareil ou du navigateur Web, ce qui aura pour effet d'empêcher d'autres tentatives d'envoi de notifications à l'appareil invalidé. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Activation des notifications pour les appareils mobiles +{: #c_enable_push-notifications} +Dernière mise à jour : 18 janvier 2017 +{: .last-updated} + +Vérifiez que vous avez exécuté la procédure [Configuration des données d'identification pour un fournisseur de +notification](t__main_push_config_provider.html). + +Cette section décrit comment configurer vos applications - mobiles, Web et applications et extensions Chrome - pour qu'elles reçoivent des notifications push, comment créer des notifications de base, obtenir et initialiser le logiciel SDK ou le plug-in et comment enregistrer votre appareil ou votre navigateur pour qu'il reçoive des notifications push. Vous pouvez également activer vos applications mobiles et de navigateur Web pour la réception de notifications push en utilisant l'[API REST](t_restapi.html). + +**Remarque **: Dans le cas d'enregistrement d'un appareil, d'un navigateur, d'applications et d'extensions Chrome, le service +{{site.data.keyword.mobilepushshort}} conserve une référence unique pour les jetons issus des fournisseurs de notification - +des APN pour Apple ou FCM pour Google. Les jetons peuvent être invalidés par le fournisseur de service {{site.data.keyword.mobilepushshort}} pour un certain nombre de raisons. + +Ceci peut survenir, par exemple, lors de la désinstallation d'une application sur l'appareil. Dans un tel scénario, quand une tentative de distribution d'une notification est effectuée et reçoit une réponse des fournisseurs indiquant que l'appareil est invalidé, le service {{site.data.keyword.mobilepushshort}} retire les enregistrements de l'appareil ou du navigateur Web, ce qui aura pour effet d'empêcher d'autres tentatives d'envoi de notifications à l'appareil invalidé. diff --git a/services/mobilepush/nl/fr/c_enable_push_webhook.md b/services/mobilepush/nl/fr/c_enable_push_webhook.md index 6b02fcdbc..388030767 100644 --- a/services/mobilepush/nl/fr/c_enable_push_webhook.md +++ b/services/mobilepush/nl/fr/c_enable_push_webhook.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Activation de webhooks -{: #tag_based_notifications} -Dernière mise à jour : 23 janvier 2017 -{: .last-updated} - - -Avec le service {{site.data.keyword.mobilepushshort}}, vous pouvez opter de recevoir des alertes sur des informations qui ont été modifiées. Les modifications des informations de l'entreprise créent des événements pour lesquels vous pouvez être notifié en les enregistrant en tant qu'événements webhook. Ces événements webhook déclenchent une alerte. - -Les webhooks sont des rappels définis par l'utilisateur qui sont déclenchés par un événement, tels que l'enregistrement d'un appareil ou l'abonnement à des balises. Sur -le service {{site.data.keyword.mobilepushshort}}, vous pouvez vous enregistrer pour les événements webhook suivants : - -- **onDeviceRegister** : un événement webhook est déclenché pour les appareils enregistrés pour opérations push. -- **onDeviceUpdate** : un événement webhook est déclenché quand des informations sur un appareil enregistré sont mises à jour. -- **onDeviceUnregister** : un événement webhook à est déclenché quand l'enregistrement d'un appareil est annulé. -- **onSubscribe** : un événement webhook à est déclenché quand un utilisateur s'abonne à un intitulé. -- **onUnsubscribe** :un événement webhook à est déclenché quand un utilisateur se désabonne d'un intitulé. -- **onNotificationSend** : un événement webhook est déclenché pour une notification qui a été transmise. -- **onNotificationFailure** : un événement webhook est déclenché pour des échecs de notification. - - -**Remarque ** : les transmissions de notifications sont effectuées par lots. Une transmission de message peut avoir plusieurs événements webhook, lesquels peuvent inclure à la fois des réussites et des échecs. -Les événements webhook porteraient le même messageID que le message transmis. - -Pour plus d'informations sur les webhooks, reportez-vous au document [API REST IBM de notifications Push ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Activation de webhooks +{: #tag_based_notifications} +Dernière mise à jour : 23 janvier 2017 +{: .last-updated} + + +Avec le service {{site.data.keyword.mobilepushshort}}, vous pouvez opter de recevoir des alertes sur des informations qui ont été modifiées. Les modifications des informations de l'entreprise créent des événements pour lesquels vous pouvez être notifié en les enregistrant en tant qu'événements webhook. Ces événements webhook déclenchent une alerte. + +Les webhooks sont des rappels définis par l'utilisateur qui sont déclenchés par un événement, tels que l'enregistrement d'un appareil ou l'abonnement à des balises. Sur +le service {{site.data.keyword.mobilepushshort}}, vous pouvez vous enregistrer pour les événements webhook suivants : + +- **onDeviceRegister** : un événement webhook est déclenché pour les appareils enregistrés pour opérations push. +- **onDeviceUpdate** : un événement webhook est déclenché quand des informations sur un appareil enregistré sont mises à jour. +- **onDeviceUnregister** : un événement webhook à est déclenché quand l'enregistrement d'un appareil est annulé. +- **onSubscribe** : un événement webhook à est déclenché quand un utilisateur s'abonne à un intitulé. +- **onUnsubscribe** :un événement webhook à est déclenché quand un utilisateur se désabonne d'un intitulé. +- **onNotificationSend** : un événement webhook est déclenché pour une notification qui a été transmise. +- **onNotificationFailure** : un événement webhook est déclenché pour des échecs de notification. + + +**Remarque ** : les transmissions de notifications sont effectuées par lots. Une transmission de message peut avoir plusieurs événements webhook, lesquels peuvent inclure à la fois des réussites et des échecs. +Les événements webhook porteraient le même messageID que le message transmis. + +Pour plus d'informations sur les webhooks, reportez-vous au document [API REST IBM de notifications Push ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}. diff --git a/services/mobilepush/nl/fr/c_ios_enable.md b/services/mobilepush/nl/fr/c_ios_enable.md index d2f0947e6..b73dd4e8e 100644 --- a/services/mobilepush/nl/fr/c_ios_enable.md +++ b/services/mobilepush/nl/fr/c_ios_enable.md @@ -1,339 +1,339 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#Activation de l'envoi de {{site.data.keyword.mobilepushshort}} par les applications iOS -{: #enable-push-ios-notifications} -Dernière mise à jour : 14 février 2017 -{: .last-updated} - -Vous pouvez permettre aux applications iOS d'envoyer des {{site.data.keyword.mobilepushshort}} à vos appareils. - - -##Installation de CocoaPods -{: #enable-push-ios-notifications-install} - -Pour un projet Xcode existant, vous pouvez configurer le logiciel SDK client des services Bluemix Mobile en utilisant l'outil de gestion des dépendances CocoaPods. Vous pouvez aussi installer le logiciel SDK manuellement. - -Pour consulter le fichier Readme de Swift Push, accédez au site [Readme![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. - - - -1. Installez CocoaPods en exécutant la commande suivante sur votre terminal Mac : -```$ sudo gem install cocoapods -``` - {: codeblock} -2. Entrez la commande `pod init` dans le terminal pour initialiser CocoaPods. Assurez-vous de bien exécuter la commande depuis le répertoire où se trouve votre projet Xcode. La commande `pod init` crée un fichier Pod. -3. Dans le fichier Pod généré, ajoutez les dépendances de logiciel SDK requises. Copiez le fichier Pod suivant : - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copiez la liste suivante telle quelle et supprimez les dépendances superflues. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - pod 'BMSAnalyticsAPI' - end - ``` - {: codeblock} - -3. Depuis le terminal, accédez au dossier de votre projet et installez des dépendances avec la commande `pod update`. - -Cette commande installe vos dépendances et crée un nouvel espace de travail Xcode. -**Remarque** : Prenez soin de toujours ouvrir le nouvel espace de travail Xcode au -lieu du fichier de projet Xcode d'origine : -``` - $ open App.xcworkspace -``` - {: codeblock} - -Cet espace de travail contient votre projet d'origine et le projet Pods contenant vos dépendances. Pour modifier le dossier source des services mobiles Bluemix, vous le trouverez dans votre projet Pods, sous `Pods/yourImportedSourceFolder`. Exemple : `Pods/BMSPush`. - -##Ajout d'infrastructures à l'aide de Carthage -{: #carthage} - -Ajoutez des infrastructures à votre projet à l'aide de [Carthage ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}. Notez que Carthage dans Xcode8 n'est pas pris en charge. - -1. Ajoutez des infrastructures `BMSPush` à votre fichier Cartfile : -``` - github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" -``` - {: codeblock} -2. Exécutez la commande `carthage update`. Lorsque la construction est terminée, faites glisser `BMSPush.framework`, `BMSCore.framework` et `BMSAnalyticsAPI.framework` dans votre projet Xcode. -3. Suivez les instructions du site [Carthage ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} pour compléter l'intégration. - -##Configuration du logiciel SDK pour iOS -{: ios-sdk} - -Installez le kit de développement de logiciels (SDK) iOS et ajoutez le code suivant au fichier **AppDelegate.swift** dans votre application. Notez que ceci effectue également un enregistrement auprès des APN. -``` - func application(_ application: UIApplication, -didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool - { - BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") - } -``` - {: codeblock} - -##Utilisation d'infrastructures et de dossiers source importés -{: using-imported-frameworks} - -Référencez le logiciel SDK dans votre code. Vérifiez que les prérequis suivants sont en place. - -- iOS 8.0 ou version ultérieure -- Xcode 7 - -Ecrivez des directives `#import` pour les en-têtes pertinents, par exemple : -``` -//swift -import BMSCore -import BMSPush -``` - {: codeblock} - -Pour consulter le fichier Readme de Swift Push, accédez au site [Readme ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. - -**Remarque** : La mise à jour de votre projet Pods via les commandes CocoaPods `pod install` ou `pod update` peut remplacer les dossiers source des services Bluemix Mobile. Si vous voulez conserver vos versions personnalisées des fichiers d'origine, prenez soin de les sauvegarder avant d'entrer l'une de ces commandes. - - -##Paramètres de génération -{: build-settings} - -Accédez à **Xcode > Build Settings > Build Options** et affectez à l'option Set Enable Bitcode la valeur **No**. - -**Attention** : Depuis iOS 9, des modifications apportées à la fonction App Transport Security (ATS) peuvent avoir un impact sur la façon dont vous gérez le processus d'authentification. Les articles de blogue suivants fournissent des informations supplémentaires sur les modifications : [ATS and Bitcode in iOS 9 ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} et [Connect your iOS 9 app to Bluemix today ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. - -## Initialisation du logiciel SDK Push pour les applications iOS -{: #enable-push-ios-notifications-initialize} - -Le code d'initialisation se trouve généralement dans le délégué d'application de l'application iOS. Cliquez sur le lien **Options pour application mobile** dans votre tableau de bord Push pour obtenir la route de l'application et l'identificateur global unique. - -###Initialisation du logiciel SDK de base -{: Initializing-the-core-sdk} - - -``` -// Initialisation du SDK Core pour Swift avec l'identificateur global unique GUID, la route et la région Bluemix -let myBMSClient = BMSClient.sharedInstance -myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") -``` - {: codeblock} - -### Route, identificateur global unique et région Bluemix -{: route-guid-bluemix-region} - -####appRoute -{: ios-approute} - -Spécifie la route qui a été affectée à l'application serveur que vous avez créée dans Bluemix. - -####identificateur_global_unique -{: ios-guid} - -Spécifie la clé unique qui a été affectée à l'application que vous avez créée dans Bluemix. Cette -valeur est sensible à la casse. - -####bluemixRegionSuffix -{: ios-bluemixRegionSuffix} - -Indique l'emplacement où l'appli est hébergée. Le paramètre `bluemixRegion` spécifie le déploiement Bluemix que vous utilisez. ous pouvez définir cette valeur avec une propriété statique `BMSClient.REGION` et utiliser l'une des trois valeurs suivantes : - -- BMSClient.Region.usSouth -- BMSClient.Region.unitedKingdom -- BMSClient.Region.sydney - -####AppGUID -{: ios-AppGUID} - -Spécifie la clé AppGUID unique qui a été affectée au service {{site.data.keyword.mobilepushshort}} que vous avez créé dans Bluemix. - -###Initialisation du logiciel SDK Push du client -{: initializing-the-client-Push-SDK} - -``` - //Initialisation du SDK Push client pour Swift -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -## Enregistrement d'applications et d'appareils iOS -{: #enable-push-ios-notifications-register} - - -Une application doit être enregistrée auprès d'APNS pour pouvoir recevoir des notifications distantes, après installation sur un appareil. Une fois que le jeton d'appareil généré par APNS est reçu par l'application, il doit être transmis au service {{site.data.keyword.mobilepushshort}}. - -Pour enregistrer les applications et les appareils iOS, vous devez : - -1. Créez une application d'arrière plan. -2. Passer le jeton à {{site.data.keyword.mobilepushshort}}. - - -###Créez une application d'arrière plan -{: create-a-backend-app} - -Créez une application d'arrière plan dans la section Boilerplates du catalogue Bluemix® , ce qui lie automatiquement le service {{site.data.keyword.mobilepushshort}} à cette application. Si -vous avez déjà créé une application dorsale, prenez soin de la lier au service {{site.data.keyword.mobilepushshort}}. - - -###Passage de jetons à {{site.data.keyword.mobilepushshort}} -{: pass-token-push-notifications} - -Une fois que le jeton envoyé par APNS a été reçu, transmettez-le à {{site.data.keyword.mobilepushshort}} dans le cadre de la méthode `registerWithDeviceToken`. - -Une fois que le jeton envoyé par APNS a été reçu, transmettez-le au service de notifications push dans le cadre de la méthode `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` - func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ - let push = BMSPushClient.sharedInstance - push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - } -``` - {: codeblock} - - -## Réception de notifications push sur des appareils iOS -{: #enable-push-ios-notifications-receiving} - - -Pour recevoir des notifications push sur des appareils iOS, ajoutez la méthode Swift suivante au délégué d'application de votre application : - -``` - // Pour Swift -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) - { //Le dictionnaire UserInfo contiendra des données envoyées depuis le serveur } -``` - {: codeblock} - -## Suivi des applications push sur les unités iOS -{: ios-monitoring} - -Pour surveiller le statut actuel de la notification, ajoutez la méthode Swift suivante au délégué d'application de votre -application. - -``` - // Envoi du statut de la notification lorsque l'application est ouverte en cliquant sur les notifications -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - print("Send message status to the Push server") - } -} -``` - {: codeblock} - -``` - // Envoi du statut de notification lorsque l'application est en mode arrière-plan. - func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { - let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) - self.showAlert(title: "Recieved Push notifications", message: payLoad) - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - completionHandler(UIBackgroundFetchResult.newData) - } -} -``` - {: codeblock} - - -## Envoi de notifications push de base -{: #send} - -Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base. - -Pour envoyer des notifications push de base, procédez comme suit : - -1. Sélectionnez **Envoyer des notifications** et rédigez un message en choisissant une option **Envoyer à**. Les options prises en charge sont **Appareil par étiquette**, **ID de l'appareil**, **ID utilisateur**, **Appareils Android**, **Appareils IOS**, **Notifications Web** et **Tous les appareils**. -**Remarque **: si vous sélectionnez l'option **Tous les appareils**, tous les appareils qui sont abonnés à des notifications de type {{site.data.keyword.mobilepushshort}} recevront les notifications. -![Ecran Notifications](images/tag_notification.jpg) - -2. Dans la zone **Message**, composez votre message. Configurez les paramètres facultatifs, selon les besoins. -3. Cliquez sur **Envoyer**. -3. Vérifiez que vos appareils ont reçu votre notification. - -L'image suivante présente une boîte de dialogue d'alerte qui traite une notification de type {{site.data.keyword.mobilepushshort}} sur un appareil iOS. - -![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) - -### Paramètres facultatifs pour l'envoi de notifications -{: #send_ios_otpional_setting} - -Vous pouvez personnaliser les paramètres de type {{site.data.keyword.mobilepushshort}} pour l'envoi de notifications vers des appareils iOS. Les options de personnalisation facultative suivantes sont prises en charge. - -- **Badge** : indique le nombre qui s'affiche sur le badge d'application. La valeur par défaut, zéro (0), n'affiche pas de badge. -- **Son** : indique le clip audio à exécuter à réception d'une notification. Prend en charge le fichier par défaut ou utilise le nom de la ressource audio intégré dans l'application. -- **Contenu supplémentaire** : spécifie les valeurs de contenu personnalisées pour vos notifications. - -##Activation des notifications interactives - -Vous pouvez à présent enrichir vos notifications iOS en leur ajoutant plus de détails, comme une image, une mappe ou un bouton de réponse en activant les notifications interactives. Ceci -fournit des informations de contexte supplémentaires aux utilisateurs, ainsi que la possibilité de lancer une action immédiate sans quitter le contexte en cours. - -Pour activer les notifications interactives, utilisez le code suivant : - -``` - // Ceci définit l'action du bouton. - let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) -``` - {: codeblock} -``` - // Ceci définit la catégorie pour les boutons -let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) -``` - {: codeblock} -``` - // Ceci met à jour l'enregistrement en incluant le buttonsPass de la catégorie définie dans iOS BMSPushClientOptions -let notificationOptions = BMSPushClientOptions(categoryName: [category]) -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) -``` - {: codeblock} - -Pour envoyer une notification interactive, procédez comme suit : - -1. Dans la section Compose, pour la liste déroulante Envoyer à, sélectionnez **Appareils IOS**. -2. Entrez le message de notification que vous voudrez peut-être envoyer. -3. Dans la section Paramètres facultatifs, sélectionnez **Mobile** et cliquez sur **iOS**. -4. Dans la liste déroulante Type, sélectionnez **Mixte**. -5. Dans la zone Catégorie, spécifiez le type de notification que vous avez défini dans votre application. - -![Notification interactive pour iOS](images/push_ios_notification_interactive.jpg) - -## Etapes suivantes -{: #next_steps_tags} - -Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options -avancées. - -Ajoutez ces fonctions du service de notifications push à votre application. -Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). -Pour utiliser des options de notification avancées, voir [Activation des notifications push avancées](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +#Activation de l'envoi de {{site.data.keyword.mobilepushshort}} par les applications iOS +{: #enable-push-ios-notifications} +Dernière mise à jour : 14 février 2017 +{: .last-updated} + +Vous pouvez permettre aux applications iOS d'envoyer des {{site.data.keyword.mobilepushshort}} à vos appareils. + + +##Installation de CocoaPods +{: #enable-push-ios-notifications-install} + +Pour un projet Xcode existant, vous pouvez configurer le logiciel SDK client des services Bluemix Mobile en utilisant l'outil de gestion des dépendances CocoaPods. Vous pouvez aussi installer le logiciel SDK manuellement. + +Pour consulter le fichier Readme de Swift Push, accédez au site [Readme![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. + + + +1. Installez CocoaPods en exécutant la commande suivante sur votre terminal Mac : +```$ sudo gem install cocoapods +``` + {: codeblock} +2. Entrez la commande `pod init` dans le terminal pour initialiser CocoaPods. Assurez-vous de bien exécuter la commande depuis le répertoire où se trouve votre projet Xcode. La commande `pod init` crée un fichier Pod. +3. Dans le fichier Pod généré, ajoutez les dépendances de logiciel SDK requises. Copiez le fichier Pod suivant : + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copiez la liste suivante telle quelle et supprimez les dépendances superflues. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + pod 'BMSAnalyticsAPI' + end + ``` + {: codeblock} + +3. Depuis le terminal, accédez au dossier de votre projet et installez des dépendances avec la commande `pod update`. + +Cette commande installe vos dépendances et crée un nouvel espace de travail Xcode. +**Remarque** : Prenez soin de toujours ouvrir le nouvel espace de travail Xcode au +lieu du fichier de projet Xcode d'origine : +``` + $ open App.xcworkspace +``` + {: codeblock} + +Cet espace de travail contient votre projet d'origine et le projet Pods contenant vos dépendances. Pour modifier le dossier source des services mobiles Bluemix, vous le trouverez dans votre projet Pods, sous `Pods/yourImportedSourceFolder`. Exemple : `Pods/BMSPush`. + +##Ajout d'infrastructures à l'aide de Carthage +{: #carthage} + +Ajoutez des infrastructures à votre projet à l'aide de [Carthage ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}. Notez que Carthage dans Xcode8 n'est pas pris en charge. + +1. Ajoutez des infrastructures `BMSPush` à votre fichier Cartfile : +``` + github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" +``` + {: codeblock} +2. Exécutez la commande `carthage update`. Lorsque la construction est terminée, faites glisser `BMSPush.framework`, `BMSCore.framework` et `BMSAnalyticsAPI.framework` dans votre projet Xcode. +3. Suivez les instructions du site [Carthage ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} pour compléter l'intégration. + +##Configuration du logiciel SDK pour iOS +{: ios-sdk} + +Installez le kit de développement de logiciels (SDK) iOS et ajoutez le code suivant au fichier **AppDelegate.swift** dans votre application. Notez que ceci effectue également un enregistrement auprès des APN. +``` + func application(_ application: UIApplication, +didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool + { + BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") + } +``` + {: codeblock} + +##Utilisation d'infrastructures et de dossiers source importés +{: using-imported-frameworks} + +Référencez le logiciel SDK dans votre code. Vérifiez que les prérequis suivants sont en place. + +- iOS 8.0 ou version ultérieure +- Xcode 7 + +Ecrivez des directives `#import` pour les en-têtes pertinents, par exemple : +``` +//swift +import BMSCore +import BMSPush +``` + {: codeblock} + +Pour consulter le fichier Readme de Swift Push, accédez au site [Readme ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. + +**Remarque** : La mise à jour de votre projet Pods via les commandes CocoaPods `pod install` ou `pod update` peut remplacer les dossiers source des services Bluemix Mobile. Si vous voulez conserver vos versions personnalisées des fichiers d'origine, prenez soin de les sauvegarder avant d'entrer l'une de ces commandes. + + +##Paramètres de génération +{: build-settings} + +Accédez à **Xcode > Build Settings > Build Options** et affectez à l'option Set Enable Bitcode la valeur **No**. + +**Attention** : Depuis iOS 9, des modifications apportées à la fonction App Transport Security (ATS) peuvent avoir un impact sur la façon dont vous gérez le processus d'authentification. Les articles de blogue suivants fournissent des informations supplémentaires sur les modifications : [ATS and Bitcode in iOS 9 ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} et [Connect your iOS 9 app to Bluemix today ![Icône de lien externe](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. + +## Initialisation du logiciel SDK Push pour les applications iOS +{: #enable-push-ios-notifications-initialize} + +Le code d'initialisation se trouve généralement dans le délégué d'application de l'application iOS. Cliquez sur le lien **Options pour application mobile** dans votre tableau de bord Push pour obtenir la route de l'application et l'identificateur global unique. + +###Initialisation du logiciel SDK de base +{: Initializing-the-core-sdk} + + +``` +// Initialisation du SDK Core pour Swift avec l'identificateur global unique GUID, la route et la région Bluemix +let myBMSClient = BMSClient.sharedInstance +myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") +``` + {: codeblock} + +### Route, identificateur global unique et région Bluemix +{: route-guid-bluemix-region} + +####appRoute +{: ios-approute} + +Spécifie la route qui a été affectée à l'application serveur que vous avez créée dans Bluemix. + +####identificateur_global_unique +{: ios-guid} + +Spécifie la clé unique qui a été affectée à l'application que vous avez créée dans Bluemix. Cette +valeur est sensible à la casse. + +####bluemixRegionSuffix +{: ios-bluemixRegionSuffix} + +Indique l'emplacement où l'appli est hébergée. Le paramètre `bluemixRegion` spécifie le déploiement Bluemix que vous utilisez. ous pouvez définir cette valeur avec une propriété statique `BMSClient.REGION` et utiliser l'une des trois valeurs suivantes : + +- BMSClient.Region.usSouth +- BMSClient.Region.unitedKingdom +- BMSClient.Region.sydney + +####AppGUID +{: ios-AppGUID} + +Spécifie la clé AppGUID unique qui a été affectée au service {{site.data.keyword.mobilepushshort}} que vous avez créé dans Bluemix. + +###Initialisation du logiciel SDK Push du client +{: initializing-the-client-Push-SDK} + +``` + //Initialisation du SDK Push client pour Swift +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +## Enregistrement d'applications et d'appareils iOS +{: #enable-push-ios-notifications-register} + + +Une application doit être enregistrée auprès d'APNS pour pouvoir recevoir des notifications distantes, après installation sur un appareil. Une fois que le jeton d'appareil généré par APNS est reçu par l'application, il doit être transmis au service {{site.data.keyword.mobilepushshort}}. + +Pour enregistrer les applications et les appareils iOS, vous devez : + +1. Créez une application d'arrière plan. +2. Passer le jeton à {{site.data.keyword.mobilepushshort}}. + + +###Créez une application d'arrière plan +{: create-a-backend-app} + +Créez une application d'arrière plan dans la section Boilerplates du catalogue Bluemix® , ce qui lie automatiquement le service {{site.data.keyword.mobilepushshort}} à cette application. Si +vous avez déjà créé une application dorsale, prenez soin de la lier au service {{site.data.keyword.mobilepushshort}}. + + +###Passage de jetons à {{site.data.keyword.mobilepushshort}} +{: pass-token-push-notifications} + +Une fois que le jeton envoyé par APNS a été reçu, transmettez-le à {{site.data.keyword.mobilepushshort}} dans le cadre de la méthode `registerWithDeviceToken`. + +Une fois que le jeton envoyé par APNS a été reçu, transmettez-le au service de notifications push dans le cadre de la méthode `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` + func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ + let push = BMSPushClient.sharedInstance + push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + } +``` + {: codeblock} + + +## Réception de notifications push sur des appareils iOS +{: #enable-push-ios-notifications-receiving} + + +Pour recevoir des notifications push sur des appareils iOS, ajoutez la méthode Swift suivante au délégué d'application de votre application : + +``` + // Pour Swift +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) + { //Le dictionnaire UserInfo contiendra des données envoyées depuis le serveur } +``` + {: codeblock} + +## Suivi des applications push sur les unités iOS +{: ios-monitoring} + +Pour surveiller le statut actuel de la notification, ajoutez la méthode Swift suivante au délégué d'application de votre +application. + +``` + // Envoi du statut de la notification lorsque l'application est ouverte en cliquant sur les notifications +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + print("Send message status to the Push server") + } +} +``` + {: codeblock} + +``` + // Envoi du statut de notification lorsque l'application est en mode arrière-plan. + func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { + let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) + self.showAlert(title: "Recieved Push notifications", message: payLoad) + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + completionHandler(UIBackgroundFetchResult.newData) + } +} +``` + {: codeblock} + + +## Envoi de notifications push de base +{: #send} + +Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base. + +Pour envoyer des notifications push de base, procédez comme suit : + +1. Sélectionnez **Envoyer des notifications** et rédigez un message en choisissant une option **Envoyer à**. Les options prises en charge sont **Appareil par étiquette**, **ID de l'appareil**, **ID utilisateur**, **Appareils Android**, **Appareils IOS**, **Notifications Web** et **Tous les appareils**. +**Remarque **: si vous sélectionnez l'option **Tous les appareils**, tous les appareils qui sont abonnés à des notifications de type {{site.data.keyword.mobilepushshort}} recevront les notifications. +![Ecran Notifications](images/tag_notification.jpg) + +2. Dans la zone **Message**, composez votre message. Configurez les paramètres facultatifs, selon les besoins. +3. Cliquez sur **Envoyer**. +3. Vérifiez que vos appareils ont reçu votre notification. + +L'image suivante présente une boîte de dialogue d'alerte qui traite une notification de type {{site.data.keyword.mobilepushshort}} sur un appareil iOS. + +![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) + +### Paramètres facultatifs pour l'envoi de notifications +{: #send_ios_otpional_setting} + +Vous pouvez personnaliser les paramètres de type {{site.data.keyword.mobilepushshort}} pour l'envoi de notifications vers des appareils iOS. Les options de personnalisation facultative suivantes sont prises en charge. + +- **Badge** : indique le nombre qui s'affiche sur le badge d'application. La valeur par défaut, zéro (0), n'affiche pas de badge. +- **Son** : indique le clip audio à exécuter à réception d'une notification. Prend en charge le fichier par défaut ou utilise le nom de la ressource audio intégré dans l'application. +- **Contenu supplémentaire** : spécifie les valeurs de contenu personnalisées pour vos notifications. + +##Activation des notifications interactives + +Vous pouvez à présent enrichir vos notifications iOS en leur ajoutant plus de détails, comme une image, une mappe ou un bouton de réponse en activant les notifications interactives. Ceci +fournit des informations de contexte supplémentaires aux utilisateurs, ainsi que la possibilité de lancer une action immédiate sans quitter le contexte en cours. + +Pour activer les notifications interactives, utilisez le code suivant : + +``` + // Ceci définit l'action du bouton. + let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) +``` + {: codeblock} +``` + // Ceci définit la catégorie pour les boutons +let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) +``` + {: codeblock} +``` + // Ceci met à jour l'enregistrement en incluant le buttonsPass de la catégorie définie dans iOS BMSPushClientOptions +let notificationOptions = BMSPushClientOptions(categoryName: [category]) +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) +``` + {: codeblock} + +Pour envoyer une notification interactive, procédez comme suit : + +1. Dans la section Compose, pour la liste déroulante Envoyer à, sélectionnez **Appareils IOS**. +2. Entrez le message de notification que vous voudrez peut-être envoyer. +3. Dans la section Paramètres facultatifs, sélectionnez **Mobile** et cliquez sur **iOS**. +4. Dans la liste déroulante Type, sélectionnez **Mixte**. +5. Dans la zone Catégorie, spécifiez le type de notification que vous avez défini dans votre application. + +![Notification interactive pour iOS](images/push_ios_notification_interactive.jpg) + +## Etapes suivantes +{: #next_steps_tags} + +Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options +avancées. + +Ajoutez ces fonctions du service de notifications push à votre application. +Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). +Pour utiliser des options de notification avancées, voir [Activation des notifications push avancées](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/fr/c_overview_push.md b/services/mobilepush/nl/fr/c_overview_push.md index 9bfd83abe..4b3fe211e 100644 --- a/services/mobilepush/nl/fr/c_overview_push.md +++ b/services/mobilepush/nl/fr/c_overview_push.md @@ -1,132 +1,132 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# A propos de {{site.data.keyword.mobilepushshort}} -{: #overview-push} -Dernière mise à jour : 18 janvier 2017 -{: .last-updated} - -IBM {{site.data.keyword.mobilepushshort}} est un service que vous pouvez utiliser pour envoyer des notifications à des appareils et des plateformes. Les notifications peuvent être ciblées vers tous les utilisateurs d'application ou vers un ensemble spécifique d'utilisateurs et d'appareils à l'aide de balises. Vous pouvez administrer les appareils, les balises et les abonnements. - -Vous pouvez utiliser l'une des options suivantes pour créer un service lié ou non lié : - -- En créant une application Bluemix à l'aide du conteneur boilerplate de MobileFirst Services Starter du catalogue. Ceci crée un service Push -Notifications lié à une application dorsale Bluemix. -- En créant directement depuis le catalogue Mobile un service Push Notifications non lié. Vous pouvez le lier par la suite à une -application ou même opter de l'utiliser comme service non lié. -- En utilisant le [Tableau de bord Mobile ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}. - -Notez que l'onglet de surveillance {{site.data.keyword.mobilepushshort}} n'affiche pas de données d'analyse. - -Le service {{site.data.keyword.mobilepushshort}} est maintenant activé pour OpenWhisk. Pour plus d'informations, voir [OpenWhisk](/docs/openwhisk/index.html). - - -## Processus du service {{site.data.keyword.mobilepushshort}} -{: #overview_push_process} - -Les clients mobiles et de navigateurs Web et les applications et extensions Google Chrome peuvent souscrire au service {{site.data.keyword.mobilepushshort}} et s'y enregistrer. Au démarrage, les applications client s'inscrivent et s'abonnent elles-mêmes au service {{site.data.keyword.mobilepushshort}}. Les notifications sont réparties sur le serveur APNS (Apple Push Notification service) ou FCM (Firebase Cloud Messaging)/Google Cloud Messaging (GCM) puis envoyées aux clients de navigateur ou appareils mobiles enregistrés. - -![Présentation de Push](images/overview.jpg) - - -###Applications mobiles et applications de navigateur -{: mobile-applications} - -Au démarrage, les applications client s'inscrivent et s'abonnent elles-mêmes au service {{site.data.keyword.mobilepushshort}} pour recevoir des notifications. - -###Applications de back end -{: backend-applications} - -Les applications de back end peuvent se trouver sur site ou dans un cloud public. Elles utilisent le service {{site.data.keyword.mobilepushshort}} pour envoyer des notifications qui dépendent du contexte aux utilisateurs d'applications mobiles et d'applications de navigateur. Elles n'ont pas besoin d'assurer la maintenance et la gestion des appareils mobiles, des agents de navigateur et des informations utilisateur pour l'envoi des notifications push. Au lieu de cela, les applications peuvent utiliser le service {{site.data.keyword.mobilepushshort}} qui se chargera des ces opérations. - -###Propriétaire de l'application de back end -{: app-backend-owner} - -Le propriétaire de l'application de back end crée l'application de back end qui comporte une instance du service {{site.data.keyword.mobilepushshort}}. Il configure et paramètre aussi le service {{site.data.keyword.mobilepushshort}} pour l'adapter aux applications de back end en l'utilisant en même temps que les applications mobiles et les applications de navigateur définies comme cible pour {{site.data.keyword.mobilepushshort}}. - -###Service {{site.data.keyword.mobilepushshort}} -{: push-notification-service} - -Le service {{site.data.keyword.mobilepushshort}} gère les informations relatives aux appareils mobiles et aux clients de navigateur Web qui sont enregistrés pour les notifications. Avec ce service, les détails de la technologie permettant d'envoyer des notifications à ces plateformes mobiles et de navigateur Web hétérogènes restent transparents pour les applications. - -###Passerelles -{: gateways} - -Il s'agit de services de cloud de notifications push spécifiques aux plateformes, comme FCM/GCM ou APNS (Apple Push Notification service), qui sont utilisés par le service IBM {{site.data.keyword.mobilepushshort}} pour envoyer des notifications aux applications mobiles et aux applications de navigateur. - -###Sécurité Push -{: push-security} - -Les API {{site.data.keyword.mobilepushshort}} sont sécurisées par deux types de valeur confidentielle : - -- **appSecret** : 'appSecret' protège les API généralement appelées par des applications dorsales (telles que l'API d'envoi -de {{site.data.keyword.mobilepushshort}} et l'API de configuration des paramètres). -- **clientSecret** : 'clientSecret' protège les API généralement appelées par des applications de client mobile. Il n'y a qu'une seule API relative à l'enregistrement d'un appareil avec un ID utilisateur associé qui nécessite cette valeur confidentielle clientSecret. Aucune des autres API invoquées depuis les clients mobiles n'ont besoin de clientSecret. - -Les valeurs appSecret et clientSecret sont allouées à chaque instance de service au moment de la liaison d'une application au service {{site.data.keyword.mobilepushshort}}. Reportez-vous à la documentation des [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/) pour plus d'informations sur la transmission des valeurs confidentielles et pour quelles API. - -**Remarque** : Les applications plus anciennes ne devaient transmettre le clientSecret que lors de l'enregistrement ou de la mise à jour -d'appareils avec la zone userId. Toutes les autres interfaces API invoquées par des clients mobiles et de navigateur n'avaient pas besoin de clientSecret. Toutes ces anciennes applications peuvent continuer à se servir facultativement de clientSecret pour les enregistrements d'appareil ou la mise à jour des appels. Il est toutefois vivement conseillé d'appliquer une vérification clientSecret pour tous les appels d'API client. Pour mettre en oeuvre ce processus dans les applications existantes, une nouvelle API, verifyClientSecret, a été publiée. Pour les nouvelles applications, la vérification clientSecret sera mise en oeuvre sur tous les appels d'API client et ce comportement ne peut être modifié avec l'API verfiyClientSecret. - -Par défaut, la vérification de la valeur confidentielle n'est appliquée que dans les nouvelles applications, mais aussi bien les applications existantes que les applications nouvelles sont autorisées à activer ou désactiver cette vérification en utilisant l'API REST verifyClientSecret. Il est conseillé d'imposer la vérification de la valeur confidentielle pour éviter d'exposer des appareils à des utilisateurs qui pourraient avoir connaissance des valeurs applicationId et deviceId. - -Prenez soin de préserver la confidentialité de clientSecret et ne procédez jamais à un codage en dur dans l'application mobile. Il existe différents modèles d'initialisation d'application qui peuvent être utilisés pour extraire dynamiquement la valeur confidentielle clientSecret durant l'exécution de l'application. Le diagramme de séquence décrit ce modèle possible. -![Enable_Push](images/init_client_secret.jpg) - -## Types {{site.data.keyword.mobilepushshort}} -{: #overview-push-types} - -###Diffusion -{: broadcast} - -Quand une application client s'enregistre auprès du service {{site.data.keyword.mobilepushshort}}, elle peut commencer à recevoir des diffusions. Les notifications de diffusion sont des messages ciblés vers toutes les instances d'une application installée sur des appareils mobiles et des navigateurs ou implémentée en tant qu'application ou instance d'application Chrome et configurée pour le service {{site.data.keyword.mobilepushshort}} ; elles sont activées par défaut dans toute application activée pour {{site.data.keyword.mobilepushshort}}. Les applications activées pour le service {{site.data.keyword.mobilepushshort}} possèdent un abonnement prédéfini à la balise Push.ALL, qui est utilisé par le serveur pour diffuser des messages de notification de diffusion à tous les appareils. Pour envoyer une notification de diffusion qui utilise l'API REST Push, assurez-vous que la "cible" est un fichier JSON vide lors de l'envoi à la ressource de message. - -###Notifications basées sur les balises -{: tag-based-notifications} - -Les notifications basées sur les balises sont des messages qui sont ciblés vers tous les appareils abonnés à une balise particulière. Elles permettent la segmentation des notifications en fonction de domaines ou de rubriques. Les destinataires des notifications peuvent choisir de ne recevoir les notifications que si elles concernent un sujet ou une rubrique qui les intéresse. Par conséquent, les notifications en fonction d'une balise constituent un moyen de segmenter les destinataires. Cette fonction permet de définir des balises, puis d'envoyer et de recevoir des messages en fonction des balises. Un message n'est ciblé que vers les instances d'application client (sur un appareil mobile, un navigateur ou une extension) qui sont abonnées à la balise. Vous devez d'abord créer des balises pour l'application, configurer les abonnements aux balises puis initier les notifications basées sur une balise. Pour envoyer une notification basée sur une balise qui utilise l'API REST, vérifiez que les éléments "tagNames" sont fournis lors de l'envoi à la ressource de message. - -###Notifications Unicast -{: unicast-notifications} - -Les notifications Unicast sont des messages qui sont envoyés à un appareil ou utilisateur spécifique. Elles ne requièrent pas de configuration supplémentaire et sont activées par défaut quand l'application est activée pour {{site.data.keyword.mobilepushshort}}. - -Toutefois, les notifications Unicast ciblées vers des utilisateurs nécessitent l'association d'un ID utilisateur à un appareil au moment de l'enregistrement de l'appareil mobile client, du navigateur Web ou des applications et extensions Chrome pour {{site.data.keyword.mobilepushshort}}. - -En général, une application client exécute d'abord un cycle d'authentification au cours duquel l'utilisateur d'application mobile est authentifié auprès d'un service d'authentification comme [Mobile Client Access](docs/services/mobileaccess/index.html). Si l'authentification aboutit, l'ID de l'utilisateur authentifié est transféré vers l'API d'enregistrement d'appareil Push. -Pour envoyer une notifications Unicast via une API REST, veillez à ce que les ID d'appareil ou d'utilisateur soient fournis lors de l'envoi à une ressource de message. - -###Notifications en fonction de la plateforme -{: platform-based-notifications} - -Les notifications peuvent être ciblées afin de viser une plateforme d'appareil particulière. Ainsi, une notification peut être envoyée uniquement aux utilisateurs Android ou aux utilisateurs Google Chrome. Pour envoyer une notification en fonction de la plateforme qui utilise l'API REST, veillez à ce que les plateformes ciblées soient fournies lors de l'envoi à une ressource de message. Spécifiez les plateformes dans un tableau. Les plateformes prises en charge sont les suivantes : -* A (Apple) -* G (Google) -* WEB_CHROME (Web Push navigateur Google Chrome) -* WEB_FIREFOX (Web Push navigateur Mozilla Firefox) -* WEB_SAFARI (Web Push navigateur Safari) -* APPEXT_CHROME (Applications et extensions Google Chrome) - -## Taille des messages de type {{site.data.keyword.mobilepushshort}} -{: #push-message-size} - -La taille d'un message de type {{site.data.keyword.mobilepushshort}} dépend des contraintes imposées par les passerelles (FCM/GCM, APNS) et les plateformes client. - -### iOS et Safari -{: ios-message-size} - -Pour iOS 8 et ultérieur, la taille maximale autorisée est de 2 kilo-octets. Le service des notifications push d'Apple n'envoie pas les notifications qui dépassent cette limite. - -###Android, navigateur Firefox, navigateur Chrome et Applications et extensions Chrome -{: android-message-size} - -La taille de la charge maximale autorisée pour les messages est de 4 kilo-octets. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# A propos de {{site.data.keyword.mobilepushshort}} +{: #overview-push} +Dernière mise à jour : 18 janvier 2017 +{: .last-updated} + +IBM {{site.data.keyword.mobilepushshort}} est un service que vous pouvez utiliser pour envoyer des notifications à des appareils et des plateformes. Les notifications peuvent être ciblées vers tous les utilisateurs d'application ou vers un ensemble spécifique d'utilisateurs et d'appareils à l'aide de balises. Vous pouvez administrer les appareils, les balises et les abonnements. + +Vous pouvez utiliser l'une des options suivantes pour créer un service lié ou non lié : + +- En créant une application Bluemix à l'aide du conteneur boilerplate de MobileFirst Services Starter du catalogue. Ceci crée un service Push +Notifications lié à une application dorsale Bluemix. +- En créant directement depuis le catalogue Mobile un service Push Notifications non lié. Vous pouvez le lier par la suite à une +application ou même opter de l'utiliser comme service non lié. +- En utilisant le [Tableau de bord Mobile ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}. + +Notez que l'onglet de surveillance {{site.data.keyword.mobilepushshort}} n'affiche pas de données d'analyse. + +Le service {{site.data.keyword.mobilepushshort}} est maintenant activé pour OpenWhisk. Pour plus d'informations, voir [OpenWhisk](/docs/openwhisk/index.html). + + +## Processus du service {{site.data.keyword.mobilepushshort}} +{: #overview_push_process} + +Les clients mobiles et de navigateurs Web et les applications et extensions Google Chrome peuvent souscrire au service {{site.data.keyword.mobilepushshort}} et s'y enregistrer. Au démarrage, les applications client s'inscrivent et s'abonnent elles-mêmes au service {{site.data.keyword.mobilepushshort}}. Les notifications sont réparties sur le serveur APNS (Apple Push Notification service) ou FCM (Firebase Cloud Messaging)/Google Cloud Messaging (GCM) puis envoyées aux clients de navigateur ou appareils mobiles enregistrés. + +![Présentation de Push](images/overview.jpg) + + +###Applications mobiles et applications de navigateur +{: mobile-applications} + +Au démarrage, les applications client s'inscrivent et s'abonnent elles-mêmes au service {{site.data.keyword.mobilepushshort}} pour recevoir des notifications. + +###Applications de back end +{: backend-applications} + +Les applications de back end peuvent se trouver sur site ou dans un cloud public. Elles utilisent le service {{site.data.keyword.mobilepushshort}} pour envoyer des notifications qui dépendent du contexte aux utilisateurs d'applications mobiles et d'applications de navigateur. Elles n'ont pas besoin d'assurer la maintenance et la gestion des appareils mobiles, des agents de navigateur et des informations utilisateur pour l'envoi des notifications push. Au lieu de cela, les applications peuvent utiliser le service {{site.data.keyword.mobilepushshort}} qui se chargera des ces opérations. + +###Propriétaire de l'application de back end +{: app-backend-owner} + +Le propriétaire de l'application de back end crée l'application de back end qui comporte une instance du service {{site.data.keyword.mobilepushshort}}. Il configure et paramètre aussi le service {{site.data.keyword.mobilepushshort}} pour l'adapter aux applications de back end en l'utilisant en même temps que les applications mobiles et les applications de navigateur définies comme cible pour {{site.data.keyword.mobilepushshort}}. + +###Service {{site.data.keyword.mobilepushshort}} +{: push-notification-service} + +Le service {{site.data.keyword.mobilepushshort}} gère les informations relatives aux appareils mobiles et aux clients de navigateur Web qui sont enregistrés pour les notifications. Avec ce service, les détails de la technologie permettant d'envoyer des notifications à ces plateformes mobiles et de navigateur Web hétérogènes restent transparents pour les applications. + +###Passerelles +{: gateways} + +Il s'agit de services de cloud de notifications push spécifiques aux plateformes, comme FCM/GCM ou APNS (Apple Push Notification service), qui sont utilisés par le service IBM {{site.data.keyword.mobilepushshort}} pour envoyer des notifications aux applications mobiles et aux applications de navigateur. + +###Sécurité Push +{: push-security} + +Les API {{site.data.keyword.mobilepushshort}} sont sécurisées par deux types de valeur confidentielle : + +- **appSecret** : 'appSecret' protège les API généralement appelées par des applications dorsales (telles que l'API d'envoi +de {{site.data.keyword.mobilepushshort}} et l'API de configuration des paramètres). +- **clientSecret** : 'clientSecret' protège les API généralement appelées par des applications de client mobile. Il n'y a qu'une seule API relative à l'enregistrement d'un appareil avec un ID utilisateur associé qui nécessite cette valeur confidentielle clientSecret. Aucune des autres API invoquées depuis les clients mobiles n'ont besoin de clientSecret. + +Les valeurs appSecret et clientSecret sont allouées à chaque instance de service au moment de la liaison d'une application au service {{site.data.keyword.mobilepushshort}}. Reportez-vous à la documentation des [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/) pour plus d'informations sur la transmission des valeurs confidentielles et pour quelles API. + +**Remarque** : Les applications plus anciennes ne devaient transmettre le clientSecret que lors de l'enregistrement ou de la mise à jour +d'appareils avec la zone userId. Toutes les autres interfaces API invoquées par des clients mobiles et de navigateur n'avaient pas besoin de clientSecret. Toutes ces anciennes applications peuvent continuer à se servir facultativement de clientSecret pour les enregistrements d'appareil ou la mise à jour des appels. Il est toutefois vivement conseillé d'appliquer une vérification clientSecret pour tous les appels d'API client. Pour mettre en oeuvre ce processus dans les applications existantes, une nouvelle API, verifyClientSecret, a été publiée. Pour les nouvelles applications, la vérification clientSecret sera mise en oeuvre sur tous les appels d'API client et ce comportement ne peut être modifié avec l'API verfiyClientSecret. + +Par défaut, la vérification de la valeur confidentielle n'est appliquée que dans les nouvelles applications, mais aussi bien les applications existantes que les applications nouvelles sont autorisées à activer ou désactiver cette vérification en utilisant l'API REST verifyClientSecret. Il est conseillé d'imposer la vérification de la valeur confidentielle pour éviter d'exposer des appareils à des utilisateurs qui pourraient avoir connaissance des valeurs applicationId et deviceId. + +Prenez soin de préserver la confidentialité de clientSecret et ne procédez jamais à un codage en dur dans l'application mobile. Il existe différents modèles d'initialisation d'application qui peuvent être utilisés pour extraire dynamiquement la valeur confidentielle clientSecret durant l'exécution de l'application. Le diagramme de séquence décrit ce modèle possible. +![Enable_Push](images/init_client_secret.jpg) + +## Types {{site.data.keyword.mobilepushshort}} +{: #overview-push-types} + +###Diffusion +{: broadcast} + +Quand une application client s'enregistre auprès du service {{site.data.keyword.mobilepushshort}}, elle peut commencer à recevoir des diffusions. Les notifications de diffusion sont des messages ciblés vers toutes les instances d'une application installée sur des appareils mobiles et des navigateurs ou implémentée en tant qu'application ou instance d'application Chrome et configurée pour le service {{site.data.keyword.mobilepushshort}} ; elles sont activées par défaut dans toute application activée pour {{site.data.keyword.mobilepushshort}}. Les applications activées pour le service {{site.data.keyword.mobilepushshort}} possèdent un abonnement prédéfini à la balise Push.ALL, qui est utilisé par le serveur pour diffuser des messages de notification de diffusion à tous les appareils. Pour envoyer une notification de diffusion qui utilise l'API REST Push, assurez-vous que la "cible" est un fichier JSON vide lors de l'envoi à la ressource de message. + +###Notifications basées sur les balises +{: tag-based-notifications} + +Les notifications basées sur les balises sont des messages qui sont ciblés vers tous les appareils abonnés à une balise particulière. Elles permettent la segmentation des notifications en fonction de domaines ou de rubriques. Les destinataires des notifications peuvent choisir de ne recevoir les notifications que si elles concernent un sujet ou une rubrique qui les intéresse. Par conséquent, les notifications en fonction d'une balise constituent un moyen de segmenter les destinataires. Cette fonction permet de définir des balises, puis d'envoyer et de recevoir des messages en fonction des balises. Un message n'est ciblé que vers les instances d'application client (sur un appareil mobile, un navigateur ou une extension) qui sont abonnées à la balise. Vous devez d'abord créer des balises pour l'application, configurer les abonnements aux balises puis initier les notifications basées sur une balise. Pour envoyer une notification basée sur une balise qui utilise l'API REST, vérifiez que les éléments "tagNames" sont fournis lors de l'envoi à la ressource de message. + +###Notifications Unicast +{: unicast-notifications} + +Les notifications Unicast sont des messages qui sont envoyés à un appareil ou utilisateur spécifique. Elles ne requièrent pas de configuration supplémentaire et sont activées par défaut quand l'application est activée pour {{site.data.keyword.mobilepushshort}}. + +Toutefois, les notifications Unicast ciblées vers des utilisateurs nécessitent l'association d'un ID utilisateur à un appareil au moment de l'enregistrement de l'appareil mobile client, du navigateur Web ou des applications et extensions Chrome pour {{site.data.keyword.mobilepushshort}}. + +En général, une application client exécute d'abord un cycle d'authentification au cours duquel l'utilisateur d'application mobile est authentifié auprès d'un service d'authentification comme [Mobile Client Access](docs/services/mobileaccess/index.html). Si l'authentification aboutit, l'ID de l'utilisateur authentifié est transféré vers l'API d'enregistrement d'appareil Push. +Pour envoyer une notifications Unicast via une API REST, veillez à ce que les ID d'appareil ou d'utilisateur soient fournis lors de l'envoi à une ressource de message. + +###Notifications en fonction de la plateforme +{: platform-based-notifications} + +Les notifications peuvent être ciblées afin de viser une plateforme d'appareil particulière. Ainsi, une notification peut être envoyée uniquement aux utilisateurs Android ou aux utilisateurs Google Chrome. Pour envoyer une notification en fonction de la plateforme qui utilise l'API REST, veillez à ce que les plateformes ciblées soient fournies lors de l'envoi à une ressource de message. Spécifiez les plateformes dans un tableau. Les plateformes prises en charge sont les suivantes : +* A (Apple) +* G (Google) +* WEB_CHROME (Web Push navigateur Google Chrome) +* WEB_FIREFOX (Web Push navigateur Mozilla Firefox) +* WEB_SAFARI (Web Push navigateur Safari) +* APPEXT_CHROME (Applications et extensions Google Chrome) + +## Taille des messages de type {{site.data.keyword.mobilepushshort}} +{: #push-message-size} + +La taille d'un message de type {{site.data.keyword.mobilepushshort}} dépend des contraintes imposées par les passerelles (FCM/GCM, APNS) et les plateformes client. + +### iOS et Safari +{: ios-message-size} + +Pour iOS 8 et ultérieur, la taille maximale autorisée est de 2 kilo-octets. Le service des notifications push d'Apple n'envoie pas les notifications qui dépassent cette limite. + +###Android, navigateur Firefox, navigateur Chrome et Applications et extensions Chrome +{: android-message-size} + +La taille de la charge maximale autorisée pour les messages est de 4 kilo-octets. diff --git a/services/mobilepush/nl/fr/c_rich_media_notifications.md b/services/mobilepush/nl/fr/c_rich_media_notifications.md index 1f7e7c2e1..7df43c0b2 100644 --- a/services/mobilepush/nl/fr/c_rich_media_notifications.md +++ b/services/mobilepush/nl/fr/c_rich_media_notifications.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Activation des notifications Rich Media (média enrichi) -{: #interactive-notifications} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - - -Vous pouvez activer Rich Media {{site.data.keyword.mobilepushshort}} dans iOS 10 et versions ultérieures. Les notifications Push peuvent être -envoyées avec un contenu audio, vidéo, des GIF et des images. - -Pour configurer votre application pour recevoir des contenus push enrichis dans iOS 10, procédez comme suit : - -1. Dans Xcode, sélectionnez **Fichier** > **Nouveau ** > **Cible** > **Extension de -service de notification**. -2. Sur la méthode `didReceive()` dans `UNNotificationServiceExtension`, ajoutez le code. -``` -BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) -``` - -Pour envoyer un contenu Rich Media {{site.data.keyword.mobilepushshort}} depuis le tableau de bord Push, prenez soin de renseigner les zones -message, titre, sous-titre et attachmentURL. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Activation des notifications Rich Media (média enrichi) +{: #interactive-notifications} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + + +Vous pouvez activer Rich Media {{site.data.keyword.mobilepushshort}} dans iOS 10 et versions ultérieures. Les notifications Push peuvent être +envoyées avec un contenu audio, vidéo, des GIF et des images. + +Pour configurer votre application pour recevoir des contenus push enrichis dans iOS 10, procédez comme suit : + +1. Dans Xcode, sélectionnez **Fichier** > **Nouveau ** > **Cible** > **Extension de +service de notification**. +2. Sur la méthode `didReceive()` dans `UNNotificationServiceExtension`, ajoutez le code. +``` +BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) +``` + +Pour envoyer un contenu Rich Media {{site.data.keyword.mobilepushshort}} depuis le tableau de bord Push, prenez soin de renseigner les zones +message, titre, sous-titre et attachmentURL. diff --git a/services/mobilepush/nl/fr/c_tag_basednotifications.md b/services/mobilepush/nl/fr/c_tag_basednotifications.md index 0a102cd42..e9318965c 100644 --- a/services/mobilepush/nl/fr/c_tag_basednotifications.md +++ b/services/mobilepush/nl/fr/c_tag_basednotifications.md @@ -1,21 +1,21 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Activation de notifications basées balises -{: #tag_based_notifications} -Dernière mise à jour : 16 janvier 2017 -{: .last-updated} - -Les messages de notifications basés balise ciblent tous les périphériques abonnés à une balise spécifique. - -Vous pouvez définir des balises, puis envoyer et recevoir des messages en fonction des balises. Vous devez d'abord créer les balises pour l'application, configurer les abonnements aux balises, puis initier les -notifications en fonction d'une balise. Pour envoyer une notification basée sur les balises à l'aide de l'[API REST](https://mobile.{DomainName}/imfpush/){: new_window}, vérifiez que les éléments "tagNames" sont fournis lors de l'envoi à la ressource de message. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Activation de notifications basées balises +{: #tag_based_notifications} +Dernière mise à jour : 16 janvier 2017 +{: .last-updated} + +Les messages de notifications basés balise ciblent tous les périphériques abonnés à une balise spécifique. + +Vous pouvez définir des balises, puis envoyer et recevoir des messages en fonction des balises. Vous devez d'abord créer les balises pour l'application, configurer les abonnements aux balises, puis initier les +notifications en fonction d'une balise. Pour envoyer une notification basée sur les balises à l'aide de l'[API REST](https://mobile.{DomainName}/imfpush/){: new_window}, vérifiez que les éléments "tagNames" sont fournis lors de l'envoi à la ressource de message. diff --git a/services/mobilepush/nl/fr/c_user_basednotifications.md b/services/mobilepush/nl/fr/c_user_basednotifications.md index ee96a2981..a2f71d7ea 100644 --- a/services/mobilepush/nl/fr/c_user_basednotifications.md +++ b/services/mobilepush/nl/fr/c_user_basednotifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Activation des notifications utilisateur -{: #user_based_notifications} -Dernière mise à jour : 16 janvier 2017 -{: .last-updated} - -Les notifications de type {{site.data.keyword.mobilepushshort}} basées sur les utilisateurs sont envoyées vers les utilisateurs d'applications mobiles avec des messages personnalisés. Avec ce type de notifications, vous pouvez choisir de notifier certains individus spécifiques en fonction de leurs préférences. - -## Enregistrement de l'appareil avec l'ID utilisateur -Pour activer les notifications push ciblées par ID utilisateur, prenez soin d'enregistrer l'appareil avec une zone ID utilisateur définie. - -L'ID utilisateur peut être toute chaîne fournie par l'application à l'API d'enregistrement d'appareil. Généralement, une application mobile exécute d'abord un cycle d'authentification au cours duquel l'utilisateur de l'application mobile s'authentifie auprès d'un service d'authentification tel que [{{site.data.keyword.amafull}} ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}. Si l'authentification aboutit, l'ID de l'utilisateur authentifié est transféré vers l'API d'enregistrement d'appareil Push. - -## Synchronisation de la connexion et de la déconnexion utilisateur - -Vous pouvez choisir de n'envoyer des notifications que si l'utilisateur est connecté. - -Supposez par exemple qu'un appareil est partagé par les membres d'une même famille ou par une équipe au travail et qu'il est nécessaire de s'adresser uniquement à certains de ces utilisateurs. Dans un tel cas, il y aura une séquence de connexion/déconnexion. Ce mécanisme d'authentification permet à l'application d'effectuer un suivi de l'identité de l'utilisateur actuel de l'application, ce qui garantit que les notifications envoyées à un utilisateur spécifique ne sont toujours reçues que par cet utilisateur uniquement. Une fois la connexion effectuée, invoquez l'API d'enregistrement d'appareil en passant l'ID utilisateur de l'utilisateur connecté. De la même façon, avant de vous déconnecter, appelez l'API de désenregistrement de l'appareil. Le séquencement de ces API Push avec les opérations de connexion et de déconnexion garantit que les notifications destinées à un utilisateur spécifique ne sont envoyées qu'à cet utilisateur uniquement. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Activation des notifications utilisateur +{: #user_based_notifications} +Dernière mise à jour : 16 janvier 2017 +{: .last-updated} + +Les notifications de type {{site.data.keyword.mobilepushshort}} basées sur les utilisateurs sont envoyées vers les utilisateurs d'applications mobiles avec des messages personnalisés. Avec ce type de notifications, vous pouvez choisir de notifier certains individus spécifiques en fonction de leurs préférences. + +## Enregistrement de l'appareil avec l'ID utilisateur +Pour activer les notifications push ciblées par ID utilisateur, prenez soin d'enregistrer l'appareil avec une zone ID utilisateur définie. + +L'ID utilisateur peut être toute chaîne fournie par l'application à l'API d'enregistrement d'appareil. Généralement, une application mobile exécute d'abord un cycle d'authentification au cours duquel l'utilisateur de l'application mobile s'authentifie auprès d'un service d'authentification tel que [{{site.data.keyword.amafull}} ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}. Si l'authentification aboutit, l'ID de l'utilisateur authentifié est transféré vers l'API d'enregistrement d'appareil Push. + +## Synchronisation de la connexion et de la déconnexion utilisateur + +Vous pouvez choisir de n'envoyer des notifications que si l'utilisateur est connecté. + +Supposez par exemple qu'un appareil est partagé par les membres d'une même famille ou par une équipe au travail et qu'il est nécessaire de s'adresser uniquement à certains de ces utilisateurs. Dans un tel cas, il y aura une séquence de connexion/déconnexion. Ce mécanisme d'authentification permet à l'application d'effectuer un suivi de l'identité de l'utilisateur actuel de l'application, ce qui garantit que les notifications envoyées à un utilisateur spécifique ne sont toujours reçues que par cet utilisateur uniquement. Une fois la connexion effectuée, invoquez l'API d'enregistrement d'appareil en passant l'ID utilisateur de l'utilisateur connecté. De la même façon, avant de vous déconnecter, appelez l'API de désenregistrement de l'appareil. Le séquencement de ces API Push avec les opérations de connexion et de déconnexion garantit que les notifications destinées à un utilisateur spécifique ne sont envoyées qu'à cet utilisateur uniquement. diff --git a/services/mobilepush/nl/fr/c_web_extensions.md b/services/mobilepush/nl/fr/c_web_extensions.md index bc8a319a6..e3327eee2 100644 --- a/services/mobilepush/nl/fr/c_web_extensions.md +++ b/services/mobilepush/nl/fr/c_web_extensions.md @@ -1,109 +1,109 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Activation des applications et extensions Chrome pour recevoir des notifications de type {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -Dernière mise à jour : 18 janvier 2017 -{: .last-updated} - -Vous pouvez autoriser les applications et extensions Google Chrome à recevoir des -{{site.data.keyword.mobilepushshort}}. Vérifiez que vous avez exécuté la procédure [Configuration des données -d'identification pour un fournisseur de notification](t__main_push_config_provider.html) avant de poursuivre. - -## Installation du logiciel SDK client pour {{site.data.keyword.mobilepushshort}} -{: #web_install} - -Cette rubrique décrit comment installer et utiliser le logiciel SDK Push JavaScript du client afin de développer davantage vos applications et extensions Chrome. - -### Initialisation dans les applications et extensions Google Chrome - -Pour installer le logiciel SDK Javascript dans les applications et extensions Chrome, procédez comme suit : - -Téléchargez les fichiers `BMSPushSDK.js` et `manifest_Chrome_Ext.json` (pour extensions Chrome) ou `manifest_Chrome_App.json` (pour applications Chrome Apps) depuis le site [Bluemix Web push SDK ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. - - - -- Pour les applications Chrome, configurez le fichier manifeste : - 1. Dans le fichier `manifest_Chrome_App.json`, fournissez le nom, la description et les icônes. - 2. Ajoutez le fichier `BMSPushSDK.js` dans `app.background.scripts`. - 3. Changez `manifest_Chrome_App.json` en `manifest.json`. - -- Pour les extensions Chrome, configurez le fichier manifeste : - 1. Dans le fichier `manifest_Chrome_Ext.json`, fournissez le nom, la description et les icônes. - 2. Ajoutez le fichier `BMSPushSDK.js` dans `background.scripts`. - 3. Changez `manifest_Chrome_Ext.json` en `manifest.json`. - -Dans le fichier `background.js`, ajoutez les lignes de code ci-dessous pour recevoir des notifications push : -``` -chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) -chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); -chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); -``` - {: codeblock} - - - -## Initialisation du logiciel SDK Push -{: #web_initialize} - -Initialisez le logiciel SDK Push avec les services {{site.data.keyword.mobilepushshort}} Bluemix `appGUID` et `appRegion`. - -Pour obtenir votre service appGUID, sélectionnez l'option **Configuration** dans le panneau de navigation pour vos services push initialisés puis cliquez sur **Options pour application mobile**. Modifiez le fragment de code pour qu'il utilise le paramètre appGUID de votre service de notifications push Bluemix. - -La valeur de `AppRegion` spécifie l'emplacement où est hébergé le service {{site.data.keyword.mobilepushshort}}. Vous pouvez utiliser l'une des trois valeurs suivantes : - - - Pour Dallas, Etats-Unis : `.ng.bluemix.net` - - Pour le Royaume-Uni : `.eu-gb.bluemix.net` - - Pour Sydney : `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) -``` - {: codeblock} - -## Enregistrement des applications et extensions Chrome -{: #web_register} - -Utilisez l'API `register()` pour enregistrer l'appareil auprès du service {{site.data.keyword.mobilepushshort}}. Pour procéder à un enregistrement depuis Google Chrome, ajoutez la clé d'API FCM (Firebase Cloud Messaging) ou GCM (Google Cloud Messaging) et l'URL de site Web dans le tableau de bord de configuration Web du service {{site.data.keyword.mobilepushshort}} Bluemix. Pour plus d'informations, voir [Configuration de données d'identification pour Google Cloud Messaging (GCM)](t_push_provider_android.html), dans la rubrique relative à la configuration de Chrome. - -Pour l'enregistrement depuis Mozilla Firefox, ajoutez l'URL de site Web dans le tableau de bord de configuration Web du service {{site.data.keyword.mobilepushshort}} Bluemix, dans la configuration Firefox. - -Utilisez les fragments de code ci-après pour procéder à l'enregistrement auprès du service {{site.data.keyword.mobilepushshort}} Bluemix. -``` -var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Activation des applications et extensions Chrome pour recevoir des notifications de type {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +Dernière mise à jour : 18 janvier 2017 +{: .last-updated} + +Vous pouvez autoriser les applications et extensions Google Chrome à recevoir des +{{site.data.keyword.mobilepushshort}}. Vérifiez que vous avez exécuté la procédure [Configuration des données +d'identification pour un fournisseur de notification](t__main_push_config_provider.html) avant de poursuivre. + +## Installation du logiciel SDK client pour {{site.data.keyword.mobilepushshort}} +{: #web_install} + +Cette rubrique décrit comment installer et utiliser le logiciel SDK Push JavaScript du client afin de développer davantage vos applications et extensions Chrome. + +### Initialisation dans les applications et extensions Google Chrome + +Pour installer le logiciel SDK Javascript dans les applications et extensions Chrome, procédez comme suit : + +Téléchargez les fichiers `BMSPushSDK.js` et `manifest_Chrome_Ext.json` (pour extensions Chrome) ou `manifest_Chrome_App.json` (pour applications Chrome Apps) depuis le site [Bluemix Web push SDK ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. + + + +- Pour les applications Chrome, configurez le fichier manifeste : + 1. Dans le fichier `manifest_Chrome_App.json`, fournissez le nom, la description et les icônes. + 2. Ajoutez le fichier `BMSPushSDK.js` dans `app.background.scripts`. + 3. Changez `manifest_Chrome_App.json` en `manifest.json`. + +- Pour les extensions Chrome, configurez le fichier manifeste : + 1. Dans le fichier `manifest_Chrome_Ext.json`, fournissez le nom, la description et les icônes. + 2. Ajoutez le fichier `BMSPushSDK.js` dans `background.scripts`. + 3. Changez `manifest_Chrome_Ext.json` en `manifest.json`. + +Dans le fichier `background.js`, ajoutez les lignes de code ci-dessous pour recevoir des notifications push : +``` +chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) +chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); +chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); +``` + {: codeblock} + + + +## Initialisation du logiciel SDK Push +{: #web_initialize} + +Initialisez le logiciel SDK Push avec les services {{site.data.keyword.mobilepushshort}} Bluemix `appGUID` et `appRegion`. + +Pour obtenir votre service appGUID, sélectionnez l'option **Configuration** dans le panneau de navigation pour vos services push initialisés puis cliquez sur **Options pour application mobile**. Modifiez le fragment de code pour qu'il utilise le paramètre appGUID de votre service de notifications push Bluemix. + +La valeur de `AppRegion` spécifie l'emplacement où est hébergé le service {{site.data.keyword.mobilepushshort}}. Vous pouvez utiliser l'une des trois valeurs suivantes : + + - Pour Dallas, Etats-Unis : `.ng.bluemix.net` + - Pour le Royaume-Uni : `.eu-gb.bluemix.net` + - Pour Sydney : `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) +``` + {: codeblock} + +## Enregistrement des applications et extensions Chrome +{: #web_register} + +Utilisez l'API `register()` pour enregistrer l'appareil auprès du service {{site.data.keyword.mobilepushshort}}. Pour procéder à un enregistrement depuis Google Chrome, ajoutez la clé d'API FCM (Firebase Cloud Messaging) ou GCM (Google Cloud Messaging) et l'URL de site Web dans le tableau de bord de configuration Web du service {{site.data.keyword.mobilepushshort}} Bluemix. Pour plus d'informations, voir [Configuration de données d'identification pour Google Cloud Messaging (GCM)](t_push_provider_android.html), dans la rubrique relative à la configuration de Chrome. + +Pour l'enregistrement depuis Mozilla Firefox, ajoutez l'URL de site Web dans le tableau de bord de configuration Web du service {{site.data.keyword.mobilepushshort}} Bluemix, dans la configuration Firefox. + +Utilisez les fragments de code ci-après pour procéder à l'enregistrement auprès du service {{site.data.keyword.mobilepushshort}} Bluemix. +``` +var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + diff --git a/services/mobilepush/nl/fr/c_web_extensions_send.md b/services/mobilepush/nl/fr/c_web_extensions_send.md index 4de18ec16..9f02bbf09 100644 --- a/services/mobilepush/nl/fr/c_web_extensions_send.md +++ b/services/mobilepush/nl/fr/c_web_extensions_send.md @@ -1,40 +1,40 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Envoi de notifications de base aux Applications et extensions Google Chrome -{: #web_extensions_notifications} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - -Une fois que vous avez développé vos applications, vous pouvez envoyer une notification push. - -1. Sélectionnez **Envoyer des notifications** et rédigez un message en choisissant **Notifications Web** comme option **Envoyer à**. -2. Entrez le message qui doit être distribué dans la zone **Message**. -3. Vous pouvez choisir de fournir des paramètres facultatifs : - - **Titre de la notification** : il s'agit du texte qui s'affichera comme en-tête de l'alerte du message. - - **URL de l'icône de notification** : si votre message doit être distribué avec une icône de notification d'application, fournissez dans cette zone le lien à l'icône. - - **Touche de réduction** : des touches de réduction sont attachées aux notifications. Si plusieurs notifications arrivent séquentiellement avec la même touche de réduction quand l'appareil est hors ligne, elles sont réduites. Quand un appareil passe en ligne, il reçoit des notifications du serveur FCM/GCM et n'affiche que la dernière notification portant la même touche de réduction. Si aucune touche de réduction n'est définie, les nouveaux et les anciens messages sont stockés pour une distribution future. - - **Durée de vie** : cette valeur est définie en secondes. Si ce paramètre n'est pas spécifié, le serveur FCM/GCM stocke le message pendant quatre semaines et tente de le distribuer. La validité expire après quatre semaines. La plage des valeurs possibles va de 0 à 2419200 secondes. - - ****Retarder si inactif : en définissant cette valeur à `true`, vous demandez au serveur FCM/GCM de ne pas distribuer de notification si le serveur est inactif. Définissez cette valeur à `false` pour garantir la distribution de la notification même si l'appareil est en veille. - - **Contenu supplémentaire** : spécifie les valeurs de contenu personnalisées pour vos notifications. - -L'image suivante montre l'option Applications et extensions Google Chrome du tableau de bord. - - ![Ecran Notifications](images/push_chrome_extns.jpg) - -## Etapes suivantes - {: #next_steps_tags} - -Une fois que vous avez configuré les notifications de base, vous pouvez choisir de configurer des notifications basées sur des balises et des options -avancées. - -Ajoutez ces fonctions de service {{site.data.keyword.mobilepushshort}} à votre application. Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). Pour utiliser des options de notification avancées, voir [Activation des notifications push avancées](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Envoi de notifications de base aux Applications et extensions Google Chrome +{: #web_extensions_notifications} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + +Une fois que vous avez développé vos applications, vous pouvez envoyer une notification push. + +1. Sélectionnez **Envoyer des notifications** et rédigez un message en choisissant **Notifications Web** comme option **Envoyer à**. +2. Entrez le message qui doit être distribué dans la zone **Message**. +3. Vous pouvez choisir de fournir des paramètres facultatifs : + - **Titre de la notification** : il s'agit du texte qui s'affichera comme en-tête de l'alerte du message. + - **URL de l'icône de notification** : si votre message doit être distribué avec une icône de notification d'application, fournissez dans cette zone le lien à l'icône. + - **Touche de réduction** : des touches de réduction sont attachées aux notifications. Si plusieurs notifications arrivent séquentiellement avec la même touche de réduction quand l'appareil est hors ligne, elles sont réduites. Quand un appareil passe en ligne, il reçoit des notifications du serveur FCM/GCM et n'affiche que la dernière notification portant la même touche de réduction. Si aucune touche de réduction n'est définie, les nouveaux et les anciens messages sont stockés pour une distribution future. + - **Durée de vie** : cette valeur est définie en secondes. Si ce paramètre n'est pas spécifié, le serveur FCM/GCM stocke le message pendant quatre semaines et tente de le distribuer. La validité expire après quatre semaines. La plage des valeurs possibles va de 0 à 2419200 secondes. + - ****Retarder si inactif : en définissant cette valeur à `true`, vous demandez au serveur FCM/GCM de ne pas distribuer de notification si le serveur est inactif. Définissez cette valeur à `false` pour garantir la distribution de la notification même si l'appareil est en veille. + - **Contenu supplémentaire** : spécifie les valeurs de contenu personnalisées pour vos notifications. + +L'image suivante montre l'option Applications et extensions Google Chrome du tableau de bord. + + ![Ecran Notifications](images/push_chrome_extns.jpg) + +## Etapes suivantes + {: #next_steps_tags} + +Une fois que vous avez configuré les notifications de base, vous pouvez choisir de configurer des notifications basées sur des balises et des options +avancées. + +Ajoutez ces fonctions de service {{site.data.keyword.mobilepushshort}} à votre application. Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). Pour utiliser des options de notification avancées, voir [Activation des notifications push avancées](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/fr/images/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/fr/images/t_enable_actionable_notifications_ios.md index 754e5f4da..38c5a5899 100644 --- a/services/mobilepush/nl/fr/images/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/fr/images/t_enable_actionable_notifications_ios.md @@ -1,104 +1,104 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Activation des notifications interactives pour iOS -{: #enable-actionable-notifications-ios} - -A la différence des notifications push traditionnelles, les notifications interactives invitent les utilisateurs à effectuer une sélection lorsqu'ils reçoivent l'alerte de notification sans ouvrir l'application. Utilisez les instructions ci-après pour activer les notifications push interactives dans votre application. - -1. Créez une réponse utilisateur. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. Créez une catégorie de notification et définissez une action. **UIUserNotificationActionContextDefault** ou **UIUserNotificationActionContextMinimal** sont des contextes valides. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. Créez le paramètre de notification et affectez les catégories de l'étape -précédente. - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. Créez la notification locale ou éloignée et affectez-lui l'identité de la catégorie. - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Activation des notifications interactives pour iOS +{: #enable-actionable-notifications-ios} + +A la différence des notifications push traditionnelles, les notifications interactives invitent les utilisateurs à effectuer une sélection lorsqu'ils reçoivent l'alerte de notification sans ouvrir l'application. Utilisez les instructions ci-après pour activer les notifications push interactives dans votre application. + +1. Créez une réponse utilisateur. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. Créez une catégorie de notification et définissez une action. **UIUserNotificationActionContextDefault** ou **UIUserNotificationActionContextMinimal** sont des contextes valides. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. Créez le paramètre de notification et affectez les catégories de l'étape +précédente. + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. Créez la notification locale ou éloignée et affectez-lui l'identité de la catégorie. + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/fr/index.md b/services/mobilepush/nl/fr/index.md index e30eac4f6..ae4933ef6 100644 --- a/services/mobilepush/nl/fr/index.md +++ b/services/mobilepush/nl/fr/index.md @@ -1,56 +1,56 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Initiation à {{site.data.keyword.mobilepushshort}} -{: #gettingstartedtemplate} -Dernière mise à jour : 19 janvier 2017 -{: .last-updated} - -{:shortdesc} - -{{site.data.keyword.mobilepushshort}} est disponible en tant que service du Catalogue Bluemix dans la catégorie Mobile et vous permet d'envoyer et de gérer des notifications push sur périphérique mobile et le Web. Le service gère le mappage de vos utilisateurs d'application avec leurs appareils, la plateforme de leur appareil et les navigateurs Web, tout en traitant la transmission des notifications. - - {{site.data.keyword.mobilepushshort}} est disponible dans le conteneur boilerplate de MobileFirst Services et dans le cadre des [Services dédiés](/docs/dedicated/index.html)Bluemix. Vous pouvez utiliser le service pour envoyer des diffusions, des notifications unicast (en fonction de l'ID d'unité et l'ID utilisateur), des notifications basées balises, des notifications basées événements webhooks, ainsi que des notifications Rich Media et des notifications interactives, à vos utilisateurs d'application mobile et de navigateur Web. Vous pouvez également utiliser un SDK (kit de développement de logiciels) et des [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window} pour affiner plus encore le développement de vos applications client. - -Le service propose aussi des capacités de surveillance des performances Push -Notification en générant des diagrammes et des rapports depuis vos données utilisateur. Voir -[Suivi des notifications Push](/docs/services/mobilepush/t_push_monitoring.html). - -Le service {{site.data.keyword.mobilepushshort}} est pris en charge sur les plateformes suivantes : - -- [Appareils mobiles iOS et Android](/docs/services/mobilepush/c_enable_push.html) -- [Navigateurs Web Google Chrome, Mozilla Firefox et Safari](/docs/services/mobilepush/c_chrome_firefox_enable.html) -- [Applications et extensions Google Chrome](/docs/services/mobilepush/c_web_extensions.html) - - -# Liens connexes -{: #rellinks} - -* [Présentation![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](c_overview_push.html){: new_window} - -## Tutoriels et exemples {:id="samples"} -{: #samples} -* [Exemple d'application Android helloPush![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} -- [Exemple d'application Cordova![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} -* [Exemple d'application iOS helloPush (Swift) ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} - -## Logiciel SDK -{: #sdk} -* [SDK Android ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} -* [SDK Cordova ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} -* [SDK iOS (Swift) ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} - -## Référence d'API -{: #api} -* [Référence d'API Push (Android) ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} -* [Référence d'API BMSPush iOS (Swift) ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} -* [Référence d'API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window} +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Initiation à {{site.data.keyword.mobilepushshort}} +{: #gettingstartedtemplate} +Dernière mise à jour : 19 janvier 2017 +{: .last-updated} + +{:shortdesc} + +{{site.data.keyword.mobilepushshort}} est disponible en tant que service du Catalogue Bluemix dans la catégorie Mobile et vous permet d'envoyer et de gérer des notifications push sur périphérique mobile et le Web. Le service gère le mappage de vos utilisateurs d'application avec leurs appareils, la plateforme de leur appareil et les navigateurs Web, tout en traitant la transmission des notifications. + + {{site.data.keyword.mobilepushshort}} est disponible dans le conteneur boilerplate de MobileFirst Services et dans le cadre des [Services dédiés](/docs/dedicated/index.html)Bluemix. Vous pouvez utiliser le service pour envoyer des diffusions, des notifications unicast (en fonction de l'ID d'unité et l'ID utilisateur), des notifications basées balises, des notifications basées événements webhooks, ainsi que des notifications Rich Media et des notifications interactives, à vos utilisateurs d'application mobile et de navigateur Web. Vous pouvez également utiliser un SDK (kit de développement de logiciels) et des [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window} pour affiner plus encore le développement de vos applications client. + +Le service propose aussi des capacités de surveillance des performances Push +Notification en générant des diagrammes et des rapports depuis vos données utilisateur. Voir +[Suivi des notifications Push](/docs/services/mobilepush/t_push_monitoring.html). + +Le service {{site.data.keyword.mobilepushshort}} est pris en charge sur les plateformes suivantes : + +- [Appareils mobiles iOS et Android](/docs/services/mobilepush/c_enable_push.html) +- [Navigateurs Web Google Chrome, Mozilla Firefox et Safari](/docs/services/mobilepush/c_chrome_firefox_enable.html) +- [Applications et extensions Google Chrome](/docs/services/mobilepush/c_web_extensions.html) + + +# Liens connexes +{: #rellinks} + +* [Présentation![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](c_overview_push.html){: new_window} + +## Tutoriels et exemples {:id="samples"} +{: #samples} +* [Exemple d'application Android helloPush![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} +- [Exemple d'application Cordova![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} +* [Exemple d'application iOS helloPush (Swift) ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} + +## Logiciel SDK +{: #sdk} +* [SDK Android ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} +* [SDK Cordova ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} +* [SDK iOS (Swift) ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} + +## Référence d'API +{: #api} +* [Référence d'API Push (Android) ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} +* [Référence d'API BMSPush iOS (Swift) ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} +* [Référence d'API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window} diff --git a/services/mobilepush/nl/fr/interactive_notifications.md b/services/mobilepush/nl/fr/interactive_notifications.md index 14dc256ae..f6b126913 100644 --- a/services/mobilepush/nl/fr/interactive_notifications.md +++ b/services/mobilepush/nl/fr/interactive_notifications.md @@ -1,87 +1,87 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Notifications interactives -{: #interactive-notifications} -Dernière mise à jour : 23 janvier 2017 -{: .last-updated} - -Les notifications interactives permettent aux utilisateurs de répondre à une notification sans ouvrir l'application. Lorsqu'une notification interactive est reçue, l'appareil affiche -les boutons d'action avec le message de notification. Les notifications sont prises en charge sur les unités iOS avec version 8 ou ultérieure. Dans le cas de -notifications interactives envoyés à des unités iOS antérieures à la version 8, les actions de notification ne sont pas affichées. - -##Envoi de notifications interactives de type {{site.data.keyword.mobilepushshort}} - - -Une notification interactive peut être envoyée en utilisant le tableau de bord Push ou la [documentation de l'API REST](t_restapi.html). - -Depuis la console {{site.data.keyword.mobilepushshort}} : - -1. Sous l'onglet de notification du tableau de bord Push, cliquez sur **Envoyer une notification**. -2. Choisissez les destinataires de votre notification et cliquez sur **Suivant**. -3. Dans la page de rédaction de la notification, une notification push interactive peut être envoyée en définissant Défaut ou Mixte comme type et en spécifiant la valeur Catégorie sous l'onglet Options avancées. Pour configurer la valeur de catégorie du client, lisez la section Traitement des notifications interactives de type {{site.data.keyword.mobilepushshort}} dans une application iOS native. - -## Traitement des notifications interactives de type {{site.data.keyword.mobilepushshort}} dans une application iOS native - - -### Swift - -Procédez comme suit pour recevoir des notifications interactives : - -1. Activez la fonction d'application pour effectuer des tâches en arrière-plan lors de la réception des notifications distantes. -1. Initialisez le SDK `BMSPush` avec votre catégorie d'action. - ``` - let myBMSClient = BMSClient.sharedInstance - myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) - let push = BMSPushClient.sharedInstance - let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) - let notifOptions = BMSPushClientOptions(categoryName: [category]) - push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) - ``` - {: codeblock} - -1. Implémentez la nouvelle méthode de rappel sur AppDelegate : - ``` - func userNotificationCenter(_ center: UNUserNotificationCenter, - didReceive response: UNNotificationResponse, - withCompletionHandler completionHandler: @escaping () -> Void) { - switch response.actionIdentifier { - case "FIRST": - print("FIRST") - case "SECOND": - print("SECOND") - default: - print("Unknown action") - } - completionHandler - } - ``` - {: codeblock} -5. Cette nouvelle méthode de rappel est appelée lorsque l'utilisateur clique sur le bouton d'action. L'implémentation de cette méthode doit effectuer les tâches associées à l'identificateur spécifié et exécuter le bloc dans le paramètre `completionHandler`. - - -### Cordova - -Pour obtenir une notification interactive dans une application Cordova sous iOS, procédez comme suit : - -1. Ajoutez une zone de catégorie dans la méthode `BMSPush.initialize`. - ``` - var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} - BMSPush.initialize(appGUID,clientSecret,category); - ``` - {: codeblock} -2. Implémentez la nouvelle méthode de rappel sur AppDelegate. -3. Cette nouvelle méthode de rappel est appelée lorsque l'utilisateur clique sur le bouton d'action. L'implémentation de cette méthode -doit effectuer les tâches associées à l'identificateur spécifié et exécuter le bloc stipulé par le paramètre -completionHandler. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Notifications interactives +{: #interactive-notifications} +Dernière mise à jour : 23 janvier 2017 +{: .last-updated} + +Les notifications interactives permettent aux utilisateurs de répondre à une notification sans ouvrir l'application. Lorsqu'une notification interactive est reçue, l'appareil affiche +les boutons d'action avec le message de notification. Les notifications sont prises en charge sur les unités iOS avec version 8 ou ultérieure. Dans le cas de +notifications interactives envoyés à des unités iOS antérieures à la version 8, les actions de notification ne sont pas affichées. + +##Envoi de notifications interactives de type {{site.data.keyword.mobilepushshort}} + + +Une notification interactive peut être envoyée en utilisant le tableau de bord Push ou la [documentation de l'API REST](t_restapi.html). + +Depuis la console {{site.data.keyword.mobilepushshort}} : + +1. Sous l'onglet de notification du tableau de bord Push, cliquez sur **Envoyer une notification**. +2. Choisissez les destinataires de votre notification et cliquez sur **Suivant**. +3. Dans la page de rédaction de la notification, une notification push interactive peut être envoyée en définissant Défaut ou Mixte comme type et en spécifiant la valeur Catégorie sous l'onglet Options avancées. Pour configurer la valeur de catégorie du client, lisez la section Traitement des notifications interactives de type {{site.data.keyword.mobilepushshort}} dans une application iOS native. + +## Traitement des notifications interactives de type {{site.data.keyword.mobilepushshort}} dans une application iOS native + + +### Swift + +Procédez comme suit pour recevoir des notifications interactives : + +1. Activez la fonction d'application pour effectuer des tâches en arrière-plan lors de la réception des notifications distantes. +1. Initialisez le SDK `BMSPush` avec votre catégorie d'action. + ``` + let myBMSClient = BMSClient.sharedInstance + myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) + let push = BMSPushClient.sharedInstance + let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) + let notifOptions = BMSPushClientOptions(categoryName: [category]) + push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) + ``` + {: codeblock} + +1. Implémentez la nouvelle méthode de rappel sur AppDelegate : + ``` + func userNotificationCenter(_ center: UNUserNotificationCenter, + didReceive response: UNNotificationResponse, + withCompletionHandler completionHandler: @escaping () -> Void) { + switch response.actionIdentifier { + case "FIRST": + print("FIRST") + case "SECOND": + print("SECOND") + default: + print("Unknown action") + } + completionHandler + } + ``` + {: codeblock} +5. Cette nouvelle méthode de rappel est appelée lorsque l'utilisateur clique sur le bouton d'action. L'implémentation de cette méthode doit effectuer les tâches associées à l'identificateur spécifié et exécuter le bloc dans le paramètre `completionHandler`. + + +### Cordova + +Pour obtenir une notification interactive dans une application Cordova sous iOS, procédez comme suit : + +1. Ajoutez une zone de catégorie dans la méthode `BMSPush.initialize`. + ``` + var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} + BMSPush.initialize(appGUID,clientSecret,category); + ``` + {: codeblock} +2. Implémentez la nouvelle méthode de rappel sur AppDelegate. +3. Cette nouvelle méthode de rappel est appelée lorsque l'utilisateur clique sur le bouton d'action. L'implémentation de cette méthode +doit effectuer les tâches associées à l'identificateur spécifié et exécuter le bloc stipulé par le paramètre +completionHandler. diff --git a/services/mobilepush/nl/fr/next_steps_tags.md b/services/mobilepush/nl/fr/next_steps_tags.md index 4d6f0a830..1d50c83ff 100644 --- a/services/mobilepush/nl/fr/next_steps_tags.md +++ b/services/mobilepush/nl/fr/next_steps_tags.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Etapes suivantes -{: #next_steps_tags} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - -Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options avancées. - -Ajoutez ces fonctions de service {{site.data.keyword.mobilepushshort}} à votre application. -Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). -Pour utiliser des options de notification avancées, voir [Notifications push avancées](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Etapes suivantes +{: #next_steps_tags} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + +Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options avancées. + +Ajoutez ces fonctions de service {{site.data.keyword.mobilepushshort}} à votre application. +Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). +Pour utiliser des options de notification avancées, voir [Notifications push avancées](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/fr/silent_notifications.md b/services/mobilepush/nl/fr/silent_notifications.md index a4cb764fd..e605968f0 100644 --- a/services/mobilepush/nl/fr/silent_notifications.md +++ b/services/mobilepush/nl/fr/silent_notifications.md @@ -1,41 +1,41 @@ ------- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Traitement des notifications silencieuses pour iOS -{: #silent-notifications} -Dernière mise à jour : 16 janvier 2017 -{: .last-updated} - -Les notifications silencieuses n'apparaissent pas sur l'écran de l'appareil. Elles sont reçues par l'application en arrière-plan, qui sort alors de veille pendant une durée maximale de 30 secondes pour effectuer la tâche d'arrière-plan spécifiée. Un utilisateur peut ne pas être conscient de l'arrivée de la notification. Pour envoyer des notifications silencieuses pour iOS, utilisez l'[API REST![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. - -1. Pour envoyer des notifications push en mode silencieux, implémentez la méthode suivante dans le fichier `appDelegate.m` dans votre projet. Dans -Swift, la valeur `contentAvailable` envoyée par le serveur pour les notifications silencieuses est égale à 1. -``` -//For Swift - -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - let contentAPS = userInfo["aps"] as [NSObject : AnyObject] - if let contentAvailable = contentAPS["content-available"] as? Int { - //silent or mixed push - if contentAvailable == 1 { - completionHandler(UIBackgroundFetchResult.NewData) - } else { - completionHandler(UIBackgroundFetchResult.NoData) - } - } else { - //Default notification - completionHandler(UIBackgroundFetchResult.NoData) - } - } -``` - {: codeblock} - +------ + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Traitement des notifications silencieuses pour iOS +{: #silent-notifications} +Dernière mise à jour : 16 janvier 2017 +{: .last-updated} + +Les notifications silencieuses n'apparaissent pas sur l'écran de l'appareil. Elles sont reçues par l'application en arrière-plan, qui sort alors de veille pendant une durée maximale de 30 secondes pour effectuer la tâche d'arrière-plan spécifiée. Un utilisateur peut ne pas être conscient de l'arrivée de la notification. Pour envoyer des notifications silencieuses pour iOS, utilisez l'[API REST![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. + +1. Pour envoyer des notifications push en mode silencieux, implémentez la méthode suivante dans le fichier `appDelegate.m` dans votre projet. Dans +Swift, la valeur `contentAvailable` envoyée par le serveur pour les notifications silencieuses est égale à 1. +``` +//For Swift + +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + let contentAPS = userInfo["aps"] as [NSObject : AnyObject] + if let contentAvailable = contentAPS["content-available"] as? Int { + //silent or mixed push + if contentAvailable == 1 { + completionHandler(UIBackgroundFetchResult.NewData) + } else { + completionHandler(UIBackgroundFetchResult.NoData) + } + } else { + //Default notification + completionHandler(UIBackgroundFetchResult.NoData) + } + } +``` + {: codeblock} + diff --git a/services/mobilepush/nl/fr/t__main_push_config_provider.md b/services/mobilepush/nl/fr/t__main_push_config_provider.md index d0651a360..8e7183bf6 100644 --- a/services/mobilepush/nl/fr/t__main_push_config_provider.md +++ b/services/mobilepush/nl/fr/t__main_push_config_provider.md @@ -1,21 +1,21 @@ - ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configuration des données d'identification pour un fournisseur de notification -{: #create-push-credentials} -Dernière mise à jour : 18 janvier 2017 -{: .last-updated} - -Pour configurer le service {{site.data.keyword.mobilepushshort}}, procurez-vous les données d'identification auprès de votre fournisseur de notifications push - soit le service Firebase Cloud Messaging ([FCM](t_push_provider_android.html)); soit le service Apple Push Notification ([APN](t_push_provider_ios.html)), pour les appareils mobiles. Pour les navigateurs Web, voir [Configuration des données d'identification pour les navigateurs Web](t_push_provider_safari.html). - -Vous pouvez configurer {{site.data.keyword.mobilepushshort}} à l'aide du tableau de bord **IBM Bluemix Services** ou des [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. + +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configuration des données d'identification pour un fournisseur de notification +{: #create-push-credentials} +Dernière mise à jour : 18 janvier 2017 +{: .last-updated} + +Pour configurer le service {{site.data.keyword.mobilepushshort}}, procurez-vous les données d'identification auprès de votre fournisseur de notifications push - soit le service Firebase Cloud Messaging ([FCM](t_push_provider_android.html)); soit le service Apple Push Notification ([APN](t_push_provider_ios.html)), pour les appareils mobiles. Pour les navigateurs Web, voir [Configuration des données d'identification pour les navigateurs Web](t_push_provider_safari.html). + +Vous pouvez configurer {{site.data.keyword.mobilepushshort}} à l'aide du tableau de bord **IBM Bluemix Services** ou des [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. diff --git a/services/mobilepush/nl/fr/t_advance_badge_sound_payload.md b/services/mobilepush/nl/fr/t_advance_badge_sound_payload.md index f9b9a5807..4f0fb0e14 100644 --- a/services/mobilepush/nl/fr/t_advance_badge_sound_payload.md +++ b/services/mobilepush/nl/fr/t_advance_badge_sound_payload.md @@ -1,78 +1,78 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#Activation des {{site.data.keyword.mobilepushshort}} avancées -Dernière mise à jour : 23 janvier 2017 -{: .last-updated} - -Configurez un badge iOS, un son, un contenu JSON supplémentaire, des notifications interactives et la conservation des notifications. - -## Configuration d'un son, d'un contenu et d'un badge iOS -{: #badge-sound-payload} - -Configurez un badge, un son et un contenu JSON supplémentaire iOS. - -1. Dans le tableau de bord {{site.data.keyword.mobilepushshort}}, accédez à l'onglet **Notifications**. -2. Accédez à la section des zones facultatives pour configurer les fonctions {{site.data.keyword.mobilepushshort}}. - - **Fichier son** - Entrez une chaîne pour pointer vers le fichier son dans votre application mobile. Dans le contenu, spécifiez le nom de chaîne du fichier son à utiliser. - - **Badge iOS** - Pour les appareils iOS, numéro à afficher comme badge de l'icône d'application. Si cette propriété manque, le badge n'est pas changé. Pour supprimer le badge, associez cette propriété à la valeur 0. - -###Android - -Ajoutez votre fichier son dans le répertoire `res/raw` de votre application Android. Lors de l'envoi de la notification, ajoutez le nom du fichier son dans la zone son de {{site.data.keyword.mobilepushshort}}. - -``` -"settings":{ - "gcm" : { - "sound":"tt.wav", - } - } -``` - {: codeblock} - -###iOS - -``` -"settings": { - "apns" : { - "badge": 10, - "sound": "tt.wav", - } -} -``` - {: codeblock} - -**Contenu supplémentaire** - Ce contenu peut être représenté par toute paire clé-valeur et doit être un objet JSON que vous voulez envoyer avec la notification de type {{site.data.keyword.mobilepushshort}}. - -``` -{"clé":"valeur", "clé2":"valeur2"} -``` - {: codeblock} - -## Conservation des notifications Android -{: #hold-notifications-android} - -Quand votre application passe en arrière-plan, vous pouvez vouloir que le service {{site.data.keyword.mobilepushshort}} conserve les notifications qui sont envoyées à cette application. Pour conserver des notifications, appelez la méthode hold() dans la méthode onPause() de l'activité qui traite les -notifications de type {{site.data.keyword.mobilepushshort}}. - -``` -@Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Activation des {{site.data.keyword.mobilepushshort}} avancées +Dernière mise à jour : 23 janvier 2017 +{: .last-updated} + +Configurez un badge iOS, un son, un contenu JSON supplémentaire, des notifications interactives et la conservation des notifications. + +## Configuration d'un son, d'un contenu et d'un badge iOS +{: #badge-sound-payload} + +Configurez un badge, un son et un contenu JSON supplémentaire iOS. + +1. Dans le tableau de bord {{site.data.keyword.mobilepushshort}}, accédez à l'onglet **Notifications**. +2. Accédez à la section des zones facultatives pour configurer les fonctions {{site.data.keyword.mobilepushshort}}. + - **Fichier son** - Entrez une chaîne pour pointer vers le fichier son dans votre application mobile. Dans le contenu, spécifiez le nom de chaîne du fichier son à utiliser. + - **Badge iOS** - Pour les appareils iOS, numéro à afficher comme badge de l'icône d'application. Si cette propriété manque, le badge n'est pas changé. Pour supprimer le badge, associez cette propriété à la valeur 0. + +### Android + +Ajoutez votre fichier son dans le répertoire `res/raw` de votre application Android. Lors de l'envoi de la notification, ajoutez le nom du fichier son dans la zone son de {{site.data.keyword.mobilepushshort}}. + +``` +"settings":{ + "gcm" : { + "sound":"tt.wav", + } + } +``` + {: codeblock} + +### iOS + +``` +"settings": { + "apns" : { + "badge": 10, + "sound": "tt.wav", + } +} +``` + {: codeblock} + +**Contenu supplémentaire** - Ce contenu peut être représenté par toute paire clé-valeur et doit être un objet JSON que vous voulez envoyer avec la notification de type {{site.data.keyword.mobilepushshort}}. + +``` +{"clé":"valeur", "clé2":"valeur2"} +``` + {: codeblock} + +## Conservation des notifications Android +{: #hold-notifications-android} + +Quand votre application passe en arrière-plan, vous pouvez vouloir que le service {{site.data.keyword.mobilepushshort}} conserve les notifications qui sont envoyées à cette application. Pour conserver des notifications, appelez la méthode hold() dans la méthode onPause() de l'activité qui traite les +notifications de type {{site.data.keyword.mobilepushshort}}. + +``` +@Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} + + diff --git a/services/mobilepush/nl/fr/t_android_create_unbound_service.md b/services/mobilepush/nl/fr/t_android_create_unbound_service.md index 6b296730b..b7a57424a 100644 --- a/services/mobilepush/nl/fr/t_android_create_unbound_service.md +++ b/services/mobilepush/nl/fr/t_android_create_unbound_service.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Création d'un service {{site.data.keyword.mobilepushshort}} non lié pour Android -{: #create_android_unbound} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - -Créez une instance de service {{site.data.keyword.mobilepushshort}}. Vous pouvez utiliser l'instance de service {{site.data.keyword.mobilepushshort}} sans liaison à aucune application de back end. - -1. Liez l'instance de service {{site.data.keyword.mobilepushshort}} à une application Bluemix. Lors de cette opération, vous serez en mesure de voir tous les détails en rapport avec le service, qui sont stockés au format JSON dans la variable d'environnement VCAP_SERVICES. - -![Liaison d'un service Push Notifications](images/unbound_1.jpg) - 2. Cliquez sur le bouton de liaison et choisissez l'instance de service {{site.data.keyword.mobilepushshort}} à lier. Quand votre application est liée au service {{site.data.keyword.mobilepushshort}}, les informations sur le service sont stockées au format JSON dans la variable d'environnement VCAP_SERVICES de votre application. par exemple : -``` - { - "imfpush_Dev": [ - { - "name": "myname_sampleUnbound", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": null - } - ] - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Création d'un service {{site.data.keyword.mobilepushshort}} non lié pour Android +{: #create_android_unbound} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + +Créez une instance de service {{site.data.keyword.mobilepushshort}}. Vous pouvez utiliser l'instance de service {{site.data.keyword.mobilepushshort}} sans liaison à aucune application de back end. + +1. Liez l'instance de service {{site.data.keyword.mobilepushshort}} à une application Bluemix. Lors de cette opération, vous serez en mesure de voir tous les détails en rapport avec le service, qui sont stockés au format JSON dans la variable d'environnement VCAP_SERVICES. + +![Liaison d'un service Push Notifications](images/unbound_1.jpg) + 2. Cliquez sur le bouton de liaison et choisissez l'instance de service {{site.data.keyword.mobilepushshort}} à lier. Quand votre application est liée au service {{site.data.keyword.mobilepushshort}}, les informations sur le service sont stockées au format JSON dans la variable d'environnement VCAP_SERVICES de votre application. par exemple : +``` + { + "imfpush_Dev": [ + { + "name": "myname_sampleUnbound", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": null + } + ] + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/fr/t_android_initialize.md b/services/mobilepush/nl/fr/t_android_initialize.md index fe5cf507f..06ed9d694 100644 --- a/services/mobilepush/nl/fr/t_android_initialize.md +++ b/services/mobilepush/nl/fr/t_android_initialize.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Initialisation du logiciel SDK Push pour les applis Android -{: #android_initialize} - -Le code d'initialisation se trouve généralement dans la méthode onCreate de l'activité principale de votre application Android. - -Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route et l'identificateur global unique de l'application. Utilisez ces valeurs pour vos paramètres de route et d'identificateur global unique d'application. Modifiez le fragment de code pour qu'il utilise les paramètres appRoute et appGUID de votre appli Bluemix. - - -##Initialisation du logiciel SDK de base - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -Spécifie la route qui a été affectée à l'application serveur que vous avez créée dans Bluemix. - -**AppGUID** - -Spécifie la clé unique qui a été affectée à l'application que vous avez créée dans Bluemix. Cette -valeur est sensible à la casse. - -**bluemixRegionSuffix** - -Indique l'emplacement où l'application est hébergée. Vous pouvez utiliser l'une des trois valeurs suivantes : - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##Initialisation du logiciel SDK Push du client - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Initialisation du logiciel SDK Push pour les applis Android +{: #android_initialize} + +Le code d'initialisation se trouve généralement dans la méthode onCreate de l'activité principale de votre application Android. + +Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route et l'identificateur global unique de l'application. Utilisez ces valeurs pour vos paramètres de route et d'identificateur global unique d'application. Modifiez le fragment de code pour qu'il utilise les paramètres appRoute et appGUID de votre appli Bluemix. + + +##Initialisation du logiciel SDK de base + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +Spécifie la route qui a été affectée à l'application serveur que vous avez créée dans Bluemix. + +**AppGUID** + +Spécifie la clé unique qui a été affectée à l'application que vous avez créée dans Bluemix. Cette +valeur est sensible à la casse. + +**bluemixRegionSuffix** + +Indique l'emplacement où l'application est hébergée. Vous pouvez utiliser l'une des trois valeurs suivantes : + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +##Initialisation du logiciel SDK Push du client + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` diff --git a/services/mobilepush/nl/fr/t_android_install_sdk.md b/services/mobilepush/nl/fr/t_android_install_sdk.md index a0d873ef6..f2d0bdac7 100644 --- a/services/mobilepush/nl/fr/t_android_install_sdk.md +++ b/services/mobilepush/nl/fr/t_android_install_sdk.md @@ -1,222 +1,222 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Installation du logiciel SDK Push du client à l'aide de Gradle -{: #android_install} - -Cette section explique comment installer et utiliser le logiciel SDK Push du client afin de développer davantage vos applications Android. - -Le logiciel SDK Push de Bluemix Mobile Services peut être ajouté à l'aide de Gradle. Gradle télécharge automatiquement des artefacts depuis des référentiels et les met à la disposition de votre application Android. Assurez-vous de configurer correctement Android Studio et le logiciel SDK Android Studio. Pour plus d'informations sur la configuration de votre système, -voir [Android Studio Overview](https://developer.android.com/tools/studio/index.html). Pour plus d'informations sur Gradle, voir [Configuring Gradle Builds](http://developer.android.com/tools/building/configuring-gradle.html). - -1. Dans Android Studio, après avoir créé et ouvert une application mobile, ouvrez le fichier **build.gradle** de votre application. Ensuite, ajoutez les dépendances suivantes à votre application mobile. Ces instructions d'importation sont requises pour les fragments de code : - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - - -1. Ajoutez les dépendances ci-après à votre application mobile. Les lignes suivantes ajoutent le logiciel SDK Push du client Bluemix Mobile Services et le logiciel SDK des services Google Play à vos dépendances de compilation : - - ``` - dependencies { - compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' - compile 'com.google.android.gms:play-services:7.8.0' - } - ``` -1. Dans le fichier **AndroidManifest.xml**, ajoutez les droits ci-dessous. Pour afficher un exemple de manifeste, voir le [modèle d'application Android helloPush](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml). Pour afficher un exemple de fichier Gradle, voir l'[exemple de fichier de génération Gradle](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle). - - ``` - - - - - - - - - ``` - - Vous trouverez davantage d'informations sur les [droits Android](http://developer.android.com/guide/topics/security/permissions.html) ici. - -1. Ajoutez les paramètres d'intention de notification pour l'activité. Ce paramètre démarre l'application lorsque l'utilisateur clique sur la -notification reçue dans la zone de notification. - - ``` - - - - - ``` - **Remarque** : Remplacez *Your_Android_Package_Name* dans l'action ci-dessus par le nom du package d'applications utilisé dans votre application. - -1. Ajoutez le service d'intention Google Cloud Messaging (GCM) et des filtres d'intention pour les notifications d'événements RECEIVE. - - ``` - service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> - - - - - - - - - - - - - - ``` - - - -# Initialisation du logiciel SDK Push pour les applis Android -{: #android_initialize} - -Le code d'initialisation se trouve généralement dans la méthode onCreate de l'activité principale de votre application Android. - -Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route et l'identificateur global unique de l'application. Utilisez ces valeurs pour vos paramètres de route et d'identificateur global unique d'application. Modifiez le fragment de code pour qu'il utilise les paramètres appRoute et appGUID de votre appli Bluemix. - - -##Initialisation du logiciel SDK de base - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -Spécifie la route qui a été affectée à l'application serveur que vous avez créée dans Bluemix. - -**AppGUID** - -Spécifie la clé unique qui a été affectée à l'application que vous avez créée dans Bluemix. Cette -valeur est sensible à la casse. - -**bluemixRegionSuffix** - -Indique l'emplacement où l'application est hébergée. Vous pouvez utiliser l'une des trois valeurs suivantes : - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##Initialisation du logiciel SDK Push du client - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` - - - -# Enregistrement d'appareils Android -{: #android_register} - -Utilisez l'API `IMFPush.register()` pour enregistrer l'appareil auprès d'un service de notifications push. Pour enregistrer des appareils Android, vous devez entrer au préalable des informations GCM (Google Cloud Messaging) dans le tableau de bord de configuration du service Push Bluemix. Pour plus d'informations, voir [Configuration de données d'identification pour Google Cloud Messaging](t_push_provider_android.html). - -Copiez et collez les fragments de code suivants dans votre application mobile Android : - -``` - //Enregistrement d'appareils Android - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //Traitement de réussite - } - @Override - public void onFailure(MFPPushException ex) { - //Traitement d'échec éventuel - } - }); -``` - -``` - //Traitement de la notification à son arrivée - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Traitement de la notification push - } - }; -``` - - - -# Réception de notifications push sur des appareils Android -{: #android_receive} - -Pour enregistrer l'objet notificationListener auprès de Push, appelez la méthode **MFPPush.listen()**. En général, elle est appelée depuis la -méthode **onResume()** de l'activité qui traite les notifications push. - -1. Pour enregistrer l'objet notificationListener auprès de Push, appelez la méthode **listen()**. En général, elle est appelée depuis la -méthode **onResume()** de l'activité qui traite les notifications push. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } - ``` -2. Générez le projet et exécutez-le sur l'appareil ou l'émulateur. Lorsque la méthode onSuccess() pour le programme d'écoute des réponses dans la méthode register() est appelée, cela signifie que l'appareil a été enregistré auprès de Push. A ce stade, vous pouvez envoyer un message comme décrit dans la rubrique Envoi de notifications push de base. -3. Vérifiez que vos appareils ont reçu votre notification. Si l'application se trouve au premier-plan, la notification est traitée par **MFPPushNotificationListener**. Si elle se trouve en arrière-plan, un message est affiché dans la barre de notification. - - - - -# Envoi de notifications push de base - -{: #push-send-notifications} - -Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base (sans utiliser de balise, de badge, de -contenu supplémentaire ou de fichier son). - - -Envoi de notifications push de base. - -1. Dans **Sélectionner les utilisateurs concernés**, sélectionnez l'une des options suivantes : **Tous les terminaux**, ou par plateforme : **Les appareils iOS uniquement** ou **Les appareils Android uniquement**. - - **Remarque** : Lorsque vous sélectionnez l'option **Tous les terminaux**, tous les appareils qui ont été abonnés à des notifications push reçoivent votre notification. - - ![Ecran Notifications](images/tag_notification.jpg) - -2. Dans la zone **Créez votre notification**, entrez votre message, puis cliquez sur **Envoyer**. -3. Vérifiez que vos appareils ont reçu votre notification. - - La capture d'écran suivante présente une boîte d'alerte relative à une notification push s'exécutant au premier plan sur un appareil Android et iOS. - ![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) - - ![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) - - La capture d'écran suivante présente une notification push qui s'exécute en arrière-plan sur un appareil Android. - ![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) - - - -# Etapes suivantes -{: #next_steps_tags} - -Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options -avancées. - -Ajoutez ces fonctions du service de notifications push à votre application. -Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). -Pour utiliser des options de notification avancées, voir [Notifications push avancées](t_advance_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Installation du logiciel SDK Push du client à l'aide de Gradle +{: #android_install} + +Cette section explique comment installer et utiliser le logiciel SDK Push du client afin de développer davantage vos applications Android. + +Le logiciel SDK Push de Bluemix Mobile Services peut être ajouté à l'aide de Gradle. Gradle télécharge automatiquement des artefacts depuis des référentiels et les met à la disposition de votre application Android. Assurez-vous de configurer correctement Android Studio et le logiciel SDK Android Studio. Pour plus d'informations sur la configuration de votre système, +voir [Android Studio Overview](https://developer.android.com/tools/studio/index.html). Pour plus d'informations sur Gradle, voir [Configuring Gradle Builds](http://developer.android.com/tools/building/configuring-gradle.html). + +1. Dans Android Studio, après avoir créé et ouvert une application mobile, ouvrez le fichier **build.gradle** de votre application. Ensuite, ajoutez les dépendances suivantes à votre application mobile. Ces instructions d'importation sont requises pour les fragments de code : + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + + +1. Ajoutez les dépendances ci-après à votre application mobile. Les lignes suivantes ajoutent le logiciel SDK Push du client Bluemix Mobile Services et le logiciel SDK des services Google Play à vos dépendances de compilation : + + ``` + dependencies { + compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' + compile 'com.google.android.gms:play-services:7.8.0' + } + ``` +1. Dans le fichier **AndroidManifest.xml**, ajoutez les droits ci-dessous. Pour afficher un exemple de manifeste, voir le [modèle d'application Android helloPush](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml). Pour afficher un exemple de fichier Gradle, voir l'[exemple de fichier de génération Gradle](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle). + + ``` + + + + + + + + + ``` + + Vous trouverez davantage d'informations sur les [droits Android](http://developer.android.com/guide/topics/security/permissions.html) ici. + +1. Ajoutez les paramètres d'intention de notification pour l'activité. Ce paramètre démarre l'application lorsque l'utilisateur clique sur la +notification reçue dans la zone de notification. + + ``` + + + + + ``` + **Remarque** : Remplacez *Your_Android_Package_Name* dans l'action ci-dessus par le nom du package d'applications utilisé dans votre application. + +1. Ajoutez le service d'intention Google Cloud Messaging (GCM) et des filtres d'intention pour les notifications d'événements RECEIVE. + + ``` + service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> + + + + + + + + + + + + + + ``` + + + +# Initialisation du logiciel SDK Push pour les applis Android +{: #android_initialize} + +Le code d'initialisation se trouve généralement dans la méthode onCreate de l'activité principale de votre application Android. + +Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route et l'identificateur global unique de l'application. Utilisez ces valeurs pour vos paramètres de route et d'identificateur global unique d'application. Modifiez le fragment de code pour qu'il utilise les paramètres appRoute et appGUID de votre appli Bluemix. + + +##Initialisation du logiciel SDK de base + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +Spécifie la route qui a été affectée à l'application serveur que vous avez créée dans Bluemix. + +**AppGUID** + +Spécifie la clé unique qui a été affectée à l'application que vous avez créée dans Bluemix. Cette +valeur est sensible à la casse. + +**bluemixRegionSuffix** + +Indique l'emplacement où l'application est hébergée. Vous pouvez utiliser l'une des trois valeurs suivantes : + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +##Initialisation du logiciel SDK Push du client + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` + + + +# Enregistrement d'appareils Android +{: #android_register} + +Utilisez l'API `IMFPush.register()` pour enregistrer l'appareil auprès d'un service de notifications push. Pour enregistrer des appareils Android, vous devez entrer au préalable des informations GCM (Google Cloud Messaging) dans le tableau de bord de configuration du service Push Bluemix. Pour plus d'informations, voir [Configuration de données d'identification pour Google Cloud Messaging](t_push_provider_android.html). + +Copiez et collez les fragments de code suivants dans votre application mobile Android : + +``` + //Enregistrement d'appareils Android + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //Traitement de réussite + } + @Override + public void onFailure(MFPPushException ex) { + //Traitement d'échec éventuel + } + }); +``` + +``` + //Traitement de la notification à son arrivée + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Traitement de la notification push + } + }; +``` + + + +# Réception de notifications push sur des appareils Android +{: #android_receive} + +Pour enregistrer l'objet notificationListener auprès de Push, appelez la méthode **MFPPush.listen()**. En général, elle est appelée depuis la +méthode **onResume()** de l'activité qui traite les notifications push. + +1. Pour enregistrer l'objet notificationListener auprès de Push, appelez la méthode **listen()**. En général, elle est appelée depuis la +méthode **onResume()** de l'activité qui traite les notifications push. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } + ``` +2. Générez le projet et exécutez-le sur l'appareil ou l'émulateur. Lorsque la méthode onSuccess() pour le programme d'écoute des réponses dans la méthode register() est appelée, cela signifie que l'appareil a été enregistré auprès de Push. A ce stade, vous pouvez envoyer un message comme décrit dans la rubrique Envoi de notifications push de base. +3. Vérifiez que vos appareils ont reçu votre notification. Si l'application se trouve au premier-plan, la notification est traitée par **MFPPushNotificationListener**. Si elle se trouve en arrière-plan, un message est affiché dans la barre de notification. + + + + +# Envoi de notifications push de base + +{: #push-send-notifications} + +Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base (sans utiliser de balise, de badge, de +contenu supplémentaire ou de fichier son). + + +Envoi de notifications push de base. + +1. Dans **Sélectionner les utilisateurs concernés**, sélectionnez l'une des options suivantes : **Tous les terminaux**, ou par plateforme : **Les appareils iOS uniquement** ou **Les appareils Android uniquement**. + + **Remarque** : Lorsque vous sélectionnez l'option **Tous les terminaux**, tous les appareils qui ont été abonnés à des notifications push reçoivent votre notification. + + ![Ecran Notifications](images/tag_notification.jpg) + +2. Dans la zone **Créez votre notification**, entrez votre message, puis cliquez sur **Envoyer**. +3. Vérifiez que vos appareils ont reçu votre notification. + + La capture d'écran suivante présente une boîte d'alerte relative à une notification push s'exécutant au premier plan sur un appareil Android et iOS. + ![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) + + ![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) + + La capture d'écran suivante présente une notification push qui s'exécute en arrière-plan sur un appareil Android. + ![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) + + + +# Etapes suivantes +{: #next_steps_tags} + +Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options +avancées. + +Ajoutez ces fonctions du service de notifications push à votre application. +Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). +Pour utiliser des options de notification avancées, voir [Notifications push avancées](t_advance_notifications.html). diff --git a/services/mobilepush/nl/fr/t_android_receive.md b/services/mobilepush/nl/fr/t_android_receive.md index aa3e03ab6..c55769e3c 100644 --- a/services/mobilepush/nl/fr/t_android_receive.md +++ b/services/mobilepush/nl/fr/t_android_receive.md @@ -1,27 +1,27 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Réception de notifications push sur des appareils Android -{: #android_receive} - -Pour enregistrer l'objet notificationListener auprès de Push, appelez la méthode **MFPPush.listen()**. En général, elle est appelée depuis la -méthode **onResume()** de l'activité qui traite les notifications push. - -1. Pour enregistrer l'objet notificationListener auprès de Push, appelez la méthode **listen()**. En général, elle est appelée depuis la -méthode **onResume()** de l'activité qui traite les notifications push. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` -2. Générez le projet et exécutez-le sur l'appareil ou l'émulateur. Lorsque la méthode onSuccess() pour le programme d'écoute des réponses dans la méthode register() est appelée, cela signifie que l'appareil a été enregistré auprès de Push. A ce stade, vous pouvez envoyer un message comme décrit dans la rubrique Envoi de notifications push de base. -3. Vérifiez que vos appareils ont reçu votre notification. Si l'application se trouve au premier-plan, la notification est traitée par **MFPPushNotificationListener**. Si elle se trouve en arrière-plan, un message est affiché dans la barre de notification. +--- + +copyright: + years: 2015, 2016 + +--- + +# Réception de notifications push sur des appareils Android +{: #android_receive} + +Pour enregistrer l'objet notificationListener auprès de Push, appelez la méthode **MFPPush.listen()**. En général, elle est appelée depuis la +méthode **onResume()** de l'activité qui traite les notifications push. + +1. Pour enregistrer l'objet notificationListener auprès de Push, appelez la méthode **listen()**. En général, elle est appelée depuis la +méthode **onResume()** de l'activité qui traite les notifications push. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` +2. Générez le projet et exécutez-le sur l'appareil ou l'émulateur. Lorsque la méthode onSuccess() pour le programme d'écoute des réponses dans la méthode register() est appelée, cela signifie que l'appareil a été enregistré auprès de Push. A ce stade, vous pouvez envoyer un message comme décrit dans la rubrique Envoi de notifications push de base. +3. Vérifiez que vos appareils ont reçu votre notification. Si l'application se trouve au premier-plan, la notification est traitée par **MFPPushNotificationListener**. Si elle se trouve en arrière-plan, un message est affiché dans la barre de notification. diff --git a/services/mobilepush/nl/fr/t_android_register.md b/services/mobilepush/nl/fr/t_android_register.md index affac74d5..c239ad0b8 100644 --- a/services/mobilepush/nl/fr/t_android_register.md +++ b/services/mobilepush/nl/fr/t_android_register.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Enregistrement d'appareils Android -{: #android_register} - -Utilisez l'API `IMFPush.register()` pour enregistrer l'appareil auprès d'un service de notifications push. Pour enregistrer des appareils Android, vous devez entrer au préalable des informations GCM (Google Cloud Messaging) dans le tableau de bord de configuration du service Push Bluemix. Pour plus d'informations, voir [Configuration de données d'identification pour Google Cloud Messaging](t_push_provider_android.html). - -Copiez et collez les fragments de code suivants dans votre application mobile Android : - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Enregistrement d'appareils Android +{: #android_register} + +Utilisez l'API `IMFPush.register()` pour enregistrer l'appareil auprès d'un service de notifications push. Pour enregistrer des appareils Android, vous devez entrer au préalable des informations GCM (Google Cloud Messaging) dans le tableau de bord de configuration du service Push Bluemix. Pour plus d'informations, voir [Configuration de données d'identification pour Google Cloud Messaging](t_push_provider_android.html). + +Copiez et collez les fragments de code suivants dans votre application mobile Android : + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` diff --git a/services/mobilepush/nl/fr/t_cordova_initialize.md b/services/mobilepush/nl/fr/t_cordova_initialize.md index 038cf815b..6371f8262 100644 --- a/services/mobilepush/nl/fr/t_cordova_initialize.md +++ b/services/mobilepush/nl/fr/t_cordova_initialize.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} - -# Initialisation du plug-in Cordova -{: #cordova_enable} - -Pour pouvoir utiliser le plug-in Cordova du service Push Notifications, vous devez l'initialiser en transmettant la route de l'application et -l'identificateur global unique de l'application. Une fois le plug-in initialisé, vous pouvez vous connecter à l'application serveur que vous avez créée dans le tableau de bord Bluemix. Le plug-in Cordova est l'encapsuleur pour les logiciels SDK de client Android et iOS qui permettent à une application Cordova de communiquer avec les services Bluemix. - -1. Initialisez le client BMS en copiant et en collant le fragment de code suivant dans votre fichier JavaScript principal (généralement situé sous le répertoire **www/js**). - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Modifiez le fragment de code pour qu'il utilise vos paramètres de route et d'identificateur global unique Bluemix. Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route et l'identificateur global unique de l'application. Utilisez les valeurs Route et Identificateur global unique de l'application comme paramètres dans votre fragment de code `BMSClient.initialize`. - - - **Remarque** : Si vous avez créé une application Cordova à l'aide de l'interface CLI de Cordova (par exemple, à l'aide de la commande Cordova create nom_app), placez ce code Javascript dans le fichier **index.js**, après la fonction `app.receivedEvent` dans la fonction `onDeviceReady: function()` afin d'initialiser le client BMS. - - ``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` -1. Etape suivante. [Enregistrement des appareils](t_cordova_register.html). +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} + +# Initialisation du plug-in Cordova +{: #cordova_enable} + +Pour pouvoir utiliser le plug-in Cordova du service Push Notifications, vous devez l'initialiser en transmettant la route de l'application et +l'identificateur global unique de l'application. Une fois le plug-in initialisé, vous pouvez vous connecter à l'application serveur que vous avez créée dans le tableau de bord Bluemix. Le plug-in Cordova est l'encapsuleur pour les logiciels SDK de client Android et iOS qui permettent à une application Cordova de communiquer avec les services Bluemix. + +1. Initialisez le client BMS en copiant et en collant le fragment de code suivant dans votre fichier JavaScript principal (généralement situé sous le répertoire **www/js**). + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Modifiez le fragment de code pour qu'il utilise vos paramètres de route et d'identificateur global unique Bluemix. Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route et l'identificateur global unique de l'application. Utilisez les valeurs Route et Identificateur global unique de l'application comme paramètres dans votre fragment de code `BMSClient.initialize`. + + + **Remarque** : Si vous avez créé une application Cordova à l'aide de l'interface CLI de Cordova (par exemple, à l'aide de la commande Cordova create nom_app), placez ce code Javascript dans le fichier **index.js**, après la fonction `app.receivedEvent` dans la fonction `onDeviceReady: function()` afin d'initialiser le client BMS. + + ``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` +1. Etape suivante. [Enregistrement des appareils](t_cordova_register.html). diff --git a/services/mobilepush/nl/fr/t_cordova_install.md b/services/mobilepush/nl/fr/t_cordova_install.md index 107122bb7..359b86999 100644 --- a/services/mobilepush/nl/fr/t_cordova_install.md +++ b/services/mobilepush/nl/fr/t_cordova_install.md @@ -1,380 +1,380 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Installation du plug-in Cordova Push -{: #cordova_install} - -Installez et utilisez le plug-in Push client pour développer davantage vos applications Cordova. Elle installe -également le plug-in Cordova Core, qui initialise votre connexion à Bluemix. - -### Avant de commencer - -1. Téléchargez les dernières versions d'Android Studio SDK et Xcode. -1. Configurez votre émulateur. Pour Android Studio, utilisez un émulateur qui prend en charge l'API Google Play. -1. Installez l'outil de ligne de commande Git. Pour Windows, prenez soin de sélectionner l'option **Run Git from the Window Command Prompt**. Pour plus d'informations sur le téléchargement et l'installation de cet outil, voir [Git](https://git-scm.com/downloads). - -1. Installez Node.js et l'outil Node Package Manager (NPM). L'outil de ligne de commande NPM est intégré à Node.js. Pour plus d'informations sur le téléchargement et l'installation de cet outil, voir [Node.js](https://nodejs.org/en/download/). -1. A partir de la ligne de commande, installez les outils de ligne de commande Cordova à l'aide de la commande **npm install -g cordova**. Vous en aurez besoin pour pouvoir utiliser le plug-in Cordova Push. Pour obtenir des informations sur l'installation de Cordova et la configuration de votre appli Cordova, voir [Cordova Apache](https://cordova.apache.org/#getstarted). - - **Remarque** : Pour afficher le fichier Readme du plug-in Cordova Push, accédez à [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## Installation du plug-in Cordova Push -1. Placez-vous dans le dossier dans lequel créer votre application Cordova et exécutez la commande ci-dessous pour créer une application Cordova. Si vous possédez déjà une application Cordova, passez à l'étape 3. - -``` -cordova create your_app_name - cd your_app_name -``` -1. Facultatif : éditez le fichier **config.xml** et remplacez le nom de l'application dans l'élément par le -nom de votre choix, plutôt que d'utiliser le nom HelloCordova par défaut. - - **Remarque** : Prenez soin de spécifier l'ID de bundle approprié. A défaut, les messages d'erreur suivants s'afficheront dans Xcode : - * The executable was signed with invalid entitlements. - * The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile. - - Pour corriger ce problème, spécifiez l'ID de bundle approprié dans Xcode ou dans le fichier **config.xml** de votre appli Cordova. - -1. Ajoutez l'API minimale prise en charge ou la déclaration de cible de déploiement dans le fichier config.xml de votre application Cordova. La valeur de minSdkVersion doit être supérieure à 15. La valeur de targetSdkVersion doit toujours refléter le logiciel SDK Android le plus récent disponible auprès de Google. - * **Android** - Avec votre éditeur, ouvrez le fichier config.xml et mettez à jour l'élément `` avec les versions de SDM minimum et cible : - - ``` - - - - - - ``` - * **iOS** - Mettez à jour l'élément avec une déclaration cible de déploiement : - - ``` - - - - - ``` - -1. A partir de l'interface de ligne de commande Cordova, ajoutez vos plateformes iOS et/ou Android à l'aide des commandes suivantes : - - ``` - cordova platform add ios@3.9.0 - cordova platform add android - ``` -1. Depuis le répertoire racine de votre application Cordova, entrez la commande suivante pour installer le plug-in Cordova Push : **cordova plugin add ibm-mfp-push**. - - Selon les plateformes que vous avez ajoutées, la sortie peut ressembler à l'exemple suivant : - - ``` - Installing "ibm-mfp-push" for android - Installing "ibm-mfp-push" for ios - ``` -1. Depuis *your-app-root-folder*, vérifiez que les plug-ins Cordova Core et Push ont été installés correctement en entrant la -commande suivante : **cordova plugin list**. - - Selon les plateformes que vous avez ajoutées, la sortie peut ressembler à l'exemple suivant : - - ``` - ibm-mfp-core 1.0.0 "MFPCore" - ibm-mfp-push 1.0.0 “MFPPush" - ``` -1. (iOS uniquement) - Configurez votre environnement de développement iOS. - a. Ouvrez votre fichier your-app-name.xcodeproj dans le répertoire *your-app-name***/platforms/ios** à l'aide de Xcode. - - b. Ajoutez l'en-tête de pontage. Accédez à **Build settings > Swift Compiler - Code Generation > Objective-C Bridging Header** et ajoutez le chemin suivant :*your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - c. Ajoutez le paramètre Frameworks. Accédez à **Build Settings > Linking > Runpath Search Paths** et ajoutez le paramètre suivant : - ``` - @executable_path/Frameworks - ``` - d. Supprimez la mise en commentaire des instructions d'importation Push suivantes dans votre en-tête de pontage. Accédez à *nom_votre_projet***/Plugins/ibm-mfp-core/Bridging-Header.h** - ``` - //#import - //#import - //#import - ``` - e. Générez et exécutez votre application à l'aide de Xcode. -1. (Android uniquement) - Générez votre projet Android à l'aide de la commande suivante : -**cordova build android**. - - **Remarque** : Avant d'ouvrir votre projet dans Android Studio, vous devez d'abord générer votre application Cordova via l'interface CLI Cordova. A défaut, des erreurs de génération seront émises. - - -# Initialisation du plug-in Cordova -{: #cordova_initialize} - -Pour pouvoir utiliser le plug-in Cordova du service Push Notifications, vous devez l'initialiser en transmettant la route de l'application et -l'identificateur global unique de l'application. Une fois le plug-in initialisé, vous pouvez vous connecter à l'application serveur que vous avez créée dans le tableau de bord Bluemix. Le plug-in Cordova est l'encapsuleur pour les logiciels SDK de client Android et iOS qui permettent à une application Cordova de communiquer avec les services Bluemix. - -1. Initialisez le client BMS en copiant et en collant le fragment de code suivant dans votre fichier JavaScript principal (généralement situé sous le répertoire **www/js**). - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Modifiez le fragment de code pour qu'il utilise vos paramètres de route et d'identificateur global unique Bluemix. Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route et l'identificateur global unique de l'application. Utilisez les valeurs Route et Identificateur global unique de l'application comme paramètres dans votre fragment de code `BMSClient.initialize`. - - **Remarque** : Si vous avez créé une application Cordova à l'aide de l'interface CLI de Cordova (par exemple, à l'aide de la commande Cordova create nom_app), placez ce code Javascript dans le fichier **index.js**, après la fonction `app.receivedEvent` dans la fonction `onDeviceReady: function()` afin d'initialiser le client BMS. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, -``` - -# Enregistrement des appareils - -{: #cordova_register} - -Pour enregistrer un appareil auprès du service de notifications push, appelez la méthode d'enregistrement. - -Copiez et collez le fragment de code suivant dans votre application Cordova pour enregistrer un appareil : - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android n'utilise pas le paramètre settings. Si vous générez uniquement un appli Android, indiquez un objet vide. Par exemple : - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -Pour personnaliser les propriétés d'alerte, de badge et de son, ajoutez le fragment de code JavaScript suivant -à la partie Web de votre application Cordova. - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -Vous pouvez accéder au contenu du paramètre de réponse success dans Javascript à l'aide de JSON.parse : **var token = JSON.parse(response).token** - - -Les clés disponibles sont les suivantes : `token`, `userId`, and `deviceId`. - -Le fragment de code JavaScript ci-après montre comment initialiser le logiciel SDK de votre client Bluemix Mobile Services, enregistrer un appareil à l'aide du service de notifications push et passer en mode écoute sur les notifications push. Placez ce code dans votre fichier Javascript. - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -Dans **onDeviceReady: function()**. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -Ajoutez le fragment de code Objective-C suivant à la classe de votre délégué d'application : - -``` - // Enregistrement du jeton d'unité auprès du service de notification Push de Bluemix - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -Ajoutez le fragment de code Swift suivant à la classe de votre délégué d'application : - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##Etapes suivantes - -{: #cordova_register_next} - -1. Générez votre projet, puis exécutez-le à l'aide des commandes suivantes : - - * Android - **cordova build android**, puis **cordova run android** - - * iOS - **cordova build ios**, puis **cordova run ios** - - - -# Réception de notifications push sur les appareils -{: #cordova_receive} - -Copiez et collez les fragments de code ci-après pour recevoir des notifications push sur les appareils. - -##JavaScript - -Ajoutez le fragment de code JavaScript suivant à la partie Web de votre application Cordova : - - -``` -var notification = function(notification){ - // La notification est un objet JSON. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Propriétés de notification Android - -La section suivante répertorie les propriétés de notification Android : - -* message - Message de notification push -* payload - Objet JSON comportant un contenu de notification - - -##Propriétés de notification iOS - -La section suivante répertorie les propriétés de notification iOS : - -* message - Message de notification push -* payload - Objet JSON comportant un contenu de notification -action-loc-key - Chaîne utilisée comme clé pour obtenir une chaîne localisée à l'emplacement en cours, à utiliser comme titre de bouton approprié à la place de "View". -* badge - Numéro à afficher comme badge de l'icône d'application. Si cette propriété manque, le badge n'est pas changé. Pour supprimer le badge, associez cette propriété à la valeur 0. -* sound - Nom d'un fichier son dans le regroupement d'applications ou dans le dossier Library/Sounds du conteneur des données d'application. - -##Objective-C - -Ajoutez les fragments de code Objective-C suivants à la classe de votre délégué d'application : - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Gestion de la réception d'une notification distante au lancement -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -Ajoutez les fragments de code Swift suivants à la classe de votre délégué d'application : - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool - { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` - - - -# Envoi de notifications push de base -{: #push-send-notifications} - -Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base (sans utiliser de balise, de badge, de -contenu supplémentaire ou de fichier son). - - -Envoi de notifications push de base. - -1. Dans **Sélectionner les utilisateurs concernés**, sélectionnez l'une des options suivantes : **Tous les terminaux**, ou par plateforme : **Les appareils iOS uniquement** ou **Les appareils Android uniquement**. - - **Remarque** : Lorsque vous sélectionnez l'option **Tous les terminaux**, tous les appareils qui ont été abonnés à des notifications push reçoivent votre notification. - - ![Ecran Notifications](images/tag_notification.jpg) - -2. Dans la zone **Créez votre notification**, entrez votre message, puis cliquez sur **Envoyer**. -3. Vérifiez que vos appareils ont reçu votre notification. - - La capture d'écran suivante présente une boîte d'alerte relative à une notification push s'exécutant au premier plan sur un appareil Android et iOS. - ![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) - - ![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) - - La capture d'écran suivante présente une notification push qui s'exécute en arrière-plan sur un appareil Android. - ![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) - - - -# Etapes suivantes -{: #next_steps_tags} - -Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options -avancées. - -Ajoutez ces fonctions du service de notifications push à votre application. -Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). -Pour utiliser des options de notification avancées, voir [Notifications push avancées](t_advance_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Installation du plug-in Cordova Push +{: #cordova_install} + +Installez et utilisez le plug-in Push client pour développer davantage vos applications Cordova. Elle installe +également le plug-in Cordova Core, qui initialise votre connexion à Bluemix. + +### Avant de commencer + +1. Téléchargez les dernières versions d'Android Studio SDK et Xcode. +1. Configurez votre émulateur. Pour Android Studio, utilisez un émulateur qui prend en charge l'API Google Play. +1. Installez l'outil de ligne de commande Git. Pour Windows, prenez soin de sélectionner l'option **Run Git from the Window Command Prompt**. Pour plus d'informations sur le téléchargement et l'installation de cet outil, voir [Git](https://git-scm.com/downloads). + +1. Installez Node.js et l'outil Node Package Manager (NPM). L'outil de ligne de commande NPM est intégré à Node.js. Pour plus d'informations sur le téléchargement et l'installation de cet outil, voir [Node.js](https://nodejs.org/en/download/). +1. A partir de la ligne de commande, installez les outils de ligne de commande Cordova à l'aide de la commande **npm install -g cordova**. Vous en aurez besoin pour pouvoir utiliser le plug-in Cordova Push. Pour obtenir des informations sur l'installation de Cordova et la configuration de votre appli Cordova, voir [Cordova Apache](https://cordova.apache.org/#getstarted). + + **Remarque** : Pour afficher le fichier Readme du plug-in Cordova Push, accédez à [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## Installation du plug-in Cordova Push +1. Placez-vous dans le dossier dans lequel créer votre application Cordova et exécutez la commande ci-dessous pour créer une application Cordova. Si vous possédez déjà une application Cordova, passez à l'étape 3. + +``` +cordova create your_app_name + cd your_app_name +``` +1. Facultatif : éditez le fichier **config.xml** et remplacez le nom de l'application dans l'élément par le +nom de votre choix, plutôt que d'utiliser le nom HelloCordova par défaut. + + **Remarque** : Prenez soin de spécifier l'ID de bundle approprié. A défaut, les messages d'erreur suivants s'afficheront dans Xcode : + * The executable was signed with invalid entitlements. + * The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile. + + Pour corriger ce problème, spécifiez l'ID de bundle approprié dans Xcode ou dans le fichier **config.xml** de votre appli Cordova. + +1. Ajoutez l'API minimale prise en charge ou la déclaration de cible de déploiement dans le fichier config.xml de votre application Cordova. La valeur de minSdkVersion doit être supérieure à 15. La valeur de targetSdkVersion doit toujours refléter le logiciel SDK Android le plus récent disponible auprès de Google. + * **Android** - Avec votre éditeur, ouvrez le fichier config.xml et mettez à jour l'élément `` avec les versions de SDM minimum et cible : + + ``` + + + + + + ``` + * **iOS** - Mettez à jour l'élément avec une déclaration cible de déploiement : + + ``` + + + + + ``` + +1. A partir de l'interface de ligne de commande Cordova, ajoutez vos plateformes iOS et/ou Android à l'aide des commandes suivantes : + + ``` + cordova platform add ios@3.9.0 + cordova platform add android + ``` +1. Depuis le répertoire racine de votre application Cordova, entrez la commande suivante pour installer le plug-in Cordova Push : **cordova plugin add ibm-mfp-push**. + + Selon les plateformes que vous avez ajoutées, la sortie peut ressembler à l'exemple suivant : + + ``` + Installing "ibm-mfp-push" for android + Installing "ibm-mfp-push" for ios + ``` +1. Depuis *your-app-root-folder*, vérifiez que les plug-ins Cordova Core et Push ont été installés correctement en entrant la +commande suivante : **cordova plugin list**. + + Selon les plateformes que vous avez ajoutées, la sortie peut ressembler à l'exemple suivant : + + ``` + ibm-mfp-core 1.0.0 "MFPCore" + ibm-mfp-push 1.0.0 “MFPPush" + ``` +1. (iOS uniquement) - Configurez votre environnement de développement iOS. + a. Ouvrez votre fichier your-app-name.xcodeproj dans le répertoire *your-app-name***/platforms/ios** à l'aide de Xcode. + + b. Ajoutez l'en-tête de pontage. Accédez à **Build settings > Swift Compiler - Code Generation > Objective-C Bridging Header** et ajoutez le chemin suivant :*your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + c. Ajoutez le paramètre Frameworks. Accédez à **Build Settings > Linking > Runpath Search Paths** et ajoutez le paramètre suivant : + ``` + @executable_path/Frameworks + ``` + d. Supprimez la mise en commentaire des instructions d'importation Push suivantes dans votre en-tête de pontage. Accédez à *nom_votre_projet***/Plugins/ibm-mfp-core/Bridging-Header.h** + ``` + //#import + //#import + //#import + ``` + e. Générez et exécutez votre application à l'aide de Xcode. +1. (Android uniquement) - Générez votre projet Android à l'aide de la commande suivante : +**cordova build android**. + + **Remarque** : Avant d'ouvrir votre projet dans Android Studio, vous devez d'abord générer votre application Cordova via l'interface CLI Cordova. A défaut, des erreurs de génération seront émises. + + +# Initialisation du plug-in Cordova +{: #cordova_initialize} + +Pour pouvoir utiliser le plug-in Cordova du service Push Notifications, vous devez l'initialiser en transmettant la route de l'application et +l'identificateur global unique de l'application. Une fois le plug-in initialisé, vous pouvez vous connecter à l'application serveur que vous avez créée dans le tableau de bord Bluemix. Le plug-in Cordova est l'encapsuleur pour les logiciels SDK de client Android et iOS qui permettent à une application Cordova de communiquer avec les services Bluemix. + +1. Initialisez le client BMS en copiant et en collant le fragment de code suivant dans votre fichier JavaScript principal (généralement situé sous le répertoire **www/js**). + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Modifiez le fragment de code pour qu'il utilise vos paramètres de route et d'identificateur global unique Bluemix. Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route et l'identificateur global unique de l'application. Utilisez les valeurs Route et Identificateur global unique de l'application comme paramètres dans votre fragment de code `BMSClient.initialize`. + + **Remarque** : Si vous avez créé une application Cordova à l'aide de l'interface CLI de Cordova (par exemple, à l'aide de la commande Cordova create nom_app), placez ce code Javascript dans le fichier **index.js**, après la fonction `app.receivedEvent` dans la fonction `onDeviceReady: function()` afin d'initialiser le client BMS. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, +``` + +# Enregistrement des appareils + +{: #cordova_register} + +Pour enregistrer un appareil auprès du service de notifications push, appelez la méthode d'enregistrement. + +Copiez et collez le fragment de code suivant dans votre application Cordova pour enregistrer un appareil : + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android n'utilise pas le paramètre settings. Si vous générez uniquement un appli Android, indiquez un objet vide. Par exemple : + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +Pour personnaliser les propriétés d'alerte, de badge et de son, ajoutez le fragment de code JavaScript suivant +à la partie Web de votre application Cordova. + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +Vous pouvez accéder au contenu du paramètre de réponse success dans Javascript à l'aide de JSON.parse : **var token = JSON.parse(response).token** + + +Les clés disponibles sont les suivantes : `token`, `userId`, and `deviceId`. + +Le fragment de code JavaScript ci-après montre comment initialiser le logiciel SDK de votre client Bluemix Mobile Services, enregistrer un appareil à l'aide du service de notifications push et passer en mode écoute sur les notifications push. Placez ce code dans votre fichier Javascript. + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +Dans **onDeviceReady: function()**. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +Ajoutez le fragment de code Objective-C suivant à la classe de votre délégué d'application : + +``` + // Enregistrement du jeton d'unité auprès du service de notification Push de Bluemix + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +Ajoutez le fragment de code Swift suivant à la classe de votre délégué d'application : + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## Etapes suivantes + +{: #cordova_register_next} + +1. Générez votre projet, puis exécutez-le à l'aide des commandes suivantes : + + * Android - **cordova build android**, puis **cordova run android** + + * iOS - **cordova build ios**, puis **cordova run ios** + + + +# Réception de notifications push sur les appareils +{: #cordova_receive} + +Copiez et collez les fragments de code ci-après pour recevoir des notifications push sur les appareils. + +## JavaScript + +Ajoutez le fragment de code JavaScript suivant à la partie Web de votre application Cordova : + + +``` +var notification = function(notification){ + // La notification est un objet JSON. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +## Propriétés de notification Android + +La section suivante répertorie les propriétés de notification Android : + +* message - Message de notification push +* payload - Objet JSON comportant un contenu de notification + + +## Propriétés de notification iOS + +La section suivante répertorie les propriétés de notification iOS : + +* message - Message de notification push +* payload - Objet JSON comportant un contenu de notification +action-loc-key - Chaîne utilisée comme clé pour obtenir une chaîne localisée à l'emplacement en cours, à utiliser comme titre de bouton approprié à la place de "View". +* badge - Numéro à afficher comme badge de l'icône d'application. Si cette propriété manque, le badge n'est pas changé. Pour supprimer le badge, associez cette propriété à la valeur 0. +* sound - Nom d'un fichier son dans le regroupement d'applications ou dans le dossier Library/Sounds du conteneur des données d'application. + +## Objective-C + +Ajoutez les fragments de code Objective-C suivants à la classe de votre délégué d'application : + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Gestion de la réception d'une notification distante au lancement +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +## Swift + +Ajoutez les fragments de code Swift suivants à la classe de votre délégué d'application : + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool + { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` + + + +# Envoi de notifications push de base +{: #push-send-notifications} + +Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base (sans utiliser de balise, de badge, de +contenu supplémentaire ou de fichier son). + + +Envoi de notifications push de base. + +1. Dans **Sélectionner les utilisateurs concernés**, sélectionnez l'une des options suivantes : **Tous les terminaux**, ou par plateforme : **Les appareils iOS uniquement** ou **Les appareils Android uniquement**. + + **Remarque** : Lorsque vous sélectionnez l'option **Tous les terminaux**, tous les appareils qui ont été abonnés à des notifications push reçoivent votre notification. + + ![Ecran Notifications](images/tag_notification.jpg) + +2. Dans la zone **Créez votre notification**, entrez votre message, puis cliquez sur **Envoyer**. +3. Vérifiez que vos appareils ont reçu votre notification. + + La capture d'écran suivante présente une boîte d'alerte relative à une notification push s'exécutant au premier plan sur un appareil Android et iOS. + ![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) + + ![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) + + La capture d'écran suivante présente une notification push qui s'exécute en arrière-plan sur un appareil Android. + ![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) + + + +# Etapes suivantes +{: #next_steps_tags} + +Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options +avancées. + +Ajoutez ces fonctions du service de notifications push à votre application. +Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). +Pour utiliser des options de notification avancées, voir [Notifications push avancées](t_advance_notifications.html). diff --git a/services/mobilepush/nl/fr/t_cordova_receive.md b/services/mobilepush/nl/fr/t_cordova_receive.md index 265585cc1..884da23af 100644 --- a/services/mobilepush/nl/fr/t_cordova_receive.md +++ b/services/mobilepush/nl/fr/t_cordova_receive.md @@ -1,85 +1,85 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Réception de notifications push sur les appareils -{: #cordova_receive} - -Copiez et collez les fragments de code ci-après pour recevoir des notifications push sur les appareils. - -##JavaScript - -Ajoutez le fragment de code JavaScript suivant à la partie Web de votre application Cordova : - - -``` -var notification = function(notification){ - // La notification est un objet JSON. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Propriétés de notification Android - -La section suivante répertorie les propriétés de notification Android : - -* message - Message de notification push -* payload - Objet JSON comportant un contenu de notification - - -##Propriétés de notification iOS - -La section suivante répertorie les propriétés de notification iOS : - -* message - Message de notification push -* payload - Objet JSON comportant un contenu de notification -action-loc-key - Chaîne utilisée comme clé pour obtenir une chaîne localisée à l'emplacement en cours, à utiliser comme titre de bouton approprié à la place de "View". -* badge - Numéro à afficher comme badge de l'icône d'application. Si cette propriété manque, le badge n'est pas changé. Pour supprimer le badge, associez cette propriété à la valeur 0. -* sound - Nom d'un fichier son dans le regroupement d'applications ou dans le dossier Library/Sounds du conteneur des données d'application. - -##Objective-C - -Ajoutez les fragments de code Objective-C suivants à la classe de votre délégué d'application : - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Gestion de la réception d'une notification distante au lancement -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -Ajoutez les fragments de code Swift suivants à la classe de votre délégué d'application : - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool - { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` -Etape suivante. [Envoyez des notifications push de base](t_send_push_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Réception de notifications push sur les appareils +{: #cordova_receive} + +Copiez et collez les fragments de code ci-après pour recevoir des notifications push sur les appareils. + +##JavaScript + +Ajoutez le fragment de code JavaScript suivant à la partie Web de votre application Cordova : + + +``` +var notification = function(notification){ + // La notification est un objet JSON. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +##Propriétés de notification Android + +La section suivante répertorie les propriétés de notification Android : + +* message - Message de notification push +* payload - Objet JSON comportant un contenu de notification + + +##Propriétés de notification iOS + +La section suivante répertorie les propriétés de notification iOS : + +* message - Message de notification push +* payload - Objet JSON comportant un contenu de notification +action-loc-key - Chaîne utilisée comme clé pour obtenir une chaîne localisée à l'emplacement en cours, à utiliser comme titre de bouton approprié à la place de "View". +* badge - Numéro à afficher comme badge de l'icône d'application. Si cette propriété manque, le badge n'est pas changé. Pour supprimer le badge, associez cette propriété à la valeur 0. +* sound - Nom d'un fichier son dans le regroupement d'applications ou dans le dossier Library/Sounds du conteneur des données d'application. + +##Objective-C + +Ajoutez les fragments de code Objective-C suivants à la classe de votre délégué d'application : + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Gestion de la réception d'une notification distante au lancement +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +##Swift + +Ajoutez les fragments de code Swift suivants à la classe de votre délégué d'application : + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool + { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` +Etape suivante. [Envoyez des notifications push de base](t_send_push_notifications.html). diff --git a/services/mobilepush/nl/fr/t_cordova_register.md b/services/mobilepush/nl/fr/t_cordova_register.md index 6449f6010..69e44dd08 100644 --- a/services/mobilepush/nl/fr/t_cordova_register.md +++ b/services/mobilepush/nl/fr/t_cordova_register.md @@ -1,140 +1,140 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Enregistrement des appareils - -{: #cordova_register} - -Pour enregistrer un appareil auprès du service de notifications push, appelez la méthode d'enregistrement. - -Copiez et collez le fragment de code suivant dans votre application Cordova pour enregistrer un appareil : - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android n'utilise pas le paramètre settings. Si vous générez uniquement un appli Android, indiquez un objet vide. Par exemple : - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -Pour personnaliser les propriétés d'alerte, de badge et de son, ajoutez le fragment de code JavaScript suivant -à la partie Web de votre application Cordova. - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -Vous pouvez accéder au contenu du paramètre de réponse success dans Javascript à l'aide de JSON.parse : **var token = JSON.parse(response).token** - - -Les clés disponibles sont les suivantes : `token`, `userId`, and `deviceId`. - -Le fragment de code JavaScript ci-après montre comment initialiser le logiciel SDK de votre client Bluemix Mobile Services, enregistrer un appareil à l'aide du service de notifications push et passer en mode écoute sur les notifications push. Placez ce code dans votre fichier Javascript. - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -Dans **onDeviceReady: function()**. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -Ajoutez le fragment de code Objective-C suivant à la classe de votre délégué d'application : - -``` - // Enregistrement du jeton d'unité auprès du service de notification Push de Bluemix - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -Ajoutez le fragment de code Swift suivant à la classe de votre délégué d'application : - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##Etapes suivantes -{: #cordova_register_next} - -1. Générez votre projet, puis exécutez-le à l'aide des commandes suivantes : - - * Android - **cordova build android**, puis **cordova run android** - - * iOS - **cordova build ios**, puis **cordova run ios** -1. [Réception de notifications push sur les appareils](t_cordova_receive.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Enregistrement des appareils + +{: #cordova_register} + +Pour enregistrer un appareil auprès du service de notifications push, appelez la méthode d'enregistrement. + +Copiez et collez le fragment de code suivant dans votre application Cordova pour enregistrer un appareil : + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android n'utilise pas le paramètre settings. Si vous générez uniquement un appli Android, indiquez un objet vide. Par exemple : + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +Pour personnaliser les propriétés d'alerte, de badge et de son, ajoutez le fragment de code JavaScript suivant +à la partie Web de votre application Cordova. + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +Vous pouvez accéder au contenu du paramètre de réponse success dans Javascript à l'aide de JSON.parse : **var token = JSON.parse(response).token** + + +Les clés disponibles sont les suivantes : `token`, `userId`, and `deviceId`. + +Le fragment de code JavaScript ci-après montre comment initialiser le logiciel SDK de votre client Bluemix Mobile Services, enregistrer un appareil à l'aide du service de notifications push et passer en mode écoute sur les notifications push. Placez ce code dans votre fichier Javascript. + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +Dans **onDeviceReady: function()**. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +Ajoutez le fragment de code Objective-C suivant à la classe de votre délégué d'application : + +``` + // Enregistrement du jeton d'unité auprès du service de notification Push de Bluemix + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +Ajoutez le fragment de code Swift suivant à la classe de votre délégué d'application : + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## Etapes suivantes +{: #cordova_register_next} + +1. Générez votre projet, puis exécutez-le à l'aide des commandes suivantes : + + * Android - **cordova build android**, puis **cordova run android** + + * iOS - **cordova build ios**, puis **cordova run ios** +1. [Réception de notifications push sur les appareils](t_cordova_receive.html). diff --git a/services/mobilepush/nl/fr/t_create_push_instance.md b/services/mobilepush/nl/fr/t_create_push_instance.md index 18e00df49..243d8624d 100644 --- a/services/mobilepush/nl/fr/t_create_push_instance.md +++ b/services/mobilepush/nl/fr/t_create_push_instance.md @@ -1,34 +1,34 @@ -# Création d'une instance de service push -{: #create-push-instance} - -Avant d'utiliser {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, vous devez créer une application {{site.data.keyword.Bluemix}} ; par exemple, une appli Node.js. Ensuite, vous créez une instance d'un service Push, {{site.data.keyword.mobilepushfull}}, qui doit être liée à cette application Bluemix. Pour ce faire, vous pouvez aussi accéder à la section Conteneurs boilerplate du catalogue Bluemix et cliquer sur MobileFirst Services Starter. - -**Remarque** : Si vous avez configuré vos organisations pour qu'elles gèrent votre environnement, sélectionnez l'organisation dans laquelle créer le contexte -d'exécution et les services pour votre application mobile. - - -1. Si vous ne disposez pas d'une application Bluemix, vous devez en créer une, par exemple, une appli Node.js. Pour créer une application Bluemix, -accédez au tableau de bord Bluemix et cliquez sur **Créer une appli**. - - **Remarque** : Si vous disposez d'une application, passez à l'étape 7 pour ajouter un service.![Créer une instance de service](images/create_service_instance1.jpg "Créer une instance de service") - -1. Depuis **Choix de votre modèle d'application**, cliquez sur **WEB**. - -3. Dans la zone **Choix du point de départ**, sélectionnez **SDK for Node.js**, puis cliquez sur **CONTINUER**.![Point de départ](images/create_service_nodejs2.jpg). - -4. Dans le menu déroulant **Espace**, sélectionnez l'espace de votre organisation.![Sélectionner un espace d'organisation](images/create_a_service3.jpg) -1. Dans la zone **Nom**, entrez le nom de votre application et dans la zone Hôte, entrez le nom de l'hôte. - -1. Dans le menu déroulant **Plan sélectionné**, sélectionnez un plan, puis cliquez sur le bouton **CREER**. Attendez que l'application soit constituée. - -1. Cliquez sur le lien **Vue d'ensemble**.![Ajouter un service](images/create_service_add4.jpg) -1. Cliquez sur **Ajouter un service**. L'écran CATALOGUE s'affiche. - -1. Sélectionnez **IBM Push Notifications** et depuis le menu déroulant **Espace**, sélectionnez votre organisation.![Menu déroulant d'espace d'organisation](images/create_service_org.jpg) -1. Dans la zone **Nom du service**, entrez le nom du service de notifications push. - -1. Dans le menu **Plan sélectionné**, sélectionnez un plan et cliquez sur le bouton **CREER**. - -1. Cliquez sur **Oui** pour reconstituer l'application.![Service IBM Push Notification](images/create_service_notification5.jpg) - -1. Cliquez sur **Notifications push** pour afficher le tableau de bord de notification push. +# Création d'une instance de service push +{: #create-push-instance} + +Avant d'utiliser {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, vous devez créer une application {{site.data.keyword.Bluemix}} ; par exemple, une appli Node.js. Ensuite, vous créez une instance d'un service Push, {{site.data.keyword.mobilepushfull}}, qui doit être liée à cette application Bluemix. Pour ce faire, vous pouvez aussi accéder à la section Conteneurs boilerplate du catalogue Bluemix et cliquer sur MobileFirst Services Starter. + +**Remarque** : Si vous avez configuré vos organisations pour qu'elles gèrent votre environnement, sélectionnez l'organisation dans laquelle créer le contexte +d'exécution et les services pour votre application mobile. + + +1. Si vous ne disposez pas d'une application Bluemix, vous devez en créer une, par exemple, une appli Node.js. Pour créer une application Bluemix, +accédez au tableau de bord Bluemix et cliquez sur **Créer une appli**. + + **Remarque** : Si vous disposez d'une application, passez à l'étape 7 pour ajouter un service.![Créer une instance de service](images/create_service_instance1.jpg "Créer une instance de service") + +1. Depuis **Choix de votre modèle d'application**, cliquez sur **WEB**. + +3. Dans la zone **Choix du point de départ**, sélectionnez **SDK for Node.js**, puis cliquez sur **CONTINUER**.![Point de départ](images/create_service_nodejs2.jpg). + +4. Dans le menu déroulant **Espace**, sélectionnez l'espace de votre organisation.![Sélectionner un espace d'organisation](images/create_a_service3.jpg) +1. Dans la zone **Nom**, entrez le nom de votre application et dans la zone Hôte, entrez le nom de l'hôte. + +1. Dans le menu déroulant **Plan sélectionné**, sélectionnez un plan, puis cliquez sur le bouton **CREER**. Attendez que l'application soit constituée. + +1. Cliquez sur le lien **Vue d'ensemble**.![Ajouter un service](images/create_service_add4.jpg) +1. Cliquez sur **Ajouter un service**. L'écran CATALOGUE s'affiche. + +1. Sélectionnez **IBM Push Notifications** et depuis le menu déroulant **Espace**, sélectionnez votre organisation.![Menu déroulant d'espace d'organisation](images/create_service_org.jpg) +1. Dans la zone **Nom du service**, entrez le nom du service de notifications push. + +1. Dans le menu **Plan sélectionné**, sélectionnez un plan et cliquez sur le bouton **CREER**. + +1. Cliquez sur **Oui** pour reconstituer l'application.![Service IBM Push Notification](images/create_service_notification5.jpg) + +1. Cliquez sur **Notifications push** pour afficher le tableau de bord de notification push. diff --git a/services/mobilepush/nl/fr/t_enable-ios-notifications-receive.md b/services/mobilepush/nl/fr/t_enable-ios-notifications-receive.md index a42b1779e..b7f75cec4 100644 --- a/services/mobilepush/nl/fr/t_enable-ios-notifications-receive.md +++ b/services/mobilepush/nl/fr/t_enable-ios-notifications-receive.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Réception de notifications push sur des appareils iOS -{: #enable-push-ios-notifications-receiving} - -Recevez des notifications push sur des appareils iOS. - -##Objective-C -Pour recevoir des notifications push sur des appareils iOS, ajoutez la méthode Objective-C suivante au délégué d'application de votre application : - -``` -// For Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -Pour recevoir des notifications push sur des appareils iOS, ajoutez la méthode Swift suivante au délégué d'application de votre application : - -``` - // For Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the server - } -``` - +--- + +copyright: + years: 2015, 2016 + +--- + +# Réception de notifications push sur des appareils iOS +{: #enable-push-ios-notifications-receiving} + +Recevez des notifications push sur des appareils iOS. + +##Objective-C +Pour recevoir des notifications push sur des appareils iOS, ajoutez la méthode Objective-C suivante au délégué d'application de votre application : + +``` +// For Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +##Swift +Pour recevoir des notifications push sur des appareils iOS, ajoutez la méthode Swift suivante au délégué d'application de votre application : + +``` + // For Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the server + } +``` + diff --git a/services/mobilepush/nl/fr/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/fr/t_enable_actionable_notifications_ios.md index 754e5f4da..38c5a5899 100644 --- a/services/mobilepush/nl/fr/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/fr/t_enable_actionable_notifications_ios.md @@ -1,104 +1,104 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Activation des notifications interactives pour iOS -{: #enable-actionable-notifications-ios} - -A la différence des notifications push traditionnelles, les notifications interactives invitent les utilisateurs à effectuer une sélection lorsqu'ils reçoivent l'alerte de notification sans ouvrir l'application. Utilisez les instructions ci-après pour activer les notifications push interactives dans votre application. - -1. Créez une réponse utilisateur. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. Créez une catégorie de notification et définissez une action. **UIUserNotificationActionContextDefault** ou **UIUserNotificationActionContextMinimal** sont des contextes valides. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. Créez le paramètre de notification et affectez les catégories de l'étape -précédente. - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. Créez la notification locale ou éloignée et affectez-lui l'identité de la catégorie. - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Activation des notifications interactives pour iOS +{: #enable-actionable-notifications-ios} + +A la différence des notifications push traditionnelles, les notifications interactives invitent les utilisateurs à effectuer une sélection lorsqu'ils reçoivent l'alerte de notification sans ouvrir l'application. Utilisez les instructions ci-après pour activer les notifications push interactives dans votre application. + +1. Créez une réponse utilisateur. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. Créez une catégorie de notification et définissez une action. **UIUserNotificationActionContextDefault** ou **UIUserNotificationActionContextMinimal** sont des contextes valides. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. Créez le paramètre de notification et affectez les catégories de l'étape +précédente. + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. Créez la notification locale ou éloignée et affectez-lui l'identité de la catégorie. + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/fr/t_enable_ios_notifications_initialize.md b/services/mobilepush/nl/fr/t_enable_ios_notifications_initialize.md index 2f3130e7e..a4442ffc9 100644 --- a/services/mobilepush/nl/fr/t_enable_ios_notifications_initialize.md +++ b/services/mobilepush/nl/fr/t_enable_ios_notifications_initialize.md @@ -1,68 +1,68 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Initialisation du logiciel SDK Push pour les applications iOS -{: #enable-push-ios-notifications-initialize} - -Le code d'initialisation se trouve généralement dans le délégué d'application de l'application iOS. -Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route -de l'application et l'identificateur global unique. - -##Initialisation du logiciel SDK de base - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - -##Initialisation du logiciel SDK Push du client - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## Route, identificateur global unique et région Bluemix - -**appRoute** - -Spécifie la route qui a été affectée à l'application serveur que vous avez créée dans Bluemix. - -**GUID** - -Spécifie la clé unique qui a été affectée à l'application que vous avez créée dans Bluemix. Cette -valeur est sensible à la casse. - -**bluemixRegionSuffix** - -Indique l'emplacement où l'appli est hébergée. Le paramètre `bluemixRegion` spécifie le déploiement Bluemix que vous utilisez. ous pouvez définir cette valeur avec une propriété statique `BMSClient.REGION` et utiliser l'une des trois valeurs suivantes : - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY +--- + +copyright: + years: 2015, 2016 + +--- + +# Initialisation du logiciel SDK Push pour les applications iOS +{: #enable-push-ios-notifications-initialize} + +Le code d'initialisation se trouve généralement dans le délégué d'application de l'application iOS. +Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route +de l'application et l'identificateur global unique. + +## Initialisation du logiciel SDK de base + +### Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +### Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + +## Initialisation du logiciel SDK Push du client + +### Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +### Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## Route, identificateur global unique et région Bluemix + +**appRoute** + +Spécifie la route qui a été affectée à l'application serveur que vous avez créée dans Bluemix. + +**GUID** + +Spécifie la clé unique qui a été affectée à l'application que vous avez créée dans Bluemix. Cette +valeur est sensible à la casse. + +**bluemixRegionSuffix** + +Indique l'emplacement où l'appli est hébergée. Le paramètre `bluemixRegion` spécifie le déploiement Bluemix que vous utilisez. ous pouvez définir cette valeur avec une propriété statique `BMSClient.REGION` et utiliser l'une des trois valeurs suivantes : + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY diff --git a/services/mobilepush/nl/fr/t_enable_ios_notifications_install.md b/services/mobilepush/nl/fr/t_enable_ios_notifications_install.md index beb018636..c2ac6602f 100644 --- a/services/mobilepush/nl/fr/t_enable_ios_notifications_install.md +++ b/services/mobilepush/nl/fr/t_enable_ios_notifications_install.md @@ -1,326 +1,326 @@ -# Initialisation du logiciel SDK Push pour les applications iOS -{: #enable-push-ios-notifications-install} - -Pour un projet Xcode existant, vous pouvez configurer le logiciel SDK du client Bluemix Mobile Services à l'aide de l'outil de gestion des dépendances CocoaPods. Vous pouvez aussi installer le logiciel SDK manuellement. - -**Remarque** : Pour afficher le fichier Readme Swift Push, accédez à https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master - -##Installation de CocoaPods - -1. Installez CocoaPods en exécutant la commande suivante sur votre terminal Mac : -``` -$ sudo gem install cocoapods -``` -2. Entrez la commande ci-dessous dans le terminal pour initialiser CocoaPods. Prenez soin d'exécuter cette commande dans le répertoire où se trouve votre Xcode. La commande `pod init` permet de créer un titre de fichier. -``` -$ pod init -``` -3. Dans le fichier Pod généré, ajoutez les dépendances de logiciel SDK dont vous avez besoin. Copiez le fichier Pod suivant : - - Objective-C - - ``` - source 'https://github.com/CocoaPods/Specs.git' - Copiez la liste suivante en l'état et supprimez les dépendances dont vous n'avez pas besoin - pod 'IMFCore' - pod 'IMFPush' - ``` - - Swift - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - end - ``` -3. Depuis le terminal, accédez au dossier de votre projet et installez des dépendances avec la commande suivante : -``` -$ pod update -``` -Cette commande installe vos dépendances et crée un espace de travail Xcode. **Remarque** : Prenez soin de toujours ouvrir le nouvel espace de travail Xcode au lieu du fichier de projet Xcode d'origine : - ``` - $ open App.xcworkspace - ``` -Cet espace de travail contient votre projet d'origine et le projet Pods contenant vos dépendances. Si -vous voulez modifier un dossier source Bluemix Mobile Services, vous le trouverez dans votre projet -Pods, sous `Pods/yourImportedSourceFolder`. Par exemple :`Pods/IMFGoogleAuthentication`. - -##Utilisation d'infrastructures et de dossiers source importés - -Référencez le logiciel SDK dans votre code. - - -### Objective-C - -Ecrivez des directives #import pour les en-têtes pertinents, par exemple : - -``` -//Objective-C -#import -#import -``` - -**Remarque** : La mise à jour de votre projet Pods à l'aide des commandes CocoaPods `pod install` ou `pod update` peut remplacer les dossiers source Bluemix Mobile Services. Si -vous voulez conserver vos versions personnalisées des fichiers d'origine, prenez soin de les sauvegarder avant d'entrer l'une de ces commandes. - -###Swift - -**Eléments prérequis** - -- iOS 8.0 ou version ultérieure -- Xcode 7 - - -Ecrivez des directives #import pour les en-têtes pertinents, par exemple : - -``` -//swift -import BMSCore -import BMSPush -``` - - -##Paramètres de génération - -Accédez à **Xcode > Build Settings > Build Options** et affectez à l'option Set Enable Bitcode la valeur **No**. - -**Attention** : Depuis iOS 9, des modifications apportées à la fonction App Transport Security (ATS) peuvent avoir un impact sur la façon dont vous gérez le processus d'authentification. Les articles de blogue suivants contiennent d'autres informations sur les modifications : [ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) et [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) - - - - -# Initialisation du logiciel SDK Push pour les applications iOS -{: #enable-push-ios-notifications-initialize} - -Le code d'initialisation se trouve généralement dans le délégué d'application de l'application iOS. -Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route -de l'application et l'identificateur global unique. - -##Initialisation du logiciel SDK de base - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - - -##Initialisation du logiciel SDK Push du client - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## Route, identificateur global unique et région Bluemix - -**appRoute** - -Spécifie la route qui a été affectée à l'application serveur que vous avez créée dans Bluemix. - -**GUID** - -Spécifie la clé unique qui a été affectée à l'application que vous avez créée dans Bluemix. Cette -valeur est sensible à la casse. - -**bluemixRegionSuffix** - -Indique l'emplacement où l'appli est hébergée. Le paramètre `bluemixRegion` spécifie le déploiement Bluemix que vous utilisez. ous pouvez définir cette valeur avec une propriété statique `BMSClient.REGION` et utiliser l'une des trois valeurs suivantes : - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - - - - -# Enregistrement d'applications et d'appareils iOS -{: #enable-push-ios-notifications-register} - - -Une application doit être enregistrée auprès d'APNS pour pouvoir recevoir des notifications distantes. Cet -enregistrement s'effectue généralement après l'installation de l'application sur un appareil. Une fois que le jeton d'appareil généré par APNS a -été reçu par l'application, il doit être transmis au service Push Notifications. - -Pour enregistrer les applications et les appareils iOs : - -1. Créez une application de back end -2. Transmettez le jeton au service de notifications push - - -##Créez une application de back end - -Créez une application de back end dans la section Conteneurs boilerplate du catalogue Bluemix, qui lie automatiquement le service Push à cette application. Si vous avez déjà créé une application de -back end, veillez à lier l'application au service de notifications push. - -###Objective-C - -``` - //Pour Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##Transmettez le jeton au service de notifications push - -Une fois reçu le jeton envoyé par le service APNS, transmettez-le au service de notifications push par le biais de la méthode `registerDevice:withDeviceToken`. - -###Objective-C - -``` -//Pour Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -Une fois reçu le jeton envoyé par le service APNS, transmettez-le au service de notifications push par le biais de la méthode `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` - - - -# Réception de notifications push sur des appareils iOS -{: #enable-push-ios-notifications-receiving} - -Recevez des notifications push sur des appareils iOS. - -##Objective-C -Pour recevoir des notifications push sur des appareils iOS, ajoutez la méthode Objective-C suivante au délégué d'application de votre application : - -``` -// For Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -Pour recevoir des notifications push sur des appareils iOS, ajoutez la méthode Swift suivante au délégué d'application de votre application : - -``` - // For Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the server - } - -``` - - - -# Envoi de notifications push de base -{: #push-send-notifications} - -Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base (sans utiliser de balise, de badge, de -contenu supplémentaire ou de fichier son). - - -Envoi de notifications push de base. - -1. Dans **Sélectionner les utilisateurs concernés**, sélectionnez l'une des options suivantes : **Tous les terminaux**, ou par plateforme : **Les appareils iOS uniquement** ou **Les appareils Android uniquement**. - - **Remarque** : Lorsque vous sélectionnez l'option **Tous les terminaux**, tous les appareils qui ont été abonnés à des notifications push reçoivent votre notification. - - ![Ecran Notifications](images/tag_notification.jpg) - -2. Dans la zone **Créez votre notification**, entrez votre message, puis cliquez sur **Envoyer**. -3. Vérifiez que vos appareils ont reçu votre notification. - - La capture d'écran suivante présente une boîte d'alerte relative à une notification push s'exécutant au premier plan sur un appareil Android et iOS. - ![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) - - ![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) - - La capture d'écran suivante présente une notification push qui s'exécute en arrière-plan sur un appareil Android. - ![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) - - - - -# Etapes suivantes -{: #next_steps_tags} - -Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options -avancées. - -Ajoutez ces fonctions du service de notifications push à votre application. -Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). -Pour utiliser des options de notification avancées, voir [Notifications push avancées](t_advance_notifications.html). +# Initialisation du logiciel SDK Push pour les applications iOS +{: #enable-push-ios-notifications-install} + +Pour un projet Xcode existant, vous pouvez configurer le logiciel SDK du client Bluemix Mobile Services à l'aide de l'outil de gestion des dépendances CocoaPods. Vous pouvez aussi installer le logiciel SDK manuellement. + +**Remarque** : Pour afficher le fichier Readme Swift Push, accédez à https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master + +##Installation de CocoaPods + +1. Installez CocoaPods en exécutant la commande suivante sur votre terminal Mac : +``` +$ sudo gem install cocoapods +``` +2. Entrez la commande ci-dessous dans le terminal pour initialiser CocoaPods. Prenez soin d'exécuter cette commande dans le répertoire où se trouve votre Xcode. La commande `pod init` permet de créer un titre de fichier. +``` +$ pod init +``` +3. Dans le fichier Pod généré, ajoutez les dépendances de logiciel SDK dont vous avez besoin. Copiez le fichier Pod suivant : + + Objective-C + + ``` + source 'https://github.com/CocoaPods/Specs.git' + Copiez la liste suivante en l'état et supprimez les dépendances dont vous n'avez pas besoin + pod 'IMFCore' + pod 'IMFPush' + ``` + + Swift + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + end + ``` +3. Depuis le terminal, accédez au dossier de votre projet et installez des dépendances avec la commande suivante : +``` +$ pod update +``` +Cette commande installe vos dépendances et crée un espace de travail Xcode. **Remarque** : Prenez soin de toujours ouvrir le nouvel espace de travail Xcode au lieu du fichier de projet Xcode d'origine : + ``` + $ open App.xcworkspace + ``` +Cet espace de travail contient votre projet d'origine et le projet Pods contenant vos dépendances. Si +vous voulez modifier un dossier source Bluemix Mobile Services, vous le trouverez dans votre projet +Pods, sous `Pods/yourImportedSourceFolder`. Par exemple :`Pods/IMFGoogleAuthentication`. + +##Utilisation d'infrastructures et de dossiers source importés + +Référencez le logiciel SDK dans votre code. + + +### Objective-C + +Ecrivez des directives #import pour les en-têtes pertinents, par exemple : + +``` +//Objective-C +# import +# import +``` + +**Remarque** : La mise à jour de votre projet Pods à l'aide des commandes CocoaPods `pod install` ou `pod update` peut remplacer les dossiers source Bluemix Mobile Services. Si +vous voulez conserver vos versions personnalisées des fichiers d'origine, prenez soin de les sauvegarder avant d'entrer l'une de ces commandes. + +###Swift + +**Eléments prérequis** + +- iOS 8.0 ou version ultérieure +- Xcode 7 + + +Ecrivez des directives #import pour les en-têtes pertinents, par exemple : + +``` +//swift +import BMSCore +import BMSPush +``` + + +##Paramètres de génération + +Accédez à **Xcode > Build Settings > Build Options** et affectez à l'option Set Enable Bitcode la valeur **No**. + +**Attention** : Depuis iOS 9, des modifications apportées à la fonction App Transport Security (ATS) peuvent avoir un impact sur la façon dont vous gérez le processus d'authentification. Les articles de blogue suivants contiennent d'autres informations sur les modifications : [ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) et [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) + + + + +# Initialisation du logiciel SDK Push pour les applications iOS +{: #enable-push-ios-notifications-initialize} + +Le code d'initialisation se trouve généralement dans le délégué d'application de l'application iOS. +Cliquez sur le lien **Options pour application mobile** dans le tableau de bord de votre application Bluemix pour obtenir la route +de l'application et l'identificateur global unique. + +##Initialisation du logiciel SDK de base + +###Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +###Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + + +##Initialisation du logiciel SDK Push du client + +###Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +###Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## Route, identificateur global unique et région Bluemix + +**appRoute** + +Spécifie la route qui a été affectée à l'application serveur que vous avez créée dans Bluemix. + +**GUID** + +Spécifie la clé unique qui a été affectée à l'application que vous avez créée dans Bluemix. Cette +valeur est sensible à la casse. + +**bluemixRegionSuffix** + +Indique l'emplacement où l'appli est hébergée. Le paramètre `bluemixRegion` spécifie le déploiement Bluemix que vous utilisez. ous pouvez définir cette valeur avec une propriété statique `BMSClient.REGION` et utiliser l'une des trois valeurs suivantes : + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + + + + +# Enregistrement d'applications et d'appareils iOS +{: #enable-push-ios-notifications-register} + + +Une application doit être enregistrée auprès d'APNS pour pouvoir recevoir des notifications distantes. Cet +enregistrement s'effectue généralement après l'installation de l'application sur un appareil. Une fois que le jeton d'appareil généré par APNS a +été reçu par l'application, il doit être transmis au service Push Notifications. + +Pour enregistrer les applications et les appareils iOs : + +1. Créez une application de back end +2. Transmettez le jeton au service de notifications push + + +##Créez une application de back end + +Créez une application de back end dans la section Conteneurs boilerplate du catalogue Bluemix, qui lie automatiquement le service Push à cette application. Si vous avez déjà créé une application de +back end, veillez à lier l'application au service de notifications push. + +###Objective-C + +``` + //Pour Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +###Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +##Transmettez le jeton au service de notifications push + +Une fois reçu le jeton envoyé par le service APNS, transmettez-le au service de notifications push par le biais de la méthode `registerDevice:withDeviceToken`. + +###Objective-C + +``` +//Pour Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +###Swift + +Une fois reçu le jeton envoyé par le service APNS, transmettez-le au service de notifications push par le biais de la méthode `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` + + + +# Réception de notifications push sur des appareils iOS +{: #enable-push-ios-notifications-receiving} + +Recevez des notifications push sur des appareils iOS. + +##Objective-C +Pour recevoir des notifications push sur des appareils iOS, ajoutez la méthode Objective-C suivante au délégué d'application de votre application : + +``` +// For Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +##Swift +Pour recevoir des notifications push sur des appareils iOS, ajoutez la méthode Swift suivante au délégué d'application de votre application : + +``` + // For Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the server + } + +``` + + + +# Envoi de notifications push de base +{: #push-send-notifications} + +Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base (sans utiliser de balise, de badge, de +contenu supplémentaire ou de fichier son). + + +Envoi de notifications push de base. + +1. Dans **Sélectionner les utilisateurs concernés**, sélectionnez l'une des options suivantes : **Tous les terminaux**, ou par plateforme : **Les appareils iOS uniquement** ou **Les appareils Android uniquement**. + + **Remarque** : Lorsque vous sélectionnez l'option **Tous les terminaux**, tous les appareils qui ont été abonnés à des notifications push reçoivent votre notification. + + ![Ecran Notifications](images/tag_notification.jpg) + +2. Dans la zone **Créez votre notification**, entrez votre message, puis cliquez sur **Envoyer**. +3. Vérifiez que vos appareils ont reçu votre notification. + + La capture d'écran suivante présente une boîte d'alerte relative à une notification push s'exécutant au premier plan sur un appareil Android et iOS. + ![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) + + ![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) + + La capture d'écran suivante présente une notification push qui s'exécute en arrière-plan sur un appareil Android. + ![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) + + + + +# Etapes suivantes +{: #next_steps_tags} + +Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options +avancées. + +Ajoutez ces fonctions du service de notifications push à votre application. +Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](c_tag_basednotifications.html). +Pour utiliser des options de notification avancées, voir [Notifications push avancées](t_advance_notifications.html). diff --git a/services/mobilepush/nl/fr/t_enable_ios_notifications_register.md b/services/mobilepush/nl/fr/t_enable_ios_notifications_register.md index da6ffaa08..b1c7085db 100644 --- a/services/mobilepush/nl/fr/t_enable_ios_notifications_register.md +++ b/services/mobilepush/nl/fr/t_enable_ios_notifications_register.md @@ -1,94 +1,94 @@ -# Enregistrements d'applications et d'appareils iOS -{: #enable-push-ios-notifications-register} - - -Une application doit être enregistrée auprès d'APNS pour pouvoir recevoir des notifications distantes. Cet -enregistrement s'effectue généralement après l'installation de l'application sur un appareil. Une fois que le jeton d'appareil généré par APNS a -été reçu par l'application, il doit être transmis au service Push Notifications. - -Pour enregistrer les applications et les appareils iOs : - -1. Créez une application de back end -2. Transmettez le jeton au service de notifications push - - -##Créez une application de back end - -Créez une application de back end dans la section Conteneurs boilerplate du catalogue Bluemix, qui lie automatiquement le service Push à cette application. Si vous avez déjà créé une application de -back end, veillez à lier l'application au service de notifications push. - -###Objective-C - -``` - //Pour Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##Transmettez le jeton au service de notifications push - -Une fois reçu le jeton envoyé par le service APNS, transmettez-le au service de notifications push par le biais de la méthode `registerDevice:withDeviceToken`. - -###Objective-C - -``` -//Pour Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -Une fois reçu le jeton envoyé par le service APNS, transmettez-le au service de notifications push par le biais de la méthode `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` +# Enregistrements d'applications et d'appareils iOS +{: #enable-push-ios-notifications-register} + + +Une application doit être enregistrée auprès d'APNS pour pouvoir recevoir des notifications distantes. Cet +enregistrement s'effectue généralement après l'installation de l'application sur un appareil. Une fois que le jeton d'appareil généré par APNS a +été reçu par l'application, il doit être transmis au service Push Notifications. + +Pour enregistrer les applications et les appareils iOs : + +1. Créez une application de back end +2. Transmettez le jeton au service de notifications push + + +## Créez une application de back end + +Créez une application de back end dans la section Conteneurs boilerplate du catalogue Bluemix, qui lie automatiquement le service Push à cette application. Si vous avez déjà créé une application de +back end, veillez à lier l'application au service de notifications push. + +### Objective-C + +``` + //Pour Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +### Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +## Transmettez le jeton au service de notifications push + +Une fois reçu le jeton envoyé par le service APNS, transmettez-le au service de notifications push par le biais de la méthode `registerDevice:withDeviceToken`. + +### Objective-C + +``` +//Pour Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +### Swift + +Une fois reçu le jeton envoyé par le service APNS, transmettez-le au service de notifications push par le biais de la méthode `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` diff --git a/services/mobilepush/nl/fr/t_get_tags.md b/services/mobilepush/nl/fr/t_get_tags.md index be98ec9de..4f720fc64 100644 --- a/services/mobilepush/nl/fr/t_get_tags.md +++ b/services/mobilepush/nl/fr/t_get_tags.md @@ -1,155 +1,155 @@ -# Obtention des balises -{: #get_tags} - -Les balises permettent d'envoyer des notifications ciblées aux utilisateurs en fonction de leurs intérêts, à la différence des diffusions -générales qui sont envoyées à toutes les applications. Vous pouvez créer et gérer des balises à l'aide de l'onglet Balise du tableau de bord Push ou utiliser l'API REST. Vous pouvez utiliser des fragments de code dans les sections suivantes pour gérer et interroger vos abonnements aux balises pour votre application mobile. Ils permettent d'obtenir des abonnements, de s'abonner à une balise, de se désabonner d'une balise et d'obtenir la liste des balises disponibles. Vous copiez et collez ces fragments de code dans votre application mobile. - -## Android - -L'API **getTags** renvoie la liste des balises disponibles auxquelles l'appareil peut s'abonner. Lorsqu'un -appareil est abonné à une balise en particulier, il peut recevoir toutes les notifications push envoyées pour cette balise. - -Copiez les fragments de code ci-après dans votre application mobile Android afin d'obtenir la liste des balises auxquelles l'appareil est -abonné ainsi que la liste des balises disponibles. - -Utilisez l'API **getTags** pour obtenir la liste des balises disponibles auxquelles l'appareil peut s'abonner. - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - -Utilisez l'API **getSubscriptions** pour obtenir la liste des balises auxquelles l'appareil est abonné. - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) -``` - -## Cordova - -Copiez les fragments de code ci-après dans votre application mobile afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles auxquelles l'appareil peut s'abonner. - -Renvoyez un tableau des balises auxquelles l'appareil peut s'abonner. - -``` -//Get a list of available tags to which the device can subscribe -MFPPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, null); - -``` - -``` -//Get a list of available tags to which the device is subscribed. -MFPPush.getSubscriptionStatus(function(tags) { - alert(tags); -}, null); -``` - -## Objective-C - -Copiez les fragments de code ci-après dans votre application iOS développée à l'aide de la méthode Objective-C afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles auxquelles l'appareil peut s'abonner. - -Utilisez l'API **retrieveAvailableTags** ci-après pour obtenir la liste des balises disponibles auxquelles l'appareil peut s'abonner. - -``` -//Get a list of available tags to which the device can subscribe -[push retrieveAvailableTagsWithCompletionHandler: -^(IMFResponse *response, NSError *error){ - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved available tags."]; - NSDictionary *availableTags = [[NSDictionary alloc]init]; - availableTags = [response tags]; -[self.appDelegateVC updateMessage:availableTags.description]; -} -}]; -``` - -Utilisez l'API **retrieveSubscriptions** pour obtenir la liste des balises auxquelles l'appareil est abonné. - - -``` -// Get a list of tags that to which the device is subscribed. -[push retrieveSubscriptionsWithCompletionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved subscriptions."]; - NSDictionary *subscribedTags = [[NSDictionary alloc]init]; -subscribedTags = [response subscriptions]; -[self.appDelegateVC updateMessage:subscribedTags.description]; -} -}]; -``` - -## Swift - -L'API **retrieveAvailableTagsWithCompletionHandler** renvoie la liste des balises disponibles auxquelles l'appareil peut s'abonner. Lorsqu'un -appareil est abonné à une balise en particulier, il peut recevoir toutes les notifications push envoyées pour cette balise. - -Appelez le service Push pour obtenir les abonnements à une balise. - -Copiez les fragments de code ci-après dans votre application mobile Swift afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles auxquelles l'appareil peut s'abonner. - - -``` -//Get a list of available tags to which the device can subscribe -push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - - if error.isEmpty { - - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else{ - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - - print( "Response during retrieving subscribed tags : \(response.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - - - +# Obtention des balises +{: #get_tags} + +Les balises permettent d'envoyer des notifications ciblées aux utilisateurs en fonction de leurs intérêts, à la différence des diffusions +générales qui sont envoyées à toutes les applications. Vous pouvez créer et gérer des balises à l'aide de l'onglet Balise du tableau de bord Push ou utiliser l'API REST. Vous pouvez utiliser des fragments de code dans les sections suivantes pour gérer et interroger vos abonnements aux balises pour votre application mobile. Ils permettent d'obtenir des abonnements, de s'abonner à une balise, de se désabonner d'une balise et d'obtenir la liste des balises disponibles. Vous copiez et collez ces fragments de code dans votre application mobile. + +## Android + +L'API **getTags** renvoie la liste des balises disponibles auxquelles l'appareil peut s'abonner. Lorsqu'un +appareil est abonné à une balise en particulier, il peut recevoir toutes les notifications push envoyées pour cette balise. + +Copiez les fragments de code ci-après dans votre application mobile Android afin d'obtenir la liste des balises auxquelles l'appareil est +abonné ainsi que la liste des balises disponibles. + +Utilisez l'API **getTags** pour obtenir la liste des balises disponibles auxquelles l'appareil peut s'abonner. + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + +Utilisez l'API **getSubscriptions** pour obtenir la liste des balises auxquelles l'appareil est abonné. + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) +``` + +## Cordova + +Copiez les fragments de code ci-après dans votre application mobile afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles auxquelles l'appareil peut s'abonner. + +Renvoyez un tableau des balises auxquelles l'appareil peut s'abonner. + +``` +//Get a list of available tags to which the device can subscribe +MFPPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, null); + +``` + +``` +//Get a list of available tags to which the device is subscribed. +MFPPush.getSubscriptionStatus(function(tags) { + alert(tags); +}, null); +``` + +## Objective-C + +Copiez les fragments de code ci-après dans votre application iOS développée à l'aide de la méthode Objective-C afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles auxquelles l'appareil peut s'abonner. + +Utilisez l'API **retrieveAvailableTags** ci-après pour obtenir la liste des balises disponibles auxquelles l'appareil peut s'abonner. + +``` +//Get a list of available tags to which the device can subscribe +[push retrieveAvailableTagsWithCompletionHandler: +^(IMFResponse *response, NSError *error){ + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved available tags."]; + NSDictionary *availableTags = [[NSDictionary alloc]init]; + availableTags = [response tags]; +[self.appDelegateVC updateMessage:availableTags.description]; +} +}]; +``` + +Utilisez l'API **retrieveSubscriptions** pour obtenir la liste des balises auxquelles l'appareil est abonné. + + +``` +// Get a list of tags that to which the device is subscribed. +[push retrieveSubscriptionsWithCompletionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved subscriptions."]; + NSDictionary *subscribedTags = [[NSDictionary alloc]init]; +subscribedTags = [response subscriptions]; +[self.appDelegateVC updateMessage:subscribedTags.description]; +} +}]; +``` + +## Swift + +L'API **retrieveAvailableTagsWithCompletionHandler** renvoie la liste des balises disponibles auxquelles l'appareil peut s'abonner. Lorsqu'un +appareil est abonné à une balise en particulier, il peut recevoir toutes les notifications push envoyées pour cette balise. + +Appelez le service Push pour obtenir les abonnements à une balise. + +Copiez les fragments de code ci-après dans votre application mobile Swift afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles auxquelles l'appareil peut s'abonner. + + +``` +//Get a list of available tags to which the device can subscribe +push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + + if error.isEmpty { + + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else{ + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + + print( "Response during retrieving subscribed tags : \(response.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + + + diff --git a/services/mobilepush/nl/fr/t_handle_actionable_notifications_ios.md b/services/mobilepush/nl/fr/t_handle_actionable_notifications_ios.md index 47bfabd2b..0631c010d 100644 --- a/services/mobilepush/nl/fr/t_handle_actionable_notifications_ios.md +++ b/services/mobilepush/nl/fr/t_handle_actionable_notifications_ios.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Traitement des notifications interactives pour iOS -{: #actionable-notifications} - - -Lors de la réception d'une notification interactive, le contrôle est -transmis à la méthode suivante en fonction de l'identificateur choisi. - -###Objective-C - -``` -(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: -(UILocalNotification *)notification completionHandler:(void (^)())completionHandler -{ - NSLog(@"actionable notification received."); - //must call completion handler when finished - completionHandler(); -} -``` - -###Swift - -``` -func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { - //must call completion handler when finished - completionHandler() - } -``` - - +--- + +copyright: + years: 2015, 2016 + +--- + +# Traitement des notifications interactives pour iOS +{: #actionable-notifications} + + +Lors de la réception d'une notification interactive, le contrôle est +transmis à la méthode suivante en fonction de l'identificateur choisi. + +###Objective-C + +``` +(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: +(UILocalNotification *)notification completionHandler:(void (^)())completionHandler +{ + NSLog(@"actionable notification received."); + //must call completion handler when finished + completionHandler(); +} +``` + +###Swift + +``` +func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { + //must call completion handler when finished + completionHandler() + } +``` + + diff --git a/services/mobilepush/nl/fr/t_holding_notifications_android.md b/services/mobilepush/nl/fr/t_holding_notifications_android.md index 752aaba65..66eaeb0e5 100644 --- a/services/mobilepush/nl/fr/t_holding_notifications_android.md +++ b/services/mobilepush/nl/fr/t_holding_notifications_android.md @@ -1,30 +1,30 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Conservation des notifications pour Android -{: #hold-notifications-android} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - -Quand votre application passe en arrière-plan, vous pouvez vouloir que le service {{site.data.keyword.mobilepushshort}} conserve les notifications qui sont envoyées à cette application. Pour conserver des notifications, appelez la méthode hold() dans la méthode onPause() de l'activité qui traite les -notifications de type {{site.data.keyword.mobilepushshort}}. - -``` - @Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Conservation des notifications pour Android +{: #hold-notifications-android} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + +Quand votre application passe en arrière-plan, vous pouvez vouloir que le service {{site.data.keyword.mobilepushshort}} conserve les notifications qui sont envoyées à cette application. Pour conserver des notifications, appelez la méthode hold() dans la méthode onPause() de l'activité qui traite les +notifications de type {{site.data.keyword.mobilepushshort}}. + +``` + @Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/fr/t_manage_tags.md b/services/mobilepush/nl/fr/t_manage_tags.md index bc210d778..8fe96f121 100644 --- a/services/mobilepush/nl/fr/t_manage_tags.md +++ b/services/mobilepush/nl/fr/t_manage_tags.md @@ -1,352 +1,352 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Gestion des balises -{: #manage_tags} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - -Utilisez le tableau de bord {{site.data.keyword.mobilepushshort}} afin de créer et de supprimer des balises pour votre application puis d'initier des notifications basées sur des balises. Ces notifications basées sur des balises sont reçues sur les appareils abonnés à ces balises. - - -## Création de balises -{: #create_tags} - -Les notifications basées sur les balises sont des messages qui sont ciblés vers tous les appareils abonnés à une balise -particulière. Chaque appareil peut s'abonner à un nombre illimité de balises. Quand une balise est supprimée, les informations qui lui sont associées, y compris ses abonnés et appareils, sont supprimées. Un désabonnement automatique n'est pas nécessaire car cette balise n'existe plus. Aucune autre action supplémentaire n'est nécessaire côté client. - -1. Dans le tableau de bord {{site.data.keyword.mobilepushshort}}, sélectionnez l'onglet relatif aux balises. -1. Cliquez sur le bouton + **Créer une balise**. - 1. Dans la zone **Nom**, entrez le nom de la balise. Exemple : "coupons". - 1. Dans la zone **Description**, entrez la description de la balise. - 1. Cliquez sur **Sauvegarder**. - -1. Dans la zone **Fragments de code**, sélectionnez la plateforme pour votre application mobile. -1. Modifiez les fragments de code pour traiter les erreurs, puis copiez-les pour chaque balise dans votre application mobile. - -## Suppression de balises -{: #delete_tags} - -1. Dans l'onglet **Balise**, sélectionnez la balise que vous voulez supprimer puis cliquez sur l'icône **Supprimer**. -1. Cliquez sur **OK**. - -## Edition d'une description de balise -{: #edit_tags} - -1. Dans l'onglet **Balise**, sélectionnez la balise à éditer. -1. Cliquez sur l'icône **Editer**. -1. Editez la description de la balise, puis cliquez sur le bouton **Sauvegarder**. - -# Obtention des balises -{: #get_tags} - -Les balises permettent d'envoyer des notifications ciblées aux utilisateurs en fonction de leurs intérêts, à la différence des diffusions -générales qui sont envoyées à toutes les applications. Vous pouvez créer et gérer des balises à l'aide de l'onglet Balise du tableau de bord {{site.data.keyword.mobilepushshort}} ou utiliser l'API REST. Vous pouvez utiliser des fragments de code pour gérer et interroger vos abonnements aux balises pour votre application mobile. Ils permettent d'obtenir des abonnements, de s'abonner à une balise, de se désabonner d'une balise ou d'obtenir la liste des balises disponibles. Copiez ces fragments de code dans votre application mobile. - -## Obtention des balises sur Android -{: android-get-tags} - -L'API **getTags** renvoie la liste des balises disponibles auxquelles l'appareil peut s'abonner. Une fois qu'un -appareil est abonné à une balise en particulier, il peut recevoir toutes les notifications de type {{site.data.keyword.mobilepushshort}} envoyées pour cette balise. - -Copiez les fragments de code ci-après dans votre application mobile Android afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles. - -Utilisez l'API **getTags** pour obtenir la liste des balises disponibles auxquelles l'appareil peut s'abonner. - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } - }) -``` - {: codeblock} - -Utilisez l'API **getSubscriptions** pour obtenir la liste des balises auxquelles l'appareil est abonné. - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) - ``` - {: codeblock} - -## Obtention des balises sur Cordova -{: cordova-get-tags} - -Copiez les fragments de code ci-après dans votre application mobile afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles. - -Extrayez un tableau de balises disponibles pour abonnement. - -``` -//Extraction d'une liste de balises disponibles auxquelles le appareil peut s'abonner -BMSPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - -``` -//Extraction d'une liste de balises disponibles auxquelles l'appareil est abonné. -BMSPush.retrieveSubscriptions(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - - -## Obtention de balises sur Swift -{: swift-get-tags} - -L'API **retrieveAvailableTagsWithCompletionHandler** renvoie la liste des balises disponibles auxquelles l'appareil peut s'abonner. Une fois qu'un -appareil est abonné à une balise en particulier, il peut recevoir toutes les notifications de type {{site.data.keyword.mobilepushshort}} envoyées pour cette balise. - -Appelez le service {{site.data.keyword.mobilepushshort}} pour obtenir les abonnements à une balise. - -Copiez les fragments de code ci-après dans votre application mobile Swift afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles auxquelles l'appareil peut s'abonner. -``` -//Get a list of available tags to which the device can subscribe - push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - if error.isEmpty - { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else - { - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during retrieving subscribed tags : \(response?.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else - { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -## Google Chrome, Safari et Mozilla Firefox -{: web-get-tags} - -Pour obtenir la liste des balises auxquelles les utilisateurs peuvent s'abonner, utilisez le code suivant. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - - -## Applications et extensions Google Chrome -{: web-get-tags} - -Pour obtenir la liste des balises auxquelles les utilisateurs peuvent s'abonner, utilisez le code suivant. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - -Copiez les fragments de code ci-après dans vos applications et extensions Google Chrome pour obtenir une liste des balises auxquelles les utilisateurs se sont -abonnés. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveSubscriptions(function(response) - { - alert(response.response) - }) -``` - {: codeblock} - - -# Abonnement et désabonnement à des balises -{: #Subscribe_tags} - -Utilisez les fragments de code ci-après pour permettre à vos appareils de s'abonner à une balise et de s'en désabonner. - -## Abonnement et désabonnement à des balises sur Android -{: android-subscribe-tags} - -Copiez et collez le fragment de code suivant dans votre application mobile Android. - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } - }); -``` - {: codeblock} - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } - }); -``` - {: codeblock} - -## Abonnement et désabonnement à des balises sur Cordova -{: cordova-subscribe-tags} - -Copiez et collez le fragment de code suivant dans votre application mobile Cordova. - -``` -var tag = "YourTag"; -BMSPush.subscribe(tag, success, failure); -BMSPush.unsubscribe(tag, success, failure); -``` - {: codeblock} - - -## Abonnement et désabonnement à des balises sur Swift -{: swift-subscribe-tags} - -Copiez et collez le fragment de code suivant dans votre application mobile Swift. - -Utilisez l'API **subscribeToTags** pour vous abonner à une balise. - -``` -push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print("Response when subscribing to tags: \(response?.description)") - print("Status code when subscribing to tags: \(statusCode)") - } else { - print("Error when subscribing to tags: \(error) ") - print("Error status code when subscribing to tags: \(statusCode)") - } -}) -``` - {: codeblock} - -Utilisez l'API **unsubscribeFromTags** pour vous désabonner d'une balise. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during unsubscribed tags : \(response?.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - {: codeblock} - -## Google Chrome et Mozilla Firefox -{: web-subscribe-tags} - -Pour vous abonner à des balises depuis des applications Web, utilisez le fragment de code suivant : - -``` -var tagsArray = ["tag1", "Tag2"] -bmsPush.subscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -Le désabonnement à des balises utilise la méthode **unSubscribe**. - -``` -var tagsArray = ["tag1", "Tag2"] - bmsPush.unSubscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -# Utilisation de notifications basées sur les balises -{: #using_tags} - -Les messages de notifications basées sur les balises sont envoyés à tous les appareils abonnés à une balise particulière. Chaque appareil peut s'abonner à un nombre illimité de balises. Cette rubrique explique comment envoyer des notifications basées sur des balises. Les abonnements sont gérés par l'instance de service Bluemix {{site.data.keyword.mobilepushshort}}. Quand une balise est supprimée, toutes les informations qui lui sont associées, y compris ses abonnés et appareils, sont supprimées. Aucun désabonnement automatique n'est requis pour cette balise car elle n'existe plus et aucune action supplémentaire n'est requise depuis le côté client. - -Créez des balises sur l'écran **Tag**. Pour plus d'informations sur la création de balises, -voir [Création de balises](t_manage_tags.html). - -1. Dans le tableau de bord des notifications push, cliquez sur **Envoyer des notifications**. -1. Sélectionnez l'option **Appareil par étiquette** dans la liste déroulante **Envoyer à**. -1. Recherchez les balises que vous voulez utiliser et sélectionnez-les. -![Ecran Notifications](images/tag_notification.jpg) -1. Dans la zone **Texte du message**, entrez le texte qui sera envoyé en tant que notification aux destinataires abonnés. -1. Cliquez sur **Envoyer**. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Gestion des balises +{: #manage_tags} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + +Utilisez le tableau de bord {{site.data.keyword.mobilepushshort}} afin de créer et de supprimer des balises pour votre application puis d'initier des notifications basées sur des balises. Ces notifications basées sur des balises sont reçues sur les appareils abonnés à ces balises. + + +## Création de balises +{: #create_tags} + +Les notifications basées sur les balises sont des messages qui sont ciblés vers tous les appareils abonnés à une balise +particulière. Chaque appareil peut s'abonner à un nombre illimité de balises. Quand une balise est supprimée, les informations qui lui sont associées, y compris ses abonnés et appareils, sont supprimées. Un désabonnement automatique n'est pas nécessaire car cette balise n'existe plus. Aucune autre action supplémentaire n'est nécessaire côté client. + +1. Dans le tableau de bord {{site.data.keyword.mobilepushshort}}, sélectionnez l'onglet relatif aux balises. +1. Cliquez sur le bouton + **Créer une balise**. + 1. Dans la zone **Nom**, entrez le nom de la balise. Exemple : "coupons". + 1. Dans la zone **Description**, entrez la description de la balise. + 1. Cliquez sur **Sauvegarder**. + +1. Dans la zone **Fragments de code**, sélectionnez la plateforme pour votre application mobile. +1. Modifiez les fragments de code pour traiter les erreurs, puis copiez-les pour chaque balise dans votre application mobile. + +## Suppression de balises +{: #delete_tags} + +1. Dans l'onglet **Balise**, sélectionnez la balise que vous voulez supprimer puis cliquez sur l'icône **Supprimer**. +1. Cliquez sur **OK**. + +## Edition d'une description de balise +{: #edit_tags} + +1. Dans l'onglet **Balise**, sélectionnez la balise à éditer. +1. Cliquez sur l'icône **Editer**. +1. Editez la description de la balise, puis cliquez sur le bouton **Sauvegarder**. + +# Obtention des balises +{: #get_tags} + +Les balises permettent d'envoyer des notifications ciblées aux utilisateurs en fonction de leurs intérêts, à la différence des diffusions +générales qui sont envoyées à toutes les applications. Vous pouvez créer et gérer des balises à l'aide de l'onglet Balise du tableau de bord {{site.data.keyword.mobilepushshort}} ou utiliser l'API REST. Vous pouvez utiliser des fragments de code pour gérer et interroger vos abonnements aux balises pour votre application mobile. Ils permettent d'obtenir des abonnements, de s'abonner à une balise, de se désabonner d'une balise ou d'obtenir la liste des balises disponibles. Copiez ces fragments de code dans votre application mobile. + +## Obtention des balises sur Android +{: android-get-tags} + +L'API **getTags** renvoie la liste des balises disponibles auxquelles l'appareil peut s'abonner. Une fois qu'un +appareil est abonné à une balise en particulier, il peut recevoir toutes les notifications de type {{site.data.keyword.mobilepushshort}} envoyées pour cette balise. + +Copiez les fragments de code ci-après dans votre application mobile Android afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles. + +Utilisez l'API **getTags** pour obtenir la liste des balises disponibles auxquelles l'appareil peut s'abonner. + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } + }) +``` + {: codeblock} + +Utilisez l'API **getSubscriptions** pour obtenir la liste des balises auxquelles l'appareil est abonné. + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) + ``` + {: codeblock} + +## Obtention des balises sur Cordova +{: cordova-get-tags} + +Copiez les fragments de code ci-après dans votre application mobile afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles. + +Extrayez un tableau de balises disponibles pour abonnement. + +``` +//Extraction d'une liste de balises disponibles auxquelles le appareil peut s'abonner +BMSPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + +``` +//Extraction d'une liste de balises disponibles auxquelles l'appareil est abonné. +BMSPush.retrieveSubscriptions(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + + +## Obtention de balises sur Swift +{: swift-get-tags} + +L'API **retrieveAvailableTagsWithCompletionHandler** renvoie la liste des balises disponibles auxquelles l'appareil peut s'abonner. Une fois qu'un +appareil est abonné à une balise en particulier, il peut recevoir toutes les notifications de type {{site.data.keyword.mobilepushshort}} envoyées pour cette balise. + +Appelez le service {{site.data.keyword.mobilepushshort}} pour obtenir les abonnements à une balise. + +Copiez les fragments de code ci-après dans votre application mobile Swift afin d'obtenir la liste des balises auxquelles l'appareil est abonné ainsi que la liste des balises disponibles auxquelles l'appareil peut s'abonner. +``` +//Get a list of available tags to which the device can subscribe + push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + if error.isEmpty + { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else + { + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during retrieving subscribed tags : \(response?.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else + { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +## Google Chrome, Safari et Mozilla Firefox +{: web-get-tags} + +Pour obtenir la liste des balises auxquelles les utilisateurs peuvent s'abonner, utilisez le code suivant. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + + +## Applications et extensions Google Chrome +{: web-get-tags} + +Pour obtenir la liste des balises auxquelles les utilisateurs peuvent s'abonner, utilisez le code suivant. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + +Copiez les fragments de code ci-après dans vos applications et extensions Google Chrome pour obtenir une liste des balises auxquelles les utilisateurs se sont +abonnés. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveSubscriptions(function(response) + { + alert(response.response) + }) +``` + {: codeblock} + + +# Abonnement et désabonnement à des balises +{: #Subscribe_tags} + +Utilisez les fragments de code ci-après pour permettre à vos appareils de s'abonner à une balise et de s'en désabonner. + +## Abonnement et désabonnement à des balises sur Android +{: android-subscribe-tags} + +Copiez et collez le fragment de code suivant dans votre application mobile Android. + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } + }); +``` + {: codeblock} + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } + }); +``` + {: codeblock} + +## Abonnement et désabonnement à des balises sur Cordova +{: cordova-subscribe-tags} + +Copiez et collez le fragment de code suivant dans votre application mobile Cordova. + +``` +var tag = "YourTag"; +BMSPush.subscribe(tag, success, failure); +BMSPush.unsubscribe(tag, success, failure); +``` + {: codeblock} + + +## Abonnement et désabonnement à des balises sur Swift +{: swift-subscribe-tags} + +Copiez et collez le fragment de code suivant dans votre application mobile Swift. + +Utilisez l'API **subscribeToTags** pour vous abonner à une balise. + +``` +push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print("Response when subscribing to tags: \(response?.description)") + print("Status code when subscribing to tags: \(statusCode)") + } else { + print("Error when subscribing to tags: \(error) ") + print("Error status code when subscribing to tags: \(statusCode)") + } +}) +``` + {: codeblock} + +Utilisez l'API **unsubscribeFromTags** pour vous désabonner d'une balise. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during unsubscribed tags : \(response?.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + {: codeblock} + +## Google Chrome et Mozilla Firefox +{: web-subscribe-tags} + +Pour vous abonner à des balises depuis des applications Web, utilisez le fragment de code suivant : + +``` +var tagsArray = ["tag1", "Tag2"] +bmsPush.subscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +Le désabonnement à des balises utilise la méthode **unSubscribe**. + +``` +var tagsArray = ["tag1", "Tag2"] + bmsPush.unSubscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +# Utilisation de notifications basées sur les balises +{: #using_tags} + +Les messages de notifications basées sur les balises sont envoyés à tous les appareils abonnés à une balise particulière. Chaque appareil peut s'abonner à un nombre illimité de balises. Cette rubrique explique comment envoyer des notifications basées sur des balises. Les abonnements sont gérés par l'instance de service Bluemix {{site.data.keyword.mobilepushshort}}. Quand une balise est supprimée, toutes les informations qui lui sont associées, y compris ses abonnés et appareils, sont supprimées. Aucun désabonnement automatique n'est requis pour cette balise car elle n'existe plus et aucune action supplémentaire n'est requise depuis le côté client. + +Créez des balises sur l'écran **Tag**. Pour plus d'informations sur la création de balises, +voir [Création de balises](t_manage_tags.html). + +1. Dans le tableau de bord des notifications push, cliquez sur **Envoyer des notifications**. +1. Sélectionnez l'option **Appareil par étiquette** dans la liste déroulante **Envoyer à**. +1. Recherchez les balises que vous voulez utiliser et sélectionnez-les. +![Ecran Notifications](images/tag_notification.jpg) +1. Dans la zone **Texte du message**, entrez le texte qui sera envoyé en tant que notification aux destinataires abonnés. +1. Cliquez sur **Envoyer**. diff --git a/services/mobilepush/nl/fr/t_manage_user.md b/services/mobilepush/nl/fr/t_manage_user.md index 339fbb70b..cc9d389e6 100644 --- a/services/mobilepush/nl/fr/t_manage_user.md +++ b/services/mobilepush/nl/fr/t_manage_user.md @@ -1,166 +1,166 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Enregistrement d'un appareil avec un ID utilisateur -{: #register_device_with_userId} -Dernière mise à jour : 6 février 2017 -{: .last-updated} - -Pour procéder à un enregistrement pour une notification à base d'ID utilisateur, procédez comme suit : - -## Android -{: android-register} - -Initialisez la classe MFPPush avec l'identificateur `AppGUID` et la clé `clientSecret` du service {{site.data.keyword.mobilepushshort}}. -``` -// Initialisation du service de notifications Push -push = MFPPush.getInstance(); -push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); -``` - {: codeblock} - - -- **AppGUID** : clé AppGUID du service {{site.data.keyword.mobilepushshort}}. -- **clientSecret** : clé clientSecret du service {{site.data.keyword.mobilepushshort}}. - - Utilisez l'API **registerDeviceWithUserId** pour enregistrer l'appareil pour {{site.data.keyword.mobilepushshort}}. - -``` -// Enregistrement de l'appareil auprès du service de notifications Push -push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - Log.d("Device is registered with Push Service.");} - @Override - public void onFailure(MFPPushException ex) { - Log.d("Error registering with Push Service...\n" - + "Push notifications will not be received."); - } - }); -``` - {: codeblock} - -- **userId** : passe la valeur userId unique pour l'enregistrement de {{site.data.keyword.mobilepushshort}}. - -**Remarque : ** pour activer les notifications de type {{site.data.keyword.mobilepushshort}} ciblées par ID utilisateur, prenez soin d'enregistrer l'appareil avec un ID utilisateur et passez aussi la valeur confidentielle clientSecret qui est allouée quand les services {{site.data.keyword.mobilepushshort}} sont provisionnés. L'enregistrement de l'appareil échouera en l'absence d'une valeur clientSecret valide. - -## Cordova -{: cordova} - -Utilisez les API suivantes pour l'enregistrement des notifications de type {{site.data.keyword.mobilepushshort}} à base d'ID utilisateur. - -``` -// Enregistrement de l'appareil pour notification push avec l'ID utilisateur -var options = {"userId": "Your User Id value"}; -BMSPush.registerDevice(options,success, failure); -``` - {: codeblock} - - -- **userId** : passe la valeur userId unique pour l'enregistrement de {{site.data.keyword.mobilepushshort}}. - - -## Swift -{: swift-register} - -``` -// Initialize the BMSPushClient -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -- **AppGUID** : clé AppGUID du service {{site.data.keyword.mobilepushshort}}. -- **clientSecret** : clé clientSecret du service {{site.data.keyword.mobilepushshort}}. - -Utilisez l'API **registerWithUserId** pour enregistrer l'appareil pour {{site.data.keyword.mobilepushshort}}. - -``` -// Enregistrement de l'appareil auprès du service de notifications Push -push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in -if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } else { - print( "Error during device registration \(error) ") - } - } -``` - {: codeblock} - -- **userId** : passe la valeur userId unique pour l'enregistrement de {{site.data.keyword.mobilepushshort}}. - -## Google Chrome, Safari et Mozilla Firefox -{: web-register} - -Utilisez les API suivantes pour l'enregistrement des notifications basées sur des balises. Initialisez le logiciel SDK avec les services `appGUID`, `appRegion` et `clientSecret`. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -Une fois l'initialisation terminée, enregistrez l'application Web avec l'ID utilisateur. - -``` -bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -## Applications et extensions Google Chrome -{: web-register-new} - -Utilisez les API suivantes pour l'enregistrement des notifications basées sur des balises. Initialisez le logiciel SDK avec les services `appGUID`, `appRegion` et `clientSecret`. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -Après la réussite de l'initialisation, vous devez enregistrer l'application Web avec l'userId. - -``` -bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -# Utilisation des notifications basées sur un ID utilisateur -{: #using_userid} - -Les notifications basées sur un ID utilisateur sont des messages de notification qui sont ciblés vers un utilisateur spécifique. Plusieurs appareils différents peuvent être enregistrés avec un seul et même utilisateur. La procédure suivante décrit comment envoyer des notifications à base d'ID utilisateur. - -1. Dans le tableau de bord **Notifications push**, sélectionnez l'option **Envoyer des notifications**. -1. Sélectionnez **ID utilisateur** dans la liste des options **Envoyer à**. -1. Dans la zone **ID utilisateur**, recherchez l'ID utilisateur dont vous voulez vous servir puis cliquez sur **+Ajouter**.![Ecran d'envoi des notifications](images/user_notification.jpg) -1. Dans la zone **Message**, entrez le texte que vous voulez envoyer dans votre notification. -1. Cliquez sur **Envoyer**. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Enregistrement d'un appareil avec un ID utilisateur +{: #register_device_with_userId} +Dernière mise à jour : 6 février 2017 +{: .last-updated} + +Pour procéder à un enregistrement pour une notification à base d'ID utilisateur, procédez comme suit : + +## Android +{: android-register} + +Initialisez la classe MFPPush avec l'identificateur `AppGUID` et la clé `clientSecret` du service {{site.data.keyword.mobilepushshort}}. +``` +// Initialisation du service de notifications Push +push = MFPPush.getInstance(); +push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); +``` + {: codeblock} + + +- **AppGUID** : clé AppGUID du service {{site.data.keyword.mobilepushshort}}. +- **clientSecret** : clé clientSecret du service {{site.data.keyword.mobilepushshort}}. + + Utilisez l'API **registerDeviceWithUserId** pour enregistrer l'appareil pour {{site.data.keyword.mobilepushshort}}. + +``` +// Enregistrement de l'appareil auprès du service de notifications Push +push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + Log.d("Device is registered with Push Service.");} + @Override + public void onFailure(MFPPushException ex) { + Log.d("Error registering with Push Service...\n" + + "Push notifications will not be received."); + } + }); +``` + {: codeblock} + +- **userId** : passe la valeur userId unique pour l'enregistrement de {{site.data.keyword.mobilepushshort}}. + +**Remarque : ** pour activer les notifications de type {{site.data.keyword.mobilepushshort}} ciblées par ID utilisateur, prenez soin d'enregistrer l'appareil avec un ID utilisateur et passez aussi la valeur confidentielle clientSecret qui est allouée quand les services {{site.data.keyword.mobilepushshort}} sont provisionnés. L'enregistrement de l'appareil échouera en l'absence d'une valeur clientSecret valide. + +## Cordova +{: cordova} + +Utilisez les API suivantes pour l'enregistrement des notifications de type {{site.data.keyword.mobilepushshort}} à base d'ID utilisateur. + +``` +// Enregistrement de l'appareil pour notification push avec l'ID utilisateur +var options = {"userId": "Your User Id value"}; +BMSPush.registerDevice(options,success, failure); +``` + {: codeblock} + + +- **userId** : passe la valeur userId unique pour l'enregistrement de {{site.data.keyword.mobilepushshort}}. + + +## Swift +{: swift-register} + +``` +// Initialize the BMSPushClient +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +- **AppGUID** : clé AppGUID du service {{site.data.keyword.mobilepushshort}}. +- **clientSecret** : clé clientSecret du service {{site.data.keyword.mobilepushshort}}. + +Utilisez l'API **registerWithUserId** pour enregistrer l'appareil pour {{site.data.keyword.mobilepushshort}}. + +``` +// Enregistrement de l'appareil auprès du service de notifications Push +push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in +if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } else { + print( "Error during device registration \(error) ") + } + } +``` + {: codeblock} + +- **userId** : passe la valeur userId unique pour l'enregistrement de {{site.data.keyword.mobilepushshort}}. + +## Google Chrome, Safari et Mozilla Firefox +{: web-register} + +Utilisez les API suivantes pour l'enregistrement des notifications basées sur des balises. Initialisez le logiciel SDK avec les services `appGUID`, `appRegion` et `clientSecret`. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +Une fois l'initialisation terminée, enregistrez l'application Web avec l'ID utilisateur. + +``` +bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +## Applications et extensions Google Chrome +{: web-register-new} + +Utilisez les API suivantes pour l'enregistrement des notifications basées sur des balises. Initialisez le logiciel SDK avec les services `appGUID`, `appRegion` et `clientSecret`. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +Après la réussite de l'initialisation, vous devez enregistrer l'application Web avec l'userId. + +``` +bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +# Utilisation des notifications basées sur un ID utilisateur +{: #using_userid} + +Les notifications basées sur un ID utilisateur sont des messages de notification qui sont ciblés vers un utilisateur spécifique. Plusieurs appareils différents peuvent être enregistrés avec un seul et même utilisateur. La procédure suivante décrit comment envoyer des notifications à base d'ID utilisateur. + +1. Dans le tableau de bord **Notifications push**, sélectionnez l'option **Envoyer des notifications**. +1. Sélectionnez **ID utilisateur** dans la liste des options **Envoyer à**. +1. Dans la zone **ID utilisateur**, recherchez l'ID utilisateur dont vous voulez vous servir puis cliquez sur **+Ajouter**.![Ecran d'envoi des notifications](images/user_notification.jpg) +1. Dans la zone **Message**, entrez le texte que vous voulez envoyer dans votre notification. +1. Cliquez sur **Envoyer**. diff --git a/services/mobilepush/nl/fr/t_push_ios_nextsteps.md b/services/mobilepush/nl/fr/t_push_ios_nextsteps.md index 5248cf923..6b2dcefa2 100644 --- a/services/mobilepush/nl/fr/t_push_ios_nextsteps.md +++ b/services/mobilepush/nl/fr/t_push_ios_nextsteps.md @@ -1,22 +1,22 @@ - ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# Etapes suivantes - -{: #push-ios-nextsteps} - -Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options -avancées. - -Ajoutez ces fonctions du service de notifications push à votre application. - - - -- Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](t_push_tagsmain.md). -- Pour utiliser des options de notification avancées, voir [Notifications push avancées](t_advance_notifications.md). + +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# Etapes suivantes + +{: #push-ios-nextsteps} + +Une fois que vous avez configuré les notifications de base, vous pouvez configurer des notifications basées sur des balises et des options +avancées. + +Ajoutez ces fonctions du service de notifications push à votre application. + + + +- Pour utiliser des notifications basées sur les balises, voir [Notifications basées sur les balises](t_push_tagsmain.md). +- Pour utiliser des options de notification avancées, voir [Notifications push avancées](t_advance_notifications.md). diff --git a/services/mobilepush/nl/fr/t_push_monitoring.md b/services/mobilepush/nl/fr/t_push_monitoring.md index a08886d19..4c4bb2288 100644 --- a/services/mobilepush/nl/fr/t_push_monitoring.md +++ b/services/mobilepush/nl/fr/t_push_monitoring.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Suivi des notifications Push -{: #monitor-notifications} -Dernière mise à jour : 16 janvier 2017 -{: .last-updated} - - -Le service IBM {{site.data.keyword.mobilepushshort}} étend désormais les capacités de surveillance des performances push en générant des graphiques depuis vos données utilisateur. Vous -pouvez utiliser l'utilitaire pour répertorier toutes les notifications push envoyées ou pour répertorier tous les appareils enregistrés et analyser les informations sur une base quotidienne, hebdomadaire ou mensuelle. - -Pour générer des rapports pour toutes les notifications envoyés, utilisez la méthode du rapport Push Messages GET report dans les [API REST](https://mobile.{DomainName}/imfpush/){: new_window}. - -![Rapport Notifications envoyées](images/monitoring_messages.jpg) - - -Pour générer des rapports pour tous les appareils enregistrés, utilisez la méthode du rapport Push Device Registrations GET dans les -[API REST](https://mobile.{DomainName}/imfpush/){: new_window}. - -![Rapport Périphériques enregistrés](images/monitoring_devices.jpg) - -Pour plus d'informations sur la mise à jour de votre SDK Android pour surveillance des informations de notification, voir [Suivi des notifications push sur les appareils Android](c_android_enable.html#android_monitor). - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Suivi des notifications Push +{: #monitor-notifications} +Dernière mise à jour : 16 janvier 2017 +{: .last-updated} + + +Le service IBM {{site.data.keyword.mobilepushshort}} étend désormais les capacités de surveillance des performances push en générant des graphiques depuis vos données utilisateur. Vous +pouvez utiliser l'utilitaire pour répertorier toutes les notifications push envoyées ou pour répertorier tous les appareils enregistrés et analyser les informations sur une base quotidienne, hebdomadaire ou mensuelle. + +Pour générer des rapports pour toutes les notifications envoyés, utilisez la méthode du rapport Push Messages GET report dans les [API REST](https://mobile.{DomainName}/imfpush/){: new_window}. + +![Rapport Notifications envoyées](images/monitoring_messages.jpg) + + +Pour générer des rapports pour tous les appareils enregistrés, utilisez la méthode du rapport Push Device Registrations GET dans les +[API REST](https://mobile.{DomainName}/imfpush/){: new_window}. + +![Rapport Périphériques enregistrés](images/monitoring_devices.jpg) + +Pour plus d'informations sur la mise à jour de votre SDK Android pour surveillance des informations de notification, voir [Suivi des notifications push sur les appareils Android](c_android_enable.html#android_monitor). + + + diff --git a/services/mobilepush/nl/fr/t_push_provider_android.md b/services/mobilepush/nl/fr/t_push_provider_android.md index 53a9e85d9..779c2dc0c 100644 --- a/services/mobilepush/nl/fr/t_push_provider_android.md +++ b/services/mobilepush/nl/fr/t_push_provider_android.md @@ -1,49 +1,49 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configuration des données d'identification pour le service FCM -{: #create-push-enable-gcm} -Dernière mise à jour : 16 janvier 2017 -{: .last-updated} - -FCM (Firebase Cloud Messaging) est la passerelle utilisée pour distribuer les notifications push aux périphériques Android et Google -Chrome. FCM est la nouvelle version de GCM (Google Cloud Messaging). Pour configurer le service {{site.data.keyword.mobilepushshort}} sur le tableau de -bord, vous devez obtenir vos données d'identification FCM. Prenez soin d'utiliser les configurations FCM pour les nouvelles applications. Les appli existantes continueraient à fonctionner avec les configurations GCM. - -##Obtention de votre ID d'émetteur et de la clé d'API -{: #android-senderid-apikey} - -La clé d'API est stockée de façon sécurisée et utilisée par le service {{site.data.keyword.mobilepushshort}} pour la connexion au serveur FCM. L'ID d'émetteur (numéro de projet) est utilisé par le logiciel SDK Android et le logiciel SDK JS pour Google Chrome et Mozilla Firefox côté client. - -Pour configurer FCM, générez la clé d'API et l'ID d'émetteur en procédant comme suit : - -1. Accédez à la [Console Firebase![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://console.firebase.google.com/?pli=1){: new_window}. -2. Sélectionnez **Créer un projet**. -3. Dans la fenêtre Créer un projet, fournissez un nom de projet, choisissez un pays/région puis cliquez sur **Créer un projet**. -3. Dans le panneau de navigation, cliquez sur l'icône des paramètres et sélectionnez **Paramètres du projet**. -4. Choisissez l'onglet Cloud Messaging pour générer la clé de serveur de l'API et l'ID de l'expéditeur. - -##Configuration du service {{site.data.keyword.mobilepushshort}} pour les applications Android et pour les applications et extensions Google Chrome -{: #setup-push-android} - -**Remarque :** vous aurez besoin de votre clé d'API FCM/GCM et de votre ID d'émetteur (numéro de projet). - -1. Ouvrez votre tableau de bord Bluemix puis cliquez sur l'instance de service {{site.data.keyword.mobilepushfull}} que vous avez créée pour ouvrir le tableau de bord. Le tableau de bord Push s'affiche. Pour configurer un service {{site.data.keyword.mobilepushshort}} non lié pour Android, sélectionnez l'icône relative au service {{site.data.keyword.mobilepushshort}} non lié pour ouvrir le tableau de bord du service {{site.data.keyword.mobilepushshort}}. - -![Tableau de bord Push](images/push_unbound.jpg) - -2. Cliquez sur le bouton **Configurer Push** pour configurer les données d'identification FCM/GCM pour les applications Android et pour les applications et extensions Google Chrome. -3. Sur la page **Configuration**, pour Android, accédez à l'onglet **Mobile** et configurez l'ID d'émetteur (numéro de projet CGM) et la clé d'API. Pour les applications et extensions Google Chrome, accédez à l'onglet **Web** et configurez l'ID d'émetteur (numéro de projet FCM/GCM) et la clé d'API de façon appropriée. -4. Cliquez sur **Sauvegarder**. -5. Etapes suivantes. [Activation des notifications pour Android](c_enable_push.html) ou [Activation des notifications pour les applications et extensions Google Chrome](c_enable_push.html). - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configuration des données d'identification pour le service FCM +{: #create-push-enable-gcm} +Dernière mise à jour : 16 janvier 2017 +{: .last-updated} + +FCM (Firebase Cloud Messaging) est la passerelle utilisée pour distribuer les notifications push aux périphériques Android et Google +Chrome. FCM est la nouvelle version de GCM (Google Cloud Messaging). Pour configurer le service {{site.data.keyword.mobilepushshort}} sur le tableau de +bord, vous devez obtenir vos données d'identification FCM. Prenez soin d'utiliser les configurations FCM pour les nouvelles applications. Les appli existantes continueraient à fonctionner avec les configurations GCM. + +##Obtention de votre ID d'émetteur et de la clé d'API +{: #android-senderid-apikey} + +La clé d'API est stockée de façon sécurisée et utilisée par le service {{site.data.keyword.mobilepushshort}} pour la connexion au serveur FCM. L'ID d'émetteur (numéro de projet) est utilisé par le logiciel SDK Android et le logiciel SDK JS pour Google Chrome et Mozilla Firefox côté client. + +Pour configurer FCM, générez la clé d'API et l'ID d'émetteur en procédant comme suit : + +1. Accédez à la [Console Firebase![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://console.firebase.google.com/?pli=1){: new_window}. +2. Sélectionnez **Créer un projet**. +3. Dans la fenêtre Créer un projet, fournissez un nom de projet, choisissez un pays/région puis cliquez sur **Créer un projet**. +3. Dans le panneau de navigation, cliquez sur l'icône des paramètres et sélectionnez **Paramètres du projet**. +4. Choisissez l'onglet Cloud Messaging pour générer la clé de serveur de l'API et l'ID de l'expéditeur. + +##Configuration du service {{site.data.keyword.mobilepushshort}} pour les applications Android et pour les applications et extensions Google Chrome +{: #setup-push-android} + +**Remarque :** vous aurez besoin de votre clé d'API FCM/GCM et de votre ID d'émetteur (numéro de projet). + +1. Ouvrez votre tableau de bord Bluemix puis cliquez sur l'instance de service {{site.data.keyword.mobilepushfull}} que vous avez créée pour ouvrir le tableau de bord. Le tableau de bord Push s'affiche. Pour configurer un service {{site.data.keyword.mobilepushshort}} non lié pour Android, sélectionnez l'icône relative au service {{site.data.keyword.mobilepushshort}} non lié pour ouvrir le tableau de bord du service {{site.data.keyword.mobilepushshort}}. + +![Tableau de bord Push](images/push_unbound.jpg) + +2. Cliquez sur le bouton **Configurer Push** pour configurer les données d'identification FCM/GCM pour les applications Android et pour les applications et extensions Google Chrome. +3. Sur la page **Configuration**, pour Android, accédez à l'onglet **Mobile** et configurez l'ID d'émetteur (numéro de projet CGM) et la clé d'API. Pour les applications et extensions Google Chrome, accédez à l'onglet **Web** et configurez l'ID d'émetteur (numéro de projet FCM/GCM) et la clé d'API de façon appropriée. +4. Cliquez sur **Sauvegarder**. +5. Etapes suivantes. [Activation des notifications pour Android](c_enable_push.html) ou [Activation des notifications pour les applications et extensions Google Chrome](c_enable_push.html). + + diff --git a/services/mobilepush/nl/fr/t_push_provider_ios.md b/services/mobilepush/nl/fr/t_push_provider_ios.md index 9f7f13c01..e281630a3 100644 --- a/services/mobilepush/nl/fr/t_push_provider_ios.md +++ b/services/mobilepush/nl/fr/t_push_provider_ios.md @@ -1,145 +1,145 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configuration des données d'identification pour le service APNS -{: #create-push-credentials-apns} -Dernière mise à jour : 16 janvier 2017 -{: .last-updated} - -Apple Push Notification Service (APNS) permet aux développeurs d'applications d'envoyer des notifications distantes depuis l'instance de service {{site.data.keyword.mobilepushshort}} dans Bluemix (le fournisseur) à des applications et des appareils iOS. Les messages sont envoyés à une application cible sur l'appareil. - -Procurez-vous des données d'identification APNS et configurez-les. Les certificats APNS sont gérés de façon sécurisée par le service {{site.data.keyword.mobilepushshort}} et utilisés pour la connexion au serveur APNS en tant que fournisseur. - - - - - - -##Enregistrement d'un ID d'appli -{: #create-push-credentials-apns-register} - - -L'ID d'application (l'identificateur de bundle) est un identificateur unique identifiant une application spécifique. Chaque application requiert un ID d'application. Les services tels que le service {{site.data.keyword.mobilepushshort}} sont configurés avec l'ID d'application. - -1. Vérifiez que vous disposez bien d'un compte [Apple Developers ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com/){: new_window}. -2. Accédez au portail [Apple Developer ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com){: new_window}, cliquez sur **Member Center**, puis sélectionnez **Certificates, Identifiers & Profiles**. -3. Accédez à la section **Registering App IDs** dans la bibliothèque [Apple Developer Library ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window}, et suivez les instructions d'enregistrement de l'ID d'application. - -Lorsque vous enregistrez un ID d'application, sélectionnez les options suivantes : - -* Push Notifications -![Services d'appli](images/appID_appservices_enablepush.jpg) -* Suffixe d'ID explicite -![ID explicite](images/appID_bundleID.jpg) -4. Création d'un certificat SSL APNS pour le développement et la distribution - -##Création d'un certificat SSL APNS pour le développement et la distribution -{: #create-push-credentials-apns-ssl} - -Pour pouvoir obtenir un certificat APNS, vous devez d'abord générer une demande de signature de certificat et la soumettre à Apple, l'autorité de certification. La demande de signature de certificat contient des informations qui identifient votre société, ainsi que votre clé publique et votre clé privée que vous utilisez pour signer vos notifications push Apple. Ensuite, générez le certificat SSL dans le portail des développeurs iOS. Le certificat, avec sa clé publique et sa clé privée, est stocké dans Keychain Access. - - - - - - -Vous pouvez utiliser APNS dans deux modes : - -* Mode bac à sable pour le développement et le test. -* Mode production lors de la distribution des applications via l'App Store (ou d'autres mécanismes de distribution d'entreprise). - -Vous devez vous procurer des certificats distincts pour vos environnements de développement et de distribution. Les certificats sont associés à un ID d'application pour l'application qui est le destinataire des notifications distantes. Pour la production, vous pouvez créer jusqu'à deux certificats. Bluemix utilise les certificats afin d'établir une connexion SSL à APNS. - - - -1. Accédez au site Web [Apple Developer ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com){: new_window}, cliquez sur **Member Center**, puis sélectionnez **Certificates, Identifiers & Profiles**. -2. Dans la zone **Identifiers**, cliquez sur **App IDs**. -3. Dans la liste des ID d'application, sélectionnez votre ID d'application puis choisissez **Settings**. -4. Dans la zone **Push Notifications**, créez un certificat SSL de développement, puis un certificat SSL de production. - - ![Certificats SSL de notification push](images/certificate_createssl.jpg) - -5. Quand l'écran **About Creating a Certificate Signing Request (CSR)** s'affiche, démarrez l'application **Keychain Access** sur votre Mac afin de créer une demande de signature de certificat. -6. Dans le menu, sélectionnez **Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority…** -7. Dans **Certificate Information**, entrez l'adresse électronique qui est associée à votre compte App Developer et un nom usuel. Attribuez un nom significatif qui permet d'identifier s'il s'agit d'un certificat pour le développement (bac à sable) ou pour la distribution (production), *certificat_apns_bacAsable* ou *certificat_apns_production*, par exemple. -8. Sélectionnez **Save to disk** pour télécharger le fichier `.certSigningRequest` sur votre bureau puis cliquez s ur **Continue**. -9. Dans l'option de menu **Save As**, attribuez un nom au fichier `.certSigningRequest` puis cliquez sur **Save**. -10. Cliquez sur **Done**. A présent, vous possédez une demande de signature de certificat. -11. Revenez à la fenêtre **About Creating a Certificate Signing Request (CSR)** puis cliquez sur **Continue**. -12. Dans l'écran **Generate**, cliquez sur **Choose File...** et sélectionnez le fichier de demande de signature de certificat que vous avez sauvegardé sur votre bureau. Ensuite, cliquez sur **Generate**. - ![Générer le certificat](images/generate_certificate.jpg) -13. Lorsque votre certificat est prêt, cliquez sur **Done**. -14. Sur l'écran **Push Notifications**, cliquez sur **Download** pour télécharger votre certificat, puis cliquez sur **Done**. - ![Téléchargement d'un certificat](images/certificate_download.jpg) -15. Sur votre Mac, accédez à **Keychain Access > My Certificates** et localisez le certificat que vous venez d'installer. Cliquez deux fois sur le certificat pour l'installer dans Keychain Access. -16. Sélectionnez le certificat et la clé privée puis sélectionnez **Export** pour convertir le certificat au format d'échange d'informations personnelles (format .`.p12`). - ![Exportation de certificat et de clés](images/keychain_export_key.jpg) -17. Dans la zone **Save As**, donnez au certificat un nom parlant, `certificat_p12.apns_bacAsable` ou `certificat_p12.apns_production`, par exemple, puis cliquez sur **Save**. - ![Exportation de certificat et de clés](images/certificate_p12v2.jpg) -18. Dans la zone **Enter a password**, entrez un mot de passe pour protéger les éléments exportés, puis cliquez sur **OK**. Vous pouvez utiliser ce mot de passe pour configurer vos paramètres APNS dans le tableau de bord Push.{: #step18} - ![Exportation de certificat et de clés](images/export_p12.jpg) -19. **Key Access.app** vous invite à exporter votre clé depuis l'écran **Keychain**. Entrez le mot de passe administrateur pour votre Mac afin de permettre au système d'exporter ces éléments puis sélectionnez l'option **Always Allow**. Un certificat `.p12` est généré sur votre bureau. - - -##Création d'un profil de mise à disposition pour le développement -{: #create-push-credentials-dev-profile} - -Le profil de mise à disposition est utilisé conjointement avec l'ID d'application pour déterminer quels sont les appareils qui peuvent installer et exécuter votre application et quels sont les services auxquels votre application peut accéder. Pour chaque ID d'application, vous créez deux profils de mise à disposition : un pour le développement et un pour la distribution. Xcode utilise le profil de mise à disposition pour le développement afin de déterminer quels sont les développeurs qui sont autorisés à construire l'application et quels sont les appareils qui peuvent être testés avec l'application. - -Prenez soin d'enregistrer un ID d'application, de l'activer pour le service {{site.data.keyword.mobilepushshort}} et de le configurer pour utiliser un certificat SSL APNS à des fins de développement et de production. - -Créez un profil de mise à disposition pour le développement, comme suit : - -1. Accédez au portail [Apple Developer ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com){: new_window}, cliquez sur **Member Center**, puis sélectionnez **Certificates, Identifiers & Profiles**. -2. Accédez à la bibliothèque [Mac Developer Library ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}, défilez jusqu'à la section **Creating Development Provisioning Profiles** et suivez les instructions de création d'un profil de développement. -**Remarque** : Lorsque vous configurez un profil de mise à disposition pour le développement, sélectionnez les options suivantes : - * **iOS App Development** - * **For iOS and watchOS apps ** - - - -##Création d'un profil de mise à disposition pour la distribution dans un magasin -{: #create-push-credentials-apns-distribute_profile} - -Utilisez le profil de mise à disposition dans un magasin afin de soumettre votre application pour la distribution dans l'App Store. - -1. Accédez au portail [Apple Developer ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com){: new_window}, cliquez sur **Member Center**, puis sélectionnez **Certificates, Identifiers & Profiles**. -2. Cliquez deux fois sur le profil de mise à disposition téléchargé afin de l'installer dans Xcode. - -##Configuration d'APNS dans le tableau de bord {{site.data.keyword.mobilepushshort}} -{: #create-push-credentials-apns-dashboard} - -Afin d'utiliser le service {{site.data.keyword.mobilepushshort}} pour envoyer des notifications, téléchargez les certificats SSL requis pour Apple Push Notification Service (APNS). Vous pouvez également utiliser l'API REST pour télécharger un certificat APNS. - - - -Les certificats requis pour un APNS sont des certificats `.p12`. Ils contiennent la clé privée et les certificats SSL requis pour construire et publier votre application. Vous devez générer les certificats depuis le Member Center du site Web Apple Developer (pour lequel un compte Apple Developer valide est requis). Des certificats distincts sont requis pour l'environnement de développement (bac à sable) et l'environnement de production (distribution). - -**Remarque** : une fois le fichier `.cer` dans votre accès à la chaîne de certificats, exportez-le sur votre ordinateur pour créer un certificat `.p12`. - -Pour plus d'information sur l'utilisation du service APNS, reportez-vous au manuel [iOS Developer Library: Local and Push Notification Programming Guide ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}. - -Pour configurer des APN sur le tableau de bord des services de notification push, procédez comme suit : - -1. Sélectionnez **Configurer** sur le tableau de bord des services de notifications push. -2. Sélectionnez l'option **Mobile** pour mettre à jour les informations dans le formulaire **Données d'identification push APNS**. -3. Sélectionnez **Bac à sable** (développement) ou **Production** (distribution) selon le cas, puis téléchargez le certificat `p.12` que vous avez créé à l'[étape](#step18) précédente. - ![Tableau de bord de définition des notifications push](images/wizard.jpg) -3. Dans la zone **Mot de passe**, entrez le mot de passe qui est associé au fichier de certificat `.p12`, puis cliquez sur **Sauvegarde**. - -Une fois les certificats téléchargés avec un mot de passe valide, vous pouvez commencer à envoyer des notifications. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configuration des données d'identification pour le service APNS +{: #create-push-credentials-apns} +Dernière mise à jour : 16 janvier 2017 +{: .last-updated} + +Apple Push Notification Service (APNS) permet aux développeurs d'applications d'envoyer des notifications distantes depuis l'instance de service {{site.data.keyword.mobilepushshort}} dans Bluemix (le fournisseur) à des applications et des appareils iOS. Les messages sont envoyés à une application cible sur l'appareil. + +Procurez-vous des données d'identification APNS et configurez-les. Les certificats APNS sont gérés de façon sécurisée par le service {{site.data.keyword.mobilepushshort}} et utilisés pour la connexion au serveur APNS en tant que fournisseur. + + + + + + +## Enregistrement d'un ID d'appli +{: #create-push-credentials-apns-register} + + +L'ID d'application (l'identificateur de bundle) est un identificateur unique identifiant une application spécifique. Chaque application requiert un ID d'application. Les services tels que le service {{site.data.keyword.mobilepushshort}} sont configurés avec l'ID d'application. + +1. Vérifiez que vous disposez bien d'un compte [Apple Developers ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com/){: new_window}. +2. Accédez au portail [Apple Developer ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com){: new_window}, cliquez sur **Member Center**, puis sélectionnez **Certificates, Identifiers & Profiles**. +3. Accédez à la section **Registering App IDs** dans la bibliothèque [Apple Developer Library ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window}, et suivez les instructions d'enregistrement de l'ID d'application. + +Lorsque vous enregistrez un ID d'application, sélectionnez les options suivantes : + +* Push Notifications +![Services d'appli](images/appID_appservices_enablepush.jpg) +* Suffixe d'ID explicite +![ID explicite](images/appID_bundleID.jpg) +4. Création d'un certificat SSL APNS pour le développement et la distribution + +## Création d'un certificat SSL APNS pour le développement et la distribution +{: #create-push-credentials-apns-ssl} + +Pour pouvoir obtenir un certificat APNS, vous devez d'abord générer une demande de signature de certificat et la soumettre à Apple, l'autorité de certification. La demande de signature de certificat contient des informations qui identifient votre société, ainsi que votre clé publique et votre clé privée que vous utilisez pour signer vos notifications push Apple. Ensuite, générez le certificat SSL dans le portail des développeurs iOS. Le certificat, avec sa clé publique et sa clé privée, est stocké dans Keychain Access. + + + + + + +Vous pouvez utiliser APNS dans deux modes : + +* Mode bac à sable pour le développement et le test. +* Mode production lors de la distribution des applications via l'App Store (ou d'autres mécanismes de distribution d'entreprise). + +Vous devez vous procurer des certificats distincts pour vos environnements de développement et de distribution. Les certificats sont associés à un ID d'application pour l'application qui est le destinataire des notifications distantes. Pour la production, vous pouvez créer jusqu'à deux certificats. Bluemix utilise les certificats afin d'établir une connexion SSL à APNS. + + + +1. Accédez au site Web [Apple Developer ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com){: new_window}, cliquez sur **Member Center**, puis sélectionnez **Certificates, Identifiers & Profiles**. +2. Dans la zone **Identifiers**, cliquez sur **App IDs**. +3. Dans la liste des ID d'application, sélectionnez votre ID d'application puis choisissez **Settings**. +4. Dans la zone **Push Notifications**, créez un certificat SSL de développement, puis un certificat SSL de production. + + ![Certificats SSL de notification push](images/certificate_createssl.jpg) + +5. Quand l'écran **About Creating a Certificate Signing Request (CSR)** s'affiche, démarrez l'application **Keychain Access** sur votre Mac afin de créer une demande de signature de certificat. +6. Dans le menu, sélectionnez **Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority…** +7. Dans **Certificate Information**, entrez l'adresse électronique qui est associée à votre compte App Developer et un nom usuel. Attribuez un nom significatif qui permet d'identifier s'il s'agit d'un certificat pour le développement (bac à sable) ou pour la distribution (production), *certificat_apns_bacAsable* ou *certificat_apns_production*, par exemple. +8. Sélectionnez **Save to disk** pour télécharger le fichier `.certSigningRequest` sur votre bureau puis cliquez s ur **Continue**. +9. Dans l'option de menu **Save As**, attribuez un nom au fichier `.certSigningRequest` puis cliquez sur **Save**. +10. Cliquez sur **Done**. A présent, vous possédez une demande de signature de certificat. +11. Revenez à la fenêtre **About Creating a Certificate Signing Request (CSR)** puis cliquez sur **Continue**. +12. Dans l'écran **Generate**, cliquez sur **Choose File...** et sélectionnez le fichier de demande de signature de certificat que vous avez sauvegardé sur votre bureau. Ensuite, cliquez sur **Generate**. + ![Générer le certificat](images/generate_certificate.jpg) +13. Lorsque votre certificat est prêt, cliquez sur **Done**. +14. Sur l'écran **Push Notifications**, cliquez sur **Download** pour télécharger votre certificat, puis cliquez sur **Done**. + ![Téléchargement d'un certificat](images/certificate_download.jpg) +15. Sur votre Mac, accédez à **Keychain Access > My Certificates** et localisez le certificat que vous venez d'installer. Cliquez deux fois sur le certificat pour l'installer dans Keychain Access. +16. Sélectionnez le certificat et la clé privée puis sélectionnez **Export** pour convertir le certificat au format d'échange d'informations personnelles (format .`.p12`). + ![Exportation de certificat et de clés](images/keychain_export_key.jpg) +17. Dans la zone **Save As**, donnez au certificat un nom parlant, `certificat_p12.apns_bacAsable` ou `certificat_p12.apns_production`, par exemple, puis cliquez sur **Save**. + ![Exportation de certificat et de clés](images/certificate_p12v2.jpg) +18. Dans la zone **Enter a password**, entrez un mot de passe pour protéger les éléments exportés, puis cliquez sur **OK**. Vous pouvez utiliser ce mot de passe pour configurer vos paramètres APNS dans le tableau de bord Push.{: #step18} + ![Exportation de certificat et de clés](images/export_p12.jpg) +19. **Key Access.app** vous invite à exporter votre clé depuis l'écran **Keychain**. Entrez le mot de passe administrateur pour votre Mac afin de permettre au système d'exporter ces éléments puis sélectionnez l'option **Always Allow**. Un certificat `.p12` est généré sur votre bureau. + + +## Création d'un profil de mise à disposition pour le développement +{: #create-push-credentials-dev-profile} + +Le profil de mise à disposition est utilisé conjointement avec l'ID d'application pour déterminer quels sont les appareils qui peuvent installer et exécuter votre application et quels sont les services auxquels votre application peut accéder. Pour chaque ID d'application, vous créez deux profils de mise à disposition : un pour le développement et un pour la distribution. Xcode utilise le profil de mise à disposition pour le développement afin de déterminer quels sont les développeurs qui sont autorisés à construire l'application et quels sont les appareils qui peuvent être testés avec l'application. + +Prenez soin d'enregistrer un ID d'application, de l'activer pour le service {{site.data.keyword.mobilepushshort}} et de le configurer pour utiliser un certificat SSL APNS à des fins de développement et de production. + +Créez un profil de mise à disposition pour le développement, comme suit : + +1. Accédez au portail [Apple Developer ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com){: new_window}, cliquez sur **Member Center**, puis sélectionnez **Certificates, Identifiers & Profiles**. +2. Accédez à la bibliothèque [Mac Developer Library ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}, défilez jusqu'à la section **Creating Development Provisioning Profiles** et suivez les instructions de création d'un profil de développement. +**Remarque** : Lorsque vous configurez un profil de mise à disposition pour le développement, sélectionnez les options suivantes : + * **iOS App Development** + * **For iOS and watchOS apps ** + + + +## Création d'un profil de mise à disposition pour la distribution dans un magasin +{: #create-push-credentials-apns-distribute_profile} + +Utilisez le profil de mise à disposition dans un magasin afin de soumettre votre application pour la distribution dans l'App Store. + +1. Accédez au portail [Apple Developer ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com){: new_window}, cliquez sur **Member Center**, puis sélectionnez **Certificates, Identifiers & Profiles**. +2. Cliquez deux fois sur le profil de mise à disposition téléchargé afin de l'installer dans Xcode. + +## Configuration d'APNS dans le tableau de bord {{site.data.keyword.mobilepushshort}} +{: #create-push-credentials-apns-dashboard} + +Afin d'utiliser le service {{site.data.keyword.mobilepushshort}} pour envoyer des notifications, téléchargez les certificats SSL requis pour Apple Push Notification Service (APNS). Vous pouvez également utiliser l'API REST pour télécharger un certificat APNS. + + + +Les certificats requis pour un APNS sont des certificats `.p12`. Ils contiennent la clé privée et les certificats SSL requis pour construire et publier votre application. Vous devez générer les certificats depuis le Member Center du site Web Apple Developer (pour lequel un compte Apple Developer valide est requis). Des certificats distincts sont requis pour l'environnement de développement (bac à sable) et l'environnement de production (distribution). + +**Remarque** : une fois le fichier `.cer` dans votre accès à la chaîne de certificats, exportez-le sur votre ordinateur pour créer un certificat `.p12`. + +Pour plus d'information sur l'utilisation du service APNS, reportez-vous au manuel [iOS Developer Library: Local and Push Notification Programming Guide ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}. + +Pour configurer des APN sur le tableau de bord des services de notification push, procédez comme suit : + +1. Sélectionnez **Configurer** sur le tableau de bord des services de notifications push. +2. Sélectionnez l'option **Mobile** pour mettre à jour les informations dans le formulaire **Données d'identification push APNS**. +3. Sélectionnez **Bac à sable** (développement) ou **Production** (distribution) selon le cas, puis téléchargez le certificat `p.12` que vous avez créé à l'[étape](#step18) précédente. + ![Tableau de bord de définition des notifications push](images/wizard.jpg) +3. Dans la zone **Mot de passe**, entrez le mot de passe qui est associé au fichier de certificat `.p12`, puis cliquez sur **Sauvegarde**. + +Une fois les certificats téléchargés avec un mot de passe valide, vous pouvez commencer à envoyer des notifications. diff --git a/services/mobilepush/nl/fr/t_push_provider_safari.md b/services/mobilepush/nl/fr/t_push_provider_safari.md index f5aa43d6f..743469303 100644 --- a/services/mobilepush/nl/fr/t_push_provider_safari.md +++ b/services/mobilepush/nl/fr/t_push_provider_safari.md @@ -1,89 +1,89 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configuration des données d'identification pour les navigateurs Web -{: #configure-credential-for-browsers} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - -Le service IBM {{site.data.keyword.mobilepushshort}} étend désormais les capacités d'envoi de notifications à votre navigateur. - -L'URL ou le nom de domaine de votre site Web sont requis par le service {{site.data.keyword.mobilepushshort}} pour identifier les demandes devant -être autorisées. Une instance de service {{site.data.keyword.mobilepushshort}} ne prend en charge qu'un seul nom de domaine à la fois. Par conséquent, -prenez soin de définir la même valeur pour Chrome, Firefox et Safari. - -Les navigateurs Chrome et Safari requièrent une configuration supplémentaire pour les notifications push sur le Web. Vous aurez besoin d'une clé d'API -FCM vu qu'un noeud final est utilisé pour distribuer des messages dans Chrome. Pour obtenir votre clé d'API FCMkey, voir -[Configuration des données d'identification pour le service FCM](t_push_provider_android.html). - - - -##Configuration pour notification push Web sur Chrome et Firefox -{: #config-chrome-firefox} - -1. Dans le panneau du tableau de bord Push, sélectionnez **Configurer**. -2. Sélectionnez l'onglet Web. - ![Configurations de Push Web](images/webpush_configure.jpg) -3. Configurez la clé d'API FCM/GCM et l'URL de votre site Web qui sera enregistré pour recevoir les notifications push. -4. Cliquez sur **Sauvegarder**. -5. Etapes suivantes. [Activation des notifications pour les navigateurs Google Chrome et Mozilla Firefox](c_enable_push.html). - - -## Configuration pour notification push Web sur Safari -{: #configure-safari} - -La version prise en charge du service {{site.data.keyword.mobilepushshort}} sur Safari est la version 10.0. Vous devez générer un certificat via votre -compte Apple Developer avant de pouvoir configurer votre navigateur pour recevoir des notifications. - -### Génération d'un certificat -{: #certificate-generation} - -Assurez-vous que vous disposez d'un compte Développeur Apple. Vous devez enregistrer un ID push du site web et générer un certificat afin de configurer votre navigateur Safari pour la réception des notifications. Les étapes suivantes vous aideront à démarrer. - -1. Dans le centre des membres développeurs Apple, cliquez sur **Certificates, ID & Profiles**. -2. Cliquez sur **Identifiers**, puis sur **Website Push IDs**. -3. Choisissez de créer une nouvelle entrée en sélectionnant l'icône plus. - ![Tableau de bord Push](images/safari_1.jpg) - -4. Dans le panneau Register Website Push ID, indiquez une description et un identificateur d'ID Push de site Web appropriés. Il est recommandé d'utiliser un format de nom de domaine inverse, en commençant par 'web'. Par exemple : web.com.example.dailyweatherreports. -5. Enregistrez l'ID Push de site Web. Vous disposez à présent de votre ID Push de site Web -6. Sélectionnez **Editer** pour créer un certificat à utiliser pour l'ID Push de site Web. -7. Dans la fenêtre Certificate Assistant de Certificate Information, indiquez votre ID de courrier électronique et un nom usuel. N'indiquez pas l'adresse de courrier électronique de l'autorité de certification. -8. Cliquez sur **Save to disk** et sélectionnez **Continue**. -9. Choisissez d'enregistrer le certificat dans un dossier approprié. -10. Sélectionnez la demande `.certSigningRequest` créée sur le disque à l'invite par l'assistant de générer le certificat. Prenez soin de télécharger le certificat push de site Web créé au format `.cer`. -11. Ouvrez le certificat dans l'outil KeyChain Access. Cliquez sur le bouton droit de la souris et exportez-le en tant que certificat p12. Notez le mot de passe fourni lors de la génération du certificat p12. - - -### Configuration pour notifications - {: #configuration-notification} - -Après avoir généré le certificat, vous devez configurer le service pour envoyer des notifications à Safari. - -Procédez comme suit : - -1. Dans le tableau de bord du service Push Notifications, **cliquez sur Configurer**. -2. Sélectionnez l'onglet Web. -3. Dans la section Safari Push, mettez à jour le formulaire avec les informations requises. - - **Nom du site web **: nom que vous avez indiqué dans le centre de notification. - - **ID push du site web **: mettez à jour cette zone avec la chaîne de domaine inverse pour votre ID push de site Web. Par exemple, web.com.example.www. - - **URL du site Web **: indiquez l'URL du site Web à abonner pour les notifications push. Par exemple, https://www.example.com. - - **Domaines autorisés **: ce paramètre est facultatif. Il s'agit de la liste des sites Web qui réclament une permission de l'utilisateur. Vérifiez que les URL sont des valeurs séparées par des virgules. Notez que la valeur de l'URL de site Web sera utilisée si cette liste n'est pas fournie. - - **Chaîne de format de l'URL **: URL à résoudre lors d'un clic sur la notification. Par exemple, ["https://www.example.com"]. L'URL doit utiliser le schéma http ou https. - - **Certificat push web Safari **: téléchargez le certificat .p12 et fournissez le mot de passe. -4. Cliquez sur **Sauvegarder**. - -![Tableau de bord Push](images/push_configure_safari.jpg) - -Vous avez effectué la configuration pour envoyer des notifications push au navigateur Safari. - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configuration des données d'identification pour les navigateurs Web +{: #configure-credential-for-browsers} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + +Le service IBM {{site.data.keyword.mobilepushshort}} étend désormais les capacités d'envoi de notifications à votre navigateur. + +L'URL ou le nom de domaine de votre site Web sont requis par le service {{site.data.keyword.mobilepushshort}} pour identifier les demandes devant +être autorisées. Une instance de service {{site.data.keyword.mobilepushshort}} ne prend en charge qu'un seul nom de domaine à la fois. Par conséquent, +prenez soin de définir la même valeur pour Chrome, Firefox et Safari. + +Les navigateurs Chrome et Safari requièrent une configuration supplémentaire pour les notifications push sur le Web. Vous aurez besoin d'une clé d'API +FCM vu qu'un noeud final est utilisé pour distribuer des messages dans Chrome. Pour obtenir votre clé d'API FCMkey, voir +[Configuration des données d'identification pour le service FCM](t_push_provider_android.html). + + + +## Configuration pour notification push Web sur Chrome et Firefox +{: #config-chrome-firefox} + +1. Dans le panneau du tableau de bord Push, sélectionnez **Configurer**. +2. Sélectionnez l'onglet Web. + ![Configurations de Push Web](images/webpush_configure.jpg) +3. Configurez la clé d'API FCM/GCM et l'URL de votre site Web qui sera enregistré pour recevoir les notifications push. +4. Cliquez sur **Sauvegarder**. +5. Etapes suivantes. [Activation des notifications pour les navigateurs Google Chrome et Mozilla Firefox](c_enable_push.html). + + +## Configuration pour notification push Web sur Safari +{: #configure-safari} + +La version prise en charge du service {{site.data.keyword.mobilepushshort}} sur Safari est la version 10.0. Vous devez générer un certificat via votre +compte Apple Developer avant de pouvoir configurer votre navigateur pour recevoir des notifications. + +### Génération d'un certificat +{: #certificate-generation} + +Assurez-vous que vous disposez d'un compte Développeur Apple. Vous devez enregistrer un ID push du site web et générer un certificat afin de configurer votre navigateur Safari pour la réception des notifications. Les étapes suivantes vous aideront à démarrer. + +1. Dans le centre des membres développeurs Apple, cliquez sur **Certificates, ID & Profiles**. +2. Cliquez sur **Identifiers**, puis sur **Website Push IDs**. +3. Choisissez de créer une nouvelle entrée en sélectionnant l'icône plus. + ![Tableau de bord Push](images/safari_1.jpg) + +4. Dans le panneau Register Website Push ID, indiquez une description et un identificateur d'ID Push de site Web appropriés. Il est recommandé d'utiliser un format de nom de domaine inverse, en commençant par 'web'. Par exemple : web.com.example.dailyweatherreports. +5. Enregistrez l'ID Push de site Web. Vous disposez à présent de votre ID Push de site Web +6. Sélectionnez **Editer** pour créer un certificat à utiliser pour l'ID Push de site Web. +7. Dans la fenêtre Certificate Assistant de Certificate Information, indiquez votre ID de courrier électronique et un nom usuel. N'indiquez pas l'adresse de courrier électronique de l'autorité de certification. +8. Cliquez sur **Save to disk** et sélectionnez **Continue**. +9. Choisissez d'enregistrer le certificat dans un dossier approprié. +10. Sélectionnez la demande `.certSigningRequest` créée sur le disque à l'invite par l'assistant de générer le certificat. Prenez soin de télécharger le certificat push de site Web créé au format `.cer`. +11. Ouvrez le certificat dans l'outil KeyChain Access. Cliquez sur le bouton droit de la souris et exportez-le en tant que certificat p12. Notez le mot de passe fourni lors de la génération du certificat p12. + + +### Configuration pour notifications + {: #configuration-notification} + +Après avoir généré le certificat, vous devez configurer le service pour envoyer des notifications à Safari. + +Procédez comme suit : + +1. Dans le tableau de bord du service Push Notifications, **cliquez sur Configurer**. +2. Sélectionnez l'onglet Web. +3. Dans la section Safari Push, mettez à jour le formulaire avec les informations requises. + - **Nom du site web **: nom que vous avez indiqué dans le centre de notification. + - **ID push du site web **: mettez à jour cette zone avec la chaîne de domaine inverse pour votre ID push de site Web. Par exemple, web.com.example.www. + - **URL du site Web **: indiquez l'URL du site Web à abonner pour les notifications push. Par exemple, https://www.example.com. + - **Domaines autorisés **: ce paramètre est facultatif. Il s'agit de la liste des sites Web qui réclament une permission de l'utilisateur. Vérifiez que les URL sont des valeurs séparées par des virgules. Notez que la valeur de l'URL de site Web sera utilisée si cette liste n'est pas fournie. + - **Chaîne de format de l'URL **: URL à résoudre lors d'un clic sur la notification. Par exemple, ["https://www.example.com"]. L'URL doit utiliser le schéma http ou https. + - **Certificat push web Safari **: téléchargez le certificat .p12 et fournissez le mot de passe. +4. Cliquez sur **Sauvegarder**. + +![Tableau de bord Push](images/push_configure_safari.jpg) + +Vous avez effectué la configuration pour envoyer des notifications push au navigateur Safari. + + diff --git a/services/mobilepush/nl/fr/t_push_tagsmain.md b/services/mobilepush/nl/fr/t_push_tagsmain.md index a37e0a2bb..ef355e591 100644 --- a/services/mobilepush/nl/fr/t_push_tagsmain.md +++ b/services/mobilepush/nl/fr/t_push_tagsmain.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Notifications basées sur les balises -{: #push-ios-main-tags} -Dernière mise à jour : 16 janvier 2017 -{: .last-updated} - -Les messages de notification basée balise sont envoyés à tous les appareils abonnés à la balise concernée. Vous pouvez définir des balises, puis envoyer et recevoir des messages à l'aide de balises. - -Vous devez d'abord créer les balises pour l'application, configurer les abonnements aux balises, puis initier les notifications basées sur les balises. Pour envoyer une notification basée balise à l'aide de l'[API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}, prenez soin de renseigner la zone "tagNames" lors de l'envoi à la ressource de message. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Notifications basées sur les balises +{: #push-ios-main-tags} +Dernière mise à jour : 16 janvier 2017 +{: .last-updated} + +Les messages de notification basée balise sont envoyés à tous les appareils abonnés à la balise concernée. Vous pouvez définir des balises, puis envoyer et recevoir des messages à l'aide de balises. + +Vous devez d'abord créer les balises pour l'application, configurer les abonnements aux balises, puis initier les notifications basées sur les balises. Pour envoyer une notification basée balise à l'aide de l'[API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}, prenez soin de renseigner la zone "tagNames" lors de l'envoi à la ressource de message. diff --git a/services/mobilepush/nl/fr/t_restapi.md b/services/mobilepush/nl/fr/t_restapi.md index 3f4ccd21b..5cf432f28 100644 --- a/services/mobilepush/nl/fr/t_restapi.md +++ b/services/mobilepush/nl/fr/t_restapi.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Utilisation des API REST -{: #push-api-rest} -Dernière mise à jour : 16 janvier 2017 -{: .last-updated} - -Vous pouvez utiliser une interface de programmation d'application REST (Representational State Transfer) pour {{site.data.keyword.mobilepushshort}}. Vous pouvez également utiliser le SDK et l'[API Push ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window} pour affiner plus encore le développement de vos applications client. - -Avec l'API REST Push, les applications serveur de back end et les clients peuvent accéder à des fonctions {{site.data.keyword.mobilepushshort}}. - -- Enregistrements d'appareil -- Enregistrements -- Messages -- Abonnements -- Balises -- Webhooks - -Pour obtenir l'URL de base pour l'API REST, procédez comme suit : - -1. Créez une application de back end dans la section Conteneurs boilerplate du catalogue Bluemix®, en choisissant MobileFirst Services Starter, ce qui a pour effet de lier le service {{site.data.keyword.mobilepushshort}} à l'application. Vous pouvez aussi créer une instance de service de Push et la laisser non liée. -1. Dans la page principale du tableau de bord Bluemix, accédez à la zone **Applications** et sélectionnez votre application. -3. Cliquez sur **OPTIONS POUR APPLICATION MOBILE**. Les valeurs de route et d'identificateur global unique de l'application sont affichées au début de la page des détails de votre application. L'écran Afficher les données d'identification affiche des informations sur la valeur confidentielle AppSecret. Vous pouvez obtenir la valeur confidentielle d'application depuis les options pour application mobile ainsi que la valeur confidentielle de client pour certaines des interfaces API. - -Vous pouvez aussi utiliser la ligne de commande pour obtenir les données d'identification pour le service : - -``` - cf create-service-key {push_instance_name} {key_name} - - cf service-key {push_instance_name} {key_name} -``` - {: codeblock} - -## En-tête Accept-Language -{: #push-api-rest-accept} - -L'en-tête "Accept-Language" spécifie la langue à utiliser pour les messages d'erreur générés par l'[API REST Push ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. Les langues suivantes sont prises en charge pour les messages d'erreur : chinois (simplifié), chinois (traditionnel), anglais (Etats-Unis), allemand, français, italien, japonais, coréen, portugais et espagnol. - -## Valeur confidentielle d'application -{: #push-api-rest-secret} - -Quand une application est liée à {{site.data.keyword.mobilepushshort}}, le service génère une valeur confidentielle appSecret (clé unique) et la transmet dans l'en-tête de réponse. Si vous utilisez l'API REST IBM {{site.data.keyword.mobilepushshort}} for Bluemix, servez-vous de la référence de l'API REST pour savoir quelles sont les API que vous devez sécuriser. Pour plus d'informations, reportez-vous à la rubrique [Push REST API ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. - -L'en-tête de demande doit contenir la valeur appSecret. Si tel n'est pas le cas, le serveur renvoie le code d'erreur 401 Unauthorized. Quand {{site.data.keyword.mobilepushshort}} est ajouté à une application, un ID d'application spécifique est créé. Dans le cadre de la réponse, vous obtenez un en-tête intitulé appSecret (valeur confidentielle d'application) qui est utilisé pour créer des balises ou envoyer des messages. L'opération est effectuée via des services dans le catalogue ou le conteneur boilerplate. - -Pour obtenir la valeur appSecret : - -1. Cliquez sur le *nom d'application* qui est lié au service Push. -2. Cliquez sur le lien **Afficher les données d'identification** pour afficher la valeur confidentielle d'application (ID d'application). - -L'écran **Afficher les données d'identification** affiche des informations sur la valeur confidentielle d'application : -``` - { - "imfpush_Dev": [ - { - "name": "testapp1", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": { - "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", - "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", - "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", - } - } - ] - } -``` - {: codeblock} - - -##Filtres des API REST Push -{: #push-api-rest-filters} - -Les filtres définissent un critère de recherche permettant de restreindre les données qui sont renvoyées depuis une API GET de {{site.data.keyword.mobilepushshort}}. Appliquez les filtres au résultat de l'opération Get à filtrer. Le filtre restreint le nombre d'entrées incluses dans le résultat. Ainsi, vous pouvez utiliser un filtre pour rechercher des balises commençant par "test". - -Les filtres peuvent être générés en utilisant la syntaxe suivante : - -**nom** : nom de la zone sur laquelle le filtre est appliqué. - -**opérateur** : == (correspondance exacte) ou =@ (contient une sous-chaîne) qui décrit la correspondance de filtre à utiliser. - -**expression** : valeurs à inclure dans le résultat. - -Dans une expression, les virgules et les barres obliques inversées doivent être précédées d'une barre oblique inversée. - -Si vous utilisez plusieurs filtres, vous pouvez les combiner avec la logique AND ou OR. - -- Pour la logique AND, utilisez plusieurs filtres dans la requête. -- Pour la logique OR, utilisez une virgule (,) dans l'expression de filtre. -- Pour la logique AND et OR : une requête simple peut comporter les deux logiques, AND et OR. Chaque filtre est évalué individuellement avant que les filtres ne soient combinés dans une expression AND. - -Pour l'API GET d'appareil, les combinaisons suivantes sont prises en charge : --Le nom est la zone de plateforme. -- Sauf pour platform, l'opérateur peut être == ou =@ -- Pour platform, l'opérateur doit être ==. Si l'opérateur =@ est utilisé, la valeur peut être une sous-chaîne. -- Si l'opérateur == est utilisé, la valeur doit être une chaîne qui correspond exactement. - -Pour l'API GET d'abonnement, les combinaisons suivantes sont prises en charge : - -- Le nom peut être l'une des zones suivantes : tagName ou deviceId -- Sauf pour platform, l'opérateur peut être == ou =@ -- Pour platform, l'opérateur doit être == -- Si l'opérateur =@ est utilisé, la valeur peut être une sous-chaîne. Si l'opérateur == est utilisé, la valeur doit être une chaîne qui correspond exactement. -- Pour l'API GET d'étiquette, les combinaisons suivantes sont prises en charge : -- Le nom peut être l'une des zones suivantes : “name” ou “description” -- Si l'opérateur =@ est utilisé, la valeur peut être une sous-chaîne. -- Si l'opérateur == est utilisé, la valeur doit être une chaîne qui correspond exactement. - - -##Codes de réponse {{site.data.keyword.mobilepushshort}} -{: #push-api-response-codes} - -Status: 405 Method Not Allowed - Appropriate method expected. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Utilisation des API REST +{: #push-api-rest} +Dernière mise à jour : 16 janvier 2017 +{: .last-updated} + +Vous pouvez utiliser une interface de programmation d'application REST (Representational State Transfer) pour {{site.data.keyword.mobilepushshort}}. Vous pouvez également utiliser le SDK et l'[API Push ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window} pour affiner plus encore le développement de vos applications client. + +Avec l'API REST Push, les applications serveur de back end et les clients peuvent accéder à des fonctions {{site.data.keyword.mobilepushshort}}. + +- Enregistrements d'appareil +- Enregistrements +- Messages +- Abonnements +- Balises +- Webhooks + +Pour obtenir l'URL de base pour l'API REST, procédez comme suit : + +1. Créez une application de back end dans la section Conteneurs boilerplate du catalogue Bluemix®, en choisissant MobileFirst Services Starter, ce qui a pour effet de lier le service {{site.data.keyword.mobilepushshort}} à l'application. Vous pouvez aussi créer une instance de service de Push et la laisser non liée. +1. Dans la page principale du tableau de bord Bluemix, accédez à la zone **Applications** et sélectionnez votre application. +3. Cliquez sur **OPTIONS POUR APPLICATION MOBILE**. Les valeurs de route et d'identificateur global unique de l'application sont affichées au début de la page des détails de votre application. L'écran Afficher les données d'identification affiche des informations sur la valeur confidentielle AppSecret. Vous pouvez obtenir la valeur confidentielle d'application depuis les options pour application mobile ainsi que la valeur confidentielle de client pour certaines des interfaces API. + +Vous pouvez aussi utiliser la ligne de commande pour obtenir les données d'identification pour le service : + +``` + cf create-service-key {push_instance_name} {key_name} + + cf service-key {push_instance_name} {key_name} +``` + {: codeblock} + +## En-tête Accept-Language +{: #push-api-rest-accept} + +L'en-tête "Accept-Language" spécifie la langue à utiliser pour les messages d'erreur générés par l'[API REST Push ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. Les langues suivantes sont prises en charge pour les messages d'erreur : chinois (simplifié), chinois (traditionnel), anglais (Etats-Unis), allemand, français, italien, japonais, coréen, portugais et espagnol. + +## Valeur confidentielle d'application +{: #push-api-rest-secret} + +Quand une application est liée à {{site.data.keyword.mobilepushshort}}, le service génère une valeur confidentielle appSecret (clé unique) et la transmet dans l'en-tête de réponse. Si vous utilisez l'API REST IBM {{site.data.keyword.mobilepushshort}} for Bluemix, servez-vous de la référence de l'API REST pour savoir quelles sont les API que vous devez sécuriser. Pour plus d'informations, reportez-vous à la rubrique [Push REST API ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. + +L'en-tête de demande doit contenir la valeur appSecret. Si tel n'est pas le cas, le serveur renvoie le code d'erreur 401 Unauthorized. Quand {{site.data.keyword.mobilepushshort}} est ajouté à une application, un ID d'application spécifique est créé. Dans le cadre de la réponse, vous obtenez un en-tête intitulé appSecret (valeur confidentielle d'application) qui est utilisé pour créer des balises ou envoyer des messages. L'opération est effectuée via des services dans le catalogue ou le conteneur boilerplate. + +Pour obtenir la valeur appSecret : + +1. Cliquez sur le *nom d'application* qui est lié au service Push. +2. Cliquez sur le lien **Afficher les données d'identification** pour afficher la valeur confidentielle d'application (ID d'application). + +L'écran **Afficher les données d'identification** affiche des informations sur la valeur confidentielle d'application : +``` + { + "imfpush_Dev": [ + { + "name": "testapp1", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": { + "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", + "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", + "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", + } + } + ] + } +``` + {: codeblock} + + +## Filtres des API REST Push +{: #push-api-rest-filters} + +Les filtres définissent un critère de recherche permettant de restreindre les données qui sont renvoyées depuis une API GET de {{site.data.keyword.mobilepushshort}}. Appliquez les filtres au résultat de l'opération Get à filtrer. Le filtre restreint le nombre d'entrées incluses dans le résultat. Ainsi, vous pouvez utiliser un filtre pour rechercher des balises commençant par "test". + +Les filtres peuvent être générés en utilisant la syntaxe suivante : + +**nom** : nom de la zone sur laquelle le filtre est appliqué. + +**opérateur** : == (correspondance exacte) ou =@ (contient une sous-chaîne) qui décrit la correspondance de filtre à utiliser. + +**expression** : valeurs à inclure dans le résultat. + +Dans une expression, les virgules et les barres obliques inversées doivent être précédées d'une barre oblique inversée. + +Si vous utilisez plusieurs filtres, vous pouvez les combiner avec la logique AND ou OR. + +- Pour la logique AND, utilisez plusieurs filtres dans la requête. +- Pour la logique OR, utilisez une virgule (,) dans l'expression de filtre. +- Pour la logique AND et OR : une requête simple peut comporter les deux logiques, AND et OR. Chaque filtre est évalué individuellement avant que les filtres ne soient combinés dans une expression AND. + +Pour l'API GET d'appareil, les combinaisons suivantes sont prises en charge : +-Le nom est la zone de plateforme. +- Sauf pour platform, l'opérateur peut être == ou =@ +- Pour platform, l'opérateur doit être ==. Si l'opérateur =@ est utilisé, la valeur peut être une sous-chaîne. +- Si l'opérateur == est utilisé, la valeur doit être une chaîne qui correspond exactement. + +Pour l'API GET d'abonnement, les combinaisons suivantes sont prises en charge : + +- Le nom peut être l'une des zones suivantes : tagName ou deviceId +- Sauf pour platform, l'opérateur peut être == ou =@ +- Pour platform, l'opérateur doit être == +- Si l'opérateur =@ est utilisé, la valeur peut être une sous-chaîne. Si l'opérateur == est utilisé, la valeur doit être une chaîne qui correspond exactement. +- Pour l'API GET d'étiquette, les combinaisons suivantes sont prises en charge : +- Le nom peut être l'une des zones suivantes : “name” ou “description” +- Si l'opérateur =@ est utilisé, la valeur peut être une sous-chaîne. +- Si l'opérateur == est utilisé, la valeur doit être une chaîne qui correspond exactement. + + +## Codes de réponse {{site.data.keyword.mobilepushshort}} +{: #push-api-response-codes} + +Status: 405 Method Not Allowed - Appropriate method expected. diff --git a/services/mobilepush/nl/fr/t_sandbox.md b/services/mobilepush/nl/fr/t_sandbox.md index e86c9bd39..84562b2f5 100644 --- a/services/mobilepush/nl/fr/t_sandbox.md +++ b/services/mobilepush/nl/fr/t_sandbox.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Mode bac à sable et mode production -{: #push-sandboxandproduction-modes} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - -Vous pouvez utiliser {{site.data.keyword.mobilepushshort}} sous l'un des deux modes suivants : bac à sable ou production. Le bac à sable est un environnement de test autonome dans lequel vous pouvez développer et tester l'intégration d'API Push avec le service Push -d'application serveur. - -Configurez les modes bac à sable et production à l'aide du tableau de bord Push. Vous pouvez permuter entre le mode d'opération bac à sable et le mode production du service push à l'aide de l'[API REST Push](https://mobile.{DomainName}/imfpush/){: new_window}. Par défaut, le mode bac à sable est activé. Toutefois, lors du passage d'un mode à l'autre, balises, les appareils et les abonnements ne sont pas partagés. - -Lorsque vous êtes prêt à déployer l'application dans un environnement de production, sélectionnez le mode PRODUCTION à l'aide de l'[API REST Push](https://mobile.{DomainName}/imfpush/){: new_window}. - -Pour changer le mode de fonctionnement du service push et passer du mode bac à sable au mode production : - -1. Utilisez l'appel d'API REST PUT ApplicationID Settings -2. Dans le corps JSON, vérifiez que le mode a été changé en utilisant l'appel d'API [REST GET ApplicationID Settings](https://mobile.{DomainName}/imfpush/){: new_window}. La réponse attendue est "mode": "PRODUCTION" -```{ - "mode": "PRODUCTION" - } -``` - {: codeblock} -1. Une fois que vous avez changé de mode d'environnement, relancez l'exécution de votre code client de manière à enregistrer votre appareil en mode PRODUCTION. - -Pour plus d'informations sur l'API REST, voir [Utilisation des API REST](t_restapi.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Mode bac à sable et mode production +{: #push-sandboxandproduction-modes} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + +Vous pouvez utiliser {{site.data.keyword.mobilepushshort}} sous l'un des deux modes suivants : bac à sable ou production. Le bac à sable est un environnement de test autonome dans lequel vous pouvez développer et tester l'intégration d'API Push avec le service Push +d'application serveur. + +Configurez les modes bac à sable et production à l'aide du tableau de bord Push. Vous pouvez permuter entre le mode d'opération bac à sable et le mode production du service push à l'aide de l'[API REST Push](https://mobile.{DomainName}/imfpush/){: new_window}. Par défaut, le mode bac à sable est activé. Toutefois, lors du passage d'un mode à l'autre, balises, les appareils et les abonnements ne sont pas partagés. + +Lorsque vous êtes prêt à déployer l'application dans un environnement de production, sélectionnez le mode PRODUCTION à l'aide de l'[API REST Push](https://mobile.{DomainName}/imfpush/){: new_window}. + +Pour changer le mode de fonctionnement du service push et passer du mode bac à sable au mode production : + +1. Utilisez l'appel d'API REST PUT ApplicationID Settings +2. Dans le corps JSON, vérifiez que le mode a été changé en utilisant l'appel d'API [REST GET ApplicationID Settings](https://mobile.{DomainName}/imfpush/){: new_window}. La réponse attendue est "mode": "PRODUCTION" +```{ + "mode": "PRODUCTION" + } +``` + {: codeblock} +1. Une fois que vous avez changé de mode d'environnement, relancez l'exécution de votre code client de manière à enregistrer votre appareil en mode PRODUCTION. + +Pour plus d'informations sur l'API REST, voir [Utilisation des API REST](t_restapi.html). diff --git a/services/mobilepush/nl/fr/t_send_push_notifications.md b/services/mobilepush/nl/fr/t_send_push_notifications.md index b766e0bd1..2665099cf 100644 --- a/services/mobilepush/nl/fr/t_send_push_notifications.md +++ b/services/mobilepush/nl/fr/t_send_push_notifications.md @@ -1,38 +1,38 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Envoi de notifications push de base -{: #push-send-notifications} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - -Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base (sans utiliser de balise, de badge, de -contenu supplémentaire ou de fichier son). - -Pour envoyer des notifications push de base, procédez comme suit : - -1. Sélectionnez **Envoyer des notifications** puis choisissez l'option **Envoyer à** appropriée. - -**Remarque **: si vous sélectionnez l'option **Tous les appareils**, tous les appareils qui sont abonnés à des notifications de type {{site.data.keyword.mobilepushshort}} recevront les notifications. - -![Ecran Notifications](images/tag_notification.jpg) -2. Dans la zone **Message**, entrez votre message puis cliquez sur **Envoyer**. - -3. Vérifiez que vos appareils ont reçu votre notification. L'image suivante présente une boîte de dialogue d'alerte qui traite une notification de type {{site.data.keyword.mobilepushshort}} s'exécutant au premier plan sur un appareil Android et iOS. - -![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) - -![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) - -La capture d'écran suivante présente une notification de type {{site.data.keyword.mobilepushshort}} qui s'exécute en arrière-plan sur un appareil Android. - -![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Envoi de notifications push de base +{: #push-send-notifications} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + +Une fois que vous avez développé vos applications, vous pouvez envoyer des notifications push de base (sans utiliser de balise, de badge, de +contenu supplémentaire ou de fichier son). + +Pour envoyer des notifications push de base, procédez comme suit : + +1. Sélectionnez **Envoyer des notifications** puis choisissez l'option **Envoyer à** appropriée. + +**Remarque **: si vous sélectionnez l'option **Tous les appareils**, tous les appareils qui sont abonnés à des notifications de type {{site.data.keyword.mobilepushshort}} recevront les notifications. + +![Ecran Notifications](images/tag_notification.jpg) +2. Dans la zone **Message**, entrez votre message puis cliquez sur **Envoyer**. + +3. Vérifiez que vos appareils ont reçu votre notification. L'image suivante présente une boîte de dialogue d'alerte qui traite une notification de type {{site.data.keyword.mobilepushshort}} s'exécutant au premier plan sur un appareil Android et iOS. + +![Notification push qui s'exécute au premier plan sur un appareil Android](images/Android_Screenshot.jpg) + +![Notification push qui s'exécute au premier plan sur un appareil iOS](images/iOS_Screenshot.jpg) + +La capture d'écran suivante présente une notification de type {{site.data.keyword.mobilepushshort}} qui s'exécute en arrière-plan sur un appareil Android. + +![Notification push qui s'exécute en arrière-plan sur un appareil Android](images/background.jpg) diff --git a/services/mobilepush/nl/fr/t_service_instance.md b/services/mobilepush/nl/fr/t_service_instance.md index 0af8edffc..13674eab0 100644 --- a/services/mobilepush/nl/fr/t_service_instance.md +++ b/services/mobilepush/nl/fr/t_service_instance.md @@ -1,48 +1,48 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Création d'une instance de service push -{: #create-push-instance} - -Avant d'utiliser {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, vous devez créer une application {{site.data.keyword.Bluemix}} ; par exemple, une appli Node.js. Ensuite, vous créez une instance d'un service Push, {{site.data.keyword.mobilepushfull}}, qui doit être liée à cette application Bluemix. Pour ce faire, vous pouvez aussi accéder à la section Conteneurs boilerplate du catalogue Bluemix et cliquer sur MobileFirst Services Starter. - -**Remarque** : Si vous avez configuré vos organisations pour qu'elles gèrent votre environnement, sélectionnez l'organisation dans laquelle créer le contexte -d'exécution et les services pour votre application mobile. - - -1. Si vous ne disposez pas d'une application Bluemix, vous devez en créer une, par exemple, une appli Node.js. Pour créer une application Bluemix, -accédez au tableau de bord Bluemix et cliquez sur **Créer une appli**. - - **Remarque** : Si vous disposez d'une application, passez à l'étape 7 pour ajouter un service.![Créer une instance de service](images/create_service_instance1.jpg "Créer une instance de service") - -1. Depuis **Choix de votre modèle d'application**, cliquez sur **WEB**. - -3. Dans la zone **Choix du point de départ**, sélectionnez **SDK for Node.js**, puis cliquez sur **CONTINUER**.![Point de départ](images/create_service_nodejs2.jpg). - -4. Dans le menu déroulant **Espace**, sélectionnez l'espace de votre organisation. - - ![ -Select organization space](images/create_a_service3.jpg) -1. Dans la zone **Nom**, entrez le nom de votre application et dans la zone Hôte, entrez le nom de l'hôte. - -1. Dans le menu déroulant **Plan sélectionné**, sélectionnez un plan, puis cliquez sur le bouton **CREER**. Attendez que l'application soit constituée. - -1. Cliquez sur le lien **Vue d'ensemble**.![Ajouter un service](images/create_service_add4.jpg) -1. Cliquez sur **Ajouter un service**. L'écran CATALOGUE s'affiche. - -1. Sélectionnez **IBM Push Notifications** et depuis le menu déroulant **Espace**, sélectionnez votre organisation. - - ![Menu déroulant Espace d'organisation](images/create_service_org.jpg) -1. Dans la zone **Nom du service**, entrez le nom du service de notifications push. - -1. Dans le menu **Plan sélectionné**, sélectionnez un plan et cliquez sur le bouton **CREER**. - -1. Cliquez sur **Oui** pour reconstituer l'application. - - ![Service IBM Push Notification](images/create_service_notification5.jpg) - -1. Cliquez sur **Notifications push** pour afficher le tableau de bord de notification push. +--- + +copyright: + years: 2015, 2016 + +--- + +# Création d'une instance de service push +{: #create-push-instance} + +Avant d'utiliser {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, vous devez créer une application {{site.data.keyword.Bluemix}} ; par exemple, une appli Node.js. Ensuite, vous créez une instance d'un service Push, {{site.data.keyword.mobilepushfull}}, qui doit être liée à cette application Bluemix. Pour ce faire, vous pouvez aussi accéder à la section Conteneurs boilerplate du catalogue Bluemix et cliquer sur MobileFirst Services Starter. + +**Remarque** : Si vous avez configuré vos organisations pour qu'elles gèrent votre environnement, sélectionnez l'organisation dans laquelle créer le contexte +d'exécution et les services pour votre application mobile. + + +1. Si vous ne disposez pas d'une application Bluemix, vous devez en créer une, par exemple, une appli Node.js. Pour créer une application Bluemix, +accédez au tableau de bord Bluemix et cliquez sur **Créer une appli**. + + **Remarque** : Si vous disposez d'une application, passez à l'étape 7 pour ajouter un service.![Créer une instance de service](images/create_service_instance1.jpg "Créer une instance de service") + +1. Depuis **Choix de votre modèle d'application**, cliquez sur **WEB**. + +3. Dans la zone **Choix du point de départ**, sélectionnez **SDK for Node.js**, puis cliquez sur **CONTINUER**.![Point de départ](images/create_service_nodejs2.jpg). + +4. Dans le menu déroulant **Espace**, sélectionnez l'espace de votre organisation. + + ![ +Select organization space](images/create_a_service3.jpg) +1. Dans la zone **Nom**, entrez le nom de votre application et dans la zone Hôte, entrez le nom de l'hôte. + +1. Dans le menu déroulant **Plan sélectionné**, sélectionnez un plan, puis cliquez sur le bouton **CREER**. Attendez que l'application soit constituée. + +1. Cliquez sur le lien **Vue d'ensemble**.![Ajouter un service](images/create_service_add4.jpg) +1. Cliquez sur **Ajouter un service**. L'écran CATALOGUE s'affiche. + +1. Sélectionnez **IBM Push Notifications** et depuis le menu déroulant **Espace**, sélectionnez votre organisation. + + ![Menu déroulant Espace d'organisation](images/create_service_org.jpg) +1. Dans la zone **Nom du service**, entrez le nom du service de notifications push. + +1. Dans le menu **Plan sélectionné**, sélectionnez un plan et cliquez sur le bouton **CREER**. + +1. Cliquez sur **Oui** pour reconstituer l'application. + + ![Service IBM Push Notification](images/create_service_notification5.jpg) + +1. Cliquez sur **Notifications push** pour afficher le tableau de bord de notification push. diff --git a/services/mobilepush/nl/fr/t_subscribe_tags.md b/services/mobilepush/nl/fr/t_subscribe_tags.md index 011dccc48..2f4c50640 100644 --- a/services/mobilepush/nl/fr/t_subscribe_tags.md +++ b/services/mobilepush/nl/fr/t_subscribe_tags.md @@ -1,126 +1,126 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Abonnement à des balises et désabonnement -{: #Subscribe_tags} - -Utilisez les fragments de code ci-après pour permettre à vos appareils de s'abonner à une balise et de s'en désabonner. - -## Android - -Copiez et collez le fragment de code suivant dans votre application mobile Android : - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - -## Cordova - -Copiez et collez le fragment de code suivant dans votre application mobile Cordova : - -``` -var tag = "YourTag"; -MFPPush.subscribe(tag, success, failure); -MFPPush.unsubscribe(tag, success, failure); -``` - -## Objective-C - -Copiez et collez le fragment de code suivant dans votre application mobile Objective-C : - -Utilisez l'API **subscribeToTags** pour vous abonner à une balise. - -``` -[push subscribeToTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - }else{ - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response subscribeStatus]; - [self updateMessage:@"Parsed subscribe status is:"]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -Utilisez l'API **unsubscribeFromTags** pour vous désabonner d'une balise. - -``` -[push unsubscribeFromTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if (error){ - [self updateMessage:error.description]; - } else { - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response unsubscribeStatus]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -## Swift - -Copiez et collez le fragment de code suivant dans votre application mobile Swift : - -**Abonnement à des balises disponibles** - -Utilisez l'API **subscribeToTags** pour vous abonner à une balise. - -``` -push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in - if (error != nil) { - //error while subscribing to tags - } else { - //successfully subscribed to tags var subStatus = response.subscribeStatus(); - } -} -``` - -**Désabonnement de balises** - -Utilisez l'API **unsubscribeFromTags** pour vous désabonner d'une balise. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - - if error.isEmpty { - print( "Response during unsubscribed tags : \(response.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Abonnement à des balises et désabonnement +{: #Subscribe_tags} + +Utilisez les fragments de code ci-après pour permettre à vos appareils de s'abonner à une balise et de s'en désabonner. + +## Android + +Copiez et collez le fragment de code suivant dans votre application mobile Android : + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + +## Cordova + +Copiez et collez le fragment de code suivant dans votre application mobile Cordova : + +``` +var tag = "YourTag"; +MFPPush.subscribe(tag, success, failure); +MFPPush.unsubscribe(tag, success, failure); +``` + +## Objective-C + +Copiez et collez le fragment de code suivant dans votre application mobile Objective-C : + +Utilisez l'API **subscribeToTags** pour vous abonner à une balise. + +``` +[push subscribeToTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + }else{ + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response subscribeStatus]; + [self updateMessage:@"Parsed subscribe status is:"]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +Utilisez l'API **unsubscribeFromTags** pour vous désabonner d'une balise. + +``` +[push unsubscribeFromTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if (error){ + [self updateMessage:error.description]; + } else { + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response unsubscribeStatus]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +## Swift + +Copiez et collez le fragment de code suivant dans votre application mobile Swift : + +**Abonnement à des balises disponibles** + +Utilisez l'API **subscribeToTags** pour vous abonner à une balise. + +``` +push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in + if (error != nil) { + //error while subscribing to tags + } else { + //successfully subscribed to tags var subStatus = response.subscribeStatus(); + } +} +``` + +**Désabonnement de balises** + +Utilisez l'API **unsubscribeFromTags** pour vous désabonner d'une balise. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + + if error.isEmpty { + print( "Response during unsubscribed tags : \(response.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` diff --git a/services/mobilepush/nl/fr/t_use_tags.md b/services/mobilepush/nl/fr/t_use_tags.md index 816777201..6379e9957 100644 --- a/services/mobilepush/nl/fr/t_use_tags.md +++ b/services/mobilepush/nl/fr/t_use_tags.md @@ -1,24 +1,24 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Utilisation de notifications basées sur les balises -{: #using_tags} - - -Les notification basées sur les balises sont des messages de notification qui sont envoyés à tous les appareils abonnés à une balise particulière. Chaque appareil peut s'abonner à un nombre illimité de balises. Cette section explique comment envoyer des notifications basées sur les balises. Les abonnements sont gérés par l'instance de service Bluemix Push Notifications. Lorsqu'une balise est supprimée, toutes les informations qui lui sont associées, y compris ses abonnés et appareils, sont supprimées. Aucun désabonnement automatique n'est requis pour cette balise car elle n'existe plus et aucune action supplémentaire n'est requise depuis le côté client. - -**Avant de commencer** - -Créez des balises sur l'écran **Tag**. Pour plus d'informations sur la création de balises, -voir [Création de balises](t_manage_tags.html). - -1. Dans le tableau de bord **Push Notifications**, cliquez sur l'onglet **Notifications**. -1. Sélectionnez l'option **Tags** pour envoyer des notifications basées sur les balises. -1. Dans la zone **Search** pour le balises, recherchez les balises que vous voulez utiliser, puis cliquez sur le bouton **+Add**.![Ecran Notifications](images/tag_notification.jpg) -1. Accédez à la zone **Create Your Notifications** et dans la zone **Message Text**, entrez le texte à -envoyer dans votre notification. -1. Cliquez sur le bouton **Send**. +--- + +copyright: + years: 2015, 2016 + +--- + +# Utilisation de notifications basées sur les balises +{: #using_tags} + + +Les notification basées sur les balises sont des messages de notification qui sont envoyés à tous les appareils abonnés à une balise particulière. Chaque appareil peut s'abonner à un nombre illimité de balises. Cette section explique comment envoyer des notifications basées sur les balises. Les abonnements sont gérés par l'instance de service Bluemix Push Notifications. Lorsqu'une balise est supprimée, toutes les informations qui lui sont associées, y compris ses abonnés et appareils, sont supprimées. Aucun désabonnement automatique n'est requis pour cette balise car elle n'existe plus et aucune action supplémentaire n'est requise depuis le côté client. + +**Avant de commencer** + +Créez des balises sur l'écran **Tag**. Pour plus d'informations sur la création de balises, +voir [Création de balises](t_manage_tags.html). + +1. Dans le tableau de bord **Push Notifications**, cliquez sur l'onglet **Notifications**. +1. Sélectionnez l'option **Tags** pour envoyer des notifications basées sur les balises. +1. Dans la zone **Search** pour le balises, recherchez les balises que vous voulez utiliser, puis cliquez sur le bouton **+Add**.![Ecran Notifications](images/tag_notification.jpg) +1. Accédez à la zone **Create Your Notifications** et dans la zone **Message Text**, entrez le texte à +envoyer dans votre notification. +1. Cliquez sur le bouton **Send**. diff --git a/services/mobilepush/nl/fr/tr_error_push.md b/services/mobilepush/nl/fr/tr_error_push.md index 311af08df..92f6caaa7 100644 --- a/services/mobilepush/nl/fr/tr_error_push.md +++ b/services/mobilepush/nl/fr/tr_error_push.md @@ -1,205 +1,205 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Message d'erreur de service {{site.data.keyword.mobilepushshort}} -{: #errors} -Dernière mise à jour : 13 février 2017 -{: .last-updated} - - -Les messages d'erreur {{site.data.keyword.mobilepushshort}} suivants sont -renvoyés en réponse aux demandes d'API REST. - -Exemple de réponse contenant une erreur : -``` - { - "message": "Missing APNs credentials", - "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", - "code": "FPWSE0003E" - } -``` - {: codeblock} - -Pour obtenir des informations supplémentaires sur une erreur, recherchez les documents pour le code d'erreur associé. - -## FPWSE0001E -{: #error_fpwse0001e} - -**Explication **: la ressource que vous tentez d'interroger, par exemple une balise ou un abonnement, -n'est pas disponible sur le serveur. - -**Réponse de l'utilisateur **: créez la ressource signalée dans le message. Vous pouvez également fournir l'identifiant correct pour interroger la ressource. - - -## FPWSE0002E -{: #error_fpwse0002e} - -**Explication **: la ressource que vous tentez de créer est déjà disponible sur le serveur. Il peut s'agir d'une étiquette, d'un abonnement, etc. - -**Réponse de l'utilisateur **: créez la ressource avec un identificateur différent. - - -## FPWSE0003E -{: #error_fpwse0003e} - -**Explication **: la configuration requise pour le service {{site.data.keyword.mobilepushshort}} est incomplète. Vous essayez peut-être d'obtenir les données d'identification du service -de notifications Push Apple (APNS) avant qu'elles ne soient configurées. - -**Réponse de l'utilisateur **: vérifiez que le service {{site.data.keyword.mobilepushshort}} a été configuré avec des certificats de sécurité valides pour les APN. Pour -plus d'informations, voir [Configuration des données d'identification pour le service APNS ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](t_push_provider_ios.html){: new_window}. - - -## FPWSE0004E -{: #error_fpwse0004e} - -**Explication **: le corps JSON inclus dans la demande n'est pas valide. - - -**Réponse de l'utilisateur **: veillez à utiliser une syntaxe valide dans la demande. - - - -## FPWSE0005E -{: #error_fpwse0005e} - -**Explication **: la demande adressée au serveur {{site.data.keyword.mobilepushshort}} est incorrecte ou incomplète étant donné que le corps JSON ne contient pas les valeurs de propriété nécessaires pour remplir la demande d'API. Par exemple, un mot de passe n'est pas valide ou un jeton d'appareil manque. - - -**Réponse de l'utilisateur **: examinez le message pour déterminer quelle valeur de propriété est manquante ou non valide et soumettez les informations requises. - - - -## FPWSE0006E -{: #error_fpwse0006e} - -**Explication **: le corps JSON de la demande comporte des paramètres que ne comprend pas le serveur {{site.data.keyword.mobilepushshort}}. - - -**Réponse de l'utilisateur **: vérifiez que le corps JSON dans la demande respecte le format de demande attendu par le serveur {{site.data.keyword.mobilepushshort}}. Pour plus d'informations, voir [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0007E -{: #error_fpwse0007e} - -**Explication **: l'URL de la demande comporte une chaîne de requête avec des paramètres non reconnus. Par exemple, si la demande de suppression de l'abonnement comporte des paramètres autres que deviceId et tagName, cette erreur peut se produire. - - -**Réponse de l'utilisateur **: vérifiez que le corps JSON dans la demande respecte le format de demande attendu par le serveur {{site.data.keyword.mobilepushshort}}. -Pour plus d'informations, voir [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0008E -{: #error_fpwse0008e} - -**Explication **: l'URL de la demande comporte une chaîne de requête avec des paramètres requis manquants. Par exemple, les paramètres deviceId et tagName peuvent être absents de la demande de suppression de l'abonnement. - - -**Réponse de l'utilisateur **: vérifiez que le corps JSON dans la demande respecte le format de demande attendu par le serveur {{site.data.keyword.mobilepushshort}}. -Pour plus d'informations, voir [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0009E -{: #error_fpwse0009e} - -**Explication **: une tentative d'envoi de notifications a été effectuée mais aucun appareil n'est enregistré auprès de l'application. - -**Réponse de l'utilisateur **: vérifiez que des appareils ont été enregistrés auprès de l'application avant de tenter d'envoyer des notifications. - - - -## FPWSE0010E -{: #error_fpwse0010e} - -**Explication **: la demande soumise au serveur a généré une situation d'exception. Il se peut que l'une des conditions suivantes soit à l'origine de l'erreur : - -- Un sous-système interne utilisé par -{{site.data.keyword.mobilepushshort}} ne répond pas. -- La demande a généré une erreur qui ne peut pas être traitée par {{site.data.keyword.mobilepushshort}}. -- Le service {{site.data.keyword.mobilepushshort}} requiert l'attention d'un administrateur. - -**Réponse de l'utilisateur **: relancez la demande. Si le problème persiste, contactez le service de support logiciel IBM. - - - -## FPWSE0011E -{: #error_fpwse0011e} - -**Explication **: l'abonnement à la balise existe déjà sur le serveur. C'est le cas, par -exemple, lorsque vous créez un abonnement qui existe déjà. - -**Réponse de l'utilisateur **: créez l'abonnement avec un nom de balise unique. - - - -## FPWSE0012E -{: #error_fpwse0012e} - -**Explication **: l'abonnement à la balise n'existe pas sur le serveur. Cette erreur -survient lorsqu'une demande d'extraction ou de suppression d'un abonnement qui n'existe pas est soumise. - - -**Réponse de l'utilisateur **: utilisez le nom d'étiquette et l'identificateur d'appareil corrects dans la demande. - - - -## FPWSE0013E -{: #error_fpwse0013e} - -**Explication **: le contenu JSON dans la demande n'est pas valide. - - -**Réponse de l'utilisateur **: vérifiez que le contenu JSON est valide. - - -## FPWSE0025E -{: #error_fpwse0025e} - -**Explication** : Le serveur est actuellement incapable de traiter la demande. - -**Réponse de l'utilisateur** : Soumettez à nouveau la demande plus tard. - - -## FPWSE1007E -{: #error_fpwse1007e} - -**Explication **: le service {{site.data.keyword.mobilepushshort}} a été désactivé pour cette application. Cela -est peut-être dû à la facturation, ou l'application a peut-être été désactivée -par l'administrateur. - - -**Réponse de l'utilisateur **: accédez aux rubriques de Traitement des incidents dans la documentation -Bluemix pour vérifier le statut du service, consultez les informations de traitement des incidents ou les informations sur l'obtention -d'une assistance. - - - -## FPWSE1079E -{: #error_fpwse1079e} - -**Explication **: la valeur de décalage soumise pour l'opération de requête n'est pas valide. - -**Réponse de l'utilisateur **: vérifiez que la valeur de décalage est supérieure ou égale à zéro. - - - -## FPWSE1080E -{: #error_fpwse1080e} - -**Explication **: la valeur de taille soumise pour l'opération de requête n'est pas valide. - -**Réponse de l'utilisateur **: vérifiez que la valeur de taille est supérieure à zéro. - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Message d'erreur de service {{site.data.keyword.mobilepushshort}} +{: #errors} +Dernière mise à jour : 13 février 2017 +{: .last-updated} + + +Les messages d'erreur {{site.data.keyword.mobilepushshort}} suivants sont +renvoyés en réponse aux demandes d'API REST. + +Exemple de réponse contenant une erreur : +``` + { + "message": "Missing APNs credentials", + "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", + "code": "FPWSE0003E" + } +``` + {: codeblock} + +Pour obtenir des informations supplémentaires sur une erreur, recherchez les documents pour le code d'erreur associé. + +## FPWSE0001E +{: #error_fpwse0001e} + +**Explication **: la ressource que vous tentez d'interroger, par exemple une balise ou un abonnement, +n'est pas disponible sur le serveur. + +**Réponse de l'utilisateur **: créez la ressource signalée dans le message. Vous pouvez également fournir l'identifiant correct pour interroger la ressource. + + +## FPWSE0002E +{: #error_fpwse0002e} + +**Explication **: la ressource que vous tentez de créer est déjà disponible sur le serveur. Il peut s'agir d'une étiquette, d'un abonnement, etc. + +**Réponse de l'utilisateur **: créez la ressource avec un identificateur différent. + + +## FPWSE0003E +{: #error_fpwse0003e} + +**Explication **: la configuration requise pour le service {{site.data.keyword.mobilepushshort}} est incomplète. Vous essayez peut-être d'obtenir les données d'identification du service +de notifications Push Apple (APNS) avant qu'elles ne soient configurées. + +**Réponse de l'utilisateur **: vérifiez que le service {{site.data.keyword.mobilepushshort}} a été configuré avec des certificats de sécurité valides pour les APN. Pour +plus d'informations, voir [Configuration des données d'identification pour le service APNS ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](t_push_provider_ios.html){: new_window}. + + +## FPWSE0004E +{: #error_fpwse0004e} + +**Explication **: le corps JSON inclus dans la demande n'est pas valide. + + +**Réponse de l'utilisateur **: veillez à utiliser une syntaxe valide dans la demande. + + + +## FPWSE0005E +{: #error_fpwse0005e} + +**Explication **: la demande adressée au serveur {{site.data.keyword.mobilepushshort}} est incorrecte ou incomplète étant donné que le corps JSON ne contient pas les valeurs de propriété nécessaires pour remplir la demande d'API. Par exemple, un mot de passe n'est pas valide ou un jeton d'appareil manque. + + +**Réponse de l'utilisateur **: examinez le message pour déterminer quelle valeur de propriété est manquante ou non valide et soumettez les informations requises. + + + +## FPWSE0006E +{: #error_fpwse0006e} + +**Explication **: le corps JSON de la demande comporte des paramètres que ne comprend pas le serveur {{site.data.keyword.mobilepushshort}}. + + +**Réponse de l'utilisateur **: vérifiez que le corps JSON dans la demande respecte le format de demande attendu par le serveur {{site.data.keyword.mobilepushshort}}. Pour plus d'informations, voir [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0007E +{: #error_fpwse0007e} + +**Explication **: l'URL de la demande comporte une chaîne de requête avec des paramètres non reconnus. Par exemple, si la demande de suppression de l'abonnement comporte des paramètres autres que deviceId et tagName, cette erreur peut se produire. + + +**Réponse de l'utilisateur **: vérifiez que le corps JSON dans la demande respecte le format de demande attendu par le serveur {{site.data.keyword.mobilepushshort}}. +Pour plus d'informations, voir [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0008E +{: #error_fpwse0008e} + +**Explication **: l'URL de la demande comporte une chaîne de requête avec des paramètres requis manquants. Par exemple, les paramètres deviceId et tagName peuvent être absents de la demande de suppression de l'abonnement. + + +**Réponse de l'utilisateur **: vérifiez que le corps JSON dans la demande respecte le format de demande attendu par le serveur {{site.data.keyword.mobilepushshort}}. +Pour plus d'informations, voir [API REST ![Icône de lien externe](../../icons/launch-glyph.svg "Icône de lien externe")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0009E +{: #error_fpwse0009e} + +**Explication **: une tentative d'envoi de notifications a été effectuée mais aucun appareil n'est enregistré auprès de l'application. + +**Réponse de l'utilisateur **: vérifiez que des appareils ont été enregistrés auprès de l'application avant de tenter d'envoyer des notifications. + + + +## FPWSE0010E +{: #error_fpwse0010e} + +**Explication **: la demande soumise au serveur a généré une situation d'exception. Il se peut que l'une des conditions suivantes soit à l'origine de l'erreur : + +- Un sous-système interne utilisé par +{{site.data.keyword.mobilepushshort}} ne répond pas. +- La demande a généré une erreur qui ne peut pas être traitée par {{site.data.keyword.mobilepushshort}}. +- Le service {{site.data.keyword.mobilepushshort}} requiert l'attention d'un administrateur. + +**Réponse de l'utilisateur **: relancez la demande. Si le problème persiste, contactez le service de support logiciel IBM. + + + +## FPWSE0011E +{: #error_fpwse0011e} + +**Explication **: l'abonnement à la balise existe déjà sur le serveur. C'est le cas, par +exemple, lorsque vous créez un abonnement qui existe déjà. + +**Réponse de l'utilisateur **: créez l'abonnement avec un nom de balise unique. + + + +## FPWSE0012E +{: #error_fpwse0012e} + +**Explication **: l'abonnement à la balise n'existe pas sur le serveur. Cette erreur +survient lorsqu'une demande d'extraction ou de suppression d'un abonnement qui n'existe pas est soumise. + + +**Réponse de l'utilisateur **: utilisez le nom d'étiquette et l'identificateur d'appareil corrects dans la demande. + + + +## FPWSE0013E +{: #error_fpwse0013e} + +**Explication **: le contenu JSON dans la demande n'est pas valide. + + +**Réponse de l'utilisateur **: vérifiez que le contenu JSON est valide. + + +## FPWSE0025E +{: #error_fpwse0025e} + +**Explication** : Le serveur est actuellement incapable de traiter la demande. + +**Réponse de l'utilisateur** : Soumettez à nouveau la demande plus tard. + + +## FPWSE1007E +{: #error_fpwse1007e} + +**Explication **: le service {{site.data.keyword.mobilepushshort}} a été désactivé pour cette application. Cela +est peut-être dû à la facturation, ou l'application a peut-être été désactivée +par l'administrateur. + + +**Réponse de l'utilisateur **: accédez aux rubriques de Traitement des incidents dans la documentation +Bluemix pour vérifier le statut du service, consultez les informations de traitement des incidents ou les informations sur l'obtention +d'une assistance. + + + +## FPWSE1079E +{: #error_fpwse1079e} + +**Explication **: la valeur de décalage soumise pour l'opération de requête n'est pas valide. + +**Réponse de l'utilisateur **: vérifiez que la valeur de décalage est supérieure ou égale à zéro. + + + +## FPWSE1080E +{: #error_fpwse1080e} + +**Explication **: la valeur de taille soumise pour l'opération de requête n'est pas valide. + +**Réponse de l'utilisateur **: vérifiez que la valeur de taille est supérieure à zéro. + + + diff --git a/services/mobilepush/nl/fr/troubleshooting.md b/services/mobilepush/nl/fr/troubleshooting.md index f3023233b..67601473b 100644 --- a/services/mobilepush/nl/fr/troubleshooting.md +++ b/services/mobilepush/nl/fr/troubleshooting.md @@ -1,52 +1,52 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Traitement des incidents -{: #errors} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - -Utilisez cette section pour traiter les incidents courants liés aux notifications de type {{site.data.keyword.mobilepushshort}}. - - -### Une erreur serveur interne s'est produite. Veuillez contacter l'administrateur. (Code d'erreur interne : PUSHD102E) - -**Explication** : Cette erreur peut se produire si vous avez créé une instance push avant le mois de novembre 2015. - -**Réponse de l'utilisateur **: pour résoudre ce problème, supprimez l'instance push et créez-en une nouvelle. Notez que lorsque vous supprimez l'instance push, vos balises ne sont pas conservées. - - -### UnauthorizedRegistration - -**Explication** : Chrome Web Push ne fonctionne pas avec les clés de Firebase Cloud Messaging (FCM). Si vous ne parvenez pas à recevoir des notifications push Web sur Chrome après avoir migré vers FCM à partir de GCM, c'est parce que le site Web a été configuré pour fonctionner avec le projet GCM et que le nouveau projet est créé dans FCM. Les jetons générés qui identifient le navigateur sont mis en cache par le navigateur Chrome. - -**Réponse de l'utilisateur **: vous pouvez résoudre ce problème en supprimant les cookies et en redéfinissant les autorisations du -navigateur. Cela demanderait des autorisations pour activer les notifications Push. - - -### Les agents de service ne sont pas pris en charge dans ce navigateur - -**Explication **: Le SDK inclus avec `BMSPushSDK.js` et utilisant l'agent de service n'est pas disponible. - -**Réponse utilisateur **: Il est recommandé d'adopter un navigateur prenant en charge l'agent de service. Les versions de navigateur prises en -charge sont Firefox version 49 (ou ultérieure) et Chrome (64 bits) version 53 (ou ultérieure). - - -### SecurityError : L'opération n'est pas sécurisée - -**Explication ** : Vous pourriez rencontrer cette erreur lors de l'activation de la console Web dans -Firefox. La prise en charge de notifications Web push dans le service Push Notification requiert d'accéder au site Web avec le protocole -`https` et non pas `http`. - -**Réponse utilisateur **: Il est recommandé d'essayer de vous connecter au site Web sous -`https` depuis le navigateur. - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Traitement des incidents +{: #errors} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + +Utilisez cette section pour traiter les incidents courants liés aux notifications de type {{site.data.keyword.mobilepushshort}}. + + +### Une erreur serveur interne s'est produite. Veuillez contacter l'administrateur. (Code d'erreur interne : PUSHD102E) + +**Explication** : Cette erreur peut se produire si vous avez créé une instance push avant le mois de novembre 2015. + +**Réponse de l'utilisateur **: pour résoudre ce problème, supprimez l'instance push et créez-en une nouvelle. Notez que lorsque vous supprimez l'instance push, vos balises ne sont pas conservées. + + +### UnauthorizedRegistration + +**Explication** : Chrome Web Push ne fonctionne pas avec les clés de Firebase Cloud Messaging (FCM). Si vous ne parvenez pas à recevoir des notifications push Web sur Chrome après avoir migré vers FCM à partir de GCM, c'est parce que le site Web a été configuré pour fonctionner avec le projet GCM et que le nouveau projet est créé dans FCM. Les jetons générés qui identifient le navigateur sont mis en cache par le navigateur Chrome. + +**Réponse de l'utilisateur **: vous pouvez résoudre ce problème en supprimant les cookies et en redéfinissant les autorisations du +navigateur. Cela demanderait des autorisations pour activer les notifications Push. + + +### Les agents de service ne sont pas pris en charge dans ce navigateur + +**Explication **: Le SDK inclus avec `BMSPushSDK.js` et utilisant l'agent de service n'est pas disponible. + +**Réponse utilisateur **: Il est recommandé d'adopter un navigateur prenant en charge l'agent de service. Les versions de navigateur prises en +charge sont Firefox version 49 (ou ultérieure) et Chrome (64 bits) version 53 (ou ultérieure). + + +### SecurityError : L'opération n'est pas sécurisée + +**Explication ** : Vous pourriez rencontrer cette erreur lors de l'activation de la console Web dans +Firefox. La prise en charge de notifications Web push dans le service Push Notification requiert d'accéder au site Web avec le protocole +`https` et non pas `http`. + +**Réponse utilisateur **: Il est recommandé d'essayer de vous connecter au site Web sous +`https` depuis le navigateur. + diff --git a/services/mobilepush/nl/fr/troubleshooting_config_errors.md b/services/mobilepush/nl/fr/troubleshooting_config_errors.md index 60aec87a2..22f820756 100644 --- a/services/mobilepush/nl/fr/troubleshooting_config_errors.md +++ b/services/mobilepush/nl/fr/troubleshooting_config_errors.md @@ -1,49 +1,49 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Résolution des erreurs de configuration push Web -{: #errors} -Dernière mise à jour : 11 janvier 2017 -{: .last-updated} - -Utilisez cette section comme guide pour résoudre des erreurs de configuration courantes associées aux notifications push Web. Les erreurs Web push de -`BMSPushSDK.js` contiennent des informations sur l'échec. - -Examinez l'exemple de code suivant pour analyser une erreur renvoyée dans le rappel : - -``` -function showStatus(response) { - if(response.statusCode == 200 || response.statusCode == 201) { - document.getElementById("status").innerHTML = "Response is " + response.response; - } - else if(response.statusCode == 0) { - if(response.response) { - document.getElementById("status").innerHTML = response.response; - } - else { - document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; - } - } - else { - document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " - + response.error + " and the status code " + response.statusCode; - } - } -``` - {: codeblock} - - -- Si l'ID d'application (`applicationId`) est configuré incorrectement, la demande initiale au service -{{site.data.keyword.mobilepushshort}} échouera et donc son code de statut (statusCode) recevra la valeur zéro (0). -- Un code de statut 200 ou 201 dénote une réponse réussie. -- Si la valeur confidentielle (`clientSecret`) n'est pas valide, une réponse 401 est affectée à statusCode. L'élément -`response.reponse` contiendra une description de l'erreur. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Résolution des erreurs de configuration push Web +{: #errors} +Dernière mise à jour : 11 janvier 2017 +{: .last-updated} + +Utilisez cette section comme guide pour résoudre des erreurs de configuration courantes associées aux notifications push Web. Les erreurs Web push de +`BMSPushSDK.js` contiennent des informations sur l'échec. + +Examinez l'exemple de code suivant pour analyser une erreur renvoyée dans le rappel : + +``` +function showStatus(response) { + if(response.statusCode == 200 || response.statusCode == 201) { + document.getElementById("status").innerHTML = "Response is " + response.response; + } + else if(response.statusCode == 0) { + if(response.response) { + document.getElementById("status").innerHTML = response.response; + } + else { + document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; + } + } + else { + document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " + + response.error + " and the status code " + response.statusCode; + } + } +``` + {: codeblock} + + +- Si l'ID d'application (`applicationId`) est configuré incorrectement, la demande initiale au service +{{site.data.keyword.mobilepushshort}} échouera et donc son code de statut (statusCode) recevra la valeur zéro (0). +- Un code de statut 200 ou 201 dénote une réponse réussie. +- Si la valeur confidentielle (`clientSecret`) n'est pas valide, une réponse 401 est affectée à statusCode. L'élément +`response.reponse` contiendra une description de l'erreur. diff --git a/services/mobilepush/nl/it/c_advance_notifications.md b/services/mobilepush/nl/it/c_advance_notifications.md index a14738ab3..1946668c3 100644 --- a/services/mobilepush/nl/it/c_advance_notifications.md +++ b/services/mobilepush/nl/it/c_advance_notifications.md @@ -1,12 +1,12 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# Abilitazione delle notifiche di push avanzate -{: #push-advanced-notifications-main} - -Configura un badge iOS, audio, payload JSON aggiuntivo, notifiche operative e notifiche messe in pausa. +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# Abilitazione delle notifiche di push avanzate +{: #push-advanced-notifications-main} + +Configura un badge iOS, audio, payload JSON aggiuntivo, notifiche operative e notifiche messe in pausa. diff --git a/services/mobilepush/nl/it/c_android_enable.md b/services/mobilepush/nl/it/c_android_enable.md index bcf5d0917..4b03abfdb 100755 --- a/services/mobilepush/nl/it/c_android_enable.md +++ b/services/mobilepush/nl/it/c_android_enable.md @@ -1,365 +1,365 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Abilitazione delle applicazioni Android alla ricezione di {{site.data.keyword.mobilepushshort}} -{: #tag_based_notifications} -Ultimo aggiornamento: 14 febbraio 2017 -{: .last-updated} - -Puoi abilitare le applicazioni Android a ricevere le notifiche di push ai tuoi dispositivi. Android Studio è un prerequisito ed è il metodo raccomandato per creare progetti Android. Una conoscenza di base di Android Studio è essenziale. - -## Installazione del Push SDK client con Gradle -{: #android_install} - -Questa sezione descrive come installare e utilizzare il Push SDK client per sviluppare ulteriormente le tue applicazioni Android. - -Il Push SDK dei servizi mobili Bluemix® può essere aggiunto utilizzando Gradle. Gradle scarica automaticamente le risorse dai repository e le rende disponibili alla tua applicazione Android. Assicurati di impostare correttamente Android Studio e Android Studio SDK. Per ulteriori informazioni su come impostare il tuo sistema, consulta la [Panoramica di Android Studio![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](https://developer.android.com/tools/studio/index.html){: new_window}. Per informazioni su Gradle, vedi [Configuring Gradle Builds ![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}. - -Dopo aver creato e aperto la tua applicazione mobile, completa la seguente procedura utilizzando Android Studio. - -1. Aggiungi le dipendenze al tuo file **build.gradle** di livello del modulo. - - - Aggiungi la seguente dipendenza per includere il client di push dei servizi Bluemix™ Mobile e l'SDK dei servizi Google Play alle tue dipendenze dell'ambito di compilazione. - ``` - com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ - ``` - {: codeblock} - - - Aggiungi le seguenti dipendenze per importare le istruzioni obbligatorie per i frammenti di codice. - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - {: codeblock} - - - Aggiungi le seguenti dipendenze alla fine del tuo file **build.gradle** di livello del modulo. - ``` - apply plugin: 'com.google.gms.google-services' - ``` - {: codeblock} -3. Aggiungi le seguenti dipendenze al tuo file **build.gradle** di livello del progetto. -``` -dependencies { - classpath 'com.android.tools.build:gradle:2.2.3' - classpath 'com.google.gms:google-services:3.0.0' -} -``` - {: codeblock} -5. Nel file **AndroidManifest.xml**, aggiungi le seguenti autorizzazioni. Per visualizzare un manifest di esempio, vedi [Applicazione di esempio helloPush Android ![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}. Per visualizzare un file Gradle di esempio, vedi [Sample Build Gradle file ![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}. -``` - - - - - -``` - {: codeblock} - Leggi ulteriori informazioni sulle [Autorizzazioni Android ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](http://developer.android.com/guide/topics/security/permissions.html){: new_window} qui. - -4. Aggiungi le impostazioni di intento di notifica per l'attività. Questa impostazione avvia l'applicazione - quando l'utente fa clic sulla notifica ricevuta dall'area di notifica. -``` - - - - -``` - {: codeblock} -**Nota**: sostituisci *Your_Android_Package_Name* nell'azione sopra indicata con il nome del pacchetto applicazione utilizzato nella tua applicazione. - -5. Aggiungi il servizio di intento FCM (Firebase Cloud Messaging) o GCM (Google Cloud Messaging) e i filtri di intento per le notifiche di evento RECEIVE e REGISTRATION. -``` - - - - - - - - - - -``` - {: codeblock} - -6. Il servizio {{site.data.keyword.mobilepushshort}} supporta il richiamo di notifiche individuali dalla barra di notifica. Per le notifiche a cui accede la barra di notifica, ti viene fornito un gestore solo per la notifica su cui stai facendo clic. Vengono visualizzate tutte le notifiche quando l'applicazione viene aperta manualmente. Aggiorna il tuo file **AndroidManifest.xml** con il seguente frammento per utilizzare questa funzionalità: - -``` - -``` - {: codeblock} - -Per configurare il progetto FCM e ottenere le tue credenziali, consulta [Come ottenere il tuo ID mittente e la chiave API](t_push_provider_android.html). Completa la seguente procedura utilizzando la console FCM (Firebase Cloud Messaging). - -1. Nella console Firebase, fai clic sull'icona **Impostazioni progetto**. - ![Impostazioni progetto Firebase](images/FCM_4.jpg) - -3. Seleziona **AGGIUNGI APPLICAZIONE** o l'**icona Aggiungi Firebase alla tua applicazione Android** dalla scheda Generale nel pannello Tue applicazioni. - ![Aggiunta di Firebase a Android](images/FCM_5.jpg) - -4. Nella finestra Aggiungi Firebase alla tua applicazione Android, aggiungi **com.ibm.mobilefirstplatform.clientsdk.android.push** come nome pacchetto. Il campo Nome alternativo applicazione è facoltativo. Fai clic su **AGGIUNGI APPLICAZIONE**. - ![Finestra Aggiunta di Firebase al tuo Android](images/FCM_1.jpg) - -5. Includi il nome pacchetto della tua applicazione immettendolo nella finestra Aggiungi Firebase alla tua applicazione Android. Il campo Nome alternativo applicazione è facoltativo. Fai clic su **AGGIUNGI APPLICAZIONE**. - - ![Aggiunta del nome pacchetto della tua applicazione](images/FCM_2.jpg) - -6. Viene generato il file `google-services.json`. Copia il file `google-services.json` nella directory root del modulo della tua applicazione Android. Nota che il file `google-service.json` include i nomi dei pacchetti aggiunti. - - ![Aggiunta del file json alla directory root della tua applicazione](images/FCM_7.jpg) - -5. Nella finestra Aggiungi Firebase alla tua applicazione Android, fai clic su **Continua** e quindi su **Fine**. - - - -Crea ed esegui la tua applicazione. - -## Inizializzazione di Push SDK per applicazioni Android -{: #android_initialize} - -Un posto comune dove inserire il codice di inizializzazione è nel metodo onCreate dell'attività principale nella tua applicazione Android. Esistono due componenti per la SDK che deve essere inizializzata. Uno è la SDK core e l'altro è la SDK push creata all'inizio della SDK core. - -###Inizializza il Core SDK - -``` -// Inizializza l'SDK per Android - BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); -``` - {: codeblock} - -####bluemixRegionSuffix -{: bluemixRegionSuffix} - -Specifica l'ubicazione in cui è ospitata l'applicazione. Puoi utilizzare uno dei seguenti tre valori: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -###Inizializza il Push SDK client - -``` -//Inizializza il Push SDK for Java client -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext(), "appGUID", "clientSecret"); -``` - {: codeblock} - -####AppGUID -{: appguid_initialize_client_push_sdk} - -Questa è la chiave AppGUID del servizio {{site.data.keyword.mobilepushshort}}. Questo valore è - sensibile al maiuscolo/minuscolo. Apri il dashboard Push Notification e seleziona la scheda di configurazione. Puoi ottenere questo valore dalle opzioni mobili nella scheda di configurazione del dashboard del servizio Push Notification. - -## Registrazione di dispositivi Android -{: #android_register} - -Utilizza l'API `MFPPush.register()` per registrare il dispositivo con il servizio {{site.data.keyword.mobilepushshort}}. Per registrare le periferiche Android, devi aggiungere le informazioni FCM (Firebase Cloud Messaging) o GCM (Google Cloud Messaging) nel dashboard di configurazione del servizio {{site.data.keyword.mobilepushshort}}. Per ulteriori informazioni, consulta [Configurazione delle credenziali per GCM (Google Cloud Messaging)](t_push_provider_android.html). - -Copia i seguenti frammenti di codice nella tua applicazione mobile Android. - -``` - //Registra dispositivi Android - push.registerDevice(new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - //gestisce esiti positivi qui - } - @Override - public void onFailure(MFPPushException ex) { - //gestisce esiti negativi qui - } - }); -``` - {: codeblock} - - -``` - //Gestisci la notifica quando arriva - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Gestisci Push Notification - } - }; -``` - {: codeblock} - -## Ricezione di notifiche di push su dispositivi Android -{: #android_receive} - -Per registrare l'oggetto notificationListener con push, richiama il metodo **MFPPush.listen()**. Questo metodo viene di norma richiamato dal metodo **onResume()** dell'attività che sta gestendo le notifiche di push. - -1. Per registrare l'oggetto notificationListener con push, richiama il metodo **listen()**. Questo metodo viene di norma richiamato dai metodi **onResume()** e **onPause** dell'attività che sta gestendo le notifiche di push. - - -``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` - {: codeblock} - - - -``` - @Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} - -2. Crea il progetto ed eseguilo sul dispositivo o sull'emulatore. Quando viene richiamato il metodo onSuccess() per il listener di risposte nel metodo register(), ricevi una conferma che il dispositivo ha eseguito correttamente la registrazione con il servizio {{site.data.keyword.mobilepushshort}}. In questo momento puoi inviare un messaggio come descritto in Invio di notifiche di push di base. -3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. Se l'applicazione è in - primo piano, la notifica viene gestita da **MFPPushNotificationListener**. Se l'applicazione è in background, viene visualizzato un messaggio nella barra di notifica. - -## Monitoraggio di notifiche di push su dispositivi Android -{: #android_monitor} - -Per monitorare lo stato corrente della notifica all'interno dell'applicazione, puoi implementare l'interfaccia `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` e definire il metodo onStatusChange(String messageId, MFPPushNotificationStatus status). - -Il **messageId** è l'identificativo del messaggio inviato dal server. **MFPPushNotificationStatus** definisce lo stato delle notifiche come valori: - -- **RECEIVED** - L'applicazione ha ricevuto la notifica. -- **QUEUED** - L'applicazione mette in coda la notifica per richiamare il listener delle notifiche. -- **OPENED** - L'utente apre la notifica selezionandola dalla barra o avviandola dall'icona dell'applicazione oppure quando l'applicazione è in primo piano. -- **DISMISSED** - L'utente cancella/ignora la notifica nella barra. - -Devi registrare la classe **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** con MFPPush. - -``` - push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { - @Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { - // Handle status change -} - }); -``` - {: codeblock} - - -### In ascolto dello stato DISMISSED - -Puoi scegliere di ascoltare lo stato DISMISSED in una delle seguenti condizioni: - -- Quando l'applicazione è attiva (in esecuzione in primo piano o in background) - - Aggiungi il frammento al tuo file `AndroidManifest.xml`: - -``` - - - - - -``` - {: codeblock} - -- Quando l'applicazione è attiva (in esecuzione in primo piano o in background) e non in esecuzione (chiusa) - -Devi estendere il ricevitore di trasmissione **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** e sovrascrivere il metodo **onReceive()**, dove **MFPPushNotificationStatusListener** deve essere registrato prima di richiamare il metodo **onReceive()** della classe di base. - -``` - public class MyDismissHandler extends MFPPushNotificationDismissHandler { - @Override -public void onReceive(Context context, Intent intent) { - MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { - @Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { - // Handle status change -} - }); -super.onReceive(context, intent); -} - } -``` - {: codeblock} - - -Aggiungi il seguente frammento al tuo file `AndroidManifest.xml`: - -``` - - - - - -``` - {: codeblock} - -## Invio di {{site.data.keyword.mobilepushshort}} di base -{: #send} - -Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base. - -Per inviare notifiche push di base, completa la seguente procedura: - -1. Seleziona **Send Notifications** e componi un messaggio scegliendo l'opzione **Send to**. Le opzioni supportate sono **Device by Tag**, **Device Id**, **User Id**, **Android devices**, **iOS devices**, **Web Notifications** e **All Devices**. -**Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi sottoscritti a {{site.data.keyword.mobilepushshort}} riceveranno le notifiche. -![Schermata notifiche](images/tag_notification.jpg) - -2. Nel campo **Message**, componi il messaggio. Scegli di configurare le impostazioni facoltative come richiesto. -3. Fai clic su **Send**. -3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. - -Il seguente screenshot mostra una casella di avviso che gestisce una notifica push -in primo piano su un dispositivo Android. - -![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) - -Il seguente screenshot mostra una notifica push in background per Android. - -![Notifica push in background su Android](images/background.jpg) - -### Impostazioni Android facoltative per l'invio delle notifiche -{: #send_otpional_setting} - -Puoi anche personalizzare le impostazioni di {{site.data.keyword.mobilepushshort}} per inviare le notifiche ai dispositivi Android. Sono supportate le seguenti opzioni di personalizzazione facoltative. -![Impostazioni personalizzate Android](images/android_custom_settings.jpg) - -- **Chiave di compressione**: le chiavi di compressione solo allegate alle notifiche. Se più notifiche arrivano in sequenza con la stessa chiave di compressione quando il dispositivo è offline, esse vengono compresse. Quando un dispositivo va online, riceve le notifiche dal server FCM/GCM e visualizza solo l'ultima notifica rilevando la stessa chiave di compressione. Se la chiave di compressione non viene inviata, sia il nuovo che il vecchio messaggio vengono archiviati per una consegna successiva. -- **Audio**: indica un file audio da riprodurre al ricevimento di un notifica. Supporta il valore predefinito o il nome della risorsa audio integrata nell'applicazione. -- **Icona**: specifica il nome dell'icona da visualizzare per la notifica. Assicurati di aver fornito l'icona nella cartella res/drawable, con l'applicazione client. -- **Priorità**: specifica le opzioni per l'assegnazione della priorità di consegna dei messaggi. Una priorità `high` o `max` creerà una notifica di avviso, mentre i messaggi di priorità `low` o `default` non apriranno le connessioni di rete in un dispositivo silenzioso. Per i messaggi con l'opzione impostata su `min`, sarà inviata una notifica silenziosa. -- **Visibilità**: puoi scegliere di impostare l'opzione di visibilità della notifica su `public` o `private`. L'opzione `private` limita la visualizzazione pubblica e puoi scegliere di abilitarla se il tuo dispositivo è protetto da un pattern o un pin e le impostazioni di notifica vengono impostate su "Hide sensitive notification content". Quando la visibilità è impostata su `private`, deve essere menzionato un campo "redact". Solo il contenuto specificato nel campo redact sarà mostrato nella schermata di blocco sul dispositivo. Scegliendo `public` sarà possibile leggere le notifiche liberamente. -- **TTL (Time to live)**: questo valore è impostato in secondi. Se questo parametro non viene specificato, il server FCM/GCM archivia il messaggio per quattro settimane e tenterà di consegnarlo. La validità scade dopo quattro settimane. L'intervallo di valori possibile è compreso tra 0 e 2,419,200 secondi. -- **Ritarda quando inattivo**: impostando questo valore su `true` si danno istruzioni al server FCM/GCM di non consegnare la notifica se il dispositivo è inattivo. Imposta questo valore su `false`, per assicurati di consegnare la notifica anche se il dispositivo è inattivo. -- **Sincronizzazione**: impostando questo valore su `true`, le notifiche vengono sincronizzate in tutti i tuoi dispositivi registrati. Se l'utente con un nome utente dispone di più dispositivi con la stessa applicazione installata, la lettura della notifica su un dispositivo assicura l'eliminazione delle notifiche negli altri dispositivi. Devi assicurarti di essere registrato con il servizio {{site.data.keyword.mobilepushshort}} con l'ID utente per questa opzione perché funzioni. -- **Payload addizionale**: specifica i valori di payload personalizzati per le tue notifiche. - - -## Fasi successive -{: #next_steps_tags} - -Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche - basate sulle tag e le opzioni avanzate. - -Aggiungi queste funzioni del servizio push notifications alla tua applicazione. -Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). -Per utilizzare le opzioni di notifica avanzate, vedi [Abilitazione delle notifiche di push avanzate](t_advance_badge_sound_payload.html). +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Abilitazione delle applicazioni Android alla ricezione di {{site.data.keyword.mobilepushshort}} +{: #tag_based_notifications} +Ultimo aggiornamento: 14 febbraio 2017 +{: .last-updated} + +Puoi abilitare le applicazioni Android a ricevere le notifiche di push ai tuoi dispositivi. Android Studio è un prerequisito ed è il metodo raccomandato per creare progetti Android. Una conoscenza di base di Android Studio è essenziale. + +## Installazione del Push SDK client con Gradle +{: #android_install} + +Questa sezione descrive come installare e utilizzare il Push SDK client per sviluppare ulteriormente le tue applicazioni Android. + +Il Push SDK dei servizi mobili Bluemix® può essere aggiunto utilizzando Gradle. Gradle scarica automaticamente le risorse dai repository e le rende disponibili alla tua applicazione Android. Assicurati di impostare correttamente Android Studio e Android Studio SDK. Per ulteriori informazioni su come impostare il tuo sistema, consulta la [Panoramica di Android Studio![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](https://developer.android.com/tools/studio/index.html){: new_window}. Per informazioni su Gradle, vedi [Configuring Gradle Builds ![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}. + +Dopo aver creato e aperto la tua applicazione mobile, completa la seguente procedura utilizzando Android Studio. + +1. Aggiungi le dipendenze al tuo file **build.gradle** di livello del modulo. + + - Aggiungi la seguente dipendenza per includere il client di push dei servizi Bluemix™ Mobile e l'SDK dei servizi Google Play alle tue dipendenze dell'ambito di compilazione. + ``` + com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ + ``` + {: codeblock} + + - Aggiungi le seguenti dipendenze per importare le istruzioni obbligatorie per i frammenti di codice. + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + {: codeblock} + + - Aggiungi le seguenti dipendenze alla fine del tuo file **build.gradle** di livello del modulo. + ``` + apply plugin: 'com.google.gms.google-services' + ``` + {: codeblock} +3. Aggiungi le seguenti dipendenze al tuo file **build.gradle** di livello del progetto. +``` +dependencies { + classpath 'com.android.tools.build:gradle:2.2.3' + classpath 'com.google.gms:google-services:3.0.0' +} +``` + {: codeblock} +5. Nel file **AndroidManifest.xml**, aggiungi le seguenti autorizzazioni. Per visualizzare un manifest di esempio, vedi [Applicazione di esempio helloPush Android ![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}. Per visualizzare un file Gradle di esempio, vedi [Sample Build Gradle file ![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}. +``` + + + + + +``` + {: codeblock} + Leggi ulteriori informazioni sulle [Autorizzazioni Android ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](http://developer.android.com/guide/topics/security/permissions.html){: new_window} qui. + +4. Aggiungi le impostazioni di intento di notifica per l'attività. Questa impostazione avvia l'applicazione + quando l'utente fa clic sulla notifica ricevuta dall'area di notifica. +``` + + + + +``` + {: codeblock} +**Nota**: sostituisci *Your_Android_Package_Name* nell'azione sopra indicata con il nome del pacchetto applicazione utilizzato nella tua applicazione. + +5. Aggiungi il servizio di intento FCM (Firebase Cloud Messaging) o GCM (Google Cloud Messaging) e i filtri di intento per le notifiche di evento RECEIVE e REGISTRATION. +``` + + + + + + + + + + +``` + {: codeblock} + +6. Il servizio {{site.data.keyword.mobilepushshort}} supporta il richiamo di notifiche individuali dalla barra di notifica. Per le notifiche a cui accede la barra di notifica, ti viene fornito un gestore solo per la notifica su cui stai facendo clic. Vengono visualizzate tutte le notifiche quando l'applicazione viene aperta manualmente. Aggiorna il tuo file **AndroidManifest.xml** con il seguente frammento per utilizzare questa funzionalità: + +``` + +``` + {: codeblock} + +Per configurare il progetto FCM e ottenere le tue credenziali, consulta [Come ottenere il tuo ID mittente e la chiave API](t_push_provider_android.html). Completa la seguente procedura utilizzando la console FCM (Firebase Cloud Messaging). + +1. Nella console Firebase, fai clic sull'icona **Impostazioni progetto**. + ![Impostazioni progetto Firebase](images/FCM_4.jpg) + +3. Seleziona **AGGIUNGI APPLICAZIONE** o l'**icona Aggiungi Firebase alla tua applicazione Android** dalla scheda Generale nel pannello Tue applicazioni. + ![Aggiunta di Firebase a Android](images/FCM_5.jpg) + +4. Nella finestra Aggiungi Firebase alla tua applicazione Android, aggiungi **com.ibm.mobilefirstplatform.clientsdk.android.push** come nome pacchetto. Il campo Nome alternativo applicazione è facoltativo. Fai clic su **AGGIUNGI APPLICAZIONE**. + ![Finestra Aggiunta di Firebase al tuo Android](images/FCM_1.jpg) + +5. Includi il nome pacchetto della tua applicazione immettendolo nella finestra Aggiungi Firebase alla tua applicazione Android. Il campo Nome alternativo applicazione è facoltativo. Fai clic su **AGGIUNGI APPLICAZIONE**. + + ![Aggiunta del nome pacchetto della tua applicazione](images/FCM_2.jpg) + +6. Viene generato il file `google-services.json`. Copia il file `google-services.json` nella directory root del modulo della tua applicazione Android. Nota che il file `google-service.json` include i nomi dei pacchetti aggiunti. + + ![Aggiunta del file json alla directory root della tua applicazione](images/FCM_7.jpg) + +5. Nella finestra Aggiungi Firebase alla tua applicazione Android, fai clic su **Continua** e quindi su **Fine**. + + + +Crea ed esegui la tua applicazione. + +## Inizializzazione di Push SDK per applicazioni Android +{: #android_initialize} + +Un posto comune dove inserire il codice di inizializzazione è nel metodo onCreate dell'attività principale nella tua applicazione Android. Esistono due componenti per la SDK che deve essere inizializzata. Uno è la SDK core e l'altro è la SDK push creata all'inizio della SDK core. + +### Inizializza il Core SDK + +``` +// Inizializza l'SDK per Android + BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); +``` + {: codeblock} + +#### bluemixRegionSuffix +{: bluemixRegionSuffix} + +Specifica l'ubicazione in cui è ospitata l'applicazione. Puoi utilizzare uno dei seguenti tre valori: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +### Inizializza il Push SDK client + +``` +//Inizializza il Push SDK for Java client +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext(), "appGUID", "clientSecret"); +``` + {: codeblock} + +#### AppGUID +{: appguid_initialize_client_push_sdk} + +Questa è la chiave AppGUID del servizio {{site.data.keyword.mobilepushshort}}. Questo valore è + sensibile al maiuscolo/minuscolo. Apri il dashboard Push Notification e seleziona la scheda di configurazione. Puoi ottenere questo valore dalle opzioni mobili nella scheda di configurazione del dashboard del servizio Push Notification. + +## Registrazione di dispositivi Android +{: #android_register} + +Utilizza l'API `MFPPush.register()` per registrare il dispositivo con il servizio {{site.data.keyword.mobilepushshort}}. Per registrare le periferiche Android, devi aggiungere le informazioni FCM (Firebase Cloud Messaging) o GCM (Google Cloud Messaging) nel dashboard di configurazione del servizio {{site.data.keyword.mobilepushshort}}. Per ulteriori informazioni, consulta [Configurazione delle credenziali per GCM (Google Cloud Messaging)](t_push_provider_android.html). + +Copia i seguenti frammenti di codice nella tua applicazione mobile Android. + +``` + //Registra dispositivi Android + push.registerDevice(new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + //gestisce esiti positivi qui + } + @Override + public void onFailure(MFPPushException ex) { + //gestisce esiti negativi qui + } + }); +``` + {: codeblock} + + +``` + //Gestisci la notifica quando arriva + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Gestisci Push Notification + } + }; +``` + {: codeblock} + +## Ricezione di notifiche di push su dispositivi Android +{: #android_receive} + +Per registrare l'oggetto notificationListener con push, richiama il metodo **MFPPush.listen()**. Questo metodo viene di norma richiamato dal metodo **onResume()** dell'attività che sta gestendo le notifiche di push. + +1. Per registrare l'oggetto notificationListener con push, richiama il metodo **listen()**. Questo metodo viene di norma richiamato dai metodi **onResume()** e **onPause** dell'attività che sta gestendo le notifiche di push. + + +``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` + {: codeblock} + + + +``` + @Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} + +2. Crea il progetto ed eseguilo sul dispositivo o sull'emulatore. Quando viene richiamato il metodo onSuccess() per il listener di risposte nel metodo register(), ricevi una conferma che il dispositivo ha eseguito correttamente la registrazione con il servizio {{site.data.keyword.mobilepushshort}}. In questo momento puoi inviare un messaggio come descritto in Invio di notifiche di push di base. +3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. Se l'applicazione è in + primo piano, la notifica viene gestita da **MFPPushNotificationListener**. Se l'applicazione è in background, viene visualizzato un messaggio nella barra di notifica. + +## Monitoraggio di notifiche di push su dispositivi Android +{: #android_monitor} + +Per monitorare lo stato corrente della notifica all'interno dell'applicazione, puoi implementare l'interfaccia `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` e definire il metodo onStatusChange(String messageId, MFPPushNotificationStatus status). + +Il **messageId** è l'identificativo del messaggio inviato dal server. **MFPPushNotificationStatus** definisce lo stato delle notifiche come valori: + +- **RECEIVED** - L'applicazione ha ricevuto la notifica. +- **QUEUED** - L'applicazione mette in coda la notifica per richiamare il listener delle notifiche. +- **OPENED** - L'utente apre la notifica selezionandola dalla barra o avviandola dall'icona dell'applicazione oppure quando l'applicazione è in primo piano. +- **DISMISSED** - L'utente cancella/ignora la notifica nella barra. + +Devi registrare la classe **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** con MFPPush. + +``` + push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { + @Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { + // Handle status change +} + }); +``` + {: codeblock} + + +### In ascolto dello stato DISMISSED + +Puoi scegliere di ascoltare lo stato DISMISSED in una delle seguenti condizioni: + +- Quando l'applicazione è attiva (in esecuzione in primo piano o in background) + + Aggiungi il frammento al tuo file `AndroidManifest.xml`: + +``` + + + + + +``` + {: codeblock} + +- Quando l'applicazione è attiva (in esecuzione in primo piano o in background) e non in esecuzione (chiusa) + +Devi estendere il ricevitore di trasmissione **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** e sovrascrivere il metodo **onReceive()**, dove **MFPPushNotificationStatusListener** deve essere registrato prima di richiamare il metodo **onReceive()** della classe di base. + +``` + public class MyDismissHandler extends MFPPushNotificationDismissHandler { + @Override +public void onReceive(Context context, Intent intent) { + MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { + @Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { + // Handle status change +} + }); +super.onReceive(context, intent); +} + } +``` + {: codeblock} + + +Aggiungi il seguente frammento al tuo file `AndroidManifest.xml`: + +``` + + + + + +``` + {: codeblock} + +## Invio di {{site.data.keyword.mobilepushshort}} di base +{: #send} + +Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base. + +Per inviare notifiche push di base, completa la seguente procedura: + +1. Seleziona **Send Notifications** e componi un messaggio scegliendo l'opzione **Send to**. Le opzioni supportate sono **Device by Tag**, **Device Id**, **User Id**, **Android devices**, **iOS devices**, **Web Notifications** e **All Devices**. +**Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi sottoscritti a {{site.data.keyword.mobilepushshort}} riceveranno le notifiche. +![Schermata notifiche](images/tag_notification.jpg) + +2. Nel campo **Message**, componi il messaggio. Scegli di configurare le impostazioni facoltative come richiesto. +3. Fai clic su **Send**. +3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. + +Il seguente screenshot mostra una casella di avviso che gestisce una notifica push +in primo piano su un dispositivo Android. + +![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) + +Il seguente screenshot mostra una notifica push in background per Android. + +![Notifica push in background su Android](images/background.jpg) + +### Impostazioni Android facoltative per l'invio delle notifiche +{: #send_otpional_setting} + +Puoi anche personalizzare le impostazioni di {{site.data.keyword.mobilepushshort}} per inviare le notifiche ai dispositivi Android. Sono supportate le seguenti opzioni di personalizzazione facoltative. +![Impostazioni personalizzate Android](images/android_custom_settings.jpg) + +- **Chiave di compressione**: le chiavi di compressione solo allegate alle notifiche. Se più notifiche arrivano in sequenza con la stessa chiave di compressione quando il dispositivo è offline, esse vengono compresse. Quando un dispositivo va online, riceve le notifiche dal server FCM/GCM e visualizza solo l'ultima notifica rilevando la stessa chiave di compressione. Se la chiave di compressione non viene inviata, sia il nuovo che il vecchio messaggio vengono archiviati per una consegna successiva. +- **Audio**: indica un file audio da riprodurre al ricevimento di un notifica. Supporta il valore predefinito o il nome della risorsa audio integrata nell'applicazione. +- **Icona**: specifica il nome dell'icona da visualizzare per la notifica. Assicurati di aver fornito l'icona nella cartella res/drawable, con l'applicazione client. +- **Priorità**: specifica le opzioni per l'assegnazione della priorità di consegna dei messaggi. Una priorità `high` o `max` creerà una notifica di avviso, mentre i messaggi di priorità `low` o `default` non apriranno le connessioni di rete in un dispositivo silenzioso. Per i messaggi con l'opzione impostata su `min`, sarà inviata una notifica silenziosa. +- **Visibilità**: puoi scegliere di impostare l'opzione di visibilità della notifica su `public` o `private`. L'opzione `private` limita la visualizzazione pubblica e puoi scegliere di abilitarla se il tuo dispositivo è protetto da un pattern o un pin e le impostazioni di notifica vengono impostate su "Hide sensitive notification content". Quando la visibilità è impostata su `private`, deve essere menzionato un campo "redact". Solo il contenuto specificato nel campo redact sarà mostrato nella schermata di blocco sul dispositivo. Scegliendo `public` sarà possibile leggere le notifiche liberamente. +- **TTL (Time to live)**: questo valore è impostato in secondi. Se questo parametro non viene specificato, il server FCM/GCM archivia il messaggio per quattro settimane e tenterà di consegnarlo. La validità scade dopo quattro settimane. L'intervallo di valori possibile è compreso tra 0 e 2,419,200 secondi. +- **Ritarda quando inattivo**: impostando questo valore su `true` si danno istruzioni al server FCM/GCM di non consegnare la notifica se il dispositivo è inattivo. Imposta questo valore su `false`, per assicurati di consegnare la notifica anche se il dispositivo è inattivo. +- **Sincronizzazione**: impostando questo valore su `true`, le notifiche vengono sincronizzate in tutti i tuoi dispositivi registrati. Se l'utente con un nome utente dispone di più dispositivi con la stessa applicazione installata, la lettura della notifica su un dispositivo assicura l'eliminazione delle notifiche negli altri dispositivi. Devi assicurarti di essere registrato con il servizio {{site.data.keyword.mobilepushshort}} con l'ID utente per questa opzione perché funzioni. +- **Payload addizionale**: specifica i valori di payload personalizzati per le tue notifiche. + + +## Fasi successive +{: #next_steps_tags} + +Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche + basate sulle tag e le opzioni avanzate. + +Aggiungi queste funzioni del servizio push notifications alla tua applicazione. +Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). +Per utilizzare le opzioni di notifica avanzate, vedi [Abilitazione delle notifiche di push avanzate](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/it/c_chrome_firefox_enable.md b/services/mobilepush/nl/it/c_chrome_firefox_enable.md index abc6e630d..29e99c4ad 100644 --- a/services/mobilepush/nl/it/c_chrome_firefox_enable.md +++ b/services/mobilepush/nl/it/c_chrome_firefox_enable.md @@ -1,131 +1,131 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Abilitazione delle applicazioni web alla ricezione di {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -Ultimo aggiornamento: 16 febbraio 2017 -{: .last-updated} - -Puoi abilitare le applicazioni web Google Chrome, Mozilla Firefox e Safari a ricevere {{site.data.keyword.mobilepushshort}}. Assicurati di aver consultato [Configurazione delle credenziali per un provider di notifica](t__main_push_config_provider.html) prima di continuare con la procedura. - -## Installazione dell'SDK client del browser web per {{site.data.keyword.mobilepushshort}} -{: #web_install} - -Questo argomento descrive come installare e utilizzare il JavaScript Push SDK client per sviluppare ulteriormente le tue applicazioni Web. - -### Inizializzazione nell'applicazione web - -Per l'installazione dell'SDK Javascript nell'applicazione web Google Chrome completa la seguente procedura: - -Scarica i file `BMSPushSDK.js`, `BMSPushServiceWorker.js` e `manifest_Website.json` dalla [SDK di push web di Bluemix](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. - -1. Modifica il file `manifest_Website.json`. - - Per il browser Google Chrome, modifica `name` con il nome del tuo sito. Ad esempio, `www.dailynewsupdates.com`. Modifica `gcm_sender_id` con il tuo sender_ID FCM (Firebase Cloud Messaging) o GCM (Google Cloud Messaging). Per ulteriori informazioni, consulta [Come ottenere il tuo ID mittente e la chiave API](t_push_provider_android.html). Il valore gcm_sender_id contiene solo numeri. - - ``` - { - "name": "YOUR_WEBSITE_NAME", - "gcm_sender_id": "GCM_Sender_Id" - } - ``` - {: codeblock} - - - Per il browser Mozilla Firefox, aggiungi i seguenti valori nel file `manifest_Website.json`. Fornisci un `name` appropriato. Questo sarà il nome del tuo sito web. - - ``` - { - "name": "YOUR_WEBSITE_NAME" - } - ``` - {: codeblock} - -2. Modifica il nome del file `manifest_Website.json` con `manifest.json`. -3. Aggiungi `BMSPushSDK.js`, `BMSPushServiceWorker.js` e `manifest.json` alla directory root del tuo sito web. -3. Includi `manifest.json` nella tag `` del tuo file html. - ``` - - ``` - {: codeblock} -4. Includi l'SDK di push web Bluemix nella tua applicazione web. - ``` - - ``` - {: codeblock} - -**Nota**: assicurati che il codice venga distribuito e che si acceda al link di esempio utilizzando `https` e non `http`. - -## Inizializzazione della SDK di push web di Bluemix -{: #web_initialize} - -Inizializza la SDK di push con `app GUID` e `app Region` del servizio {{site.data.keyword.mobilepushshort}} di Bluemix. - -Per ottenere il tuo GUID dell'applicazione, seleziona l'opzione **Configurazione** nel pannello di navigazione per i servizi di push inizializzati e fai clic su **Opzioni mobili**. Modifica il frammento di codice per utilizzare il tuo parametro appGUID del servizio di notifiche di push di Bluemix. - -`App Region` specifica l'ubicazione in cui è ospitato il servizio {{site.data.keyword.mobilepushshort}}. Puoi utilizzare uno dei seguenti tre valori: - - - Per Dallas Stati Uniti: `.ng.bluemix.net` - - Per il Regno unito: `.eu-gb.bluemix.net` - - Per Sydney: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(initParams, callback) -``` - {: codeblock} - -**Nota**: se le tue credenziali FCM sono state modificate per l'SDK push Web, la ricezione dei messaggi potrebbe non riuscire per il browser Chrome. Assicurati di richiamare `bmsPush.unRegisterDevice` per evitare errori. - -Se fornisci un parametro errato potresti visualizzare degli errori di configurazione. Per ulteriori informazioni, vedi [Risoluzione degli errori di configurazione push web](troubleshooting_config_errors.html). - -## Registrazione dell'applicazione web -{: #web_register} - -Utilizza l'API **register()** per registrare il dispositivo con il servizio {{site.data.keyword.mobilepushshort}}. Utilizza una delle seguenti opzioni, in base al tuo browser. - -- Per la registrazione da Google Chrome, aggiungi l'URL del sito web e la chiave API di FCM (Firebase Cloud Messaging) o GCM (Google Cloud Messaging) nel dashboard di configurazione web del servizio {{site.data.keyword.mobilepushshort}} di Bluemix. Per ulteriori informazioni, consulta [Configurazione delle credenziali per GCM (Google Cloud Messaging)](t_push_provider_android.html) nelle impostazioni di Chrome. - -- Per la registrazione da Mozilla Firefox, aggiungi l'URL del sito web nel dashboard di configurazione web del servizio {{site.data.keyword.mobilepushshort}} di Bluemix nelle impostazioni di Firefox. - -Utilizza il seguente frammento di codice per registrare il servizio {{site.data.keyword.mobilepushshort}} di Bluemix. - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Abilitazione delle applicazioni web alla ricezione di {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +Ultimo aggiornamento: 16 febbraio 2017 +{: .last-updated} + +Puoi abilitare le applicazioni web Google Chrome, Mozilla Firefox e Safari a ricevere {{site.data.keyword.mobilepushshort}}. Assicurati di aver consultato [Configurazione delle credenziali per un provider di notifica](t__main_push_config_provider.html) prima di continuare con la procedura. + +## Installazione dell'SDK client del browser web per {{site.data.keyword.mobilepushshort}} +{: #web_install} + +Questo argomento descrive come installare e utilizzare il JavaScript Push SDK client per sviluppare ulteriormente le tue applicazioni Web. + +### Inizializzazione nell'applicazione web + +Per l'installazione dell'SDK Javascript nell'applicazione web Google Chrome completa la seguente procedura: + +Scarica i file `BMSPushSDK.js`, `BMSPushServiceWorker.js` e `manifest_Website.json` dalla [SDK di push web di Bluemix](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. + +1. Modifica il file `manifest_Website.json`. + - Per il browser Google Chrome, modifica `name` con il nome del tuo sito. Ad esempio, `www.dailynewsupdates.com`. Modifica `gcm_sender_id` con il tuo sender_ID FCM (Firebase Cloud Messaging) o GCM (Google Cloud Messaging). Per ulteriori informazioni, consulta [Come ottenere il tuo ID mittente e la chiave API](t_push_provider_android.html). Il valore gcm_sender_id contiene solo numeri. + + ``` + { + "name": "YOUR_WEBSITE_NAME", + "gcm_sender_id": "GCM_Sender_Id" + } + ``` + {: codeblock} + + - Per il browser Mozilla Firefox, aggiungi i seguenti valori nel file `manifest_Website.json`. Fornisci un `name` appropriato. Questo sarà il nome del tuo sito web. + + ``` + { + "name": "YOUR_WEBSITE_NAME" + } + ``` + {: codeblock} + +2. Modifica il nome del file `manifest_Website.json` con `manifest.json`. +3. Aggiungi `BMSPushSDK.js`, `BMSPushServiceWorker.js` e `manifest.json` alla directory root del tuo sito web. +3. Includi `manifest.json` nella tag `` del tuo file html. + ``` + + ``` + {: codeblock} +4. Includi l'SDK di push web Bluemix nella tua applicazione web. + ``` + + ``` + {: codeblock} + +**Nota**: assicurati che il codice venga distribuito e che si acceda al link di esempio utilizzando `https` e non `http`. + +## Inizializzazione della SDK di push web di Bluemix +{: #web_initialize} + +Inizializza la SDK di push con `app GUID` e `app Region` del servizio {{site.data.keyword.mobilepushshort}} di Bluemix. + +Per ottenere il tuo GUID dell'applicazione, seleziona l'opzione **Configurazione** nel pannello di navigazione per i servizi di push inizializzati e fai clic su **Opzioni mobili**. Modifica il frammento di codice per utilizzare il tuo parametro appGUID del servizio di notifiche di push di Bluemix. + +`App Region` specifica l'ubicazione in cui è ospitato il servizio {{site.data.keyword.mobilepushshort}}. Puoi utilizzare uno dei seguenti tre valori: + + - Per Dallas Stati Uniti: `.ng.bluemix.net` + - Per il Regno unito: `.eu-gb.bluemix.net` + - Per Sydney: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(initParams, callback) +``` + {: codeblock} + +**Nota**: se le tue credenziali FCM sono state modificate per l'SDK push Web, la ricezione dei messaggi potrebbe non riuscire per il browser Chrome. Assicurati di richiamare `bmsPush.unRegisterDevice` per evitare errori. + +Se fornisci un parametro errato potresti visualizzare degli errori di configurazione. Per ulteriori informazioni, vedi [Risoluzione degli errori di configurazione push web](troubleshooting_config_errors.html). + +## Registrazione dell'applicazione web +{: #web_register} + +Utilizza l'API **register()** per registrare il dispositivo con il servizio {{site.data.keyword.mobilepushshort}}. Utilizza una delle seguenti opzioni, in base al tuo browser. + +- Per la registrazione da Google Chrome, aggiungi l'URL del sito web e la chiave API di FCM (Firebase Cloud Messaging) o GCM (Google Cloud Messaging) nel dashboard di configurazione web del servizio {{site.data.keyword.mobilepushshort}} di Bluemix. Per ulteriori informazioni, consulta [Configurazione delle credenziali per GCM (Google Cloud Messaging)](t_push_provider_android.html) nelle impostazioni di Chrome. + +- Per la registrazione da Mozilla Firefox, aggiungi l'URL del sito web nel dashboard di configurazione web del servizio {{site.data.keyword.mobilepushshort}} di Bluemix nelle impostazioni di Firefox. + +Utilizza il seguente frammento di codice per registrare il servizio {{site.data.keyword.mobilepushshort}} di Bluemix. + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + + + diff --git a/services/mobilepush/nl/it/c_chrome_firefox_enable_send.md b/services/mobilepush/nl/it/c_chrome_firefox_enable_send.md index cadd99686..ebcf4cdb5 100644 --- a/services/mobilepush/nl/it/c_chrome_firefox_enable_send.md +++ b/services/mobilepush/nl/it/c_chrome_firefox_enable_send.md @@ -1,43 +1,43 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Invio di notifiche di base ai browser web -{: #web_notifications} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - -Dopo che hai sviluppato le tue applicazioni, puoi inviare una notifica push. - -1. Seleziona **Send Notifications** e componi un messaggio scegliendo **Web Notifications** come l'opzione **Send To**. -2. Immetti il messaggio che deve essere consegnato nel campo **Message**. -3. Puoi scegliere di fornire delle impostazioni facoltative: - - **Titolo della notifica**: questo è il testo che deve essere visualizzato nell'intestazione dell'avviso del messaggio. - - **URL dell'icona di notifica**: se il tuo messaggio deve essere consegnato con un'icona di notifica dell'applicazione, fornisci il link alla tua icona nel campo. - - **TTL (Time to live)**: notifica al server in merito alla validità dei messaggi. -4. Per le notifiche web inviate al browser Safari, sono richieste delle informazioni aggiuntive: - - **Azione**: si tratta dell'etichetta del pulsante di azione. - - **Argomenti URL**: gli argomenti URL che devono essere utilizzati con questa notifica. Assicurati che vengano forniti in forma di array JSON. - -La seguente immagine mostra l'opzione delle notifiche web nel dashboard. - - ![Schermata notifiche](images/DashboardWebpush.jpg) - - -## Fasi successive - {: #next_steps_tags} - -Dopo che hai correttamente configurato le notifiche di base, puoi scegliere di configurare le notifiche basate sulle tag e le opzioni avanzate. - -Aggiungi queste funzioni del servizio {{site.data.keyword.mobilepushshort}} alla tua applicazione. Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche avanzate](t_advance_badge_sound_payload.html). - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Invio di notifiche di base ai browser web +{: #web_notifications} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + +Dopo che hai sviluppato le tue applicazioni, puoi inviare una notifica push. + +1. Seleziona **Send Notifications** e componi un messaggio scegliendo **Web Notifications** come l'opzione **Send To**. +2. Immetti il messaggio che deve essere consegnato nel campo **Message**. +3. Puoi scegliere di fornire delle impostazioni facoltative: + - **Titolo della notifica**: questo è il testo che deve essere visualizzato nell'intestazione dell'avviso del messaggio. + - **URL dell'icona di notifica**: se il tuo messaggio deve essere consegnato con un'icona di notifica dell'applicazione, fornisci il link alla tua icona nel campo. + - **TTL (Time to live)**: notifica al server in merito alla validità dei messaggi. +4. Per le notifiche web inviate al browser Safari, sono richieste delle informazioni aggiuntive: + - **Azione**: si tratta dell'etichetta del pulsante di azione. + - **Argomenti URL**: gli argomenti URL che devono essere utilizzati con questa notifica. Assicurati che vengano forniti in forma di array JSON. + +La seguente immagine mostra l'opzione delle notifiche web nel dashboard. + + ![Schermata notifiche](images/DashboardWebpush.jpg) + + +## Fasi successive + {: #next_steps_tags} + +Dopo che hai correttamente configurato le notifiche di base, puoi scegliere di configurare le notifiche basate sulle tag e le opzioni avanzate. + +Aggiungi queste funzioni del servizio {{site.data.keyword.mobilepushshort}} alla tua applicazione. Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche avanzate](t_advance_badge_sound_payload.html). + + + diff --git a/services/mobilepush/nl/it/c_cordova_enable.md b/services/mobilepush/nl/it/c_cordova_enable.md index e742f0639..1243c6bab 100755 --- a/services/mobilepush/nl/it/c_cordova_enable.md +++ b/services/mobilepush/nl/it/c_cordova_enable.md @@ -1,320 +1,320 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Abilitazione delle applicazioni Cordova alla ricezione di notifiche di push -{: #cordova_enable} -Ultimo aggiornamento: 18 gennaio 2017 -{: .last-updated} - -Cordova è una piattaforma per creare applicazioni ibride con JavaScript, CSS e HTML. Il servizio {{site.data.keyword.mobilepushshort}} supporta lo sviluppo di applicazioni Android e iOS basate su Cordova. - -Puoi abilitare le applicazioni Cordova a ricevere le notifiche di push ai tuoi dispositivi. - -## Installazione del plugin push Cordova -{: #cordova_install} - -Installa e utilizza il plugin di Push client per sviluppare ulteriormente le tue applicazioni Cordova. Questo installa anche il plugin Cordova core, che inizializza la tua connessione a Bluemix. - -### Prima di cominciare - -1. Scarica le ultime versioni dell'SDK Android Studio e Xcode. -1. Configura il tuo emulatore. Per Android Studio, utilizza un emulatore che supporti l'API Google Play. -1. Installa lo strumento della riga di comando Git. Per Windows, assicurati di selezionare l'opzione **Esegui Git dal prompt dei comandi della finestra**. Per informazioni su come scaricare e installare questo strumento, consulta [Git ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://git-scm.com/downloads "Icona link esterno"){: new_window}. -1. Installa lo strumento Node.js e il gestore pacchetti di nodi (NPM). Lo strumento della riga comandi NPM è integrato con Node.js. Per informazioni su come scaricare e installare Node.js, consulta [Node.js ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://nodejs.org/en/download/ "Icona link esterno"){: new_window}. -1. Dalla riga comandi, installa gli strumenti della riga di comando Cordova utilizzando il comando **npm install -g cordova**. È necessario per utilizzare il plugin Push Cordova. Per informazioni su come installare Cordova e configurare la tua applicazione Cordova, consulta [Cordova Apache ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://cordova.apache.org/#getstarted "Icona link esterno"){: new_window}. Per ulteriori informazioni, vedi il [file readme ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push "Icona link esterno"){: new_window} del plug-in Cordova push. -1. Passa alla cartella in cui vuoi creare la tua applicazione Cordova ed esegui il seguente comando per - creare un'applicazione Cordova. Se hai un'applicazione Cordova esistente, vai al passo 3. -```cordova create your_app_name - cd your_app_name -``` - {: codeblock} -- Facoltativo: puoi modificare il file **config.xml** e modificare il nome dell'applicazione nell'elemento in uno a tua scelta, invece del nome predefinito HelloCordova. - -Assicurati di specificare l'ID bundle corretto. Il seguente messaggio di errore potrebbe essere in Xcode, se viene specificato un ID bundle non corretto. - -* L'eseguibile è stato firmato con diritti non validi. -* I diritti specificati nel tuo file Diritti di firma del codice non corrispondo a quelli specificati nel tuo profilo di provisioning. Per risolvere questo problema, specifica l'ID bundle corretto in Xcode o nel tuo file **config.xml** dell'applicazione Cordova. - -1. Aggiungi la API supportata minima o la dichiarazione di destinazione della distribuzione al file config.xml per la tua applicazione Cordova. Il valore minSdkVersion deve essere maggiore di 15. Il valore targetSdkVersion deve sempre riflettere l'SDK Android più recente disponibile da Google. - - * Android - Con il tuo editor, apri il file **config.xml** e aggiorna l'elemento -`` con le versioni SDK minima e di destinazione: - - ``` - - - - - - ``` - {: codeblock} - - * iOS - Aggiorna l'elemento con una dichiarazione di destinazione della distribuzione: - - ``` - - - - - ``` - {: codeblock} - -1. Dalla CLI (command-line interface) Cordova, aggiungi le tue piattaforme: iOS, Android o entrambe utilizzando il comando: -``` -cordova platform add ios - cordova platform add android -``` - {: codeblock} - -1. Dalla directory root della tua applicazione Cordova, immetti il seguente comando per installare il plugin Cordova push: **cordova plugin add bms-push**. A seconda delle piattaforme da te aggiunte, potresti visualizzare: -``` -Installing "bms-push" for android -Installing "bms-push" for ios -``` - {: codeblock} - -1. Dalla cartella root della tua applicazione, verifica che i plug-in Cordova core e push siano stati installati correttamente utilizzando questo comando: **cordova plugin list**. A seconda delle piattaforme da te aggiunte, potresti visualizzare: -``` -bms-core "BMSCore" -bms-push "BMSPush" -``` - {: codeblock} - -1. Configura il tuo ambiente di sviluppo iOS. -2. Crea ed esegui la tua applicazione con Xcode. -1. Scarica il tuo Firebase `google-services.json` per Android e inseriscilo nella cartella root del tuo progetto Cordova, in `[your-app-name]/platforms/android. - 1. Vai a `[your-app-name]/platforms/android`. - 2. Apri il file `build.gradle` (Percorso : platform > android > build.gradle). - 3. Trova il testo `buildscript` nel file `build.gradle`. - 4. Dopo la riga del classpath, aggiungi la riga classpath 'com.google.gms:google-services:3.0.0' - 5. Trova quindi "dependencies". Seleziona le dipendenze in cui è presente il testo `compile` e subito dopo il punto in cui terminano queste dipendenze aggiungi la riga :apply plugin: 'com.google.gms.google-services'. - 6. Prepara e crea il tuo progetto Android Cordova. - ``` - cordova prepare android - cordova build android - ``` - {: codeblock} - **Nota**: prima di aprire il tuo progetto in Android Studio, devi creare la tua applicazione Cordova con la CLI di Cordova. Questo aiuterà nel prevenire errori di generazione. - -## Inizializzazione del plugin Cordova -{: #cordova_initialize} - -Prima di poter utilizzare il plugin Cordova del servizio {{site.data.keyword.mobilepushshort}}, devi inizializzarlo passando la rotta e il GUID dell'applicazione. Dopo che hai inizializzato il plugin, puoi stabilire una connessione all'applicazione server che hai creato nel dashboard Bluemix. Il plugin Cordova è il contenitore per gli SDK client Android e iOS per abilitare un'applicazione Cordova a comunicare con i servizi Bluemix. - -1. Inizializza il BMSClient copiando e incollando il seguente frammento di codice nel tuo file JavaScript principale (normalmente ubicato nella directory **www/js**). - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("YOUR APP REGION"); - var category = {}; - BMSPush.initialize(appGUID,clientSecret,category); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); - } -``` - {: codeblock} - -Passa la regione per la tua applicazione. Sono fornite le seguenti costanti: - -``` -REGION_US_SOUTH // ".ng.bluemix.net"; -REGION_UK //".eu-gb.bluemix.net"; -REGION_SYDNEY // ".au-syd.bluemix.net"; -``` - -Ad esempio: - -``` -BMSClient.initialize(BMSClient.REGION_US_SOUTH); -``` - -**Nota**: se hai creato un'applicazione Cordova utilizzando la CLI di Cordova, ad esempio, con il comando Cordova create app-name, inserisci questo codice Javascript nel file index.js, dopo la funzione app.receivedEvent all'interno della funzione onDeviceReady: function() per inizializzare `BMSClient`. - - -## Registrazione di dispositivi -{: #cordova_register} - - -Per registrare un dispositivo con il servizio {{site.data.keyword.mobilepushshort}}, richiama il metodo di registro. Copia il seguente frammento di codice nella tua applicazione Cordova per registrare un dispositivo. - -``` -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); -``` - {: codeblock} - -Il seguente frammento di codice JavaScript mostra come inizializzare il tuo Bluemix Mobile Services client SDK, registra un dispositivo con il servizio {{site.data.keyword.mobilepushshort}} e ascolta le notifiche push. Inserisci questo codice nel tuo file Javascript. - -All'interno di **onDeviceReady: function()**. - -``` -onDeviceReady: function() { -app.receivedEvent('deviceready'); -BMSClient.initialize("YOUR APP REGION"); -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; -BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -Aggiungi il seguente frammento di codice Swift alla classe delegato della tua applicazione. - -``` -// Registra il token dispositivo con Bluemix Push Notification Service -func application(application: UIApplication, - didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { - CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) -} -// Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita -func application(application: UIApplication, - didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) -} -``` - {: codeblock} - -##Fasi successive - -{: #cordova_register_next} - -Crea il tuo progetto e quindi eseguilo utilizzando i seguenti comandi: - -####Android -{: android-next-steps} - -``` -cordova build android -``` - {: codeblock} - -``` -cordova run android -``` - {: codeblock} - -####iOS -{: ios-next-steps} - -``` -cordova build ios -``` - {: codeblock} - -``` -cordova run ios -``` - {: codeblock} - -## Ricezione di notifiche di push sui dispositivi -{: #cordova_receive} - -Copia i seguenti frammenti di codice per ricevere notifiche di push sui dispositivi. - -###JavaScript - -Aggiungi il seguente frammento di codice JavaScript alla parte web della tua applicazione Cordova. -``` -var showNotification = function(notif) { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -###Proprietà di notifica Android - -La seguente selezione elenca le proprietà di notifica Android: - -* **message** - messaggio di notifica di push -* **payload** - oggetto JSON che contiene un payload di notifica - - -###Proprietà di notifica iOS - -La seguente sezione elenca le proprietà di notifica iOS: - -* **message** - messaggio di notifica di push -* **payload** - oggetto JSON che contiene un payload di notifica -action-loc-key - la stringa viene utilizzata come una chiave per ottenere una stringa localizzata nella localizzazione corrente da utilizzare per il titolo del pulsante appropriato, invece di `View`. -* **badge** - il numero da visualizzare come badge dell'icona applicazione. Se questa proprietà - non è presente, il badge non viene modificato. Per rimuovere il badge, imposta - il valore di questa proprietà su 0. -* **sound** - il nome di un file audio nel bundle del'applicazione o nella cartella Library/Sounds del contenitore di dati dell'applicazione. - - -Aggiungi i seguenti frammenti di codice Swift alla classe delegato della tua applicazione. -``` -// Gestisci la ricezione di una notifica remota -func application(application: UIApplication, - didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) -} -``` - {: codeblock} - -``` -// Gestisci la ricezione di una notifica remota all'avvio -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary - if remoteNotif != nil { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) - } -} -``` - {: codeblock} - -## Invio di notifiche di push di base -{: #push-send-notifications} - -Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base. - -Per inviare notifiche push di base, completa la seguente procedura: - -1. Seleziona **Send Notifications** e componi un messaggio scegliendo l'opzione **Send to**. Le opzioni supportate sono **Device by Tag**, **Device Id**, **User Id**, **Android devices**, **iOS devices**, **Web Notifications** e **All Devices**. -**Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi sottoscritti a {{site.data.keyword.mobilepushshort}} riceveranno le notifiche. -![Schermata notifiche](images/tag_notification.jpg) - -2. Nel campo **Message**, componi il messaggio. Scegli di configurare le impostazioni facoltative come richiesto. -3. Fai clic su **Send**. -3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. - -Il seguente screenshot mostra una casella di avviso che gestisce una {{site.data.keyword.mobilepushshort}} in primo piano su un dispositivo Android e iOS. - -![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) - -![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) - - La seguente immagine mostra {{site.data.keyword.mobilepushshort}} in background per Android. -![Notifica push in background su Android](images/background.jpg) - -## Fasi successive -{: #next_steps_tags} - -Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche - basate sulle tag e le opzioni avanzate. - -Aggiungi le funzioni del servizio {{site.data.keyword.mobilepushshort}} alla tua applicazione. -Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). -Per utilizzare le opzioni di notifica avanzate, vedi [Abilitazione delle notifiche di push avanzate](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Abilitazione delle applicazioni Cordova alla ricezione di notifiche di push +{: #cordova_enable} +Ultimo aggiornamento: 18 gennaio 2017 +{: .last-updated} + +Cordova è una piattaforma per creare applicazioni ibride con JavaScript, CSS e HTML. Il servizio {{site.data.keyword.mobilepushshort}} supporta lo sviluppo di applicazioni Android e iOS basate su Cordova. + +Puoi abilitare le applicazioni Cordova a ricevere le notifiche di push ai tuoi dispositivi. + +## Installazione del plugin push Cordova +{: #cordova_install} + +Installa e utilizza il plugin di Push client per sviluppare ulteriormente le tue applicazioni Cordova. Questo installa anche il plugin Cordova core, che inizializza la tua connessione a Bluemix. + +### Prima di cominciare + +1. Scarica le ultime versioni dell'SDK Android Studio e Xcode. +1. Configura il tuo emulatore. Per Android Studio, utilizza un emulatore che supporti l'API Google Play. +1. Installa lo strumento della riga di comando Git. Per Windows, assicurati di selezionare l'opzione **Esegui Git dal prompt dei comandi della finestra**. Per informazioni su come scaricare e installare questo strumento, consulta [Git ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://git-scm.com/downloads "Icona link esterno"){: new_window}. +1. Installa lo strumento Node.js e il gestore pacchetti di nodi (NPM). Lo strumento della riga comandi NPM è integrato con Node.js. Per informazioni su come scaricare e installare Node.js, consulta [Node.js ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://nodejs.org/en/download/ "Icona link esterno"){: new_window}. +1. Dalla riga comandi, installa gli strumenti della riga di comando Cordova utilizzando il comando **npm install -g cordova**. È necessario per utilizzare il plugin Push Cordova. Per informazioni su come installare Cordova e configurare la tua applicazione Cordova, consulta [Cordova Apache ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://cordova.apache.org/#getstarted "Icona link esterno"){: new_window}. Per ulteriori informazioni, vedi il [file readme ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push "Icona link esterno"){: new_window} del plug-in Cordova push. +1. Passa alla cartella in cui vuoi creare la tua applicazione Cordova ed esegui il seguente comando per + creare un'applicazione Cordova. Se hai un'applicazione Cordova esistente, vai al passo 3. +```cordova create your_app_name + cd your_app_name +``` + {: codeblock} +- Facoltativo: puoi modificare il file **config.xml** e modificare il nome dell'applicazione nell'elemento in uno a tua scelta, invece del nome predefinito HelloCordova. + +Assicurati di specificare l'ID bundle corretto. Il seguente messaggio di errore potrebbe essere in Xcode, se viene specificato un ID bundle non corretto. + +* L'eseguibile è stato firmato con diritti non validi. +* I diritti specificati nel tuo file Diritti di firma del codice non corrispondo a quelli specificati nel tuo profilo di provisioning. Per risolvere questo problema, specifica l'ID bundle corretto in Xcode o nel tuo file **config.xml** dell'applicazione Cordova. + +1. Aggiungi la API supportata minima o la dichiarazione di destinazione della distribuzione al file config.xml per la tua applicazione Cordova. Il valore minSdkVersion deve essere maggiore di 15. Il valore targetSdkVersion deve sempre riflettere l'SDK Android più recente disponibile da Google. + + * Android - Con il tuo editor, apri il file **config.xml** e aggiorna l'elemento +`` con le versioni SDK minima e di destinazione: + + ``` + + + + + + ``` + {: codeblock} + + * iOS - Aggiorna l'elemento con una dichiarazione di destinazione della distribuzione: + + ``` + + + + + ``` + {: codeblock} + +1. Dalla CLI (command-line interface) Cordova, aggiungi le tue piattaforme: iOS, Android o entrambe utilizzando il comando: +``` +cordova platform add ios + cordova platform add android +``` + {: codeblock} + +1. Dalla directory root della tua applicazione Cordova, immetti il seguente comando per installare il plugin Cordova push: **cordova plugin add bms-push**. A seconda delle piattaforme da te aggiunte, potresti visualizzare: +``` +Installing "bms-push" for android +Installing "bms-push" for ios +``` + {: codeblock} + +1. Dalla cartella root della tua applicazione, verifica che i plug-in Cordova core e push siano stati installati correttamente utilizzando questo comando: **cordova plugin list**. A seconda delle piattaforme da te aggiunte, potresti visualizzare: +``` +bms-core "BMSCore" +bms-push "BMSPush" +``` + {: codeblock} + +1. Configura il tuo ambiente di sviluppo iOS. +2. Crea ed esegui la tua applicazione con Xcode. +1. Scarica il tuo Firebase `google-services.json` per Android e inseriscilo nella cartella root del tuo progetto Cordova, in `[your-app-name]/platforms/android. + 1. Vai a `[your-app-name]/platforms/android`. + 2. Apri il file `build.gradle` (Percorso : platform > android > build.gradle). + 3. Trova il testo `buildscript` nel file `build.gradle`. + 4. Dopo la riga del classpath, aggiungi la riga classpath 'com.google.gms:google-services:3.0.0' + 5. Trova quindi "dependencies". Seleziona le dipendenze in cui è presente il testo `compile` e subito dopo il punto in cui terminano queste dipendenze aggiungi la riga :apply plugin: 'com.google.gms.google-services'. + 6. Prepara e crea il tuo progetto Android Cordova. + ``` + cordova prepare android + cordova build android + ``` + {: codeblock} + **Nota**: prima di aprire il tuo progetto in Android Studio, devi creare la tua applicazione Cordova con la CLI di Cordova. Questo aiuterà nel prevenire errori di generazione. + +## Inizializzazione del plugin Cordova +{: #cordova_initialize} + +Prima di poter utilizzare il plugin Cordova del servizio {{site.data.keyword.mobilepushshort}}, devi inizializzarlo passando la rotta e il GUID dell'applicazione. Dopo che hai inizializzato il plugin, puoi stabilire una connessione all'applicazione server che hai creato nel dashboard Bluemix. Il plugin Cordova è il contenitore per gli SDK client Android e iOS per abilitare un'applicazione Cordova a comunicare con i servizi Bluemix. + +1. Inizializza il BMSClient copiando e incollando il seguente frammento di codice nel tuo file JavaScript principale (normalmente ubicato nella directory **www/js**). + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("YOUR APP REGION"); + var category = {}; + BMSPush.initialize(appGUID,clientSecret,category); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); + } +``` + {: codeblock} + +Passa la regione per la tua applicazione. Sono fornite le seguenti costanti: + +``` +REGION_US_SOUTH // ".ng.bluemix.net"; +REGION_UK //".eu-gb.bluemix.net"; +REGION_SYDNEY // ".au-syd.bluemix.net"; +``` + +Ad esempio: + +``` +BMSClient.initialize(BMSClient.REGION_US_SOUTH); +``` + +**Nota**: se hai creato un'applicazione Cordova utilizzando la CLI di Cordova, ad esempio, con il comando Cordova create app-name, inserisci questo codice Javascript nel file index.js, dopo la funzione app.receivedEvent all'interno della funzione onDeviceReady: function() per inizializzare `BMSClient`. + + +## Registrazione di dispositivi +{: #cordova_register} + + +Per registrare un dispositivo con il servizio {{site.data.keyword.mobilepushshort}}, richiama il metodo di registro. Copia il seguente frammento di codice nella tua applicazione Cordova per registrare un dispositivo. + +``` +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); +``` + {: codeblock} + +Il seguente frammento di codice JavaScript mostra come inizializzare il tuo Bluemix Mobile Services client SDK, registra un dispositivo con il servizio {{site.data.keyword.mobilepushshort}} e ascolta le notifiche push. Inserisci questo codice nel tuo file Javascript. + +All'interno di **onDeviceReady: function()**. + +``` +onDeviceReady: function() { +app.receivedEvent('deviceready'); +BMSClient.initialize("YOUR APP REGION"); +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; +BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +Aggiungi il seguente frammento di codice Swift alla classe delegato della tua applicazione. + +``` +// Registra il token dispositivo con Bluemix Push Notification Service +func application(application: UIApplication, + didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { + CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) +} +// Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita +func application(application: UIApplication, + didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) +} +``` + {: codeblock} + +## Fasi successive + +{: #cordova_register_next} + +Crea il tuo progetto e quindi eseguilo utilizzando i seguenti comandi: + +#### Android +{: android-next-steps} + +``` +cordova build android +``` + {: codeblock} + +``` +cordova run android +``` + {: codeblock} + +#### iOS +{: ios-next-steps} + +``` +cordova build ios +``` + {: codeblock} + +``` +cordova run ios +``` + {: codeblock} + +## Ricezione di notifiche di push sui dispositivi +{: #cordova_receive} + +Copia i seguenti frammenti di codice per ricevere notifiche di push sui dispositivi. + +### JavaScript + +Aggiungi il seguente frammento di codice JavaScript alla parte web della tua applicazione Cordova. +``` +var showNotification = function(notif) { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +### Proprietà di notifica Android + +La seguente selezione elenca le proprietà di notifica Android: + +* **message** - messaggio di notifica di push +* **payload** - oggetto JSON che contiene un payload di notifica + + +### Proprietà di notifica iOS + +La seguente sezione elenca le proprietà di notifica iOS: + +* **message** - messaggio di notifica di push +* **payload** - oggetto JSON che contiene un payload di notifica +action-loc-key - la stringa viene utilizzata come una chiave per ottenere una stringa localizzata nella localizzazione corrente da utilizzare per il titolo del pulsante appropriato, invece di `View`. +* **badge** - il numero da visualizzare come badge dell'icona applicazione. Se questa proprietà + non è presente, il badge non viene modificato. Per rimuovere il badge, imposta + il valore di questa proprietà su 0. +* **sound** - il nome di un file audio nel bundle del'applicazione o nella cartella Library/Sounds del contenitore di dati dell'applicazione. + + +Aggiungi i seguenti frammenti di codice Swift alla classe delegato della tua applicazione. +``` +// Gestisci la ricezione di una notifica remota +func application(application: UIApplication, + didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) +} +``` + {: codeblock} + +``` +// Gestisci la ricezione di una notifica remota all'avvio +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary + if remoteNotif != nil { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) + } +} +``` + {: codeblock} + +## Invio di notifiche di push di base +{: #push-send-notifications} + +Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base. + +Per inviare notifiche push di base, completa la seguente procedura: + +1. Seleziona **Send Notifications** e componi un messaggio scegliendo l'opzione **Send to**. Le opzioni supportate sono **Device by Tag**, **Device Id**, **User Id**, **Android devices**, **iOS devices**, **Web Notifications** e **All Devices**. +**Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi sottoscritti a {{site.data.keyword.mobilepushshort}} riceveranno le notifiche. +![Schermata notifiche](images/tag_notification.jpg) + +2. Nel campo **Message**, componi il messaggio. Scegli di configurare le impostazioni facoltative come richiesto. +3. Fai clic su **Send**. +3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. + +Il seguente screenshot mostra una casella di avviso che gestisce una {{site.data.keyword.mobilepushshort}} in primo piano su un dispositivo Android e iOS. + +![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) + +![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) + + La seguente immagine mostra {{site.data.keyword.mobilepushshort}} in background per Android. +![Notifica push in background su Android](images/background.jpg) + +## Fasi successive +{: #next_steps_tags} + +Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche + basate sulle tag e le opzioni avanzate. + +Aggiungi le funzioni del servizio {{site.data.keyword.mobilepushshort}} alla tua applicazione. +Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). +Per utilizzare le opzioni di notifica avanzate, vedi [Abilitazione delle notifiche di push avanzate](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/it/c_enable_push.md b/services/mobilepush/nl/it/c_enable_push.md index 26611c9f4..262e65c85 100755 --- a/services/mobilepush/nl/it/c_enable_push.md +++ b/services/mobilepush/nl/it/c_enable_push.md @@ -1,25 +1,25 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Abilitazione delle notifiche per i dispositivi mobili -{: #c_enable_push-notifications} -Ultimo aggiornamento: 18 gennaio 2017 -{: .last-updated} - -Assicurati di aver consultato [Configurazione delle credenziali per un provider di notifica](t__main_push_config_provider.html). - -Questa sezione descrive come abilitare le tue applicazioni client - mobili, browser web e anche le estensioni e le applicazioni Chrome per ricevere notifiche di push e in che modo dettagliato come creare notifiche di base, ottenere e inizializzare l'SDK o il plugin e come registrare il tuo dispositivo o browser per ricevere notifiche di push. Puoi anche abilitare le tue applicazioni mobili o browser web a ricevere notifiche di push utilizzando la [API REST](t_restapi.html). - -**Nota**: per le registrazioni del dispositivo, del browser, delle estensioni e delle applicazioni Chrome, il servizio {{site.data.keyword.mobilepushshort}} conserva un riferimento univoco ai token emessi dai provider di notifica - -APNs per Apple o FCM per Google. I token possono essere annullati dal provider di notifica del servizio {{site.data.keyword.mobilepushshort}} per molti motivi. - -Ad esempio, durante la disinstallazione d i un'applicazione sul dispositivo. In questo scenario, quando viene tentato l'invio di una notifica in base ai provider, la risposta del dispositivo viene annullata, il servizio {{site.data.keyword.mobilepushshort}} rimuoverà le registrazioni del dispositivo o del browser web. Ciò impedirà i seguenti tentativi di invio della notifica ai dispositivi annullati. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Abilitazione delle notifiche per i dispositivi mobili +{: #c_enable_push-notifications} +Ultimo aggiornamento: 18 gennaio 2017 +{: .last-updated} + +Assicurati di aver consultato [Configurazione delle credenziali per un provider di notifica](t__main_push_config_provider.html). + +Questa sezione descrive come abilitare le tue applicazioni client - mobili, browser web e anche le estensioni e le applicazioni Chrome per ricevere notifiche di push e in che modo dettagliato come creare notifiche di base, ottenere e inizializzare l'SDK o il plugin e come registrare il tuo dispositivo o browser per ricevere notifiche di push. Puoi anche abilitare le tue applicazioni mobili o browser web a ricevere notifiche di push utilizzando la [API REST](t_restapi.html). + +**Nota**: per le registrazioni del dispositivo, del browser, delle estensioni e delle applicazioni Chrome, il servizio {{site.data.keyword.mobilepushshort}} conserva un riferimento univoco ai token emessi dai provider di notifica - +APNs per Apple o FCM per Google. I token possono essere annullati dal provider di notifica del servizio {{site.data.keyword.mobilepushshort}} per molti motivi. + +Ad esempio, durante la disinstallazione d i un'applicazione sul dispositivo. In questo scenario, quando viene tentato l'invio di una notifica in base ai provider, la risposta del dispositivo viene annullata, il servizio {{site.data.keyword.mobilepushshort}} rimuoverà le registrazioni del dispositivo o del browser web. Ciò impedirà i seguenti tentativi di invio della notifica ai dispositivi annullati. diff --git a/services/mobilepush/nl/it/c_enable_push_webhook.md b/services/mobilepush/nl/it/c_enable_push_webhook.md index 4ce76121a..c0b73f3f0 100644 --- a/services/mobilepush/nl/it/c_enable_push_webhook.md +++ b/services/mobilepush/nl/it/c_enable_push_webhook.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Abilitazione dei webhook -{: #tag_based_notifications} -Ultimo aggiornamento: 23 gennaio 2017 -{: .last-updated} - - -Con il servizio {{site.data.keyword.mobilepushshort}}, puoi scegliere di ricevere avvisi relativi alle modifiche apportate alle informazioni. Le modifiche alle informazioni aziendali creano degli eventi, per i quali puoi ricevere una notifica registrandoli come eventi webhook. Questi eventi webhook attivano un avviso. - -I webhook sono dei callback definiti dall'utente che vengono attivati da un evento, ad esempio la registrazione di un dispositivo o la sottoscrizione a una tag. Nel servizio {{site.data.keyword.mobilepushshort}}, puoi effettuare la registrazione per i seguenti webhook: - -- **onDeviceRegister**: un evento webhook viene attivato per i dispositivi registrati per il push. -- **onDeviceUpdate**: un evento webhook viene attivato quando vengono aggiornate le informazioni su un dispositivo registrato. -- **onDeviceUnregister**: un evento webhook viene attivato quando viene annullata la registrazione di un dispositivo. -- **onSubscribe**: un evento webhook viene attivato per la sottoscrizione dell'utente a una tag. -- **onUnsubscribe**: un evento webhook viene attivato per l'annullamento della sottoscrizione dell'utente a una tag. -- **onNotificationSend**: un evento webhook viene attivato per una notifica che è stata inviata. -- **onNotificationFailure**: un evento webhook viene attivato per gli errori di notifica. - - -**Nota**: gli invii delle notifiche vengono effettuati in batch. L'invio di un messaggio può avere più eventi webhook, che possono includere sia errori che esiti positivi. -Gli eventi webhook hanno lo stesso messageID del messaggio inviato. - -Per ulteriori informazioni sui webhook, vedi [IBM Push Notifications REST API ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Abilitazione dei webhook +{: #tag_based_notifications} +Ultimo aggiornamento: 23 gennaio 2017 +{: .last-updated} + + +Con il servizio {{site.data.keyword.mobilepushshort}}, puoi scegliere di ricevere avvisi relativi alle modifiche apportate alle informazioni. Le modifiche alle informazioni aziendali creano degli eventi, per i quali puoi ricevere una notifica registrandoli come eventi webhook. Questi eventi webhook attivano un avviso. + +I webhook sono dei callback definiti dall'utente che vengono attivati da un evento, ad esempio la registrazione di un dispositivo o la sottoscrizione a una tag. Nel servizio {{site.data.keyword.mobilepushshort}}, puoi effettuare la registrazione per i seguenti webhook: + +- **onDeviceRegister**: un evento webhook viene attivato per i dispositivi registrati per il push. +- **onDeviceUpdate**: un evento webhook viene attivato quando vengono aggiornate le informazioni su un dispositivo registrato. +- **onDeviceUnregister**: un evento webhook viene attivato quando viene annullata la registrazione di un dispositivo. +- **onSubscribe**: un evento webhook viene attivato per la sottoscrizione dell'utente a una tag. +- **onUnsubscribe**: un evento webhook viene attivato per l'annullamento della sottoscrizione dell'utente a una tag. +- **onNotificationSend**: un evento webhook viene attivato per una notifica che è stata inviata. +- **onNotificationFailure**: un evento webhook viene attivato per gli errori di notifica. + + +**Nota**: gli invii delle notifiche vengono effettuati in batch. L'invio di un messaggio può avere più eventi webhook, che possono includere sia errori che esiti positivi. +Gli eventi webhook hanno lo stesso messageID del messaggio inviato. + +Per ulteriori informazioni sui webhook, vedi [IBM Push Notifications REST API ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}. diff --git a/services/mobilepush/nl/it/c_ios_enable.md b/services/mobilepush/nl/it/c_ios_enable.md index f7e504d90..b9f7828b5 100755 --- a/services/mobilepush/nl/it/c_ios_enable.md +++ b/services/mobilepush/nl/it/c_ios_enable.md @@ -1,335 +1,335 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#Abilitazione delle applicazioni iOS a inviare {{site.data.keyword.mobilepushshort}} -{: #enable-push-ios-notifications} -Ultimo aggiornamento: 14 febbraio 2017 -{: .last-updated} - -Puoi abilitare le applicazioni iOS a inviare {{site.data.keyword.mobilepushshort}} ai tuoi dispositivi. - - -##Installazione di CocoaPods -{: #enable-push-ios-notifications-install} - -Per un progetto Xcode esistente, puoi impostare il Bluemix Mobile services client SDK utilizzando lo strumento di gestione delle dipendenze CocoaPods. Un'alternativa consiste nell'installare l'SDK in modo manuale. - -Per visualizzare il file readme Swift Push, vai a [Readme ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. - - - -1. Installa CocoaPods utilizzando il seguente comando nel tuo terminale Mac. -```$ sudo gem install cocoapods -``` - {: codeblock} -2. Immetti il comando `pod init` nel terminale per inizializzare CocoaPods. Assicurati di eseguire il comando dalla directory in cui si trova il progetto Xcode. Il comando `pod init` crea un Podfile. -3. Nel Podfile generato, aggiungi le dipendenze SDK richieste. Copia il seguente Podfile. - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copia il seguente elenco come è e rimuovi le dipendenze di cui non hai bisogno. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - pod 'BMSAnalyticsAPI' - end - ``` - {: codeblock} - -3. Dal terminale, vai alla cartella del progetto e installa le dipendenze con il comando `pod update`. - -Il comando installa le tue dipendenze e crea un nuovo spazio di lavoro Xcode. -**Nota**: assicurati di aprire sempre il nuovo spazio di lavoro Xcode invece del file di progetto Xcode originale: -``` - $ open App.xcworkspace -``` - {: codeblock} - -Lo spazio di lavoro contiene il tuo progetto originale e il progetto Pods che contiene le tue dipendenze. Per modificare una cartella di origine Bluemix mobile services, puoi trovarla nel tuo progetto Pods, in `Pods/yourImportedSourceFolder`, ad esempio: `Pods/BMSPush`. - -##Aggiunta di framework utilizzando Carthage -{: #carthage} - -Aggiungi i framework al tuo progetto utilizzando [Carthage ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}. Nota che Carthage in Xcode8 non è supportato. - -1. Aggiungi i framework `BMSPush` al tuo Cartfile: -``` - github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" -``` - {: codeblock} -2. Esegui il comando `carthage update`. Quando la build è stata completata, trascina `BMSPush.framework`, `BMSCore.framework` e `BMSAnalyticsAPI.framework` nel tuo progetto Xcode. -3. Segui le istruzioni sul sito di [Carthage ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} per completare l'integrazione. - -##Configurazione dell'SDK iOS -{: ios-sdk} - -Per configurare l'SDK iOS, aggiungi il seguente codice nel file **AppDelegate.swift** della tua applicazione. Nota che questo registra anche gli APNs. -``` - func application(_ application: UIApplication, -didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") - } -``` - {: codeblock} - -##Utilizzo dei framework importati e delle cartelle di origine -{: using-imported-frameworks} - -Fai riferimento all'SDK nel tuo codice. Assicurati che siano implementati i seguenti prerequisiti. - -- iOS 8.0 o successiva -- Xcode 7 - -Scrivi le direttive `#import` per le intestazioni -pertinenti, ad esempio: -``` -//swift -import BMSCore -import BMSPush -``` - {: codeblock} - -Per leggere il file readme Swift Push, vedi [Readme ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. - -**Nota**: aggiornare il tuo progetto Pods utilizzando i comandi CocoaPods `pod install` o `pod update` potrebbe sovrascrivere le cartelle di origine Bluemix Mobile services. Se vuoi conservare le tue versioni personalizzate dei file originali, assicurati che ne sia stato eseguito il backup prime di immettere uno di questi comandi. - - -##Impostazioni di creazione -{: build-settings} - -Vai a **Xcode > Build Settings > Build Options e imposta Enable Bitcode** su **No**. - -**Attenzione**: a partire da iOS 9, le modifiche alla funzione ATS (App Transport Security) potrebbero influenzare il modo in cui gestisci il processo di autenticazione. I seguenti post del blog descrivono in maggiore dettaglio le modifiche: [ATS and Bitcode in iOS 9 ![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} e [Connect your iOS 9 app to Bluemix today ![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. - -## Inizializzazione di Push SDK per applicazioni iOS -{: #enable-push-ios-notifications-initialize} - -Un posto comune dove inserire il codice di inizializzazione è nel delegato dell'applicazione per l'applicazione iOS. Fai clic sul link **Opzioni mobili** nel tuo dashboard Push per ottenere il GUID e la rotta dell'applicazione. - -###Inizializzazione dell'SDK Core -{: Initializing-the-core-sdk} - - -``` -// Inizializza l'SDK Core for Swift con l'area, la rotta e la GUID IBM Bluemix -let myBMSClient = BMSClient.sharedInstance -myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") -``` - {: codeblock} - -### Rotta, GUID e area Bluemix -{: route-guid-bluemix-region} - -####appRoute -{: ios-approute} - -Specifica la rotta assegnato all'applicazione server creata in Bluemix. - -####GUID -{: ios-guid} - -Specifica la chiave univoca assegnata all'applicazione creata in Bluemix. Questo valore è - sensibile al maiuscolo/minuscolo. - -####bluemixRegionSuffix -{: ios-bluemixRegionSuffix} - -Specifica l'ubicazione in cui è ospitata l'applicazione. Il parametro `bluemixRegion` specifica quale distribuzione di Bluemix stati utilizzando. Puoi impostare questo valore con una proprietà statica `BMSClient.REGION` e utilizzare uno dei seguenti tre valori: - -- BMSClient.Region.usSouth -- BMSClient.Region.unitedKingdom -- BMSClient.Region.sydney - -####AppGUID -{: ios-AppGUID} - -Specifica la chiave AppGUID univoca assegnata al servizio {{site.data.keyword.mobilepushshort}} creata in Bluemix. - -###Inizializzazione del Push SDK client -{: initializing-the-client-Push-SDK} - -``` - //Inizializza il Push SDK for Swift client -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -## Registrazione di dispositivi ed applicazioni iOS -{: #enable-push-ios-notifications-register} - - -Un'applicazione deve essere registrata con il servizio APNS per ricevere le notifiche remote, dopo l'installazione su un dispositivo. Una volta che il token del dispositivo generato da APNS viene ricevuto dall'applicazione, questo deve essere trasmesso nuovamente al servizio {{site.data.keyword.mobilepushshort}}. - -Per registrare le applicazioni e dispositivi iOS, devi: - -1. Creare un'applicazione di backend. -2. Inviare il token a {{site.data.keyword.mobilepushshort}}. - - -###Creazione di un'applicazione di backend -{: create-a-backend-app} - -Crea un'applicazione di backend nella sezione Contenitori tipo del catalogo Bluemix®, che esegue automaticamente il bind del servizio {{site.data.keyword.mobilepushshort}} a questa applicazione. Se già hai creato un'applicazione di backend, assicurati di eseguirne il bind al servizio {{site.data.keyword.mobilepushshort}}. - - -###Trasmissione dei token a {{site.data.keyword.mobilepushshort}} -{: pass-token-push-notifications} - -Dopo che il token viene ricevuto da APNs, passa il token a {{site.data.keyword.mobilepushshort}} come parte del metodo `registerWithDeviceToken`. - -Dopo che il token viene ricevuto da APNs, passa il token a Push Notifications come parte del metodo `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` - func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ - let push = BMSPushClient.sharedInstance - push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - } -``` - {: codeblock} - - -## Ricezione di notifiche di push su dispositivi iOS -{: #enable-push-ios-notifications-receiving} - - -Per ricevere notifiche di push sui dispositivi ioS, aggiungi il seguente metodo Swift al delegato applicazione della tua applicazione. - -``` - // For Swift -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) - { //UserInfo dictionary will contain data sent from the server } -``` - {: codeblock} - -## Monitoraggio di notifiche di push su dispositivi iOS -{: ios-monitoring} - -Per monitorare lo stato corrente della notifica, aggiungi il seguente metodo Swift al delegato applicazione della tua applicazione. - -``` - // Send notification status when app is opened by clicking the notifications -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - print("Send message status to the Push server") - } -} -``` - {: codeblock} - -``` - // Send notification status when the app is in background mode. - func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { - let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) - self.showAlert(title: "Recieved Push notifications", message: payLoad) - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - completionHandler(UIBackgroundFetchResult.newData) - } -} -``` - {: codeblock} - - -## Invio di notifiche di push di base -{: #send} - -Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base. - -Per inviare notifiche push di base, completa la seguente procedura: - -1. Seleziona **Send Notifications** e componi un messaggio scegliendo l'opzione **Send to**. Le opzioni supportate sono **Device by Tag**, **Device Id**, **User Id**, **Android devices**, **iOS devices**, **Web Notifications** e **All Devices**. -**Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi sottoscritti a {{site.data.keyword.mobilepushshort}} riceveranno le notifiche. -![Schermata notifiche](images/tag_notification.jpg) - -2. Nel campo **Message**, componi il messaggio. Scegli di configurare le impostazioni facoltative come richiesto. -3. Fai clic su **Send**. -3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. - -La seguente immagine mostra una casella di avviso che gestisce {{site.data.keyword.mobilepushshort}} su un dispositivo iOS. - -![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) - -### Impostazioni facoltative per l'invio delle notifiche -{: #send_ios_otpional_setting} - -Puoi anche personalizzare le impostazioni di {{site.data.keyword.mobilepushshort}} per inviare le notifiche ai dispositivi iOS. Sono supportate le seguenti opzioni di personalizzazione facoltative. - -- **Badge**: indica il numero che viene visualizzato nel badge dell'applicazione. Il valore predefinito è zero (0) e ciò significa che non sarà visualizzato un badge. -- **Audio**: indica un file audio da riprodurre al ricevimento di un notifica. Supporta il valore predefinito o il nome della risorsa audio integrata nell'applicazione. -- **Payload addizionale**: specifica i valori di payload personalizzati per le tue notifiche. - -##Abilitazione di notifiche interattive - -Puoi ora arricchire le tue notifiche iOS con maggiori dettagli, come l'aggiunta di un'immagine, una mappa o un pulsante di risposta, attraverso l'abilitazione di notifiche interattive. Ciò fornisce un maggiore contesto per i clienti, insieme alla capacità di agire immediatamente senza uscire dal contesto corrente. - -Per abilitare le notifiche interattive, utilizza il seguente codice: - -``` - // This defines the button action. - let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) -``` - {: codeblock} -``` - // This defines category for the buttons -let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) -``` - {: codeblock} -``` - // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions -let notificationOptions = BMSPushClientOptions(categoryName: [category]) -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) -``` - {: codeblock} - -Per inviare una notifica interattiva, completa la procedura: - -1. Nella sezione Compose, dall'elenco a discesa Send To, seleziona **iOS Devices**. -2. Immetti il messaggio di notifica che vuoi inviare. -3. Nella sezione Optional Settings, seleziona **Mobile** e fai clic su **iOS**. -4. Nell'elenco a discesa Type, seleziona **Mixed**. -5. Nel campo Category, specifica il tipo di notifica che hai definito nella tua applicazione. - -![Notifica interattiva per iOS](images/push_ios_notification_interactive.jpg) - -## Fasi successive -{: #next_steps_tags} - -Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche - basate sulle tag e le opzioni avanzate. - -Aggiungi queste funzioni del servizio Push Notifications alla tua applicazione. -Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). -Per utilizzare le opzioni di notifica avanzate, vedi [Abilitazione delle notifiche di push avanzate](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +#Abilitazione delle applicazioni iOS a inviare {{site.data.keyword.mobilepushshort}} +{: #enable-push-ios-notifications} +Ultimo aggiornamento: 14 febbraio 2017 +{: .last-updated} + +Puoi abilitare le applicazioni iOS a inviare {{site.data.keyword.mobilepushshort}} ai tuoi dispositivi. + + +##Installazione di CocoaPods +{: #enable-push-ios-notifications-install} + +Per un progetto Xcode esistente, puoi impostare il Bluemix Mobile services client SDK utilizzando lo strumento di gestione delle dipendenze CocoaPods. Un'alternativa consiste nell'installare l'SDK in modo manuale. + +Per visualizzare il file readme Swift Push, vai a [Readme ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. + + + +1. Installa CocoaPods utilizzando il seguente comando nel tuo terminale Mac. +```$ sudo gem install cocoapods +``` + {: codeblock} +2. Immetti il comando `pod init` nel terminale per inizializzare CocoaPods. Assicurati di eseguire il comando dalla directory in cui si trova il progetto Xcode. Il comando `pod init` crea un Podfile. +3. Nel Podfile generato, aggiungi le dipendenze SDK richieste. Copia il seguente Podfile. + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copia il seguente elenco come è e rimuovi le dipendenze di cui non hai bisogno. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + pod 'BMSAnalyticsAPI' + end + ``` + {: codeblock} + +3. Dal terminale, vai alla cartella del progetto e installa le dipendenze con il comando `pod update`. + +Il comando installa le tue dipendenze e crea un nuovo spazio di lavoro Xcode. +**Nota**: assicurati di aprire sempre il nuovo spazio di lavoro Xcode invece del file di progetto Xcode originale: +``` + $ open App.xcworkspace +``` + {: codeblock} + +Lo spazio di lavoro contiene il tuo progetto originale e il progetto Pods che contiene le tue dipendenze. Per modificare una cartella di origine Bluemix mobile services, puoi trovarla nel tuo progetto Pods, in `Pods/yourImportedSourceFolder`, ad esempio: `Pods/BMSPush`. + +##Aggiunta di framework utilizzando Carthage +{: #carthage} + +Aggiungi i framework al tuo progetto utilizzando [Carthage ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}. Nota che Carthage in Xcode8 non è supportato. + +1. Aggiungi i framework `BMSPush` al tuo Cartfile: +``` + github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" +``` + {: codeblock} +2. Esegui il comando `carthage update`. Quando la build è stata completata, trascina `BMSPush.framework`, `BMSCore.framework` e `BMSAnalyticsAPI.framework` nel tuo progetto Xcode. +3. Segui le istruzioni sul sito di [Carthage ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} per completare l'integrazione. + +##Configurazione dell'SDK iOS +{: ios-sdk} + +Per configurare l'SDK iOS, aggiungi il seguente codice nel file **AppDelegate.swift** della tua applicazione. Nota che questo registra anche gli APNs. +``` + func application(_ application: UIApplication, +didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") + } +``` + {: codeblock} + +##Utilizzo dei framework importati e delle cartelle di origine +{: using-imported-frameworks} + +Fai riferimento all'SDK nel tuo codice. Assicurati che siano implementati i seguenti prerequisiti. + +- iOS 8.0 o successiva +- Xcode 7 + +Scrivi le direttive `#import` per le intestazioni +pertinenti, ad esempio: +``` +//swift +import BMSCore +import BMSPush +``` + {: codeblock} + +Per leggere il file readme Swift Push, vedi [Readme ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. + +**Nota**: aggiornare il tuo progetto Pods utilizzando i comandi CocoaPods `pod install` o `pod update` potrebbe sovrascrivere le cartelle di origine Bluemix Mobile services. Se vuoi conservare le tue versioni personalizzate dei file originali, assicurati che ne sia stato eseguito il backup prime di immettere uno di questi comandi. + + +##Impostazioni di creazione +{: build-settings} + +Vai a **Xcode > Build Settings > Build Options e imposta Enable Bitcode** su **No**. + +**Attenzione**: a partire da iOS 9, le modifiche alla funzione ATS (App Transport Security) potrebbero influenzare il modo in cui gestisci il processo di autenticazione. I seguenti post del blog descrivono in maggiore dettaglio le modifiche: [ATS and Bitcode in iOS 9 ![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} e [Connect your iOS 9 app to Bluemix today ![Icona link esterno](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. + +## Inizializzazione di Push SDK per applicazioni iOS +{: #enable-push-ios-notifications-initialize} + +Un posto comune dove inserire il codice di inizializzazione è nel delegato dell'applicazione per l'applicazione iOS. Fai clic sul link **Opzioni mobili** nel tuo dashboard Push per ottenere il GUID e la rotta dell'applicazione. + +###Inizializzazione dell'SDK Core +{: Initializing-the-core-sdk} + + +``` +// Inizializza l'SDK Core for Swift con l'area, la rotta e la GUID IBM Bluemix +let myBMSClient = BMSClient.sharedInstance +myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") +``` + {: codeblock} + +### Rotta, GUID e area Bluemix +{: route-guid-bluemix-region} + +####appRoute +{: ios-approute} + +Specifica la rotta assegnato all'applicazione server creata in Bluemix. + +####GUID +{: ios-guid} + +Specifica la chiave univoca assegnata all'applicazione creata in Bluemix. Questo valore è + sensibile al maiuscolo/minuscolo. + +####bluemixRegionSuffix +{: ios-bluemixRegionSuffix} + +Specifica l'ubicazione in cui è ospitata l'applicazione. Il parametro `bluemixRegion` specifica quale distribuzione di Bluemix stati utilizzando. Puoi impostare questo valore con una proprietà statica `BMSClient.REGION` e utilizzare uno dei seguenti tre valori: + +- BMSClient.Region.usSouth +- BMSClient.Region.unitedKingdom +- BMSClient.Region.sydney + +####AppGUID +{: ios-AppGUID} + +Specifica la chiave AppGUID univoca assegnata al servizio {{site.data.keyword.mobilepushshort}} creata in Bluemix. + +###Inizializzazione del Push SDK client +{: initializing-the-client-Push-SDK} + +``` + //Inizializza il Push SDK for Swift client +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +## Registrazione di dispositivi ed applicazioni iOS +{: #enable-push-ios-notifications-register} + + +Un'applicazione deve essere registrata con il servizio APNS per ricevere le notifiche remote, dopo l'installazione su un dispositivo. Una volta che il token del dispositivo generato da APNS viene ricevuto dall'applicazione, questo deve essere trasmesso nuovamente al servizio {{site.data.keyword.mobilepushshort}}. + +Per registrare le applicazioni e dispositivi iOS, devi: + +1. Creare un'applicazione di backend. +2. Inviare il token a {{site.data.keyword.mobilepushshort}}. + + +###Creazione di un'applicazione di backend +{: create-a-backend-app} + +Crea un'applicazione di backend nella sezione Contenitori tipo del catalogo Bluemix®, che esegue automaticamente il bind del servizio {{site.data.keyword.mobilepushshort}} a questa applicazione. Se già hai creato un'applicazione di backend, assicurati di eseguirne il bind al servizio {{site.data.keyword.mobilepushshort}}. + + +###Trasmissione dei token a {{site.data.keyword.mobilepushshort}} +{: pass-token-push-notifications} + +Dopo che il token viene ricevuto da APNs, passa il token a {{site.data.keyword.mobilepushshort}} come parte del metodo `registerWithDeviceToken`. + +Dopo che il token viene ricevuto da APNs, passa il token a Push Notifications come parte del metodo `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` + func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ + let push = BMSPushClient.sharedInstance + push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + } +``` + {: codeblock} + + +## Ricezione di notifiche di push su dispositivi iOS +{: #enable-push-ios-notifications-receiving} + + +Per ricevere notifiche di push sui dispositivi ioS, aggiungi il seguente metodo Swift al delegato applicazione della tua applicazione. + +``` + // For Swift +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) + { //UserInfo dictionary will contain data sent from the server } +``` + {: codeblock} + +## Monitoraggio di notifiche di push su dispositivi iOS +{: ios-monitoring} + +Per monitorare lo stato corrente della notifica, aggiungi il seguente metodo Swift al delegato applicazione della tua applicazione. + +``` + // Send notification status when app is opened by clicking the notifications +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + print("Send message status to the Push server") + } +} +``` + {: codeblock} + +``` + // Send notification status when the app is in background mode. + func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { + let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) + self.showAlert(title: "Recieved Push notifications", message: payLoad) + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + completionHandler(UIBackgroundFetchResult.newData) + } +} +``` + {: codeblock} + + +## Invio di notifiche di push di base +{: #send} + +Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base. + +Per inviare notifiche push di base, completa la seguente procedura: + +1. Seleziona **Send Notifications** e componi un messaggio scegliendo l'opzione **Send to**. Le opzioni supportate sono **Device by Tag**, **Device Id**, **User Id**, **Android devices**, **iOS devices**, **Web Notifications** e **All Devices**. +**Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi sottoscritti a {{site.data.keyword.mobilepushshort}} riceveranno le notifiche. +![Schermata notifiche](images/tag_notification.jpg) + +2. Nel campo **Message**, componi il messaggio. Scegli di configurare le impostazioni facoltative come richiesto. +3. Fai clic su **Send**. +3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. + +La seguente immagine mostra una casella di avviso che gestisce {{site.data.keyword.mobilepushshort}} su un dispositivo iOS. + +![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) + +### Impostazioni facoltative per l'invio delle notifiche +{: #send_ios_otpional_setting} + +Puoi anche personalizzare le impostazioni di {{site.data.keyword.mobilepushshort}} per inviare le notifiche ai dispositivi iOS. Sono supportate le seguenti opzioni di personalizzazione facoltative. + +- **Badge**: indica il numero che viene visualizzato nel badge dell'applicazione. Il valore predefinito è zero (0) e ciò significa che non sarà visualizzato un badge. +- **Audio**: indica un file audio da riprodurre al ricevimento di un notifica. Supporta il valore predefinito o il nome della risorsa audio integrata nell'applicazione. +- **Payload addizionale**: specifica i valori di payload personalizzati per le tue notifiche. + +##Abilitazione di notifiche interattive + +Puoi ora arricchire le tue notifiche iOS con maggiori dettagli, come l'aggiunta di un'immagine, una mappa o un pulsante di risposta, attraverso l'abilitazione di notifiche interattive. Ciò fornisce un maggiore contesto per i clienti, insieme alla capacità di agire immediatamente senza uscire dal contesto corrente. + +Per abilitare le notifiche interattive, utilizza il seguente codice: + +``` + // This defines the button action. + let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) +``` + {: codeblock} +``` + // This defines category for the buttons +let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) +``` + {: codeblock} +``` + // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions +let notificationOptions = BMSPushClientOptions(categoryName: [category]) +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) +``` + {: codeblock} + +Per inviare una notifica interattiva, completa la procedura: + +1. Nella sezione Compose, dall'elenco a discesa Send To, seleziona **iOS Devices**. +2. Immetti il messaggio di notifica che vuoi inviare. +3. Nella sezione Optional Settings, seleziona **Mobile** e fai clic su **iOS**. +4. Nell'elenco a discesa Type, seleziona **Mixed**. +5. Nel campo Category, specifica il tipo di notifica che hai definito nella tua applicazione. + +![Notifica interattiva per iOS](images/push_ios_notification_interactive.jpg) + +## Fasi successive +{: #next_steps_tags} + +Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche + basate sulle tag e le opzioni avanzate. + +Aggiungi queste funzioni del servizio Push Notifications alla tua applicazione. +Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). +Per utilizzare le opzioni di notifica avanzate, vedi [Abilitazione delle notifiche di push avanzate](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/it/c_overview_push.md b/services/mobilepush/nl/it/c_overview_push.md index 9b8b6c705..2cafbcb81 100755 --- a/services/mobilepush/nl/it/c_overview_push.md +++ b/services/mobilepush/nl/it/c_overview_push.md @@ -1,139 +1,139 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Informazioni su {{site.data.keyword.mobilepushshort}} -{: #overview-push} -Ultimo aggiornamento: 18 gennaio 2017 -{: .last-updated} - -IBM {{site.data.keyword.mobilepushshort}} è un servizio che puoi utilizzare per inviare notifiche a dispositivi e piattaforme. Le notifiche possono essere destinate a tutti gli utenti dell'applicazione oppure a uno specifico insieme di utenti e dispositivi facendo uso delle tag. Puoi amministrare dispositivi, tag e sottoscrizioni. - -Puoi utilizzare una delle seguenti opzioni per creare un servizio associato o non associato: - -- Creando un'applicazione Bluemix mediante il contenitore tipo MobileFirst Services Starter dal catalogo. In questo modo si crea un servizio Push Notifications associato a un'applicazione di backend Bluemix. -- Creando un servizio Push Notifications non associato direttamente dal catalogo Mobile. Puoi associarlo in seguito a un'applicazione o scegliere di utilizzarlo non associato. -- Utilizzando il [dashboard Mobile ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://console.ng.bluemix.net/docs/mobile/services.html "Icona link esterno"){: new_window}. - -Tieni presente che la scheda di monitoraggio di {{site.data.keyword.mobilepushshort}} non visualizza dati di analisi. - -Il servizio {{site.data.keyword.mobilepushshort}} è ora abilitato con OpenWhisk. Per ulteriori informazioni, vedi [OpenWhisk](/docs/openwhisk/index.html). - - -## Processo del servizio {{site.data.keyword.mobilepushshort}} -{: #overview_push_process} - -I client browser web, mobili e le estensioni e le applicazioni Google Chrome possono sottoscriversi e registrarsi per il servizio {{site.data.keyword.mobilepushshort}}. All'avvio, le applicazioni client si registrano al servizio {{site.data.keyword.mobilepushshort}} e lo sottoscrivono. Le notifiche vengono spedite al servizio APNS (Apple Push Notification Service) o al server FCM (Firebase Cloud Messaging)/GCM (Google Cloud Messaging) e inviate quindi ai client mobili o browser registrati. - -![Panoramica Push](images/overview.jpg) - - -###Applicazioni mobili e browser -{: mobile-applications} - -All'avvio, le applicazioni client si registrano al servizio {{site.data.keyword.mobilepushshort}} e lo sottoscrivono per ricevere notifiche. - -###Applicazioni di backend -{: backend-applications} - -Le applicazioni di backend possono essere in loco o in un cloud pubblico. Le applicazioni di backend utilizzeranno il servizio {{site.data.keyword.mobilepushshort}} per inviare notifiche sensibili al contesto agli utenti mobili o browser. Le applicazioni di backend non devono necessariamente conservare e gestire informazioni sugli utenti, sugli agent browser e sui dispositivi mobili per inviare notifiche di push. Invece, le applicazioni di backend possono utilizzare il servizio {{site.data.keyword.mobilepushshort}} che le gestisce e mantiene. - -###Proprietario backend applicazione -{: app-backend-owner} - -Il proprietario del backend dell'applicazione crea l'applicazione di backend mobile che aggrega un'istanza al servizio {{site.data.keyword.mobilepushshort}}. Il proprietario del backend dell'applicazione configurare inoltre il servizio {{site.data.keyword.mobilepushshort}} in modo che le applicazioni di backend utilizzino il servizio con le applicazioni mobili e browser destinate a {{site.data.keyword.mobilepushshort}}. - -###Servizio {{site.data.keyword.mobilepushshort}} -{: push-notification-service} - -Il servizio {{site.data.keyword.mobilepushshort}} gestisce tutte le informazioni relative ai dispositivi mobili e ai client browser web registrati per le notifiche. Il servizio fornisce alle tue applicazioni la trasparenza dei dettagli di tecnologia relativi all'invio di notifiche a queste eterogenee piattaforme mobili e browser web, gestendo tutto questo internamente. - -###Gateway -{: gateways} - -Servizi cloud specifici per piattaforme quali FCM/GCM o APNS (Apple Push Notification Service) utilizzati dal servizio {{site.data.keyword.mobilepushshort}} IBM per inviare notifiche alle applicazioni mobili e browser. - -###Sicurezza push -{: push-security} - -Le API {{site.data.keyword.mobilepushshort}} sono protette da due tipi di segreti: - -- **appSecret**: 'appSecret' protegge le API normalmente richiamate dalle applicazioni di backend, come l'API per inviare {{site.data.keyword.mobilepushshort}} e l'API per configurare le impostazioni. -- **clientSecret**: 'clientSecret' protegge le API normalmente richiamate dalle applicazioni client mobili. È presente solo un'API correlata alla registrazione di un dispositivo con un ID utente associato che richiede 'clientSecret'. Nessuna delle altre API richiamate dai client mobili richiede il clientSecret. - -'appSecret' e 'clientSecret' sono assegnati a ogni istanza del servizio al momento del bind di un'applicazione al servizio {{site.data.keyword.mobilepushshort}}. Fai riferimento alla documentazione [API REST ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno") per informazioni su come i segreti vengono trasmessi e a quale API. - -**Nota**: sono necessarie le precedenti applicazioni per trasmettere il clientSecret solo quando viene seguita la registrazione o l'aggiornamento dei dispositivi con il campo userID. Tutte le altre API richiamate dai client mobili e browser non richiedono il clientSecret. Queste vecchie applicazioni possono continuare ad utilizzare il clientSecret facoltativamente per le registrazioni del dispositivo o per l'aggiornamento delle chiamate. Tuttavia, è fortemente raccomandato che il controllo clientSecret venga applicato a tutte le chiamate API client. Per applicarlo alle applicazioni esistenti, è stata pubblicata una nuova API denominata 'verifyClientSecret'. Per le nuove applicazioni, il controllo clientSecret sarà imposto per tutte le chiamate API client e questo comportamento non può essere modificato con l'API 'verfiyClientSecret'. - -Per impostazione predefinita, la verifica del segreto client viene forzata solo nelle nuove applicazioni. Alle applicazioni nuove e esistenti è consentito abilitare o disabilitare la verifica del segreto client utilizzando l'API REST verifyClientSecret. Ti raccomandiamo di forzare la verifica del segreto client per evitare l'esposizione dei dispositivi agli utenti che possono conoscere il applicationId e il deviceId. - -Assicurati che il 'clientSecret' sia mantenuto confidenziale e non inserirlo mai nell'applicazione mobile. Esistono vari modelli di inizializzazione dell'applicazione che possono essere utilizzati per estrarre il 'clientSecret' dinamicamente durante il runtime delle applicazioni. Il diagramma della sequenza illustra il possibile modello. -![Enable_Push](images/init_client_secret.jpg) - -## Tipi di {{site.data.keyword.mobilepushshort}} -{: #overview-push-types} - -###Broadcast -{: broadcast} - -Quando un'applicazione client si registra al servizio {{site.data.keyword.mobilepushshort}}, può iniziare a ricevere i broadcast. Le notifiche broadcast sono messaggi destinati a tutte le istanze di un'applicazione installate nei dispositivi mobili, nei browser o implementate come applicazioni Chrome o istanze dell'estensione e configurate per il servizio {{site.data.keyword.mobilepushshort}}. Le notifiche broadcast sono abilitate per impostazione predefinita con qualsiasi applicazione abilitata per {{site.data.keyword.mobilepushshort}}. Le applicazioni abilitate per il servizio {{site.data.keyword.mobilepushshort}} hanno una sottoscrizione predefinita alla tag Push.ALL, che viene utilizzata dal server per eseguire il broadcast dei messaggi di notifica a tutti i dispositivi. Per inviare una notifica broadcast che utilizza la API Push - REST, assicurati che la destinazione ("target") sia un JSON vuoto all'inserimento nella - risorsa messaggi. - -###Notifiche basate sulle tag -{: tag-based-notifications} - -Le notifiche basate sulle tag sono messaggi destinati a tutti i dispositivi sottoscritti a una particolare tag. Le notifiche basate sulle tag - consentono la segmentazione di notifiche sulla base di argomenti o di aree - oggetto. I destinatari della notifica possono scegliere di ricevere le notifiche solo - se sono relative a un oggetto o a un argomento a cui sono interessati. Pertanto, - la notifica basata sulle tag fornisce un mezzo per segmentare i destinatari. Questa funzione - consente di definire delle tag e quindi di inviare e ricevere messaggi in - base alle tag. Un messaggio viene indirizzato solo alle istanze dell'applicazione client (mobili, browser o come un'applicazione o estensioni) sottoscritte a una tag. Devi prima creare le tag per l'applicazione, impostare le sottoscrizioni di tag e iniziare quindi le notifiche basate sulle tag. Per inviare una notifica basata sulle tag che utilizza la API REST, assicurati che i "tagName" siano forniti all'inserimento nella risorsa messaggi. - -###Notifiche Unicast -{: unicast-notifications} - -Le notifiche Unicast sono messaggi destinati a un dispositivo o un utente particolare. Le notifiche Unicast destinate ai dispositivi non richiedono alcuna impostazione aggiuntiva e sono abilitate per impostazione predefinita quando l'applicazione è abilitata per {{site.data.keyword.mobilepushshort}}. - -Tuttavia, le notifiche Unicast indirizzate agli utenti richiedono l'associazione di un ID utente a un dispositivo al momento della registrazione del dispositivo mobile client o del browser web o delle estensioni e delle applicazioni Chrome per {{site.data.keyword.mobilepushshort}}. - -Normalmente, un'applicazione client prima eseguirà un ciclo di autenticazione in cui l'utente dell'applicazione mobile viene autenticato in un servizio di autenticazione come [Mobile Client Access](docs/services/mobileaccess/index.html). Dopo la corretta autenticazione, l'ID dell'utente autenticato viene trasmesso all'API Push Device Registration. -Per inviare notifiche Unicast tramite l'API REST, assicurati che gli ID del dispositivo o dell'utente siano forniti durante l'inserimento in una risorsa messaggi. - -###Notifiche basate sulla piattaforma -{: platform-based-notifications} - -Il recapito delle notifiche può essere destinato a una specifica piattaforma di dispositivo. Ad esempio, una notifica può essere inviata solo a tutti gli utenti Android o solo agli utenti Google Chrome. Per inviare una notifica basata sulla - piattaforma che utilizza la API REST, assicurati che le piattaforme - di destinazione siano fornite all'inserimento in una risorsa messaggi. Specifica - le piattaforme come un array. Le piattaforme supportate sono: -* A (Apple) -* G (Google) -* WEB_CHROME (Google Chrome Browser Web Push) -* WEB_FIREFOX (Mozilla Firefox Browser Web Push) -* WEB_SAFARI (Safari Browser Web Push) -* APPEXT_CHROME (Google Chrome Apps & Extensions) - -## Dimensione messaggio {{site.data.keyword.mobilepushshort}} -{: #push-message-size} - -La dimensione del payload del messaggio di {{site.data.keyword.mobilepushshort}} dipende dai vincoli disposti dai gateway (FCM/GCM, APNs) e dalle piattaforme client. - -### iOS e Safari -{: ios-message-size} - -Per iOS 8 e successivi, la dimensione massima consentita è 2 kilobyte. Il Push Notification service per Apple non invia notifiche che superano questo limite. - -###Estensioni Android, browser Firefox, browser Chrome e applicazioni Chrome & -{: android-message-size} - -Esiste una limitazione di 4 kilobyte come massimo consentito per la dimensione del payload del messaggio. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Informazioni su {{site.data.keyword.mobilepushshort}} +{: #overview-push} +Ultimo aggiornamento: 18 gennaio 2017 +{: .last-updated} + +IBM {{site.data.keyword.mobilepushshort}} è un servizio che puoi utilizzare per inviare notifiche a dispositivi e piattaforme. Le notifiche possono essere destinate a tutti gli utenti dell'applicazione oppure a uno specifico insieme di utenti e dispositivi facendo uso delle tag. Puoi amministrare dispositivi, tag e sottoscrizioni. + +Puoi utilizzare una delle seguenti opzioni per creare un servizio associato o non associato: + +- Creando un'applicazione Bluemix mediante il contenitore tipo MobileFirst Services Starter dal catalogo. In questo modo si crea un servizio Push Notifications associato a un'applicazione di backend Bluemix. +- Creando un servizio Push Notifications non associato direttamente dal catalogo Mobile. Puoi associarlo in seguito a un'applicazione o scegliere di utilizzarlo non associato. +- Utilizzando il [dashboard Mobile ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://console.ng.bluemix.net/docs/mobile/services.html "Icona link esterno"){: new_window}. + +Tieni presente che la scheda di monitoraggio di {{site.data.keyword.mobilepushshort}} non visualizza dati di analisi. + +Il servizio {{site.data.keyword.mobilepushshort}} è ora abilitato con OpenWhisk. Per ulteriori informazioni, vedi [OpenWhisk](/docs/openwhisk/index.html). + + +## Processo del servizio {{site.data.keyword.mobilepushshort}} +{: #overview_push_process} + +I client browser web, mobili e le estensioni e le applicazioni Google Chrome possono sottoscriversi e registrarsi per il servizio {{site.data.keyword.mobilepushshort}}. All'avvio, le applicazioni client si registrano al servizio {{site.data.keyword.mobilepushshort}} e lo sottoscrivono. Le notifiche vengono spedite al servizio APNS (Apple Push Notification Service) o al server FCM (Firebase Cloud Messaging)/GCM (Google Cloud Messaging) e inviate quindi ai client mobili o browser registrati. + +![Panoramica Push](images/overview.jpg) + + +### Applicazioni mobili e browser +{: mobile-applications} + +All'avvio, le applicazioni client si registrano al servizio {{site.data.keyword.mobilepushshort}} e lo sottoscrivono per ricevere notifiche. + +### Applicazioni di backend +{: backend-applications} + +Le applicazioni di backend possono essere in loco o in un cloud pubblico. Le applicazioni di backend utilizzeranno il servizio {{site.data.keyword.mobilepushshort}} per inviare notifiche sensibili al contesto agli utenti mobili o browser. Le applicazioni di backend non devono necessariamente conservare e gestire informazioni sugli utenti, sugli agent browser e sui dispositivi mobili per inviare notifiche di push. Invece, le applicazioni di backend possono utilizzare il servizio {{site.data.keyword.mobilepushshort}} che le gestisce e mantiene. + +### Proprietario backend applicazione +{: app-backend-owner} + +Il proprietario del backend dell'applicazione crea l'applicazione di backend mobile che aggrega un'istanza al servizio {{site.data.keyword.mobilepushshort}}. Il proprietario del backend dell'applicazione configurare inoltre il servizio {{site.data.keyword.mobilepushshort}} in modo che le applicazioni di backend utilizzino il servizio con le applicazioni mobili e browser destinate a {{site.data.keyword.mobilepushshort}}. + +### Servizio {{site.data.keyword.mobilepushshort}} +{: push-notification-service} + +Il servizio {{site.data.keyword.mobilepushshort}} gestisce tutte le informazioni relative ai dispositivi mobili e ai client browser web registrati per le notifiche. Il servizio fornisce alle tue applicazioni la trasparenza dei dettagli di tecnologia relativi all'invio di notifiche a queste eterogenee piattaforme mobili e browser web, gestendo tutto questo internamente. + +### Gateway +{: gateways} + +Servizi cloud specifici per piattaforme quali FCM/GCM o APNS (Apple Push Notification Service) utilizzati dal servizio {{site.data.keyword.mobilepushshort}} IBM per inviare notifiche alle applicazioni mobili e browser. + +### Sicurezza push +{: push-security} + +Le API {{site.data.keyword.mobilepushshort}} sono protette da due tipi di segreti: + +- **appSecret**: 'appSecret' protegge le API normalmente richiamate dalle applicazioni di backend, come l'API per inviare {{site.data.keyword.mobilepushshort}} e l'API per configurare le impostazioni. +- **clientSecret**: 'clientSecret' protegge le API normalmente richiamate dalle applicazioni client mobili. È presente solo un'API correlata alla registrazione di un dispositivo con un ID utente associato che richiede 'clientSecret'. Nessuna delle altre API richiamate dai client mobili richiede il clientSecret. + +'appSecret' e 'clientSecret' sono assegnati a ogni istanza del servizio al momento del bind di un'applicazione al servizio {{site.data.keyword.mobilepushshort}}. Fai riferimento alla documentazione [API REST ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno") per informazioni su come i segreti vengono trasmessi e a quale API. + +**Nota**: sono necessarie le precedenti applicazioni per trasmettere il clientSecret solo quando viene seguita la registrazione o l'aggiornamento dei dispositivi con il campo userID. Tutte le altre API richiamate dai client mobili e browser non richiedono il clientSecret. Queste vecchie applicazioni possono continuare ad utilizzare il clientSecret facoltativamente per le registrazioni del dispositivo o per l'aggiornamento delle chiamate. Tuttavia, è fortemente raccomandato che il controllo clientSecret venga applicato a tutte le chiamate API client. Per applicarlo alle applicazioni esistenti, è stata pubblicata una nuova API denominata 'verifyClientSecret'. Per le nuove applicazioni, il controllo clientSecret sarà imposto per tutte le chiamate API client e questo comportamento non può essere modificato con l'API 'verfiyClientSecret'. + +Per impostazione predefinita, la verifica del segreto client viene forzata solo nelle nuove applicazioni. Alle applicazioni nuove e esistenti è consentito abilitare o disabilitare la verifica del segreto client utilizzando l'API REST verifyClientSecret. Ti raccomandiamo di forzare la verifica del segreto client per evitare l'esposizione dei dispositivi agli utenti che possono conoscere il applicationId e il deviceId. + +Assicurati che il 'clientSecret' sia mantenuto confidenziale e non inserirlo mai nell'applicazione mobile. Esistono vari modelli di inizializzazione dell'applicazione che possono essere utilizzati per estrarre il 'clientSecret' dinamicamente durante il runtime delle applicazioni. Il diagramma della sequenza illustra il possibile modello. +![Enable_Push](images/init_client_secret.jpg) + +## Tipi di {{site.data.keyword.mobilepushshort}} +{: #overview-push-types} + +### Broadcast +{: broadcast} + +Quando un'applicazione client si registra al servizio {{site.data.keyword.mobilepushshort}}, può iniziare a ricevere i broadcast. Le notifiche broadcast sono messaggi destinati a tutte le istanze di un'applicazione installate nei dispositivi mobili, nei browser o implementate come applicazioni Chrome o istanze dell'estensione e configurate per il servizio {{site.data.keyword.mobilepushshort}}. Le notifiche broadcast sono abilitate per impostazione predefinita con qualsiasi applicazione abilitata per {{site.data.keyword.mobilepushshort}}. Le applicazioni abilitate per il servizio {{site.data.keyword.mobilepushshort}} hanno una sottoscrizione predefinita alla tag Push.ALL, che viene utilizzata dal server per eseguire il broadcast dei messaggi di notifica a tutti i dispositivi. Per inviare una notifica broadcast che utilizza la API Push + REST, assicurati che la destinazione ("target") sia un JSON vuoto all'inserimento nella + risorsa messaggi. + +### Notifiche basate sulle tag +{: tag-based-notifications} + +Le notifiche basate sulle tag sono messaggi destinati a tutti i dispositivi sottoscritti a una particolare tag. Le notifiche basate sulle tag + consentono la segmentazione di notifiche sulla base di argomenti o di aree + oggetto. I destinatari della notifica possono scegliere di ricevere le notifiche solo + se sono relative a un oggetto o a un argomento a cui sono interessati. Pertanto, + la notifica basata sulle tag fornisce un mezzo per segmentare i destinatari. Questa funzione + consente di definire delle tag e quindi di inviare e ricevere messaggi in + base alle tag. Un messaggio viene indirizzato solo alle istanze dell'applicazione client (mobili, browser o come un'applicazione o estensioni) sottoscritte a una tag. Devi prima creare le tag per l'applicazione, impostare le sottoscrizioni di tag e iniziare quindi le notifiche basate sulle tag. Per inviare una notifica basata sulle tag che utilizza la API REST, assicurati che i "tagName" siano forniti all'inserimento nella risorsa messaggi. + +### Notifiche Unicast +{: unicast-notifications} + +Le notifiche Unicast sono messaggi destinati a un dispositivo o un utente particolare. Le notifiche Unicast destinate ai dispositivi non richiedono alcuna impostazione aggiuntiva e sono abilitate per impostazione predefinita quando l'applicazione è abilitata per {{site.data.keyword.mobilepushshort}}. + +Tuttavia, le notifiche Unicast indirizzate agli utenti richiedono l'associazione di un ID utente a un dispositivo al momento della registrazione del dispositivo mobile client o del browser web o delle estensioni e delle applicazioni Chrome per {{site.data.keyword.mobilepushshort}}. + +Normalmente, un'applicazione client prima eseguirà un ciclo di autenticazione in cui l'utente dell'applicazione mobile viene autenticato in un servizio di autenticazione come [Mobile Client Access](docs/services/mobileaccess/index.html). Dopo la corretta autenticazione, l'ID dell'utente autenticato viene trasmesso all'API Push Device Registration. +Per inviare notifiche Unicast tramite l'API REST, assicurati che gli ID del dispositivo o dell'utente siano forniti durante l'inserimento in una risorsa messaggi. + +### Notifiche basate sulla piattaforma +{: platform-based-notifications} + +Il recapito delle notifiche può essere destinato a una specifica piattaforma di dispositivo. Ad esempio, una notifica può essere inviata solo a tutti gli utenti Android o solo agli utenti Google Chrome. Per inviare una notifica basata sulla + piattaforma che utilizza la API REST, assicurati che le piattaforme + di destinazione siano fornite all'inserimento in una risorsa messaggi. Specifica + le piattaforme come un array. Le piattaforme supportate sono: +* A (Apple) +* G (Google) +* WEB_CHROME (Google Chrome Browser Web Push) +* WEB_FIREFOX (Mozilla Firefox Browser Web Push) +* WEB_SAFARI (Safari Browser Web Push) +* APPEXT_CHROME (Google Chrome Apps & Extensions) + +## Dimensione messaggio {{site.data.keyword.mobilepushshort}} +{: #push-message-size} + +La dimensione del payload del messaggio di {{site.data.keyword.mobilepushshort}} dipende dai vincoli disposti dai gateway (FCM/GCM, APNs) e dalle piattaforme client. + +### iOS e Safari +{: ios-message-size} + +Per iOS 8 e successivi, la dimensione massima consentita è 2 kilobyte. Il Push Notification service per Apple non invia notifiche che superano questo limite. + +### Estensioni Android, browser Firefox, browser Chrome e applicazioni Chrome & +{: android-message-size} + +Esiste una limitazione di 4 kilobyte come massimo consentito per la dimensione del payload del messaggio. diff --git a/services/mobilepush/nl/it/c_rich_media_notifications.md b/services/mobilepush/nl/it/c_rich_media_notifications.md index c84840631..1002f0ed5 100644 --- a/services/mobilepush/nl/it/c_rich_media_notifications.md +++ b/services/mobilepush/nl/it/c_rich_media_notifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Abilitazione delle notifiche Rich Media -{: #interactive-notifications} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - - -Puoi abilitare Rich Media {{site.data.keyword.mobilepushshort}} in iOS 10 e superiore. Le notifiche di push possono essere inviate con audio, video, GIF e immagini. - -Per configurare la tua applicazione per ricevere rich push su iOS 10, completa la procedura: - -1. In Xcode, seleziona **File** > **New** > **Target** > **Notification Service Extension**. -2. Sul metodo `didReceive()` in `UNNotificationServiceExtension`, aggiungi il codice. -``` -BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) -``` - -Per inviare un Rich Media {{site.data.keyword.mobilepushshort}} dal dashboard Push, assicurati di specificare i campi relativi a messaggio, titolo, sottotitolo e URL allegato. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Abilitazione delle notifiche Rich Media +{: #interactive-notifications} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + + +Puoi abilitare Rich Media {{site.data.keyword.mobilepushshort}} in iOS 10 e superiore. Le notifiche di push possono essere inviate con audio, video, GIF e immagini. + +Per configurare la tua applicazione per ricevere rich push su iOS 10, completa la procedura: + +1. In Xcode, seleziona **File** > **New** > **Target** > **Notification Service Extension**. +2. Sul metodo `didReceive()` in `UNNotificationServiceExtension`, aggiungi il codice. +``` +BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) +``` + +Per inviare un Rich Media {{site.data.keyword.mobilepushshort}} dal dashboard Push, assicurati di specificare i campi relativi a messaggio, titolo, sottotitolo e URL allegato. diff --git a/services/mobilepush/nl/it/c_tag_basednotifications.md b/services/mobilepush/nl/it/c_tag_basednotifications.md index 1deecd554..0ab798b4f 100755 --- a/services/mobilepush/nl/it/c_tag_basednotifications.md +++ b/services/mobilepush/nl/it/c_tag_basednotifications.md @@ -1,23 +1,23 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Abilitazione di notifiche basate sulle tag -{: #tag_based_notifications} -Ultimo aggiornamento: 16 gennaio 2017 -{: .last-updated} - -I messaggi di notifica basata su tag sono destinati a tutti i dispositivi sottoscritti una specifica tag. - -Puoi definire le tag e quindi utilizzarle per - inviare e ricevere messaggi. Devi prima creare le tag per l'applicazione, impostare - le sottoscrizioni di tag e iniziare quindi le notifiche basate sulle - tag. Per inviare una notifica basata sulle tag utilizzando la [API REST](https://mobile.{DomainName}/imfpush/){: new_window}, assicurati che i "tagName" siano forniti durante l'inserimento nella risorsa messaggi. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Abilitazione di notifiche basate sulle tag +{: #tag_based_notifications} +Ultimo aggiornamento: 16 gennaio 2017 +{: .last-updated} + +I messaggi di notifica basata su tag sono destinati a tutti i dispositivi sottoscritti una specifica tag. + +Puoi definire le tag e quindi utilizzarle per + inviare e ricevere messaggi. Devi prima creare le tag per l'applicazione, impostare + le sottoscrizioni di tag e iniziare quindi le notifiche basate sulle + tag. Per inviare una notifica basata sulle tag utilizzando la [API REST](https://mobile.{DomainName}/imfpush/){: new_window}, assicurati che i "tagName" siano forniti durante l'inserimento nella risorsa messaggi. diff --git a/services/mobilepush/nl/it/c_user_basednotifications.md b/services/mobilepush/nl/it/c_user_basednotifications.md index 2bb7c93ca..3cb300477 100755 --- a/services/mobilepush/nl/it/c_user_basednotifications.md +++ b/services/mobilepush/nl/it/c_user_basednotifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Abilitazione delle notifiche basate sull'utente -{: #user_based_notifications} -Ultimo aggiornamento: 16 gennaio 2017 -{: .last-updated} - -Le {{site.data.keyword.mobilepushshort}} basate su ID utente sono destinate agli utenti dell'applicazione mobile con messaggi personalizzati. Con le notifiche basate sull'utente, puoi scegliere di inviare la notifica a delle persone specifiche in base alle rispettive preferenze. - -## Registrazione del dispositivo con l'ID utente -Per abilitare le notifiche di push indirizzate dall'ID utente, assicurati di aver registrato il dispositivo con un campo ID utente impostato. - -L'ID utente può essere una qualsiasi stringa fornita dall'applicazione all'API di registrazione del dispositivo. Normalmente, un'applicazione mobile prima eseguirà un ciclo di autenticazione in cui l'utente dell'applicazione mobile viene autenticato in un servizio di autenticazione come [{{site.data.keyword.amafull}} ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html "Icona link esterno"){: new_window}. Dopo la corretta autenticazione, l'ID dell'utente autenticato viene trasmesso all'API Push Device Registration. - -## Sincronizzazione di accesso/disconnessione dell'utente - -Puoi scegliere di inviare le notifiche solo se l'utente ha effettuato l'accesso. - -Ad esempio, prendi in considerazione un dispositivo condiviso dai membri di una famiglia o un team di lavoro e che ci sia bisogno di indirizzare utenti specifici. In questo caso di utilizzo, dovrebbe esserci una sequenza di accesso e disconnessione utente. Questo meccanismo di autenticazione consente alll'applicazione di tracciare l'identità dell'utente presente dell'applicazione. Questo assicura che le notifiche destinate a un'utente specifico siano sempre ricevute solo da tale utente. Dopo un accesso corretto, richiama l'API di registrazione del dispositivo trasmettendo l'ID utente dell'utente che ha eseguito l'accesso. Allo stesso modo, prima della disconnessione, richiama l'API di annullamento della registrazione del dispositivo. La sequenza di queste API push con accesso e disconnessione ti assicurerà che le notifiche pensate per un utente specifico siano inviate solo a tale utente. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Abilitazione delle notifiche basate sull'utente +{: #user_based_notifications} +Ultimo aggiornamento: 16 gennaio 2017 +{: .last-updated} + +Le {{site.data.keyword.mobilepushshort}} basate su ID utente sono destinate agli utenti dell'applicazione mobile con messaggi personalizzati. Con le notifiche basate sull'utente, puoi scegliere di inviare la notifica a delle persone specifiche in base alle rispettive preferenze. + +## Registrazione del dispositivo con l'ID utente +Per abilitare le notifiche di push indirizzate dall'ID utente, assicurati di aver registrato il dispositivo con un campo ID utente impostato. + +L'ID utente può essere una qualsiasi stringa fornita dall'applicazione all'API di registrazione del dispositivo. Normalmente, un'applicazione mobile prima eseguirà un ciclo di autenticazione in cui l'utente dell'applicazione mobile viene autenticato in un servizio di autenticazione come [{{site.data.keyword.amafull}} ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html "Icona link esterno"){: new_window}. Dopo la corretta autenticazione, l'ID dell'utente autenticato viene trasmesso all'API Push Device Registration. + +## Sincronizzazione di accesso/disconnessione dell'utente + +Puoi scegliere di inviare le notifiche solo se l'utente ha effettuato l'accesso. + +Ad esempio, prendi in considerazione un dispositivo condiviso dai membri di una famiglia o un team di lavoro e che ci sia bisogno di indirizzare utenti specifici. In questo caso di utilizzo, dovrebbe esserci una sequenza di accesso e disconnessione utente. Questo meccanismo di autenticazione consente alll'applicazione di tracciare l'identità dell'utente presente dell'applicazione. Questo assicura che le notifiche destinate a un'utente specifico siano sempre ricevute solo da tale utente. Dopo un accesso corretto, richiama l'API di registrazione del dispositivo trasmettendo l'ID utente dell'utente che ha eseguito l'accesso. Allo stesso modo, prima della disconnessione, richiama l'API di annullamento della registrazione del dispositivo. La sequenza di queste API push con accesso e disconnessione ti assicurerà che le notifiche pensate per un utente specifico siano inviate solo a tale utente. diff --git a/services/mobilepush/nl/it/c_web_extensions.md b/services/mobilepush/nl/it/c_web_extensions.md index 0190f27d2..8a949eb2c 100644 --- a/services/mobilepush/nl/it/c_web_extensions.md +++ b/services/mobilepush/nl/it/c_web_extensions.md @@ -1,107 +1,107 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Abilitazione delle estensioni e delle applicazioni Chrome a ricevere {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -Ultimo aggiornamento: 18 gennaio 2017 -{: .last-updated} - -Puoi abilitare le estensioni e le applicazioni Google Chrome a ricevere {{site.data.keyword.mobilepushshort}}. Assicurati di aver consultato [Configurazione delle credenziali per un provider di notifica](t__main_push_config_provider.html) prima di continuare con la procedura. - -## Installazione dell'SDK client per {{site.data.keyword.mobilepushshort}} -{: #web_install} - -Questo argomento descrive come installare e utilizzare il JavaScript Push SDK client per sviluppare ulteriormente le tue estensioni e applicazioni Chrome. - -### Inizializzazione delle estensioni e delle applicazioni Google Chrome - -Per l'installazione dell'SDK Javascript SDK nelle estensioni e applicazioni Chrome completa la seguente procedura: - -Scarica `BMSPushSDK.js` e `manifest_Chrome_Ext.json` (per le estensioni Chrome) o `manifest_Chrome_App.json` (per le applicazioni Chrome) dalla [SDK di push web di Bluemix ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master "Icona link esterno"){: new_window}. - - - -- Per le applicazioni Chrome, configura il file manifest: - 1. Nel file `manifest_Chrome_App.json`, fornisci il nome, la descrizione e le icone. - 2. Aggiungi `BMSPushSDK.js` in `app.background.scripts`. - 3. Modifica `manifest_Chrome_App.json` in `manifest.json`. - -- Per le estensioni Chrome, configura il file manifest: - 1. Nel file `manifest_Chrome_Ext.json` fornisci nome, descrizione e icone. - 2. Aggiungi `BMSPushSDK.js` in `background.scripts`. - 3. Modifica `manifest_Chrome_Ext.json` in `manifest.json`. - -Nel file `background.js` aggiungi quanto segue per ricevere le notifiche push -``` -chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) -chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); -chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); -``` - {: codeblock} - - - -## Inizializzazione della SDK di push -{: #web_initialize} - -Inizializza la SDK di push con `app GUID` e `app Region` del servizio {{site.data.keyword.mobilepushshort}} di Bluemix. - -Per ottenere il tuo GUID dell'applicazione, seleziona l'opzione **Configurazione** nel pannello di navigazione per i servizi di push inizializzati e fai clic su **Opzioni mobili**. Modifica il frammento di codice per utilizzare il tuo parametro appGUID del servizio di notifiche di push di Bluemix. - -`App Region` specifica l'ubicazione in cui è ospitato il servizio {{site.data.keyword.mobilepushshort}}. Puoi utilizzare uno dei seguenti tre valori: - - - Per Dallas Stati Uniti: `.ng.bluemix.net` - - Per il Regno unito: `.eu-gb.bluemix.net` - - Per Sydney: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) -``` - {: codeblock} - -## Registrazione delle estensioni e delle applicazioni Chrome -{: #web_register} - -Utilizza l'API `register()` per registrare il dispositivo con il servizio {{site.data.keyword.mobilepushshort}}. Per la registrazione da Google Chrome, aggiungi l'URL del sito web e la chiave API di FCM (Firebase Cloud Messaging) o GCM (Google Cloud Messaging) nel dashboard di configurazione web del servizio {{site.data.keyword.mobilepushshort}} di Bluemix. Per ulteriori informazioni, consulta [Configurazione delle credenziali per GCM (Google Cloud Messaging)](t_push_provider_android.html) nelle impostazioni di Chrome. - -Per la registrazione da Mozilla Firefox, aggiungi l'URL del sito web nel dashboard di configurazione web del servizio {{site.data.keyword.mobilepushshort}} di Bluemix nelle impostazioni di Firefox. - -Utilizza il seguente frammento di codice per registrare il servizio {{site.data.keyword.mobilepushshort}} di Bluemix. -``` -var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Abilitazione delle estensioni e delle applicazioni Chrome a ricevere {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +Ultimo aggiornamento: 18 gennaio 2017 +{: .last-updated} + +Puoi abilitare le estensioni e le applicazioni Google Chrome a ricevere {{site.data.keyword.mobilepushshort}}. Assicurati di aver consultato [Configurazione delle credenziali per un provider di notifica](t__main_push_config_provider.html) prima di continuare con la procedura. + +## Installazione dell'SDK client per {{site.data.keyword.mobilepushshort}} +{: #web_install} + +Questo argomento descrive come installare e utilizzare il JavaScript Push SDK client per sviluppare ulteriormente le tue estensioni e applicazioni Chrome. + +### Inizializzazione delle estensioni e delle applicazioni Google Chrome + +Per l'installazione dell'SDK Javascript SDK nelle estensioni e applicazioni Chrome completa la seguente procedura: + +Scarica `BMSPushSDK.js` e `manifest_Chrome_Ext.json` (per le estensioni Chrome) o `manifest_Chrome_App.json` (per le applicazioni Chrome) dalla [SDK di push web di Bluemix ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master "Icona link esterno"){: new_window}. + + + +- Per le applicazioni Chrome, configura il file manifest: + 1. Nel file `manifest_Chrome_App.json`, fornisci il nome, la descrizione e le icone. + 2. Aggiungi `BMSPushSDK.js` in `app.background.scripts`. + 3. Modifica `manifest_Chrome_App.json` in `manifest.json`. + +- Per le estensioni Chrome, configura il file manifest: + 1. Nel file `manifest_Chrome_Ext.json` fornisci nome, descrizione e icone. + 2. Aggiungi `BMSPushSDK.js` in `background.scripts`. + 3. Modifica `manifest_Chrome_Ext.json` in `manifest.json`. + +Nel file `background.js` aggiungi quanto segue per ricevere le notifiche push +``` +chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) +chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); +chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); +``` + {: codeblock} + + + +## Inizializzazione della SDK di push +{: #web_initialize} + +Inizializza la SDK di push con `app GUID` e `app Region` del servizio {{site.data.keyword.mobilepushshort}} di Bluemix. + +Per ottenere il tuo GUID dell'applicazione, seleziona l'opzione **Configurazione** nel pannello di navigazione per i servizi di push inizializzati e fai clic su **Opzioni mobili**. Modifica il frammento di codice per utilizzare il tuo parametro appGUID del servizio di notifiche di push di Bluemix. + +`App Region` specifica l'ubicazione in cui è ospitato il servizio {{site.data.keyword.mobilepushshort}}. Puoi utilizzare uno dei seguenti tre valori: + + - Per Dallas Stati Uniti: `.ng.bluemix.net` + - Per il Regno unito: `.eu-gb.bluemix.net` + - Per Sydney: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) +``` + {: codeblock} + +## Registrazione delle estensioni e delle applicazioni Chrome +{: #web_register} + +Utilizza l'API `register()` per registrare il dispositivo con il servizio {{site.data.keyword.mobilepushshort}}. Per la registrazione da Google Chrome, aggiungi l'URL del sito web e la chiave API di FCM (Firebase Cloud Messaging) o GCM (Google Cloud Messaging) nel dashboard di configurazione web del servizio {{site.data.keyword.mobilepushshort}} di Bluemix. Per ulteriori informazioni, consulta [Configurazione delle credenziali per GCM (Google Cloud Messaging)](t_push_provider_android.html) nelle impostazioni di Chrome. + +Per la registrazione da Mozilla Firefox, aggiungi l'URL del sito web nel dashboard di configurazione web del servizio {{site.data.keyword.mobilepushshort}} di Bluemix nelle impostazioni di Firefox. + +Utilizza il seguente frammento di codice per registrare il servizio {{site.data.keyword.mobilepushshort}} di Bluemix. +``` +var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + diff --git a/services/mobilepush/nl/it/c_web_extensions_send.md b/services/mobilepush/nl/it/c_web_extensions_send.md index d112473fa..e1fb57c77 100644 --- a/services/mobilepush/nl/it/c_web_extensions_send.md +++ b/services/mobilepush/nl/it/c_web_extensions_send.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Inviare le notifiche di base alle estensioni e alle applicazioni Chrome -{: #web_extensions_notifications} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - -Dopo che hai sviluppato le tue applicazioni, puoi inviare una notifica push. - -1. Seleziona **Send Notifications** e componi un messaggio scegliendo **Web Notifications** come l'opzione **Send To**. -2. Immetti il messaggio che deve essere consegnato nel campo **Message**. -3. Puoi scegliere di fornire delle impostazioni facoltative: - - **Titolo della notifica**: questo è il testo che deve essere visualizzato nell'intestazione dell'avviso del messaggio. - - **URL dell'icona di notifica**: se il tuo messaggio deve essere consegnato con un'icona di notifica dell'applicazione, fornisci il link alla tua icona nel campo. - - **Chiave di compressione**: le chiavi di compressione solo allegate alle notifiche. Se più notifiche arrivano in sequenza con la stessa chiave di compressione quando il dispositivo è offline, esse vengono compresse. Quando un dispositivo va online, riceve le notifiche dal server FCM/GCM e visualizza solo l'ultima notifica rilevando la stessa chiave di compressione. Se la chiave di compressione non viene inviata, sia il nuovo che il vecchio messaggio vengono archiviati per una consegna successiva. - - **TTL (Time to live)**: questo valore è impostato in secondi. Se questo parametro non viene specificato, il server FCM/GCM archivia il messaggio per quattro settimane e tenterà di consegnarlo. La validità scade dopo quattro settimane. L'intervallo di valori possibile è compreso tra 0 e 2,419,200 secondi. - - **Ritarda quando inattivo**: impostando questo valore su `true` si danno istruzioni al server FCM/GCM di non consegnare la notifica se il dispositivo è inattivo. Imposta questo valore su `false`, per assicurati di consegnare la notifica anche se il dispositivo è inattivo. - - **Payload addizionale**: specifica i valori di payload personalizzati per le tue notifiche. - -La seguente immagine mostra l'opzione delle notifiche alle estensioni e applicazioni Chrome nel dashboard. - - ![Schermata notifiche](images/push_chrome_extns.jpg) - -## Fasi successive - {: #next_steps_tags} - -Dopo che hai correttamente configurato le notifiche di base, puoi scegliere di configurare le notifiche basate sulle tag e le opzioni avanzate. - -Aggiungi queste funzioni del servizio {{site.data.keyword.mobilepushshort}} alla tua applicazione. Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche avanzate](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Inviare le notifiche di base alle estensioni e alle applicazioni Chrome +{: #web_extensions_notifications} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + +Dopo che hai sviluppato le tue applicazioni, puoi inviare una notifica push. + +1. Seleziona **Send Notifications** e componi un messaggio scegliendo **Web Notifications** come l'opzione **Send To**. +2. Immetti il messaggio che deve essere consegnato nel campo **Message**. +3. Puoi scegliere di fornire delle impostazioni facoltative: + - **Titolo della notifica**: questo è il testo che deve essere visualizzato nell'intestazione dell'avviso del messaggio. + - **URL dell'icona di notifica**: se il tuo messaggio deve essere consegnato con un'icona di notifica dell'applicazione, fornisci il link alla tua icona nel campo. + - **Chiave di compressione**: le chiavi di compressione solo allegate alle notifiche. Se più notifiche arrivano in sequenza con la stessa chiave di compressione quando il dispositivo è offline, esse vengono compresse. Quando un dispositivo va online, riceve le notifiche dal server FCM/GCM e visualizza solo l'ultima notifica rilevando la stessa chiave di compressione. Se la chiave di compressione non viene inviata, sia il nuovo che il vecchio messaggio vengono archiviati per una consegna successiva. + - **TTL (Time to live)**: questo valore è impostato in secondi. Se questo parametro non viene specificato, il server FCM/GCM archivia il messaggio per quattro settimane e tenterà di consegnarlo. La validità scade dopo quattro settimane. L'intervallo di valori possibile è compreso tra 0 e 2,419,200 secondi. + - **Ritarda quando inattivo**: impostando questo valore su `true` si danno istruzioni al server FCM/GCM di non consegnare la notifica se il dispositivo è inattivo. Imposta questo valore su `false`, per assicurati di consegnare la notifica anche se il dispositivo è inattivo. + - **Payload addizionale**: specifica i valori di payload personalizzati per le tue notifiche. + +La seguente immagine mostra l'opzione delle notifiche alle estensioni e applicazioni Chrome nel dashboard. + + ![Schermata notifiche](images/push_chrome_extns.jpg) + +## Fasi successive + {: #next_steps_tags} + +Dopo che hai correttamente configurato le notifiche di base, puoi scegliere di configurare le notifiche basate sulle tag e le opzioni avanzate. + +Aggiungi queste funzioni del servizio {{site.data.keyword.mobilepushshort}} alla tua applicazione. Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche avanzate](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/it/images/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/it/images/t_enable_actionable_notifications_ios.md index fd1f6e2bb..2852f4a94 100755 --- a/services/mobilepush/nl/it/images/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/it/images/t_enable_actionable_notifications_ios.md @@ -1,107 +1,107 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Abilitazione di notifiche operative per iOS -{: #enable-actionable-notifications-ios} - -A differenza delle notifiche di push tradizionali, le notifiche operative richiedono agli utenti di effettuare una selezione al momento della ricezione dell'avviso di notifica senza aprire l'applicazione. Utilizza le seguenti istruzioni per abilitare le notifiche di push operative nella tua applicazione. - -1. Crea un'azione di risposta utente. - - Objective-C - - ``` - // Per Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. Crea la categoria di notifica e imposta un'azione. **UIUserNotificationActionContextDefault** o - **UIUserNotificationActionContextMinimal** sono -contesti validi. - - Objective-C - - ``` - // Per Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // Per Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. Crea l'impostazione di notifica e assegna le categorie -dal passo precedente. - - Objective-C - - ``` - // Per Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // Per Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. Crea la notifica locale o remota e assegnale -l'identità della categoria. - - Objective-C - - ``` - //Per Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //Per Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Abilitazione di notifiche operative per iOS +{: #enable-actionable-notifications-ios} + +A differenza delle notifiche di push tradizionali, le notifiche operative richiedono agli utenti di effettuare una selezione al momento della ricezione dell'avviso di notifica senza aprire l'applicazione. Utilizza le seguenti istruzioni per abilitare le notifiche di push operative nella tua applicazione. + +1. Crea un'azione di risposta utente. + + Objective-C + + ``` + // Per Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. Crea la categoria di notifica e imposta un'azione. **UIUserNotificationActionContextDefault** o + **UIUserNotificationActionContextMinimal** sono +contesti validi. + + Objective-C + + ``` + // Per Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // Per Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. Crea l'impostazione di notifica e assegna le categorie +dal passo precedente. + + Objective-C + + ``` + // Per Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // Per Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. Crea la notifica locale o remota e assegnale +l'identità della categoria. + + Objective-C + + ``` + //Per Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //Per Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/it/index.md b/services/mobilepush/nl/it/index.md index a1cb923ee..6cbd99adc 100644 --- a/services/mobilepush/nl/it/index.md +++ b/services/mobilepush/nl/it/index.md @@ -1,54 +1,54 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Introduzione a {{site.data.keyword.mobilepushshort}} -{: #gettingstartedtemplate} -Ultimo aggiornamento: 19 gennaio 2017 -{: .last-updated} - -{:shortdesc} - -{{site.data.keyword.mobilepushshort}} è disponibile come servizio del Catalogo Bluemix nella categoria Mobile e ti consente di inviare e gestire le notifiche di push mobili e web. Il servizio gestisce l'associazione dei tuoi utenti dell'applicazione ai loro dispositivi, alla loro piattaforma del dispositivo e ai loro browser web e regola l'invio delle notifiche. - - {{site.data.keyword.mobilepushshort}} è disponibile come parte del contenitore tipo MobileFirst Services Starter e come [Servizio dedicato ](/docs/dedicated/index.html) Bluemix. Puoi utilizzare il servizio per inviare broadcast, unicast (basati su ID dispositivo e ID utente), notifiche basate su tag, notifiche basate sugli eventi webhook oltre alle notifiche Rich Media e interattive ai tuoi utenti delle applicazioni mobili e browser web. Puoi anche utilizzare un SDK (software development kit) e delle [API REST![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window} per sviluppare ulteriormente le tue applicazioni client. - -Il servizio fornisce inoltre delle funzionalità di monitoraggio che ti consentono di monitorare le prestazioni di Push Notification generando grafici e report dai dati dell'utente. Vedi [Monitoraggio di Push Notifications](/docs/services/mobilepush/t_push_monitoring.html). - -Il servizio {{site.data.keyword.mobilepushshort}} è supportato nelle seguenti piattaforme: - -- [Dispositivi mobili iOS e Android](/docs/services/mobilepush/c_enable_push.html) -- [Browser web Google Chrome, Mozilla Firefox e Safari](/docs/services/mobilepush/c_chrome_firefox_enable.html) -- [Estensioni e applicazioni Google Chrome](/docs/services/mobilepush/c_web_extensions.html) - - -# Link correlati -{: #rellinks} - -* [Panoramica ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](c_overview_push.html "Icona link esterno"){: new_window} - -## Esercitazioni ed esempi {:id="samples"} -{: #samples} -* [Applicazione di esempio helloPush Android ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/ "Icona link esterno"){: new_window} -- [Applicazione di esempio Cordova ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush "Icona link esterno"){: new_window} -* [Applicazione di esempio helloPush iOS (Swift) ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush "Icona link esterno"){: new_window} - -## SDK -{: #sdk} -* [SDK Android ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push "Icona link esterno"){: new_window} -* [SDK Cordova ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push "Icona link esterno"){: new_window} -* [SDK iOS (Swift) ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master "Icona link esterno"){: new_window} - -## Guida di riferimento API -{: #api} -* [Riferimento API Push (Android) ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html "Icona link esterno"){: new_window} -* [iOS riferimento API BMSPush (Swift) ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html "Icona link esterno"){: new_window} -* [Riferimento API REST ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window} +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Introduzione a {{site.data.keyword.mobilepushshort}} +{: #gettingstartedtemplate} +Ultimo aggiornamento: 19 gennaio 2017 +{: .last-updated} + +{:shortdesc} + +{{site.data.keyword.mobilepushshort}} è disponibile come servizio del Catalogo Bluemix nella categoria Mobile e ti consente di inviare e gestire le notifiche di push mobili e web. Il servizio gestisce l'associazione dei tuoi utenti dell'applicazione ai loro dispositivi, alla loro piattaforma del dispositivo e ai loro browser web e regola l'invio delle notifiche. + + {{site.data.keyword.mobilepushshort}} è disponibile come parte del contenitore tipo MobileFirst Services Starter e come [Servizio dedicato ](/docs/dedicated/index.html) Bluemix. Puoi utilizzare il servizio per inviare broadcast, unicast (basati su ID dispositivo e ID utente), notifiche basate su tag, notifiche basate sugli eventi webhook oltre alle notifiche Rich Media e interattive ai tuoi utenti delle applicazioni mobili e browser web. Puoi anche utilizzare un SDK (software development kit) e delle [API REST![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window} per sviluppare ulteriormente le tue applicazioni client. + +Il servizio fornisce inoltre delle funzionalità di monitoraggio che ti consentono di monitorare le prestazioni di Push Notification generando grafici e report dai dati dell'utente. Vedi [Monitoraggio di Push Notifications](/docs/services/mobilepush/t_push_monitoring.html). + +Il servizio {{site.data.keyword.mobilepushshort}} è supportato nelle seguenti piattaforme: + +- [Dispositivi mobili iOS e Android](/docs/services/mobilepush/c_enable_push.html) +- [Browser web Google Chrome, Mozilla Firefox e Safari](/docs/services/mobilepush/c_chrome_firefox_enable.html) +- [Estensioni e applicazioni Google Chrome](/docs/services/mobilepush/c_web_extensions.html) + + +# Link correlati +{: #rellinks} + +* [Panoramica ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](c_overview_push.html "Icona link esterno"){: new_window} + +## Esercitazioni ed esempi {:id="samples"} +{: #samples} +* [Applicazione di esempio helloPush Android ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/ "Icona link esterno"){: new_window} +- [Applicazione di esempio Cordova ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush "Icona link esterno"){: new_window} +* [Applicazione di esempio helloPush iOS (Swift) ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush "Icona link esterno"){: new_window} + +## SDK +{: #sdk} +* [SDK Android ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push "Icona link esterno"){: new_window} +* [SDK Cordova ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push "Icona link esterno"){: new_window} +* [SDK iOS (Swift) ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master "Icona link esterno"){: new_window} + +## Guida di riferimento API +{: #api} +* [Riferimento API Push (Android) ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html "Icona link esterno"){: new_window} +* [iOS riferimento API BMSPush (Swift) ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html "Icona link esterno"){: new_window} +* [Riferimento API REST ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window} diff --git a/services/mobilepush/nl/it/interactive_notifications.md b/services/mobilepush/nl/it/interactive_notifications.md index 13e1b6bf5..893c2a611 100755 --- a/services/mobilepush/nl/it/interactive_notifications.md +++ b/services/mobilepush/nl/it/interactive_notifications.md @@ -1,83 +1,83 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Notifiche interattive -{: #interactive-notifications} -Ultimo aggiornamento: 23 gennaio 2017 -{: .last-updated} - -Le notifiche interattive consentono agli utenti di rispondere a una notifica senza aprire l'applicazione. Quando viene ricevuta una notifica, il dispositivo visualizza i pulsanti di azione insieme al messaggio di notifica. Le notifiche interattive sono supportare sui dispositivi iOS con versione 8 o successiva. Per le notifiche interattive inviate a dispositivi iOS precedenti alla versione 8, le azioni di notifica non vengono visualizzate. - -##Invio di {{site.data.keyword.mobilepushshort}} interattive - - -La notifica interattiva può essere inviata utilizzando il dashboard Push o utilizzando la [Documentazione API REST](t_restapi.html). - -Dalla console {{site.data.keyword.mobilepushshort}}: - -1. Nella scheda delle notifiche del dashboard Push, fai clic su **Invia notifica**. -2. Scegli i tuoi destinatari per la notifica e fai clic su **Avanti**. -3. Nella pagina di composizione della notifica, può essere inviato un push interattivo impostando il tipo su predefinito o misto e specificando il valore della categoria nella scheda del delle opzioni avanzate. Per configurare il valore della categoria sul client, controlla **Gestione {{site.data.keyword.mobilepushshort}}** interattiva nella sezione dell'applicazione iOS nativa. - -## Gestione {{site.data.keyword.mobilepushshort}} interattive in un'applicazione iOS - - -### Swift - -Completa la seguente procedura per ricevere le notifiche interattive: - -1. Abilita la funzionalità dell'applicazione ad eseguire attività in background per la ricezione di notifiche remote. -1. Inizializza l'SDK `BMSPush` con la tua categoria di azione. - ``` - let myBMSClient = BMSClient.sharedInstance - myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) - let push = BMSPushClient.sharedInstance - let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) - let notifOptions = BMSPushClientOptions(categoryName: [category]) - push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) - ``` - {: codeblock} - -1. Implementa il nuovo metodo di callback su AppDelegate: - ``` - func userNotificationCenter(_ center: UNUserNotificationCenter, - didReceive response: UNNotificationResponse, - withCompletionHandler completionHandler: @escaping () -> Void) { - switch response.actionIdentifier { - case "FIRST": - print("FIRST") - case "SECOND": - print("SECOND") - default: - print("Unknown action") - } - completionHandler - } - ``` - {: codeblock} -5. Questo nuovo metodo di callback viene richiamato quando l'utente fa clic sul pulsante azione. L'implementazione di questo metodo deve eseguire le azioni associate con l'identificativo specificato ed eseguire il blocco nel parametro `completionHandler`. - - -### Cordova - -Per ottenere una notifica operativa in un'applicazione iOS Cordova, completa la procedura: - -1. Aggiungi il campo di categoria all'interno del metodo `BMSPush.initialize`. - ``` - var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} - BMSPush.initialize(appGUID,clientSecret,category); - ``` - {: codeblock} -2. Implementa il nuovo metodo di callback su AppDelegate. -3. Questo nuovo metodo di callback viene richiamato quando l'utente fa clic sul pulsante azione. L'implementazione di questo metodo deve eseguire le attività associate con l'identificativo specificato ed eseguire il blocco nel parametro completionHandler. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Notifiche interattive +{: #interactive-notifications} +Ultimo aggiornamento: 23 gennaio 2017 +{: .last-updated} + +Le notifiche interattive consentono agli utenti di rispondere a una notifica senza aprire l'applicazione. Quando viene ricevuta una notifica, il dispositivo visualizza i pulsanti di azione insieme al messaggio di notifica. Le notifiche interattive sono supportare sui dispositivi iOS con versione 8 o successiva. Per le notifiche interattive inviate a dispositivi iOS precedenti alla versione 8, le azioni di notifica non vengono visualizzate. + +##Invio di {{site.data.keyword.mobilepushshort}} interattive + + +La notifica interattiva può essere inviata utilizzando il dashboard Push o utilizzando la [Documentazione API REST](t_restapi.html). + +Dalla console {{site.data.keyword.mobilepushshort}}: + +1. Nella scheda delle notifiche del dashboard Push, fai clic su **Invia notifica**. +2. Scegli i tuoi destinatari per la notifica e fai clic su **Avanti**. +3. Nella pagina di composizione della notifica, può essere inviato un push interattivo impostando il tipo su predefinito o misto e specificando il valore della categoria nella scheda del delle opzioni avanzate. Per configurare il valore della categoria sul client, controlla **Gestione {{site.data.keyword.mobilepushshort}}** interattiva nella sezione dell'applicazione iOS nativa. + +## Gestione {{site.data.keyword.mobilepushshort}} interattive in un'applicazione iOS + + +### Swift + +Completa la seguente procedura per ricevere le notifiche interattive: + +1. Abilita la funzionalità dell'applicazione ad eseguire attività in background per la ricezione di notifiche remote. +1. Inizializza l'SDK `BMSPush` con la tua categoria di azione. + ``` + let myBMSClient = BMSClient.sharedInstance + myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) + let push = BMSPushClient.sharedInstance + let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) + let notifOptions = BMSPushClientOptions(categoryName: [category]) + push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) + ``` + {: codeblock} + +1. Implementa il nuovo metodo di callback su AppDelegate: + ``` + func userNotificationCenter(_ center: UNUserNotificationCenter, + didReceive response: UNNotificationResponse, + withCompletionHandler completionHandler: @escaping () -> Void) { + switch response.actionIdentifier { + case "FIRST": + print("FIRST") + case "SECOND": + print("SECOND") + default: + print("Unknown action") + } + completionHandler + } + ``` + {: codeblock} +5. Questo nuovo metodo di callback viene richiamato quando l'utente fa clic sul pulsante azione. L'implementazione di questo metodo deve eseguire le azioni associate con l'identificativo specificato ed eseguire il blocco nel parametro `completionHandler`. + + +### Cordova + +Per ottenere una notifica operativa in un'applicazione iOS Cordova, completa la procedura: + +1. Aggiungi il campo di categoria all'interno del metodo `BMSPush.initialize`. + ``` + var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} + BMSPush.initialize(appGUID,clientSecret,category); + ``` + {: codeblock} +2. Implementa il nuovo metodo di callback su AppDelegate. +3. Questo nuovo metodo di callback viene richiamato quando l'utente fa clic sul pulsante azione. L'implementazione di questo metodo deve eseguire le attività associate con l'identificativo specificato ed eseguire il blocco nel parametro completionHandler. diff --git a/services/mobilepush/nl/it/next_steps_tags.md b/services/mobilepush/nl/it/next_steps_tags.md index a316a71f1..d3c86d436 100755 --- a/services/mobilepush/nl/it/next_steps_tags.md +++ b/services/mobilepush/nl/it/next_steps_tags.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Fasi successive -{: #next_steps_tags} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - -Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche basate sulle tag e le opzioni avanzate. - -Aggiungi queste funzioni del servizio {{site.data.keyword.mobilepushshort}} alla tua applicazione. -Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). -Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche di push avanzate](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Fasi successive +{: #next_steps_tags} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + +Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche basate sulle tag e le opzioni avanzate. + +Aggiungi queste funzioni del servizio {{site.data.keyword.mobilepushshort}} alla tua applicazione. +Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). +Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche di push avanzate](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/it/silent_notifications.md b/services/mobilepush/nl/it/silent_notifications.md index 82c27e5b8..81dd478a6 100755 --- a/services/mobilepush/nl/it/silent_notifications.md +++ b/services/mobilepush/nl/it/silent_notifications.md @@ -1,39 +1,39 @@ ------- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Gestione di notifiche automatiche per iOS -{: #silent-notifications} -Ultimo aggiornamento: 16 gennaio 2017 -{: .last-updated} - -Le notifiche automatiche non vengono visualizzate sulla schermata del dispositivo. Queste notifiche vengono ricevute dall'applicazione in background, che la attivano per 30 secondi in modo che esegua l'attività in background specificata. Un utente non viene avvisato dell'arrivo della notifica. Per inviare notifiche automatiche per iOS, utilizza l'[API REST ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window}. - -1. Per inviare notifiche automatiche, implementa il seguente metodo nel file `appDelegate.m` nel tuo progetto. In Swift, il valore `contentAvailable` inviato dal server per le notifiche automatiche è uguale a 1. -``` -// Per Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - let contentAPS = userInfo["aps"] as [NSObject : AnyObject] - if let contentAvailable = contentAPS["content-available"] as? Int { - //silent or mixed push - if contentAvailable == 1 { - completionHandler(UIBackgroundFetchResult.NewData) - } else { - completionHandler(UIBackgroundFetchResult.NoData) - } - } else { - //Notifica predefinita - completionHandler(UIBackgroundFetchResult.NoData) - } - } -``` - {: codeblock} - +------ + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Gestione di notifiche automatiche per iOS +{: #silent-notifications} +Ultimo aggiornamento: 16 gennaio 2017 +{: .last-updated} + +Le notifiche automatiche non vengono visualizzate sulla schermata del dispositivo. Queste notifiche vengono ricevute dall'applicazione in background, che la attivano per 30 secondi in modo che esegua l'attività in background specificata. Un utente non viene avvisato dell'arrivo della notifica. Per inviare notifiche automatiche per iOS, utilizza l'[API REST ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window}. + +1. Per inviare notifiche automatiche, implementa il seguente metodo nel file `appDelegate.m` nel tuo progetto. In Swift, il valore `contentAvailable` inviato dal server per le notifiche automatiche è uguale a 1. +``` +// Per Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + let contentAPS = userInfo["aps"] as [NSObject : AnyObject] + if let contentAvailable = contentAPS["content-available"] as? Int { + //silent or mixed push + if contentAvailable == 1 { + completionHandler(UIBackgroundFetchResult.NewData) + } else { + completionHandler(UIBackgroundFetchResult.NoData) + } + } else { + //Notifica predefinita + completionHandler(UIBackgroundFetchResult.NoData) + } + } +``` + {: codeblock} + diff --git a/services/mobilepush/nl/it/t__main_push_config_provider.md b/services/mobilepush/nl/it/t__main_push_config_provider.md index 5b6757cd2..409e5bfdb 100755 --- a/services/mobilepush/nl/it/t__main_push_config_provider.md +++ b/services/mobilepush/nl/it/t__main_push_config_provider.md @@ -1,21 +1,21 @@ - ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configurazione delle credenziali per un provider di notifica -{: #create-push-credentials} -Ultimo aggiornamento: 18 gennaio 2017 -{: .last-updated} - -Per configurare il servizio {{site.data.keyword.mobilepushshort}}, ottieni le credenziali richieste dal tuo provider di notifiche di push - Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) o Apple Push Notification Service ([APNs](t_push_provider_ios.html)) per i dispositivi mobili. Per i browser Web, vedi [Configurazione delle credenziali per i browser Web](t_push_provider_safari.html). - -Puoi configurare {{site.data.keyword.mobilepushshort}} utilizzando il Dashboard **IBM Bluemix Services** o mediante le [API REST ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window}. + +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configurazione delle credenziali per un provider di notifica +{: #create-push-credentials} +Ultimo aggiornamento: 18 gennaio 2017 +{: .last-updated} + +Per configurare il servizio {{site.data.keyword.mobilepushshort}}, ottieni le credenziali richieste dal tuo provider di notifiche di push - Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) o Apple Push Notification Service ([APNs](t_push_provider_ios.html)) per i dispositivi mobili. Per i browser Web, vedi [Configurazione delle credenziali per i browser Web](t_push_provider_safari.html). + +Puoi configurare {{site.data.keyword.mobilepushshort}} utilizzando il Dashboard **IBM Bluemix Services** o mediante le [API REST ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window}. diff --git a/services/mobilepush/nl/it/t_advance_badge_sound_payload.md b/services/mobilepush/nl/it/t_advance_badge_sound_payload.md index cc35dc0f9..129a43689 100755 --- a/services/mobilepush/nl/it/t_advance_badge_sound_payload.md +++ b/services/mobilepush/nl/it/t_advance_badge_sound_payload.md @@ -1,80 +1,80 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#Abilitazione delle {{site.data.keyword.mobilepushshort}} avanzate -Ultimo aggiornamento: 23 gennaio 2017 -{: .last-updated} - -Configura un badge iOS, audio, payload JSON aggiuntivo, notifiche operative e notifiche messe in pausa. - -## Configurazione di audio e payload e badge iOS -{: #badge-sound-payload} - -Configura un badge, l'audio e del payload JSON aggiuntivo iOS. - -1. Nel dashboard {{site.data.keyword.mobilepushshort}}, vai alla scheda **Notifications**. -2. Vai alla sezione **Optional Fields** per configurare le funzioni di {{site.data.keyword.mobilepushshort}}. - - **Sound File** - immetti una stringa per puntare al file audio nella tua applicazione mobile. Nel payload, specifica il nome stringa del file audio da utilizzare. - - **iOS Badge** - per i dispositivi iOS, il numero da visualizzare come badge dell'icona - applicazione. Se questa proprietà - non è presente, il badge non viene modificato. Per rimuovere il badge, imposta - il valore di questa proprietà su 0. - -###Android - -Aggiungi il file audio nella directory `res/raw` della tua applicazione android. Mentre invii le notifiche aggiungi il nome del file audio nel campo audio di {{site.data.keyword.mobilepushshort}}. - -``` -"settings": { - "gcm" : { - "sound":"tt.wav", - } - } -``` - {: codeblock} - -###iOS - -``` -"settings": { - "apns" : { - "badge": 10, - "sound": "tt.wav", - } -} -``` - {: codeblock} - -**Additional Payload** - This payload can be any key-value pair and must be a JSON object that you want to send with th**Additional Payload** - questo payload può essere qualsiasi coppia chiave-valore e deve essere un oggetto JSON che vuoi inviare con {{site.data.keyword.mobilepushshort}}. - -``` -{"chiave":"valore", "chiave2":"valore2"} -``` - {: codeblock} - -## Messa in pausa delle notifiche Android -{: #hold-notifications-android} - -Quando la tua applicazione va in background, probabilmente vuoi che {{site.data.keyword.mobilepushshort}} metta in pausa le notifiche inviate alla tua applicazione. Per mettere in pausa le notifiche, richiama il metodo hold() nel metodo onPause() dell'attività che sta gestendo {{site.data.keyword.mobilepushshort}}. - -``` -@Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +#Abilitazione delle {{site.data.keyword.mobilepushshort}} avanzate +Ultimo aggiornamento: 23 gennaio 2017 +{: .last-updated} + +Configura un badge iOS, audio, payload JSON aggiuntivo, notifiche operative e notifiche messe in pausa. + +## Configurazione di audio e payload e badge iOS +{: #badge-sound-payload} + +Configura un badge, l'audio e del payload JSON aggiuntivo iOS. + +1. Nel dashboard {{site.data.keyword.mobilepushshort}}, vai alla scheda **Notifications**. +2. Vai alla sezione **Optional Fields** per configurare le funzioni di {{site.data.keyword.mobilepushshort}}. + - **Sound File** - immetti una stringa per puntare al file audio nella tua applicazione mobile. Nel payload, specifica il nome stringa del file audio da utilizzare. + - **iOS Badge** - per i dispositivi iOS, il numero da visualizzare come badge dell'icona + applicazione. Se questa proprietà + non è presente, il badge non viene modificato. Per rimuovere il badge, imposta + il valore di questa proprietà su 0. + +###Android + +Aggiungi il file audio nella directory `res/raw` della tua applicazione android. Mentre invii le notifiche aggiungi il nome del file audio nel campo audio di {{site.data.keyword.mobilepushshort}}. + +``` +"settings": { + "gcm" : { + "sound":"tt.wav", + } + } +``` + {: codeblock} + +###iOS + +``` +"settings": { + "apns" : { + "badge": 10, + "sound": "tt.wav", + } +} +``` + {: codeblock} + +**Additional Payload** - This payload can be any key-value pair and must be a JSON object that you want to send with th**Additional Payload** - questo payload può essere qualsiasi coppia chiave-valore e deve essere un oggetto JSON che vuoi inviare con {{site.data.keyword.mobilepushshort}}. + +``` +{"chiave":"valore", "chiave2":"valore2"} +``` + {: codeblock} + +## Messa in pausa delle notifiche Android +{: #hold-notifications-android} + +Quando la tua applicazione va in background, probabilmente vuoi che {{site.data.keyword.mobilepushshort}} metta in pausa le notifiche inviate alla tua applicazione. Per mettere in pausa le notifiche, richiama il metodo hold() nel metodo onPause() dell'attività che sta gestendo {{site.data.keyword.mobilepushshort}}. + +``` +@Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} + + diff --git a/services/mobilepush/nl/it/t_android_create_unbound_service.md b/services/mobilepush/nl/it/t_android_create_unbound_service.md index 7daa570b2..1ac5e0b12 100644 --- a/services/mobilepush/nl/it/t_android_create_unbound_service.md +++ b/services/mobilepush/nl/it/t_android_create_unbound_service.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Creazione di un servizio {{site.data.keyword.mobilepushshort}} senza binding per Android -{: #create_android_unbound} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - -Crea un'istanza del servizio -{{site.data.keyword.mobilepushshort}}. Puoi utilizzare l'istanza del servizio {{site.data.keyword.mobilepushshort}} senza binding per ogni applicazione di backend. - -1. Esegui il bind dell'istanza del servizio {{site.data.keyword.mobilepushshort}} a un'applicazione Bluemix. Durante il bind, vedrai che tutti i dettagli correlati al servizio vengono archiviati nel formato JSON nella variabile di ambiente VCAP_SERVICES. - -![Bind a un servizio Push Notification](images/unbound_1.jpg) - 2. Fai clic su **Bind** e scegli l'istanza del servizio {{site.data.keyword.mobilepushshort}} di cui eseguire il bind. Quando è stato eseguito il bind della tua applicazione al servizio {{site.data.keyword.mobilepushshort}}, le informazioni sul servizio vengono archiviate in formato JSON nella variabile di ambiente VCAP_SERVICES per la tua applicazione. Ad esempio: -``` - { - "imfpush_Dev": [ - { - "name": "myname_sampleUnbound", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": null - } - ] - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Creazione di un servizio {{site.data.keyword.mobilepushshort}} senza binding per Android +{: #create_android_unbound} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + +Crea un'istanza del servizio +{{site.data.keyword.mobilepushshort}}. Puoi utilizzare l'istanza del servizio {{site.data.keyword.mobilepushshort}} senza binding per ogni applicazione di backend. + +1. Esegui il bind dell'istanza del servizio {{site.data.keyword.mobilepushshort}} a un'applicazione Bluemix. Durante il bind, vedrai che tutti i dettagli correlati al servizio vengono archiviati nel formato JSON nella variabile di ambiente VCAP_SERVICES. + +![Bind a un servizio Push Notification](images/unbound_1.jpg) + 2. Fai clic su **Bind** e scegli l'istanza del servizio {{site.data.keyword.mobilepushshort}} di cui eseguire il bind. Quando è stato eseguito il bind della tua applicazione al servizio {{site.data.keyword.mobilepushshort}}, le informazioni sul servizio vengono archiviate in formato JSON nella variabile di ambiente VCAP_SERVICES per la tua applicazione. Ad esempio: +``` + { + "imfpush_Dev": [ + { + "name": "myname_sampleUnbound", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": null + } + ] + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/it/t_android_initialize.md b/services/mobilepush/nl/it/t_android_initialize.md index cb0692cef..9046fff80 100644 --- a/services/mobilepush/nl/it/t_android_initialize.md +++ b/services/mobilepush/nl/it/t_android_initialize.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Inizializzazione di Push SDK per applicazioni Android -{: #android_initialize} - -Un posto comune dove inserire il codice di inizializzazione è nel metodo onCreate dell'attività principale nella tua applicazione Android. - -Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix per ottenere rotta e applicationGUID dell'applicazione. Utilizza questi valori per la rotta e il GUID dell'applicazione. Modifica il frammento di codice per utilizzare la tua applicazione Bluemix appRoute e i parametri appGUID. - - -##Inizializza il Core SDK - -``` -// Inizializza l'SDK for Java (Android) con IBM Bluemix AppGUID e la rotta -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Ubicazione in cui è ospitata la tua applicazione"); -``` - - -**appRoute** - -Specifica la rotta assegnato all'applicazione server creata in Bluemix. - -**AppGUID** - -Specifica la chiave univoca assegnata all'applicazione creata in Bluemix. Questo valore è - sensibile al maiuscolo/minuscolo. - -**bluemixRegionSuffix** - -Specifica l'ubicazione in cui è ospitata l'applicazione. Puoi utilizzare uno dei seguenti tre valori: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##Inizializza il Push SDK client - -``` -//Inizializza il Push SDK for Java client -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Inizializzazione di Push SDK per applicazioni Android +{: #android_initialize} + +Un posto comune dove inserire il codice di inizializzazione è nel metodo onCreate dell'attività principale nella tua applicazione Android. + +Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix per ottenere rotta e applicationGUID dell'applicazione. Utilizza questi valori per la rotta e il GUID dell'applicazione. Modifica il frammento di codice per utilizzare la tua applicazione Bluemix appRoute e i parametri appGUID. + + +## Inizializza il Core SDK + +``` +// Inizializza l'SDK for Java (Android) con IBM Bluemix AppGUID e la rotta +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Ubicazione in cui è ospitata la tua applicazione"); +``` + + +**appRoute** + +Specifica la rotta assegnato all'applicazione server creata in Bluemix. + +**AppGUID** + +Specifica la chiave univoca assegnata all'applicazione creata in Bluemix. Questo valore è + sensibile al maiuscolo/minuscolo. + +**bluemixRegionSuffix** + +Specifica l'ubicazione in cui è ospitata l'applicazione. Puoi utilizzare uno dei seguenti tre valori: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +## Inizializza il Push SDK client + +``` +//Inizializza il Push SDK for Java client +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` diff --git a/services/mobilepush/nl/it/t_android_install_sdk.md b/services/mobilepush/nl/it/t_android_install_sdk.md index d0c478f99..7d824d01f 100644 --- a/services/mobilepush/nl/it/t_android_install_sdk.md +++ b/services/mobilepush/nl/it/t_android_install_sdk.md @@ -1,231 +1,231 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Installazione del Push SDK client con Gradle -{: #android_install} - -Questa sezione descrive come installare e utilizzare il Push SDK client per sviluppare - ulteriormente le tue applicazioni Android. - -Il Push SDK dei servizi mobili Bluemix® può essere aggiunto utilizzando Gradle. Gradle - scarica automaticamente le risorse dai repository e le rende disponibili alla tua applicazione Android. Assicurati di impostare correttamente - Android Studio e Android Studio SDK. Per ulteriori informazioni su come impostare il tuo sistema, consulta la [panoramica di Android Studio](https://developer.android.com/tools/studio/index.html). Per informazioni su Gradle, consulta [Configuring Gradle Builds](http://developer.android.com/tools/building/configuring-gradle.html). - -1. In Android Studio, dopo aver creato e aperto la tua applicazione mobile, apri il tuo file **build.gradle** dell'applicazione. Quindi aggiungi le seguenti dipendenze alla tua applicazione mobile. Queste istruzioni di importazione sono necessarie per i frammenti di codice: - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - - -1. Aggiungi le seguenti dipendenze alla tua applicazione mobile. Le seguenti righe aggiungono l'SDK del client di push Bluemix™ Mobile Services e l'SDK dei servizi Google Play alle tue dipendenze dell'ambito di compilazione. - - ``` - dependencies { - compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' - compile 'com.google.android.gms:play-services:7.8.0' - } - ``` -1. Nel file **AndroidManifest.xml**, aggiungi le seguenti autorizzazioni. Per visualizzare un manifest di esempio, consulta [Applicazione di esempio Android helloPush](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml). Per visualizzare un file Gradle di esempio, consulta [Sample Build Gradle file](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle). - - ``` - - - - - - - - - ``` - - Puoi leggere ulteriori informazioni sulle [autorizzazioni Android](http://developer.android.com/guide/topics/security/permissions.html) qui. - -1. Aggiungi le impostazioni di intento di notifica per l'attività. Questa impostazione avvia l'applicazione - quando l'utente fa clic sulla notifica ricevuta dall'area di notifica. - - ``` - - - - - ``` - **Nota**: sostituisci *Your_Android_Package_Name* nell'azione sopra indicata con il nome del pacchetto applicazione utilizzato nella tua applicazione. - -1. Aggiungi il servizio di intento GCM (Google Cloud Messaging) e i filtri di intento per - le notifiche di evento RECEIVE. - - ``` - service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> - - - - - - - - - - - - - - ``` - - - -# Inizializzazione di Push SDK per applicazioni Android -{: #android_initialize} - -Un posto comune dove inserire il codice di inizializzazione è nel metodo onCreate dell'attività principale nella tua applicazione Android. - -Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix per ottenere rotta e applicationGUID dell'applicazione. Utilizza questi valori per la rotta e il GUID dell'applicazione. Modifica il frammento di codice per utilizzare la tua applicazione Bluemix appRoute e i parametri appGUID. - - -##Inizializza il Core SDK - -``` -// Inizializza l'SDK for Java (Android) con IBM Bluemix AppGUID e la rotta -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Ubicazione in cui è ospitata la tua applicazione"); -``` - - -**appRoute** - -Specifica la rotta assegnato all'applicazione server creata in Bluemix. - -**AppGUID** - -Specifica la chiave univoca assegnata all'applicazione creata in Bluemix. Questo valore è - sensibile al maiuscolo/minuscolo. - -**bluemixRegionSuffix** - -Specifica l'ubicazione in cui è ospitata l'applicazione. Puoi utilizzare uno dei seguenti tre valori: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##Inizializza il Push SDK client - -``` -//Inizializza il Push SDK for Java client -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` - - - -# Registrazione di dispositivi Android -{: #android_register} - -Utilizza la API `IMFPush.register()` per registrare il dispositivo con un Push Notification Service. Per registrare le periferiche Android, devi prima aggiungere le informazioni di GCM (Google Cloud Messaging) nel dashboard di configurazione del servizio push Bluemix. Per ulteriori informazioni, consulta [Configurazione delle credenziali per GCM (Google Cloud Messaging)](t_push_provider_android.html). - -Copia e incolla i seguenti frammenti di codice nella tua applicazione mobile Android. - -``` - //Registra dispositivi Android - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //gestisce esiti positivi qui - } - @Override - public void onFailure(MFPPushException ex) { - //gestisce esiti negativi qui - } - }); -``` - -``` - //Gestisci la notifica quando arriva - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Gestisci Push Notification - } - }; -``` - - - -# Ricezione di notifiche di push su dispositivi Android -{: #android_receive} - -Per registrare l'oggetto notificationListener con Push, richiama il metodo **MFPPush.listen()**. Questo metodo viene di norma - richiamato dal metodo ** onResume() **dell'attività che - sta gestendo le notifiche di push. - -1. Per registrare l'oggetto notificationListener con Push, richiama il metodo **listen()**. Questo metodo viene di norma - richiamato dal metodo ** onResume() **dell'attività che - sta gestendo le notifiche di push. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } - ``` -2. Crea il progetto ed eseguilo sul dispositivo o sull'emulatore. Quando viene richiamato il metodo onSuccess() per il listener di risposte nel metodo register(), ricevi una conferma che il dispositivo ha eseguito correttamente la registrazione presso il Push Notification Service. In questo momento puoi inviare un messaggio come descritto in Invio di notifiche di push di base. -3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. Se l'applicazione è in - primo piano, la notifica viene gestita da **MFPPushNotificationListener**. Se l'applicazione è in background, viene visualizzato un messaggio nella barra di notifica. - - - - -# Invio di notifiche di push di base - -{: #push-send-notifications} - -Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base (senza utilizzare tag, badge, payload aggiuntivi o file audio). - - -Invia notifiche di push di base. - -1. In **Choose the Audience**, seleziona uno dei seguenti destinatari: - **All Devices**, oppure in base alla piattaforma: **Only iOS devices** o - **Only Android devices**. - - **Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi che hanno sottoscritto le notifiche di push ricevono la tua notifica. - - ![Schermata notifiche](images/tag_notification.jpg) - -2. In **Create your Notification**, immetti il tuo messaggio e quindi fai clic su **Send**. -3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. - - Il seguente screenshot mostra una casella di avviso che gestisce una notifica push -in primo piano su un dispositivo Android e iOS. - - ![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) - - ![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) - - Il seguente screenshot mostra una notifica push in background per Android. - ![Notifica push in background su Android](images/background.jpg) - - - -# Fasi successive -{: #next_steps_tags} - -Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche - basate sulle tag e le opzioni avanzate. - -Aggiungi queste funzioni del servizio Push Notifications alla tua applicazione. -Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). -Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche di push avanzate](t_advance_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Installazione del Push SDK client con Gradle +{: #android_install} + +Questa sezione descrive come installare e utilizzare il Push SDK client per sviluppare + ulteriormente le tue applicazioni Android. + +Il Push SDK dei servizi mobili Bluemix® può essere aggiunto utilizzando Gradle. Gradle + scarica automaticamente le risorse dai repository e le rende disponibili alla tua applicazione Android. Assicurati di impostare correttamente + Android Studio e Android Studio SDK. Per ulteriori informazioni su come impostare il tuo sistema, consulta la [panoramica di Android Studio](https://developer.android.com/tools/studio/index.html). Per informazioni su Gradle, consulta [Configuring Gradle Builds](http://developer.android.com/tools/building/configuring-gradle.html). + +1. In Android Studio, dopo aver creato e aperto la tua applicazione mobile, apri il tuo file **build.gradle** dell'applicazione. Quindi aggiungi le seguenti dipendenze alla tua applicazione mobile. Queste istruzioni di importazione sono necessarie per i frammenti di codice: + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + + +1. Aggiungi le seguenti dipendenze alla tua applicazione mobile. Le seguenti righe aggiungono l'SDK del client di push Bluemix™ Mobile Services e l'SDK dei servizi Google Play alle tue dipendenze dell'ambito di compilazione. + + ``` + dependencies { + compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' + compile 'com.google.android.gms:play-services:7.8.0' + } + ``` +1. Nel file **AndroidManifest.xml**, aggiungi le seguenti autorizzazioni. Per visualizzare un manifest di esempio, consulta [Applicazione di esempio Android helloPush](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml). Per visualizzare un file Gradle di esempio, consulta [Sample Build Gradle file](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle). + + ``` + + + + + + + + + ``` + + Puoi leggere ulteriori informazioni sulle [autorizzazioni Android](http://developer.android.com/guide/topics/security/permissions.html) qui. + +1. Aggiungi le impostazioni di intento di notifica per l'attività. Questa impostazione avvia l'applicazione + quando l'utente fa clic sulla notifica ricevuta dall'area di notifica. + + ``` + + + + + ``` + **Nota**: sostituisci *Your_Android_Package_Name* nell'azione sopra indicata con il nome del pacchetto applicazione utilizzato nella tua applicazione. + +1. Aggiungi il servizio di intento GCM (Google Cloud Messaging) e i filtri di intento per + le notifiche di evento RECEIVE. + + ``` + service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> + + + + + + + + + + + + + + ``` + + + +# Inizializzazione di Push SDK per applicazioni Android +{: #android_initialize} + +Un posto comune dove inserire il codice di inizializzazione è nel metodo onCreate dell'attività principale nella tua applicazione Android. + +Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix per ottenere rotta e applicationGUID dell'applicazione. Utilizza questi valori per la rotta e il GUID dell'applicazione. Modifica il frammento di codice per utilizzare la tua applicazione Bluemix appRoute e i parametri appGUID. + + +##Inizializza il Core SDK + +``` +// Inizializza l'SDK for Java (Android) con IBM Bluemix AppGUID e la rotta +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Ubicazione in cui è ospitata la tua applicazione"); +``` + + +**appRoute** + +Specifica la rotta assegnato all'applicazione server creata in Bluemix. + +**AppGUID** + +Specifica la chiave univoca assegnata all'applicazione creata in Bluemix. Questo valore è + sensibile al maiuscolo/minuscolo. + +**bluemixRegionSuffix** + +Specifica l'ubicazione in cui è ospitata l'applicazione. Puoi utilizzare uno dei seguenti tre valori: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +##Inizializza il Push SDK client + +``` +//Inizializza il Push SDK for Java client +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` + + + +# Registrazione di dispositivi Android +{: #android_register} + +Utilizza la API `IMFPush.register()` per registrare il dispositivo con un Push Notification Service. Per registrare le periferiche Android, devi prima aggiungere le informazioni di GCM (Google Cloud Messaging) nel dashboard di configurazione del servizio push Bluemix. Per ulteriori informazioni, consulta [Configurazione delle credenziali per GCM (Google Cloud Messaging)](t_push_provider_android.html). + +Copia e incolla i seguenti frammenti di codice nella tua applicazione mobile Android. + +``` + //Registra dispositivi Android + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //gestisce esiti positivi qui + } + @Override + public void onFailure(MFPPushException ex) { + //gestisce esiti negativi qui + } + }); +``` + +``` + //Gestisci la notifica quando arriva + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Gestisci Push Notification + } + }; +``` + + + +# Ricezione di notifiche di push su dispositivi Android +{: #android_receive} + +Per registrare l'oggetto notificationListener con Push, richiama il metodo **MFPPush.listen()**. Questo metodo viene di norma + richiamato dal metodo ** onResume() **dell'attività che + sta gestendo le notifiche di push. + +1. Per registrare l'oggetto notificationListener con Push, richiama il metodo **listen()**. Questo metodo viene di norma + richiamato dal metodo ** onResume() **dell'attività che + sta gestendo le notifiche di push. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } + ``` +2. Crea il progetto ed eseguilo sul dispositivo o sull'emulatore. Quando viene richiamato il metodo onSuccess() per il listener di risposte nel metodo register(), ricevi una conferma che il dispositivo ha eseguito correttamente la registrazione presso il Push Notification Service. In questo momento puoi inviare un messaggio come descritto in Invio di notifiche di push di base. +3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. Se l'applicazione è in + primo piano, la notifica viene gestita da **MFPPushNotificationListener**. Se l'applicazione è in background, viene visualizzato un messaggio nella barra di notifica. + + + + +# Invio di notifiche di push di base + +{: #push-send-notifications} + +Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base (senza utilizzare tag, badge, payload aggiuntivi o file audio). + + +Invia notifiche di push di base. + +1. In **Choose the Audience**, seleziona uno dei seguenti destinatari: + **All Devices**, oppure in base alla piattaforma: **Only iOS devices** o + **Only Android devices**. + + **Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi che hanno sottoscritto le notifiche di push ricevono la tua notifica. + + ![Schermata notifiche](images/tag_notification.jpg) + +2. In **Create your Notification**, immetti il tuo messaggio e quindi fai clic su **Send**. +3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. + + Il seguente screenshot mostra una casella di avviso che gestisce una notifica push +in primo piano su un dispositivo Android e iOS. + + ![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) + + ![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) + + Il seguente screenshot mostra una notifica push in background per Android. + ![Notifica push in background su Android](images/background.jpg) + + + +# Fasi successive +{: #next_steps_tags} + +Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche + basate sulle tag e le opzioni avanzate. + +Aggiungi queste funzioni del servizio Push Notifications alla tua applicazione. +Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). +Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche di push avanzate](t_advance_notifications.html). diff --git a/services/mobilepush/nl/it/t_android_receive.md b/services/mobilepush/nl/it/t_android_receive.md index ab5959394..83c82bb4d 100644 --- a/services/mobilepush/nl/it/t_android_receive.md +++ b/services/mobilepush/nl/it/t_android_receive.md @@ -1,30 +1,30 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Ricezione di notifiche di push su dispositivi Android -{: #android_receive} - -Per registrare l'oggetto notificationListener con Push, richiama il metodo **MFPPush.listen()**. Questo metodo viene di norma - richiamato dal metodo ** onResume() **dell'attività che - sta gestendo le notifiche di push. - -1. Per registrare l'oggetto notificationListener con Push, richiama il metodo **listen()**. Questo metodo viene di norma - richiamato dal metodo ** onResume() **dell'attività che - sta gestendo le notifiche di push. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` -2. Crea il progetto ed eseguilo sul dispositivo o sull'emulatore. Quando viene richiamato il metodo onSuccess() per il listener di risposte nel metodo register(), ricevi una conferma che il dispositivo ha eseguito correttamente la registrazione presso il Push Notification Service. In questo momento puoi inviare un messaggio come descritto in Invio di notifiche di push di base. -3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. Se l'applicazione è in - primo piano, la notifica viene gestita da **MFPPushNotificationListener**. Se l'applicazione è in background, viene visualizzato un messaggio nella barra di notifica. +--- + +copyright: + years: 2015, 2016 + +--- + +# Ricezione di notifiche di push su dispositivi Android +{: #android_receive} + +Per registrare l'oggetto notificationListener con Push, richiama il metodo **MFPPush.listen()**. Questo metodo viene di norma + richiamato dal metodo ** onResume() **dell'attività che + sta gestendo le notifiche di push. + +1. Per registrare l'oggetto notificationListener con Push, richiama il metodo **listen()**. Questo metodo viene di norma + richiamato dal metodo ** onResume() **dell'attività che + sta gestendo le notifiche di push. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` +2. Crea il progetto ed eseguilo sul dispositivo o sull'emulatore. Quando viene richiamato il metodo onSuccess() per il listener di risposte nel metodo register(), ricevi una conferma che il dispositivo ha eseguito correttamente la registrazione presso il Push Notification Service. In questo momento puoi inviare un messaggio come descritto in Invio di notifiche di push di base. +3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. Se l'applicazione è in + primo piano, la notifica viene gestita da **MFPPushNotificationListener**. Se l'applicazione è in background, viene visualizzato un messaggio nella barra di notifica. diff --git a/services/mobilepush/nl/it/t_android_register.md b/services/mobilepush/nl/it/t_android_register.md index ff1653f46..8896dae67 100644 --- a/services/mobilepush/nl/it/t_android_register.md +++ b/services/mobilepush/nl/it/t_android_register.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Registrazione di dispositivi Android -{: #android_register} - -Utilizza la API `IMFPush.register()` per registrare il dispositivo con un Push Notification Service. Per registrare le periferiche Android, devi prima aggiungere le informazioni di GCM (Google Cloud Messaging) nel dashboard di configurazione del servizio push Bluemix. Per ulteriori informazioni, consulta [Configurazione delle credenziali per GCM (Google Cloud Messaging)](t_push_provider_android.html). - -Copia e incolla i seguenti frammenti di codice nella tua applicazione mobile Android. - -``` - //Registra dispositivi Android - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //gestisce esiti positivi qui - } - @Override - public void onFailure(MFPPushException ex) { - //gestisce esiti negativi qui - } - }); -``` - -``` - //Gestisci la notifica quando arriva - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Gestisci Push Notification - } - }; -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Registrazione di dispositivi Android +{: #android_register} + +Utilizza la API `IMFPush.register()` per registrare il dispositivo con un Push Notification Service. Per registrare le periferiche Android, devi prima aggiungere le informazioni di GCM (Google Cloud Messaging) nel dashboard di configurazione del servizio push Bluemix. Per ulteriori informazioni, consulta [Configurazione delle credenziali per GCM (Google Cloud Messaging)](t_push_provider_android.html). + +Copia e incolla i seguenti frammenti di codice nella tua applicazione mobile Android. + +``` + //Registra dispositivi Android + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //gestisce esiti positivi qui + } + @Override + public void onFailure(MFPPushException ex) { + //gestisce esiti negativi qui + } + }); +``` + +``` + //Gestisci la notifica quando arriva + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Gestisci Push Notification + } + }; +``` diff --git a/services/mobilepush/nl/it/t_cordova_initialize.md b/services/mobilepush/nl/it/t_cordova_initialize.md index 0913921f2..31b8a56d4 100644 --- a/services/mobilepush/nl/it/t_cordova_initialize.md +++ b/services/mobilepush/nl/it/t_cordova_initialize.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} - -# Inizializzazione del plugin Cordova -{: #cordova_enable} - -Prima di poter utilizzare il plugin Cordova del servizio Push Notification, devi inizializzarlo passando -la rotta e il GUID dell'applicazione. Dopo che hai inizializzato il plugin, puoi stabilire una connessione all'applicazione server che hai creato nel dashboard Bluemix. Il plugin Cordova è il contenitore per gli SDK client Android e iOS per abilitare un'applicazione Cordova a comunicare con i servizi Bluemix. - -1. Inizializza il BMSClient copiando e incollando il seguente frammento di codice nel tuo file JavaScript principale (normalmente ubicato nella directory **www/js**). - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Modifica il frammento di codice per utilizzare la tua rotta Bluemix e i parametri appGUID. Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix per ottenere rotta e GUID dell'applicazione. Utilizza i valori rotta e GUID dell'applicazione come tuoi parametri nel tuo frammento di codice `BMSClient.initialize`. - - - **Nota**: se hai creato un'applicazione Cordova utilizzando la CLI di Cordova, ad esempio, con il comando Cordova create app-name, inserisci questo codice Javascript nel file **index.js**, dopo la funzione `app.receivedEvent` nella funzione `onDeviceReady: function()` per inizializzare il client BMS. - - ``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` -1. Fase successiva. [Registrazione di dispositivi](t_cordova_register.html). +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} + +# Inizializzazione del plugin Cordova +{: #cordova_enable} + +Prima di poter utilizzare il plugin Cordova del servizio Push Notification, devi inizializzarlo passando +la rotta e il GUID dell'applicazione. Dopo che hai inizializzato il plugin, puoi stabilire una connessione all'applicazione server che hai creato nel dashboard Bluemix. Il plugin Cordova è il contenitore per gli SDK client Android e iOS per abilitare un'applicazione Cordova a comunicare con i servizi Bluemix. + +1. Inizializza il BMSClient copiando e incollando il seguente frammento di codice nel tuo file JavaScript principale (normalmente ubicato nella directory **www/js**). + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Modifica il frammento di codice per utilizzare la tua rotta Bluemix e i parametri appGUID. Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix per ottenere rotta e GUID dell'applicazione. Utilizza i valori rotta e GUID dell'applicazione come tuoi parametri nel tuo frammento di codice `BMSClient.initialize`. + + + **Nota**: se hai creato un'applicazione Cordova utilizzando la CLI di Cordova, ad esempio, con il comando Cordova create app-name, inserisci questo codice Javascript nel file **index.js**, dopo la funzione `app.receivedEvent` nella funzione `onDeviceReady: function()` per inizializzare il client BMS. + + ``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` +1. Fase successiva. [Registrazione di dispositivi](t_cordova_register.html). diff --git a/services/mobilepush/nl/it/t_cordova_install.md b/services/mobilepush/nl/it/t_cordova_install.md index d96013c9b..c3377553e 100644 --- a/services/mobilepush/nl/it/t_cordova_install.md +++ b/services/mobilepush/nl/it/t_cordova_install.md @@ -1,388 +1,388 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Installazione del plugin Push Cordova -{: #cordova_install} - -Installa e utilizza il plugin di Push client per sviluppare ulteriormente le tue applicazioni Cordova. Questo installa anche il plugin Cordova Core, che inizializza la tua connessione a Bluemix. - -### Prima di cominciare - -1. Scarica le ultime versioni dell'SDK Android Studio e Xcode. -1. Configura il tuo emulatore. Per Android Studio, utilizza un emulatore che supporti l'API Google Play. -1. Installa lo strumento della riga di comando Git. Per Windows, assicurati di selezionare l'opzione **Esegui Git dal prompt dei comandi della finestra**. Per informazioni su come scaricare e installare questo strumento, consulta [Git](https://git-scm.com/downloads). - -1. Installa lo strumento Node.js e il gestore pacchetti di nodi (NPM). Lo strumento della riga comandi NPM è integrato con Node.js. Per informazioni su come scaricare e installare Node.js, consulta [Node.js](https://nodejs.org/en/download/). -1. Dalla riga comandi, installa gli strumenti della riga di comando Cordova utilizzando il comando **npm install -g cordova**. È necessario per utilizzare il plugin Push Cordova. Per informazioni su come installare Cordova e configurare la tua applicazione Cordova, consulta [Cordova Apache](https://cordova.apache.org/#getstarted). - - **Nota**: per visualizzare il file readme del plugin Push Cordova, vai a [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## Installazione del plugin Push Cordova -1. Passa alla cartella in cui vuoi creare la tua applicazione Cordova ed esegui il seguente comando per - creare un'applicazione Cordova. Se hai un'applicazione Cordova esistente, vai al passo 3. - -``` -cordova create your_app_name - cd your_app_name -``` -1. Facoltativo: (Facoltativo) modifica il file **config.xml** e modifica il nome dell'applicazione nell'elemento in uno a tua scelta, invece del nome predefinito HelloCordova. - - **Nota**: assicurati di specificare l'ID bundle corretto. In caso contrario, i seguenti messaggi di errore vengono visualizzati in Xcode. - * L'eseguibile è stato firmato con diritti non validi. - * I diritti specificati nel tuo file Diritti di firma del codice non corrispondo a quelli specificati nel tuo profilo di provisioning. - - Per risolvere questo problema, specifica l'ID bundle corretto in Xcode o nel tuo file **config.xml** dell'applicazione Cordova. - -1. Aggiungi la API supportata minima o la dichiarazione di destinazione della distribuzione al file config.xml per la tua applicazione Cordova. Il valore minSdkVersion deve essere maggiore di 15. Il valore targetSdkVersion deve sempre riflettere l'SDK Android più recente disponibile da Google. - * **Android** - Con il tuo editor, apri il file config.xml e aggiorna l'elemento -`` con le versioni SDK minima e di destinazione: - - ``` - - - - - - ``` - * **iOS** - Aggiorna l'elemento con una dichiarazione di destinazione della distribuzione: - - ``` - - - - - ``` - -1. Dalla CLI (command-line interface) Cordova, aggiungi le tue piattaforme: iOS, Android o entrambe utilizzando i seguenti comandi. - - ``` - cordova platform add ios@3.9.0 - cordova platform add android - ``` -1. Dalla directory root della tua applicazione Cordova, immetti il seguente comando per installare il plugin Cordova Push: **cordova plugin add ibm-mfp-push**. - - A seconda delle piattaforme da te aggiunte, vedrai qualcosa di simile a questo: - - ``` - Installing "ibm-mfp-push" for android - Installing "ibm-mfp-push" for ios - ``` -1. Da *your-app-root-folder*, verifica che i plugin Cordova Core e Push siano stati installati correttamente utilizzando questo comando: **cordova plugin list**. - - A seconda delle piattaforme da te aggiunte, vedrai qualcosa di simile a questo: - - ``` - ibm-mfp-core 1.0.0 "MFPCore" - ibm-mfp-push 1.0.0 “MFPPush" - ``` -1. (solo iOS) - Configura il tuo ambiente di sviluppo iOS. - a. Apri il tuo file your-app-name.xcodeproj nella directory *your-app-name***/platforms/ios** con Xcode. - - b. Aggiungi l'intestazione di collegamento. Vai a **Build settings > Swift Compiler - Code Generation > Objective-C Bridging Header** e aggiungi il seguente percorso: *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - c. Aggiungi il parametro Frameworks. Vai a **Build Settings > Linking > Runpath Search Paths** e aggiungi il seguente parametro: - ``` - @executable_path/Frameworks - ``` - d. Rimuovi il commento per le seguenti istruzioni di importazione push nella tua intestazione di collegamento. Vai a *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - ``` - //#import - //#import - //#import - ``` - e. Crea ed esegui la tua applicazione con Xcode. -1. (solo Android)- Crea il tuo progetto Android utilizzando il seguente comando: -**cordova build android**. - - **Nota**: prima di aprire il tuo progetto in Android Studio, devi prima creare la tua applicazione Cordova con la CLI di Cordova. Altrimenti, riscontrerai degli errori di generazione. - - -# Inizializzazione del plugin Cordova -{: #cordova_initialize} - -Prima di poter utilizzare il plugin Cordova del servizio Push Notification, devi inizializzarlo passando -la rotta e il GUID dell'applicazione. Dopo che hai inizializzato il plugin, puoi stabilire una connessione all'applicazione server che hai creato nel dashboard Bluemix. Il plugin Cordova è il contenitore per gli SDK client Android e iOS per abilitare un'applicazione Cordova a comunicare con i servizi Bluemix. - -1. Inizializza il BMSClient copiando e incollando il seguente frammento di codice nel tuo file JavaScript principale (normalmente ubicato nella directory **www/js**). - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Modifica il frammento di codice per utilizzare la tua rotta Bluemix e i parametri appGUID. Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix per ottenere rotta e GUID dell'applicazione. Utilizza i valori rotta e GUID dell'applicazione come tuoi parametri nel tuo frammento di codice `BMSClient.initialize`. - - **Nota**: se hai creato un'applicazione Cordova utilizzando la CLI di Cordova, ad esempio, con il comando Cordova create app-name, inserisci questo codice Javascript nel file **index.js**, dopo la funzione `app.receivedEvent` nella funzione `onDeviceReady: function()` per inizializzare il client BMS. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, -``` - -# Registrazione di dispositivi - -{: #cordova_register} - -Per registrare un dispositivo con il Push Notification Service, richiama il metodo. - -Copia e incolla il seguente frammento di codice nella tua applicazione Cordova per registrare - un dispositivo. - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android non utilizza il parametro delle impostazioni. Se stai soltanto creando un'applicazione Android, invia un oggetto vuoto; ad esempio: - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -Se vuoi personalizzare le proprietà di avviso, badge e audio, - aggiungi il seguente frammento di codice JavaScript alla parte web della tua applicazione - Cordova. - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -Puoi accedere ai contenuti del parametro di risposta con esito positivo in Javascript utilizzando JSON.parse: -**var token = JSON.parse(response).token** - - -Le chiavi disponibili sono le seguenti: `token`, `userId` e `deviceId`. - -Il seguente frammento di codice JavaScript mostra come inizializzare il tuo Bluemix Mobile Services client SDK, registra un dispositivo ed è in ascolto per le notifiche push. Inserisci questo codice nel tuo file Javascript. - - - -``` -//Registra il token di dispositivo presso il Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -in **onDeviceReady: function()**. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -Aggiungi il seguente frammento di codice Objective-C alla classe delegato della tua applicazione - -``` - // Registra il token dispositivo con Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -Aggiungi il seguente frammento di codice Swift alla classe delegato della tua applicazione. - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -//Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##Passi successivi - -{: #cordova_register_next} - -1. Crea il tuo progetto e quindi eseguilo utilizzando i seguenti comandi: - - * Android - **cordova build android** e quindi **cordova run android** - - * iOS - **cordova build ios** e quindi **cordova run ios** - - - -# Ricezione di notifiche di push sui dispositivi -{: #cordova_receive} - -Copia e incolla i seguenti dispositivi di codice per ricevere notifiche di push sui dispositivi. - -##JavaScript - -Aggiungi il seguente frammento di codice JavaScript alla parte web della tua applicazione Cordova. - - -``` -var notification = function(notification){ - // la notifica è un oggetto JSON. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Proprietà di notifica Android - -La seguente selezione elenca le proprietà di notifica Android: - -* message - messaggio di notifica di push -* payload - oggetto JSON che contiene un payload di notifica - - -##Proprietà di notifica iOS - -La seguente sezione elenca le proprietà di notifica iOS: - -* message - messaggio di notifica di push -* payload - oggetto JSON che contiene un payload di notifica -action-loc-key - la stringa viene utilizzata come una chiave per ottenere una stringa localizzata nella localizzazione corrente da utilizzare per il titolo del pulsante destro invece di “View". -* badge - il numero da visualizzare come badge dell'icona applicazione. Se questa proprietà - non è presente, il badge non viene modificato. Per rimuovere il badge, imposta - il valore di questa proprietà su 0. -* sound - il nome di un file audio nel bundle dell'applicazione o nella cartella - Library/Sounds dei contenitore di dati dell'applicazione. - -##Objective-C - -Aggiungi i seguenti frammenti di codice Objective-C alla classe delegato della tua applicazione. - -``` -// Gestisci la ricezione di una notifica remota --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Gestisci la ricezione di una notifica all'avvio -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -Aggiungi i seguenti frammenti di codice Swift alla classe delegato della tua applicazione. - -``` -// Gestisci la ricezione di una notifica remota -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Gestisci la ricezione di una notifica remota all'avvio -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` - - - -# Invio di notifiche di push di base -{: #push-send-notifications} - -Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base (senza utilizzare tag, badge, payload aggiuntivi o file audio). - - -Invia notifiche di push di base. - -1. In **Choose the Audience**, seleziona uno dei seguenti destinatari: - **All Devices**, oppure in base alla piattaforma: **Only iOS devices** o - **Only Android devices**. - - **Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi che hanno sottoscritto le notifiche di push ricevono la tua notifica. - - ![Schermata notifiche](images/tag_notification.jpg) - -2. In **Create your Notification**, immetti il tuo messaggio e quindi fai clic su **Send**. -3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. - - Il seguente screenshot mostra una casella di avviso che gestisce una notifica push -in primo piano su un dispositivo Android e iOS. - - ![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) - - ![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) - - Il seguente screenshot mostra una notifica push in background per Android. - ![Notifica push in background su Android](images/background.jpg) - - - -# Fasi successive -{: #next_steps_tags} - -Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche - basate sulle tag e le opzioni avanzate. - -Aggiungi queste funzioni del servizio Push Notifications alla tua applicazione. -Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). -Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche di push avanzate](t_advance_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Installazione del plugin Push Cordova +{: #cordova_install} + +Installa e utilizza il plugin di Push client per sviluppare ulteriormente le tue applicazioni Cordova. Questo installa anche il plugin Cordova Core, che inizializza la tua connessione a Bluemix. + +### Prima di cominciare + +1. Scarica le ultime versioni dell'SDK Android Studio e Xcode. +1. Configura il tuo emulatore. Per Android Studio, utilizza un emulatore che supporti l'API Google Play. +1. Installa lo strumento della riga di comando Git. Per Windows, assicurati di selezionare l'opzione **Esegui Git dal prompt dei comandi della finestra**. Per informazioni su come scaricare e installare questo strumento, consulta [Git](https://git-scm.com/downloads). + +1. Installa lo strumento Node.js e il gestore pacchetti di nodi (NPM). Lo strumento della riga comandi NPM è integrato con Node.js. Per informazioni su come scaricare e installare Node.js, consulta [Node.js](https://nodejs.org/en/download/). +1. Dalla riga comandi, installa gli strumenti della riga di comando Cordova utilizzando il comando **npm install -g cordova**. È necessario per utilizzare il plugin Push Cordova. Per informazioni su come installare Cordova e configurare la tua applicazione Cordova, consulta [Cordova Apache](https://cordova.apache.org/#getstarted). + + **Nota**: per visualizzare il file readme del plugin Push Cordova, vai a [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## Installazione del plugin Push Cordova +1. Passa alla cartella in cui vuoi creare la tua applicazione Cordova ed esegui il seguente comando per + creare un'applicazione Cordova. Se hai un'applicazione Cordova esistente, vai al passo 3. + +``` +cordova create your_app_name + cd your_app_name +``` +1. Facoltativo: (Facoltativo) modifica il file **config.xml** e modifica il nome dell'applicazione nell'elemento in uno a tua scelta, invece del nome predefinito HelloCordova. + + **Nota**: assicurati di specificare l'ID bundle corretto. In caso contrario, i seguenti messaggi di errore vengono visualizzati in Xcode. + * L'eseguibile è stato firmato con diritti non validi. + * I diritti specificati nel tuo file Diritti di firma del codice non corrispondo a quelli specificati nel tuo profilo di provisioning. + + Per risolvere questo problema, specifica l'ID bundle corretto in Xcode o nel tuo file **config.xml** dell'applicazione Cordova. + +1. Aggiungi la API supportata minima o la dichiarazione di destinazione della distribuzione al file config.xml per la tua applicazione Cordova. Il valore minSdkVersion deve essere maggiore di 15. Il valore targetSdkVersion deve sempre riflettere l'SDK Android più recente disponibile da Google. + * **Android** - Con il tuo editor, apri il file config.xml e aggiorna l'elemento +`` con le versioni SDK minima e di destinazione: + + ``` + + + + + + ``` + * **iOS** - Aggiorna l'elemento con una dichiarazione di destinazione della distribuzione: + + ``` + + + + + ``` + +1. Dalla CLI (command-line interface) Cordova, aggiungi le tue piattaforme: iOS, Android o entrambe utilizzando i seguenti comandi. + + ``` + cordova platform add ios@3.9.0 + cordova platform add android + ``` +1. Dalla directory root della tua applicazione Cordova, immetti il seguente comando per installare il plugin Cordova Push: **cordova plugin add ibm-mfp-push**. + + A seconda delle piattaforme da te aggiunte, vedrai qualcosa di simile a questo: + + ``` + Installing "ibm-mfp-push" for android + Installing "ibm-mfp-push" for ios + ``` +1. Da *your-app-root-folder*, verifica che i plugin Cordova Core e Push siano stati installati correttamente utilizzando questo comando: **cordova plugin list**. + + A seconda delle piattaforme da te aggiunte, vedrai qualcosa di simile a questo: + + ``` + ibm-mfp-core 1.0.0 "MFPCore" + ibm-mfp-push 1.0.0 “MFPPush" + ``` +1. (solo iOS) - Configura il tuo ambiente di sviluppo iOS. + a. Apri il tuo file your-app-name.xcodeproj nella directory *your-app-name***/platforms/ios** con Xcode. + + b. Aggiungi l'intestazione di collegamento. Vai a **Build settings > Swift Compiler - Code Generation > Objective-C Bridging Header** e aggiungi il seguente percorso: *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + c. Aggiungi il parametro Frameworks. Vai a **Build Settings > Linking > Runpath Search Paths** e aggiungi il seguente parametro: + ``` + @executable_path/Frameworks + ``` + d. Rimuovi il commento per le seguenti istruzioni di importazione push nella tua intestazione di collegamento. Vai a *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + ``` + //#import + //#import + //#import + ``` + e. Crea ed esegui la tua applicazione con Xcode. +1. (solo Android)- Crea il tuo progetto Android utilizzando il seguente comando: +**cordova build android**. + + **Nota**: prima di aprire il tuo progetto in Android Studio, devi prima creare la tua applicazione Cordova con la CLI di Cordova. Altrimenti, riscontrerai degli errori di generazione. + + +# Inizializzazione del plugin Cordova +{: #cordova_initialize} + +Prima di poter utilizzare il plugin Cordova del servizio Push Notification, devi inizializzarlo passando +la rotta e il GUID dell'applicazione. Dopo che hai inizializzato il plugin, puoi stabilire una connessione all'applicazione server che hai creato nel dashboard Bluemix. Il plugin Cordova è il contenitore per gli SDK client Android e iOS per abilitare un'applicazione Cordova a comunicare con i servizi Bluemix. + +1. Inizializza il BMSClient copiando e incollando il seguente frammento di codice nel tuo file JavaScript principale (normalmente ubicato nella directory **www/js**). + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Modifica il frammento di codice per utilizzare la tua rotta Bluemix e i parametri appGUID. Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix per ottenere rotta e GUID dell'applicazione. Utilizza i valori rotta e GUID dell'applicazione come tuoi parametri nel tuo frammento di codice `BMSClient.initialize`. + + **Nota**: se hai creato un'applicazione Cordova utilizzando la CLI di Cordova, ad esempio, con il comando Cordova create app-name, inserisci questo codice Javascript nel file **index.js**, dopo la funzione `app.receivedEvent` nella funzione `onDeviceReady: function()` per inizializzare il client BMS. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, +``` + +# Registrazione di dispositivi + +{: #cordova_register} + +Per registrare un dispositivo con il Push Notification Service, richiama il metodo. + +Copia e incolla il seguente frammento di codice nella tua applicazione Cordova per registrare + un dispositivo. + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android non utilizza il parametro delle impostazioni. Se stai soltanto creando un'applicazione Android, invia un oggetto vuoto; ad esempio: + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +Se vuoi personalizzare le proprietà di avviso, badge e audio, + aggiungi il seguente frammento di codice JavaScript alla parte web della tua applicazione + Cordova. + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +##JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +Puoi accedere ai contenuti del parametro di risposta con esito positivo in Javascript utilizzando JSON.parse: +**var token = JSON.parse(response).token** + + +Le chiavi disponibili sono le seguenti: `token`, `userId` e `deviceId`. + +Il seguente frammento di codice JavaScript mostra come inizializzare il tuo Bluemix Mobile Services client SDK, registra un dispositivo ed è in ascolto per le notifiche push. Inserisci questo codice nel tuo file Javascript. + + + +``` +//Registra il token di dispositivo presso il Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +in **onDeviceReady: function()**. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +Aggiungi il seguente frammento di codice Objective-C alla classe delegato della tua applicazione + +``` + // Registra il token dispositivo con Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +##Swift +{: #cordova_register_swift} +Aggiungi il seguente frammento di codice Swift alla classe delegato della tua applicazione. + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +//Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +##Passi successivi + +{: #cordova_register_next} + +1. Crea il tuo progetto e quindi eseguilo utilizzando i seguenti comandi: + + * Android - **cordova build android** e quindi **cordova run android** + + * iOS - **cordova build ios** e quindi **cordova run ios** + + + +# Ricezione di notifiche di push sui dispositivi +{: #cordova_receive} + +Copia e incolla i seguenti dispositivi di codice per ricevere notifiche di push sui dispositivi. + +##JavaScript + +Aggiungi il seguente frammento di codice JavaScript alla parte web della tua applicazione Cordova. + + +``` +var notification = function(notification){ + // la notifica è un oggetto JSON. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +##Proprietà di notifica Android + +La seguente selezione elenca le proprietà di notifica Android: + +* message - messaggio di notifica di push +* payload - oggetto JSON che contiene un payload di notifica + + +##Proprietà di notifica iOS + +La seguente sezione elenca le proprietà di notifica iOS: + +* message - messaggio di notifica di push +* payload - oggetto JSON che contiene un payload di notifica +action-loc-key - la stringa viene utilizzata come una chiave per ottenere una stringa localizzata nella localizzazione corrente da utilizzare per il titolo del pulsante destro invece di “View". +* badge - il numero da visualizzare come badge dell'icona applicazione. Se questa proprietà + non è presente, il badge non viene modificato. Per rimuovere il badge, imposta + il valore di questa proprietà su 0. +* sound - il nome di un file audio nel bundle dell'applicazione o nella cartella + Library/Sounds dei contenitore di dati dell'applicazione. + +##Objective-C + +Aggiungi i seguenti frammenti di codice Objective-C alla classe delegato della tua applicazione. + +``` +// Gestisci la ricezione di una notifica remota +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Gestisci la ricezione di una notifica all'avvio +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +##Swift + +Aggiungi i seguenti frammenti di codice Swift alla classe delegato della tua applicazione. + +``` +// Gestisci la ricezione di una notifica remota +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Gestisci la ricezione di una notifica remota all'avvio +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` + + + +# Invio di notifiche di push di base +{: #push-send-notifications} + +Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base (senza utilizzare tag, badge, payload aggiuntivi o file audio). + + +Invia notifiche di push di base. + +1. In **Choose the Audience**, seleziona uno dei seguenti destinatari: + **All Devices**, oppure in base alla piattaforma: **Only iOS devices** o + **Only Android devices**. + + **Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi che hanno sottoscritto le notifiche di push ricevono la tua notifica. + + ![Schermata notifiche](images/tag_notification.jpg) + +2. In **Create your Notification**, immetti il tuo messaggio e quindi fai clic su **Send**. +3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. + + Il seguente screenshot mostra una casella di avviso che gestisce una notifica push +in primo piano su un dispositivo Android e iOS. + + ![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) + + ![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) + + Il seguente screenshot mostra una notifica push in background per Android. + ![Notifica push in background su Android](images/background.jpg) + + + +# Fasi successive +{: #next_steps_tags} + +Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche + basate sulle tag e le opzioni avanzate. + +Aggiungi queste funzioni del servizio Push Notifications alla tua applicazione. +Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). +Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche di push avanzate](t_advance_notifications.html). diff --git a/services/mobilepush/nl/it/t_cordova_receive.md b/services/mobilepush/nl/it/t_cordova_receive.md index d5ec8218a..bd5141748 100644 --- a/services/mobilepush/nl/it/t_cordova_receive.md +++ b/services/mobilepush/nl/it/t_cordova_receive.md @@ -1,87 +1,87 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Ricezione di notifiche di push sui dispositivi -{: #cordova_receive} - -Copia e incolla i seguenti dispositivi di codice per ricevere notifiche di push sui dispositivi. - -##JavaScript - -Aggiungi il seguente frammento di codice JavaScript alla parte web della tua applicazione Cordova. - - -``` -var notification = function(notification){ - // la notifica è un oggetto JSON. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Proprietà di notifica Android - -La seguente selezione elenca le proprietà di notifica Android: - -* message - messaggio di notifica di push -* payload - oggetto JSON che contiene un payload di notifica - - -##Proprietà di notifica iOS - -La seguente sezione elenca le proprietà di notifica iOS: - -* message - messaggio di notifica di push -* payload - oggetto JSON che contiene un payload di notifica -action-loc-key - la stringa viene utilizzata come una chiave per ottenere una stringa localizzata nella localizzazione corrente da utilizzare per il titolo del pulsante destro invece di “View". -* badge - il numero da visualizzare come badge dell'icona applicazione. Se questa proprietà - non è presente, il badge non viene modificato. Per rimuovere il badge, imposta - il valore di questa proprietà su 0. -* sound - il nome di un file audio nel bundle dell'applicazione o nella cartella - Library/Sounds dei contenitore di dati dell'applicazione. - -##Objective-C - -Aggiungi i seguenti frammenti di codice Objective-C alla classe delegato della tua applicazione. - -``` -// Gestisci la ricezione di una notifica remota --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Gestisci la ricezione di una notifica all'avvio -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -Aggiungi i seguenti frammenti di codice Swift alla classe delegato della tua applicazione. - -``` -// Gestisci la ricezione di una notifica remota -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Gestisci la ricezione di una notifica remota all'avvio -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` -Fase successiva. [Invia notifiche di push di base](t_send_push_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Ricezione di notifiche di push sui dispositivi +{: #cordova_receive} + +Copia e incolla i seguenti dispositivi di codice per ricevere notifiche di push sui dispositivi. + +## JavaScript + +Aggiungi il seguente frammento di codice JavaScript alla parte web della tua applicazione Cordova. + + +``` +var notification = function(notification){ + // la notifica è un oggetto JSON. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +## Proprietà di notifica Android + +La seguente selezione elenca le proprietà di notifica Android: + +* message - messaggio di notifica di push +* payload - oggetto JSON che contiene un payload di notifica + + +## Proprietà di notifica iOS + +La seguente sezione elenca le proprietà di notifica iOS: + +* message - messaggio di notifica di push +* payload - oggetto JSON che contiene un payload di notifica +action-loc-key - la stringa viene utilizzata come una chiave per ottenere una stringa localizzata nella localizzazione corrente da utilizzare per il titolo del pulsante destro invece di “View". +* badge - il numero da visualizzare come badge dell'icona applicazione. Se questa proprietà + non è presente, il badge non viene modificato. Per rimuovere il badge, imposta + il valore di questa proprietà su 0. +* sound - il nome di un file audio nel bundle dell'applicazione o nella cartella + Library/Sounds dei contenitore di dati dell'applicazione. + +## Objective-C + +Aggiungi i seguenti frammenti di codice Objective-C alla classe delegato della tua applicazione. + +``` +// Gestisci la ricezione di una notifica remota +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Gestisci la ricezione di una notifica all'avvio +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +## Swift + +Aggiungi i seguenti frammenti di codice Swift alla classe delegato della tua applicazione. + +``` +// Gestisci la ricezione di una notifica remota +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Gestisci la ricezione di una notifica remota all'avvio +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` +Fase successiva. [Invia notifiche di push di base](t_send_push_notifications.html). diff --git a/services/mobilepush/nl/it/t_cordova_register.md b/services/mobilepush/nl/it/t_cordova_register.md index d116eb9cd..2f27db530 100644 --- a/services/mobilepush/nl/it/t_cordova_register.md +++ b/services/mobilepush/nl/it/t_cordova_register.md @@ -1,143 +1,143 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Registrazione di dispositivi - -{: #cordova_register} - -Per registrare un dispositivo con il Push Notification Service, richiama il metodo. - -Copia e incolla il seguente frammento di codice nella tua applicazione Cordova per registrare - un dispositivo. - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android non utilizza il parametro delle impostazioni. Se stai soltanto creando un'applicazione Android, invia un oggetto vuoto; ad esempio: - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -Se vuoi personalizzare le proprietà di avviso, badge e audio, - aggiungi il seguente frammento di codice JavaScript alla parte web della tua applicazione - Cordova. - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -Puoi accedere ai contenuti del parametro di risposta con esito positivo in Javascript utilizzando JSON.parse: -**var token = JSON.parse(response).token** - - -Le chiavi disponibili sono le seguenti: `token`, `userId` e `deviceId`. - -Il seguente frammento di codice JavaScript mostra come inizializzare il tuo Bluemix Mobile Services client SDK, registra un dispositivo ed è in ascolto per le notifiche push. Inserisci questo codice nel tuo file Javascript. - - - -``` -//Registra il token di dispositivo presso il Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -in **onDeviceReady: function()**. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -Aggiungi il seguente frammento di codice Objective-C alla classe delegato della tua applicazione - -``` - // Registra il token dispositivo con Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -Aggiungi il seguente frammento di codice Swift alla classe delegato della tua applicazione. - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -//Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##Passi successivi -{: #cordova_register_next} - -1. Crea il tuo progetto e quindi eseguilo utilizzando i seguenti comandi: - - * Android - **cordova build android** e quindi **cordova run android** - - * iOS - **cordova build ios** e quindi **cordova run ios** -1. [Ricezione di notifiche di push sui dispositivi](t_cordova_receive.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Registrazione di dispositivi + +{: #cordova_register} + +Per registrare un dispositivo con il Push Notification Service, richiama il metodo. + +Copia e incolla il seguente frammento di codice nella tua applicazione Cordova per registrare + un dispositivo. + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android non utilizza il parametro delle impostazioni. Se stai soltanto creando un'applicazione Android, invia un oggetto vuoto; ad esempio: + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +Se vuoi personalizzare le proprietà di avviso, badge e audio, + aggiungi il seguente frammento di codice JavaScript alla parte web della tua applicazione + Cordova. + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +Puoi accedere ai contenuti del parametro di risposta con esito positivo in Javascript utilizzando JSON.parse: +**var token = JSON.parse(response).token** + + +Le chiavi disponibili sono le seguenti: `token`, `userId` e `deviceId`. + +Il seguente frammento di codice JavaScript mostra come inizializzare il tuo Bluemix Mobile Services client SDK, registra un dispositivo ed è in ascolto per le notifiche push. Inserisci questo codice nel tuo file Javascript. + + + +``` +//Registra il token di dispositivo presso il Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +in **onDeviceReady: function()**. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +Aggiungi il seguente frammento di codice Objective-C alla classe delegato della tua applicazione + +``` + // Registra il token dispositivo con Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +Aggiungi il seguente frammento di codice Swift alla classe delegato della tua applicazione. + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +//Gestisci l'errore in caso di registrazione del token di dispositivo presso APNS non riuscita +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## Passi successivi +{: #cordova_register_next} + +1. Crea il tuo progetto e quindi eseguilo utilizzando i seguenti comandi: + + * Android - **cordova build android** e quindi **cordova run android** + + * iOS - **cordova build ios** e quindi **cordova run ios** +1. [Ricezione di notifiche di push sui dispositivi](t_cordova_receive.html). diff --git a/services/mobilepush/nl/it/t_create_push_instance.md b/services/mobilepush/nl/it/t_create_push_instance.md index ea7829944..9e34e3a95 100644 --- a/services/mobilepush/nl/it/t_create_push_instance.md +++ b/services/mobilepush/nl/it/t_create_push_instance.md @@ -1,33 +1,33 @@ -# Creazione di un'istanza del servizio push -{: #create-push-instance} - -Per iniziare a lavorare con {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, devi prima creare un'applicazione {{site.data.keyword.Bluemix}}, ad esempio un'applicazione Node.js. Puoi quindi creare un'istanza di un servizio Push, {{site.data.keyword.mobilepushfull}}, che deve essere associata a questa applicazione Bluemix. Puoi anche eseguire questa operazione andando alla sezione Contenitore tipo del catalogo Bluemix e facendo clic su MobileFirst Services Starter. - -**Nota**: se hai configurato le organizzazioni per gestire il tuo ambiente, seleziona l'organizzazione in cui vuoi creare il runtime e i servizi per la tua applicazione mobile. - - -1. Se non disponi di un'applicazione Bluemix, devi crearne una; ad esempio un'applicazione Node.js. Per creare un'applicazione Bluemix, vai al dashboard Bluemix e fai clic su **Crea applicazione**. - - **Nota**: se hai un'applicazione, vai al passo 7 per aggiungere un servizio.![Crea un'istanza del servizio](images/create_service_instance1.jpg "Crea un'istanza del servizio") - -1. Da **Scegli il template della tua applicazione**, fai clic su **WEB** - -3. Nell'area **Scegli il punto di partenza**, seleziona **SDK for Node.js** e quindi fai clic su **CONTINUA**.![Punto di partenza](images/create_service_nodejs2.jpg) - -4. Dal menu a discesa **Spazio**, seleziona il tuo spazio dell'organizzazione.![Seleziona spazio dell'organizzazione](images/create_a_service3.jpg) -1. In **Nome**, immetti il nome della tua applicazione e, nell'host, immetti il nome dell'host. - -1. Dal menu a discesa **Piano selezionato**, - seleziona un piano e fai quindi clic sul pulsante **CREA**. Attendi la preparazione dell'applicazione. - -1. Fai clic sul link **Panoramica**.![Aggiungi un servizio](images/create_service_add4.jpg) -1. Fai clic su **Aggiungi un servizio** . Viene visualizzata la schermata CATALOGO. - -1. Seleziona **IBM Push Notifications:** e dal menu a discesa **Spazio**, seleziona la tua organizzazione.![Menu a discesa dello spazio dell'organizzazione](images/create_service_org.jpg) -1. Nel nome **Servizio**, immetti il nome del servizio Notifica di push. - -1. Nel campo **Piano selezionato**, seleziona un piano e fai clic sul pulsante **CREA**. - -1. Fai clic su **Sì** per ripreparare l'applicazione.![IBM Push Notification Service](images/create_service_notification5.jpg) - -1. Fai clic su **Push Notifications** per visualizzare il dashboard Push Notification. +# Creazione di un'istanza del servizio push +{: #create-push-instance} + +Per iniziare a lavorare con {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, devi prima creare un'applicazione {{site.data.keyword.Bluemix}}, ad esempio un'applicazione Node.js. Puoi quindi creare un'istanza di un servizio Push, {{site.data.keyword.mobilepushfull}}, che deve essere associata a questa applicazione Bluemix. Puoi anche eseguire questa operazione andando alla sezione Contenitore tipo del catalogo Bluemix e facendo clic su MobileFirst Services Starter. + +**Nota**: se hai configurato le organizzazioni per gestire il tuo ambiente, seleziona l'organizzazione in cui vuoi creare il runtime e i servizi per la tua applicazione mobile. + + +1. Se non disponi di un'applicazione Bluemix, devi crearne una; ad esempio un'applicazione Node.js. Per creare un'applicazione Bluemix, vai al dashboard Bluemix e fai clic su **Crea applicazione**. + + **Nota**: se hai un'applicazione, vai al passo 7 per aggiungere un servizio.![Crea un'istanza del servizio](images/create_service_instance1.jpg "Crea un'istanza del servizio") + +1. Da **Scegli il template della tua applicazione**, fai clic su **WEB** + +3. Nell'area **Scegli il punto di partenza**, seleziona **SDK for Node.js** e quindi fai clic su **CONTINUA**.![Punto di partenza](images/create_service_nodejs2.jpg) + +4. Dal menu a discesa **Spazio**, seleziona il tuo spazio dell'organizzazione.![Seleziona spazio dell'organizzazione](images/create_a_service3.jpg) +1. In **Nome**, immetti il nome della tua applicazione e, nell'host, immetti il nome dell'host. + +1. Dal menu a discesa **Piano selezionato**, + seleziona un piano e fai quindi clic sul pulsante **CREA**. Attendi la preparazione dell'applicazione. + +1. Fai clic sul link **Panoramica**.![Aggiungi un servizio](images/create_service_add4.jpg) +1. Fai clic su **Aggiungi un servizio** . Viene visualizzata la schermata CATALOGO. + +1. Seleziona **IBM Push Notifications:** e dal menu a discesa **Spazio**, seleziona la tua organizzazione.![Menu a discesa dello spazio dell'organizzazione](images/create_service_org.jpg) +1. Nel nome **Servizio**, immetti il nome del servizio Notifica di push. + +1. Nel campo **Piano selezionato**, seleziona un piano e fai clic sul pulsante **CREA**. + +1. Fai clic su **Sì** per ripreparare l'applicazione.![IBM Push Notification Service](images/create_service_notification5.jpg) + +1. Fai clic su **Push Notifications** per visualizzare il dashboard Push Notification. diff --git a/services/mobilepush/nl/it/t_enable-ios-notifications-receive.md b/services/mobilepush/nl/it/t_enable-ios-notifications-receive.md index 0950032f1..0eb7cc9e3 100644 --- a/services/mobilepush/nl/it/t_enable-ios-notifications-receive.md +++ b/services/mobilepush/nl/it/t_enable-ios-notifications-receive.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Ricezione di notifiche di push su dispositivi iOS -{: #enable-push-ios-notifications-receiving} - -Ricezione di notifiche di push su dispositivi iOS. - -##Objective-C -Per ricevere notifiche di push sui dispositivi ioS, aggiungi il seguente metodo Objective-C al delegato applicazione della tua applicazione. - -``` -// Per Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//il dizionario userInfo conterrà i dati inviati dal server. -} -``` - -##Swift -Per ricevere notifiche di push sui dispositivi ioS, aggiungi il seguente metodo Swift al delegato applicazione della tua applicazione. - -``` - // Per Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //Il dizionario UserInfo conterrà i dati inviati dal server - } -``` - +--- + +copyright: + years: 2015, 2016 + +--- + +# Ricezione di notifiche di push su dispositivi iOS +{: #enable-push-ios-notifications-receiving} + +Ricezione di notifiche di push su dispositivi iOS. + +## Objective-C +Per ricevere notifiche di push sui dispositivi ioS, aggiungi il seguente metodo Objective-C al delegato applicazione della tua applicazione. + +``` +// Per Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//il dizionario userInfo conterrà i dati inviati dal server. +} +``` + +## Swift +Per ricevere notifiche di push sui dispositivi ioS, aggiungi il seguente metodo Swift al delegato applicazione della tua applicazione. + +``` + // Per Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //Il dizionario UserInfo conterrà i dati inviati dal server + } +``` + diff --git a/services/mobilepush/nl/it/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/it/t_enable_actionable_notifications_ios.md index fd1f6e2bb..2852f4a94 100644 --- a/services/mobilepush/nl/it/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/it/t_enable_actionable_notifications_ios.md @@ -1,107 +1,107 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Abilitazione di notifiche operative per iOS -{: #enable-actionable-notifications-ios} - -A differenza delle notifiche di push tradizionali, le notifiche operative richiedono agli utenti di effettuare una selezione al momento della ricezione dell'avviso di notifica senza aprire l'applicazione. Utilizza le seguenti istruzioni per abilitare le notifiche di push operative nella tua applicazione. - -1. Crea un'azione di risposta utente. - - Objective-C - - ``` - // Per Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. Crea la categoria di notifica e imposta un'azione. **UIUserNotificationActionContextDefault** o - **UIUserNotificationActionContextMinimal** sono -contesti validi. - - Objective-C - - ``` - // Per Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // Per Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. Crea l'impostazione di notifica e assegna le categorie -dal passo precedente. - - Objective-C - - ``` - // Per Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // Per Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. Crea la notifica locale o remota e assegnale -l'identità della categoria. - - Objective-C - - ``` - //Per Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //Per Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Abilitazione di notifiche operative per iOS +{: #enable-actionable-notifications-ios} + +A differenza delle notifiche di push tradizionali, le notifiche operative richiedono agli utenti di effettuare una selezione al momento della ricezione dell'avviso di notifica senza aprire l'applicazione. Utilizza le seguenti istruzioni per abilitare le notifiche di push operative nella tua applicazione. + +1. Crea un'azione di risposta utente. + + Objective-C + + ``` + // Per Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. Crea la categoria di notifica e imposta un'azione. **UIUserNotificationActionContextDefault** o + **UIUserNotificationActionContextMinimal** sono +contesti validi. + + Objective-C + + ``` + // Per Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // Per Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. Crea l'impostazione di notifica e assegna le categorie +dal passo precedente. + + Objective-C + + ``` + // Per Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // Per Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. Crea la notifica locale o remota e assegnale +l'identità della categoria. + + Objective-C + + ``` + //Per Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //Per Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/it/t_enable_ios_notifications_initialize.md b/services/mobilepush/nl/it/t_enable_ios_notifications_initialize.md index 869519462..dbf082e44 100644 --- a/services/mobilepush/nl/it/t_enable_ios_notifications_initialize.md +++ b/services/mobilepush/nl/it/t_enable_ios_notifications_initialize.md @@ -1,68 +1,68 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Inizializzazione di Push SDK per applicazioni iOS -{: #enable-push-ios-notifications-initialize} - -Un posto comune dove inserire il codice di inizializzazione è nel delegato dell'applicazione per l'applicazione iOS. -Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix - per ottenere rotta e GUID dell'applicazione. - -##Inizializzazione dell'SDK Core - -###Objective-C - -``` -// Inizializza l'SDK for Object-C con la rotta e la GUID IBM Bluemix -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Inizializza l'SDK Core for Swift con l'area, la rotta e la GUID IBM Bluemix -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Ubicazione in cui è ospitata la tua applicazione") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - -##Inizializzazione del Push SDK client - -###Objective-C - -``` -//Inizializza il Push SDK for Objective-C client -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Inizializza il Push SDK for Swift client -let push = BMSPushClient.sharedInstance -``` - -## Rotta, GUID e area Bluemix - -**appRoute** - -Specifica la rotta assegnato all'applicazione server creata in Bluemix. - -**GUID** - -Specifica la chiave univoca assegnata all'applicazione creata in Bluemix. Questo valore è - sensibile al maiuscolo/minuscolo. - -**bluemixRegionSuffix** - -Specifica l'ubicazione in cui è ospitata l'applicazione. Il parametro `bluemixRegion` specifica quale distribuzione di Bluemix stati utilizzando. Puoi impostare questo valore con una proprietà statica `BMSClient.REGION` e utilizzare uno dei seguenti tre valori: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY +--- + +copyright: + years: 2015, 2016 + +--- + +# Inizializzazione di Push SDK per applicazioni iOS +{: #enable-push-ios-notifications-initialize} + +Un posto comune dove inserire il codice di inizializzazione è nel delegato dell'applicazione per l'applicazione iOS. +Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix + per ottenere rotta e GUID dell'applicazione. + +##Inizializzazione dell'SDK Core + +###Objective-C + +``` +// Inizializza l'SDK for Object-C con la rotta e la GUID IBM Bluemix +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +###Swift + +``` +// Inizializza l'SDK Core for Swift con l'area, la rotta e la GUID IBM Bluemix +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Ubicazione in cui è ospitata la tua applicazione") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + +##Inizializzazione del Push SDK client + +###Objective-C + +``` +//Inizializza il Push SDK for Objective-C client +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +###Swift + +``` +//Inizializza il Push SDK for Swift client +let push = BMSPushClient.sharedInstance +``` + +## Rotta, GUID e area Bluemix + +**appRoute** + +Specifica la rotta assegnato all'applicazione server creata in Bluemix. + +**GUID** + +Specifica la chiave univoca assegnata all'applicazione creata in Bluemix. Questo valore è + sensibile al maiuscolo/minuscolo. + +**bluemixRegionSuffix** + +Specifica l'ubicazione in cui è ospitata l'applicazione. Il parametro `bluemixRegion` specifica quale distribuzione di Bluemix stati utilizzando. Puoi impostare questo valore con una proprietà statica `BMSClient.REGION` e utilizzare uno dei seguenti tre valori: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY diff --git a/services/mobilepush/nl/it/t_enable_ios_notifications_install.md b/services/mobilepush/nl/it/t_enable_ios_notifications_install.md index e90f23f3f..c5416c7e9 100644 --- a/services/mobilepush/nl/it/t_enable_ios_notifications_install.md +++ b/services/mobilepush/nl/it/t_enable_ios_notifications_install.md @@ -1,327 +1,327 @@ -# Inizializzazione di Push SDK per applicazioni iOS -{: #enable-push-ios-notifications-install} - -Per un progetto Xcode esistente, puoi impostare il Bluemix Mobile Services Client SDK utilizzando lo strumento di gestione delle dipendenze CocoaPods. Un'alternativa consiste nell'installare l'SDK in modo manuale. - -**Nota**: per visualizzare il file readme Swift Push, vai a https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master - -##Installazione di CocoaPods - -1. Installa CocoaPods utilizzando il seguente comando nel tuo terminale Mac. -``` -$ sudo gem install cocoapods -``` -2. Immetti il seguente comando nel terminale per inizializzare CocoaPods. Quando immetti questo comando, assicurati di eseguirlo nella directory dove si trova il tuo progetto Xcode. Il comando `pod init` file denominato Podfile. -``` -$ pod init -``` -3. Nel Podfile generato, aggiungi le dipendenze SDK di cui hai bisogno. Copia il seguente Podfile. - - Objective-C - - ``` - source 'https://github.com/CocoaPods/Specs.git' - Copia il seguente elenco come è e rimuovi le dipendenze di cui non hai bisogno - pod 'IMFCore' - pod 'IMFPush' - ``` - - Swift - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copia il seguente elenco come è e rimuovi le dipendenze di cui non hai bisogno. - use_frameworks! - - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - end - ``` -3. Dal terminale, vai alla cartella del progetto e installa le dipendenze con il seguente comando: -``` -$ pod update -``` -Tale comando installa le tue dipendenze e crea un nuovo spazio di lavoro Xcode. **Nota**: assicurati di aprire sempre il nuovo spazio di lavoro Xcode invece del file di progetto Xcode originale: - - ``` - $ open App.xcworkspace - ``` -Lo spazio di lavoro contiene il tuo progetto originale e il progetto Pods che contiene le tue dipendenze. Se vuoi modificare una cartella di origine Bluemix Mobile Services, puoi trovarla nel tuo progetto Pods, in `Pods/yourImportedSourceFolder`, ad esempio: `Pods/IMFGoogleAuthentication`. - -##Utilizzo dei framework importati e delle cartelle di origine - -Fai riferimento all'SDK nel tuo codice. - - -### Objective-C - -Scrivi le direttive #import per le intestazioni pertinenti, ad esempio: - -``` -//Objective-C -#import -#import -``` - -**Nota**: aggiornare il tuo progetto Pods utilizzando i comandi CocoaPods `pod install` o `pod update` potrebbe sovrascrivere le cartelle di origine Bluemix Mobile Services. Se vuoi conservare le tue versioni personalizzate dei file originali, assicurati che ne sia stato eseguito il backup prime di immettere uno di questi comandi. - -###Swift - -**Prerequisiti** - -- iOS 8.0 o successiva -- Xcode 7 - - -Scrivi le direttive #import per le intestazioni pertinenti, ad esempio: - -``` -//swift -import BMSCore -import BMSPush -``` - - -##Impostazioni di creazione - -Vai a **Xcode > Build Settings > Build Options e imposta Enable Bitcode** su **No**. - -**Attenzione**: a partire da iOS 9, le modifiche alla funzione ATS (App Transport Security) potrebbero influenzare il modo in cui gestisci il processo di autenticazione. I seguenti post del blog descrivono in maggiore dettaglio le modifiche:[ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) e [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) - - - - -# Inizializzazione di Push SDK per applicazioni iOS -{: #enable-push-ios-notifications-initialize} - -Un posto comune dove inserire il codice di inizializzazione è nel delegato dell'applicazione per l'applicazione iOS. -Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix - per ottenere rotta e GUID dell'applicazione. - -##Inizializzazione dell'SDK Core - -###Objective-C - -``` -// Inizializza l'SDK for Object-C con la rotta e la GUID IBM Bluemix -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Inizializza l'SDK Core for Swift con l'area, la rotta e la GUID IBM Bluemix -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Ubicazione in cui è ospitata la tua applicazione") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - - -##Inizializzazione del Push SDK client - -###Objective-C - -``` -//Inizializza il Push SDK for Objective-C client -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Inizializza il Push SDK for Swift client -let push = BMSPushClient.sharedInstance -``` - -## Rotta, GUID e area Bluemix - -**appRoute** - -Specifica la rotta assegnato all'applicazione server creata in Bluemix. - -**GUID** - -Specifica la chiave univoca assegnata all'applicazione creata in Bluemix. Questo valore è - sensibile al maiuscolo/minuscolo. - -**bluemixRegionSuffix** - -Specifica l'ubicazione in cui è ospitata l'applicazione. Il parametro `bluemixRegion` specifica quale distribuzione di Bluemix stati utilizzando. Puoi impostare questo valore con una proprietà statica `BMSClient.REGION` e utilizzare uno dei seguenti tre valori: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - - - - -# Registrazione di dispositivi ed applicazioni iOS -{: #enable-push-ios-notifications-register} - - -Un'applicazione deve essere registrata con il servizio APNS per ricevere le notifiche remote, il che di solito avviene -dopo che l'applicazione viene installata su un dispositivo. Una volta che il token del dispositivo generato da APNS viene ricevuto dall'applicazione, questo deve essere trasmesso nuovamente al Push Notifications Service. - -Per registrare le applicazioni e dispositivi iOs: - -1. Crea un'applicazione di backend -2. Invia il token a Push Notifications - - -##Crea un'applicazione di backend - -Crea un'applicazione di backend nella sezione Contenitori tipo del catalogo Bluemix®, che esegue automaticamente il bind del servizio Push a questa applicazione. Se già hai - creato un'applicazione di backend, assicurati di eseguirne il bind al Push - Notification Service. - -###Objective-C - -``` - //Per Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //Per Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##Invia il token a Push Notifications - -Dopo che il token viene ricevuto da APNs, passa il token a Push Notifications come parte del metodo `registerDevice:withDeviceToken`. - -###Objective-C - -``` -//Per Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute:@"il-tuo-instradamento-di-backend-qui" backendGUID:@"il-tuo-GUID-di-backend-qui"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -Dopo che il token viene ricevuto da APNS, passa il token a Push Notifications come parte del metodo `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` - - - -# Ricezione di notifiche di push su dispositivi iOS -{: #enable-push-ios-notifications-receiving} - -Ricezione di notifiche di push su dispositivi iOS. - -##Objective-C -Per ricevere notifiche di push sui dispositivi ioS, aggiungi il seguente metodo Objective-C al delegato applicazione della tua applicazione. - -``` -// Per Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//il dizionario userInfo conterrà i dati inviati dal server. -} -``` - -##Swift -Per ricevere notifiche di push sui dispositivi ioS, aggiungi il seguente metodo Swift al delegato applicazione della tua applicazione. - -``` - // Per Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //Il dizionario UserInfo conterrà i dati inviati dal server - } - -``` - - - -# Invio di notifiche di push di base -{: #push-send-notifications} - -Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base (senza utilizzare tag, badge, payload aggiuntivi o file audio). - - -Invia notifiche di push di base. - -1. In **Choose the Audience**, seleziona uno dei seguenti destinatari: - **All Devices**, oppure in base alla piattaforma: **Only iOS devices** o - **Only Android devices**. - - **Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi che hanno sottoscritto le notifiche di push ricevono la tua notifica. - - ![Schermata notifiche](images/tag_notification.jpg) - -2. In **Create your Notification**, immetti il tuo messaggio e quindi fai clic su **Send**. -3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. - - Il seguente screenshot mostra una casella di avviso che gestisce una notifica push -in primo piano su un dispositivo Android e iOS. - - ![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) - - ![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) - - Il seguente screenshot mostra una notifica push in background per Android. - ![Notifica push in background su Android](images/background.jpg) - - - - -# Fasi successive -{: #next_steps_tags} - -Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche - basate sulle tag e le opzioni avanzate. - -Aggiungi queste funzioni del servizio Push Notifications alla tua applicazione. -Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). -Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche di push avanzate](t_advance_notifications.html). +# Inizializzazione di Push SDK per applicazioni iOS +{: #enable-push-ios-notifications-install} + +Per un progetto Xcode esistente, puoi impostare il Bluemix Mobile Services Client SDK utilizzando lo strumento di gestione delle dipendenze CocoaPods. Un'alternativa consiste nell'installare l'SDK in modo manuale. + +**Nota**: per visualizzare il file readme Swift Push, vai a https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master + +##Installazione di CocoaPods + +1. Installa CocoaPods utilizzando il seguente comando nel tuo terminale Mac. +``` +$ sudo gem install cocoapods +``` +2. Immetti il seguente comando nel terminale per inizializzare CocoaPods. Quando immetti questo comando, assicurati di eseguirlo nella directory dove si trova il tuo progetto Xcode. Il comando `pod init` file denominato Podfile. +``` +$ pod init +``` +3. Nel Podfile generato, aggiungi le dipendenze SDK di cui hai bisogno. Copia il seguente Podfile. + + Objective-C + + ``` + source 'https://github.com/CocoaPods/Specs.git' + Copia il seguente elenco come è e rimuovi le dipendenze di cui non hai bisogno + pod 'IMFCore' + pod 'IMFPush' + ``` + + Swift + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copia il seguente elenco come è e rimuovi le dipendenze di cui non hai bisogno. + use_frameworks! + + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + end + ``` +3. Dal terminale, vai alla cartella del progetto e installa le dipendenze con il seguente comando: +``` +$ pod update +``` +Tale comando installa le tue dipendenze e crea un nuovo spazio di lavoro Xcode. **Nota**: assicurati di aprire sempre il nuovo spazio di lavoro Xcode invece del file di progetto Xcode originale: + + ``` + $ open App.xcworkspace + ``` +Lo spazio di lavoro contiene il tuo progetto originale e il progetto Pods che contiene le tue dipendenze. Se vuoi modificare una cartella di origine Bluemix Mobile Services, puoi trovarla nel tuo progetto Pods, in `Pods/yourImportedSourceFolder`, ad esempio: `Pods/IMFGoogleAuthentication`. + +##Utilizzo dei framework importati e delle cartelle di origine + +Fai riferimento all'SDK nel tuo codice. + + +### Objective-C + +Scrivi le direttive #import per le intestazioni pertinenti, ad esempio: + +``` +//Objective-C +# import +# import +``` + +**Nota**: aggiornare il tuo progetto Pods utilizzando i comandi CocoaPods `pod install` o `pod update` potrebbe sovrascrivere le cartelle di origine Bluemix Mobile Services. Se vuoi conservare le tue versioni personalizzate dei file originali, assicurati che ne sia stato eseguito il backup prime di immettere uno di questi comandi. + +###Swift + +**Prerequisiti** + +- iOS 8.0 o successiva +- Xcode 7 + + +Scrivi le direttive #import per le intestazioni pertinenti, ad esempio: + +``` +//swift +import BMSCore +import BMSPush +``` + + +##Impostazioni di creazione + +Vai a **Xcode > Build Settings > Build Options e imposta Enable Bitcode** su **No**. + +**Attenzione**: a partire da iOS 9, le modifiche alla funzione ATS (App Transport Security) potrebbero influenzare il modo in cui gestisci il processo di autenticazione. I seguenti post del blog descrivono in maggiore dettaglio le modifiche:[ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) e [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) + + + + +# Inizializzazione di Push SDK per applicazioni iOS +{: #enable-push-ios-notifications-initialize} + +Un posto comune dove inserire il codice di inizializzazione è nel delegato dell'applicazione per l'applicazione iOS. +Fai clic sul link **Opzioni mobili** nel tuo dashboard dell'applicazione Bluemix + per ottenere rotta e GUID dell'applicazione. + +##Inizializzazione dell'SDK Core + +###Objective-C + +``` +// Inizializza l'SDK for Object-C con la rotta e la GUID IBM Bluemix +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +###Swift + +``` +// Inizializza l'SDK Core for Swift con l'area, la rotta e la GUID IBM Bluemix +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Ubicazione in cui è ospitata la tua applicazione") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + + +##Inizializzazione del Push SDK client + +###Objective-C + +``` +//Inizializza il Push SDK for Objective-C client +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +###Swift + +``` +//Inizializza il Push SDK for Swift client +let push = BMSPushClient.sharedInstance +``` + +## Rotta, GUID e area Bluemix + +**appRoute** + +Specifica la rotta assegnato all'applicazione server creata in Bluemix. + +**GUID** + +Specifica la chiave univoca assegnata all'applicazione creata in Bluemix. Questo valore è + sensibile al maiuscolo/minuscolo. + +**bluemixRegionSuffix** + +Specifica l'ubicazione in cui è ospitata l'applicazione. Il parametro `bluemixRegion` specifica quale distribuzione di Bluemix stati utilizzando. Puoi impostare questo valore con una proprietà statica `BMSClient.REGION` e utilizzare uno dei seguenti tre valori: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + + + + +# Registrazione di dispositivi ed applicazioni iOS +{: #enable-push-ios-notifications-register} + + +Un'applicazione deve essere registrata con il servizio APNS per ricevere le notifiche remote, il che di solito avviene +dopo che l'applicazione viene installata su un dispositivo. Una volta che il token del dispositivo generato da APNS viene ricevuto dall'applicazione, questo deve essere trasmesso nuovamente al Push Notifications Service. + +Per registrare le applicazioni e dispositivi iOs: + +1. Crea un'applicazione di backend +2. Invia il token a Push Notifications + + +##Crea un'applicazione di backend + +Crea un'applicazione di backend nella sezione Contenitori tipo del catalogo Bluemix®, che esegue automaticamente il bind del servizio Push a questa applicazione. Se già hai + creato un'applicazione di backend, assicurati di eseguirne il bind al Push + Notification Service. + +###Objective-C + +``` + //Per Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +###Swift + +``` + //Per Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +##Invia il token a Push Notifications + +Dopo che il token viene ricevuto da APNs, passa il token a Push Notifications come parte del metodo `registerDevice:withDeviceToken`. + +###Objective-C + +``` +//Per Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute:@"il-tuo-instradamento-di-backend-qui" backendGUID:@"il-tuo-GUID-di-backend-qui"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +###Swift + +Dopo che il token viene ricevuto da APNS, passa il token a Push Notifications come parte del metodo `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` + + + +# Ricezione di notifiche di push su dispositivi iOS +{: #enable-push-ios-notifications-receiving} + +Ricezione di notifiche di push su dispositivi iOS. + +##Objective-C +Per ricevere notifiche di push sui dispositivi ioS, aggiungi il seguente metodo Objective-C al delegato applicazione della tua applicazione. + +``` +// Per Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//il dizionario userInfo conterrà i dati inviati dal server. +} +``` + +##Swift +Per ricevere notifiche di push sui dispositivi ioS, aggiungi il seguente metodo Swift al delegato applicazione della tua applicazione. + +``` + // Per Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //Il dizionario UserInfo conterrà i dati inviati dal server + } + +``` + + + +# Invio di notifiche di push di base +{: #push-send-notifications} + +Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base (senza utilizzare tag, badge, payload aggiuntivi o file audio). + + +Invia notifiche di push di base. + +1. In **Choose the Audience**, seleziona uno dei seguenti destinatari: + **All Devices**, oppure in base alla piattaforma: **Only iOS devices** o + **Only Android devices**. + + **Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi che hanno sottoscritto le notifiche di push ricevono la tua notifica. + + ![Schermata notifiche](images/tag_notification.jpg) + +2. In **Create your Notification**, immetti il tuo messaggio e quindi fai clic su **Send**. +3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. + + Il seguente screenshot mostra una casella di avviso che gestisce una notifica push +in primo piano su un dispositivo Android e iOS. + + ![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) + + ![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) + + Il seguente screenshot mostra una notifica push in background per Android. + ![Notifica push in background su Android](images/background.jpg) + + + + +# Fasi successive +{: #next_steps_tags} + +Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche + basate sulle tag e le opzioni avanzate. + +Aggiungi queste funzioni del servizio Push Notifications alla tua applicazione. +Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](c_tag_basednotifications.html). +Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche di push avanzate](t_advance_notifications.html). diff --git a/services/mobilepush/nl/it/t_enable_ios_notifications_register.md b/services/mobilepush/nl/it/t_enable_ios_notifications_register.md index 065496607..cc9086769 100644 --- a/services/mobilepush/nl/it/t_enable_ios_notifications_register.md +++ b/services/mobilepush/nl/it/t_enable_ios_notifications_register.md @@ -1,94 +1,94 @@ -# Registrazione di dispositivi ed applicazioni iOS -{: #enable-push-ios-notifications-register} - - -Un'applicazione deve essere registrata con il servizio APNS per ricevere le notifiche remote, il che di solito avviene -dopo che l'applicazione viene installata su un dispositivo. Una volta che il token del dispositivo generato da APNS viene ricevuto dall'applicazione, questo deve essere trasmesso nuovamente al Push Notifications Service. - -Per registrare le applicazioni e dispositivi iOs: - -1. Crea un'applicazione di backend -2. Invia il token a Push Notifications - - -##Crea un'applicazione di backend - -Crea un'applicazione di backend nella sezione Contenitori tipo del catalogo Bluemix®, che esegue automaticamente il bind del servizio Push a questa applicazione. Se già hai - creato un'applicazione di backend, assicurati di eseguirne il bind al Push - Notification Service. - -###Objective-C - -``` - //Per Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //Per Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##Invia il token a Push Notifications - -Dopo che il token viene ricevuto da APNs, passa il token a Push Notifications come parte del metodo `registerDevice:withDeviceToken`. - -###Objective-C - -``` -//Per Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute:@"il-tuo-instradamento-di-backend-qui" backendGUID:@"il-tuo-GUID-di-backend-qui"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -Dopo che il token viene ricevuto da APNS, passa il token a Push Notifications come parte del metodo `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` +# Registrazione di dispositivi ed applicazioni iOS +{: #enable-push-ios-notifications-register} + + +Un'applicazione deve essere registrata con il servizio APNS per ricevere le notifiche remote, il che di solito avviene +dopo che l'applicazione viene installata su un dispositivo. Una volta che il token del dispositivo generato da APNS viene ricevuto dall'applicazione, questo deve essere trasmesso nuovamente al Push Notifications Service. + +Per registrare le applicazioni e dispositivi iOs: + +1. Crea un'applicazione di backend +2. Invia il token a Push Notifications + + +##Crea un'applicazione di backend + +Crea un'applicazione di backend nella sezione Contenitori tipo del catalogo Bluemix®, che esegue automaticamente il bind del servizio Push a questa applicazione. Se già hai + creato un'applicazione di backend, assicurati di eseguirne il bind al Push + Notification Service. + +###Objective-C + +``` + //Per Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +###Swift + +``` + //Per Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +##Invia il token a Push Notifications + +Dopo che il token viene ricevuto da APNs, passa il token a Push Notifications come parte del metodo `registerDevice:withDeviceToken`. + +###Objective-C + +``` +//Per Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute:@"il-tuo-instradamento-di-backend-qui" backendGUID:@"il-tuo-GUID-di-backend-qui"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +###Swift + +Dopo che il token viene ricevuto da APNS, passa il token a Push Notifications come parte del metodo `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` diff --git a/services/mobilepush/nl/it/t_get_tags.md b/services/mobilepush/nl/it/t_get_tags.md index e6c42f7f5..94784d617 100644 --- a/services/mobilepush/nl/it/t_get_tags.md +++ b/services/mobilepush/nl/it/t_get_tags.md @@ -1,158 +1,158 @@ -# Come ottenere le tag -{: #get_tags} - -Le tag forniscono un modo per inviare notifiche mirate agli utenti sulla base dei loro interessi, - a differenza dai broadcast generali che vengono inviati a tutte le applicazioni. Puoi creare e gestire le tag utilizzando la scheda Tag nel dashboard Push oppure utilizzare le API REST. Puoi utilizzare i frammenti di codice nelle seguenti sezioni per gestire e sottoporre a query le tue sottoscrizioni di tag per la tua applicazione mobile. Puoi utilizzare questi frammenti di codice per ottenere sottoscrizioni, sottoscrivere - una tag e ottenere un elenco delle tag disponibili. Copi e incolli questi frammenti di codice nella tua applicazione mobile. - -## Android - -La API **getTags** restituisce l'elenco di - tag disponibili che il dispositivo può sottoscrivere. Una volta sottoscritto a una - determinata tag, il dispositivo può ricevere una qualsiasi notifica di push inviata per tale - tag. - -Copia i seguenti frammenti di codice nella tua applicazione mobile Android per ottenere un elenco di - tag sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili. - -Utilizza l'API **getTags** per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. - -``` -// Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - -Utilizza la API **getSubscriptions** per ottenere un elenco delle tag sottoscritte dal dispositivo. - -``` -// Ottieni un elenco delle tag sottoscritte dal dispositivo. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Errore di ottenimento delle sottoscrizioni.. " + ex.getMessage()); - } -}) -``` - -## Cordova - -Copia i seguenti frammenti di codice nella tua applicazione mobile per ottenere un elenco di tag sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. - -Richiama un array delle tag disponibili per la sottoscrizione. - -``` -//Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo -MFPPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, null); - -``` - -``` -//Ottieni un elenco di tag disponibili sottoscritte dal dispositivo. -MFPPush.getSubscriptionStatus(function(tags) { - alert(tags); -}, null); -``` - -## Objective-C - -Copia i seguenti frammenti di codice nella tua applicazione iOS sviluppata con Objective-C per ottenere un elenco di tag sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. - -Utilizza la seguente API **retrieveAvailableTags** per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. - -``` -//Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo -[push retrieveAvailableTagsWithCompletionHandler: -^(IMFResponse *response, NSError *error){ - if (error){[ self updateMessage:error.description];} else { - [self updateMessage:@"Successfully retrieved available tags."]; - NSDictionary *availableTags = [[NSDictionary alloc]init]; - availableTags = [response tags]; -[self.appDelegateVC updateMessage:availableTags.description]; -} -}]; -``` - -Utilizza la API **retrieveSubscriptions** per ottenere un elenco delle tag sottoscritte dal dispositivo. - - -``` -// Ottieni un elenco delle tag sottoscritte dal dispositivo. -[push retrieveSubscriptionsWithCompletionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved subscriptions."]; - NSDictionary *subscribedTags = [[NSDictionary alloc]init]; -subscribedTags = [response subscriptions]; -[self.appDelegateVC updateMessage:subscribedTags.description]; -} -}]; -``` - -## Swift - -La API **retrieveAvailableTagsWithCompletionHandler** restituisce l'elenco di - tag disponibili che il dispositivo può sottoscrivere. Una volta sottoscritto a una - determinata tag, il dispositivo può ricevere una qualsiasi notifica di push inviata per tale - tag. - -Richiama il servizio push per ottenere le sottoscrizioni per una tag. - -Copia i seguenti frammenti di codice nella tua applicazione mobile Swift per ottenere un elenco delle tag disponibili sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. - - -``` -//Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo -push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - - if error.isEmpty { - - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else{ - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - -``` -//Ottieni un elenco di tag disponibili sottoscritte dal dispositivo -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - - print( "Response during retrieving subscribed tags : \(response.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - - - +# Come ottenere le tag +{: #get_tags} + +Le tag forniscono un modo per inviare notifiche mirate agli utenti sulla base dei loro interessi, + a differenza dai broadcast generali che vengono inviati a tutte le applicazioni. Puoi creare e gestire le tag utilizzando la scheda Tag nel dashboard Push oppure utilizzare le API REST. Puoi utilizzare i frammenti di codice nelle seguenti sezioni per gestire e sottoporre a query le tue sottoscrizioni di tag per la tua applicazione mobile. Puoi utilizzare questi frammenti di codice per ottenere sottoscrizioni, sottoscrivere + una tag e ottenere un elenco delle tag disponibili. Copi e incolli questi frammenti di codice nella tua applicazione mobile. + +## Android + +La API **getTags** restituisce l'elenco di + tag disponibili che il dispositivo può sottoscrivere. Una volta sottoscritto a una + determinata tag, il dispositivo può ricevere una qualsiasi notifica di push inviata per tale + tag. + +Copia i seguenti frammenti di codice nella tua applicazione mobile Android per ottenere un elenco di + tag sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili. + +Utilizza l'API **getTags** per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. + +``` +// Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + +Utilizza la API **getSubscriptions** per ottenere un elenco delle tag sottoscritte dal dispositivo. + +``` +// Ottieni un elenco delle tag sottoscritte dal dispositivo. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Errore di ottenimento delle sottoscrizioni.. " + ex.getMessage()); + } +}) +``` + +## Cordova + +Copia i seguenti frammenti di codice nella tua applicazione mobile per ottenere un elenco di tag sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. + +Richiama un array delle tag disponibili per la sottoscrizione. + +``` +//Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo +MFPPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, null); + +``` + +``` +//Ottieni un elenco di tag disponibili sottoscritte dal dispositivo. +MFPPush.getSubscriptionStatus(function(tags) { + alert(tags); +}, null); +``` + +## Objective-C + +Copia i seguenti frammenti di codice nella tua applicazione iOS sviluppata con Objective-C per ottenere un elenco di tag sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. + +Utilizza la seguente API **retrieveAvailableTags** per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. + +``` +//Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo +[push retrieveAvailableTagsWithCompletionHandler: +^(IMFResponse *response, NSError *error){ + if (error){[ self updateMessage:error.description];} else { + [self updateMessage:@"Successfully retrieved available tags."]; + NSDictionary *availableTags = [[NSDictionary alloc]init]; + availableTags = [response tags]; +[self.appDelegateVC updateMessage:availableTags.description]; +} +}]; +``` + +Utilizza la API **retrieveSubscriptions** per ottenere un elenco delle tag sottoscritte dal dispositivo. + + +``` +// Ottieni un elenco delle tag sottoscritte dal dispositivo. +[push retrieveSubscriptionsWithCompletionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved subscriptions."]; + NSDictionary *subscribedTags = [[NSDictionary alloc]init]; +subscribedTags = [response subscriptions]; +[self.appDelegateVC updateMessage:subscribedTags.description]; +} +}]; +``` + +## Swift + +La API **retrieveAvailableTagsWithCompletionHandler** restituisce l'elenco di + tag disponibili che il dispositivo può sottoscrivere. Una volta sottoscritto a una + determinata tag, il dispositivo può ricevere una qualsiasi notifica di push inviata per tale + tag. + +Richiama il servizio push per ottenere le sottoscrizioni per una tag. + +Copia i seguenti frammenti di codice nella tua applicazione mobile Swift per ottenere un elenco delle tag disponibili sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. + + +``` +//Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo +push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + + if error.isEmpty { + + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else{ + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + +``` +//Ottieni un elenco di tag disponibili sottoscritte dal dispositivo +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + + print( "Response during retrieving subscribed tags : \(response.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + + + diff --git a/services/mobilepush/nl/it/t_handle_actionable_notifications_ios.md b/services/mobilepush/nl/it/t_handle_actionable_notifications_ios.md index 59f5095ea..4b2e0e69f 100644 --- a/services/mobilepush/nl/it/t_handle_actionable_notifications_ios.md +++ b/services/mobilepush/nl/it/t_handle_actionable_notifications_ios.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Gestione di notifiche operative per iOS -{: #actionable-notifications} - - -Quando viene ricevuta una notifica operativa, il controllo -viene spostato sul seguente metodo in base all'identificativo -scelto. - -###Objective-C - -``` -(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: -(UILocalNotification *)notification completionHandler:(void (^)())completionHandler -{ - NSLog(@"actionable notification received."); - //è necessario richiamare il gestore del completamente quando finito - completionHandler(); -} -``` - -###Swift - -``` -func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { - //è necessario richiamare il gestore del completamente quando finito - completionHandler() - } -``` - - +--- + +copyright: + years: 2015, 2016 + +--- + +# Gestione di notifiche operative per iOS +{: #actionable-notifications} + + +Quando viene ricevuta una notifica operativa, il controllo +viene spostato sul seguente metodo in base all'identificativo +scelto. + +###Objective-C + +``` +(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: +(UILocalNotification *)notification completionHandler:(void (^)())completionHandler +{ + NSLog(@"actionable notification received."); + //è necessario richiamare il gestore del completamente quando finito + completionHandler(); +} +``` + +###Swift + +``` +func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { + //è necessario richiamare il gestore del completamente quando finito + completionHandler() + } +``` + + diff --git a/services/mobilepush/nl/it/t_holding_notifications_android.md b/services/mobilepush/nl/it/t_holding_notifications_android.md index 2b5765bab..bf9e88823 100755 --- a/services/mobilepush/nl/it/t_holding_notifications_android.md +++ b/services/mobilepush/nl/it/t_holding_notifications_android.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Notifiche messe in pausa per Android -{: #hold-notifications-android} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - -Quando la tua applicazione va in background, probabilmente vuoi che il servizio {{site.data.keyword.mobilepushshort}} conservi le notifiche inviate alla tua applicazione. Per mettere in pausa le notifiche, richiama il metodo hold() nel metodo onPause() dell'attività che sta gestendo {{site.data.keyword.mobilepushshort}}. - -``` - @Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Notifiche messe in pausa per Android +{: #hold-notifications-android} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + +Quando la tua applicazione va in background, probabilmente vuoi che il servizio {{site.data.keyword.mobilepushshort}} conservi le notifiche inviate alla tua applicazione. Per mettere in pausa le notifiche, richiama il metodo hold() nel metodo onPause() dell'attività che sta gestendo {{site.data.keyword.mobilepushshort}}. + +``` + @Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/it/t_manage_tags.md b/services/mobilepush/nl/it/t_manage_tags.md index 999431a63..f1bc6798b 100755 --- a/services/mobilepush/nl/it/t_manage_tags.md +++ b/services/mobilepush/nl/it/t_manage_tags.md @@ -1,351 +1,351 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Gestione delle tag -{: #manage_tags} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - -Utilizza il dashboard {{site.data.keyword.mobilepushshort}} per creare ed eliminare tag per la tua applicazione e avviare quindi le notifiche basate sulle tag. La notifica basata sulle tag viene ricevuta dai dispositivi che hanno sottoscritto le tag. - - -## Creazione di tag -{: #create_tags} - -Le notifiche basate sulle tag sono messaggi destinati a tutti i dispositivi sottoscritti a una particolare tag. Ciascun dispositivo può sottoscrivere qualsiasi numero di tag. Quando viene eliminata una tag, vengono eliminate anche le informazioni associate con tale tag, inclusi i relativi sottoscrittori e dispositivi. L'annullamento della sottoscrizione automatico non è obbligatorio, poiché la tag non esiste più. Non è richiesta alcuna ulteriore azione dal lato client. - -1. Nel dashboard {{site.data.keyword.mobilepushshort}} **Tags**. -1. Fai clic sul pulsante + **Crea tag**. - 1. Nel campo **Nome**, immetti il nome della tag. Ad esempio, "coupons". - 1. Nel campo **Descrizione**, immetti una descrizione della tag. - 1. Fai clic su **Save**. - -1. Nell'area **Frammenti di codice**, seleziona la piattaforma per la tua applicazione mobile. -1. Modifica i frammenti di codice per gestire gli errori e copiali quindi per ogni tag nella tua applicazione mobile. - -## Eliminazione di tag -{: #delete_tags} - -1. Dalla scheda **Tag**, seleziona la tag che vuoi eliminare e fai clic sull'icona **Elimina**. -1. Fai clic su **OK**. - -## Modifica della descrizione di una tag -{: #edit_tags} - -1. Dalla scheda **Tag**, seleziona la tag che vuoi modificare. -1. Fai clic sull'icona **Modifica**. -1. Modifica la descrizione della tag e fai quindi clic sul pulsante **Salva**. - -# Come ottenere le tag -{: #get_tags} - -Le tag forniscono un modo per inviare notifiche mirate agli utenti sulla base dei loro interessi, a differenza dai broadcast generali che vengono inviati a tutte le applicazioni. Puoi creare e gestire le tag utilizzando la scheda Tag nel dashboard {{site.data.keyword.mobilepushshort}}oppure utilizzare le API REST. Puoi utilizzare i frammenti di codice per gestire e sottoporre a query le tue sottoscrizioni di tag per la tua - applicazione mobile. Puoi utilizzare questi frammenti di codice per ottenere sottoscrizioni, sottoscrivere una tag, annullare la sottoscrizione a un tag o ottenere un elenco delle tag disponibili. Copia e incolla questi frammenti di codice nella tua applicazione mobile. - -## Come ottenere le tag su Android -{: android-get-tags} - -La API **getTags** restituisce l'elenco di - tag disponibili che il dispositivo può sottoscrivere. Una volta sottoscritto a una determinata tag, il dispositivo può ricevere {{site.data.keyword.mobilepushshort}} inviata per tale tag. - -Copia i seguenti frammenti di codice nella tua applicazione mobile Android per ottenere un elenco di tag sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili. - -Utilizza l'API **getTags** per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. - -``` -// Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } - }) -``` - {: codeblock} - -Utilizza la API **getSubscriptions** per ottenere un elenco delle tag sottoscritte dal dispositivo. - -``` -// Ottieni un elenco delle tag sottoscritte dal dispositivo. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Errore di ottenimento delle sottoscrizioni.. " + ex.getMessage()); - } -}) - ``` - {: codeblock} - -## Come ottenere le tag su Cordova -{: cordova-get-tags} - -Copia i seguenti frammenti di codice nella tua applicazione mobile per ottenere un elenco di tag sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili. - -Richiama un array delle tag disponibili per la sottoscrizione. - -``` -//Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo -BMSPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - -``` -//Ottieni un elenco di tag disponibili sottoscritte dal dispositivo. -BMSPush.retrieveSubscriptions(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - - -## Come ottenere le tag su Swift -{: swift-get-tags} - -La API **retrieveAvailableTagsWithCompletionHandler** restituisce l'elenco di - tag disponibili che il dispositivo può sottoscrivere. Una volta sottoscritto a una determinata tag, il dispositivo può ricevere {{site.data.keyword.mobilepushshort}} inviata per tale tag. - -Richiama {{site.data.keyword.mobilepushshort}} per ottenere le sottoscrizioni per una tag. - -Copia i seguenti frammenti di codice nella tua applicazione mobile Swift per ottenere un elenco delle tag disponibili sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. -``` -//Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo - push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - if error.isEmpty - { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else - { - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -``` -//Ottieni un elenco di tag disponibili sottoscritte dal dispositivo -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during retrieving subscribed tags : \(response?.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else - { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -## Google Chrome, Safari e Mozilla Firefox -{: web-get-tags} - -Per ottenere l'elenco delle tag disponibili, a cui possono sottoscriversi i clienti, utilizza il seguente codice. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - - -## Estensioni e applicazioni Google Chrome -{: web-get-tags} - -Per ottenere l'elenco delle tag disponibili, a cui possono sottoscriversi i clienti, utilizza il seguente codice. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - -Copia i seguenti frammenti di codice nelle tue estensioni e applicazioni Google Chrome per ottenere un elenco di tag a cui sono sottoscritti i clienti. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveSubscriptions(function(response) - { - alert(response.response) - }) -``` - {: codeblock} - - -# Sottoscrizione e annullamento di sottoscrizioni alle tag -{: #Subscribe_tags} - -Utilizza i seguenti frammenti di codice per consentire ai tuoi dispositivi di ottenere sottoscrizioni, sottoscriversi a una tag e annullare la sottoscrizione a una tag. - -## Sottoscrizione e annullamento di sottoscrizioni alle tag su Android -{: android-subscribe-tags} - -Copia e incolla questo frammento di codice nella tua applicazione mobile Android. - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } - }); -``` - {: codeblock} - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } - }); -``` - {: codeblock} - -## Sottoscrizione e annullamento di sottoscrizioni alle tag su Cordova -{: cordova-subscribe-tags} - -Copia e incolla questo frammento di codice nella tua applicazione mobile Cordova. - -``` -var tag = "YourTag"; -BMSPush.subscribe(tag, success, failure); -BMSPush.unsubscribe(tag, success, failure); -``` - {: codeblock} - - -## Sottoscrizione e annullamento di sottoscrizioni alle tag su Swift -{: swift-subscribe-tags} - -Copia e incolla questo frammento di codice nella tua applicazione mobile Swift. - -Utilizza la API **subscribeToTags** per sottoscrivere a una - tag. - -``` -push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print("Response when subscribing to tags: \(response?.description)") - print("Status code when subscribing to tags: \(statusCode)") - } else { - print("Error when subscribing to tags: \(error) ") - print("Error status code when subscribing to tags: \(statusCode)") - } -}) -``` - {: codeblock} - -Utilizza la API **unsubscribeFromTags** per annullare la sottoscrizione a una - tag. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during unsubscribed tags : \(response?.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - {: codeblock} - -## Google Chrome e Mozilla Firefox -{: web-subscribe-tags} - -Per sottoscriverti alle tag dalle applicazioni web, utilizza il seguente frammento di codice: - -``` -var tagsArray = ["tag1", "Tag2"] -bmsPush.subscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -Per annullare la sottoscrizione alle tag utilizza il metodo **unSubscribe**. - -``` -var tagsArray = ["tag1", "Tag2"] - bmsPush.unSubscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -# Utilizzo delle notifiche basate sulle tag -{: #using_tags} - -Le notifiche basate sulle tag sono messaggi destinati a tutti i dispositivi sottoscritti a una particolare tag. Ciascun dispositivo può essere sottoscritto a un qualsiasi numero di tag. Questo argomento descrive come inviare notifiche basate sulle tag. Le sottoscrizioni vengono gestite dall'istanza Bluemix del servizio {{site.data.keyword.mobilepushshort}}. Quando viene eliminata una tag, vengono eliminate anche tutte le informazioni associate con tale tag, inclusi i relativi sottoscrittori e dispositivi. Non è necessario un annullamento della sottoscrizione automatico per questa tag poiché non esiste più e non sono richieste ulteriori azioni dal lato client. - -Crea le tag sulla schermata **Tag**. Per informazioni su come creare le tag, vedi [Creazione di tag](t_manage_tags.html). - -1. Dal dashboard **Push Notification**, fai clic su **Send Notifications**. -1. Seleziona l'opzione **Device by Tag** nell'elenco a discesa **Send To**. -1. Cerca le tag che vuoi utilizzare e selezionale. -![Schermata notifiche](images/tag_notification.jpg) -1. Nel campo **Message Text**, immetti il testo che deve essere inviato come notifica ai destinatari sottoscritti. -1. Fai clic su **Send**. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Gestione delle tag +{: #manage_tags} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + +Utilizza il dashboard {{site.data.keyword.mobilepushshort}} per creare ed eliminare tag per la tua applicazione e avviare quindi le notifiche basate sulle tag. La notifica basata sulle tag viene ricevuta dai dispositivi che hanno sottoscritto le tag. + + +## Creazione di tag +{: #create_tags} + +Le notifiche basate sulle tag sono messaggi destinati a tutti i dispositivi sottoscritti a una particolare tag. Ciascun dispositivo può sottoscrivere qualsiasi numero di tag. Quando viene eliminata una tag, vengono eliminate anche le informazioni associate con tale tag, inclusi i relativi sottoscrittori e dispositivi. L'annullamento della sottoscrizione automatico non è obbligatorio, poiché la tag non esiste più. Non è richiesta alcuna ulteriore azione dal lato client. + +1. Nel dashboard {{site.data.keyword.mobilepushshort}} **Tags**. +1. Fai clic sul pulsante + **Crea tag**. + 1. Nel campo **Nome**, immetti il nome della tag. Ad esempio, "coupons". + 1. Nel campo **Descrizione**, immetti una descrizione della tag. + 1. Fai clic su **Save**. + +1. Nell'area **Frammenti di codice**, seleziona la piattaforma per la tua applicazione mobile. +1. Modifica i frammenti di codice per gestire gli errori e copiali quindi per ogni tag nella tua applicazione mobile. + +## Eliminazione di tag +{: #delete_tags} + +1. Dalla scheda **Tag**, seleziona la tag che vuoi eliminare e fai clic sull'icona **Elimina**. +1. Fai clic su **OK**. + +## Modifica della descrizione di una tag +{: #edit_tags} + +1. Dalla scheda **Tag**, seleziona la tag che vuoi modificare. +1. Fai clic sull'icona **Modifica**. +1. Modifica la descrizione della tag e fai quindi clic sul pulsante **Salva**. + +# Come ottenere le tag +{: #get_tags} + +Le tag forniscono un modo per inviare notifiche mirate agli utenti sulla base dei loro interessi, a differenza dai broadcast generali che vengono inviati a tutte le applicazioni. Puoi creare e gestire le tag utilizzando la scheda Tag nel dashboard {{site.data.keyword.mobilepushshort}}oppure utilizzare le API REST. Puoi utilizzare i frammenti di codice per gestire e sottoporre a query le tue sottoscrizioni di tag per la tua + applicazione mobile. Puoi utilizzare questi frammenti di codice per ottenere sottoscrizioni, sottoscrivere una tag, annullare la sottoscrizione a un tag o ottenere un elenco delle tag disponibili. Copia e incolla questi frammenti di codice nella tua applicazione mobile. + +## Come ottenere le tag su Android +{: android-get-tags} + +La API **getTags** restituisce l'elenco di + tag disponibili che il dispositivo può sottoscrivere. Una volta sottoscritto a una determinata tag, il dispositivo può ricevere {{site.data.keyword.mobilepushshort}} inviata per tale tag. + +Copia i seguenti frammenti di codice nella tua applicazione mobile Android per ottenere un elenco di tag sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili. + +Utilizza l'API **getTags** per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. + +``` +// Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } + }) +``` + {: codeblock} + +Utilizza la API **getSubscriptions** per ottenere un elenco delle tag sottoscritte dal dispositivo. + +``` +// Ottieni un elenco delle tag sottoscritte dal dispositivo. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Errore di ottenimento delle sottoscrizioni.. " + ex.getMessage()); + } +}) + ``` + {: codeblock} + +## Come ottenere le tag su Cordova +{: cordova-get-tags} + +Copia i seguenti frammenti di codice nella tua applicazione mobile per ottenere un elenco di tag sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili. + +Richiama un array delle tag disponibili per la sottoscrizione. + +``` +//Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo +BMSPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + +``` +//Ottieni un elenco di tag disponibili sottoscritte dal dispositivo. +BMSPush.retrieveSubscriptions(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + + +## Come ottenere le tag su Swift +{: swift-get-tags} + +La API **retrieveAvailableTagsWithCompletionHandler** restituisce l'elenco di + tag disponibili che il dispositivo può sottoscrivere. Una volta sottoscritto a una determinata tag, il dispositivo può ricevere {{site.data.keyword.mobilepushshort}} inviata per tale tag. + +Richiama {{site.data.keyword.mobilepushshort}} per ottenere le sottoscrizioni per una tag. + +Copia i seguenti frammenti di codice nella tua applicazione mobile Swift per ottenere un elenco delle tag disponibili sottoscritte dal dispositivo e per ottenere un elenco delle tag disponibili a cui può sottoscriversi il dispositivo. +``` +//Ottieni un elenco di tag disponibili a cui può sottoscriversi il dispositivo + push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + if error.isEmpty + { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else + { + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +``` +//Ottieni un elenco di tag disponibili sottoscritte dal dispositivo +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during retrieving subscribed tags : \(response?.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else + { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +## Google Chrome, Safari e Mozilla Firefox +{: web-get-tags} + +Per ottenere l'elenco delle tag disponibili, a cui possono sottoscriversi i clienti, utilizza il seguente codice. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + + +## Estensioni e applicazioni Google Chrome +{: web-get-tags} + +Per ottenere l'elenco delle tag disponibili, a cui possono sottoscriversi i clienti, utilizza il seguente codice. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + +Copia i seguenti frammenti di codice nelle tue estensioni e applicazioni Google Chrome per ottenere un elenco di tag a cui sono sottoscritti i clienti. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveSubscriptions(function(response) + { + alert(response.response) + }) +``` + {: codeblock} + + +# Sottoscrizione e annullamento di sottoscrizioni alle tag +{: #Subscribe_tags} + +Utilizza i seguenti frammenti di codice per consentire ai tuoi dispositivi di ottenere sottoscrizioni, sottoscriversi a una tag e annullare la sottoscrizione a una tag. + +## Sottoscrizione e annullamento di sottoscrizioni alle tag su Android +{: android-subscribe-tags} + +Copia e incolla questo frammento di codice nella tua applicazione mobile Android. + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } + }); +``` + {: codeblock} + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } + }); +``` + {: codeblock} + +## Sottoscrizione e annullamento di sottoscrizioni alle tag su Cordova +{: cordova-subscribe-tags} + +Copia e incolla questo frammento di codice nella tua applicazione mobile Cordova. + +``` +var tag = "YourTag"; +BMSPush.subscribe(tag, success, failure); +BMSPush.unsubscribe(tag, success, failure); +``` + {: codeblock} + + +## Sottoscrizione e annullamento di sottoscrizioni alle tag su Swift +{: swift-subscribe-tags} + +Copia e incolla questo frammento di codice nella tua applicazione mobile Swift. + +Utilizza la API **subscribeToTags** per sottoscrivere a una + tag. + +``` +push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print("Response when subscribing to tags: \(response?.description)") + print("Status code when subscribing to tags: \(statusCode)") + } else { + print("Error when subscribing to tags: \(error) ") + print("Error status code when subscribing to tags: \(statusCode)") + } +}) +``` + {: codeblock} + +Utilizza la API **unsubscribeFromTags** per annullare la sottoscrizione a una + tag. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during unsubscribed tags : \(response?.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + {: codeblock} + +## Google Chrome e Mozilla Firefox +{: web-subscribe-tags} + +Per sottoscriverti alle tag dalle applicazioni web, utilizza il seguente frammento di codice: + +``` +var tagsArray = ["tag1", "Tag2"] +bmsPush.subscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +Per annullare la sottoscrizione alle tag utilizza il metodo **unSubscribe**. + +``` +var tagsArray = ["tag1", "Tag2"] + bmsPush.unSubscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +# Utilizzo delle notifiche basate sulle tag +{: #using_tags} + +Le notifiche basate sulle tag sono messaggi destinati a tutti i dispositivi sottoscritti a una particolare tag. Ciascun dispositivo può essere sottoscritto a un qualsiasi numero di tag. Questo argomento descrive come inviare notifiche basate sulle tag. Le sottoscrizioni vengono gestite dall'istanza Bluemix del servizio {{site.data.keyword.mobilepushshort}}. Quando viene eliminata una tag, vengono eliminate anche tutte le informazioni associate con tale tag, inclusi i relativi sottoscrittori e dispositivi. Non è necessario un annullamento della sottoscrizione automatico per questa tag poiché non esiste più e non sono richieste ulteriori azioni dal lato client. + +Crea le tag sulla schermata **Tag**. Per informazioni su come creare le tag, vedi [Creazione di tag](t_manage_tags.html). + +1. Dal dashboard **Push Notification**, fai clic su **Send Notifications**. +1. Seleziona l'opzione **Device by Tag** nell'elenco a discesa **Send To**. +1. Cerca le tag che vuoi utilizzare e selezionale. +![Schermata notifiche](images/tag_notification.jpg) +1. Nel campo **Message Text**, immetti il testo che deve essere inviato come notifica ai destinatari sottoscritti. +1. Fai clic su **Send**. diff --git a/services/mobilepush/nl/it/t_manage_user.md b/services/mobilepush/nl/it/t_manage_user.md index 9ef1a9aad..3877eacf7 100755 --- a/services/mobilepush/nl/it/t_manage_user.md +++ b/services/mobilepush/nl/it/t_manage_user.md @@ -1,166 +1,166 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Registrazione di un dispositivo con l'ID utente -{: #register_device_with_userId} -Ultimo aggiornamento: 06 febbraio 2017 -{: .last-updated} - -Per registrare la notifica basate sull'ID utente, completa la seguente procedura: - -## Android -{: android-register} - -Inizializza la classe MFPPush con le chiavi `AppGUID` e `clientSecret` del servizio {{site.data.keyword.mobilepushshort}}. -``` -// Initialize the Push Notifications service -push = MFPPush.getInstance(); -push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); -``` - {: codeblock} - - -- **AppGUID**: questa è la chiave AppGUID del servizio {{site.data.keyword.mobilepushshort}}. -- **clientSecret**: questa è la chiave clientSecret del servizio {{site.data.keyword.mobilepushshort}}. - - Utilizza l'API **registerDeviceWithUserId** per registrare il dispositivo per {{site.data.keyword.mobilepushshort}}. - -``` -// Register the device to Push Notifications -push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - Log.d("Device is registered with Push Service.");} - @Override - public void onFailure(MFPPushException ex) { - Log.d("Error registering with Push Service...\n" - + "Push notifications will not be received."); - } - }); -``` - {: codeblock} - -- **userId**: passa il valore ID utente univoco per la registrazione per {{site.data.keyword.mobilepushshort}}. - -**Nota:** per abilitare le {{site.data.keyword.mobilepushshort}} indirizzate dall'ID utente, assicurati di aver registrato il dispositivo con un ID utente e inoltre di passare il 'clientSecret' assegnato quando viene eseguito il provisioning dei servizi {{site.data.keyword.mobilepushshort}}. La registrazione del dispositivo avrà esito negativo senza un clientSecret valido. - -## Cordova -{: cordova} - -Utilizza le seguenti API per registrare le {{site.data.keyword.mobilepushshort}} basate sull'ID utente. - -``` -// Register device for Push Notification with UserId -var options = {"userId": "Your User Id value"}; -BMSPush.registerDevice(options,success, failure); -``` - {: codeblock} - - -- **userId**: passa il valore ID utente univoco per la registrazione per {{site.data.keyword.mobilepushshort}}. - - -## Swift -{: swift-register} - -``` -// Inizializza BMSPushClient -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -- **AppGUID**: questa è la chiave AppGUID del servizio {{site.data.keyword.mobilepushshort}}. -- **clientSecret**: questa è la chiave clientSecret del servizio {{site.data.keyword.mobilepushshort}}. - -Utilizza l'API **registerWithUserId** per registrare il dispositivo per {{site.data.keyword.mobilepushshort}}. - -``` -// Register the device to Push Notifications service -push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in -if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } else { - print( "Error during device registration \(error) ") - } - } -``` - {: codeblock} - -- **userId**: passa il valore ID utente univoco per la registrazione per {{site.data.keyword.mobilepushshort}}. - -## Google Chrome, Safari e Mozilla Firefox -{: web-register} - -Utilizza le seguenti API per registrare le notifiche basate sull'ID utente. Inizializza l'SDK con `app GUID`, `app Region` e `Client Secret`. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -Dopo aver correttamente eseguito l'inizializzazione registra l'applicazione web con l'ID utente. - -``` -bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -## Estensioni e applicazioni Google Chrome -{: web-register-new} - -Utilizza le seguenti API per registrare le notifiche basate sull'ID utente. Inizializza l'SDK con `app GUID`, `app Region` e `Client Secret`. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -Dopo l'inizializzazione, devi registrare l'applicazione web con l'ID utente. - -``` -bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -# Utilizzo delle notifiche basate sull'ID utente -{: #using_userid} - -Le notifiche basate sull'ID utente sono messaggi di notifica destinati a uno specifico utente. Possono essere registrati con un utente molti dispositivi. I seguenti passi descrivono come inviare le notifiche basate sull'ID utente. - -1. Dal dashboard **Push Notification**, seleziona l'opzione **Send Notifications**. -1. Seleziona **UserId** nell'elenco delle opzioni **Send to**. -1. Nel campo **User Id**, cerca gli ID utente che vuoi utilizzare e fai quindi clic su **+Add**.![Schermata notifiche](images/user_notification.jpg) -1. Nel campo **Message**, immetti il testo che vuoi inviare nella tua notifica. -1. Fai clic su **Send**. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Registrazione di un dispositivo con l'ID utente +{: #register_device_with_userId} +Ultimo aggiornamento: 06 febbraio 2017 +{: .last-updated} + +Per registrare la notifica basate sull'ID utente, completa la seguente procedura: + +## Android +{: android-register} + +Inizializza la classe MFPPush con le chiavi `AppGUID` e `clientSecret` del servizio {{site.data.keyword.mobilepushshort}}. +``` +// Initialize the Push Notifications service +push = MFPPush.getInstance(); +push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); +``` + {: codeblock} + + +- **AppGUID**: questa è la chiave AppGUID del servizio {{site.data.keyword.mobilepushshort}}. +- **clientSecret**: questa è la chiave clientSecret del servizio {{site.data.keyword.mobilepushshort}}. + + Utilizza l'API **registerDeviceWithUserId** per registrare il dispositivo per {{site.data.keyword.mobilepushshort}}. + +``` +// Register the device to Push Notifications +push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + Log.d("Device is registered with Push Service.");} + @Override + public void onFailure(MFPPushException ex) { + Log.d("Error registering with Push Service...\n" + + "Push notifications will not be received."); + } + }); +``` + {: codeblock} + +- **userId**: passa il valore ID utente univoco per la registrazione per {{site.data.keyword.mobilepushshort}}. + +**Nota:** per abilitare le {{site.data.keyword.mobilepushshort}} indirizzate dall'ID utente, assicurati di aver registrato il dispositivo con un ID utente e inoltre di passare il 'clientSecret' assegnato quando viene eseguito il provisioning dei servizi {{site.data.keyword.mobilepushshort}}. La registrazione del dispositivo avrà esito negativo senza un clientSecret valido. + +## Cordova +{: cordova} + +Utilizza le seguenti API per registrare le {{site.data.keyword.mobilepushshort}} basate sull'ID utente. + +``` +// Register device for Push Notification with UserId +var options = {"userId": "Your User Id value"}; +BMSPush.registerDevice(options,success, failure); +``` + {: codeblock} + + +- **userId**: passa il valore ID utente univoco per la registrazione per {{site.data.keyword.mobilepushshort}}. + + +## Swift +{: swift-register} + +``` +// Inizializza BMSPushClient +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +- **AppGUID**: questa è la chiave AppGUID del servizio {{site.data.keyword.mobilepushshort}}. +- **clientSecret**: questa è la chiave clientSecret del servizio {{site.data.keyword.mobilepushshort}}. + +Utilizza l'API **registerWithUserId** per registrare il dispositivo per {{site.data.keyword.mobilepushshort}}. + +``` +// Register the device to Push Notifications service +push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in +if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } else { + print( "Error during device registration \(error) ") + } + } +``` + {: codeblock} + +- **userId**: passa il valore ID utente univoco per la registrazione per {{site.data.keyword.mobilepushshort}}. + +## Google Chrome, Safari e Mozilla Firefox +{: web-register} + +Utilizza le seguenti API per registrare le notifiche basate sull'ID utente. Inizializza l'SDK con `app GUID`, `app Region` e `Client Secret`. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +Dopo aver correttamente eseguito l'inizializzazione registra l'applicazione web con l'ID utente. + +``` +bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +## Estensioni e applicazioni Google Chrome +{: web-register-new} + +Utilizza le seguenti API per registrare le notifiche basate sull'ID utente. Inizializza l'SDK con `app GUID`, `app Region` e `Client Secret`. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +Dopo l'inizializzazione, devi registrare l'applicazione web con l'ID utente. + +``` +bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +# Utilizzo delle notifiche basate sull'ID utente +{: #using_userid} + +Le notifiche basate sull'ID utente sono messaggi di notifica destinati a uno specifico utente. Possono essere registrati con un utente molti dispositivi. I seguenti passi descrivono come inviare le notifiche basate sull'ID utente. + +1. Dal dashboard **Push Notification**, seleziona l'opzione **Send Notifications**. +1. Seleziona **UserId** nell'elenco delle opzioni **Send to**. +1. Nel campo **User Id**, cerca gli ID utente che vuoi utilizzare e fai quindi clic su **+Add**.![Schermata notifiche](images/user_notification.jpg) +1. Nel campo **Message**, immetti il testo che vuoi inviare nella tua notifica. +1. Fai clic su **Send**. diff --git a/services/mobilepush/nl/it/t_push_ios_nextsteps.md b/services/mobilepush/nl/it/t_push_ios_nextsteps.md index 5f263d336..bd8c03a62 100644 --- a/services/mobilepush/nl/it/t_push_ios_nextsteps.md +++ b/services/mobilepush/nl/it/t_push_ios_nextsteps.md @@ -1,22 +1,22 @@ - ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# Passi successivi - -{: #push-ios-nextsteps} - -Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche - basate sulle tag e le opzioni avanzate. - -Aggiungi queste funzioni del Servizio Push Notifications alla tua applicazione. - - - -- Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](t_push_tagsmain.md). -- Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche di push avanzate](t_advance_notifications.md). + +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# Passi successivi + +{: #push-ios-nextsteps} + +Dopo che hai correttamente configurato le notifiche di base, puoi configurare le notifiche + basate sulle tag e le opzioni avanzate. + +Aggiungi queste funzioni del Servizio Push Notifications alla tua applicazione. + + + +- Per utilizzare le notifiche basate sulle tag, vedi [Notifiche basate sulle tag](t_push_tagsmain.md). +- Per utilizzare le opzioni di notifica avanzate, vedi [Notifiche di push avanzate](t_advance_notifications.md). diff --git a/services/mobilepush/nl/it/t_push_monitoring.md b/services/mobilepush/nl/it/t_push_monitoring.md index d29cfb47c..b42725357 100644 --- a/services/mobilepush/nl/it/t_push_monitoring.md +++ b/services/mobilepush/nl/it/t_push_monitoring.md @@ -1,33 +1,33 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Monitoraggio di Push Notifications -{: #monitor-notifications} -Ultimo aggiornamento: 16 gennaio 2017 -{: .last-updated} - - -Il servizio IBM {{site.data.keyword.mobilepushshort}} ora estende le funzionalità di monitoraggio delle prestazioni di push generando dei grafici dai tuoi dati utente. Puoi utilizzare il programma di utilità per elencare tutte le notifiche di push inviate o tutti i dispositivi registrati e per analizzare le informazioni su base giornaliera, settimanale o mensile. - -Per generare dei report per tutte le tue notifiche inviate, utilizza il metodo GET report Push Messages nelle [API REST](https://mobile.{DomainName}/imfpush/){: new_window}. - -![Report Notifiche inviate](images/monitoring_messages.jpg) - - -Per generare dei report per tutti i tuoi dispositivi registrati, utilizza il metodo GET report Push Device Registrations nelle [API REST](https://mobile.{DomainName}/imfpush/){: new_window}. - -![Report Dispositivi registrati](images/monitoring_devices.jpg) - -Per informazioni su come aggiornare il tuo SDK Android SDK per monitorare le informazioni sulle notifiche, vedi [Monitoraggio di notifiche di push su dispositivi Android](c_android_enable.html#android_monitor). - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Monitoraggio di Push Notifications +{: #monitor-notifications} +Ultimo aggiornamento: 16 gennaio 2017 +{: .last-updated} + + +Il servizio IBM {{site.data.keyword.mobilepushshort}} ora estende le funzionalità di monitoraggio delle prestazioni di push generando dei grafici dai tuoi dati utente. Puoi utilizzare il programma di utilità per elencare tutte le notifiche di push inviate o tutti i dispositivi registrati e per analizzare le informazioni su base giornaliera, settimanale o mensile. + +Per generare dei report per tutte le tue notifiche inviate, utilizza il metodo GET report Push Messages nelle [API REST](https://mobile.{DomainName}/imfpush/){: new_window}. + +![Report Notifiche inviate](images/monitoring_messages.jpg) + + +Per generare dei report per tutti i tuoi dispositivi registrati, utilizza il metodo GET report Push Device Registrations nelle [API REST](https://mobile.{DomainName}/imfpush/){: new_window}. + +![Report Dispositivi registrati](images/monitoring_devices.jpg) + +Per informazioni su come aggiornare il tuo SDK Android SDK per monitorare le informazioni sulle notifiche, vedi [Monitoraggio di notifiche di push su dispositivi Android](c_android_enable.html#android_monitor). + + + diff --git a/services/mobilepush/nl/it/t_push_provider_android.md b/services/mobilepush/nl/it/t_push_provider_android.md index 786966d4d..9225b80b1 100755 --- a/services/mobilepush/nl/it/t_push_provider_android.md +++ b/services/mobilepush/nl/it/t_push_provider_android.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configurazione delle credenziali per FCM -{: #create-push-enable-gcm} -Ultimo aggiornamento: 16 gennaio 2017 -{: .last-updated} - -FCM (Firebase Cloud Messaging) è il gateway utilizzato per consegnare le notifiche di push ai dispositivi Android e a Google Chrome. FCM è la nuova versione di GCM (Google Cloud Messaging). Per configurare il servizio {{site.data.keyword.mobilepushshort}} sul dashboard, devi ottenere le tue credenziali FCM. Assicurati di utilizzare le configurazioni FCM per le nuove applicazioni. Le applicazioni esistenti continueranno a funzionare con le configurazioni GCM. - -##Come ottenere il tuo ID mittente e la chiave API -{: #android-senderid-apikey} - -La chiave API è archiviata in modo protetto e utilizzata dal servizio {{site.data.keyword.mobilepushshort}} per stabilire una connessione al server FCM e l'ID mittente (numero progetto) viene utilizzato dall'SDK Android e dall'SDK JS per Google Chrome e Mozilla Firefox sul lato client. - -Per configurare FCM, generare la chiave API e l'ID mittente, completa la seguente procedura: - -1. Visita il sito [Firebase Console ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://console.firebase.google.com/?pli=1 "Icona link esterno"){: new_window}. -2. Seleziona **Create new project**. -3. Nella finestra Create a project, fornisci un nome progetto, scegli una regione/paese e fai clic su **Create project**. -3. Nel pannello di navigazione, fai clic sull'icona delle impostazioni e seleziona **Project settings**. -4. Scegli la scheda Cloud Messaging per generare la chiave API server e un ID mittente. - -##Configurazione del servizio {{site.data.keyword.mobilepushshort}} per Android e per le estensioni e le applicazioni Chrome -{: #setup-push-android} - -**Nota:** ti serviranno i tuoi chiave API FCM/GCM e ID mittente (numero progetto). - -1. Apri il tuo dashboard Bluemix e fai quindi clic sull'istanza del servizio {{site.data.keyword.mobilepushfull}} che hai creato, per aprire il dashboard. Viene visualizzato il dashboard Push. Per configurare un servizio {{site.data.keyword.mobilepushshort}} senza binding per Android, selezione l'icona del servizio {{site.data.keyword.mobilepushshort}} senza binding per aprire il dashboard del servizio {{site.data.keyword.mobilepushshort}}. - -![Dashboard Push](images/push_unbound.jpg) - -2. Fai clic sul pulsante **Setup Push** per configurare le credenziali FCM/GCM per le applicazioni Android e per le estensioni e applicazioni Google Chrome. -3. Nella pagina **Configuration**, per Android, vai alla scheda **Mobile** e configura l'ID mittente (numero progetto GCM) e la chiave API. Per le estensioni e applicazioni Google Chrome, vai alla scheda **Web** e configura l'ID mittente (numero progetto FCM/GCM) e la chiave API in modo appropriato. -4. Fai clic su **Save**. -5. Fasi successive. [Abilitazione delle notifiche per Android](c_enable_push.html) o [Abilitazione delle notifiche per le estensioni & applicazioni Google Chrome](c_enable_push.html). - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configurazione delle credenziali per FCM +{: #create-push-enable-gcm} +Ultimo aggiornamento: 16 gennaio 2017 +{: .last-updated} + +FCM (Firebase Cloud Messaging) è il gateway utilizzato per consegnare le notifiche di push ai dispositivi Android e a Google Chrome. FCM è la nuova versione di GCM (Google Cloud Messaging). Per configurare il servizio {{site.data.keyword.mobilepushshort}} sul dashboard, devi ottenere le tue credenziali FCM. Assicurati di utilizzare le configurazioni FCM per le nuove applicazioni. Le applicazioni esistenti continueranno a funzionare con le configurazioni GCM. + +##Come ottenere il tuo ID mittente e la chiave API +{: #android-senderid-apikey} + +La chiave API è archiviata in modo protetto e utilizzata dal servizio {{site.data.keyword.mobilepushshort}} per stabilire una connessione al server FCM e l'ID mittente (numero progetto) viene utilizzato dall'SDK Android e dall'SDK JS per Google Chrome e Mozilla Firefox sul lato client. + +Per configurare FCM, generare la chiave API e l'ID mittente, completa la seguente procedura: + +1. Visita il sito [Firebase Console ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://console.firebase.google.com/?pli=1 "Icona link esterno"){: new_window}. +2. Seleziona **Create new project**. +3. Nella finestra Create a project, fornisci un nome progetto, scegli una regione/paese e fai clic su **Create project**. +3. Nel pannello di navigazione, fai clic sull'icona delle impostazioni e seleziona **Project settings**. +4. Scegli la scheda Cloud Messaging per generare la chiave API server e un ID mittente. + +##Configurazione del servizio {{site.data.keyword.mobilepushshort}} per Android e per le estensioni e le applicazioni Chrome +{: #setup-push-android} + +**Nota:** ti serviranno i tuoi chiave API FCM/GCM e ID mittente (numero progetto). + +1. Apri il tuo dashboard Bluemix e fai quindi clic sull'istanza del servizio {{site.data.keyword.mobilepushfull}} che hai creato, per aprire il dashboard. Viene visualizzato il dashboard Push. Per configurare un servizio {{site.data.keyword.mobilepushshort}} senza binding per Android, selezione l'icona del servizio {{site.data.keyword.mobilepushshort}} senza binding per aprire il dashboard del servizio {{site.data.keyword.mobilepushshort}}. + +![Dashboard Push](images/push_unbound.jpg) + +2. Fai clic sul pulsante **Setup Push** per configurare le credenziali FCM/GCM per le applicazioni Android e per le estensioni e applicazioni Google Chrome. +3. Nella pagina **Configuration**, per Android, vai alla scheda **Mobile** e configura l'ID mittente (numero progetto GCM) e la chiave API. Per le estensioni e applicazioni Google Chrome, vai alla scheda **Web** e configura l'ID mittente (numero progetto FCM/GCM) e la chiave API in modo appropriato. +4. Fai clic su **Save**. +5. Fasi successive. [Abilitazione delle notifiche per Android](c_enable_push.html) o [Abilitazione delle notifiche per le estensioni & applicazioni Google Chrome](c_enable_push.html). + + diff --git a/services/mobilepush/nl/it/t_push_provider_ios.md b/services/mobilepush/nl/it/t_push_provider_ios.md index 5999484af..1c51bc920 100755 --- a/services/mobilepush/nl/it/t_push_provider_ios.md +++ b/services/mobilepush/nl/it/t_push_provider_ios.md @@ -1,166 +1,166 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configurazione delle credenziali per APNs -{: #create-push-credentials-apns} -Ultimo aggiornamento: 16 gennaio 2017 -{: .last-updated} - -Il servizio APNS (Apple Push Notification Service) consente agli sviluppatori dell'applicazione di inviare notifiche remote dall'istanza del servizio {{site.data.keyword.mobilepushshort}} su Bluemix (il provider) alle applicazioni e ai dispositivi iOS. I messaggi sono inviati a un'applicazione di destinazione sul dispositivo. - -Ottieni e - configura le tue credenziali APNS. I certificati APNS sono gestiti in modo sicuro dal servizio {{site.data.keyword.mobilepushshort}} e utilizzati per stabilire una connessione al server APNs come un provider. - - - - - - -##Registrazione di un ID applicazione -{: #create-push-credentials-apns-register} - - -L'ID applicazione (l'identificativo del bundle) è un identificativo univoco che identifica una specifica - applicazione. Ogni applicazione richiede un ID applicazione. I servizi come {{site.data.keyword.mobilepushshort}} sono configurati sull'ID applicazione. - -1. Assicurati di disporre di un account [Apple Developers ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com/ "Icona link esterno"){: new_window}. -2. Vai al portale [Apple Developer ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com "Icona link esterno"){: new_window}, fai clic su **Member Center** e seleziona **Certificates, Identifiers & Profiles**. -3. Vai alla sezione **Registering App IDs** nella [Apple Developer Library ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991 "Icona link esterno"){: new_window} e attieniti alle istruzioni per registrare l'ID applicazione. - -Quando registri un ID applicazione, seleziona le seguenti opzioni: - -* Push Notifications -![Servizi di applicazione](images/appID_appservices_enablepush.jpg) -* Explicit ID Suffix -![Explicit ID](images/appID_bundleID.jpg) -4. Crea un certificato SSL di APNS di sviluppo e distribuzione. - -##Crea un certificato SSL di APNS di sviluppo e distribuzione -{: #create-push-credentials-apns-ssl} - -Prima di ottenere un certificato APNs, devi generare una CSR (certificate signing request) e inoltrarla ad Apple, l'autorità di certificazione (CA). La CSR contiene informazioni che identificano la tua società e la tua chiave pubblica e privata che usi per firmare le tue notifiche di push Apple. Genera quindi il certificato SSL - nel portale per sviluppatori iOS. Il certificato, insieme alla sua chiave pubblica e a quella privata, - viene archiviato in Keychain Access. - - - - - - -Puoi utilizzare le APNs in due modi: - -* Modalità sandbox per lo sviluppo e il test. -* Modalità produzione quando si distribuiscono le applicazioni tramite l'App Store (o altri meccanismi di distribuzione aziendali). - -Devi ottenere dei certificati separati per gli ambienti di sviluppo e - distribuzione. I certificati sono associati a un ID applicazione per l'applicazione - destinataria delle notifiche remote. per la produzione, è possibile creare fino a - due certificati. Bluemix utilizza i certificati per stabilire una connessione SSL - con APNS. - - - -1. Vai al sito web [Apple Developer ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com "Icona link esterno"){: new_window}, fai clic su **Member Center** e seleziona **Certificates, Identifiers & Profiles**. -2. Nell'area **Identifiers**, fai clic su **App - IDs**. -3. Dall'elenco di ID applicazione, seleziona il tuo ID applicazione e seleziona quindi **Settings**. -4. Nell'area **Push Notifications**, crea un certificato SSL di sviluppo e quindi - un certificato SSL di produzione. - - ![Certificati SSL Push Notification](images/certificate_createssl.jpg) - -5. Quando viene visualizzata la **schermata About Creating a Certificate Signing Request (CSR)**, avvia l'applicazione **Keychain Access** nel tuo Mac per creare una CSR (Certificate Signing Request). -6. Dal menu, seleziona **Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority…** -7. In **Certificate Information**, immetti l'indirizzo email che è associato al tuo account di sviluppatore di applicazioni e un nome comune. Fornisci un nome significativo che ti aiuta a identificare se si tratta di un certificato per lo sviluppo (sandbox) o la distribuzione (produzione); ad esempio, *sandbox-apns-certificate* o *production-apns-certificate*. -8. Seleziona **Save to disk** per scaricare il file `.certSigningRequest` sul tuo desktop e fai quindi clic su **Continue**. -9. Nell'opzione del menu **Save As**, denomina il file `.certSigningRequest` e fai clic su **Save**. -10. Fai clic su **Done**. Ora hai una CSR. -11. Ritorna nella finestra **About Creating a Certificate Siging Request (CSR)** e fai clic su **Continue**. -12. Dalla schermata **Generate**, fai clic su **Choose - File ... **e seleziona il file CSR che avevi salvato sul tuo - desktop. Fai quindi clic su **Generate**. - ![Genera certificato](images/generate_certificate.jpg) -13. Quando il tuo certificato è pronto, fai clic su **Done**. -14. Sulla schermata **Push Notifications**, fai clic su **Download** per scaricare il tuo certificato e fai quindi clic su **Done**. - ![Scarica certificato](images/certificate_download.jpg) -15. Sul tuo Mac, vai a **Keychain Access > My Certificates**, e individua il certificato appena installato. Fai doppio clic sul certificato per installarlo in Keychain Access. -16. Seleziona il certificato (certificate) e la chiave privata (private key) e seleziona quindi **Export** per convertire il certificato nel formato Personal Information Exchange (formato `.p12`). - ![Esporta certificato e chiavi](images/keychain_export_key.jpg) -17. Nel campo **Save As**, dai al certificato un nome significativo. Ad esempio, `sandbox_apns.p12_certifcate` o `production_apns.p12` e fai quindi clic su **Save**. - ![Esporta certificato e chiavi](images/certificate_p12v2.jpg) -18. Nel campo **Enter a password**, immetti una password per proteggere gli elementi esportati e fai quindi clic su **OK**. Puoi utilizzare questa password per configurare le tue impostazioni APNS sul dashboard Push.{: #step18} - ![Esporta certificato e chiavi](images/export_p12.jpg) -19. **Key Access.app** ti chiede di esportare la tua chiave dalla schermata **Keychain**. Immetti la tua password amministrativa per il tuo Mac per consentire al tuo sistema di esportare questi elementi e seleziona quindi l'opzione **Always Allow**. Sul tuo desktop viene generato un certificato `.p12`. - - -##Creazione di profilo di provisioning di sviluppo -{: #create-push-credentials-dev-profile} - -Il profilo di provisioning utilizza l'ID applicazione per determinare quali sono - i dispositivi su cui può essere installata ed eseguita la tua applicazione e quali sono - i servizi a cui la tua applicazione può accedere. Per ogni ID applicazione, crei - due profili di provisioning: uno per lo sviluppo e l'altro per la distribuzione. Xcode utilizza il profilo di provisioning di sviluppo per determinare quali sono - gli sviluppatori a cui è consentito creare l'applicazione e quali sono i dispositivi - di cui è consentita l'esecuzione di test sull'applicazione. - -Assicurati di aver registrato un ID applicazione, di averlo abilitato per il servizio {{site.data.keyword.mobilepushshort}} e di averlo configurato per utilizzare un certificato SSL APNs di sviluppo e produzione. - -Crea un profilo di provisioning di sviluppo nel seguente modo: - -1. Vai al portale [Apple Developer ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com "Icona link esterno"){: new_window}, fai clic su **Member Center** e seleziona **Certificates, Identifiers & Profiles**. -2. Vai alla [Mac Developer Library ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site "Icona link esterno"){: new_window}, scorri fino alla sezione **Creating Development Provisioning Profiles** e attieniti alle istruzioni per creare un profilo di sviluppo. -**Nota**: quando configuri un profilo di provisioning di sviluppo, seleziona le seguenti opzioni: - * **iOS App Development** - * **For iOS and watchOS apps ** - - - -##Creazione di un profilo di provisioning di distribuzione di archivio -{: #create-push-credentials-apns-distribute_profile} - -Utilizza il profilo di provisioning di archivio per inoltrare la tua applicazione per la distribuzione all'App Store. - -1. Vai al portale [Apple Developer ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com "Icona link esterno"){: new_window}, fai clic su **Member Center** e seleziona **Certificates, Identifiers & Profiles**. -2. Fai doppio clic sul file di provisioning scaricato per installarlo in Xcode. - -##Configurazione APNs sul dashboard {{site.data.keyword.mobilepushshort}} -{: #create-push-credentials-apns-dashboard} - -Per utilizzare il servizio {{site.data.keyword.mobilepushshort}} per inviare notifiche, carica i certificati SSL richiesti per APNS (Apple Push Notification Service). Puoi inoltre utilizzare l'API REST per caricare un certificato APNS. - - - -I certificati richiesti per APNs sono i certificati `.p12`. Questi certificati contengono i certificati di chiave privata e SSL richiesti per creare e pubblicare la tua applicazione. Devi generare i certificati dal Member Center del sito Web Apple - Developer (per il quale è richiesto un account Apple Developer - valido). Sono richiesti dei certificati separati per l'ambiente di sviluppo (sandbox) e - l'ambiente di produzione (distribuzione). - -**Nota**: dopo che il file `.cer` è presente nel tuo accesso alla catena di chiavi, eseguine l'esportazione sul tuo computer per creare un certificato `.p12`. - -Per ulteriori informazioni sull'utilizzo di APNS, vedi [iOS Developer Library: Local and Push Notification Programming Guide ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4 "Icona link esterno"){: new_window}. - -Per configurare APNS sul dashboard dei servizi Push Notification, completa la procedura: - -1. Seleziona **Configure** nel dashboard dei servizi Push Notification. -2. Scegli l'opzione **Mobile** per aggiornare le informazioni nel formato **APNs Push Credentials**. -3. Seleziona **Sandbox** (sviluppo) o **Production** (distribuzione) come appropriato e e quindi carica il certificato `p.12` che hai creato utilizzando il precedente [passo](#step18). - ![Imposta dashboard push notifications](images/wizard.jpg) -3. Nel campo **Password**, immetti la password associata al file di certificato `.p12` e quindi fai clic su **Save**. - -Dopo che i certificati sono - stati caricati correttamente con una password valida, puoi iniziare a inviare notifiche. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configurazione delle credenziali per APNs +{: #create-push-credentials-apns} +Ultimo aggiornamento: 16 gennaio 2017 +{: .last-updated} + +Il servizio APNS (Apple Push Notification Service) consente agli sviluppatori dell'applicazione di inviare notifiche remote dall'istanza del servizio {{site.data.keyword.mobilepushshort}} su Bluemix (il provider) alle applicazioni e ai dispositivi iOS. I messaggi sono inviati a un'applicazione di destinazione sul dispositivo. + +Ottieni e + configura le tue credenziali APNS. I certificati APNS sono gestiti in modo sicuro dal servizio {{site.data.keyword.mobilepushshort}} e utilizzati per stabilire una connessione al server APNs come un provider. + + + + + + +##Registrazione di un ID applicazione +{: #create-push-credentials-apns-register} + + +L'ID applicazione (l'identificativo del bundle) è un identificativo univoco che identifica una specifica + applicazione. Ogni applicazione richiede un ID applicazione. I servizi come {{site.data.keyword.mobilepushshort}} sono configurati sull'ID applicazione. + +1. Assicurati di disporre di un account [Apple Developers ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com/ "Icona link esterno"){: new_window}. +2. Vai al portale [Apple Developer ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com "Icona link esterno"){: new_window}, fai clic su **Member Center** e seleziona **Certificates, Identifiers & Profiles**. +3. Vai alla sezione **Registering App IDs** nella [Apple Developer Library ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991 "Icona link esterno"){: new_window} e attieniti alle istruzioni per registrare l'ID applicazione. + +Quando registri un ID applicazione, seleziona le seguenti opzioni: + +* Push Notifications +![Servizi di applicazione](images/appID_appservices_enablepush.jpg) +* Explicit ID Suffix +![Explicit ID](images/appID_bundleID.jpg) +4. Crea un certificato SSL di APNS di sviluppo e distribuzione. + +##Crea un certificato SSL di APNS di sviluppo e distribuzione +{: #create-push-credentials-apns-ssl} + +Prima di ottenere un certificato APNs, devi generare una CSR (certificate signing request) e inoltrarla ad Apple, l'autorità di certificazione (CA). La CSR contiene informazioni che identificano la tua società e la tua chiave pubblica e privata che usi per firmare le tue notifiche di push Apple. Genera quindi il certificato SSL + nel portale per sviluppatori iOS. Il certificato, insieme alla sua chiave pubblica e a quella privata, + viene archiviato in Keychain Access. + + + + + + +Puoi utilizzare le APNs in due modi: + +* Modalità sandbox per lo sviluppo e il test. +* Modalità produzione quando si distribuiscono le applicazioni tramite l'App Store (o altri meccanismi di distribuzione aziendali). + +Devi ottenere dei certificati separati per gli ambienti di sviluppo e + distribuzione. I certificati sono associati a un ID applicazione per l'applicazione + destinataria delle notifiche remote. per la produzione, è possibile creare fino a + due certificati. Bluemix utilizza i certificati per stabilire una connessione SSL + con APNS. + + + +1. Vai al sito web [Apple Developer ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com "Icona link esterno"){: new_window}, fai clic su **Member Center** e seleziona **Certificates, Identifiers & Profiles**. +2. Nell'area **Identifiers**, fai clic su **App + IDs**. +3. Dall'elenco di ID applicazione, seleziona il tuo ID applicazione e seleziona quindi **Settings**. +4. Nell'area **Push Notifications**, crea un certificato SSL di sviluppo e quindi + un certificato SSL di produzione. + + ![Certificati SSL Push Notification](images/certificate_createssl.jpg) + +5. Quando viene visualizzata la **schermata About Creating a Certificate Signing Request (CSR)**, avvia l'applicazione **Keychain Access** nel tuo Mac per creare una CSR (Certificate Signing Request). +6. Dal menu, seleziona **Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority…** +7. In **Certificate Information**, immetti l'indirizzo email che è associato al tuo account di sviluppatore di applicazioni e un nome comune. Fornisci un nome significativo che ti aiuta a identificare se si tratta di un certificato per lo sviluppo (sandbox) o la distribuzione (produzione); ad esempio, *sandbox-apns-certificate* o *production-apns-certificate*. +8. Seleziona **Save to disk** per scaricare il file `.certSigningRequest` sul tuo desktop e fai quindi clic su **Continue**. +9. Nell'opzione del menu **Save As**, denomina il file `.certSigningRequest` e fai clic su **Save**. +10. Fai clic su **Done**. Ora hai una CSR. +11. Ritorna nella finestra **About Creating a Certificate Siging Request (CSR)** e fai clic su **Continue**. +12. Dalla schermata **Generate**, fai clic su **Choose + File ... **e seleziona il file CSR che avevi salvato sul tuo + desktop. Fai quindi clic su **Generate**. + ![Genera certificato](images/generate_certificate.jpg) +13. Quando il tuo certificato è pronto, fai clic su **Done**. +14. Sulla schermata **Push Notifications**, fai clic su **Download** per scaricare il tuo certificato e fai quindi clic su **Done**. + ![Scarica certificato](images/certificate_download.jpg) +15. Sul tuo Mac, vai a **Keychain Access > My Certificates**, e individua il certificato appena installato. Fai doppio clic sul certificato per installarlo in Keychain Access. +16. Seleziona il certificato (certificate) e la chiave privata (private key) e seleziona quindi **Export** per convertire il certificato nel formato Personal Information Exchange (formato `.p12`). + ![Esporta certificato e chiavi](images/keychain_export_key.jpg) +17. Nel campo **Save As**, dai al certificato un nome significativo. Ad esempio, `sandbox_apns.p12_certifcate` o `production_apns.p12` e fai quindi clic su **Save**. + ![Esporta certificato e chiavi](images/certificate_p12v2.jpg) +18. Nel campo **Enter a password**, immetti una password per proteggere gli elementi esportati e fai quindi clic su **OK**. Puoi utilizzare questa password per configurare le tue impostazioni APNS sul dashboard Push.{: #step18} + ![Esporta certificato e chiavi](images/export_p12.jpg) +19. **Key Access.app** ti chiede di esportare la tua chiave dalla schermata **Keychain**. Immetti la tua password amministrativa per il tuo Mac per consentire al tuo sistema di esportare questi elementi e seleziona quindi l'opzione **Always Allow**. Sul tuo desktop viene generato un certificato `.p12`. + + +##Creazione di profilo di provisioning di sviluppo +{: #create-push-credentials-dev-profile} + +Il profilo di provisioning utilizza l'ID applicazione per determinare quali sono + i dispositivi su cui può essere installata ed eseguita la tua applicazione e quali sono + i servizi a cui la tua applicazione può accedere. Per ogni ID applicazione, crei + due profili di provisioning: uno per lo sviluppo e l'altro per la distribuzione. Xcode utilizza il profilo di provisioning di sviluppo per determinare quali sono + gli sviluppatori a cui è consentito creare l'applicazione e quali sono i dispositivi + di cui è consentita l'esecuzione di test sull'applicazione. + +Assicurati di aver registrato un ID applicazione, di averlo abilitato per il servizio {{site.data.keyword.mobilepushshort}} e di averlo configurato per utilizzare un certificato SSL APNs di sviluppo e produzione. + +Crea un profilo di provisioning di sviluppo nel seguente modo: + +1. Vai al portale [Apple Developer ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com "Icona link esterno"){: new_window}, fai clic su **Member Center** e seleziona **Certificates, Identifiers & Profiles**. +2. Vai alla [Mac Developer Library ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site "Icona link esterno"){: new_window}, scorri fino alla sezione **Creating Development Provisioning Profiles** e attieniti alle istruzioni per creare un profilo di sviluppo. +**Nota**: quando configuri un profilo di provisioning di sviluppo, seleziona le seguenti opzioni: + * **iOS App Development** + * **For iOS and watchOS apps ** + + + +##Creazione di un profilo di provisioning di distribuzione di archivio +{: #create-push-credentials-apns-distribute_profile} + +Utilizza il profilo di provisioning di archivio per inoltrare la tua applicazione per la distribuzione all'App Store. + +1. Vai al portale [Apple Developer ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com "Icona link esterno"){: new_window}, fai clic su **Member Center** e seleziona **Certificates, Identifiers & Profiles**. +2. Fai doppio clic sul file di provisioning scaricato per installarlo in Xcode. + +##Configurazione APNs sul dashboard {{site.data.keyword.mobilepushshort}} +{: #create-push-credentials-apns-dashboard} + +Per utilizzare il servizio {{site.data.keyword.mobilepushshort}} per inviare notifiche, carica i certificati SSL richiesti per APNS (Apple Push Notification Service). Puoi inoltre utilizzare l'API REST per caricare un certificato APNS. + + + +I certificati richiesti per APNs sono i certificati `.p12`. Questi certificati contengono i certificati di chiave privata e SSL richiesti per creare e pubblicare la tua applicazione. Devi generare i certificati dal Member Center del sito Web Apple + Developer (per il quale è richiesto un account Apple Developer + valido). Sono richiesti dei certificati separati per l'ambiente di sviluppo (sandbox) e + l'ambiente di produzione (distribuzione). + +**Nota**: dopo che il file `.cer` è presente nel tuo accesso alla catena di chiavi, eseguine l'esportazione sul tuo computer per creare un certificato `.p12`. + +Per ulteriori informazioni sull'utilizzo di APNS, vedi [iOS Developer Library: Local and Push Notification Programming Guide ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4 "Icona link esterno"){: new_window}. + +Per configurare APNS sul dashboard dei servizi Push Notification, completa la procedura: + +1. Seleziona **Configure** nel dashboard dei servizi Push Notification. +2. Scegli l'opzione **Mobile** per aggiornare le informazioni nel formato **APNs Push Credentials**. +3. Seleziona **Sandbox** (sviluppo) o **Production** (distribuzione) come appropriato e e quindi carica il certificato `p.12` che hai creato utilizzando il precedente [passo](#step18). + ![Imposta dashboard push notifications](images/wizard.jpg) +3. Nel campo **Password**, immetti la password associata al file di certificato `.p12` e quindi fai clic su **Save**. + +Dopo che i certificati sono + stati caricati correttamente con una password valida, puoi iniziare a inviare notifiche. diff --git a/services/mobilepush/nl/it/t_push_provider_safari.md b/services/mobilepush/nl/it/t_push_provider_safari.md index 2d78aace8..0ba9e3466 100644 --- a/services/mobilepush/nl/it/t_push_provider_safari.md +++ b/services/mobilepush/nl/it/t_push_provider_safari.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configurazione delle credenziali per i browser Web -{: #configure-credential-for-browsers} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - -Il servizio IBM {{site.data.keyword.mobilepushshort}} ora estende le funzionalità per inviare le notifiche al tuo browser. - -L'URL o il nome dominio del tuo sito Web è richiesto dal servizio {{site.data.keyword.mobilepushshort}} per identificare le richieste che devono essere consentite. Un'istanza del servizio {{site.data.keyword.mobilepushshort}} supporta un solo nome dominio alla volta. Pertanto, assicurati che sia impostato lo stesso valore per Chrome, Firefox e Safari. - -I browser Chrome e Safari richiedono una configurazione aggiuntiva per il push web. Avrai bisogno di una chiave API FCM in quanto viene utilizzato un endpoint FCM per consegnare i messaggi in Chrome. Per ottenere la tua chiave API FCM, vedi [Configurazione delle credenziali per FCM](t_push_provider_android.html). - - - -##Configurazione del push web per Chrome e Firefox -{: #config-chrome-firefox} - -1. Nel pannello del dashboard Push, seleziona **Configure**. -2. Seleziona la scheda Web. - ![Configurazioni push web](images/webpush_configure.jpg) -3. Configura la chiave API FCM/GCM e l'URL del tuo sito web che sarà registrato per ricevere le notifiche push. -4. Fai clic su **Save**. -5. Fasi successive. [Abilitazione delle notifiche per i browser Google Chrome e Mozilla Firefox](c_enable_push.html). - - -## Configurazione del push web per Safari -{: #configure-safari} - -La versione supportata per il servizio {{site.data.keyword.mobilepushshort}} su Safari è la 10.0. Prima di poter configurare il tuo browser per la ricezione delle notifiche, devi generare un certificato tramite il tuo account Apple Developer. - -### Generazione di un certificato -{: #certificate-generation} - -Assicurati di disporre in un account Apple Developer. Hai bisogno di registrare un ID push sito web e generare un certificato per configurare il tuo browser Safari per ricevere le notifiche. La seguente procedura ti aiuterà ad iniziare. - -1. Nel Apple Developer Member center, fai clic su **Certificates, ID & Profiles**. -2. Fai clic su **Identifiers** e quindi su **Website Push IDs**. -3. Scegli di creare una nuova voce selezionando l'icona più. - ![Dashboard Push](images/safari_1.jpg) - -4. Nel pannello Register Website Push ID, fornisci un ID identificativo e una descrizione Website Push ID appropriati. Ti raccomandiamo che sia nel formato del nome a dominio inverso, e che inizi con 'web'. Ad esempio: web.com.example.dailyweatherreports. -5. Registra l'ID push sito web. Ora hai un ID push sito web. -6. Seleziona **Edit** per creare un certificato da utilizzare per l'ID push sito web. -7. Nella finestra Certificate Assistant per Certificate Information, fornisci il tuo indirizzo email e un nome comune. Lascia l'indirizzo email Certificate Authority vuoto. -8. Fai clic su **Save to disk** e seleziona **Continue**. -9. Scegli di salvare il certificato in una cartella appropriata. -10. Scegli il `.certSigningRequest` creato sul disco quando ti viene richiesto nella procedura guidata di creazione del certificato. Assicurati di scaricare il certificato di push sito web creato nel formato `.cer`. -11. Apri il certificato nello strumento KeyChain Access. Fai clic con il tasto destro del mouse ed esportalo come certificato p12. Annota la password fornita durante la generazione del certificato p12. - - -### Configurazione per le notifiche - {: #configuration-notification} - -Dopo aver generato il certificato, puoi configurare il servizio per l'invio di notifiche a Safari. - -Completa la procedura: - -1. Nel dashboard del servizio Push Notifications, fai clic su **Configure**. -2. Seleziona la scheda Web. -3. Nella sezione Safari Push, aggiorna il modulo con le informazioni richieste. - - **Website Name**: il nome che hai fornito nel centro di notifica. - - **Website Push ID**: aggiorna con la stringa reverse-domain per il tuo ID push sito web. Ad esempio, web.com.example.www. - - **Website URL**: fornisci l'URL del sito web da sottoscrivere alle notifiche di push. Ad esempio, https://www.example.com. - - **Allowed Domains**: parametro facoltativo. Indica l'elenco di siti web che richiedono l'autorizzazione dall'utente. Assicurati che gli URL siano valori separati da virgola. Se non si fornisce questo valore, verrà utilizzato quello specificato in Website URL. - - **URL Format String**: l'URL da risolvere quando si fa clic sulla notifica. Ad esempio, ["https://www.example.com"]. Assicurati che l'URL utilizzi lo schema http o https. - - **Safari web push certificate**: carica il certificato .p12 e fornisci la password. -4. Fai clic su **Save**. - -![Dashboard Push](images/push_configure_safari.jpg) - -Il servizio è ora configurato per l'invio di notifiche di push al browser Safari. - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configurazione delle credenziali per i browser Web +{: #configure-credential-for-browsers} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + +Il servizio IBM {{site.data.keyword.mobilepushshort}} ora estende le funzionalità per inviare le notifiche al tuo browser. + +L'URL o il nome dominio del tuo sito Web è richiesto dal servizio {{site.data.keyword.mobilepushshort}} per identificare le richieste che devono essere consentite. Un'istanza del servizio {{site.data.keyword.mobilepushshort}} supporta un solo nome dominio alla volta. Pertanto, assicurati che sia impostato lo stesso valore per Chrome, Firefox e Safari. + +I browser Chrome e Safari richiedono una configurazione aggiuntiva per il push web. Avrai bisogno di una chiave API FCM in quanto viene utilizzato un endpoint FCM per consegnare i messaggi in Chrome. Per ottenere la tua chiave API FCM, vedi [Configurazione delle credenziali per FCM](t_push_provider_android.html). + + + +##Configurazione del push web per Chrome e Firefox +{: #config-chrome-firefox} + +1. Nel pannello del dashboard Push, seleziona **Configure**. +2. Seleziona la scheda Web. + ![Configurazioni push web](images/webpush_configure.jpg) +3. Configura la chiave API FCM/GCM e l'URL del tuo sito web che sarà registrato per ricevere le notifiche push. +4. Fai clic su **Save**. +5. Fasi successive. [Abilitazione delle notifiche per i browser Google Chrome e Mozilla Firefox](c_enable_push.html). + + +## Configurazione del push web per Safari +{: #configure-safari} + +La versione supportata per il servizio {{site.data.keyword.mobilepushshort}} su Safari è la 10.0. Prima di poter configurare il tuo browser per la ricezione delle notifiche, devi generare un certificato tramite il tuo account Apple Developer. + +### Generazione di un certificato +{: #certificate-generation} + +Assicurati di disporre in un account Apple Developer. Hai bisogno di registrare un ID push sito web e generare un certificato per configurare il tuo browser Safari per ricevere le notifiche. La seguente procedura ti aiuterà ad iniziare. + +1. Nel Apple Developer Member center, fai clic su **Certificates, ID & Profiles**. +2. Fai clic su **Identifiers** e quindi su **Website Push IDs**. +3. Scegli di creare una nuova voce selezionando l'icona più. + ![Dashboard Push](images/safari_1.jpg) + +4. Nel pannello Register Website Push ID, fornisci un ID identificativo e una descrizione Website Push ID appropriati. Ti raccomandiamo che sia nel formato del nome a dominio inverso, e che inizi con 'web'. Ad esempio: web.com.example.dailyweatherreports. +5. Registra l'ID push sito web. Ora hai un ID push sito web. +6. Seleziona **Edit** per creare un certificato da utilizzare per l'ID push sito web. +7. Nella finestra Certificate Assistant per Certificate Information, fornisci il tuo indirizzo email e un nome comune. Lascia l'indirizzo email Certificate Authority vuoto. +8. Fai clic su **Save to disk** e seleziona **Continue**. +9. Scegli di salvare il certificato in una cartella appropriata. +10. Scegli il `.certSigningRequest` creato sul disco quando ti viene richiesto nella procedura guidata di creazione del certificato. Assicurati di scaricare il certificato di push sito web creato nel formato `.cer`. +11. Apri il certificato nello strumento KeyChain Access. Fai clic con il tasto destro del mouse ed esportalo come certificato p12. Annota la password fornita durante la generazione del certificato p12. + + +### Configurazione per le notifiche + {: #configuration-notification} + +Dopo aver generato il certificato, puoi configurare il servizio per l'invio di notifiche a Safari. + +Completa la procedura: + +1. Nel dashboard del servizio Push Notifications, fai clic su **Configure**. +2. Seleziona la scheda Web. +3. Nella sezione Safari Push, aggiorna il modulo con le informazioni richieste. + - **Website Name**: il nome che hai fornito nel centro di notifica. + - **Website Push ID**: aggiorna con la stringa reverse-domain per il tuo ID push sito web. Ad esempio, web.com.example.www. + - **Website URL**: fornisci l'URL del sito web da sottoscrivere alle notifiche di push. Ad esempio, https://www.example.com. + - **Allowed Domains**: parametro facoltativo. Indica l'elenco di siti web che richiedono l'autorizzazione dall'utente. Assicurati che gli URL siano valori separati da virgola. Se non si fornisce questo valore, verrà utilizzato quello specificato in Website URL. + - **URL Format String**: l'URL da risolvere quando si fa clic sulla notifica. Ad esempio, ["https://www.example.com"]. Assicurati che l'URL utilizzi lo schema http o https. + - **Safari web push certificate**: carica il certificato .p12 e fornisci la password. +4. Fai clic su **Save**. + +![Dashboard Push](images/push_configure_safari.jpg) + +Il servizio è ora configurato per l'invio di notifiche di push al browser Safari. + + diff --git a/services/mobilepush/nl/it/t_push_tagsmain.md b/services/mobilepush/nl/it/t_push_tagsmain.md index 8fedeb48a..f5509c9df 100755 --- a/services/mobilepush/nl/it/t_push_tagsmain.md +++ b/services/mobilepush/nl/it/t_push_tagsmain.md @@ -1,23 +1,23 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Notifiche basate sulle tag -{: #push-ios-main-tags} -Ultimo aggiornamento: 16 gennaio 2017 -{: .last-updated} - -I messaggi di notifica basata su tag sono destinati a tutti i dispositivi che hanno sottoscritto una specifica tag. Puoi definire le tag e quindi utilizzarle per - inviare e ricevere messaggi. - -Devi prima creare le tag per l'applicazione, impostare - le sottoscrizioni di tag e iniziare quindi le notifiche basate sulle - tag. Per inviare una notifica basata sulle tag che utilizza l'[API REST ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window}, assicurati che i "tagName" siano forniti all'inserimento nella risorsa messaggi. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Notifiche basate sulle tag +{: #push-ios-main-tags} +Ultimo aggiornamento: 16 gennaio 2017 +{: .last-updated} + +I messaggi di notifica basata su tag sono destinati a tutti i dispositivi che hanno sottoscritto una specifica tag. Puoi definire le tag e quindi utilizzarle per + inviare e ricevere messaggi. + +Devi prima creare le tag per l'applicazione, impostare + le sottoscrizioni di tag e iniziare quindi le notifiche basate sulle + tag. Per inviare una notifica basata sulle tag che utilizza l'[API REST ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window}, assicurati che i "tagName" siano forniti all'inserimento nella risorsa messaggi. diff --git a/services/mobilepush/nl/it/t_restapi.md b/services/mobilepush/nl/it/t_restapi.md index f2096f192..046896775 100755 --- a/services/mobilepush/nl/it/t_restapi.md +++ b/services/mobilepush/nl/it/t_restapi.md @@ -1,130 +1,130 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Utilizzo delle API REST -{: #push-api-rest} -Ultimo aggiornamento: 16 gennaio 2017 -{: .last-updated} - -Puoi utilizzare una API (application program interface) REST (Representational State Transfer) per {{site.data.keyword.mobilepushshort}}. Puoi anche utilizzare l'SDK e l'[API Push ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window} per sviluppare ulteriormente le tue applicazioni client. - -Con la API REST Push, i client e le applicazioni server di backend possono accedere alle funzioni {{site.data.keyword.mobilepushshort}}. - -- Registrazioni di dispositivi -- Registrazioni -- messaggi -- Sottoscrizioni -- Tag -- Webhook - -Per ottenere l'URL di base per la API REST, completa seguente procedura: - -1. Crea un'applicazione di backend nella sezione Contenitori tipo del catalogo Bluemix® scegliendo MobileFirst Services Starter. In questo modo viene eseguito il bind del servizio {{site.data.keyword.mobilepushshort}} all'applicazione. Puoi anche creare un'istanza del servizio di push e lasciarla senza binding. -1. Nella pagina principale del dashboard Bluemix, vai nell'area **Applicazioni** e quindi seleziona la tua applicazione. -3. Fai clic su **OPZIONI MOBILI**. I valori di rotta e GUID applicazione sono visualizzati nella parte superiore della pagina dei dettagli della tua applicazione. La schermata Visualizza credenziali mostra informazioni relative all'AppSecret. Puoi ottenere il segreto applicazione dalle opzioni mobili e anche il segreto client per alcune API. - -Puoi inoltre utilizzare la riga di comando per ottenere le credenziali del servizio: - -``` - cf create-service-key {push_instance_name} {key_name} - - cf service-key {push_instance_name} {key_name} -``` - {: codeblock} - -## Intestazione Accept-Language -{: #push-api-rest-accept} - -L'intestazione "Accept-Language" specifica quale lingua utilizzare per i messaggi di errore generati in output dalla [API REST Push ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window}. Per i messaggi di errore sono supportate le - seguenti lingue: cinese (semplificato), cinese, (tradizionale), inglese (US), tedesco, francese, - italiano, giapponese, coreano, portoghese e spagnolo. - -## appSecret -{: #push-api-rest-secret} - -Quando un'applicazione esegue il bind a {{site.data.keyword.mobilepushshort}}, il servizio genera una appSecret (una chiave univoca) e la passa nell'intestazione di risposta. Se stai utilizzando IBM {{site.data.keyword.mobilepushshort}} per la API Rest Bluemix, utilizza la guida di riferimento alle API REST per ottenere informazioni su quali API devi proteggere. Per informazioni, vedi [API REST Push![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window}. - -L'intestazione di richiesta deve contenere l'appSecret. In caso contrario, il server restituisce un codice di errore - 401 Non autorizzato. Quando {{site.data.keyword.mobilepushshort}} viene aggiunto a un'applicazione, viene creato uno specifico AppID. Come parte della risposta, ottieni un'intestazione denominata appSecret che viene utilizzata per la creazione di tag o l'invio di messaggi. L'operazione viene eseguita tramite i servizi nel catalogo o - nel contenitore tipo. - -Per ottenere il valore appSecret: - -1. Fai clic sul * nome-applicazione* associato al servizio push. -2. Fai clic sul link **Visualizza credenziali** per visualizzare - l'appSecret (AppID). - -La schermata **Visualizza credenziali** mostra le informazioni sull'AppSecret: -``` - { - "imfpush_Dev": [ - { - "name": "testapp1", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": { - "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", - "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", - "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", - } - } - ] - } -``` - {: codeblock} - - -##Filtri API REST di Push -{: #push-api-rest-filters} - -I filtri definiscono un criterio di ricerca che limita i dati restituiti da una API GET di {{site.data.keyword.mobilepushshort}}. Applica i filtri sul risultato dell'operazione Get che desideri filtrare. Il filtro limita il numero di voci incluse nel risultato. d esempio, puoi utilizzare un filtro per cercare tag il cui nome inizia con "test". - -I filtri possono essere generati utilizzando la seguente sintassi: - -**name**: il nome campo su cui viene applicato il filtro. - -**operator**: (corrispondenza esatta) oppure =@ (contiene la sottostringa) che descrive la corrispondenza di filtro da utilizzare. - -**expression**: i valori da includere nel risultato. - -Quando in un'espressione vengono visualizzati una virgola o una barra rovesciata, è necessario eseguirne l'escape - con una barra rovesciata. - -Quando utilizzi più filtri, puoi combinarli utilizzando la logica AND e OR. - -- Per la logica AND, utilizza più filtri nella query. -- Per la logica OR, utilizza una virgola nell'espressione di filtro. -- Sia per la logica AND che per quella OR: una singola query può avere sia la logica AND sia quella OR. Ogni filtro viene valutato singolarmente prima che i filtri vengano combinati - in un'espressione AND. - -Per l'API GET di dispositivo, sono supportate le seguenti combinazioni: --Il nome è il campo piattaforma. -- Fatta eccezione per la piattaforma, l'operatore può essere == oppure =@ -- Per la piattaforma, l'operatore deve essere ==. Se viene utilizzato l'operatore =@, il valore può essere una sottostringa. -- Se viene utilizzato ==, il valore deve essere una stringa di corrispondenza esatta. - -Per la API GET di sottoscrizione, sono supportate le seguenti combinazioni: - -- Il nome può essere uno di questi campi: tagName o deviceId -- Fatta eccezione per la piattaforma, l'operatore può essere == oppure =@ -- Per la piattaforma, l'operatore deve essere == -- Se viene utilizzato l'operatore =@, il valore può essere una sottostringa. Se viene utilizzato l'operatore ==, il valore deve essere una stringa di corrispondenza esatta. -- Per la API GET di tag, sono supportate le seguenti combinazioni: -- Il nome può essere uno dei seguenti campi: “name” o “description” -- Se viene utilizzato l'operatore =@, il valore può essere una sottostringa. -- Se viene utilizzato ==, il valore deve essere una stringa di corrispondenza esatta. - - -##Codici di risposta {{site.data.keyword.mobilepushshort}} -{: #push-api-response-codes} - -Stato: 405 Metodo non consentito - È previsto un metodo appropriato +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Utilizzo delle API REST +{: #push-api-rest} +Ultimo aggiornamento: 16 gennaio 2017 +{: .last-updated} + +Puoi utilizzare una API (application program interface) REST (Representational State Transfer) per {{site.data.keyword.mobilepushshort}}. Puoi anche utilizzare l'SDK e l'[API Push ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window} per sviluppare ulteriormente le tue applicazioni client. + +Con la API REST Push, i client e le applicazioni server di backend possono accedere alle funzioni {{site.data.keyword.mobilepushshort}}. + +- Registrazioni di dispositivi +- Registrazioni +- messaggi +- Sottoscrizioni +- Tag +- Webhook + +Per ottenere l'URL di base per la API REST, completa seguente procedura: + +1. Crea un'applicazione di backend nella sezione Contenitori tipo del catalogo Bluemix® scegliendo MobileFirst Services Starter. In questo modo viene eseguito il bind del servizio {{site.data.keyword.mobilepushshort}} all'applicazione. Puoi anche creare un'istanza del servizio di push e lasciarla senza binding. +1. Nella pagina principale del dashboard Bluemix, vai nell'area **Applicazioni** e quindi seleziona la tua applicazione. +3. Fai clic su **OPZIONI MOBILI**. I valori di rotta e GUID applicazione sono visualizzati nella parte superiore della pagina dei dettagli della tua applicazione. La schermata Visualizza credenziali mostra informazioni relative all'AppSecret. Puoi ottenere il segreto applicazione dalle opzioni mobili e anche il segreto client per alcune API. + +Puoi inoltre utilizzare la riga di comando per ottenere le credenziali del servizio: + +``` + cf create-service-key {push_instance_name} {key_name} + + cf service-key {push_instance_name} {key_name} +``` + {: codeblock} + +## Intestazione Accept-Language +{: #push-api-rest-accept} + +L'intestazione "Accept-Language" specifica quale lingua utilizzare per i messaggi di errore generati in output dalla [API REST Push ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window}. Per i messaggi di errore sono supportate le + seguenti lingue: cinese (semplificato), cinese, (tradizionale), inglese (US), tedesco, francese, + italiano, giapponese, coreano, portoghese e spagnolo. + +## appSecret +{: #push-api-rest-secret} + +Quando un'applicazione esegue il bind a {{site.data.keyword.mobilepushshort}}, il servizio genera una appSecret (una chiave univoca) e la passa nell'intestazione di risposta. Se stai utilizzando IBM {{site.data.keyword.mobilepushshort}} per la API Rest Bluemix, utilizza la guida di riferimento alle API REST per ottenere informazioni su quali API devi proteggere. Per informazioni, vedi [API REST Push![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/ "Icona link esterno"){: new_window}. + +L'intestazione di richiesta deve contenere l'appSecret. In caso contrario, il server restituisce un codice di errore + 401 Non autorizzato. Quando {{site.data.keyword.mobilepushshort}} viene aggiunto a un'applicazione, viene creato uno specifico AppID. Come parte della risposta, ottieni un'intestazione denominata appSecret che viene utilizzata per la creazione di tag o l'invio di messaggi. L'operazione viene eseguita tramite i servizi nel catalogo o + nel contenitore tipo. + +Per ottenere il valore appSecret: + +1. Fai clic sul * nome-applicazione* associato al servizio push. +2. Fai clic sul link **Visualizza credenziali** per visualizzare + l'appSecret (AppID). + +La schermata **Visualizza credenziali** mostra le informazioni sull'AppSecret: +``` + { + "imfpush_Dev": [ + { + "name": "testapp1", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": { + "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", + "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", + "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", + } + } + ] + } +``` + {: codeblock} + + +##Filtri API REST di Push +{: #push-api-rest-filters} + +I filtri definiscono un criterio di ricerca che limita i dati restituiti da una API GET di {{site.data.keyword.mobilepushshort}}. Applica i filtri sul risultato dell'operazione Get che desideri filtrare. Il filtro limita il numero di voci incluse nel risultato. d esempio, puoi utilizzare un filtro per cercare tag il cui nome inizia con "test". + +I filtri possono essere generati utilizzando la seguente sintassi: + +**name**: il nome campo su cui viene applicato il filtro. + +**operator**: (corrispondenza esatta) oppure =@ (contiene la sottostringa) che descrive la corrispondenza di filtro da utilizzare. + +**expression**: i valori da includere nel risultato. + +Quando in un'espressione vengono visualizzati una virgola o una barra rovesciata, è necessario eseguirne l'escape + con una barra rovesciata. + +Quando utilizzi più filtri, puoi combinarli utilizzando la logica AND e OR. + +- Per la logica AND, utilizza più filtri nella query. +- Per la logica OR, utilizza una virgola nell'espressione di filtro. +- Sia per la logica AND che per quella OR: una singola query può avere sia la logica AND sia quella OR. Ogni filtro viene valutato singolarmente prima che i filtri vengano combinati + in un'espressione AND. + +Per l'API GET di dispositivo, sono supportate le seguenti combinazioni: +-Il nome è il campo piattaforma. +- Fatta eccezione per la piattaforma, l'operatore può essere == oppure =@ +- Per la piattaforma, l'operatore deve essere ==. Se viene utilizzato l'operatore =@, il valore può essere una sottostringa. +- Se viene utilizzato ==, il valore deve essere una stringa di corrispondenza esatta. + +Per la API GET di sottoscrizione, sono supportate le seguenti combinazioni: + +- Il nome può essere uno di questi campi: tagName o deviceId +- Fatta eccezione per la piattaforma, l'operatore può essere == oppure =@ +- Per la piattaforma, l'operatore deve essere == +- Se viene utilizzato l'operatore =@, il valore può essere una sottostringa. Se viene utilizzato l'operatore ==, il valore deve essere una stringa di corrispondenza esatta. +- Per la API GET di tag, sono supportate le seguenti combinazioni: +- Il nome può essere uno dei seguenti campi: “name” o “description” +- Se viene utilizzato l'operatore =@, il valore può essere una sottostringa. +- Se viene utilizzato ==, il valore deve essere una stringa di corrispondenza esatta. + + +##Codici di risposta {{site.data.keyword.mobilepushshort}} +{: #push-api-response-codes} + +Stato: 405 Metodo non consentito - È previsto un metodo appropriato diff --git a/services/mobilepush/nl/it/t_sandbox.md b/services/mobilepush/nl/it/t_sandbox.md index d95770979..fc362052f 100755 --- a/services/mobilepush/nl/it/t_sandbox.md +++ b/services/mobilepush/nl/it/t_sandbox.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Modalità sandbox e di produzione -{: #push-sandboxandproduction-modes} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - -Puoi utilizzare {{site.data.keyword.mobilepushshort}} in una delle seguenti modalità: sandbox o produzione. Sandbox è un ambiente di test autonomo per sviluppare e testare l'integrazione - della API di push con il servizio push dell'applicazione del server. - -Configura le modalità sandbox e di produzione utilizzando il dashboard Push. Puoi passare dalla modalità operativa sandbox alla modalità di produzione del servizio di push utilizzando l'[API REST Push](https://mobile.{DomainName}/imfpush/){: new_window}. Per impostazione predefinita, è abilitata la modalità sandbox. Tuttavia, quando passi da una modalità all'altra, le tag, i dispositivi e le sottoscrizioni non sono condivisi tra queste modalità. - -Quando sei pronto a distribuire l'applicazione a un ambiente live, seleziona la modalità di PRODUZIONE utilizzando l'[API REST Push](https://mobile.{DomainName}/imfpush/){: new_window}. - -Per passare alla modalità di operazione del servizio di push dal sandbox alla produzione: - -1. Utilizza la chiamata API REST delle impostazioni ApplicationID PUT -2. Nel corpo JSON, conferma che la modalità è stata passata utilizzando la chiamata API [REST delle impostazioni ApplicationID PUT](https://mobile.{DomainName}/imfpush/){: new_window} . La risposta prevista è "mode": "PRODUCTION -```{ - "mode": "PRODUCTION" - } -``` - {: codeblock} -1. Dopo che è stata passata la tua modalità di ambiente, riesegui il tuo codice client per registrare il tuo dispositivo nella modalità di PRODUZIONE. - -Per informazioni sull'API REST, consulta [Utilizzo delle API REST](t_restapi.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Modalità sandbox e di produzione +{: #push-sandboxandproduction-modes} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + +Puoi utilizzare {{site.data.keyword.mobilepushshort}} in una delle seguenti modalità: sandbox o produzione. Sandbox è un ambiente di test autonomo per sviluppare e testare l'integrazione + della API di push con il servizio push dell'applicazione del server. + +Configura le modalità sandbox e di produzione utilizzando il dashboard Push. Puoi passare dalla modalità operativa sandbox alla modalità di produzione del servizio di push utilizzando l'[API REST Push](https://mobile.{DomainName}/imfpush/){: new_window}. Per impostazione predefinita, è abilitata la modalità sandbox. Tuttavia, quando passi da una modalità all'altra, le tag, i dispositivi e le sottoscrizioni non sono condivisi tra queste modalità. + +Quando sei pronto a distribuire l'applicazione a un ambiente live, seleziona la modalità di PRODUZIONE utilizzando l'[API REST Push](https://mobile.{DomainName}/imfpush/){: new_window}. + +Per passare alla modalità di operazione del servizio di push dal sandbox alla produzione: + +1. Utilizza la chiamata API REST delle impostazioni ApplicationID PUT +2. Nel corpo JSON, conferma che la modalità è stata passata utilizzando la chiamata API [REST delle impostazioni ApplicationID PUT](https://mobile.{DomainName}/imfpush/){: new_window} . La risposta prevista è "mode": "PRODUCTION +```{ + "mode": "PRODUCTION" + } +``` + {: codeblock} +1. Dopo che è stata passata la tua modalità di ambiente, riesegui il tuo codice client per registrare il tuo dispositivo nella modalità di PRODUZIONE. + +Per informazioni sull'API REST, consulta [Utilizzo delle API REST](t_restapi.html). diff --git a/services/mobilepush/nl/it/t_send_push_notifications.md b/services/mobilepush/nl/it/t_send_push_notifications.md index 571f02bf9..4cea05a07 100755 --- a/services/mobilepush/nl/it/t_send_push_notifications.md +++ b/services/mobilepush/nl/it/t_send_push_notifications.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Invio di notifiche di push di base -{: #push-send-notifications} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - -Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base (senza utilizzare tag, badge, payload aggiuntivi o file audio). - -Per inviare notifiche push di base, completa la seguente procedura: - -1. Seleziona **Send Notifications** e quindi scegli l'opzione **Send to** appropriata. - -**Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi sottoscritti a {{site.data.keyword.mobilepushshort}} riceveranno le notifiche. - -![Schermata notifiche](images/tag_notification.jpg) -2. Nel campo **Message**, immetti il tuo messaggio e fai quindi clic su **Send**. - -3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. La seguente immagine mostra una casella di avviso che gestisce una {{site.data.keyword.mobilepushshort}} in primo piano su un dispositivo Android e iOS. - -![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) - -![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) - -Il seguente screenshot mostra una {{site.data.keyword.mobilepushshort}} in background per Android. - -![Notifica push in background su Android](images/background.jpg) +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Invio di notifiche di push di base +{: #push-send-notifications} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + +Dopo che hai sviluppato le tue applicazioni, puoi inviare delle notifiche di push di base (senza utilizzare tag, badge, payload aggiuntivi o file audio). + +Per inviare notifiche push di base, completa la seguente procedura: + +1. Seleziona **Send Notifications** e quindi scegli l'opzione **Send to** appropriata. + +**Nota**: quando selezioni l'opzione **All Devices**, tutti i dispositivi sottoscritti a {{site.data.keyword.mobilepushshort}} riceveranno le notifiche. + +![Schermata notifiche](images/tag_notification.jpg) +2. Nel campo **Message**, immetti il tuo messaggio e fai quindi clic su **Send**. + +3. Verifica che i tuoi dispositivi abbiano ricevuto la tua notifica. La seguente immagine mostra una casella di avviso che gestisce una {{site.data.keyword.mobilepushshort}} in primo piano su un dispositivo Android e iOS. + +![Notifica push in primo piano su Android](images/Android_Screenshot.jpg) + +![Notifica push in primo piano su iOS](images/iOS_Screenshot.jpg) + +Il seguente screenshot mostra una {{site.data.keyword.mobilepushshort}} in background per Android. + +![Notifica push in background su Android](images/background.jpg) diff --git a/services/mobilepush/nl/it/t_service_instance.md b/services/mobilepush/nl/it/t_service_instance.md index 3d951ad92..4af45ed9f 100644 --- a/services/mobilepush/nl/it/t_service_instance.md +++ b/services/mobilepush/nl/it/t_service_instance.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Creazione di un'istanza del servizio push -{: #create-push-instance} - -Per iniziare a lavorare con {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, devi prima creare un'applicazione {{site.data.keyword.Bluemix}}, ad esempio un'applicazione Node.js. Puoi quindi creare un'istanza di un servizio Push, {{site.data.keyword.mobilepushfull}}, che deve essere associata a questa applicazione Bluemix. Puoi anche eseguire questa operazione andando alla sezione Contenitore tipo del catalogo Bluemix e facendo clic su MobileFirst Services Starter. - -**Nota**: se hai configurato le organizzazioni per gestire il tuo ambiente, seleziona l'organizzazione in cui vuoi creare il runtime e i servizi per la tua applicazione mobile. - - -1. Se non disponi di un'applicazione Bluemix, devi crearne una; ad esempio un'applicazione Node.js. Per creare un'applicazione Bluemix, vai al dashboard Bluemix e fai clic su **Crea applicazione**. - - **Nota**: se hai un'applicazione, vai al passo 7 per aggiungere un servizio.![Crea un'istanza del servizio](images/create_service_instance1.jpg "Crea un'istanza del servizio") - -1. Da **Scegli il template della tua applicazione**, fai clic su **WEB** - -3. Nell'area **Scegli il punto di partenza**, seleziona **SDK for Node.js** e quindi fai clic su **CONTINUA**.![Punto di partenza](images/create_service_nodejs2.jpg) - -4. Dal menu a discesa **Spazio**, seleziona il tuo spazio dell'organizzazione. - - ![ -Select organization space](images/create_a_service3.jpg) -1. In **Nome**, immetti il nome della tua applicazione e, nell'host, immetti il nome dell'host. - -1. Dal menu a discesa **Piano selezionato**, - seleziona un piano e fai quindi clic sul pulsante **CREA**. Attendi la preparazione dell'applicazione. - -1. Fai clic sul link **Panoramica**.![Aggiungi un servizio](images/create_service_add4.jpg) -1. Fai clic su **Aggiungi un servizio** . Viene visualizzata la schermata CATALOGO. - -1. Seleziona **IBM Push Notifications:** e dal menu a discesa **Spazio**, seleziona la tua organizzazione. - - ![Menu a discesa Spazio dell'organizzazione](images/create_service_org.jpg) -1. Nel nome **Servizio**, immetti il nome del servizio Notifica di push. - -1. Nel campo **Piano selezionato**, seleziona un piano e fai clic sul pulsante **CREA**. - -1. Fai clic su **Sì** per ripreparare l'applicazione. - - ![IBM Push Notification Service](images/create_service_notification5.jpg) - -1. Fai clic su **Push Notifications** per visualizzare il dashboard Push Notification. +--- + +copyright: + years: 2015, 2016 + +--- + +# Creazione di un'istanza del servizio push +{: #create-push-instance} + +Per iniziare a lavorare con {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, devi prima creare un'applicazione {{site.data.keyword.Bluemix}}, ad esempio un'applicazione Node.js. Puoi quindi creare un'istanza di un servizio Push, {{site.data.keyword.mobilepushfull}}, che deve essere associata a questa applicazione Bluemix. Puoi anche eseguire questa operazione andando alla sezione Contenitore tipo del catalogo Bluemix e facendo clic su MobileFirst Services Starter. + +**Nota**: se hai configurato le organizzazioni per gestire il tuo ambiente, seleziona l'organizzazione in cui vuoi creare il runtime e i servizi per la tua applicazione mobile. + + +1. Se non disponi di un'applicazione Bluemix, devi crearne una; ad esempio un'applicazione Node.js. Per creare un'applicazione Bluemix, vai al dashboard Bluemix e fai clic su **Crea applicazione**. + + **Nota**: se hai un'applicazione, vai al passo 7 per aggiungere un servizio.![Crea un'istanza del servizio](images/create_service_instance1.jpg "Crea un'istanza del servizio") + +1. Da **Scegli il template della tua applicazione**, fai clic su **WEB** + +3. Nell'area **Scegli il punto di partenza**, seleziona **SDK for Node.js** e quindi fai clic su **CONTINUA**.![Punto di partenza](images/create_service_nodejs2.jpg) + +4. Dal menu a discesa **Spazio**, seleziona il tuo spazio dell'organizzazione. + + ![ +Select organization space](images/create_a_service3.jpg) +1. In **Nome**, immetti il nome della tua applicazione e, nell'host, immetti il nome dell'host. + +1. Dal menu a discesa **Piano selezionato**, + seleziona un piano e fai quindi clic sul pulsante **CREA**. Attendi la preparazione dell'applicazione. + +1. Fai clic sul link **Panoramica**.![Aggiungi un servizio](images/create_service_add4.jpg) +1. Fai clic su **Aggiungi un servizio** . Viene visualizzata la schermata CATALOGO. + +1. Seleziona **IBM Push Notifications:** e dal menu a discesa **Spazio**, seleziona la tua organizzazione. + + ![Menu a discesa Spazio dell'organizzazione](images/create_service_org.jpg) +1. Nel nome **Servizio**, immetti il nome del servizio Notifica di push. + +1. Nel campo **Piano selezionato**, seleziona un piano e fai clic sul pulsante **CREA**. + +1. Fai clic su **Sì** per ripreparare l'applicazione. + + ![IBM Push Notification Service](images/create_service_notification5.jpg) + +1. Fai clic su **Push Notifications** per visualizzare il dashboard Push Notification. diff --git a/services/mobilepush/nl/it/t_subscribe_tags.md b/services/mobilepush/nl/it/t_subscribe_tags.md index e7acb0eb9..cbd3f46d1 100644 --- a/services/mobilepush/nl/it/t_subscribe_tags.md +++ b/services/mobilepush/nl/it/t_subscribe_tags.md @@ -1,130 +1,130 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Sottoscrizione e annullamento di sottoscrizioni di tag -{: #Subscribe_tags} - -Utilizza i seguenti frammenti di codice per consentire ai tuoi dispositivi di ottenere sottoscrizioni, sottoscriversi a una tag e annullare la sottoscrizione a una tag. - -## Android - -Copia e incolla questo frammento di codice nella tua applicazione mobile Android. - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - -## Cordova - -Copia e incolla questo frammento di codice nella tua applicazione mobile Cordova. - -``` -var tag = "YourTag"; -MFPPush.subscribe(tag, success, failure); -MFPPush.unsubscribe(tag, success, failure); -``` - -## Objective-C - -Copia e incolla questo frammento di codice nella tua applicazione mobile Objective-C. - -Utilizza la API **subscribeToTags** per sottoscrivere a una - tag. - -``` -[push subscribeToTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - }else{ - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response subscribeStatus]; - [self updateMessage:@"Parsed subscribe status is:"]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -Utilizza la API **unsubscribeFromTags** per annullare la sottoscrizione a una - tag. - -``` -[push unsubscribeFromTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if (error){ - [self updateMessage:error.description]; - } else { - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response unsubscribeStatus]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -## Swift - -Copia e incolla questo frammento di codice nella tua applicazione mobile Swift. - -**Sottoscrizione alle tag disponibili** - -Utilizza la API **subscribeToTags** per sottoscrivere a una - tag. - -``` -push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in - if (error != nil) { - //error while subscribing to tags - } else { - //successfully subscribed to tags var subStatus = response.subscribeStatus(); - } -} -``` - -**Annullare la sottoscrizione alle tag** - -Utilizza la API **unsubscribeFromTags** per annullare la sottoscrizione a una - tag. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - - if error.isEmpty { - print( "Response during unsubscribed tags : \(response.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Sottoscrizione e annullamento di sottoscrizioni di tag +{: #Subscribe_tags} + +Utilizza i seguenti frammenti di codice per consentire ai tuoi dispositivi di ottenere sottoscrizioni, sottoscriversi a una tag e annullare la sottoscrizione a una tag. + +## Android + +Copia e incolla questo frammento di codice nella tua applicazione mobile Android. + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + +## Cordova + +Copia e incolla questo frammento di codice nella tua applicazione mobile Cordova. + +``` +var tag = "YourTag"; +MFPPush.subscribe(tag, success, failure); +MFPPush.unsubscribe(tag, success, failure); +``` + +## Objective-C + +Copia e incolla questo frammento di codice nella tua applicazione mobile Objective-C. + +Utilizza la API **subscribeToTags** per sottoscrivere a una + tag. + +``` +[push subscribeToTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + }else{ + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response subscribeStatus]; + [self updateMessage:@"Parsed subscribe status is:"]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +Utilizza la API **unsubscribeFromTags** per annullare la sottoscrizione a una + tag. + +``` +[push unsubscribeFromTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if (error){ + [self updateMessage:error.description]; + } else { + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response unsubscribeStatus]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +## Swift + +Copia e incolla questo frammento di codice nella tua applicazione mobile Swift. + +**Sottoscrizione alle tag disponibili** + +Utilizza la API **subscribeToTags** per sottoscrivere a una + tag. + +``` +push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in + if (error != nil) { + //error while subscribing to tags + } else { + //successfully subscribed to tags var subStatus = response.subscribeStatus(); + } +} +``` + +**Annullare la sottoscrizione alle tag** + +Utilizza la API **unsubscribeFromTags** per annullare la sottoscrizione a una + tag. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + + if error.isEmpty { + print( "Response during unsubscribed tags : \(response.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` diff --git a/services/mobilepush/nl/it/t_use_tags.md b/services/mobilepush/nl/it/t_use_tags.md index 70acd9b32..e89863d88 100644 --- a/services/mobilepush/nl/it/t_use_tags.md +++ b/services/mobilepush/nl/it/t_use_tags.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Utilizzo delle notifiche basate sulle tag -{: #using_tags} - - -Le notifiche basate sulle tag sono messaggi di notifica destinati a tutti i dispositivi che hanno sottoscritto una specifica tag. Ciascun dispositivo può essere sottoscritto a un qualsiasi numero di tag. Questa sezione descrive come inviare notifiche basate sulle tag. Le sottoscrizioni vengono gestite dall'istanza Bluemix Push Notifications service. Quando viene eliminata una tag, vengono eliminate anche tutte le informazioni associate con tale tag, inclusi i relativi sottoscrittori e dispositivi. Non è necessario un annullamento della sottoscrizione automatico per questa tag poiché non esiste più e non sono richieste ulteriori azioni dal lato client. - -**Prima di iniziare** - -Crea le tag sulla schermata **Tag**. Per informazioni su come creare le tag, vedi [Creazione di tag](t_manage_tags.html). - -1. Dal dashboard **Push Notification**, fai clic sulla scheda **Notifications**. -1. Seleziona l'opzione **Tags** per inviare notifiche basate sulle tag. -1. Nel campo **Search**, cerca le tag che vuoi utilizzare e fai quindi clic sul pulsante **+Add**.![Schermata notifiche](images/tag_notification.jpg) -1. Vai all'area **Create Your Notifications** e, nel campo **Message Text**, immetti il testo che vuoi inviare nella tua notifica. -1. Fai clic sul pulsante **Send**. +--- + +copyright: + years: 2015, 2016 + +--- + +# Utilizzo delle notifiche basate sulle tag +{: #using_tags} + + +Le notifiche basate sulle tag sono messaggi di notifica destinati a tutti i dispositivi che hanno sottoscritto una specifica tag. Ciascun dispositivo può essere sottoscritto a un qualsiasi numero di tag. Questa sezione descrive come inviare notifiche basate sulle tag. Le sottoscrizioni vengono gestite dall'istanza Bluemix Push Notifications service. Quando viene eliminata una tag, vengono eliminate anche tutte le informazioni associate con tale tag, inclusi i relativi sottoscrittori e dispositivi. Non è necessario un annullamento della sottoscrizione automatico per questa tag poiché non esiste più e non sono richieste ulteriori azioni dal lato client. + +**Prima di iniziare** + +Crea le tag sulla schermata **Tag**. Per informazioni su come creare le tag, vedi [Creazione di tag](t_manage_tags.html). + +1. Dal dashboard **Push Notification**, fai clic sulla scheda **Notifications**. +1. Seleziona l'opzione **Tags** per inviare notifiche basate sulle tag. +1. Nel campo **Search**, cerca le tag che vuoi utilizzare e fai quindi clic sul pulsante **+Add**.![Schermata notifiche](images/tag_notification.jpg) +1. Vai all'area **Create Your Notifications** e, nel campo **Message Text**, immetti il testo che vuoi inviare nella tua notifica. +1. Fai clic sul pulsante **Send**. diff --git a/services/mobilepush/nl/it/tr_error_push.md b/services/mobilepush/nl/it/tr_error_push.md index 992bddd15..065703e8e 100644 --- a/services/mobilepush/nl/it/tr_error_push.md +++ b/services/mobilepush/nl/it/tr_error_push.md @@ -1,203 +1,203 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Messaggi di errore del servizio {{site.data.keyword.mobilepushshort}} -{: #errors} -Ultimo aggiornamento: 13 febbraio 2017 -{: .last-updated} - - -I seguenti messaggi di errore di {{site.data.keyword.mobilepushshort}} vengono restituiti in risposta alle richieste della API REST. - -Esempio di risposta di errore: -``` - { - "message": "Missing APNs credentials", - "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", - "code": "FPWSE0003E" - } -``` - {: codeblock} - -Per ottenere ulteriori informazioni su un errore, cerca il relativo codice di errore nella documentazione. - -## FPWSE0001E -{: #error_fpwse0001e} - -**Spiegazione**: la risorsa che stai tentando di sottoporre a query, come una tag o sottoscrizione, non è disponibile sul server. - -**Risposta utente**: crea la risorsa indicata nel messaggio. In alternativa, fornisci l'identificativo corretto per eseguire la query della risorsa. - - -## FPWSE0002E -{: #error_fpwse0002e} - -**Spiegazione**: la risorsa che stai tentando di creare è già disponibile sul server. La - risorsa potrebbe essere una tag, una sottoscrizione e così via. - -**Risposta utente**: crea la risorsa con un identificativo differente. - - -## FPWSE0003E -{: #error_fpwse0003e} - -**Spiegazione**: la configurazione dei prerequisiti per il servizio {{site.data.keyword.mobilepushshort}} non è completa. È possibile che tu stia tentando - di richiamare le credenziali del servizio APNS (Apple Push Notification Service) prima della loro - configurazione. - -**Risposta utente**: assicurati che il servizio {{site.data.keyword.mobilepushshort}} sia stato configurato con certificati di sicurezza validi per APNs. Per ulteriori informazioni, vedi [Configurazione delle credenziali per APNs ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](t_push_provider_ios.html){: new_window}. - - -## FPWSE0004E -{: #error_fpwse0004e} - -**Spiegazione**: il corpo JSON incluso nella richiesta non è valido. - - -**Risposta utente**: assicurati di utilizzare la sintassi JSON corretta nella richiesta. - - - -## FPWSE0005E -{: #error_fpwse0005e} - -**Spiegazione**: la richiesta al server {{site.data.keyword.mobilepushshort}} è errata o incompleta perché il corpo JSON non contiene i valori di proprietà necessari per completare la richiesta API. Ad esempio, una password non è valida o - manca un token del dispositivo. - - -**Risposta utente**: esamina il messaggio per individuare quale valore di proprietà risulta non valido o mancante, quindi fornisci le informazioni richieste. - - - -## FPWSE0006E -{: #error_fpwse0006e} - -**Spiegazione**: il corpo JSON della richiesta contiene dei parametri non riconosciuti dal server {{site.data.keyword.mobilepushshort}}. - - -**Risposta utente**: verifica che il corpo JSON nella richiesta rispetti il formato della richiesta previsto dal server {{site.data.keyword.mobilepushshort}}. Per ulteriori informazioni, vedi [API REST![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0007E -{: #error_fpwse0007e} - -**Spiegazione**: l'URL della richiesta ha una stringa di query con parametri non riconosciuti. Ad esempio, se la richiesta di eliminazione della sottoscrizione ha parametri diversi da deviceId e tagName, si potrebbe verificare questo errore. - - -**Risposta utente**: verifica che il corpo JSON nella richiesta rispetti il formato della richiesta previsto dal server {{site.data.keyword.mobilepushshort}}. Per ulteriori informazioni, vedi [API REST![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0008E -{: #error_fpwse0008e} - -**Spiegazione **: l'URL della richiesta ha una stringa di query in cui mancano dei parametri richiesti. Ad esempio, i parametri deviceId e tagName potrebbero non essere presenti nella richiesta di eliminazione della sottoscrizione. - - -**Risposta utente**: verifica che il corpo JSON nella richiesta rispetti il formato della richiesta previsto dal server {{site.data.keyword.mobilepushshort}}. Per ulteriori informazioni, vedi [API REST![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0009E -{: #error_fpwse0009e} - -**Spiegazione**: è stato effettuato un tentativo di inviare le notifiche ma non ci sono dispositivi registrati con l'applicazione. - -**Risposta utente**: assicurati che i dispositivi siano stati registrati con l'applicazione prima di tentare l'invio delle notifiche. - - - -## FPWSE0010E -{: #error_fpwse0010e} - -**Spiegazione**: la richiesta inoltrata al server ha provocato una condizione di eccezione. L'errore potrebbe essere stato causato da una delle -seguenti condizioni: - -- Un sottosistema interno utilizzato da {{site.data.keyword.mobilepushshort}} non - risponde. -- La richiesta ha provocato una condizione di errore che potrebbe non essere gestita da - {{site.data.keyword.mobilepushshort}}. -- Il servizio {{site.data.keyword.mobilepushshort}} - richiede l'attenzione da parte dell'amministratore. - -**Risposta utente**: ritenta la richiesta. Se il problema persiste, contatta il supporto software IBM. - - - -## FPWSE0011E -{: #error_fpwse0011e} - -**Spiegazione**: la sottoscrizione per la tag è già presente sul server. Questo errore si verifica, ad esempio, quando crei una - sottoscrizione già esistente. - -**Risposta utente**: crea la sottoscrizione con un nome tag univoco. - - - -## FPWSE0012E -{: #error_fpwse0012e} - -**Spiegazione**: la sottoscrizione per la tag non esiste sul server. Questo errore si verifica quando - viene inoltrata una richiesta per richiamare o eliminare una sottoscrizione che non esiste. - - -**Risposta utente**: utilizza il nome tag e l'identificativo del dispositivo corretti nella richiesta. - - - -## FPWSE0013E -{: #error_fpwse0013e} - -**Spiegazione**: il payload JSON nella richiesta non è valido. - - -**Risposta utente**: assicurati che il payload JSON sia valido. - - -## FPWSE0025E -{: #error_fpwse0025e} - -**Spiegazione**: il server non è attualmente in grado di gestire la richiesta. - -**Risposta utente**: reinvia la richiesta in un secondo momento. - - -## FPWSE1007E -{: #error_fpwse1007e} - -**Spiegazione**: il servizio {{site.data.keyword.mobilepushshort}} è stato disabilitato per questa applicazione. Questo potrebbe essere dovuto a motivi di fatturazione o l'applicazione -potrebbe essere stata disabilitata dall'amministratore. - - -**Risposta utente**: consulta gli argomenti relativi alla Risoluzione dei problemi nella documentazione Bluemix per controllare lo stato del servizio, per esaminare le informazioni sulla risoluzione dei problemi o per informazioni sulla richiesta di assistenza. - - - -## FPWSE1079E -{: #error_fpwse1079e} - -**Spiegazione**: il valore di offset fornito per l'operazione di query non è valido. - -**Risposta utente**: assicurati che il valore di offset sia superiore o uguale a zero. - - - -## FPWSE1080E -{: #error_fpwse1080e} - -**Spiegazione**: il valore della dimensione fornito per l'operazione di query non è valido. - -**Risposta utente**: assicurati che il valore della dimensione sia maggiore di zero. - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Messaggi di errore del servizio {{site.data.keyword.mobilepushshort}} +{: #errors} +Ultimo aggiornamento: 13 febbraio 2017 +{: .last-updated} + + +I seguenti messaggi di errore di {{site.data.keyword.mobilepushshort}} vengono restituiti in risposta alle richieste della API REST. + +Esempio di risposta di errore: +``` + { + "message": "Missing APNs credentials", + "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", + "code": "FPWSE0003E" + } +``` + {: codeblock} + +Per ottenere ulteriori informazioni su un errore, cerca il relativo codice di errore nella documentazione. + +## FPWSE0001E +{: #error_fpwse0001e} + +**Spiegazione**: la risorsa che stai tentando di sottoporre a query, come una tag o sottoscrizione, non è disponibile sul server. + +**Risposta utente**: crea la risorsa indicata nel messaggio. In alternativa, fornisci l'identificativo corretto per eseguire la query della risorsa. + + +## FPWSE0002E +{: #error_fpwse0002e} + +**Spiegazione**: la risorsa che stai tentando di creare è già disponibile sul server. La + risorsa potrebbe essere una tag, una sottoscrizione e così via. + +**Risposta utente**: crea la risorsa con un identificativo differente. + + +## FPWSE0003E +{: #error_fpwse0003e} + +**Spiegazione**: la configurazione dei prerequisiti per il servizio {{site.data.keyword.mobilepushshort}} non è completa. È possibile che tu stia tentando + di richiamare le credenziali del servizio APNS (Apple Push Notification Service) prima della loro + configurazione. + +**Risposta utente**: assicurati che il servizio {{site.data.keyword.mobilepushshort}} sia stato configurato con certificati di sicurezza validi per APNs. Per ulteriori informazioni, vedi [Configurazione delle credenziali per APNs ![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](t_push_provider_ios.html){: new_window}. + + +## FPWSE0004E +{: #error_fpwse0004e} + +**Spiegazione**: il corpo JSON incluso nella richiesta non è valido. + + +**Risposta utente**: assicurati di utilizzare la sintassi JSON corretta nella richiesta. + + + +## FPWSE0005E +{: #error_fpwse0005e} + +**Spiegazione**: la richiesta al server {{site.data.keyword.mobilepushshort}} è errata o incompleta perché il corpo JSON non contiene i valori di proprietà necessari per completare la richiesta API. Ad esempio, una password non è valida o + manca un token del dispositivo. + + +**Risposta utente**: esamina il messaggio per individuare quale valore di proprietà risulta non valido o mancante, quindi fornisci le informazioni richieste. + + + +## FPWSE0006E +{: #error_fpwse0006e} + +**Spiegazione**: il corpo JSON della richiesta contiene dei parametri non riconosciuti dal server {{site.data.keyword.mobilepushshort}}. + + +**Risposta utente**: verifica che il corpo JSON nella richiesta rispetti il formato della richiesta previsto dal server {{site.data.keyword.mobilepushshort}}. Per ulteriori informazioni, vedi [API REST![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0007E +{: #error_fpwse0007e} + +**Spiegazione**: l'URL della richiesta ha una stringa di query con parametri non riconosciuti. Ad esempio, se la richiesta di eliminazione della sottoscrizione ha parametri diversi da deviceId e tagName, si potrebbe verificare questo errore. + + +**Risposta utente**: verifica che il corpo JSON nella richiesta rispetti il formato della richiesta previsto dal server {{site.data.keyword.mobilepushshort}}. Per ulteriori informazioni, vedi [API REST![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0008E +{: #error_fpwse0008e} + +**Spiegazione **: l'URL della richiesta ha una stringa di query in cui mancano dei parametri richiesti. Ad esempio, i parametri deviceId e tagName potrebbero non essere presenti nella richiesta di eliminazione della sottoscrizione. + + +**Risposta utente**: verifica che il corpo JSON nella richiesta rispetti il formato della richiesta previsto dal server {{site.data.keyword.mobilepushshort}}. Per ulteriori informazioni, vedi [API REST![Icona link esterno](../../icons/launch-glyph.svg "Icona link esterno")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0009E +{: #error_fpwse0009e} + +**Spiegazione**: è stato effettuato un tentativo di inviare le notifiche ma non ci sono dispositivi registrati con l'applicazione. + +**Risposta utente**: assicurati che i dispositivi siano stati registrati con l'applicazione prima di tentare l'invio delle notifiche. + + + +## FPWSE0010E +{: #error_fpwse0010e} + +**Spiegazione**: la richiesta inoltrata al server ha provocato una condizione di eccezione. L'errore potrebbe essere stato causato da una delle +seguenti condizioni: + +- Un sottosistema interno utilizzato da {{site.data.keyword.mobilepushshort}} non + risponde. +- La richiesta ha provocato una condizione di errore che potrebbe non essere gestita da + {{site.data.keyword.mobilepushshort}}. +- Il servizio {{site.data.keyword.mobilepushshort}} + richiede l'attenzione da parte dell'amministratore. + +**Risposta utente**: ritenta la richiesta. Se il problema persiste, contatta il supporto software IBM. + + + +## FPWSE0011E +{: #error_fpwse0011e} + +**Spiegazione**: la sottoscrizione per la tag è già presente sul server. Questo errore si verifica, ad esempio, quando crei una + sottoscrizione già esistente. + +**Risposta utente**: crea la sottoscrizione con un nome tag univoco. + + + +## FPWSE0012E +{: #error_fpwse0012e} + +**Spiegazione**: la sottoscrizione per la tag non esiste sul server. Questo errore si verifica quando + viene inoltrata una richiesta per richiamare o eliminare una sottoscrizione che non esiste. + + +**Risposta utente**: utilizza il nome tag e l'identificativo del dispositivo corretti nella richiesta. + + + +## FPWSE0013E +{: #error_fpwse0013e} + +**Spiegazione**: il payload JSON nella richiesta non è valido. + + +**Risposta utente**: assicurati che il payload JSON sia valido. + + +## FPWSE0025E +{: #error_fpwse0025e} + +**Spiegazione**: il server non è attualmente in grado di gestire la richiesta. + +**Risposta utente**: reinvia la richiesta in un secondo momento. + + +## FPWSE1007E +{: #error_fpwse1007e} + +**Spiegazione**: il servizio {{site.data.keyword.mobilepushshort}} è stato disabilitato per questa applicazione. Questo potrebbe essere dovuto a motivi di fatturazione o l'applicazione +potrebbe essere stata disabilitata dall'amministratore. + + +**Risposta utente**: consulta gli argomenti relativi alla Risoluzione dei problemi nella documentazione Bluemix per controllare lo stato del servizio, per esaminare le informazioni sulla risoluzione dei problemi o per informazioni sulla richiesta di assistenza. + + + +## FPWSE1079E +{: #error_fpwse1079e} + +**Spiegazione**: il valore di offset fornito per l'operazione di query non è valido. + +**Risposta utente**: assicurati che il valore di offset sia superiore o uguale a zero. + + + +## FPWSE1080E +{: #error_fpwse1080e} + +**Spiegazione**: il valore della dimensione fornito per l'operazione di query non è valido. + +**Risposta utente**: assicurati che il valore della dimensione sia maggiore di zero. + + + diff --git a/services/mobilepush/nl/it/troubleshooting.md b/services/mobilepush/nl/it/troubleshooting.md index 5302175b8..02b9cff98 100755 --- a/services/mobilepush/nl/it/troubleshooting.md +++ b/services/mobilepush/nl/it/troubleshooting.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Risoluzione dei problemi -{: #errors} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - -Utilizza questa sezione come una guida per risolvere i problemi comuni di {{site.data.keyword.mobilepushshort}}. - - -### Si è verificato un errore server interno. Per favore contatta l'amministratore. (Codice errore interno: PUSHD102E) - -**Spiegazione**: questo errore potrebbe verificarsi se hai creato un'istanza di push prima del novembre 2015. - -**Risposta utente**: per risolvere il problema, elimina l'istanza di push e creane una nuova. Nota che quando elimini l'istanza di push, le tue tag non vengono conservate. - - -### Registrazione non autorizzata - -**Spiegazione**: Chrome Web Push non funziona con le chiavi FCM (Firebase Cloud Messaging). Se non puoi ricevere le notifiche push web su Chrome dopo lo spostamento a FCM da GCM, questo succede perché il sito web era stato precedentemente configurato per utilizzare il progetto GCM mentre il nuovo progetto è stato creato in FCM. I token generati che identificano il browser vengono memorizzati nella cache dal browser Chrome. - -**Risposta utente**: puoi risolvere questo problema rimuovendo i cookie e reimpostando le autorizzazioni del browser. Questo richiederà alle autorizzazioni di abilitare Push Notifications. - - -### I worker del servizio non sono supportati in questo browser - -**Spiegazione**: l'SDK che era stato incluso come parte di `BMSPushSDK.js` mediante il worker del servizio non è disponibile. - -**Risposta utente**: si consiglia di passare a un browser che supporti il worker del servizio. Le versioni supportate dei browser sono Firefox versione 49 o successive e Chrome versione 53 (64 bit) o successive. - - -### SecurityError: l'operazione non è sicura - -**Spiegazione**: si potrebbe visualizzare l'errore durante l'abilitazione della console web in Firefox. Il supporto push web nel servizio Push Notification richiede l'accesso al sito web tramite il protocollo `https` invece di `http`. - -**Risposta utente**: si consiglia di provare a connettersi al sito web utilizzando il protocollo `https` dal browser. - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Risoluzione dei problemi +{: #errors} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + +Utilizza questa sezione come una guida per risolvere i problemi comuni di {{site.data.keyword.mobilepushshort}}. + + +### Si è verificato un errore server interno. Per favore contatta l'amministratore. (Codice errore interno: PUSHD102E) + +**Spiegazione**: questo errore potrebbe verificarsi se hai creato un'istanza di push prima del novembre 2015. + +**Risposta utente**: per risolvere il problema, elimina l'istanza di push e creane una nuova. Nota che quando elimini l'istanza di push, le tue tag non vengono conservate. + + +### Registrazione non autorizzata + +**Spiegazione**: Chrome Web Push non funziona con le chiavi FCM (Firebase Cloud Messaging). Se non puoi ricevere le notifiche push web su Chrome dopo lo spostamento a FCM da GCM, questo succede perché il sito web era stato precedentemente configurato per utilizzare il progetto GCM mentre il nuovo progetto è stato creato in FCM. I token generati che identificano il browser vengono memorizzati nella cache dal browser Chrome. + +**Risposta utente**: puoi risolvere questo problema rimuovendo i cookie e reimpostando le autorizzazioni del browser. Questo richiederà alle autorizzazioni di abilitare Push Notifications. + + +### I worker del servizio non sono supportati in questo browser + +**Spiegazione**: l'SDK che era stato incluso come parte di `BMSPushSDK.js` mediante il worker del servizio non è disponibile. + +**Risposta utente**: si consiglia di passare a un browser che supporti il worker del servizio. Le versioni supportate dei browser sono Firefox versione 49 o successive e Chrome versione 53 (64 bit) o successive. + + +### SecurityError: l'operazione non è sicura + +**Spiegazione**: si potrebbe visualizzare l'errore durante l'abilitazione della console web in Firefox. Il supporto push web nel servizio Push Notification richiede l'accesso al sito web tramite il protocollo `https` invece di `http`. + +**Risposta utente**: si consiglia di provare a connettersi al sito web utilizzando il protocollo `https` dal browser. + diff --git a/services/mobilepush/nl/it/troubleshooting_config_errors.md b/services/mobilepush/nl/it/troubleshooting_config_errors.md index 6dc424233..9e7619286 100644 --- a/services/mobilepush/nl/it/troubleshooting_config_errors.md +++ b/services/mobilepush/nl/it/troubleshooting_config_errors.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Risoluzione degli errori di configurazione push web -{: #errors} -Ultimo aggiornamento: 11 gennaio 2017 -{: .last-updated} - -Utilizza questa sezione come una guida per risolvere gli errori comuni relativi alla configurazione del push web. Gli errori push web dal `BMSPushSDK.js` contengono informazioni sull'errore. - -Per analizzare un errore restituiti nel callback, considera il seguente codice di esempio: - -``` -function showStatus(response) { - if(response.statusCode == 200 || response.statusCode == 201) { - document.getElementById("status").innerHTML = "Response is " + response.response; - } - else if(response.statusCode == 0) { - if(response.response) { - document.getElementById("status").innerHTML = response.response; - } - else { - document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; - } - } - else { - document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " - + response.error + " and the status code " + response.statusCode; - } - } -``` - {: codeblock} - - -- Se l'`applicationId` non è configurato correttamente, la richiesta iniziale al servizio {{site.data.keyword.mobilepushshort}} avrà esito negativo, pertanto lo statusCode verrà impostato su zero (0). -- Il codice di stato 200 o 201 indica una risposta positiva. -- Nel caso in cui il `clientSecret` non sia valido, sullo statusCode verrà impostata una risposta 401. L'elemento `response.reponse` conterrà la descrizione dell'errore. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Risoluzione degli errori di configurazione push web +{: #errors} +Ultimo aggiornamento: 11 gennaio 2017 +{: .last-updated} + +Utilizza questa sezione come una guida per risolvere gli errori comuni relativi alla configurazione del push web. Gli errori push web dal `BMSPushSDK.js` contengono informazioni sull'errore. + +Per analizzare un errore restituiti nel callback, considera il seguente codice di esempio: + +``` +function showStatus(response) { + if(response.statusCode == 200 || response.statusCode == 201) { + document.getElementById("status").innerHTML = "Response is " + response.response; + } + else if(response.statusCode == 0) { + if(response.response) { + document.getElementById("status").innerHTML = response.response; + } + else { + document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; + } + } + else { + document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " + + response.error + " and the status code " + response.statusCode; + } + } +``` + {: codeblock} + + +- Se l'`applicationId` non è configurato correttamente, la richiesta iniziale al servizio {{site.data.keyword.mobilepushshort}} avrà esito negativo, pertanto lo statusCode verrà impostato su zero (0). +- Il codice di stato 200 o 201 indica una risposta positiva. +- Nel caso in cui il `clientSecret` non sia valido, sullo statusCode verrà impostata una risposta 401. L'elemento `response.reponse` conterrà la descrizione dell'errore. diff --git a/services/mobilepush/nl/ja/c_advance_notifications.md b/services/mobilepush/nl/ja/c_advance_notifications.md index 5c0267bdb..2e4c5b2c1 100644 --- a/services/mobilepush/nl/ja/c_advance_notifications.md +++ b/services/mobilepush/nl/ja/c_advance_notifications.md @@ -1,12 +1,12 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# 拡張プッシュ通知の使用可能化 -{: #push-advanced-notifications-main} - -iOS バッジ、音声、追加の JSON ペイロード、アクション可能通知、および保留通知を構成します。 +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# 拡張プッシュ通知の使用可能化 +{: #push-advanced-notifications-main} + +iOS バッジ、音声、追加の JSON ペイロード、アクション可能通知、および保留通知を構成します。 diff --git a/services/mobilepush/nl/ja/c_android_enable.md b/services/mobilepush/nl/ja/c_android_enable.md index 7793de1f2..a97da8e3c 100644 --- a/services/mobilepush/nl/ja/c_android_enable.md +++ b/services/mobilepush/nl/ja/c_android_enable.md @@ -1,363 +1,363 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Android アプリケーションによる{{site.data.keyword.mobilepushshort}}受け取りの可能化 -{: #tag_based_notifications} -最終更新日: 2017 年 2 月 14 日 -{: .last-updated} - -Android アプリケーションでデバイスへのプッシュ通知を受け取れるようにすることができます。Android Studio が前提条件であり、Android プロジェクトをビルドするための推奨方式です。Android Studio の基本知識が必要です。 - -## Gradle を使用したクライアント Push SDK のインストール -{: #android_install} - -このセクションでは、Android アプリケーションをさらに開発するためにクライアント Push SDK をインストールして使用する方法について説明します。 - -Bluemix® Mobile Services Push SDK は、Gradle を使用して追加できます。Gradle は自動的に成果物をリポジトリーからダウンロードして、Android アプリケーションで使用できるようにします。Android Studio および Android Studio SDK が正しくセットアップされていることを確認してください。システムのセットアップ方法について詳しくは、[Android Studio の概要![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.android.com/tools/studio/index.html){: new_window}を参照してください。Gradle について詳しくは、[Gradle でのビルドの構成に関する資料![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}を参照してください。 - -モバイル・アプリケーションを作成して開いてから、Android Studio を使用して以下の手順を実行します。 - -1. モジュール・レベルの **build.gradle** ファイルに、依存関係を追加します。 - - - 以下の依存関係を追加して、Bluemix™ Mobile サービスの Push クライアント SDK と Google Play サービス SDK を、コンパイル有効範囲の依存関係に含めます。 - ``` - com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ - ``` - {: codeblock} - - - コード・スニペットに必要なインポート・ステートメントに、以下の依存関係を追加します。 - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - {: codeblock} - - - 次の依存関係をモジュール・レベルの **build.gradle** ファイルの最後に追加します。 - ``` - apply plugin: 'com.google.gms.google-services' - ``` - {: codeblock} -3. プロジェクト・レベルの **build.gradle** ファイルに、以下の依存関係を追加します。 -``` -dependencies { - classpath 'com.android.tools.build:gradle:2.2.3' - classpath 'com.google.gms:google-services:3.0.0' -} -``` - {: codeblock} -5. **AndroidManifest.xml** ファイルに、以下のアクセス権を追加します。サンプル・マニフェストを表示するには、[Android helloPush のサンプル・アプリケーション![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}を参照してください。サンプル Gradle ファイルを表示するには、[サンプルの Build Gradle ファイル![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}を参照してください。 -``` - - - - - -``` - {: codeblock} -ここをクリックすると、[Android のパーミッション![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](http://developer.android.com/guide/topics/security/permissions.html){: new_window}の詳細情報が表示されます。 - -4. アクティビティーの通知インテント設定を追加します。この設定により、ユーザーが通知エリアで受信した通知をクリックすると、アプリケーションが開始します。 -``` - - - - -``` - {: codeblock} -**注**: 上記のアクション内の *Your_Android_Package_Name* を、アプリケーションで使用されているアプリケーション・パッケージ名に置き換えてください。 - -5. RECEIVE および REGISTRATION のイベント通知用に、Firebase Cloud Messaging (FCM) または Google Cloud Messaging (GCM) のインテント・サービスとインテント・フィルターを追加します。 -``` - - - - - - - - - - -``` - {: codeblock} - -6. {{site.data.keyword.mobilepushshort}} サービスは、通知トレイからの個々の通知の取り出しをサポートします。通知トレイから通知にアクセスする場合、クリックしている通知のみへのハンドルが提供されます。アプリケーションを通常どおりに開いた場合は、すべての通知が表示されます。この機能を使用するには、以下のスニペットを使用して **AndroidManifest.xml** ファイルを更新します。 - -``` - -``` - {: codeblock} - -FCM プロジェクトのセットアップおよび資格情報の取得については、[送信側 ID と API キーの取得](t_push_provider_android.html)を参照してください。Firebase Cloud Messaging (FCM) コンソールを使用して、以下の手順を実行します。 - -1. Firebase コンソールで、**「Project Settings (プロジェクト設定)」** アイコンをクリックします。 - ![Firebase のプロジェクト設定](images/FCM_4.jpg) - -3. アプリケーション・ペインの「General (一般)」タブから、**「ADD APP」**または**「Android アプリへの Firebase の追加 (Add Firebase to your Android app)」アイコン**を選択します。 - ![Android への Firebase の追加](images/FCM_5.jpg) - -4. 「Android アプリへの Firebase の追加 (Add Firebase to your Android app)」ウィンドウで、パッケージ名として **com.ibm.mobilefirstplatform.clientsdk.android.push** を追加します。「アプリのニックネーム (App nickname)」フィールドはオプションです。**「ADD APP」**をクリックします。 - ![「Android への Firebase の追加」ウィンドウ](images/FCM_1.jpg) - -5. 「Android アプリへの Firebase の追加 (Add Firebase to your Android app)」ウィンドウにパッケージ名を入力して、アプリケーションのパッケージ名を組み込みます。「アプリのニックネーム (App nickname)」フィールドはオプションです。**「ADD APP」**をクリックします。 - - ![アプリケーションのパッケージ名の追加](images/FCM_2.jpg) - -6. `google-services.json` ファイルが生成されます。`google-services.json` ファイルを Android アプリケーション・モジュールのルート・ディレクトリーにコピーします。この `google-service.json` ファイルには、追加されたパッケージ名が含まれていることに注意してください。 - - ![アプリケーションのルート・ディレクトリーへの json ファイルの追加](images/FCM_7.jpg) - -5. 「Android アプリへの Firebase の追加 (Add Firebase to your Android app)」ウィンドウで、**「続行」**をクリックして、**「終了 (Finish)」**をクリックします。 - - - -アプリケーションをビルドして、実行します。 - -## Android アプリ用の Push SDK の初期化 -{: #android_initialize} - -初期化コードを配置する一般的な場所は、Android アプリケーション内のメインアクティビティーの onCreate メソッド内です。初期化を必要とする SDK のコンポーネントが 2 つあります。1 つは Core SDK であり、もう 1 つは Core SDK の上にビルドされた Push SDK です。 - -###Core SDK を初期化します。 - -``` -// Initialize the SDK for Android - BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); -``` - {: codeblock} - -####bluemixRegionSuffix -{: bluemixRegionSuffix} - -アプリがホストされている場所を指定します。次の 3 つの値のいずれかを使用できます。 - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -###クライアント Push SDK を初期化します。 - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext(), "appGUID", "clientSecret"); -``` - {: codeblock} - -####AppGUID -{: appguid_initialize_client_push_sdk} - -これは、{{site.data.keyword.mobilepushshort}}サービスの AppGUID キーです。この値では、大/小文字が区別されます。「Push Notification」ダッシュボードを開き、「構成」タブを選択します。「Push Notification」サービス・ダッシュボード上の「構成」タブの「モバイル・オプション」から、この値を取得できます。 - -## Android デバイスの登録 -{: #android_register} - -`MFPPush.register()` API を使用して、デバイスを{{site.data.keyword.mobilepushshort}}サービスに登録します。Android デバイスを登録するには、Firebase Cloud Messaging (FCM) または Google Cloud Messaging (GCM) の情報を、Bluemix {{site.data.keyword.mobilepushshort}} サービス構成ダッシュボードに追加します。詳しくは、[Google Cloud Messaging の資格情報の構成](t_push_provider_android.html)を参照してください。 - -以下のコード・スニペットを Android モバイル・アプリケーションにコピーします。 - -``` - //Register Android devices - push.registerDevice(new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - {: codeblock} - - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` - {: codeblock} - -## Android デバイスでのプッシュ通知の受け取り -{: #android_receive} - -notificationListener オブジェクトを Push に登録するには、**MFPPush.listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドから呼び出されます。 - -1. notificationListener オブジェクトを Push に登録するには、**listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドおよび **onPause** メソッドから呼び出されます。 - - -``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` - {: codeblock} - - - -``` - @Override - protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} - -2. プロジェクトをビルドし、デバイスまたはエミュレーター上で実行します。register() メソッド内で応答リスナーに対する onSuccess() メソッドが呼び出されたら、デバイスは{{site.data.keyword.mobilepushshort}}サービスに正常に登録されていると確定されます。この時点で、『基本プッシュ通知の送信』に説明されている方法でメッセージを送信できます。 -3. デバイスが通知を受信していることを確認します。アプリケーションがフォアグラウンドにある場合は、通知は **MFPPushNotificationListener** により処理されます。アプリケーションがバックグラウンドにある場合は、メッセージが通知バーに表示されます。 - -## Android デバイスでのプッシュ通知のモニター -{: #android_monitor} - -アプリケーション内で通知の現在の状況をモニターするには、`com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` インターフェースを実装し、メソッド onStatusChange(String messageId, MFPPushNotificationStatus status) を定義します。 - -**messageId** は、サーバーから送信されたメッセージの ID です。**MFPPushNotificationStatus** は、以下のように、通知の状況を値として定義します。 - -- **RECEIVED** - アプリは通知を受信済みです。 -- **QUEUED** - アプリは通知リスナーを呼び出すために、通知をキューに入れました。 -- **OPENED** - ユーザーが、トレイ内の通知をクリックするか、アプリ・アイコンから起動するか、またはアプリがフォアグラウンドにあるときに起動して、通知を開きました。 -- **DISMISSED** - ユーザーがトレイ内の通知をクリアまたは破棄しました。 - -**com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** クラスを MFPPush に登録する必要があります。 - -``` - push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { - @Override - public void onStatusChange(String messageId, MFPPushNotificationStatus status) { - // Handle status change - } - }); -``` - {: codeblock} - - -### DISMISSED 状況の listen - -以下のいずれかの条件に基づいて DISMISSED 状況を listen することを選択できます。 - -- アプリがアクティブのとき (フォアグラウンドまたはバックグラウンドで実行中) - - 次のスニペットを `AndroidManifest.xml` ファイルに追加します。 - -``` - - - - - -``` - {: codeblock} - -- アプリがアクティブのとき (フォアグラウンドまたはバックグラウンドで実行中) と未実行 (クローズ済み) のときの両方 - -**com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** ブロードキャスト・レシーバーを拡張して、メソッド **onReceive()** をオーバーライドする必要があります。ここで、**MFPPushNotificationStatusListener** は、基本クラスのメソッド **onReceive()** を呼び出す前に登録しておく必要があります。 - -``` - public class MyDismissHandler extends MFPPushNotificationDismissHandler { - @Override - public void onReceive(Context context, Intent intent) { - MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { - @Override - public void onStatusChange(String messageId, MFPPushNotificationStatus status) { - // Handle status change - } - }); - super.onReceive(context, intent); - } - } -``` - {: codeblock} - - -以下のスニペットを `AndroidManifest.xml` ファイルに追加します。 - -``` - - - - - -``` - {: codeblock} - -## 基本{{site.data.keyword.mobilepushshort}}の送信 -{: #send} - -アプリケーションの開発が完了したら、基本プッシュ通知を送信できます。 - -基本プッシュ通知を送信するには、以下の手順を実行します。 - -1. **「通知の送信 (Send Notifications)」**を選択し、**「送信先 (Send To)」**オプションを選択することでメッセージを構成します。サポートされるオプションは、**「タグ指定によるデバイス (Device by Tag)」**、**「デバイス ID (Device Id)」**、**「ユーザー ID」**、**「Android デバイス (Android devices)」**、**「iOS デバイス (iOS devices)」**、**「Web 通知 (Web Notifications)」**、および**「すべてのデバイス」**です。 -**注**: **「すべてのデバイス」**オプションを選択すると、{{site.data.keyword.mobilepushshort}}をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 -![「通知」画面](images/tag_notification.jpg) - -2. **「メッセージ」**フィールドで、メッセージを構成します。必要に応じてオプションの設定を構成してください。 -3. **「送信」**をクリックします。 -3. デバイスが通知を受信していることを確認します。 - -次のスクリーン・ショットは、Android デバイスのフォアグラウンドでプッシュ通知を処理しているアラート・ボックスを示しています。 - -![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) - -次のスクリーン・ショットは、Android のバックグラウンドでのプッシュ通知を示しています。 - -![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) - -### 通知を送信するためのオプションの Android 設定 -{: #send_otpional_setting} - -Android デバイスに通知を送信するための{{site.data.keyword.mobilepushshort}}設定をさらに詳細にカスタマイズできます。以下の任意指定のカスタマイズ・オプションがサポートされます。 -![Android カスタム設定](images/android_custom_settings.jpg) - -- **省略キー (Collapse Key)**: 省略キーは通知にアタッチされます。デバイスがオフラインのときに、同じ省略キーを持つ複数の通知が連続して到着すると、それらは省略されます。デバイスがオンラインになると、FCM/GCM サーバーから通知を受け取り、同じ省略キーを持つ最新の通知のみを表示します。省略キーが設定されていない場合、新しいメッセージと古いメッセージの両方が将来の配信のために保管されます。 -- **音 (Sound)**: 通知の受信時に音声クリップを再生するかどうかを示します。デフォルト、またはアプリにバンドルされている音声リソースの名前がサポートされます。 -- **アイコン (Icon)**: 通知用に表示されるアイコンの名前を指定します。クライアント・アプリケーションを使用して、アイコンを res/drawable フォルダーにパッケージしてあることを確認してください。 -- **優先度 (Priority)**: メッセージに配信の優先度を割り当てるためのオプションを指定します。`high` または `max` の優先度は注意喚起の通知になり、一方、`low` または `default` の優先度のメッセージは、スリープ中デバイスに対してネットワーク接続を開きません。このオプションが `min` に設定されたメッセージの場合、サイレント通知になります。 -- **可視性 (Visibility)**: 通知の可視性オプションは `public` または `private` のいずれかに設定できます。`private` オプションにすると、公開表示は制限されます。デバイスが PIN またはパターンによって保護されており、通知設定が「機密の通知内容を隠す (Hide sensitive notification content)」に設定されている場合は、公開表示を有効にするように選択できます。可視性を `private` に設定する場合は、「redact」フィールドの指定が必要です。 -「redact」フィールドに指定された内容のみが、保護されてロックされているデバイスの画面に表示されます。`public` を選択すると、通知は自由に読み取りされる状態になります。 -- **存続時間**: この値は秒単位で設定します。このパラメーターを指定しないと、FCM/GCM サーバーはメッセージを 4 週間保管し、配信を試行します。4 週間が経過すると、有効期限が切れます。可能な値の範囲は、0 から 2,419,200 秒です。 -- **アイドル時は遅延 (Delay when idle)**: デバイスがアイドル状態の場合、通知を配信しないように FCM/GCM サーバーに指示するには、この値を `true` に設定します。デバイスがアイドル状態であっても通知を配信できるようにするには、この値を `false` に設定します。 -- **同期**: このオプションを `true` に設定すると、ユーザーのすべての登録済みデバイス間で通知が同期化されます。あるユーザー名を持つユーザーが、同じアプリケーションがインストールされている複数のデバイスを所持している場合、1 台のデバイスで通知を読むと、その他のデバイスの通知は削除されます。 -このオプションが機能するためには、ユーザーが userId を指定して -{{site.data.keyword.mobilepushshort}}サービスに登録されていることを確認する必要があります。 -- **追加のペイロード (Additional payload)**: 通知用のカスタム・ペイロードの値を指定します。 - - -## 次のステップ -{: #next_steps_tags} - -基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 - -以下の Push Notifications Service の機能を、ご使用のアプリに追加します。 -タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。 -拡張通知オプションを使用する場合は、[拡張プッシュ通知の使用可能化](t_advance_badge_sound_payload.html)を参照してください。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Android アプリケーションによる{{site.data.keyword.mobilepushshort}}受け取りの可能化 +{: #tag_based_notifications} +最終更新日: 2017 年 2 月 14 日 +{: .last-updated} + +Android アプリケーションでデバイスへのプッシュ通知を受け取れるようにすることができます。Android Studio が前提条件であり、Android プロジェクトをビルドするための推奨方式です。Android Studio の基本知識が必要です。 + +## Gradle を使用したクライアント Push SDK のインストール +{: #android_install} + +このセクションでは、Android アプリケーションをさらに開発するためにクライアント Push SDK をインストールして使用する方法について説明します。 + +Bluemix® Mobile Services Push SDK は、Gradle を使用して追加できます。Gradle は自動的に成果物をリポジトリーからダウンロードして、Android アプリケーションで使用できるようにします。Android Studio および Android Studio SDK が正しくセットアップされていることを確認してください。システムのセットアップ方法について詳しくは、[Android Studio の概要![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.android.com/tools/studio/index.html){: new_window}を参照してください。Gradle について詳しくは、[Gradle でのビルドの構成に関する資料![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}を参照してください。 + +モバイル・アプリケーションを作成して開いてから、Android Studio を使用して以下の手順を実行します。 + +1. モジュール・レベルの **build.gradle** ファイルに、依存関係を追加します。 + + - 以下の依存関係を追加して、Bluemix™ Mobile サービスの Push クライアント SDK と Google Play サービス SDK を、コンパイル有効範囲の依存関係に含めます。 + ``` + com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ + ``` + {: codeblock} + + - コード・スニペットに必要なインポート・ステートメントに、以下の依存関係を追加します。 + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + {: codeblock} + + - 次の依存関係をモジュール・レベルの **build.gradle** ファイルの最後に追加します。 + ``` + apply plugin: 'com.google.gms.google-services' + ``` + {: codeblock} +3. プロジェクト・レベルの **build.gradle** ファイルに、以下の依存関係を追加します。 +``` +dependencies { + classpath 'com.android.tools.build:gradle:2.2.3' + classpath 'com.google.gms:google-services:3.0.0' +} +``` + {: codeblock} +5. **AndroidManifest.xml** ファイルに、以下のアクセス権を追加します。サンプル・マニフェストを表示するには、[Android helloPush のサンプル・アプリケーション![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}を参照してください。サンプル Gradle ファイルを表示するには、[サンプルの Build Gradle ファイル![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}を参照してください。 +``` + + + + + +``` + {: codeblock} +ここをクリックすると、[Android のパーミッション![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](http://developer.android.com/guide/topics/security/permissions.html){: new_window}の詳細情報が表示されます。 + +4. アクティビティーの通知インテント設定を追加します。この設定により、ユーザーが通知エリアで受信した通知をクリックすると、アプリケーションが開始します。 +``` + + + + +``` + {: codeblock} +**注**: 上記のアクション内の *Your_Android_Package_Name* を、アプリケーションで使用されているアプリケーション・パッケージ名に置き換えてください。 + +5. RECEIVE および REGISTRATION のイベント通知用に、Firebase Cloud Messaging (FCM) または Google Cloud Messaging (GCM) のインテント・サービスとインテント・フィルターを追加します。 +``` + + + + + + + + + + +``` + {: codeblock} + +6. {{site.data.keyword.mobilepushshort}} サービスは、通知トレイからの個々の通知の取り出しをサポートします。通知トレイから通知にアクセスする場合、クリックしている通知のみへのハンドルが提供されます。アプリケーションを通常どおりに開いた場合は、すべての通知が表示されます。この機能を使用するには、以下のスニペットを使用して **AndroidManifest.xml** ファイルを更新します。 + +``` + +``` + {: codeblock} + +FCM プロジェクトのセットアップおよび資格情報の取得については、[送信側 ID と API キーの取得](t_push_provider_android.html)を参照してください。Firebase Cloud Messaging (FCM) コンソールを使用して、以下の手順を実行します。 + +1. Firebase コンソールで、**「Project Settings (プロジェクト設定)」** アイコンをクリックします。 + ![Firebase のプロジェクト設定](images/FCM_4.jpg) + +3. アプリケーション・ペインの「General (一般)」タブから、**「ADD APP」**または**「Android アプリへの Firebase の追加 (Add Firebase to your Android app)」アイコン**を選択します。 + ![Android への Firebase の追加](images/FCM_5.jpg) + +4. 「Android アプリへの Firebase の追加 (Add Firebase to your Android app)」ウィンドウで、パッケージ名として **com.ibm.mobilefirstplatform.clientsdk.android.push** を追加します。「アプリのニックネーム (App nickname)」フィールドはオプションです。**「ADD APP」**をクリックします。 + ![「Android への Firebase の追加」ウィンドウ](images/FCM_1.jpg) + +5. 「Android アプリへの Firebase の追加 (Add Firebase to your Android app)」ウィンドウにパッケージ名を入力して、アプリケーションのパッケージ名を組み込みます。「アプリのニックネーム (App nickname)」フィールドはオプションです。**「ADD APP」**をクリックします。 + + ![アプリケーションのパッケージ名の追加](images/FCM_2.jpg) + +6. `google-services.json` ファイルが生成されます。`google-services.json` ファイルを Android アプリケーション・モジュールのルート・ディレクトリーにコピーします。この `google-service.json` ファイルには、追加されたパッケージ名が含まれていることに注意してください。 + + ![アプリケーションのルート・ディレクトリーへの json ファイルの追加](images/FCM_7.jpg) + +5. 「Android アプリへの Firebase の追加 (Add Firebase to your Android app)」ウィンドウで、**「続行」**をクリックして、**「終了 (Finish)」**をクリックします。 + + + +アプリケーションをビルドして、実行します。 + +## Android アプリ用の Push SDK の初期化 +{: #android_initialize} + +初期化コードを配置する一般的な場所は、Android アプリケーション内のメインアクティビティーの onCreate メソッド内です。初期化を必要とする SDK のコンポーネントが 2 つあります。1 つは Core SDK であり、もう 1 つは Core SDK の上にビルドされた Push SDK です。 + +### Core SDK を初期化します。 + +``` +// Initialize the SDK for Android + BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); +``` + {: codeblock} + +#### bluemixRegionSuffix +{: bluemixRegionSuffix} + +アプリがホストされている場所を指定します。次の 3 つの値のいずれかを使用できます。 + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +### クライアント Push SDK を初期化します。 + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext(), "appGUID", "clientSecret"); +``` + {: codeblock} + +#### AppGUID +{: appguid_initialize_client_push_sdk} + +これは、{{site.data.keyword.mobilepushshort}}サービスの AppGUID キーです。この値では、大/小文字が区別されます。「Push Notification」ダッシュボードを開き、「構成」タブを選択します。「Push Notification」サービス・ダッシュボード上の「構成」タブの「モバイル・オプション」から、この値を取得できます。 + +## Android デバイスの登録 +{: #android_register} + +`MFPPush.register()` API を使用して、デバイスを{{site.data.keyword.mobilepushshort}}サービスに登録します。Android デバイスを登録するには、Firebase Cloud Messaging (FCM) または Google Cloud Messaging (GCM) の情報を、Bluemix {{site.data.keyword.mobilepushshort}} サービス構成ダッシュボードに追加します。詳しくは、[Google Cloud Messaging の資格情報の構成](t_push_provider_android.html)を参照してください。 + +以下のコード・スニペットを Android モバイル・アプリケーションにコピーします。 + +``` + //Register Android devices + push.registerDevice(new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + {: codeblock} + + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` + {: codeblock} + +## Android デバイスでのプッシュ通知の受け取り +{: #android_receive} + +notificationListener オブジェクトを Push に登録するには、**MFPPush.listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドから呼び出されます。 + +1. notificationListener オブジェクトを Push に登録するには、**listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドおよび **onPause** メソッドから呼び出されます。 + + +``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` + {: codeblock} + + + +``` + @Override + protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} + +2. プロジェクトをビルドし、デバイスまたはエミュレーター上で実行します。register() メソッド内で応答リスナーに対する onSuccess() メソッドが呼び出されたら、デバイスは{{site.data.keyword.mobilepushshort}}サービスに正常に登録されていると確定されます。この時点で、『基本プッシュ通知の送信』に説明されている方法でメッセージを送信できます。 +3. デバイスが通知を受信していることを確認します。アプリケーションがフォアグラウンドにある場合は、通知は **MFPPushNotificationListener** により処理されます。アプリケーションがバックグラウンドにある場合は、メッセージが通知バーに表示されます。 + +## Android デバイスでのプッシュ通知のモニター +{: #android_monitor} + +アプリケーション内で通知の現在の状況をモニターするには、`com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` インターフェースを実装し、メソッド onStatusChange(String messageId, MFPPushNotificationStatus status) を定義します。 + +**messageId** は、サーバーから送信されたメッセージの ID です。**MFPPushNotificationStatus** は、以下のように、通知の状況を値として定義します。 + +- **RECEIVED** - アプリは通知を受信済みです。 +- **QUEUED** - アプリは通知リスナーを呼び出すために、通知をキューに入れました。 +- **OPENED** - ユーザーが、トレイ内の通知をクリックするか、アプリ・アイコンから起動するか、またはアプリがフォアグラウンドにあるときに起動して、通知を開きました。 +- **DISMISSED** - ユーザーがトレイ内の通知をクリアまたは破棄しました。 + +**com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** クラスを MFPPush に登録する必要があります。 + +``` + push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { + @Override + public void onStatusChange(String messageId, MFPPushNotificationStatus status) { + // Handle status change + } + }); +``` + {: codeblock} + + +### DISMISSED 状況の listen + +以下のいずれかの条件に基づいて DISMISSED 状況を listen することを選択できます。 + +- アプリがアクティブのとき (フォアグラウンドまたはバックグラウンドで実行中) + + 次のスニペットを `AndroidManifest.xml` ファイルに追加します。 + +``` + + + + + +``` + {: codeblock} + +- アプリがアクティブのとき (フォアグラウンドまたはバックグラウンドで実行中) と未実行 (クローズ済み) のときの両方 + +**com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** ブロードキャスト・レシーバーを拡張して、メソッド **onReceive()** をオーバーライドする必要があります。ここで、**MFPPushNotificationStatusListener** は、基本クラスのメソッド **onReceive()** を呼び出す前に登録しておく必要があります。 + +``` + public class MyDismissHandler extends MFPPushNotificationDismissHandler { + @Override + public void onReceive(Context context, Intent intent) { + MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { + @Override + public void onStatusChange(String messageId, MFPPushNotificationStatus status) { + // Handle status change + } + }); + super.onReceive(context, intent); + } + } +``` + {: codeblock} + + +以下のスニペットを `AndroidManifest.xml` ファイルに追加します。 + +``` + + + + + +``` + {: codeblock} + +## 基本{{site.data.keyword.mobilepushshort}}の送信 +{: #send} + +アプリケーションの開発が完了したら、基本プッシュ通知を送信できます。 + +基本プッシュ通知を送信するには、以下の手順を実行します。 + +1. **「通知の送信 (Send Notifications)」**を選択し、**「送信先 (Send To)」**オプションを選択することでメッセージを構成します。サポートされるオプションは、**「タグ指定によるデバイス (Device by Tag)」**、**「デバイス ID (Device Id)」**、**「ユーザー ID」**、**「Android デバイス (Android devices)」**、**「iOS デバイス (iOS devices)」**、**「Web 通知 (Web Notifications)」**、および**「すべてのデバイス」**です。 +**注**: **「すべてのデバイス」**オプションを選択すると、{{site.data.keyword.mobilepushshort}}をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 +![「通知」画面](images/tag_notification.jpg) + +2. **「メッセージ」**フィールドで、メッセージを構成します。必要に応じてオプションの設定を構成してください。 +3. **「送信」**をクリックします。 +3. デバイスが通知を受信していることを確認します。 + +次のスクリーン・ショットは、Android デバイスのフォアグラウンドでプッシュ通知を処理しているアラート・ボックスを示しています。 + +![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) + +次のスクリーン・ショットは、Android のバックグラウンドでのプッシュ通知を示しています。 + +![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) + +### 通知を送信するためのオプションの Android 設定 +{: #send_otpional_setting} + +Android デバイスに通知を送信するための{{site.data.keyword.mobilepushshort}}設定をさらに詳細にカスタマイズできます。以下の任意指定のカスタマイズ・オプションがサポートされます。 +![Android カスタム設定](images/android_custom_settings.jpg) + +- **省略キー (Collapse Key)**: 省略キーは通知にアタッチされます。デバイスがオフラインのときに、同じ省略キーを持つ複数の通知が連続して到着すると、それらは省略されます。デバイスがオンラインになると、FCM/GCM サーバーから通知を受け取り、同じ省略キーを持つ最新の通知のみを表示します。省略キーが設定されていない場合、新しいメッセージと古いメッセージの両方が将来の配信のために保管されます。 +- **音 (Sound)**: 通知の受信時に音声クリップを再生するかどうかを示します。デフォルト、またはアプリにバンドルされている音声リソースの名前がサポートされます。 +- **アイコン (Icon)**: 通知用に表示されるアイコンの名前を指定します。クライアント・アプリケーションを使用して、アイコンを res/drawable フォルダーにパッケージしてあることを確認してください。 +- **優先度 (Priority)**: メッセージに配信の優先度を割り当てるためのオプションを指定します。`high` または `max` の優先度は注意喚起の通知になり、一方、`low` または `default` の優先度のメッセージは、スリープ中デバイスに対してネットワーク接続を開きません。このオプションが `min` に設定されたメッセージの場合、サイレント通知になります。 +- **可視性 (Visibility)**: 通知の可視性オプションは `public` または `private` のいずれかに設定できます。`private` オプションにすると、公開表示は制限されます。デバイスが PIN またはパターンによって保護されており、通知設定が「機密の通知内容を隠す (Hide sensitive notification content)」に設定されている場合は、公開表示を有効にするように選択できます。可視性を `private` に設定する場合は、「redact」フィールドの指定が必要です。 +「redact」フィールドに指定された内容のみが、保護されてロックされているデバイスの画面に表示されます。`public` を選択すると、通知は自由に読み取りされる状態になります。 +- **存続時間**: この値は秒単位で設定します。このパラメーターを指定しないと、FCM/GCM サーバーはメッセージを 4 週間保管し、配信を試行します。4 週間が経過すると、有効期限が切れます。可能な値の範囲は、0 から 2,419,200 秒です。 +- **アイドル時は遅延 (Delay when idle)**: デバイスがアイドル状態の場合、通知を配信しないように FCM/GCM サーバーに指示するには、この値を `true` に設定します。デバイスがアイドル状態であっても通知を配信できるようにするには、この値を `false` に設定します。 +- **同期**: このオプションを `true` に設定すると、ユーザーのすべての登録済みデバイス間で通知が同期化されます。あるユーザー名を持つユーザーが、同じアプリケーションがインストールされている複数のデバイスを所持している場合、1 台のデバイスで通知を読むと、その他のデバイスの通知は削除されます。 +このオプションが機能するためには、ユーザーが userId を指定して +{{site.data.keyword.mobilepushshort}}サービスに登録されていることを確認する必要があります。 +- **追加のペイロード (Additional payload)**: 通知用のカスタム・ペイロードの値を指定します。 + + +## 次のステップ +{: #next_steps_tags} + +基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 + +以下の Push Notifications Service の機能を、ご使用のアプリに追加します。 +タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。 +拡張通知オプションを使用する場合は、[拡張プッシュ通知の使用可能化](t_advance_badge_sound_payload.html)を参照してください。 diff --git a/services/mobilepush/nl/ja/c_chrome_firefox_enable.md b/services/mobilepush/nl/ja/c_chrome_firefox_enable.md index dd8e9cbd2..e463ab9d8 100644 --- a/services/mobilepush/nl/ja/c_chrome_firefox_enable.md +++ b/services/mobilepush/nl/ja/c_chrome_firefox_enable.md @@ -1,131 +1,131 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Web アプリケーションによる {{site.data.keyword.mobilepushshort}} の受信の使用可能化 -{: #web_notifications} -最終更新日: 2017 年 2 月 16 日 -{: .last-updated} - -Google Chrome、Mozilla Firefox、および Safari の Web アプリケーションによる {{site.data.keyword.mobilepushshort}} の受信を可能にすることができます。以下のステップに進む前に、[通知プロバイダーの資格情報の構成](t__main_push_config_provider.html)を確実に実行してください。 - -## {{site.data.keyword.mobilepushshort}}用の Web ブラウザー・クライアント SDK のインストール -{: #web_install} - -このトピックでは、Web アプリケーションの開発を促進するためにクライアント JavaScript Push SDK をインストールして使用する方法について説明します。 - -### Web アプリケーションの初期化 - -Google Chrome Web アプリケーションに Javascript SDK をインストールする場合、以下の手順を実行します。 - -[Bluemix Web push SDK](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window} から、`BMSPushSDK.js`、`BMSPushServiceWorker.js`、および `manifest_Website.json` の各ファイルをダウンロードします。 - -1. `manifest_Website.json` ファイルを編集します。 - - Google Chrome ブラウザーの場合、`name` を、ご使用のサイトの名前に変更します。例えば、`www.dailynewsupdates.com` とします。`gcm_sender_id` を、Firebase Cloud Messaging (FCM) または Google Cloud Messaging (GCM) の送信側_ID に変更します。詳しくは、[送信側 ID と API キーの取得](t_push_provider_android.html)を参照してください。gcm_sender_id 値には数値のみが含まれます。 - - ``` - { - "name": "YOUR_WEBSITE_NAME", - "gcm_sender_id": "GCM_Sender_Id" - } - ``` - {: codeblock} - - - Mozilla Firefox ブラウザーの場合、以下の値を `manifest_Website.json` ファイルに追加します。適切な `name` を入力します。これは、ご使用の Web サイトの名前にすることができます。 - - ``` - { - "name": "YOUR_WEBSITE_NAME" - } - ``` - {: codeblock} - -2. `manifest_Website.json` ファイル名を `manifest.json` に変更します。 -3. `BMSPushSDK.js`、`BMSPushServiceWorker.js`、および `manifest.json` を Web サイトのルート・ディレクトリーに追加します。 -3. `manifest.json` を html ファイルの `` タグに組み込みます。 - ``` - - ``` - {: codeblock} -4. Bluemix Web プッシュ SDK を Web アプリケーションに組み込みます。 - ``` - - ``` - {: codeblock} - -**注**: コードのデプロイおよびサンプル・リンクのアクセスは、必ず `http` ではなく `https` を使用して行うようにしてください。 - -## Web Push SDK の初期化 -{: #web_initialize} - -Bluemix {{site.data.keyword.mobilepushshort}} サービスの `app GUID` と `app Region` を使用して Push SDK を初期化します。 - -app GUID を入手するには、初期化されたプッシュ・サービスのナビゲーション・ペインで**「構成」**オプションを選択し、**「モバイル・オプション」**をクリックします。Bluemix のプッシュ通知サービス appGUID パラメーターを使用するようにコード・スニペットを変更します。 - -`App Region` は、{{site.data.keyword.mobilepushshort}}サービスがホストされる場所を指定します。次の 3 つの値のいずれかを使用できます。 - - - 米国のダラス: `.ng.bluemix.net` - - 英国: `.eu-gb.bluemix.net` - - シドニー: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(initParams, callback) -``` - {: codeblock} - -**注**: Web push SDK の FCM 資格情報が変更された場合、Chrome ブラウザーのメッセージ送信が失敗する可能性があります。失敗しないようにするために、必ず `bmsPush.unRegisterDevice` を呼び出してください。 - -誤ったパラメーターを指定すると、構成に関連したエラーが表示される可能性があります。詳細については、[Web プッシュ構成エラーの解決](troubleshooting_config_errors.html)を参照してください。 - -## Web アプリケーションの登録 -{: #web_register} - -**register()** API を使用して、デバイスを{{site.data.keyword.mobilepushshort}}サービスに登録します。ブラウザーに応じて、以下のいずれかのオプションを使用してください。 - -- Google Chrome から登録する場合、Firebase Cloud Messaging (FCM) または Google Cloud Messaging (GCM) の API キーと Web サイト URL を、Bluemix {{site.data.keyword.mobilepushshort}} サービス Web 構成ダッシュボードに追加します。詳しくは、[Google Cloud Messaging の資格情報の構成](t_push_provider_android.html)で Chrome 用のセットアップを参照してください。 - -- Mozilla Firefox から登録する場合は、Web サイト URL を Bluemix {{site.data.keyword.mobilepushshort}}サービスの Web 構成ダッシュボードで Firefox 用セットアップの下に追加してください。 - -以下のコード・スニペットを使用して、 Bluemix {{site.data.keyword.mobilepushshort}}サービスに登録します。 - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Web アプリケーションによる {{site.data.keyword.mobilepushshort}} の受信の使用可能化 +{: #web_notifications} +最終更新日: 2017 年 2 月 16 日 +{: .last-updated} + +Google Chrome、Mozilla Firefox、および Safari の Web アプリケーションによる {{site.data.keyword.mobilepushshort}} の受信を可能にすることができます。以下のステップに進む前に、[通知プロバイダーの資格情報の構成](t__main_push_config_provider.html)を確実に実行してください。 + +## {{site.data.keyword.mobilepushshort}}用の Web ブラウザー・クライアント SDK のインストール +{: #web_install} + +このトピックでは、Web アプリケーションの開発を促進するためにクライアント JavaScript Push SDK をインストールして使用する方法について説明します。 + +### Web アプリケーションの初期化 + +Google Chrome Web アプリケーションに Javascript SDK をインストールする場合、以下の手順を実行します。 + +[Bluemix Web push SDK](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window} から、`BMSPushSDK.js`、`BMSPushServiceWorker.js`、および `manifest_Website.json` の各ファイルをダウンロードします。 + +1. `manifest_Website.json` ファイルを編集します。 + - Google Chrome ブラウザーの場合、`name` を、ご使用のサイトの名前に変更します。例えば、`www.dailynewsupdates.com` とします。`gcm_sender_id` を、Firebase Cloud Messaging (FCM) または Google Cloud Messaging (GCM) の送信側_ID に変更します。詳しくは、[送信側 ID と API キーの取得](t_push_provider_android.html)を参照してください。gcm_sender_id 値には数値のみが含まれます。 + + ``` + { + "name": "YOUR_WEBSITE_NAME", + "gcm_sender_id": "GCM_Sender_Id" + } + ``` + {: codeblock} + + - Mozilla Firefox ブラウザーの場合、以下の値を `manifest_Website.json` ファイルに追加します。適切な `name` を入力します。これは、ご使用の Web サイトの名前にすることができます。 + + ``` + { + "name": "YOUR_WEBSITE_NAME" + } + ``` + {: codeblock} + +2. `manifest_Website.json` ファイル名を `manifest.json` に変更します。 +3. `BMSPushSDK.js`、`BMSPushServiceWorker.js`、および `manifest.json` を Web サイトのルート・ディレクトリーに追加します。 +3. `manifest.json` を html ファイルの `` タグに組み込みます。 + ``` + + ``` + {: codeblock} +4. Bluemix Web プッシュ SDK を Web アプリケーションに組み込みます。 + ``` + + ``` + {: codeblock} + +**注**: コードのデプロイおよびサンプル・リンクのアクセスは、必ず `http` ではなく `https` を使用して行うようにしてください。 + +## Web Push SDK の初期化 +{: #web_initialize} + +Bluemix {{site.data.keyword.mobilepushshort}} サービスの `app GUID` と `app Region` を使用して Push SDK を初期化します。 + +app GUID を入手するには、初期化されたプッシュ・サービスのナビゲーション・ペインで**「構成」**オプションを選択し、**「モバイル・オプション」**をクリックします。Bluemix のプッシュ通知サービス appGUID パラメーターを使用するようにコード・スニペットを変更します。 + +`App Region` は、{{site.data.keyword.mobilepushshort}}サービスがホストされる場所を指定します。次の 3 つの値のいずれかを使用できます。 + + - 米国のダラス: `.ng.bluemix.net` + - 英国: `.eu-gb.bluemix.net` + - シドニー: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(initParams, callback) +``` + {: codeblock} + +**注**: Web push SDK の FCM 資格情報が変更された場合、Chrome ブラウザーのメッセージ送信が失敗する可能性があります。失敗しないようにするために、必ず `bmsPush.unRegisterDevice` を呼び出してください。 + +誤ったパラメーターを指定すると、構成に関連したエラーが表示される可能性があります。詳細については、[Web プッシュ構成エラーの解決](troubleshooting_config_errors.html)を参照してください。 + +## Web アプリケーションの登録 +{: #web_register} + +**register()** API を使用して、デバイスを{{site.data.keyword.mobilepushshort}}サービスに登録します。ブラウザーに応じて、以下のいずれかのオプションを使用してください。 + +- Google Chrome から登録する場合、Firebase Cloud Messaging (FCM) または Google Cloud Messaging (GCM) の API キーと Web サイト URL を、Bluemix {{site.data.keyword.mobilepushshort}} サービス Web 構成ダッシュボードに追加します。詳しくは、[Google Cloud Messaging の資格情報の構成](t_push_provider_android.html)で Chrome 用のセットアップを参照してください。 + +- Mozilla Firefox から登録する場合は、Web サイト URL を Bluemix {{site.data.keyword.mobilepushshort}}サービスの Web 構成ダッシュボードで Firefox 用セットアップの下に追加してください。 + +以下のコード・スニペットを使用して、 Bluemix {{site.data.keyword.mobilepushshort}}サービスに登録します。 + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + + + diff --git a/services/mobilepush/nl/ja/c_chrome_firefox_enable_send.md b/services/mobilepush/nl/ja/c_chrome_firefox_enable_send.md index f4eae8438..717844a67 100644 --- a/services/mobilepush/nl/ja/c_chrome_firefox_enable_send.md +++ b/services/mobilepush/nl/ja/c_chrome_firefox_enable_send.md @@ -1,44 +1,44 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Web ブラウザーへの基本通知の送信 -{: #web_notifications} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - -アプリケーションの開発が完了したら、プッシュ通知を送信できます。 - -1. **「通知の送信 (Send Notifications)」**を選択し、**「送信先 (Send To)」**オプションとして**「Web 通知 (Web Notifications)」**を選択することでメッセージを構成します。 -2. **「メッセージ」**フィールドに、配信する必要があるメッセージを入力します。 -3. 以下のオプションの設定を指定することを選択できます。 - - **通知タイトル (Notification Title)**: メッセージ・アラートの見出しとして表示されるテキストです。 - - **通知アイコン URL (Notification Icon URL)**: メッセージにアプリ通知アイコンを付けて配信する必要がある場合、このフィールドにアイコンへのリンクを指定します。 - - **存続時間 (Time to live)**: メッセージの有効期間をサーバーに通知します。 -4. Safari ブラウザーに送信される Web 通知の場合、以下のようにいくつかの追加情報が必要です。 - - **アクション (Action)**: これは、アクション・ボタンのラベルです。 - - **URL 引数 (URL Arguments)**: この通知で使用する必要がある URL 引数。これは、必ず JSON 配列形式で指定してください。 - -以下のイメージは、ダッシュボードの Web 通知オプションを示しています。 - - ![「通知」画面](images/DashboardWebpush.jpg) - - -## 次のステップ - {: #next_steps_tags} - -基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 - -{{site.data.keyword.mobilepushshort}}サービスの以下の機能をご使用のアプリに追加します。 - タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張通知](t_advance_badge_sound_payload.html)を参照してください。 - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Web ブラウザーへの基本通知の送信 +{: #web_notifications} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + +アプリケーションの開発が完了したら、プッシュ通知を送信できます。 + +1. **「通知の送信 (Send Notifications)」**を選択し、**「送信先 (Send To)」**オプションとして**「Web 通知 (Web Notifications)」**を選択することでメッセージを構成します。 +2. **「メッセージ」**フィールドに、配信する必要があるメッセージを入力します。 +3. 以下のオプションの設定を指定することを選択できます。 + - **通知タイトル (Notification Title)**: メッセージ・アラートの見出しとして表示されるテキストです。 + - **通知アイコン URL (Notification Icon URL)**: メッセージにアプリ通知アイコンを付けて配信する必要がある場合、このフィールドにアイコンへのリンクを指定します。 + - **存続時間 (Time to live)**: メッセージの有効期間をサーバーに通知します。 +4. Safari ブラウザーに送信される Web 通知の場合、以下のようにいくつかの追加情報が必要です。 + - **アクション (Action)**: これは、アクション・ボタンのラベルです。 + - **URL 引数 (URL Arguments)**: この通知で使用する必要がある URL 引数。これは、必ず JSON 配列形式で指定してください。 + +以下のイメージは、ダッシュボードの Web 通知オプションを示しています。 + + ![「通知」画面](images/DashboardWebpush.jpg) + + +## 次のステップ + {: #next_steps_tags} + +基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 + +{{site.data.keyword.mobilepushshort}}サービスの以下の機能をご使用のアプリに追加します。 + タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張通知](t_advance_badge_sound_payload.html)を参照してください。 + + + diff --git a/services/mobilepush/nl/ja/c_cordova_enable.md b/services/mobilepush/nl/ja/c_cordova_enable.md index 9b35b1c7b..65e6a0e4f 100644 --- a/services/mobilepush/nl/ja/c_cordova_enable.md +++ b/services/mobilepush/nl/ja/c_cordova_enable.md @@ -1,314 +1,314 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Cordova アプリケーションによるプッシュ通知受け取りの可能化 -{: #cordova_enable} -最終更新日: 2017 年 1 月 18 日 -{: .last-updated} - -Cordova は、JavaScript、CSS、および HTML を使用したハイブリッド・アプリケーションの構築用プラットフォームです。 -{{site.data.keyword.mobilepushshort}} サービスは、Cordova ベースの iOS アプリケーションおよび Android アプリケーションの開発をサポートします。 - -Cordova アプリケーションによる、デバイスでのプッシュ通知の受信を可能にすることができます。 - -## Cordova の Push プラグインのインストール -{: #cordova_install} - -Cordova アプリケーションをさらに開発するために、クライアントの Push プラグインをインストールして使用します。これにより、Bluemix への接続を初期化する Cordova の Core プラグインもインストールされます。 - -### 始めに - -1. 最新バージョンの Android Studio SDK と Xcode をダウンロードします。 -1. エミュレーターをセットアップします。Android Studio では、Google Play API をサポートするエミュレーターを使用します。 -1. Git のコマンド・ライン・ツールをインストールします。Windows では、必ず **「Windows コマンド・プロンプトから Git を実行する (Run Git from the Window Command Prompt)」**オプションを選択してください。このツールのダウンロードとインストールの方法については、[Git ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://git-scm.com/downloads){: new_window}を参照してください。 -1. Node.js と Node Package Manager (NPM) ツールをインストールします。NPM コマンド・ライン・ツールは Node.js とバンドルされています。Node.js のダウンロードとインストールの方法については、[Node.js ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://nodejs.org/en/download/){: new_window}を参照してください。 -1. コマンド・ラインから、**npm install -g cordova** コマンドを使用して、Cordova コマンド・ライン・ツールをインストールします。これは、Cordova の Push プラグインを使用するために必要です。Cordova をインストールして Cordova アプリをセットアップする方法については、[Cordova Apache ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://cordova.apache.org/#getstarted){: new_window}を参照してください。詳細については、Cordova プッシュ・プラグインの [README ファイル![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window}を参照してください。 -1. Cordova アプリを作成するフォルダーに移動し、次のコマンドを実行して Cordova アプリケーションを作成します。 -既存の Cordova アプリがある場合は、ステップ 3 に進みます。 -```cordova create your_app_name -cd your_app_name -``` - {: codeblock} -- オプション: **config.xml** ファイルを編集して、 エレメントのアプリケーション名を、デフォルトの HelloCordova という名前ではなく、自分で選択した名前に変更できます。 - -正しいバンドル ID を指定してください。誤ったバンドル ID を指定すると、Xcode で以下のエラー・メッセージが出されることがあります。 - -* 実行可能ファイルの署名に使用された資格が無効です (The executable was signed with invalid entitlements.) -* アプリケーションのコード署名資格ファイルに指定された資格が、プロビジョニング・プロファイルに指定された資格と一致しません (The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile.)この問題を修正するには、Xcode または Cordova アプリ **config.xml** ファイルに正しいバンドル ID を指定します。 - -1. サポートされる最低レベルの API またはデプロイメント・ターゲット (Deployment Target) の宣言を、Cordova アプリケーションの config.xml ファイルに追加します。minSdkVersion の値は、15 より高くなければなりません。targetSdkVersion の値は、常に、Google から入手可能な最新の Android SDK を反映している必要があります。 - - * Android - ご使用のエディターで **config.xml** ファイルを開き、以下のように、最低 SDK バージョンとターゲット SDK バージョンで `` エレメントを更新します。 - - ``` - - - - - - ``` - {: codeblock} - - * iOS - エレメントを、以下のデプロイメント・ターゲット宣言を使用して更新します。 - - ``` - - - - - ``` - {: codeblock} - -1. Cordova コマンド・ライン・インターフェース (CLI) から、以下のコマンドを使用して、プラットフォーム (iOS、Android、またはその両方) を追加します。 -``` -cordova platform add ios -cordova platform add android -``` - {: codeblock} - -1. Cordova アプリケーションのルート・ディレクトリーで、コマンド **cordova plugin add bms-push** を入力して Cordova の Push プラグインをインストールします。追加したプラットフォームに応じて、以下のような内容が表示されます。 -``` -Installing "bms-push" for android -Installing "bms-push" for ios -``` - {: codeblock} - -1. your-app-root-folder から、コマンド **cordova plugin list** を使用して、Cordova の Core および Push のプラグインが正常にインストールされたことを確認します。追加したプラットフォームに応じて、以下のような内容が表示されます。 -``` -bms-core "BMSCore" -bms-push "BMSPush" -``` - {: codeblock} - -1. iOS 開発環境を構成します。 -2. Xcode を使用してアプリケーションをビルドおよび実行します。 -1. Firebase `google-services.json` for android をダウンロードし、Cordova プロジェクトのルート・フォルダー、[your-app-name]/platforms/android に置きます。 - 1. `[your-app-name]/platforms/android` に移動します。 - 2. ファイル `build.gradle` (パス : platform > android > build.gradle) を開きます。 - 3. `build.gradle` ファイル内で `buildscript` テキストを検索します。 - 4. クラスパス行の後に、classpath 'com.google.gms:google-services:3.0.0' という行を追加します。 - 5. 次に、「dependencies」を検索します。`compile` というテキストがある場所の dependencies を選択します。そして、その dependencies が終了している場所のすぐ後に、次の行を追加します :apply plugin: 'com.google.gms.google-services'。 - 6. Cordova Android プロジェクトの準備とビルド - ``` - cordova prepare android - cordova build android - ``` - {: codeblock} - **注**: Android Studio でプロジェクトを開く前に、Cordova CLI を使用して Cordova アプリケーションをビルドしてください。これは、ビルド・エラーの回避に有効です。## Cordova プラグインの初期化 -{: #cordova_initialize} - -{{site.data.keyword.mobilepushshort}}サービスの Cordova プラグインを使用するには、事前に、アプリケーション経路とアプリケーション GUID を受け渡すことでプラグインを初期化しておく必要があります。プラグインを初期化したら、Bluemix ダッシュボードで作成したサーバー・アプリに接続することができます。Cordova プラグインは、Cordova アプリが Bluemix サービスと通信できるようにするための Android および iOS のクライアント SDK のラッパーです。 - -1. 以下のコード・スニペットをメイン JavaScript ファイル (通常、**www/js** ディレクトリーの下にある) にコピー・アンド・ペーストして、BMSClient を初期化します。 - -``` -onDeviceReady: function() {app.receivedEvent('deviceready'); - BMSClient.initialize("YOUR APP REGION"); - var category = {}; - BMSPush.initialize(appGUID,clientSecret,category); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); - } -``` - {: codeblock} - -アプリケーションの地域を受け渡します。以下の定数が提供されています。 - -``` -REGION_US_SOUTH // ".ng.bluemix.net"; -REGION_UK //".eu-gb.bluemix.net"; -REGION_SYDNEY // ".au-syd.bluemix.net"; -``` - -例えば、次のようにします。 - -``` -BMSClient.initialize(BMSClient.REGION_US_SOUTH); -``` - -**注**: Cordova CLI (例えば、Cordova の create app-name コマンド) を使用して Cordova アプリを作成した場合、この Javascript コードを index.js ファイルの onDeviceReady: function() 関数内の app.receivedEvent 関数の後に置いて、`BMSClient` を初期化します。 - - -## デバイスの登録 -{: #cordova_register} - - -デバイスを{{site.data.keyword.mobilepushshort}}サービスに登録するには、register メソッドを呼び出します。デバイスを登録するために、次のコード・スニペットを Cordova アプリケーションにコピーします。 - -``` -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); -``` - {: codeblock} - -以下の JavaScript コード・スニペットは、Bluemix Mobile Services クライアント SDK を初期化し、デバイスを{{site.data.keyword.mobilepushshort}}サービスに登録し、プッシュ通知を listen する方法を示しています。このコードを Javascript ファイルに組み込んでください。 - -コードは **onDeviceReady: function()** 内に置きます。 - -``` -onDeviceReady: function() { -app.receivedEvent('deviceready'); -BMSClient.initialize("YOUR APP REGION"); -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; -BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 - -``` -// Register the device token with Bluemix Push Notification Service -func application(application: UIApplication, - didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { - CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) -} -// Handle error when failed to register device token with APNs -func application(application: UIApplication, - didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) -} -``` - {: codeblock} - -##次のステップ - -{: #cordova_register_next} - -プロジェクトをビルドし、以下のコマンドを使用してプロジェクトを実行します。 - -####Android -{: android-next-steps} - -``` -cordova build android -``` - {: codeblock} - -``` -cordova run android -``` - {: codeblock} - -####iOS -{: ios-next-steps} - -``` -cordova build ios -``` - {: codeblock} - -``` -cordova run ios -``` - {: codeblock} - -## デバイスでのプッシュ通知の受け取り -{: #cordova_receive} - -デバイスでプッシュ通知を受け取るには、以下のコード・スニペットをコピーします。 - -###JavaScript - -以下の JavaScript コード・スニペットを Cordova アプリケーションの Web パーツに追加します。 -``` -var showNotification = function(notif) { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -###Android 通知プロパティー - -次のセクションに、Android の通知プロパティーをリストします。 - -* **message** - プッシュ通知メッセージ -* **payload** - 通知ペイロードを含む JSON オブジェクト - - -###iOS 通知プロパティー - -次のセクションに、iOS の通知プロパティーをリストします。 - -* **message** - プッシュ通知メッセージ -* **payload** - 通知ペイロードを含む JSON オブジェクト。 -action-loc-key - このストリングは、現行ローカリゼーションにおいて、`「View」`の代わりに該当ボタンのタイトルに使用されるローカライズされたストリングを取得するためのキーとして使用されます。 -* **badge** - アプリ・アイコンのバッジとして表示する数。このプロパティーがないと、バッジは変更されません。バッジを削除するには、このプロパティーの値を 0 に設定します。 -* **sound** - アプリ・バンドル内、またはアプリ・データ・コンテナーの Library/Sounds フォルダー内にある音声ファイルの名前。 - - -アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 -``` -// Handle receiving a remote notification -func application(application: UIApplication, - didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) -} -``` - {: codeblock} - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary - if remoteNotif != nil { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) - } -} -``` - {: codeblock} - -## 基本プッシュ通知の送信 -{: #push-send-notifications} - -アプリケーションの開発が完了したら、基本プッシュ通知を送信できます。 - -基本プッシュ通知を送信するには、以下の手順を実行します。 - -1. **「通知の送信 (Send Notifications)」**を選択し、**「送信先 (Send To)」**オプションを選択することでメッセージを構成します。サポートされるオプションは、**「タグ指定によるデバイス (Device by Tag)」**、**「デバイス ID (Device Id)」**、**「ユーザー ID」**、**「Android デバイス (Android devices)」**、**「iOS デバイス (iOS devices)」**、**「Web 通知 (Web Notifications)」**、および**「すべてのデバイス」**です。 -**注**: **「すべてのデバイス」**オプションを選択すると、{{site.data.keyword.mobilepushshort}}をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 -![「通知」画面](images/tag_notification.jpg) - -2. **「メッセージ」**フィールドで、メッセージを構成します。必要に応じてオプションの設定を構成してください。 -3. **「送信」**をクリックします。 -3. デバイスが通知を受信していることを確認します。 - -次のスクリーン・ショットは、Android デバイスおよび iOS デバイス上のフォアグラウンドで{{site.data.keyword.mobilepushshort}}を処理しているアラート・ボックスを示しています。 - -![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) - -![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) - - 以下のイメージは、Android のバックグラウンドでの{{site.data.keyword.mobilepushshort}}を示しています。 -![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) - -## 次のステップ -{: #next_steps_tags} - -基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 - -{{site.data.keyword.mobilepushshort}}サービスの機能をアプリに追加します。 -タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。 -拡張通知オプションを使用する場合は、[拡張プッシュ通知の使用可能化](t_advance_badge_sound_payload.html)を参照してください。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Cordova アプリケーションによるプッシュ通知受け取りの可能化 +{: #cordova_enable} +最終更新日: 2017 年 1 月 18 日 +{: .last-updated} + +Cordova は、JavaScript、CSS、および HTML を使用したハイブリッド・アプリケーションの構築用プラットフォームです。 +{{site.data.keyword.mobilepushshort}} サービスは、Cordova ベースの iOS アプリケーションおよび Android アプリケーションの開発をサポートします。 + +Cordova アプリケーションによる、デバイスでのプッシュ通知の受信を可能にすることができます。 + +## Cordova の Push プラグインのインストール +{: #cordova_install} + +Cordova アプリケーションをさらに開発するために、クライアントの Push プラグインをインストールして使用します。これにより、Bluemix への接続を初期化する Cordova の Core プラグインもインストールされます。 + +### 始めに + +1. 最新バージョンの Android Studio SDK と Xcode をダウンロードします。 +1. エミュレーターをセットアップします。Android Studio では、Google Play API をサポートするエミュレーターを使用します。 +1. Git のコマンド・ライン・ツールをインストールします。Windows では、必ず **「Windows コマンド・プロンプトから Git を実行する (Run Git from the Window Command Prompt)」**オプションを選択してください。このツールのダウンロードとインストールの方法については、[Git ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://git-scm.com/downloads){: new_window}を参照してください。 +1. Node.js と Node Package Manager (NPM) ツールをインストールします。NPM コマンド・ライン・ツールは Node.js とバンドルされています。Node.js のダウンロードとインストールの方法については、[Node.js ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://nodejs.org/en/download/){: new_window}を参照してください。 +1. コマンド・ラインから、**npm install -g cordova** コマンドを使用して、Cordova コマンド・ライン・ツールをインストールします。これは、Cordova の Push プラグインを使用するために必要です。Cordova をインストールして Cordova アプリをセットアップする方法については、[Cordova Apache ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://cordova.apache.org/#getstarted){: new_window}を参照してください。詳細については、Cordova プッシュ・プラグインの [README ファイル![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window}を参照してください。 +1. Cordova アプリを作成するフォルダーに移動し、次のコマンドを実行して Cordova アプリケーションを作成します。 +既存の Cordova アプリがある場合は、ステップ 3 に進みます。 +```cordova create your_app_name +cd your_app_name +``` + {: codeblock} +- オプション: **config.xml** ファイルを編集して、 エレメントのアプリケーション名を、デフォルトの HelloCordova という名前ではなく、自分で選択した名前に変更できます。 + +正しいバンドル ID を指定してください。誤ったバンドル ID を指定すると、Xcode で以下のエラー・メッセージが出されることがあります。 + +* 実行可能ファイルの署名に使用された資格が無効です (The executable was signed with invalid entitlements.) +* アプリケーションのコード署名資格ファイルに指定された資格が、プロビジョニング・プロファイルに指定された資格と一致しません (The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile.)この問題を修正するには、Xcode または Cordova アプリ **config.xml** ファイルに正しいバンドル ID を指定します。 + +1. サポートされる最低レベルの API またはデプロイメント・ターゲット (Deployment Target) の宣言を、Cordova アプリケーションの config.xml ファイルに追加します。minSdkVersion の値は、15 より高くなければなりません。targetSdkVersion の値は、常に、Google から入手可能な最新の Android SDK を反映している必要があります。 + + * Android - ご使用のエディターで **config.xml** ファイルを開き、以下のように、最低 SDK バージョンとターゲット SDK バージョンで `` エレメントを更新します。 + + ``` + + + + + + ``` + {: codeblock} + + * iOS - エレメントを、以下のデプロイメント・ターゲット宣言を使用して更新します。 + + ``` + + + + + ``` + {: codeblock} + +1. Cordova コマンド・ライン・インターフェース (CLI) から、以下のコマンドを使用して、プラットフォーム (iOS、Android、またはその両方) を追加します。 +``` +cordova platform add ios +cordova platform add android +``` + {: codeblock} + +1. Cordova アプリケーションのルート・ディレクトリーで、コマンド **cordova plugin add bms-push** を入力して Cordova の Push プラグインをインストールします。追加したプラットフォームに応じて、以下のような内容が表示されます。 +``` +Installing "bms-push" for android +Installing "bms-push" for ios +``` + {: codeblock} + +1. your-app-root-folder から、コマンド **cordova plugin list** を使用して、Cordova の Core および Push のプラグインが正常にインストールされたことを確認します。追加したプラットフォームに応じて、以下のような内容が表示されます。 +``` +bms-core "BMSCore" +bms-push "BMSPush" +``` + {: codeblock} + +1. iOS 開発環境を構成します。 +2. Xcode を使用してアプリケーションをビルドおよび実行します。 +1. Firebase `google-services.json` for android をダウンロードし、Cordova プロジェクトのルート・フォルダー、[your-app-name]/platforms/android に置きます。 + 1. `[your-app-name]/platforms/android` に移動します。 + 2. ファイル `build.gradle` (パス : platform > android > build.gradle) を開きます。 + 3. `build.gradle` ファイル内で `buildscript` テキストを検索します。 + 4. クラスパス行の後に、classpath 'com.google.gms:google-services:3.0.0' という行を追加します。 + 5. 次に、「dependencies」を検索します。`compile` というテキストがある場所の dependencies を選択します。そして、その dependencies が終了している場所のすぐ後に、次の行を追加します :apply plugin: 'com.google.gms.google-services'。 + 6. Cordova Android プロジェクトの準備とビルド + ``` + cordova prepare android + cordova build android + ``` + {: codeblock} + **注**: Android Studio でプロジェクトを開く前に、Cordova CLI を使用して Cordova アプリケーションをビルドしてください。これは、ビルド・エラーの回避に有効です。## Cordova プラグインの初期化 +{: #cordova_initialize} + +{{site.data.keyword.mobilepushshort}}サービスの Cordova プラグインを使用するには、事前に、アプリケーション経路とアプリケーション GUID を受け渡すことでプラグインを初期化しておく必要があります。プラグインを初期化したら、Bluemix ダッシュボードで作成したサーバー・アプリに接続することができます。Cordova プラグインは、Cordova アプリが Bluemix サービスと通信できるようにするための Android および iOS のクライアント SDK のラッパーです。 + +1. 以下のコード・スニペットをメイン JavaScript ファイル (通常、**www/js** ディレクトリーの下にある) にコピー・アンド・ペーストして、BMSClient を初期化します。 + +``` +onDeviceReady: function() {app.receivedEvent('deviceready'); + BMSClient.initialize("YOUR APP REGION"); + var category = {}; + BMSPush.initialize(appGUID,clientSecret,category); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); + } +``` + {: codeblock} + +アプリケーションの地域を受け渡します。以下の定数が提供されています。 + +``` +REGION_US_SOUTH // ".ng.bluemix.net"; +REGION_UK //".eu-gb.bluemix.net"; +REGION_SYDNEY // ".au-syd.bluemix.net"; +``` + +例えば、次のようにします。 + +``` +BMSClient.initialize(BMSClient.REGION_US_SOUTH); +``` + +**注**: Cordova CLI (例えば、Cordova の create app-name コマンド) を使用して Cordova アプリを作成した場合、この Javascript コードを index.js ファイルの onDeviceReady: function() 関数内の app.receivedEvent 関数の後に置いて、`BMSClient` を初期化します。 + + +## デバイスの登録 +{: #cordova_register} + + +デバイスを{{site.data.keyword.mobilepushshort}}サービスに登録するには、register メソッドを呼び出します。デバイスを登録するために、次のコード・スニペットを Cordova アプリケーションにコピーします。 + +``` +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); +``` + {: codeblock} + +以下の JavaScript コード・スニペットは、Bluemix Mobile Services クライアント SDK を初期化し、デバイスを{{site.data.keyword.mobilepushshort}}サービスに登録し、プッシュ通知を listen する方法を示しています。このコードを Javascript ファイルに組み込んでください。 + +コードは **onDeviceReady: function()** 内に置きます。 + +``` +onDeviceReady: function() { +app.receivedEvent('deviceready'); +BMSClient.initialize("YOUR APP REGION"); +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; +BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 + +``` +// Register the device token with Bluemix Push Notification Service +func application(application: UIApplication, + didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { + CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) +} +// Handle error when failed to register device token with APNs +func application(application: UIApplication, + didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) +} +``` + {: codeblock} + +## 次のステップ + +{: #cordova_register_next} + +プロジェクトをビルドし、以下のコマンドを使用してプロジェクトを実行します。 + +#### Android +{: android-next-steps} + +``` +cordova build android +``` + {: codeblock} + +``` +cordova run android +``` + {: codeblock} + +#### iOS +{: ios-next-steps} + +``` +cordova build ios +``` + {: codeblock} + +``` +cordova run ios +``` + {: codeblock} + +## デバイスでのプッシュ通知の受け取り +{: #cordova_receive} + +デバイスでプッシュ通知を受け取るには、以下のコード・スニペットをコピーします。 + +### JavaScript + +以下の JavaScript コード・スニペットを Cordova アプリケーションの Web パーツに追加します。 +``` +var showNotification = function(notif) { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +### Android 通知プロパティー + +次のセクションに、Android の通知プロパティーをリストします。 + +* **message** - プッシュ通知メッセージ +* **payload** - 通知ペイロードを含む JSON オブジェクト + + +### iOS 通知プロパティー + +次のセクションに、iOS の通知プロパティーをリストします。 + +* **message** - プッシュ通知メッセージ +* **payload** - 通知ペイロードを含む JSON オブジェクト。 +action-loc-key - このストリングは、現行ローカリゼーションにおいて、`「View」`の代わりに該当ボタンのタイトルに使用されるローカライズされたストリングを取得するためのキーとして使用されます。 +* **badge** - アプリ・アイコンのバッジとして表示する数。このプロパティーがないと、バッジは変更されません。バッジを削除するには、このプロパティーの値を 0 に設定します。 +* **sound** - アプリ・バンドル内、またはアプリ・データ・コンテナーの Library/Sounds フォルダー内にある音声ファイルの名前。 + + +アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 +``` +// Handle receiving a remote notification +func application(application: UIApplication, + didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) +} +``` + {: codeblock} + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary + if remoteNotif != nil { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) + } +} +``` + {: codeblock} + +## 基本プッシュ通知の送信 +{: #push-send-notifications} + +アプリケーションの開発が完了したら、基本プッシュ通知を送信できます。 + +基本プッシュ通知を送信するには、以下の手順を実行します。 + +1. **「通知の送信 (Send Notifications)」**を選択し、**「送信先 (Send To)」**オプションを選択することでメッセージを構成します。サポートされるオプションは、**「タグ指定によるデバイス (Device by Tag)」**、**「デバイス ID (Device Id)」**、**「ユーザー ID」**、**「Android デバイス (Android devices)」**、**「iOS デバイス (iOS devices)」**、**「Web 通知 (Web Notifications)」**、および**「すべてのデバイス」**です。 +**注**: **「すべてのデバイス」**オプションを選択すると、{{site.data.keyword.mobilepushshort}}をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 +![「通知」画面](images/tag_notification.jpg) + +2. **「メッセージ」**フィールドで、メッセージを構成します。必要に応じてオプションの設定を構成してください。 +3. **「送信」**をクリックします。 +3. デバイスが通知を受信していることを確認します。 + +次のスクリーン・ショットは、Android デバイスおよび iOS デバイス上のフォアグラウンドで{{site.data.keyword.mobilepushshort}}を処理しているアラート・ボックスを示しています。 + +![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) + +![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) + + 以下のイメージは、Android のバックグラウンドでの{{site.data.keyword.mobilepushshort}}を示しています。 +![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) + +## 次のステップ +{: #next_steps_tags} + +基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 + +{{site.data.keyword.mobilepushshort}}サービスの機能をアプリに追加します。 +タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。 +拡張通知オプションを使用する場合は、[拡張プッシュ通知の使用可能化](t_advance_badge_sound_payload.html)を参照してください。 diff --git a/services/mobilepush/nl/ja/c_enable_push.md b/services/mobilepush/nl/ja/c_enable_push.md index eb4886be7..cb60bb599 100644 --- a/services/mobilepush/nl/ja/c_enable_push.md +++ b/services/mobilepush/nl/ja/c_enable_push.md @@ -1,24 +1,24 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# モバイル・デバイス用の通知の使用可能化 -{: #c_enable_push-notifications} -最終更新日: 2017 年 1 月 18 日 -{: .last-updated} - -[通知プロバイダーの資格情報の構成](t__main_push_config_provider.html)を確実に実行しておいてください。 - -このセクションでは、クライアント・アプリケーション (モバイル・アプリケーション、Web ブラウザー・アプリケーション、および Chrome アプリケーションおよびエクステンション) でのプッシュ通知の受け取りを使用可能にする方法、基本的な通知の作成方法、SDK またはプラグインの取得と初期化の方法、およびプッシュ通知を受け取るためにデバイスまたはブラウザーを登録する方法について説明します。また、ご使用のモバイル・アプリケーションおよび Web ブラウザー・アプリケーションで [REST API](t_restapi.html) を使用してプッシュ通知を受け取るようにすることもできます。 - -**注**: デバイス、ブラウザー、Chrome アプリケーションおよびエクステンションの登録のために、{{site.data.keyword.mobilepushshort}} サービスは、通知プロバイダー (Apple の場合は APNs、Google の場合は FCM) から発行されたトークンへの固有の参照を維持しています。これらのトークンは、いくつかの理由で、{{site.data.keyword.mobilepushshort}}サービスの通知プロバイダーによって無効にされることがあります。 - -例えば、デバイス上のアプリのアンインストール時について考えてみます。この場合、そのデバイスが無効になったというプロバイダーの応答に基づいて通知の配信が試行されると、{{site.data.keyword.mobilepushshort}}サービスはデバイスまたは Web ブラウザーの登録を削除します。その結果として、これらの無効にされたデバイスに通知を送信しようとする試みが抑えられることになります。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# モバイル・デバイス用の通知の使用可能化 +{: #c_enable_push-notifications} +最終更新日: 2017 年 1 月 18 日 +{: .last-updated} + +[通知プロバイダーの資格情報の構成](t__main_push_config_provider.html)を確実に実行しておいてください。 + +このセクションでは、クライアント・アプリケーション (モバイル・アプリケーション、Web ブラウザー・アプリケーション、および Chrome アプリケーションおよびエクステンション) でのプッシュ通知の受け取りを使用可能にする方法、基本的な通知の作成方法、SDK またはプラグインの取得と初期化の方法、およびプッシュ通知を受け取るためにデバイスまたはブラウザーを登録する方法について説明します。また、ご使用のモバイル・アプリケーションおよび Web ブラウザー・アプリケーションで [REST API](t_restapi.html) を使用してプッシュ通知を受け取るようにすることもできます。 + +**注**: デバイス、ブラウザー、Chrome アプリケーションおよびエクステンションの登録のために、{{site.data.keyword.mobilepushshort}} サービスは、通知プロバイダー (Apple の場合は APNs、Google の場合は FCM) から発行されたトークンへの固有の参照を維持しています。これらのトークンは、いくつかの理由で、{{site.data.keyword.mobilepushshort}}サービスの通知プロバイダーによって無効にされることがあります。 + +例えば、デバイス上のアプリのアンインストール時について考えてみます。この場合、そのデバイスが無効になったというプロバイダーの応答に基づいて通知の配信が試行されると、{{site.data.keyword.mobilepushshort}}サービスはデバイスまたは Web ブラウザーの登録を削除します。その結果として、これらの無効にされたデバイスに通知を送信しようとする試みが抑えられることになります。 diff --git a/services/mobilepush/nl/ja/c_enable_push_webhook.md b/services/mobilepush/nl/ja/c_enable_push_webhook.md index f540c1784..34bf0a18c 100644 --- a/services/mobilepush/nl/ja/c_enable_push_webhook.md +++ b/services/mobilepush/nl/ja/c_enable_push_webhook.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Web フックの使用可能化 -{: #tag_based_notifications} -最終更新日: 2017 年 1 月 23 日 -{: .last-updated} - - -{{site.data.keyword.mobilepushshort}} サービスを使用して、変更された情報に関するアラートを受け取ることを選択できます。エンタープライズ情報に対する変更があると、イベントが作成されます。これらのイベントを Web フック・イベントとして登録することによって、通知を受け取ることができます。これらの Web フック・イベントは、アラートをトリガーします。 - -Web フックは、デバイスの登録やタグへのサブスクライブなどのイベントによってトリガーされる、ユーザー定義のコールバックです。{{site.data.keyword.mobilepushshort}} サービス上で、以下の Web フック・イベントを登録できます。 - -- **onDeviceRegister**: プッシュ用にデバイスが登録された場合に、Web フック・イベントがトリガーされます。 -- **onDeviceUpdate**: 登録デバイスに関する情報が更新されたときに、Web フック・イベントがトリガーされます。 -- **onDeviceUnregister**: デバイスが登録抹消されたときに、Web フック・イベントがトリガーされます。 -- **onSubscribe**: ユーザーがタグをサブスクライブしたときに、Web フック・イベントがトリガーされます。 -- **onUnsubscribe**: ユーザーがタグをアンサブスクライブしたときに、Web フック・イベントがトリガーされます。 -- **onNotificationSend**: 通知がディスパッチされた場合に、Web フック・イベントがトリガーされます。 -- **onNotificationFailure**: 通知が失敗した場合に、Web フック・イベントがトリガーされます。 - - -**注**: 通知のディスパッチはバッチ単位で行われます。1 回のメッセージのディスパッチに複数の Web フック・イベントが含まれることがあります。また、これには失敗と成功の両方が含まれている可能性があります。 -Web フック・イベントは、ディスパッチされたメッセージと同じ messageID を持ちます。 - -Web フックについて詳しくは、[IBM Push Notifications REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}を参照してください。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Web フックの使用可能化 +{: #tag_based_notifications} +最終更新日: 2017 年 1 月 23 日 +{: .last-updated} + + +{{site.data.keyword.mobilepushshort}} サービスを使用して、変更された情報に関するアラートを受け取ることを選択できます。エンタープライズ情報に対する変更があると、イベントが作成されます。これらのイベントを Web フック・イベントとして登録することによって、通知を受け取ることができます。これらの Web フック・イベントは、アラートをトリガーします。 + +Web フックは、デバイスの登録やタグへのサブスクライブなどのイベントによってトリガーされる、ユーザー定義のコールバックです。{{site.data.keyword.mobilepushshort}} サービス上で、以下の Web フック・イベントを登録できます。 + +- **onDeviceRegister**: プッシュ用にデバイスが登録された場合に、Web フック・イベントがトリガーされます。 +- **onDeviceUpdate**: 登録デバイスに関する情報が更新されたときに、Web フック・イベントがトリガーされます。 +- **onDeviceUnregister**: デバイスが登録抹消されたときに、Web フック・イベントがトリガーされます。 +- **onSubscribe**: ユーザーがタグをサブスクライブしたときに、Web フック・イベントがトリガーされます。 +- **onUnsubscribe**: ユーザーがタグをアンサブスクライブしたときに、Web フック・イベントがトリガーされます。 +- **onNotificationSend**: 通知がディスパッチされた場合に、Web フック・イベントがトリガーされます。 +- **onNotificationFailure**: 通知が失敗した場合に、Web フック・イベントがトリガーされます。 + + +**注**: 通知のディスパッチはバッチ単位で行われます。1 回のメッセージのディスパッチに複数の Web フック・イベントが含まれることがあります。また、これには失敗と成功の両方が含まれている可能性があります。 +Web フック・イベントは、ディスパッチされたメッセージと同じ messageID を持ちます。 + +Web フックについて詳しくは、[IBM Push Notifications REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}を参照してください。 diff --git a/services/mobilepush/nl/ja/c_ios_enable.md b/services/mobilepush/nl/ja/c_ios_enable.md index 802f86db4..25da19e70 100644 --- a/services/mobilepush/nl/ja/c_ios_enable.md +++ b/services/mobilepush/nl/ja/c_ios_enable.md @@ -1,330 +1,330 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#iOS アプリケーションによる {{site.data.keyword.mobilepushshort}} の送信の可能化 -{: #enable-push-ios-notifications} -最終更新日: 2017 年 2 月 14 日 -{: .last-updated} - -iOS アプリケーションによる、デバイスへの {{site.data.keyword.mobilepushshort}} の送信を可能にすることができます。 - - -##CocoaPods のインストール -{: #enable-push-ios-notifications-install} - -既存の Xcode プロジェクトでは、CocoaPods 依存関係管理ツールを使用して Bluemix Mobile サービス・クライアント SDK をセットアップできます。あるいは、手動で SDK をインストールすることもできます。 - -Swift の Push の README ファイルを表示するには、[README ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}を参照してください。 - - - -1. Mac ターミナルで以下のコマンドを使用して CocoaPods をインストールします。 -```$ sudo gem install cocoapods -``` - {: codeblock} -2. ターミナルで `pod init` コマンドを入力して、CocoaPods を初期化します。このコマンドは、Xcode プロジェクトが位置するディレクトリーから必ず実行してください。`pod init` コマンドによって Podfile が作成されます。 -3. 生成された Podfile に、必要な SDK 依存関係を追加します。以下の Podfile をコピーします。 - - ``` - source 'https://github.com/CocoaPods/Specs.git' - //Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - pod 'BMSAnalyticsAPI' end - ``` - {: codeblock} - -3. ターミナルで、プロジェクト・フォルダーに移動し、`pod update` コマンドを使用して依存関係をインストールします。 - -このコマンドにより、依存関係がインストールされ、新規 Xcode ワークスペースが作成されます。 -**注**: 元の Xcode プロジェクト・ファイルではなく、次のように必ず新しい Xcode ワークスペースを開いてください。 -``` - $ open App.xcworkspace -``` - {: codeblock} - -このワークスペースには、元のプロジェクトと、依存関係が含まれている Pods プロジェクトが含まれています。Bluemix モバイル・サービスのソース・フォルダーを変更する場合は、Pods プロジェクト内の `Pods/yourImportedSourceFolder` の下にあります (例えば、`Pods/BMSPush`)。 - -##Carthage を使用したフレームワークの追加 -{: #carthage} - -[Carthage ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}を使用してプロジェクトにフレームワークを追加します。Xcode8 の Carthage はサポートされません。 - -1. `BMSPush` フレームワークを Cartfile に追加します。 -``` -github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" -``` - {: codeblock} -2. `carthage update` コマンドを実行します。ビルドが完了したら、`BMSPush.framework`、 `BMSCore.framework`、および `BMSAnalyticsAPI.framework` をドラッグして、Xcode プロジェクトに入れます。 -3. [Carthage ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}サイトの説明に従って統合を完了してください。 - -##iOS SDK のセットアップ -{: ios-sdk} - -iOS SDK をセットアップするには、以下のコードをアプリケーション内の **AppDelegate.swift** ファイルに追加します。これによって APNs にも登録されることに注意してください。 -``` - func application(_ application: UIApplication, - didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool - { - BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") - } -``` - {: codeblock} - -##インポートされたフレームワークおよびソース・フォルダーの使用 -{: using-imported-frameworks} - -コードで SDK を参照します。以下の前提条件を満たしていることを確認してください。 - -- iOS 8.0 以降 -- Xcode 7 - -関連するヘッダーの `#import` ディレクティブを記述します。例えば、以下のようにします。 -``` -//swift - import BMSCore - import BMSPush -``` - {: codeblock} - -Swift の Push の README ファイルを読むには、[README ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}を参照してください。 - -**注**: CocoaPods コマンド `pod install` または `pod update` を使用して Pods プロジェクトを更新すると、Bluemix モバイル・サービスのソース・フォルダーがオーバーライドされる可能性があります。元ファイルのカスタマイズしたバージョンを保持する場合は、これらのコマンドのいずれかを発行する前には、それらをバックアップしてください。 - - -##ビルド設定 -{: build-settings} - -**「Xcode」>「ビルド設定」>「ビルド・オプション」に移動し、「Bitcode を使用可能に設定 (Set Enable Bitcode)」**を**「いいえ」**に設定します。 - -**重要**: iOS 9 現在では、App Transport Security (ATS) 機能に対する変更が、認証プロセスの処理方法に影響する可能性があります。次のブログ投稿にこれらの変更の詳細な情報が記載されています: [ATS and Bitcode in iOS 9 ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window}および [Connect your iOS 9 app to Bluemix today ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}を参照してください。 - -## iOS アプリ用の Push SDK の初期化 -{: #enable-push-ios-notifications-initialize} - -初期化コードを配置する一般的な場所は、iOS アプリケーションのアプリケーション代行内です。Push ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路と GUID を取得します。 - -###Core SDK の初期化 -{: Initializing-the-core-sdk} - - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance -myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") -``` - {: codeblock} - -### 経路、GUID、および Bluemix の地域 -{: route-guid-bluemix-region} - -####appRoute -{: ios-approute} - -Bluemix で作成したサーバー・アプリケーションに割り当てられた経路を指定します。 - -####GUID -{: ios-guid} - -Bluemix で作成したアプリケーションに割り当てられた固有キーを指定します。この値では、大/小文字が区別されます。 - -####bluemixRegionSuffix -{: ios-bluemixRegionSuffix} - -アプリがホストされている場所を指定します。`bluemixRegion` パラメーターでは、使用する Bluemix デプロイメントを指定します。`BMSClient.REGION` 静的プロパティーを使用してこの値を設定し、次の 3 つの値のいずれかを使用できます。 - -- BMSClient.Region.usSouth -- BMSClient.Region.unitedKingdom -- BMSClient.Region.sydney - -####AppGUID -{: ios-AppGUID} - -Bluemix で作成した{{site.data.keyword.mobilepushshort}}サービスに割り当てられた固有の AppGUID キーを指定します。 - -###クライアント Push SDK の初期化 -{: initializing-the-client-Push-SDK} - -``` - //Initialize client Push SDK for Swift - let push = BMSPushClient.sharedInstance - push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -## iOS アプリケーションとデバイスの登録 -{: #enable-push-ios-notifications-register} - - -アプリケーションでリモート通知を受け取るには、アプリケーションをデバイスにインストールした後、APNs に登録する必要があります。アプリは、APNs によって生成されたデバイス・トークンを受け取った後、それを{{site.data.keyword.mobilepushshort}}サービスに送り返す必要があります。 - -iOS のアプリケーションおよびデバイスを登録するには、以下を行う必要があります。 - -1. バックエンド・アプリケーションを作成します。 -2. トークンを {{site.data.keyword.mobilepushshort}} に渡します。 - - -###バックエンド・アプリケーションの作成 -{: create-a-backend-app} - -Bluemix® カタログの Boilerplates セクションでバックエンド・アプリケーションを作成します。これにより、{{site.data.keyword.mobilepushshort}} サービスはこのアプリケーションに自動的にバインドされます。バックエンド・アプリを既に作成済みの場合は、必ずそのアプリを {{site.data.keyword.mobilepushshort}} サービスにバインドしてください。 - - -###{{site.data.keyword.mobilepushshort}}へのトークンの受け渡し -{: pass-token-push-notifications} - -トークンを APNs から受け取った後で、`registerWithDeviceToken` メソッドの一部としてそのトークンを{{site.data.keyword.mobilepushshort}}に渡します。 - -トークンを APNs から受け取った後で、`didRegisterForRemoteNotificationsWithDeviceToken` メソッドの一部として、そのトークンをプッシュ通知に渡します。 - -``` - func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ - let push = BMSPushClient.sharedInstance - push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - } -``` - {: codeblock} - - -## iOS デバイスでのプッシュ通知の受け取り -{: #enable-push-ios-notifications-receiving} - - -iOS デバイスでプッシュ通知を受け取るには、アプリケーションのアプリケーション代行に以下の Swift メソッドを追加します。 - -``` - // For Swift - func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) - { //UserInfo dictionary will contain data sent from the server } -``` - {: codeblock} - -## iOS デバイスでのプッシュ通知のモニター -{: ios-monitoring} - -通知の現在の状況をモニターするには、アプリケーションのアプリケーション代行に以下の Swift メソッドを追加します。 - -``` - // Send notification status when app is opened by clicking the notifications - func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - print("Send message status to the Push server") - } -} -``` - {: codeblock} - -``` - // Send notification status when the app is in background mode. - func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { - let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) - self.showAlert(title: "Recieved Push notifications", message: payLoad) - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - completionHandler(UIBackgroundFetchResult.newData) - } -} -``` - {: codeblock} - - -## 基本プッシュ通知の送信 -{: #send} - -アプリケーションの開発が完了したら、基本プッシュ通知を送信できます。 - -基本プッシュ通知を送信するには、以下の手順を実行します。 - -1. **「通知の送信 (Send Notifications)」**を選択し、**「送信先 (Send To)」**オプションを選択することでメッセージを構成します。サポートされるオプションは、**「タグ指定によるデバイス (Device by Tag)」**、**「デバイス ID (Device Id)」**、**「ユーザー ID」**、**「Android デバイス (Android devices)」**、**「iOS デバイス (iOS devices)」**、**「Web 通知 (Web Notifications)」**、および**「すべてのデバイス」**です。 -**注**: **「すべてのデバイス」**オプションを選択すると、{{site.data.keyword.mobilepushshort}}をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 -![「通知」画面](images/tag_notification.jpg) - -2. **「メッセージ」**フィールドで、メッセージを構成します。必要に応じてオプションの設定を構成してください。 -3. **「送信」**をクリックします。 -3. デバイスが通知を受信していることを確認します。 - -次のイメージは、iOS デバイス上で{{site.data.keyword.mobilepushshort}}を処理しているアラート・ボックスを示しています。 - -![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) - -### 通知を送信するためのオプションの設定 -{: #send_ios_otpional_setting} - -iOS デバイスに通知を送信するための{{site.data.keyword.mobilepushshort}}設定をさらに詳細にカスタマイズできます。以下の任意指定のカスタマイズ・オプションがサポートされます。 - -- **バッジ**: アプリケーション・バッジに表示される数値を示します。デフォルト値はゼロ (0) で、この場合、バッジは表示されません。 -- **音 (Sound)**: 通知の受信時に音声クリップを再生するかどうかを示します。デフォルト、またはアプリにバンドルされている音声リソースの名前がサポートされます。 -- **追加のペイロード (Additional payload)**: 通知用のカスタム・ペイロードの値を指定します。 - -##対話式通知の使用可能化 - -対話式通知を使用可能にすることにより、イメージ、マップ、応答ボタンを追加するなど、より詳細な機能を iOS 通知に持たせることができるようになりました。これによって、より多くのコンテキストをお客様に提供するとともに、現行コンテキストから離れることなく、即時にアクションを取ることができます。 - -対話式通知を使用可能にするには、以下のコードを使用します。 - -``` - // This defines the button action. - let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) -``` - {: codeblock} -``` - // This defines category for the buttons - let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) -``` - {: codeblock} -``` - // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions - let notificationOptions = BMSPushClientOptions(categoryName: [category]) - let push = BMSPushClient.sharedInstance - push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) -``` - {: codeblock} - -対話式通知を送信するには、以下の手順を実行します。 - -1. 「構成 (Compose)」セクションで、「送信先 (Send To)」ドロップダウン・リストに、**「iOS Devices (iOS デバイス)」**を選択します。 -2. 送信する通知メッセージを入力します。 -3. 「オプション設定 (Optional Settings)」セクションで、**「モバイル」**を選択して、**「iOS」** をクリックします。 -4. 「タイプ」ドロップダウン・リストで、**「混合」**を選択します。 -5. 「カテゴリー」フィールドに、アプリで定義した通知タイプを指定します。 - -![iOS 用の対話式通知](images/push_ios_notification_interactive.jpg) - -## 次のステップ -{: #next_steps_tags} - -基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 - -以下の Push Notifications Service の機能をご使用のアプリに追加します。タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張プッシュ通知の使用可能化](t_advance_badge_sound_payload.html)を参照してください。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +#iOS アプリケーションによる {{site.data.keyword.mobilepushshort}} の送信の可能化 +{: #enable-push-ios-notifications} +最終更新日: 2017 年 2 月 14 日 +{: .last-updated} + +iOS アプリケーションによる、デバイスへの {{site.data.keyword.mobilepushshort}} の送信を可能にすることができます。 + + +##CocoaPods のインストール +{: #enable-push-ios-notifications-install} + +既存の Xcode プロジェクトでは、CocoaPods 依存関係管理ツールを使用して Bluemix Mobile サービス・クライアント SDK をセットアップできます。あるいは、手動で SDK をインストールすることもできます。 + +Swift の Push の README ファイルを表示するには、[README ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}を参照してください。 + + + +1. Mac ターミナルで以下のコマンドを使用して CocoaPods をインストールします。 +```$ sudo gem install cocoapods +``` + {: codeblock} +2. ターミナルで `pod init` コマンドを入力して、CocoaPods を初期化します。このコマンドは、Xcode プロジェクトが位置するディレクトリーから必ず実行してください。`pod init` コマンドによって Podfile が作成されます。 +3. 生成された Podfile に、必要な SDK 依存関係を追加します。以下の Podfile をコピーします。 + + ``` + source 'https://github.com/CocoaPods/Specs.git' + //Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + pod 'BMSAnalyticsAPI' end + ``` + {: codeblock} + +3. ターミナルで、プロジェクト・フォルダーに移動し、`pod update` コマンドを使用して依存関係をインストールします。 + +このコマンドにより、依存関係がインストールされ、新規 Xcode ワークスペースが作成されます。 +**注**: 元の Xcode プロジェクト・ファイルではなく、次のように必ず新しい Xcode ワークスペースを開いてください。 +``` + $ open App.xcworkspace +``` + {: codeblock} + +このワークスペースには、元のプロジェクトと、依存関係が含まれている Pods プロジェクトが含まれています。Bluemix モバイル・サービスのソース・フォルダーを変更する場合は、Pods プロジェクト内の `Pods/yourImportedSourceFolder` の下にあります (例えば、`Pods/BMSPush`)。 + +##Carthage を使用したフレームワークの追加 +{: #carthage} + +[Carthage ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}を使用してプロジェクトにフレームワークを追加します。Xcode8 の Carthage はサポートされません。 + +1. `BMSPush` フレームワークを Cartfile に追加します。 +``` +github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" +``` + {: codeblock} +2. `carthage update` コマンドを実行します。ビルドが完了したら、`BMSPush.framework`、 `BMSCore.framework`、および `BMSAnalyticsAPI.framework` をドラッグして、Xcode プロジェクトに入れます。 +3. [Carthage ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}サイトの説明に従って統合を完了してください。 + +##iOS SDK のセットアップ +{: ios-sdk} + +iOS SDK をセットアップするには、以下のコードをアプリケーション内の **AppDelegate.swift** ファイルに追加します。これによって APNs にも登録されることに注意してください。 +``` + func application(_ application: UIApplication, + didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool + { + BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") + } +``` + {: codeblock} + +##インポートされたフレームワークおよびソース・フォルダーの使用 +{: using-imported-frameworks} + +コードで SDK を参照します。以下の前提条件を満たしていることを確認してください。 + +- iOS 8.0 以降 +- Xcode 7 + +関連するヘッダーの `#import` ディレクティブを記述します。例えば、以下のようにします。 +``` +//swift + import BMSCore + import BMSPush +``` + {: codeblock} + +Swift の Push の README ファイルを読むには、[README ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}を参照してください。 + +**注**: CocoaPods コマンド `pod install` または `pod update` を使用して Pods プロジェクトを更新すると、Bluemix モバイル・サービスのソース・フォルダーがオーバーライドされる可能性があります。元ファイルのカスタマイズしたバージョンを保持する場合は、これらのコマンドのいずれかを発行する前には、それらをバックアップしてください。 + + +##ビルド設定 +{: build-settings} + +**「Xcode」>「ビルド設定」>「ビルド・オプション」に移動し、「Bitcode を使用可能に設定 (Set Enable Bitcode)」**を**「いいえ」**に設定します。 + +**重要**: iOS 9 現在では、App Transport Security (ATS) 機能に対する変更が、認証プロセスの処理方法に影響する可能性があります。次のブログ投稿にこれらの変更の詳細な情報が記載されています: [ATS and Bitcode in iOS 9 ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window}および [Connect your iOS 9 app to Bluemix today ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}を参照してください。 + +## iOS アプリ用の Push SDK の初期化 +{: #enable-push-ios-notifications-initialize} + +初期化コードを配置する一般的な場所は、iOS アプリケーションのアプリケーション代行内です。Push ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路と GUID を取得します。 + +###Core SDK の初期化 +{: Initializing-the-core-sdk} + + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance +myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") +``` + {: codeblock} + +### 経路、GUID、および Bluemix の地域 +{: route-guid-bluemix-region} + +####appRoute +{: ios-approute} + +Bluemix で作成したサーバー・アプリケーションに割り当てられた経路を指定します。 + +####GUID +{: ios-guid} + +Bluemix で作成したアプリケーションに割り当てられた固有キーを指定します。この値では、大/小文字が区別されます。 + +####bluemixRegionSuffix +{: ios-bluemixRegionSuffix} + +アプリがホストされている場所を指定します。`bluemixRegion` パラメーターでは、使用する Bluemix デプロイメントを指定します。`BMSClient.REGION` 静的プロパティーを使用してこの値を設定し、次の 3 つの値のいずれかを使用できます。 + +- BMSClient.Region.usSouth +- BMSClient.Region.unitedKingdom +- BMSClient.Region.sydney + +####AppGUID +{: ios-AppGUID} + +Bluemix で作成した{{site.data.keyword.mobilepushshort}}サービスに割り当てられた固有の AppGUID キーを指定します。 + +###クライアント Push SDK の初期化 +{: initializing-the-client-Push-SDK} + +``` + //Initialize client Push SDK for Swift + let push = BMSPushClient.sharedInstance + push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +## iOS アプリケーションとデバイスの登録 +{: #enable-push-ios-notifications-register} + + +アプリケーションでリモート通知を受け取るには、アプリケーションをデバイスにインストールした後、APNs に登録する必要があります。アプリは、APNs によって生成されたデバイス・トークンを受け取った後、それを{{site.data.keyword.mobilepushshort}}サービスに送り返す必要があります。 + +iOS のアプリケーションおよびデバイスを登録するには、以下を行う必要があります。 + +1. バックエンド・アプリケーションを作成します。 +2. トークンを {{site.data.keyword.mobilepushshort}} に渡します。 + + +###バックエンド・アプリケーションの作成 +{: create-a-backend-app} + +Bluemix® カタログの Boilerplates セクションでバックエンド・アプリケーションを作成します。これにより、{{site.data.keyword.mobilepushshort}} サービスはこのアプリケーションに自動的にバインドされます。バックエンド・アプリを既に作成済みの場合は、必ずそのアプリを {{site.data.keyword.mobilepushshort}} サービスにバインドしてください。 + + +###{{site.data.keyword.mobilepushshort}}へのトークンの受け渡し +{: pass-token-push-notifications} + +トークンを APNs から受け取った後で、`registerWithDeviceToken` メソッドの一部としてそのトークンを{{site.data.keyword.mobilepushshort}}に渡します。 + +トークンを APNs から受け取った後で、`didRegisterForRemoteNotificationsWithDeviceToken` メソッドの一部として、そのトークンをプッシュ通知に渡します。 + +``` + func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ + let push = BMSPushClient.sharedInstance + push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + } +``` + {: codeblock} + + +## iOS デバイスでのプッシュ通知の受け取り +{: #enable-push-ios-notifications-receiving} + + +iOS デバイスでプッシュ通知を受け取るには、アプリケーションのアプリケーション代行に以下の Swift メソッドを追加します。 + +``` + // For Swift + func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) + { //UserInfo dictionary will contain data sent from the server } +``` + {: codeblock} + +## iOS デバイスでのプッシュ通知のモニター +{: ios-monitoring} + +通知の現在の状況をモニターするには、アプリケーションのアプリケーション代行に以下の Swift メソッドを追加します。 + +``` + // Send notification status when app is opened by clicking the notifications + func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + print("Send message status to the Push server") + } +} +``` + {: codeblock} + +``` + // Send notification status when the app is in background mode. + func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { + let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) + self.showAlert(title: "Recieved Push notifications", message: payLoad) + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + completionHandler(UIBackgroundFetchResult.newData) + } +} +``` + {: codeblock} + + +## 基本プッシュ通知の送信 +{: #send} + +アプリケーションの開発が完了したら、基本プッシュ通知を送信できます。 + +基本プッシュ通知を送信するには、以下の手順を実行します。 + +1. **「通知の送信 (Send Notifications)」**を選択し、**「送信先 (Send To)」**オプションを選択することでメッセージを構成します。サポートされるオプションは、**「タグ指定によるデバイス (Device by Tag)」**、**「デバイス ID (Device Id)」**、**「ユーザー ID」**、**「Android デバイス (Android devices)」**、**「iOS デバイス (iOS devices)」**、**「Web 通知 (Web Notifications)」**、および**「すべてのデバイス」**です。 +**注**: **「すべてのデバイス」**オプションを選択すると、{{site.data.keyword.mobilepushshort}}をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 +![「通知」画面](images/tag_notification.jpg) + +2. **「メッセージ」**フィールドで、メッセージを構成します。必要に応じてオプションの設定を構成してください。 +3. **「送信」**をクリックします。 +3. デバイスが通知を受信していることを確認します。 + +次のイメージは、iOS デバイス上で{{site.data.keyword.mobilepushshort}}を処理しているアラート・ボックスを示しています。 + +![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) + +### 通知を送信するためのオプションの設定 +{: #send_ios_otpional_setting} + +iOS デバイスに通知を送信するための{{site.data.keyword.mobilepushshort}}設定をさらに詳細にカスタマイズできます。以下の任意指定のカスタマイズ・オプションがサポートされます。 + +- **バッジ**: アプリケーション・バッジに表示される数値を示します。デフォルト値はゼロ (0) で、この場合、バッジは表示されません。 +- **音 (Sound)**: 通知の受信時に音声クリップを再生するかどうかを示します。デフォルト、またはアプリにバンドルされている音声リソースの名前がサポートされます。 +- **追加のペイロード (Additional payload)**: 通知用のカスタム・ペイロードの値を指定します。 + +##対話式通知の使用可能化 + +対話式通知を使用可能にすることにより、イメージ、マップ、応答ボタンを追加するなど、より詳細な機能を iOS 通知に持たせることができるようになりました。これによって、より多くのコンテキストをお客様に提供するとともに、現行コンテキストから離れることなく、即時にアクションを取ることができます。 + +対話式通知を使用可能にするには、以下のコードを使用します。 + +``` + // This defines the button action. + let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) +``` + {: codeblock} +``` + // This defines category for the buttons + let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) +``` + {: codeblock} +``` + // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions + let notificationOptions = BMSPushClientOptions(categoryName: [category]) + let push = BMSPushClient.sharedInstance + push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) +``` + {: codeblock} + +対話式通知を送信するには、以下の手順を実行します。 + +1. 「構成 (Compose)」セクションで、「送信先 (Send To)」ドロップダウン・リストに、**「iOS Devices (iOS デバイス)」**を選択します。 +2. 送信する通知メッセージを入力します。 +3. 「オプション設定 (Optional Settings)」セクションで、**「モバイル」**を選択して、**「iOS」** をクリックします。 +4. 「タイプ」ドロップダウン・リストで、**「混合」**を選択します。 +5. 「カテゴリー」フィールドに、アプリで定義した通知タイプを指定します。 + +![iOS 用の対話式通知](images/push_ios_notification_interactive.jpg) + +## 次のステップ +{: #next_steps_tags} + +基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 + +以下の Push Notifications Service の機能をご使用のアプリに追加します。タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張プッシュ通知の使用可能化](t_advance_badge_sound_payload.html)を参照してください。 diff --git a/services/mobilepush/nl/ja/c_overview_push.md b/services/mobilepush/nl/ja/c_overview_push.md index 2abec0b23..3a27bcf42 100644 --- a/services/mobilepush/nl/ja/c_overview_push.md +++ b/services/mobilepush/nl/ja/c_overview_push.md @@ -1,129 +1,129 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}}の概要 -{: #overview-push} -最終更新日: 2017 年 1 月 18 日 -{: .last-updated} - -IBM {{site.data.keyword.mobilepushshort}} は、デバイスおよびプラットフォームに通知を送信するために使用できるサービスです。通知は、すべてのアプリケーション・ユーザーをターゲットとすることも、タグを使用して特定のユーザーおよびデバイスの集合をターゲットとすることもできます。デバイス、タグ、およびサブスクリプションを管理できます。 - - -以下のいずれかのオプションを使用して、バインドまたはアンバインドされたサービスを作成することができます。 - -- カタログから MobileFirst Services Starter ボイラープレートを使用して Bluemix アプリケーションを作成する。これにより、Bluemix バックエンド・アプリケーションにバインドされた Push Notifications (プッシュ通知) サービスが作成されます。 -- モバイル・カタログから直接、アンバウンド Push Notifications (プッシュ通知) サービスを作成する。後でアプリケーションにバインドするか、アンバウンドの状態で使用するよう選択することもできます。 -- [モバイル・ダッシュボード![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}を使用する。 - -なお、{{site.data.keyword.mobilepushshort}}のモニター・タブには、分析データは表示されません。 - -{{site.data.keyword.mobilepushshort}}サービスは、OpenWhisk 対応になりました。詳細については、[OpenWhisk](/docs/openwhisk/index.html) を参照してください。 - - -## {{site.data.keyword.mobilepushshort}}サービスのプロセス -{: #overview_push_process} - -モバイル・クライアント、Web ブラウザー・クライアント、および Google Chrome アプリケーションおよびエクステンションは、{{site.data.keyword.mobilepushshort}} サービスをサブスクライブし、登録することができます。クライアント・アプリケーションは、開始時、{{site.data.keyword.mobilepushshort}}サービスにそれぞれを登録してサブスクライブします。通知は、Apple Push Notification Service (APNs) または Firebase Cloud Messaging (FCM)/Google Cloud Messaging (GCM) サーバーにディスパッチされ、その後、登録済みのモバイル・クライアントまたはブラウザー・クライアントに送信されます。 - -![プッシュの概要](images/overview.jpg) - - -###モバイル・アプリケーションとブラウザー・アプリケーション -{: mobile-applications} - -クライアント・アプリケーションは、通知を受け取るために、開始時に {{site.data.keyword.mobilepushshort}} サービスにそれぞれを登録してサブスクライブします。 - -###バックエンド・アプリケーション -{: backend-applications} - -バックエンド・アプリケーションは、オンプレミスまたはパブリック・クラウドに位置することができます。バックエンド・アプリケーションは、{{site.data.keyword.mobilepushshort}}サービスを使用して、コンテキストに依存した通知をモバイル・アプリケーション・ユーザーとブラウザー・アプリケーション・ユーザーに送信します。バックエンド・アプリケーションは、プッシュ通知を送信するためにモバイル・デバイス、ブラウザー・エージェント、およびユーザーに関する情報を維持し管理する必要はありません。代わりに、バックエンド・アプリケーションは、それらを管理および維持する{{site.data.keyword.mobilepushshort}}サービスを使用することができます。 - -###アプリ・バックエンド所有者 -{: app-backend-owner} - -アプリ・バックエンド所有者は、{{site.data.keyword.mobilepushshort}}サービスのインスタンスをバンドルするモバイル・バックエンド・アプリケーションを作成します。また、アプリ・バックエンド所有者は、{{site.data.keyword.mobilepushshort}}サービスとこのサービスのターゲットとなるモバイル・アプリケーションおよびブラウザー・アプリケーションとを使用するバックエンド・アプリケーションに合うように、{{site.data.keyword.mobilepushshort}}サービスの構成とセットアップも行います。 - -###{{site.data.keyword.mobilepushshort}}サービス -{: push-notification-service} - -{{site.data.keyword.mobilepushshort}}サービスは、通知用に登録されたモバイル・デバイスと Web ブラウザー・クライアントに関するすべての情報を管理します。このサービスは、異機種のモバイル・プラットフォームおよび Web ブラウザー・プラットフォームに通知を送信するテクノロジー詳細がアプリケーションに透過的になるようにし、サービス内部でそのすべてを処理します。 - -###ゲートウェイ -{: gateways} - -モバイル・アプリケーションやブラウザー・アプリケーションに通知をディスパッチするために IBM {{site.data.keyword.mobilepushshort}} サービスが使用する、FCM/GCM または Apple Push Notification Service (APNs) などのプラットフォーム固有のプッシュ通知クラウド・サービス。 - -###プッシュのセキュリティー -{: push-security} - -{{site.data.keyword.mobilepushshort}} API は、次の 2 つのタイプの secret によって保護されています。 - -- **appSecret**: 「appSecret」は、バックエンド・アプリケーションによって通常呼び出される API を保護します。例えば、{{site.data.keyword.mobilepushshort}}を送信する API や設定を構成する API などです。 -- **clientSecret**: 「clientSecret」は、モバイル・クライアント・アプリケーションによって通常呼び出される API を保護します。この「clientSecret」を必要とする関連付けられた UserId を持つデバイスの登録に関与する API は 1 つだけです。その他の API は、clientSecret を必要とするモバイル・クライアントからは呼び出されません。 - -「appSecret」と「clientSecret」は、アプリケーションと{{site.data.keyword.mobilepushshort}}サービスのバインド時にすべてのサービス・インスタンスに割り振られます。secret の受け渡しの方法や、対象の API について詳しくは、[REST APIs ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/)の資料を参照してください。 - -**注**: 以前のアプリケーションでは、userId フィールドが設定されたデバイスを登録または更新する場合にのみ、clientSecret の受け渡しが必要とされました。モバイル・クライアントおよびブラウザー・クライアントによって呼び出されるその他のすべての API では、clientSecret は不要でした。これらの古いアプリケーションでは引き続き、デバイスの登録や呼び出しの更新時にオプションで clientSecret を使用できます。ただし、すべてのクライアント API 呼び出しで clientSecret チェックを実施することを強くお勧めします。これを既存のアプリケーションでも実施するために、新規の「verifyClientSecret」API が公開されています。新規アプリケーションの場合、clientSecret チェックがすべてのクライアント API 呼び出しに対して実施され、この動作は「verfiyClientSecret」API を使用して変更することはできません。 - -デフォルトでは、クライアント秘密鍵検証は新規アプリケーションに対してのみ実施されます。既存のアプリケーションと新規アプリケーションはどちらも、verifyClientSecret REST API を使用して、クライアント秘密鍵検証を使用可能または使用不可にすることができます。applicationId および deviceId を知っている可能性のあるユーザーにデバイスが公開されないようにするために、クライアント秘密鍵検証を実施することをお勧めします。 - -「clientSecret」は常に機密とし、モバイル・アプリケーションへのハードコーディングは絶対に行わないでください。アプリケーションの実行時に「clientSecret」を動的にプルするために使用できる、さまざまなアプリケーション初期化パターンがあります。以下のシーケンス図に、可能なパターンの概要を示します。![通知の使用可能化](images/init_client_secret.jpg) - -## {{site.data.keyword.mobilepushshort}}のタイプ -{: #overview-push-types} - -###ブロードキャスト -{: broadcast} - -クライアント・アプリケーションは、{{site.data.keyword.mobilepushshort}} サービスに自身を登録すると、ブロードキャストの受信を開始できます。ブロードキャスト通知は、モバイル・デバイスおよびブラウザーの全体にインストールされているか Chrome アプリケーションまたはエクステンションとして実装されていて、かつ {{site.data.keyword.mobilepushshort}} サービス用に構成されている、1 つのアプリケーションのすべてのインスタンスをターゲットとしたメッセージです。ブロードキャスト通知は、{{site.data.keyword.mobilepushshort}}が有効になっているすべてのアプリケーションに、デフォルトで有効になっています。{{site.data.keyword.mobilepushshort}}サービスが有効になっているアプリケーションでは、Push.ALL タグへのサブスクリプションが事前定義されています。サーバーはこれを使用して、通知メッセージをすべてのデバイスにブロードキャストします。REST Push API を使用するブロードキャスト通知を送信する場合は、メッセージ・リソースに投稿する際に「target」が空の JSON ファイルであることを確認してください。 - - -###タグ・ベースの通知 -{: tag-based-notifications} - -タグ通知は、特定のタグにサブスクライブしているすべてのデバイスをターゲットとするメッセージです。タグ・ベースの通知では、サブジェクト・エリアまたはトピックに基づいて通知を分割できます。通知の受信側は、関心のあるサブジェクトまたはトピックに関するものであった場合にのみ通知を受信するように選択できます。そのため、タグ・ベースの通知は、受信側を分割する手段を提供します。この機能により、タグを定義した後、タグ別にメッセージの送受信を行うことが可能になります。メッセージは、タグにサブスクライブしている (モバイル上、ブラウザー上、あるいはアプリケーションまたはエクステンションとしての) クライアント・アプリケーション・インスタンスのみをターゲットにします。まず、アプリケーションのタグを作成し、タグ・サブスクリプションをセットアップしてから、タグ・ベースの通知を開始する必要があります。REST API を使用するタグ・ベースの通知を送信する場合は、メッセージ・リソースに投稿する際に「tagNames」が指定されていることを確認してください。 - -###ユニキャスト通知 -{: unicast-notifications} - -ユニキャスト通知は、特定のデバイスまたはユーザーをターゲットとするメッセージです。デバイスをターゲットとするユニキャスト通知は、追加のセットアップを必要とせず、アプリケーションで{{site.data.keyword.mobilepushshort}}が有効になっている場合にデフォルトで有効になります。 - -ただし、ユーザーをターゲットとするユニキャスト通知では、{{site.data.keyword.mobilepushshort}} 用のクライアント・モバイル・デバイスまたは Web ブラウザー、あるいは Chrome アプリケーションおよびエクステンションの登録時に、ユーザー ID をデバイスと関連付ける必要があります。 - -通常、クライアント・アプリケーションは、最初に認証サイクルを実行します。この認証サイクルで、モバイル・アプリケーション・ユーザーは [Mobile Client Access](docs/services/mobileaccess/index.html) などの認証サービスと照合して認証されます。認証に成功すると、認証済みユーザー ID がプッシュ・デバイス登録 API に渡されます。REST API を使用するユニキャスト通知を送信する場合は、メッセージ・リソースに投稿する際に deviceId または userId が指定されていることを確認してください。 - -###プラットフォーム・ベースの通知 -{: platform-based-notifications} - -特定のデバイス・プラットフォームに届くように通知のターゲットを設定することができます。例えば、すべての Android ユーザーまたは Google Chrome ユーザーにのみ通知を送信するようにできます。REST API を使用するプラットフォーム・ベースの通知を送信する場合には、メッセージ・リソースに投稿する際にターゲットのプラットフォームが指定されていることを確認してください。 -プラットフォームを配列として指定します。サポートされるプラットフォームは、以下のとおりです。 -* A (Apple) -* G (Google) -* WEB_CHROME (Google Chrome ブラウザーの Web プッシュ) -* WEB_FIREFOX (Mozilla Firefox ブラウザーの Web プッシュ) -* WEB_SAFARI (Safari ブラウザーの Web プッシュ) -* APPEXT_CHROME (Google Chrome アプリケーション & エクステンション) - -## {{site.data.keyword.mobilepushshort}}のメッセージ・サイズ -{: #push-message-size} - -{{site.data.keyword.mobilepushshort}} のメッセージ・ペイロード・サイズは、ゲートウェイ (FCM/GCM、APNs) およびクライアント・プラットフォームによって課せられる制約に依存します。 - -### iOS および Safari -{: ios-message-size} - -iOS 8 以降では、許容される最大サイズは 2 キロバイトです。Apple プッシュ通知サービスは、この制限を超える通知を送信しません。 - -###Android、Firefox ブラウザー、Chrome ブラウザー、および Chrome アプリケーション & エクステンション -{: android-message-size} - -メッセージ・ペイロードの許容される最大サイズとして、4 キロバイトの制限があります。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}}の概要 +{: #overview-push} +最終更新日: 2017 年 1 月 18 日 +{: .last-updated} + +IBM {{site.data.keyword.mobilepushshort}} は、デバイスおよびプラットフォームに通知を送信するために使用できるサービスです。通知は、すべてのアプリケーション・ユーザーをターゲットとすることも、タグを使用して特定のユーザーおよびデバイスの集合をターゲットとすることもできます。デバイス、タグ、およびサブスクリプションを管理できます。 + + +以下のいずれかのオプションを使用して、バインドまたはアンバインドされたサービスを作成することができます。 + +- カタログから MobileFirst Services Starter ボイラープレートを使用して Bluemix アプリケーションを作成する。これにより、Bluemix バックエンド・アプリケーションにバインドされた Push Notifications (プッシュ通知) サービスが作成されます。 +- モバイル・カタログから直接、アンバウンド Push Notifications (プッシュ通知) サービスを作成する。後でアプリケーションにバインドするか、アンバウンドの状態で使用するよう選択することもできます。 +- [モバイル・ダッシュボード![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}を使用する。 + +なお、{{site.data.keyword.mobilepushshort}}のモニター・タブには、分析データは表示されません。 + +{{site.data.keyword.mobilepushshort}}サービスは、OpenWhisk 対応になりました。詳細については、[OpenWhisk](/docs/openwhisk/index.html) を参照してください。 + + +## {{site.data.keyword.mobilepushshort}}サービスのプロセス +{: #overview_push_process} + +モバイル・クライアント、Web ブラウザー・クライアント、および Google Chrome アプリケーションおよびエクステンションは、{{site.data.keyword.mobilepushshort}} サービスをサブスクライブし、登録することができます。クライアント・アプリケーションは、開始時、{{site.data.keyword.mobilepushshort}}サービスにそれぞれを登録してサブスクライブします。通知は、Apple Push Notification Service (APNs) または Firebase Cloud Messaging (FCM)/Google Cloud Messaging (GCM) サーバーにディスパッチされ、その後、登録済みのモバイル・クライアントまたはブラウザー・クライアントに送信されます。 + +![プッシュの概要](images/overview.jpg) + + +###モバイル・アプリケーションとブラウザー・アプリケーション +{: mobile-applications} + +クライアント・アプリケーションは、通知を受け取るために、開始時に {{site.data.keyword.mobilepushshort}} サービスにそれぞれを登録してサブスクライブします。 + +###バックエンド・アプリケーション +{: backend-applications} + +バックエンド・アプリケーションは、オンプレミスまたはパブリック・クラウドに位置することができます。バックエンド・アプリケーションは、{{site.data.keyword.mobilepushshort}}サービスを使用して、コンテキストに依存した通知をモバイル・アプリケーション・ユーザーとブラウザー・アプリケーション・ユーザーに送信します。バックエンド・アプリケーションは、プッシュ通知を送信するためにモバイル・デバイス、ブラウザー・エージェント、およびユーザーに関する情報を維持し管理する必要はありません。代わりに、バックエンド・アプリケーションは、それらを管理および維持する{{site.data.keyword.mobilepushshort}}サービスを使用することができます。 + +###アプリ・バックエンド所有者 +{: app-backend-owner} + +アプリ・バックエンド所有者は、{{site.data.keyword.mobilepushshort}}サービスのインスタンスをバンドルするモバイル・バックエンド・アプリケーションを作成します。また、アプリ・バックエンド所有者は、{{site.data.keyword.mobilepushshort}}サービスとこのサービスのターゲットとなるモバイル・アプリケーションおよびブラウザー・アプリケーションとを使用するバックエンド・アプリケーションに合うように、{{site.data.keyword.mobilepushshort}}サービスの構成とセットアップも行います。 + +###{{site.data.keyword.mobilepushshort}}サービス +{: push-notification-service} + +{{site.data.keyword.mobilepushshort}}サービスは、通知用に登録されたモバイル・デバイスと Web ブラウザー・クライアントに関するすべての情報を管理します。このサービスは、異機種のモバイル・プラットフォームおよび Web ブラウザー・プラットフォームに通知を送信するテクノロジー詳細がアプリケーションに透過的になるようにし、サービス内部でそのすべてを処理します。 + +###ゲートウェイ +{: gateways} + +モバイル・アプリケーションやブラウザー・アプリケーションに通知をディスパッチするために IBM {{site.data.keyword.mobilepushshort}} サービスが使用する、FCM/GCM または Apple Push Notification Service (APNs) などのプラットフォーム固有のプッシュ通知クラウド・サービス。 + +###プッシュのセキュリティー +{: push-security} + +{{site.data.keyword.mobilepushshort}} API は、次の 2 つのタイプの secret によって保護されています。 + +- **appSecret**: 「appSecret」は、バックエンド・アプリケーションによって通常呼び出される API を保護します。例えば、{{site.data.keyword.mobilepushshort}}を送信する API や設定を構成する API などです。 +- **clientSecret**: 「clientSecret」は、モバイル・クライアント・アプリケーションによって通常呼び出される API を保護します。この「clientSecret」を必要とする関連付けられた UserId を持つデバイスの登録に関与する API は 1 つだけです。その他の API は、clientSecret を必要とするモバイル・クライアントからは呼び出されません。 + +「appSecret」と「clientSecret」は、アプリケーションと{{site.data.keyword.mobilepushshort}}サービスのバインド時にすべてのサービス・インスタンスに割り振られます。secret の受け渡しの方法や、対象の API について詳しくは、[REST APIs ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/)の資料を参照してください。 + +**注**: 以前のアプリケーションでは、userId フィールドが設定されたデバイスを登録または更新する場合にのみ、clientSecret の受け渡しが必要とされました。モバイル・クライアントおよびブラウザー・クライアントによって呼び出されるその他のすべての API では、clientSecret は不要でした。これらの古いアプリケーションでは引き続き、デバイスの登録や呼び出しの更新時にオプションで clientSecret を使用できます。ただし、すべてのクライアント API 呼び出しで clientSecret チェックを実施することを強くお勧めします。これを既存のアプリケーションでも実施するために、新規の「verifyClientSecret」API が公開されています。新規アプリケーションの場合、clientSecret チェックがすべてのクライアント API 呼び出しに対して実施され、この動作は「verfiyClientSecret」API を使用して変更することはできません。 + +デフォルトでは、クライアント秘密鍵検証は新規アプリケーションに対してのみ実施されます。既存のアプリケーションと新規アプリケーションはどちらも、verifyClientSecret REST API を使用して、クライアント秘密鍵検証を使用可能または使用不可にすることができます。applicationId および deviceId を知っている可能性のあるユーザーにデバイスが公開されないようにするために、クライアント秘密鍵検証を実施することをお勧めします。 + +「clientSecret」は常に機密とし、モバイル・アプリケーションへのハードコーディングは絶対に行わないでください。アプリケーションの実行時に「clientSecret」を動的にプルするために使用できる、さまざまなアプリケーション初期化パターンがあります。以下のシーケンス図に、可能なパターンの概要を示します。![通知の使用可能化](images/init_client_secret.jpg) + +## {{site.data.keyword.mobilepushshort}}のタイプ +{: #overview-push-types} + +###ブロードキャスト +{: broadcast} + +クライアント・アプリケーションは、{{site.data.keyword.mobilepushshort}} サービスに自身を登録すると、ブロードキャストの受信を開始できます。ブロードキャスト通知は、モバイル・デバイスおよびブラウザーの全体にインストールされているか Chrome アプリケーションまたはエクステンションとして実装されていて、かつ {{site.data.keyword.mobilepushshort}} サービス用に構成されている、1 つのアプリケーションのすべてのインスタンスをターゲットとしたメッセージです。ブロードキャスト通知は、{{site.data.keyword.mobilepushshort}}が有効になっているすべてのアプリケーションに、デフォルトで有効になっています。{{site.data.keyword.mobilepushshort}}サービスが有効になっているアプリケーションでは、Push.ALL タグへのサブスクリプションが事前定義されています。サーバーはこれを使用して、通知メッセージをすべてのデバイスにブロードキャストします。REST Push API を使用するブロードキャスト通知を送信する場合は、メッセージ・リソースに投稿する際に「target」が空の JSON ファイルであることを確認してください。 + + +###タグ・ベースの通知 +{: tag-based-notifications} + +タグ通知は、特定のタグにサブスクライブしているすべてのデバイスをターゲットとするメッセージです。タグ・ベースの通知では、サブジェクト・エリアまたはトピックに基づいて通知を分割できます。通知の受信側は、関心のあるサブジェクトまたはトピックに関するものであった場合にのみ通知を受信するように選択できます。そのため、タグ・ベースの通知は、受信側を分割する手段を提供します。この機能により、タグを定義した後、タグ別にメッセージの送受信を行うことが可能になります。メッセージは、タグにサブスクライブしている (モバイル上、ブラウザー上、あるいはアプリケーションまたはエクステンションとしての) クライアント・アプリケーション・インスタンスのみをターゲットにします。まず、アプリケーションのタグを作成し、タグ・サブスクリプションをセットアップしてから、タグ・ベースの通知を開始する必要があります。REST API を使用するタグ・ベースの通知を送信する場合は、メッセージ・リソースに投稿する際に「tagNames」が指定されていることを確認してください。 + +###ユニキャスト通知 +{: unicast-notifications} + +ユニキャスト通知は、特定のデバイスまたはユーザーをターゲットとするメッセージです。デバイスをターゲットとするユニキャスト通知は、追加のセットアップを必要とせず、アプリケーションで{{site.data.keyword.mobilepushshort}}が有効になっている場合にデフォルトで有効になります。 + +ただし、ユーザーをターゲットとするユニキャスト通知では、{{site.data.keyword.mobilepushshort}} 用のクライアント・モバイル・デバイスまたは Web ブラウザー、あるいは Chrome アプリケーションおよびエクステンションの登録時に、ユーザー ID をデバイスと関連付ける必要があります。 + +通常、クライアント・アプリケーションは、最初に認証サイクルを実行します。この認証サイクルで、モバイル・アプリケーション・ユーザーは [Mobile Client Access](docs/services/mobileaccess/index.html) などの認証サービスと照合して認証されます。認証に成功すると、認証済みユーザー ID がプッシュ・デバイス登録 API に渡されます。REST API を使用するユニキャスト通知を送信する場合は、メッセージ・リソースに投稿する際に deviceId または userId が指定されていることを確認してください。 + +###プラットフォーム・ベースの通知 +{: platform-based-notifications} + +特定のデバイス・プラットフォームに届くように通知のターゲットを設定することができます。例えば、すべての Android ユーザーまたは Google Chrome ユーザーにのみ通知を送信するようにできます。REST API を使用するプラットフォーム・ベースの通知を送信する場合には、メッセージ・リソースに投稿する際にターゲットのプラットフォームが指定されていることを確認してください。 +プラットフォームを配列として指定します。サポートされるプラットフォームは、以下のとおりです。 +* A (Apple) +* G (Google) +* WEB_CHROME (Google Chrome ブラウザーの Web プッシュ) +* WEB_FIREFOX (Mozilla Firefox ブラウザーの Web プッシュ) +* WEB_SAFARI (Safari ブラウザーの Web プッシュ) +* APPEXT_CHROME (Google Chrome アプリケーション & エクステンション) + +## {{site.data.keyword.mobilepushshort}}のメッセージ・サイズ +{: #push-message-size} + +{{site.data.keyword.mobilepushshort}} のメッセージ・ペイロード・サイズは、ゲートウェイ (FCM/GCM、APNs) およびクライアント・プラットフォームによって課せられる制約に依存します。 + +### iOS および Safari +{: ios-message-size} + +iOS 8 以降では、許容される最大サイズは 2 キロバイトです。Apple プッシュ通知サービスは、この制限を超える通知を送信しません。 + +###Android、Firefox ブラウザー、Chrome ブラウザー、および Chrome アプリケーション & エクステンション +{: android-message-size} + +メッセージ・ペイロードの許容される最大サイズとして、4 キロバイトの制限があります。 diff --git a/services/mobilepush/nl/ja/c_rich_media_notifications.md b/services/mobilepush/nl/ja/c_rich_media_notifications.md index efa9a209d..ebbf4feea 100644 --- a/services/mobilepush/nl/ja/c_rich_media_notifications.md +++ b/services/mobilepush/nl/ja/c_rich_media_notifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# リッチ・メディア通知の使用可能化 -{: #interactive-notifications} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - - -iOS 10 以上でリッチ・メディアの{{site.data.keyword.mobilepushshort}}を有効にすることができます。プッシュ通知は、音声、ビデオ、GIF、およびイメージとともに送信できます。 - -iOS 10 でリッチ・プッシュを受信するようにアプリケーションをセットアップするには、以下を実行します。 - -1. Xcode で、**「File」** > **「New」** > **「Target」** > **「Notification Service Extension」**を選択します。 -2. `UNNotificationServiceExtension` 内のメソッド `didReceive()` に以下のコードを追加します。 -``` -BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) -``` - -リッチ・メディアの{{site.data.keyword.mobilepushshort}}を Push ダッシュボードから送信するには、メッセージ、タイトル、サブタイトル、および attachmentURL の各フィールドを指定するようにしてください。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# リッチ・メディア通知の使用可能化 +{: #interactive-notifications} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + + +iOS 10 以上でリッチ・メディアの{{site.data.keyword.mobilepushshort}}を有効にすることができます。プッシュ通知は、音声、ビデオ、GIF、およびイメージとともに送信できます。 + +iOS 10 でリッチ・プッシュを受信するようにアプリケーションをセットアップするには、以下を実行します。 + +1. Xcode で、**「File」** > **「New」** > **「Target」** > **「Notification Service Extension」**を選択します。 +2. `UNNotificationServiceExtension` 内のメソッド `didReceive()` に以下のコードを追加します。 +``` +BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) +``` + +リッチ・メディアの{{site.data.keyword.mobilepushshort}}を Push ダッシュボードから送信するには、メッセージ、タイトル、サブタイトル、および attachmentURL の各フィールドを指定するようにしてください。 diff --git a/services/mobilepush/nl/ja/c_tag_basednotifications.md b/services/mobilepush/nl/ja/c_tag_basednotifications.md index 0140b68db..40dae5bb3 100644 --- a/services/mobilepush/nl/ja/c_tag_basednotifications.md +++ b/services/mobilepush/nl/ja/c_tag_basednotifications.md @@ -1,21 +1,21 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# タグ・ベースの通知の使用可能化 -{: #tag_based_notifications} -最終更新日: 2017 年 1 月 16 日 -{: .last-updated} - -タグ・ベースの通知メッセージは、特定のタグをサブスクライブしているすべてのデバイスをターゲットとします。 - -タグを定義して、タグを使用したメッセージの送受信を行うことが可能です。 -まず、アプリケーションのタグを作成し、タグ・サブスクリプションをセットアップしてから、タグ・ベースの通知を開始する必要があります。[REST API](https://mobile.{DomainName}/imfpush/){: new_window} を使用してタグ・ベースの通知を送信する場合には、メッセージ・リソースにポストする際に「tagNames」が指定されていることを確認してください。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# タグ・ベースの通知の使用可能化 +{: #tag_based_notifications} +最終更新日: 2017 年 1 月 16 日 +{: .last-updated} + +タグ・ベースの通知メッセージは、特定のタグをサブスクライブしているすべてのデバイスをターゲットとします。 + +タグを定義して、タグを使用したメッセージの送受信を行うことが可能です。 +まず、アプリケーションのタグを作成し、タグ・サブスクリプションをセットアップしてから、タグ・ベースの通知を開始する必要があります。[REST API](https://mobile.{DomainName}/imfpush/){: new_window} を使用してタグ・ベースの通知を送信する場合には、メッセージ・リソースにポストする際に「tagNames」が指定されていることを確認してください。 diff --git a/services/mobilepush/nl/ja/c_user_basednotifications.md b/services/mobilepush/nl/ja/c_user_basednotifications.md index 46f917997..7e2c43388 100644 --- a/services/mobilepush/nl/ja/c_user_basednotifications.md +++ b/services/mobilepush/nl/ja/c_user_basednotifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# ユーザー・ベースの通知の使用可能化 -{: #user_based_notifications} -最終更新日: 2017 年 1 月 16 日 -{: .last-updated} - -ユーザー ID ベースの{{site.data.keyword.mobilepushshort}}は、カスタマイズしたメッセージを使用し、モバイル・アプリ・ユーザーをターゲットとします。ユーザー・ベースの通知では、通知設定に基づいて特定の個人に通知するように選択できます。 - -## ユーザー ID を使用したデバイスの登録 -ユーザー ID によってターゲット指定されるプッシュ通知を有効にするには、必ず、「ユーザー ID」フィールドを設定した状態でデバイスを登録してください。 - -ユーザー ID には、アプリケーションがデバイス登録 API に提供する任意のストリングが可能です。通常、モバイル・アプリケーションはまず、[{{site.data.keyword.amafull}} ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}などの認証サービスに対してモバイル・アプリ・ユーザーを認証する認証サイクルを実行します。認証に成功すると、認証済みユーザー ID がプッシュ・デバイス登録 API に渡されます。 - -## ユーザーのログインおよびログアウトの同期化 - -ユーザーがログインしている場合にのみ通知を送信するようにすることができます。 - -例えば、デバイスが家族や職場のチームのメンバーによって共有されているときに、特定ユーザーに対応する必要がある場合を考えてください。そのようなユース・ケースでは、ユーザー・ログイン/ログアウト・シーケンスを使用できます。この認証メカニズムを使用すると、アプリケーションが、アプリケーションの現在のユーザーの ID を追跡できるようになります。これにより、特定のユーザーをターゲットとした通知は、常にそのユーザーのみが受信するようにできます。正常なログインの後、ログイン・ユーザーのユーザー ID を渡すデバイス登録 API を呼び出します。ログアウトの前にも同様に、デバイス登録抹消 API を呼び出します。これらのプッシュ API を、ログインおよびログアウトと共にシーケンスにすると、特定のユーザー向けの通知がそのユーザーだけに送信されるようになります。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# ユーザー・ベースの通知の使用可能化 +{: #user_based_notifications} +最終更新日: 2017 年 1 月 16 日 +{: .last-updated} + +ユーザー ID ベースの{{site.data.keyword.mobilepushshort}}は、カスタマイズしたメッセージを使用し、モバイル・アプリ・ユーザーをターゲットとします。ユーザー・ベースの通知では、通知設定に基づいて特定の個人に通知するように選択できます。 + +## ユーザー ID を使用したデバイスの登録 +ユーザー ID によってターゲット指定されるプッシュ通知を有効にするには、必ず、「ユーザー ID」フィールドを設定した状態でデバイスを登録してください。 + +ユーザー ID には、アプリケーションがデバイス登録 API に提供する任意のストリングが可能です。通常、モバイル・アプリケーションはまず、[{{site.data.keyword.amafull}} ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}などの認証サービスに対してモバイル・アプリ・ユーザーを認証する認証サイクルを実行します。認証に成功すると、認証済みユーザー ID がプッシュ・デバイス登録 API に渡されます。 + +## ユーザーのログインおよびログアウトの同期化 + +ユーザーがログインしている場合にのみ通知を送信するようにすることができます。 + +例えば、デバイスが家族や職場のチームのメンバーによって共有されているときに、特定ユーザーに対応する必要がある場合を考えてください。そのようなユース・ケースでは、ユーザー・ログイン/ログアウト・シーケンスを使用できます。この認証メカニズムを使用すると、アプリケーションが、アプリケーションの現在のユーザーの ID を追跡できるようになります。これにより、特定のユーザーをターゲットとした通知は、常にそのユーザーのみが受信するようにできます。正常なログインの後、ログイン・ユーザーのユーザー ID を渡すデバイス登録 API を呼び出します。ログアウトの前にも同様に、デバイス登録抹消 API を呼び出します。これらのプッシュ API を、ログインおよびログアウトと共にシーケンスにすると、特定のユーザー向けの通知がそのユーザーだけに送信されるようになります。 diff --git a/services/mobilepush/nl/ja/c_web_extensions.md b/services/mobilepush/nl/ja/c_web_extensions.md index 6963b875d..0f372b4ba 100644 --- a/services/mobilepush/nl/ja/c_web_extensions.md +++ b/services/mobilepush/nl/ja/c_web_extensions.md @@ -1,107 +1,107 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Chrome アプリケーションおよびエクステンションによる {{site.data.keyword.mobilepushshort}} の受信の可能化 -{: #web_notifications} -最終更新日: 2017 年 1 月 18 日 -{: .last-updated} - -Google Chrome のアプリケーションおよび拡張機能を有効にして、{{site.data.keyword.mobilepushshort}} を受信することができます。以下のステップに進む前に、[通知プロバイダーの資格情報の構成](t__main_push_config_provider.html)を確実に実行してください。 - -## {{site.data.keyword.mobilepushshort}} 用のクライアント SDK のインストール -{: #web_install} - -このトピックでは、Chrome アプリケーションおよびエクステンションの開発を促進するために、クライアント JavaScript Push SDK をインストールして使用する方法について説明します。 - -### Google Chrome アプリケーションおよびエクステンションの初期化 - -Chrome アプリケーションおよびエクステンションに Javascript SDK をインストールする場合、以下の手順を実行します。 - -`BMSPushSDK.js` と `manifest_Chrome_Ext.json` (Chrome エクステンションの場合) または `manifest_Chrome_App.json` (Chrome アプリケーションの場合) を [Bluemix Web push SDK ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}からダウンロードします。 - - - -- Chrome アプリケーションの場合、マニフェスト・ファイルを以下のように構成します。 - 1. `manifest_Chrome_App.json` ファイルに、名前、記述、およびアイコンを指定します。 - 2. `BMSPushSDK.js` を `app.background.scripts` に追加します。 - 3. `manifest_Chrome_App.json` を `manifest.json` に変更します。 - -- Chrome エクステンションの場合、マニフェスト・ファイルを以下のように構成します。 - 1. `manifest_Chrome_Ext.json` ファイルに、名前、記述、およびアイコンを指定します。 - 2. `BMSPushSDK.js` を `background.scripts` に追加します。 - 3. `manifest_Chrome_Ext.json` を `manifest.json` に変更します。 - -プッシュ通知を受信するために、`background.js` ファイルに以下を追加します。 -``` -chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) -chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); -chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); -``` - {: codeblock} - - - -## Push SDK の初期化 -{: #web_initialize} - -Bluemix {{site.data.keyword.mobilepushshort}} サービスの `app GUID` と `app Region` を使用して Push SDK を初期化します。 - -app GUID を入手するには、初期化されたプッシュ・サービスのナビゲーション・ペインで**「構成」**オプションを選択し、**「モバイル・オプション」**をクリックします。Bluemix のプッシュ通知サービス appGUID パラメーターを使用するようにコード・スニペットを変更します。 - -`App Region` は、{{site.data.keyword.mobilepushshort}}サービスがホストされる場所を指定します。次の 3 つの値のいずれかを使用できます。 - - - 米国のダラス: `.ng.bluemix.net` - - 英国: `.eu-gb.bluemix.net` - - シドニー: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) -``` - {: codeblock} - -## Chrome アプリケーションおよびエクステンションの登録 -{: #web_register} - -`register()` API を使用して、デバイスを{{site.data.keyword.mobilepushshort}}サービスに登録します。Google Chrome から登録する場合、Firebase Cloud Messaging (FCM) または Google Cloud Messaging (GCM) の API キーと Web サイト URL を、Bluemix {{site.data.keyword.mobilepushshort}} サービス Web 構成ダッシュボードに追加します。詳しくは、[Google Cloud Messaging の資格情報の構成](t_push_provider_android.html)で Chrome 用のセットアップを参照してください。 - -Mozilla Firefox から登録する場合は、Web サイト URL を Bluemix {{site.data.keyword.mobilepushshort}}サービスの Web 構成ダッシュボードで Firefox 用セットアップの下に追加してください。 - -以下のコード・スニペットを使用して、 Bluemix {{site.data.keyword.mobilepushshort}}サービスに登録します。 -``` -var bmsPush = new BMSPush(); -function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Chrome アプリケーションおよびエクステンションによる {{site.data.keyword.mobilepushshort}} の受信の可能化 +{: #web_notifications} +最終更新日: 2017 年 1 月 18 日 +{: .last-updated} + +Google Chrome のアプリケーションおよび拡張機能を有効にして、{{site.data.keyword.mobilepushshort}} を受信することができます。以下のステップに進む前に、[通知プロバイダーの資格情報の構成](t__main_push_config_provider.html)を確実に実行してください。 + +## {{site.data.keyword.mobilepushshort}} 用のクライアント SDK のインストール +{: #web_install} + +このトピックでは、Chrome アプリケーションおよびエクステンションの開発を促進するために、クライアント JavaScript Push SDK をインストールして使用する方法について説明します。 + +### Google Chrome アプリケーションおよびエクステンションの初期化 + +Chrome アプリケーションおよびエクステンションに Javascript SDK をインストールする場合、以下の手順を実行します。 + +`BMSPushSDK.js` と `manifest_Chrome_Ext.json` (Chrome エクステンションの場合) または `manifest_Chrome_App.json` (Chrome アプリケーションの場合) を [Bluemix Web push SDK ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}からダウンロードします。 + + + +- Chrome アプリケーションの場合、マニフェスト・ファイルを以下のように構成します。 + 1. `manifest_Chrome_App.json` ファイルに、名前、記述、およびアイコンを指定します。 + 2. `BMSPushSDK.js` を `app.background.scripts` に追加します。 + 3. `manifest_Chrome_App.json` を `manifest.json` に変更します。 + +- Chrome エクステンションの場合、マニフェスト・ファイルを以下のように構成します。 + 1. `manifest_Chrome_Ext.json` ファイルに、名前、記述、およびアイコンを指定します。 + 2. `BMSPushSDK.js` を `background.scripts` に追加します。 + 3. `manifest_Chrome_Ext.json` を `manifest.json` に変更します。 + +プッシュ通知を受信するために、`background.js` ファイルに以下を追加します。 +``` +chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) +chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); +chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); +``` + {: codeblock} + + + +## Push SDK の初期化 +{: #web_initialize} + +Bluemix {{site.data.keyword.mobilepushshort}} サービスの `app GUID` と `app Region` を使用して Push SDK を初期化します。 + +app GUID を入手するには、初期化されたプッシュ・サービスのナビゲーション・ペインで**「構成」**オプションを選択し、**「モバイル・オプション」**をクリックします。Bluemix のプッシュ通知サービス appGUID パラメーターを使用するようにコード・スニペットを変更します。 + +`App Region` は、{{site.data.keyword.mobilepushshort}}サービスがホストされる場所を指定します。次の 3 つの値のいずれかを使用できます。 + + - 米国のダラス: `.ng.bluemix.net` + - 英国: `.eu-gb.bluemix.net` + - シドニー: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) +``` + {: codeblock} + +## Chrome アプリケーションおよびエクステンションの登録 +{: #web_register} + +`register()` API を使用して、デバイスを{{site.data.keyword.mobilepushshort}}サービスに登録します。Google Chrome から登録する場合、Firebase Cloud Messaging (FCM) または Google Cloud Messaging (GCM) の API キーと Web サイト URL を、Bluemix {{site.data.keyword.mobilepushshort}} サービス Web 構成ダッシュボードに追加します。詳しくは、[Google Cloud Messaging の資格情報の構成](t_push_provider_android.html)で Chrome 用のセットアップを参照してください。 + +Mozilla Firefox から登録する場合は、Web サイト URL を Bluemix {{site.data.keyword.mobilepushshort}}サービスの Web 構成ダッシュボードで Firefox 用セットアップの下に追加してください。 + +以下のコード・スニペットを使用して、 Bluemix {{site.data.keyword.mobilepushshort}}サービスに登録します。 +``` +var bmsPush = new BMSPush(); +function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + diff --git a/services/mobilepush/nl/ja/c_web_extensions_send.md b/services/mobilepush/nl/ja/c_web_extensions_send.md index 43214522e..dbc732e09 100644 --- a/services/mobilepush/nl/ja/c_web_extensions_send.md +++ b/services/mobilepush/nl/ja/c_web_extensions_send.md @@ -1,40 +1,40 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Chrome アプリケーションおよびエクステンションへの基本通知の送信 -{: #web_extensions_notifications} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - -アプリケーションの開発が完了したら、プッシュ通知を送信できます。 - -1. **「通知の送信 (Send Notifications)」**を選択し、**「送信先 (Send To)」**オプションとして**「Web 通知 (Web Notifications)」**を選択することでメッセージを構成します。 -2. **「メッセージ」**フィールドに、配信する必要があるメッセージを入力します。 -3. 以下のオプションの設定を指定することを選択できます。 - - **通知タイトル (Notification Title)**: メッセージ・アラートの見出しとして表示されるテキストです。 - - **通知アイコン URL (Notification Icon URL)**: メッセージにアプリ通知アイコンを付けて配信する必要がある場合、このフィールドにアイコンへのリンクを指定します。 - - **省略キー (Collapse key)**: 省略キーは通知にアタッチされます。デバイスがオフラインのときに、同じ省略キーを持つ複数の通知が連続して到着すると、それらは省略されます。デバイスがオンラインになると、FCM/GCM サーバーから通知を受け取り、同じ省略キーを持つ最新の通知のみを表示します。省略キーが設定されていない場合、新しいメッセージと古いメッセージの両方が将来の配信のために保管されます。 - - **存続時間**: この値は秒単位で設定します。このパラメーターを指定しないと、FCM/GCM サーバーはメッセージを 4 週間保管し、配信を試行します。4 週間が経過すると、有効期限が切れます。可能な値の範囲は、0 から 2,419,200 秒です。 - - **アイドル時は遅延 (Delay when idle)**: デバイスがアイドル状態の場合、通知を配信しないように FCM/GCM サーバーに指示するには、この値を `true` に設定します。デバイスがアイドル状態であっても通知を配信できるようにするには、この値を `false` に設定します。 - - **追加のペイロード (Additional payload)**: 通知用のカスタム・ペイロードの値を指定します。 - -以下のイメージは、ダッシュボードの Chrome アプリケーションおよびエクステンションの通知オプションを示しています。 - - ![「通知」画面](images/push_chrome_extns.jpg) - -## 次のステップ - {: #next_steps_tags} - -基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 - -{{site.data.keyword.mobilepushshort}}サービスの以下の機能をご使用のアプリに追加します。 - タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張通知](t_advance_badge_sound_payload.html)を参照してください。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Chrome アプリケーションおよびエクステンションへの基本通知の送信 +{: #web_extensions_notifications} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + +アプリケーションの開発が完了したら、プッシュ通知を送信できます。 + +1. **「通知の送信 (Send Notifications)」**を選択し、**「送信先 (Send To)」**オプションとして**「Web 通知 (Web Notifications)」**を選択することでメッセージを構成します。 +2. **「メッセージ」**フィールドに、配信する必要があるメッセージを入力します。 +3. 以下のオプションの設定を指定することを選択できます。 + - **通知タイトル (Notification Title)**: メッセージ・アラートの見出しとして表示されるテキストです。 + - **通知アイコン URL (Notification Icon URL)**: メッセージにアプリ通知アイコンを付けて配信する必要がある場合、このフィールドにアイコンへのリンクを指定します。 + - **省略キー (Collapse key)**: 省略キーは通知にアタッチされます。デバイスがオフラインのときに、同じ省略キーを持つ複数の通知が連続して到着すると、それらは省略されます。デバイスがオンラインになると、FCM/GCM サーバーから通知を受け取り、同じ省略キーを持つ最新の通知のみを表示します。省略キーが設定されていない場合、新しいメッセージと古いメッセージの両方が将来の配信のために保管されます。 + - **存続時間**: この値は秒単位で設定します。このパラメーターを指定しないと、FCM/GCM サーバーはメッセージを 4 週間保管し、配信を試行します。4 週間が経過すると、有効期限が切れます。可能な値の範囲は、0 から 2,419,200 秒です。 + - **アイドル時は遅延 (Delay when idle)**: デバイスがアイドル状態の場合、通知を配信しないように FCM/GCM サーバーに指示するには、この値を `true` に設定します。デバイスがアイドル状態であっても通知を配信できるようにするには、この値を `false` に設定します。 + - **追加のペイロード (Additional payload)**: 通知用のカスタム・ペイロードの値を指定します。 + +以下のイメージは、ダッシュボードの Chrome アプリケーションおよびエクステンションの通知オプションを示しています。 + + ![「通知」画面](images/push_chrome_extns.jpg) + +## 次のステップ + {: #next_steps_tags} + +基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 + +{{site.data.keyword.mobilepushshort}}サービスの以下の機能をご使用のアプリに追加します。 + タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張通知](t_advance_badge_sound_payload.html)を参照してください。 diff --git a/services/mobilepush/nl/ja/images/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/ja/images/t_enable_actionable_notifications_ios.md index 9e373a17b..a9212bbdf 100644 --- a/services/mobilepush/nl/ja/images/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/ja/images/t_enable_actionable_notifications_ios.md @@ -1,103 +1,103 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# iOS のアクション可能通知の使用可能化 -{: #enable-actionable-notifications-ios} - -従来のプッシュ通知とは異なり、アクション可能通知は、通知アラートを受け取る際にアプリを開くことなく選択を行うようにユーザーにプロンプトを出します。アクション可能プッシュ通知をアプリケーションで使用可能にするには、以下の指示に従います。 - -1. ユーザー応答アクションを作成します。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. 通知カテゴリーを作成し、アクションを設定します。**UIUserNotificationActionContextDefault** または **UIUserNotificationActionContextMinimal** が有効なコンテキストです。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. 通知設定を作成し、前のステップで作成したカテゴリーを割り当てます。 - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. ローカル通知またはリモート通知を作成し、その通知にカテゴリーの ID を割り当てます。 - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# iOS のアクション可能通知の使用可能化 +{: #enable-actionable-notifications-ios} + +従来のプッシュ通知とは異なり、アクション可能通知は、通知アラートを受け取る際にアプリを開くことなく選択を行うようにユーザーにプロンプトを出します。アクション可能プッシュ通知をアプリケーションで使用可能にするには、以下の指示に従います。 + +1. ユーザー応答アクションを作成します。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. 通知カテゴリーを作成し、アクションを設定します。**UIUserNotificationActionContextDefault** または **UIUserNotificationActionContextMinimal** が有効なコンテキストです。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. 通知設定を作成し、前のステップで作成したカテゴリーを割り当てます。 + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. ローカル通知またはリモート通知を作成し、その通知にカテゴリーの ID を割り当てます。 + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/ja/index.md b/services/mobilepush/nl/ja/index.md index 6a2b0791b..02112c12e 100644 --- a/services/mobilepush/nl/ja/index.md +++ b/services/mobilepush/nl/ja/index.md @@ -1,54 +1,54 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}} 概説 -{: #gettingstartedtemplate} -最終更新日: 2017 年 1 月 19 日 -{: .last-updated} - -{:shortdesc} - -{{site.data.keyword.mobilepushshort}} は、モバイル・カテゴリー内の Bluemix カタログ・サービスとして使用可能であり、モバイルおよび Web のプッシュ通知の送信と管理を可能にします。このサービスは、通知のディスパッチを処理しながら、アプリケーション・ユーザーとデバイス、デバイス・プラットフォーム、および Web ブラウザーとのマッピングを管理します。 - - {{site.data.keyword.mobilepushshort}} は、MobileFirst Services Starter ボイラープレートの一部として、および Bluemix [専用サービス](/docs/dedicated/index.html)として使用可能です。このサービスを使用して、ブロードキャスト、ユニキャスト (deviceID と userID に基づく)、タグ・ベースの通知、Web フックベースの通知だけでなく、リッチ・メディア通知と対話式通知もモバイル・ユーザーと Web ブラウザー・アプリケーション・ユーザーに送信することができます。また、SDK (Software Development Kit) と [REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を使用して、クライアント・アプリケーションをさらに開発することもできます。 - -このサービスでは、ユーザー・データからグラフおよびレポートを生成してプッシュ通知のパフォーマンスのモニターに役立つモニタリング機能も提供されています。[プッシュ通知のモニター](/docs/services/mobilepush/t_push_monitoring.html)を参照してください。 - -{{site.data.keyword.mobilepushshort}} サービスは、以下のプラットフォームでサポートされています。 - -- [iOS および Android のモバイル・デバイス](/docs/services/mobilepush/c_enable_push.html) -- [Google Chrome、Mozilla Firefox、および Safari の Web ブラウザー](/docs/services/mobilepush/c_chrome_firefox_enable.html) -- [Google Chrome アプリケーションおよびエクステンション](/docs/services/mobilepush/c_web_extensions.html) - - -# 関連リンク -{: #rellinks} - -* [概要![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](c_overview_push.html){: new_window} - -## チュートリアルおよびサンプル {:id="samples"} -{: #samples} -* [Android helloPush のサンプル・アプリケーション![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} -- [Cordova のサンプル・アプリケーション![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} -* [iOS helloPush のサンプル・アプリケーション (Swift) ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} - -## SDK -{: #sdk} -* [Android SDK ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} -* [Cordova SDK ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} -* [iOS SDK (Swift) ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} - -## API リファレンス -{: #api} -* [Push API リファレンス (Android) ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} -* [BMS Push API リファレンス iOS (Swift) ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} -* [REST API リファレンス ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window} +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}} 概説 +{: #gettingstartedtemplate} +最終更新日: 2017 年 1 月 19 日 +{: .last-updated} + +{:shortdesc} + +{{site.data.keyword.mobilepushshort}} は、モバイル・カテゴリー内の Bluemix カタログ・サービスとして使用可能であり、モバイルおよび Web のプッシュ通知の送信と管理を可能にします。このサービスは、通知のディスパッチを処理しながら、アプリケーション・ユーザーとデバイス、デバイス・プラットフォーム、および Web ブラウザーとのマッピングを管理します。 + + {{site.data.keyword.mobilepushshort}} は、MobileFirst Services Starter ボイラープレートの一部として、および Bluemix [専用サービス](/docs/dedicated/index.html)として使用可能です。このサービスを使用して、ブロードキャスト、ユニキャスト (deviceID と userID に基づく)、タグ・ベースの通知、Web フックベースの通知だけでなく、リッチ・メディア通知と対話式通知もモバイル・ユーザーと Web ブラウザー・アプリケーション・ユーザーに送信することができます。また、SDK (Software Development Kit) と [REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を使用して、クライアント・アプリケーションをさらに開発することもできます。 + +このサービスでは、ユーザー・データからグラフおよびレポートを生成してプッシュ通知のパフォーマンスのモニターに役立つモニタリング機能も提供されています。[プッシュ通知のモニター](/docs/services/mobilepush/t_push_monitoring.html)を参照してください。 + +{{site.data.keyword.mobilepushshort}} サービスは、以下のプラットフォームでサポートされています。 + +- [iOS および Android のモバイル・デバイス](/docs/services/mobilepush/c_enable_push.html) +- [Google Chrome、Mozilla Firefox、および Safari の Web ブラウザー](/docs/services/mobilepush/c_chrome_firefox_enable.html) +- [Google Chrome アプリケーションおよびエクステンション](/docs/services/mobilepush/c_web_extensions.html) + + +# 関連リンク +{: #rellinks} + +* [概要![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](c_overview_push.html){: new_window} + +## チュートリアルおよびサンプル {:id="samples"} +{: #samples} +* [Android helloPush のサンプル・アプリケーション![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} +- [Cordova のサンプル・アプリケーション![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} +* [iOS helloPush のサンプル・アプリケーション (Swift) ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} + +## SDK +{: #sdk} +* [Android SDK ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} +* [Cordova SDK ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} +* [iOS SDK (Swift) ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} + +## API リファレンス +{: #api} +* [Push API リファレンス (Android) ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} +* [BMS Push API リファレンス iOS (Swift) ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} +* [REST API リファレンス ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window} diff --git a/services/mobilepush/nl/ja/interactive_notifications.md b/services/mobilepush/nl/ja/interactive_notifications.md index ee4d50835..f3a2e27ae 100644 --- a/services/mobilepush/nl/ja/interactive_notifications.md +++ b/services/mobilepush/nl/ja/interactive_notifications.md @@ -1,83 +1,83 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 対話式通知 -{: #interactive-notifications} -最終更新日: 2017 年 1 月 23 日 -{: .last-updated} - -対話式通知により、ユーザーはアプリケーションを開かずに通知に応答することができます。対話式通知が到着すると、デバイスは通知メッセージとともにアクション・ボタンを表示します。対話式通知は、バージョン 8 以降の iOS デバイスでサポートされています。バージョン 8 より前の iOS デバイスに送信された対話式通知については、通知アクションは表示されません。 - -##対話式{{site.data.keyword.mobilepushshort}}の送信 - - -対話式通知は、Push ダッシュボードを使用するか、[REST API 資料](t_restapi.html)を参照して、送信できます。 - -{{site.data.keyword.mobilepushshort}} コンソールから以下を実行します。 - -1. Push ダッシュボードの通知タブで、**「通知の送信」**をクリックします。 -2. 通知の受信側を選択して、**「次へ」**をクリックします。 -3. 「通知の作成」ページで、「タイプ」を「デフォルト」または「混合」のいずれかに設定し、「詳細オプション」タブの下で「カテゴリー」値を指定することで、対話式プッシュを送信できます。クライアント上でカテゴリー値を構成するには、ネイティブ iOS アプリケーション・セクションで**「対話式{{site.data.keyword.mobilepushshort}}の処理 (Handling interactive {{site.data.keyword.mobilepushshort}})」**にチェック・マークを付けます。 - -## iOS アプリケーションでの対話式{{site.data.keyword.mobilepushshort}}の処理 - - -### Swift - -対話式通知を受け取るには、以下の手順を行います。 - -1. リモート通知の受信時にバックグラウンド・タスクを実行するアプリケーション機能を使用可能にします。 -1. アクション・カテゴリーで `BMSPush` SDK を初期化します。 - ``` - let myBMSClient = BMSClient.sharedInstance - myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) - let push = BMSPushClient.sharedInstance - let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) - let notifOptions = BMSPushClientOptions(categoryName: [category]) - push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) - ``` - {: codeblock} - -1. 以下のように、AppDelegate に新しいコールバック・メソッドを実装します。 - ``` - func userNotificationCenter(_ center: UNUserNotificationCenter, - didReceive response: UNNotificationResponse, - withCompletionHandler completionHandler: @escaping () -> Void) { - switch response.actionIdentifier { - case "FIRST": - print("FIRST") - case "SECOND": - print("SECOND") - default: - print("Unknown action") - } - completionHandler - } - ``` - {: codeblock} -5. ユーザーがアクション・ボタンをクリックすると、この新しいコールバック・メソッドが呼び出されます。このメソッドの実装では、指定の ID に関連付けられたタスクを行い、`completionHandler` パラメーター内のブロックを実行する必要があります。 - - -### Cordova - -Cordova iOS アプリケーションで要アクション通知を取得するには、以下のステップを実行します。 - -1. `BMSPush.initialize` メソッド内にカテゴリー・フィールドを追加します。 - ``` - var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} - BMSPush.initialize(appGUID,clientSecret,category); - ``` - {: codeblock} -2. AppDelegate に新しいコールバック・メソッドを実装します。 -3. ユーザーがアクション・ボタンをクリックすると、この新しいコールバック・メソッドが呼び出されます。このメソッドの実装は、指定された ID に関連付けられたタスクを実行し、completionHandler パラメーターでブロックを実行する必要があります。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 対話式通知 +{: #interactive-notifications} +最終更新日: 2017 年 1 月 23 日 +{: .last-updated} + +対話式通知により、ユーザーはアプリケーションを開かずに通知に応答することができます。対話式通知が到着すると、デバイスは通知メッセージとともにアクション・ボタンを表示します。対話式通知は、バージョン 8 以降の iOS デバイスでサポートされています。バージョン 8 より前の iOS デバイスに送信された対話式通知については、通知アクションは表示されません。 + +##対話式{{site.data.keyword.mobilepushshort}}の送信 + + +対話式通知は、Push ダッシュボードを使用するか、[REST API 資料](t_restapi.html)を参照して、送信できます。 + +{{site.data.keyword.mobilepushshort}} コンソールから以下を実行します。 + +1. Push ダッシュボードの通知タブで、**「通知の送信」**をクリックします。 +2. 通知の受信側を選択して、**「次へ」**をクリックします。 +3. 「通知の作成」ページで、「タイプ」を「デフォルト」または「混合」のいずれかに設定し、「詳細オプション」タブの下で「カテゴリー」値を指定することで、対話式プッシュを送信できます。クライアント上でカテゴリー値を構成するには、ネイティブ iOS アプリケーション・セクションで**「対話式{{site.data.keyword.mobilepushshort}}の処理 (Handling interactive {{site.data.keyword.mobilepushshort}})」**にチェック・マークを付けます。 + +## iOS アプリケーションでの対話式{{site.data.keyword.mobilepushshort}}の処理 + + +### Swift + +対話式通知を受け取るには、以下の手順を行います。 + +1. リモート通知の受信時にバックグラウンド・タスクを実行するアプリケーション機能を使用可能にします。 +1. アクション・カテゴリーで `BMSPush` SDK を初期化します。 + ``` + let myBMSClient = BMSClient.sharedInstance + myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) + let push = BMSPushClient.sharedInstance + let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) + let notifOptions = BMSPushClientOptions(categoryName: [category]) + push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) + ``` + {: codeblock} + +1. 以下のように、AppDelegate に新しいコールバック・メソッドを実装します。 + ``` + func userNotificationCenter(_ center: UNUserNotificationCenter, + didReceive response: UNNotificationResponse, + withCompletionHandler completionHandler: @escaping () -> Void) { + switch response.actionIdentifier { + case "FIRST": + print("FIRST") + case "SECOND": + print("SECOND") + default: + print("Unknown action") + } + completionHandler + } + ``` + {: codeblock} +5. ユーザーがアクション・ボタンをクリックすると、この新しいコールバック・メソッドが呼び出されます。このメソッドの実装では、指定の ID に関連付けられたタスクを行い、`completionHandler` パラメーター内のブロックを実行する必要があります。 + + +### Cordova + +Cordova iOS アプリケーションで要アクション通知を取得するには、以下のステップを実行します。 + +1. `BMSPush.initialize` メソッド内にカテゴリー・フィールドを追加します。 + ``` + var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} + BMSPush.initialize(appGUID,clientSecret,category); + ``` + {: codeblock} +2. AppDelegate に新しいコールバック・メソッドを実装します。 +3. ユーザーがアクション・ボタンをクリックすると、この新しいコールバック・メソッドが呼び出されます。このメソッドの実装は、指定された ID に関連付けられたタスクを実行し、completionHandler パラメーターでブロックを実行する必要があります。 diff --git a/services/mobilepush/nl/ja/next_steps_tags.md b/services/mobilepush/nl/ja/next_steps_tags.md index 22ff0b934..ff8200095 100644 --- a/services/mobilepush/nl/ja/next_steps_tags.md +++ b/services/mobilepush/nl/ja/next_steps_tags.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 次のステップ -{: #next_steps_tags} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - -基本通知を正常にセットアップした後、タグ・ベースの通知および詳細オプションの構成を行うことができます。 - -{{site.data.keyword.mobilepushshort}}サービスの以下の機能をご使用のアプリに追加します。 - タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。 -拡張通知オプションを使用する場合は、[拡張プッシュ通知](t_advance_badge_sound_payload.html)を参照してください。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 次のステップ +{: #next_steps_tags} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + +基本通知を正常にセットアップした後、タグ・ベースの通知および詳細オプションの構成を行うことができます。 + +{{site.data.keyword.mobilepushshort}}サービスの以下の機能をご使用のアプリに追加します。 + タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。 +拡張通知オプションを使用する場合は、[拡張プッシュ通知](t_advance_badge_sound_payload.html)を参照してください。 diff --git a/services/mobilepush/nl/ja/silent_notifications.md b/services/mobilepush/nl/ja/silent_notifications.md index 21588df2d..54c0a690f 100644 --- a/services/mobilepush/nl/ja/silent_notifications.md +++ b/services/mobilepush/nl/ja/silent_notifications.md @@ -1,39 +1,39 @@ ------- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# iOS のサイレント通知の処理 -{: #silent-notifications} -最終更新日: 2017 年 1 月 16 日 -{: .last-updated} - -サイレント通知は、デバイスの画面に表示されません。これらの通知は、アプリケーションがバックグラウンドで受け取ります。その結果、アプリケーションは最大で 30 秒までウェイク状態になり、指定されたバックグラウンド・タスクを実行します。ユーザーは、この通知の着信に気付かない可能性があります。iOS のサイレント通知を送信するには、[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を使用します。 - -1. サイレント・プッシュ通知を送信するには、プロジェクトの `appDelegate.m` ファイルで以下のメソッドを実装します。Swift では、サーバーから送信される、サイレント通知の `contentAvailable` 値は 1 になります。 -``` -//For Swift - func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - let contentAPS = userInfo["aps"] as [NSObject : AnyObject] - if let contentAvailable = contentAPS["content-available"] as? Int { - //silent or mixed push - if contentAvailable == 1 { - completionHandler(UIBackgroundFetchResult.NewData) - } else { - completionHandler(UIBackgroundFetchResult.NoData) - } - } else { - //Default notification - completionHandler(UIBackgroundFetchResult.NoData) - } - } -``` - {: codeblock} - +------ + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# iOS のサイレント通知の処理 +{: #silent-notifications} +最終更新日: 2017 年 1 月 16 日 +{: .last-updated} + +サイレント通知は、デバイスの画面に表示されません。これらの通知は、アプリケーションがバックグラウンドで受け取ります。その結果、アプリケーションは最大で 30 秒までウェイク状態になり、指定されたバックグラウンド・タスクを実行します。ユーザーは、この通知の着信に気付かない可能性があります。iOS のサイレント通知を送信するには、[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を使用します。 + +1. サイレント・プッシュ通知を送信するには、プロジェクトの `appDelegate.m` ファイルで以下のメソッドを実装します。Swift では、サーバーから送信される、サイレント通知の `contentAvailable` 値は 1 になります。 +``` +//For Swift + func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + let contentAPS = userInfo["aps"] as [NSObject : AnyObject] + if let contentAvailable = contentAPS["content-available"] as? Int { + //silent or mixed push + if contentAvailable == 1 { + completionHandler(UIBackgroundFetchResult.NewData) + } else { + completionHandler(UIBackgroundFetchResult.NoData) + } + } else { + //Default notification + completionHandler(UIBackgroundFetchResult.NoData) + } + } +``` + {: codeblock} + diff --git a/services/mobilepush/nl/ja/t__main_push_config_provider.md b/services/mobilepush/nl/ja/t__main_push_config_provider.md index 466588787..013fcf4be 100644 --- a/services/mobilepush/nl/ja/t__main_push_config_provider.md +++ b/services/mobilepush/nl/ja/t__main_push_config_provider.md @@ -1,21 +1,21 @@ - ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 通知プロバイダーの資格情報の構成 -{: #create-push-credentials} -最終更新日: 2017 年 1 月 18 日 -{: .last-updated} - -{{site.data.keyword.mobilepushshort}} サービスをセットアップするには、プッシュ通知プロバイダー (Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) または Apple Push Notification service ([APNs](t_push_provider_ios.html))) からモバイル・デバイスに必要な資格情報を取得します。Web ブラウザーについては、[Web ブラウザーの資格情報の構成](t_push_provider_safari.html)を参照してください。 - -{{site.data.keyword.mobilepushshort}} のセットアップは、**IBM Bluemix Services** ダッシュボードを使用するか、[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を使用して実行できます。 + +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 通知プロバイダーの資格情報の構成 +{: #create-push-credentials} +最終更新日: 2017 年 1 月 18 日 +{: .last-updated} + +{{site.data.keyword.mobilepushshort}} サービスをセットアップするには、プッシュ通知プロバイダー (Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) または Apple Push Notification service ([APNs](t_push_provider_ios.html))) からモバイル・デバイスに必要な資格情報を取得します。Web ブラウザーについては、[Web ブラウザーの資格情報の構成](t_push_provider_safari.html)を参照してください。 + +{{site.data.keyword.mobilepushshort}} のセットアップは、**IBM Bluemix Services** ダッシュボードを使用するか、[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を使用して実行できます。 diff --git a/services/mobilepush/nl/ja/t_advance_badge_sound_payload.md b/services/mobilepush/nl/ja/t_advance_badge_sound_payload.md index de04afe94..cd60beffc 100644 --- a/services/mobilepush/nl/ja/t_advance_badge_sound_payload.md +++ b/services/mobilepush/nl/ja/t_advance_badge_sound_payload.md @@ -1,77 +1,77 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#拡張 {{site.data.keyword.mobilepushshort}} の使用可能化 -最終更新日: 2017 年 1 月 23 日 -{: .last-updated} - -iOS バッジ、音声、追加の JSON ペイロード、アクション可能通知、および保留通知を構成します。 - -## 音声、ペイロード、および iOS バッジの構成 -{: #badge-sound-payload} - -iOS のバッジ、音声、および追加の JSON ペイロードを構成します。 - -1. {{site.data.keyword.mobilepushshort}}ダッシュボードで、**「通知」**タブに移動します。 -2. **「オプション・フィールド」**セクションに移動して、{{site.data.keyword.mobilepushshort}}機能を構成します。 - - **音声ファイル (Sound File)** - モバイル・アプリの音声ファイルを指定するストリングを入力します。ペイロードで、使用する音声ファイルのストリング名を指定します。 - - **iOS バッジ (iOS Badge)** - iOS デバイスにアプリ・アイコンのバッジとして表示する数。このプロパティーがないと、バッジは変更されません。バッジを削除するには、このプロパティーの値を 0 に設定します。 - -###Android - -Android アプリケーションの `res/raw` ディレクトリーに音声ファイルを追加します。通知の送信中に、{{site.data.keyword.mobilepushshort}}の音声フィールドに音声ファイル名を追加します。 - -``` -"settings":{ - "gcm":{ - "sound":"tt.wav", - } - } -``` - {: codeblock} - -###iOS - -``` -"settings": { - "apns" : { - "badge": 10, - "sound": "tt.wav", - } -} -``` - {: codeblock} - -**追加のペイロード** - このペイロードは、任意のキーと値のペアにすることができますが、{{site.data.keyword.mobilepushshort}}で送信する JSON オブジェクトでなければなりません。 - -``` -{"key":"value", "key2":"value2"} -``` - {: codeblock} - -## Android 通知の保留 -{: #hold-notifications-android} - -アプリケーションがバックグラウンドになる場合に、アプリケーションに送信された通知を{{site.data.keyword.mobilepushshort}}に保留させたいことがあります。通知を保留するには、{{site.data.keyword.mobilepushshort}}を処理しているアクティビティーの onPause() メソッドで hold() メソッドを呼び出します。 - -``` -@Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 拡張 {{site.data.keyword.mobilepushshort}} の使用可能化 +最終更新日: 2017 年 1 月 23 日 +{: .last-updated} + +iOS バッジ、音声、追加の JSON ペイロード、アクション可能通知、および保留通知を構成します。 + +## 音声、ペイロード、および iOS バッジの構成 +{: #badge-sound-payload} + +iOS のバッジ、音声、および追加の JSON ペイロードを構成します。 + +1. {{site.data.keyword.mobilepushshort}}ダッシュボードで、**「通知」**タブに移動します。 +2. **「オプション・フィールド」**セクションに移動して、{{site.data.keyword.mobilepushshort}}機能を構成します。 + - **音声ファイル (Sound File)** - モバイル・アプリの音声ファイルを指定するストリングを入力します。ペイロードで、使用する音声ファイルのストリング名を指定します。 + - **iOS バッジ (iOS Badge)** - iOS デバイスにアプリ・アイコンのバッジとして表示する数。このプロパティーがないと、バッジは変更されません。バッジを削除するには、このプロパティーの値を 0 に設定します。 + +### Android + +Android アプリケーションの `res/raw` ディレクトリーに音声ファイルを追加します。通知の送信中に、{{site.data.keyword.mobilepushshort}}の音声フィールドに音声ファイル名を追加します。 + +``` +"settings":{ + "gcm":{ + "sound":"tt.wav", + } + } +``` + {: codeblock} + +### iOS + +``` +"settings": { + "apns" : { + "badge": 10, + "sound": "tt.wav", + } +} +``` + {: codeblock} + +**追加のペイロード** - このペイロードは、任意のキーと値のペアにすることができますが、{{site.data.keyword.mobilepushshort}}で送信する JSON オブジェクトでなければなりません。 + +``` +{"key":"value", "key2":"value2"} +``` + {: codeblock} + +## Android 通知の保留 +{: #hold-notifications-android} + +アプリケーションがバックグラウンドになる場合に、アプリケーションに送信された通知を{{site.data.keyword.mobilepushshort}}に保留させたいことがあります。通知を保留するには、{{site.data.keyword.mobilepushshort}}を処理しているアクティビティーの onPause() メソッドで hold() メソッドを呼び出します。 + +``` +@Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} + + diff --git a/services/mobilepush/nl/ja/t_android_create_unbound_service.md b/services/mobilepush/nl/ja/t_android_create_unbound_service.md index 31a2601d7..0bb6df0d8 100644 --- a/services/mobilepush/nl/ja/t_android_create_unbound_service.md +++ b/services/mobilepush/nl/ja/t_android_create_unbound_service.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Android 用のアンバインド・{{site.data.keyword.mobilepushshort}}サービスの作成 -{: #create_android_unbound} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - -{{site.data.keyword.mobilepushshort}}サービス・インスタンスを作成します。バックエンド・アプリケーションにバインドせずに、{{site.data.keyword.mobilepushshort}}サービス・インスタンスを使用することができます。 - -1. {{site.data.keyword.mobilepushshort}}サービス・インスタンスを Bluemix アプリケーションにバインドします。バインドすると、サービスに関連するすべての詳細が、JSON 形式で VCAP_SERVICES 環境変数に保管されていることを確認できます。 - -![プッシュ通知サービスのバインド](images/unbound_1.jpg) - 2. **「バインド」**をクリックして、バインドする{{site.data.keyword.mobilepushshort}}サービス・インスタンスを選択します。アプリケーションが{{site.data.keyword.mobilepushshort}}サービスにバインドされると、サービスに関する情報が JSON 形式でアプリの VCAP_SERVICES 環境変数に保管されます。例えば、次のようにします。 -``` - { - "imfpush_Dev": [ - { - "name": "myname_sampleUnbound", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": null - } - ] - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Android 用のアンバインド・{{site.data.keyword.mobilepushshort}}サービスの作成 +{: #create_android_unbound} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + +{{site.data.keyword.mobilepushshort}}サービス・インスタンスを作成します。バックエンド・アプリケーションにバインドせずに、{{site.data.keyword.mobilepushshort}}サービス・インスタンスを使用することができます。 + +1. {{site.data.keyword.mobilepushshort}}サービス・インスタンスを Bluemix アプリケーションにバインドします。バインドすると、サービスに関連するすべての詳細が、JSON 形式で VCAP_SERVICES 環境変数に保管されていることを確認できます。 + +![プッシュ通知サービスのバインド](images/unbound_1.jpg) + 2. **「バインド」**をクリックして、バインドする{{site.data.keyword.mobilepushshort}}サービス・インスタンスを選択します。アプリケーションが{{site.data.keyword.mobilepushshort}}サービスにバインドされると、サービスに関する情報が JSON 形式でアプリの VCAP_SERVICES 環境変数に保管されます。例えば、次のようにします。 +``` + { + "imfpush_Dev": [ + { + "name": "myname_sampleUnbound", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": null + } + ] + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/ja/t_android_initialize.md b/services/mobilepush/nl/ja/t_android_initialize.md index 9564232ce..39ea12038 100644 --- a/services/mobilepush/nl/ja/t_android_initialize.md +++ b/services/mobilepush/nl/ja/t_android_initialize.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Android アプリ用の Push SDK の初期化 -{: #android_initialize} - -初期化コードを配置する一般的な場所は、Android アプリケーション内のメインアクティビティーの onCreate メソッド内です。 - -Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路とアプリケーション GUID を取得します。これらの値を、経路とアプリ GUID に使用します。コード・スニペットを変更して、Bluemix アプリの appRoute パラメーターと appGUID パラメーターを使用するようにします。 - - -##Core SDK を初期化します。 - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -Bluemix で作成したサーバー・アプリケーションに割り当てられた経路を指定します。 - -**AppGUID** - -Bluemix で作成したアプリケーションに割り当てられた固有キーを指定します。この値では、大/小文字が区別されます。 - -**bluemixRegionSuffix** - -アプリがホストされている場所を指定します。次の 3 つの値のいずれかを使用できます。 - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##クライアント Push SDK を初期化します。 - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Android アプリ用の Push SDK の初期化 +{: #android_initialize} + +初期化コードを配置する一般的な場所は、Android アプリケーション内のメインアクティビティーの onCreate メソッド内です。 + +Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路とアプリケーション GUID を取得します。これらの値を、経路とアプリ GUID に使用します。コード・スニペットを変更して、Bluemix アプリの appRoute パラメーターと appGUID パラメーターを使用するようにします。 + + +##Core SDK を初期化します。 + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +Bluemix で作成したサーバー・アプリケーションに割り当てられた経路を指定します。 + +**AppGUID** + +Bluemix で作成したアプリケーションに割り当てられた固有キーを指定します。この値では、大/小文字が区別されます。 + +**bluemixRegionSuffix** + +アプリがホストされている場所を指定します。次の 3 つの値のいずれかを使用できます。 + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +##クライアント Push SDK を初期化します。 + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` diff --git a/services/mobilepush/nl/ja/t_android_install_sdk.md b/services/mobilepush/nl/ja/t_android_install_sdk.md index 63e46ab4b..e8c40845c 100644 --- a/services/mobilepush/nl/ja/t_android_install_sdk.md +++ b/services/mobilepush/nl/ja/t_android_install_sdk.md @@ -1,213 +1,213 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Gradle を使用したクライアント Push SDK のインストール -{: #android_install} - -このセクションでは、Android アプリケーションをさらに開発するためにクライアント Push SDK をインストールして使用する方法について説明します。 - -Bluemix® モバイル・サービスの Push SDK は、Gradle を使用して追加できます。Gradle は自動的に成果物をリポジトリーからダウンロードして、Android アプリケーションで使用できるようにします。Android Studio および Android Studio SDK を正しくセットアップしてください。システムのセットアップ方法について詳しくは、[Android Studio 概要](https://developer.android.com/tools/studio/index.html)を参照してください。Gradle については、[Configuring Gradle Builds](http://developer.android.com/tools/building/configuring-gradle.html) を参照してください。 - -1. Android Studio で、モバイル・アプリケーションを作成して開いてから、アプリケーションの **build.gradle** ファイルを開きます。次に、以下の依存関係をモバイル・アプリケーションに追加します。これらのインポート・ステートメントは、以下のコード・スニペットに必要です。 - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - - -1. 以下の依存関係をモバイル・アプリケーションに追加します。以下のコード行により、Bluemix™ Mobile Services Push クライアント SDK と Google Play サービス SDK をコンパイル有効範囲の依存関係に追加します。 - - ``` - dependencies { - compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' -compile 'com.google.android.gms:play-services:7.8.0' -} - ``` -1. **AndroidManifest.xml** ファイルに、以下のアクセス権を追加します。サンプル・マニフェストを表示するには、[Android helloPush Sample Application (Android helloPush サンプル・アプリケーション)](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml)を参照してください。 サンプル Gradle ファイルを表示するには、[Sample Build Gradle file (サンプル Build Gradle ファイル)](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle) を参照してください。 - - ``` - - - - - - - - -``` - - ここに、[Android のアクセス権](http://developer.android.com/guide/topics/security/permissions.html)の詳しい説明があります。 - -1. アクティビティーの通知インテント設定を追加します。この設定により、ユーザーが通知エリアで受信した通知をクリックすると、アプリケーションが開始します。 - - ``` - - - - - ``` - **注**: 上記のアクション内の *Your_Android_Package_Name* を、アプリケーションで使用されているアプリケーション・パッケージ名に置き換えてください。 - -1. RECEIVE イベント通知のための Google Cloud Messaging (GCM) インテント・サービスおよびインテント・フィルターを追加します。 - - ``` - service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> - - - - - - - - - - - - - - ``` - - - -# Android アプリ用の Push SDK の初期化 -{: #android_initialize} - -初期化コードを配置する一般的な場所は、Android アプリケーション内のメインアクティビティーの onCreate メソッド内です。 - -Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路とアプリケーション GUID を取得します。これらの値を、経路とアプリ GUID に使用します。コード・スニペットを変更して、Bluemix アプリの appRoute パラメーターと appGUID パラメーターを使用するようにします。 - - -##Core SDK を初期化します。 - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -Bluemix で作成したサーバー・アプリケーションに割り当てられた経路を指定します。 - -**AppGUID** - -Bluemix で作成したアプリケーションに割り当てられた固有キーを指定します。この値では、大/小文字が区別されます。 - -**bluemixRegionSuffix** - -アプリがホストされている場所を指定します。次の 3 つの値のいずれかを使用できます。 - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##クライアント Push SDK を初期化します。 - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` - - - -# Android デバイスの登録 -{: #android_register} - -`IMFPush.register()` API を使用して Push Notification Service にデバイスを登録します。Android デバイスを登録する場合、まず、Google Cloud Messaging (GCM) 情報を Bluemix プッシュ・サービス構成ダッシュボードに追加します。詳しくは、[Google Cloud Messaging の資格情報の構成](t_push_provider_android.html)を参照してください。 - -以下のコード・スニペットを Android モバイル・アプリケーションにコピーして貼り付けます。 - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` - - - -# Android デバイスでのプッシュ通知の受け取り -{: #android_receive} - -notificationListener オブジェクトを Push に登録するには、**MFPPush.listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドから呼び出されます。 - -1. notificationListener オブジェクトを Push に登録するには、**listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドから呼び出されます。 - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } - ``` -2. プロジェクトをビルドし、デバイスまたはエミュレーター上で実行します。register() メソッド内で応答リスナーに onSuccess() メソッドを呼び出す際に、デバイスが Push Notification Service に正常に登録されていることを確認します。この時点で、『基本プッシュ通知の送信』に説明されている方法でメッセージを送信できます。 -3. デバイスが通知を受信していることを確認します。アプリケーションがフォアグラウンドにある場合は、通知は **MFPPushNotificationListener** により処理されます。アプリケーションがバックグラウンドにある場合は、メッセージが通知バーに表示されます。 - - - - -# 基本プッシュ通知の送信 - -{: #push-send-notifications} - -アプリケーションを開発したら、(タグ、バッジ、追加のペイロード、音声ファイルを使用することなく) 基本プッシュ通知を送信できます。 - - -基本プッシュ通知の送信を行います。 - -1. **「対象者の選択 (Choose the Audience)」**で、**「すべてのデバイス (All Devices)」**、またはプラットフォームに従って**「iOS デバイスのみ (Only iOS devices)」**または**「Android デバイスのみ (Only Anroid devices)」**のいずれかの対象者を選択します。 - **注**: **「すべてのデバイス (All Devices)」**オプションを選択すると、プッシュ通知をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 - - ![「通知」画面](images/tag_notification.jpg) - -2. **「通知の作成 (Create your Notification)」**にメッセージを入力し、次に**「送信」**をクリックします。 -3. デバイスが通知を受信していることを確認します。 - - 次のスクリーン・ショットは、Android および iOS のデバイスのフォアグラウンドでプッシュ通知を処理しているアラート・ボックスを示しています。 - - ![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) - - ![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) - - 次のスクリーン・ショットは、Android のバックグラウンドでのプッシュ通知を示しています。 - ![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) - - - -# 次のステップ -{: #next_steps_tags} - -基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 - -以下の Push Notifications Service の機能をご使用のアプリに追加します。タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張プッシュ通知](t_advance_notifications.html)を参照してください。 +--- + +copyright: + years: 2015, 2016 + +--- + +# Gradle を使用したクライアント Push SDK のインストール +{: #android_install} + +このセクションでは、Android アプリケーションをさらに開発するためにクライアント Push SDK をインストールして使用する方法について説明します。 + +Bluemix® モバイル・サービスの Push SDK は、Gradle を使用して追加できます。Gradle は自動的に成果物をリポジトリーからダウンロードして、Android アプリケーションで使用できるようにします。Android Studio および Android Studio SDK を正しくセットアップしてください。システムのセットアップ方法について詳しくは、[Android Studio 概要](https://developer.android.com/tools/studio/index.html)を参照してください。Gradle については、[Configuring Gradle Builds](http://developer.android.com/tools/building/configuring-gradle.html) を参照してください。 + +1. Android Studio で、モバイル・アプリケーションを作成して開いてから、アプリケーションの **build.gradle** ファイルを開きます。次に、以下の依存関係をモバイル・アプリケーションに追加します。これらのインポート・ステートメントは、以下のコード・スニペットに必要です。 + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + + +1. 以下の依存関係をモバイル・アプリケーションに追加します。以下のコード行により、Bluemix™ Mobile Services Push クライアント SDK と Google Play サービス SDK をコンパイル有効範囲の依存関係に追加します。 + + ``` + dependencies { + compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' +compile 'com.google.android.gms:play-services:7.8.0' +} + ``` +1. **AndroidManifest.xml** ファイルに、以下のアクセス権を追加します。サンプル・マニフェストを表示するには、[Android helloPush Sample Application (Android helloPush サンプル・アプリケーション)](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml)を参照してください。 サンプル Gradle ファイルを表示するには、[Sample Build Gradle file (サンプル Build Gradle ファイル)](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle) を参照してください。 + + ``` + + + + + + + + +``` + + ここに、[Android のアクセス権](http://developer.android.com/guide/topics/security/permissions.html)の詳しい説明があります。 + +1. アクティビティーの通知インテント設定を追加します。この設定により、ユーザーが通知エリアで受信した通知をクリックすると、アプリケーションが開始します。 + + ``` + + + + + ``` + **注**: 上記のアクション内の *Your_Android_Package_Name* を、アプリケーションで使用されているアプリケーション・パッケージ名に置き換えてください。 + +1. RECEIVE イベント通知のための Google Cloud Messaging (GCM) インテント・サービスおよびインテント・フィルターを追加します。 + + ``` + service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> + + + + + + + + + + + + + + ``` + + + +# Android アプリ用の Push SDK の初期化 +{: #android_initialize} + +初期化コードを配置する一般的な場所は、Android アプリケーション内のメインアクティビティーの onCreate メソッド内です。 + +Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路とアプリケーション GUID を取得します。これらの値を、経路とアプリ GUID に使用します。コード・スニペットを変更して、Bluemix アプリの appRoute パラメーターと appGUID パラメーターを使用するようにします。 + + +## Core SDK を初期化します。 + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +Bluemix で作成したサーバー・アプリケーションに割り当てられた経路を指定します。 + +**AppGUID** + +Bluemix で作成したアプリケーションに割り当てられた固有キーを指定します。この値では、大/小文字が区別されます。 + +**bluemixRegionSuffix** + +アプリがホストされている場所を指定します。次の 3 つの値のいずれかを使用できます。 + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +## クライアント Push SDK を初期化します。 + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` + + + +# Android デバイスの登録 +{: #android_register} + +`IMFPush.register()` API を使用して Push Notification Service にデバイスを登録します。Android デバイスを登録する場合、まず、Google Cloud Messaging (GCM) 情報を Bluemix プッシュ・サービス構成ダッシュボードに追加します。詳しくは、[Google Cloud Messaging の資格情報の構成](t_push_provider_android.html)を参照してください。 + +以下のコード・スニペットを Android モバイル・アプリケーションにコピーして貼り付けます。 + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` + + + +# Android デバイスでのプッシュ通知の受け取り +{: #android_receive} + +notificationListener オブジェクトを Push に登録するには、**MFPPush.listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドから呼び出されます。 + +1. notificationListener オブジェクトを Push に登録するには、**listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドから呼び出されます。 + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } + ``` +2. プロジェクトをビルドし、デバイスまたはエミュレーター上で実行します。register() メソッド内で応答リスナーに onSuccess() メソッドを呼び出す際に、デバイスが Push Notification Service に正常に登録されていることを確認します。この時点で、『基本プッシュ通知の送信』に説明されている方法でメッセージを送信できます。 +3. デバイスが通知を受信していることを確認します。アプリケーションがフォアグラウンドにある場合は、通知は **MFPPushNotificationListener** により処理されます。アプリケーションがバックグラウンドにある場合は、メッセージが通知バーに表示されます。 + + + + +# 基本プッシュ通知の送信 + +{: #push-send-notifications} + +アプリケーションを開発したら、(タグ、バッジ、追加のペイロード、音声ファイルを使用することなく) 基本プッシュ通知を送信できます。 + + +基本プッシュ通知の送信を行います。 + +1. **「対象者の選択 (Choose the Audience)」**で、**「すべてのデバイス (All Devices)」**、またはプラットフォームに従って**「iOS デバイスのみ (Only iOS devices)」**または**「Android デバイスのみ (Only Anroid devices)」**のいずれかの対象者を選択します。 + **注**: **「すべてのデバイス (All Devices)」**オプションを選択すると、プッシュ通知をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 + + ![「通知」画面](images/tag_notification.jpg) + +2. **「通知の作成 (Create your Notification)」**にメッセージを入力し、次に**「送信」**をクリックします。 +3. デバイスが通知を受信していることを確認します。 + + 次のスクリーン・ショットは、Android および iOS のデバイスのフォアグラウンドでプッシュ通知を処理しているアラート・ボックスを示しています。 + + ![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) + + ![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) + + 次のスクリーン・ショットは、Android のバックグラウンドでのプッシュ通知を示しています。 + ![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) + + + +# 次のステップ +{: #next_steps_tags} + +基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 + +以下の Push Notifications Service の機能をご使用のアプリに追加します。タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張プッシュ通知](t_advance_notifications.html)を参照してください。 diff --git a/services/mobilepush/nl/ja/t_android_receive.md b/services/mobilepush/nl/ja/t_android_receive.md index 3249a59ac..efb151699 100644 --- a/services/mobilepush/nl/ja/t_android_receive.md +++ b/services/mobilepush/nl/ja/t_android_receive.md @@ -1,25 +1,25 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Android デバイスでのプッシュ通知の受け取り -{: #android_receive} - -notificationListener オブジェクトを Push に登録するには、**MFPPush.listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドから呼び出されます。 - -1. notificationListener オブジェクトを Push に登録するには、**listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドから呼び出されます。 - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` -2. プロジェクトをビルドし、デバイスまたはエミュレーター上で実行します。register() メソッド内で応答リスナーに onSuccess() メソッドを呼び出す際に、デバイスが Push Notification Service に正常に登録されていることを確認します。この時点で、『基本プッシュ通知の送信』に説明されている方法でメッセージを送信できます。 -3. デバイスが通知を受信していることを確認します。アプリケーションがフォアグラウンドにある場合は、通知は **MFPPushNotificationListener** により処理されます。アプリケーションがバックグラウンドにある場合は、メッセージが通知バーに表示されます。 +--- + +copyright: + years: 2015, 2016 + +--- + +# Android デバイスでのプッシュ通知の受け取り +{: #android_receive} + +notificationListener オブジェクトを Push に登録するには、**MFPPush.listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドから呼び出されます。 + +1. notificationListener オブジェクトを Push に登録するには、**listen()** メソッドを呼び出します。このメソッドは通常、プッシュ通知を処理しているアクティビティーの **onResume()** メソッドから呼び出されます。 + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` +2. プロジェクトをビルドし、デバイスまたはエミュレーター上で実行します。register() メソッド内で応答リスナーに onSuccess() メソッドを呼び出す際に、デバイスが Push Notification Service に正常に登録されていることを確認します。この時点で、『基本プッシュ通知の送信』に説明されている方法でメッセージを送信できます。 +3. デバイスが通知を受信していることを確認します。アプリケーションがフォアグラウンドにある場合は、通知は **MFPPushNotificationListener** により処理されます。アプリケーションがバックグラウンドにある場合は、メッセージが通知バーに表示されます。 diff --git a/services/mobilepush/nl/ja/t_android_register.md b/services/mobilepush/nl/ja/t_android_register.md index 4c817a596..2bca280c7 100644 --- a/services/mobilepush/nl/ja/t_android_register.md +++ b/services/mobilepush/nl/ja/t_android_register.md @@ -1,38 +1,38 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Android デバイスの登録 -{: #android_register} - -`IMFPush.register()` API を使用して Push Notification Service にデバイスを登録します。Android デバイスを登録する場合、まず、Google Cloud Messaging (GCM) 情報を Bluemix プッシュ・サービス構成ダッシュボードに追加します。詳しくは、[Google Cloud Messaging の資格情報の構成](t_push_provider_android.html)を参照してください。 - -以下のコード・スニペットを Android モバイル・アプリケーションにコピーして貼り付けます。 - - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Android デバイスの登録 +{: #android_register} + +`IMFPush.register()` API を使用して Push Notification Service にデバイスを登録します。Android デバイスを登録する場合、まず、Google Cloud Messaging (GCM) 情報を Bluemix プッシュ・サービス構成ダッシュボードに追加します。詳しくは、[Google Cloud Messaging の資格情報の構成](t_push_provider_android.html)を参照してください。 + +以下のコード・スニペットを Android モバイル・アプリケーションにコピーして貼り付けます。 + + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` diff --git a/services/mobilepush/nl/ja/t_cordova_initialize.md b/services/mobilepush/nl/ja/t_cordova_initialize.md index 1fc358298..85c0cd260 100644 --- a/services/mobilepush/nl/ja/t_cordova_initialize.md +++ b/services/mobilepush/nl/ja/t_cordova_initialize.md @@ -1,30 +1,30 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} - -# Cordova プラグインの初期化 -{: #cordova_enable} - -Push Notification Service の Cordova プラグインを使用するには、事前に、アプリケーション経路とアプリケーション GUID を受け渡すことでプラグインを初期化しておく必要があります。 -プラグインを初期化したら、Bluemix ダッシュボードで作成したサーバー・アプリに接続することができます。Cordova プラグインは、Cordova アプリが Bluemix サービスと通信できるようにするための Android および iOS のクライアント SDK のラッパーです。 - -1. 以下のコード・スニペットをメイン JavaScript ファイル (通常、**www/js** ディレクトリーの下にある) にコピー・アンド・ペーストして、BMSClient を初期化します。 - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd");``` -1. Bluemix の Route パラメーターと appGUID パラメーターを使用するように、コード・スニペットを変更します。Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路とアプリ GUID を取得します。この経路とアプリ GUID の値を `BMSClient.initialize` コード・スニペットのパラメーターとして使用します。 - - - **注**: Cordova CLI (例えば、Cordova の create app-name コマンド) を使用して Cordova アプリを作成した場合、この Javascript コードを **index.js** ファイルの `onDeviceReady: function()` 関数内の `app.receivedEvent` 関数の後に置いて BMS クライアントを初期化します。 - - ``` - onDeviceReady: function() {app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` -1. 次のステップ。[デバイスの登録](t_cordova_register.html)を行います。 +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} + +# Cordova プラグインの初期化 +{: #cordova_enable} + +Push Notification Service の Cordova プラグインを使用するには、事前に、アプリケーション経路とアプリケーション GUID を受け渡すことでプラグインを初期化しておく必要があります。 +プラグインを初期化したら、Bluemix ダッシュボードで作成したサーバー・アプリに接続することができます。Cordova プラグインは、Cordova アプリが Bluemix サービスと通信できるようにするための Android および iOS のクライアント SDK のラッパーです。 + +1. 以下のコード・スニペットをメイン JavaScript ファイル (通常、**www/js** ディレクトリーの下にある) にコピー・アンド・ペーストして、BMSClient を初期化します。 + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd");``` +1. Bluemix の Route パラメーターと appGUID パラメーターを使用するように、コード・スニペットを変更します。Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路とアプリ GUID を取得します。この経路とアプリ GUID の値を `BMSClient.initialize` コード・スニペットのパラメーターとして使用します。 + + + **注**: Cordova CLI (例えば、Cordova の create app-name コマンド) を使用して Cordova アプリを作成した場合、この Javascript コードを **index.js** ファイルの `onDeviceReady: function()` 関数内の `app.receivedEvent` 関数の後に置いて BMS クライアントを初期化します。 + + ``` + onDeviceReady: function() {app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` +1. 次のステップ。[デバイスの登録](t_cordova_register.html)を行います。 diff --git a/services/mobilepush/nl/ja/t_cordova_install.md b/services/mobilepush/nl/ja/t_cordova_install.md index a0b6d3c0c..bab0f8c50 100644 --- a/services/mobilepush/nl/ja/t_cordova_install.md +++ b/services/mobilepush/nl/ja/t_cordova_install.md @@ -1,374 +1,374 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Cordova の Push プラグインのインストール -{: #cordova_install} - -Cordova アプリケーションをさらに開発するために、クライアントの Push プラグインをインストールして使用します。これにより、Cordova Core のプラグインもインストールされます。これは、Bluemix への接続を初期化するものです。 - - -### 始めに - -1. 最新バージョンの Android Studio SDK と Xcode をダウンロードします。 -1. エミュレーターをセットアップします。Android Studio では、Google Play API をサポートするエミュレーターを使用します。 -1. Git のコマンド・ライン・ツールをインストールします。Windows では、必ず **「Windows コマンド・プロンプトから Git を実行する (Run Git from the Window Command Prompt)」**オプションを選択してください。このツールのダウンロードとインストールの方法については、[Git](https://git-scm.com/downloads) を参照してください。 - -1. Node.js と Node Package Manager (NPM) ツールをインストールします。NPM コマンド・ライン・ツールは Node.js とバンドルされています。Node.js のダウンロードとインストールの方法については、[Node.js](https://nodejs.org/en/download/) を参照してください。 -1. コマンド・ラインから、**npm install -g cordova** コマンドを使用して、Cordova コマンド・ライン・ツールをインストールします。これは、Cordova の Push プラグインを使用するために必要です。 -Cordova のインストールと Cordova アプリのセットアップの方法については、[Cordova Apache](https://cordova.apache.org/#getstarted) を参照してください。 - - **注**: Cordova の Push プラグインの readme ファイルを確認する場合は、[https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) にアクセスしてください。 - - -## Cordova の Push プラグインのインストール -1. Cordova アプリを作成するフォルダーに移動し、次のコマンドを実行して Cordova アプリケーションを作成します。 -既存の Cordova アプリがある場合は、ステップ 3 に進みます。 - -``` -cordova create your_app_name -cd your_app_name -``` -1. オプション: (オプション) **config.xml** ファイルを編集し、 エレメント内のアプリケーション名を、デフォルトの HelloCordova という名前ではなく、自分で選択した名前に変更します。 - - **注**: 正しいバンドル ID を指定してください。正しいバンドル ID を指定しないと、Xcode に次のエラー・メッセージが表示されます。 - * 実行可能ファイルの署名に使用された資格が無効です (The executable was signed with invalid entitlements.) - * アプリケーションのコード署名資格ファイルに指定された資格が、プロビジョニング・プロファイルに指定された資格と一致しません (The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile.) - - この問題を修正するには、Xcode または Cordova アプリ **config.xml** ファイルに正しいバンドル ID を指定します。 - -1. サポートされる最低レベルの API またはデプロイメント・ターゲット (Deployment Target) の宣言を、Cordova アプリケーションの config.xml ファイルに追加します。minSdkVersion の値は、15 より高くなければなりません。targetSdkVersion の値は、常に、Google から入手可能な最新の Android SDK を反映している必要があります。 - * **Android** - ご使用のエディターで config.xml ファイルを開き、`` エレメントを最低レベルのターゲット SDK バージョンに更新します。 - - ``` - - - - - - ``` - * **iOS** - エレメントを、デプロイメント・ターゲット (Deployment Target) の宣言で更新します。 - - ``` - - - - - ``` - -1. Cordova コマンド・ライン・インターフェース (CLI) から、以下のコマンドを使用して、プラットフォーム (iOS、Android、またはその両方) を追加します。 - - ``` - cordova platform add ios@3.9.0 - cordova platform add android - ``` -1. Cordova アプリケーションのルート・ディレクトリーで、以下のコマンドを入力して Cordova の Push プラグイン **cordova plugin add ibm-mfp-push** をインストールします。 - - 追加したプラットフォームに応じて、以下のような内容が表示されます。 - - ``` - Installing "ibm-mfp-push" for android - Installing "ibm-mfp-push" for ios - ``` -1. *your-app-root-folder* から、コマンド **cordova plugin list** を使用して、Cordova の Core および Push のプラグインが正常にインストールされたことを確認します。 - - 追加したプラットフォームに応じて、以下のような内容が表示されます。 - - ``` - ibm-mfp-core 1.0.0 "MFPCore" - ibm-mfp-push 1.0.0 “MFPPush" - ``` -1. (iOS のみ) - iOS 開発環境を構成します。a. Xcode を使用して、*your-app-name***/platforms/ios** ディレクトリーにある your-app-name.xcodeproj ファイルを開きます。 - - b. ブリッジング・ヘッダーを追加します。**「ビルド設定」>「Swift コンパイラー - コード生成」>「 Objective-C ブリッジング・ヘッダー」**に移動し、パス *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** を追加します。 - - c. Frameworks パラメーターを追加します。**「ビルド設定」>「 リンク」>「実行パス検索パス (Runpath Search Paths)」**に移動し、以下のパラメーターを追加します。 - ``` - @executable_path/Frameworks - ``` - d. ブリッジング・ヘッダーの以下の Push インポート・ステートメントをアンコメントします。*your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** に移動します。 - - ``` - //#import - //#import - //#import - ``` - e. Xcode で、アプリケーションをビルドして実行します。 -1. (Android のみ)- コマンド **cordova build android** を使用して、Android プロジェクトをビルドします。 - - **注**: Android Studio でプロジェクトを開く前に、最初に Cordova CLI を使用して Cordova アプリケーションをビルドする必要があります。そうしないと、ビルド・エラーが発生します。 - - -# Cordova プラグインの初期化 -{: #cordova_initialize} - -Push Notification Service の Cordova プラグインを使用するには、事前に、アプリケーション経路とアプリケーション GUID を受け渡すことでプラグインを初期化しておく必要があります。 -プラグインを初期化したら、Bluemix ダッシュボードで作成したサーバー・アプリに接続することができます。Cordova プラグインは、Cordova アプリが Bluemix サービスと通信できるようにするための Android および iOS のクライアント SDK のラッパーです。 - -1. 以下のコード・スニペットをメイン JavaScript ファイル (通常、**www/js** ディレクトリーの下にある) にコピー・アンド・ペーストして、BMSClient を初期化します。 - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Bluemix の Route パラメーターと appGUID パラメーターを使用するように、コード・スニペットを変更します。Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路とアプリ GUID を取得します。この経路とアプリ GUID の値を `BMSClient.initialize` コード・スニペットのパラメーターとして使用します。 - - **注**: Cordova CLI (例えば、Cordova の create app-name コマンド) を使用して Cordova アプリを作成した場合、この Javascript コードを **index.js** ファイルの `onDeviceReady: function()` 関数内の `app.receivedEvent` 関数の後に置いて BMS クライアントを初期化します。 - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` - -# デバイスの登録 - -{: #cordova_register} - -デバイスを Push Notification Service に登録するには、登録メソッドを呼び出します。 - -デバイスを登録するには、次のコード・スニペットを Cordova アプリケーションにコピーして貼り付けます。 - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android では、settings パラメーターを使用しません。Android アプリのみをビルドする場合は、空のオブジェクトを受け渡します。例えば、次のようにします。 - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -アラート、バッジ、および音声のプロパティーをカスタマイズする場合は、次の JavaScript コード・スニペットを Cordova アプリケーションの Web パーツに追加します。 - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -次のように JSON.parse を使用して、Javascript 内の成功した応答パラメーターの内容にアクセスできます。 -**var token = JSON.parse(response).token** - - -使用可能なキーは、`token`、`userId`、および `deviceId` です。 - -以下の JavaScript コード・スニペットは、Bluemix Mobile Services クライアント SDK を初期化し、デバイスを Push Notification Service に登録し、プッシュ通知を listen する方法を示しています。このコードを Javascript ファイルに置きます。 - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -コードは **onDeviceReady: function()** 内に置きます。 - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -アプリケーション代行クラスに次の Objective-C コード・スニペットを追加します。 - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##次のステップ - -{: #cordova_register_next} - -1. プロジェクトをビルドし、以下のコマンドを使用してプロジェクトを実行します。 - - * Android - **cordova build android** および **cordova run android** - - * iOS - **cordova build ios** および **cordova run ios** - - - -# デバイスでのプッシュ通知の受け取り -{: #cordova_receive} - -デバイスでプッシュ通知を受け取るには、以下のコード・スニペットをコピーして貼り付けます。 - -##JavaScript - -以下の JavaScript コード・スニペットを Cordova アプリケーションの Web パーツに追加します。 - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Android 通知プロパティー - -次のセクションに、Android の通知プロパティーをリストします。 - -* message - プッシュ通知メッセージ -* payload - 通知ペイロードを含む JSON オブジェクト - - -##iOS 通知プロパティー - -次のセクションに、iOS の通知プロパティーをリストします。 - -* message - プッシュ通知メッセージ -* payload - 通知ペイロードを含む JSON オブジェクト。 -action-loc-key - このストリングは、現行ローカリゼーションにおいて、「View」の代わりに右ボタンのタイトルに使用されるローカライズされたストリングを取得するためのキーとして使用されます。 -* badge - アプリ・アイコンのバッジとして表示する数。このプロパティーがないと、バッジは変更されません。バッジを削除するには、このプロパティーの値を 0 に設定します。 -* sound - アプリ・バンドル内、またはアプリ・データ・コンテナーの Library/Sounds フォルダー内にある音声ファイルの名前。 - -##Objective-C - -アプリケーション代行クラスに次の Objective-C コード・スニペットを追加します。 - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` - - - -# 基本プッシュ通知の送信 -{: #push-send-notifications} - -アプリケーションを開発したら、(タグ、バッジ、追加のペイロード、音声ファイルを使用することなく) 基本プッシュ通知を送信できます。 - - -基本プッシュ通知の送信を行います。 - -1. **「対象者の選択 (Choose the Audience)」**で、**「すべてのデバイス (All Devices)」**、またはプラットフォームに従って**「iOS デバイスのみ (Only iOS devices)」**または**「Android デバイスのみ (Only Anroid devices)」**のいずれかの対象者を選択します。 - **注**: **「すべてのデバイス (All Devices)」**オプションを選択すると、プッシュ通知をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 - - ![「通知」画面](images/tag_notification.jpg) - -2. **「通知の作成 (Create your Notification)」**にメッセージを入力し、次に**「送信」**をクリックします。 -3. デバイスが通知を受信していることを確認します。 - - 次のスクリーン・ショットは、Android および iOS のデバイスのフォアグラウンドでプッシュ通知を処理しているアラート・ボックスを示しています。 - - ![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) - - ![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) - - 次のスクリーン・ショットは、Android のバックグラウンドでのプッシュ通知を示しています。 - ![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) - - - -# 次のステップ -{: #next_steps_tags} - -基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 - -以下の Push Notifications Service の機能をご使用のアプリに追加します。タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張プッシュ通知](t_advance_notifications.html)を参照してください。 +--- + +copyright: + years: 2015, 2016 + +--- + +# Cordova の Push プラグインのインストール +{: #cordova_install} + +Cordova アプリケーションをさらに開発するために、クライアントの Push プラグインをインストールして使用します。これにより、Cordova Core のプラグインもインストールされます。これは、Bluemix への接続を初期化するものです。 + + +### 始めに + +1. 最新バージョンの Android Studio SDK と Xcode をダウンロードします。 +1. エミュレーターをセットアップします。Android Studio では、Google Play API をサポートするエミュレーターを使用します。 +1. Git のコマンド・ライン・ツールをインストールします。Windows では、必ず **「Windows コマンド・プロンプトから Git を実行する (Run Git from the Window Command Prompt)」**オプションを選択してください。このツールのダウンロードとインストールの方法については、[Git](https://git-scm.com/downloads) を参照してください。 + +1. Node.js と Node Package Manager (NPM) ツールをインストールします。NPM コマンド・ライン・ツールは Node.js とバンドルされています。Node.js のダウンロードとインストールの方法については、[Node.js](https://nodejs.org/en/download/) を参照してください。 +1. コマンド・ラインから、**npm install -g cordova** コマンドを使用して、Cordova コマンド・ライン・ツールをインストールします。これは、Cordova の Push プラグインを使用するために必要です。 +Cordova のインストールと Cordova アプリのセットアップの方法については、[Cordova Apache](https://cordova.apache.org/#getstarted) を参照してください。 + + **注**: Cordova の Push プラグインの readme ファイルを確認する場合は、[https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) にアクセスしてください。 + + +## Cordova の Push プラグインのインストール +1. Cordova アプリを作成するフォルダーに移動し、次のコマンドを実行して Cordova アプリケーションを作成します。 +既存の Cordova アプリがある場合は、ステップ 3 に進みます。 + +``` +cordova create your_app_name +cd your_app_name +``` +1. オプション: (オプション) **config.xml** ファイルを編集し、 エレメント内のアプリケーション名を、デフォルトの HelloCordova という名前ではなく、自分で選択した名前に変更します。 + + **注**: 正しいバンドル ID を指定してください。正しいバンドル ID を指定しないと、Xcode に次のエラー・メッセージが表示されます。 + * 実行可能ファイルの署名に使用された資格が無効です (The executable was signed with invalid entitlements.) + * アプリケーションのコード署名資格ファイルに指定された資格が、プロビジョニング・プロファイルに指定された資格と一致しません (The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile.) + + この問題を修正するには、Xcode または Cordova アプリ **config.xml** ファイルに正しいバンドル ID を指定します。 + +1. サポートされる最低レベルの API またはデプロイメント・ターゲット (Deployment Target) の宣言を、Cordova アプリケーションの config.xml ファイルに追加します。minSdkVersion の値は、15 より高くなければなりません。targetSdkVersion の値は、常に、Google から入手可能な最新の Android SDK を反映している必要があります。 + * **Android** - ご使用のエディターで config.xml ファイルを開き、`` エレメントを最低レベルのターゲット SDK バージョンに更新します。 + + ``` + + + + + + ``` + * **iOS** - エレメントを、デプロイメント・ターゲット (Deployment Target) の宣言で更新します。 + + ``` + + + + + ``` + +1. Cordova コマンド・ライン・インターフェース (CLI) から、以下のコマンドを使用して、プラットフォーム (iOS、Android、またはその両方) を追加します。 + + ``` + cordova platform add ios@3.9.0 + cordova platform add android + ``` +1. Cordova アプリケーションのルート・ディレクトリーで、以下のコマンドを入力して Cordova の Push プラグイン **cordova plugin add ibm-mfp-push** をインストールします。 + + 追加したプラットフォームに応じて、以下のような内容が表示されます。 + + ``` + Installing "ibm-mfp-push" for android + Installing "ibm-mfp-push" for ios + ``` +1. *your-app-root-folder* から、コマンド **cordova plugin list** を使用して、Cordova の Core および Push のプラグインが正常にインストールされたことを確認します。 + + 追加したプラットフォームに応じて、以下のような内容が表示されます。 + + ``` + ibm-mfp-core 1.0.0 "MFPCore" + ibm-mfp-push 1.0.0 “MFPPush" + ``` +1. (iOS のみ) - iOS 開発環境を構成します。a. Xcode を使用して、*your-app-name***/platforms/ios** ディレクトリーにある your-app-name.xcodeproj ファイルを開きます。 + + b. ブリッジング・ヘッダーを追加します。**「ビルド設定」>「Swift コンパイラー - コード生成」>「 Objective-C ブリッジング・ヘッダー」**に移動し、パス *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** を追加します。 + + c. Frameworks パラメーターを追加します。**「ビルド設定」>「 リンク」>「実行パス検索パス (Runpath Search Paths)」**に移動し、以下のパラメーターを追加します。 + ``` + @executable_path/Frameworks + ``` + d. ブリッジング・ヘッダーの以下の Push インポート・ステートメントをアンコメントします。*your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** に移動します。 + + ``` + //#import + //#import + //#import + ``` + e. Xcode で、アプリケーションをビルドして実行します。 +1. (Android のみ)- コマンド **cordova build android** を使用して、Android プロジェクトをビルドします。 + + **注**: Android Studio でプロジェクトを開く前に、最初に Cordova CLI を使用して Cordova アプリケーションをビルドする必要があります。そうしないと、ビルド・エラーが発生します。 + + +# Cordova プラグインの初期化 +{: #cordova_initialize} + +Push Notification Service の Cordova プラグインを使用するには、事前に、アプリケーション経路とアプリケーション GUID を受け渡すことでプラグインを初期化しておく必要があります。 +プラグインを初期化したら、Bluemix ダッシュボードで作成したサーバー・アプリに接続することができます。Cordova プラグインは、Cordova アプリが Bluemix サービスと通信できるようにするための Android および iOS のクライアント SDK のラッパーです。 + +1. 以下のコード・スニペットをメイン JavaScript ファイル (通常、**www/js** ディレクトリーの下にある) にコピー・アンド・ペーストして、BMSClient を初期化します。 + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Bluemix の Route パラメーターと appGUID パラメーターを使用するように、コード・スニペットを変更します。Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路とアプリ GUID を取得します。この経路とアプリ GUID の値を `BMSClient.initialize` コード・スニペットのパラメーターとして使用します。 + + **注**: Cordova CLI (例えば、Cordova の create app-name コマンド) を使用して Cordova アプリを作成した場合、この Javascript コードを **index.js** ファイルの `onDeviceReady: function()` 関数内の `app.receivedEvent` 関数の後に置いて BMS クライアントを初期化します。 + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` + +# デバイスの登録 + +{: #cordova_register} + +デバイスを Push Notification Service に登録するには、登録メソッドを呼び出します。 + +デバイスを登録するには、次のコード・スニペットを Cordova アプリケーションにコピーして貼り付けます。 + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android では、settings パラメーターを使用しません。Android アプリのみをビルドする場合は、空のオブジェクトを受け渡します。例えば、次のようにします。 + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +アラート、バッジ、および音声のプロパティーをカスタマイズする場合は、次の JavaScript コード・スニペットを Cordova アプリケーションの Web パーツに追加します。 + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +次のように JSON.parse を使用して、Javascript 内の成功した応答パラメーターの内容にアクセスできます。 +**var token = JSON.parse(response).token** + + +使用可能なキーは、`token`、`userId`、および `deviceId` です。 + +以下の JavaScript コード・スニペットは、Bluemix Mobile Services クライアント SDK を初期化し、デバイスを Push Notification Service に登録し、プッシュ通知を listen する方法を示しています。このコードを Javascript ファイルに置きます。 + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +コードは **onDeviceReady: function()** 内に置きます。 + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +アプリケーション代行クラスに次の Objective-C コード・スニペットを追加します。 + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## 次のステップ + +{: #cordova_register_next} + +1. プロジェクトをビルドし、以下のコマンドを使用してプロジェクトを実行します。 + + * Android - **cordova build android** および **cordova run android** + + * iOS - **cordova build ios** および **cordova run ios** + + + +# デバイスでのプッシュ通知の受け取り +{: #cordova_receive} + +デバイスでプッシュ通知を受け取るには、以下のコード・スニペットをコピーして貼り付けます。 + +## JavaScript + +以下の JavaScript コード・スニペットを Cordova アプリケーションの Web パーツに追加します。 + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +## Android 通知プロパティー + +次のセクションに、Android の通知プロパティーをリストします。 + +* message - プッシュ通知メッセージ +* payload - 通知ペイロードを含む JSON オブジェクト + + +## iOS 通知プロパティー + +次のセクションに、iOS の通知プロパティーをリストします。 + +* message - プッシュ通知メッセージ +* payload - 通知ペイロードを含む JSON オブジェクト。 +action-loc-key - このストリングは、現行ローカリゼーションにおいて、「View」の代わりに右ボタンのタイトルに使用されるローカライズされたストリングを取得するためのキーとして使用されます。 +* badge - アプリ・アイコンのバッジとして表示する数。このプロパティーがないと、バッジは変更されません。バッジを削除するには、このプロパティーの値を 0 に設定します。 +* sound - アプリ・バンドル内、またはアプリ・データ・コンテナーの Library/Sounds フォルダー内にある音声ファイルの名前。 + +## Objective-C + +アプリケーション代行クラスに次の Objective-C コード・スニペットを追加します。 + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +## Swift + +アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` + + + +# 基本プッシュ通知の送信 +{: #push-send-notifications} + +アプリケーションを開発したら、(タグ、バッジ、追加のペイロード、音声ファイルを使用することなく) 基本プッシュ通知を送信できます。 + + +基本プッシュ通知の送信を行います。 + +1. **「対象者の選択 (Choose the Audience)」**で、**「すべてのデバイス (All Devices)」**、またはプラットフォームに従って**「iOS デバイスのみ (Only iOS devices)」**または**「Android デバイスのみ (Only Anroid devices)」**のいずれかの対象者を選択します。 + **注**: **「すべてのデバイス (All Devices)」**オプションを選択すると、プッシュ通知をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 + + ![「通知」画面](images/tag_notification.jpg) + +2. **「通知の作成 (Create your Notification)」**にメッセージを入力し、次に**「送信」**をクリックします。 +3. デバイスが通知を受信していることを確認します。 + + 次のスクリーン・ショットは、Android および iOS のデバイスのフォアグラウンドでプッシュ通知を処理しているアラート・ボックスを示しています。 + + ![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) + + ![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) + + 次のスクリーン・ショットは、Android のバックグラウンドでのプッシュ通知を示しています。 + ![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) + + + +# 次のステップ +{: #next_steps_tags} + +基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 + +以下の Push Notifications Service の機能をご使用のアプリに追加します。タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張プッシュ通知](t_advance_notifications.html)を参照してください。 diff --git a/services/mobilepush/nl/ja/t_cordova_receive.md b/services/mobilepush/nl/ja/t_cordova_receive.md index 547f9c2cc..c987d7c15 100644 --- a/services/mobilepush/nl/ja/t_cordova_receive.md +++ b/services/mobilepush/nl/ja/t_cordova_receive.md @@ -1,87 +1,87 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# デバイスでのプッシュ通知の受け取り -{: #cordova_receive} - -デバイスでプッシュ通知を受け取るには、以下のコード・スニペットをコピーして貼り付けます。 - - -##JavaScript - -以下の JavaScript コード・スニペットを Cordova アプリケーションの Web パーツに追加します。 - - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Android 通知プロパティー - -次のセクションに、Android の通知プロパティーをリストします。 - -* message - プッシュ通知メッセージ -* payload - 通知ペイロードを含む JSON オブジェクト - - -##iOS 通知プロパティー - -次のセクションに、iOS の通知プロパティーをリストします。 - -* message - プッシュ通知メッセージ -* payload - 通知ペイロードを含む JSON オブジェクト。 -action-loc-key - このストリングは、現行ローカリゼーションにおいて、「View」の代わりに右ボタンのタイトルに使用されるローカライズされたストリングを取得するためのキーとして使用されます。 -* badge - アプリ・アイコンのバッジとして表示する数。このプロパティーがないと、バッジは変更されません。バッジを削除するには、このプロパティーの値を 0 に設定します。 -* sound - アプリ・バンドル内、またはアプリ・データ・コンテナーの Library/Sounds フォルダー内にある音声ファイルの名前。 - - -##Objective-C - -アプリケーション代行クラスに次の Objective-C コード・スニペットを追加します。 - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` -次のステップ。[基本プッシュ通知の送信](t_send_push_notifications.html)を行います。 +--- + +copyright: + years: 2015, 2016 + +--- + +# デバイスでのプッシュ通知の受け取り +{: #cordova_receive} + +デバイスでプッシュ通知を受け取るには、以下のコード・スニペットをコピーして貼り付けます。 + + +##JavaScript + +以下の JavaScript コード・スニペットを Cordova アプリケーションの Web パーツに追加します。 + + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +##Android 通知プロパティー + +次のセクションに、Android の通知プロパティーをリストします。 + +* message - プッシュ通知メッセージ +* payload - 通知ペイロードを含む JSON オブジェクト + + +##iOS 通知プロパティー + +次のセクションに、iOS の通知プロパティーをリストします。 + +* message - プッシュ通知メッセージ +* payload - 通知ペイロードを含む JSON オブジェクト。 +action-loc-key - このストリングは、現行ローカリゼーションにおいて、「View」の代わりに右ボタンのタイトルに使用されるローカライズされたストリングを取得するためのキーとして使用されます。 +* badge - アプリ・アイコンのバッジとして表示する数。このプロパティーがないと、バッジは変更されません。バッジを削除するには、このプロパティーの値を 0 に設定します。 +* sound - アプリ・バンドル内、またはアプリ・データ・コンテナーの Library/Sounds フォルダー内にある音声ファイルの名前。 + + +##Objective-C + +アプリケーション代行クラスに次の Objective-C コード・スニペットを追加します。 + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +##Swift + +アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` +次のステップ。[基本プッシュ通知の送信](t_send_push_notifications.html)を行います。 diff --git a/services/mobilepush/nl/ja/t_cordova_register.md b/services/mobilepush/nl/ja/t_cordova_register.md index 258e6600d..b666d5647 100644 --- a/services/mobilepush/nl/ja/t_cordova_register.md +++ b/services/mobilepush/nl/ja/t_cordova_register.md @@ -1,140 +1,140 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# デバイスの登録 - -{: #cordova_register} - -デバイスを Push Notification Service に登録するには、登録メソッドを呼び出します。 - -デバイスを登録するには、次のコード・スニペットを Cordova アプリケーションにコピーして貼り付けます。 - - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android では、settings パラメーターを使用しません。Android アプリのみをビルドする場合は、空のオブジェクトを受け渡します。例えば、次のようにします。 - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -アラート、バッジ、および音声のプロパティーをカスタマイズする場合は、次の JavaScript コード・スニペットを Cordova アプリケーションの Web パーツに追加します。 - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - }} - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -次のように JSON.parse を使用して、Javascript 内の成功した応答パラメーターの内容にアクセスできます。 -**var token = JSON.parse(response).token** - - -使用可能なキーは、`token`、`userId`、および `deviceId` です。 - -以下の JavaScript コード・スニペットは、Bluemix Mobile Services クライアント SDK を初期化し、デバイスを Push Notification Service に登録し、プッシュ通知を listen する方法を示しています。このコードを Javascript ファイルに置きます。 - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -コードは **onDeviceReady: function()** 内に置きます。 - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -アプリケーション代行クラスに次の Objective-C コード・スニペットを追加します。 - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##次のステップ -{: #cordova_register_next} - -1. プロジェクトをビルドし、以下のコマンドを使用してプロジェクトを実行します。 - - * Android - **cordova build android** および **cordova run android** - - * iOS - **cordova build ios** および **cordova run ios** -1. [デバイスでのプッシュ通知の受け取り](t_cordova_receive.html)を行います。 +--- + +copyright: + years: 2015, 2016 + +--- + +# デバイスの登録 + +{: #cordova_register} + +デバイスを Push Notification Service に登録するには、登録メソッドを呼び出します。 + +デバイスを登録するには、次のコード・スニペットを Cordova アプリケーションにコピーして貼り付けます。 + + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android では、settings パラメーターを使用しません。Android アプリのみをビルドする場合は、空のオブジェクトを受け渡します。例えば、次のようにします。 + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +アラート、バッジ、および音声のプロパティーをカスタマイズする場合は、次の JavaScript コード・スニペットを Cordova アプリケーションの Web パーツに追加します。 + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + }} + MFPPush.registerDevice(settings, success, failure); +``` + + + +##JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +次のように JSON.parse を使用して、Javascript 内の成功した応答パラメーターの内容にアクセスできます。 +**var token = JSON.parse(response).token** + + +使用可能なキーは、`token`、`userId`、および `deviceId` です。 + +以下の JavaScript コード・スニペットは、Bluemix Mobile Services クライアント SDK を初期化し、デバイスを Push Notification Service に登録し、プッシュ通知を listen する方法を示しています。このコードを Javascript ファイルに置きます。 + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +コードは **onDeviceReady: function()** 内に置きます。 + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +アプリケーション代行クラスに次の Objective-C コード・スニペットを追加します。 + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +##Swift +{: #cordova_register_swift} +アプリケーション代行クラスに次の Swift コード・スニペットを追加します。 + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +##次のステップ +{: #cordova_register_next} + +1. プロジェクトをビルドし、以下のコマンドを使用してプロジェクトを実行します。 + + * Android - **cordova build android** および **cordova run android** + + * iOS - **cordova build ios** および **cordova run ios** +1. [デバイスでのプッシュ通知の受け取り](t_cordova_receive.html)を行います。 diff --git a/services/mobilepush/nl/ja/t_create_push_instance.md b/services/mobilepush/nl/ja/t_create_push_instance.md index 3f4e60478..f367c7fda 100644 --- a/services/mobilepush/nl/ja/t_create_push_instance.md +++ b/services/mobilepush/nl/ja/t_create_push_instance.md @@ -1,34 +1,34 @@ -# プッシュ・サービス・インスタンスの作成 -{: #create-push-instance} - -{{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}} の使用を開始するには、最初に {{site.data.keyword.Bluemix}} アプリケーション (例えば、Node.js アプリ) を作成します。次に、プッシュ・サービス {{site.data.keyword.mobilepushfull}} のインスタンスを作成し、この Bluemix アプリケーションにバインドする必要があります。これはまた、Bluemix カタログの「ボイラープレート」セクションに移動して、「MobileFirst Services Starter」をクリックすることでも行えます。 - -**注**: 環境を管理するために複数の組織を構成した場合は、モバイル・アプリ用のランタイムおよびサービスを作成する組織を選択します。 - - -1. Bluemix アプリケーションがない場合は、1 つ (例えば、Node.js アプリ) を作成する必要があります。 -Bluemix アプリケーションを作成するには「Bluemix ダッシュボード (Bluemix Dashboard)」に移動し、**「アプリの作成」**をクリックします。 - - **注**: アプリケーションがある場合は、ステップ 7 に進み、サービスを追加します。![サービス・インスタンスの作成](images/create_service_instance1.jpg "サービス・インスタンスの作成") - -1. **「アプリ・テンプレートの選択」**で、**「WEB」**をクリックします。 - -3. **「開始点の選択」**エリアで、**「SDK for Node.js」**を選択して、**「続行」**をクリックします。![開始点](images/create_service_nodejs2.jpg) - -4. **「スペース」**プルダウン・メニューで、組織スペースを選択します。 -![組織スペースの選択](images/create_a_service3.jpg) -1. **「名前」**にアプリの名前を入力し、「ホスト」にホストの名前を入力します。 - -1. **「選択済みプラン」**プルダウン・メニューから、プランを選択し、**「作成」**ボタンをクリックします。アプリケーションのステージングを待ちます。 - -1. **「概要」**リンクをクリックします。![サービスの追加](images/create_service_add4.jpg) -1. **「サービスの追加」**をクリックします。「カタログ」画面が表示されます。 - -1. **「IBM Push Notifications:」**を選択し、**「スペース」**プルダウン・メニューから組織を選択します。![組織スペースのプルダウン・メニュー](images/create_service_org.jpg) -1. **「サービス名」**に、Push Notification Service の名前を入力します。 - -1. **「選択済みプラン」**で、プランを選択し、**「作成」**ボタンをクリックします。 - -1. **「はい」**をクリックして、アプリケーションを再ステージングします。![IBM Push Notification Service](images/create_service_notification5.jpg) - -1. **「Push Notifications」**をクリックして、「Push Notification」ダッシュボードを表示します。 +# プッシュ・サービス・インスタンスの作成 +{: #create-push-instance} + +{{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}} の使用を開始するには、最初に {{site.data.keyword.Bluemix}} アプリケーション (例えば、Node.js アプリ) を作成します。次に、プッシュ・サービス {{site.data.keyword.mobilepushfull}} のインスタンスを作成し、この Bluemix アプリケーションにバインドする必要があります。これはまた、Bluemix カタログの「ボイラープレート」セクションに移動して、「MobileFirst Services Starter」をクリックすることでも行えます。 + +**注**: 環境を管理するために複数の組織を構成した場合は、モバイル・アプリ用のランタイムおよびサービスを作成する組織を選択します。 + + +1. Bluemix アプリケーションがない場合は、1 つ (例えば、Node.js アプリ) を作成する必要があります。 +Bluemix アプリケーションを作成するには「Bluemix ダッシュボード (Bluemix Dashboard)」に移動し、**「アプリの作成」**をクリックします。 + + **注**: アプリケーションがある場合は、ステップ 7 に進み、サービスを追加します。![サービス・インスタンスの作成](images/create_service_instance1.jpg "サービス・インスタンスの作成") + +1. **「アプリ・テンプレートの選択」**で、**「WEB」**をクリックします。 + +3. **「開始点の選択」**エリアで、**「SDK for Node.js」**を選択して、**「続行」**をクリックします。![開始点](images/create_service_nodejs2.jpg) + +4. **「スペース」**プルダウン・メニューで、組織スペースを選択します。 +![組織スペースの選択](images/create_a_service3.jpg) +1. **「名前」**にアプリの名前を入力し、「ホスト」にホストの名前を入力します。 + +1. **「選択済みプラン」**プルダウン・メニューから、プランを選択し、**「作成」**ボタンをクリックします。アプリケーションのステージングを待ちます。 + +1. **「概要」**リンクをクリックします。![サービスの追加](images/create_service_add4.jpg) +1. **「サービスの追加」**をクリックします。「カタログ」画面が表示されます。 + +1. **「IBM Push Notifications:」**を選択し、**「スペース」**プルダウン・メニューから組織を選択します。![組織スペースのプルダウン・メニュー](images/create_service_org.jpg) +1. **「サービス名」**に、Push Notification Service の名前を入力します。 + +1. **「選択済みプラン」**で、プランを選択し、**「作成」**ボタンをクリックします。 + +1. **「はい」**をクリックして、アプリケーションを再ステージングします。![IBM Push Notification Service](images/create_service_notification5.jpg) + +1. **「Push Notifications」**をクリックして、「Push Notification」ダッシュボードを表示します。 diff --git a/services/mobilepush/nl/ja/t_enable-ios-notifications-receive.md b/services/mobilepush/nl/ja/t_enable-ios-notifications-receive.md index 25800449e..b91d30456 100644 --- a/services/mobilepush/nl/ja/t_enable-ios-notifications-receive.md +++ b/services/mobilepush/nl/ja/t_enable-ios-notifications-receive.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# iOS デバイスでのプッシュ通知の受け取り -{: #enable-push-ios-notifications-receiving} - -iOS デバイスでプッシュ通知を受け取ります。 - -##Objective-C -iOS デバイスでプッシュ通知を受け取るには、アプリケーションのアプリケーション代行に以下の Objective-C メソッドを追加します。 - -``` -// For Objective-C - -(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -iOS デバイスでプッシュ通知を受け取るには、アプリケーションのアプリケーション代行に以下の Swift メソッドを追加します。 - -``` -// For Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { -//UserInfo dictionary will contain data sent from the server - } -``` - +--- + +copyright: + years: 2015, 2016 + +--- + +# iOS デバイスでのプッシュ通知の受け取り +{: #enable-push-ios-notifications-receiving} + +iOS デバイスでプッシュ通知を受け取ります。 + +##Objective-C +iOS デバイスでプッシュ通知を受け取るには、アプリケーションのアプリケーション代行に以下の Objective-C メソッドを追加します。 + +``` +// For Objective-C + -(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +##Swift +iOS デバイスでプッシュ通知を受け取るには、アプリケーションのアプリケーション代行に以下の Swift メソッドを追加します。 + +``` +// For Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { +//UserInfo dictionary will contain data sent from the server + } +``` + diff --git a/services/mobilepush/nl/ja/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/ja/t_enable_actionable_notifications_ios.md index 9e373a17b..a9212bbdf 100644 --- a/services/mobilepush/nl/ja/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/ja/t_enable_actionable_notifications_ios.md @@ -1,103 +1,103 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# iOS のアクション可能通知の使用可能化 -{: #enable-actionable-notifications-ios} - -従来のプッシュ通知とは異なり、アクション可能通知は、通知アラートを受け取る際にアプリを開くことなく選択を行うようにユーザーにプロンプトを出します。アクション可能プッシュ通知をアプリケーションで使用可能にするには、以下の指示に従います。 - -1. ユーザー応答アクションを作成します。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. 通知カテゴリーを作成し、アクションを設定します。**UIUserNotificationActionContextDefault** または **UIUserNotificationActionContextMinimal** が有効なコンテキストです。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. 通知設定を作成し、前のステップで作成したカテゴリーを割り当てます。 - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. ローカル通知またはリモート通知を作成し、その通知にカテゴリーの ID を割り当てます。 - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# iOS のアクション可能通知の使用可能化 +{: #enable-actionable-notifications-ios} + +従来のプッシュ通知とは異なり、アクション可能通知は、通知アラートを受け取る際にアプリを開くことなく選択を行うようにユーザーにプロンプトを出します。アクション可能プッシュ通知をアプリケーションで使用可能にするには、以下の指示に従います。 + +1. ユーザー応答アクションを作成します。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. 通知カテゴリーを作成し、アクションを設定します。**UIUserNotificationActionContextDefault** または **UIUserNotificationActionContextMinimal** が有効なコンテキストです。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. 通知設定を作成し、前のステップで作成したカテゴリーを割り当てます。 + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. ローカル通知またはリモート通知を作成し、その通知にカテゴリーの ID を割り当てます。 + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/ja/t_enable_ios_notifications_initialize.md b/services/mobilepush/nl/ja/t_enable_ios_notifications_initialize.md index dff4bbb70..7335c088b 100644 --- a/services/mobilepush/nl/ja/t_enable_ios_notifications_initialize.md +++ b/services/mobilepush/nl/ja/t_enable_ios_notifications_initialize.md @@ -1,67 +1,67 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# iOS アプリ用の Push SDK の初期化 -{: #enable-push-ios-notifications-initialize} - -初期化コードを配置する一般的な場所は、iOS アプリケーションのアプリケーション代行内です。 -Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路と GUID を取得します。 - - -##Core SDK の初期化 - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - -##クライアント Push SDK の初期化 - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## 経路、GUID、および Bluemix の地域 - -**appRoute** - -Bluemix で作成したサーバー・アプリケーションに割り当てられた経路を指定します。 - -**GUID** - -Bluemix で作成したアプリケーションに割り当てられた固有キーを指定します。この値では、大/小文字が区別されます。 - -**bluemixRegionSuffix** - -アプリがホストされている場所を指定します。`bluemixRegion` パラメーターでは、使用する Bluemix デプロイメントを指定します。`BMSClient.REGION` 静的プロパティーを使用してこの値を設定し、次の 3 つの値のいずれかを使用できます。 - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY +--- + +copyright: + years: 2015, 2016 + +--- + +# iOS アプリ用の Push SDK の初期化 +{: #enable-push-ios-notifications-initialize} + +初期化コードを配置する一般的な場所は、iOS アプリケーションのアプリケーション代行内です。 +Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路と GUID を取得します。 + + +##Core SDK の初期化 + +###Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +###Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + +##クライアント Push SDK の初期化 + +###Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +###Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## 経路、GUID、および Bluemix の地域 + +**appRoute** + +Bluemix で作成したサーバー・アプリケーションに割り当てられた経路を指定します。 + +**GUID** + +Bluemix で作成したアプリケーションに割り当てられた固有キーを指定します。この値では、大/小文字が区別されます。 + +**bluemixRegionSuffix** + +アプリがホストされている場所を指定します。`bluemixRegion` パラメーターでは、使用する Bluemix デプロイメントを指定します。`BMSClient.REGION` 静的プロパティーを使用してこの値を設定し、次の 3 つの値のいずれかを使用できます。 + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY diff --git a/services/mobilepush/nl/ja/t_enable_ios_notifications_install.md b/services/mobilepush/nl/ja/t_enable_ios_notifications_install.md index e565842f8..463c57169 100644 --- a/services/mobilepush/nl/ja/t_enable_ios_notifications_install.md +++ b/services/mobilepush/nl/ja/t_enable_ios_notifications_install.md @@ -1,315 +1,315 @@ -# iOS アプリ用の Push SDK の初期化 -{: #enable-push-ios-notifications-install} - -既存の Xcode プロジェクトでは、CocoaPods 依存関係管理ツールを使用して Bluemix Mobile Services クライアント SDK をセットアップできます。あるいは、手動で SDK をインストールすることもできます。 - -**注**: Swift の Push の readme ファイルを確認するには、 https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master にアクセスしてください。 - -##CocoaPods のインストール - -1. Mac ターミナルで以下のコマンドを使用して CocoaPods をインストールします。 -``` -$ sudo gem install cocoapods -``` -2. ターミナルで以下のコマンドを入力して CocoaPods を初期化します。このコマンドを発行する際には、必ず、Xcode プロジェクトがあるディレクトリーで実行してください。`pod init` コマンドはファイルのタイトルを作成します。 -``` -$ pod init -``` -3. 生成された Podfile に、必要な SDK 依存関係を追加します。以下の Podfile をコピーします。 - - Objective-C - - ``` - source 'https://github.com/CocoaPods/Specs.git' - Copy the following list as is and remove the dependencies you do not need - pod 'IMFCore' - pod 'IMFPush' - ``` - - Swift - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - end - ``` -3. ターミナルで、プロジェクト・フォルダーに移動し、以下のコマンドを使用して依存関係をインストールします。 -``` -$ pod update -``` -このコマンドにより、依存関係がインストールされ、新しい Xcode ワークスペースが作成されます。**注**: 元の Xcode プロジェクト・ファイルではなく、次のように必ず新しい Xcode ワークスペースを開いてください。 - - ``` - $ open App.xcworkspace - ``` -このワークスペースには、元のプロジェクトと、依存関係が含まれている Pods プロジェクトが含まれています。Bluemix Mobile Services ソース・フォルダーを変更したい場合は、Pods プロジェクト内の `Pods/yourImportedSourceFolder` の下にあります (例えば、`Pods/IMFGoogleAuthentication`)。##インポートされたフレームワークおよびソース・フォルダーの使用 - -コードで SDK を参照します。 - - -### Objective-C - -関連するヘッダーの #import ディレクティブを記述します。例えば、以下のようにします。 - -``` -//Objective-C -#import -#import -``` - -**注**: CocoaPods コマンド `pod install` または `pod update` を使用して Pods プロジェクトを更新すると、Bluemix Mobile Services のソース・フォルダーがオーバーライドされる可能性があります。元ファイルのカスタマイズしたバージョンを保持する場合は、これらのコマンドのいずれかを発行する前には、それらをバックアップしてください。 - -###Swift - -**前提条件** - -- iOS 8.0 以降 -- Xcode 7 - - -関連するヘッダーの #import ディレクティブを記述します。例えば、以下のようにします。 - -``` -//swift -import BMSCore -import BMSPush -``` - - -##ビルド設定 - -**「Xcode」>「ビルド設定」>「ビルド・オプション」に移動し、「Bitcode を使用可能に設定 (Set Enable Bitcode)」**を**「いいえ」**に設定します。 - -**重要**: iOS 9 現在では、App Transport Security (ATS) 機能に対する変更が、認証プロセスの処理方法に影響する可能性があります。以下のブログ投稿に、変更に関する詳細情報が記載されています。 [ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) および [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) - - - - -# iOS アプリ用の Push SDK の初期化 -{: #enable-push-ios-notifications-initialize} - -初期化コードを配置する一般的な場所は、iOS アプリケーションのアプリケーション代行内です。 -Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路と GUID を取得します。 - -##Core SDK の初期化 - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - - -##クライアント Push SDK の初期化 - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## 経路、GUID、および Bluemix の地域 - -**appRoute** - -Bluemix で作成したサーバー・アプリケーションに割り当てられた経路を指定します。 - -**GUID** - -Bluemix で作成したアプリケーションに割り当てられた固有キーを指定します。この値では、大/小文字が区別されます。 - -**bluemixRegionSuffix** - -アプリがホストされている場所を指定します。`bluemixRegion` パラメーターでは、使用する Bluemix デプロイメントを指定します。`BMSClient.REGION` 静的プロパティーを使用してこの値を設定し、次の 3 つの値のいずれかを使用できます。 - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - - - - -# iOS アプリケーションとデバイスの登録 -{: #enable-push-ios-notifications-register} - - -アプリケーション (アプリ) でリモート通知を受け取るには、そのアプリケーション (アプリ) を APNs に登録する必要があります。これは、通常アプリをデバイスにインストールした後で行われます。 -アプリは、APNs によって生成されたデバイス・トークンを受け取った後、それを Push Notifications Service に送り返す必要があります。 - -iOS のアプリケーションおよびデバイスを登録するには、以下を行います。 - -1. バックエンド・アプリケーションの作成 -2. プッシュ通知へのトークンの受け渡し - - -##バックエンド・アプリケーションの作成 - -Bluemix® カタログの Boilerplates セクションでバックエンド・アプリケーションを作成します。これにより、プッシュ・サービスはこのアプリケーションに自動的にバインドされます。バックエンド・アプリを既に作成済みの場合は、必ずアプリを Push Notification Service にバインドしてください。 - -###Objective-C - -``` - //For Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##プッシュ通知へのトークンの受け渡し - -トークンを APNs から受け取った後で、`registerDevice:withDeviceToken` メソッドの一部として、そのトークンをプッシュ通知に渡します。 - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -トークンを APNS から受け取った後で、`didRegisterForRemoteNotificationsWithDeviceToken` メソッドの一部として、そのトークンをプッシュ通知に渡します。 - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` - - - -# iOS デバイスでのプッシュ通知の受け取り -{: #enable-push-ios-notifications-receiving} - -iOS デバイスでプッシュ通知を受け取ります。 - -##Objective-C -iOS デバイスでプッシュ通知を受け取るには、アプリケーションのアプリケーション代行に以下の Objective-C メソッドを追加します。 - -``` -// For Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -iOS デバイスでプッシュ通知を受け取るには、アプリケーションのアプリケーション代行に以下の Swift メソッドを追加します。 - -``` - // For Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the server - } - -``` - - - -# 基本プッシュ通知の送信 -{: #push-send-notifications} - -アプリケーションを開発したら、(タグ、バッジ、追加のペイロード、音声ファイルを使用することなく) 基本プッシュ通知を送信できます。 - - -基本プッシュ通知の送信を行います。 - -1. **「対象者の選択 (Choose the Audience)」**で、**「すべてのデバイス (All Devices)」**、またはプラットフォームに従って**「iOS デバイスのみ (Only iOS devices)」**または**「Android デバイスのみ (Only Anroid devices)」**のいずれかの対象者を選択します。 - - **注**: **「すべてのデバイス (All Devices)」**オプションを選択すると、プッシュ通知をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 - - ![「通知」画面](images/tag_notification.jpg) - -2. **「通知の作成 (Create your Notification)」**にメッセージを入力し、次に**「送信」**をクリックします。 -3. デバイスが通知を受信していることを確認します。 - - 次のスクリーン・ショットは、Android および iOS のデバイスのフォアグラウンドでプッシュ通知を処理しているアラート・ボックスを示しています。 - - ![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) - - ![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) - - 次のスクリーン・ショットは、Android のバックグラウンドでのプッシュ通知を示しています。 - ![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) - - - - -# 次のステップ -{: #next_steps_tags} - -基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 - -以下の Push Notifications Service の機能をご使用のアプリに追加します。タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張プッシュ通知](t_advance_notifications.html)を参照してください。 +# iOS アプリ用の Push SDK の初期化 +{: #enable-push-ios-notifications-install} + +既存の Xcode プロジェクトでは、CocoaPods 依存関係管理ツールを使用して Bluemix Mobile Services クライアント SDK をセットアップできます。あるいは、手動で SDK をインストールすることもできます。 + +**注**: Swift の Push の readme ファイルを確認するには、 https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master にアクセスしてください。 + +## CocoaPods のインストール + +1. Mac ターミナルで以下のコマンドを使用して CocoaPods をインストールします。 +``` +$ sudo gem install cocoapods +``` +2. ターミナルで以下のコマンドを入力して CocoaPods を初期化します。このコマンドを発行する際には、必ず、Xcode プロジェクトがあるディレクトリーで実行してください。`pod init` コマンドはファイルのタイトルを作成します。 +``` +$ pod init +``` +3. 生成された Podfile に、必要な SDK 依存関係を追加します。以下の Podfile をコピーします。 + + Objective-C + + ``` + source 'https://github.com/CocoaPods/Specs.git' + Copy the following list as is and remove the dependencies you do not need + pod 'IMFCore' + pod 'IMFPush' + ``` + + Swift + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + end + ``` +3. ターミナルで、プロジェクト・フォルダーに移動し、以下のコマンドを使用して依存関係をインストールします。 +``` +$ pod update +``` +このコマンドにより、依存関係がインストールされ、新しい Xcode ワークスペースが作成されます。**注**: 元の Xcode プロジェクト・ファイルではなく、次のように必ず新しい Xcode ワークスペースを開いてください。 + + ``` + $ open App.xcworkspace + ``` +このワークスペースには、元のプロジェクトと、依存関係が含まれている Pods プロジェクトが含まれています。Bluemix Mobile Services ソース・フォルダーを変更したい場合は、Pods プロジェクト内の `Pods/yourImportedSourceFolder` の下にあります (例えば、`Pods/IMFGoogleAuthentication`)。##インポートされたフレームワークおよびソース・フォルダーの使用 + +コードで SDK を参照します。 + + +### Objective-C + +関連するヘッダーの #import ディレクティブを記述します。例えば、以下のようにします。 + +``` +//Objective-C +#import +#import +``` + +**注**: CocoaPods コマンド `pod install` または `pod update` を使用して Pods プロジェクトを更新すると、Bluemix Mobile Services のソース・フォルダーがオーバーライドされる可能性があります。元ファイルのカスタマイズしたバージョンを保持する場合は、これらのコマンドのいずれかを発行する前には、それらをバックアップしてください。 + +### Swift + +**前提条件** + +- iOS 8.0 以降 +- Xcode 7 + + +関連するヘッダーの #import ディレクティブを記述します。例えば、以下のようにします。 + +``` +//swift +import BMSCore +import BMSPush +``` + + +## ビルド設定 + +**「Xcode」>「ビルド設定」>「ビルド・オプション」に移動し、「Bitcode を使用可能に設定 (Set Enable Bitcode)」**を**「いいえ」**に設定します。 + +**重要**: iOS 9 現在では、App Transport Security (ATS) 機能に対する変更が、認証プロセスの処理方法に影響する可能性があります。以下のブログ投稿に、変更に関する詳細情報が記載されています。 [ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) および [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) + + + + +# iOS アプリ用の Push SDK の初期化 +{: #enable-push-ios-notifications-initialize} + +初期化コードを配置する一般的な場所は、iOS アプリケーションのアプリケーション代行内です。 +Bluemix アプリケーション・ダッシュボード内の**「モバイル・オプション」**リンクをクリックして、アプリケーション経路と GUID を取得します。 + +## Core SDK の初期化 + +### Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +### Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + + +## クライアント Push SDK の初期化 + +### Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +### Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## 経路、GUID、および Bluemix の地域 + +**appRoute** + +Bluemix で作成したサーバー・アプリケーションに割り当てられた経路を指定します。 + +**GUID** + +Bluemix で作成したアプリケーションに割り当てられた固有キーを指定します。この値では、大/小文字が区別されます。 + +**bluemixRegionSuffix** + +アプリがホストされている場所を指定します。`bluemixRegion` パラメーターでは、使用する Bluemix デプロイメントを指定します。`BMSClient.REGION` 静的プロパティーを使用してこの値を設定し、次の 3 つの値のいずれかを使用できます。 + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + + + + +# iOS アプリケーションとデバイスの登録 +{: #enable-push-ios-notifications-register} + + +アプリケーション (アプリ) でリモート通知を受け取るには、そのアプリケーション (アプリ) を APNs に登録する必要があります。これは、通常アプリをデバイスにインストールした後で行われます。 +アプリは、APNs によって生成されたデバイス・トークンを受け取った後、それを Push Notifications Service に送り返す必要があります。 + +iOS のアプリケーションおよびデバイスを登録するには、以下を行います。 + +1. バックエンド・アプリケーションの作成 +2. プッシュ通知へのトークンの受け渡し + + +## バックエンド・アプリケーションの作成 + +Bluemix® カタログの Boilerplates セクションでバックエンド・アプリケーションを作成します。これにより、プッシュ・サービスはこのアプリケーションに自動的にバインドされます。バックエンド・アプリを既に作成済みの場合は、必ずアプリを Push Notification Service にバインドしてください。 + +### Objective-C + +``` + //For Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +### Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +## プッシュ通知へのトークンの受け渡し + +トークンを APNs から受け取った後で、`registerDevice:withDeviceToken` メソッドの一部として、そのトークンをプッシュ通知に渡します。 + +### Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +### Swift + +トークンを APNS から受け取った後で、`didRegisterForRemoteNotificationsWithDeviceToken` メソッドの一部として、そのトークンをプッシュ通知に渡します。 + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` + + + +# iOS デバイスでのプッシュ通知の受け取り +{: #enable-push-ios-notifications-receiving} + +iOS デバイスでプッシュ通知を受け取ります。 + +## Objective-C +iOS デバイスでプッシュ通知を受け取るには、アプリケーションのアプリケーション代行に以下の Objective-C メソッドを追加します。 + +``` +// For Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +## Swift +iOS デバイスでプッシュ通知を受け取るには、アプリケーションのアプリケーション代行に以下の Swift メソッドを追加します。 + +``` + // For Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the server + } + +``` + + + +# 基本プッシュ通知の送信 +{: #push-send-notifications} + +アプリケーションを開発したら、(タグ、バッジ、追加のペイロード、音声ファイルを使用することなく) 基本プッシュ通知を送信できます。 + + +基本プッシュ通知の送信を行います。 + +1. **「対象者の選択 (Choose the Audience)」**で、**「すべてのデバイス (All Devices)」**、またはプラットフォームに従って**「iOS デバイスのみ (Only iOS devices)」**または**「Android デバイスのみ (Only Anroid devices)」**のいずれかの対象者を選択します。 + + **注**: **「すべてのデバイス (All Devices)」**オプションを選択すると、プッシュ通知をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 + + ![「通知」画面](images/tag_notification.jpg) + +2. **「通知の作成 (Create your Notification)」**にメッセージを入力し、次に**「送信」**をクリックします。 +3. デバイスが通知を受信していることを確認します。 + + 次のスクリーン・ショットは、Android および iOS のデバイスのフォアグラウンドでプッシュ通知を処理しているアラート・ボックスを示しています。 + + ![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) + + ![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) + + 次のスクリーン・ショットは、Android のバックグラウンドでのプッシュ通知を示しています。 + ![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) + + + + +# 次のステップ +{: #next_steps_tags} + +基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 + +以下の Push Notifications Service の機能をご使用のアプリに追加します。タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](c_tag_basednotifications.html)を参照してください。拡張通知オプションを使用する場合は、[拡張プッシュ通知](t_advance_notifications.html)を参照してください。 diff --git a/services/mobilepush/nl/ja/t_enable_ios_notifications_register.md b/services/mobilepush/nl/ja/t_enable_ios_notifications_register.md index 68f5039e3..4be7e28d7 100644 --- a/services/mobilepush/nl/ja/t_enable_ios_notifications_register.md +++ b/services/mobilepush/nl/ja/t_enable_ios_notifications_register.md @@ -1,91 +1,91 @@ -# iOS アプリケーションとデバイスの登録 -{: #enable-push-ios-notifications-register} - - -アプリケーション (アプリ) でリモート通知を受け取るには、そのアプリケーション (アプリ) を APNs に登録する必要があります。これは、通常アプリをデバイスにインストールした後で行われます。 -アプリは、APNs によって生成されたデバイス・トークンを受け取った後、それを Push Notifications Service に送り返す必要があります。 - - -iOS のアプリケーションおよびデバイスを登録するには、以下を行います。 - -1. バックエンド・アプリケーションの作成 -2. プッシュ通知へのトークンの受け渡し - - -##バックエンド・アプリケーションの作成 - -Bluemix® カタログの Boilerplates セクションでバックエンド・アプリケーションを作成します。これにより、プッシュ・サービスはこのアプリケーションに自動的にバインドされます。バックエンド・アプリを既に作成済みの場合は、必ずアプリを Push Notification Service にバインドしてください。 - - -###Objective-C - -``` - //For Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ -[[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { -let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##プッシュ通知へのトークンの受け渡し - -トークンを APNs から受け取った後で、`registerDevice:withDeviceToken` メソッドの一部として、そのトークンをプッシュ通知に渡します。 - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; -[client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; -// get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -トークンを APNS から受け取った後で、`didRegisterForRemoteNotificationsWithDeviceToken` メソッドの一部として、そのトークンをプッシュ通知に渡します。 - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` +# iOS アプリケーションとデバイスの登録 +{: #enable-push-ios-notifications-register} + + +アプリケーション (アプリ) でリモート通知を受け取るには、そのアプリケーション (アプリ) を APNs に登録する必要があります。これは、通常アプリをデバイスにインストールした後で行われます。 +アプリは、APNs によって生成されたデバイス・トークンを受け取った後、それを Push Notifications Service に送り返す必要があります。 + + +iOS のアプリケーションおよびデバイスを登録するには、以下を行います。 + +1. バックエンド・アプリケーションの作成 +2. プッシュ通知へのトークンの受け渡し + + +##バックエンド・アプリケーションの作成 + +Bluemix® カタログの Boilerplates セクションでバックエンド・アプリケーションを作成します。これにより、プッシュ・サービスはこのアプリケーションに自動的にバインドされます。バックエンド・アプリを既に作成済みの場合は、必ずアプリを Push Notification Service にバインドしてください。 + + +###Objective-C + +``` + //For Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ +[[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +###Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { +let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +##プッシュ通知へのトークンの受け渡し + +トークンを APNs から受け取った後で、`registerDevice:withDeviceToken` メソッドの一部として、そのトークンをプッシュ通知に渡します。 + +###Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; +[client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; +// get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +###Swift + +トークンを APNS から受け取った後で、`didRegisterForRemoteNotificationsWithDeviceToken` メソッドの一部として、そのトークンをプッシュ通知に渡します。 + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` diff --git a/services/mobilepush/nl/ja/t_get_tags.md b/services/mobilepush/nl/ja/t_get_tags.md index 39e66c114..96ffcfc6f 100644 --- a/services/mobilepush/nl/ja/t_get_tags.md +++ b/services/mobilepush/nl/ja/t_get_tags.md @@ -1,153 +1,153 @@ -# タグの取得 -{: #get_tags} - -タグは、ユーザーの関心に基づいてユーザーにターゲット通知を送信する手段となります。この点は、すべてのアプリケーションに送信される一般ブロードキャストと異なります。タグを作成および管理するには、Push ダッシュボードの「タグ」タブを使用するか、または REST API を使用します。以下のセクションのコード・スニペットを使用して、モバイル・アプリケーションのタグ・サブスクリプションを管理および照会できます。これらのコード・スニペットを使用して、サブスクリプションの取得、タグへのサブスクライブ、タグからのアンサブスクライブ、使用可能なタグのリストの取得を行うことができます。 -これらのコード・スニペットは、モバイル・アプリケーションにコピー・アンド・ペーストします。 - -## Android - -**getTags** API は、デバイスをサブスクライブできる対象として使用可能なタグのリストを返します。デバイスを特定のタグにサブスクライブすると、そのタグに送られるすべてのプッシュ通知をそのデバイスは受け取ることができるようになります。 - -デバイスのサブスクライブ対象タグ・リストを取得し、使用可能なタグのリストを取得するには、Android モバイル・アプリケーションに以下のコード・スニペットをコピーします。 - - -以下の **getTags** API を使用して、デバイスをサブスクライブできる使用可能なタグのリストを取得します。 - -``` -// Get a list of available tags to which the device can subscribe - push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - -**getSubscriptions** API を使用して、デバイスがサブスクライブする対象タグのリストを取得します。 - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) -``` - -## Cordova - -デバイスがサブスクライブする対象タグのリストを取得し、デバイスをサブスクライブできる対象として使用可能なタグのリストを取得するには、モバイル・アプリケーションに以下のコード・スニペットをコピーします。 - -サブスクライブ対象として使用可能なタグの配列を取得します。 - -``` -//Get a list of available tags to which the device can subscribe -MFPPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, null); - -``` - -``` -//Get a list of available tags to which the device is subscribed. -MFPPush.getSubscriptionStatus(function(tags) { - alert(tags); -}, null); -``` - -## Objective-C - -デバイスがサブスクライブする対象タグのリストを取得し、デバイスをサブスクライブできる対象として使用可能なタグのリストを取得するには、Objective-C を使用して開発された iOS アプリケーションに以下のコード・スニペットをコピーします。 - -以下の **retrieveAvailableTags** API を使用して、デバイスをサブスクライブできる対象として使用可能なタグのリストを取得します。 - -``` -//Get a list of available tags to which the device can subscribe -[push retrieveAvailableTagsWithCompletionHandler: -^(IMFResponse *response, NSError *error){ - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved available tags."]; - NSDictionary *availableTags = [[NSDictionary alloc]init]; - availableTags = [response tags]; -[self.appDelegateVC updateMessage:availableTags.description]; -} -}]; -``` - -**retrieveSubscriptions** API を使用して、デバイスがサブスクライブする対象タグのリストを取得します。 - - -``` -// Get a list of tags that to which the device is subscribed. -[push retrieveSubscriptionsWithCompletionHandler: - ^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved subscriptions."]; - NSDictionary *subscribedTags = [[NSDictionary alloc]init]; -subscribedTags = [response subscriptions]; -[self.appDelegateVC updateMessage:subscribedTags.description]; -} -}]; -``` - -## Swift - -**retrieveAvailableTagsWithCompletionHandler** API は、デバイスをサブスクライブできる対象として使用可能なタグのリストを返します。デバイスを特定のタグにサブスクライブすると、そのタグに送られるすべてのプッシュ通知をそのデバイスは受け取ることができるようになります。 - -タグのサブスクリプションを取得するためにプッシュ・サービスを呼び出します。 - -デバイスがサブスクライブする使用可能なタグのリストを取得し、デバイスをサブスクライブできる対象として使用可能なタグのリストを取得するには、Swift モバイル・アプリケーションに以下のコード・スニペットをコピーします。 - - -``` -//Get a list of available tags to which the device can subscribe -push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - - if error.isEmpty { - - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else{ - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - - print( "Response during retrieving subscribed tags : \(response.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - - - +# タグの取得 +{: #get_tags} + +タグは、ユーザーの関心に基づいてユーザーにターゲット通知を送信する手段となります。この点は、すべてのアプリケーションに送信される一般ブロードキャストと異なります。タグを作成および管理するには、Push ダッシュボードの「タグ」タブを使用するか、または REST API を使用します。以下のセクションのコード・スニペットを使用して、モバイル・アプリケーションのタグ・サブスクリプションを管理および照会できます。これらのコード・スニペットを使用して、サブスクリプションの取得、タグへのサブスクライブ、タグからのアンサブスクライブ、使用可能なタグのリストの取得を行うことができます。 +これらのコード・スニペットは、モバイル・アプリケーションにコピー・アンド・ペーストします。 + +## Android + +**getTags** API は、デバイスをサブスクライブできる対象として使用可能なタグのリストを返します。デバイスを特定のタグにサブスクライブすると、そのタグに送られるすべてのプッシュ通知をそのデバイスは受け取ることができるようになります。 + +デバイスのサブスクライブ対象タグ・リストを取得し、使用可能なタグのリストを取得するには、Android モバイル・アプリケーションに以下のコード・スニペットをコピーします。 + + +以下の **getTags** API を使用して、デバイスをサブスクライブできる使用可能なタグのリストを取得します。 + +``` +// Get a list of available tags to which the device can subscribe + push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + +**getSubscriptions** API を使用して、デバイスがサブスクライブする対象タグのリストを取得します。 + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) +``` + +## Cordova + +デバイスがサブスクライブする対象タグのリストを取得し、デバイスをサブスクライブできる対象として使用可能なタグのリストを取得するには、モバイル・アプリケーションに以下のコード・スニペットをコピーします。 + +サブスクライブ対象として使用可能なタグの配列を取得します。 + +``` +//Get a list of available tags to which the device can subscribe +MFPPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, null); + +``` + +``` +//Get a list of available tags to which the device is subscribed. +MFPPush.getSubscriptionStatus(function(tags) { + alert(tags); +}, null); +``` + +## Objective-C + +デバイスがサブスクライブする対象タグのリストを取得し、デバイスをサブスクライブできる対象として使用可能なタグのリストを取得するには、Objective-C を使用して開発された iOS アプリケーションに以下のコード・スニペットをコピーします。 + +以下の **retrieveAvailableTags** API を使用して、デバイスをサブスクライブできる対象として使用可能なタグのリストを取得します。 + +``` +//Get a list of available tags to which the device can subscribe +[push retrieveAvailableTagsWithCompletionHandler: +^(IMFResponse *response, NSError *error){ + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved available tags."]; + NSDictionary *availableTags = [[NSDictionary alloc]init]; + availableTags = [response tags]; +[self.appDelegateVC updateMessage:availableTags.description]; +} +}]; +``` + +**retrieveSubscriptions** API を使用して、デバイスがサブスクライブする対象タグのリストを取得します。 + + +``` +// Get a list of tags that to which the device is subscribed. +[push retrieveSubscriptionsWithCompletionHandler: + ^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved subscriptions."]; + NSDictionary *subscribedTags = [[NSDictionary alloc]init]; +subscribedTags = [response subscriptions]; +[self.appDelegateVC updateMessage:subscribedTags.description]; +} +}]; +``` + +## Swift + +**retrieveAvailableTagsWithCompletionHandler** API は、デバイスをサブスクライブできる対象として使用可能なタグのリストを返します。デバイスを特定のタグにサブスクライブすると、そのタグに送られるすべてのプッシュ通知をそのデバイスは受け取ることができるようになります。 + +タグのサブスクリプションを取得するためにプッシュ・サービスを呼び出します。 + +デバイスがサブスクライブする使用可能なタグのリストを取得し、デバイスをサブスクライブできる対象として使用可能なタグのリストを取得するには、Swift モバイル・アプリケーションに以下のコード・スニペットをコピーします。 + + +``` +//Get a list of available tags to which the device can subscribe +push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + + if error.isEmpty { + + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else{ + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + + print( "Response during retrieving subscribed tags : \(response.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + + + diff --git a/services/mobilepush/nl/ja/t_handle_actionable_notifications_ios.md b/services/mobilepush/nl/ja/t_handle_actionable_notifications_ios.md index f1e611fe9..811c1339b 100644 --- a/services/mobilepush/nl/ja/t_handle_actionable_notifications_ios.md +++ b/services/mobilepush/nl/ja/t_handle_actionable_notifications_ios.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# iOS のアクション可能通知の処理 -{: #actionable-notifications} - - -アクション可能通知を受け取ると、選択した ID に基づいて制御が以下のメソッドに渡されます。 - -###Objective-C - -``` -(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: -(UILocalNotification *)notification completionHandler:(void (^)())completionHandler -{ - NSLog(@"actionable notification received."); - //must call completion handler when finished - completionHandler(); -} -``` - -###Swift - -``` -func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { - //must call completion handler when finished - completionHandler() - } -``` - - +--- + +copyright: + years: 2015, 2016 + +--- + +# iOS のアクション可能通知の処理 +{: #actionable-notifications} + + +アクション可能通知を受け取ると、選択した ID に基づいて制御が以下のメソッドに渡されます。 + +### Objective-C + +``` +(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: +(UILocalNotification *)notification completionHandler:(void (^)())completionHandler +{ + NSLog(@"actionable notification received."); + //must call completion handler when finished + completionHandler(); +} +``` + +### Swift + +``` +func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { + //must call completion handler when finished + completionHandler() + } +``` + + diff --git a/services/mobilepush/nl/ja/t_holding_notifications_android.md b/services/mobilepush/nl/ja/t_holding_notifications_android.md index 79c4a47df..2fd1f0de1 100644 --- a/services/mobilepush/nl/ja/t_holding_notifications_android.md +++ b/services/mobilepush/nl/ja/t_holding_notifications_android.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Android の通知の保留 -{: #hold-notifications-android} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - -アプリケーションがバックグラウンドになる場合、アプリケーションに送信される通知を{{site.data.keyword.mobilepushshort}}サービスが保留するようにすることが必要な場合があります。通知を保留するには、{{site.data.keyword.mobilepushshort}}を処理しているアクティビティーの onPause() メソッドで hold() メソッドを呼び出します。 - -``` - @Override - protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Android の通知の保留 +{: #hold-notifications-android} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + +アプリケーションがバックグラウンドになる場合、アプリケーションに送信される通知を{{site.data.keyword.mobilepushshort}}サービスが保留するようにすることが必要な場合があります。通知を保留するには、{{site.data.keyword.mobilepushshort}}を処理しているアクティビティーの onPause() メソッドで hold() メソッドを呼び出します。 + +``` + @Override + protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/ja/t_manage_tags.md b/services/mobilepush/nl/ja/t_manage_tags.md index 229bc4c41..ad1f441b3 100644 --- a/services/mobilepush/nl/ja/t_manage_tags.md +++ b/services/mobilepush/nl/ja/t_manage_tags.md @@ -1,347 +1,347 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# タグの管理 -{: #manage_tags} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - -{{site.data.keyword.mobilepushshort}}ダッシュボードを使用して、ご使用のアプリケーション向けのタグを作成および削除し、タグ・ベースの通知を開始します。タグ・ベースの通知は、タグにサブスクライブしているデバイスが受け取ります。 - - -## タグの作成 -{: #create_tags} - -タグ・ベースの通知は、特定のタグにサブスクライブしているすべてのデバイスをターゲットとするメッセージです。各デバイスは、任意の数のタグにサブスクライブできます。タグが削除されると、そのタグに関連付けられている情報 (サブスクライバーやデバイスを含む) が削除されます。タグが存在しなくなることから、自動アンサブスクライブは不要です。クライアント・サイドではそれ以上のアクションは不要です。 - -1. {{site.data.keyword.mobilepushshort}}ダッシュボードで、**「タグ」**タブを選択します。 -1. **「+ タグを作成 (+ Create Tag)」**ボタンをクリックします。 - 1. **「名前」**フィールドで、タグの名前を入力します。例えば、「クーポン」と入力します。 - 1. **「説明」**フィールドで、タグの説明を入力します。 - 1. **「保存」**をクリックします。 - -1. **「コード・スニペット (Code Snippets)」**エリアで、ご使用のモバイル・アプリケーションのプラットフォームを選択します。 -1. エラー処理をするコード・スニペットを変更し、各タグに対するコード・スニペットをご使用のモバイル・アプリケーションにコピーします。 - -## タグの削除 -{: #delete_tags} - -1. **「タグ」**タブで、削除するタグを選択し**「削除」**アイコンをクリックします。 -1. **「OK」**をクリックします。 - -## タグの説明の編集 -{: #edit_tags} - -1. **「タグ」**タブで、編集するタグを選択します。 -1. **「編集」**アイコンをクリックします。 -1. タグの説明を編集し、**「保存」**ボタンをクリックします。 - -# タグの取得 -{: #get_tags} - -タグは、ユーザーの関心に基づいてターゲットを絞った通知をユーザーに送信する手段となります。この点は、すべてのアプリケーションに送信される一般ブロードキャストと異なります。タグを作成および管理するには、{{site.data.keyword.mobilepushshort}}ダッシュボードの「タグ」タブを使用するか、または REST API を使用します。コード・スニペットを使用して、モバイル・アプリケーションのタグ・サブスクリプションを管理および照会できます。以下のコード・スニペットを使用して、サブスクリプションの取得、タグへのサブスクライブ、タグからのアンサブスクライブ、または使用可能なタグのリストの取得を行うことができます。以下のコード・スニペットをモバイル・アプリケーションにコピーしてください。 - -## Android 上でのタグの取得 -{: android-get-tags} - -**getTags** API は、デバイスをサブスクライブできる対象として使用可能なタグのリストを返します。デバイスを特定のタグにサブスクライブすると、そのタグに送られる{{site.data.keyword.mobilepushshort}}をそのデバイスは受け取ることができるようになります。 - -デバイスがサブスクライブしているタグのリストを取得したり、使用可能なタグのリストを取得したりするには、Android モバイル・アプリケーションに以下のコード・スニペットをコピーします。 - -以下の **getTags** API を使用して、デバイスをサブスクライブできる使用可能なタグのリストを取得します。 - -``` -// Get a list of available tags to which the device can subscribe - push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - {: codeblock} - -**getSubscriptions** API を使用して、デバイスがサブスクライブする対象タグのリストを取得します。 - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) - ``` - {: codeblock} - -## Cordova 上でのタグの取得 -{: cordova-get-tags} - -デバイスがサブスクライブしているタグのリストを取得したり、使用可能なタグのリストを取得したりするには、モバイル・アプリケーションに以下のコード・スニペットをコピーします。 - -サブスクリプションに使用可能なタグの配列を取得します。 - -``` -//Get a list of available tags to which the device can subscribe -BMSPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed. -BMSPush.retrieveSubscriptions(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - - -## Swift 上でのタグの取得 -{: swift-get-tags} - -**retrieveAvailableTagsWithCompletionHandler** API は、デバイスをサブスクライブできる対象として使用可能なタグのリストを返します。デバイスを特定のタグにサブスクライブすると、そのタグに送られる{{site.data.keyword.mobilepushshort}}をそのデバイスは受け取ることができるようになります。 - -タグのサブスクリプションを取得するために{{site.data.keyword.mobilepushshort}}を呼び出します。 - -デバイスがサブスクライブする使用可能なタグのリストを取得し、デバイスをサブスクライブできる対象として使用可能なタグのリストを取得するには、Swift モバイル・アプリケーションに以下のコード・スニペットをコピーします。 -``` -//Get a list of available tags to which the device can subscribe - push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - if error.isEmpty - { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else - { - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty - { - print( "Response during retrieving subscribed tags : \(response?.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else - { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -## Google Chrome、Safari、および Mozilla Firefox -{: web-get-tags} - -お客様がサブスクライブできる、使用可能なタグのリストを取得するには、以下のコードを使用します。 - -``` -var bmsPush = new BMSPush(); -bmsPush.retrieveAvailableTags(function(response) -{ - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) -{ - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - - -## Google Chrome アプリケーションおよびエクステンション -{: web-get-tags} - -お客様がサブスクライブできる、使用可能なタグのリストを取得するには、以下のコードを使用します。 - -``` -var bmsPush = new BMSPush(); -bmsPush.retrieveAvailableTags(function(response) -{ - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) -{ - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - -お客様がサブスクライブしているタグのリストを取得するには、以下のコード・スニペットを Google Chrome アプリケーションおよびエクステンションにコピーします。 - -``` -var bmsPush = new BMSPush(); -bmsPush.retrieveSubscriptions(function(response) -{ - alert(response.response) - }) -``` - {: codeblock} - - -# タグへのサブスクライブとアンサブスクライブ -{: #Subscribe_tags} - -以下のコード・スニペットを使用して、デバイスのサブスクリプションの取得、タグへのサブスクライブ、およびタグからのアンサブスクライブを可能にします。 - -## Android 上でのタグのサブスクライブとアンサブスクライブ -{: android-subscribe-tags} - -このコード・スニペットを Android モバイル・アプリケーションにコピー・アンド・ペーストします。 - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } - }); -``` - {: codeblock} - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } - }); -``` - {: codeblock} - -## Cordova 上でのタグのサブスクライブとアンサブスクライブ -{: cordova-subscribe-tags} - -このコード・スニペットを Cordova モバイル・アプリケーションにコピー・アンド・ペーストします。 - -``` -var tag = "YourTag"; -BMSPush.subscribe(tag, success, failure); -BMSPush.unsubscribe(tag, success, failure); -``` - {: codeblock} - - -## Swift 上でのタグのサブスクライブとアンサブスクライブ -{: swift-subscribe-tags} - -このコード・スニペットを Swift モバイル・アプリケーションにコピー・アンド・ペーストします。 - -タグにサブスクライブするには、**subscribeToTags** API を使用します。 - -``` -push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print("Response when subscribing to tags: \(response?.description)") - print("Status code when subscribing to tags: \(statusCode)") - } else { - print("Error when subscribing to tags: \(error) ") - print("Error status code when subscribing to tags: \(statusCode)") - } -}) -``` - {: codeblock} - -タグからアンサブスクライブするには、**unsubscribeFromTags** API を使用します。 - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during unsubscribed tags : \(response?.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - {: codeblock} - -## Google Chrome と Mozilla Firefox -{: web-subscribe-tags} - -Web アプリケーションからタグにサブスクライブするには、以下のコード・スニペットを使用します。 - -``` -var tagsArray = ["tag1", "Tag2"] -bmsPush.subscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -タグをアンサブスクライブするには、**unSubscribe** メソッドを使用します。 - -``` -var tagsArray = ["tag1", "Tag2"] - bmsPush.unSubscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -# タグ・ベースの通知の使用 -{: #using_tags} - -タグ・ベースの通知は、特定のタグにサブスクライブしているすべてのデバイスをターゲットとするメッセージです。各デバイスは、任意の数のタグにサブスクライブできます。このトピックでは、タグ・ベースの通知の送信方法を説明します。サブスクリプションは、{{site.data.keyword.mobilepushshort}}サービス Bluemix インスタンスによって維持されます。タグが削除されると、そのタグに関連付けられているすべての情報 (サブスクライバーやデバイスを含む) が削除されます。このタグはもはや存在せず、クライアント・サイドから必要な追加アクションはないので、このタグの自動アンサブスクライブは必要ありません。 - -**「タグ」**画面でタグを作成します。タグの作成方法については、[「タグの作成」](t_manage_tags.html)を参照してください。 - -1. **「Push Notification」**ダッシュボードで、**「通知の送信 (Send Notifications)」**をクリックします。 -1. **「送信先 (Send To)」**ドロップダウン・リストで、**「タグ指定によるデバイス (Device by Tag)」**オプションを選択します。 -1. 使用するタグを検索して、タグを選択します。 -![「通知」画面](images/tag_notification.jpg) -1. **「メッセージ・テキスト」**フィールドに、サブスクライブした対象者に通知として送信されるテキストを入力します。 -1. **「送信」**をクリックします。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# タグの管理 +{: #manage_tags} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + +{{site.data.keyword.mobilepushshort}}ダッシュボードを使用して、ご使用のアプリケーション向けのタグを作成および削除し、タグ・ベースの通知を開始します。タグ・ベースの通知は、タグにサブスクライブしているデバイスが受け取ります。 + + +## タグの作成 +{: #create_tags} + +タグ・ベースの通知は、特定のタグにサブスクライブしているすべてのデバイスをターゲットとするメッセージです。各デバイスは、任意の数のタグにサブスクライブできます。タグが削除されると、そのタグに関連付けられている情報 (サブスクライバーやデバイスを含む) が削除されます。タグが存在しなくなることから、自動アンサブスクライブは不要です。クライアント・サイドではそれ以上のアクションは不要です。 + +1. {{site.data.keyword.mobilepushshort}}ダッシュボードで、**「タグ」**タブを選択します。 +1. **「+ タグを作成 (+ Create Tag)」**ボタンをクリックします。 + 1. **「名前」**フィールドで、タグの名前を入力します。例えば、「クーポン」と入力します。 + 1. **「説明」**フィールドで、タグの説明を入力します。 + 1. **「保存」**をクリックします。 + +1. **「コード・スニペット (Code Snippets)」**エリアで、ご使用のモバイル・アプリケーションのプラットフォームを選択します。 +1. エラー処理をするコード・スニペットを変更し、各タグに対するコード・スニペットをご使用のモバイル・アプリケーションにコピーします。 + +## タグの削除 +{: #delete_tags} + +1. **「タグ」**タブで、削除するタグを選択し**「削除」**アイコンをクリックします。 +1. **「OK」**をクリックします。 + +## タグの説明の編集 +{: #edit_tags} + +1. **「タグ」**タブで、編集するタグを選択します。 +1. **「編集」**アイコンをクリックします。 +1. タグの説明を編集し、**「保存」**ボタンをクリックします。 + +# タグの取得 +{: #get_tags} + +タグは、ユーザーの関心に基づいてターゲットを絞った通知をユーザーに送信する手段となります。この点は、すべてのアプリケーションに送信される一般ブロードキャストと異なります。タグを作成および管理するには、{{site.data.keyword.mobilepushshort}}ダッシュボードの「タグ」タブを使用するか、または REST API を使用します。コード・スニペットを使用して、モバイル・アプリケーションのタグ・サブスクリプションを管理および照会できます。以下のコード・スニペットを使用して、サブスクリプションの取得、タグへのサブスクライブ、タグからのアンサブスクライブ、または使用可能なタグのリストの取得を行うことができます。以下のコード・スニペットをモバイル・アプリケーションにコピーしてください。 + +## Android 上でのタグの取得 +{: android-get-tags} + +**getTags** API は、デバイスをサブスクライブできる対象として使用可能なタグのリストを返します。デバイスを特定のタグにサブスクライブすると、そのタグに送られる{{site.data.keyword.mobilepushshort}}をそのデバイスは受け取ることができるようになります。 + +デバイスがサブスクライブしているタグのリストを取得したり、使用可能なタグのリストを取得したりするには、Android モバイル・アプリケーションに以下のコード・スニペットをコピーします。 + +以下の **getTags** API を使用して、デバイスをサブスクライブできる使用可能なタグのリストを取得します。 + +``` +// Get a list of available tags to which the device can subscribe + push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + {: codeblock} + +**getSubscriptions** API を使用して、デバイスがサブスクライブする対象タグのリストを取得します。 + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) + ``` + {: codeblock} + +## Cordova 上でのタグの取得 +{: cordova-get-tags} + +デバイスがサブスクライブしているタグのリストを取得したり、使用可能なタグのリストを取得したりするには、モバイル・アプリケーションに以下のコード・スニペットをコピーします。 + +サブスクリプションに使用可能なタグの配列を取得します。 + +``` +//Get a list of available tags to which the device can subscribe +BMSPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed. +BMSPush.retrieveSubscriptions(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + + +## Swift 上でのタグの取得 +{: swift-get-tags} + +**retrieveAvailableTagsWithCompletionHandler** API は、デバイスをサブスクライブできる対象として使用可能なタグのリストを返します。デバイスを特定のタグにサブスクライブすると、そのタグに送られる{{site.data.keyword.mobilepushshort}}をそのデバイスは受け取ることができるようになります。 + +タグのサブスクリプションを取得するために{{site.data.keyword.mobilepushshort}}を呼び出します。 + +デバイスがサブスクライブする使用可能なタグのリストを取得し、デバイスをサブスクライブできる対象として使用可能なタグのリストを取得するには、Swift モバイル・アプリケーションに以下のコード・スニペットをコピーします。 +``` +//Get a list of available tags to which the device can subscribe + push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + if error.isEmpty + { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else + { + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty + { + print( "Response during retrieving subscribed tags : \(response?.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else + { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +## Google Chrome、Safari、および Mozilla Firefox +{: web-get-tags} + +お客様がサブスクライブできる、使用可能なタグのリストを取得するには、以下のコードを使用します。 + +``` +var bmsPush = new BMSPush(); +bmsPush.retrieveAvailableTags(function(response) +{ + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) +{ + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + + +## Google Chrome アプリケーションおよびエクステンション +{: web-get-tags} + +お客様がサブスクライブできる、使用可能なタグのリストを取得するには、以下のコードを使用します。 + +``` +var bmsPush = new BMSPush(); +bmsPush.retrieveAvailableTags(function(response) +{ + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) +{ + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + +お客様がサブスクライブしているタグのリストを取得するには、以下のコード・スニペットを Google Chrome アプリケーションおよびエクステンションにコピーします。 + +``` +var bmsPush = new BMSPush(); +bmsPush.retrieveSubscriptions(function(response) +{ + alert(response.response) + }) +``` + {: codeblock} + + +# タグへのサブスクライブとアンサブスクライブ +{: #Subscribe_tags} + +以下のコード・スニペットを使用して、デバイスのサブスクリプションの取得、タグへのサブスクライブ、およびタグからのアンサブスクライブを可能にします。 + +## Android 上でのタグのサブスクライブとアンサブスクライブ +{: android-subscribe-tags} + +このコード・スニペットを Android モバイル・アプリケーションにコピー・アンド・ペーストします。 + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } + }); +``` + {: codeblock} + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } + }); +``` + {: codeblock} + +## Cordova 上でのタグのサブスクライブとアンサブスクライブ +{: cordova-subscribe-tags} + +このコード・スニペットを Cordova モバイル・アプリケーションにコピー・アンド・ペーストします。 + +``` +var tag = "YourTag"; +BMSPush.subscribe(tag, success, failure); +BMSPush.unsubscribe(tag, success, failure); +``` + {: codeblock} + + +## Swift 上でのタグのサブスクライブとアンサブスクライブ +{: swift-subscribe-tags} + +このコード・スニペットを Swift モバイル・アプリケーションにコピー・アンド・ペーストします。 + +タグにサブスクライブするには、**subscribeToTags** API を使用します。 + +``` +push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print("Response when subscribing to tags: \(response?.description)") + print("Status code when subscribing to tags: \(statusCode)") + } else { + print("Error when subscribing to tags: \(error) ") + print("Error status code when subscribing to tags: \(statusCode)") + } +}) +``` + {: codeblock} + +タグからアンサブスクライブするには、**unsubscribeFromTags** API を使用します。 + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during unsubscribed tags : \(response?.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + {: codeblock} + +## Google Chrome と Mozilla Firefox +{: web-subscribe-tags} + +Web アプリケーションからタグにサブスクライブするには、以下のコード・スニペットを使用します。 + +``` +var tagsArray = ["tag1", "Tag2"] +bmsPush.subscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +タグをアンサブスクライブするには、**unSubscribe** メソッドを使用します。 + +``` +var tagsArray = ["tag1", "Tag2"] + bmsPush.unSubscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +# タグ・ベースの通知の使用 +{: #using_tags} + +タグ・ベースの通知は、特定のタグにサブスクライブしているすべてのデバイスをターゲットとするメッセージです。各デバイスは、任意の数のタグにサブスクライブできます。このトピックでは、タグ・ベースの通知の送信方法を説明します。サブスクリプションは、{{site.data.keyword.mobilepushshort}}サービス Bluemix インスタンスによって維持されます。タグが削除されると、そのタグに関連付けられているすべての情報 (サブスクライバーやデバイスを含む) が削除されます。このタグはもはや存在せず、クライアント・サイドから必要な追加アクションはないので、このタグの自動アンサブスクライブは必要ありません。 + +**「タグ」**画面でタグを作成します。タグの作成方法については、[「タグの作成」](t_manage_tags.html)を参照してください。 + +1. **「Push Notification」**ダッシュボードで、**「通知の送信 (Send Notifications)」**をクリックします。 +1. **「送信先 (Send To)」**ドロップダウン・リストで、**「タグ指定によるデバイス (Device by Tag)」**オプションを選択します。 +1. 使用するタグを検索して、タグを選択します。 +![「通知」画面](images/tag_notification.jpg) +1. **「メッセージ・テキスト」**フィールドに、サブスクライブした対象者に通知として送信されるテキストを入力します。 +1. **「送信」**をクリックします。 diff --git a/services/mobilepush/nl/ja/t_manage_user.md b/services/mobilepush/nl/ja/t_manage_user.md index c94722991..b9f61bf89 100644 --- a/services/mobilepush/nl/ja/t_manage_user.md +++ b/services/mobilepush/nl/ja/t_manage_user.md @@ -1,166 +1,166 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# userId によるデバイスの登録 -{: #register_device_with_userId} -最終更新日: 2017 年 2 月 6 日 -{: .last-updated} - -userId ベースの通知への登録を行うには、以下の手順を実行します。 - -## Android -{: android-register} - -{{site.data.keyword.mobilepushshort}}サービスの `AppGUID` および `clientSecret` キーを使用して MFPPush クラスを初期化します。 -``` -// Initialize the Push Notifications service -push = MFPPush.getInstance(); -push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); -``` - {: codeblock} - - -- **AppGUID**: これは、{{site.data.keyword.mobilepushshort}} サービスの AppGUID キーです。 -- **clientSecret**: これは、{{site.data.keyword.mobilepushshort}} サービスの clientSecret キーです。 - - **registerDeviceWithUserId** API を使用して、デバイスを{{site.data.keyword.mobilepushshort}}に登録します。 - -``` -// Register the device to Push Notifications -push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - Log.d("Device is registered with Push Service.");} - @Override - public void onFailure(MFPPushException ex) { - Log.d("Error registering with Push Service...\n" - + "Push notifications will not be received."); - } - }); -``` - {: codeblock} - -- **userId**: {{site.data.keyword.mobilepushshort}} への登録を行うための固有の userId 値を渡します。 - -**注:** UserId によってターゲット指定される{{site.data.keyword.mobilepushshort}}を有効にするには、必ず、UserId を指定してデバイスを登録し、{{site.data.keyword.mobilepushshort}}サービスのプロビジョン時に割り振られる「clientSecret」も渡してください。有効な clientSecret がないと、デバイス登録は失敗します。 - -## Cordova -{: cordova} - -以下の API を使用して、UserId ベースの{{site.data.keyword.mobilepushshort}}への登録を行います。 - -``` -// Register device for Push Notification with UserId -var options = {"userId": "Your User Id value"}; -BMSPush.registerDevice(options,success, failure); -``` - {: codeblock} - - -- **userId**: {{site.data.keyword.mobilepushshort}} への登録を行うための固有の userId 値を渡します。 - - -## Swift -{: swift-register} - -``` -// Initialize the BMSPushClient - let push = BMSPushClient.sharedInstance - push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -- **AppGUID**: これは、{{site.data.keyword.mobilepushshort}} サービスの AppGUID キーです。 -- **clientSecret**: これは、{{site.data.keyword.mobilepushshort}} サービスの clientSecret キーです。 - -**registerWithUserId** API を使用して、デバイスを{{site.data.keyword.mobilepushshort}}に登録します。 - -``` -// Register the device to Push Notifications service -push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in -if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } else { - print( "Error during device registration \(error) ") - } - } -``` - {: codeblock} - -- **userId**: {{site.data.keyword.mobilepushshort}} への登録を行うための固有の userId 値を渡します。 - -## Google Chrome、Safari、および Mozilla Firefox -{: web-register} - -以下の API を使用して、userId ベースの通知への登録を行います。`app GUID`、`app Region`、および `Client Secret` を使用して SDK を初期化します。 - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -初期化が正常に完了したら、userId を指定して Web アプリケーションを登録します。 - -``` - bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -## Google Chrome アプリケーションおよびエクステンション -{: web-register-new} - -以下の API を使用して、userId ベースの通知への登録を行います。`app GUID`、`app Region`、および `Client Secret` を使用して SDK を初期化します。 - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -正常に初期化された後、userId を使用して Web アプリケーションを登録する必要があります。 - -``` -bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -# userId ベースの通知の使用 -{: #using_userid} - -userId ベースの通知は、特定のユーザーをターゲットとする通知メッセージです。1 つのユーザーで複数のデバイスを登録できます。以下の手順では、ユーザー ID ベースの通知の送信方法を説明します。 - -1. **「プッシュ通知」**ダッシュボードで、**「通知の送信 (Send Notifications)」**オプションを選択します。 -1. **「送信先 (Send to)」**リストのオプションで**「UserId」**を選択します。 -1. **「ユーザー ID」**フィールドで、使用するユーザー ID を検索し、**「+ 追加 (+Add)」**をクリックします。![「通知」画面](images/user_notification.jpg) -1. **「メッセージ」**フィールドに、通知で送信するテキストを入力します。 -1. **「送信」**をクリックします。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# userId によるデバイスの登録 +{: #register_device_with_userId} +最終更新日: 2017 年 2 月 6 日 +{: .last-updated} + +userId ベースの通知への登録を行うには、以下の手順を実行します。 + +## Android +{: android-register} + +{{site.data.keyword.mobilepushshort}}サービスの `AppGUID` および `clientSecret` キーを使用して MFPPush クラスを初期化します。 +``` +// Initialize the Push Notifications service +push = MFPPush.getInstance(); +push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); +``` + {: codeblock} + + +- **AppGUID**: これは、{{site.data.keyword.mobilepushshort}} サービスの AppGUID キーです。 +- **clientSecret**: これは、{{site.data.keyword.mobilepushshort}} サービスの clientSecret キーです。 + + **registerDeviceWithUserId** API を使用して、デバイスを{{site.data.keyword.mobilepushshort}}に登録します。 + +``` +// Register the device to Push Notifications +push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + Log.d("Device is registered with Push Service.");} + @Override + public void onFailure(MFPPushException ex) { + Log.d("Error registering with Push Service...\n" + + "Push notifications will not be received."); + } + }); +``` + {: codeblock} + +- **userId**: {{site.data.keyword.mobilepushshort}} への登録を行うための固有の userId 値を渡します。 + +**注:** UserId によってターゲット指定される{{site.data.keyword.mobilepushshort}}を有効にするには、必ず、UserId を指定してデバイスを登録し、{{site.data.keyword.mobilepushshort}}サービスのプロビジョン時に割り振られる「clientSecret」も渡してください。有効な clientSecret がないと、デバイス登録は失敗します。 + +## Cordova +{: cordova} + +以下の API を使用して、UserId ベースの{{site.data.keyword.mobilepushshort}}への登録を行います。 + +``` +// Register device for Push Notification with UserId +var options = {"userId": "Your User Id value"}; +BMSPush.registerDevice(options,success, failure); +``` + {: codeblock} + + +- **userId**: {{site.data.keyword.mobilepushshort}} への登録を行うための固有の userId 値を渡します。 + + +## Swift +{: swift-register} + +``` +// Initialize the BMSPushClient + let push = BMSPushClient.sharedInstance + push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +- **AppGUID**: これは、{{site.data.keyword.mobilepushshort}} サービスの AppGUID キーです。 +- **clientSecret**: これは、{{site.data.keyword.mobilepushshort}} サービスの clientSecret キーです。 + +**registerWithUserId** API を使用して、デバイスを{{site.data.keyword.mobilepushshort}}に登録します。 + +``` +// Register the device to Push Notifications service +push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in +if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } else { + print( "Error during device registration \(error) ") + } + } +``` + {: codeblock} + +- **userId**: {{site.data.keyword.mobilepushshort}} への登録を行うための固有の userId 値を渡します。 + +## Google Chrome、Safari、および Mozilla Firefox +{: web-register} + +以下の API を使用して、userId ベースの通知への登録を行います。`app GUID`、`app Region`、および `Client Secret` を使用して SDK を初期化します。 + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +初期化が正常に完了したら、userId を指定して Web アプリケーションを登録します。 + +``` + bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +## Google Chrome アプリケーションおよびエクステンション +{: web-register-new} + +以下の API を使用して、userId ベースの通知への登録を行います。`app GUID`、`app Region`、および `Client Secret` を使用して SDK を初期化します。 + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +正常に初期化された後、userId を使用して Web アプリケーションを登録する必要があります。 + +``` +bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +# userId ベースの通知の使用 +{: #using_userid} + +userId ベースの通知は、特定のユーザーをターゲットとする通知メッセージです。1 つのユーザーで複数のデバイスを登録できます。以下の手順では、ユーザー ID ベースの通知の送信方法を説明します。 + +1. **「プッシュ通知」**ダッシュボードで、**「通知の送信 (Send Notifications)」**オプションを選択します。 +1. **「送信先 (Send to)」**リストのオプションで**「UserId」**を選択します。 +1. **「ユーザー ID」**フィールドで、使用するユーザー ID を検索し、**「+ 追加 (+Add)」**をクリックします。![「通知」画面](images/user_notification.jpg) +1. **「メッセージ」**フィールドに、通知で送信するテキストを入力します。 +1. **「送信」**をクリックします。 diff --git a/services/mobilepush/nl/ja/t_push_ios_nextsteps.md b/services/mobilepush/nl/ja/t_push_ios_nextsteps.md index 7b0ff19c9..73a1dd7ca 100644 --- a/services/mobilepush/nl/ja/t_push_ios_nextsteps.md +++ b/services/mobilepush/nl/ja/t_push_ios_nextsteps.md @@ -1,22 +1,22 @@ - ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# 次のステップ - -{: #push-ios-nextsteps} - -基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 - -以下の Push Notifications Service の機能をご使用のアプリに追加します。 - - - -- タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](t_push_tagsmain.md)を参照してください。 - -- 拡張通知オプションを使用する場合は、[拡張プッシュ通知](t_advance_notifications.md)を参照してください。 + +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# 次のステップ + +{: #push-ios-nextsteps} + +基本通知を正常にセットアップしたら、タグ・ベースの通知および詳細オプションの構成を行うことができます。 + +以下の Push Notifications Service の機能をご使用のアプリに追加します。 + + + +- タグ・ベースの通知を使用する場合は、[タグ・ベースの通知](t_push_tagsmain.md)を参照してください。 + +- 拡張通知オプションを使用する場合は、[拡張プッシュ通知](t_advance_notifications.md)を参照してください。 diff --git a/services/mobilepush/nl/ja/t_push_monitoring.md b/services/mobilepush/nl/ja/t_push_monitoring.md index ddaec480a..69b03b1f2 100644 --- a/services/mobilepush/nl/ja/t_push_monitoring.md +++ b/services/mobilepush/nl/ja/t_push_monitoring.md @@ -1,33 +1,33 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# プッシュ通知のモニター -{: #monitor-notifications} -最終更新日: 2017 年 1 月 16 日 -{: .last-updated} - - -IBM {{site.data.keyword.mobilepushshort}} サービスの機能が拡張され、ユーザー・データからグラフを生成することにより、プッシュのパフォーマンスをモニターできるようになりました。ユーティリティーを使用して、すべての送信プッシュ通知をリストするか、すべての登録デバイスをリストして、日次、週次、または月次ベースで情報を分析できます。 - -すべての送信通知のレポートを生成するには、[REST API](https://mobile.{DomainName}/imfpush/){: new_window} で Push Messages GET レポート・メソッドを使用します。 - -![送信通知レポート](images/monitoring_messages.jpg) - - -すべての登録デバイスのレポートを生成するには、[REST API](https://mobile.{DomainName}/imfpush/){: new_window} で Push Device Registrations GET レポート・メソッドを使用します。 - -![登録デバイス・レポート](images/monitoring_devices.jpg) - -Android SDK を更新して通知情報をモニターする方法については、[Android デバイスでのプッシュ通知のモニター](c_android_enable.html#android_monitor)を参照してください。 - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# プッシュ通知のモニター +{: #monitor-notifications} +最終更新日: 2017 年 1 月 16 日 +{: .last-updated} + + +IBM {{site.data.keyword.mobilepushshort}} サービスの機能が拡張され、ユーザー・データからグラフを生成することにより、プッシュのパフォーマンスをモニターできるようになりました。ユーティリティーを使用して、すべての送信プッシュ通知をリストするか、すべての登録デバイスをリストして、日次、週次、または月次ベースで情報を分析できます。 + +すべての送信通知のレポートを生成するには、[REST API](https://mobile.{DomainName}/imfpush/){: new_window} で Push Messages GET レポート・メソッドを使用します。 + +![送信通知レポート](images/monitoring_messages.jpg) + + +すべての登録デバイスのレポートを生成するには、[REST API](https://mobile.{DomainName}/imfpush/){: new_window} で Push Device Registrations GET レポート・メソッドを使用します。 + +![登録デバイス・レポート](images/monitoring_devices.jpg) + +Android SDK を更新して通知情報をモニターする方法については、[Android デバイスでのプッシュ通知のモニター](c_android_enable.html#android_monitor)を参照してください。 + + + diff --git a/services/mobilepush/nl/ja/t_push_provider_android.md b/services/mobilepush/nl/ja/t_push_provider_android.md index 54bb7a89b..fc97f4dab 100644 --- a/services/mobilepush/nl/ja/t_push_provider_android.md +++ b/services/mobilepush/nl/ja/t_push_provider_android.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# FCM の資格情報の構成 -{: #create-push-enable-gcm} -最終更新日: 2017 年 1 月 16 日 -{: .last-updated} - -Firebase Cloud Messaging (FCM) は、プッシュ通知を Android デバイスおよび Google Chrome に送信するために使用されるゲートウェイです。FCM は、Google Cloud Messaging (GCM) の新規バージョンです。ダッシュボード上に {{site.data.keyword.mobilepushshort}} サービスをセットアップするには、FCM の資格情報が必要です。新規アプリケーションには必ず FCM 構成を使用してください。既存のアプリケーションは、引き続き GCM 構成で機能します。 - -##送信側 ID と API キーの取得 -{: #android-senderid-apikey} - -API キーは、{{site.data.keyword.mobilepushshort}} サービスによって安全に保管され、FCM サーバーに接続するために使用されます。送信側 ID (プロジェクト番号) は、クライアント側の Android SDK (Google Chrome の場合) および JS SDK (Mozilla Firefox の場合) によって使用されます。 - -FCM をセットアップして、API キーおよび送信側 ID を生成するには、以下の手順を実行します。 - -1. [Firebase コンソール![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.firebase.google.com/?pli=1){: new_window}にアクセスします。 -2. **「新規プロジェクトを作成」**を選択します。 -3. 「プロジェクトの作成」ウィンドウで、プロジェクト名を指定し、国/地域を選択して、**「プロジェクトを作成」**をクリックします。 -3. ナビゲーション・ペインで、「Settings」アイコンをクリックして、**「プロジェクトの設定」**を選択します。 -4. 「クラウド メッセージング」タブを選択して、「サーバー API キー」および「送信側 ID」を生成します。 - -##Android および Chrome アプリケーションおよびエクステンションの {{site.data.keyword.mobilepushshort}} サービスのセットアップ -{: #setup-push-android} - -**注:** FCM/GCM API キーと送信側 ID (プロジェクト番号) が必要になります。 - -1. Bluemix ダッシュボードを開き、次に、作成した「{{site.data.keyword.mobilepushfull}}」サービス・インスタンスをクリックしてダッシュボードを開きます。「Push」ダッシュボードが表示されます。Android 用のアンバインド・{{site.data.keyword.mobilepushshort}}サービスをセットアップするには、アンバインド・{{site.data.keyword.mobilepushshort}}サービスのアイコンを選択して、{{site.data.keyword.mobilepushshort}}サービスのダッシュボードを開きます。 - -![Push ダッシュボード](images/push_unbound.jpg) - -2. **「プッシュのセットアップ (Setup Push)」**ボタンをクリックし、Android アプリケーションと Google Chrome アプリケーションおよびエクステンションの FCM/GCM 資格情報を構成します。 -3. Android の場合、**「構成 (Configuration)」**ページで、**「モバイル」**タブに移動し、送信側 ID (GCM プロジェクト番号) と API キーを構成します。Google Chrome アプリケーションおよびエクステンションの場合、**「Web」**タブに移動して、送信側 ID (FCM/GCM プロジェクト番号) と API キーを適切に構成します。 -4. **「保存」**をクリックします。 -5. 次のステップ。[Android 用の通知の使用可能化](c_enable_push.html)または[Google Chrome アプリケーション & エクステンション用の通知の使用可能化](c_enable_push.html)。 - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# FCM の資格情報の構成 +{: #create-push-enable-gcm} +最終更新日: 2017 年 1 月 16 日 +{: .last-updated} + +Firebase Cloud Messaging (FCM) は、プッシュ通知を Android デバイスおよび Google Chrome に送信するために使用されるゲートウェイです。FCM は、Google Cloud Messaging (GCM) の新規バージョンです。ダッシュボード上に {{site.data.keyword.mobilepushshort}} サービスをセットアップするには、FCM の資格情報が必要です。新規アプリケーションには必ず FCM 構成を使用してください。既存のアプリケーションは、引き続き GCM 構成で機能します。 + +##送信側 ID と API キーの取得 +{: #android-senderid-apikey} + +API キーは、{{site.data.keyword.mobilepushshort}} サービスによって安全に保管され、FCM サーバーに接続するために使用されます。送信側 ID (プロジェクト番号) は、クライアント側の Android SDK (Google Chrome の場合) および JS SDK (Mozilla Firefox の場合) によって使用されます。 + +FCM をセットアップして、API キーおよび送信側 ID を生成するには、以下の手順を実行します。 + +1. [Firebase コンソール![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://console.firebase.google.com/?pli=1){: new_window}にアクセスします。 +2. **「新規プロジェクトを作成」**を選択します。 +3. 「プロジェクトの作成」ウィンドウで、プロジェクト名を指定し、国/地域を選択して、**「プロジェクトを作成」**をクリックします。 +3. ナビゲーション・ペインで、「Settings」アイコンをクリックして、**「プロジェクトの設定」**を選択します。 +4. 「クラウド メッセージング」タブを選択して、「サーバー API キー」および「送信側 ID」を生成します。 + +##Android および Chrome アプリケーションおよびエクステンションの {{site.data.keyword.mobilepushshort}} サービスのセットアップ +{: #setup-push-android} + +**注:** FCM/GCM API キーと送信側 ID (プロジェクト番号) が必要になります。 + +1. Bluemix ダッシュボードを開き、次に、作成した「{{site.data.keyword.mobilepushfull}}」サービス・インスタンスをクリックしてダッシュボードを開きます。「Push」ダッシュボードが表示されます。Android 用のアンバインド・{{site.data.keyword.mobilepushshort}}サービスをセットアップするには、アンバインド・{{site.data.keyword.mobilepushshort}}サービスのアイコンを選択して、{{site.data.keyword.mobilepushshort}}サービスのダッシュボードを開きます。 + +![Push ダッシュボード](images/push_unbound.jpg) + +2. **「プッシュのセットアップ (Setup Push)」**ボタンをクリックし、Android アプリケーションと Google Chrome アプリケーションおよびエクステンションの FCM/GCM 資格情報を構成します。 +3. Android の場合、**「構成 (Configuration)」**ページで、**「モバイル」**タブに移動し、送信側 ID (GCM プロジェクト番号) と API キーを構成します。Google Chrome アプリケーションおよびエクステンションの場合、**「Web」**タブに移動して、送信側 ID (FCM/GCM プロジェクト番号) と API キーを適切に構成します。 +4. **「保存」**をクリックします。 +5. 次のステップ。[Android 用の通知の使用可能化](c_enable_push.html)または[Google Chrome アプリケーション & エクステンション用の通知の使用可能化](c_enable_push.html)。 + + diff --git a/services/mobilepush/nl/ja/t_push_provider_ios.md b/services/mobilepush/nl/ja/t_push_provider_ios.md index 96a6f802c..37097dd17 100644 --- a/services/mobilepush/nl/ja/t_push_provider_ios.md +++ b/services/mobilepush/nl/ja/t_push_provider_ios.md @@ -1,145 +1,145 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# APNs の資格情報の構成 -{: #create-push-credentials-apns} -最終更新日: 2017 年 1 月 16 日 -{: .last-updated} - -Apple Push Notification Service (APNs) を使用して、アプリケーション開発者は、Bluemix (プロバイダー) 上の{{site.data.keyword.mobilepushshort}}サービス・インスタンスから iOS のデバイスおよびアプリケーションにリモート通知を送信することができます。メッセージは、デバイス上のターゲット・アプリケーションに送信されます。 - -APNs の資格情報を取得して構成してください。 -APNs の証明書は、{{site.data.keyword.mobilepushshort}}サービスによって安全に管理され、プロバイダーとしての APNs サーバーへの接続に使用されます。 - - - - - - -##アプリ ID の登録 -{: #create-push-credentials-apns-register} - - -アプリ ID (バンドル ID) は、特定のアプリケーションを識別する固有の ID です。各アプリケーションにアプリ ID が必要です。{{site.data.keyword.mobilepushshort}}サービスのようなサービスが、特定のアプリ ID に対して構成されます。 - -1. [Apple Developers ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com/){: new_window} アカウントを持っていることを確認してください。 -2. [Apple Developer ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com){: new_window}ポータルにアクセスし、**「Member Center」**をクリックし、**「Certificates, Identifiers & Profiles」**を選択します。 -3. [Apple Developer Library ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window}の**「Registering App IDs」**セクションにアクセスし、指示に従って App ID を登録します。 - -アプリ ID を登録する際、以下のオプションを選択します。 - -* Push Notifications ![「App Services (アプリケーション・サービス)」](images/appID_appservices_enablepush.jpg) -* Explicit ID Suffix (明示的 ID サフィックス) ![「Explicit ID (明示的 ID)」](images/appID_bundleID.jpg) -4. 開発および配布用 APNs SSL 証明書の作成。 - -##開発および配布用 APNs SSL 証明書の作成 -{: #create-push-credentials-apns-ssl} - -APNs 証明書を取得する前に、最初に証明書署名要求 (CSR) を生成し、それを Apple の認証局 (CA) にサブミットしておく必要があります。CSR には、ユーザーの会社を識別する情報および Apple プッシュ通知に署名するために使用する公開鍵と秘密鍵が含まれます。次に、iOS 開発者ポータル (iOS Developer Portal) で SSL 証明書を生成します。証明書は、公開鍵および秘密鍵と共に「キーチェーンアクセス」に保管されます。 - - - - - - - -APNs は、以下の 2 つのモードで使用できます。 - -* サンドボックス・モード。開発およびテスト用です。 -* 実動モード。App Store (またはその他のエンタープライズ配布メカニズム) を介してアプリケーションを配布するときのモードです。 - -開発環境と配布環境では別々の証明書を取得する必要があります。証明書は、リモート通知の受信者であるアプリのアプリ ID に関連付けられます。実動の場合、2 つまで証明書を作成できます。Bluemix は、その証明書を使用して APNs との SSL 接続を確立します。 - - - - -1. [Apple Developer ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com){: new_window} Web サイトにアクセスし、**「Member Center」**をクリックし、**「Certificates, Identifiers & Profiles」**を選択します。 -2. **「Identifiers (ID)」**エリアで、**「App IDs (アプリ ID)」**をクリックします。 -3. アプリ ID のリストから、アプリ ID を選択し、次に、**「Settings (設定)」**を選択します。 -4. **「Push Notifications (プッシュ通知)」**エリアで、開発 SSL 証明書を作成し、次に実動 SSL 証明書を作成します。 - - ![プッシュ通知 SSL 証明書](images/certificate_createssl.jpg) - -5. **「証明書署名要求 (CSR) の作成について (About Creating a Certificate Signing Request (CSR))」**画面が表示されたら、Mac で**「キーチェーンアクセス」**アプリケーションを開始して、証明書署名要求 (CSR) を作成します。 -6. メニューから、**「キーチェーンアクセス」>「証明書アシスタント」>「認証局に証明書を要求…」**を選択します。 -7. **「証明書情報」**で、アプリ開発者アカウントに関連付けられている E メール・アドレスと通称を入力します。開発用 (サンドボックス) と配布用 (実動) のいずれの証明書であるかを識別するのに役立つ、分かりやすい名前にしてください。例えば、*sandbox-apns-certificate* または *production-apns-certificate* などです。 -8. **「ディスクに保存」**を選択し、`.certSigningRequest` ファイルをデスクトップにダウンロードしてから、**「続ける」**をクリックします。 -9. **「別名で保存」**メニュー・オプションで、`.certSigningRequest` ファイルに名前を指定し、**「保存」**をクリックします。 -10. **「完了」**をクリックします。これで CSR を使用できるようになりました。 -11. **「証明書署名要求 (CSR) の作成について (About Creating a Certificate Signing Request (CSR))」**ウィンドウに戻り、**「続ける」**をクリックします。 -12. **「Generate (生成)」**画面で、**「Choose File... (ファイルの選択...)」**をクリックして、デスクトップに保存した CSR ファイルを選択します。次に、**「Generate (生成)」**をクリックします。 -![証明書の生成](images/generate_certificate.jpg) -13. 証明書ができたら、**「Done (完了)」**をクリックします。 -14. **「Push Notifications (プッシュ通知)」**画面で、**「Download (ダウンロード)」**をクリックして証明書をダウンロードし、次に**「Done (完了)」**をクリックします。![証明書のダウンロード](images/certificate_download.jpg) -15. Mac で、**「キーチェーンアクセス」 > 「自分の証明書」**に進み、新規にインストールした証明書を見つけます。証明書をダブルクリックして、それを「キーチェーンアクセス」にインストールします。 -16. 「証明書」と「秘密鍵」を選択してから、**「書き出し」**を選択して、個人情報交換形式 (`.p12` 形式) に証明書を変換します。 - ![証明書とキーのエクスポート](images/keychain_export_key.jpg) -17. **「別名で保存」**フィールドで、証明書に意味のある名前を指定します。例えば、`sandbox_apns.p12_certifcate` または `production_apns.p12` などです。その後、**「保存」**をクリックします。 - ![証明書とキーのエクスポート](images/certificate_p12v2.jpg) -18. **「パスワードの入力」**フィールドで、エクスポートされる項目を保護するためのパスワードを入力し、**「OK」**をクリックします。このパスワードは、Push ダッシュボードで APNs 設定を構成するために使用できます。{: #step18} - ![証明書とキーのエクスポート](images/export_p12.jpg) -19. **「Key Access.app」**は、**「Keychain」**画面から、キーをエクスポートするように求めるプロンプトを出します。ご使用の Mac の管理パスワードを入力して、システムによるそれらの項目のエクスポートを許可し、**「常に許可」**オプションを選択します。`.p12` 証明書がデスクトップ上に生成されます。 - - -##開発プロビジョニング・プロファイルの作成 -{: #create-push-credentials-dev-profile} - -プロビジョニング・プロファイルは、アプリ ID を使用して機能し、アプリをインストールして実行できるデバイス、およびアプリからアクセスできるサービスを判別します。各アプリ ID ごとに、2 つのプロビジョニング・プロファイル、すなわち、開発用に 1 つ、配布用にもう 1 つを作成します。Xcode は、開発プロビジョニング・プロファイルを使用して、アプリケーションのビルドを許可されている開発者と、アプリケーションのテストが許可されているデバイスを判別します。 - -アプリ ID を登録済みであること、それを {{site.data.keyword.mobilepushshort}} サービス用に使用可能化していること、および開発および実動の APNs SSL 証明書を使用するように構成済みであることを確認します。 - -以下のように、開発プロビジョニング・プロファイルを作成します。 - -1. [Apple Developer ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com){: new_window}ポータルにアクセスし、**「Member Center」**をクリックし、**「Certificates, Identifiers & Profiles」**を選択します。 -2. [Mac Developer Library ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}にアクセスし、**「Creating Development Provisioning Profiles」**セクションにスクロールし、指示に従って開発プロファイルを作成します。 -**注**: 開発プロビジョン・プロファイルを構成する際に、以下のオプションを選択します。 - * **「iOS App Development (iOS アプリ開発)」** - * **「For iOS and watchOS apps (iOS アプリおよび watchOS アプリ用)」 ** - - - -##ストア配布プロビジョニング・プロファイルの作成 -{: #create-push-credentials-apns-distribute_profile} - -ストア・プロビジョニング・プロファイルを使用して、ご使用のアプリを配布用にアプリ・ストアにサブミットします。 - -1. [Apple Developer ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com){: new_window}ポータルにアクセスし、**「Member Center」**をクリックし、**「Certificates, Identifiers & Profiles」**を選択します。 -2. ダウンロードしたプロビジョニング・プロファイルをダブルクリックして、Xcode にインストールします。 - - -##{{site.data.keyword.mobilepushshort}}ダッシュボードでの APNs のセットアップ -{: #create-push-credentials-apns-dashboard} - -{{site.data.keyword.mobilepushshort}}サービスを使用して通知を送信するには、Apple Push Notification Service (APNs) で必要とされる SSL 証明書をアップロードします。REST API を使用して APNs 証明書をアップロードすることもできます。 - - - -APNs に必要な証明書は、`.p12` 証明書です。これらの証明書には、アプリケーションのビルドと公開に必要な、秘密鍵と SSL 証明書が含まれています。これらの証明書は、Apple Developer Web サイト (このサイトには有効な Apple Developer アカウントが必要です) の「メンバー・センター」から生成する必要があります。開発環境 (サンドボックス) と実動 (配布) 環境には、別々の証明書が必要です。 - -**注**: `.cer` ファイルがキー・チェーン・アクセスに配置されたら、それをコンピューターにエクスポートして、`.p12` 証明書を作成します。 - -APNs の使用について詳しくは、[iOS Developer Library: Local and Push Notification Programming Guide ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}を参照してください。 - -「Push Notification」サービス・ダッシュボードで APNs をセットアップするには、以下の手順を実行します。 - -1. 「Push Notification」サービス・ダッシュボードで**「Configure (構成)」**を選択します。 -2. **「モバイル」**オプションを選択し、**「APNs Push Credentials (APNs プッシュ資格情報)」**フォームの情報を更新します。 -3. **「Sandbox (サンドボックス)」** (開発) または**「Production (実動)」** (配布) の該当する方を選択し、前の[ステップ](#step18)を使用して作成した `p.12` 証明書をアップロードします。![「プッシュ通知の設定」ダッシュボード](images/wizard.jpg) -3. **「パスワード」**フィールドに、`.p12` 証明書ファイルに関連付けられているパスワードを入力し、次に**「保存」**をクリックします。 - -有効なパスワードを使用して証明書のアップロードに成功したら、通知の送信を開始できます。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# APNs の資格情報の構成 +{: #create-push-credentials-apns} +最終更新日: 2017 年 1 月 16 日 +{: .last-updated} + +Apple Push Notification Service (APNs) を使用して、アプリケーション開発者は、Bluemix (プロバイダー) 上の{{site.data.keyword.mobilepushshort}}サービス・インスタンスから iOS のデバイスおよびアプリケーションにリモート通知を送信することができます。メッセージは、デバイス上のターゲット・アプリケーションに送信されます。 + +APNs の資格情報を取得して構成してください。 +APNs の証明書は、{{site.data.keyword.mobilepushshort}}サービスによって安全に管理され、プロバイダーとしての APNs サーバーへの接続に使用されます。 + + + + + + +## アプリ ID の登録 +{: #create-push-credentials-apns-register} + + +アプリ ID (バンドル ID) は、特定のアプリケーションを識別する固有の ID です。各アプリケーションにアプリ ID が必要です。{{site.data.keyword.mobilepushshort}}サービスのようなサービスが、特定のアプリ ID に対して構成されます。 + +1. [Apple Developers ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com/){: new_window} アカウントを持っていることを確認してください。 +2. [Apple Developer ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com){: new_window}ポータルにアクセスし、**「Member Center」**をクリックし、**「Certificates, Identifiers & Profiles」**を選択します。 +3. [Apple Developer Library ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window}の**「Registering App IDs」**セクションにアクセスし、指示に従って App ID を登録します。 + +アプリ ID を登録する際、以下のオプションを選択します。 + +* Push Notifications ![「App Services (アプリケーション・サービス)」](images/appID_appservices_enablepush.jpg) +* Explicit ID Suffix (明示的 ID サフィックス) ![「Explicit ID (明示的 ID)」](images/appID_bundleID.jpg) +4. 開発および配布用 APNs SSL 証明書の作成。 + +## 開発および配布用 APNs SSL 証明書の作成 +{: #create-push-credentials-apns-ssl} + +APNs 証明書を取得する前に、最初に証明書署名要求 (CSR) を生成し、それを Apple の認証局 (CA) にサブミットしておく必要があります。CSR には、ユーザーの会社を識別する情報および Apple プッシュ通知に署名するために使用する公開鍵と秘密鍵が含まれます。次に、iOS 開発者ポータル (iOS Developer Portal) で SSL 証明書を生成します。証明書は、公開鍵および秘密鍵と共に「キーチェーンアクセス」に保管されます。 + + + + + + + +APNs は、以下の 2 つのモードで使用できます。 + +* サンドボックス・モード。開発およびテスト用です。 +* 実動モード。App Store (またはその他のエンタープライズ配布メカニズム) を介してアプリケーションを配布するときのモードです。 + +開発環境と配布環境では別々の証明書を取得する必要があります。証明書は、リモート通知の受信者であるアプリのアプリ ID に関連付けられます。実動の場合、2 つまで証明書を作成できます。Bluemix は、その証明書を使用して APNs との SSL 接続を確立します。 + + + + +1. [Apple Developer ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com){: new_window} Web サイトにアクセスし、**「Member Center」**をクリックし、**「Certificates, Identifiers & Profiles」**を選択します。 +2. **「Identifiers (ID)」**エリアで、**「App IDs (アプリ ID)」**をクリックします。 +3. アプリ ID のリストから、アプリ ID を選択し、次に、**「Settings (設定)」**を選択します。 +4. **「Push Notifications (プッシュ通知)」**エリアで、開発 SSL 証明書を作成し、次に実動 SSL 証明書を作成します。 + + ![プッシュ通知 SSL 証明書](images/certificate_createssl.jpg) + +5. **「証明書署名要求 (CSR) の作成について (About Creating a Certificate Signing Request (CSR))」**画面が表示されたら、Mac で**「キーチェーンアクセス」**アプリケーションを開始して、証明書署名要求 (CSR) を作成します。 +6. メニューから、**「キーチェーンアクセス」>「証明書アシスタント」>「認証局に証明書を要求…」**を選択します。 +7. **「証明書情報」**で、アプリ開発者アカウントに関連付けられている E メール・アドレスと通称を入力します。開発用 (サンドボックス) と配布用 (実動) のいずれの証明書であるかを識別するのに役立つ、分かりやすい名前にしてください。例えば、*sandbox-apns-certificate* または *production-apns-certificate* などです。 +8. **「ディスクに保存」**を選択し、`.certSigningRequest` ファイルをデスクトップにダウンロードしてから、**「続ける」**をクリックします。 +9. **「別名で保存」**メニュー・オプションで、`.certSigningRequest` ファイルに名前を指定し、**「保存」**をクリックします。 +10. **「完了」**をクリックします。これで CSR を使用できるようになりました。 +11. **「証明書署名要求 (CSR) の作成について (About Creating a Certificate Signing Request (CSR))」**ウィンドウに戻り、**「続ける」**をクリックします。 +12. **「Generate (生成)」**画面で、**「Choose File... (ファイルの選択...)」**をクリックして、デスクトップに保存した CSR ファイルを選択します。次に、**「Generate (生成)」**をクリックします。 +![証明書の生成](images/generate_certificate.jpg) +13. 証明書ができたら、**「Done (完了)」**をクリックします。 +14. **「Push Notifications (プッシュ通知)」**画面で、**「Download (ダウンロード)」**をクリックして証明書をダウンロードし、次に**「Done (完了)」**をクリックします。![証明書のダウンロード](images/certificate_download.jpg) +15. Mac で、**「キーチェーンアクセス」 > 「自分の証明書」**に進み、新規にインストールした証明書を見つけます。証明書をダブルクリックして、それを「キーチェーンアクセス」にインストールします。 +16. 「証明書」と「秘密鍵」を選択してから、**「書き出し」**を選択して、個人情報交換形式 (`.p12` 形式) に証明書を変換します。 + ![証明書とキーのエクスポート](images/keychain_export_key.jpg) +17. **「別名で保存」**フィールドで、証明書に意味のある名前を指定します。例えば、`sandbox_apns.p12_certifcate` または `production_apns.p12` などです。その後、**「保存」**をクリックします。 + ![証明書とキーのエクスポート](images/certificate_p12v2.jpg) +18. **「パスワードの入力」**フィールドで、エクスポートされる項目を保護するためのパスワードを入力し、**「OK」**をクリックします。このパスワードは、Push ダッシュボードで APNs 設定を構成するために使用できます。{: #step18} + ![証明書とキーのエクスポート](images/export_p12.jpg) +19. **「Key Access.app」**は、**「Keychain」**画面から、キーをエクスポートするように求めるプロンプトを出します。ご使用の Mac の管理パスワードを入力して、システムによるそれらの項目のエクスポートを許可し、**「常に許可」**オプションを選択します。`.p12` 証明書がデスクトップ上に生成されます。 + + +## 開発プロビジョニング・プロファイルの作成 +{: #create-push-credentials-dev-profile} + +プロビジョニング・プロファイルは、アプリ ID を使用して機能し、アプリをインストールして実行できるデバイス、およびアプリからアクセスできるサービスを判別します。各アプリ ID ごとに、2 つのプロビジョニング・プロファイル、すなわち、開発用に 1 つ、配布用にもう 1 つを作成します。Xcode は、開発プロビジョニング・プロファイルを使用して、アプリケーションのビルドを許可されている開発者と、アプリケーションのテストが許可されているデバイスを判別します。 + +アプリ ID を登録済みであること、それを {{site.data.keyword.mobilepushshort}} サービス用に使用可能化していること、および開発および実動の APNs SSL 証明書を使用するように構成済みであることを確認します。 + +以下のように、開発プロビジョニング・プロファイルを作成します。 + +1. [Apple Developer ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com){: new_window}ポータルにアクセスし、**「Member Center」**をクリックし、**「Certificates, Identifiers & Profiles」**を選択します。 +2. [Mac Developer Library ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}にアクセスし、**「Creating Development Provisioning Profiles」**セクションにスクロールし、指示に従って開発プロファイルを作成します。 +**注**: 開発プロビジョン・プロファイルを構成する際に、以下のオプションを選択します。 + * **「iOS App Development (iOS アプリ開発)」** + * **「For iOS and watchOS apps (iOS アプリおよび watchOS アプリ用)」 ** + + + +## ストア配布プロビジョニング・プロファイルの作成 +{: #create-push-credentials-apns-distribute_profile} + +ストア・プロビジョニング・プロファイルを使用して、ご使用のアプリを配布用にアプリ・ストアにサブミットします。 + +1. [Apple Developer ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com){: new_window}ポータルにアクセスし、**「Member Center」**をクリックし、**「Certificates, Identifiers & Profiles」**を選択します。 +2. ダウンロードしたプロビジョニング・プロファイルをダブルクリックして、Xcode にインストールします。 + + +## {{site.data.keyword.mobilepushshort}}ダッシュボードでの APNs のセットアップ +{: #create-push-credentials-apns-dashboard} + +{{site.data.keyword.mobilepushshort}}サービスを使用して通知を送信するには、Apple Push Notification Service (APNs) で必要とされる SSL 証明書をアップロードします。REST API を使用して APNs 証明書をアップロードすることもできます。 + + + +APNs に必要な証明書は、`.p12` 証明書です。これらの証明書には、アプリケーションのビルドと公開に必要な、秘密鍵と SSL 証明書が含まれています。これらの証明書は、Apple Developer Web サイト (このサイトには有効な Apple Developer アカウントが必要です) の「メンバー・センター」から生成する必要があります。開発環境 (サンドボックス) と実動 (配布) 環境には、別々の証明書が必要です。 + +**注**: `.cer` ファイルがキー・チェーン・アクセスに配置されたら、それをコンピューターにエクスポートして、`.p12` 証明書を作成します。 + +APNs の使用について詳しくは、[iOS Developer Library: Local and Push Notification Programming Guide ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}を参照してください。 + +「Push Notification」サービス・ダッシュボードで APNs をセットアップするには、以下の手順を実行します。 + +1. 「Push Notification」サービス・ダッシュボードで**「Configure (構成)」**を選択します。 +2. **「モバイル」**オプションを選択し、**「APNs Push Credentials (APNs プッシュ資格情報)」**フォームの情報を更新します。 +3. **「Sandbox (サンドボックス)」** (開発) または**「Production (実動)」** (配布) の該当する方を選択し、前の[ステップ](#step18)を使用して作成した `p.12` 証明書をアップロードします。![「プッシュ通知の設定」ダッシュボード](images/wizard.jpg) +3. **「パスワード」**フィールドに、`.p12` 証明書ファイルに関連付けられているパスワードを入力し、次に**「保存」**をクリックします。 + +有効なパスワードを使用して証明書のアップロードに成功したら、通知の送信を開始できます。 diff --git a/services/mobilepush/nl/ja/t_push_provider_safari.md b/services/mobilepush/nl/ja/t_push_provider_safari.md index 2629e7a1d..7e0eca16c 100644 --- a/services/mobilepush/nl/ja/t_push_provider_safari.md +++ b/services/mobilepush/nl/ja/t_push_provider_safari.md @@ -1,83 +1,83 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Web ブラウザーの資格情報の構成 -{: #configure-credential-for-browsers} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - -IBM {{site.data.keyword.mobilepushshort}} サービスの機能が拡張され、ブラウザーに通知を送信できるようになりました。 - -許可が必要な要求を識別するために、{{site.data.keyword.mobilepushshort}} サービスによって Web サイト URL または Web サイトのドメイン・ネームが要求されます。{{site.data.keyword.mobilepushshort}} サービス・インスタンスがサポートするのは、1 度に 1 つのドメイン・ネームのみです。したがって、Chrome、Firefox、および Safari に同じ値を設定するようにしてください。 - -Chrome ブラウザーと Safari ブラウザーには、Web プッシュ用の追加構成が必要です。Chrome ではメッセージを送信するために FCM エンドポイントが使用されるため、FCM API キーが必要になります。FCM API キーを取得するには、[FCM の資格情報の構成](t_push_provider_android.html)を参照してください。 - - - -##Chrome および Firefox の Web プッシュの構成 -{: #config-chrome-firefox} - -1. Push ダッシュボードで**「構成」**を選択します。 -2. 「Web」タブを選択します。 - ![WebPush 構成](images/webpush_configure.jpg) -3. プッシュ通知を受信するために登録する FCM/GCM API キーと Web サイトの URL を構成します。 -4. **「保存」**をクリックします。 -5. 次のステップ。[Google Chrome および Mozilla Firefox ブラウザー用の通知の使用可能化](c_enable_push.html)を行います。 - - -## Safari Web プッシュの構成 -{: #configure-safari} - -Safari でサポートされる {{site.data.keyword.mobilepushshort}} サービスのバージョンは 10.0 です。ブラウザーで通知を受信するように構成する前に、Apple Developer アカウントを介して証明書を生成する必要があります。 - -### 証明書の生成 -{: #certificate-generation} - -Apple 開発者アカウントを必ず取得しておいてください。Safari ブラウザーで通知を受け取るように構成するには、Web サイト Push ID を登録し、証明書を生成する必要があります。以下の手順を使用して、開始してください。 - -1. Apple Developer Member センターで、**「Certificates, ID & Profiles (証明書、ID およびプロファイル)」**をクリックします。 -2. **「Identifiers (ID)」**をクリックして、**「Website Push IDs (Web サイト Push ID)」**をクリックします。 -3. プラス・アイコンを選択して、新規エントリーの作成を選択します。![Push ダッシュボード](images/safari_1.jpg) - -4. 「Register Website Push ID (Web サイト Push ID の登録)」パネルで、適切な Web サイト Push ID の説明と識別子 ID を入力します。これは、「web」で始まる反転ドメイン名形式にすることをお勧めします。例: web.com.example.dailyweatherreports。 -5. Web サイト Push ID を登録します。これで、Web サイト Push ID を使用できるようになりました。 -6. **「編集」**を選択して、Web サイト Push ID 用に使用する証明書を作成します。 -7. 「Certificate Information (証明書情報)」の「Certificate Assistant (証明書アシスタント)」ウィンドウで、E メール ID と共通名を入力します。「Certificate Authority email address (認証局 E メール・アドレス)」はブランクのままにします。 -8. **「Save to disk (ディスクに保存)」**をクリックし、**「続行」**を選択します。 -9. 必要に応じて証明書を適切なフォルダーに保存してください。 -10. 証明書を生成するためのウィザードでプロンプトが出されたときにディスク上で作成された `.certSigningRequest` を選択します。必ず `.cer` フォーマットで作成された Web サイト・プッシュ証明書をダウンロードしてください。 -11. 「キーチェーンアクセス」ツールで証明書を開きます。右クリックして、p12 証明書としてエクスポートします。p12 証明書の生成時に指定したパスワードをメモしてください。 - - -### 通知の構成 - {: #configuration-notification} - -証明書を生成したら、通知を Safari に送信するように、サービスを構成できます。 - -以下の手順を実行します。 - -1. 「Push Notifications」サービス・ダッシュボードで、**「構成」**をクリックします。 -2. 「Web」タブを選択します。 -3. 「Safari Push」セクションで、必要な情報を指定してフォームを更新します。 - - **Website Name**: これは、「通知」センターで指定した名前です。 - - **Website Push ID**: Web サイト Push ID の反転ドメイン・ストリングを使用して更新します。例: web.com.example.www。 - - **Website URL**: プッシュ通知をサブスクライブする必要がある Web サイトの URL を指定します。例: https://www.example.com。 - - **Allowed Domains**: これは、オプション・パラメーターです。これは、ユーザーからの許可を要求する Web サイトのリストです。URL は、必ずコンマ区切りの値で指定します。これが指定されていない場合は、Web サイト URL 内の値が使用されます。 - - **URL Format String**: 通知がクリックされたときに解決される URL。例: ["https://www.example.com"]。 URL には、http または https 方式を使用してください。 - - **Safari web push certificate**: .p12 証明書をアップロードして、パスワードを指定します。 -4. **「保存」**をクリックします。 - -![Push ダッシュボード](images/push_configure_safari.jpg) - -これで、プッシュ通知を Safari ブラウザーに送信するように構成されました。 - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Web ブラウザーの資格情報の構成 +{: #configure-credential-for-browsers} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + +IBM {{site.data.keyword.mobilepushshort}} サービスの機能が拡張され、ブラウザーに通知を送信できるようになりました。 + +許可が必要な要求を識別するために、{{site.data.keyword.mobilepushshort}} サービスによって Web サイト URL または Web サイトのドメイン・ネームが要求されます。{{site.data.keyword.mobilepushshort}} サービス・インスタンスがサポートするのは、1 度に 1 つのドメイン・ネームのみです。したがって、Chrome、Firefox、および Safari に同じ値を設定するようにしてください。 + +Chrome ブラウザーと Safari ブラウザーには、Web プッシュ用の追加構成が必要です。Chrome ではメッセージを送信するために FCM エンドポイントが使用されるため、FCM API キーが必要になります。FCM API キーを取得するには、[FCM の資格情報の構成](t_push_provider_android.html)を参照してください。 + + + +##Chrome および Firefox の Web プッシュの構成 +{: #config-chrome-firefox} + +1. Push ダッシュボードで**「構成」**を選択します。 +2. 「Web」タブを選択します。 + ![WebPush 構成](images/webpush_configure.jpg) +3. プッシュ通知を受信するために登録する FCM/GCM API キーと Web サイトの URL を構成します。 +4. **「保存」**をクリックします。 +5. 次のステップ。[Google Chrome および Mozilla Firefox ブラウザー用の通知の使用可能化](c_enable_push.html)を行います。 + + +## Safari Web プッシュの構成 +{: #configure-safari} + +Safari でサポートされる {{site.data.keyword.mobilepushshort}} サービスのバージョンは 10.0 です。ブラウザーで通知を受信するように構成する前に、Apple Developer アカウントを介して証明書を生成する必要があります。 + +### 証明書の生成 +{: #certificate-generation} + +Apple 開発者アカウントを必ず取得しておいてください。Safari ブラウザーで通知を受け取るように構成するには、Web サイト Push ID を登録し、証明書を生成する必要があります。以下の手順を使用して、開始してください。 + +1. Apple Developer Member センターで、**「Certificates, ID & Profiles (証明書、ID およびプロファイル)」**をクリックします。 +2. **「Identifiers (ID)」**をクリックして、**「Website Push IDs (Web サイト Push ID)」**をクリックします。 +3. プラス・アイコンを選択して、新規エントリーの作成を選択します。![Push ダッシュボード](images/safari_1.jpg) + +4. 「Register Website Push ID (Web サイト Push ID の登録)」パネルで、適切な Web サイト Push ID の説明と識別子 ID を入力します。これは、「web」で始まる反転ドメイン名形式にすることをお勧めします。例: web.com.example.dailyweatherreports。 +5. Web サイト Push ID を登録します。これで、Web サイト Push ID を使用できるようになりました。 +6. **「編集」**を選択して、Web サイト Push ID 用に使用する証明書を作成します。 +7. 「Certificate Information (証明書情報)」の「Certificate Assistant (証明書アシスタント)」ウィンドウで、E メール ID と共通名を入力します。「Certificate Authority email address (認証局 E メール・アドレス)」はブランクのままにします。 +8. **「Save to disk (ディスクに保存)」**をクリックし、**「続行」**を選択します。 +9. 必要に応じて証明書を適切なフォルダーに保存してください。 +10. 証明書を生成するためのウィザードでプロンプトが出されたときにディスク上で作成された `.certSigningRequest` を選択します。必ず `.cer` フォーマットで作成された Web サイト・プッシュ証明書をダウンロードしてください。 +11. 「キーチェーンアクセス」ツールで証明書を開きます。右クリックして、p12 証明書としてエクスポートします。p12 証明書の生成時に指定したパスワードをメモしてください。 + + +### 通知の構成 + {: #configuration-notification} + +証明書を生成したら、通知を Safari に送信するように、サービスを構成できます。 + +以下の手順を実行します。 + +1. 「Push Notifications」サービス・ダッシュボードで、**「構成」**をクリックします。 +2. 「Web」タブを選択します。 +3. 「Safari Push」セクションで、必要な情報を指定してフォームを更新します。 + - **Website Name**: これは、「通知」センターで指定した名前です。 + - **Website Push ID**: Web サイト Push ID の反転ドメイン・ストリングを使用して更新します。例: web.com.example.www。 + - **Website URL**: プッシュ通知をサブスクライブする必要がある Web サイトの URL を指定します。例: https://www.example.com。 + - **Allowed Domains**: これは、オプション・パラメーターです。これは、ユーザーからの許可を要求する Web サイトのリストです。URL は、必ずコンマ区切りの値で指定します。これが指定されていない場合は、Web サイト URL 内の値が使用されます。 + - **URL Format String**: 通知がクリックされたときに解決される URL。例: ["https://www.example.com"]。 URL には、http または https 方式を使用してください。 + - **Safari web push certificate**: .p12 証明書をアップロードして、パスワードを指定します。 +4. **「保存」**をクリックします。 + +![Push ダッシュボード](images/push_configure_safari.jpg) + +これで、プッシュ通知を Safari ブラウザーに送信するように構成されました。 + + diff --git a/services/mobilepush/nl/ja/t_push_tagsmain.md b/services/mobilepush/nl/ja/t_push_tagsmain.md index 3109bf256..7d20caab8 100644 --- a/services/mobilepush/nl/ja/t_push_tagsmain.md +++ b/services/mobilepush/nl/ja/t_push_tagsmain.md @@ -1,21 +1,21 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# タグ・ベースの通知 -{: #push-ios-main-tags} -最終更新日: 2017 年 1 月 16 日 -{: .last-updated} - -タグ・ベースの通知メッセージは、特定のタグにサブスクライブしているすべてのデバイスをターゲットとします。タグを定義して、タグを使用したメッセージの送受信を行うことが可能です。 - - -まず、アプリケーションのタグを作成し、タグ・サブスクリプションをセットアップしてから、タグ・ベースの通知を開始する必要があります。[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を使用してタグ・ベースの通知を送信するには、メッセージ・リソースに投稿する際に「tagNames」を指定するようにしてください。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# タグ・ベースの通知 +{: #push-ios-main-tags} +最終更新日: 2017 年 1 月 16 日 +{: .last-updated} + +タグ・ベースの通知メッセージは、特定のタグにサブスクライブしているすべてのデバイスをターゲットとします。タグを定義して、タグを使用したメッセージの送受信を行うことが可能です。 + + +まず、アプリケーションのタグを作成し、タグ・サブスクリプションをセットアップしてから、タグ・ベースの通知を開始する必要があります。[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を使用してタグ・ベースの通知を送信するには、メッセージ・リソースに投稿する際に「tagNames」を指定するようにしてください。 diff --git a/services/mobilepush/nl/ja/t_restapi.md b/services/mobilepush/nl/ja/t_restapi.md index 3f9ccb886..2be7e7ce7 100644 --- a/services/mobilepush/nl/ja/t_restapi.md +++ b/services/mobilepush/nl/ja/t_restapi.md @@ -1,122 +1,122 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# REST API の使用 -{: #push-api-rest} -最終更新日: 2017 年 1 月 16 日 -{: .last-updated} - -{{site.data.keyword.mobilepushshort}}には REST (Representational State Transfer) API (アプリケーション・プログラム・インターフェース) を使用できます。また、SDK と [Push API ![アイコン・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window} を使用して、クライアント・アプリケーションをさらに開発することもできます。 - -バックエンド・サーバー・アプリケーションとクライアントは、Push REST API を使用して、{{site.data.keyword.mobilepushshort}}機能にアクセスできます。 - -- デバイス登録 -- 登録 -- メッセージ -- サブスクリプション -- タグ (Tags) -- Web フック - -REST API のベース URL を取得するには、以下の手順を実行します。 - -1. MobileFirst Services Starter を選択することで、Bluemix® カタログの Boilerplates セクションでバックエンド・アプリケーションを作成します。これにより、{{site.data.keyword.mobilepushshort}}サービスがアプリケーションにバインドされます。Push のサービス・インスタンスを作成してアンバインドのままにすることもできます。 -1. Bluemix ダッシュボードのメインページで、**「アプリケーション」**エリアに移動し、アプリを選択します。 -3. **「モバイル・オプション」**をクリックします。アプリの詳細ページの最初に、経路およびアプリ GUID の値が表示されます。「資格情報の表示」画面に、AppSecret に関する情報が表示されます。「モバイル・オプション」のアプリケーション秘密鍵や、いくつかの API のクライアント秘密鍵も取得できます。 - -また、以下のようにコマンド・ラインを使用してサービス資格情報を取得することも可能です。 - -``` - cf create-service-key {push_instance_name} {key_name} - cf service-key {push_instance_name} {key_name} -``` - {: codeblock} - -## Accept-Language ヘッダー -{: #push-api-rest-accept} - -「Accept-Language」ヘッダーは、[Push REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}によって出力されるエラー・メッセージに使用する言語を指定します。エラー・メッセージでサポートされる言語は、中国語 (簡体字)、中国語 (繁体字)、英語 (米国)、ドイツ語、フランス語、イタリア語、日本語、韓国語、ポルトガル語、およびスペイン語です。 - -## appSecret -{: #push-api-rest-secret} - -アプリケーションが {{site.data.keyword.mobilepushshort}} にバインドされると、サービスは appSecret (固有キー) を生成し、それを応答ヘッダーで渡します。IBM {{site.data.keyword.mobilepushshort}} for Bluemix Rest API を使用している場合は、REST API リファレンスを使用して、保護する必要のある API に関する情報を取得してください。詳しくは、[Push REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を参照してください。 - -要求ヘッダーには appSecret が含まれている必要があります。含まれていない場合、サーバーは 401 無許可エラー・コードを返します。{{site.data.keyword.mobilepushshort}} がアプリケーションに追加されると、特定の AppID が作成されます。応答の一部として、タグの作成やメッセージの送信に使用される appSecret というヘッダーを取得します。操作は、カタログまたはボイラープレートのサービスを介して行われます。 - -appSecret 値を取得するには、以下のようにします。 - -1. プッシュ・サービスにバインドされている *app-name* をクリックします。 -2. **「資格情報の表示」**リンクをクリックして appSecret (AppID) を表示します。 - -**「資格情報の表示」**画面に、AppSecret に関する情報が表示されます。 -``` - { - "imfpush_Dev": [ - { - "name": "testapp1", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": { - "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", - "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", - "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", - } - } - ] - } -``` - {: codeblock} - - -##Push REST API のフィルター -{: #push-api-rest-filters} - -フィルターは、{{site.data.keyword.mobilepushshort}}の GET API から返されるデータを制限する検索条件を定義します。フィルタリングする GET 操作の結果に対してフィルターを適用します。フィルターは、結果に含まれる項目の数を制限します。例えば、フィルターを使用して、名前が「test」で始まるタグを検索できます。 - -フィルターは、以下の構文で生成できます。 - -**name**: フィルターが適用されるフィールドの名前。 - -**operator**: 使用するフィルターの一致条件を記述する == (完全一致) または =@ (サブストリングを含む)。 - -**expression**: 結果に含める値。 - -コンマおよび円記号 () は、式で表示する場合、円記号 () でエスケープする必要があります。 - -複数のフィルターを使用する場合、AND ロジックと OR ロジックを使用してそれらを結合することができます。 - -- AND ロジックの場合、照会で複数のフィルターを使用します。 -- OR ロジックの場合、フィルター式内でコンマ (,) を使用します。 -- AND と OR の両方のロジックの場合、単一の照会で AND ロジックと OR ロジックの両方を含めることができます。各フィルターが個別に評価されてから、AND 式で結合されます。 - -デバイス GET API では、以下の組み合わせがサポートされます。 -- name は platform フィールドです。 -- platform 以外の場合、operator は == または =@ にすることができます。 -- platform の場合、operator は == でなければなりません。operator として =@ が使用された場合、値はサブストリングになることがあります。 -- == が使用された場合、値は完全一致ストリングでなければなりません。 - -サブスクリプション GET API では、以下の組み合わせがサポートされます。 - -- name は、tagName または deviceId のいずれかのフィールドにすることができます。 -- platform 以外の場合、operator は == または =@ にすることができます。 -- platform の場合、operator は == でなければなりません。 -- operator として =@ が使用された場合、値はサブストリングになることがあります。operator として == が使用された場合、値は完全一致ストリングでなければなりません。 -- タグ GET API では、以下の組み合わせがサポートされます。 -- name は、name または description のいずれかのフィールドにすることができます。 -- operator として =@ が使用された場合、値はサブストリングになることがあります。 -- == が使用された場合、値は完全一致ストリングでなければなりません。 - - -##{{site.data.keyword.mobilepushshort}}の応答コード -{: #push-api-response-codes} - -状況: 405 Method Not Allowed - 適切なメソッドを使用する必要があります。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# REST API の使用 +{: #push-api-rest} +最終更新日: 2017 年 1 月 16 日 +{: .last-updated} + +{{site.data.keyword.mobilepushshort}}には REST (Representational State Transfer) API (アプリケーション・プログラム・インターフェース) を使用できます。また、SDK と [Push API ![アイコン・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window} を使用して、クライアント・アプリケーションをさらに開発することもできます。 + +バックエンド・サーバー・アプリケーションとクライアントは、Push REST API を使用して、{{site.data.keyword.mobilepushshort}}機能にアクセスできます。 + +- デバイス登録 +- 登録 +- メッセージ +- サブスクリプション +- タグ (Tags) +- Web フック + +REST API のベース URL を取得するには、以下の手順を実行します。 + +1. MobileFirst Services Starter を選択することで、Bluemix® カタログの Boilerplates セクションでバックエンド・アプリケーションを作成します。これにより、{{site.data.keyword.mobilepushshort}}サービスがアプリケーションにバインドされます。Push のサービス・インスタンスを作成してアンバインドのままにすることもできます。 +1. Bluemix ダッシュボードのメインページで、**「アプリケーション」**エリアに移動し、アプリを選択します。 +3. **「モバイル・オプション」**をクリックします。アプリの詳細ページの最初に、経路およびアプリ GUID の値が表示されます。「資格情報の表示」画面に、AppSecret に関する情報が表示されます。「モバイル・オプション」のアプリケーション秘密鍵や、いくつかの API のクライアント秘密鍵も取得できます。 + +また、以下のようにコマンド・ラインを使用してサービス資格情報を取得することも可能です。 + +``` + cf create-service-key {push_instance_name} {key_name} + cf service-key {push_instance_name} {key_name} +``` + {: codeblock} + +## Accept-Language ヘッダー +{: #push-api-rest-accept} + +「Accept-Language」ヘッダーは、[Push REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}によって出力されるエラー・メッセージに使用する言語を指定します。エラー・メッセージでサポートされる言語は、中国語 (簡体字)、中国語 (繁体字)、英語 (米国)、ドイツ語、フランス語、イタリア語、日本語、韓国語、ポルトガル語、およびスペイン語です。 + +## appSecret +{: #push-api-rest-secret} + +アプリケーションが {{site.data.keyword.mobilepushshort}} にバインドされると、サービスは appSecret (固有キー) を生成し、それを応答ヘッダーで渡します。IBM {{site.data.keyword.mobilepushshort}} for Bluemix Rest API を使用している場合は、REST API リファレンスを使用して、保護する必要のある API に関する情報を取得してください。詳しくは、[Push REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を参照してください。 + +要求ヘッダーには appSecret が含まれている必要があります。含まれていない場合、サーバーは 401 無許可エラー・コードを返します。{{site.data.keyword.mobilepushshort}} がアプリケーションに追加されると、特定の AppID が作成されます。応答の一部として、タグの作成やメッセージの送信に使用される appSecret というヘッダーを取得します。操作は、カタログまたはボイラープレートのサービスを介して行われます。 + +appSecret 値を取得するには、以下のようにします。 + +1. プッシュ・サービスにバインドされている *app-name* をクリックします。 +2. **「資格情報の表示」**リンクをクリックして appSecret (AppID) を表示します。 + +**「資格情報の表示」**画面に、AppSecret に関する情報が表示されます。 +``` + { + "imfpush_Dev": [ + { + "name": "testapp1", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": { + "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", + "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", + "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", + } + } + ] + } +``` + {: codeblock} + + +##Push REST API のフィルター +{: #push-api-rest-filters} + +フィルターは、{{site.data.keyword.mobilepushshort}}の GET API から返されるデータを制限する検索条件を定義します。フィルタリングする GET 操作の結果に対してフィルターを適用します。フィルターは、結果に含まれる項目の数を制限します。例えば、フィルターを使用して、名前が「test」で始まるタグを検索できます。 + +フィルターは、以下の構文で生成できます。 + +**name**: フィルターが適用されるフィールドの名前。 + +**operator**: 使用するフィルターの一致条件を記述する == (完全一致) または =@ (サブストリングを含む)。 + +**expression**: 結果に含める値。 + +コンマおよび円記号 () は、式で表示する場合、円記号 () でエスケープする必要があります。 + +複数のフィルターを使用する場合、AND ロジックと OR ロジックを使用してそれらを結合することができます。 + +- AND ロジックの場合、照会で複数のフィルターを使用します。 +- OR ロジックの場合、フィルター式内でコンマ (,) を使用します。 +- AND と OR の両方のロジックの場合、単一の照会で AND ロジックと OR ロジックの両方を含めることができます。各フィルターが個別に評価されてから、AND 式で結合されます。 + +デバイス GET API では、以下の組み合わせがサポートされます。 +- name は platform フィールドです。 +- platform 以外の場合、operator は == または =@ にすることができます。 +- platform の場合、operator は == でなければなりません。operator として =@ が使用された場合、値はサブストリングになることがあります。 +- == が使用された場合、値は完全一致ストリングでなければなりません。 + +サブスクリプション GET API では、以下の組み合わせがサポートされます。 + +- name は、tagName または deviceId のいずれかのフィールドにすることができます。 +- platform 以外の場合、operator は == または =@ にすることができます。 +- platform の場合、operator は == でなければなりません。 +- operator として =@ が使用された場合、値はサブストリングになることがあります。operator として == が使用された場合、値は完全一致ストリングでなければなりません。 +- タグ GET API では、以下の組み合わせがサポートされます。 +- name は、name または description のいずれかのフィールドにすることができます。 +- operator として =@ が使用された場合、値はサブストリングになることがあります。 +- == が使用された場合、値は完全一致ストリングでなければなりません。 + + +##{{site.data.keyword.mobilepushshort}}の応答コード +{: #push-api-response-codes} + +状況: 405 Method Not Allowed - 適切なメソッドを使用する必要があります。 diff --git a/services/mobilepush/nl/ja/t_sandbox.md b/services/mobilepush/nl/ja/t_sandbox.md index 268e108ca..3eeb4769a 100644 --- a/services/mobilepush/nl/ja/t_sandbox.md +++ b/services/mobilepush/nl/ja/t_sandbox.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# サンドボックス・モードおよび実動モード -{: #push-sandboxandproduction-modes} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - -{{site.data.keyword.mobilepushshort}} は、サンドボックス・モードまたは実動モードのいずれかで使用できます。サンドボックスは、サーバー・アプリケーション・プッシュ・サービスとのプッシュ API の統合を開発およびテストするための自己完結型のテスト環境です。 - -Push ダッシュボードを使用して、サンドボックス・モードと実動モードを構成します。[Push REST API](https://mobile.{DomainName}/imfpush/){: new_window} を使用して、プッシュ・サービスの動作モードをサンドボックスと実動の間で切り替えることができます。デフォルトでは、サンドボックス・モードが有効になっています。ただし、モードの切り替え時に、タグ、デバイス、およびサブスクリプションは共有されません。 - -アプリケーションをライブ環境にデプロイする準備ができたら、[Push REST API](https://mobile.{DomainName}/imfpush/){: new_window} を使用して、「実動」モードを選択します。 - -プッシュ・サービスの動作モードをサンドボックスから実動に切り替えるには、以下のようにします。 - -1. PUT ApplicationID Settings REST API 呼び出しを使用します。 -2. JSON 本体で、[GET ApplicationID Settings REST](https://mobile.{DomainName}/imfpush/){: new_window} API 呼び出しを使用して、モードが切り替えられたことを確認します。予想される応答は、"mode": "PRODUCTION です。 -```{ - "mode": "PRODUCTION" - } -``` - {: codeblock} -1. 環境モードの切り替え後、クライアント・コードを再度実行して、「実動」モードでデバイスを登録します。 - -REST API については、[REST API の使用](t_restapi.html)を参照してください。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# サンドボックス・モードおよび実動モード +{: #push-sandboxandproduction-modes} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + +{{site.data.keyword.mobilepushshort}} は、サンドボックス・モードまたは実動モードのいずれかで使用できます。サンドボックスは、サーバー・アプリケーション・プッシュ・サービスとのプッシュ API の統合を開発およびテストするための自己完結型のテスト環境です。 + +Push ダッシュボードを使用して、サンドボックス・モードと実動モードを構成します。[Push REST API](https://mobile.{DomainName}/imfpush/){: new_window} を使用して、プッシュ・サービスの動作モードをサンドボックスと実動の間で切り替えることができます。デフォルトでは、サンドボックス・モードが有効になっています。ただし、モードの切り替え時に、タグ、デバイス、およびサブスクリプションは共有されません。 + +アプリケーションをライブ環境にデプロイする準備ができたら、[Push REST API](https://mobile.{DomainName}/imfpush/){: new_window} を使用して、「実動」モードを選択します。 + +プッシュ・サービスの動作モードをサンドボックスから実動に切り替えるには、以下のようにします。 + +1. PUT ApplicationID Settings REST API 呼び出しを使用します。 +2. JSON 本体で、[GET ApplicationID Settings REST](https://mobile.{DomainName}/imfpush/){: new_window} API 呼び出しを使用して、モードが切り替えられたことを確認します。予想される応答は、"mode": "PRODUCTION です。 +```{ + "mode": "PRODUCTION" + } +``` + {: codeblock} +1. 環境モードの切り替え後、クライアント・コードを再度実行して、「実動」モードでデバイスを登録します。 + +REST API については、[REST API の使用](t_restapi.html)を参照してください。 diff --git a/services/mobilepush/nl/ja/t_send_push_notifications.md b/services/mobilepush/nl/ja/t_send_push_notifications.md index 33122dc1e..6dcfc9c3a 100644 --- a/services/mobilepush/nl/ja/t_send_push_notifications.md +++ b/services/mobilepush/nl/ja/t_send_push_notifications.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 基本プッシュ通知の送信 -{: #push-send-notifications} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - -アプリケーションを開発したら、(タグ、バッジ、追加のペイロード、音声ファイルを使用することなく) 基本プッシュ通知を送信できます。 - -基本プッシュ通知を送信するには、以下にリストした手順を実行します。 - -1. **「通知の送信 (Send Notifications)」**を選択し、次に適切な**「送信先 (Send To)」**オプションを選択します。 - -**注**: **「すべてのデバイス」**オプションを選択すると、{{site.data.keyword.mobilepushshort}}をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 - -![「通知」画面](images/tag_notification.jpg) -2. **「メッセージ」**フィールドで、メッセージを入力してから**「送信」**をクリックします。 - -3. デバイスが通知を受信していることを確認します。次のイメージは、Android デバイスおよび iOS デバイス上でフォアグラウンドの{{site.data.keyword.mobilepushshort}}を処理しているアラート・ボックスを示しています。 - -![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) - -![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) - -次のスクリーン・ショットは、Android のバックグラウンドでの{{site.data.keyword.mobilepushshort}}を示しています。 - -![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 基本プッシュ通知の送信 +{: #push-send-notifications} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + +アプリケーションを開発したら、(タグ、バッジ、追加のペイロード、音声ファイルを使用することなく) 基本プッシュ通知を送信できます。 + +基本プッシュ通知を送信するには、以下にリストした手順を実行します。 + +1. **「通知の送信 (Send Notifications)」**を選択し、次に適切な**「送信先 (Send To)」**オプションを選択します。 + +**注**: **「すべてのデバイス」**オプションを選択すると、{{site.data.keyword.mobilepushshort}}をサブスクライブしているすべてのデバイスが通知を受け取ることになります。 + +![「通知」画面](images/tag_notification.jpg) +2. **「メッセージ」**フィールドで、メッセージを入力してから**「送信」**をクリックします。 + +3. デバイスが通知を受信していることを確認します。次のイメージは、Android デバイスおよび iOS デバイス上でフォアグラウンドの{{site.data.keyword.mobilepushshort}}を処理しているアラート・ボックスを示しています。 + +![Android 上のフォアグラウンドのプッシュ通知](images/Android_Screenshot.jpg) + +![iOS 上のフォアグラウンドのプッシュ通知](images/iOS_Screenshot.jpg) + +次のスクリーン・ショットは、Android のバックグラウンドでの{{site.data.keyword.mobilepushshort}}を示しています。 + +![Android 上のバックグラウンドのプッシュ通知](images/background.jpg) diff --git a/services/mobilepush/nl/ja/t_service_instance.md b/services/mobilepush/nl/ja/t_service_instance.md index 4db3840ab..8738ab956 100644 --- a/services/mobilepush/nl/ja/t_service_instance.md +++ b/services/mobilepush/nl/ja/t_service_instance.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# プッシュ・サービス・インスタンスの作成 -{: #create-push-instance} - -{{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}} の使用を開始するには、最初に {{site.data.keyword.Bluemix}} アプリケーション (例えば、Node.js アプリ) を作成します。次に、プッシュ・サービス {{site.data.keyword.mobilepushfull}} のインスタンスを作成し、この Bluemix アプリケーションにバインドする必要があります。これはまた、Bluemix カタログの「ボイラープレート」セクションに移動して、「MobileFirst Services Starter」をクリックすることでも行えます。 - -**注**: 環境を管理するために複数の組織を構成した場合は、モバイル・アプリ用のランタイムおよびサービスを作成する組織を選択します。 - - -1. Bluemix アプリケーションがない場合は、1 つ (例えば、Node.js アプリ) を作成する必要があります。 -Bluemix アプリケーションを作成するには「Bluemix ダッシュボード (Bluemix Dashboard)」に移動し、**「アプリの作成」**をクリックします。 - - **注**: アプリケーションがある場合は、ステップ 7 に進み、サービスを追加します。![サービス・インスタンスの作成](images/create_service_instance1.jpg "サービス・インスタンスの作成") - -1. **「アプリ・テンプレートの選択」**で、**「WEB」**をクリックします。 - -3. **「開始点の選択」**エリアで、**「SDK for Node.js」**を選択して、**「続行」**をクリックします。![開始点](images/create_service_nodejs2.jpg) - -4. **「スペース」**プルダウン・メニューで、組織スペースを選択します。 - - ![ -Select organization space](images/create_a_service3.jpg) -1. **「名前」**にアプリの名前を入力し、「ホスト」にホストの名前を入力します。 - -1. **「選択済みプラン」**プルダウン・メニューから、プランを選択し、**「作成」**ボタンをクリックします。アプリケーションのステージングを待ちます。 - -1. **「概要」**リンクをクリックします。![サービスの追加](images/create_service_add4.jpg) -1. **「サービスの追加」**をクリックします。「カタログ」画面が表示されます。 - -1. **「IBM Push Notifications」**を選択します。**「スペース」**プルダウン・メニューから組織を選択します。 - - ![組織スペースのプルダウン・メニュー](images/create_service_org.jpg) -1. **「サービス名」**に、Push Notification Service の名前を入力します。 - -1. **「選択済みプラン」**で、プランを選択し、**「作成」**ボタンをクリックします。 - -1. **「はい」**をクリックして、アプリケーションを再ステージングします。 - - ![IBM Push Notification Service](images/create_service_notification5.jpg) - -1. **「Push Notifications」**をクリックして、「Push Notification」ダッシュボードを表示します。 +--- + +copyright: + years: 2015, 2016 + +--- + +# プッシュ・サービス・インスタンスの作成 +{: #create-push-instance} + +{{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}} の使用を開始するには、最初に {{site.data.keyword.Bluemix}} アプリケーション (例えば、Node.js アプリ) を作成します。次に、プッシュ・サービス {{site.data.keyword.mobilepushfull}} のインスタンスを作成し、この Bluemix アプリケーションにバインドする必要があります。これはまた、Bluemix カタログの「ボイラープレート」セクションに移動して、「MobileFirst Services Starter」をクリックすることでも行えます。 + +**注**: 環境を管理するために複数の組織を構成した場合は、モバイル・アプリ用のランタイムおよびサービスを作成する組織を選択します。 + + +1. Bluemix アプリケーションがない場合は、1 つ (例えば、Node.js アプリ) を作成する必要があります。 +Bluemix アプリケーションを作成するには「Bluemix ダッシュボード (Bluemix Dashboard)」に移動し、**「アプリの作成」**をクリックします。 + + **注**: アプリケーションがある場合は、ステップ 7 に進み、サービスを追加します。![サービス・インスタンスの作成](images/create_service_instance1.jpg "サービス・インスタンスの作成") + +1. **「アプリ・テンプレートの選択」**で、**「WEB」**をクリックします。 + +3. **「開始点の選択」**エリアで、**「SDK for Node.js」**を選択して、**「続行」**をクリックします。![開始点](images/create_service_nodejs2.jpg) + +4. **「スペース」**プルダウン・メニューで、組織スペースを選択します。 + + ![ +Select organization space](images/create_a_service3.jpg) +1. **「名前」**にアプリの名前を入力し、「ホスト」にホストの名前を入力します。 + +1. **「選択済みプラン」**プルダウン・メニューから、プランを選択し、**「作成」**ボタンをクリックします。アプリケーションのステージングを待ちます。 + +1. **「概要」**リンクをクリックします。![サービスの追加](images/create_service_add4.jpg) +1. **「サービスの追加」**をクリックします。「カタログ」画面が表示されます。 + +1. **「IBM Push Notifications」**を選択します。**「スペース」**プルダウン・メニューから組織を選択します。 + + ![組織スペースのプルダウン・メニュー](images/create_service_org.jpg) +1. **「サービス名」**に、Push Notification Service の名前を入力します。 + +1. **「選択済みプラン」**で、プランを選択し、**「作成」**ボタンをクリックします。 + +1. **「はい」**をクリックして、アプリケーションを再ステージングします。 + + ![IBM Push Notification Service](images/create_service_notification5.jpg) + +1. **「Push Notifications」**をクリックして、「Push Notification」ダッシュボードを表示します。 diff --git a/services/mobilepush/nl/ja/t_subscribe_tags.md b/services/mobilepush/nl/ja/t_subscribe_tags.md index 4a7ecf41f..bfc8b352e 100644 --- a/services/mobilepush/nl/ja/t_subscribe_tags.md +++ b/services/mobilepush/nl/ja/t_subscribe_tags.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# タグのサブスクライブとアンサブスクライブ -{: #Subscribe_tags} - -以下のコード・スニペットを使用して、デバイスのサブスクリプションの取得、タグへのサブスクライブ、およびタグからのアンサブスクライブを可能にします。 - -## Android - -このコード・スニペットを Android モバイル・アプリケーションにコピーして貼り付けます。 - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { -@Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - -## Cordova - -このコード・スニペットを Cordova モバイル・アプリケーションにコピーして貼り付けます。 - -``` -var tag = "YourTag"; -MFPPush.subscribe(tag, success, failure); -MFPPush.unsubscribe(tag, success, failure); -``` - -## Objective-C - -このコード・スニペットを Objective-C モバイル・アプリケーションにコピーして貼り付けます。 - -タグにサブスクライブするには、**subscribeToTags** API を使用します。 - -``` -[push subscribeToTags:tags completionHandler: - ^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - }else{ - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response subscribeStatus]; - [self updateMessage:@"Parsed subscribe status is:"]; - [self updateMessage:subStatus.description]; - } - }]; -``` - -タグからアンサブスクライブするには、**unsubscribeFromTags** API を使用します。 - -``` -[push unsubscribeFromTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if (error){ - [self updateMessage:error.description]; - } else { - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response unsubscribeStatus]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -## Swift - -このコード・スニペットを Swift モバイル・アプリケーションにコピーして貼り付けます。 - -**使用可能なタグへのサブスクライブ** - -タグにサブスクライブするには、**subscribeToTags** API を使用します。 - -``` -push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in - if (error != nil) { - //error while subscribing to tags - } else { - //successfully subscribed to tags var subStatus = response.subscribeStatus(); - } -} -``` - -**タグからのアンサブスクライブ** - -タグからアンサブスクライブするには、**unsubscribeFromTags** API を使用します。 - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void inif error.isEmpty {print( "Response during unsubscribed tags : \(response.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# タグのサブスクライブとアンサブスクライブ +{: #Subscribe_tags} + +以下のコード・スニペットを使用して、デバイスのサブスクリプションの取得、タグへのサブスクライブ、およびタグからのアンサブスクライブを可能にします。 + +## Android + +このコード・スニペットを Android モバイル・アプリケーションにコピーして貼り付けます。 + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { +@Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + +## Cordova + +このコード・スニペットを Cordova モバイル・アプリケーションにコピーして貼り付けます。 + +``` +var tag = "YourTag"; +MFPPush.subscribe(tag, success, failure); +MFPPush.unsubscribe(tag, success, failure); +``` + +## Objective-C + +このコード・スニペットを Objective-C モバイル・アプリケーションにコピーして貼り付けます。 + +タグにサブスクライブするには、**subscribeToTags** API を使用します。 + +``` +[push subscribeToTags:tags completionHandler: + ^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + }else{ + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response subscribeStatus]; + [self updateMessage:@"Parsed subscribe status is:"]; + [self updateMessage:subStatus.description]; + } + }]; +``` + +タグからアンサブスクライブするには、**unsubscribeFromTags** API を使用します。 + +``` +[push unsubscribeFromTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if (error){ + [self updateMessage:error.description]; + } else { + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response unsubscribeStatus]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +## Swift + +このコード・スニペットを Swift モバイル・アプリケーションにコピーして貼り付けます。 + +**使用可能なタグへのサブスクライブ** + +タグにサブスクライブするには、**subscribeToTags** API を使用します。 + +``` +push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in + if (error != nil) { + //error while subscribing to tags + } else { + //successfully subscribed to tags var subStatus = response.subscribeStatus(); + } +} +``` + +**タグからのアンサブスクライブ** + +タグからアンサブスクライブするには、**unsubscribeFromTags** API を使用します。 + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void inif error.isEmpty {print( "Response during unsubscribed tags : \(response.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` diff --git a/services/mobilepush/nl/ja/t_use_tags.md b/services/mobilepush/nl/ja/t_use_tags.md index 1d6d3c3e8..49d3acb13 100644 --- a/services/mobilepush/nl/ja/t_use_tags.md +++ b/services/mobilepush/nl/ja/t_use_tags.md @@ -1,23 +1,23 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# タグ・ベースの通知の使用 -{: #using_tags} - - -タグ・ベースの通知は、特定のタグにサブスクライブしているすべてのデバイスをターゲットとする通知メッセージです。 -各デバイスは、任意の数のタグにサブスクライブできます。このセクションでは、タグ・ベースの通知の送信方法を説明します。サブスクリプションは、Push Notifications Service Bluemix インスタンスによって維持されます。タグが削除されると、そのタグに関連付けられているすべての情報 (サブスクライバーやデバイスを含む) が削除されます。このタグはもはや存在せず、クライアント・サイドから必要な追加アクションはないので、このタグの自動アンサブスクライブは必要ありません。 - -**始めに** - -**「タグ」**画面でタグを作成します。タグの作成方法については、[「タグの作成」](t_manage_tags.html)を参照してください。 - -1. **「Push Notification」**ダッシュボードで、**「通知」**タブをクリックします。 -1. タグ・ベースの通知を送信する**「タグ」**オプションを選択します。 -1. **「タグの検索 (Search tags)」**フィールドで、使用するタグを検索し**「+ 追加 (+Add)」**ボタンをクリックします。![「通知」画面](images/tag_notification.jpg) -1. **「通知の作成 (Create Your Notifications)」**エリアに移動し、**「メッセージ・テキスト (Message Text)」**フィールドで、通知で送信したいテキストを入力します。 -1. **「送信」**ボタンをクリックします。 +--- + +copyright: + years: 2015, 2016 + +--- + +# タグ・ベースの通知の使用 +{: #using_tags} + + +タグ・ベースの通知は、特定のタグにサブスクライブしているすべてのデバイスをターゲットとする通知メッセージです。 +各デバイスは、任意の数のタグにサブスクライブできます。このセクションでは、タグ・ベースの通知の送信方法を説明します。サブスクリプションは、Push Notifications Service Bluemix インスタンスによって維持されます。タグが削除されると、そのタグに関連付けられているすべての情報 (サブスクライバーやデバイスを含む) が削除されます。このタグはもはや存在せず、クライアント・サイドから必要な追加アクションはないので、このタグの自動アンサブスクライブは必要ありません。 + +**始めに** + +**「タグ」**画面でタグを作成します。タグの作成方法については、[「タグの作成」](t_manage_tags.html)を参照してください。 + +1. **「Push Notification」**ダッシュボードで、**「通知」**タブをクリックします。 +1. タグ・ベースの通知を送信する**「タグ」**オプションを選択します。 +1. **「タグの検索 (Search tags)」**フィールドで、使用するタグを検索し**「+ 追加 (+Add)」**ボタンをクリックします。![「通知」画面](images/tag_notification.jpg) +1. **「通知の作成 (Create Your Notifications)」**エリアに移動し、**「メッセージ・テキスト (Message Text)」**フィールドで、通知で送信したいテキストを入力します。 +1. **「送信」**ボタンをクリックします。 diff --git a/services/mobilepush/nl/ja/tr_error_push.md b/services/mobilepush/nl/ja/tr_error_push.md index 8e6c78974..f1b46b946 100644 --- a/services/mobilepush/nl/ja/tr_error_push.md +++ b/services/mobilepush/nl/ja/tr_error_push.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}} サービスのエラー・メッセージ -{: #errors} -最終更新日: 2017 年 2 月 13 日 -{: .last-updated} - - -以下の {{site.data.keyword.mobilepushshort}} エラー・メッセージは、REST API 要求に対する応答として返されます。 - -エラー応答の例は以下のとおりです。 -``` - { - "message": "Missing APNs credentials", - "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", - "code": "FPWSE0003E" - -} -``` - {: codeblock} - -エラーに関する追加情報を入手するには、資料で関連のエラー・コードを検索してください。 - -## FPWSE0001E -{: #error_fpwse0001e} - -**説明**: 照会しようとしているリソース (タグやサブスクリプションなど) は、このサーバー上では使用不可です。 - -**ユーザー応答**: メッセージで報告されたリソースを作成してください。代わりに、正しい ID を指定してリソースを照会することもできます。 - - -## FPWSE0002E -{: #error_fpwse0002e} - -**説明**: 作成しようとしているリソースは、既にサーバーで使用可能になっています。この場合のリソースは、タグやサブスクリプションなどです。 - -**ユーザー応答**: 異なる ID を使用してリソースを作成してください。 - - -## FPWSE0003E -{: #error_fpwse0003e} - -**説明**: {{site.data.keyword.mobilepushshort}} サービスの前提条件となる構成が完了していません。Apple Push Notification サービス (APNs) の資格情報をまだ構成していないのに取得しようとしている可能性があります。 - -**ユーザー応答**: {{site.data.keyword.mobilepushshort}} サービスが APNs 用の有効なセキュリティー証明書を使用して構成されているようにしてください。詳細情報については、[APNs の資格情報の構成![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](t_push_provider_ios.html){: new_window}を参照してください。 - - -## FPWSE0004E -{: #error_fpwse0004e} - -**説明**: 要求に含まれる JSON 本体が無効です。 - - -**ユーザー応答**: 要求では有効な JSON 構文を使用してください。 - - - -## FPWSE0005E -{: #error_fpwse0005e} - -**説明**: {{site.data.keyword.mobilepushshort}} サーバーに対する要求が正しくないか、または不完全です。API 要求を実行するために必要なプロパティー値が JSON 本体に含まれていません。例えば、パスワードが無効であるか、またはデバイス・トークンが欠落しています。 - - -**ユーザー応答**: メッセージを確認して、欠落しているプロパティー値または無効なプロパティー値を調べ、必要な情報を入力してください。 - - - -## FPWSE0006E -{: #error_fpwse0006e} - -**説明**: 要求の JSON 本体に、{{site.data.keyword.mobilepushshort}} サーバーが理解できないパラメーターが含まれています。 - - -**ユーザー応答**: 要求内の JSON 本体が、{{site.data.keyword.mobilepushshort}} サーバーで予想されている要求の形式に従っていることを確認してください。詳細情報については、[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を参照してください。 - - - -## FPWSE0007E -{: #error_fpwse0007e} - -**説明**: 要求 URL に、認識されないパラメーターが含まれる照会ストリングがあります。例えば、サブスクリプションを削除する要求に deviceId と tagName 以外のパラメーターが含まれている場合に、このエラーが発生する可能性があります。 - - -**ユーザー応答**: 要求内の JSON 本体が、{{site.data.keyword.mobilepushshort}} サーバーで予想されている要求の形式に従っていることを確認してください。詳細情報については、[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を参照してください。 - - - -## FPWSE0008E -{: #error_fpwse0008e} - -**説明**: 要求 URL に、必須パラメーターが欠落している照会ストリングがあります。例えば、サブスクリプションを削除する要求から deviceId パラメーターや tagName パラメーターが欠落していることが考えられます。 - - -**ユーザー応答**: 要求内の JSON 本体が、{{site.data.keyword.mobilepushshort}} サーバーで予想されている要求の形式に従っていることを確認してください。詳細情報については、[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を参照してください。 - - - -## FPWSE0009E -{: #error_fpwse0009e} - -**説明**: 通知を送信しようとしましたが、アプリケーションに登録されているデバイスがありません。 - -**ユーザー応答**: 通知を送信する前に、アプリケーションにデバイスを登録しておくようにしてください。 - - - -## FPWSE0010E -{: #error_fpwse0010e} - -**説明**: サーバーに実行依頼された要求により、例外条件が発生しました。このエラーの原因は、以下のいずれかの条件である可能性があります。 - -- {{site.data.keyword.mobilepushshort}} が使用する内部サブシステムが応答していない。 -- 要求の結果が、{{site.data.keyword.mobilepushshort}} によって処理できない可能性のあるエラー条件になった。 -- {{site.data.keyword.mobilepushshort}} サービスには管理者による対応が必要である。 - -**ユーザー応答**: 要求を再試行してください。問題が解決しない場合は、IBM ソフトウェア・サポートにお問い合わせください。 - - - -## FPWSE0011E -{: #error_fpwse0011e} - -**説明**: タグのサブスクリプションがサーバー上に既に存在しています。例えば、既に存在しているサブスクリプションを作成しようとした場合です。 - -**ユーザー応答**: 固有のタグ名を使用してサブスクリプションを作成してください。 - - - -## FPWSE0012E -{: #error_fpwse0012e} - -**説明**: タグのサブスクリプションがサーバー上に存在しません。存在しないサブスクリプションを取得または削除する要求を処理依頼した場合に、このエラーが発生します。 - - -**ユーザー応答**: 要求では正しいタグ名とデバイス ID を使用してください。 - - - -## FPWSE0013E -{: #error_fpwse0013e} - -**説明**: 要求に含まれる JSON ペイロードが無効です。 - - -**ユーザー応答**: JSON ペイロードが有効になるようにしてください。 - - -## FPWSE0025E -{: #error_fpwse0025e} - -**説明**: 現在サーバーは要求を処理できません。 - -**ユーザー応答**: しばらく時間をおいてから要求を再サブミットしてください。 - - -## FPWSE1007E -{: #error_fpwse1007e} - -**説明**: {{site.data.keyword.mobilepushshort}} サービスがこのアプリケーションでは使用不可になっています。原因は料金の請求にあるか、あるいは管理者によってアプリが無効にされたことが考えられます。 - - -**ユーザー応答**: Bluemix の資料にあるトラブルシューティング関連のトピックを参照して、サービス状況の確認、トラブルシューティング情報の検討、またはヘルプの取得に関する情報を確認してください。 - - - -## FPWSE1079E -{: #error_fpwse1079e} - -**説明**: 照会操作のために指定されたオフセット値が無効です。 - -**ユーザー応答**: オフセット値は 0 (ゼロ) 以上になるようにしてください。 - - - -## FPWSE1080E -{: #error_fpwse1080e} - -**説明**: 照会操作のために指定されたサイズ値が無効です。 - -**ユーザー応答**: サイズ値は 0 (ゼロ) より大きくなるようにしてください。 - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}} サービスのエラー・メッセージ +{: #errors} +最終更新日: 2017 年 2 月 13 日 +{: .last-updated} + + +以下の {{site.data.keyword.mobilepushshort}} エラー・メッセージは、REST API 要求に対する応答として返されます。 + +エラー応答の例は以下のとおりです。 +``` + { + "message": "Missing APNs credentials", + "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", + "code": "FPWSE0003E" + +} +``` + {: codeblock} + +エラーに関する追加情報を入手するには、資料で関連のエラー・コードを検索してください。 + +## FPWSE0001E +{: #error_fpwse0001e} + +**説明**: 照会しようとしているリソース (タグやサブスクリプションなど) は、このサーバー上では使用不可です。 + +**ユーザー応答**: メッセージで報告されたリソースを作成してください。代わりに、正しい ID を指定してリソースを照会することもできます。 + + +## FPWSE0002E +{: #error_fpwse0002e} + +**説明**: 作成しようとしているリソースは、既にサーバーで使用可能になっています。この場合のリソースは、タグやサブスクリプションなどです。 + +**ユーザー応答**: 異なる ID を使用してリソースを作成してください。 + + +## FPWSE0003E +{: #error_fpwse0003e} + +**説明**: {{site.data.keyword.mobilepushshort}} サービスの前提条件となる構成が完了していません。Apple Push Notification サービス (APNs) の資格情報をまだ構成していないのに取得しようとしている可能性があります。 + +**ユーザー応答**: {{site.data.keyword.mobilepushshort}} サービスが APNs 用の有効なセキュリティー証明書を使用して構成されているようにしてください。詳細情報については、[APNs の資格情報の構成![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](t_push_provider_ios.html){: new_window}を参照してください。 + + +## FPWSE0004E +{: #error_fpwse0004e} + +**説明**: 要求に含まれる JSON 本体が無効です。 + + +**ユーザー応答**: 要求では有効な JSON 構文を使用してください。 + + + +## FPWSE0005E +{: #error_fpwse0005e} + +**説明**: {{site.data.keyword.mobilepushshort}} サーバーに対する要求が正しくないか、または不完全です。API 要求を実行するために必要なプロパティー値が JSON 本体に含まれていません。例えば、パスワードが無効であるか、またはデバイス・トークンが欠落しています。 + + +**ユーザー応答**: メッセージを確認して、欠落しているプロパティー値または無効なプロパティー値を調べ、必要な情報を入力してください。 + + + +## FPWSE0006E +{: #error_fpwse0006e} + +**説明**: 要求の JSON 本体に、{{site.data.keyword.mobilepushshort}} サーバーが理解できないパラメーターが含まれています。 + + +**ユーザー応答**: 要求内の JSON 本体が、{{site.data.keyword.mobilepushshort}} サーバーで予想されている要求の形式に従っていることを確認してください。詳細情報については、[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を参照してください。 + + + +## FPWSE0007E +{: #error_fpwse0007e} + +**説明**: 要求 URL に、認識されないパラメーターが含まれる照会ストリングがあります。例えば、サブスクリプションを削除する要求に deviceId と tagName 以外のパラメーターが含まれている場合に、このエラーが発生する可能性があります。 + + +**ユーザー応答**: 要求内の JSON 本体が、{{site.data.keyword.mobilepushshort}} サーバーで予想されている要求の形式に従っていることを確認してください。詳細情報については、[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を参照してください。 + + + +## FPWSE0008E +{: #error_fpwse0008e} + +**説明**: 要求 URL に、必須パラメーターが欠落している照会ストリングがあります。例えば、サブスクリプションを削除する要求から deviceId パラメーターや tagName パラメーターが欠落していることが考えられます。 + + +**ユーザー応答**: 要求内の JSON 本体が、{{site.data.keyword.mobilepushshort}} サーバーで予想されている要求の形式に従っていることを確認してください。詳細情報については、[REST API ![外部リンク・アイコン](../../icons/launch-glyph.svg "外部リンク・アイコン")](https://mobile.{DomainName}/imfpush/){: new_window}を参照してください。 + + + +## FPWSE0009E +{: #error_fpwse0009e} + +**説明**: 通知を送信しようとしましたが、アプリケーションに登録されているデバイスがありません。 + +**ユーザー応答**: 通知を送信する前に、アプリケーションにデバイスを登録しておくようにしてください。 + + + +## FPWSE0010E +{: #error_fpwse0010e} + +**説明**: サーバーに実行依頼された要求により、例外条件が発生しました。このエラーの原因は、以下のいずれかの条件である可能性があります。 + +- {{site.data.keyword.mobilepushshort}} が使用する内部サブシステムが応答していない。 +- 要求の結果が、{{site.data.keyword.mobilepushshort}} によって処理できない可能性のあるエラー条件になった。 +- {{site.data.keyword.mobilepushshort}} サービスには管理者による対応が必要である。 + +**ユーザー応答**: 要求を再試行してください。問題が解決しない場合は、IBM ソフトウェア・サポートにお問い合わせください。 + + + +## FPWSE0011E +{: #error_fpwse0011e} + +**説明**: タグのサブスクリプションがサーバー上に既に存在しています。例えば、既に存在しているサブスクリプションを作成しようとした場合です。 + +**ユーザー応答**: 固有のタグ名を使用してサブスクリプションを作成してください。 + + + +## FPWSE0012E +{: #error_fpwse0012e} + +**説明**: タグのサブスクリプションがサーバー上に存在しません。存在しないサブスクリプションを取得または削除する要求を処理依頼した場合に、このエラーが発生します。 + + +**ユーザー応答**: 要求では正しいタグ名とデバイス ID を使用してください。 + + + +## FPWSE0013E +{: #error_fpwse0013e} + +**説明**: 要求に含まれる JSON ペイロードが無効です。 + + +**ユーザー応答**: JSON ペイロードが有効になるようにしてください。 + + +## FPWSE0025E +{: #error_fpwse0025e} + +**説明**: 現在サーバーは要求を処理できません。 + +**ユーザー応答**: しばらく時間をおいてから要求を再サブミットしてください。 + + +## FPWSE1007E +{: #error_fpwse1007e} + +**説明**: {{site.data.keyword.mobilepushshort}} サービスがこのアプリケーションでは使用不可になっています。原因は料金の請求にあるか、あるいは管理者によってアプリが無効にされたことが考えられます。 + + +**ユーザー応答**: Bluemix の資料にあるトラブルシューティング関連のトピックを参照して、サービス状況の確認、トラブルシューティング情報の検討、またはヘルプの取得に関する情報を確認してください。 + + + +## FPWSE1079E +{: #error_fpwse1079e} + +**説明**: 照会操作のために指定されたオフセット値が無効です。 + +**ユーザー応答**: オフセット値は 0 (ゼロ) 以上になるようにしてください。 + + + +## FPWSE1080E +{: #error_fpwse1080e} + +**説明**: 照会操作のために指定されたサイズ値が無効です。 + +**ユーザー応答**: サイズ値は 0 (ゼロ) より大きくなるようにしてください。 + + + diff --git a/services/mobilepush/nl/ja/troubleshooting.md b/services/mobilepush/nl/ja/troubleshooting.md index ad7fe5fa6..b35885809 100644 --- a/services/mobilepush/nl/ja/troubleshooting.md +++ b/services/mobilepush/nl/ja/troubleshooting.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# トラブルシューティング -{: #errors} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - -このセクションは、{{site.data.keyword.mobilepushshort}}の一般的な問題をトラブルシューティングするためのガイドとして使用してください。 - - -### 内部サーバー・エラーが発生しました。管理者に連絡してください。(内部エラー・コード: PUSHD102E) - -**説明**: このエラーは、2015 年 11 月より前にプッシュ・インスタンスを作成した場合に発生する可能性があります。 - -**ユーザー応答**: 問題を解決するには、プッシュ・インスタンスを削除して、新しいプッシュ・インスタンスを作成します。プッシュ・インスタンスを削除すると、タグは保持されないことに注意してください。 - - -### UnauthorizedRegistration - -**説明**: Chrome Web Push は、Firebase Cloud Messaging (FCM) キーでは動作しません。GCM から FCM への移行後に Chrome 上で Web プッシュ通知を受け取れない場合、その原因は Web サイトが以前に GCM プロジェクトで動作するように構成されており、新規プロジェクトは FCM で作成されていることにあります。ブラウザーを識別する生成済みトークンは、Chrome ブラウザーによってキャッシュされます。 - -**ユーザー応答**: Cookie を削除し、ブラウザーの許可を再設定することで、この問題を解決できます。この場合、Push Notifications を有効にするための許可を要求することになります。 - - -### このブラウザーでは Service Worker はサポートされません - -**説明**: Service Worker を使用する `BMSPushSDK.js` の一部として組み込まれた SDK が使用できません。 - -**ユーザー応答**: Service Worker をサポートするブラウザーに切り替えることをお勧めします。サポートされるブラウザーのバージョンは、Firefox バージョン 49 以降と Chrome バージョン 53 (64 ビット) 以降です。 - - -### SecurityError: この操作は安全ではありません - -**説明**: このエラーは、Firefox で Web コンソールを有効にした時に表示されることがあります。プッシュ通知サービスの Web プッシュ・サポートでは、`http` プロトコルではなく `https` プロトコルを使用して Web サイトにアクセスする必要があります。 - -**ユーザー応答**: ブラウザーから `https` を使用して Web サイトへの接続を試行することをお勧めします。 - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# トラブルシューティング +{: #errors} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + +このセクションは、{{site.data.keyword.mobilepushshort}}の一般的な問題をトラブルシューティングするためのガイドとして使用してください。 + + +### 内部サーバー・エラーが発生しました。管理者に連絡してください。(内部エラー・コード: PUSHD102E) + +**説明**: このエラーは、2015 年 11 月より前にプッシュ・インスタンスを作成した場合に発生する可能性があります。 + +**ユーザー応答**: 問題を解決するには、プッシュ・インスタンスを削除して、新しいプッシュ・インスタンスを作成します。プッシュ・インスタンスを削除すると、タグは保持されないことに注意してください。 + + +### UnauthorizedRegistration + +**説明**: Chrome Web Push は、Firebase Cloud Messaging (FCM) キーでは動作しません。GCM から FCM への移行後に Chrome 上で Web プッシュ通知を受け取れない場合、その原因は Web サイトが以前に GCM プロジェクトで動作するように構成されており、新規プロジェクトは FCM で作成されていることにあります。ブラウザーを識別する生成済みトークンは、Chrome ブラウザーによってキャッシュされます。 + +**ユーザー応答**: Cookie を削除し、ブラウザーの許可を再設定することで、この問題を解決できます。この場合、Push Notifications を有効にするための許可を要求することになります。 + + +### このブラウザーでは Service Worker はサポートされません + +**説明**: Service Worker を使用する `BMSPushSDK.js` の一部として組み込まれた SDK が使用できません。 + +**ユーザー応答**: Service Worker をサポートするブラウザーに切り替えることをお勧めします。サポートされるブラウザーのバージョンは、Firefox バージョン 49 以降と Chrome バージョン 53 (64 ビット) 以降です。 + + +### SecurityError: この操作は安全ではありません + +**説明**: このエラーは、Firefox で Web コンソールを有効にした時に表示されることがあります。プッシュ通知サービスの Web プッシュ・サポートでは、`http` プロトコルではなく `https` プロトコルを使用して Web サイトにアクセスする必要があります。 + +**ユーザー応答**: ブラウザーから `https` を使用して Web サイトへの接続を試行することをお勧めします。 + diff --git a/services/mobilepush/nl/ja/troubleshooting_config_errors.md b/services/mobilepush/nl/ja/troubleshooting_config_errors.md index bd4d789bd..056b133f3 100644 --- a/services/mobilepush/nl/ja/troubleshooting_config_errors.md +++ b/services/mobilepush/nl/ja/troubleshooting_config_errors.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Web プッシュ構成エラーの解決 -{: #errors} -最終更新日: 2017 年 1 月 11 日 -{: .last-updated} - -このセクションは、一般的に発生する Web プッシュ構成に関連したエラーを解決するためのガイドとして使用してください。`BMSPushSDK.js` からの Web プッシュ・エラーには、障害に関する情報が含まれています。 - -コールバックで返されたエラーを解析するには、以下のサンプル・コードを検討してください。 - -``` -function showStatus(response) { - if(response.statusCode == 200 || response.statusCode == 201) { - document.getElementById("status").innerHTML = "Response is " + response.response; - } - else if(response.statusCode == 0) { - if(response.response) { - document.getElementById("status").innerHTML = response.response; - } - else { - document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; - } - } - else { - document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " - + response.error + " and the status code " + response.statusCode; - } - } -``` - {: codeblock} - - -- `applicationId` が誤って構成されていると {{site.data.keyword.mobilepushshort}} サービスへの初期要求が失敗し、それにより statusCode はゼロ (0) に設定されます。 -- 状況コード 200 または 201 は、正常な応答を示しています。 -- `clientSecret` が無効な場合、statusCode に 401 応答が設定されます。`response.reponse` エレメントには、エラーの説明が含まれます。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Web プッシュ構成エラーの解決 +{: #errors} +最終更新日: 2017 年 1 月 11 日 +{: .last-updated} + +このセクションは、一般的に発生する Web プッシュ構成に関連したエラーを解決するためのガイドとして使用してください。`BMSPushSDK.js` からの Web プッシュ・エラーには、障害に関する情報が含まれています。 + +コールバックで返されたエラーを解析するには、以下のサンプル・コードを検討してください。 + +``` +function showStatus(response) { + if(response.statusCode == 200 || response.statusCode == 201) { + document.getElementById("status").innerHTML = "Response is " + response.response; + } + else if(response.statusCode == 0) { + if(response.response) { + document.getElementById("status").innerHTML = response.response; + } + else { + document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; + } + } + else { + document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " + + response.error + " and the status code " + response.statusCode; + } + } +``` + {: codeblock} + + +- `applicationId` が誤って構成されていると {{site.data.keyword.mobilepushshort}} サービスへの初期要求が失敗し、それにより statusCode はゼロ (0) に設定されます。 +- 状況コード 200 または 201 は、正常な応答を示しています。 +- `clientSecret` が無効な場合、statusCode に 401 応答が設定されます。`response.reponse` エレメントには、エラーの説明が含まれます。 diff --git a/services/mobilepush/nl/ko/c_advance_notifications.md b/services/mobilepush/nl/ko/c_advance_notifications.md index 699a00e49..1959ab6e1 100644 --- a/services/mobilepush/nl/ko/c_advance_notifications.md +++ b/services/mobilepush/nl/ko/c_advance_notifications.md @@ -1,12 +1,12 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# 고급 푸시 알림 사용 -{: #push-advanced-notifications-main} - -iOS 배지, 사운드, 추가 JSON 페이로드, 조치 가능 알림, 보류 알림을 구성합니다. +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# 고급 푸시 알림 사용 +{: #push-advanced-notifications-main} + +iOS 배지, 사운드, 추가 JSON 페이로드, 조치 가능 알림, 보류 알림을 구성합니다. diff --git a/services/mobilepush/nl/ko/c_android_enable.md b/services/mobilepush/nl/ko/c_android_enable.md index f03a340d5..fed7b9a30 100644 --- a/services/mobilepush/nl/ko/c_android_enable.md +++ b/services/mobilepush/nl/ko/c_android_enable.md @@ -1,361 +1,361 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}}를 수신하도록 Android 애플리케이션 설정 -{: #tag_based_notifications} -마지막 업데이트 날짜: 2017년 2월 14일 -{: .last-updated} - -Android 애플리케이션에서 사용자 디바이스에 푸시 알림을 수신하도록 설정할 수 있습니다. Android Studio는 필수 소프트웨어이며 이를 사용하여 Android 프로젝트를 빌드하는 것이 좋습니다. Android Studio에 대한 기본 지식이 반드시 있어야 합니다. - -## Gradle을 사용하여 클라이언트 푸시 SDK 설치 -{: #android_install} - -이 섹션에서는 클라이언트 푸시 SDK를 설치하고 이를 사용하여 추가적으로 Android 애플리케이션을 개발하는 방법에 대해 설명합니다. - -Gradle을 사용하여 Bluemix® 모바일 서비스 푸시 SDK를 추가할 수 있습니다. Gradle은 저장소에서 아티팩트를 자동으로 다운로드하여 Android 애플리케이션에 제공합니다. Android Studio 및 Android Studio SDK를 올바로 설정해야 합니다. 시스템을 설정하는 방법에 대한 자세한 정보는 [Android Studio 개요 ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](https://developer.android.com/tools/studio/index.html){: new_window}을 참조하십시오. Gradle에 대한 정보는 [Gradle 빌드 구성 ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}을 참조하십시오. - -모바일 애플리케이션을 작성하고 연 후 Android Studio를 사용하여 다음 단계를 완료하십시오. - -1. 모듈 레벨 **build.gradle** 파일에 종속 항목을 추가하십시오. - - - 다음 종속 항목을 추가하여 Bluemix™ 모바일 서비스 푸시 클라이언트 SDK 및 Google 플레이 서비스 SDK를 사용자의 컴파일 범위 종속 항목에 추가하십시오. - ``` - com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ - ``` - {: codeblock} - - - 코드 스니펫에 필요한 import 문에 다음 종속 항목을 추가하십시오. - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - {: codeblock} - - - 끝에 있는 모듈 레벨 **build.gradle** 파일에 다음 종속 항목을 추가하십시오. - ``` - apply plugin: 'com.google.gms.google-services' - ``` - {: codeblock} -3. 프로젝트 레벨 **build.gradle** 파일에 다음 종속 항목을 추가하십시오. -``` -dependencies { -classpath 'com.android.tools.build:gradle:2.2.3' - classpath 'com.google.gms:google-services:3.0.0' -} -``` - {: codeblock} -5. **AndroidManifest.xml** 파일에서 다음 권한을 추가하십시오. 샘플 Manifest을 보려면 [Android helloPush 샘플 애플리케이션 ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}을 참조하십시오. 샘플 Gradle 파일을 보려면 [샘플 빌드 Gradle 파일 ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}을 참조하십시오. -``` - - - - - -``` - {: codeblock} - 여기에서 [Android 권한 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](http://developer.android.com/guide/topics/security/permissions.html){: new_window}에 대해 자세히 살펴보십시오. - -4. 활동에 대한 알림 의도 설정을 추가하십시오. 사용자가 알림 영역에서 수신한 알림을 클릭할 경우 이 설정을 통해 애플리케이션이 시작됩니다. -``` - - - - -``` - {: codeblock} -**참고**: 위의 조치에서 *Your_Android_Package_Name*을 사용자 애플리케이션에서 사용되는 애플리케이션 패키지 이름으로 대체하십시오. - -5. RECEIVE 및 REGISTRATION 이벤트 통지용으로 FCM(Firebase Cloud Messaging) 또는 GCM(Google Cloud Messaging) 의도 서비스 및 의도 필터를 추가하십시오. -``` - - - - - - - - - - -``` - {: codeblock} - -6. {{site.data.keyword.mobilepushshort}} 서비스는 알림 트레이에서 개별 알림을 검색하도록 지원합니다. 알림 트레이에서 액세스하는 알림의 경우 클릭하는 알림에 대한 핸들만 사용자에게 제공됩니다. 애플리케이션이 정상적으로 열리면 모든 알림이 표시됩니다. 이 기능을 사용하려면 다음 스니펫으로 **AndroidManifest.xml** 파일을 업데이트하십시오. - -``` - -``` - {: codeblock} - -FCM 프로젝트를 설정하고 신임 정보를 얻으려면 [발신인 ID 및 API 키 가져오기](t_push_provider_android.html)를 참조하십시오. FCM(Firebase Cloud Messaging) 콘솔을 사용하여 다음 단계를 완료하십시오. - -1. Firebase 콘솔에서 **프로젝트 설정** 아이콘을 클릭하십시오. - ![Firebase 프로젝트 설정](images/FCM_4.jpg) - -3. 앱 분할창의 일반 탭에서 **앱 추가** 또는 **Android 앱에 Firebase 추가 아이콘**을 선택하십시오. - ![Android에 Firebase 추가](images/FCM_5.jpg) - -4. Android 앱에 Firebase 추가 창에서 패키지 이름으로 **com.ibm.mobilefirstplatform.clientsdk.android.push**를 추가하십시오. 앱 닉네임 필드는 선택사항입니다. **앱 추가**를 클릭하십시오. - ![Android에 Firebase 추가 창](images/FCM_1.jpg) - -5. 'Android 앱에 Firebase 추가' 창에서 패키지 이름을 입력하여 애플리케이션의 패키지 이름을 포함하십시오. 앱 닉네임 필드는 선택사항입니다. **앱 추가**를 클릭하십시오. - - ![애플리케이션의 패키지 이름 추가](images/FCM_2.jpg) - -6. `google-services.json` 파일이 생성됩니다. `google-services.json` 파일을 Android 애플리케이션 모듈 루트 디렉토리에 복사하십시오. `google-service.json` 파일에 추가된 패키지 이름이 포함됩니다. - - ![애플리케이션의 루트 디렉토리에 json 파일 추가](images/FCM_7.jpg) - -5. Android 앱에 Firebase 추가 창에서 **계속**을 클릭하고 **완료**를 클릭하십시오. - - - -애플리케이션을 빌드하고 실행하십시오. - -## Android 앱을 위한 푸시 SDK 초기화 -{: #android_initialize} - -초기화 코드를 배치하는 공통 위치는 Android 애플리케이션에서 기본 활동의 onCreate 메소드입니다. 초기화해야 하는 두 개의 SDK 컴포넌트가 있습니다. 하나는 코어 SDK이고 다른 하나는 코어 SDK 위에 빌드되는 푸시 SDK입니다. - -###Core SDK 초기화 - -``` -// Initialize the SDK for Android - BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); -``` - {: codeblock} - -####bluemixRegionSuffix -{: bluemixRegionSuffix} - -앱이 호스트된 위치를 지정합니다. 다음 세 값 중 하나를 사용할 수 있습니다. - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -###클라이언트 푸시 SDK 초기화 - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext(), "appGUID", "clientSecret"); -``` - {: codeblock} - -####AppGUID -{: appguid_initialize_client_push_sdk} - -{{site.data.keyword.mobilepushshort}} 서비스의 AppGUID 키입니다. 이 값은 대소문자를 구분합니다. 푸시 알림 대시보드를 열고 구성 탭을 선택하십시오. 푸시 알림 서비스 대시보드에 있는 구성 탭의 모바일 옵션에서 이 값을 가져올 수 있습니다. - -## Android 디바이스 등록 -{: #android_register} - -`MFPPush.register()` API를 사용하여 {{site.data.keyword.mobilepushshort}} 서비스에 디바이스를 등록합니다. Android 디바이스에서 사용하도록 등록하는 경우 Bluemix {{site.data.keyword.mobilepushshort}} 서비스 구성 대시보드에 FCM(Firebase Cloud Messaging) 또는 GCM(Google Cloud Messaging) 정보를 추가하십시오. 자세한 정보는 [GCM(Google Cloud Messaging)의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. - -다음 코드 스니펫을 Android 모바일 애플리케이션에 복사하십시오. - -``` - //Register Android devices - push.registerDevice(new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - {: codeblock} - - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` - {: codeblock} - -## Android 디바이스에서 푸시 알림 수신 -{: #android_receive} - -notificationListener 오브젝트를 푸시에 등록하려면 **MFPPush.listen()** 메소드를 호출하십시오. 푸시 알림을 처리하는 활동의 **onResume()** 메소드에서 일반적으로 이 메소드가 호출됩니다. - -1. notificationListener 오브젝트를 푸시에 등록하려면 **listen()** 메소드를 호출하십시오. 이 메소드는 일반적으로 푸시 알림을 처리하는 활동의 **onResume()** 및 **onPause** 메소드에서 호출됩니다. - - -``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` - {: codeblock} - - - -``` - @Override - protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} - -2. 프로젝트를 빌드하고 디바이스 또는 에뮬레이터에서 이를 실행하십시오. register() 메소드의 응답 리스너에 대해 onSuccess() 메소드가 호출되면 디바이스가 {{site.data.keyword.mobilepushshort}} 서비스에 정상적으로 등록된 것입니다. 이 때 기본 푸시 알림 전송에 설명된 대로 메시지를 보낼 수 있습니다. -3. 디바이스가 알림을 수신했는지 확인하십시오. 애플리케이션이 포그라운드에 있는 경우 **MFPPushNotificationListener**에 의해 알림이 처리됩니다. 애플리케이션이 백그라운드에 있는 경우 알림 막대에 메시지가 표시됩니다. - -## Android 디바이스에서 푸시 알림 모니터링 -{: #android_monitor} - -`com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` 인터페이스를 구현하고 onStatusChange(String messageId, MFPPushNotificationStatus status) 메소드를 정의하여 애플리케이션 내의 현재 알림 상태를 모니터할 수 있습니다. - -**messageId**는 서버에서 발송한 메시지의 ID입니다. **MFPPushNotificationStatus**는 알림 상태를 값으로 정의합니다. - -- **RECEIVED** - 앱에서 알림을 수신한 상태입니다. -- **QUEUED** - 앱에서 알림 리스너 호출을 대기하도록 알림을 대기시킨 상태입니다. -- **OPENED** - 트레이에서 알림을 클릭하거나 앱 아이콘에서 실행하거나 앱이 포그라운드에 있을 때 사용자가 알림을 연 상태입니다. -- **DISMISSED** - 사용자가 트레이의 알림을 선택 취소하거나 해제하는 상태입니다. - -**com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** 클래스를 MFPPush와 함께 등록해야 합니다. - -``` - push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { -@Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { -// Handle status change -} -}); -``` - {: codeblock} - - -### DISMISSED 상태 청취 - -다음 조건 중 하나에 대한 DISMISSED 상태를 청취하도록 선택할 수 있습니다. - -- 앱이 활성인 경우(포그라운드 또는 백그라운드에서 실행 중) - - `AndroidManifest.xml` 파일에 스니펫을 추가하십시오. - -``` - - - - - -``` - {: codeblock} - -- 앱이 활성(포그라운드 또는 백그라운드에서 실행 중)이면서 실행 중이 아닌 경우(종료됨) - -**com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** 브로드캐스트 수신기를 확장하고 **onReceive()** 메소드를 대체해야 합니다. 여기서 기본 클래스의 메소드 **onReceive()**를 호출하기 전에 **MFPPushNotificationStatusListener**를 등록해야 합니다. - -``` - public class MyDismissHandler extends MFPPushNotificationDismissHandler { -@Override -public void onReceive(Context context, Intent intent) { -MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { -@Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { -// Handle status change -} -}); -super.onReceive(context, intent); -} -} -``` - {: codeblock} - - -다음 스니펫을 `AndroidManifest.xml` 파일에 추가하십시오. - -``` - - - - - -``` - {: codeblock} - -## 기본 {{site.data.keyword.mobilepushshort}} 전송 -{: #send} - -애플리케이션을 개발한 후에는 기본 푸시 알림을 전송할 수 있습니다. - -기본 푸시 알림을 전송하려면 다음 단계를 완료하십시오. - -1. **알림 전송**을 선택하고 **받는 사람** 옵션을 선택하여 메시지를 작성하십시오. 지원되는 옵션은 **태그별 디바이스**, **디바이스 ID**, **사용자 ID**, **Android 디바이스**, **iOS 디바이스**, **웹 알림** 및 **모든 디바이스**입니다. -**참고**: **모든 디바이스** 옵션을 선택하는 경우 {{site.data.keyword.mobilepushshort}}를 구독하는 모든 디바이스가 알림을 수신합니다. -![알림 화면](images/tag_notification.jpg) - -2. **메시지** 필드에 메시지를 작성하십시오. 필요에 따라 선택적 옵션을 구성하도록 선택하십시오. -3. **전송**을 클릭하십시오. -3. 디바이스가 알림을 수신했는지 확인하십시오. - -다음 스크린샷은 Android 디바이스의 포그라운드에서 -푸시 알림을 처리하는 경보 상자를 표시합니다. - -![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) - -다음 스크린샷은 Android의 백그라운드에 있는 푸시 알림을 보여줍니다. - -![Android의 백그라운드 푸시 알림](images/background.jpg) - -### 알림 전송을 위한 선택적 Android 설정 -{: #send_otpional_setting} - -Android 디바이스에 알림을 전송하기 위해 {{site.data.keyword.mobilepushshort}} 설정을 추가로 사용자 정의할 수 있습니다. 다음과 같은 선택적 사용자 정의 옵션이 지원됩니다. -![Android 사용자 정의 설정](images/android_custom_settings.jpg) - -- **접기 키**: 접기 키는 알림에 첨부됩니다. 디바이스가 오프라인 상태일 때 접기 키가 동일한 여러 개의 알림이 순차적으로 도착하는 경우 해당 알림은 접혀 있습니다. 디바이스가 온라인 상태가 되면 FCM/GCM 서버에서 알림을 수신하고 동일한 접기 키가 있는 최신 알림만 표시합니다. 접기 키가 설정되어 있지 않는 경우에는 나중에 전달할 수 있도록 새 메시지와 이전 메시지가 모두 저장됩니다. -- **사운드**: 알림을 수신할 때 재생되는 사운드 클립을 표시합니다. 기본값 또는 앱에 번들링된 사운드 리소스의 이름을 지원합니다. -- **아이콘**: 알림과 관련하여 표시할 아이콘의 이름을 지정합니다. 클라이언트 애플리케이션을 사용하여 res/drawable 폴더에 아이콘을 패키지했는지 확인하십시오. -- **우선순위**: 메시지에 전달 우선순위를 지정하는 옵션을 지정합니다. `high` 또는 `max` 우선순위를 지정한 메시지는 heads-up 알림이 되는 반면, `low` 또는 `default` 우선순위 메시지는 휴면 디바이스에서 네트워크 연결을 열지 않습니다. 이 옵션을 `min`으로 설정한 메시지는 자동 알림이 됩니다. -- **가시성**: 알림 가시성 옵션을 `public` 또는 `private`으로 설정할 수 있습니다. `private` 옵션은 일반 사용자가 볼 수 없도록 제한하며, 디바이스가 핀 또는 패턴으로 보호되거나 알림 설정이 "민감한 알림 컨텐츠 숨기기"로 설정된 경우 이 옵션을 사용하도록 선택할 수 있습니다. 가시성을 `private`으로 설정하는 경우에는 "redact" 필드를 언급해야 합니다. redact 필드에 지정된 컨텐츠만 디바이스의 보안 잠금 화면에 표시됩니다. `public`을 선택하면 알림이 누구나 읽을 수 있도록 렌더링됩니다. -- **유효 기간**: 이 값은 초 단위로 설정됩니다. 이 매개변수를 지정하지 않는 경우 FCM/GCM 서버는 메시지를 4주 동안 저장하고 전달하려고 합니다. 4주 후에 유효성이 만료됩니다. 가능한 값 범위는 0 - 2,419,200초입니다. -- **유휴 시 지연**: 이 값을 `true`로 설정하면 디바이스가 유휴 상태인 경우 FCM/GCM 서버가 알림을 전달하지 않습니다. 디바이스가 유휴 상태인 경우에도 알림이 전달되도록 하려면 이 값을 `false`로 설정하십시오. -- **동기화**: 이 옵션을 `true`로 설정하면 등록된 모든 디바이스에서 알림이 동기화됩니다. 하나의 사용자 이름을 갖는 사용자에게 동일한 애플리케이션이 설치된 여러 개의 디바이스가 있는 경우, 하나의 디바이스에서 알림을 읽으면 나머지 디바이스에서 해당 알림이 삭제됩니다. 사용자 ID를 사용하여 {{site.data.keyword.mobilepushshort}} 서비스에 등록한 경우에만 이 옵션이 작동합니다. -- **추가 페이로드**: 알림에 대한 사용자 정의 페이로드 값을 지정합니다. - - -## 다음 단계 -{: #next_steps_tags} - -정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. - -이러한 푸시 알림 서비스 기능을 앱에 추가하십시오. -태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. -고급 알림 옵션을 사용하려면 [고급 푸시 알림 사용](t_advance_badge_sound_payload.html)을 참조하십시오. +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}}를 수신하도록 Android 애플리케이션 설정 +{: #tag_based_notifications} +마지막 업데이트 날짜: 2017년 2월 14일 +{: .last-updated} + +Android 애플리케이션에서 사용자 디바이스에 푸시 알림을 수신하도록 설정할 수 있습니다. Android Studio는 필수 소프트웨어이며 이를 사용하여 Android 프로젝트를 빌드하는 것이 좋습니다. Android Studio에 대한 기본 지식이 반드시 있어야 합니다. + +## Gradle을 사용하여 클라이언트 푸시 SDK 설치 +{: #android_install} + +이 섹션에서는 클라이언트 푸시 SDK를 설치하고 이를 사용하여 추가적으로 Android 애플리케이션을 개발하는 방법에 대해 설명합니다. + +Gradle을 사용하여 Bluemix® 모바일 서비스 푸시 SDK를 추가할 수 있습니다. Gradle은 저장소에서 아티팩트를 자동으로 다운로드하여 Android 애플리케이션에 제공합니다. Android Studio 및 Android Studio SDK를 올바로 설정해야 합니다. 시스템을 설정하는 방법에 대한 자세한 정보는 [Android Studio 개요 ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](https://developer.android.com/tools/studio/index.html){: new_window}을 참조하십시오. Gradle에 대한 정보는 [Gradle 빌드 구성 ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}을 참조하십시오. + +모바일 애플리케이션을 작성하고 연 후 Android Studio를 사용하여 다음 단계를 완료하십시오. + +1. 모듈 레벨 **build.gradle** 파일에 종속 항목을 추가하십시오. + + - 다음 종속 항목을 추가하여 Bluemix™ 모바일 서비스 푸시 클라이언트 SDK 및 Google 플레이 서비스 SDK를 사용자의 컴파일 범위 종속 항목에 추가하십시오. + ``` + com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ + ``` + {: codeblock} + + - 코드 스니펫에 필요한 import 문에 다음 종속 항목을 추가하십시오. + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + {: codeblock} + + - 끝에 있는 모듈 레벨 **build.gradle** 파일에 다음 종속 항목을 추가하십시오. + ``` + apply plugin: 'com.google.gms.google-services' + ``` + {: codeblock} +3. 프로젝트 레벨 **build.gradle** 파일에 다음 종속 항목을 추가하십시오. +``` +dependencies { +classpath 'com.android.tools.build:gradle:2.2.3' + classpath 'com.google.gms:google-services:3.0.0' +} +``` + {: codeblock} +5. **AndroidManifest.xml** 파일에서 다음 권한을 추가하십시오. 샘플 Manifest을 보려면 [Android helloPush 샘플 애플리케이션 ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}을 참조하십시오. 샘플 Gradle 파일을 보려면 [샘플 빌드 Gradle 파일 ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}을 참조하십시오. +``` + + + + + +``` + {: codeblock} + 여기에서 [Android 권한 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](http://developer.android.com/guide/topics/security/permissions.html){: new_window}에 대해 자세히 살펴보십시오. + +4. 활동에 대한 알림 의도 설정을 추가하십시오. 사용자가 알림 영역에서 수신한 알림을 클릭할 경우 이 설정을 통해 애플리케이션이 시작됩니다. +``` + + + + +``` + {: codeblock} +**참고**: 위의 조치에서 *Your_Android_Package_Name*을 사용자 애플리케이션에서 사용되는 애플리케이션 패키지 이름으로 대체하십시오. + +5. RECEIVE 및 REGISTRATION 이벤트 통지용으로 FCM(Firebase Cloud Messaging) 또는 GCM(Google Cloud Messaging) 의도 서비스 및 의도 필터를 추가하십시오. +``` + + + + + + + + + + +``` + {: codeblock} + +6. {{site.data.keyword.mobilepushshort}} 서비스는 알림 트레이에서 개별 알림을 검색하도록 지원합니다. 알림 트레이에서 액세스하는 알림의 경우 클릭하는 알림에 대한 핸들만 사용자에게 제공됩니다. 애플리케이션이 정상적으로 열리면 모든 알림이 표시됩니다. 이 기능을 사용하려면 다음 스니펫으로 **AndroidManifest.xml** 파일을 업데이트하십시오. + +``` + +``` + {: codeblock} + +FCM 프로젝트를 설정하고 신임 정보를 얻으려면 [발신인 ID 및 API 키 가져오기](t_push_provider_android.html)를 참조하십시오. FCM(Firebase Cloud Messaging) 콘솔을 사용하여 다음 단계를 완료하십시오. + +1. Firebase 콘솔에서 **프로젝트 설정** 아이콘을 클릭하십시오. + ![Firebase 프로젝트 설정](images/FCM_4.jpg) + +3. 앱 분할창의 일반 탭에서 **앱 추가** 또는 **Android 앱에 Firebase 추가 아이콘**을 선택하십시오. + ![Android에 Firebase 추가](images/FCM_5.jpg) + +4. Android 앱에 Firebase 추가 창에서 패키지 이름으로 **com.ibm.mobilefirstplatform.clientsdk.android.push**를 추가하십시오. 앱 닉네임 필드는 선택사항입니다. **앱 추가**를 클릭하십시오. + ![Android에 Firebase 추가 창](images/FCM_1.jpg) + +5. 'Android 앱에 Firebase 추가' 창에서 패키지 이름을 입력하여 애플리케이션의 패키지 이름을 포함하십시오. 앱 닉네임 필드는 선택사항입니다. **앱 추가**를 클릭하십시오. + + ![애플리케이션의 패키지 이름 추가](images/FCM_2.jpg) + +6. `google-services.json` 파일이 생성됩니다. `google-services.json` 파일을 Android 애플리케이션 모듈 루트 디렉토리에 복사하십시오. `google-service.json` 파일에 추가된 패키지 이름이 포함됩니다. + + ![애플리케이션의 루트 디렉토리에 json 파일 추가](images/FCM_7.jpg) + +5. Android 앱에 Firebase 추가 창에서 **계속**을 클릭하고 **완료**를 클릭하십시오. + + + +애플리케이션을 빌드하고 실행하십시오. + +## Android 앱을 위한 푸시 SDK 초기화 +{: #android_initialize} + +초기화 코드를 배치하는 공통 위치는 Android 애플리케이션에서 기본 활동의 onCreate 메소드입니다. 초기화해야 하는 두 개의 SDK 컴포넌트가 있습니다. 하나는 코어 SDK이고 다른 하나는 코어 SDK 위에 빌드되는 푸시 SDK입니다. + +###Core SDK 초기화 + +``` +// Initialize the SDK for Android + BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); +``` + {: codeblock} + +####bluemixRegionSuffix +{: bluemixRegionSuffix} + +앱이 호스트된 위치를 지정합니다. 다음 세 값 중 하나를 사용할 수 있습니다. + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +###클라이언트 푸시 SDK 초기화 + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext(), "appGUID", "clientSecret"); +``` + {: codeblock} + +####AppGUID +{: appguid_initialize_client_push_sdk} + +{{site.data.keyword.mobilepushshort}} 서비스의 AppGUID 키입니다. 이 값은 대소문자를 구분합니다. 푸시 알림 대시보드를 열고 구성 탭을 선택하십시오. 푸시 알림 서비스 대시보드에 있는 구성 탭의 모바일 옵션에서 이 값을 가져올 수 있습니다. + +## Android 디바이스 등록 +{: #android_register} + +`MFPPush.register()` API를 사용하여 {{site.data.keyword.mobilepushshort}} 서비스에 디바이스를 등록합니다. Android 디바이스에서 사용하도록 등록하는 경우 Bluemix {{site.data.keyword.mobilepushshort}} 서비스 구성 대시보드에 FCM(Firebase Cloud Messaging) 또는 GCM(Google Cloud Messaging) 정보를 추가하십시오. 자세한 정보는 [GCM(Google Cloud Messaging)의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. + +다음 코드 스니펫을 Android 모바일 애플리케이션에 복사하십시오. + +``` + //Register Android devices + push.registerDevice(new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + {: codeblock} + + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` + {: codeblock} + +## Android 디바이스에서 푸시 알림 수신 +{: #android_receive} + +notificationListener 오브젝트를 푸시에 등록하려면 **MFPPush.listen()** 메소드를 호출하십시오. 푸시 알림을 처리하는 활동의 **onResume()** 메소드에서 일반적으로 이 메소드가 호출됩니다. + +1. notificationListener 오브젝트를 푸시에 등록하려면 **listen()** 메소드를 호출하십시오. 이 메소드는 일반적으로 푸시 알림을 처리하는 활동의 **onResume()** 및 **onPause** 메소드에서 호출됩니다. + + +``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` + {: codeblock} + + + +``` + @Override + protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} + +2. 프로젝트를 빌드하고 디바이스 또는 에뮬레이터에서 이를 실행하십시오. register() 메소드의 응답 리스너에 대해 onSuccess() 메소드가 호출되면 디바이스가 {{site.data.keyword.mobilepushshort}} 서비스에 정상적으로 등록된 것입니다. 이 때 기본 푸시 알림 전송에 설명된 대로 메시지를 보낼 수 있습니다. +3. 디바이스가 알림을 수신했는지 확인하십시오. 애플리케이션이 포그라운드에 있는 경우 **MFPPushNotificationListener**에 의해 알림이 처리됩니다. 애플리케이션이 백그라운드에 있는 경우 알림 막대에 메시지가 표시됩니다. + +## Android 디바이스에서 푸시 알림 모니터링 +{: #android_monitor} + +`com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` 인터페이스를 구현하고 onStatusChange(String messageId, MFPPushNotificationStatus status) 메소드를 정의하여 애플리케이션 내의 현재 알림 상태를 모니터할 수 있습니다. + +**messageId**는 서버에서 발송한 메시지의 ID입니다. **MFPPushNotificationStatus**는 알림 상태를 값으로 정의합니다. + +- **RECEIVED** - 앱에서 알림을 수신한 상태입니다. +- **QUEUED** - 앱에서 알림 리스너 호출을 대기하도록 알림을 대기시킨 상태입니다. +- **OPENED** - 트레이에서 알림을 클릭하거나 앱 아이콘에서 실행하거나 앱이 포그라운드에 있을 때 사용자가 알림을 연 상태입니다. +- **DISMISSED** - 사용자가 트레이의 알림을 선택 취소하거나 해제하는 상태입니다. + +**com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** 클래스를 MFPPush와 함께 등록해야 합니다. + +``` + push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { +@Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { +// Handle status change +} +}); +``` + {: codeblock} + + +### DISMISSED 상태 청취 + +다음 조건 중 하나에 대한 DISMISSED 상태를 청취하도록 선택할 수 있습니다. + +- 앱이 활성인 경우(포그라운드 또는 백그라운드에서 실행 중) + + `AndroidManifest.xml` 파일에 스니펫을 추가하십시오. + +``` + + + + + +``` + {: codeblock} + +- 앱이 활성(포그라운드 또는 백그라운드에서 실행 중)이면서 실행 중이 아닌 경우(종료됨) + +**com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** 브로드캐스트 수신기를 확장하고 **onReceive()** 메소드를 대체해야 합니다. 여기서 기본 클래스의 메소드 **onReceive()**를 호출하기 전에 **MFPPushNotificationStatusListener**를 등록해야 합니다. + +``` + public class MyDismissHandler extends MFPPushNotificationDismissHandler { +@Override +public void onReceive(Context context, Intent intent) { +MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { +@Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { +// Handle status change +} +}); +super.onReceive(context, intent); +} +} +``` + {: codeblock} + + +다음 스니펫을 `AndroidManifest.xml` 파일에 추가하십시오. + +``` + + + + + +``` + {: codeblock} + +## 기본 {{site.data.keyword.mobilepushshort}} 전송 +{: #send} + +애플리케이션을 개발한 후에는 기본 푸시 알림을 전송할 수 있습니다. + +기본 푸시 알림을 전송하려면 다음 단계를 완료하십시오. + +1. **알림 전송**을 선택하고 **받는 사람** 옵션을 선택하여 메시지를 작성하십시오. 지원되는 옵션은 **태그별 디바이스**, **디바이스 ID**, **사용자 ID**, **Android 디바이스**, **iOS 디바이스**, **웹 알림** 및 **모든 디바이스**입니다. +**참고**: **모든 디바이스** 옵션을 선택하는 경우 {{site.data.keyword.mobilepushshort}}를 구독하는 모든 디바이스가 알림을 수신합니다. +![알림 화면](images/tag_notification.jpg) + +2. **메시지** 필드에 메시지를 작성하십시오. 필요에 따라 선택적 옵션을 구성하도록 선택하십시오. +3. **전송**을 클릭하십시오. +3. 디바이스가 알림을 수신했는지 확인하십시오. + +다음 스크린샷은 Android 디바이스의 포그라운드에서 +푸시 알림을 처리하는 경보 상자를 표시합니다. + +![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) + +다음 스크린샷은 Android의 백그라운드에 있는 푸시 알림을 보여줍니다. + +![Android의 백그라운드 푸시 알림](images/background.jpg) + +### 알림 전송을 위한 선택적 Android 설정 +{: #send_otpional_setting} + +Android 디바이스에 알림을 전송하기 위해 {{site.data.keyword.mobilepushshort}} 설정을 추가로 사용자 정의할 수 있습니다. 다음과 같은 선택적 사용자 정의 옵션이 지원됩니다. +![Android 사용자 정의 설정](images/android_custom_settings.jpg) + +- **접기 키**: 접기 키는 알림에 첨부됩니다. 디바이스가 오프라인 상태일 때 접기 키가 동일한 여러 개의 알림이 순차적으로 도착하는 경우 해당 알림은 접혀 있습니다. 디바이스가 온라인 상태가 되면 FCM/GCM 서버에서 알림을 수신하고 동일한 접기 키가 있는 최신 알림만 표시합니다. 접기 키가 설정되어 있지 않는 경우에는 나중에 전달할 수 있도록 새 메시지와 이전 메시지가 모두 저장됩니다. +- **사운드**: 알림을 수신할 때 재생되는 사운드 클립을 표시합니다. 기본값 또는 앱에 번들링된 사운드 리소스의 이름을 지원합니다. +- **아이콘**: 알림과 관련하여 표시할 아이콘의 이름을 지정합니다. 클라이언트 애플리케이션을 사용하여 res/drawable 폴더에 아이콘을 패키지했는지 확인하십시오. +- **우선순위**: 메시지에 전달 우선순위를 지정하는 옵션을 지정합니다. `high` 또는 `max` 우선순위를 지정한 메시지는 heads-up 알림이 되는 반면, `low` 또는 `default` 우선순위 메시지는 휴면 디바이스에서 네트워크 연결을 열지 않습니다. 이 옵션을 `min`으로 설정한 메시지는 자동 알림이 됩니다. +- **가시성**: 알림 가시성 옵션을 `public` 또는 `private`으로 설정할 수 있습니다. `private` 옵션은 일반 사용자가 볼 수 없도록 제한하며, 디바이스가 핀 또는 패턴으로 보호되거나 알림 설정이 "민감한 알림 컨텐츠 숨기기"로 설정된 경우 이 옵션을 사용하도록 선택할 수 있습니다. 가시성을 `private`으로 설정하는 경우에는 "redact" 필드를 언급해야 합니다. redact 필드에 지정된 컨텐츠만 디바이스의 보안 잠금 화면에 표시됩니다. `public`을 선택하면 알림이 누구나 읽을 수 있도록 렌더링됩니다. +- **유효 기간**: 이 값은 초 단위로 설정됩니다. 이 매개변수를 지정하지 않는 경우 FCM/GCM 서버는 메시지를 4주 동안 저장하고 전달하려고 합니다. 4주 후에 유효성이 만료됩니다. 가능한 값 범위는 0 - 2,419,200초입니다. +- **유휴 시 지연**: 이 값을 `true`로 설정하면 디바이스가 유휴 상태인 경우 FCM/GCM 서버가 알림을 전달하지 않습니다. 디바이스가 유휴 상태인 경우에도 알림이 전달되도록 하려면 이 값을 `false`로 설정하십시오. +- **동기화**: 이 옵션을 `true`로 설정하면 등록된 모든 디바이스에서 알림이 동기화됩니다. 하나의 사용자 이름을 갖는 사용자에게 동일한 애플리케이션이 설치된 여러 개의 디바이스가 있는 경우, 하나의 디바이스에서 알림을 읽으면 나머지 디바이스에서 해당 알림이 삭제됩니다. 사용자 ID를 사용하여 {{site.data.keyword.mobilepushshort}} 서비스에 등록한 경우에만 이 옵션이 작동합니다. +- **추가 페이로드**: 알림에 대한 사용자 정의 페이로드 값을 지정합니다. + + +## 다음 단계 +{: #next_steps_tags} + +정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. + +이러한 푸시 알림 서비스 기능을 앱에 추가하십시오. +태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. +고급 알림 옵션을 사용하려면 [고급 푸시 알림 사용](t_advance_badge_sound_payload.html)을 참조하십시오. diff --git a/services/mobilepush/nl/ko/c_chrome_firefox_enable.md b/services/mobilepush/nl/ko/c_chrome_firefox_enable.md index 0895692ce..8e662e781 100644 --- a/services/mobilepush/nl/ko/c_chrome_firefox_enable.md +++ b/services/mobilepush/nl/ko/c_chrome_firefox_enable.md @@ -1,131 +1,131 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}}를 수신하도록 웹 애플리케이션 설정 -{: #web_notifications} -마지막 업데이트 날짜: 2017년 2월 16일 -{: .last-updated} - -Google Chrome, Mozilla Firefox 및 Safari 웹 애플리케이션을 사용하여 {{site.data.keyword.mobilepushshort}}를 수신할 수 있습니다. 단계를 진행하기 전에 [알림 제공자의 신임 정보 구성](t__main_push_config_provider.html)을 수행했는지 확인하십시오. - -## {{site.data.keyword.mobilepushshort}}를 위한 웹 브라우저 클라이언트 SDK 설치 -{: #web_install} - -이 주제에서는 클라이언트 JavaScript 푸시 SDK를 설치하고 이를 사용하여 추가적으로 웹 애플리케이션을 개발하는 방법에 대해 설명합니다. - -### 웹 애플리케이션에서 초기화 - -Google Chrome 웹 애플리케이션에 Javascript SDK를 설치하려면 다음 단계를 완료하십시오. - -[Bluemix 웹 푸시 SDK](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}에서 `BMSPushSDK.js`, `BMSPushServiceWorker.js`, `manifest_Website.json` 파일을 다운로드하십시오. - -1. `manifest_Website.json` 파일을 편집하십시오. - - Google Chrome 브라우저의 경우 `name`을 사용하는 사이트의 이름으로 변경하십시오. 예: `www.dailynewsupdates.com`. `gcm_sender_id`를 FCM(Firebase Cloud Messaging) 또는 GCM(Google Cloud Messaging) sender_ID로 변경하십시오. 자세한 정보는 [발신인 ID 및 API 키 가져오기](t_push_provider_android.html)를 참조하십시오. gcm_sender_id 값에는 숫자만 포함됩니다. - - ``` - { - "name": "YOUR_WEBSITE_NAME", - "gcm_sender_id": "GCM_Sender_Id" - } - ``` - {: codeblock} - - - Mozilla Firefox 브라우저의 경우, `manifest_Website.json` 파일에 다음 값을 추가하십시오. 적절한 `이름`을 제공하십시오. 이 이름은 웹 사이트의 이름이 됩니다. - - ``` - { - "name": "YOUR_WEBSITE_NAME" - } - ``` - {: codeblock} - -2. `manifest_Website.json` 파일 이름을 `manifest.json`으로 변경하십시오. -3. 웹 사이트의 루트 디렉토리에 `BMSPushSDK.js`, `BMSPushServiceWorker.js` 및 `manifest.json`을 추가하십시오. -3. html 파일의 `` 태그에 `manifest.json`을 포함시키십시오. - ``` - - ``` - {: codeblock} -4. 웹 애플리케이션에 Bluemix 웹 푸시 SDK를 포함시키십시오. - ``` - - ``` - {: codeblock} - -**참고**: 코드가 배치되고 `http`가 아닌 `https`를 사용하여 샘플 링크에 액세스되는지 확인하십시오. - -## 웹 푸시 SDK 초기화 -{: #web_initialize} - -Bluemix {{site.data.keyword.mobilepushshort}} 서비스 `app GUID` 및 `app Region`을 사용하여 푸시 SDK를 초기화하십시오. - -앱 GUID를 가져오려면 초기화된 푸시 서비스의 탐색 분할창에서 **구성** 옵션을 선택하고 **모바일 옵션**을 클릭하십시오. Bluemix 푸시 알림 서비스 appGUID 매개변수를 사용하도록 코드 스니펫을 수정하십시오. - -`App Region`은 {{site.data.keyword.mobilepushshort}} 서비스가 호스팅되는 위치를 지정합니다. 다음 세 값 중 하나를 사용할 수 있습니다. - - - 미국 댈러스의 경우: `.ng.bluemix.net` - - 영국의 경우: `.eu-gb.bluemix.net` - - 시드니의 경우: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(initParams, callback) -``` - {: codeblock} - -**참고**: 웹 푸시 SDK의 FCM 신임 정보를 변경한 경우 Chrome 브라우저에 대한 메시지 전달이 실패할 수 있습니다. 실패를 방지하려면 `bmsPush.unRegisterDevice`를 호출하십시오. - -잘못된 매개변수를 제공하는 경우 구성 관련 오류가 표시될 수 있습니다. 자세한 정보는 [웹 푸시 구성 오류 해결](troubleshooting_config_errors.html)을 참조하십시오. - -## 웹 애플리케이션 등록 -{: #web_register} - -{{site.data.keyword.mobilepushshort}} 서비스에 디바이스를 등록하려면 **register()** API를 사용하십시오. 사용하는 브라우저에 따라 다음 옵션을 사용하십시오. - -- Google Chrome에서 등록하는 경우 Bluemix {{site.data.keyword.mobilepushshort}} 서비스 웹 구성 대시보드에 FCM(Firebase Cloud Messaging) 또는 GCM(Google Cloud Messaging) API 키와 웹 사이트 URL을 추가하십시오. 자세한 정보는 Chrome 설정 아래에 있는 [GCM(Google Cloud Messaging)의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. - -- Mozilla Firefox에서 등록하는 경우, Firefox 설정 아래의 Bluemix {{site.data.keyword.mobilepushshort}} 서비스 웹 구성 대시보드에 웹 사이트 URL을 추가하십시오. - -Bluemix {{site.data.keyword.mobilepushshort}} 서비스에 등록하려면 다음 코드 스니펫을 사용하십시오. - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}}를 수신하도록 웹 애플리케이션 설정 +{: #web_notifications} +마지막 업데이트 날짜: 2017년 2월 16일 +{: .last-updated} + +Google Chrome, Mozilla Firefox 및 Safari 웹 애플리케이션을 사용하여 {{site.data.keyword.mobilepushshort}}를 수신할 수 있습니다. 단계를 진행하기 전에 [알림 제공자의 신임 정보 구성](t__main_push_config_provider.html)을 수행했는지 확인하십시오. + +## {{site.data.keyword.mobilepushshort}}를 위한 웹 브라우저 클라이언트 SDK 설치 +{: #web_install} + +이 주제에서는 클라이언트 JavaScript 푸시 SDK를 설치하고 이를 사용하여 추가적으로 웹 애플리케이션을 개발하는 방법에 대해 설명합니다. + +### 웹 애플리케이션에서 초기화 + +Google Chrome 웹 애플리케이션에 Javascript SDK를 설치하려면 다음 단계를 완료하십시오. + +[Bluemix 웹 푸시 SDK](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}에서 `BMSPushSDK.js`, `BMSPushServiceWorker.js`, `manifest_Website.json` 파일을 다운로드하십시오. + +1. `manifest_Website.json` 파일을 편집하십시오. + - Google Chrome 브라우저의 경우 `name`을 사용하는 사이트의 이름으로 변경하십시오. 예: `www.dailynewsupdates.com`. `gcm_sender_id`를 FCM(Firebase Cloud Messaging) 또는 GCM(Google Cloud Messaging) sender_ID로 변경하십시오. 자세한 정보는 [발신인 ID 및 API 키 가져오기](t_push_provider_android.html)를 참조하십시오. gcm_sender_id 값에는 숫자만 포함됩니다. + + ``` + { + "name": "YOUR_WEBSITE_NAME", + "gcm_sender_id": "GCM_Sender_Id" + } + ``` + {: codeblock} + + - Mozilla Firefox 브라우저의 경우, `manifest_Website.json` 파일에 다음 값을 추가하십시오. 적절한 `이름`을 제공하십시오. 이 이름은 웹 사이트의 이름이 됩니다. + + ``` + { + "name": "YOUR_WEBSITE_NAME" + } + ``` + {: codeblock} + +2. `manifest_Website.json` 파일 이름을 `manifest.json`으로 변경하십시오. +3. 웹 사이트의 루트 디렉토리에 `BMSPushSDK.js`, `BMSPushServiceWorker.js` 및 `manifest.json`을 추가하십시오. +3. html 파일의 `` 태그에 `manifest.json`을 포함시키십시오. + ``` + + ``` + {: codeblock} +4. 웹 애플리케이션에 Bluemix 웹 푸시 SDK를 포함시키십시오. + ``` + + ``` + {: codeblock} + +**참고**: 코드가 배치되고 `http`가 아닌 `https`를 사용하여 샘플 링크에 액세스되는지 확인하십시오. + +## 웹 푸시 SDK 초기화 +{: #web_initialize} + +Bluemix {{site.data.keyword.mobilepushshort}} 서비스 `app GUID` 및 `app Region`을 사용하여 푸시 SDK를 초기화하십시오. + +앱 GUID를 가져오려면 초기화된 푸시 서비스의 탐색 분할창에서 **구성** 옵션을 선택하고 **모바일 옵션**을 클릭하십시오. Bluemix 푸시 알림 서비스 appGUID 매개변수를 사용하도록 코드 스니펫을 수정하십시오. + +`App Region`은 {{site.data.keyword.mobilepushshort}} 서비스가 호스팅되는 위치를 지정합니다. 다음 세 값 중 하나를 사용할 수 있습니다. + + - 미국 댈러스의 경우: `.ng.bluemix.net` + - 영국의 경우: `.eu-gb.bluemix.net` + - 시드니의 경우: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(initParams, callback) +``` + {: codeblock} + +**참고**: 웹 푸시 SDK의 FCM 신임 정보를 변경한 경우 Chrome 브라우저에 대한 메시지 전달이 실패할 수 있습니다. 실패를 방지하려면 `bmsPush.unRegisterDevice`를 호출하십시오. + +잘못된 매개변수를 제공하는 경우 구성 관련 오류가 표시될 수 있습니다. 자세한 정보는 [웹 푸시 구성 오류 해결](troubleshooting_config_errors.html)을 참조하십시오. + +## 웹 애플리케이션 등록 +{: #web_register} + +{{site.data.keyword.mobilepushshort}} 서비스에 디바이스를 등록하려면 **register()** API를 사용하십시오. 사용하는 브라우저에 따라 다음 옵션을 사용하십시오. + +- Google Chrome에서 등록하는 경우 Bluemix {{site.data.keyword.mobilepushshort}} 서비스 웹 구성 대시보드에 FCM(Firebase Cloud Messaging) 또는 GCM(Google Cloud Messaging) API 키와 웹 사이트 URL을 추가하십시오. 자세한 정보는 Chrome 설정 아래에 있는 [GCM(Google Cloud Messaging)의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. + +- Mozilla Firefox에서 등록하는 경우, Firefox 설정 아래의 Bluemix {{site.data.keyword.mobilepushshort}} 서비스 웹 구성 대시보드에 웹 사이트 URL을 추가하십시오. + +Bluemix {{site.data.keyword.mobilepushshort}} 서비스에 등록하려면 다음 코드 스니펫을 사용하십시오. + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + + + diff --git a/services/mobilepush/nl/ko/c_chrome_firefox_enable_send.md b/services/mobilepush/nl/ko/c_chrome_firefox_enable_send.md index 32e27c4c4..ed281483a 100644 --- a/services/mobilepush/nl/ko/c_chrome_firefox_enable_send.md +++ b/services/mobilepush/nl/ko/c_chrome_firefox_enable_send.md @@ -1,43 +1,43 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 웹 브라우저에 기본 알림 전송 -{: #web_notifications} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - -애플리케이션을 개발한 후에는 푸시 알림을 전송할 수 있습니다. - -1. **알림 전송**을 선택하고 **받는 사람** 옵션으로 **웹 알림**을 선택하여 메시지를 작성하십시오. -2. **메시지** 필드에 전달할 메시지를 입력하십시오. -3. 다음과 같은 선택적 설정을 제공하도록 선택할 수 있습니다. - - **알림 제목**: 메시지 경보 표제로 표시할 텍스트입니다. - - **알림 아이콘 URL**: 메시지를 앱 알림 아이콘과 함께 전달해야 하는 경우 필드에서 아이콘에 대한 링크를 제공하십시오. - - **유효 기간**: 서버에 메시지 유효 기간을 알립니다. -4. Safari 브라우저에 발송된 웹 알림의 경우, 필요한 추가 정보가 있습니다. - - **조치**: 조치 단추의 레이블입니다. - - **URL 인수**: 이 알림에 사용할 URL 인수입니다. JSON 배열 양식으로 제공해야 합니다. - -다음 이미지는 대시보드의 웹 알림 옵션을 표시합니다. - - ![알림 화면](images/DashboardWebpush.jpg) - - -## 다음 단계 - {: #next_steps_tags} - -정상적으로 기본 알림을 설정한 후에는 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. - -이러한 {{site.data.keyword.mobilepushshort}} 서비스 기능을 앱에 추가하십시오. 태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. 고급 알림 옵션을 사용하려면 [고급 알림](t_advance_badge_sound_payload.html)을 참조하십시오. - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 웹 브라우저에 기본 알림 전송 +{: #web_notifications} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + +애플리케이션을 개발한 후에는 푸시 알림을 전송할 수 있습니다. + +1. **알림 전송**을 선택하고 **받는 사람** 옵션으로 **웹 알림**을 선택하여 메시지를 작성하십시오. +2. **메시지** 필드에 전달할 메시지를 입력하십시오. +3. 다음과 같은 선택적 설정을 제공하도록 선택할 수 있습니다. + - **알림 제목**: 메시지 경보 표제로 표시할 텍스트입니다. + - **알림 아이콘 URL**: 메시지를 앱 알림 아이콘과 함께 전달해야 하는 경우 필드에서 아이콘에 대한 링크를 제공하십시오. + - **유효 기간**: 서버에 메시지 유효 기간을 알립니다. +4. Safari 브라우저에 발송된 웹 알림의 경우, 필요한 추가 정보가 있습니다. + - **조치**: 조치 단추의 레이블입니다. + - **URL 인수**: 이 알림에 사용할 URL 인수입니다. JSON 배열 양식으로 제공해야 합니다. + +다음 이미지는 대시보드의 웹 알림 옵션을 표시합니다. + + ![알림 화면](images/DashboardWebpush.jpg) + + +## 다음 단계 + {: #next_steps_tags} + +정상적으로 기본 알림을 설정한 후에는 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. + +이러한 {{site.data.keyword.mobilepushshort}} 서비스 기능을 앱에 추가하십시오. 태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. 고급 알림 옵션을 사용하려면 [고급 알림](t_advance_badge_sound_payload.html)을 참조하십시오. + + + diff --git a/services/mobilepush/nl/ko/c_cordova_enable.md b/services/mobilepush/nl/ko/c_cordova_enable.md index 1760f0079..f240346b1 100644 --- a/services/mobilepush/nl/ko/c_cordova_enable.md +++ b/services/mobilepush/nl/ko/c_cordova_enable.md @@ -1,316 +1,316 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 푸시 알림을 수신하도록 Cordova 애플리케이션 설정 -{: #cordova_enable} -마지막 업데이트 날짜: 2017년 1월 18일 -{: .last-updated} - -Cordova는 JavaScript, CSS 및 HTML을 사용하여 하이브리드 애플리케이션을 빌드하는 플랫폼입니다. {{site.data.keyword.mobilepushshort}} 서비스는 Cordova 기반 iOS 및 Android 애플리케이션의 개발을 지원합니다. - -Cordova 애플리케이션에서 사용자 디바이스에 푸시 알림을 수신하도록 설정할 수 있습니다. - -## Cordova 푸시 플러그인 설치 -{: #cordova_install} - -클라이언트 푸시 플러그인을 설치하고 이를 사용하여 추가적으로 Cordova 애플리케이션을 개발할 수 있습니다. 이 때 사용자와 Bluemix의 연결을 초기화하는 Cordova 코어 플러그인도 설치됩니다. - -### 시작하기 전에 - -1. 최신 Android Studio SDK 및 Xcode 버전을 다운로드하십시오. -1. 에뮬레이터를 설정하십시오. Android Studio의 경우 Google Play API를 지원하는 에뮬레이터를 사용하십시오. -1. Git 명령행 도구를 설치하십시오. Windows의 경우 **Window 명령 프롬프트에서 Git 실행** 옵션을 선택하십시오. 이 도구를 다운로드하고 설치하는 방법에 대한 정보는 [Git ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://git-scm.com/downloads){: new_window}을 참조하십시오. -1. Node.js 및 NPM(Node Package Manager) 도구를 설치하십시오. NPM 명령행 도구는 Node.js와 함께 번들로 제공됩니다. Node.js를 다운로드하고 설치하는 방법에 대한 정보는 [Node.js ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://nodejs.org/en/download/){: new_window}을 참조하십시오. -1. 명령행에서 **npm install -g cordova** 명령을 사용하여 Cordova 명령행 도구를 설치하십시오. Cordova 푸시 플러그인을 사용하려면 필요합니다. Cordova를 설치하고 Cordova 앱을 설정하는 방법에 대한 정보는 [Cordova Apache ![외부 링크 아콘](../../icons/launch-glyph.svg "External link icon")](https://cordova.apache.org/#getstarted){: new_window}을 참조하십시오. 자세한 정보는 Cordova 푸시 플러그인 [Readme 파일 ![외부 링크 아이콘](../../icons/launch-glyph.svg)](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window}을 참조하십시오. -1. Cordova 앱을 작성하려는 폴더로 변경하고 다음 명령을 실행하여 Cordova 애플리케이션을 작성하십시오. 기존의 Cordova 앱이 있을 경우 3단계로 가십시오. -```cordova create your_app_name -cd your_app_name -``` - {: codeblock} -- 선택사항: **config.xml** 파일을 편집하고 요소의 애플리케이션 이름을 기본값인 HelloCordova 이름이 아닌 사용자가 선택하는 이름으로 변경할 수 있습니다. - -올바른 번들 ID를 지정했는지 확인하십시오. 올바르지 않은 번들 ID를 지정하면 Xcode에 다음 오류 메시지가 표시됩니다. - -* 실행 파일이 올바르지 않은 인타이틀먼트로 서명되었습니다. -* 애플리케이션의 코드 서명 인타이틀먼트에 지정된 인타이틀먼트가 프로비저닝 프로파일에 지정된 인타이틀먼트와 일치하지 않습니다. 이 문제를 수정하려면 Xcode 또는 Cordova 앱 **config.xml** 파일에서 올바른 번들 ID를 지정하십시오. - -1. Corova 애플리케이션의 config.xml 파일에 최소 지원 API 또는 배치 대상 선언을 추가하십시오. minSdkVersion 값은 15보다 커야 합니다. targetSdkVersion 값은 항상 Google을 통해 제공받을 수 있는 최신 Android SDK를 반영해야 합니다. - - * Android - 편집기에서 **config.xml** 파일을 열고 최소의 대상 SDK 버전으로 -`` 요소를 업데이트하십시오. - - ``` - - - - - - ``` - {: codeblock} - - * iOS - 배치 대상 선언으로 요소를 업데이트하십시오. - - ``` - - - - - ``` - {: codeblock} - -1. Cordova 명령행 인터페이스(CLI)에서 다음 명령을 사용하여 플랫폼(iOS, Android 또는 둘 다)을 추가하십시오. -``` -cordova platform add ios -cordova platform add android -``` - {: codeblock} - -1. Cordova 애플리케이션 루트 디렉토리에서 다음 명령을 입력하여 Cordova 푸시 플러그인을 설치하십시오. **cordova plugin add bms-push**. 추가한 플랫폼에 따라 다음과 같이 표시됩니다. -``` -Installing "bms-push" for android -Installing "bms-push" for ios -``` - {: codeblock} - -1. your-app-root-folder에서 다음 명령을 사용하여 Cordova 코어 플러그인과 푸시 플러그인이 정상적으로 설치되었는지 확인하십시오. **cordova plugin list**. 추가한 플랫폼에 따라 다음과 같이 표시됩니다. -``` -bms-core "BMSCore" -bms-push "BMSPush" -``` - {: codeblock} - -1. iOS 개발 환경을 구성하십시오. -2. Xcode를 사용하여 애플리케이션을 빌드하고 실행하십시오. -1. Android용 Firebase `google-services.json`을 다운로드하고 Cordova 프로젝트의 루트 폴더인 `[your-app-name]/platforms/android에 두십시오. - 1. `[your-app-name]/platforms/android`로 이동하십시오. - 2. `build.gradle` 파일을 여십시오(경로 : 플랫폼 > android > build.gradle). - 3. `build.gradle` 파일에서 `buildscript` 텍스트를 찾으십시오. - 4. classpath 행 다음에 classpath 'com.google.gms:google-services:3.0.0'이라는 행을 추가하십시오. - 5. 그런 다음 "dependencies"를 찾으십시오. `compile` 텍스트가 있는 종속 항목과 해당 종속 항목이 종료되는 위치를 선택한 후, 그 다음에 :apply plugin: 'com.google.gms.google-services'라는 행을 추가하십시오. - 6. Cordova Android 프로젝트를 준비하고 빌드하십시오. - ``` - cordova prepare android - cordova build android - ``` - {: codeblock} - **참고**: Android Studio에서 프로젝트를 열기 전에 먼저 Cordova CLI를 통해 Cordova 애플리케이션을 빌드하십시오. 그러면 빌드 오류를 방지하는 데 유용합니다. - -## Cordova 플러그인 초기화 -{: #cordova_initialize} - -{{site.data.keyword.mobilepushshort}} 서비스 Cordova 플러그인을 사용하려면 먼저 애플리케이션 라우트와 애플리케이션 GUID를 전달하여 플러그이니을 초기화해야 합니다. 플러그인을 초기화한 후 Bluemix 대시보드에서 작성한 서버 앱에 연결할 수 있습니다. Cordova 플러그인은 Cordova 앱이 Bluemix 서비스와 통신할 수 있도록 해주는 Android 및 iOS 클라이언트 SDK용 랩퍼입니다. - -1. 다음 코드 스니펫을 복사하여 기본 JavaScript 파일(일반적으로 **www/js** 디렉토리 아래에 있음)에 붙여넣어 BMSClient를 초기화하십시오. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("YOUR APP REGION"); - var category = {}; - BMSPush.initialize(appGUID,clientSecret,category); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); - } -``` - {: codeblock} - -애플리케이션의 영역을 전달하십시오. 다음 상수가 제공됩니다. - -``` -REGION_US_SOUTH // ".ng.bluemix.net"; -REGION_UK //".eu-gb.bluemix.net"; -REGION_SYDNEY // ".au-syd.bluemix.net"; -``` - -예: - -``` -BMSClient.initialize(BMSClient.REGION_US_SOUTH); -``` - -**참고**: Cordova CLI(예: Cordova create app-name 명령)를 사용하여 Cordova 앱을 작성한 경우 이 Javascript 코드를 index.js 파일에서 onDeviceReady: function() 함수의 app.receivedEvent 함수 뒤에 넣어서 `BMSClient`를 초기화하십시오. - - -## 디바이스 등록 -{: #cordova_register} - - -디바이스를 {{site.data.keyword.mobilepushshort}} 서비스에 등록하려면 등록 메소드를 호출하십시오. 다음 코드 스니펫을 Cordova 애플리케이션에 복사하여 디바이스를 등록하십시오. - -``` -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); -``` - {: codeblock} - -다음 JavaScript 코드 스니펫은 Bluemix 모바일 서비스 클라이언트 SDK를 초기화하고, 디바이스를 {{site.data.keyword.mobilepushshort}} 서비스에 등록하고, 푸시 알림을 청취하는 방법을 표시합니다. 이 코드를 Javascript 파일에 포함하십시오. - -**onDeviceReady: function()**에서 다음을 수행하십시오. - -``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); -BMSClient.initialize("YOUR APP REGION"); -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; -BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. - -``` -// Register the device token with Bluemix Push Notification Service -func application(application: UIApplication, - didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { - CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) -} -// Handle error when failed to register device token with APNs -func application(application: UIApplication, - didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) -} -``` - {: codeblock} - -##다음 단계 - -{: #cordova_register_next} - -프로젝트를 빌드하고 다음 명령을 사용하여 프로젝트를 실행하십시오. - -####Android -{: android-next-steps} - -``` -cordova build android -``` - {: codeblock} - -``` -cordova run android -``` - {: codeblock} - -####iOS -{: ios-next-steps} - -``` -cordova build ios -``` - {: codeblock} - -``` -cordova run ios -``` - {: codeblock} - -## 디바이스에서 푸시 알림 수신 -{: #cordova_receive} - -디바이스에서 푸시 알림을 받으려면 다음 코드 스니펫을 복사하십시오. - -###JavaScript - -다음의 JavaScript 코드 스니펫을 Cordova 애플리케이션의 웹 파트에 추가하십시오. -``` -var showNotification = function(notif) { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -###Android 알림 특성 - -다음 섹션에는 Android 알림 특성이 나열되어 있습니다. - -* **메시지** - 푸시 알림 메시지 -* **페이로드** - 알림 페이로드를 포함하는 JSON 오브젝트 - - -###iOS 알림 특성 - -다음 섹션에는 iOS 알림 특성이 나열되어 있습니다. - -* **메시지** - 푸시 알림 메시지 -* **페이로드** - 알림 페이로드를 포함한 JSON 오브젝트 -action-loc-key - 이 문자열은 `View` 대신 해당 단추 제목에 사용할 현재 로컬라이제이션의 현지화된 문자열을 가져올 키로 사용됩니다. -* **배지** - 앱 아이콘의 배지로 표시할 숫자입니다. 이 특성을 비워두면 배지가 변경되지 않습니다. 배지를 제거하려면 이 특성의 값을 0으로 설정하십시오. -* **사운드** - 앱 번들 또는 앱 데이터 컨테이너의 라이브러리/사운드 폴더에 있는 사운드 파일의 이름입니다. - - -다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. -``` -// Handle receiving a remote notification -func application(application: UIApplication, - didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) -} -``` - {: codeblock} - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary - if remoteNotif != nil { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) - } -} -``` - {: codeblock} - -## 기본 푸시 알림 전송 -{: #push-send-notifications} - -애플리케이션을 개발한 후에는 기본 푸시 알림을 전송할 수 있습니다. - -기본 푸시 알림을 전송하려면 다음 단계를 완료하십시오. - -1. **알림 전송**을 선택하고 **받는 사람** 옵션을 선택하여 메시지를 작성하십시오. 지원되는 옵션은 **태그별 디바이스**, **디바이스 ID**, **사용자 ID**, **Android 디바이스**, **iOS 디바이스**, **웹 알림** 및 **모든 디바이스**입니다. -**참고**: **모든 디바이스** 옵션을 선택하는 경우 {{site.data.keyword.mobilepushshort}}를 구독하는 모든 디바이스가 알림을 수신합니다. -![알림 화면](images/tag_notification.jpg) - -2. **메시지** 필드에 메시지를 작성하십시오. 필요에 따라 선택적 옵션을 구성하도록 선택하십시오. -3. **전송**을 클릭하십시오. -3. 디바이스가 알림을 수신했는지 확인하십시오. - -다음 스크린샷은 Android 디바이스와 iOS 디바이스의 포그라운드에서 {{site.data.keyword.mobilepushshort}}를 처리하는 경보 상자를 표시합니다. - -![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) - -![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) - - 다음 이미지는 Android에서 사용되는 백그라운드의 {{site.data.keyword.mobilepushshort}}를 표시합니다. -![Android의 백그라운드 푸시 알림](images/background.jpg) - -## 다음 단계 -{: #next_steps_tags} - -정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. - -이러한 {{site.data.keyword.mobilepushshort}} 서비스 기능을 앱에 추가하십시오. -태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. -고급 알림 옵션을 사용하려면 [고급 푸시 알림 사용](t_advance_badge_sound_payload.html)을 참조하십시오. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 푸시 알림을 수신하도록 Cordova 애플리케이션 설정 +{: #cordova_enable} +마지막 업데이트 날짜: 2017년 1월 18일 +{: .last-updated} + +Cordova는 JavaScript, CSS 및 HTML을 사용하여 하이브리드 애플리케이션을 빌드하는 플랫폼입니다. {{site.data.keyword.mobilepushshort}} 서비스는 Cordova 기반 iOS 및 Android 애플리케이션의 개발을 지원합니다. + +Cordova 애플리케이션에서 사용자 디바이스에 푸시 알림을 수신하도록 설정할 수 있습니다. + +## Cordova 푸시 플러그인 설치 +{: #cordova_install} + +클라이언트 푸시 플러그인을 설치하고 이를 사용하여 추가적으로 Cordova 애플리케이션을 개발할 수 있습니다. 이 때 사용자와 Bluemix의 연결을 초기화하는 Cordova 코어 플러그인도 설치됩니다. + +### 시작하기 전에 + +1. 최신 Android Studio SDK 및 Xcode 버전을 다운로드하십시오. +1. 에뮬레이터를 설정하십시오. Android Studio의 경우 Google Play API를 지원하는 에뮬레이터를 사용하십시오. +1. Git 명령행 도구를 설치하십시오. Windows의 경우 **Window 명령 프롬프트에서 Git 실행** 옵션을 선택하십시오. 이 도구를 다운로드하고 설치하는 방법에 대한 정보는 [Git ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://git-scm.com/downloads){: new_window}을 참조하십시오. +1. Node.js 및 NPM(Node Package Manager) 도구를 설치하십시오. NPM 명령행 도구는 Node.js와 함께 번들로 제공됩니다. Node.js를 다운로드하고 설치하는 방법에 대한 정보는 [Node.js ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://nodejs.org/en/download/){: new_window}을 참조하십시오. +1. 명령행에서 **npm install -g cordova** 명령을 사용하여 Cordova 명령행 도구를 설치하십시오. Cordova 푸시 플러그인을 사용하려면 필요합니다. Cordova를 설치하고 Cordova 앱을 설정하는 방법에 대한 정보는 [Cordova Apache ![외부 링크 아콘](../../icons/launch-glyph.svg "External link icon")](https://cordova.apache.org/#getstarted){: new_window}을 참조하십시오. 자세한 정보는 Cordova 푸시 플러그인 [Readme 파일 ![외부 링크 아이콘](../../icons/launch-glyph.svg)](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window}을 참조하십시오. +1. Cordova 앱을 작성하려는 폴더로 변경하고 다음 명령을 실행하여 Cordova 애플리케이션을 작성하십시오. 기존의 Cordova 앱이 있을 경우 3단계로 가십시오. +```cordova create your_app_name +cd your_app_name +``` + {: codeblock} +- 선택사항: **config.xml** 파일을 편집하고 요소의 애플리케이션 이름을 기본값인 HelloCordova 이름이 아닌 사용자가 선택하는 이름으로 변경할 수 있습니다. + +올바른 번들 ID를 지정했는지 확인하십시오. 올바르지 않은 번들 ID를 지정하면 Xcode에 다음 오류 메시지가 표시됩니다. + +* 실행 파일이 올바르지 않은 인타이틀먼트로 서명되었습니다. +* 애플리케이션의 코드 서명 인타이틀먼트에 지정된 인타이틀먼트가 프로비저닝 프로파일에 지정된 인타이틀먼트와 일치하지 않습니다. 이 문제를 수정하려면 Xcode 또는 Cordova 앱 **config.xml** 파일에서 올바른 번들 ID를 지정하십시오. + +1. Corova 애플리케이션의 config.xml 파일에 최소 지원 API 또는 배치 대상 선언을 추가하십시오. minSdkVersion 값은 15보다 커야 합니다. targetSdkVersion 값은 항상 Google을 통해 제공받을 수 있는 최신 Android SDK를 반영해야 합니다. + + * Android - 편집기에서 **config.xml** 파일을 열고 최소의 대상 SDK 버전으로 +`` 요소를 업데이트하십시오. + + ``` + + + + + + ``` + {: codeblock} + + * iOS - 배치 대상 선언으로 요소를 업데이트하십시오. + + ``` + + + + + ``` + {: codeblock} + +1. Cordova 명령행 인터페이스(CLI)에서 다음 명령을 사용하여 플랫폼(iOS, Android 또는 둘 다)을 추가하십시오. +``` +cordova platform add ios +cordova platform add android +``` + {: codeblock} + +1. Cordova 애플리케이션 루트 디렉토리에서 다음 명령을 입력하여 Cordova 푸시 플러그인을 설치하십시오. **cordova plugin add bms-push**. 추가한 플랫폼에 따라 다음과 같이 표시됩니다. +``` +Installing "bms-push" for android +Installing "bms-push" for ios +``` + {: codeblock} + +1. your-app-root-folder에서 다음 명령을 사용하여 Cordova 코어 플러그인과 푸시 플러그인이 정상적으로 설치되었는지 확인하십시오. **cordova plugin list**. 추가한 플랫폼에 따라 다음과 같이 표시됩니다. +``` +bms-core "BMSCore" +bms-push "BMSPush" +``` + {: codeblock} + +1. iOS 개발 환경을 구성하십시오. +2. Xcode를 사용하여 애플리케이션을 빌드하고 실행하십시오. +1. Android용 Firebase `google-services.json`을 다운로드하고 Cordova 프로젝트의 루트 폴더인 `[your-app-name]/platforms/android에 두십시오. + 1. `[your-app-name]/platforms/android`로 이동하십시오. + 2. `build.gradle` 파일을 여십시오(경로 : 플랫폼 > android > build.gradle). + 3. `build.gradle` 파일에서 `buildscript` 텍스트를 찾으십시오. + 4. classpath 행 다음에 classpath 'com.google.gms:google-services:3.0.0'이라는 행을 추가하십시오. + 5. 그런 다음 "dependencies"를 찾으십시오. `compile` 텍스트가 있는 종속 항목과 해당 종속 항목이 종료되는 위치를 선택한 후, 그 다음에 :apply plugin: 'com.google.gms.google-services'라는 행을 추가하십시오. + 6. Cordova Android 프로젝트를 준비하고 빌드하십시오. + ``` + cordova prepare android + cordova build android + ``` + {: codeblock} + **참고**: Android Studio에서 프로젝트를 열기 전에 먼저 Cordova CLI를 통해 Cordova 애플리케이션을 빌드하십시오. 그러면 빌드 오류를 방지하는 데 유용합니다. + +## Cordova 플러그인 초기화 +{: #cordova_initialize} + +{{site.data.keyword.mobilepushshort}} 서비스 Cordova 플러그인을 사용하려면 먼저 애플리케이션 라우트와 애플리케이션 GUID를 전달하여 플러그이니을 초기화해야 합니다. 플러그인을 초기화한 후 Bluemix 대시보드에서 작성한 서버 앱에 연결할 수 있습니다. Cordova 플러그인은 Cordova 앱이 Bluemix 서비스와 통신할 수 있도록 해주는 Android 및 iOS 클라이언트 SDK용 랩퍼입니다. + +1. 다음 코드 스니펫을 복사하여 기본 JavaScript 파일(일반적으로 **www/js** 디렉토리 아래에 있음)에 붙여넣어 BMSClient를 초기화하십시오. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("YOUR APP REGION"); + var category = {}; + BMSPush.initialize(appGUID,clientSecret,category); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); + } +``` + {: codeblock} + +애플리케이션의 영역을 전달하십시오. 다음 상수가 제공됩니다. + +``` +REGION_US_SOUTH // ".ng.bluemix.net"; +REGION_UK //".eu-gb.bluemix.net"; +REGION_SYDNEY // ".au-syd.bluemix.net"; +``` + +예: + +``` +BMSClient.initialize(BMSClient.REGION_US_SOUTH); +``` + +**참고**: Cordova CLI(예: Cordova create app-name 명령)를 사용하여 Cordova 앱을 작성한 경우 이 Javascript 코드를 index.js 파일에서 onDeviceReady: function() 함수의 app.receivedEvent 함수 뒤에 넣어서 `BMSClient`를 초기화하십시오. + + +## 디바이스 등록 +{: #cordova_register} + + +디바이스를 {{site.data.keyword.mobilepushshort}} 서비스에 등록하려면 등록 메소드를 호출하십시오. 다음 코드 스니펫을 Cordova 애플리케이션에 복사하여 디바이스를 등록하십시오. + +``` +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); +``` + {: codeblock} + +다음 JavaScript 코드 스니펫은 Bluemix 모바일 서비스 클라이언트 SDK를 초기화하고, 디바이스를 {{site.data.keyword.mobilepushshort}} 서비스에 등록하고, 푸시 알림을 청취하는 방법을 표시합니다. 이 코드를 Javascript 파일에 포함하십시오. + +**onDeviceReady: function()**에서 다음을 수행하십시오. + +``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); +BMSClient.initialize("YOUR APP REGION"); +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; +BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. + +``` +// Register the device token with Bluemix Push Notification Service +func application(application: UIApplication, + didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { + CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) +} +// Handle error when failed to register device token with APNs +func application(application: UIApplication, + didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) +} +``` + {: codeblock} + +## 다음 단계 + +{: #cordova_register_next} + +프로젝트를 빌드하고 다음 명령을 사용하여 프로젝트를 실행하십시오. + +#### Android +{: android-next-steps} + +``` +cordova build android +``` + {: codeblock} + +``` +cordova run android +``` + {: codeblock} + +#### iOS +{: ios-next-steps} + +``` +cordova build ios +``` + {: codeblock} + +``` +cordova run ios +``` + {: codeblock} + +## 디바이스에서 푸시 알림 수신 +{: #cordova_receive} + +디바이스에서 푸시 알림을 받으려면 다음 코드 스니펫을 복사하십시오. + +### JavaScript + +다음의 JavaScript 코드 스니펫을 Cordova 애플리케이션의 웹 파트에 추가하십시오. +``` +var showNotification = function(notif) { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +### Android 알림 특성 + +다음 섹션에는 Android 알림 특성이 나열되어 있습니다. + +* **메시지** - 푸시 알림 메시지 +* **페이로드** - 알림 페이로드를 포함하는 JSON 오브젝트 + + +### iOS 알림 특성 + +다음 섹션에는 iOS 알림 특성이 나열되어 있습니다. + +* **메시지** - 푸시 알림 메시지 +* **페이로드** - 알림 페이로드를 포함한 JSON 오브젝트 +action-loc-key - 이 문자열은 `View` 대신 해당 단추 제목에 사용할 현재 로컬라이제이션의 현지화된 문자열을 가져올 키로 사용됩니다. +* **배지** - 앱 아이콘의 배지로 표시할 숫자입니다. 이 특성을 비워두면 배지가 변경되지 않습니다. 배지를 제거하려면 이 특성의 값을 0으로 설정하십시오. +* **사운드** - 앱 번들 또는 앱 데이터 컨테이너의 라이브러리/사운드 폴더에 있는 사운드 파일의 이름입니다. + + +다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. +``` +// Handle receiving a remote notification +func application(application: UIApplication, + didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) +} +``` + {: codeblock} + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary + if remoteNotif != nil { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) + } +} +``` + {: codeblock} + +## 기본 푸시 알림 전송 +{: #push-send-notifications} + +애플리케이션을 개발한 후에는 기본 푸시 알림을 전송할 수 있습니다. + +기본 푸시 알림을 전송하려면 다음 단계를 완료하십시오. + +1. **알림 전송**을 선택하고 **받는 사람** 옵션을 선택하여 메시지를 작성하십시오. 지원되는 옵션은 **태그별 디바이스**, **디바이스 ID**, **사용자 ID**, **Android 디바이스**, **iOS 디바이스**, **웹 알림** 및 **모든 디바이스**입니다. +**참고**: **모든 디바이스** 옵션을 선택하는 경우 {{site.data.keyword.mobilepushshort}}를 구독하는 모든 디바이스가 알림을 수신합니다. +![알림 화면](images/tag_notification.jpg) + +2. **메시지** 필드에 메시지를 작성하십시오. 필요에 따라 선택적 옵션을 구성하도록 선택하십시오. +3. **전송**을 클릭하십시오. +3. 디바이스가 알림을 수신했는지 확인하십시오. + +다음 스크린샷은 Android 디바이스와 iOS 디바이스의 포그라운드에서 {{site.data.keyword.mobilepushshort}}를 처리하는 경보 상자를 표시합니다. + +![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) + +![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) + + 다음 이미지는 Android에서 사용되는 백그라운드의 {{site.data.keyword.mobilepushshort}}를 표시합니다. +![Android의 백그라운드 푸시 알림](images/background.jpg) + +## 다음 단계 +{: #next_steps_tags} + +정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. + +이러한 {{site.data.keyword.mobilepushshort}} 서비스 기능을 앱에 추가하십시오. +태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. +고급 알림 옵션을 사용하려면 [고급 푸시 알림 사용](t_advance_badge_sound_payload.html)을 참조하십시오. diff --git a/services/mobilepush/nl/ko/c_enable_push.md b/services/mobilepush/nl/ko/c_enable_push.md index f982e0f09..05201d20f 100644 --- a/services/mobilepush/nl/ko/c_enable_push.md +++ b/services/mobilepush/nl/ko/c_enable_push.md @@ -1,25 +1,25 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 모바일 디바이스의 알림 사용 -{: #c_enable_push-notifications} -마지막 업데이트 날짜: 2017년 1월 18일 -{: .last-updated} - -[알림 제공자의 신임 정보 구성](t__main_push_config_provider.html)을 수행했는지 확인하십시오. - -이 섹션에서는 모바일, 웹 브라우저 애플리케이션과 같은 클라이언트 애플리케이션과 Chrome 앱 및 확장 프로그램에서 푸시 알림을 수신하도록 설정하는 방법, 기본 알림을 작성하고 SDK 또는 플러그인을 가져와서 초기화하는 방법, 푸시 알림을 수신하기 위해 디바이스 또는 브라우저를 등록하는 방법에 대해 설명합니다. [REST API](t_restapi.html)를 사용하여 모바일 및 웹 브라우저 애플리케이션이 푸시 알림을 수신하도록 설정할 수도 있습니다. - -**참고**: 디바이스, 브라우저, Chrome 앱 및 확장 프로그램 등록의 경우 {{site.data.keyword.mobilepushshort}} 서비스는 알림 제공자(Apple의 경우 APNs 또는 Google의 경우 FCM)가 발행한 토큰에 대한 -고유 참조를 유지보수합니다. 몇 가지 이유로 {{site.data.keyword.mobilepushshort}} 서비스 알림 제공자가 토큰을 무효화할 수 있습니다. - -예를 들어, 디바이스에서 앱을 설치 제거하는 경우입니다. 이와 같은 시나리오에서 디바이스가 무효화되는 제공자 응답을 기반으로 알림을 전달하려고 하면 {{site.data.keyword.mobilepushshort}} 서비스가 디바이스 또는 웹 브라우저 등록을 제거합니다. 그런 다음 이러한 무효화된 디바이스에 알림을 전송하려는 시도를 제한합니다. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 모바일 디바이스의 알림 사용 +{: #c_enable_push-notifications} +마지막 업데이트 날짜: 2017년 1월 18일 +{: .last-updated} + +[알림 제공자의 신임 정보 구성](t__main_push_config_provider.html)을 수행했는지 확인하십시오. + +이 섹션에서는 모바일, 웹 브라우저 애플리케이션과 같은 클라이언트 애플리케이션과 Chrome 앱 및 확장 프로그램에서 푸시 알림을 수신하도록 설정하는 방법, 기본 알림을 작성하고 SDK 또는 플러그인을 가져와서 초기화하는 방법, 푸시 알림을 수신하기 위해 디바이스 또는 브라우저를 등록하는 방법에 대해 설명합니다. [REST API](t_restapi.html)를 사용하여 모바일 및 웹 브라우저 애플리케이션이 푸시 알림을 수신하도록 설정할 수도 있습니다. + +**참고**: 디바이스, 브라우저, Chrome 앱 및 확장 프로그램 등록의 경우 {{site.data.keyword.mobilepushshort}} 서비스는 알림 제공자(Apple의 경우 APNs 또는 Google의 경우 FCM)가 발행한 토큰에 대한 +고유 참조를 유지보수합니다. 몇 가지 이유로 {{site.data.keyword.mobilepushshort}} 서비스 알림 제공자가 토큰을 무효화할 수 있습니다. + +예를 들어, 디바이스에서 앱을 설치 제거하는 경우입니다. 이와 같은 시나리오에서 디바이스가 무효화되는 제공자 응답을 기반으로 알림을 전달하려고 하면 {{site.data.keyword.mobilepushshort}} 서비스가 디바이스 또는 웹 브라우저 등록을 제거합니다. 그런 다음 이러한 무효화된 디바이스에 알림을 전송하려는 시도를 제한합니다. diff --git a/services/mobilepush/nl/ko/c_enable_push_webhook.md b/services/mobilepush/nl/ko/c_enable_push_webhook.md index 139306268..8cc250b23 100644 --- a/services/mobilepush/nl/ko/c_enable_push_webhook.md +++ b/services/mobilepush/nl/ko/c_enable_push_webhook.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 웹훅 사용 -{: #tag_based_notifications} -마지막 업데이트 날짜: 2017년 1월 23일 -{: .last-updated} - - -{{site.data.keyword.mobilepushshort}} 서비스를 사용하면 변경된 정보에 관한 경보를 수신하도록 선택할 수 있습니다. 엔터프라이즈 정보가 변경되면 이벤트가 작성되며 이를 웹훅 이벤트로 등록하여 알림을 수신할 수 있습니다. 이러한 웹훅 이벤트는 경보를 트리거합니다. - -웹훅은 이벤트에서 트리거하는 사용자 정의 콜백입니다(예: 디바이스 등록 또는 태그 구독). {{site.data.keyword.mobilepushshort}} 서비스에서 다음 웹훅 이벤트에 등록할 수 있습니다. - -- **onDeviceRegister**: 웹훅 이벤트가 푸시에 등록된 디바이스에 대해 트리거됩니다. -- **onDeviceUpdate**: 등록된 디바이스에 대한 정보를 업데이트할 때 웹훅 이벤트가 트리거됩니다. -- **onDeviceUnregister**: 디바이스의 등록이 해지될 때 웹훅 이벤트가 트리거됩니다. -- **onSubscribe**: 사용자가 태그를 구독할 때 웹훅 이벤트가 트리거됩니다. -- **onUnsubscribe**: 사용자가 태그의 구독을 해지할 때 웹훅 이벤트가 트리거됩니다. -- **onNotificationSend**: 디스패치된 알림이 있을 때 웹훅 이벤트가 트리거됩니다. -- **onNotificationFailure**: 알림이 실패하면 웹훅 이벤트가 트리거됩니다. - - -**참고**: 일괄처리로 알림 디스패치가 실행됩니다. 메시지 디스패치에 여러 웹훅 이벤트가 있으며 실패 및 성공 이벤트가 모두 포함될 수 있습니다. -웹훅 이벤트의 메시지 ID가 디스패치된 메시지 ID와 동일할 수 있습니다. - -웹훅에 대한 자세한 정보는 [IBM Push Notifications REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}을 참조하십시오. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 웹훅 사용 +{: #tag_based_notifications} +마지막 업데이트 날짜: 2017년 1월 23일 +{: .last-updated} + + +{{site.data.keyword.mobilepushshort}} 서비스를 사용하면 변경된 정보에 관한 경보를 수신하도록 선택할 수 있습니다. 엔터프라이즈 정보가 변경되면 이벤트가 작성되며 이를 웹훅 이벤트로 등록하여 알림을 수신할 수 있습니다. 이러한 웹훅 이벤트는 경보를 트리거합니다. + +웹훅은 이벤트에서 트리거하는 사용자 정의 콜백입니다(예: 디바이스 등록 또는 태그 구독). {{site.data.keyword.mobilepushshort}} 서비스에서 다음 웹훅 이벤트에 등록할 수 있습니다. + +- **onDeviceRegister**: 웹훅 이벤트가 푸시에 등록된 디바이스에 대해 트리거됩니다. +- **onDeviceUpdate**: 등록된 디바이스에 대한 정보를 업데이트할 때 웹훅 이벤트가 트리거됩니다. +- **onDeviceUnregister**: 디바이스의 등록이 해지될 때 웹훅 이벤트가 트리거됩니다. +- **onSubscribe**: 사용자가 태그를 구독할 때 웹훅 이벤트가 트리거됩니다. +- **onUnsubscribe**: 사용자가 태그의 구독을 해지할 때 웹훅 이벤트가 트리거됩니다. +- **onNotificationSend**: 디스패치된 알림이 있을 때 웹훅 이벤트가 트리거됩니다. +- **onNotificationFailure**: 알림이 실패하면 웹훅 이벤트가 트리거됩니다. + + +**참고**: 일괄처리로 알림 디스패치가 실행됩니다. 메시지 디스패치에 여러 웹훅 이벤트가 있으며 실패 및 성공 이벤트가 모두 포함될 수 있습니다. +웹훅 이벤트의 메시지 ID가 디스패치된 메시지 ID와 동일할 수 있습니다. + +웹훅에 대한 자세한 정보는 [IBM Push Notifications REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}을 참조하십시오. diff --git a/services/mobilepush/nl/ko/c_ios_enable.md b/services/mobilepush/nl/ko/c_ios_enable.md index 7c0683f34..a812063b1 100644 --- a/services/mobilepush/nl/ko/c_ios_enable.md +++ b/services/mobilepush/nl/ko/c_ios_enable.md @@ -1,333 +1,333 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#{{site.data.keyword.mobilepushshort}}를 전송하도록 iOS 애플리케이션 설정 -{: #enable-push-ios-notifications} -마지막 업데이트 날짜: 2017년 2월 14일 -{: .last-updated} - -iOS 애플리케이션이 {{site.data.keyword.mobilepushshort}}를 사용자 디바이스에 전송하도록 설정할 수 있습니다. - - -##CocoaPods 설치 -{: #enable-push-ios-notifications-install} - -기존 Xcode 프로젝트의 경우 CocoaPods 종속 항목 관리 도구를 사용하여 Bluemix Mobile Services Client SDK를 설정할 수 있습니다. 또는 SDK를 수동으로 설치할 수 있습니다. - -Swift 푸시 Readme 파일을 보려면 [Readme ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}으로 이동하십시오. - - - -1. Mac 터미널에서 다음 명령을 사용하여 CocoaPods를 설치하십시오. -```$ sudo gem install cocoapods -``` - {: codeblock} -2. 터미널에 `pod init` 명령을 입력하여 CocoaPods를 초기화하십시오. Xcode 프로젝트가 있는 디렉토리에서 명령을 실행하십시오. `pod init` 명령에서 Podfile을 작성합니다. -3. 생성된 Podfile에 필요한 SDK 종속 항목을 추가하십시오. 다음 Podfile을 복사하십시오. - - ``` - source 'https://github.com/CocoaPods/Specs.git' - //Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - pod 'BMSAnalyticsAPI' end - ``` - {: codeblock} - -3. 터미널에서 프로젝트 폴더로 이동한 후 `pod update` 명령을 사용하여 종속 항목을 설치하십시오. - -이 명령은 종속 항목을 설치하고 새 Xcode 작업공간을 작성합니다. -**참고**: 원래 Xcode 프로젝트 파일 대신, 반드시 항상 새 Xcode 작업공간을 여십시오. -``` -$ open App.xcworkspace - ``` - {: codeblock} - -작업공간에는 원래 프로젝트 및 종속 항목이 포함된 Pods 프로젝트가 있습니다. Bluemix Mobile Services 소스 폴더를 수정하려는 경우 Pods 프로젝트의 `Pods/yourImportedSourceFolder`에서 이 폴더를 찾을 수 있습니다(예: `Pods/BMSPush`). - -##Carthage를 사용하여 프레임워크 추가 -{: #carthage} - -[Carthage ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}을 사용하여 프로젝트에 프레임워크를 추가하십시오. Xcode8의 Carthage는 지원되지 않습니다. - -1. `BMSPush` 프레임워크를 Cartfile에 추가하십시오. -``` -github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" -``` - {: codeblock} -2. `carthage update` 명령을 실행하십시오. 빌드가 완료되면 `BMSPush.framework`, `BMSCore.framework`, `BMSAnalyticsAPI.framework`를 Xcode 프로젝트로 끌어오십시오. -3. [Carthage ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} 사이트의 지시사항에 따라 통합을 완료하십시오. - -##iOS SDK 설정 -{: ios-sdk} - -iOS SDK를 설치하고 다음 코드를 애플리케이션의 **AppDelegate.swift** 파일에 추가하십시오. 이 코드도 APNs에 등록됩니다. -``` -func application(_ application: UIApplication, -didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool - { - BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") - } -``` - {: codeblock} - -##가져온 프레임워크 및 소스 폴더 사용 -{: using-imported-frameworks} - -코드에서 SDK를 참조하십시오. 다음 전제조건이 충족되는지 확인하십시오. - -- iOS 8.0 이상 -- Xcode 7 - -관련 헤더에 대해 `#import` 지시문을 작성합니다. 예: -``` -//swift -import BMSCore -import BMSPush -``` - {: codeblock} - -Swift 푸시 Readme 파일을 읽어보려면 [Readme ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}을 참조하십시오. - -**참고**: CocoaPods 명령 `pod install` 또는 `pod update`를 사용하여 Pods 프로젝트를 업데이트하면 Bluemix Mobile Services 소스 폴더를 대체할 수 있습니다. 원래 파일의 사용자 정의한 버전을 유지하려면, 이러한 명령을 실행하기 전에 해당 버전을 백업해야 합니다. - - -##빌드 설정 -{: build-settings} - -**Xcode > 빌드 설정 > 빌드 옵션 및 Bitcode 사용 설정**으로 이동하여 **No**로 설정하십시오. - -**주의**: iOS 9의 경우, ATS(App Transport Security) 기능을 변경하면 인증 프로세스의 처리 방식에 영향이 미칠 수 있습니다. 다음 블로그 게시물에서 변경사항에 대한 자세한 정보를 설명합니다. [ATS and Bitcode in iOS 9 ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} 및 [Connect your iOS 9 app to Bluemix today ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. - -## iOS 앱을 위한 푸시 SDK 초기화 -{: #enable-push-ios-notifications-initialize} - -초기화 코드를 배치하는 공통 위치는 iOS 애플리케이션에 대한 애플리케이션 위임자입니다. 푸시 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 GUID를 가져오십시오. - -###Core SDK 초기화 -{: Initializing-the-core-sdk} - - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance -myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") -``` - {: codeblock} - -### 라우트, GUID 및 Bluemix 지역 -{: route-guid-bluemix-region} - -####appRoute -{: ios-approute} - -Bluemix에서 생성한 서버 애플리케이션에 지정된 라우트를 지정합니다. - -####GUID -{: ios-guid} - -Bluemix에서 생성한 애플리케이션에 지정된 고유 키를 지정합니다. 이 값은 대소문자를 구분합니다. - -####bluemixRegionSuffix -{: ios-bluemixRegionSuffix} - -앱이 호스트된 위치를 지정합니다. `bluemixRegion` 매개변수는 사용 중인 Bluemix 배치를 지정합니다. 이 값을 `BMSClient.REGION` 정적 특성으로 설정하고 세 값 중 하나를 사용할 수 있습니다. - -- BMSClient.Region.usSouth -- BMSClient.Region.unitedKingdom -- BMSClient.Region.sydney - -####AppGUID -{: ios-AppGUID} - -Bluemix에서 작성한 {{site.data.keyword.mobilepushshort}} 서비스에 지정되는 고유 AppGUID 키를 지정합니다. - -###클라이언트 푸시 SDK 초기화 -{: initializing-the-client-Push-SDK} - -``` - //Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -## iOS 애플리케이션 및 디바이스 등록 -{: #enable-push-ios-notifications-register} - - -디바이스에 애플리케이션을 설치한 후 원격 알림을 수신하려면 애플리케이션을 APNs에 등록해야 합니다. APNs에서 생성한 디바이스 토큰을 앱에서 수신한 후에는 {{site.data.keyword.mobilepushshort}} 서비스에 이를 되돌려 보내야 합니다. - -iOS 애플리케이션과 디바이스를 등록하려면 다음을 수행해야 합니다. - -1. 백엔드 애플리케이션을 작성하십시오. -2. 토큰을 {{site.data.keyword.mobilepushshort}}에 전달하십시오. - - -###백엔드 애플리케이션 작성 -{: create-a-backend-app} - -표준 유형 섹션 Bluemix® 카탈로그에서 {{site.data.keyword.mobilepushshort}} 서비스를 이 애플리케이션에 자동으로 바인드하는 백엔드 애플리케이션을 작성하십시오. 백엔드 앱을 이미 작성한 경우에는 앱을 {{site.data.keyword.mobilepushshort}} 서비스에 바인드했는지 확인하십시오. - - -###{{site.data.keyword.mobilepushshort}}에 토큰 전달 -{: pass-token-push-notifications} - -APNs에서 토큰이 수신되면 `registerWithDeviceToken` 메소드의 일부로 {{site.data.keyword.mobilepushshort}}에 토큰을 전달하십시오. - -APNs에서 토큰이 수신되면 이 토큰을 `didRegisterForRemoteNotificationsWithDeviceToken` 메소드의 일부로 푸시 알림에 전달하십시오. - -``` -func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ - let push = BMSPushClient.sharedInstance - push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - } -``` - {: codeblock} - - -## iOS 디바이스에서 푸시 알림 수신 -{: #enable-push-ios-notifications-receiving} - - -iOS 디바이스에서 푸시 알림을 수신하려면 애플리케이션의 위임자에 다음 Swift 메소드를 추가하십시오. - -``` -// For Swift -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) -{ //UserInfo dictionary will contain data sent from the server } -``` - {: codeblock} - -## iOS 디바이스에서 푸시 알림 모니터링 -{: ios-monitoring} - -알림의 현재 상태를 모니터하려면 다음 Swift 메소드를 애플리케이션의 애플리케이션 위임자에 추가하십시오. - -``` - // Send notification status when app is opened by clicking the notifications -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - print("Send message status to the Push server") - } -} -``` - {: codeblock} - -``` - // Send notification status when the app is in background mode. -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { - let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) - self.showAlert(title: "Recieved Push notifications", message: payLoad) - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - completionHandler(UIBackgroundFetchResult.newData) - } -} -``` - {: codeblock} - - -## 기본 푸시 알림 전송 -{: #send} - -애플리케이션을 개발한 후에는 기본 푸시 알림을 전송할 수 있습니다. - -기본 푸시 알림을 전송하려면 다음 단계를 완료하십시오. - -1. **알림 전송**을 선택하고 **받는 사람** 옵션을 선택하여 메시지를 작성하십시오. 지원되는 옵션은 **태그별 디바이스**, **디바이스 ID**, **사용자 ID**, **Android 디바이스**, **iOS 디바이스**, **웹 알림** 및 **모든 디바이스**입니다. - -**참고**: **모든 디바이스** 옵션을 선택하는 경우 {{site.data.keyword.mobilepushshort}}를 구독하는 모든 디바이스가 알림을 수신합니다. -![알림 화면](images/tag_notification.jpg) - -2. **메시지** 필드에 메시지를 작성하십시오. 필요에 따라 선택적 옵션을 구성하도록 선택하십시오. -3. **전송**을 클릭하십시오. -3. 디바이스가 알림을 수신했는지 확인하십시오. - -다음 이미지는 iOS 디바이스에서 {{site.data.keyword.mobilepushshort}}를 처리하는 경보 상자를 표시합니다. - -![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) - -### 알림 전송을 위한 선택적 설정 -{: #send_ios_otpional_setting} - -iOS 디바이스에 알림을 전송하기 위해 {{site.data.keyword.mobilepushshort}} 설정을 추가로 사용자 정의할 수 있습니다. 다음과 같은 선택적 사용자 정의 옵션이 지원됩니다. - -- **배지**: 애플리케이션 배지에 표시되는 숫자를 나타냅니다. 기본값은 영(0)이며, 이 값은 배지를 표시하지 않습니다. -- **사운드**: 알림을 수신할 때 재생되는 사운드 클립을 표시합니다. 기본값 또는 앱에 번들링된 사운드 리소스의 이름을 지원합니다. -- **추가 페이로드**: 알림에 대한 사용자 정의 페이로드 값을 지정합니다. - -##대화식 알림 사용 - -대화식 알림을 설정하여 이미지, 맵 또는 응답 단추 추가와 같은 추가 세부사항으로 iOS 알림을 보강할 수 있습니다. 이를 통해 현재 컨텍스트를 종료하지 않고도 즉시 조치를 수행할 수 있는 기능과 추가 컨텍스트를 제공할 수 있습니다. - -대화식 알림을 설정하려면 다음 코드를 사용하십시오. - -``` - // This defines the button action. -let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) -``` - {: codeblock} -``` - // This defines category for the buttons -let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) -``` - {: codeblock} -``` - // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions -let notificationOptions = BMSPushClientOptions(categoryName: [category]) -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) -``` - {: codeblock} - -대화식 알림을 보내려면 다음 단계를 완료하십시오. - -1. 작성 섹션의 받는 사람 드롭 다운 목록에서 **iOS 디바이스**를 선택합니다. -2. 보내려는 알림 메시지를 입력합니다. -3. 선택적 설정 섹션에서 **모바일**을 선택하고 **iOS**를 클릭합니다. -4. 유형 드롭 다운 목록에서 **혼합**을 선택합니다. -5. 카테고리 필드에서 앱에서 정의한 알림 유형을 지정합니다. - -![iOS용 대화식 알림](images/push_ios_notification_interactive.jpg) - -## 다음 단계 -{: #next_steps_tags} - -정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. - -이러한 푸시 알림 서비스 기능을 앱에 추가하십시오. -태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. -고급 알림 옵션을 사용하려면 [고급 푸시 알림 사용](t_advance_badge_sound_payload.html)을 참조하십시오. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +#{{site.data.keyword.mobilepushshort}}를 전송하도록 iOS 애플리케이션 설정 +{: #enable-push-ios-notifications} +마지막 업데이트 날짜: 2017년 2월 14일 +{: .last-updated} + +iOS 애플리케이션이 {{site.data.keyword.mobilepushshort}}를 사용자 디바이스에 전송하도록 설정할 수 있습니다. + + +##CocoaPods 설치 +{: #enable-push-ios-notifications-install} + +기존 Xcode 프로젝트의 경우 CocoaPods 종속 항목 관리 도구를 사용하여 Bluemix Mobile Services Client SDK를 설정할 수 있습니다. 또는 SDK를 수동으로 설치할 수 있습니다. + +Swift 푸시 Readme 파일을 보려면 [Readme ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}으로 이동하십시오. + + + +1. Mac 터미널에서 다음 명령을 사용하여 CocoaPods를 설치하십시오. +```$ sudo gem install cocoapods +``` + {: codeblock} +2. 터미널에 `pod init` 명령을 입력하여 CocoaPods를 초기화하십시오. Xcode 프로젝트가 있는 디렉토리에서 명령을 실행하십시오. `pod init` 명령에서 Podfile을 작성합니다. +3. 생성된 Podfile에 필요한 SDK 종속 항목을 추가하십시오. 다음 Podfile을 복사하십시오. + + ``` + source 'https://github.com/CocoaPods/Specs.git' + //Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + pod 'BMSAnalyticsAPI' end + ``` + {: codeblock} + +3. 터미널에서 프로젝트 폴더로 이동한 후 `pod update` 명령을 사용하여 종속 항목을 설치하십시오. + +이 명령은 종속 항목을 설치하고 새 Xcode 작업공간을 작성합니다. +**참고**: 원래 Xcode 프로젝트 파일 대신, 반드시 항상 새 Xcode 작업공간을 여십시오. +``` +$ open App.xcworkspace + ``` + {: codeblock} + +작업공간에는 원래 프로젝트 및 종속 항목이 포함된 Pods 프로젝트가 있습니다. Bluemix Mobile Services 소스 폴더를 수정하려는 경우 Pods 프로젝트의 `Pods/yourImportedSourceFolder`에서 이 폴더를 찾을 수 있습니다(예: `Pods/BMSPush`). + +## Carthage를 사용하여 프레임워크 추가 +{: #carthage} + +[Carthage ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}을 사용하여 프로젝트에 프레임워크를 추가하십시오. Xcode8의 Carthage는 지원되지 않습니다. + +1. `BMSPush` 프레임워크를 Cartfile에 추가하십시오. +``` +github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" +``` + {: codeblock} +2. `carthage update` 명령을 실행하십시오. 빌드가 완료되면 `BMSPush.framework`, `BMSCore.framework`, `BMSAnalyticsAPI.framework`를 Xcode 프로젝트로 끌어오십시오. +3. [Carthage ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} 사이트의 지시사항에 따라 통합을 완료하십시오. + +## iOS SDK 설정 +{: ios-sdk} + +iOS SDK를 설치하고 다음 코드를 애플리케이션의 **AppDelegate.swift** 파일에 추가하십시오. 이 코드도 APNs에 등록됩니다. +``` +func application(_ application: UIApplication, +didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool + { + BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") + } +``` + {: codeblock} + +## 가져온 프레임워크 및 소스 폴더 사용 +{: using-imported-frameworks} + +코드에서 SDK를 참조하십시오. 다음 전제조건이 충족되는지 확인하십시오. + +- iOS 8.0 이상 +- Xcode 7 + +관련 헤더에 대해 `#import` 지시문을 작성합니다. 예: +``` +//swift +import BMSCore +import BMSPush +``` + {: codeblock} + +Swift 푸시 Readme 파일을 읽어보려면 [Readme ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}을 참조하십시오. + +**참고**: CocoaPods 명령 `pod install` 또는 `pod update`를 사용하여 Pods 프로젝트를 업데이트하면 Bluemix Mobile Services 소스 폴더를 대체할 수 있습니다. 원래 파일의 사용자 정의한 버전을 유지하려면, 이러한 명령을 실행하기 전에 해당 버전을 백업해야 합니다. + + +## 빌드 설정 +{: build-settings} + +**Xcode > 빌드 설정 > 빌드 옵션 및 Bitcode 사용 설정**으로 이동하여 **No**로 설정하십시오. + +**주의**: iOS 9의 경우, ATS(App Transport Security) 기능을 변경하면 인증 프로세스의 처리 방식에 영향이 미칠 수 있습니다. 다음 블로그 게시물에서 변경사항에 대한 자세한 정보를 설명합니다. [ATS and Bitcode in iOS 9 ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} 및 [Connect your iOS 9 app to Bluemix today ![외부 링크 아이콘](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. + +## iOS 앱을 위한 푸시 SDK 초기화 +{: #enable-push-ios-notifications-initialize} + +초기화 코드를 배치하는 공통 위치는 iOS 애플리케이션에 대한 애플리케이션 위임자입니다. 푸시 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 GUID를 가져오십시오. + +### Core SDK 초기화 +{: Initializing-the-core-sdk} + + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance +myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") +``` + {: codeblock} + +### 라우트, GUID 및 Bluemix 지역 +{: route-guid-bluemix-region} + +#### appRoute +{: ios-approute} + +Bluemix에서 생성한 서버 애플리케이션에 지정된 라우트를 지정합니다. + +#### GUID +{: ios-guid} + +Bluemix에서 생성한 애플리케이션에 지정된 고유 키를 지정합니다. 이 값은 대소문자를 구분합니다. + +#### bluemixRegionSuffix +{: ios-bluemixRegionSuffix} + +앱이 호스트된 위치를 지정합니다. `bluemixRegion` 매개변수는 사용 중인 Bluemix 배치를 지정합니다. 이 값을 `BMSClient.REGION` 정적 특성으로 설정하고 세 값 중 하나를 사용할 수 있습니다. + +- BMSClient.Region.usSouth +- BMSClient.Region.unitedKingdom +- BMSClient.Region.sydney + +#### AppGUID +{: ios-AppGUID} + +Bluemix에서 작성한 {{site.data.keyword.mobilepushshort}} 서비스에 지정되는 고유 AppGUID 키를 지정합니다. + +### 클라이언트 푸시 SDK 초기화 +{: initializing-the-client-Push-SDK} + +``` + //Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +## iOS 애플리케이션 및 디바이스 등록 +{: #enable-push-ios-notifications-register} + + +디바이스에 애플리케이션을 설치한 후 원격 알림을 수신하려면 애플리케이션을 APNs에 등록해야 합니다. APNs에서 생성한 디바이스 토큰을 앱에서 수신한 후에는 {{site.data.keyword.mobilepushshort}} 서비스에 이를 되돌려 보내야 합니다. + +iOS 애플리케이션과 디바이스를 등록하려면 다음을 수행해야 합니다. + +1. 백엔드 애플리케이션을 작성하십시오. +2. 토큰을 {{site.data.keyword.mobilepushshort}}에 전달하십시오. + + +### 백엔드 애플리케이션 작성 +{: create-a-backend-app} + +표준 유형 섹션 Bluemix® 카탈로그에서 {{site.data.keyword.mobilepushshort}} 서비스를 이 애플리케이션에 자동으로 바인드하는 백엔드 애플리케이션을 작성하십시오. 백엔드 앱을 이미 작성한 경우에는 앱을 {{site.data.keyword.mobilepushshort}} 서비스에 바인드했는지 확인하십시오. + + +### {{site.data.keyword.mobilepushshort}}에 토큰 전달 +{: pass-token-push-notifications} + +APNs에서 토큰이 수신되면 `registerWithDeviceToken` 메소드의 일부로 {{site.data.keyword.mobilepushshort}}에 토큰을 전달하십시오. + +APNs에서 토큰이 수신되면 이 토큰을 `didRegisterForRemoteNotificationsWithDeviceToken` 메소드의 일부로 푸시 알림에 전달하십시오. + +``` +func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ + let push = BMSPushClient.sharedInstance + push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + } +``` + {: codeblock} + + +## iOS 디바이스에서 푸시 알림 수신 +{: #enable-push-ios-notifications-receiving} + + +iOS 디바이스에서 푸시 알림을 수신하려면 애플리케이션의 위임자에 다음 Swift 메소드를 추가하십시오. + +``` +// For Swift +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) +{ //UserInfo dictionary will contain data sent from the server } +``` + {: codeblock} + +## iOS 디바이스에서 푸시 알림 모니터링 +{: ios-monitoring} + +알림의 현재 상태를 모니터하려면 다음 Swift 메소드를 애플리케이션의 애플리케이션 위임자에 추가하십시오. + +``` + // Send notification status when app is opened by clicking the notifications +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + print("Send message status to the Push server") + } +} +``` + {: codeblock} + +``` + // Send notification status when the app is in background mode. +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { + let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) + self.showAlert(title: "Recieved Push notifications", message: payLoad) + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + completionHandler(UIBackgroundFetchResult.newData) + } +} +``` + {: codeblock} + + +## 기본 푸시 알림 전송 +{: #send} + +애플리케이션을 개발한 후에는 기본 푸시 알림을 전송할 수 있습니다. + +기본 푸시 알림을 전송하려면 다음 단계를 완료하십시오. + +1. **알림 전송**을 선택하고 **받는 사람** 옵션을 선택하여 메시지를 작성하십시오. 지원되는 옵션은 **태그별 디바이스**, **디바이스 ID**, **사용자 ID**, **Android 디바이스**, **iOS 디바이스**, **웹 알림** 및 **모든 디바이스**입니다. + +**참고**: **모든 디바이스** 옵션을 선택하는 경우 {{site.data.keyword.mobilepushshort}}를 구독하는 모든 디바이스가 알림을 수신합니다. +![알림 화면](images/tag_notification.jpg) + +2. **메시지** 필드에 메시지를 작성하십시오. 필요에 따라 선택적 옵션을 구성하도록 선택하십시오. +3. **전송**을 클릭하십시오. +3. 디바이스가 알림을 수신했는지 확인하십시오. + +다음 이미지는 iOS 디바이스에서 {{site.data.keyword.mobilepushshort}}를 처리하는 경보 상자를 표시합니다. + +![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) + +### 알림 전송을 위한 선택적 설정 +{: #send_ios_otpional_setting} + +iOS 디바이스에 알림을 전송하기 위해 {{site.data.keyword.mobilepushshort}} 설정을 추가로 사용자 정의할 수 있습니다. 다음과 같은 선택적 사용자 정의 옵션이 지원됩니다. + +- **배지**: 애플리케이션 배지에 표시되는 숫자를 나타냅니다. 기본값은 영(0)이며, 이 값은 배지를 표시하지 않습니다. +- **사운드**: 알림을 수신할 때 재생되는 사운드 클립을 표시합니다. 기본값 또는 앱에 번들링된 사운드 리소스의 이름을 지원합니다. +- **추가 페이로드**: 알림에 대한 사용자 정의 페이로드 값을 지정합니다. + +## 대화식 알림 사용 + +대화식 알림을 설정하여 이미지, 맵 또는 응답 단추 추가와 같은 추가 세부사항으로 iOS 알림을 보강할 수 있습니다. 이를 통해 현재 컨텍스트를 종료하지 않고도 즉시 조치를 수행할 수 있는 기능과 추가 컨텍스트를 제공할 수 있습니다. + +대화식 알림을 설정하려면 다음 코드를 사용하십시오. + +``` + // This defines the button action. +let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) +``` + {: codeblock} +``` + // This defines category for the buttons +let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) +``` + {: codeblock} +``` + // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions +let notificationOptions = BMSPushClientOptions(categoryName: [category]) +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) +``` + {: codeblock} + +대화식 알림을 보내려면 다음 단계를 완료하십시오. + +1. 작성 섹션의 받는 사람 드롭 다운 목록에서 **iOS 디바이스**를 선택합니다. +2. 보내려는 알림 메시지를 입력합니다. +3. 선택적 설정 섹션에서 **모바일**을 선택하고 **iOS**를 클릭합니다. +4. 유형 드롭 다운 목록에서 **혼합**을 선택합니다. +5. 카테고리 필드에서 앱에서 정의한 알림 유형을 지정합니다. + +![iOS용 대화식 알림](images/push_ios_notification_interactive.jpg) + +## 다음 단계 +{: #next_steps_tags} + +정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. + +이러한 푸시 알림 서비스 기능을 앱에 추가하십시오. +태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. +고급 알림 옵션을 사용하려면 [고급 푸시 알림 사용](t_advance_badge_sound_payload.html)을 참조하십시오. diff --git a/services/mobilepush/nl/ko/c_overview_push.md b/services/mobilepush/nl/ko/c_overview_push.md index a090d026f..8fb08533e 100644 --- a/services/mobilepush/nl/ko/c_overview_push.md +++ b/services/mobilepush/nl/ko/c_overview_push.md @@ -1,128 +1,128 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}} 정보 -{: #overview-push} -마지막 업데이트 날짜: 2017년 1월 18일 -{: .last-updated} - -IBM {{site.data.keyword.mobilepushshort}}는 디바이스와 플랫폼에 알림을 보내는 데 사용할 수 있는 서비스입니다. 알림은 모든 애플리케이션 사용자와 태그를 사용하는 특정 디바이스 및 사용자 세트를 대상으로 할 수 있습니다. 디바이스, 태그 및 구독을 관리할 수 있습니다. - -다음 옵션을 사용하여 바인드 또는 바인드 해제된 서비스를 작성할 수 있습니다. - -- 카탈로그에서 MobileFirst Services Starter 표준 유형을 사용하여 Bluemix 애플리케이션을 작성하여 수행합니다. 그러면 Bluemix 백엔드 애플리케이션에 바인드된 푸시 알림 서비스가 작성됩니다. -- 모바일 카탈로그에서 직접 바인드 해제된 푸시 알림 서비스를 작성하여 수행합니다. 나중에 애플리케이션에 바인드할 수 있습니다. 또는 바인드 해제하는 데 사용하도록 선택할 수도 있습니다. -- [모바일 대시보드 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}을 사용하여 수행합니다. - -{{site.data.keyword.mobilepushshort}} 모니터링 탭에는 분석 데이터가 표시되지 않습니다. - -이제 {{site.data.keyword.mobilepushshort}} 서비스에서 OpenWhisk를 사용할 수 있습니다. 자세한 정보는 [OpenWhisk](/docs/openwhisk/index.html)를 참조하십시오. - - -## {{site.data.keyword.mobilepushshort}} 서비스 프로세스 -{: #overview_push_process} - -모바일, 웹 브라우저 클라이언트, Google Chrome 앱과 확장 프로그램은 {{site.data.keyword.mobilepushshort}} 서비스를 구독하고 이 서비스에 등록할 수 있습니다. 시작 시 클라이언트 애플리케이션은 {{site.data.keyword.mobilepushshort}} 서비스에 등록하고 구독을 신청합니다. 알림은 APNs(Apple Push Notification Service) 또는 FCM(Firebase Cloud Messaging)/GCM(Google Cloud Messaging) 서버로 디스패치된 후 등록된 모바일 또는 브라우저 클라이언트에 전송됩니다. - -![푸시 개요](images/overview.jpg) - - -###모바일 및 브라우저 애플리케이션 -{: mobile-applications} - -시작 시 클라이언트 애플리케이션은 알림을 수신하도록 {{site.data.keyword.mobilepushshort}} 서비스에 등록하고 구독을 신청합니다. - -###백엔드 애플리케이션 -{: backend-applications} - -백엔드 애플리케이션은 온프레미스 또는 퍼블릭 클라우드에 있습니다. 백엔드 애플리케이션은 {{site.data.keyword.mobilepushshort}} 서비스를 사용하여 컨텍스트 알림을 모바일 및 브라우저 애플리케이션 사용자에게 전송합니다. 백엔드 애플리케이션은 푸시 알림을 전송하기 위해 모바일 디바이스, 브라우저 에이전트 및 사용자 정보를 유지보수하고 관리할 필요가 없습니다. 대신 백엔드 애플리케이션에서는 이들을 관리하고 유지보수하는 {{site.data.keyword.mobilepushshort}} 서비스를 사용할 수 있습니다. - -###앱 백엔드 소유자 -{: app-backend-owner} - -앱 백엔드 소유자는 {{site.data.keyword.mobilepushshort}} 서비스의 인스턴스를 번들로 제공하는 모바일 백엔드 애플리케이션을 작성합니다. 앱 백엔드 소유자는 또한 {{site.data.keyword.mobilepushshort}}의 대상인 모바일 및 브라우저 애플리케이션과 함께 {{site.data.keyword.mobilepushshort}} 서비스를 사용하는 백엔드 애플리케이션에 적합하도록 이 서비스를 구성하고 설정합니다. - -###{{site.data.keyword.mobilepushshort}} 서비스 -{: push-notification-service} - -{{site.data.keyword.mobilepushshort}} 서비스는 알림을 수신하기 위해 등록한 모바일 디바이스 및 웹 브라우저 클라이언트와 관련된 모든 정보를 관리합니다. 이 서비스는 이기종 모바일 및 웹 브라우저 플랫폼에 알림을 보내는 기술 세부사항을 애플리케이션에 적용할 수 있도록 알려주고 이 모든 사항을 내부에서 처리합니다. - -###게이트웨이 -{: gateways} - -IBM {{site.data.keyword.mobilepushshort}} 서비스에서 모바일 애플리케이션과 브라우저 애플리케이션에 알림을 디스패치하는 데 사용하는 플랫폼별 푸시 알림 클라우드 서비스(예: FCM/GCM 또는 APNs(Apple Push Notification Service))입니다. - -###푸시 보안 -{: push-security} - -{{site.data.keyword.mobilepushshort}} API는 다음 두 유형의 시크릿으로 보호됩니다. - -- **appSecret**: 'appSecret'은 일반적으로 백엔드 애플리케이션에서 호출하는 API(예: {{site.data.keyword.mobilepushshort}}를 보내는 API와 설정을 구성하는 API)를 보호합니다. -- **clientSecret**: 'clientSecret'은 일반적으로 모바일 클라이언트 애플리케이션에서 호출하는 API를 보호합니다. 이 'clientSecret'이 필요한 연관된 사용자 ID를 사용한 디바이스의 등록과 관련된 API는 하나뿐입니다. 모바일 클라이언트에서 호출된 기타 API에는 clientSecret이 필요하지 않습니다. - -'appSecret'과 'clientSecret'은 {{site.data.keyword.mobilepushshort}} 서비스와 애플리케이션을 바인드할 때 모든 서비스 인스턴스에 할당됩니다. 시크릿을 전달하는 방법과 전달 대상 API에 대한 정보는 [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/) 문서를 참조하십시오. - -**참고**: 이전 애플리케이션에서는 사용자 ID 필드에서 디바이스를 등록하거나 업데이트하는 경우에만 clientSecret을 전달해야 했습니다. 모바일 클라이언트와 브라우저 클라이언트에서 호출한 기타 모든 API에는 clientSecret이 필요하지 않았습니다. 이와 같은 이전 애플리케이션에서 디바이스 등록 또는 호출 업데이트에 선택적으로 clientSecret을 계속 사용할 수 있습니다. 그러나 모든 클라이언트 API 호출에 clientSecret 검사를 적용하는 것이 좋습니다. 이를 기존 애플리케이션에 적용할 수 있도록 새 'verifyClientSecret' API가 공개되었습니다. 새 애플리케이션의 경우 모든 클라이언트 API 호출에 clientSecret 검사가 적용되며 'verfiyClientSecret' API로 이 동작을 변경할 수 없습니다. - -기본적으로 클라이언트 시크릿 확인은 새 앱에서만 적용됩니다. 기존 앱과 새 앱 모두 verifyClientSecret REST API를 사용하여 클라이언트 시크릿 확인을 사용 또는 사용 안함으로 설정할 수 있습니다. applicationId와 deviceId를 아는 사용자에게 디바이스가 노출되지 않도록 클라이언트 시크릿 확인을 적용하는 것이 좋습니다. - -'clientSecret'을 기밀로 유지하고 모바일 앱으로 하드코딩하지 마십시오. 애플리케이션 런타임 중에 동적으로 'clientSecret'에 가져오는 데 사용할 수 있는 여러 애플리케이션 초기화 패턴이 있습니다. 시퀀스 다이어그램에서 이와 같은 가능한 패턴을 간략히 보여줍니다. -![Enable_Push](images/init_client_secret.jpg) - -## {{site.data.keyword.mobilepushshort}} 유형 -{: #overview-push-types} - -###브로드캐스트 -{: broadcast} - -클라이언트 애플리케이션이 {{site.data.keyword.mobilepushshort}} 서비스에 등록되면 브로드캐스트를 수신할 수 있습니다. 브로드캐스트 알림은 모바일 디바이스, 브라우저에 설치되거나 Chrome 앱 또는 확장 프로그램 인스턴스로 구현되고 {{site.data.keyword.mobilepushshort}} 서비스를 사용할 수 있도록 구성된 애플리케이션의 모든 인스턴스를 대상으로 전송되는 메시지입니다. 브로드캐스트 알림은 {{site.data.keyword.mobilepushshort}}가 사용으로 설정된 애플리케이션에서 기본적으로 사용됩니다. {{site.data.keyword.mobilepushshort}} 서비스가 사용 가능하도록 설정된 애플리케이션에는 Push.ALL 태그에 대한 구독이 사전 정의되어 있으며 서버에서 이 태그를 사용하여 알림 메시지를 모든 디바이스에 브로드캐스트합니다. REST Push API를 사용하는 브로드캐스트 알림을 전송하려면 메시지 리소스에 게시할 때 "대상"은 빈 JSON 파일이어야 합니다. - -###태그 기반 알림 -{: tag-based-notifications} - -태그 알림은 특정 태그를 구독하는 모든 디바이스를 대상으로 하는 메시지입니다. 태그 기반 알림을 사용하면 제목 영역 또는 주제를 기반으로 알림을 구분할 수 있습니다. 알림 수신인은 관심있는 제목 또는 주제에 대한 알림일 경우에만 알림을 수신하도록 선택할 수 있습니다. 따라서 태그 기반 알림은 수신인을 구분할 수 있는 수단을 제공합니다. 이 기능을 사용하면 태그를 정의한 다음 태그별로 메시지를 전송 및 수신할 수 있는 기능을 사용할 수 있습니다. 태그를 구독하는 클라이언트 애플리케이션 인스턴스(모바일, 브라우저에 있거나 앱 또는 확장 프로그램으로서의 인스턴스)만 메시지의 대상입니다. 먼저 애플리케이션의 태그를 작성하고 태그 구독을 설정한 후 태그 기반 알림을 시작해야 합니다. REST API를 사용하는 태그 기반 알림을 전송하려면 메시지 자원에 게시할 때 "tagNames"가 제공되는지 확인하십시오. - -###유니캐스트 알림 -{: unicast-notifications} - -유니캐스트 알림은 특정 디바이스 또는 사용자를 대상으로 하는 메시지입니다. 디바이스를 대상으로 하는 유니캐스트 알림에는 추가 설정이 필요하지 않으며 애플리케이션에서 {{site.data.keyword.mobilepushshort}}를 사용하는 경우 기본적으로 유니캐스트 알림이 사용됩니다. - -그러나 사용자를 대상으로 하는 유니캐스트 알림에서는 {{site.data.keyword.mobilepushshort}}를 수신하도록 클라이언트 모바일 디바이스나 웹 브라우저 또는 Chrome 앱과 확장 프로그램을 등록할 때 사용자 ID와 디바이스를 연관시켜야 합니다. - -일반적으로 클라이언트 애플리케이션은 제일 먼저 인증 주기를 실행하며 여기서 모바일 앱 사용자가 인증 서비스(예: [Mobile Client Access](docs/services/mobileaccess/index.html))에 대해 인증됩니다. 인증에 성공하면 인증된 사용자 ID가 푸시 디바이스 등록 API에 전달됩니다. -REST API를 통해 유니캐스트 알림을 전송하려면 메시지 자원에 게시할 때 deviceIds 또는 userIds가 제공되는지 확인하십시오. - -###플랫폼 기반 알림 -{: platform-based-notifications} - -특정 디바이스 플랫폼에 도달하도록 알림의 대상을 설정할 수 있습니다. 예를 들어, 모든 Android 사용자 또는 Google Chrome 사용자에게만 알림을 전송할 수 있습니다. REST API를 사용하는 플랫폼 기반 알림을 전송하려면 메시지 리소스에 게시할 때 대상 플랫폼이 제공되는지 확인하십시오. 플랫폼을 어레이로 지정하십시오. 지원되는 플랫폼은 다음과 같습니다. -* A(Apple) -* G(Google) -* WEB_CHROME(Google Chrome 브라우저 웹 푸시) -* WEB_FIREFOX(Mozilla Firefox 브라우저 웹 푸시) -* WEB_SAFARI(Safari 브라우저 웹 푸시) -* APPEXT_CHROME(Google Chrome 앱 및 확장 프로그램) - -## {{site.data.keyword.mobilepushshort}} 메시지 크기 -{: #push-message-size} - -{{site.data.keyword.mobilepushshort}} 메시지 페이로드 크기는 게이트웨이(FCM/GCM, APNs)와 클라이언트 플랫폼의 제한조건에 따라 다릅니다. - -### iOS 및 Safari -{: ios-message-size} - -iOS 8 이상의 경우 허용된 최대 크기는 2KB입니다. Apple 푸시 알림 서비스는 이 한계를 초과하는 알림을 전송하지 않습니다. - -###Android, Firefox 브라우저, Chrome 브라우저, Chrome 앱 및 확장기능 -{: android-message-size} - -허용되는 최대 메시지 페이로드 크기는 4KB입니다. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}} 정보 +{: #overview-push} +마지막 업데이트 날짜: 2017년 1월 18일 +{: .last-updated} + +IBM {{site.data.keyword.mobilepushshort}}는 디바이스와 플랫폼에 알림을 보내는 데 사용할 수 있는 서비스입니다. 알림은 모든 애플리케이션 사용자와 태그를 사용하는 특정 디바이스 및 사용자 세트를 대상으로 할 수 있습니다. 디바이스, 태그 및 구독을 관리할 수 있습니다. + +다음 옵션을 사용하여 바인드 또는 바인드 해제된 서비스를 작성할 수 있습니다. + +- 카탈로그에서 MobileFirst Services Starter 표준 유형을 사용하여 Bluemix 애플리케이션을 작성하여 수행합니다. 그러면 Bluemix 백엔드 애플리케이션에 바인드된 푸시 알림 서비스가 작성됩니다. +- 모바일 카탈로그에서 직접 바인드 해제된 푸시 알림 서비스를 작성하여 수행합니다. 나중에 애플리케이션에 바인드할 수 있습니다. 또는 바인드 해제하는 데 사용하도록 선택할 수도 있습니다. +- [모바일 대시보드 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}을 사용하여 수행합니다. + +{{site.data.keyword.mobilepushshort}} 모니터링 탭에는 분석 데이터가 표시되지 않습니다. + +이제 {{site.data.keyword.mobilepushshort}} 서비스에서 OpenWhisk를 사용할 수 있습니다. 자세한 정보는 [OpenWhisk](/docs/openwhisk/index.html)를 참조하십시오. + + +## {{site.data.keyword.mobilepushshort}} 서비스 프로세스 +{: #overview_push_process} + +모바일, 웹 브라우저 클라이언트, Google Chrome 앱과 확장 프로그램은 {{site.data.keyword.mobilepushshort}} 서비스를 구독하고 이 서비스에 등록할 수 있습니다. 시작 시 클라이언트 애플리케이션은 {{site.data.keyword.mobilepushshort}} 서비스에 등록하고 구독을 신청합니다. 알림은 APNs(Apple Push Notification Service) 또는 FCM(Firebase Cloud Messaging)/GCM(Google Cloud Messaging) 서버로 디스패치된 후 등록된 모바일 또는 브라우저 클라이언트에 전송됩니다. + +![푸시 개요](images/overview.jpg) + + +### 모바일 및 브라우저 애플리케이션 +{: mobile-applications} + +시작 시 클라이언트 애플리케이션은 알림을 수신하도록 {{site.data.keyword.mobilepushshort}} 서비스에 등록하고 구독을 신청합니다. + +### 백엔드 애플리케이션 +{: backend-applications} + +백엔드 애플리케이션은 온프레미스 또는 퍼블릭 클라우드에 있습니다. 백엔드 애플리케이션은 {{site.data.keyword.mobilepushshort}} 서비스를 사용하여 컨텍스트 알림을 모바일 및 브라우저 애플리케이션 사용자에게 전송합니다. 백엔드 애플리케이션은 푸시 알림을 전송하기 위해 모바일 디바이스, 브라우저 에이전트 및 사용자 정보를 유지보수하고 관리할 필요가 없습니다. 대신 백엔드 애플리케이션에서는 이들을 관리하고 유지보수하는 {{site.data.keyword.mobilepushshort}} 서비스를 사용할 수 있습니다. + +### 앱 백엔드 소유자 +{: app-backend-owner} + +앱 백엔드 소유자는 {{site.data.keyword.mobilepushshort}} 서비스의 인스턴스를 번들로 제공하는 모바일 백엔드 애플리케이션을 작성합니다. 앱 백엔드 소유자는 또한 {{site.data.keyword.mobilepushshort}}의 대상인 모바일 및 브라우저 애플리케이션과 함께 {{site.data.keyword.mobilepushshort}} 서비스를 사용하는 백엔드 애플리케이션에 적합하도록 이 서비스를 구성하고 설정합니다. + +### {{site.data.keyword.mobilepushshort}} 서비스 +{: push-notification-service} + +{{site.data.keyword.mobilepushshort}} 서비스는 알림을 수신하기 위해 등록한 모바일 디바이스 및 웹 브라우저 클라이언트와 관련된 모든 정보를 관리합니다. 이 서비스는 이기종 모바일 및 웹 브라우저 플랫폼에 알림을 보내는 기술 세부사항을 애플리케이션에 적용할 수 있도록 알려주고 이 모든 사항을 내부에서 처리합니다. + +### 게이트웨이 +{: gateways} + +IBM {{site.data.keyword.mobilepushshort}} 서비스에서 모바일 애플리케이션과 브라우저 애플리케이션에 알림을 디스패치하는 데 사용하는 플랫폼별 푸시 알림 클라우드 서비스(예: FCM/GCM 또는 APNs(Apple Push Notification Service))입니다. + +### 푸시 보안 +{: push-security} + +{{site.data.keyword.mobilepushshort}} API는 다음 두 유형의 시크릿으로 보호됩니다. + +- **appSecret**: 'appSecret'은 일반적으로 백엔드 애플리케이션에서 호출하는 API(예: {{site.data.keyword.mobilepushshort}}를 보내는 API와 설정을 구성하는 API)를 보호합니다. +- **clientSecret**: 'clientSecret'은 일반적으로 모바일 클라이언트 애플리케이션에서 호출하는 API를 보호합니다. 이 'clientSecret'이 필요한 연관된 사용자 ID를 사용한 디바이스의 등록과 관련된 API는 하나뿐입니다. 모바일 클라이언트에서 호출된 기타 API에는 clientSecret이 필요하지 않습니다. + +'appSecret'과 'clientSecret'은 {{site.data.keyword.mobilepushshort}} 서비스와 애플리케이션을 바인드할 때 모든 서비스 인스턴스에 할당됩니다. 시크릿을 전달하는 방법과 전달 대상 API에 대한 정보는 [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/) 문서를 참조하십시오. + +**참고**: 이전 애플리케이션에서는 사용자 ID 필드에서 디바이스를 등록하거나 업데이트하는 경우에만 clientSecret을 전달해야 했습니다. 모바일 클라이언트와 브라우저 클라이언트에서 호출한 기타 모든 API에는 clientSecret이 필요하지 않았습니다. 이와 같은 이전 애플리케이션에서 디바이스 등록 또는 호출 업데이트에 선택적으로 clientSecret을 계속 사용할 수 있습니다. 그러나 모든 클라이언트 API 호출에 clientSecret 검사를 적용하는 것이 좋습니다. 이를 기존 애플리케이션에 적용할 수 있도록 새 'verifyClientSecret' API가 공개되었습니다. 새 애플리케이션의 경우 모든 클라이언트 API 호출에 clientSecret 검사가 적용되며 'verfiyClientSecret' API로 이 동작을 변경할 수 없습니다. + +기본적으로 클라이언트 시크릿 확인은 새 앱에서만 적용됩니다. 기존 앱과 새 앱 모두 verifyClientSecret REST API를 사용하여 클라이언트 시크릿 확인을 사용 또는 사용 안함으로 설정할 수 있습니다. applicationId와 deviceId를 아는 사용자에게 디바이스가 노출되지 않도록 클라이언트 시크릿 확인을 적용하는 것이 좋습니다. + +'clientSecret'을 기밀로 유지하고 모바일 앱으로 하드코딩하지 마십시오. 애플리케이션 런타임 중에 동적으로 'clientSecret'에 가져오는 데 사용할 수 있는 여러 애플리케이션 초기화 패턴이 있습니다. 시퀀스 다이어그램에서 이와 같은 가능한 패턴을 간략히 보여줍니다. +![Enable_Push](images/init_client_secret.jpg) + +## {{site.data.keyword.mobilepushshort}} 유형 +{: #overview-push-types} + +### 브로드캐스트 +{: broadcast} + +클라이언트 애플리케이션이 {{site.data.keyword.mobilepushshort}} 서비스에 등록되면 브로드캐스트를 수신할 수 있습니다. 브로드캐스트 알림은 모바일 디바이스, 브라우저에 설치되거나 Chrome 앱 또는 확장 프로그램 인스턴스로 구현되고 {{site.data.keyword.mobilepushshort}} 서비스를 사용할 수 있도록 구성된 애플리케이션의 모든 인스턴스를 대상으로 전송되는 메시지입니다. 브로드캐스트 알림은 {{site.data.keyword.mobilepushshort}}가 사용으로 설정된 애플리케이션에서 기본적으로 사용됩니다. {{site.data.keyword.mobilepushshort}} 서비스가 사용 가능하도록 설정된 애플리케이션에는 Push.ALL 태그에 대한 구독이 사전 정의되어 있으며 서버에서 이 태그를 사용하여 알림 메시지를 모든 디바이스에 브로드캐스트합니다. REST Push API를 사용하는 브로드캐스트 알림을 전송하려면 메시지 리소스에 게시할 때 "대상"은 빈 JSON 파일이어야 합니다. + +### 태그 기반 알림 +{: tag-based-notifications} + +태그 알림은 특정 태그를 구독하는 모든 디바이스를 대상으로 하는 메시지입니다. 태그 기반 알림을 사용하면 제목 영역 또는 주제를 기반으로 알림을 구분할 수 있습니다. 알림 수신인은 관심있는 제목 또는 주제에 대한 알림일 경우에만 알림을 수신하도록 선택할 수 있습니다. 따라서 태그 기반 알림은 수신인을 구분할 수 있는 수단을 제공합니다. 이 기능을 사용하면 태그를 정의한 다음 태그별로 메시지를 전송 및 수신할 수 있는 기능을 사용할 수 있습니다. 태그를 구독하는 클라이언트 애플리케이션 인스턴스(모바일, 브라우저에 있거나 앱 또는 확장 프로그램으로서의 인스턴스)만 메시지의 대상입니다. 먼저 애플리케이션의 태그를 작성하고 태그 구독을 설정한 후 태그 기반 알림을 시작해야 합니다. REST API를 사용하는 태그 기반 알림을 전송하려면 메시지 자원에 게시할 때 "tagNames"가 제공되는지 확인하십시오. + +### 유니캐스트 알림 +{: unicast-notifications} + +유니캐스트 알림은 특정 디바이스 또는 사용자를 대상으로 하는 메시지입니다. 디바이스를 대상으로 하는 유니캐스트 알림에는 추가 설정이 필요하지 않으며 애플리케이션에서 {{site.data.keyword.mobilepushshort}}를 사용하는 경우 기본적으로 유니캐스트 알림이 사용됩니다. + +그러나 사용자를 대상으로 하는 유니캐스트 알림에서는 {{site.data.keyword.mobilepushshort}}를 수신하도록 클라이언트 모바일 디바이스나 웹 브라우저 또는 Chrome 앱과 확장 프로그램을 등록할 때 사용자 ID와 디바이스를 연관시켜야 합니다. + +일반적으로 클라이언트 애플리케이션은 제일 먼저 인증 주기를 실행하며 여기서 모바일 앱 사용자가 인증 서비스(예: [Mobile Client Access](docs/services/mobileaccess/index.html))에 대해 인증됩니다. 인증에 성공하면 인증된 사용자 ID가 푸시 디바이스 등록 API에 전달됩니다. +REST API를 통해 유니캐스트 알림을 전송하려면 메시지 자원에 게시할 때 deviceIds 또는 userIds가 제공되는지 확인하십시오. + +### 플랫폼 기반 알림 +{: platform-based-notifications} + +특정 디바이스 플랫폼에 도달하도록 알림의 대상을 설정할 수 있습니다. 예를 들어, 모든 Android 사용자 또는 Google Chrome 사용자에게만 알림을 전송할 수 있습니다. REST API를 사용하는 플랫폼 기반 알림을 전송하려면 메시지 리소스에 게시할 때 대상 플랫폼이 제공되는지 확인하십시오. 플랫폼을 어레이로 지정하십시오. 지원되는 플랫폼은 다음과 같습니다. +* A(Apple) +* G(Google) +* WEB_CHROME(Google Chrome 브라우저 웹 푸시) +* WEB_FIREFOX(Mozilla Firefox 브라우저 웹 푸시) +* WEB_SAFARI(Safari 브라우저 웹 푸시) +* APPEXT_CHROME(Google Chrome 앱 및 확장 프로그램) + +## {{site.data.keyword.mobilepushshort}} 메시지 크기 +{: #push-message-size} + +{{site.data.keyword.mobilepushshort}} 메시지 페이로드 크기는 게이트웨이(FCM/GCM, APNs)와 클라이언트 플랫폼의 제한조건에 따라 다릅니다. + +### iOS 및 Safari +{: ios-message-size} + +iOS 8 이상의 경우 허용된 최대 크기는 2KB입니다. Apple 푸시 알림 서비스는 이 한계를 초과하는 알림을 전송하지 않습니다. + +### Android, Firefox 브라우저, Chrome 브라우저, Chrome 앱 및 확장기능 +{: android-message-size} + +허용되는 최대 메시지 페이로드 크기는 4KB입니다. diff --git a/services/mobilepush/nl/ko/c_rich_media_notifications.md b/services/mobilepush/nl/ko/c_rich_media_notifications.md index ab7285131..b3a1e40bb 100644 --- a/services/mobilepush/nl/ko/c_rich_media_notifications.md +++ b/services/mobilepush/nl/ko/c_rich_media_notifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 리치 미디어 알림 사용 -{: #interactive-notifications} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - - -iOS 10 이상에서 리치 미디어 {{site.data.keyword.mobilepushshort}}를 사용할 수 있습니다. 오디오, 동영상, GIF 및 이미지가 포함된 푸시 알림을 보낼 수 있습니다. - -iOS 10에서 리치 푸시를 받을 애플리케이션을 설정하려면 다음 단계를 완료하십시오. - -1. Xcode에서 **파일** > **새로 작성** > **대상** > **알림 서비스 확장기능**을 선택하십시오. -2. `UNNotificationServiceExtension`의 `didReceive()` 메소드에서 코드를 추가하십시오. -``` -BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) -``` - -푸시 대시보드에서 리치 미디어 {{site.data.keyword.mobilepushshort}}를 보내려면 메시지, 제목, 부제목 및 attachmentURL 필드를 지정하십시오. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 리치 미디어 알림 사용 +{: #interactive-notifications} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + + +iOS 10 이상에서 리치 미디어 {{site.data.keyword.mobilepushshort}}를 사용할 수 있습니다. 오디오, 동영상, GIF 및 이미지가 포함된 푸시 알림을 보낼 수 있습니다. + +iOS 10에서 리치 푸시를 받을 애플리케이션을 설정하려면 다음 단계를 완료하십시오. + +1. Xcode에서 **파일** > **새로 작성** > **대상** > **알림 서비스 확장기능**을 선택하십시오. +2. `UNNotificationServiceExtension`의 `didReceive()` 메소드에서 코드를 추가하십시오. +``` +BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) +``` + +푸시 대시보드에서 리치 미디어 {{site.data.keyword.mobilepushshort}}를 보내려면 메시지, 제목, 부제목 및 attachmentURL 필드를 지정하십시오. diff --git a/services/mobilepush/nl/ko/c_tag_basednotifications.md b/services/mobilepush/nl/ko/c_tag_basednotifications.md index 72b97d75a..47ac31b42 100644 --- a/services/mobilepush/nl/ko/c_tag_basednotifications.md +++ b/services/mobilepush/nl/ko/c_tag_basednotifications.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 태그 기반 알림 사용 -{: #tag_based_notifications} -마지막 업데이트 날짜: 2017년 1월 16일 -{: .last-updated} - -태그 기반 알림 메시지는 특정 태그를 구독하는 모든 디바이스가 대상입니다. - -태그를 정의한 다음 태그를 사용하여 메시지를 전송 및 수신할 수 있습니다. 먼저 애플리케이션에 대한 태그를 작성하고, 태그 구독을 설정한 다음, 태그 기반 알림을 시작해야 합니다. [REST API](https://mobile.{DomainName}/imfpush/){: new_window}를 사용하여 태그 기반 알림을 전송하려면 메시지 리소스에 게시하는 중에 "tagNames"가 제공되는지 확인하십시오. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 태그 기반 알림 사용 +{: #tag_based_notifications} +마지막 업데이트 날짜: 2017년 1월 16일 +{: .last-updated} + +태그 기반 알림 메시지는 특정 태그를 구독하는 모든 디바이스가 대상입니다. + +태그를 정의한 다음 태그를 사용하여 메시지를 전송 및 수신할 수 있습니다. 먼저 애플리케이션에 대한 태그를 작성하고, 태그 구독을 설정한 다음, 태그 기반 알림을 시작해야 합니다. [REST API](https://mobile.{DomainName}/imfpush/){: new_window}를 사용하여 태그 기반 알림을 전송하려면 메시지 리소스에 게시하는 중에 "tagNames"가 제공되는지 확인하십시오. diff --git a/services/mobilepush/nl/ko/c_user_basednotifications.md b/services/mobilepush/nl/ko/c_user_basednotifications.md index a2fb82bc4..7c86b7de9 100644 --- a/services/mobilepush/nl/ko/c_user_basednotifications.md +++ b/services/mobilepush/nl/ko/c_user_basednotifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 사용자 기반 알림 사용 -{: #user_based_notifications} -마지막 업데이트 날짜: 2017년 1월 16일 -{: .last-updated} - -사용자 ID 기반 {{site.data.keyword.mobilepushshort}}는 사용자 정의된 메시지를 사용하는 모바일 앱 사용자가 대상입니다. 사용자 기반 알림에서는 사용자의 환경 설정을 기반으로 특정 개인에게 알림을 전송하도록 선택할 수 있습니다. - -## 사용자 ID를 사용하여 디바이스 등록 -사용자 ID로 대상이 지정되는 푸시 알림을 사용하려면 사용자 ID 필드를 설정하여 디바이스를 등록해야 합니다. - -애플리케이션에서 디바이스 등록 API에 제공하는 모든 문자열이 사용자 ID가 될 수 있습니다. 일반적으로, 모바일 애플리케이션은 먼저 인증 주기를 실행하며, 여기서 모바일 앱 사용자는 인증 서비스(예: [{{site.data.keyword.amafull}} ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window})에 대해 인증됩니다. 인증에 성공하면 인증된 사용자 ID가 푸시 디바이스 등록 API에 전달됩니다. - -## 사용자 로그인과 로그아웃 동기화 - -사용자가 로그인한 경우에만 알림을 보내도록 선택할 수 있습니다. - -예를 들어, 직장의 팀 또는 가족의 구성원이 디바이스를 공유하는 경우 특정 사용자를 지정해야 합니다. 이와 같은 유스 케이스에서는 사용자 로그인/로그아웃 시퀀스가 있습니다. 이러한 인증 메커니즘을 사용하면 애플리케이션에서 애플리케이션 현재 사용자의 ID를 추적할 수 있습니다. 이로 인해 특정 사용자를 대상으로 하는 알림을 항상 해당 사용자만 수신할 수 있습니다. 로그인한 후 로그인한 사용자의 사용자 ID를 전달하여 디바이스 등록 API를 호출하십시오. 마찬가지로 로그아웃하기 전에 디바이스 등록 해제 API를 호출하십시오. 로그인과 로그아웃에서 이러한 푸시 API의 시퀀스를 지정하면 특정 사용자를 대상으로 작성된 알림이 해당 사용자에게만 전송됩니다. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 사용자 기반 알림 사용 +{: #user_based_notifications} +마지막 업데이트 날짜: 2017년 1월 16일 +{: .last-updated} + +사용자 ID 기반 {{site.data.keyword.mobilepushshort}}는 사용자 정의된 메시지를 사용하는 모바일 앱 사용자가 대상입니다. 사용자 기반 알림에서는 사용자의 환경 설정을 기반으로 특정 개인에게 알림을 전송하도록 선택할 수 있습니다. + +## 사용자 ID를 사용하여 디바이스 등록 +사용자 ID로 대상이 지정되는 푸시 알림을 사용하려면 사용자 ID 필드를 설정하여 디바이스를 등록해야 합니다. + +애플리케이션에서 디바이스 등록 API에 제공하는 모든 문자열이 사용자 ID가 될 수 있습니다. 일반적으로, 모바일 애플리케이션은 먼저 인증 주기를 실행하며, 여기서 모바일 앱 사용자는 인증 서비스(예: [{{site.data.keyword.amafull}} ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window})에 대해 인증됩니다. 인증에 성공하면 인증된 사용자 ID가 푸시 디바이스 등록 API에 전달됩니다. + +## 사용자 로그인과 로그아웃 동기화 + +사용자가 로그인한 경우에만 알림을 보내도록 선택할 수 있습니다. + +예를 들어, 직장의 팀 또는 가족의 구성원이 디바이스를 공유하는 경우 특정 사용자를 지정해야 합니다. 이와 같은 유스 케이스에서는 사용자 로그인/로그아웃 시퀀스가 있습니다. 이러한 인증 메커니즘을 사용하면 애플리케이션에서 애플리케이션 현재 사용자의 ID를 추적할 수 있습니다. 이로 인해 특정 사용자를 대상으로 하는 알림을 항상 해당 사용자만 수신할 수 있습니다. 로그인한 후 로그인한 사용자의 사용자 ID를 전달하여 디바이스 등록 API를 호출하십시오. 마찬가지로 로그아웃하기 전에 디바이스 등록 해제 API를 호출하십시오. 로그인과 로그아웃에서 이러한 푸시 API의 시퀀스를 지정하면 특정 사용자를 대상으로 작성된 알림이 해당 사용자에게만 전송됩니다. diff --git a/services/mobilepush/nl/ko/c_web_extensions.md b/services/mobilepush/nl/ko/c_web_extensions.md index 5cc1bfd53..78e2be2cc 100644 --- a/services/mobilepush/nl/ko/c_web_extensions.md +++ b/services/mobilepush/nl/ko/c_web_extensions.md @@ -1,110 +1,110 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}}를 수신하도록 Chrome 앱과 확장 프로그램 설정 -{: #web_notifications} -마지막 업데이트 날짜: 2017년 1월 18일 -{: .last-updated} - -Google Chrome 앱과 확장 프로그램에서 {{site.data.keyword.mobilepushshort}}를 수신하도록 설정할 수 있습니다. 단계를 진행하기 전에 [알림 제공자의 신임 정보 구성](t__main_push_config_provider.html)을 수행했는지 확인하십시오. - -## {{site.data.keyword.mobilepushshort}}에 사용할 클라이언트 SDK 설치 -{: #web_install} - -이 주제에서는 클라이언트 JavaScript 푸시 SDK를 설치하고 이를 사용하여 추가적으로 Chrome 앱과 확장 프로그램을 개발하는 방법에 대해 설명합니다. - -### Google Chrome 앱과 확장 프로그램에서 초기화 - -Chrome 앱과 확장 프로그램에 Javascript SDK를 설치하려면 다음 단계를 완료하십시오. - -[Bluemix 웹 푸시 SDK -![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}에서 -`BMSPushSDK.js` 및 `manifest_Chrome_Ext.json`(chrome 확장기능의 경우) 또는 -`manifest_Chrome_App.json`(Chrome 앱의 경우)을 다운로드하십시오. - - - -- Chrome 앱의 경우 다음과 같이 Manifest 파일을 구성하십시오. - 1. `manifest_Chrome_App.json` 파일에 이름, 설명, 아이콘을 제공하십시오. - 2. `BMSPushSDK.js`를 `app.background.scripts`에 추가하십시오. - 3. `manifest_Chrome_App.json`을 `manifest.json`으로 변경하십시오. - -- Chrome 확장 프로그램의 경우 다음과 같이 Manifest 파일을 구성하십시오. - 1. `manifest_Chrome_Ext.json` 파일에 이름, 설명, 아이콘을 제공하십시오. - 2. `BMSPushSDK.js`를 `background.scripts`에 추가하십시오. - 3. `manifest_Chrome_Ext.json`을 `manifest.json`으로 변경하십시오. - -`background.js` 파일에서 푸시 알림을 수신하도록 다음을 추가하십시오. -``` -chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) -chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); -chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); -``` - {: codeblock} - - - -## 푸시 SDK 초기화 -{: #web_initialize} - -Bluemix {{site.data.keyword.mobilepushshort}} 서비스 `app GUID` 및 `app Region`을 사용하여 푸시 SDK를 초기화하십시오. - -앱 GUID를 가져오려면 초기화된 푸시 서비스의 탐색 분할창에서 **구성** 옵션을 선택하고 **모바일 옵션**을 클릭하십시오. Bluemix 푸시 알림 서비스 appGUID 매개변수를 사용하도록 코드 스니펫을 수정하십시오. - -`App Region`은 {{site.data.keyword.mobilepushshort}} 서비스가 호스팅되는 위치를 지정합니다. 다음 세 값 중 하나를 사용할 수 있습니다. - - - 미국 댈러스의 경우: `.ng.bluemix.net` - - 영국의 경우: `.eu-gb.bluemix.net` - - 시드니의 경우: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) -``` - {: codeblock} - -## Chrome 앱과 확장 프로그램 등록 -{: #web_register} - -{{site.data.keyword.mobilepushshort}} 서비스에 디바이스를 등록하려면 `register()` API를 사용하십시오. Google Chrome에서 등록하는 경우 Bluemix {{site.data.keyword.mobilepushshort}} 서비스 웹 구성 대시보드에 FCM(Firebase Cloud Messaging) 또는 GCM(Google Cloud Messaging) API 키와 웹 사이트 URL을 추가하십시오. 자세한 정보는 Chrome 설정 아래에 있는 [GCM(Google Cloud Messaging)의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. - -Mozilla Firefox에서 등록하는 경우, Firefox 설정 아래의 Bluemix {{site.data.keyword.mobilepushshort}} 서비스 웹 구성 대시보드에 웹 사이트 URL을 추가하십시오. - -Bluemix {{site.data.keyword.mobilepushshort}} 서비스에 등록하려면 다음 코드 스니펫을 사용하십시오. -``` -var bmsPush = new BMSPush(); -function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}}를 수신하도록 Chrome 앱과 확장 프로그램 설정 +{: #web_notifications} +마지막 업데이트 날짜: 2017년 1월 18일 +{: .last-updated} + +Google Chrome 앱과 확장 프로그램에서 {{site.data.keyword.mobilepushshort}}를 수신하도록 설정할 수 있습니다. 단계를 진행하기 전에 [알림 제공자의 신임 정보 구성](t__main_push_config_provider.html)을 수행했는지 확인하십시오. + +## {{site.data.keyword.mobilepushshort}}에 사용할 클라이언트 SDK 설치 +{: #web_install} + +이 주제에서는 클라이언트 JavaScript 푸시 SDK를 설치하고 이를 사용하여 추가적으로 Chrome 앱과 확장 프로그램을 개발하는 방법에 대해 설명합니다. + +### Google Chrome 앱과 확장 프로그램에서 초기화 + +Chrome 앱과 확장 프로그램에 Javascript SDK를 설치하려면 다음 단계를 완료하십시오. + +[Bluemix 웹 푸시 SDK +![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}에서 +`BMSPushSDK.js` 및 `manifest_Chrome_Ext.json`(chrome 확장기능의 경우) 또는 +`manifest_Chrome_App.json`(Chrome 앱의 경우)을 다운로드하십시오. + + + +- Chrome 앱의 경우 다음과 같이 Manifest 파일을 구성하십시오. + 1. `manifest_Chrome_App.json` 파일에 이름, 설명, 아이콘을 제공하십시오. + 2. `BMSPushSDK.js`를 `app.background.scripts`에 추가하십시오. + 3. `manifest_Chrome_App.json`을 `manifest.json`으로 변경하십시오. + +- Chrome 확장 프로그램의 경우 다음과 같이 Manifest 파일을 구성하십시오. + 1. `manifest_Chrome_Ext.json` 파일에 이름, 설명, 아이콘을 제공하십시오. + 2. `BMSPushSDK.js`를 `background.scripts`에 추가하십시오. + 3. `manifest_Chrome_Ext.json`을 `manifest.json`으로 변경하십시오. + +`background.js` 파일에서 푸시 알림을 수신하도록 다음을 추가하십시오. +``` +chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) +chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); +chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); +``` + {: codeblock} + + + +## 푸시 SDK 초기화 +{: #web_initialize} + +Bluemix {{site.data.keyword.mobilepushshort}} 서비스 `app GUID` 및 `app Region`을 사용하여 푸시 SDK를 초기화하십시오. + +앱 GUID를 가져오려면 초기화된 푸시 서비스의 탐색 분할창에서 **구성** 옵션을 선택하고 **모바일 옵션**을 클릭하십시오. Bluemix 푸시 알림 서비스 appGUID 매개변수를 사용하도록 코드 스니펫을 수정하십시오. + +`App Region`은 {{site.data.keyword.mobilepushshort}} 서비스가 호스팅되는 위치를 지정합니다. 다음 세 값 중 하나를 사용할 수 있습니다. + + - 미국 댈러스의 경우: `.ng.bluemix.net` + - 영국의 경우: `.eu-gb.bluemix.net` + - 시드니의 경우: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) +``` + {: codeblock} + +## Chrome 앱과 확장 프로그램 등록 +{: #web_register} + +{{site.data.keyword.mobilepushshort}} 서비스에 디바이스를 등록하려면 `register()` API를 사용하십시오. Google Chrome에서 등록하는 경우 Bluemix {{site.data.keyword.mobilepushshort}} 서비스 웹 구성 대시보드에 FCM(Firebase Cloud Messaging) 또는 GCM(Google Cloud Messaging) API 키와 웹 사이트 URL을 추가하십시오. 자세한 정보는 Chrome 설정 아래에 있는 [GCM(Google Cloud Messaging)의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. + +Mozilla Firefox에서 등록하는 경우, Firefox 설정 아래의 Bluemix {{site.data.keyword.mobilepushshort}} 서비스 웹 구성 대시보드에 웹 사이트 URL을 추가하십시오. + +Bluemix {{site.data.keyword.mobilepushshort}} 서비스에 등록하려면 다음 코드 스니펫을 사용하십시오. +``` +var bmsPush = new BMSPush(); +function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + diff --git a/services/mobilepush/nl/ko/c_web_extensions_send.md b/services/mobilepush/nl/ko/c_web_extensions_send.md index 1e20d5e04..63954536b 100644 --- a/services/mobilepush/nl/ko/c_web_extensions_send.md +++ b/services/mobilepush/nl/ko/c_web_extensions_send.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Chrome 앱 및 확장기능에 기본 알림 전송 -{: #web_extensions_notifications} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - -애플리케이션을 개발한 후에는 푸시 알림을 전송할 수 있습니다. - -1. **알림 전송**을 선택하고 **받는 사람** 옵션으로 **웹 알림**을 선택하여 메시지를 작성하십시오. -2. **메시지** 필드에 전달할 메시지를 입력하십시오. -3. 다음과 같은 선택적 설정을 제공하도록 선택할 수 있습니다. - - **알림 제목**: 메시지 경보 표제로 표시할 텍스트입니다. - - **알림 아이콘 URL**: 메시지를 앱 알림 아이콘과 함께 전달해야 하는 경우 필드에서 아이콘에 대한 링크를 제공하십시오. - - **접기 키**: 접기 키는 알림에 첨부됩니다. 디바이스가 오프라인 상태일 때 접기 키가 동일한 여러 개의 알림이 순차적으로 도착하는 경우 해당 알림은 접혀 있습니다. 디바이스가 온라인 상태가 되면 FCM/GCM 서버에서 알림을 수신하고 동일한 접기 키가 있는 최신 알림만 표시합니다. 접기 키가 설정되어 있지 않는 경우에는 나중에 전달할 수 있도록 새 메시지와 이전 메시지가 모두 저장됩니다. - - **유효 기간**: 이 값은 초 단위로 설정됩니다. 이 매개변수를 지정하지 않는 경우 FCM/GCM 서버는 메시지를 4주 동안 저장하고 전달하려고 합니다. 4주 후에 유효성이 만료됩니다. 가능한 값 범위는 0 - 2,419,200초입니다. - - **유휴 시 지연**: 이 값을 `true`로 설정하면 디바이스가 유휴 상태인 경우 FCM/GCM 서버가 알림을 전달하지 않습니다. 디바이스가 유휴 상태인 경우에도 알림이 전달되도록 하려면 이 값을 `false`로 설정하십시오. - - **추가 페이로드**: 알림에 대한 사용자 정의 페이로드 값을 지정합니다. - -다음 이미지는 대시보드의 Chrome 앱 및 확장기능 알림 옵션을 표시합니다. - - ![알림 화면](images/push_chrome_extns.jpg) - -## 다음 단계 - {: #next_steps_tags} - -정상적으로 기본 알림을 설정한 후에는 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. - -이러한 {{site.data.keyword.mobilepushshort}} 서비스 기능을 앱에 추가하십시오. 태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. 고급 알림 옵션을 사용하려면 [고급 알림](t_advance_badge_sound_payload.html)을 참조하십시오. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Chrome 앱 및 확장기능에 기본 알림 전송 +{: #web_extensions_notifications} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + +애플리케이션을 개발한 후에는 푸시 알림을 전송할 수 있습니다. + +1. **알림 전송**을 선택하고 **받는 사람** 옵션으로 **웹 알림**을 선택하여 메시지를 작성하십시오. +2. **메시지** 필드에 전달할 메시지를 입력하십시오. +3. 다음과 같은 선택적 설정을 제공하도록 선택할 수 있습니다. + - **알림 제목**: 메시지 경보 표제로 표시할 텍스트입니다. + - **알림 아이콘 URL**: 메시지를 앱 알림 아이콘과 함께 전달해야 하는 경우 필드에서 아이콘에 대한 링크를 제공하십시오. + - **접기 키**: 접기 키는 알림에 첨부됩니다. 디바이스가 오프라인 상태일 때 접기 키가 동일한 여러 개의 알림이 순차적으로 도착하는 경우 해당 알림은 접혀 있습니다. 디바이스가 온라인 상태가 되면 FCM/GCM 서버에서 알림을 수신하고 동일한 접기 키가 있는 최신 알림만 표시합니다. 접기 키가 설정되어 있지 않는 경우에는 나중에 전달할 수 있도록 새 메시지와 이전 메시지가 모두 저장됩니다. + - **유효 기간**: 이 값은 초 단위로 설정됩니다. 이 매개변수를 지정하지 않는 경우 FCM/GCM 서버는 메시지를 4주 동안 저장하고 전달하려고 합니다. 4주 후에 유효성이 만료됩니다. 가능한 값 범위는 0 - 2,419,200초입니다. + - **유휴 시 지연**: 이 값을 `true`로 설정하면 디바이스가 유휴 상태인 경우 FCM/GCM 서버가 알림을 전달하지 않습니다. 디바이스가 유휴 상태인 경우에도 알림이 전달되도록 하려면 이 값을 `false`로 설정하십시오. + - **추가 페이로드**: 알림에 대한 사용자 정의 페이로드 값을 지정합니다. + +다음 이미지는 대시보드의 Chrome 앱 및 확장기능 알림 옵션을 표시합니다. + + ![알림 화면](images/push_chrome_extns.jpg) + +## 다음 단계 + {: #next_steps_tags} + +정상적으로 기본 알림을 설정한 후에는 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. + +이러한 {{site.data.keyword.mobilepushshort}} 서비스 기능을 앱에 추가하십시오. 태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. 고급 알림 옵션을 사용하려면 [고급 알림](t_advance_badge_sound_payload.html)을 참조하십시오. diff --git a/services/mobilepush/nl/ko/images/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/ko/images/t_enable_actionable_notifications_ios.md index 46dc480de..d6ac43678 100644 --- a/services/mobilepush/nl/ko/images/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/ko/images/t_enable_actionable_notifications_ios.md @@ -1,105 +1,105 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# iOS에 조치 가능 알림 사용 -{: #enable-actionable-notifications-ios} - -일반적인 조치 알림과 달리, 조치 가능 알림은 알림 경고 수신 시 앱을 열지 않고 수행할 동작을 선택할 수 있는 프롬프트를 사용자에게 표시합니다. 다음 지시사항을 사용하여 애플리케이션에서 조치 가능 푸시 알림을 사용하십시오. - - - -1. 사용자 응답 조치를 작성하십시오. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. 알림 카테고리를 작성하고 조치를 설정하십시오. **UIUserNotificationActionContextDefault** 또는 **UIUserNotificationActionContextMinimal**이 올바른 컨텍스트입니다. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. 알림 설정을 작성하고 이전 단계의 범주를 지정하십시오. - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. 로컬 또는 원격 알림을 작성하고 카테고리 ID를 지정하십시오. - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# iOS에 조치 가능 알림 사용 +{: #enable-actionable-notifications-ios} + +일반적인 조치 알림과 달리, 조치 가능 알림은 알림 경고 수신 시 앱을 열지 않고 수행할 동작을 선택할 수 있는 프롬프트를 사용자에게 표시합니다. 다음 지시사항을 사용하여 애플리케이션에서 조치 가능 푸시 알림을 사용하십시오. + + + +1. 사용자 응답 조치를 작성하십시오. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. 알림 카테고리를 작성하고 조치를 설정하십시오. **UIUserNotificationActionContextDefault** 또는 **UIUserNotificationActionContextMinimal**이 올바른 컨텍스트입니다. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. 알림 설정을 작성하고 이전 단계의 범주를 지정하십시오. + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. 로컬 또는 원격 알림을 작성하고 카테고리 ID를 지정하십시오. + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/ko/index.md b/services/mobilepush/nl/ko/index.md index bbeebfe87..8e9745602 100644 --- a/services/mobilepush/nl/ko/index.md +++ b/services/mobilepush/nl/ko/index.md @@ -1,54 +1,54 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}} 시작하기 -{: #gettingstartedtemplate} -마지막 업데이트 날짜: 2017년 1월 19일 -{: .last-updated} - -{:shortdesc} - -{{site.data.keyword.mobilepushshort}}는 모바일 카테고리에서 Bluemix 카탈로그 서비스로 사용할 수 있으며, 모바일 및 웹 푸시 알림을 보내고 관리할 수 있습니다. 이 서비스에서는 애플리케이션 사용자를 디바이스, 디바이스 플랫폼 및 웹 브라우저와 맵핑하는 작업을 관리하면서 알림의 디스패치를 처리합니다. - - {{site.data.keyword.mobilepushshort}}는 MobileFirst Services Starter 표준 유형의 일부 및 Bluemix [데디케이티드 서비스](/docs/dedicated/index.html)로 사용 가능합니다. 이 서비스를 사용하여 브로드캐스트, 유니캐스트(디바이스 ID와 사용자 ID 기반), 태그 기반 알림, 웹 후크 이벤트 기반 알림 외에도 리치 미디어 알림과 대화식 알림을 모바일 및 웹 브라우저 애플리케이션 사용자에게 보낼 수 있습니다. 또한 SDK(Software Development Kit) 및 [REST API![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 사용하여 클라이언트 애플리케이션을 추가로 개발할 수 있습니다. - -이 서비스에서는 사용자 데이터에서 그래프와 보고서를 생성하여 푸시 알림 성능을 모니터할 수 있는 모니터링 기능도 제공합니다. [푸시 알림 모니터링](/docs/services/mobilepush/t_push_monitoring.html)을 참조하십시오. - -{{site.data.keyword.mobilepushshort}} 서비스는 다음 플랫폼에서 지원됩니다. - -- [iOS 및 Android 모바일 디바이스](/docs/services/mobilepush/c_enable_push.html) -- [Google Chrome, Mozilla Firefox 및 Safari 웹 브라우저](/docs/services/mobilepush/c_chrome_firefox_enable.html) -- [Google Chrome 앱 및 확장 프로그램](/docs/services/mobilepush/c_web_extensions.html) - - -# 관련 링크 -{: #rellinks} - -* [개요 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](c_overview_push.html){: new_window} - -## 튜토리얼 및 샘플 {:id="samples"} -{: #samples} -* [Android helloPush 샘플 애플리케이션 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} -- [Cordova 샘플 애플리케이션 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} -* [iOS helloPush 샘플 애플리케이션(Swift) ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} - -## SDK -{: #sdk} -* [Android SDK ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} -* [Cordova SDK ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} -* [iOS SDK(Swift) ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} - -## API 참조 -{: #api} -* [Push API 참조(Android) ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} -* [BMSPush API 참조 iOS(Swift) ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} -* [REST API 참조 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window} +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}} 시작하기 +{: #gettingstartedtemplate} +마지막 업데이트 날짜: 2017년 1월 19일 +{: .last-updated} + +{:shortdesc} + +{{site.data.keyword.mobilepushshort}}는 모바일 카테고리에서 Bluemix 카탈로그 서비스로 사용할 수 있으며, 모바일 및 웹 푸시 알림을 보내고 관리할 수 있습니다. 이 서비스에서는 애플리케이션 사용자를 디바이스, 디바이스 플랫폼 및 웹 브라우저와 맵핑하는 작업을 관리하면서 알림의 디스패치를 처리합니다. + + {{site.data.keyword.mobilepushshort}}는 MobileFirst Services Starter 표준 유형의 일부 및 Bluemix [데디케이티드 서비스](/docs/dedicated/index.html)로 사용 가능합니다. 이 서비스를 사용하여 브로드캐스트, 유니캐스트(디바이스 ID와 사용자 ID 기반), 태그 기반 알림, 웹 후크 이벤트 기반 알림 외에도 리치 미디어 알림과 대화식 알림을 모바일 및 웹 브라우저 애플리케이션 사용자에게 보낼 수 있습니다. 또한 SDK(Software Development Kit) 및 [REST API![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 사용하여 클라이언트 애플리케이션을 추가로 개발할 수 있습니다. + +이 서비스에서는 사용자 데이터에서 그래프와 보고서를 생성하여 푸시 알림 성능을 모니터할 수 있는 모니터링 기능도 제공합니다. [푸시 알림 모니터링](/docs/services/mobilepush/t_push_monitoring.html)을 참조하십시오. + +{{site.data.keyword.mobilepushshort}} 서비스는 다음 플랫폼에서 지원됩니다. + +- [iOS 및 Android 모바일 디바이스](/docs/services/mobilepush/c_enable_push.html) +- [Google Chrome, Mozilla Firefox 및 Safari 웹 브라우저](/docs/services/mobilepush/c_chrome_firefox_enable.html) +- [Google Chrome 앱 및 확장 프로그램](/docs/services/mobilepush/c_web_extensions.html) + + +# 관련 링크 +{: #rellinks} + +* [개요 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](c_overview_push.html){: new_window} + +## 튜토리얼 및 샘플 {:id="samples"} +{: #samples} +* [Android helloPush 샘플 애플리케이션 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} +- [Cordova 샘플 애플리케이션 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} +* [iOS helloPush 샘플 애플리케이션(Swift) ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} + +## SDK +{: #sdk} +* [Android SDK ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} +* [Cordova SDK ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} +* [iOS SDK(Swift) ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} + +## API 참조 +{: #api} +* [Push API 참조(Android) ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} +* [BMSPush API 참조 iOS(Swift) ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} +* [REST API 참조 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window} diff --git a/services/mobilepush/nl/ko/interactive_notifications.md b/services/mobilepush/nl/ko/interactive_notifications.md index c2579ec43..55faef43b 100644 --- a/services/mobilepush/nl/ko/interactive_notifications.md +++ b/services/mobilepush/nl/ko/interactive_notifications.md @@ -1,83 +1,83 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 대화식 알림 -{: #interactive-notifications} -마지막 업데이트 날짜: 2017년 1월 23일 -{: .last-updated} - -대화식 알림을 사용하면 애플리케이션을 열지 않고 알림에 응답할 수 있습니다. 대화식 알림이 도착하면 디바이스에 알림 메시지와 함께 조치 단추가 표시됩니다. 대화식 알림은 iOS 버전 8 이상이 설치된 디바이스에서 지원됩니다. 버전 8 미만의 iOS 디바이스에 보낸 대화식 알림의 경우 알림 조치가 표시되지 않습니다. - -##대화식 {{site.data.keyword.mobilepushshort}} 전송 - - -푸시 대시보드 또는 [REST API 문서](t_restapi.html)를 사용하여 대화식 알림을 전송할 수 있습니다. - -{{site.data.keyword.mobilepushshort}} 콘솔에서 다음을 수행하십시오. - -1. 푸시 대시보드의 알림 탭에서 **알림 전송**을 클릭하십시오. -2. 알림 수신인을 선택하고 **다음**을 클릭하십시오. -3. 알림 작성 페이지에서 유형을 기본 또는 혼합으로 설정하고 고급 옵션 탭에서 카테고리 값을 지정하여 대화식 푸시를 전송할 수 있습니다. 클라이언트에서 카테고리 값을 구성하려면 기본 iOS 애플리케이션 섹션에서 **대화식 {{site.data.keyword.mobilepushshort}} 처리**를 선택하십시오. - -## iOS 애플리케이션에서 대화식 {{site.data.keyword.mobilepushshort}} 처리 - - -### Swift - -대화식 알림을 받으려면 다음 단계를 완료하십시오. - -1. 애플리케이션이 원격 알림 수신에 대한 백그라운드 태스크를 수행하는 기능을 사용으로 설정하십시오. -1. 조치 카테고리로 `BMSPush` SDK를 초기화하십시오. - ``` - let myBMSClient = BMSClient.sharedInstance - myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) - let push = BMSPushClient.sharedInstance - let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) - let notifOptions = BMSPushClientOptions(categoryName: [category]) - push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) - ``` - {: codeblock} - -1. AppDelegate에서 다음과 같이 새 콜백 메소드를 구현하십시오. - ``` - func userNotificationCenter(_ center: UNUserNotificationCenter, - didReceive response: UNNotificationResponse, - withCompletionHandler completionHandler: @escaping () -> Void) { - switch response.actionIdentifier { - case "FIRST": - print("FIRST") - case "SECOND": - print("SECOND") - default: - print("Unknown action") - } - completionHandler - } - ``` - {: codeblock} -5. 이 새로운 콜백 메소드는 사용자가 조치 단추를 클릭할 때 호출됩니다. 이 메소드를 구현하기 위해서는 지정된 ID와 연관된 태스크를 수행하고 `completionHandler` 매개변수에서 블록을 실행해야 합니다. - - -### Cordova - -Cordova iOS 애플리케이션에서 조치 가능 알림을 받으려면 다음 단계를 완료하십시오. - -1. `BMSPush.initialize` 메소드에 카테고리 필드를 추가합니다. - ``` - var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} - BMSPush.initialize(appGUID,clientSecret,category); - ``` - {: codeblock} -2. AppDelegate에서 새 콜백 메소드를 구현합니다. -3. 이 새로운 콜백 메소드는 사용자가 조치 단추를 클릭할 때 호출됩니다. 이 메소드를 구현하기 위해서는 지정된 ID와 연관된 태스크를 수행하고 completionHandler 매개변수에서 블록을 실행해야 합니다. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 대화식 알림 +{: #interactive-notifications} +마지막 업데이트 날짜: 2017년 1월 23일 +{: .last-updated} + +대화식 알림을 사용하면 애플리케이션을 열지 않고 알림에 응답할 수 있습니다. 대화식 알림이 도착하면 디바이스에 알림 메시지와 함께 조치 단추가 표시됩니다. 대화식 알림은 iOS 버전 8 이상이 설치된 디바이스에서 지원됩니다. 버전 8 미만의 iOS 디바이스에 보낸 대화식 알림의 경우 알림 조치가 표시되지 않습니다. + +##대화식 {{site.data.keyword.mobilepushshort}} 전송 + + +푸시 대시보드 또는 [REST API 문서](t_restapi.html)를 사용하여 대화식 알림을 전송할 수 있습니다. + +{{site.data.keyword.mobilepushshort}} 콘솔에서 다음을 수행하십시오. + +1. 푸시 대시보드의 알림 탭에서 **알림 전송**을 클릭하십시오. +2. 알림 수신인을 선택하고 **다음**을 클릭하십시오. +3. 알림 작성 페이지에서 유형을 기본 또는 혼합으로 설정하고 고급 옵션 탭에서 카테고리 값을 지정하여 대화식 푸시를 전송할 수 있습니다. 클라이언트에서 카테고리 값을 구성하려면 기본 iOS 애플리케이션 섹션에서 **대화식 {{site.data.keyword.mobilepushshort}} 처리**를 선택하십시오. + +## iOS 애플리케이션에서 대화식 {{site.data.keyword.mobilepushshort}} 처리 + + +### Swift + +대화식 알림을 받으려면 다음 단계를 완료하십시오. + +1. 애플리케이션이 원격 알림 수신에 대한 백그라운드 태스크를 수행하는 기능을 사용으로 설정하십시오. +1. 조치 카테고리로 `BMSPush` SDK를 초기화하십시오. + ``` + let myBMSClient = BMSClient.sharedInstance + myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) + let push = BMSPushClient.sharedInstance + let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) + let notifOptions = BMSPushClientOptions(categoryName: [category]) + push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) + ``` + {: codeblock} + +1. AppDelegate에서 다음과 같이 새 콜백 메소드를 구현하십시오. + ``` + func userNotificationCenter(_ center: UNUserNotificationCenter, + didReceive response: UNNotificationResponse, + withCompletionHandler completionHandler: @escaping () -> Void) { + switch response.actionIdentifier { + case "FIRST": + print("FIRST") + case "SECOND": + print("SECOND") + default: + print("Unknown action") + } + completionHandler + } + ``` + {: codeblock} +5. 이 새로운 콜백 메소드는 사용자가 조치 단추를 클릭할 때 호출됩니다. 이 메소드를 구현하기 위해서는 지정된 ID와 연관된 태스크를 수행하고 `completionHandler` 매개변수에서 블록을 실행해야 합니다. + + +### Cordova + +Cordova iOS 애플리케이션에서 조치 가능 알림을 받으려면 다음 단계를 완료하십시오. + +1. `BMSPush.initialize` 메소드에 카테고리 필드를 추가합니다. + ``` + var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} + BMSPush.initialize(appGUID,clientSecret,category); + ``` + {: codeblock} +2. AppDelegate에서 새 콜백 메소드를 구현합니다. +3. 이 새로운 콜백 메소드는 사용자가 조치 단추를 클릭할 때 호출됩니다. 이 메소드를 구현하기 위해서는 지정된 ID와 연관된 태스크를 수행하고 completionHandler 매개변수에서 블록을 실행해야 합니다. diff --git a/services/mobilepush/nl/ko/next_steps_tags.md b/services/mobilepush/nl/ko/next_steps_tags.md index 2896bf4e6..de1667f4d 100644 --- a/services/mobilepush/nl/ko/next_steps_tags.md +++ b/services/mobilepush/nl/ko/next_steps_tags.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 다음 단계 -{: #next_steps_tags} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - -정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. - -이러한 {{site.data.keyword.mobilepushshort}} 서비스 기능을 앱에 추가하십시오. -태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. -고급 알림 옵션을 사용하려면 [고급 푸시 알림](t_advance_badge_sound_payload.html)을 참조하십시오. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 다음 단계 +{: #next_steps_tags} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + +정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. + +이러한 {{site.data.keyword.mobilepushshort}} 서비스 기능을 앱에 추가하십시오. +태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. +고급 알림 옵션을 사용하려면 [고급 푸시 알림](t_advance_badge_sound_payload.html)을 참조하십시오. diff --git a/services/mobilepush/nl/ko/silent_notifications.md b/services/mobilepush/nl/ko/silent_notifications.md index a6f4bd829..97606bde7 100644 --- a/services/mobilepush/nl/ko/silent_notifications.md +++ b/services/mobilepush/nl/ko/silent_notifications.md @@ -1,39 +1,39 @@ ------- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# iOS의 자동 알림 처리 -{: #silent-notifications} -마지막 업데이트 날짜: 2017년 1월 16일 -{: .last-updated} - -자동 알림은 디바이스 화면에 표시되지 않습니다. 이러한 알림은 애플리케이션에서 백그라운드로 수신되며 애플리케이션이 최대 30초 동안 특정 백그라운드 작업을 수행하도록 지시합니다. 사용자는 알림 도착을 인식하지 못할 수 있습니다. iOS용 자동 알림을 전송하려면, [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 사용하십시오. - -1. 자동 푸시 알림을 전송하려면 프로젝트의 `appDelegate.m` 파일에서 다음 메소드를 구현하십시오. Swift에서는 자동 알림을 위해 서버에서 전송하는 `contentAvailable` 값은 1입니다. -``` -//For Swift - func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - let contentAPS = userInfo["aps"] as [NSObject : AnyObject] - if let contentAvailable = contentAPS["content-available"] as? Int { - //silent or mixed push - if contentAvailable == 1 { - completionHandler(UIBackgroundFetchResult.NewData) - } else { - completionHandler(UIBackgroundFetchResult.NoData) - } - } else { - //Default notification - completionHandler(UIBackgroundFetchResult.NoData) - } - } -``` - {: codeblock} - +------ + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# iOS의 자동 알림 처리 +{: #silent-notifications} +마지막 업데이트 날짜: 2017년 1월 16일 +{: .last-updated} + +자동 알림은 디바이스 화면에 표시되지 않습니다. 이러한 알림은 애플리케이션에서 백그라운드로 수신되며 애플리케이션이 최대 30초 동안 특정 백그라운드 작업을 수행하도록 지시합니다. 사용자는 알림 도착을 인식하지 못할 수 있습니다. iOS용 자동 알림을 전송하려면, [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 사용하십시오. + +1. 자동 푸시 알림을 전송하려면 프로젝트의 `appDelegate.m` 파일에서 다음 메소드를 구현하십시오. Swift에서는 자동 알림을 위해 서버에서 전송하는 `contentAvailable` 값은 1입니다. +``` +//For Swift + func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + let contentAPS = userInfo["aps"] as [NSObject : AnyObject] + if let contentAvailable = contentAPS["content-available"] as? Int { + //silent or mixed push + if contentAvailable == 1 { + completionHandler(UIBackgroundFetchResult.NewData) + } else { + completionHandler(UIBackgroundFetchResult.NoData) + } + } else { + //Default notification + completionHandler(UIBackgroundFetchResult.NoData) + } + } +``` + {: codeblock} + diff --git a/services/mobilepush/nl/ko/t__main_push_config_provider.md b/services/mobilepush/nl/ko/t__main_push_config_provider.md index f4eda0842..168142f58 100644 --- a/services/mobilepush/nl/ko/t__main_push_config_provider.md +++ b/services/mobilepush/nl/ko/t__main_push_config_provider.md @@ -1,21 +1,21 @@ - ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 알림 제공자에 대한 신임 정보 구성 -{: #create-push-credentials} -마지막 업데이트 날짜: 2017년 1월 18일 -{: .last-updated} - -{{site.data.keyword.mobilepushshort}} 서비스를 설정하려면 푸시 알림 제공자에서 필수 신임 정보를 얻으십시오(예: [FCM](t_push_provider_android.html)(Firebase Cloud Messaging) 또는 모바일 디바이스용 [APNs](t_push_provider_ios.html)(Apple Push Notification service)). 웹 브라우저의 경우 [웹 브라우저의 신임 정보 구성](t_push_provider_safari.html)을 참조하십시오. - -**IBM Bluemix Services** 대시보드를 사용하거나 [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 사용하여 {{site.data.keyword.mobilepushshort}}를 설정할 수 있습니다. + +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 알림 제공자에 대한 신임 정보 구성 +{: #create-push-credentials} +마지막 업데이트 날짜: 2017년 1월 18일 +{: .last-updated} + +{{site.data.keyword.mobilepushshort}} 서비스를 설정하려면 푸시 알림 제공자에서 필수 신임 정보를 얻으십시오(예: [FCM](t_push_provider_android.html)(Firebase Cloud Messaging) 또는 모바일 디바이스용 [APNs](t_push_provider_ios.html)(Apple Push Notification service)). 웹 브라우저의 경우 [웹 브라우저의 신임 정보 구성](t_push_provider_safari.html)을 참조하십시오. + +**IBM Bluemix Services** 대시보드를 사용하거나 [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 사용하여 {{site.data.keyword.mobilepushshort}}를 설정할 수 있습니다. diff --git a/services/mobilepush/nl/ko/t_advance_badge_sound_payload.md b/services/mobilepush/nl/ko/t_advance_badge_sound_payload.md index a5c48d23b..8743a6e3c 100644 --- a/services/mobilepush/nl/ko/t_advance_badge_sound_payload.md +++ b/services/mobilepush/nl/ko/t_advance_badge_sound_payload.md @@ -1,77 +1,77 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#고급 {{site.data.keyword.mobilepushshort}} 사용 -마지막 업데이트 날짜: 2017년 1월 23일 -{: .last-updated} - -iOS 배지, 사운드, 추가 JSON 페이로드, 조치 가능 알림, 보류 알림을 구성합니다. - -## 사운드, 페이로드 및 iOS 배지 구성 -{: #badge-sound-payload} - -iOS 배지, 사운드 및 추가적인 JSON 페이로드를 구성합니다. - -1. {{site.data.keyword.mobilepushshort}} 대시보드에서 **알림** 탭으로 이동하십시오. -2. **선택적 필드** 섹션으로 이동하여 다음과 같이 {{site.data.keyword.mobilepushshort}} 기능을 구성하십시오. - - **사운드 파일** - 모바일 앱의 사운드 파일을 가리키는 문자열을 입력하십시오. 페이로드에서 사용할 사운드 파일의 문자열 이름을 지정하십시오. - - **iOS 배지** - iOS 디바이스의 경우 앱 아이콘의 배지로 표시할 숫자입니다. 이 특성을 비워두면 배지가 변경되지 않습니다. 배지를 제거하려면 이 특성의 값을 0으로 설정하십시오. - -###Android - -Android 애플리케이션의 `res/raw` 디렉토리에 사운드 파일을 추가하십시오. 알림을 전송하는 동안 {{site.data.keyword.mobilepushshort}}의 사운드 필드에 사운드 파일 이름을 추가하십시오. - -``` -"settings":{ - "gcm":{ - "sound":"tt.wav", - } - } -``` - {: codeblock} - -###iOS - -``` -"settings": { - "apns" : { - "badge": 10, - "sound": "tt.wav", - } - } -``` - {: codeblock} - -**추가 페이로드** - 이 페이로드는 키-값 쌍이며 {{site.data.keyword.mobilepushshort}}를 사용하여 전송하려는 JSON 오브젝트여야 합니다. - -``` -{"key":"value", "key2":"value2"} -``` - {: codeblock} - -## Android 알림 보류 -{: #hold-notifications-android} - -애플리케이션이 백그라운드로 전환되는 경우 {{site.data.keyword.mobilepushshort}}에서 애플리케이션에 전송되는 알림을 보류할 수 있습니다. 알림을 보류하려면 {{site.data.keyword.mobilepushshort}}를 처리하는 활동의 onPause() 메소드에서 hold() 메소드를 호출하십시오. - -``` -@Override -protected void onPause() { -super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 고급 {{site.data.keyword.mobilepushshort}} 사용 +마지막 업데이트 날짜: 2017년 1월 23일 +{: .last-updated} + +iOS 배지, 사운드, 추가 JSON 페이로드, 조치 가능 알림, 보류 알림을 구성합니다. + +## 사운드, 페이로드 및 iOS 배지 구성 +{: #badge-sound-payload} + +iOS 배지, 사운드 및 추가적인 JSON 페이로드를 구성합니다. + +1. {{site.data.keyword.mobilepushshort}} 대시보드에서 **알림** 탭으로 이동하십시오. +2. **선택적 필드** 섹션으로 이동하여 다음과 같이 {{site.data.keyword.mobilepushshort}} 기능을 구성하십시오. + - **사운드 파일** - 모바일 앱의 사운드 파일을 가리키는 문자열을 입력하십시오. 페이로드에서 사용할 사운드 파일의 문자열 이름을 지정하십시오. + - **iOS 배지** - iOS 디바이스의 경우 앱 아이콘의 배지로 표시할 숫자입니다. 이 특성을 비워두면 배지가 변경되지 않습니다. 배지를 제거하려면 이 특성의 값을 0으로 설정하십시오. + +### Android + +Android 애플리케이션의 `res/raw` 디렉토리에 사운드 파일을 추가하십시오. 알림을 전송하는 동안 {{site.data.keyword.mobilepushshort}}의 사운드 필드에 사운드 파일 이름을 추가하십시오. + +``` +"settings":{ + "gcm":{ + "sound":"tt.wav", + } + } +``` + {: codeblock} + +### iOS + +``` +"settings": { + "apns" : { + "badge": 10, + "sound": "tt.wav", + } + } +``` + {: codeblock} + +**추가 페이로드** - 이 페이로드는 키-값 쌍이며 {{site.data.keyword.mobilepushshort}}를 사용하여 전송하려는 JSON 오브젝트여야 합니다. + +``` +{"key":"value", "key2":"value2"} +``` + {: codeblock} + +## Android 알림 보류 +{: #hold-notifications-android} + +애플리케이션이 백그라운드로 전환되는 경우 {{site.data.keyword.mobilepushshort}}에서 애플리케이션에 전송되는 알림을 보류할 수 있습니다. 알림을 보류하려면 {{site.data.keyword.mobilepushshort}}를 처리하는 활동의 onPause() 메소드에서 hold() 메소드를 호출하십시오. + +``` +@Override +protected void onPause() { +super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} + + diff --git a/services/mobilepush/nl/ko/t_android_create_unbound_service.md b/services/mobilepush/nl/ko/t_android_create_unbound_service.md index 481fc6330..25615b0c0 100644 --- a/services/mobilepush/nl/ko/t_android_create_unbound_service.md +++ b/services/mobilepush/nl/ko/t_android_create_unbound_service.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 바인딩하지 않은 Android용 {{site.data.keyword.mobilepushshort}} 서비스 작성 -{: #create_android_unbound} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - -{{site.data.keyword.mobilepushshort}} 서비스 인스턴스를 작성하십시오. 백엔드 애플리케이션에 바인드하지 않아도 {{site.data.keyword.mobilepushshort}} 서비스 인스턴스를 사용할 수 있습니다. - -1. {{site.data.keyword.mobilepushshort}} 서비스 인스턴스를 Bluemix 애플리케이션에 바인드하십시오. 바인딩 시 서비스와 관련된 모든 세부사항이 JSON 형식으로 VCAP_SERVICES 환경 변수에 저장됨을 확인할 수 있습니다. - -![푸시 알림 서비스 바인딩](images/unbound_1.jpg) - 2. **바인드**를 클릭하고 바인드할 {{site.data.keyword.mobilepushshort}} 서비스 인스턴스를 선택하십시오. 애플리케이션이 {{site.data.keyword.mobilepushshort}} 서비스에 바인드되면 서비스에 대한 정보가 JSON 형식으로 앱의 VCAP_SERVICES 환경 변수에 저장됩니다. 예: -``` - { - "imfpush_Dev": [ - { - "name": "myname_sampleUnbound", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": null - } - ] - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 바인딩하지 않은 Android용 {{site.data.keyword.mobilepushshort}} 서비스 작성 +{: #create_android_unbound} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + +{{site.data.keyword.mobilepushshort}} 서비스 인스턴스를 작성하십시오. 백엔드 애플리케이션에 바인드하지 않아도 {{site.data.keyword.mobilepushshort}} 서비스 인스턴스를 사용할 수 있습니다. + +1. {{site.data.keyword.mobilepushshort}} 서비스 인스턴스를 Bluemix 애플리케이션에 바인드하십시오. 바인딩 시 서비스와 관련된 모든 세부사항이 JSON 형식으로 VCAP_SERVICES 환경 변수에 저장됨을 확인할 수 있습니다. + +![푸시 알림 서비스 바인딩](images/unbound_1.jpg) + 2. **바인드**를 클릭하고 바인드할 {{site.data.keyword.mobilepushshort}} 서비스 인스턴스를 선택하십시오. 애플리케이션이 {{site.data.keyword.mobilepushshort}} 서비스에 바인드되면 서비스에 대한 정보가 JSON 형식으로 앱의 VCAP_SERVICES 환경 변수에 저장됩니다. 예: +``` + { + "imfpush_Dev": [ + { + "name": "myname_sampleUnbound", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": null + } + ] + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/ko/t_android_initialize.md b/services/mobilepush/nl/ko/t_android_initialize.md index 2896a956c..3c006cce9 100644 --- a/services/mobilepush/nl/ko/t_android_initialize.md +++ b/services/mobilepush/nl/ko/t_android_initialize.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Android 앱을 위한 푸시 SDK 초기화 -{: #android_initialize} - -초기화 코드를 배치하는 공통 위치는 Android 애플리케이션에서 기본 활동의 onCreate 메소드입니다. - -Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 애플리케이션 GUID를 확보하십시오. 라우트 및 앱 GUID에 이러한 값을 사용하십시오. Bluemix 앱 appRoute 및 appGUID 매개변수를 사용하려면 코드 스니펫을 수정하십시오. - - -##Core SDK 초기화 - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -Bluemix에서 생성한 서버 애플리케이션에 지정된 라우트를 지정합니다. - -**AppGUID** - -Bluemix에서 생성한 애플리케이션에 지정된 고유 키를 지정합니다. 이 값은 대소문자를 구분합니다. - -**bluemixRegionSuffix** - -앱이 호스트된 위치를 지정합니다. 다음 값 중 하나를 사용할 수 있습니다. - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##클라이언트 푸시 SDK 초기화 - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Android 앱을 위한 푸시 SDK 초기화 +{: #android_initialize} + +초기화 코드를 배치하는 공통 위치는 Android 애플리케이션에서 기본 활동의 onCreate 메소드입니다. + +Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 애플리케이션 GUID를 확보하십시오. 라우트 및 앱 GUID에 이러한 값을 사용하십시오. Bluemix 앱 appRoute 및 appGUID 매개변수를 사용하려면 코드 스니펫을 수정하십시오. + + +## Core SDK 초기화 + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +Bluemix에서 생성한 서버 애플리케이션에 지정된 라우트를 지정합니다. + +**AppGUID** + +Bluemix에서 생성한 애플리케이션에 지정된 고유 키를 지정합니다. 이 값은 대소문자를 구분합니다. + +**bluemixRegionSuffix** + +앱이 호스트된 위치를 지정합니다. 다음 값 중 하나를 사용할 수 있습니다. + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +## 클라이언트 푸시 SDK 초기화 + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` diff --git a/services/mobilepush/nl/ko/t_android_install_sdk.md b/services/mobilepush/nl/ko/t_android_install_sdk.md index be69917ac..e766e2c2b 100644 --- a/services/mobilepush/nl/ko/t_android_install_sdk.md +++ b/services/mobilepush/nl/ko/t_android_install_sdk.md @@ -1,216 +1,216 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Gradle을 사용하여 클라이언트 푸시 SDK 설치 -{: #android_install} - -이 섹션에서는 클라이언트 푸시 SDK를 설치하고 이를 사용하여 추가적으로 Android 애플리케이션을 개발하는 방법에 대해 설명합니다. - -Gradle을 사용하여 Bluemix® 모바일 서비스 푸시 SDK를 추가할 수 있습니다. Gradle은 저장소에서 아티팩트를 자동으로 다운로드하여 Android 애플리케이션에 제공합니다. Android Studio 및 Android Studio SDK를 올바로 설정해야 합니다. 시스템 설정 방법에 대한 자세한 정보는 [Android Studio 개요](https://developer.android.com/tools/studio/index.html)를 참조하십시오. Gradle에 대한 자세한 정보는 [Gradle 빌드 구성](http://developer.android.com/tools/building/configuring-gradle.html)을 참조하십시오. - -1. Android Studio에서 모바일 애플리케이션을 작성하고 연 다음에 애플리케이션 **build.gradle** 파일을 여십시오. 다음 종속 항목을 모바일 애플리케이션에 추가하십시오. 이러한 import 문은 코드 스니펫에 필요합니다. - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - - -1. 다음 종속 항목을 모바일 애플리케이션에 추가하십시오. 다음 행이 Bluemix™ Mobile Services Push 클라이언트 SDK 및 Google 플레이 서비스 SDK를 사용자의 컴파일 범위 종속 항목에 추가합니다. - - ``` - dependencies { - compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' -compile 'com.google.android.gms:play-services:7.8.0' -} - ``` -1. **AndroidManifest.xml** 파일에서 다음 권한을 추가하십시오. 샘플 Manifest를 보려면 [Android helloPush 샘플 애플리케이션](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml)을 참조하십시오. 샘플 Gradle 파일을 보려면 [샘플 빌드 Gradle 파일](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle)을 참조하십시오. - - ``` - - - - - - - - -``` - - 여기에서 [Android 권한](http://developer.android.com/guide/topics/security/permissions.html)에 대한 정보를 볼 수 있습니다. - -1. 활동에 대한 알림 의도 설정을 추가하십시오. 사용자가 알림 영역에서 수신한 알림을 클릭할 경우 이 설정을 통해 애플리케이션이 시작됩니다. - - ``` - - - - - ``` - **참고**: 위의 조치에서 *Your_Android_Package_Name*을 사용자 애플리케이션에서 사용되는 애플리케이션 패키지 이름으로 대체하십시오. - -1. GCM(Google Cloud Messaging) 의도 서비스 및 RECEIVE 이벤트 알림에 대한 의도 필터를 추가하십시오. - - ``` - service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> - - - - - - - - - - - - - - ``` - - - -# Android 앱을 위한 푸시 SDK 초기화 -{: #android_initialize} - -초기화 코드를 배치하는 공통 위치는 Android 애플리케이션에서 기본 활동의 onCreate 메소드입니다. - -Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 애플리케이션 GUID를 확보하십시오. 라우트 및 앱 GUID에 이러한 값을 사용하십시오. Bluemix 앱 appRoute 및 appGUID 매개변수를 사용하려면 코드 스니펫을 수정하십시오. - - -##Core SDK 초기화 - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -Bluemix에서 생성한 서버 애플리케이션에 지정된 라우트를 지정합니다. - -**AppGUID** - -Bluemix에서 생성한 애플리케이션에 지정된 고유 키를 지정합니다. 이 값은 대소문자를 구분합니다. - -**bluemixRegionSuffix** - -앱이 호스트된 위치를 지정합니다. 다음 값 중 하나를 사용할 수 있습니다. - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##클라이언트 푸시 SDK 초기화 - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` - - - -# Android 디바이스 등록 -{: #android_register} - -`IMFPush.register()` API를 사용하여 디바이스를 푸시 알림 서비스에 등록할 수 있습니다. Android 디바이스의 등록인 경우, 우선 Bluemix 푸시 서비스 구성 대시보드에서 GCM(Google Cloud Messaging) 정보를 추가하십시오. 자세한 정보는 [GCM(Google Cloud Messaging)의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. - -다음 코드 스니펫을 복사하여 Android 모바일 애플리케이션에 붙여넣으십시오. - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` - - - -# Android 디바이스에서 푸시 알림 수신 -{: #android_receive} - -notificationListener 오브젝트를 푸시에 등록하려면 **MFPPush.listen()** 메소드를 호출하십시오. 푸시 알림을 처리하는 활동의 **onResume()** 메소드에서 일반적으로 이 메소드가 호출됩니다. - -1. notificationListener 오브젝트를 푸시에 등록하려면 **listen()** 메소드를 호출하십시오. 푸시 알림을 처리하는 활동의 **onResume()** 메소드에서 일반적으로 이 메소드가 호출됩니다. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } - ``` -2. 프로젝트를 빌드하고 디바이스 또는 에뮬레이터에서 이를 실행하십시오. register() 메소드의 응답 리스너에 대해 onSuccess() 메소드가 호출되면 디바이스가 푸시 알림 서비스에 정상적으로 푸시에 등록된 것입니다. 이 때 기본 푸시 알림 전송에 설명된 대로 메시지를 보낼 수 있습니다. -3. 디바이스가 알림을 수신했는지 확인하십시오. 애플리케이션이 포그라운드에 있는 경우 **MFPPushNotificationListener**에 의해 알림이 처리됩니다. 애플리케이션이 백그라운드에 있는 경우 알림 막대에 메시지가 표시됩니다. - - - - -# 기본 푸시 알림 전송 - -{: #push-send-notifications} - -애플리케이션이 개발된 후에는 (태그, 배지, 추가 페이로드 또는 사운드 파일을 사용하지 않아도) 기본 푸시 알림을 전송할 수 있습니다. - - -기본 푸시 알림을 전송하십시오. - -1. **청취자 선택**에서 다음 청취자 중 하나를 선택하십시오. **모든 디바이스** 또는 플랫폼 기준으로 **iOS 디바이스만** 또는 **Anroid 디바이스만**. - - **참고**: **모든 디바이스** 옵션을 선택하는 경우 푸시 알림에 등록된 모든 디바이스는 알림을 수신합니다. - - ![알림 화면](images/tag_notification.jpg) - -2. **알림 작성**에서 메시지를 입력한 후 **전송**을 클릭하십시오. -3. 디바이스가 알림을 수신했는지 확인하십시오. - - 다음 스크린샷은 Android 및 iOS 디바이스의 포그라운드에서 -푸시 알림을 처리하는 경보 상자를 표시합니다. - - ![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) - - ![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) - - 다음 스크린샷은 Android의 백그라운드에 있는 푸시 알림을 보여줍니다.![Android의 백그라운드 푸시 알림](images/background.jpg) - - - -# 다음 단계 -{: #next_steps_tags} - -정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. - -이러한 푸시 알림 서비스 기능을 앱에 추가하십시오. -태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. -고급 알림 옵션을 사용하려면 [고급 푸시 알림](t_advance_notifications.html)을 참조하십시오. +--- + +copyright: + years: 2015, 2016 + +--- + +# Gradle을 사용하여 클라이언트 푸시 SDK 설치 +{: #android_install} + +이 섹션에서는 클라이언트 푸시 SDK를 설치하고 이를 사용하여 추가적으로 Android 애플리케이션을 개발하는 방법에 대해 설명합니다. + +Gradle을 사용하여 Bluemix® 모바일 서비스 푸시 SDK를 추가할 수 있습니다. Gradle은 저장소에서 아티팩트를 자동으로 다운로드하여 Android 애플리케이션에 제공합니다. Android Studio 및 Android Studio SDK를 올바로 설정해야 합니다. 시스템 설정 방법에 대한 자세한 정보는 [Android Studio 개요](https://developer.android.com/tools/studio/index.html)를 참조하십시오. Gradle에 대한 자세한 정보는 [Gradle 빌드 구성](http://developer.android.com/tools/building/configuring-gradle.html)을 참조하십시오. + +1. Android Studio에서 모바일 애플리케이션을 작성하고 연 다음에 애플리케이션 **build.gradle** 파일을 여십시오. 다음 종속 항목을 모바일 애플리케이션에 추가하십시오. 이러한 import 문은 코드 스니펫에 필요합니다. + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + + +1. 다음 종속 항목을 모바일 애플리케이션에 추가하십시오. 다음 행이 Bluemix™ Mobile Services Push 클라이언트 SDK 및 Google 플레이 서비스 SDK를 사용자의 컴파일 범위 종속 항목에 추가합니다. + + ``` + dependencies { + compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' +compile 'com.google.android.gms:play-services:7.8.0' +} + ``` +1. **AndroidManifest.xml** 파일에서 다음 권한을 추가하십시오. 샘플 Manifest를 보려면 [Android helloPush 샘플 애플리케이션](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml)을 참조하십시오. 샘플 Gradle 파일을 보려면 [샘플 빌드 Gradle 파일](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle)을 참조하십시오. + + ``` + + + + + + + + +``` + + 여기에서 [Android 권한](http://developer.android.com/guide/topics/security/permissions.html)에 대한 정보를 볼 수 있습니다. + +1. 활동에 대한 알림 의도 설정을 추가하십시오. 사용자가 알림 영역에서 수신한 알림을 클릭할 경우 이 설정을 통해 애플리케이션이 시작됩니다. + + ``` + + + + + ``` + **참고**: 위의 조치에서 *Your_Android_Package_Name*을 사용자 애플리케이션에서 사용되는 애플리케이션 패키지 이름으로 대체하십시오. + +1. GCM(Google Cloud Messaging) 의도 서비스 및 RECEIVE 이벤트 알림에 대한 의도 필터를 추가하십시오. + + ``` + service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> + + + + + + + + + + + + + + ``` + + + +# Android 앱을 위한 푸시 SDK 초기화 +{: #android_initialize} + +초기화 코드를 배치하는 공통 위치는 Android 애플리케이션에서 기본 활동의 onCreate 메소드입니다. + +Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 애플리케이션 GUID를 확보하십시오. 라우트 및 앱 GUID에 이러한 값을 사용하십시오. Bluemix 앱 appRoute 및 appGUID 매개변수를 사용하려면 코드 스니펫을 수정하십시오. + + +##Core SDK 초기화 + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +Bluemix에서 생성한 서버 애플리케이션에 지정된 라우트를 지정합니다. + +**AppGUID** + +Bluemix에서 생성한 애플리케이션에 지정된 고유 키를 지정합니다. 이 값은 대소문자를 구분합니다. + +**bluemixRegionSuffix** + +앱이 호스트된 위치를 지정합니다. 다음 값 중 하나를 사용할 수 있습니다. + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +##클라이언트 푸시 SDK 초기화 + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` + + + +# Android 디바이스 등록 +{: #android_register} + +`IMFPush.register()` API를 사용하여 디바이스를 푸시 알림 서비스에 등록할 수 있습니다. Android 디바이스의 등록인 경우, 우선 Bluemix 푸시 서비스 구성 대시보드에서 GCM(Google Cloud Messaging) 정보를 추가하십시오. 자세한 정보는 [GCM(Google Cloud Messaging)의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. + +다음 코드 스니펫을 복사하여 Android 모바일 애플리케이션에 붙여넣으십시오. + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` + + + +# Android 디바이스에서 푸시 알림 수신 +{: #android_receive} + +notificationListener 오브젝트를 푸시에 등록하려면 **MFPPush.listen()** 메소드를 호출하십시오. 푸시 알림을 처리하는 활동의 **onResume()** 메소드에서 일반적으로 이 메소드가 호출됩니다. + +1. notificationListener 오브젝트를 푸시에 등록하려면 **listen()** 메소드를 호출하십시오. 푸시 알림을 처리하는 활동의 **onResume()** 메소드에서 일반적으로 이 메소드가 호출됩니다. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } + ``` +2. 프로젝트를 빌드하고 디바이스 또는 에뮬레이터에서 이를 실행하십시오. register() 메소드의 응답 리스너에 대해 onSuccess() 메소드가 호출되면 디바이스가 푸시 알림 서비스에 정상적으로 푸시에 등록된 것입니다. 이 때 기본 푸시 알림 전송에 설명된 대로 메시지를 보낼 수 있습니다. +3. 디바이스가 알림을 수신했는지 확인하십시오. 애플리케이션이 포그라운드에 있는 경우 **MFPPushNotificationListener**에 의해 알림이 처리됩니다. 애플리케이션이 백그라운드에 있는 경우 알림 막대에 메시지가 표시됩니다. + + + + +# 기본 푸시 알림 전송 + +{: #push-send-notifications} + +애플리케이션이 개발된 후에는 (태그, 배지, 추가 페이로드 또는 사운드 파일을 사용하지 않아도) 기본 푸시 알림을 전송할 수 있습니다. + + +기본 푸시 알림을 전송하십시오. + +1. **청취자 선택**에서 다음 청취자 중 하나를 선택하십시오. **모든 디바이스** 또는 플랫폼 기준으로 **iOS 디바이스만** 또는 **Anroid 디바이스만**. + + **참고**: **모든 디바이스** 옵션을 선택하는 경우 푸시 알림에 등록된 모든 디바이스는 알림을 수신합니다. + + ![알림 화면](images/tag_notification.jpg) + +2. **알림 작성**에서 메시지를 입력한 후 **전송**을 클릭하십시오. +3. 디바이스가 알림을 수신했는지 확인하십시오. + + 다음 스크린샷은 Android 및 iOS 디바이스의 포그라운드에서 +푸시 알림을 처리하는 경보 상자를 표시합니다. + + ![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) + + ![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) + + 다음 스크린샷은 Android의 백그라운드에 있는 푸시 알림을 보여줍니다.![Android의 백그라운드 푸시 알림](images/background.jpg) + + + +# 다음 단계 +{: #next_steps_tags} + +정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. + +이러한 푸시 알림 서비스 기능을 앱에 추가하십시오. +태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. +고급 알림 옵션을 사용하려면 [고급 푸시 알림](t_advance_notifications.html)을 참조하십시오. diff --git a/services/mobilepush/nl/ko/t_android_receive.md b/services/mobilepush/nl/ko/t_android_receive.md index 144f48e22..5c6ab8a13 100644 --- a/services/mobilepush/nl/ko/t_android_receive.md +++ b/services/mobilepush/nl/ko/t_android_receive.md @@ -1,25 +1,25 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Android 디바이스에서 푸시 알림 수신 -{: #android_receive} - -notificationListener 오브젝트를 푸시에 등록하려면 **MFPPush.listen()** 메소드를 호출하십시오. 푸시 알림을 처리하는 활동의 **onResume()** 메소드에서 일반적으로 이 메소드가 호출됩니다. - -1. notificationListener 오브젝트를 푸시에 등록하려면 **listen()** 메소드를 호출하십시오. 푸시 알림을 처리하는 활동의 **onResume()** 메소드에서 일반적으로 이 메소드가 호출됩니다. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` -2. 프로젝트를 빌드하고 디바이스 또는 에뮬레이터에서 이를 실행하십시오. register() 메소드의 응답 리스너에 대해 onSuccess() 메소드가 호출되면 디바이스가 푸시 알림 서비스에 정상적으로 푸시에 등록된 것입니다. 이 때 기본 푸시 알림 전송에 설명된 대로 메시지를 보낼 수 있습니다. -3. 디바이스가 알림을 수신했는지 확인하십시오. 애플리케이션이 포그라운드에 있는 경우 **MFPPushNotificationListener**에 의해 알림이 처리됩니다. 애플리케이션이 백그라운드에 있는 경우 알림 막대에 메시지가 표시됩니다. +--- + +copyright: + years: 2015, 2016 + +--- + +# Android 디바이스에서 푸시 알림 수신 +{: #android_receive} + +notificationListener 오브젝트를 푸시에 등록하려면 **MFPPush.listen()** 메소드를 호출하십시오. 푸시 알림을 처리하는 활동의 **onResume()** 메소드에서 일반적으로 이 메소드가 호출됩니다. + +1. notificationListener 오브젝트를 푸시에 등록하려면 **listen()** 메소드를 호출하십시오. 푸시 알림을 처리하는 활동의 **onResume()** 메소드에서 일반적으로 이 메소드가 호출됩니다. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` +2. 프로젝트를 빌드하고 디바이스 또는 에뮬레이터에서 이를 실행하십시오. register() 메소드의 응답 리스너에 대해 onSuccess() 메소드가 호출되면 디바이스가 푸시 알림 서비스에 정상적으로 푸시에 등록된 것입니다. 이 때 기본 푸시 알림 전송에 설명된 대로 메시지를 보낼 수 있습니다. +3. 디바이스가 알림을 수신했는지 확인하십시오. 애플리케이션이 포그라운드에 있는 경우 **MFPPushNotificationListener**에 의해 알림이 처리됩니다. 애플리케이션이 백그라운드에 있는 경우 알림 막대에 메시지가 표시됩니다. diff --git a/services/mobilepush/nl/ko/t_android_register.md b/services/mobilepush/nl/ko/t_android_register.md index 03c348af8..af5365a73 100644 --- a/services/mobilepush/nl/ko/t_android_register.md +++ b/services/mobilepush/nl/ko/t_android_register.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Android 디바이스 등록 -{: #android_register} - -`IMFPush.register()` API를 사용하여 디바이스를 푸시 알림 서비스에 등록할 수 있습니다. Android 디바이스의 등록인 경우, 우선 Bluemix 푸시 서비스 구성 대시보드에서 GCM(Google Cloud Messaging) 정보를 추가하십시오. 자세한 정보는 [GCM(Google Cloud Messaging)의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. - -다음 코드 스니펫을 복사하여 Android 모바일 애플리케이션에 붙여넣으십시오. - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Android 디바이스 등록 +{: #android_register} + +`IMFPush.register()` API를 사용하여 디바이스를 푸시 알림 서비스에 등록할 수 있습니다. Android 디바이스의 등록인 경우, 우선 Bluemix 푸시 서비스 구성 대시보드에서 GCM(Google Cloud Messaging) 정보를 추가하십시오. 자세한 정보는 [GCM(Google Cloud Messaging)의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. + +다음 코드 스니펫을 복사하여 Android 모바일 애플리케이션에 붙여넣으십시오. + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` diff --git a/services/mobilepush/nl/ko/t_cordova_initialize.md b/services/mobilepush/nl/ko/t_cordova_initialize.md index 7d4ef5148..f98ea7d6a 100644 --- a/services/mobilepush/nl/ko/t_cordova_initialize.md +++ b/services/mobilepush/nl/ko/t_cordova_initialize.md @@ -1,31 +1,31 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} - -# Cordova 플러그인 초기화 -{: #cordova_enable} - -푸시 알림 서비스 Cordova 플러그인을 사용할 수 있으려면 애플리케이션 라우트와 애플리케이션 GUID를 전달하여 플러그인을 초기화해야 합니다. 플러그인을 초기화한 후 Bluemix 대시보드에서 작성한 서버 앱에 연결할 수 있습니다. Cordova 플러그인은 Cordova 앱이 Bluemix 서비스와 통신할 수 있도록 해주는 Android 및 iOS 클라이언트 SDK용 랩퍼입니다. - -1. 다음 코드 스니펫을 복사하여 기본 JavaScript 파일(일반적으로 **www/js** 디렉토리 아래에 있음)에 붙여넣어 BMSClient를 초기화하십시오. - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Bluemix Route 및 appGUID 매개변수를 사용하려면 코드 스니펫을 수정하십시오. Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 애플리케이션 GUID를 확보하십시오. `BMSClient.initialize` 코드 스니펫에서 라우트 및 앱 GUID 값을 매개변수로 사용하십시오. - - - **참고**: Cordova CLI(예: Cordova create app-name 명령)를 사용하여 Cordova 앱을 작성한 경우 이 Javascript 코드를 **index.js** 파일에서 `onDeviceReady: function()` 함수의 `app.receivedEvent` 함수 뒤에 넣어서 BMS 클라이언트를 초기화하십시오. - - ``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` -1. 다음 단계. [디바이스를 등록하십시오.](t_cordova_register.html) +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} + +# Cordova 플러그인 초기화 +{: #cordova_enable} + +푸시 알림 서비스 Cordova 플러그인을 사용할 수 있으려면 애플리케이션 라우트와 애플리케이션 GUID를 전달하여 플러그인을 초기화해야 합니다. 플러그인을 초기화한 후 Bluemix 대시보드에서 작성한 서버 앱에 연결할 수 있습니다. Cordova 플러그인은 Cordova 앱이 Bluemix 서비스와 통신할 수 있도록 해주는 Android 및 iOS 클라이언트 SDK용 랩퍼입니다. + +1. 다음 코드 스니펫을 복사하여 기본 JavaScript 파일(일반적으로 **www/js** 디렉토리 아래에 있음)에 붙여넣어 BMSClient를 초기화하십시오. + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Bluemix Route 및 appGUID 매개변수를 사용하려면 코드 스니펫을 수정하십시오. Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 애플리케이션 GUID를 확보하십시오. `BMSClient.initialize` 코드 스니펫에서 라우트 및 앱 GUID 값을 매개변수로 사용하십시오. + + + **참고**: Cordova CLI(예: Cordova create app-name 명령)를 사용하여 Cordova 앱을 작성한 경우 이 Javascript 코드를 **index.js** 파일에서 `onDeviceReady: function()` 함수의 `app.receivedEvent` 함수 뒤에 넣어서 BMS 클라이언트를 초기화하십시오. + + ``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` +1. 다음 단계. [디바이스를 등록하십시오.](t_cordova_register.html) diff --git a/services/mobilepush/nl/ko/t_cordova_install.md b/services/mobilepush/nl/ko/t_cordova_install.md index f823b6bd3..fab48a01e 100644 --- a/services/mobilepush/nl/ko/t_cordova_install.md +++ b/services/mobilepush/nl/ko/t_cordova_install.md @@ -1,374 +1,374 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Cordova 푸시 플러그인 설치 -{: #cordova_install} - -클라이언트 푸시 플러그인을 설치하고 이를 사용하여 추가적으로 Cordova 애플리케이션을 개발할 수 있습니다. 이 때 사용자와 Bluemix의 연결을 초기화하는 Cordova 코어 플러그인도 설치됩니다. - -### 시작하기 전에 - -1. 최신 Android Studio SDK 및 Xcode 버전을 다운로드하십시오. -1. 에뮬레이터를 설정하십시오. Android Studio의 경우 Google Play API를 지원하는 에뮬레이터를 사용하십시오. -1. Git 명령행 도구를 설치하십시오. Windows의 경우 **Window 명령 프롬프트에서 Git 실행** 옵션을 선택하십시오. 이 도구의 다운로드 및 설치에 대한 정보는 [Git](https://git-scm.com/downloads)을 참조하십시오. - -1. Node.js 및 NPM(Node Package Manager) 도구를 설치하십시오. NPM 명령행 도구는 Node.js와 함께 번들로 제공됩니다. Node.js를 다운로드하고 설치하는 방법에 대한 정보는 [Node.js](https://nodejs.org/en/download/)를 참조하십시오. -1. 명령행에서 **npm install -g cordova** 명령을 사용하여 Cordova 명령행 도구를 설치하십시오. Cordova 푸시 플러그인을 사용하려면 필요합니다. Cordova 설치 및 Cordova 앱 설정 정보를 보려면 [Cordova Apache](https://cordova.apache.org/#getstarted)를 참조하십시오. - - **참고**: Cordova 푸시 플러그인 Readme 파일을 보려면 [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push)로 이동하십시오. - - -## Cordova 푸시 플러그인 설치 -1. Cordova 앱을 작성하려는 폴더로 변경하고 다음 명령을 실행하여 Cordova 애플리케이션을 작성하십시오. 기존의 Cordova 앱이 있을 경우 3단계로 가십시오. - -``` -cordova create your_app_name -cd your_app_name -``` -1. 선택사항: **config.xml** 파일을 편집하고 요소에서 애플리케이션 이름을 기본값인 HelloCordova 이름 대신 원하는 이름으로 변경하십시오. - - **참고**: 올바른 번들 ID를 지정하십시오. 그렇지 않은 경우 다음 오류 메시지가 Xcode에 표시됩니다. - * 실행 파일이 올바르지 않은 인타이틀먼트로 서명되었습니다. - * 애플리케이션의 코드 서명 인타이틀먼트에 지정된 인타이틀먼트가 프로비저닝 프로파일에 지정된 인타이틀먼트와 일치하지 않습니다. - - 이 문제를 수정하려면 Xcode 또는 Cordova 앱 **config.xml** 파일에서 올바른 번들 ID를 지정하십시오. - -1. Corova 애플리케이션의 config.xml 파일에 최소 지원 API 또는 배치 대상 선언을 추가하십시오. minSdkVersion 값은 15보다 커야 합니다. targetSdkVersion 값은 항상 Google을 통해 제공받을 수 있는 최신 Android SDK를 반영해야 합니다. - * **Android** - 편집기를 사용하여 config.xml 파일을 열고, 최소 대상 SDK 버전으로 `` 요소를 업데이트하십시오. - - ``` - - - - - - ``` - * **iOS** - 배치 대상 선언으로 요소를 업데이트하십시오. - - ``` - - - - - ``` - -1. Cordova 명령행 인터페이스(CLI)에서 다음 명령을 사용하여 플랫폼(iOS, Android 또는 둘 다)을 추가하십시오. - - ``` - cordova platform add ios@3.9.0 - cordova platform add android - ``` -1. Cordova 애플리케이션 루트 디렉토리에서 다음 명령을 입력하여 Cordova 푸시 플러그인을 설치하십시오. **cordova plugin add ibm-mfp-push** - - 추가한 플랫폼에 따라 다음과 유사하게 표시됩니다. - - ``` - Installing "ibm-mfp-push" for android - Installing "ibm-mfp-push" for ios - ``` -1. *your-app-root-folder*에서 다음 명령을 사용하여 Cordova 코어 및 푸시 플러그인이 정상적으로 설치되었는지 확인하십시오. **cordova plugin list** - - 추가한 플랫폼에 따라 다음과 유사하게 표시됩니다. - - ``` - ibm-mfp-core 1.0.0 "MFPCore" - ibm-mfp-push 1.0.0 “MFPPush" - ``` -1. (iOS만 해당) - iOS 개발 환경을 구성하십시오. - a. Xcode가 있는 *your-app-name***/platforms/ios** 디렉토리에서 your-app-name.xcodeproj 파일을 여십시오. - - b. 브릿지 헤더를 추가하십시오. **빌드 설정 > Swift 컴파일러 - 코드 생성 > Objective-C 브릿지 헤더**로 이동하여 다음 경로를 추가하십시오. *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - c. 프레임워크 매개변수를 추가하십시오. **빌드 설정 > 링크 > Runpath 검색 경로**로 이동하여 다음 매개변수를 추가하십시오. - - ``` - @executable_path/Frameworks - ``` - d. 브릿지 헤더에서 다음 푸시 가져오기 명령을 주석 해제하십시오. *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h**로 이동하십시오. - - ``` - //#import - //#import - //#import - ``` - e. Xcode를 사용하여 애플리케이션을 빌드하고 실행하십시오. -1. (Android만 해당) - 다음 명령을 사용하여 Android 프로젝트를 빌드하십시오. -**cordova build android**. - - **참고**: Android Studio에서 프로젝트를 열기 전에 먼저 Cordova CLI를 통해 Cordova 애플리케이션을 빌드해야 합니다. 그렇지 않으면 빌드 오류가 발생합니다. - - -# Cordova 플러그인 초기화 -{: #cordova_initialize} - -푸시 알림 서비스 Cordova 플러그인을 사용할 수 있으려면 애플리케이션 라우트와 애플리케이션 GUID를 전달하여 플러그인을 초기화해야 합니다. 플러그인을 초기화한 후 Bluemix 대시보드에서 작성한 서버 앱에 연결할 수 있습니다. Cordova 플러그인은 Cordova 앱이 Bluemix 서비스와 통신할 수 있도록 해주는 Android 및 iOS 클라이언트 SDK용 랩퍼입니다. - -1. 다음 코드 스니펫을 복사하여 기본 JavaScript 파일(일반적으로 **www/js** 디렉토리 아래에 있음)에 붙여넣어 BMSClient를 초기화하십시오. - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Bluemix Route 및 appGUID 매개변수를 사용하려면 코드 스니펫을 수정하십시오. Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 애플리케이션 GUID를 확보하십시오. `BMSClient.initialize` 코드 스니펫에서 라우트 및 앱 GUID 값을 매개변수로 사용하십시오. - - **참고**: Cordova CLI(예: Cordova create app-name 명령)를 사용하여 Cordova 앱을 작성한 경우 이 Javascript 코드를 **index.js** 파일에서 `onDeviceReady: function()` 함수의 `app.receivedEvent` 함수 뒤에 넣어서 BMS 클라이언트를 초기화하십시오. - -``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` - -# 디바이스 등록 - -{: #cordova_register} - -디바이스를 푸시 알림 서비스에 등록하려면 등록 메소드를 호출하십시오. - -디바이스를 등록하려면 다음 코드 스니펫을 복사하여 Cordova 애플리케이션에 붙여넣으십시오. - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android에서는 이 설정 매개변수를 사용하지 않습니다. Android 앱만 빌드할 경우에는 공백 오브젝트를 전달하십시오. 예를 들어 다음과 같습니다. - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -경보, 배지 및 사운드 특성을 사용자 정의하려면 다음의 JavaScript 코드 스니펫을 Cordova 애플리케이션의 웹 파트에 추가하십시오. - -``` - var settings = { -ios: { -alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -JSON.parse를 사용하여 Javascript에서 성공 응답 매개변수의 컨텐츠에 액세스할 수 있습니다. -**var token = JSON.parse(response).token** - - -사용 가능한 키는 다음과 같습니다. `token`, `userId`, `deviceId`. - -다음 JavaScript 코드 스니펫은 Bluemix Mobile Services 클라이언트 SDK를 초기화하고, 푸시 알림 서비스를 사용하여 디바이스를 등록하고, 푸시 알림을 청취하는 방법을 보여줍니다. 이 코드를 Javascript 파일에 넣으십시오. - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -**onDeviceReady: function()**에서 다음을 수행하십시오. - -``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { -alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification);} -``` - -## Objective-C -{: #cordova_register_objective} -다음의 Objective-C 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##다음 단계 - -{: #cordova_register_next} - -1. 프로젝트를 빌드하고 다음 명령을 사용하여 프로젝트를 실행하십시오. - - * Android - **cordova build android** 실행 후 **cordova run android** 실행 - - * iOS - **cordova build ios** 실행 후 **cordova run ios** 실행 - - - -# 디바이스에서 푸시 알림 수신 -{: #cordova_receive} - -디바이스에서 푸시 알림을 수신하려면 다음 코드 스니펫을 복사하여 붙여넣으십시오. - -##JavaScript - -다음의 JavaScript 코드 스니펫을 Cordova 애플리케이션의 웹 파트에 추가하십시오. - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Android 알림 특성 - -다음 섹션에는 Android 알림 특성이 나열되어 있습니다. - -* 메시지 - 푸시 알림 메시지 -* 페이로드 - 알림 페이로드를 포함하는 JSON 오브젝트 - - -##iOS 알림 특성 - -다음 섹션에는 iOS 알림 특성이 나열되어 있습니다. - -* 메시지 - 푸시 알림 메시지 -* 페이로드 - 알림 페이로드를 포함한 JSON 오브젝트 -action-loc-key - 문자열은 "보기" 대신 오른쪽 단추의 제목에 사용할 현재 로컬라이제이션의 현지화된 문자열을 가져오기 위한 키로 사용됩니다. -* 배지 - 앱 아이콘의 배지로 표시할 숫자입니다. 이 특성을 비워두면 배지가 변경되지 않습니다. 배지를 제거하려면 이 특성의 값을 0으로 설정하십시오. -* 사운드 - 앱 번들 또는 앱 데이터 컨테이너의 라이브러리/사운드 폴더에 있는 사운드 파일의 이름입니다. - -##Objective-C - -다음의 Objective-C 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` - - - -# 기본 푸시 알림 전송 -{: #push-send-notifications} - -애플리케이션이 개발된 후에는 (태그, 배지, 추가 페이로드 또는 사운드 파일을 사용하지 않아도) 기본 푸시 알림을 전송할 수 있습니다. - - -기본 푸시 알림을 전송하십시오. - -1. **청취자 선택**에서 다음 청취자 중 하나를 선택하십시오. **모든 디바이스** 또는 플랫폼 기준으로 **iOS 디바이스만** 또는 **Anroid 디바이스만**. - - **참고**: **모든 디바이스** 옵션을 선택하는 경우 푸시 알림에 등록된 모든 디바이스는 알림을 수신합니다. - - ![알림 화면](images/tag_notification.jpg) - -2. **알림 작성**에서 메시지를 입력한 후 **전송**을 클릭하십시오. -3. 디바이스가 알림을 수신했는지 확인하십시오. - - 다음 스크린샷은 Android 및 iOS 디바이스의 포그라운드에서 -푸시 알림을 처리하는 경보 상자를 표시합니다. - - ![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) - - ![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) - - 다음 스크린샷은 Android의 백그라운드에 있는 푸시 알림을 보여줍니다.![Android의 백그라운드 푸시 알림](images/background.jpg) - - - -# 다음 단계 -{: #next_steps_tags} - -정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. - -이러한 푸시 알림 서비스 기능을 앱에 추가하십시오. -태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. -고급 알림 옵션을 사용하려면 [고급 푸시 알림](t_advance_notifications.html)을 참조하십시오. +--- + +copyright: + years: 2015, 2016 + +--- + +# Cordova 푸시 플러그인 설치 +{: #cordova_install} + +클라이언트 푸시 플러그인을 설치하고 이를 사용하여 추가적으로 Cordova 애플리케이션을 개발할 수 있습니다. 이 때 사용자와 Bluemix의 연결을 초기화하는 Cordova 코어 플러그인도 설치됩니다. + +### 시작하기 전에 + +1. 최신 Android Studio SDK 및 Xcode 버전을 다운로드하십시오. +1. 에뮬레이터를 설정하십시오. Android Studio의 경우 Google Play API를 지원하는 에뮬레이터를 사용하십시오. +1. Git 명령행 도구를 설치하십시오. Windows의 경우 **Window 명령 프롬프트에서 Git 실행** 옵션을 선택하십시오. 이 도구의 다운로드 및 설치에 대한 정보는 [Git](https://git-scm.com/downloads)을 참조하십시오. + +1. Node.js 및 NPM(Node Package Manager) 도구를 설치하십시오. NPM 명령행 도구는 Node.js와 함께 번들로 제공됩니다. Node.js를 다운로드하고 설치하는 방법에 대한 정보는 [Node.js](https://nodejs.org/en/download/)를 참조하십시오. +1. 명령행에서 **npm install -g cordova** 명령을 사용하여 Cordova 명령행 도구를 설치하십시오. Cordova 푸시 플러그인을 사용하려면 필요합니다. Cordova 설치 및 Cordova 앱 설정 정보를 보려면 [Cordova Apache](https://cordova.apache.org/#getstarted)를 참조하십시오. + + **참고**: Cordova 푸시 플러그인 Readme 파일을 보려면 [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push)로 이동하십시오. + + +## Cordova 푸시 플러그인 설치 +1. Cordova 앱을 작성하려는 폴더로 변경하고 다음 명령을 실행하여 Cordova 애플리케이션을 작성하십시오. 기존의 Cordova 앱이 있을 경우 3단계로 가십시오. + +``` +cordova create your_app_name +cd your_app_name +``` +1. 선택사항: **config.xml** 파일을 편집하고 요소에서 애플리케이션 이름을 기본값인 HelloCordova 이름 대신 원하는 이름으로 변경하십시오. + + **참고**: 올바른 번들 ID를 지정하십시오. 그렇지 않은 경우 다음 오류 메시지가 Xcode에 표시됩니다. + * 실행 파일이 올바르지 않은 인타이틀먼트로 서명되었습니다. + * 애플리케이션의 코드 서명 인타이틀먼트에 지정된 인타이틀먼트가 프로비저닝 프로파일에 지정된 인타이틀먼트와 일치하지 않습니다. + + 이 문제를 수정하려면 Xcode 또는 Cordova 앱 **config.xml** 파일에서 올바른 번들 ID를 지정하십시오. + +1. Corova 애플리케이션의 config.xml 파일에 최소 지원 API 또는 배치 대상 선언을 추가하십시오. minSdkVersion 값은 15보다 커야 합니다. targetSdkVersion 값은 항상 Google을 통해 제공받을 수 있는 최신 Android SDK를 반영해야 합니다. + * **Android** - 편집기를 사용하여 config.xml 파일을 열고, 최소 대상 SDK 버전으로 `` 요소를 업데이트하십시오. + + ``` + + + + + + ``` + * **iOS** - 배치 대상 선언으로 요소를 업데이트하십시오. + + ``` + + + + + ``` + +1. Cordova 명령행 인터페이스(CLI)에서 다음 명령을 사용하여 플랫폼(iOS, Android 또는 둘 다)을 추가하십시오. + + ``` + cordova platform add ios@3.9.0 + cordova platform add android + ``` +1. Cordova 애플리케이션 루트 디렉토리에서 다음 명령을 입력하여 Cordova 푸시 플러그인을 설치하십시오. **cordova plugin add ibm-mfp-push** + + 추가한 플랫폼에 따라 다음과 유사하게 표시됩니다. + + ``` + Installing "ibm-mfp-push" for android + Installing "ibm-mfp-push" for ios + ``` +1. *your-app-root-folder*에서 다음 명령을 사용하여 Cordova 코어 및 푸시 플러그인이 정상적으로 설치되었는지 확인하십시오. **cordova plugin list** + + 추가한 플랫폼에 따라 다음과 유사하게 표시됩니다. + + ``` + ibm-mfp-core 1.0.0 "MFPCore" + ibm-mfp-push 1.0.0 “MFPPush" + ``` +1. (iOS만 해당) - iOS 개발 환경을 구성하십시오. + a. Xcode가 있는 *your-app-name***/platforms/ios** 디렉토리에서 your-app-name.xcodeproj 파일을 여십시오. + + b. 브릿지 헤더를 추가하십시오. **빌드 설정 > Swift 컴파일러 - 코드 생성 > Objective-C 브릿지 헤더**로 이동하여 다음 경로를 추가하십시오. *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + c. 프레임워크 매개변수를 추가하십시오. **빌드 설정 > 링크 > Runpath 검색 경로**로 이동하여 다음 매개변수를 추가하십시오. + + ``` + @executable_path/Frameworks + ``` + d. 브릿지 헤더에서 다음 푸시 가져오기 명령을 주석 해제하십시오. *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h**로 이동하십시오. + + ``` + //#import + //#import + //#import + ``` + e. Xcode를 사용하여 애플리케이션을 빌드하고 실행하십시오. +1. (Android만 해당) - 다음 명령을 사용하여 Android 프로젝트를 빌드하십시오. +**cordova build android**. + + **참고**: Android Studio에서 프로젝트를 열기 전에 먼저 Cordova CLI를 통해 Cordova 애플리케이션을 빌드해야 합니다. 그렇지 않으면 빌드 오류가 발생합니다. + + +# Cordova 플러그인 초기화 +{: #cordova_initialize} + +푸시 알림 서비스 Cordova 플러그인을 사용할 수 있으려면 애플리케이션 라우트와 애플리케이션 GUID를 전달하여 플러그인을 초기화해야 합니다. 플러그인을 초기화한 후 Bluemix 대시보드에서 작성한 서버 앱에 연결할 수 있습니다. Cordova 플러그인은 Cordova 앱이 Bluemix 서비스와 통신할 수 있도록 해주는 Android 및 iOS 클라이언트 SDK용 랩퍼입니다. + +1. 다음 코드 스니펫을 복사하여 기본 JavaScript 파일(일반적으로 **www/js** 디렉토리 아래에 있음)에 붙여넣어 BMSClient를 초기화하십시오. + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Bluemix Route 및 appGUID 매개변수를 사용하려면 코드 스니펫을 수정하십시오. Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 애플리케이션 GUID를 확보하십시오. `BMSClient.initialize` 코드 스니펫에서 라우트 및 앱 GUID 값을 매개변수로 사용하십시오. + + **참고**: Cordova CLI(예: Cordova create app-name 명령)를 사용하여 Cordova 앱을 작성한 경우 이 Javascript 코드를 **index.js** 파일에서 `onDeviceReady: function()` 함수의 `app.receivedEvent` 함수 뒤에 넣어서 BMS 클라이언트를 초기화하십시오. + +``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` + +# 디바이스 등록 + +{: #cordova_register} + +디바이스를 푸시 알림 서비스에 등록하려면 등록 메소드를 호출하십시오. + +디바이스를 등록하려면 다음 코드 스니펫을 복사하여 Cordova 애플리케이션에 붙여넣으십시오. + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android에서는 이 설정 매개변수를 사용하지 않습니다. Android 앱만 빌드할 경우에는 공백 오브젝트를 전달하십시오. 예를 들어 다음과 같습니다. + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +경보, 배지 및 사운드 특성을 사용자 정의하려면 다음의 JavaScript 코드 스니펫을 Cordova 애플리케이션의 웹 파트에 추가하십시오. + +``` + var settings = { +ios: { +alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +JSON.parse를 사용하여 Javascript에서 성공 응답 매개변수의 컨텐츠에 액세스할 수 있습니다. +**var token = JSON.parse(response).token** + + +사용 가능한 키는 다음과 같습니다. `token`, `userId`, `deviceId`. + +다음 JavaScript 코드 스니펫은 Bluemix Mobile Services 클라이언트 SDK를 초기화하고, 푸시 알림 서비스를 사용하여 디바이스를 등록하고, 푸시 알림을 청취하는 방법을 보여줍니다. 이 코드를 Javascript 파일에 넣으십시오. + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +**onDeviceReady: function()**에서 다음을 수행하십시오. + +``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { +alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification);} +``` + +## Objective-C +{: #cordova_register_objective} +다음의 Objective-C 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## 다음 단계 + +{: #cordova_register_next} + +1. 프로젝트를 빌드하고 다음 명령을 사용하여 프로젝트를 실행하십시오. + + * Android - **cordova build android** 실행 후 **cordova run android** 실행 + + * iOS - **cordova build ios** 실행 후 **cordova run ios** 실행 + + + +# 디바이스에서 푸시 알림 수신 +{: #cordova_receive} + +디바이스에서 푸시 알림을 수신하려면 다음 코드 스니펫을 복사하여 붙여넣으십시오. + +## JavaScript + +다음의 JavaScript 코드 스니펫을 Cordova 애플리케이션의 웹 파트에 추가하십시오. + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +## Android 알림 특성 + +다음 섹션에는 Android 알림 특성이 나열되어 있습니다. + +* 메시지 - 푸시 알림 메시지 +* 페이로드 - 알림 페이로드를 포함하는 JSON 오브젝트 + + +## iOS 알림 특성 + +다음 섹션에는 iOS 알림 특성이 나열되어 있습니다. + +* 메시지 - 푸시 알림 메시지 +* 페이로드 - 알림 페이로드를 포함한 JSON 오브젝트 +action-loc-key - 문자열은 "보기" 대신 오른쪽 단추의 제목에 사용할 현재 로컬라이제이션의 현지화된 문자열을 가져오기 위한 키로 사용됩니다. +* 배지 - 앱 아이콘의 배지로 표시할 숫자입니다. 이 특성을 비워두면 배지가 변경되지 않습니다. 배지를 제거하려면 이 특성의 값을 0으로 설정하십시오. +* 사운드 - 앱 번들 또는 앱 데이터 컨테이너의 라이브러리/사운드 폴더에 있는 사운드 파일의 이름입니다. + +## Objective-C + +다음의 Objective-C 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +## Swift + +다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` + + + +# 기본 푸시 알림 전송 +{: #push-send-notifications} + +애플리케이션이 개발된 후에는 (태그, 배지, 추가 페이로드 또는 사운드 파일을 사용하지 않아도) 기본 푸시 알림을 전송할 수 있습니다. + + +기본 푸시 알림을 전송하십시오. + +1. **청취자 선택**에서 다음 청취자 중 하나를 선택하십시오. **모든 디바이스** 또는 플랫폼 기준으로 **iOS 디바이스만** 또는 **Anroid 디바이스만**. + + **참고**: **모든 디바이스** 옵션을 선택하는 경우 푸시 알림에 등록된 모든 디바이스는 알림을 수신합니다. + + ![알림 화면](images/tag_notification.jpg) + +2. **알림 작성**에서 메시지를 입력한 후 **전송**을 클릭하십시오. +3. 디바이스가 알림을 수신했는지 확인하십시오. + + 다음 스크린샷은 Android 및 iOS 디바이스의 포그라운드에서 +푸시 알림을 처리하는 경보 상자를 표시합니다. + + ![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) + + ![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) + + 다음 스크린샷은 Android의 백그라운드에 있는 푸시 알림을 보여줍니다.![Android의 백그라운드 푸시 알림](images/background.jpg) + + + +# 다음 단계 +{: #next_steps_tags} + +정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. + +이러한 푸시 알림 서비스 기능을 앱에 추가하십시오. +태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. +고급 알림 옵션을 사용하려면 [고급 푸시 알림](t_advance_notifications.html)을 참조하십시오. diff --git a/services/mobilepush/nl/ko/t_cordova_receive.md b/services/mobilepush/nl/ko/t_cordova_receive.md index 36f8a4664..ba44fac9c 100644 --- a/services/mobilepush/nl/ko/t_cordova_receive.md +++ b/services/mobilepush/nl/ko/t_cordova_receive.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 디바이스에서 푸시 알림 수신 -{: #cordova_receive} - -디바이스에서 푸시 알림을 수신하려면 다음 코드 스니펫을 복사하여 붙여넣으십시오. - -##JavaScript - -다음의 JavaScript 코드 스니펫을 Cordova 애플리케이션의 웹 파트에 추가하십시오. - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Android 알림 특성 - -다음 섹션에는 Android 알림 특성이 나열되어 있습니다. - -* 메시지 - 푸시 알림 메시지 -* 페이로드 - 알림 페이로드를 포함하는 JSON 오브젝트 - - -##iOS 알림 특성 - -다음 섹션에는 iOS 알림 특성이 나열되어 있습니다. - -* 메시지 - 푸시 알림 메시지 -* 페이로드 - 알림 페이로드를 포함한 JSON 오브젝트 -action-loc-key - 문자열은 "보기" 대신 오른쪽 단추의 제목에 사용할 현재 로컬라이제이션의 현지화된 문자열을 가져오기 위한 키로 사용됩니다. -* 배지 - 앱 아이콘의 배지로 표시할 숫자입니다. 이 특성을 비워두면 배지가 변경되지 않습니다. 배지를 제거하려면 이 특성의 값을 0으로 설정하십시오. -* 사운드 - 앱 번들 또는 앱 데이터 컨테이너의 라이브러리/사운드 폴더에 있는 사운드 파일의 이름입니다. - -##Objective-C - -다음의 Objective-C 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` -다음 단계. [기본 푸시 알림 전송](t_send_push_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# 디바이스에서 푸시 알림 수신 +{: #cordova_receive} + +디바이스에서 푸시 알림을 수신하려면 다음 코드 스니펫을 복사하여 붙여넣으십시오. + +##JavaScript + +다음의 JavaScript 코드 스니펫을 Cordova 애플리케이션의 웹 파트에 추가하십시오. + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +##Android 알림 특성 + +다음 섹션에는 Android 알림 특성이 나열되어 있습니다. + +* 메시지 - 푸시 알림 메시지 +* 페이로드 - 알림 페이로드를 포함하는 JSON 오브젝트 + + +##iOS 알림 특성 + +다음 섹션에는 iOS 알림 특성이 나열되어 있습니다. + +* 메시지 - 푸시 알림 메시지 +* 페이로드 - 알림 페이로드를 포함한 JSON 오브젝트 +action-loc-key - 문자열은 "보기" 대신 오른쪽 단추의 제목에 사용할 현재 로컬라이제이션의 현지화된 문자열을 가져오기 위한 키로 사용됩니다. +* 배지 - 앱 아이콘의 배지로 표시할 숫자입니다. 이 특성을 비워두면 배지가 변경되지 않습니다. 배지를 제거하려면 이 특성의 값을 0으로 설정하십시오. +* 사운드 - 앱 번들 또는 앱 데이터 컨테이너의 라이브러리/사운드 폴더에 있는 사운드 파일의 이름입니다. + +##Objective-C + +다음의 Objective-C 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +##Swift + +다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` +다음 단계. [기본 푸시 알림 전송](t_send_push_notifications.html). diff --git a/services/mobilepush/nl/ko/t_cordova_register.md b/services/mobilepush/nl/ko/t_cordova_register.md index f90ba0d79..fa299357f 100644 --- a/services/mobilepush/nl/ko/t_cordova_register.md +++ b/services/mobilepush/nl/ko/t_cordova_register.md @@ -1,138 +1,138 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 디바이스 등록 - -{: #cordova_register} - -디바이스를 푸시 알림 서비스에 등록하려면 등록 메소드를 호출하십시오. - -디바이스를 등록하려면 다음 코드 스니펫을 복사하여 Cordova 애플리케이션에 붙여넣으십시오. - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android에서는 이 설정 매개변수를 사용하지 않습니다. Android 앱만 빌드할 경우에는 공백 오브젝트를 전달하십시오. 예를 들어 다음과 같습니다. - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -경보, 배지 및 사운드 특성을 사용자 정의하려면 다음의 JavaScript 코드 스니펫을 Cordova 애플리케이션의 웹 파트에 추가하십시오. - -``` - var settings = { -ios: { -alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -JSON.parse를 사용하여 Javascript에서 성공 응답 매개변수의 컨텐츠에 액세스할 수 있습니다. -**var token = JSON.parse(response).token** - - -사용 가능한 키는 다음과 같습니다. `token`, `userId`, `deviceId`. - -다음 JavaScript 코드 스니펫은 Bluemix Mobile Services 클라이언트 SDK를 초기화하고, 푸시 알림 서비스를 사용하여 디바이스를 등록하고, 푸시 알림을 청취하는 방법을 보여줍니다. 이 코드를 Javascript 파일에 넣으십시오. - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -**onDeviceReady: function()**에서 다음을 수행하십시오. - -``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { -alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification);} -``` - -## Objective-C -{: #cordova_register_objective} -다음의 Objective-C 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##다음 단계 -{: #cordova_register_next} - -1. 프로젝트를 빌드하고 다음 명령을 사용하여 프로젝트를 실행하십시오. - - * Android - **cordova build android** 실행 후 **cordova run android** 실행 - - * iOS - **cordova build ios** 실행 후 **cordova run ios** 실행 -1. [디바이스에서 푸시 알림 수신](t_cordova_receive.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# 디바이스 등록 + +{: #cordova_register} + +디바이스를 푸시 알림 서비스에 등록하려면 등록 메소드를 호출하십시오. + +디바이스를 등록하려면 다음 코드 스니펫을 복사하여 Cordova 애플리케이션에 붙여넣으십시오. + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android에서는 이 설정 매개변수를 사용하지 않습니다. Android 앱만 빌드할 경우에는 공백 오브젝트를 전달하십시오. 예를 들어 다음과 같습니다. + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +경보, 배지 및 사운드 특성을 사용자 정의하려면 다음의 JavaScript 코드 스니펫을 Cordova 애플리케이션의 웹 파트에 추가하십시오. + +``` + var settings = { +ios: { +alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +##JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +JSON.parse를 사용하여 Javascript에서 성공 응답 매개변수의 컨텐츠에 액세스할 수 있습니다. +**var token = JSON.parse(response).token** + + +사용 가능한 키는 다음과 같습니다. `token`, `userId`, `deviceId`. + +다음 JavaScript 코드 스니펫은 Bluemix Mobile Services 클라이언트 SDK를 초기화하고, 푸시 알림 서비스를 사용하여 디바이스를 등록하고, 푸시 알림을 청취하는 방법을 보여줍니다. 이 코드를 Javascript 파일에 넣으십시오. + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +**onDeviceReady: function()**에서 다음을 수행하십시오. + +``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { +alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification);} +``` + +## Objective-C +{: #cordova_register_objective} +다음의 Objective-C 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +##Swift +{: #cordova_register_swift} +다음의 Swift 코드 스니펫을 애플리케이션 위임 클래스에 추가하십시오. + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +##다음 단계 +{: #cordova_register_next} + +1. 프로젝트를 빌드하고 다음 명령을 사용하여 프로젝트를 실행하십시오. + + * Android - **cordova build android** 실행 후 **cordova run android** 실행 + + * iOS - **cordova build ios** 실행 후 **cordova run ios** 실행 +1. [디바이스에서 푸시 알림 수신](t_cordova_receive.html). diff --git a/services/mobilepush/nl/ko/t_create_push_instance.md b/services/mobilepush/nl/ko/t_create_push_instance.md index af98971c0..ffd64a6b0 100644 --- a/services/mobilepush/nl/ko/t_create_push_instance.md +++ b/services/mobilepush/nl/ko/t_create_push_instance.md @@ -1,32 +1,32 @@ -# 푸시 서비스 인스턴스 작성 -{: #create-push-instance} - -{{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}를 시작하기 위해, 먼저 {{site.data.keyword.Bluemix}} 애플리케이션을 작성합니다(예: Node.js 앱). 그런 다음 이 Bluemix 애플리케이션에 바인드하는 데 필요한 푸시 서비스 인스턴스 {{site.data.keyword.mobilepushfull}}를 작성합니다. Bluemix 카탈로그의 표준 유형 섹션으로 이동하여 MobileFirst 서비스 스타터를 클릭하여 이를 수행할 수도 있습니다. - -**참고**: 환경을 관리하도록 조직을 구성하였으면, 모바일 앱을 위한 런타임과 서비스를 작성하려는 조직을 선택하십시오. - - -1. Bluemix 애플리케이션이 없는 경우 애플리케이션을 작성해야 합니다(예: Node.js 앱). Bluemix 애플리케이션을 작성하려면, Bluemix 대시보드로 이동하여 **앱 작성**을 클릭하십시오. - - **참고**: 애플리케이션이 있을 경우 7단계로 이동하여 서비스를 추가하십시오. ![서비스 인스턴스 작성](images/create_service_instance1.jpg "서비스 인스턴스 작성") - -1. **앱 템플리트 선택**에서 **웹**을 클릭하십시오. - -3. **시작점 선택** 영역에서 **SDK for Node.js**를 선택하고 **계속**을 클릭하십시오. ![시작점](images/create_service_nodejs2.jpg) - -4. **영역** 풀다운 메뉴에서 조직 영역을 선택하십시오. ![조직 영역 선택](images/create_a_service3.jpg) -1. **이름**에 앱의 이름을 입력하고 호스트에 호스트의 이름을 입력하십시오. - -1. **선택된 계획** 풀다운 메뉴에서 계획을 선택한 다음 **작성** 단추를 클릭하십시오. 애플리케이션이 스테이징될 때까지 대기하십시오. - -1. **개요** 링크를 클릭하십시오. ![서비스 추가](images/create_service_add4.jpg) -1. **서비스 추가**를 클릭하십시오. CATALOG 화면이 표시됩니다. - -1. **IBM 푸시 알림:**을 선택하고 **Space** 풀다운 메뉴에서 조직을 선택하십시오. ![조직 영역 풀다운 메뉴](images/create_service_org.jpg) -1. **서비스** 이름에 푸시 알림 서비스 이름을 입력하십시오. - -1. **선택된 계획**에서 계획을 선택하고 **작성** 단추를 클릭하십시오. - -1. **예**를 클릭하여 애플리케이션을 다시 스테이징하십시오. ![IBM 푸시 알림 서비스](images/create_service_notification5.jpg) - -1. **푸시 알림**을 클릭하여 푸시 알림 대시보드를 표시하십시오. +# 푸시 서비스 인스턴스 작성 +{: #create-push-instance} + +{{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}를 시작하기 위해, 먼저 {{site.data.keyword.Bluemix}} 애플리케이션을 작성합니다(예: Node.js 앱). 그런 다음 이 Bluemix 애플리케이션에 바인드하는 데 필요한 푸시 서비스 인스턴스 {{site.data.keyword.mobilepushfull}}를 작성합니다. Bluemix 카탈로그의 표준 유형 섹션으로 이동하여 MobileFirst 서비스 스타터를 클릭하여 이를 수행할 수도 있습니다. + +**참고**: 환경을 관리하도록 조직을 구성하였으면, 모바일 앱을 위한 런타임과 서비스를 작성하려는 조직을 선택하십시오. + + +1. Bluemix 애플리케이션이 없는 경우 애플리케이션을 작성해야 합니다(예: Node.js 앱). Bluemix 애플리케이션을 작성하려면, Bluemix 대시보드로 이동하여 **앱 작성**을 클릭하십시오. + + **참고**: 애플리케이션이 있을 경우 7단계로 이동하여 서비스를 추가하십시오. ![서비스 인스턴스 작성](images/create_service_instance1.jpg "서비스 인스턴스 작성") + +1. **앱 템플리트 선택**에서 **웹**을 클릭하십시오. + +3. **시작점 선택** 영역에서 **SDK for Node.js**를 선택하고 **계속**을 클릭하십시오. ![시작점](images/create_service_nodejs2.jpg) + +4. **영역** 풀다운 메뉴에서 조직 영역을 선택하십시오. ![조직 영역 선택](images/create_a_service3.jpg) +1. **이름**에 앱의 이름을 입력하고 호스트에 호스트의 이름을 입력하십시오. + +1. **선택된 계획** 풀다운 메뉴에서 계획을 선택한 다음 **작성** 단추를 클릭하십시오. 애플리케이션이 스테이징될 때까지 대기하십시오. + +1. **개요** 링크를 클릭하십시오. ![서비스 추가](images/create_service_add4.jpg) +1. **서비스 추가**를 클릭하십시오. CATALOG 화면이 표시됩니다. + +1. **IBM 푸시 알림:**을 선택하고 **Space** 풀다운 메뉴에서 조직을 선택하십시오. ![조직 영역 풀다운 메뉴](images/create_service_org.jpg) +1. **서비스** 이름에 푸시 알림 서비스 이름을 입력하십시오. + +1. **선택된 계획**에서 계획을 선택하고 **작성** 단추를 클릭하십시오. + +1. **예**를 클릭하여 애플리케이션을 다시 스테이징하십시오. ![IBM 푸시 알림 서비스](images/create_service_notification5.jpg) + +1. **푸시 알림**을 클릭하여 푸시 알림 대시보드를 표시하십시오. diff --git a/services/mobilepush/nl/ko/t_enable-ios-notifications-receive.md b/services/mobilepush/nl/ko/t_enable-ios-notifications-receive.md index ac0c60694..dd6bbfb08 100644 --- a/services/mobilepush/nl/ko/t_enable-ios-notifications-receive.md +++ b/services/mobilepush/nl/ko/t_enable-ios-notifications-receive.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# iOS 디바이스에서 푸시 알림 수신 -{: #enable-push-ios-notifications-receiving} - -iOS 디바이스에서 푸시 알림을 수신합니다. - -##Objective-C -iOS 디바이스에서 푸시 알림을 수신하려면 애플리케이션의 위임자에 다음 Objective-C 메소드를 추가하십시오. - -``` -// For Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -iOS 디바이스에서 푸시 알림을 수신하려면 애플리케이션의 위임자에 다음 Swift 메소드를 추가하십시오. - -``` -//For Swift - func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the server - } -``` - +--- + +copyright: + years: 2015, 2016 + +--- + +# iOS 디바이스에서 푸시 알림 수신 +{: #enable-push-ios-notifications-receiving} + +iOS 디바이스에서 푸시 알림을 수신합니다. + +## Objective-C +iOS 디바이스에서 푸시 알림을 수신하려면 애플리케이션의 위임자에 다음 Objective-C 메소드를 추가하십시오. + +``` +// For Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +## Swift +iOS 디바이스에서 푸시 알림을 수신하려면 애플리케이션의 위임자에 다음 Swift 메소드를 추가하십시오. + +``` +//For Swift + func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the server + } +``` + diff --git a/services/mobilepush/nl/ko/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/ko/t_enable_actionable_notifications_ios.md index 46dc480de..d6ac43678 100644 --- a/services/mobilepush/nl/ko/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/ko/t_enable_actionable_notifications_ios.md @@ -1,105 +1,105 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# iOS에 조치 가능 알림 사용 -{: #enable-actionable-notifications-ios} - -일반적인 조치 알림과 달리, 조치 가능 알림은 알림 경고 수신 시 앱을 열지 않고 수행할 동작을 선택할 수 있는 프롬프트를 사용자에게 표시합니다. 다음 지시사항을 사용하여 애플리케이션에서 조치 가능 푸시 알림을 사용하십시오. - - - -1. 사용자 응답 조치를 작성하십시오. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. 알림 카테고리를 작성하고 조치를 설정하십시오. **UIUserNotificationActionContextDefault** 또는 **UIUserNotificationActionContextMinimal**이 올바른 컨텍스트입니다. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. 알림 설정을 작성하고 이전 단계의 범주를 지정하십시오. - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. 로컬 또는 원격 알림을 작성하고 카테고리 ID를 지정하십시오. - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# iOS에 조치 가능 알림 사용 +{: #enable-actionable-notifications-ios} + +일반적인 조치 알림과 달리, 조치 가능 알림은 알림 경고 수신 시 앱을 열지 않고 수행할 동작을 선택할 수 있는 프롬프트를 사용자에게 표시합니다. 다음 지시사항을 사용하여 애플리케이션에서 조치 가능 푸시 알림을 사용하십시오. + + + +1. 사용자 응답 조치를 작성하십시오. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. 알림 카테고리를 작성하고 조치를 설정하십시오. **UIUserNotificationActionContextDefault** 또는 **UIUserNotificationActionContextMinimal**이 올바른 컨텍스트입니다. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. 알림 설정을 작성하고 이전 단계의 범주를 지정하십시오. + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. 로컬 또는 원격 알림을 작성하고 카테고리 ID를 지정하십시오. + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/ko/t_enable_ios_notifications_initialize.md b/services/mobilepush/nl/ko/t_enable_ios_notifications_initialize.md index 58acb3c18..a5bea9708 100644 --- a/services/mobilepush/nl/ko/t_enable_ios_notifications_initialize.md +++ b/services/mobilepush/nl/ko/t_enable_ios_notifications_initialize.md @@ -1,64 +1,64 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# iOS 앱을 위한 푸시 SDK 초기화 -{: #enable-push-ios-notifications-initialize} - -초기화 코드를 배치하는 공통 위치는 iOS 애플리케이션에 대한 애플리케이션 위임자입니다. -Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 GUID를 확보하십시오. - -##Core SDK 초기화 - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstancemyBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - -##클라이언트 푸시 SDK 초기화 - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## 라우트, GUID 및 Bluemix 지역 - -**appRoute** - -Bluemix에서 생성한 서버 애플리케이션에 지정된 라우트를 지정합니다. - -**GUID** - -Bluemix에서 생성한 애플리케이션에 지정된 고유 키를 지정합니다. 이 값은 대소문자를 구분합니다. - -**bluemixRegionSuffix** - -앱이 호스트된 위치를 지정합니다. `bluemixRegion` 매개변수는 사용 중인 Bluemix 배치를 지정합니다. 이 값을 `BMSClient.REGION` 정적 특성으로 설정하고 세 값 중 하나를 사용할 수 있습니다. - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY +--- + +copyright: + years: 2015, 2016 + +--- + +# iOS 앱을 위한 푸시 SDK 초기화 +{: #enable-push-ios-notifications-initialize} + +초기화 코드를 배치하는 공통 위치는 iOS 애플리케이션에 대한 애플리케이션 위임자입니다. +Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 GUID를 확보하십시오. + +##Core SDK 초기화 + +###Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +###Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstancemyBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + +##클라이언트 푸시 SDK 초기화 + +###Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +###Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## 라우트, GUID 및 Bluemix 지역 + +**appRoute** + +Bluemix에서 생성한 서버 애플리케이션에 지정된 라우트를 지정합니다. + +**GUID** + +Bluemix에서 생성한 애플리케이션에 지정된 고유 키를 지정합니다. 이 값은 대소문자를 구분합니다. + +**bluemixRegionSuffix** + +앱이 호스트된 위치를 지정합니다. `bluemixRegion` 매개변수는 사용 중인 Bluemix 배치를 지정합니다. 이 값을 `BMSClient.REGION` 정적 특성으로 설정하고 세 값 중 하나를 사용할 수 있습니다. + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY diff --git a/services/mobilepush/nl/ko/t_enable_ios_notifications_install.md b/services/mobilepush/nl/ko/t_enable_ios_notifications_install.md index 9e8b7f274..c1cb84bd7 100644 --- a/services/mobilepush/nl/ko/t_enable_ios_notifications_install.md +++ b/services/mobilepush/nl/ko/t_enable_ios_notifications_install.md @@ -1,315 +1,315 @@ -# iOS 앱을 위한 푸시 SDK 초기화 -{: #enable-push-ios-notifications-install} - -기존 Xcode 프로젝트의 경우 CocoaPods 종속 항목 관리 도구를 사용하여 Bluemix Mobile Services Client SDK를 설정할 수 있습니다. 또는 SDK를 수동으로 설치할 수 있습니다. - -**참고**: Swift Push readme 파일을 보려면 다음으로 이동하십시오. https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master - -##CocoaPods 설치 - -1. Mac 터미널에서 다음 명령을 사용하여 CocoaPods를 설치하십시오. -``` -$ sudo gem install cocoapods -``` -2. 터미널에서 다음 명령을 입력하여 CocoaPods를 초기화하십시오. -이 명령을 실행할 경우 Xcode 프로젝트가 있는 디렉토리에서 실행해야 합니다. `pod init` 명령에서 파일 제목을 작성합니다. -``` -$ pod init -``` -3. 생성된 Podfile에서 필요한 SDK 종속 항목을 추가하십시오. 다음 Podfile을 복사하십시오. - - Objective-C - - ``` -source 'https://github.com/CocoaPods/Specs.git' - Copy the following list as is and remove the dependencies you do not need - pod 'IMFCore' - pod 'IMFPush' - ``` - - Swift - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - end - ``` -3. 터미널에서 프로젝트 폴더로 이동한 후, 다음 명령을 사용하여 종속 항목을 설치하십시오. - -``` -$ pod update -``` -해당 명령은 종속 항목을 설치하고 새 Xcode 작업공간을 작성합니다. **참고**: 원래 Xcode 프로젝트 파일 대신, 반드시 항상 새 Xcode 작업공간을 여십시오. - -``` - $ open App.xcworkspace - ``` -작업공간에는 원래 프로젝트 및 종속 항목이 포함된 Pods 프로젝트가 있습니다. Bluemix Mobile Services 소스 폴더를 수정하려는 경우, `Pods/yourImportedSourceFolder` 아래의 Pods 프로젝트에서 폴더를 찾을 수 있습니다(예: `Pods/IMFGoogleAuthentication`). - -##가져온 프레임워크 및 소스 폴더 사용 - -코드에서 SDK를 참조하십시오. - - -### Objective-C - -관련 헤더에 대해 #import 지시문을 작성합니다. 예: - -``` -//Objective-C -#import -#import -``` - -**참고**: CocoaPods 명령 `pod install` 또는 `pod update`를 사용하여 Pods 프로젝트를 업데이트하면 Bluemix Mobile Services 소스 폴더를 대체할 수 있습니다. 원래 파일의 사용자 정의한 버전을 유지하려면, 이러한 명령을 실행하기 전에 -해당 버전을 백업해야 합니다. - -###Swift - -**사전 전제조건** - -- iOS 8.0 이상 -- Xcode 7 - - -관련 헤더에 대해 #import 지시문을 작성합니다. 예: - -``` -//swift -import BMSCore -import BMSPush -``` - - -##빌드 설정 - -**Xcode > 빌드 설정 > 빌드 옵션 및 Bitcode 사용 설정**으로 이동하여 **No**로 설정하십시오. - -**주의**: iOS 9의 경우, ATS(App Transport Security) 기능을 변경하면 인증 프로세스의 처리 방식에 영향이 미칠 수 있습니다. 다음 블로그 포스팅에서 이러한 변경에 대해 자세히 설명합니다. [ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) 및 [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) - - - - -# iOS 앱을 위한 푸시 SDK 초기화 -{: #enable-push-ios-notifications-initialize} - -초기화 코드를 배치하는 공통 위치는 iOS 애플리케이션에 대한 애플리케이션 위임자입니다. -Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 GUID를 확보하십시오. - -##Core SDK 초기화 - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstancemyBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - - -##클라이언트 푸시 SDK 초기화 - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## 라우트, GUID 및 Bluemix 지역 - -**appRoute** - -Bluemix에서 생성한 서버 애플리케이션에 지정된 라우트를 지정합니다. - -**GUID** - -Bluemix에서 생성한 애플리케이션에 지정된 고유 키를 지정합니다. 이 값은 대소문자를 구분합니다. - -**bluemixRegionSuffix** - -앱이 호스트된 위치를 지정합니다. `bluemixRegion` 매개변수는 사용 중인 Bluemix 배치를 지정합니다. 이 값을 `BMSClient.REGION` 정적 특성으로 설정하고 세 값 중 하나를 사용할 수 있습니다. - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - - - - -# iOS 애플리케이션 및 디바이스 등록 -{: #enable-push-ios-notifications-register} - - -일반적으로 앱이 디바이스에 설치된 후에 발생하는 원격 알림을 수신하려면 APNs에 애플리케이션(앱)을 등록해야 합니다. APNs에 의해 생성된 디바이스 토큰을 애플리케이션에서 수신한 후에는 푸시 알림 서비스에 이를 되돌려 보내야 합니다. - -iOs 애플리케이션 및 디바이스를 등록하려면 다음을 수행하십시오. - -1. 백엔드 애플리케이션 작성 -2. 토큰을 푸시 알림에 전달 - - -##백엔드 애플리케이션 작성 - -표준 유형 섹션 Bluemix® 카탈로그에서 푸시 서비스를 이 애플리케이션에 자동으로 바인드하는 백엔드 애플리케이션을 작성하십시오. 백엔드 앱을 이미 작성한 경우 앱을 푸시 알림 서비스에 바인드해야 합니다. - -###Objective-C - -``` - //For Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##토큰을 푸시 알림에 전달 - -APNs에서 토큰이 수신되면 이 토큰을 `registerDevice:withDeviceToken` 메소드의 일부로 푸시 알림에 전달하십시오. - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; -[client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; -// get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -APNS에서 토큰이 수신되면 이 토큰을 `didRegisterForRemoteNotificationsWithDeviceToken` 메소드의 일부로 푸시 알림에 전달하십시오. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` - - - -# iOS 디바이스에서 푸시 알림 수신 -{: #enable-push-ios-notifications-receiving} - -iOS 디바이스에서 푸시 알림을 수신합니다. - -##Objective-C -iOS 디바이스에서 푸시 알림을 수신하려면 애플리케이션의 위임자에 다음 Objective-C 메소드를 추가하십시오. - -``` -// For Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -iOS 디바이스에서 푸시 알림을 수신하려면 애플리케이션의 위임자에 다음 Swift 메소드를 추가하십시오. - -``` -//For Swift - func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the server - } - -``` - - - -# 기본 푸시 알림 전송 -{: #push-send-notifications} - -애플리케이션이 개발된 후에는 (태그, 배지, 추가 페이로드 또는 사운드 파일을 사용하지 않아도) 기본 푸시 알림을 전송할 수 있습니다. - - -기본 푸시 알림을 전송하십시오. - -1. **청취자 선택**에서 다음 청취자 중 하나를 선택하십시오. **모든 디바이스** 또는 플랫폼 기준으로 **iOS 디바이스만** 또는 **Anroid 디바이스만**. - - **참고**: **모든 디바이스** 옵션을 선택하는 경우 푸시 알림에 등록된 모든 디바이스는 알림을 수신합니다. - - ![알림 화면](images/tag_notification.jpg) - -2. **알림 작성**에서 메시지를 입력한 후 **전송**을 클릭하십시오. -3. 디바이스가 알림을 수신했는지 확인하십시오. - - 다음 스크린샷은 Android 및 iOS 디바이스의 포그라운드에서 -푸시 알림을 처리하는 경보 상자를 표시합니다. - - ![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) - - ![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) - - 다음 스크린샷은 Android의 백그라운드에 있는 푸시 알림을 보여줍니다.![Android의 백그라운드 푸시 알림](images/background.jpg) - - - - -# 다음 단계 -{: #next_steps_tags} - -정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. - -이러한 푸시 알림 서비스 기능을 앱에 추가하십시오. -태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. -고급 알림 옵션을 사용하려면 [고급 푸시 알림](t_advance_notifications.html)을 참조하십시오. +# iOS 앱을 위한 푸시 SDK 초기화 +{: #enable-push-ios-notifications-install} + +기존 Xcode 프로젝트의 경우 CocoaPods 종속 항목 관리 도구를 사용하여 Bluemix Mobile Services Client SDK를 설정할 수 있습니다. 또는 SDK를 수동으로 설치할 수 있습니다. + +**참고**: Swift Push readme 파일을 보려면 다음으로 이동하십시오. https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master + +##CocoaPods 설치 + +1. Mac 터미널에서 다음 명령을 사용하여 CocoaPods를 설치하십시오. +``` +$ sudo gem install cocoapods +``` +2. 터미널에서 다음 명령을 입력하여 CocoaPods를 초기화하십시오. +이 명령을 실행할 경우 Xcode 프로젝트가 있는 디렉토리에서 실행해야 합니다. `pod init` 명령에서 파일 제목을 작성합니다. +``` +$ pod init +``` +3. 생성된 Podfile에서 필요한 SDK 종속 항목을 추가하십시오. 다음 Podfile을 복사하십시오. + + Objective-C + + ``` +source 'https://github.com/CocoaPods/Specs.git' + Copy the following list as is and remove the dependencies you do not need + pod 'IMFCore' + pod 'IMFPush' + ``` + + Swift + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + end + ``` +3. 터미널에서 프로젝트 폴더로 이동한 후, 다음 명령을 사용하여 종속 항목을 설치하십시오. + +``` +$ pod update +``` +해당 명령은 종속 항목을 설치하고 새 Xcode 작업공간을 작성합니다. **참고**: 원래 Xcode 프로젝트 파일 대신, 반드시 항상 새 Xcode 작업공간을 여십시오. + +``` + $ open App.xcworkspace + ``` +작업공간에는 원래 프로젝트 및 종속 항목이 포함된 Pods 프로젝트가 있습니다. Bluemix Mobile Services 소스 폴더를 수정하려는 경우, `Pods/yourImportedSourceFolder` 아래의 Pods 프로젝트에서 폴더를 찾을 수 있습니다(예: `Pods/IMFGoogleAuthentication`). + +## 가져온 프레임워크 및 소스 폴더 사용 + +코드에서 SDK를 참조하십시오. + + +### Objective-C + +관련 헤더에 대해 #import 지시문을 작성합니다. 예: + +``` +//Objective-C +#import +#import +``` + +**참고**: CocoaPods 명령 `pod install` 또는 `pod update`를 사용하여 Pods 프로젝트를 업데이트하면 Bluemix Mobile Services 소스 폴더를 대체할 수 있습니다. 원래 파일의 사용자 정의한 버전을 유지하려면, 이러한 명령을 실행하기 전에 +해당 버전을 백업해야 합니다. + +### Swift + +**사전 전제조건** + +- iOS 8.0 이상 +- Xcode 7 + + +관련 헤더에 대해 #import 지시문을 작성합니다. 예: + +``` +//swift +import BMSCore +import BMSPush +``` + + +## 빌드 설정 + +**Xcode > 빌드 설정 > 빌드 옵션 및 Bitcode 사용 설정**으로 이동하여 **No**로 설정하십시오. + +**주의**: iOS 9의 경우, ATS(App Transport Security) 기능을 변경하면 인증 프로세스의 처리 방식에 영향이 미칠 수 있습니다. 다음 블로그 포스팅에서 이러한 변경에 대해 자세히 설명합니다. [ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) 및 [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) + + + + +# iOS 앱을 위한 푸시 SDK 초기화 +{: #enable-push-ios-notifications-initialize} + +초기화 코드를 배치하는 공통 위치는 iOS 애플리케이션에 대한 애플리케이션 위임자입니다. +Bluemix 애플리케이션 대시보드의 **모바일 옵션** 링크를 클릭하여 애플리케이션 라우트와 GUID를 확보하십시오. + +## Core SDK 초기화 + +### Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +### Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstancemyBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + + +## 클라이언트 푸시 SDK 초기화 + +### Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +### Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## 라우트, GUID 및 Bluemix 지역 + +**appRoute** + +Bluemix에서 생성한 서버 애플리케이션에 지정된 라우트를 지정합니다. + +**GUID** + +Bluemix에서 생성한 애플리케이션에 지정된 고유 키를 지정합니다. 이 값은 대소문자를 구분합니다. + +**bluemixRegionSuffix** + +앱이 호스트된 위치를 지정합니다. `bluemixRegion` 매개변수는 사용 중인 Bluemix 배치를 지정합니다. 이 값을 `BMSClient.REGION` 정적 특성으로 설정하고 세 값 중 하나를 사용할 수 있습니다. + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + + + + +# iOS 애플리케이션 및 디바이스 등록 +{: #enable-push-ios-notifications-register} + + +일반적으로 앱이 디바이스에 설치된 후에 발생하는 원격 알림을 수신하려면 APNs에 애플리케이션(앱)을 등록해야 합니다. APNs에 의해 생성된 디바이스 토큰을 애플리케이션에서 수신한 후에는 푸시 알림 서비스에 이를 되돌려 보내야 합니다. + +iOs 애플리케이션 및 디바이스를 등록하려면 다음을 수행하십시오. + +1. 백엔드 애플리케이션 작성 +2. 토큰을 푸시 알림에 전달 + + +## 백엔드 애플리케이션 작성 + +표준 유형 섹션 Bluemix® 카탈로그에서 푸시 서비스를 이 애플리케이션에 자동으로 바인드하는 백엔드 애플리케이션을 작성하십시오. 백엔드 앱을 이미 작성한 경우 앱을 푸시 알림 서비스에 바인드해야 합니다. + +### Objective-C + +``` + //For Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +### Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +## 토큰을 푸시 알림에 전달 + +APNs에서 토큰이 수신되면 이 토큰을 `registerDevice:withDeviceToken` 메소드의 일부로 푸시 알림에 전달하십시오. + +### Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; +[client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; +// get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +### Swift + +APNS에서 토큰이 수신되면 이 토큰을 `didRegisterForRemoteNotificationsWithDeviceToken` 메소드의 일부로 푸시 알림에 전달하십시오. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` + + + +# iOS 디바이스에서 푸시 알림 수신 +{: #enable-push-ios-notifications-receiving} + +iOS 디바이스에서 푸시 알림을 수신합니다. + +## Objective-C +iOS 디바이스에서 푸시 알림을 수신하려면 애플리케이션의 위임자에 다음 Objective-C 메소드를 추가하십시오. + +``` +// For Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +## Swift +iOS 디바이스에서 푸시 알림을 수신하려면 애플리케이션의 위임자에 다음 Swift 메소드를 추가하십시오. + +``` +//For Swift + func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the server + } + +``` + + + +# 기본 푸시 알림 전송 +{: #push-send-notifications} + +애플리케이션이 개발된 후에는 (태그, 배지, 추가 페이로드 또는 사운드 파일을 사용하지 않아도) 기본 푸시 알림을 전송할 수 있습니다. + + +기본 푸시 알림을 전송하십시오. + +1. **청취자 선택**에서 다음 청취자 중 하나를 선택하십시오. **모든 디바이스** 또는 플랫폼 기준으로 **iOS 디바이스만** 또는 **Anroid 디바이스만**. + + **참고**: **모든 디바이스** 옵션을 선택하는 경우 푸시 알림에 등록된 모든 디바이스는 알림을 수신합니다. + + ![알림 화면](images/tag_notification.jpg) + +2. **알림 작성**에서 메시지를 입력한 후 **전송**을 클릭하십시오. +3. 디바이스가 알림을 수신했는지 확인하십시오. + + 다음 스크린샷은 Android 및 iOS 디바이스의 포그라운드에서 +푸시 알림을 처리하는 경보 상자를 표시합니다. + + ![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) + + ![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) + + 다음 스크린샷은 Android의 백그라운드에 있는 푸시 알림을 보여줍니다.![Android의 백그라운드 푸시 알림](images/background.jpg) + + + + +# 다음 단계 +{: #next_steps_tags} + +정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. + +이러한 푸시 알림 서비스 기능을 앱에 추가하십시오. +태그 기반 알림을 사용하려면 [태그 기반 알림](c_tag_basednotifications.html)을 참조하십시오. +고급 알림 옵션을 사용하려면 [고급 푸시 알림](t_advance_notifications.html)을 참조하십시오. diff --git a/services/mobilepush/nl/ko/t_enable_ios_notifications_register.md b/services/mobilepush/nl/ko/t_enable_ios_notifications_register.md index 09b9dd41f..126c9dcca 100644 --- a/services/mobilepush/nl/ko/t_enable_ios_notifications_register.md +++ b/services/mobilepush/nl/ko/t_enable_ios_notifications_register.md @@ -1,88 +1,88 @@ -# iOS 애플리케이션 및 디바이스 등록 -{: #enable-push-ios-notifications-register} - - -일반적으로 앱이 디바이스에 설치된 후에 발생하는 원격 알림을 수신하려면 APNs에 애플리케이션(앱)을 등록해야 합니다. APNs에 의해 생성된 디바이스 토큰을 애플리케이션에서 수신한 후에는 푸시 알림 서비스에 이를 되돌려 보내야 합니다. - -iOs 애플리케이션 및 디바이스를 등록하려면 다음을 수행하십시오. - -1. 백엔드 애플리케이션 작성 -2. 토큰을 푸시 알림에 전달 - - -##백엔드 애플리케이션 작성 - -표준 유형 섹션 Bluemix® 카탈로그에서 푸시 서비스를 이 애플리케이션에 자동으로 바인드하는 백엔드 애플리케이션을 작성하십시오. 백엔드 앱을 이미 작성한 경우 앱을 푸시 알림 서비스에 바인드해야 합니다. - -###Objective-C - -``` - //For Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##토큰을 푸시 알림에 전달 - -APNs에서 토큰이 수신되면 이 토큰을 `registerDevice:withDeviceToken` 메소드의 일부로 푸시 알림에 전달하십시오. - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; -[client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; -// get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -APNS에서 토큰이 수신되면 이 토큰을 `didRegisterForRemoteNotificationsWithDeviceToken` 메소드의 일부로 푸시 알림에 전달하십시오. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` +# iOS 애플리케이션 및 디바이스 등록 +{: #enable-push-ios-notifications-register} + + +일반적으로 앱이 디바이스에 설치된 후에 발생하는 원격 알림을 수신하려면 APNs에 애플리케이션(앱)을 등록해야 합니다. APNs에 의해 생성된 디바이스 토큰을 애플리케이션에서 수신한 후에는 푸시 알림 서비스에 이를 되돌려 보내야 합니다. + +iOs 애플리케이션 및 디바이스를 등록하려면 다음을 수행하십시오. + +1. 백엔드 애플리케이션 작성 +2. 토큰을 푸시 알림에 전달 + + +## 백엔드 애플리케이션 작성 + +표준 유형 섹션 Bluemix® 카탈로그에서 푸시 서비스를 이 애플리케이션에 자동으로 바인드하는 백엔드 애플리케이션을 작성하십시오. 백엔드 앱을 이미 작성한 경우 앱을 푸시 알림 서비스에 바인드해야 합니다. + +### Objective-C + +``` + //For Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +### Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +## 토큰을 푸시 알림에 전달 + +APNs에서 토큰이 수신되면 이 토큰을 `registerDevice:withDeviceToken` 메소드의 일부로 푸시 알림에 전달하십시오. + +### Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; +[client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; +// get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +### Swift + +APNS에서 토큰이 수신되면 이 토큰을 `didRegisterForRemoteNotificationsWithDeviceToken` 메소드의 일부로 푸시 알림에 전달하십시오. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` diff --git a/services/mobilepush/nl/ko/t_get_tags.md b/services/mobilepush/nl/ko/t_get_tags.md index 022d01bad..28b272e2b 100644 --- a/services/mobilepush/nl/ko/t_get_tags.md +++ b/services/mobilepush/nl/ko/t_get_tags.md @@ -1,146 +1,146 @@ -# 태그 가져오기 -{: #get_tags} - -태그는 모든 애플리케이션에 전송되는 일반 브로드캐스트와 달리 관심사를 기반으로 수신인에게 맞춤형 알림을 전송하는 방법을 제공합니다. 푸시 대시보드의 태그 탭을 사용하여 태그를 작성 및 관리하거나 REST API를 사용할 수 있습니다. 다음 섹션의 코드 스니펫을 사용하여 모바일 애플리케이션에 대한 태그 구독을 관리 및 조회할 수 있습니다. 이 코드 스니펫을 사용하여 구독을 가져오고 태그를 구독하며 태그 구독을 취소하고 사용 가능한 태그 목록을 가져올 수 있습니다. 코드 스니펫을 모바일 애플리케이션에 복사하고 붙여넣으십시오. - -## Android - -**getTags** API는 디바이스를 구독할 수 있는 사용 가능한 태그 목록을 리턴합니다. 디바이스가 특정 태그에 구독되면 디바이스는 해당 태그에 대해 전송되는 모든 푸시 알림을 수신할 수 있습니다. - -디바이스가 구독된 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 Android 모바일 애플리케이션에 복사하십시오. - -디바이스가 구독할 수 있는 사용 가능 태그 목록을 가져오려면 다음 **getTags** API를 사용하십시오. - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - -디바이스가 구독된 태그 목록을 가져오려면 **getSubscriptions** API를 사용하십시오. - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { -@Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) -``` - -## Cordova - -디바이스가 구독된 사용 가능한 태그 목록을 가져오고 디바이스가 구독할 수 있는 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 모바일 애플리케이션에 복사하십시오. - -구독에 사용할 수 있는 태그의 배열을 검색하십시오. - -``` -//Get a list of available tags to which the device can subscribe -MFPPush.retrieveAvailableTags(function(tags) {alert(tags); -}, null); -``` - -``` -//Get a list of available tags to which the device is subscribed. -MFPPush.getSubscriptionStatus(function(tags) { -alert(tags); -}, null); -``` - -## Objective-C - -디바이스가 구독된 사용 가능한 태그 목록을 가져오고 디바이스가 구독할 수 있는 사용 가능한 태그 목록을 가져오려면 Objective-C를 사용하여 개발된 iOS 애플리케이션으로 다음 코드 스니펫을 복사하십시오. - -디바이스가 구독할 수 있는 사용 가능 태그 목록을 가져오려면 다음 **retrieveAvailableTags** API를 사용하십시오. - -``` -//Get a list of available tags to which the device can subscribe -[push retrieveAvailableTagsWithCompletionHandler: -^(IMFResponse *response, NSError *error){ - if (error){[ self updateMessage:error.description];} -else { - [self updateMessage:@"Successfully retrieved available tags."]; - NSDictionary *availableTags = [[NSDictionary alloc]init]; - availableTags = [response tags]; -[self.appDelegateVC updateMessage:availableTags.description]; -} -}]; -``` - -디바이스가 구독된 태그 목록을 가져오려면 **retrieveSubscriptions** API를 사용하십시오. - - - -``` -// Get a list of tags that to which the device is subscribed. -[push retrieveSubscriptionsWithCompletionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved subscriptions."]; - NSDictionary *subscribedTags = [[NSDictionary alloc]init]; -subscribedTags = [response subscriptions]; -[self.appDelegateVC updateMessage:subscribedTags.description]; -} -}]; -``` - -## Swift - -**retrieveAvailableTagsWithCompletionHandler** API는 디바이스가 구독하는 데 사용할 수 있는 모든 태그의 목록을 리턴합니다. 디바이스가 특정 태그에 구독되면 디바이스는 해당 태그에 대해 전송되는 모든 푸시 알림을 수신할 수 있습니다. - -태그 구독을 위해 푸시 서비스를 호출합니다. - -디바이스가 구독된 사용 가능한 태그 목록을 가져오고 디바이스가 구독할 수 있는 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 Swift 모바일 애플리케이션에 복사하십시오. - - -``` -//Get a list of available tags to which the device can subscribe -push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void inif error.isEmpty { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else{ - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - - print( "Response during retrieving subscribed tags : \(response.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - - - +# 태그 가져오기 +{: #get_tags} + +태그는 모든 애플리케이션에 전송되는 일반 브로드캐스트와 달리 관심사를 기반으로 수신인에게 맞춤형 알림을 전송하는 방법을 제공합니다. 푸시 대시보드의 태그 탭을 사용하여 태그를 작성 및 관리하거나 REST API를 사용할 수 있습니다. 다음 섹션의 코드 스니펫을 사용하여 모바일 애플리케이션에 대한 태그 구독을 관리 및 조회할 수 있습니다. 이 코드 스니펫을 사용하여 구독을 가져오고 태그를 구독하며 태그 구독을 취소하고 사용 가능한 태그 목록을 가져올 수 있습니다. 코드 스니펫을 모바일 애플리케이션에 복사하고 붙여넣으십시오. + +## Android + +**getTags** API는 디바이스를 구독할 수 있는 사용 가능한 태그 목록을 리턴합니다. 디바이스가 특정 태그에 구독되면 디바이스는 해당 태그에 대해 전송되는 모든 푸시 알림을 수신할 수 있습니다. + +디바이스가 구독된 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 Android 모바일 애플리케이션에 복사하십시오. + +디바이스가 구독할 수 있는 사용 가능 태그 목록을 가져오려면 다음 **getTags** API를 사용하십시오. + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + +디바이스가 구독된 태그 목록을 가져오려면 **getSubscriptions** API를 사용하십시오. + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { +@Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) +``` + +## Cordova + +디바이스가 구독된 사용 가능한 태그 목록을 가져오고 디바이스가 구독할 수 있는 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 모바일 애플리케이션에 복사하십시오. + +구독에 사용할 수 있는 태그의 배열을 검색하십시오. + +``` +//Get a list of available tags to which the device can subscribe +MFPPush.retrieveAvailableTags(function(tags) {alert(tags); +}, null); +``` + +``` +//Get a list of available tags to which the device is subscribed. +MFPPush.getSubscriptionStatus(function(tags) { +alert(tags); +}, null); +``` + +## Objective-C + +디바이스가 구독된 사용 가능한 태그 목록을 가져오고 디바이스가 구독할 수 있는 사용 가능한 태그 목록을 가져오려면 Objective-C를 사용하여 개발된 iOS 애플리케이션으로 다음 코드 스니펫을 복사하십시오. + +디바이스가 구독할 수 있는 사용 가능 태그 목록을 가져오려면 다음 **retrieveAvailableTags** API를 사용하십시오. + +``` +//Get a list of available tags to which the device can subscribe +[push retrieveAvailableTagsWithCompletionHandler: +^(IMFResponse *response, NSError *error){ + if (error){[ self updateMessage:error.description];} +else { + [self updateMessage:@"Successfully retrieved available tags."]; + NSDictionary *availableTags = [[NSDictionary alloc]init]; + availableTags = [response tags]; +[self.appDelegateVC updateMessage:availableTags.description]; +} +}]; +``` + +디바이스가 구독된 태그 목록을 가져오려면 **retrieveSubscriptions** API를 사용하십시오. + + + +``` +// Get a list of tags that to which the device is subscribed. +[push retrieveSubscriptionsWithCompletionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved subscriptions."]; + NSDictionary *subscribedTags = [[NSDictionary alloc]init]; +subscribedTags = [response subscriptions]; +[self.appDelegateVC updateMessage:subscribedTags.description]; +} +}]; +``` + +## Swift + +**retrieveAvailableTagsWithCompletionHandler** API는 디바이스가 구독하는 데 사용할 수 있는 모든 태그의 목록을 리턴합니다. 디바이스가 특정 태그에 구독되면 디바이스는 해당 태그에 대해 전송되는 모든 푸시 알림을 수신할 수 있습니다. + +태그 구독을 위해 푸시 서비스를 호출합니다. + +디바이스가 구독된 사용 가능한 태그 목록을 가져오고 디바이스가 구독할 수 있는 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 Swift 모바일 애플리케이션에 복사하십시오. + + +``` +//Get a list of available tags to which the device can subscribe +push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void inif error.isEmpty { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else{ + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + + print( "Response during retrieving subscribed tags : \(response.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + + + diff --git a/services/mobilepush/nl/ko/t_handle_actionable_notifications_ios.md b/services/mobilepush/nl/ko/t_handle_actionable_notifications_ios.md index 42ab684bf..994bfd6ca 100644 --- a/services/mobilepush/nl/ko/t_handle_actionable_notifications_ios.md +++ b/services/mobilepush/nl/ko/t_handle_actionable_notifications_ios.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# iOS의 조치 가능 알림 처리 -{: #actionable-notifications} - - -조치 가능 알림이 수신되면 선택한 ID를 기반으로 다음 메소드에 제어가 전달됩니다. - -###Objective-C - -``` -(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: -(UILocalNotification *)notification completionHandler:(void (^)())completionHandler -{ - NSLog(@"actionable notification received."); - //must call completion handler when finished - completionHandler(); -} -``` - -###Swift - -``` -func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { -//must call completion handler when finished - completionHandler() - } -``` - - +--- + +copyright: + years: 2015, 2016 + +--- + +# iOS의 조치 가능 알림 처리 +{: #actionable-notifications} + + +조치 가능 알림이 수신되면 선택한 ID를 기반으로 다음 메소드에 제어가 전달됩니다. + +### Objective-C + +``` +(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: +(UILocalNotification *)notification completionHandler:(void (^)())completionHandler +{ + NSLog(@"actionable notification received."); + //must call completion handler when finished + completionHandler(); +} +``` + +### Swift + +``` +func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { +//must call completion handler when finished + completionHandler() + } +``` + + diff --git a/services/mobilepush/nl/ko/t_holding_notifications_android.md b/services/mobilepush/nl/ko/t_holding_notifications_android.md index 348a786cd..7e6129ad4 100644 --- a/services/mobilepush/nl/ko/t_holding_notifications_android.md +++ b/services/mobilepush/nl/ko/t_holding_notifications_android.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Android의 보류 알림 -{: #hold-notifications-android} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - -애플리케이션이 백그라운드로 전환되는 경우 {{site.data.keyword.mobilepushshort}} 서비스에서 애플리케이션에 전송되는 알림을 보유할 수 있습니다. 알림을 보류하려면 {{site.data.keyword.mobilepushshort}}를 처리하는 활동의 onPause() 메소드에서 hold() 메소드를 호출하십시오. - -``` - @Override - protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Android의 보류 알림 +{: #hold-notifications-android} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + +애플리케이션이 백그라운드로 전환되는 경우 {{site.data.keyword.mobilepushshort}} 서비스에서 애플리케이션에 전송되는 알림을 보유할 수 있습니다. 알림을 보류하려면 {{site.data.keyword.mobilepushshort}}를 처리하는 활동의 onPause() 메소드에서 hold() 메소드를 호출하십시오. + +``` + @Override + protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/ko/t_manage_tags.md b/services/mobilepush/nl/ko/t_manage_tags.md index 56e396511..dafca8f23 100644 --- a/services/mobilepush/nl/ko/t_manage_tags.md +++ b/services/mobilepush/nl/ko/t_manage_tags.md @@ -1,347 +1,347 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 태그 관리 -{: #manage_tags} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - -{{site.data.keyword.mobilepushshort}} 대시보드를 사용하여 애플리케이션의 태그를 작성 및 삭제하고 태그 기반 알림을 시작합니다. 태그를 구독하는 디바이스에서 태그 기반 알림이 수신됩니다. - - -## 태그 작성 -{: #create_tags} - -태그 기반 알림은 특정 태그를 구독하는 모든 디바이스를 대상으로 하는 메시지입니다. 각 디바이스는 수에 관계 없이 태그를 구독할 수 있습니다. 태그가 삭제되면 태그 구독자와 디바이스를 비롯한 해당 태그와 연관된 정보가 삭제됩니다. 태그가 더 이상 존재하지 않으므로 자동 구독 해지가 필요하지 않습니다. 클라이언트 측에서 추가 조치가 필요하지 않습니다. - -1. {{site.data.keyword.mobilepushshort}} 대시보드에서 **태그** 탭을 선택하십시오. -1. + **태그 작성** 단추를 클릭하십시오. - 1. **이름** 필드에 태그의 이름을 입력하십시오. 예를 들어, "coupons"를 입력하십시오. - 1. **설명** 필드에 태그 설명을 입력하십시오. - 1. **저장**을 클릭하십시오. - -1. **코드 스니펫** 영역에서 모바일 애플리케이션에 대한 플랫폼을 선택하십시오. -1. 코드 스니펫을 수정하여 오류를 수정한 다음 각 태그의 코드 스니펫을 모바일 애플리케이션에 복사하십시오. - -## 태그 삭제 -{: #delete_tags} - -1. **태그** 탭에서 삭제할 태그를 선택하고 **삭제** 아이콘을 클릭하십시오. -1. **확인**을 클릭하십시오. - -## 태그 설명 편집 -{: #edit_tags} - -1. **태그** 탭에서 편집할 탭을 선택하십시오. -1. **편집** 아이콘을 클릭하십시오. -1. 태그 설명을 편집하고 **저장** 단추를 클릭하십시오. - -# 태그 가져오기 -{: #get_tags} - -태그는 모든 애플리케이션에 전송되는 일반 브로드캐스트와 달리 관심사를 기반으로 수신인에게 맞춤형 알림을 전송하는 방법을 제공합니다. {{site.data.keyword.mobilepushshort}} 대시보드의 태그 탭을 사용하여 태그를 작성 및 관리하거나 REST API를 사용할 수 있습니다. 코드 스니펫을 사용하여 모바일 애플리케이션에 대한 태그 구독을 관리 및 조회할 수 있습니다. 이러한 코드 스니펫을 사용하여 구독을 가져오고 태그를 구독하며 태그 구독을 취소하고 사용 가능한 태그 목록을 가져올 수 있습니다. 이러한 코드 스니펫을 모바일 애플리케이션에 복사하십시오. - -## Android에서 태그 가져오기 -{: android-get-tags} - -**getTags** API는 디바이스를 구독할 수 있는 사용 가능한 태그 목록을 리턴합니다. 디바이스에서 특정 태그를 구독하면 디바이스가 해당 태그와 관련하여 전송되는 {{site.data.keyword.mobilepushshort}}를 수신할 수 있습니다. - -디바이스가 구독하는 태그 목록을 가져오고 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 Android 모바일 애플리케이션에 복사하십시오. - -디바이스가 구독할 수 있는 사용 가능 태그 목록을 가져오려면 다음 **getTags** API를 사용하십시오. - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - {: codeblock} - -디바이스가 구독된 태그 목록을 가져오려면 **getSubscriptions** API를 사용하십시오. - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) - ``` - {: codeblock} - -## Cordova에서 태그 가져오기 -{: cordova-get-tags} - -디바이스가 구독하는 태그 목록과 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 모바일 애플리케이션에 복사하십시오. - -구독에 사용할 수 있는 태그의 배열을 검색하십시오. - -``` -//Get a list of available tags to which the device can subscribe -BMSPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed. -BMSPush.retrieveSubscriptions(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - - -## Swift에서 태그 가져오기 -{: swift-get-tags} - -**retrieveAvailableTagsWithCompletionHandler** API는 디바이스가 구독하는 데 사용할 수 있는 모든 태그의 목록을 리턴합니다. 디바이스에서 특정 태그를 구독하면 디바이스가 해당 태그와 관련하여 전송되는 {{site.data.keyword.mobilepushshort}}를 수신할 수 있습니다. - -태그를 구독하려면 {{site.data.keyword.mobilepushshort}}를 호출하십시오. - -디바이스가 구독된 사용 가능한 태그 목록을 가져오고 디바이스가 구독할 수 있는 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 Swift 모바일 애플리케이션에 복사하십시오. -``` -//Get a list of available tags to which the device can subscribe - push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - if error.isEmpty - { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else - { - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - - print( "Response during retrieving subscribed tags : \(response?.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else - { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -## Google Chrome, Safari 및 Mozilla Firefox -{: web-get-tags} - -고객이 구독할 수 있는 사용 가능한 태그 목록을 얻으려면 다음 코드를 사용하십시오. - -``` -var bmsPush = new BMSPush(); -bmsPush.retrieveAvailableTags(function(response) -{ - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) -{ - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - - -## Google Chrome 앱 및 확장 프로그램 -{: web-get-tags} - -고객이 구독할 수 있는 사용 가능한 태그 목록을 얻으려면 다음 코드를 사용하십시오. - -``` -var bmsPush = new BMSPush(); -bmsPush.retrieveAvailableTags(function(response) -{ - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) -{ - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - -고객이 구독한 태그 목록을 가져오려면 다음 코드 스니펫을 Google Chrome 앱과 확장 프로그램에 복사하십시오. - -``` -var bmsPush = new BMSPush(); -bmsPush.retrieveSubscriptions(function(response) -{ - alert(response.response) - }) -``` - {: codeblock} - - -# 태그 구독 및 구독 해지 -{: #Subscribe_tags} - -다음 코드 스니펫을 사용하여 사용자 디바이스가 구독을 가져오고, 태그를 구독하고, 태그를 구독 해지할 수 있도록 합니다. - -## Android에서 태그 구독 및 구독 해지 -{: android-subscribe-tags} - -다음 코드 스니펫을 복사하여 Android 모바일 애플리케이션에 붙여넣으십시오. - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - {: codeblock} - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - {: codeblock} - -## Cordova에서 태그 구독 및 구독 해지 -{: cordova-subscribe-tags} - -다음 코드 스니펫을 복사하여 Cordova 모바일 애플리케이션에 붙여넣으십시오. - -``` -var tag = "YourTag"; -BMSPush.subscribe(tag, success, failure); -BMSPush.unsubscribe(tag, success, failure); -``` - {: codeblock} - - -## Swift에서 태그 구독 및 구독 해지 -{: swift-subscribe-tags} - -다음 코드 스니펫을 복사하여 Swift 모바일 애플리케이션에 붙여넣으십시오. - -태그를 구독하려면 **subscribeToTags** API를 사용하십시오. - -``` -push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print("Response when subscribing to tags: \(response?.description)") - print("Status code when subscribing to tags: \(statusCode)") - } else { - print("Error when subscribing to tags: \(error) ") - print("Error status code when subscribing to tags: \(statusCode)") - } -}) -``` - {: codeblock} - -태그 구독을 취소하려면 **unsubscribeFromTags** API를 사용하십시오. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during unsubscribed tags : \(response?.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - {: codeblock} - -## Google Chrome 및 Mozilla Firefox -{: web-subscribe-tags} - -웹 애플리케이션에서 태그를 구독하려면 다음 코드 스니펫을 사용하십시오. - -``` -var tagsArray = ["tag1", "Tag2"] -bmsPush.subscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -태그 구독을 취소하려면 **unSubscribe** 메소드를 사용합니다. - -``` -var tagsArray = ["tag1", "Tag2"] - bmsPush.unSubscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -# 태그 기반 알림 사용 -{: #using_tags} - -태그 기반 알림은 특정 태그를 구독하는 모든 디바이스를 대상으로 하는 메시지입니다. 각 디바이스는 원하는 수만큼의 태그에 대해 구독이 가능합니다. 이 주제에서는 태그 기반 알림의 전송 방법에 대해 설명합니다. {{site.data.keyword.mobilepushshort}} 서비스 Bluemix 인스턴스에서 구독을 유지보수합니다. 태그가 삭제되면 태그 구독자와 디바이스를 비롯한 해당 태그와 연관된 모든 정보가 삭제됩니다. 이 태그가 더 이상 존재하지 않고 클라이언트측에서 추가 조치가 필요하지 않으므로 이 태그에 대해 자동 구독 해지 조치가 필요하지 않습니다. - -**태그** 화면에서 태그를 작성하십시오. 태그 작성 방법에 대한 정보는 [태그 작성](t_manage_tags.html)을 참조하십시오. - -1. **푸시 알림** 대시보드에서 **알림 전송**을 클릭하십시오. -1. **받는 사람** 드롭 다운 목록에서 **태그별 디바이스** 옵션을 선택하십시오. -1. 사용할 태그를 검색하여 선택하십시오. -![알림 화면](images/tag_notification.jpg) -1. **메시지 텍스트** 필드에서 알림으로 구독자에게 전송될 텍스트를 입력하십시오. -1. **전송**을 클릭하십시오. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 태그 관리 +{: #manage_tags} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + +{{site.data.keyword.mobilepushshort}} 대시보드를 사용하여 애플리케이션의 태그를 작성 및 삭제하고 태그 기반 알림을 시작합니다. 태그를 구독하는 디바이스에서 태그 기반 알림이 수신됩니다. + + +## 태그 작성 +{: #create_tags} + +태그 기반 알림은 특정 태그를 구독하는 모든 디바이스를 대상으로 하는 메시지입니다. 각 디바이스는 수에 관계 없이 태그를 구독할 수 있습니다. 태그가 삭제되면 태그 구독자와 디바이스를 비롯한 해당 태그와 연관된 정보가 삭제됩니다. 태그가 더 이상 존재하지 않으므로 자동 구독 해지가 필요하지 않습니다. 클라이언트 측에서 추가 조치가 필요하지 않습니다. + +1. {{site.data.keyword.mobilepushshort}} 대시보드에서 **태그** 탭을 선택하십시오. +1. + **태그 작성** 단추를 클릭하십시오. + 1. **이름** 필드에 태그의 이름을 입력하십시오. 예를 들어, "coupons"를 입력하십시오. + 1. **설명** 필드에 태그 설명을 입력하십시오. + 1. **저장**을 클릭하십시오. + +1. **코드 스니펫** 영역에서 모바일 애플리케이션에 대한 플랫폼을 선택하십시오. +1. 코드 스니펫을 수정하여 오류를 수정한 다음 각 태그의 코드 스니펫을 모바일 애플리케이션에 복사하십시오. + +## 태그 삭제 +{: #delete_tags} + +1. **태그** 탭에서 삭제할 태그를 선택하고 **삭제** 아이콘을 클릭하십시오. +1. **확인**을 클릭하십시오. + +## 태그 설명 편집 +{: #edit_tags} + +1. **태그** 탭에서 편집할 탭을 선택하십시오. +1. **편집** 아이콘을 클릭하십시오. +1. 태그 설명을 편집하고 **저장** 단추를 클릭하십시오. + +# 태그 가져오기 +{: #get_tags} + +태그는 모든 애플리케이션에 전송되는 일반 브로드캐스트와 달리 관심사를 기반으로 수신인에게 맞춤형 알림을 전송하는 방법을 제공합니다. {{site.data.keyword.mobilepushshort}} 대시보드의 태그 탭을 사용하여 태그를 작성 및 관리하거나 REST API를 사용할 수 있습니다. 코드 스니펫을 사용하여 모바일 애플리케이션에 대한 태그 구독을 관리 및 조회할 수 있습니다. 이러한 코드 스니펫을 사용하여 구독을 가져오고 태그를 구독하며 태그 구독을 취소하고 사용 가능한 태그 목록을 가져올 수 있습니다. 이러한 코드 스니펫을 모바일 애플리케이션에 복사하십시오. + +## Android에서 태그 가져오기 +{: android-get-tags} + +**getTags** API는 디바이스를 구독할 수 있는 사용 가능한 태그 목록을 리턴합니다. 디바이스에서 특정 태그를 구독하면 디바이스가 해당 태그와 관련하여 전송되는 {{site.data.keyword.mobilepushshort}}를 수신할 수 있습니다. + +디바이스가 구독하는 태그 목록을 가져오고 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 Android 모바일 애플리케이션에 복사하십시오. + +디바이스가 구독할 수 있는 사용 가능 태그 목록을 가져오려면 다음 **getTags** API를 사용하십시오. + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + {: codeblock} + +디바이스가 구독된 태그 목록을 가져오려면 **getSubscriptions** API를 사용하십시오. + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) + ``` + {: codeblock} + +## Cordova에서 태그 가져오기 +{: cordova-get-tags} + +디바이스가 구독하는 태그 목록과 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 모바일 애플리케이션에 복사하십시오. + +구독에 사용할 수 있는 태그의 배열을 검색하십시오. + +``` +//Get a list of available tags to which the device can subscribe +BMSPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed. +BMSPush.retrieveSubscriptions(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + + +## Swift에서 태그 가져오기 +{: swift-get-tags} + +**retrieveAvailableTagsWithCompletionHandler** API는 디바이스가 구독하는 데 사용할 수 있는 모든 태그의 목록을 리턴합니다. 디바이스에서 특정 태그를 구독하면 디바이스가 해당 태그와 관련하여 전송되는 {{site.data.keyword.mobilepushshort}}를 수신할 수 있습니다. + +태그를 구독하려면 {{site.data.keyword.mobilepushshort}}를 호출하십시오. + +디바이스가 구독된 사용 가능한 태그 목록을 가져오고 디바이스가 구독할 수 있는 사용 가능한 태그 목록을 가져오려면 다음 코드 스니펫을 Swift 모바일 애플리케이션에 복사하십시오. +``` +//Get a list of available tags to which the device can subscribe + push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + if error.isEmpty + { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else + { + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + + print( "Response during retrieving subscribed tags : \(response?.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else + { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +## Google Chrome, Safari 및 Mozilla Firefox +{: web-get-tags} + +고객이 구독할 수 있는 사용 가능한 태그 목록을 얻으려면 다음 코드를 사용하십시오. + +``` +var bmsPush = new BMSPush(); +bmsPush.retrieveAvailableTags(function(response) +{ + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) +{ + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + + +## Google Chrome 앱 및 확장 프로그램 +{: web-get-tags} + +고객이 구독할 수 있는 사용 가능한 태그 목록을 얻으려면 다음 코드를 사용하십시오. + +``` +var bmsPush = new BMSPush(); +bmsPush.retrieveAvailableTags(function(response) +{ + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) +{ + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + +고객이 구독한 태그 목록을 가져오려면 다음 코드 스니펫을 Google Chrome 앱과 확장 프로그램에 복사하십시오. + +``` +var bmsPush = new BMSPush(); +bmsPush.retrieveSubscriptions(function(response) +{ + alert(response.response) + }) +``` + {: codeblock} + + +# 태그 구독 및 구독 해지 +{: #Subscribe_tags} + +다음 코드 스니펫을 사용하여 사용자 디바이스가 구독을 가져오고, 태그를 구독하고, 태그를 구독 해지할 수 있도록 합니다. + +## Android에서 태그 구독 및 구독 해지 +{: android-subscribe-tags} + +다음 코드 스니펫을 복사하여 Android 모바일 애플리케이션에 붙여넣으십시오. + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + {: codeblock} + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + {: codeblock} + +## Cordova에서 태그 구독 및 구독 해지 +{: cordova-subscribe-tags} + +다음 코드 스니펫을 복사하여 Cordova 모바일 애플리케이션에 붙여넣으십시오. + +``` +var tag = "YourTag"; +BMSPush.subscribe(tag, success, failure); +BMSPush.unsubscribe(tag, success, failure); +``` + {: codeblock} + + +## Swift에서 태그 구독 및 구독 해지 +{: swift-subscribe-tags} + +다음 코드 스니펫을 복사하여 Swift 모바일 애플리케이션에 붙여넣으십시오. + +태그를 구독하려면 **subscribeToTags** API를 사용하십시오. + +``` +push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print("Response when subscribing to tags: \(response?.description)") + print("Status code when subscribing to tags: \(statusCode)") + } else { + print("Error when subscribing to tags: \(error) ") + print("Error status code when subscribing to tags: \(statusCode)") + } +}) +``` + {: codeblock} + +태그 구독을 취소하려면 **unsubscribeFromTags** API를 사용하십시오. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during unsubscribed tags : \(response?.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + {: codeblock} + +## Google Chrome 및 Mozilla Firefox +{: web-subscribe-tags} + +웹 애플리케이션에서 태그를 구독하려면 다음 코드 스니펫을 사용하십시오. + +``` +var tagsArray = ["tag1", "Tag2"] +bmsPush.subscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +태그 구독을 취소하려면 **unSubscribe** 메소드를 사용합니다. + +``` +var tagsArray = ["tag1", "Tag2"] + bmsPush.unSubscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +# 태그 기반 알림 사용 +{: #using_tags} + +태그 기반 알림은 특정 태그를 구독하는 모든 디바이스를 대상으로 하는 메시지입니다. 각 디바이스는 원하는 수만큼의 태그에 대해 구독이 가능합니다. 이 주제에서는 태그 기반 알림의 전송 방법에 대해 설명합니다. {{site.data.keyword.mobilepushshort}} 서비스 Bluemix 인스턴스에서 구독을 유지보수합니다. 태그가 삭제되면 태그 구독자와 디바이스를 비롯한 해당 태그와 연관된 모든 정보가 삭제됩니다. 이 태그가 더 이상 존재하지 않고 클라이언트측에서 추가 조치가 필요하지 않으므로 이 태그에 대해 자동 구독 해지 조치가 필요하지 않습니다. + +**태그** 화면에서 태그를 작성하십시오. 태그 작성 방법에 대한 정보는 [태그 작성](t_manage_tags.html)을 참조하십시오. + +1. **푸시 알림** 대시보드에서 **알림 전송**을 클릭하십시오. +1. **받는 사람** 드롭 다운 목록에서 **태그별 디바이스** 옵션을 선택하십시오. +1. 사용할 태그를 검색하여 선택하십시오. +![알림 화면](images/tag_notification.jpg) +1. **메시지 텍스트** 필드에서 알림으로 구독자에게 전송될 텍스트를 입력하십시오. +1. **전송**을 클릭하십시오. diff --git a/services/mobilepush/nl/ko/t_manage_user.md b/services/mobilepush/nl/ko/t_manage_user.md index 927e41516..36304c459 100644 --- a/services/mobilepush/nl/ko/t_manage_user.md +++ b/services/mobilepush/nl/ko/t_manage_user.md @@ -1,166 +1,166 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 사용자 ID를 사용하여 디바이스 등록 -{: #register_device_with_userId} -마지막 업데이트 날짜: 2017년 2월 06일 -{: .last-updated} - -사용자 ID 기반 알림에 등록하려면 다음 단계를 완료하십시오. - -## Android -{: android-register} - -{{site.data.keyword.mobilepushshort}} 서비스의 `AppGUID`와 `clientSecret` 키를 사용하여 MFPPush 클래스를 초기화하십시오. -``` -// Initialize the Push Notifications service -push = MFPPush.getInstance(); -push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); -``` - {: codeblock} - - -- **AppGUID**: {{site.data.keyword.mobilepushshort}} 서비스의 AppGUID입니다. -- **clientSecret**: {{site.data.keyword.mobilepushshort}} 서비스의 clientSecret 키입니다. - - **registerDeviceWithUserId** API를 사용하여 {{site.data.keyword.mobilepushshort}}를 받을 디바이스를 등록하십시오. - -``` -// Register the device to Push Notifications -push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - Log.d("Device is registered with Push Service.");} - @Override - public void onFailure(MFPPushException ex) { - Log.d("Error registering with Push Service...\n" - + "Push notifications will not be received."); - } - }); -``` - {: codeblock} - -- **사용자 ID**: {{site.data.keyword.mobilepushshort}}에 등록하기 위한 고유 사용자 ID 값을 전달하십시오. - -**참고:** UserId로 대상이 지정되는 {{site.data.keyword.mobilepushshort}}를 사용하려면 UserId를 사용하여 디바이스를 등록하고 {{site.data.keyword.mobilepushshort}} 서비스가 프로비저닝될 때 할당되는 'clientSecret'을 전달해야 합니다. 올바른 clientSecret이 없으면 디바이스 등록에 실패합니다. - -## Cordova -{: cordova} - -다음 API를 사용하여 UserId 기반 {{site.data.keyword.mobilepushshort}}를 받도록 등록하십시오. - -``` -// Register device for Push Notification with UserId -var options = {"userId": "Your User Id value"}; -BMSPush.registerDevice(options,success, failure); -``` - {: codeblock} - - -- **사용자 ID**: {{site.data.keyword.mobilepushshort}}에 등록하기 위한 고유 사용자 ID 값을 전달하십시오. - - -## Swift -{: swift-register} - -``` -// Initialize the BMSPushClient -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -- **AppGUID**: {{site.data.keyword.mobilepushshort}} 서비스의 AppGUID입니다. -- **clientSecret**: {{site.data.keyword.mobilepushshort}} 서비스의 clientSecret 키입니다. - -**registerWithUserId** API를 사용하여 {{site.data.keyword.mobilepushshort}}를 받을 디바이스를 등록하십시오. - -``` -// Register the device to Push Notifications service -push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in -if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } else { - print( "Error during device registration \(error) ") - } - } -``` - {: codeblock} - -- **사용자 ID**: {{site.data.keyword.mobilepushshort}}에 등록하기 위한 고유 사용자 ID 값을 전달하십시오. - -## Google Chrome, Safari 및 Mozilla Firefox -{: web-register} - -사용자 ID 기반 알림에 등록하려면 다음 API를 사용하십시오. `app GUID`, `app Region` 및 `Client Secret`을 사용하여 SDK를 초기화하십시오. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -초기화가 완료되면 사용자 ID를 사용하여 웹 애플리케이션을 등록하십시오. - -``` - bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -## Google Chrome 앱 및 확장 프로그램 -{: web-register-new} - -사용자 ID 기반 알림에 등록하려면 다음 API를 사용하십시오. `app GUID`, `app Region` 및 `Client Secret`을 사용하여 SDK를 초기화하십시오. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -초기화가 완료되면 사용자 ID로 웹 애플리케이션을 등록해야 합니다. - -``` - bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -# 사용자 ID 기반 알림 사용 -{: #using_userid} - -사용자 ID 기반 알림은 특정 사용자를 대상으로 하는 알림 메시지입니다. 하나의 사용자에 여러 디바이스를 등록할 수 있습니다. 다음 단계는 사용자 ID 기반 알림을 전송하는 방법에 대해 설명합니다. - -1. **푸시 알림** 대시보드에서 **알림 전송** 옵션을 선택하십시오. -1. **받는 사람** 옵션 목록에서 **사용자 ID**를 선택하십시오. -1. **사용자 ID** 필드에서 사용하려는 사용자 ID를 검색한 후 **+추가**를 클릭하십시오. ![알림 화면](images/user_notification.jpg) -1. **메시지** 필드에 알림에서 전송할 텍스트를 입력하십시오. -1. **전송**을 클릭하십시오. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 사용자 ID를 사용하여 디바이스 등록 +{: #register_device_with_userId} +마지막 업데이트 날짜: 2017년 2월 06일 +{: .last-updated} + +사용자 ID 기반 알림에 등록하려면 다음 단계를 완료하십시오. + +## Android +{: android-register} + +{{site.data.keyword.mobilepushshort}} 서비스의 `AppGUID`와 `clientSecret` 키를 사용하여 MFPPush 클래스를 초기화하십시오. +``` +// Initialize the Push Notifications service +push = MFPPush.getInstance(); +push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); +``` + {: codeblock} + + +- **AppGUID**: {{site.data.keyword.mobilepushshort}} 서비스의 AppGUID입니다. +- **clientSecret**: {{site.data.keyword.mobilepushshort}} 서비스의 clientSecret 키입니다. + + **registerDeviceWithUserId** API를 사용하여 {{site.data.keyword.mobilepushshort}}를 받을 디바이스를 등록하십시오. + +``` +// Register the device to Push Notifications +push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + Log.d("Device is registered with Push Service.");} + @Override + public void onFailure(MFPPushException ex) { + Log.d("Error registering with Push Service...\n" + + "Push notifications will not be received."); + } + }); +``` + {: codeblock} + +- **사용자 ID**: {{site.data.keyword.mobilepushshort}}에 등록하기 위한 고유 사용자 ID 값을 전달하십시오. + +**참고:** UserId로 대상이 지정되는 {{site.data.keyword.mobilepushshort}}를 사용하려면 UserId를 사용하여 디바이스를 등록하고 {{site.data.keyword.mobilepushshort}} 서비스가 프로비저닝될 때 할당되는 'clientSecret'을 전달해야 합니다. 올바른 clientSecret이 없으면 디바이스 등록에 실패합니다. + +## Cordova +{: cordova} + +다음 API를 사용하여 UserId 기반 {{site.data.keyword.mobilepushshort}}를 받도록 등록하십시오. + +``` +// Register device for Push Notification with UserId +var options = {"userId": "Your User Id value"}; +BMSPush.registerDevice(options,success, failure); +``` + {: codeblock} + + +- **사용자 ID**: {{site.data.keyword.mobilepushshort}}에 등록하기 위한 고유 사용자 ID 값을 전달하십시오. + + +## Swift +{: swift-register} + +``` +// Initialize the BMSPushClient +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +- **AppGUID**: {{site.data.keyword.mobilepushshort}} 서비스의 AppGUID입니다. +- **clientSecret**: {{site.data.keyword.mobilepushshort}} 서비스의 clientSecret 키입니다. + +**registerWithUserId** API를 사용하여 {{site.data.keyword.mobilepushshort}}를 받을 디바이스를 등록하십시오. + +``` +// Register the device to Push Notifications service +push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in +if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } else { + print( "Error during device registration \(error) ") + } + } +``` + {: codeblock} + +- **사용자 ID**: {{site.data.keyword.mobilepushshort}}에 등록하기 위한 고유 사용자 ID 값을 전달하십시오. + +## Google Chrome, Safari 및 Mozilla Firefox +{: web-register} + +사용자 ID 기반 알림에 등록하려면 다음 API를 사용하십시오. `app GUID`, `app Region` 및 `Client Secret`을 사용하여 SDK를 초기화하십시오. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +초기화가 완료되면 사용자 ID를 사용하여 웹 애플리케이션을 등록하십시오. + +``` + bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +## Google Chrome 앱 및 확장 프로그램 +{: web-register-new} + +사용자 ID 기반 알림에 등록하려면 다음 API를 사용하십시오. `app GUID`, `app Region` 및 `Client Secret`을 사용하여 SDK를 초기화하십시오. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +초기화가 완료되면 사용자 ID로 웹 애플리케이션을 등록해야 합니다. + +``` + bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +# 사용자 ID 기반 알림 사용 +{: #using_userid} + +사용자 ID 기반 알림은 특정 사용자를 대상으로 하는 알림 메시지입니다. 하나의 사용자에 여러 디바이스를 등록할 수 있습니다. 다음 단계는 사용자 ID 기반 알림을 전송하는 방법에 대해 설명합니다. + +1. **푸시 알림** 대시보드에서 **알림 전송** 옵션을 선택하십시오. +1. **받는 사람** 옵션 목록에서 **사용자 ID**를 선택하십시오. +1. **사용자 ID** 필드에서 사용하려는 사용자 ID를 검색한 후 **+추가**를 클릭하십시오. ![알림 화면](images/user_notification.jpg) +1. **메시지** 필드에 알림에서 전송할 텍스트를 입력하십시오. +1. **전송**을 클릭하십시오. diff --git a/services/mobilepush/nl/ko/t_push_ios_nextsteps.md b/services/mobilepush/nl/ko/t_push_ios_nextsteps.md index b8817e82e..b0fadac75 100644 --- a/services/mobilepush/nl/ko/t_push_ios_nextsteps.md +++ b/services/mobilepush/nl/ko/t_push_ios_nextsteps.md @@ -1,21 +1,21 @@ - ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# 다음 단계 - -{: #push-ios-nextsteps} - -정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. - -다음의 푸시 알림 서비스 기능을 사용자의 앱에 추가하십시오. - - - -- 태그 기반 알림을 사용하려면 [태그 기반 알림](t_push_tagsmain.md)을 참조하십시오. -- 고급 알림 옵션을 사용하려면 [고급 푸시 알림](t_advance_notifications.md)을 참조하십시오. + +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# 다음 단계 + +{: #push-ios-nextsteps} + +정상적으로 기본 알림을 설정한 후 태그 기반 알림 및 고급 옵션을 구성할 수 있습니다. + +다음의 푸시 알림 서비스 기능을 사용자의 앱에 추가하십시오. + + + +- 태그 기반 알림을 사용하려면 [태그 기반 알림](t_push_tagsmain.md)을 참조하십시오. +- 고급 알림 옵션을 사용하려면 [고급 푸시 알림](t_advance_notifications.md)을 참조하십시오. diff --git a/services/mobilepush/nl/ko/t_push_monitoring.md b/services/mobilepush/nl/ko/t_push_monitoring.md index b2d47f308..d1db0611f 100644 --- a/services/mobilepush/nl/ko/t_push_monitoring.md +++ b/services/mobilepush/nl/ko/t_push_monitoring.md @@ -1,33 +1,33 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 푸시 알림 모니터링 -{: #monitor-notifications} -마지막 업데이트 날짜: 2017년 1월 16일 -{: .last-updated} - - -IBM {{site.data.keyword.mobilepushshort}} 서비스가 확장되어 이제 사용자 데이터에서 그래프를 생성하여 푸시 성능을 모니터할 수 있는 기능을 제공합니다. 유틸리티를 사용하여 일별, 주별 또는 월별 기준으로 전송된 푸시 알림을 모두 나열하거나 등록된 디바이스를 모두 나열하여 정보를 분석할 수 있습니다. - -전송된 모든 알림에 대한 보고서를 생성하려면 [REST API](https://mobile.{DomainName}/imfpush/){: new_window}에 있는 푸시 메시지 GET 메소드를 사용하십시오. - -![발송된 알림 보고서](images/monitoring_messages.jpg) - - -등록된 모든 디바이스에 관한 보고서를 생성하려면 [REST API](https://mobile.{DomainName}/imfpush/){: new_window}의 푸시 디바이스 등록 GET 보고서 메소드를 사용하십시오. - -![등록된 디바이스 보고서](images/monitoring_devices.jpg) - -Android SDK를 업데이트하여 알림 정보를 모니터하는 방법은 [Android 디바이스에서 푸시 알림 모니터링](c_android_enable.html#android_monitor)을 참조하십시오. - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 푸시 알림 모니터링 +{: #monitor-notifications} +마지막 업데이트 날짜: 2017년 1월 16일 +{: .last-updated} + + +IBM {{site.data.keyword.mobilepushshort}} 서비스가 확장되어 이제 사용자 데이터에서 그래프를 생성하여 푸시 성능을 모니터할 수 있는 기능을 제공합니다. 유틸리티를 사용하여 일별, 주별 또는 월별 기준으로 전송된 푸시 알림을 모두 나열하거나 등록된 디바이스를 모두 나열하여 정보를 분석할 수 있습니다. + +전송된 모든 알림에 대한 보고서를 생성하려면 [REST API](https://mobile.{DomainName}/imfpush/){: new_window}에 있는 푸시 메시지 GET 메소드를 사용하십시오. + +![발송된 알림 보고서](images/monitoring_messages.jpg) + + +등록된 모든 디바이스에 관한 보고서를 생성하려면 [REST API](https://mobile.{DomainName}/imfpush/){: new_window}의 푸시 디바이스 등록 GET 보고서 메소드를 사용하십시오. + +![등록된 디바이스 보고서](images/monitoring_devices.jpg) + +Android SDK를 업데이트하여 알림 정보를 모니터하는 방법은 [Android 디바이스에서 푸시 알림 모니터링](c_android_enable.html#android_monitor)을 참조하십시오. + + + diff --git a/services/mobilepush/nl/ko/t_push_provider_android.md b/services/mobilepush/nl/ko/t_push_provider_android.md index ec95c1215..d1879bfef 100644 --- a/services/mobilepush/nl/ko/t_push_provider_android.md +++ b/services/mobilepush/nl/ko/t_push_provider_android.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# FCM의 신임 정보 구성 -{: #create-push-enable-gcm} -마지막 업데이트 날짜: 2017년 1월 16일 -{: .last-updated} - -FCM(Firebase Cloud Messaging)은 Android 디바이스 및 Google Chrome에 푸시 알림을 전달하는 데 사용되는 게이트웨이입니다. FCM은 GCM(Google Cloud Messaging)의 새 버전입니다. 대시보드에서 {{site.data.keyword.mobilepushshort}} 서비스를 설정하려면 FCM 신임 정보를 가져와야 합니다. 새 앱에 FCM 구성을 사용하십시오. 기존 앱은 계속해서 GCM 구성으로 작동합니다. - -##발신인 ID 및 API 키 가져오기 -{: #android-senderid-apikey} - -API 키는 안전하게 저장되어 {{site.data.keyword.mobilepushshort}} 서비스에서 FCM 서버에 연결하는 데 사용되며 발신인 ID(프로젝트 번호)는 클라이언트 측의 Google Chrome 및 Mozilla Firefox용 Android SDK와 JS SDK에서 사용됩니다. - -FCM을 설정하려면 API 키와 발신인 ID를 생성하고 다음 단계를 완료하십시오. - -1. [Firebase 콘솔 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.firebase.google.com/?pli=1){: new_window}을 방문하십시오. -2. **새 프로젝트 작성**을 선택하십시오. -3. 프로젝트 작성 창에서 프로젝트 이름을 입력하고 국가/지역을 선택한 후 **프로젝트 작성**을 클릭하십시오. -3. 탐색 분할창에서 설정 아이콘을 클릭한 후 **프로젝트 설정**을 선택하십시오. -4. 클라우드 메시징 탭을 선택하여 서버 API 키와 발신인 ID를 생성하십시오. - -##Android와 Chrome 앱 및 확장 프로그램의 {{site.data.keyword.mobilepushshort}} 서비스 설정 -{: #setup-push-android} - -**참고:** FCM/GCM API 키와 발신인 ID(프로젝트 번호)가 필요합니다. - -1. Bluemix 대시보드를 연 후 작성한 {{site.data.keyword.mobilepushfull}} 서비스 인스턴스를 클릭하여 대시보드를 여십시오. 푸시 대시보드가 표시됩니다. 바인딩되지 않은 Android용 {{site.data.keyword.mobilepushshort}} 서비스를 설정하려면 바인딩되지 않은 {{site.data.keyword.mobilepushshort}} 서비스 아이콘을 선택하여 {{site.data.keyword.mobilepushshort}} 서비스 대시보드를 여십시오. - -![푸시 대시보드](images/push_unbound.jpg) - -2. **푸시 설정** 단추를 클릭하여 Android 애플리케이션과 Google Chrome 앱 및 확장 프로그램의 FCM/GCM 신임 정보를 구성하십시오. -3. **구성** 페이지에서, Android의 경우 **모바일** 탭으로 이동하여 발신인 ID(GCM 프로젝트 번호)와 API 키를 구성하십시오. Google Chrome 앱 및 확장 프로그램의 경우 **웹** 탭으로 이동하여 발신인 ID(FCM/GCM 프로젝트 번호)와 API 키를 적절히 구성하십시오. -4. **저장**을 클릭하십시오. -5. 다음 단계. [Android의 알림 사용](c_enable_push.html) 또는 [Google Chrome 앱 및 확장 프로그램의 알림 사용](c_enable_push.html)을 설정하십시오. - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# FCM의 신임 정보 구성 +{: #create-push-enable-gcm} +마지막 업데이트 날짜: 2017년 1월 16일 +{: .last-updated} + +FCM(Firebase Cloud Messaging)은 Android 디바이스 및 Google Chrome에 푸시 알림을 전달하는 데 사용되는 게이트웨이입니다. FCM은 GCM(Google Cloud Messaging)의 새 버전입니다. 대시보드에서 {{site.data.keyword.mobilepushshort}} 서비스를 설정하려면 FCM 신임 정보를 가져와야 합니다. 새 앱에 FCM 구성을 사용하십시오. 기존 앱은 계속해서 GCM 구성으로 작동합니다. + +##발신인 ID 및 API 키 가져오기 +{: #android-senderid-apikey} + +API 키는 안전하게 저장되어 {{site.data.keyword.mobilepushshort}} 서비스에서 FCM 서버에 연결하는 데 사용되며 발신인 ID(프로젝트 번호)는 클라이언트 측의 Google Chrome 및 Mozilla Firefox용 Android SDK와 JS SDK에서 사용됩니다. + +FCM을 설정하려면 API 키와 발신인 ID를 생성하고 다음 단계를 완료하십시오. + +1. [Firebase 콘솔 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://console.firebase.google.com/?pli=1){: new_window}을 방문하십시오. +2. **새 프로젝트 작성**을 선택하십시오. +3. 프로젝트 작성 창에서 프로젝트 이름을 입력하고 국가/지역을 선택한 후 **프로젝트 작성**을 클릭하십시오. +3. 탐색 분할창에서 설정 아이콘을 클릭한 후 **프로젝트 설정**을 선택하십시오. +4. 클라우드 메시징 탭을 선택하여 서버 API 키와 발신인 ID를 생성하십시오. + +##Android와 Chrome 앱 및 확장 프로그램의 {{site.data.keyword.mobilepushshort}} 서비스 설정 +{: #setup-push-android} + +**참고:** FCM/GCM API 키와 발신인 ID(프로젝트 번호)가 필요합니다. + +1. Bluemix 대시보드를 연 후 작성한 {{site.data.keyword.mobilepushfull}} 서비스 인스턴스를 클릭하여 대시보드를 여십시오. 푸시 대시보드가 표시됩니다. 바인딩되지 않은 Android용 {{site.data.keyword.mobilepushshort}} 서비스를 설정하려면 바인딩되지 않은 {{site.data.keyword.mobilepushshort}} 서비스 아이콘을 선택하여 {{site.data.keyword.mobilepushshort}} 서비스 대시보드를 여십시오. + +![푸시 대시보드](images/push_unbound.jpg) + +2. **푸시 설정** 단추를 클릭하여 Android 애플리케이션과 Google Chrome 앱 및 확장 프로그램의 FCM/GCM 신임 정보를 구성하십시오. +3. **구성** 페이지에서, Android의 경우 **모바일** 탭으로 이동하여 발신인 ID(GCM 프로젝트 번호)와 API 키를 구성하십시오. Google Chrome 앱 및 확장 프로그램의 경우 **웹** 탭으로 이동하여 발신인 ID(FCM/GCM 프로젝트 번호)와 API 키를 적절히 구성하십시오. +4. **저장**을 클릭하십시오. +5. 다음 단계. [Android의 알림 사용](c_enable_push.html) 또는 [Google Chrome 앱 및 확장 프로그램의 알림 사용](c_enable_push.html)을 설정하십시오. + + diff --git a/services/mobilepush/nl/ko/t_push_provider_ios.md b/services/mobilepush/nl/ko/t_push_provider_ios.md index b35f5b78a..b1b9af81f 100644 --- a/services/mobilepush/nl/ko/t_push_provider_ios.md +++ b/services/mobilepush/nl/ko/t_push_provider_ios.md @@ -1,145 +1,145 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# APNs의 신임 정보 구성 -{: #create-push-credentials-apns} -마지막 업데이트 날짜: 2017년 1월 16일 -{: .last-updated} - -애플리케이션 개발자는 APNs(Apple Push Notification Service)를 이용하여 Bluemix의 {{site.data.keyword.mobilepushshort}} 서비스 인스턴스(제공자)에서 iOS 디바이스와 애플리케이션으로 원격 알림을 전송할 수 있습니다. 디바이스의 대상 애플리케이션으로 메시지가 전송됩니다. - -APNs 신임 정보를 획득하여 구성합니다. {{site.data.keyword.mobilepushshort}} 서비스에서 APNs 인증서를 안전하게 관리하며 제공자로 APNs 서버에 연결하는 데 이 인증서를 사용합니다. - - - - - - -##앱 ID 등록 -{: #create-push-credentials-apns-register} - - -앱 ID(번들 ID)는 특정 애플리케이션을 식별하는 고유 ID입니다. 각 애플리케이션에 앱 ID가 필요합니다. {{site.data.keyword.mobilepushshort}} 서비스와 같은 서비스는 앱 ID에 따라 구성됩니다. - -1. [Apple Developer ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com/){: new_window} 계정이 있는지 확인하십시오. -2. [Apple Developer ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com){: new_window} 포털로 이동하여 **멤버 센터**를 클릭하고 **인증서, ID 및 프로파일**을 선택하십시오. -3. [Apple Developer Library ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window}의 **Registering App IDs** 섹션으로 이동하고 지시사항에 따라 앱 ID를 등록하십시오. - -앱 ID를 등록할 때 다음 옵션을 선택하십시오. - -* 푸시 알림 -![앱 서비스](images/appID_appservices_enablepush.jpg) -* 명시적 ID 접미부 -![명시적 ID](images/appID_bundleID.jpg) -4. 개발 및 배포 APNs SSL 인증서를 작성하십시오. - -##개발 및 배포 APNs SSL 인증서 작성 -{: #create-push-credentials-apns-ssl} - -APNs 인증서를 획득하려면 먼저 인증서 서명 요청(CSR)을 작성하여 이를 Apple 인증 기관(CA)에 제출해야 합니다. CSR에는 사용자의 회사, Apple 푸시 알림을 신청할 때 사용하는 공용 키와 개인 키를 식별하는 정보가 포함됩니다. 그런 다음 iOS 개발자 포털에서 SSL 인증서를 생성하십시오. 인증서와 이의 공개 및 개인 키는 Keychain Access에 저장됩니다. - - - - - - -다음 두 모드에서 APNs를 사용할 수 있습니다. - -* 개발 및 테스트를 위한 샌드박스 모드에서 -* 앱 저장소(또는 다른 엔터프라이즈 배포 메커니즘)를 통해 애플리케이션을 배포할 때 프로덕션 모드에서 - -개발 및 배포 환경을 위한 별도의 인증서를 획득해야 합니다. 인증서는 원격 알림의 수신인인 앱의 앱 ID와 연관되어 있습니다. 프로덕션의 경우 최대 2개의 인증서를 작성할 수 있습니다. Bluemix는 인증서를 사용하여 APNs와의 SSL 연결을 설정합니다. - - - -1. [Apple Developer ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com){: new_window} 웹 사이트로 이동하여 **멤버 센터**를 클릭하고 **인증서, ID 및 프로파일**을 선택하십시오. -2. **ID** 영역에서 **앱 ID**를 클릭하십시오. -3. 앱 ID 목록에서 앱 ID를 선택한 다음 **설정**을 선택하십시오. -4. **푸시 알림** 영역에서 개발 SSL 인증서를 작성한 다음 프로덕션 SSL 인증서를 작성하십시오. - - ![푸시 알림 SSL 인증서](images/certificate_createssl.jpg) - -5. **인증서 서명 요청(CSR) 작성 정보 화면**이 표시되면 Mac에서 **Keychain Access** 애플리케이션을 시작하여 인증서 서명 요청(CSR)을 작성하십시오. -6. 메뉴에서 **Keychain Access > 인증서 지원 > 인증 기관에 인증서 요청…**을 선택하십시오. -7. **인증서 정보**에서 앱 개발자 계정과 연관된 이메일 주소와 공통 이름을 입력하십시오. 개발(샌드박스)용 인증서인지 배포(프로덕션)용 인증서인지 식별할 수 있도록 의미있는 이름을 지정하십시오(예: *sandbox-apns-certificate* 또는 *production-apns-certificate*). -8. **디스크에 저장**을 선택하여 `.certSigningRequest` 파일을 데스크탑에 다운로드한 다음 **계속**을 클릭하십시오. -9. **다른 이름으로 저장** 메뉴 옵션에서 `.certSigningRequest` 파일의 이름을 지정한 후 **저장**을 클릭하십시오. -10. **완료**를 클릭하십시오. 이제 CSR이 작성되었습니다. -11. **인증서 서명 요청(CSR) 작성 정보** 창으로 돌아가서 **계속**을 클릭하십시오. -12. **생성** 화면에서 **파일 선택... **을 클릭하고 데스크탑에 저장한 CSR 파일을 선택하십시오. 그런 다음 **생성**을 클릭하십시오. -![인증서 생성](images/generate_certificate.jpg) -13. 인증서가 준비되면 **완료**를 클릭하십시오. -14. **푸시 알림** 화면에서 **다운로드**를 클릭하여 인증서를 다운로드하고 **완료**를 클릭하십시오. - ![인증서 다운로드](images/certificate_download.jpg) -15. Mac의 경우 **Keychain Access > 내 인증서**로 이동하여 새로 설치된 인증서를 찾아보십시오. 인증서를 두 번 클릭하여 Keychain Access에 인증서를 설치하십시오. -16. 인증서와 개인 키를 선택한 다음 **내보내기**를 선택하여 인증서를 개인 정보 변환 형식(`.p12` 형식)으로 변환하십시오. - ![인증서 및 키 내보내기](images/keychain_export_key.jpg) -17. **다른 이름으로 저장** 필드에서 인증서에 의미있는 이름을 지정하십시오. 예를 들어, `sandbox_apns.p12_certifcate` 또는 `production_apns.p12`를 지정한 후 **저장**을 클릭하십시오. - ![인증서 및 키 내보내기](images/certificate_p12v2.jpg) -18. **비밀번호 입력** 필드에 내보낸 항목을 보호하기 위한 비밀번호를 입력한 다음 **확인**을 클릭하십시오. 이 비밀번호를 사용하여 푸시 대시보드에서 APNs 설정을 구성할 수 있습니다.{: #step18} - ![인증서 및 키 내보내기](images/export_p12.jpg) -19. **Key Access.app**이 **키 체인** 화면에서 키를 내보내도록 프롬프트를 표시합니다. 시스템이 해당 항목을 내보낼 수 있도록 Mac의 관리 비밀번호를 입력한 다음 **항상 허용** 옵션을 선택하십시오. 데스크탑에 `.p12` 인증서가 생성됩니다. - - -##개발 프로비저닝 프로파일 작성 -{: #create-push-credentials-dev-profile} - -프로비저닝 프로파일은 APP ID와 함께 작동하여 사용자 앱을 설치하고 실행할 수 있는 디바이스 및 사용자 앱에서 액세스할 수 있는 서비스를 판별합니다. 각 앱 ID에 대해 개발 및 배포용으로 두 개의 프로비저닝 프로파일을 작성하십시오. Xcode는 개발 프로비저닝 프로파일을 사용하여 애플리케이션을 빌드할 수 있는 개발자와 애플리케이션을 테스트할 수 있는 디바이스를 판별합니다. - -앱 ID를 등록하고 이를 {{site.data.keyword.mobilepushshort}} 서비스에 사용할 수 있도록 설정하였으며 개발 및 프로덕션 APNs SSL 인증서를 사용하도록 구성했는지 확인하십시오. - -개발 프로비저닝 프로파일을 다음과 같이 작성하십시오. - -1. [Apple Developer ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com){: new_window} 포털로 이동하여 **멤버 센터**를 클릭하고 **인증서, ID 및 프로파일**을 선택하십시오. -2. [Mac Developer Library ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}으로 이동하고, **Creating Development Provisioning Profiles** 섹션으로 화면 이동하여 지시사항에 따라 개발 프로파일을 작성하십시오. -**참고**:개발 프로비저닝 프로파일을 구성할 때 다음 옵션을 선택하십시오. - * **iOS 앱 개발** - * **iOS 및 watchOS 앱용** - - - -##저장소 배포 프로비저닝 프로파일 작성 -{: #create-push-credentials-apns-distribute_profile} - -저장소 프로비저닝 프로파일을 사용하여 배포용 앱을 앱 저장소에 제출하십시오. - -1. [Apple Developer ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com){: new_window} 포털로 이동하여 **멤버 센터**를 클릭하고 **인증서, ID 및 프로파일**을 선택하십시오. -2. 다운로드한 프로비저닝 프로파일을 두 번 클릭하여 이를 Xcode에 설치하십시오. - -##{{site.data.keyword.mobilepushshort}} 대시보드에서 APNs 설정 -{: #create-push-credentials-apns-dashboard} - -{{site.data.keyword.mobilepushshort}} 서비스를 사용하여 알림을 전송하려면 APNs(Apple Push Notification Service)에 필요한 SSL 인증서를 업로드하십시오. REST API를 사용하여 APNs 인증서를 업로드할 수도 있습니다. - - - -APNs에 필요한 인증서는 `.p12` 인증서입니다. 이러한 인증서에는 애플리케이션 빌드와 공개에 필요한 개인 키와 SSL 인증서가 있습니다. Apple Developer 웹 사이트의 Member Center에서 인증서를 생성해야 합니다(유효한 Apple Developer 계정 필요). 개발 환경(샌드박스)과 프로덕션(배포) 환경에 대해 별도의 인증서가 필요합니다. - -**참고**: `.cer` 파일이 키 체인 액세스에 있으면 이를 컴퓨터로 내보내서 `.p12` 인증서를 작성하십시오. - -APNs 사용에 대한 자세한 정보는 [iOS Developer Library: Local and Push Notification Programming Guide ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}을 참조하십시오. - -푸시 알림 서비스 대시보드에서 APNs를 설정하려면 다음을 수행하십시오. - -1. 푸시 알림 서비스 대시보드에서 **구성**을 선택하십시오. -2. **모바일** 옵션을 선택하여 **APNs 알림 신임 정보** 양식의 정보를 업데이트하십시오. -3. **샌드박스**(개발) 또는 **프로덕션**(배포)을 선택한 후 이전 [단계](#step18)에서 작성한 `p.12` 인증서를 업로드하십시오. - ![푸시 알림 설정 대시보드](images/wizard.jpg) -3. **비밀번호** 필드에서 `.p12` 인증서 파일과 연관된 비밀번호를 입력하고 **저장**을 클릭하십시오. - -올바른 비밀번호를 사용하여 인증서를 업로드한 후 알림 전송을 시작할 수 있습니다. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# APNs의 신임 정보 구성 +{: #create-push-credentials-apns} +마지막 업데이트 날짜: 2017년 1월 16일 +{: .last-updated} + +애플리케이션 개발자는 APNs(Apple Push Notification Service)를 이용하여 Bluemix의 {{site.data.keyword.mobilepushshort}} 서비스 인스턴스(제공자)에서 iOS 디바이스와 애플리케이션으로 원격 알림을 전송할 수 있습니다. 디바이스의 대상 애플리케이션으로 메시지가 전송됩니다. + +APNs 신임 정보를 획득하여 구성합니다. {{site.data.keyword.mobilepushshort}} 서비스에서 APNs 인증서를 안전하게 관리하며 제공자로 APNs 서버에 연결하는 데 이 인증서를 사용합니다. + + + + + + +## 앱 ID 등록 +{: #create-push-credentials-apns-register} + + +앱 ID(번들 ID)는 특정 애플리케이션을 식별하는 고유 ID입니다. 각 애플리케이션에 앱 ID가 필요합니다. {{site.data.keyword.mobilepushshort}} 서비스와 같은 서비스는 앱 ID에 따라 구성됩니다. + +1. [Apple Developer ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com/){: new_window} 계정이 있는지 확인하십시오. +2. [Apple Developer ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com){: new_window} 포털로 이동하여 **멤버 센터**를 클릭하고 **인증서, ID 및 프로파일**을 선택하십시오. +3. [Apple Developer Library ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window}의 **Registering App IDs** 섹션으로 이동하고 지시사항에 따라 앱 ID를 등록하십시오. + +앱 ID를 등록할 때 다음 옵션을 선택하십시오. + +* 푸시 알림 +![앱 서비스](images/appID_appservices_enablepush.jpg) +* 명시적 ID 접미부 +![명시적 ID](images/appID_bundleID.jpg) +4. 개발 및 배포 APNs SSL 인증서를 작성하십시오. + +## 개발 및 배포 APNs SSL 인증서 작성 +{: #create-push-credentials-apns-ssl} + +APNs 인증서를 획득하려면 먼저 인증서 서명 요청(CSR)을 작성하여 이를 Apple 인증 기관(CA)에 제출해야 합니다. CSR에는 사용자의 회사, Apple 푸시 알림을 신청할 때 사용하는 공용 키와 개인 키를 식별하는 정보가 포함됩니다. 그런 다음 iOS 개발자 포털에서 SSL 인증서를 생성하십시오. 인증서와 이의 공개 및 개인 키는 Keychain Access에 저장됩니다. + + + + + + +다음 두 모드에서 APNs를 사용할 수 있습니다. + +* 개발 및 테스트를 위한 샌드박스 모드에서 +* 앱 저장소(또는 다른 엔터프라이즈 배포 메커니즘)를 통해 애플리케이션을 배포할 때 프로덕션 모드에서 + +개발 및 배포 환경을 위한 별도의 인증서를 획득해야 합니다. 인증서는 원격 알림의 수신인인 앱의 앱 ID와 연관되어 있습니다. 프로덕션의 경우 최대 2개의 인증서를 작성할 수 있습니다. Bluemix는 인증서를 사용하여 APNs와의 SSL 연결을 설정합니다. + + + +1. [Apple Developer ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com){: new_window} 웹 사이트로 이동하여 **멤버 센터**를 클릭하고 **인증서, ID 및 프로파일**을 선택하십시오. +2. **ID** 영역에서 **앱 ID**를 클릭하십시오. +3. 앱 ID 목록에서 앱 ID를 선택한 다음 **설정**을 선택하십시오. +4. **푸시 알림** 영역에서 개발 SSL 인증서를 작성한 다음 프로덕션 SSL 인증서를 작성하십시오. + + ![푸시 알림 SSL 인증서](images/certificate_createssl.jpg) + +5. **인증서 서명 요청(CSR) 작성 정보 화면**이 표시되면 Mac에서 **Keychain Access** 애플리케이션을 시작하여 인증서 서명 요청(CSR)을 작성하십시오. +6. 메뉴에서 **Keychain Access > 인증서 지원 > 인증 기관에 인증서 요청…**을 선택하십시오. +7. **인증서 정보**에서 앱 개발자 계정과 연관된 이메일 주소와 공통 이름을 입력하십시오. 개발(샌드박스)용 인증서인지 배포(프로덕션)용 인증서인지 식별할 수 있도록 의미있는 이름을 지정하십시오(예: *sandbox-apns-certificate* 또는 *production-apns-certificate*). +8. **디스크에 저장**을 선택하여 `.certSigningRequest` 파일을 데스크탑에 다운로드한 다음 **계속**을 클릭하십시오. +9. **다른 이름으로 저장** 메뉴 옵션에서 `.certSigningRequest` 파일의 이름을 지정한 후 **저장**을 클릭하십시오. +10. **완료**를 클릭하십시오. 이제 CSR이 작성되었습니다. +11. **인증서 서명 요청(CSR) 작성 정보** 창으로 돌아가서 **계속**을 클릭하십시오. +12. **생성** 화면에서 **파일 선택... **을 클릭하고 데스크탑에 저장한 CSR 파일을 선택하십시오. 그런 다음 **생성**을 클릭하십시오. +![인증서 생성](images/generate_certificate.jpg) +13. 인증서가 준비되면 **완료**를 클릭하십시오. +14. **푸시 알림** 화면에서 **다운로드**를 클릭하여 인증서를 다운로드하고 **완료**를 클릭하십시오. + ![인증서 다운로드](images/certificate_download.jpg) +15. Mac의 경우 **Keychain Access > 내 인증서**로 이동하여 새로 설치된 인증서를 찾아보십시오. 인증서를 두 번 클릭하여 Keychain Access에 인증서를 설치하십시오. +16. 인증서와 개인 키를 선택한 다음 **내보내기**를 선택하여 인증서를 개인 정보 변환 형식(`.p12` 형식)으로 변환하십시오. + ![인증서 및 키 내보내기](images/keychain_export_key.jpg) +17. **다른 이름으로 저장** 필드에서 인증서에 의미있는 이름을 지정하십시오. 예를 들어, `sandbox_apns.p12_certifcate` 또는 `production_apns.p12`를 지정한 후 **저장**을 클릭하십시오. + ![인증서 및 키 내보내기](images/certificate_p12v2.jpg) +18. **비밀번호 입력** 필드에 내보낸 항목을 보호하기 위한 비밀번호를 입력한 다음 **확인**을 클릭하십시오. 이 비밀번호를 사용하여 푸시 대시보드에서 APNs 설정을 구성할 수 있습니다.{: #step18} + ![인증서 및 키 내보내기](images/export_p12.jpg) +19. **Key Access.app**이 **키 체인** 화면에서 키를 내보내도록 프롬프트를 표시합니다. 시스템이 해당 항목을 내보낼 수 있도록 Mac의 관리 비밀번호를 입력한 다음 **항상 허용** 옵션을 선택하십시오. 데스크탑에 `.p12` 인증서가 생성됩니다. + + +## 개발 프로비저닝 프로파일 작성 +{: #create-push-credentials-dev-profile} + +프로비저닝 프로파일은 APP ID와 함께 작동하여 사용자 앱을 설치하고 실행할 수 있는 디바이스 및 사용자 앱에서 액세스할 수 있는 서비스를 판별합니다. 각 앱 ID에 대해 개발 및 배포용으로 두 개의 프로비저닝 프로파일을 작성하십시오. Xcode는 개발 프로비저닝 프로파일을 사용하여 애플리케이션을 빌드할 수 있는 개발자와 애플리케이션을 테스트할 수 있는 디바이스를 판별합니다. + +앱 ID를 등록하고 이를 {{site.data.keyword.mobilepushshort}} 서비스에 사용할 수 있도록 설정하였으며 개발 및 프로덕션 APNs SSL 인증서를 사용하도록 구성했는지 확인하십시오. + +개발 프로비저닝 프로파일을 다음과 같이 작성하십시오. + +1. [Apple Developer ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com){: new_window} 포털로 이동하여 **멤버 센터**를 클릭하고 **인증서, ID 및 프로파일**을 선택하십시오. +2. [Mac Developer Library ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}으로 이동하고, **Creating Development Provisioning Profiles** 섹션으로 화면 이동하여 지시사항에 따라 개발 프로파일을 작성하십시오. +**참고**:개발 프로비저닝 프로파일을 구성할 때 다음 옵션을 선택하십시오. + * **iOS 앱 개발** + * **iOS 및 watchOS 앱용** + + + +## 저장소 배포 프로비저닝 프로파일 작성 +{: #create-push-credentials-apns-distribute_profile} + +저장소 프로비저닝 프로파일을 사용하여 배포용 앱을 앱 저장소에 제출하십시오. + +1. [Apple Developer ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com){: new_window} 포털로 이동하여 **멤버 센터**를 클릭하고 **인증서, ID 및 프로파일**을 선택하십시오. +2. 다운로드한 프로비저닝 프로파일을 두 번 클릭하여 이를 Xcode에 설치하십시오. + +## {{site.data.keyword.mobilepushshort}} 대시보드에서 APNs 설정 +{: #create-push-credentials-apns-dashboard} + +{{site.data.keyword.mobilepushshort}} 서비스를 사용하여 알림을 전송하려면 APNs(Apple Push Notification Service)에 필요한 SSL 인증서를 업로드하십시오. REST API를 사용하여 APNs 인증서를 업로드할 수도 있습니다. + + + +APNs에 필요한 인증서는 `.p12` 인증서입니다. 이러한 인증서에는 애플리케이션 빌드와 공개에 필요한 개인 키와 SSL 인증서가 있습니다. Apple Developer 웹 사이트의 Member Center에서 인증서를 생성해야 합니다(유효한 Apple Developer 계정 필요). 개발 환경(샌드박스)과 프로덕션(배포) 환경에 대해 별도의 인증서가 필요합니다. + +**참고**: `.cer` 파일이 키 체인 액세스에 있으면 이를 컴퓨터로 내보내서 `.p12` 인증서를 작성하십시오. + +APNs 사용에 대한 자세한 정보는 [iOS Developer Library: Local and Push Notification Programming Guide ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}을 참조하십시오. + +푸시 알림 서비스 대시보드에서 APNs를 설정하려면 다음을 수행하십시오. + +1. 푸시 알림 서비스 대시보드에서 **구성**을 선택하십시오. +2. **모바일** 옵션을 선택하여 **APNs 알림 신임 정보** 양식의 정보를 업데이트하십시오. +3. **샌드박스**(개발) 또는 **프로덕션**(배포)을 선택한 후 이전 [단계](#step18)에서 작성한 `p.12` 인증서를 업로드하십시오. + ![푸시 알림 설정 대시보드](images/wizard.jpg) +3. **비밀번호** 필드에서 `.p12` 인증서 파일과 연관된 비밀번호를 입력하고 **저장**을 클릭하십시오. + +올바른 비밀번호를 사용하여 인증서를 업로드한 후 알림 전송을 시작할 수 있습니다. diff --git a/services/mobilepush/nl/ko/t_push_provider_safari.md b/services/mobilepush/nl/ko/t_push_provider_safari.md index 90fca71fb..cbc519db3 100644 --- a/services/mobilepush/nl/ko/t_push_provider_safari.md +++ b/services/mobilepush/nl/ko/t_push_provider_safari.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 웹 브라우저의 신임 정보 구성 -{: #configure-credential-for-browsers} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - -IBM {{site.data.keyword.mobilepushshort}} 서비스는 이제 기능을 확장하여 사용자의 브라우저에 알림을 전송합니다. - -{{site.data.keyword.mobilepushshort}} 서비스에서 허용해야 할 요청을 식별하려면 웹 사이트 URL 또는 웹 사이트의 도메인 이름이 필요합니다. {{site.data.keyword.mobilepushshort}} 서비스 인스턴스는 한 번에 하나의 도메인 이름만 지원합니다. 그러므로 Chrome, Firefox 및 Safari에 동일한 값이 설정되는지 확인하십시오. - -Chrome 및 Safari 브라우저에서는 웹 푸시를 위해 추가 구성이 필요합니다. FCM 엔드포인트를 사용하여 Chrome에서 메시지를 제공하므로 FCM API 키가 필요합니다. FCM API 키를 얻으려면 [FCM의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. - - - -##Chrome 및 Firefox 웹 푸시 구성 -{: #config-chrome-firefox} - -1. 푸시 대시보드 패널에서 **구성**을 선택하십시오. -2. 웹 탭을 선택하십시오. - ![WebPush 구성](images/webpush_configure.jpg) -3. 푸시 알림을 수신하도록 등록할 웹 사이트의 URL과 FCM/GCM API 키를 구성하십시오. -4. **저장**을 클릭하십시오. -5. 다음 단계. [Google Chrome 및 Mozilla Firefox 브라우저에 알림 사용](c_enable_push.html). - - -## Safari 웹 푸시 구성 -{: #configure-safari} - -Safari에서 {{site.data.keyword.mobilepushshort}} 서비스에 지원되는 버전은 10.0입니다. Apple Developer 계정을 통해 인증서를 생성해야 알림을 받도록 브라우저를 구성할 수 있습니다. - -### 인증서 생성 -{: #certificate-generation} - -Apple 개발자 계정이 있는지 확인하십시오. 알림을 수신하도록 Safari 브라우저를 구성하려면 웹 사이트 푸시 ID를 등록하고 인증서를 생성해야 합니다. 다음 단계를 수행하면 시작에 도움이 됩니다. - -1. Apple 개발자 구성원 센터에서 **인증서, ID 및 프로파일**을 클릭하십시오. -2. **ID**를 클릭한 후 **웹 사이트 푸시 ID**를 클릭하십시오. -3. 더하기 아이콘을 선택하여 새 항목을 작성하도록 선택하십시오. - ![푸시 대시보드](images/safari_1.jpg) - -4. 웹 사이트 푸시 ID 등록 패널에서 적절한 웹 사이트 푸시 ID 설명 및 식별자 ID를 제공하십시오. 'web'으로 시작하는 역 도메인 이름 형식을 사용하는 것이 좋습니다. 예: web.com.example.dailyweatherreports. -5. 웹 사이트 푸시 ID를 등록하십시오. 사용자의 웹 사이트 푸시 ID가 생성됩니다. -6. **편집**을 선택하여 웹 사이트 푸시 ID에 사용할 인증서를 생성하십시오. -7. 인증서 정보의 인증서 지원 창에서 이메일 ID와 공통 이름을 제공하십시오. 인증 기관 이메일 주소는 공백으로 두십시오. -8. **디스크에 저장**을 클릭하고 **계속**을 선택하십시오. -9. 인증서를 적절한 폴더에 저장하도록 선택하십시오. -10. 마법사에서 인증서를 생성하도록 프롬프트하면 디스크에 작성된 `.certSigningRequest`를 선택하십시오. `.cer` 형식으로 작성된 웹 사이트 푸시 인증서를 다운로드해야 합니다. -11. KeyChain Access 도구에서 인증서를 여십시오. 마우스 오른쪽 단추를 클릭하고 p12 인증서로 내보내십시오. p12 인증서 생성 중에 입력한 비밀번호를 기록하십시오. - - -### 알림 구성 - {: #configuration-notification} - -인증서를 생성한 후에 서비스를 구성하여 알림을 Safari로 보낼 수 있습니다. - -다음 단계를 완료하십시오. - -1. 푸시 알림 서비스 대시보드에서 **구성을 클릭**하십시오. -2. 웹 탭을 선택하십시오. -3. Safari 푸시 섹션에서 필수 정보로 양식을 업데이트하십시오. - - **웹 사이트 이름**: 알림 센터에서 입력한 이름입니다. - - **웹 사이트 푸시 ID**: 웹 사이트 푸시 ID에 대한 역 도메인 문자열로 업데이트하십시오. 예: web.com.example.www. - - **웹 사이트 URL**: 푸시 알림에 등록될 웹 사이트의 URL을 입력하십시오. 예: https://www.example.com. - - **허용 도메인**: 선택적 매개변수입니다. 사용자에게 권한을 요청하는 웹 사이트 목록입니다. URL은 쉼표로 구분된 값이어야 합니다. 이 값을 입력하지 않으면 웹 사이트 URL 값을 사용합니다. - - **URL 형식 문자열**: 알림을 클릭할 때 분석할 URL입니다. 예: ["https://www.example.com"]. 이 URL은 http 또는 https 체계를 사용해야 합니다. - - **Safari 웹 푸시 인증서**: .p12 인증서를 업로드하고 비밀번호를 입력하십시오. -4. **저장**을 클릭하십시오. - -![푸시 대시보드](images/push_configure_safari.jpg) - -이제 Safari 브라우저로 푸시 알림을 전송하는 구성이 완료되었습니다. - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 웹 브라우저의 신임 정보 구성 +{: #configure-credential-for-browsers} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + +IBM {{site.data.keyword.mobilepushshort}} 서비스는 이제 기능을 확장하여 사용자의 브라우저에 알림을 전송합니다. + +{{site.data.keyword.mobilepushshort}} 서비스에서 허용해야 할 요청을 식별하려면 웹 사이트 URL 또는 웹 사이트의 도메인 이름이 필요합니다. {{site.data.keyword.mobilepushshort}} 서비스 인스턴스는 한 번에 하나의 도메인 이름만 지원합니다. 그러므로 Chrome, Firefox 및 Safari에 동일한 값이 설정되는지 확인하십시오. + +Chrome 및 Safari 브라우저에서는 웹 푸시를 위해 추가 구성이 필요합니다. FCM 엔드포인트를 사용하여 Chrome에서 메시지를 제공하므로 FCM API 키가 필요합니다. FCM API 키를 얻으려면 [FCM의 신임 정보 구성](t_push_provider_android.html)을 참조하십시오. + + + +##Chrome 및 Firefox 웹 푸시 구성 +{: #config-chrome-firefox} + +1. 푸시 대시보드 패널에서 **구성**을 선택하십시오. +2. 웹 탭을 선택하십시오. + ![WebPush 구성](images/webpush_configure.jpg) +3. 푸시 알림을 수신하도록 등록할 웹 사이트의 URL과 FCM/GCM API 키를 구성하십시오. +4. **저장**을 클릭하십시오. +5. 다음 단계. [Google Chrome 및 Mozilla Firefox 브라우저에 알림 사용](c_enable_push.html). + + +## Safari 웹 푸시 구성 +{: #configure-safari} + +Safari에서 {{site.data.keyword.mobilepushshort}} 서비스에 지원되는 버전은 10.0입니다. Apple Developer 계정을 통해 인증서를 생성해야 알림을 받도록 브라우저를 구성할 수 있습니다. + +### 인증서 생성 +{: #certificate-generation} + +Apple 개발자 계정이 있는지 확인하십시오. 알림을 수신하도록 Safari 브라우저를 구성하려면 웹 사이트 푸시 ID를 등록하고 인증서를 생성해야 합니다. 다음 단계를 수행하면 시작에 도움이 됩니다. + +1. Apple 개발자 구성원 센터에서 **인증서, ID 및 프로파일**을 클릭하십시오. +2. **ID**를 클릭한 후 **웹 사이트 푸시 ID**를 클릭하십시오. +3. 더하기 아이콘을 선택하여 새 항목을 작성하도록 선택하십시오. + ![푸시 대시보드](images/safari_1.jpg) + +4. 웹 사이트 푸시 ID 등록 패널에서 적절한 웹 사이트 푸시 ID 설명 및 식별자 ID를 제공하십시오. 'web'으로 시작하는 역 도메인 이름 형식을 사용하는 것이 좋습니다. 예: web.com.example.dailyweatherreports. +5. 웹 사이트 푸시 ID를 등록하십시오. 사용자의 웹 사이트 푸시 ID가 생성됩니다. +6. **편집**을 선택하여 웹 사이트 푸시 ID에 사용할 인증서를 생성하십시오. +7. 인증서 정보의 인증서 지원 창에서 이메일 ID와 공통 이름을 제공하십시오. 인증 기관 이메일 주소는 공백으로 두십시오. +8. **디스크에 저장**을 클릭하고 **계속**을 선택하십시오. +9. 인증서를 적절한 폴더에 저장하도록 선택하십시오. +10. 마법사에서 인증서를 생성하도록 프롬프트하면 디스크에 작성된 `.certSigningRequest`를 선택하십시오. `.cer` 형식으로 작성된 웹 사이트 푸시 인증서를 다운로드해야 합니다. +11. KeyChain Access 도구에서 인증서를 여십시오. 마우스 오른쪽 단추를 클릭하고 p12 인증서로 내보내십시오. p12 인증서 생성 중에 입력한 비밀번호를 기록하십시오. + + +### 알림 구성 + {: #configuration-notification} + +인증서를 생성한 후에 서비스를 구성하여 알림을 Safari로 보낼 수 있습니다. + +다음 단계를 완료하십시오. + +1. 푸시 알림 서비스 대시보드에서 **구성을 클릭**하십시오. +2. 웹 탭을 선택하십시오. +3. Safari 푸시 섹션에서 필수 정보로 양식을 업데이트하십시오. + - **웹 사이트 이름**: 알림 센터에서 입력한 이름입니다. + - **웹 사이트 푸시 ID**: 웹 사이트 푸시 ID에 대한 역 도메인 문자열로 업데이트하십시오. 예: web.com.example.www. + - **웹 사이트 URL**: 푸시 알림에 등록될 웹 사이트의 URL을 입력하십시오. 예: https://www.example.com. + - **허용 도메인**: 선택적 매개변수입니다. 사용자에게 권한을 요청하는 웹 사이트 목록입니다. URL은 쉼표로 구분된 값이어야 합니다. 이 값을 입력하지 않으면 웹 사이트 URL 값을 사용합니다. + - **URL 형식 문자열**: 알림을 클릭할 때 분석할 URL입니다. 예: ["https://www.example.com"]. 이 URL은 http 또는 https 체계를 사용해야 합니다. + - **Safari 웹 푸시 인증서**: .p12 인증서를 업로드하고 비밀번호를 입력하십시오. +4. **저장**을 클릭하십시오. + +![푸시 대시보드](images/push_configure_safari.jpg) + +이제 Safari 브라우저로 푸시 알림을 전송하는 구성이 완료되었습니다. + + diff --git a/services/mobilepush/nl/ko/t_push_tagsmain.md b/services/mobilepush/nl/ko/t_push_tagsmain.md index b6aa2f572..674696c88 100644 --- a/services/mobilepush/nl/ko/t_push_tagsmain.md +++ b/services/mobilepush/nl/ko/t_push_tagsmain.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 태그 기반 알림 -{: #push-ios-main-tags} -마지막 업데이트 날짜: 2017년 1월 16일 -{: .last-updated} - -태그 기반 알림 메시지는 특정 태그를 구독하는 모든 디바이스가 대상입니다. 태그를 정의한 다음 태그를 사용하여 메시지를 전송 및 수신할 수 있습니다. - -먼저 애플리케이션에 대한 태그를 작성하고, 태그 구독을 설정한 다음, 태그 기반 알림을 시작해야 합니다. [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 사용하여 태그 기반 알림을 전송하려면, 메시지 리소스에 게시할 때 "tagNames"가 제공되는지 확인하십시오. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 태그 기반 알림 +{: #push-ios-main-tags} +마지막 업데이트 날짜: 2017년 1월 16일 +{: .last-updated} + +태그 기반 알림 메시지는 특정 태그를 구독하는 모든 디바이스가 대상입니다. 태그를 정의한 다음 태그를 사용하여 메시지를 전송 및 수신할 수 있습니다. + +먼저 애플리케이션에 대한 태그를 작성하고, 태그 구독을 설정한 다음, 태그 기반 알림을 시작해야 합니다. [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 사용하여 태그 기반 알림을 전송하려면, 메시지 리소스에 게시할 때 "tagNames"가 제공되는지 확인하십시오. diff --git a/services/mobilepush/nl/ko/t_restapi.md b/services/mobilepush/nl/ko/t_restapi.md index e9a5abf55..bf9ed882d 100644 --- a/services/mobilepush/nl/ko/t_restapi.md +++ b/services/mobilepush/nl/ko/t_restapi.md @@ -1,122 +1,122 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# REST API 사용 -{: #push-api-rest} -마지막 업데이트 날짜: 2017년 1월 16일 -{: .last-updated} - -{{site.data.keyword.mobilepushshort}}에 REST(Representational State Transfer) API(Application Program Interface)를 사용할 수 있습니다. 또한 SDK 및 [Push API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 사용하여 클라이언트 애플리케이션을 추가 개발할 수 있습니다. - -백엔드 서버 애플리케이션과 클라이언트에서 푸시 REST API를 사용하여 {{site.data.keyword.mobilepushshort}} 기능에 액세스할 수 있습니다. - -- 디바이스 등록 -- 등록 -- 메시지 -- 구독 -- 태그 -- 웹훅 - -REST API의 기본 URL을 얻으려면 다음 단계를 완료하십시오. - -1. MobileFirst Services Starter를 선택하여 표준 유형 섹션 Bluemix® 카탈로그에서 백엔드 애플리케이션을 작성하십시오. 이렇게 하면 {{site.data.keyword.mobilepushshort}} 서비스가 애플리케이션에 바인드됩니다. 푸시의 서비스 인스턴스를 작성하고 바인드되지 않은 상태로 둘 수도 있습니다. -1. Bluemix 대시보드의 기본 페이지에서 **애플리케이션** 영역으로 이동한 후 앱을 선택하십시오. -3. **모바일 옵션**을 클릭하십시오. 앱의 세부사항 페이지 시작 부분에 라우트 값과 앱 GUID 값이 표시됩니다. 신임 정보 표시 화면에 AppSecret에 관한 정보가 표시됩니다. 모바일 옵션에서 애플리케이션 시크릿을 가져올 수 있으며 일부 API의 클라이언트 시크릿을 가져올 수도 있습니다. - -또한 명령행을 사용하여 서비스 신임 정보를 가져올 수 있습니다. - -``` - cf create-service-key {push_instance_name} {key_name} - cf service-key {push_instance_name} {key_name} -``` - {: codeblock} - -## 언어 승인 헤더 -{: #push-api-rest-accept} - -"Accept-Language" 헤더는 [Push REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}에서 출력하는 오류 메시지에 사용할 언어를 지정합니다. 오류 메시지에 지원되는 언어는 중국어, 대만어, 영어(미국), 독일어, 프랑스어, 이탈리아어, 일본어, 한국어, 포르투갈어 및 스페인어입니다. - -## appSecret -{: #push-api-rest-secret} - -애플리케이션이 {{site.data.keyword.mobilepushshort}}에 바인드되는 경우 서비스에서 appSecret(고유 키)을 생성하여 응답 헤더를 통해 전달합니다. IBM {{site.data.keyword.mobilepushshort}} for Bluemix Rest API를 사용 중인 경우 보호해야 하는 API에 대한 정보를 얻으려면 REST API 참조를 사용하십시오. 자세한 정보는 [Push REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 참조하십시오. - -요청 헤더에 appSecret이 포함되어야 합니다. 그렇지 않으면 서버가 401 권한 없음 오류 코드를 리턴합니다. {{site.data.keyword.mobilepushshort}}가 애플리케이션에 추가되면 특정 AppID가 작성됩니다. 응답 과정에서 태그를 작성하거나 메시지를 전송하는 데 사용되는 appSecret 헤더를 받습니다. 카탈로그 또는 표준 유형의 서비스를 통해 오퍼레이션이 발생합니다. - -appSecret 값을 가져오려면 다음을 수행하십시오. - -1. 푸시 서비스에 바인드되는 *app-name*을 클릭하십시오. -2. **신임 정보 표시** 링크를 클릭하여 appSecret(AppID)을 표시하십시오. - -**신임 정보 표시** 화면에 다음과 같이 AppSecret에 대한 정보가 표시됩니다. -``` - { - "imfpush_Dev": [ - { - "name": "testapp1", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": { - "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", - "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", - "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", - } - } - ] - } -``` - {: codeblock} - - -##Push REST API 필터 -{: #push-api-rest-filters} - -필터는 {{site.data.keyword.mobilepushshort}}의 GET API에서 리턴되는 데이터를 제한하는 검색 기준을 정의합니다. 필터링할 Get 오퍼레이션의 결과에 대해 필터를 적용하십시오. 필터가 결과에 포함되는 항목의 수를 제한합니다. 예를 들면, 필터를 사용하여 "test"로 시작하는 태그를 검색할 수 있습니다. - -다음 구문을 사용하여 필터를 생성할 수 있습니다. - -**name**: 필터가 적용되는 필드 이름입니다. - -**operator**: 사용할 필터 일치를 설명하는 ==(정확히 일치) 또는 =@(하위 문자열 포함)입니다. - -**expression**: 결과에 포함시킬 값입니다. - -표현식에 쉼표 및 백슬래시가 표시될 경우 백슬래시로 이스케이프해야 합니다. - -여러 개의 필터를 사용할 경우 AND 및 OR 논리를 사용하여 필터를 결합할 수 있습니다. - -- AND 논리의 경우 조회에서 여러 필터를 사용하십시오. -- OR 논리의 경우 필터 식 안에 쉼표(,)를 사용하십시오. -- AND 및 OR 논리를 둘 다 사용할 경우, 단일 조회에 AND 및 OR 논리를 모두 포함시킬 수 있습니다. 각 필터는 AND 표현식에서 결합되기 전에 개별적으로 평가됩니다. - -디바이스 GET API의 경우 다음 조합이 지원됩니다. --이름은 플랫폼 필드입니다. -- 플랫폼을 제외하고 연산자는 == 또는 =@일 수 있습니다. -- 플랫폼의 경우 연산자는 ==여야 합니다. 연산자 =@을 사용할 경우 값이 하위 문자열이 될 수 있습니다. -- ==를 사용할 경우 값이 정확히 일치하는 문자열이어야 합니다. - -구독 GET API의 경우 다음 조합이 지원됩니다. - -- 이름은 tagName 또는 deviceId 필드 중 하나일 수 있습니다. -- 플랫폼을 제외하고 연산자는 == 또는 =@일 수 있습니다. -- 플랫폼의 경우 연산자는 ==여야 합니다. -- =@ 연산자를 사용하는 경우 값은 하위 문자열이 될 수 있습니다. == 연산자를 사용하는 경우 값은 정확히 일치하는 문자열이어야 합니다. -- 태그 GET API의 경우 다음 조합이 지원됩니다. -- 이름은 "이름" 또는 "설명" 필드 중 하나일 수 있습니다. -- 연산자 =@을 사용할 경우 값이 하위 문자열이 될 수 있습니다. -- ==를 사용할 경우 값이 정확히 일치하는 문자열이어야 합니다. - - -##{{site.data.keyword.mobilepushshort}} 응답 코드 -{: #push-api-response-codes} - -상태: 405 허용되지 않은 메소드 - 적절한 메소드를 예상했습니다. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# REST API 사용 +{: #push-api-rest} +마지막 업데이트 날짜: 2017년 1월 16일 +{: .last-updated} + +{{site.data.keyword.mobilepushshort}}에 REST(Representational State Transfer) API(Application Program Interface)를 사용할 수 있습니다. 또한 SDK 및 [Push API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 사용하여 클라이언트 애플리케이션을 추가 개발할 수 있습니다. + +백엔드 서버 애플리케이션과 클라이언트에서 푸시 REST API를 사용하여 {{site.data.keyword.mobilepushshort}} 기능에 액세스할 수 있습니다. + +- 디바이스 등록 +- 등록 +- 메시지 +- 구독 +- 태그 +- 웹훅 + +REST API의 기본 URL을 얻으려면 다음 단계를 완료하십시오. + +1. MobileFirst Services Starter를 선택하여 표준 유형 섹션 Bluemix® 카탈로그에서 백엔드 애플리케이션을 작성하십시오. 이렇게 하면 {{site.data.keyword.mobilepushshort}} 서비스가 애플리케이션에 바인드됩니다. 푸시의 서비스 인스턴스를 작성하고 바인드되지 않은 상태로 둘 수도 있습니다. +1. Bluemix 대시보드의 기본 페이지에서 **애플리케이션** 영역으로 이동한 후 앱을 선택하십시오. +3. **모바일 옵션**을 클릭하십시오. 앱의 세부사항 페이지 시작 부분에 라우트 값과 앱 GUID 값이 표시됩니다. 신임 정보 표시 화면에 AppSecret에 관한 정보가 표시됩니다. 모바일 옵션에서 애플리케이션 시크릿을 가져올 수 있으며 일부 API의 클라이언트 시크릿을 가져올 수도 있습니다. + +또한 명령행을 사용하여 서비스 신임 정보를 가져올 수 있습니다. + +``` + cf create-service-key {push_instance_name} {key_name} + cf service-key {push_instance_name} {key_name} +``` + {: codeblock} + +## 언어 승인 헤더 +{: #push-api-rest-accept} + +"Accept-Language" 헤더는 [Push REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}에서 출력하는 오류 메시지에 사용할 언어를 지정합니다. 오류 메시지에 지원되는 언어는 중국어, 대만어, 영어(미국), 독일어, 프랑스어, 이탈리아어, 일본어, 한국어, 포르투갈어 및 스페인어입니다. + +## appSecret +{: #push-api-rest-secret} + +애플리케이션이 {{site.data.keyword.mobilepushshort}}에 바인드되는 경우 서비스에서 appSecret(고유 키)을 생성하여 응답 헤더를 통해 전달합니다. IBM {{site.data.keyword.mobilepushshort}} for Bluemix Rest API를 사용 중인 경우 보호해야 하는 API에 대한 정보를 얻으려면 REST API 참조를 사용하십시오. 자세한 정보는 [Push REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 참조하십시오. + +요청 헤더에 appSecret이 포함되어야 합니다. 그렇지 않으면 서버가 401 권한 없음 오류 코드를 리턴합니다. {{site.data.keyword.mobilepushshort}}가 애플리케이션에 추가되면 특정 AppID가 작성됩니다. 응답 과정에서 태그를 작성하거나 메시지를 전송하는 데 사용되는 appSecret 헤더를 받습니다. 카탈로그 또는 표준 유형의 서비스를 통해 오퍼레이션이 발생합니다. + +appSecret 값을 가져오려면 다음을 수행하십시오. + +1. 푸시 서비스에 바인드되는 *app-name*을 클릭하십시오. +2. **신임 정보 표시** 링크를 클릭하여 appSecret(AppID)을 표시하십시오. + +**신임 정보 표시** 화면에 다음과 같이 AppSecret에 대한 정보가 표시됩니다. +``` + { + "imfpush_Dev": [ + { + "name": "testapp1", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": { + "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", + "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", + "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", + } + } + ] + } +``` + {: codeblock} + + +##Push REST API 필터 +{: #push-api-rest-filters} + +필터는 {{site.data.keyword.mobilepushshort}}의 GET API에서 리턴되는 데이터를 제한하는 검색 기준을 정의합니다. 필터링할 Get 오퍼레이션의 결과에 대해 필터를 적용하십시오. 필터가 결과에 포함되는 항목의 수를 제한합니다. 예를 들면, 필터를 사용하여 "test"로 시작하는 태그를 검색할 수 있습니다. + +다음 구문을 사용하여 필터를 생성할 수 있습니다. + +**name**: 필터가 적용되는 필드 이름입니다. + +**operator**: 사용할 필터 일치를 설명하는 ==(정확히 일치) 또는 =@(하위 문자열 포함)입니다. + +**expression**: 결과에 포함시킬 값입니다. + +표현식에 쉼표 및 백슬래시가 표시될 경우 백슬래시로 이스케이프해야 합니다. + +여러 개의 필터를 사용할 경우 AND 및 OR 논리를 사용하여 필터를 결합할 수 있습니다. + +- AND 논리의 경우 조회에서 여러 필터를 사용하십시오. +- OR 논리의 경우 필터 식 안에 쉼표(,)를 사용하십시오. +- AND 및 OR 논리를 둘 다 사용할 경우, 단일 조회에 AND 및 OR 논리를 모두 포함시킬 수 있습니다. 각 필터는 AND 표현식에서 결합되기 전에 개별적으로 평가됩니다. + +디바이스 GET API의 경우 다음 조합이 지원됩니다. +-이름은 플랫폼 필드입니다. +- 플랫폼을 제외하고 연산자는 == 또는 =@일 수 있습니다. +- 플랫폼의 경우 연산자는 ==여야 합니다. 연산자 =@을 사용할 경우 값이 하위 문자열이 될 수 있습니다. +- ==를 사용할 경우 값이 정확히 일치하는 문자열이어야 합니다. + +구독 GET API의 경우 다음 조합이 지원됩니다. + +- 이름은 tagName 또는 deviceId 필드 중 하나일 수 있습니다. +- 플랫폼을 제외하고 연산자는 == 또는 =@일 수 있습니다. +- 플랫폼의 경우 연산자는 ==여야 합니다. +- =@ 연산자를 사용하는 경우 값은 하위 문자열이 될 수 있습니다. == 연산자를 사용하는 경우 값은 정확히 일치하는 문자열이어야 합니다. +- 태그 GET API의 경우 다음 조합이 지원됩니다. +- 이름은 "이름" 또는 "설명" 필드 중 하나일 수 있습니다. +- 연산자 =@을 사용할 경우 값이 하위 문자열이 될 수 있습니다. +- ==를 사용할 경우 값이 정확히 일치하는 문자열이어야 합니다. + + +##{{site.data.keyword.mobilepushshort}} 응답 코드 +{: #push-api-response-codes} + +상태: 405 허용되지 않은 메소드 - 적절한 메소드를 예상했습니다. diff --git a/services/mobilepush/nl/ko/t_sandbox.md b/services/mobilepush/nl/ko/t_sandbox.md index 2e7356aa7..dfe7d9723 100644 --- a/services/mobilepush/nl/ko/t_sandbox.md +++ b/services/mobilepush/nl/ko/t_sandbox.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 샌드박스 및 프로덕션 모드 -{: #push-sandboxandproduction-modes} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - -샌드박스 또는 프로덕션 모드 중 하나에서 {{site.data.keyword.mobilepushshort}}를 사용할 수 있습니다. 샌드박스는 서버 애플리케이션 푸시 서비스와 푸시 API 통합을 개발 및 테스트하는 자체 포함된 테스트 환경입니다. - -먼저 푸시 대시보드를 사용하여 샌드박스와 프로덕션 모드를 구성합니다. 푸시 서비스의 조작 모드를 전환할 수 있습니다([Push REST API](https://mobile.{DomainName}/imfpush/){: new_window}를 사용하여 샌드박스와 프로덕션 간 모드 전환). 기본적으로 샌드박스 모드가 설정됩니다. 그러나 모드 간에 전환할 경우 해당 모드 사이에서 태그, 디바이스 및 구독이 공유되지 않습니다. - -애플리케이션을 라이브 환경에 배치할 준비가 된 경우 [Push REST API](https://mobile.{DomainName}/imfpush/){: new_window}를 사용하여 프로덕션 모드를 선택하십시오. - -푸시 서비스 조작 모드를 샌드박스에서 프로덕션으로 전환하려면 다음을 수행하십시오. - -1. PUT ApplicationID Settings REST API 호출을 사용하십시오. -2. JSON 본문에서 [GET ApplicationID Settings REST](https://mobile.{DomainName}/imfpush/){: new_window} API 호출을 사용하여 모드가 전환되었는지 확인하십시오. 예상되는 응답은 "mode": "PRODUCTION입니다. -```{ - "mode": "PRODUCTION" - } - ``` - {: codeblock} -1. 환경 모드가 전환된 후 클라이언트 코드를 다시 실행하여 디바이스를 PRODUCTION 모드로 등록하십시오. - -REST API에 대한 정보는 [REST API 사용](t_restapi.html)을 참조하십시오. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 샌드박스 및 프로덕션 모드 +{: #push-sandboxandproduction-modes} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + +샌드박스 또는 프로덕션 모드 중 하나에서 {{site.data.keyword.mobilepushshort}}를 사용할 수 있습니다. 샌드박스는 서버 애플리케이션 푸시 서비스와 푸시 API 통합을 개발 및 테스트하는 자체 포함된 테스트 환경입니다. + +먼저 푸시 대시보드를 사용하여 샌드박스와 프로덕션 모드를 구성합니다. 푸시 서비스의 조작 모드를 전환할 수 있습니다([Push REST API](https://mobile.{DomainName}/imfpush/){: new_window}를 사용하여 샌드박스와 프로덕션 간 모드 전환). 기본적으로 샌드박스 모드가 설정됩니다. 그러나 모드 간에 전환할 경우 해당 모드 사이에서 태그, 디바이스 및 구독이 공유되지 않습니다. + +애플리케이션을 라이브 환경에 배치할 준비가 된 경우 [Push REST API](https://mobile.{DomainName}/imfpush/){: new_window}를 사용하여 프로덕션 모드를 선택하십시오. + +푸시 서비스 조작 모드를 샌드박스에서 프로덕션으로 전환하려면 다음을 수행하십시오. + +1. PUT ApplicationID Settings REST API 호출을 사용하십시오. +2. JSON 본문에서 [GET ApplicationID Settings REST](https://mobile.{DomainName}/imfpush/){: new_window} API 호출을 사용하여 모드가 전환되었는지 확인하십시오. 예상되는 응답은 "mode": "PRODUCTION입니다. +```{ + "mode": "PRODUCTION" + } + ``` + {: codeblock} +1. 환경 모드가 전환된 후 클라이언트 코드를 다시 실행하여 디바이스를 PRODUCTION 모드로 등록하십시오. + +REST API에 대한 정보는 [REST API 사용](t_restapi.html)을 참조하십시오. diff --git a/services/mobilepush/nl/ko/t_send_push_notifications.md b/services/mobilepush/nl/ko/t_send_push_notifications.md index 0c5eb0d3c..23020eca8 100644 --- a/services/mobilepush/nl/ko/t_send_push_notifications.md +++ b/services/mobilepush/nl/ko/t_send_push_notifications.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 기본 푸시 알림 전송 -{: #push-send-notifications} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - -애플리케이션이 개발된 후에는 (태그, 배지, 추가 페이로드 또는 사운드 파일을 사용하지 않아도) 기본 푸시 알림을 전송할 수 있습니다. - -기본 푸시 알림을 보내려면 다음에 나열된 단계를 완료하십시오. - -1. **알림 전송**을 선택한 후 적절한 **받는 사람** 옵션을 선택하십시오. - -**참고**: **모든 디바이스** 옵션을 선택하는 경우 {{site.data.keyword.mobilepushshort}}를 구독하는 모든 디바이스가 알림을 수신합니다. - -![알림 화면](images/tag_notification.jpg) -2. **메시지** 필드에 메시지를 입력한 후 **전송**을 클릭하십시오. - -3. 디바이스가 알림을 수신했는지 확인하십시오. 다음 이미지는 Android 및 iOS 디바이스의 포그라운드에서 {{site.data.keyword.mobilepushshort}}를 처리하는 경보 상자를 표시합니다. - -![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) - -![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) - -다음 스크린샷은 Android에서 사용되는 백그라운드의 {{site.data.keyword.mobilepushshort}}를 표시합니다. - -![Android의 백그라운드 푸시 알림](images/background.jpg) +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 기본 푸시 알림 전송 +{: #push-send-notifications} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + +애플리케이션이 개발된 후에는 (태그, 배지, 추가 페이로드 또는 사운드 파일을 사용하지 않아도) 기본 푸시 알림을 전송할 수 있습니다. + +기본 푸시 알림을 보내려면 다음에 나열된 단계를 완료하십시오. + +1. **알림 전송**을 선택한 후 적절한 **받는 사람** 옵션을 선택하십시오. + +**참고**: **모든 디바이스** 옵션을 선택하는 경우 {{site.data.keyword.mobilepushshort}}를 구독하는 모든 디바이스가 알림을 수신합니다. + +![알림 화면](images/tag_notification.jpg) +2. **메시지** 필드에 메시지를 입력한 후 **전송**을 클릭하십시오. + +3. 디바이스가 알림을 수신했는지 확인하십시오. 다음 이미지는 Android 및 iOS 디바이스의 포그라운드에서 {{site.data.keyword.mobilepushshort}}를 처리하는 경보 상자를 표시합니다. + +![Android의 포그라운드 푸시 알림](images/Android_Screenshot.jpg) + +![iOS의 포그라운드 푸시 알림](images/iOS_Screenshot.jpg) + +다음 스크린샷은 Android에서 사용되는 백그라운드의 {{site.data.keyword.mobilepushshort}}를 표시합니다. + +![Android의 백그라운드 푸시 알림](images/background.jpg) diff --git a/services/mobilepush/nl/ko/t_service_instance.md b/services/mobilepush/nl/ko/t_service_instance.md index a9151c5e7..e369df1f9 100644 --- a/services/mobilepush/nl/ko/t_service_instance.md +++ b/services/mobilepush/nl/ko/t_service_instance.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 푸시 서비스 인스턴스 작성 -{: #create-push-instance} - -{{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}를 시작하기 위해, 먼저 {{site.data.keyword.Bluemix}} 애플리케이션을 작성합니다(예: Node.js 앱). 그런 다음 이 Bluemix 애플리케이션에 바인드하는 데 필요한 푸시 서비스 인스턴스 {{site.data.keyword.mobilepushfull}}를 작성합니다. Bluemix 카탈로그의 표준 유형 섹션으로 이동하여 MobileFirst 서비스 스타터를 클릭하여 이를 수행할 수도 있습니다. - -**참고**: 환경을 관리하도록 조직을 구성하였으면, 모바일 앱을 위한 런타임과 서비스를 작성하려는 조직을 선택하십시오. - - -1. Bluemix 애플리케이션이 없는 경우 애플리케이션을 작성해야 합니다(예: Node.js 앱). Bluemix 애플리케이션을 작성하려면, Bluemix 대시보드로 이동하여 **앱 작성**을 클릭하십시오. - - **참고**: 애플리케이션이 있을 경우 7단계로 이동하여 서비스를 추가하십시오. ![서비스 인스턴스 작성](images/create_service_instance1.jpg "서비스 인스턴스 작성") - -1. **앱 템플리트 선택**에서 **웹**을 클릭하십시오. - -3. **시작점 선택** 영역에서 **SDK for Node.js**를 선택하고 **계속**을 클릭하십시오. ![시작점](images/create_service_nodejs2.jpg) - -4. **영역** 풀다운 메뉴에서 조직 영역을 선택하십시오. - - ![ -조직 영역 선택](images/create_a_service3.jpg) -1. **이름**에 앱의 이름을 입력하고 호스트에 호스트의 이름을 입력하십시오. - -1. **선택된 계획** 풀다운 메뉴에서 계획을 선택한 다음 **작성** 단추를 클릭하십시오. 애플리케이션이 스테이징될 때까지 대기하십시오. - -1. **개요** 링크를 클릭하십시오. ![서비스 추가](images/create_service_add4.jpg) -1. **서비스 추가**를 클릭하십시오. CATALOG 화면이 표시됩니다. - -1. **IBM 푸시 알림:**을 선택하고 **영역** 풀다운 메뉴에서 조직을 선택하십시오. - - ![조직 영역 풀다운 메뉴](images/create_service_org.jpg) -1. **서비스** 이름에 푸시 알림 서비스 이름을 입력하십시오. - -1. **선택된 계획**에서 계획을 선택하고 **작성** 단추를 클릭하십시오. - -1. **예**를 클릭하여 애플리케이션을 다시 스테이징하십시오. - - ![IBM 푸시 알림 서비스](images/create_service_notification5.jpg) - -1. **푸시 알림**을 클릭하여 푸시 알림 대시보드를 표시하십시오. +--- + +copyright: + years: 2015, 2016 + +--- + +# 푸시 서비스 인스턴스 작성 +{: #create-push-instance} + +{{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}를 시작하기 위해, 먼저 {{site.data.keyword.Bluemix}} 애플리케이션을 작성합니다(예: Node.js 앱). 그런 다음 이 Bluemix 애플리케이션에 바인드하는 데 필요한 푸시 서비스 인스턴스 {{site.data.keyword.mobilepushfull}}를 작성합니다. Bluemix 카탈로그의 표준 유형 섹션으로 이동하여 MobileFirst 서비스 스타터를 클릭하여 이를 수행할 수도 있습니다. + +**참고**: 환경을 관리하도록 조직을 구성하였으면, 모바일 앱을 위한 런타임과 서비스를 작성하려는 조직을 선택하십시오. + + +1. Bluemix 애플리케이션이 없는 경우 애플리케이션을 작성해야 합니다(예: Node.js 앱). Bluemix 애플리케이션을 작성하려면, Bluemix 대시보드로 이동하여 **앱 작성**을 클릭하십시오. + + **참고**: 애플리케이션이 있을 경우 7단계로 이동하여 서비스를 추가하십시오. ![서비스 인스턴스 작성](images/create_service_instance1.jpg "서비스 인스턴스 작성") + +1. **앱 템플리트 선택**에서 **웹**을 클릭하십시오. + +3. **시작점 선택** 영역에서 **SDK for Node.js**를 선택하고 **계속**을 클릭하십시오. ![시작점](images/create_service_nodejs2.jpg) + +4. **영역** 풀다운 메뉴에서 조직 영역을 선택하십시오. + + ![ +조직 영역 선택](images/create_a_service3.jpg) +1. **이름**에 앱의 이름을 입력하고 호스트에 호스트의 이름을 입력하십시오. + +1. **선택된 계획** 풀다운 메뉴에서 계획을 선택한 다음 **작성** 단추를 클릭하십시오. 애플리케이션이 스테이징될 때까지 대기하십시오. + +1. **개요** 링크를 클릭하십시오. ![서비스 추가](images/create_service_add4.jpg) +1. **서비스 추가**를 클릭하십시오. CATALOG 화면이 표시됩니다. + +1. **IBM 푸시 알림:**을 선택하고 **영역** 풀다운 메뉴에서 조직을 선택하십시오. + + ![조직 영역 풀다운 메뉴](images/create_service_org.jpg) +1. **서비스** 이름에 푸시 알림 서비스 이름을 입력하십시오. + +1. **선택된 계획**에서 계획을 선택하고 **작성** 단추를 클릭하십시오. + +1. **예**를 클릭하여 애플리케이션을 다시 스테이징하십시오. + + ![IBM 푸시 알림 서비스](images/create_service_notification5.jpg) + +1. **푸시 알림**을 클릭하여 푸시 알림 대시보드를 표시하십시오. diff --git a/services/mobilepush/nl/ko/t_subscribe_tags.md b/services/mobilepush/nl/ko/t_subscribe_tags.md index f08eba1d8..2d79bc007 100644 --- a/services/mobilepush/nl/ko/t_subscribe_tags.md +++ b/services/mobilepush/nl/ko/t_subscribe_tags.md @@ -1,126 +1,126 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 태그 구독 및 구독 해지 -{: #Subscribe_tags} - -다음 코드 스니펫을 사용하여 사용자 디바이스가 구독을 가져오고, 태그를 구독하고, 태그를 구독 해지할 수 있도록 합니다. - -## Android - -다음 코드 스니펫을 복사하여 Android 모바일 애플리케이션에 붙여넣으십시오. - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { -@Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - -## Cordova - -다음 코드 스니펫을 복사하여 Cordova 모바일 애플리케이션에 붙여넣으십시오. - -``` -var tag = "YourTag"; -MFPPush.subscribe(tag, success, failure); -MFPPush.unsubscribe(tag, success, failure); -``` - -## Objective-C - -다음 코드 스니펫을 복사하여 Objective-C 모바일 애플리케이션에 붙여넣으십시오. - -태그를 구독하려면 **subscribeToTags** API를 사용하십시오. - - -``` -[push subscribeToTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - }else{ - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response subscribeStatus]; - [self updateMessage:@"Parsed subscribe status is:"]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -태그 구독을 취소하려면 **unsubscribeFromTags** API를 사용하십시오. - -``` -[push unsubscribeFromTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if (error){ - [self updateMessage:error.description]; - } else { - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response unsubscribeStatus]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -## Swift - -다음 코드 스니펫을 복사하여 Swift 모바일 애플리케이션에 붙여넣으십시오. - -**사용 가능한 태그 구독** - -태그를 구독하려면 **subscribeToTags** API를 사용하십시오. - - -``` -push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in - if (error != nil) { - //error while subscribing to tags - } else { - //successfully subscribed to tags var subStatus = response.subscribeStatus(); - } -} -``` - -**태그 구독 해지** - -태그 구독을 취소하려면 **unsubscribeFromTags** API를 사용하십시오. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void inif error.isEmpty { - print( "Response during unsubscribed tags : \(response.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# 태그 구독 및 구독 해지 +{: #Subscribe_tags} + +다음 코드 스니펫을 사용하여 사용자 디바이스가 구독을 가져오고, 태그를 구독하고, 태그를 구독 해지할 수 있도록 합니다. + +## Android + +다음 코드 스니펫을 복사하여 Android 모바일 애플리케이션에 붙여넣으십시오. + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { +@Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + +## Cordova + +다음 코드 스니펫을 복사하여 Cordova 모바일 애플리케이션에 붙여넣으십시오. + +``` +var tag = "YourTag"; +MFPPush.subscribe(tag, success, failure); +MFPPush.unsubscribe(tag, success, failure); +``` + +## Objective-C + +다음 코드 스니펫을 복사하여 Objective-C 모바일 애플리케이션에 붙여넣으십시오. + +태그를 구독하려면 **subscribeToTags** API를 사용하십시오. + + +``` +[push subscribeToTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + }else{ + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response subscribeStatus]; + [self updateMessage:@"Parsed subscribe status is:"]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +태그 구독을 취소하려면 **unsubscribeFromTags** API를 사용하십시오. + +``` +[push unsubscribeFromTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if (error){ + [self updateMessage:error.description]; + } else { + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response unsubscribeStatus]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +## Swift + +다음 코드 스니펫을 복사하여 Swift 모바일 애플리케이션에 붙여넣으십시오. + +**사용 가능한 태그 구독** + +태그를 구독하려면 **subscribeToTags** API를 사용하십시오. + + +``` +push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in + if (error != nil) { + //error while subscribing to tags + } else { + //successfully subscribed to tags var subStatus = response.subscribeStatus(); + } +} +``` + +**태그 구독 해지** + +태그 구독을 취소하려면 **unsubscribeFromTags** API를 사용하십시오. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void inif error.isEmpty { + print( "Response during unsubscribed tags : \(response.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` diff --git a/services/mobilepush/nl/ko/t_use_tags.md b/services/mobilepush/nl/ko/t_use_tags.md index dc12be1c8..032da63dc 100644 --- a/services/mobilepush/nl/ko/t_use_tags.md +++ b/services/mobilepush/nl/ko/t_use_tags.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 태그 기반 알림 사용 -{: #using_tags} - - -태그 기반 알림은 특정 태그를 구독하는 모든 디바이스를 대상으로 하는 알림 메시지입니다. 각 디바이스는 원하는 수만큼의 태그에 대해 구독이 가능합니다. 여기서는 태그 기반 알림의 전송 방법에 대해 설명합니다. 구독은 푸시 알림 서비스 Bluemix 인스턴스에서 유지보수됩니다. 태그가 삭제되면 구독자와 디바이스를 포함하여 해당 태그와 연관된 모든 정보가 삭제됩니다. 이 태그가 더 이상 존재하지 않고 클라이언트측에서 추가 조치가 필요하지 않으므로 이 태그에 대해 자동 구독 해지 조치가 필요하지 않습니다. - -**시작하기 전에** - -**태그** 화면에서 태그를 작성하십시오. 태그 작성 방법에 대한 정보는 [태그 작성](t_manage_tags.html)을 참조하십시오. - -1. **푸시 알림** 대시보드에서 **알림** 탭을 클릭하십시오. -1. 태그 기반 알림을 전송할 **태그** 옵션을 선택하십시오. -1. **검색** 태그 필드에서 사용할 태그를 검색하고 **+추가** 단추를 클릭하십시오. ![알림 화면](images/tag_notification.jpg) -1. **메시지 텍스트** 필드의 **알림 작성** 영역으로 이동하여 알림에서 전송할 텍스트를 입력하십시오. -1. **전송** 단추를 클릭하십시오. +--- + +copyright: + years: 2015, 2016 + +--- + +# 태그 기반 알림 사용 +{: #using_tags} + + +태그 기반 알림은 특정 태그를 구독하는 모든 디바이스를 대상으로 하는 알림 메시지입니다. 각 디바이스는 원하는 수만큼의 태그에 대해 구독이 가능합니다. 여기서는 태그 기반 알림의 전송 방법에 대해 설명합니다. 구독은 푸시 알림 서비스 Bluemix 인스턴스에서 유지보수됩니다. 태그가 삭제되면 구독자와 디바이스를 포함하여 해당 태그와 연관된 모든 정보가 삭제됩니다. 이 태그가 더 이상 존재하지 않고 클라이언트측에서 추가 조치가 필요하지 않으므로 이 태그에 대해 자동 구독 해지 조치가 필요하지 않습니다. + +**시작하기 전에** + +**태그** 화면에서 태그를 작성하십시오. 태그 작성 방법에 대한 정보는 [태그 작성](t_manage_tags.html)을 참조하십시오. + +1. **푸시 알림** 대시보드에서 **알림** 탭을 클릭하십시오. +1. 태그 기반 알림을 전송할 **태그** 옵션을 선택하십시오. +1. **검색** 태그 필드에서 사용할 태그를 검색하고 **+추가** 단추를 클릭하십시오. ![알림 화면](images/tag_notification.jpg) +1. **메시지 텍스트** 필드의 **알림 작성** 영역으로 이동하여 알림에서 전송할 텍스트를 입력하십시오. +1. **전송** 단추를 클릭하십시오. diff --git a/services/mobilepush/nl/ko/tr_error_push.md b/services/mobilepush/nl/ko/tr_error_push.md index b59436189..ef174962e 100644 --- a/services/mobilepush/nl/ko/tr_error_push.md +++ b/services/mobilepush/nl/ko/tr_error_push.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}} 서비스 오류 메시지 -{: #errors} -마지막 업데이트 날짜: 2017년 2월 13일 -{: .last-updated} - - -다음과 같은 {{site.data.keyword.mobilepushshort}} 오류 메시지는 -REST API 요청에 대한 응답으로 리턴됩니다. - -샘플 오류 응답: -``` - { - "message": "Missing APNs credentials", - "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", - "code": "FPWSE0003E" - } -``` - {: codeblock} - -오류에 대한 추가 정보를 얻으려면 문서에서 관련 오류 코드를 검색하십시오. - -## FPWSE0001E -{: #error_fpwse0001e} - -**설명**: 조회하려는 자원(예: 태그 또는 구독)이 서버에 없습니다. - -**사용자 응답**: 메시지에서 보고된 리소스를 작성하십시오. 또는 올바른 ID를 제공하여 리소스를 조회할 수 있습니다. - - -## FPWSE0002E -{: #error_fpwse0002e} - -**설명**: 작성하려는 자원이 서버에 이미 있습니다. 자원은 태그, 구독 등일 수 있습니다. - -**사용자 응답**: 다른 ID를 사용하여 리소스를 작성하십시오. - - -## FPWSE0003E -{: #error_fpwse0003e} - -**설명**: {{site.data.keyword.mobilepushshort}} 서비스에 대한 전제조건 구성이 완료되지 않았습니다. Apple 푸시 알림 서비스(APNs) 신임 정보가 구성되기 전에 해당 신임 정보를 가져오려고 했을 수 있습니다. - -**사용자 응답**: {{site.data.keyword.mobilepushshort}} 서비스가 APNs에 대한 올바른 보안 인증서를 사용하여 구성되었는지 확인하십시오. 자세한 정보는 [APNs에 대한 신임 정보 구성 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](t_push_provider_ios.html){: new_window}을 참조하십시오. - - -## FPWSE0004E -{: #error_fpwse0004e} - -**설명**: 요청에 포함된 JSON 본문이 올바르지 않습니다. - - -**사용자 응답**: 요청에서 올바른 JSON 구문을 사용하는지 확인하십시오. - - - -## FPWSE0005E -{: #error_fpwse0005e} - -**설명**: API 요청을 완료하는 데 필요한 특성이 JSON 본문에 포함되어 있지 않기 때문에 {{site.data.keyword.mobilepushshort}} 서버에 대한 요청이 올바르지 않거나 완전하지 않습니다. 예를 들어, 비밀번호가 올바르지 않거나 디바이스 토큰이 누락되었습니다. - - -**사용자 응답**: 메시지를 검토하여 올바르지 않거나 누락된 특성 값을 확인한 후 필수 정보를 제공하십시오. - - - -## FPWSE0006E -{: #error_fpwse0006e} - -**설명**: 요청의 JSON 본문에 {{site.data.keyword.mobilepushshort}} 서버에서 이해할 수 없는 매개변수가 있습니다. - - -**사용자 응답**: 요청의 JSON 본문이 {{site.data.keyword.mobilepushshort}} 서버에서 예상하는 요청의 형식을 따르는지 확인하십시오. 자세한 정보는 [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 참조하십시오. - - - -## FPWSE0007E -{: #error_fpwse0007e} - -**설명**: 요청 URL에 인식되지 않는 매개변수가 포함된 조회 문자열이 있습니다. 예를 들어, 구독을 삭제하기 위한 요청에 deviceId 및 tagName 이외의 매개변수가 있는 경우 이 오류가 발생할 수 있습니다. - - -**사용자 응답**: 요청의 JSON 본문이 {{site.data.keyword.mobilepushshort}} 서버에서 예상하는 요청의 형식을 따르는지 확인하십시오. 자세한 정보는 [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 참조하십시오. - - - -## FPWSE0008E -{: #error_fpwse0008e} - -**설명**: 요청 URL에 필수 매개변수가 누락된 조회 문자열이 있습니다. 예를 들어, 구독을 삭제하기 위한 요청에서 deviceId 및 tagName 매개변수가 누락되었을 수 있습니다. - - -**사용자 응답**: 요청의 JSON 본문이 {{site.data.keyword.mobilepushshort}} 서버에서 예상하는 요청의 형식을 따르는지 확인하십시오. 자세한 정보는 [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 참조하십시오. - - - -## FPWSE0009E -{: #error_fpwse0009e} - -**설명**: 알림 전송이 시도되었지만 애플리케이션에 등록된 디바이스가 없습니다. - -**사용자 응답**: 알림 전송을 시도하기 전에 디바이스가 애플리케이션에 등록되었는지 확인하십시오. - - - -## FPWSE0010E -{: #error_fpwse0010e} - -**설명**: 서버에 제출된 요청이 예외 조건을 생성했습니다. 다음 조건 중 하나가 이 오류를 일으켰을 수 있습니다. - -- {{site.data.keyword.mobilepushshort}}가 사용하는 내부 시스템이 응답하지 않습니다. -- 요청이 {{site.data.keyword.mobilepushshort}}에서 처리할 수 없는 오류 조건을 생성했습니다. -- {{site.data.keyword.mobilepushshort}} 서비스가 관리자의 조치가 필요한 상태입니다. - -**사용자 응답**: 요청을 재시도하십시오. 문제가 계속되면 IBM 소프트웨어 지원 부서에 문의하십시오. - - - -## FPWSE0011E -{: #error_fpwse0011e} - -**설명**: 태그에 대한 구독이 이미 서버에 있습니다. 예를 들어, 이미 존재하는 구독을 작성하려고 했습니다. - -**사용자 응답**: 고유한 태그 이름을 사용하여 구독을 작성하십시오. - - - -## FPWSE0012E -{: #error_fpwse0012e} - -**설명**: 태그에 대한 구독이 이미 서버에 없습니다. 이 오류는 존재하지 않는 구독을 검색하거나 삭제하는 요청이 제출되는 경우에 발생합니다. - - -**사용자 응답**: 요청에 올바른 태그 이름 및 디바이스 ID를 사용하십시오. - - - -## FPWSE0013E -{: #error_fpwse0013e} - -**설명**: 요청에 포함된 JSON 페이로드가 올바르지 않습니다. - - -**사용자 응답**: JSON 페이로드가 올바른지 확인하십시오. - - -## FPWSE0025E -{: #error_fpwse0025e} - -**설명**: 현재 서버는 요청을 처리할 수 없습니다. - -**사용자 응답**: 나중에 요청을 다시 제출하십시오. - - -## FPWSE1007E -{: #error_fpwse1007e} - -**설명**: {{site.data.keyword.mobilepushshort}} 서비스가 이 애플리케이션에 대해 사용하지 않도록 설정되었습니다. 요금 청구 관련 문제이거나 관리자가 앱을 사용하지 않도록 설정했을 수 있습니다. - - -**사용자 응답**: Bluemix 문서의 문제점 해결 주제에서 서비스 상태를 확인하고 문제점 해결 정보 또는 지원을 받는 방법에 대한 정보를 검토하십시오. - - - -## FPWSE1079E -{: #error_fpwse1079e} - -**설명**: 조회 오퍼레이션에 제공된 오프셋 값이 올바르지 않습니다. - -**사용자 응답**: 오프셋 값이 0보다 크거나 같은지 확인하십시오. - - - -## FPWSE1080E -{: #error_fpwse1080e} - -**설명**: 조회 오퍼레이션에 제공된 크기 값이 올바르지 않습니다. - -**사용자 응답**: 크기 값이 0보다 큰지 확인하십시오. - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}} 서비스 오류 메시지 +{: #errors} +마지막 업데이트 날짜: 2017년 2월 13일 +{: .last-updated} + + +다음과 같은 {{site.data.keyword.mobilepushshort}} 오류 메시지는 +REST API 요청에 대한 응답으로 리턴됩니다. + +샘플 오류 응답: +``` + { + "message": "Missing APNs credentials", + "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", + "code": "FPWSE0003E" + } +``` + {: codeblock} + +오류에 대한 추가 정보를 얻으려면 문서에서 관련 오류 코드를 검색하십시오. + +## FPWSE0001E +{: #error_fpwse0001e} + +**설명**: 조회하려는 자원(예: 태그 또는 구독)이 서버에 없습니다. + +**사용자 응답**: 메시지에서 보고된 리소스를 작성하십시오. 또는 올바른 ID를 제공하여 리소스를 조회할 수 있습니다. + + +## FPWSE0002E +{: #error_fpwse0002e} + +**설명**: 작성하려는 자원이 서버에 이미 있습니다. 자원은 태그, 구독 등일 수 있습니다. + +**사용자 응답**: 다른 ID를 사용하여 리소스를 작성하십시오. + + +## FPWSE0003E +{: #error_fpwse0003e} + +**설명**: {{site.data.keyword.mobilepushshort}} 서비스에 대한 전제조건 구성이 완료되지 않았습니다. Apple 푸시 알림 서비스(APNs) 신임 정보가 구성되기 전에 해당 신임 정보를 가져오려고 했을 수 있습니다. + +**사용자 응답**: {{site.data.keyword.mobilepushshort}} 서비스가 APNs에 대한 올바른 보안 인증서를 사용하여 구성되었는지 확인하십시오. 자세한 정보는 [APNs에 대한 신임 정보 구성 ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](t_push_provider_ios.html){: new_window}을 참조하십시오. + + +## FPWSE0004E +{: #error_fpwse0004e} + +**설명**: 요청에 포함된 JSON 본문이 올바르지 않습니다. + + +**사용자 응답**: 요청에서 올바른 JSON 구문을 사용하는지 확인하십시오. + + + +## FPWSE0005E +{: #error_fpwse0005e} + +**설명**: API 요청을 완료하는 데 필요한 특성이 JSON 본문에 포함되어 있지 않기 때문에 {{site.data.keyword.mobilepushshort}} 서버에 대한 요청이 올바르지 않거나 완전하지 않습니다. 예를 들어, 비밀번호가 올바르지 않거나 디바이스 토큰이 누락되었습니다. + + +**사용자 응답**: 메시지를 검토하여 올바르지 않거나 누락된 특성 값을 확인한 후 필수 정보를 제공하십시오. + + + +## FPWSE0006E +{: #error_fpwse0006e} + +**설명**: 요청의 JSON 본문에 {{site.data.keyword.mobilepushshort}} 서버에서 이해할 수 없는 매개변수가 있습니다. + + +**사용자 응답**: 요청의 JSON 본문이 {{site.data.keyword.mobilepushshort}} 서버에서 예상하는 요청의 형식을 따르는지 확인하십시오. 자세한 정보는 [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 참조하십시오. + + + +## FPWSE0007E +{: #error_fpwse0007e} + +**설명**: 요청 URL에 인식되지 않는 매개변수가 포함된 조회 문자열이 있습니다. 예를 들어, 구독을 삭제하기 위한 요청에 deviceId 및 tagName 이외의 매개변수가 있는 경우 이 오류가 발생할 수 있습니다. + + +**사용자 응답**: 요청의 JSON 본문이 {{site.data.keyword.mobilepushshort}} 서버에서 예상하는 요청의 형식을 따르는지 확인하십시오. 자세한 정보는 [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 참조하십시오. + + + +## FPWSE0008E +{: #error_fpwse0008e} + +**설명**: 요청 URL에 필수 매개변수가 누락된 조회 문자열이 있습니다. 예를 들어, 구독을 삭제하기 위한 요청에서 deviceId 및 tagName 매개변수가 누락되었을 수 있습니다. + + +**사용자 응답**: 요청의 JSON 본문이 {{site.data.keyword.mobilepushshort}} 서버에서 예상하는 요청의 형식을 따르는지 확인하십시오. 자세한 정보는 [REST API ![외부 링크 아이콘](../../icons/launch-glyph.svg "외부 링크 아이콘")](https://mobile.{DomainName}/imfpush/){: new_window}을 참조하십시오. + + + +## FPWSE0009E +{: #error_fpwse0009e} + +**설명**: 알림 전송이 시도되었지만 애플리케이션에 등록된 디바이스가 없습니다. + +**사용자 응답**: 알림 전송을 시도하기 전에 디바이스가 애플리케이션에 등록되었는지 확인하십시오. + + + +## FPWSE0010E +{: #error_fpwse0010e} + +**설명**: 서버에 제출된 요청이 예외 조건을 생성했습니다. 다음 조건 중 하나가 이 오류를 일으켰을 수 있습니다. + +- {{site.data.keyword.mobilepushshort}}가 사용하는 내부 시스템이 응답하지 않습니다. +- 요청이 {{site.data.keyword.mobilepushshort}}에서 처리할 수 없는 오류 조건을 생성했습니다. +- {{site.data.keyword.mobilepushshort}} 서비스가 관리자의 조치가 필요한 상태입니다. + +**사용자 응답**: 요청을 재시도하십시오. 문제가 계속되면 IBM 소프트웨어 지원 부서에 문의하십시오. + + + +## FPWSE0011E +{: #error_fpwse0011e} + +**설명**: 태그에 대한 구독이 이미 서버에 있습니다. 예를 들어, 이미 존재하는 구독을 작성하려고 했습니다. + +**사용자 응답**: 고유한 태그 이름을 사용하여 구독을 작성하십시오. + + + +## FPWSE0012E +{: #error_fpwse0012e} + +**설명**: 태그에 대한 구독이 이미 서버에 없습니다. 이 오류는 존재하지 않는 구독을 검색하거나 삭제하는 요청이 제출되는 경우에 발생합니다. + + +**사용자 응답**: 요청에 올바른 태그 이름 및 디바이스 ID를 사용하십시오. + + + +## FPWSE0013E +{: #error_fpwse0013e} + +**설명**: 요청에 포함된 JSON 페이로드가 올바르지 않습니다. + + +**사용자 응답**: JSON 페이로드가 올바른지 확인하십시오. + + +## FPWSE0025E +{: #error_fpwse0025e} + +**설명**: 현재 서버는 요청을 처리할 수 없습니다. + +**사용자 응답**: 나중에 요청을 다시 제출하십시오. + + +## FPWSE1007E +{: #error_fpwse1007e} + +**설명**: {{site.data.keyword.mobilepushshort}} 서비스가 이 애플리케이션에 대해 사용하지 않도록 설정되었습니다. 요금 청구 관련 문제이거나 관리자가 앱을 사용하지 않도록 설정했을 수 있습니다. + + +**사용자 응답**: Bluemix 문서의 문제점 해결 주제에서 서비스 상태를 확인하고 문제점 해결 정보 또는 지원을 받는 방법에 대한 정보를 검토하십시오. + + + +## FPWSE1079E +{: #error_fpwse1079e} + +**설명**: 조회 오퍼레이션에 제공된 오프셋 값이 올바르지 않습니다. + +**사용자 응답**: 오프셋 값이 0보다 크거나 같은지 확인하십시오. + + + +## FPWSE1080E +{: #error_fpwse1080e} + +**설명**: 조회 오퍼레이션에 제공된 크기 값이 올바르지 않습니다. + +**사용자 응답**: 크기 값이 0보다 큰지 확인하십시오. + + + diff --git a/services/mobilepush/nl/ko/troubleshooting.md b/services/mobilepush/nl/ko/troubleshooting.md index 8e40c21c4..964f965ea 100644 --- a/services/mobilepush/nl/ko/troubleshooting.md +++ b/services/mobilepush/nl/ko/troubleshooting.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 문제점 해결 -{: #errors} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - -이 섹션을 참조하여 공통 {{site.data.keyword.mobilepushshort}} 문제를 해결할 수 있습니다. - - -### 내부 서버 오류가 발생했습니다. 관리자에게 문의하십시오. (내부 오류 코드: PUSHD102E) - -**설명**: 이 오류는 2015년 11월 이전에 푸시 인스턴스를 작성한 경우에 발생할 수 있습니다. - -**사용자 응답**: 이 문제를 해결하려면 푸시 인스턴스를 삭제하고 새로 작성하십시오. 푸시 인스턴스를 삭제하면 태그가 보존되지 않습니다. - - -### 권한이 없는 등록 - -**설명**: Chrome 웹 푸시가 FCM(Firebase Cloud Messaging) 키로 작동하지 않습니다. GCM에서 FCM으로 이동한 후 Chrome에서 푸시 알림을 수신할 수 없는 경우, 이는 웹 사이트가 이전에 GCM 프로젝트에서 작동하도록 구성되었고 새 프로젝트는 FCM에서 작성되었기 때문입니다. 브라우저를 식별하는 생성된 토큰은 Chrome 브라우저에 의해 캐시됩니다. - -**사용자 응답**: 쿠키를 제거하고 브라우저의 권한을 재설정하여 이 문제를 해결할 수 있습니다. 이 조치는 푸시 알림을 사용 가능하게 설정하는 권한을 요청합니다. - - -### 서비스 작업자는 이 브라우저에서 지원되지 않음 - -**설명**: 서비스 작업자를 사용하여 `BMSPushSDK.js`의 일부로 포함된 SDK를 사용할 수 없습니다. - -**사용자 응답**: 서비스 작업자를 지원하는 브라우저로 전환하는 것이 좋습니다. 지원되는 브라우저 버전은 Firefox 버전 49 이상 및 Chrome 버전 53(64비트) 이상입니다. - - -### SecurityError: 작업이 안전하지 않음 - -**설명**: Firefox에서 웹 콘솔을 사용할 때 오류가 표시될 수 있습니다. 푸시 알림 서비스에서 웹 푸시를 지원하려면 `http`가 아니라 `https` 프로토콜로 웹 사이트에 액세스해야 합니다. - -**사용자 응답**: 브라우저에서 `https`를 사용하여 웹 사이트에 연결하는 것이 좋습니다. - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 문제점 해결 +{: #errors} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + +이 섹션을 참조하여 공통 {{site.data.keyword.mobilepushshort}} 문제를 해결할 수 있습니다. + + +### 내부 서버 오류가 발생했습니다. 관리자에게 문의하십시오. (내부 오류 코드: PUSHD102E) + +**설명**: 이 오류는 2015년 11월 이전에 푸시 인스턴스를 작성한 경우에 발생할 수 있습니다. + +**사용자 응답**: 이 문제를 해결하려면 푸시 인스턴스를 삭제하고 새로 작성하십시오. 푸시 인스턴스를 삭제하면 태그가 보존되지 않습니다. + + +### 권한이 없는 등록 + +**설명**: Chrome 웹 푸시가 FCM(Firebase Cloud Messaging) 키로 작동하지 않습니다. GCM에서 FCM으로 이동한 후 Chrome에서 푸시 알림을 수신할 수 없는 경우, 이는 웹 사이트가 이전에 GCM 프로젝트에서 작동하도록 구성되었고 새 프로젝트는 FCM에서 작성되었기 때문입니다. 브라우저를 식별하는 생성된 토큰은 Chrome 브라우저에 의해 캐시됩니다. + +**사용자 응답**: 쿠키를 제거하고 브라우저의 권한을 재설정하여 이 문제를 해결할 수 있습니다. 이 조치는 푸시 알림을 사용 가능하게 설정하는 권한을 요청합니다. + + +### 서비스 작업자는 이 브라우저에서 지원되지 않음 + +**설명**: 서비스 작업자를 사용하여 `BMSPushSDK.js`의 일부로 포함된 SDK를 사용할 수 없습니다. + +**사용자 응답**: 서비스 작업자를 지원하는 브라우저로 전환하는 것이 좋습니다. 지원되는 브라우저 버전은 Firefox 버전 49 이상 및 Chrome 버전 53(64비트) 이상입니다. + + +### SecurityError: 작업이 안전하지 않음 + +**설명**: Firefox에서 웹 콘솔을 사용할 때 오류가 표시될 수 있습니다. 푸시 알림 서비스에서 웹 푸시를 지원하려면 `http`가 아니라 `https` 프로토콜로 웹 사이트에 액세스해야 합니다. + +**사용자 응답**: 브라우저에서 `https`를 사용하여 웹 사이트에 연결하는 것이 좋습니다. + diff --git a/services/mobilepush/nl/ko/troubleshooting_config_errors.md b/services/mobilepush/nl/ko/troubleshooting_config_errors.md index 1de50de38..1601608c1 100644 --- a/services/mobilepush/nl/ko/troubleshooting_config_errors.md +++ b/services/mobilepush/nl/ko/troubleshooting_config_errors.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 웹 푸시 구성 오류 해결 -{: #errors} -마지막 업데이트 날짜: 2017년 1월 11일 -{: .last-updated} - -이 섹션을 참조하여 일반적으로 발생하는 웹 푸시 구성 관련 오류를 해결하십시오. `BMSPushSDK.js`의 웹 푸시 오류에는 실패에 대한 정보가 포함되어 있습니다. - -콜백에 리턴된 오류를 구문 분석하려면 다음 샘플 코드를 살펴보십시오. - -``` -function showStatus(response) { - if(response.statusCode == 200 || response.statusCode == 201) { - document.getElementById("status").innerHTML = "Response is " + response.response; - } - else if(response.statusCode == 0) { - if(response.response) { - document.getElementById("status").innerHTML = response.response; - } - else { - document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; - } - } - else { - document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " - + response.error + " and the status code " + response.statusCode; - } - } -``` - {: codeblock} - - -- `applicationId`가 잘못 구성되면 {{site.data.keyword.mobilepushshort}} 서비스에 대한 초기 요청에 실패하므로 statusCode가 영(0)으로 설정됩니다. -- 상태 코드가 200 또는 201이면 성공적인 응답을 나타냅니다. -- `clientSecret`가 올바르지 않으면 401 응답이 statusCode에 설정됩니다. `response.reponse` 요소에 오류의 설명이 포함됩니다. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 웹 푸시 구성 오류 해결 +{: #errors} +마지막 업데이트 날짜: 2017년 1월 11일 +{: .last-updated} + +이 섹션을 참조하여 일반적으로 발생하는 웹 푸시 구성 관련 오류를 해결하십시오. `BMSPushSDK.js`의 웹 푸시 오류에는 실패에 대한 정보가 포함되어 있습니다. + +콜백에 리턴된 오류를 구문 분석하려면 다음 샘플 코드를 살펴보십시오. + +``` +function showStatus(response) { + if(response.statusCode == 200 || response.statusCode == 201) { + document.getElementById("status").innerHTML = "Response is " + response.response; + } + else if(response.statusCode == 0) { + if(response.response) { + document.getElementById("status").innerHTML = response.response; + } + else { + document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; + } + } + else { + document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " + + response.error + " and the status code " + response.statusCode; + } + } +``` + {: codeblock} + + +- `applicationId`가 잘못 구성되면 {{site.data.keyword.mobilepushshort}} 서비스에 대한 초기 요청에 실패하므로 statusCode가 영(0)으로 설정됩니다. +- 상태 코드가 200 또는 201이면 성공적인 응답을 나타냅니다. +- `clientSecret`가 올바르지 않으면 401 응답이 statusCode에 설정됩니다. `response.reponse` 요소에 오류의 설명이 포함됩니다. diff --git a/services/mobilepush/nl/pt/BR/c_advance_notifications.md b/services/mobilepush/nl/pt/BR/c_advance_notifications.md index b059c1074..963514f1e 100644 --- a/services/mobilepush/nl/pt/BR/c_advance_notifications.md +++ b/services/mobilepush/nl/pt/BR/c_advance_notifications.md @@ -1,12 +1,12 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# Ativando notificações push avançadas -{: #push-advanced-notifications-main} - -Configure um badge iOS, som, carga útil JSON adicional, notificações acionáveis e notificações de participação. +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# Ativando notificações push avançadas +{: #push-advanced-notifications-main} + +Configure um badge iOS, som, carga útil JSON adicional, notificações acionáveis e notificações de participação. diff --git a/services/mobilepush/nl/pt/BR/c_android_enable.md b/services/mobilepush/nl/pt/BR/c_android_enable.md index 4a4fd8c8a..214a08bab 100644 --- a/services/mobilepush/nl/pt/BR/c_android_enable.md +++ b/services/mobilepush/nl/pt/BR/c_android_enable.md @@ -1,360 +1,360 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Ativando aplicativos Android para receber {{site.data.keyword.mobilepushshort}} -{: #tag_based_notifications} -Última atualização: 14 de fevereiro de 2017 -{: .last-updated} - -É possível ativar os aplicativos do Android para receber notificações push para os seus dispositivos. O Android Studio é um pré-requisito e é o método recomendado para construir projetos Android. Um conhecimento de configuração básica de Android Studio é essencial. - -## Instalando o Client Push SDK com Gradle -{: #android_install} - -Esta seção descreve como instalar e usar o Client Push SDK para desenvolver ainda mais os aplicativos Android. - -O Bluemix® Mobile Services Push SDK pode ser incluído usando o Gradle. O Gradle faz download automaticamente dos artefatos de repositórios e os disponibiliza para seu aplicativo Android. Assegure-se de configurar corretamente o Android Studio e o Android Studio SDK. Para obter mais informações sobre como configurar seu sistema, veja a [Visão geral do Android Studio ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.android.com/tools/studio/index.html){: new_window}. Para obter informações sobre o Gradle, veja [Configurando construções do Gradle ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}. - -Após a criação e a abertura do seu aplicativo móvel, conclua as etapas a seguir usando o Android Studio. - -1. Inclua dependências em seu arquivo de nível Módulo **build.gradle**. - - - Inclua a dependência a seguir para incluir o SDK do cliente Push dos serviços do Bluemix™ Mobile e o SDK dos serviços do Google Play em suas dependências do escopo de compilação. - ``` - com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ - ``` - {: codeblock} - - - Inclua as dependências a seguir para importar instruções que são requeridas para os fragmentos de código. - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - {: codeblock} - - - Inclua a dependência a seguir no arquivo de nível Módulo **build.gradle** no final. - ``` - apply plugin: 'com.google.gms.google-services' - ``` - {: codeblock} -3. Inclua as dependências a seguir para o seu arquivo de nível Projeto **build.gradle**. -``` -dependencies { - classpath 'com.android.tools.build:gradle:2.2.3' - classpath 'com.google.gms:google-services:3.0.0' -} -``` - {: codeblock} -5. No arquivo **AndroidManifest.xml**, inclua as permissões a seguir. Para visualizar um manifest de amostra, veja [Aplicativo de amostra helloPush Android ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}. Para visualizar um arquivo Gradle de amostra, veja [Arquivo Gradle de construção de amostra ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}. -``` - - - - - -``` - {: codeblock} - Leia mais sobre as [Permissões do Android ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/guide/topics/security/permissions.html){: new_window} aqui. - -4. Inclua as configurações de intento de notificação da atividade. Essa configuração inicia o aplicativo quando o usuário clica na notificação recebida da área de notificação. -``` - - - - -``` - {: codeblock} -**Nota**: substitua *Your_Android_Package_Name* na ação anterior pelo nome do pacote de aplicativos usado em seu aplicativo. - -5. Inclua o serviço de intenção e os filtros de intenção do Firebase Cloud Messaging (FCM) ou do Google Cloud Messaging (GCM) para as notificações de eventos RECEIVE e REGISTRATION. -``` - - - - - - - - - - -``` - {: codeblock} - -6. O serviço {{site.data.keyword.mobilepushshort}} suporta a recuperação de notificações individuais a partir da bandeja de notificação. Para notificações acessadas a partir da bandeja de notificação, você receberá um identificador somente para a notificação que estiver sendo clicada. Todas as notificações são exibidas quando o aplicativo é aberto normalmente. Para usar essa funcionalidade, atualize o seu arquivo **AndroidManifest.xml** com o fragmento a seguir: - -``` - -``` - {: codeblock} - -Para configurar o projeto FCM e obter as suas credenciais, veja [Obtendo o seu ID de emissor e chave API](t_push_provider_android.html). Conclua as etapas a seguir usando o console do Firebase Cloud Messaging (FCM). - -1. No console do Firebase, clique no ícone **Configurações de projeto**. - ![Configurações de projeto do Firebase](images/FCM_4.jpg) - -3. Selecione **INCLUIR APP** ou **Incluir Firebase em seu ícone de app Android** a partir da guia Geral no painel Seus apps. - ![Incluindo Firebase no Android](images/FCM_5.jpg) - -4. Na janela Incluir Firebase no seu app Android, inclua **com.ibm.mobilefirstplatform.clientsdk.android.push** como o Nome do pacote. O campo de apelido App é opcional. Clique em **INCLUIR APP**. - ![Incluindo o Firebase em sua janela do Android](images/FCM_1.jpg) - -5. Inclua o nome do pacote do seu aplicativo inserindo o nome do pacote na janela Incluir Firebase no seu app Android. O campo de apelido App é opcional. Clique em **INCLUIR APP**. - - ![Incluindo o nome do pacote do seu aplicativo](images/FCM_2.jpg) - -6. O arquivo `google-services.json` é gerado. Copie o arquivo `google-services.json` para o seu diretório-raiz do módulo do aplicativo Android. Observe que o arquivo `google-service.json` inclui os nomes de pacote adicionados. - - ![Incluindo o arquivo json no diretório-raiz do seu aplicativo](images/FCM_7.jpg) - -5. Na janela Incluir Firebase no seu app Android, clique em **Continuar** e, em seguida, **Concluir**. - - - -Construa e execute o seu aplicativo. - -## Inicializando os apps Push SDK for Android -{: #android_initialize} - -Um local comum para colocar o código de inicialização está no método onCreate da atividade principal no aplicativo Android. Há dois componentes do SDK que precisam ser inicializados. Um é o SDK principal e o outro é o SDK push construído sobre o SDK principal. - -###Inicializar o SDK principal - -``` -// Initialize the SDK for Android - BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); -``` - {: codeblock} - -####bluemixRegionSuffix -{: bluemixRegionSuffix} - -Especifica o local em que o app está hospedado. É possível usar um destes três valores: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -###Inicializar o Push SDK do cliente - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext(), "appGUID", "clientSecret"); -``` - {: codeblock} - -####AppGUID -{: appguid_initialize_client_push_sdk} - -Esta é a chave AppGUID do serviço {{site.data.keyword.mobilepushshort}}. Esse valor faz distinção entre maiúsculas e minúsculas. Abra o painel Notificação push e selecione a guia Configurar. É possível obter esse valor em Opções móveis na guia configurar no painel de serviço Notificação push. - -## Registrando dispositivos Android -{: #android_register} - -Use a API `MFPPush.register()` para registrar o dispositivo com o serviço {{site.data.keyword.mobilepushshort}}. Para o registro para dispositivos Android, inclua as informações do Firebase Cloud Messaging (FCM) ou do Google Cloud Messaging (GCM) no painel de configuração de serviço {{site.data.keyword.mobilepushshort}} do Bluemix. Para obter mais informações, consulte [Configurando credenciais para o Google Cloud Messaging](t_push_provider_android.html). - -Copie os fragmentos de código a seguir para seu aplicativo móvel Android. - -``` - //Register Android devices -push.registerDevice(new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - {: codeblock} - - -``` - //Handles the notification when it arrives -MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ -// Handle Push Notification - } - }; -``` - {: codeblock} - -## Recebendo notificações push em dispositivos Android -{: #android_receive} - -Para registrar o objeto notificationListener com push, chame o método **MFPPush.listen()**. Esse método é chamado geralmente a partir do método** onResume() **da atividade que está manipulando as notificações push. - -1. Para registrar o objeto notificationListener com push, chame o método **listen()**. Este método é geralmente chamado a partir dos métodos **onResume()** e **onPause** da atividade que está manipulando as notificações push. - - -``` - @Override -protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` - {: codeblock} - - - -``` - @Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} - -2. Compile o projeto e execute-o no dispositivo ou simulador. Quando o método onSuccess() para o listener de resposta no método register() for chamado, ele confirmará que o dispositivo foi registrado com sucesso com o serviço {{site.data.keyword.mobilepushshort}}. Nesse momento, é possível enviar uma mensagem conforme descrito em Enviando notificações push básicas. -3. Verifique se seus dispositivos receberam sua notificação. Se o aplicativo estiver em execução no primeiro plano, a notificação será manipulada por **MFPPushNotificationListener**. Se o aplicativo estiver em segundo plano, uma mensagem será exibida na barra de notificações. - -## Monitorando notificações push em dispositivos Android -{: #android_monitor} - -Para monitorar o status atual da notificação dentro do aplicativo, é possível implementar a interface `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` e definir o método onStatusChange(String messageId, MFPPushNotificationStatus status). - -O **messageId** é o identificador da mensagem enviada do servidor. **MFPPushNotificationStatus** define o status das notificações como valores: - -- **RECEIVED** - o app recebeu a notificação. -- **QUEUED** - o app enfileira a notificação para chamar o listener de notificação. -- **OPENED** - o usuário abre a notificação clicando na notificação na bandeja, ativando-a no ícone do app ou quando o app está em primeiro plano. -- **DISMISSED** - o usuário limpa/descarta a notificação na bandeja. - -É necessário registrar a classe **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** com MFPPush. - -``` - push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { - @Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { - // Handle status change -} - }); -``` - {: codeblock} - - -### Atendendo ao status DISMISSED - -É possível optar por atender ao status DISMISSED em uma das seguintes condições: - -- Quando o app está ativo (em execução em primeiro plano ou em segundo plano) - - Inclua o fragmento no seu arquivo `AndroidManifest.xml`: - -``` - - - - - -``` - {: codeblock} - -- Quando o app está ativo (em execução em primeiro plano ou em segundo plano) e não executando (encerrado) - -É necessário estender o receptor de transmissão **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** e substituir o método **onReceive()**, em que o **MFPPushNotificationStatusListener** deve ser registrado antes de chamar o método **onReceive()** da classe de base. - -``` - public class MyDismissHandler extends MFPPushNotificationDismissHandler { - @Override -public void onReceive(Context context, Intent intent) { - MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { - @Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { - // Handle status change -} - }); -super.onReceive(context, intent); -} - } -``` - {: codeblock} - - -Inclua o fragmento a seguir no arquivo `AndroidManifest.xml`: - -``` - - - - - -``` - {: codeblock} - -## Enviando {{site.data.keyword.mobilepushshort}} básicas -{: #send} - -Depois de ter desenvolvido seus aplicativos, será possível enviar notificações push básicas. - -Para enviar notificações push básicas, conclua as etapas: - -1. Selecione **Enviar notificações** e componha uma mensagem escolhendo uma opção **Enviar para**. As opções suportadas são **Dispositivo por tag**, **ID do dispositivo**, **ID do usuário**, **Dispositivos Android**, **Dispositivos iOS**, **Notificações da web** e **Todos os dispositivos**. -**Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para {{site.data.keyword.mobilepushshort}} receberão notificações. -![Tela de notificações](images/tag_notification.jpg) - -2. No campo **Mensagem**, componha sua mensagem. Escolha a configurar das definições opcionais conforme necessário. -3. Clique em **Enviar**. -3. Verifique se seus dispositivos receberam sua notificação. - -A captura de tela a seguir mostra uma caixa de alerta que -manipula uma notificação push no primeiro plano em um dispositivo Android. - -![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) - -A captura de tela a seguir mostra uma notificação push no plano de fundo para Android. - -![Notificação push no plano de fundo no Android](images/background.jpg) - -### Configurações opcionais do Android para envio de notificações -{: #send_otpional_setting} - -É possível customizar ainda mais as configurações do {{site.data.keyword.mobilepushshort}} para enviar notificações a dispositivos Android. As opções de customização opcionais a seguir são suportadas. -![Configurações customizadas do Android](images/android_custom_settings.jpg) - -- **Chave de redução**: as chaves de redução são anexadas às notificações. Se diversas notificações chegarem sequencialmente com a mesma chave de redução quando o dispositivo estiver off-line, elas serão reduzidas. Quando um dispositivo fica on-line, ele recebe notificações a partir do servidor FCM/GCM e exibe somente a notificação mais recente que comporta a mesma chave de redução. Se a chave de redução não estiver configurada, as mensagens novas e antigas serão armazenadas para entrega futura. -- **Som**: indica que um clique de som seja reproduzido no recebimento de uma notificação. Suporta o padrão ou o nome de um recurso de som empacotado no app. -- **Ícone**: especifique o nome do ícone a ser exibido para a notificação. Assegure-se de ter empacotado o ícone na pasta rec/desenhável com o aplicativo cliente. -- **Prioridade**: especifica as opções para designar prioridade de entrega às mensagens. Uma prioridade `high` ou `max` resultará em notificação direta, enquanto mensagens com prioridade `low` ou `default` não abririam conexões de rede em um dispositivo em suspensão. Para mensagens com a opção configurada como `min`, será uma notificação silenciosa. -- **Visibilidade**: é possível optar por configurar a opção de visibilidade de notificação como `public` ou `private`. A opção `private` restringe a visualização pública e será possível optar por ativá-la se seu dispositivo for protegido com pin ou padrão e a configuração de notificação estiver configurada como "Ocultar conteúdo de notificação confidencial". Quando a visibilidade for configurada como `private`, um campo "redact" deverá ser mencionado. Somente o conteúdo especificado no campo de edição será exibido em uma tela bloqueada segura no dispositivo. A escolha de `public` renderizaria as notificações para serem livremente lidas. -- **Tempo de vida**: esse valor é configurado em segundos. Se esse parâmetro não for especificado, o servidor FCM/GCM armazenará a mensagem por quatro semanas e tentará entregar. A validade expira após quatro semanas. A faixa de valores possíveis vai de 0 a 2.419.200 segundos. -- **Atrasar quando inativo**: configurar esse valor como `true` instruirá o servidor FCM/GCM a não entregar a notificação se o dispositivo estiver inativo. Configure esse valor como `false` para assegurar a entrega de notificação mesmo que o dispositivo esteja inativo. -- **Sincronizar**: a configuração dessa opção como `true` sincroniza as notificações entre todos os dispositivos registrados. Se o usuário com um nome de usuário tiver diversos dispositivos com o mesmo aplicativo instalado, a leitura da notificação em um dispositivo assegura a exclusão das notificações nos outros dispositivos. É preciso assegurar-se de estar registrado no serviço {{site.data.keyword.mobilepushshort}} com userId para que essa opção funcione. -- **Carga útil adicional**: especifica os valores de carga útil customizados para suas notificações. - - -## Etapas Seguintes -{: #next_steps_tags} - -Depois de configurar com êxito notificações básicas, é possível configurar notificações baseadas em tag e opções avançadas. - -Inclua esses recursos de serviço de notificações push no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). -Para usar opções de notificações avançadas, veja [Ativando notificações push avançadas](t_advance_badge_sound_payload.html). +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ativando aplicativos Android para receber {{site.data.keyword.mobilepushshort}} +{: #tag_based_notifications} +Última atualização: 14 de fevereiro de 2017 +{: .last-updated} + +É possível ativar os aplicativos do Android para receber notificações push para os seus dispositivos. O Android Studio é um pré-requisito e é o método recomendado para construir projetos Android. Um conhecimento de configuração básica de Android Studio é essencial. + +## Instalando o Client Push SDK com Gradle +{: #android_install} + +Esta seção descreve como instalar e usar o Client Push SDK para desenvolver ainda mais os aplicativos Android. + +O Bluemix® Mobile Services Push SDK pode ser incluído usando o Gradle. O Gradle faz download automaticamente dos artefatos de repositórios e os disponibiliza para seu aplicativo Android. Assegure-se de configurar corretamente o Android Studio e o Android Studio SDK. Para obter mais informações sobre como configurar seu sistema, veja a [Visão geral do Android Studio ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.android.com/tools/studio/index.html){: new_window}. Para obter informações sobre o Gradle, veja [Configurando construções do Gradle ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}. + +Após a criação e a abertura do seu aplicativo móvel, conclua as etapas a seguir usando o Android Studio. + +1. Inclua dependências em seu arquivo de nível Módulo **build.gradle**. + + - Inclua a dependência a seguir para incluir o SDK do cliente Push dos serviços do Bluemix™ Mobile e o SDK dos serviços do Google Play em suas dependências do escopo de compilação. + ``` + com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ + ``` + {: codeblock} + + - Inclua as dependências a seguir para importar instruções que são requeridas para os fragmentos de código. + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + {: codeblock} + + - Inclua a dependência a seguir no arquivo de nível Módulo **build.gradle** no final. + ``` + apply plugin: 'com.google.gms.google-services' + ``` + {: codeblock} +3. Inclua as dependências a seguir para o seu arquivo de nível Projeto **build.gradle**. +``` +dependencies { + classpath 'com.android.tools.build:gradle:2.2.3' + classpath 'com.google.gms:google-services:3.0.0' +} +``` + {: codeblock} +5. No arquivo **AndroidManifest.xml**, inclua as permissões a seguir. Para visualizar um manifest de amostra, veja [Aplicativo de amostra helloPush Android ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}. Para visualizar um arquivo Gradle de amostra, veja [Arquivo Gradle de construção de amostra ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}. +``` + + + + + +``` + {: codeblock} + Leia mais sobre as [Permissões do Android ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](http://developer.android.com/guide/topics/security/permissions.html){: new_window} aqui. + +4. Inclua as configurações de intento de notificação da atividade. Essa configuração inicia o aplicativo quando o usuário clica na notificação recebida da área de notificação. +``` + + + + +``` + {: codeblock} +**Nota**: substitua *Your_Android_Package_Name* na ação anterior pelo nome do pacote de aplicativos usado em seu aplicativo. + +5. Inclua o serviço de intenção e os filtros de intenção do Firebase Cloud Messaging (FCM) ou do Google Cloud Messaging (GCM) para as notificações de eventos RECEIVE e REGISTRATION. +``` + + + + + + + + + + +``` + {: codeblock} + +6. O serviço {{site.data.keyword.mobilepushshort}} suporta a recuperação de notificações individuais a partir da bandeja de notificação. Para notificações acessadas a partir da bandeja de notificação, você receberá um identificador somente para a notificação que estiver sendo clicada. Todas as notificações são exibidas quando o aplicativo é aberto normalmente. Para usar essa funcionalidade, atualize o seu arquivo **AndroidManifest.xml** com o fragmento a seguir: + +``` + +``` + {: codeblock} + +Para configurar o projeto FCM e obter as suas credenciais, veja [Obtendo o seu ID de emissor e chave API](t_push_provider_android.html). Conclua as etapas a seguir usando o console do Firebase Cloud Messaging (FCM). + +1. No console do Firebase, clique no ícone **Configurações de projeto**. + ![Configurações de projeto do Firebase](images/FCM_4.jpg) + +3. Selecione **INCLUIR APP** ou **Incluir Firebase em seu ícone de app Android** a partir da guia Geral no painel Seus apps. + ![Incluindo Firebase no Android](images/FCM_5.jpg) + +4. Na janela Incluir Firebase no seu app Android, inclua **com.ibm.mobilefirstplatform.clientsdk.android.push** como o Nome do pacote. O campo de apelido App é opcional. Clique em **INCLUIR APP**. + ![Incluindo o Firebase em sua janela do Android](images/FCM_1.jpg) + +5. Inclua o nome do pacote do seu aplicativo inserindo o nome do pacote na janela Incluir Firebase no seu app Android. O campo de apelido App é opcional. Clique em **INCLUIR APP**. + + ![Incluindo o nome do pacote do seu aplicativo](images/FCM_2.jpg) + +6. O arquivo `google-services.json` é gerado. Copie o arquivo `google-services.json` para o seu diretório-raiz do módulo do aplicativo Android. Observe que o arquivo `google-service.json` inclui os nomes de pacote adicionados. + + ![Incluindo o arquivo json no diretório-raiz do seu aplicativo](images/FCM_7.jpg) + +5. Na janela Incluir Firebase no seu app Android, clique em **Continuar** e, em seguida, **Concluir**. + + + +Construa e execute o seu aplicativo. + +## Inicializando os apps Push SDK for Android +{: #android_initialize} + +Um local comum para colocar o código de inicialização está no método onCreate da atividade principal no aplicativo Android. Há dois componentes do SDK que precisam ser inicializados. Um é o SDK principal e o outro é o SDK push construído sobre o SDK principal. + +###Inicializar o SDK principal + +``` +// Initialize the SDK for Android + BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); +``` + {: codeblock} + +####bluemixRegionSuffix +{: bluemixRegionSuffix} + +Especifica o local em que o app está hospedado. É possível usar um destes três valores: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +###Inicializar o Push SDK do cliente + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext(), "appGUID", "clientSecret"); +``` + {: codeblock} + +####AppGUID +{: appguid_initialize_client_push_sdk} + +Esta é a chave AppGUID do serviço {{site.data.keyword.mobilepushshort}}. Esse valor faz distinção entre maiúsculas e minúsculas. Abra o painel Notificação push e selecione a guia Configurar. É possível obter esse valor em Opções móveis na guia configurar no painel de serviço Notificação push. + +## Registrando dispositivos Android +{: #android_register} + +Use a API `MFPPush.register()` para registrar o dispositivo com o serviço {{site.data.keyword.mobilepushshort}}. Para o registro para dispositivos Android, inclua as informações do Firebase Cloud Messaging (FCM) ou do Google Cloud Messaging (GCM) no painel de configuração de serviço {{site.data.keyword.mobilepushshort}} do Bluemix. Para obter mais informações, consulte [Configurando credenciais para o Google Cloud Messaging](t_push_provider_android.html). + +Copie os fragmentos de código a seguir para seu aplicativo móvel Android. + +``` + //Register Android devices +push.registerDevice(new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + {: codeblock} + + +``` + //Handles the notification when it arrives +MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ +// Handle Push Notification + } + }; +``` + {: codeblock} + +## Recebendo notificações push em dispositivos Android +{: #android_receive} + +Para registrar o objeto notificationListener com push, chame o método **MFPPush.listen()**. Esse método é chamado geralmente a partir do método** onResume() **da atividade que está manipulando as notificações push. + +1. Para registrar o objeto notificationListener com push, chame o método **listen()**. Este método é geralmente chamado a partir dos métodos **onResume()** e **onPause** da atividade que está manipulando as notificações push. + + +``` + @Override +protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` + {: codeblock} + + + +``` + @Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} + +2. Compile o projeto e execute-o no dispositivo ou simulador. Quando o método onSuccess() para o listener de resposta no método register() for chamado, ele confirmará que o dispositivo foi registrado com sucesso com o serviço {{site.data.keyword.mobilepushshort}}. Nesse momento, é possível enviar uma mensagem conforme descrito em Enviando notificações push básicas. +3. Verifique se seus dispositivos receberam sua notificação. Se o aplicativo estiver em execução no primeiro plano, a notificação será manipulada por **MFPPushNotificationListener**. Se o aplicativo estiver em segundo plano, uma mensagem será exibida na barra de notificações. + +## Monitorando notificações push em dispositivos Android +{: #android_monitor} + +Para monitorar o status atual da notificação dentro do aplicativo, é possível implementar a interface `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` e definir o método onStatusChange(String messageId, MFPPushNotificationStatus status). + +O **messageId** é o identificador da mensagem enviada do servidor. **MFPPushNotificationStatus** define o status das notificações como valores: + +- **RECEIVED** - o app recebeu a notificação. +- **QUEUED** - o app enfileira a notificação para chamar o listener de notificação. +- **OPENED** - o usuário abre a notificação clicando na notificação na bandeja, ativando-a no ícone do app ou quando o app está em primeiro plano. +- **DISMISSED** - o usuário limpa/descarta a notificação na bandeja. + +É necessário registrar a classe **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** com MFPPush. + +``` + push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { + @Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { + // Handle status change +} + }); +``` + {: codeblock} + + +### Atendendo ao status DISMISSED + +É possível optar por atender ao status DISMISSED em uma das seguintes condições: + +- Quando o app está ativo (em execução em primeiro plano ou em segundo plano) + + Inclua o fragmento no seu arquivo `AndroidManifest.xml`: + +``` + + + + + +``` + {: codeblock} + +- Quando o app está ativo (em execução em primeiro plano ou em segundo plano) e não executando (encerrado) + +É necessário estender o receptor de transmissão **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** e substituir o método **onReceive()**, em que o **MFPPushNotificationStatusListener** deve ser registrado antes de chamar o método **onReceive()** da classe de base. + +``` + public class MyDismissHandler extends MFPPushNotificationDismissHandler { + @Override +public void onReceive(Context context, Intent intent) { + MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { + @Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { + // Handle status change +} + }); +super.onReceive(context, intent); +} + } +``` + {: codeblock} + + +Inclua o fragmento a seguir no arquivo `AndroidManifest.xml`: + +``` + + + + + +``` + {: codeblock} + +## Enviando {{site.data.keyword.mobilepushshort}} básicas +{: #send} + +Depois de ter desenvolvido seus aplicativos, será possível enviar notificações push básicas. + +Para enviar notificações push básicas, conclua as etapas: + +1. Selecione **Enviar notificações** e componha uma mensagem escolhendo uma opção **Enviar para**. As opções suportadas são **Dispositivo por tag**, **ID do dispositivo**, **ID do usuário**, **Dispositivos Android**, **Dispositivos iOS**, **Notificações da web** e **Todos os dispositivos**. +**Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para {{site.data.keyword.mobilepushshort}} receberão notificações. +![Tela de notificações](images/tag_notification.jpg) + +2. No campo **Mensagem**, componha sua mensagem. Escolha a configurar das definições opcionais conforme necessário. +3. Clique em **Enviar**. +3. Verifique se seus dispositivos receberam sua notificação. + +A captura de tela a seguir mostra uma caixa de alerta que +manipula uma notificação push no primeiro plano em um dispositivo Android. + +![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) + +A captura de tela a seguir mostra uma notificação push no plano de fundo para Android. + +![Notificação push no plano de fundo no Android](images/background.jpg) + +### Configurações opcionais do Android para envio de notificações +{: #send_otpional_setting} + +É possível customizar ainda mais as configurações do {{site.data.keyword.mobilepushshort}} para enviar notificações a dispositivos Android. As opções de customização opcionais a seguir são suportadas. +![Configurações customizadas do Android](images/android_custom_settings.jpg) + +- **Chave de redução**: as chaves de redução são anexadas às notificações. Se diversas notificações chegarem sequencialmente com a mesma chave de redução quando o dispositivo estiver off-line, elas serão reduzidas. Quando um dispositivo fica on-line, ele recebe notificações a partir do servidor FCM/GCM e exibe somente a notificação mais recente que comporta a mesma chave de redução. Se a chave de redução não estiver configurada, as mensagens novas e antigas serão armazenadas para entrega futura. +- **Som**: indica que um clique de som seja reproduzido no recebimento de uma notificação. Suporta o padrão ou o nome de um recurso de som empacotado no app. +- **Ícone**: especifique o nome do ícone a ser exibido para a notificação. Assegure-se de ter empacotado o ícone na pasta rec/desenhável com o aplicativo cliente. +- **Prioridade**: especifica as opções para designar prioridade de entrega às mensagens. Uma prioridade `high` ou `max` resultará em notificação direta, enquanto mensagens com prioridade `low` ou `default` não abririam conexões de rede em um dispositivo em suspensão. Para mensagens com a opção configurada como `min`, será uma notificação silenciosa. +- **Visibilidade**: é possível optar por configurar a opção de visibilidade de notificação como `public` ou `private`. A opção `private` restringe a visualização pública e será possível optar por ativá-la se seu dispositivo for protegido com pin ou padrão e a configuração de notificação estiver configurada como "Ocultar conteúdo de notificação confidencial". Quando a visibilidade for configurada como `private`, um campo "redact" deverá ser mencionado. Somente o conteúdo especificado no campo de edição será exibido em uma tela bloqueada segura no dispositivo. A escolha de `public` renderizaria as notificações para serem livremente lidas. +- **Tempo de vida**: esse valor é configurado em segundos. Se esse parâmetro não for especificado, o servidor FCM/GCM armazenará a mensagem por quatro semanas e tentará entregar. A validade expira após quatro semanas. A faixa de valores possíveis vai de 0 a 2.419.200 segundos. +- **Atrasar quando inativo**: configurar esse valor como `true` instruirá o servidor FCM/GCM a não entregar a notificação se o dispositivo estiver inativo. Configure esse valor como `false` para assegurar a entrega de notificação mesmo que o dispositivo esteja inativo. +- **Sincronizar**: a configuração dessa opção como `true` sincroniza as notificações entre todos os dispositivos registrados. Se o usuário com um nome de usuário tiver diversos dispositivos com o mesmo aplicativo instalado, a leitura da notificação em um dispositivo assegura a exclusão das notificações nos outros dispositivos. É preciso assegurar-se de estar registrado no serviço {{site.data.keyword.mobilepushshort}} com userId para que essa opção funcione. +- **Carga útil adicional**: especifica os valores de carga útil customizados para suas notificações. + + +## Etapas Seguintes +{: #next_steps_tags} + +Depois de configurar com êxito notificações básicas, é possível configurar notificações baseadas em tag e opções avançadas. + +Inclua esses recursos de serviço de notificações push no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). +Para usar opções de notificações avançadas, veja [Ativando notificações push avançadas](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/pt/BR/c_chrome_firefox_enable.md b/services/mobilepush/nl/pt/BR/c_chrome_firefox_enable.md index 02fb5b503..1707ebb9f 100644 --- a/services/mobilepush/nl/pt/BR/c_chrome_firefox_enable.md +++ b/services/mobilepush/nl/pt/BR/c_chrome_firefox_enable.md @@ -1,149 +1,149 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Ativando aplicativos da web para receber o {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -Última atualização: 16 de fevereiro de 2017 -{: .last-updated} - -É possível ativar os aplicativos da web Google Chrome, Mozilla Firefox e Safari para receber o -{{site.data.keyword.mobilepushshort}}. Assegure-se de que você tenha passado por [Configurando credenciais para um provedor de notificação](t__main_push_config_provider.html) antes de continuar com as etapas. - -## Instalando o SDK do cliente do navegador da web para {{site.data.keyword.mobilepushshort}} -{: #web_install} - -Este tópico descreve como instalar e usar o SDK de Push do JavaScript do cliente para desenvolver ainda mais os seus aplicativos da web. - -### Inicializando no aplicativo da web - -Para instalar o SDK do Javascript no aplicativo da web do Google Chrome, conclua as etapas: - -Faça download dos arquivos `BMSPushSDK.js`, `BMSPushServiceWorker.js` e -`manifest_Website.json` por meio do -[SDK -de push da web do Bluemix](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. - -1. Edite o arquivo `manifest_Website.json`. - - Para o navegador Google Chrome, mude `name` para o nome do seu site. Por -exemplo, `www.dailynewsupdates.com`. Mude o -`gcm_sender_id` para o seu sender_ID do Firebase Cloud Messaging -(FCM) ou do Google Cloud Messaging (GCM). Para obter mais -informações, veja [Obtendo o seu ID de -emissor e chave API](t_push_provider_android.html). O valor gcm_sender_id contém somente números. - - ``` - { - "name": "YOUR_WEBSITE_NAME", - "gcm_sender_id": "GCM_Sender_Id" - } - ``` - {: codeblock} - - - Para o navegador Mozilla Firefox, inclua os valores a seguir no arquivo `manifest_Website.json`. Forneça -um `name` apropriado. Isso seria o nome de seu website. - - ``` - { - "name": "YOUR_WEBSITE_NAME" - } - ``` - {: codeblock} - -2. Mude o nome do arquivo `manifest_Website.json` para `manifest.json`. -3. Inclua o `BMSPushSDK.js`, -`BMSPushServiceWorker.js` e -`manifest.json` no diretório-raiz do seu website. -3. Inclua o `manifest.json` na tag `` de seu arquivo html. - ``` - - ``` - {: codeblock} -4. Inclua o SDK de push da web do Bluemix em seu aplicativo da web. - ``` - - ``` - {: codeblock} - -**Nota**: assegure-se de que o código seja implementado e que o link de amostra seja acessado usando `https` e não `http`. - -## Inicializando o Web Push SDK -{: #web_initialize} - -Inicialize o SDK de push com o `app GUID` e o `app Region` do Bluemix {{site.data.keyword.mobilepushshort}}. - -Para obter o GUID do app, selecione a opção **Configuração** na área de janela de navegação para seus serviços de push inicializados e clique em **Opções móveis**. Modifique o fragmento de código para usar o parâmetro appGUID do serviço de notificações push do Bluemix. - -O `App Region` especifica o local no qual o serviço {{site.data.keyword.mobilepushshort}} é hospedado. É possível usar um destes três valores: - - - Para Dalas EUA: `.ng.bluemix.net` - - Para Reino Unido: `.eu-gb.bluemix.net` - - Para Sydney: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(initParams, callback) -``` - {: codeblock} - -**Nota**: se suas credenciais de FCM forem mudadas para SDK de push da web, a -entrega da mensagem poderá falhar para o navegador Chrome. Assegure-se de chamar -`bmsPush.unRegisterDevice` para evitar falha. - -Você poderá ver erros relacionados à configuração se fornecer um parâmetro errado. Para obter mais informações, veja [Resolvendo erros de configuração Push da web](troubleshooting_config_errors.html). - -## Registrando o aplicativo da web -{: #web_register} - -Use a API **register()** para registrar o dispositivo no serviço -{{site.data.keyword.mobilepushshort}}. Use qualquer uma das -opções a seguir, com base em seu navegador. - -- Para o registro a partir do Google Chrome, inclua a Chave API do Firebase Cloud Messaging (FCM) ou do Google Cloud -Messaging (GCM) e a URL do website no painel de configuração da web de serviço {{site.data.keyword.mobilepushshort}} do Bluemix. Para obter mais informações, consulte [Configurando as credenciais do Google Cloud Messaging](t_push_provider_android.html) na configuração do Chrome. - -- Para registro a partir do Mozilla Firefox, inclua a URL do website no painel de configuração da web do serviço Bluemix {{site.data.keyword.mobilepushshort}} na configuração do Firefox. - -Use o fragmento de código a seguir para registrar o serviço Bluemix -{{site.data.keyword.mobilepushshort}}. - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ativando aplicativos da web para receber o {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +Última atualização: 16 de fevereiro de 2017 +{: .last-updated} + +É possível ativar os aplicativos da web Google Chrome, Mozilla Firefox e Safari para receber o +{{site.data.keyword.mobilepushshort}}. Assegure-se de que você tenha passado por [Configurando credenciais para um provedor de notificação](t__main_push_config_provider.html) antes de continuar com as etapas. + +## Instalando o SDK do cliente do navegador da web para {{site.data.keyword.mobilepushshort}} +{: #web_install} + +Este tópico descreve como instalar e usar o SDK de Push do JavaScript do cliente para desenvolver ainda mais os seus aplicativos da web. + +### Inicializando no aplicativo da web + +Para instalar o SDK do Javascript no aplicativo da web do Google Chrome, conclua as etapas: + +Faça download dos arquivos `BMSPushSDK.js`, `BMSPushServiceWorker.js` e +`manifest_Website.json` por meio do +[SDK +de push da web do Bluemix](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. + +1. Edite o arquivo `manifest_Website.json`. + - Para o navegador Google Chrome, mude `name` para o nome do seu site. Por +exemplo, `www.dailynewsupdates.com`. Mude o +`gcm_sender_id` para o seu sender_ID do Firebase Cloud Messaging +(FCM) ou do Google Cloud Messaging (GCM). Para obter mais +informações, veja [Obtendo o seu ID de +emissor e chave API](t_push_provider_android.html). O valor gcm_sender_id contém somente números. + + ``` + { + "name": "YOUR_WEBSITE_NAME", + "gcm_sender_id": "GCM_Sender_Id" + } + ``` + {: codeblock} + + - Para o navegador Mozilla Firefox, inclua os valores a seguir no arquivo `manifest_Website.json`. Forneça +um `name` apropriado. Isso seria o nome de seu website. + + ``` + { + "name": "YOUR_WEBSITE_NAME" + } + ``` + {: codeblock} + +2. Mude o nome do arquivo `manifest_Website.json` para `manifest.json`. +3. Inclua o `BMSPushSDK.js`, +`BMSPushServiceWorker.js` e +`manifest.json` no diretório-raiz do seu website. +3. Inclua o `manifest.json` na tag `` de seu arquivo html. + ``` + + ``` + {: codeblock} +4. Inclua o SDK de push da web do Bluemix em seu aplicativo da web. + ``` + + ``` + {: codeblock} + +**Nota**: assegure-se de que o código seja implementado e que o link de amostra seja acessado usando `https` e não `http`. + +## Inicializando o Web Push SDK +{: #web_initialize} + +Inicialize o SDK de push com o `app GUID` e o `app Region` do Bluemix {{site.data.keyword.mobilepushshort}}. + +Para obter o GUID do app, selecione a opção **Configuração** na área de janela de navegação para seus serviços de push inicializados e clique em **Opções móveis**. Modifique o fragmento de código para usar o parâmetro appGUID do serviço de notificações push do Bluemix. + +O `App Region` especifica o local no qual o serviço {{site.data.keyword.mobilepushshort}} é hospedado. É possível usar um destes três valores: + + - Para Dalas EUA: `.ng.bluemix.net` + - Para Reino Unido: `.eu-gb.bluemix.net` + - Para Sydney: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(initParams, callback) +``` + {: codeblock} + +**Nota**: se suas credenciais de FCM forem mudadas para SDK de push da web, a +entrega da mensagem poderá falhar para o navegador Chrome. Assegure-se de chamar +`bmsPush.unRegisterDevice` para evitar falha. + +Você poderá ver erros relacionados à configuração se fornecer um parâmetro errado. Para obter mais informações, veja [Resolvendo erros de configuração Push da web](troubleshooting_config_errors.html). + +## Registrando o aplicativo da web +{: #web_register} + +Use a API **register()** para registrar o dispositivo no serviço +{{site.data.keyword.mobilepushshort}}. Use qualquer uma das +opções a seguir, com base em seu navegador. + +- Para o registro a partir do Google Chrome, inclua a Chave API do Firebase Cloud Messaging (FCM) ou do Google Cloud +Messaging (GCM) e a URL do website no painel de configuração da web de serviço {{site.data.keyword.mobilepushshort}} do Bluemix. Para obter mais informações, consulte [Configurando as credenciais do Google Cloud Messaging](t_push_provider_android.html) na configuração do Chrome. + +- Para registro a partir do Mozilla Firefox, inclua a URL do website no painel de configuração da web do serviço Bluemix {{site.data.keyword.mobilepushshort}} na configuração do Firefox. + +Use o fragmento de código a seguir para registrar o serviço Bluemix +{{site.data.keyword.mobilepushshort}}. + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + + + diff --git a/services/mobilepush/nl/pt/BR/c_chrome_firefox_enable_send.md b/services/mobilepush/nl/pt/BR/c_chrome_firefox_enable_send.md index 6c6515da7..5174519d3 100644 --- a/services/mobilepush/nl/pt/BR/c_chrome_firefox_enable_send.md +++ b/services/mobilepush/nl/pt/BR/c_chrome_firefox_enable_send.md @@ -1,45 +1,45 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Enviando notificações básicas para navegadores da web -{: #web_notifications} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - -Depois de ter desenvolvido seus aplicativos, é possível enviar uma notificação push. - -1. Selecione **Enviar notificações** e componha uma mensagem escolhendo **Notificações da web** como a opção **Enviar para**. -2. Digite a mensagem que precisa ser entregue no campo **Mensagem**. -3. É possível optar por fornecer configurações opcionais: - - **Título da notificação**: esse é o texto que seria exibido como título de alerta de mensagem. - - **URL do ícone de notificação**: se sua mensagem precisar ser entregue com um ícone de notificação de app, forneça o link para o ícone no campo. - - **Tempo de vida**: notifica o servidor sobre a validade das mensagens. -4. Para notificações da web enviadas ao navegador Safari, há algumas informações adicionais necessárias: - - **Ação**: este é o rótulo do botão de ação. - - **Argumentos da URL**: os argumentos da URL que precisam ser usados com esta -notificação. Assegure-se de que isso seja fornecido na forma de uma matriz JSON. - -A imagem a seguir mostra a opção de notificações da web no painel. - - ![Tela de notificações](images/DashboardWebpush.jpg) - - -## Etapas Seguintes - {: #next_steps_tags} - -Após ter configurado com sucesso as notificações básicas, -será possível configurar notificações baseadas em tag e opções avançadas. - -Inclua esses recursos de serviço do {{site.data.keyword.mobilepushshort}} no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). Para usar opções de notificações avançadas, veja [Notificações avançadas](t_advance_badge_sound_payload.html). - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Enviando notificações básicas para navegadores da web +{: #web_notifications} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + +Depois de ter desenvolvido seus aplicativos, é possível enviar uma notificação push. + +1. Selecione **Enviar notificações** e componha uma mensagem escolhendo **Notificações da web** como a opção **Enviar para**. +2. Digite a mensagem que precisa ser entregue no campo **Mensagem**. +3. É possível optar por fornecer configurações opcionais: + - **Título da notificação**: esse é o texto que seria exibido como título de alerta de mensagem. + - **URL do ícone de notificação**: se sua mensagem precisar ser entregue com um ícone de notificação de app, forneça o link para o ícone no campo. + - **Tempo de vida**: notifica o servidor sobre a validade das mensagens. +4. Para notificações da web enviadas ao navegador Safari, há algumas informações adicionais necessárias: + - **Ação**: este é o rótulo do botão de ação. + - **Argumentos da URL**: os argumentos da URL que precisam ser usados com esta +notificação. Assegure-se de que isso seja fornecido na forma de uma matriz JSON. + +A imagem a seguir mostra a opção de notificações da web no painel. + + ![Tela de notificações](images/DashboardWebpush.jpg) + + +## Etapas Seguintes + {: #next_steps_tags} + +Após ter configurado com sucesso as notificações básicas, +será possível configurar notificações baseadas em tag e opções avançadas. + +Inclua esses recursos de serviço do {{site.data.keyword.mobilepushshort}} no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). Para usar opções de notificações avançadas, veja [Notificações avançadas](t_advance_badge_sound_payload.html). + + + diff --git a/services/mobilepush/nl/pt/BR/c_cordova_enable.md b/services/mobilepush/nl/pt/BR/c_cordova_enable.md index 6286fc4e3..30a321c90 100644 --- a/services/mobilepush/nl/pt/BR/c_cordova_enable.md +++ b/services/mobilepush/nl/pt/BR/c_cordova_enable.md @@ -1,347 +1,347 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Ativando aplicativos Cordova para receber -notificações push -{: #cordova_enable} -Última atualização: 18 de janeiro de 2017 -{: .last-updated} - -Cordova é uma plataforma para criar aplicativos híbridos -com JavaScript, CSS e HTML. O serviço {{site.data.keyword.mobilepushshort}} suporta o desenvolvimento -de aplicativos iOS e Android baseados em Cordova. - -É possível ativar aplicativos Cordova para receber notificações push para os seus dispositivos. - -## Instalando o plug-in do push Cordova -{: #cordova_install} - -Instale e use o plug-in de push do cliente para desenvolver ainda mais seus aplicativos Cordova. Isso também instala o plug-in núcleo do Cordova, que inicializa sua conexão com o Bluemix. - -### Antes de começar - -1. Faça download das versões mais recentes do Android Studio SDK e Xcode. -1. Configure o emulador. Para Android Studio, use um emulador que suporte a API do Google. -1. Instale a ferramenta de linha de comandos Git. Para Windows, certifique-se de -selecionar a opção **Executar Git no prompt de comandos do Windows**. Para obter informações sobre como fazer download e instalar essa ferramenta, veja o [Git ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://git-scm.com/downloads){: new_window}. -1. Instale o Node.js e a ferramenta Node Package Manager (NPM). A ferramenta de -linha de comandos NPM é empacotada com o Node.js. Para obter informações sobre como fazer download e instalar o Node.js, veja [Node.js ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://nodejs.org/en/download/){: new_window}. -1. Na linha de comandos, instale as ferramentas de linha de comandos Cordova -usando o comando **npm install -g cordova**. Isso é necessário para usar o plug-in de push Cordova. Para obter informações sobre como instalar o Cordova e configurar seu app Cordova, veja [Cordova Apache ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://cordova.apache.org/#getstarted){: new_window}. Para obter mais informações, veja o [Arquivo leia-me ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} do plug-in push Cordova. -1. Mude para a pasta na qual deseja criar seu app Cordova e -execute o comando a seguir para criar um aplicativo Cordova. Se -você tiver um app Cordova existente, vá para a etapa 3. -```cordova create your_app_name - cd your_app_name -``` - {: codeblock} -- Opcional: é possível editar o arquivo **config.xml** e mudar o nome do aplicativo no elemento para um nome de sua escolha, em -vez do nome HelloCordova padrão. - -Assegure-se de especificar o ID de pacote configurável correto. As mensagens de erro a seguir poderão resultar em Xcode, se um ID de pacote configurável -incorreto for especificado. - -* O executável foi assinado com autorizações inválidas. -* As autorizações especificadas no arquivo de autorizações de assinatura de código do aplicativo não correspondem às especificadas no seu perfil de fornecimento. Para corrigir esse problema, especifique o ID do pacote configurável correto no -Xcode ou no arquivo **config.xml** do seu app Cordova. - -1. Inclua a API mínima suportada ou a declaração de destino de -implementação no arquivo config.xml do seu aplicativo Cordova. O valor minSdkVersion deve -ser maior que 15. O valor targetSdkVersion deve sempre refletir o SDK mais recente do -Android que esta disponível no Google. - - * Android - com seu editor, abra o arquivo **config.xml** e atualize o -elemento `` com as versões de SDK mínima e de destino: - - ``` - - - - - - ``` - {: codeblock} - - * iOS - atualize o elemento com uma declaração de destino de implementação: - - ``` - - - - - ``` - {: codeblock} - -1. Na interface da linha de comandos (CLI) do Cordova, inclua suas plataformas: iOS, Android, ou ambas, usando o comando: -``` -cordova platform add ios - cordova platform add android -``` - {: codeblock} - -1. No diretório-raiz do aplicativo Cordova, insira o comando a seguir para instalar o plug-in de push do Cordova: **cordova plugin add bms-push**. Dependendo das plataformas que você incluiu, será possível ver: -``` -Installing "bms-push" for android -Installing "bms-push" for ios -``` - {: codeblock} - -1. Em your-app-root-folder, verifique se os plug-ins de núcleo e de push do Cordova foram instalados com sucesso usando o comando a seguir: **cordova plugin list**. Dependendo das plataformas que você incluiu, será possível ver: -``` -bms-core "BMSCore" -bms-push "BMSPush" -``` - {: codeblock} - -1. Configure o ambiente de desenvolvimento iOS. -2. Compile e execute seu aplicativo com Xcode. -1. Faça download do `google-services.json` do Firebase para android e coloque-o na pasta raiz do projeto Cordova, em `[your-app-name]/platforms/android. - 1. Acesse `[your-app-name]/platforms/android`. - 2. Abra o arquivo `build.gradle` (caminho: plataforma > android > build.gradle). - 3. Localize o texto `buildscript` no arquivo `build.gradle`. - 4. Após a linha de caminho de classe, inclua a linha classpath 'com.google.gms:google-services:3.0.0' - 5. Em seguida, localize "dependencies". Selecione as dependências que tenham o texto `compile` e onde essas dependências terminam, logo após isso, inclua esta linha :apply plugin: 'com.google.gms.google-services'. - 6. Prepare e construa o projeto Cordova Android. - ``` - cordova prepare android - cordova build android - ``` - {: codeblock} - **Nota**: antes de abrir o projeto no Android Studio, construa seu aplicativo Cordova por meio da CLI do Cordova. Isso ajudará a evitar erros de construção. - -## Inicializando o plug-in Cordova -{: #cordova_initialize} - -Antes de poder usar o plug-in do Cordova do serviço {{site.data.keyword.mobilepushshort}}, é necessário inicializá-lo passando a rota do aplicativo e o GUID do aplicativo. Depois de inicializar o plug-in, é possível conectar-se ao app de -servidor criado no painel do Bluemix. O plug-in Cordova é o wrapper dos SDKs de cliente -Android e iOS para permitir que um app Cordova se comunique com serviços Bluemix. - -1. Inicialize o BMSClient copiando e colando o fragmento de código a seguir no -arquivo JavaScript principal (em geral, localizado no diretório **www/js**). - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("YOUR APP REGION"); - var category = {}; - BMSPush.initialize(appGUID,clientSecret,category); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); - } -``` - {: codeblock} - -Transmita a região para seu aplicativo. As constantes a seguir são fornecidas: - -``` -REGION_US_SOUTH // ".ng.bluemix.net"; -REGION_UK //".eu-gb.bluemix.net"; -REGION_SYDNEY // ".au-syd.bluemix.net"; -``` - -Por exemplo: - -``` -BMSClient.initialize(BMSClient.REGION_US_SOUTH); -``` - -**Observação**: se você tiver criado um aplicativo Cordova usando a CLI do Cordova, por exemplo, o comando create app-name do Cordova, coloque este código Javascript no arquivo index.js, após a função app.receivedEvent na função onDeviceReady: function() para inicializar o `BMSClient`. - - -## Registrando Dispositivos -{: #cordova_register} - - -Para registrar um dispositivo com o serviço {{site.data.keyword.mobilepushshort}}, chame o método de registro. Copie o fragmento de código a seguir em seu aplicativo Cordova para registrar um dispositivo. - -``` -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); -``` - {: codeblock} - -O fragmento de código JavaScript a seguir mostra como inicializar o Bluemix Mobile Services client SDK, registrar um dispositivo com o serviço {{site.data.keyword.mobilepushshort}} e atender a notificações push. Inclua esse código no arquivo Javascript. - -Dentro de **onDeviceReady: function()**. - -``` -onDeviceReady: function() { -app.receivedEvent('deviceready'); -BMSClient.initialize("YOUR APP REGION"); -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; -BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -Inclua o seguinte fragmento de código Swift em sua classe de -delegação de aplicativo. - -``` -// Register the device token with Bluemix Push Notification Service -func application(application: UIApplication, - didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { - CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) -} -// Handle error when failed to register device token with APNs -func application(application: UIApplication, - didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) -} -``` - {: codeblock} - -##Etapas Seguintes - -{: #cordova_register_next} - -Compile seu projeto e, em seguida, execute-o usando os comandos a seguir: - -####Android -{: android-next-steps} - -``` -cordova build android -``` - {: codeblock} - -``` -cordova run android -``` - {: codeblock} - -####iOS -{: ios-next-steps} - -``` -cordova build ios -``` - {: codeblock} - -``` -cordova run ios -``` - {: codeblock} - -## Recebendo notificações push em dispositivos -{: #cordova_receive} - -Copie o fragmento de código a seguir para receber notificações push em dispositivos. - -###JavaScript - -Inclua o seguinte fragmento de código JavaScript -na web part do seu aplicativo Cordova. -``` -var showNotification = function(notif) { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -###Propriedades de notificação do Android - -A seção a seguir lista as propriedades de notificação de Android: - -* **message** - mensagem de notificação push -* **payload** - objeto JSON contendo uma carga útil de notificação - - -###Propriedades de notificação do iOS - -A seguinte seção lista as propriedades de notificação iOS: - -* **message** - mensagem de notificação push -* **payload** - objeto JSON que contém uma carga útil de notificação action-loc-key - a sequência é usada como chave para obter uma sequência localizada no local atual, a ser usada para o título de botão apropriado, em vez de `Visualizar`. -* **badge** - o número a ser exibido como o badge do ícone de app. Se essa propriedade -estiver ausente, o badge não será mudado. Para remover o badge, -configure o valor dessa propriedade para 0. -* **sound** - o nome de um arquivo de som no pacote configurável de app ou na -pasta Biblioteca/Sons do contêiner de dados de app. - - -Inclua os fragmentos de código Swift a seguir em sua classe de delegação de -aplicativo. -``` -// Handle receiving a remote notification -func application(application: UIApplication, - didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) -} -``` - {: codeblock} - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary - if remoteNotif != nil { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) - } -} -``` - {: codeblock} - -## Enviando notificações push básicas -{: #push-send-notifications} - -Depois de ter desenvolvido seus aplicativos, será possível enviar notificações push básicas. - -Para enviar notificações push básicas, conclua as etapas: - -1. Selecione **Enviar notificações** e componha uma mensagem -escolhendo uma opção **Enviar para**. As opções suportadas são -**Dispositivo por tag**, **ID do dispositivo**, -**ID do usuário**, **Dispositivos Android**, -**Dispositivos iOS**, **Notificações da web** e -**Todos os dispositivos**. -**Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para {{site.data.keyword.mobilepushshort}} receberão notificações. -![Tela de notificações](images/tag_notification.jpg) - -2. No campo **Mensagem**, componha sua mensagem. Escolha a -configurar das definições opcionais conforme necessário. -3. Clique em **Enviar**. -3. Verifique se seus dispositivos receberam sua notificação. - -A captura de tela a seguir mostra uma caixa de alerta que manipula um {{site.data.keyword.mobilepushshort}} no primeiro plano em dispositivos Android e iOS. - -![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) - -![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) - - A imagem a seguir mostra {{site.data.keyword.mobilepushshort}} no segundo plano para Android. -![Notificação push no plano de fundo no Android](images/background.jpg) - -## Etapas Seguintes -{: #next_steps_tags} - -Depois de configurar com êxito notificações básicas, -é possível configurar notificações baseadas em tag e opções -avançadas. - -Inclua os recursos de serviço do {{site.data.keyword.mobilepushshort}} no seu app. Para usar -notificações baseadas em tag, consulte [Notificações baseadas em -tag](c_tag_basednotifications.html). -Para usar opções de notificações avançadas, veja [Ativando notificações push avançadas](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ativando aplicativos Cordova para receber +notificações push +{: #cordova_enable} +Última atualização: 18 de janeiro de 2017 +{: .last-updated} + +Cordova é uma plataforma para criar aplicativos híbridos +com JavaScript, CSS e HTML. O serviço {{site.data.keyword.mobilepushshort}} suporta o desenvolvimento +de aplicativos iOS e Android baseados em Cordova. + +É possível ativar aplicativos Cordova para receber notificações push para os seus dispositivos. + +## Instalando o plug-in do push Cordova +{: #cordova_install} + +Instale e use o plug-in de push do cliente para desenvolver ainda mais seus aplicativos Cordova. Isso também instala o plug-in núcleo do Cordova, que inicializa sua conexão com o Bluemix. + +### Antes de começar + +1. Faça download das versões mais recentes do Android Studio SDK e Xcode. +1. Configure o emulador. Para Android Studio, use um emulador que suporte a API do Google. +1. Instale a ferramenta de linha de comandos Git. Para Windows, certifique-se de +selecionar a opção **Executar Git no prompt de comandos do Windows**. Para obter informações sobre como fazer download e instalar essa ferramenta, veja o [Git ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://git-scm.com/downloads){: new_window}. +1. Instale o Node.js e a ferramenta Node Package Manager (NPM). A ferramenta de +linha de comandos NPM é empacotada com o Node.js. Para obter informações sobre como fazer download e instalar o Node.js, veja [Node.js ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://nodejs.org/en/download/){: new_window}. +1. Na linha de comandos, instale as ferramentas de linha de comandos Cordova +usando o comando **npm install -g cordova**. Isso é necessário para usar o plug-in de push Cordova. Para obter informações sobre como instalar o Cordova e configurar seu app Cordova, veja [Cordova Apache ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://cordova.apache.org/#getstarted){: new_window}. Para obter mais informações, veja o [Arquivo leia-me ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} do plug-in push Cordova. +1. Mude para a pasta na qual deseja criar seu app Cordova e +execute o comando a seguir para criar um aplicativo Cordova. Se +você tiver um app Cordova existente, vá para a etapa 3. +```cordova create your_app_name + cd your_app_name +``` + {: codeblock} +- Opcional: é possível editar o arquivo **config.xml** e mudar o nome do aplicativo no elemento para um nome de sua escolha, em +vez do nome HelloCordova padrão. + +Assegure-se de especificar o ID de pacote configurável correto. As mensagens de erro a seguir poderão resultar em Xcode, se um ID de pacote configurável +incorreto for especificado. + +* O executável foi assinado com autorizações inválidas. +* As autorizações especificadas no arquivo de autorizações de assinatura de código do aplicativo não correspondem às especificadas no seu perfil de fornecimento. Para corrigir esse problema, especifique o ID do pacote configurável correto no +Xcode ou no arquivo **config.xml** do seu app Cordova. + +1. Inclua a API mínima suportada ou a declaração de destino de +implementação no arquivo config.xml do seu aplicativo Cordova. O valor minSdkVersion deve +ser maior que 15. O valor targetSdkVersion deve sempre refletir o SDK mais recente do +Android que esta disponível no Google. + + * Android - com seu editor, abra o arquivo **config.xml** e atualize o +elemento `` com as versões de SDK mínima e de destino: + + ``` + + + + + + ``` + {: codeblock} + + * iOS - atualize o elemento com uma declaração de destino de implementação: + + ``` + + + + + ``` + {: codeblock} + +1. Na interface da linha de comandos (CLI) do Cordova, inclua suas plataformas: iOS, Android, ou ambas, usando o comando: +``` +cordova platform add ios + cordova platform add android +``` + {: codeblock} + +1. No diretório-raiz do aplicativo Cordova, insira o comando a seguir para instalar o plug-in de push do Cordova: **cordova plugin add bms-push**. Dependendo das plataformas que você incluiu, será possível ver: +``` +Installing "bms-push" for android +Installing "bms-push" for ios +``` + {: codeblock} + +1. Em your-app-root-folder, verifique se os plug-ins de núcleo e de push do Cordova foram instalados com sucesso usando o comando a seguir: **cordova plugin list**. Dependendo das plataformas que você incluiu, será possível ver: +``` +bms-core "BMSCore" +bms-push "BMSPush" +``` + {: codeblock} + +1. Configure o ambiente de desenvolvimento iOS. +2. Compile e execute seu aplicativo com Xcode. +1. Faça download do `google-services.json` do Firebase para android e coloque-o na pasta raiz do projeto Cordova, em `[your-app-name]/platforms/android. + 1. Acesse `[your-app-name]/platforms/android`. + 2. Abra o arquivo `build.gradle` (caminho: plataforma > android > build.gradle). + 3. Localize o texto `buildscript` no arquivo `build.gradle`. + 4. Após a linha de caminho de classe, inclua a linha classpath 'com.google.gms:google-services:3.0.0' + 5. Em seguida, localize "dependencies". Selecione as dependências que tenham o texto `compile` e onde essas dependências terminam, logo após isso, inclua esta linha :apply plugin: 'com.google.gms.google-services'. + 6. Prepare e construa o projeto Cordova Android. + ``` + cordova prepare android + cordova build android + ``` + {: codeblock} + **Nota**: antes de abrir o projeto no Android Studio, construa seu aplicativo Cordova por meio da CLI do Cordova. Isso ajudará a evitar erros de construção. + +## Inicializando o plug-in Cordova +{: #cordova_initialize} + +Antes de poder usar o plug-in do Cordova do serviço {{site.data.keyword.mobilepushshort}}, é necessário inicializá-lo passando a rota do aplicativo e o GUID do aplicativo. Depois de inicializar o plug-in, é possível conectar-se ao app de +servidor criado no painel do Bluemix. O plug-in Cordova é o wrapper dos SDKs de cliente +Android e iOS para permitir que um app Cordova se comunique com serviços Bluemix. + +1. Inicialize o BMSClient copiando e colando o fragmento de código a seguir no +arquivo JavaScript principal (em geral, localizado no diretório **www/js**). + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("YOUR APP REGION"); + var category = {}; + BMSPush.initialize(appGUID,clientSecret,category); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); + } +``` + {: codeblock} + +Transmita a região para seu aplicativo. As constantes a seguir são fornecidas: + +``` +REGION_US_SOUTH // ".ng.bluemix.net"; +REGION_UK //".eu-gb.bluemix.net"; +REGION_SYDNEY // ".au-syd.bluemix.net"; +``` + +Por exemplo: + +``` +BMSClient.initialize(BMSClient.REGION_US_SOUTH); +``` + +**Observação**: se você tiver criado um aplicativo Cordova usando a CLI do Cordova, por exemplo, o comando create app-name do Cordova, coloque este código Javascript no arquivo index.js, após a função app.receivedEvent na função onDeviceReady: function() para inicializar o `BMSClient`. + + +## Registrando Dispositivos +{: #cordova_register} + + +Para registrar um dispositivo com o serviço {{site.data.keyword.mobilepushshort}}, chame o método de registro. Copie o fragmento de código a seguir em seu aplicativo Cordova para registrar um dispositivo. + +``` +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); +``` + {: codeblock} + +O fragmento de código JavaScript a seguir mostra como inicializar o Bluemix Mobile Services client SDK, registrar um dispositivo com o serviço {{site.data.keyword.mobilepushshort}} e atender a notificações push. Inclua esse código no arquivo Javascript. + +Dentro de **onDeviceReady: function()**. + +``` +onDeviceReady: function() { +app.receivedEvent('deviceready'); +BMSClient.initialize("YOUR APP REGION"); +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; +BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +Inclua o seguinte fragmento de código Swift em sua classe de +delegação de aplicativo. + +``` +// Register the device token with Bluemix Push Notification Service +func application(application: UIApplication, + didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { + CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) +} +// Handle error when failed to register device token with APNs +func application(application: UIApplication, + didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) +} +``` + {: codeblock} + +##Etapas Seguintes + +{: #cordova_register_next} + +Compile seu projeto e, em seguida, execute-o usando os comandos a seguir: + +####Android +{: android-next-steps} + +``` +cordova build android +``` + {: codeblock} + +``` +cordova run android +``` + {: codeblock} + +####iOS +{: ios-next-steps} + +``` +cordova build ios +``` + {: codeblock} + +``` +cordova run ios +``` + {: codeblock} + +## Recebendo notificações push em dispositivos +{: #cordova_receive} + +Copie o fragmento de código a seguir para receber notificações push em dispositivos. + +###JavaScript + +Inclua o seguinte fragmento de código JavaScript +na web part do seu aplicativo Cordova. +``` +var showNotification = function(notif) { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +###Propriedades de notificação do Android + +A seção a seguir lista as propriedades de notificação de Android: + +* **message** - mensagem de notificação push +* **payload** - objeto JSON contendo uma carga útil de notificação + + +###Propriedades de notificação do iOS + +A seguinte seção lista as propriedades de notificação iOS: + +* **message** - mensagem de notificação push +* **payload** - objeto JSON que contém uma carga útil de notificação action-loc-key - a sequência é usada como chave para obter uma sequência localizada no local atual, a ser usada para o título de botão apropriado, em vez de `Visualizar`. +* **badge** - o número a ser exibido como o badge do ícone de app. Se essa propriedade +estiver ausente, o badge não será mudado. Para remover o badge, +configure o valor dessa propriedade para 0. +* **sound** - o nome de um arquivo de som no pacote configurável de app ou na +pasta Biblioteca/Sons do contêiner de dados de app. + + +Inclua os fragmentos de código Swift a seguir em sua classe de delegação de +aplicativo. +``` +// Handle receiving a remote notification +func application(application: UIApplication, + didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) +} +``` + {: codeblock} + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary + if remoteNotif != nil { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) + } +} +``` + {: codeblock} + +## Enviando notificações push básicas +{: #push-send-notifications} + +Depois de ter desenvolvido seus aplicativos, será possível enviar notificações push básicas. + +Para enviar notificações push básicas, conclua as etapas: + +1. Selecione **Enviar notificações** e componha uma mensagem +escolhendo uma opção **Enviar para**. As opções suportadas são +**Dispositivo por tag**, **ID do dispositivo**, +**ID do usuário**, **Dispositivos Android**, +**Dispositivos iOS**, **Notificações da web** e +**Todos os dispositivos**. +**Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para {{site.data.keyword.mobilepushshort}} receberão notificações. +![Tela de notificações](images/tag_notification.jpg) + +2. No campo **Mensagem**, componha sua mensagem. Escolha a +configurar das definições opcionais conforme necessário. +3. Clique em **Enviar**. +3. Verifique se seus dispositivos receberam sua notificação. + +A captura de tela a seguir mostra uma caixa de alerta que manipula um {{site.data.keyword.mobilepushshort}} no primeiro plano em dispositivos Android e iOS. + +![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) + +![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) + + A imagem a seguir mostra {{site.data.keyword.mobilepushshort}} no segundo plano para Android. +![Notificação push no plano de fundo no Android](images/background.jpg) + +## Etapas Seguintes +{: #next_steps_tags} + +Depois de configurar com êxito notificações básicas, +é possível configurar notificações baseadas em tag e opções +avançadas. + +Inclua os recursos de serviço do {{site.data.keyword.mobilepushshort}} no seu app. Para usar +notificações baseadas em tag, consulte [Notificações baseadas em +tag](c_tag_basednotifications.html). +Para usar opções de notificações avançadas, veja [Ativando notificações push avançadas](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/pt/BR/c_enable_push.md b/services/mobilepush/nl/pt/BR/c_enable_push.md index 49ebcf1e3..57390990d 100644 --- a/services/mobilepush/nl/pt/BR/c_enable_push.md +++ b/services/mobilepush/nl/pt/BR/c_enable_push.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Ativando notificações para dispositivos móveis -{: #c_enable_push-notifications} -Última atualização: 18 de janeiro de 2017 -{: .last-updated} - -Assegure-se de que você tenha passado por [Configurando credenciais para um provedor de notificação](t__main_push_config_provider.html). - -Esta seção descreve como ativar os seus aplicativos clientes - aplicativos móveis e de navegador da web, bem como os Apps Chrome e Extensões para receber notificações push, como criar -notificações de configuração básica, obter e inicializar o SDK ou o plug-in e como registrar o seu dispositivo ou navegador para receber notificações push. Também é possível -ativar seus aplicativos móveis e de navegador da web para receber notificações push usando -a [API REST](t_restapi.html). - -**Nota**: para registros de dispositivo, navegador, Apps Chrome e Extensões, o serviço {{site.data.keyword.mobilepushshort}} mantém uma referência exclusiva para tokens emitidos de provedores de notificação - -APNs para Apple ou FCM para Google. Os tokens podem ser invalidados pelo provedor de notificação de serviço {{site.data.keyword.mobilepushshort}} por vários motivos. - -Por exemplo, durante a desinstalação de um app no dispositivo. Nesse cenário, quando a entrega de uma notificação for tentada com base na resposta dos provedores de que o dispositivo está invalidado, o serviço {{site.data.keyword.mobilepushshort}} removerá os registros do dispositivo ou do navegador da web. Isso, -por sua vez, restringiria tentativas subsequentes de enviar a notificação a esses dispositivos invalidados. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ativando notificações para dispositivos móveis +{: #c_enable_push-notifications} +Última atualização: 18 de janeiro de 2017 +{: .last-updated} + +Assegure-se de que você tenha passado por [Configurando credenciais para um provedor de notificação](t__main_push_config_provider.html). + +Esta seção descreve como ativar os seus aplicativos clientes - aplicativos móveis e de navegador da web, bem como os Apps Chrome e Extensões para receber notificações push, como criar +notificações de configuração básica, obter e inicializar o SDK ou o plug-in e como registrar o seu dispositivo ou navegador para receber notificações push. Também é possível +ativar seus aplicativos móveis e de navegador da web para receber notificações push usando +a [API REST](t_restapi.html). + +**Nota**: para registros de dispositivo, navegador, Apps Chrome e Extensões, o serviço {{site.data.keyword.mobilepushshort}} mantém uma referência exclusiva para tokens emitidos de provedores de notificação - +APNs para Apple ou FCM para Google. Os tokens podem ser invalidados pelo provedor de notificação de serviço {{site.data.keyword.mobilepushshort}} por vários motivos. + +Por exemplo, durante a desinstalação de um app no dispositivo. Nesse cenário, quando a entrega de uma notificação for tentada com base na resposta dos provedores de que o dispositivo está invalidado, o serviço {{site.data.keyword.mobilepushshort}} removerá os registros do dispositivo ou do navegador da web. Isso, +por sua vez, restringiria tentativas subsequentes de enviar a notificação a esses dispositivos invalidados. diff --git a/services/mobilepush/nl/pt/BR/c_enable_push_webhook.md b/services/mobilepush/nl/pt/BR/c_enable_push_webhook.md index 147fb3f84..844333397 100644 --- a/services/mobilepush/nl/pt/BR/c_enable_push_webhook.md +++ b/services/mobilepush/nl/pt/BR/c_enable_push_webhook.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Ativando webhooks -{: #tag_based_notifications} -Última atualização: 23 de janeiro de 2017 -{: .last-updated} - - -Com o serviço {{site.data.keyword.mobilepushshort}}, é possível optar por receber alertas -sobre informações que foram mudadas. As mudanças nas informações corporativas criam eventos, para os quais é -possível ser notificado registrando-os como eventos webhook. Esses eventos webhook acionam um alerta. - -Webhooks são retornos de chamada definidos pelo usuário que são acionados por um evento, como -registrar-se em um dispositivo ou inscrever-se nas tags. No serviço {{site.data.keyword.mobilepushshort}}, -é possível registrar-se para os eventos webhook a seguir: - -- **onDeviceRegister**: um evento webhook é acionado para dispositivos registrados -para push. -- **onDeviceUpdate**: um evento webhook é acionado quando informações sobre um -dispositivo registrado são atualizadas. -- **onDeviceUnregister**: um evento webhook é acionado quando um -dispositivo tem o registro cancelado. -- **onSubscribe**: um evento webhook é acionado quando um usuário se inscreve em -uma tag. -- **onUnsubscribe**: um evento webhook é acionado quando um usuário remove a -assinatura de uma tag. -- **onNotificationSend**: um evento webhook é acionado para uma notificação que foi -despachada. -- **onNotificationFailure**: um evento webhook é acionado para falhas de notificação. - - -**Nota**: a notificação é despachada em lotes. Um despacho de mensagem pode ter -múltiplos eventos webhooks, que podem incluir falhas e sucesso. -Os eventos webhook têm o mesmo messageID que a mensagem despachada. - -Para obter mais informações sobre webhooks, veja a [API de REST de notificações push da IBM ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ativando webhooks +{: #tag_based_notifications} +Última atualização: 23 de janeiro de 2017 +{: .last-updated} + + +Com o serviço {{site.data.keyword.mobilepushshort}}, é possível optar por receber alertas +sobre informações que foram mudadas. As mudanças nas informações corporativas criam eventos, para os quais é +possível ser notificado registrando-os como eventos webhook. Esses eventos webhook acionam um alerta. + +Webhooks são retornos de chamada definidos pelo usuário que são acionados por um evento, como +registrar-se em um dispositivo ou inscrever-se nas tags. No serviço {{site.data.keyword.mobilepushshort}}, +é possível registrar-se para os eventos webhook a seguir: + +- **onDeviceRegister**: um evento webhook é acionado para dispositivos registrados +para push. +- **onDeviceUpdate**: um evento webhook é acionado quando informações sobre um +dispositivo registrado são atualizadas. +- **onDeviceUnregister**: um evento webhook é acionado quando um +dispositivo tem o registro cancelado. +- **onSubscribe**: um evento webhook é acionado quando um usuário se inscreve em +uma tag. +- **onUnsubscribe**: um evento webhook é acionado quando um usuário remove a +assinatura de uma tag. +- **onNotificationSend**: um evento webhook é acionado para uma notificação que foi +despachada. +- **onNotificationFailure**: um evento webhook é acionado para falhas de notificação. + + +**Nota**: a notificação é despachada em lotes. Um despacho de mensagem pode ter +múltiplos eventos webhooks, que podem incluir falhas e sucesso. +Os eventos webhook têm o mesmo messageID que a mensagem despachada. + +Para obter mais informações sobre webhooks, veja a [API de REST de notificações push da IBM ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}. diff --git a/services/mobilepush/nl/pt/BR/c_ios_enable.md b/services/mobilepush/nl/pt/BR/c_ios_enable.md index 363078248..3178fd24c 100644 --- a/services/mobilepush/nl/pt/BR/c_ios_enable.md +++ b/services/mobilepush/nl/pt/BR/c_ios_enable.md @@ -1,361 +1,361 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#Ativando aplicativos iOS para enviar {{site.data.keyword.mobilepushshort}} -{: #enable-push-ios-notifications} -Última atualização: 14 de fevereiro de 2017 -{: .last-updated} - -É possível ativar aplicativos iOS para enviar {{site.data.keyword.mobilepushshort}} -para os seus dispositivos. - - -##Instalando o CocoaPods -{: #enable-push-ios-notifications-install} - -Para obter um projeto Xcode existente, é possível configurar o SDK do cliente de serviços móveis do Bluemix usando a ferramenta de gerenciamento de dependência CocoaPods. Uma alternativa é instalar o SDK manualmente. - -Para visualizar o arquivo leia-me Push Swift, acesse o [Leia-me ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. - - - -1. Instale o CocoaPods usando o comando a seguir em seu terminal Mac. -```$ sudo gem install cocoapods -``` - {: codeblock} -2. Insira o comando `pod init` no terminal para inicializar o CocoaPods. Assegure-se de executar o comando a partir do diretório no qual seu projeto Xcode está. O comando `pod init` cria um Podfile. -3. No Podfile gerado, inclua as dependências necessárias de SDK. Copie o Podfile a -seguir. - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - pod 'BMSAnalyticsAPI' - end - ``` - {: codeblock} - -3. A partir do terminal, acesse a sua pasta do projeto e instale as dependências com o comando `pod update`. - -O comando instala as suas dependências e cria uma nova área de trabalho do Xcode. -**Nota**: assegure-se de sempre abrir a nova área de trabalho do Xcode, -em vez do arquivo de projeto do Xcode original: -``` - $ open App.xcworkspace -``` - {: codeblock} - -A área de trabalho contém o projeto original e o projeto Pods que contém suas -dependências. Para -modificar a pasta de origem de serviços móveis do Bluemix, é possível localizá-la em seu -projeto Pods, em `Pods/yourImportedSourceFolder`, por exemplo: -`Pods/BMSPush`. - -##Incluindo estruturas usando Carthage -{: #carthage} - -Inclua estruturas em seu projeto usando o [Carthage ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}. Observe que -Carthage em Xcode8 não é suportado. - -1. Inclua as estruturas `BMSPush` em seu Cartfile: -``` - github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" -``` - {: codeblock} -2. Execute o comando `carthage update`. Quando a construção for concluída, arraste `BMSPush.framework`, `BMSCore.framework` e `BMSAnalyticsAPI.framework` até seu projeto Xcode. -3. Siga as instruções no site [Carthage ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} para concluir a integração. - -##Configurando o SDK do iOS -{: ios-sdk} - -Configure o SDK iOS, inclua o código a seguir no arquivo **AppDelegate.swift** -em seu aplicativo. Observe que isso também é registrado com o APNs. -``` - func application(_ application: UIApplication, -didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") - } -``` - {: codeblock} - -##Usando estruturas importadas e pastas de origem -{: using-imported-frameworks} - -Referencie o SDK no código. Assegure-se de que os pré-requisitos a seguir sejam atendidos. - -- iOS 8.0 ou superior -- Xcode 7 - -Grave diretivas `#import` para os cabeçalhos relevantes, por exemplo: -``` -//swift -import BMSCore -import BMSPush -``` - {: codeblock} - -Para o arquivo leia-me Push Swift, veja o [Leia-me ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. - -**Nota**: a atualização de seu projeto Pods usando os comandos `pod install` ou `pod update` do CocoaPods pode substituir as pastas de origem de serviços móveis do Bluemix. Para reter as versões -customizadas dos arquivos originais, assegure-se de que sejam submetidas a backup antes de emitir um destes -comandos. - - -##Configurações de Compilação -{: build-settings} - -Acesse **Xcode > Configurações de compilação > Opções de compilação e -configure Ativar Bitcode** como **Não**. - -**Atenção**: Desde o iOS 9, mudanças no recurso App Transport -Security (ATS) podem afetar a maneira de manipular o processo de autenticação. As postagens do blog a seguir descrevem mais informações sobre as mudanças: [ATS e Bitcode no iOS 9 ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} e [Conecte seu app iOS 9 ao Bluemix hoje ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. - -## Inicializando apps Push SDK para iOS -{: #enable-push-ios-notifications-initialize} - -Um local comum para colocar o código de inicialização é no aplicativo delegado do aplicativo iOS. Clique no link **Opções móveis** no Painel Push para obter a rota e o GUID do aplicativo. - -###Inicializando o SDK principal -{: Initializing-the-core-sdk} - - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance -myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") -``` - {: codeblock} - -### Rota, GUID e região do Bluemix -{: route-guid-bluemix-region} - -####appRoute -{: ios-approute} - -Especifica a rota que é designada ao aplicativo do servidor que você criou no Bluemix. - -####GUID -{: ios-guid} - -Especifica a chave exclusiva que é designada ao aplicativo que você criou no Bluemix. Esse valor faz -distinção entre maiúsculas e minúsculas. - -####bluemixRegionSuffix -{: ios-bluemixRegionSuffix} - -Especifica o local em que o app está hospedado. O parâmetro `bluemixRegion` especifica qual implementação do Bluemix você está usando. É possível configurar esse valor com uma propriedade estática `BMSClient.REGION` e use um dos três valores: - -- BMSClient.Region.usSouth -- BMSClient.Region.unitedKingdom -- BMSClient.Region.sydney - -####AppGUID -{: ios-AppGUID} - -Especifica a chave AppGUID exclusiva que é designada ao serviço {{site.data.keyword.mobilepushshort}} que você criou no Bluemix. - -###Inicializando o SDK de Push do cliente -{: initializing-the-client-Push-SDK} - -``` - //Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -## Registrando aplicativos e dispositivos iOS -{: #enable-push-ios-notifications-register} - - -Um aplicativo deve se registrar com os APNs para receber notificações remotas, após a instalação em um dispositivo. Depois que o token de dispositivo gerado pelo APNs é recebido pelo app, ele deve ser passado de volta ao serviço {{site.data.keyword.mobilepushshort}}. - -Para registrar aplicativos e dispositivos iOS, será necessário: - -1. Criar um aplicativo backend. -2. Passar o token para o {{site.data.keyword.mobilepushshort}}. - - -###Criar um aplicativo backend -{: create-a-backend-app} - -Crie um aplicativo backend no catálogo do Bluemix® da seção Modelos, que ligará automaticamente o -serviço {{site.data.keyword.mobilepushshort}} a esse aplicativo. Se você já tiver criado um app backend, assegure-se de ligar o app ao serviço {{site.data.keyword.mobilepushshort}}. - - -###Passando tokens para {{site.data.keyword.mobilepushshort}} -{: pass-token-push-notifications} - -Depois que o token for recebido do APNs, passe-o para {{site.data.keyword.mobilepushshort}} como parte do método `registerWithDeviceToken`. - -Depois que o token for recebido dos APNs, transmita o token para Notificações push -como parte do método `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` - func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ - let push = BMSPushClient.sharedInstance - push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - } -``` - {: codeblock} - - -## Recebendo notificações push em dispositivos iOS -{: #enable-push-ios-notifications-receiving} - - -Para receber notificações push em dispositivos iOS, inclua o método Swift a seguir -na delegação de seu aplicativo. - -``` - // For Swift -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) - { //UserInfo dictionary will contain data sent from the server } -``` - {: codeblock} - -## Monitorando notificações push em dispositivos iOS -{: ios-monitoring} - -Para monitorar o status atual da notificação, inclua o método Swift a seguir na delegação de seu aplicativo. - -``` - // Send notification status when app is opened by clicking the notifications -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - print("Send message status to the Push server") - } -} -``` - {: codeblock} - -``` - // Send notification status when the app is in background mode. - func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { - let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) - self.showAlert(title: "Recieved Push notifications", message: payLoad) - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - completionHandler(UIBackgroundFetchResult.newData) - } -} -``` - {: codeblock} - - -## Enviando notificações push básicas -{: #send} - -Depois de ter desenvolvido seus aplicativos, será possível enviar notificações push básicas. - -Para enviar notificações push básicas, conclua as etapas: - -1. Selecione **Enviar notificações** e componha uma mensagem -escolhendo uma opção **Enviar para**. As opções suportadas são -**Dispositivo por tag**, **ID do dispositivo**, -**ID do usuário**, **Dispositivos Android**, -**Dispositivos iOS**, **Notificações da web** e -**Todos os dispositivos**. -**Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para {{site.data.keyword.mobilepushshort}} receberão notificações. -![Tela de notificações](images/tag_notification.jpg) - -2. No campo **Mensagem**, componha sua mensagem. Escolha a -configurar das definições opcionais conforme necessário. -3. Clique em **Enviar**. -3. Verifique se seus dispositivos receberam sua notificação. - -A imagem a seguir mostra uma caixa de alerta manipulando um {{site.data.keyword.mobilepushshort}} e um dispositivo iOS. - -![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) - -### Configurações opcionais para enviar notificações -{: #send_ios_otpional_setting} - -É possível customizar ainda mais as configurações do -{{site.data.keyword.mobilepushshort}} para enviar notificações a dispositivos -iOS. As opções de customização opcionais a seguir são suportadas. - -- **Badge**: indica o número que é exibido no badge do aplicativo. O valor padrão é zero (0) e isso não exibiria um badge. -- **Som**: indica que um clique de som seja reproduzido no recebimento de uma notificação. Suporta o padrão ou o nome de um recurso de som empacotado no app. -- **Carga útil adicional**: especifica os valores de carga útil customizados para suas notificações. - -##Ativando notificações interativas - -Agora, é possível enriquecer suas notificações de iOS com mais detalhes, como incluir uma imagem, um mapa -ou um botão de resposta ativando notificações interativas. Isso fornece mais contexto aos clientes, -além da capacidade de executar ação imediata sem sair do contexto atual. - -Para ativar notificações interativas, use o código a seguir: - -``` - // This defines the button action. - let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) -``` - {: codeblock} -``` - // This defines category for the buttons -let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) -``` - {: codeblock} -``` - // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions -let notificationOptions = BMSPushClientOptions(categoryName: [category]) -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) -``` - {: codeblock} - -Para enviar uma notificação interativa, conclua estas etapas: - -1. Na seção Editar, para a lista suspensa Enviar para, selecione **Dispositivos iOS**. -2. Insira a mensagem de notificação que talvez queira enviar. -3. Na seção Configurações opcionais, selecione **Móvel** e clique em -**iOS**. -4. Na lista suspensa Tipo, selecione **Combinado**. -5. No campo Categoria, especifique o tipo de notificação que você definiu em seu app. - -![Notificação interativa para iOS](images/push_ios_notification_interactive.jpg) - -## Etapas Seguintes -{: #next_steps_tags} - -Depois de configurar com êxito notificações básicas, -é possível configurar notificações baseadas em tag e opções -avançadas. - -Inclua esses recursos de serviço de Notificações push no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). -Para usar opções de notificações avançadas, veja [Ativando notificações push avançadas](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ativando aplicativos iOS para enviar {{site.data.keyword.mobilepushshort}} +{: #enable-push-ios-notifications} +Última atualização: 14 de fevereiro de 2017 +{: .last-updated} + +É possível ativar aplicativos iOS para enviar {{site.data.keyword.mobilepushshort}} +para os seus dispositivos. + + +## Instalando o CocoaPods +{: #enable-push-ios-notifications-install} + +Para obter um projeto Xcode existente, é possível configurar o SDK do cliente de serviços móveis do Bluemix usando a ferramenta de gerenciamento de dependência CocoaPods. Uma alternativa é instalar o SDK manualmente. + +Para visualizar o arquivo leia-me Push Swift, acesse o [Leia-me ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. + + + +1. Instale o CocoaPods usando o comando a seguir em seu terminal Mac. +```$ sudo gem install cocoapods +``` + {: codeblock} +2. Insira o comando `pod init` no terminal para inicializar o CocoaPods. Assegure-se de executar o comando a partir do diretório no qual seu projeto Xcode está. O comando `pod init` cria um Podfile. +3. No Podfile gerado, inclua as dependências necessárias de SDK. Copie o Podfile a +seguir. + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + pod 'BMSAnalyticsAPI' + end + ``` + {: codeblock} + +3. A partir do terminal, acesse a sua pasta do projeto e instale as dependências com o comando `pod update`. + +O comando instala as suas dependências e cria uma nova área de trabalho do Xcode. +**Nota**: assegure-se de sempre abrir a nova área de trabalho do Xcode, +em vez do arquivo de projeto do Xcode original: +``` + $ open App.xcworkspace +``` + {: codeblock} + +A área de trabalho contém o projeto original e o projeto Pods que contém suas +dependências. Para +modificar a pasta de origem de serviços móveis do Bluemix, é possível localizá-la em seu +projeto Pods, em `Pods/yourImportedSourceFolder`, por exemplo: +`Pods/BMSPush`. + +## Incluindo estruturas usando Carthage +{: #carthage} + +Inclua estruturas em seu projeto usando o [Carthage ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}. Observe que +Carthage em Xcode8 não é suportado. + +1. Inclua as estruturas `BMSPush` em seu Cartfile: +``` + github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" +``` + {: codeblock} +2. Execute o comando `carthage update`. Quando a construção for concluída, arraste `BMSPush.framework`, `BMSCore.framework` e `BMSAnalyticsAPI.framework` até seu projeto Xcode. +3. Siga as instruções no site [Carthage ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} para concluir a integração. + +## Configurando o SDK do iOS +{: ios-sdk} + +Configure o SDK iOS, inclua o código a seguir no arquivo **AppDelegate.swift** +em seu aplicativo. Observe que isso também é registrado com o APNs. +``` + func application(_ application: UIApplication, +didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") + } +``` + {: codeblock} + +## Usando estruturas importadas e pastas de origem +{: using-imported-frameworks} + +Referencie o SDK no código. Assegure-se de que os pré-requisitos a seguir sejam atendidos. + +- iOS 8.0 ou superior +- Xcode 7 + +Grave diretivas `#import` para os cabeçalhos relevantes, por exemplo: +``` +//swift +import BMSCore +import BMSPush +``` + {: codeblock} + +Para o arquivo leia-me Push Swift, veja o [Leia-me ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}. + +**Nota**: a atualização de seu projeto Pods usando os comandos `pod install` ou `pod update` do CocoaPods pode substituir as pastas de origem de serviços móveis do Bluemix. Para reter as versões +customizadas dos arquivos originais, assegure-se de que sejam submetidas a backup antes de emitir um destes +comandos. + + +## Configurações de Compilação +{: build-settings} + +Acesse **Xcode > Configurações de compilação > Opções de compilação e +configure Ativar Bitcode** como **Não**. + +**Atenção**: Desde o iOS 9, mudanças no recurso App Transport +Security (ATS) podem afetar a maneira de manipular o processo de autenticação. As postagens do blog a seguir descrevem mais informações sobre as mudanças: [ATS e Bitcode no iOS 9 ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} e [Conecte seu app iOS 9 ao Bluemix hoje ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}. + +## Inicializando apps Push SDK para iOS +{: #enable-push-ios-notifications-initialize} + +Um local comum para colocar o código de inicialização é no aplicativo delegado do aplicativo iOS. Clique no link **Opções móveis** no Painel Push para obter a rota e o GUID do aplicativo. + +### Inicializando o SDK principal +{: Initializing-the-core-sdk} + + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance +myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") +``` + {: codeblock} + +### Rota, GUID e região do Bluemix +{: route-guid-bluemix-region} + +#### appRoute +{: ios-approute} + +Especifica a rota que é designada ao aplicativo do servidor que você criou no Bluemix. + +#### GUID +{: ios-guid} + +Especifica a chave exclusiva que é designada ao aplicativo que você criou no Bluemix. Esse valor faz +distinção entre maiúsculas e minúsculas. + +#### bluemixRegionSuffix +{: ios-bluemixRegionSuffix} + +Especifica o local em que o app está hospedado. O parâmetro `bluemixRegion` especifica qual implementação do Bluemix você está usando. É possível configurar esse valor com uma propriedade estática `BMSClient.REGION` e use um dos três valores: + +- BMSClient.Region.usSouth +- BMSClient.Region.unitedKingdom +- BMSClient.Region.sydney + +#### AppGUID +{: ios-AppGUID} + +Especifica a chave AppGUID exclusiva que é designada ao serviço {{site.data.keyword.mobilepushshort}} que você criou no Bluemix. + +### Inicializando o SDK de Push do cliente +{: initializing-the-client-Push-SDK} + +``` + //Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +## Registrando aplicativos e dispositivos iOS +{: #enable-push-ios-notifications-register} + + +Um aplicativo deve se registrar com os APNs para receber notificações remotas, após a instalação em um dispositivo. Depois que o token de dispositivo gerado pelo APNs é recebido pelo app, ele deve ser passado de volta ao serviço {{site.data.keyword.mobilepushshort}}. + +Para registrar aplicativos e dispositivos iOS, será necessário: + +1. Criar um aplicativo backend. +2. Passar o token para o {{site.data.keyword.mobilepushshort}}. + + +### Criar um aplicativo backend +{: create-a-backend-app} + +Crie um aplicativo backend no catálogo do Bluemix® da seção Modelos, que ligará automaticamente o +serviço {{site.data.keyword.mobilepushshort}} a esse aplicativo. Se você já tiver criado um app backend, assegure-se de ligar o app ao serviço {{site.data.keyword.mobilepushshort}}. + + +### Passando tokens para {{site.data.keyword.mobilepushshort}} +{: pass-token-push-notifications} + +Depois que o token for recebido do APNs, passe-o para {{site.data.keyword.mobilepushshort}} como parte do método `registerWithDeviceToken`. + +Depois que o token for recebido dos APNs, transmita o token para Notificações push +como parte do método `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` + func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ + let push = BMSPushClient.sharedInstance + push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + } +``` + {: codeblock} + + +## Recebendo notificações push em dispositivos iOS +{: #enable-push-ios-notifications-receiving} + + +Para receber notificações push em dispositivos iOS, inclua o método Swift a seguir +na delegação de seu aplicativo. + +``` + // For Swift +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) + { //UserInfo dictionary will contain data sent from the server } +``` + {: codeblock} + +## Monitorando notificações push em dispositivos iOS +{: ios-monitoring} + +Para monitorar o status atual da notificação, inclua o método Swift a seguir na delegação de seu aplicativo. + +``` + // Send notification status when app is opened by clicking the notifications +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + print("Send message status to the Push server") + } +} +``` + {: codeblock} + +``` + // Send notification status when the app is in background mode. + func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { + let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) + self.showAlert(title: "Recieved Push notifications", message: payLoad) + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + completionHandler(UIBackgroundFetchResult.newData) + } +} +``` + {: codeblock} + + +## Enviando notificações push básicas +{: #send} + +Depois de ter desenvolvido seus aplicativos, será possível enviar notificações push básicas. + +Para enviar notificações push básicas, conclua as etapas: + +1. Selecione **Enviar notificações** e componha uma mensagem +escolhendo uma opção **Enviar para**. As opções suportadas são +**Dispositivo por tag**, **ID do dispositivo**, +**ID do usuário**, **Dispositivos Android**, +**Dispositivos iOS**, **Notificações da web** e +**Todos os dispositivos**. +**Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para {{site.data.keyword.mobilepushshort}} receberão notificações. +![Tela de notificações](images/tag_notification.jpg) + +2. No campo **Mensagem**, componha sua mensagem. Escolha a +configurar das definições opcionais conforme necessário. +3. Clique em **Enviar**. +3. Verifique se seus dispositivos receberam sua notificação. + +A imagem a seguir mostra uma caixa de alerta manipulando um {{site.data.keyword.mobilepushshort}} e um dispositivo iOS. + +![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) + +### Configurações opcionais para enviar notificações +{: #send_ios_otpional_setting} + +É possível customizar ainda mais as configurações do +{{site.data.keyword.mobilepushshort}} para enviar notificações a dispositivos +iOS. As opções de customização opcionais a seguir são suportadas. + +- **Badge**: indica o número que é exibido no badge do aplicativo. O valor padrão é zero (0) e isso não exibiria um badge. +- **Som**: indica que um clique de som seja reproduzido no recebimento de uma notificação. Suporta o padrão ou o nome de um recurso de som empacotado no app. +- **Carga útil adicional**: especifica os valores de carga útil customizados para suas notificações. + +## Ativando notificações interativas + +Agora, é possível enriquecer suas notificações de iOS com mais detalhes, como incluir uma imagem, um mapa +ou um botão de resposta ativando notificações interativas. Isso fornece mais contexto aos clientes, +além da capacidade de executar ação imediata sem sair do contexto atual. + +Para ativar notificações interativas, use o código a seguir: + +``` + // This defines the button action. + let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) +``` + {: codeblock} +``` + // This defines category for the buttons +let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) +``` + {: codeblock} +``` + // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions +let notificationOptions = BMSPushClientOptions(categoryName: [category]) +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) +``` + {: codeblock} + +Para enviar uma notificação interativa, conclua estas etapas: + +1. Na seção Editar, para a lista suspensa Enviar para, selecione **Dispositivos iOS**. +2. Insira a mensagem de notificação que talvez queira enviar. +3. Na seção Configurações opcionais, selecione **Móvel** e clique em +**iOS**. +4. Na lista suspensa Tipo, selecione **Combinado**. +5. No campo Categoria, especifique o tipo de notificação que você definiu em seu app. + +![Notificação interativa para iOS](images/push_ios_notification_interactive.jpg) + +## Etapas Seguintes +{: #next_steps_tags} + +Depois de configurar com êxito notificações básicas, +é possível configurar notificações baseadas em tag e opções +avançadas. + +Inclua esses recursos de serviço de Notificações push no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). +Para usar opções de notificações avançadas, veja [Ativando notificações push avançadas](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/pt/BR/c_overview_push.md b/services/mobilepush/nl/pt/BR/c_overview_push.md index 0ec2f9a73..b2fda542b 100644 --- a/services/mobilepush/nl/pt/BR/c_overview_push.md +++ b/services/mobilepush/nl/pt/BR/c_overview_push.md @@ -1,183 +1,183 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Sobre {{site.data.keyword.mobilepushshort}} -{: #overview-push} -Última atualização: 18 de janeiro de 2017 -{: .last-updated} - -O IBM {{site.data.keyword.mobilepushshort}} é um serviço que pode ser usado para enviar notificações para dispositivos e plataformas. É possível direcionar notificações para todos os usuários -do aplicativo ou para um conjunto específico de usuários e dispositivos usando tags. É possível administrar dispositivos, tags e assinaturas. - -É possível usar qualquer uma das opções a seguir para criar um serviço de limite ou desvinculado: - -- Criando um aplicativo Bluemix usando o modelo do MobileFirst Services Starter do catálogo. Isso cria um serviço Push Notifications ligado a um aplicativo backend do Bluemix. -- Criando um serviço Push Notifications desvinculado diretamente do catálogo Mobile. É possível ligar posteriormente a um aplicativo ou até mesmo escolher usá-lo desvinculado. -- Usando o [painel Mobile ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}. - -Observe que a guia de monitoramento {{site.data.keyword.mobilepushshort}} não mostra dados de analítica. - -O serviço {{site.data.keyword.mobilepushshort}} agora está ativado para OpenWhisk. Para obter mais informações, consulte [OpenWhisk](/docs/openwhisk/index.html). - - -## Processo do serviço {{site.data.keyword.mobilepushshort}} -{: #overview_push_process} - -Dispositivos móveis, clientes do navegador da web, Apps Google Chrome e Extensões podem assinar e se registrar no serviço -{{site.data.keyword.mobilepushshort}}. Na inicialização, os aplicativos -clientes farão seus próprios registros e assinaturas no serviço -{{site.data.keyword.mobilepushshort}}. As notificações são despachadas para o servidor Apple Push Notification Service (APNs) ou Firebase Cloud Messaging -(FCM)/Google Cloud Messaging (GCM) e, em seguida, enviadas para os dispositivos móveis ou clientes do navegador registrados. - -![Visão geral de push](images/overview.jpg) - - -###Aplicativos móveis e do navegador -{: mobile-applications} - -Na inicialização, os aplicativos clientes se registram e assinam o serviço {{site.data.keyword.mobilepushshort}} para receber notificações. - -###Aplicativos backend -{: backend-applications} - -Os aplicativos backend podem ser locais ou estarem em uma nuvem pública. Os -aplicativos backend usarão o serviço -{{site.data.keyword.mobilepushshort}} para enviar notificações sensíveis ao -contexto para usuários de aplicativos móveis e do navegador. Os aplicativos backend não -são obrigados a manter e gerenciar dispositivos móveis, agentes do navegador e -informações sobre o usuário para enviar notificações push. Em vez disso, os aplicativos -podem usar o serviço {{site.data.keyword.mobilepushshort}} que os gerenciará -e os manterá. - -###Proprietário backend do app -{: app-backend-owner} - -O proprietário backend do App cria o aplicativo backend móvel que empacota uma instância do serviço {{site.data.keyword.mobilepushshort}}. O -proprietário backend do App também configura e instala o serviço -{{site.data.keyword.mobilepushshort}} para adequar os aplicativos backend usando -o serviço com os aplicativos móveis e do navegador que se destinam a {{site.data.keyword.mobilepushshort}}. - -###Serviço {{site.data.keyword.mobilepushshort}} -{: push-notification-service} - -O serviço {{site.data.keyword.mobilepushshort}} gerencia todas as -informações relacionadas a dispositivos móveis e clientes do navegador da web que são -registrados para notificações. O serviço mantém seus aplicativos transparentes para os -detalhes de tecnologia de envio de notificações a plataformas móveis e de navegador da -web heterogêneas, manipulando todos esses dentro. - -###Gateways -{: gateways} - -Serviços de nuvem de Notificações push específicos da plataforma, como FCM/GCM ou Apple Push Notification Service (APNs), que são usados pelo serviço IBM -{{site.data.keyword.mobilepushshort}} para despachar notificações aos aplicativos móveis e do navegador. - -###Segurança de Push -{: push-security} - -As APIs de {{site.data.keyword.mobilepushshort}} são protegidas por dois tipos de segredos: - -- **appSecret**: O 'appSecret' protege as APIs que são normalmente chamadas por aplicativos backend - como a API para enviar o {{site.data.keyword.mobilepushshort}} e a API para configurar definições. -- **clientSecret**: O 'clientSecret' protege as APIs que são normalmente chamadas por aplicativos cliente móveis. Existe -somente uma API relacionada para registro de um dispositivo com um ID do usuário associado que requer este 'clientSecret'. Nenhuma das outras APIs chamadas a partir -de clientes móveis requer o clientSecret. - -O 'appSecret' e o 'clientSecret' são alocados para todas as instâncias de serviço no momento da ligação de um aplicativo ao serviço {{site.data.keyword.mobilepushshort}}. Consulte a documentação das [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/) para obter informações sobre como os segredos devem ser passados e para quais APIs. - -**Nota**: os aplicativos anteriores eram necessários para passar o clientSecret somente ao registrar ou atualizar dispositivos com o campo userId. Todas -as outras APIs chamadas por clientes móveis e do navegador não requerem o clientSecret. Esses aplicativos antigos podem continuar a usar o clientSecret opcionalmente -para registros de dispositivo ou chamadas de atualização. Entretanto, é -expressamente recomendado que a verificação do clientSecret seja imposta para todas as -chamadas de API do cliente. Para impingir isso em aplicativos existentes, há uma nova API 'verifyClientSecret' que está publicada. Para novos aplicativos, a verificação do clientSecret será impingida em todas as chamadas de API do cliente e esse comportamento não poderá ser mudado mesmo com a API -'verfiyClientSecret'. - -Por padrão, a verificação do segredo do cliente é impingida apenas em novos apps. Os apps existentes e novos têm permissão para ativar ou desativar a verificação do segredo do cliente -usando a API de REST verifyClientSecret. Recomenda-se que você impinja a verificação do segredo do cliente para evitar -expor dispositivos para usuários que possam conhecer o ID do aplicativo e o ID do dispositivo. - -Assegure-se de que 'clientSecret' seja mantido confidencial e que nunca seja codificado permanentemente -no app móvel. Há vários padrões de inicialização de aplicativo que podem ser usados para puxar o -'clientSecret' dinamicamente durante o tempo de execução dos aplicativos. O diagrama de sequência é descrito nesse -possível padrão. -![Enable_Push](images/init_client_secret.jpg) - -## Tipos de {{site.data.keyword.mobilepushshort}} -{: #overview-push-types} - -###Difusão -{: broadcast} - -Quando um aplicativo cliente se registra no serviço {{site.data.keyword.mobilepushshort}}, ele pode começar a receber transmissões. Notificações de -transmissão são mensagens destinadas a todas as instâncias de um aplicativo instalado em dispositivos móveis, navegadores ou implementadas como apps Chrome ou -instâncias de extensão e configuradas para o serviço {{site.data.keyword.mobilepushshort}}. As notificações de transmissão são ativadas por padrão para qualquer aplicativo ativado para {{site.data.keyword.mobilepushshort}}. Aplicativos ativados para o serviço {{site.data.keyword.mobilepushshort}} possuem uma assinatura predefinida para a tag Push.ALL, que é usada pelo servidor para transmitir mensagens de notificação para todos os dispositivos. Para enviar uma -notificação de transmissão usando a API Push REST, assegure-se de que -o "destino" seja um JSON vazio ao postar no recurso de mensagens. - -###Notificações baseadas em tag -{: tag-based-notifications} - -Notificações de tag são mensagens destinadas a todos os dispositivos inscritos em uma tag específica. As notificações baseadas em identificação -permitem a segmentação de notificações com base em áreas ou tópicos de assunto. Os destinatários da notificação podem optar por receber notificações somente se for -sobre um assunto ou um tópico de interesse. Portanto, a notificação baseada em -identificação fornece um meio de segmentar destinatários. Esse recurso ativa -a capacidade de definir identificações e, em seguida, de enviar e receber mensagens por identificações. Uma mensagem é destinada somente para instâncias do aplicativo -cliente (no dispositivo móvel, navegador ou como um app ou extensões) que estão inscritas para a identificação. Deve-se primeiramente criar tags para o aplicativo, configurar as assinaturas da tag e, em seguida, iniciar as notificações baseadas em tag. Para enviar uma notificação baseada em tag que usa a API REST, assegure-se de que os "tagNames" sejam fornecidos ao postar no recurso de mensagem. - -###Notificações unicast -{: unicast-notifications} - -Notificações unicast são mensagens destinadas a um dispositivo ou usuário específico. As notificações unicast destinadas a dispositivos não requerem configuração adicional e são ativadas por padrão quando o aplicativo está ativado para {{site.data.keyword.mobilepushshort}}. - -No entanto, as notificações Unicast destinadas para usuários requerem a associação de um ID do usuário com um dispositivo no momento do registro do dispositivo -móvel, do navegador da web ou de Apps Chrome e Extensões do cliente para {{site.data.keyword.mobilepushshort}}. - -Geralmente, um aplicativo cliente executará, primeiramente, um ciclo de autenticação no qual o usuário do app móvel é autenticado em um serviço como -[Mobile Client Access](docs/services/mobileaccess/index.html). Na -autenticação bem-sucedida, o ID de usuário autenticado então é passado para a API de -registro de dispositivo push. -Para enviar notificações Unicast por meio da API REST, assegure-se de que os deviceIds ou userIds sejam fornecidos ao postar em um recurso de mensagem. - -###Notificações com base em plataforma -{: platform-based-notifications} - -Notificações podem ser -destinada a atingir uma plataforma de dispositivo -específica. Por exemplo, uma notificação pode ser enviada a todos os usuários do Android -ou somente a usuários do Google Chrome. Para enviar uma notificação baseada em -plataforma usando a API REST, assegure-se de que as plataformas -destinadas sejam fornecidas ao postar no recurso de mensagem. Especifique as plataformas como uma matriz. As plataformas -suportadas são como a seguir: -* A (Apple) -* G (Google) -* WEB_CHROME (Google Chrome Browser Web Push) -* WEB_FIREFOX (Mozilla Firefox Browser Web Push) -* WEB_SAFARI (Safari Browser Web Push) -* APPEXT_CHROME (Apps Google Chrome e Extensões) - -## Tamanho da mensagem de {{site.data.keyword.mobilepushshort}} -{: #push-message-size} - -O tamanho da carga útil da mensagem de {{site.data.keyword.mobilepushshort}} depende das restrições estabelecidas pelos Gateways (FCM/GCM, APNs) e -pelas plataformas do cliente. - -### iOS e Safari -{: ios-message-size} - -Para o iOS 8 e posterior, o tamanho máximo permitido é 2 kilobytes. O serviço de Notificação push Apple não envia notificações que excedem -esse limite. - -###Android, navegador Firefox, navegador Chrome e Apps e -extensões Chrome -{: android-message-size} - -Há uma limitação de 4 kilobytes como o tamanho da carga útil de -mensagem máximo permitido. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Sobre {{site.data.keyword.mobilepushshort}} +{: #overview-push} +Última atualização: 18 de janeiro de 2017 +{: .last-updated} + +O IBM {{site.data.keyword.mobilepushshort}} é um serviço que pode ser usado para enviar notificações para dispositivos e plataformas. É possível direcionar notificações para todos os usuários +do aplicativo ou para um conjunto específico de usuários e dispositivos usando tags. É possível administrar dispositivos, tags e assinaturas. + +É possível usar qualquer uma das opções a seguir para criar um serviço de limite ou desvinculado: + +- Criando um aplicativo Bluemix usando o modelo do MobileFirst Services Starter do catálogo. Isso cria um serviço Push Notifications ligado a um aplicativo backend do Bluemix. +- Criando um serviço Push Notifications desvinculado diretamente do catálogo Mobile. É possível ligar posteriormente a um aplicativo ou até mesmo escolher usá-lo desvinculado. +- Usando o [painel Mobile ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}. + +Observe que a guia de monitoramento {{site.data.keyword.mobilepushshort}} não mostra dados de analítica. + +O serviço {{site.data.keyword.mobilepushshort}} agora está ativado para OpenWhisk. Para obter mais informações, consulte [OpenWhisk](/docs/openwhisk/index.html). + + +## Processo do serviço {{site.data.keyword.mobilepushshort}} +{: #overview_push_process} + +Dispositivos móveis, clientes do navegador da web, Apps Google Chrome e Extensões podem assinar e se registrar no serviço +{{site.data.keyword.mobilepushshort}}. Na inicialização, os aplicativos +clientes farão seus próprios registros e assinaturas no serviço +{{site.data.keyword.mobilepushshort}}. As notificações são despachadas para o servidor Apple Push Notification Service (APNs) ou Firebase Cloud Messaging +(FCM)/Google Cloud Messaging (GCM) e, em seguida, enviadas para os dispositivos móveis ou clientes do navegador registrados. + +![Visão geral de push](images/overview.jpg) + + +###Aplicativos móveis e do navegador +{: mobile-applications} + +Na inicialização, os aplicativos clientes se registram e assinam o serviço {{site.data.keyword.mobilepushshort}} para receber notificações. + +###Aplicativos backend +{: backend-applications} + +Os aplicativos backend podem ser locais ou estarem em uma nuvem pública. Os +aplicativos backend usarão o serviço +{{site.data.keyword.mobilepushshort}} para enviar notificações sensíveis ao +contexto para usuários de aplicativos móveis e do navegador. Os aplicativos backend não +são obrigados a manter e gerenciar dispositivos móveis, agentes do navegador e +informações sobre o usuário para enviar notificações push. Em vez disso, os aplicativos +podem usar o serviço {{site.data.keyword.mobilepushshort}} que os gerenciará +e os manterá. + +###Proprietário backend do app +{: app-backend-owner} + +O proprietário backend do App cria o aplicativo backend móvel que empacota uma instância do serviço {{site.data.keyword.mobilepushshort}}. O +proprietário backend do App também configura e instala o serviço +{{site.data.keyword.mobilepushshort}} para adequar os aplicativos backend usando +o serviço com os aplicativos móveis e do navegador que se destinam a {{site.data.keyword.mobilepushshort}}. + +###Serviço {{site.data.keyword.mobilepushshort}} +{: push-notification-service} + +O serviço {{site.data.keyword.mobilepushshort}} gerencia todas as +informações relacionadas a dispositivos móveis e clientes do navegador da web que são +registrados para notificações. O serviço mantém seus aplicativos transparentes para os +detalhes de tecnologia de envio de notificações a plataformas móveis e de navegador da +web heterogêneas, manipulando todos esses dentro. + +###Gateways +{: gateways} + +Serviços de nuvem de Notificações push específicos da plataforma, como FCM/GCM ou Apple Push Notification Service (APNs), que são usados pelo serviço IBM +{{site.data.keyword.mobilepushshort}} para despachar notificações aos aplicativos móveis e do navegador. + +###Segurança de Push +{: push-security} + +As APIs de {{site.data.keyword.mobilepushshort}} são protegidas por dois tipos de segredos: + +- **appSecret**: O 'appSecret' protege as APIs que são normalmente chamadas por aplicativos backend - como a API para enviar o {{site.data.keyword.mobilepushshort}} e a API para configurar definições. +- **clientSecret**: O 'clientSecret' protege as APIs que são normalmente chamadas por aplicativos cliente móveis. Existe +somente uma API relacionada para registro de um dispositivo com um ID do usuário associado que requer este 'clientSecret'. Nenhuma das outras APIs chamadas a partir +de clientes móveis requer o clientSecret. + +O 'appSecret' e o 'clientSecret' são alocados para todas as instâncias de serviço no momento da ligação de um aplicativo ao serviço {{site.data.keyword.mobilepushshort}}. Consulte a documentação das [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/) para obter informações sobre como os segredos devem ser passados e para quais APIs. + +**Nota**: os aplicativos anteriores eram necessários para passar o clientSecret somente ao registrar ou atualizar dispositivos com o campo userId. Todas +as outras APIs chamadas por clientes móveis e do navegador não requerem o clientSecret. Esses aplicativos antigos podem continuar a usar o clientSecret opcionalmente +para registros de dispositivo ou chamadas de atualização. Entretanto, é +expressamente recomendado que a verificação do clientSecret seja imposta para todas as +chamadas de API do cliente. Para impingir isso em aplicativos existentes, há uma nova API 'verifyClientSecret' que está publicada. Para novos aplicativos, a verificação do clientSecret será impingida em todas as chamadas de API do cliente e esse comportamento não poderá ser mudado mesmo com a API +'verfiyClientSecret'. + +Por padrão, a verificação do segredo do cliente é impingida apenas em novos apps. Os apps existentes e novos têm permissão para ativar ou desativar a verificação do segredo do cliente +usando a API de REST verifyClientSecret. Recomenda-se que você impinja a verificação do segredo do cliente para evitar +expor dispositivos para usuários que possam conhecer o ID do aplicativo e o ID do dispositivo. + +Assegure-se de que 'clientSecret' seja mantido confidencial e que nunca seja codificado permanentemente +no app móvel. Há vários padrões de inicialização de aplicativo que podem ser usados para puxar o +'clientSecret' dinamicamente durante o tempo de execução dos aplicativos. O diagrama de sequência é descrito nesse +possível padrão. +![Enable_Push](images/init_client_secret.jpg) + +## Tipos de {{site.data.keyword.mobilepushshort}} +{: #overview-push-types} + +###Difusão +{: broadcast} + +Quando um aplicativo cliente se registra no serviço {{site.data.keyword.mobilepushshort}}, ele pode começar a receber transmissões. Notificações de +transmissão são mensagens destinadas a todas as instâncias de um aplicativo instalado em dispositivos móveis, navegadores ou implementadas como apps Chrome ou +instâncias de extensão e configuradas para o serviço {{site.data.keyword.mobilepushshort}}. As notificações de transmissão são ativadas por padrão para qualquer aplicativo ativado para {{site.data.keyword.mobilepushshort}}. Aplicativos ativados para o serviço {{site.data.keyword.mobilepushshort}} possuem uma assinatura predefinida para a tag Push.ALL, que é usada pelo servidor para transmitir mensagens de notificação para todos os dispositivos. Para enviar uma +notificação de transmissão usando a API Push REST, assegure-se de que +o "destino" seja um JSON vazio ao postar no recurso de mensagens. + +###Notificações baseadas em tag +{: tag-based-notifications} + +Notificações de tag são mensagens destinadas a todos os dispositivos inscritos em uma tag específica. As notificações baseadas em identificação +permitem a segmentação de notificações com base em áreas ou tópicos de assunto. Os destinatários da notificação podem optar por receber notificações somente se for +sobre um assunto ou um tópico de interesse. Portanto, a notificação baseada em +identificação fornece um meio de segmentar destinatários. Esse recurso ativa +a capacidade de definir identificações e, em seguida, de enviar e receber mensagens por identificações. Uma mensagem é destinada somente para instâncias do aplicativo +cliente (no dispositivo móvel, navegador ou como um app ou extensões) que estão inscritas para a identificação. Deve-se primeiramente criar tags para o aplicativo, configurar as assinaturas da tag e, em seguida, iniciar as notificações baseadas em tag. Para enviar uma notificação baseada em tag que usa a API REST, assegure-se de que os "tagNames" sejam fornecidos ao postar no recurso de mensagem. + +###Notificações unicast +{: unicast-notifications} + +Notificações unicast são mensagens destinadas a um dispositivo ou usuário específico. As notificações unicast destinadas a dispositivos não requerem configuração adicional e são ativadas por padrão quando o aplicativo está ativado para {{site.data.keyword.mobilepushshort}}. + +No entanto, as notificações Unicast destinadas para usuários requerem a associação de um ID do usuário com um dispositivo no momento do registro do dispositivo +móvel, do navegador da web ou de Apps Chrome e Extensões do cliente para {{site.data.keyword.mobilepushshort}}. + +Geralmente, um aplicativo cliente executará, primeiramente, um ciclo de autenticação no qual o usuário do app móvel é autenticado em um serviço como +[Mobile Client Access](docs/services/mobileaccess/index.html). Na +autenticação bem-sucedida, o ID de usuário autenticado então é passado para a API de +registro de dispositivo push. +Para enviar notificações Unicast por meio da API REST, assegure-se de que os deviceIds ou userIds sejam fornecidos ao postar em um recurso de mensagem. + +###Notificações com base em plataforma +{: platform-based-notifications} + +Notificações podem ser +destinada a atingir uma plataforma de dispositivo +específica. Por exemplo, uma notificação pode ser enviada a todos os usuários do Android +ou somente a usuários do Google Chrome. Para enviar uma notificação baseada em +plataforma usando a API REST, assegure-se de que as plataformas +destinadas sejam fornecidas ao postar no recurso de mensagem. Especifique as plataformas como uma matriz. As plataformas +suportadas são como a seguir: +* A (Apple) +* G (Google) +* WEB_CHROME (Google Chrome Browser Web Push) +* WEB_FIREFOX (Mozilla Firefox Browser Web Push) +* WEB_SAFARI (Safari Browser Web Push) +* APPEXT_CHROME (Apps Google Chrome e Extensões) + +## Tamanho da mensagem de {{site.data.keyword.mobilepushshort}} +{: #push-message-size} + +O tamanho da carga útil da mensagem de {{site.data.keyword.mobilepushshort}} depende das restrições estabelecidas pelos Gateways (FCM/GCM, APNs) e +pelas plataformas do cliente. + +### iOS e Safari +{: ios-message-size} + +Para o iOS 8 e posterior, o tamanho máximo permitido é 2 kilobytes. O serviço de Notificação push Apple não envia notificações que excedem +esse limite. + +###Android, navegador Firefox, navegador Chrome e Apps e +extensões Chrome +{: android-message-size} + +Há uma limitação de 4 kilobytes como o tamanho da carga útil de +mensagem máximo permitido. diff --git a/services/mobilepush/nl/pt/BR/c_rich_media_notifications.md b/services/mobilepush/nl/pt/BR/c_rich_media_notifications.md index 81148a229..7429f2e54 100644 --- a/services/mobilepush/nl/pt/BR/c_rich_media_notifications.md +++ b/services/mobilepush/nl/pt/BR/c_rich_media_notifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Ativando notificações do rich media -{: #interactive-notifications} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - - -É possível ativar o Rich Media {{site.data.keyword.mobilepushshort}} no iOS 10 e superior. As notificações push podem ser enviadas com Áudio, Vídeo, GIFs e imagens. - -Para configurar o aplicativo para receber rich push no iOS 10, conclua as etapas: - -1. Em Xcode, selecione **Arquivo** > **Novo** > **Destino** > **Extensão de serviço de notificação**. -2. No método `didReceive()` no `UNNotificationServiceExtension`, inclua o código. -``` -BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) -``` - -Para enviar um Rich Media {{site.data.keyword.mobilepushshort}} do painel Push, assegure-se de especificar os campos de mensagem, título, subtítulo e attachmentURL. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ativando notificações do rich media +{: #interactive-notifications} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + + +É possível ativar o Rich Media {{site.data.keyword.mobilepushshort}} no iOS 10 e superior. As notificações push podem ser enviadas com Áudio, Vídeo, GIFs e imagens. + +Para configurar o aplicativo para receber rich push no iOS 10, conclua as etapas: + +1. Em Xcode, selecione **Arquivo** > **Novo** > **Destino** > **Extensão de serviço de notificação**. +2. No método `didReceive()` no `UNNotificationServiceExtension`, inclua o código. +``` +BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) +``` + +Para enviar um Rich Media {{site.data.keyword.mobilepushshort}} do painel Push, assegure-se de especificar os campos de mensagem, título, subtítulo e attachmentURL. diff --git a/services/mobilepush/nl/pt/BR/c_tag_basednotifications.md b/services/mobilepush/nl/pt/BR/c_tag_basednotifications.md index 59dfca5ac..8c2d12f62 100644 --- a/services/mobilepush/nl/pt/BR/c_tag_basednotifications.md +++ b/services/mobilepush/nl/pt/BR/c_tag_basednotifications.md @@ -1,28 +1,28 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Ativando notificações baseadas em tag -{: #tag_based_notifications} -Última atualização: 16 de janeiro de 2017 -{: .last-updated} - -As mensagens de notificação baseada em tag se destinam a todos os dispositivos inscritos em uma tag específica. - -É possível -definir tags e depois enviar e receber mensagens usando - tags. Deve-se -primeiramente criar as identificações para o aplicativo, configurar as assinaturas da identificação -e, em seguida, iniciar as notificações baseadas em identificação. Para enviar uma -notificação baseada em tag usando a -[API -REST](https://mobile.{DomainName}/imfpush/){: new_window}, assegure-se de que os "tagNames" sejam fornecidos ao -postar no recurso de mensagem. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ativando notificações baseadas em tag +{: #tag_based_notifications} +Última atualização: 16 de janeiro de 2017 +{: .last-updated} + +As mensagens de notificação baseada em tag se destinam a todos os dispositivos inscritos em uma tag específica. + +É possível +definir tags e depois enviar e receber mensagens usando + tags. Deve-se +primeiramente criar as identificações para o aplicativo, configurar as assinaturas da identificação +e, em seguida, iniciar as notificações baseadas em identificação. Para enviar uma +notificação baseada em tag usando a +[API +REST](https://mobile.{DomainName}/imfpush/){: new_window}, assegure-se de que os "tagNames" sejam fornecidos ao +postar no recurso de mensagem. diff --git a/services/mobilepush/nl/pt/BR/c_user_basednotifications.md b/services/mobilepush/nl/pt/BR/c_user_basednotifications.md index 03fc7b44f..1dae3ef8c 100644 --- a/services/mobilepush/nl/pt/BR/c_user_basednotifications.md +++ b/services/mobilepush/nl/pt/BR/c_user_basednotifications.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Ativando notificações baseadas no usuário -{: #user_based_notifications} -Última atualização: 16 de janeiro de 2017 -{: .last-updated} - -{{site.data.keyword.mobilepushshort}} baseado no ID do usuário destina-se a usuários do app móvel com mensagens customizadas. Com -notificações baseadas no usuário, é possível escolher notificar indivíduos -específicos com base em suas preferências. - -## Registrar dispositivo com ID do usuário -Para ativar notificações push destinadas por ID do usuário, assegure-se de registrar -o dispositivo com um campo ID do usuário configurado. - -O ID do usuário pode ser qualquer sequência que o aplicativo forneça para o API de registro de dispositivo. Normalmente, um aplicativo móvel primeiro executará um ciclo de autenticação no qual o usuário do app móvel é autenticado junto a um serviço de autenticação, tal como o [{{site.data.keyword.amafull}} ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}. Na autenticação bem-sucedida, o ID de usuário autenticado então é passado para a API de -registro de dispositivo push. - -## Sincronizando o login e o logout do usuário - -É possível optar por enviar notificações somente se o usuário está conectado. - -Por exemplo, considere um dispositivo compartilhado por membros de uma família ou uma equipe no trabalho e há uma necessidade de abordar usuários específicos. Em -um caso de uso desse tipo, haveria uma sequência de login e logout do usuário. Esse -mecanismo de autenticação permite que o aplicativo rastreie a identidade do usuário -presente do aplicativo. Isso assegura que notificações destinadas a um usuário -específico sempre sejam recebidas por esse usuário somente. Após um login bem-sucedido, -chame a API de registro de dispositivo passando o ID do usuário conectado. Da mesma forma, antes do logout, chame a API de remoção de registro do dispositivo. O -sequenciamento dessas APIs de Push com login e logout irá assegurar que as notificações destinadas a um usuário específico sejam enviadas somente para esse usuário. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ativando notificações baseadas no usuário +{: #user_based_notifications} +Última atualização: 16 de janeiro de 2017 +{: .last-updated} + +{{site.data.keyword.mobilepushshort}} baseado no ID do usuário destina-se a usuários do app móvel com mensagens customizadas. Com +notificações baseadas no usuário, é possível escolher notificar indivíduos +específicos com base em suas preferências. + +## Registrar dispositivo com ID do usuário +Para ativar notificações push destinadas por ID do usuário, assegure-se de registrar +o dispositivo com um campo ID do usuário configurado. + +O ID do usuário pode ser qualquer sequência que o aplicativo forneça para o API de registro de dispositivo. Normalmente, um aplicativo móvel primeiro executará um ciclo de autenticação no qual o usuário do app móvel é autenticado junto a um serviço de autenticação, tal como o [{{site.data.keyword.amafull}} ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}. Na autenticação bem-sucedida, o ID de usuário autenticado então é passado para a API de +registro de dispositivo push. + +## Sincronizando o login e o logout do usuário + +É possível optar por enviar notificações somente se o usuário está conectado. + +Por exemplo, considere um dispositivo compartilhado por membros de uma família ou uma equipe no trabalho e há uma necessidade de abordar usuários específicos. Em +um caso de uso desse tipo, haveria uma sequência de login e logout do usuário. Esse +mecanismo de autenticação permite que o aplicativo rastreie a identidade do usuário +presente do aplicativo. Isso assegura que notificações destinadas a um usuário +específico sempre sejam recebidas por esse usuário somente. Após um login bem-sucedido, +chame a API de registro de dispositivo passando o ID do usuário conectado. Da mesma forma, antes do logout, chame a API de remoção de registro do dispositivo. O +sequenciamento dessas APIs de Push com login e logout irá assegurar que as notificações destinadas a um usuário específico sejam enviadas somente para esse usuário. diff --git a/services/mobilepush/nl/pt/BR/c_web_extensions.md b/services/mobilepush/nl/pt/BR/c_web_extensions.md index 7ffbb1494..2763104f1 100644 --- a/services/mobilepush/nl/pt/BR/c_web_extensions.md +++ b/services/mobilepush/nl/pt/BR/c_web_extensions.md @@ -1,110 +1,110 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Ativando os Apps Chrome e Extensões para receber {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -Última atualização: 18 de janeiro de 2017 -{: .last-updated} - -É possível ativar os Apps Chrome e Extensões para receber o {{site.data.keyword.mobilepushshort}}. Assegure-se de que você tenha passado por [Configurando credenciais para um provedor de notificação](t__main_push_config_provider.html) antes de continuar com as etapas. - -## Instalando o SDK do cliente para {{site.data.keyword.mobilepushshort}} -{: #web_install} - -Este tópico descreve como instalar e usar o SDK de Push do JavaScript do cliente para desenvolver ainda mais os seus Apps Chrome e Extensões. - -### Inicialização nos Apps Google Chrome e Extensões - -Para instalar o SDK do Javascript nos Apps Chrome e Extensões, conclua as etapas: - -Faça download do `BMSPushSDK.js` e do `manifest_Chrome_Ext.json` (para extensões Chrome) ou do `manifest_Chrome_App.json` (para apps Chrome) no [SDK Push da web do Bluemix ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. - - - -- Para Apps Chrome, configure o arquivo manifest: - 1. No arquivo `manifest_Chrome_App.json`, forneça o nome, a descrição e os ícones. - 2. Inclua o `BMSPushSDK.js` no `app.background.scripts`. - 3. Mude o `manifest_Chrome_App.json` para `manifest.json`. - -- Para Extensões do Chrome, configure o arquivo manifest: - 1. No arquivo `manifest_Chrome_Ext.json` forneça o nome, a descrição e os ícones. - 2. Inclua o `BMSPushSDK.js` no `background.scripts`. - 3. Mude o `manifest_Chrome_Ext.json` para `manifest.json`. - -No arquivo `background.js` inclua o seguinte para receber notificações push -``` -chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) -chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); -chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); -``` - {: codeblock} - - - -## Inicializando o SDK de Push -{: #web_initialize} - -Inicialize o push SDK com o `app GUID` e `app Region` do serviço Bluemix {{site.data.keyword.mobilepushshort}}. - -Para obter o GUID do app, selecione a opção **Configuração** na área de janela de navegação para seus serviços de push inicializados e clique em **Opções móveis**. Modifique o fragmento de código para usar o parâmetro appGUID do serviço de notificações push do Bluemix. - -O `App Region` especifica o local no qual o serviço {{site.data.keyword.mobilepushshort}} é hospedado. É possível usar um destes três valores: - - - Para Dalas EUA: `.ng.bluemix.net` - - Para Reino Unido: `.eu-gb.bluemix.net` - - Para Sydney: `.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) -``` - {: codeblock} - -## Registrando os Apps Chrome e Extensões -{: #web_register} - -Use a API `register()` para registrar o dispositivo no serviço -{{site.data.keyword.mobilepushshort}}. Para o registro a partir do Google Chrome, inclua a Chave API do Firebase Cloud Messaging (FCM) ou do Google Cloud -Messaging (GCM) e a URL do website no painel de configuração da web de serviço {{site.data.keyword.mobilepushshort}} do Bluemix. Para obter mais informações, consulte [Configurando as credenciais do Google Cloud Messaging](t_push_provider_android.html) na configuração do Chrome. - -Para registro a partir do Mozilla Firefox, inclua a URL do website no painel de configuração da web do serviço Bluemix {{site.data.keyword.mobilepushshort}} na configuração do Firefox. - -Use o fragmento de código a seguir para registrar o serviço Bluemix -{{site.data.keyword.mobilepushshort}}. -``` -var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ativando os Apps Chrome e Extensões para receber {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +Última atualização: 18 de janeiro de 2017 +{: .last-updated} + +É possível ativar os Apps Chrome e Extensões para receber o {{site.data.keyword.mobilepushshort}}. Assegure-se de que você tenha passado por [Configurando credenciais para um provedor de notificação](t__main_push_config_provider.html) antes de continuar com as etapas. + +## Instalando o SDK do cliente para {{site.data.keyword.mobilepushshort}} +{: #web_install} + +Este tópico descreve como instalar e usar o SDK de Push do JavaScript do cliente para desenvolver ainda mais os seus Apps Chrome e Extensões. + +### Inicialização nos Apps Google Chrome e Extensões + +Para instalar o SDK do Javascript nos Apps Chrome e Extensões, conclua as etapas: + +Faça download do `BMSPushSDK.js` e do `manifest_Chrome_Ext.json` (para extensões Chrome) ou do `manifest_Chrome_App.json` (para apps Chrome) no [SDK Push da web do Bluemix ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}. + + + +- Para Apps Chrome, configure o arquivo manifest: + 1. No arquivo `manifest_Chrome_App.json`, forneça o nome, a descrição e os ícones. + 2. Inclua o `BMSPushSDK.js` no `app.background.scripts`. + 3. Mude o `manifest_Chrome_App.json` para `manifest.json`. + +- Para Extensões do Chrome, configure o arquivo manifest: + 1. No arquivo `manifest_Chrome_Ext.json` forneça o nome, a descrição e os ícones. + 2. Inclua o `BMSPushSDK.js` no `background.scripts`. + 3. Mude o `manifest_Chrome_Ext.json` para `manifest.json`. + +No arquivo `background.js` inclua o seguinte para receber notificações push +``` +chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) +chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); +chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); +``` + {: codeblock} + + + +## Inicializando o SDK de Push +{: #web_initialize} + +Inicialize o push SDK com o `app GUID` e `app Region` do serviço Bluemix {{site.data.keyword.mobilepushshort}}. + +Para obter o GUID do app, selecione a opção **Configuração** na área de janela de navegação para seus serviços de push inicializados e clique em **Opções móveis**. Modifique o fragmento de código para usar o parâmetro appGUID do serviço de notificações push do Bluemix. + +O `App Region` especifica o local no qual o serviço {{site.data.keyword.mobilepushshort}} é hospedado. É possível usar um destes três valores: + + - Para Dalas EUA: `.ng.bluemix.net` + - Para Reino Unido: `.eu-gb.bluemix.net` + - Para Sydney: `.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) +``` + {: codeblock} + +## Registrando os Apps Chrome e Extensões +{: #web_register} + +Use a API `register()` para registrar o dispositivo no serviço +{{site.data.keyword.mobilepushshort}}. Para o registro a partir do Google Chrome, inclua a Chave API do Firebase Cloud Messaging (FCM) ou do Google Cloud +Messaging (GCM) e a URL do website no painel de configuração da web de serviço {{site.data.keyword.mobilepushshort}} do Bluemix. Para obter mais informações, consulte [Configurando as credenciais do Google Cloud Messaging](t_push_provider_android.html) na configuração do Chrome. + +Para registro a partir do Mozilla Firefox, inclua a URL do website no painel de configuração da web do serviço Bluemix {{site.data.keyword.mobilepushshort}} na configuração do Firefox. + +Use o fragmento de código a seguir para registrar o serviço Bluemix +{{site.data.keyword.mobilepushshort}}. +``` +var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + diff --git a/services/mobilepush/nl/pt/BR/c_web_extensions_send.md b/services/mobilepush/nl/pt/BR/c_web_extensions_send.md index 2b22f5785..d7cc7ae79 100644 --- a/services/mobilepush/nl/pt/BR/c_web_extensions_send.md +++ b/services/mobilepush/nl/pt/BR/c_web_extensions_send.md @@ -1,45 +1,45 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Enviando notificações básicas para Apps e extensões do -Chrome -{: #web_extensions_notifications} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - -Depois de ter desenvolvido seus aplicativos, é possível enviar uma notificação push. - -1. Selecione **Enviar notificações** e componha uma mensagem escolhendo **Notificações da web** como a opção **Enviar para**. -2. Digite a mensagem que precisa ser entregue no campo **Mensagem**. -3. É possível optar por fornecer configurações opcionais: - - **Título da notificação**: esse é o texto que seria exibido como título de alerta de mensagem. - - **URL do ícone de notificação**: se sua mensagem precisar ser entregue com um ícone de notificação de app, forneça o link para o ícone no campo. - - **Chave de redução**: as chaves de redução são anexadas às notificações. Se diversas notificações chegarem sequencialmente com a mesma chave de redução quando o dispositivo estiver off-line, elas serão reduzidas. Quando -um dispositivo fica on-line, ele recebe notificações a partir do servidor FCM/GCM e exibe somente a notificação mais recente que comporta a mesma chave de redução. Se a chave de redução não estiver configurada, as mensagens novas e antigas serão armazenadas para entrega futura. - - **Tempo de vida**: esse valor é configurado em segundos. Se esse parâmetro não for especificado, o servidor FCM/GCM armazenará a mensagem -por quatro semanas e tentará entregar. A validade expira após quatro semanas. A faixa de valores possíveis vai de 0 a 2.419.200 segundos. - - **Atrasar quando inativo**: configurar esse valor como `true` instruirá o servidor FCM/GCM a não entregar a notificação se o -dispositivo estiver inativo. Configure esse valor como `false` para assegurar a entrega de notificação mesmo que o dispositivo esteja inativo. - - **Carga útil adicional**: especifica os valores de carga útil customizados para suas notificações. - -A imagem a seguir mostra a opção Notificações de apps e -extensões do Chrome no painel. - - ![Tela de notificações](images/push_chrome_extns.jpg) - -## Etapas Seguintes - {: #next_steps_tags} - -Após ter configurado com sucesso as notificações básicas, -será possível configurar notificações baseadas em tag e opções avançadas. - -Inclua esses recursos de serviço do {{site.data.keyword.mobilepushshort}} no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). Para usar opções de notificações avançadas, veja [Notificações avançadas](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Enviando notificações básicas para Apps e extensões do +Chrome +{: #web_extensions_notifications} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + +Depois de ter desenvolvido seus aplicativos, é possível enviar uma notificação push. + +1. Selecione **Enviar notificações** e componha uma mensagem escolhendo **Notificações da web** como a opção **Enviar para**. +2. Digite a mensagem que precisa ser entregue no campo **Mensagem**. +3. É possível optar por fornecer configurações opcionais: + - **Título da notificação**: esse é o texto que seria exibido como título de alerta de mensagem. + - **URL do ícone de notificação**: se sua mensagem precisar ser entregue com um ícone de notificação de app, forneça o link para o ícone no campo. + - **Chave de redução**: as chaves de redução são anexadas às notificações. Se diversas notificações chegarem sequencialmente com a mesma chave de redução quando o dispositivo estiver off-line, elas serão reduzidas. Quando +um dispositivo fica on-line, ele recebe notificações a partir do servidor FCM/GCM e exibe somente a notificação mais recente que comporta a mesma chave de redução. Se a chave de redução não estiver configurada, as mensagens novas e antigas serão armazenadas para entrega futura. + - **Tempo de vida**: esse valor é configurado em segundos. Se esse parâmetro não for especificado, o servidor FCM/GCM armazenará a mensagem +por quatro semanas e tentará entregar. A validade expira após quatro semanas. A faixa de valores possíveis vai de 0 a 2.419.200 segundos. + - **Atrasar quando inativo**: configurar esse valor como `true` instruirá o servidor FCM/GCM a não entregar a notificação se o +dispositivo estiver inativo. Configure esse valor como `false` para assegurar a entrega de notificação mesmo que o dispositivo esteja inativo. + - **Carga útil adicional**: especifica os valores de carga útil customizados para suas notificações. + +A imagem a seguir mostra a opção Notificações de apps e +extensões do Chrome no painel. + + ![Tela de notificações](images/push_chrome_extns.jpg) + +## Etapas Seguintes + {: #next_steps_tags} + +Após ter configurado com sucesso as notificações básicas, +será possível configurar notificações baseadas em tag e opções avançadas. + +Inclua esses recursos de serviço do {{site.data.keyword.mobilepushshort}} no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). Para usar opções de notificações avançadas, veja [Notificações avançadas](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/pt/BR/images/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/pt/BR/images/t_enable_actionable_notifications_ios.md index 567ebdcae..8c98cb1d2 100644 --- a/services/mobilepush/nl/pt/BR/images/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/pt/BR/images/t_enable_actionable_notifications_ios.md @@ -1,106 +1,106 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Ativando notificações acionáveis para iOS -{: #enable-actionable-notifications-ios} - -Ao contrário das notificações push tradicionais, as notificações acionáveis solicitam que os usuários façam uma seleção no recibo do alerta de notificação sem abrir o app. Use as instruções a seguir para ativar as notificações push acionáveis em seu aplicativo. - -1. Crie uma ação de resposta do usuário. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. Crie a categoria de notificação e configure uma ação. **UIUserNotificationActionContextDefault** ou - **UIUserNotificationActionContextMinimal** são contextos válidos. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. Crie a configuração de notificação e designe as categorias da etapa -anterior. - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. Crie a notificação local ou remota e designe a ela a identidade da -categoria. - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Ativando notificações acionáveis para iOS +{: #enable-actionable-notifications-ios} + +Ao contrário das notificações push tradicionais, as notificações acionáveis solicitam que os usuários façam uma seleção no recibo do alerta de notificação sem abrir o app. Use as instruções a seguir para ativar as notificações push acionáveis em seu aplicativo. + +1. Crie uma ação de resposta do usuário. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. Crie a categoria de notificação e configure uma ação. **UIUserNotificationActionContextDefault** ou + **UIUserNotificationActionContextMinimal** são contextos válidos. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. Crie a configuração de notificação e designe as categorias da etapa +anterior. + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. Crie a notificação local ou remota e designe a ela a identidade da +categoria. + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/pt/BR/index.md b/services/mobilepush/nl/pt/BR/index.md index 148b9f57b..ba71d54cd 100644 --- a/services/mobilepush/nl/pt/BR/index.md +++ b/services/mobilepush/nl/pt/BR/index.md @@ -1,54 +1,54 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Introdução ao {{site.data.keyword.mobilepushshort}} -{: #gettingstartedtemplate} -Última atualização: 19 de janeiro de 2017 -{: .last-updated} - -{:shortdesc} - -O {{site.data.keyword.mobilepushshort}} está disponível como um serviço de catálogo do Bluemix na categoria Móvel e permite enviar e gerenciar notificações push móveis e da web. O serviço gerencia o mapeamento dos usuários do aplicativo para seus dispositivos, plataforma de dispositivo e navegadores da web durante a manipulação do despacho de notificações. - - O {{site.data.keyword.mobilepushshort}} está disponível como uma parte do Modelo do MobileFirst Services Starter e como Bluemix [Dedicated Services](/docs/dedicated/index.html). É possível usar o serviço para enviar transmissões, unicasts (com base em deviceID e userID), notificação baseada em tag, notificação baseada em evento de webhooks, bem como notificações Rich Media e notificações interativas para os usuários de aplicativos móveis e de navegador da web. Também é possível usar um SDK (kit de desenvolvimento de software) e [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window} para desenvolver adicionalmente seus aplicativos clientes. - -O serviço também fornece recursos de monitoramento que ajudam a monitorar o desempenho de Notificação push, gerando gráficos e relatórios dos dados do usuário. Veja [Monitoramento para notificações push](/docs/services/mobilepush/t_push_monitoring.html). - -O serviço {{site.data.keyword.mobilepushshort}} é suportado nas plataformas a seguir: - -- [Dispositivos móveis iOS e Android](/docs/services/mobilepush/c_enable_push.html) -- [Navegadores da web Google Chrome, Mozilla Firefox e Safari](/docs/services/mobilepush/c_chrome_firefox_enable.html) -- [Apps Google Chrome e Extensões](/docs/services/mobilepush/c_web_extensions.html) - - -# Links relacionados -{: #rellinks} - -* [Visão geral ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](c_overview_push.html){: new_window} - -## Tutoriais e Amostras {:id="samples"} -{: #samples} -* [Aplicativo de amostra helloPush Android ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} -- [Aplicativo de amostra Cordova ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} -* [Aplicativo de amostra helloPush iOS (Swift) ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} - -## SDK -{: #sdk} -* [SDK Android ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} -* [SDK Cordova ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} -* [SDK iOS (Swift) ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} - -## Referência de API -{: #api} -* [Referência da API Push (Android) ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} -* [Referência da API BMSPush iOS (Swift) ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} -* [Referência da API de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window} +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Introdução ao {{site.data.keyword.mobilepushshort}} +{: #gettingstartedtemplate} +Última atualização: 19 de janeiro de 2017 +{: .last-updated} + +{:shortdesc} + +O {{site.data.keyword.mobilepushshort}} está disponível como um serviço de catálogo do Bluemix na categoria Móvel e permite enviar e gerenciar notificações push móveis e da web. O serviço gerencia o mapeamento dos usuários do aplicativo para seus dispositivos, plataforma de dispositivo e navegadores da web durante a manipulação do despacho de notificações. + + O {{site.data.keyword.mobilepushshort}} está disponível como uma parte do Modelo do MobileFirst Services Starter e como Bluemix [Dedicated Services](/docs/dedicated/index.html). É possível usar o serviço para enviar transmissões, unicasts (com base em deviceID e userID), notificação baseada em tag, notificação baseada em evento de webhooks, bem como notificações Rich Media e notificações interativas para os usuários de aplicativos móveis e de navegador da web. Também é possível usar um SDK (kit de desenvolvimento de software) e [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window} para desenvolver adicionalmente seus aplicativos clientes. + +O serviço também fornece recursos de monitoramento que ajudam a monitorar o desempenho de Notificação push, gerando gráficos e relatórios dos dados do usuário. Veja [Monitoramento para notificações push](/docs/services/mobilepush/t_push_monitoring.html). + +O serviço {{site.data.keyword.mobilepushshort}} é suportado nas plataformas a seguir: + +- [Dispositivos móveis iOS e Android](/docs/services/mobilepush/c_enable_push.html) +- [Navegadores da web Google Chrome, Mozilla Firefox e Safari](/docs/services/mobilepush/c_chrome_firefox_enable.html) +- [Apps Google Chrome e Extensões](/docs/services/mobilepush/c_web_extensions.html) + + +# Links relacionados +{: #rellinks} + +* [Visão geral ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](c_overview_push.html){: new_window} + +## Tutoriais e Amostras {:id="samples"} +{: #samples} +* [Aplicativo de amostra helloPush Android ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} +- [Aplicativo de amostra Cordova ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} +* [Aplicativo de amostra helloPush iOS (Swift) ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} + +## SDK +{: #sdk} +* [SDK Android ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} +* [SDK Cordova ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} +* [SDK iOS (Swift) ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} + +## Referência de API +{: #api} +* [Referência da API Push (Android) ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} +* [Referência da API BMSPush iOS (Swift) ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} +* [Referência da API de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window} diff --git a/services/mobilepush/nl/pt/BR/interactive_notifications.md b/services/mobilepush/nl/pt/BR/interactive_notifications.md index 6cdad10be..3beeafa2f 100644 --- a/services/mobilepush/nl/pt/BR/interactive_notifications.md +++ b/services/mobilepush/nl/pt/BR/interactive_notifications.md @@ -1,83 +1,83 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Notificações interativas -{: #interactive-notifications} -Última atualização: 23 de janeiro de 2017 -{: .last-updated} - -As notificações interativas permitem que os usuários respondam a uma notificação sem abrir o aplicativo. Quando uma notificação interativa chega, o dispositivo mostra os botões de ação junto com a mensagem de notificação. As notificações interativas são suportadas em dispositivos iOS com a versão 8 ou mais recente. Para notificações interativas enviadas para dispositivos iOS que são anteriores à versão 8, as ações de notificação não são exibidas. - -##Enviando {{site.data.keyword.mobilepushshort}} interativo - - -A notificação interativa pode ser enviada usando o painel Push ou usando a [Documentação da API de REST](t_restapi.html). - -No console de {{site.data.keyword.mobilepushshort}}: - -1. Na guia de notificação no painel Push, clique em **Enviar notificação**. -2. Escolha seus destinatários de notificação e clique em **Avançar**. -3. Na página de composição de notificação, o push interativo pode ser enviado configurando o Tipo como Padrão ou Combinado e especificando o valor de Categoria na guia Opções avançadas. Para configurar o valor de categoria no cliente, marque **Manipulando o {{site.data.keyword.mobilepushshort}}** interativo na seção de aplicativo iOS nativo. - -## Manipulando o {{site.data.keyword.mobilepushshort}} interativo em um aplicativo iOS - - -### Swift - -Conclua as etapas para receber notificações interativas: - -1. Ative o recurso do aplicativo para executar tarefas em segundo plano no recebimento de notificações remotas. -1. Inicialize o SDK de `BMSPush` com sua categoria de ação. - ``` - let myBMSClient = BMSClient.sharedInstance - myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) - let push = BMSPushClient.sharedInstance - let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) - let notifOptions = BMSPushClientOptions(categoryName: [category]) - push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) - ``` - {: codeblock} - -1. Implemente o novo método de retorno de chamada em AppDelegate: - ``` - func userNotificationCenter(_ center: UNUserNotificationCenter, - didReceive response: UNNotificationResponse, - withCompletionHandler completionHandler: @escaping () -> Void) { - switch response.actionIdentifier { - case "FIRST": - print("FIRST") - case "SECOND": - print("SECOND") - default: - print("Unknown action") - } - completionHandler - } - ``` - {: codeblock} -5. Este novo método de retorno de chamada é chamado quando o usuário clica no botão de ação. A implementação desse método deve executar tarefas associadas ao identificador especificado e executar o bloco no parâmetro `completionHandler`. - - -### Cordova - -Para obter notificação acionável em um aplicativo Cordova iOS, conclua as etapas: - -1. Inclua o campo de categoria no método `BMSPush.initialize`. - ``` - var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} - BMSPush.initialize(appGUID,clientSecret,category); - ``` - {: codeblock} -2. Implemente o novo método de retorno de chamada em AppDelegate. -3. Este novo método de retorno de chamada é chamado quando o usuário clica no botão de ação. A implementação desse método deve executar tarefas associadas ao identificador especificado e executar o bloco no parâmetro completionHandler. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Notificações interativas +{: #interactive-notifications} +Última atualização: 23 de janeiro de 2017 +{: .last-updated} + +As notificações interativas permitem que os usuários respondam a uma notificação sem abrir o aplicativo. Quando uma notificação interativa chega, o dispositivo mostra os botões de ação junto com a mensagem de notificação. As notificações interativas são suportadas em dispositivos iOS com a versão 8 ou mais recente. Para notificações interativas enviadas para dispositivos iOS que são anteriores à versão 8, as ações de notificação não são exibidas. + +##Enviando {{site.data.keyword.mobilepushshort}} interativo + + +A notificação interativa pode ser enviada usando o painel Push ou usando a [Documentação da API de REST](t_restapi.html). + +No console de {{site.data.keyword.mobilepushshort}}: + +1. Na guia de notificação no painel Push, clique em **Enviar notificação**. +2. Escolha seus destinatários de notificação e clique em **Avançar**. +3. Na página de composição de notificação, o push interativo pode ser enviado configurando o Tipo como Padrão ou Combinado e especificando o valor de Categoria na guia Opções avançadas. Para configurar o valor de categoria no cliente, marque **Manipulando o {{site.data.keyword.mobilepushshort}}** interativo na seção de aplicativo iOS nativo. + +## Manipulando o {{site.data.keyword.mobilepushshort}} interativo em um aplicativo iOS + + +### Swift + +Conclua as etapas para receber notificações interativas: + +1. Ative o recurso do aplicativo para executar tarefas em segundo plano no recebimento de notificações remotas. +1. Inicialize o SDK de `BMSPush` com sua categoria de ação. + ``` + let myBMSClient = BMSClient.sharedInstance + myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) + let push = BMSPushClient.sharedInstance + let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) + let notifOptions = BMSPushClientOptions(categoryName: [category]) + push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) + ``` + {: codeblock} + +1. Implemente o novo método de retorno de chamada em AppDelegate: + ``` + func userNotificationCenter(_ center: UNUserNotificationCenter, + didReceive response: UNNotificationResponse, + withCompletionHandler completionHandler: @escaping () -> Void) { + switch response.actionIdentifier { + case "FIRST": + print("FIRST") + case "SECOND": + print("SECOND") + default: + print("Unknown action") + } + completionHandler + } + ``` + {: codeblock} +5. Este novo método de retorno de chamada é chamado quando o usuário clica no botão de ação. A implementação desse método deve executar tarefas associadas ao identificador especificado e executar o bloco no parâmetro `completionHandler`. + + +### Cordova + +Para obter notificação acionável em um aplicativo Cordova iOS, conclua as etapas: + +1. Inclua o campo de categoria no método `BMSPush.initialize`. + ``` + var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} + BMSPush.initialize(appGUID,clientSecret,category); + ``` + {: codeblock} +2. Implemente o novo método de retorno de chamada em AppDelegate. +3. Este novo método de retorno de chamada é chamado quando o usuário clica no botão de ação. A implementação desse método deve executar tarefas associadas ao identificador especificado e executar o bloco no parâmetro completionHandler. diff --git a/services/mobilepush/nl/pt/BR/next_steps_tags.md b/services/mobilepush/nl/pt/BR/next_steps_tags.md index d947d3230..4ee089b68 100644 --- a/services/mobilepush/nl/pt/BR/next_steps_tags.md +++ b/services/mobilepush/nl/pt/BR/next_steps_tags.md @@ -1,21 +1,21 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Etapas Seguintes -{: #next_steps_tags} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - -Após ter configurado com sucesso as notificações básicas, é possível configurar notificações baseadas em tag e opções avançadas. - -Inclua esses recursos de serviço do {{site.data.keyword.mobilepushshort}} no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). -Para usar opções de notificações avançadas, veja [Notificações push avançadas](t_advance_badge_sound_payload.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Etapas Seguintes +{: #next_steps_tags} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + +Após ter configurado com sucesso as notificações básicas, é possível configurar notificações baseadas em tag e opções avançadas. + +Inclua esses recursos de serviço do {{site.data.keyword.mobilepushshort}} no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). +Para usar opções de notificações avançadas, veja [Notificações push avançadas](t_advance_badge_sound_payload.html). diff --git a/services/mobilepush/nl/pt/BR/silent_notifications.md b/services/mobilepush/nl/pt/BR/silent_notifications.md index b2d7b3fc0..fe5cf8cc1 100644 --- a/services/mobilepush/nl/pt/BR/silent_notifications.md +++ b/services/mobilepush/nl/pt/BR/silent_notifications.md @@ -1,39 +1,39 @@ ------- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Manipulando notificações silenciosas para iOS -{: #silent-notifications} -Última atualização: 16 de janeiro de 2017 -{: .last-updated} - -As notificações silenciosas não aparecem na tela do dispositivo. Essas notificações são recebidas pelo aplicativo no segundo plano, que acorda o aplicativo por até 30 segundos para executar a tarefa em segundo plano especificada. É possível que um usuário não perceba a chegada da notificação. Para enviar notificações silenciosas para o iOS, use a [API de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. - -1. Para enviar notificações push silenciosas, implemente o método a seguir no arquivo `appDelegate.m` em seu projeto. Em Swift, o valor `contentAvailable` enviado pelo servidor para notificações silenciosas é igual a 1. -``` -// For Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - let contentAPS = userInfo["aps"] as [NSObject : AnyObject] - if let contentAvailable = contentAPS["content-available"] as? Int { - //silent or mixed push - if contentAvailable == 1 { - completionHandler(UIBackgroundFetchResult.NewData) - } else { - completionHandler(UIBackgroundFetchResult.NoData) - } - } else { - //Default notification - completionHandler(UIBackgroundFetchResult.NoData) - } - } -``` - {: codeblock} - +------ + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Manipulando notificações silenciosas para iOS +{: #silent-notifications} +Última atualização: 16 de janeiro de 2017 +{: .last-updated} + +As notificações silenciosas não aparecem na tela do dispositivo. Essas notificações são recebidas pelo aplicativo no segundo plano, que acorda o aplicativo por até 30 segundos para executar a tarefa em segundo plano especificada. É possível que um usuário não perceba a chegada da notificação. Para enviar notificações silenciosas para o iOS, use a [API de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. + +1. Para enviar notificações push silenciosas, implemente o método a seguir no arquivo `appDelegate.m` em seu projeto. Em Swift, o valor `contentAvailable` enviado pelo servidor para notificações silenciosas é igual a 1. +``` +// For Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + let contentAPS = userInfo["aps"] as [NSObject : AnyObject] + if let contentAvailable = contentAPS["content-available"] as? Int { + //silent or mixed push + if contentAvailable == 1 { + completionHandler(UIBackgroundFetchResult.NewData) + } else { + completionHandler(UIBackgroundFetchResult.NoData) + } + } else { + //Default notification + completionHandler(UIBackgroundFetchResult.NoData) + } + } +``` + {: codeblock} + diff --git a/services/mobilepush/nl/pt/BR/t__main_push_config_provider.md b/services/mobilepush/nl/pt/BR/t__main_push_config_provider.md index 9b9b27e21..7d262e5b1 100644 --- a/services/mobilepush/nl/pt/BR/t__main_push_config_provider.md +++ b/services/mobilepush/nl/pt/BR/t__main_push_config_provider.md @@ -1,22 +1,22 @@ - ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configurando credenciais para um -provedor de notificação -{: #create-push-credentials} -Última atualização: 18 de janeiro de 2017 -{: .last-updated} - -Para configurar o serviço {{site.data.keyword.mobilepushshort}}, obtenha as credenciais necessárias com seu provedor de notificação push - serviço Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) ou Apple Push Notification ([APNs](t_push_provider_ios.html)) para dispositivos móveis. Para navegadores da web, veja [Configurando credenciais para navegadores da web](t_push_provider_safari.html). - -É possível configurar o {{site.data.keyword.mobilepushshort}} usando o painel do **IBM Bluemix Services** ou usando as [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. + +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configurando credenciais para um +provedor de notificação +{: #create-push-credentials} +Última atualização: 18 de janeiro de 2017 +{: .last-updated} + +Para configurar o serviço {{site.data.keyword.mobilepushshort}}, obtenha as credenciais necessárias com seu provedor de notificação push - serviço Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) ou Apple Push Notification ([APNs](t_push_provider_ios.html)) para dispositivos móveis. Para navegadores da web, veja [Configurando credenciais para navegadores da web](t_push_provider_safari.html). + +É possível configurar o {{site.data.keyword.mobilepushshort}} usando o painel do **IBM Bluemix Services** ou usando as [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. diff --git a/services/mobilepush/nl/pt/BR/t_advance_badge_sound_payload.md b/services/mobilepush/nl/pt/BR/t_advance_badge_sound_payload.md index ccae93580..125bba768 100644 --- a/services/mobilepush/nl/pt/BR/t_advance_badge_sound_payload.md +++ b/services/mobilepush/nl/pt/BR/t_advance_badge_sound_payload.md @@ -1,81 +1,81 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#Ativando o {{site.data.keyword.mobilepushshort}} avançado -Última atualização: 23 de janeiro de 2017 -{: .last-updated} - -Configure um badge iOS, som, carga útil JSON adicional, notificações acionáveis e notificações de participação. - -## Configure o som, a carga útil e o badge do iOS -{: #badge-sound-payload} - -Configure um badge iOS, som e carga útil JSON adicional. - -1. No painel {{site.data.keyword.mobilepushshort}}, acesse a guia **Notificações**. -2. Acesse a seção **Campos opcionais** para configurar os recursos do {{site.data.keyword.mobilepushshort}}. - - **Arquivo de som** - insira uma sequência para apontar para o arquivo de som em -seu app móvel. Na carga útil, especifique o nome da sequência do arquivo de som a ser usado. - - **Badge iOS** - para dispositivos iOS, o -número a ser exibido como o badge do ícone do aplicativo. Se essa propriedade -estiver ausente, o badge não será mudado. Para remover o badge, -configure o valor dessa propriedade para 0. - -###Android - -Inclua seu arquivo de som no diretório `res/raw` do aplicativo Android. Ao enviar a notificação, inclua o nome do arquivo de som no campo de som do {{site.data.keyword.mobilepushshort}}. - -``` -"settings": { - "gcm" : { - "sound":"tt.wav", - } - } -``` - {: codeblock} - -###iOS - -``` -"settings": { - "apns" : { - "badge": 10, - "sound": "tt.wav", - } -} -``` - {: codeblock} - -**Carga útil adicional** - Essa carga útil pode ser qualquer par de valores de chave e deve ser um objeto JSON que você deseja enviar com o {{site.data.keyword.mobilepushshort}}. - -``` -{"key":"value", "key2":"value2"} -``` - {: codeblock} - -## Participação de notificações do Android -{: #hold-notifications-android} - -Quando seu aplicativo entra em segundo plano, é possível que você queira que o {{site.data.keyword.mobilepushshort}} retenha as notificações enviadas para seu aplicativo. Para reter notificações, chame o método hold() no método onPause() da atividade que está manipulando o {{site.data.keyword.mobilepushshort}}. - -``` -@Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Ativando o {{site.data.keyword.mobilepushshort}} avançado +Última atualização: 23 de janeiro de 2017 +{: .last-updated} + +Configure um badge iOS, som, carga útil JSON adicional, notificações acionáveis e notificações de participação. + +## Configure o som, a carga útil e o badge do iOS +{: #badge-sound-payload} + +Configure um badge iOS, som e carga útil JSON adicional. + +1. No painel {{site.data.keyword.mobilepushshort}}, acesse a guia **Notificações**. +2. Acesse a seção **Campos opcionais** para configurar os recursos do {{site.data.keyword.mobilepushshort}}. + - **Arquivo de som** - insira uma sequência para apontar para o arquivo de som em +seu app móvel. Na carga útil, especifique o nome da sequência do arquivo de som a ser usado. + - **Badge iOS** - para dispositivos iOS, o +número a ser exibido como o badge do ícone do aplicativo. Se essa propriedade +estiver ausente, o badge não será mudado. Para remover o badge, +configure o valor dessa propriedade para 0. + +### Android + +Inclua seu arquivo de som no diretório `res/raw` do aplicativo Android. Ao enviar a notificação, inclua o nome do arquivo de som no campo de som do {{site.data.keyword.mobilepushshort}}. + +``` +"settings": { + "gcm" : { + "sound":"tt.wav", + } + } +``` + {: codeblock} + +### iOS + +``` +"settings": { + "apns" : { + "badge": 10, + "sound": "tt.wav", + } +} +``` + {: codeblock} + +**Carga útil adicional** - Essa carga útil pode ser qualquer par de valores de chave e deve ser um objeto JSON que você deseja enviar com o {{site.data.keyword.mobilepushshort}}. + +``` +{"key":"value", "key2":"value2"} +``` + {: codeblock} + +## Participação de notificações do Android +{: #hold-notifications-android} + +Quando seu aplicativo entra em segundo plano, é possível que você queira que o {{site.data.keyword.mobilepushshort}} retenha as notificações enviadas para seu aplicativo. Para reter notificações, chame o método hold() no método onPause() da atividade que está manipulando o {{site.data.keyword.mobilepushshort}}. + +``` +@Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} + + diff --git a/services/mobilepush/nl/pt/BR/t_android_create_unbound_service.md b/services/mobilepush/nl/pt/BR/t_android_create_unbound_service.md index c008de456..3c14c5ad3 100644 --- a/services/mobilepush/nl/pt/BR/t_android_create_unbound_service.md +++ b/services/mobilepush/nl/pt/BR/t_android_create_unbound_service.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Criando um serviço {{site.data.keyword.mobilepushshort}} desvinculado para Android -{: #create_android_unbound} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - -Crie uma instância de serviço do {{site.data.keyword.mobilepushshort}}. É possível usar a instância de serviço do {{site.data.keyword.mobilepushshort}} sem ligar a nenhum aplicativo backend. - -1. Ligue a instância de serviço do {{site.data.keyword.mobilepushshort}} a um aplicativo Bluemix. Ao ligar, você será capaz de ver que todos os detalhes relacionados ao serviço são armazenados no formato JSON na variável de ambiente VCAP_SERVICES. - -![Ligando um serviço Push Notification](images/unbound_1.jpg) - 2. Clique em **Ligar** e escolha a instância de serviço do {{site.data.keyword.mobilepushshort}} a ser ligada. Quando o aplicativo é ligado ao serviço {{site.data.keyword.mobilepushshort}}, as informações sobre o serviço são armazenadas no formato JSON na variável de ambiente VCAP_SERVICES do app, por exemplo: -``` - { - "imfpush_Dev": [ - { - "name": "myname_sampleUnbound", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": null - } - ] - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Criando um serviço {{site.data.keyword.mobilepushshort}} desvinculado para Android +{: #create_android_unbound} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + +Crie uma instância de serviço do {{site.data.keyword.mobilepushshort}}. É possível usar a instância de serviço do {{site.data.keyword.mobilepushshort}} sem ligar a nenhum aplicativo backend. + +1. Ligue a instância de serviço do {{site.data.keyword.mobilepushshort}} a um aplicativo Bluemix. Ao ligar, você será capaz de ver que todos os detalhes relacionados ao serviço são armazenados no formato JSON na variável de ambiente VCAP_SERVICES. + +![Ligando um serviço Push Notification](images/unbound_1.jpg) + 2. Clique em **Ligar** e escolha a instância de serviço do {{site.data.keyword.mobilepushshort}} a ser ligada. Quando o aplicativo é ligado ao serviço {{site.data.keyword.mobilepushshort}}, as informações sobre o serviço são armazenadas no formato JSON na variável de ambiente VCAP_SERVICES do app, por exemplo: +``` + { + "imfpush_Dev": [ + { + "name": "myname_sampleUnbound", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": null + } + ] + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/pt/BR/t_android_initialize.md b/services/mobilepush/nl/pt/BR/t_android_initialize.md index 27922b974..de30a507a 100644 --- a/services/mobilepush/nl/pt/BR/t_android_initialize.md +++ b/services/mobilepush/nl/pt/BR/t_android_initialize.md @@ -1,50 +1,50 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Inicializando os apps Push SDK for Android -{: #android_initialize} - -Um local comum para colocar o código de inicialização está no método onCreate da atividade principal no aplicativo Android. - -Clique no link **Opções móveis** no Painel do Aplicativo Bluemix -para obter a rota do aplicativo e o GUID do aplicativo. Use esses valores para a rota e o -GUID do App. Modifique o fragmento de código para usar os parâmetros appRoute e appGUID -do app Bluemix. - - -##Inicializar o SDK principal - -``` -// Inicialize o SDK for Java (Android) com o GUID do app IBM Bluemix e roteie -BMSClient.getInstance().initialize(getApplicationContext(), em que "applicationRoute","applicationGUID", bluemixRegion:"Local e seu app é hospedado"); -``` - - -**appRoute** - -Especifica a rota que é designada ao aplicativo do servidor que você criou no Bluemix. - -**AppGUID** - -Especifica a chave exclusiva que é designada ao aplicativo que você criou no Bluemix. Esse valor faz -distinção entre maiúsculas e minúsculas. - -**bluemixRegionSuffix** - -Especifica o local em que o app está hospedado. Você pode usar um de três valores: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##Inicializar o Push SDK do cliente - -``` -//Inicialize o Push SDK for Java do cliente -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Inicializando os apps Push SDK for Android +{: #android_initialize} + +Um local comum para colocar o código de inicialização está no método onCreate da atividade principal no aplicativo Android. + +Clique no link **Opções móveis** no Painel do Aplicativo Bluemix +para obter a rota do aplicativo e o GUID do aplicativo. Use esses valores para a rota e o +GUID do App. Modifique o fragmento de código para usar os parâmetros appRoute e appGUID +do app Bluemix. + + +##Inicializar o SDK principal + +``` +// Inicialize o SDK for Java (Android) com o GUID do app IBM Bluemix e roteie +BMSClient.getInstance().initialize(getApplicationContext(), em que "applicationRoute","applicationGUID", bluemixRegion:"Local e seu app é hospedado"); +``` + + +**appRoute** + +Especifica a rota que é designada ao aplicativo do servidor que você criou no Bluemix. + +**AppGUID** + +Especifica a chave exclusiva que é designada ao aplicativo que você criou no Bluemix. Esse valor faz +distinção entre maiúsculas e minúsculas. + +**bluemixRegionSuffix** + +Especifica o local em que o app está hospedado. Você pode usar um de três valores: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +##Inicializar o Push SDK do cliente + +``` +//Inicialize o Push SDK for Java do cliente +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` diff --git a/services/mobilepush/nl/pt/BR/t_android_install_sdk.md b/services/mobilepush/nl/pt/BR/t_android_install_sdk.md index 7a6a37483..fd3a2fdff 100644 --- a/services/mobilepush/nl/pt/BR/t_android_install_sdk.md +++ b/services/mobilepush/nl/pt/BR/t_android_install_sdk.md @@ -1,247 +1,247 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Instalando o Client Push SDK com Gradle -{: #android_install} - -Esta seção descreve como instalar e usar o Client Push SDK para desenvolver ainda mais -os aplicativos Android. - -Os serviços Push SDK móveis do Bluemix® podem ser incluídos usando Gradle. O Gradle -faz download automaticamente dos artefatos de repositórios e os disponibiliza para seu -aplicativo Android. Certifique-se de configurar corretamente o Android Studio e o Android -Studio SDK. Para obter mais informações sobre como configurar o sistema, consulte [Visão geral do Android Studio](https://developer.android.com/tools/studio/index.html). Para obter informações sobre o Gradle, consulte [Configurando compilações do Gradle](http://developer.android.com/tools/building/configuring-gradle.html). - -1. No Android Studio, depois de criar e abrir seu aplicativo móvel, abra o arquivo -**build.gradle** do aplicativo. Em seguida, inclua as dependências -a seguir no aplicativo móvel. Essas instruções de importação são requeridas para os fragmentos de código: - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - - -1. Inclua as seguintes dependências em seu aplicativo móvel. As linhas a seguir -incluem o SDK do cliente Push do Bluemix™ Mobile Services e o SDK de serviços do Google -play nas dependências do escopo de compilação. - - ``` - dependencies { - compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' - compile 'com.google.android.gms:play-services:7.8.0' - } - ``` -1. No arquivo **AndroidManifest.xml**, inclua as -permissões a seguir. Para visualizar um manifest de amostra, consulte [Aplicativo de amostra Android helloPush](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml). Para visualizar um arquivo Gradle de amostra, consulte [Arquivo de amostra Build Gradle](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle). - - ``` - - - - - - - - - ``` - - É possível ler mais sobre as -[permissões -do Android](http://developer.android.com/guide/topics/security/permissions.html) aqui. - -1. Inclua as configurações de intento de notificação da atividade. Essa configuração inicia o -aplicativo quando o usuário clica na notificação recebida da área de notificação. - - ``` - - - - - ``` - **Nota**: substitua *Your_Android_Package_Name* na ação acima pelo nome do pacote de aplicativos usado em seu aplicativo. - -1. Inclua o serviço de intento Google Cloud Messaging (GCM) e os filtros de intento das -notificações de evento RECEIVE. - - ``` - service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> - - - - - - - - - - - - - - ``` - - - -# Inicializando os apps Push SDK for Android -{: #android_initialize} - -Um local comum para colocar o código de inicialização está no método onCreate da atividade principal no aplicativo Android. - -Clique no link **Opções móveis** no Painel do Aplicativo Bluemix -para obter a rota do aplicativo e o GUID do aplicativo. Use esses valores para a rota e o -GUID do App. Modifique o fragmento de código para usar os parâmetros appRoute e appGUID -do app Bluemix. - - -##Inicializar o SDK principal - -``` -// Inicialize o SDK for Java (Android) com o GUID do app IBM Bluemix e roteie -BMSClient.getInstance().initialize(getApplicationContext(), em que "applicationRoute","applicationGUID", bluemixRegion:"Local e seu app é hospedado"); -``` - - -**appRoute** - -Especifica a rota que é designada ao aplicativo do servidor que você criou no Bluemix. - -**AppGUID** - -Especifica a chave exclusiva que é designada ao aplicativo que você criou no Bluemix. Esse valor faz -distinção entre maiúsculas e minúsculas. - -**bluemixRegionSuffix** - -Especifica o local em que o app está hospedado. Você pode usar um de três valores: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##Inicializar o Push SDK do cliente - -``` -//Inicialize o Push SDK for Java do cliente -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` - - - -# Registrando dispositivos Android -{: #android_register} - -Use a API `IMFPush.register()` para registrar o dispositivo com um serviço de notificação push. Para o registro de dispositivos Android, primeiro -inclua as informações do Google Cloud Messaging (GCM) no painel de configuração de serviço de push do Bluemix. Para obter mais informações, consulte [Configurando credenciais para o Google Cloud Messaging](t_push_provider_android.html). - -Copie e cole os seguintes fragmentos de códigos em seu -aplicativo móvel Android. - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` - - - -# Recebendo notificações push em dispositivos Android -{: #android_receive} - -Para registrar o objeto notificationListener com Push, chame o método -**MFPPush.listen()**. Esse método é chamado geralmente a partir do método** onResume() **da atividade que está manipulando as notificações push. - -1. Para registrar o objeto notificationListener com Push, chame o método -**listen()**. Esse método é chamado geralmente a partir do método** onResume() **da atividade que está manipulando as notificações push. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } - ``` -2. Compile o projeto e execute-o no dispositivo ou simulador. Quando o método -onSuccess() para o listener de resposta no método register() é chamado, ele confirma se o -dispositivo foi registrado com sucesso no Serviço de notificação push. Nesse momento, é possível enviar uma mensagem conforme descrito em Enviando notificações push básicas. -3. Verifique se seus dispositivos receberam sua notificação. Se o aplicativo estiver em execução no primeiro plano, a notificação será manipulada por **MFPPushNotificationListener**. Se o aplicativo estiver em segundo plano, uma mensagem será exibida na barra de notificações. - - - - -# Enviando notificações push básicas - -{: #push-send-notifications} - -Depois de desenvolver seus aplicativos, é possível enviar notificações push básicas (sem usar tags, badges, cargas úteis adicionais ou arquivos de som). - - -Envie notificações push básicas. - -1. Em **Escolher o público**, -selecione um dos seguintes públicos: - **Todos os dispositivos**, ou por -plataforma: **Apenas dispositivos iOS** -ou - **Apenas dispositivos Android**. - - - **Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para notificações push recebem sua notificação. - - ![Tela de notificações](images/tag_notification.jpg) - -2. Em **Criar sua notificação**, insira sua mensagem e clique -em **Enviar**. -3. Verifique se seus dispositivos receberam sua notificação. - - A captura de tela a seguir mostra uma caixa de alerta que manipula uma notificação push em primeiro plano em um dispositivo Android e iOS. - - ![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) - - ![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) - - A captura de tela a seguir mostra uma notificação push no plano de fundo para Android. - ![Notificação push no plano de fundo no Android](images/background.jpg) - - - -# Etapas Seguintes -{: #next_steps_tags} - -Depois de configurar com êxito notificações básicas, -é possível configurar notificações baseadas em tag e opções -avançadas. - -Inclua esses recursos de serviço de Notificações push no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). -Para usar opções de notificações avançadas, consulte [Notificações push avançadas](t_advance_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Instalando o Client Push SDK com Gradle +{: #android_install} + +Esta seção descreve como instalar e usar o Client Push SDK para desenvolver ainda mais +os aplicativos Android. + +Os serviços Push SDK móveis do Bluemix® podem ser incluídos usando Gradle. O Gradle +faz download automaticamente dos artefatos de repositórios e os disponibiliza para seu +aplicativo Android. Certifique-se de configurar corretamente o Android Studio e o Android +Studio SDK. Para obter mais informações sobre como configurar o sistema, consulte [Visão geral do Android Studio](https://developer.android.com/tools/studio/index.html). Para obter informações sobre o Gradle, consulte [Configurando compilações do Gradle](http://developer.android.com/tools/building/configuring-gradle.html). + +1. No Android Studio, depois de criar e abrir seu aplicativo móvel, abra o arquivo +**build.gradle** do aplicativo. Em seguida, inclua as dependências +a seguir no aplicativo móvel. Essas instruções de importação são requeridas para os fragmentos de código: + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + + +1. Inclua as seguintes dependências em seu aplicativo móvel. As linhas a seguir +incluem o SDK do cliente Push do Bluemix™ Mobile Services e o SDK de serviços do Google +play nas dependências do escopo de compilação. + + ``` + dependencies { + compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' + compile 'com.google.android.gms:play-services:7.8.0' + } + ``` +1. No arquivo **AndroidManifest.xml**, inclua as +permissões a seguir. Para visualizar um manifest de amostra, consulte [Aplicativo de amostra Android helloPush](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml). Para visualizar um arquivo Gradle de amostra, consulte [Arquivo de amostra Build Gradle](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle). + + ``` + + + + + + + + + ``` + + É possível ler mais sobre as +[permissões +do Android](http://developer.android.com/guide/topics/security/permissions.html) aqui. + +1. Inclua as configurações de intento de notificação da atividade. Essa configuração inicia o +aplicativo quando o usuário clica na notificação recebida da área de notificação. + + ``` + + + + + ``` + **Nota**: substitua *Your_Android_Package_Name* na ação acima pelo nome do pacote de aplicativos usado em seu aplicativo. + +1. Inclua o serviço de intento Google Cloud Messaging (GCM) e os filtros de intento das +notificações de evento RECEIVE. + + ``` + service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> + + + + + + + + + + + + + + ``` + + + +# Inicializando os apps Push SDK for Android +{: #android_initialize} + +Um local comum para colocar o código de inicialização está no método onCreate da atividade principal no aplicativo Android. + +Clique no link **Opções móveis** no Painel do Aplicativo Bluemix +para obter a rota do aplicativo e o GUID do aplicativo. Use esses valores para a rota e o +GUID do App. Modifique o fragmento de código para usar os parâmetros appRoute e appGUID +do app Bluemix. + + +## Inicializar o SDK principal + +``` +// Inicialize o SDK for Java (Android) com o GUID do app IBM Bluemix e roteie +BMSClient.getInstance().initialize(getApplicationContext(), em que "applicationRoute","applicationGUID", bluemixRegion:"Local e seu app é hospedado"); +``` + + +**appRoute** + +Especifica a rota que é designada ao aplicativo do servidor que você criou no Bluemix. + +**AppGUID** + +Especifica a chave exclusiva que é designada ao aplicativo que você criou no Bluemix. Esse valor faz +distinção entre maiúsculas e minúsculas. + +**bluemixRegionSuffix** + +Especifica o local em que o app está hospedado. Você pode usar um de três valores: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +## Inicializar o Push SDK do cliente + +``` +//Inicialize o Push SDK for Java do cliente +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` + + + +# Registrando dispositivos Android +{: #android_register} + +Use a API `IMFPush.register()` para registrar o dispositivo com um serviço de notificação push. Para o registro de dispositivos Android, primeiro +inclua as informações do Google Cloud Messaging (GCM) no painel de configuração de serviço de push do Bluemix. Para obter mais informações, consulte [Configurando credenciais para o Google Cloud Messaging](t_push_provider_android.html). + +Copie e cole os seguintes fragmentos de códigos em seu +aplicativo móvel Android. + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` + + + +# Recebendo notificações push em dispositivos Android +{: #android_receive} + +Para registrar o objeto notificationListener com Push, chame o método +**MFPPush.listen()**. Esse método é chamado geralmente a partir do método** onResume() **da atividade que está manipulando as notificações push. + +1. Para registrar o objeto notificationListener com Push, chame o método +**listen()**. Esse método é chamado geralmente a partir do método** onResume() **da atividade que está manipulando as notificações push. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } + ``` +2. Compile o projeto e execute-o no dispositivo ou simulador. Quando o método +onSuccess() para o listener de resposta no método register() é chamado, ele confirma se o +dispositivo foi registrado com sucesso no Serviço de notificação push. Nesse momento, é possível enviar uma mensagem conforme descrito em Enviando notificações push básicas. +3. Verifique se seus dispositivos receberam sua notificação. Se o aplicativo estiver em execução no primeiro plano, a notificação será manipulada por **MFPPushNotificationListener**. Se o aplicativo estiver em segundo plano, uma mensagem será exibida na barra de notificações. + + + + +# Enviando notificações push básicas + +{: #push-send-notifications} + +Depois de desenvolver seus aplicativos, é possível enviar notificações push básicas (sem usar tags, badges, cargas úteis adicionais ou arquivos de som). + + +Envie notificações push básicas. + +1. Em **Escolher o público**, +selecione um dos seguintes públicos: + **Todos os dispositivos**, ou por +plataforma: **Apenas dispositivos iOS** +ou + **Apenas dispositivos Android**. + + + **Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para notificações push recebem sua notificação. + + ![Tela de notificações](images/tag_notification.jpg) + +2. Em **Criar sua notificação**, insira sua mensagem e clique +em **Enviar**. +3. Verifique se seus dispositivos receberam sua notificação. + + A captura de tela a seguir mostra uma caixa de alerta que manipula uma notificação push em primeiro plano em um dispositivo Android e iOS. + + ![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) + + ![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) + + A captura de tela a seguir mostra uma notificação push no plano de fundo para Android. + ![Notificação push no plano de fundo no Android](images/background.jpg) + + + +# Etapas Seguintes +{: #next_steps_tags} + +Depois de configurar com êxito notificações básicas, +é possível configurar notificações baseadas em tag e opções +avançadas. + +Inclua esses recursos de serviço de Notificações push no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). +Para usar opções de notificações avançadas, consulte [Notificações push avançadas](t_advance_notifications.html). diff --git a/services/mobilepush/nl/pt/BR/t_android_receive.md b/services/mobilepush/nl/pt/BR/t_android_receive.md index 335ab2032..2d7c8813b 100644 --- a/services/mobilepush/nl/pt/BR/t_android_receive.md +++ b/services/mobilepush/nl/pt/BR/t_android_receive.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Recebendo notificações push em dispositivos Android -{: #android_receive} - -Para registrar o objeto notificationListener com Push, chame o método -**MFPPush.listen()**. Esse método é chamado geralmente a partir do -método** onResume() **da atividade que está -manipulando as notificações push. - -1. Para registrar o objeto notificationListener com Push, chame o método -**listen()**. Esse método é chamado geralmente a partir do -método** onResume() **da atividade que está -manipulando as notificações push. - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` -2. Compile o projeto e execute-o no dispositivo ou simulador. Quando o método -onSuccess() para o listener de resposta no método register() é chamado, ele confirma se o -dispositivo foi registrado com sucesso no Serviço de notificação push. Nesse momento, é -possível enviar uma mensagem conforme descrito em Enviando notificações push básicas. -3. Verifique se seus dispositivos receberam sua notificação. Se o -aplicativo estiver em execução no primeiro plano, a notificação será -manipulada por **MFPPushNotificationListener**. Se o aplicativo estiver em segundo plano, uma mensagem será exibida na barra de notificações. +--- + +copyright: + years: 2015, 2016 + +--- + +# Recebendo notificações push em dispositivos Android +{: #android_receive} + +Para registrar o objeto notificationListener com Push, chame o método +**MFPPush.listen()**. Esse método é chamado geralmente a partir do +método** onResume() **da atividade que está +manipulando as notificações push. + +1. Para registrar o objeto notificationListener com Push, chame o método +**listen()**. Esse método é chamado geralmente a partir do +método** onResume() **da atividade que está +manipulando as notificações push. + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` +2. Compile o projeto e execute-o no dispositivo ou simulador. Quando o método +onSuccess() para o listener de resposta no método register() é chamado, ele confirma se o +dispositivo foi registrado com sucesso no Serviço de notificação push. Nesse momento, é +possível enviar uma mensagem conforme descrito em Enviando notificações push básicas. +3. Verifique se seus dispositivos receberam sua notificação. Se o +aplicativo estiver em execução no primeiro plano, a notificação será +manipulada por **MFPPushNotificationListener**. Se o aplicativo estiver em segundo plano, uma mensagem será exibida na barra de notificações. diff --git a/services/mobilepush/nl/pt/BR/t_android_register.md b/services/mobilepush/nl/pt/BR/t_android_register.md index bf657c71a..3b6aee7b8 100644 --- a/services/mobilepush/nl/pt/BR/t_android_register.md +++ b/services/mobilepush/nl/pt/BR/t_android_register.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Registrando dispositivos Android -{: #android_register} - -Use a API `IMFPush.register()` para registrar o dispositivo com um serviço de notificação push. Para o registro de dispositivos Android, primeiro -inclua as informações do Google Cloud Messaging (GCM) no painel de configuração de serviço de push do Bluemix. Para obter mais informações, consulte [Configurando credenciais para o Google Cloud Messaging](t_push_provider_android.html). - -Copie e cole os seguintes fragmentos de códigos em seu -aplicativo móvel Android. - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Registrando dispositivos Android +{: #android_register} + +Use a API `IMFPush.register()` para registrar o dispositivo com um serviço de notificação push. Para o registro de dispositivos Android, primeiro +inclua as informações do Google Cloud Messaging (GCM) no painel de configuração de serviço de push do Bluemix. Para obter mais informações, consulte [Configurando credenciais para o Google Cloud Messaging](t_push_provider_android.html). + +Copie e cole os seguintes fragmentos de códigos em seu +aplicativo móvel Android. + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` diff --git a/services/mobilepush/nl/pt/BR/t_cordova_initialize.md b/services/mobilepush/nl/pt/BR/t_cordova_initialize.md index b0f0935e6..b394af9ef 100644 --- a/services/mobilepush/nl/pt/BR/t_cordova_initialize.md +++ b/services/mobilepush/nl/pt/BR/t_cordova_initialize.md @@ -1,41 +1,41 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} - -# Inicializando o plug-in Cordova -{: #cordova_enable} - -Antes de poder usar o plug-in Push -Notification -Service Cordova, é necessário inicializá-lo transmitindo a rota e o -GUID do aplicativo. Depois de inicializar o plug-in, é possível conectar-se ao app de -servidor criado no painel do Bluemix. O plug-in Cordova é o wrapper dos SDKs de cliente -Android e iOS para permitir que um app Cordova se comunique com serviços Bluemix. - -1. Inicialize o BMSClient copiando e colando o fragmento de código a seguir no -arquivo JavaScript principal (em geral, localizado no diretório **www/js**). - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Modifique o fragmento de código para usar os parâmetros Route e appGUID do -Bluemix. Clique no link **Opções móveis** no Painel do aplicativo -Bluemix para obter a rota e o GUID do aplicativo. Use os valores de GUID de rota e aplicativo como seus parâmetros em seu fragmento de código `BMSClient.initialize`. - - - **Nota**: se você tiver criado um aplicativo Cordova usando a CLI Cordova, por exemplo, comando do nome do -aplicativo de criação Cordova, coloque este código Javascript no arquivo **index.js**, após a função `app.receivedEvent` na função `onDeviceReady: function()` para inicializar o cliente BMS. - - ``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` -1. Próxima etapa. [Registrando -dispositivos](t_cordova_register.html). +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} + +# Inicializando o plug-in Cordova +{: #cordova_enable} + +Antes de poder usar o plug-in Push +Notification +Service Cordova, é necessário inicializá-lo transmitindo a rota e o +GUID do aplicativo. Depois de inicializar o plug-in, é possível conectar-se ao app de +servidor criado no painel do Bluemix. O plug-in Cordova é o wrapper dos SDKs de cliente +Android e iOS para permitir que um app Cordova se comunique com serviços Bluemix. + +1. Inicialize o BMSClient copiando e colando o fragmento de código a seguir no +arquivo JavaScript principal (em geral, localizado no diretório **www/js**). + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Modifique o fragmento de código para usar os parâmetros Route e appGUID do +Bluemix. Clique no link **Opções móveis** no Painel do aplicativo +Bluemix para obter a rota e o GUID do aplicativo. Use os valores de GUID de rota e aplicativo como seus parâmetros em seu fragmento de código `BMSClient.initialize`. + + + **Nota**: se você tiver criado um aplicativo Cordova usando a CLI Cordova, por exemplo, comando do nome do +aplicativo de criação Cordova, coloque este código Javascript no arquivo **index.js**, após a função `app.receivedEvent` na função `onDeviceReady: function()` para inicializar o cliente BMS. + + ``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` +1. Próxima etapa. [Registrando +dispositivos](t_cordova_register.html). diff --git a/services/mobilepush/nl/pt/BR/t_cordova_install.md b/services/mobilepush/nl/pt/BR/t_cordova_install.md index 40c67f6e8..a519ee431 100644 --- a/services/mobilepush/nl/pt/BR/t_cordova_install.md +++ b/services/mobilepush/nl/pt/BR/t_cordova_install.md @@ -1,446 +1,446 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Instalando o plug-in Push do Cordova -{: #cordova_install} - -Instale e use o plug-in Push do cliente para -desenvolver ainda mais seus aplicativos Cordova. Isso -também instala o plug-in Núcleo do Cordova, que inicializa sua -conexão com o Bluemix. - -### Antes de começar - -1. Faça download das versões mais recentes do Android Studio SDK e Xcode. -1. Configure o emulador. Para Android Studio, use um emulador que suporte a API do Google. -1. Instale a ferramenta de linha de comandos Git. Para Windows, certifique-se de -selecionar a opção **Executar Git no prompt de comandos do Windows**. Para -obter informações sobre como fazer download e instalar essa ferramenta, consulte -[Git](https://git-scm.com/downloads). - -1. Instale o Node.js e a ferramenta Node Package Manager (NPM). A ferramenta de -linha de comandos NPM é empacotada com o Node.js. Para obter informações sobre como fazer download e instalar o Node.js, consulte -[Node.js](https://nodejs.org/en/download/). -1. Na linha de comandos, instale as ferramentas de linha de comandos Cordova -usando o comando **npm install -g cordova**. Isso é -necessário para usar o plug-in Push do Cordova. Para obter informações sobre como -instalar o Cordova e configurar o app Cordova, consulte -[Cordova Apache](https://cordova.apache.org/#getstarted). - - **Nota**: Para visualizar o arquivo leia-me do plug-in Push do -Cordova, acesse [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) - - -## Instalando o plug-in Push do Cordova -1. Mude para a pasta na qual deseja criar seu app Cordova e -execute o comando a seguir para criar um aplicativo Cordova. Se -você tiver um app Cordova existente, vá para a etapa 3. - -``` -cordova create your_app_name - cd your_app_name -``` -1. Opcional: (Opcional) Edite o arquivo **config.xml** e mude o -nome do aplicativo no elemento para um da sua escolha, em vez do nome -HelloCordova padrão. - - **Nota**: Certifique-se de especificar o ID do pacote -configurável correto. Se você não fizer isso, as mensagens de erro a seguir serão -exibidas no Xcode. - * O executável foi assinado com autorizações inválidas. - * As autorizações especificadas no arquivo de autorizações de assinatura de -código do aplicativo não correspondem às especificadas no seu perfil de fornecimento. - - Para corrigir esse problema, especifique o ID do pacote configurável correto no -Xcode ou no arquivo **config.xml** do seu app Cordova. - -1. Inclua a API mínima suportada ou a declaração de destino de -implementação no arquivo config.xml do seu aplicativo Cordova. O valor minSdkVersion deve -ser maior que 15. O valor targetSdkVersion deve sempre refletir o SDK mais recente do -Android que esta disponível no Google. - * **Android** - com seu editor, abra o arquivo config.xml e atualize o elemento `` com as versões de SDK mínima e de destino: - - ``` - - - - - - ``` - * **iOS** - Atualize o elemento -com uma declaração de destino de implementação: - - ``` - - - - - ``` - -1. Na interface da linha de comandos (CLI) do Cordova, inclua suas plataformas: iOS, -Android, ou ambas, usando os comandos a seguir. - - ``` - cordova platform add ios@3.9.0 - cordova platform add android - ``` -1. No diretório raiz do aplicativo Cordova, insira o comando a seguir para -instalar o plug-in Push do Cordova: **cordova plugin add ibm-mfp-push**. - - Dependendo das plataformas incluídas, você vê algo semelhante ao -seguinte: - - ``` - Installing "ibm-mfp-push" for android - Installing "ibm-mfp-push" for ios - ``` -1. Em *your-app-root-folder*, verifique se o plug-in Principal e Push -do Cordova foram instalados com sucesso usando o comando a seguir: **cordova plugin list**. - - Dependendo das plataformas incluídas, você vê algo semelhante ao -seguinte: - - ``` - ibm-mfp-core 1.0.0 "MFPCore" - ibm-mfp-push 1.0.0 “MFPPush" - ``` -1. (Somente iOS) - Configure seu ambiente de desenvolvimento iOS. - a. Abra o arquivo your-app-name.xcodeproj no diretório *your-app-name***/platforms/ios** com Xcode. - - b. Inclua o Cabeçalho de ponte. Acesse **Configurações de compilação > -Compilador Swift - Geração de código > Cabeçalho de ponte Objective-C** e inclua o -caminho a seguir: *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - c. Inclua o parâmetro Frameworks. Acesse **Configurações de compilação > Link > Caminhos da procura Runpath** e inclua o parâmetro a seguir: - ``` - @executable_path/Frameworks - ``` - d. Remova o comentário das instruções de importação Push a seguir em seu cabeçalho de ponte. Acesse *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - ``` - //#import - //#import - //#import - ``` - e. Compile e execute seu aplicativo com Xcode. -1. (Somente Android)- Compile seu projeto Android usando o comando a seguir: -**cordova build android**. - - **Nota**: Antes de abrir seu projeto no Android Studio, -deve-se primeiro compilar o aplicativo Cordova por meio da CLI do Cordova. Caso -contrário, você encontrará erros de compilação. - - -# Inicializando o plug-in Cordova -{: #cordova_initialize} - -Antes de poder usar o plug-in Push -Notification -Service Cordova, é necessário inicializá-lo transmitindo a rota e o -GUID do aplicativo. Depois de inicializar o plug-in, é possível conectar-se ao app de -servidor criado no painel do Bluemix. O plug-in Cordova é o wrapper dos SDKs de cliente -Android e iOS para permitir que um app Cordova se comunique com serviços Bluemix. - -1. Inicialize o BMSClient copiando e colando o fragmento de código a seguir no -arquivo JavaScript principal (em geral, localizado no diretório **www/js**). - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. Modifique o fragmento de código para usar os parâmetros Route e appGUID do -Bluemix. Clique no link **Opções móveis** no Painel do aplicativo -Bluemix para obter a rota e o GUID do aplicativo. Use os valores de GUID de rota e aplicativo como seus parâmetros em seu fragmento de código `BMSClient.initialize`. - - **Nota**: se você tiver criado um aplicativo Cordova usando a CLI Cordova, por exemplo, comando do nome do -aplicativo de criação Cordova, coloque este código Javascript no arquivo **index.js**, após a função `app.receivedEvent` na função `onDeviceReady: function()` para inicializar o cliente BMS. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, -``` - -# Registrando Dispositivos - -{: #cordova_register} - -Para registrar um dispositivo no Serviço de notificação push, chame o método de -registro. - -Copie e cole o fragmento de código a seguir em seu aplicativo -Cordova para registrar um dispositivo. - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -O Android não usa o parâmetro de definições. Se você estiver somente compilando um app -Android, passe um objeto vazio; por exemplo: - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -Se deseja customizar o alerta, badge e propriedades de som, -inclua o seguinte fragmento de código JavaScript na -web part de seu aplicativo Cordova. - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -É possível acessar o conteúdo do parâmetro de resposta de sucesso em Javascript usando JSON.parse: -**var token = JSON.parse(response).token** - - -As chaves disponíveis são como a seguir: `token`, `userId` e `deviceId`. - -O fragmento de código JavaScript a seguir mostra como inicializar o SDK do cliente Bluemix -Mobile Services, registrar um dispositivo no Serviço de notificação push e atender a -notificações push. Coloque esse código em seu arquivo Javascript. - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -within the **onDeviceReady: function()**. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -Inclua o fragmento de código Objective-C a seguir em sua classe de delegação de aplicativo. - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application -didRegisterForRemoteNotificationsWithDeviceToken:(NSData -*)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -Inclua o seguinte fragmento de código Swift em sua classe de -delegação de aplicativo. - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##Próximas Etapas - -{: #cordova_register_next} - -1. Compile seu projeto e, em seguida, execute-o usando os comandos a seguir: - - * Android - **cordova build android** e depois **cordova run android** - - * iOS - **cordova build ios** e depois **cordova run ios** - - - -# Recebendo notificações push em dispositivos -{: #cordova_receive} - -Copie e cole os fragmentos de código a seguir para receber -notificações push em dispositivos. - -##JavaScript - -Inclua o seguinte fragmento de código JavaScript -na web part do seu aplicativo Cordova. - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Propriedades de notificação do Android - -A seção a seguir lista as propriedades de notificação de Android: - -* message - mensagem de notificação push -* payload - objeto JSON contendo uma carga útil de notificação - - -##Propriedades de notificação do iOS - -A seguinte seção lista as propriedades de notificação iOS: - -* message - mensagem de notificação push -* payload - objeto JSON que contém uma carga útil de notificação -action-loc-key - A sequência é usada como chave para obter uma sequência localizada na -localização atual a ser usada para o título do botão direito, em vez de “Visualizar". -* badge - O número a ser exeibido como o badge do ícone de app. Se essa propriedade -estiver ausente, o badge não será mudado. Para remover o badge, -configure o valor dessa propriedade para 0. -* sound - O nome de um arquivo de som no pacote configurável de app ou na pasta Biblioteca/sons do contêiner de dados de app. - -##Objective-C - -Inclua os fragmentos de código Objective-C a seguir em sua classe de delegação de -aplicativo. - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application -didReceiveRemoteNotification:(NSDictionary *)userInfo -fetchCompletionHandler:(void -(^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -Inclua os fragmentos de código Swift a seguir em sua classe de delegação de -aplicativo. - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` - - - -# Enviando notificações push básicas -{: #push-send-notifications} - -Depois de desenvolver seus aplicativos, é possível enviar notificações push básicas (sem usar tags, badges, cargas úteis adicionais ou arquivos de som). - - -Envie notificações push básicas. - -1. Em **Escolher o público**, -selecione um dos seguintes públicos: - **Todos os dispositivos**, ou por -plataforma: **Apenas dispositivos iOS** -ou - **Apenas dispositivos Android**. - - - **Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para notificações push recebem sua notificação. - - ![Tela de notificações](images/tag_notification.jpg) - -2. Em **Criar sua notificação**, insira sua mensagem e clique -em **Enviar**. -3. Verifique se seus dispositivos receberam sua notificação. - - A captura de tela a seguir mostra uma caixa de alerta que manipula uma notificação push em primeiro plano em um dispositivo Android e iOS. - - ![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) - - ![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) - - A captura de tela a seguir mostra uma notificação push no plano de fundo para Android. - ![Notificação push no plano de fundo no Android](images/background.jpg) - - - -# Etapas Seguintes -{: #next_steps_tags} - -Depois de configurar com êxito notificações básicas, -é possível configurar notificações baseadas em tag e opções -avançadas. - -Inclua esses recursos de serviço de Notificações push no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). -Para usar opções de notificações avançadas, consulte [Notificações push avançadas](t_advance_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Instalando o plug-in Push do Cordova +{: #cordova_install} + +Instale e use o plug-in Push do cliente para +desenvolver ainda mais seus aplicativos Cordova. Isso +também instala o plug-in Núcleo do Cordova, que inicializa sua +conexão com o Bluemix. + +### Antes de começar + +1. Faça download das versões mais recentes do Android Studio SDK e Xcode. +1. Configure o emulador. Para Android Studio, use um emulador que suporte a API do Google. +1. Instale a ferramenta de linha de comandos Git. Para Windows, certifique-se de +selecionar a opção **Executar Git no prompt de comandos do Windows**. Para +obter informações sobre como fazer download e instalar essa ferramenta, consulte +[Git](https://git-scm.com/downloads). + +1. Instale o Node.js e a ferramenta Node Package Manager (NPM). A ferramenta de +linha de comandos NPM é empacotada com o Node.js. Para obter informações sobre como fazer download e instalar o Node.js, consulte +[Node.js](https://nodejs.org/en/download/). +1. Na linha de comandos, instale as ferramentas de linha de comandos Cordova +usando o comando **npm install -g cordova**. Isso é +necessário para usar o plug-in Push do Cordova. Para obter informações sobre como +instalar o Cordova e configurar o app Cordova, consulte +[Cordova Apache](https://cordova.apache.org/#getstarted). + + **Nota**: Para visualizar o arquivo leia-me do plug-in Push do +Cordova, acesse [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push) + + +## Instalando o plug-in Push do Cordova +1. Mude para a pasta na qual deseja criar seu app Cordova e +execute o comando a seguir para criar um aplicativo Cordova. Se +você tiver um app Cordova existente, vá para a etapa 3. + +``` +cordova create your_app_name + cd your_app_name +``` +1. Opcional: (Opcional) Edite o arquivo **config.xml** e mude o +nome do aplicativo no elemento para um da sua escolha, em vez do nome +HelloCordova padrão. + + **Nota**: Certifique-se de especificar o ID do pacote +configurável correto. Se você não fizer isso, as mensagens de erro a seguir serão +exibidas no Xcode. + * O executável foi assinado com autorizações inválidas. + * As autorizações especificadas no arquivo de autorizações de assinatura de +código do aplicativo não correspondem às especificadas no seu perfil de fornecimento. + + Para corrigir esse problema, especifique o ID do pacote configurável correto no +Xcode ou no arquivo **config.xml** do seu app Cordova. + +1. Inclua a API mínima suportada ou a declaração de destino de +implementação no arquivo config.xml do seu aplicativo Cordova. O valor minSdkVersion deve +ser maior que 15. O valor targetSdkVersion deve sempre refletir o SDK mais recente do +Android que esta disponível no Google. + * **Android** - com seu editor, abra o arquivo config.xml e atualize o elemento `` com as versões de SDK mínima e de destino: + + ``` + + + + + + ``` + * **iOS** - Atualize o elemento +com uma declaração de destino de implementação: + + ``` + + + + + ``` + +1. Na interface da linha de comandos (CLI) do Cordova, inclua suas plataformas: iOS, +Android, ou ambas, usando os comandos a seguir. + + ``` + cordova platform add ios@3.9.0 + cordova platform add android + ``` +1. No diretório raiz do aplicativo Cordova, insira o comando a seguir para +instalar o plug-in Push do Cordova: **cordova plugin add ibm-mfp-push**. + + Dependendo das plataformas incluídas, você vê algo semelhante ao +seguinte: + + ``` + Installing "ibm-mfp-push" for android + Installing "ibm-mfp-push" for ios + ``` +1. Em *your-app-root-folder*, verifique se o plug-in Principal e Push +do Cordova foram instalados com sucesso usando o comando a seguir: **cordova plugin list**. + + Dependendo das plataformas incluídas, você vê algo semelhante ao +seguinte: + + ``` + ibm-mfp-core 1.0.0 "MFPCore" + ibm-mfp-push 1.0.0 “MFPPush" + ``` +1. (Somente iOS) - Configure seu ambiente de desenvolvimento iOS. + a. Abra o arquivo your-app-name.xcodeproj no diretório *your-app-name***/platforms/ios** com Xcode. + + b. Inclua o Cabeçalho de ponte. Acesse **Configurações de compilação > +Compilador Swift - Geração de código > Cabeçalho de ponte Objective-C** e inclua o +caminho a seguir: *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + c. Inclua o parâmetro Frameworks. Acesse **Configurações de compilação > Link > Caminhos da procura Runpath** e inclua o parâmetro a seguir: + ``` + @executable_path/Frameworks + ``` + d. Remova o comentário das instruções de importação Push a seguir em seu cabeçalho de ponte. Acesse *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + ``` + //#import + //#import + //#import + ``` + e. Compile e execute seu aplicativo com Xcode. +1. (Somente Android)- Compile seu projeto Android usando o comando a seguir: +**cordova build android**. + + **Nota**: Antes de abrir seu projeto no Android Studio, +deve-se primeiro compilar o aplicativo Cordova por meio da CLI do Cordova. Caso +contrário, você encontrará erros de compilação. + + +# Inicializando o plug-in Cordova +{: #cordova_initialize} + +Antes de poder usar o plug-in Push +Notification +Service Cordova, é necessário inicializá-lo transmitindo a rota e o +GUID do aplicativo. Depois de inicializar o plug-in, é possível conectar-se ao app de +servidor criado no painel do Bluemix. O plug-in Cordova é o wrapper dos SDKs de cliente +Android e iOS para permitir que um app Cordova se comunique com serviços Bluemix. + +1. Inicialize o BMSClient copiando e colando o fragmento de código a seguir no +arquivo JavaScript principal (em geral, localizado no diretório **www/js**). + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. Modifique o fragmento de código para usar os parâmetros Route e appGUID do +Bluemix. Clique no link **Opções móveis** no Painel do aplicativo +Bluemix para obter a rota e o GUID do aplicativo. Use os valores de GUID de rota e aplicativo como seus parâmetros em seu fragmento de código `BMSClient.initialize`. + + **Nota**: se você tiver criado um aplicativo Cordova usando a CLI Cordova, por exemplo, comando do nome do +aplicativo de criação Cordova, coloque este código Javascript no arquivo **index.js**, após a função `app.receivedEvent` na função `onDeviceReady: function()` para inicializar o cliente BMS. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, +``` + +# Registrando Dispositivos + +{: #cordova_register} + +Para registrar um dispositivo no Serviço de notificação push, chame o método de +registro. + +Copie e cole o fragmento de código a seguir em seu aplicativo +Cordova para registrar um dispositivo. + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +O Android não usa o parâmetro de definições. Se você estiver somente compilando um app +Android, passe um objeto vazio; por exemplo: + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +Se deseja customizar o alerta, badge e propriedades de som, +inclua o seguinte fragmento de código JavaScript na +web part de seu aplicativo Cordova. + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +É possível acessar o conteúdo do parâmetro de resposta de sucesso em Javascript usando JSON.parse: +**var token = JSON.parse(response).token** + + +As chaves disponíveis são como a seguir: `token`, `userId` e `deviceId`. + +O fragmento de código JavaScript a seguir mostra como inicializar o SDK do cliente Bluemix +Mobile Services, registrar um dispositivo no Serviço de notificação push e atender a +notificações push. Coloque esse código em seu arquivo Javascript. + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +within the **onDeviceReady: function()**. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +Inclua o fragmento de código Objective-C a seguir em sua classe de delegação de aplicativo. + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application +didRegisterForRemoteNotificationsWithDeviceToken:(NSData +*)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +Inclua o seguinte fragmento de código Swift em sua classe de +delegação de aplicativo. + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## Próximas Etapas + +{: #cordova_register_next} + +1. Compile seu projeto e, em seguida, execute-o usando os comandos a seguir: + + * Android - **cordova build android** e depois **cordova run android** + + * iOS - **cordova build ios** e depois **cordova run ios** + + + +# Recebendo notificações push em dispositivos +{: #cordova_receive} + +Copie e cole os fragmentos de código a seguir para receber +notificações push em dispositivos. + +## JavaScript + +Inclua o seguinte fragmento de código JavaScript +na web part do seu aplicativo Cordova. + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +## Propriedades de notificação do Android + +A seção a seguir lista as propriedades de notificação de Android: + +* message - mensagem de notificação push +* payload - objeto JSON contendo uma carga útil de notificação + + +## Propriedades de notificação do iOS + +A seguinte seção lista as propriedades de notificação iOS: + +* message - mensagem de notificação push +* payload - objeto JSON que contém uma carga útil de notificação +action-loc-key - A sequência é usada como chave para obter uma sequência localizada na +localização atual a ser usada para o título do botão direito, em vez de “Visualizar". +* badge - O número a ser exeibido como o badge do ícone de app. Se essa propriedade +estiver ausente, o badge não será mudado. Para remover o badge, +configure o valor dessa propriedade para 0. +* sound - O nome de um arquivo de som no pacote configurável de app ou na pasta Biblioteca/sons do contêiner de dados de app. + +## Objective-C + +Inclua os fragmentos de código Objective-C a seguir em sua classe de delegação de +aplicativo. + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application +didReceiveRemoteNotification:(NSDictionary *)userInfo +fetchCompletionHandler:(void +(^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +## Swift + +Inclua os fragmentos de código Swift a seguir em sua classe de delegação de +aplicativo. + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` + + + +# Enviando notificações push básicas +{: #push-send-notifications} + +Depois de desenvolver seus aplicativos, é possível enviar notificações push básicas (sem usar tags, badges, cargas úteis adicionais ou arquivos de som). + + +Envie notificações push básicas. + +1. Em **Escolher o público**, +selecione um dos seguintes públicos: + **Todos os dispositivos**, ou por +plataforma: **Apenas dispositivos iOS** +ou + **Apenas dispositivos Android**. + + + **Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para notificações push recebem sua notificação. + + ![Tela de notificações](images/tag_notification.jpg) + +2. Em **Criar sua notificação**, insira sua mensagem e clique +em **Enviar**. +3. Verifique se seus dispositivos receberam sua notificação. + + A captura de tela a seguir mostra uma caixa de alerta que manipula uma notificação push em primeiro plano em um dispositivo Android e iOS. + + ![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) + + ![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) + + A captura de tela a seguir mostra uma notificação push no plano de fundo para Android. + ![Notificação push no plano de fundo no Android](images/background.jpg) + + + +# Etapas Seguintes +{: #next_steps_tags} + +Depois de configurar com êxito notificações básicas, +é possível configurar notificações baseadas em tag e opções +avançadas. + +Inclua esses recursos de serviço de Notificações push no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). +Para usar opções de notificações avançadas, consulte [Notificações push avançadas](t_advance_notifications.html). diff --git a/services/mobilepush/nl/pt/BR/t_cordova_receive.md b/services/mobilepush/nl/pt/BR/t_cordova_receive.md index e96c5f59a..95e0416c7 100644 --- a/services/mobilepush/nl/pt/BR/t_cordova_receive.md +++ b/services/mobilepush/nl/pt/BR/t_cordova_receive.md @@ -1,95 +1,95 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Recebendo notificações push em dispositivos -{: #cordova_receive} - -Copie e cole os fragmentos de código a seguir para receber -notificações push em dispositivos. - -##JavaScript - -Inclua o seguinte fragmento de código JavaScript -na web part do seu aplicativo Cordova. - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Propriedades de notificação do Android - -A seção a seguir lista as propriedades de notificação de Android: - -* message - mensagem de notificação push -* payload - objeto JSON contendo uma carga útil de notificação - - -##Propriedades de notificação do iOS - -A seguinte seção lista as propriedades de notificação iOS: - -* message - mensagem de notificação push -* payload - objeto JSON que contém uma carga útil de notificação -action-loc-key - A sequência é usada como chave para obter uma sequência localizada na -localização atual a ser usada para o título do botão direito, em vez de “Visualizar". -* badge - O número a ser exeibido como o badge do ícone de app. Se essa propriedade -estiver ausente, o badge não será mudado. Para remover o badge, -configure o valor dessa propriedade para 0. -* sound - O nome de um arquivo de som no pacote configurável de app -ou na pasta Biblioteca/sons do contêiner de dados de app. - -##Objective-C - -Inclua os fragmentos de código Objective-C a seguir em sua classe de delegação de -aplicativo. - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application -didReceiveRemoteNotification:(NSDictionary *)userInfo -fetchCompletionHandler:(void -(^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -Inclua os fragmentos de código Swift a seguir em sua classe de delegação de -aplicativo. - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` -Próxima Etapa. [Enviar notificações push básicas](t_send_push_notifications.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Recebendo notificações push em dispositivos +{: #cordova_receive} + +Copie e cole os fragmentos de código a seguir para receber +notificações push em dispositivos. + +##JavaScript + +Inclua o seguinte fragmento de código JavaScript +na web part do seu aplicativo Cordova. + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +##Propriedades de notificação do Android + +A seção a seguir lista as propriedades de notificação de Android: + +* message - mensagem de notificação push +* payload - objeto JSON contendo uma carga útil de notificação + + +##Propriedades de notificação do iOS + +A seguinte seção lista as propriedades de notificação iOS: + +* message - mensagem de notificação push +* payload - objeto JSON que contém uma carga útil de notificação +action-loc-key - A sequência é usada como chave para obter uma sequência localizada na +localização atual a ser usada para o título do botão direito, em vez de “Visualizar". +* badge - O número a ser exeibido como o badge do ícone de app. Se essa propriedade +estiver ausente, o badge não será mudado. Para remover o badge, +configure o valor dessa propriedade para 0. +* sound - O nome de um arquivo de som no pacote configurável de app +ou na pasta Biblioteca/sons do contêiner de dados de app. + +##Objective-C + +Inclua os fragmentos de código Objective-C a seguir em sua classe de delegação de +aplicativo. + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application +didReceiveRemoteNotification:(NSDictionary *)userInfo +fetchCompletionHandler:(void +(^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +##Swift + +Inclua os fragmentos de código Swift a seguir em sua classe de delegação de +aplicativo. + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` +Próxima Etapa. [Enviar notificações push básicas](t_send_push_notifications.html). diff --git a/services/mobilepush/nl/pt/BR/t_cordova_register.md b/services/mobilepush/nl/pt/BR/t_cordova_register.md index 4061744ba..cf5e25277 100644 --- a/services/mobilepush/nl/pt/BR/t_cordova_register.md +++ b/services/mobilepush/nl/pt/BR/t_cordova_register.md @@ -1,151 +1,151 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Registrando Dispositivos - -{: #cordova_register} - -Para registrar um dispositivo no Serviço de notificação push, chame o método de -registro. - -Copie e cole o fragmento de código a seguir em seu aplicativo -Cordova para registrar um dispositivo. - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -O Android não usa o parâmetro de definições. Se você estiver somente compilando um app -Android, passe um objeto vazio; por exemplo: - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -Se deseja customizar o alerta, badge e propriedades de som, -inclua o seguinte fragmento de código JavaScript na -web part de seu aplicativo Cordova. - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -É possível acessar o conteúdo do parâmetro de resposta de sucesso em Javascript usando JSON.parse: -**var token = JSON.parse(response).token** - - -As chaves disponíveis são como a seguir: `token`, `userId` e `deviceId`. - -O fragmento de código JavaScript a seguir mostra como inicializar o SDK do cliente Bluemix -Mobile Services, registrar um dispositivo no Serviço de notificação push e atender a -notificações push. Coloque esse código em seu arquivo Javascript. - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -within the **onDeviceReady: function()**. - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -Inclua o fragmento de código Objective-C a seguir em sua classe de delegação de aplicativo. - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application -didRegisterForRemoteNotificationsWithDeviceToken:(NSData -*)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -Inclua o seguinte fragmento de código Swift em sua classe de -delegação de aplicativo. - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##Próximas Etapas -{: #cordova_register_next} - -1. Compile seu projeto e, em seguida, execute-o usando os comandos a seguir: - - * Android - **cordova build android** e depois **cordova run android** - - * iOS - **cordova build ios** e depois **cordova run ios** -1. [Recebendo -notificações push em dispositivos](t_cordova_receive.html). +--- + +copyright: + years: 2015, 2016 + +--- + +# Registrando Dispositivos + +{: #cordova_register} + +Para registrar um dispositivo no Serviço de notificação push, chame o método de +registro. + +Copie e cole o fragmento de código a seguir em seu aplicativo +Cordova para registrar um dispositivo. + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +O Android não usa o parâmetro de definições. Se você estiver somente compilando um app +Android, passe um objeto vazio; por exemplo: + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +Se deseja customizar o alerta, badge e propriedades de som, +inclua o seguinte fragmento de código JavaScript na +web part de seu aplicativo Cordova. + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +É possível acessar o conteúdo do parâmetro de resposta de sucesso em Javascript usando JSON.parse: +**var token = JSON.parse(response).token** + + +As chaves disponíveis são como a seguir: `token`, `userId` e `deviceId`. + +O fragmento de código JavaScript a seguir mostra como inicializar o SDK do cliente Bluemix +Mobile Services, registrar um dispositivo no Serviço de notificação push e atender a +notificações push. Coloque esse código em seu arquivo Javascript. + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +within the **onDeviceReady: function()**. + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +Inclua o fragmento de código Objective-C a seguir em sua classe de delegação de aplicativo. + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application +didRegisterForRemoteNotificationsWithDeviceToken:(NSData +*)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +Inclua o seguinte fragmento de código Swift em sua classe de +delegação de aplicativo. + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## Próximas Etapas +{: #cordova_register_next} + +1. Compile seu projeto e, em seguida, execute-o usando os comandos a seguir: + + * Android - **cordova build android** e depois **cordova run android** + + * iOS - **cordova build ios** e depois **cordova run ios** +1. [Recebendo +notificações push em dispositivos](t_cordova_receive.html). diff --git a/services/mobilepush/nl/pt/BR/t_create_push_instance.md b/services/mobilepush/nl/pt/BR/t_create_push_instance.md index 5d0bf3f93..f17313ae7 100644 --- a/services/mobilepush/nl/pt/BR/t_create_push_instance.md +++ b/services/mobilepush/nl/pt/BR/t_create_push_instance.md @@ -1,32 +1,32 @@ -# Criando uma instância de serviço de push -{: #create-push-instance} - -Para uma introdução ao {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, primeiro, deve-se criar um aplicativo {{site.data.keyword.Bluemix}}; por exemplo, um app Node.js. Em seguida, deve-se criar uma instância de um serviço Push, {{site.data.keyword.mobilepushfull}}, que precisa ser vinculado a este aplicativo Bluemix. É possível também fazer isso acessando a seção Modelo do catálogo do Bluemix e clicando no Iniciador de serviços MobileFirst. - -**Nota**: Se você configurou organizações para gerenciar seu ambiente, selecione a organização na qual deseja criar o tempo de execução e os serviços para seu app móvel. - - -1. Se você não tiver um aplicativo Bluemix, será necessário criar um; por exemplo, o app Node.js. Para criar um aplicativo Bluemix, acesse o painel do Bluemix e clique em **Criar app**. - - **Nota**: Se você tiver um aplicativo, acesse a etapa 7 para incluir um serviço.![Criar uma instância de serviço](images/create_service_instance1.jpg "Criar uma instância de serviço") - -1. Em **Escolher seu modelo de app**, clique em **WEB** - -3. Na área **Escolher ponto de início**, selecione **SDK for Node.js** e clique em **CONTINUE**.![Ponto de início](images/create_service_nodejs2.jpg) - -4. No menu suspenso **Espaço**, selecione o espaço da organização.![Selecionar espaço da organização](images/create_a_service3.jpg) -1. Em **Nome**, insira o nome de seu app e no host, insira o nome do host. - -1. No menu suspenso **Plano selecionado**, selecione um plano e depois clique no botão **CRIAR**. Aguarde até que o aplicativo entre no estágio. - -1. Clique no link **Visão geral**.![Incluir um serviço](images/create_service_add4.jpg) -1. Clique em **Incluir um serviço** . A tela CATALOG é exibida. - -1. Selecione **IBM Push Notifications:** e, no menu suspenso **Espaço**, selecione a organização.![menu suspenso Espaço da organização](images/create_service_org.jpg) -1. No nome **Serviço**, insira o nome do serviço de notificação push. - -1. Em **Plano selecionado**, selecione um plano e clique no botão **CRIAR**. - -1. Clique em **Sim** para remontar o aplicativo.![IBM Push Notification Service](images/create_service_notification5.jpg) - -1. Clique em **Notificações push** para exibir o painel Notificação push. +# Criando uma instância de serviço de push +{: #create-push-instance} + +Para uma introdução ao {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, primeiro, deve-se criar um aplicativo {{site.data.keyword.Bluemix}}; por exemplo, um app Node.js. Em seguida, deve-se criar uma instância de um serviço Push, {{site.data.keyword.mobilepushfull}}, que precisa ser vinculado a este aplicativo Bluemix. É possível também fazer isso acessando a seção Modelo do catálogo do Bluemix e clicando no Iniciador de serviços MobileFirst. + +**Nota**: Se você configurou organizações para gerenciar seu ambiente, selecione a organização na qual deseja criar o tempo de execução e os serviços para seu app móvel. + + +1. Se você não tiver um aplicativo Bluemix, será necessário criar um; por exemplo, o app Node.js. Para criar um aplicativo Bluemix, acesse o painel do Bluemix e clique em **Criar app**. + + **Nota**: Se você tiver um aplicativo, acesse a etapa 7 para incluir um serviço.![Criar uma instância de serviço](images/create_service_instance1.jpg "Criar uma instância de serviço") + +1. Em **Escolher seu modelo de app**, clique em **WEB** + +3. Na área **Escolher ponto de início**, selecione **SDK for Node.js** e clique em **CONTINUE**.![Ponto de início](images/create_service_nodejs2.jpg) + +4. No menu suspenso **Espaço**, selecione o espaço da organização.![Selecionar espaço da organização](images/create_a_service3.jpg) +1. Em **Nome**, insira o nome de seu app e no host, insira o nome do host. + +1. No menu suspenso **Plano selecionado**, selecione um plano e depois clique no botão **CRIAR**. Aguarde até que o aplicativo entre no estágio. + +1. Clique no link **Visão geral**.![Incluir um serviço](images/create_service_add4.jpg) +1. Clique em **Incluir um serviço** . A tela CATALOG é exibida. + +1. Selecione **IBM Push Notifications:** e, no menu suspenso **Espaço**, selecione a organização.![menu suspenso Espaço da organização](images/create_service_org.jpg) +1. No nome **Serviço**, insira o nome do serviço de notificação push. + +1. Em **Plano selecionado**, selecione um plano e clique no botão **CRIAR**. + +1. Clique em **Sim** para remontar o aplicativo.![IBM Push Notification Service](images/create_service_notification5.jpg) + +1. Clique em **Notificações push** para exibir o painel Notificação push. diff --git a/services/mobilepush/nl/pt/BR/t_enable-ios-notifications-receive.md b/services/mobilepush/nl/pt/BR/t_enable-ios-notifications-receive.md index 2f61f0589..a78a8441c 100644 --- a/services/mobilepush/nl/pt/BR/t_enable-ios-notifications-receive.md +++ b/services/mobilepush/nl/pt/BR/t_enable-ios-notifications-receive.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Recebendo notificações push em dispositivos iOS -{: #enable-push-ios-notifications-receiving} - -Receba notificações push em dispositivos iOS - -##Objective-C -Para receber notificações push em dispositivos iOS, inclua o método -Objective-C a seguir na delegação de seu aplicativo. - -``` -// For Objective-C -(void)application:(UIApplication *)application -didReceiveRemoteNotification:(NSDictionary *)userInfo { -//O dicionário userInfo conterá dados enviados do servidor. -} -``` - -##Swift -Para receber notificações push em dispositivos iOS, inclua o método Swift a seguir -na delegação de seu aplicativo. - -``` - // For Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the -server - } -``` - +--- + +copyright: + years: 2015, 2016 + +--- + +# Recebendo notificações push em dispositivos iOS +{: #enable-push-ios-notifications-receiving} + +Receba notificações push em dispositivos iOS + +## Objective-C +Para receber notificações push em dispositivos iOS, inclua o método +Objective-C a seguir na delegação de seu aplicativo. + +``` +// For Objective-C -(void)application:(UIApplication *)application +didReceiveRemoteNotification:(NSDictionary *)userInfo { +//O dicionário userInfo conterá dados enviados do servidor. +} +``` + +## Swift +Para receber notificações push em dispositivos iOS, inclua o método Swift a seguir +na delegação de seu aplicativo. + +``` + // For Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the +server + } +``` + diff --git a/services/mobilepush/nl/pt/BR/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/pt/BR/t_enable_actionable_notifications_ios.md index 567ebdcae..8c98cb1d2 100644 --- a/services/mobilepush/nl/pt/BR/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/pt/BR/t_enable_actionable_notifications_ios.md @@ -1,106 +1,106 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Ativando notificações acionáveis para iOS -{: #enable-actionable-notifications-ios} - -Ao contrário das notificações push tradicionais, as notificações acionáveis solicitam que os usuários façam uma seleção no recibo do alerta de notificação sem abrir o app. Use as instruções a seguir para ativar as notificações push acionáveis em seu aplicativo. - -1. Crie uma ação de resposta do usuário. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. Crie a categoria de notificação e configure uma ação. **UIUserNotificationActionContextDefault** ou - **UIUserNotificationActionContextMinimal** são contextos válidos. - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. Crie a configuração de notificação e designe as categorias da etapa -anterior. - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. Crie a notificação local ou remota e designe a ela a identidade da -categoria. - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - - [[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Ativando notificações acionáveis para iOS +{: #enable-actionable-notifications-ios} + +Ao contrário das notificações push tradicionais, as notificações acionáveis solicitam que os usuários façam uma seleção no recibo do alerta de notificação sem abrir o app. Use as instruções a seguir para ativar as notificações push acionáveis em seu aplicativo. + +1. Crie uma ação de resposta do usuário. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. Crie a categoria de notificação e configure uma ação. **UIUserNotificationActionContextDefault** ou + **UIUserNotificationActionContextMinimal** são contextos válidos. + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. Crie a configuração de notificação e designe as categorias da etapa +anterior. + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. Crie a notificação local ou remota e designe a ela a identidade da +categoria. + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + + [[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_initialize.md b/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_initialize.md index c5e135ac1..46aa5a23a 100644 --- a/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_initialize.md +++ b/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_initialize.md @@ -1,72 +1,72 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Inicializando apps Push SDK para iOS -{: #enable-push-ios-notifications-initialize} - -Um local comum para colocar o código de inicialização é no -aplicativo delegado do aplicativo iOS. -Clique no link **Opções móveis** -em seu Bluemix Application Dashboard - para obter a rota e GUID de aplicativo. - -##Inicializando o SDK principal - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - -##Inicializando o SDK de Push do cliente - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## Rota, GUID e região do Bluemix - -**appRoute** - -Especifica a rota que é designada ao aplicativo do servidor que você criou no -Bluemix. - -**GUID** - -Especifica a chave exclusiva que é designada ao aplicativo que você criou no -Bluemix. Esse valor faz -distinção entre maiúsculas e minúsculas. - -**bluemixRegionSuffix** - -Especifica o local em que o app está hospedado. O parâmetro `bluemixRegion` especifica qual implementação do Bluemix você está usando. É possível configurar esse valor com uma propriedade estática `BMSClient.REGION` e use um dos três valores: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY +--- + +copyright: + years: 2015, 2016 + +--- + +# Inicializando apps Push SDK para iOS +{: #enable-push-ios-notifications-initialize} + +Um local comum para colocar o código de inicialização é no +aplicativo delegado do aplicativo iOS. +Clique no link **Opções móveis** +em seu Bluemix Application Dashboard + para obter a rota e GUID de aplicativo. + +##Inicializando o SDK principal + +###Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +###Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + +##Inicializando o SDK de Push do cliente + +###Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +###Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## Rota, GUID e região do Bluemix + +**appRoute** + +Especifica a rota que é designada ao aplicativo do servidor que você criou no +Bluemix. + +**GUID** + +Especifica a chave exclusiva que é designada ao aplicativo que você criou no +Bluemix. Esse valor faz +distinção entre maiúsculas e minúsculas. + +**bluemixRegionSuffix** + +Especifica o local em que o app está hospedado. O parâmetro `bluemixRegion` especifica qual implementação do Bluemix você está usando. É possível configurar esse valor com uma propriedade estática `BMSClient.REGION` e use um dos três valores: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY diff --git a/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_install.md b/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_install.md index a9e7dd7af..e98dfeb0a 100644 --- a/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_install.md +++ b/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_install.md @@ -1,351 +1,351 @@ -# Inicializando apps Push SDK para iOS -{: #enable-push-ios-notifications-install} - -Para um projeto Xcode existente, é possível configurar o SDK do cliente Bluemix -Mobile Services usando a ferramenta de gerenciamento de dependência CocoaPods. Uma alternativa é instalar o SDK manualmente. - -**Nota**: Para visualizar o arquivo leia-me de Push do Swift, -acesse https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master - -##Instalando o CocoaPods - -1. Instale o CocoaPods usando o comando a seguir em seu terminal Mac. -``` -$ sudo gem install cocoapods -``` -2. Insira o comando a seguir no terminal para inicializar o CocoaPods. Ao emitir -esse comando, certifique-se de executá-lo no diretório em que está o projeto Xcode. O comando `pod init` cria um título de arquivo. -``` -$ pod init -``` -3. No Podfile gerado, inclua as dependências necessárias de SDK. Copie o Podfile a -seguir. - - Objective-C - - ``` - source 'https://github.com/CocoaPods/Specs.git' - Copy the following list as is and remove the dependencies you do not need - pod 'IMFCore' - pod 'IMFPush' - ``` - - Swift - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - end - ``` -3. No Terminal, acesse a pasta do projeto e instale as dependências com o comando a seguir: -``` -$ pod update -``` -Esse comando instala suas dependências e cria uma nova área de trabalho Xcode. **Nota**: assegure-se de sempre abrir a nova área de trabalho do Xcode, em vez do arquivo de projeto do Xcode original: - - ``` - $ open App.xcworkspace - ``` -A área de trabalho contém o projeto original e o projeto Pods que contém suas -dependências. Para modificar uma pasta de origem do Bluemix Mobile Services, é possível -localizá-la em seu projeto Pods, em `Pods/yourImportedSourceFolder`, -por exemplo: `Pods/IMFGoogleAuthentication`. - -##Usando estruturas importadas e pastas de origem - -Referencie o SDK no código. - - -### Objective-C - -Escreva diretivas #import para os cabeçalhos relevantes, por exemplo: - -``` -//Objective-C -#import -#import -``` - -**Nota**: A atualização de seu projeto Pods usando os comandos -CocoaPods `pod install` ou `pod update` poderá -substituir as pastas de origem do Bluemix Mobile Services. Para reter as versões -customizadas dos arquivos originais, assegure-se de que sejam submetidas a backup antes de emitir um destes -comandos. - -###Swift - -**Pré-requisitos -** - -- iOS 8.0 ou superior -- Xcode 7 - - -Escreva diretivas #import para os cabeçalhos relevantes, por exemplo: - -``` -//swift -import BMSCore -import BMSPush -``` - - -##Configurações de Compilação - -Acesse **Xcode > Configurações de compilação > Opções de compilação e -configure Ativar Bitcode** como **Não**. - -**Atenção**: Desde o iOS 9, mudanças no recurso App Transport -Security (ATS) podem afetar a maneira de manipular o processo de autenticação. As postagens do blog a seguir descrevem mais informações sobre as mudanças:[ATS e Bitcode no iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) e [Conecte seu app iOS 9 ao Bluemix hoje](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) - - - - -# Inicializando apps Push SDK para iOS -{: #enable-push-ios-notifications-initialize} - -Um local comum para colocar o código de inicialização é no -aplicativo delegado do aplicativo iOS. -Clique no link **Opções móveis** -em seu Bluemix Application Dashboard - para obter a rota e GUID de aplicativo. - -##Inicializando o SDK principal - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - - -##Inicializando o SDK de Push do cliente - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## Rota, GUID e região do Bluemix - -**appRoute** - -Especifica a rota que é designada ao aplicativo do servidor que você criou no Bluemix. - -**GUID** - -Especifica a chave exclusiva que é designada ao aplicativo que você criou no Bluemix. Esse valor faz -distinção entre maiúsculas e minúsculas. - -**bluemixRegionSuffix** - -Especifica o local em que o app está hospedado. O parâmetro `bluemixRegion` especifica qual implementação do Bluemix você está usando. É possível configurar esse valor com uma propriedade estática `BMSClient.REGION` e use um dos três valores: - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - - - - -# Registrando aplicativos e dispositivos iOS -{: #enable-push-ios-notifications-register} - - -Um aplicativo (app) deve se registrar com APNs para -receber notificações remotas, que geralmente ocorrem depois que o app -é instalado em um dispositivo. Depois que o token de dispositivo -gerado pelos APNs é recebido pelo app, ele deve ser transmitido de -volta ao Push Notifications Service. - -Para registrar aplicativos e dispositivos iOs: - -1. Crie um aplicativo backend -2. Passe o token para as Notificações push - - -##Crie um aplicativo backend - -Crie um aplicativo backend no catálogo do Bluemix® da seção Modelos que ligará automaticamente o serviço de Push a esse aplicativo. Se também já tiver criado um app backend, certifique-se de ligar o app ao Push Notification Service. - -###Objective-C - -``` - //For Objective-C -- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##Passe o token para as Notificações push - -Após o token ser recebido dos APNs, passe o token para as notificações push como parte do método `registerDevice:withDeviceToken`. - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -Após o token ser recebido do APNS, transmita o token para Notificações push como parte do método `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` - - - -# Recebendo notificações push em dispositivos iOS -{: #enable-push-ios-notifications-receiving} - -Receba notificações push em dispositivos iOS - -##Objective-C -Para receber notificações push em dispositivos iOS, inclua o método -Objective-C a seguir na delegação de seu aplicativo. - -``` -// For Objective-C -(void)application:(UIApplication *)application -didReceiveRemoteNotification:(NSDictionary *)userInfo { -//O dicionário userInfo conterá dados enviados do servidor. -} -``` - -##Swift -Para receber notificações push em dispositivos iOS, inclua o método Swift a seguir -na delegação de seu aplicativo. - -``` - // For Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the -server - } - -``` - - - -# Enviando notificações push básicas -{: #push-send-notifications} - -Depois de desenvolver seus aplicativos, é possível enviar notificações push básicas (sem usar tags, badges, cargas úteis adicionais ou arquivos de som). - - -Envie notificações push básicas. - -1. Em **Escolher o público**, -selecione um dos seguintes públicos: - **Todos os dispositivos**, ou por -plataforma: **Apenas dispositivos iOS** -ou - **Apenas dispositivos Android**. - - - **Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para notificações push recebem sua notificação. - - ![Tela de notificações](images/tag_notification.jpg) - -2. Em **Criar sua notificação**, insira sua mensagem e clique -em **Enviar**. -3. Verifique se seus dispositivos receberam sua notificação. - - A captura de tela a seguir mostra uma caixa de alerta que manipula uma notificação push em primeiro plano em um dispositivo Android e iOS. - - ![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) - - ![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) - - A captura de tela a seguir mostra uma notificação push no plano de fundo para Android. - ![Notificação push no plano de fundo no Android](images/background.jpg) - - - - -# Etapas Seguintes -{: #next_steps_tags} - -Depois de configurar com êxito notificações básicas, -é possível configurar notificações baseadas em tag e opções -avançadas. - -Inclua esses recursos de serviço de Notificações push no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). -Para usar opções de notificações avançadas, consulte [Notificações push avançadas](t_advance_notifications.html). +# Inicializando apps Push SDK para iOS +{: #enable-push-ios-notifications-install} + +Para um projeto Xcode existente, é possível configurar o SDK do cliente Bluemix +Mobile Services usando a ferramenta de gerenciamento de dependência CocoaPods. Uma alternativa é instalar o SDK manualmente. + +**Nota**: Para visualizar o arquivo leia-me de Push do Swift, +acesse https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master + +##Instalando o CocoaPods + +1. Instale o CocoaPods usando o comando a seguir em seu terminal Mac. +``` +$ sudo gem install cocoapods +``` +2. Insira o comando a seguir no terminal para inicializar o CocoaPods. Ao emitir +esse comando, certifique-se de executá-lo no diretório em que está o projeto Xcode. O comando `pod init` cria um título de arquivo. +``` +$ pod init +``` +3. No Podfile gerado, inclua as dependências necessárias de SDK. Copie o Podfile a +seguir. + + Objective-C + + ``` + source 'https://github.com/CocoaPods/Specs.git' + Copy the following list as is and remove the dependencies you do not need + pod 'IMFCore' + pod 'IMFPush' + ``` + + Swift + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + end + ``` +3. No Terminal, acesse a pasta do projeto e instale as dependências com o comando a seguir: +``` +$ pod update +``` +Esse comando instala suas dependências e cria uma nova área de trabalho Xcode. **Nota**: assegure-se de sempre abrir a nova área de trabalho do Xcode, em vez do arquivo de projeto do Xcode original: + + ``` + $ open App.xcworkspace + ``` +A área de trabalho contém o projeto original e o projeto Pods que contém suas +dependências. Para modificar uma pasta de origem do Bluemix Mobile Services, é possível +localizá-la em seu projeto Pods, em `Pods/yourImportedSourceFolder`, +por exemplo: `Pods/IMFGoogleAuthentication`. + +##Usando estruturas importadas e pastas de origem + +Referencie o SDK no código. + + +### Objective-C + +Escreva diretivas #import para os cabeçalhos relevantes, por exemplo: + +``` +//Objective-C +# import +# import +``` + +**Nota**: A atualização de seu projeto Pods usando os comandos +CocoaPods `pod install` ou `pod update` poderá +substituir as pastas de origem do Bluemix Mobile Services. Para reter as versões +customizadas dos arquivos originais, assegure-se de que sejam submetidas a backup antes de emitir um destes +comandos. + +###Swift + +**Pré-requisitos +** + +- iOS 8.0 ou superior +- Xcode 7 + + +Escreva diretivas #import para os cabeçalhos relevantes, por exemplo: + +``` +//swift +import BMSCore +import BMSPush +``` + + +##Configurações de Compilação + +Acesse **Xcode > Configurações de compilação > Opções de compilação e +configure Ativar Bitcode** como **Não**. + +**Atenção**: Desde o iOS 9, mudanças no recurso App Transport +Security (ATS) podem afetar a maneira de manipular o processo de autenticação. As postagens do blog a seguir descrevem mais informações sobre as mudanças:[ATS e Bitcode no iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) e [Conecte seu app iOS 9 ao Bluemix hoje](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) + + + + +# Inicializando apps Push SDK para iOS +{: #enable-push-ios-notifications-initialize} + +Um local comum para colocar o código de inicialização é no +aplicativo delegado do aplicativo iOS. +Clique no link **Opções móveis** +em seu Bluemix Application Dashboard + para obter a rota e GUID de aplicativo. + +##Inicializando o SDK principal + +###Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +###Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + + +##Inicializando o SDK de Push do cliente + +###Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +###Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## Rota, GUID e região do Bluemix + +**appRoute** + +Especifica a rota que é designada ao aplicativo do servidor que você criou no Bluemix. + +**GUID** + +Especifica a chave exclusiva que é designada ao aplicativo que você criou no Bluemix. Esse valor faz +distinção entre maiúsculas e minúsculas. + +**bluemixRegionSuffix** + +Especifica o local em que o app está hospedado. O parâmetro `bluemixRegion` especifica qual implementação do Bluemix você está usando. É possível configurar esse valor com uma propriedade estática `BMSClient.REGION` e use um dos três valores: + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + + + + +# Registrando aplicativos e dispositivos iOS +{: #enable-push-ios-notifications-register} + + +Um aplicativo (app) deve se registrar com APNs para +receber notificações remotas, que geralmente ocorrem depois que o app +é instalado em um dispositivo. Depois que o token de dispositivo +gerado pelos APNs é recebido pelo app, ele deve ser transmitido de +volta ao Push Notifications Service. + +Para registrar aplicativos e dispositivos iOs: + +1. Crie um aplicativo backend +2. Passe o token para as Notificações push + + +##Crie um aplicativo backend + +Crie um aplicativo backend no catálogo do Bluemix® da seção Modelos que ligará automaticamente o serviço de Push a esse aplicativo. Se também já tiver criado um app backend, certifique-se de ligar o app ao Push Notification Service. + +###Objective-C + +``` + //For Objective-C +- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +###Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +##Passe o token para as Notificações push + +Após o token ser recebido dos APNs, passe o token para as notificações push como parte do método `registerDevice:withDeviceToken`. + +###Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +###Swift + +Após o token ser recebido do APNS, transmita o token para Notificações push como parte do método `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` + + + +# Recebendo notificações push em dispositivos iOS +{: #enable-push-ios-notifications-receiving} + +Receba notificações push em dispositivos iOS + +##Objective-C +Para receber notificações push em dispositivos iOS, inclua o método +Objective-C a seguir na delegação de seu aplicativo. + +``` +// For Objective-C -(void)application:(UIApplication *)application +didReceiveRemoteNotification:(NSDictionary *)userInfo { +//O dicionário userInfo conterá dados enviados do servidor. +} +``` + +##Swift +Para receber notificações push em dispositivos iOS, inclua o método Swift a seguir +na delegação de seu aplicativo. + +``` + // For Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the +server + } + +``` + + + +# Enviando notificações push básicas +{: #push-send-notifications} + +Depois de desenvolver seus aplicativos, é possível enviar notificações push básicas (sem usar tags, badges, cargas úteis adicionais ou arquivos de som). + + +Envie notificações push básicas. + +1. Em **Escolher o público**, +selecione um dos seguintes públicos: + **Todos os dispositivos**, ou por +plataforma: **Apenas dispositivos iOS** +ou + **Apenas dispositivos Android**. + + + **Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para notificações push recebem sua notificação. + + ![Tela de notificações](images/tag_notification.jpg) + +2. Em **Criar sua notificação**, insira sua mensagem e clique +em **Enviar**. +3. Verifique se seus dispositivos receberam sua notificação. + + A captura de tela a seguir mostra uma caixa de alerta que manipula uma notificação push em primeiro plano em um dispositivo Android e iOS. + + ![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) + + ![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) + + A captura de tela a seguir mostra uma notificação push no plano de fundo para Android. + ![Notificação push no plano de fundo no Android](images/background.jpg) + + + + +# Etapas Seguintes +{: #next_steps_tags} + +Depois de configurar com êxito notificações básicas, +é possível configurar notificações baseadas em tag e opções +avançadas. + +Inclua esses recursos de serviço de Notificações push no seu app. Para usar notificações baseadas em tag, consulte [Notificações baseadas em tag](c_tag_basednotifications.html). +Para usar opções de notificações avançadas, consulte [Notificações push avançadas](t_advance_notifications.html). diff --git a/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_register.md b/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_register.md index edace1f7a..619488509 100644 --- a/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_register.md +++ b/services/mobilepush/nl/pt/BR/t_enable_ios_notifications_register.md @@ -1,98 +1,98 @@ -# Registrando aplicativos e dispositivos iOS -{: #enable-push-ios-notifications-register} - - -Um aplicativo (app) deve se registrar com APNs para -receber notificações remotas, que geralmente ocorrem depois que o app -é instalado em um dispositivo. Depois que o token de dispositivo -gerado pelos APNs é recebido pelo app, ele deve ser transmitido de -volta ao Push Notifications Service. - -Para registrar aplicativos e dispositivos iOs: - -1. Crie um aplicativo backend -2. Passe o token para as Notificações push - - -##Crie um aplicativo backend - -Crie um aplicativo backend no catálogo do Bluemix® da seção Modelos que ligará -automaticamente o serviço de Push a esse aplicativo. Se também -já tiver criado um app backend, certifique-se de ligar o app ao Push - Notification Service. - -###Objective-C - -``` - //For Objective-C -- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##Passe o token para as Notificações push - -Após o token ser recebido dos APNs, passe o token para as notificações push como parte do método `registerDevice:withDeviceToken`. - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -Após o token ser recebido do APNS, transmita o token para Notificações push como parte do método `didRegisterForRemoteNotificationsWithDeviceToken`. - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` +# Registrando aplicativos e dispositivos iOS +{: #enable-push-ios-notifications-register} + + +Um aplicativo (app) deve se registrar com APNs para +receber notificações remotas, que geralmente ocorrem depois que o app +é instalado em um dispositivo. Depois que o token de dispositivo +gerado pelos APNs é recebido pelo app, ele deve ser transmitido de +volta ao Push Notifications Service. + +Para registrar aplicativos e dispositivos iOs: + +1. Crie um aplicativo backend +2. Passe o token para as Notificações push + + +## Crie um aplicativo backend + +Crie um aplicativo backend no catálogo do Bluemix® da seção Modelos que ligará +automaticamente o serviço de Push a esse aplicativo. Se também +já tiver criado um app backend, certifique-se de ligar o app ao Push + Notification Service. + +### Objective-C + +``` + //For Objective-C +- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +### Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +## Passe o token para as Notificações push + +Após o token ser recebido dos APNs, passe o token para as notificações push como parte do método `registerDevice:withDeviceToken`. + +### Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +### Swift + +Após o token ser recebido do APNS, transmita o token para Notificações push como parte do método `didRegisterForRemoteNotificationsWithDeviceToken`. + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` diff --git a/services/mobilepush/nl/pt/BR/t_get_tags.md b/services/mobilepush/nl/pt/BR/t_get_tags.md index 71a04f393..cbb89d7b5 100644 --- a/services/mobilepush/nl/pt/BR/t_get_tags.md +++ b/services/mobilepush/nl/pt/BR/t_get_tags.md @@ -1,174 +1,174 @@ -# Obtendo tags -{: #get_tags} - -As identificações fornecem uma maneira de enviar notificações desejadas aos usuários com base em seus interesses, -ao contrário de transmissões gerais que são enviadas a todos os aplicativos. É possível -criar e gerenciar tags usando a guia Tag no painel Push ou usar APIs REST. É possível -usar fragmentos de código nas seções a seguir para gerenciar e consultar assinaturas de -tag de seu aplicativo móvel. É possível usar esses fragmentos de código para obter -assinaturas, inscrever-se em uma tag, cancelar a assinatura de -uma tag, obter uma lista de tags disponíveis. Copie e cole esses fragmentos de código em seu aplicativo móvel. - -## Android - -A API **getTags** -retorna a lista de identificações disponíveis as quais o dispositivo pode assinar. Depois que o dispositivo está inscrito em uma -identificação específica, ele pode receber qualquer notificação push enviada para essa -identificação. - -Copie os seguintes fragmentos de códigos em seu aplicativo -móvel Android para obter uma lista de tags nas quais o dispositivo -está inscrito e obter uma lista de tags disponíveis. - -Use a API **getTags** a seguir para obter uma lista de tags -disponíveis as quais o dispositivo podem assinar. - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - -Use a API **getSubscriptions** para obter uma lista -de tags nas quais o dispositivo está inscrito. - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) -``` - -## Cordova - -Copie os fragmentos de códigos a seguir em seu aplicativo móvel para obter uma -lista de tags nas quais o dispositivo está inscrito e para obter uma lista de tags -disponíveis as quais o dispositivo pode assinar. - -Recupere uma matriz de tags que estão disponíveis para assinatura. - -``` -//Get a list of available tags to which the device can subscribe -MFPPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, null); - -``` - -``` -//Get a list of available tags to which the device is subscribed. -MFPPush.getSubscriptionStatus(function(tags) { - alert(tags); -}, null); -``` - -## Objective-C - -Copie os fragmentos de códigos a seguir em seu aplicativo iOS desenvolvido usando -Objective-C para obter uma lista de tags nas quais o dispositivo está inscrito e para -obter uma lista de tags disponíveis as quais o dispositivo pode assinar. - -Use a API **retrieveAvailableTags** a seguir para obter uma -lista de tags disponíveis as quais o dispositivo pode assinar. - -``` -//Get a list of available tags to which the device can subscribe -[push retrieveAvailableTagsWithCompletionHandler: -^(IMFResponse *response, NSError *error){ - if (error){[ self updateMessage:error.description];} else { - [self updateMessage:@"Successfully retrieved available tags."]; - NSDictionary *availableTags = [[NSDictionary alloc]init]; - availableTags = [response tags]; -[self.appDelegateVC updateMessage:availableTags.description]; -} -}]; -``` - -Use a API **retrieveSubscriptions** para obter uma -lista de tags nas quais o dispositivo está inscrito. - - -``` -// Get a list of tags that to which the device is subscribed. -[push retrieveSubscriptionsWithCompletionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved subscriptions."]; - NSDictionary *subscribedTags = [[NSDictionary alloc]init]; -subscribedTags = [response subscriptions]; -[self.appDelegateVC updateMessage:subscribedTags.description]; -} -}]; -``` - -## Swift - -A API **retrieveAvailableTagsWithCompletionHandler** retorna a lista de -identificações disponíveis as quais o dispositivo pode assinar. Depois que o dispositivo está inscrito em uma -identificação específica, ele pode receber qualquer notificação push enviada para essa -identificação. - -Chame o serviço push para obter assinaturas para -uma tag. - -Copie os fragmentos de códigos a seguir em seu aplicativo móvel Swift para obter uma -lista de tags disponíveis nas quais o dispositivo está inscrito e para obter uma lista de -tags disponíveis as quais o dispositivo pode assinar. - - -``` -//Get a list of available tags to which the device can subscribe -push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - - if error.isEmpty { - - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else{ - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - - print( "Response during retrieving subscribed tags : \(response.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - - - +# Obtendo tags +{: #get_tags} + +As identificações fornecem uma maneira de enviar notificações desejadas aos usuários com base em seus interesses, +ao contrário de transmissões gerais que são enviadas a todos os aplicativos. É possível +criar e gerenciar tags usando a guia Tag no painel Push ou usar APIs REST. É possível +usar fragmentos de código nas seções a seguir para gerenciar e consultar assinaturas de +tag de seu aplicativo móvel. É possível usar esses fragmentos de código para obter +assinaturas, inscrever-se em uma tag, cancelar a assinatura de +uma tag, obter uma lista de tags disponíveis. Copie e cole esses fragmentos de código em seu aplicativo móvel. + +## Android + +A API **getTags** +retorna a lista de identificações disponíveis as quais o dispositivo pode assinar. Depois que o dispositivo está inscrito em uma +identificação específica, ele pode receber qualquer notificação push enviada para essa +identificação. + +Copie os seguintes fragmentos de códigos em seu aplicativo +móvel Android para obter uma lista de tags nas quais o dispositivo +está inscrito e obter uma lista de tags disponíveis. + +Use a API **getTags** a seguir para obter uma lista de tags +disponíveis as quais o dispositivo podem assinar. + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + +Use a API **getSubscriptions** para obter uma lista +de tags nas quais o dispositivo está inscrito. + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) +``` + +## Cordova + +Copie os fragmentos de códigos a seguir em seu aplicativo móvel para obter uma +lista de tags nas quais o dispositivo está inscrito e para obter uma lista de tags +disponíveis as quais o dispositivo pode assinar. + +Recupere uma matriz de tags que estão disponíveis para assinatura. + +``` +//Get a list of available tags to which the device can subscribe +MFPPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, null); + +``` + +``` +//Get a list of available tags to which the device is subscribed. +MFPPush.getSubscriptionStatus(function(tags) { + alert(tags); +}, null); +``` + +## Objective-C + +Copie os fragmentos de códigos a seguir em seu aplicativo iOS desenvolvido usando +Objective-C para obter uma lista de tags nas quais o dispositivo está inscrito e para +obter uma lista de tags disponíveis as quais o dispositivo pode assinar. + +Use a API **retrieveAvailableTags** a seguir para obter uma +lista de tags disponíveis as quais o dispositivo pode assinar. + +``` +//Get a list of available tags to which the device can subscribe +[push retrieveAvailableTagsWithCompletionHandler: +^(IMFResponse *response, NSError *error){ + if (error){[ self updateMessage:error.description];} else { + [self updateMessage:@"Successfully retrieved available tags."]; + NSDictionary *availableTags = [[NSDictionary alloc]init]; + availableTags = [response tags]; +[self.appDelegateVC updateMessage:availableTags.description]; +} +}]; +``` + +Use a API **retrieveSubscriptions** para obter uma +lista de tags nas quais o dispositivo está inscrito. + + +``` +// Get a list of tags that to which the device is subscribed. +[push retrieveSubscriptionsWithCompletionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved subscriptions."]; + NSDictionary *subscribedTags = [[NSDictionary alloc]init]; +subscribedTags = [response subscriptions]; +[self.appDelegateVC updateMessage:subscribedTags.description]; +} +}]; +``` + +## Swift + +A API **retrieveAvailableTagsWithCompletionHandler** retorna a lista de +identificações disponíveis as quais o dispositivo pode assinar. Depois que o dispositivo está inscrito em uma +identificação específica, ele pode receber qualquer notificação push enviada para essa +identificação. + +Chame o serviço push para obter assinaturas para +uma tag. + +Copie os fragmentos de códigos a seguir em seu aplicativo móvel Swift para obter uma +lista de tags disponíveis nas quais o dispositivo está inscrito e para obter uma lista de +tags disponíveis as quais o dispositivo pode assinar. + + +``` +//Get a list of available tags to which the device can subscribe +push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + + if error.isEmpty { + + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else{ + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + + print( "Response during retrieving subscribed tags : \(response.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + + + diff --git a/services/mobilepush/nl/pt/BR/t_handle_actionable_notifications_ios.md b/services/mobilepush/nl/pt/BR/t_handle_actionable_notifications_ios.md index 2fda75368..3591b2645 100644 --- a/services/mobilepush/nl/pt/BR/t_handle_actionable_notifications_ios.md +++ b/services/mobilepush/nl/pt/BR/t_handle_actionable_notifications_ios.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Manipulando notificações acionáveis para iOS -{: #actionable-notifications} - - -Quando uma notificação que permite ação é recebida, o controle é passado para o -método a seguir com base no identificador escolhido. - -###Objective-C - -``` -(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: -(UILocalNotification *)notification completionHandler:(void (^)())completionHandler -{ - NSLog(@"actionable notification received."); - //must call completion handler when finished - completionHandler(); -} -``` - -###Swift - -``` -func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { - //must call completion handler when finished - completionHandler() - } -``` - - +--- + +copyright: + years: 2015, 2016 + +--- + +# Manipulando notificações acionáveis para iOS +{: #actionable-notifications} + + +Quando uma notificação que permite ação é recebida, o controle é passado para o +método a seguir com base no identificador escolhido. + +### Objective-C + +``` +(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: +(UILocalNotification *)notification completionHandler:(void (^)())completionHandler +{ + NSLog(@"actionable notification received."); + //must call completion handler when finished + completionHandler(); +} +``` + +### Swift + +``` +func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { + //must call completion handler when finished + completionHandler() + } +``` + + diff --git a/services/mobilepush/nl/pt/BR/t_holding_notifications_android.md b/services/mobilepush/nl/pt/BR/t_holding_notifications_android.md index 103987e18..c0004efac 100644 --- a/services/mobilepush/nl/pt/BR/t_holding_notifications_android.md +++ b/services/mobilepush/nl/pt/BR/t_holding_notifications_android.md @@ -1,30 +1,30 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Participando de notificações para -Android -{: #hold-notifications-android} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - -Quando seu aplicativo entra em segundo plano, é possível que você queira que o serviço {{site.data.keyword.mobilepushshort}} retenha as notificações enviadas para seu aplicativo. Para reter notificações, chame o método hold() no método onPause() da atividade que está manipulando o {{site.data.keyword.mobilepushshort}}. - -``` - @Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Participando de notificações para +Android +{: #hold-notifications-android} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + +Quando seu aplicativo entra em segundo plano, é possível que você queira que o serviço {{site.data.keyword.mobilepushshort}} retenha as notificações enviadas para seu aplicativo. Para reter notificações, chame o método hold() no método onPause() da atividade que está manipulando o {{site.data.keyword.mobilepushshort}}. + +``` + @Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/pt/BR/t_manage_tags.md b/services/mobilepush/nl/pt/BR/t_manage_tags.md index 34c7fff4d..6846c77d9 100644 --- a/services/mobilepush/nl/pt/BR/t_manage_tags.md +++ b/services/mobilepush/nl/pt/BR/t_manage_tags.md @@ -1,380 +1,380 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Gerenciando Identificações -{: #manage_tags} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - -Use o painel {{site.data.keyword.mobilepushshort}} para criar e excluir -tags de seu aplicativo e depois inicializar notificações baseadas em tag. A notificação -baseada em tag é recebida nos dispositivos inscritos nas tags. - - -## Criando marcações -{: #create_tags} - -Notificações baseadas em tag são mensagens que se destinam a todos os dispositivos inscritos em uma tag específica. Cada dispositivo pode se inscrever em -qualquer número de tags. Quando uma tag é excluída, informações associadas a essa tag, incluindo seus assinantes e dispositivos, são excluídos. O -cancelamento de assinatura automático não é necessário, uma vez que a tag não -existe mais. Nenhuma ação posterior é necessária no lado do cliente. - -1. No painel {{site.data.keyword.mobilepushshort}}, selecione a tag **Tags**. -1. Clique no botão + **Criar tag**. - 1. No campo **Nome**, insira o nome da tag. Por exemplo, "coupons". - 1. No campo **Descrição**, insira uma descrição de tag. - 1. Clique em **Salvar**. - -1. Na área **Fragmentos de códigos**, -selecione a plataforma para seu aplicativo móvel. -1. Modifique os fragmentos de códigos para manipular erros e -depois copie os fragmentos de códigos para cada tag em seu -aplicativo móvel. - -## Excluindo marcações -{: #delete_tags} - -1. Na guia **Tag**, selecione a tag que você deseja excluir e -clique no ícone **Excluir**. -1. Clique em **OK**. - -## Editando uma descrição de tag -{: #edit_tags} - -1. Na guia **Tag**, selecione a tag que deseja -editar. -1. Clique no ícone **Editar**. -1. Edite a descrição d tag e clique no botão -**Salvar**. - -# Obtendo tags -{: #get_tags} - -As tags fornecem uma maneira de enviar notificações destinadas a usuários com base -em seus interesses, ao contrário das transmissões em geral que são enviadas a todos os -aplicativos. É possível criar e gerenciar tags usando a guia Tag no painel -{{site.data.keyword.mobilepushshort}} ou use APIs REST. É possível usar fragmentos de código para gerenciar e consultar as assinaturas de identificação de seu aplicativo -móvel. É possível usar esses fragmentos de código para obter assinaturas, assinar uma -tag, cancelar a assinatura de uma tag ou obter uma lista de tags disponíveis. Copie esses -fragmentos de código para seu aplicativo móvel. - -## Obtendo tags no Android -{: android-get-tags} - -A API **getTags** -retorna a lista de identificações disponíveis as quais o dispositivo pode assinar. Depois que o dispositivo é inscrito em uma tag específica, ele pode receber {{site.data.keyword.mobilepushshort}} enviada para essa tag. - -Copie os fragmentos de código a seguir para seu aplicativo móvel Android para obter -uma lista de tags nas quais o dispositivo está inscrito e obter uma lista de tags -disponíveis. - -Use a API **getTags** a seguir para obter uma lista de tags -disponíveis as quais o dispositivo podem assinar. - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } - }) -``` - {: codeblock} - -Use a API **getSubscriptions** para obter uma lista -de tags nas quais o dispositivo está inscrito. - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) - ``` - {: codeblock} - -## Obtendo tags no Cordova -{: cordova-get-tags} - -Copie os fragmentos de código a seguir para seu aplicativo móvel para obter uma -lista de tags nas quais o dispositivo está inscrito e uma lista de tags disponíveis. - -Recupere uma matriz de tags que estiverem disponíveis para assinatura. - -``` -//Get a list of available tags to which the device can subscribe -BMSPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed. -BMSPush.retrieveSubscriptions(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - - -## Obtendo tags no Swift -{: swift-get-tags} - -A API **retrieveAvailableTagsWithCompletionHandler** retorna a lista de -identificações disponíveis as quais o dispositivo pode assinar. Depois que o dispositivo é inscrito em uma tag específica, ele pode receber {{site.data.keyword.mobilepushshort}} enviada para essa tag. - -Chame o {{site.data.keyword.mobilepushshort}} para obter assinaturas para uma tag. - -Copie os fragmentos de códigos a seguir em seu aplicativo móvel Swift para obter uma -lista de tags disponíveis nas quais o dispositivo está inscrito e para obter uma lista de -tags disponíveis as quais o dispositivo pode assinar. -``` -//Get a list of available tags to which the device can subscribe - push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - if error.isEmpty - { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else { - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during retrieving subscribed tags : \(response?.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -## Google Chrome, Safari e Mozilla Firefox -{: web-get-tags} - -Para obter a lista de identificações disponíveis, a qual os clientes podem assinar, use o código a seguir. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - - -## Apps Google Chrome e Extensões -{: web-get-tags} - -Para obter a lista de identificações disponíveis, a qual os clientes podem assinar, use o código a seguir. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - -Copie os fragmentos de código a seguir em seus Apps Google Chrome e Extensões para -obter uma lista de identificações nas quais os clientes se inscreveram. - -``` -var bmsPush = new BMSPush(); - bmsPush.retrieveSubscriptions(function(response) - { - alert(response.response) - }) -``` - {: codeblock} - - -# Assinando e removendo assinatura de tags -{: #Subscribe_tags} - -Use os fragmentos de código a seguir para permitir que seus dispositivos obtenham -assinaturas, bem como assinem e cancelem a assinatura de uma tag. - -## Assinando e removendo assinatura de tags no Android -{: android-subscribe-tags} - -Copie e cole este fragmento de código em seu aplicativo móvel Android. - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } - }); -``` - {: codeblock} - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } - }); -``` - {: codeblock} - -## Assinando e removendo assinatura de tags no Cordova -{: cordova-subscribe-tags} - -Copie e cole este fragmento de código em seu aplicativo móvel Cordova. - -``` -var tag = "YourTag"; -BMSPush.subscribe(tag, success, failure); -BMSPush.unsubscribe(tag, success, failure); -``` - {: codeblock} - - -## Assinando e removendo assinatura de tags no Swift -{: swift-subscribe-tags} - -Copie e cole este fragmento de código em seu aplicativo móvel Swift. - -Use a API **subscribeToTags** para assinar uma -identificação. - -``` -push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print("Response when subscribing to tags: \(response?.description)") - print("Status code when subscribing to tags: \(statusCode)") - } else { - print("Error when subscribing to tags: \(error) ") - print("Error status code when subscribing to tags: \(statusCode)") - } -}) -``` - {: codeblock} - -Use a API **unsubscribeFromTags** para cancelar a assinatura de uma -identificação. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during unsubscribed tags : \(response?.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - {: codeblock} - -## Google Chrome e Mozilla Firefox -{: web-subscribe-tags} - -Para assinar tags de aplicativos da web, use o fragmento de código a seguir: - -``` -var tagsArray = ["tag1", "Tag2"] -bmsPush.subscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -Cancele a assinatura das tags usando o método **unSubscribe**. - -``` -var tagsArray = ["tag1", "Tag2"] - bmsPush.unSubscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -# Usando -notificações baseada em tag -{: #using_tags} - -Notificações baseadas em tag são mensagens que se destinam a todos os dispositivos inscritos em uma tag específica. Cada dispositivo pode ser inscrito em qualquer número de tags. Este -tópico descreve como enviar notificações baseadas em tag. As assinaturas são mantidas pela instância do Bluemix do serviço {{site.data.keyword.mobilepushshort}}. Quando uma tag é excluída, todas as informações associadas a essa tag, incluindo seus assinantes e dispositivos, são excluídas. Nenhum cancelamento de -assinatura automático é necessário para essa tag, uma vez que ela não existe mais e -nenhuma ação adicional é necessária no lado do cliente. - -Crie tags na tela **Tag**. Para obter informações sobre como -criar tags, consulte -[Criando tags](t_manage_tags.html). - -1. A partir do painel **Notificação push**, clique em **Enviar notificações**. -1. Selecione a opção **Dispositivo por identificação** na lista suspensa **Enviar para**. -1. Procure as identificações que deseja usar e selecione-as. -![Tela de notificações](images/tag_notification.jpg) -1. No campo **Texto da mensagem**, insira o texto que seria enviado como uma notificação ao público inscrito. -1. Clique em **Enviar**. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Gerenciando Identificações +{: #manage_tags} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + +Use o painel {{site.data.keyword.mobilepushshort}} para criar e excluir +tags de seu aplicativo e depois inicializar notificações baseadas em tag. A notificação +baseada em tag é recebida nos dispositivos inscritos nas tags. + + +## Criando marcações +{: #create_tags} + +Notificações baseadas em tag são mensagens que se destinam a todos os dispositivos inscritos em uma tag específica. Cada dispositivo pode se inscrever em +qualquer número de tags. Quando uma tag é excluída, informações associadas a essa tag, incluindo seus assinantes e dispositivos, são excluídos. O +cancelamento de assinatura automático não é necessário, uma vez que a tag não +existe mais. Nenhuma ação posterior é necessária no lado do cliente. + +1. No painel {{site.data.keyword.mobilepushshort}}, selecione a tag **Tags**. +1. Clique no botão + **Criar tag**. + 1. No campo **Nome**, insira o nome da tag. Por exemplo, "coupons". + 1. No campo **Descrição**, insira uma descrição de tag. + 1. Clique em **Salvar**. + +1. Na área **Fragmentos de códigos**, +selecione a plataforma para seu aplicativo móvel. +1. Modifique os fragmentos de códigos para manipular erros e +depois copie os fragmentos de códigos para cada tag em seu +aplicativo móvel. + +## Excluindo marcações +{: #delete_tags} + +1. Na guia **Tag**, selecione a tag que você deseja excluir e +clique no ícone **Excluir**. +1. Clique em **OK**. + +## Editando uma descrição de tag +{: #edit_tags} + +1. Na guia **Tag**, selecione a tag que deseja +editar. +1. Clique no ícone **Editar**. +1. Edite a descrição d tag e clique no botão +**Salvar**. + +# Obtendo tags +{: #get_tags} + +As tags fornecem uma maneira de enviar notificações destinadas a usuários com base +em seus interesses, ao contrário das transmissões em geral que são enviadas a todos os +aplicativos. É possível criar e gerenciar tags usando a guia Tag no painel +{{site.data.keyword.mobilepushshort}} ou use APIs REST. É possível usar fragmentos de código para gerenciar e consultar as assinaturas de identificação de seu aplicativo +móvel. É possível usar esses fragmentos de código para obter assinaturas, assinar uma +tag, cancelar a assinatura de uma tag ou obter uma lista de tags disponíveis. Copie esses +fragmentos de código para seu aplicativo móvel. + +## Obtendo tags no Android +{: android-get-tags} + +A API **getTags** +retorna a lista de identificações disponíveis as quais o dispositivo pode assinar. Depois que o dispositivo é inscrito em uma tag específica, ele pode receber {{site.data.keyword.mobilepushshort}} enviada para essa tag. + +Copie os fragmentos de código a seguir para seu aplicativo móvel Android para obter +uma lista de tags nas quais o dispositivo está inscrito e obter uma lista de tags +disponíveis. + +Use a API **getTags** a seguir para obter uma lista de tags +disponíveis as quais o dispositivo podem assinar. + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } + }) +``` + {: codeblock} + +Use a API **getSubscriptions** para obter uma lista +de tags nas quais o dispositivo está inscrito. + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) + ``` + {: codeblock} + +## Obtendo tags no Cordova +{: cordova-get-tags} + +Copie os fragmentos de código a seguir para seu aplicativo móvel para obter uma +lista de tags nas quais o dispositivo está inscrito e uma lista de tags disponíveis. + +Recupere uma matriz de tags que estiverem disponíveis para assinatura. + +``` +//Get a list of available tags to which the device can subscribe +BMSPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed. +BMSPush.retrieveSubscriptions(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + + +## Obtendo tags no Swift +{: swift-get-tags} + +A API **retrieveAvailableTagsWithCompletionHandler** retorna a lista de +identificações disponíveis as quais o dispositivo pode assinar. Depois que o dispositivo é inscrito em uma tag específica, ele pode receber {{site.data.keyword.mobilepushshort}} enviada para essa tag. + +Chame o {{site.data.keyword.mobilepushshort}} para obter assinaturas para uma tag. + +Copie os fragmentos de códigos a seguir em seu aplicativo móvel Swift para obter uma +lista de tags disponíveis nas quais o dispositivo está inscrito e para obter uma lista de +tags disponíveis as quais o dispositivo pode assinar. +``` +//Get a list of available tags to which the device can subscribe + push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + if error.isEmpty + { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else { + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during retrieving subscribed tags : \(response?.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +## Google Chrome, Safari e Mozilla Firefox +{: web-get-tags} + +Para obter a lista de identificações disponíveis, a qual os clientes podem assinar, use o código a seguir. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + + +## Apps Google Chrome e Extensões +{: web-get-tags} + +Para obter a lista de identificações disponíveis, a qual os clientes podem assinar, use o código a seguir. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + +Copie os fragmentos de código a seguir em seus Apps Google Chrome e Extensões para +obter uma lista de identificações nas quais os clientes se inscreveram. + +``` +var bmsPush = new BMSPush(); + bmsPush.retrieveSubscriptions(function(response) + { + alert(response.response) + }) +``` + {: codeblock} + + +# Assinando e removendo assinatura de tags +{: #Subscribe_tags} + +Use os fragmentos de código a seguir para permitir que seus dispositivos obtenham +assinaturas, bem como assinem e cancelem a assinatura de uma tag. + +## Assinando e removendo assinatura de tags no Android +{: android-subscribe-tags} + +Copie e cole este fragmento de código em seu aplicativo móvel Android. + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } + }); +``` + {: codeblock} + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } + }); +``` + {: codeblock} + +## Assinando e removendo assinatura de tags no Cordova +{: cordova-subscribe-tags} + +Copie e cole este fragmento de código em seu aplicativo móvel Cordova. + +``` +var tag = "YourTag"; +BMSPush.subscribe(tag, success, failure); +BMSPush.unsubscribe(tag, success, failure); +``` + {: codeblock} + + +## Assinando e removendo assinatura de tags no Swift +{: swift-subscribe-tags} + +Copie e cole este fragmento de código em seu aplicativo móvel Swift. + +Use a API **subscribeToTags** para assinar uma +identificação. + +``` +push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print("Response when subscribing to tags: \(response?.description)") + print("Status code when subscribing to tags: \(statusCode)") + } else { + print("Error when subscribing to tags: \(error) ") + print("Error status code when subscribing to tags: \(statusCode)") + } +}) +``` + {: codeblock} + +Use a API **unsubscribeFromTags** para cancelar a assinatura de uma +identificação. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during unsubscribed tags : \(response?.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + {: codeblock} + +## Google Chrome e Mozilla Firefox +{: web-subscribe-tags} + +Para assinar tags de aplicativos da web, use o fragmento de código a seguir: + +``` +var tagsArray = ["tag1", "Tag2"] +bmsPush.subscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +Cancele a assinatura das tags usando o método **unSubscribe**. + +``` +var tagsArray = ["tag1", "Tag2"] + bmsPush.unSubscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +# Usando +notificações baseada em tag +{: #using_tags} + +Notificações baseadas em tag são mensagens que se destinam a todos os dispositivos inscritos em uma tag específica. Cada dispositivo pode ser inscrito em qualquer número de tags. Este +tópico descreve como enviar notificações baseadas em tag. As assinaturas são mantidas pela instância do Bluemix do serviço {{site.data.keyword.mobilepushshort}}. Quando uma tag é excluída, todas as informações associadas a essa tag, incluindo seus assinantes e dispositivos, são excluídas. Nenhum cancelamento de +assinatura automático é necessário para essa tag, uma vez que ela não existe mais e +nenhuma ação adicional é necessária no lado do cliente. + +Crie tags na tela **Tag**. Para obter informações sobre como +criar tags, consulte +[Criando tags](t_manage_tags.html). + +1. A partir do painel **Notificação push**, clique em **Enviar notificações**. +1. Selecione a opção **Dispositivo por identificação** na lista suspensa **Enviar para**. +1. Procure as identificações que deseja usar e selecione-as. +![Tela de notificações](images/tag_notification.jpg) +1. No campo **Texto da mensagem**, insira o texto que seria enviado como uma notificação ao público inscrito. +1. Clique em **Enviar**. diff --git a/services/mobilepush/nl/pt/BR/t_manage_user.md b/services/mobilepush/nl/pt/BR/t_manage_user.md index 924a35692..8cae1271f 100644 --- a/services/mobilepush/nl/pt/BR/t_manage_user.md +++ b/services/mobilepush/nl/pt/BR/t_manage_user.md @@ -1,182 +1,182 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Registrando um dispositivo com userId -{: #register_device_with_userId} -Última atualização: 06 de fevereiro de 2017 -{: .last-updated} - -Para registrar-se para notificação baseada em userId, conclua as etapas a seguir: - -## Android -{: android-register} - -Inicialize a classe MFPPush com a chave `AppGUID` e `clientSecret` do serviço {{site.data.keyword.mobilepushshort}}. -``` -// Initialize the Push Notifications service -push = MFPPush.getInstance(); -push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); -``` - {: codeblock} - - -- **AppGUID**: esta é a chave AppGUID do serviço -{{site.data.keyword.mobilepushshort}}. -- **clientSecret**: esta é a chave clientSecret do serviço -{{site.data.keyword.mobilepushshort}}. - - Use a API **registerDeviceWithUserId** para registrar o dispositivo para {{site.data.keyword.mobilepushshort}}. - -``` -// Register the device to Push Notifications -push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - Log.d("Device is registered with Push Service.");} - @Override - public void onFailure(MFPPushException ex) { - Log.d("Error registering with Push Service...\n" - + "Push notifications will not be received."); - } - }); -``` - {: codeblock} - -- **userId**: transmita o valor exclusivo de userId para registrar-se no {{site.data.keyword.mobilepushshort}}. - -**Nota:** para ativar -{{site.data.keyword.mobilepushshort}} destinado por UserId, assegure-se de -registrar o dispositivo com um userId e também de passar o 'clientSecret' -que é alocado quando os serviços {{site.data.keyword.mobilepushshort}} são -provisionados. O registro do dispositivo falhará sem um clientSecret válido. - -## Cordova -{: cordova} - -Use as APIs a seguir para registrar para {{site.data.keyword.mobilepushshort}} baseadas em UserId. - -``` -// Register device for Push Notification with UserId -var options = {"userId": "Your User Id value"}; -BMSPush.registerDevice(options,success, failure); -``` - {: codeblock} - - -- **userId**: transmita o valor exclusivo de userId para registrar-se no {{site.data.keyword.mobilepushshort}}. - - -## Swift -{: swift-register} - -``` -// Initialize the BMSPushClient -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -- **AppGUID**: esta é a chave AppGUID do serviço -{{site.data.keyword.mobilepushshort}}. -- **clientSecret**: esta é a chave clientSecret do serviço -{{site.data.keyword.mobilepushshort}}. - -Use a API **registerWithUserId** para registrar o dispositivo para {{site.data.keyword.mobilepushshort}}. - -``` -// Register the device to Push Notifications service -push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in -if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } else { - print( "Error during device registration \(error) ") - } - } -``` - {: codeblock} - -- **userId**: transmita o valor exclusivo de userId para registrar-se no {{site.data.keyword.mobilepushshort}}. - -## Google Chrome, Safari e Mozilla Firefox -{: web-register} - -Use as APIs a seguir para registrar-se para notificações baseadas em userId. Inicialize -o SDK com `app GUID`, `app Region` e -`Client Secret`. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -Após inicializado com sucesso o registro do aplicativo da web com o userId. - -``` -bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -## Apps Google Chrome e Extensões -{: web-register-new} - -Use as APIs a seguir para registrar-se para notificações baseadas em userId. Inicialize -o SDK com `app GUID`, `app Region` e -`Client Secret`. - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -Após a inicialização bem-sucedida, será necessário registrar o aplicativo da web com o userId. - -``` -bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -# Usando notificações baseadas em userId -{: #using_userid} - -As notificações baseadas em userId são mensagens de notificação destinadas a -um usuário específico. Muitos dispositivos podem ser -registrados com um usuário. As etapas a seguir descrevem como enviar notificações baseadas em ID do usuário. - -1. No painel **Notificação push**, selecione a opção -**Enviar notificações**. -1. Selecione **UserId** na lista de opções **Enviar para**. -1. No campo **ID do usuário**, procure o ID do usuário que deseja usar e, em seguida, clique em -**+Incluir**.![Tela de notificações](images/user_notification.jpg) -1. No campo **Mensagem**, insira o texto que você deseja enviar em sua notificação. -1. Clique em **Enviar**. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Registrando um dispositivo com userId +{: #register_device_with_userId} +Última atualização: 06 de fevereiro de 2017 +{: .last-updated} + +Para registrar-se para notificação baseada em userId, conclua as etapas a seguir: + +## Android +{: android-register} + +Inicialize a classe MFPPush com a chave `AppGUID` e `clientSecret` do serviço {{site.data.keyword.mobilepushshort}}. +``` +// Initialize the Push Notifications service +push = MFPPush.getInstance(); +push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); +``` + {: codeblock} + + +- **AppGUID**: esta é a chave AppGUID do serviço +{{site.data.keyword.mobilepushshort}}. +- **clientSecret**: esta é a chave clientSecret do serviço +{{site.data.keyword.mobilepushshort}}. + + Use a API **registerDeviceWithUserId** para registrar o dispositivo para {{site.data.keyword.mobilepushshort}}. + +``` +// Register the device to Push Notifications +push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + Log.d("Device is registered with Push Service.");} + @Override + public void onFailure(MFPPushException ex) { + Log.d("Error registering with Push Service...\n" + + "Push notifications will not be received."); + } + }); +``` + {: codeblock} + +- **userId**: transmita o valor exclusivo de userId para registrar-se no {{site.data.keyword.mobilepushshort}}. + +**Nota:** para ativar +{{site.data.keyword.mobilepushshort}} destinado por UserId, assegure-se de +registrar o dispositivo com um userId e também de passar o 'clientSecret' +que é alocado quando os serviços {{site.data.keyword.mobilepushshort}} são +provisionados. O registro do dispositivo falhará sem um clientSecret válido. + +## Cordova +{: cordova} + +Use as APIs a seguir para registrar para {{site.data.keyword.mobilepushshort}} baseadas em UserId. + +``` +// Register device for Push Notification with UserId +var options = {"userId": "Your User Id value"}; +BMSPush.registerDevice(options,success, failure); +``` + {: codeblock} + + +- **userId**: transmita o valor exclusivo de userId para registrar-se no {{site.data.keyword.mobilepushshort}}. + + +## Swift +{: swift-register} + +``` +// Initialize the BMSPushClient +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +- **AppGUID**: esta é a chave AppGUID do serviço +{{site.data.keyword.mobilepushshort}}. +- **clientSecret**: esta é a chave clientSecret do serviço +{{site.data.keyword.mobilepushshort}}. + +Use a API **registerWithUserId** para registrar o dispositivo para {{site.data.keyword.mobilepushshort}}. + +``` +// Register the device to Push Notifications service +push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in +if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } else { + print( "Error during device registration \(error) ") + } + } +``` + {: codeblock} + +- **userId**: transmita o valor exclusivo de userId para registrar-se no {{site.data.keyword.mobilepushshort}}. + +## Google Chrome, Safari e Mozilla Firefox +{: web-register} + +Use as APIs a seguir para registrar-se para notificações baseadas em userId. Inicialize +o SDK com `app GUID`, `app Region` e +`Client Secret`. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +Após inicializado com sucesso o registro do aplicativo da web com o userId. + +``` +bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +## Apps Google Chrome e Extensões +{: web-register-new} + +Use as APIs a seguir para registrar-se para notificações baseadas em userId. Inicialize +o SDK com `app GUID`, `app Region` e +`Client Secret`. + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +Após a inicialização bem-sucedida, será necessário registrar o aplicativo da web com o userId. + +``` +bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +# Usando notificações baseadas em userId +{: #using_userid} + +As notificações baseadas em userId são mensagens de notificação destinadas a +um usuário específico. Muitos dispositivos podem ser +registrados com um usuário. As etapas a seguir descrevem como enviar notificações baseadas em ID do usuário. + +1. No painel **Notificação push**, selecione a opção +**Enviar notificações**. +1. Selecione **UserId** na lista de opções **Enviar para**. +1. No campo **ID do usuário**, procure o ID do usuário que deseja usar e, em seguida, clique em +**+Incluir**.![Tela de notificações](images/user_notification.jpg) +1. No campo **Mensagem**, insira o texto que você deseja enviar em sua notificação. +1. Clique em **Enviar**. diff --git a/services/mobilepush/nl/pt/BR/t_push_ios_nextsteps.md b/services/mobilepush/nl/pt/BR/t_push_ios_nextsteps.md index 8a9c87282..0552a77c1 100644 --- a/services/mobilepush/nl/pt/BR/t_push_ios_nextsteps.md +++ b/services/mobilepush/nl/pt/BR/t_push_ios_nextsteps.md @@ -1,25 +1,25 @@ - ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# Próximas Etapas - -{: #push-ios-nextsteps} - -Depois de configurar com êxito notificações básicas, -é possível configurar notificações baseadas em tag e opções -avançadas. - -Inclua esses recursos do Serviço de notificações push em seu app. - - - -- Para usar notificações baseadas em tag, consulte -[Notificações baseadas em tag](t_push_tagsmain.md). -- Para usar opções de notificações avançadas, consulte -[Notificações push avançadas](t_advance_notifications.md). + +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# Próximas Etapas + +{: #push-ios-nextsteps} + +Depois de configurar com êxito notificações básicas, +é possível configurar notificações baseadas em tag e opções +avançadas. + +Inclua esses recursos do Serviço de notificações push em seu app. + + + +- Para usar notificações baseadas em tag, consulte +[Notificações baseadas em tag](t_push_tagsmain.md). +- Para usar opções de notificações avançadas, consulte +[Notificações push avançadas](t_advance_notifications.md). diff --git a/services/mobilepush/nl/pt/BR/t_push_monitoring.md b/services/mobilepush/nl/pt/BR/t_push_monitoring.md index 052589630..8dccb9ea7 100644 --- a/services/mobilepush/nl/pt/BR/t_push_monitoring.md +++ b/services/mobilepush/nl/pt/BR/t_push_monitoring.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Monitorando notificações push -{: #monitor-notifications} -Última atualização: 16 de janeiro de 2017 -{: .last-updated} - - -Agora, o serviço IBM {{site.data.keyword.mobilepushshort}} estende os recursos para monitorar o -desempenho de push gerando gráficos de seus dados do usuário. É possível usar o utilitário para listar todas as notificações push enviadas ou para listar todos os -dispositivos registrados e analisar informações em uma base diária, semanal ou mensal. - -Para gerar relatórios para todas as notificações enviadas, utilize o método de relatório GET de Mensagem push nas [APIs de REST](https://mobile.{DomainName}/imfpush/){: new_window}. - -![Enviar relatório de notificações](images/monitoring_messages.jpg) - - -Para gerar relatórios para todos os dispositivos registrados, utilize o método de relatório GET de Registros de dispositivo push nas [APIs de REST](https://mobile.{DomainName}/imfpush/){: new_window}. - -![Relatório de dispositivos registrados](images/monitoring_devices.jpg) - -Para obter informações sobre como atualizar seu SDK (kit de desenvolvimento de software) Android para -monitorar suas informações de notificação, consulte [Monitorando notificações push em -dispositivos Android](c_android_enable.html#android_monitor). - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Monitorando notificações push +{: #monitor-notifications} +Última atualização: 16 de janeiro de 2017 +{: .last-updated} + + +Agora, o serviço IBM {{site.data.keyword.mobilepushshort}} estende os recursos para monitorar o +desempenho de push gerando gráficos de seus dados do usuário. É possível usar o utilitário para listar todas as notificações push enviadas ou para listar todos os +dispositivos registrados e analisar informações em uma base diária, semanal ou mensal. + +Para gerar relatórios para todas as notificações enviadas, utilize o método de relatório GET de Mensagem push nas [APIs de REST](https://mobile.{DomainName}/imfpush/){: new_window}. + +![Enviar relatório de notificações](images/monitoring_messages.jpg) + + +Para gerar relatórios para todos os dispositivos registrados, utilize o método de relatório GET de Registros de dispositivo push nas [APIs de REST](https://mobile.{DomainName}/imfpush/){: new_window}. + +![Relatório de dispositivos registrados](images/monitoring_devices.jpg) + +Para obter informações sobre como atualizar seu SDK (kit de desenvolvimento de software) Android para +monitorar suas informações de notificação, consulte [Monitorando notificações push em +dispositivos Android](c_android_enable.html#android_monitor). + + + diff --git a/services/mobilepush/nl/pt/BR/t_push_provider_android.md b/services/mobilepush/nl/pt/BR/t_push_provider_android.md index ad3d00417..e50e1d915 100644 --- a/services/mobilepush/nl/pt/BR/t_push_provider_android.md +++ b/services/mobilepush/nl/pt/BR/t_push_provider_android.md @@ -1,53 +1,53 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configurando credenciais para o FCM -{: #create-push-enable-gcm} -Última atualização: 16 de janeiro de 2017 -{: .last-updated} - -Firebase Cloud Messaging (FCM) é o gateway usado para entregar notificações push para dispositivos Android e para o Google Chrome. FCM é a nova versão do Google Cloud Messaging (GCM). Para configurar o serviço {{site.data.keyword.mobilepushshort}} no painel, é necessário obter suas credenciais do FCM. Assegure-se de usar configurações do FCM para novos apps. Apps existentes continuarão a funcionar com configurações do GCM. - -##Obtendo seu ID de emissor e chave de API -{: #android-senderid-apikey} - -A chave API é armazenada com segurança e usada pelo serviço {{site.data.keyword.mobilepushshort}} para se conectar ao servidor FCM e o ID do emissor -(número do projeto) é usado pelo SDK do Android e o SDK do JS para Google Chrome e Mozilla Firefox no lado do cliente. - -Para configurar o FCM, gerar a chave API e o ID do emissor, conclua as etapas: - -1. Visite o [console do Firebase ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://console.firebase.google.com/?pli=1){: new_window}. -2. Selecione **Criar novo projeto**. -3. Na janela Criar um projeto, forneça um nome do projeto, escolha um país/região e clique em **Criar projeto**. -3. Na área de janela de navegação, clique no ícone Configurações e selecione **Configurações do projeto**. -4. Escolha a guia Cloud Messaging para gerar uma Chave API Server e um ID do emissor. - -##Configurando o serviço {{site.data.keyword.mobilepushshort}} para Android e Apps Chrome e Extensões -{: #setup-push-android} - -**Nota:** você precisará da sua Chave API e do ID do emissor do FCM/GCM (número do projeto). - -1. Abra o painel Bluemix e, em seguida, clique na instância de serviço -{{site.data.keyword.mobilepushfull}} que você criou para abrir o painel. O painel Push é exibido. Para configurar um serviço {{site.data.keyword.mobilepushshort}} desvinculado -para Android, selecione o ícone do serviço {{site.data.keyword.mobilepushshort}} -desvinculado para abrir o painel do serviço {{site.data.keyword.mobilepushshort}}. - -![painel Push](images/push_unbound.jpg) - -2. Clique no botão **Configurar push**, para configurar as credenciais do FCM/GCM para aplicativos Android e Apps Google Chrome e Extensões. -3. Na página **Configuração**, para Android, acesse a guia **Móvel** e configure o ID do emissor (número do projeto do -GCM) e a Chave API. Para Apps Google Chrome e Extensões, acesse a guia **Web** e configure o ID do emissor (número do projeto do FCM/GCM) e -a Chave API apropriadamente. -4. Clique em **Salvar**. -5. Próximas etapas. [Ativando notificações para Android](c_enable_push.html) ou [Ativando notificações para Apps Google Chrome e Extensões](c_enable_push.html). - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configurando credenciais para o FCM +{: #create-push-enable-gcm} +Última atualização: 16 de janeiro de 2017 +{: .last-updated} + +Firebase Cloud Messaging (FCM) é o gateway usado para entregar notificações push para dispositivos Android e para o Google Chrome. FCM é a nova versão do Google Cloud Messaging (GCM). Para configurar o serviço {{site.data.keyword.mobilepushshort}} no painel, é necessário obter suas credenciais do FCM. Assegure-se de usar configurações do FCM para novos apps. Apps existentes continuarão a funcionar com configurações do GCM. + +## Obtendo seu ID de emissor e chave de API +{: #android-senderid-apikey} + +A chave API é armazenada com segurança e usada pelo serviço {{site.data.keyword.mobilepushshort}} para se conectar ao servidor FCM e o ID do emissor +(número do projeto) é usado pelo SDK do Android e o SDK do JS para Google Chrome e Mozilla Firefox no lado do cliente. + +Para configurar o FCM, gerar a chave API e o ID do emissor, conclua as etapas: + +1. Visite o [console do Firebase ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://console.firebase.google.com/?pli=1){: new_window}. +2. Selecione **Criar novo projeto**. +3. Na janela Criar um projeto, forneça um nome do projeto, escolha um país/região e clique em **Criar projeto**. +3. Na área de janela de navegação, clique no ícone Configurações e selecione **Configurações do projeto**. +4. Escolha a guia Cloud Messaging para gerar uma Chave API Server e um ID do emissor. + +## Configurando o serviço {{site.data.keyword.mobilepushshort}} para Android e Apps Chrome e Extensões +{: #setup-push-android} + +**Nota:** você precisará da sua Chave API e do ID do emissor do FCM/GCM (número do projeto). + +1. Abra o painel Bluemix e, em seguida, clique na instância de serviço +{{site.data.keyword.mobilepushfull}} que você criou para abrir o painel. O painel Push é exibido. Para configurar um serviço {{site.data.keyword.mobilepushshort}} desvinculado +para Android, selecione o ícone do serviço {{site.data.keyword.mobilepushshort}} +desvinculado para abrir o painel do serviço {{site.data.keyword.mobilepushshort}}. + +![painel Push](images/push_unbound.jpg) + +2. Clique no botão **Configurar push**, para configurar as credenciais do FCM/GCM para aplicativos Android e Apps Google Chrome e Extensões. +3. Na página **Configuração**, para Android, acesse a guia **Móvel** e configure o ID do emissor (número do projeto do +GCM) e a Chave API. Para Apps Google Chrome e Extensões, acesse a guia **Web** e configure o ID do emissor (número do projeto do FCM/GCM) e +a Chave API apropriadamente. +4. Clique em **Salvar**. +5. Próximas etapas. [Ativando notificações para Android](c_enable_push.html) ou [Ativando notificações para Apps Google Chrome e Extensões](c_enable_push.html). + + diff --git a/services/mobilepush/nl/pt/BR/t_push_provider_ios.md b/services/mobilepush/nl/pt/BR/t_push_provider_ios.md index 1131b0a12..4c49ea22c 100644 --- a/services/mobilepush/nl/pt/BR/t_push_provider_ios.md +++ b/services/mobilepush/nl/pt/BR/t_push_provider_ios.md @@ -1,221 +1,221 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configurando credenciais para o APNs -{: #create-push-credentials-apns} -Última atualização: 16 de janeiro de 2017 -{: .last-updated} - -O Apple Push Notification Service (APNs) permite que os desenvolvedores de aplicativos enviem notificações remotas da instância do serviço {{site.data.keyword.mobilepushshort}} no Bluemix (o provedor) para dispositivos e aplicativos do iOS. Mensagens são enviadas para um aplicativo de -destino no dispositivo. - -Obtenha e configure suas credenciais APNs. Os certificados do APNs são gerenciados com segurança pelo serviço {{site.data.keyword.mobilepushshort}} e usados para se conectar ao servidor APNs como um provedor. - - - - - - -##Registrando um ID de app -{: #create-push-credentials-apns-register} - - -O ID de app (o identificador de pacote configurável) é um -identificador exclusivo que identifica um aplicativo específico. Cada -aplicativo requer um ID de app. Serviços, como o serviço {{site.data.keyword.mobilepushshort}}, são configurados para o ID do app. - -1. Certifique-se de ter uma conta do [Apple Developers ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com/){: new_window}. -2. Acesse o portal [Apple Developer ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com){: new_window}, clique em **Member Center** e selecione **Certificates, Identifiers & Profiles**. -3. Acesse a seção **Registering App IDs** na [Apple Developer Library ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window} e siga as instruções para registrar o ID do app. - -Ao registrar um ID do App, selecione as opções a seguir: - -* Notificações push ![Serviços de app](images/appID_appservices_enablepush.jpg) -* Sufixo de ID explícito -![ID explícito](images/appID_bundleID.jpg) -4. Crie um certificado SSL de APNs de desenvolvimento e -distribuição. - -##Crie um certificado SSL de APNs de desenvolvimento e distribuição -{: #create-push-credentials-apns-ssl} - -Antes de obter um certificado APNs, deve-se primeiro gerar uma solicitação de assinatura de certificado (CSR) e enviá-la para Apple, a autoridade de certificação (CA). A CSR contém informações que identificam sua empresa e suas chaves pública e privada usadas para assinar suas notificações push da Apple. Depois, gere o certificado SSL no - portal de Desenvolvedor de iOS. O certificado, junto com -seu público e chave privada, é armazenado no Keychain Access. - - - - - - -É possível usar APNs de dois modos: - -* Modo de ambiente de simulação para desenvolvimento e teste. -* Modo de produção ao distribuir aplicativos por meio da App Store (ou outros mecanismos de distribuição da empresa). - -É necessário obter certificados separados para -seus ambientes de desenvolvimento e distribuição. Os certificados são -associados a um ID de app para o app que é o destinatário das -notificações remotas. Para produção, é possível criar até dois -certificados. O Bluemix usa os certificados para estabelecer uma -conexão SSL com APNs. - - - -1. Acesse o website [Apple Developer ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com){: new_window}, clique em **Member Center** e selecione **Certificates, Identifiers & Profiles**. -2. Na área **Identificadores**, clique em -**IDs de app**. -3. A partir da sua lista de IDs do app, selecione o seu ID do app e, em seguida, selecione -**Configurações**. -4. Na área **Serviço Push -Notifications**, crie um -certificado SSL de desenvolvimento e depois um certificado SSL de -produção. - - ![Certificados SSL de notificação push](images/certificate_createssl.jpg) - -5. Quando a **tela Sobre a criação de uma solicitação de assinatura -de certificado (CSR)** for exibida, inicie o aplicativo -**Keychain Access** em seu Mac para criar uma solicitação de -assinatura de certificado (CSR). -6. No menu, selecione **Keychain Access > Assistente de certificado > Solicitar um certificado de uma autoridade de certificação…** -7. Em **Informações de certificado**, insira o endereço de -e-mail associado à sua conta de Desenvolvedor de app e um nome comum. Forneça um nome -significativo que ajude a identificar se é um certificado para desenvolvimento (ambiente -de simulação) ou distribuição (produção); por exemplo, -*sandbox-apns-certificate* ou *production-apns-certificate*. -8. Selecione **Salvar no disco** para fazer download do arquivo -`.certSigningRequest` para sua área de trabalho e, em seguida, clique em -**Continuar**. -9. Na opção de menu **Salvar como**, nomeie o arquivo -`.certSigningRequest` e clique em **Salvar**. -10. Clique em **Pronto**. Agora você tem uma -CSR. -11. Retorne para a janela **Sobre como criar uma solicitação de -assinatura de certificado (CSR)** e clique em **Continuar**. -12. Na tela **Gerar**, clique em -**Escolher arquivo ... **e selecione o arquivo CSR -salvo em sua área de trabalho. Em seguida, clique em **Gerar**. - ![Gerar certificado -](images/generate_certificate.jpg) -13. Quando seu certificado estiver pronto, clique em -**Concluído**. -14. Na tela **Notificações push**, clique em -**Fazer download** para fazer download do seu certificado e depois -clique em **Concluído**. - ![Fazer download de certificado](images/certificate_download.jpg) -15. No Mac, acesse **Keychain Access > Meus certificados** e -localize seu certificado recém-instalado. Dê um clique duplo no certificado -para instalá-lo no Keychain Access. -16. Selecione o certificado e a chave privada; em seguida, selecione -**Exportar** para converter o certificado no formato de troca de -informações pessoais (formato `.p12`). - ![Exportar certificado e chaves](images/keychain_export_key.jpg) -17. No campo **Salvar como**, dê um nome significativo para o certificado. Por -exemplo, `sandbox_apns.p12_certifcate` ou -`production_apns.p12`; em seguida, clique em **Salvar**. - ![Exportar certificado e -chaves](images/certificate_p12v2.jpg) -18. No campo **Inserir uma senha**, insira -uma senha para proteger os itens exportados e clique em **OK**. É possível usar essa senha para configurar as definições do APNs no painel Push.{: #step18} - ![Exportar certificado e chaves](images/export_p12.jpg) -19. O **Key Access.app** solicita que -você exporte sua chave da tela **Keychain**. Insira sua senha -administrativa para seu Mac para permitir que o sistema exporte esses itens; em seguida, -selecione a opção **Sempre permitir**. Um certificado -`.p12` é gerado em sua área de trabalho. - - -##Criando um perfil de fornecimento de desenvolvimento -{: #create-push-credentials-dev-profile} - -O perfil de fornecimento funciona com o ID de app para -determinar quais dispositivos podem instalar e executar seu app e -quais serviços seu app pode acessar. Para cada ID de app, você cria -dois perfis de fornecimento: um para desenvolvimento e outro para -distribuição. Xcode usa o perfil de fornecimento de desenvolvimento -para determinar quais desenvolvedores podem criar o aplicativo e -quais dispositivos podem ser testados no aplicativo. - -Certifique-se de registrar um ID de app, de ativá-lo para o serviço {{site.data.keyword.mobilepushshort}} e de configurá-lo para -usar um certificado SSL APNs de desenvolvimento e produção. - -Crie um perfil de fornecimento de desenvolvimento, da seguinte forma: - -1. Acesse o portal [Apple Developer ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com){: new_window}, clique em **Member Center** e selecione **Certificates, Identifiers & Profiles**. -2. Acesse a [Mac Developer Library ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}, role até a seção **Creating Development Provisioning Profiles** e siga as instruções para criar um perfil de desenvolvimento. -**Nota**: Ao configurar um perfil de provisão de -desenvolvimento, selecione as opções a seguir: - * **iOS App Development** - * **Para apps iOS e watchOS ** - - - -##Criando um perfil de fornecimento de distribuição de -armazenamento -{: #create-push-credentials-apns-distribute_profile} - -Use o perfil de fornecimento de armazenamento para -enviar seu app para distribuição para a App Store. - -1. Acesse o portal [Apple Developer ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com){: new_window}, clique em **Member Center** e selecione **Certificates, Identifiers & Profiles**. -2. Dê um clique duplo no perfil de fornecimento -transferido por download para instalá-lo em Xcode. - -##Configurando o APNs no Painel {{site.data.keyword.mobilepushshort}} -{: #create-push-credentials-apns-dashboard} - -Para usar o serviço {{site.data.keyword.mobilepushshort}} para enviar notificações, faça upload dos certificados SSL necessários para o Apple Push Notification Service (APNs). A API REST também pode ser -usada para fazer upload de um certificado APNs. - - - -Os certificados necessários para APNs são certificados `.p12`. Esses certificados -contêm a chave privada e os certificados SSL que são necessários -para construir e publicar seu aplicativo. Deve-se gerar os certificados a partir do Member Center do -website do Apple Developer (para o qual é necessária uma conta válida do Apple Developer). São necessários certificados separados para o -ambiente de desenvolvimento (ambiente de -simulação) e para o ambiente de produção (distribuição). - -**Nota**: depois que o arquivo `.cer` estiver -em seu acesso de cadeia de chaves, exporte-o para seu computador para criar um -certificado `.p12`. - -Para obter mais informações sobre o uso de APNs, veja [iOS Developer Library: Local and Push Notification Programming Guide ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}. - -Para configurar os APNs no painel de serviços de Notificação push, conclua as etapas: - -1. Selecione **Configurar** no painel de -serviços de Notificação push. -2. Escolha a opção **Móvel** para atualizar -as informações no formulário **Credenciais push de -APNs**. -3. Selecione **Ambiente de simulação** -(desenvolvimento) ou **Produção** (distribuição) -conforme apropriado e, em seguida, faça upload do certificado -`p.12` que você criou, usando a -[etapa](#step18) anterior. - ![Configure o painel de notificações -push](images/wizard.jpg) -3. No campo **Senha**, insira a senha que está -associada ao arquivo de certificado `.p12`; em seguida, clique em -**Salvar**. - -Após o -upload bem-sucedido dos certificados com uma senha válida, é possível iniciar -o envio de notificações. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configurando credenciais para o APNs +{: #create-push-credentials-apns} +Última atualização: 16 de janeiro de 2017 +{: .last-updated} + +O Apple Push Notification Service (APNs) permite que os desenvolvedores de aplicativos enviem notificações remotas da instância do serviço {{site.data.keyword.mobilepushshort}} no Bluemix (o provedor) para dispositivos e aplicativos do iOS. Mensagens são enviadas para um aplicativo de +destino no dispositivo. + +Obtenha e configure suas credenciais APNs. Os certificados do APNs são gerenciados com segurança pelo serviço {{site.data.keyword.mobilepushshort}} e usados para se conectar ao servidor APNs como um provedor. + + + + + + +##Registrando um ID de app +{: #create-push-credentials-apns-register} + + +O ID de app (o identificador de pacote configurável) é um +identificador exclusivo que identifica um aplicativo específico. Cada +aplicativo requer um ID de app. Serviços, como o serviço {{site.data.keyword.mobilepushshort}}, são configurados para o ID do app. + +1. Certifique-se de ter uma conta do [Apple Developers ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com/){: new_window}. +2. Acesse o portal [Apple Developer ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com){: new_window}, clique em **Member Center** e selecione **Certificates, Identifiers & Profiles**. +3. Acesse a seção **Registering App IDs** na [Apple Developer Library ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window} e siga as instruções para registrar o ID do app. + +Ao registrar um ID do App, selecione as opções a seguir: + +* Notificações push ![Serviços de app](images/appID_appservices_enablepush.jpg) +* Sufixo de ID explícito +![ID explícito](images/appID_bundleID.jpg) +4. Crie um certificado SSL de APNs de desenvolvimento e +distribuição. + +##Crie um certificado SSL de APNs de desenvolvimento e distribuição +{: #create-push-credentials-apns-ssl} + +Antes de obter um certificado APNs, deve-se primeiro gerar uma solicitação de assinatura de certificado (CSR) e enviá-la para Apple, a autoridade de certificação (CA). A CSR contém informações que identificam sua empresa e suas chaves pública e privada usadas para assinar suas notificações push da Apple. Depois, gere o certificado SSL no + portal de Desenvolvedor de iOS. O certificado, junto com +seu público e chave privada, é armazenado no Keychain Access. + + + + + + +É possível usar APNs de dois modos: + +* Modo de ambiente de simulação para desenvolvimento e teste. +* Modo de produção ao distribuir aplicativos por meio da App Store (ou outros mecanismos de distribuição da empresa). + +É necessário obter certificados separados para +seus ambientes de desenvolvimento e distribuição. Os certificados são +associados a um ID de app para o app que é o destinatário das +notificações remotas. Para produção, é possível criar até dois +certificados. O Bluemix usa os certificados para estabelecer uma +conexão SSL com APNs. + + + +1. Acesse o website [Apple Developer ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com){: new_window}, clique em **Member Center** e selecione **Certificates, Identifiers & Profiles**. +2. Na área **Identificadores**, clique em +**IDs de app**. +3. A partir da sua lista de IDs do app, selecione o seu ID do app e, em seguida, selecione +**Configurações**. +4. Na área **Serviço Push +Notifications**, crie um +certificado SSL de desenvolvimento e depois um certificado SSL de +produção. + + ![Certificados SSL de notificação push](images/certificate_createssl.jpg) + +5. Quando a **tela Sobre a criação de uma solicitação de assinatura +de certificado (CSR)** for exibida, inicie o aplicativo +**Keychain Access** em seu Mac para criar uma solicitação de +assinatura de certificado (CSR). +6. No menu, selecione **Keychain Access > Assistente de certificado > Solicitar um certificado de uma autoridade de certificação…** +7. Em **Informações de certificado**, insira o endereço de +e-mail associado à sua conta de Desenvolvedor de app e um nome comum. Forneça um nome +significativo que ajude a identificar se é um certificado para desenvolvimento (ambiente +de simulação) ou distribuição (produção); por exemplo, +*sandbox-apns-certificate* ou *production-apns-certificate*. +8. Selecione **Salvar no disco** para fazer download do arquivo +`.certSigningRequest` para sua área de trabalho e, em seguida, clique em +**Continuar**. +9. Na opção de menu **Salvar como**, nomeie o arquivo +`.certSigningRequest` e clique em **Salvar**. +10. Clique em **Pronto**. Agora você tem uma +CSR. +11. Retorne para a janela **Sobre como criar uma solicitação de +assinatura de certificado (CSR)** e clique em **Continuar**. +12. Na tela **Gerar**, clique em +**Escolher arquivo ... **e selecione o arquivo CSR +salvo em sua área de trabalho. Em seguida, clique em **Gerar**. + ![Gerar certificado +](images/generate_certificate.jpg) +13. Quando seu certificado estiver pronto, clique em +**Concluído**. +14. Na tela **Notificações push**, clique em +**Fazer download** para fazer download do seu certificado e depois +clique em **Concluído**. + ![Fazer download de certificado](images/certificate_download.jpg) +15. No Mac, acesse **Keychain Access > Meus certificados** e +localize seu certificado recém-instalado. Dê um clique duplo no certificado +para instalá-lo no Keychain Access. +16. Selecione o certificado e a chave privada; em seguida, selecione +**Exportar** para converter o certificado no formato de troca de +informações pessoais (formato `.p12`). + ![Exportar certificado e chaves](images/keychain_export_key.jpg) +17. No campo **Salvar como**, dê um nome significativo para o certificado. Por +exemplo, `sandbox_apns.p12_certifcate` ou +`production_apns.p12`; em seguida, clique em **Salvar**. + ![Exportar certificado e +chaves](images/certificate_p12v2.jpg) +18. No campo **Inserir uma senha**, insira +uma senha para proteger os itens exportados e clique em **OK**. É possível usar essa senha para configurar as definições do APNs no painel Push.{: #step18} + ![Exportar certificado e chaves](images/export_p12.jpg) +19. O **Key Access.app** solicita que +você exporte sua chave da tela **Keychain**. Insira sua senha +administrativa para seu Mac para permitir que o sistema exporte esses itens; em seguida, +selecione a opção **Sempre permitir**. Um certificado +`.p12` é gerado em sua área de trabalho. + + +##Criando um perfil de fornecimento de desenvolvimento +{: #create-push-credentials-dev-profile} + +O perfil de fornecimento funciona com o ID de app para +determinar quais dispositivos podem instalar e executar seu app e +quais serviços seu app pode acessar. Para cada ID de app, você cria +dois perfis de fornecimento: um para desenvolvimento e outro para +distribuição. Xcode usa o perfil de fornecimento de desenvolvimento +para determinar quais desenvolvedores podem criar o aplicativo e +quais dispositivos podem ser testados no aplicativo. + +Certifique-se de registrar um ID de app, de ativá-lo para o serviço {{site.data.keyword.mobilepushshort}} e de configurá-lo para +usar um certificado SSL APNs de desenvolvimento e produção. + +Crie um perfil de fornecimento de desenvolvimento, da seguinte forma: + +1. Acesse o portal [Apple Developer ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com){: new_window}, clique em **Member Center** e selecione **Certificates, Identifiers & Profiles**. +2. Acesse a [Mac Developer Library ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}, role até a seção **Creating Development Provisioning Profiles** e siga as instruções para criar um perfil de desenvolvimento. +**Nota**: Ao configurar um perfil de provisão de +desenvolvimento, selecione as opções a seguir: + * **iOS App Development** + * **Para apps iOS e watchOS ** + + + +##Criando um perfil de fornecimento de distribuição de +armazenamento +{: #create-push-credentials-apns-distribute_profile} + +Use o perfil de fornecimento de armazenamento para +enviar seu app para distribuição para a App Store. + +1. Acesse o portal [Apple Developer ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com){: new_window}, clique em **Member Center** e selecione **Certificates, Identifiers & Profiles**. +2. Dê um clique duplo no perfil de fornecimento +transferido por download para instalá-lo em Xcode. + +##Configurando o APNs no Painel {{site.data.keyword.mobilepushshort}} +{: #create-push-credentials-apns-dashboard} + +Para usar o serviço {{site.data.keyword.mobilepushshort}} para enviar notificações, faça upload dos certificados SSL necessários para o Apple Push Notification Service (APNs). A API REST também pode ser +usada para fazer upload de um certificado APNs. + + + +Os certificados necessários para APNs são certificados `.p12`. Esses certificados +contêm a chave privada e os certificados SSL que são necessários +para construir e publicar seu aplicativo. Deve-se gerar os certificados a partir do Member Center do +website do Apple Developer (para o qual é necessária uma conta válida do Apple Developer). São necessários certificados separados para o +ambiente de desenvolvimento (ambiente de +simulação) e para o ambiente de produção (distribuição). + +**Nota**: depois que o arquivo `.cer` estiver +em seu acesso de cadeia de chaves, exporte-o para seu computador para criar um +certificado `.p12`. + +Para obter mais informações sobre o uso de APNs, veja [iOS Developer Library: Local and Push Notification Programming Guide ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}. + +Para configurar os APNs no painel de serviços de Notificação push, conclua as etapas: + +1. Selecione **Configurar** no painel de +serviços de Notificação push. +2. Escolha a opção **Móvel** para atualizar +as informações no formulário **Credenciais push de +APNs**. +3. Selecione **Ambiente de simulação** +(desenvolvimento) ou **Produção** (distribuição) +conforme apropriado e, em seguida, faça upload do certificado +`p.12` que você criou, usando a +[etapa](#step18) anterior. + ![Configure o painel de notificações +push](images/wizard.jpg) +3. No campo **Senha**, insira a senha que está +associada ao arquivo de certificado `.p12`; em seguida, clique em +**Salvar**. + +Após o +upload bem-sucedido dos certificados com uma senha válida, é possível iniciar +o envio de notificações. diff --git a/services/mobilepush/nl/pt/BR/t_push_provider_safari.md b/services/mobilepush/nl/pt/BR/t_push_provider_safari.md index da33b20ec..2a2c349d8 100644 --- a/services/mobilepush/nl/pt/BR/t_push_provider_safari.md +++ b/services/mobilepush/nl/pt/BR/t_push_provider_safari.md @@ -1,107 +1,107 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configurando credenciais para navegadores da web -{: #configure-credential-for-browsers} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - -Agora, o serviço IBM {{site.data.keyword.mobilepushshort}} estende os recursos para enviar notificações para seu navegador. - -A URL do website ou o nome de domínio de seu website é requerido pelo serviço {{site.data.keyword.mobilepushshort}} para identificar as solicitações que precisam ser permitidas. Uma instância do serviço {{site.data.keyword.mobilepushshort}} suporta somente um nome de domínio por vez. Portanto, assegure-se de que o mesmo valor seja configurado para o Chrome, Firefox e Safari. - -Os navegadores Chrome e Safari requerem configuração adicional para push da web. Você precisaria de uma chave de API do FCM, pois um terminal do FCM é usado para entregar mensagens no Chrome. Para obter sua chave de API do FCM, veja [Configurando credenciais para o FCM](t_push_provider_android.html). - - - -##Configurando para push da web do Chrome e do Firefox -{: #config-chrome-firefox} - -1. Na área do Painel push, selecione **Configurar**. -2. Selecione a guia Web. - ![Configuração de WebPush](images/webpush_configure.jpg) -3. Configure a chave API do FCM/GCM e a URL de seu website que estará registrada para receber notificações push. -4. Clique em **Salvar**. -5. Próximas etapas. [Ativando notificações para navegadores Google Chrome e Mozilla Firefox](c_enable_push.html). - - -## Configurando para push da web do Safari -{: #configure-safari} - -A versão suportada para o serviço {{site.data.keyword.mobilepushshort}} no Safari é 10.0. É necessário gerar um certificado por meio de sua conta do Apple Developer, antes de poder configurar o navegador para receber notificações. - -### Gerando um certificado -{: #certificate-generation} - -Assegure-se de ter uma conta do Apple Developer. É necessário -registrar um ID de push do website e gerar um certificado para -configurar o seu navegador Safari para receber notificações. As -etapas a seguir ajudarão na introdução. - -1. No centro de Membro de desenvolvedor Apple, clique em -**Certificados, ID e perfis**. -2. Clique em **Identificadores** e, sem -seguida, **IDs de push do website**. -3. Escolha criar uma nova entrada, selecionando o ícone de -mais. - ![painel Push](images/safari_1.jpg) - -4. No painel Registrar ID de push do website, forneça uma -descrição do ID de push do website e um ID do identificador -apropriados. É recomendado que esteja no formato de nome de domínio -reverso, começando com "web". Por exemplo: -web.com.example.dailyweatherreports. -5. Registre o ID de push do website. Agora, você tem seu ID de push do website. -6. Selecione **Editar** para criar um certificado a ser usado pelo ID de push do -website. -7. Na janela Assistente de certificado, forneça seu ID do -e-mail e um nome comum. Deixe o endereço de e-mail da Autoridade -de certificação em branco. -8. Clique em **Salvar em disco** e -selecione **Continuar**. -9. Escolha para salvar o certificado em uma pasta -apropriada. -10. Escolha `.certSigningRequest` criado no disco, quando solicitado, no assistente -para gerar o certificado. Certifique-se de fazer download do certificado de push do website criado no -formato `.cer`. -11. Abra o certificado na ferramenta KeyChain Access. Clique com o botão direito e exporte -como um certificado p12. Observe a senha fornecida durante a geração do certificado p12. - - -### Configurando para notificações - {: #configuration-notification} - -Após gerar o certificado, é possível configurar o serviço para enviar notificações para o Safari. - -Conclua estas etapas: - -1. No painel de serviço Notificações push, **clique em Configurar**. -2. Selecione a guia Web. -3. Na seção Push do Safari, atualize o formulário com as informações necessárias. - - **Nome do website**: este é o nome que você forneceu no centro de notificação. - - **ID de push do website**: atualize com a sequência de domínio reversa para seu -ID de push do website. Por exemplo, web.com.example.www. - - **URL do website**: forneça a URL do website que deve ser inscrita para -notificações push. Por exemplo, https://www.example.com. - - **Domínios permitidos**: este é parâmetro opcional. Esta é a lista de websites -que solicitam permissão do usuário. Certifique-se de que as URLs sejam valores separados por vírgula. Observe -que o valor na URL do website será usado se isso não for fornecido. - - **Sequência de formatações de URL**: a URL a ser resolvida quando a notificação é clicada. Por exemplo, ["https://www.example.com"]. Assegure-se de que a URL use o esquema HTTPS ou HTTP. - - **Certificado de push da web do Safari**: faça upload do -certificado .p12 e forneça a senha. -4. Clique em **Salvar**. - -![painel Push](images/push_configure_safari.jpg) - -Agora, você está configurado para enviar notificações push para o navegador Safari. - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configurando credenciais para navegadores da web +{: #configure-credential-for-browsers} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + +Agora, o serviço IBM {{site.data.keyword.mobilepushshort}} estende os recursos para enviar notificações para seu navegador. + +A URL do website ou o nome de domínio de seu website é requerido pelo serviço {{site.data.keyword.mobilepushshort}} para identificar as solicitações que precisam ser permitidas. Uma instância do serviço {{site.data.keyword.mobilepushshort}} suporta somente um nome de domínio por vez. Portanto, assegure-se de que o mesmo valor seja configurado para o Chrome, Firefox e Safari. + +Os navegadores Chrome e Safari requerem configuração adicional para push da web. Você precisaria de uma chave de API do FCM, pois um terminal do FCM é usado para entregar mensagens no Chrome. Para obter sua chave de API do FCM, veja [Configurando credenciais para o FCM](t_push_provider_android.html). + + + +##Configurando para push da web do Chrome e do Firefox +{: #config-chrome-firefox} + +1. Na área do Painel push, selecione **Configurar**. +2. Selecione a guia Web. + ![Configuração de WebPush](images/webpush_configure.jpg) +3. Configure a chave API do FCM/GCM e a URL de seu website que estará registrada para receber notificações push. +4. Clique em **Salvar**. +5. Próximas etapas. [Ativando notificações para navegadores Google Chrome e Mozilla Firefox](c_enable_push.html). + + +## Configurando para push da web do Safari +{: #configure-safari} + +A versão suportada para o serviço {{site.data.keyword.mobilepushshort}} no Safari é 10.0. É necessário gerar um certificado por meio de sua conta do Apple Developer, antes de poder configurar o navegador para receber notificações. + +### Gerando um certificado +{: #certificate-generation} + +Assegure-se de ter uma conta do Apple Developer. É necessário +registrar um ID de push do website e gerar um certificado para +configurar o seu navegador Safari para receber notificações. As +etapas a seguir ajudarão na introdução. + +1. No centro de Membro de desenvolvedor Apple, clique em +**Certificados, ID e perfis**. +2. Clique em **Identificadores** e, sem +seguida, **IDs de push do website**. +3. Escolha criar uma nova entrada, selecionando o ícone de +mais. + ![painel Push](images/safari_1.jpg) + +4. No painel Registrar ID de push do website, forneça uma +descrição do ID de push do website e um ID do identificador +apropriados. É recomendado que esteja no formato de nome de domínio +reverso, começando com "web". Por exemplo: +web.com.example.dailyweatherreports. +5. Registre o ID de push do website. Agora, você tem seu ID de push do website. +6. Selecione **Editar** para criar um certificado a ser usado pelo ID de push do +website. +7. Na janela Assistente de certificado, forneça seu ID do +e-mail e um nome comum. Deixe o endereço de e-mail da Autoridade +de certificação em branco. +8. Clique em **Salvar em disco** e +selecione **Continuar**. +9. Escolha para salvar o certificado em uma pasta +apropriada. +10. Escolha `.certSigningRequest` criado no disco, quando solicitado, no assistente +para gerar o certificado. Certifique-se de fazer download do certificado de push do website criado no +formato `.cer`. +11. Abra o certificado na ferramenta KeyChain Access. Clique com o botão direito e exporte +como um certificado p12. Observe a senha fornecida durante a geração do certificado p12. + + +### Configurando para notificações + {: #configuration-notification} + +Após gerar o certificado, é possível configurar o serviço para enviar notificações para o Safari. + +Conclua estas etapas: + +1. No painel de serviço Notificações push, **clique em Configurar**. +2. Selecione a guia Web. +3. Na seção Push do Safari, atualize o formulário com as informações necessárias. + - **Nome do website**: este é o nome que você forneceu no centro de notificação. + - **ID de push do website**: atualize com a sequência de domínio reversa para seu +ID de push do website. Por exemplo, web.com.example.www. + - **URL do website**: forneça a URL do website que deve ser inscrita para +notificações push. Por exemplo, https://www.example.com. + - **Domínios permitidos**: este é parâmetro opcional. Esta é a lista de websites +que solicitam permissão do usuário. Certifique-se de que as URLs sejam valores separados por vírgula. Observe +que o valor na URL do website será usado se isso não for fornecido. + - **Sequência de formatações de URL**: a URL a ser resolvida quando a notificação é clicada. Por exemplo, ["https://www.example.com"]. Assegure-se de que a URL use o esquema HTTPS ou HTTP. + - **Certificado de push da web do Safari**: faça upload do +certificado .p12 e forneça a senha. +4. Clique em **Salvar**. + +![painel Push](images/push_configure_safari.jpg) + +Agora, você está configurado para enviar notificações push para o navegador Safari. + + diff --git a/services/mobilepush/nl/pt/BR/t_push_tagsmain.md b/services/mobilepush/nl/pt/BR/t_push_tagsmain.md index 9e0663852..ade4b102f 100644 --- a/services/mobilepush/nl/pt/BR/t_push_tagsmain.md +++ b/services/mobilepush/nl/pt/BR/t_push_tagsmain.md @@ -1,25 +1,25 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Notificações baseadas em tag -{: #push-ios-main-tags} -Última atualização: 16 de janeiro de 2017 -{: .last-updated} - -As mensagens de notificação baseadas em tag se destinam a todos os dispositivos que estiverem inscritos em -uma tag específica. É possível -definir tags e depois enviar e receber mensagens usando - tags. - -Deve-se -primeiramente criar as identificações para o aplicativo, configurar as assinaturas da identificação -e, em seguida, iniciar as notificações baseadas em identificação. Para enviar uma notificação baseada em tag usando a [API de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}, assegure-se de que as "tagNames" sejam fornecidas ao postar no recurso de mensagem. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Notificações baseadas em tag +{: #push-ios-main-tags} +Última atualização: 16 de janeiro de 2017 +{: .last-updated} + +As mensagens de notificação baseadas em tag se destinam a todos os dispositivos que estiverem inscritos em +uma tag específica. É possível +definir tags e depois enviar e receber mensagens usando + tags. + +Deve-se +primeiramente criar as identificações para o aplicativo, configurar as assinaturas da identificação +e, em seguida, iniciar as notificações baseadas em identificação. Para enviar uma notificação baseada em tag usando a [API de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}, assegure-se de que as "tagNames" sejam fornecidas ao postar no recurso de mensagem. diff --git a/services/mobilepush/nl/pt/BR/t_restapi.md b/services/mobilepush/nl/pt/BR/t_restapi.md index fc94cc0d3..31fa0974e 100644 --- a/services/mobilepush/nl/pt/BR/t_restapi.md +++ b/services/mobilepush/nl/pt/BR/t_restapi.md @@ -1,129 +1,129 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Usando -APIs REST -{: #push-api-rest} -Última atualização: 16 de janeiro de 2017 -{: .last-updated} - -É possível usar uma API (interface de programação de aplicativos) REST (Representational State Transfer) para {{site.data.keyword.mobilepushshort}}. Também é possível usar o SDK e a [API de Push ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window} para desenvolver adicionalmente seus aplicativos clientes. - -Com a API REST de Push, aplicativos do servidor de backend e clientes podem acessar funções {{site.data.keyword.mobilepushshort}}. - -- Registros de dispositivo -- Registros -- Messages -- Subscriptions -- Marcações -- Webhooks - -Para obter a URL base para a API REST, conclua as etapas: - -1. Crie um aplicativo backend no catálogo do Bluemix® da seção Modelos escolhendo o MobileFirst Services Starter. Isso liga o serviço {{site.data.keyword.mobilepushshort}} ao aplicativo. Também é possível criar uma instância de serviço de Push e deixá-la sem limites. -1. Na página principal do painel Bluemix, acesse a área **Aplicativos** e, em seguida, selecione seu app. -3. Clique em **OPÇÕES MÓVEIS**. Os valores de GUID (Identificador Exclusivo Global) -de rota e de app são exibidos no início da página de detalhes do seu app. A tela Mostrar credenciais mostra -informações sobre o AppSecret. É possível obter o segredo do aplicativo em Opções móveis e também o segredo do cliente para algumas das APIs. - -Também é possível usar a linha de comandos para obter as credenciais de serviço: - -``` - cf create-service-key {push_instance_name} {key_name} - - cf service-key {push_instance_name} {key_name} -``` - {: codeblock} - -## Aceitar cabeçalho do idioma -{: #push-api-rest-accept} - -O cabeçalho "Accept-Language" especifica qual idioma usar para as mensagens de erro que são produzidas pela [API de REST Push ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. Os idiomas a seguir são suportados para as mensagens de erro: chinês (simplificado), chinês (tradicional), inglês (EUA), alemão, francês, italiano, japonês, coreano, português e espanhol. - -## appSecret -{: #push-api-rest-secret} - -Quando um aplicativo é ligado ao {{site.data.keyword.mobilepushshort}}, o serviço gera um appSecret (uma chave exclusiva) e passa-o no cabeçalho de resposta. Se -você estiver usando a API de REST do IBM {{site.data.keyword.mobilepushshort}} for Bluemix, use a referência da API de REST para obter informações sobre quais -APIs você precisa assegurar. Para obter informações, veja a [API de REST Push ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. - -O cabeçalho da solicitação deve conter o appSecret. Caso contrário, o servidor retornará um código de erro 401 Desautorizado. Quando o {{site.data.keyword.mobilepushshort}} é incluído em um aplicativo, um AppID específico é criado. Como parte da resposta, você obtém um cabeçalho chamado appSecret que é usado para criar tags ou enviar -mensagens. A operação acontece por meio de serviços no catálogo ou do modelo. - -Para obter o valor appSecret: - -1. Clique no* app-name* que está ligado ao serviço de push. -2. Clique no link **Mostrar credenciais** para exibir o appSecret (AppID). - -A tela **Mostrar credenciais** mostra informações sobre o AppSecret: -``` - { - "imfpush_Dev": [ - { - "name": "testapp1", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": { - "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", - "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", - "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", - } - } - ] - } -``` - {: codeblock} - - -##Filtros de API REST de Push -{: #push-api-rest-filters} - -Filtros definem um critério de procura que restringe os dados retornados de uma API GET de {{site.data.keyword.mobilepushshort}}. Aplique os filtros no resultado da operação Get que deseja filtrar. O filtro restringe o número de entradas incluídas no resultado. Por exemplo, é possível usar um filtro para procurar tags iniciadas com "test". - -É possível gerar filtros usando a sintaxe a seguir: - -**nome**: o nome do campo no qual o filtro está sendo aplicado. - -**operador**: == (correspondência exata) ou =@ (contém -subsequência) que descreve a correspondência de filtro a ser usada. - -**expressão**: os valores a serem incluídos no resultado. - -Quando uma vírgula e uma barra invertida são exibidas em uma expressão, elas devem ser escapadas com barra invertida. - -Ao usar múltiplos filtros, eles podem ser combinados usando as lógicas AND e OR. - -- Para a lógica AND, use vários filtros na consulta. -- Para a lógica OR, use uma vírgula (,) dentro da expressão de filtro. -- Para as lógicas AND e OR: uma única consulta pode ter a lógica AND e OR. Cada filtro é avaliado individualmente antes que os filtros sejam combinados em uma expressão AND. - -Para a API GET do dispositivo, as combinações a seguir são suportadas: - O nome é o campo de plataforma. -- Exceto para a plataforma, o operador pode ser == ou =@ -- Para a plataforma, o operador deve ser ==. Se o operador =@ for usado, o valor poderá ser uma subsequência. -- Se == for usado, o valor deverá ser uma sequência correspondente exata. - -Para a API GET da assinatura, as combinações a seguir são suportadas: - -- O nome pode ser um destes campos: tagName ou deviceId -- Exceto para a plataforma, o operador pode ser == ou =@ -- Para a plataforma, o operador deve ser == -- Se o operador =@ for usado, o valor poderá ser uma subsequência. Se o operador == for usado, o valor deverá ser uma sequência de correspondência exata. -- Para a API GET de identificação, as combinações a seguir são suportadas: -- O nome pode ser um destes campos: “name” ou “description” -- Se o operador =@ for usado, o valor poderá ser uma subsequência. -- Se == for usado, o valor deverá ser uma sequência correspondente exata. - - -##Códigos de resposta do {{site.data.keyword.mobilepushshort}} -{: #push-api-response-codes} - -Status: 405 Método não permitido - Método apropriado esperado. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Usando +APIs REST +{: #push-api-rest} +Última atualização: 16 de janeiro de 2017 +{: .last-updated} + +É possível usar uma API (interface de programação de aplicativos) REST (Representational State Transfer) para {{site.data.keyword.mobilepushshort}}. Também é possível usar o SDK e a [API de Push ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window} para desenvolver adicionalmente seus aplicativos clientes. + +Com a API REST de Push, aplicativos do servidor de backend e clientes podem acessar funções {{site.data.keyword.mobilepushshort}}. + +- Registros de dispositivo +- Registros +- Messages +- Subscriptions +- Marcações +- Webhooks + +Para obter a URL base para a API REST, conclua as etapas: + +1. Crie um aplicativo backend no catálogo do Bluemix® da seção Modelos escolhendo o MobileFirst Services Starter. Isso liga o serviço {{site.data.keyword.mobilepushshort}} ao aplicativo. Também é possível criar uma instância de serviço de Push e deixá-la sem limites. +1. Na página principal do painel Bluemix, acesse a área **Aplicativos** e, em seguida, selecione seu app. +3. Clique em **OPÇÕES MÓVEIS**. Os valores de GUID (Identificador Exclusivo Global) +de rota e de app são exibidos no início da página de detalhes do seu app. A tela Mostrar credenciais mostra +informações sobre o AppSecret. É possível obter o segredo do aplicativo em Opções móveis e também o segredo do cliente para algumas das APIs. + +Também é possível usar a linha de comandos para obter as credenciais de serviço: + +``` + cf create-service-key {push_instance_name} {key_name} + + cf service-key {push_instance_name} {key_name} +``` + {: codeblock} + +## Aceitar cabeçalho do idioma +{: #push-api-rest-accept} + +O cabeçalho "Accept-Language" especifica qual idioma usar para as mensagens de erro que são produzidas pela [API de REST Push ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. Os idiomas a seguir são suportados para as mensagens de erro: chinês (simplificado), chinês (tradicional), inglês (EUA), alemão, francês, italiano, japonês, coreano, português e espanhol. + +## appSecret +{: #push-api-rest-secret} + +Quando um aplicativo é ligado ao {{site.data.keyword.mobilepushshort}}, o serviço gera um appSecret (uma chave exclusiva) e passa-o no cabeçalho de resposta. Se +você estiver usando a API de REST do IBM {{site.data.keyword.mobilepushshort}} for Bluemix, use a referência da API de REST para obter informações sobre quais +APIs você precisa assegurar. Para obter informações, veja a [API de REST Push ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. + +O cabeçalho da solicitação deve conter o appSecret. Caso contrário, o servidor retornará um código de erro 401 Desautorizado. Quando o {{site.data.keyword.mobilepushshort}} é incluído em um aplicativo, um AppID específico é criado. Como parte da resposta, você obtém um cabeçalho chamado appSecret que é usado para criar tags ou enviar +mensagens. A operação acontece por meio de serviços no catálogo ou do modelo. + +Para obter o valor appSecret: + +1. Clique no* app-name* que está ligado ao serviço de push. +2. Clique no link **Mostrar credenciais** para exibir o appSecret (AppID). + +A tela **Mostrar credenciais** mostra informações sobre o AppSecret: +``` + { + "imfpush_Dev": [ + { + "name": "testapp1", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": { + "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", + "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", + "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", + } + } + ] + } +``` + {: codeblock} + + +##Filtros de API REST de Push +{: #push-api-rest-filters} + +Filtros definem um critério de procura que restringe os dados retornados de uma API GET de {{site.data.keyword.mobilepushshort}}. Aplique os filtros no resultado da operação Get que deseja filtrar. O filtro restringe o número de entradas incluídas no resultado. Por exemplo, é possível usar um filtro para procurar tags iniciadas com "test". + +É possível gerar filtros usando a sintaxe a seguir: + +**nome**: o nome do campo no qual o filtro está sendo aplicado. + +**operador**: == (correspondência exata) ou =@ (contém +subsequência) que descreve a correspondência de filtro a ser usada. + +**expressão**: os valores a serem incluídos no resultado. + +Quando uma vírgula e uma barra invertida são exibidas em uma expressão, elas devem ser escapadas com barra invertida. + +Ao usar múltiplos filtros, eles podem ser combinados usando as lógicas AND e OR. + +- Para a lógica AND, use vários filtros na consulta. +- Para a lógica OR, use uma vírgula (,) dentro da expressão de filtro. +- Para as lógicas AND e OR: uma única consulta pode ter a lógica AND e OR. Cada filtro é avaliado individualmente antes que os filtros sejam combinados em uma expressão AND. + +Para a API GET do dispositivo, as combinações a seguir são suportadas: - O nome é o campo de plataforma. +- Exceto para a plataforma, o operador pode ser == ou =@ +- Para a plataforma, o operador deve ser ==. Se o operador =@ for usado, o valor poderá ser uma subsequência. +- Se == for usado, o valor deverá ser uma sequência correspondente exata. + +Para a API GET da assinatura, as combinações a seguir são suportadas: + +- O nome pode ser um destes campos: tagName ou deviceId +- Exceto para a plataforma, o operador pode ser == ou =@ +- Para a plataforma, o operador deve ser == +- Se o operador =@ for usado, o valor poderá ser uma subsequência. Se o operador == for usado, o valor deverá ser uma sequência de correspondência exata. +- Para a API GET de identificação, as combinações a seguir são suportadas: +- O nome pode ser um destes campos: “name” ou “description” +- Se o operador =@ for usado, o valor poderá ser uma subsequência. +- Se == for usado, o valor deverá ser uma sequência correspondente exata. + + +##Códigos de resposta do {{site.data.keyword.mobilepushshort}} +{: #push-api-response-codes} + +Status: 405 Método não permitido - Método apropriado esperado. diff --git a/services/mobilepush/nl/pt/BR/t_sandbox.md b/services/mobilepush/nl/pt/BR/t_sandbox.md index 6cb9dc9ec..91b2e2441 100644 --- a/services/mobilepush/nl/pt/BR/t_sandbox.md +++ b/services/mobilepush/nl/pt/BR/t_sandbox.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Modos de ambiente de simulação e de produção -{: #push-sandboxandproduction-modes} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - -É possível usar o {{site.data.keyword.mobilepushshort}} em um dos modos a seguir: ambiente de -simulação ou produção. Ambiente de simulação é um ambiente de teste autocontido para desenvolver e testar a integração de API push com o serviço de push do aplicativo do servidor. - -Configure os modos de ambiente de simulação e produção usando o painel Push. É possível alternar entre o modo de operações de serviço de push, entre o ambiente de simulação e produção usando a [API de REST de Push](https://mobile.{DomainName}/imfpush/){: new_window}. Por padrão, o -modo de ambiente de simulação é ativado. No entanto, ao alternar entre os modos, as tags, os dispositivos e as assinaturas não são compartilhados entre esses modos. - -Quando você estiver pronto para implementar o aplicativo em um ambiente de produção, selecione o modo PRODUÇÃO usando a [API de REST de Push](https://mobile.{DomainName}/imfpush/){: new_window}. - -Para alternar o modo de operação do serviço de push de ambiente de simulação para produção: - -1. Use a chamada de API REST PUT ApplicationID Settings -2. No corpo de JSON, confirme se o modo foi alternado usando a chamada de API [GET ApplicationID Settings REST](https://mobile.{DomainName}/imfpush/){: new_window}. A resposta esperada é "mode": "PRODUCTION -```{ - "mode": "PRODUCTION" - } -``` - {: codeblock} -1. Depois de ter alternado seu modo de ambiente, execute o código do cliente novamente para registrar seu dispositivo no modo de PRODUÇÃO. - -Para obter informações sobre a API REST, consulte [Usando APIs REST](t_restapi.html). +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Modos de ambiente de simulação e de produção +{: #push-sandboxandproduction-modes} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + +É possível usar o {{site.data.keyword.mobilepushshort}} em um dos modos a seguir: ambiente de +simulação ou produção. Ambiente de simulação é um ambiente de teste autocontido para desenvolver e testar a integração de API push com o serviço de push do aplicativo do servidor. + +Configure os modos de ambiente de simulação e produção usando o painel Push. É possível alternar entre o modo de operações de serviço de push, entre o ambiente de simulação e produção usando a [API de REST de Push](https://mobile.{DomainName}/imfpush/){: new_window}. Por padrão, o +modo de ambiente de simulação é ativado. No entanto, ao alternar entre os modos, as tags, os dispositivos e as assinaturas não são compartilhados entre esses modos. + +Quando você estiver pronto para implementar o aplicativo em um ambiente de produção, selecione o modo PRODUÇÃO usando a [API de REST de Push](https://mobile.{DomainName}/imfpush/){: new_window}. + +Para alternar o modo de operação do serviço de push de ambiente de simulação para produção: + +1. Use a chamada de API REST PUT ApplicationID Settings +2. No corpo de JSON, confirme se o modo foi alternado usando a chamada de API [GET ApplicationID Settings REST](https://mobile.{DomainName}/imfpush/){: new_window}. A resposta esperada é "mode": "PRODUCTION +```{ + "mode": "PRODUCTION" + } +``` + {: codeblock} +1. Depois de ter alternado seu modo de ambiente, execute o código do cliente novamente para registrar seu dispositivo no modo de PRODUÇÃO. + +Para obter informações sobre a API REST, consulte [Usando APIs REST](t_restapi.html). diff --git a/services/mobilepush/nl/pt/BR/t_send_push_notifications.md b/services/mobilepush/nl/pt/BR/t_send_push_notifications.md index 787a0345b..584bdd189 100644 --- a/services/mobilepush/nl/pt/BR/t_send_push_notifications.md +++ b/services/mobilepush/nl/pt/BR/t_send_push_notifications.md @@ -1,41 +1,41 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Enviando notificações push básicas -{: #push-send-notifications} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - -Depois de desenvolver seus aplicativos, é possível enviar notificações push básicas (sem usar tags, badges, cargas úteis adicionais ou arquivos de som). - -Para enviar notificações push básicas, conclua as etapas listadas: - -1. Selecione **Enviar notificações** e depois escolha a opção -**Enviar para** apropriada. - -**Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para {{site.data.keyword.mobilepushshort}} receberão notificações. - -![Tela de notificações](images/tag_notification.jpg) -2. No campo **Mensagem**, insira sua mensagem e, em seguida, -clique em **Enviar**. - -3. Verifique se seus dispositivos receberam sua notificação. A imagem a seguir -mostra uma caixa de alerta que manipula um {{site.data.keyword.mobilepushshort}} -no primeiro plano em um dispositivo Android e iOS. - -![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) - -![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) - -A captura de tela a seguir mostra um {{site.data.keyword.mobilepushshort}} no plano de fundo para Android. - -![Notificação push no plano de fundo no Android](images/background.jpg) +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Enviando notificações push básicas +{: #push-send-notifications} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + +Depois de desenvolver seus aplicativos, é possível enviar notificações push básicas (sem usar tags, badges, cargas úteis adicionais ou arquivos de som). + +Para enviar notificações push básicas, conclua as etapas listadas: + +1. Selecione **Enviar notificações** e depois escolha a opção +**Enviar para** apropriada. + +**Nota**: ao selecionar a opção **Todos os dispositivos**, todos os dispositivos inscritos para {{site.data.keyword.mobilepushshort}} receberão notificações. + +![Tela de notificações](images/tag_notification.jpg) +2. No campo **Mensagem**, insira sua mensagem e, em seguida, +clique em **Enviar**. + +3. Verifique se seus dispositivos receberam sua notificação. A imagem a seguir +mostra uma caixa de alerta que manipula um {{site.data.keyword.mobilepushshort}} +no primeiro plano em um dispositivo Android e iOS. + +![Notificação push em primeiro plano no Android](images/Android_Screenshot.jpg) + +![Notificação push em primeiro plano no iOS](images/iOS_Screenshot.jpg) + +A captura de tela a seguir mostra um {{site.data.keyword.mobilepushshort}} no plano de fundo para Android. + +![Notificação push no plano de fundo no Android](images/background.jpg) diff --git a/services/mobilepush/nl/pt/BR/t_service_instance.md b/services/mobilepush/nl/pt/BR/t_service_instance.md index bd49ede80..29d9ade1e 100644 --- a/services/mobilepush/nl/pt/BR/t_service_instance.md +++ b/services/mobilepush/nl/pt/BR/t_service_instance.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Criando uma instância de serviço de push -{: #create-push-instance} - -Para uma introdução ao {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, primeiro, deve-se criar um aplicativo {{site.data.keyword.Bluemix}}; por exemplo, um app Node.js. Em seguida, deve-se criar uma instância de um serviço Push, {{site.data.keyword.mobilepushfull}}, que precisa ser vinculado a este aplicativo Bluemix. É possível também fazer isso acessando a seção Modelo do catálogo do Bluemix e clicando no Iniciador de serviços MobileFirst. - -**Nota**: Se você configurou organizações para gerenciar seu ambiente, selecione a organização na qual deseja criar o tempo de execução e os serviços para seu app móvel. - - -1. Se você não tiver um aplicativo Bluemix, será necessário criar um; por exemplo, o app Node.js. Para criar um aplicativo Bluemix, acesse o painel do Bluemix e clique em **Criar app**. - - **Nota**: Se você tiver um aplicativo, acesse a etapa 7 para incluir um serviço.![Criar uma instância de serviço](images/create_service_instance1.jpg "Criar uma instância de serviço") - -1. Em **Escolher seu modelo de app**, clique em **WEB** - -3. Na área **Escolher ponto de início**, selecione **SDK for Node.js** e clique em **CONTINUE**.![Ponto de início](images/create_service_nodejs2.jpg) - -4. No menu suspenso **Espaço**, selecione o espaço da organização. - - ![ -Selecione espaço da organização](images/create_a_service3.jpg) -1. Em **Nome**, insira o nome de seu app e no host, insira o nome do host. - -1. No menu suspenso **Plano selecionado**, selecione um plano e depois clique no botão **CRIAR**. Aguarde até que o aplicativo entre no estágio. - -1. Clique no link **Visão geral**.![Incluir um serviço](images/create_service_add4.jpg) -1. Clique em **Incluir um serviço** . A tela CATALOG é exibida. - -1. Selecione **IBM Push Notifications:** e, no menu suspenso **Espaço**, selecione a organização. - - ![Menu suspenso do espaço da organização](images/create_service_org.jpg) -1. No nome **Serviço**, insira o nome do serviço de notificação push. - -1. Em **Plano selecionado**, selecione um plano e clique no botão **CRIAR**. - -1. Clique em **Sim** para remontar o aplicativo. - - ![IBM Push Notification Service](images/create_service_notification5.jpg) - -1. Clique em **Notificações push** para exibir o painel Notificação push. +--- + +copyright: + years: 2015, 2016 + +--- + +# Criando uma instância de serviço de push +{: #create-push-instance} + +Para uma introdução ao {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}, primeiro, deve-se criar um aplicativo {{site.data.keyword.Bluemix}}; por exemplo, um app Node.js. Em seguida, deve-se criar uma instância de um serviço Push, {{site.data.keyword.mobilepushfull}}, que precisa ser vinculado a este aplicativo Bluemix. É possível também fazer isso acessando a seção Modelo do catálogo do Bluemix e clicando no Iniciador de serviços MobileFirst. + +**Nota**: Se você configurou organizações para gerenciar seu ambiente, selecione a organização na qual deseja criar o tempo de execução e os serviços para seu app móvel. + + +1. Se você não tiver um aplicativo Bluemix, será necessário criar um; por exemplo, o app Node.js. Para criar um aplicativo Bluemix, acesse o painel do Bluemix e clique em **Criar app**. + + **Nota**: Se você tiver um aplicativo, acesse a etapa 7 para incluir um serviço.![Criar uma instância de serviço](images/create_service_instance1.jpg "Criar uma instância de serviço") + +1. Em **Escolher seu modelo de app**, clique em **WEB** + +3. Na área **Escolher ponto de início**, selecione **SDK for Node.js** e clique em **CONTINUE**.![Ponto de início](images/create_service_nodejs2.jpg) + +4. No menu suspenso **Espaço**, selecione o espaço da organização. + + ![ +Selecione espaço da organização](images/create_a_service3.jpg) +1. Em **Nome**, insira o nome de seu app e no host, insira o nome do host. + +1. No menu suspenso **Plano selecionado**, selecione um plano e depois clique no botão **CRIAR**. Aguarde até que o aplicativo entre no estágio. + +1. Clique no link **Visão geral**.![Incluir um serviço](images/create_service_add4.jpg) +1. Clique em **Incluir um serviço** . A tela CATALOG é exibida. + +1. Selecione **IBM Push Notifications:** e, no menu suspenso **Espaço**, selecione a organização. + + ![Menu suspenso do espaço da organização](images/create_service_org.jpg) +1. No nome **Serviço**, insira o nome do serviço de notificação push. + +1. Em **Plano selecionado**, selecione um plano e clique no botão **CRIAR**. + +1. Clique em **Sim** para remontar o aplicativo. + + ![IBM Push Notification Service](images/create_service_notification5.jpg) + +1. Clique em **Notificações push** para exibir o painel Notificação push. diff --git a/services/mobilepush/nl/pt/BR/t_subscribe_tags.md b/services/mobilepush/nl/pt/BR/t_subscribe_tags.md index 86a6fe832..9fb3c4bf4 100644 --- a/services/mobilepush/nl/pt/BR/t_subscribe_tags.md +++ b/services/mobilepush/nl/pt/BR/t_subscribe_tags.md @@ -1,135 +1,135 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Assinando e removendo assinatura de tags -{: #Subscribe_tags} - -Use os fragmentos de código a seguir para permitir que seus dispositivos obtenham -assinaturas, bem como assinem e cancelem a assinatura de uma tag. - -## Android - -Copie e cole este fragmento de código em seu -aplicativo móvel Android. - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - -## Cordova - -Copie e cole este fragmento de código em seu aplicativo móvel -Cordova. - -``` -var tag = "YourTag"; -MFPPush.subscribe(tag, success, failure); -MFPPush.unsubscribe(tag, success, failure); -``` - -## Objective-C - -Copie e cole este fragmento de código em seu aplicativo móvel -Objective-C. - -Use a API **subscribeToTags** para assinar uma -identificação. - -``` -[push subscribeToTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - }else{ - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response subscribeStatus]; - [self updateMessage:@"Parsed subscribe status is:"]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -Use a API **unsubscribeFromTags** para cancelar a assinatura de uma -identificação. - -``` -[push unsubscribeFromTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if (error){ - [self updateMessage:error.description]; - } else { - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response unsubscribeStatus]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -## Swift - -Copie e cole este fragmento de código em seu aplicativo móvel -Swift. - -**Assinar tags disponíveis** - -Use a API **subscribeToTags** para assinar uma -identificação. - -``` -push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in - if (error != nil) { - //error while subscribing to tags - } else { - //successfully subscribed to tags var subStatus = response.subscribeStatus(); - } -} -``` - -**Cancelar assinatura de tags** - -Use a API **unsubscribeFromTags** para cancelar a assinatura de uma -identificação. - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - - if error.isEmpty { - print( "Response during unsubscribed tags : \(response.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# Assinando e removendo assinatura de tags +{: #Subscribe_tags} + +Use os fragmentos de código a seguir para permitir que seus dispositivos obtenham +assinaturas, bem como assinem e cancelem a assinatura de uma tag. + +## Android + +Copie e cole este fragmento de código em seu +aplicativo móvel Android. + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + +## Cordova + +Copie e cole este fragmento de código em seu aplicativo móvel +Cordova. + +``` +var tag = "YourTag"; +MFPPush.subscribe(tag, success, failure); +MFPPush.unsubscribe(tag, success, failure); +``` + +## Objective-C + +Copie e cole este fragmento de código em seu aplicativo móvel +Objective-C. + +Use a API **subscribeToTags** para assinar uma +identificação. + +``` +[push subscribeToTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + }else{ + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response subscribeStatus]; + [self updateMessage:@"Parsed subscribe status is:"]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +Use a API **unsubscribeFromTags** para cancelar a assinatura de uma +identificação. + +``` +[push unsubscribeFromTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if (error){ + [self updateMessage:error.description]; + } else { + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response unsubscribeStatus]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +## Swift + +Copie e cole este fragmento de código em seu aplicativo móvel +Swift. + +**Assinar tags disponíveis** + +Use a API **subscribeToTags** para assinar uma +identificação. + +``` +push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in + if (error != nil) { + //error while subscribing to tags + } else { + //successfully subscribed to tags var subStatus = response.subscribeStatus(); + } +} +``` + +**Cancelar assinatura de tags** + +Use a API **unsubscribeFromTags** para cancelar a assinatura de uma +identificação. + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + + if error.isEmpty { + print( "Response during unsubscribed tags : \(response.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` diff --git a/services/mobilepush/nl/pt/BR/t_use_tags.md b/services/mobilepush/nl/pt/BR/t_use_tags.md index 289ffd888..aec42cceb 100644 --- a/services/mobilepush/nl/pt/BR/t_use_tags.md +++ b/services/mobilepush/nl/pt/BR/t_use_tags.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# Usando notificações baseada em tag -{: #using_tags} - - -Notificações baseadas em tag são mensagens de -notificação que se destinam a todos os dispositivos inscritos -em uma tag específica. Cada dispositivo pode ser inscrito em qualquer número de tags. Esta seção -descreve como enviar notificações baseadas em tag. As assinaturas são mantidas pela -instância do Bluemix do serviço de notificação push. Quando uma tag é excluída, todas as informações associadas a -ela, incluindo seus assinantes e dispositivos são excluídos. Nenhum cancelamento de assinatura automático é necessário para essa tag, uma vez que ela -não existe mais e nenhuma ação adicional é necessária no lado do cliente. - -**Antes de começar** - -Crie tags na tela **Tag**. Para obter informações sobre como -criar tags, consulte -[Criando tags](t_manage_tags.html). - -1. A partir do painel **Notificação push**, -clique na guia **Notificações**. -1. Selecione a opção **Tags** para enviar notificações baseadas -em tag. -1. No campo **Procurar** tags, procure pelas tags que deseja -usar e clique no botão -**+Incluir**.![Tela -Notificações](images/tag_notification.jpg) -1. Acesse a área **Criar suas notificações **, e -no campo **Texto da mensagem**, -insira o texto que deseja enviar em sua notificação. -1. Clique no botão **Enviar**. +--- + +copyright: + years: 2015, 2016 + +--- + +# Usando notificações baseada em tag +{: #using_tags} + + +Notificações baseadas em tag são mensagens de +notificação que se destinam a todos os dispositivos inscritos +em uma tag específica. Cada dispositivo pode ser inscrito em qualquer número de tags. Esta seção +descreve como enviar notificações baseadas em tag. As assinaturas são mantidas pela +instância do Bluemix do serviço de notificação push. Quando uma tag é excluída, todas as informações associadas a +ela, incluindo seus assinantes e dispositivos são excluídos. Nenhum cancelamento de assinatura automático é necessário para essa tag, uma vez que ela +não existe mais e nenhuma ação adicional é necessária no lado do cliente. + +**Antes de começar** + +Crie tags na tela **Tag**. Para obter informações sobre como +criar tags, consulte +[Criando tags](t_manage_tags.html). + +1. A partir do painel **Notificação push**, +clique na guia **Notificações**. +1. Selecione a opção **Tags** para enviar notificações baseadas +em tag. +1. No campo **Procurar** tags, procure pelas tags que deseja +usar e clique no botão +**+Incluir**.![Tela +Notificações](images/tag_notification.jpg) +1. Acesse a área **Criar suas notificações **, e +no campo **Texto da mensagem**, +insira o texto que deseja enviar em sua notificação. +1. Clique no botão **Enviar**. diff --git a/services/mobilepush/nl/pt/BR/tr_error_push.md b/services/mobilepush/nl/pt/BR/tr_error_push.md index cf96ff8ed..79c34fede 100644 --- a/services/mobilepush/nl/pt/BR/tr_error_push.md +++ b/services/mobilepush/nl/pt/BR/tr_error_push.md @@ -1,228 +1,228 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Mensagens de erro -de serviço {{site.data.keyword.mobilepushshort}} -{: #errors} -Última atualização: 13 de fevereiro de 2017 -{: .last-updated} - - -As mensagens de erro de {{site.data.keyword.mobilepushshort}} a seguir são retornadas em resposta a solicitações da API REST. - -Resposta de erro de amostra: -``` - { - "message": "Missing APNs credentials", - "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", - "code": "FPWSE0003E" - } -``` - {: codeblock} - -Para obter informações adicionais sobre um erro, procure nos -docs o código de erro relacionado. - -## FPWSE0001E -{: #error_fpwse0001e} - -**Explicação**: o recurso que você está tentando consultar, como uma -tag ou assinatura, não está disponível no servidor. - -**Resposta do usuário**: crie o recurso que foi relatado na mensagem. Como alternativa, é possível fornecer o identificador -correto para consultar o recurso. - - -## FPWSE0002E -{: #error_fpwse0002e} - -**Explicação**: o recurso que você está tentando criar já está disponível no servidor. O -recurso pode ser uma identificação, uma assinatura, etc. - -**Resposta do usuário**: crie o recurso com um identificador diferente. - - -## FPWSE0003E -{: #error_fpwse0003e} - -**Explicação**: a configuração de pré-requisito para o serviço {{site.data.keyword.mobilepushshort}} não foi concluída. É possível -que você esteja tentando obter as credenciais de Apple Push Notification service (APNs) antes de elas serem -configuradas. - -**Resposta do usuário**: assegure-se de que o serviço -{{site.data.keyword.mobilepushshort}} -tenha sido configurado com certificados de segurança válidos para APNs. Para obter mais informações, veja [Configurando credenciais para APNs ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](t_push_provider_ios.html){: new_window}. - - -## FPWSE0004E -{: #error_fpwse0004e} - -**Explicação**: o corpo de JSON incluído na solicitação não é válido. - - -**Resposta do usuário**: assegure-se de usar uma sintaxe válida de JSON na -solicitação. - - - -## FPWSE0005E -{: #error_fpwse0005e} - -**Explicação**: a solicitação para o servidor -{{site.data.keyword.mobilepushshort}} está incorreta ou incompleta, -pois o corpo de JSON não contém os valores de propriedade necessários para concluir a solicitação de API. Por exemplo, uma senha não é válida ou -um token de dispositivo está ausente. - - -**Resposta do usuário**: revise a mensagem para saber qual valor de propriedade está -ausente ou não é válido e, em seguida, forneça as informações necessárias. - - - -## FPWSE0006E -{: #error_fpwse0006e} - -**Explicação**: o corpo de JSON da solicitação possui parâmetros que o servidor -{{site.data.keyword.mobilepushshort}} não entende. - - -**Resposta do usuário**: verifique se o corpo de JSON na solicitação segue o -formato da solicitação que é esperado pelo servidor {{site.data.keyword.mobilepushshort}}. Para obter mais informações, veja [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0007E -{: #error_fpwse0007e} - -**Explicação**: a URL de solicitação possui uma sequência de consultas com parâmetros -não reconhecidos. Por exemplo, se a solicitação para excluir a assinatura tiver parâmetros diferentes de deviceId e tagName, esse erro poderá ocorrer. - - -**Resposta do usuário**: verifique se o corpo de JSON na solicitação segue o formato -da solicitação que é esperado pelo servidor {{site.data.keyword.mobilepushshort}}. Para obter mais informações, veja [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0008E -{: #error_fpwse0008e} - -**Explicação**: a URL de solicitação possui uma sequência de consultas com parâmetros -ausentes. Por exemplo, os parâmetros deviceId e tagName podem estar ausentes na solicitação para excluir a assinatura. - - -**Resposta do usuário**: verifique se o corpo de JSON na solicitação segue o formato -da solicitação que é esperado pelo servidor {{site.data.keyword.mobilepushshort}}. Para obter mais informações, veja [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. - - - -## FPWSE0009E -{: #error_fpwse0009e} - -**Explicação**: foi feita uma tentativa para enviar notificações, mas não há -dispositivos registrados com o aplicativo. - -**Resposta do usuário**: assegure-se de que os dispositivos tenham sido registrados -com o aplicativo antes de tentar enviar notificações. - - - -## FPWSE0010E -{: #error_fpwse0010e} - -**Explicação**: a solicitação enviada para o servidor resultou em uma condição de exceção. Uma das condições a seguir pode ter causado esse erro: - -- Um subsistema interno usado por -{{site.data.keyword.mobilepushshort}} não está respondendo. -- A solicitação resultou em uma condição de erro que pode não -ser manipulada por {{site.data.keyword.mobilepushshort}}. -- O serviço {{site.data.keyword.mobilepushshort}} -requer atenção do administrador. - -**Resposta do usuário**: tente novamente a solicitação. Se o problema persistir, entre em contato com o suporte de -software IBM. - - - -## FPWSE0011E -{: #error_fpwse0011e} - -**Explicação**: a assinatura para a tag já existe no servidor. Por exemplo, ao criar -uma assinatura que já existe. - -**Resposta do usuário**: crie a assinatura com um nome de tag exclusivo. - - - -## FPWSE0012E -{: #error_fpwse0012e} - -**Explicação**: a assinatura para a tag não existe no servidor. Esse erro ocorre quando uma -solicitação é enviada para recuperar ou excluir uma assinatura que não existe. - - -**Resposta do usuário**: use o nome de tag e o identificador de dispositivo corretos na -solicitação. - - - -## FPWSE0013E -{: #error_fpwse0013e} - -**Explicação**: a carga útil de JSON na solicitação não é válida. - - -**Resposta do usuário**: assegure-se de que a carga útil de JSON seja válida. - - -## FPWSE0025E -{: #error_fpwse0025e} - -**Explicação**: atualmente o servidor não é capaz de manipular a solicitação. - -**Resposta do usuário**: envie novamente a solicitação posteriormente. - - -## FPWSE1007E -{: #error_fpwse1007e} - -**Explicação**: o serviço {{site.data.keyword.mobilepushshort}} foi -desativado para este aplicativo. O motivo pode ser o faturamento, ou o app pode ter sido desativado pelo -administrador. - - -**Resposta do usuário**: consulte os tópicos de Resolução de problemas no Bluemix Docs -para verificar o status do serviço, revisar informações de resolução de problemas ou para acessar informações sobre como obter -ajuda. - - - -## FPWSE1079E -{: #error_fpwse1079e} - -**Explicação**: o valor de compensação que foi fornecido para a operação de consulta -não é válido. - -**Resposta do usuário**: assegure-se de que o valor de compensação seja maior ou -igual a zero. - - - -## FPWSE1080E -{: #error_fpwse1080e} - -**Explicação**: o valor do tamanho que foi fornecido para a operação de consulta -não é válido. - -**Resposta do usuário**: assegure-se de que o valor do tamanho seja maior que zero. - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Mensagens de erro +de serviço {{site.data.keyword.mobilepushshort}} +{: #errors} +Última atualização: 13 de fevereiro de 2017 +{: .last-updated} + + +As mensagens de erro de {{site.data.keyword.mobilepushshort}} a seguir são retornadas em resposta a solicitações da API REST. + +Resposta de erro de amostra: +``` + { + "message": "Missing APNs credentials", + "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", + "code": "FPWSE0003E" + } +``` + {: codeblock} + +Para obter informações adicionais sobre um erro, procure nos +docs o código de erro relacionado. + +## FPWSE0001E +{: #error_fpwse0001e} + +**Explicação**: o recurso que você está tentando consultar, como uma +tag ou assinatura, não está disponível no servidor. + +**Resposta do usuário**: crie o recurso que foi relatado na mensagem. Como alternativa, é possível fornecer o identificador +correto para consultar o recurso. + + +## FPWSE0002E +{: #error_fpwse0002e} + +**Explicação**: o recurso que você está tentando criar já está disponível no servidor. O +recurso pode ser uma identificação, uma assinatura, etc. + +**Resposta do usuário**: crie o recurso com um identificador diferente. + + +## FPWSE0003E +{: #error_fpwse0003e} + +**Explicação**: a configuração de pré-requisito para o serviço {{site.data.keyword.mobilepushshort}} não foi concluída. É possível +que você esteja tentando obter as credenciais de Apple Push Notification service (APNs) antes de elas serem +configuradas. + +**Resposta do usuário**: assegure-se de que o serviço +{{site.data.keyword.mobilepushshort}} +tenha sido configurado com certificados de segurança válidos para APNs. Para obter mais informações, veja [Configurando credenciais para APNs ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](t_push_provider_ios.html){: new_window}. + + +## FPWSE0004E +{: #error_fpwse0004e} + +**Explicação**: o corpo de JSON incluído na solicitação não é válido. + + +**Resposta do usuário**: assegure-se de usar uma sintaxe válida de JSON na +solicitação. + + + +## FPWSE0005E +{: #error_fpwse0005e} + +**Explicação**: a solicitação para o servidor +{{site.data.keyword.mobilepushshort}} está incorreta ou incompleta, +pois o corpo de JSON não contém os valores de propriedade necessários para concluir a solicitação de API. Por exemplo, uma senha não é válida ou +um token de dispositivo está ausente. + + +**Resposta do usuário**: revise a mensagem para saber qual valor de propriedade está +ausente ou não é válido e, em seguida, forneça as informações necessárias. + + + +## FPWSE0006E +{: #error_fpwse0006e} + +**Explicação**: o corpo de JSON da solicitação possui parâmetros que o servidor +{{site.data.keyword.mobilepushshort}} não entende. + + +**Resposta do usuário**: verifique se o corpo de JSON na solicitação segue o +formato da solicitação que é esperado pelo servidor {{site.data.keyword.mobilepushshort}}. Para obter mais informações, veja [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0007E +{: #error_fpwse0007e} + +**Explicação**: a URL de solicitação possui uma sequência de consultas com parâmetros +não reconhecidos. Por exemplo, se a solicitação para excluir a assinatura tiver parâmetros diferentes de deviceId e tagName, esse erro poderá ocorrer. + + +**Resposta do usuário**: verifique se o corpo de JSON na solicitação segue o formato +da solicitação que é esperado pelo servidor {{site.data.keyword.mobilepushshort}}. Para obter mais informações, veja [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0008E +{: #error_fpwse0008e} + +**Explicação**: a URL de solicitação possui uma sequência de consultas com parâmetros +ausentes. Por exemplo, os parâmetros deviceId e tagName podem estar ausentes na solicitação para excluir a assinatura. + + +**Resposta do usuário**: verifique se o corpo de JSON na solicitação segue o formato +da solicitação que é esperado pelo servidor {{site.data.keyword.mobilepushshort}}. Para obter mais informações, veja [APIs de REST ![Ícone de link externo](../../icons/launch-glyph.svg "External link icon")](https://mobile.{DomainName}/imfpush/){: new_window}. + + + +## FPWSE0009E +{: #error_fpwse0009e} + +**Explicação**: foi feita uma tentativa para enviar notificações, mas não há +dispositivos registrados com o aplicativo. + +**Resposta do usuário**: assegure-se de que os dispositivos tenham sido registrados +com o aplicativo antes de tentar enviar notificações. + + + +## FPWSE0010E +{: #error_fpwse0010e} + +**Explicação**: a solicitação enviada para o servidor resultou em uma condição de exceção. Uma das condições a seguir pode ter causado esse erro: + +- Um subsistema interno usado por +{{site.data.keyword.mobilepushshort}} não está respondendo. +- A solicitação resultou em uma condição de erro que pode não +ser manipulada por {{site.data.keyword.mobilepushshort}}. +- O serviço {{site.data.keyword.mobilepushshort}} +requer atenção do administrador. + +**Resposta do usuário**: tente novamente a solicitação. Se o problema persistir, entre em contato com o suporte de +software IBM. + + + +## FPWSE0011E +{: #error_fpwse0011e} + +**Explicação**: a assinatura para a tag já existe no servidor. Por exemplo, ao criar +uma assinatura que já existe. + +**Resposta do usuário**: crie a assinatura com um nome de tag exclusivo. + + + +## FPWSE0012E +{: #error_fpwse0012e} + +**Explicação**: a assinatura para a tag não existe no servidor. Esse erro ocorre quando uma +solicitação é enviada para recuperar ou excluir uma assinatura que não existe. + + +**Resposta do usuário**: use o nome de tag e o identificador de dispositivo corretos na +solicitação. + + + +## FPWSE0013E +{: #error_fpwse0013e} + +**Explicação**: a carga útil de JSON na solicitação não é válida. + + +**Resposta do usuário**: assegure-se de que a carga útil de JSON seja válida. + + +## FPWSE0025E +{: #error_fpwse0025e} + +**Explicação**: atualmente o servidor não é capaz de manipular a solicitação. + +**Resposta do usuário**: envie novamente a solicitação posteriormente. + + +## FPWSE1007E +{: #error_fpwse1007e} + +**Explicação**: o serviço {{site.data.keyword.mobilepushshort}} foi +desativado para este aplicativo. O motivo pode ser o faturamento, ou o app pode ter sido desativado pelo +administrador. + + +**Resposta do usuário**: consulte os tópicos de Resolução de problemas no Bluemix Docs +para verificar o status do serviço, revisar informações de resolução de problemas ou para acessar informações sobre como obter +ajuda. + + + +## FPWSE1079E +{: #error_fpwse1079e} + +**Explicação**: o valor de compensação que foi fornecido para a operação de consulta +não é válido. + +**Resposta do usuário**: assegure-se de que o valor de compensação seja maior ou +igual a zero. + + + +## FPWSE1080E +{: #error_fpwse1080e} + +**Explicação**: o valor do tamanho que foi fornecido para a operação de consulta +não é válido. + +**Resposta do usuário**: assegure-se de que o valor do tamanho seja maior que zero. + + + diff --git a/services/mobilepush/nl/pt/BR/troubleshooting.md b/services/mobilepush/nl/pt/BR/troubleshooting.md index e4ee2afc6..58b86f0ff 100644 --- a/services/mobilepush/nl/pt/BR/troubleshooting.md +++ b/services/mobilepush/nl/pt/BR/troubleshooting.md @@ -1,53 +1,53 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Resolução de problemas -{: #errors} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - -Use esta seção como um guia para solucionar problemas comuns do {{site.data.keyword.mobilepushshort}}. - - -### Ocorreu um erro do servidor interno. Contate o administrador. (Código de erro interno: PUSHD102E) - -**Explicação**: este erro poderá ocorrer se -você tiver criado uma instância push antes de novembro de 2015. - -**Resposta do usuário**: para resolver esse problema, exclua a instância de push e -crie uma nova. Observe que, ao excluir a instância de push, suas tags não serão preservadas. - - -### UnauthorizedRegistration - -**Explicação**: o Chrome Web Push não -funciona com as Chaves do Firebase Cloud Messaging (FCM). Caso você não possa receber notificações push da web no Chrome após mudar para o FCM do GCM, é porque o website foi configurado anteriormente para -funcionar com o projeto GCM e o novo projeto foi criado no FCM. Os tokens gerados que identificam o navegador são armazenadas em cache pelo navegador Chrome. - -**Resposta do usuário**: é possível resolver este problema ao remover os cookies e -reconfigurar as permissões do navegador. Isso -solicitaria permissões para ativar Notificações push. - - -### Os trabalhadores de serviço não são suportados neste navegador - -**Explicação**: o SDK que foi incluído como uma parte de `BMSPushSDK.js` usando o trabalhador de serviço não está disponível. - -**Resposta do usuário**: é recomendável alternar para um navegador que suporte o trabalhador de serviço. As versões suportadas dos navegadores são o Firefox versão 49 ou mais recente e o Chrome versão 53 (64 bits) ou mais recente. - - -### SecurityError: a operação é insegura - -**Explicação**: você poder ver o erro ao ativar o console da web no Firefox. O suporte de push da web no serviço de Notificação push requer que o website seja acessado com o protocolo `https`, em vez de `http`. - -**Resposta do usuário**: recomenda-se tentar a conexão ao website usando `https` no navegador. - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Resolução de problemas +{: #errors} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + +Use esta seção como um guia para solucionar problemas comuns do {{site.data.keyword.mobilepushshort}}. + + +### Ocorreu um erro do servidor interno. Contate o administrador. (Código de erro interno: PUSHD102E) + +**Explicação**: este erro poderá ocorrer se +você tiver criado uma instância push antes de novembro de 2015. + +**Resposta do usuário**: para resolver esse problema, exclua a instância de push e +crie uma nova. Observe que, ao excluir a instância de push, suas tags não serão preservadas. + + +### UnauthorizedRegistration + +**Explicação**: o Chrome Web Push não +funciona com as Chaves do Firebase Cloud Messaging (FCM). Caso você não possa receber notificações push da web no Chrome após mudar para o FCM do GCM, é porque o website foi configurado anteriormente para +funcionar com o projeto GCM e o novo projeto foi criado no FCM. Os tokens gerados que identificam o navegador são armazenadas em cache pelo navegador Chrome. + +**Resposta do usuário**: é possível resolver este problema ao remover os cookies e +reconfigurar as permissões do navegador. Isso +solicitaria permissões para ativar Notificações push. + + +### Os trabalhadores de serviço não são suportados neste navegador + +**Explicação**: o SDK que foi incluído como uma parte de `BMSPushSDK.js` usando o trabalhador de serviço não está disponível. + +**Resposta do usuário**: é recomendável alternar para um navegador que suporte o trabalhador de serviço. As versões suportadas dos navegadores são o Firefox versão 49 ou mais recente e o Chrome versão 53 (64 bits) ou mais recente. + + +### SecurityError: a operação é insegura + +**Explicação**: você poder ver o erro ao ativar o console da web no Firefox. O suporte de push da web no serviço de Notificação push requer que o website seja acessado com o protocolo `https`, em vez de `http`. + +**Resposta do usuário**: recomenda-se tentar a conexão ao website usando `https` no navegador. + diff --git a/services/mobilepush/nl/pt/BR/troubleshooting_config_errors.md b/services/mobilepush/nl/pt/BR/troubleshooting_config_errors.md index 0f235e6b4..b14d2730c 100644 --- a/services/mobilepush/nl/pt/BR/troubleshooting_config_errors.md +++ b/services/mobilepush/nl/pt/BR/troubleshooting_config_errors.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Resolvendo erros de configuração Push da web -{: #errors} -Última atualização: 11 de janeiro de 2017 -{: .last-updated} - -Use esta seção como um guia para resolver erros relacionados à configuração Push da web que normalmente ocorrem. Os erros de push da web do `BMSPushSDK.js` contêm informações sobre a falha. - -Para analisar um erro retornado no retorno de chamada, considere o código de amostra a seguir: - -``` -function showStatus(response) { - if(response.statusCode == 200 || response.statusCode == 201) { - document.getElementById("status").innerHTML = "Response is " + response.response; - } - else if(response.statusCode == 0) { - if(response.response) { - document.getElementById("status").innerHTML = response.response; - } - else { - document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; - } - } - else { - document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " - + response.error + " and the status code " + response.statusCode; - } - } -``` - {: codeblock} - - -- Se o `applicationId` estiver configurado incorretamente, a solicitação inicial para o serviço {{site.data.keyword.mobilepushshort}} falhará, por conseguinte o statusCode será configurado como zero (0). -- Um código de status de 200 ou 201 denota uma resposta bem-sucedida. -- No caso de o `clientSecret` ser inválido, uma resposta 401 será configurada no statusCode. O elemento `response.reponse` conterá uma descrição do erro. +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Resolvendo erros de configuração Push da web +{: #errors} +Última atualização: 11 de janeiro de 2017 +{: .last-updated} + +Use esta seção como um guia para resolver erros relacionados à configuração Push da web que normalmente ocorrem. Os erros de push da web do `BMSPushSDK.js` contêm informações sobre a falha. + +Para analisar um erro retornado no retorno de chamada, considere o código de amostra a seguir: + +``` +function showStatus(response) { + if(response.statusCode == 200 || response.statusCode == 201) { + document.getElementById("status").innerHTML = "Response is " + response.response; + } + else if(response.statusCode == 0) { + if(response.response) { + document.getElementById("status").innerHTML = response.response; + } + else { + document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; + } + } + else { + document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " + + response.error + " and the status code " + response.statusCode; + } + } +``` + {: codeblock} + + +- Se o `applicationId` estiver configurado incorretamente, a solicitação inicial para o serviço {{site.data.keyword.mobilepushshort}} falhará, por conseguinte o statusCode será configurado como zero (0). +- Um código de status de 200 ou 201 denota uma resposta bem-sucedida. +- No caso de o `clientSecret` ser inválido, uma resposta 401 será configurada no statusCode. O elemento `response.reponse` conterá uma descrição do erro. diff --git a/services/mobilepush/nl/zh/CN/c_advance_notifications.md b/services/mobilepush/nl/zh/CN/c_advance_notifications.md index db44eb555..05575e154 100644 --- a/services/mobilepush/nl/zh/CN/c_advance_notifications.md +++ b/services/mobilepush/nl/zh/CN/c_advance_notifications.md @@ -1,12 +1,12 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# 启用高级推送通知 -{: #push-advanced-notifications-main} - -配置 iOS 角标、声音、其他 JSON 有效内容、可操作通知和暂停通知。 +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# 启用高级推送通知 +{: #push-advanced-notifications-main} + +配置 iOS 角标、声音、其他 JSON 有效内容、可操作通知和暂停通知。 diff --git a/services/mobilepush/nl/zh/CN/c_android_enable.md b/services/mobilepush/nl/zh/CN/c_android_enable.md index e0e47e5d5..82aef97c6 100644 --- a/services/mobilepush/nl/zh/CN/c_android_enable.md +++ b/services/mobilepush/nl/zh/CN/c_android_enable.md @@ -1,361 +1,361 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 使 Android 应用程序能够接收 {{site.data.keyword.mobilepushshort}} -{: #tag_based_notifications} -上次更新时间：2017 年 2 月 14 日 -{: .last-updated} - -您可以让 Android 应用程序具有向您的设备接收推送通知的能力。Android Studio 是必备软件，也是构建 Android 项目的建议方法。必须具有 Android Studio 的基本知识。 - -## 使用 Gradle 安装客户机推送 SDK -{: #android_install} - -本部分描述如何安装和使用客户机推送 SDK 来进一步开发 Android 应用程序。 - -可以使用 Gradle 来添加 Bluemix® Mobile Services 推送 SDK。Gradle 会从存储库自动下载工件，并使这些工件可用于您的 Android 应用程序。 -确保正确设置了 Android Studio 和 Android Studio SDK。有关如何设置系统的更多信息，请参阅 [Android Studio 概述 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.android.com/tools/studio/index.html){: new_window}。有关 Gradle 的更多信息，请参阅[配置 Gradle 构建 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}。 - -创建并打开移动应用程序后，使用 Android Studio 完成以下步骤。 - -1. 向模块级别 **build.gradle** 文件添加依赖关系。 - - - 添加以下依赖关系会将 Bluemix™ Mobile 服务推送客户机 SDK 和 Google 播放服务 SDK 添加到编译作用域依赖关系中。 - ``` - com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ - ``` - {: codeblock} - - - 添加以下依赖关系可以导入代码片段所需的语句。 - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - {: codeblock} - - - 在结尾，向模块级别 **build.gradle** 文件添加以下依赖关系。 - ``` - apply plugin: 'com.google.gms.google-services' - ``` - {: codeblock} -3. 向项目级别 **build.gradle** 文件添加以下依赖关系。 -``` -dependencies { -classpath 'com.android.tools.build:gradle:2.2.3' - classpath 'com.google.gms:google-services:3.0.0' -} -``` - {: codeblock} -5. 在 **AndroidManifest.xml** 文件中，添加以下许可权，要查看样本清单，请参阅 [Android helloPush 样本应用程序 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}。要查看样本 Gradle 清单，请参阅 [样本构建 Gradle 文件 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}。 -``` - - - - - -``` - {: codeblock} -在此处阅读有关 [Android 许可权 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](http://developer.android.com/guide/topics/security/permissions.html){: new_window} 的更多信息。 -4. 添加活动的通知意向设置。此设置会在用户单击通知区域中收到的通知时启动应用程序。 -``` - - - - -``` - {: codeblock} -**注**：将上述操作中的 *Your_Android_Package_Name* 替换为应用程序中使用的应用程序包名称。 - -5. 针对 RECEIVE 和 REGISTRATION 事件通知，添加 Firebase 云消息传递 (FCM) 或 Google 云消息传递 (GCM) 意向服务和意向过滤器。 -``` - - - - - - - - - - -``` - {: codeblock} - -6. {{site.data.keyword.mobilepushshort}} 服务支持从通知区检索个别通知。对于从通知区访问的通知，系统仅会就单击的通知向您提供手柄。当正常打开应用程序时会显示所有通知。使用以下片段来更新 **AndroidManifest.xml** 文件，以使用此功能： - -``` - -``` - {: codeblock} - -要设置 FCM 项目并获取凭证，请参阅[获取您的发送方标识和 API 密钥](t_push_provider_android.html)。使用 Firebase 云消息传递 (FCM) 控制台完成以下步骤。 - -1. 在 Firebase 控制台中，单击**项目设置**图标。![Firebase 项目设置](images/FCM_4.jpg) - -3. 从您的应用程序窗格的“常规”选项卡中选择**添加应用程序**或**添加 Firebase 至您的 Android 应用程序图标**。![添加 Firebase 至 Android](images/FCM_5.jpg) - -4. 在“添加 Firebase 至您的 Android 应用程序”窗口中，添加 **com.ibm.mobilefirstplatform.clientsdk.android.push** 作为程序包名。“应用程序昵称”字段为可选字段。单击**添加应用程序**。 -![“添加 Firebase 至您的 Android”窗口](images/FCM_1.jpg) - -5. 通过在“添加 Firebase 至您的 Android 应用程序”窗口中，输入应用程序的程序包名。“应用程序昵称”字段为可选字段。单击**添加应用程序**。 - - - ![添加应用程序的程序包名](images/FCM_2.jpg) - -6. 生成 `google-services.json` 文件。将 `google-services.json` 文件复制到 Android 应用程序模块根目录。请注意，`google-service.json` 文件包括添加的程序包名。 - - ![添加 json 文件至应用程序根目录](images/FCM_7.jpg) - -5. 在“添加 Firebase 至您的 Android 应用程序”窗口中，单击**继续**然后单击**完成**。 - - - -构建并运行应用程序。 - -## 为 Android 应用程序初始化推送 SDK -{: #android_initialize} - -在 Android 应用程序中，通常会将初始化代码放置在主活动的 onCreate 方法中。SDK 有两个组件需要初始化。一个是核心 SDK，另一个是在核心 SDK 之上构建的推送 SDK。 - -###初始化核心 SDK - -``` -// Initialize the SDK for Android - BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); -``` - {: codeblock} - -####bluemixRegionSuffix -{: bluemixRegionSuffix} - -指定托管应用程序的位置。可以使用以下三个值中的一个值： - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -###初始化客户机推送 SDK - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext(), "appGUID", "clientSecret"); -``` - {: codeblock} - -####AppGUID -{: appguid_initialize_client_push_sdk} - -此为 {{site.data.keyword.mobilepushshort}} 服务的 AppGUID 键。此值区分大小写。打开 Push Notification 仪表板并选择“配置”选项卡。您可以从 Push Notification 服务仪表板上“配置”选项卡中的“移动选项”中获取此值。 - -## 注册 Android 设备 -{: #android_register} - -使用 `MFPPush.register()` API 可向 {{site.data.keyword.mobilepushshort}} 服务注册设备。对于注册 Android 设备，请在 Bluemix {{site.data.keyword.mobilepushshort}} 服务配置仪表板中添加 Firebase 云消息传递 (FCM) 或 Google 云消息传递 (GCM) 信息。有关更多信息，请参阅[为 Google 云消息传递配置凭证](t_push_provider_android.html)。 - -将以下代码片段复制到 Android 移动应用程序中。 - -``` - //Register Android devices - push.registerDevice(new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - {: codeblock} - - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` - {: codeblock} - -## 在 Android 设备上接收推送通知 -{: #android_receive} - -要为 notificationListener 对象注册推送，请调用 **MFPPush.listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 方法进行调用。 - -1. 要为 notificationListener 对象注册推送，请调用 **listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 和 **onPause** 方法进行调用的。 - - -``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` - {: codeblock} - - - -``` - @Override -protected void onPause() {super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} - -2. 构建项目，然后在设备或仿真器上运行该项目。在 register() 方法中针对响应侦听器调用 onSuccess() 方法时，这证实设备已成功注册 {{site.data.keyword.mobilepushshort}} 服务。此时，可以如“发送基本推送通知”中所述发送消息。 -3. 验证设备是否收到通知。如果应用程序在前台运行，那么通知将由 **MFPPushNotificationListener** 进行处理。如果应用程序在后台运行，那么通知栏中会显示一条消息。 - -## 在 Android 设备上监视推送通知 -{: #android_monitor} - -要监视应用程序中通知的当前状态，您可以实现 `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` 接口，并定义方法 onStatusChange(String messageId, MFPPushNotificationStatus status)。 - -**messageId** 是从服务器发送的消息的标识。**MFPPushNotificationStatus** 将通知的状态定义为值： - -- **RECEIVED** - 应用程序已接收通知。 -- **QUEUED** - 应用程序将通知排入队列，以用于调用通知侦听器。 -- **OPENED** - 用户通过单击托盘中的通知或从应用程序图标启动应用程序或当应用程序位于前台时，打开通知。 -- **DISMISSED** - 用户清除/关闭托盘中的通知。 - -您需要使用 MFPPush，来注册 **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** 类。 - -``` - push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { -@Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { -// Handle status change -} -}); -``` - {: codeblock} - - -### 侦听 DISMISSED 状态 - -您可以选择在以下任何一个条件中，侦听 DISMISSED 状态： - -- 当应用程序处于活动状态（在前台或后台运行）时 - - 添加以下片段到 `AndroidManifest.xml` 文件： - -``` - - - - - -``` - {: codeblock} - -- 当应用程序处于活动状态（在前台或后台运行）和未在运行（已关闭）时 - -您需要扩展 **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** 广播接收器并覆盖方法 **onReceive()**，其中 **MFPPushNotificationStatusListener** 应该在调用基类的方法 **onReceive()** 之前注册。 - -``` - public class MyDismissHandler extends MFPPushNotificationDismissHandler { -@Override -public void onReceive(Context context, Intent intent) { -MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { -@Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { -// Handle status change -} -}); -super.onReceive(context, intent); -} -} -``` - {: codeblock} - - -添加以下片段到 `AndroidManifest.xml` 文件： - -``` - - - - - -``` - {: codeblock} - -## 发送基本 {{site.data.keyword.mobilepushshort}} -{: #send} - -开发应用程序后，可以发送基本推送通知。 - -要发送基本推送通知，请完成以下步骤： - -1. 选择**发送通知**，并通过选择**发送至**选项编辑消息。支持的选项有**按标记列出设备**、**设备标识**、**用户标识**、**Android 设备**、**iOS 设备**、**Web 通知**和**所有设备**。 -**注**：选择**所有设备**选项时，预订了 {{site.data.keyword.mobilepushshort}} 的所有设备都会收到通知。![“通知”屏幕](images/tag_notification.jpg) - -2. 在**消息**字段中，编辑您的消息。根据需要，选择配置可选设置。 -3. 单击**发送**。 -3. 验证设备是否收到通知。 - -以下屏幕快照显示了在 Android 设备上前台处理推送通知的警报框。 - - - -![Android 上的前台推送通知](images/Android_Screenshot.jpg) - -以下屏幕快照显示了 Android 后台的推送通知。 - - - ![Android 上的后台推送通知](images/background.jpg) - -### 发送通知的可选 Android 设置 -{: #send_otpional_setting} - -对于向 Android 设备发送通知的 {{site.data.keyword.mobilepushshort}} 设置，您可以进一步定制。支持以下可选的定制选项。 -![Android 定制设置](images/android_custom_settings.jpg) - -- **折叠键**：折叠键附加在通知上。如果设备脱机时多个通知使用相同的折叠键按顺序抵达，那么将折叠通知。在设备联机时，将从 FCM/GCM 服务器接收通知，并只显示带有相同折叠键的最新通知。如果没有设置折叠键，将存储新和旧的消息，以在以后传递。 -- **声音**：指示在接收通知时播放声音片段。支持缺省值或应用程序中绑定的声音资源的名称。 -- **图标**：指定要针对通知显示的图标名称。请确保您已使用客户机应用程序，在 res/drawable 文件夹中包装了该图标。 -- **优先级**：指定将向消息分配传送优先级的选项。`high` 或 `max` 优先级将生成提醒通知，而 `low` 或 `default` 优先级的消息不会打开休眠设备上的网络连接。对于选项设置为 `min` 的消息，将发送静默通知。 -- **可视性**：您可以选择将消息可视性选项设置为 `public` 或 `private`。 -`private` 选项限制公共查看，如果您的设备已通过锁定或模式保护，您可以选择启用该选项，通知设置将设置为“隐藏敏感的通知内容”。当可视性设置为 `private` 时，一定会涉及“编辑”字段。在设备的安全锁定屏幕上将显示编辑字段中指定的内容。选择 `public` 时，通知可以自由阅读。 -- **生存时间**：此值以秒为单位进行设置。如果未指定此参数，FCM/GCM 服务器将把消息存储 4 周时间并将尝试传递。4 周后有效性到期。值可以为 0 至 2,419,200 秒之间的值。 -- **空闲时延迟**：将此值设置为 `true` 将指示 FCM/GCM 服务器在设备空闲时不要传递通知。将此值设置为 `false`，以确保在设备空闲时传递通知。 -- **同步**：通过将此选项设置为 `true`，将同步所有已注册设备的通知。如果某个用户名的用户在多个设备上安装了相同的应用程序，那么在一个设备上读取通知将确保删除其他设备上的通知。要使此选项生效，您需要确保已使用用户标识向 {{site.data.keyword.mobilepushshort}} 服务进行注册。 -- **其他有效内容**：为您的通知指定定制的有效内容值。 - - -## 后续步骤 -{: #next_steps_tags} - -成功设置基本通知后，可以配置基于标记的通知和高级选项。 - -将这些推送通知服务功能添加到应用程序中。 -要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 -要使用高级通知选项，请参阅[启用高级推送通知](t_advance_badge_sound_payload.html)。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 使 Android 应用程序能够接收 {{site.data.keyword.mobilepushshort}} +{: #tag_based_notifications} +上次更新时间：2017 年 2 月 14 日 +{: .last-updated} + +您可以让 Android 应用程序具有向您的设备接收推送通知的能力。Android Studio 是必备软件，也是构建 Android 项目的建议方法。必须具有 Android Studio 的基本知识。 + +## 使用 Gradle 安装客户机推送 SDK +{: #android_install} + +本部分描述如何安装和使用客户机推送 SDK 来进一步开发 Android 应用程序。 + +可以使用 Gradle 来添加 Bluemix® Mobile Services 推送 SDK。Gradle 会从存储库自动下载工件，并使这些工件可用于您的 Android 应用程序。 +确保正确设置了 Android Studio 和 Android Studio SDK。有关如何设置系统的更多信息，请参阅 [Android Studio 概述 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.android.com/tools/studio/index.html){: new_window}。有关 Gradle 的更多信息，请参阅[配置 Gradle 构建 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}。 + +创建并打开移动应用程序后，使用 Android Studio 完成以下步骤。 + +1. 向模块级别 **build.gradle** 文件添加依赖关系。 + + - 添加以下依赖关系会将 Bluemix™ Mobile 服务推送客户机 SDK 和 Google 播放服务 SDK 添加到编译作用域依赖关系中。 + ``` + com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ + ``` + {: codeblock} + + - 添加以下依赖关系可以导入代码片段所需的语句。 + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + {: codeblock} + + - 在结尾，向模块级别 **build.gradle** 文件添加以下依赖关系。 + ``` + apply plugin: 'com.google.gms.google-services' + ``` + {: codeblock} +3. 向项目级别 **build.gradle** 文件添加以下依赖关系。 +``` +dependencies { +classpath 'com.android.tools.build:gradle:2.2.3' + classpath 'com.google.gms:google-services:3.0.0' +} +``` + {: codeblock} +5. 在 **AndroidManifest.xml** 文件中，添加以下许可权，要查看样本清单，请参阅 [Android helloPush 样本应用程序 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}。要查看样本 Gradle 清单，请参阅 [样本构建 Gradle 文件 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}。 +``` + + + + + +``` + {: codeblock} +在此处阅读有关 [Android 许可权 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](http://developer.android.com/guide/topics/security/permissions.html){: new_window} 的更多信息。 +4. 添加活动的通知意向设置。此设置会在用户单击通知区域中收到的通知时启动应用程序。 +``` + + + + +``` + {: codeblock} +**注**：将上述操作中的 *Your_Android_Package_Name* 替换为应用程序中使用的应用程序包名称。 + +5. 针对 RECEIVE 和 REGISTRATION 事件通知，添加 Firebase 云消息传递 (FCM) 或 Google 云消息传递 (GCM) 意向服务和意向过滤器。 +``` + + + + + + + + + + +``` + {: codeblock} + +6. {{site.data.keyword.mobilepushshort}} 服务支持从通知区检索个别通知。对于从通知区访问的通知，系统仅会就单击的通知向您提供手柄。当正常打开应用程序时会显示所有通知。使用以下片段来更新 **AndroidManifest.xml** 文件，以使用此功能： + +``` + +``` + {: codeblock} + +要设置 FCM 项目并获取凭证，请参阅[获取您的发送方标识和 API 密钥](t_push_provider_android.html)。使用 Firebase 云消息传递 (FCM) 控制台完成以下步骤。 + +1. 在 Firebase 控制台中，单击**项目设置**图标。![Firebase 项目设置](images/FCM_4.jpg) + +3. 从您的应用程序窗格的“常规”选项卡中选择**添加应用程序**或**添加 Firebase 至您的 Android 应用程序图标**。![添加 Firebase 至 Android](images/FCM_5.jpg) + +4. 在“添加 Firebase 至您的 Android 应用程序”窗口中，添加 **com.ibm.mobilefirstplatform.clientsdk.android.push** 作为程序包名。“应用程序昵称”字段为可选字段。单击**添加应用程序**。 +![“添加 Firebase 至您的 Android”窗口](images/FCM_1.jpg) + +5. 通过在“添加 Firebase 至您的 Android 应用程序”窗口中，输入应用程序的程序包名。“应用程序昵称”字段为可选字段。单击**添加应用程序**。 + + + ![添加应用程序的程序包名](images/FCM_2.jpg) + +6. 生成 `google-services.json` 文件。将 `google-services.json` 文件复制到 Android 应用程序模块根目录。请注意，`google-service.json` 文件包括添加的程序包名。 + + ![添加 json 文件至应用程序根目录](images/FCM_7.jpg) + +5. 在“添加 Firebase 至您的 Android 应用程序”窗口中，单击**继续**然后单击**完成**。 + + + +构建并运行应用程序。 + +## 为 Android 应用程序初始化推送 SDK +{: #android_initialize} + +在 Android 应用程序中，通常会将初始化代码放置在主活动的 onCreate 方法中。SDK 有两个组件需要初始化。一个是核心 SDK，另一个是在核心 SDK 之上构建的推送 SDK。 + +###初始化核心 SDK + +``` +// Initialize the SDK for Android + BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); +``` + {: codeblock} + +####bluemixRegionSuffix +{: bluemixRegionSuffix} + +指定托管应用程序的位置。可以使用以下三个值中的一个值： + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +###初始化客户机推送 SDK + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext(), "appGUID", "clientSecret"); +``` + {: codeblock} + +####AppGUID +{: appguid_initialize_client_push_sdk} + +此为 {{site.data.keyword.mobilepushshort}} 服务的 AppGUID 键。此值区分大小写。打开 Push Notification 仪表板并选择“配置”选项卡。您可以从 Push Notification 服务仪表板上“配置”选项卡中的“移动选项”中获取此值。 + +## 注册 Android 设备 +{: #android_register} + +使用 `MFPPush.register()` API 可向 {{site.data.keyword.mobilepushshort}} 服务注册设备。对于注册 Android 设备，请在 Bluemix {{site.data.keyword.mobilepushshort}} 服务配置仪表板中添加 Firebase 云消息传递 (FCM) 或 Google 云消息传递 (GCM) 信息。有关更多信息，请参阅[为 Google 云消息传递配置凭证](t_push_provider_android.html)。 + +将以下代码片段复制到 Android 移动应用程序中。 + +``` + //Register Android devices + push.registerDevice(new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + {: codeblock} + + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` + {: codeblock} + +## 在 Android 设备上接收推送通知 +{: #android_receive} + +要为 notificationListener 对象注册推送，请调用 **MFPPush.listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 方法进行调用。 + +1. 要为 notificationListener 对象注册推送，请调用 **listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 和 **onPause** 方法进行调用的。 + + +``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` + {: codeblock} + + + +``` + @Override +protected void onPause() {super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} + +2. 构建项目，然后在设备或仿真器上运行该项目。在 register() 方法中针对响应侦听器调用 onSuccess() 方法时，这证实设备已成功注册 {{site.data.keyword.mobilepushshort}} 服务。此时，可以如“发送基本推送通知”中所述发送消息。 +3. 验证设备是否收到通知。如果应用程序在前台运行，那么通知将由 **MFPPushNotificationListener** 进行处理。如果应用程序在后台运行，那么通知栏中会显示一条消息。 + +## 在 Android 设备上监视推送通知 +{: #android_monitor} + +要监视应用程序中通知的当前状态，您可以实现 `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` 接口，并定义方法 onStatusChange(String messageId, MFPPushNotificationStatus status)。 + +**messageId** 是从服务器发送的消息的标识。**MFPPushNotificationStatus** 将通知的状态定义为值： + +- **RECEIVED** - 应用程序已接收通知。 +- **QUEUED** - 应用程序将通知排入队列，以用于调用通知侦听器。 +- **OPENED** - 用户通过单击托盘中的通知或从应用程序图标启动应用程序或当应用程序位于前台时，打开通知。 +- **DISMISSED** - 用户清除/关闭托盘中的通知。 + +您需要使用 MFPPush，来注册 **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** 类。 + +``` + push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { +@Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { +// Handle status change +} +}); +``` + {: codeblock} + + +### 侦听 DISMISSED 状态 + +您可以选择在以下任何一个条件中，侦听 DISMISSED 状态： + +- 当应用程序处于活动状态（在前台或后台运行）时 + + 添加以下片段到 `AndroidManifest.xml` 文件： + +``` + + + + + +``` + {: codeblock} + +- 当应用程序处于活动状态（在前台或后台运行）和未在运行（已关闭）时 + +您需要扩展 **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** 广播接收器并覆盖方法 **onReceive()**，其中 **MFPPushNotificationStatusListener** 应该在调用基类的方法 **onReceive()** 之前注册。 + +``` + public class MyDismissHandler extends MFPPushNotificationDismissHandler { +@Override +public void onReceive(Context context, Intent intent) { +MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { +@Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { +// Handle status change +} +}); +super.onReceive(context, intent); +} +} +``` + {: codeblock} + + +添加以下片段到 `AndroidManifest.xml` 文件： + +``` + + + + + +``` + {: codeblock} + +## 发送基本 {{site.data.keyword.mobilepushshort}} +{: #send} + +开发应用程序后，可以发送基本推送通知。 + +要发送基本推送通知，请完成以下步骤： + +1. 选择**发送通知**，并通过选择**发送至**选项编辑消息。支持的选项有**按标记列出设备**、**设备标识**、**用户标识**、**Android 设备**、**iOS 设备**、**Web 通知**和**所有设备**。 +**注**：选择**所有设备**选项时，预订了 {{site.data.keyword.mobilepushshort}} 的所有设备都会收到通知。![“通知”屏幕](images/tag_notification.jpg) + +2. 在**消息**字段中，编辑您的消息。根据需要，选择配置可选设置。 +3. 单击**发送**。 +3. 验证设备是否收到通知。 + +以下屏幕快照显示了在 Android 设备上前台处理推送通知的警报框。 + + + +![Android 上的前台推送通知](images/Android_Screenshot.jpg) + +以下屏幕快照显示了 Android 后台的推送通知。 + + + ![Android 上的后台推送通知](images/background.jpg) + +### 发送通知的可选 Android 设置 +{: #send_otpional_setting} + +对于向 Android 设备发送通知的 {{site.data.keyword.mobilepushshort}} 设置，您可以进一步定制。支持以下可选的定制选项。 +![Android 定制设置](images/android_custom_settings.jpg) + +- **折叠键**：折叠键附加在通知上。如果设备脱机时多个通知使用相同的折叠键按顺序抵达，那么将折叠通知。在设备联机时，将从 FCM/GCM 服务器接收通知，并只显示带有相同折叠键的最新通知。如果没有设置折叠键，将存储新和旧的消息，以在以后传递。 +- **声音**：指示在接收通知时播放声音片段。支持缺省值或应用程序中绑定的声音资源的名称。 +- **图标**：指定要针对通知显示的图标名称。请确保您已使用客户机应用程序，在 res/drawable 文件夹中包装了该图标。 +- **优先级**：指定将向消息分配传送优先级的选项。`high` 或 `max` 优先级将生成提醒通知，而 `low` 或 `default` 优先级的消息不会打开休眠设备上的网络连接。对于选项设置为 `min` 的消息，将发送静默通知。 +- **可视性**：您可以选择将消息可视性选项设置为 `public` 或 `private`。 +`private` 选项限制公共查看，如果您的设备已通过锁定或模式保护，您可以选择启用该选项，通知设置将设置为“隐藏敏感的通知内容”。当可视性设置为 `private` 时，一定会涉及“编辑”字段。在设备的安全锁定屏幕上将显示编辑字段中指定的内容。选择 `public` 时，通知可以自由阅读。 +- **生存时间**：此值以秒为单位进行设置。如果未指定此参数，FCM/GCM 服务器将把消息存储 4 周时间并将尝试传递。4 周后有效性到期。值可以为 0 至 2,419,200 秒之间的值。 +- **空闲时延迟**：将此值设置为 `true` 将指示 FCM/GCM 服务器在设备空闲时不要传递通知。将此值设置为 `false`，以确保在设备空闲时传递通知。 +- **同步**：通过将此选项设置为 `true`，将同步所有已注册设备的通知。如果某个用户名的用户在多个设备上安装了相同的应用程序，那么在一个设备上读取通知将确保删除其他设备上的通知。要使此选项生效，您需要确保已使用用户标识向 {{site.data.keyword.mobilepushshort}} 服务进行注册。 +- **其他有效内容**：为您的通知指定定制的有效内容值。 + + +## 后续步骤 +{: #next_steps_tags} + +成功设置基本通知后，可以配置基于标记的通知和高级选项。 + +将这些推送通知服务功能添加到应用程序中。 +要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 +要使用高级通知选项，请参阅[启用高级推送通知](t_advance_badge_sound_payload.html)。 diff --git a/services/mobilepush/nl/zh/CN/c_chrome_firefox_enable.md b/services/mobilepush/nl/zh/CN/c_chrome_firefox_enable.md index 55761dd14..87a6db269 100644 --- a/services/mobilepush/nl/zh/CN/c_chrome_firefox_enable.md +++ b/services/mobilepush/nl/zh/CN/c_chrome_firefox_enable.md @@ -1,131 +1,131 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 让 Web 应用程序能够接收 {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -上次更新时间：2017 年 2 月 16 日 -{: .last-updated} - -您可以启用 Google Chrome、Mozilla Firefox 和 Safari Web 应用程序以接收 {{site.data.keyword.mobilepushshort}}。请确保您已经完成[配置通知提供程序的凭证](t__main_push_config_provider.html)，然后再继续相关步骤。 - -## 安装 Web 浏览器客户机 SDK 以支持 {{site.data.keyword.mobilepushshort}} -{: #web_install} - -本主题描述如何安装和使用客户机 JavaScript 推送 SDK 来进一步开发 Web 应用程序。 - -### 在 Web 应用程序中初始化 - -要在 Google Chrome Web 应用程序中安装 JavaScript SDK，请完成以下步骤： - -从 [Bluemix Web 推送 SDK](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window} 下载 `BMSPushSDK.js`、`BMSPushServiceWorker.js` 和 `manifest_Website.json` 文件。 - -1. 编辑 `manifest_Website.json` 文件。 - - 对于 Google Chrome 浏览器，将 `name` 更改为站点名称。例如，`www.dailynewsupdates.com`。将 `gcm_sender_id` 更改为 Firebase 云消息传递 (FCM) 或 Google 云消息传递 (GCM) sender_ID。有关更多信息，请参阅[获取您的发送方标识和 API 密钥](t_push_provider_android.html)。gcm_sender_id 值仅包含数字。 - - ``` - { - "name": "YOUR_WEBSITE_NAME", - "gcm_sender_id": "GCM_Sender_Id" - } - ``` - {: codeblock} - - - 对于 Mozilla Firefox 浏览器，在 `manifest_Website.json` 文件中添加以下值。提供相应的`名称`。该名称应该是 Web 站点的名称。 - - ``` - { - "name": "YOUR_WEBSITE_NAME" - } - ``` - {: codeblock} - -2. 将 `manifest_Website.json` 文件名更改为 `manifest.json`。 -3. 将 `BMSPushSDK.js`、`BMSPushServiceWorker.js` 和 `manifest.json` 添加到 Web 站点的根目录。 -3. 将 `manifest.json` 包含在 html 文件的 `` 标记中。 - ``` - - ``` - {: codeblock} -4. 将 Bluemix Web 推送 SDK 包含在您的 Web 应用程序中。 - ``` - - ``` - {: codeblock} - -**注**：请确保已部署代码且使用 `https` 而非 `http` 访问样本链接。 - -## 初始化 Web 推送 SDK -{: #web_initialize} - -通过 Bluemix {{site.data.keyword.mobilepushshort}} 服务 `app GUID` 和 `app Region` 初始化推送 SDK。 - -要获取您的应用程序 GUID，在初始化的推送服务的导航窗格中选择**配置**选项，并单击**移动选项**。修改代码片段以使用 Bluemix 推送通知服务 appGUID 参数。 - -`App Region` 指定托管 {{site.data.keyword.mobilepushshort}} 服务的位置。可以使用以下三个值中的一个值： - - - 对于美国达拉斯：`.ng.bluemix.net` - - 对于英国：`.eu-gb.bluemix.net` - - 对于悉尼：`.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(initParams, callback) -``` - {: codeblock} - -**注**：如果针对 Web 推送 SDK 更改了您的 FCM 凭证，那么对于 Chrome 浏览器，消息传送可能会失败。请确保调用 `bmsPush.unRegisterDevice` 以避免失败。 - -如果您提供错误的参数，那么您可能会看到配置相关错误。有关更多信息，请参阅[解决 Web 推送配置错误](troubleshooting_config_errors.html)。 - -## 注册 Web 应用程序 -{: #web_register} - -使用 **register()** API 向 {{site.data.keyword.mobilepushshort}} 服务注册设备。基于您的浏览器，使用以下任一选项。 - -- 对于从 Google Chrome 注册，请在 Bluemix {{site.data.keyword.mobilepushshort}} 服务 Web 配置仪表板中添加 Firebase 云消息传递 (FCM) 和 Google 云消息传递 (GCM) API 密钥和 Web 站点 URL。有关更多信息，请参阅 Chrome 设置下的[为 Google 云消息传递配置凭证](t_push_provider_android.html)。 - -- 对于从 Mozilla Firefox 注册，在 Firefox 设置下的 Bluemix {{site.data.keyword.mobilepushshort}} 服务 Web 配置仪表板中添加 Web 站点 URL。 - -使用以下代码片段在 Bluemix {{site.data.keyword.mobilepushshort}} 服务中注册。 - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 让 Web 应用程序能够接收 {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +上次更新时间：2017 年 2 月 16 日 +{: .last-updated} + +您可以启用 Google Chrome、Mozilla Firefox 和 Safari Web 应用程序以接收 {{site.data.keyword.mobilepushshort}}。请确保您已经完成[配置通知提供程序的凭证](t__main_push_config_provider.html)，然后再继续相关步骤。 + +## 安装 Web 浏览器客户机 SDK 以支持 {{site.data.keyword.mobilepushshort}} +{: #web_install} + +本主题描述如何安装和使用客户机 JavaScript 推送 SDK 来进一步开发 Web 应用程序。 + +### 在 Web 应用程序中初始化 + +要在 Google Chrome Web 应用程序中安装 JavaScript SDK，请完成以下步骤： + +从 [Bluemix Web 推送 SDK](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window} 下载 `BMSPushSDK.js`、`BMSPushServiceWorker.js` 和 `manifest_Website.json` 文件。 + +1. 编辑 `manifest_Website.json` 文件。 + - 对于 Google Chrome 浏览器，将 `name` 更改为站点名称。例如，`www.dailynewsupdates.com`。将 `gcm_sender_id` 更改为 Firebase 云消息传递 (FCM) 或 Google 云消息传递 (GCM) sender_ID。有关更多信息，请参阅[获取您的发送方标识和 API 密钥](t_push_provider_android.html)。gcm_sender_id 值仅包含数字。 + + ``` + { + "name": "YOUR_WEBSITE_NAME", + "gcm_sender_id": "GCM_Sender_Id" + } + ``` + {: codeblock} + + - 对于 Mozilla Firefox 浏览器，在 `manifest_Website.json` 文件中添加以下值。提供相应的`名称`。该名称应该是 Web 站点的名称。 + + ``` + { + "name": "YOUR_WEBSITE_NAME" + } + ``` + {: codeblock} + +2. 将 `manifest_Website.json` 文件名更改为 `manifest.json`。 +3. 将 `BMSPushSDK.js`、`BMSPushServiceWorker.js` 和 `manifest.json` 添加到 Web 站点的根目录。 +3. 将 `manifest.json` 包含在 html 文件的 `` 标记中。 + ``` + + ``` + {: codeblock} +4. 将 Bluemix Web 推送 SDK 包含在您的 Web 应用程序中。 + ``` + + ``` + {: codeblock} + +**注**：请确保已部署代码且使用 `https` 而非 `http` 访问样本链接。 + +## 初始化 Web 推送 SDK +{: #web_initialize} + +通过 Bluemix {{site.data.keyword.mobilepushshort}} 服务 `app GUID` 和 `app Region` 初始化推送 SDK。 + +要获取您的应用程序 GUID，在初始化的推送服务的导航窗格中选择**配置**选项，并单击**移动选项**。修改代码片段以使用 Bluemix 推送通知服务 appGUID 参数。 + +`App Region` 指定托管 {{site.data.keyword.mobilepushshort}} 服务的位置。可以使用以下三个值中的一个值： + + - 对于美国达拉斯：`.ng.bluemix.net` + - 对于英国：`.eu-gb.bluemix.net` + - 对于悉尼：`.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(initParams, callback) +``` + {: codeblock} + +**注**：如果针对 Web 推送 SDK 更改了您的 FCM 凭证，那么对于 Chrome 浏览器，消息传送可能会失败。请确保调用 `bmsPush.unRegisterDevice` 以避免失败。 + +如果您提供错误的参数，那么您可能会看到配置相关错误。有关更多信息，请参阅[解决 Web 推送配置错误](troubleshooting_config_errors.html)。 + +## 注册 Web 应用程序 +{: #web_register} + +使用 **register()** API 向 {{site.data.keyword.mobilepushshort}} 服务注册设备。基于您的浏览器，使用以下任一选项。 + +- 对于从 Google Chrome 注册，请在 Bluemix {{site.data.keyword.mobilepushshort}} 服务 Web 配置仪表板中添加 Firebase 云消息传递 (FCM) 和 Google 云消息传递 (GCM) API 密钥和 Web 站点 URL。有关更多信息，请参阅 Chrome 设置下的[为 Google 云消息传递配置凭证](t_push_provider_android.html)。 + +- 对于从 Mozilla Firefox 注册，在 Firefox 设置下的 Bluemix {{site.data.keyword.mobilepushshort}} 服务 Web 配置仪表板中添加 Web 站点 URL。 + +使用以下代码片段在 Bluemix {{site.data.keyword.mobilepushshort}} 服务中注册。 + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + + + diff --git a/services/mobilepush/nl/zh/CN/c_chrome_firefox_enable_send.md b/services/mobilepush/nl/zh/CN/c_chrome_firefox_enable_send.md index 125d2697d..7c569b16f 100644 --- a/services/mobilepush/nl/zh/CN/c_chrome_firefox_enable_send.md +++ b/services/mobilepush/nl/zh/CN/c_chrome_firefox_enable_send.md @@ -1,43 +1,43 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 向 Web 浏览器发送基本通知 -{: #web_notifications} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - -开发应用程序后，可以发送推送通知。 - -1. 选择**发送通知**，并通过选择 **Web 通知**作为**发送至**选项来编辑消息。 -2. 键入需要在**消息**字段中传递的消息。 -3. 您可以选择提供可选设置： - - **通知标题**：这是作为消息警报标题显示的文本。 - - **通知图标 URL**：如果您的消息需要与应用程序通知图标一起传递，请在字段中提供图标的链接。 - - **生存时间**：通知服务器消息的有效性。 -4. 对于发送到 Safari 浏览器的 Web 通知，需要一些附加信息： - - **操作**：这是操作按钮的标签 。 - - **URL 自变量**：需要与此通知一起使用的 URL 自变量。请确保以 JSON 数组的形式提供。 - -下面的图像显示仪表板中的 Web 通知选项。 - - ![“通知”屏幕](images/DashboardWebpush.jpg) - - -## 后续步骤 - {: #next_steps_tags} - -成功设置基本通知后，可以选择配置基于标记的通知和高级选项。 - -将这些 {{site.data.keyword.mobilepushshort}} 服务功能添加到应用程序中。要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。要使用高级通知选项，请参阅[高级通知](t_advance_badge_sound_payload.html)。 - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 向 Web 浏览器发送基本通知 +{: #web_notifications} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + +开发应用程序后，可以发送推送通知。 + +1. 选择**发送通知**，并通过选择 **Web 通知**作为**发送至**选项来编辑消息。 +2. 键入需要在**消息**字段中传递的消息。 +3. 您可以选择提供可选设置： + - **通知标题**：这是作为消息警报标题显示的文本。 + - **通知图标 URL**：如果您的消息需要与应用程序通知图标一起传递，请在字段中提供图标的链接。 + - **生存时间**：通知服务器消息的有效性。 +4. 对于发送到 Safari 浏览器的 Web 通知，需要一些附加信息： + - **操作**：这是操作按钮的标签 。 + - **URL 自变量**：需要与此通知一起使用的 URL 自变量。请确保以 JSON 数组的形式提供。 + +下面的图像显示仪表板中的 Web 通知选项。 + + ![“通知”屏幕](images/DashboardWebpush.jpg) + + +## 后续步骤 + {: #next_steps_tags} + +成功设置基本通知后，可以选择配置基于标记的通知和高级选项。 + +将这些 {{site.data.keyword.mobilepushshort}} 服务功能添加到应用程序中。要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。要使用高级通知选项，请参阅[高级通知](t_advance_badge_sound_payload.html)。 + + + diff --git a/services/mobilepush/nl/zh/CN/c_cordova_enable.md b/services/mobilepush/nl/zh/CN/c_cordova_enable.md index 376fde193..745bd16a2 100644 --- a/services/mobilepush/nl/zh/CN/c_cordova_enable.md +++ b/services/mobilepush/nl/zh/CN/c_cordova_enable.md @@ -1,314 +1,314 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 使 Cordova 应用程序能够接收推送通知 -{: #cordova_enable} -上次更新时间：2017 年 1 月 18 日 -{: .last-updated} - -Cordova 是一种平台，用于通过 JavaScript、CSS 和 HTML 构建混合应用程序。{{site.data.keyword.mobilepushshort}} 服务支持开发基于 Cordova 的 iOS 和 Android 应用程序。 - -您可以让 Cordova 应用程序具有向您的设备接收推送通知的能力。 - -## 安装 Cordova 推送插件 -{: #cordova_install} - -安装并使用客户机推送插件来进一步开发 Cordova 应用程序。这还会安装 Cordova 核心插件，该插件会初始化与 Bluemix 的连接。 - -### 开始之前 - -1. 下载最新版本的 Android Studio SDK 和 Xcode。 -1. 设置仿真器。对于 Android Studio，请使用支持 Google Play API 的仿真器。 -1. 安装 Git 命令行工具。对于 Windows，请确保选择**从 Windows 命令提示符运行 Git** 选项。有关如何下载和安装此工具的更多信息，请参阅 [Git ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://git-scm.com/downloads){: new_window}。 -1. 安装 Node.js 和 Node 软件包管理器 (NPM) 工具。NPM 命令行工具与 Node.js 捆绑在一起。有关如何下载和安装 Node.js 的更多信息，请参阅 [Node.js ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://nodejs.org/en/download/){: new_window}。 -1. 在命令行中，使用 **npm install -g cordova** 命令来安装 Cordova 命令行工具。必须有该工具才能使用 Cordova 推送插件。有关如何安装 Cordova 并设置 Cordova 应用程序的更多信息，请参阅 [Cordova Apache ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://cordova.apache.org/#getstarted){: new_window}。有关的更多信息，请参阅 Cordova 推送插件[自述文件 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window}。 -1. 切换到要在其中创建 Cordova 应用程序的文件夹，然后运行以下命令来创建 Cordova 应用程序。如果已有 Cordova 应用程序，请转至步骤 3。 -```cordova create your_app_name - cd your_app_name - ``` - {: codeblock} -- 可选：您可以编辑 **config.xml** 文件，然后将 元素中的应用程序名称更改为所选名称，而不使用缺省 HelloCordova 名称。 - -确保指定正确的捆绑软件标识。如果指定不正确的捆绑软件标识，那么以下错误消息可能会导致 Xcode。 - -* 对可执行文件进行签名的权利无效。 -* 应用程序的“代码签名权利”文件中指定的权利与供应概要文件中指定的权利不同。要解决此问题，请在 Xcode 或 Cordova 应用程序 **config.xml** 文件中指定正确的捆绑软件标识。 - -1. 将支持的最低版本 API 或部署目标声明添加到 Cordova 应用程序的 config.xml 文件中。minSdkVersion 值必须高于 15。targetSdkVersion 值必须始终反映出 Google 上可用的最新版本 Android SDK。 - - * Android - 使用编辑器，打开 **config.xml** 文件并使用最低 SDK 版本和目标 SDK 版本更新 `` 元素： - - ``` - - - - - - ``` - {: codeblock} - - * iOS - 使用部署目标声明更新 元素： - - ``` - - - - - ``` - {: codeblock} - -1. 在 Cordova 命令行界面 (CLI) 中，使用以下命令添加 iOS 和/或 Android 平台： -``` -cordova platform add ios - cordova platform add android - ``` - {: codeblock} - -1. 在 Cordova 应用程序根目录中，输入以下命令来安装 Cordova 推送插件：**cordova plugin add bms-push**。根据您所添加的平台，您可能会看到： -``` -Installing "bms-push" for android -Installing "bms-push" for ios -``` - {: codeblock} - -1. 在 your-app-root-folder 中，使用以下命令来验证 Cordova 核心和推送插件是否成功安装：**cordova plugin list**。根据您所添加的平台，您可能会看到： -``` -bms-core "BMSCore" -bms-push "BMSPush" -``` - {: codeblock} - -1. 配置 iOS 开发环境。 -2. 使用 Xcode 构建并运行应用程序。 -1. 下载 Android 的 Firebase `google-services.json`，并将它们放在 Cordova 项目的根文件夹的 `[your-app-name]/platforms/android 中。 - 1. 转至 `[your-app-name]/platforms/android`。 - 2. 打开文件 `build.gradle`（路径：平台 > android > build.gradle）。 - 3. 在 `build.gradle` 文件中查找 `buildscript` 文本。 - 4. 在 classpath 行之后，添加一行 classpath 'com.google.gms:google-services:3.0.0' - 5. 然后查找“dependencies”。选择具有文本 `compile` 且依赖关系结束处的依赖关系，在那之后，添加此行：apply plugin: 'com.google.gms.google-services'。 - 6. 准备并构建 Cordova Android 项目。 - ``` - cordova prepare android - cordova build android - ``` - {: codeblock} - **注**：在 Android Studio 中打开项目之前，先通过 Cordova CLI 构建 Cordova 应用程序。这将帮助您避免构建错误。 -## 初始化 Cordova 插件 -{: #cordova_initialize} - -开始使用 {{site.data.keyword.mobilepushshort}} 服务 Cordova 插件之前，需要通过传递应用程序路径和应用程序 GUID 对其进行初始化。初始化该插件后，可以连接到在 Bluemix“仪表板”中创建的服务器应用程序。 Cordova 插件是 Android 和 iOS 客户机 SDK 的包装程序，可以使 Cordova 应用程序能够与 Bluemix 服务进行通信。 - -1. 通过将以下代码片段复制并粘贴到主 JavaScript 文件（通常位于 **www/js** 目录下）中来初始化 BMSClient。 - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("YOUR APP REGION"); - var category = {}; - BMSPush.initialize(appGUID,clientSecret,category); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); - } -``` - {: codeblock} - -为应用程序传入区域。提供以下常量： - -``` -REGION_US_SOUTH // ".ng.bluemix.net"; -REGION_UK //".eu-gb.bluemix.net"; -REGION_SYDNEY // ".au-syd.bluemix.net"; -``` - -例如： - -``` -BMSClient.initialize(BMSClient.REGION_US_SOUTH); -``` - -**注**：如果是使用 Cordova CLI（例如，Cordova create app-name 命令）创建的 Cordova 应用程序，请将此 JavaScript 代码放入 index.js 文件内 onDeviceReady: function() 函数中的 app.receivedEvent 函数之后，以初始化 `BMSClient`。 - - -## 注册设备 -{: #cordova_register} - - -要向 {{site.data.keyword.mobilepushshort}} 服务注册设备，请调用 register 方法。将以下代码片段复制到 Cordova 应用程序中，以注册设备。 - -``` -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); -``` - {: codeblock} - -以下 JavaScript 代码片段显示如何初始化 Bluemix Mobile Services 客户机 SDK，向 {{site.data.keyword.mobilepushshort}} 服务注册设备以及侦听推送通知。将此代码放入 JavaScript 文件中。 - -在 **onDeviceReady: function()** 中。 - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); -BMSClient.initialize("YOUR APP REGION"); -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; -BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -将以下 Swift 代码片段添加到应用程序代表类中。 - -``` -// Register the device token with Bluemix Push Notification Service -func application(application: UIApplication, - didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { - CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) -} -// Handle error when failed to register device token with APNs -func application(application: UIApplication, - didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) -} -``` - {: codeblock} - -##后续步骤 - -{: #cordova_register_next} - -使用以下命令构建项目，然后运行项目： - -####Android -{: android-next-steps} - -``` -cordova build android -``` - {: codeblock} - -``` -cordova run android -``` - {: codeblock} - -####iOS -{: ios-next-steps} - -``` -cordova build ios -``` - {: codeblock} - -``` -cordova run ios -``` - {: codeblock} - -## 在设备上接收推送通知 -{: #cordova_receive} - -复制以下代码片段，以在设备上接收推送通知。 - -###JavaScript - -将以下 JavaScript 代码片段添加到 Cordova 应用程序的 Web 部分中。 -``` -var showNotification = function(notif) { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -###Android 通知属性 - -以下部分列出了 Android 通知属性： - -* **message** - 推送通知消息 -* **payload** - 包含通知有效内容的 JSON 对象 - - -###iOS 通知属性 - -以下部分列出了 iOS 通知属性： - -* **message** - 推送通知消息 -* **payload** - 包含通知有效内容的 JSON 对象 action-loc-key - 此字符串用作键以从当前本地化版本中获取本地化字符串，用于适当按钮标题，而不是 `View`。 -* **badge** - 要显示为应用程序图标角标的数字。如果缺少此属性，那么角标不会改变。要除去角标，请将此属性的值设置为 0。 -* **sound** - 应用程序捆绑包中或应用程序数据容器的 Library/Sounds 文件夹中声音文件的名称。 - - -将以下 Swift 代码片段添加到应用程序代表类中。 -``` -// Handle receiving a remote notification -func application(application: UIApplication, - didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) -} -``` - {: codeblock} - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary - if remoteNotif != nil { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) - } -} -``` - {: codeblock} - -## 发送基本推送通知 -{: #push-send-notifications} - -开发应用程序后，可以发送基本推送通知。 - -要发送基本推送通知，请完成以下步骤： - -1. 选择**发送通知**，并通过选择**发送至**选项编辑消息。支持的选项有**按标记列出设备**、**设备标识**、**用户标识**、**Android 设备**、**iOS 设备**、**Web 通知**和**所有设备**。 -**注**：选择**所有设备**选项时，预订了 {{site.data.keyword.mobilepushshort}} 的所有设备都会收到通知。![“通知”屏幕](images/tag_notification.jpg) - -2. 在**消息**字段中，编辑您的消息。根据需要，选择配置可选设置。 -3. 单击**发送**。 -3. 验证设备是否收到通知。 - -以下屏幕快照显示了在 Android 和 iOS 设备上前台处理 {{site.data.keyword.mobilepushshort}} 的警报框。 - - -![Android 上的前台推送通知](images/Android_Screenshot.jpg) - -![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) - - 下图显示 Android 上的后台 {{site.data.keyword.mobilepushshort}}。 - ![Android 上的后台推送通知](images/background.jpg) - -## 后续步骤 -{: #next_steps_tags} - -成功设置基本通知后，可以配置基于标记的通知和高级选项。 - -将 {{site.data.keyword.mobilepushshort}} 服务功能添加到应用程序中。 -要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 -要使用高级通知选项，请参阅[启用高级推送通知](t_advance_badge_sound_payload.html)。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 使 Cordova 应用程序能够接收推送通知 +{: #cordova_enable} +上次更新时间：2017 年 1 月 18 日 +{: .last-updated} + +Cordova 是一种平台，用于通过 JavaScript、CSS 和 HTML 构建混合应用程序。{{site.data.keyword.mobilepushshort}} 服务支持开发基于 Cordova 的 iOS 和 Android 应用程序。 + +您可以让 Cordova 应用程序具有向您的设备接收推送通知的能力。 + +## 安装 Cordova 推送插件 +{: #cordova_install} + +安装并使用客户机推送插件来进一步开发 Cordova 应用程序。这还会安装 Cordova 核心插件，该插件会初始化与 Bluemix 的连接。 + +### 开始之前 + +1. 下载最新版本的 Android Studio SDK 和 Xcode。 +1. 设置仿真器。对于 Android Studio，请使用支持 Google Play API 的仿真器。 +1. 安装 Git 命令行工具。对于 Windows，请确保选择**从 Windows 命令提示符运行 Git** 选项。有关如何下载和安装此工具的更多信息，请参阅 [Git ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://git-scm.com/downloads){: new_window}。 +1. 安装 Node.js 和 Node 软件包管理器 (NPM) 工具。NPM 命令行工具与 Node.js 捆绑在一起。有关如何下载和安装 Node.js 的更多信息，请参阅 [Node.js ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://nodejs.org/en/download/){: new_window}。 +1. 在命令行中，使用 **npm install -g cordova** 命令来安装 Cordova 命令行工具。必须有该工具才能使用 Cordova 推送插件。有关如何安装 Cordova 并设置 Cordova 应用程序的更多信息，请参阅 [Cordova Apache ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://cordova.apache.org/#getstarted){: new_window}。有关的更多信息，请参阅 Cordova 推送插件[自述文件 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window}。 +1. 切换到要在其中创建 Cordova 应用程序的文件夹，然后运行以下命令来创建 Cordova 应用程序。如果已有 Cordova 应用程序，请转至步骤 3。 +```cordova create your_app_name + cd your_app_name + ``` + {: codeblock} +- 可选：您可以编辑 **config.xml** 文件，然后将 元素中的应用程序名称更改为所选名称，而不使用缺省 HelloCordova 名称。 + +确保指定正确的捆绑软件标识。如果指定不正确的捆绑软件标识，那么以下错误消息可能会导致 Xcode。 + +* 对可执行文件进行签名的权利无效。 +* 应用程序的“代码签名权利”文件中指定的权利与供应概要文件中指定的权利不同。要解决此问题，请在 Xcode 或 Cordova 应用程序 **config.xml** 文件中指定正确的捆绑软件标识。 + +1. 将支持的最低版本 API 或部署目标声明添加到 Cordova 应用程序的 config.xml 文件中。minSdkVersion 值必须高于 15。targetSdkVersion 值必须始终反映出 Google 上可用的最新版本 Android SDK。 + + * Android - 使用编辑器，打开 **config.xml** 文件并使用最低 SDK 版本和目标 SDK 版本更新 `` 元素： + + ``` + + + + + + ``` + {: codeblock} + + * iOS - 使用部署目标声明更新 元素： + + ``` + + + + + ``` + {: codeblock} + +1. 在 Cordova 命令行界面 (CLI) 中，使用以下命令添加 iOS 和/或 Android 平台： +``` +cordova platform add ios + cordova platform add android + ``` + {: codeblock} + +1. 在 Cordova 应用程序根目录中，输入以下命令来安装 Cordova 推送插件：**cordova plugin add bms-push**。根据您所添加的平台，您可能会看到： +``` +Installing "bms-push" for android +Installing "bms-push" for ios +``` + {: codeblock} + +1. 在 your-app-root-folder 中，使用以下命令来验证 Cordova 核心和推送插件是否成功安装：**cordova plugin list**。根据您所添加的平台，您可能会看到： +``` +bms-core "BMSCore" +bms-push "BMSPush" +``` + {: codeblock} + +1. 配置 iOS 开发环境。 +2. 使用 Xcode 构建并运行应用程序。 +1. 下载 Android 的 Firebase `google-services.json`，并将它们放在 Cordova 项目的根文件夹的 `[your-app-name]/platforms/android 中。 + 1. 转至 `[your-app-name]/platforms/android`。 + 2. 打开文件 `build.gradle`（路径：平台 > android > build.gradle）。 + 3. 在 `build.gradle` 文件中查找 `buildscript` 文本。 + 4. 在 classpath 行之后，添加一行 classpath 'com.google.gms:google-services:3.0.0' + 5. 然后查找“dependencies”。选择具有文本 `compile` 且依赖关系结束处的依赖关系，在那之后，添加此行：apply plugin: 'com.google.gms.google-services'。 + 6. 准备并构建 Cordova Android 项目。 + ``` + cordova prepare android + cordova build android + ``` + {: codeblock} + **注**：在 Android Studio 中打开项目之前，先通过 Cordova CLI 构建 Cordova 应用程序。这将帮助您避免构建错误。 +## 初始化 Cordova 插件 +{: #cordova_initialize} + +开始使用 {{site.data.keyword.mobilepushshort}} 服务 Cordova 插件之前，需要通过传递应用程序路径和应用程序 GUID 对其进行初始化。初始化该插件后，可以连接到在 Bluemix“仪表板”中创建的服务器应用程序。 Cordova 插件是 Android 和 iOS 客户机 SDK 的包装程序，可以使 Cordova 应用程序能够与 Bluemix 服务进行通信。 + +1. 通过将以下代码片段复制并粘贴到主 JavaScript 文件（通常位于 **www/js** 目录下）中来初始化 BMSClient。 + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("YOUR APP REGION"); + var category = {}; + BMSPush.initialize(appGUID,clientSecret,category); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); + } +``` + {: codeblock} + +为应用程序传入区域。提供以下常量： + +``` +REGION_US_SOUTH // ".ng.bluemix.net"; +REGION_UK //".eu-gb.bluemix.net"; +REGION_SYDNEY // ".au-syd.bluemix.net"; +``` + +例如： + +``` +BMSClient.initialize(BMSClient.REGION_US_SOUTH); +``` + +**注**：如果是使用 Cordova CLI（例如，Cordova create app-name 命令）创建的 Cordova 应用程序，请将此 JavaScript 代码放入 index.js 文件内 onDeviceReady: function() 函数中的 app.receivedEvent 函数之后，以初始化 `BMSClient`。 + + +## 注册设备 +{: #cordova_register} + + +要向 {{site.data.keyword.mobilepushshort}} 服务注册设备，请调用 register 方法。将以下代码片段复制到 Cordova 应用程序中，以注册设备。 + +``` +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); +``` + {: codeblock} + +以下 JavaScript 代码片段显示如何初始化 Bluemix Mobile Services 客户机 SDK，向 {{site.data.keyword.mobilepushshort}} 服务注册设备以及侦听推送通知。将此代码放入 JavaScript 文件中。 + +在 **onDeviceReady: function()** 中。 + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); +BMSClient.initialize("YOUR APP REGION"); +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; +BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +将以下 Swift 代码片段添加到应用程序代表类中。 + +``` +// Register the device token with Bluemix Push Notification Service +func application(application: UIApplication, + didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { + CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) +} +// Handle error when failed to register device token with APNs +func application(application: UIApplication, + didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) +} +``` + {: codeblock} + +##后续步骤 + +{: #cordova_register_next} + +使用以下命令构建项目，然后运行项目： + +####Android +{: android-next-steps} + +``` +cordova build android +``` + {: codeblock} + +``` +cordova run android +``` + {: codeblock} + +####iOS +{: ios-next-steps} + +``` +cordova build ios +``` + {: codeblock} + +``` +cordova run ios +``` + {: codeblock} + +## 在设备上接收推送通知 +{: #cordova_receive} + +复制以下代码片段，以在设备上接收推送通知。 + +###JavaScript + +将以下 JavaScript 代码片段添加到 Cordova 应用程序的 Web 部分中。 +``` +var showNotification = function(notif) { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +###Android 通知属性 + +以下部分列出了 Android 通知属性： + +* **message** - 推送通知消息 +* **payload** - 包含通知有效内容的 JSON 对象 + + +###iOS 通知属性 + +以下部分列出了 iOS 通知属性： + +* **message** - 推送通知消息 +* **payload** - 包含通知有效内容的 JSON 对象 action-loc-key - 此字符串用作键以从当前本地化版本中获取本地化字符串，用于适当按钮标题，而不是 `View`。 +* **badge** - 要显示为应用程序图标角标的数字。如果缺少此属性，那么角标不会改变。要除去角标，请将此属性的值设置为 0。 +* **sound** - 应用程序捆绑包中或应用程序数据容器的 Library/Sounds 文件夹中声音文件的名称。 + + +将以下 Swift 代码片段添加到应用程序代表类中。 +``` +// Handle receiving a remote notification +func application(application: UIApplication, + didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) +} +``` + {: codeblock} + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary + if remoteNotif != nil { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) + } +} +``` + {: codeblock} + +## 发送基本推送通知 +{: #push-send-notifications} + +开发应用程序后，可以发送基本推送通知。 + +要发送基本推送通知，请完成以下步骤： + +1. 选择**发送通知**，并通过选择**发送至**选项编辑消息。支持的选项有**按标记列出设备**、**设备标识**、**用户标识**、**Android 设备**、**iOS 设备**、**Web 通知**和**所有设备**。 +**注**：选择**所有设备**选项时，预订了 {{site.data.keyword.mobilepushshort}} 的所有设备都会收到通知。![“通知”屏幕](images/tag_notification.jpg) + +2. 在**消息**字段中，编辑您的消息。根据需要，选择配置可选设置。 +3. 单击**发送**。 +3. 验证设备是否收到通知。 + +以下屏幕快照显示了在 Android 和 iOS 设备上前台处理 {{site.data.keyword.mobilepushshort}} 的警报框。 + + +![Android 上的前台推送通知](images/Android_Screenshot.jpg) + +![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) + + 下图显示 Android 上的后台 {{site.data.keyword.mobilepushshort}}。 + ![Android 上的后台推送通知](images/background.jpg) + +## 后续步骤 +{: #next_steps_tags} + +成功设置基本通知后，可以配置基于标记的通知和高级选项。 + +将 {{site.data.keyword.mobilepushshort}} 服务功能添加到应用程序中。 +要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 +要使用高级通知选项，请参阅[启用高级推送通知](t_advance_badge_sound_payload.html)。 diff --git a/services/mobilepush/nl/zh/CN/c_enable_push.md b/services/mobilepush/nl/zh/CN/c_enable_push.md index ecdfc6b50..0c14f8fc8 100644 --- a/services/mobilepush/nl/zh/CN/c_enable_push.md +++ b/services/mobilepush/nl/zh/CN/c_enable_push.md @@ -1,24 +1,24 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 为移动设备启用通知 -{: #c_enable_push-notifications} -上次更新时间：2017 年 1 月 18 日 -{: .last-updated} - -请确保您已经完成[配置通知提供程序的凭证](t__main_push_config_provider.html)。 - -本部分描述了如何使您的客户机应用程序（移动、Web 浏览器应用程序以及 Chrome Apps and Extensions）能够接收推送通知，如何创建基本通知、获取和初始化SDK 或插件，以及如何注册您的设备或浏览器来接收推送通知。您还可以通过 [REST API](t_restapi.html) 使移动和 Web 浏览器应用程序能够接收推送通知。 - -**注**：对于设备、浏览器、Chrome Apps and Extensions 注册，{{site.data.keyword.mobilepushshort}} 服务会保持对通知提供者颁发的令牌的唯一引用。对于 Apple，通知提供者为 APNs；而对于 Google，则为 FCM。{{site.data.keyword.mobilepushshort}} 服务通知提供者可能会基于一些原因让令牌失效。 - -例如，在设备上卸载应用程序期间。在这种情况下，如果有传递通知的尝试，通知提供者就会给出有关设备已失效的响应，{{site.data.keyword.mobilepushshort}} 服务会根据该响应来除去设备或 Web 浏览器注册。这样会抑制后续的尝试，阻止将通知发送给这些已失效的设备。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 为移动设备启用通知 +{: #c_enable_push-notifications} +上次更新时间：2017 年 1 月 18 日 +{: .last-updated} + +请确保您已经完成[配置通知提供程序的凭证](t__main_push_config_provider.html)。 + +本部分描述了如何使您的客户机应用程序（移动、Web 浏览器应用程序以及 Chrome Apps and Extensions）能够接收推送通知，如何创建基本通知、获取和初始化SDK 或插件，以及如何注册您的设备或浏览器来接收推送通知。您还可以通过 [REST API](t_restapi.html) 使移动和 Web 浏览器应用程序能够接收推送通知。 + +**注**：对于设备、浏览器、Chrome Apps and Extensions 注册，{{site.data.keyword.mobilepushshort}} 服务会保持对通知提供者颁发的令牌的唯一引用。对于 Apple，通知提供者为 APNs；而对于 Google，则为 FCM。{{site.data.keyword.mobilepushshort}} 服务通知提供者可能会基于一些原因让令牌失效。 + +例如，在设备上卸载应用程序期间。在这种情况下，如果有传递通知的尝试，通知提供者就会给出有关设备已失效的响应，{{site.data.keyword.mobilepushshort}} 服务会根据该响应来除去设备或 Web 浏览器注册。这样会抑制后续的尝试，阻止将通知发送给这些已失效的设备。 diff --git a/services/mobilepush/nl/zh/CN/c_enable_push_webhook.md b/services/mobilepush/nl/zh/CN/c_enable_push_webhook.md index adcf82163..88f3c1cac 100644 --- a/services/mobilepush/nl/zh/CN/c_enable_push_webhook.md +++ b/services/mobilepush/nl/zh/CN/c_enable_push_webhook.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 启用 Webhook -{: #tag_based_notifications} -上次更新时间：2017 年 1 月 23 日 -{: .last-updated} - - -使用 {{site.data.keyword.mobilepushshort}} 服务，您可以选择接收已更改信息的警报。企业信息的更改会创建事件，通过将它们注册为 Webhook 事件，您可以接收相关通知。这些 Webhook 事件可触发警报。 - -Webhook 是用户定义的回调，可由事件触发，如注册设备或预订标记。在 {{site.data.keyword.mobilepushshort}} 服务上，您可以针对以下 Webhook 事件进行注册： - -- **onDeviceRegister**：针对已为推送注册的设备触发 Webhook 事件。 -- **onDeviceUpdate**：当更新已注册设备的相关信息时触发 Webhook 事件。 -- **onDeviceUnregister**：当取消注册设备时触发 Webhook 事件。 -- **onSubscribe**：用户预订标记时触发 Webhook 事件。 -- **onUnsubscribe**：用户取消预订标记时触发 Webhook 事件。 -- **onNotificationSend**：针对已分派的通知触发 Webhook 事件。 -- **onNotificationFailure**：针对通知失败触发 Webhook 事件。 - - -**注**：通知分派以批量处理。消息分派可以具有多个 Webhook 事件，其中可能包括失败和成功。 -Webhook 事件可以与已分派的消息具有相同的消息标识。 - -有关 Webhook 的更多信息，请参阅 [IBM Push Notifications REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 启用 Webhook +{: #tag_based_notifications} +上次更新时间：2017 年 1 月 23 日 +{: .last-updated} + + +使用 {{site.data.keyword.mobilepushshort}} 服务，您可以选择接收已更改信息的警报。企业信息的更改会创建事件，通过将它们注册为 Webhook 事件，您可以接收相关通知。这些 Webhook 事件可触发警报。 + +Webhook 是用户定义的回调，可由事件触发，如注册设备或预订标记。在 {{site.data.keyword.mobilepushshort}} 服务上，您可以针对以下 Webhook 事件进行注册： + +- **onDeviceRegister**：针对已为推送注册的设备触发 Webhook 事件。 +- **onDeviceUpdate**：当更新已注册设备的相关信息时触发 Webhook 事件。 +- **onDeviceUnregister**：当取消注册设备时触发 Webhook 事件。 +- **onSubscribe**：用户预订标记时触发 Webhook 事件。 +- **onUnsubscribe**：用户取消预订标记时触发 Webhook 事件。 +- **onNotificationSend**：针对已分派的通知触发 Webhook 事件。 +- **onNotificationFailure**：针对通知失败触发 Webhook 事件。 + + +**注**：通知分派以批量处理。消息分派可以具有多个 Webhook 事件，其中可能包括失败和成功。 +Webhook 事件可以与已分派的消息具有相同的消息标识。 + +有关 Webhook 的更多信息，请参阅 [IBM Push Notifications REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}。 diff --git a/services/mobilepush/nl/zh/CN/c_ios_enable.md b/services/mobilepush/nl/zh/CN/c_ios_enable.md index 774741c8d..52bab38dc 100644 --- a/services/mobilepush/nl/zh/CN/c_ios_enable.md +++ b/services/mobilepush/nl/zh/CN/c_ios_enable.md @@ -1,336 +1,336 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#让 iOS 应用程序具有发送 {{site.data.keyword.mobilepushshort}} 的能力 -{: #enable-push-ios-notifications} -上次更新时间：2017 年 2 月 14 日 -{: .last-updated} - -您可以让 iOS 应用程序具有对您的设备发送 {{site.data.keyword.mobilepushshort}} 的能力。 - - -##安装 CocoaPods -{: #enable-push-ios-notifications-install} - -对于现有 Xcode 项目，可以使用 CocoaPods 依赖关系管理工具来设置 Bluemix Mobile 服务客户机 SDK。替代方法是手动安装该 SDK。 - -要查看 Swift Push 自述文件，请转至[自述文件 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}。 - - - -1. 在 Mac 终端中，使用以下命令安装 CocoaPods： - -```$ sudo gem install cocoapods -``` - {: codeblock} -2. 在终端中输入 `pod init` 命令来初始化 CocoaPods。请确保从 Xcode 项目所在的目录运行命令。`pod init` 命令创建 Podfile。 -3. 在生成的 Podfile 中，添加所需的 SDK 依赖关系。复制以下 Podfile。 - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - pod 'BMSAnalyticsAPI' - end - ``` - {: codeblock} - -3. 在终端中，转至项目文件夹，然后使用 `pod update` 命令安装依赖关系。 - -该命令会安装依赖关系并创建新的 Xcode 工作空间。 -**注**：确保始终打开新的 Xcode 工作空间，而不是原始 Xcode 项目文件： -``` -$ open App.xcworkspace - ``` - {: codeblock} - -该工作空间包含原始项目，以及包含依赖关系的 Pods 项目。要修改 Bluemix 移动服务源文件夹，您可以在 Pods 项目的 `Pods/yourImportedSourceFolder` 下找到该文件夹，例如：`Pods/BMSPush`。 - - -##使用 Carthage 添加框架 -{: #carthage} - -使用 [Carthage ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}，向项目添加框架。请注意，Xcode8 中不支持 Carthage。 - -1. 将 `BMSPush` 框架添加到 Cartfile 中： -``` -github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" -``` - {: codeblock} -2. 运行 `carthage update` 命令。构建完成时，请将 `BMSPush.framework`、`BMSCore.framework` 和 `BMSAnalyticsAPI.framework` 拖动到 Xcode 项目中。 -3. 遵循 [Carthage ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} 站点上的指示，完成集成。 - -##设置 iOS SDK -{: ios-sdk} - -设置 iOS SDK，将以下代码添加到应用程序的 **AppDelegate.swift** 文件中。请注意，这也会向 APN 进行注册。 -``` -func application(_ application: UIApplication, -didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") - } -``` - {: codeblock} - -##使用导入的框架和源文件夹 -{: using-imported-frameworks} - -在代码中引用 SDK。确保满足以下先决条件。 - -- iOS 8.0 或更高版本 -- Xcode 7 - -针对相关头编写 `#import` 伪指令，例如： -``` -//swift -import BMSCore -import BMSPush -``` - {: codeblock} - -要阅读 Swift Push 自述文件，请参阅[自述文件 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}。 - -**注**：使用 CocoaPods 命令 `pod install` 或 `pod update` 更新 Pods 项目可能覆盖 Bluemix Mobile 服务源文件夹。如果要保留原始文件的定制版本，请确保在发出其中某个命令之前已备份这些文件。 - - -##构建设置 -{: build-settings} - -转至 **Xcode > 构建设置 > 构建选项**，然后将**启用位代码**设置为**否**。 - -**注意**：自 iOS 9 起，对应用程序传输安全性 (ATS) 功能的更改可能会影响您处理认证过程的方式。以下博客帖子描述相关更改的更多信息：[iOS 9 中的 ATS 和 Bitcode ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} 和[立即将 iOS 9 应用程序连接到 Bluemix![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}。 - -## 为 iOS 应用程序初始化推送 SDK -{: #enable-push-ios-notifications-initialize} - -在 iOS 应用程序中，通常会将初始化代码放置在应用程序代表中。单击“推送”仪表板的**移动选项**链接，以获取应用程序路径和 GUID。 - -###初始化核心 SDK -{: Initializing-the-core-sdk} - - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance -myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") -``` - {: codeblock} - -### 路径、GUID 和 Bluemix 区域 -{: route-guid-bluemix-region} - -####appRoute -{: ios-approute} - -指定分配给在 Bluemix 上创建的服务器应用程序的路径。 - -####GUID -{: ios-guid} - -指定分配给在 Bluemix 上创建的应用程序的唯一键。此值区分大小写。 - -####bluemixRegionSuffix -{: ios-bluemixRegionSuffix} - -指定托管应用程序的位置。`bluemixRegion` 参数指定要使用的 Bluemix 部署。可以使用 `BMSClient.REGION` 静态属性设置此值，并使用以下三个值中的一个值： - -- BMSClient.Region.usSouth -- BMSClient.Region.unitedKingdom -- BMSClient.Region.sydney - -####AppGUID -{: ios-AppGUID} - -指定分配给在 Bluemix 上创建的 {{site.data.keyword.mobilepushshort}} 服务的唯一 AppGUID 键。 - -###初始化客户机推送 SDK -{: initializing-the-client-Push-SDK} - -``` - //Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -## 注册 iOS 应用程序和设备 -{: #enable-push-ios-notifications-register} - - -应用程序必须向 APNs 进行注册，才能在安装到设备上之后接收远程通知。当应用程序收到 APNs 生成的设备令牌后，必须将该令牌传递回 {{site.data.keyword.mobilepushshort}} 服务。 - -要注册 iOS 应用程序和设备，您需要： - -1. 创建后端应用程序。 -2. 将令牌传递给 {{site.data.keyword.mobilepushshort}}。 - - -###创建后端应用程序 -{: create-a-backend-app} - -在 Bluemix®“目录”的“样板”部分中创建后端应用程序，这会自动将该 {{site.data.keyword.mobilepushshort}} 服务绑定到此应用程序。如果已创建后端应用程序，请务必将该应用程序绑定到 {{site.data.keyword.mobilepushshort}} 服务。 - - -###将令牌传递至 {{site.data.keyword.mobilepushshort}} -{: pass-token-push-notifications} - -从 APNs 收到令牌后，将令牌传递给 {{site.data.keyword.mobilepushshort}}（`registerWithDeviceToken` 方法的一部分）。 - -从 APNs 收到令牌后，将该令牌传递给 Push Notifications（作为 `didRegisterForRemoteNotificationsWithDeviceToken` -方法的一部分）。 - -``` -func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ - let push = BMSPushClient.sharedInstance - push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - } -``` - {: codeblock} - - -## 在 iOS 设备上接收推送通知 -{: #enable-push-ios-notifications-receiving} - - -要在 iOS 设备上接收推送通知，请将以下 Swift 方法添加到应用程序的应用程序代表中。 - -``` -// For Swift -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) -{ //UserInfo dictionary will contain data sent from the server } -``` - {: codeblock} - -## 在 iOS 设备上监视推送通知 -{: ios-monitoring} - -要监视通知的当前状态，请将以下 Swift 方法添加到应用程序的应用程序代表中。 - -``` - // Send notification status when app is opened by clicking the notifications -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - print("Send message status to the Push server") - } -} -``` - {: codeblock} - -``` - // Send notification status when the app is in background mode. -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { - let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) - self.showAlert(title: "Recieved Push notifications", message: payLoad) - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - completionHandler(UIBackgroundFetchResult.newData) - } -} -``` - {: codeblock} - - -## 发送基本推送通知 -{: #send} - -开发应用程序后，可以发送基本推送通知。 - -要发送基本推送通知，请完成以下步骤： - -1. 选择**发送通知**，并通过选择**发送至**选项编辑消息。支持的选项有**按标记列出设备**、**设备标识**、**用户标识**、**Android 设备**、**iOS 设备**、**Web 通知**和**所有设备**。 - -**注**：选择**所有设备**选项时，预订了 {{site.data.keyword.mobilepushshort}} 的所有设备都会收到通知。![“通知”屏幕](images/tag_notification.jpg) - -2. 在**消息**字段中，编辑您的消息。根据需要，选择配置可选设置。 -3. 单击**发送**。 -3. 验证设备是否收到通知。 - -下图显示在 iOS 设备上处理 {{site.data.keyword.mobilepushshort}} 的警报框。 - -![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) - -### 发送通知的可选设置 -{: #send_ios_otpional_setting} - -您可以定制将通知发送至 IOS 设备的 {{site.data.keyword.mobilepushshort}} 设置。支持以下可选的定制选项。 - -- **角标**：指示在应用程序角标上显示的数字。缺省值为零 (0)，这样不会显示角标。 -- **声音**：指示在接收通知时播放声音片段。支持缺省值或应用程序中绑定的声音资源的名称。 -- **其他有效内容**：为您的通知指定定制的有效内容值。 - -##启用交互式通知 - -现在，您可以通过启用交互式通知，利用更多详细信息来补充 iOS 通知，如添加图像、地图或响应按钮。这样做可为客户提供更多背景信息，同时可让客户立即采取操作而无需离开当前环境。 - -要启用交互式通知，请使用以下代码： - -``` - // This defines the button action. -let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) -``` - {: codeblock} -``` - // This defines category for the buttons -let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) -``` - {: codeblock} -``` - // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions -let notificationOptions = BMSPushClientOptions(categoryName: [category]) -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) -``` - {: codeblock} - -要发送交互式通知，请完成以下步骤： - -1. 在“编写”部分中，对于“发送至”下拉列表，选择 **iOS 设备**。 -2. 输入您要发送的通知消息。 -3. 在“可选设置”部分中，选择**移动**并单击 **iOS**。 -4. 在“类型”下拉列表中，选择**混合**。 -5. 在“类别”字段中，指定您在应用程序中定义的通知类型。 - -![针对 iOS 的交互式通知](images/push_ios_notification_interactive.jpg) - -## 后续步骤 -{: #next_steps_tags} - -成功设置基本通知后，可以配置基于标记的通知和高级选项。 - -将这些 Push Notifications 服务功能添加到应用程序中。 -要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 -要使用高级通知选项，请参阅[启用高级推送通知](t_advance_badge_sound_payload.html)。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 让 iOS 应用程序具有发送 {{site.data.keyword.mobilepushshort}} 的能力 +{: #enable-push-ios-notifications} +上次更新时间：2017 年 2 月 14 日 +{: .last-updated} + +您可以让 iOS 应用程序具有对您的设备发送 {{site.data.keyword.mobilepushshort}} 的能力。 + + +## 安装 CocoaPods +{: #enable-push-ios-notifications-install} + +对于现有 Xcode 项目，可以使用 CocoaPods 依赖关系管理工具来设置 Bluemix Mobile 服务客户机 SDK。替代方法是手动安装该 SDK。 + +要查看 Swift Push 自述文件，请转至[自述文件 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}。 + + + +1. 在 Mac 终端中，使用以下命令安装 CocoaPods： + +```$ sudo gem install cocoapods +``` + {: codeblock} +2. 在终端中输入 `pod init` 命令来初始化 CocoaPods。请确保从 Xcode 项目所在的目录运行命令。`pod init` 命令创建 Podfile。 +3. 在生成的 Podfile 中，添加所需的 SDK 依赖关系。复制以下 Podfile。 + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + pod 'BMSAnalyticsAPI' + end + ``` + {: codeblock} + +3. 在终端中，转至项目文件夹，然后使用 `pod update` 命令安装依赖关系。 + +该命令会安装依赖关系并创建新的 Xcode 工作空间。 +**注**：确保始终打开新的 Xcode 工作空间，而不是原始 Xcode 项目文件： +``` +$ open App.xcworkspace + ``` + {: codeblock} + +该工作空间包含原始项目，以及包含依赖关系的 Pods 项目。要修改 Bluemix 移动服务源文件夹，您可以在 Pods 项目的 `Pods/yourImportedSourceFolder` 下找到该文件夹，例如：`Pods/BMSPush`。 + + +##使用 Carthage 添加框架 +{: #carthage} + +使用 [Carthage ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}，向项目添加框架。请注意，Xcode8 中不支持 Carthage。 + +1. 将 `BMSPush` 框架添加到 Cartfile 中： +``` +github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" +``` + {: codeblock} +2. 运行 `carthage update` 命令。构建完成时，请将 `BMSPush.framework`、`BMSCore.framework` 和 `BMSAnalyticsAPI.framework` 拖动到 Xcode 项目中。 +3. 遵循 [Carthage ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} 站点上的指示，完成集成。 + +##设置 iOS SDK +{: ios-sdk} + +设置 iOS SDK，将以下代码添加到应用程序的 **AppDelegate.swift** 文件中。请注意，这也会向 APN 进行注册。 +``` +func application(_ application: UIApplication, +didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") + } +``` + {: codeblock} + +##使用导入的框架和源文件夹 +{: using-imported-frameworks} + +在代码中引用 SDK。确保满足以下先决条件。 + +- iOS 8.0 或更高版本 +- Xcode 7 + +针对相关头编写 `#import` 伪指令，例如： +``` +//swift +import BMSCore +import BMSPush +``` + {: codeblock} + +要阅读 Swift Push 自述文件，请参阅[自述文件 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}。 + +**注**：使用 CocoaPods 命令 `pod install` 或 `pod update` 更新 Pods 项目可能覆盖 Bluemix Mobile 服务源文件夹。如果要保留原始文件的定制版本，请确保在发出其中某个命令之前已备份这些文件。 + + +##构建设置 +{: build-settings} + +转至 **Xcode > 构建设置 > 构建选项**，然后将**启用位代码**设置为**否**。 + +**注意**：自 iOS 9 起，对应用程序传输安全性 (ATS) 功能的更改可能会影响您处理认证过程的方式。以下博客帖子描述相关更改的更多信息：[iOS 9 中的 ATS 和 Bitcode ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} 和[立即将 iOS 9 应用程序连接到 Bluemix![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}。 + +## 为 iOS 应用程序初始化推送 SDK +{: #enable-push-ios-notifications-initialize} + +在 iOS 应用程序中，通常会将初始化代码放置在应用程序代表中。单击“推送”仪表板的**移动选项**链接，以获取应用程序路径和 GUID。 + +###初始化核心 SDK +{: Initializing-the-core-sdk} + + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance +myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") +``` + {: codeblock} + +### 路径、GUID 和 Bluemix 区域 +{: route-guid-bluemix-region} + +####appRoute +{: ios-approute} + +指定分配给在 Bluemix 上创建的服务器应用程序的路径。 + +####GUID +{: ios-guid} + +指定分配给在 Bluemix 上创建的应用程序的唯一键。此值区分大小写。 + +####bluemixRegionSuffix +{: ios-bluemixRegionSuffix} + +指定托管应用程序的位置。`bluemixRegion` 参数指定要使用的 Bluemix 部署。可以使用 `BMSClient.REGION` 静态属性设置此值，并使用以下三个值中的一个值： + +- BMSClient.Region.usSouth +- BMSClient.Region.unitedKingdom +- BMSClient.Region.sydney + +####AppGUID +{: ios-AppGUID} + +指定分配给在 Bluemix 上创建的 {{site.data.keyword.mobilepushshort}} 服务的唯一 AppGUID 键。 + +###初始化客户机推送 SDK +{: initializing-the-client-Push-SDK} + +``` + //Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +## 注册 iOS 应用程序和设备 +{: #enable-push-ios-notifications-register} + + +应用程序必须向 APNs 进行注册，才能在安装到设备上之后接收远程通知。当应用程序收到 APNs 生成的设备令牌后，必须将该令牌传递回 {{site.data.keyword.mobilepushshort}} 服务。 + +要注册 iOS 应用程序和设备，您需要： + +1. 创建后端应用程序。 +2. 将令牌传递给 {{site.data.keyword.mobilepushshort}}。 + + +###创建后端应用程序 +{: create-a-backend-app} + +在 Bluemix®“目录”的“样板”部分中创建后端应用程序，这会自动将该 {{site.data.keyword.mobilepushshort}} 服务绑定到此应用程序。如果已创建后端应用程序，请务必将该应用程序绑定到 {{site.data.keyword.mobilepushshort}} 服务。 + + +###将令牌传递至 {{site.data.keyword.mobilepushshort}} +{: pass-token-push-notifications} + +从 APNs 收到令牌后，将令牌传递给 {{site.data.keyword.mobilepushshort}}（`registerWithDeviceToken` 方法的一部分）。 + +从 APNs 收到令牌后，将该令牌传递给 Push Notifications（作为 `didRegisterForRemoteNotificationsWithDeviceToken` +方法的一部分）。 + +``` +func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ + let push = BMSPushClient.sharedInstance + push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + } +``` + {: codeblock} + + +## 在 iOS 设备上接收推送通知 +{: #enable-push-ios-notifications-receiving} + + +要在 iOS 设备上接收推送通知，请将以下 Swift 方法添加到应用程序的应用程序代表中。 + +``` +// For Swift +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) +{ //UserInfo dictionary will contain data sent from the server } +``` + {: codeblock} + +## 在 iOS 设备上监视推送通知 +{: ios-monitoring} + +要监视通知的当前状态，请将以下 Swift 方法添加到应用程序的应用程序代表中。 + +``` + // Send notification status when app is opened by clicking the notifications +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + print("Send message status to the Push server") + } +} +``` + {: codeblock} + +``` + // Send notification status when the app is in background mode. +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { + let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) + self.showAlert(title: "Recieved Push notifications", message: payLoad) + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + completionHandler(UIBackgroundFetchResult.newData) + } +} +``` + {: codeblock} + + +## 发送基本推送通知 +{: #send} + +开发应用程序后，可以发送基本推送通知。 + +要发送基本推送通知，请完成以下步骤： + +1. 选择**发送通知**，并通过选择**发送至**选项编辑消息。支持的选项有**按标记列出设备**、**设备标识**、**用户标识**、**Android 设备**、**iOS 设备**、**Web 通知**和**所有设备**。 + +**注**：选择**所有设备**选项时，预订了 {{site.data.keyword.mobilepushshort}} 的所有设备都会收到通知。![“通知”屏幕](images/tag_notification.jpg) + +2. 在**消息**字段中，编辑您的消息。根据需要，选择配置可选设置。 +3. 单击**发送**。 +3. 验证设备是否收到通知。 + +下图显示在 iOS 设备上处理 {{site.data.keyword.mobilepushshort}} 的警报框。 + +![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) + +### 发送通知的可选设置 +{: #send_ios_otpional_setting} + +您可以定制将通知发送至 IOS 设备的 {{site.data.keyword.mobilepushshort}} 设置。支持以下可选的定制选项。 + +- **角标**：指示在应用程序角标上显示的数字。缺省值为零 (0)，这样不会显示角标。 +- **声音**：指示在接收通知时播放声音片段。支持缺省值或应用程序中绑定的声音资源的名称。 +- **其他有效内容**：为您的通知指定定制的有效内容值。 + +##启用交互式通知 + +现在，您可以通过启用交互式通知，利用更多详细信息来补充 iOS 通知，如添加图像、地图或响应按钮。这样做可为客户提供更多背景信息，同时可让客户立即采取操作而无需离开当前环境。 + +要启用交互式通知，请使用以下代码： + +``` + // This defines the button action. +let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) +``` + {: codeblock} +``` + // This defines category for the buttons +let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) +``` + {: codeblock} +``` + // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions +let notificationOptions = BMSPushClientOptions(categoryName: [category]) +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) +``` + {: codeblock} + +要发送交互式通知，请完成以下步骤： + +1. 在“编写”部分中，对于“发送至”下拉列表，选择 **iOS 设备**。 +2. 输入您要发送的通知消息。 +3. 在“可选设置”部分中，选择**移动**并单击 **iOS**。 +4. 在“类型”下拉列表中，选择**混合**。 +5. 在“类别”字段中，指定您在应用程序中定义的通知类型。 + +![针对 iOS 的交互式通知](images/push_ios_notification_interactive.jpg) + +## 后续步骤 +{: #next_steps_tags} + +成功设置基本通知后，可以配置基于标记的通知和高级选项。 + +将这些 Push Notifications 服务功能添加到应用程序中。 +要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 +要使用高级通知选项，请参阅[启用高级推送通知](t_advance_badge_sound_payload.html)。 diff --git a/services/mobilepush/nl/zh/CN/c_overview_push.md b/services/mobilepush/nl/zh/CN/c_overview_push.md index ffc0dd7fc..73d8e2167 100644 --- a/services/mobilepush/nl/zh/CN/c_overview_push.md +++ b/services/mobilepush/nl/zh/CN/c_overview_push.md @@ -1,129 +1,129 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 关于 {{site.data.keyword.mobilepushshort}} -{: #overview-push} -上次更新时间：2017 年 1 月 18 日 -{: .last-updated} - -IBM {{site.data.keyword.mobilepushshort}} 是一项服务，您可以使用该服务将通知发送到设备和平台。通知可以针对所有应用程序用户，也可以针对一组使用标记的特定用户和设备。您可以管理设备、标记和预订。 - -您可以使用以下任何选项，来创建绑定或未绑定服务： - -- 通过从目录使用 MobileFirst Services Starter 样板创建 Bluemix 应用程序。这会创建绑定到 Bluemix 后端应用程序的 Push Notifications 服务。 -- 通过从 Mobile 目录直接创建未绑定的 Push Notifications 服务。您可以稍后绑定到应用程序或者选择在未绑定的情况下使用它。 -- 通过使用 [Mobile 仪表板 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}。 - -请注意，{{site.data.keyword.mobilepushshort}} 监视选项卡并不显示分析数据。 - -{{site.data.keyword.mobilepushshort}} 服务现在支持 OpenWhisk。有关更多信息，请参阅 [OpenWhisk](/docs/openwhisk/index.html)。 - - -## {{site.data.keyword.mobilepushshort}} 服务流程 -{: #overview_push_process} - -移动、Web 浏览器客户机和 Google Chrome Apps and Extensions 可以针对 {{site.data.keyword.mobilepushshort}} 服务进行预订和注册。客户端应用程序会在启动时自行注册并预订 {{site.data.keyword.mobilepushshort}} 服务。通知会分派到 Apple 推送通知服务 (APNs) 或 Firebase 云消息传递 (FCM)/Google 云消息传递 (GCM) 服务器，然后发送到注册的移动或浏览器客户端。 - -![推送概述](images/overview.jpg) - - -###移动和浏览器应用程序 -{: mobile-applications} - -启动时，客户机应用程序会自行注册并预订 {{site.data.keyword.mobilepushshort}} 服务来接收通知。 - -###后端应用程序 -{: backend-applications} - -后端应用程序可以位于内部部署中，也可以位于公共云中。后端应用程序使用 {{site.data.keyword.mobilepushshort}} 服务将上下文相关通知发送给移动和浏览器应用程序用户。后端应用程序无需维护和管理用于发送推送通知的移动设备、浏览器代理程序和用户信息。相反，后端应用程序可以使用将用于对其进行管理和维护的 {{site.data.keyword.mobilepushshort}} 服务。 - -###应用程序后端所有者 -{: app-backend-owner} - -应用程序后端所有者会创建捆绑 {{site.data.keyword.mobilepushshort}} 服务实例的移动后端应用程序。应用程序后端所有者还会使用该服务搭配以 {{site.data.keyword.mobilepushshort}} 为目标的移动和浏览器应用程序，配置和设置 {{site.data.keyword.mobilepushshort}} 服务，以符合后端应用程序。 - -###{{site.data.keyword.mobilepushshort}} 服务 -{: push-notification-service} - -{{site.data.keyword.mobilepushshort}} 服务可管理与注册通知的移动设备和 Web 浏览器相关的所有信息。对于如何将通知发送给异构移动和 Web 浏览器平台，您的应用程序无需了解详细的技术信息，该服务会在其内部对所有这一切进行处理。 - -###网关 -{: gateways} - -平台特定的 Push Notifications 云服务（例如，IBM {{site.data.keyword.mobilepushshort}} 服务使用的 FCM/GCM 或 Apple 推送通知服务 (APNs)）将通知分派给移动和浏览器应用程序。 - -###推送安全 -{: push-security} - -{{site.data.keyword.mobilepushshort}} API 由两种类型的私钥进行保护： - -- **appSecret**：“appSecret”会保护通常由后端应用程序调用的 API，如用于发送 {{site.data.keyword.mobilepushshort}} 的 API 和用于配置设置的 API。 -- **clientSecret**：“clientSecret”会保护通常由移动客户端应用程序调用的 API。只有一个 API 与设备注册相关，且其相关联用户标识需要此“clientSecret”。从移动客户端调用的其他 API 没有一个需要 clientSecret。 - -在将应用程序与 {{site.data.keyword.mobilepushshort}} 服务绑定在一起时，“appSecret”和“clientSecret”会分配给每一个服务实例。 -请参阅 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/) 文档，以获取如何传递私钥以及相关联的 API 的更多信息。 - -**注**：仅在使用用户标识字段注册或更新设备时需要较早版本的应用程序来传递 clientSecret。移动和浏览器客户端调用的所有其他 API 不 -需要 clientSecret。这些旧应用程序可以选择针对设备注册或更新调用继续使用 clientSecret。但是，强烈建议对所有客户端 API 调用强制执行 clientSecret 检查。要在现有应用程序中强制执行此检查，已发布了一个新的“verifyClientSecret”API。对于所有新的应用程序，将对所有客户端 API 调用强制执行 clientSecret 检查，而此行为无法使用“verfiyClientSecret”API 进行更改。 - -缺省情况下，客户端密钥验证仅在新应用程序中强制执行。允许现有的和新的应用程序使用 verifyClientSecret REST API 启用或停用客户端密钥验证。建议您强制执行客户端密钥验证，以避免向可能了解 applicationId 和 deviceId 的用户公开设备。 - -请确保秘密保存“clientSecret”，绝不要将其硬编码到移动应用程序中。可以使用多种应用程序初始化模式，在应用程序运行时，动态地拉入“clientSecret”。时序图概述了此可能模式。 -![启用推送](images/init_client_secret.jpg) - -## {{site.data.keyword.mobilepushshort}} 类型 -{: #overview-push-types} - -###广播 -{: broadcast} - -当客户机应用程序在向 {{site.data.keyword.mobilepushshort}} 服务进行注册时即可开始接收广播。广播通知是向跨移动设备、浏览器安装，或实现为 Chrome 应用程序或扩展实例，以及针对 {{site.data.keyword.mobilepushshort}} 服务配置的所有应用程序实例发送的消息。缺省情况下，已启用 {{site.data.keyword.mobilepushshort}} 的任何应用程序都已启用广播通知。启用了 {{site.data.keyword.mobilepushshort}} 服务的应用程序都具有预定义的 Push.ALL 标记预订，服务器使用该标记来向所有设备广播通知消息。要使用 REST Push API 发送广播通知，请确保发布到消息资源时，“目标”是一个空的 JSON 文件。 - -###基于标记的通知 -{: tag-based-notifications} - -标记通知是针对预订了特定标记的所有设备的消息。基于标记的通知允许根据主题区域或主题对通知进行细分。通知接收方可以选择仅接收关于所关注主题的通知。因此，基于标记的通知提供了一种对接收方进行细分的方法。此功能可以定义标记，然后按标记发送和接收消息。消息的目标对象只包括已预订某标记的客户机应用程序实例（在移动、浏览器上或作为应用程序或扩展）。必须首先为应用程序创建标记，设置标记预订，然后再启动基于标记的通知。要使用 REST API 发送基于标记的通知，请确保发布到消息资源时提供了“tagNames”。 - -###单点广播通知 -{: unicast-notifications} - -单点广播通知是针对特定设备或用户的通知消息。单点广播通知不需要任何额外的设置，当应用程序启用了 {{site.data.keyword.mobilepushshort}} 时，缺省情况下就会启用单点广播通知。 - -但是，面向用户的单点广播通知要求在向 {{site.data.keyword.mobilepushshort}} 注册客户机移动设备或 Web 浏览器或 Chrome Apps and Extensions 时将用户标识与设备关联。 - -通常，客户机应用程序首先会运行认证周期，在这期间会针对认证服务（如 [Mobile Client Access](docs/services/mobileaccess/index.html)）认证移动应用程序用户。在成功认证之后，已认证的用户标识会传递至推送设备注册 API。要通过 REST API 发送单点广播通知，请确保发布到消息资源时提供了 deviceId 或 userId。 - -###基于平台的通知 -{: platform-based-notifications} - -可将通知定向发送到特定的设备平台。例如，可以只将通知发送给所有 Android 用户或 Google Chrome 用户。要使用 REST API 发送基于平台的通知，请确保发布到消息资源时提供了目标平台。将平台指定为数组。支持的平台如下所示： -* A (Apple) -* G (Google) -* WEB_CHROME（Google Chrome 浏览器 Web 推送） -* WEB_FIREFOX（Mozilla Firefox 浏览器 Web 推送） -* WEB_SAFARI（Safari 浏览器 Web 推送） -* APPEXT_CHROME (Google Chrome Apps & Extensions) - -## {{site.data.keyword.mobilepushshort}} 消息大小 -{: #push-message-size} - -{{site.data.keyword.mobilepushshort}} 消息有效内容大小取决于网关（FCM/GCM、APNs）和客户机平台规定的约束。 - -### iOS 和 Safari -{: ios-message-size} - -对于 iOS 8 和更高版本，所允许的最大大小为 2 KB。Apple 推送通知服务不会发送超过此限制的通知。 - -###Android、Firefox 浏览器、Chrome 浏览器以及 Chrome Apps & Extensions -{: android-message-size} - -允许的消息有效内容最大大小限制为 4 KB。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 关于 {{site.data.keyword.mobilepushshort}} +{: #overview-push} +上次更新时间：2017 年 1 月 18 日 +{: .last-updated} + +IBM {{site.data.keyword.mobilepushshort}} 是一项服务，您可以使用该服务将通知发送到设备和平台。通知可以针对所有应用程序用户，也可以针对一组使用标记的特定用户和设备。您可以管理设备、标记和预订。 + +您可以使用以下任何选项，来创建绑定或未绑定服务： + +- 通过从目录使用 MobileFirst Services Starter 样板创建 Bluemix 应用程序。这会创建绑定到 Bluemix 后端应用程序的 Push Notifications 服务。 +- 通过从 Mobile 目录直接创建未绑定的 Push Notifications 服务。您可以稍后绑定到应用程序或者选择在未绑定的情况下使用它。 +- 通过使用 [Mobile 仪表板 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}。 + +请注意，{{site.data.keyword.mobilepushshort}} 监视选项卡并不显示分析数据。 + +{{site.data.keyword.mobilepushshort}} 服务现在支持 OpenWhisk。有关更多信息，请参阅 [OpenWhisk](/docs/openwhisk/index.html)。 + + +## {{site.data.keyword.mobilepushshort}} 服务流程 +{: #overview_push_process} + +移动、Web 浏览器客户机和 Google Chrome Apps and Extensions 可以针对 {{site.data.keyword.mobilepushshort}} 服务进行预订和注册。客户端应用程序会在启动时自行注册并预订 {{site.data.keyword.mobilepushshort}} 服务。通知会分派到 Apple 推送通知服务 (APNs) 或 Firebase 云消息传递 (FCM)/Google 云消息传递 (GCM) 服务器，然后发送到注册的移动或浏览器客户端。 + +![推送概述](images/overview.jpg) + + +###移动和浏览器应用程序 +{: mobile-applications} + +启动时，客户机应用程序会自行注册并预订 {{site.data.keyword.mobilepushshort}} 服务来接收通知。 + +###后端应用程序 +{: backend-applications} + +后端应用程序可以位于内部部署中，也可以位于公共云中。后端应用程序使用 {{site.data.keyword.mobilepushshort}} 服务将上下文相关通知发送给移动和浏览器应用程序用户。后端应用程序无需维护和管理用于发送推送通知的移动设备、浏览器代理程序和用户信息。相反，后端应用程序可以使用将用于对其进行管理和维护的 {{site.data.keyword.mobilepushshort}} 服务。 + +###应用程序后端所有者 +{: app-backend-owner} + +应用程序后端所有者会创建捆绑 {{site.data.keyword.mobilepushshort}} 服务实例的移动后端应用程序。应用程序后端所有者还会使用该服务搭配以 {{site.data.keyword.mobilepushshort}} 为目标的移动和浏览器应用程序，配置和设置 {{site.data.keyword.mobilepushshort}} 服务，以符合后端应用程序。 + +###{{site.data.keyword.mobilepushshort}} 服务 +{: push-notification-service} + +{{site.data.keyword.mobilepushshort}} 服务可管理与注册通知的移动设备和 Web 浏览器相关的所有信息。对于如何将通知发送给异构移动和 Web 浏览器平台，您的应用程序无需了解详细的技术信息，该服务会在其内部对所有这一切进行处理。 + +###网关 +{: gateways} + +平台特定的 Push Notifications 云服务（例如，IBM {{site.data.keyword.mobilepushshort}} 服务使用的 FCM/GCM 或 Apple 推送通知服务 (APNs)）将通知分派给移动和浏览器应用程序。 + +###推送安全 +{: push-security} + +{{site.data.keyword.mobilepushshort}} API 由两种类型的私钥进行保护： + +- **appSecret**：“appSecret”会保护通常由后端应用程序调用的 API，如用于发送 {{site.data.keyword.mobilepushshort}} 的 API 和用于配置设置的 API。 +- **clientSecret**：“clientSecret”会保护通常由移动客户端应用程序调用的 API。只有一个 API 与设备注册相关，且其相关联用户标识需要此“clientSecret”。从移动客户端调用的其他 API 没有一个需要 clientSecret。 + +在将应用程序与 {{site.data.keyword.mobilepushshort}} 服务绑定在一起时，“appSecret”和“clientSecret”会分配给每一个服务实例。 +请参阅 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/) 文档，以获取如何传递私钥以及相关联的 API 的更多信息。 + +**注**：仅在使用用户标识字段注册或更新设备时需要较早版本的应用程序来传递 clientSecret。移动和浏览器客户端调用的所有其他 API 不 +需要 clientSecret。这些旧应用程序可以选择针对设备注册或更新调用继续使用 clientSecret。但是，强烈建议对所有客户端 API 调用强制执行 clientSecret 检查。要在现有应用程序中强制执行此检查，已发布了一个新的“verifyClientSecret”API。对于所有新的应用程序，将对所有客户端 API 调用强制执行 clientSecret 检查，而此行为无法使用“verfiyClientSecret”API 进行更改。 + +缺省情况下，客户端密钥验证仅在新应用程序中强制执行。允许现有的和新的应用程序使用 verifyClientSecret REST API 启用或停用客户端密钥验证。建议您强制执行客户端密钥验证，以避免向可能了解 applicationId 和 deviceId 的用户公开设备。 + +请确保秘密保存“clientSecret”，绝不要将其硬编码到移动应用程序中。可以使用多种应用程序初始化模式，在应用程序运行时，动态地拉入“clientSecret”。时序图概述了此可能模式。 +![启用推送](images/init_client_secret.jpg) + +## {{site.data.keyword.mobilepushshort}} 类型 +{: #overview-push-types} + +###广播 +{: broadcast} + +当客户机应用程序在向 {{site.data.keyword.mobilepushshort}} 服务进行注册时即可开始接收广播。广播通知是向跨移动设备、浏览器安装，或实现为 Chrome 应用程序或扩展实例，以及针对 {{site.data.keyword.mobilepushshort}} 服务配置的所有应用程序实例发送的消息。缺省情况下，已启用 {{site.data.keyword.mobilepushshort}} 的任何应用程序都已启用广播通知。启用了 {{site.data.keyword.mobilepushshort}} 服务的应用程序都具有预定义的 Push.ALL 标记预订，服务器使用该标记来向所有设备广播通知消息。要使用 REST Push API 发送广播通知，请确保发布到消息资源时，“目标”是一个空的 JSON 文件。 + +###基于标记的通知 +{: tag-based-notifications} + +标记通知是针对预订了特定标记的所有设备的消息。基于标记的通知允许根据主题区域或主题对通知进行细分。通知接收方可以选择仅接收关于所关注主题的通知。因此，基于标记的通知提供了一种对接收方进行细分的方法。此功能可以定义标记，然后按标记发送和接收消息。消息的目标对象只包括已预订某标记的客户机应用程序实例（在移动、浏览器上或作为应用程序或扩展）。必须首先为应用程序创建标记，设置标记预订，然后再启动基于标记的通知。要使用 REST API 发送基于标记的通知，请确保发布到消息资源时提供了“tagNames”。 + +###单点广播通知 +{: unicast-notifications} + +单点广播通知是针对特定设备或用户的通知消息。单点广播通知不需要任何额外的设置，当应用程序启用了 {{site.data.keyword.mobilepushshort}} 时，缺省情况下就会启用单点广播通知。 + +但是，面向用户的单点广播通知要求在向 {{site.data.keyword.mobilepushshort}} 注册客户机移动设备或 Web 浏览器或 Chrome Apps and Extensions 时将用户标识与设备关联。 + +通常，客户机应用程序首先会运行认证周期，在这期间会针对认证服务（如 [Mobile Client Access](docs/services/mobileaccess/index.html)）认证移动应用程序用户。在成功认证之后，已认证的用户标识会传递至推送设备注册 API。要通过 REST API 发送单点广播通知，请确保发布到消息资源时提供了 deviceId 或 userId。 + +###基于平台的通知 +{: platform-based-notifications} + +可将通知定向发送到特定的设备平台。例如，可以只将通知发送给所有 Android 用户或 Google Chrome 用户。要使用 REST API 发送基于平台的通知，请确保发布到消息资源时提供了目标平台。将平台指定为数组。支持的平台如下所示： +* A (Apple) +* G (Google) +* WEB_CHROME（Google Chrome 浏览器 Web 推送） +* WEB_FIREFOX（Mozilla Firefox 浏览器 Web 推送） +* WEB_SAFARI（Safari 浏览器 Web 推送） +* APPEXT_CHROME (Google Chrome Apps & Extensions) + +## {{site.data.keyword.mobilepushshort}} 消息大小 +{: #push-message-size} + +{{site.data.keyword.mobilepushshort}} 消息有效内容大小取决于网关（FCM/GCM、APNs）和客户机平台规定的约束。 + +### iOS 和 Safari +{: ios-message-size} + +对于 iOS 8 和更高版本，所允许的最大大小为 2 KB。Apple 推送通知服务不会发送超过此限制的通知。 + +###Android、Firefox 浏览器、Chrome 浏览器以及 Chrome Apps & Extensions +{: android-message-size} + +允许的消息有效内容最大大小限制为 4 KB。 diff --git a/services/mobilepush/nl/zh/CN/c_rich_media_notifications.md b/services/mobilepush/nl/zh/CN/c_rich_media_notifications.md index 9ddc891b3..3f3b23880 100644 --- a/services/mobilepush/nl/zh/CN/c_rich_media_notifications.md +++ b/services/mobilepush/nl/zh/CN/c_rich_media_notifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 启用富媒体通知 -{: #interactive-notifications} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - - -您可以在 iOS 10 和以上版本中启用富媒体 {{site.data.keyword.mobilepushshort}}。推送通知可随音频、视频、GIF 和图像一起发送。 - -要设置应用程序在 iOS 10 上接收富媒体推送，请完成以下步骤： - -1. 在 Xcode 中，选择**文件** > **新建** > **目标** > **通知服务扩展**。 -2. 在 `UNNotificationServiceExtension` 的方法 `didReceive()` 上，添加代码。 -``` -BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) -``` - -要从“推送”仪表板发送富媒体 {{site.data.keyword.mobilepushshort}}，请确保您指定消息、标题、子标题和附件 URL 字段。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 启用富媒体通知 +{: #interactive-notifications} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + + +您可以在 iOS 10 和以上版本中启用富媒体 {{site.data.keyword.mobilepushshort}}。推送通知可随音频、视频、GIF 和图像一起发送。 + +要设置应用程序在 iOS 10 上接收富媒体推送，请完成以下步骤： + +1. 在 Xcode 中，选择**文件** > **新建** > **目标** > **通知服务扩展**。 +2. 在 `UNNotificationServiceExtension` 的方法 `didReceive()` 上，添加代码。 +``` +BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) +``` + +要从“推送”仪表板发送富媒体 {{site.data.keyword.mobilepushshort}}，请确保您指定消息、标题、子标题和附件 URL 字段。 diff --git a/services/mobilepush/nl/zh/CN/c_tag_basednotifications.md b/services/mobilepush/nl/zh/CN/c_tag_basednotifications.md index ec81efd3d..89e848122 100644 --- a/services/mobilepush/nl/zh/CN/c_tag_basednotifications.md +++ b/services/mobilepush/nl/zh/CN/c_tag_basednotifications.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 启用基于标记的通知 -{: #tag_based_notifications} -上次更新时间：2017 年 1 月 16 日 -{: .last-updated} - -基于标记的通知消息是针对预订了特定标记的所有设备的通知消息。 - -您可以定义标记，然后使用标记发送和接收消息。必须首先为应用程序创建标记，设置标记预订，然后再启动基于标记的通知。要使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 发送基于标记的通知，请确保发布到消息资源时提供了“tagName”。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 启用基于标记的通知 +{: #tag_based_notifications} +上次更新时间：2017 年 1 月 16 日 +{: .last-updated} + +基于标记的通知消息是针对预订了特定标记的所有设备的通知消息。 + +您可以定义标记，然后使用标记发送和接收消息。必须首先为应用程序创建标记，设置标记预订，然后再启动基于标记的通知。要使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 发送基于标记的通知，请确保发布到消息资源时提供了“tagName”。 diff --git a/services/mobilepush/nl/zh/CN/c_user_basednotifications.md b/services/mobilepush/nl/zh/CN/c_user_basednotifications.md index 2d8b64e58..69c7e02e6 100644 --- a/services/mobilepush/nl/zh/CN/c_user_basednotifications.md +++ b/services/mobilepush/nl/zh/CN/c_user_basednotifications.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 启用基于用户的通知 -{: #user_based_notifications} -上次更新时间：2017 年 1 月 16 日 -{: .last-updated} - -基于用户标识的 {{site.data.keyword.mobilepushshort}} 针对具有定制消息的移动应用程序用户。使用基于用户的通知，您可以根据首选项选择通知特定个人。 - -## 使用用户标识注册设备 -要按用户标识向目标推送通知，确保您在设置了用户标识字段的情况下注册设备。 - -用户标识可以是应用程序提供给设备注册 API 的任何字符串。通常，移动应用程序首先会运行认证周期，在这期间会针对认证服务（如 [{{site.data.keyword.amafull}} ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}）认证移动应用程序用户。在成功认证之后，已认证的用户标识会传递至推送设备注册 API。 - -## 同步用户登录和注销 - -您可以选择仅在用户登录时发送通知。 - -例如，假设设备由家庭或工作团队的成员共享，而您需要定址特定用户。在此用例中，将会有用户登录和注销序列。此认证机制允许应用程序跟踪应用程序当前用户的身份。这样确保针对特定用户的通知始终由该用户接收。成功登录之后，调用传递登录用户的用户标识的设备注册 API。同样，在注销之前，调用设备注销 API。使用登录和注销对这些 Push API 进行序列化可确保针对特定用户的通知仅会发送到该用户。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 启用基于用户的通知 +{: #user_based_notifications} +上次更新时间：2017 年 1 月 16 日 +{: .last-updated} + +基于用户标识的 {{site.data.keyword.mobilepushshort}} 针对具有定制消息的移动应用程序用户。使用基于用户的通知，您可以根据首选项选择通知特定个人。 + +## 使用用户标识注册设备 +要按用户标识向目标推送通知，确保您在设置了用户标识字段的情况下注册设备。 + +用户标识可以是应用程序提供给设备注册 API 的任何字符串。通常，移动应用程序首先会运行认证周期，在这期间会针对认证服务（如 [{{site.data.keyword.amafull}} ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}）认证移动应用程序用户。在成功认证之后，已认证的用户标识会传递至推送设备注册 API。 + +## 同步用户登录和注销 + +您可以选择仅在用户登录时发送通知。 + +例如，假设设备由家庭或工作团队的成员共享，而您需要定址特定用户。在此用例中，将会有用户登录和注销序列。此认证机制允许应用程序跟踪应用程序当前用户的身份。这样确保针对特定用户的通知始终由该用户接收。成功登录之后，调用传递登录用户的用户标识的设备注册 API。同样，在注销之前，调用设备注销 API。使用登录和注销对这些 Push API 进行序列化可确保针对特定用户的通知仅会发送到该用户。 diff --git a/services/mobilepush/nl/zh/CN/c_web_extensions.md b/services/mobilepush/nl/zh/CN/c_web_extensions.md index 19401d9f6..0e888a919 100644 --- a/services/mobilepush/nl/zh/CN/c_web_extensions.md +++ b/services/mobilepush/nl/zh/CN/c_web_extensions.md @@ -1,107 +1,107 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 让 Chrome Apps and Extensions 能够接收 {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -上次更新时间：2017 年 1 月 18 日 -{: .last-updated} - -您可以支持 Chrome Apps and Extensions 接收 {{site.data.keyword.mobilepushshort}}。请确保您已经完成[配置通知提供程序的凭证](t__main_push_config_provider.html)，然后再继续相关步骤。 - -## 安装客户机 SDK 以支持 {{site.data.keyword.mobilepushshort}} -{: #web_install} - -本主题描述如何安装和使用客户机 JavaScript 推送 SDK 来进一步开发 Chrome Apps and Extensions。 - -### Google Chrome Apps and Extensions 中的初始化 - -要在 Chrome Apps and Extensions 中安装 JavaScript SDK，请完成以下步骤： - -从 [Bluemix Web 推送 SDK ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window} 下载 `BMSPushSDK.js` 和 `manifest_Chrome_Ext.json`（对于 Chrome Extensions）或 `manifest_Chrome_App.json`（对于 Chrome Apps）。 - - - -- 对于 Chrome Apps，请配置清单文件： - 1. 在 `manifest_Chrome_App.json` 文件中，提供名称、描述和图标。 - 2. 在 `app.background.scripts` 中添加 `BMSPushSDK.js`。 - 3. 将 `manifest_Chrome_App.json` 更改为 `manifest.json`。 - -- 对于 Chrome Extensions，请配置清单文件： - 1. 在 `manifest_Chrome_Ext.json` 文件中，提供名称、描述和图标。 - 2. 在 `background.scripts` 中添加 `BMSPushSDK.js`。 - 3. 将 `manifest_Chrome_Ext.json` 更改为 `manifest.json`。 - -在 `background.js` 文件中，添加以下内容以接收推送通知。 -``` -chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) -chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); -chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); -``` - {: codeblock} - - - -## 初始化 推送 SDK -{: #web_initialize} - -通过 Bluemix {{site.data.keyword.mobilepushshort}} 服务 `app GUID` 和 `app Region` 初始化推送 SDK。 - -要获取您的应用程序 GUID，在初始化的推送服务的导航窗格中选择**配置**选项，并单击**移动选项**。修改代码片段以使用 Bluemix 推送通知服务 appGUID 参数。 - -`App Region` 指定托管 {{site.data.keyword.mobilepushshort}} 服务的位置。可以使用以下三个值中的一个值： - - - 对于美国达拉斯：`.ng.bluemix.net` - - 对于英国：`.eu-gb.bluemix.net` - - 对于悉尼：`.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) -``` - {: codeblock} - -## 注册 Chrome Apps and Extensions -{: #web_register} - -使用 `register()` API 向 {{site.data.keyword.mobilepushshort}} 服务注册设备。对于从 Google Chrome 注册，请在 Bluemix {{site.data.keyword.mobilepushshort}} 服务 Web 配置仪表板中添加 Firebase 云消息传递 (FCM) 和 Google 云消息传递 (GCM) API 密钥和 Web 站点 URL。有关更多信息，请参阅 Chrome 设置下的[为 Google 云消息传递配置凭证](t_push_provider_android.html)。 - -对于从 Mozilla Firefox 注册，在 Firefox 设置下的 Bluemix {{site.data.keyword.mobilepushshort}} 服务 Web 配置仪表板中添加 Web 站点 URL。 - -使用以下代码片段在 Bluemix {{site.data.keyword.mobilepushshort}} 服务中注册。 -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 让 Chrome Apps and Extensions 能够接收 {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +上次更新时间：2017 年 1 月 18 日 +{: .last-updated} + +您可以支持 Chrome Apps and Extensions 接收 {{site.data.keyword.mobilepushshort}}。请确保您已经完成[配置通知提供程序的凭证](t__main_push_config_provider.html)，然后再继续相关步骤。 + +## 安装客户机 SDK 以支持 {{site.data.keyword.mobilepushshort}} +{: #web_install} + +本主题描述如何安装和使用客户机 JavaScript 推送 SDK 来进一步开发 Chrome Apps and Extensions。 + +### Google Chrome Apps and Extensions 中的初始化 + +要在 Chrome Apps and Extensions 中安装 JavaScript SDK，请完成以下步骤： + +从 [Bluemix Web 推送 SDK ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window} 下载 `BMSPushSDK.js` 和 `manifest_Chrome_Ext.json`（对于 Chrome Extensions）或 `manifest_Chrome_App.json`（对于 Chrome Apps）。 + + + +- 对于 Chrome Apps，请配置清单文件： + 1. 在 `manifest_Chrome_App.json` 文件中，提供名称、描述和图标。 + 2. 在 `app.background.scripts` 中添加 `BMSPushSDK.js`。 + 3. 将 `manifest_Chrome_App.json` 更改为 `manifest.json`。 + +- 对于 Chrome Extensions，请配置清单文件： + 1. 在 `manifest_Chrome_Ext.json` 文件中，提供名称、描述和图标。 + 2. 在 `background.scripts` 中添加 `BMSPushSDK.js`。 + 3. 将 `manifest_Chrome_Ext.json` 更改为 `manifest.json`。 + +在 `background.js` 文件中，添加以下内容以接收推送通知。 +``` +chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) +chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); +chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); +``` + {: codeblock} + + + +## 初始化 推送 SDK +{: #web_initialize} + +通过 Bluemix {{site.data.keyword.mobilepushshort}} 服务 `app GUID` 和 `app Region` 初始化推送 SDK。 + +要获取您的应用程序 GUID，在初始化的推送服务的导航窗格中选择**配置**选项，并单击**移动选项**。修改代码片段以使用 Bluemix 推送通知服务 appGUID 参数。 + +`App Region` 指定托管 {{site.data.keyword.mobilepushshort}} 服务的位置。可以使用以下三个值中的一个值： + + - 对于美国达拉斯：`.ng.bluemix.net` + - 对于英国：`.eu-gb.bluemix.net` + - 对于悉尼：`.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) +``` + {: codeblock} + +## 注册 Chrome Apps and Extensions +{: #web_register} + +使用 `register()` API 向 {{site.data.keyword.mobilepushshort}} 服务注册设备。对于从 Google Chrome 注册，请在 Bluemix {{site.data.keyword.mobilepushshort}} 服务 Web 配置仪表板中添加 Firebase 云消息传递 (FCM) 和 Google 云消息传递 (GCM) API 密钥和 Web 站点 URL。有关更多信息，请参阅 Chrome 设置下的[为 Google 云消息传递配置凭证](t_push_provider_android.html)。 + +对于从 Mozilla Firefox 注册，在 Firefox 设置下的 Bluemix {{site.data.keyword.mobilepushshort}} 服务 Web 配置仪表板中添加 Web 站点 URL。 + +使用以下代码片段在 Bluemix {{site.data.keyword.mobilepushshort}} 服务中注册。 +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + diff --git a/services/mobilepush/nl/zh/CN/c_web_extensions_send.md b/services/mobilepush/nl/zh/CN/c_web_extensions_send.md index 4ea71f2c5..0a03d7539 100644 --- a/services/mobilepush/nl/zh/CN/c_web_extensions_send.md +++ b/services/mobilepush/nl/zh/CN/c_web_extensions_send.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 向 Chrome Apps and Extensions 发送基本通知 -{: #web_extensions_notifications} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - -开发应用程序后，可以发送推送通知。 - -1. 选择**发送通知**，并通过选择 **Web 通知**作为**发送至**选项来编辑消息。 -2. 键入需要在**消息**字段中传递的消息。 -3. 您可以选择提供可选设置： - - **通知标题**：这是作为消息警报标题显示的文本。 - - **通知图标 URL**：如果您的消息需要与应用程序通知图标一起传递，请在字段中提供图标的链接。 - - **折叠键**：折叠键附加在通知上。如果设备脱机时多个通知使用相同的折叠键按顺序抵达，那么将折叠通知。在设备联机时，将从 FCM/GCM 服务器接收通知，并只显示带有相同折叠键的最新通知。如果没有设置折叠键，将存储新和旧的消息，以在以后传递。 - - **生存时间**：此值以秒为单位进行设置。如果未指定此参数，FCM/GCM 服务器将把消息存储 4 周时间并将尝试传递。4 周后有效性到期。值可以为 0 至 2,419,200 秒之间的值。 - - **空闲时延迟**：将此值设置为 `true` 将指示 FCM/GCM 服务器在设备空闲时不要传递通知。将此值设置为 `false`，以确保在设备空闲时传递通知。 - - **其他有效内容**：为您的通知指定定制的有效内容值。 - -下面的图像显示仪表板中的 Chrome Apps and Extensions 通知选项。 - - ![“通知”屏幕](images/push_chrome_extns.jpg) - -## 后续步骤 - {: #next_steps_tags} - -成功设置基本通知后，可以选择配置基于标记的通知和高级选项。 - -将这些 {{site.data.keyword.mobilepushshort}} 服务功能添加到应用程序中。要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。要使用高级通知选项，请参阅[高级通知](t_advance_badge_sound_payload.html)。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 向 Chrome Apps and Extensions 发送基本通知 +{: #web_extensions_notifications} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + +开发应用程序后，可以发送推送通知。 + +1. 选择**发送通知**，并通过选择 **Web 通知**作为**发送至**选项来编辑消息。 +2. 键入需要在**消息**字段中传递的消息。 +3. 您可以选择提供可选设置： + - **通知标题**：这是作为消息警报标题显示的文本。 + - **通知图标 URL**：如果您的消息需要与应用程序通知图标一起传递，请在字段中提供图标的链接。 + - **折叠键**：折叠键附加在通知上。如果设备脱机时多个通知使用相同的折叠键按顺序抵达，那么将折叠通知。在设备联机时，将从 FCM/GCM 服务器接收通知，并只显示带有相同折叠键的最新通知。如果没有设置折叠键，将存储新和旧的消息，以在以后传递。 + - **生存时间**：此值以秒为单位进行设置。如果未指定此参数，FCM/GCM 服务器将把消息存储 4 周时间并将尝试传递。4 周后有效性到期。值可以为 0 至 2,419,200 秒之间的值。 + - **空闲时延迟**：将此值设置为 `true` 将指示 FCM/GCM 服务器在设备空闲时不要传递通知。将此值设置为 `false`，以确保在设备空闲时传递通知。 + - **其他有效内容**：为您的通知指定定制的有效内容值。 + +下面的图像显示仪表板中的 Chrome Apps and Extensions 通知选项。 + + ![“通知”屏幕](images/push_chrome_extns.jpg) + +## 后续步骤 + {: #next_steps_tags} + +成功设置基本通知后，可以选择配置基于标记的通知和高级选项。 + +将这些 {{site.data.keyword.mobilepushshort}} 服务功能添加到应用程序中。要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。要使用高级通知选项，请参阅[高级通知](t_advance_badge_sound_payload.html)。 diff --git a/services/mobilepush/nl/zh/CN/images/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/zh/CN/images/t_enable_actionable_notifications_ios.md index 3df95a5d8..e60ef5309 100644 --- a/services/mobilepush/nl/zh/CN/images/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/zh/CN/images/t_enable_actionable_notifications_ios.md @@ -1,100 +1,100 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 启用针对 iOS 的可操作通知 -{: #enable-actionable-notifications-ios} - -与传统推送通知不同，可操作通知会提示用户在收到通知警报时进行相应的选择，而无需打开应用程序。请使用以下指示信息在应用程序中启用可操作推送通知。 - -1. 创建用户响应操作。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. 创建通知类别并设置操作。**UIUserNotificationActionContextDefault** 或 **UIUserNotificationActionContextMinimal** 是有效的上下文。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. 创建通知设置并分配前一步中的类别。 - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. 创建本地或远程通知，并为其分配类别的标识。 - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; -[[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories)application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# 启用针对 iOS 的可操作通知 +{: #enable-actionable-notifications-ios} + +与传统推送通知不同，可操作通知会提示用户在收到通知警报时进行相应的选择，而无需打开应用程序。请使用以下指示信息在应用程序中启用可操作推送通知。 + +1. 创建用户响应操作。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. 创建通知类别并设置操作。**UIUserNotificationActionContextDefault** 或 **UIUserNotificationActionContextMinimal** 是有效的上下文。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. 创建通知设置并分配前一步中的类别。 + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. 创建本地或远程通知，并为其分配类别的标识。 + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; +[[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories)application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/zh/CN/index.md b/services/mobilepush/nl/zh/CN/index.md index c6b4df66c..6f12322c0 100644 --- a/services/mobilepush/nl/zh/CN/index.md +++ b/services/mobilepush/nl/zh/CN/index.md @@ -1,55 +1,55 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}} 入门 -{: #gettingstartedtemplate} -上次更新时间：2017 年 1 月 19 日 -{: .last-updated} - -{:shortdesc} - -{{site.data.keyword.mobilepushshort}} 在 Mobile 类别中作为 Bluemix 目录服务提供，使您能够发送和管理移动和 Web 推送通知。 -该服务可管理应用程序用户到设备的映射、管理设备平台和Web 浏览器，同时处理通知的分派。 - - {{site.data.keyword.mobilepushshort}} 作为 MobileFirst Services Starter 样板的一部分和 Bluemix [专用服务](/docs/dedicated/index.html)提供。您可以使用此服务向移动和 Web 浏览器应用程序用户发送广播、单点广播（基于 deviceID 和 userID）、基于标记的通知、基于 Webhook 事件的通知，以及富媒体通知和交互式通知。您还可以使用 SDK（软件开发包）和 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} 来进一步开发您的客户机应用程序。 - -该服务还为您提供监视功能，可帮助您通过从用户数据生成图形和报告，来监视 Push Notification 性能。请参阅[监视 Push Notifications](/docs/services/mobilepush/t_push_monitoring.html)。 - -以下平台支持 {{site.data.keyword.mobilepushshort}} 服务： - -- [iOS 和 Android 移动设备](/docs/services/mobilepush/c_enable_push.html) -- [Google Chrome、Mozilla Firefox 和 Safari Web 浏览器](/docs/services/mobilepush/c_chrome_firefox_enable.html) -- [Google Chrome Apps and Extensions](/docs/services/mobilepush/c_web_extensions.html) - - -# 相关链接 -{: #rellinks} - -* [概述 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](c_overview_push.html){: new_window} - -## 教程和样本 {:id="samples"} -{: #samples} -* [Android helloPush 样本应用程序 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} -- [Cordova 样本应用程序 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} -* [iOS helloPush 样本应用程序 (Swift) ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} - -## SDK -{: #sdk} -* [Android SDK ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} -* [Cordova SDK ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} -* [iOS SDK (Swift) ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} - -## API 参考 -{: #api} -* [Push API 参考 (Android) ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} -* [BMSPush API 参考 iOS (Swift) ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} -* [REST API 参考![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}} 入门 +{: #gettingstartedtemplate} +上次更新时间：2017 年 1 月 19 日 +{: .last-updated} + +{:shortdesc} + +{{site.data.keyword.mobilepushshort}} 在 Mobile 类别中作为 Bluemix 目录服务提供，使您能够发送和管理移动和 Web 推送通知。 +该服务可管理应用程序用户到设备的映射、管理设备平台和Web 浏览器，同时处理通知的分派。 + + {{site.data.keyword.mobilepushshort}} 作为 MobileFirst Services Starter 样板的一部分和 Bluemix [专用服务](/docs/dedicated/index.html)提供。您可以使用此服务向移动和 Web 浏览器应用程序用户发送广播、单点广播（基于 deviceID 和 userID）、基于标记的通知、基于 Webhook 事件的通知，以及富媒体通知和交互式通知。您还可以使用 SDK（软件开发包）和 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} 来进一步开发您的客户机应用程序。 + +该服务还为您提供监视功能，可帮助您通过从用户数据生成图形和报告，来监视 Push Notification 性能。请参阅[监视 Push Notifications](/docs/services/mobilepush/t_push_monitoring.html)。 + +以下平台支持 {{site.data.keyword.mobilepushshort}} 服务： + +- [iOS 和 Android 移动设备](/docs/services/mobilepush/c_enable_push.html) +- [Google Chrome、Mozilla Firefox 和 Safari Web 浏览器](/docs/services/mobilepush/c_chrome_firefox_enable.html) +- [Google Chrome Apps and Extensions](/docs/services/mobilepush/c_web_extensions.html) + + +# 相关链接 +{: #rellinks} + +* [概述 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](c_overview_push.html){: new_window} + +## 教程和样本 {:id="samples"} +{: #samples} +* [Android helloPush 样本应用程序 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} +- [Cordova 样本应用程序 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} +* [iOS helloPush 样本应用程序 (Swift) ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} + +## SDK +{: #sdk} +* [Android SDK ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} +* [Cordova SDK ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} +* [iOS SDK (Swift) ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} + +## API 参考 +{: #api} +* [Push API 参考 (Android) ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} +* [BMSPush API 参考 iOS (Swift) ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} +* [REST API 参考![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} diff --git a/services/mobilepush/nl/zh/CN/interactive_notifications.md b/services/mobilepush/nl/zh/CN/interactive_notifications.md index b47d89e07..259ec5364 100644 --- a/services/mobilepush/nl/zh/CN/interactive_notifications.md +++ b/services/mobilepush/nl/zh/CN/interactive_notifications.md @@ -1,83 +1,83 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 交互式通知 -{: #interactive-notifications} -上次更新时间：2017 年 1 月 23 日 -{: .last-updated} - -使用交互式通知，用户可以在不打开应用程序的情况下响应通知。当交互式通知到达时，设备会显示通知消息及相应的操作按钮。V8 或更高版本的 iOS 设备上支持交互式通知。对于向版本低于 V8 的 iOS 设备发送的交互式通知，不会显示通知操作。 - -##发送交互式 {{site.data.keyword.mobilepushshort}} - - -使用“推送”仪表板或使用 [REST API 文档](t_restapi.html)可发送交互式通知。 - -从 {{site.data.keyword.mobilepushshort}} 控制台： - -1. 在“推送”仪表板中的“通知”选项卡上，单击**发送通知**。 -2. 选择通知收件人，并单击**下一步**。 -3. 在编写通知页面上，可以通过将“类型”设置为“缺省值”或“混合”并在“高级选项”选项卡下指定“类别”值来发送交互式推送。要在客户机上配置类别值，请查看“在本机 iOS 应用程序中**处理交互式 {{site.data.keyword.mobilepushshort}}**”一节。 - -## 在 iOS 应用程序中处理交互式 {{site.data.keyword.mobilepushshort}} - - -### Swift - -完成以下步骤以接收交互式通知： - -1. 为应用程序启用在后台执行接收远程通知任务的功能。 -1. 使用您的操作类别，初始化`BMSPush` SDK。 - ``` - let myBMSClient = BMSClient.sharedInstance - myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) - let push = BMSPushClient.sharedInstance - let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) - let notifOptions = BMSPushClientOptions(categoryName: [category]) - push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) - ``` - {: codeblock} - -1. 在 AppDelegate 上实施新回调方法： - ``` - func userNotificationCenter(_ center: UNUserNotificationCenter, - didReceive response: UNNotificationResponse, - withCompletionHandler completionHandler: @escaping () -> Void) { - switch response.actionIdentifier { - case "FIRST": - print("FIRST") - case "SECOND": - print("SECOND") - default: - print("Unknown action") - } - completionHandler - } - ``` - {: codeblock} -5. 用户单击操作按钮时，将调用此新回调方法。要实施此方法，必须执行与指定标识关联的任务，并执行 `completionHandler` 参数中的块。 - - -### Cordova - -要在 Cordova iOS 应用程序中获取可操作通知，请完成以下步骤： - -1. 在 `BMSPush.initialize` 方法内添加类别字段。 - ``` - var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} - BMSPush.initialize(appGUID,clientSecret,category); - ``` - {: codeblock} -2. 在 AppDelegate 上实施新回调方法。 -3. 用户单击操作按钮时，将调用此新回调方法。要实施此方法，必须执行与指定标识关联的任务，并执行 completionHandler 参数中的块。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 交互式通知 +{: #interactive-notifications} +上次更新时间：2017 年 1 月 23 日 +{: .last-updated} + +使用交互式通知，用户可以在不打开应用程序的情况下响应通知。当交互式通知到达时，设备会显示通知消息及相应的操作按钮。V8 或更高版本的 iOS 设备上支持交互式通知。对于向版本低于 V8 的 iOS 设备发送的交互式通知，不会显示通知操作。 + +##发送交互式 {{site.data.keyword.mobilepushshort}} + + +使用“推送”仪表板或使用 [REST API 文档](t_restapi.html)可发送交互式通知。 + +从 {{site.data.keyword.mobilepushshort}} 控制台： + +1. 在“推送”仪表板中的“通知”选项卡上，单击**发送通知**。 +2. 选择通知收件人，并单击**下一步**。 +3. 在编写通知页面上，可以通过将“类型”设置为“缺省值”或“混合”并在“高级选项”选项卡下指定“类别”值来发送交互式推送。要在客户机上配置类别值，请查看“在本机 iOS 应用程序中**处理交互式 {{site.data.keyword.mobilepushshort}}**”一节。 + +## 在 iOS 应用程序中处理交互式 {{site.data.keyword.mobilepushshort}} + + +### Swift + +完成以下步骤以接收交互式通知： + +1. 为应用程序启用在后台执行接收远程通知任务的功能。 +1. 使用您的操作类别，初始化`BMSPush` SDK。 + ``` + let myBMSClient = BMSClient.sharedInstance + myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) + let push = BMSPushClient.sharedInstance + let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) + let notifOptions = BMSPushClientOptions(categoryName: [category]) + push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) + ``` + {: codeblock} + +1. 在 AppDelegate 上实施新回调方法： + ``` + func userNotificationCenter(_ center: UNUserNotificationCenter, + didReceive response: UNNotificationResponse, + withCompletionHandler completionHandler: @escaping () -> Void) { + switch response.actionIdentifier { + case "FIRST": + print("FIRST") + case "SECOND": + print("SECOND") + default: + print("Unknown action") + } + completionHandler + } + ``` + {: codeblock} +5. 用户单击操作按钮时，将调用此新回调方法。要实施此方法，必须执行与指定标识关联的任务，并执行 `completionHandler` 参数中的块。 + + +### Cordova + +要在 Cordova iOS 应用程序中获取可操作通知，请完成以下步骤： + +1. 在 `BMSPush.initialize` 方法内添加类别字段。 + ``` + var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} + BMSPush.initialize(appGUID,clientSecret,category); + ``` + {: codeblock} +2. 在 AppDelegate 上实施新回调方法。 +3. 用户单击操作按钮时，将调用此新回调方法。要实施此方法，必须执行与指定标识关联的任务，并执行 completionHandler 参数中的块。 diff --git a/services/mobilepush/nl/zh/CN/next_steps_tags.md b/services/mobilepush/nl/zh/CN/next_steps_tags.md index 325d92634..f5801365e 100644 --- a/services/mobilepush/nl/zh/CN/next_steps_tags.md +++ b/services/mobilepush/nl/zh/CN/next_steps_tags.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 后续步骤 -{: #next_steps_tags} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - -成功设置基本通知后，可以配置基于标记的通知和高级选项。 - -将这些 {{site.data.keyword.mobilepushshort}} 服务功能添加到应用程序中。 -要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 -要使用高级通知选项，请参阅[高级推送通知](t_advance_badge_sound_payload.html)。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 后续步骤 +{: #next_steps_tags} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + +成功设置基本通知后，可以配置基于标记的通知和高级选项。 + +将这些 {{site.data.keyword.mobilepushshort}} 服务功能添加到应用程序中。 +要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 +要使用高级通知选项，请参阅[高级推送通知](t_advance_badge_sound_payload.html)。 diff --git a/services/mobilepush/nl/zh/CN/silent_notifications.md b/services/mobilepush/nl/zh/CN/silent_notifications.md index 8731e0ae9..a7203be7e 100644 --- a/services/mobilepush/nl/zh/CN/silent_notifications.md +++ b/services/mobilepush/nl/zh/CN/silent_notifications.md @@ -1,39 +1,39 @@ ------- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 处理针对 iOS 的静默通知 -{: #silent-notifications} -上次更新时间：2017 年 1 月 16 日 -{: .last-updated} - -静默通知不会显示在设备屏幕上。这些通知由应用程序在后台进行接收，这会将应用程序唤醒最多 30 秒来执行指定的后台任务。用户可能并不知道有通知到达。要针对 iOS 发送静默通知，请使用 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window}。 - -1. 要发送静默推送通知，请在项目的 `appDelegate.m` 文件中实施以下方法。在 Swift 中，服务器针对静默通知发送的 `contentAvailable` 值等于 1。 -``` -//For Swift - func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - let contentAPS = userInfo["aps"] as [NSObject : AnyObject] - if let contentAvailable = contentAPS["content-available"] as? Int { - //silent or mixed push - if contentAvailable == 1 { - completionHandler(UIBackgroundFetchResult.NewData) - } else { - completionHandler(UIBackgroundFetchResult.NoData) - } - } else { - //Default notification - completionHandler(UIBackgroundFetchResult.NoData) - } - } -``` - {: codeblock} - +------ + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 处理针对 iOS 的静默通知 +{: #silent-notifications} +上次更新时间：2017 年 1 月 16 日 +{: .last-updated} + +静默通知不会显示在设备屏幕上。这些通知由应用程序在后台进行接收，这会将应用程序唤醒最多 30 秒来执行指定的后台任务。用户可能并不知道有通知到达。要针对 iOS 发送静默通知，请使用 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window}。 + +1. 要发送静默推送通知，请在项目的 `appDelegate.m` 文件中实施以下方法。在 Swift 中，服务器针对静默通知发送的 `contentAvailable` 值等于 1。 +``` +//For Swift + func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + let contentAPS = userInfo["aps"] as [NSObject : AnyObject] + if let contentAvailable = contentAPS["content-available"] as? Int { + //silent or mixed push + if contentAvailable == 1 { + completionHandler(UIBackgroundFetchResult.NewData) + } else { + completionHandler(UIBackgroundFetchResult.NoData) + } + } else { + //Default notification + completionHandler(UIBackgroundFetchResult.NoData) + } + } +``` + {: codeblock} + diff --git a/services/mobilepush/nl/zh/CN/t__main_push_config_provider.md b/services/mobilepush/nl/zh/CN/t__main_push_config_provider.md index e1a2e6a61..3a2ec3087 100644 --- a/services/mobilepush/nl/zh/CN/t__main_push_config_provider.md +++ b/services/mobilepush/nl/zh/CN/t__main_push_config_provider.md @@ -1,21 +1,21 @@ - ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 配置通知提供者凭证 -{: #create-push-credentials} -上次更新时间：2017 年 1 月 18 日 -{: .last-updated} - -要设置 {{site.data.keyword.mobilepushshort}} 服务，从推送通知提供程序获取移动设备所需的凭证 - Firebase 云消息传递 ([FCM](t_push_provider_android.html)) 或 Apple Push Notification 服务 ([APN](t_push_provider_ios.html))。对于 Web 浏览器，请参阅[配置 Web 浏览器的凭证](t_push_provider_safari.html)。 - -您可以使用 **IBM Bluemix Services** 仪表板或使用 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} 来设置 {{site.data.keyword.mobilepushshort}}。 + +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 配置通知提供者凭证 +{: #create-push-credentials} +上次更新时间：2017 年 1 月 18 日 +{: .last-updated} + +要设置 {{site.data.keyword.mobilepushshort}} 服务，从推送通知提供程序获取移动设备所需的凭证 - Firebase 云消息传递 ([FCM](t_push_provider_android.html)) 或 Apple Push Notification 服务 ([APN](t_push_provider_ios.html))。对于 Web 浏览器，请参阅[配置 Web 浏览器的凭证](t_push_provider_safari.html)。 + +您可以使用 **IBM Bluemix Services** 仪表板或使用 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} 来设置 {{site.data.keyword.mobilepushshort}}。 diff --git a/services/mobilepush/nl/zh/CN/t_advance_badge_sound_payload.md b/services/mobilepush/nl/zh/CN/t_advance_badge_sound_payload.md index 71a78883d..58298ee45 100644 --- a/services/mobilepush/nl/zh/CN/t_advance_badge_sound_payload.md +++ b/services/mobilepush/nl/zh/CN/t_advance_badge_sound_payload.md @@ -1,78 +1,78 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#启用高级 {{site.data.keyword.mobilepushshort}} -上次更新时间：2017 年 1 月 23 日 -{: .last-updated} - -配置 iOS 角标、声音、其他 JSON 有效内容、可操作通知和暂停通知。 - -## 配置声音、有效内容和 iOS 角标 -{: #badge-sound-payload} - -配置 iOS 角标、声音和其他 JSON 有效内容。 - -1. 在 {{site.data.keyword.mobilepushshort}} 仪表板上，转至**通知**选项卡。 -2. 转至**可选字段**部分，以配置 {{site.data.keyword.mobilepushshort}} 功能。 - - **声音文件** - 输入字符串，以指向移动应用程序中的声音文件。在有效内容中，指定要使用的声音文件的字符串名称。 - - **iOS 角标** - 对于 iOS 设备，要显示为应用程序图标角标的数字。如果缺少此属性，那么角标不会改变。要除去角标，请将此属性的值设置为 0。 - -###Android - -将声音文件添加到 Android 应用程序的 `res/raw` 目录中。发送通知时，在 {{site.data.keyword.mobilepushshort}} 的声音字段中添加声音文件名。 - -``` -"settings":{ - "gcm":{ - "sound":"tt.wav", - } - } -``` - {: codeblock} - -###iOS - -``` -"settings": { - "apns" : { - "badge": 10, - "sound": "tt.wav", - } - } -``` - {: codeblock} - -**其他有效内容** - 此有效内容可以是任何键/值对，但必须为要与 {{site.data.keyword.mobilepushshort}} 一起发送的 JSON 对象。 - - -``` -{"key":"value", "key2":"value2"} -``` - {: codeblock} - -## 暂停 Android 通知 -{: #hold-notifications-android} - -应用程序转入后台运行时，您可能希望 {{site.data.keyword.mobilepushshort}} 暂停发送给应用程序的通知。要暂停通知，请调用处理 {{site.data.keyword.mobilepushshort}} 的活动的 onPause() 方法中的 hold() 方法。 - -``` -@Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +#启用高级 {{site.data.keyword.mobilepushshort}} +上次更新时间：2017 年 1 月 23 日 +{: .last-updated} + +配置 iOS 角标、声音、其他 JSON 有效内容、可操作通知和暂停通知。 + +## 配置声音、有效内容和 iOS 角标 +{: #badge-sound-payload} + +配置 iOS 角标、声音和其他 JSON 有效内容。 + +1. 在 {{site.data.keyword.mobilepushshort}} 仪表板上，转至**通知**选项卡。 +2. 转至**可选字段**部分，以配置 {{site.data.keyword.mobilepushshort}} 功能。 + - **声音文件** - 输入字符串，以指向移动应用程序中的声音文件。在有效内容中，指定要使用的声音文件的字符串名称。 + - **iOS 角标** - 对于 iOS 设备，要显示为应用程序图标角标的数字。如果缺少此属性，那么角标不会改变。要除去角标，请将此属性的值设置为 0。 + +###Android + +将声音文件添加到 Android 应用程序的 `res/raw` 目录中。发送通知时，在 {{site.data.keyword.mobilepushshort}} 的声音字段中添加声音文件名。 + +``` +"settings":{ + "gcm":{ + "sound":"tt.wav", + } + } +``` + {: codeblock} + +###iOS + +``` +"settings": { + "apns" : { + "badge": 10, + "sound": "tt.wav", + } + } +``` + {: codeblock} + +**其他有效内容** - 此有效内容可以是任何键/值对，但必须为要与 {{site.data.keyword.mobilepushshort}} 一起发送的 JSON 对象。 + + +``` +{"key":"value", "key2":"value2"} +``` + {: codeblock} + +## 暂停 Android 通知 +{: #hold-notifications-android} + +应用程序转入后台运行时，您可能希望 {{site.data.keyword.mobilepushshort}} 暂停发送给应用程序的通知。要暂停通知，请调用处理 {{site.data.keyword.mobilepushshort}} 的活动的 onPause() 方法中的 hold() 方法。 + +``` +@Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} + + diff --git a/services/mobilepush/nl/zh/CN/t_android_create_unbound_service.md b/services/mobilepush/nl/zh/CN/t_android_create_unbound_service.md index 8de551020..a22a9b200 100644 --- a/services/mobilepush/nl/zh/CN/t_android_create_unbound_service.md +++ b/services/mobilepush/nl/zh/CN/t_android_create_unbound_service.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 针对 Android 创建未绑定 {{site.data.keyword.mobilepushshort}} 服务 -{: #create_android_unbound} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - -创建 {{site.data.keyword.mobilepushshort}} 服务实例。您可以在未绑定任何后端应用程序的情况下使用 {{site.data.keyword.mobilepushshort}} 服务实例。 - -1. 将 {{site.data.keyword.mobilepushshort}} 服务实例绑定到 Bluemix 应用程序。在绑定时，您将能够看到与该服务相关的所有详细信息以 JSON 格式存储在 VCAP_SERVICES 环境变量中。 - -![绑定 Push Notification 服务](images/unbound_1.jpg) - 2. 单击**绑定**并选择要绑定的 {{site.data.keyword.mobilepushshort}} 服务实例。当应用程序绑定到 {{site.data.keyword.mobilepushshort}} 服务时，有关该服务的信息将以 JSON 格式存储在应用程序的 VCAP_SERVICES 环境变量中。例如： -``` - { - "imfpush_Dev": [ - { - "name": "myname_sampleUnbound", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": null - } - ] - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 针对 Android 创建未绑定 {{site.data.keyword.mobilepushshort}} 服务 +{: #create_android_unbound} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + +创建 {{site.data.keyword.mobilepushshort}} 服务实例。您可以在未绑定任何后端应用程序的情况下使用 {{site.data.keyword.mobilepushshort}} 服务实例。 + +1. 将 {{site.data.keyword.mobilepushshort}} 服务实例绑定到 Bluemix 应用程序。在绑定时，您将能够看到与该服务相关的所有详细信息以 JSON 格式存储在 VCAP_SERVICES 环境变量中。 + +![绑定 Push Notification 服务](images/unbound_1.jpg) + 2. 单击**绑定**并选择要绑定的 {{site.data.keyword.mobilepushshort}} 服务实例。当应用程序绑定到 {{site.data.keyword.mobilepushshort}} 服务时，有关该服务的信息将以 JSON 格式存储在应用程序的 VCAP_SERVICES 环境变量中。例如： +``` + { + "imfpush_Dev": [ + { + "name": "myname_sampleUnbound", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": null + } + ] + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/zh/CN/t_android_initialize.md b/services/mobilepush/nl/zh/CN/t_android_initialize.md index 5d920111d..34d720ef9 100644 --- a/services/mobilepush/nl/zh/CN/t_android_initialize.md +++ b/services/mobilepush/nl/zh/CN/t_android_initialize.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 为 Android 应用程序初始化推送 SDK -{: #android_initialize} - -在 Android 应用程序中，通常会将初始化代码放置在主活动的 onCreate 方法中。 - -单击 Bluemix 应用程序仪表板中的**移动选项**链接，以获取应用程序路径和应用程序 GUID。将这些值用于您的路径和应用程序 GUID。修改代码片段以使用 Bluemix 应用程序的 appRoute 和 appGUID 参数。 - - -##初始化核心 SDK - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -指定分配给在 Bluemix 上创建的服务器应用程序的路径。 - -**AppGUID** - -指定分配给在 Bluemix 上创建的应用程序的唯一键。此值区分大小写。 - -**bluemixRegionSuffix** - -指定托管应用程序的位置。可以使用以下三个值中的一个值： - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##初始化客户机推送 SDK - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# 为 Android 应用程序初始化推送 SDK +{: #android_initialize} + +在 Android 应用程序中，通常会将初始化代码放置在主活动的 onCreate 方法中。 + +单击 Bluemix 应用程序仪表板中的**移动选项**链接，以获取应用程序路径和应用程序 GUID。将这些值用于您的路径和应用程序 GUID。修改代码片段以使用 Bluemix 应用程序的 appRoute 和 appGUID 参数。 + + +## 初始化核心 SDK + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +指定分配给在 Bluemix 上创建的服务器应用程序的路径。 + +**AppGUID** + +指定分配给在 Bluemix 上创建的应用程序的唯一键。此值区分大小写。 + +**bluemixRegionSuffix** + +指定托管应用程序的位置。可以使用以下三个值中的一个值： + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +## 初始化客户机推送 SDK + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` diff --git a/services/mobilepush/nl/zh/CN/t_android_install_sdk.md b/services/mobilepush/nl/zh/CN/t_android_install_sdk.md index aa90debb7..115512db4 100644 --- a/services/mobilepush/nl/zh/CN/t_android_install_sdk.md +++ b/services/mobilepush/nl/zh/CN/t_android_install_sdk.md @@ -1,216 +1,216 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 使用 Gradle 安装客户机推送 SDK -{: #android_install} - -本部分描述如何安装和使用客户机推送 SDK 来进一步开发 Android 应用程序。 - -可以使用 Gradle 来添加 Bluemix® Mobile Services 推送 SDK。Gradle 会从存储库自动下载工件，并使这些工件可用于您的 Android 应用程序。确保正确设置了 Android Studio 和 Android Studio SDK。有关如何设置系统的更多信息，请参阅 [Android Studio 概述](https://developer.android.com/tools/studio/index.html)。有关 Gradle 的信息，请参阅[配置 Gradle 构建](http://developer.android.com/tools/building/configuring-gradle.html)。 - -1. 在 Android Studio 中，创建并打开移动应用程序后，打开应用程序 **build.gradle** 文件。然后，将以下依赖关系添加到移动应用程序中。以下是代码片段所需的导入语句： - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - - -1. 将以下依赖关系添加到移动应用程序中。以下这些行会将 Bluemix™ Mobile Services 推送客户机 SDK 和 Google 播放服务 SDK 添加到编译作用域依赖关系中。 - - ``` - dependencies { - compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' -compile 'com.google.android.gms:play-services:7.8.0' -} - ``` -1. 在 **AndroidManifest.xml** 文件中，添加以下许可权，要查看样本清单，请参阅 [Android helloPush 样本应用程序](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml)。要查看样本 Gradle 文件，请参阅[样本构建 Gradle 文件](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle)。 - - ``` - - - - - - - - -``` - - 您可以在此阅读有关 [Android 许可权](http://developer.android.com/guide/topics/security/permissions.html)的更多信息。 - -1. 添加活动的通知意向设置。此设置会在用户单击通知区域中收到的通知时启动应用程序。 - - ``` - - - - - ``` - **注**：将上述操作中的 *Your_Android_Package_Name* 替换为应用程序中使用的应用程序包名称。 - -1. 针对 RECEIVE 事件通知，添加 Google 云消息传递 (GCM) 意向服务和意向过滤器。 - - ``` - service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> - - - - - - - - - - - - - - ``` - - - -# 为 Android 应用程序初始化推送 SDK -{: #android_initialize} - -在 Android 应用程序中，通常会将初始化代码放置在主活动的 onCreate 方法中。 - -单击 Bluemix 应用程序仪表板中的**移动选项**链接，以获取应用程序路径和应用程序 GUID。将这些值用于您的路径和应用程序 GUID。修改代码片段以使用 Bluemix 应用程序的 appRoute 和 appGUID 参数。 - - -##初始化核心 SDK - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -指定分配给在 Bluemix 上创建的服务器应用程序的路径。 - -**AppGUID** - -指定分配给在 Bluemix 上创建的应用程序的唯一键。此值区分大小写。 - -**bluemixRegionSuffix** - -指定托管应用程序的位置。可以使用以下三个值中的一个值： - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##初始化客户机推送 SDK - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` - - - -# 注册 Android 设备 -{: #android_register} - -使用 `IMFPush.register()` API 可向 Push Notification Service 注册设备。对于注册 Android 设备，您首先要在 Bluemix 推送服务配置仪表板中添加 Google 云消息传递 (GCM) 信息。有关更多信息，请参阅[为 Google 云消息传递配置凭证](t_push_provider_android.html)。 - -将以下代码片段复制并粘贴到 Android 移动应用程序中。 - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` - - - -# 在 Android 设备上接收推送通知 -{: #android_receive} - -要向 Push 注册 notificationListener 对象，请调用 **MFPPush.listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 方法进行调用。 - -1. 要向 Push 注册 notificationListener 对象，请调用 **listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 方法进行调用。 - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } - ``` -2. 构建项目，然后在设备或仿真器上运行该项目。在 register() 方法中针对响应侦听器调用 onSuccess() 方法时，这证实设备已成功向 Push Notification Service 进行注册。此时，可以如“发送基本推送通知”中所述发送消息。 -3. 验证设备是否收到通知。如果应用程序在前台运行，那么通知将由 **MFPPushNotificationListener** 进行处理。如果应用程序在后台运行，那么通知栏中会显示一条消息。 - - - - -# 发送基本推送通知 - -{: #push-send-notifications} - -开发应用程序后，可以发送基本推送通知（不使用标记、角标、其他有效内容或声音文件）。 - - -发送基本推送通知。 - -1. 在**选择受众**中，选择以下某个受众：**所有设备**，或者按平台选择：**仅限 iOS 设备**或**仅限 Android 设备**。 - - **注**：选择**所有设备**选项时，预订了推送通知的所有设备都会收到通知。 - - ![“通知”屏幕](images/tag_notification.jpg) - -2. 在**创建通知**中，输入消息然后单击**发送**。 -3. 验证设备是否收到通知。 - - 以下屏幕快照显示了在 Android 和 iOS 设备上前台处理推送通知的警报框。 - - ![Android 上的前台推送通知](images/Android_Screenshot.jpg) - - ![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) - - 以下屏幕快照显示了 Android 后台的推送通知。 - ![Android 上的后台推送通知](images/background.jpg) - - - -# 后续步骤 -{: #next_steps_tags} - -成功设置基本通知后，可以配置基于标记的通知和高级选项。 - -将这些 Push Notifications 服务功能添加到应用程序中。 -要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 -要使用高级通知选项，请参阅[高级推送通知](t_advance_notifications.html)。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 使用 Gradle 安装客户机推送 SDK +{: #android_install} + +本部分描述如何安装和使用客户机推送 SDK 来进一步开发 Android 应用程序。 + +可以使用 Gradle 来添加 Bluemix® Mobile Services 推送 SDK。Gradle 会从存储库自动下载工件，并使这些工件可用于您的 Android 应用程序。确保正确设置了 Android Studio 和 Android Studio SDK。有关如何设置系统的更多信息，请参阅 [Android Studio 概述](https://developer.android.com/tools/studio/index.html)。有关 Gradle 的信息，请参阅[配置 Gradle 构建](http://developer.android.com/tools/building/configuring-gradle.html)。 + +1. 在 Android Studio 中，创建并打开移动应用程序后，打开应用程序 **build.gradle** 文件。然后，将以下依赖关系添加到移动应用程序中。以下是代码片段所需的导入语句： + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + + +1. 将以下依赖关系添加到移动应用程序中。以下这些行会将 Bluemix™ Mobile Services 推送客户机 SDK 和 Google 播放服务 SDK 添加到编译作用域依赖关系中。 + + ``` + dependencies { + compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' +compile 'com.google.android.gms:play-services:7.8.0' +} + ``` +1. 在 **AndroidManifest.xml** 文件中，添加以下许可权，要查看样本清单，请参阅 [Android helloPush 样本应用程序](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml)。要查看样本 Gradle 文件，请参阅[样本构建 Gradle 文件](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle)。 + + ``` + + + + + + + + +``` + + 您可以在此阅读有关 [Android 许可权](http://developer.android.com/guide/topics/security/permissions.html)的更多信息。 + +1. 添加活动的通知意向设置。此设置会在用户单击通知区域中收到的通知时启动应用程序。 + + ``` + + + + + ``` + **注**：将上述操作中的 *Your_Android_Package_Name* 替换为应用程序中使用的应用程序包名称。 + +1. 针对 RECEIVE 事件通知，添加 Google 云消息传递 (GCM) 意向服务和意向过滤器。 + + ``` + service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> + + + + + + + + + + + + + + ``` + + + +# 为 Android 应用程序初始化推送 SDK +{: #android_initialize} + +在 Android 应用程序中，通常会将初始化代码放置在主活动的 onCreate 方法中。 + +单击 Bluemix 应用程序仪表板中的**移动选项**链接，以获取应用程序路径和应用程序 GUID。将这些值用于您的路径和应用程序 GUID。修改代码片段以使用 Bluemix 应用程序的 appRoute 和 appGUID 参数。 + + +##初始化核心 SDK + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +指定分配给在 Bluemix 上创建的服务器应用程序的路径。 + +**AppGUID** + +指定分配给在 Bluemix 上创建的应用程序的唯一键。此值区分大小写。 + +**bluemixRegionSuffix** + +指定托管应用程序的位置。可以使用以下三个值中的一个值： + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +##初始化客户机推送 SDK + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` + + + +# 注册 Android 设备 +{: #android_register} + +使用 `IMFPush.register()` API 可向 Push Notification Service 注册设备。对于注册 Android 设备，您首先要在 Bluemix 推送服务配置仪表板中添加 Google 云消息传递 (GCM) 信息。有关更多信息，请参阅[为 Google 云消息传递配置凭证](t_push_provider_android.html)。 + +将以下代码片段复制并粘贴到 Android 移动应用程序中。 + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` + + + +# 在 Android 设备上接收推送通知 +{: #android_receive} + +要向 Push 注册 notificationListener 对象，请调用 **MFPPush.listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 方法进行调用。 + +1. 要向 Push 注册 notificationListener 对象，请调用 **listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 方法进行调用。 + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } + ``` +2. 构建项目，然后在设备或仿真器上运行该项目。在 register() 方法中针对响应侦听器调用 onSuccess() 方法时，这证实设备已成功向 Push Notification Service 进行注册。此时，可以如“发送基本推送通知”中所述发送消息。 +3. 验证设备是否收到通知。如果应用程序在前台运行，那么通知将由 **MFPPushNotificationListener** 进行处理。如果应用程序在后台运行，那么通知栏中会显示一条消息。 + + + + +# 发送基本推送通知 + +{: #push-send-notifications} + +开发应用程序后，可以发送基本推送通知（不使用标记、角标、其他有效内容或声音文件）。 + + +发送基本推送通知。 + +1. 在**选择受众**中，选择以下某个受众：**所有设备**，或者按平台选择：**仅限 iOS 设备**或**仅限 Android 设备**。 + + **注**：选择**所有设备**选项时，预订了推送通知的所有设备都会收到通知。 + + ![“通知”屏幕](images/tag_notification.jpg) + +2. 在**创建通知**中，输入消息然后单击**发送**。 +3. 验证设备是否收到通知。 + + 以下屏幕快照显示了在 Android 和 iOS 设备上前台处理推送通知的警报框。 + + ![Android 上的前台推送通知](images/Android_Screenshot.jpg) + + ![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) + + 以下屏幕快照显示了 Android 后台的推送通知。 + ![Android 上的后台推送通知](images/background.jpg) + + + +# 后续步骤 +{: #next_steps_tags} + +成功设置基本通知后，可以配置基于标记的通知和高级选项。 + +将这些 Push Notifications 服务功能添加到应用程序中。 +要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 +要使用高级通知选项，请参阅[高级推送通知](t_advance_notifications.html)。 diff --git a/services/mobilepush/nl/zh/CN/t_android_receive.md b/services/mobilepush/nl/zh/CN/t_android_receive.md index afe7c2bd0..970ad50f9 100644 --- a/services/mobilepush/nl/zh/CN/t_android_receive.md +++ b/services/mobilepush/nl/zh/CN/t_android_receive.md @@ -1,25 +1,25 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 在 Android 设备上接收推送通知 -{: #android_receive} - -要向 Push 注册 notificationListener 对象，请调用 **MFPPush.listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 方法进行调用。 - -1. 要向 Push 注册 notificationListener 对象，请调用 **listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 方法进行调用。 - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` -2. 构建项目，然后在设备或仿真器上运行该项目。在 register() 方法中针对响应侦听器调用 onSuccess() 方法时，这证实设备已成功向 Push Notification Service 进行注册。此时，可以如“发送基本推送通知”中所述发送消息。 -3. 验证设备是否收到通知。如果应用程序在前台运行，那么通知将由 **MFPPushNotificationListener** 进行处理。如果应用程序在后台运行，那么通知栏中会显示一条消息。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 在 Android 设备上接收推送通知 +{: #android_receive} + +要向 Push 注册 notificationListener 对象，请调用 **MFPPush.listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 方法进行调用。 + +1. 要向 Push 注册 notificationListener 对象，请调用 **listen()** 方法。此方法通常是通过处理推送通知的活动的 **onResume()** 方法进行调用。 + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` +2. 构建项目，然后在设备或仿真器上运行该项目。在 register() 方法中针对响应侦听器调用 onSuccess() 方法时，这证实设备已成功向 Push Notification Service 进行注册。此时，可以如“发送基本推送通知”中所述发送消息。 +3. 验证设备是否收到通知。如果应用程序在前台运行，那么通知将由 **MFPPushNotificationListener** 进行处理。如果应用程序在后台运行，那么通知栏中会显示一条消息。 diff --git a/services/mobilepush/nl/zh/CN/t_android_register.md b/services/mobilepush/nl/zh/CN/t_android_register.md index f6ebfafb9..998da8ab2 100644 --- a/services/mobilepush/nl/zh/CN/t_android_register.md +++ b/services/mobilepush/nl/zh/CN/t_android_register.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 注册 Android 设备 -{: #android_register} - -使用 `IMFPush.register()` API 可向 Push Notification Service 注册设备。对于注册 Android 设备，您首先要在 Bluemix 推送服务配置仪表板中添加 Google 云消息传递 (GCM) 信息。有关更多信息，请参阅[为 Google 云消息传递配置凭证](t_push_provider_android.html)。 - -将以下代码片段复制并粘贴到 Android 移动应用程序中。 - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# 注册 Android 设备 +{: #android_register} + +使用 `IMFPush.register()` API 可向 Push Notification Service 注册设备。对于注册 Android 设备，您首先要在 Bluemix 推送服务配置仪表板中添加 Google 云消息传递 (GCM) 信息。有关更多信息，请参阅[为 Google 云消息传递配置凭证](t_push_provider_android.html)。 + +将以下代码片段复制并粘贴到 Android 移动应用程序中。 + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` diff --git a/services/mobilepush/nl/zh/CN/t_cordova_initialize.md b/services/mobilepush/nl/zh/CN/t_cordova_initialize.md index f5f5c61d9..65d568da6 100644 --- a/services/mobilepush/nl/zh/CN/t_cordova_initialize.md +++ b/services/mobilepush/nl/zh/CN/t_cordova_initialize.md @@ -1,31 +1,31 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} - -# 初始化 Cordova 插件 -{: #cordova_enable} - -开始使用 Push Notification Service Cordova 插件之前，需要通过传递应用程序路径和应用程序 GUID 对其进行初始化。 初始化该插件后，可以连接到在 Bluemix“仪表板”中创建的服务器应用程序。 Cordova 插件是 Android 和 iOS 客户机 SDK 的包装程序，可以使 Cordova 应用程序能够与 Bluemix 服务进行通信。 - -1. 通过将以下代码片段复制并粘贴到主 JavaScript 文件（通常位于 **www/js** 目录下）中来初始化 BMSClient。 - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. 修改代码片段以使用 Bluemix 的 Route 和 appGUID 参数。 单击 Bluemix 的“应用程序仪表板”中的**移动选项**链接，以获取应用程序的“路径”和“应用程序 GUID”。 在 `BMSClient.initialize` 代码片段中将“路径”和“应用程序 GUID”值作为您的参数。 - - - **注**：如果是使用 Cordova CLI（例如，Cordova create app-name 命令）创建的 Cordova 应用程序，请将此 JavaScript 代码放入 **index.js** 文件内 `nDeviceReady: function()` 函数中的 `app.receivedEvent` 函数之后，以初始化 BMS 客户机。 - - ``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` -1. 后续步骤：[注册设备](t_cordova_register.html)。 +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} + +# 初始化 Cordova 插件 +{: #cordova_enable} + +开始使用 Push Notification Service Cordova 插件之前，需要通过传递应用程序路径和应用程序 GUID 对其进行初始化。 初始化该插件后，可以连接到在 Bluemix“仪表板”中创建的服务器应用程序。 Cordova 插件是 Android 和 iOS 客户机 SDK 的包装程序，可以使 Cordova 应用程序能够与 Bluemix 服务进行通信。 + +1. 通过将以下代码片段复制并粘贴到主 JavaScript 文件（通常位于 **www/js** 目录下）中来初始化 BMSClient。 + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. 修改代码片段以使用 Bluemix 的 Route 和 appGUID 参数。 单击 Bluemix 的“应用程序仪表板”中的**移动选项**链接，以获取应用程序的“路径”和“应用程序 GUID”。 在 `BMSClient.initialize` 代码片段中将“路径”和“应用程序 GUID”值作为您的参数。 + + + **注**：如果是使用 Cordova CLI（例如，Cordova create app-name 命令）创建的 Cordova 应用程序，请将此 JavaScript 代码放入 **index.js** 文件内 `nDeviceReady: function()` 函数中的 `app.receivedEvent` 函数之后，以初始化 BMS 客户机。 + + ``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` +1. 后续步骤：[注册设备](t_cordova_register.html)。 diff --git a/services/mobilepush/nl/zh/CN/t_cordova_install.md b/services/mobilepush/nl/zh/CN/t_cordova_install.md index e7ea47998..7bac5acbd 100644 --- a/services/mobilepush/nl/zh/CN/t_cordova_install.md +++ b/services/mobilepush/nl/zh/CN/t_cordova_install.md @@ -1,371 +1,371 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 安装 Cordova 推送插件 -{: #cordova_install} - -安装和使用客户机推送插件来进一步开发 Cordova 应用程序。这还会安装 Cordova 核心插件，该插件会初始化与 Bluemix 的连接。 - -### 开始之前 - -1. 下载最新版本的 Android Studio SDK 和 Xcode。 -1. 设置仿真器。对于 Android Studio，请使用支持 Google Play API 的仿真器。 -1. 安装 Git 命令行工具。对于 Windows，请确保选择**从 Windows 命令提示符运行 Git** 选项。有关如何下载并安装此工具的信息，请参阅 [Git](https://git-scm.com/downloads)。 - -1. 安装 Node.js 和 Node 软件包管理器 (NPM) 工具。NPM 命令行工具与 Node.js 捆绑在一起。有关如何下载并安装 Node.js 的信息，请参阅 [Node.js](https://nodejs.org/en/download/)。 -1. 在命令行中，使用 **npm install -g cordova** 命令来安装 Cordova 命令行工具。必须有该工具才能使用 Cordova 推送插件。有关如何安装 Cordova 和设置 Cordova 应用程序的信息，请参阅 [Cordova Apache](https://cordova.apache.org/#getstarted)。 - - **注**：要查看 Cordova 推送插件自述文件，请转至 [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push)。 - - -## 安装 Cordova 推送插件 -1. 切换到要在其中创建 Cordova 应用程序的文件夹，然后运行以下命令来创建 Cordova 应用程序。如果已有 Cordova 应用程序，请转至步骤 3。 - -``` -cordova create your_app_name - cd your_app_name - ``` -1. 可选：编辑 **config.xml** 文件，然后将 元素中的应用程序名称更改为所选名称，而不使用缺省 HelloCordova 名称。 - - **注**：确保指定正确的捆绑软件标识。否则，将在 Xcode 中显示以下错误消息： - * 对可执行文件进行签名的权利无效。 - * 应用程序的“代码签名权利”文件中指定的权利与供应概要文件中指定的权利不同。 - - 要解决此问题，请在 Xcode 或 Cordova 应用程序 **config.xml** 文件中指定正确的捆绑软件标识。 - -1. 将支持的最低版本 API 或部署目标声明添加到 Cordova 应用程序的 config.xml 文件中。minSdkVersion 值必须高于 15。targetSdkVersion 值必须始终反映出 Google 上可用的最新版本 Android SDK。 - * **Android** - 使用编辑器，打开 config.xml 文件并使用最低 SDK 版本和目标 SDK 版本更新 `` 元素： - - ``` - - - - - - ``` - * **iOS** - 使用部署目标声明更新 元素： - - ``` - - - - - ``` - -1. 在 Cordova 命令行界面 (CLI) 中，使用以下命令添加平台：iOS 和/或 Android。 - - ``` - cordova platform add ios@3.9.0 - cordova platform add android - ``` -1. 在 Cordova 应用程序根目录中，输入以下命令来安装 Cordova 推送插件：**cordova plugin add ibm-mfp-push**。 - - 您会看到类似于以下内容的信息，具体取决于您添加的平台： - - ``` - Installing "ibm-mfp-push" for android - Installing "ibm-mfp-push" for ios - ``` -1. 在 *your-app-root-folder* 中，使用以下命令来验证 Cordova 核心和推送插件是否成功安装：**cordova plugin list**。 - - 您会看到类似于以下内容的信息，具体取决于您添加的平台： - - ``` - ibm-mfp-core 1.0.0 "MFPCore" - ibm-mfp-push 1.0.0 “MFPPush" - ``` -1. （仅限 iOS）- 配置 iOS 开发环境。 - a. 使用 Xcode 打开 *your-app-name***/platforms/ios** 目录中的 your-app-name.xcodeproj 文件。 - - b. 添加桥接头。转至**构建设置 > Swift 编译器 - 代码生成 > Objective-C 桥接头**，然后添加以下路径：*your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - c. 添加 Frameworks 参数。转至**构建设置 > 链接 > Runpath 搜索路径**，然后添加以下参数： - - ``` - @executable_path/Frameworks - ``` - d. 取消注释桥接头中的以下推送导入语句。转至 *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - ``` - //#import - //#import - //#import - ``` - e. 使用 Xcode 构建并运行应用程序。 -1. （仅限 Android）- 使用以下命令来构建 Android 项目： -**cordova build android**。 - - **注**：在 Android Studio 中打开项目之前，必须先通过 Cordova CLI 构建 Cordova 应用程序。否则，将遇到构建错误。 - - -# 初始化 Cordova 插件 -{: #cordova_initialize} - -开始使用 Push Notification Service Cordova 插件之前，需要通过传递应用程序路径和应用程序 GUID 对其进行初始化。 初始化该插件后，可以连接到在 Bluemix“仪表板”中创建的服务器应用程序。 Cordova 插件是 Android 和 iOS 客户机 SDK 的包装程序，可以使 Cordova 应用程序能够与 Bluemix 服务进行通信。 - -1. 通过将以下代码片段复制并粘贴到主 JavaScript 文件（通常位于 **www/js** 目录下）中来初始化 BMSClient。 - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. 修改代码片段以使用 Bluemix 的 Route 和 appGUID 参数。 单击 Bluemix 的“应用程序仪表板”中的**移动选项**链接，以获取应用程序的“路径”和“应用程序 GUID”。 在 `BMSClient.initialize` 代码片段中将“路径”和“应用程序 GUID”值作为您的参数。 - - **注**：如果是使用 Cordova CLI（例如，Cordova create app-name 命令）创建的 Cordova 应用程序，请将此 JavaScript 代码放入 **index.js** 文件内 `nDeviceReady: function()` 函数中的 `app.receivedEvent` 函数之后，以初始化 BMS 客户机。 - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` - -# 注册设备 - -{: #cordova_register} - -要向 Push Notification Service 注册设备，请调用 register 方法。 - -将以下代码片段复制并粘贴到 Cordova 应用程序中，以注册设备。 - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android 不使用 settings 参数。如果要仅构建 Android 应用程序，请传递空对象；例如： - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -如果想要定制警报、角标和声音属性，请将以下 JavaScript 代码片段添加到 Cordova 应用程序的 Web 部分中。 - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -可使用 JSON.parse 访问 JavaScript 中成功响应参数的内容：**var token = JSON.parse(response).token** - - -可用键如下所示：`token`、`userId` 和 `deviceId`。 - -以下 JavaScript 代码片段显示如何初始化 Bluemix Mobile Services 推送客户机 SDK，向 Push Notification Service 注册设备以及侦听推送通知。将此代码放入 JavaScript 文件中。 - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -在 **onDeviceReady: function()** 中。 - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { -alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification);} -``` - -## Objective-C -{: #cordova_register_objective} -将以下 Objective-C 代码片段添加到应用程序代表类中 - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -将以下 Swift 代码片段添加到应用程序代表类中。 - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##后续步骤 - -{: #cordova_register_next} - -1. 使用以下命令构建项目，然后运行项目： - - * Android - 运行 **cordova build android**，然后运行 **cordova run android** - - * iOS - 运行 **cordova build ios**，然后运行 **cordova run ios** - - - -# 在设备上接收推送通知 -{: #cordova_receive} - -复制并粘贴以下代码片段，以在设备上接收推送通知。 - -##JavaScript - -将以下 JavaScript 代码片段添加到 Cordova 应用程序的 Web 部分中。 - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Android 通知属性 - -以下部分列出了 Android 通知属性： - -* message - 推送通知消息 -* payload - 包含通知有效内容的 JSON 对象 - - -##iOS 通知属性 - -以下部分列出了 iOS 通知属性： - -* message - 推送通知消息 -* payload - 包含通知有效内容的 JSON 对象 -* action-loc-key - 此字符串用作键以从当前本地化版本中获取本地化字符串，用于正确按钮的标题，而不是“View”。 -* badge - 要显示为应用程序图标角标的数字。如果缺少此属性，那么角标不会改变。要除去角标，请将此属性的值设置为 0。 -* sound - 应用程序捆绑包中或应用程序数据容器的 Library/Sounds 文件夹中声音文件的名称。 - -##Objective-C - -将以下 Objective-C 代码片段添加到应用程序代表类中。 - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -将以下 Swift 代码片段添加到应用程序代表类中。 - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` - - - -# 发送基本推送通知 -{: #push-send-notifications} - -开发应用程序后，可以发送基本推送通知（不使用标记、角标、其他有效内容或声音文件）。 - - -发送基本推送通知。 - -1. 在**选择受众**中，选择以下某个受众：**所有设备**，或者按平台选择：**仅限 iOS 设备**或**仅限 Android 设备**。 - - **注**：选择**所有设备**选项时，预订了推送通知的所有设备都会收到通知。 - - ![“通知”屏幕](images/tag_notification.jpg) - -2. 在**创建通知**中，输入消息然后单击**发送**。 -3. 验证设备是否收到通知。 - - 以下屏幕快照显示了在 Android 和 iOS 设备上前台处理推送通知的警报框。 - - ![Android 上的前台推送通知](images/Android_Screenshot.jpg) - - ![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) - - 以下屏幕快照显示了 Android 后台的推送通知。 - ![Android 上的后台推送通知](images/background.jpg) - - - -# 后续步骤 -{: #next_steps_tags} - -成功设置基本通知后，可以配置基于标记的通知和高级选项。 - -将这些 Push Notifications 服务功能添加到应用程序中。 -要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 -要使用高级通知选项，请参阅[高级推送通知](t_advance_notifications.html)。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 安装 Cordova 推送插件 +{: #cordova_install} + +安装和使用客户机推送插件来进一步开发 Cordova 应用程序。这还会安装 Cordova 核心插件，该插件会初始化与 Bluemix 的连接。 + +### 开始之前 + +1. 下载最新版本的 Android Studio SDK 和 Xcode。 +1. 设置仿真器。对于 Android Studio，请使用支持 Google Play API 的仿真器。 +1. 安装 Git 命令行工具。对于 Windows，请确保选择**从 Windows 命令提示符运行 Git** 选项。有关如何下载并安装此工具的信息，请参阅 [Git](https://git-scm.com/downloads)。 + +1. 安装 Node.js 和 Node 软件包管理器 (NPM) 工具。NPM 命令行工具与 Node.js 捆绑在一起。有关如何下载并安装 Node.js 的信息，请参阅 [Node.js](https://nodejs.org/en/download/)。 +1. 在命令行中，使用 **npm install -g cordova** 命令来安装 Cordova 命令行工具。必须有该工具才能使用 Cordova 推送插件。有关如何安装 Cordova 和设置 Cordova 应用程序的信息，请参阅 [Cordova Apache](https://cordova.apache.org/#getstarted)。 + + **注**：要查看 Cordova 推送插件自述文件，请转至 [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push)。 + + +## 安装 Cordova 推送插件 +1. 切换到要在其中创建 Cordova 应用程序的文件夹，然后运行以下命令来创建 Cordova 应用程序。如果已有 Cordova 应用程序，请转至步骤 3。 + +``` +cordova create your_app_name + cd your_app_name + ``` +1. 可选：编辑 **config.xml** 文件，然后将 元素中的应用程序名称更改为所选名称，而不使用缺省 HelloCordova 名称。 + + **注**：确保指定正确的捆绑软件标识。否则，将在 Xcode 中显示以下错误消息： + * 对可执行文件进行签名的权利无效。 + * 应用程序的“代码签名权利”文件中指定的权利与供应概要文件中指定的权利不同。 + + 要解决此问题，请在 Xcode 或 Cordova 应用程序 **config.xml** 文件中指定正确的捆绑软件标识。 + +1. 将支持的最低版本 API 或部署目标声明添加到 Cordova 应用程序的 config.xml 文件中。minSdkVersion 值必须高于 15。targetSdkVersion 值必须始终反映出 Google 上可用的最新版本 Android SDK。 + * **Android** - 使用编辑器，打开 config.xml 文件并使用最低 SDK 版本和目标 SDK 版本更新 `` 元素： + + ``` + + + + + + ``` + * **iOS** - 使用部署目标声明更新 元素： + + ``` + + + + + ``` + +1. 在 Cordova 命令行界面 (CLI) 中，使用以下命令添加平台：iOS 和/或 Android。 + + ``` + cordova platform add ios@3.9.0 + cordova platform add android + ``` +1. 在 Cordova 应用程序根目录中，输入以下命令来安装 Cordova 推送插件：**cordova plugin add ibm-mfp-push**。 + + 您会看到类似于以下内容的信息，具体取决于您添加的平台： + + ``` + Installing "ibm-mfp-push" for android + Installing "ibm-mfp-push" for ios + ``` +1. 在 *your-app-root-folder* 中，使用以下命令来验证 Cordova 核心和推送插件是否成功安装：**cordova plugin list**。 + + 您会看到类似于以下内容的信息，具体取决于您添加的平台： + + ``` + ibm-mfp-core 1.0.0 "MFPCore" + ibm-mfp-push 1.0.0 “MFPPush" + ``` +1. （仅限 iOS）- 配置 iOS 开发环境。 + a. 使用 Xcode 打开 *your-app-name***/platforms/ios** 目录中的 your-app-name.xcodeproj 文件。 + + b. 添加桥接头。转至**构建设置 > Swift 编译器 - 代码生成 > Objective-C 桥接头**，然后添加以下路径：*your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + c. 添加 Frameworks 参数。转至**构建设置 > 链接 > Runpath 搜索路径**，然后添加以下参数： + + ``` + @executable_path/Frameworks + ``` + d. 取消注释桥接头中的以下推送导入语句。转至 *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + ``` + //#import + //#import + //#import + ``` + e. 使用 Xcode 构建并运行应用程序。 +1. （仅限 Android）- 使用以下命令来构建 Android 项目： +**cordova build android**。 + + **注**：在 Android Studio 中打开项目之前，必须先通过 Cordova CLI 构建 Cordova 应用程序。否则，将遇到构建错误。 + + +# 初始化 Cordova 插件 +{: #cordova_initialize} + +开始使用 Push Notification Service Cordova 插件之前，需要通过传递应用程序路径和应用程序 GUID 对其进行初始化。 初始化该插件后，可以连接到在 Bluemix“仪表板”中创建的服务器应用程序。 Cordova 插件是 Android 和 iOS 客户机 SDK 的包装程序，可以使 Cordova 应用程序能够与 Bluemix 服务进行通信。 + +1. 通过将以下代码片段复制并粘贴到主 JavaScript 文件（通常位于 **www/js** 目录下）中来初始化 BMSClient。 + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. 修改代码片段以使用 Bluemix 的 Route 和 appGUID 参数。 单击 Bluemix 的“应用程序仪表板”中的**移动选项**链接，以获取应用程序的“路径”和“应用程序 GUID”。 在 `BMSClient.initialize` 代码片段中将“路径”和“应用程序 GUID”值作为您的参数。 + + **注**：如果是使用 Cordova CLI（例如，Cordova create app-name 命令）创建的 Cordova 应用程序，请将此 JavaScript 代码放入 **index.js** 文件内 `nDeviceReady: function()` 函数中的 `app.receivedEvent` 函数之后，以初始化 BMS 客户机。 + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` + +# 注册设备 + +{: #cordova_register} + +要向 Push Notification Service 注册设备，请调用 register 方法。 + +将以下代码片段复制并粘贴到 Cordova 应用程序中，以注册设备。 + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android 不使用 settings 参数。如果要仅构建 Android 应用程序，请传递空对象；例如： + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +如果想要定制警报、角标和声音属性，请将以下 JavaScript 代码片段添加到 Cordova 应用程序的 Web 部分中。 + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +##JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +可使用 JSON.parse 访问 JavaScript 中成功响应参数的内容：**var token = JSON.parse(response).token** + + +可用键如下所示：`token`、`userId` 和 `deviceId`。 + +以下 JavaScript 代码片段显示如何初始化 Bluemix Mobile Services 推送客户机 SDK，向 Push Notification Service 注册设备以及侦听推送通知。将此代码放入 JavaScript 文件中。 + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +在 **onDeviceReady: function()** 中。 + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { +alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification);} +``` + +## Objective-C +{: #cordova_register_objective} +将以下 Objective-C 代码片段添加到应用程序代表类中 + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +##Swift +{: #cordova_register_swift} +将以下 Swift 代码片段添加到应用程序代表类中。 + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +##后续步骤 + +{: #cordova_register_next} + +1. 使用以下命令构建项目，然后运行项目： + + * Android - 运行 **cordova build android**，然后运行 **cordova run android** + + * iOS - 运行 **cordova build ios**，然后运行 **cordova run ios** + + + +# 在设备上接收推送通知 +{: #cordova_receive} + +复制并粘贴以下代码片段，以在设备上接收推送通知。 + +##JavaScript + +将以下 JavaScript 代码片段添加到 Cordova 应用程序的 Web 部分中。 + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +##Android 通知属性 + +以下部分列出了 Android 通知属性： + +* message - 推送通知消息 +* payload - 包含通知有效内容的 JSON 对象 + + +##iOS 通知属性 + +以下部分列出了 iOS 通知属性： + +* message - 推送通知消息 +* payload - 包含通知有效内容的 JSON 对象 +* action-loc-key - 此字符串用作键以从当前本地化版本中获取本地化字符串，用于正确按钮的标题，而不是“View”。 +* badge - 要显示为应用程序图标角标的数字。如果缺少此属性，那么角标不会改变。要除去角标，请将此属性的值设置为 0。 +* sound - 应用程序捆绑包中或应用程序数据容器的 Library/Sounds 文件夹中声音文件的名称。 + +##Objective-C + +将以下 Objective-C 代码片段添加到应用程序代表类中。 + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +##Swift + +将以下 Swift 代码片段添加到应用程序代表类中。 + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` + + + +# 发送基本推送通知 +{: #push-send-notifications} + +开发应用程序后，可以发送基本推送通知（不使用标记、角标、其他有效内容或声音文件）。 + + +发送基本推送通知。 + +1. 在**选择受众**中，选择以下某个受众：**所有设备**，或者按平台选择：**仅限 iOS 设备**或**仅限 Android 设备**。 + + **注**：选择**所有设备**选项时，预订了推送通知的所有设备都会收到通知。 + + ![“通知”屏幕](images/tag_notification.jpg) + +2. 在**创建通知**中，输入消息然后单击**发送**。 +3. 验证设备是否收到通知。 + + 以下屏幕快照显示了在 Android 和 iOS 设备上前台处理推送通知的警报框。 + + ![Android 上的前台推送通知](images/Android_Screenshot.jpg) + + ![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) + + 以下屏幕快照显示了 Android 后台的推送通知。 + ![Android 上的后台推送通知](images/background.jpg) + + + +# 后续步骤 +{: #next_steps_tags} + +成功设置基本通知后，可以配置基于标记的通知和高级选项。 + +将这些 Push Notifications 服务功能添加到应用程序中。 +要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 +要使用高级通知选项，请参阅[高级推送通知](t_advance_notifications.html)。 diff --git a/services/mobilepush/nl/zh/CN/t_cordova_receive.md b/services/mobilepush/nl/zh/CN/t_cordova_receive.md index 0df65090d..97197015d 100644 --- a/services/mobilepush/nl/zh/CN/t_cordova_receive.md +++ b/services/mobilepush/nl/zh/CN/t_cordova_receive.md @@ -1,82 +1,82 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 在设备上接收推送通知 -{: #cordova_receive} - -复制并粘贴以下代码片段，以在设备上接收推送通知。 - -##JavaScript - -将以下 JavaScript 代码片段添加到 Cordova 应用程序的 Web 部分中。 - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Android 通知属性 - -以下部分列出了 Android 通知属性： - -* message - 推送通知消息 -* payload - 包含通知有效内容的 JSON 对象 - - -##iOS 通知属性 - -以下部分列出了 iOS 通知属性： - -* message - 推送通知消息 -* payload - 包含通知有效内容的 JSON 对象 -* action-loc-key - 此字符串用作键以从当前本地化版本中获取本地化字符串，用于正确按钮的标题，而不是“View”。 -* badge - 要显示为应用程序图标角标的数字。如果缺少此属性，那么角标不会改变。要除去角标，请将此属性的值设置为 0。 -* sound - 应用程序捆绑包中或应用程序数据容器的 Library/Sounds 文件夹中声音文件的名称。 - -##Objective-C - -将以下 Objective-C 代码片段添加到应用程序代表类中。 - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -将以下 Swift 代码片段添加到应用程序代表类中。 - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` -后续步骤：[发送基本推送通知](t_send_push_notifications.html)。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 在设备上接收推送通知 +{: #cordova_receive} + +复制并粘贴以下代码片段，以在设备上接收推送通知。 + +## JavaScript + +将以下 JavaScript 代码片段添加到 Cordova 应用程序的 Web 部分中。 + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +## Android 通知属性 + +以下部分列出了 Android 通知属性： + +* message - 推送通知消息 +* payload - 包含通知有效内容的 JSON 对象 + + +## iOS 通知属性 + +以下部分列出了 iOS 通知属性： + +* message - 推送通知消息 +* payload - 包含通知有效内容的 JSON 对象 +* action-loc-key - 此字符串用作键以从当前本地化版本中获取本地化字符串，用于正确按钮的标题，而不是“View”。 +* badge - 要显示为应用程序图标角标的数字。如果缺少此属性，那么角标不会改变。要除去角标，请将此属性的值设置为 0。 +* sound - 应用程序捆绑包中或应用程序数据容器的 Library/Sounds 文件夹中声音文件的名称。 + +## Objective-C + +将以下 Objective-C 代码片段添加到应用程序代表类中。 + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +## Swift + +将以下 Swift 代码片段添加到应用程序代表类中。 + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` +后续步骤：[发送基本推送通知](t_send_push_notifications.html)。 diff --git a/services/mobilepush/nl/zh/CN/t_cordova_register.md b/services/mobilepush/nl/zh/CN/t_cordova_register.md index 0103fadf7..5453eba3d 100644 --- a/services/mobilepush/nl/zh/CN/t_cordova_register.md +++ b/services/mobilepush/nl/zh/CN/t_cordova_register.md @@ -1,137 +1,137 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 注册设备 - -{: #cordova_register} - -要向 Push Notification Service 注册设备，请调用 register 方法。 - -将以下代码片段复制并粘贴到 Cordova 应用程序中，以注册设备。 - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android 不使用 settings 参数。如果要仅构建 Android 应用程序，请传递空对象；例如： - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -如果想要定制警报、角标和声音属性，请将以下 JavaScript 代码片段添加到 Cordova 应用程序的 Web 部分中。 - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -可使用 JSON.parse 访问 JavaScript 中成功响应参数的内容：**var token = JSON.parse(response).token** - - -可用键如下所示：`token`、`userId` 和 `deviceId`。 - -以下 JavaScript 代码片段显示如何初始化 Bluemix Mobile Services 推送客户机 SDK，向 Push Notification Service 注册设备以及侦听推送通知。将此代码放入 JavaScript 文件中。 - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -在 **onDeviceReady: function()** 中。 - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { -alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification);} -``` - -## Objective-C -{: #cordova_register_objective} -将以下 Objective-C 代码片段添加到应用程序代表类中 - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -将以下 Swift 代码片段添加到应用程序代表类中。 - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##后续步骤 -{: #cordova_register_next} - -1. 使用以下命令构建项目，然后运行项目： - - * Android - 运行 **cordova build android**，然后运行 **cordova run android** - - * iOS - 运行 **cordova build ios**，然后运行 **cordova run ios** -1. [在设备上接收推送通知](t_cordova_receive.html)。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 注册设备 + +{: #cordova_register} + +要向 Push Notification Service 注册设备，请调用 register 方法。 + +将以下代码片段复制并粘贴到 Cordova 应用程序中，以注册设备。 + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android 不使用 settings 参数。如果要仅构建 Android 应用程序，请传递空对象；例如： + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +如果想要定制警报、角标和声音属性，请将以下 JavaScript 代码片段添加到 Cordova 应用程序的 Web 部分中。 + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +可使用 JSON.parse 访问 JavaScript 中成功响应参数的内容：**var token = JSON.parse(response).token** + + +可用键如下所示：`token`、`userId` 和 `deviceId`。 + +以下 JavaScript 代码片段显示如何初始化 Bluemix Mobile Services 推送客户机 SDK，向 Push Notification Service 注册设备以及侦听推送通知。将此代码放入 JavaScript 文件中。 + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +在 **onDeviceReady: function()** 中。 + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { +alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification);} +``` + +## Objective-C +{: #cordova_register_objective} +将以下 Objective-C 代码片段添加到应用程序代表类中 + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +将以下 Swift 代码片段添加到应用程序代表类中。 + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## 后续步骤 +{: #cordova_register_next} + +1. 使用以下命令构建项目，然后运行项目： + + * Android - 运行 **cordova build android**，然后运行 **cordova run android** + + * iOS - 运行 **cordova build ios**，然后运行 **cordova run ios** +1. [在设备上接收推送通知](t_cordova_receive.html)。 diff --git a/services/mobilepush/nl/zh/CN/t_create_push_instance.md b/services/mobilepush/nl/zh/CN/t_create_push_instance.md index fb6d0d6d7..aba4dd397 100644 --- a/services/mobilepush/nl/zh/CN/t_create_push_instance.md +++ b/services/mobilepush/nl/zh/CN/t_create_push_instance.md @@ -1,32 +1,32 @@ -# 创建 Push 服务实例 -{: #create-push-instance} - -要开始使用 {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}，首先应创建 {{site.data.keyword.Bluemix}} 应用程序；例如，Node.js 应用程序。然后，创建 Push 服务 {{site.data.keyword.mobilepushfull}} 的实例，该实例需要绑定到此 Bluemix 应用程序。此外，也可以转至 Bluemix“目录”的“样板”部分，然后单击 MobileFirst Services Starter 来执行此操作。 - -**注**：如果已配置组织来管理您的环境，请选择要在其中为移动应用程序创建运行时和服务的组织。 - - -1. 如果没有 Bluemix 应用程序，那么需要创建 Bluemix 应用程序；例如，Node.js 应用程序。要创建 Bluemix 应用程序，请转至 Bluemix“仪表板”，然后单击**创建应用程序**。 - - **注**：如果已有应用程序，请转至步骤 7 来添加服务。![创建服务实例](images/create_service_instance1.jpg "创建服务实例") - -1. 在**选择应用程序模板**中，单击 **WEB**。 - -3. 在**选择起点**区域中，选择 **SDK for Node.js**，然后单击**继续**。![起点](images/create_service_nodejs2.jpg) - -4. 在**空间**下拉菜单中，选择组织空间。![选择组织空间](images/create_a_service3.jpg) -1. 在**名称**中，输入应用程序的名称。在“主机”中，输入主机的名称。 - -1. 在**所选套餐**下拉菜单中，选择套餐，然后单击**创建**按钮。等待应用程序编译打包。 - -1. 单击**概述**链接。![添加服务](images/create_service_add4.jpg) -1. 单击**添加服务**。这将显示“目录”屏幕。 - -1. 选择 **IBM Push Notifications：**，然后从**空间**下拉菜单中，选择您的组织。![“组织空间”下拉菜单](images/create_service_org.jpg) -1. 在**服务名称**中，输入 Push Notification Service 名称。 - -1. 在**所选套餐**中，选择套餐，然后单击**创建**按钮。 - -1. 单击**是**，以重新编译打包应用程序。![IBM Push Notification Service](images/create_service_notification5.jpg) - -1. 单击**推送通知**，以显示“推送通知”仪表板。 +# 创建 Push 服务实例 +{: #create-push-instance} + +要开始使用 {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}，首先应创建 {{site.data.keyword.Bluemix}} 应用程序；例如，Node.js 应用程序。然后，创建 Push 服务 {{site.data.keyword.mobilepushfull}} 的实例，该实例需要绑定到此 Bluemix 应用程序。此外，也可以转至 Bluemix“目录”的“样板”部分，然后单击 MobileFirst Services Starter 来执行此操作。 + +**注**：如果已配置组织来管理您的环境，请选择要在其中为移动应用程序创建运行时和服务的组织。 + + +1. 如果没有 Bluemix 应用程序，那么需要创建 Bluemix 应用程序；例如，Node.js 应用程序。要创建 Bluemix 应用程序，请转至 Bluemix“仪表板”，然后单击**创建应用程序**。 + + **注**：如果已有应用程序，请转至步骤 7 来添加服务。![创建服务实例](images/create_service_instance1.jpg "创建服务实例") + +1. 在**选择应用程序模板**中，单击 **WEB**。 + +3. 在**选择起点**区域中，选择 **SDK for Node.js**，然后单击**继续**。![起点](images/create_service_nodejs2.jpg) + +4. 在**空间**下拉菜单中，选择组织空间。![选择组织空间](images/create_a_service3.jpg) +1. 在**名称**中，输入应用程序的名称。在“主机”中，输入主机的名称。 + +1. 在**所选套餐**下拉菜单中，选择套餐，然后单击**创建**按钮。等待应用程序编译打包。 + +1. 单击**概述**链接。![添加服务](images/create_service_add4.jpg) +1. 单击**添加服务**。这将显示“目录”屏幕。 + +1. 选择 **IBM Push Notifications：**，然后从**空间**下拉菜单中，选择您的组织。![“组织空间”下拉菜单](images/create_service_org.jpg) +1. 在**服务名称**中，输入 Push Notification Service 名称。 + +1. 在**所选套餐**中，选择套餐，然后单击**创建**按钮。 + +1. 单击**是**，以重新编译打包应用程序。![IBM Push Notification Service](images/create_service_notification5.jpg) + +1. 单击**推送通知**，以显示“推送通知”仪表板。 diff --git a/services/mobilepush/nl/zh/CN/t_enable-ios-notifications-receive.md b/services/mobilepush/nl/zh/CN/t_enable-ios-notifications-receive.md index 5cc275809..3c7b40897 100644 --- a/services/mobilepush/nl/zh/CN/t_enable-ios-notifications-receive.md +++ b/services/mobilepush/nl/zh/CN/t_enable-ios-notifications-receive.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 在 iOS 设备上接收推送通知 -{: #enable-push-ios-notifications-receiving} - -在 iOS 设备上接收推送通知 - -##Objective-C -要在 iOS 设备上接收推送通知，请将以下 Objective-C 方法添加到应用程序的应用程序代表中。 - -``` -// For Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -要在 iOS 设备上接收推送通知，请将以下 Swift 方法添加到应用程序的应用程序代表中。 - -``` -//For Swift - func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the server - } -``` - +--- + +copyright: + years: 2015, 2016 + +--- + +# 在 iOS 设备上接收推送通知 +{: #enable-push-ios-notifications-receiving} + +在 iOS 设备上接收推送通知 + +## Objective-C +要在 iOS 设备上接收推送通知，请将以下 Objective-C 方法添加到应用程序的应用程序代表中。 + +``` +// For Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +## Swift +要在 iOS 设备上接收推送通知，请将以下 Swift 方法添加到应用程序的应用程序代表中。 + +``` +//For Swift + func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the server + } +``` + diff --git a/services/mobilepush/nl/zh/CN/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/zh/CN/t_enable_actionable_notifications_ios.md index 3df95a5d8..e60ef5309 100644 --- a/services/mobilepush/nl/zh/CN/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/zh/CN/t_enable_actionable_notifications_ios.md @@ -1,100 +1,100 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 启用针对 iOS 的可操作通知 -{: #enable-actionable-notifications-ios} - -与传统推送通知不同，可操作通知会提示用户在收到通知警报时进行相应的选择，而无需打开应用程序。请使用以下指示信息在应用程序中启用可操作推送通知。 - -1. 创建用户响应操作。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. 创建通知类别并设置操作。**UIUserNotificationActionContextDefault** 或 **UIUserNotificationActionContextMinimal** 是有效的上下文。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. 创建通知设置并分配前一步中的类别。 - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. 创建本地或远程通知，并为其分配类别的标识。 - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; -[[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories)application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# 启用针对 iOS 的可操作通知 +{: #enable-actionable-notifications-ios} + +与传统推送通知不同，可操作通知会提示用户在收到通知警报时进行相应的选择，而无需打开应用程序。请使用以下指示信息在应用程序中启用可操作推送通知。 + +1. 创建用户响应操作。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. 创建通知类别并设置操作。**UIUserNotificationActionContextDefault** 或 **UIUserNotificationActionContextMinimal** 是有效的上下文。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. 创建通知设置并分配前一步中的类别。 + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. 创建本地或远程通知，并为其分配类别的标识。 + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; +[[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories)application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_initialize.md b/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_initialize.md index 79e57e312..97a47df2e 100644 --- a/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_initialize.md +++ b/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_initialize.md @@ -1,63 +1,63 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 为 iOS 应用程序初始化推送 SDK -{: #enable-push-ios-notifications-initialize} - -在 iOS 应用程序中，通常会将初始化代码放置在应用程序代表中。单击 Bluemix 应用程序仪表板中的**移动选项**链接，以获取应用程序路径和 GUID。 - -##初始化核心 SDK - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstancemyBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - -##初始化客户机推送 SDK - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## 路径、GUID 和 Bluemix 区域 - -**appRoute** - -指定分配给在 Bluemix 上创建的服务器应用程序的路径。 - -**GUID** - -指定分配给在 Bluemix 上创建的应用程序的唯一键。此值区分大小写。 - -**bluemixRegionSuffix** - -指定托管应用程序的位置。`bluemixRegion` 参数指定要使用的 Bluemix 部署。可以使用 `BMSClient.REGION` 静态属性设置此值，并使用以下三个值中的一个值： - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY +--- + +copyright: + years: 2015, 2016 + +--- + +# 为 iOS 应用程序初始化推送 SDK +{: #enable-push-ios-notifications-initialize} + +在 iOS 应用程序中，通常会将初始化代码放置在应用程序代表中。单击 Bluemix 应用程序仪表板中的**移动选项**链接，以获取应用程序路径和 GUID。 + +## 初始化核心 SDK + +### Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +### Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstancemyBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + +## 初始化客户机推送 SDK + +### Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +### Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## 路径、GUID 和 Bluemix 区域 + +**appRoute** + +指定分配给在 Bluemix 上创建的服务器应用程序的路径。 + +**GUID** + +指定分配给在 Bluemix 上创建的应用程序的唯一键。此值区分大小写。 + +**bluemixRegionSuffix** + +指定托管应用程序的位置。`bluemixRegion` 参数指定要使用的 Bluemix 部署。可以使用 `BMSClient.REGION` 静态属性设置此值，并使用以下三个值中的一个值： + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY diff --git a/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_install.md b/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_install.md index f7a4d5d12..e784198e5 100644 --- a/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_install.md +++ b/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_install.md @@ -1,319 +1,319 @@ -# 为 iOS 应用程序初始化推送 SDK -{: #enable-push-ios-notifications-install} - -对于现有 Xcode 项目，可以使用 CocoaPods 依赖关系管理工具来设置 Bluemix Mobile Services 客户机 SDK。替代方法是手动安装该 SDK。 - -**注**：要查看 Swift Push 自述文件，请转至 https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master - -##安装 CocoaPods - -1. 在 Mac 终端中，使用以下命令安装 CocoaPods： - -``` -$ sudo gem install cocoapods -``` -2. 在终端中输入以下命令来初始化 CocoaPods。发出此命令时，确保此命令是在 Xcode 项目所在目录中运行。`pod init` 命令会创建文件标题。 - -``` -$ pod init -``` -3. 在生成的 Podfile 中，添加所需的 SDK 依赖关系。复制以下 Podfile。 - - Objective-C - - ``` -source 'https://github.com/CocoaPods/Specs.git' - Copy the following list as is and remove the dependencies you do not need - pod 'IMFCore' - pod 'IMFPush' - ``` - - Swift - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - end - ``` -3. 在终端中，转至项目文件夹，然后使用以下命令安装依赖关系： -``` -$ pod update -``` -该命令会安装依赖关系并创建新的 Xcode 工作空间。**注**：确保始终打开新的 Xcode 工作空间，而不是原始 Xcode 项目文件： - -``` - $ open App.xcworkspace - ``` -该工作空间包含原始项目，以及包含依赖关系的 Pods 项目。如果要修改 Bluemix Mobile Services 源文件夹，那么可以在 Pods 项目的 `Pods/yourImportedSourceFolder` 下找到该文件夹，例如：`Pods/IMFGoogleAuthentication`。 - -##使用导入的框架和源文件夹 - -在代码中引用 SDK。 - - -### Objective-C - -针对相关头编写 #import 伪指令，例如： - -``` -//Objective-C -#import -#import -``` - -**注**：使用 CocoaPods 命令 `pod install` 或 `pod update` 更新 Pods 项目可能会覆盖 Bluemix Mobile Services 源文件夹。如果要保留原始文件的定制版本，请确保在发出其中某个命令之前已备份这些文件。 - -###Swift - -**先决条件** - -- iOS 8.0 或更高版本 -- Xcode 7 - - -针对相关头编写 #import 伪指令，例如： - -``` -//swift -import BMSCore -import BMSPush -``` - - -##构建设置 - -转至 **Xcode > 构建设置 > 构建选项**，然后将**启用位代码**设置为**否**。 - -**注意**：自 iOS 9 起，对应用程序传输安全性 (ATS) 功能的更改可能会影响您处理认证过程的方式。以下博客帖子描述了有关这些更改的更多信息：[ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) 和 [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) - - - - -# 为 iOS 应用程序初始化推送 SDK -{: #enable-push-ios-notifications-initialize} - -在 iOS 应用程序中，通常会将初始化代码放置在应用程序代表中。 -单击 Bluemix 应用程序仪表板中的**移动选项**链接，以获取应用程序路径和 GUID。 - -##初始化核心 SDK - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - - -##初始化客户机推送 SDK - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## 路径、GUID 和 Bluemix 区域 - -**appRoute** - -指定分配给在 Bluemix 上创建的服务器应用程序的路径。 - -**GUID** - -指定分配给在 Bluemix 上创建的应用程序的唯一键。此值区分大小写。 - -**bluemixRegionSuffix** - -指定托管应用程序的位置。`bluemixRegion` 参数指定要使用的 Bluemix 部署。可以使用 `BMSClient.REGION` 静态属性设置此值，并使用以下三个值中的一个值： - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - - - - -# 注册 iOS 应用程序和设备 -{: #enable-push-ios-notifications-register} - - -应用程序必须向 APNs 进行注册，才能接收远程通知，该注册通常发生在将应用程序安装到设备上之后。当应用程序收到 APNs 生成的设备令牌后，必须将该令牌传递回 Push Notifications Service。 - -要注册 iOS 应用程序和设备，请执行以下操作： - -1. 创建后端应用程序 -2. 将令牌传递给 Push Notifications - - -##创建后端应用程序 - -在 Bluemix®“目录”的“样板”部分中创建后端应用程序，这会自动将该 Push 服务绑定到此应用程序。如果已创建后端应用程序，请务必将该应用程序绑定到 Push Notification Service。 - -###Objective-C - -``` - //For Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ -[[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##将令牌传递给 Push Notifications - -从 APNs 收到令牌后，将该令牌传递给 Push Notifications（作为 `registerDevice:withDeviceToken` -方法的一部分）。 - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; -[client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; -// get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -从 APNS 收到令牌后，将该令牌传递给 Push Notifications（作为 `didRegisterForRemoteNotificationsWithDeviceToken` -方法的一部分）。 - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` - - - -# 在 iOS 设备上接收推送通知 -{: #enable-push-ios-notifications-receiving} - -在 iOS 设备上接收推送通知 - -##Objective-C -要在 iOS 设备上接收推送通知，请将以下 Objective-C 方法添加到应用程序的应用程序代表中。 - -``` -// For Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -要在 iOS 设备上接收推送通知，请将以下 Swift 方法添加到应用程序的应用程序代表中。 - -``` -//For Swift - func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the server - } - -``` - - - -# 发送基本推送通知 -{: #push-send-notifications} - -开发应用程序后，可以发送基本推送通知（不使用标记、角标、其他有效内容或声音文件）。 - - -发送基本推送通知。 - -1. 在**选择受众**中，选择以下某个受众：**所有设备**，或者按平台选择：**仅限 iOS 设备**或**仅限 Android 设备**。 - - **注**：选择**所有设备**选项时，预订了推送通知的所有设备都会收到通知。 - - ![“通知”屏幕](images/tag_notification.jpg) - -2. 在**创建通知**中，输入消息然后单击**发送**。 -3. 验证设备是否收到通知。 - - 以下屏幕快照显示了在 Android 和 iOS 设备上前台处理推送通知的警报框。 - - ![Android 上的前台推送通知](images/Android_Screenshot.jpg) - - ![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) - - 以下屏幕快照显示了 Android 后台的推送通知。 - ![Android 上的后台推送通知](images/background.jpg) - - - - -# 后续步骤 -{: #next_steps_tags} - -成功设置基本通知后，可以配置基于标记的通知和高级选项。 - -将这些 Push Notifications 服务功能添加到应用程序中。 -要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 -要使用高级通知选项，请参阅[高级推送通知](t_advance_notifications.html)。 +# 为 iOS 应用程序初始化推送 SDK +{: #enable-push-ios-notifications-install} + +对于现有 Xcode 项目，可以使用 CocoaPods 依赖关系管理工具来设置 Bluemix Mobile Services 客户机 SDK。替代方法是手动安装该 SDK。 + +**注**：要查看 Swift Push 自述文件，请转至 https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master + +## 安装 CocoaPods + +1. 在 Mac 终端中，使用以下命令安装 CocoaPods： + +``` +$ sudo gem install cocoapods +``` +2. 在终端中输入以下命令来初始化 CocoaPods。发出此命令时，确保此命令是在 Xcode 项目所在目录中运行。`pod init` 命令会创建文件标题。 + +``` +$ pod init +``` +3. 在生成的 Podfile 中，添加所需的 SDK 依赖关系。复制以下 Podfile。 + + Objective-C + + ``` +source 'https://github.com/CocoaPods/Specs.git' + Copy the following list as is and remove the dependencies you do not need + pod 'IMFCore' + pod 'IMFPush' + ``` + + Swift + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + end + ``` +3. 在终端中，转至项目文件夹，然后使用以下命令安装依赖关系： +``` +$ pod update +``` +该命令会安装依赖关系并创建新的 Xcode 工作空间。**注**：确保始终打开新的 Xcode 工作空间，而不是原始 Xcode 项目文件： + +``` + $ open App.xcworkspace + ``` +该工作空间包含原始项目，以及包含依赖关系的 Pods 项目。如果要修改 Bluemix Mobile Services 源文件夹，那么可以在 Pods 项目的 `Pods/yourImportedSourceFolder` 下找到该文件夹，例如：`Pods/IMFGoogleAuthentication`。 + +##使用导入的框架和源文件夹 + +在代码中引用 SDK。 + + +### Objective-C + +针对相关头编写 #import 伪指令，例如： + +``` +//Objective-C +# import +# import +``` + +**注**：使用 CocoaPods 命令 `pod install` 或 `pod update` 更新 Pods 项目可能会覆盖 Bluemix Mobile Services 源文件夹。如果要保留原始文件的定制版本，请确保在发出其中某个命令之前已备份这些文件。 + +###Swift + +**先决条件** + +- iOS 8.0 或更高版本 +- Xcode 7 + + +针对相关头编写 #import 伪指令，例如： + +``` +//swift +import BMSCore +import BMSPush +``` + + +##构建设置 + +转至 **Xcode > 构建设置 > 构建选项**，然后将**启用位代码**设置为**否**。 + +**注意**：自 iOS 9 起，对应用程序传输安全性 (ATS) 功能的更改可能会影响您处理认证过程的方式。以下博客帖子描述了有关这些更改的更多信息：[ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) 和 [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) + + + + +# 为 iOS 应用程序初始化推送 SDK +{: #enable-push-ios-notifications-initialize} + +在 iOS 应用程序中，通常会将初始化代码放置在应用程序代表中。 +单击 Bluemix 应用程序仪表板中的**移动选项**链接，以获取应用程序路径和 GUID。 + +##初始化核心 SDK + +###Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +###Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + + +##初始化客户机推送 SDK + +###Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +###Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## 路径、GUID 和 Bluemix 区域 + +**appRoute** + +指定分配给在 Bluemix 上创建的服务器应用程序的路径。 + +**GUID** + +指定分配给在 Bluemix 上创建的应用程序的唯一键。此值区分大小写。 + +**bluemixRegionSuffix** + +指定托管应用程序的位置。`bluemixRegion` 参数指定要使用的 Bluemix 部署。可以使用 `BMSClient.REGION` 静态属性设置此值，并使用以下三个值中的一个值： + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + + + + +# 注册 iOS 应用程序和设备 +{: #enable-push-ios-notifications-register} + + +应用程序必须向 APNs 进行注册，才能接收远程通知，该注册通常发生在将应用程序安装到设备上之后。当应用程序收到 APNs 生成的设备令牌后，必须将该令牌传递回 Push Notifications Service。 + +要注册 iOS 应用程序和设备，请执行以下操作： + +1. 创建后端应用程序 +2. 将令牌传递给 Push Notifications + + +##创建后端应用程序 + +在 Bluemix®“目录”的“样板”部分中创建后端应用程序，这会自动将该 Push 服务绑定到此应用程序。如果已创建后端应用程序，请务必将该应用程序绑定到 Push Notification Service。 + +###Objective-C + +``` + //For Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ +[[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +###Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +##将令牌传递给 Push Notifications + +从 APNs 收到令牌后，将该令牌传递给 Push Notifications（作为 `registerDevice:withDeviceToken` +方法的一部分）。 + +###Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; +[client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; +// get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +###Swift + +从 APNS 收到令牌后，将该令牌传递给 Push Notifications（作为 `didRegisterForRemoteNotificationsWithDeviceToken` +方法的一部分）。 + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` + + + +# 在 iOS 设备上接收推送通知 +{: #enable-push-ios-notifications-receiving} + +在 iOS 设备上接收推送通知 + +##Objective-C +要在 iOS 设备上接收推送通知，请将以下 Objective-C 方法添加到应用程序的应用程序代表中。 + +``` +// For Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +##Swift +要在 iOS 设备上接收推送通知，请将以下 Swift 方法添加到应用程序的应用程序代表中。 + +``` +//For Swift + func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the server + } + +``` + + + +# 发送基本推送通知 +{: #push-send-notifications} + +开发应用程序后，可以发送基本推送通知（不使用标记、角标、其他有效内容或声音文件）。 + + +发送基本推送通知。 + +1. 在**选择受众**中，选择以下某个受众：**所有设备**，或者按平台选择：**仅限 iOS 设备**或**仅限 Android 设备**。 + + **注**：选择**所有设备**选项时，预订了推送通知的所有设备都会收到通知。 + + ![“通知”屏幕](images/tag_notification.jpg) + +2. 在**创建通知**中，输入消息然后单击**发送**。 +3. 验证设备是否收到通知。 + + 以下屏幕快照显示了在 Android 和 iOS 设备上前台处理推送通知的警报框。 + + ![Android 上的前台推送通知](images/Android_Screenshot.jpg) + + ![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) + + 以下屏幕快照显示了 Android 后台的推送通知。 + ![Android 上的后台推送通知](images/background.jpg) + + + + +# 后续步骤 +{: #next_steps_tags} + +成功设置基本通知后，可以配置基于标记的通知和高级选项。 + +将这些 Push Notifications 服务功能添加到应用程序中。 +要使用基于标记的通知，请参阅[基于标记的通知](c_tag_basednotifications.html)。 +要使用高级通知选项，请参阅[高级推送通知](t_advance_notifications.html)。 diff --git a/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_register.md b/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_register.md index d576008b5..4b102272c 100644 --- a/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_register.md +++ b/services/mobilepush/nl/zh/CN/t_enable_ios_notifications_register.md @@ -1,91 +1,91 @@ -# 注册 iOS 应用程序和设备 -{: #enable-push-ios-notifications-register} - - -应用程序必须向 APNs 进行注册，才能接收远程通知，该注册通常发生在将应用程序安装到设备上之后。当应用程序收到 APNs 生成的设备令牌后，必须将该令牌传递回 Push Notifications Service。 - -要注册 iOS 应用程序和设备，请执行以下操作： - -1. 创建后端应用程序 -2. 将令牌传递给 Push Notifications - - -##创建后端应用程序 - -在 Bluemix®“目录”的“样板”部分中创建后端应用程序，这会自动将该 Push 服务绑定到此应用程序。如果已创建后端应用程序，请务必将该应用程序绑定到 Push Notification Service。 - -###Objective-C - -``` - //For Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ -[[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##将令牌传递给 Push Notifications - -从 APNs 收到令牌后，将该令牌传递给 Push Notifications（作为 `registerDevice:withDeviceToken` -方法的一部分）。 - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; -[client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; -// get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -从 APNS 收到令牌后，将该令牌传递给 Push Notifications（作为 `didRegisterForRemoteNotificationsWithDeviceToken` -方法的一部分）。 - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` +# 注册 iOS 应用程序和设备 +{: #enable-push-ios-notifications-register} + + +应用程序必须向 APNs 进行注册，才能接收远程通知，该注册通常发生在将应用程序安装到设备上之后。当应用程序收到 APNs 生成的设备令牌后，必须将该令牌传递回 Push Notifications Service。 + +要注册 iOS 应用程序和设备，请执行以下操作： + +1. 创建后端应用程序 +2. 将令牌传递给 Push Notifications + + +##创建后端应用程序 + +在 Bluemix®“目录”的“样板”部分中创建后端应用程序，这会自动将该 Push 服务绑定到此应用程序。如果已创建后端应用程序，请务必将该应用程序绑定到 Push Notification Service。 + +###Objective-C + +``` + //For Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ +[[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +###Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +##将令牌传递给 Push Notifications + +从 APNs 收到令牌后，将该令牌传递给 Push Notifications（作为 `registerDevice:withDeviceToken` +方法的一部分）。 + +###Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; +[client initializeWithBackendRoute:@"your-backend-route-here" backendGUID:@"Your-backend-GUID-here"]; +// get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +###Swift + +从 APNS 收到令牌后，将该令牌传递给 Push Notifications（作为 `didRegisterForRemoteNotificationsWithDeviceToken` +方法的一部分）。 + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` diff --git a/services/mobilepush/nl/zh/CN/t_get_tags.md b/services/mobilepush/nl/zh/CN/t_get_tags.md index cab405a46..1a3e799e1 100644 --- a/services/mobilepush/nl/zh/CN/t_get_tags.md +++ b/services/mobilepush/nl/zh/CN/t_get_tags.md @@ -1,148 +1,148 @@ -# 获取标记 -{: #get_tags} - -标记不同于发送给所有应用程序的一般性广播，通过标记，可以根据用户的兴趣发送有针对性的通知。您可以使用“推送”仪表板上的“标记”选项卡或使用 REST API 来创建和管理标记。您可以使用以下部分中的代码片段来管理和查询移动应用程序的标记预订。还可以使用这些代码片段来获取预订、预订标记、取消预订标记，以及获取可用标记的列表。您可将这些代码片段复制并粘贴到移动应用程序中。 - -## Android - -**getTags** API 会返回设备可预订的可用标记的列表。在预订特定标记后，设备可以接收针对该标记发送的任何推送通知。 - -将以下代码片段复制到 Android 移动应用程序中，以获取设备所预订的标记的列表以及获取可用标记的列表。 - -使用以下 **getTags** API 可获取设备可预订的可用标记的列表。 - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - -使用以下 **getSubscriptions** API 可获取设备所预订的标记的列表。 - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { -@Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) -``` - -## Cordova - -将以下代码片段复制到移动应用程序中，以获取设备所预订的标记的列表以及获取设备可预订的可用标记的列表。 - -检索可供预订的标记的数组。 - -``` -//Get a list of available tags to which the device can subscribe -MFPPush.retrieveAvailableTags(function(tags) {alert(tags); -}, null); -``` - -``` -//Get a list of available tags to which the device is subscribed. -MFPPush.getSubscriptionStatus(function(tags) { -alert(tags); -}, null); -``` - -## Objective-C - -将以下代码片段复制到使用 Objective-C 开发的 iOS 应用程序中，以获取设备所预订的标记的列表以及获取设备可预订的可用标记的列表。 - -使用以下 **retrieveAvailableTags** API 可获取设备可预订的可用标记的列表。 - -``` -//Get a list of available tags to which the device can subscribe -[push retrieveAvailableTagsWithCompletionHandler: -^(IMFResponse *response, NSError *error){ - if(error){ - [self updateMessage:error.description]; - } else - { - [self updateMessage:@"Successfully retrieved available tags."]; - NSDictionary *availableTags = [[NSDictionary alloc]init]; - availableTags = [response tags]; -[self.appDelegateVC updateMessage:availableTags.description]; -} -}]; -``` - -使用以下 **retrieveSubscriptions** API 可获取设备所预订的标记的列表。 - - -``` -// Get a list of tags that to which the device is subscribed. -[push retrieveSubscriptionsWithCompletionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved subscriptions."]; - NSDictionary *subscribedTags = [[NSDictionary alloc]init]; -subscribedTags = [response subscriptions]; -[self.appDelegateVC updateMessage:subscribedTags.description]; -} -}]; -``` - -## Swift - -**retrieveAvailableTagsWithCompletionHandler** API 会返回设备可预订的可用标记的列表。在预订特定标记后，设备可以接收针对该标记发送的任何推送通知。 - -调用推送服务来预订标记。 - -将以下代码片段复制到 Swift 移动应用程序中，以获取设备所预订的标记的列表以及获取设备可预订的可用标记的列表。 - - -``` -//Get a list of available tags to which the device can subscribe -push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void inif error.isEmpty { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else{ - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - - print( "Response during retrieving subscribed tags : \(response.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else - { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - - - +# 获取标记 +{: #get_tags} + +标记不同于发送给所有应用程序的一般性广播，通过标记，可以根据用户的兴趣发送有针对性的通知。您可以使用“推送”仪表板上的“标记”选项卡或使用 REST API 来创建和管理标记。您可以使用以下部分中的代码片段来管理和查询移动应用程序的标记预订。还可以使用这些代码片段来获取预订、预订标记、取消预订标记，以及获取可用标记的列表。您可将这些代码片段复制并粘贴到移动应用程序中。 + +## Android + +**getTags** API 会返回设备可预订的可用标记的列表。在预订特定标记后，设备可以接收针对该标记发送的任何推送通知。 + +将以下代码片段复制到 Android 移动应用程序中，以获取设备所预订的标记的列表以及获取可用标记的列表。 + +使用以下 **getTags** API 可获取设备可预订的可用标记的列表。 + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + +使用以下 **getSubscriptions** API 可获取设备所预订的标记的列表。 + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { +@Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) +``` + +## Cordova + +将以下代码片段复制到移动应用程序中，以获取设备所预订的标记的列表以及获取设备可预订的可用标记的列表。 + +检索可供预订的标记的数组。 + +``` +//Get a list of available tags to which the device can subscribe +MFPPush.retrieveAvailableTags(function(tags) {alert(tags); +}, null); +``` + +``` +//Get a list of available tags to which the device is subscribed. +MFPPush.getSubscriptionStatus(function(tags) { +alert(tags); +}, null); +``` + +## Objective-C + +将以下代码片段复制到使用 Objective-C 开发的 iOS 应用程序中，以获取设备所预订的标记的列表以及获取设备可预订的可用标记的列表。 + +使用以下 **retrieveAvailableTags** API 可获取设备可预订的可用标记的列表。 + +``` +//Get a list of available tags to which the device can subscribe +[push retrieveAvailableTagsWithCompletionHandler: +^(IMFResponse *response, NSError *error){ + if(error){ + [self updateMessage:error.description]; + } else + { + [self updateMessage:@"Successfully retrieved available tags."]; + NSDictionary *availableTags = [[NSDictionary alloc]init]; + availableTags = [response tags]; +[self.appDelegateVC updateMessage:availableTags.description]; +} +}]; +``` + +使用以下 **retrieveSubscriptions** API 可获取设备所预订的标记的列表。 + + +``` +// Get a list of tags that to which the device is subscribed. +[push retrieveSubscriptionsWithCompletionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved subscriptions."]; + NSDictionary *subscribedTags = [[NSDictionary alloc]init]; +subscribedTags = [response subscriptions]; +[self.appDelegateVC updateMessage:subscribedTags.description]; +} +}]; +``` + +## Swift + +**retrieveAvailableTagsWithCompletionHandler** API 会返回设备可预订的可用标记的列表。在预订特定标记后，设备可以接收针对该标记发送的任何推送通知。 + +调用推送服务来预订标记。 + +将以下代码片段复制到 Swift 移动应用程序中，以获取设备所预订的标记的列表以及获取设备可预订的可用标记的列表。 + + +``` +//Get a list of available tags to which the device can subscribe +push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void inif error.isEmpty { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else{ + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + + print( "Response during retrieving subscribed tags : \(response.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else + { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + + + diff --git a/services/mobilepush/nl/zh/CN/t_handle_actionable_notifications_ios.md b/services/mobilepush/nl/zh/CN/t_handle_actionable_notifications_ios.md index f396dc368..e4c19a3bc 100644 --- a/services/mobilepush/nl/zh/CN/t_handle_actionable_notifications_ios.md +++ b/services/mobilepush/nl/zh/CN/t_handle_actionable_notifications_ios.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 处理针对 iOS 的可操作通知 -{: #actionable-notifications} - - -收到可操作通知时，会根据所选择的标识将控制权传递到以下方法上。 - -###Objective-C - -``` -(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: -(UILocalNotification *)notification completionHandler:(void (^)())completionHandler -{ - NSLog(@"actionable notification received."); - //must call completion handler when finished - completionHandler(); -} -``` - -###Swift - -``` -func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { -//must call completion handler when finished - completionHandler() - } -``` - - +--- + +copyright: + years: 2015, 2016 + +--- + +# 处理针对 iOS 的可操作通知 +{: #actionable-notifications} + + +收到可操作通知时，会根据所选择的标识将控制权传递到以下方法上。 + +###Objective-C + +``` +(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: +(UILocalNotification *)notification completionHandler:(void (^)())completionHandler +{ + NSLog(@"actionable notification received."); + //must call completion handler when finished + completionHandler(); +} +``` + +###Swift + +``` +func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { +//must call completion handler when finished + completionHandler() + } +``` + + diff --git a/services/mobilepush/nl/zh/CN/t_holding_notifications_android.md b/services/mobilepush/nl/zh/CN/t_holding_notifications_android.md index eba79b441..1c5072b63 100644 --- a/services/mobilepush/nl/zh/CN/t_holding_notifications_android.md +++ b/services/mobilepush/nl/zh/CN/t_holding_notifications_android.md @@ -1,28 +1,28 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 针对 Android 的暂停通知 -{: #hold-notifications-android} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - -应用程序转入后台运行时，您可能希望 {{site.data.keyword.mobilepushshort}} 服务暂停发送给应用程序的通知。要暂停通知，请调用处理 {{site.data.keyword.mobilepushshort}} 的活动的 onPause() 方法中的 hold() 方法。 - -``` - @Override -protected void onPause() {super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 针对 Android 的暂停通知 +{: #hold-notifications-android} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + +应用程序转入后台运行时，您可能希望 {{site.data.keyword.mobilepushshort}} 服务暂停发送给应用程序的通知。要暂停通知，请调用处理 {{site.data.keyword.mobilepushshort}} 的活动的 onPause() 方法中的 hold() 方法。 + +``` + @Override +protected void onPause() {super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} diff --git a/services/mobilepush/nl/zh/CN/t_manage_tags.md b/services/mobilepush/nl/zh/CN/t_manage_tags.md index 0b4184a6c..ad4d16145 100644 --- a/services/mobilepush/nl/zh/CN/t_manage_tags.md +++ b/services/mobilepush/nl/zh/CN/t_manage_tags.md @@ -1,349 +1,349 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 管理标记 -{: #manage_tags} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - -使用 {{site.data.keyword.mobilepushshort}} 仪表板，可以创建和删除应用程序的标记，然后初始化基于标记的通知。预订了标记的设备会收到基于标记的通知。 - - -## 创建标记 -{: #create_tags} - -基于标记的通知是针对预订了特定标记的所有设备的消息。每个设备都可以预订任意数量的标记。删除标记时，与该标记关联的信息（包括其订户和设备）都会一并删除。不需要自动取消预订，因为该标记不存在。客户端不需要任何进一步操作。 - -1. 在 {{site.data.keyword.mobilepushshort}} 仪表板上，选择**标记**选项卡。 -1. 单击 + **创建标记**按钮。 - 1. 在**名称**字段中，输入标记的名称。例如，“coupons”。 - 1. 在**描述**字段中，输入标记描述。 - 1. 单击**保存**。 - -1. 在**代码片段**区域中，选择移动应用程序的平台。 -1. 修改代码片段以处理错误，然后将每个标记的代码片段复制到移动应用程序中。 - -## 删除标记 -{: #delete_tags} - -1. 从**标记**选项卡，选择要删除的标记，并单击**删除**图标。 -1. 单击**确定**。 - -## 编辑标记描述 -{: #edit_tags} - -1. 在**标记**选项卡中，选择要编辑的标记。 -1. 单击**编辑**图标。 -1. 编辑标记描述，然后单击**保存**按钮。 - -# 获取标记 -{: #get_tags} - -不同于发送给所有应用程序的一般性广播，通过标记，可以根据用户的兴趣发送有针对性的通知。您可以使用 {{site.data.keyword.mobilepushshort}} 仪表板上的“标记”选项卡或使用 REST API 来创建和管理标记。您可以使用代码片段来管理和查询移动应用程序的标记预订。还可以使用这些代码片段来获取预订、预订标记、取消预订标记，或者获取可用标记的列表。将这些代码片段复制到移动应用程序中。 - -## 在 Android 上获取标记 -{: android-get-tags} - -**getTags** API 会返回设备可预订的可用标记的列表。在设备预订特定标记后，该设备可以接收针对该标记发送的 {{site.data.keyword.mobilepushshort}}。 - -将以下代码片段复制到 Android 移动应用程序中，以获取设备所预订的标记的列表以及获取可用标记的列表。 - -使用以下 **getTags** API 可获取设备可预订的可用标记的列表。 - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - {: codeblock} - -使用以下 **getSubscriptions** API 可获取设备所预订的标记的列表。 - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { -@Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) - ``` - {: codeblock} - -## 在 Cordova 上获取标记 -{: cordova-get-tags} - -将以下代码片段复制到移动应用程序中，以获取设备所预订的标记的列 -表以及可用标记的列表。 - -检索可供预订的标记的数组。 - -``` -//Get a list of available tags to which the device can subscribe -BMSPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed. -BMSPush.retrieveSubscriptions(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - - -## 在 Swift 上获取标记 -{: swift-get-tags} - -**retrieveAvailableTagsWithCompletionHandler** API 会返回设备可预订的可用标记的列表。在设备预订特定标记后，该设备可以接收针对该标记发送的 {{site.data.keyword.mobilepushshort}}。 - -调用 {{site.data.keyword.mobilepushshort}} 来预订标记。 - -将以下代码片段复制到 Swift 移动应用程序中，以获取设备所预订的标记的列表以及获取设备可预订的可用标记的列表。 -``` -//Get a list of available tags to which the device can subscribe - push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - if error.isEmpty - { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else - { - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - - print( "Response during retrieving subscribed tags : \(response?.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else - { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -## Google Chrome、Safari 和 Mozilla Firefox -{: web-get-tags} - -要获取客户可以预订的可用标记列表，请使用以下代码。 - -``` - var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - - -## Google Chrome Apps and Extensions -{: web-get-tags} - -要获取客户可以预订的可用标记列表，请使用以下代码。 - -``` - var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - -将以下代码片段复制到 Google Chrome Apps and Extensions 中，以获取客户所预订的标记列表。 - -``` - var bmsPush = new BMSPush(); - bmsPush.retrieveSubscriptions(function(response) - { - alert(response.response) - }) -``` - {: codeblock} - - -# 预订和取消预订标记 -{: #Subscribe_tags} - -使用以下代码片段可允许设备获取预订、预订某个标记以及取消预订某个标记。 - -## 在 Android 上预订和取消预订标记 -{: android-subscribe-tags} - -将以下代码片段复制并粘贴到 Android 移动应用程序中。 - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - {: codeblock} - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { -@Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - {: codeblock} - -## 在 Cordova 上预订和取消预订标记 -{: cordova-subscribe-tags} - -将以下代码片段复制并粘贴到 Cordova 移动应用程序中。 - -``` -var tag = "YourTag"; -BMSPush.subscribe(tag, success, failure); -BMSPush.unsubscribe(tag, success, failure); -``` - {: codeblock} - - -## 在 Swift 上预订和取消预订标记 -{: swift-subscribe-tags} - -将以下代码片段复制并粘贴到 Swift 移动应用程序中。 - -使用 **subscribeToTags** API，可以预订标记。 - -``` -push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print("Response when subscribing to tags: \(response?.description)") - print("Status code when subscribing to tags: \(statusCode)") - } else { - print("Error when subscribing to tags: \(error) ") - print("Error status code when subscribing to tags: \(statusCode)") - } -}) -``` - {: codeblock} - -使用 **unsubscribeFromTags** API，可以取消预订标记。 - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during unsubscribed tags : \(response?.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else - { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - {: codeblock} - -## Google Chrome 和 Mozilla Firefox -{: web-subscribe-tags} - -要从 Web 应用程序预订标记，请使用以下代码片段： - -``` -var tagsArray = ["tag1", "Tag2"] -bmsPush.subscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -要取消预订标记，请使用 **unSubscribe** 方法。 - -``` -var tagsArray = ["tag1", "Tag2"] - bmsPush.unSubscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -# 使用基于标记的通知 -{: #using_tags} - -基于标记的通知是针对预订了特定标记的所有设备的消息。每个设备都可以预订任意数量的标记。本主题描述了如何发送基于标记的通知。预订通过 {{site.data.keyword.mobilepushshort}} 服务 Bluemix 实例进行维护。删除标记时，与该标记关联的所有信息（包括其订户和设备）都会一并删除。无需对此标记自动取消预订，因为此标记不再存在，因此也不需要从客户机端执行进一步的操作。 - -在**标记**屏幕上创建标记。有关如何创建标记的信息，请参阅[创建标记](t_manage_tags.html)。 - -1. 从 **Push Notification** 仪表板，单击**发送通知**。 -1. 在**发送到**下拉列表中，选择**按标记列出设备**选项。 -1. 搜索您要使用的标记并选择它们。 -![通知屏幕](images/tag_notification.jpg) -1. 在**消息文本**字段中，输入将作为通知发送给订阅受众的文本。 -1. 单击**发送**。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 管理标记 +{: #manage_tags} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + +使用 {{site.data.keyword.mobilepushshort}} 仪表板，可以创建和删除应用程序的标记，然后初始化基于标记的通知。预订了标记的设备会收到基于标记的通知。 + + +## 创建标记 +{: #create_tags} + +基于标记的通知是针对预订了特定标记的所有设备的消息。每个设备都可以预订任意数量的标记。删除标记时，与该标记关联的信息（包括其订户和设备）都会一并删除。不需要自动取消预订，因为该标记不存在。客户端不需要任何进一步操作。 + +1. 在 {{site.data.keyword.mobilepushshort}} 仪表板上，选择**标记**选项卡。 +1. 单击 + **创建标记**按钮。 + 1. 在**名称**字段中，输入标记的名称。例如，“coupons”。 + 1. 在**描述**字段中，输入标记描述。 + 1. 单击**保存**。 + +1. 在**代码片段**区域中，选择移动应用程序的平台。 +1. 修改代码片段以处理错误，然后将每个标记的代码片段复制到移动应用程序中。 + +## 删除标记 +{: #delete_tags} + +1. 从**标记**选项卡，选择要删除的标记，并单击**删除**图标。 +1. 单击**确定**。 + +## 编辑标记描述 +{: #edit_tags} + +1. 在**标记**选项卡中，选择要编辑的标记。 +1. 单击**编辑**图标。 +1. 编辑标记描述，然后单击**保存**按钮。 + +# 获取标记 +{: #get_tags} + +不同于发送给所有应用程序的一般性广播，通过标记，可以根据用户的兴趣发送有针对性的通知。您可以使用 {{site.data.keyword.mobilepushshort}} 仪表板上的“标记”选项卡或使用 REST API 来创建和管理标记。您可以使用代码片段来管理和查询移动应用程序的标记预订。还可以使用这些代码片段来获取预订、预订标记、取消预订标记，或者获取可用标记的列表。将这些代码片段复制到移动应用程序中。 + +## 在 Android 上获取标记 +{: android-get-tags} + +**getTags** API 会返回设备可预订的可用标记的列表。在设备预订特定标记后，该设备可以接收针对该标记发送的 {{site.data.keyword.mobilepushshort}}。 + +将以下代码片段复制到 Android 移动应用程序中，以获取设备所预订的标记的列表以及获取可用标记的列表。 + +使用以下 **getTags** API 可获取设备可预订的可用标记的列表。 + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + {: codeblock} + +使用以下 **getSubscriptions** API 可获取设备所预订的标记的列表。 + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { +@Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) + ``` + {: codeblock} + +## 在 Cordova 上获取标记 +{: cordova-get-tags} + +将以下代码片段复制到移动应用程序中，以获取设备所预订的标记的列 +表以及可用标记的列表。 + +检索可供预订的标记的数组。 + +``` +//Get a list of available tags to which the device can subscribe +BMSPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed. +BMSPush.retrieveSubscriptions(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + + +## 在 Swift 上获取标记 +{: swift-get-tags} + +**retrieveAvailableTagsWithCompletionHandler** API 会返回设备可预订的可用标记的列表。在设备预订特定标记后，该设备可以接收针对该标记发送的 {{site.data.keyword.mobilepushshort}}。 + +调用 {{site.data.keyword.mobilepushshort}} 来预订标记。 + +将以下代码片段复制到 Swift 移动应用程序中，以获取设备所预订的标记的列表以及获取设备可预订的可用标记的列表。 +``` +//Get a list of available tags to which the device can subscribe + push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + if error.isEmpty + { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else + { + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + + print( "Response during retrieving subscribed tags : \(response?.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else + { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +## Google Chrome、Safari 和 Mozilla Firefox +{: web-get-tags} + +要获取客户可以预订的可用标记列表，请使用以下代码。 + +``` + var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + + +## Google Chrome Apps and Extensions +{: web-get-tags} + +要获取客户可以预订的可用标记列表，请使用以下代码。 + +``` + var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + +将以下代码片段复制到 Google Chrome Apps and Extensions 中，以获取客户所预订的标记列表。 + +``` + var bmsPush = new BMSPush(); + bmsPush.retrieveSubscriptions(function(response) + { + alert(response.response) + }) +``` + {: codeblock} + + +# 预订和取消预订标记 +{: #Subscribe_tags} + +使用以下代码片段可允许设备获取预订、预订某个标记以及取消预订某个标记。 + +## 在 Android 上预订和取消预订标记 +{: android-subscribe-tags} + +将以下代码片段复制并粘贴到 Android 移动应用程序中。 + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + {: codeblock} + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { +@Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + {: codeblock} + +## 在 Cordova 上预订和取消预订标记 +{: cordova-subscribe-tags} + +将以下代码片段复制并粘贴到 Cordova 移动应用程序中。 + +``` +var tag = "YourTag"; +BMSPush.subscribe(tag, success, failure); +BMSPush.unsubscribe(tag, success, failure); +``` + {: codeblock} + + +## 在 Swift 上预订和取消预订标记 +{: swift-subscribe-tags} + +将以下代码片段复制并粘贴到 Swift 移动应用程序中。 + +使用 **subscribeToTags** API，可以预订标记。 + +``` +push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print("Response when subscribing to tags: \(response?.description)") + print("Status code when subscribing to tags: \(statusCode)") + } else { + print("Error when subscribing to tags: \(error) ") + print("Error status code when subscribing to tags: \(statusCode)") + } +}) +``` + {: codeblock} + +使用 **unsubscribeFromTags** API，可以取消预订标记。 + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during unsubscribed tags : \(response?.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else + { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + {: codeblock} + +## Google Chrome 和 Mozilla Firefox +{: web-subscribe-tags} + +要从 Web 应用程序预订标记，请使用以下代码片段： + +``` +var tagsArray = ["tag1", "Tag2"] +bmsPush.subscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +要取消预订标记，请使用 **unSubscribe** 方法。 + +``` +var tagsArray = ["tag1", "Tag2"] + bmsPush.unSubscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +# 使用基于标记的通知 +{: #using_tags} + +基于标记的通知是针对预订了特定标记的所有设备的消息。每个设备都可以预订任意数量的标记。本主题描述了如何发送基于标记的通知。预订通过 {{site.data.keyword.mobilepushshort}} 服务 Bluemix 实例进行维护。删除标记时，与该标记关联的所有信息（包括其订户和设备）都会一并删除。无需对此标记自动取消预订，因为此标记不再存在，因此也不需要从客户机端执行进一步的操作。 + +在**标记**屏幕上创建标记。有关如何创建标记的信息，请参阅[创建标记](t_manage_tags.html)。 + +1. 从 **Push Notification** 仪表板，单击**发送通知**。 +1. 在**发送到**下拉列表中，选择**按标记列出设备**选项。 +1. 搜索您要使用的标记并选择它们。 +![通知屏幕](images/tag_notification.jpg) +1. 在**消息文本**字段中，输入将作为通知发送给订阅受众的文本。 +1. 单击**发送**。 diff --git a/services/mobilepush/nl/zh/CN/t_manage_user.md b/services/mobilepush/nl/zh/CN/t_manage_user.md index dcd3e7f70..efa64b7c3 100644 --- a/services/mobilepush/nl/zh/CN/t_manage_user.md +++ b/services/mobilepush/nl/zh/CN/t_manage_user.md @@ -1,167 +1,167 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 使用用户标识注册设备 -{: #register_device_with_userId} -上次更新时间：2017 年 2 月 6 日 -{: .last-updated} - -要注册基于用户标识的通知，请完成以下步骤： - -## Android -{: android-register} - -使用 {{site.data.keyword.mobilepushshort}} 服务的 `AppGUID` 和 `clientSecret` 键来初始化 MFPPush 类。 -``` -// Initialize the Push Notifications service -push = MFPPush.getInstance(); -push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); -``` - {: codeblock} - - -- **AppGUID**：此为 {{site.data.keyword.mobilepushshort}} 服务的 AppGUID 键。 -- **clientSecret**：此为 {{site.data.keyword.mobilepushshort}} 服务的 clientSecret 键。 - - 使用 **registerDeviceWithUserId** API 为设备注册 {{site.data.keyword.mobilepushshort}}。 - -``` -// Register the device to Push Notifications -push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - Log.d("Device is registered with Push Service.");} - @Override - public void onFailure(MFPPushException ex) { - Log.d("Error registering with Push Service...\n" - + "Push notifications will not be received."); - } - }); -``` - {: codeblock} - -- **userId**：传递用于注册 {{site.data.keyword.mobilepushshort}} 的唯一用户标识值。 - -**注：**要启用用户标识所针对的 {{site.data.keyword.mobilepushshort}}，请确保您是使用用户标识注册设备的，并且还需要传递在供应 {{site.data.keyword.mobilepushshort}} 服务时分配的“clientSecret”。没有有效的 clientSecret，设备注册将失败。 - -## Cordova -{: cordova} - -使用以下 API 来注册基于 UserId 的 {{site.data.keyword.mobilepushshort}}。 - -``` -// Register device for Push Notification with UserId -var options = {"userId": "Your User Id value"}; -BMSPush.registerDevice(options,success, failure); -``` - {: codeblock} - - -- **userId**：传递用于注册 {{site.data.keyword.mobilepushshort}} 的唯一用户标识值。 - - -## Swift -{: swift-register} - -``` -// Initialize the BMSPushClient -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -- **AppGUID**：此为 {{site.data.keyword.mobilepushshort}} 服务的 AppGUID 键。 -- **clientSecret**：此为 {{site.data.keyword.mobilepushshort}} 服务的 clientSecret 键。 - -使用 **registerWithUserId** API 为设备注册 {{site.data.keyword.mobilepushshort}}。 - -``` -// Register the device to Push Notifications service -push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in -if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } else { - print( "Error during device registration \(error) ") - } - } -``` - {: codeblock} - -- **userId**：传递用于注册 {{site.data.keyword.mobilepushshort}} 的唯一用户标识值。 - -## Google Chrome、Safari 和 Mozilla Firefox -{: web-register} - -使用以下 API 来注册基于用户标识的通知。使用 `app GUID`、`app Region` 和 `Client Secret` 初始化 SDK。 - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -成功初始化之后，使用用户标识注册 Web 应用程序。 - -``` - bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -## Google Chrome Apps and Extensions -{: web-register-new} - -使用以下 API 来注册基于用户标识的通知。使用 `app GUID`、`app Region` 和 `Client Secret` 初始化 SDK。 - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -成功初始化后，您需要使用用户标识注册 Web 应用程序。 - -``` - bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -# 使用基于用户标记的通知 -{: #using_userid} - -基于用户标识的通知是针对特定用户的通知消息。一个用户可注册多个设备。以下步骤描述了如何发送基于用户标识的通知。 - -1. 从 **Push Notification** 仪表板，选择**发送通知**选项。 -1. 在**发送至**选项列表中，选择**用户标识**。 -1. 在**用户标识**字段中，搜索要使用的用户标识并单击 **+添加**。 -![通知屏幕](images/user_notification.jpg) -1. 在**消息**字段中，输入要在通知中发送的文本。 -1. 单击**发送**。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 使用用户标识注册设备 +{: #register_device_with_userId} +上次更新时间：2017 年 2 月 6 日 +{: .last-updated} + +要注册基于用户标识的通知，请完成以下步骤： + +## Android +{: android-register} + +使用 {{site.data.keyword.mobilepushshort}} 服务的 `AppGUID` 和 `clientSecret` 键来初始化 MFPPush 类。 +``` +// Initialize the Push Notifications service +push = MFPPush.getInstance(); +push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); +``` + {: codeblock} + + +- **AppGUID**：此为 {{site.data.keyword.mobilepushshort}} 服务的 AppGUID 键。 +- **clientSecret**：此为 {{site.data.keyword.mobilepushshort}} 服务的 clientSecret 键。 + + 使用 **registerDeviceWithUserId** API 为设备注册 {{site.data.keyword.mobilepushshort}}。 + +``` +// Register the device to Push Notifications +push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + Log.d("Device is registered with Push Service.");} + @Override + public void onFailure(MFPPushException ex) { + Log.d("Error registering with Push Service...\n" + + "Push notifications will not be received."); + } + }); +``` + {: codeblock} + +- **userId**：传递用于注册 {{site.data.keyword.mobilepushshort}} 的唯一用户标识值。 + +**注：**要启用用户标识所针对的 {{site.data.keyword.mobilepushshort}}，请确保您是使用用户标识注册设备的，并且还需要传递在供应 {{site.data.keyword.mobilepushshort}} 服务时分配的“clientSecret”。没有有效的 clientSecret，设备注册将失败。 + +## Cordova +{: cordova} + +使用以下 API 来注册基于 UserId 的 {{site.data.keyword.mobilepushshort}}。 + +``` +// Register device for Push Notification with UserId +var options = {"userId": "Your User Id value"}; +BMSPush.registerDevice(options,success, failure); +``` + {: codeblock} + + +- **userId**：传递用于注册 {{site.data.keyword.mobilepushshort}} 的唯一用户标识值。 + + +## Swift +{: swift-register} + +``` +// Initialize the BMSPushClient +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +- **AppGUID**：此为 {{site.data.keyword.mobilepushshort}} 服务的 AppGUID 键。 +- **clientSecret**：此为 {{site.data.keyword.mobilepushshort}} 服务的 clientSecret 键。 + +使用 **registerWithUserId** API 为设备注册 {{site.data.keyword.mobilepushshort}}。 + +``` +// Register the device to Push Notifications service +push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in +if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } else { + print( "Error during device registration \(error) ") + } + } +``` + {: codeblock} + +- **userId**：传递用于注册 {{site.data.keyword.mobilepushshort}} 的唯一用户标识值。 + +## Google Chrome、Safari 和 Mozilla Firefox +{: web-register} + +使用以下 API 来注册基于用户标识的通知。使用 `app GUID`、`app Region` 和 `Client Secret` 初始化 SDK。 + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +成功初始化之后，使用用户标识注册 Web 应用程序。 + +``` + bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +## Google Chrome Apps and Extensions +{: web-register-new} + +使用以下 API 来注册基于用户标识的通知。使用 `app GUID`、`app Region` 和 `Client Secret` 初始化 SDK。 + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +成功初始化后，您需要使用用户标识注册 Web 应用程序。 + +``` + bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +# 使用基于用户标记的通知 +{: #using_userid} + +基于用户标识的通知是针对特定用户的通知消息。一个用户可注册多个设备。以下步骤描述了如何发送基于用户标识的通知。 + +1. 从 **Push Notification** 仪表板，选择**发送通知**选项。 +1. 在**发送至**选项列表中，选择**用户标识**。 +1. 在**用户标识**字段中，搜索要使用的用户标识并单击 **+添加**。 +![通知屏幕](images/user_notification.jpg) +1. 在**消息**字段中，输入要在通知中发送的文本。 +1. 单击**发送**。 diff --git a/services/mobilepush/nl/zh/CN/t_push_ios_nextsteps.md b/services/mobilepush/nl/zh/CN/t_push_ios_nextsteps.md index 2fd41b345..44447e0c6 100644 --- a/services/mobilepush/nl/zh/CN/t_push_ios_nextsteps.md +++ b/services/mobilepush/nl/zh/CN/t_push_ios_nextsteps.md @@ -1,21 +1,21 @@ - ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# 后续步骤 - -{: #push-ios-nextsteps} - -成功设置基本通知后，可以配置基于标记的通知和高级选项。 - -将这些 Push Notifications 服务功能添加到应用程序中。 - - - -- 要使用基于标记的通知，请参阅[基于标记的通知](t_push_tagsmain.md)。 -- 要使用高级通知选项，请参阅[高级推送通知](t_advance_notifications.md)。 + +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# 后续步骤 + +{: #push-ios-nextsteps} + +成功设置基本通知后，可以配置基于标记的通知和高级选项。 + +将这些 Push Notifications 服务功能添加到应用程序中。 + + + +- 要使用基于标记的通知，请参阅[基于标记的通知](t_push_tagsmain.md)。 +- 要使用高级通知选项，请参阅[高级推送通知](t_advance_notifications.md)。 diff --git a/services/mobilepush/nl/zh/CN/t_push_monitoring.md b/services/mobilepush/nl/zh/CN/t_push_monitoring.md index 1703010b3..cca1cb508 100644 --- a/services/mobilepush/nl/zh/CN/t_push_monitoring.md +++ b/services/mobilepush/nl/zh/CN/t_push_monitoring.md @@ -1,33 +1,33 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 监视推送通知 -{: #monitor-notifications} -上次更新时间：2017 年 1 月 16 日 -{: .last-updated} - - -IBM {{site.data.keyword.mobilepushshort}} 服务现已扩展了功能，可以通过用户数据生成图形，从而监视推送性能。您可以使用实用程序列出所有已发送的推送通知，或者列出所有已注册的设备，并以每天、每周或每月为基础来分析信息。 - -要为所有已发送的通知生成报告，请使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 中的“推送消息 GET”报告方法。 - -![已发送的通知报告](images/monitoring_messages.jpg) - - -要为所有已注册的设备生成报告，请使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 中的“推送设备注册 GET”报告方法。 - -![已注册的设备报告](images/monitoring_devices.jpg) - -有关如何更新 Android SDK 以监视通知信息的更多信息，请参阅[在 Android 设备上监视推送通知](c_android_enable.html#android_monitor)。 - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 监视推送通知 +{: #monitor-notifications} +上次更新时间：2017 年 1 月 16 日 +{: .last-updated} + + +IBM {{site.data.keyword.mobilepushshort}} 服务现已扩展了功能，可以通过用户数据生成图形，从而监视推送性能。您可以使用实用程序列出所有已发送的推送通知，或者列出所有已注册的设备，并以每天、每周或每月为基础来分析信息。 + +要为所有已发送的通知生成报告，请使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 中的“推送消息 GET”报告方法。 + +![已发送的通知报告](images/monitoring_messages.jpg) + + +要为所有已注册的设备生成报告，请使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 中的“推送设备注册 GET”报告方法。 + +![已注册的设备报告](images/monitoring_devices.jpg) + +有关如何更新 Android SDK 以监视通知信息的更多信息，请参阅[在 Android 设备上监视推送通知](c_android_enable.html#android_monitor)。 + + + diff --git a/services/mobilepush/nl/zh/CN/t_push_provider_android.md b/services/mobilepush/nl/zh/CN/t_push_provider_android.md index 09c2eeb07..6abe6febc 100644 --- a/services/mobilepush/nl/zh/CN/t_push_provider_android.md +++ b/services/mobilepush/nl/zh/CN/t_push_provider_android.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 为 FCM 配置凭证 -{: #create-push-enable-gcm} -上次更新时间：2017 年 1 月 16 日 -{: .last-updated} - -Firebase 云消息传递 (FCM) 是用于向 Android 设备和 Google Chrome 传递推送通知的网关。FCM 是 Google 云消息传递 (GCM) 的新版本。要在仪表板上设置 {{site.data.keyword.mobilepushshort}} 服务，您需要获取 FCM 凭证。请确保您为新应用程序使用 FCM 配置。现有应用程序将继续以 GCM 配置运作。 - -##获取发送方标识和 API 密钥 -{: #android-senderid-apikey} - -API 密钥以安全方式存储，并由 {{site.data.keyword.mobilepushshort}} 服务用于连接到 FCM 服务器，而发送方标识（项目编号）由客户机端的适用于 Google Chrome 和 Mozilla Firefox 的 Android SDK 和 JS SDK 使用。 - -要设置 FCM，产生 API 密钥和发送方标识，请完成以下步骤： - -1. 访问 [Firebase 控制台 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://console.firebase.google.com/?pli=1){: new_window}。 -2. 选择**创建新项目**。 -3. 在“创建项目”窗口中，提供项目名称，选择国家/地区并单击**创建项目**。 -3. 在导航窗格中，单击“设置”图标并选择**项目设置**。 -4. 选择“云消息传递”选项卡，以生成服务器 API 密钥和发送方标识。 - -##针对 Android 和 Chrome Apps and Extensions 设置 {{site.data.keyword.mobilepushshort}} 服务 -{: #setup-push-android} - -**注：**您将需要 FCM/GCM API 密钥和发送方标识（项目编号）。 - -1. 打开 Bluemix 仪表板，然后单击您创建的 {{site.data.keyword.mobilepushfull}} 服务实例，以打开仪表板。这将显示推送仪表板。要针对 Android 设置未绑定的 {{site.data.keyword.mobilepushshort}} 服务，请选择“未绑定 {{site.data.keyword.mobilepushshort}} 服务”图标，以打开 {{site.data.keyword.mobilepushshort}} 服务仪表板。 - -![推送仪表板](images/push_unbound.jpg) - -2. 单击**设置 Push** 按钮，以为 Android 应用程序和 Google Chrome Apps and Extensions 配置 FCM/GCM 凭证。 -3. 在**配置**页面上，对于 Android，转至**移动**选项卡，然后配置发送方标识（GCM 项目编号）和 API 密钥。对于 Google Chrome Apps and Extensions，转至 **Web** 选项卡，然后适当地配置发送方标识（FCM/GCM 项目编号）和 API 密钥。 -4. 单击**保存**。 -5. 后续步骤：[针对 Android 启用通知](c_enable_push.html)或[针对 Google Chrome Apps & Extensions 启用通知](c_enable_push.html)。 - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 为 FCM 配置凭证 +{: #create-push-enable-gcm} +上次更新时间：2017 年 1 月 16 日 +{: .last-updated} + +Firebase 云消息传递 (FCM) 是用于向 Android 设备和 Google Chrome 传递推送通知的网关。FCM 是 Google 云消息传递 (GCM) 的新版本。要在仪表板上设置 {{site.data.keyword.mobilepushshort}} 服务，您需要获取 FCM 凭证。请确保您为新应用程序使用 FCM 配置。现有应用程序将继续以 GCM 配置运作。 + +## 获取发送方标识和 API 密钥 +{: #android-senderid-apikey} + +API 密钥以安全方式存储，并由 {{site.data.keyword.mobilepushshort}} 服务用于连接到 FCM 服务器，而发送方标识（项目编号）由客户机端的适用于 Google Chrome 和 Mozilla Firefox 的 Android SDK 和 JS SDK 使用。 + +要设置 FCM，产生 API 密钥和发送方标识，请完成以下步骤： + +1. 访问 [Firebase 控制台 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://console.firebase.google.com/?pli=1){: new_window}。 +2. 选择**创建新项目**。 +3. 在“创建项目”窗口中，提供项目名称，选择国家/地区并单击**创建项目**。 +3. 在导航窗格中，单击“设置”图标并选择**项目设置**。 +4. 选择“云消息传递”选项卡，以生成服务器 API 密钥和发送方标识。 + +## 针对 Android 和 Chrome Apps and Extensions 设置 {{site.data.keyword.mobilepushshort}} 服务 +{: #setup-push-android} + +**注：**您将需要 FCM/GCM API 密钥和发送方标识（项目编号）。 + +1. 打开 Bluemix 仪表板，然后单击您创建的 {{site.data.keyword.mobilepushfull}} 服务实例，以打开仪表板。这将显示推送仪表板。要针对 Android 设置未绑定的 {{site.data.keyword.mobilepushshort}} 服务，请选择“未绑定 {{site.data.keyword.mobilepushshort}} 服务”图标，以打开 {{site.data.keyword.mobilepushshort}} 服务仪表板。 + +![推送仪表板](images/push_unbound.jpg) + +2. 单击**设置 Push** 按钮，以为 Android 应用程序和 Google Chrome Apps and Extensions 配置 FCM/GCM 凭证。 +3. 在**配置**页面上，对于 Android，转至**移动**选项卡，然后配置发送方标识（GCM 项目编号）和 API 密钥。对于 Google Chrome Apps and Extensions，转至 **Web** 选项卡，然后适当地配置发送方标识（FCM/GCM 项目编号）和 API 密钥。 +4. 单击**保存**。 +5. 后续步骤：[针对 Android 启用通知](c_enable_push.html)或[针对 Google Chrome Apps & Extensions 启用通知](c_enable_push.html)。 + + diff --git a/services/mobilepush/nl/zh/CN/t_push_provider_ios.md b/services/mobilepush/nl/zh/CN/t_push_provider_ios.md index 8226cd54a..45a4bc90c 100644 --- a/services/mobilepush/nl/zh/CN/t_push_provider_ios.md +++ b/services/mobilepush/nl/zh/CN/t_push_provider_ios.md @@ -1,146 +1,146 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 为 APNs 配置凭证 -{: #create-push-credentials-apns} -上次更新时间：2017 年 1 月 16 日 -{: .last-updated} - -通过 Apple 推送通知服务 (APNs)，应用程序开发者可以将远程通知从 Bluemix 上的 {{site.data.keyword.mobilepushshort}} 服务实例（提供者）发送到 iOS 设备和应用程序。消息会发送到设备上的目标应用程序。 - -您需要获取并配置您的 APNs 凭证。APNs 证书由 {{site.data.keyword.mobilepushshort}} 服务安全管理，在连接到 APNs 服务器（提供者）时需要使用该证书。 - - - - - - -##注册应用程序标识 -{: #create-push-credentials-apns-register} - - -应用程序标识（捆绑标识）是用于识别特定应用程序的唯一标识。每个应用程序都需要应用程序标识。像 {{site.data.keyword.mobilepushshort}} 服务这类的服务都是配置给应用程序标识的。 - -1. 请确保您具有 [Apple Developer ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com/){: new_window} 帐户。 -2. 转至 [Apple Developer ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com){: new_window} 门户网站，单击 **Member Center**，然后选择 **Certificates, Identifiers & Profiles**。 -3. 转至 [Apple Developer Library ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window} 中的 **Registering App IDs** 部分，然后遵循指示注册应用程序标识。 - -注册应用程序标识时，请选择以下选项： - -* Push Notifications -![应用程序服务](images/appID_appservices_enablepush.jpg) -* 显式标识后缀 -![显式标识](images/appID_bundleID.jpg) -4. 创建开发和分发 APNs SSL 证书。 - -##创建开发和分发 APNs SSL 证书 -{: #create-push-credentials-apns-ssl} - -在获取 APNs 证书之前，必须首先生成一个证书签名请求 (CSR)，然后将其提交给 Apple（认证中心 (CA)）。CSR 中包含您公司的标识信息，以及您用于签署 Apple 推送通知的公用密钥和专用密钥信息。然后，在 iOS 开发者门户网站上生成 SSL 证书。该证书与其公用密钥和专用密钥一起存储在“钥匙串访问”中。 - - - - - - -您可以在两种模式下使用 APN： - -* 用于开发和测试的沙箱模式。 -* 在 App Store（或其他企业分发机制）中分发应用程序时的生产模式。 - -必须分别针对开发环境和分发环境获取证书。证书与接收远程通知的应用程序的应用程序标识相关联。对于生产方式，最多可创建两个证书。Bluemix 使用证书与 APNs 建立 SSL 连接。 - - - -1. 转至 [Apple Developer ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com){: new_window} 网站，单击 **Member Center**，然后选择 **Certificates, Identifiers & Profiles**。 -2. 在 **Identifiers** 区域中，单击 **App IDs**。 -3. 在您的应用程序标识列表中，选择您新创建的应用程序标识，然后选择 **Settings**。 -4. 在 **Push Notifications** 区域中，创建开发 SSL 证书，然后创建生产 SSL 证书。 - - ![推送通知 SSL 证书](images/certificate_createssl.jpg) - -5. 在 **About Creating a Certificate Signing Request (CSR) screen** 显示时，启用 Mac 上的**钥匙串访问**应用程序以创建证书签名请求 (CSR)。 -6. 从菜单选择**钥匙串访问 > 证书助理 > 从证书颁发机构请求证书…** -7. 在**证书信息**中，输入与您的 App Developer 帐户相关联的电子邮件地址和常用名称。提供有意义的名称来帮助您识别此为开发（沙箱）证书还是分发（生产）证书；例如，*sandbox_apns_certificate* 或 *production_apns_certificate*。 -8. 选择**另存到磁盘**，以将 `.certSigningRequest` 文件下载到桌面，然后单击**继续**。 -9. 在**另存为**菜单选项中，对 `.certSigningRequest` 文件命名并单击**保存**。 -10. 单击**完成**。您现在就有一个 CSR 了。 -11. 返回 **About Creating a Certificate Siging Request (CSR)** 窗口并单击 **Continue**。 -12. 在 **Generate** 屏幕中，单击 **Choose File...**，选择保存在桌面上的 CSR 文件。然后，单击 **Generate**。 -![生成证书](images/generate_certificate.jpg) -13. 证书准备就绪后，单击 **Done**。 -14. 在 **Push Notifications** 屏幕中，单击 **Download** 以下载证书，然后单击 **Done**。 -![下载证书](images/certificate_download.jpg) -15. 在 Mac 上，转至**钥匙串访问 > 我的证书**，然后找到新安装的证书。双击该证书，以将其安装到“钥匙串访问”中。 -16. 选择证书和专用密钥，然后选择**导出**，以将证书转换成个人信息交换格式（`.p12` 格式）。 -![导出证书和密钥](images/keychain_export_key.jpg) -17. 在**存储为**字段中，为证书提供有意义的名称。例如，`sandbox_apns.p12_certifcate` 或 `production_apns.p12`，然后单击**保存**。 -![导出证书和密钥](images/certificate_p12v2.jpg) -18. 在**输入密码**字段中，输入用于保护导出项的密码，然后单击**确定**。您可以使用此密码，在“推送”仪表板上配置 APNs 设置。 -{: #step18} - ![导出证书和密钥](images/export_p12.jpg) -19. **Key Access.app** 会提示您从**密钥串**屏幕导出密钥。输入 Mac 的管理员密码，以允许系统导出这些项，然后选择**总是允许**选项。这将在桌面上生成一个 `.p12` 证书。 - - -##创建开发供应概要文件 -{: #create-push-credentials-dev-profile} - -供应概要文件与应用程序标识一起来确定哪些设备可以安装并运行您的应用程序，以及您的应用程序可以访问哪些服务。对于每个应用程序标识，都可创建两个供应概要文件：一个用于开发，另一个用于分发。Xcode 使用开发供应概要文件来确定允许哪些开发者构建应用程序，以及允许哪些设备在应用程序上进行测试。 - -请确保您已执行以下操作：注册应用程序标识，针对 {{site.data.keyword.mobilepushshort}} Service 启用该标识，然后将其配置为使用开发和生产 APNs SSL 证书。 - -创建开发供应概要文件，如下所示： - -1. 转至 [Apple Developer ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com){: new_window} 门户网站，单击 **Member Center**，然后选择 **Certificates, Identifiers & Profiles**。 -2. 转至 [Mac Developer Library ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}，滚动至 **Creating Development Provisioning Profiles** 部分，然后遵循指示创建开发概要文件。 -**注**：配置开发供应概要文件时，请选择以下选项： - * **iOS App Development** - * **对于 iOS 和 watchOS 应用程序** - - - -##创建应用商店分发供应概要文件 -{: #create-push-credentials-apns-distribute_profile} - -使用应用商店供应概要文件可提交应用程序以分发到 App Store。 - -1. 转至 [Apple Developer ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com){: new_window} 门户网站，单击 **Member Center**，然后选择 **Certificates, Identifiers & Profiles**。 -2. 双击所下载的供应概要文件，以将其安装到 Xcode 中。 - -##在 {{site.data.keyword.mobilepushshort}} 仪表板上设置 APNs -{: #create-push-credentials-apns-dashboard} - -要使用 {{site.data.keyword.mobilepushshort}} 服务发送通知，请上传 Apple 推送通知服务 (APNs) 所需的 SSL 证书。此外，也可以使用 REST API 来上传 APNs 证书。 - - - -APNs 所需的证书为 `.p12` 证书。这些证书包含构建和发布应用程序所需的专用密钥和 SSL 证书。您必须从 Apple Developer Web 站点的 Member Center 生成证书（此操作需要有效的 Apple Developer 帐户）。对于开发（沙箱）环境和生产（分发）环境，需要不同的证书。 - -**注**：当 `.cer` 文件出现在钥匙串访问中之后，请将其导出到您的计算机，以创建 `.p12` 证书。 - -有关使用 APN 的更多信息，请参阅 [iOS Developer Library: Local and Push Notification Programming Guide ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}。 - -要在“推送通知”服务仪表板上设置 APNs，请完成以下步骤： - -1. 在“推送通知”服务仪表板上选择**配置**。 -2. 选择**移动**选项，以更新 **APNs 推送凭证**表单上的信息。 -3. 根据需要选择**沙箱**（开发）或**生产**（分发），然后上传在先前[步骤](#step18)中创建的 `p.12` 证书。 -![设置推送通知仪表板](images/wizard.jpg) -3. 在**密码**字段中，输入与 `.p12` 证书文件相关联的密码，然后单击**保存**。 - -使用有效的密码成功上传证书后，即可开始发送通知。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 为 APNs 配置凭证 +{: #create-push-credentials-apns} +上次更新时间：2017 年 1 月 16 日 +{: .last-updated} + +通过 Apple 推送通知服务 (APNs)，应用程序开发者可以将远程通知从 Bluemix 上的 {{site.data.keyword.mobilepushshort}} 服务实例（提供者）发送到 iOS 设备和应用程序。消息会发送到设备上的目标应用程序。 + +您需要获取并配置您的 APNs 凭证。APNs 证书由 {{site.data.keyword.mobilepushshort}} 服务安全管理，在连接到 APNs 服务器（提供者）时需要使用该证书。 + + + + + + +## 注册应用程序标识 +{: #create-push-credentials-apns-register} + + +应用程序标识（捆绑标识）是用于识别特定应用程序的唯一标识。每个应用程序都需要应用程序标识。像 {{site.data.keyword.mobilepushshort}} 服务这类的服务都是配置给应用程序标识的。 + +1. 请确保您具有 [Apple Developer ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com/){: new_window} 帐户。 +2. 转至 [Apple Developer ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com){: new_window} 门户网站，单击 **Member Center**，然后选择 **Certificates, Identifiers & Profiles**。 +3. 转至 [Apple Developer Library ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window} 中的 **Registering App IDs** 部分，然后遵循指示注册应用程序标识。 + +注册应用程序标识时，请选择以下选项： + +* Push Notifications +![应用程序服务](images/appID_appservices_enablepush.jpg) +* 显式标识后缀 +![显式标识](images/appID_bundleID.jpg) +4. 创建开发和分发 APNs SSL 证书。 + +## 创建开发和分发 APNs SSL 证书 +{: #create-push-credentials-apns-ssl} + +在获取 APNs 证书之前，必须首先生成一个证书签名请求 (CSR)，然后将其提交给 Apple（认证中心 (CA)）。CSR 中包含您公司的标识信息，以及您用于签署 Apple 推送通知的公用密钥和专用密钥信息。然后，在 iOS 开发者门户网站上生成 SSL 证书。该证书与其公用密钥和专用密钥一起存储在“钥匙串访问”中。 + + + + + + +您可以在两种模式下使用 APN： + +* 用于开发和测试的沙箱模式。 +* 在 App Store（或其他企业分发机制）中分发应用程序时的生产模式。 + +必须分别针对开发环境和分发环境获取证书。证书与接收远程通知的应用程序的应用程序标识相关联。对于生产方式，最多可创建两个证书。Bluemix 使用证书与 APNs 建立 SSL 连接。 + + + +1. 转至 [Apple Developer ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com){: new_window} 网站，单击 **Member Center**，然后选择 **Certificates, Identifiers & Profiles**。 +2. 在 **Identifiers** 区域中，单击 **App IDs**。 +3. 在您的应用程序标识列表中，选择您新创建的应用程序标识，然后选择 **Settings**。 +4. 在 **Push Notifications** 区域中，创建开发 SSL 证书，然后创建生产 SSL 证书。 + + ![推送通知 SSL 证书](images/certificate_createssl.jpg) + +5. 在 **About Creating a Certificate Signing Request (CSR) screen** 显示时，启用 Mac 上的**钥匙串访问**应用程序以创建证书签名请求 (CSR)。 +6. 从菜单选择**钥匙串访问 > 证书助理 > 从证书颁发机构请求证书…** +7. 在**证书信息**中，输入与您的 App Developer 帐户相关联的电子邮件地址和常用名称。提供有意义的名称来帮助您识别此为开发（沙箱）证书还是分发（生产）证书；例如，*sandbox_apns_certificate* 或 *production_apns_certificate*。 +8. 选择**另存到磁盘**，以将 `.certSigningRequest` 文件下载到桌面，然后单击**继续**。 +9. 在**另存为**菜单选项中，对 `.certSigningRequest` 文件命名并单击**保存**。 +10. 单击**完成**。您现在就有一个 CSR 了。 +11. 返回 **About Creating a Certificate Siging Request (CSR)** 窗口并单击 **Continue**。 +12. 在 **Generate** 屏幕中，单击 **Choose File...**，选择保存在桌面上的 CSR 文件。然后，单击 **Generate**。 +![生成证书](images/generate_certificate.jpg) +13. 证书准备就绪后，单击 **Done**。 +14. 在 **Push Notifications** 屏幕中，单击 **Download** 以下载证书，然后单击 **Done**。 +![下载证书](images/certificate_download.jpg) +15. 在 Mac 上，转至**钥匙串访问 > 我的证书**，然后找到新安装的证书。双击该证书，以将其安装到“钥匙串访问”中。 +16. 选择证书和专用密钥，然后选择**导出**，以将证书转换成个人信息交换格式（`.p12` 格式）。 +![导出证书和密钥](images/keychain_export_key.jpg) +17. 在**存储为**字段中，为证书提供有意义的名称。例如，`sandbox_apns.p12_certifcate` 或 `production_apns.p12`，然后单击**保存**。 +![导出证书和密钥](images/certificate_p12v2.jpg) +18. 在**输入密码**字段中，输入用于保护导出项的密码，然后单击**确定**。您可以使用此密码，在“推送”仪表板上配置 APNs 设置。 +{: #step18} + ![导出证书和密钥](images/export_p12.jpg) +19. **Key Access.app** 会提示您从**密钥串**屏幕导出密钥。输入 Mac 的管理员密码，以允许系统导出这些项，然后选择**总是允许**选项。这将在桌面上生成一个 `.p12` 证书。 + + +## 创建开发供应概要文件 +{: #create-push-credentials-dev-profile} + +供应概要文件与应用程序标识一起来确定哪些设备可以安装并运行您的应用程序，以及您的应用程序可以访问哪些服务。对于每个应用程序标识，都可创建两个供应概要文件：一个用于开发，另一个用于分发。Xcode 使用开发供应概要文件来确定允许哪些开发者构建应用程序，以及允许哪些设备在应用程序上进行测试。 + +请确保您已执行以下操作：注册应用程序标识，针对 {{site.data.keyword.mobilepushshort}} Service 启用该标识，然后将其配置为使用开发和生产 APNs SSL 证书。 + +创建开发供应概要文件，如下所示： + +1. 转至 [Apple Developer ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com){: new_window} 门户网站，单击 **Member Center**，然后选择 **Certificates, Identifiers & Profiles**。 +2. 转至 [Mac Developer Library ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}，滚动至 **Creating Development Provisioning Profiles** 部分，然后遵循指示创建开发概要文件。 +**注**：配置开发供应概要文件时，请选择以下选项： + * **iOS App Development** + * **对于 iOS 和 watchOS 应用程序** + + + +## 创建应用商店分发供应概要文件 +{: #create-push-credentials-apns-distribute_profile} + +使用应用商店供应概要文件可提交应用程序以分发到 App Store。 + +1. 转至 [Apple Developer ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com){: new_window} 门户网站，单击 **Member Center**，然后选择 **Certificates, Identifiers & Profiles**。 +2. 双击所下载的供应概要文件，以将其安装到 Xcode 中。 + +## 在 {{site.data.keyword.mobilepushshort}} 仪表板上设置 APNs +{: #create-push-credentials-apns-dashboard} + +要使用 {{site.data.keyword.mobilepushshort}} 服务发送通知，请上传 Apple 推送通知服务 (APNs) 所需的 SSL 证书。此外，也可以使用 REST API 来上传 APNs 证书。 + + + +APNs 所需的证书为 `.p12` 证书。这些证书包含构建和发布应用程序所需的专用密钥和 SSL 证书。您必须从 Apple Developer Web 站点的 Member Center 生成证书（此操作需要有效的 Apple Developer 帐户）。对于开发（沙箱）环境和生产（分发）环境，需要不同的证书。 + +**注**：当 `.cer` 文件出现在钥匙串访问中之后，请将其导出到您的计算机，以创建 `.p12` 证书。 + +有关使用 APN 的更多信息，请参阅 [iOS Developer Library: Local and Push Notification Programming Guide ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}。 + +要在“推送通知”服务仪表板上设置 APNs，请完成以下步骤： + +1. 在“推送通知”服务仪表板上选择**配置**。 +2. 选择**移动**选项，以更新 **APNs 推送凭证**表单上的信息。 +3. 根据需要选择**沙箱**（开发）或**生产**（分发），然后上传在先前[步骤](#step18)中创建的 `p.12` 证书。 +![设置推送通知仪表板](images/wizard.jpg) +3. 在**密码**字段中，输入与 `.p12` 证书文件相关联的密码，然后单击**保存**。 + +使用有效的密码成功上传证书后，即可开始发送通知。 diff --git a/services/mobilepush/nl/zh/CN/t_push_provider_safari.md b/services/mobilepush/nl/zh/CN/t_push_provider_safari.md index 4823e6dc3..edbf62610 100644 --- a/services/mobilepush/nl/zh/CN/t_push_provider_safari.md +++ b/services/mobilepush/nl/zh/CN/t_push_provider_safari.md @@ -1,82 +1,82 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 配置 Web 浏览器的凭证 -{: #configure-credential-for-browsers} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - -IBM {{site.data.keyword.mobilepushshort}} 服务现已扩展了功能，可以向浏览器发送通知。 - -{{site.data.keyword.mobilepushshort}} 服务需要 Web 站点 URL 或 Web 站点的域名来识别需要允许的请求。{{site.data.keyword.mobilepushshort}} 服务实例一次仅支持一个域名。因此，确保针对 Chrome、Firefox 和 Safari 设置相同的值。 - -Chrome 和 Safari 浏览器需要针对 Web 推送进行额外的配置。您需要 FCM API 密钥，因为 FCM 端点用于在 Chrome 中传递消息。要获取 FCM API 密钥，请参阅[配置 FCM 的凭证](t_push_provider_android.html)。 - - - -##针对 Chrome 和 Firefox Web 推送进行配置 -{: #config-chrome-firefox} - -1. 在“推送仪表板”面板上，选择**配置**。 -2. 选择 Web 选项卡。![WebPush 配置](images/webpush_configure.jpg) -3. 配置 FCM/GCM API 密钥和将注册以接收推送通知的 Web 站点的 URL。 -4. 单击**保存**。 -5. 后续步骤：[为 Google Chrome 和 Mozilla Firefox 浏览器启用通知](c_enable_push.html)。 - - -## 针对 Safari Web 推送进行配置 -{: #configure-safari} - -在 Safari 上受支持的 {{site.data.keyword.mobilepushshort}} 服务是 10.0。您需要通过 Apple Developer 帐户生成证书，然后才能配置浏览器来接收通知。 - -### 生成证书 -{: #certificate-generation} - -确保您已拥有 Apple Developer 帐户。您需要注册 Web 站点推送标识，并生成证书，以配置您的 Safari 浏览器来接收通知。以下步骤将帮助您开始使用该功能。 - -1. 在 Apple Developer Member 中心，单击 **Certificates, ID & Profiles**。 -2. 单击 **Identifiers**，然后单击 **Website Push IDs**。 -3. 通过选择加号图标来创建新条目。![推送仪表板](images/safari_1.jpg) - -4. 在 Register Website Push ID 面板中，提供相应的 Web 站点推送标识描述和识别标识。建议使用反向域名格式，以“web”开头。例如：web.com.example.dailyweatherreports。 -5. 注册 Web 站点推送标识。您现在已有 Web 站点推送标识 -6. 选择**编辑**以创建要用于 Web 站点推送标识的证书。 -7. 在证书信息的“证书助理”窗口中，提供您的电子邮件标识和通用名称。将认证中心电子邮件地址保留为空白。 -8. 单击**保存到磁盘**并选择**继续**。 -9. 选择将证书保存到相应的文件夹。 -10. 向导中提示时选择在磁盘上创建的 `.certSigningRequest`，以生成证书。请确保您已下载以 `.cer` 格式创建的 Web 站点推送证书。 -11. 在“钥匙串访问”工具中打开证书。右键单击并导出为 p12 证书。记下在生成 p12 证书时提供的密码。 - - -### 为通知配置 - {: #configuration-notification} - -生成证书之后，您可以配置服务以将通知发送到 Safari。 - -完成以下步骤： - -1. 在 Push Notifications 服务仪表板中，单击**配置**。 -2. 选择 Web 选项卡。 -3. 在“Safari 推送”部分中，使用必要信息更新表单。 - - **Web 站点名称**：这是您在通知中心中提供的名称。 - - **Web 站点推送标识**：使用 Web 站点推送标识的反向域字符串进行更新。例如，web.com.example.www。 - - **Web 站点 URL**：提供应该预订到推送通知的 Web 站点 URL。例如，https://www.example.com。 - - **允许的域**：这是可选参数。这是需要用户提供许可权的 Web 站点列表。请确保 URL 是以逗号分隔的值。请注意，如果未提供此列表，那么将使用 Web 站点 URL 中的值。 - - **URL 格式字符串**：单击通知时解析的 URL。例如，["https://www.example.com"]。请确保 URL 使用 http 或 https 方案。 - - **Safari Web 推送证书**：上传 .p12 证书并提供密码。 -4. 单击**保存**。 - -![推送仪表板](images/push_configure_safari.jpg) - -现在，您已配置为将推送通知发送到 Safari 浏览器。 - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 配置 Web 浏览器的凭证 +{: #configure-credential-for-browsers} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + +IBM {{site.data.keyword.mobilepushshort}} 服务现已扩展了功能，可以向浏览器发送通知。 + +{{site.data.keyword.mobilepushshort}} 服务需要 Web 站点 URL 或 Web 站点的域名来识别需要允许的请求。{{site.data.keyword.mobilepushshort}} 服务实例一次仅支持一个域名。因此，确保针对 Chrome、Firefox 和 Safari 设置相同的值。 + +Chrome 和 Safari 浏览器需要针对 Web 推送进行额外的配置。您需要 FCM API 密钥，因为 FCM 端点用于在 Chrome 中传递消息。要获取 FCM API 密钥，请参阅[配置 FCM 的凭证](t_push_provider_android.html)。 + + + +##针对 Chrome 和 Firefox Web 推送进行配置 +{: #config-chrome-firefox} + +1. 在“推送仪表板”面板上，选择**配置**。 +2. 选择 Web 选项卡。![WebPush 配置](images/webpush_configure.jpg) +3. 配置 FCM/GCM API 密钥和将注册以接收推送通知的 Web 站点的 URL。 +4. 单击**保存**。 +5. 后续步骤：[为 Google Chrome 和 Mozilla Firefox 浏览器启用通知](c_enable_push.html)。 + + +## 针对 Safari Web 推送进行配置 +{: #configure-safari} + +在 Safari 上受支持的 {{site.data.keyword.mobilepushshort}} 服务是 10.0。您需要通过 Apple Developer 帐户生成证书，然后才能配置浏览器来接收通知。 + +### 生成证书 +{: #certificate-generation} + +确保您已拥有 Apple Developer 帐户。您需要注册 Web 站点推送标识，并生成证书，以配置您的 Safari 浏览器来接收通知。以下步骤将帮助您开始使用该功能。 + +1. 在 Apple Developer Member 中心，单击 **Certificates, ID & Profiles**。 +2. 单击 **Identifiers**，然后单击 **Website Push IDs**。 +3. 通过选择加号图标来创建新条目。![推送仪表板](images/safari_1.jpg) + +4. 在 Register Website Push ID 面板中，提供相应的 Web 站点推送标识描述和识别标识。建议使用反向域名格式，以“web”开头。例如：web.com.example.dailyweatherreports。 +5. 注册 Web 站点推送标识。您现在已有 Web 站点推送标识 +6. 选择**编辑**以创建要用于 Web 站点推送标识的证书。 +7. 在证书信息的“证书助理”窗口中，提供您的电子邮件标识和通用名称。将认证中心电子邮件地址保留为空白。 +8. 单击**保存到磁盘**并选择**继续**。 +9. 选择将证书保存到相应的文件夹。 +10. 向导中提示时选择在磁盘上创建的 `.certSigningRequest`，以生成证书。请确保您已下载以 `.cer` 格式创建的 Web 站点推送证书。 +11. 在“钥匙串访问”工具中打开证书。右键单击并导出为 p12 证书。记下在生成 p12 证书时提供的密码。 + + +### 为通知配置 + {: #configuration-notification} + +生成证书之后，您可以配置服务以将通知发送到 Safari。 + +完成以下步骤： + +1. 在 Push Notifications 服务仪表板中，单击**配置**。 +2. 选择 Web 选项卡。 +3. 在“Safari 推送”部分中，使用必要信息更新表单。 + - **Web 站点名称**：这是您在通知中心中提供的名称。 + - **Web 站点推送标识**：使用 Web 站点推送标识的反向域字符串进行更新。例如，web.com.example.www。 + - **Web 站点 URL**：提供应该预订到推送通知的 Web 站点 URL。例如，https://www.example.com。 + - **允许的域**：这是可选参数。这是需要用户提供许可权的 Web 站点列表。请确保 URL 是以逗号分隔的值。请注意，如果未提供此列表，那么将使用 Web 站点 URL 中的值。 + - **URL 格式字符串**：单击通知时解析的 URL。例如，["https://www.example.com"]。请确保 URL 使用 http 或 https 方案。 + - **Safari Web 推送证书**：上传 .p12 证书并提供密码。 +4. 单击**保存**。 + +![推送仪表板](images/push_configure_safari.jpg) + +现在，您已配置为将推送通知发送到 Safari 浏览器。 + + diff --git a/services/mobilepush/nl/zh/CN/t_push_tagsmain.md b/services/mobilepush/nl/zh/CN/t_push_tagsmain.md index e0a497c68..848a5addb 100644 --- a/services/mobilepush/nl/zh/CN/t_push_tagsmain.md +++ b/services/mobilepush/nl/zh/CN/t_push_tagsmain.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 基于标记的通知 -{: #push-ios-main-tags} -上次更新时间：2017 年 1 月 16 日 -{: .last-updated} - -基于标记的通知消息针对预订了特定标记的所有设备。您可以定义标记，然后使用标记发送和接收消息。 - -必须首先为应用程序创建标记，设置标记预订，然后再启动基于标记的通知。要使用 [REST API ![外部链接图](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} 发送基于标记的通知，请确保发布到消息资源时提供了“tagNames”。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 基于标记的通知 +{: #push-ios-main-tags} +上次更新时间：2017 年 1 月 16 日 +{: .last-updated} + +基于标记的通知消息针对预订了特定标记的所有设备。您可以定义标记，然后使用标记发送和接收消息。 + +必须首先为应用程序创建标记，设置标记预订，然后再启动基于标记的通知。要使用 [REST API ![外部链接图](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} 发送基于标记的通知，请确保发布到消息资源时提供了“tagNames”。 diff --git a/services/mobilepush/nl/zh/CN/t_restapi.md b/services/mobilepush/nl/zh/CN/t_restapi.md index b80a11327..19b248eda 100644 --- a/services/mobilepush/nl/zh/CN/t_restapi.md +++ b/services/mobilepush/nl/zh/CN/t_restapi.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 使用 REST API -{: #push-api-rest} -上次更新时间：2017 年 1 月 16 日 -{: .last-updated} - -您可以将 REST（具象状态传输）API（应用程序编程接口）用于 {{site.data.keyword.mobilepushshort}}。您还可以使用 SDK 和 [Push API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} 来进一步开发您的客户机应用程序。 - -通过 Push REST API，后端服务器应用程序和客户机可以访问 {{site.data.keyword.mobilepushshort}} 功能。 - -- 设备注册 -- 注册 -- 消息 -- 预订 -- 标记 -- Webhook - -要获取 REST API 的基本 URL，请完成以下步骤： - -1. 通过选择 MobileFirst Services Starter，在 Bluemix®“目录”的“样板”部分中创建后端应用程序。这可将 {{site.data.keyword.mobilepushshort}} 服务绑定到应用程序。您还可以创建 Push 的服务实例，并保留其为未绑定状态。 -1. 在 Bluemix“仪表板”的主页中，转至**应用程序**区域，然后选择您的应用程序。 -3. 单击**移动选项**。路径和应用程序 GUID 值会显示在应用程序的详细信息页面顶部。“显示凭证”屏幕将显示有关 appSecret 的信息。您可以从“移动选项”获取应用程序私钥，也可以获取一些 API 的客户机私钥。 - -您还可以使用命令行来获取服务凭证： - -``` - cf create-service-key {push_instance_name} {key_name} - - cf service-key {push_instance_name} {key_name} -``` - {: codeblock} - -## 接受语言头 -{: #push-api-rest-accept} - -“Accept-Language”头指定要将哪种语言用于 [Push REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} 输出的错误消息。支持的错误消息语言如下：简体中文、繁体中文、英语（美国）、德语、法语、意大利语、日语、韩语、葡萄牙语和西班牙语。 - -## appSecret -{: #push-api-rest-secret} - -应用程序绑定到 {{site.data.keyword.mobilepushshort}} 后，该服务会生成一个 appSecret（唯一密钥），并会在响应头中传递该密钥。如果是使用 IBM {{site.data.keyword.mobilepushshort}} for Bluemix Rest API，请参阅 REST API 参考来获取有关需要保护哪些 API 的信息。有关更多信息，请参阅 [Push REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window}。 - -请求头必须包含 appSecret。如果不包含，服务器会返回“401 未授权”错误代码。将 {{site.data.keyword.mobilepushshort}} 添加到应用程序时，会创建特定的 AppID。作为响应的一部分，您会获取名为 appSecret 的头，其用于创建标记或发送消息。通过目录或样板中的服务，可执行该操作。 - -要获取 appSecret 值，请执行以下操作： - -1. 单击绑定到推送服务的 *app-name*。 -2. 单击**显示凭证**链接以显示 appSecret (AppID)。 - -**显示凭证**屏幕将显示有关 appSecret 的信息： -``` - { - "imfpush_Dev": [ - { - "name": "testapp1", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": { - "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", - "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", - "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", - } - } - ] - } -``` - {: codeblock} - - -##Push REST API 过滤器 -{: #push-api-rest-filters} - -过滤器定义搜索条件，该条件用于限制从 {{site.data.keyword.mobilepushshort}} 的 GET API 返回的数据。针对要过滤的 GET 操作结果应用过滤器。过滤器会限制结果中包含的条目数。例如，可以使用过滤器来搜索以“test”开头的标记。 - -使用以下语法，可生成过滤器： - -**名称**：应用过滤器的字段名称。 - -**运算符**：可以为 ==（完全匹配）或 =@（包含子字符串），用于描述要使用的过滤匹配。 - -**表达式**：要包含在结果中的值。 - -如果表达式中出现逗号和反斜杠，必须用反斜杠将它们转义。 - -使用多个过滤器时，可以使用 AND 和 OR 逻辑来组合这些过滤器。 - -- 对于 AND 逻辑，在查询中使用多个过滤器。 -- 对于 OR 逻辑，在过滤表达式内部使用逗号 (,)。 -- 对于 AND 和 OR 逻辑，单个查询可以同时包含 AND 和 OR 逻辑。使用 AND 表达式组合多个过滤器时，会先对每个过滤器单独求值，然后再执行 AND 运算。 - -对于设备 GET API，将支持以下组合： --名称为 platform 字段。 -- 运算符可以为 == 或 =@，但 platform 除外 -- 对于 platform，运算符必须是 ==。如果使用运算符 =@，那么值可以为子字符串。 -- 如果使用 ==，那么值必须为完全匹配的字符串。 - -对于预订 GET API，将支持以下组合： - -- 名称可以是以下某个字段：tagName 或 deviceId -- 运算符可以为 == 或 =@，但 platform 除外 -- 对于 platform，运算符必须是 == -- 如果使用 =@ 运算符，那么值可以为子字符串。如果使用 == 运算符，那么值必须为完全匹配的字符串。 -- 对于标记 GET API，将支持以下组合： -- 名称可以是以下某个字段：“name”或“description” -- 如果使用运算符 =@，那么值可以为子字符串。 -- 如果使用 ==，那么值必须为完全匹配的字符串。 - - -##{{site.data.keyword.mobilepushshort}} 响应代码 -{: #push-api-response-codes} - -状态：405 不允许的方法 - 应使用适当的方法。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 使用 REST API +{: #push-api-rest} +上次更新时间：2017 年 1 月 16 日 +{: .last-updated} + +您可以将 REST（具象状态传输）API（应用程序编程接口）用于 {{site.data.keyword.mobilepushshort}}。您还可以使用 SDK 和 [Push API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} 来进一步开发您的客户机应用程序。 + +通过 Push REST API，后端服务器应用程序和客户机可以访问 {{site.data.keyword.mobilepushshort}} 功能。 + +- 设备注册 +- 注册 +- 消息 +- 预订 +- 标记 +- Webhook + +要获取 REST API 的基本 URL，请完成以下步骤： + +1. 通过选择 MobileFirst Services Starter，在 Bluemix®“目录”的“样板”部分中创建后端应用程序。这可将 {{site.data.keyword.mobilepushshort}} 服务绑定到应用程序。您还可以创建 Push 的服务实例，并保留其为未绑定状态。 +1. 在 Bluemix“仪表板”的主页中，转至**应用程序**区域，然后选择您的应用程序。 +3. 单击**移动选项**。路径和应用程序 GUID 值会显示在应用程序的详细信息页面顶部。“显示凭证”屏幕将显示有关 appSecret 的信息。您可以从“移动选项”获取应用程序私钥，也可以获取一些 API 的客户机私钥。 + +您还可以使用命令行来获取服务凭证： + +``` + cf create-service-key {push_instance_name} {key_name} + + cf service-key {push_instance_name} {key_name} +``` + {: codeblock} + +## 接受语言头 +{: #push-api-rest-accept} + +“Accept-Language”头指定要将哪种语言用于 [Push REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window} 输出的错误消息。支持的错误消息语言如下：简体中文、繁体中文、英语（美国）、德语、法语、意大利语、日语、韩语、葡萄牙语和西班牙语。 + +## appSecret +{: #push-api-rest-secret} + +应用程序绑定到 {{site.data.keyword.mobilepushshort}} 后，该服务会生成一个 appSecret（唯一密钥），并会在响应头中传递该密钥。如果是使用 IBM {{site.data.keyword.mobilepushshort}} for Bluemix Rest API，请参阅 REST API 参考来获取有关需要保护哪些 API 的信息。有关更多信息，请参阅 [Push REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window}。 + +请求头必须包含 appSecret。如果不包含，服务器会返回“401 未授权”错误代码。将 {{site.data.keyword.mobilepushshort}} 添加到应用程序时，会创建特定的 AppID。作为响应的一部分，您会获取名为 appSecret 的头，其用于创建标记或发送消息。通过目录或样板中的服务，可执行该操作。 + +要获取 appSecret 值，请执行以下操作： + +1. 单击绑定到推送服务的 *app-name*。 +2. 单击**显示凭证**链接以显示 appSecret (AppID)。 + +**显示凭证**屏幕将显示有关 appSecret 的信息： +``` + { + "imfpush_Dev": [ + { + "name": "testapp1", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": { + "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", + "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", + "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", + } + } + ] + } +``` + {: codeblock} + + +## Push REST API 过滤器 +{: #push-api-rest-filters} + +过滤器定义搜索条件，该条件用于限制从 {{site.data.keyword.mobilepushshort}} 的 GET API 返回的数据。针对要过滤的 GET 操作结果应用过滤器。过滤器会限制结果中包含的条目数。例如，可以使用过滤器来搜索以“test”开头的标记。 + +使用以下语法，可生成过滤器： + +**名称**：应用过滤器的字段名称。 + +**运算符**：可以为 ==（完全匹配）或 =@（包含子字符串），用于描述要使用的过滤匹配。 + +**表达式**：要包含在结果中的值。 + +如果表达式中出现逗号和反斜杠，必须用反斜杠将它们转义。 + +使用多个过滤器时，可以使用 AND 和 OR 逻辑来组合这些过滤器。 + +- 对于 AND 逻辑，在查询中使用多个过滤器。 +- 对于 OR 逻辑，在过滤表达式内部使用逗号 (,)。 +- 对于 AND 和 OR 逻辑，单个查询可以同时包含 AND 和 OR 逻辑。使用 AND 表达式组合多个过滤器时，会先对每个过滤器单独求值，然后再执行 AND 运算。 + +对于设备 GET API，将支持以下组合： +-名称为 platform 字段。 +- 运算符可以为 == 或 =@，但 platform 除外 +- 对于 platform，运算符必须是 ==。如果使用运算符 =@，那么值可以为子字符串。 +- 如果使用 ==，那么值必须为完全匹配的字符串。 + +对于预订 GET API，将支持以下组合： + +- 名称可以是以下某个字段：tagName 或 deviceId +- 运算符可以为 == 或 =@，但 platform 除外 +- 对于 platform，运算符必须是 == +- 如果使用 =@ 运算符，那么值可以为子字符串。如果使用 == 运算符，那么值必须为完全匹配的字符串。 +- 对于标记 GET API，将支持以下组合： +- 名称可以是以下某个字段：“name”或“description” +- 如果使用运算符 =@，那么值可以为子字符串。 +- 如果使用 ==，那么值必须为完全匹配的字符串。 + + +## {{site.data.keyword.mobilepushshort}} 响应代码 +{: #push-api-response-codes} + +状态：405 不允许的方法 - 应使用适当的方法。 diff --git a/services/mobilepush/nl/zh/CN/t_sandbox.md b/services/mobilepush/nl/zh/CN/t_sandbox.md index 47405abff..a9b2d985b 100644 --- a/services/mobilepush/nl/zh/CN/t_sandbox.md +++ b/services/mobilepush/nl/zh/CN/t_sandbox.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 沙箱和生产方式 -{: #push-sandboxandproduction-modes} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - -您可以通过以下任何一种方式来使用 {{site.data.keyword.mobilepushshort}}：沙箱或生产。沙箱是独立的测试环境，用于开发和测试 Push API 与服务器应用程序推送服务的集成。 - -使用“推送”仪表板配置沙箱和生产方式。您可以使用 [Push REST API](https://mobile.{DomainName}/imfpush/){: new_window} 将推送服务操作方式在沙箱和生产之间进行切换。缺省情况下，会启用沙箱方式。但是，在两种方式之间切换时，标记、设备和预订不会在这两种方式之间共享。 - -如果已准备好将应用程序部署到现场环境，请使用 [Push REST API](https://mobile.{DomainName}/imfpush/){: new_window} 选择生产方式。 - -要将推送服务操作方式从沙箱切换到生产，请执行以下操作： - -1. 使用 PUT ApplicationID 设置 REST API 调用 -2. 在 JSON 主体中，确认是否已使用 [GET ApplicationID 设置 REST](https://mobile.{DomainName}/imfpush/){: new_window} API 调用切换了该方式。响应应该为 "mode": "PRODUCTION" -```{ - "mode": "PRODUCTION" - } - ``` - {: codeblock} -1. 切换环境方式后，重新运行客户机代码来以生产方式注册设备。 - -有关 REST API 的信息，请参阅[使用 REST API](t_restapi.html)。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 沙箱和生产方式 +{: #push-sandboxandproduction-modes} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + +您可以通过以下任何一种方式来使用 {{site.data.keyword.mobilepushshort}}：沙箱或生产。沙箱是独立的测试环境，用于开发和测试 Push API 与服务器应用程序推送服务的集成。 + +使用“推送”仪表板配置沙箱和生产方式。您可以使用 [Push REST API](https://mobile.{DomainName}/imfpush/){: new_window} 将推送服务操作方式在沙箱和生产之间进行切换。缺省情况下，会启用沙箱方式。但是，在两种方式之间切换时，标记、设备和预订不会在这两种方式之间共享。 + +如果已准备好将应用程序部署到现场环境，请使用 [Push REST API](https://mobile.{DomainName}/imfpush/){: new_window} 选择生产方式。 + +要将推送服务操作方式从沙箱切换到生产，请执行以下操作： + +1. 使用 PUT ApplicationID 设置 REST API 调用 +2. 在 JSON 主体中，确认是否已使用 [GET ApplicationID 设置 REST](https://mobile.{DomainName}/imfpush/){: new_window} API 调用切换了该方式。响应应该为 "mode": "PRODUCTION" +```{ + "mode": "PRODUCTION" + } + ``` + {: codeblock} +1. 切换环境方式后，重新运行客户机代码来以生产方式注册设备。 + +有关 REST API 的信息，请参阅[使用 REST API](t_restapi.html)。 diff --git a/services/mobilepush/nl/zh/CN/t_send_push_notifications.md b/services/mobilepush/nl/zh/CN/t_send_push_notifications.md index 12e638bcb..1087fd244 100644 --- a/services/mobilepush/nl/zh/CN/t_send_push_notifications.md +++ b/services/mobilepush/nl/zh/CN/t_send_push_notifications.md @@ -1,39 +1,39 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 发送基本推送通知 -{: #push-send-notifications} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - -开发应用程序后，可以发送基本推送通知（不使用标记、角标、其他有效内容或声音文件）。 - -要发送基本推送通知，请完成所列步骤： - -1. 选择**发送通知**，然后选择相应的**发送至**选项。 - -**注**：选择**所有设备**选项时，预订了 {{site.data.keyword.mobilepushshort}} 的所有设备都会收到通知。 - -![“通知”屏幕](images/tag_notification.jpg) -2. 在**消息**字段中，输入消息然后单击**发送**。 - -3. 验证设备是否收到通知。下图显示了在 Android 和 iOS 设备上前台处理 {{site.data.keyword.mobilepushshort}} 的警报框。 - - -![Android 上的前台推送通知](images/Android_Screenshot.jpg) - -![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) - -以下屏幕快照显示了 Android 后台的 {{site.data.keyword.mobilepushshort}}。 - - - ![Android 上的后台推送通知](images/background.jpg) +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 发送基本推送通知 +{: #push-send-notifications} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + +开发应用程序后，可以发送基本推送通知（不使用标记、角标、其他有效内容或声音文件）。 + +要发送基本推送通知，请完成所列步骤： + +1. 选择**发送通知**，然后选择相应的**发送至**选项。 + +**注**：选择**所有设备**选项时，预订了 {{site.data.keyword.mobilepushshort}} 的所有设备都会收到通知。 + +![“通知”屏幕](images/tag_notification.jpg) +2. 在**消息**字段中，输入消息然后单击**发送**。 + +3. 验证设备是否收到通知。下图显示了在 Android 和 iOS 设备上前台处理 {{site.data.keyword.mobilepushshort}} 的警报框。 + + +![Android 上的前台推送通知](images/Android_Screenshot.jpg) + +![iOS 上的前台推送通知](images/iOS_Screenshot.jpg) + +以下屏幕快照显示了 Android 后台的 {{site.data.keyword.mobilepushshort}}。 + + + ![Android 上的后台推送通知](images/background.jpg) diff --git a/services/mobilepush/nl/zh/CN/t_service_instance.md b/services/mobilepush/nl/zh/CN/t_service_instance.md index e743f0dad..6b7ede4a7 100644 --- a/services/mobilepush/nl/zh/CN/t_service_instance.md +++ b/services/mobilepush/nl/zh/CN/t_service_instance.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 创建 Push 服务实例 -{: #create-push-instance} - -要开始使用 {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}，首先应创建 {{site.data.keyword.Bluemix}} 应用程序；例如，Node.js 应用程序。然后，创建 Push 服务 {{site.data.keyword.mobilepushfull}} 的实例，该实例需要绑定到此 Bluemix 应用程序。此外，也可以转至 Bluemix“目录”的“样板”部分，然后单击 MobileFirst Services Starter 来执行此操作。 - -**注**：如果已配置组织来管理您的环境，请选择要在其中为移动应用程序创建运行时和服务的组织。 - - -1. 如果没有 Bluemix 应用程序，那么需要创建 Bluemix 应用程序；例如，Node.js 应用程序。要创建 Bluemix 应用程序，请转至 Bluemix“仪表板”，然后单击**创建应用程序**。 - - **注**：如果已有应用程序，请转至步骤 7 来添加服务。![创建服务实例](images/create_service_instance1.jpg "创建服务实例") - -1. 在**选择应用程序模板**中，单击 **WEB**。 - -3. 在**选择起点**区域中，选择 **SDK for Node.js**，然后单击**继续**。![起点](images/create_service_nodejs2.jpg) - -4. 在**空间**下拉菜单中，选择组织空间。 - - ![ -选择组织空间](images/create_a_service3.jpg) -1. 在**名称**中，输入应用程序的名称。在“主机”中，输入主机的名称。 - -1. 在**所选套餐**下拉菜单中，选择套餐，然后单击**创建**按钮。等待应用程序编译打包。 - -1. 单击**概述**链接。![添加服务](images/create_service_add4.jpg) -1. 单击**添加服务**。这将显示“目录”屏幕。 - -1. 选择 **IBM Push Notifications：**，然后从**空间**下拉菜单中，选择您的组织。 - - ![组织空间下拉菜单](images/create_service_org.jpg) -1. 在**服务名称**中，输入 Push Notification Service 名称。 - -1. 在**所选套餐**中，选择套餐，然后单击**创建**按钮。 - -1. 单击**是**，以重新编译打包应用程序。 - - ![IBM Push Notification 服务](images/create_service_notification5.jpg) - -1. 单击**推送通知**，以显示“推送通知”仪表板。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 创建 Push 服务实例 +{: #create-push-instance} + +要开始使用 {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}，首先应创建 {{site.data.keyword.Bluemix}} 应用程序；例如，Node.js 应用程序。然后，创建 Push 服务 {{site.data.keyword.mobilepushfull}} 的实例，该实例需要绑定到此 Bluemix 应用程序。此外，也可以转至 Bluemix“目录”的“样板”部分，然后单击 MobileFirst Services Starter 来执行此操作。 + +**注**：如果已配置组织来管理您的环境，请选择要在其中为移动应用程序创建运行时和服务的组织。 + + +1. 如果没有 Bluemix 应用程序，那么需要创建 Bluemix 应用程序；例如，Node.js 应用程序。要创建 Bluemix 应用程序，请转至 Bluemix“仪表板”，然后单击**创建应用程序**。 + + **注**：如果已有应用程序，请转至步骤 7 来添加服务。![创建服务实例](images/create_service_instance1.jpg "创建服务实例") + +1. 在**选择应用程序模板**中，单击 **WEB**。 + +3. 在**选择起点**区域中，选择 **SDK for Node.js**，然后单击**继续**。![起点](images/create_service_nodejs2.jpg) + +4. 在**空间**下拉菜单中，选择组织空间。 + + ![ +选择组织空间](images/create_a_service3.jpg) +1. 在**名称**中，输入应用程序的名称。在“主机”中，输入主机的名称。 + +1. 在**所选套餐**下拉菜单中，选择套餐，然后单击**创建**按钮。等待应用程序编译打包。 + +1. 单击**概述**链接。![添加服务](images/create_service_add4.jpg) +1. 单击**添加服务**。这将显示“目录”屏幕。 + +1. 选择 **IBM Push Notifications：**，然后从**空间**下拉菜单中，选择您的组织。 + + ![组织空间下拉菜单](images/create_service_org.jpg) +1. 在**服务名称**中，输入 Push Notification Service 名称。 + +1. 在**所选套餐**中，选择套餐，然后单击**创建**按钮。 + +1. 单击**是**，以重新编译打包应用程序。 + + ![IBM Push Notification 服务](images/create_service_notification5.jpg) + +1. 单击**推送通知**，以显示“推送通知”仪表板。 diff --git a/services/mobilepush/nl/zh/CN/t_subscribe_tags.md b/services/mobilepush/nl/zh/CN/t_subscribe_tags.md index 48908a74f..f8f8bc33f 100644 --- a/services/mobilepush/nl/zh/CN/t_subscribe_tags.md +++ b/services/mobilepush/nl/zh/CN/t_subscribe_tags.md @@ -1,125 +1,125 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 预订和取消预订标记 -{: #Subscribe_tags} - -使用以下代码片段可允许设备获取预订、预订某个标记以及取消预订某个标记。 - -## Android - -将以下代码片段复制并粘贴到 Android 移动应用程序中。 - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { -@Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - -## Cordova - -将以下代码片段复制并粘贴到 Cordova 移动应用程序中。 - -``` -var tag = "YourTag"; -MFPPush.subscribe(tag, success, failure); -MFPPush.unsubscribe(tag, success, failure); -``` - -## Objective-C - -将以下代码片段复制并粘贴到 Objective-C 移动应用程序中。 - -使用 **subscribeToTags** API，可以预订标记。 - -``` -[push subscribeToTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - }else{ - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response subscribeStatus]; - [self updateMessage:@"Parsed subscribe status is:"]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -使用 **unsubscribeFromTags** API，可以取消预订标记。 - -``` -[push unsubscribeFromTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if (error){ - [self updateMessage:error.description]; - } else { - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response unsubscribeStatus]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -## Swift - -将以下代码片段复制并粘贴到 Swift 移动应用程序中。 - -**预订可用标记** - -使用 **subscribeToTags** API，可以预订标记。 - -``` -push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in - if (error != nil) { - //error while subscribing to tags - } else { - //successfully subscribed to tags var subStatus = response.subscribeStatus(); - } -} -``` - -**取消预订标记** - -使用 **unsubscribeFromTags** API，可以取消预订标记。 - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void inif error.isEmpty { - print( "Response during unsubscribed tags : \(response.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else - { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# 预订和取消预订标记 +{: #Subscribe_tags} + +使用以下代码片段可允许设备获取预订、预订某个标记以及取消预订某个标记。 + +## Android + +将以下代码片段复制并粘贴到 Android 移动应用程序中。 + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { +@Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + +## Cordova + +将以下代码片段复制并粘贴到 Cordova 移动应用程序中。 + +``` +var tag = "YourTag"; +MFPPush.subscribe(tag, success, failure); +MFPPush.unsubscribe(tag, success, failure); +``` + +## Objective-C + +将以下代码片段复制并粘贴到 Objective-C 移动应用程序中。 + +使用 **subscribeToTags** API，可以预订标记。 + +``` +[push subscribeToTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + }else{ + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response subscribeStatus]; + [self updateMessage:@"Parsed subscribe status is:"]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +使用 **unsubscribeFromTags** API，可以取消预订标记。 + +``` +[push unsubscribeFromTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if (error){ + [self updateMessage:error.description]; + } else { + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response unsubscribeStatus]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +## Swift + +将以下代码片段复制并粘贴到 Swift 移动应用程序中。 + +**预订可用标记** + +使用 **subscribeToTags** API，可以预订标记。 + +``` +push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in + if (error != nil) { + //error while subscribing to tags + } else { + //successfully subscribed to tags var subStatus = response.subscribeStatus(); + } +} +``` + +**取消预订标记** + +使用 **unsubscribeFromTags** API，可以取消预订标记。 + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void inif error.isEmpty { + print( "Response during unsubscribed tags : \(response.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else + { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` diff --git a/services/mobilepush/nl/zh/CN/t_use_tags.md b/services/mobilepush/nl/zh/CN/t_use_tags.md index 67c7bde16..27f135cc4 100644 --- a/services/mobilepush/nl/zh/CN/t_use_tags.md +++ b/services/mobilepush/nl/zh/CN/t_use_tags.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 使用基于标记的通知 -{: #using_tags} - - -基于标记的通知是针对预订了特定标记的所有设备的通知消息。每个设备都可以预订任意数量的标记。本部分描述了如何发送基于标记的通知。预订通过 Push Notification Service Bluemix 实例进行维护。删除标记时，与该标记关联的所有信息（包括其订户和设备）都会一并删除。无需对此标记自动取消预订，因为此标记不再存在，因此也不需要从客户机端执行进一步的操作。 - -**开始之前** - -在**标记**屏幕上创建标记。有关如何创建标记的信息，请参阅[创建标记](t_manage_tags.html)。 - -1. 在**推送通知**仪表板中，单击**通知**选项卡。 -1. 选择**标记**选项，以发送基于标记的通知。 -1. 在**搜索标记**字段中，搜索要使用的标记，然后单击 **+添加**按钮。![“通知”屏幕](images/tag_notification.jpg) -1. 转至**创建通知**区域，然后在**消息文本**字段中输入要在通知中发送的文本。 -1. 单击**发送**按钮。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 使用基于标记的通知 +{: #using_tags} + + +基于标记的通知是针对预订了特定标记的所有设备的通知消息。每个设备都可以预订任意数量的标记。本部分描述了如何发送基于标记的通知。预订通过 Push Notification Service Bluemix 实例进行维护。删除标记时，与该标记关联的所有信息（包括其订户和设备）都会一并删除。无需对此标记自动取消预订，因为此标记不再存在，因此也不需要从客户机端执行进一步的操作。 + +**开始之前** + +在**标记**屏幕上创建标记。有关如何创建标记的信息，请参阅[创建标记](t_manage_tags.html)。 + +1. 在**推送通知**仪表板中，单击**通知**选项卡。 +1. 选择**标记**选项，以发送基于标记的通知。 +1. 在**搜索标记**字段中，搜索要使用的标记，然后单击 **+添加**按钮。![“通知”屏幕](images/tag_notification.jpg) +1. 转至**创建通知**区域，然后在**消息文本**字段中输入要在通知中发送的文本。 +1. 单击**发送**按钮。 diff --git a/services/mobilepush/nl/zh/CN/tr_error_push.md b/services/mobilepush/nl/zh/CN/tr_error_push.md index 090645301..c86a1468d 100644 --- a/services/mobilepush/nl/zh/CN/tr_error_push.md +++ b/services/mobilepush/nl/zh/CN/tr_error_push.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}} 服务错误消息 -{: #errors} -上次更新时间：2017 年 2 月 13 日 -{: .last-updated} - - -在响应 REST API 请求时，会返回以下 {{site.data.keyword.mobilepushshort}} 错误消息。 - -样本错误响应： -``` - { - "message": "Missing APNs credentials", - "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", - "code": "FPWSE0003E" - -} -``` - {: codeblock} - -要获取有关错误的更多信息，请在文档中搜索相关错误代码。 - -## FPWSE0001E -{: #error_fpwse0001e} - -**说明**：服务器上没有您尝试查询的资源，例如标记或预订。 - -**用户响应**：请创建在消息中报告的资源。或者，您可以提供正确的标识来查询该资源。 - - -## FPWSE0002E -{: #error_fpwse0002e} - -**说明**：服务器上已存在您尝试创建的资源。资源可以是标记、预订等。 - -**用户响应**：请使用其他标识来创建该资源。 - - -## FPWSE0003E -{: #error_fpwse0003e} - -**说明**：{{site.data.keyword.mobilepushshort}} 服务的必备配置不完整。可能是您在尝试获取 Apple 推送通知服务 (APNs) 凭证，但凭证尚未配置。 - -**用户响应**：请确保已使用有效的 APNs 安全证书配置 {{site.data.keyword.mobilepushshort}}服务。有关的更多信息，请参阅[配置 APN 的凭证 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](t_push_provider_ios.html){: new_window}。 - - -## FPWSE0004E -{: #error_fpwse0004e} - -**说明**：请求中包含的 JSON 主体无效。 - - -**用户响应**：请确保在请求中使用有效的 JSON 语法。 - - - -## FPWSE0005E -{: #error_fpwse0005e} - -**说明**：对 {{site.data.keyword.mobilepushshort}} 服务器发出的请求不正确或不完整，因为 JSON 主体未包含完成 API 请求所需的属性值。例如，密码无效或设备令牌缺失。 - - -**用户响应**：请查看消息以了解缺失或无效的属性值，然后提供必需信息。 - - - -## FPWSE0006E -{: #error_fpwse0006e} - -**说明**：请求的 JSON 主体具有 {{site.data.keyword.mobilepushshort}} 服务器无法识别的参数。 - - -**用户响应**：请验证请求中的 JSON 主体是否遵循 {{site.data.keyword.mobilepushshort}} 服务器所预期的请求格式。有关的更多信息，请参阅 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window}。 - - - -## FPWSE0007E -{: #error_fpwse0007e} - -**说明**：请求 URL 中的查询字符串具有无法识别的参数。例如，如果预订删除请求具有 deviceId 和 tagName 以外的参数，那么可能会发生此错误。 - - -**用户响应**：请验证请求中的 JSON 主体是否遵循 {{site.data.keyword.mobilepushshort}} 服务器所预期的请求格式。有关的更多信息，请参阅 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window}。 - - - -## FPWSE0008E -{: #error_fpwse0008e} - -**说明**：请求 URL 中的查询字符串缺少必需参数。例如，预订删除请求中可能缺少 deviceId 和 tagName 参数。 - - -**用户响应**：请验证请求中的 JSON 主体是否遵循 {{site.data.keyword.mobilepushshort}} 服务器所预期的请求格式。有关的更多信息，请参阅 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window}。 - - - -## FPWSE0009E -{: #error_fpwse0009e} - -**说明**：尝试发送通知，但设备没有向应用程序注册。 - -**用户响应**：请在尝试发送通知之前，确保设备已向应用程序注册。 - - - -## FPWSE0010E -{: #error_fpwse0010e} - -**说明**：提交到服务器的请求导致异常状况。以下某个情况可能会导致此错误： - -- {{site.data.keyword.mobilepushshort}} 使用的内部子系统未在响应。 -- {{site.data.keyword.mobilepushshort}} 无法处理请求所导致的错误状况。 -- {{site.data.keyword.mobilepushshort}} 服务需要管理员的帮助。 - -**用户响应**：请重试请求。如果问题仍然存在，请联系 IBM 软件支持。 - - - -## FPWSE0011E -{: #error_fpwse0011e} - -**说明**：服务器上已存在该标记预订。例如，在创建已存在的预订时。 - -**用户响应**：请使用唯一标记名称来创建预订。 - - - -## FPWSE0012E -{: #error_fpwse0012e} - -**说明**：服务器上不存在该标记预订。所提交请求的内容是检索或删除不存在的预订时，会发生此错误。 - - -**用户响应**：请在请求中使用正确的标记名称和设备标识。 - - - -## FPWSE0013E -{: #error_fpwse0013e} - -**说明**：请求中的 JSON 有效内容无效。 - - -**用户响应**：请确保 JSON 有效内容有效。 - - -## FPWSE0025E -{: #error_fpwse0025e} - -**解释**：服务器当前无法处理请求。 - -**用户响应**：请稍后重新提交请求。 - - -## FPWSE1007E -{: #error_fpwse1007e} - -**说明**：已对此应用程序禁用 {{site.data.keyword.mobilepushshort}} 服务。这可能是由于计费问题，也可能是管理员已禁用该应用程序。 - - -**用户响应**：请参阅 Bluemix 文档中的故障诊断主题，以检查服务状态，查看故障诊断信息或了解有关获取帮助的信息。 - - - -## FPWSE1079E -{: #error_fpwse1079e} - -**说明**：为查询操作提供的偏移值无效。 - -**用户响应**：请确保偏移值大于或等于零。 - - - -## FPWSE1080E -{: #error_fpwse1080e} - -**说明**：为查询操作提供的大小值无效。 - -**用户响应**：请确保大小值大于零。 - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}} 服务错误消息 +{: #errors} +上次更新时间：2017 年 2 月 13 日 +{: .last-updated} + + +在响应 REST API 请求时，会返回以下 {{site.data.keyword.mobilepushshort}} 错误消息。 + +样本错误响应： +``` + { + "message": "Missing APNs credentials", + "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", + "code": "FPWSE0003E" + +} +``` + {: codeblock} + +要获取有关错误的更多信息，请在文档中搜索相关错误代码。 + +## FPWSE0001E +{: #error_fpwse0001e} + +**说明**：服务器上没有您尝试查询的资源，例如标记或预订。 + +**用户响应**：请创建在消息中报告的资源。或者，您可以提供正确的标识来查询该资源。 + + +## FPWSE0002E +{: #error_fpwse0002e} + +**说明**：服务器上已存在您尝试创建的资源。资源可以是标记、预订等。 + +**用户响应**：请使用其他标识来创建该资源。 + + +## FPWSE0003E +{: #error_fpwse0003e} + +**说明**：{{site.data.keyword.mobilepushshort}} 服务的必备配置不完整。可能是您在尝试获取 Apple 推送通知服务 (APNs) 凭证，但凭证尚未配置。 + +**用户响应**：请确保已使用有效的 APNs 安全证书配置 {{site.data.keyword.mobilepushshort}}服务。有关的更多信息，请参阅[配置 APN 的凭证 ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](t_push_provider_ios.html){: new_window}。 + + +## FPWSE0004E +{: #error_fpwse0004e} + +**说明**：请求中包含的 JSON 主体无效。 + + +**用户响应**：请确保在请求中使用有效的 JSON 语法。 + + + +## FPWSE0005E +{: #error_fpwse0005e} + +**说明**：对 {{site.data.keyword.mobilepushshort}} 服务器发出的请求不正确或不完整，因为 JSON 主体未包含完成 API 请求所需的属性值。例如，密码无效或设备令牌缺失。 + + +**用户响应**：请查看消息以了解缺失或无效的属性值，然后提供必需信息。 + + + +## FPWSE0006E +{: #error_fpwse0006e} + +**说明**：请求的 JSON 主体具有 {{site.data.keyword.mobilepushshort}} 服务器无法识别的参数。 + + +**用户响应**：请验证请求中的 JSON 主体是否遵循 {{site.data.keyword.mobilepushshort}} 服务器所预期的请求格式。有关的更多信息，请参阅 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window}。 + + + +## FPWSE0007E +{: #error_fpwse0007e} + +**说明**：请求 URL 中的查询字符串具有无法识别的参数。例如，如果预订删除请求具有 deviceId 和 tagName 以外的参数，那么可能会发生此错误。 + + +**用户响应**：请验证请求中的 JSON 主体是否遵循 {{site.data.keyword.mobilepushshort}} 服务器所预期的请求格式。有关的更多信息，请参阅 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window}。 + + + +## FPWSE0008E +{: #error_fpwse0008e} + +**说明**：请求 URL 中的查询字符串缺少必需参数。例如，预订删除请求中可能缺少 deviceId 和 tagName 参数。 + + +**用户响应**：请验证请求中的 JSON 主体是否遵循 {{site.data.keyword.mobilepushshort}} 服务器所预期的请求格式。有关的更多信息，请参阅 [REST API ![外部链接图标](../../icons/launch-glyph.svg "外部链接图标")](https://mobile.{DomainName}/imfpush/){: new_window}。 + + + +## FPWSE0009E +{: #error_fpwse0009e} + +**说明**：尝试发送通知，但设备没有向应用程序注册。 + +**用户响应**：请在尝试发送通知之前，确保设备已向应用程序注册。 + + + +## FPWSE0010E +{: #error_fpwse0010e} + +**说明**：提交到服务器的请求导致异常状况。以下某个情况可能会导致此错误： + +- {{site.data.keyword.mobilepushshort}} 使用的内部子系统未在响应。 +- {{site.data.keyword.mobilepushshort}} 无法处理请求所导致的错误状况。 +- {{site.data.keyword.mobilepushshort}} 服务需要管理员的帮助。 + +**用户响应**：请重试请求。如果问题仍然存在，请联系 IBM 软件支持。 + + + +## FPWSE0011E +{: #error_fpwse0011e} + +**说明**：服务器上已存在该标记预订。例如，在创建已存在的预订时。 + +**用户响应**：请使用唯一标记名称来创建预订。 + + + +## FPWSE0012E +{: #error_fpwse0012e} + +**说明**：服务器上不存在该标记预订。所提交请求的内容是检索或删除不存在的预订时，会发生此错误。 + + +**用户响应**：请在请求中使用正确的标记名称和设备标识。 + + + +## FPWSE0013E +{: #error_fpwse0013e} + +**说明**：请求中的 JSON 有效内容无效。 + + +**用户响应**：请确保 JSON 有效内容有效。 + + +## FPWSE0025E +{: #error_fpwse0025e} + +**解释**：服务器当前无法处理请求。 + +**用户响应**：请稍后重新提交请求。 + + +## FPWSE1007E +{: #error_fpwse1007e} + +**说明**：已对此应用程序禁用 {{site.data.keyword.mobilepushshort}} 服务。这可能是由于计费问题，也可能是管理员已禁用该应用程序。 + + +**用户响应**：请参阅 Bluemix 文档中的故障诊断主题，以检查服务状态，查看故障诊断信息或了解有关获取帮助的信息。 + + + +## FPWSE1079E +{: #error_fpwse1079e} + +**说明**：为查询操作提供的偏移值无效。 + +**用户响应**：请确保偏移值大于或等于零。 + + + +## FPWSE1080E +{: #error_fpwse1080e} + +**说明**：为查询操作提供的大小值无效。 + +**用户响应**：请确保大小值大于零。 + + + diff --git a/services/mobilepush/nl/zh/CN/troubleshooting.md b/services/mobilepush/nl/zh/CN/troubleshooting.md index 81a20432d..27dbd2c39 100644 --- a/services/mobilepush/nl/zh/CN/troubleshooting.md +++ b/services/mobilepush/nl/zh/CN/troubleshooting.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 故障诊断 -{: #errors} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - -使用本部分作为指南，对常见 {{site.data.keyword.mobilepushshort}} 问题进行故障诊断。 - - -### 发生内部服务器错误。请联系管理员。（内部错误代码：PUSHD102E） - -**说明**：如果您在 2015 年 11 月之前创建了推送实例，那么可能会发生此错误。 - -**用户响应**：要解决此问题，请删除推送实例并创建新实例。请注意，删除推送实例时，不会保留标记。 - - -### UnauthorizedRegistration - -**说明**：Chrome Web 推送不使用 Firebase 云消息传递 (FCM) 密钥。如果您从 GCM 迁移到 FCM 之后无法在 Chrome 上接收 Web 推送通知，这是因为 Web 站点先前配置为与 GCM 项目一起运作，而现在 FCM 中创建了新项目。所生成的识别浏览器的标记在 Chrome 浏览器中缓存。 - -**用户响应**：您可以通过删除 cookie 并重置浏览器权限来解决此问题。这样将请求启用推送通知的权限。 - - -### 在此浏览器中不支持服务工作程序 - -**解释**：使用服务工作程序作为 `BMSPushSDK.js` 一部分包含的 SDK 不可用。 - -**用户响应**：建议您切换至支持服务工作程序的浏览器。受支持的浏览器版本为 Firefox V49 或更高版本，以及 Chrome V53（64 位元）或更高版本。 - - -### SecurityError：操作不安全 - -**解释**：当您在 Firefox 中启用 Web 控制台时，您可能会看到错误。Push Notification 服务中的 Web 推送支持需要使用 `https` 协议而非 `http` 访问 Web 站点。 - -**用户响应**：建议您尝试从浏览器使用 `https` 连接到 Web 站点。 - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 故障诊断 +{: #errors} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + +使用本部分作为指南，对常见 {{site.data.keyword.mobilepushshort}} 问题进行故障诊断。 + + +### 发生内部服务器错误。请联系管理员。（内部错误代码：PUSHD102E） + +**说明**：如果您在 2015 年 11 月之前创建了推送实例，那么可能会发生此错误。 + +**用户响应**：要解决此问题，请删除推送实例并创建新实例。请注意，删除推送实例时，不会保留标记。 + + +### UnauthorizedRegistration + +**说明**：Chrome Web 推送不使用 Firebase 云消息传递 (FCM) 密钥。如果您从 GCM 迁移到 FCM 之后无法在 Chrome 上接收 Web 推送通知，这是因为 Web 站点先前配置为与 GCM 项目一起运作，而现在 FCM 中创建了新项目。所生成的识别浏览器的标记在 Chrome 浏览器中缓存。 + +**用户响应**：您可以通过删除 cookie 并重置浏览器权限来解决此问题。这样将请求启用推送通知的权限。 + + +### 在此浏览器中不支持服务工作程序 + +**解释**：使用服务工作程序作为 `BMSPushSDK.js` 一部分包含的 SDK 不可用。 + +**用户响应**：建议您切换至支持服务工作程序的浏览器。受支持的浏览器版本为 Firefox V49 或更高版本，以及 Chrome V53（64 位元）或更高版本。 + + +### SecurityError：操作不安全 + +**解释**：当您在 Firefox 中启用 Web 控制台时，您可能会看到错误。Push Notification 服务中的 Web 推送支持需要使用 `https` 协议而非 `http` 访问 Web 站点。 + +**用户响应**：建议您尝试从浏览器使用 `https` 连接到 Web 站点。 + diff --git a/services/mobilepush/nl/zh/CN/troubleshooting_config_errors.md b/services/mobilepush/nl/zh/CN/troubleshooting_config_errors.md index c2a89aab9..2ee75bb94 100644 --- a/services/mobilepush/nl/zh/CN/troubleshooting_config_errors.md +++ b/services/mobilepush/nl/zh/CN/troubleshooting_config_errors.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 解决 Web 推送配置错误 -{: #errors} -上次更新时间：2017 年 1 月 11 日 -{: .last-updated} - -使用本部分作为指南，解决经常发生的 Web 推送配置相关错误。来自 `BMSPushSDK.js` 的 Web 推送错误包含失败的相关信息。 - -要解析回调中返回的错误，请考虑以下样本代码： - -``` -function showStatus(response) { - if(response.statusCode == 200 || response.statusCode == 201) { - document.getElementById("status").innerHTML = "Response is " + response.response; - } - else if(response.statusCode == 0) { - if(response.response) { - document.getElementById("status").innerHTML = response.response; - } - else { - document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; - } - } - else { - document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " - + response.error + " and the status code " + response.statusCode; - } - } -``` - {: codeblock} - - -- 如果错误地配置 `applicationId`，那么对 {{site.data.keyword.mobilepushshort}} 服务的初始请求会失败，因为 statusCode 将设置为零 (0)。 -- 200 或 201 的状态码表示响应成功。 -- 如果 `clientSecret` 无效，那么会在 statusCode 上设置 401 响应。`response.reponse` 元素将包含错误的描述。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 解决 Web 推送配置错误 +{: #errors} +上次更新时间：2017 年 1 月 11 日 +{: .last-updated} + +使用本部分作为指南，解决经常发生的 Web 推送配置相关错误。来自 `BMSPushSDK.js` 的 Web 推送错误包含失败的相关信息。 + +要解析回调中返回的错误，请考虑以下样本代码： + +``` +function showStatus(response) { + if(response.statusCode == 200 || response.statusCode == 201) { + document.getElementById("status").innerHTML = "Response is " + response.response; + } + else if(response.statusCode == 0) { + if(response.response) { + document.getElementById("status").innerHTML = response.response; + } + else { + document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; + } + } + else { + document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " + + response.error + " and the status code " + response.statusCode; + } + } +``` + {: codeblock} + + +- 如果错误地配置 `applicationId`，那么对 {{site.data.keyword.mobilepushshort}} 服务的初始请求会失败，因为 statusCode 将设置为零 (0)。 +- 200 或 201 的状态码表示响应成功。 +- 如果 `clientSecret` 无效，那么会在 statusCode 上设置 401 响应。`response.reponse` 元素将包含错误的描述。 diff --git a/services/mobilepush/nl/zh/TW/c_advance_notifications.md b/services/mobilepush/nl/zh/TW/c_advance_notifications.md index 54072ce91..3db046654 100644 --- a/services/mobilepush/nl/zh/TW/c_advance_notifications.md +++ b/services/mobilepush/nl/zh/TW/c_advance_notifications.md @@ -1,12 +1,12 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# 啟用進階推送通知 -{: #push-advanced-notifications-main} - -配置 iOS 徽章、音效、其他 JSON 有效負載、可採取動作的通知，以及保存通知。 +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# 啟用進階推送通知 +{: #push-advanced-notifications-main} + +配置 iOS 徽章、音效、其他 JSON 有效負載、可採取動作的通知，以及保存通知。 diff --git a/services/mobilepush/nl/zh/TW/c_android_enable.md b/services/mobilepush/nl/zh/TW/c_android_enable.md index 969ab273c..eb35772d8 100644 --- a/services/mobilepush/nl/zh/TW/c_android_enable.md +++ b/services/mobilepush/nl/zh/TW/c_android_enable.md @@ -1,361 +1,361 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 啟用 Android 應用程式來接收 {{site.data.keyword.mobilepushshort}} -{: #tag_based_notifications} -前次更新：2017 年 2 月 14 日 -{: .last-updated} - -您可以啟用 Android 應用程式來接收傳送至您裝置的推送通知。Android Studio 是必備項目，而且是建置 Android 專案的建議方法。對 Android Studio 的基本瞭解十分重要。 - -## 使用 Gradle 安裝 Client Push SDK -{: #android_install} - -本節說明如何安裝及使用 Client Push SDK 來進一步開發 Android 應用程式。 - -Bluemix® Mobile Services Push SDK 可以使用 Gradle 進行新增。Gradle 會從儲存庫中自動下載構件，並讓它們可供 Android 應用程式使用。請確定您已正確設定 Android Studio 及 Android Studio SDK。如需如何設定系統的相關資訊，請參閱 [Android Studio Overview ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.android.com/tools/studio/index.html){: new_window}。如需 Gradle 的相關資訊，請參閱 [Configuring Gradle Builds ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}。 - -在建立並開啟行動應用程式之後，請使用 Android Studio 來完成下列步驟。 - -1. 將相依關係新增至「模組」層次 **build.gradle** 檔案。 - - - 新增下列相依關係，以將 Bluemix™ Mobile Services Push Client SDK 及 Google Play Services SDK 包含在您的編譯範圍相依關係。 - ``` - com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ - ``` - {: codeblock} - - - 將下列相依關係新增至 import 陳述式，程式碼 Snippet 需要這些 import 陳述式。 - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - {: codeblock} - - - 最後，將下列相依關係新增至「模組」層次 **build.gradle** 檔案。 - ``` - apply plugin: 'com.google.gms.google-services' - ``` - {: codeblock} -3. 將下列相依關係新增至「專案」層次 **build.gradle** 檔案。 -``` -dependencies { - classpath 'com.android.tools.build:gradle:2.2.3' - classpath 'com.google.gms:google-services:3.0.0' -} -``` - {: codeblock} -5. 在 **AndroidManifest.xml** 檔案中，新增下列許可權。若要檢視範例資訊清單，請參閱 [Android helloPush 範例應用程式 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}。若要檢視範例 Gradle 檔案，請參閱 [範例建置 Gradle 檔案 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}。 -``` - - - - - -``` - {: codeblock} - 此處鏈結可閱讀 [Android 許可權 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](http://developer.android.com/guide/topics/security/permissions.html){: new_window}。 - -4. 新增活動的通知目的設定。此設定會在使用者按一下通知區域中的接收通知時啟動應用程式。 -``` - - - - -``` - {: codeblock} -**附註**：將先前動作中的 *Your_Android_Package_Name* 取代為您應用程式中所使用的應用程式套件名稱。 - -5. 針對 RECEIVE 及 REGISTRATION 事件通知，新增 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) 目的服務及目的過濾器。 -``` - - - - - - - - - - -``` - {: codeblock} - -6. {{site.data.keyword.mobilepushshort}} Service 支援從通知匣擷取個別通知。對於從通知匣存取的通知，只會提供給您所點選之通知的控點。正常開啟應用程式時，會顯示所有通知。請使用下列 Snippet 來更新 **AndroidManifest.xml** 檔案，以使用此功能： - -``` - -``` - {: codeblock} - -若要設定 FCM 專案並取得您的認證，請參閱[取得傳送端 ID 及 API 金鑰](t_push_provider_android.html)。請使用 Firebase Cloud Messaging (FCM) 主控台來完成下列步驟。 - -1. 在 Firebase 主控台中，按一下**專案設定**圖示。 - ![Firebase 專案設定](images/FCM_4.jpg) - -3. 從應用程式窗格的「一般」標籤中，選取**新增應用程式**或**將 Firebase 新增至 Android 應用程式**圖示。![將 Firebase 新增至 Android](images/FCM_5.jpg) - -4. 在「將 Firebase 新增至 Android 應用程式」視窗中，新增 **com.ibm.mobilefirstplatform.clientsdk.android.push** 作為「套件名稱」。應用程式暱稱欄位是選用性的。按一下**新增應用程式**。 - ![「將 Firebase 新增至 Android」視窗](images/FCM_1.jpg) - -5. 在「將 Firebase 新增至 Android 應用程式」視窗中輸入套件名稱，以包含應用程式的套件名稱。應用程式暱稱欄位是選用性的。按一下**新增應用程式**。 - - ![新增應用程式的套件名稱](images/FCM_2.jpg) - -6. 會產生 `google-services.json` 檔案。將 `google-services.json` 檔案複製到您的 Android 應用程式模組根目錄。請注意，`google-service.json` 檔案包含已新增的套件名稱。 - - ![將 json 檔案新增至應用程式的根目錄](images/FCM_7.jpg) - -5. 在「將 Firebase 新增至 Android 應用程式」視窗中，按一下**繼續**，然後按一下**完成**。 - - - -建置並執行應用程式。 - -## 起始設定 Push SDK for Android 應用程式 -{: #android_initialize} - -放置起始設定碼的一般位置位於 Android 應用程式之主要活動的 onCreate 方法中。SDK 有兩個需要起始設定的元件。一個是核心 SDK，另一個是根據核心 SDK 所建置的 Push SDK。 - -###起始設定 Core SDK - -``` -// Initialize the SDK for Android - BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); -``` - {: codeblock} - -####bluemixRegionSuffix -{: bluemixRegionSuffix} - -指定管理應用程式的位置。您可以使用下列三個值的其中一個： - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -###起始設定 Client Push SDK - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext(), "appGUID", "clientSecret"); -``` - {: codeblock} - -####AppGUID -{: appguid_initialize_client_push_sdk} - -這是 {{site.data.keyword.mobilepushshort}} Service 的 AppGUID 金鑰。此值區分大小寫。開啟 Push Notification 儀表板，然後選取「配置」標籤。您可以從 Push Notification Service 儀表板上「配置」標籤的「行動選項」中取得此值。 - -## 登錄 Android 裝置 -{: #android_register} - -使用 `MFPPush.register()` API，以向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置。如需登錄 Android 裝置，請在 Bluemix {{site.data.keyword.mobilepushshort}} Service 配置儀表板中新增 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) 資訊。如需相關資訊，請參閱[配置 Google Cloud Messaging 的認證](t_push_provider_android.html)。 - -將下列程式碼 Snippet 複製到 Android 行動應用程式。 - -``` - //Register Android devices - push.registerDevice(new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - {: codeblock} - - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` - {: codeblock} - -## 在 Android 裝置上接收推送通知 -{: #android_receive} - -若要向 Push 登錄 notificationListener 物件，請呼叫 **MFPPush.listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 方法所呼叫。 - -1. 若要向 Push 登錄 notificationListener 物件，請呼叫 **listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 及 **onPause** 方法所呼叫。 - - -``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` - {: codeblock} - - - -``` - @Override - protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } - } -``` - {: codeblock} - -2. 建置專案，並在裝置或模擬器上執行該專案。在 register() 方法中呼叫回應接聽器的 onSuccess() 方法時，它會確認已順利向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置。此時，您可以如「傳送基本推送通知」所述傳送訊息。 -3. 驗證您的裝置已接收到通知。如果應用程式是在前景中，則 **MFPPushNotificationListener** 會處理通知。如果應用程式是在背景中，則會在通知列中顯示一則訊息。 - -## 在 Android 裝置上監視推送通知 -{: #android_monitor} - -若要監視應用程式內的現行通知狀態，您可以實作 `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` 介面，並定義方法 onStatusChange(String messageId, MFPPushNotificationStatus status)。 - -**messageId** 是從伺服器傳送之訊息的 ID。**MFPPushNotificationStatus** 以值來定義通知的狀態： - -- **RECEIVED** - 應用程式已收到通知。 -- **QUEUED** - 應用程式將通知置入佇列以便呼叫通知接聽器。 -- **OPENED** - 使用者藉由按一下系統匣裡的通知，或是從應用程式圖示或在應用程式處於前景時啟用它，來開啟通知。 -- **DISMISSED** - 使用者清除/跳出系統匣裡的通知。 - -您需要向 MFPPush 登錄 **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** 類別。 - -``` - push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { -@Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { -// Handle status change -} -}); -``` - {: codeblock} - - -### 接聽 DISMISSED 狀態 - -您可以選擇在下列任一狀況接聽 DISMISSED 狀態： - -- 當應用程式在作用中（在前景或背景執行）時 - - 將 Snippet 新增至您的 `AndroidManifest.xml` 檔案： - -``` - - - - - -``` - {: codeblock} - -- 當應用程式在作用中（在前景或背景執行）以及不在執行中（已關閉）時 - -您需要延伸 **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** 廣播接收端並置換 **onReceive()** 方法，其中應該先登錄 **MFPPushNotificationStatusListener** 然後再呼叫基礎類別的 **onReceive()** 方法。 - -``` - public class MyDismissHandler extends MFPPushNotificationDismissHandler { -@Override -public void onReceive(Context context, Intent intent) { -MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { -@Override -public void onStatusChange(String messageId, MFPPushNotificationStatus status) { -// Handle status change -} -}); -super.onReceive(context, intent); -} -} -``` - {: codeblock} - - -將下列 Snippet 新增至您的 `AndroidManifest.xml` 檔案： - -``` - - - - - -``` - {: codeblock} - -## 傳送基本 {{site.data.keyword.mobilepushshort}} -{: #send} - -開發應用程式之後，您可以傳送基本推送通知。 - -若要傳送基本推送通知，請完成下列步驟： - -1. 選取**傳送通知**，然後選擇**傳送至**選項來編寫訊息。支援的選項是**依標籤的裝置**、**裝置 ID**、**使用者 ID**、**Android 裝置**、**iOS 裝置**、**Web 通知**及**所有裝置**。 -**附註**：當您選取**所有裝置**選項時，所有已訂閱 {{site.data.keyword.mobilepushshort}} 的裝置都會接收到通知。![通知畫面](images/tag_notification.jpg) - -2. 在**訊息**欄位中，編寫訊息。視需要選擇配置選用設定。 -3. 按一下**傳送**。 -3. 驗證您的裝置已接收到通知。 - -下列擷取畫面顯示在 Android 裝置的前景中處理推送通知的警示框。 - - - -![Android 上的前景推送通知](images/Android_Screenshot.jpg) - -下列擷取畫面顯示 Android 背景中的推送通知。 - - -![Android 上的背景推送通知](images/background.jpg) - -### 傳送通知的選用 Android 設定 -{: #send_otpional_setting} - -您可以進一步自訂 {{site.data.keyword.mobilepushshort}} 設定，以將通知傳送給 Android 裝置。支援下列選用自訂選項。 -![Android 自訂設定](images/android_custom_settings.jpg) - -- **收合金鑰**：收合金鑰會附加至通知。如果多個具有相同收合金鑰的通知在裝置離線時循序到達，則會予以收合。當裝置上線時，會接收到來自 FCM/GCM 伺服器的通知，並且只會顯示含有相同收合金鑰的最新通知。如果未設定收合金鑰，則會儲存新舊訊息，以供未來遞送。 -- **音效**：指出要在收到通知時播放的音效短片。支援預設值或應用程式中所組合的音效資源名稱。 -- **圖示**：指定要針對通知顯示的圖示名稱。請確定您已將圖示與用戶端應用程式包裝至 res/drawable 資料夾。 -- **優先順序**：指定用於指派訊息遞送優先順序的選項。優先順序 `high` 或 `max` 將會導致提前通知，而 `low` 或 `default` 優先順序訊息則不會在休眠裝置上開啟網路連線。針對選項設為 `min` 的訊息，它會是無聲自動通知。 -- **可見性**：您可以選擇將通知可見性選項設為 `public` 或 `private`。`private` 選項會限制公用檢視，因此，如果您的裝置使用 PIN 碼或型樣保護，且通知設定設為「隱藏機密通知內容」，則可以選擇啟用它。可見性設為 `private` 時，必須提及 "redact" 欄位。只有 redact 欄位中所指定的內容才會顯示在裝置的安全鎖定畫面上。選擇 `public` 則會呈現可自由讀取的通知。 -- **存活時間**：此值是以秒為單位來設定。如果未指定此參數，則 FCM/GCM 伺服器會儲存訊息四週，並嘗試遞送。有效性會在四週後到期。可能值範圍是從 0 到 2,419,200 秒。 -- **閒置時延遲**：將此值設為 `true` 時，指示 FCM/GCM 伺服器不要在裝置閒置時遞送通知。將此值設為 `false`，則可確保遞送通知，即使裝置閒置也是一樣。 -- **同步**：透過將此選項設為 `true`，所有已登錄裝置的通知就會同步。如果具有使用者名稱的使用者有多個已安裝相同應用程式的裝置，則讀取某個裝置上的通知可確保刪除其他裝置中的通知。您需要確定已使用 userId 向 {{site.data.keyword.mobilepushshort}} Service 進行登錄，此選項才能運作。 -- **其他有效負載**：指定通知的自訂有效負載值。 - - -## 後續步驟 -{: #next_steps_tags} - -順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 - -將這些 Push Notifications Service 特性新增至您的應用程式。 -若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 -若要使用進階通知選項，請參閱[啟用進階推送通知](t_advance_badge_sound_payload.html)。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 啟用 Android 應用程式來接收 {{site.data.keyword.mobilepushshort}} +{: #tag_based_notifications} +前次更新：2017 年 2 月 14 日 +{: .last-updated} + +您可以啟用 Android 應用程式來接收傳送至您裝置的推送通知。Android Studio 是必備項目，而且是建置 Android 專案的建議方法。對 Android Studio 的基本瞭解十分重要。 + +## 使用 Gradle 安裝 Client Push SDK +{: #android_install} + +本節說明如何安裝及使用 Client Push SDK 來進一步開發 Android 應用程式。 + +Bluemix® Mobile Services Push SDK 可以使用 Gradle 進行新增。Gradle 會從儲存庫中自動下載構件，並讓它們可供 Android 應用程式使用。請確定您已正確設定 Android Studio 及 Android Studio SDK。如需如何設定系統的相關資訊，請參閱 [Android Studio Overview ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.android.com/tools/studio/index.html){: new_window}。如需 Gradle 的相關資訊，請參閱 [Configuring Gradle Builds ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](http://developer.android.com/tools/building/configuring-gradle.html){: new_window}。 + +在建立並開啟行動應用程式之後，請使用 Android Studio 來完成下列步驟。 + +1. 將相依關係新增至「模組」層次 **build.gradle** 檔案。 + + - 新增下列相依關係，以將 Bluemix™ Mobile Services Push Client SDK 及 Google Play Services SDK 包含在您的編譯範圍相依關係。 + ``` + com.ibm.mobilefirstplatform.clientsdk.android:push:3.+ + ``` + {: codeblock} + + - 將下列相依關係新增至 import 陳述式，程式碼 Snippet 需要這些 import 陳述式。 + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + {: codeblock} + + - 最後，將下列相依關係新增至「模組」層次 **build.gradle** 檔案。 + ``` + apply plugin: 'com.google.gms.google-services' + ``` + {: codeblock} +3. 將下列相依關係新增至「專案」層次 **build.gradle** 檔案。 +``` +dependencies { + classpath 'com.android.tools.build:gradle:2.2.3' + classpath 'com.google.gms:google-services:3.0.0' +} +``` + {: codeblock} +5. 在 **AndroidManifest.xml** 檔案中，新增下列許可權。若要檢視範例資訊清單，請參閱 [Android helloPush 範例應用程式 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml){: new_window}。若要檢視範例 Gradle 檔案，請參閱 [範例建置 Gradle 檔案 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle){: new_window}。 +``` + + + + + +``` + {: codeblock} + 此處鏈結可閱讀 [Android 許可權 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](http://developer.android.com/guide/topics/security/permissions.html){: new_window}。 + +4. 新增活動的通知目的設定。此設定會在使用者按一下通知區域中的接收通知時啟動應用程式。 +``` + + + + +``` + {: codeblock} +**附註**：將先前動作中的 *Your_Android_Package_Name* 取代為您應用程式中所使用的應用程式套件名稱。 + +5. 針對 RECEIVE 及 REGISTRATION 事件通知，新增 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) 目的服務及目的過濾器。 +``` + + + + + + + + + + +``` + {: codeblock} + +6. {{site.data.keyword.mobilepushshort}} Service 支援從通知匣擷取個別通知。對於從通知匣存取的通知，只會提供給您所點選之通知的控點。正常開啟應用程式時，會顯示所有通知。請使用下列 Snippet 來更新 **AndroidManifest.xml** 檔案，以使用此功能： + +``` + +``` + {: codeblock} + +若要設定 FCM 專案並取得您的認證，請參閱[取得傳送端 ID 及 API 金鑰](t_push_provider_android.html)。請使用 Firebase Cloud Messaging (FCM) 主控台來完成下列步驟。 + +1. 在 Firebase 主控台中，按一下**專案設定**圖示。 + ![Firebase 專案設定](images/FCM_4.jpg) + +3. 從應用程式窗格的「一般」標籤中，選取**新增應用程式**或**將 Firebase 新增至 Android 應用程式**圖示。![將 Firebase 新增至 Android](images/FCM_5.jpg) + +4. 在「將 Firebase 新增至 Android 應用程式」視窗中，新增 **com.ibm.mobilefirstplatform.clientsdk.android.push** 作為「套件名稱」。應用程式暱稱欄位是選用性的。按一下**新增應用程式**。 + ![「將 Firebase 新增至 Android」視窗](images/FCM_1.jpg) + +5. 在「將 Firebase 新增至 Android 應用程式」視窗中輸入套件名稱，以包含應用程式的套件名稱。應用程式暱稱欄位是選用性的。按一下**新增應用程式**。 + + ![新增應用程式的套件名稱](images/FCM_2.jpg) + +6. 會產生 `google-services.json` 檔案。將 `google-services.json` 檔案複製到您的 Android 應用程式模組根目錄。請注意，`google-service.json` 檔案包含已新增的套件名稱。 + + ![將 json 檔案新增至應用程式的根目錄](images/FCM_7.jpg) + +5. 在「將 Firebase 新增至 Android 應用程式」視窗中，按一下**繼續**，然後按一下**完成**。 + + + +建置並執行應用程式。 + +## 起始設定 Push SDK for Android 應用程式 +{: #android_initialize} + +放置起始設定碼的一般位置位於 Android 應用程式之主要活動的 onCreate 方法中。SDK 有兩個需要起始設定的元件。一個是核心 SDK，另一個是根據核心 SDK 所建置的 Push SDK。 + +### 起始設定 Core SDK + +``` +// Initialize the SDK for Android + BMSClient.getInstance().initialize(this, BMSClient.REGION_US_SOUTH); +``` + {: codeblock} + +#### bluemixRegionSuffix +{: bluemixRegionSuffix} + +指定管理應用程式的位置。您可以使用下列三個值的其中一個： + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +### 起始設定 Client Push SDK + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext(), "appGUID", "clientSecret"); +``` + {: codeblock} + +#### AppGUID +{: appguid_initialize_client_push_sdk} + +這是 {{site.data.keyword.mobilepushshort}} Service 的 AppGUID 金鑰。此值區分大小寫。開啟 Push Notification 儀表板，然後選取「配置」標籤。您可以從 Push Notification Service 儀表板上「配置」標籤的「行動選項」中取得此值。 + +## 登錄 Android 裝置 +{: #android_register} + +使用 `MFPPush.register()` API，以向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置。如需登錄 Android 裝置，請在 Bluemix {{site.data.keyword.mobilepushshort}} Service 配置儀表板中新增 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) 資訊。如需相關資訊，請參閱[配置 Google Cloud Messaging 的認證](t_push_provider_android.html)。 + +將下列程式碼 Snippet 複製到 Android 行動應用程式。 + +``` + //Register Android devices + push.registerDevice(new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + {: codeblock} + + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` + {: codeblock} + +## 在 Android 裝置上接收推送通知 +{: #android_receive} + +若要向 Push 登錄 notificationListener 物件，請呼叫 **MFPPush.listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 方法所呼叫。 + +1. 若要向 Push 登錄 notificationListener 物件，請呼叫 **listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 及 **onPause** 方法所呼叫。 + + +``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` + {: codeblock} + + + +``` + @Override + protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } + } +``` + {: codeblock} + +2. 建置專案，並在裝置或模擬器上執行該專案。在 register() 方法中呼叫回應接聽器的 onSuccess() 方法時，它會確認已順利向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置。此時，您可以如「傳送基本推送通知」所述傳送訊息。 +3. 驗證您的裝置已接收到通知。如果應用程式是在前景中，則 **MFPPushNotificationListener** 會處理通知。如果應用程式是在背景中，則會在通知列中顯示一則訊息。 + +## 在 Android 裝置上監視推送通知 +{: #android_monitor} + +若要監視應用程式內的現行通知狀態，您可以實作 `com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener` 介面，並定義方法 onStatusChange(String messageId, MFPPushNotificationStatus status)。 + +**messageId** 是從伺服器傳送之訊息的 ID。**MFPPushNotificationStatus** 以值來定義通知的狀態： + +- **RECEIVED** - 應用程式已收到通知。 +- **QUEUED** - 應用程式將通知置入佇列以便呼叫通知接聽器。 +- **OPENED** - 使用者藉由按一下系統匣裡的通知，或是從應用程式圖示或在應用程式處於前景時啟用它，來開啟通知。 +- **DISMISSED** - 使用者清除/跳出系統匣裡的通知。 + +您需要向 MFPPush 登錄 **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationStatusListener** 類別。 + +``` + push.setNotificationStatusListener(new MFPPushNotificationStatusListener() { +@Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { +// Handle status change +} +}); +``` + {: codeblock} + + +### 接聽 DISMISSED 狀態 + +您可以選擇在下列任一狀況接聽 DISMISSED 狀態： + +- 當應用程式在作用中（在前景或背景執行）時 + + 將 Snippet 新增至您的 `AndroidManifest.xml` 檔案： + +``` + + + + + +``` + {: codeblock} + +- 當應用程式在作用中（在前景或背景執行）以及不在執行中（已關閉）時 + +您需要延伸 **com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationDismissHandler** 廣播接收端並置換 **onReceive()** 方法，其中應該先登錄 **MFPPushNotificationStatusListener** 然後再呼叫基礎類別的 **onReceive()** 方法。 + +``` + public class MyDismissHandler extends MFPPushNotificationDismissHandler { +@Override +public void onReceive(Context context, Intent intent) { +MFPPush.getInstance().setNotificationStatusListener(new MFPPushNotificationStatusListener() { +@Override +public void onStatusChange(String messageId, MFPPushNotificationStatus status) { +// Handle status change +} +}); +super.onReceive(context, intent); +} +} +``` + {: codeblock} + + +將下列 Snippet 新增至您的 `AndroidManifest.xml` 檔案： + +``` + + + + + +``` + {: codeblock} + +## 傳送基本 {{site.data.keyword.mobilepushshort}} +{: #send} + +開發應用程式之後，您可以傳送基本推送通知。 + +若要傳送基本推送通知，請完成下列步驟： + +1. 選取**傳送通知**，然後選擇**傳送至**選項來編寫訊息。支援的選項是**依標籤的裝置**、**裝置 ID**、**使用者 ID**、**Android 裝置**、**iOS 裝置**、**Web 通知**及**所有裝置**。 +**附註**：當您選取**所有裝置**選項時，所有已訂閱 {{site.data.keyword.mobilepushshort}} 的裝置都會接收到通知。![通知畫面](images/tag_notification.jpg) + +2. 在**訊息**欄位中，編寫訊息。視需要選擇配置選用設定。 +3. 按一下**傳送**。 +3. 驗證您的裝置已接收到通知。 + +下列擷取畫面顯示在 Android 裝置的前景中處理推送通知的警示框。 + + + +![Android 上的前景推送通知](images/Android_Screenshot.jpg) + +下列擷取畫面顯示 Android 背景中的推送通知。 + + +![Android 上的背景推送通知](images/background.jpg) + +### 傳送通知的選用 Android 設定 +{: #send_otpional_setting} + +您可以進一步自訂 {{site.data.keyword.mobilepushshort}} 設定，以將通知傳送給 Android 裝置。支援下列選用自訂選項。 +![Android 自訂設定](images/android_custom_settings.jpg) + +- **收合金鑰**：收合金鑰會附加至通知。如果多個具有相同收合金鑰的通知在裝置離線時循序到達，則會予以收合。當裝置上線時，會接收到來自 FCM/GCM 伺服器的通知，並且只會顯示含有相同收合金鑰的最新通知。如果未設定收合金鑰，則會儲存新舊訊息，以供未來遞送。 +- **音效**：指出要在收到通知時播放的音效短片。支援預設值或應用程式中所組合的音效資源名稱。 +- **圖示**：指定要針對通知顯示的圖示名稱。請確定您已將圖示與用戶端應用程式包裝至 res/drawable 資料夾。 +- **優先順序**：指定用於指派訊息遞送優先順序的選項。優先順序 `high` 或 `max` 將會導致提前通知，而 `low` 或 `default` 優先順序訊息則不會在休眠裝置上開啟網路連線。針對選項設為 `min` 的訊息，它會是無聲自動通知。 +- **可見性**：您可以選擇將通知可見性選項設為 `public` 或 `private`。`private` 選項會限制公用檢視，因此，如果您的裝置使用 PIN 碼或型樣保護，且通知設定設為「隱藏機密通知內容」，則可以選擇啟用它。可見性設為 `private` 時，必須提及 "redact" 欄位。只有 redact 欄位中所指定的內容才會顯示在裝置的安全鎖定畫面上。選擇 `public` 則會呈現可自由讀取的通知。 +- **存活時間**：此值是以秒為單位來設定。如果未指定此參數，則 FCM/GCM 伺服器會儲存訊息四週，並嘗試遞送。有效性會在四週後到期。可能值範圍是從 0 到 2,419,200 秒。 +- **閒置時延遲**：將此值設為 `true` 時，指示 FCM/GCM 伺服器不要在裝置閒置時遞送通知。將此值設為 `false`，則可確保遞送通知，即使裝置閒置也是一樣。 +- **同步**：透過將此選項設為 `true`，所有已登錄裝置的通知就會同步。如果具有使用者名稱的使用者有多個已安裝相同應用程式的裝置，則讀取某個裝置上的通知可確保刪除其他裝置中的通知。您需要確定已使用 userId 向 {{site.data.keyword.mobilepushshort}} Service 進行登錄，此選項才能運作。 +- **其他有效負載**：指定通知的自訂有效負載值。 + + +## 後續步驟 +{: #next_steps_tags} + +順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 + +將這些 Push Notifications Service 特性新增至您的應用程式。 +若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 +若要使用進階通知選項，請參閱[啟用進階推送通知](t_advance_badge_sound_payload.html)。 diff --git a/services/mobilepush/nl/zh/TW/c_chrome_firefox_enable.md b/services/mobilepush/nl/zh/TW/c_chrome_firefox_enable.md index fe3b6c9d1..9620772f9 100644 --- a/services/mobilepush/nl/zh/TW/c_chrome_firefox_enable.md +++ b/services/mobilepush/nl/zh/TW/c_chrome_firefox_enable.md @@ -1,132 +1,132 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 啟用 Web 應用程式來接收 {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -前次更新：2017 年 2 月 16 日 -{: .last-updated} - -您可以啟用 Google Chrome、Mozilla Firefox 及 Safari Web 應用程式來接收 {{site.data.keyword.mobilepushshort}}。請確定您已通過 -[配置通知提供者的認證](t__main_push_config_provider.html)，再繼續進行下列步驟。 - -## 安裝適用於 {{site.data.keyword.mobilepushshort}} 的 Web 瀏覽器用戶端 SDK -{: #web_install} - -本主題說明如何安裝及使用用戶端 JavaScript Push SDK，來進一步開發 Web 應用程式。 - -### 在 Web 應用程式中起始設定 - -若要在 Google Chrome Web 應用程式中安裝 Javascript SDK，請完成下列步驟： - -從 [Bluemix Web Push SDK](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window} 下載 `BMSPushSDK.js`、`BMSPushServiceWorker.js` 及 `manifest_Website.json` 檔案。 - -1. 編輯 `manifest_Website.json` 檔案。 - - 若為 Google Chrome 瀏覽器，請將 `name` 變更為您網站的名稱。例如，`www.dailynewsupdates.com`。將 `gcm_sender_id` 變更為 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) sender_ID。如需相關資訊，請參閱[取得傳送端 ID 及 API 金鑰](t_push_provider_android.html)。gcm_sender_id 值只包含數字。 - - ``` - { - "name": "YOUR_WEBSITE_NAME", - "gcm_sender_id": "GCM_Sender_Id" - } - ``` - {: codeblock} - - - 若使用 Mozilla Firefox 瀏覽器，請在 `manifest_Website.json` 檔案中新增下列值。提供適當的 `name`。這將會是網站的名稱。 - - ``` - { - "name": "YOUR_WEBSITE_NAME" - } - ``` - {: codeblock} - -2. 將 `manifest_Website.json` 檔名變更為 `manifest.json`。 -3. 將 `BMSPushSDK.js`、`BMSPushServiceWorker.js` 及 `manifest.json` 新增至網站的根目錄。 -3. 在 html 檔案的 `` 標籤中包含 `manifest.json`。 - ``` - - ``` - {: codeblock} -4. 在 Web 應用程式中包含 Bluemix Web Push SDK。 - ``` - - ``` - {: codeblock} - -**附註**：確定已部署程式碼，且範例鏈結是使用 `https` 存取，而非 `http`。 - -## 起始設定 Web Push SDK -{: #web_initialize} - -使用 Bluemix {{site.data.keyword.mobilepushshort}} 服務 `app GUID` 及 `app Region` 來起始設定 Push SDK。 - -若要取得應用程式 GUID，請在導覽窗格中選取已起始設定之 Push 服務的**配置**選項，然後按一下**行動選項**。修改程式碼 Snippet，以使用 Bluemix Push Notifications Service appGUID 參數。 - -`App Region` 指定管理 {{site.data.keyword.mobilepushshort}} Service 的位置。您可以使用下列三個值的其中一個： - - - 美國達拉斯：`.ng.bluemix.net` - - 英國：`.eu-gb.bluemix.net` - - 雪梨：`.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(initParams, callback) -``` - {: codeblock} - -**附註：**如果您的 Web 推送 SDK 的 FCM 認證變更，Chrome 瀏覽器的訊息遞送可能會失敗。請確定您呼叫 `bmsPush.unRegisterDevice`，以避免發生失敗。 - -如果您提供錯誤參數，您可能會看到配置相關的錯誤。如需相關資訊，請參閱[解析 Web 推送配置錯誤](troubleshooting_config_errors.html)。 - -## 登錄 Web 應用程式 -{: #web_register} - -使用 **register()** API，以向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置。根據您的瀏覽器，使用下列任何選項。 - -- 若要從 Google Chrome 登錄，請在 Bluemix {{site.data.keyword.mobilepushshort}} Service Web 配置儀表板中新增 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) API 金鑰及網站 URL。如需相關資訊，請參閱 Chrome 設定下的[配置 Google Cloud Messaging 的認證](t_push_provider_android.html)。 - -- 若要從 Mozilla Firefox 登錄，請在 Bluemix {{site.data.keyword.mobilepushshort}} Service Web 配置儀表板的 Firefox 設定下新增網站 URL。 - -使用下列程式碼 Snippet，在 Bluemix {{site.data.keyword.mobilepushshort}} Service 中登錄。 - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 啟用 Web 應用程式來接收 {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +前次更新：2017 年 2 月 16 日 +{: .last-updated} + +您可以啟用 Google Chrome、Mozilla Firefox 及 Safari Web 應用程式來接收 {{site.data.keyword.mobilepushshort}}。請確定您已通過 +[配置通知提供者的認證](t__main_push_config_provider.html)，再繼續進行下列步驟。 + +## 安裝適用於 {{site.data.keyword.mobilepushshort}} 的 Web 瀏覽器用戶端 SDK +{: #web_install} + +本主題說明如何安裝及使用用戶端 JavaScript Push SDK，來進一步開發 Web 應用程式。 + +### 在 Web 應用程式中起始設定 + +若要在 Google Chrome Web 應用程式中安裝 Javascript SDK，請完成下列步驟： + +從 [Bluemix Web Push SDK](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window} 下載 `BMSPushSDK.js`、`BMSPushServiceWorker.js` 及 `manifest_Website.json` 檔案。 + +1. 編輯 `manifest_Website.json` 檔案。 + - 若為 Google Chrome 瀏覽器，請將 `name` 變更為您網站的名稱。例如，`www.dailynewsupdates.com`。將 `gcm_sender_id` 變更為 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) sender_ID。如需相關資訊，請參閱[取得傳送端 ID 及 API 金鑰](t_push_provider_android.html)。gcm_sender_id 值只包含數字。 + + ``` + { + "name": "YOUR_WEBSITE_NAME", + "gcm_sender_id": "GCM_Sender_Id" + } + ``` + {: codeblock} + + - 若使用 Mozilla Firefox 瀏覽器，請在 `manifest_Website.json` 檔案中新增下列值。提供適當的 `name`。這將會是網站的名稱。 + + ``` + { + "name": "YOUR_WEBSITE_NAME" + } + ``` + {: codeblock} + +2. 將 `manifest_Website.json` 檔名變更為 `manifest.json`。 +3. 將 `BMSPushSDK.js`、`BMSPushServiceWorker.js` 及 `manifest.json` 新增至網站的根目錄。 +3. 在 html 檔案的 `` 標籤中包含 `manifest.json`。 + ``` + + ``` + {: codeblock} +4. 在 Web 應用程式中包含 Bluemix Web Push SDK。 + ``` + + ``` + {: codeblock} + +**附註**：確定已部署程式碼，且範例鏈結是使用 `https` 存取，而非 `http`。 + +## 起始設定 Web Push SDK +{: #web_initialize} + +使用 Bluemix {{site.data.keyword.mobilepushshort}} 服務 `app GUID` 及 `app Region` 來起始設定 Push SDK。 + +若要取得應用程式 GUID，請在導覽窗格中選取已起始設定之 Push 服務的**配置**選項，然後按一下**行動選項**。修改程式碼 Snippet，以使用 Bluemix Push Notifications Service appGUID 參數。 + +`App Region` 指定管理 {{site.data.keyword.mobilepushshort}} Service 的位置。您可以使用下列三個值的其中一個： + + - 美國達拉斯：`.ng.bluemix.net` + - 英國：`.eu-gb.bluemix.net` + - 雪梨：`.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(initParams, callback) +``` + {: codeblock} + +**附註：**如果您的 Web 推送 SDK 的 FCM 認證變更，Chrome 瀏覽器的訊息遞送可能會失敗。請確定您呼叫 `bmsPush.unRegisterDevice`，以避免發生失敗。 + +如果您提供錯誤參數，您可能會看到配置相關的錯誤。如需相關資訊，請參閱[解析 Web 推送配置錯誤](troubleshooting_config_errors.html)。 + +## 登錄 Web 應用程式 +{: #web_register} + +使用 **register()** API，以向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置。根據您的瀏覽器，使用下列任何選項。 + +- 若要從 Google Chrome 登錄，請在 Bluemix {{site.data.keyword.mobilepushshort}} Service Web 配置儀表板中新增 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) API 金鑰及網站 URL。如需相關資訊，請參閱 Chrome 設定下的[配置 Google Cloud Messaging 的認證](t_push_provider_android.html)。 + +- 若要從 Mozilla Firefox 登錄，請在 Bluemix {{site.data.keyword.mobilepushshort}} Service Web 配置儀表板的 Firefox 設定下新增網站 URL。 + +使用下列程式碼 Snippet，在 Bluemix {{site.data.keyword.mobilepushshort}} Service 中登錄。 + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + "websitePushIDSafari": "Optional parameter for Safari Push Notifications only. The value should match the website Push ID provided during the server side configuration." + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + + + diff --git a/services/mobilepush/nl/zh/TW/c_chrome_firefox_enable_send.md b/services/mobilepush/nl/zh/TW/c_chrome_firefox_enable_send.md index 0a640dda6..29c76f9f5 100644 --- a/services/mobilepush/nl/zh/TW/c_chrome_firefox_enable_send.md +++ b/services/mobilepush/nl/zh/TW/c_chrome_firefox_enable_send.md @@ -1,43 +1,43 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 將基本通知傳送至 Web 瀏覽器 -{: #web_notifications} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - -開發應用程式之後，您可以傳送推送通知。 - -1. 選取**傳送通知**，然後選擇 **Web 通知**作為**傳送至**選項來編寫訊息。 -2. 在**訊息**欄位中，鍵入需要遞送的訊息。 -3. 您可以選擇提供選用設定： - - **通知標題**：這是將顯示為訊息警示標題的文字。 - - **通知圖示 URL**：如果需要使用應用程式通知圖示來遞送您的訊息，請在此欄位中提供該圖示的鏈結。 - - **存活時間**：通知伺服器訊息的有效性。 -4. 針對傳送給 Safari 瀏覽器的 Web 通知，還需要一些其他資訊： - - **動作**：這是動作按鈕的標籤。 - - **URL 引數**：需要與此通知一起使用的 URL 引數。請確定這是以 JSON 陣列的格式提供。 - -下列影像顯示儀表板中的 Web 通知選項。 - - ![通知畫面](images/DashboardWebpush.jpg) - - -## 後續步驟 - {: #next_steps_tags} - -順利設定基本通知之後，即可選擇配置標籤型通知及進階選項。 - -將這些 {{site.data.keyword.mobilepushshort}} Service 特性新增至您的應用程式。若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。若要使用進階通知選項，請參閱[進階通知](t_advance_badge_sound_payload.html)。 - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 將基本通知傳送至 Web 瀏覽器 +{: #web_notifications} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + +開發應用程式之後，您可以傳送推送通知。 + +1. 選取**傳送通知**，然後選擇 **Web 通知**作為**傳送至**選項來編寫訊息。 +2. 在**訊息**欄位中，鍵入需要遞送的訊息。 +3. 您可以選擇提供選用設定： + - **通知標題**：這是將顯示為訊息警示標題的文字。 + - **通知圖示 URL**：如果需要使用應用程式通知圖示來遞送您的訊息，請在此欄位中提供該圖示的鏈結。 + - **存活時間**：通知伺服器訊息的有效性。 +4. 針對傳送給 Safari 瀏覽器的 Web 通知，還需要一些其他資訊： + - **動作**：這是動作按鈕的標籤。 + - **URL 引數**：需要與此通知一起使用的 URL 引數。請確定這是以 JSON 陣列的格式提供。 + +下列影像顯示儀表板中的 Web 通知選項。 + + ![通知畫面](images/DashboardWebpush.jpg) + + +## 後續步驟 + {: #next_steps_tags} + +順利設定基本通知之後，即可選擇配置標籤型通知及進階選項。 + +將這些 {{site.data.keyword.mobilepushshort}} Service 特性新增至您的應用程式。若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。若要使用進階通知選項，請參閱[進階通知](t_advance_badge_sound_payload.html)。 + + + diff --git a/services/mobilepush/nl/zh/TW/c_cordova_enable.md b/services/mobilepush/nl/zh/TW/c_cordova_enable.md index f7c4c4873..50c42356b 100644 --- a/services/mobilepush/nl/zh/TW/c_cordova_enable.md +++ b/services/mobilepush/nl/zh/TW/c_cordova_enable.md @@ -1,315 +1,315 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 讓 Cordova 應用程式可接收推送通知 -{: #cordova_enable} -前次更新：2017 年 1 月 18 日 -{: .last-updated} - -Cordova 是一個平台，可使用 JavaScript、CSS 及 HTML 來建置混合式應用程式。{{site.data.keyword.mobilepushshort}} 服務支援開發 Cordova 型 iOS 及 Android 應用程式。 - -您可以啟用 Cordova 應用程式來接收傳送至您裝置的推送通知。 - -## 安裝 Cordova Push 外掛程式 -{: #cordova_install} - -安裝及使用 Client Push 外掛程式來進一步開發 Cordova 應用程式。這也會安裝起始設定您的 Bluemix 連線的 Cordova Core 外掛程式。 - -### 開始之前 - -1. 下載最新的 Android Studio SDK 及 Xcode 版本。 -1. 設定您的模擬器。若為 Android Studio，請使用支援 Google Play API 的模擬器。 -1. 安裝 Git 指令行工具。若為 Windows，請確保選取**從 Windows 命令提示字元執行 Git** 選項。如需如何下載及安裝此工具的相關資訊，請參閱 [Git ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://git-scm.com/downloads){: new_window}。 -1. 安裝 Node.js 及「Node 套件管理程式 (NPM)」工具。NPM 指令行工具與 Node.js 組合在一起。如需如何下載及安裝 Node.js 的相關資訊，請參閱 [Node.js ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://nodejs.org/en/download/){: new_window}。 -1. 從指令行中，使用 **npm install -g cordova** 指令來安裝 Cordova 指令行工具。若要使用 Cordova Push 外掛程式，這是必要動作。如需如何安裝 Cordova 以及設定 Cordova 應用程式的相關資訊，請參閱 [Cordova Apache ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://cordova.apache.org/#getstarted){: new_window}。如需相關資訊，請參閱 Cordova Push 外掛程式 [Readme 檔 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window}。 -1. 切換至您要在其中建立 Cordova 應用程式的資料夾，並執行下列指令來建立 Cordova 應用程式。如果您有現存的 Cordova 應用程式，請移至步驟 3。 -```cordova create your_app_name -cd your_app_name -``` - {: codeblock} -- 選用項目：您可以編輯 **config.xml** 檔案，並將 元素中的應用程式名稱變更為您選擇的名稱，而不是預設 HelloCordova 名稱。 - -請確定您指定正確的「軟體組 ID」。如果指定不正確的「軟體組 ID」，則下列錯誤訊息可能會導致 Xcode。 - -* 以無效的授權簽署執行檔。 -* 應用程式的「程式碼簽署授權」檔案中指定的授權，不符合佈建設定檔中指定的授權。若要修正此問題，請在 Xcode 或 Cordova 應用程式 **config.xml** 檔案中指定正確的「軟體組 ID」。 - -1. 將最低支援的 API 或部署目標宣告新增至 Cordova 應用程式的 config.xml 檔案。minSdkVersion 值必須高於 15。targetSdkVersion 值必須一律反映可從 Google 取得的最新 Android SDK。 - - * Android - 使用編輯器來開啟 **config.xml** 檔案，並將 -`` 元素更新為最小及目標 SDK 版本： - - ``` - - - - - - ``` - {: codeblock} - - * iOS - 使用部署目標宣告更新 元素： - - ``` - - - - - ``` - {: codeblock} - -1. 從 Cordova 指令行介面 (CLI) 中，使用下列指令新增平台：iOS 及（或）Android： -``` -cordova platform add ios -cordova platform add android -``` - {: codeblock} - -1. 從 Cordova 應用程式根目錄中，輸入下列指令來安裝 Cordova Push 外掛程式：**cordova plugin add bms-push**。根據您新增的平台，您可能會看到： -``` -Installing "bms-push" for android -Installing "bms-push" for ios -``` - {: codeblock} - -1. 從 your-app-root-folder 中，使用下列指令，驗證已順利安裝 Cordova Core 及 Push 外掛程式：**cordova plugin list**。根據您新增的平台，您可能會看到： -``` -bms-core "BMSCore" -bms-push "BMSPush" -``` - {: codeblock} - -1. 配置您的 iOS 開發環境。 -2. 使用 Xcode 建置並執行應用程式。 -1. 下載針對 Android 使用的 Firebase `google-services.json`，並且將他們放置在 Cordova 專案的根資料夾：[your-app-name]/platforms/android。 - 1. 請移至 `[your-app-name]/platforms/android`。 - 2. 開啟 `build.gradle` 檔案（路徑：platform > android > build.gradle）。 - 3. 在 `build.gradle` 檔案中尋找 `buildscript` 文字。 - 4. 在類別路徑行之後，新增此行：classpath 'com.google.gms:google-services:3.0.0' - 5. 然後，尋找 "dependencies"。選取 `compile` 文字的相依關係以及選取要於何處結束該相依關係，在此之後，新增此行 :apply plugin: 'com.google.gms.google-services'。 - 6. 準備及建置您的 Cordova Android 專案。 - ``` - cordova prepare android - cordova build android - ``` - {: codeblock} - **附註**：在 Android Studio 中開啟專案之前，請先透過 Cordova CLI 建置 Cordova 應用程式。這將有助於避免建置錯誤。 - -## 起始設定 Cordova 外掛程式 -{: #cordova_initialize} - -您需要透過傳遞應用程式路徑及應用程式 GUID 來起始設定 {{site.data.keyword.mobilepushshort}} Service Cordova 外掛程式，才能使用該外掛程式。在起始設定外掛程式之後，您可以連接至在 Bluemix 儀表板中所建立的伺服器應用程式。Cordova 外掛程式是 Android 及 iOS Client SDK 的封套，可讓 Cordova 應用程式與 Bluemix 服務通訊。 - -1. 複製下列程式碼 Snippet，並將其貼入您的主要 JavaScript 檔案（通常位於 **www/js** 目錄下），以起始設定 BMSClient。 - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("YOUR APP REGION"); - var category = {}; - BMSPush.initialize(appGUID,clientSecret,category); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); - } -``` - {: codeblock} - -傳入應用程式的地區。會提供以下常數： - -``` -REGION_US_SOUTH // ".ng.bluemix.net"; -REGION_UK //".eu-gb.bluemix.net"; -REGION_SYDNEY // ".au-syd.bluemix.net"; -``` - -例如： - -``` -BMSClient.initialize(BMSClient.REGION_US_SOUTH); -``` - -**附註**：如果您已使用 Cordova CLI（例如，Cordova create app-name 指令）建立 Cordova 應用程式，請將此 JavaScript 程式碼放置在 index.js 檔案中 onDeviceReady: function() 函數內的 app.receivedEvent 函數後面，以起始設定 `BMSClient`。 - - -## 登錄裝置 -{: #cordova_register} - - -若要向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置，請呼叫 register 方法。將下列程式碼 Snippet 複製至 Cordova 應用程式，以登錄裝置。 - -``` -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); -``` - {: codeblock} - -下列 JavaScript 程式碼 Snippet 顯示如何起始設定 Bluemix Mobile Services Push Client SDK、向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置，以及接聽推送通知。請在 Javascript 檔案中包含此程式碼。 - -在 **onDeviceReady: function()** 內。 - -``` -onDeviceReady: function() { -app.receivedEvent('deviceready'); -BMSClient.initialize("YOUR APP REGION"); -var success = function(message) { console.log("Success: " + message); }; -var failure = function(message) { console.log("Error: " + message); }; -BMSPush.registerDevice({}, success, failure); - var showNotification = function(notif) - { - alert(JSON.stringify(notif)); - }; -BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 - -``` -// Register the device token with Bluemix Push Notification Service -func application(application: UIApplication, - didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { - CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) -} -// Handle error when failed to register device token with APNs -func application(application: UIApplication, - didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) -} -``` - {: codeblock} - -##後續步驟 - -{: #cordova_register_next} - -使用下列指令建置專案，然後執行專案： - -####Android -{: android-next-steps} - -``` -cordova build android -``` - {: codeblock} - -``` -cordova run android -``` - {: codeblock} - -####iOS -{: ios-next-steps} - -``` -cordova build ios -``` - {: codeblock} - -``` -cordova run ios -``` - {: codeblock} - -## 在裝置上接收推送通知 -{: #cordova_receive} - -複製下列程式碼 Snippet，以在裝置上接收推送通知。 - -###JavaScript - -將下列 JavaScript 程式碼 Snippet 新增至 Cordova 應用程式的 Web 組件。 -``` -var showNotification = function(notif) { - alert(JSON.stringify(notif)); - }; - BMSPush.registerNotificationsCallback(showNotification); -``` - {: codeblock} - -###Android 通知內容 - -下節列出 Android 通知內容： - -* **message** - 推送通知訊息 -* **payload** - 包含通知有效負載的 JSON 物件 - - -###iOS 通知內容 - -下節列出 iOS 通知內容： - -* **message** - 推送通知訊息 -* **payload** - 包含通知有效負載的 JSON 物件 -* **action-loc-key** - 此字串用來作為索引鍵，在現行本地化中取得一個本地化字串，以用於適當的按鈕標題，而取代 `View`。 -* **badge** - 顯示為應用程式圖示徽章的號碼。如果沒有此內容，則不會變更徽章。若要移除徽章，請將此內容的值設為 0。 -* **sound** - 應用程式組合或者應用程式資料容器之 Library/Sounds 資料夾中的音效檔名稱。 - - -將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 -``` -// Handle receiving a remote notification -func application(application: UIApplication, - didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) -} -``` - {: codeblock} - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool - { - let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary - if remoteNotif != nil { - CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) - } -} -``` - {: codeblock} - -## 傳送基本推送通知 -{: #push-send-notifications} - -開發應用程式之後，您可以傳送基本推送通知。 - -若要傳送基本推送通知，請完成下列步驟： - -1. 選取**傳送通知**，然後選擇**傳送至**選項來編寫訊息。支援的選項是**依標籤的裝置**、**裝置 ID**、**使用者 ID**、**Android 裝置**、**iOS 裝置**、**Web 通知**及**所有裝置**。 -**附註**：當您選取**所有裝置**選項時，所有已訂閱 {{site.data.keyword.mobilepushshort}} 的裝置都會接收到通知。![通知畫面](images/tag_notification.jpg) - -2. 在**訊息**欄位中，編寫訊息。視需要選擇配置選用設定。 -3. 按一下**傳送**。 -3. 驗證您的裝置已接收到通知。 - -下列擷取畫面顯示在 Android 及 iOS 裝置的前景中處理 {{site.data.keyword.mobilepushshort}} 的警示框。 - -![Android 上的前景推送通知](images/Android_Screenshot.jpg) - -![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) - - 下列影像在 Android 的背景中顯示 {{site.data.keyword.mobilepushshort}}。 -![Android 上的背景推送通知](images/background.jpg) - -## 後續步驟 -{: #next_steps_tags} - -順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 - -將 {{site.data.keyword.mobilepushshort}} Service 特性新增至您的應用程式。若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 -若要使用進階通知選項，請參閱[啟用進階推送通知](t_advance_badge_sound_payload.html)。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 讓 Cordova 應用程式可接收推送通知 +{: #cordova_enable} +前次更新：2017 年 1 月 18 日 +{: .last-updated} + +Cordova 是一個平台，可使用 JavaScript、CSS 及 HTML 來建置混合式應用程式。{{site.data.keyword.mobilepushshort}} 服務支援開發 Cordova 型 iOS 及 Android 應用程式。 + +您可以啟用 Cordova 應用程式來接收傳送至您裝置的推送通知。 + +## 安裝 Cordova Push 外掛程式 +{: #cordova_install} + +安裝及使用 Client Push 外掛程式來進一步開發 Cordova 應用程式。這也會安裝起始設定您的 Bluemix 連線的 Cordova Core 外掛程式。 + +### 開始之前 + +1. 下載最新的 Android Studio SDK 及 Xcode 版本。 +1. 設定您的模擬器。若為 Android Studio，請使用支援 Google Play API 的模擬器。 +1. 安裝 Git 指令行工具。若為 Windows，請確保選取**從 Windows 命令提示字元執行 Git** 選項。如需如何下載及安裝此工具的相關資訊，請參閱 [Git ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://git-scm.com/downloads){: new_window}。 +1. 安裝 Node.js 及「Node 套件管理程式 (NPM)」工具。NPM 指令行工具與 Node.js 組合在一起。如需如何下載及安裝 Node.js 的相關資訊，請參閱 [Node.js ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://nodejs.org/en/download/){: new_window}。 +1. 從指令行中，使用 **npm install -g cordova** 指令來安裝 Cordova 指令行工具。若要使用 Cordova Push 外掛程式，這是必要動作。如需如何安裝 Cordova 以及設定 Cordova 應用程式的相關資訊，請參閱 [Cordova Apache ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://cordova.apache.org/#getstarted){: new_window}。如需相關資訊，請參閱 Cordova Push 外掛程式 [Readme 檔 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window}。 +1. 切換至您要在其中建立 Cordova 應用程式的資料夾，並執行下列指令來建立 Cordova 應用程式。如果您有現存的 Cordova 應用程式，請移至步驟 3。 +```cordova create your_app_name +cd your_app_name +``` + {: codeblock} +- 選用項目：您可以編輯 **config.xml** 檔案，並將 元素中的應用程式名稱變更為您選擇的名稱，而不是預設 HelloCordova 名稱。 + +請確定您指定正確的「軟體組 ID」。如果指定不正確的「軟體組 ID」，則下列錯誤訊息可能會導致 Xcode。 + +* 以無效的授權簽署執行檔。 +* 應用程式的「程式碼簽署授權」檔案中指定的授權，不符合佈建設定檔中指定的授權。若要修正此問題，請在 Xcode 或 Cordova 應用程式 **config.xml** 檔案中指定正確的「軟體組 ID」。 + +1. 將最低支援的 API 或部署目標宣告新增至 Cordova 應用程式的 config.xml 檔案。minSdkVersion 值必須高於 15。targetSdkVersion 值必須一律反映可從 Google 取得的最新 Android SDK。 + + * Android - 使用編輯器來開啟 **config.xml** 檔案，並將 +`` 元素更新為最小及目標 SDK 版本： + + ``` + + + + + + ``` + {: codeblock} + + * iOS - 使用部署目標宣告更新 元素： + + ``` + + + + + ``` + {: codeblock} + +1. 從 Cordova 指令行介面 (CLI) 中，使用下列指令新增平台：iOS 及（或）Android： +``` +cordova platform add ios +cordova platform add android +``` + {: codeblock} + +1. 從 Cordova 應用程式根目錄中，輸入下列指令來安裝 Cordova Push 外掛程式：**cordova plugin add bms-push**。根據您新增的平台，您可能會看到： +``` +Installing "bms-push" for android +Installing "bms-push" for ios +``` + {: codeblock} + +1. 從 your-app-root-folder 中，使用下列指令，驗證已順利安裝 Cordova Core 及 Push 外掛程式：**cordova plugin list**。根據您新增的平台，您可能會看到： +``` +bms-core "BMSCore" +bms-push "BMSPush" +``` + {: codeblock} + +1. 配置您的 iOS 開發環境。 +2. 使用 Xcode 建置並執行應用程式。 +1. 下載針對 Android 使用的 Firebase `google-services.json`，並且將他們放置在 Cordova 專案的根資料夾：[your-app-name]/platforms/android。 + 1. 請移至 `[your-app-name]/platforms/android`。 + 2. 開啟 `build.gradle` 檔案（路徑：platform > android > build.gradle）。 + 3. 在 `build.gradle` 檔案中尋找 `buildscript` 文字。 + 4. 在類別路徑行之後，新增此行：classpath 'com.google.gms:google-services:3.0.0' + 5. 然後，尋找 "dependencies"。選取 `compile` 文字的相依關係以及選取要於何處結束該相依關係，在此之後，新增此行 :apply plugin: 'com.google.gms.google-services'。 + 6. 準備及建置您的 Cordova Android 專案。 + ``` + cordova prepare android + cordova build android + ``` + {: codeblock} + **附註**：在 Android Studio 中開啟專案之前，請先透過 Cordova CLI 建置 Cordova 應用程式。這將有助於避免建置錯誤。 + +## 起始設定 Cordova 外掛程式 +{: #cordova_initialize} + +您需要透過傳遞應用程式路徑及應用程式 GUID 來起始設定 {{site.data.keyword.mobilepushshort}} Service Cordova 外掛程式，才能使用該外掛程式。在起始設定外掛程式之後，您可以連接至在 Bluemix 儀表板中所建立的伺服器應用程式。Cordova 外掛程式是 Android 及 iOS Client SDK 的封套，可讓 Cordova 應用程式與 Bluemix 服務通訊。 + +1. 複製下列程式碼 Snippet，並將其貼入您的主要 JavaScript 檔案（通常位於 **www/js** 目錄下），以起始設定 BMSClient。 + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("YOUR APP REGION"); + var category = {}; + BMSPush.initialize(appGUID,clientSecret,category); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); + } +``` + {: codeblock} + +傳入應用程式的地區。會提供以下常數： + +``` +REGION_US_SOUTH // ".ng.bluemix.net"; +REGION_UK //".eu-gb.bluemix.net"; +REGION_SYDNEY // ".au-syd.bluemix.net"; +``` + +例如： + +``` +BMSClient.initialize(BMSClient.REGION_US_SOUTH); +``` + +**附註**：如果您已使用 Cordova CLI（例如，Cordova create app-name 指令）建立 Cordova 應用程式，請將此 JavaScript 程式碼放置在 index.js 檔案中 onDeviceReady: function() 函數內的 app.receivedEvent 函數後面，以起始設定 `BMSClient`。 + + +## 登錄裝置 +{: #cordova_register} + + +若要向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置，請呼叫 register 方法。將下列程式碼 Snippet 複製至 Cordova 應用程式，以登錄裝置。 + +``` +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); +``` + {: codeblock} + +下列 JavaScript 程式碼 Snippet 顯示如何起始設定 Bluemix Mobile Services Push Client SDK、向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置，以及接聽推送通知。請在 Javascript 檔案中包含此程式碼。 + +在 **onDeviceReady: function()** 內。 + +``` +onDeviceReady: function() { +app.receivedEvent('deviceready'); +BMSClient.initialize("YOUR APP REGION"); +var success = function(message) { console.log("Success: " + message); }; +var failure = function(message) { console.log("Error: " + message); }; +BMSPush.registerDevice({}, success, failure); + var showNotification = function(notif) + { + alert(JSON.stringify(notif)); + }; +BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 + +``` +// Register the device token with Bluemix Push Notification Service +func application(application: UIApplication, + didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) { + CDVBMSPush.sharedInstance().didRegisterForRemoteNotificationsWithDeviceToken(deviceToken) +} +// Handle error when failed to register device token with APNs +func application(application: UIApplication, + didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(error) +} +``` + {: codeblock} + +## 後續步驟 + +{: #cordova_register_next} + +使用下列指令建置專案，然後執行專案： + +#### Android +{: android-next-steps} + +``` +cordova build android +``` + {: codeblock} + +``` +cordova run android +``` + {: codeblock} + +#### iOS +{: ios-next-steps} + +``` +cordova build ios +``` + {: codeblock} + +``` +cordova run ios +``` + {: codeblock} + +## 在裝置上接收推送通知 +{: #cordova_receive} + +複製下列程式碼 Snippet，以在裝置上接收推送通知。 + +### JavaScript + +將下列 JavaScript 程式碼 Snippet 新增至 Cordova 應用程式的 Web 組件。 +``` +var showNotification = function(notif) { + alert(JSON.stringify(notif)); + }; + BMSPush.registerNotificationsCallback(showNotification); +``` + {: codeblock} + +### Android 通知內容 + +下節列出 Android 通知內容： + +* **message** - 推送通知訊息 +* **payload** - 包含通知有效負載的 JSON 物件 + + +### iOS 通知內容 + +下節列出 iOS 通知內容： + +* **message** - 推送通知訊息 +* **payload** - 包含通知有效負載的 JSON 物件 +* **action-loc-key** - 此字串用來作為索引鍵，在現行本地化中取得一個本地化字串，以用於適當的按鈕標題，而取代 `View`。 +* **badge** - 顯示為應用程式圖示徽章的號碼。如果沒有此內容，則不會變更徽章。若要移除徽章，請將此內容的值設為 0。 +* **sound** - 應用程式組合或者應用程式資料容器之 Library/Sounds 資料夾中的音效檔名稱。 + + +將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 +``` +// Handle receiving a remote notification +func application(application: UIApplication, + didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ) { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationWithNotification(userInfo) +} +``` + {: codeblock} + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool + { + let remoteNotif = launchOptions?[UIApplicationLaunchOptionsKey.remoteNotification] as? NSDictionary + if remoteNotif != nil { + CDVBMSPush.sharedInstance().didReceiveRemoteNotificationOnLaunchWithLaunchOptions(launchOptions) + } +} +``` + {: codeblock} + +## 傳送基本推送通知 +{: #push-send-notifications} + +開發應用程式之後，您可以傳送基本推送通知。 + +若要傳送基本推送通知，請完成下列步驟： + +1. 選取**傳送通知**，然後選擇**傳送至**選項來編寫訊息。支援的選項是**依標籤的裝置**、**裝置 ID**、**使用者 ID**、**Android 裝置**、**iOS 裝置**、**Web 通知**及**所有裝置**。 +**附註**：當您選取**所有裝置**選項時，所有已訂閱 {{site.data.keyword.mobilepushshort}} 的裝置都會接收到通知。![通知畫面](images/tag_notification.jpg) + +2. 在**訊息**欄位中，編寫訊息。視需要選擇配置選用設定。 +3. 按一下**傳送**。 +3. 驗證您的裝置已接收到通知。 + +下列擷取畫面顯示在 Android 及 iOS 裝置的前景中處理 {{site.data.keyword.mobilepushshort}} 的警示框。 + +![Android 上的前景推送通知](images/Android_Screenshot.jpg) + +![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) + + 下列影像在 Android 的背景中顯示 {{site.data.keyword.mobilepushshort}}。 +![Android 上的背景推送通知](images/background.jpg) + +## 後續步驟 +{: #next_steps_tags} + +順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 + +將 {{site.data.keyword.mobilepushshort}} Service 特性新增至您的應用程式。若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 +若要使用進階通知選項，請參閱[啟用進階推送通知](t_advance_badge_sound_payload.html)。 diff --git a/services/mobilepush/nl/zh/TW/c_enable_push.md b/services/mobilepush/nl/zh/TW/c_enable_push.md index 9dca787c7..394094cd9 100644 --- a/services/mobilepush/nl/zh/TW/c_enable_push.md +++ b/services/mobilepush/nl/zh/TW/c_enable_push.md @@ -1,25 +1,25 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 啟用行動裝置的通知 -{: #c_enable_push-notifications} -前次更新：2017 年 1 月 18 日 -{: .last-updated} - -請確定您已通過[配置通知提供者的認證](t__main_push_config_provider.html)。 - -本節說明如何啟用用戶端應用程式（行動裝置、Web 瀏覽器應用程式以及 Chrome Apps and Extensions）來接收推送通知、如何建立基本通知、取得及起始設定 SDK 或外掛程式，以及如何登錄裝置或瀏覽器來接收推送通知。您也可以使用 [REST API](t_restapi.html)，讓行動及 Web 瀏覽器應用程式接收推送通知。 - -**附註**：對於裝置、瀏覽器及 Chrome Apps and Extensions 登錄，{{site.data.keyword.mobilepushshort}} Service 會對從通知提供者（APNs for Apple 或 FCM for Google）發出的記號保持唯一參照。 -{{site.data.keyword.mobilepushshort}} Service 通知提供者可基於數個原因，而讓這些記號失效。 - -例如，解除安裝裝置上的應用程式期間。在這種情境中，當嘗試根據裝置失效的提供者回應遞送通知時，{{site.data.keyword.mobilepushshort}} Service 將移除裝置或 Web 瀏覽器登錄。接著，這將限制隨後不得將通知傳送至失效裝置。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 啟用行動裝置的通知 +{: #c_enable_push-notifications} +前次更新：2017 年 1 月 18 日 +{: .last-updated} + +請確定您已通過[配置通知提供者的認證](t__main_push_config_provider.html)。 + +本節說明如何啟用用戶端應用程式（行動裝置、Web 瀏覽器應用程式以及 Chrome Apps and Extensions）來接收推送通知、如何建立基本通知、取得及起始設定 SDK 或外掛程式，以及如何登錄裝置或瀏覽器來接收推送通知。您也可以使用 [REST API](t_restapi.html)，讓行動及 Web 瀏覽器應用程式接收推送通知。 + +**附註**：對於裝置、瀏覽器及 Chrome Apps and Extensions 登錄，{{site.data.keyword.mobilepushshort}} Service 會對從通知提供者（APNs for Apple 或 FCM for Google）發出的記號保持唯一參照。 +{{site.data.keyword.mobilepushshort}} Service 通知提供者可基於數個原因，而讓這些記號失效。 + +例如，解除安裝裝置上的應用程式期間。在這種情境中，當嘗試根據裝置失效的提供者回應遞送通知時，{{site.data.keyword.mobilepushshort}} Service 將移除裝置或 Web 瀏覽器登錄。接著，這將限制隨後不得將通知傳送至失效裝置。 diff --git a/services/mobilepush/nl/zh/TW/c_enable_push_webhook.md b/services/mobilepush/nl/zh/TW/c_enable_push_webhook.md index 33f2ece7b..0a2efc9b7 100644 --- a/services/mobilepush/nl/zh/TW/c_enable_push_webhook.md +++ b/services/mobilepush/nl/zh/TW/c_enable_push_webhook.md @@ -1,34 +1,34 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 啟用 Webhook -{: #tag_based_notifications} -前次更新：2017 年 1 月 23 日 -{: .last-updated} - - -使用 {{site.data.keyword.mobilepushshort}} 服務，您可以選擇接收關於已變更資訊的警示。企業資訊的變更會建立事件，您可以將事件登錄為 Webhook 事件，以收到其通知。這些 Webhook 事件會觸發警示。 - -Webhook 是使用者定義的回呼，它們是由例如登錄裝置或訂閱標籤等事件所觸發。在 {{site.data.keyword.mobilepushshort}} 服務上，您可以登錄下列 Webhook 事件： - -- **onDeviceRegister**：裝置登錄推送時會觸發 Webhook 事件。 -- **onDeviceUpdate**：已登錄裝置的相關資訊更新時會觸發 Webhook 事件。 -- **onDeviceUnregister**：取消登錄裝置時會觸發 Webhook 事件。 -- **onSubscribe**：使用者訂閱標籤時會觸發 Webhook 事件。 -- **onUnsubscribe**：使用者取消訂閱標籤時會觸發 Webhook 事件。 -- **onNotificationSend**分派通知時會觸發 Webhook 事件。 -- **onNotificationFailure**通知失敗時會觸發 Webhook 事件。 - - -**附註：**通知分派會以批次處理。訊息分派可以有多個 Webhook 事件，事件可能同時包含失敗和成功。Webhook 事件的 messageID 會與分派訊息的相同。 - -如需 Webhook 的相關資訊，請參閱 [IBM Push Notifications REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 啟用 Webhook +{: #tag_based_notifications} +前次更新：2017 年 1 月 23 日 +{: .last-updated} + + +使用 {{site.data.keyword.mobilepushshort}} 服務，您可以選擇接收關於已變更資訊的警示。企業資訊的變更會建立事件，您可以將事件登錄為 Webhook 事件，以收到其通知。這些 Webhook 事件會觸發警示。 + +Webhook 是使用者定義的回呼，它們是由例如登錄裝置或訂閱標籤等事件所觸發。在 {{site.data.keyword.mobilepushshort}} 服務上，您可以登錄下列 Webhook 事件： + +- **onDeviceRegister**：裝置登錄推送時會觸發 Webhook 事件。 +- **onDeviceUpdate**：已登錄裝置的相關資訊更新時會觸發 Webhook 事件。 +- **onDeviceUnregister**：取消登錄裝置時會觸發 Webhook 事件。 +- **onSubscribe**：使用者訂閱標籤時會觸發 Webhook 事件。 +- **onUnsubscribe**：使用者取消訂閱標籤時會觸發 Webhook 事件。 +- **onNotificationSend**分派通知時會觸發 Webhook 事件。 +- **onNotificationFailure**通知失敗時會觸發 Webhook 事件。 + + +**附註：**通知分派會以批次處理。訊息分派可以有多個 Webhook 事件，事件可能同時包含失敗和成功。Webhook 事件的 messageID 會與分派訊息的相同。 + +如需 Webhook 的相關資訊，請參閱 [IBM Push Notifications REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/#/webhooks){: new_window}。 diff --git a/services/mobilepush/nl/zh/TW/c_ios_enable.md b/services/mobilepush/nl/zh/TW/c_ios_enable.md index 31d1e6da4..ed24d2211 100644 --- a/services/mobilepush/nl/zh/TW/c_ios_enable.md +++ b/services/mobilepush/nl/zh/TW/c_ios_enable.md @@ -1,333 +1,333 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#啟用 iOS 應用程式來傳送 {{site.data.keyword.mobilepushshort}} -{: #enable-push-ios-notifications} -前次更新：2017 年 2 月 14 日 -{: .last-updated} - -您可讓 iOS 應用程式傳送 {{site.data.keyword.mobilepushshort}} 至您的裝置。 - - -##安裝 CocoaPods -{: #enable-push-ios-notifications-install} - -針對現有的 Xcode 專案，您可以使用 CocoaPods 相依關係管理工具來設定 Bluemix Mobile Services Client SDK。替代方案是手動安裝 SDK。 - -若要檢視 Swift Push Readme 檔，請移至 [Readme ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}。 - - - -1. 在 Mac 終端機中，使用下列指令來安裝 CocoaPods。 -```$ sudo gem install cocoapods -``` - {: codeblock} -2. 在終端機中輸入 `pod init` 指令，以起始設定 CocoaPods。請確定您從 Xcode 專案所在的目錄執行指令。`pod init` 指令會建立 Podfile。 -3. 在產生的 Podfile 中，新增必要 SDK 相依關係。請複製下列 Podfile。 - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - pod 'BMSAnalyticsAPI' - end - ``` - {: codeblock} - -3. 從終端機中，移至您的專案資料夾，並使用 `pod update` 指令來安裝相依關係。 - -此指令會安裝相依關係並建立新的 Xcode 工作區。 -**附註**：請確定您一律開啟新的 Xcode 工作區，而不是原始 Xcode 專案檔： -``` -$ open App.xcworkspace -``` - {: codeblock} - -工作區會包含原始專案以及包含相依關係的 Pods 專案。若要修改 Bluemix Mobile Services 來源資料夾，您可以在 Pods 專案的 `Pods/yourImportedSourceFolder` 下找到它，例如：`Pods/BMSPush`。 - -##使用 Carthage 新增架構 -{: #carthage} - -使用 [Carthage ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}，將架構新增至您的專案。請注意，不支援 Xcode8 形式的 Carthage。 - -1. 在 Cartfile 中新增 `BMSPush` 架構： -``` -github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" -``` - {: codeblock} -2. 執行 `carthage update` 指令。建置完成時，請將 `BMSPush.framework`、`BMSCore.framework` 及 `BMSAnalyticsAPI.framework` 拖曳至 Xcode 專案。 -3. 遵循在 [Carthage ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} 網站的指示，以完成整合。 - -##設定 iOS SDK -{: ios-sdk} - -設定 iOS SDK，並新增下列程式碼至應用程式中的 **AppDelegate.swift** 檔案。請注意，這也會使用 APNs 登錄。 -``` -func application(_ application: UIApplication, -didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool - { - BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") - } -``` - {: codeblock} - -##使用匯入的架構和來源資料夾 -{: using-imported-frameworks} - -在您的程式碼中參照 SDK。請確定已具備下列必備項目。 - -- iOS 8.0 或以上版本 -- Xcode 7 - -撰寫相關標頭的 `#import` 指引，例如： -``` -//swift -import BMSCore -import BMSPush -``` - {: codeblock} - -若要閱讀 Swift Push Readme 檔案，請參閱 [Readme ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}。 - -**附註**：使用 CocoaPods 指令 `pod install` 或 `pod update` 更新 Pods 專案時，可能會置換 Bluemix Mobile Services 來源資料夾。如果您要保留原始檔案的自訂版本，請確保先進行備份，然後再發出下列其中一個指令。 - - -##建置設定 -{: build-settings} - -移至 **Xcode > 建置設定 > 建置選項，然後將啟用位元碼**設為**否**。 - -**注意**：自 iOS 9 開始，對「應用程式傳輸安全 (ATS)」特性進行的變更可能會影響您處理鑑別處理程序的方式。下列部落格文章說明這些變更的相關資訊：[ATS and Bitcode in iOS 9 ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} and [Connect your iOS 9 app to Bluemix today ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}。 - -## 起始設定 Push SDK for iOS 應用程式 -{: #enable-push-ios-notifications-initialize} - -放置起始設定碼的一般位置位於 iOS 應用程式的應用程式委派中。按一下「Push 儀表板」中的**行動選項**鏈結，以取得應用程式路徑及 GUID。 - -###起始設定 Core SDK -{: Initializing-the-core-sdk} - - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance -myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") -``` - {: codeblock} - -### 路徑、GUID 及 Bluemix 地區 -{: route-guid-bluemix-region} - -####appRoute -{: ios-approute} - -指定指派給您在 Bluemix 上所建立之伺服器應用程式的路徑。 - -####GUID -{: ios-guid} - -指定指派給您在 Bluemix 上所建立之應用程式的唯一索引鍵。此值區分大小寫。 - -####bluemixRegionSuffix -{: ios-bluemixRegionSuffix} - -指定管理應用程式的位置。`bluemixRegion` 參數指定您所使用的 Bluemix 部署。您可以使用 `BMSClient.REGION` 靜態內容設定此值，然後使用下列三個值的其中一個： - -- BMSClient.Region.usSouth -- BMSClient.Region.unitedKingdom -- BMSClient.Region.sydney - -####AppGUID -{: ios-AppGUID} - -指定指派給您在 Bluemix 上所建立之 {{site.data.keyword.mobilepushshort}} Service 的唯一 AppGUID 索引鍵。 - -###起始設定 Client Push SDK -{: initializing-the-client-Push-SDK} - -``` - //Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -## 登錄 iOS 應用程式及裝置 -{: #enable-push-ios-notifications-register} - - -在裝置上安裝應用程式之後，應用程式必須向 APNs 登錄才能接收遠端通知。在應用程式接收到 APNs 所產生的裝置記號之後，必須將裝置記號傳回給 {{site.data.keyword.mobilepushshort}} Service。 - -若要登錄 iOS 應用程式及裝置，您需要： - -1. 建立後端應用程式。 -2. 將記號傳遞至 {{site.data.keyword.mobilepushshort}}。 - - -###建立後端應用程式 -{: create-a-backend-app} - -在 Bluemix® 型錄的「樣板」區段中建立後端應用程式，以自動將 {{site.data.keyword.mobilepushshort}} Service 連結至此應用程式。如果您已建立後端應用程式，請確定將應用程式連結至 {{site.data.keyword.mobilepushshort}} Service。 - - -###將記號傳遞至 {{site.data.keyword.mobilepushshort}} -{: pass-token-push-notifications} - -從 APNs 接收到記號之後，將記號傳遞至 {{site.data.keyword.mobilepushshort}}，這是 `registerWithDeviceToken` 方法的一部分。 - -從 APNs 接收到記號之後，將記號傳遞至 Push Notifications，這是 `didRegisterForRemoteNotificationsWithDeviceToken` 方法的一部分。 - -``` -func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ - let push = BMSPushClient.sharedInstance - push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - } -``` - {: codeblock} - - -## 在 iOS 裝置上接收推送通知 -{: #enable-push-ios-notifications-receiving} - - -若要在 iOS 裝置上接收推送通知，請將下列 Swift 方法新增至應用程式的應用程式委派。 - -``` -// For Swift -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) -{ //UserInfo dictionary will contain data sent from the server } -``` - {: codeblock} - -## 監視 iOS 裝置上的推送通知 -{: ios-monitoring} - -若要監視通知的現行狀態，請將下列 Swift 方法新增至應用程式的應用程式委派。 - -``` - // Send notification status when app is opened by clicking the notifications -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - print("Send message status to the Push server") - } -} -``` - {: codeblock} - -``` - // Send notification status when the app is in background mode. -func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { - let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) - self.showAlert(title: "Recieved Push notifications", message: payLoad) - let push = BMSPushClient.sharedInstance - let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String - let data = respJson.data(using: String.Encoding.utf8) - let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary - let messageId:String = jsonResponse.value(forKey: "nid") as! String - push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in - completionHandler(UIBackgroundFetchResult.newData) - } -} -``` - {: codeblock} - - -## 傳送基本推送通知 -{: #send} - -開發應用程式之後，您可以傳送基本推送通知。 - -若要傳送基本推送通知，請完成下列步驟： - -1. 選取**傳送通知**，然後選擇**傳送至**選項來編寫訊息。支援的選項是**依標籤的裝置**、**裝置 ID**、**使用者 ID**、**Android 裝置**、**iOS 裝置**、**Web 通知**及**所有裝置**。 -**附註**：當您選取**所有裝置**選項時，所有已訂閱 {{site.data.keyword.mobilepushshort}} 的裝置都會接收到通知。![通知畫面](images/tag_notification.jpg) - -2. 在**訊息**欄位中，編寫訊息。視需要選擇配置選用設定。 -3. 按一下**傳送**。 -3. 驗證您的裝置已接收到通知。 - -下列影像顯示處理 {{site.data.keyword.mobilepushshort}} iOS 裝置的警示框。 - -![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) - -### 傳送通知的選用設定 -{: #send_ios_otpional_setting} - -您可以進一步自訂 {{site.data.keyword.mobilepushshort}} 設定，以將通知傳送給 iOS 裝置。支援下列選用自訂選項。 - - -- **徽章**：指出應用程式徽章上所顯示的號碼。預設值是零 (0)，而且這不會顯示徽章。 -- **音效**：指出要在收到通知時播放的音效短片。支援預設值或應用程式中所組合的音效資源名稱。 -- **其他有效負載**：指定通知的自訂有效負載值。 - -##啟用互動式通知 - -現在，您可以使用更多詳細資料強化您的 iOS 通知，例如透過啟用互動式通知來新增影像、地圖或回應按鈕。這樣可提供更多環境定義給客戶，並且能夠立即採取動作而不需要離開現行環境定義。 - -若要啟用互動式通知，請使用下列程式碼： - -``` - // This defines the button action. -let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) -``` - {: codeblock} -``` - // This defines category for the buttons -let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) -``` - {: codeblock} -``` - // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions -let notificationOptions = BMSPushClientOptions(categoryName: [category]) -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) -``` - {: codeblock} - -若要傳送互動式通知，請完成下列步驟： - -1. 在「組合」區段的「傳送至」下拉清單，選取 **iOS 裝置**。 -2. 輸入您可能想要傳送的通知訊息。 -3. 在「選用性設定」區段中，選取**行動**然後按一下 **iOS**。 -4. 在「類型」下拉清單中，選取**混合**。 -5. 在「種類」欄位中，指定您已在應用程式定義的通知類型。 - -![iOS 的互動式通知](images/push_ios_notification_interactive.jpg) - -## 後續步驟 -{: #next_steps_tags} - -順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 - -將這些 Push Notifications Service 特性新增至您的應用程式。 -若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 -若要使用進階通知選項，請參閱[啟用進階推送通知](t_advance_badge_sound_payload.html)。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +#啟用 iOS 應用程式來傳送 {{site.data.keyword.mobilepushshort}} +{: #enable-push-ios-notifications} +前次更新：2017 年 2 月 14 日 +{: .last-updated} + +您可讓 iOS 應用程式傳送 {{site.data.keyword.mobilepushshort}} 至您的裝置。 + + +##安裝 CocoaPods +{: #enable-push-ios-notifications-install} + +針對現有的 Xcode 專案，您可以使用 CocoaPods 相依關係管理工具來設定 Bluemix Mobile Services Client SDK。替代方案是手動安裝 SDK。 + +若要檢視 Swift Push Readme 檔，請移至 [Readme ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}。 + + + +1. 在 Mac 終端機中，使用下列指令來安裝 CocoaPods。 +```$ sudo gem install cocoapods +``` + {: codeblock} +2. 在終端機中輸入 `pod init` 指令，以起始設定 CocoaPods。請確定您從 Xcode 專案所在的目錄執行指令。`pod init` 指令會建立 Podfile。 +3. 在產生的 Podfile 中，新增必要 SDK 相依關係。請複製下列 Podfile。 + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + pod 'BMSAnalyticsAPI' + end + ``` + {: codeblock} + +3. 從終端機中，移至您的專案資料夾，並使用 `pod update` 指令來安裝相依關係。 + +此指令會安裝相依關係並建立新的 Xcode 工作區。 +**附註**：請確定您一律開啟新的 Xcode 工作區，而不是原始 Xcode 專案檔： +``` +$ open App.xcworkspace +``` + {: codeblock} + +工作區會包含原始專案以及包含相依關係的 Pods 專案。若要修改 Bluemix Mobile Services 來源資料夾，您可以在 Pods 專案的 `Pods/yourImportedSourceFolder` 下找到它，例如：`Pods/BMSPush`。 + +##使用 Carthage 新增架構 +{: #carthage} + +使用 [Carthage ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window}，將架構新增至您的專案。請注意，不支援 Xcode8 形式的 Carthage。 + +1. 在 Cartfile 中新增 `BMSPush` 架構： +``` +github "github "ibm-bluemix-mobile-services/bms-clientsdk-swift-push" ~> 1.0" +``` + {: codeblock} +2. 執行 `carthage update` 指令。建置完成時，請將 `BMSPush.framework`、`BMSCore.framework` 及 `BMSAnalyticsAPI.framework` 拖曳至 Xcode 專案。 +3. 遵循在 [Carthage ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos){: new_window} 網站的指示，以完成整合。 + +##設定 iOS SDK +{: ios-sdk} + +設定 iOS SDK，並新增下列程式碼至應用程式中的 **AppDelegate.swift** 檔案。請注意，這也會使用 APNs 登錄。 +``` +func application(_ application: UIApplication, +didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool + { + BMSPushClient.sharedInstance.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE") + } +``` + {: codeblock} + +##使用匯入的架構和來源資料夾 +{: using-imported-frameworks} + +在您的程式碼中參照 SDK。請確定已具備下列必備項目。 + +- iOS 8.0 或以上版本 +- Xcode 7 + +撰寫相關標頭的 `#import` 指引，例如： +``` +//swift +import BMSCore +import BMSPush +``` + {: codeblock} + +若要閱讀 Swift Push Readme 檔案，請參閱 [Readme ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master){: new_window}。 + +**附註**：使用 CocoaPods 指令 `pod install` 或 `pod update` 更新 Pods 專案時，可能會置換 Bluemix Mobile Services 來源資料夾。如果您要保留原始檔案的自訂版本，請確保先進行備份，然後再發出下列其中一個指令。 + + +##建置設定 +{: build-settings} + +移至 **Xcode > 建置設定 > 建置選項，然後將啟用位元碼**設為**否**。 + +**注意**：自 iOS 9 開始，對「應用程式傳輸安全 (ATS)」特性進行的變更可能會影響您處理鑑別處理程序的方式。下列部落格文章說明這些變更的相關資訊：[ATS and Bitcode in iOS 9 ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/){: new_window} and [Connect your iOS 9 app to Bluemix today ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/){: new_window}。 + +## 起始設定 Push SDK for iOS 應用程式 +{: #enable-push-ios-notifications-initialize} + +放置起始設定碼的一般位置位於 iOS 應用程式的應用程式委派中。按一下「Push 儀表板」中的**行動選項**鏈結，以取得應用程式路徑及 GUID。 + +###起始設定 Core SDK +{: Initializing-the-core-sdk} + + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance +myBMSClient.initialize(bluemixRegion: "Location where your app is hosted.") +``` + {: codeblock} + +### 路徑、GUID 及 Bluemix 地區 +{: route-guid-bluemix-region} + +####appRoute +{: ios-approute} + +指定指派給您在 Bluemix 上所建立之伺服器應用程式的路徑。 + +####GUID +{: ios-guid} + +指定指派給您在 Bluemix 上所建立之應用程式的唯一索引鍵。此值區分大小寫。 + +####bluemixRegionSuffix +{: ios-bluemixRegionSuffix} + +指定管理應用程式的位置。`bluemixRegion` 參數指定您所使用的 Bluemix 部署。您可以使用 `BMSClient.REGION` 靜態內容設定此值，然後使用下列三個值的其中一個： + +- BMSClient.Region.usSouth +- BMSClient.Region.unitedKingdom +- BMSClient.Region.sydney + +####AppGUID +{: ios-AppGUID} + +指定指派給您在 Bluemix 上所建立之 {{site.data.keyword.mobilepushshort}} Service 的唯一 AppGUID 索引鍵。 + +###起始設定 Client Push SDK +{: initializing-the-client-Push-SDK} + +``` + //Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +## 登錄 iOS 應用程式及裝置 +{: #enable-push-ios-notifications-register} + + +在裝置上安裝應用程式之後，應用程式必須向 APNs 登錄才能接收遠端通知。在應用程式接收到 APNs 所產生的裝置記號之後，必須將裝置記號傳回給 {{site.data.keyword.mobilepushshort}} Service。 + +若要登錄 iOS 應用程式及裝置，您需要： + +1. 建立後端應用程式。 +2. 將記號傳遞至 {{site.data.keyword.mobilepushshort}}。 + + +###建立後端應用程式 +{: create-a-backend-app} + +在 Bluemix® 型錄的「樣板」區段中建立後端應用程式，以自動將 {{site.data.keyword.mobilepushshort}} Service 連結至此應用程式。如果您已建立後端應用程式，請確定將應用程式連結至 {{site.data.keyword.mobilepushshort}} Service。 + + +###將記號傳遞至 {{site.data.keyword.mobilepushshort}} +{: pass-token-push-notifications} + +從 APNs 接收到記號之後，將記號傳遞至 {{site.data.keyword.mobilepushshort}}，這是 `registerWithDeviceToken` 方法的一部分。 + +從 APNs 接收到記號之後，將記號傳遞至 Push Notifications，這是 `didRegisterForRemoteNotificationsWithDeviceToken` 方法的一部分。 + +``` +func application (_application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data){ + let push = BMSPushClient.sharedInstance + push.registerWithDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + } +``` + {: codeblock} + + +## 在 iOS 裝置上接收推送通知 +{: #enable-push-ios-notifications-receiving} + + +若要在 iOS 裝置上接收推送通知，請將下列 Swift 方法新增至應用程式的應用程式委派。 + +``` +// For Swift +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) +{ //UserInfo dictionary will contain data sent from the server } +``` + {: codeblock} + +## 監視 iOS 裝置上的推送通知 +{: ios-monitoring} + +若要監視通知的現行狀態，請將下列 Swift 方法新增至應用程式的應用程式委派。 + +``` + // Send notification status when app is opened by clicking the notifications +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + print("Send message status to the Push server") + } +} +``` + {: codeblock} + +``` + // Send notification status when the app is in background mode. +func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { + let payLoad = ((((userInfo as NSDictionary).value(forKey: "aps") as! NSDictionary).value(forKey: "alert") as! NSDictionary).value(forKey: "body") as! NSString) + self.showAlert(title: "Recieved Push notifications", message: payLoad) + let push = BMSPushClient.sharedInstance + let respJson = (userInfo as NSDictionary).value(forKey: "payload") as! String + let data = respJson.data(using: String.Encoding.utf8) + let jsonResponse:NSDictionary = try! JSONSerialization.jsonObject(with: data! , options: JSONSerialization.ReadingOptions.allowFragments) as! NSDictionary + let messageId:String = jsonResponse.value(forKey: "nid") as! String + push.sendMessageDeliveryStatus(messageId: messageId) { (res, ss, ee) in + completionHandler(UIBackgroundFetchResult.newData) + } +} +``` + {: codeblock} + + +## 傳送基本推送通知 +{: #send} + +開發應用程式之後，您可以傳送基本推送通知。 + +若要傳送基本推送通知，請完成下列步驟： + +1. 選取**傳送通知**，然後選擇**傳送至**選項來編寫訊息。支援的選項是**依標籤的裝置**、**裝置 ID**、**使用者 ID**、**Android 裝置**、**iOS 裝置**、**Web 通知**及**所有裝置**。 +**附註**：當您選取**所有裝置**選項時，所有已訂閱 {{site.data.keyword.mobilepushshort}} 的裝置都會接收到通知。![通知畫面](images/tag_notification.jpg) + +2. 在**訊息**欄位中，編寫訊息。視需要選擇配置選用設定。 +3. 按一下**傳送**。 +3. 驗證您的裝置已接收到通知。 + +下列影像顯示處理 {{site.data.keyword.mobilepushshort}} iOS 裝置的警示框。 + +![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) + +### 傳送通知的選用設定 +{: #send_ios_otpional_setting} + +您可以進一步自訂 {{site.data.keyword.mobilepushshort}} 設定，以將通知傳送給 iOS 裝置。支援下列選用自訂選項。 + + +- **徽章**：指出應用程式徽章上所顯示的號碼。預設值是零 (0)，而且這不會顯示徽章。 +- **音效**：指出要在收到通知時播放的音效短片。支援預設值或應用程式中所組合的音效資源名稱。 +- **其他有效負載**：指定通知的自訂有效負載值。 + +##啟用互動式通知 + +現在，您可以使用更多詳細資料強化您的 iOS 通知，例如透過啟用互動式通知來新增影像、地圖或回應按鈕。這樣可提供更多環境定義給客戶，並且能夠立即採取動作而不需要離開現行環境定義。 + +若要啟用互動式通知，請使用下列程式碼： + +``` + // This defines the button action. +let actionOne = BMSPushNotificationAction(identifierName: "ACCEPT", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "DECLINE", buttonTitle: "Decline", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) +``` + {: codeblock} +``` + // This defines category for the buttons +let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) +``` + {: codeblock} +``` + // This updates the registration to include the buttonsPass the defined category into iOS BMSPushClientOptions +let notificationOptions = BMSPushClientOptions(categoryName: [category]) +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID(appGUID: "APP-GUID-HERE", clientSecret:"CLIENT-SECRET-HERE", options: notificationOptions) +``` + {: codeblock} + +若要傳送互動式通知，請完成下列步驟： + +1. 在「組合」區段的「傳送至」下拉清單，選取 **iOS 裝置**。 +2. 輸入您可能想要傳送的通知訊息。 +3. 在「選用性設定」區段中，選取**行動**然後按一下 **iOS**。 +4. 在「類型」下拉清單中，選取**混合**。 +5. 在「種類」欄位中，指定您已在應用程式定義的通知類型。 + +![iOS 的互動式通知](images/push_ios_notification_interactive.jpg) + +## 後續步驟 +{: #next_steps_tags} + +順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 + +將這些 Push Notifications Service 特性新增至您的應用程式。 +若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 +若要使用進階通知選項，請參閱[啟用進階推送通知](t_advance_badge_sound_payload.html)。 diff --git a/services/mobilepush/nl/zh/TW/c_overview_push.md b/services/mobilepush/nl/zh/TW/c_overview_push.md index dd142aae5..7b8578854 100644 --- a/services/mobilepush/nl/zh/TW/c_overview_push.md +++ b/services/mobilepush/nl/zh/TW/c_overview_push.md @@ -1,128 +1,128 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 關於 {{site.data.keyword.mobilepushshort}} -{: #overview-push} -前次更新：2017 年 1 月 18 日 -{: .last-updated} - -IBM {{site.data.keyword.mobilepushshort}} 是您可以用來傳送通知至裝置及平台的一種服務。通知可以使用標籤，以所有應用程式使用者或一組特定使用者及裝置為目標。您可以管理裝置、標籤及訂閱。 - -您可以使用下列任一選項來建立連結服務或取消連結服務，請執行下列動作： - -- 使用型錄中的 MobileFirst Services Starter 樣板建立 Bluemix 應用程式。這將建立連結至 Bluemix 後端應用程式的 Push Notifications 服務。 -- 直接從 Mobile 型錄建立取消連結 Push Notifications 服務。您可以稍後連結至應用程式或甚至選擇使用它來取消連結。 -- 使用 [Mobile 儀表板 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}。 - -請注意，{{site.data.keyword.mobilepushshort}} 監視標籤不會顯示分析資料。 - -{{site.data.keyword.mobilepushshort}} Service 現在已啟用 OpenWhisk。如需相關資訊，請參閱 [OpenWhisk](/docs/openwhisk/index.html)。 - - -## {{site.data.keyword.mobilepushshort}} Service 程序 -{: #overview_push_process} - -行動裝置、Web 瀏覽器用戶端及 Google Chrome Apps and Extensions 可以訂閱及登錄 {{site.data.keyword.mobilepushshort}} Service。啟動時，用戶端應用程式會自行登錄及訂閱 {{site.data.keyword.mobilepushshort}} Service。通知會先分派到 Apple Push Notification Service (APNs) 或 Firebase Cloud Messaging (FCM)/Google Cloud Messaging (GCM) 伺服器，然後傳送給已登錄的行動或瀏覽器用戶端。 - -![推送概觀](images/overview.jpg) - - -###行動及瀏覽器應用程式 -{: mobile-applications} - -啟動時，用戶端應用程式會自行登錄及訂閱 {{site.data.keyword.mobilepushshort}} Service 以接收通知。 - -###後端應用程式 -{: backend-applications} - -後端應用程式可以位於內部部署中，也可以位於公用雲端中。後端應用程式會使用 {{site.data.keyword.mobilepushshort}} Service，以將環境定義相關通知傳送給行動及瀏覽器應用程式使用者。不需要後端應用程式，也可以維護及管理用於傳送推送通知的行動裝置、瀏覽器代理程式及使用者資訊。反之，後端應用程式可以使用對其進行管理及維護的 {{site.data.keyword.mobilepushshort}} Service。 - -###應用程式後端擁有者 -{: app-backend-owner} - -應用程式後端擁有者會建立可組合 {{site.data.keyword.mobilepushshort}} Service 實例的行動後端應用程式。應用程式後端擁有者也會配置及設定 {{site.data.keyword.mobilepushshort}} Service，以符合使用此服務的後端應用程式以及作為 {{site.data.keyword.mobilepushshort}} 目標的行動及瀏覽器應用程式。 - -###{{site.data.keyword.mobilepushshort}} Service -{: push-notification-service} - -{{site.data.keyword.mobilepushshort}} Service 會管理用於登錄通知之行動裝置及 Web 瀏覽器用戶端的所有相關資訊。此服務讓應用程式不必處理將通知傳送給異質行動及 Web 瀏覽器平台的技術詳細資料，全都在其內進行處理。 - -###閘道 -{: gateways} - -IBM {{site.data.keyword.mobilepushshort}} Service 使用平台專用 Push Notifications 雲端服務（例如 FCM/GCM 或 Apple Push Notification Service (APNs)）將通知分派給行動及瀏覽器應用程式。 - -###推送安全 -{: push-security} - -{{site.data.keyword.mobilepushshort}} API 透過兩種類型的密碼來進行保護： - -- **appSecret**：'appSecret' 會保護一般由後端應用程式所呼叫的 API（例如，傳送 {{site.data.keyword.mobilepushshort}} 的 API，以及配置設定的 API）。 -- **clientSecret**：'clientSecret' 會保護一般由行動用戶端應用程式所呼叫的 API。只有一個 API 與使用需要此 'clientSecret' 的相關聯 UserId 登錄裝置有關。從行動用戶端呼叫的其他 API 都不需要 clientSecret。 - -連結應用程式與 {{site.data.keyword.mobilepushshort}} Service 時，會將 'appSecret' 及 'clientSecret' 配置給每個服務實例。請參閱 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/) 文件，以取得如何傳遞密碼以及針對哪些 API 傳遞的相關資訊。 - -**附註**：只有在使用 userId 欄位登錄或更新裝置時，才需要舊版應用程式來傳遞 clientSecret。行動及瀏覽器用戶端所呼叫的所有其他 API 都不需要 clientSecret。這些舊應用程式可以選擇性地繼續使用 clientSecret 進行裝置登錄或更新呼叫。不過，強烈建議所有用戶端 API 呼叫都強制執行 clientSecret 檢查。若要在現有應用程式中強制執行此作業，則有一個已發佈的新 'verifyClientSecret' API 可供使用。對於新的應用程式，將會對所有用戶端 API 呼叫強制執行 clientSecret 檢查，而且使用 'verfiyClientSecret' API 無法變更此行為。 - -預設只會在新的應用程式中強制執行用戶端密碼驗證。同時容許現有及新的應用程式，以使用 verifyClientSecret REST API 來啟用或停用用戶端密碼驗證。建議您強制執行用戶端密碼驗證，以避免向可能知道 applicationId 及 deviceId 的使用者公開裝置。 - -請確定 'clientSecret' 保持機密，而且絕不寫在行動應用程式中。您可以利用各種應用程式起始設定型樣，在應用程式運行環境期間動態地取回 'clientSecret'。序列圖會概述這類可能的型樣。 -![Enable_Push](images/init_client_secret.jpg) - -## {{site.data.keyword.mobilepushshort}} 類型 -{: #overview-push-types} - -###播送 -{: broadcast} - -用戶端應用程式向 {{site.data.keyword.mobilepushshort}} Service 登錄自己後，就可以開始接收播送。播送通知是訊息，以針對 {{site.data.keyword.mobilepushshort}} Service 跨行動裝置、瀏覽器或者實作為 Chrome 應用程式或延伸規格實例安裝及配置的所有應用程式實例為目標。任何已啟用 {{site.data.keyword.mobilepushshort}} 的應用程式預設都會啟用播送通知。啟用 {{site.data.keyword.mobilepushshort}} Service 的應用程式都會有 Push.ALL 標籤的預先定義訂閱，伺服器會使用此標籤將通知訊息播送給所有裝置。若要傳送使用 Push REST API 的播送通知，請確定在公佈至訊息資源時，"target" 是空的 JSON 檔案。 - -###標籤型通知 -{: tag-based-notifications} - -標籤通知是指以所有訂閱特定標籤之裝置為目標的訊息。標籤型通知容許根據主旨區域或主題分段通知。只有在通知是所感興趣的主旨或主題時，通知收件者才能選擇接收通知。因此，標籤型通知提供一種方法來分段收件者。此特性會啟用定義標籤後根據標籤來傳送及接收訊息的能力。訊息只會以訂閱標籤的用戶端應用程式實例（在行動裝置或瀏覽器上，或者作為應用程式或延伸規格）為目標。您必須先建立應用程式的標籤，並設定標籤訂閱，然後起始標籤型通知。若要傳送使用 REST API 的標籤型通知，請確定在公佈至訊息資源時提供 "tagNames"。 - -###單點播送通知 -{: unicast-notifications} - -單點播送通知是指以特定裝置或使用者為目標的訊息。以裝置為目標的單點播送通知不需要任何額外的設定，而且預設會在應用程式啟用 {{site.data.keyword.mobilepushshort}} 時予以啟用。 - -不過，以使用者為目標的單點播送通知需要在登錄用戶端行動裝置或 Web 瀏覽器或 Chrome Apps and Extensions for {{site.data.keyword.mobilepushshort}} 時，關聯使用者 ID 與裝置。 - -一般而言，用戶端應用程式會先執行鑑別週期，在此鑑別週期，會針對鑑別服務（例如 [Mobile Client Access](docs/services/mobileaccess/index.html)）鑑別行動應用程式使用者。鑑別成功時，接著會將已鑑別使用者 ID 傳遞至「推送裝置登錄 API」。 -若要透過 REST API 傳送單點播送通知，請確定在公佈至訊息資源時已提供 deviceId 或 userId。 - -###平台型通知 -{: platform-based-notifications} - -可以設定通知的目標以送達特定的裝置平台。例如，只能將通知只傳送給所有 Android 使用者或 Google Chrome 使用者。若要傳送使用 REST API 的平台型通知，請確定在公佈至訊息資源時已提供目標平台。請將平台指定為陣列。支援的平台如下： -* A (Apple) -* G (Google) -* WEB_CHROME（Google Chrome 瀏覽器 Web 推送） -* WEB_FIREFOX（Mozilla Firefox 瀏覽器 Web 推送） -* WEB_SAFARI（Safari 瀏覽器 Web 推送） -* APPEXT_CHROME (Google Chrome Apps & Extensions) - -## {{site.data.keyword.mobilepushshort}} 訊息大小 -{: #push-message-size} - -{{site.data.keyword.mobilepushshort}} 訊息有效負載大小取決於「閘道」（FCM/GCM、APNs）及用戶端平台所配置的限制。 - -### iOS 及 Safari -{: ios-message-size} - -若為 iOS 8 以及更新版本，接受的大小上限為 2 KB。Apple Push Notification Service 不會傳送超過此限制的通知。 - -###Android、Firefox 瀏覽器、Chrome 瀏覽器及 Chrome Apps & Extensions -{: android-message-size} - -容許的訊息有效負載大小上限為 4 KB。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 關於 {{site.data.keyword.mobilepushshort}} +{: #overview-push} +前次更新：2017 年 1 月 18 日 +{: .last-updated} + +IBM {{site.data.keyword.mobilepushshort}} 是您可以用來傳送通知至裝置及平台的一種服務。通知可以使用標籤，以所有應用程式使用者或一組特定使用者及裝置為目標。您可以管理裝置、標籤及訂閱。 + +您可以使用下列任一選項來建立連結服務或取消連結服務，請執行下列動作： + +- 使用型錄中的 MobileFirst Services Starter 樣板建立 Bluemix 應用程式。這將建立連結至 Bluemix 後端應用程式的 Push Notifications 服務。 +- 直接從 Mobile 型錄建立取消連結 Push Notifications 服務。您可以稍後連結至應用程式或甚至選擇使用它來取消連結。 +- 使用 [Mobile 儀表板 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://console.ng.bluemix.net/docs/mobile/services.html){: new_window}。 + +請注意，{{site.data.keyword.mobilepushshort}} 監視標籤不會顯示分析資料。 + +{{site.data.keyword.mobilepushshort}} Service 現在已啟用 OpenWhisk。如需相關資訊，請參閱 [OpenWhisk](/docs/openwhisk/index.html)。 + + +## {{site.data.keyword.mobilepushshort}} Service 程序 +{: #overview_push_process} + +行動裝置、Web 瀏覽器用戶端及 Google Chrome Apps and Extensions 可以訂閱及登錄 {{site.data.keyword.mobilepushshort}} Service。啟動時，用戶端應用程式會自行登錄及訂閱 {{site.data.keyword.mobilepushshort}} Service。通知會先分派到 Apple Push Notification Service (APNs) 或 Firebase Cloud Messaging (FCM)/Google Cloud Messaging (GCM) 伺服器，然後傳送給已登錄的行動或瀏覽器用戶端。 + +![推送概觀](images/overview.jpg) + + +###行動及瀏覽器應用程式 +{: mobile-applications} + +啟動時，用戶端應用程式會自行登錄及訂閱 {{site.data.keyword.mobilepushshort}} Service 以接收通知。 + +###後端應用程式 +{: backend-applications} + +後端應用程式可以位於內部部署中，也可以位於公用雲端中。後端應用程式會使用 {{site.data.keyword.mobilepushshort}} Service，以將環境定義相關通知傳送給行動及瀏覽器應用程式使用者。不需要後端應用程式，也可以維護及管理用於傳送推送通知的行動裝置、瀏覽器代理程式及使用者資訊。反之，後端應用程式可以使用對其進行管理及維護的 {{site.data.keyword.mobilepushshort}} Service。 + +###應用程式後端擁有者 +{: app-backend-owner} + +應用程式後端擁有者會建立可組合 {{site.data.keyword.mobilepushshort}} Service 實例的行動後端應用程式。應用程式後端擁有者也會配置及設定 {{site.data.keyword.mobilepushshort}} Service，以符合使用此服務的後端應用程式以及作為 {{site.data.keyword.mobilepushshort}} 目標的行動及瀏覽器應用程式。 + +###{{site.data.keyword.mobilepushshort}} Service +{: push-notification-service} + +{{site.data.keyword.mobilepushshort}} Service 會管理用於登錄通知之行動裝置及 Web 瀏覽器用戶端的所有相關資訊。此服務讓應用程式不必處理將通知傳送給異質行動及 Web 瀏覽器平台的技術詳細資料，全都在其內進行處理。 + +###閘道 +{: gateways} + +IBM {{site.data.keyword.mobilepushshort}} Service 使用平台專用 Push Notifications 雲端服務（例如 FCM/GCM 或 Apple Push Notification Service (APNs)）將通知分派給行動及瀏覽器應用程式。 + +###推送安全 +{: push-security} + +{{site.data.keyword.mobilepushshort}} API 透過兩種類型的密碼來進行保護： + +- **appSecret**：'appSecret' 會保護一般由後端應用程式所呼叫的 API（例如，傳送 {{site.data.keyword.mobilepushshort}} 的 API，以及配置設定的 API）。 +- **clientSecret**：'clientSecret' 會保護一般由行動用戶端應用程式所呼叫的 API。只有一個 API 與使用需要此 'clientSecret' 的相關聯 UserId 登錄裝置有關。從行動用戶端呼叫的其他 API 都不需要 clientSecret。 + +連結應用程式與 {{site.data.keyword.mobilepushshort}} Service 時，會將 'appSecret' 及 'clientSecret' 配置給每個服務實例。請參閱 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/) 文件，以取得如何傳遞密碼以及針對哪些 API 傳遞的相關資訊。 + +**附註**：只有在使用 userId 欄位登錄或更新裝置時，才需要舊版應用程式來傳遞 clientSecret。行動及瀏覽器用戶端所呼叫的所有其他 API 都不需要 clientSecret。這些舊應用程式可以選擇性地繼續使用 clientSecret 進行裝置登錄或更新呼叫。不過，強烈建議所有用戶端 API 呼叫都強制執行 clientSecret 檢查。若要在現有應用程式中強制執行此作業，則有一個已發佈的新 'verifyClientSecret' API 可供使用。對於新的應用程式，將會對所有用戶端 API 呼叫強制執行 clientSecret 檢查，而且使用 'verfiyClientSecret' API 無法變更此行為。 + +預設只會在新的應用程式中強制執行用戶端密碼驗證。同時容許現有及新的應用程式，以使用 verifyClientSecret REST API 來啟用或停用用戶端密碼驗證。建議您強制執行用戶端密碼驗證，以避免向可能知道 applicationId 及 deviceId 的使用者公開裝置。 + +請確定 'clientSecret' 保持機密，而且絕不寫在行動應用程式中。您可以利用各種應用程式起始設定型樣，在應用程式運行環境期間動態地取回 'clientSecret'。序列圖會概述這類可能的型樣。 +![Enable_Push](images/init_client_secret.jpg) + +## {{site.data.keyword.mobilepushshort}} 類型 +{: #overview-push-types} + +###播送 +{: broadcast} + +用戶端應用程式向 {{site.data.keyword.mobilepushshort}} Service 登錄自己後，就可以開始接收播送。播送通知是訊息，以針對 {{site.data.keyword.mobilepushshort}} Service 跨行動裝置、瀏覽器或者實作為 Chrome 應用程式或延伸規格實例安裝及配置的所有應用程式實例為目標。任何已啟用 {{site.data.keyword.mobilepushshort}} 的應用程式預設都會啟用播送通知。啟用 {{site.data.keyword.mobilepushshort}} Service 的應用程式都會有 Push.ALL 標籤的預先定義訂閱，伺服器會使用此標籤將通知訊息播送給所有裝置。若要傳送使用 Push REST API 的播送通知，請確定在公佈至訊息資源時，"target" 是空的 JSON 檔案。 + +###標籤型通知 +{: tag-based-notifications} + +標籤通知是指以所有訂閱特定標籤之裝置為目標的訊息。標籤型通知容許根據主旨區域或主題分段通知。只有在通知是所感興趣的主旨或主題時，通知收件者才能選擇接收通知。因此，標籤型通知提供一種方法來分段收件者。此特性會啟用定義標籤後根據標籤來傳送及接收訊息的能力。訊息只會以訂閱標籤的用戶端應用程式實例（在行動裝置或瀏覽器上，或者作為應用程式或延伸規格）為目標。您必須先建立應用程式的標籤，並設定標籤訂閱，然後起始標籤型通知。若要傳送使用 REST API 的標籤型通知，請確定在公佈至訊息資源時提供 "tagNames"。 + +###單點播送通知 +{: unicast-notifications} + +單點播送通知是指以特定裝置或使用者為目標的訊息。以裝置為目標的單點播送通知不需要任何額外的設定，而且預設會在應用程式啟用 {{site.data.keyword.mobilepushshort}} 時予以啟用。 + +不過，以使用者為目標的單點播送通知需要在登錄用戶端行動裝置或 Web 瀏覽器或 Chrome Apps and Extensions for {{site.data.keyword.mobilepushshort}} 時，關聯使用者 ID 與裝置。 + +一般而言，用戶端應用程式會先執行鑑別週期，在此鑑別週期，會針對鑑別服務（例如 [Mobile Client Access](docs/services/mobileaccess/index.html)）鑑別行動應用程式使用者。鑑別成功時，接著會將已鑑別使用者 ID 傳遞至「推送裝置登錄 API」。 +若要透過 REST API 傳送單點播送通知，請確定在公佈至訊息資源時已提供 deviceId 或 userId。 + +###平台型通知 +{: platform-based-notifications} + +可以設定通知的目標以送達特定的裝置平台。例如，只能將通知只傳送給所有 Android 使用者或 Google Chrome 使用者。若要傳送使用 REST API 的平台型通知，請確定在公佈至訊息資源時已提供目標平台。請將平台指定為陣列。支援的平台如下： +* A (Apple) +* G (Google) +* WEB_CHROME（Google Chrome 瀏覽器 Web 推送） +* WEB_FIREFOX（Mozilla Firefox 瀏覽器 Web 推送） +* WEB_SAFARI（Safari 瀏覽器 Web 推送） +* APPEXT_CHROME (Google Chrome Apps & Extensions) + +## {{site.data.keyword.mobilepushshort}} 訊息大小 +{: #push-message-size} + +{{site.data.keyword.mobilepushshort}} 訊息有效負載大小取決於「閘道」（FCM/GCM、APNs）及用戶端平台所配置的限制。 + +### iOS 及 Safari +{: ios-message-size} + +若為 iOS 8 以及更新版本，接受的大小上限為 2 KB。Apple Push Notification Service 不會傳送超過此限制的通知。 + +###Android、Firefox 瀏覽器、Chrome 瀏覽器及 Chrome Apps & Extensions +{: android-message-size} + +容許的訊息有效負載大小上限為 4 KB。 diff --git a/services/mobilepush/nl/zh/TW/c_rich_media_notifications.md b/services/mobilepush/nl/zh/TW/c_rich_media_notifications.md index 6ddb609fe..9af5f8855 100644 --- a/services/mobilepush/nl/zh/TW/c_rich_media_notifications.md +++ b/services/mobilepush/nl/zh/TW/c_rich_media_notifications.md @@ -1,29 +1,29 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 啟用複合式多媒體通知 -{: #interactive-notifications} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - - -您可以在 iOS 10 及更新版本啟用「複合式多媒體」{{site.data.keyword.mobilepushshort}}。可以使用「音訊」、「視訊」、GIF 及影像傳送「推送」通知。 - -如果要設定應用程式，以在 iOS 10 上接收複合式推送，請完成下列步驟： - -1. 在 Xcode 中，選取**檔案** > **新建** > **目標** > **通知服務延伸**。 -2. 在 `UNNotificationServiceExtension` 中的 `didReceive()` 方法上，新增程式碼。 -``` -BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) -``` - -若要從 Push 儀表板傳送「複合式多媒體」{{site.data.keyword.mobilepushshort}}，請確定您已指定訊息、標題、子標題，及 attachmentURL 欄位。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 啟用複合式多媒體通知 +{: #interactive-notifications} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + + +您可以在 iOS 10 及更新版本啟用「複合式多媒體」{{site.data.keyword.mobilepushshort}}。可以使用「音訊」、「視訊」、GIF 及影像傳送「推送」通知。 + +如果要設定應用程式，以在 iOS 10 上接收複合式推送，請完成下列步驟： + +1. 在 Xcode 中，選取**檔案** > **新建** > **目標** > **通知服務延伸**。 +2. 在 `UNNotificationServiceExtension` 中的 `didReceive()` 方法上，新增程式碼。 +``` +BMSPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler) +``` + +若要從 Push 儀表板傳送「複合式多媒體」{{site.data.keyword.mobilepushshort}}，請確定您已指定訊息、標題、子標題，及 attachmentURL 欄位。 diff --git a/services/mobilepush/nl/zh/TW/c_tag_basednotifications.md b/services/mobilepush/nl/zh/TW/c_tag_basednotifications.md index c40f11cf9..fa88b34da 100644 --- a/services/mobilepush/nl/zh/TW/c_tag_basednotifications.md +++ b/services/mobilepush/nl/zh/TW/c_tag_basednotifications.md @@ -1,20 +1,20 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 啟用標籤型通知 -{: #tag_based_notifications} -前次更新：2017 年 1 月 16 日 -{: .last-updated} - -標籤型通知訊息是指以所有訂閱特定標籤之裝置為目標的訊息。 - -您可以定義標籤，然後使用標籤來傳送及接收訊息。您必須先建立應用程式的標籤、設定標籤訂閱，然後起始標籤型通知。若要使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 傳送標籤型通知，請確定在公佈至訊息資源時已提供 "tagName"。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 啟用標籤型通知 +{: #tag_based_notifications} +前次更新：2017 年 1 月 16 日 +{: .last-updated} + +標籤型通知訊息是指以所有訂閱特定標籤之裝置為目標的訊息。 + +您可以定義標籤，然後使用標籤來傳送及接收訊息。您必須先建立應用程式的標籤、設定標籤訂閱，然後起始標籤型通知。若要使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 傳送標籤型通知，請確定在公佈至訊息資源時已提供 "tagName"。 diff --git a/services/mobilepush/nl/zh/TW/c_user_basednotifications.md b/services/mobilepush/nl/zh/TW/c_user_basednotifications.md index 4877d662b..8a4444a83 100644 --- a/services/mobilepush/nl/zh/TW/c_user_basednotifications.md +++ b/services/mobilepush/nl/zh/TW/c_user_basednotifications.md @@ -1,29 +1,29 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 啟用使用者型通知 -{: #user_based_notifications} -前次更新：2017 年 1 月 16 日 -{: .last-updated} - -使用者 ID 型 {{site.data.keyword.mobilepushshort}} 是以具有自訂訊息的行動應用程式使用者為目標。運用使用者型通知，您可以選擇根據其喜好設定來通知特定個體。 - -## 向使用者 ID 登錄裝置 -若要啟用「使用者 ID」設為目標的推送通知，請確定您已設定「使用者 ID」欄位來登錄裝置。 - -「使用者 ID」可以是應用程式提供給裝置登錄 API 的任何字串。一般而言，行動應用程式會先執行鑑別週期，在此鑑別週期，會對鑑別服務（例如 [{{site.data.keyword.amafull}} ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}）鑑別行動應用程式使用者。鑑別成功時，接著會將已鑑別使用者 ID 傳遞至「推送裝置登錄 API」。 - -## 同步化使用者登入及登出 - -只有在使用者已登入時，您才能選擇傳送通知。 - -例如，請考慮使用家族成員或工作團隊成員共用的裝置，而且需要定址特定使用者。在這類使用案例中，將會有使用者登入及登出序列。此鑑別機制容許應用程式追蹤現行應用程式使用者的身分。這確保一律只有該使用者才會接收到以特定使用者為目標的通知。在成功登入之後，請呼叫傳遞已登入使用者之「使用者 ID」的裝置登錄 API。同樣地，登出之前，請呼叫裝置取消登錄 API。排序這些具有登入及登出的 Push API，可確保只將要送往特定使用者的通知傳送給該使用者。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 啟用使用者型通知 +{: #user_based_notifications} +前次更新：2017 年 1 月 16 日 +{: .last-updated} + +使用者 ID 型 {{site.data.keyword.mobilepushshort}} 是以具有自訂訊息的行動應用程式使用者為目標。運用使用者型通知，您可以選擇根據其喜好設定來通知特定個體。 + +## 向使用者 ID 登錄裝置 +若要啟用「使用者 ID」設為目標的推送通知，請確定您已設定「使用者 ID」欄位來登錄裝置。 + +「使用者 ID」可以是應用程式提供給裝置登錄 API 的任何字串。一般而言，行動應用程式會先執行鑑別週期，在此鑑別週期，會對鑑別服務（例如 [{{site.data.keyword.amafull}} ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://console.ng.bluemix.net/docs/services/mobileaccess/index.html){: new_window}）鑑別行動應用程式使用者。鑑別成功時，接著會將已鑑別使用者 ID 傳遞至「推送裝置登錄 API」。 + +## 同步化使用者登入及登出 + +只有在使用者已登入時，您才能選擇傳送通知。 + +例如，請考慮使用家族成員或工作團隊成員共用的裝置，而且需要定址特定使用者。在這類使用案例中，將會有使用者登入及登出序列。此鑑別機制容許應用程式追蹤現行應用程式使用者的身分。這確保一律只有該使用者才會接收到以特定使用者為目標的通知。在成功登入之後，請呼叫傳遞已登入使用者之「使用者 ID」的裝置登錄 API。同樣地，登出之前，請呼叫裝置取消登錄 API。排序這些具有登入及登出的 Push API，可確保只將要送往特定使用者的通知傳送給該使用者。 diff --git a/services/mobilepush/nl/zh/TW/c_web_extensions.md b/services/mobilepush/nl/zh/TW/c_web_extensions.md index 750a99f43..6ce0c8731 100644 --- a/services/mobilepush/nl/zh/TW/c_web_extensions.md +++ b/services/mobilepush/nl/zh/TW/c_web_extensions.md @@ -1,107 +1,107 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 啟用 Chrome Apps and Extensions 來接收 {{site.data.keyword.mobilepushshort}} -{: #web_notifications} -前次更新：2017 年 1 月 18 日 -{: .last-updated} - -您可以啟用 Chrome Apps and Extensions 來接收 {{site.data.keyword.mobilepushshort}}。請確定您已通過[配置通知提供者的認證](t__main_push_config_provider.html)，再繼續進行下列步驟。 - -## 安裝適用於 {{site.data.keyword.mobilepushshort}} 的用戶端 SDK -{: #web_install} - -本主題說明如何安裝及使用用戶端 JavaScript Push SDK 來進一步開發 Chrome Apps and Extensions。 - -### 在 Google Chrome Apps and Extensions 中起始設定 - -若要在 Chrome Apps and Extensions 中安裝 Javascript SDK，請完成下列步驟： - -請從 [Bluemix Web Push SDK ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}，下載 `BMSPushSDK.js` 及 `manifest_Chrome_Ext.json`（適用於 Chrome Extensions）或 `manifest_Chrome_App.json`（適用於 Chrome Apps）。 - - - -- 若為 Chrome Apps，請配置資訊清單檔： - 1. 在 `manifest_Chrome_App.json` 檔案中，提供名稱、說明及圖示。 - 2. 在 `app.background.scripts` 中，新增 `BMSPushSDK.js`。 - 3. 將 `manifest_Chrome_App.json` 變更為 `manifest.json`。 - -- 若為 Chrome Extensions，請配置資訊清單檔： - 1. 在 `manifest_Chrome_Ext.json` 檔案中，提供名稱、說明及圖示。 - 2. 在 `background.scripts` 中，新增 `BMSPushSDK.js`。 - 3. 將 `manifest_Chrome_Ext.json` 變更為 `manifest.json`。 - -在 `background.js` 檔案中，新增下列這幾行，以接收推送通知： -``` -chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) -chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); -chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); -``` - {: codeblock} - - - -## 起始設定 Push SDK -{: #web_initialize} - -使用 Bluemix {{site.data.keyword.mobilepushshort}} Service `app GUID` 及 `app Region` 來起始設定 Push SDK。 - -若要取得應用程式 GUID，請在導覽窗格中選取已起始設定之 Push 服務的**配置**選項，然後按一下**行動選項**。修改程式碼 Snippet，以使用 Bluemix Push Notifications Service appGUID 參數。 - -`App Region` 指定管理 {{site.data.keyword.mobilepushshort}} Service 的位置。您可以使用下列三個值的其中一個： - - - 美國達拉斯：`.ng.bluemix.net` - - 英國：`.eu-gb.bluemix.net` - - 雪梨：`.au-syd.bluemix.net` - -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) -``` - {: codeblock} - -## 登錄 Chrome Apps and Extensions -{: #web_register} - -使用 `register()` API，以向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置。若要從 Google Chrome 登錄，請在 Bluemix {{site.data.keyword.mobilepushshort}} Service Web 配置儀表板中新增 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) API 金鑰及網站 URL。如需相關資訊，請參閱 Chrome 設定下的[配置 Google Cloud Messaging 的認證](t_push_provider_android.html)。 - -若要從 Mozilla Firefox 登錄，請在 Bluemix {{site.data.keyword.mobilepushshort}} Service Web 配置儀表板的 Firefox 設定下新增網站 URL。 - -使用下列程式碼 Snippet，在 Bluemix {{site.data.keyword.mobilepushshort}} Service 中登錄。 -``` - var bmsPush = new BMSPush(); - function callback(response) { - alert(response.response) - } - var initParams = { - "appGUID":"push app GUID", - "appRegion":"Region where service hosted", - "clientSecret":"clientSecret of your push service" - } - bmsPush.initialize(params, callback) - bmsPush.register(function(response) { - alert(response.response) - }) -``` - {: codeblock} - - - - +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 啟用 Chrome Apps and Extensions 來接收 {{site.data.keyword.mobilepushshort}} +{: #web_notifications} +前次更新：2017 年 1 月 18 日 +{: .last-updated} + +您可以啟用 Chrome Apps and Extensions 來接收 {{site.data.keyword.mobilepushshort}}。請確定您已通過[配置通知提供者的認證](t__main_push_config_provider.html)，再繼續進行下列步驟。 + +## 安裝適用於 {{site.data.keyword.mobilepushshort}} 的用戶端 SDK +{: #web_install} + +本主題說明如何安裝及使用用戶端 JavaScript Push SDK 來進一步開發 Chrome Apps and Extensions。 + +### 在 Google Chrome Apps and Extensions 中起始設定 + +若要在 Chrome Apps and Extensions 中安裝 Javascript SDK，請完成下列步驟： + +請從 [Bluemix Web Push SDK ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-javascript-webpush/zip/master){: new_window}，下載 `BMSPushSDK.js` 及 `manifest_Chrome_Ext.json`（適用於 Chrome Extensions）或 `manifest_Chrome_App.json`（適用於 Chrome Apps）。 + + + +- 若為 Chrome Apps，請配置資訊清單檔： + 1. 在 `manifest_Chrome_App.json` 檔案中，提供名稱、說明及圖示。 + 2. 在 `app.background.scripts` 中，新增 `BMSPushSDK.js`。 + 3. 將 `manifest_Chrome_App.json` 變更為 `manifest.json`。 + +- 若為 Chrome Extensions，請配置資訊清單檔： + 1. 在 `manifest_Chrome_Ext.json` 檔案中，提供名稱、說明及圖示。 + 2. 在 `background.scripts` 中，新增 `BMSPushSDK.js`。 + 3. 將 `manifest_Chrome_Ext.json` 變更為 `manifest.json`。 + +在 `background.js` 檔案中，新增下列這幾行，以接收推送通知： +``` +chrome.gcm.onMessage.addListener(BMSPushBackground.onMessageReceived) +chrome.notifications.onClicked.addListener(BMSPushBackground.notification_onClicked); +chrome.notifications.onButtonClicked.addListener(BMSPushBackground.notifiation_buttonClicked); +``` + {: codeblock} + + + +## 起始設定 Push SDK +{: #web_initialize} + +使用 Bluemix {{site.data.keyword.mobilepushshort}} Service `app GUID` 及 `app Region` 來起始設定 Push SDK。 + +若要取得應用程式 GUID，請在導覽窗格中選取已起始設定之 Push 服務的**配置**選項，然後按一下**行動選項**。修改程式碼 Snippet，以使用 Bluemix Push Notifications Service appGUID 參數。 + +`App Region` 指定管理 {{site.data.keyword.mobilepushshort}} Service 的位置。您可以使用下列三個值的其中一個： + + - 美國達拉斯：`.ng.bluemix.net` + - 英國：`.eu-gb.bluemix.net` + - 雪梨：`.au-syd.bluemix.net` + +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) +``` + {: codeblock} + +## 登錄 Chrome Apps and Extensions +{: #web_register} + +使用 `register()` API，以向 {{site.data.keyword.mobilepushshort}} Service 登錄裝置。若要從 Google Chrome 登錄，請在 Bluemix {{site.data.keyword.mobilepushshort}} Service Web 配置儀表板中新增 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) API 金鑰及網站 URL。如需相關資訊，請參閱 Chrome 設定下的[配置 Google Cloud Messaging 的認證](t_push_provider_android.html)。 + +若要從 Mozilla Firefox 登錄，請在 Bluemix {{site.data.keyword.mobilepushshort}} Service Web 配置儀表板的 Firefox 設定下新增網站 URL。 + +使用下列程式碼 Snippet，在 Bluemix {{site.data.keyword.mobilepushshort}} Service 中登錄。 +``` + var bmsPush = new BMSPush(); + function callback(response) { + alert(response.response) + } + var initParams = { + "appGUID":"push app GUID", + "appRegion":"Region where service hosted", + "clientSecret":"clientSecret of your push service" + } + bmsPush.initialize(params, callback) + bmsPush.register(function(response) { + alert(response.response) + }) +``` + {: codeblock} + + + + diff --git a/services/mobilepush/nl/zh/TW/c_web_extensions_send.md b/services/mobilepush/nl/zh/TW/c_web_extensions_send.md index 55b9647b6..0215e16c5 100644 --- a/services/mobilepush/nl/zh/TW/c_web_extensions_send.md +++ b/services/mobilepush/nl/zh/TW/c_web_extensions_send.md @@ -1,39 +1,39 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 將基本通知傳送至 Chrome Apps and Extensions -{: #web_extensions_notifications} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - -開發應用程式之後，您可以傳送推送通知。 - -1. 選取**傳送通知**，然後選擇 **Web 通知**作為**傳送至**選項來編寫訊息。 -2. 在**訊息**欄位中，鍵入需要遞送的訊息。 -3. 您可以選擇提供選用設定： - - **通知標題**：這是將顯示為訊息警示標題的文字。 - - **通知圖示 URL**：如果需要使用應用程式通知圖示來遞送您的訊息，請在此欄位中提供該圖示的鏈結。 - - **收合金鑰**：收合金鑰會附加至通知。如果多個具有相同收合金鑰的通知在裝置離線時循序到達，則會予以收合。當裝置上線時，會接收到來自 FCM/GCM 伺服器的通知，並且只會顯示含有相同收合金鑰的最新通知。如果未設定收合金鑰，則會儲存新舊訊息，以供未來遞送。 - - **存活時間**：此值是以秒為單位來設定。如果未指定此參數，則 FCM/GCM 伺服器會儲存訊息四週，並嘗試遞送。有效性會在四週後到期。可能值範圍是從 0 到 2,419,200 秒。 - - **閒置時延遲**：將此值設為 `true` 時，指示 FCM/GCM 伺服器不要在裝置閒置時遞送通知。將此值設為 `false`，則可確保遞送通知，即使裝置閒置也是一樣。 - - **其他有效負載**：指定通知的自訂有效負載值。 - -下列影像顯示儀表板中的 Chrome Apps and Extensions 通知選項。 - - ![通知畫面](images/push_chrome_extns.jpg) - -## 後續步驟 - {: #next_steps_tags} - -順利設定基本通知之後，即可選擇配置標籤型通知及進階選項。 - -將這些 {{site.data.keyword.mobilepushshort}} Service 特性新增至您的應用程式。若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。若要使用進階通知選項，請參閱[進階通知](t_advance_badge_sound_payload.html)。 +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 將基本通知傳送至 Chrome Apps and Extensions +{: #web_extensions_notifications} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + +開發應用程式之後，您可以傳送推送通知。 + +1. 選取**傳送通知**，然後選擇 **Web 通知**作為**傳送至**選項來編寫訊息。 +2. 在**訊息**欄位中，鍵入需要遞送的訊息。 +3. 您可以選擇提供選用設定： + - **通知標題**：這是將顯示為訊息警示標題的文字。 + - **通知圖示 URL**：如果需要使用應用程式通知圖示來遞送您的訊息，請在此欄位中提供該圖示的鏈結。 + - **收合金鑰**：收合金鑰會附加至通知。如果多個具有相同收合金鑰的通知在裝置離線時循序到達，則會予以收合。當裝置上線時，會接收到來自 FCM/GCM 伺服器的通知，並且只會顯示含有相同收合金鑰的最新通知。如果未設定收合金鑰，則會儲存新舊訊息，以供未來遞送。 + - **存活時間**：此值是以秒為單位來設定。如果未指定此參數，則 FCM/GCM 伺服器會儲存訊息四週，並嘗試遞送。有效性會在四週後到期。可能值範圍是從 0 到 2,419,200 秒。 + - **閒置時延遲**：將此值設為 `true` 時，指示 FCM/GCM 伺服器不要在裝置閒置時遞送通知。將此值設為 `false`，則可確保遞送通知，即使裝置閒置也是一樣。 + - **其他有效負載**：指定通知的自訂有效負載值。 + +下列影像顯示儀表板中的 Chrome Apps and Extensions 通知選項。 + + ![通知畫面](images/push_chrome_extns.jpg) + +## 後續步驟 + {: #next_steps_tags} + +順利設定基本通知之後，即可選擇配置標籤型通知及進階選項。 + +將這些 {{site.data.keyword.mobilepushshort}} Service 特性新增至您的應用程式。若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。若要使用進階通知選項，請參閱[進階通知](t_advance_badge_sound_payload.html)。 diff --git a/services/mobilepush/nl/zh/TW/images/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/zh/TW/images/t_enable_actionable_notifications_ios.md index 4e729f4a2..113307ec3 100644 --- a/services/mobilepush/nl/zh/TW/images/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/zh/TW/images/t_enable_actionable_notifications_ios.md @@ -1,100 +1,100 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 啟用 iOS 可採取動作的通知 -{: #enable-actionable-notifications-ios} - -和傳統推送通知不同，可採取動作的通知會提示使用者在接收通知警示時做選擇，而不必開啟應用程式。請使用下列指示，在應用程式中啟用可採取動作的推送通知。 - -1. 建立使用者回應動作。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. 建立通知種類並設定動作。**UIUserNotificationActionContextDefault** 或 **UIUserNotificationActionContextMinimal** 是有效的環境定義。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. 建立通知設定，並指派前一個步驟的種類。 - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. 建立本端或遠端通知，並為其指派種類身分。 - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; -[[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories)application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# 啟用 iOS 可採取動作的通知 +{: #enable-actionable-notifications-ios} + +和傳統推送通知不同，可採取動作的通知會提示使用者在接收通知警示時做選擇，而不必開啟應用程式。請使用下列指示，在應用程式中啟用可採取動作的推送通知。 + +1. 建立使用者回應動作。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. 建立通知種類並設定動作。**UIUserNotificationActionContextDefault** 或 **UIUserNotificationActionContextMinimal** 是有效的環境定義。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. 建立通知設定，並指派前一個步驟的種類。 + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. 建立本端或遠端通知，並為其指派種類身分。 + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; +[[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories)application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/zh/TW/index.md b/services/mobilepush/nl/zh/TW/index.md index 99b1a2055..c5bd1f217 100644 --- a/services/mobilepush/nl/zh/TW/index.md +++ b/services/mobilepush/nl/zh/TW/index.md @@ -1,54 +1,54 @@ ---- - -copyright: -years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 開始使用 {{site.data.keyword.mobilepushshort}} -{: #gettingstartedtemplate} -前次更新：2017 年 1 月 19 日 -{: .last-updated} - -{:shortdesc} - -{{site.data.keyword.mobilepushshort}} 可在 Mobile 型錄中作為「Bluemix 型錄」服務使用，並且讓您傳送及管理行動與 Web 推送通知。此服務可管理應用程式使用者與其裝置的對映、裝置平台，以及處理通知分派時的 Web 瀏覽器。 - - {{site.data.keyword.mobilepushshort}} 可作為部分的 MobileFirst Services Starter 樣版使用，並且作為 Bluemix [專用服務](/docs/dedicated/index.html)。您可以使用服務，將播送、單點播送（根據 deviceID 及 userID）、標籤型通知、webhook 事件型通知，以及複合式多媒體通知及互動式通知傳送至您的行動及 Web 瀏覽器應用程式使用者。您也可以使用 SDK（軟體開發套件）及 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}，以進一步開發用戶端應用程式。 - -該服務也可為您提供監視功能，以協助您監視 Push Notification 效能，方法是從您的使用者資料產生圖形及報告。請參閱 [監視 Push Notifications](/docs/services/mobilepush/t_push_monitoring.html)。 - -在下列平台中支援 {{site.data.keyword.mobilepushshort}} 服務： - -- [iOS 及 Android 行動裝置](/docs/services/mobilepush/c_enable_push.html) -- [Google Chrome、Mozilla Firefox 及 Safari Web 瀏覽器](/docs/services/mobilepush/c_chrome_firefox_enable.html) -- [Google Chrome Apps and Extensions](/docs/services/mobilepush/c_web_extensions.html) - - -# 相關鏈結 -{: #rellinks} - -* [概觀 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](c_overview_push.html){: new_window} - -## 指導教學及範例 {:id="samples"} -{: #samples} -* [Android helloPush 範例應用程式 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} -- [Cordova 範例應用程式 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} -* [iOS helloPush 範例應用程式 (Swift) ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} - -## SDK -{: #sdk} -* [Android SDK ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} -* [Cordova SDK ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} -* [iOS SDK (Swift) ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} - -## API 參考資料 -{: #api} -* [Push API 參考資料 (Android) ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} -* [BMSPush API 參考資料 iOS (Swift) ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} -* [REST API 參考資料 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window} +--- + +copyright: +years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 開始使用 {{site.data.keyword.mobilepushshort}} +{: #gettingstartedtemplate} +前次更新：2017 年 1 月 19 日 +{: .last-updated} + +{:shortdesc} + +{{site.data.keyword.mobilepushshort}} 可在 Mobile 型錄中作為「Bluemix 型錄」服務使用，並且讓您傳送及管理行動與 Web 推送通知。此服務可管理應用程式使用者與其裝置的對映、裝置平台，以及處理通知分派時的 Web 瀏覽器。 + + {{site.data.keyword.mobilepushshort}} 可作為部分的 MobileFirst Services Starter 樣版使用，並且作為 Bluemix [專用服務](/docs/dedicated/index.html)。您可以使用服務，將播送、單點播送（根據 deviceID 及 userID）、標籤型通知、webhook 事件型通知，以及複合式多媒體通知及互動式通知傳送至您的行動及 Web 瀏覽器應用程式使用者。您也可以使用 SDK（軟體開發套件）及 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}，以進一步開發用戶端應用程式。 + +該服務也可為您提供監視功能，以協助您監視 Push Notification 效能，方法是從您的使用者資料產生圖形及報告。請參閱 [監視 Push Notifications](/docs/services/mobilepush/t_push_monitoring.html)。 + +在下列平台中支援 {{site.data.keyword.mobilepushshort}} 服務： + +- [iOS 及 Android 行動裝置](/docs/services/mobilepush/c_enable_push.html) +- [Google Chrome、Mozilla Firefox 及 Safari Web 瀏覽器](/docs/services/mobilepush/c_chrome_firefox_enable.html) +- [Google Chrome Apps and Extensions](/docs/services/mobilepush/c_web_extensions.html) + + +# 相關鏈結 +{: #rellinks} + +* [概觀 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](c_overview_push.html){: new_window} + +## 指導教學及範例 {:id="samples"} +{: #samples} +* [Android helloPush 範例應用程式 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/){: new_window} +- [Cordova 範例應用程式 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-samples-cordova-hellopush){: new_window} +* [iOS helloPush 範例應用程式 (Swift) ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush){: new_window} + +## SDK +{: #sdk} +* [Android SDK ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-android-push){: new_window} +* [Cordova SDK ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push){: new_window} +* [iOS SDK (Swift) ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://codeload.github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/zip/master){: new_window} + +## API 參考資料 +{: #api} +* [Push API 參考資料 (Android) ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://classicdocs.ng.bluemix.net/docs/api/content/api/mobilefirst/android/push-api-doc/overview-summary.html){: new_window} +* [BMSPush API 參考資料 iOS (Swift) ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/blob/development/Apple Docs/index.html){: new_window} +* [REST API 參考資料 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window} diff --git a/services/mobilepush/nl/zh/TW/interactive_notifications.md b/services/mobilepush/nl/zh/TW/interactive_notifications.md index e0f459c31..95e02257e 100644 --- a/services/mobilepush/nl/zh/TW/interactive_notifications.md +++ b/services/mobilepush/nl/zh/TW/interactive_notifications.md @@ -1,83 +1,83 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 互動式通知 -{: #interactive-notifications} -前次更新：2017 年 1 月 23 日 -{: .last-updated} - -互動式通知可讓使用者在不開啟應用程式的情況下，就可以回應通知。當互動式通知到達時，裝置會顯示動作按鈕以及通知訊息。第 8 版或更新版本的 iOS 裝置上都支援互動式通知。若將互動式通知傳送至第 8 版之前的 iOS 裝置，則不會顯示通知動作。 - -##傳送互動式 {{site.data.keyword.mobilepushshort}} - - -您可以使用 Push 儀表板或使用 [REST API 文件](t_restapi.html)來傳送互動式通知。 - -從 {{site.data.keyword.mobilepushshort}} 主控台，請執行下列動作： - -1. 在 Push 儀表板的通知標籤上，按一下**傳送通知**。 -2. 選擇您的通知收件者，然後按**下一步**。 -3. 在「編寫通知」頁面中，將「類型」設為「預設值」或「混合」，並在「進階選項」標籤下指定「種類」值，即可傳送互動式推送。若要配置用戶端上的種類值，請檢查**處理原生 iOS 應用程式中的互動式 {{site.data.keyword.mobilepushshort}}** 區段。 - -## 處理 iOS 應用程式中的互動式 {{site.data.keyword.mobilepushshort}} - - -### Swift - -請完成下列步驟，以接收互動式通知： - -1. 啟用應用程式功能，以執行背景作業來接收遠端通知。 -1. 起始設定 `BMSPush` SDK 及您的動作種類。 - ``` - let myBMSClient = BMSClient.sharedInstance - myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) - let push = BMSPushClient.sharedInstance - let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) - let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) - let notifOptions = BMSPushClientOptions(categoryName: [category]) - push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) - ``` - {: codeblock} - -1. 在 AppDelegate 上實作新的回呼方法： - ``` - func userNotificationCenter(_ center: UNUserNotificationCenter, - didReceive response: UNNotificationResponse, - withCompletionHandler completionHandler: @escaping () -> Void) { - switch response.actionIdentifier { - case "FIRST": - print("FIRST") - case "SECOND": - print("SECOND") - default: - print("Unknown action") - } - completionHandler - } - ``` - {: codeblock} -5. 當使用者按一下動作按鈕時，即會呼叫這個新的回呼方法。實作此方法必須執行與指定 ID 相關聯的作業，並執行 `completionHandler` 參數中的區塊。 - - -### Cordova - -若要在 Cordova iOS 應用程式中取得可採取動作的通知，請完成下列步驟： - -1. 在 `BMSPush.initialize` 方法內新增種類欄位。 - ``` - var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} - BMSPush.initialize(appGUID,clientSecret,category); - ``` - {: codeblock} -2. 在 AppDelegate 上實作新的回呼方法。 -3. 當使用者按一下動作按鈕時，即會呼叫這個新的回呼方法。實作此方法必須執行與指定 ID 相關聯的作業，並執行 completionHandler 參數中的區塊。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 互動式通知 +{: #interactive-notifications} +前次更新：2017 年 1 月 23 日 +{: .last-updated} + +互動式通知可讓使用者在不開啟應用程式的情況下，就可以回應通知。當互動式通知到達時，裝置會顯示動作按鈕以及通知訊息。第 8 版或更新版本的 iOS 裝置上都支援互動式通知。若將互動式通知傳送至第 8 版之前的 iOS 裝置，則不會顯示通知動作。 + +##傳送互動式 {{site.data.keyword.mobilepushshort}} + + +您可以使用 Push 儀表板或使用 [REST API 文件](t_restapi.html)來傳送互動式通知。 + +從 {{site.data.keyword.mobilepushshort}} 主控台，請執行下列動作： + +1. 在 Push 儀表板的通知標籤上，按一下**傳送通知**。 +2. 選擇您的通知收件者，然後按**下一步**。 +3. 在「編寫通知」頁面中，將「類型」設為「預設值」或「混合」，並在「進階選項」標籤下指定「種類」值，即可傳送互動式推送。若要配置用戶端上的種類值，請檢查**處理原生 iOS 應用程式中的互動式 {{site.data.keyword.mobilepushshort}}** 區段。 + +## 處理 iOS 應用程式中的互動式 {{site.data.keyword.mobilepushshort}} + + +### Swift + +請完成下列步驟，以接收互動式通知： + +1. 啟用應用程式功能，以執行背景作業來接收遠端通知。 +1. 起始設定 `BMSPush` SDK 及您的動作種類。 + ``` + let myBMSClient = BMSClient.sharedInstance + myBMSClient.initialize(bluemixRegion: BMSClient.Region.usSouth) + let push = BMSPushClient.sharedInstance + let actionOne = BMSPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let actionTwo = BMSPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: UIUserNotificationActivationMode.background) + let category = BMSPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo]) + let notifOptions = BMSPushClientOptions(categoryName: [category]) + push.initializeWithAppGUID(appGUID: "YOUR_APP_GUID", clientSecret:"YOUR_APP_CLIENT_SECRET", options: notifOptions) + ``` + {: codeblock} + +1. 在 AppDelegate 上實作新的回呼方法： + ``` + func userNotificationCenter(_ center: UNUserNotificationCenter, + didReceive response: UNNotificationResponse, + withCompletionHandler completionHandler: @escaping () -> Void) { + switch response.actionIdentifier { + case "FIRST": + print("FIRST") + case "SECOND": + print("SECOND") + default: + print("Unknown action") + } + completionHandler + } + ``` + {: codeblock} +5. 當使用者按一下動作按鈕時，即會呼叫這個新的回呼方法。實作此方法必須執行與指定 ID 相關聯的作業，並執行 `completionHandler` 參數中的區塊。 + + +### Cordova + +若要在 Cordova iOS 應用程式中取得可採取動作的通知，請完成下列步驟： + +1. 在 `BMSPush.initialize` 方法內新增種類欄位。 + ``` + var category = {"Category_Name":[{"IdentifierName_1":"actionName_1"},{"IdentifierName_2":"actionName_2"}]} + BMSPush.initialize(appGUID,clientSecret,category); + ``` + {: codeblock} +2. 在 AppDelegate 上實作新的回呼方法。 +3. 當使用者按一下動作按鈕時，即會呼叫這個新的回呼方法。實作此方法必須執行與指定 ID 相關聯的作業，並執行 completionHandler 參數中的區塊。 diff --git a/services/mobilepush/nl/zh/TW/next_steps_tags.md b/services/mobilepush/nl/zh/TW/next_steps_tags.md index 27e62b19f..46cb15666 100644 --- a/services/mobilepush/nl/zh/TW/next_steps_tags.md +++ b/services/mobilepush/nl/zh/TW/next_steps_tags.md @@ -1,23 +1,23 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 後續步驟 -{: #next_steps_tags} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - -順利設定基本通知之後，即可配置標籤型通知及進階選項。 - -將這些 {{site.data.keyword.mobilepushshort}} Service 特性新增至您的應用程式。 -若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 -若要使用進階通知選項，請參閱[進階推送通知](t_advance_badge_sound_payload.html)。 - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 後續步驟 +{: #next_steps_tags} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + +順利設定基本通知之後，即可配置標籤型通知及進階選項。 + +將這些 {{site.data.keyword.mobilepushshort}} Service 特性新增至您的應用程式。 +若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 +若要使用進階通知選項，請參閱[進階推送通知](t_advance_badge_sound_payload.html)。 + diff --git a/services/mobilepush/nl/zh/TW/silent_notifications.md b/services/mobilepush/nl/zh/TW/silent_notifications.md index 7893fbc33..794c94afe 100644 --- a/services/mobilepush/nl/zh/TW/silent_notifications.md +++ b/services/mobilepush/nl/zh/TW/silent_notifications.md @@ -1,39 +1,39 @@ ------- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 處理 iOS 的無聲自動通知 -{: #silent-notifications} -前次更新：2017 年 1 月 16 日 -{: .last-updated} - -無聲自動通知不會出現在裝置畫面上。這些通知由應用程式在背景接收，此情況會喚醒應用程式最多達 30 秒，以執行指定的背景作業。使用者可能不知道有通知送達。若要傳送 iOS 的無聲自動通知，請使用 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}。 - -1. 在專案中，若要傳送無聲自動推送通知，請在 `appDelegate.m` 檔案中實作下列方法。在 Swift 中，伺服器針對無聲自動通知而傳送的 `contentAvailable` 值等於 1。 -``` -//For Swift - func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - let contentAPS = userInfo["aps"] as [NSObject : AnyObject] - if let contentAvailable = contentAPS["content-available"] as? Int { - //silent or mixed push - if contentAvailable == 1 { - completionHandler(UIBackgroundFetchResult.NewData) - } else { - completionHandler(UIBackgroundFetchResult.NoData) - } - } else { -//Default notification - completionHandler(UIBackgroundFetchResult.NoData) - } - } -``` - {: codeblock} - +------ + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 處理 iOS 的無聲自動通知 +{: #silent-notifications} +前次更新：2017 年 1 月 16 日 +{: .last-updated} + +無聲自動通知不會出現在裝置畫面上。這些通知由應用程式在背景接收，此情況會喚醒應用程式最多達 30 秒，以執行指定的背景作業。使用者可能不知道有通知送達。若要傳送 iOS 的無聲自動通知，請使用 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}。 + +1. 在專案中，若要傳送無聲自動推送通知，請在 `appDelegate.m` 檔案中實作下列方法。在 Swift 中，伺服器針對無聲自動通知而傳送的 `contentAvailable` 值等於 1。 +``` +//For Swift + func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + let contentAPS = userInfo["aps"] as [NSObject : AnyObject] + if let contentAvailable = contentAPS["content-available"] as? Int { + //silent or mixed push + if contentAvailable == 1 { + completionHandler(UIBackgroundFetchResult.NewData) + } else { + completionHandler(UIBackgroundFetchResult.NoData) + } + } else { +//Default notification + completionHandler(UIBackgroundFetchResult.NoData) + } + } +``` + {: codeblock} + diff --git a/services/mobilepush/nl/zh/TW/t__main_push_config_provider.md b/services/mobilepush/nl/zh/TW/t__main_push_config_provider.md index f41ca29df..edbd3784e 100644 --- a/services/mobilepush/nl/zh/TW/t__main_push_config_provider.md +++ b/services/mobilepush/nl/zh/TW/t__main_push_config_provider.md @@ -1,22 +1,22 @@ - ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 配置通知提供者的認證 -{: #create-push-credentials} -前次更新：2017 年 1 月 18 日 -{: .last-updated} - -針對行動裝置，若要設定 {{site.data.keyword.mobilepushshort}} 服務，您必須先從推送通知提供者 - -Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) 或 Apple Push Notification Service ([APNs](t_push_provider_ios.html)) 其中之一取得需要的認證。若為 Web 瀏覽器，請參閱[配置 Web 瀏覽器的認證](t_push_provider_safari.html)。 - -您可以使用 **IBM Bluemix 服務**儀表板或使用 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}，設定 {{site.data.keyword.mobilepushshort}}。 + +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 配置通知提供者的認證 +{: #create-push-credentials} +前次更新：2017 年 1 月 18 日 +{: .last-updated} + +針對行動裝置，若要設定 {{site.data.keyword.mobilepushshort}} 服務，您必須先從推送通知提供者 - +Firebase Cloud Messaging ([FCM](t_push_provider_android.html)) 或 Apple Push Notification Service ([APNs](t_push_provider_ios.html)) 其中之一取得需要的認證。若為 Web 瀏覽器，請參閱[配置 Web 瀏覽器的認證](t_push_provider_safari.html)。 + +您可以使用 **IBM Bluemix 服務**儀表板或使用 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}，設定 {{site.data.keyword.mobilepushshort}}。 diff --git a/services/mobilepush/nl/zh/TW/t_advance_badge_sound_payload.md b/services/mobilepush/nl/zh/TW/t_advance_badge_sound_payload.md index 83bda0413..f1d43e55d 100644 --- a/services/mobilepush/nl/zh/TW/t_advance_badge_sound_payload.md +++ b/services/mobilepush/nl/zh/TW/t_advance_badge_sound_payload.md @@ -1,79 +1,79 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -#啟用進階 {{site.data.keyword.mobilepushshort}} -前次更新：2017 年 1 月 23 日 -{: .last-updated} - -配置 iOS 徽章、音效、其他 JSON 有效負載、可採取動作的通知，以及保存通知。 - -## 配置音效、有效負載以及 iOS 徽章 -{: #badge-sound-payload} - -配置 iOS 徽章、音效及其他 JSON 有效負載。 - -1. 在 {{site.data.keyword.mobilepushshort}} 儀表板上，移至**通知**標籤。 -2. 移至**選用欄位**區段，以配置 {{site.data.keyword.mobilepushshort}} 特性。 - - **音效檔** - 輸入指向行動應用程式中音效檔的字串。在有效負載中，指定要使用之音效檔的字串名稱。 - - **iOS 徽章** - 對於 iOS 裝置，這是要顯示為應用程式圖示徽章的號碼。如果沒有此內容，則不會變更徽章。若要移除徽章，請將此內容的值設為 0。 - -###Android - -在 Android 應用程式的 `res/raw` 目錄中，新增您的音效檔。傳送通知時，在 {{site.data.keyword.mobilepushshort}} 的音效欄位中新增音效檔名稱。 - -``` -"settings":{ - "gcm":{ - "sound":"tt.wav", - } - } -``` - {: codeblock} - -###iOS - -``` -"settings": { - "apns" : { - "badge": 10, - "sound": "tt.wav", - } -} -``` - {: codeblock} - -**其他有效負載** - 此有效負載可以是任意鍵值組，而且必須是您要與 {{site.data.keyword.mobilepushshort}} 一起傳送的 JSON 物件。 - - - -``` -{"key":"value", "key2":"value2"} -``` - {: codeblock} - -## 保存 Android 通知 -{: #hold-notifications-android} - -在應用程式進入背景時，您可能會想要 {{site.data.keyword.mobilepushshort}} 保留傳送給應用程式的通知。若要保留通知，請在處理 {{site.data.keyword.mobilepushshort}} 之活動的 onPause() 方法中呼叫 hold() 方法。 - -``` -@Override -protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 啟用進階 {{site.data.keyword.mobilepushshort}} +前次更新：2017 年 1 月 23 日 +{: .last-updated} + +配置 iOS 徽章、音效、其他 JSON 有效負載、可採取動作的通知，以及保存通知。 + +## 配置音效、有效負載以及 iOS 徽章 +{: #badge-sound-payload} + +配置 iOS 徽章、音效及其他 JSON 有效負載。 + +1. 在 {{site.data.keyword.mobilepushshort}} 儀表板上，移至**通知**標籤。 +2. 移至**選用欄位**區段，以配置 {{site.data.keyword.mobilepushshort}} 特性。 + - **音效檔** - 輸入指向行動應用程式中音效檔的字串。在有效負載中，指定要使用之音效檔的字串名稱。 + - **iOS 徽章** - 對於 iOS 裝置，這是要顯示為應用程式圖示徽章的號碼。如果沒有此內容，則不會變更徽章。若要移除徽章，請將此內容的值設為 0。 + +### Android + +在 Android 應用程式的 `res/raw` 目錄中，新增您的音效檔。傳送通知時，在 {{site.data.keyword.mobilepushshort}} 的音效欄位中新增音效檔名稱。 + +``` +"settings":{ + "gcm":{ + "sound":"tt.wav", + } + } +``` + {: codeblock} + +### iOS + +``` +"settings": { + "apns" : { + "badge": 10, + "sound": "tt.wav", + } +} +``` + {: codeblock} + +**其他有效負載** - 此有效負載可以是任意鍵值組，而且必須是您要與 {{site.data.keyword.mobilepushshort}} 一起傳送的 JSON 物件。 + + + +``` +{"key":"value", "key2":"value2"} +``` + {: codeblock} + +## 保存 Android 通知 +{: #hold-notifications-android} + +在應用程式進入背景時，您可能會想要 {{site.data.keyword.mobilepushshort}} 保留傳送給應用程式的通知。若要保留通知，請在處理 {{site.data.keyword.mobilepushshort}} 之活動的 onPause() 方法中呼叫 hold() 方法。 + +``` +@Override +protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} + + diff --git a/services/mobilepush/nl/zh/TW/t_android_create_unbound_service.md b/services/mobilepush/nl/zh/TW/t_android_create_unbound_service.md index 48176830d..18149562c 100644 --- a/services/mobilepush/nl/zh/TW/t_android_create_unbound_service.md +++ b/services/mobilepush/nl/zh/TW/t_android_create_unbound_service.md @@ -1,36 +1,36 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 建立適用於 Android 的未連結 {{site.data.keyword.mobilepushshort}} Service -{: #create_android_unbound} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - -建立 {{site.data.keyword.mobilepushshort}} Service 實例。您可以使用 {{site.data.keyword.mobilepushshort}} Service 實例，而不連結至任何後端應用程式。 - -1. 將 {{site.data.keyword.mobilepushshort}} Service 實例連結至 Bluemix 應用程式。連結時，您可以看到所有與服務相關的詳細資料都會以 JSON 格式儲存在 VCAP_SERVICES 環境變數中。 - -![連結 Push Notification Service](images/unbound_1.jpg) - 2. 按一下**連結**，然後選擇要連結的 {{site.data.keyword.mobilepushshort}} Service 實例。將應用程式連結至 {{site.data.keyword.mobilepushshort}} Service 時，服務的資訊會以 JSON 格式儲存在應用程式的 VCAP_SERVICES 環境變數中。例如： -``` - { - "imfpush_Dev": [ - { - "name": "myname_sampleUnbound", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": null - } - ] - } -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 建立適用於 Android 的未連結 {{site.data.keyword.mobilepushshort}} Service +{: #create_android_unbound} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + +建立 {{site.data.keyword.mobilepushshort}} Service 實例。您可以使用 {{site.data.keyword.mobilepushshort}} Service 實例，而不連結至任何後端應用程式。 + +1. 將 {{site.data.keyword.mobilepushshort}} Service 實例連結至 Bluemix 應用程式。連結時，您可以看到所有與服務相關的詳細資料都會以 JSON 格式儲存在 VCAP_SERVICES 環境變數中。 + +![連結 Push Notification Service](images/unbound_1.jpg) + 2. 按一下**連結**，然後選擇要連結的 {{site.data.keyword.mobilepushshort}} Service 實例。將應用程式連結至 {{site.data.keyword.mobilepushshort}} Service 時，服務的資訊會以 JSON 格式儲存在應用程式的 VCAP_SERVICES 環境變數中。例如： +``` + { + "imfpush_Dev": [ + { + "name": "myname_sampleUnbound", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": null + } + ] + } +``` + {: codeblock} diff --git a/services/mobilepush/nl/zh/TW/t_android_initialize.md b/services/mobilepush/nl/zh/TW/t_android_initialize.md index ff4d875d5..88a1fbc87 100644 --- a/services/mobilepush/nl/zh/TW/t_android_initialize.md +++ b/services/mobilepush/nl/zh/TW/t_android_initialize.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 起始設定 Push SDK for Android 應用程式 -{: #android_initialize} - -放置起始設定碼的一般位置位於 Android 應用程式之主要活動的 onCreate 方法中。 - -按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的路徑及應用程式 GUID。將這些值用於您的路徑和應用程式 GUID。修改程式碼 Snippet，以使用 Bluemix 應用程式 appRoute 及 appGUID 參數。 - - -##起始設定 Core SDK - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -指定指派給您在 Bluemix 上所建立之伺服器應用程式的路徑。 - -**AppGUID** - -指定指派給您在 Bluemix 上所建立之應用程式的唯一索引鍵。此值區分大小寫。 - -**bluemixRegionSuffix** - -指定管理應用程式的位置。您可以使用下列三個值的其中一個： - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##起始設定 Client Push SDK - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# 起始設定 Push SDK for Android 應用程式 +{: #android_initialize} + +放置起始設定碼的一般位置位於 Android 應用程式之主要活動的 onCreate 方法中。 + +按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的路徑及應用程式 GUID。將這些值用於您的路徑和應用程式 GUID。修改程式碼 Snippet，以使用 Bluemix 應用程式 appRoute 及 appGUID 參數。 + + +## 起始設定 Core SDK + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +指定指派給您在 Bluemix 上所建立之伺服器應用程式的路徑。 + +**AppGUID** + +指定指派給您在 Bluemix 上所建立之應用程式的唯一索引鍵。此值區分大小寫。 + +**bluemixRegionSuffix** + +指定管理應用程式的位置。您可以使用下列三個值的其中一個： + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +## 起始設定 Client Push SDK + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` diff --git a/services/mobilepush/nl/zh/TW/t_android_install_sdk.md b/services/mobilepush/nl/zh/TW/t_android_install_sdk.md index d96e3870e..8d78b99ec 100644 --- a/services/mobilepush/nl/zh/TW/t_android_install_sdk.md +++ b/services/mobilepush/nl/zh/TW/t_android_install_sdk.md @@ -1,216 +1,216 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 使用 Gradle 安裝 Client Push SDK -{: #android_install} - -本節說明如何安裝及使用 Client Push SDK 來進一步開發 Android 應用程式。 - -Bluemix® Mobile Services Push SDK 可以使用 Gradle 進行新增。Gradle 會從儲存庫中自動下載構件，並讓它們可供 Android 應用程式使用。請確定您已正確設定 Android Studio 及 Android Studio SDK。如需如何設定系統的相關資訊，請參閱 [Android Studio 概觀](https://developer.android.com/tools/studio/index.html)。如需 Gradle 的相關資訊，請參閱[配置 Gradle 建置](http://developer.android.com/tools/building/configuring-gradle.html)。 - -1. 在 Android Studio 中，建立並開啟行動應用程式之後，開啟應用程式 **build.gradle** 檔案。然後，將下列相依關係新增至行動應用程式。程式碼 Snippet 需要這些 import 陳述式： - - ``` - import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; - import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; - ``` - - -1. 將下列相依關係新增至行動應用程式。下列數行會將 Bluemix™ Mobile Services Push Client SDK 及 Google Play Services SDK 新增至您的編譯範圍相依關係。 - - ``` - dependencies { - compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' -compile 'com.google.android.gms:play-services:7.8.0' -} - ``` -1. 在 **AndroidManifest.xml** 檔案中，新增下列許可權。若要檢視範例資訊清單，請參閱 [Android helloPush 範例應用程式](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml)。若要檢視範例 Gradle 檔案，請參閱[範例建置 Gradle 檔案](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle)。 - - ``` - - - - - - - - - ``` - - 您可以在這裡閱讀 [Android 許可權](http://developer.android.com/guide/topics/security/permissions.html)的相關資訊。 - -1. 新增活動的通知目的設定。此設定會在使用者按一下通知區域中的接收通知時啟動應用程式。 - - ``` - - - - - ``` - **附註**：將上面動作中的 *Your_Android_Package_Name* 取代為您應用程式中所使用的應用程式套件名稱。 - -1. 新增 RECEIVE 事件通知的 Google Cloud Messaging (GCM) 目的服務及目的過濾器。 - - ``` - service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> - - - - - - - - - - - - - - ``` - - - -# 起始設定 Push SDK for Android 應用程式 -{: #android_initialize} - -放置起始設定碼的一般位置位於 Android 應用程式之主要活動的 onCreate 方法中。 - -按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的路徑及應用程式 GUID。將這些值用於您的路徑和應用程式 GUID。修改程式碼 Snippet，以使用 Bluemix 應用程式 appRoute 及 appGUID 參數。 - - -##起始設定 Core SDK - -``` -// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route -BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); -``` - - -**appRoute** - -指定指派給您在 Bluemix 上所建立之伺服器應用程式的路徑。 - -**AppGUID** - -指定指派給您在 Bluemix 上所建立之應用程式的唯一索引鍵。此值區分大小寫。 - -**bluemixRegionSuffix** - -指定管理應用程式的位置。您可以使用下列三個值的其中一個： - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - -##起始設定 Client Push SDK - -``` -//Initialize client Push SDK for Java -MFPPush push = MFPPush.getInstance(); -push.initialize(getApplicationContext()); -``` - - - -# 登錄 Android 裝置 -{: #android_register} - -使用 `IMFPush.register()` API，以向 Push Notification Service 登錄裝置。如需登錄 Android 裝置，您要先在 Bluemix Push 服務配置儀表板中新增 Google Cloud Messaging (GCM) 資訊。如需相關資訊，請參閱[配置 Google Cloud Messaging 的認證](t_push_provider_android.html)。 - -複製下列程式碼 Snippet，並將其貼入 Android 行動應用程式。 - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` - - - -# 在 Android 裝置上接收推送通知 -{: #android_receive} - -若要向 Push 登錄 notificationListener 物件，請呼叫 **MFPPush.listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 方法所呼叫。 - -1. 若要向 Push 登錄 notificationListener 物件，請呼叫 **listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 方法所呼叫。 - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } - ``` -2. 建置專案，並在裝置或模擬器上執行該專案。在 register() 方法中呼叫回應接聽器的 onSuccess() 方法時，它會確認已順利向 Push Notification Service 登錄裝置。此時，您可以如「傳送基本推送通知」所述傳送訊息。 -3. 驗證您的裝置已接收到通知。如果應用程式是在前景中，則 **MFPPushNotificationListener** 會處理通知。如果應用程式是在背景中，則會在通知列中顯示一則訊息。 - - - - -# 傳送基本推送通知 - -{: #push-send-notifications} - -開發應用程式之後，您可以傳送基本推送通知（不需要使用標籤、徽章、其他有效負載或音效檔）。 - - -傳送基本推送通知。 - -1. 在**選擇讀者**，請選取下列一個讀者：**所有裝置**，或依平台：**僅限 iOS 裝置**或**僅限 Anroid 裝置**。 - - **附註**：當您選取**所有裝置**選項時，所有已訂閱推送通知的裝置都會收到您的通知。 - - ![通知畫面](images/tag_notification.jpg) - -2. 在**建立通知**中，輸入您的訊息，然後按一下**傳送**。 -3. 驗證您的裝置已接收到通知。 - - 下列擷取畫面顯示在 Android 及 iOS 裝置的前景中處理推送通知的警示框。 - - ![Android 上的前景推送通知](images/Android_Screenshot.jpg) - - ![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) - - 下列擷取畫面顯示 Android 背景中的推送通知。 - ![Android 上的背景推送通知](images/background.jpg) - - - -# 後續步驟 -{: #next_steps_tags} - -順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 - -將這些 Push Notifications Service 特性新增至您的應用程式。 -若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 -若要使用進階通知選項，請參閱[進階推送通知](t_advance_notifications.html)。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 使用 Gradle 安裝 Client Push SDK +{: #android_install} + +本節說明如何安裝及使用 Client Push SDK 來進一步開發 Android 應用程式。 + +Bluemix® Mobile Services Push SDK 可以使用 Gradle 進行新增。Gradle 會從儲存庫中自動下載構件，並讓它們可供 Android 應用程式使用。請確定您已正確設定 Android Studio 及 Android Studio SDK。如需如何設定系統的相關資訊，請參閱 [Android Studio 概觀](https://developer.android.com/tools/studio/index.html)。如需 Gradle 的相關資訊，請參閱[配置 Gradle 建置](http://developer.android.com/tools/building/configuring-gradle.html)。 + +1. 在 Android Studio 中，建立並開啟行動應用程式之後，開啟應用程式 **build.gradle** 檔案。然後，將下列相依關係新增至行動應用程式。程式碼 Snippet 需要這些 import 陳述式： + + ``` + import com.ibm.mobilefirstplatform.clientsdk.android.core.api.BMSClient; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPush; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushException; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushResponseListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushNotificationListener; + import com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPSimplePushNotification; + ``` + + +1. 將下列相依關係新增至行動應用程式。下列數行會將 Bluemix™ Mobile Services Push Client SDK 及 Google Play Services SDK 新增至您的編譯範圍相依關係。 + + ``` + dependencies { + compile 'com.ibm.mobilefirstplatform.clientsdk.android:push:1.+' +compile 'com.google.android.gms:play-services:7.8.0' +} + ``` +1. 在 **AndroidManifest.xml** 檔案中，新增下列許可權。若要檢視範例資訊清單，請參閱 [Android helloPush 範例應用程式](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/src/main/AndroidManifest.xml)。若要檢視範例 Gradle 檔案，請參閱[範例建置 Gradle 檔案](https://github.com/ibm-bluemix-mobile-services/bms-samples-android-hellopush/blob/master/helloPush/app/build.gradle)。 + + ``` + + + + + + + + + ``` + + 您可以在這裡閱讀 [Android 許可權](http://developer.android.com/guide/topics/security/permissions.html)的相關資訊。 + +1. 新增活動的通知目的設定。此設定會在使用者按一下通知區域中的接收通知時啟動應用程式。 + + ``` + + + + + ``` + **附註**：將上面動作中的 *Your_Android_Package_Name* 取代為您應用程式中所使用的應用程式套件名稱。 + +1. 新增 RECEIVE 事件通知的 Google Cloud Messaging (GCM) 目的服務及目的過濾器。 + + ``` + service android:name="com.ibm.mobilefirstplatform.clientsdk.android.push.api.MFPPushIntentService" /> + + + + + + + + + + + + + + ``` + + + +# 起始設定 Push SDK for Android 應用程式 +{: #android_initialize} + +放置起始設定碼的一般位置位於 Android 應用程式之主要活動的 onCreate 方法中。 + +按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的路徑及應用程式 GUID。將這些值用於您的路徑和應用程式 GUID。修改程式碼 Snippet，以使用 Bluemix 應用程式 appRoute 及 appGUID 參數。 + + +##起始設定 Core SDK + +``` +// Initialize the SDK for Java (Android) with IBM Bluemix AppGUID and route +BMSClient.getInstance().initialize(getApplicationContext(), "applicationRoute","applicationGUID", bluemixRegion:"Location where your app Hosted"); +``` + + +**appRoute** + +指定指派給您在 Bluemix 上所建立之伺服器應用程式的路徑。 + +**AppGUID** + +指定指派給您在 Bluemix 上所建立之應用程式的唯一索引鍵。此值區分大小寫。 + +**bluemixRegionSuffix** + +指定管理應用程式的位置。您可以使用下列三個值的其中一個： + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + +##起始設定 Client Push SDK + +``` +//Initialize client Push SDK for Java +MFPPush push = MFPPush.getInstance(); +push.initialize(getApplicationContext()); +``` + + + +# 登錄 Android 裝置 +{: #android_register} + +使用 `IMFPush.register()` API，以向 Push Notification Service 登錄裝置。如需登錄 Android 裝置，您要先在 Bluemix Push 服務配置儀表板中新增 Google Cloud Messaging (GCM) 資訊。如需相關資訊，請參閱[配置 Google Cloud Messaging 的認證](t_push_provider_android.html)。 + +複製下列程式碼 Snippet，並將其貼入 Android 行動應用程式。 + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` + + + +# 在 Android 裝置上接收推送通知 +{: #android_receive} + +若要向 Push 登錄 notificationListener 物件，請呼叫 **MFPPush.listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 方法所呼叫。 + +1. 若要向 Push 登錄 notificationListener 物件，請呼叫 **listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 方法所呼叫。 + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } + ``` +2. 建置專案，並在裝置或模擬器上執行該專案。在 register() 方法中呼叫回應接聽器的 onSuccess() 方法時，它會確認已順利向 Push Notification Service 登錄裝置。此時，您可以如「傳送基本推送通知」所述傳送訊息。 +3. 驗證您的裝置已接收到通知。如果應用程式是在前景中，則 **MFPPushNotificationListener** 會處理通知。如果應用程式是在背景中，則會在通知列中顯示一則訊息。 + + + + +# 傳送基本推送通知 + +{: #push-send-notifications} + +開發應用程式之後，您可以傳送基本推送通知（不需要使用標籤、徽章、其他有效負載或音效檔）。 + + +傳送基本推送通知。 + +1. 在**選擇讀者**，請選取下列一個讀者：**所有裝置**，或依平台：**僅限 iOS 裝置**或**僅限 Anroid 裝置**。 + + **附註**：當您選取**所有裝置**選項時，所有已訂閱推送通知的裝置都會收到您的通知。 + + ![通知畫面](images/tag_notification.jpg) + +2. 在**建立通知**中，輸入您的訊息，然後按一下**傳送**。 +3. 驗證您的裝置已接收到通知。 + + 下列擷取畫面顯示在 Android 及 iOS 裝置的前景中處理推送通知的警示框。 + + ![Android 上的前景推送通知](images/Android_Screenshot.jpg) + + ![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) + + 下列擷取畫面顯示 Android 背景中的推送通知。 + ![Android 上的背景推送通知](images/background.jpg) + + + +# 後續步驟 +{: #next_steps_tags} + +順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 + +將這些 Push Notifications Service 特性新增至您的應用程式。 +若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 +若要使用進階通知選項，請參閱[進階推送通知](t_advance_notifications.html)。 diff --git a/services/mobilepush/nl/zh/TW/t_android_receive.md b/services/mobilepush/nl/zh/TW/t_android_receive.md index 883738f8e..1877f85aa 100644 --- a/services/mobilepush/nl/zh/TW/t_android_receive.md +++ b/services/mobilepush/nl/zh/TW/t_android_receive.md @@ -1,25 +1,25 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 在 Android 裝置上接收推送通知 -{: #android_receive} - -若要向 Push 登錄 notificationListener 物件，請呼叫 **MFPPush.listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 方法所呼叫。 - -1. 若要向 Push 登錄 notificationListener 物件，請呼叫 **listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 方法所呼叫。 - - ``` - @Override - protected void onResume(){ - super.onResume(); - if(push != null) { - push.listen(notificationListener); - } - } -``` -2. 建置專案，並在裝置或模擬器上執行該專案。在 register() 方法中呼叫回應接聽器的 onSuccess() 方法時，它會確認已順利向 Push Notification Service 登錄裝置。此時，您可以如「傳送基本推送通知」所述傳送訊息。 -3. 驗證您的裝置已接收到通知。如果應用程式是在前景中，則 **MFPPushNotificationListener** 會處理通知。如果應用程式是在背景中，則會在通知列中顯示一則訊息。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 在 Android 裝置上接收推送通知 +{: #android_receive} + +若要向 Push 登錄 notificationListener 物件，請呼叫 **MFPPush.listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 方法所呼叫。 + +1. 若要向 Push 登錄 notificationListener 物件，請呼叫 **listen()** 方法。此方法一般是透過處理推送通知之活動的 **onResume()** 方法所呼叫。 + + ``` + @Override + protected void onResume(){ + super.onResume(); + if(push != null) { + push.listen(notificationListener); + } + } +``` +2. 建置專案，並在裝置或模擬器上執行該專案。在 register() 方法中呼叫回應接聽器的 onSuccess() 方法時，它會確認已順利向 Push Notification Service 登錄裝置。此時，您可以如「傳送基本推送通知」所述傳送訊息。 +3. 驗證您的裝置已接收到通知。如果應用程式是在前景中，則 **MFPPushNotificationListener** 會處理通知。如果應用程式是在背景中，則會在通知列中顯示一則訊息。 diff --git a/services/mobilepush/nl/zh/TW/t_android_register.md b/services/mobilepush/nl/zh/TW/t_android_register.md index dc59a0e44..3fa77b396 100644 --- a/services/mobilepush/nl/zh/TW/t_android_register.md +++ b/services/mobilepush/nl/zh/TW/t_android_register.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 登錄 Android 裝置 -{: #android_register} - -使用 `IMFPush.register()` API，以向 Push Notification Service 登錄裝置。如需登錄 Android 裝置，您要先在 Bluemix Push 服務配置儀表板中新增 Google Cloud Messaging (GCM) 資訊。如需相關資訊，請參閱[配置 Google Cloud Messaging 的認證](t_push_provider_android.html)。 - -複製下列程式碼 Snippet，並將其貼入 Android 行動應用程式。 - -``` - //Register Android devices - push.register(new MFPPushResponseListener() { - @Override - public void onSuccess(String deviceId) { - //handle success here - } - @Override - public void onFailure(MFPPushException ex) { - //handle failure here - } - }); -``` - -``` - //Handles the notification when it arrives - MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { - @Override - public void onReceive (final MFPSimplePushNotification message){ - // Handle Push Notification - } - }; -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# 登錄 Android 裝置 +{: #android_register} + +使用 `IMFPush.register()` API，以向 Push Notification Service 登錄裝置。如需登錄 Android 裝置，您要先在 Bluemix Push 服務配置儀表板中新增 Google Cloud Messaging (GCM) 資訊。如需相關資訊，請參閱[配置 Google Cloud Messaging 的認證](t_push_provider_android.html)。 + +複製下列程式碼 Snippet，並將其貼入 Android 行動應用程式。 + +``` + //Register Android devices + push.register(new MFPPushResponseListener() { + @Override + public void onSuccess(String deviceId) { + //handle success here + } + @Override + public void onFailure(MFPPushException ex) { + //handle failure here + } + }); +``` + +``` + //Handles the notification when it arrives + MFPPushNotificationListener notificationListener = new MFPPushNotificationListener() { + @Override + public void onReceive (final MFPSimplePushNotification message){ + // Handle Push Notification + } + }; +``` diff --git a/services/mobilepush/nl/zh/TW/t_cordova_initialize.md b/services/mobilepush/nl/zh/TW/t_cordova_initialize.md index 37e6a753e..23e734e5b 100644 --- a/services/mobilepush/nl/zh/TW/t_cordova_initialize.md +++ b/services/mobilepush/nl/zh/TW/t_cordova_initialize.md @@ -1,31 +1,31 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} - -# 起始設定 Cordova 外掛程式 -{: #cordova_enable} - -您需要透過傳遞應用程式路徑及應用程式 GUID 來起始設定 Push Notification Service Cordova 外掛程式，才能使用該外掛程式。在起始設定外掛程式之後，您可以連接至在 Bluemix 儀表板中所建立的伺服器應用程式。Cordova 外掛程式是 Android 及 iOS Client SDK 的封套，可讓 Cordova 應用程式與 Bluemix 服務通訊。 - -1. 複製下列程式碼 Snippet，並將其貼入您的主要 JavaScript 檔案（通常位於 **www/js** 目錄下），以起始設定 BMSClient。 - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. 修改程式碼 Snippet，以使用您的 Bluemix「路徑」及「應用程式 GUID」參數。按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的「路徑」及「應用程式 GUID」。請使用「路徑」及「應用程式 GUID」的值，作為 `BMSClient.initialize` 程式碼 Snippet 中的參數。 - - - **附註**：如果您已使用 Cordova CLI（例如，Cordova create app-name 指令）建立 Cordova 應用程式，請將此 Javascript 程式碼放置在 **index.js** 檔案中 `onDeviceReady: function()` 函數內的 `app.receivedEvent` 函數後面，以起始設定 BMS 用戶端。 - - ``` - onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, - ``` -1. 後續步驟。[登錄裝置](t_cordova_register.html)。 +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} + +# 起始設定 Cordova 外掛程式 +{: #cordova_enable} + +您需要透過傳遞應用程式路徑及應用程式 GUID 來起始設定 Push Notification Service Cordova 外掛程式，才能使用該外掛程式。在起始設定外掛程式之後，您可以連接至在 Bluemix 儀表板中所建立的伺服器應用程式。Cordova 外掛程式是 Android 及 iOS Client SDK 的封套，可讓 Cordova 應用程式與 Bluemix 服務通訊。 + +1. 複製下列程式碼 Snippet，並將其貼入您的主要 JavaScript 檔案（通常位於 **www/js** 目錄下），以起始設定 BMSClient。 + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. 修改程式碼 Snippet，以使用您的 Bluemix「路徑」及「應用程式 GUID」參數。按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的「路徑」及「應用程式 GUID」。請使用「路徑」及「應用程式 GUID」的值，作為 `BMSClient.initialize` 程式碼 Snippet 中的參數。 + + + **附註**：如果您已使用 Cordova CLI（例如，Cordova create app-name 指令）建立 Cordova 應用程式，請將此 Javascript 程式碼放置在 **index.js** 檔案中 `onDeviceReady: function()` 函數內的 `app.receivedEvent` 函數後面，以起始設定 BMS 用戶端。 + + ``` + onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, + ``` +1. 後續步驟。[登錄裝置](t_cordova_register.html)。 diff --git a/services/mobilepush/nl/zh/TW/t_cordova_install.md b/services/mobilepush/nl/zh/TW/t_cordova_install.md index fb9375e37..4249fa6f9 100644 --- a/services/mobilepush/nl/zh/TW/t_cordova_install.md +++ b/services/mobilepush/nl/zh/TW/t_cordova_install.md @@ -1,373 +1,373 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 安裝 Cordova Push 外掛程式 -{: #cordova_install} - -安裝及使用 Client Push 外掛程式來進一步開發 Cordova 應用程式。這也會安裝起始設定您的 Bluemix 連線的 Cordova Core 外掛程式。 - -### 開始之前 - -1. 下載最新的 Android Studio SDK 及 Xcode 版本。 -1. 設定您的模擬器。若為 Android Studio，請使用支援 Google Play API 的模擬器。 -1. 安裝 Git 指令行工具。若為 Windows，請確保選取**從 Windows 命令提示字元執行 Git** 選項。如需如何下載並安裝此工具的相關資訊，請參閱 [Git](https://git-scm.com/downloads)。 - -1. 安裝 Node.js 及「Node 套件管理程式 (NPM)」工具。NPM 指令行工具與 Node.js 組合在一起。如需如何下載並安裝 Node.js 的相關資訊，請參閱 [Node.js](https://nodejs.org/en/download/)。 -1. 從指令行中，使用 **npm install -g cordova** 指令來安裝 Cordova 指令行工具。若要使用 Cordova Push 外掛程式，這是必要動作。如需如何安裝 Cordova 以及設定 Cordova 應用程式的相關資訊，請參閱 [Cordova Apache](https://cordova.apache.org/#getstarted)。 - - **附註**：若要檢視 Cordova Push 外掛程式 Readme 檔，請移至 [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push)。 - - -## 安裝 Cordova Push 外掛程式 -1. 切換至您要在其中建立 Cordova 應用程式的資料夾，並執行下列指令來建立 Cordova 應用程式。如果您有現存的 Cordova 應用程式，請移至步驟 3。 - -``` -cordova create your_app_name -cd your_app_name -``` -1. 選用項目：（選用）編輯 **config.xml** 檔案，並將 元素中的應用程式名稱變更為您選擇的名稱，而不是預設 HelloCordova 名稱。 - - **附註**：請確定指定正確的軟體組 ID。如果您未指定，則會在 Xcode 中顯示錯誤訊息。 - * 以無效的授權簽署執行檔。 - * 應用程式的「程式碼簽署授權」檔案中指定的授權，不符合佈建設定檔中指定的授權。 - - 若要修正此問題，請在 Xcode 或 Cordova 應用程式 **config.xml** 檔案中指定正確的「軟體組 ID」。 - -1. 將最低支援的 API 或部署目標宣告新增至 Cordova 應用程式的 config.xml 檔案。minSdkVersion 值必須高於 15。targetSdkVersion 值必須一律反映可從 Google 取得的最新 Android SDK。 - * **Android** - 使用編輯器來開啟 config.xml 檔案，並將 `` 元素更新為最小及目標 SDK 版本： - - ``` - - - - - - ``` - * **iOS** - 使用部署目標宣告更新 元素： - - ``` - - - - - ``` - -1. 從 Cordova 指令行介面 (CLI) 中，使用下列指令新增平台：iOS 及（或）Android。 - - ``` - cordova platform add ios@3.9.0 - cordova platform add android - ``` -1. 從 Cordova 應用程式根目錄中，輸入下列指令來安裝 Cordova Push 外掛程式：**cordova plugin add ibm-mfp-push**。 - - 根據您新增的平台，您會看到與下列類似的內容： - - ``` - Installing "ibm-mfp-push" for android - Installing "ibm-mfp-push" for ios - ``` -1. 從 *your-app-root-folder* 中，使用下列指令，驗證已順利安裝 Cordova Core 及 Push 外掛程式：**cordova plugin list**。 - - 根據您新增的平台，您會看到與下列類似的內容： - - ``` - ibm-mfp-core 1.0.0 "MFPCore" - ibm-mfp-push 1.0.0 "MFPPush" - ``` -1. （僅限 iOS）- 配置 iOS 開發環境。 - a. 使用 Xcode 開啟 *your-app-name***/platforms/ios** 目錄中的 your-app-name.xcodeproj 檔案。 - - b. 新增橋接標頭。移至**建置設定 > Swift 編譯器 - 產生程式碼 > Objective-C 橋接標頭**，然後新增下列路徑：*your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - c. 新增 Frameworks 參數。移至**建置設定 > 鏈結 > Runpath 搜尋路徑**，然後新增下列參數： - ``` - @executable_path/Frameworks - ``` - d. 解除註解橋接標頭中的下列 Push import 陳述式。移至 *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** - - ``` - //#import - //#import - //#import - ``` - e. 使用 Xcode 建置並執行應用程式。 -1. （僅限 Android）- 使用下列指令建置 Android 專案：**cordova build android**。 - - **附註**：在 Android Studio 中開啟專案之前，必須先透過 Cordova CLI 建置 Cordova 應用程式。否則，將發生建置錯誤。 - - -# 起始設定 Cordova 外掛程式 -{: #cordova_initialize} - -您需要透過傳遞應用程式路徑及應用程式 GUID 來起始設定 Push Notification Service Cordova 外掛程式，才能使用該外掛程式。在起始設定外掛程式之後，您可以連接至在 Bluemix 儀表板中所建立的伺服器應用程式。Cordova 外掛程式是 Android 及 iOS Client SDK 的封套，可讓 Cordova 應用程式與 Bluemix 服務通訊。 - -1. 複製下列程式碼 Snippet，並將其貼入您的主要 JavaScript 檔案（通常位於 **www/js** 目錄下），以起始設定 BMSClient。 - - ``` - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - ``` -1. 修改程式碼 Snippet，以使用您的 Bluemix「路徑」及「應用程式 GUID」參數。按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的「路徑」及「應用程式 GUID」。請使用「路徑」及「應用程式 GUID」的值，作為 `BMSClient.initialize` 程式碼 Snippet 中的參數。 - - **附註**：如果您已使用 Cordova CLI（例如，Cordova create app-name 指令）建立 Cordova 應用程式，請將此 Javascript 程式碼放置在 **index.js** 檔案中 `onDeviceReady: function()` 函數內的 `app.receivedEvent` 函數後面，以起始設定 BMS 用戶端。 - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); - }, -``` - -# 登錄裝置 - -{: #cordova_register} - -若要向 Push Notification Service 登錄裝置，請呼叫 register 方法。 - -複製下列程式碼 Snippet，並將其貼入 Cordova 應用程式，以登錄裝置。 - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android 不使用 settings 參數。如果您只是建置 Android 應用程式，請傳遞空物件；例如： - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -如果您要自訂警示、徽章及音效內容，請將下列 JavaScript 程式碼 Snippet 新增至 Cordova 應用程式的 Web 組件。 - - - -``` - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -您可以使用 JSON.parse 存取 JavaScript 中成功回應參數的內容：**var token = JSON.parse(response).token** - - -可用的索引鍵如下：`token`、`userId` 及 `deviceId`。 - -下列 JavaScript 程式碼 Snippet 顯示如何起始設定 Bluemix Mobile Services Push Client SDK、向 Push Notification Service 登錄裝置，以及接聽推送通知。將此程式碼放入 JavaScript 檔案中。 - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -在 **onDeviceReady: function()** 內。 - -``` -onDeviceReady: function() { -app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification);} -``` - -## Objective-C -{: #cordova_register_objective} -將下列 Objective-C 程式碼 Snippet 新增至應用程式委派類別 - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##後續步驟 - -{: #cordova_register_next} - -1. 使用下列指令建置專案，然後執行專案： - - * Android - 依序執行 **cordova build android** 及 **cordova run android** - - * iOS - 依序執行 **cordova build ios** 及 **cordova run ios** - - - -# 在裝置上接收推送通知 -{: #cordova_receive} - -複製並貼上下列程式碼 Snippet，以在裝置上接收推送通知。 - -##JavaScript - -將下列 JavaScript 程式碼 Snippet 新增至 Cordova 應用程式的 Web 組件。 - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Android 通知內容 - -下節列出 Android 通知內容： - -* message - 推送通知訊息 -* payload - 包含通知有效負載的 JSON 物件 - - -##iOS 通知內容 - -下節列出 iOS 通知內容： - -* message - 推送通知訊息 -* payload - 包含通知有效負載的 JSON 物件 -* action-loc-key - 此字串用來作為索引鍵，在現行本地化中取得一個本地化字串，以用於右按鈕的標題，取代「檢視」。 -* badge - 顯示為應用程式圖示徽章的號碼。如果沒有此內容，則不會變更徽章。若要移除徽章，請將此內容的值設為 0。 -* sound - 應用程式組合或者應用程式資料容器之 Library/Sounds 資料夾中的音效檔名稱。 - -##Objective-C - -將下列 Objective-C 程式碼 Snippet 新增至應用程式委派類別。 - -``` -// Handle receiving a remote notification --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` - - - -# 傳送基本推送通知 -{: #push-send-notifications} - -開發應用程式之後，您可以傳送基本推送通知（不需要使用標籤、徽章、其他有效負載或音效檔）。 - - -傳送基本推送通知。 - -1. 在**選擇讀者**，請選取下列一個讀者：**所有裝置**，或依平台：**僅限 iOS 裝置**或**僅限 Anroid 裝置**。 - - **附註**：當您選取**所有裝置**選項時，所有已訂閱推送通知的裝置都會收到您的通知。 - - ![通知畫面](images/tag_notification.jpg) - -2. 在**建立通知**中，輸入您的訊息，然後按一下**傳送**。 -3. 驗證您的裝置已接收到通知。 - - 下列擷取畫面顯示在 Android 及 iOS 裝置的前景中處理推送通知的警示框。 - - ![Android 上的前景推送通知](images/Android_Screenshot.jpg) - - ![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) - - 下列擷取畫面顯示 Android 背景中的推送通知。 - ![Android 上的背景推送通知](images/background.jpg) - - - -# 後續步驟 -{: #next_steps_tags} - -順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 - -將這些 Push Notifications Service 特性新增至您的應用程式。 -若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 -若要使用進階通知選項，請參閱[進階推送通知](t_advance_notifications.html)。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 安裝 Cordova Push 外掛程式 +{: #cordova_install} + +安裝及使用 Client Push 外掛程式來進一步開發 Cordova 應用程式。這也會安裝起始設定您的 Bluemix 連線的 Cordova Core 外掛程式。 + +### 開始之前 + +1. 下載最新的 Android Studio SDK 及 Xcode 版本。 +1. 設定您的模擬器。若為 Android Studio，請使用支援 Google Play API 的模擬器。 +1. 安裝 Git 指令行工具。若為 Windows，請確保選取**從 Windows 命令提示字元執行 Git** 選項。如需如何下載並安裝此工具的相關資訊，請參閱 [Git](https://git-scm.com/downloads)。 + +1. 安裝 Node.js 及「Node 套件管理程式 (NPM)」工具。NPM 指令行工具與 Node.js 組合在一起。如需如何下載並安裝 Node.js 的相關資訊，請參閱 [Node.js](https://nodejs.org/en/download/)。 +1. 從指令行中，使用 **npm install -g cordova** 指令來安裝 Cordova 指令行工具。若要使用 Cordova Push 外掛程式，這是必要動作。如需如何安裝 Cordova 以及設定 Cordova 應用程式的相關資訊，請參閱 [Cordova Apache](https://cordova.apache.org/#getstarted)。 + + **附註**：若要檢視 Cordova Push 外掛程式 Readme 檔，請移至 [https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push](https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-cordova-plugin-push)。 + + +## 安裝 Cordova Push 外掛程式 +1. 切換至您要在其中建立 Cordova 應用程式的資料夾，並執行下列指令來建立 Cordova 應用程式。如果您有現存的 Cordova 應用程式，請移至步驟 3。 + +``` +cordova create your_app_name +cd your_app_name +``` +1. 選用項目：（選用）編輯 **config.xml** 檔案，並將 元素中的應用程式名稱變更為您選擇的名稱，而不是預設 HelloCordova 名稱。 + + **附註**：請確定指定正確的軟體組 ID。如果您未指定，則會在 Xcode 中顯示錯誤訊息。 + * 以無效的授權簽署執行檔。 + * 應用程式的「程式碼簽署授權」檔案中指定的授權，不符合佈建設定檔中指定的授權。 + + 若要修正此問題，請在 Xcode 或 Cordova 應用程式 **config.xml** 檔案中指定正確的「軟體組 ID」。 + +1. 將最低支援的 API 或部署目標宣告新增至 Cordova 應用程式的 config.xml 檔案。minSdkVersion 值必須高於 15。targetSdkVersion 值必須一律反映可從 Google 取得的最新 Android SDK。 + * **Android** - 使用編輯器來開啟 config.xml 檔案，並將 `` 元素更新為最小及目標 SDK 版本： + + ``` + + + + + + ``` + * **iOS** - 使用部署目標宣告更新 元素： + + ``` + + + + + ``` + +1. 從 Cordova 指令行介面 (CLI) 中，使用下列指令新增平台：iOS 及（或）Android。 + + ``` + cordova platform add ios@3.9.0 + cordova platform add android + ``` +1. 從 Cordova 應用程式根目錄中，輸入下列指令來安裝 Cordova Push 外掛程式：**cordova plugin add ibm-mfp-push**。 + + 根據您新增的平台，您會看到與下列類似的內容： + + ``` + Installing "ibm-mfp-push" for android + Installing "ibm-mfp-push" for ios + ``` +1. 從 *your-app-root-folder* 中，使用下列指令，驗證已順利安裝 Cordova Core 及 Push 外掛程式：**cordova plugin list**。 + + 根據您新增的平台，您會看到與下列類似的內容： + + ``` + ibm-mfp-core 1.0.0 "MFPCore" + ibm-mfp-push 1.0.0 "MFPPush" + ``` +1. （僅限 iOS）- 配置 iOS 開發環境。 + a. 使用 Xcode 開啟 *your-app-name***/platforms/ios** 目錄中的 your-app-name.xcodeproj 檔案。 + + b. 新增橋接標頭。移至**建置設定 > Swift 編譯器 - 產生程式碼 > Objective-C 橋接標頭**，然後新增下列路徑：*your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + c. 新增 Frameworks 參數。移至**建置設定 > 鏈結 > Runpath 搜尋路徑**，然後新增下列參數： + ``` + @executable_path/Frameworks + ``` + d. 解除註解橋接標頭中的下列 Push import 陳述式。移至 *your-project-name***/Plugins/ibm-mfp-core/Bridging-Header.h** + + ``` + //#import + //#import + //#import + ``` + e. 使用 Xcode 建置並執行應用程式。 +1. （僅限 Android）- 使用下列指令建置 Android 專案：**cordova build android**。 + + **附註**：在 Android Studio 中開啟專案之前，必須先透過 Cordova CLI 建置 Cordova 應用程式。否則，將發生建置錯誤。 + + +# 起始設定 Cordova 外掛程式 +{: #cordova_initialize} + +您需要透過傳遞應用程式路徑及應用程式 GUID 來起始設定 Push Notification Service Cordova 外掛程式，才能使用該外掛程式。在起始設定外掛程式之後，您可以連接至在 Bluemix 儀表板中所建立的伺服器應用程式。Cordova 外掛程式是 Android 及 iOS Client SDK 的封套，可讓 Cordova 應用程式與 Bluemix 服務通訊。 + +1. 複製下列程式碼 Snippet，並將其貼入您的主要 JavaScript 檔案（通常位於 **www/js** 目錄下），以起始設定 BMSClient。 + + ``` + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + ``` +1. 修改程式碼 Snippet，以使用您的 Bluemix「路徑」及「應用程式 GUID」參數。按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的「路徑」及「應用程式 GUID」。請使用「路徑」及「應用程式 GUID」的值，作為 `BMSClient.initialize` 程式碼 Snippet 中的參數。 + + **附註**：如果您已使用 Cordova CLI（例如，Cordova create app-name 指令）建立 Cordova 應用程式，請將此 Javascript 程式碼放置在 **index.js** 檔案中 `onDeviceReady: function()` 函數內的 `app.receivedEvent` 函數後面，以起始設定 BMS 用戶端。 + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://myapp.mybluemix.net","abcd1234-abcd-1234-abcd-abcd1234abcd"); + }, +``` + +# 登錄裝置 + +{: #cordova_register} + +若要向 Push Notification Service 登錄裝置，請呼叫 register 方法。 + +複製下列程式碼 Snippet，並將其貼入 Cordova 應用程式，以登錄裝置。 + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android 不使用 settings 參數。如果您只是建置 Android 應用程式，請傳遞空物件；例如： + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +如果您要自訂警示、徽章及音效內容，請將下列 JavaScript 程式碼 Snippet 新增至 Cordova 應用程式的 Web 組件。 + + + +``` + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +您可以使用 JSON.parse 存取 JavaScript 中成功回應參數的內容：**var token = JSON.parse(response).token** + + +可用的索引鍵如下：`token`、`userId` 及 `deviceId`。 + +下列 JavaScript 程式碼 Snippet 顯示如何起始設定 Bluemix Mobile Services Push Client SDK、向 Push Notification Service 登錄裝置，以及接聽推送通知。將此程式碼放入 JavaScript 檔案中。 + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +在 **onDeviceReady: function()** 內。 + +``` +onDeviceReady: function() { +app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification);} +``` + +## Objective-C +{: #cordova_register_objective} +將下列 Objective-C 程式碼 Snippet 新增至應用程式委派類別 + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## 後續步驟 + +{: #cordova_register_next} + +1. 使用下列指令建置專案，然後執行專案： + + * Android - 依序執行 **cordova build android** 及 **cordova run android** + + * iOS - 依序執行 **cordova build ios** 及 **cordova run ios** + + + +# 在裝置上接收推送通知 +{: #cordova_receive} + +複製並貼上下列程式碼 Snippet，以在裝置上接收推送通知。 + +## JavaScript + +將下列 JavaScript 程式碼 Snippet 新增至 Cordova 應用程式的 Web 組件。 + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +## Android 通知內容 + +下節列出 Android 通知內容： + +* message - 推送通知訊息 +* payload - 包含通知有效負載的 JSON 物件 + + +## iOS 通知內容 + +下節列出 iOS 通知內容： + +* message - 推送通知訊息 +* payload - 包含通知有效負載的 JSON 物件 +* action-loc-key - 此字串用來作為索引鍵，在現行本地化中取得一個本地化字串，以用於右按鈕的標題，取代「檢視」。 +* badge - 顯示為應用程式圖示徽章的號碼。如果沒有此內容，則不會變更徽章。若要移除徽章，請將此內容的值設為 0。 +* sound - 應用程式組合或者應用程式資料容器之 Library/Sounds 資料夾中的音效檔名稱。 + +## Objective-C + +將下列 Objective-C 程式碼 Snippet 新增至應用程式委派類別。 + +``` +// Handle receiving a remote notification +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +## Swift + +將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` + + + +# 傳送基本推送通知 +{: #push-send-notifications} + +開發應用程式之後，您可以傳送基本推送通知（不需要使用標籤、徽章、其他有效負載或音效檔）。 + + +傳送基本推送通知。 + +1. 在**選擇讀者**，請選取下列一個讀者：**所有裝置**，或依平台：**僅限 iOS 裝置**或**僅限 Anroid 裝置**。 + + **附註**：當您選取**所有裝置**選項時，所有已訂閱推送通知的裝置都會收到您的通知。 + + ![通知畫面](images/tag_notification.jpg) + +2. 在**建立通知**中，輸入您的訊息，然後按一下**傳送**。 +3. 驗證您的裝置已接收到通知。 + + 下列擷取畫面顯示在 Android 及 iOS 裝置的前景中處理推送通知的警示框。 + + ![Android 上的前景推送通知](images/Android_Screenshot.jpg) + + ![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) + + 下列擷取畫面顯示 Android 背景中的推送通知。 + ![Android 上的背景推送通知](images/background.jpg) + + + +# 後續步驟 +{: #next_steps_tags} + +順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 + +將這些 Push Notifications Service 特性新增至您的應用程式。 +若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 +若要使用進階通知選項，請參閱[進階推送通知](t_advance_notifications.html)。 diff --git a/services/mobilepush/nl/zh/TW/t_cordova_receive.md b/services/mobilepush/nl/zh/TW/t_cordova_receive.md index 89cc66021..30a3f1745 100644 --- a/services/mobilepush/nl/zh/TW/t_cordova_receive.md +++ b/services/mobilepush/nl/zh/TW/t_cordova_receive.md @@ -1,85 +1,85 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 在裝置上接收推送通知 -{: #cordova_receive} - -複製並貼上下列程式碼 Snippet，以在裝置上接收推送通知。 - -##JavaScript - -將下列 JavaScript 程式碼 Snippet 新增至 Cordova 應用程式的 Web 組件。 - - -``` -var notification = function(notification){ - // notification is a JSON object. - alert(notification.message); -}; -MFPPush.registerNotificationsCallback(notification); -``` - -##Android 通知內容 - -下節列出 Android 通知內容： - -* message - 推送通知訊息 -* payload - 包含通知有效負載的 JSON 物件 - - -##iOS 通知內容 - -下節列出 iOS 通知內容： - -* message - 推送通知訊息 -* payload - 包含通知有效負載的 JSON 物件 -* action-loc-key - 此字串用來作為索引鍵，在現行本地化中取得一個本地化字串，以用於右按鈕的標題，取代「檢視」。 -* badge - 顯示為應用程式圖示徽章的號碼。如果沒有此內容，則不會變更徽章。若要移除徽章，請將此內容的值設為 0。 -* sound - 應用程式組合或者應用程式資料容器之 Library/Sounds 資料夾中的音效檔名稱。 - -##Objective-C - -將下列 Objective-C 程式碼 Snippet 新增至應用程式委派類別。 - -``` -//Handle receiving a remote notification --(void)application:(UIApplication *)application - didReceiveRemoteNotification:(NSDictionary *)userInfo - fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { - [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; -} -``` - -``` -// Handle receiving a remote notification on launch -- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions - - [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; -} -``` - -##Swift - -將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 - -``` -// Handle receiving a remote notification -funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ - - CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) -} -``` - -``` -// Handle receiving a remote notification on launch -func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - - CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) -} - -``` -後續步驟。[傳送基本推送通知](t_send_push_notifications.html)。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 在裝置上接收推送通知 +{: #cordova_receive} + +複製並貼上下列程式碼 Snippet，以在裝置上接收推送通知。 + +## JavaScript + +將下列 JavaScript 程式碼 Snippet 新增至 Cordova 應用程式的 Web 組件。 + + +``` +var notification = function(notification){ + // notification is a JSON object. + alert(notification.message); +}; +MFPPush.registerNotificationsCallback(notification); +``` + +## Android 通知內容 + +下節列出 Android 通知內容： + +* message - 推送通知訊息 +* payload - 包含通知有效負載的 JSON 物件 + + +## iOS 通知內容 + +下節列出 iOS 通知內容： + +* message - 推送通知訊息 +* payload - 包含通知有效負載的 JSON 物件 +* action-loc-key - 此字串用來作為索引鍵，在現行本地化中取得一個本地化字串，以用於右按鈕的標題，取代「檢視」。 +* badge - 顯示為應用程式圖示徽章的號碼。如果沒有此內容，則不會變更徽章。若要移除徽章，請將此內容的值設為 0。 +* sound - 應用程式組合或者應用程式資料容器之 Library/Sounds 資料夾中的音效檔名稱。 + +## Objective-C + +將下列 Objective-C 程式碼 Snippet 新增至應用程式委派類別。 + +``` +//Handle receiving a remote notification +-(void)application:(UIApplication *)application + didReceiveRemoteNotification:(NSDictionary *)userInfo + fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { + [[CDVMFPPush sharedInstance] didReceiveRemoteNotification:userInfo]; +} +``` + +``` +// Handle receiving a remote notification on launch +- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions + + [[CDVMFPPush sharedInstance] didReceiveRemoteNotificationOnLaunch:launchOptions]; +} +``` + +## Swift + +將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 + +``` +// Handle receiving a remote notification +funcapplication(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: ){ + + CDVMFPPush.sharedInstance().didReceiveRemoteNotification(userInfo) +} +``` + +``` +// Handle receiving a remote notification on launch +func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + + CDVMFPPush.sharedInstance().didReceiveRemoteNotificationOnLaunch(launchOptions) +} + +``` +後續步驟。[傳送基本推送通知](t_send_push_notifications.html)。 diff --git a/services/mobilepush/nl/zh/TW/t_cordova_register.md b/services/mobilepush/nl/zh/TW/t_cordova_register.md index 43745c198..60bb36da4 100644 --- a/services/mobilepush/nl/zh/TW/t_cordova_register.md +++ b/services/mobilepush/nl/zh/TW/t_cordova_register.md @@ -1,141 +1,141 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 登錄裝置 - -{: #cordova_register} - -若要向 Push Notification Service 登錄裝置，請呼叫 register 方法。 - -複製下列程式碼 Snippet，並將其貼入 Cordova 應用程式，以登錄裝置。 - -``` - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - MFPPush.registerDevice({}, success, failure); -``` - -## Android -{: #cordova_register_android} -Android 不使用 settings 參數。如果您只是建置 Android 應用程式，請傳遞空物件；例如： - -``` - MFPPush.registerDevice({}, success, failure); - MFPPush.unregisterDevice(success, failure); -``` - -## iOS -{: #cordova_register_ios} -如果您要自訂警示、徽章及音效內容，請將下列 JavaScript 程式碼 Snippet 新增至 Cordova 應用程式的 Web 組件。 - - - -``` - var settings = { -ios: { -alert: true, - badge: true, - sound: true - } - } - MFPPush.registerDevice(settings, success, failure); -``` - - - -##JavaScript -{: #cordova_register_js} - -``` -MFPPush.registerDevice({}, success, failure); -``` - -您可以使用 JSON.parse 存取 JavaScript 中成功回應參數的內容：**var token = JSON.parse(response).token** - - -可用的索引鍵如下：`token`、`userId` 及 `deviceId`。 - -下列 JavaScript 程式碼 Snippet 顯示如何起始設定 Bluemix Mobile Services Push Client SDK、向 Push Notification Service 登錄裝置，以及接聽推送通知。將此程式碼放入 JavaScript 檔案中。 - - - -``` -//Register device token with Bluemix Push Notification Service -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -``` - -``` -//Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ -CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -在 **onDeviceReady: function()** 內。 - -``` -onDeviceReady: function() { - app.receivedEvent('deviceready'); - BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); - var success = function(message) { console.log("Success: " + message); }; - var failure = function(message) { console.log("Error: " + message); }; - var settings = { - ios: { - alert: true, - badge: true, - sound: true - } - }; - MFPPush.registerDevice(settings, success, failure); - var notification = function(notif){ - alert (notif.message); - }; - MFPPush.registerNotificationsCallback(notification); - - } -``` - -## Objective-C -{: #cordova_register_objective} -將下列 Objective-C 程式碼 Snippet 新增至應用程式委派類別 - -``` - // Register the device token with Bluemix Push Notification Service - - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { - [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; - } - // Handle error when failed to register device token with APNs - - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { - [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; - } -``` - -##Swift -{: #cordova_register_swift} -將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 - -``` -funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) -} -// Handle error when failed to register device token with APNs -funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ - CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) -} -``` - -##後續步驟 -{: #cordova_register_next} - -1. 使用下列指令建置專案，然後執行專案： - - * Android - 依序執行 **cordova build android** 及 **cordova run android** - - * iOS - 依序執行 **cordova build ios** 及 **cordova run ios** -1. [在裝置上接收推送通知](t_cordova_receive.html)。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 登錄裝置 + +{: #cordova_register} + +若要向 Push Notification Service 登錄裝置，請呼叫 register 方法。 + +複製下列程式碼 Snippet，並將其貼入 Cordova 應用程式，以登錄裝置。 + +``` + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + MFPPush.registerDevice({}, success, failure); +``` + +## Android +{: #cordova_register_android} +Android 不使用 settings 參數。如果您只是建置 Android 應用程式，請傳遞空物件；例如： + +``` + MFPPush.registerDevice({}, success, failure); + MFPPush.unregisterDevice(success, failure); +``` + +## iOS +{: #cordova_register_ios} +如果您要自訂警示、徽章及音效內容，請將下列 JavaScript 程式碼 Snippet 新增至 Cordova 應用程式的 Web 組件。 + + + +``` + var settings = { +ios: { +alert: true, + badge: true, + sound: true + } + } + MFPPush.registerDevice(settings, success, failure); +``` + + + +## JavaScript +{: #cordova_register_js} + +``` +MFPPush.registerDevice({}, success, failure); +``` + +您可以使用 JSON.parse 存取 JavaScript 中成功回應參數的內容：**var token = JSON.parse(response).token** + + +可用的索引鍵如下：`token`、`userId` 及 `deviceId`。 + +下列 JavaScript 程式碼 Snippet 顯示如何起始設定 Bluemix Mobile Services Push Client SDK、向 Push Notification Service 登錄裝置，以及接聽推送通知。將此程式碼放入 JavaScript 檔案中。 + + + +``` +//Register device token with Bluemix Push Notification Service +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +``` + +``` +//Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ +CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +在 **onDeviceReady: function()** 內。 + +``` +onDeviceReady: function() { + app.receivedEvent('deviceready'); + BMSClient.initialize("https://http://myroute_mybluemix.net","my_appGuid"); + var success = function(message) { console.log("Success: " + message); }; + var failure = function(message) { console.log("Error: " + message); }; + var settings = { + ios: { + alert: true, + badge: true, + sound: true + } + }; + MFPPush.registerDevice(settings, success, failure); + var notification = function(notif){ + alert (notif.message); + }; + MFPPush.registerNotificationsCallback(notification); + + } +``` + +## Objective-C +{: #cordova_register_objective} +將下列 Objective-C 程式碼 Snippet 新增至應用程式委派類別 + +``` + // Register the device token with Bluemix Push Notification Service + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { + [[CDVMFPPush sharedInstance] didRegisterForRemoteNotifications:deviceToken]; + } + // Handle error when failed to register device token with APNs + - (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error { + [[CDVMFPPush sharedInstance] didFailToRegisterForRemoteNotificationsWithError:error]; + } +``` + +## Swift +{: #cordova_register_swift} +將下列 Swift 程式碼 Snippet 新增至應用程式委派類別。 + +``` +funcapplication(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + CDVMFPPush.sharedInstance().didRegisterForRemoteNotifications(deviceToken) +} +// Handle error when failed to register device token with APNs +funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSErrorPointer){ + CDVMFPPush.sharedInstance().didFailToRegisterForRemoteNotifications(error) +} +``` + +## 後續步驟 +{: #cordova_register_next} + +1. 使用下列指令建置專案，然後執行專案： + + * Android - 依序執行 **cordova build android** 及 **cordova run android** + + * iOS - 依序執行 **cordova build ios** 及 **cordova run ios** +1. [在裝置上接收推送通知](t_cordova_receive.html)。 diff --git a/services/mobilepush/nl/zh/TW/t_create_push_instance.md b/services/mobilepush/nl/zh/TW/t_create_push_instance.md index ae0ac0cae..6cea0c9f5 100644 --- a/services/mobilepush/nl/zh/TW/t_create_push_instance.md +++ b/services/mobilepush/nl/zh/TW/t_create_push_instance.md @@ -1,32 +1,32 @@ -# 建立 Push 服務實例 -{: #create-push-instance} - -若要開始使用 {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}，請先建立 {{site.data.keyword.Bluemix}} 應用程式；例如，Node.js 應用程式。然後，建立需要連結至此 Bluemix 應用程式之 Push 服務 ({{site.data.keyword.mobilepushfull}}) 的實例。另一種作法為移至 Bluemix 型錄的「樣板」區段，然後按一下 MobileFirst Services Starter。 - -**附註**：如果您已配置組織來管理環境，請選取該組織，而您要在該組織中建立針對行動應用程式的運行環境及服務。 - - -1. 如果您沒有 Bluemix 應用程式，則需要予以建立（例如，Node.js 應用程式）。若要建立 Bluemix 應用程式，請移至 Bluemix 儀表板，然後按一下**建立應用程式**。 - - **附註**：如果已有應用程式，請移至步驟 7 來新增服務。![建立服務實例](images/create_service_instance1.jpg "建立服務實例") - -1. 從**選擇應用程式範本**中，按一下 **WEB**。 - -3. 在**選取起點**區域中，選取 **SDK for Node.js**，然後按一下**繼續**。![起點](images/create_service_nodejs2.jpg) - -4. 從**空間**下拉功能表中，選取您的組織空間。![選取組織空間](images/create_a_service3.jpg) -1. 在**名稱**中，輸入您應用程式的名稱，然後在主機中輸入主機名稱。 - -1. 從**選取的方案**下拉功能表中選取方案，然後按一下**建立**按鈕。請等待應用程式編譯打包。 - -1. 按一下**概觀**鏈結。![新增服務](images/create_service_add4.jpg) -1. 按一下**新增服務**。即會顯示「型錄」畫面。 - -1. 選取 **IBM Push Notifications：**，然後從**空間**下拉功能表中，選取您的組織。![組織空間下拉功能表](images/create_service_org.jpg) -1. 在**服務**名稱中，輸入 Push Notification Service 名稱。 - -1. 在**選取的方案**中選取方案，然後按一下**建立**按鈕。 - -1. 按一下**是**，以重新編譯打包應用程式。![IBM Push Notification Service](images/create_service_notification5.jpg) - -1. 按一下 **Push Notifications**，以顯示 Push Notifications 儀表板。 +# 建立 Push 服務實例 +{: #create-push-instance} + +若要開始使用 {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}，請先建立 {{site.data.keyword.Bluemix}} 應用程式；例如，Node.js 應用程式。然後，建立需要連結至此 Bluemix 應用程式之 Push 服務 ({{site.data.keyword.mobilepushfull}}) 的實例。另一種作法為移至 Bluemix 型錄的「樣板」區段，然後按一下 MobileFirst Services Starter。 + +**附註**：如果您已配置組織來管理環境，請選取該組織，而您要在該組織中建立針對行動應用程式的運行環境及服務。 + + +1. 如果您沒有 Bluemix 應用程式，則需要予以建立（例如，Node.js 應用程式）。若要建立 Bluemix 應用程式，請移至 Bluemix 儀表板，然後按一下**建立應用程式**。 + + **附註**：如果已有應用程式，請移至步驟 7 來新增服務。![建立服務實例](images/create_service_instance1.jpg "建立服務實例") + +1. 從**選擇應用程式範本**中，按一下 **WEB**。 + +3. 在**選取起點**區域中，選取 **SDK for Node.js**，然後按一下**繼續**。![起點](images/create_service_nodejs2.jpg) + +4. 從**空間**下拉功能表中，選取您的組織空間。![選取組織空間](images/create_a_service3.jpg) +1. 在**名稱**中，輸入您應用程式的名稱，然後在主機中輸入主機名稱。 + +1. 從**選取的方案**下拉功能表中選取方案，然後按一下**建立**按鈕。請等待應用程式編譯打包。 + +1. 按一下**概觀**鏈結。![新增服務](images/create_service_add4.jpg) +1. 按一下**新增服務**。即會顯示「型錄」畫面。 + +1. 選取 **IBM Push Notifications：**，然後從**空間**下拉功能表中，選取您的組織。![組織空間下拉功能表](images/create_service_org.jpg) +1. 在**服務**名稱中，輸入 Push Notification Service 名稱。 + +1. 在**選取的方案**中選取方案，然後按一下**建立**按鈕。 + +1. 按一下**是**，以重新編譯打包應用程式。![IBM Push Notification Service](images/create_service_notification5.jpg) + +1. 按一下 **Push Notifications**，以顯示 Push Notifications 儀表板。 diff --git a/services/mobilepush/nl/zh/TW/t_enable-ios-notifications-receive.md b/services/mobilepush/nl/zh/TW/t_enable-ios-notifications-receive.md index a2073b98d..0b79f72e2 100644 --- a/services/mobilepush/nl/zh/TW/t_enable-ios-notifications-receive.md +++ b/services/mobilepush/nl/zh/TW/t_enable-ios-notifications-receive.md @@ -1,32 +1,32 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 在 iOS 裝置上接收推送通知 -{: #enable-push-ios-notifications-receiving} - -在 iOS 裝置上接收推送通知。 - -##Objective-C -若要在 iOS 裝置上接收推送通知，請將下列 Objective-C 方法新增至應用程式的應用程式委派。 - -``` -// For Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -若要在 iOS 裝置上接收推送通知，請將下列 Swift 方法新增至應用程式的應用程式委派。 - -``` -// For Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { -//UserInfo dictionary will contain data sent from the server - } -``` - +--- + +copyright: + years: 2015, 2016 + +--- + +# 在 iOS 裝置上接收推送通知 +{: #enable-push-ios-notifications-receiving} + +在 iOS 裝置上接收推送通知。 + +## Objective-C +若要在 iOS 裝置上接收推送通知，請將下列 Objective-C 方法新增至應用程式的應用程式委派。 + +``` +// For Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +## Swift +若要在 iOS 裝置上接收推送通知，請將下列 Swift 方法新增至應用程式的應用程式委派。 + +``` +// For Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { +//UserInfo dictionary will contain data sent from the server + } +``` + diff --git a/services/mobilepush/nl/zh/TW/t_enable_actionable_notifications_ios.md b/services/mobilepush/nl/zh/TW/t_enable_actionable_notifications_ios.md index 4e729f4a2..113307ec3 100644 --- a/services/mobilepush/nl/zh/TW/t_enable_actionable_notifications_ios.md +++ b/services/mobilepush/nl/zh/TW/t_enable_actionable_notifications_ios.md @@ -1,100 +1,100 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 啟用 iOS 可採取動作的通知 -{: #enable-actionable-notifications-ios} - -和傳統推送通知不同，可採取動作的通知會提示使用者在接收通知警示時做選擇，而不必開啟應用程式。請使用下列指示，在應用程式中啟用可採取動作的推送通知。 - -1. 建立使用者回應動作。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; - acceptAction.identifier = @"ACCEPT_ACTION"; - acceptAction.title = @"Accept"; - /* Optional properties - acceptAction.destructive = NO; - acceptAction.authenticationRequired = NO; */ - ``` - - Swift - - ``` - let acceptAction = UIMutableUserNotificationAction() - acceptAction.identifier = "ACCEPT_ACTION" - acceptAction.title = "Accept" - acceptAction.destructive = false - acceptAction.authenticationRequired = false - acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ - ``` - ``` - let declineAction = UIMutableUserNotificationAction() - declineAction.identifier = "DECLINE_ACTION" - declineAction.title = "Decline" - declineAction.destructive = true - declineAction.authenticationRequired = false - declineAction.activationMode = UIUserNotificationActivationMode.Background - ``` - -2. 建立通知種類並設定動作。**UIUserNotificationActionContextDefault** 或 **UIUserNotificationActionContextMinimal** 是有效的環境定義。 - - Objective-C - - ``` - // For Objective-C - UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; - callCat.identifier = @"POLL_CATEGORY"; - [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; - ``` - - Swift - - ``` - // For Swift - let pushCategory = UIMutableUserNotificationCategory() - pushCategory.identifier = "TODO_CATEGORY" - pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) - ``` - -1. 建立通知設定，並指派前一個步驟的種類。 - - Objective-C - - ``` - // For Objective-C - NSSet *categories = [NSSet setWithObjects:callCat, nil]; - ``` - - Swift - - ``` - // For Swift - let categories = NSSet(array:[pushCategory]); - ``` - -1. 建立本端或遠端通知，並為其指派種類身分。 - - Objective-C - - ``` - //For Objective-C - - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; -[[UIApplication sharedApplication] registerForRemoteNotifications]; - ``` - - Swift - - ``` - //For Swift - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories)application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - ``` +--- + +copyright: + years: 2015, 2016 + +--- + +# 啟用 iOS 可採取動作的通知 +{: #enable-actionable-notifications-ios} + +和傳統推送通知不同，可採取動作的通知會提示使用者在接收通知警示時做選擇，而不必開啟應用程式。請使用下列指示，在應用程式中啟用可採取動作的推送通知。 + +1. 建立使用者回應動作。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationAction *acceptAction = [[UIMutableUserNotificationAction alloc] init]; + acceptAction.identifier = @"ACCEPT_ACTION"; + acceptAction.title = @"Accept"; + /* Optional properties + acceptAction.destructive = NO; + acceptAction.authenticationRequired = NO; */ + ``` + + Swift + + ``` + let acceptAction = UIMutableUserNotificationAction() + acceptAction.identifier = "ACCEPT_ACTION" + acceptAction.title = "Accept" + acceptAction.destructive = false + acceptAction.authenticationRequired = false + acceptAction.activationMode = UIUserNotificationActivationMode.Foreground*/ + ``` + ``` + let declineAction = UIMutableUserNotificationAction() + declineAction.identifier = "DECLINE_ACTION" + declineAction.title = "Decline" + declineAction.destructive = true + declineAction.authenticationRequired = false + declineAction.activationMode = UIUserNotificationActivationMode.Background + ``` + +2. 建立通知種類並設定動作。**UIUserNotificationActionContextDefault** 或 **UIUserNotificationActionContextMinimal** 是有效的環境定義。 + + Objective-C + + ``` + // For Objective-C + UIMutableUserNotificationCategory *callCat = [[UIMutableUserNotificationCategory alloc] init]; + callCat.identifier = @"POLL_CATEGORY"; + [callCat setActions:@[acceptAction, declineAction] forContext:UIUserNotificationActionContextDefault]; + ``` + + Swift + + ``` + // For Swift + let pushCategory = UIMutableUserNotificationCategory() + pushCategory.identifier = "TODO_CATEGORY" + pushCategory.setActions([acceptAction, declineAction], forContext: UIUserNotificationActionContext.Default) + ``` + +1. 建立通知設定，並指派前一個步驟的種類。 + + Objective-C + + ``` + // For Objective-C + NSSet *categories = [NSSet setWithObjects:callCat, nil]; + ``` + + Swift + + ``` + // For Swift + let categories = NSSet(array:[pushCategory]); + ``` + +1. 建立本端或遠端通知，並為其指派種類身分。 + + Objective-C + + ``` + //For Objective-C + + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; +[[UIApplication sharedApplication] registerForRemoteNotifications]; + ``` + + Swift + + ``` + //For Swift + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories)application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + ``` diff --git a/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_initialize.md b/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_initialize.md index 83f44c69f..00632bb3e 100644 --- a/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_initialize.md +++ b/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_initialize.md @@ -1,63 +1,63 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 起始設定 Push SDK for iOS 應用程式 -{: #enable-push-ios-notifications-initialize} - -放置起始設定碼的一般位置位於 iOS 應用程式的應用程式委派中。按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的路徑及應用程式 GUID。 - -##起始設定 Core SDK - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstancemyBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - -##起始設定 Client Push SDK - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## 路徑、GUID 及 Bluemix 地區 - -**appRoute** - -指定指派給您在 Bluemix 上所建立之伺服器應用程式的路徑。 - -**GUID** - -指定指派給您在 Bluemix 上所建立之應用程式的唯一索引鍵。此值區分大小寫。 - -**bluemixRegionSuffix** - -指定管理應用程式的位置。`bluemixRegion` 參數指定您所使用的 Bluemix 部署。您可以使用 `BMSClient.REGION` 靜態內容設定此值，然後使用下列三個值的其中一個： - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY +--- + +copyright: + years: 2015, 2016 + +--- + +# 起始設定 Push SDK for iOS 應用程式 +{: #enable-push-ios-notifications-initialize} + +放置起始設定碼的一般位置位於 iOS 應用程式的應用程式委派中。按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的路徑及應用程式 GUID。 + +## 起始設定 Core SDK + +### Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +### Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstancemyBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + +## 起始設定 Client Push SDK + +### Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +### Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## 路徑、GUID 及 Bluemix 地區 + +**appRoute** + +指定指派給您在 Bluemix 上所建立之伺服器應用程式的路徑。 + +**GUID** + +指定指派給您在 Bluemix 上所建立之應用程式的唯一索引鍵。此值區分大小寫。 + +**bluemixRegionSuffix** + +指定管理應用程式的位置。`bluemixRegion` 參數指定您所使用的 Bluemix 部署。您可以使用 `BMSClient.REGION` 靜態內容設定此值，然後使用下列三個值的其中一個： + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY diff --git a/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_install.md b/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_install.md index 5510b8603..b1b7df0f7 100644 --- a/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_install.md +++ b/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_install.md @@ -1,317 +1,317 @@ -# 起始設定 Push SDK for iOS 應用程式 -{: #enable-push-ios-notifications-install} - -若為現有的 Xcode 專案，您可以使用 CocoaPods 相依關係管理工具來設定 Bluemix Mobile Services Client SDK。替代方案是手動安裝 SDK。 - -**附註**：若要檢視 Swift Push Readme 檔，請移至 https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master - -##安裝 CocoaPods - -1. 在 Mac 終端機中，使用下列指令來安裝 CocoaPods。 -``` -$ sudo gem install cocoapods -``` -2. 在終端機中輸入下列指令，以起始設定 CocoaPods。發出此指令時，請確定是在 Xcode 專案所在的目錄中執行它。`pod init` 指令會建立檔案標題。 - -``` -$ pod init -``` -3. 在產生的 Podfile 中，新增您需要的 SDK 相依關係。請複製下列 Podfile。 - - Objective-C - - ``` -source 'https://github.com/CocoaPods/Specs.git' - Copy the following list as is and remove the dependencies you do not need - pod 'IMFCore' - pod 'IMFPush' - ``` - - Swift - - ``` - source 'https://github.com/CocoaPods/Specs.git' - // Copy the following list as is and remove the dependencies you do not need. - use_frameworks! - target 'MyApp' do - platform :ios, '8.0' - pod 'BMSCore' - pod 'BMSPush' - end - ``` -3. 從「終端機」中，移至您的專案資料夾，並使用下列指令來安裝相依關係： -``` -$ pod update -``` -該指令會安裝相依關係並建立新的 Xcode 工作區。**附註**：請確定您一律開啟新的 Xcode 工作區，而不是原始 Xcode 專案檔： - - ``` - $ open App.xcworkspace - ``` -工作區會包含原始專案以及包含相依關係的 Pods 專案。如果您想要修改 Bluemix Mobile Services 來源資料夾，則可以在 Pods 專案的 `Pods/yourImportedSourceFolder` 下找到它，例如：`Pods/IMFGoogleAuthentication`。 - -##使用匯入的架構和來源資料夾 - -在您的程式碼中參照 SDK。 - - -### Objective-C - -撰寫相關標頭的 #import 指引，例如： - -``` -//Objective-C -#import -#import -``` - -**附註**：使用 CocoaPods 指令 `pod install` 或 `pod update` 更新 Pods 專案時，可能會置換 Bluemix Mobile Services 來源資料夾。如果您要保留原始檔案的自訂版本，請確保先進行備份，然後再發出下列其中一個指令。 - -###Swift - -**先決條件** - -- iOS 8.0 或以上版本 -- Xcode 7 - - -撰寫相關標頭的 #import 指引，例如： - -``` -//swift -import BMSCore -import BMSPush -``` - - -##建置設定 - -移至 **Xcode > 建置設定 > 建置選項，然後將啟用位元碼**設為**否**。 - -**注意**：自 iOS 9 開始，對「應用程式傳輸安全 (ATS)」特性進行的變更可能會影響您處理鑑別處理程序的方式。下列部落格文章說明了這些變更的相關資訊：[ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) 及 [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) - - - - -# 起始設定 Push SDK for iOS 應用程式 -{: #enable-push-ios-notifications-initialize} - -放置起始設定碼的一般位置位於 iOS 應用程式的應用程式委派中。按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的路徑及應用程式 GUID。 - -##起始設定 Core SDK - -###Objective-C - -``` -// Initialize the SDK for Object-C with IBM Bluemix GUID and route -IMFClient *imfClient = [IMFClient sharedInstance]; -[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; -``` - -###Swift - -``` -// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region -let myBMSClient = BMSClient.sharedInstance - -myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") -myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds -``` - - -##起始設定 Client Push SDK - -###Objective-C - -``` -//Initialize client Push SDK for Objective-C -IMFPushClient _pushService = [IMFPushClient sharedInstance]; -``` - -###Swift - -``` -//Initialize client Push SDK for Swift -let push = BMSPushClient.sharedInstance -``` - -## 路徑、GUID 及 Bluemix 地區 - -**appRoute** - -指定指派給您在 Bluemix 上所建立之伺服器應用程式的路徑。 - -**GUID** - -指定指派給您在 Bluemix 上所建立之應用程式的唯一索引鍵。此值區分大小寫。 - -**bluemixRegionSuffix** - -指定管理應用程式的位置。`bluemixRegion` 參數指定您所使用的 Bluemix 部署。您可以使用 `BMSClient.REGION` 靜態內容設定此值，然後使用下列三個值的其中一個： - -- BMSClient.REGION_US_SOUTH -- BMSClient.REGION_UK -- BMSClient.REGION_SYDNEY - - - - -# 登錄 iOS 應用程式及裝置 -{: #enable-push-ios-notifications-register} - - -應用程式必須向 APNs 登錄才能接收遠端通知，這通常發生在應用程式安裝到裝置上之後。在應用程式接收到 APNs 所產生的裝置記號之後，必須將裝置記號傳回給 Push Notifications Service。 - -若要登錄 iOS 應用程式及裝置，請執行下列動作： - -1. 建立後端應用程式 -2. 將記號傳遞至 Push Notifications - - -##建立後端應用程式 - -在 Bluemix® 型錄的「樣板」區段中建立後端應用程式，以自動將 Push 服務連結至此應用程式。如果您已建立後端應用程式，請確定將應用程式連結至 Push Notification Service。 - -###Objective-C - -``` - //For Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##將記號傳遞至 Push Notifications - -從 APNs 接收到記號之後，將記號傳遞至 Push Notifications，這是 `registerDevice:withDeviceToken` 方法的一部分。 - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -從 APNS 接收到記號之後，將記號傳遞至 Push Notifications，這是 `didRegisterForRemoteNotificationsWithDeviceToken` 方法的一部分。 - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` - - - -# 在 iOS 裝置上接收推送通知 -{: #enable-push-ios-notifications-receiving} - -在 iOS 裝置上接收推送通知。 - -##Objective-C -若要在 iOS 裝置上接收推送通知，請將下列 Objective-C 方法新增至應用程式的應用程式委派。 - -``` -// For Objective-C --(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { -//userInfo dictionary will contain data sent from server. -} -``` - -##Swift -若要在 iOS 裝置上接收推送通知，請將下列 Swift 方法新增至應用程式的應用程式委派。 - -``` - // For Swift -func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { - //UserInfo dictionary will contain data sent from the server - } - -``` - - - -# 傳送基本推送通知 -{: #push-send-notifications} - -開發應用程式之後，您可以傳送基本推送通知（不需要使用標籤、徽章、其他有效負載或音效檔）。 - - -傳送基本推送通知。 - -1. 在**選擇讀者**，請選取下列一個讀者：**所有裝置**，或依平台：**僅限 iOS 裝置**或**僅限 Anroid 裝置**。 - - **附註**：當您選取**所有裝置**選項時，所有已訂閱推送通知的裝置都會收到您的通知。 - - ![通知畫面](images/tag_notification.jpg) - -2. 在**建立通知**中，輸入您的訊息，然後按一下**傳送**。 -3. 驗證您的裝置已接收到通知。 - - 下列擷取畫面顯示在 Android 及 iOS 裝置的前景中處理推送通知的警示框。 - - ![Android 上的前景推送通知](images/Android_Screenshot.jpg) - - ![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) - - 下列擷取畫面顯示 Android 背景中的推送通知。 - ![Android 上的背景推送通知](images/background.jpg) - - - - -# 後續步驟 -{: #next_steps_tags} - -順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 - -將這些 Push Notifications Service 特性新增至您的應用程式。 -若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 -若要使用進階通知選項，請參閱[進階推送通知](t_advance_notifications.html)。 +# 起始設定 Push SDK for iOS 應用程式 +{: #enable-push-ios-notifications-install} + +若為現有的 Xcode 專案，您可以使用 CocoaPods 相依關係管理工具來設定 Bluemix Mobile Services Client SDK。替代方案是手動安裝 SDK。 + +**附註**：若要檢視 Swift Push Readme 檔，請移至 https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master + +## 安裝 CocoaPods + +1. 在 Mac 終端機中，使用下列指令來安裝 CocoaPods。 +``` +$ sudo gem install cocoapods +``` +2. 在終端機中輸入下列指令，以起始設定 CocoaPods。發出此指令時，請確定是在 Xcode 專案所在的目錄中執行它。`pod init` 指令會建立檔案標題。 + +``` +$ pod init +``` +3. 在產生的 Podfile 中，新增您需要的 SDK 相依關係。請複製下列 Podfile。 + + Objective-C + + ``` +source 'https://github.com/CocoaPods/Specs.git' + Copy the following list as is and remove the dependencies you do not need + pod 'IMFCore' + pod 'IMFPush' + ``` + + Swift + + ``` + source 'https://github.com/CocoaPods/Specs.git' + // Copy the following list as is and remove the dependencies you do not need. + use_frameworks! + target 'MyApp' do + platform :ios, '8.0' + pod 'BMSCore' + pod 'BMSPush' + end + ``` +3. 從「終端機」中，移至您的專案資料夾，並使用下列指令來安裝相依關係： +``` +$ pod update +``` +該指令會安裝相依關係並建立新的 Xcode 工作區。**附註**：請確定您一律開啟新的 Xcode 工作區，而不是原始 Xcode 專案檔： + + ``` + $ open App.xcworkspace + ``` +工作區會包含原始專案以及包含相依關係的 Pods 專案。如果您想要修改 Bluemix Mobile Services 來源資料夾，則可以在 Pods 專案的 `Pods/yourImportedSourceFolder` 下找到它，例如：`Pods/IMFGoogleAuthentication`。 + +## 使用匯入的架構和來源資料夾 + +在您的程式碼中參照 SDK。 + + +### Objective-C + +撰寫相關標頭的 #import 指引，例如： + +``` +//Objective-C +#import +#import +``` + +**附註**：使用 CocoaPods 指令 `pod install` 或 `pod update` 更新 Pods 專案時，可能會置換 Bluemix Mobile Services 來源資料夾。如果您要保留原始檔案的自訂版本，請確保先進行備份，然後再發出下列其中一個指令。 + +### Swift + +**先決條件** + +- iOS 8.0 或以上版本 +- Xcode 7 + + +撰寫相關標頭的 #import 指引，例如： + +``` +//swift +import BMSCore +import BMSPush +``` + + +## 建置設定 + +移至 **Xcode > 建置設定 > 建置選項，然後將啟用位元碼**設為**否**。 + +**注意**：自 iOS 9 開始，對「應用程式傳輸安全 (ATS)」特性進行的變更可能會影響您處理鑑別處理程序的方式。下列部落格文章說明了這些變更的相關資訊：[ATS and Bitcode in iOS 9](https://developer.ibm.com/mobilefirstplatform/2015/09/09/ats-and-bitcode-in-ios9/) 及 [Connect your iOS 9 app to Bluemix today](https://developer.ibm.com/bluemix/2015/09/16/connect-your-ios-9-app-to-bluemix/) + + + + +# 起始設定 Push SDK for iOS 應用程式 +{: #enable-push-ios-notifications-initialize} + +放置起始設定碼的一般位置位於 iOS 應用程式的應用程式委派中。按一下「Bluemix 應用程式儀表板」中的**行動選項**鏈結，以取得應用程式的路徑及應用程式 GUID。 + +## 起始設定 Core SDK + +### Objective-C + +``` +// Initialize the SDK for Object-C with IBM Bluemix GUID and route +IMFClient *imfClient = [IMFClient sharedInstance]; +[imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; +``` + +### Swift + +``` +// Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region +let myBMSClient = BMSClient.sharedInstance + +myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "APPGUID", bluemixRegion:"Location where your app Hosted") +myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds +``` + + +## 起始設定 Client Push SDK + +### Objective-C + +``` +//Initialize client Push SDK for Objective-C +IMFPushClient _pushService = [IMFPushClient sharedInstance]; +``` + +### Swift + +``` +//Initialize client Push SDK for Swift +let push = BMSPushClient.sharedInstance +``` + +## 路徑、GUID 及 Bluemix 地區 + +**appRoute** + +指定指派給您在 Bluemix 上所建立之伺服器應用程式的路徑。 + +**GUID** + +指定指派給您在 Bluemix 上所建立之應用程式的唯一索引鍵。此值區分大小寫。 + +**bluemixRegionSuffix** + +指定管理應用程式的位置。`bluemixRegion` 參數指定您所使用的 Bluemix 部署。您可以使用 `BMSClient.REGION` 靜態內容設定此值，然後使用下列三個值的其中一個： + +- BMSClient.REGION_US_SOUTH +- BMSClient.REGION_UK +- BMSClient.REGION_SYDNEY + + + + +# 登錄 iOS 應用程式及裝置 +{: #enable-push-ios-notifications-register} + + +應用程式必須向 APNs 登錄才能接收遠端通知，這通常發生在應用程式安裝到裝置上之後。在應用程式接收到 APNs 所產生的裝置記號之後，必須將裝置記號傳回給 Push Notifications Service。 + +若要登錄 iOS 應用程式及裝置，請執行下列動作： + +1. 建立後端應用程式 +2. 將記號傳遞至 Push Notifications + + +## 建立後端應用程式 + +在 Bluemix® 型錄的「樣板」區段中建立後端應用程式，以自動將 Push 服務連結至此應用程式。如果您已建立後端應用程式，請確定將應用程式連結至 Push Notification Service。 + +### Objective-C + +``` + //For Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +### Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +## 將記號傳遞至 Push Notifications + +從 APNs 接收到記號之後，將記號傳遞至 Push Notifications，這是 `registerDevice:withDeviceToken` 方法的一部分。 + +### Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +### Swift + +從 APNS 接收到記號之後，將記號傳遞至 Push Notifications，這是 `didRegisterForRemoteNotificationsWithDeviceToken` 方法的一部分。 + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` + + + +# 在 iOS 裝置上接收推送通知 +{: #enable-push-ios-notifications-receiving} + +在 iOS 裝置上接收推送通知。 + +## Objective-C +若要在 iOS 裝置上接收推送通知，請將下列 Objective-C 方法新增至應用程式的應用程式委派。 + +``` +// For Objective-C +-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo { +//userInfo dictionary will contain data sent from server. +} +``` + +## Swift +若要在 iOS 裝置上接收推送通知，請將下列 Swift 方法新增至應用程式的應用程式委派。 + +``` + // For Swift +func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) { + //UserInfo dictionary will contain data sent from the server + } + +``` + + + +# 傳送基本推送通知 +{: #push-send-notifications} + +開發應用程式之後，您可以傳送基本推送通知（不需要使用標籤、徽章、其他有效負載或音效檔）。 + + +傳送基本推送通知。 + +1. 在**選擇讀者**，請選取下列一個讀者：**所有裝置**，或依平台：**僅限 iOS 裝置**或**僅限 Anroid 裝置**。 + + **附註**：當您選取**所有裝置**選項時，所有已訂閱推送通知的裝置都會收到您的通知。 + + ![通知畫面](images/tag_notification.jpg) + +2. 在**建立通知**中，輸入您的訊息，然後按一下**傳送**。 +3. 驗證您的裝置已接收到通知。 + + 下列擷取畫面顯示在 Android 及 iOS 裝置的前景中處理推送通知的警示框。 + + ![Android 上的前景推送通知](images/Android_Screenshot.jpg) + + ![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) + + 下列擷取畫面顯示 Android 背景中的推送通知。 + ![Android 上的背景推送通知](images/background.jpg) + + + + +# 後續步驟 +{: #next_steps_tags} + +順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 + +將這些 Push Notifications Service 特性新增至您的應用程式。 +若要使用標籤型通知，請參閱[標籤型通知](c_tag_basednotifications.html)。 +若要使用進階通知選項，請參閱[進階推送通知](t_advance_notifications.html)。 diff --git a/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_register.md b/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_register.md index 4009f42b6..7aeaf2f39 100644 --- a/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_register.md +++ b/services/mobilepush/nl/zh/TW/t_enable_ios_notifications_register.md @@ -1,91 +1,91 @@ -# 登錄 iOS 應用程式及裝置 -{: #enable-push-ios-notifications-register} - - -應用程式必須向 APNs 登錄才能接收遠端通知，這通常發生在應用程式安裝到裝置上之後。在應用程式接收到 APNs 所產生的裝置記號之後，必須將裝置記號傳回給 Push Notifications Service。 - -若要登錄 iOS 應用程式及裝置，請執行下列動作： - -1. 建立後端應用程式 -2. 將記號傳遞至 Push Notifications - - -##建立後端應用程式 - -在 Bluemix® 型錄的「樣板」區段中建立後端應用程式，以自動將 Push 服務連結至此應用程式。如果您已建立後端應用程式，請確定將應用程式連結至 Push Notification Service。 - -###Objective-C - -``` - //For Objective-C - - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { - if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ - [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; - [[UIApplication sharedApplication] registerForRemoteNotifications]; - } - else{ - [[UIApplication sharedApplication] registerForRemoteNotificationTypes: - (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; - } - return YES; - } -``` - -###Swift - -``` - //For Swift - func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { - let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound - let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) - application.registerUserNotificationSettings(notificationSettings) - application.registerForRemoteNotifications() - } -``` - -##將記號傳遞至 Push Notifications - -從 APNs 接收到記號之後，將記號傳遞至 Push Notifications，這是 `registerDevice:withDeviceToken` 方法的一部分。 - -###Objective-C - -``` -//For Objective-C --( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ - - IMFClient *client = [IMFClient sharedInstance]; - - [client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; - - - // get Push instance -IMFPushClient* push = [IMFPushClient sharedInstance]; -[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { - if (error){ - [ self updateMessage:error .description]; - } else { - [ self updateMessage:response .responseJson .description]; -} -}]; -``` - -###Swift - -從 APNS 接收到記號之後，將記號傳遞至 Push Notifications，這是 `didRegisterForRemoteNotificationsWithDeviceToken` 方法的一部分。 - -``` -func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ - let push = BMSPushClient.sharedInstance - push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } - else{ - print( "Error during device registration \(error) ") - Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") - } - } - -} -``` +# 登錄 iOS 應用程式及裝置 +{: #enable-push-ios-notifications-register} + + +應用程式必須向 APNs 登錄才能接收遠端通知，這通常發生在應用程式安裝到裝置上之後。在應用程式接收到 APNs 所產生的裝置記號之後，必須將裝置記號傳回給 Push Notifications Service。 + +若要登錄 iOS 應用程式及裝置，請執行下列動作： + +1. 建立後端應用程式 +2. 將記號傳遞至 Push Notifications + + +##建立後端應用程式 + +在 Bluemix® 型錄的「樣板」區段中建立後端應用程式，以自動將 Push 服務連結至此應用程式。如果您已建立後端應用程式，請確定將應用程式連結至 Push Notification Service。 + +###Objective-C + +``` + //For Objective-C + - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){ + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:categories]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; + } + else{ + [[UIApplication sharedApplication] registerForRemoteNotificationTypes: + (UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; + } + return YES; + } +``` + +###Swift + +``` + //For Swift + func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { + let notificationTypes: UIUserNotificationType = UIUserNotificationType.Badge | UIUserNotificationType.Alert | UIUserNotificationType.Sound + let notificationSettings: UIUserNotificationSettings = UIUserNotificationSettings(forTypes: notificationTypes, categories: categories) + application.registerUserNotificationSettings(notificationSettings) + application.registerForRemoteNotifications() + } +``` + +##將記號傳遞至 Push Notifications + +從 APNs 接收到記號之後，將記號傳遞至 Push Notifications，這是 `registerDevice:withDeviceToken` 方法的一部分。 + +###Objective-C + +``` +//For Objective-C +-( void) application:( UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:( NSData *)deviceToken{ + + IMFClient *client = [IMFClient sharedInstance]; + + [client initializeWithBackendRoute: @"your-backend-route-here" backendGUID: @"Your-backend-GUID-here"]; + + + // get Push instance +IMFPushClient* push = [IMFPushClient sharedInstance]; +[push registerDeviceToken:deviceToken completionHandler:^(IMFResponse *response, NSError *error) { + if (error){ + [ self updateMessage:error .description]; + } else { + [ self updateMessage:response .responseJson .description]; +} +}]; +``` + +###Swift + +從 APNS 接收到記號之後，將記號傳遞至 Push Notifications，這是 `didRegisterForRemoteNotificationsWithDeviceToken` 方法的一部分。 + +``` +func application (application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData){ + let push = BMSPushClient.sharedInstance + push.registerDeviceToken(deviceToken) { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } + else{ + print( "Error during device registration \(error) ") + Print( "Error during device registration \n - status code: \(statusCode) \n Error :\(error) \n") + } + } + +} +``` diff --git a/services/mobilepush/nl/zh/TW/t_get_tags.md b/services/mobilepush/nl/zh/TW/t_get_tags.md index 924328dfa..feef4fe99 100644 --- a/services/mobilepush/nl/zh/TW/t_get_tags.md +++ b/services/mobilepush/nl/zh/TW/t_get_tags.md @@ -1,144 +1,144 @@ -# 取得標籤 -{: #get_tags} - -標籤提供的方法是根據使用者的興趣將目標通知傳送給使用者，與傳送給所有應用程式的一般播送不同。您可以使用 Push 儀表板上的「標籤」標籤或使用 REST API 來建立及管理標籤。您可在下列區段中使用程式碼 Snippet 來管理及查詢行動應用程式的標籤訂閱。您可以使用這些程式碼 Snippet 來取得訂閱、訂閱標籤、取消訂閱標籤，以及取得可用標籤清單。您可以複製這些程式碼 Snippet，並將其貼入行動應用程式中。 - -## Android - -**getTags** API 會傳回裝置可訂閱的可用標籤清單。在裝置訂閱特定標籤之後，該裝置就可以接收針對該標籤傳送的任何推送通知。 - -將下列程式碼 Snippet 複製到 Android 行動應用程式來取得裝置訂閱的標籤清單，以及取得可用標籤清單。 - -使用下列 **getTags** API 來取得裝置可訂閱的可用標籤清單。 - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - -使用 **getSubscriptions** API 來取得裝置訂閱的標籤清單。 - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) -``` - -## Cordova - -將下列程式碼 Snippet 複製到行動應用程式來取得裝置訂閱的標籤清單，以及取得裝置可訂閱的可用標籤清單。 - -擷取可供訂閱的標籤陣列。 - -``` -//Get a list of available tags to which the device can subscribe -MFPPush.retrieveAvailableTags(function(tags) {alert(tags); -}, null); -``` - -``` -//Get a list of available tags to which the device is subscribed. -MFPPush.getSubscriptionStatus(function(tags) {alert(tags); -}, null); -``` - -## Objective-C - -將下列程式碼 Snippet 複製到使用 Objective-C 所開發的 iOS 應用程式來取得裝置訂閱的標籤清單，以及取得裝置可訂閱的可用標籤清單。 - -使用下列 **retrieveAvailableTags** API 來取得裝置可訂閱的可用標籤清單。 - -``` -//Get a list of available tags to which the device can subscribe -[push retrieveAvailableTagsWithCompletionHandler: -^(IMFResponse *response, NSError *error){ - if (error){[ self updateMessage:error.description];} -else { - [self updateMessage:@"Successfully retrieved available tags."]; - NSDictionary *availableTags = [[NSDictionary alloc]init]; - availableTags = [response tags]; -[self.appDelegateVC updateMessage:availableTags.description]; -} -}]; -``` - -使用 **retrieveSubscriptions** API 來取得裝置訂閱的標籤清單。 - - -``` -// Get a list of tags that to which the device is subscribed. -[push retrieveSubscriptionsWithCompletionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - } else { - [self updateMessage:@"Successfully retrieved subscriptions."]; - NSDictionary *subscribedTags = [[NSDictionary alloc]init]; -subscribedTags = [response subscriptions]; -[self.appDelegateVC updateMessage:subscribedTags.description]; -} -}]; -``` - -## Swift - -**retrieveAvailableTagsWithCompletionHandler** API 會傳回裝置可訂閱的可用標籤清單。在裝置訂閱特定標籤之後，該裝置就可以接收針對該標籤傳送的任何推送通知。 - -呼叫 Push 服務來取得標籤的訂閱。 - -將下列程式碼 Snippet 複製到 Swift 行動應用程式，來取得裝置訂閱的可用標籤清單，以及取得裝置可訂閱的可用標籤清單。 - - -``` -//Get a list of available tags to which the device can subscribe -push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void inif error.isEmpty { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else{ - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - - print( "Response during retrieving subscribed tags : \(response.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else { -print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - - - +# 取得標籤 +{: #get_tags} + +標籤提供的方法是根據使用者的興趣將目標通知傳送給使用者，與傳送給所有應用程式的一般播送不同。您可以使用 Push 儀表板上的「標籤」標籤或使用 REST API 來建立及管理標籤。您可在下列區段中使用程式碼 Snippet 來管理及查詢行動應用程式的標籤訂閱。您可以使用這些程式碼 Snippet 來取得訂閱、訂閱標籤、取消訂閱標籤，以及取得可用標籤清單。您可以複製這些程式碼 Snippet，並將其貼入行動應用程式中。 + +## Android + +**getTags** API 會傳回裝置可訂閱的可用標籤清單。在裝置訂閱特定標籤之後，該裝置就可以接收針對該標籤傳送的任何推送通知。 + +將下列程式碼 Snippet 複製到 Android 行動應用程式來取得裝置訂閱的標籤清單，以及取得可用標籤清單。 + +使用下列 **getTags** API 來取得裝置可訂閱的可用標籤清單。 + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + +使用 **getSubscriptions** API 來取得裝置訂閱的標籤清單。 + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) +``` + +## Cordova + +將下列程式碼 Snippet 複製到行動應用程式來取得裝置訂閱的標籤清單，以及取得裝置可訂閱的可用標籤清單。 + +擷取可供訂閱的標籤陣列。 + +``` +//Get a list of available tags to which the device can subscribe +MFPPush.retrieveAvailableTags(function(tags) {alert(tags); +}, null); +``` + +``` +//Get a list of available tags to which the device is subscribed. +MFPPush.getSubscriptionStatus(function(tags) {alert(tags); +}, null); +``` + +## Objective-C + +將下列程式碼 Snippet 複製到使用 Objective-C 所開發的 iOS 應用程式來取得裝置訂閱的標籤清單，以及取得裝置可訂閱的可用標籤清單。 + +使用下列 **retrieveAvailableTags** API 來取得裝置可訂閱的可用標籤清單。 + +``` +//Get a list of available tags to which the device can subscribe +[push retrieveAvailableTagsWithCompletionHandler: +^(IMFResponse *response, NSError *error){ + if (error){[ self updateMessage:error.description];} +else { + [self updateMessage:@"Successfully retrieved available tags."]; + NSDictionary *availableTags = [[NSDictionary alloc]init]; + availableTags = [response tags]; +[self.appDelegateVC updateMessage:availableTags.description]; +} +}]; +``` + +使用 **retrieveSubscriptions** API 來取得裝置訂閱的標籤清單。 + + +``` +// Get a list of tags that to which the device is subscribed. +[push retrieveSubscriptionsWithCompletionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + } else { + [self updateMessage:@"Successfully retrieved subscriptions."]; + NSDictionary *subscribedTags = [[NSDictionary alloc]init]; +subscribedTags = [response subscriptions]; +[self.appDelegateVC updateMessage:subscribedTags.description]; +} +}]; +``` + +## Swift + +**retrieveAvailableTagsWithCompletionHandler** API 會傳回裝置可訂閱的可用標籤清單。在裝置訂閱特定標籤之後，該裝置就可以接收針對該標籤傳送的任何推送通知。 + +呼叫 Push 服務來取得標籤的訂閱。 + +將下列程式碼 Snippet 複製到 Swift 行動應用程式，來取得裝置訂閱的可用標籤清單，以及取得裝置可訂閱的可用標籤清單。 + + +``` +//Get a list of available tags to which the device can subscribe +push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void inif error.isEmpty { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else{ + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + + print( "Response during retrieving subscribed tags : \(response.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else { +print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + + + diff --git a/services/mobilepush/nl/zh/TW/t_handle_actionable_notifications_ios.md b/services/mobilepush/nl/zh/TW/t_handle_actionable_notifications_ios.md index ef16fa4e8..a92de63bd 100644 --- a/services/mobilepush/nl/zh/TW/t_handle_actionable_notifications_ios.md +++ b/services/mobilepush/nl/zh/TW/t_handle_actionable_notifications_ios.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 處理 iOS 可採取動作的通知 -{: #actionable-notifications} - - -接收到可採取動作的通知時，會根據選擇的 ID，將控制權傳遞給下列方法。 - -###Objective-C - -``` -(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: -(UILocalNotification *)notification completionHandler:(void (^)())completionHandler -{ - NSLog(@"actionable notification received."); - //must call completion handler when finished - completionHandler(); -} -``` - -###Swift - -``` -func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { - //must call completion handler when finished - completionHandler() - } -``` - - +--- + +copyright: + years: 2015, 2016 + +--- + +# 處理 iOS 可採取動作的通知 +{: #actionable-notifications} + + +接收到可採取動作的通知時，會根據選擇的 ID，將控制權傳遞給下列方法。 + +###Objective-C + +``` +(void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification: +(UILocalNotification *)notification completionHandler:(void (^)())completionHandler +{ + NSLog(@"actionable notification received."); + //must call completion handler when finished + completionHandler(); +} +``` + +###Swift + +``` +func application(application: UIApplication, handleActionWithIdentifier identifier: String?, forRemoteNotification userInfo: [NSObject : AnyObject], completionHandler: () -> Void) { + //must call completion handler when finished + completionHandler() + } +``` + + diff --git a/services/mobilepush/nl/zh/TW/t_holding_notifications_android.md b/services/mobilepush/nl/zh/TW/t_holding_notifications_android.md index 39465f5b0..d15182ea7 100644 --- a/services/mobilepush/nl/zh/TW/t_holding_notifications_android.md +++ b/services/mobilepush/nl/zh/TW/t_holding_notifications_android.md @@ -1,29 +1,29 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 保存 Android 的通知 -{: #hold-notifications-android} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - -在應用程式進入背景時，您可能會想要 {{site.data.keyword.mobilepushshort}} Service 保留傳送給應用程式的通知。若要保留通知，請在處理 {{site.data.keyword.mobilepushshort}} 之活動的 onPause() 方法中呼叫 hold() 方法。 - -``` - @Override - protected void onPause() { - super.onPause(); - if (push != null) { - push.hold(); - } -} -``` - {: codeblock} +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 保存 Android 的通知 +{: #hold-notifications-android} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + +在應用程式進入背景時，您可能會想要 {{site.data.keyword.mobilepushshort}} Service 保留傳送給應用程式的通知。若要保留通知，請在處理 {{site.data.keyword.mobilepushshort}} 之活動的 onPause() 方法中呼叫 hold() 方法。 + +``` + @Override + protected void onPause() { + super.onPause(); + if (push != null) { + push.hold(); + } +} +``` + {: codeblock} diff --git a/services/mobilepush/nl/zh/TW/t_manage_tags.md b/services/mobilepush/nl/zh/TW/t_manage_tags.md index 728092d3b..e50212606 100644 --- a/services/mobilepush/nl/zh/TW/t_manage_tags.md +++ b/services/mobilepush/nl/zh/TW/t_manage_tags.md @@ -1,347 +1,347 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 管理標籤 -{: #manage_tags} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - -使用 {{site.data.keyword.mobilepushshort}} 儀表板來建立及刪除您應用程式的標籤，然後起始標籤型通知。標籤型通知是在訂閱標籤的裝置上接收。 - - -## 建立標籤 -{: #create_tags} - -標籤型通知是指以所有訂閱特定標籤之裝置為目標的訊息。每一個裝置都可以訂閱任意數目的標籤。刪除標籤時，會刪除與該標籤相關聯的資訊（包括其訂閱者及裝置）。不需要自動取消訂閱，因為標籤不再存在。用戶端不需要採取任何進一步動作。 - -1. 在 {{site.data.keyword.mobilepushshort}} 儀表板上，選取**標籤**標籤。 -1. 按一下 + **建立標籤**按鈕。 - 1. 在**名稱**欄位中，輸入標籤的名稱。例如，"coupons"。 - 1. 在**說明**欄位中，輸入標籤說明。 - 1. 按一下**儲存**。 - -1. 在**程式碼 Snippet** 區域中，選取您行動應用程式的平台。 -1. 修改程式碼 Snippet 來處理錯誤，然後將每一個標籤的程式碼 Snippet 複製到行動應用程式。 - -## 刪除標籤 -{: #delete_tags} - -1. 從**標籤**標籤中，選取您要刪除的標籤，然後按一下**刪除**圖示。 -1. 按一下**確定**。 - -## 編輯標籤說明 -{: #edit_tags} - -1. 從**標籤**標籤中，選取您要編輯的標籤。 -1. 按一下**編輯**圖示。 -1. 編輯標籤說明，然後按一下**儲存**按鈕。 - -# 取得標籤 -{: #get_tags} - -標籤提供的方法是根據使用者的興趣將目標通知傳送給使用者，與傳送給所有應用程式的一般播送不同。您可以使用 {{site.data.keyword.mobilepushshort}} 儀表板上的「標籤」標籤或使用 REST API 來建立及管理標籤。您可以使用程式碼 Snippet 來管理及查詢行動應用程式的標籤訂閱。您可以使用這些程式碼 Snippet 來取得訂閱、訂閱標籤、取消訂閱標籤，或取得可用標籤清單。請將這些程式碼 Snippet 複製到行動應用程式中。 - -## 在 Android 上取得標籤 -{: android-get-tags} - -**getTags** API 會傳回裝置可訂閱的可用標籤清單。在裝置訂閱特定標籤之後，該裝置就可以接收針對該標籤傳送的 {{site.data.keyword.mobilepushshort}}。 - -將下列程式碼 Snippet 複製到 Android 行動應用程式來取得裝置訂閱的標籤清單，以及取得可用標籤清單。 - -使用下列 **getTags** API 來取得裝置可訂閱的可用標籤清單。 - -``` -// Get a list of available tags to which the device can subscribe -push.getTags(new MFPPushResponseListener>(){ - @Override - public void onSuccess(List tags){ - updateTextView("Retrieved available tags: " + tags); - System.out.println("Available tags are: "+tags); - availableTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex){ - updateTextView("Error getting available tags.. " + ex.getMessage()); - } -}) -``` - {: codeblock} - -使用 **getSubscriptions** API 來取得裝置訂閱的標籤清單。 - -``` -// Get a list of tags that to which the device is subscribed. -push.getSubscriptions(new MFPPushResponseListener>() { - @Override - public void onSuccess(List tags) { - updateTextView("Retrieved subscriptions : " + tags); - System.out.println("Subscribed tags are: "+tags); - subscribedTags = tags; - subscribeToTag(); - } - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error getting subscriptions.. " + ex.getMessage()); - } -}) - ``` - {: codeblock} - -## 在 Cordova 上取得標籤 -{: cordova-get-tags} - -將下列程式碼 Snippet 複製到行動應用程式來取得裝置訂閱的標籤清單，以及取得可用標籤清單。 - -擷取可供訂閱的標籤陣列。 - -``` -//Get a list of available tags to which the device can subscribe -BMSPush.retrieveAvailableTags(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed. -BMSPush.retrieveSubscriptions(function(tags) { - alert(tags); -}, failure); -``` - {: codeblock} - - -## 在 Swift 上取得標籤 -{: swift-get-tags} - -**retrieveAvailableTagsWithCompletionHandler** API 會傳回裝置可訂閱的可用標籤清單。在裝置訂閱特定標籤之後，該裝置就可以接收針對該標籤傳送的 {{site.data.keyword.mobilepushshort}}。 - -呼叫 {{site.data.keyword.mobilepushshort}} 來取得標籤的訂閱。 - -將下列程式碼 Snippet 複製到 Swift 行動應用程式，來取得裝置訂閱的可用標籤清單，以及取得裝置可訂閱的可用標籤清單。 -``` -//Get a list of available tags to which the device can subscribe - push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in - if error.isEmpty - { - print( "Response during retrieve tags : \(response)") - print( "status code during retrieve tags : \(statusCode)") - } - else - { - print( "Error during retrieve tags \(error) ") - Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -``` -//Get a list of available tags to which the device is subscribed -push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in - if error.isEmpty { - - print( "Response during retrieving subscribed tags : \(response?.description)") - print( "status code during retrieving subscribed tags : \(statusCode)") - } - else - { - print( "Error during retrieving subscribed tags \(error) ") - Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } - } -``` - {: codeblock} - -## Google Chrome、Safari 及 Mozilla Firefox -{: web-get-tags} - -若要取得客戶可以訂閱的可用標籤清單，請使用下列程式碼。 - -``` - var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - - -## Google Chrome Apps and Extensions -{: web-get-tags} - -若要取得客戶可以訂閱的可用標籤清單，請使用下列程式碼。 - -``` - var bmsPush = new BMSPush(); - bmsPush.retrieveAvailableTags(function(response) - { - alert(response.response) - var json = JSON.parse(response.response); - var tagsA = [] - for (i in json.tags) - { - tagsA.push(json.tags[i].name) - } - alert(tagsA) - }) -``` - {: codeblock} - -將下列程式碼 Snippet 複製到 Google Chrome Apps and Extensions，以取得客戶已訂閱的標籤清單。 - -``` - var bmsPush = new BMSPush(); - bmsPush.retrieveSubscriptions(function(response) - { - alert(response.response) -}) -``` - {: codeblock} - - -# 訂閱及取消訂閱標籤 -{: #Subscribe_tags} - -使用下列程式碼 Snippet，可容許裝置取得訂閱、訂閱標籤，以及取消訂閱標籤。 - -## 在 Android 上訂閱及取消訂閱標籤 -{: android-subscribe-tags} - -複製下列程式碼 Snippet，並將其貼入 Android 行動應用程式。 - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - {: codeblock} - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - {: codeblock} - -## 在 Cordova 上訂閱及取消訂閱標籤 -{: cordova-subscribe-tags} - -複製下列程式碼 Snippet，並將其貼入 Cordova 行動應用程式。 - -``` -var tag = "YourTag"; -BMSPush.subscribe(tag, success, failure); -BMSPush.unsubscribe(tag, success, failure); -``` - {: codeblock} - - -## 在 Swift 上訂閱及取消訂閱標籤 -{: swift-subscribe-tags} - -複製下列程式碼 Snippet，並將其貼入 Swift 行動應用程式。 - -使用 **subscribeToTags** API 來訂閱標籤。 - -``` -push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print("Response when subscribing to tags: \(response?.description)") - print("Status code when subscribing to tags: \(statusCode)") - } else { - print("Error when subscribing to tags: \(error) ") - print("Error status code when subscribing to tags: \(statusCode)") - } -}) -``` - {: codeblock} - -使用 **unsubscribeFromTags** API 來取消訂閱標籤。 - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - if error.isEmpty { - print( "Response during unsubscribed tags : \(response?.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` - {: codeblock} - -## Google Chrome 及 Mozilla Firefox -{: web-subscribe-tags} - -若要從 Web 應用程式訂閱標籤，請使用下列程式碼 Snippet： - -``` -var tagsArray = ["tag1", "Tag2"] -bmsPush.subscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -取消訂閱標籤會使用 **unSubscribe** 方法。 - -``` -var tagsArray = ["tag1", "Tag2"] - bmsPush.unSubscribe(tagsArray,function(response) { - alert(response.response) -}) -``` - {: codeblock} - -# 使用標籤型通知 -{: #using_tags} - -標籤型通知是指以所有訂閱特定標籤之裝置為目標的訊息。每一個裝置都可以訂閱任意數目的標籤。本主題說明如何傳送標籤型通知。訂閱透過 {{site.data.keyword.mobilepushshort}} Service Bluemix 實例進行維護。刪除標籤時，會刪除與該標籤相關聯的所有資訊（包括其訂閱者及裝置）。無需對此標籤進行自動取消訂閱，因為此標籤已不存在，因此也不需要從用戶端採取進一步的動作。 - -在**標籤**畫面上建立標籤。如需如何建立標籤的相關資訊，請參閱[建立標籤](t_manage_tags.html)。 - -1. 從 **Push Notification** 儀表板中，按一下**傳送通知**。 -1. 選取**傳送至**下拉清單中的**依標籤的裝置**選項。 -1. 搜尋您要使用的標籤，然後選取它們。 -![通知畫面](images/tag_notification.jpg) -1. 在**訊息文字**欄位中，輸入將當作通知傳送給已訂閱讀者的文字。 -1. 按一下**傳送**。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 管理標籤 +{: #manage_tags} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + +使用 {{site.data.keyword.mobilepushshort}} 儀表板來建立及刪除您應用程式的標籤，然後起始標籤型通知。標籤型通知是在訂閱標籤的裝置上接收。 + + +## 建立標籤 +{: #create_tags} + +標籤型通知是指以所有訂閱特定標籤之裝置為目標的訊息。每一個裝置都可以訂閱任意數目的標籤。刪除標籤時，會刪除與該標籤相關聯的資訊（包括其訂閱者及裝置）。不需要自動取消訂閱，因為標籤不再存在。用戶端不需要採取任何進一步動作。 + +1. 在 {{site.data.keyword.mobilepushshort}} 儀表板上，選取**標籤**標籤。 +1. 按一下 + **建立標籤**按鈕。 + 1. 在**名稱**欄位中，輸入標籤的名稱。例如，"coupons"。 + 1. 在**說明**欄位中，輸入標籤說明。 + 1. 按一下**儲存**。 + +1. 在**程式碼 Snippet** 區域中，選取您行動應用程式的平台。 +1. 修改程式碼 Snippet 來處理錯誤，然後將每一個標籤的程式碼 Snippet 複製到行動應用程式。 + +## 刪除標籤 +{: #delete_tags} + +1. 從**標籤**標籤中，選取您要刪除的標籤，然後按一下**刪除**圖示。 +1. 按一下**確定**。 + +## 編輯標籤說明 +{: #edit_tags} + +1. 從**標籤**標籤中，選取您要編輯的標籤。 +1. 按一下**編輯**圖示。 +1. 編輯標籤說明，然後按一下**儲存**按鈕。 + +# 取得標籤 +{: #get_tags} + +標籤提供的方法是根據使用者的興趣將目標通知傳送給使用者，與傳送給所有應用程式的一般播送不同。您可以使用 {{site.data.keyword.mobilepushshort}} 儀表板上的「標籤」標籤或使用 REST API 來建立及管理標籤。您可以使用程式碼 Snippet 來管理及查詢行動應用程式的標籤訂閱。您可以使用這些程式碼 Snippet 來取得訂閱、訂閱標籤、取消訂閱標籤，或取得可用標籤清單。請將這些程式碼 Snippet 複製到行動應用程式中。 + +## 在 Android 上取得標籤 +{: android-get-tags} + +**getTags** API 會傳回裝置可訂閱的可用標籤清單。在裝置訂閱特定標籤之後，該裝置就可以接收針對該標籤傳送的 {{site.data.keyword.mobilepushshort}}。 + +將下列程式碼 Snippet 複製到 Android 行動應用程式來取得裝置訂閱的標籤清單，以及取得可用標籤清單。 + +使用下列 **getTags** API 來取得裝置可訂閱的可用標籤清單。 + +``` +// Get a list of available tags to which the device can subscribe +push.getTags(new MFPPushResponseListener>(){ + @Override + public void onSuccess(List tags){ + updateTextView("Retrieved available tags: " + tags); + System.out.println("Available tags are: "+tags); + availableTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex){ + updateTextView("Error getting available tags.. " + ex.getMessage()); + } +}) +``` + {: codeblock} + +使用 **getSubscriptions** API 來取得裝置訂閱的標籤清單。 + +``` +// Get a list of tags that to which the device is subscribed. +push.getSubscriptions(new MFPPushResponseListener>() { + @Override + public void onSuccess(List tags) { + updateTextView("Retrieved subscriptions : " + tags); + System.out.println("Subscribed tags are: "+tags); + subscribedTags = tags; + subscribeToTag(); + } + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error getting subscriptions.. " + ex.getMessage()); + } +}) + ``` + {: codeblock} + +## 在 Cordova 上取得標籤 +{: cordova-get-tags} + +將下列程式碼 Snippet 複製到行動應用程式來取得裝置訂閱的標籤清單，以及取得可用標籤清單。 + +擷取可供訂閱的標籤陣列。 + +``` +//Get a list of available tags to which the device can subscribe +BMSPush.retrieveAvailableTags(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed. +BMSPush.retrieveSubscriptions(function(tags) { + alert(tags); +}, failure); +``` + {: codeblock} + + +## 在 Swift 上取得標籤 +{: swift-get-tags} + +**retrieveAvailableTagsWithCompletionHandler** API 會傳回裝置可訂閱的可用標籤清單。在裝置訂閱特定標籤之後，該裝置就可以接收針對該標籤傳送的 {{site.data.keyword.mobilepushshort}}。 + +呼叫 {{site.data.keyword.mobilepushshort}} 來取得標籤的訂閱。 + +將下列程式碼 Snippet 複製到 Swift 行動應用程式，來取得裝置訂閱的可用標籤清單，以及取得裝置可訂閱的可用標籤清單。 +``` +//Get a list of available tags to which the device can subscribe + push.retrieveAvailableTagsWithCompletionHandler({ (response, statusCode, error) -> Void in + if error.isEmpty + { + print( "Response during retrieve tags : \(response)") + print( "status code during retrieve tags : \(statusCode)") + } + else + { + print( "Error during retrieve tags \(error) ") + Print( "Error during retrieve tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +``` +//Get a list of available tags to which the device is subscribed +push.retrieveSubscriptionsWithCompletionHandler { (response, statusCode, error) -> Void in + if error.isEmpty { + + print( "Response during retrieving subscribed tags : \(response?.description)") + print( "status code during retrieving subscribed tags : \(statusCode)") + } + else + { + print( "Error during retrieving subscribed tags \(error) ") + Print( "Error during retrieving subscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } + } +``` + {: codeblock} + +## Google Chrome、Safari 及 Mozilla Firefox +{: web-get-tags} + +若要取得客戶可以訂閱的可用標籤清單，請使用下列程式碼。 + +``` + var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + + +## Google Chrome Apps and Extensions +{: web-get-tags} + +若要取得客戶可以訂閱的可用標籤清單，請使用下列程式碼。 + +``` + var bmsPush = new BMSPush(); + bmsPush.retrieveAvailableTags(function(response) + { + alert(response.response) + var json = JSON.parse(response.response); + var tagsA = [] + for (i in json.tags) + { + tagsA.push(json.tags[i].name) + } + alert(tagsA) + }) +``` + {: codeblock} + +將下列程式碼 Snippet 複製到 Google Chrome Apps and Extensions，以取得客戶已訂閱的標籤清單。 + +``` + var bmsPush = new BMSPush(); + bmsPush.retrieveSubscriptions(function(response) + { + alert(response.response) +}) +``` + {: codeblock} + + +# 訂閱及取消訂閱標籤 +{: #Subscribe_tags} + +使用下列程式碼 Snippet，可容許裝置取得訂閱、訂閱標籤，以及取消訂閱標籤。 + +## 在 Android 上訂閱及取消訂閱標籤 +{: android-subscribe-tags} + +複製下列程式碼 Snippet，並將其貼入 Android 行動應用程式。 + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + {: codeblock} + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + {: codeblock} + +## 在 Cordova 上訂閱及取消訂閱標籤 +{: cordova-subscribe-tags} + +複製下列程式碼 Snippet，並將其貼入 Cordova 行動應用程式。 + +``` +var tag = "YourTag"; +BMSPush.subscribe(tag, success, failure); +BMSPush.unsubscribe(tag, success, failure); +``` + {: codeblock} + + +## 在 Swift 上訂閱及取消訂閱標籤 +{: swift-subscribe-tags} + +複製下列程式碼 Snippet，並將其貼入 Swift 行動應用程式。 + +使用 **subscribeToTags** API 來訂閱標籤。 + +``` +push.subscribeToTags(tagsArray: ["MyTag"], completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print("Response when subscribing to tags: \(response?.description)") + print("Status code when subscribing to tags: \(statusCode)") + } else { + print("Error when subscribing to tags: \(error) ") + print("Error status code when subscribing to tags: \(statusCode)") + } +}) +``` + {: codeblock} + +使用 **unsubscribeFromTags** API 來取消訂閱標籤。 + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + if error.isEmpty { + print( "Response during unsubscribed tags : \(response?.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` + {: codeblock} + +## Google Chrome 及 Mozilla Firefox +{: web-subscribe-tags} + +若要從 Web 應用程式訂閱標籤，請使用下列程式碼 Snippet： + +``` +var tagsArray = ["tag1", "Tag2"] +bmsPush.subscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +取消訂閱標籤會使用 **unSubscribe** 方法。 + +``` +var tagsArray = ["tag1", "Tag2"] + bmsPush.unSubscribe(tagsArray,function(response) { + alert(response.response) +}) +``` + {: codeblock} + +# 使用標籤型通知 +{: #using_tags} + +標籤型通知是指以所有訂閱特定標籤之裝置為目標的訊息。每一個裝置都可以訂閱任意數目的標籤。本主題說明如何傳送標籤型通知。訂閱透過 {{site.data.keyword.mobilepushshort}} Service Bluemix 實例進行維護。刪除標籤時，會刪除與該標籤相關聯的所有資訊（包括其訂閱者及裝置）。無需對此標籤進行自動取消訂閱，因為此標籤已不存在，因此也不需要從用戶端採取進一步的動作。 + +在**標籤**畫面上建立標籤。如需如何建立標籤的相關資訊，請參閱[建立標籤](t_manage_tags.html)。 + +1. 從 **Push Notification** 儀表板中，按一下**傳送通知**。 +1. 選取**傳送至**下拉清單中的**依標籤的裝置**選項。 +1. 搜尋您要使用的標籤，然後選取它們。 +![通知畫面](images/tag_notification.jpg) +1. 在**訊息文字**欄位中，輸入將當作通知傳送給已訂閱讀者的文字。 +1. 按一下**傳送**。 diff --git a/services/mobilepush/nl/zh/TW/t_manage_user.md b/services/mobilepush/nl/zh/TW/t_manage_user.md index 64fe24221..c670de0fd 100644 --- a/services/mobilepush/nl/zh/TW/t_manage_user.md +++ b/services/mobilepush/nl/zh/TW/t_manage_user.md @@ -1,166 +1,166 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 使用 userId 登錄裝置 -{: #register_device_with_userId} -前次更新：2017 年 2 月 6 日 -{: .last-updated} - -若要登錄 userId 型通知，請完成下列步驟： - -## Android -{: android-register} - -使用 {{site.data.keyword.mobilepushshort}} Service 的 `AppGUID` 及 `clientSecret` 金鑰，來起始設定 MFPPush 類別。 -``` -// Initialize the Push Notifications service -push = MFPPush.getInstance(); -push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); -``` - {: codeblock} - - -- **AppGUID**：這是 {{site.data.keyword.mobilepushshort}} Service 的 AppGUID 金鑰。 -- **clientSecret**：這是 {{site.data.keyword.mobilepushshort}} Service 的 clientSecret 金鑰。 - - 使用 **registerDeviceWithUserId** API 登錄裝置，以取得 {{site.data.keyword.mobilepushshort}}。 - -``` -// Register the device to Push Notifications -push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { - @Override - public void onSuccess(String response) { - Log.d("Device is registered with Push Service.");} - @Override - public void onFailure(MFPPushException ex) { - Log.d("Error registering with Push Service...\n" - + "Push notifications will not be received."); - } - }); -``` - {: codeblock} - -- **userId**：傳遞唯一 userId 值，以登錄 {{site.data.keyword.mobilepushshort}}。 - -**附註：**若要啟用 userId 設為目標的 {{site.data.keyword.mobilepushshort}}，請確定您使用 userId 登錄裝置，同時也傳遞佈建 {{site.data.keyword.mobilepushshort}} Service 時所配置的 'clientSecret'。若沒有有效的 clientSecret，裝置登錄會失敗。 - -## Cordova -{: cordova} - -使用下列 API 來登錄使用者 ID 型 {{site.data.keyword.mobilepushshort}}。 - -``` -// Register device for Push Notification with UserId -var options = {"userId": "Your User Id value"}; -BMSPush.registerDevice(options,success, failure); -``` - {: codeblock} - - -- **userId**：傳遞唯一 userId 值，以登錄 {{site.data.keyword.mobilepushshort}}。 - - -## Swift -{: swift-register} - -``` -// Initialize the BMSPushClient -let push = BMSPushClient.sharedInstance -push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") -``` - {: codeblock} - - -- **AppGUID**：這是 {{site.data.keyword.mobilepushshort}} Service 的 AppGUID 金鑰。 -- **clientSecret**：這是 {{site.data.keyword.mobilepushshort}} Service 的 clientSecret 金鑰。 - -使用 **registerWithUserId** API 登錄裝置，以取得 {{site.data.keyword.mobilepushshort}}。 - -``` -// Register the device to Push Notifications service -push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in -if error.isEmpty { - print( "Response during device registration : \(response)") - print( "status code during device registration : \(statusCode)") - } else { - print( "Error during device registration \(error) ") - } - } -``` - {: codeblock} - -- **userId**：傳遞唯一 userId 值，以登錄 {{site.data.keyword.mobilepushshort}}。 - -## Google Chrome、Safari 及 Mozilla Firefox -{: web-register} - -使用下列 API 來登錄 userId 型通知。使用 `app GUID`、`app Region` 及 `Client Secret` 來起始設定 SDK。 - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -順利起始設定之後，請使用 userId 登錄 Web 應用程式。 - -``` - bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -## Google Chrome Apps and Extensions -{: web-register-new} - -使用下列 API 來登錄 userId 型通知。使用 `app GUID`、`app Region` 及 `Client Secret` 來起始設定 SDK。 - -``` -var bmsPush = new BMSPush(); -var params = { - "appGUID":"push app GUID", - "appRegion":"App Region", - "clientSecret":"Push Client Secret" - } - bmsPush.initialize(params, function(response){ - alert(response.response) - }) -``` - {: codeblock} - -成功起始設定之後，您需要以使用者 ID 來登錄 Web 應用程式。 - -``` - bmsPush.registerWithUserId("UserId", function(response) { - alert(response.response) - }) -``` - {: codeblock} - -# 使用 userId 型通知 -{: #using_userid} - -userId 型通知是以特定使用者為目標的通知訊息。可向一個使用者登錄多個裝置。下列步驟說明如何傳送使用者 ID 型通知。 - -1. 從 **Push Notification** 儀表板中，選取**傳送通知**選項。 -1. 在**傳送至**選項清單中，選取**使用者 ID**。 -1. 在**使用者 ID** 欄位中，搜尋您要使用的使用者 ID，然後按一下 **+ 新增**。![通知畫面](images/user_notification.jpg) -1. 在**訊息**欄位中，輸入要在通知中傳送的文字。 -1. 按一下**傳送**。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 使用 userId 登錄裝置 +{: #register_device_with_userId} +前次更新：2017 年 2 月 6 日 +{: .last-updated} + +若要登錄 userId 型通知，請完成下列步驟： + +## Android +{: android-register} + +使用 {{site.data.keyword.mobilepushshort}} Service 的 `AppGUID` 及 `clientSecret` 金鑰，來起始設定 MFPPush 類別。 +``` +// Initialize the Push Notifications service +push = MFPPush.getInstance(); +push.initialize(getApplicationContext(),"AppGUID", "clientSecret"); +``` + {: codeblock} + + +- **AppGUID**：這是 {{site.data.keyword.mobilepushshort}} Service 的 AppGUID 金鑰。 +- **clientSecret**：這是 {{site.data.keyword.mobilepushshort}} Service 的 clientSecret 金鑰。 + + 使用 **registerDeviceWithUserId** API 登錄裝置，以取得 {{site.data.keyword.mobilepushshort}}。 + +``` +// Register the device to Push Notifications +push.registerDeviceWithUserId("userId",new MFPPushResponseListener() { + @Override + public void onSuccess(String response) { + Log.d("Device is registered with Push Service.");} + @Override + public void onFailure(MFPPushException ex) { + Log.d("Error registering with Push Service...\n" + + "Push notifications will not be received."); + } + }); +``` + {: codeblock} + +- **userId**：傳遞唯一 userId 值，以登錄 {{site.data.keyword.mobilepushshort}}。 + +**附註：**若要啟用 userId 設為目標的 {{site.data.keyword.mobilepushshort}}，請確定您使用 userId 登錄裝置，同時也傳遞佈建 {{site.data.keyword.mobilepushshort}} Service 時所配置的 'clientSecret'。若沒有有效的 clientSecret，裝置登錄會失敗。 + +## Cordova +{: cordova} + +使用下列 API 來登錄使用者 ID 型 {{site.data.keyword.mobilepushshort}}。 + +``` +// Register device for Push Notification with UserId +var options = {"userId": "Your User Id value"}; +BMSPush.registerDevice(options,success, failure); +``` + {: codeblock} + + +- **userId**：傳遞唯一 userId 值，以登錄 {{site.data.keyword.mobilepushshort}}。 + + +## Swift +{: swift-register} + +``` +// Initialize the BMSPushClient +let push = BMSPushClient.sharedInstance +push.initializeWithAppGUID("appGUID", clientSecret:"clientSecret") +``` + {: codeblock} + + +- **AppGUID**：這是 {{site.data.keyword.mobilepushshort}} Service 的 AppGUID 金鑰。 +- **clientSecret**：這是 {{site.data.keyword.mobilepushshort}} Service 的 clientSecret 金鑰。 + +使用 **registerWithUserId** API 登錄裝置，以取得 {{site.data.keyword.mobilepushshort}}。 + +``` +// Register the device to Push Notifications service +push.registerWithDeviceToken("deviceToken", WithUserId: "userId") { (response, statusCode, error) -> Void in +if error.isEmpty { + print( "Response during device registration : \(response)") + print( "status code during device registration : \(statusCode)") + } else { + print( "Error during device registration \(error) ") + } + } +``` + {: codeblock} + +- **userId**：傳遞唯一 userId 值，以登錄 {{site.data.keyword.mobilepushshort}}。 + +## Google Chrome、Safari 及 Mozilla Firefox +{: web-register} + +使用下列 API 來登錄 userId 型通知。使用 `app GUID`、`app Region` 及 `Client Secret` 來起始設定 SDK。 + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +順利起始設定之後，請使用 userId 登錄 Web 應用程式。 + +``` + bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +## Google Chrome Apps and Extensions +{: web-register-new} + +使用下列 API 來登錄 userId 型通知。使用 `app GUID`、`app Region` 及 `Client Secret` 來起始設定 SDK。 + +``` +var bmsPush = new BMSPush(); +var params = { + "appGUID":"push app GUID", + "appRegion":"App Region", + "clientSecret":"Push Client Secret" + } + bmsPush.initialize(params, function(response){ + alert(response.response) + }) +``` + {: codeblock} + +成功起始設定之後，您需要以使用者 ID 來登錄 Web 應用程式。 + +``` + bmsPush.registerWithUserId("UserId", function(response) { + alert(response.response) + }) +``` + {: codeblock} + +# 使用 userId 型通知 +{: #using_userid} + +userId 型通知是以特定使用者為目標的通知訊息。可向一個使用者登錄多個裝置。下列步驟說明如何傳送使用者 ID 型通知。 + +1. 從 **Push Notification** 儀表板中，選取**傳送通知**選項。 +1. 在**傳送至**選項清單中，選取**使用者 ID**。 +1. 在**使用者 ID** 欄位中，搜尋您要使用的使用者 ID，然後按一下 **+ 新增**。![通知畫面](images/user_notification.jpg) +1. 在**訊息**欄位中，輸入要在通知中傳送的文字。 +1. 按一下**傳送**。 diff --git a/services/mobilepush/nl/zh/TW/t_push_ios_nextsteps.md b/services/mobilepush/nl/zh/TW/t_push_ios_nextsteps.md index b9613d95f..dcb7e72f5 100644 --- a/services/mobilepush/nl/zh/TW/t_push_ios_nextsteps.md +++ b/services/mobilepush/nl/zh/TW/t_push_ios_nextsteps.md @@ -1,21 +1,21 @@ - ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -# 後續步驟 - -{: #push-ios-nextsteps} - -順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 - -將這些 Push Notifications Service 特性新增至您的應用程式。 - - - -- 若要使用標籤型通知，請參閱[標籤型通知](t_push_tagsmain.md)。 -- 若要使用進階通知選項，請參閱[進階推送通知](t_advance_notifications.md)。 + +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +# 後續步驟 + +{: #push-ios-nextsteps} + +順利設定基本通知之後，您就可以配置標籤型通知及進階選項。 + +將這些 Push Notifications Service 特性新增至您的應用程式。 + + + +- 若要使用標籤型通知，請參閱[標籤型通知](t_push_tagsmain.md)。 +- 若要使用進階通知選項，請參閱[進階推送通知](t_advance_notifications.md)。 diff --git a/services/mobilepush/nl/zh/TW/t_push_monitoring.md b/services/mobilepush/nl/zh/TW/t_push_monitoring.md index d8f5cf4df..1b45b7b7e 100644 --- a/services/mobilepush/nl/zh/TW/t_push_monitoring.md +++ b/services/mobilepush/nl/zh/TW/t_push_monitoring.md @@ -1,33 +1,33 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 監視 Push Notifications -{: #monitor-notifications} -前次更新：2017 年 1 月 16 日 -{: .last-updated} - - -IBM {{site.data.keyword.mobilepushshort}} 服務現在已擴充功能，可藉由從您的使用者資料產生圖形，來監視推送效能。您可以使用此公用程式來列出所有已傳送的推送通知，或是列出所有已登錄裝置，並以每日、每週或每月為基礎分析資訊。 - -若要產生所有已傳送通知的報告，請使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 中的 Push Messages GET report 方法。 - -![已傳送通知報告](images/monitoring_messages.jpg) - - -若要產生所有已登錄裝置的報告，請使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 中的 Push Device Registrations GET report 方法。 - -![已登錄裝置報告](images/monitoring_devices.jpg) - -如需如何更新 Android SDK 以監視通知資訊的相關資訊，請參閱[在 Android 裝置上監視推送通知](c_android_enable.html#android_monitor)。 - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 監視 Push Notifications +{: #monitor-notifications} +前次更新：2017 年 1 月 16 日 +{: .last-updated} + + +IBM {{site.data.keyword.mobilepushshort}} 服務現在已擴充功能，可藉由從您的使用者資料產生圖形，來監視推送效能。您可以使用此公用程式來列出所有已傳送的推送通知，或是列出所有已登錄裝置，並以每日、每週或每月為基礎分析資訊。 + +若要產生所有已傳送通知的報告，請使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 中的 Push Messages GET report 方法。 + +![已傳送通知報告](images/monitoring_messages.jpg) + + +若要產生所有已登錄裝置的報告，請使用 [REST API](https://mobile.{DomainName}/imfpush/){: new_window} 中的 Push Device Registrations GET report 方法。 + +![已登錄裝置報告](images/monitoring_devices.jpg) + +如需如何更新 Android SDK 以監視通知資訊的相關資訊，請參閱[在 Android 裝置上監視推送通知](c_android_enable.html#android_monitor)。 + + + diff --git a/services/mobilepush/nl/zh/TW/t_push_provider_android.md b/services/mobilepush/nl/zh/TW/t_push_provider_android.md index e1debeb95..c7ca6f06b 100644 --- a/services/mobilepush/nl/zh/TW/t_push_provider_android.md +++ b/services/mobilepush/nl/zh/TW/t_push_provider_android.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 配置 FCM 的認證 -{: #create-push-enable-gcm} -前次更新：2017 年 1 月 16 日 -{: .last-updated} - -Firebase Cloud Messaging (FCM) 是用來將推送通知遞送至 Android 裝置及 Google Chrome 的閘道。FCM 是新版本的 Google Cloud Messaging (GCM)。若要在儀表板上設定 {{site.data.keyword.mobilepushshort}} 服務，您需要取得 FCM 認證。請確定將 FCM 配置用於新的應用程式。現有應用程式將繼續使用 GCM 配置運作。 - -##取得傳送端 ID 及 API 金鑰 -{: #android-senderid-apikey} - -API 金鑰會安全地儲存並供 {{site.data.keyword.mobilepushshort}} Service 用來連接至 FCM 伺服器，而適用於 Google Chrome 及 Mozilla Firefox 的 Android SDK 及 JS SDK 在用戶端上使用「傳送端 ID」（專案號碼）。 - -若要設定 FCM 以及產生 API 金鑰和「傳送端 ID」，請完成下列步驟： - -1. 造訪 [Firebase 主控台 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://console.firebase.google.com/?pli=1){: new_window}。 -2. 選取**建立新專案**。 -3. 在「建立專案」視窗中，提供專案名稱、選擇國家/地區，然後按一下**建立專案**。 -3. 在導覽窗格中，按一下「設定」圖示，然後選取**專案設定**。 -4. 選擇 Cloud Messaging 標籤，以產生「伺服器 API 金鑰」及「傳送端 ID」。 - -##設定適用於 Android 及 Chrome Apps and Extensions 的 {{site.data.keyword.mobilepushshort}} Service -{: #setup-push-android} - -**附註：**您將需要「FCM/GCM API 金鑰」及「傳送端 ID」（專案號碼）。 - -1. 開啟 Bluemix 儀表板，然後按一下您已建立的 {{site.data.keyword.mobilepushfull}} Service 實例來開啟儀表板。即會顯示 Push 儀表板。若要設定適用於 Android 的未連結 {{site.data.keyword.mobilepushshort}} Service，請選取「未連結 {{site.data.keyword.mobilepushshort}} Service」圖示來開啟 {{site.data.keyword.mobilepushshort}} Service 儀表板。 - -![Push 儀表板](images/push_unbound.jpg) - -2. 按一下**設定 Push** 按鈕，以配置適用於 Android 應用程式及 Google Chrome Apps and Extensions 的 FCM/GCM 認證。 -3. 在**配置**頁面上，對於 Android，移至 **Mobile** 標籤，然後配置「傳送端 ID」（GCM 專案號碼）及「API 金鑰」。對於 Google Chrome Apps and Extensions，移至 **Web** 標籤，然後適當地配置「傳送端 ID」（FCM/GCM 專案號碼）及「API 金鑰」。 -4. 按一下**儲存**。 -5. 後續步驟。[啟用 Android 的通知](c_enable_push.html)或[啟用 Google Chrome Apps & Extensions 的通知](c_enable_push.html)。 - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 配置 FCM 的認證 +{: #create-push-enable-gcm} +前次更新：2017 年 1 月 16 日 +{: .last-updated} + +Firebase Cloud Messaging (FCM) 是用來將推送通知遞送至 Android 裝置及 Google Chrome 的閘道。FCM 是新版本的 Google Cloud Messaging (GCM)。若要在儀表板上設定 {{site.data.keyword.mobilepushshort}} 服務，您需要取得 FCM 認證。請確定將 FCM 配置用於新的應用程式。現有應用程式將繼續使用 GCM 配置運作。 + +## 取得傳送端 ID 及 API 金鑰 +{: #android-senderid-apikey} + +API 金鑰會安全地儲存並供 {{site.data.keyword.mobilepushshort}} Service 用來連接至 FCM 伺服器，而適用於 Google Chrome 及 Mozilla Firefox 的 Android SDK 及 JS SDK 在用戶端上使用「傳送端 ID」（專案號碼）。 + +若要設定 FCM 以及產生 API 金鑰和「傳送端 ID」，請完成下列步驟： + +1. 造訪 [Firebase 主控台 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://console.firebase.google.com/?pli=1){: new_window}。 +2. 選取**建立新專案**。 +3. 在「建立專案」視窗中，提供專案名稱、選擇國家/地區，然後按一下**建立專案**。 +3. 在導覽窗格中，按一下「設定」圖示，然後選取**專案設定**。 +4. 選擇 Cloud Messaging 標籤，以產生「伺服器 API 金鑰」及「傳送端 ID」。 + +## 設定適用於 Android 及 Chrome Apps and Extensions 的 {{site.data.keyword.mobilepushshort}} Service +{: #setup-push-android} + +**附註：**您將需要「FCM/GCM API 金鑰」及「傳送端 ID」（專案號碼）。 + +1. 開啟 Bluemix 儀表板，然後按一下您已建立的 {{site.data.keyword.mobilepushfull}} Service 實例來開啟儀表板。即會顯示 Push 儀表板。若要設定適用於 Android 的未連結 {{site.data.keyword.mobilepushshort}} Service，請選取「未連結 {{site.data.keyword.mobilepushshort}} Service」圖示來開啟 {{site.data.keyword.mobilepushshort}} Service 儀表板。 + +![Push 儀表板](images/push_unbound.jpg) + +2. 按一下**設定 Push** 按鈕，以配置適用於 Android 應用程式及 Google Chrome Apps and Extensions 的 FCM/GCM 認證。 +3. 在**配置**頁面上，對於 Android，移至 **Mobile** 標籤，然後配置「傳送端 ID」（GCM 專案號碼）及「API 金鑰」。對於 Google Chrome Apps and Extensions，移至 **Web** 標籤，然後適當地配置「傳送端 ID」（FCM/GCM 專案號碼）及「API 金鑰」。 +4. 按一下**儲存**。 +5. 後續步驟。[啟用 Android 的通知](c_enable_push.html)或[啟用 Google Chrome Apps & Extensions 的通知](c_enable_push.html)。 + + diff --git a/services/mobilepush/nl/zh/TW/t_push_provider_ios.md b/services/mobilepush/nl/zh/TW/t_push_provider_ios.md index 8f09f30c1..c4b945b09 100644 --- a/services/mobilepush/nl/zh/TW/t_push_provider_ios.md +++ b/services/mobilepush/nl/zh/TW/t_push_provider_ios.md @@ -1,145 +1,145 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 配置 APNs 的認證 -{: #create-push-credentials-apns} -前次更新：2017 年 1 月 16 日 -{: .last-updated} - -Apple Push Notification Service (APNs) 容許應用程式開發人員將遠端通知從 Bluemix（提供者）上的 {{site.data.keyword.mobilepushshort}} Service 實例傳送給 iOS 裝置及應用程式。訊息會傳送至裝置上的目標應用程式。 - -請取得並配置 APNs 認證。APNs 憑證是透過 {{site.data.keyword.mobilepushshort}} Service 安全地進行管理，並且用來以提供者身分連接至 APNs 伺服器。 - - - - - - -##登錄應用程式 ID -{: #create-push-credentials-apns-register} - - -「應用程式 ID」（軟體組 ID）是可識別特定應用程式的唯一 ID。每一個應用程式都需要「應用程式 ID」。{{site.data.keyword.mobilepushshort}} Service 這類服務會配置成「應用程式 ID」。 - -1. 請確定您有一個 [Apple Developers ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com/){: new_window} 帳戶。 -2. 移至 [Apple Developer ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com){: new_window} 入口網站，按一下 **Member Center**，然後選取 **Certificates, Identifiers & Profiles**。 -3. 移至 [Apple Developer Library ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window} 中的 **Registering App IDs** 區段，遵循指示登錄 App ID。 - -登錄「應用程式 ID」時，請選取下列選項： - -* Push Notifications -![應用程式服務](images/appID_appservices_enablepush.jpg) -* 明確 ID 字尾 -![明確 ID](images/appID_bundleID.jpg) -4. 建立開發及配送 APNs SSL 憑證。 - -##建立開發及配送 APNs SSL 憑證 -{: #create-push-credentials-apns-ssl} - -您必須先產生憑證簽署要求 (CSR) 並將它提交給 Apple（憑證管理中心 (CA)），才能取得 APNs 憑證。CSR 所含的資訊可識別您的公司，以及用來簽署 Apple Push Notifications 的公開和私密金鑰。然後，在「iOS 開發者入口網站」上產生 SSL 憑證。憑證以及其公開和私密金鑰都儲存在「金鑰鏈存取」中。 - - - - - - -您可以透過兩種模式使用 APNs： - -* 沙盤推演模式，用於進行開發及測試。 -* 正式作業模式，在透過「應用程式市集」（或其他企業配送機制）配送應用程式時使用。 - -您必須取得開發及配送環境的個別憑證。憑證是與接收遠端通知之應用程式的「應用程式 ID」相關聯。對於正式作業，您最多可以建立兩個憑證。Bluemix 使用憑證來建立與 APNs 的 SSL 連線。 - - - -1. 移至 [Apple Developer ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com){: new_window} 網站，按一下 **Member Center**，然後選取 **Certificates, Identifiers & Profiles**。 -2. 在 **Identifiers** 區域中，按一下 **App IDs**。 -3. 從 App IDs 清單中，選取 App ID，然後選取 **Settings**。 -4. 在 **Push Notifications** 區域中，依序建立「開發 SSL」憑證及「正式作業 SSL」憑證。 - - ![Push Notification SSL 憑證](images/certificate_createssl.jpg) - -5. 顯示**關於建立憑證簽署要求 (CSR)** 畫面時，請在 Mac 上啟動**金鑰鏈存取**應用程式，以建立「憑證簽署要求 (CSR)」。 -6. 從功能表中，選取**金鑰鏈存取 > 憑證助理 > 從憑證管理中心要求憑證...** -7. 在**憑證資訊**中，輸入與「應用程式開發人員」帳戶及通用名稱相關聯的電子郵件位址。請提供有意義的名稱，協助您識別它是用於開發（沙盤推演）還是配送（正式作業）的憑證；例如，*sandbox-apns-certificate* 或 *production-apns-certificate*。 -8. 選取**儲存至磁碟**，以將 `.certSigningRequest` 檔案下載至您的桌面，然後按一下**繼續**。 -9. 在**另存新檔**功能表選項中，命名 `.certSigningRequest` 檔案，然後按一下**儲存**。 -10. 按一下**完成**。您現在有 CSR。 -11. 回到**關於建立憑證簽署要求 (CSR)** 視窗，然後按一下**繼續**。 -12. 從**產生**畫面中，按一下**選擇檔案...**，然後選取您儲存在桌面上的 CSR 檔案。然後，按一下**產生**。![產生憑證](images/generate_certificate.jpg) -13. 您的憑證備妥之後，請按一下**完成**。 -14. 在 **Push Notifications** 畫面上，按一下**下載**以下載您的憑證，然後按一下**完成**。![下載憑證](images/certificate_download.jpg) -15. 在 Mac 上，移至**金鑰鏈存取 > 我的憑證**，然後尋找新安裝的憑證。按兩下憑證，以將它安裝至「金鑰鏈存取」。 -16. 選取憑證及私密金鑰，然後選取**匯出**，以將憑證轉換為個人資訊交換格式（`.p12` 格式）。 -![匯出憑證及金鑰](images/keychain_export_key.jpg) -17. 在**另存新檔**欄位中，提供有意義的憑證名稱（例如，`sandbox_apns.p12_certifcate` 或 `production_apns.p12`），然後按一下**儲存**。 -![匯出憑證及金鑰](images/certificate_p12v2.jpg) -18. 在**輸入密碼**欄位中，輸入密碼以保護匯出的項目，然後按一下**確定**。您可以使用此密碼，在 Push 儀表板上配置 APNs 設定。 -{: #step18} - ![匯出憑證及金鑰](images/export_p12.jpg) -19. **Key Access.app** 會提示您從**金鑰鏈**畫面匯出金鑰。請輸入您的管理密碼，以便 Mac 容許您的系統匯出這些項目，然後選取**一律容許**選項。`.p12` 憑證會在桌面上產生。 - - -##建立開發佈建設定檔 -{: #create-push-credentials-dev-profile} - -佈建設定檔與「應用程式 ID」搭配使用，以判定可安裝及執行應用程式的裝置以及您的應用程式可存取的服務。對於每一個「應用程式 ID」，您可以建立兩個佈建設定檔：一個用於開發，另一個用於配送。Xcode 使用開發佈建設定檔來判定容許建置應用程式的開發人員，以及容許在應用程式上進行測試的裝置。 - -請確定您已登錄「應用程式 ID」、已針對 {{site.data.keyword.mobilepushshort}} 服務予以啟用，以及配置它來使用開發及正式作業 APNs SSL 憑證。 - -建立開發佈建設定檔，如下所示： - -1. 移至 [Apple Developer ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com){: new_window} 入口網站，按一下 **Member Center**，然後選取 **Certificates, Identifiers & Profiles**。 -2. 移至 [Mac Developer Library ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}，捲動至 **Creating Development Provisioning Profiles** 區段，並遵循指示以建立開發設定檔。 -**附註**：配置開發佈建設定檔時，請選取下列選項： - * **iOS 應用程式開發** - * **對於 iOS 及 watchOS 應用程式** - - - -##建立市集配送佈建設定檔 -{: #create-push-credentials-apns-distribute_profile} - -使用市集佈建設定檔，將要進行配送的應用程式提交給「應用程式市集」。 - -1. 移至 [Apple Developer ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com){: new_window} 入口網站，按一下 **Member Center**，然後選取 **Certificates, Identifiers & Profiles**。 -2. 按兩下下載的佈建設定檔，以將它安裝至 Xcode。 - -##在 {{site.data.keyword.mobilepushshort}} 儀表板上設定 APNs -{: #create-push-credentials-apns-dashboard} - -若要使用 {{site.data.keyword.mobilepushshort}} Service 來傳送通知，請上傳 Apple Push Notification Service (APNs) 所需的 SSL 憑證。您也可以使用 REST API 來上傳 APNs 憑證。 - - - -APNs 需要的憑證為 `.p12` 憑證。這些憑證包含私密金鑰以及建置和發佈應用程式所需的 SSL 憑證。您必須從 Apple Developer 網站的 Member Center 產生憑證（這需要有效的 Apple Developer 帳戶）。開發環境（沙盤推演）和正式作業（配送）環境需要個別憑證。 - -**附註**：`.cer` 檔案位於您的金鑰鏈存取之後，請將它匯出至您的電腦，以建立 `.p12` 憑證。 - -如需有關使用 APNs 的相關資訊，請參閱 [iOS Developer Library: Local and Push Notification Programming Guide ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}。 - -若要在 Push Notification Service 儀表板上設定 APNs，請完成以下步驟： - -1. 在 Push Notification Service 儀表板上，選取**配置**。 -2. 選擇 **Mobile** 選項，以更新 **APNs Push 認證**表單中的資訊。 -3. 適當地選取**沙盤推演**（開發）或**正式作業**（配送），然後上傳您使用前一個[步驟](#step18)所建立的 `p.12` 憑證。 -![設定 Push Notifications 儀表板](images/wizard.jpg) -3. 在**密碼**欄位中，輸入與 `.p12` 憑證檔案相關聯的密碼，然後按一下**儲存**。 - - -使用有效的密碼順利上傳憑證之後，您就可以開始傳送通知。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 配置 APNs 的認證 +{: #create-push-credentials-apns} +前次更新：2017 年 1 月 16 日 +{: .last-updated} + +Apple Push Notification Service (APNs) 容許應用程式開發人員將遠端通知從 Bluemix（提供者）上的 {{site.data.keyword.mobilepushshort}} Service 實例傳送給 iOS 裝置及應用程式。訊息會傳送至裝置上的目標應用程式。 + +請取得並配置 APNs 認證。APNs 憑證是透過 {{site.data.keyword.mobilepushshort}} Service 安全地進行管理，並且用來以提供者身分連接至 APNs 伺服器。 + + + + + + +##登錄應用程式 ID +{: #create-push-credentials-apns-register} + + +「應用程式 ID」（軟體組 ID）是可識別特定應用程式的唯一 ID。每一個應用程式都需要「應用程式 ID」。{{site.data.keyword.mobilepushshort}} Service 這類服務會配置成「應用程式 ID」。 + +1. 請確定您有一個 [Apple Developers ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com/){: new_window} 帳戶。 +2. 移至 [Apple Developer ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com){: new_window} 入口網站，按一下 **Member Center**，然後選取 **Certificates, Identifiers & Profiles**。 +3. 移至 [Apple Developer Library ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW991){: new_window} 中的 **Registering App IDs** 區段，遵循指示登錄 App ID。 + +登錄「應用程式 ID」時，請選取下列選項： + +* Push Notifications +![應用程式服務](images/appID_appservices_enablepush.jpg) +* 明確 ID 字尾 +![明確 ID](images/appID_bundleID.jpg) +4. 建立開發及配送 APNs SSL 憑證。 + +##建立開發及配送 APNs SSL 憑證 +{: #create-push-credentials-apns-ssl} + +您必須先產生憑證簽署要求 (CSR) 並將它提交給 Apple（憑證管理中心 (CA)），才能取得 APNs 憑證。CSR 所含的資訊可識別您的公司，以及用來簽署 Apple Push Notifications 的公開和私密金鑰。然後，在「iOS 開發者入口網站」上產生 SSL 憑證。憑證以及其公開和私密金鑰都儲存在「金鑰鏈存取」中。 + + + + + + +您可以透過兩種模式使用 APNs： + +* 沙盤推演模式，用於進行開發及測試。 +* 正式作業模式，在透過「應用程式市集」（或其他企業配送機制）配送應用程式時使用。 + +您必須取得開發及配送環境的個別憑證。憑證是與接收遠端通知之應用程式的「應用程式 ID」相關聯。對於正式作業，您最多可以建立兩個憑證。Bluemix 使用憑證來建立與 APNs 的 SSL 連線。 + + + +1. 移至 [Apple Developer ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com){: new_window} 網站，按一下 **Member Center**，然後選取 **Certificates, Identifiers & Profiles**。 +2. 在 **Identifiers** 區域中，按一下 **App IDs**。 +3. 從 App IDs 清單中，選取 App ID，然後選取 **Settings**。 +4. 在 **Push Notifications** 區域中，依序建立「開發 SSL」憑證及「正式作業 SSL」憑證。 + + ![Push Notification SSL 憑證](images/certificate_createssl.jpg) + +5. 顯示**關於建立憑證簽署要求 (CSR)** 畫面時，請在 Mac 上啟動**金鑰鏈存取**應用程式，以建立「憑證簽署要求 (CSR)」。 +6. 從功能表中，選取**金鑰鏈存取 > 憑證助理 > 從憑證管理中心要求憑證...** +7. 在**憑證資訊**中，輸入與「應用程式開發人員」帳戶及通用名稱相關聯的電子郵件位址。請提供有意義的名稱，協助您識別它是用於開發（沙盤推演）還是配送（正式作業）的憑證；例如，*sandbox-apns-certificate* 或 *production-apns-certificate*。 +8. 選取**儲存至磁碟**，以將 `.certSigningRequest` 檔案下載至您的桌面，然後按一下**繼續**。 +9. 在**另存新檔**功能表選項中，命名 `.certSigningRequest` 檔案，然後按一下**儲存**。 +10. 按一下**完成**。您現在有 CSR。 +11. 回到**關於建立憑證簽署要求 (CSR)** 視窗，然後按一下**繼續**。 +12. 從**產生**畫面中，按一下**選擇檔案...**，然後選取您儲存在桌面上的 CSR 檔案。然後，按一下**產生**。![產生憑證](images/generate_certificate.jpg) +13. 您的憑證備妥之後，請按一下**完成**。 +14. 在 **Push Notifications** 畫面上，按一下**下載**以下載您的憑證，然後按一下**完成**。![下載憑證](images/certificate_download.jpg) +15. 在 Mac 上，移至**金鑰鏈存取 > 我的憑證**，然後尋找新安裝的憑證。按兩下憑證，以將它安裝至「金鑰鏈存取」。 +16. 選取憑證及私密金鑰，然後選取**匯出**，以將憑證轉換為個人資訊交換格式（`.p12` 格式）。 +![匯出憑證及金鑰](images/keychain_export_key.jpg) +17. 在**另存新檔**欄位中，提供有意義的憑證名稱（例如，`sandbox_apns.p12_certifcate` 或 `production_apns.p12`），然後按一下**儲存**。 +![匯出憑證及金鑰](images/certificate_p12v2.jpg) +18. 在**輸入密碼**欄位中，輸入密碼以保護匯出的項目，然後按一下**確定**。您可以使用此密碼，在 Push 儀表板上配置 APNs 設定。 +{: #step18} + ![匯出憑證及金鑰](images/export_p12.jpg) +19. **Key Access.app** 會提示您從**金鑰鏈**畫面匯出金鑰。請輸入您的管理密碼，以便 Mac 容許您的系統匯出這些項目，然後選取**一律容許**選項。`.p12` 憑證會在桌面上產生。 + + +##建立開發佈建設定檔 +{: #create-push-credentials-dev-profile} + +佈建設定檔與「應用程式 ID」搭配使用，以判定可安裝及執行應用程式的裝置以及您的應用程式可存取的服務。對於每一個「應用程式 ID」，您可以建立兩個佈建設定檔：一個用於開發，另一個用於配送。Xcode 使用開發佈建設定檔來判定容許建置應用程式的開發人員，以及容許在應用程式上進行測試的裝置。 + +請確定您已登錄「應用程式 ID」、已針對 {{site.data.keyword.mobilepushshort}} 服務予以啟用，以及配置它來使用開發及正式作業 APNs SSL 憑證。 + +建立開發佈建設定檔，如下所示： + +1. 移至 [Apple Developer ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com){: new_window} 入口網站，按一下 **Member Center**，然後選取 **Certificates, Identifiers & Profiles**。 +2. 移至 [Mac Developer Library ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW62site){: new_window}，捲動至 **Creating Development Provisioning Profiles** 區段，並遵循指示以建立開發設定檔。 +**附註**：配置開發佈建設定檔時，請選取下列選項： + * **iOS 應用程式開發** + * **對於 iOS 及 watchOS 應用程式** + + + +##建立市集配送佈建設定檔 +{: #create-push-credentials-apns-distribute_profile} + +使用市集佈建設定檔，將要進行配送的應用程式提交給「應用程式市集」。 + +1. 移至 [Apple Developer ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com){: new_window} 入口網站，按一下 **Member Center**，然後選取 **Certificates, Identifiers & Profiles**。 +2. 按兩下下載的佈建設定檔，以將它安裝至 Xcode。 + +##在 {{site.data.keyword.mobilepushshort}} 儀表板上設定 APNs +{: #create-push-credentials-apns-dashboard} + +若要使用 {{site.data.keyword.mobilepushshort}} Service 來傳送通知，請上傳 Apple Push Notification Service (APNs) 所需的 SSL 憑證。您也可以使用 REST API 來上傳 APNs 憑證。 + + + +APNs 需要的憑證為 `.p12` 憑證。這些憑證包含私密金鑰以及建置和發佈應用程式所需的 SSL 憑證。您必須從 Apple Developer 網站的 Member Center 產生憑證（這需要有效的 Apple Developer 帳戶）。開發環境（沙盤推演）和正式作業（配送）環境需要個別憑證。 + +**附註**：`.cer` 檔案位於您的金鑰鏈存取之後，請將它匯出至您的電腦，以建立 `.p12` 憑證。 + +如需有關使用 APNs 的相關資訊，請參閱 [iOS Developer Library: Local and Push Notification Programming Guide ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW4){: new_window}。 + +若要在 Push Notification Service 儀表板上設定 APNs，請完成以下步驟： + +1. 在 Push Notification Service 儀表板上，選取**配置**。 +2. 選擇 **Mobile** 選項，以更新 **APNs Push 認證**表單中的資訊。 +3. 適當地選取**沙盤推演**（開發）或**正式作業**（配送），然後上傳您使用前一個[步驟](#step18)所建立的 `p.12` 憑證。 +![設定 Push Notifications 儀表板](images/wizard.jpg) +3. 在**密碼**欄位中，輸入與 `.p12` 憑證檔案相關聯的密碼，然後按一下**儲存**。 + + +使用有效的密碼順利上傳憑證之後，您就可以開始傳送通知。 diff --git a/services/mobilepush/nl/zh/TW/t_push_provider_safari.md b/services/mobilepush/nl/zh/TW/t_push_provider_safari.md index 28bccbc55..221de13bc 100644 --- a/services/mobilepush/nl/zh/TW/t_push_provider_safari.md +++ b/services/mobilepush/nl/zh/TW/t_push_provider_safari.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 配置 Web 瀏覽器的認證 -{: #configure-credential-for-browsers} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - -IBM {{site.data.keyword.mobilepushshort}} 服務現在已擴充功能，可將通知傳送至您的瀏覽器。 - -{{site.data.keyword.mobilepushshort}} 服務需要您網站的網站 URL 或網域名稱，以識別需要被容許的要求。{{site.data.keyword.mobilepushshort}} 服務實例一次僅支援一個網域名稱。因此，請確保針對 Chrome、Firefox 及 Safari 設定相同的值。 - -Chrome 及 Safari 瀏覽器需要其他配置才能進行 Web 推送。您將需要 FCM API 金鑰用作 FCM 端點，用來在 Chrome 中遞送訊息。若要取得您的 FCM API 金鑰，請參閱[配置 FCM 的認證](t_push_provider_android.html)。 - - - -##Chrome 及 Firefox Web 推送的配置 -{: #config-chrome-firefox} - -1. 在「Push 儀表板」畫面中，選取**配置**。 -2. 選取 Web 標籤。 -![WebPush 配置](images/webpush_configure.jpg) -3. 配置 FCM/GCM API 金鑰，以及將登錄以接收推送通知的網站 URL。 -4. 按一下**儲存**。 -5. 後續步驟。[啟用 Google Chrome 及 Mozilla Firefox 瀏覽器的通知](c_enable_push.html)。 - - -## Safari Web 推送的配置 -{: #configure-safari} - -Safari 上 {{site.data.keyword.mobilepushshort}} 服務的支援版本為 10.0。需要透過您的 Apple Developer 帳戶產生憑證，才能配置您的瀏覽器來接收通知。 - -### 產生憑證 -{: #certificate-generation} - -請確定您具有 Apple Developer 帳戶。您需要登錄一個 Website Push ID 並產生一個憑證，才能配置 Safari 瀏覽器來接收通知。下列步驟將協助您開始使用。 - -1. 在 Apple Developer Member Center 中，按一下 **Certificates, ID & Profiles**。 -2. 依序按一下 **Identifiers** 及 **Website Push IDs**。 -3. 選取加號圖示來選擇建立新的項目。 - ![Push 儀表板](images/safari_1.jpg) - -4. 在 Register Website Push ID 畫面中，提供適當的 Website Push ID 說明及識別 ID。建議採用反向網域名稱格式，起始於 'web'。例如：web.com.example.dailyweatherreports。 -5. 登錄 Website Push ID。您現在有了自己的 Website Push ID。 -6. 選取 **Edit** 以建立憑證，用於 Website Push ID。 -7. 在 Certificate Information 的 Certificate Assistant 視窗中，提供您的電子郵件 ID 及通用名稱。讓 Certificate Authority 的電子郵件位址保留為空白。 -8. 按一下 **Save to disk**，然後選取 **Continue**。 -9. 選擇將憑證儲存至適當的資料夾。 -10. 選擇在精靈中被提示產生憑證時，在磁碟上建立的 `.certSigningRequest`。請確定您下載以 `. cer` 格式建立的網站推送憑證。 -11. 在 KeyChain Access 工具中開啟憑證。按一下滑鼠右鍵並匯出為 p12 憑證。請記下在產生 p12 憑證的期間所提供的密碼。 - - -### 配置通知 - {: #configuration-notification} - -產生憑證之後，您可以配置服務以傳送通知給 Safari。 - -請完成下列步驟： - -1. 在 Push Notifications 服務儀表板中，按一下**配置**。 -2. 選取 Web 標籤。 -3. 在 Safari Push 區段中，使用必要的資訊更新表單。 - - **網站名稱**：這是您在通知中心提供的名稱。 - - **Website Push ID**：使用 Website Push ID 的反向網域字串來更新。例如，`web.com.example.www`。 - - **網站 URL**：提供應該訂閱推送通知的網站 URL。例如，`https://www.example.com`。 - - **接受的網域**這是選用性的參數。這是向使用者要求許可權的網站清單。請確定 URL 是以逗點區隔的值。請注意，如果未提供此值，將會使用網站 URL 的值。 - - **URL 格式字串**：按一下通知時要解析的 URL。例如，["`https://www.example.com`"]。請確定 URL 使用 http 或 https 方法。 - - **Safari Web 推送憑證**：上傳 .p12 憑證並提供密碼。 -4. 按一下**儲存**。 - -![Push 儀表板](images/push_configure_safari.jpg) - -現在，您已配置好將推送通知傳送到 Safari 瀏覽器。 - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 配置 Web 瀏覽器的認證 +{: #configure-credential-for-browsers} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + +IBM {{site.data.keyword.mobilepushshort}} 服務現在已擴充功能，可將通知傳送至您的瀏覽器。 + +{{site.data.keyword.mobilepushshort}} 服務需要您網站的網站 URL 或網域名稱，以識別需要被容許的要求。{{site.data.keyword.mobilepushshort}} 服務實例一次僅支援一個網域名稱。因此，請確保針對 Chrome、Firefox 及 Safari 設定相同的值。 + +Chrome 及 Safari 瀏覽器需要其他配置才能進行 Web 推送。您將需要 FCM API 金鑰用作 FCM 端點，用來在 Chrome 中遞送訊息。若要取得您的 FCM API 金鑰，請參閱[配置 FCM 的認證](t_push_provider_android.html)。 + + + +## Chrome 及 Firefox Web 推送的配置 +{: #config-chrome-firefox} + +1. 在「Push 儀表板」畫面中，選取**配置**。 +2. 選取 Web 標籤。 +![WebPush 配置](images/webpush_configure.jpg) +3. 配置 FCM/GCM API 金鑰，以及將登錄以接收推送通知的網站 URL。 +4. 按一下**儲存**。 +5. 後續步驟。[啟用 Google Chrome 及 Mozilla Firefox 瀏覽器的通知](c_enable_push.html)。 + + +## Safari Web 推送的配置 +{: #configure-safari} + +Safari 上 {{site.data.keyword.mobilepushshort}} 服務的支援版本為 10.0。需要透過您的 Apple Developer 帳戶產生憑證，才能配置您的瀏覽器來接收通知。 + +### 產生憑證 +{: #certificate-generation} + +請確定您具有 Apple Developer 帳戶。您需要登錄一個 Website Push ID 並產生一個憑證，才能配置 Safari 瀏覽器來接收通知。下列步驟將協助您開始使用。 + +1. 在 Apple Developer Member Center 中，按一下 **Certificates, ID & Profiles**。 +2. 依序按一下 **Identifiers** 及 **Website Push IDs**。 +3. 選取加號圖示來選擇建立新的項目。 + ![Push 儀表板](images/safari_1.jpg) + +4. 在 Register Website Push ID 畫面中，提供適當的 Website Push ID 說明及識別 ID。建議採用反向網域名稱格式，起始於 'web'。例如：web.com.example.dailyweatherreports。 +5. 登錄 Website Push ID。您現在有了自己的 Website Push ID。 +6. 選取 **Edit** 以建立憑證，用於 Website Push ID。 +7. 在 Certificate Information 的 Certificate Assistant 視窗中，提供您的電子郵件 ID 及通用名稱。讓 Certificate Authority 的電子郵件位址保留為空白。 +8. 按一下 **Save to disk**，然後選取 **Continue**。 +9. 選擇將憑證儲存至適當的資料夾。 +10. 選擇在精靈中被提示產生憑證時，在磁碟上建立的 `.certSigningRequest`。請確定您下載以 `. cer` 格式建立的網站推送憑證。 +11. 在 KeyChain Access 工具中開啟憑證。按一下滑鼠右鍵並匯出為 p12 憑證。請記下在產生 p12 憑證的期間所提供的密碼。 + + +### 配置通知 + {: #configuration-notification} + +產生憑證之後，您可以配置服務以傳送通知給 Safari。 + +請完成下列步驟： + +1. 在 Push Notifications 服務儀表板中，按一下**配置**。 +2. 選取 Web 標籤。 +3. 在 Safari Push 區段中，使用必要的資訊更新表單。 + - **網站名稱**：這是您在通知中心提供的名稱。 + - **Website Push ID**：使用 Website Push ID 的反向網域字串來更新。例如，`web.com.example.www`。 + - **網站 URL**：提供應該訂閱推送通知的網站 URL。例如，`https://www.example.com`。 + - **接受的網域**這是選用性的參數。這是向使用者要求許可權的網站清單。請確定 URL 是以逗點區隔的值。請注意，如果未提供此值，將會使用網站 URL 的值。 + - **URL 格式字串**：按一下通知時要解析的 URL。例如，["`https://www.example.com`"]。請確定 URL 使用 http 或 https 方法。 + - **Safari Web 推送憑證**：上傳 .p12 憑證並提供密碼。 +4. 按一下**儲存**。 + +![Push 儀表板](images/push_configure_safari.jpg) + +現在，您已配置好將推送通知傳送到 Safari 瀏覽器。 + + diff --git a/services/mobilepush/nl/zh/TW/t_push_tagsmain.md b/services/mobilepush/nl/zh/TW/t_push_tagsmain.md index c6c46da68..441e893af 100644 --- a/services/mobilepush/nl/zh/TW/t_push_tagsmain.md +++ b/services/mobilepush/nl/zh/TW/t_push_tagsmain.md @@ -1,20 +1,20 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 標籤型通知 -{: #push-ios-main-tags} -前次更新：2017 年 1 月 16 日 -{: .last-updated} - -標籤型通知訊息是指以所有訂閱特定標籤之裝置為目標的訊息。您可以定義標籤，然後使用標籤來傳送及接收訊息。 - -您必須先建立應用程式的標籤、設定標籤訂閱，然後起始標籤型通知。若要使用 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}傳送標籤型通知，請確定在公佈至訊息資源時提供 "tagNames"。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 標籤型通知 +{: #push-ios-main-tags} +前次更新：2017 年 1 月 16 日 +{: .last-updated} + +標籤型通知訊息是指以所有訂閱特定標籤之裝置為目標的訊息。您可以定義標籤，然後使用標籤來傳送及接收訊息。 + +您必須先建立應用程式的標籤、設定標籤訂閱，然後起始標籤型通知。若要使用 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}傳送標籤型通知，請確定在公佈至訊息資源時提供 "tagNames"。 diff --git a/services/mobilepush/nl/zh/TW/t_restapi.md b/services/mobilepush/nl/zh/TW/t_restapi.md index 217334a5d..e7181b55a 100644 --- a/services/mobilepush/nl/zh/TW/t_restapi.md +++ b/services/mobilepush/nl/zh/TW/t_restapi.md @@ -1,123 +1,123 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 使用 REST API -{: #push-api-rest} -前次更新：2017 年 1 月 16 日 -{: .last-updated} - -您可以對 {{site.data.keyword.mobilepushshort}} 使用 REST（具象狀態傳輸）API（應用程式介面）。您也可以使用 SDK（軟體開發套件）及 [Push API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}，進一步開發用戶端應用程式。 - -運用 Push REST API，後端伺服器應用程式及用戶端可以存取 {{site.data.keyword.mobilepushshort}} 功能。 - -- 裝置登錄 -- 登錄 -- 訊息 -- 訂閱 -- 標籤 -- Webhook - -若要取得 REST API 的基本 URL，請完成下列步驟： - -1. 選擇 MobileFirst Services Starter，以在 Bluemix® 型錄的「樣板」區段中建立後端應用程式。這會將 {{site.data.keyword.mobilepushshort}} Service 連結至應用程式。您也可以建立 Push 的服務實例，並將它保留為無界限。 -1. 在 Bluemix 儀表板的主頁面中，移至**應用程式**區域，然後選取您的應用程式。 -3. 按一下**行動選項**。路徑及應用程式 GUID 值會顯示在應用程式的詳細資料頁面開頭。「顯示認證」畫面會顯示 AppSecret 的相關資訊。您可以從「行動選項」取得應用程式密碼，也可以取得部分 API 的用戶端密碼。 - -您也可以使用下列指令行來取得服務認證： - -``` - cf create-service-key {push_instance_name} {key_name} - - cf service-key {push_instance_name} {key_name} -``` - {: codeblock} - -## Accept-Language（接受語言）標頭 -{: #push-api-rest-accept} - -"Accept-Language" 標頭指定要用於 [Push REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window} 所輸出之錯誤訊息的語言。以下是錯誤訊息支援的語言：簡體中文、繁體中文、美式英文、德文、法文、義大利文、日文、韓文、葡萄牙文及西班牙文。 - -## appSecret -{: #push-api-rest-secret} - -應用程式連結至 {{site.data.keyword.mobilepushshort}} 時，服務會產生 appSecret（唯一金鑰）並透過回應標頭進行傳遞。如果您使用的是 IBM {{site.data.keyword.mobilepushshort}} for Bluemix Rest API，請使用 REST API 參考資料來取得所需保護之 API 的資訊。如需資訊，請參閱 [Push REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}。 - -要求標頭必須包含 appSecret。如果沒有，則伺服器會傳回「401 未獲授權」的錯誤碼。將 {{site.data.keyword.mobilepushshort}} 新增至應用程式時，會建立特定的 AppID。在回應中有一個稱為 appSecret 的標頭，它用來建立標籤或傳送訊息。作業是透過型錄或樣板中的服務進行。 - -若要取得 appSecret 值，請執行下列動作： - -1. 按一下連結至 Push 服務的 *app-name*。 -2. 按一下**顯示認證**鏈結，以顯示 appSecret (AppID)。 - -**顯示認證**畫面會顯示 AppSecret 的相關資訊： -``` - { - "imfpush_Dev": [ - { - "name": "testapp1", - "label": "imfpush_Dev", - "plan": "Basic", - "credentials": { - "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", - "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", - "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", - } - } - ] - } -``` - {: codeblock} - - -##Push REST API 過濾器 -{: #push-api-rest-filters} - -過濾器會定義一個搜尋準則，以限制從 {{site.data.keyword.mobilepushshort}} 的 GET API 傳回的資料。請將過濾器套用至您要過濾的 Get 作業結果。過濾器會限制結果中包含的項目數。例如，您可以使用過濾器來搜尋開頭為 "test" 的標籤。 - -過濾器可以使用下列語法產生： - -**name**：要套用過濾器的欄位名稱。 - -**operator**：說明要使用的過濾器相符項目的 ==（完全相符）或 =@（包含子字串）。 - -**expression**：要包含在結果中的值。 - -在表示式中顯示逗點及反斜線時，必須使用反斜線跳出。 - -當您使用多個過濾器時，可以使用 AND 及 OR 邏輯進行結合。 - -- 對於 AND 邏輯，請在查詢中使用多個過濾器。 -- 對於 OR 邏輯，請在過濾器表示式內使用逗點 (,)。 -- 對於 AND 及 OR 邏輯：單一查詢可以同時包含 AND 及 OR 邏輯。會先個別評估每一個過濾器，再使用 AND 表示式結合過濾器。 - -若為裝置 GET API，支援下列組合： -- 名稱為 platform 欄位。 -- 除了 platform 之外，運算子可以是 == 或 =@。 -- 若為 platform，運算子必須是 ==。如果使用運算子 =@，則值可以是子字串。 -- 如果使用 ==，則值必須是完全相符的字串。 - -若為訂閱 GET API，支援下列組合： - -- 名稱可以是下列其中一個欄位：tagName 或 deviceId。 -- 除了 platform 之外，運算子可以是 == 或 =@。 -- 若為 platform，運算子必須是 ==。 -- 如果使用 =@ 運算子，則值可以是子字串。如果使用 == 運算子，則值必須是完全相符的字串。 -- 若為標籤 GET API，支援下列組合： -- 名稱可以是下列其中一個欄位：name 或 description。 -- 如果使用運算子 =@，則值可以是子字串。 -- 如果使用 ==，則值必須是完全相符的字串。 - - -##{{site.data.keyword.mobilepushshort}} 回應碼 -{: #push-api-response-codes} - -狀態：405 不接受方法 - 預期適當的方法。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 使用 REST API +{: #push-api-rest} +前次更新：2017 年 1 月 16 日 +{: .last-updated} + +您可以對 {{site.data.keyword.mobilepushshort}} 使用 REST（具象狀態傳輸）API（應用程式介面）。您也可以使用 SDK（軟體開發套件）及 [Push API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}，進一步開發用戶端應用程式。 + +運用 Push REST API，後端伺服器應用程式及用戶端可以存取 {{site.data.keyword.mobilepushshort}} 功能。 + +- 裝置登錄 +- 登錄 +- 訊息 +- 訂閱 +- 標籤 +- Webhook + +若要取得 REST API 的基本 URL，請完成下列步驟： + +1. 選擇 MobileFirst Services Starter，以在 Bluemix® 型錄的「樣板」區段中建立後端應用程式。這會將 {{site.data.keyword.mobilepushshort}} Service 連結至應用程式。您也可以建立 Push 的服務實例，並將它保留為無界限。 +1. 在 Bluemix 儀表板的主頁面中，移至**應用程式**區域，然後選取您的應用程式。 +3. 按一下**行動選項**。路徑及應用程式 GUID 值會顯示在應用程式的詳細資料頁面開頭。「顯示認證」畫面會顯示 AppSecret 的相關資訊。您可以從「行動選項」取得應用程式密碼，也可以取得部分 API 的用戶端密碼。 + +您也可以使用下列指令行來取得服務認證： + +``` + cf create-service-key {push_instance_name} {key_name} + + cf service-key {push_instance_name} {key_name} +``` + {: codeblock} + +## Accept-Language（接受語言）標頭 +{: #push-api-rest-accept} + +"Accept-Language" 標頭指定要用於 [Push REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window} 所輸出之錯誤訊息的語言。以下是錯誤訊息支援的語言：簡體中文、繁體中文、美式英文、德文、法文、義大利文、日文、韓文、葡萄牙文及西班牙文。 + +## appSecret +{: #push-api-rest-secret} + +應用程式連結至 {{site.data.keyword.mobilepushshort}} 時，服務會產生 appSecret（唯一金鑰）並透過回應標頭進行傳遞。如果您使用的是 IBM {{site.data.keyword.mobilepushshort}} for Bluemix Rest API，請使用 REST API 參考資料來取得所需保護之 API 的資訊。如需資訊，請參閱 [Push REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}。 + +要求標頭必須包含 appSecret。如果沒有，則伺服器會傳回「401 未獲授權」的錯誤碼。將 {{site.data.keyword.mobilepushshort}} 新增至應用程式時，會建立特定的 AppID。在回應中有一個稱為 appSecret 的標頭，它用來建立標籤或傳送訊息。作業是透過型錄或樣板中的服務進行。 + +若要取得 appSecret 值，請執行下列動作： + +1. 按一下連結至 Push 服務的 *app-name*。 +2. 按一下**顯示認證**鏈結，以顯示 appSecret (AppID)。 + +**顯示認證**畫面會顯示 AppSecret 的相關資訊： +``` + { + "imfpush_Dev": [ + { + "name": "testapp1", + "label": "imfpush_Dev", + "plan": "Basic", + "credentials": { + "url": "http://imfpush.ng.bluemix.net/imfpush/v1/apps/b615b280-b37e-4042-8815-38a758f234e2", + "admin_url": "//mobile.ng.bluemix.net/imfpushdashboard/?appGuid=b615b280-b37e-4042-8815-38a758f234e2", + "appSecret": "8dac71a5-2219-42b3-a9f3-dbb828ba1f04", + } + } + ] + } +``` + {: codeblock} + + +## Push REST API 過濾器 +{: #push-api-rest-filters} + +過濾器會定義一個搜尋準則，以限制從 {{site.data.keyword.mobilepushshort}} 的 GET API 傳回的資料。請將過濾器套用至您要過濾的 Get 作業結果。過濾器會限制結果中包含的項目數。例如，您可以使用過濾器來搜尋開頭為 "test" 的標籤。 + +過濾器可以使用下列語法產生： + +**name**：要套用過濾器的欄位名稱。 + +**operator**：說明要使用的過濾器相符項目的 ==（完全相符）或 =@（包含子字串）。 + +**expression**：要包含在結果中的值。 + +在表示式中顯示逗點及反斜線時，必須使用反斜線跳出。 + +當您使用多個過濾器時，可以使用 AND 及 OR 邏輯進行結合。 + +- 對於 AND 邏輯，請在查詢中使用多個過濾器。 +- 對於 OR 邏輯，請在過濾器表示式內使用逗點 (,)。 +- 對於 AND 及 OR 邏輯：單一查詢可以同時包含 AND 及 OR 邏輯。會先個別評估每一個過濾器，再使用 AND 表示式結合過濾器。 + +若為裝置 GET API，支援下列組合： +- 名稱為 platform 欄位。 +- 除了 platform 之外，運算子可以是 == 或 =@。 +- 若為 platform，運算子必須是 ==。如果使用運算子 =@，則值可以是子字串。 +- 如果使用 ==，則值必須是完全相符的字串。 + +若為訂閱 GET API，支援下列組合： + +- 名稱可以是下列其中一個欄位：tagName 或 deviceId。 +- 除了 platform 之外，運算子可以是 == 或 =@。 +- 若為 platform，運算子必須是 ==。 +- 如果使用 =@ 運算子，則值可以是子字串。如果使用 == 運算子，則值必須是完全相符的字串。 +- 若為標籤 GET API，支援下列組合： +- 名稱可以是下列其中一個欄位：name 或 description。 +- 如果使用運算子 =@，則值可以是子字串。 +- 如果使用 ==，則值必須是完全相符的字串。 + + +## {{site.data.keyword.mobilepushshort}} 回應碼 +{: #push-api-response-codes} + +狀態：405 不接受方法 - 預期適當的方法。 diff --git a/services/mobilepush/nl/zh/TW/t_sandbox.md b/services/mobilepush/nl/zh/TW/t_sandbox.md index 78ad3eb38..e969b2953 100644 --- a/services/mobilepush/nl/zh/TW/t_sandbox.md +++ b/services/mobilepush/nl/zh/TW/t_sandbox.md @@ -1,35 +1,35 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 沙盤推演及正式作業模式 -{: #push-sandboxandproduction-modes} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - -您可以透過下列其中一種模式來使用 {{site.data.keyword.mobilepushshort}}：沙盤推演或正式作業。沙盤推演是一種自行包含的測試環境，可開發及測試 Push API 與伺服器應用程式 Push 服務的整合。 - -請使用「Push 儀表板」配置沙盤推演及正式作業模式。您可以使用 [Push REST API](https://mobile.{DomainName}/imfpush/){: new_window}，在沙盤推演與正式作業之間切換推送服務的作業模式。預設會啟用沙盤推演模式。不過，當您切換模式時，在這些模式之間不會共用標籤、裝置及訂閱。 - -如果已準備好將應用程式部署至即時環境，請使用 [Push REST API](https://mobile.{DomainName}/imfpush/){: new_window} 選取「正式作業」模式。 - -若要將推送服務的作業模式從沙盤推演切換至正式作業，請執行下列動作： - -1. 使用 PUT ApplicationID Settings REST API 呼叫 -2. 在 JSON 主體中，使用 [GET ApplicationID Settings REST](https://mobile.{DomainName}/imfpush/){: new_window} API 呼叫來確認已切換模式。預期的回應為 "mode": "PRODUCTION" -```{ - "mode": "PRODUCTION" - } -``` - {: codeblock} -1. 在切換環境模式之後，請重新執行用戶端程式碼，以「正式作業」模式登錄裝置。 - -如需 REST API 的相關資訊，請參閱[使用 REST API](t_restapi.html)。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 沙盤推演及正式作業模式 +{: #push-sandboxandproduction-modes} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + +您可以透過下列其中一種模式來使用 {{site.data.keyword.mobilepushshort}}：沙盤推演或正式作業。沙盤推演是一種自行包含的測試環境，可開發及測試 Push API 與伺服器應用程式 Push 服務的整合。 + +請使用「Push 儀表板」配置沙盤推演及正式作業模式。您可以使用 [Push REST API](https://mobile.{DomainName}/imfpush/){: new_window}，在沙盤推演與正式作業之間切換推送服務的作業模式。預設會啟用沙盤推演模式。不過，當您切換模式時，在這些模式之間不會共用標籤、裝置及訂閱。 + +如果已準備好將應用程式部署至即時環境，請使用 [Push REST API](https://mobile.{DomainName}/imfpush/){: new_window} 選取「正式作業」模式。 + +若要將推送服務的作業模式從沙盤推演切換至正式作業，請執行下列動作： + +1. 使用 PUT ApplicationID Settings REST API 呼叫 +2. 在 JSON 主體中，使用 [GET ApplicationID Settings REST](https://mobile.{DomainName}/imfpush/){: new_window} API 呼叫來確認已切換模式。預期的回應為 "mode": "PRODUCTION" +```{ + "mode": "PRODUCTION" + } +``` + {: codeblock} +1. 在切換環境模式之後，請重新執行用戶端程式碼，以「正式作業」模式登錄裝置。 + +如需 REST API 的相關資訊，請參閱[使用 REST API](t_restapi.html)。 diff --git a/services/mobilepush/nl/zh/TW/t_send_push_notifications.md b/services/mobilepush/nl/zh/TW/t_send_push_notifications.md index f9dcfec00..123192c0a 100644 --- a/services/mobilepush/nl/zh/TW/t_send_push_notifications.md +++ b/services/mobilepush/nl/zh/TW/t_send_push_notifications.md @@ -1,37 +1,37 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 傳送基本推送通知 -{: #push-send-notifications} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - -開發應用程式之後，您可以傳送基本推送通知（不需要使用標籤、徽章、其他有效負載或音效檔）。 - -若要傳送基本推送通知，請完成所列出的步驟： - -1. 選取**傳送通知**，然後選擇適當的**傳送至**選項。 - -**附註**：當您選取**所有裝置**選項時，所有已訂閱 {{site.data.keyword.mobilepushshort}} 的裝置都會接收到通知。 - -![通知畫面](images/tag_notification.jpg) -2. 在**訊息**欄位中，輸入您的訊息，然後按一下**傳送**。 - -3. 驗證您的裝置已接收到通知。下列影像顯示在 Android 及 iOS 裝置的前景中處理 {{site.data.keyword.mobilepushshort}} 的警示框。 - -![Android 上的前景推送通知](images/Android_Screenshot.jpg) - -![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) - -下列擷取畫面顯示 Android 的背景中的 {{site.data.keyword.mobilepushshort}}。 - -![Android 上的背景推送通知](images/background.jpg) +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 傳送基本推送通知 +{: #push-send-notifications} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + +開發應用程式之後，您可以傳送基本推送通知（不需要使用標籤、徽章、其他有效負載或音效檔）。 + +若要傳送基本推送通知，請完成所列出的步驟： + +1. 選取**傳送通知**，然後選擇適當的**傳送至**選項。 + +**附註**：當您選取**所有裝置**選項時，所有已訂閱 {{site.data.keyword.mobilepushshort}} 的裝置都會接收到通知。 + +![通知畫面](images/tag_notification.jpg) +2. 在**訊息**欄位中，輸入您的訊息，然後按一下**傳送**。 + +3. 驗證您的裝置已接收到通知。下列影像顯示在 Android 及 iOS 裝置的前景中處理 {{site.data.keyword.mobilepushshort}} 的警示框。 + +![Android 上的前景推送通知](images/Android_Screenshot.jpg) + +![iOS 上的前景推送通知](images/iOS_Screenshot.jpg) + +下列擷取畫面顯示 Android 的背景中的 {{site.data.keyword.mobilepushshort}}。 + +![Android 上的背景推送通知](images/background.jpg) diff --git a/services/mobilepush/nl/zh/TW/t_service_instance.md b/services/mobilepush/nl/zh/TW/t_service_instance.md index bf23c8605..d81c8a48b 100644 --- a/services/mobilepush/nl/zh/TW/t_service_instance.md +++ b/services/mobilepush/nl/zh/TW/t_service_instance.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 建立 Push 服務實例 -{: #create-push-instance} - -若要開始使用 {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}，請先建立 {{site.data.keyword.Bluemix}} 應用程式；例如，Node.js 應用程式。然後，建立需要連結至此 Bluemix 應用程式之 Push 服務 ({{site.data.keyword.mobilepushfull}}) 的實例。另一種作法為移至 Bluemix 型錄的「樣板」區段，然後按一下 MobileFirst Services Starter。 - -**附註**：如果您已配置組織來管理環境，請選取該組織，而您要在該組織中建立針對行動應用程式的運行環境及服務。 - - -1. 如果您沒有 Bluemix 應用程式，則需要予以建立（例如，Node.js 應用程式）。若要建立 Bluemix 應用程式，請移至 Bluemix 儀表板，然後按一下**建立應用程式**。 - - **附註**：如果已有應用程式，請移至步驟 7 來新增服務。![建立服務實例](images/create_service_instance1.jpg "建立服務實例") - -1. 從**選擇應用程式範本**中，按一下 **WEB**。 - -3. 在**選取起點**區域中，選取 **SDK for Node.js**，然後按一下**繼續**。![起點](images/create_service_nodejs2.jpg) - -4. 從**空間**下拉功能表中，選取您的組織空間。 - - ![ -選取組織空間](images/create_a_service3.jpg) -1. 在**名稱**中，輸入您應用程式的名稱，然後在主機中輸入主機名稱。 - -1. 從**選取的方案**下拉功能表中選取方案，然後按一下**建立**按鈕。請等待應用程式編譯打包。 - -1. 按一下**概觀**鏈結。![新增服務](images/create_service_add4.jpg) -1. 按一下**新增服務**。即會顯示「型錄」畫面。 - -1. 選取 **IBM Push Notifications：**，然後從**空間**下拉功能表中，選取您的組織。 - - ![組織空間下拉功能表](images/create_service_org.jpg) -1. 在**服務**名稱中，輸入 Push Notification Service 名稱。 - -1. 在**選取的方案**中選取方案，然後按一下**建立**按鈕。 - -1. 按一下**是**，以重新編譯打包應用程式。 - - ![IBM Push Notification Service](images/create_service_notification5.jpg) - -1. 按一下 **Push Notifications**，以顯示 Push Notifications 儀表板。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 建立 Push 服務實例 +{: #create-push-instance} + +若要開始使用 {{site.data.keyword.IBM}} {{site.data.keyword.mobilepushshort}}，請先建立 {{site.data.keyword.Bluemix}} 應用程式；例如，Node.js 應用程式。然後，建立需要連結至此 Bluemix 應用程式之 Push 服務 ({{site.data.keyword.mobilepushfull}}) 的實例。另一種作法為移至 Bluemix 型錄的「樣板」區段，然後按一下 MobileFirst Services Starter。 + +**附註**：如果您已配置組織來管理環境，請選取該組織，而您要在該組織中建立針對行動應用程式的運行環境及服務。 + + +1. 如果您沒有 Bluemix 應用程式，則需要予以建立（例如，Node.js 應用程式）。若要建立 Bluemix 應用程式，請移至 Bluemix 儀表板，然後按一下**建立應用程式**。 + + **附註**：如果已有應用程式，請移至步驟 7 來新增服務。![建立服務實例](images/create_service_instance1.jpg "建立服務實例") + +1. 從**選擇應用程式範本**中，按一下 **WEB**。 + +3. 在**選取起點**區域中，選取 **SDK for Node.js**，然後按一下**繼續**。![起點](images/create_service_nodejs2.jpg) + +4. 從**空間**下拉功能表中，選取您的組織空間。 + + ![ +選取組織空間](images/create_a_service3.jpg) +1. 在**名稱**中，輸入您應用程式的名稱，然後在主機中輸入主機名稱。 + +1. 從**選取的方案**下拉功能表中選取方案，然後按一下**建立**按鈕。請等待應用程式編譯打包。 + +1. 按一下**概觀**鏈結。![新增服務](images/create_service_add4.jpg) +1. 按一下**新增服務**。即會顯示「型錄」畫面。 + +1. 選取 **IBM Push Notifications：**，然後從**空間**下拉功能表中，選取您的組織。 + + ![組織空間下拉功能表](images/create_service_org.jpg) +1. 在**服務**名稱中，輸入 Push Notification Service 名稱。 + +1. 在**選取的方案**中選取方案，然後按一下**建立**按鈕。 + +1. 按一下**是**，以重新編譯打包應用程式。 + + ![IBM Push Notification Service](images/create_service_notification5.jpg) + +1. 按一下 **Push Notifications**，以顯示 Push Notifications 儀表板。 diff --git a/services/mobilepush/nl/zh/TW/t_subscribe_tags.md b/services/mobilepush/nl/zh/TW/t_subscribe_tags.md index 44b8a1361..c3ac5446f 100644 --- a/services/mobilepush/nl/zh/TW/t_subscribe_tags.md +++ b/services/mobilepush/nl/zh/TW/t_subscribe_tags.md @@ -1,126 +1,126 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 訂閱及取消訂閱標籤 -{: #Subscribe_tags} - -使用下列程式碼 Snippet，可容許裝置取得訂閱、訂閱標籤，以及取消訂閱標籤。 - -## Android - -複製下列程式碼 Snippet，並將其貼入 Android 行動應用程式。 - -``` -push.subscribe(allTags.get(0), -new MFPPushResponseListener() { - @Override - public void onFailure(MFPPushException ex) { - updateTextView("Error subscribing to Tag1.." - + ex.getMessage()); - } - @Override - public void onSuccess(String arg0) { - updateTextView("Succesfully Subscribed to: "+ arg0); - unsubscribeFromTags(arg0); - } -}); -``` - -``` -push.unsubscribe(tag, new MFPPushResponseListener() { - @Override - public void onSuccess(String s) { - updateTextView("Unsubscribing from tag"); - updateTextView("Successfully unsubscribed from tag . "+ tag); - } - @Override - public void onFailure(MFPPushException e) { - updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); - } -}); -``` - -## Cordova - -複製下列程式碼 Snippet，並將其貼入 Cordova 行動應用程式。 - -``` -var tag = "YourTag"; -MFPPush.subscribe(tag, success, failure); -MFPPush.unsubscribe(tag, success, failure); -``` - -## Objective-C - -複製下列程式碼 Snippet，並將其貼入 Objective-C 行動應用程式。 - -使用 **subscribeToTags** API 來訂閱標籤。 - -``` -[push subscribeToTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if(error){ - [self updateMessage:error.description]; - }else{ - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response subscribeStatus]; - [self updateMessage:@"Parsed subscribe status is:"]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -使用 **unsubscribeFromTags** API 來取消訂閱標籤。 - -``` -[push unsubscribeFromTags:tags completionHandler: -^(IMFResponse *response, NSError *error) { - if (error){ - [self updateMessage:error.description]; - } else { - NSDictionary* subStatus = [[NSDictionary alloc]init]; - subStatus = [response unsubscribeStatus]; - [self updateMessage:subStatus.description]; - } -}]; -``` - -## Swift - -複製下列程式碼 Snippet，並將其貼入 Swift 行動應用程式。 - -**訂閱可用的標籤** - -使用 **subscribeToTags** API 來訂閱標籤。 - -``` -push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in - if (error != nil) { - //error while subscribing to tags - } else { - //successfully subscribed to tags var subStatus = response.subscribeStatus(); - } -} -``` - -**取消訂閱標籤** - -使用 **unsubscribeFromTags** API 來取消訂閱標籤。 - -``` -push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in - - if error.isEmpty { - print( "Response during unsubscribed tags : \(response.description)") - print( "status code during unsubscribed tags : \(statusCode)") - } - else { - print( "Error during unsubscribed tags \(error) ") - print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") - } -} -``` +--- + +copyright: + years: 2015, 2016 + +--- + +# 訂閱及取消訂閱標籤 +{: #Subscribe_tags} + +使用下列程式碼 Snippet，可容許裝置取得訂閱、訂閱標籤，以及取消訂閱標籤。 + +## Android + +複製下列程式碼 Snippet，並將其貼入 Android 行動應用程式。 + +``` +push.subscribe(allTags.get(0), +new MFPPushResponseListener() { + @Override + public void onFailure(MFPPushException ex) { + updateTextView("Error subscribing to Tag1.." + + ex.getMessage()); + } + @Override + public void onSuccess(String arg0) { + updateTextView("Succesfully Subscribed to: "+ arg0); + unsubscribeFromTags(arg0); + } +}); +``` + +``` +push.unsubscribe(tag, new MFPPushResponseListener() { + @Override + public void onSuccess(String s) { + updateTextView("Unsubscribing from tag"); + updateTextView("Successfully unsubscribed from tag . "+ tag); + } + @Override + public void onFailure(MFPPushException e) { + updateTextView("Error while unsubscribing from tags. "+ e.getMessage()); + } +}); +``` + +## Cordova + +複製下列程式碼 Snippet，並將其貼入 Cordova 行動應用程式。 + +``` +var tag = "YourTag"; +MFPPush.subscribe(tag, success, failure); +MFPPush.unsubscribe(tag, success, failure); +``` + +## Objective-C + +複製下列程式碼 Snippet，並將其貼入 Objective-C 行動應用程式。 + +使用 **subscribeToTags** API 來訂閱標籤。 + +``` +[push subscribeToTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if(error){ + [self updateMessage:error.description]; + }else{ + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response subscribeStatus]; + [self updateMessage:@"Parsed subscribe status is:"]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +使用 **unsubscribeFromTags** API 來取消訂閱標籤。 + +``` +[push unsubscribeFromTags:tags completionHandler: +^(IMFResponse *response, NSError *error) { + if (error){ + [self updateMessage:error.description]; + } else { + NSDictionary* subStatus = [[NSDictionary alloc]init]; + subStatus = [response unsubscribeStatus]; + [self updateMessage:subStatus.description]; + } +}]; +``` + +## Swift + +複製下列程式碼 Snippet，並將其貼入 Swift 行動應用程式。 + +**訂閱可用的標籤** + +使用 **subscribeToTags** API 來訂閱標籤。 + +``` +push.subscribeToTags(tagsArray: tags) { (response: IMFResponse!, error: NSError!) -> Void in + if (error != nil) { + //error while subscribing to tags + } else { + //successfully subscribed to tags var subStatus = response.subscribeStatus(); + } +} +``` + +**取消訂閱標籤** + +使用 **unsubscribeFromTags** API 來取消訂閱標籤。 + +``` +push.unsubscribeFromTags(response, completionHandler: { (response, statusCode, error) -> Void in + + if error.isEmpty { + print( "Response during unsubscribed tags : \(response.description)") + print( "status code during unsubscribed tags : \(statusCode)") + } + else { + print( "Error during unsubscribed tags \(error) ") + print( "Error during unsubscribed tags \n - status code: \(statusCode) \n Error :\(error) \n") + } +} +``` diff --git a/services/mobilepush/nl/zh/TW/t_use_tags.md b/services/mobilepush/nl/zh/TW/t_use_tags.md index aa1c98884..724870a50 100644 --- a/services/mobilepush/nl/zh/TW/t_use_tags.md +++ b/services/mobilepush/nl/zh/TW/t_use_tags.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -# 使用標籤型通知 -{: #using_tags} - - -標籤型通知是指以所有訂閱特定標籤之裝置為目標的通知訊息。每一個裝置都可以訂閱任意數目的標籤。本節說明如何傳送標籤型通知。訂閱透過 Push Notification Service Bluemix 實例進行維護。刪除標籤時，會刪除與該標籤相關聯的所有資訊，包括其訂閱者及裝置。無需對此標籤進行自動取消訂閱，因為此標籤已不存在，因此也不需要從用戶端採取進一步的動作。 - -**開始之前** - -在**標籤**畫面上建立標籤。如需如何建立標籤的相關資訊，請參閱[建立標籤](t_manage_tags.html)。 - -1. 從**推送通知**儀表板中，按一下**通知**標籤。 -1. 選取**標籤**選項，以傳送標籤型通知。 -1. 在**搜尋標籤**欄位中，搜尋您要使用的標籤，然後按一下 **+ 新增**按鈕。![通知畫面](images/tag_notification.jpg) -1. 移至**建立您的通知**區域，然後在**訊息文字**欄位中輸入要在通知中傳送的文字。 -1. 按一下**傳送**按鈕。 +--- + +copyright: + years: 2015, 2016 + +--- + +# 使用標籤型通知 +{: #using_tags} + + +標籤型通知是指以所有訂閱特定標籤之裝置為目標的通知訊息。每一個裝置都可以訂閱任意數目的標籤。本節說明如何傳送標籤型通知。訂閱透過 Push Notification Service Bluemix 實例進行維護。刪除標籤時，會刪除與該標籤相關聯的所有資訊，包括其訂閱者及裝置。無需對此標籤進行自動取消訂閱，因為此標籤已不存在，因此也不需要從用戶端採取進一步的動作。 + +**開始之前** + +在**標籤**畫面上建立標籤。如需如何建立標籤的相關資訊，請參閱[建立標籤](t_manage_tags.html)。 + +1. 從**推送通知**儀表板中，按一下**通知**標籤。 +1. 選取**標籤**選項，以傳送標籤型通知。 +1. 在**搜尋標籤**欄位中，搜尋您要使用的標籤，然後按一下 **+ 新增**按鈕。![通知畫面](images/tag_notification.jpg) +1. 移至**建立您的通知**區域，然後在**訊息文字**欄位中輸入要在通知中傳送的文字。 +1. 按一下**傳送**按鈕。 diff --git a/services/mobilepush/nl/zh/TW/tr_error_push.md b/services/mobilepush/nl/zh/TW/tr_error_push.md index cc7924073..b461a02b4 100644 --- a/services/mobilepush/nl/zh/TW/tr_error_push.md +++ b/services/mobilepush/nl/zh/TW/tr_error_push.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# {{site.data.keyword.mobilepushshort}} Service 錯誤訊息 -{: #errors} -前次更新：2017 年 2 月 13 日 -{: .last-updated} - - -傳回下列 {{site.data.keyword.mobilepushshort}} 錯誤訊息，以回應 REST API 要求。 - -錯誤回應範例： -``` - { - "message": "Missing APNs credentials", - "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", - "code": "FPWSE0003E" - -} -``` - {: codeblock} - -若要取得錯誤的其他相關資訊，請搜尋相關錯誤碼的文件。 - -## FPWSE0001E -{: #error_fpwse0001e} - -**說明**：伺服器上沒有您嘗試查詢的資源（例如標籤或訂閱）。 - -**使用者回應**：請建立訊息中所報告的資源。或者，提供正確的 ID 來查詢資源。 - - -## FPWSE0002E -{: #error_fpwse0002e} - -**說明**：伺服器上已有您嘗試建立的資源。此資源可以是標籤、訂閱等等。 - -**使用者回應**：請使用不同的 ID 建立資源。 - - -## FPWSE0003E -{: #error_fpwse0003e} - -**說明**：{{site.data.keyword.mobilepushshort}} Service 的必要配置未完成。在配置之前，請嘗試取得 Apple Push Notification Service (APNs) 認證。 - -**使用者回應**：請確定已使用 APNs 的有效安全憑證配置 {{site.data.keyword.mobilepushshort}} Service。如需相關資訊，請參閱 [配置 APNs 的認證 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](t_push_provider_ios.html){: new_window}。 - - -## FPWSE0004E -{: #error_fpwse0004e} - -**說明**：要求中內含的 JSON 主體無效。 - - -**使用者回應**：請確定您在要求使用的是有效的 JSON 語法。 - - - -## FPWSE0005E -{: #error_fpwse0005e} - -**說明**：向 {{site.data.keyword.mobilepushshort}} 伺服器提出的要求不正確或不完整，因為 JSON 主體未包含完成 API 要求所需的內容值。例如，密碼無效或裝置記號遺漏。 - - -**使用者回應**：請檢閱訊息以瞭解遺漏或無效的內容值，然後提供必要資訊。 - - - -## FPWSE0006E -{: #error_fpwse0006e} - -**說明**：要求的 JSON 主體具有 {{site.data.keyword.mobilepushshort}} 伺服器不瞭解的參數。 - - -**使用者回應**：請確認要求中的 JSON 主體遵循 {{site.data.keyword.mobilepushshort}} 伺服器所預期要求的格式。如需相關資訊，請參閱 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}。 - - - -## FPWSE0007E -{: #error_fpwse0007e} - -**說明**：要求 URL 的查詢字串含有無法辨識的參數。例如，如果刪除訂閱的要求中含有 deviceId 及 tagName 以外的參數，則可能發生此錯誤。 - - -**使用者回應**：請確認要求中的 JSON 主體遵循 {{site.data.keyword.mobilepushshort}} 伺服器所預期要求的格式。如需相關資訊，請參閱 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}。 - - - -## FPWSE0008E -{: #error_fpwse0008e} - -**說明**：要求 URL 的查詢字串遺漏必要的參數。例如，刪除訂閱的要求中遺漏 deviceId 及 tagName 參數。 - - -**使用者回應**：請確認要求中的 JSON 主體遵循 {{site.data.keyword.mobilepushshort}} 伺服器所預期要求的格式。如需相關資訊，請參閱 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}。 - - - -## FPWSE0009E -{: #error_fpwse0009e} - -**說明**：嘗試傳送通知，但沒有任何裝置已向應用程式進行登錄。 - -**使用者回應**：嘗試傳送通知之前，請確定裝置已向應用程式進行登錄。 - - - -## FPWSE0010E -{: #error_fpwse0010e} - -**說明**：提交至伺服器的要求導致異常狀況。下列其中一種狀況可能造成此錯誤： - -- {{site.data.keyword.mobilepushshort}} 使用的某個內部子系統未回應。 -- 導致錯誤狀況的要求可能不是由 {{site.data.keyword.mobilepushshort}} 處理。 -- {{site.data.keyword.mobilepushshort}} Service 需要管理者的注意。 - -**使用者回應**：請重試要求。如果問題持續發生，請聯絡 IBM 軟體支援中心。 - - - -## FPWSE0011E -{: #error_fpwse0011e} - -**說明**：伺服器上已存在訂閱的標籤。例如，若您建立已存在的訂閱時。 - -**使用者回應**：請使用唯一標籤名稱來建立訂閱。 - - - -## FPWSE0012E -{: #error_fpwse0012e} - -**說明**：伺服器上不存在訂閱的標籤。提交要擷取或刪除不存在的訂閱的要求時，會發生此錯誤。 - - -**使用者回應**：請在要求中使用正確的標籤名稱及裝置 ID。 - - - -## FPWSE0013E -{: #error_fpwse0013e} - -**說明**：要求中的 JSON 有效負載無效。 - - -**使用者回應**：請確定 JSON 有效負載是有效的。 - - -## FPWSE0025E -{: #error_fpwse0025e} - -**說明**：伺服器目前無法處理要求。 - -**使用者回應**：請稍後再重新提交要求。 - - -## FPWSE1007E -{: #error_fpwse1007e} - -**說明**：此應用程式的 {{site.data.keyword.mobilepushshort}} Service 已停用。這可能是因為管理者已停用計費或應用程式。 - - -**使用者回應**：請參閱「Bluemix 文件」中的「疑難排解」主題，以檢查服務狀態、檢閱疑難排解資訊或取得協助的相關資訊。 - - - -## FPWSE1079E -{: #error_fpwse1079e} - -**說明**：針對查詢作業所提供的偏移值無效。 - -**使用者回應**：請確定偏移值大於或等於零。 - - - -## FPWSE1080E -{: #error_fpwse1080e} - -**說明**：針對查詢作業所提供的大小值無效。 - -**使用者回應**：請確定大小值大於或等於零。 - - - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# {{site.data.keyword.mobilepushshort}} Service 錯誤訊息 +{: #errors} +前次更新：2017 年 2 月 13 日 +{: .last-updated} + + +傳回下列 {{site.data.keyword.mobilepushshort}} 錯誤訊息，以回應 REST API 要求。 + +錯誤回應範例： +``` + { + "message": "Missing APNs credentials", + "docUrl": "https://www.ng.bluemix.net/docs/troubleshoot/errors/mobilepush/index.html#FPWSE0003E", + "code": "FPWSE0003E" + +} +``` + {: codeblock} + +若要取得錯誤的其他相關資訊，請搜尋相關錯誤碼的文件。 + +## FPWSE0001E +{: #error_fpwse0001e} + +**說明**：伺服器上沒有您嘗試查詢的資源（例如標籤或訂閱）。 + +**使用者回應**：請建立訊息中所報告的資源。或者，提供正確的 ID 來查詢資源。 + + +## FPWSE0002E +{: #error_fpwse0002e} + +**說明**：伺服器上已有您嘗試建立的資源。此資源可以是標籤、訂閱等等。 + +**使用者回應**：請使用不同的 ID 建立資源。 + + +## FPWSE0003E +{: #error_fpwse0003e} + +**說明**：{{site.data.keyword.mobilepushshort}} Service 的必要配置未完成。在配置之前，請嘗試取得 Apple Push Notification Service (APNs) 認證。 + +**使用者回應**：請確定已使用 APNs 的有效安全憑證配置 {{site.data.keyword.mobilepushshort}} Service。如需相關資訊，請參閱 [配置 APNs 的認證 ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](t_push_provider_ios.html){: new_window}。 + + +## FPWSE0004E +{: #error_fpwse0004e} + +**說明**：要求中內含的 JSON 主體無效。 + + +**使用者回應**：請確定您在要求使用的是有效的 JSON 語法。 + + + +## FPWSE0005E +{: #error_fpwse0005e} + +**說明**：向 {{site.data.keyword.mobilepushshort}} 伺服器提出的要求不正確或不完整，因為 JSON 主體未包含完成 API 要求所需的內容值。例如，密碼無效或裝置記號遺漏。 + + +**使用者回應**：請檢閱訊息以瞭解遺漏或無效的內容值，然後提供必要資訊。 + + + +## FPWSE0006E +{: #error_fpwse0006e} + +**說明**：要求的 JSON 主體具有 {{site.data.keyword.mobilepushshort}} 伺服器不瞭解的參數。 + + +**使用者回應**：請確認要求中的 JSON 主體遵循 {{site.data.keyword.mobilepushshort}} 伺服器所預期要求的格式。如需相關資訊，請參閱 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}。 + + + +## FPWSE0007E +{: #error_fpwse0007e} + +**說明**：要求 URL 的查詢字串含有無法辨識的參數。例如，如果刪除訂閱的要求中含有 deviceId 及 tagName 以外的參數，則可能發生此錯誤。 + + +**使用者回應**：請確認要求中的 JSON 主體遵循 {{site.data.keyword.mobilepushshort}} 伺服器所預期要求的格式。如需相關資訊，請參閱 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}。 + + + +## FPWSE0008E +{: #error_fpwse0008e} + +**說明**：要求 URL 的查詢字串遺漏必要的參數。例如，刪除訂閱的要求中遺漏 deviceId 及 tagName 參數。 + + +**使用者回應**：請確認要求中的 JSON 主體遵循 {{site.data.keyword.mobilepushshort}} 伺服器所預期要求的格式。如需相關資訊，請參閱 [REST API ![外部鏈結圖示](../../icons/launch-glyph.svg "外部鏈結圖示")](https://mobile.{DomainName}/imfpush/){: new_window}。 + + + +## FPWSE0009E +{: #error_fpwse0009e} + +**說明**：嘗試傳送通知，但沒有任何裝置已向應用程式進行登錄。 + +**使用者回應**：嘗試傳送通知之前，請確定裝置已向應用程式進行登錄。 + + + +## FPWSE0010E +{: #error_fpwse0010e} + +**說明**：提交至伺服器的要求導致異常狀況。下列其中一種狀況可能造成此錯誤： + +- {{site.data.keyword.mobilepushshort}} 使用的某個內部子系統未回應。 +- 導致錯誤狀況的要求可能不是由 {{site.data.keyword.mobilepushshort}} 處理。 +- {{site.data.keyword.mobilepushshort}} Service 需要管理者的注意。 + +**使用者回應**：請重試要求。如果問題持續發生，請聯絡 IBM 軟體支援中心。 + + + +## FPWSE0011E +{: #error_fpwse0011e} + +**說明**：伺服器上已存在訂閱的標籤。例如，若您建立已存在的訂閱時。 + +**使用者回應**：請使用唯一標籤名稱來建立訂閱。 + + + +## FPWSE0012E +{: #error_fpwse0012e} + +**說明**：伺服器上不存在訂閱的標籤。提交要擷取或刪除不存在的訂閱的要求時，會發生此錯誤。 + + +**使用者回應**：請在要求中使用正確的標籤名稱及裝置 ID。 + + + +## FPWSE0013E +{: #error_fpwse0013e} + +**說明**：要求中的 JSON 有效負載無效。 + + +**使用者回應**：請確定 JSON 有效負載是有效的。 + + +## FPWSE0025E +{: #error_fpwse0025e} + +**說明**：伺服器目前無法處理要求。 + +**使用者回應**：請稍後再重新提交要求。 + + +## FPWSE1007E +{: #error_fpwse1007e} + +**說明**：此應用程式的 {{site.data.keyword.mobilepushshort}} Service 已停用。這可能是因為管理者已停用計費或應用程式。 + + +**使用者回應**：請參閱「Bluemix 文件」中的「疑難排解」主題，以檢查服務狀態、檢閱疑難排解資訊或取得協助的相關資訊。 + + + +## FPWSE1079E +{: #error_fpwse1079e} + +**說明**：針對查詢作業所提供的偏移值無效。 + +**使用者回應**：請確定偏移值大於或等於零。 + + + +## FPWSE1080E +{: #error_fpwse1080e} + +**說明**：針對查詢作業所提供的大小值無效。 + +**使用者回應**：請確定大小值大於或等於零。 + + + diff --git a/services/mobilepush/nl/zh/TW/troubleshooting.md b/services/mobilepush/nl/zh/TW/troubleshooting.md index 03f8bfa13..a3f3f34dd 100644 --- a/services/mobilepush/nl/zh/TW/troubleshooting.md +++ b/services/mobilepush/nl/zh/TW/troubleshooting.md @@ -1,47 +1,47 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 疑難排解 -{: #errors} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - -請使用本節作為一般 {{site.data.keyword.mobilepushshort}} 問題的疑難排解指引。 - - -### 發生內部伺服器錯誤。請與管理者聯絡。（內部錯誤碼：PUSHD102E） - -**說明**：如果您在 2015 年 11 月之前已建立 Push 實例，則可能發生此錯誤。 - -**使用者回應**：若要解決此問題，請刪除 Push 實例然後建立一個新的。請注意，當您刪除 Push 實例時，不會保留您的標籤。 - - -### UnauthorizedRegistration - -**說明**：Chrome Web Push 無法與 Firebase Cloud Messaging (FCM) 金鑰搭配使用。如果您從 GCM 移至 FCM 之後無法在 Chrome 上接收 Web Push 通知，這是因為網站先前配置為與 GCM 專案搭配使用，但新的專案是採用 FCM 建立的。用於識別瀏覽器的產生記號是由 Chrome 瀏覽器快取。 - -**使用者回應**：您可以透過移除 Cookie 並重設瀏覽器的許可權來解決此問題。這將要求許可權以啟用 Push Notifications。 - - -### 在此瀏覽器中不支援服務工作程式 - -**說明**：無法使用以服務工作程式包含為 `BMSPushSDK.js` 一部分的 SDK。 - -**使用者回應**：建議您切換為支援服務工作程式的瀏覽器。支援的瀏覽器版本為 Firefox 第 49 版或更新版本，以及 Chrome 第 53 版（64 位元）或更新版本。 - - -### SecurityError：作業不安全 - -**說明**：在 Firefox 中啟用 Web 主控台時，您可能會看到錯誤。在 Push Notification Service 中的 Web 推送支援需要以 `https` 通訊協定，而非 `http` 通訊協定進行網站存取。 - -**使用者回應**：建議您從瀏覽器嘗試使用 `https` 連接至網站。 - +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 疑難排解 +{: #errors} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + +請使用本節作為一般 {{site.data.keyword.mobilepushshort}} 問題的疑難排解指引。 + + +### 發生內部伺服器錯誤。請與管理者聯絡。（內部錯誤碼：PUSHD102E） + +**說明**：如果您在 2015 年 11 月之前已建立 Push 實例，則可能發生此錯誤。 + +**使用者回應**：若要解決此問題，請刪除 Push 實例然後建立一個新的。請注意，當您刪除 Push 實例時，不會保留您的標籤。 + + +### UnauthorizedRegistration + +**說明**：Chrome Web Push 無法與 Firebase Cloud Messaging (FCM) 金鑰搭配使用。如果您從 GCM 移至 FCM 之後無法在 Chrome 上接收 Web Push 通知，這是因為網站先前配置為與 GCM 專案搭配使用，但新的專案是採用 FCM 建立的。用於識別瀏覽器的產生記號是由 Chrome 瀏覽器快取。 + +**使用者回應**：您可以透過移除 Cookie 並重設瀏覽器的許可權來解決此問題。這將要求許可權以啟用 Push Notifications。 + + +### 在此瀏覽器中不支援服務工作程式 + +**說明**：無法使用以服務工作程式包含為 `BMSPushSDK.js` 一部分的 SDK。 + +**使用者回應**：建議您切換為支援服務工作程式的瀏覽器。支援的瀏覽器版本為 Firefox 第 49 版或更新版本，以及 Chrome 第 53 版（64 位元）或更新版本。 + + +### SecurityError：作業不安全 + +**說明**：在 Firefox 中啟用 Web 主控台時，您可能會看到錯誤。在 Push Notification Service 中的 Web 推送支援需要以 `https` 通訊協定，而非 `http` 通訊協定進行網站存取。 + +**使用者回應**：建議您從瀏覽器嘗試使用 `https` 連接至網站。 + diff --git a/services/mobilepush/nl/zh/TW/troubleshooting_config_errors.md b/services/mobilepush/nl/zh/TW/troubleshooting_config_errors.md index ceef41ab1..9d4d86219 100644 --- a/services/mobilepush/nl/zh/TW/troubleshooting_config_errors.md +++ b/services/mobilepush/nl/zh/TW/troubleshooting_config_errors.md @@ -1,46 +1,46 @@ ---- - -copyright: - years: 2015, 2017 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 解析 Web 推送配置錯誤 -{: #errors} -前次更新：2017 年 1 月 11 日 -{: .last-updated} - -使用本節作為指引來解析一般發生的 Web 推送配置相關錯誤。`BMSPushSDK.js` 的 Web 推送錯誤包含失敗的資訊。 - -若要剖析在回呼時傳回的錯誤，請考量下列範例程式碼： - -``` -function showStatus(response) { - if(response.statusCode == 200 || response.statusCode == 201) { - document.getElementById("status").innerHTML = "Response is " + response.response; - } - else if(response.statusCode == 0) { - if(response.response) { - document.getElementById("status").innerHTML = response.response; - } - else { - document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; - } - } - else { - document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " - + response.error + " and the status code " + response.statusCode; - } - } -``` - {: codeblock} - - -- 如果未正確配置 `applicationId`，{{site.data.keyword.mobilepushshort}} 服務的起始要求將會失敗，因此 statusCode 將設為零 (0)。 -- 狀態碼 200 或 201 表示順利回應。 -- 案例 `clientSecret` 無效，將在 statusCode 上設定 401 回應。`response.reponse` 元件將包含錯誤說明。 +--- + +copyright: + years: 2015, 2017 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 解析 Web 推送配置錯誤 +{: #errors} +前次更新：2017 年 1 月 11 日 +{: .last-updated} + +使用本節作為指引來解析一般發生的 Web 推送配置相關錯誤。`BMSPushSDK.js` 的 Web 推送錯誤包含失敗的資訊。 + +若要剖析在回呼時傳回的錯誤，請考量下列範例程式碼： + +``` +function showStatus(response) { + if(response.statusCode == 200 || response.statusCode == 201) { + document.getElementById("status").innerHTML = "Response is " + response.response; + } + else if(response.statusCode == 0) { + if(response.response) { + document.getElementById("status").innerHTML = response.response; + } + else { + document.getElementById("status").innerHTML = "There is a possible CORS or access issue while attempting the request."; + } + } + else { + document.getElementById("status").innerHTML = "Response is " + response.response + " with the error " + + response.error + " and the status code " + response.statusCode; + } + } +``` + {: codeblock} + + +- 如果未正確配置 `applicationId`，{{site.data.keyword.mobilepushshort}} 服務的起始要求將會失敗，因此 statusCode 將設為零 (0)。 +- 狀態碼 200 或 201 表示順利回應。 +- 案例 `clientSecret` 無效，將在 statusCode 上設定 401 回應。`response.reponse` 元件將包含錯誤說明。 diff --git a/services/mobilepush/t_advance_badge_sound_payload.md b/services/mobilepush/t_advance_badge_sound_payload.md index 24581378b..bf31d678c 100644 --- a/services/mobilepush/t_advance_badge_sound_payload.md +++ b/services/mobilepush/t_advance_badge_sound_payload.md @@ -10,7 +10,7 @@ copyright: {:screen:.screen} {:codeblock:.codeblock} -#Enabling advanced push notifications +# Enabling advanced push notifications Last updated: 28 February 2017 {: .last-updated} diff --git a/services/mobilepush/t_cordova_receive.md b/services/mobilepush/t_cordova_receive.md index 14450e9f5..8383ce31b 100644 --- a/services/mobilepush/t_cordova_receive.md +++ b/services/mobilepush/t_cordova_receive.md @@ -10,7 +10,7 @@ copyright: Copy and paste the following code snippets to receive push notifications on devices. -##JavaScript +## JavaScript Add the following JavaScript code snippet to the web part of your Cordova application. @@ -23,7 +23,7 @@ var notification = function(notification){ MFPPush.registerNotificationsCallback(notification); ``` -##Android notification properties +## Android notification properties The following section lists the Android notification properties: @@ -31,7 +31,7 @@ The following section lists the Android notification properties: * payload - JSON object containing a notification payload -##iOS notification properties +## iOS notification properties The following section lists the iOS notification properties: @@ -41,7 +41,7 @@ action-loc-key - The string is used as a key to get a localized string in the cu * badge - The number to display as the badge of the app icon. If this property is absent, the badge is not changed. To remove the badge, set the value of this property to 0. * sound - The name of a sound file in the app bundle or in the Library/Sounds folder of the app data container. -##Objective-C +## Objective-C Add the following Objective-C code snippets to your application delegate class. @@ -61,7 +61,7 @@ Add the following Objective-C code snippets to your application delegate class. } ``` -##Swift +## Swift Add the following Swift code snippets to your application delegate class. diff --git a/services/mobilepush/t_cordova_register.md b/services/mobilepush/t_cordova_register.md index 917929364..36a7057fa 100644 --- a/services/mobilepush/t_cordova_register.md +++ b/services/mobilepush/t_cordova_register.md @@ -45,7 +45,7 @@ If you want to customize the alert, badge, and sound properties, add the followi -##JavaScript +## JavaScript {: #cordova_register_js} ``` @@ -115,7 +115,7 @@ Add the following Objective-C code snippet to your application delegate class } ``` -##Swift +## Swift {: #cordova_register_swift} Add the following Swift code snippet to your application delegate class. @@ -129,7 +129,7 @@ funcapplication(application: UIApplication, didFailToRegisterForRemoteNotificati } ``` -##Next Steps +## Next Steps {: #cordova_register_next} 1. Build your project and then run your project by using the following commands: diff --git a/services/mobilepush/t_enable_ios_notifications_initialize.md b/services/mobilepush/t_enable_ios_notifications_initialize.md index f03b83181..580bee8e5 100755 --- a/services/mobilepush/t_enable_ios_notifications_initialize.md +++ b/services/mobilepush/t_enable_ios_notifications_initialize.md @@ -11,9 +11,9 @@ copyright: A common place to put the initialization code is in the application delegate for the iOS application. Click the **Mobile Options** link in your Bluemix Application Dashboard to get the application route and GUID. -##Initializing the Core SDK +## Initializing the Core SDK -###Objective-C +### Objective-C ``` // Initialize the SDK for Object-C with IBM Bluemix GUID and route @@ -21,7 +21,7 @@ IMFClient *imfClient = [IMFClient sharedInstance]; [imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; ``` -###Swift +### Swift ``` // Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region @@ -31,16 +31,16 @@ myBMSClient.initializeWithBluemixAppRoute("BluemixAppRoute", bluemixAppGUID: "AP myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds ``` -##Initializing the client Push SDK +## Initializing the client Push SDK -###Objective-C +### Objective-C ``` //Initialize client Push SDK for Objective-C IMFPushClient _pushService = [IMFPushClient sharedInstance]; ``` -###Swift +### Swift ``` //Initialize client Push SDK for Swift diff --git a/services/mobilepush/t_enable_ios_notifications_install.md b/services/mobilepush/t_enable_ios_notifications_install.md index 93ab294db..435911918 100755 --- a/services/mobilepush/t_enable_ios_notifications_install.md +++ b/services/mobilepush/t_enable_ios_notifications_install.md @@ -5,7 +5,7 @@ For an existing Xcode project, you can set up the Bluemix Mobile Services Client **Note**: To view the Swift Push readme file, go https://github.com/ibm-bluemix-mobile-services/bms-clientsdk-swift-push/tree/master -##Installing CocoaPods +## Installing CocoaPods 1. Install CocoaPods by using the following command in your Mac terminal. ``` @@ -50,7 +50,7 @@ That command installs your dependencies and creates a new Xcode workspace. **No ``` The workspace contains your original project and Pods project that contains your dependencies. If you would like to modify an Bluemix Mobile Services source folder, you can find it in your Pods project, under `Pods/yourImportedSourceFolder`, for example: `Pods/IMFGoogleAuthentication`. -##Using imported frameworks and source folders +## Using imported frameworks and source folders Reference the SDK in your code. @@ -67,7 +67,7 @@ Write #import directives for the relevant headers, for example: **Note**: Updating your Pods project using the CocoaPods commands `pod install` or `pod update` might override the Bluemix Mobile Services source folders. If you want to retain your customized versions of the original files, ensure that they are backed up before you issue one of these commands. -###Swift +### Swift **Pre-requisites** @@ -84,7 +84,7 @@ import BMSPush ``` -##Build Settings +## Build Settings Go to **Xcode > Build Settings > Build Options and Set Enable Bitcode** to **No**. @@ -99,9 +99,9 @@ Go to **Xcode > Build Settings > Build Options and Set Enable Bitcode** to **No* A common place to put the initialization code is in the application delegate for the iOS application. Click the **Mobile Options** link in your Bluemix Application Dashboard to get the application route and GUID. -##Initializing the Core SDK +## Initializing the Core SDK -###Objective-C +### Objective-C ``` // Initialize the SDK for Object-C with IBM Bluemix GUID and route @@ -109,7 +109,7 @@ IMFClient *imfClient = [IMFClient sharedInstance]; [imfClient initializeWithBackendRoute:"add_your_applicationRoute_here" backendGUID:"add_your_appId_here"]; ``` -###Swift +### Swift ``` // Initialize the Core SDK for Swift with IBM Bluemix GUID, route, and region @@ -120,16 +120,16 @@ myBMSClient.defaultRequestTimeout = 10.0 // Timput in seconds ``` -##Initializing the client Push SDK +## Initializing the client Push SDK -###Objective-C +### Objective-C ``` //Initialize client Push SDK for Objective-C IMFPushClient _pushService = [IMFPushClient sharedInstance]; ``` -###Swift +### Swift ``` //Initialize client Push SDK for Swift @@ -169,11 +169,11 @@ To register iOs applications and devices: 2. Pass the token to Push Notifications -##Create a backend application +## Create a backend application Create a backend application in the Boilerplates section Bluemix® catalog, which automatically binds the Push service to this application. If you already created a backend app, make sure that you bind the app to the Push Notification Service. -###Objective-C +### Objective-C ``` //For Objective-C @@ -190,7 +190,7 @@ Create a backend application in the Boilerplates section Bluemix® catalog, whic } ``` -###Swift +### Swift ``` //For Swift @@ -202,11 +202,11 @@ Create a backend application in the Boilerplates section Bluemix® catalog, whic } ``` -##Pass the token to Push Notifications +## Pass the token to Push Notifications After the token is received from APNs, pass the token to Push Notifications as part of the `registerDevice:withDeviceToken` method. -###Objective-C +### Objective-C ``` //For Objective-C @@ -228,7 +228,7 @@ IMFPushClient* push = [IMFPushClient sharedInstance]; }]; ``` -###Swift +### Swift After the token is received from APNS, pass the token to Push Notifications as part of the `didRegisterForRemoteNotificationsWithDeviceToken` method. @@ -256,7 +256,7 @@ func application (application: UIApplication, didRegisterForRemoteNotificationsW Receive push notifications on iOS devices. -##Objective-C +## Objective-C To receive push notifications on iOS devices, add the following Objective-C method to the application delegate of your application. ``` @@ -266,7 +266,7 @@ To receive push notifications on iOS devices, add the following Objective-C meth } ``` -##Swift +## Swift To receive push notifications on iOS devices, add the following Swift method to the application delegate of your application. ``` diff --git a/services/mobilepush/t_enable_ios_notifications_register.md b/services/mobilepush/t_enable_ios_notifications_register.md index 847733754..f503b0f2a 100755 --- a/services/mobilepush/t_enable_ios_notifications_register.md +++ b/services/mobilepush/t_enable_ios_notifications_register.md @@ -10,11 +10,11 @@ To register iOs applications and devices: 2. Pass the token to Push Notifications -##Create a backend application +## Create a backend application Create a backend application in the Boilerplates section Bluemix® catalog, which automatically binds the Push service to this application. If you already created a backend app, make sure that you bind the app to the Push Notification Service. -###Objective-C +### Objective-C ``` //For Objective-C @@ -31,7 +31,7 @@ Create a backend application in the Boilerplates section Bluemix® catalog, whic } ``` -###Swift +### Swift ``` //For Swift @@ -43,11 +43,11 @@ Create a backend application in the Boilerplates section Bluemix® catalog, whic } ``` -##Pass the token to Push Notifications +## Pass the token to Push Notifications After the token is received from APNs, pass the token to Push Notifications as part of the `registerDevice:withDeviceToken` method. -###Objective-C +### Objective-C ``` //For Objective-C @@ -69,7 +69,7 @@ IMFPushClient* push = [IMFPushClient sharedInstance]; }]; ``` -###Swift +### Swift After the token is received from APNS, pass the token to Push Notifications as part of the `didRegisterForRemoteNotificationsWithDeviceToken` method. diff --git a/services/mobilepush/t_push_provider_android.md b/services/mobilepush/t_push_provider_android.md index 678738a3e..189998500 100644 --- a/services/mobilepush/t_push_provider_android.md +++ b/services/mobilepush/t_push_provider_android.md @@ -17,7 +17,7 @@ Last updated: 16 January 2017 Firebase Cloud Messaging (FCM) is the gateway used to deliver push notifications to Android devices and Google Chrome. FCM is the new version of Google Cloud Messaging (GCM). To set up the {{site.data.keyword.mobilepushshort}} service on the dashboard, you need to get your FCM credentials. Ensure that you use FCM configurations for new apps. Existing apps would continue to function with GCM configurations. -##Getting Your Sender ID and API key +## Getting Your Sender ID and API key {: #android-senderid-apikey} The API key is stored securely and used by the {{site.data.keyword.mobilepushshort}} service to connect to the FCM server and the sender ID (project number) is used by the Android SDK and the JS SDK for Google Chrome and Mozilla Firefox on the client side. @@ -30,7 +30,7 @@ To setup the FCM, generate the API key and Sender ID, complete the steps: 3. In the navigation pane, click the Settings icon and select **Project settings**. 4. Choose the Cloud Messaging tab to generate a Server API Key and a Sender ID. -##Setting up {{site.data.keyword.mobilepushshort}} service for Android and Chrome Apps and Extensions +## Setting up {{site.data.keyword.mobilepushshort}} service for Android and Chrome Apps and Extensions {: #setup-push-android} **Note:** You will need your FCM/GCM API Key and Sender ID (project number). diff --git a/services/mobilepush/t_push_provider_ios.md b/services/mobilepush/t_push_provider_ios.md index deee7c9e5..c6ae09bd3 100644 --- a/services/mobilepush/t_push_provider_ios.md +++ b/services/mobilepush/t_push_provider_ios.md @@ -30,7 +30,7 @@ Obtain and configure your APNs credentials. The APNs certificates are securely m --> -##Registering an App ID +## Registering an App ID {: #create-push-credentials-apns-register} @@ -48,7 +48,7 @@ When you register an App ID, select the following options: ![Explicit ID](images/appID_bundleID.jpg) 4. Create a development and distribution APNs SSL certificate. -##Create a development and distribution APNs SSL certificate +## Create a development and distribution APNs SSL certificate {: #create-push-credentials-apns-ssl} Before you obtain an APNs certificate, you must first generate a certificate signing request (CSR) and submit it to Apple, the certificate authority (CA). The CSR contains information that identifies your company and your public and private key that you use to sign for your Apple push notifications. Then, generate the SSL certificate on the iOS Developer Portal. The certificate, along with its public and private key, is stored in Keychain Access. @@ -96,7 +96,7 @@ You must obtain separate certificates for your development and distribution envi 19. The **Key Access.app** prompts you to export your key from the **Keychain** screen. Enter your administrative password for your Mac to allow your system to export these items, and then select the **Always Allow** option. A `.p12` certificate is generated on your desktop. -##Creating a development provisioning profile +## Creating a development provisioning profile {: #create-push-credentials-dev-profile} The provisioning profile works with the App ID to determine which devices can install and run your app and which services your app can access. For each App ID, you create two provisioning profiles: one for development and the other for distribution. Xcode uses the development provisioning profile to determine which developers are allowed to build the application and which devices are allowed to be tested on the application. @@ -113,7 +113,7 @@ Create a development provisioning profile, as follows: -##Creating a store distribution provisioning profile +## Creating a store distribution provisioning profile {: #create-push-credentials-apns-distribute_profile} Use the store provisioning profile to submit your app for distribution to the App Store. @@ -121,7 +121,7 @@ Use the store provisioning profile to submit your app for distribution to the Ap 1. Go to the [Apple Developer ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://developer.apple.com){: new_window} portal, click **Member Center**, and select **Certificates, Identifiers & Profiles**. 2. Double-click the downloaded provisioning profile to install it into Xcode. -##Setting up APNs on the {{site.data.keyword.mobilepushshort}} Dashboard +## Setting up APNs on the {{site.data.keyword.mobilepushshort}} Dashboard {: #create-push-credentials-apns-dashboard} To use the {{site.data.keyword.mobilepushshort}} service to send notifications, upload the SSL certificates that are required for Apple Push Notification Service (APNs). You can also use the REST API to upload an APNs certificate. diff --git a/services/mobilepush/t_push_provider_safari.md b/services/mobilepush/t_push_provider_safari.md index b053d428c..63ff322b1 100644 --- a/services/mobilepush/t_push_provider_safari.md +++ b/services/mobilepush/t_push_provider_safari.md @@ -23,7 +23,7 @@ Chrome and Safari browsers require additional configuration for web push. You wo -##Configuring for Chrome and Firefox web push +## Configuring for Chrome and Firefox web push {: #config-chrome-firefox} 1. On the Push Dashboard panel, select **Configure**. diff --git a/services/nl/de/index.md b/services/nl/de/index.md index 8a694f53d..164953e8d 100644 --- a/services/nl/de/index.md +++ b/services/nl/de/index.md @@ -11,7 +11,7 @@ lastupdated: "2017-01-11" {:shortdesc: .shortdesc} -#Services +# Services {: #services} {{site.data.keyword.Bluemix_notm}} macht es Ihnen leicht, Services und Apps zu implementieren, zu hosten und zu skalieren. Sie können sich voll auf Ihre Anwendungslogik und den Anwendungsentwurf konzentrieren. @@ -27,7 +27,7 @@ Für {{site.data.keyword.Bluemix_notm}}-Services stehen mehrere Unterstützungss |Beta |Ein Service, der für die Produktionsumgebung noch nicht einsatzfähig ist und sich in einer Versuchsphase der Entwicklung befindet. Ein Betaservice kann den Entwicklungs- und Marketingteams dabei helfen, den Wert der Services einzuschätzen, bevor sie den Service der Allgemeinheit zur Verfügung stellen. |Probleme, die sich als Mängel in einem von IBM bereitgestellten Betaservice erweisen, werden unterstützt; jedoch ist IBM nicht verpflichtet, einen Fix zur Verfügung zu stellen. Zusätzlich wird dem Problemticket eine Prioritätsstufe von 3 oder 4 zugeordnet, soweit zutreffend. Informationen zu Prioritätsstufen von Tickets finden Sie unter [Support kontaktieren](/docs/support/index.html#contacting-bluemix-support).| {: caption="Table 1. {{site.data.keyword.Bluemix_notm}} services support information" caption-side="top"} -##Experimentelle Services +## Experimentelle Services {: #experimental_services} {{site.data.keyword.Bluemix_notm}} stellt darüber hinaus experimentelle Services bereit, die Sie testen können. Um alle verfügbaren experimentellen Services, Boilerplates und Laufzeiten anzuzeigen, melden Sie sich bei der {{site.data.keyword.Bluemix_notm}}-Konsole an, klicken Sie auf **Katalog**, blättern Sie bis zum Ende des Katalogs und klicken Sie dann auf **{{site.data.keyword.Bluemix_notm}} Experimental Services**. @@ -35,7 +35,7 @@ Für {{site.data.keyword.Bluemix_notm}}-Services stehen mehrere Unterstützungss Experimentelle Services sind möglicherweise nicht stabil und können so geändert werden, dass sie nicht mehr mit früheren Versionen kompatibel sind. Diese Services sollten nicht in Produktionsumgebungen verwendet werden. Support für experimentelle Services wird von der {{site.data.keyword.Bluemix_notm}} Developers Community bereitgestellt. Wenn ein Problem von IBM untersucht wird und sich als Mangel eines experimentellen Service herausstellt, ist IBM nicht verpflichtet, einen Fix zur Verfügung zu stellen. -##Services nach Region +## Services nach Region {: #services_region} Nicht alle Services sind in jeder {{site.data.keyword.Bluemix_notm}}-Region erhältlich. Auch dann, wenn der Service in einer Region erhältlich ist, kann er an einem anderen Standort gehostet werden. In der folgenden Tabelle sind die Services aufgeführt, die von IBM zur Verfügung gestellt werden. diff --git a/services/nl/es/index.md b/services/nl/es/index.md index 449a3b793..41fdeacff 100644 --- a/services/nl/es/index.md +++ b/services/nl/es/index.md @@ -11,7 +11,7 @@ lastupdated: "2017-01-11" {:shortdesc: .shortdesc} -#Servicios +# Servicios {: #services} {{site.data.keyword.Bluemix_notm}} le permite fácilmente implementar, alojar y escalar servicios y aplicaciones. Puede centrarse en la lógica de la aplicación y en el diseño de la aplicación. @@ -27,14 +27,14 @@ Se proporcionan varios niveles de soporte para los servicios de {{site.data.keyw |Beta |Servicio que no está listo para producción que está en una etapa de prueba de desarrollo. Un servicio beta puede ayudar a los equipos de desarrollo y marketing a evaluar el valor de los servicios antes de que el servició esté generalmente disponible. |Se da soporte a los problemas que se determinen que son un defecto de un servicio beta proporcionado por IBM, aunque IBM no está obligado a proporcionar un arreglo. Además, se asignará una incidencia de problema con una gravedad de 3 o 4 cuando proceda. Para obtener información sobre la gravedad de las incidencias, consulte [Cómo obtener soporte](/docs/support/index.html#contacting-bluemix-support).| {: caption="Table 1. {{site.data.keyword.Bluemix_notm}} información de soporte de los servicios" caption-side="top"} -##Servicios experimentales +## Servicios experimentales {: #experimental_services} {{site.data.keyword.Bluemix_notm}} también dispone de servicios experimentales que puede probar. Para ver todos los servicios experimentales, contenedores modelo y tiempos de ejecución disponibles, inicie una sesión en la consola de {{site.data.keyword.Bluemix_notm}}, pulse **Catálogo**, desplácese hasta el final del catálogo y pulse **{{site.data.keyword.Bluemix_notm}} Servicios experimentales**. Los servicios experimentales pueden no ser estables y es posible que cambien de modo que no sean compatibles con versiones anteriores. No se recomienda utilizar estos servicios en entornos de producción. El soporte para servicios experimentales se proporciona a través de la Comunidad de desarrolladores de {{site.data.keyword.Bluemix_notm}}. Si IBM investiga un problema y se determina que el problema es un defecto de servicio experimental, IBM no está obligado a proporcionar un arreglo. -##Servicios por región +## Servicios por región {: #services_region} No todos los servicios están disponibles para su adquisición en cada región de {{site.data.keyword.Bluemix_notm}}. E, incluso si el servicio está disponible para su adquisición en dicha región, el servicio puede estar alojado en una ubicación diferente. La siguiente tabla muestra los servicios proporcionados por IBM. diff --git a/services/nl/fr/index.md b/services/nl/fr/index.md index a5d63b589..091a4cf4a 100644 --- a/services/nl/fr/index.md +++ b/services/nl/fr/index.md @@ -11,7 +11,7 @@ lastupdated: "2017-01-11" {:shortdesc: .shortdesc} -#Services +# Services {: #services} {{site.data.keyword.Bluemix_notm}} simplifie l'implémentation, l'hébergement et la mise à l'échelle des services et des applications. Ainsi, @@ -31,7 +31,7 @@ gravité que vous définissez. Pour plus d'informations sur la gravité des tick |Bêta |Service qui n'est pas prêt pour la phase de production et qui se trouve au stade d'essai de développement. Un service bêta peut aider les équipes de développement et marketing à évaluer la valeur d'un service avant de le rendre généralement disponible. |Les problèmes identifiés comme défauts dans un service bêta fourni par IBM sont pris en charge, mais IBM n'est pas obligée de fournir un correctif. De plus, le ticket de problème sera associé à une gravité de 3 ou 4 si applicable. Pour des informations sur la gravité des tickets, voir [Contacter le service de support](/docs/support/index.html#contacting-bluemix-support).| {: caption="Table 1. {{site.data.keyword.Bluemix_notm}} information du service de support" caption-side="top"} -##Services expérimentaux +## Services expérimentaux {: #experimental_services} {{site.data.keyword.Bluemix_notm}} @@ -45,7 +45,7 @@ Les services expérimentaux peuvent environnements de production n'est pas recommandée. Le support des services expérimentaux est assuré par la communauté des développeurs {{site.data.keyword.Bluemix_notm}}. Si IBM examine un problème et détermine qu'il s'agit d'un défaut d'un service expérimental, elle n'est pas obligée de fournir un correctif. -##Services par région +## Services par région {: #services_region} Les services ne sont pas tous disponibles à l'achat dans toutes les régions {{site.data.keyword.Bluemix_notm}}. De plus, même si le diff --git a/services/nl/it/apis.md b/services/nl/it/apis.md index c526b316f..1af61e70a 100644 --- a/services/nl/it/apis.md +++ b/services/nl/it/apis.md @@ -1,16 +1,16 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-02" - ---- - -{:shortdesc: .shortdesc} - - -# API -{: #apis} - -Utilizza le API creando le tue proprie API personalizzate. Puoi inoltre monitorare le prestazioni e l'utilizzo. -{: shortdesc} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-02" + +--- + +{:shortdesc: .shortdesc} + + +# API +{: #apis} + +Utilizza le API creando le tue proprie API personalizzate. Puoi inoltre monitorare le prestazioni e l'utilizzo. +{: shortdesc} diff --git a/services/nl/it/application_services.md b/services/nl/it/application_services.md index f770e03f5..f1d1e98c1 100644 --- a/services/nl/it/application_services.md +++ b/services/nl/it/application_services.md @@ -1,26 +1,26 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - - -{:shortdesc: .shortdesc} - -# Servizi dell'applicazione -{: #app_services} - -Utilizza questi -servizi per aggiungere o rimuovere funzioni rapidamente mentre sviluppi -applicazioni web nel cloud. Puoi anche semplificare le attività di gestione -e organizzare i tuoi processi e le tue regole di business. -{:shortdesc} - - -Incrementa la produttività | Semplifica la gestione | Orchestra le regole aziendali e di processo ---- | --- | --- -Sviluppa applicazioni web nel cloud utilizzando un semplice e completo -IDE web e consenti una rapida composizione delle applicazioni da parte dei servizi. Aggiungi e rimuovi funzioni, compresi i servizi open source con middleware componibile, come i dati, la memorizzazione nella cache, la messaggistica, le regole, il flusso di lavoro e la geocodifica. | Riduci notevolmente e automatizza le attività di gestione e configurazione IT, in modo rapido. Risolvi in modo accurato i problemi delle applicazioni e modifica automaticamente la dimensione dei carichi di lavoro, aumentandola o riducendola, sulla base del carico o della richiesta. Trasferisci in modo incrementale le funzioni applicative sulle piattaforme installate in loco e i cloud esistenti con dei servizi congruenti. | Crea la logica aziendale separatamente dall'applicazione, abilitando una più facile modifica nella politica e nella logica aziendale e una cattura codificata delle politiche, delle prassi e dei regolamenti aziendali. Esprimi facilmente la logica aziendale con delle regole aziendali per automatizzare le decisioni con la precisione di un esperto in materia. -{: caption="Table 1. Options for using application services" caption-side="top"} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + + +{:shortdesc: .shortdesc} + +# Servizi dell'applicazione +{: #app_services} + +Utilizza questi +servizi per aggiungere o rimuovere funzioni rapidamente mentre sviluppi +applicazioni web nel cloud. Puoi anche semplificare le attività di gestione +e organizzare i tuoi processi e le tue regole di business. +{:shortdesc} + + +Incrementa la produttività | Semplifica la gestione | Orchestra le regole aziendali e di processo +--- | --- | --- +Sviluppa applicazioni web nel cloud utilizzando un semplice e completo +IDE web e consenti una rapida composizione delle applicazioni da parte dei servizi. Aggiungi e rimuovi funzioni, compresi i servizi open source con middleware componibile, come i dati, la memorizzazione nella cache, la messaggistica, le regole, il flusso di lavoro e la geocodifica. | Riduci notevolmente e automatizza le attività di gestione e configurazione IT, in modo rapido. Risolvi in modo accurato i problemi delle applicazioni e modifica automaticamente la dimensione dei carichi di lavoro, aumentandola o riducendola, sulla base del carico o della richiesta. Trasferisci in modo incrementale le funzioni applicative sulle piattaforme installate in loco e i cloud esistenti con dei servizi congruenti. | Crea la logica aziendale separatamente dall'applicazione, abilitando una più facile modifica nella politica e nella logica aziendale e una cattura codificata delle politiche, delle prassi e dei regolamenti aziendali. Esprimi facilmente la logica aziendale con delle regole aziendali per automatizzare le decisioni con la precisione di un esperto in materia. +{: caption="Table 1. Options for using application services" caption-side="top"} diff --git a/services/nl/it/businessanalytics.md b/services/nl/it/businessanalytics.md index a96f302a7..9c7ba65d5 100644 --- a/services/nl/it/businessanalytics.md +++ b/services/nl/it/businessanalytics.md @@ -1,23 +1,23 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - - -{:shortdesc: .shortdesc} - -# Business Analytics -{: #businessanalytics} - -Con questi -servizi, puoi integrare la business intelligence nelle tue applicazioni -per individuare più rapidamente e più facilmente informazioni approfondite da tutti i tipi di dati. -{:shortdesc} - - -Incorpora la business intelligence nelle applicazioni | Servizio controllato dalle API | Contenuto BI Cognos basato sul cloud ---- | --- | --- -IBM Embeddable Reporting consente agli sviluppatori di incorporare il loro contenuto IBM Cognos Business Intelligence nelle loro applicazioni {{site.data.keyword.Bluemix_notm}}, rapidamente e facilmente. | Includi rapidamente il servizio controllato dalla API REST nella tua applicazione e presenta preziose informazioni di analisi nel cloud. | Porta contenuto Business Intelligence Cognos nel cloud rendendo disponibili gli asset BI esistenti in un'applicazione {{site.data.keyword.Bluemix_notm}}. +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + + +{:shortdesc: .shortdesc} + +# Business Analytics +{: #businessanalytics} + +Con questi +servizi, puoi integrare la business intelligence nelle tue applicazioni +per individuare più rapidamente e più facilmente informazioni approfondite da tutti i tipi di dati. +{:shortdesc} + + +Incorpora la business intelligence nelle applicazioni | Servizio controllato dalle API | Contenuto BI Cognos basato sul cloud +--- | --- | --- +IBM Embeddable Reporting consente agli sviluppatori di incorporare il loro contenuto IBM Cognos Business Intelligence nelle loro applicazioni {{site.data.keyword.Bluemix_notm}}, rapidamente e facilmente. | Includi rapidamente il servizio controllato dalla API REST nella tua applicazione e presenta preziose informazioni di analisi nel cloud. | Porta contenuto Business Intelligence Cognos nel cloud rendendo disponibili gli asset BI esistenti in un'applicazione {{site.data.keyword.Bluemix_notm}}. diff --git a/services/nl/it/data_analytics.md b/services/nl/it/data_analytics.md index f62aa9f09..7bd7e2914 100644 --- a/services/nl/it/data_analytics.md +++ b/services/nl/it/data_analytics.md @@ -1,22 +1,22 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - -{:shortdesc: .shortdesc} - -# Data & Analytics -{: #data_analytics} - -Fai di più con i potenti database cloud e servizi di analisi integrati. Oltre ad esplorare i servizi, puoi -utilizzare la console Gestisci i dati per ottenere dati nei tuoi servizi, creare delle applicazioni guidate dai dati e analizzare i dati, tutto in una sola ubicazione centrale. Ti basta fare clic su [GESTISCI I DATI](https://console.ng.bluemix.net/data/services/) nel tile `Data & Analytics` sul Dashboard {{site.data.keyword.Bluemix_notm}}. -{:shortdesc} - - -Crea di più | Cresci di più | Dormi di più ----- | ---- | ---- -Concentrati sulla cosa più divertente, ossia la creazione di nuove applicazioni, senza doverti preoccupare dell'amministrazione del sistema. | Ridimensiona i tuoi dati su IBM Cloud. | Dormi sonni tranquilli mentre gli esperti IBM si occupano del corretto funzionamento dei tuoi dati 24 ore al giorno, sette giorni alla settimana. -{: caption="Table 1. Benefits of using the Work with Data console" caption-side="top"} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + +{:shortdesc: .shortdesc} + +# Data & Analytics +{: #data_analytics} + +Fai di più con i potenti database cloud e servizi di analisi integrati. Oltre ad esplorare i servizi, puoi +utilizzare la console Gestisci i dati per ottenere dati nei tuoi servizi, creare delle applicazioni guidate dai dati e analizzare i dati, tutto in una sola ubicazione centrale. Ti basta fare clic su [GESTISCI I DATI](https://console.ng.bluemix.net/data/services/) nel tile `Data & Analytics` sul Dashboard {{site.data.keyword.Bluemix_notm}}. +{:shortdesc} + + +Crea di più | Cresci di più | Dormi di più +---- | ---- | ---- +Concentrati sulla cosa più divertente, ossia la creazione di nuove applicazioni, senza doverti preoccupare dell'amministrazione del sistema. | Ridimensiona i tuoi dati su IBM Cloud. | Dormi sonni tranquilli mentre gli esperti IBM si occupano del corretto funzionamento dei tuoi dati 24 ore al giorno, sette giorni alla settimana. +{: caption="Table 1. Benefits of using the Work with Data console" caption-side="top"} diff --git a/services/nl/it/data_analytics_services.md b/services/nl/it/data_analytics_services.md index 7da14dc9c..91c23a361 100644 --- a/services/nl/it/data_analytics_services.md +++ b/services/nl/it/data_analytics_services.md @@ -1,12 +1,12 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - -{:shortdesc: .shortdesc} - -# Servizi Data & Analytics -{: #data_analytics_services} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + +{:shortdesc: .shortdesc} + +# Servizi Data & Analytics +{: #data_analytics_services} diff --git a/services/nl/it/devops.md b/services/nl/it/devops.md index 5a9aa3465..814dc1011 100644 --- a/services/nl/it/devops.md +++ b/services/nl/it/devops.md @@ -1,15 +1,15 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - -# DevOps -{: #devops} - -Accelera la distribuzione di applicazioni | Scegli come codificare | Distribuisci con fiducia ----- | ---- | ---- -Sviluppa, tieni traccia, pianifica, distribuisci monitora e ridimensiona: gli strumenti giusti, in uno solo posto. Ospita un progetto open source. Tieni un hackathon. Avvia un progetto innovativo. Sviluppa software per una causa o per quello che sarà il prossimo successo commerciale della tua azienda. Non stai scrivendo codice? Pianifica tutto, anche il meetup mensile. | Scrivi codice nel cloud—modifica facilmente qualsiasi file di testo o script nel tuo browser. L'IDE web è probabilmente tutto quello che ti serve, ma puoi anche utilizzare i tuoi strumenti. E se disponi di codice sorgente esistente in un repository Github, connettiti al tuo progetto {{site.data.keyword.Bluemix_notm}} Bluemix DevOps Services per tenere traccia delle modifiche. | Crea, scansiona, verifica, integra e assembla le applicazioni prima della distribuzione, gestisci la fornitura continua di codice di produzione a {{site.data.keyword.Bluemix_notm}},e assicurati un feedback utente rapido e metriche di qualità in ogni fase dello sviluppo. -{: caption="Table 1. Options for using DevOps" caption-side="top"} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + +# DevOps +{: #devops} + +Accelera la distribuzione di applicazioni | Scegli come codificare | Distribuisci con fiducia +---- | ---- | ---- +Sviluppa, tieni traccia, pianifica, distribuisci monitora e ridimensiona: gli strumenti giusti, in uno solo posto. Ospita un progetto open source. Tieni un hackathon. Avvia un progetto innovativo. Sviluppa software per una causa o per quello che sarà il prossimo successo commerciale della tua azienda. Non stai scrivendo codice? Pianifica tutto, anche il meetup mensile. | Scrivi codice nel cloud—modifica facilmente qualsiasi file di testo o script nel tuo browser. L'IDE web è probabilmente tutto quello che ti serve, ma puoi anche utilizzare i tuoi strumenti. E se disponi di codice sorgente esistente in un repository Github, connettiti al tuo progetto {{site.data.keyword.Bluemix_notm}} Bluemix DevOps Services per tenere traccia delle modifiche. | Crea, scansiona, verifica, integra e assembla le applicazioni prima della distribuzione, gestisci la fornitura continua di codice di produzione a {{site.data.keyword.Bluemix_notm}},e assicurati un feedback utente rapido e metriche di qualità in ogni fase dello sviluppo. +{: caption="Table 1. Options for using DevOps" caption-side="top"} diff --git a/services/nl/it/devops_services.md b/services/nl/it/devops_services.md index 72a305c84..221983f6f 100644 --- a/services/nl/it/devops_services.md +++ b/services/nl/it/devops_services.md @@ -1,12 +1,12 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - -{:shortdesc: .shortdesc} - -# Servizi DevOps -{: #devops_services} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + +{:shortdesc: .shortdesc} + +# Servizi DevOps +{: #devops_services} diff --git a/services/nl/it/experimental.md b/services/nl/it/experimental.md index 73049927a..e921000f4 100644 --- a/services/nl/it/experimental.md +++ b/services/nl/it/experimental.md @@ -1,17 +1,17 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - -# Sperimentale -{: #experimental} - -Controlla i servizi sperimentali {{site.data.keyword.Bluemix_notm}} per provare i servizi sperimentali. -{: shortdesc} - - - -**Attenzione:** i servizi sperimentali potrebbero non essere stabili e possono cambiare secondo modalità non compatibili con le versioni precedenti. L'uso di questi servizi negli ambienti di produzione è sconsigliato. +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + +# Sperimentale +{: #experimental} + +Controlla i servizi sperimentali {{site.data.keyword.Bluemix_notm}} per provare i servizi sperimentali. +{: shortdesc} + + + +**Attenzione:** i servizi sperimentali potrebbero non essere stabili e possono cambiare secondo modalità non compatibili con le versioni precedenti. L'uso di questi servizi negli ambienti di produzione è sconsigliato. diff --git a/services/nl/it/index.md b/services/nl/it/index.md index 0ff741b18..6e12156bb 100644 --- a/services/nl/it/index.md +++ b/services/nl/it/index.md @@ -11,7 +11,7 @@ lastupdated: "2017-01-11" {:shortdesc: .shortdesc} -#Servizi +# Servizi {: #services} {{site.data.keyword.Bluemix_notm}} ti consente di implementare, ospitare o ridimensionare facilmente servizi e applicazioni. Potrai così concentrarti sulla logica e @@ -35,7 +35,7 @@ renderli generalmente disponibili. |Viene fornito supporto per i problemi consid laddove applicabile, al ticket del problema verrà assegnata una severità 3 o 4. Per informazioni sulla severità del ticket, vedi [Come contattare il supporto](/docs/support/index.html#contacting-bluemix-support).| {: caption="Table 1. {{site.data.keyword.Bluemix_notm}} services support information" caption-side="top"} -##Servizi sperimentali +## Servizi sperimentali {: #experimental_services} {{site.data.keyword.Bluemix_notm}} offre anche dei servizi sperimentali che puoi provare. Per visualizzare tutti i servizi sperimentali, i contenitori tipo e i runtime disponibili, accedi alla console {{site.data.keyword.Bluemix_notm}}, fai clic su **Catalogo**, scorri fino alla parte inferiore del catalogo e fai quindi clic su **Servizi sperimentali {{site.data.keyword.Bluemix_notm}}**. @@ -44,7 +44,7 @@ I servizi sperimentali potrebbero non essere stabili e possono cambiare secondo e tale problema viene considerato come un difetto in un servizio sperimentale, IBM non è tenuto a fornire una correzione. -##Servizi per regione +## Servizi per regione {: #services_region} Non tutti i servizi sono disponibili per l'acquisto in ogni regione {{site.data.keyword.Bluemix_notm}}. E, anche se il servizio è disponibile per l'acquisto in una regione, tale servizio potrebbe essere ospitato in un luogo differente. La seguente tabella mostra i servizi forniti da IBM. diff --git a/services/nl/it/integrate.md b/services/nl/it/integrate.md index 208c20db1..5971f2a79 100644 --- a/services/nl/it/integrate.md +++ b/services/nl/it/integrate.md @@ -1,16 +1,16 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - - -{:shortdesc: .shortdesc} - -# Integra -{: #integrate} - -I servizi di integrazione ti offrono una vasta gamma di potenti servizi componibili per la connessione protetta a dati e servizi ovunque questi si trovino. Puoi connetterti in modo semplice e veloce a una serie di endpoint che puoi esporre e gestire come API da utilizzare e riutilizzare all'interno delle tue applicazioni. La combinazione di movimento e pulizia dei dati nel flusso aiuta a garantire che le tue applicazioni vedano solo ciò che è rilevante e accurato. -{: shortdesc} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + + +{:shortdesc: .shortdesc} + +# Integra +{: #integrate} + +I servizi di integrazione ti offrono una vasta gamma di potenti servizi componibili per la connessione protetta a dati e servizi ovunque questi si trovino. Puoi connetterti in modo semplice e veloce a una serie di endpoint che puoi esporre e gestire come API da utilizzare e riutilizzare all'interno delle tue applicazioni. La combinazione di movimento e pulizia dei dati nel flusso aiuta a garantire che le tue applicazioni vedano solo ciò che è rilevante e accurato. +{: shortdesc} diff --git a/services/nl/it/integration.md b/services/nl/it/integration.md index 31a82709a..7f85feae0 100644 --- a/services/nl/it/integration.md +++ b/services/nl/it/integration.md @@ -1,15 +1,15 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - -{:shortdesc: .shortdesc} - -# Integrazione -{: #integration} - -I servizi di integrazione ti offrono una vasta gamma di potenti servizi componibili per la connessione protetta a dati e servizi ovunque questi si trovino. Puoi connetterti in modo semplice e veloce a una serie di endpoint che puoi esporre e gestire come API da utilizzare e riutilizzare all'interno delle tue applicazioni. La combinazione di movimento e pulizia dei dati nel flusso aiuta a garantire che le tue applicazioni vedano solo ciò che è rilevante e accurato. -{: shortdesc} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + +{:shortdesc: .shortdesc} + +# Integrazione +{: #integration} + +I servizi di integrazione ti offrono una vasta gamma di potenti servizi componibili per la connessione protetta a dati e servizi ovunque questi si trovino. Puoi connetterti in modo semplice e veloce a una serie di endpoint che puoi esporre e gestire come API da utilizzare e riutilizzare all'interno delle tue applicazioni. La combinazione di movimento e pulizia dei dati nel flusso aiuta a garantire che le tue applicazioni vedano solo ciò che è rilevante e accurato. +{: shortdesc} diff --git a/services/nl/it/internetofthings.md b/services/nl/it/internetofthings.md index 2d1c8aa9f..4854a0510 100644 --- a/services/nl/it/internetofthings.md +++ b/services/nl/it/internetofthings.md @@ -1,15 +1,15 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - -# Internet delle cose -{: #internetofthings} - -Utilizza questi -servizi per creare ed estendere rapidamente applicazioni che -si avvalgono dei dati e delle analisi dai sensori e dai dispositivi connessi. -{: shortdesc} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + +# Internet delle cose +{: #internetofthings} + +Utilizza questi +servizi per creare ed estendere rapidamente applicazioni che +si avvalgono dei dati e delle analisi dai sensori e dai dispositivi connessi. +{: shortdesc} diff --git a/services/nl/it/mobile.md b/services/nl/it/mobile.md index 7dee8b383..1333c77fa 100644 --- a/services/nl/it/mobile.md +++ b/services/nl/it/mobile.md @@ -1,23 +1,23 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - - -{:shortdesc: .shortdesc} - -# Mobile -{: #mobile} - -Utilizza i servizi Mobile per creare applicazioni Android e iOS -multipiattaforma, native o ibride. -{:shortdesc} - - -Informazioni approfondite senza precedenti sulle esperienze degli utenti | Preserva la sicurezza delle applicazioni | Ridimensiona e sincronizza i dati ----- | ---- | ---- -Ottieni un feedback articolato e dettagliato con la riproduzione delle operazioni eseguite dall'utente. Migliora continuamente le applicazioni con le attività di analisi sulle prestazioni in tempo reale. | Identifica i problemi di sicurezza prima che lo facciano gli utenti. Gestisci l'accesso degli utenti. Assicurati che le comunicazioni con i sistemi aziendali siano protette. | Mantieni sincronizzati i dati di tutti i tuoi dispositivi e tienili offline. Non è necessario ottimizzare il database. Funziona. -{: caption="Table 1. Benefits of using mobile services" caption-side="top"} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + + +{:shortdesc: .shortdesc} + +# Mobile +{: #mobile} + +Utilizza i servizi Mobile per creare applicazioni Android e iOS +multipiattaforma, native o ibride. +{:shortdesc} + + +Informazioni approfondite senza precedenti sulle esperienze degli utenti | Preserva la sicurezza delle applicazioni | Ridimensiona e sincronizza i dati +---- | ---- | ---- +Ottieni un feedback articolato e dettagliato con la riproduzione delle operazioni eseguite dall'utente. Migliora continuamente le applicazioni con le attività di analisi sulle prestazioni in tempo reale. | Identifica i problemi di sicurezza prima che lo facciano gli utenti. Gestisci l'accesso degli utenti. Assicurati che le comunicazioni con i sistemi aziendali siano protette. | Mantieni sincronizzati i dati di tutti i tuoi dispositivi e tienili offline. Non è necessario ottimizzare il database. Funziona. +{: caption="Table 1. Benefits of using mobile services" caption-side="top"} diff --git a/services/nl/it/network.md b/services/nl/it/network.md index fec9a167c..46c1c46c0 100644 --- a/services/nl/it/network.md +++ b/services/nl/it/network.md @@ -1,15 +1,15 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - -{:shortdesc: .shortdesc} - -# Rete -{: #network} - -Con i servizi di rete, puoi creare reti nel cloud e stabilire una connessione tra le reti all'interno di {{site.data.keyword.Bluemix}} e l'infrastruttura IT installata in loco. -{: shortdesc} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + +{:shortdesc: .shortdesc} + +# Rete +{: #network} + +Con i servizi di rete, puoi creare reti nel cloud e stabilire una connessione tra le reti all'interno di {{site.data.keyword.Bluemix}} e l'infrastruttura IT installata in loco. +{: shortdesc} diff --git a/services/nl/it/reqnsi.md b/services/nl/it/reqnsi.md index 99fe96c6b..68931c798 100644 --- a/services/nl/it/reqnsi.md +++ b/services/nl/it/reqnsi.md @@ -1,463 +1,463 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-01-11" - ---- - - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - - -#Servizi -{: #services} - -I servizi disponibili sono elencati nel **catalogo** sotto **Servizi** -nell'interfaccia utente -di {{site.data.keyword.Bluemix}}. -{:shortdesc} - - -I servizi predefiniti sono disponibili in {{site.data.keyword.Bluemix_notm}} per -le applicazioni mobili. {{site.data.keyword.Bluemix_notm}} -ti consente di implementare, ospitare o ingrandire facilmente questi servizi mobili per le tue applicazioni mobili. Potrai così concentrarti sulla logica e -sulla progettazione dell'applicazione. - -{{site.data.keyword.Bluemix_notm}} ospita -e gestisce servizi middleware per le applicazioni Web. Gli sviluppatori -delle applicazioni possono specificare i servizi middleware di cui hanno bisogno. {{site.data.keyword.Bluemix_notm}} esegue quindi -automaticamente il provisioning di nuove istanze dei servizi middleware -specificati ed esegue il bind delle istanze del servizio all'applicazione. - -{{site.data.keyword.Bluemix_notm}} visualizza i servizi in due modi: per categoria del servizio e per tipo di supporto del servizio. - - - -
      -
      Categoria
      -
      I servizi {{site.data.keyword.Bluemix_notm}} -sono organizzati in diverse categorie. In ciascuna categoria del servizio, -i servizi creati da IBM vengono elencati per primi, seguiti dai servizi di terze parti e, infine, -dai servizi della community.
      -
      Supporto
      -
      Per i servizi {{site.data.keyword.Bluemix_notm}} vengono forniti più livelli di supporto. La seguente tabella descrive le informazioni di supporto generali per i servizi {{site.data.keyword.Bluemix_notm}}: - -
      -
      - - - -|Tipo |Descrizione |Dettagli sul supporto| -|:------|:--------------|:--------------| -|IBM |Un servizio fornito da IBM e che è generalmente disponibile. |Viene fornito supporto per i problemi considerati come un difetto -in un servizio fornito da IBM generalmente disponibile. Il supporto viene fornito in base alla severità da te impostata. Per ulteriori informazioni sulla severità del ticket, vedi [Come contattare il supporto](/docs/support/index.html#contacting-bluemix-support).| -|Terze parti |Un servizio fornito da un'azienda diversa da IBM. |Il supporto per i servizi di terze parti è fornito dal -fornitore del servizio. Se un problema viene analizzato da IBM e tale problema viene considerato come un difetto in un servizio di terze parti, IBM non è tenuto a fornire una correzione. IBM condividerà l'analisi con il fornitore del servizio di terze parti laddove necessario.| -|Community |Un servizio fornito da una community -open source. |Il supporto per i servizi di community viene fornito dalla Community di sviluppatori {{site.data.keyword.Bluemix_notm}}. Se un problema viene analizzato da IBM e tale problema viene considerato come un difetto in un servizio di community, IBM non è tenuto a fornire una correzione.| -|Beta |Un servizio che non è pronto per la produzione ed è a una -fase di sviluppo di prova. Un servizio beta può aiutare i team di sviluppo -e di marketing a valutare la qualità dei servizi prima di -renderli generalmente disponibili. |Viene fornito supporto per i problemi considerati come un difetto in un servizio beta fornito da IBM, tuttavia IBM non è tenuto a fornire una correzione. Inoltre, -laddove applicabile, al ticket del problema verrà assegnata una severità 3 o 4. Per informazioni sulla severità del ticket, vedi [Come contattare il supporto](/docs/support/index.html#contacting-bluemix-support).| -{: caption="Table 1. {{site.data.keyword.Bluemix_notm}} services support information" caption-side="top"} - - - - -{{site.data.keyword.Bluemix_notm}} offre anche dei servizi sperimentali che puoi provare. Per visualizzare tutti i servizi sperimentali, i contenitori tipo e i runtime disponibili, accedi a {{site.data.keyword.Bluemix_notm}}, scorri fino alla fine del Catalogo e fai clic su **Catalogo Lab {{site.data.keyword.Bluemix_notm}}**. - -I servizi sperimentali potrebbero non essere stabili e possono cambiare secondo modalità non compatibili con le versioni precedenti. L'uso di questi servizi negli ambienti di produzione è sconsigliato. Il supporto per i servizi sperimentali viene fornito tramite la Community di sviluppatori {{site.data.keyword.Bluemix_notm}}. Se un problema viene analizzato da IBM -e tale problema viene considerato come un difetto in un servizio sperimentale, -IBM non è tenuto a fornire una correzione. - -Per utilizzare un servizio nell'interfaccia utente di {{site.data.keyword.Bluemix_notm}}, nell'interfaccia riga di comando cf, in IBM {{site.data.keyword.Bluemix_notm}} DevOps Services o in qualsiasi strumento supportato, attieniti alla seguente procedura: - -1. Crea un'istanza del servizio. Nella maggior parte dei casi, -l'istanza del servizio può essere creata quando crei l'applicazione. - -2. Identifica l'applicazione che utilizza la nuova istanza del servizio. Per le applicazioni Web, puoi specificare più di un'applicazione per -utilizzare la stessa istanza del servizio, in genere per la condivisione dei dati. - -3. Scrivi il codice nella tua applicazione per consentire l'integrazione con il -servizio. - -##Servizi per regione - -Non tutti i servizi sono -disponibili in ogni regione {{site.data.keyword.Bluemix_notm}}. La seguente tabella mostra i servizi forniti da IBM. - - - -|Servizio |Disponibile nella regione Stati Uniti Sud |Disponibile nella regione Europa Regno Unito |Disponibile nella regione di Sydney in Australia| -|:----------|:------------------------------|:------------------|:------------------| -|{{site.data.keyword.activedeployshort}} |Sì |Sì |No| -|{{site.data.keyword.alchemyapishort}} |Sì |Sì |Sì| -|{{site.data.keyword.appsecshort}} |Sì |No |No| -|{{site.data.keyword.alertnotificationshort}}|Sì |No |No | -|{{site.data.keyword.APS_DA}} |Sì |No |No| -|{{site.data.keyword.APS_MA}} |Sì |No |No| -|{{site.data.keyword.amashort}} |Sì |Sì |Sì| -|{{site.data.keyword.hadoopst}} |Sì |No |No| -|{{site.data.keyword.APIM}} |Sì |Sì |No| -|{{site.data.keyword.autoscaling}} |Sì |Sì |Sì| -|{{site.data.keyword.bigicloudst}} |Sì |No |No| -|{{site.data.keyword.blockstorageshort}} |No |Sì |No | -|{{site.data.keyword.rules_short}} |Sì |Sì |No| -|{{site.data.keyword.cloudint}} |Sì |Sì |No| -|{{site.data.keyword.cloudant}} |Sì |Sì |No| -|{{site.data.keyword.conceptexpansionshort}} |Sì |Sì |Sì| -|{{site.data.keyword.conceptinsightsshort}} |Sì |Sì |Sì| -|{{site.data.keyword.dashdbshort}} |Sì |Sì |No| -|{{site.data.keyword.datacshort}} |Sì |Sì |Sì| -|{{site.data.keyword.DB2OnCloud_short}} |Sì |Sì |Sì| -|{{site.data.keyword.deliverypipeline}} |Sì |Sì |No| -|{{site.data.keyword.dialogshort}} |Sì |Sì |Sì| -|{{site.data.keyword.documentconversionshort}} |Sì |Sì |Sì| -|{{site.data.keyword.creshort}} |Sì |No |No| -|{{site.data.keyword.game}} |Sì |Sì |Sì| -|{{site.data.keyword.geospatialshort_Geospatial}} |Sì |Sì |No| -|{{site.data.keyword.globalizationshort}} |Sì |No |No| -|{{site.data.keyword.dataworks_short}} |Sì |Sì |No| -|{{site.data.keyword.twittershort}} |Sì |Sì |Sì| -|{{site.data.keyword.weather_short}} |Sì |Sì |Sì| -|{{site.data.keyword.IntegrationTestingshort}} |Sì |Sì |No| -|{{site.data.keyword.iot_short}} |Sì |No |No| -|{{site.data.keyword.keymanagementserviceshort}}|No |Sì |No| -|{{site.data.keyword.languagetranslationshort}} |Sì |Sì |No| -|{{site.data.keyword.messagehub}} |Sì |Sì |No| -|{{site.data.keyword.messageresonanceshort}} |Sì |Sì |No| -|{{site.data.keyword.APS_MAiOS}} |Sì |No |No| -|{{site.data.keyword.macm_short}} |Sì |Sì |Sì| -|{{site.data.keyword.mobilemam}} |Sì |Sì |No| -|{{site.data.keyword.mobiledata}} |Sì |Sì |No| -|{{site.data.keyword.manda}} |Sì |Sì |No| -|{{site.data.keyword.mqa}} |Sì |Sì |No| -|{{site.data.keyword.mql}} |Sì |Sì |No| -|{{site.data.keyword.nlclassifierlshort}} |Sì |Sì |Sì| -|{{site.data.keyword.objectstorageshort}} |Sì |No |No| -|{{site.data.keyword.personalityinsightsshort}} |Sì |Sì |Sì| -|{{site.data.keyword.mobilepush}} |Sì |Sì |No| -|Push for iOS 8 |Sì |Sì |No| -|{{site.data.keyword.questionandanswershort}} |Sì |Sì |Sì| -|{{site.data.keyword.rapidApps}} |Sì |Sì |No| -|{{site.data.keyword.relationshipextractionshort}} |Sì |Sì |Sì| -|{{site.data.keyword.retrieveandrankshort}} |Sì |Sì |Sì| -|{{site.data.keyword.SecureGateway}} |Sì |Sì |No| -|{{site.data.keyword.sescashort}} |Sì |Sì |Sì| -|{{site.data.keyword.ssofull}} |Sì |No |No| -|{{site.data.keyword.speechtotextshort}} |Sì |Sì |Sì| -|{{site.data.keyword.sqldb}} |Sì |Sì |No| -|{{site.data.keyword.staticanalyzershort}} |Sì |Sì |No| -|{{site.data.keyword.streaminganalyticsshort}} |Sì |No |No| -|{{site.data.keyword.texttospeechshort}} |Sì |Sì |Sì| -|{{site.data.keyword.times}} |Sì |Sì |No| -|{{site.data.keyword.toneanalyzershort}} |Sì |Sì |Sì| -|{{site.data.keyword.trackplan}} |Sì |Sì |No| -|{{site.data.keyword.tradeoffanalyticsshort}} |Sì |Sì |Sì| -|{{site.data.keyword.visualinsightsshort}} |Sì |Sì |Sì| -|{{site.data.keyword.visualizationrenderingshort}} |Sì |Sì |No| -|{{site.data.keyword.workflow}} |Sì |Sì |No| -|{{site.data.keyword.workloadscheduler}} |Sì |Sì |No| -|{{site.data.keyword.xpagesservice_short}} |Sì |Sì |No| -*Tabella 2. Disponibilità dei servizi* -{: caption="Table 2. Service availability" caption-side="top"} - - - -# Aggiunta di un servizio alla tua applicazione -{: #add_service} - - -{{site.data.keyword.Bluemix}} ha un elenco di servizi e -li gestisce per conto degli sviluppatori. Per aggiungere un servizio a -un'applicazione da utilizzare, devi richiedere un'istanza di tale servizio e configurare l'applicazione in modo -che interagisca con il servizio. - -Puoi visualizzare tutti i servizi disponibili in {{site.data.keyword.Bluemix_notm}} -nei seguenti modi: - -* Dall'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Visualizza il catalogo {{site.data.keyword.Bluemix_notm}}. -* Dall'interfaccia riga di comando cf. Utilizza il comando **cf marketplace**. -* Dalla tua applicazione. Utilizza la [API di servizi GET /v2/services ![icona link esterno](../icons/launch-glyph.svg)](http://apidocs.cloudfoundry.org/197/services/list_all_services.html){: new_window}. - -Puoi selezionare il servizio di cui hai bisogno quando sviluppi le applicazioni. Dopo la tua selezione, {{site.data.keyword.Bluemix_notm}} interagisce con il servizio ed -effettua le operazioni necessarie per eseguire il provisioning delle risorse del servizio. Il processo di provisioning può essere -differente per i diversi tipi di servizi. Ad esempio, un servizio database crea un database e un -servizio di notifiche di push per le applicazioni mobili genera le informazioni di configurazione. - -{{site.data.keyword.Bluemix_notm}} fornisce le risorse di un servizio alla tua applicazione utilizzando un'istanza del servizio. Un'istanza del servizio può essere condivisa tra le -applicazioni Web. - -Se vi sono dei servizi disponibili in altre regioni, potrai utilizzare anche tali -servizi. Questi servizi devono essere accessibili da Internet e avere degli endpoint API. Per utilizzare -questi servizi, devi codificare manualmente l'applicazione nello stesso modo in cui codifichi le applicazioni -esterne o gli strumenti di terze parti per utilizzare i servizi {{site.data.keyword.Bluemix_notm}}. Per ulteriori informazioni, vedi [Abilitazione di applicazioni esterne e strumenti di terze parti all'utilizzo di servizi {{site.data.keyword.Bluemix_notm}}](#accser_external). - - - -## Richiesta di una nuova istanza del servizio -{: #req_instance} - -Per richiedere una nuova istanza del servizio, devi utilizzare l'interfaccia utente di {{site.data.keyword.Bluemix_notm}} oppure -l'interfaccia riga di comando cf. - -**Nota:** quando specifichi il nome servizio, evita di utilizzare caratteri che non siano alfabetici o numerici; in caso contrario, i risultati potrebbero essere imprevedibili. - -Se utilizzi l'interfaccia utente di {{site.data.keyword.Bluemix_notm}} -per richiedere un'istanza del servizio, completa la seguente procedura: - -1. Nel {{site.data.keyword.Bluemix_notm}} **Catalogo**, fai clic sul tile per il servizio che vuoi aggiungere. Viene visualizzata la pagina dei dettagli. - -2. Nel riquadro Aggiungi servizio, seleziona un'applicazione di cui desideri eseguire il bind a questa istanza del servizio dall'elenco **Applicazione**. - -3. Immetti un nome nel campo **Nome servizio**. Viene fornito un nome servizio predefinito. Puoi modificare il nome nel campo o lasciarlo invariato. - -4. Completa le selezioni o i campi aggiuntivi e fai quindi clic su **CREA**. - -Se utilizzi l'interfaccia riga di comando cf per richiedere un'istanza del servizio, completa la seguente procedura: - -1. Utilizza il comando **cf marketplace** per trovare il nome e il piano del servizio di cui hai bisogno. - -2. Utilizza il seguente comando per creare un'istanza del servizio, dove nome_servizio è il nome del servizio, piano_servizio è il piano del servizio e istanza_servizio è il nome da utilizzare per questa istanza del servizio. - - ``` - cf create-service nome_servizio piano_servizio istanza_servizio - ``` - -3. Utilizza il seguente comando per eseguire il bind dell'istanza del servizio a un'applicazione, dove nome_applicazione è il nome dell'applicazione e istanza_servizio è il nome dell'istanza del servizio. - - ``` - cf bind-service nome_applicazione istanza_servizio - ``` - -Puoi eseguire il bind a un'istanza del servizio per le sole istanze dell'applicazione che si trovano nello stesso spazio od organizzazione. Tuttavia, puoi utilizzare istanze di servizio provenienti da altri spazi od organizzazioni seguendo le modalità adottate dalle applicazioni esterne. Invece di creare un bind, utilizza le credenziali per configurare direttamente l'istanza della tua applicazione. Per ulteriori informazioni sull'uso dei servizi {{site.data.keyword.Bluemix_notm}} da parte delle applicazioni esterne, vedi [Abilitazione di applicazioni esterne all'utilizzo dei servizi {{site.data.keyword.Bluemix_notm}} ](#accser_external). - - -## Configurazione della tua applicazione per l'interazione con un servizio -{: #config} - -Dopo aver eseguito il bind di un'istanza del servizio all'applicazione, devi configurare -l'applicazione in modo da interagire con il servizio. - -Ciascun servizio potrebbe richiedere un meccanismo differente per comunicare con le applicazioni. Questi -meccanismi sono documentati come parte della definizione del servizio a scopo informativo quando sviluppi le -applicazioni. Per congruenza, i meccanismi sono richiesti perché la tua applicazione interagisca con il -servizio. - -* Per interagire con i servizi del database, utilizza le informazioni fornite da {{site.data.keyword.Bluemix_notm}}, quali ID utente, password -e l'URI di accesso per l'applicazione. -* Per interagire con i servizi di back-end mobili, utilizza le informazioni fornite da {{site.data.keyword.Bluemix_notm}}, quali l'identità dell'applicazione -(ID applicazione), le informazioni di sicurezza specifiche per il client e l'URI di accesso per -l'applicazione. I servizi mobili di norma operano in contesto reciproco e, pertanto, le informazioni -di contesto, come il nome dello sviluppatore dell'applicazione e l'utente che utilizza l'applicazione, -possono essere condivise tra la serie di servizi. -* Per interagire con le applicazioni Web o il codice cloud lato server per le applicazioni mobili, utilizza le -informazioni fornite da {{site.data.keyword.Bluemix_notm}}, quali le -credenziali di runtime nella variabile di ambiente *VCAP_SERVICES* -dell'applicazione. Il valore della variabile di ambiente *VCAP_SERVICES* è la -serializzazione di un oggetto JSON. La variabile contiene i dati di runtime richiesti per interagire con i servizi -a cui è associata l'applicazione. Il formato dei dati è differente per i -diversi servizi. Potresti dover leggere la documentazione del servizio in merito a cosa aspettarsi -e come interpretare ogni elemento di informazione. - -Se si verifica un arresto anomalo di un servizio di cui esegui il bind a un'applicazione, -l'esecuzione dell'applicazione potrebbe essere arrestata oppure potrebbero verificarsi per essa delle condizioni di errore. {{site.data.keyword.Bluemix_notm}} non riavvia automaticamente l'applicazione per eseguire un ripristino da tali problemi. Valuta una codifica della tua applicazione per identificare interruzioni, eccezioni ed errori di connessione e per eseguire il ripristino da tali condizioni. Per ulteriori informazioni, consulta l'argomento di risoluzione dei problemi relativo al fatto che [le applicazioni non verranno riavviate automaticamente](/docs/troubleshoot/index.html#ts_topmenubar). - -## Abilitazione di applicazioni esterne all'utilizzo dei servizi {{site.data.keyword.Bluemix_notm}} -{: #accser_external} - -Potresti disporre di applicazioni create ed eseguite -all'esterno di {{site.data.keyword.Bluemix_notm}}, -o utilizzare strumenti di terze parti. Se i servizi {{site.data.keyword.Bluemix_notm}} forniscono chiavi del servizio accessibili da Internet, puoi utilizzare questi servizi con le tue applicazioni locali e con gli strumenti di terze parti. - -I seguenti servizi forniscono le chiavi del servizio per l'utilizzo esterno: - -* {{site.data.keyword.amashort_old}} -* {{site.data.keyword.alchemyapishort}} -* {{site.data.keyword.alertnotificationshort}} -* {{site.data.keyword.sparks}} -* {{site.data.keyword.appseccloudshort}} -* {{site.data.keyword.blockchain}} -* {{site.data.keyword.cloudant}} -* {{site.data.keyword.iotmapinsights_short}} -* {{site.data.keyword.conversationshort}} -* {{site.data.keyword.dashdbshort}} -* {{site.data.keyword.discoveryshort}} -* {{site.data.keyword.documentconversionshort}} -* {{site.data.keyword.iotdriverinsights_short}} -* {{site.data.keyword.geospatialshort_Geospatial}} -* {{site.data.keyword.GlobalizationPipeline_short}} -* {{site.data.keyword.appconserviceshort}} -* {{site.data.keyword.dataworks_short}} -* {{site.data.keyword.graphshort}} -* {{site.data.keyword.iotelectronics_full}} -* {{site.data.keyword.twittershort}} -* {{site.data.keyword.iot4auto_short}} -* {{site.data.keyword.iotinsurance_short}} -* {{site.data.keyword.languagetranslatorshort}} -* {{site.data.keyword.dwl_short}} -* {{site.data.keyword.messagehub}} -* {{site.data.keyword.mobileanalytics_short}} -* {{site.data.keyword.nlclassifiershort}} -* {{site.data.keyword.objectstorageshort}} -* {{site.data.keyword.personalityinsightsshort}} -* {{site.data.keyword.HybridConnect_short}} -* {{site.data.keyword.mobilepush}} -* {{site.data.keyword.retrieveandrankshort}} -* {{site.data.keyword.speechtotextshort}} -* {{site.data.keyword.streaminganalyticsshort}} -* {{site.data.keyword.texttospeechshort}} -* {{site.data.keyword.toneanalyzershort}} -* {{site.data.keyword.tradeoffanalyticsshort}} -* {{site.data.keyword.weather_short}} -* {{site.data.keyword.workloadscheduler}} - -Per abilitare un'applicazione esterna o uno strumento di terze parti -a utilizzare un servizio {{site.data.keyword.Bluemix_notm}}, -completa la seguente procedura: - -1. Richiedi un'istanza del servizio. - 1. Nel Dashboard nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}, fai clic su **Utilizza servizi o API**. Viene visualizzato il Catalogo. - 2. Dal Catalogo, seleziona il servizio che vuoi facendo clic sul relativo tile. Viene visualizzata la pagina dei dettagli. - 3. Nella finestra Aggiungi servizio, mantieni la selezione dell'elenco **Applicazione**: come **Lascia senza binding**. Questa selezione significa che -il servizio non sarà connesso a un'applicazione {{site.data.keyword.Bluemix_notm}}. - 4. Opera le altre selezioni come necessario. Fai quindi clic su **CREA**. Viene creata un'istanza del servizio e viene visualizzato il dashboard del servizio. -2. Nel riquadro di navigazione del dashboard del servizio, puoi selezionare **Credenziali del servizio** per visualizzare o aggiungere credenziali in formato JSON. Utilizza la chiave API visualizzata come credenziali per stabilire una -connessione all'istanza del servizio. - -La tua applicazione che viene eseguita esternamente a {{site.data.keyword.Bluemix_notm}} può -ora accedere al servizio {{site.data.keyword.Bluemix_notm}}. - -**Nota:** se vuoi eliminare delle istanze del servizio oppure controllare le informazioni di fatturazione, devi tornare indietro al Dashboard nell'interfaccia utente per gestire le istanze del servizio. - -## Creazione di un'istanza del servizio fornito dall'utente -{: #user_provide_services} - -Puoi avere delle risorse che sono gestite esternamente a {{site.data.keyword.Bluemix_notm}}. Se hai delle credenziali per accedere a queste risorse esterne da Internet, puoi creare delle istanze del servizio fornito dall'utente {{site.data.keyword.Bluemix_notm}} per rappresentare le risorse esterne e comunicare con esse. - -Per creare un'istanza del servizio fornito dall'utente ed eseguirne il bind a un'applicazione, completa la seguente procedura: - -1. Crea un'istanza del servizio fornito dall'utente utilizzando il comando **cf create-user-provided-service** oppure il comando **cf cups**: - * Per creare un'istanza del servizio fornito dall'utente generale, utilizza l'opzione **-p** e -separa i nomi parametro con delle virgole. L'interfaccia riga di comando cf ti chiede quindi ciascun -parametro, uno alla volta. Ad -esempio: - ``` - cf cups testups1 -p "host, port, dbname, username, password" - host> pubsub01.example.com - port> 1234 - dbname> sampledb01 - username> pubsubuser - password> p@$$w0rd - Creating user provided service testups1 in org my-org / space dev as user@sample.com... - OK - ``` - - * Per creare un'istanza del servizio che scarica informazioni in un software di gestione di log di terze parti, -utilizza l'opzione **-l** e specifica la destinazione fornita dal software di gestione di log di terze parti. Ad -esempio: - - ``` - cf cups testups2 -l syslog://example.com - Creating user provided service testups2 in org my-org / space dev as user@sample.com... - OK - ``` - - Se vuoi aggiornare uno o più parametri dell'istanza del servizio fornito dall'utente, utilizza il comando **cf update-user-provided-service** oppure -il comando **cf uups**. - - * Per aggiornare un'istanza del servizio fornito dall'utente, utilizza l'opzione **-p** -e specifica le chiavi e i valori di parametro in un oggetto json. Ad -esempio: - - ``` - cf uups testups1 -p "{\"username\":\"pubsubuser2\",\"password\":\"p@$$w0rd2\"}" - Updating user provided service testups1 in org my-org / space dev as user@sample.com... - OK - ``` - - * Per creare un'istanza del servizio che scarica informazioni in un software di gestione di log di terze parti, utilizza l'opzione -l. Ad -esempio: - - ``` - cf uups testups2 -l syslog://example2.com - Updating user provided service testups2 in org my-org / space dev as user@sample.com... - OK - ``` - -2. Esegui il bind dell'istanza del servizio alla tua applicazione utilizzando il comando cf bind-service. Ad -esempio: - - ``` - cf bind-service myapp testups1 - Binding service testups1 to app myapp in org my-org / space dev as user@sample.com... - OK - ``` - -Ora puoi configurare la tua applicazione per utilizzare le risorse esterne. Per informazioni su come configurare la tua applicazione per interagire con un servizio, vedi [Configurazione della tua applicazione per l'interazione con un servizio](#config){: new_window}. - -## Utilizzo dei servizi in un'altra regione -{: #cross_region_service} - -Se disponi di un'istanza di servizio creata e associata mediante bind ad applicazioni in un'unica regione, puoi utilizzare questa istanza in un'altra regione utilizzando uno dei seguenti metodi: - - * Utilizza le credenziali del servizio per configurare direttamente l'istanza della tua applicazione. Per i dettagli, vedi [Abilitazione di applicazioni esterne all'utilizzo dei servizi {{site.data.keyword.Bluemix_notm}}](#accser_external). - * Crea come ponte un servizio fornito dall'utente. - - Supponiamo di iniziare nella regione in cui -desideri utilizzare l'istanza del servizio. Per utilizzare un'istanza del servizio che si trova -in un'altra regione, completa la seguente procedura: - - 1. Passa alla regione in cui si trova l'istanza del servizio. Nella barra dei menu di {{site.data.keyword.Bluemix_notm}}, espandi **Regione** o fai clic sull'icona **Regione**, quindi seleziona la regione in cui si trova l'istanza del servizio. - - 2. Recupera le credenziali e i parametri di connessione dalla variabile di ambiente VCAP_SERVICES dell'istanza del servizio nella regione in cui si trova il servizio. Completa la seguente -procedura: - - 1. Nel Dashboard {{site.data.keyword.Bluemix_notm}}, fai clic sul tile dell'applicazione. Viene visualizzata la pagina Panoramica. - 2. Nel riquadro di navigazione, fai clic su **Variabili di ambiente**. Vengono visualizzati i dettagli della variabile di ambiente *VCAP_SERVICES*. Registra il contenuto JSON per l'istanza -del servizio. - - 3. Passa alla regione in cui desideri utilizzare l'istanza del -servizio. Nella barra dei menu di {{site.data.keyword.Bluemix_notm}}, espandi **Regione** o fai clic sull'icona **Regione**, quindi seleziona la regione in cui desideri utilizzare l'istanza del servizio. - - 4. Crea un'istanza del servizio fornito dall'utente utilizzando le credenziali -e i parametri di connessione che hai registrato dalla variabile di ambiente -*VCAP_SERVICES*. Per informazioni su come creare un'istanza -del servizio fornito dall'utente, vedi [Creazione di un'istanza -del servizio fornito dall'utente](#user_provide_services). - - 5. Esegui il bind dell'istanza del servizio fornito dall'utente alla tua applicazione -utilizzando il seguente comando: - - ``` - cf bind-service myapp user-provided_service_instance - ``` - - - - - - -## Utilizzo di servizi in un altro servizio -{: #s2s_binding} - -Autorizzazione accesso al servizio consente a un servizio di accedere a un altro servizio direttamente. Puoi autorizzare e configurare l'accesso di un'istanza del servizio ad altre istanze del servizio sul Dashboard {{site.data.keyword.Bluemix_notm}}. - -Per utilizzare un'istanza del servizio da un altro servizio, completa la seguente procedura: - -1. Nel Dashboard {{site.data.keyword.Bluemix_notm}}, fai clic sul tile per il servizio a -cui vuoi accedere. Viene visualizzato il dashboard per il servizio. -2. Nel riquadro di navigazione, fai clic su **Gestisci** per autorizzare il bind da altre istanze del servizio utilizzando la console dell'istanza del servizio. -3. Se vuoi negare ad altri servizi l'accesso all'istanza, fai clic su **Autorizzazione accesso al servizio** nel riquadro di navigazione e utilizza quindi **Revoca** per rimuovere il bind del servizio. - -# rellinks -{: #rellinks} - -## general -{: #general} - -* [Esecuzione del bind di un servizio utilizzando l'interfaccia utente {{site.data.keyword.Bluemix_notm}}](/docs/cfapps/ee.html#ee_bindui) -* [Richiamo di VCAP_SERVICES](/docs/cli/vcapsvc.html#retrieving) +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-01-11" + +--- + + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + + +#Servizi +{: #services} + +I servizi disponibili sono elencati nel **catalogo** sotto **Servizi** +nell'interfaccia utente +di {{site.data.keyword.Bluemix}}. +{:shortdesc} + + +I servizi predefiniti sono disponibili in {{site.data.keyword.Bluemix_notm}} per +le applicazioni mobili. {{site.data.keyword.Bluemix_notm}} +ti consente di implementare, ospitare o ingrandire facilmente questi servizi mobili per le tue applicazioni mobili. Potrai così concentrarti sulla logica e +sulla progettazione dell'applicazione. + +{{site.data.keyword.Bluemix_notm}} ospita +e gestisce servizi middleware per le applicazioni Web. Gli sviluppatori +delle applicazioni possono specificare i servizi middleware di cui hanno bisogno. {{site.data.keyword.Bluemix_notm}} esegue quindi +automaticamente il provisioning di nuove istanze dei servizi middleware +specificati ed esegue il bind delle istanze del servizio all'applicazione. + +{{site.data.keyword.Bluemix_notm}} visualizza i servizi in due modi: per categoria del servizio e per tipo di supporto del servizio. + + + +
      +
      Categoria
      +
      I servizi {{site.data.keyword.Bluemix_notm}} +sono organizzati in diverse categorie. In ciascuna categoria del servizio, +i servizi creati da IBM vengono elencati per primi, seguiti dai servizi di terze parti e, infine, +dai servizi della community.
      +
      Supporto
      +
      Per i servizi {{site.data.keyword.Bluemix_notm}} vengono forniti più livelli di supporto. La seguente tabella descrive le informazioni di supporto generali per i servizi {{site.data.keyword.Bluemix_notm}}: + +
      +
      + + + +|Tipo |Descrizione |Dettagli sul supporto| +|:------|:--------------|:--------------| +|IBM |Un servizio fornito da IBM e che è generalmente disponibile. |Viene fornito supporto per i problemi considerati come un difetto +in un servizio fornito da IBM generalmente disponibile. Il supporto viene fornito in base alla severità da te impostata. Per ulteriori informazioni sulla severità del ticket, vedi [Come contattare il supporto](/docs/support/index.html#contacting-bluemix-support).| +|Terze parti |Un servizio fornito da un'azienda diversa da IBM. |Il supporto per i servizi di terze parti è fornito dal +fornitore del servizio. Se un problema viene analizzato da IBM e tale problema viene considerato come un difetto in un servizio di terze parti, IBM non è tenuto a fornire una correzione. IBM condividerà l'analisi con il fornitore del servizio di terze parti laddove necessario.| +|Community |Un servizio fornito da una community +open source. |Il supporto per i servizi di community viene fornito dalla Community di sviluppatori {{site.data.keyword.Bluemix_notm}}. Se un problema viene analizzato da IBM e tale problema viene considerato come un difetto in un servizio di community, IBM non è tenuto a fornire una correzione.| +|Beta |Un servizio che non è pronto per la produzione ed è a una +fase di sviluppo di prova. Un servizio beta può aiutare i team di sviluppo +e di marketing a valutare la qualità dei servizi prima di +renderli generalmente disponibili. |Viene fornito supporto per i problemi considerati come un difetto in un servizio beta fornito da IBM, tuttavia IBM non è tenuto a fornire una correzione. Inoltre, +laddove applicabile, al ticket del problema verrà assegnata una severità 3 o 4. Per informazioni sulla severità del ticket, vedi [Come contattare il supporto](/docs/support/index.html#contacting-bluemix-support).| +{: caption="Table 1. {{site.data.keyword.Bluemix_notm}} services support information" caption-side="top"} + + + + +{{site.data.keyword.Bluemix_notm}} offre anche dei servizi sperimentali che puoi provare. Per visualizzare tutti i servizi sperimentali, i contenitori tipo e i runtime disponibili, accedi a {{site.data.keyword.Bluemix_notm}}, scorri fino alla fine del Catalogo e fai clic su **Catalogo Lab {{site.data.keyword.Bluemix_notm}}**. + +I servizi sperimentali potrebbero non essere stabili e possono cambiare secondo modalità non compatibili con le versioni precedenti. L'uso di questi servizi negli ambienti di produzione è sconsigliato. Il supporto per i servizi sperimentali viene fornito tramite la Community di sviluppatori {{site.data.keyword.Bluemix_notm}}. Se un problema viene analizzato da IBM +e tale problema viene considerato come un difetto in un servizio sperimentale, +IBM non è tenuto a fornire una correzione. + +Per utilizzare un servizio nell'interfaccia utente di {{site.data.keyword.Bluemix_notm}}, nell'interfaccia riga di comando cf, in IBM {{site.data.keyword.Bluemix_notm}} DevOps Services o in qualsiasi strumento supportato, attieniti alla seguente procedura: + +1. Crea un'istanza del servizio. Nella maggior parte dei casi, +l'istanza del servizio può essere creata quando crei l'applicazione. + +2. Identifica l'applicazione che utilizza la nuova istanza del servizio. Per le applicazioni Web, puoi specificare più di un'applicazione per +utilizzare la stessa istanza del servizio, in genere per la condivisione dei dati. + +3. Scrivi il codice nella tua applicazione per consentire l'integrazione con il +servizio. + +##Servizi per regione + +Non tutti i servizi sono +disponibili in ogni regione {{site.data.keyword.Bluemix_notm}}. La seguente tabella mostra i servizi forniti da IBM. + + + +|Servizio |Disponibile nella regione Stati Uniti Sud |Disponibile nella regione Europa Regno Unito |Disponibile nella regione di Sydney in Australia| +|:----------|:------------------------------|:------------------|:------------------| +|{{site.data.keyword.activedeployshort}} |Sì |Sì |No| +|{{site.data.keyword.alchemyapishort}} |Sì |Sì |Sì| +|{{site.data.keyword.appsecshort}} |Sì |No |No| +|{{site.data.keyword.alertnotificationshort}}|Sì |No |No | +|{{site.data.keyword.APS_DA}} |Sì |No |No| +|{{site.data.keyword.APS_MA}} |Sì |No |No| +|{{site.data.keyword.amashort}} |Sì |Sì |Sì| +|{{site.data.keyword.hadoopst}} |Sì |No |No| +|{{site.data.keyword.APIM}} |Sì |Sì |No| +|{{site.data.keyword.autoscaling}} |Sì |Sì |Sì| +|{{site.data.keyword.bigicloudst}} |Sì |No |No| +|{{site.data.keyword.blockstorageshort}} |No |Sì |No | +|{{site.data.keyword.rules_short}} |Sì |Sì |No| +|{{site.data.keyword.cloudint}} |Sì |Sì |No| +|{{site.data.keyword.cloudant}} |Sì |Sì |No| +|{{site.data.keyword.conceptexpansionshort}} |Sì |Sì |Sì| +|{{site.data.keyword.conceptinsightsshort}} |Sì |Sì |Sì| +|{{site.data.keyword.dashdbshort}} |Sì |Sì |No| +|{{site.data.keyword.datacshort}} |Sì |Sì |Sì| +|{{site.data.keyword.DB2OnCloud_short}} |Sì |Sì |Sì| +|{{site.data.keyword.deliverypipeline}} |Sì |Sì |No| +|{{site.data.keyword.dialogshort}} |Sì |Sì |Sì| +|{{site.data.keyword.documentconversionshort}} |Sì |Sì |Sì| +|{{site.data.keyword.creshort}} |Sì |No |No| +|{{site.data.keyword.game}} |Sì |Sì |Sì| +|{{site.data.keyword.geospatialshort_Geospatial}} |Sì |Sì |No| +|{{site.data.keyword.globalizationshort}} |Sì |No |No| +|{{site.data.keyword.dataworks_short}} |Sì |Sì |No| +|{{site.data.keyword.twittershort}} |Sì |Sì |Sì| +|{{site.data.keyword.weather_short}} |Sì |Sì |Sì| +|{{site.data.keyword.IntegrationTestingshort}} |Sì |Sì |No| +|{{site.data.keyword.iot_short}} |Sì |No |No| +|{{site.data.keyword.keymanagementserviceshort}}|No |Sì |No| +|{{site.data.keyword.languagetranslationshort}} |Sì |Sì |No| +|{{site.data.keyword.messagehub}} |Sì |Sì |No| +|{{site.data.keyword.messageresonanceshort}} |Sì |Sì |No| +|{{site.data.keyword.APS_MAiOS}} |Sì |No |No| +|{{site.data.keyword.macm_short}} |Sì |Sì |Sì| +|{{site.data.keyword.mobilemam}} |Sì |Sì |No| +|{{site.data.keyword.mobiledata}} |Sì |Sì |No| +|{{site.data.keyword.manda}} |Sì |Sì |No| +|{{site.data.keyword.mqa}} |Sì |Sì |No| +|{{site.data.keyword.mql}} |Sì |Sì |No| +|{{site.data.keyword.nlclassifierlshort}} |Sì |Sì |Sì| +|{{site.data.keyword.objectstorageshort}} |Sì |No |No| +|{{site.data.keyword.personalityinsightsshort}} |Sì |Sì |Sì| +|{{site.data.keyword.mobilepush}} |Sì |Sì |No| +|Push for iOS 8 |Sì |Sì |No| +|{{site.data.keyword.questionandanswershort}} |Sì |Sì |Sì| +|{{site.data.keyword.rapidApps}} |Sì |Sì |No| +|{{site.data.keyword.relationshipextractionshort}} |Sì |Sì |Sì| +|{{site.data.keyword.retrieveandrankshort}} |Sì |Sì |Sì| +|{{site.data.keyword.SecureGateway}} |Sì |Sì |No| +|{{site.data.keyword.sescashort}} |Sì |Sì |Sì| +|{{site.data.keyword.ssofull}} |Sì |No |No| +|{{site.data.keyword.speechtotextshort}} |Sì |Sì |Sì| +|{{site.data.keyword.sqldb}} |Sì |Sì |No| +|{{site.data.keyword.staticanalyzershort}} |Sì |Sì |No| +|{{site.data.keyword.streaminganalyticsshort}} |Sì |No |No| +|{{site.data.keyword.texttospeechshort}} |Sì |Sì |Sì| +|{{site.data.keyword.times}} |Sì |Sì |No| +|{{site.data.keyword.toneanalyzershort}} |Sì |Sì |Sì| +|{{site.data.keyword.trackplan}} |Sì |Sì |No| +|{{site.data.keyword.tradeoffanalyticsshort}} |Sì |Sì |Sì| +|{{site.data.keyword.visualinsightsshort}} |Sì |Sì |Sì| +|{{site.data.keyword.visualizationrenderingshort}} |Sì |Sì |No| +|{{site.data.keyword.workflow}} |Sì |Sì |No| +|{{site.data.keyword.workloadscheduler}} |Sì |Sì |No| +|{{site.data.keyword.xpagesservice_short}} |Sì |Sì |No| +*Tabella 2. Disponibilità dei servizi* +{: caption="Table 2. Service availability" caption-side="top"} + + + +# Aggiunta di un servizio alla tua applicazione +{: #add_service} + + +{{site.data.keyword.Bluemix}} ha un elenco di servizi e +li gestisce per conto degli sviluppatori. Per aggiungere un servizio a +un'applicazione da utilizzare, devi richiedere un'istanza di tale servizio e configurare l'applicazione in modo +che interagisca con il servizio. + +Puoi visualizzare tutti i servizi disponibili in {{site.data.keyword.Bluemix_notm}} +nei seguenti modi: + +* Dall'interfaccia utente {{site.data.keyword.Bluemix_notm}}. Visualizza il catalogo {{site.data.keyword.Bluemix_notm}}. +* Dall'interfaccia riga di comando cf. Utilizza il comando **cf marketplace**. +* Dalla tua applicazione. Utilizza la [API di servizi GET /v2/services ![icona link esterno](../icons/launch-glyph.svg)](http://apidocs.cloudfoundry.org/197/services/list_all_services.html){: new_window}. + +Puoi selezionare il servizio di cui hai bisogno quando sviluppi le applicazioni. Dopo la tua selezione, {{site.data.keyword.Bluemix_notm}} interagisce con il servizio ed +effettua le operazioni necessarie per eseguire il provisioning delle risorse del servizio. Il processo di provisioning può essere +differente per i diversi tipi di servizi. Ad esempio, un servizio database crea un database e un +servizio di notifiche di push per le applicazioni mobili genera le informazioni di configurazione. + +{{site.data.keyword.Bluemix_notm}} fornisce le risorse di un servizio alla tua applicazione utilizzando un'istanza del servizio. Un'istanza del servizio può essere condivisa tra le +applicazioni Web. + +Se vi sono dei servizi disponibili in altre regioni, potrai utilizzare anche tali +servizi. Questi servizi devono essere accessibili da Internet e avere degli endpoint API. Per utilizzare +questi servizi, devi codificare manualmente l'applicazione nello stesso modo in cui codifichi le applicazioni +esterne o gli strumenti di terze parti per utilizzare i servizi {{site.data.keyword.Bluemix_notm}}. Per ulteriori informazioni, vedi [Abilitazione di applicazioni esterne e strumenti di terze parti all'utilizzo di servizi {{site.data.keyword.Bluemix_notm}}](#accser_external). + + + +## Richiesta di una nuova istanza del servizio +{: #req_instance} + +Per richiedere una nuova istanza del servizio, devi utilizzare l'interfaccia utente di {{site.data.keyword.Bluemix_notm}} oppure +l'interfaccia riga di comando cf. + +**Nota:** quando specifichi il nome servizio, evita di utilizzare caratteri che non siano alfabetici o numerici; in caso contrario, i risultati potrebbero essere imprevedibili. + +Se utilizzi l'interfaccia utente di {{site.data.keyword.Bluemix_notm}} +per richiedere un'istanza del servizio, completa la seguente procedura: + +1. Nel {{site.data.keyword.Bluemix_notm}} **Catalogo**, fai clic sul tile per il servizio che vuoi aggiungere. Viene visualizzata la pagina dei dettagli. + +2. Nel riquadro Aggiungi servizio, seleziona un'applicazione di cui desideri eseguire il bind a questa istanza del servizio dall'elenco **Applicazione**. + +3. Immetti un nome nel campo **Nome servizio**. Viene fornito un nome servizio predefinito. Puoi modificare il nome nel campo o lasciarlo invariato. + +4. Completa le selezioni o i campi aggiuntivi e fai quindi clic su **CREA**. + +Se utilizzi l'interfaccia riga di comando cf per richiedere un'istanza del servizio, completa la seguente procedura: + +1. Utilizza il comando **cf marketplace** per trovare il nome e il piano del servizio di cui hai bisogno. + +2. Utilizza il seguente comando per creare un'istanza del servizio, dove nome_servizio è il nome del servizio, piano_servizio è il piano del servizio e istanza_servizio è il nome da utilizzare per questa istanza del servizio. + + ``` + cf create-service nome_servizio piano_servizio istanza_servizio + ``` + +3. Utilizza il seguente comando per eseguire il bind dell'istanza del servizio a un'applicazione, dove nome_applicazione è il nome dell'applicazione e istanza_servizio è il nome dell'istanza del servizio. + + ``` + cf bind-service nome_applicazione istanza_servizio + ``` + +Puoi eseguire il bind a un'istanza del servizio per le sole istanze dell'applicazione che si trovano nello stesso spazio od organizzazione. Tuttavia, puoi utilizzare istanze di servizio provenienti da altri spazi od organizzazioni seguendo le modalità adottate dalle applicazioni esterne. Invece di creare un bind, utilizza le credenziali per configurare direttamente l'istanza della tua applicazione. Per ulteriori informazioni sull'uso dei servizi {{site.data.keyword.Bluemix_notm}} da parte delle applicazioni esterne, vedi [Abilitazione di applicazioni esterne all'utilizzo dei servizi {{site.data.keyword.Bluemix_notm}} ](#accser_external). + + +## Configurazione della tua applicazione per l'interazione con un servizio +{: #config} + +Dopo aver eseguito il bind di un'istanza del servizio all'applicazione, devi configurare +l'applicazione in modo da interagire con il servizio. + +Ciascun servizio potrebbe richiedere un meccanismo differente per comunicare con le applicazioni. Questi +meccanismi sono documentati come parte della definizione del servizio a scopo informativo quando sviluppi le +applicazioni. Per congruenza, i meccanismi sono richiesti perché la tua applicazione interagisca con il +servizio. + +* Per interagire con i servizi del database, utilizza le informazioni fornite da {{site.data.keyword.Bluemix_notm}}, quali ID utente, password +e l'URI di accesso per l'applicazione. +* Per interagire con i servizi di back-end mobili, utilizza le informazioni fornite da {{site.data.keyword.Bluemix_notm}}, quali l'identità dell'applicazione +(ID applicazione), le informazioni di sicurezza specifiche per il client e l'URI di accesso per +l'applicazione. I servizi mobili di norma operano in contesto reciproco e, pertanto, le informazioni +di contesto, come il nome dello sviluppatore dell'applicazione e l'utente che utilizza l'applicazione, +possono essere condivise tra la serie di servizi. +* Per interagire con le applicazioni Web o il codice cloud lato server per le applicazioni mobili, utilizza le +informazioni fornite da {{site.data.keyword.Bluemix_notm}}, quali le +credenziali di runtime nella variabile di ambiente *VCAP_SERVICES* +dell'applicazione. Il valore della variabile di ambiente *VCAP_SERVICES* è la +serializzazione di un oggetto JSON. La variabile contiene i dati di runtime richiesti per interagire con i servizi +a cui è associata l'applicazione. Il formato dei dati è differente per i +diversi servizi. Potresti dover leggere la documentazione del servizio in merito a cosa aspettarsi +e come interpretare ogni elemento di informazione. + +Se si verifica un arresto anomalo di un servizio di cui esegui il bind a un'applicazione, +l'esecuzione dell'applicazione potrebbe essere arrestata oppure potrebbero verificarsi per essa delle condizioni di errore. {{site.data.keyword.Bluemix_notm}} non riavvia automaticamente l'applicazione per eseguire un ripristino da tali problemi. Valuta una codifica della tua applicazione per identificare interruzioni, eccezioni ed errori di connessione e per eseguire il ripristino da tali condizioni. Per ulteriori informazioni, consulta l'argomento di risoluzione dei problemi relativo al fatto che [le applicazioni non verranno riavviate automaticamente](/docs/troubleshoot/index.html#ts_topmenubar). + +## Abilitazione di applicazioni esterne all'utilizzo dei servizi {{site.data.keyword.Bluemix_notm}} +{: #accser_external} + +Potresti disporre di applicazioni create ed eseguite +all'esterno di {{site.data.keyword.Bluemix_notm}}, +o utilizzare strumenti di terze parti. Se i servizi {{site.data.keyword.Bluemix_notm}} forniscono chiavi del servizio accessibili da Internet, puoi utilizzare questi servizi con le tue applicazioni locali e con gli strumenti di terze parti. + +I seguenti servizi forniscono le chiavi del servizio per l'utilizzo esterno: + +* {{site.data.keyword.amashort_old}} +* {{site.data.keyword.alchemyapishort}} +* {{site.data.keyword.alertnotificationshort}} +* {{site.data.keyword.sparks}} +* {{site.data.keyword.appseccloudshort}} +* {{site.data.keyword.blockchain}} +* {{site.data.keyword.cloudant}} +* {{site.data.keyword.iotmapinsights_short}} +* {{site.data.keyword.conversationshort}} +* {{site.data.keyword.dashdbshort}} +* {{site.data.keyword.discoveryshort}} +* {{site.data.keyword.documentconversionshort}} +* {{site.data.keyword.iotdriverinsights_short}} +* {{site.data.keyword.geospatialshort_Geospatial}} +* {{site.data.keyword.GlobalizationPipeline_short}} +* {{site.data.keyword.appconserviceshort}} +* {{site.data.keyword.dataworks_short}} +* {{site.data.keyword.graphshort}} +* {{site.data.keyword.iotelectronics_full}} +* {{site.data.keyword.twittershort}} +* {{site.data.keyword.iot4auto_short}} +* {{site.data.keyword.iotinsurance_short}} +* {{site.data.keyword.languagetranslatorshort}} +* {{site.data.keyword.dwl_short}} +* {{site.data.keyword.messagehub}} +* {{site.data.keyword.mobileanalytics_short}} +* {{site.data.keyword.nlclassifiershort}} +* {{site.data.keyword.objectstorageshort}} +* {{site.data.keyword.personalityinsightsshort}} +* {{site.data.keyword.HybridConnect_short}} +* {{site.data.keyword.mobilepush}} +* {{site.data.keyword.retrieveandrankshort}} +* {{site.data.keyword.speechtotextshort}} +* {{site.data.keyword.streaminganalyticsshort}} +* {{site.data.keyword.texttospeechshort}} +* {{site.data.keyword.toneanalyzershort}} +* {{site.data.keyword.tradeoffanalyticsshort}} +* {{site.data.keyword.weather_short}} +* {{site.data.keyword.workloadscheduler}} + +Per abilitare un'applicazione esterna o uno strumento di terze parti +a utilizzare un servizio {{site.data.keyword.Bluemix_notm}}, +completa la seguente procedura: + +1. Richiedi un'istanza del servizio. + 1. Nel Dashboard nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}, fai clic su **Utilizza servizi o API**. Viene visualizzato il Catalogo. + 2. Dal Catalogo, seleziona il servizio che vuoi facendo clic sul relativo tile. Viene visualizzata la pagina dei dettagli. + 3. Nella finestra Aggiungi servizio, mantieni la selezione dell'elenco **Applicazione**: come **Lascia senza binding**. Questa selezione significa che +il servizio non sarà connesso a un'applicazione {{site.data.keyword.Bluemix_notm}}. + 4. Opera le altre selezioni come necessario. Fai quindi clic su **CREA**. Viene creata un'istanza del servizio e viene visualizzato il dashboard del servizio. +2. Nel riquadro di navigazione del dashboard del servizio, puoi selezionare **Credenziali del servizio** per visualizzare o aggiungere credenziali in formato JSON. Utilizza la chiave API visualizzata come credenziali per stabilire una +connessione all'istanza del servizio. + +La tua applicazione che viene eseguita esternamente a {{site.data.keyword.Bluemix_notm}} può +ora accedere al servizio {{site.data.keyword.Bluemix_notm}}. + +**Nota:** se vuoi eliminare delle istanze del servizio oppure controllare le informazioni di fatturazione, devi tornare indietro al Dashboard nell'interfaccia utente per gestire le istanze del servizio. + +## Creazione di un'istanza del servizio fornito dall'utente +{: #user_provide_services} + +Puoi avere delle risorse che sono gestite esternamente a {{site.data.keyword.Bluemix_notm}}. Se hai delle credenziali per accedere a queste risorse esterne da Internet, puoi creare delle istanze del servizio fornito dall'utente {{site.data.keyword.Bluemix_notm}} per rappresentare le risorse esterne e comunicare con esse. + +Per creare un'istanza del servizio fornito dall'utente ed eseguirne il bind a un'applicazione, completa la seguente procedura: + +1. Crea un'istanza del servizio fornito dall'utente utilizzando il comando **cf create-user-provided-service** oppure il comando **cf cups**: + * Per creare un'istanza del servizio fornito dall'utente generale, utilizza l'opzione **-p** e +separa i nomi parametro con delle virgole. L'interfaccia riga di comando cf ti chiede quindi ciascun +parametro, uno alla volta. Ad +esempio: + ``` + cf cups testups1 -p "host, port, dbname, username, password" + host> pubsub01.example.com + port> 1234 + dbname> sampledb01 + username> pubsubuser + password> p@$$w0rd + Creating user provided service testups1 in org my-org / space dev as user@sample.com... + OK + ``` + + * Per creare un'istanza del servizio che scarica informazioni in un software di gestione di log di terze parti, +utilizza l'opzione **-l** e specifica la destinazione fornita dal software di gestione di log di terze parti. Ad +esempio: + + ``` + cf cups testups2 -l syslog://example.com + Creating user provided service testups2 in org my-org / space dev as user@sample.com... + OK + ``` + + Se vuoi aggiornare uno o più parametri dell'istanza del servizio fornito dall'utente, utilizza il comando **cf update-user-provided-service** oppure +il comando **cf uups**. + + * Per aggiornare un'istanza del servizio fornito dall'utente, utilizza l'opzione **-p** +e specifica le chiavi e i valori di parametro in un oggetto json. Ad +esempio: + + ``` + cf uups testups1 -p "{\"username\":\"pubsubuser2\",\"password\":\"p@$$w0rd2\"}" + Updating user provided service testups1 in org my-org / space dev as user@sample.com... + OK + ``` + + * Per creare un'istanza del servizio che scarica informazioni in un software di gestione di log di terze parti, utilizza l'opzione -l. Ad +esempio: + + ``` + cf uups testups2 -l syslog://example2.com + Updating user provided service testups2 in org my-org / space dev as user@sample.com... + OK + ``` + +2. Esegui il bind dell'istanza del servizio alla tua applicazione utilizzando il comando cf bind-service. Ad +esempio: + + ``` + cf bind-service myapp testups1 + Binding service testups1 to app myapp in org my-org / space dev as user@sample.com... + OK + ``` + +Ora puoi configurare la tua applicazione per utilizzare le risorse esterne. Per informazioni su come configurare la tua applicazione per interagire con un servizio, vedi [Configurazione della tua applicazione per l'interazione con un servizio](#config){: new_window}. + +## Utilizzo dei servizi in un'altra regione +{: #cross_region_service} + +Se disponi di un'istanza di servizio creata e associata mediante bind ad applicazioni in un'unica regione, puoi utilizzare questa istanza in un'altra regione utilizzando uno dei seguenti metodi: + + * Utilizza le credenziali del servizio per configurare direttamente l'istanza della tua applicazione. Per i dettagli, vedi [Abilitazione di applicazioni esterne all'utilizzo dei servizi {{site.data.keyword.Bluemix_notm}}](#accser_external). + * Crea come ponte un servizio fornito dall'utente. + + Supponiamo di iniziare nella regione in cui +desideri utilizzare l'istanza del servizio. Per utilizzare un'istanza del servizio che si trova +in un'altra regione, completa la seguente procedura: + + 1. Passa alla regione in cui si trova l'istanza del servizio. Nella barra dei menu di {{site.data.keyword.Bluemix_notm}}, espandi **Regione** o fai clic sull'icona **Regione**, quindi seleziona la regione in cui si trova l'istanza del servizio. + + 2. Recupera le credenziali e i parametri di connessione dalla variabile di ambiente VCAP_SERVICES dell'istanza del servizio nella regione in cui si trova il servizio. Completa la seguente +procedura: + + 1. Nel Dashboard {{site.data.keyword.Bluemix_notm}}, fai clic sul tile dell'applicazione. Viene visualizzata la pagina Panoramica. + 2. Nel riquadro di navigazione, fai clic su **Variabili di ambiente**. Vengono visualizzati i dettagli della variabile di ambiente *VCAP_SERVICES*. Registra il contenuto JSON per l'istanza +del servizio. + + 3. Passa alla regione in cui desideri utilizzare l'istanza del +servizio. Nella barra dei menu di {{site.data.keyword.Bluemix_notm}}, espandi **Regione** o fai clic sull'icona **Regione**, quindi seleziona la regione in cui desideri utilizzare l'istanza del servizio. + + 4. Crea un'istanza del servizio fornito dall'utente utilizzando le credenziali +e i parametri di connessione che hai registrato dalla variabile di ambiente +*VCAP_SERVICES*. Per informazioni su come creare un'istanza +del servizio fornito dall'utente, vedi [Creazione di un'istanza +del servizio fornito dall'utente](#user_provide_services). + + 5. Esegui il bind dell'istanza del servizio fornito dall'utente alla tua applicazione +utilizzando il seguente comando: + + ``` + cf bind-service myapp user-provided_service_instance + ``` + + + + + + +## Utilizzo di servizi in un altro servizio +{: #s2s_binding} + +Autorizzazione accesso al servizio consente a un servizio di accedere a un altro servizio direttamente. Puoi autorizzare e configurare l'accesso di un'istanza del servizio ad altre istanze del servizio sul Dashboard {{site.data.keyword.Bluemix_notm}}. + +Per utilizzare un'istanza del servizio da un altro servizio, completa la seguente procedura: + +1. Nel Dashboard {{site.data.keyword.Bluemix_notm}}, fai clic sul tile per il servizio a +cui vuoi accedere. Viene visualizzato il dashboard per il servizio. +2. Nel riquadro di navigazione, fai clic su **Gestisci** per autorizzare il bind da altre istanze del servizio utilizzando la console dell'istanza del servizio. +3. Se vuoi negare ad altri servizi l'accesso all'istanza, fai clic su **Autorizzazione accesso al servizio** nel riquadro di navigazione e utilizza quindi **Revoca** per rimuovere il bind del servizio. + +# rellinks +{: #rellinks} + +## general +{: #general} + +* [Esecuzione del bind di un servizio utilizzando l'interfaccia utente {{site.data.keyword.Bluemix_notm}}](/docs/cfapps/ee.html#ee_bindui) +* [Richiamo di VCAP_SERVICES](/docs/cli/vcapsvc.html#retrieving) diff --git a/services/nl/it/security.md b/services/nl/it/security.md index 3e63e816f..58ba964ce 100644 --- a/services/nl/it/security.md +++ b/services/nl/it/security.md @@ -1,27 +1,27 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - - -{:shortdesc: .shortdesc} - - -# Sicurezza -{: #security} - -Con questi -servizi di sicurezza, puoi proteggere l'accesso alle applicazioni e ai -carichi di lavoro ed eseguire la scansione delle applicazioni per rilevare -eventuali vulnerabilità. Puoi anche integrare i controlli di sicurezza nei -servizi di gestione dati e Big Data. -{:shortdesc} - - -Proteggi l'accesso alle applicazioni e ai carichi di lavoro | Scansiona le applicazioni per rilevare eventuali vulnerabilità | Proteggi i dati ----- | ---- | ---- -Aggiungi facilmente le funzionalità di autenticazione utente e SSO (single sign-on) nelle applicazioni web e mobili in esecuzione su Bluemix. Le interfacce di autenticazione basate sulle politiche consentono la rapida creazione di un'autenticazione multifattore. | Valuta le applicazioni web e mobili per rilevare eventuali vulnerabilità, rafforzando sia gli sforzi di conformità alle normative sia quelli miranti alla sicurezza. Eseguendo la scansione delle applicazioni prima della distribuzione, puoi identificare problemi, generare report e apportare le correzioni consigliate. | Utilizza i controlli di sicurezza e di riservatezza integrati nei servizi di gestione dati e Big Data, compresi il controllo, il rilevamento e il mascheramento dei dati. -{: caption="Table 1. Benefits of using security services" caption-side="top"} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + + +{:shortdesc: .shortdesc} + + +# Sicurezza +{: #security} + +Con questi +servizi di sicurezza, puoi proteggere l'accesso alle applicazioni e ai +carichi di lavoro ed eseguire la scansione delle applicazioni per rilevare +eventuali vulnerabilità. Puoi anche integrare i controlli di sicurezza nei +servizi di gestione dati e Big Data. +{:shortdesc} + + +Proteggi l'accesso alle applicazioni e ai carichi di lavoro | Scansiona le applicazioni per rilevare eventuali vulnerabilità | Proteggi i dati +---- | ---- | ---- +Aggiungi facilmente le funzionalità di autenticazione utente e SSO (single sign-on) nelle applicazioni web e mobili in esecuzione su Bluemix. Le interfacce di autenticazione basate sulle politiche consentono la rapida creazione di un'autenticazione multifattore. | Valuta le applicazioni web e mobili per rilevare eventuali vulnerabilità, rafforzando sia gli sforzi di conformità alle normative sia quelli miranti alla sicurezza. Eseguendo la scansione delle applicazioni prima della distribuzione, puoi identificare problemi, generare report e apportare le correzioni consigliate. | Utilizza i controlli di sicurezza e di riservatezza integrati nei servizi di gestione dati e Big Data, compresi il controllo, il rilevamento e il mascheramento dei dati. +{: caption="Table 1. Benefits of using security services" caption-side="top"} diff --git a/services/nl/it/storage.md b/services/nl/it/storage.md index cdc090d16..ede5d13a9 100644 --- a/services/nl/it/storage.md +++ b/services/nl/it/storage.md @@ -1,16 +1,16 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - - -{:shortdesc: .shortdesc} - -# Archiviazione -{: #storage} - -Con questi servizi di archiviazione, ottieni l'accesso a un'archiviazione di dati nel cloud affidabile ed efficace sotto il profilo dei costi. -{: shortdesc} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + + +{:shortdesc: .shortdesc} + +# Archiviazione +{: #storage} + +Con questi servizi di archiviazione, ottieni l'accesso a un'archiviazione di dati nel cloud affidabile ed efficace sotto il profilo dei costi. +{: shortdesc} diff --git a/services/nl/it/watson.md b/services/nl/it/watson.md index 0f6a1657f..f831a9108 100644 --- a/services/nl/it/watson.md +++ b/services/nl/it/watson.md @@ -1,19 +1,19 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-10-31" - ---- - -{:shortdesc: .shortdesc} - -# Watson -{: #watson} - -I servizi cognitivi offrono informazioni in maniera adattabile, interattiva e contestuale. Invece di limitarsi a fornire risposte pronte, questi servizi rispondono secondo quello che ritengono essere corretto, affidandosi alle informazioni acquisite nel tempo. -{:shortdesc} - - - - +--- + +copyright: + years: 2016 +lastupdated: "2016-10-31" + +--- + +{:shortdesc: .shortdesc} + +# Watson +{: #watson} + +I servizi cognitivi offrono informazioni in maniera adattabile, interattiva e contestuale. Invece di limitarsi a fornire risposte pronte, questi servizi rispondono secondo quello che ritengono essere corretto, affidandosi alle informazioni acquisite nel tempo. +{:shortdesc} + + + + diff --git a/services/nl/it/webapplication.md b/services/nl/it/webapplication.md index 853380614..349d5244d 100644 --- a/services/nl/it/webapplication.md +++ b/services/nl/it/webapplication.md @@ -1,26 +1,26 @@ ---- - -copyright: - years: 2016 -lastupdated: "2016-11-03" - ---- - - -{:shortdesc: .shortdesc} - -# Web e applicazione -{: #webapplication} - -Utilizza questi -servizi per aggiungere o rimuovere funzioni rapidamente mentre sviluppi -applicazioni web nel cloud. Puoi anche semplificare le attività di gestione -e organizzare i tuoi processi e le tue regole di business. -{:shortdesc} - - -Incrementa la produttività | Semplifica la gestione | Orchestra le regole aziendali e di processo ---- | --- | --- -Sviluppa applicazioni web nel cloud utilizzando un semplice e completo -IDE web e consenti una rapida composizione delle applicazioni da parte dei servizi. Aggiungi e rimuovi funzioni, compresi i servizi open source con middleware componibile, come i dati, la memorizzazione nella cache, la messaggistica, le regole, il flusso di lavoro e la geocodifica. | Riduci notevolmente e automatizza le attività di gestione e configurazione IT, in modo rapido. Risolvi in modo accurato i problemi delle applicazioni e modifica automaticamente la dimensione dei carichi di lavoro, aumentandola o riducendola, sulla base del carico o della richiesta. Trasferisci in modo incrementale le funzioni applicative sulle piattaforme installate in loco e i cloud esistenti con dei servizi congruenti. | Crea la logica aziendale separatamente dall'applicazione, abilitando una più facile modifica nella politica e nella logica aziendale e una cattura codificata delle politiche, delle prassi e dei regolamenti aziendali. Esprimi facilmente la logica aziendale con delle regole aziendali per automatizzare le decisioni con la precisione di un esperto in materia. -{: caption="Table 1. Options for using web app services" caption-side="top"} +--- + +copyright: + years: 2016 +lastupdated: "2016-11-03" + +--- + + +{:shortdesc: .shortdesc} + +# Web e applicazione +{: #webapplication} + +Utilizza questi +servizi per aggiungere o rimuovere funzioni rapidamente mentre sviluppi +applicazioni web nel cloud. Puoi anche semplificare le attività di gestione +e organizzare i tuoi processi e le tue regole di business. +{:shortdesc} + + +Incrementa la produttività | Semplifica la gestione | Orchestra le regole aziendali e di processo +--- | --- | --- +Sviluppa applicazioni web nel cloud utilizzando un semplice e completo +IDE web e consenti una rapida composizione delle applicazioni da parte dei servizi. Aggiungi e rimuovi funzioni, compresi i servizi open source con middleware componibile, come i dati, la memorizzazione nella cache, la messaggistica, le regole, il flusso di lavoro e la geocodifica. | Riduci notevolmente e automatizza le attività di gestione e configurazione IT, in modo rapido. Risolvi in modo accurato i problemi delle applicazioni e modifica automaticamente la dimensione dei carichi di lavoro, aumentandola o riducendola, sulla base del carico o della richiesta. Trasferisci in modo incrementale le funzioni applicative sulle piattaforme installate in loco e i cloud esistenti con dei servizi congruenti. | Crea la logica aziendale separatamente dall'applicazione, abilitando una più facile modifica nella politica e nella logica aziendale e una cattura codificata delle politiche, delle prassi e dei regolamenti aziendali. Esprimi facilmente la logica aziendale con delle regole aziendali per automatizzare le decisioni con la precisione di un esperto in materia. +{: caption="Table 1. Options for using web app services" caption-side="top"} diff --git a/services/nl/ja/reqnsi.md b/services/nl/ja/reqnsi.md index 2ecef5940..6dd3cef93 100644 --- a/services/nl/ja/reqnsi.md +++ b/services/nl/ja/reqnsi.md @@ -11,7 +11,7 @@ lastupdated: "2017-01-11" {:shortdesc: .shortdesc} -#サービス +# サービス {: #services} {{site.data.keyword.Bluemix}} ユーザー・インターフェースの**「サービス」**の下の**「カタログ」**で、使用可能なサービスを見つけることができます。 @@ -56,7 +56,7 @@ lastupdated: "2017-01-11" 3. サービスとの対話のためのコードをアプリケーション内に作成します。 -##地域別のサービス +## 地域別のサービス 各 {{site.data.keyword.Bluemix_notm}} 地域ですべてのサービスが利用できるわけではありません。 以下の表は、IBM が提供するサービスを示しています。 diff --git a/services/nl/ko/index.md b/services/nl/ko/index.md index 92763324a..0e9690621 100644 --- a/services/nl/ko/index.md +++ b/services/nl/ko/index.md @@ -11,7 +11,7 @@ lastupdated: "2017-01-11" {:shortdesc: .shortdesc} -#서비스 +# 서비스 {: #services} {{site.data.keyword.Bluemix_notm}}에서는 서비스 및 앱을 손쉽게 구현, 호스팅 및 스케일링할 수 있습니다. 애플리케이션 로직 및 애플리케이션 디자인에 집중할 수 있습니다. @@ -27,14 +27,14 @@ lastupdated: "2017-01-11" |베타 |프로덕션에 사용할 준비가 되지 않았으며 개발의 시험 단계에 있는 서비스입니다. 베타 서비스는 개발 및 마케팅 팀이 서비스를 GA(Generally Available)하기 전에 서비스의 가치를 평가하는 데 도움이 됩니다. |IBM에서 제공한 베타 서비스의 결함으로 판별된 문제점은 지원되지만, IBM이 수정사항을 제공할 의무는 없습니다. 또한 문제점 티켓에 심각도 3 또는 4가 지정됩니다(해당하는 경우). 티켓 심각도에 대한 정보는 [지원 문의](/docs/support/index.html#contacting-bluemix-support)를 참조하십시오.| {: caption="표 1. {{site.data.keyword.Bluemix_notm}} 서비스 지원 정보" caption-side="top"} -##시범 서비스 +## 시범 서비스 {: #experimental_services} {{site.data.keyword.Bluemix_notm}}에 사용해 볼 수 있는 시범 서비스도 포함되어 있습니다. 사용 가능한 모든 시범 서비스, 표준 유형 및 런타임을 보려면, {{site.data.keyword.Bluemix_notm}} 콘솔에 로그인하고 **카탈로그**를 클릭하고 카탈로그의 맨 아래로 스크롤한 후에 **{{site.data.keyword.Bluemix_notm}} 시범 서비스**를 클릭하십시오. 시범 서비스는 안정적이지 않을 수 있으며 이전 버전과 호환 가능하지 않은 방식으로 변경될 수 있습니다. 프로덕션 환경에서는 이러한 서비스를 사용하지 않는 것이 좋습니다. 시범 서비스에 대한 지원은 {{site.data.keyword.Bluemix_notm}} 개발자 커뮤니티를 통해 제공됩니다. IBM에서 문제점을 조사한 결과 시범 서비스의 결함으로 판별될 경우 IBM이 수정사항을 제공할 의무는 없습니다. -##지역별 서비스 +## 지역별 서비스 {: #services_region} 모든 {{site.data.keyword.Bluemix_notm}} 지역에서 모든 서비스를 구매할 수 있는 것은 아닙니다. 해당 지역에서 서비스를 구매할 수 있는 경우에도 서비스는 다른 위치에서 호스팅될 수 있습니다. 다음 표는 IBM에서 제공하는 서비스를 보여줍니다. diff --git a/services/nl/ko/reqnsi.md b/services/nl/ko/reqnsi.md index b1a9ab588..b65c848bb 100644 --- a/services/nl/ko/reqnsi.md +++ b/services/nl/ko/reqnsi.md @@ -11,7 +11,7 @@ lastupdated: "2017-01-11" {:shortdesc: .shortdesc} -#서비스 +# 서비스 {: #services} {{site.data.keyword.Bluemix}} 사용자 인터페이스의 **서비스** 아래에 있는 **카탈로그**에서 사용 가능한 서비스를 확인할 수 있습니다. @@ -60,7 +60,7 @@ lastupdated: "2017-01-11" 3. 서비스와 상호작용하도록 애플리케이션에 고유한 코드를 작성하십시오. -##지역별 서비스 +## 지역별 서비스 모든 {{site.data.keyword.Bluemix_notm}} 지역에서 모든 서비스를 사용할 수 있는 것은 아닙니다. 다음 표는 IBM에서 제공하는 서비스를 보여줍니다. diff --git a/services/nl/pt/BR/reqnsi.md b/services/nl/pt/BR/reqnsi.md index c3caf0833..6c44a15b1 100644 --- a/services/nl/pt/BR/reqnsi.md +++ b/services/nl/pt/BR/reqnsi.md @@ -11,7 +11,7 @@ lastupdated: "2017-01-11" {:shortdesc: .shortdesc} -#Serviços +# Serviços {: #services} É possível localizar serviços disponíveis no **Catálogo** em **Serviços** na interface com o usuário do {{site.data.keyword.Bluemix}}. @@ -84,7 +84,7 @@ para usar a mesma instância de serviço, geralmente para compartilhamento de da 3. Escreva seu próprio código no aplicativo para interagir com o serviço. -##Serviços por região +## Serviços por região Nem todos os serviços estão disponíveis em toda região do {{site.data.keyword.Bluemix_notm}}. A tabela a seguir mostra os serviços que são fornecidos pela IBM. diff --git a/services/nl/zh/CN/reqnsi.md b/services/nl/zh/CN/reqnsi.md index c71d0969d..3eedd22af 100644 --- a/services/nl/zh/CN/reqnsi.md +++ b/services/nl/zh/CN/reqnsi.md @@ -11,7 +11,7 @@ lastupdated: "2017-01-11" {:shortdesc: .shortdesc} -#服务 +# 服务 {: #services} 在 {{site.data.keyword.Bluemix}} 用户界面中，可以在**目录**的**服务**下找到可用的服务。 @@ -55,7 +55,7 @@ lastupdated: "2017-01-11" 3. 在应用程序中编写自己的代码用于与服务进行交互。 -##按区域列出的服务 +## 按区域列出的服务 不是所有的服务都可以在每个 {{site.data.keyword.Bluemix_notm}} 区域中使用。下表显示 IBM 提供的服务。 diff --git a/services/nl/zh/TW/reqnsi.md b/services/nl/zh/TW/reqnsi.md index 219658e31..647742fa5 100644 --- a/services/nl/zh/TW/reqnsi.md +++ b/services/nl/zh/TW/reqnsi.md @@ -11,7 +11,7 @@ lastupdated: "2017-01-11" {:shortdesc: .shortdesc} -#服務 +# 服務 {: #services} 您可以在 {{site.data.keyword.Bluemix}} 使用者介面的**型錄**中，在**服務**下找到可用的服務。 @@ -58,7 +58,7 @@ lastupdated: "2017-01-11" 3. 在應用程式中撰寫自己的程式碼，以便與服務互動。 -##各地區的服務 +## 各地區的服務 並非所有服務都能在每個 {{site.data.keyword.Bluemix_notm}} 地區使用。下表顯示 IBM 所提供的服務。 diff --git a/services/product-insights/nl/de/index.md b/services/product-insights/nl/de/index.md index cee59c31e..8b32fb11c 100644 --- a/services/product-insights/nl/de/index.md +++ b/services/product-insights/nl/de/index.md @@ -1,50 +1,50 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# Einführung in {{site.data.keyword.product-insights_short}} -{: #product-insights} - -{{site.data.keyword.product-insights_full}} stellt eine Verbindung zu lokalen IBM Softwareprodukten her, um so einen produktübergreifenden Bestand einzurichten und Einblicke in und Informationen zu den Produktnutzungsmetriken bereitzustellen. - -{:shortdesc} - -Der Service {{site.data.keyword.product-insights_short}} wird innerhalb von IBM Bluemix ausgeführt; er empfängt Informationen aus den aktivierten lokalen IBM Softwareprodukten. Diese Informationen werden dann im Dashboard der Serviceinstanz angezeigt. Um den Service nutzen zu können, benötigen Sie ein Bluemix-Konto; außerdem müssen Sie den Service in einer Organisation und einem Bereich einrichten. Die Produkt- und Nutzungsinformationen für Ihre aktivierten lokalen Produkte werden im Gültigkeitsbereich bzw. im Kontext dieses eindeutigen Service sicher gespeichert und angezeigt. - -Tipp: Zur Vereinfachung können Sie anfänglich eine einzelne Serviceinstanz verwenden. - -Führen Sie zur Einführung in {{site.data.keyword.product-insights_short}} die folgenden Schritte aus: - -1. Klicken Sie auf der Registerkarte **Verwalten** auf die Schaltfläche zum Registrieren eines Produkts, um eine Liste der unterstützten Produkte sowie den erforderlichen Versionsstand anzuzeigen. Zu jedem Produkttyp werden Anweisungen bereitgestellt, sodass Sie eine Verbindung zwischen Ihren lokalen Produktinstanzen und dem Service {{site.data.keyword.product-insights_short}} herstellen können. Falls dies erforderlich sein sollte, aktualisieren Sie Ihre aktivierten lokalen IBM Softwareprodukte auf den vorausgesetzten Mindestversionsstand. Für ein Produkt, für das ein unterstützter Mindestversionsstand erforderlich ist, müssen Sie das Fixpack oder den vorläufigen Fix installieren, um die Integration mit {{site.data.keyword.product-insights_short}} zu ermöglichen. -2. Stellen Sie eine Verbindung zwischen Ihren aktivierten lokalen IBM Softwareprodukten und Ihrem {{site.data.keyword.product-insights_short}}-Service her. Für den Konfigurationsprozess der einzelnen Produkte benötigen Sie die Serviceberechtigungsnachweise (d. h. den API-Schlüssel sowie den API-Host). Sie finden die Serviceberechtigungsnachweise auf der Registerkarte **Serviceberechtigungsnachweise** Ihres Service-Dashboards. -3. Nach der Aktivierung der einzelnen Produktinstanzen und nach dem Herstellen einer Verbindung zu diesen ist möglicherweise ein Start oder Neustart der Produkte oder Produktinstanzen erforderlich, damit diese dem Service {{site.data.keyword.product-insights_short}} die Produkt- und Nutzungsinformationen bereitstellen können. - -Details zu den Aktivierungsprodukten, dem für jedes Produkt erforderlichen Mindestversionsstand sowie zur Vorgehensweise beim Aktivieren der einzelnen Produkte zur Integration mit {{site.data.keyword.product-insights_short}} finden Sie bei der [technischen Community](https://developer.ibm.com/product-insights/) zu {{site.data.keyword.product-insights_full}}. - -Sie können Ihren Bestand anzeigen, indem Sie die Option **Verwalten** im Service-Dashboard auswählen. - -* Im Service-Dashboard werden die Namen der Produkte, zu denen eine Verbindung hergestellt wurde, im Fenster **Produkte** aufgeführt. -* Wählen Sie die Option **Alle anzeigen** aus, um alle Produktinstanzen anzuzeigen. Um die Produktinstanzen für ein Produkt anzuzeigen, wählen Sie das Produkt im Fenster **Produkte** aus; sie werden dann im Fenster **Instanzen** angezeigt. -* Wählen Sie zum Anzeigen der Details einer einzelnen Produktinstanz diese Produktinstanz im Fenster **Instanzen** aus. Das Fenster **Details** wird dann mit diesen Angaben gefüllt. Im Fenster **Details** werden Details der Produktinstanz sowie die Nutzungsinformationen angezeigt, die von der Instanz gesendet wurden. -* Auf der Registerkarte **Nutzung** werden Informationen zur Produktnutzung im grafischen Format angezeigt. In Abhängigkeit von dem Produkt können Sie den Typ von Informationen, die Sie anzeigen möchten, sowie den Stichprobenzeitraum angeben. -* Auf der Registerkarte **Details** werden die Produktinstanzinformationen angezeigt; dazu gehören auch die Produktinformationen, die Umgebungsinformationen sowie die Komponenteninformationen. -* Auf der Registerkarte **Services** der Registerkarte **Advisor** werden Details zu zusätzlichen Services bereitgestellt, die in Bezug auf die aktuelle Produktinstanz von Nutzen sein können. Auf der Registerkarte mit den Aktualisierungen werden Informationen zum Versionsstand der Produktinstanz sowie zu dessen Aktualität angegeben. - - - - - - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# Einführung in {{site.data.keyword.product-insights_short}} +{: #product-insights} + +{{site.data.keyword.product-insights_full}} stellt eine Verbindung zu lokalen IBM Softwareprodukten her, um so einen produktübergreifenden Bestand einzurichten und Einblicke in und Informationen zu den Produktnutzungsmetriken bereitzustellen. + +{:shortdesc} + +Der Service {{site.data.keyword.product-insights_short}} wird innerhalb von IBM Bluemix ausgeführt; er empfängt Informationen aus den aktivierten lokalen IBM Softwareprodukten. Diese Informationen werden dann im Dashboard der Serviceinstanz angezeigt. Um den Service nutzen zu können, benötigen Sie ein Bluemix-Konto; außerdem müssen Sie den Service in einer Organisation und einem Bereich einrichten. Die Produkt- und Nutzungsinformationen für Ihre aktivierten lokalen Produkte werden im Gültigkeitsbereich bzw. im Kontext dieses eindeutigen Service sicher gespeichert und angezeigt. + +Tipp: Zur Vereinfachung können Sie anfänglich eine einzelne Serviceinstanz verwenden. + +Führen Sie zur Einführung in {{site.data.keyword.product-insights_short}} die folgenden Schritte aus: + +1. Klicken Sie auf der Registerkarte **Verwalten** auf die Schaltfläche zum Registrieren eines Produkts, um eine Liste der unterstützten Produkte sowie den erforderlichen Versionsstand anzuzeigen. Zu jedem Produkttyp werden Anweisungen bereitgestellt, sodass Sie eine Verbindung zwischen Ihren lokalen Produktinstanzen und dem Service {{site.data.keyword.product-insights_short}} herstellen können. Falls dies erforderlich sein sollte, aktualisieren Sie Ihre aktivierten lokalen IBM Softwareprodukte auf den vorausgesetzten Mindestversionsstand. Für ein Produkt, für das ein unterstützter Mindestversionsstand erforderlich ist, müssen Sie das Fixpack oder den vorläufigen Fix installieren, um die Integration mit {{site.data.keyword.product-insights_short}} zu ermöglichen. +2. Stellen Sie eine Verbindung zwischen Ihren aktivierten lokalen IBM Softwareprodukten und Ihrem {{site.data.keyword.product-insights_short}}-Service her. Für den Konfigurationsprozess der einzelnen Produkte benötigen Sie die Serviceberechtigungsnachweise (d. h. den API-Schlüssel sowie den API-Host). Sie finden die Serviceberechtigungsnachweise auf der Registerkarte **Serviceberechtigungsnachweise** Ihres Service-Dashboards. +3. Nach der Aktivierung der einzelnen Produktinstanzen und nach dem Herstellen einer Verbindung zu diesen ist möglicherweise ein Start oder Neustart der Produkte oder Produktinstanzen erforderlich, damit diese dem Service {{site.data.keyword.product-insights_short}} die Produkt- und Nutzungsinformationen bereitstellen können. + +Details zu den Aktivierungsprodukten, dem für jedes Produkt erforderlichen Mindestversionsstand sowie zur Vorgehensweise beim Aktivieren der einzelnen Produkte zur Integration mit {{site.data.keyword.product-insights_short}} finden Sie bei der [technischen Community](https://developer.ibm.com/product-insights/) zu {{site.data.keyword.product-insights_full}}. + +Sie können Ihren Bestand anzeigen, indem Sie die Option **Verwalten** im Service-Dashboard auswählen. + +* Im Service-Dashboard werden die Namen der Produkte, zu denen eine Verbindung hergestellt wurde, im Fenster **Produkte** aufgeführt. +* Wählen Sie die Option **Alle anzeigen** aus, um alle Produktinstanzen anzuzeigen. Um die Produktinstanzen für ein Produkt anzuzeigen, wählen Sie das Produkt im Fenster **Produkte** aus; sie werden dann im Fenster **Instanzen** angezeigt. +* Wählen Sie zum Anzeigen der Details einer einzelnen Produktinstanz diese Produktinstanz im Fenster **Instanzen** aus. Das Fenster **Details** wird dann mit diesen Angaben gefüllt. Im Fenster **Details** werden Details der Produktinstanz sowie die Nutzungsinformationen angezeigt, die von der Instanz gesendet wurden. +* Auf der Registerkarte **Nutzung** werden Informationen zur Produktnutzung im grafischen Format angezeigt. In Abhängigkeit von dem Produkt können Sie den Typ von Informationen, die Sie anzeigen möchten, sowie den Stichprobenzeitraum angeben. +* Auf der Registerkarte **Details** werden die Produktinstanzinformationen angezeigt; dazu gehören auch die Produktinformationen, die Umgebungsinformationen sowie die Komponenteninformationen. +* Auf der Registerkarte **Services** der Registerkarte **Advisor** werden Details zu zusätzlichen Services bereitgestellt, die in Bezug auf die aktuelle Produktinstanz von Nutzen sein können. Auf der Registerkarte mit den Aktualisierungen werden Informationen zum Versionsstand der Produktinstanz sowie zu dessen Aktualität angegeben. + + + + + + + + + + diff --git a/services/product-insights/nl/de/product-insights_overview.md b/services/product-insights/nl/de/product-insights_overview.md index cb8713773..a58f7d82c 100644 --- a/services/product-insights/nl/de/product-insights_overview.md +++ b/services/product-insights/nl/de/product-insights_overview.md @@ -1,145 +1,145 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" - ---- - - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# Informationen zu IBM {{site.data.keyword.product-insights_short}} -{: #about_product-insights} - -Bei {{site.data.keyword.product-insights_full}} handelt es sich um einen IBM Bluemix-Service, der Teil von IBM Connect to Cloud ist. Er stellt eine Verbindung zwischen Ihren lokalen IBM Softwareprodukten und Ihrem {{site.data.keyword.product-insights_short}}-Service her und stellt Einblicke in und Informationen zu Ihrem aktiven Bestand sowie zu Ihren Laufzeitnutzungsmetriken bereit. - -{:shortdesc} - -Der Service {{site.data.keyword.product-insights_short}} ist ein Einstiegspunkt; in Zukunft werden voraussichtlich weitere Funktionen folgen. - -{{site.data.keyword.product-insights_short}} stellt die folgenden Features bereit: - -* Registrierung Ihrer lokalen IBM Softwareprodukte bei IBM, insbesondere bei einem Bluemix-Service. -* Datenerfassung für verbundene lokale Produkte und zugeordnete Nutzungsdaten. -* Dashboard für Laufzeitnutzungsdaten für die Bereitstellung echter Einblicke in und Informationen zu Ihrer Produktnutzung und Ihrem Workload. - - -Führen Sie zur Nutzung der {{site.data.keyword.product-insights_full}}-Funktionen die folgenden Schritte aus: - -1. Erstellen Sie mindestens einen Service in Bluemix for {{site.data.keyword.product-insights_short}}. -1. Führen Sie für Ihre lokalen IBM Softwareprodukte ein Upgrade auf die erforderlichen Release-Level durch und fügen Sie für jede Produktinstallation den Aktivierungscode hinzu. -1. Konfigurieren Sie die Softwareinstallation mit den {{site.data.keyword.bluemix_short}}-Berechtigungsnachweisen für Ihre {{site.data.keyword.product-insights_short}}-Serviceinstanz. Ihre gesamten Daten werden mit diesen Berechtigungsnachweisen sicher gespeichert. Die Daten stehen nur Einzelpersonen mit den richtigen Berechtigungen für den Service zur Verfügung. - - - -## Funktionsweise -{: #product-insights_howitworks} -Der Service {{site.data.keyword.product-insights_full}} wird mit Ihren lokalen IBM Softwareprodukten integriert, um Laufzeitproduktinformationen und Nutzungsmetriken zu erfassen und anzuzeigen. Anfänglich wird ein Subset von IBM Softwareprodukten zur Integration mit diesem Service aktiviert. Sind die lokalen Softwareprodukte registriert und verbunden, senden sie in regelmäßigen Abständen Startup- und Nutzungsinformationen. Die Informationen werden in Relation zu dieser Serviceinstanz über die konfigurierten Berechtigungsnachweise gespeichert. Mithilfe des Serviceinstanzdashboards können Sie die Informationen innerhalb von Bluemix anzeigen. - -Die {{site.data.keyword.product-insights_short}}-Lösung beinhaltet mehrere Komponenten; dies ist in der folgenden Grafik zu sehen: - -![{{site.data.keyword.product-insights_full}}-Architektur](images/architecture_product-insights.png "{{site.data.keyword.product-insights_full}}-Architektur"). - - -## Organisationen und Bereiche -{: #product-insights_orgs} -Ihr {{site.data.keyword.product-insights_full}}-Service ist einer einzigen Bluemix-Organisation und einem einzigen Bluemix-Bereich zugeordnet und weist eindeutige Berechtigungsnachweise auf. Sie müssen mindestens eine Bluemix-Organisation und einen Bluemix-Bereich einrichten. Wenn Sie die Daten separieren möchten, um beispielsweise den Zugriff auf bestimmte Einzelpersonen zu begrenzen, können Sie mehrere Bereiche in einer Organisation mit einer einzigen Serviceinstanz pro Bereich erstellen. Jede Serviceinstanz weist eindeutige Berechtigungsnachweise auf, die Sie für Ihre IBM Softwareprodukte angeben müssen. - -Informationen für die Produkte, die mit einer Reihe von Berechtigungsnachweisen konfiguriert sind, sind nur innerhalb des Service mit diesen Berechtigungsnachweisen sichtbar. Zur Trennung der Daten können mehrere Services erstellt werden, falls dies erforderlich sein sollte; dabei wird jeder Service mit eindeutigen Berechtigungsnachweisen erstellt. - - -## Service-Dashboard -{: #service_dashboard} -Nach der Erstellung Ihrer Serviceinstanz werden Sie an das Service-Dashboard weitergeleitet. Sie können immer zum Service-Dashboard zurückkehren; klicken Sie hierfür in Ihrem Organisationsdashboard auf das Servicesymbol. Über das Service-Dashboard haben Sie Zugriff auf Folgendes: - -* Dokumentation zur Einführung -* Serviceberechtigungsnachweise, die für die Herstellung einer Verbindung zu Ihren lokalen Produkten erforderlich sind -* Einen Bestand unterstützter Produkte sowie sämtlicher Laufzeitinstanzen, die für die {{site.data.keyword.product-insights_short}}-Serviceinstanz registriert sind -* Nutzungsinformationen für verbundene Laufzeitinstanzen -* Produkt- und Umgebungsinformationen für verbundene Laufzeitinstanzen - -Wenn auf der Registerkarte 'Verwalten' keine Produkte aufgeführt sind, klicken Sie auf die Option zum Registrieren eines Produkts, um eine Liste der unterstützten Produkte anzuzeigen und um auf bestimmte Details zur Herstellung einer Verbindung zu Produktinstanzen zuzugreifen. -![Service-Dashboard ohne registrierte Produkte](images/NoRegisteredProducts.jpg "Service-Dashboard ohne registrierte Produkte") - -## Ein Produkt registrieren -{: #product-insights_register} -Klicken Sie auf der Registerkarte **Verwalten** auf die Schaltfläche zum Registrieren eines Produkts, um eine Liste der unterstützten Produkte anzuzeigen. Blättern Sie zu Ihrem Produkt oder verwenden Sie das Suchfeld, um die Liste der Produkte zu filtern. -![Gefilterte Liste der unterstützten Produkte mit Suchbegriff](images/products-filtered.png "Gefilterte Liste der Produkte, die für die Registrierung verfügbar sind") - -Um Anweisungen zur Registrierung einer Instanz eines Produkts anzuzeigen, müssen Sie es in der Liste auswählen. - -Wenn Sie eine Verbindung zwischen einer Produktinstanz und dem Service {{site.data.keyword.product-insights_short}} herstellen, wird dieser auf der Registerkarte **Verwalten** des Dashboards angezeigt. In einem Dashboard können mehrere verbundene Produktinstanzen für unterschiedliche Produkte aufgeführt werden. - -## Produktbestand -{: #product-insights_products} -Nach der Aktivierung der Produktinstanzen zum Senden von Daten an {{site.data.keyword.product-insights_short}} können Sie Ihren Bestand anzeigen, indem Sie die Option **Verwalten** im Service-Dashboard auswählen. - -![Service-Dashboard mit Produkten und Produktinstanzen](images/productinstances.png "Service-Dashboard mit Produkten und Produktinstanzen") - -Bei {{site.data.keyword.product-insights_short}} unterscheidet sich ein Produkt von einer Produktinstanz. Ein Produkt hat einen Produktnamen, z. B. IBM MQ oder IBM WebSphere Application Server Liberty Network Deployment. Eine Produktinstanz ist die Darstellung eines Produkts nach dessen Installation und Aktivierung. Für einige Produkt gibt es mehrere Instanzen, die von ein und derselben Installation des Produkts ausgeführt werden. Beispiel: WebSphere Application Server Liberty Network Deployment kann mehrere Anwendungsserver ausführen, die aus einer einzigen Installation des Produkts erstellt werden. - -Im Service-Dashboard werden die Namen der registrierten Produkte im Fenster **Produkte** unter *Alle anzeigen* aufgeführt. Verbundene Instanzen werden im Fenster **Instanzen** aufgeführt. In diesem Fenster sind Instanzen des Produkts enthalten, die im Fenster **Produkte** ausgewählt werden. Im folgenden Beispiel werden alle Produktinstanzen angezeigt, da die Option *Alle anzeigen* im Fenster 'Produkte' ausgewählt ist. In diesem Beispiel werden sechs Produkte angezeigt; einige von ihnen weisen mehrere verbundene Instanzen auf. Sie können die Liste der Instanzen mithilfe des Felds **Instanzen durchsuchen** filtern oder einen Produkteintrag auswählen. Wenn Sie Details zu einer Produktinstanz anzeigen möchten, wählen Sie den entsprechenden Eintrag im Fenster **Instanzen** aus. - -Die Liste der Produktinstanzen, die angezeigt werden, wird beim Durchblättern gefiltert. Als Navigationshilfe wird der Suchpfad zu einer ausgewählten Instanz angezeigt. - -![Service-Dashboard](images/products.png "Service-Dashboard") - - - -## Informationen zur Produktinstanz -{: #product-insights_productinstances} -Ist eine Produktinstanz ausgewählt, wird das Fenster **Instanzdetails** gefüllt. In dem Fenster werden Nutzungsdaten, Produktdetails sowie Empfehlungen für die Produktinstanz auf der Registerkarte **Advisor** angezeigt. - - -## Nutzungsinformationen -{: #product-insights_usage} -Die Nutzungsinformationen werden auf der Registerkarte **Nutzung** angezeigt. Mithilfe der beiden Dropdown-Listen können Sie die Metrik für die Anzeige (sofern die Produktinstanz mehr als eine Metrik sendet) sowie den anzuzeigenden Zeitraum auswählen. - -Sendet die Produktinstanz mehr als eine Metrik, verwenden Sie die erste Dropdown-Liste, um die Metrik für die Anzeige auszuwählen. Wählen Sie den Zeitraum für die Anzeige in der zweiten Dropdown-Liste aus. Die Optionen für den Zeitraum für die Abschnitte sind folgende: Letzte 24 Stunden, 1 Woche, 1 Monat, 6 Monate, 1 Jahr. - -Im ersten Abschnitt sind das durchschnittliche Maximum, der Durchschnitt, das durchschnittliche Minimum sowie die Gesamtsumme der Metrikwerte über den ausgewählten Zeitraum zu sehen. Im zweiten Abschnitt ist ein Diagramm der Werte innerhalb des Zeitraums mit dem X-Achsenzeitraum zu sehen; dieser verändert sich in Abhängigkeit von dem ausgewählten Zeitraum. Beispiel: 'Letzte 24 Stunden' zeigt Diagrammpunkte für jede Stunde an, während '1 Woche' Diagrammpunkte für jeden Tag innerhalb dieser Woche anzeigt. Im letzten Abschnitt werden Maximum, Durchschnitt und Minimum für den ausgewählten Diagrammpunkt angezeigt. Um die Werte für einen weiteren Punkt im Diagramm anzuzeigen, müssen Sie die Zeitleiste an eine neue Position ziehen. - -Wenn für diesen Zeitraum keine Daten verfügbar sind, wird eine Nachricht angezeigt. So stellt eine gestoppte Instanz beispielsweise keine Daten bereit; folglich werden für den Zeitraum, in dem sie gestoppt war, keine Daten angezeigt. Für weitere Zeiträume gibt es möglicherweise Nutzungsdaten, die angezeigt werden können. Ändern Sie den Zeitraum in der Dropdown-Liste, um weitere Zeiträume anzuzeigen. - -Auf der Registerkarte **Details** werden die Produktinstanzinformationen angezeigt; dazu können die folgenden Positionen gehören: - -* Produktname und -version -* Position, an der das Produkt installiert ist, einschließlich des Hostnamens und des Verzeichnisses -* Letzter Zeitpunkt, zu dem die Instanz Startup-Informationen gesendet hat -* Instanz-ID, falls das Produkt mehrere Instanzen innerhalb eines einzigen Verzeichnisses haben kann - -![Details zur Produktinstanz](images/instancedetail.png "Details zur Produktinstanz") - -Die Produktinstanz stellt außerdem die folgenden optionalen Informationen bereit: - -* Eine Liste der installierten APARs. -* Angaben zum Betriebssystem und der Betriebssystemversion, die sich auf der Registerkarte **Umgebung** befinden. -![Details zur Produktinstanz - Registerkarte 'Umgebung'](images/instancedetails-env.png "Details zur Produktinstanz - Registerkarte 'Umgebung'") -* Komponenten oder installierte Features, die auf der Registerkarte **Komponenten** zu sehen sind. In dem Beispiel wird die Registerkarte **Komponenten** nicht angezeigt, da die Instanz von IBM Product XYZ keine weiteren Komponenteninformationen bereitstellt. -![Details zur Produktinstanz - Registerkarte 'Komponente'](images/instancedetails-comps.png "Details zur Produktinstanz - Registerkarte 'Komponente'") -* Die eindeutige ID für die Produktinstanz; diese ist eine Kombination aus Hostname, Verzeichnis und Instanz-ID. - - - - -## Suche -{: #product-insights_search} -Das Fenster **Produktinstanz** stellt eine Basissuchfunktion zum Filtern der Produktliste bereit. Geben Sie im Suchfeld die Zeichenfolge für die Suche ein. Die Suche kann nur für Produktinstanzdaten durchgeführt werden (d. h. für die Angaben auf der Registerkarte **Details**). - - - - - -## Hilfe für {{site.data.keyword.product-insights_short}} anfordern -{: #gettinghelp} - -Ausführliche Informationen zur Erstellung eines Service, zum Abrufen der Aktualisierungen für die aktivierten IBM Softwareprodukte sowie die erforderlichen Installations- und Konfigurationsschritte finden Sie bei der [technischen Community von {{site.data.keyword.product-insights_full}}](https://developer.ibm.com/product-insights/). Bei Problemen bei der oder Fragen zu der Verwendung von {{site.data.keyword.product-insights_short}} können Sie Fragen im Forenabschnitt der Community einsehen oder posten. Diese Fragen werden vom Entwickler- und Kundenprogrammteam bearbeitet. - -Zum Einsehen oder Posten von Fragen können Sie auch das Stack Overflow- und das IBM DeveloperWorks dw Answers-Forum nutzen. Für Fragen zum Service sowie zu den Anweisungen zur Einführung nutzen Sie IBM developerWorks dW Answers. Wenn Sie in einem der beiden Foren eine Frage posten, wenden Sie die folgenden Tagging-Regeln an, damit die Bluemix-Entwicklerteams Ihre Frage unmittelbar identifizieren können. - -* Für Posts an [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window} klicken, Frage mit "ibm-bluemix" und "productinsights" taggen. -* Für Posts an [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window} klicken, Fragen mit "productinsights" oder "hybridconnect" taggen. - -Weitere Informationen zur Nutzung der Foren finden Sie im Thema [Hilfe anfordern](https://www.{DomainName}/docs/support/index.html#getting-help). +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" + +--- + + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# Informationen zu IBM {{site.data.keyword.product-insights_short}} +{: #about_product-insights} + +Bei {{site.data.keyword.product-insights_full}} handelt es sich um einen IBM Bluemix-Service, der Teil von IBM Connect to Cloud ist. Er stellt eine Verbindung zwischen Ihren lokalen IBM Softwareprodukten und Ihrem {{site.data.keyword.product-insights_short}}-Service her und stellt Einblicke in und Informationen zu Ihrem aktiven Bestand sowie zu Ihren Laufzeitnutzungsmetriken bereit. + +{:shortdesc} + +Der Service {{site.data.keyword.product-insights_short}} ist ein Einstiegspunkt; in Zukunft werden voraussichtlich weitere Funktionen folgen. + +{{site.data.keyword.product-insights_short}} stellt die folgenden Features bereit: + +* Registrierung Ihrer lokalen IBM Softwareprodukte bei IBM, insbesondere bei einem Bluemix-Service. +* Datenerfassung für verbundene lokale Produkte und zugeordnete Nutzungsdaten. +* Dashboard für Laufzeitnutzungsdaten für die Bereitstellung echter Einblicke in und Informationen zu Ihrer Produktnutzung und Ihrem Workload. + + +Führen Sie zur Nutzung der {{site.data.keyword.product-insights_full}}-Funktionen die folgenden Schritte aus: + +1. Erstellen Sie mindestens einen Service in Bluemix for {{site.data.keyword.product-insights_short}}. +1. Führen Sie für Ihre lokalen IBM Softwareprodukte ein Upgrade auf die erforderlichen Release-Level durch und fügen Sie für jede Produktinstallation den Aktivierungscode hinzu. +1. Konfigurieren Sie die Softwareinstallation mit den {{site.data.keyword.bluemix_short}}-Berechtigungsnachweisen für Ihre {{site.data.keyword.product-insights_short}}-Serviceinstanz. Ihre gesamten Daten werden mit diesen Berechtigungsnachweisen sicher gespeichert. Die Daten stehen nur Einzelpersonen mit den richtigen Berechtigungen für den Service zur Verfügung. + + + +## Funktionsweise +{: #product-insights_howitworks} +Der Service {{site.data.keyword.product-insights_full}} wird mit Ihren lokalen IBM Softwareprodukten integriert, um Laufzeitproduktinformationen und Nutzungsmetriken zu erfassen und anzuzeigen. Anfänglich wird ein Subset von IBM Softwareprodukten zur Integration mit diesem Service aktiviert. Sind die lokalen Softwareprodukte registriert und verbunden, senden sie in regelmäßigen Abständen Startup- und Nutzungsinformationen. Die Informationen werden in Relation zu dieser Serviceinstanz über die konfigurierten Berechtigungsnachweise gespeichert. Mithilfe des Serviceinstanzdashboards können Sie die Informationen innerhalb von Bluemix anzeigen. + +Die {{site.data.keyword.product-insights_short}}-Lösung beinhaltet mehrere Komponenten; dies ist in der folgenden Grafik zu sehen: + +![{{site.data.keyword.product-insights_full}}-Architektur](images/architecture_product-insights.png "{{site.data.keyword.product-insights_full}}-Architektur"). + + +## Organisationen und Bereiche +{: #product-insights_orgs} +Ihr {{site.data.keyword.product-insights_full}}-Service ist einer einzigen Bluemix-Organisation und einem einzigen Bluemix-Bereich zugeordnet und weist eindeutige Berechtigungsnachweise auf. Sie müssen mindestens eine Bluemix-Organisation und einen Bluemix-Bereich einrichten. Wenn Sie die Daten separieren möchten, um beispielsweise den Zugriff auf bestimmte Einzelpersonen zu begrenzen, können Sie mehrere Bereiche in einer Organisation mit einer einzigen Serviceinstanz pro Bereich erstellen. Jede Serviceinstanz weist eindeutige Berechtigungsnachweise auf, die Sie für Ihre IBM Softwareprodukte angeben müssen. + +Informationen für die Produkte, die mit einer Reihe von Berechtigungsnachweisen konfiguriert sind, sind nur innerhalb des Service mit diesen Berechtigungsnachweisen sichtbar. Zur Trennung der Daten können mehrere Services erstellt werden, falls dies erforderlich sein sollte; dabei wird jeder Service mit eindeutigen Berechtigungsnachweisen erstellt. + + +## Service-Dashboard +{: #service_dashboard} +Nach der Erstellung Ihrer Serviceinstanz werden Sie an das Service-Dashboard weitergeleitet. Sie können immer zum Service-Dashboard zurückkehren; klicken Sie hierfür in Ihrem Organisationsdashboard auf das Servicesymbol. Über das Service-Dashboard haben Sie Zugriff auf Folgendes: + +* Dokumentation zur Einführung +* Serviceberechtigungsnachweise, die für die Herstellung einer Verbindung zu Ihren lokalen Produkten erforderlich sind +* Einen Bestand unterstützter Produkte sowie sämtlicher Laufzeitinstanzen, die für die {{site.data.keyword.product-insights_short}}-Serviceinstanz registriert sind +* Nutzungsinformationen für verbundene Laufzeitinstanzen +* Produkt- und Umgebungsinformationen für verbundene Laufzeitinstanzen + +Wenn auf der Registerkarte 'Verwalten' keine Produkte aufgeführt sind, klicken Sie auf die Option zum Registrieren eines Produkts, um eine Liste der unterstützten Produkte anzuzeigen und um auf bestimmte Details zur Herstellung einer Verbindung zu Produktinstanzen zuzugreifen. +![Service-Dashboard ohne registrierte Produkte](images/NoRegisteredProducts.jpg "Service-Dashboard ohne registrierte Produkte") + +## Ein Produkt registrieren +{: #product-insights_register} +Klicken Sie auf der Registerkarte **Verwalten** auf die Schaltfläche zum Registrieren eines Produkts, um eine Liste der unterstützten Produkte anzuzeigen. Blättern Sie zu Ihrem Produkt oder verwenden Sie das Suchfeld, um die Liste der Produkte zu filtern. +![Gefilterte Liste der unterstützten Produkte mit Suchbegriff](images/products-filtered.png "Gefilterte Liste der Produkte, die für die Registrierung verfügbar sind") + +Um Anweisungen zur Registrierung einer Instanz eines Produkts anzuzeigen, müssen Sie es in der Liste auswählen. + +Wenn Sie eine Verbindung zwischen einer Produktinstanz und dem Service {{site.data.keyword.product-insights_short}} herstellen, wird dieser auf der Registerkarte **Verwalten** des Dashboards angezeigt. In einem Dashboard können mehrere verbundene Produktinstanzen für unterschiedliche Produkte aufgeführt werden. + +## Produktbestand +{: #product-insights_products} +Nach der Aktivierung der Produktinstanzen zum Senden von Daten an {{site.data.keyword.product-insights_short}} können Sie Ihren Bestand anzeigen, indem Sie die Option **Verwalten** im Service-Dashboard auswählen. + +![Service-Dashboard mit Produkten und Produktinstanzen](images/productinstances.png "Service-Dashboard mit Produkten und Produktinstanzen") + +Bei {{site.data.keyword.product-insights_short}} unterscheidet sich ein Produkt von einer Produktinstanz. Ein Produkt hat einen Produktnamen, z. B. IBM MQ oder IBM WebSphere Application Server Liberty Network Deployment. Eine Produktinstanz ist die Darstellung eines Produkts nach dessen Installation und Aktivierung. Für einige Produkt gibt es mehrere Instanzen, die von ein und derselben Installation des Produkts ausgeführt werden. Beispiel: WebSphere Application Server Liberty Network Deployment kann mehrere Anwendungsserver ausführen, die aus einer einzigen Installation des Produkts erstellt werden. + +Im Service-Dashboard werden die Namen der registrierten Produkte im Fenster **Produkte** unter *Alle anzeigen* aufgeführt. Verbundene Instanzen werden im Fenster **Instanzen** aufgeführt. In diesem Fenster sind Instanzen des Produkts enthalten, die im Fenster **Produkte** ausgewählt werden. Im folgenden Beispiel werden alle Produktinstanzen angezeigt, da die Option *Alle anzeigen* im Fenster 'Produkte' ausgewählt ist. In diesem Beispiel werden sechs Produkte angezeigt; einige von ihnen weisen mehrere verbundene Instanzen auf. Sie können die Liste der Instanzen mithilfe des Felds **Instanzen durchsuchen** filtern oder einen Produkteintrag auswählen. Wenn Sie Details zu einer Produktinstanz anzeigen möchten, wählen Sie den entsprechenden Eintrag im Fenster **Instanzen** aus. + +Die Liste der Produktinstanzen, die angezeigt werden, wird beim Durchblättern gefiltert. Als Navigationshilfe wird der Suchpfad zu einer ausgewählten Instanz angezeigt. + +![Service-Dashboard](images/products.png "Service-Dashboard") + + + +## Informationen zur Produktinstanz +{: #product-insights_productinstances} +Ist eine Produktinstanz ausgewählt, wird das Fenster **Instanzdetails** gefüllt. In dem Fenster werden Nutzungsdaten, Produktdetails sowie Empfehlungen für die Produktinstanz auf der Registerkarte **Advisor** angezeigt. + + +## Nutzungsinformationen +{: #product-insights_usage} +Die Nutzungsinformationen werden auf der Registerkarte **Nutzung** angezeigt. Mithilfe der beiden Dropdown-Listen können Sie die Metrik für die Anzeige (sofern die Produktinstanz mehr als eine Metrik sendet) sowie den anzuzeigenden Zeitraum auswählen. + +Sendet die Produktinstanz mehr als eine Metrik, verwenden Sie die erste Dropdown-Liste, um die Metrik für die Anzeige auszuwählen. Wählen Sie den Zeitraum für die Anzeige in der zweiten Dropdown-Liste aus. Die Optionen für den Zeitraum für die Abschnitte sind folgende: Letzte 24 Stunden, 1 Woche, 1 Monat, 6 Monate, 1 Jahr. + +Im ersten Abschnitt sind das durchschnittliche Maximum, der Durchschnitt, das durchschnittliche Minimum sowie die Gesamtsumme der Metrikwerte über den ausgewählten Zeitraum zu sehen. Im zweiten Abschnitt ist ein Diagramm der Werte innerhalb des Zeitraums mit dem X-Achsenzeitraum zu sehen; dieser verändert sich in Abhängigkeit von dem ausgewählten Zeitraum. Beispiel: 'Letzte 24 Stunden' zeigt Diagrammpunkte für jede Stunde an, während '1 Woche' Diagrammpunkte für jeden Tag innerhalb dieser Woche anzeigt. Im letzten Abschnitt werden Maximum, Durchschnitt und Minimum für den ausgewählten Diagrammpunkt angezeigt. Um die Werte für einen weiteren Punkt im Diagramm anzuzeigen, müssen Sie die Zeitleiste an eine neue Position ziehen. + +Wenn für diesen Zeitraum keine Daten verfügbar sind, wird eine Nachricht angezeigt. So stellt eine gestoppte Instanz beispielsweise keine Daten bereit; folglich werden für den Zeitraum, in dem sie gestoppt war, keine Daten angezeigt. Für weitere Zeiträume gibt es möglicherweise Nutzungsdaten, die angezeigt werden können. Ändern Sie den Zeitraum in der Dropdown-Liste, um weitere Zeiträume anzuzeigen. + +Auf der Registerkarte **Details** werden die Produktinstanzinformationen angezeigt; dazu können die folgenden Positionen gehören: + +* Produktname und -version +* Position, an der das Produkt installiert ist, einschließlich des Hostnamens und des Verzeichnisses +* Letzter Zeitpunkt, zu dem die Instanz Startup-Informationen gesendet hat +* Instanz-ID, falls das Produkt mehrere Instanzen innerhalb eines einzigen Verzeichnisses haben kann + +![Details zur Produktinstanz](images/instancedetail.png "Details zur Produktinstanz") + +Die Produktinstanz stellt außerdem die folgenden optionalen Informationen bereit: + +* Eine Liste der installierten APARs. +* Angaben zum Betriebssystem und der Betriebssystemversion, die sich auf der Registerkarte **Umgebung** befinden. +![Details zur Produktinstanz - Registerkarte 'Umgebung'](images/instancedetails-env.png "Details zur Produktinstanz - Registerkarte 'Umgebung'") +* Komponenten oder installierte Features, die auf der Registerkarte **Komponenten** zu sehen sind. In dem Beispiel wird die Registerkarte **Komponenten** nicht angezeigt, da die Instanz von IBM Product XYZ keine weiteren Komponenteninformationen bereitstellt. +![Details zur Produktinstanz - Registerkarte 'Komponente'](images/instancedetails-comps.png "Details zur Produktinstanz - Registerkarte 'Komponente'") +* Die eindeutige ID für die Produktinstanz; diese ist eine Kombination aus Hostname, Verzeichnis und Instanz-ID. + + + + +## Suche +{: #product-insights_search} +Das Fenster **Produktinstanz** stellt eine Basissuchfunktion zum Filtern der Produktliste bereit. Geben Sie im Suchfeld die Zeichenfolge für die Suche ein. Die Suche kann nur für Produktinstanzdaten durchgeführt werden (d. h. für die Angaben auf der Registerkarte **Details**). + + + + + +## Hilfe für {{site.data.keyword.product-insights_short}} anfordern +{: #gettinghelp} + +Ausführliche Informationen zur Erstellung eines Service, zum Abrufen der Aktualisierungen für die aktivierten IBM Softwareprodukte sowie die erforderlichen Installations- und Konfigurationsschritte finden Sie bei der [technischen Community von {{site.data.keyword.product-insights_full}}](https://developer.ibm.com/product-insights/). Bei Problemen bei der oder Fragen zu der Verwendung von {{site.data.keyword.product-insights_short}} können Sie Fragen im Forenabschnitt der Community einsehen oder posten. Diese Fragen werden vom Entwickler- und Kundenprogrammteam bearbeitet. + +Zum Einsehen oder Posten von Fragen können Sie auch das Stack Overflow- und das IBM DeveloperWorks dw Answers-Forum nutzen. Für Fragen zum Service sowie zu den Anweisungen zur Einführung nutzen Sie IBM developerWorks dW Answers. Wenn Sie in einem der beiden Foren eine Frage posten, wenden Sie die folgenden Tagging-Regeln an, damit die Bluemix-Entwicklerteams Ihre Frage unmittelbar identifizieren können. + +* Für Posts an [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window} klicken, Frage mit "ibm-bluemix" und "productinsights" taggen. +* Für Posts an [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window} klicken, Fragen mit "productinsights" oder "hybridconnect" taggen. + +Weitere Informationen zur Nutzung der Foren finden Sie im Thema [Hilfe anfordern](https://www.{DomainName}/docs/support/index.html#getting-help). diff --git a/services/product-insights/nl/fr/index.md b/services/product-insights/nl/fr/index.md index a81d0a76f..be45679c2 100644 --- a/services/product-insights/nl/fr/index.md +++ b/services/product-insights/nl/fr/index.md @@ -1,50 +1,50 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# Initiation à {{site.data.keyword.product-insights_short}} -{: #product-insights} - -{{site.data.keyword.product-insights_full}} se connecte aux produits logiciels IBM sur site pour générer un inventaire de tous les produits et fournit des analyses sur les données d'utilisation de ces derniers. - -{:shortdesc} - -Le service {{site.data.keyword.product-insights_short}} s'exécute dans IBM Bluemix et reçoit des informations provenant des produits logiciels IBM sur site activés. Ces informations sont ensuite affichées dans le tableau de bord de l'instance de service. Pour utiliser ce service, vous devez disposer d'un compte Bluemix et devez créer le service dans une organisation et un espace. Les informations sur les produits et l'utilisation des produits sur site activés sont stockées de manière sécurisée et peuvent être consultées dans la portée ou le contexte de ce service unique. - -Astuce : il est plus simple de n'utiliser qu'une seule instance de service pour commencer. - -Pour commencer à utiliser {{site.data.keyword.product-insights_short}}, procédez comme suit : - -1. Dans l'onglet **Manage**, cliquez sur le bouton **Register a product** pour afficher la liste des produits pris en charge, ainsi que le niveau de version requis. Des instructions sont fournies pour chaque type de produit afin que vous puissiez connecter vos instances de produit sur site au service {{site.data.keyword.product-insights_short}}. Si nécessaire, mettez à jour vos produits logiciels IBM sur site activés vers le niveau prérequis minimum. S'il s'agit d'un produit nécessitant un niveau minimum pris en charge, installez le groupe de correctifs ou le correctif temporaire afin d'activer l'intégration avec {{site.data.keyword.product-insights_short}}. -2. Connectez vos produits logiciels IBM sur site activés à votre service {{site.data.keyword.product-insights_short}}. Dans le cadre du processus de configuration de chaque produit, vous avez besoin des données d'identification du service (c'est-à-dire apikey et apihost). Vous trouverez les données d'identification du service dans l'onglet **Service Credentials** du tableau de bord du service. -3. Après avoir activé et connecté chaque instance de produit, il se peut que vous deviez démarrer ou redémarrer les produits ou les instances de produit afin qu'ils fournissent les informations les concernant et sur leur utilisation au service {{site.data.keyword.product-insights_short}}. - -Pour plus de détails sur l'activation des produits, le niveau de prise en charge minimum de chaque produit et le mode d'activation de chaque produit en vue de son intégration avec {{site.data.keyword.product-insights_short}}, rejoignez la communauté {{site.data.keyword.product-insights_full}} [Technical Community](https://developer.ibm.com/product-insights/). - -Vous pouvez consulter votre inventaire en sélectionnant l'onglet **Manage** dans le tableau de bord du service. - -* Dans le tableau de bord du service, les noms des produits connectés sont répertoriés dans le panneau **Products**. -* Pour afficher toutes les instances de produit, sélectionnez **View all**. Pour afficher les instances de produit d'un produit, sélectionnez ce produit dans le panneau **Products** ; les instances apparaissent alors dans le panneau **Instances**. -* Pour afficher les détails d'une seule instance de produit, sélectionnez l'instance de produit dans le panneau **Instances**. Le panneau **Details** affiche alors les informations correspondantes. Le panneau **Details** indique les détails de chaque instance de produit, ainsi que les informations d'utilisation envoyées par l'instance. -* L'onglet **Usage** affiche les informations d'utilisation du produit au format graphique. Selon le produit, vous pouvez indiquer le type d'informations que vous souhaitez visualiser ainsi que la période d'échantillonnage. -* L'onglet **Details** affiche les informations sur l'instance de produit, notamment les informations sur le produit, l'environnement et les composants. -* L'onglet **Advisor**, dans l'onglet **Services**, fournit des détails sur les services supplémentaires dont vous pourriez tirer parti en plus de l'instance de produit en cours. L'onglet **Updates** fournit des informations sur le niveau de version de l'instance de produit et sa devise. - - - - - - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# Initiation à {{site.data.keyword.product-insights_short}} +{: #product-insights} + +{{site.data.keyword.product-insights_full}} se connecte aux produits logiciels IBM sur site pour générer un inventaire de tous les produits et fournit des analyses sur les données d'utilisation de ces derniers. + +{:shortdesc} + +Le service {{site.data.keyword.product-insights_short}} s'exécute dans IBM Bluemix et reçoit des informations provenant des produits logiciels IBM sur site activés. Ces informations sont ensuite affichées dans le tableau de bord de l'instance de service. Pour utiliser ce service, vous devez disposer d'un compte Bluemix et devez créer le service dans une organisation et un espace. Les informations sur les produits et l'utilisation des produits sur site activés sont stockées de manière sécurisée et peuvent être consultées dans la portée ou le contexte de ce service unique. + +Astuce : il est plus simple de n'utiliser qu'une seule instance de service pour commencer. + +Pour commencer à utiliser {{site.data.keyword.product-insights_short}}, procédez comme suit : + +1. Dans l'onglet **Manage**, cliquez sur le bouton **Register a product** pour afficher la liste des produits pris en charge, ainsi que le niveau de version requis. Des instructions sont fournies pour chaque type de produit afin que vous puissiez connecter vos instances de produit sur site au service {{site.data.keyword.product-insights_short}}. Si nécessaire, mettez à jour vos produits logiciels IBM sur site activés vers le niveau prérequis minimum. S'il s'agit d'un produit nécessitant un niveau minimum pris en charge, installez le groupe de correctifs ou le correctif temporaire afin d'activer l'intégration avec {{site.data.keyword.product-insights_short}}. +2. Connectez vos produits logiciels IBM sur site activés à votre service {{site.data.keyword.product-insights_short}}. Dans le cadre du processus de configuration de chaque produit, vous avez besoin des données d'identification du service (c'est-à-dire apikey et apihost). Vous trouverez les données d'identification du service dans l'onglet **Service Credentials** du tableau de bord du service. +3. Après avoir activé et connecté chaque instance de produit, il se peut que vous deviez démarrer ou redémarrer les produits ou les instances de produit afin qu'ils fournissent les informations les concernant et sur leur utilisation au service {{site.data.keyword.product-insights_short}}. + +Pour plus de détails sur l'activation des produits, le niveau de prise en charge minimum de chaque produit et le mode d'activation de chaque produit en vue de son intégration avec {{site.data.keyword.product-insights_short}}, rejoignez la communauté {{site.data.keyword.product-insights_full}} [Technical Community](https://developer.ibm.com/product-insights/). + +Vous pouvez consulter votre inventaire en sélectionnant l'onglet **Manage** dans le tableau de bord du service. + +* Dans le tableau de bord du service, les noms des produits connectés sont répertoriés dans le panneau **Products**. +* Pour afficher toutes les instances de produit, sélectionnez **View all**. Pour afficher les instances de produit d'un produit, sélectionnez ce produit dans le panneau **Products** ; les instances apparaissent alors dans le panneau **Instances**. +* Pour afficher les détails d'une seule instance de produit, sélectionnez l'instance de produit dans le panneau **Instances**. Le panneau **Details** affiche alors les informations correspondantes. Le panneau **Details** indique les détails de chaque instance de produit, ainsi que les informations d'utilisation envoyées par l'instance. +* L'onglet **Usage** affiche les informations d'utilisation du produit au format graphique. Selon le produit, vous pouvez indiquer le type d'informations que vous souhaitez visualiser ainsi que la période d'échantillonnage. +* L'onglet **Details** affiche les informations sur l'instance de produit, notamment les informations sur le produit, l'environnement et les composants. +* L'onglet **Advisor**, dans l'onglet **Services**, fournit des détails sur les services supplémentaires dont vous pourriez tirer parti en plus de l'instance de produit en cours. L'onglet **Updates** fournit des informations sur le niveau de version de l'instance de produit et sa devise. + + + + + + + + + + diff --git a/services/product-insights/nl/fr/product-insights_overview.md b/services/product-insights/nl/fr/product-insights_overview.md index d376c5306..0f4486aea 100644 --- a/services/product-insights/nl/fr/product-insights_overview.md +++ b/services/product-insights/nl/fr/product-insights_overview.md @@ -1,144 +1,144 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" - ---- - - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# A propos d'IBM {{site.data.keyword.product-insights_short}} -{: #about_product-insights} - -{{site.data.keyword.product-insights_full}} est un service IBM Bluemix, qui fait partie d'IBM Connect to Cloud. Il permet de connecter vos produits logiciels IBM sur site à votre service {{site.data.keyword.product-insights_short}} et fournit des analyses sur l'inventaire en cours, ainsi que sur les mesures relatives à l'utilisation du contexte d'exécution. - -{:shortdesc} - -Le service {{site.data.keyword.product-insights_short}} est un point d'entrée, des fonctions supplémentaires peuvent être ajoutées ultérieurement. - -{{site.data.keyword.product-insights_short}} fournit les fonctions suivantes : - -* Enregistrement de vos produits logiciels IBM sur site auprès d'IBM, en particulier avec un service Bluemix. -* Collecte de données pour les produits sur site connectés et les données d'utilisation associées. -* Tableau de bord des données d'utilisation du contexte d'exécution visant à fournir une analyse réelle de l'utilisation et de la charge de travail de vos produits. - - -Pour utiliser les fonctionnalités d'{{site.data.keyword.product-insights_full}}, procédez comme suit : - -1. Créez au moins un service dans Bluemix pour {{site.data.keyword.product-insights_short}}. -1. Mettez à niveau vos produits logiciels IBM sur site vers les niveaux d'édition requis et ajoutez le code d'intégration de chaque installation de produit. -1. Configurez l'installation des logiciels avec les données d'identification {{site.data.keyword.bluemix_short}} de votre instance de service {{site.data.keyword.product-insights_short}}. Toutes les données sont stockées de manière sécurisée avec ces données d'identification. Les données sont disponibles uniquement auprès des individus dotés des droits appropriés sur le service. - - - -## Fonctionnement -{: #product-insights_howitworks} -Le service {{site.data.keyword.product-insights_full}} s'intègre à vos produits logiciels IBM sur site afin de rassembler et afficher des informations sur les produits de votre contexte d'exécution, ainsi que les mesures liées à leur utilisation. Initialement, un sous-ensemble de produits logiciels IBM est activé pour s'intégrer avec ce service. Une fois enregistrés et connectés, les produits logiciels sur site envoient régulièrement des informations liées au démarrage et à leur utilisation. Ces informations sont stockées en lien avec cette instance de service grâce aux données d'identification configurées. Vous pouvez utiliser le tableau de bord de l'instance de service pour visualiser ces informations dans Bluemix. - -La solution {{site.data.keyword.product-insights_short}} inclut plusieurs composants, comme indiqué dans la figure suivante : - -![Architecture d'{{site.data.keyword.product-insights_full}}](images/architecture_product-insights.png "Architecture d'{{site.data.keyword.product-insights_full}}"). - - -## Organisations et espaces -{: #product-insights_orgs} -Votre service {{site.data.keyword.product-insights_full}} est associé à un seul espace et une seule organisation Bluemix, et est dotée de données d'identification uniques. Vous devez configurer au moins un espace et une organisation Bluemix. Si vous souhaitez séparer les données, par exemple pour limiter l'accès d'individus spécifiques, vous pouvez créer plusieurs espaces au sein d'une organisation avec une instance de service dans chaque espace. Chaque instance de service possède des données d'identification uniques que vous devez fournir à vos produits logiciels IBM. - -Les informations des produits configurés avec un ensemble de données d'identification sont visibles uniquement dans le service doté de ces données d'identification. Il est possible de créer plusieurs services pour séparer les données si nécessaire, chacun d'entre eux étant doté de données d'identification uniques. - - -## Tableau de bord du service -{: #service_dashboard} -Après avoir créé votre instance de service, vous êtes dirigé vers le tableau de bord du service. Vous pouvez toujours revenir à ce tableau de bord en cliquant sur l'icône du service dans le tableau de bord de votre organisation. Le tableau de bord du service vous permet d'accéder aux éléments suivants : - -* La documentation d'initiation -* Les données d'identification du service dont vous avez besoin pour vous connecter à vos produits sur site -* Un inventaire des produits pris en charge et des instances d'exécution enregistrées auprès de l'instance de service {{site.data.keyword.product-insights_short}} -* Les informations sur l'utilisation des instances d'exécution connectées -* Les informations sur les produits et l'environnement des instances d'exécution connectées - -Si aucun produit n'est indiqué dans l'onglet Manage, cliquez sur **Register a product** pour afficher une liste des produits pris en charge, ainsi que les détails spécifiques des accès pour la connexion aux instances de produit. -![Tableau de bord du service sans produit enregistré](images/NoRegisteredProducts.jpg "Tableau de bord du service sans produit enregistré") - -## Enregistrement d'un produit -{: #product-insights_register} -Dans l'onglet **Manage**, cliquez sur **Register a product** pour afficher une liste des produits pris en charge. Accédez à votre produit ou utilisez la zone de recherche pour filtrer la liste des produits. -![Liste filtrée des produits disponibles pour l'enregistrement](images/products-filtered.png "Liste filtrée des produits disponibles pour l'enregistrement") - -Pour afficher les instructions relatives à l'enregistrement de l'instance d'un produit, sélectionnez ce dernier dans la liste. - -Lorsque vous connectez une instance de produit au service {{site.data.keyword.product-insights_short}}, elle apparaît dans l'onglet **Manage** du tableau de bord. Un tableau de bord peut répertorier plusieurs instances de produit connectées pour différents produits. - -## Inventaire des produits -{: #product-insights_products} -Une fois que vous avez activé les instances de produit afin qu'elles envoient des données à {{site.data.keyword.product-insights_short}}, vous pouvez visualiser votre inventaire en sélectionnant l'onglet **Manage** dans le tableau de bord du service. - -![Tableau de bord du service comportant des produits et des instances de produit](images/productinstances.png "Tableau de bord du service comportant des produits et des instances de produit") - -Dans {{site.data.keyword.product-insights_short}}, un produit est différent d'une instance de produit. Un produit est doté d'un nom de produit, comme IBM MQ ou IBM WebSphere Application Server Liberty Network Deployment. Une instance de produit permet de représenter un produit une fois qu'il est installé et exécuté. Certains produits possèdent plusieurs instances qui sont exécutées à partir de la même installation du produit. Par exemple, WebSphere Application Server Liberty Network Deployment peut exécuter plusieurs serveurs d'applications créés à partir d'une seule installation du produit. - -Dans le tableau de bord du service, les noms des produits enregistrés s'affichent sous *View all* dans le panneau **Products**. Les instances connectées sont indiquées dans le panneau **Instances**. Ce panneau contient les instances des produits sélectionnés dans le panneau **Products**. Dans l'exemple qui suit, toutes les instances de produits sont affichées car l'option *View all* est sélectionnée dans le panneau Products. Cet exemple montre six produits, dont certains possèdent plusieurs instances connectées. Vous pouvez filtrer la liste des instances à l'aide de la zone **Search Instances** ou en sélectionnant une entrée de produit. Pour afficher les détails d'une instance de produit, sélectionnez l'entrée correspondante dans le panneau **Instances**. - -La liste des instances de produit qui s'affichent est filtrée en fonction du chemin d'accès. Dans le but de faciliter la navigation, le chemin d'accès à l'instance sélectionnée est indiqué. - -![Tableau de bord du service](images/products.png "Tableau de bord du service") - - - -## Informations sur une instance de produit -{: #product-insights_productinstances} -Lorsqu'une instance de produit est sélectionnée, le panneau **Instance details** affiche les informations associées. Il indique les données d'utilisation et les détails du produit, ainsi que les recommandations liées à l'instance de produit dans un onglet **Advisor**. - - -## Informations d'utilisation -{: #product-insights_usage} -Les informations d'utilisation sont indiquées dans l'onglet **Usage**. Utilisez les deux listes déroulantes pour sélectionner la mesure(si l'instance de produit envoie plusieurs mesures) et la période à afficher. - -Si l'instance de produit envoie plusieurs mesures, utilisez la première liste déroulante pour sélectionner la mesure à afficher. Sélectionnez la période dans la seconde liste déroulante. Vous pouvez choisir parmi les dernières 24 heures, 1 semaine, 1 mois, 6 mois ou 1 an. - -La première section montre le maximum moyen, la moyenne, le minimum moyen et le total des valeurs de mesure sur la période sélectionnée. La seconde section affiche un diagramme des valeurs pendant la période sélectionnée, la période étant indiquée sur l'axe des X, qui change selon votre sélection. Par exemple, si vous optez pour les dernières 24 heures, un point du diagramme indique chaque heure, alors que si vous choisissez une période d'une semaine, un point du diagramme représente chaque jour de la semaine. La section finale représente le maximum, la moyenne et le minimum du point de diagramme sélectionné. Pour visualiser les valeurs d'un autre point, faites glisser la barre de temps vers une nouvelle position. - -Un message s'affiche si aucune donnée n'est disponible pour la période choisie. Par exemple, une instance arrêtée ne fournit aucune donnée, et aucune donnée ne s'affiche pour la période de l'arrêt. D'autres périodes peuvent fournir des données d'utilisation à afficher. Modifiez la période dans la liste déroulante pour visualiser d'autres périodes. - -L'onglet **Details** affiche des informations sur l'instance de produit qui peuvent inclure les éléments suivants : - -* Le nom et la version du produit -* L'emplacement d'installation du produit, avec le nom d'hôte et le répertoire -* L'heure du dernier envoi d'informations de la part de l'instance au démarrage -* L'identificateur de l'instance si le produit peut posséder plusieurs instances dans un seul répertoire - -![Détails d'une instance de produit](images/instancedetail.png "Détails d'une instance de produit") - -L'instance de produit fournit également les informations facultatives suivantes : - -* La liste des APAR installés. -* Le système d'exploitation et sa version, qui s'affichent dans l'onglet **Environment**. -![Détails d'une instance de produit - Onglet Environment](images/instancedetails-env.png "Détails d'une instance de produit - Onglet Environment") -* Les composants ou les fonctions installées, qui sont indiqués dans l'onglet **Components**. L'exemple ne montre pas l'onglet **Components** car l'instance du produit IBM XYZ ne fournit pas d'informations sur d'éventuels composants supplémentaires. ![Détails d'une instance de produit - Onglet Component](images/instancedetails-comps.png "Détails d'une instance de produit - Onglet Component") -* L'identificateur unique de l'instance de produit, avec une combinaison du nom d'hôte, du répertoire et de l'identificateur de l'instance. - - - - -## Recherche -{: #product-insights_search} -Le panneau **Product instance** permet d'effectuer une recherche de base pour filtrer la liste des produits. Dans la zone de recherche, entrez la chaîne que vous voulez employer pour la recherche. La recherche ne peut être effectuée que sur les données de l'instance de produit (c'est-à-dire les informations figurant dans l'onglet **Details**). - - - - - -## Obtenir de l'aide sur {{site.data.keyword.product-insights_short}} -{: #gettinghelp} - -Vous trouvez des informations détaillées sur la création d'un service, l'obtention des mises à jour pour les produits logiciels IBM activés et les étapes relatives à l'installation et à la configuration sur le site de la communauté [{{site.data.keyword.product-insights_full}} Technical Community](https://developer.ibm.com/product-insights/). Si vous rencontrez des problèmes ou si vous avez des questions sur l'utilisation de {{site.data.keyword.product-insights_short}}, consultez le forum de la communauté ou envoyez vos questions dans cette section. Les questions sont traitées par l'équipe de développement et des programmes client. - -Vous pouvez également utiliser les forums Stack Overflow et IBM DeveloperWorks dw Answers pour consulter ou poser des questions. Pour toute question sur le service et les instructions de mise en route, consultez IBM developerWorks dW Answers. Lorsque vous envoyez une question sur l'un ou l'autre de ces forums, appliquez les règles d'étiquette suivantes pour permettre aux équipes de développement Bluemix de la voir facilement. - -* Cliquez ici pour envoyer une question sur [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window} et marquez votre question avec les étiquettes "ibm-bluemix" et "productinsights". -* Cliquez ici pour envoyer une question sur [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window} et marquez votre question avec l'étiquette "productinsights" ou "hybridconnect". - -Pour plus d'informations sur l'utilisation des forums, reportez-vous à la rubrique indiquant [comment obtenir de l'aide](https://www.{DomainName}/docs/support/index.html#getting-help). +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" + +--- + + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# A propos d'IBM {{site.data.keyword.product-insights_short}} +{: #about_product-insights} + +{{site.data.keyword.product-insights_full}} est un service IBM Bluemix, qui fait partie d'IBM Connect to Cloud. Il permet de connecter vos produits logiciels IBM sur site à votre service {{site.data.keyword.product-insights_short}} et fournit des analyses sur l'inventaire en cours, ainsi que sur les mesures relatives à l'utilisation du contexte d'exécution. + +{:shortdesc} + +Le service {{site.data.keyword.product-insights_short}} est un point d'entrée, des fonctions supplémentaires peuvent être ajoutées ultérieurement. + +{{site.data.keyword.product-insights_short}} fournit les fonctions suivantes : + +* Enregistrement de vos produits logiciels IBM sur site auprès d'IBM, en particulier avec un service Bluemix. +* Collecte de données pour les produits sur site connectés et les données d'utilisation associées. +* Tableau de bord des données d'utilisation du contexte d'exécution visant à fournir une analyse réelle de l'utilisation et de la charge de travail de vos produits. + + +Pour utiliser les fonctionnalités d'{{site.data.keyword.product-insights_full}}, procédez comme suit : + +1. Créez au moins un service dans Bluemix pour {{site.data.keyword.product-insights_short}}. +1. Mettez à niveau vos produits logiciels IBM sur site vers les niveaux d'édition requis et ajoutez le code d'intégration de chaque installation de produit. +1. Configurez l'installation des logiciels avec les données d'identification {{site.data.keyword.bluemix_short}} de votre instance de service {{site.data.keyword.product-insights_short}}. Toutes les données sont stockées de manière sécurisée avec ces données d'identification. Les données sont disponibles uniquement auprès des individus dotés des droits appropriés sur le service. + + + +## Fonctionnement +{: #product-insights_howitworks} +Le service {{site.data.keyword.product-insights_full}} s'intègre à vos produits logiciels IBM sur site afin de rassembler et afficher des informations sur les produits de votre contexte d'exécution, ainsi que les mesures liées à leur utilisation. Initialement, un sous-ensemble de produits logiciels IBM est activé pour s'intégrer avec ce service. Une fois enregistrés et connectés, les produits logiciels sur site envoient régulièrement des informations liées au démarrage et à leur utilisation. Ces informations sont stockées en lien avec cette instance de service grâce aux données d'identification configurées. Vous pouvez utiliser le tableau de bord de l'instance de service pour visualiser ces informations dans Bluemix. + +La solution {{site.data.keyword.product-insights_short}} inclut plusieurs composants, comme indiqué dans la figure suivante : + +![Architecture d'{{site.data.keyword.product-insights_full}}](images/architecture_product-insights.png "Architecture d'{{site.data.keyword.product-insights_full}}"). + + +## Organisations et espaces +{: #product-insights_orgs} +Votre service {{site.data.keyword.product-insights_full}} est associé à un seul espace et une seule organisation Bluemix, et est dotée de données d'identification uniques. Vous devez configurer au moins un espace et une organisation Bluemix. Si vous souhaitez séparer les données, par exemple pour limiter l'accès d'individus spécifiques, vous pouvez créer plusieurs espaces au sein d'une organisation avec une instance de service dans chaque espace. Chaque instance de service possède des données d'identification uniques que vous devez fournir à vos produits logiciels IBM. + +Les informations des produits configurés avec un ensemble de données d'identification sont visibles uniquement dans le service doté de ces données d'identification. Il est possible de créer plusieurs services pour séparer les données si nécessaire, chacun d'entre eux étant doté de données d'identification uniques. + + +## Tableau de bord du service +{: #service_dashboard} +Après avoir créé votre instance de service, vous êtes dirigé vers le tableau de bord du service. Vous pouvez toujours revenir à ce tableau de bord en cliquant sur l'icône du service dans le tableau de bord de votre organisation. Le tableau de bord du service vous permet d'accéder aux éléments suivants : + +* La documentation d'initiation +* Les données d'identification du service dont vous avez besoin pour vous connecter à vos produits sur site +* Un inventaire des produits pris en charge et des instances d'exécution enregistrées auprès de l'instance de service {{site.data.keyword.product-insights_short}} +* Les informations sur l'utilisation des instances d'exécution connectées +* Les informations sur les produits et l'environnement des instances d'exécution connectées + +Si aucun produit n'est indiqué dans l'onglet Manage, cliquez sur **Register a product** pour afficher une liste des produits pris en charge, ainsi que les détails spécifiques des accès pour la connexion aux instances de produit. +![Tableau de bord du service sans produit enregistré](images/NoRegisteredProducts.jpg "Tableau de bord du service sans produit enregistré") + +## Enregistrement d'un produit +{: #product-insights_register} +Dans l'onglet **Manage**, cliquez sur **Register a product** pour afficher une liste des produits pris en charge. Accédez à votre produit ou utilisez la zone de recherche pour filtrer la liste des produits. +![Liste filtrée des produits disponibles pour l'enregistrement](images/products-filtered.png "Liste filtrée des produits disponibles pour l'enregistrement") + +Pour afficher les instructions relatives à l'enregistrement de l'instance d'un produit, sélectionnez ce dernier dans la liste. + +Lorsque vous connectez une instance de produit au service {{site.data.keyword.product-insights_short}}, elle apparaît dans l'onglet **Manage** du tableau de bord. Un tableau de bord peut répertorier plusieurs instances de produit connectées pour différents produits. + +## Inventaire des produits +{: #product-insights_products} +Une fois que vous avez activé les instances de produit afin qu'elles envoient des données à {{site.data.keyword.product-insights_short}}, vous pouvez visualiser votre inventaire en sélectionnant l'onglet **Manage** dans le tableau de bord du service. + +![Tableau de bord du service comportant des produits et des instances de produit](images/productinstances.png "Tableau de bord du service comportant des produits et des instances de produit") + +Dans {{site.data.keyword.product-insights_short}}, un produit est différent d'une instance de produit. Un produit est doté d'un nom de produit, comme IBM MQ ou IBM WebSphere Application Server Liberty Network Deployment. Une instance de produit permet de représenter un produit une fois qu'il est installé et exécuté. Certains produits possèdent plusieurs instances qui sont exécutées à partir de la même installation du produit. Par exemple, WebSphere Application Server Liberty Network Deployment peut exécuter plusieurs serveurs d'applications créés à partir d'une seule installation du produit. + +Dans le tableau de bord du service, les noms des produits enregistrés s'affichent sous *View all* dans le panneau **Products**. Les instances connectées sont indiquées dans le panneau **Instances**. Ce panneau contient les instances des produits sélectionnés dans le panneau **Products**. Dans l'exemple qui suit, toutes les instances de produits sont affichées car l'option *View all* est sélectionnée dans le panneau Products. Cet exemple montre six produits, dont certains possèdent plusieurs instances connectées. Vous pouvez filtrer la liste des instances à l'aide de la zone **Search Instances** ou en sélectionnant une entrée de produit. Pour afficher les détails d'une instance de produit, sélectionnez l'entrée correspondante dans le panneau **Instances**. + +La liste des instances de produit qui s'affichent est filtrée en fonction du chemin d'accès. Dans le but de faciliter la navigation, le chemin d'accès à l'instance sélectionnée est indiqué. + +![Tableau de bord du service](images/products.png "Tableau de bord du service") + + + +## Informations sur une instance de produit +{: #product-insights_productinstances} +Lorsqu'une instance de produit est sélectionnée, le panneau **Instance details** affiche les informations associées. Il indique les données d'utilisation et les détails du produit, ainsi que les recommandations liées à l'instance de produit dans un onglet **Advisor**. + + +## Informations d'utilisation +{: #product-insights_usage} +Les informations d'utilisation sont indiquées dans l'onglet **Usage**. Utilisez les deux listes déroulantes pour sélectionner la mesure(si l'instance de produit envoie plusieurs mesures) et la période à afficher. + +Si l'instance de produit envoie plusieurs mesures, utilisez la première liste déroulante pour sélectionner la mesure à afficher. Sélectionnez la période dans la seconde liste déroulante. Vous pouvez choisir parmi les dernières 24 heures, 1 semaine, 1 mois, 6 mois ou 1 an. + +La première section montre le maximum moyen, la moyenne, le minimum moyen et le total des valeurs de mesure sur la période sélectionnée. La seconde section affiche un diagramme des valeurs pendant la période sélectionnée, la période étant indiquée sur l'axe des X, qui change selon votre sélection. Par exemple, si vous optez pour les dernières 24 heures, un point du diagramme indique chaque heure, alors que si vous choisissez une période d'une semaine, un point du diagramme représente chaque jour de la semaine. La section finale représente le maximum, la moyenne et le minimum du point de diagramme sélectionné. Pour visualiser les valeurs d'un autre point, faites glisser la barre de temps vers une nouvelle position. + +Un message s'affiche si aucune donnée n'est disponible pour la période choisie. Par exemple, une instance arrêtée ne fournit aucune donnée, et aucune donnée ne s'affiche pour la période de l'arrêt. D'autres périodes peuvent fournir des données d'utilisation à afficher. Modifiez la période dans la liste déroulante pour visualiser d'autres périodes. + +L'onglet **Details** affiche des informations sur l'instance de produit qui peuvent inclure les éléments suivants : + +* Le nom et la version du produit +* L'emplacement d'installation du produit, avec le nom d'hôte et le répertoire +* L'heure du dernier envoi d'informations de la part de l'instance au démarrage +* L'identificateur de l'instance si le produit peut posséder plusieurs instances dans un seul répertoire + +![Détails d'une instance de produit](images/instancedetail.png "Détails d'une instance de produit") + +L'instance de produit fournit également les informations facultatives suivantes : + +* La liste des APAR installés. +* Le système d'exploitation et sa version, qui s'affichent dans l'onglet **Environment**. +![Détails d'une instance de produit - Onglet Environment](images/instancedetails-env.png "Détails d'une instance de produit - Onglet Environment") +* Les composants ou les fonctions installées, qui sont indiqués dans l'onglet **Components**. L'exemple ne montre pas l'onglet **Components** car l'instance du produit IBM XYZ ne fournit pas d'informations sur d'éventuels composants supplémentaires. ![Détails d'une instance de produit - Onglet Component](images/instancedetails-comps.png "Détails d'une instance de produit - Onglet Component") +* L'identificateur unique de l'instance de produit, avec une combinaison du nom d'hôte, du répertoire et de l'identificateur de l'instance. + + + + +## Recherche +{: #product-insights_search} +Le panneau **Product instance** permet d'effectuer une recherche de base pour filtrer la liste des produits. Dans la zone de recherche, entrez la chaîne que vous voulez employer pour la recherche. La recherche ne peut être effectuée que sur les données de l'instance de produit (c'est-à-dire les informations figurant dans l'onglet **Details**). + + + + + +## Obtenir de l'aide sur {{site.data.keyword.product-insights_short}} +{: #gettinghelp} + +Vous trouvez des informations détaillées sur la création d'un service, l'obtention des mises à jour pour les produits logiciels IBM activés et les étapes relatives à l'installation et à la configuration sur le site de la communauté [{{site.data.keyword.product-insights_full}} Technical Community](https://developer.ibm.com/product-insights/). Si vous rencontrez des problèmes ou si vous avez des questions sur l'utilisation de {{site.data.keyword.product-insights_short}}, consultez le forum de la communauté ou envoyez vos questions dans cette section. Les questions sont traitées par l'équipe de développement et des programmes client. + +Vous pouvez également utiliser les forums Stack Overflow et IBM DeveloperWorks dw Answers pour consulter ou poser des questions. Pour toute question sur le service et les instructions de mise en route, consultez IBM developerWorks dW Answers. Lorsque vous envoyez une question sur l'un ou l'autre de ces forums, appliquez les règles d'étiquette suivantes pour permettre aux équipes de développement Bluemix de la voir facilement. + +* Cliquez ici pour envoyer une question sur [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window} et marquez votre question avec les étiquettes "ibm-bluemix" et "productinsights". +* Cliquez ici pour envoyer une question sur [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window} et marquez votre question avec l'étiquette "productinsights" ou "hybridconnect". + +Pour plus d'informations sur l'utilisation des forums, reportez-vous à la rubrique indiquant [comment obtenir de l'aide](https://www.{DomainName}/docs/support/index.html#getting-help). diff --git a/services/product-insights/nl/it/index.md b/services/product-insights/nl/it/index.md index b88acca61..56569e558 100644 --- a/services/product-insights/nl/it/index.md +++ b/services/product-insights/nl/it/index.md @@ -1,50 +1,50 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# Introduzione a {{site.data.keyword.product-insights_short}} -{: #product-insights} - -{{site.data.keyword.product-insights_full}} si collega a prodotti software IBM in loco per creare l'inventario tra i prodotti e fornire informazioni approfondite sulle metriche di utilizzo del prodotto. - -{:shortdesc} - -Il servizio {{site.data.keyword.product-insights_short}} viene eseguito in IBM Bluemix e riceve le informazioni dai prodotti software IBM in loco abilitati. Queste informazioni vengono quindi visualizzate nel dashboard dell'istanza del servizio. Per utilizzare il servizio, devi avere un account Bluemix e creare il servizio in un'organizzazione o in uno spazio. Le informazioni sull'utilizzo e sul prodotto per i prodotti in loco abilitati sono archiviate in modo sicuro e visualizzate nell'ambito o nel contesto di tale servizio univoco. - -Suggerimento: per semplicità, puoi inizialmente utilizzare una sola istanza del servizio. - -Introduzione a {{site.data.keyword.product-insights_short}}, completa le seguenti istruzioni: - -1. Nella scheda **Gestione**, fai clic sul pulsante **Registra un prodotto** per visualizzare un elenco di prodotti supportati e il livello della versione richiesto. Vengono fornite le istruzioni su ogni tipo di prodotto, in modo che puoi collegare le tue istanze del prodotto in loco al servizio {{site.data.keyword.product-insights_short}}. Se richiesto, aggiorna i tuoi prodotti software IBM in loco abilitati al livello prerequisito minimo. Per un prodotto che richiede un livello supportato minimo, installa il fix pack o la correzione ad interim per abilitare l'integrazione con {{site.data.keyword.product-insights_short}}. -2. Collega i tuoi prodotti software IBM in loco abilitati al tuo servizio {{site.data.keyword.product-insights_short}}. Come parte del processo di configurazione di ogni prodotto, hai bisogno delle credenziali del servizio (apikey e apihost). Puoi trovare le credenziali del servizio nella scheda **Credenziali del servizio** del tuo dashboard del servizio. -3. Dopo aver abilitato e collegato ogni istanza del prodotto, potresti dover avviare o riavviare i prodotti o le istanze del prodotto per fornire le riformazioni sull'utilizzo e sul prodotto al servizio {{site.data.keyword.product-insights_short}}. - -Per i dettagli sull'abilitazione dei prodotti, il livello di supporto minimo necessario per ogni prodotto e su come abilitare ogni prodotto per l'integrazione con {{site.data.keyword.product-insights_short}}, unisciti alla {{site.data.keyword.product-insights_full}} [Technical Community](https://developer.ibm.com/product-insights/). - -Puoi visualizzare il tuo inventario selezionando **Gestione** nel dashboard del servizio. - -* Nel dashboard del servizio, i nomi dei prodotti che sono stati collegati sono elencati nel pannello **Prodotti**. -* Per visualizzare tutte le istanze del prodotto, seleziona **Visualizza tutto**. Per visualizzare le istanze del prodotto di un prodotto, seleziona tale prodotto dal pannello **Prodotti** ed esse saranno visualizzate nel pannello **Istanze**. -* Per visualizzare i dettagli di una sola istanza del prodotto, selezionala dal pannello **Istanze**. Il pannello **Dettagli** viene quindi popolato. Il pannello **Dettagli** mostra i dettagli dell'istanza del prodotto e le informazioni sull'utilizzo che sono state inviate dall'istanza. -* La scheda **Utilizzo** mostra le informazioni sull'utilizzo del prodotto in formato grafico. A seconda del prodotto, puoi specificare il tipo di informazioni che desideri visualizzare e il periodo di campionamento. -* La scheda **Dettagli** mostra le informazioni sull'istanza del prodotto; incluse le informazioni sul prodotto, sull'ambiente e sul componente. -* La scheda **Controllo**, nella scheda **Servizi**, fornisce i dettagli sui servizi aggiuntivi che possono trarre vantaggio in relazione all'istanza del prodotto corrente. Nella scheda **Aggiornamenti**, fornisce informazioni sul livello della versione dell'istanza del prodotto e la relativa diffusione. - - - - - - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# Introduzione a {{site.data.keyword.product-insights_short}} +{: #product-insights} + +{{site.data.keyword.product-insights_full}} si collega a prodotti software IBM in loco per creare l'inventario tra i prodotti e fornire informazioni approfondite sulle metriche di utilizzo del prodotto. + +{:shortdesc} + +Il servizio {{site.data.keyword.product-insights_short}} viene eseguito in IBM Bluemix e riceve le informazioni dai prodotti software IBM in loco abilitati. Queste informazioni vengono quindi visualizzate nel dashboard dell'istanza del servizio. Per utilizzare il servizio, devi avere un account Bluemix e creare il servizio in un'organizzazione o in uno spazio. Le informazioni sull'utilizzo e sul prodotto per i prodotti in loco abilitati sono archiviate in modo sicuro e visualizzate nell'ambito o nel contesto di tale servizio univoco. + +Suggerimento: per semplicità, puoi inizialmente utilizzare una sola istanza del servizio. + +Introduzione a {{site.data.keyword.product-insights_short}}, completa le seguenti istruzioni: + +1. Nella scheda **Gestione**, fai clic sul pulsante **Registra un prodotto** per visualizzare un elenco di prodotti supportati e il livello della versione richiesto. Vengono fornite le istruzioni su ogni tipo di prodotto, in modo che puoi collegare le tue istanze del prodotto in loco al servizio {{site.data.keyword.product-insights_short}}. Se richiesto, aggiorna i tuoi prodotti software IBM in loco abilitati al livello prerequisito minimo. Per un prodotto che richiede un livello supportato minimo, installa il fix pack o la correzione ad interim per abilitare l'integrazione con {{site.data.keyword.product-insights_short}}. +2. Collega i tuoi prodotti software IBM in loco abilitati al tuo servizio {{site.data.keyword.product-insights_short}}. Come parte del processo di configurazione di ogni prodotto, hai bisogno delle credenziali del servizio (apikey e apihost). Puoi trovare le credenziali del servizio nella scheda **Credenziali del servizio** del tuo dashboard del servizio. +3. Dopo aver abilitato e collegato ogni istanza del prodotto, potresti dover avviare o riavviare i prodotti o le istanze del prodotto per fornire le riformazioni sull'utilizzo e sul prodotto al servizio {{site.data.keyword.product-insights_short}}. + +Per i dettagli sull'abilitazione dei prodotti, il livello di supporto minimo necessario per ogni prodotto e su come abilitare ogni prodotto per l'integrazione con {{site.data.keyword.product-insights_short}}, unisciti alla {{site.data.keyword.product-insights_full}} [Technical Community](https://developer.ibm.com/product-insights/). + +Puoi visualizzare il tuo inventario selezionando **Gestione** nel dashboard del servizio. + +* Nel dashboard del servizio, i nomi dei prodotti che sono stati collegati sono elencati nel pannello **Prodotti**. +* Per visualizzare tutte le istanze del prodotto, seleziona **Visualizza tutto**. Per visualizzare le istanze del prodotto di un prodotto, seleziona tale prodotto dal pannello **Prodotti** ed esse saranno visualizzate nel pannello **Istanze**. +* Per visualizzare i dettagli di una sola istanza del prodotto, selezionala dal pannello **Istanze**. Il pannello **Dettagli** viene quindi popolato. Il pannello **Dettagli** mostra i dettagli dell'istanza del prodotto e le informazioni sull'utilizzo che sono state inviate dall'istanza. +* La scheda **Utilizzo** mostra le informazioni sull'utilizzo del prodotto in formato grafico. A seconda del prodotto, puoi specificare il tipo di informazioni che desideri visualizzare e il periodo di campionamento. +* La scheda **Dettagli** mostra le informazioni sull'istanza del prodotto; incluse le informazioni sul prodotto, sull'ambiente e sul componente. +* La scheda **Controllo**, nella scheda **Servizi**, fornisce i dettagli sui servizi aggiuntivi che possono trarre vantaggio in relazione all'istanza del prodotto corrente. Nella scheda **Aggiornamenti**, fornisce informazioni sul livello della versione dell'istanza del prodotto e la relativa diffusione. + + + + + + + + + + diff --git a/services/product-insights/nl/it/product-insights_overview.md b/services/product-insights/nl/it/product-insights_overview.md index 230bc17dd..1b98de602 100644 --- a/services/product-insights/nl/it/product-insights_overview.md +++ b/services/product-insights/nl/it/product-insights_overview.md @@ -1,145 +1,145 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" - ---- - - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# Informazioni su IBM {{site.data.keyword.product-insights_short}} -{: #about_product-insights} - -{{site.data.keyword.product-insights_full}} è un servizio IBM Bluemix, parte di IBM Connect to Cloud. Collega i tuoi prodotti software IBM in loco al tuo servizio {{site.data.keyword.product-insights_short}} e fornisce informazioni approfondite sull'esecuzione dell'inventario e sulle metriche di utilizzo del runtime. - -{:shortdesc} - -Il servizio {{site.data.keyword.product-insights_short}} è un punto di partenza e potrebbero venire aggiunte ulteriori funzioni in futuro. - -{{site.data.keyword.product-insights_short}} fornisce le seguenti funzionalità: - -* Registrazione di tuoi prodotti software IBM in loco con IBM, nello specifico con un servizio Bluemix. -* Raccolta dei dati per i prodotti in loco collegati e dei dati di utilizzo associati. -* Dashboard per i dati di utilizzo del runtime per fornire informazioni approfondite reali sul carico di lavoro e l'utilizzo del tuo prodotto. - - -Per utilizzare le funzionalità {{site.data.keyword.product-insights_full}}, completa le seguenti istruzioni: - -1. Crea almeno un servizio in Bluemix per {{site.data.keyword.product-insights_short}}. -1. Aggiorna i tuoi prodotti software IBM in loco ai livelli di release richiesti e aggiungi l'abilitazione del codice ad ogni installazione del prodotto. -1. Configura l'installazione software con le credenziali {{site.data.keyword.bluemix_short}} della tua istanza del servizio {{site.data.keyword.product-insights_short}}. Tutti i tuoi dati saranno archiviati in modo sicuro con tali credenziali. I dati sono disponibili solo agli utenti con le autorizzazioni corrette per il servizio. - - - -## Come funziona -{: #product-insights_howitworks} -Il servizio {{site.data.keyword.product-insights_full}} si integra con i tuoi prodotti software IBM in loco per raccogliere e visualizzare le informazioni sul prodotto di runtime e le metriche di utilizzo. Inizialmente, una sottoserie di prodotti software IBM è stata abilitata all'integrazione con questo servizio. Quando registrati e collegati, i prodotti software in loco inviano periodicamente informazioni sull'utilizzo e sull'avvio. Le informazioni vengono archiviate in relazione a questa istanza del sevizio tramite le credenziali configurate. Puoi utilizzare il dashboard dell'istanza del servizio per visualizzare le informazioni in Bluemix. - -La soluzione {{site.data.keyword.product-insights_short}} include più componenti, come illustrato nel seguente grafico: - -![Architettura {{site.data.keyword.product-insights_full}}](images/architecture_product-insights.png "Architettura {{site.data.keyword.product-insights_full}}"). - - -## Organizzazioni e spazi -{: #product-insights_orgs} -Il tuo servizio {{site.data.keyword.product-insights_full}} viene associato con un solo spazio o una sola organizzazione Bluemix e ha credenziali univoche. Devi configurare almeno uno spazio o un'organizzazione Bluemix. Se desideri dividere i dati, ad esempio, per limitare l'accesso a utenti specifici, puoi creare più spazi in un'organizzazione con l'istanza del servizio in ogni spazio. Ogni istanza del servizio ha credenziali univoche di cui hai bisogno da fornire ai tuoi prodotti software IBM. - -Le informazioni sui prodotti configurati con una serie di credenziali sono visibili solo nel servizio con tali credenziali. Possono essere creati più servizi per dividere i dati se necessario, ognuno con credenziali univoche. - - -## Dashboard del servizio -{: #service_dashboard} -Dopo aver creato la tua istanza del servizio, vieni indirizzato al dashboard del servizio. Puoi sempre ritornare al dashboard del servizio facendo clic sull'icona del servizio nel tuo dashboard dell'organizzazione. Dal dashboard del servizio, puoi accedere ai seguenti elementi: - -* La documentazione introduttiva -* Le credenziali del servizio di cui hai bisogno per collegare i tuoi prodotti in loco -* Un inventario di prodotti supportati e di istanze di runtime registrato nell'istanza del servizio {{site.data.keyword.product-insights_short}} -* Le informazioni di utilizzo per le istanze di runtime collegate. -* Le informazioni sull'ambiente e sul prodotto per le istanze di runtime collegate. - -Se nessun prodotto è elencato nella scheda Gestione, fai clic su **Registra un prodotto** per visualizzare un elenco di prodotti supportati e i dettagli specifici di accesso per la connessione delle istanze del prodotto. -![Dashboard del servizio senza prodotti registrati](images/NoRegisteredProducts.jpg "Dashboard del servizio senza prodotti registrati") - -## Registra un prodotto -{: #product-insights_register} -Nella scheda **Gestione**, fai clic su **Registra un prodotto** per visualizzare un elenco di prodotti supportati. Scorri fono al tuo prodotto o utilizza il campo di ricerca per filtrare l'elenco dei prodotti. -![Elenco dei prodotti supportati filtrato utilizzando la stringa di ricerca](images/products-filtered.png "Elenco filtrato dei prodotti disponibili alla registrazione") - -Per visualizzare le informazioni sulla registrazione di un'istanza di un prodotto, selezionalo dall'elenco. - -Quando colleghi un'istanza del prodotto al servizio {{site.data.keyword.product-insights_short}}, viene visualizzata nella scheda **Gestione** del dashboard. Un dashboard può elencare più istanze del prodotto collegate in più prodotti differenti. - -## Inventario prodotto -{: #product-insights_products} -Dopo aver abilitato le istanze del prodotto per inviare i dati a {{site.data.keyword.product-insights_short}}, puoi visualizzare il tuo inventario selezionando **Gestione** nel dashboard del servizio. - -![Dashboard del servizio con prodotti e istanze del prodotto](images/productinstances.png "Dashboard del servizio con prodotti e istanze del prodotto") - -Per {{site.data.keyword.product-insights_short}}, un prodotto è diverso da un'istanza del prodotto. Un prodotto ha un nome prodotto, come IBM MQ o IBM WebSphere Application Server Liberty Network Deployment. Un'istanza del prodotto viene utilizzata per rappresentare un prodotto dopo che è stato installato ed è in esecuzione. Alcuni prodotti hanno più istanze eseguite nella stessa installazione del prodotto. Ad esempio, WebSphere Application Server Liberty Network Deployment può eseguire più server delle applicazioni creati da una sola installazione del prodotto. - -Nel dashboard del servizio, i nomi dei prodotti registrati sono visualizzati nella scelta *Visualizza tutto* nel pannello **Prodotti**. Le istanze collegate sono elencate nel pannello **Istanze**. Questo pannello contiene le istanze dei prodotti selezionate nel pannello **Prodotti**. Nel seguente esempio, sono visualizzate tutte le istanze del prodotto perché è selezionata la scelta *Visualizza tutto* nel pannello Prodotti. Questo esempio mostra sei prodotti, alcuni con più istanze collegate. Puoi filtrare l'elenco delle istanze utilizzando il campo **Cerca istanze** o selezionando un prodotto vuoto. Per visualizzare i dettagli di un'istanza del prodotto, selezionane la voce nel pannello **Istanze**. - -L'elenco delle istanze del prodotto visualizzate viene filtrato per la tua esplorazione. Per agevolare la navigazione, viene visualizzato il percorso di esplorazione a un'istanza selezionata. - -![Dashboard del servizio](images/products.png "Dashboard del servizio") - - - -## Informazioni sull'istanza del prodotto -{: #product-insights_productinstances} -Quando viene selezionata un'istanza del prodotto, viene popolato il pannello **Dettagli istanza**. Il pannello mostra i dati di utilizzo, i dettagli del prodotto e le raccomandazioni per l'istanza del prodotto tramite una scheda **Controllo**. - - -## Informazioni sull'utilizzo -{: #product-insights_usage} -Le informazioni sull'utilizzo vengono visualizzate nella scheda **Utilizzo**. Utilizza i due elenchi a discesa per selezionare la metrica da visualizzare (se l'istanza del prodotto invia più di una metrica) e il periodo di tempo di visualizzazione. - -Se l'istanza del prodotto invia più di una metrica, utilizza il primo menu a discesa per selezionare quale metrica visualizzare. Seleziona il periodo di tempo di visualizzazione dal secondo menu a discesa. Le opzioni per il periodo di tempo per le sezioni sono Ultime 24 ore, 1 settimana, 1 mese, 6 mesi, 1 anno. - -La prima sezione mostra massimo medio, medio, minimo medio e totale dei valori della metrica nel periodo di tempo selezionato. La seconda sezione mostra un grafico dei valori nel periodo di tempo con il periodo nell'asse x, che viene modificato in base al periodo di tempo selezionato. Ad esempio, Ultime 24 ore mostra punti del grafico per ogni ora, mentre la visualizzazione 1 settimana li mostra per ogni giorno nell'ultima settimana. L'ultima sezione mostra massimo, medio e minimo per il punto del grafico selezionato. Per visualizzare i valori per un altro punto nel grafico, trascina la barra del tempo in una nuova posizione. - -Viene visualizzato un messaggio se non sono presenti dati per tale periodo di tempo. Ad esempio, un'istanza arrestata potrebbe non fornire dati e non ne saranno visualizzati per il periodo di tempo in cui è stata arrestata. Altri periodi di tempo possono avere utilizzi da visualizzare. Modifica il periodo di tempo nel menu a discesa per visualizzare altri periodi di tempo. - -La scheda **Dettagli** mostra le informazioni sull'istanza del prodotto, che includono i seguenti elementi: - -* La versione e il nome del prodotto -* L'ubicazione in cui il prodotto è installato, inclusi nome host e directory -* L'ultima ora in cui l'istanza ha inviato informazioni sull'avvio -* L'identificativo dell'istanza se il prodotto può avere più istanze in una sola directory - -![Dettagli istanza del prodotto](images/instancedetail.png "Dettagli istanza del prodotto") - -L'istanza del prodotto fornisce inoltre le seguenti informazioni facoltative: - -* Un elenco di APAR installate. -* Il sistema operativo e la sua versione, visualizzata nella scheda **Ambiente**. -![Dettagli istanza del prodotto - Scheda ambiente](images/instancedetails-env.png "Dettagli istanza del prodotto - Scheda ambiente") -* I componenti o le funzioni installate, visualizzati nella scheda **Componenti**. L'esempio non mostra la scheda **Componenti** perché l'istanza di IBM Product XYZ non fornisce alcuna informazione sul componente aggiuntiva. -![Dettagli istanza del prodotto - Scheda componente](images/instancedetails-comps.png "Dettagli istanza del prodotto - Scheda componente") -* L'identificativo univoco dell'istanza del prodotto, che è una combinazione di nome host, directory e identificativo dell'istanza. - - - - -## Ricerca -{: #product-insights_search} -Il pannello **Istanza del prodotto** fornisce una funzionalità di ricerca di base per filtrare l'elenco dei prodotti. Nel campo di ricerca, immetti la stringa che desideri utilizzare per la ricerca. La ricerca può essere effettuata per i dati dell'istanza del prodotto (cioè le informazioni nella scheda **Dettagli**). - - - - - -## Come ottenere supporto per {{site.data.keyword.product-insights_short}} -{: #gettinghelp} - -Le informazioni dettagliate sulla creazione di un servizio, su come ottenere gli aggiornamenti per i prodotti software IBM abilitati e sulle fasi di installazione e configurazione si trovano in [{{site.data.keyword.product-insights_full}} Technical Community](https://developer.ibm.com/product-insights/). Se hai delle domande o dei problemi quando utilizzi {{site.data.keyword.product-insights_short}}, cerca o pubblica una domanda nella sezione dei forum della community. Queste domande sono gestite dal team dei programmi clienti e di sviluppo. - -Puoi anche utilizzare i forum Stack Overflow e IBM DeveloperWorks dw Answers per cercare o pubblicare una domanda. Per domande sul servizio e sulle istruzioni introduttive, utilizza IBM developerWorks dW Answers. Quando pubblichi una domanda in uno di questi forum, applica le seguenti regole di contrassegnazione tramite tag in modo che i team di sviluppo Bluemix possano facilmente visualizzare la tua domanda. - -* Fai clic per pubblicare in [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window}, contrassegna la tua domanda con le tag "ibm-bluemix" e "productinsights". -* Fai clic per pubblicare in [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window}, contrassegna le tue domande con le tag "productinsights" o "hybridconnect". - -Per ulteriori informazioni sull'utilizzo dei forum, consulta l'argomento [Come ottenere supporto](https://www.{DomainName}/docs/support/index.html#getting-help). +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" + +--- + + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# Informazioni su IBM {{site.data.keyword.product-insights_short}} +{: #about_product-insights} + +{{site.data.keyword.product-insights_full}} è un servizio IBM Bluemix, parte di IBM Connect to Cloud. Collega i tuoi prodotti software IBM in loco al tuo servizio {{site.data.keyword.product-insights_short}} e fornisce informazioni approfondite sull'esecuzione dell'inventario e sulle metriche di utilizzo del runtime. + +{:shortdesc} + +Il servizio {{site.data.keyword.product-insights_short}} è un punto di partenza e potrebbero venire aggiunte ulteriori funzioni in futuro. + +{{site.data.keyword.product-insights_short}} fornisce le seguenti funzionalità: + +* Registrazione di tuoi prodotti software IBM in loco con IBM, nello specifico con un servizio Bluemix. +* Raccolta dei dati per i prodotti in loco collegati e dei dati di utilizzo associati. +* Dashboard per i dati di utilizzo del runtime per fornire informazioni approfondite reali sul carico di lavoro e l'utilizzo del tuo prodotto. + + +Per utilizzare le funzionalità {{site.data.keyword.product-insights_full}}, completa le seguenti istruzioni: + +1. Crea almeno un servizio in Bluemix per {{site.data.keyword.product-insights_short}}. +1. Aggiorna i tuoi prodotti software IBM in loco ai livelli di release richiesti e aggiungi l'abilitazione del codice ad ogni installazione del prodotto. +1. Configura l'installazione software con le credenziali {{site.data.keyword.bluemix_short}} della tua istanza del servizio {{site.data.keyword.product-insights_short}}. Tutti i tuoi dati saranno archiviati in modo sicuro con tali credenziali. I dati sono disponibili solo agli utenti con le autorizzazioni corrette per il servizio. + + + +## Come funziona +{: #product-insights_howitworks} +Il servizio {{site.data.keyword.product-insights_full}} si integra con i tuoi prodotti software IBM in loco per raccogliere e visualizzare le informazioni sul prodotto di runtime e le metriche di utilizzo. Inizialmente, una sottoserie di prodotti software IBM è stata abilitata all'integrazione con questo servizio. Quando registrati e collegati, i prodotti software in loco inviano periodicamente informazioni sull'utilizzo e sull'avvio. Le informazioni vengono archiviate in relazione a questa istanza del sevizio tramite le credenziali configurate. Puoi utilizzare il dashboard dell'istanza del servizio per visualizzare le informazioni in Bluemix. + +La soluzione {{site.data.keyword.product-insights_short}} include più componenti, come illustrato nel seguente grafico: + +![Architettura {{site.data.keyword.product-insights_full}}](images/architecture_product-insights.png "Architettura {{site.data.keyword.product-insights_full}}"). + + +## Organizzazioni e spazi +{: #product-insights_orgs} +Il tuo servizio {{site.data.keyword.product-insights_full}} viene associato con un solo spazio o una sola organizzazione Bluemix e ha credenziali univoche. Devi configurare almeno uno spazio o un'organizzazione Bluemix. Se desideri dividere i dati, ad esempio, per limitare l'accesso a utenti specifici, puoi creare più spazi in un'organizzazione con l'istanza del servizio in ogni spazio. Ogni istanza del servizio ha credenziali univoche di cui hai bisogno da fornire ai tuoi prodotti software IBM. + +Le informazioni sui prodotti configurati con una serie di credenziali sono visibili solo nel servizio con tali credenziali. Possono essere creati più servizi per dividere i dati se necessario, ognuno con credenziali univoche. + + +## Dashboard del servizio +{: #service_dashboard} +Dopo aver creato la tua istanza del servizio, vieni indirizzato al dashboard del servizio. Puoi sempre ritornare al dashboard del servizio facendo clic sull'icona del servizio nel tuo dashboard dell'organizzazione. Dal dashboard del servizio, puoi accedere ai seguenti elementi: + +* La documentazione introduttiva +* Le credenziali del servizio di cui hai bisogno per collegare i tuoi prodotti in loco +* Un inventario di prodotti supportati e di istanze di runtime registrato nell'istanza del servizio {{site.data.keyword.product-insights_short}} +* Le informazioni di utilizzo per le istanze di runtime collegate. +* Le informazioni sull'ambiente e sul prodotto per le istanze di runtime collegate. + +Se nessun prodotto è elencato nella scheda Gestione, fai clic su **Registra un prodotto** per visualizzare un elenco di prodotti supportati e i dettagli specifici di accesso per la connessione delle istanze del prodotto. +![Dashboard del servizio senza prodotti registrati](images/NoRegisteredProducts.jpg "Dashboard del servizio senza prodotti registrati") + +## Registra un prodotto +{: #product-insights_register} +Nella scheda **Gestione**, fai clic su **Registra un prodotto** per visualizzare un elenco di prodotti supportati. Scorri fono al tuo prodotto o utilizza il campo di ricerca per filtrare l'elenco dei prodotti. +![Elenco dei prodotti supportati filtrato utilizzando la stringa di ricerca](images/products-filtered.png "Elenco filtrato dei prodotti disponibili alla registrazione") + +Per visualizzare le informazioni sulla registrazione di un'istanza di un prodotto, selezionalo dall'elenco. + +Quando colleghi un'istanza del prodotto al servizio {{site.data.keyword.product-insights_short}}, viene visualizzata nella scheda **Gestione** del dashboard. Un dashboard può elencare più istanze del prodotto collegate in più prodotti differenti. + +## Inventario prodotto +{: #product-insights_products} +Dopo aver abilitato le istanze del prodotto per inviare i dati a {{site.data.keyword.product-insights_short}}, puoi visualizzare il tuo inventario selezionando **Gestione** nel dashboard del servizio. + +![Dashboard del servizio con prodotti e istanze del prodotto](images/productinstances.png "Dashboard del servizio con prodotti e istanze del prodotto") + +Per {{site.data.keyword.product-insights_short}}, un prodotto è diverso da un'istanza del prodotto. Un prodotto ha un nome prodotto, come IBM MQ o IBM WebSphere Application Server Liberty Network Deployment. Un'istanza del prodotto viene utilizzata per rappresentare un prodotto dopo che è stato installato ed è in esecuzione. Alcuni prodotti hanno più istanze eseguite nella stessa installazione del prodotto. Ad esempio, WebSphere Application Server Liberty Network Deployment può eseguire più server delle applicazioni creati da una sola installazione del prodotto. + +Nel dashboard del servizio, i nomi dei prodotti registrati sono visualizzati nella scelta *Visualizza tutto* nel pannello **Prodotti**. Le istanze collegate sono elencate nel pannello **Istanze**. Questo pannello contiene le istanze dei prodotti selezionate nel pannello **Prodotti**. Nel seguente esempio, sono visualizzate tutte le istanze del prodotto perché è selezionata la scelta *Visualizza tutto* nel pannello Prodotti. Questo esempio mostra sei prodotti, alcuni con più istanze collegate. Puoi filtrare l'elenco delle istanze utilizzando il campo **Cerca istanze** o selezionando un prodotto vuoto. Per visualizzare i dettagli di un'istanza del prodotto, selezionane la voce nel pannello **Istanze**. + +L'elenco delle istanze del prodotto visualizzate viene filtrato per la tua esplorazione. Per agevolare la navigazione, viene visualizzato il percorso di esplorazione a un'istanza selezionata. + +![Dashboard del servizio](images/products.png "Dashboard del servizio") + + + +## Informazioni sull'istanza del prodotto +{: #product-insights_productinstances} +Quando viene selezionata un'istanza del prodotto, viene popolato il pannello **Dettagli istanza**. Il pannello mostra i dati di utilizzo, i dettagli del prodotto e le raccomandazioni per l'istanza del prodotto tramite una scheda **Controllo**. + + +## Informazioni sull'utilizzo +{: #product-insights_usage} +Le informazioni sull'utilizzo vengono visualizzate nella scheda **Utilizzo**. Utilizza i due elenchi a discesa per selezionare la metrica da visualizzare (se l'istanza del prodotto invia più di una metrica) e il periodo di tempo di visualizzazione. + +Se l'istanza del prodotto invia più di una metrica, utilizza il primo menu a discesa per selezionare quale metrica visualizzare. Seleziona il periodo di tempo di visualizzazione dal secondo menu a discesa. Le opzioni per il periodo di tempo per le sezioni sono Ultime 24 ore, 1 settimana, 1 mese, 6 mesi, 1 anno. + +La prima sezione mostra massimo medio, medio, minimo medio e totale dei valori della metrica nel periodo di tempo selezionato. La seconda sezione mostra un grafico dei valori nel periodo di tempo con il periodo nell'asse x, che viene modificato in base al periodo di tempo selezionato. Ad esempio, Ultime 24 ore mostra punti del grafico per ogni ora, mentre la visualizzazione 1 settimana li mostra per ogni giorno nell'ultima settimana. L'ultima sezione mostra massimo, medio e minimo per il punto del grafico selezionato. Per visualizzare i valori per un altro punto nel grafico, trascina la barra del tempo in una nuova posizione. + +Viene visualizzato un messaggio se non sono presenti dati per tale periodo di tempo. Ad esempio, un'istanza arrestata potrebbe non fornire dati e non ne saranno visualizzati per il periodo di tempo in cui è stata arrestata. Altri periodi di tempo possono avere utilizzi da visualizzare. Modifica il periodo di tempo nel menu a discesa per visualizzare altri periodi di tempo. + +La scheda **Dettagli** mostra le informazioni sull'istanza del prodotto, che includono i seguenti elementi: + +* La versione e il nome del prodotto +* L'ubicazione in cui il prodotto è installato, inclusi nome host e directory +* L'ultima ora in cui l'istanza ha inviato informazioni sull'avvio +* L'identificativo dell'istanza se il prodotto può avere più istanze in una sola directory + +![Dettagli istanza del prodotto](images/instancedetail.png "Dettagli istanza del prodotto") + +L'istanza del prodotto fornisce inoltre le seguenti informazioni facoltative: + +* Un elenco di APAR installate. +* Il sistema operativo e la sua versione, visualizzata nella scheda **Ambiente**. +![Dettagli istanza del prodotto - Scheda ambiente](images/instancedetails-env.png "Dettagli istanza del prodotto - Scheda ambiente") +* I componenti o le funzioni installate, visualizzati nella scheda **Componenti**. L'esempio non mostra la scheda **Componenti** perché l'istanza di IBM Product XYZ non fornisce alcuna informazione sul componente aggiuntiva. +![Dettagli istanza del prodotto - Scheda componente](images/instancedetails-comps.png "Dettagli istanza del prodotto - Scheda componente") +* L'identificativo univoco dell'istanza del prodotto, che è una combinazione di nome host, directory e identificativo dell'istanza. + + + + +## Ricerca +{: #product-insights_search} +Il pannello **Istanza del prodotto** fornisce una funzionalità di ricerca di base per filtrare l'elenco dei prodotti. Nel campo di ricerca, immetti la stringa che desideri utilizzare per la ricerca. La ricerca può essere effettuata per i dati dell'istanza del prodotto (cioè le informazioni nella scheda **Dettagli**). + + + + + +## Come ottenere supporto per {{site.data.keyword.product-insights_short}} +{: #gettinghelp} + +Le informazioni dettagliate sulla creazione di un servizio, su come ottenere gli aggiornamenti per i prodotti software IBM abilitati e sulle fasi di installazione e configurazione si trovano in [{{site.data.keyword.product-insights_full}} Technical Community](https://developer.ibm.com/product-insights/). Se hai delle domande o dei problemi quando utilizzi {{site.data.keyword.product-insights_short}}, cerca o pubblica una domanda nella sezione dei forum della community. Queste domande sono gestite dal team dei programmi clienti e di sviluppo. + +Puoi anche utilizzare i forum Stack Overflow e IBM DeveloperWorks dw Answers per cercare o pubblicare una domanda. Per domande sul servizio e sulle istruzioni introduttive, utilizza IBM developerWorks dW Answers. Quando pubblichi una domanda in uno di questi forum, applica le seguenti regole di contrassegnazione tramite tag in modo che i team di sviluppo Bluemix possano facilmente visualizzare la tua domanda. + +* Fai clic per pubblicare in [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window}, contrassegna la tua domanda con le tag "ibm-bluemix" e "productinsights". +* Fai clic per pubblicare in [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window}, contrassegna le tue domande con le tag "productinsights" o "hybridconnect". + +Per ulteriori informazioni sull'utilizzo dei forum, consulta l'argomento [Come ottenere supporto](https://www.{DomainName}/docs/support/index.html#getting-help). diff --git a/services/product-insights/nl/ja/index.md b/services/product-insights/nl/ja/index.md index afc2d4d11..55e2ee9a7 100644 --- a/services/product-insights/nl/ja/index.md +++ b/services/product-insights/nl/ja/index.md @@ -1,29 +1,29 @@ ---- -layout: tutorial -title: IBM MobileFirst Foundation 8.0 -breadcrumb_title: 8.0 -use_dropdown: true -print_pdf: false -weight: 0 -show_disqus: false -show_breadcrumb: true ---- - -
      -{{site.data.keys.product_full }} では、事前に統合されたモバイル・アプリケーション・サービスの包括的なセットを使用して、モバイル・アプリケーションのビルド、管理、および更新を大幅に合理化します。 - -開発者は、フロントエンド・フレームワークと好みのツールを使用してアプリケーションをビルドできます。また、サポートされるモバイル・プラットフォームで広い範囲にわたって使用可能な {{site.data.keys.product }} Software Development Kit (SDK) を使用して、アプリケーションにプッシュ、認証、オフライン同期、およびビジネス・ロジックを簡単に追加できます。{{site.data.keys.product }} によって、クライアントからサーバーにアプリケーションを制御できるようになり、それにより、ビジネス・データを相互作用の時点で収集できるようになります。また、{{site.data.keys.product }} アプリケーションによって、アプリケーションのインクリメンタル更新のための合理化された反復可能処理を採用することができ、アプリケーションを柔軟なハイブリッド・クラウド・パターンで実行できます。 - -すべてのカテゴリーとチュートリアルを確認するには、次にアクセスします。 - -* [すべてのチュートリアル](all-tutorials/) - -それぞれの内容については、以下にアクセスします。 - -* [Cordova の開発](cordova-tutorials/) -* [iOS の開発](ios-tutorials/) -* [Android の開発](android-tutorials/) -* [Windows 8.1 Universal および Windows 10 UWP の開発](windows-8-10-tutorials/) -* [Xamarin の開発](xamarin-tutorials/) -* [Web アプリケーションの開発](web-tutorials/) -* [サーバー・サイドの開発](server-side-tutorials/) +--- +layout: tutorial +title: IBM MobileFirst Foundation 8.0 +breadcrumb_title: 8.0 +use_dropdown: true +print_pdf: false +weight: 0 +show_disqus: false +show_breadcrumb: true +--- + +
      +{{site.data.keys.product_full }} では、事前に統合されたモバイル・アプリケーション・サービスの包括的なセットを使用して、モバイル・アプリケーションのビルド、管理、および更新を大幅に合理化します。 + +開発者は、フロントエンド・フレームワークと好みのツールを使用してアプリケーションをビルドできます。また、サポートされるモバイル・プラットフォームで広い範囲にわたって使用可能な {{site.data.keys.product }} Software Development Kit (SDK) を使用して、アプリケーションにプッシュ、認証、オフライン同期、およびビジネス・ロジックを簡単に追加できます。{{site.data.keys.product }} によって、クライアントからサーバーにアプリケーションを制御できるようになり、それにより、ビジネス・データを相互作用の時点で収集できるようになります。また、{{site.data.keys.product }} アプリケーションによって、アプリケーションのインクリメンタル更新のための合理化された反復可能処理を採用することができ、アプリケーションを柔軟なハイブリッド・クラウド・パターンで実行できます。 + +すべてのカテゴリーとチュートリアルを確認するには、次にアクセスします。 + +* [すべてのチュートリアル](all-tutorials/) + +それぞれの内容については、以下にアクセスします。 + +* [Cordova の開発](cordova-tutorials/) +* [iOS の開発](ios-tutorials/) +* [Android の開発](android-tutorials/) +* [Windows 8.1 Universal および Windows 10 UWP の開発](windows-8-10-tutorials/) +* [Xamarin の開発](xamarin-tutorials/) +* [Web アプリケーションの開発](web-tutorials/) +* [サーバー・サイドの開発](server-side-tutorials/) diff --git a/services/product-insights/nl/ko/index.md b/services/product-insights/nl/ko/index.md index be1471acd..cbd289b92 100644 --- a/services/product-insights/nl/ko/index.md +++ b/services/product-insights/nl/ko/index.md @@ -1,50 +1,50 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# {{site.data.keyword.product-insights_short}} 시작하기 -{: #product-insights} - -{{site.data.keyword.product-insights_full}}는 온프레미스 IBM 소프트웨어 제품과 연결되어 교차 제품 인벤토리를 구축하고 제품 사용 메트릭에 대한 인사이트를 제공합니다. - -{:shortdesc} - -{{site.data.keyword.product-insights_short}} 서비스는 IBM Bluemix 내에서 실행되며 사용 가능한 온프레미스 IBM 소프트웨어 제품의 정보를 수신합니다. 이 정보는 서비스 인스턴스 대시보드 내에 표시됩니다. 서비스를 사용하려면 Bluemix 계정이 있어야 하고 조직 및 영역에서 서비스를 작성해야 합니다. 사용 가능한 온프레미스 제품에 대한 제품 및 사용 정보는 안전하게 저장되며 해당 고유 서비스의 범위 또는 컨텍스트 내에서 표시됩니다. - -팁: 간단하게 처리할 수 있도록 처음에는 단일 서비스 인스턴스를 사용할 수 있습니다. - -{{site.data.keyword.product-insights_short}}를 시작하려면 다음 단계를 완료하십시오. - -1. **관리** 탭에서 **제품 등록** 단추를 클릭하여 지원되는 제품 목록 및 필수 버전 레벨을 확인하십시오. 각 제품 유형에 대한 지시사항이 제공되어 온프레미스 제품 인스턴스를 {{site.data.keyword.product-insights_short}} 서비스에 연결할 수 있습니다. 필요한 경우, 사용 가능한 온프레미스 IBM 소프트웨어 제품을 최소 전제조건 레벨로 업데이트하십시오. 최소 지원 레벨이 필요한 제품의 경우, 수정팩 또는 임시 수정사항을 설치하여 {{site.data.keyword.product-insights_short}}와 통합하십시오. -2. 사용 가능한 온프레미스 IBM 소프트웨어 제품을 {{site.data.keyword.product-insights_short}} 서비스에 연결하십시오. 각 제품에 대한 구성 프로세스의 일부로 서비스 신임 정보(즉, apikey 및 apihost)가 필요합니다. 서비스 대시보드의 **서비스 신임 정보** 탭에서 서비스 신임 정보를 찾을 수 있습니다. -3. 각 제품 인스턴스를 사용으로 설정하고 연결한 후 제품 또는 제품 인스턴스를 시작하거나 재시작하여 제품 및 사용 정보를 {{site.data.keyword.product-insights_short}} 서비스에 제공해야 합니다. - -제품 사용 설정, 각 제품에 필요한 최소 지원 레벨, 각 제품을 {{site.data.keyword.product-insights_short}}와 통합하는 방법에 대한 세부사항은 {{site.data.keyword.product-insights_full}} [Technical Community](https://developer.ibm.com/product-insights/)에 참여하여 확인하십시오. - -서비스 대시보드에서 **관리**를 선택하여 인벤토리를 볼 수 있습니다. - -* 서비스 대시보드에서 연결된 제품의 이름은 **제품** 분할창에 나열됩니다. -* 모든 제품 인스턴스를 표시하려면 **모두 보기**를 선택하십시오. 제품에 대한 제품 인스턴스를 표시하려면 **제품** 분할창에서 제품을 선택하십시오. **인스턴스** 분할창에 제품 인스턴스가 표시됩니다. -* 단일 제품 인스턴스에 대한 세부사항을 표시하려면 **인스턴스** 분할창에서 제품 인스턴스를 선택하십시오. **세부사항** 분할창이 채워집니다. **세부사항** 분할창에 제품 인스턴스의 세부사항 및 인스턴스에서 전송한 사용 정보가 표시됩니다. -* **사용** 탭에 그래픽 형식의 제품 사용 정보가 표시됩니다. 제품에 따라 표시할 정보 유형 및 샘플링 기간을 지정할 수 있습니다. -* **세부사항** 탭에 제품 정보, 환경 정보 및 컴포넌트 정보가 포함된 제품 인스턴스 정보가 표시됩니다. -* **서비스** 탭의 **어드바이저** 탭에는 현재 제품 인스턴스와 관련하여 이점이 될 수 있는 추가 서비스에 대한 세부사항이 제공됩니다. **업데이트** 탭에는 제품 인스턴스 버전 레벨 및 통화에 대한 정보가 제공됩니다. - - - - - - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# {{site.data.keyword.product-insights_short}} 시작하기 +{: #product-insights} + +{{site.data.keyword.product-insights_full}}는 온프레미스 IBM 소프트웨어 제품과 연결되어 교차 제품 인벤토리를 구축하고 제품 사용 메트릭에 대한 인사이트를 제공합니다. + +{:shortdesc} + +{{site.data.keyword.product-insights_short}} 서비스는 IBM Bluemix 내에서 실행되며 사용 가능한 온프레미스 IBM 소프트웨어 제품의 정보를 수신합니다. 이 정보는 서비스 인스턴스 대시보드 내에 표시됩니다. 서비스를 사용하려면 Bluemix 계정이 있어야 하고 조직 및 영역에서 서비스를 작성해야 합니다. 사용 가능한 온프레미스 제품에 대한 제품 및 사용 정보는 안전하게 저장되며 해당 고유 서비스의 범위 또는 컨텍스트 내에서 표시됩니다. + +팁: 간단하게 처리할 수 있도록 처음에는 단일 서비스 인스턴스를 사용할 수 있습니다. + +{{site.data.keyword.product-insights_short}}를 시작하려면 다음 단계를 완료하십시오. + +1. **관리** 탭에서 **제품 등록** 단추를 클릭하여 지원되는 제품 목록 및 필수 버전 레벨을 확인하십시오. 각 제품 유형에 대한 지시사항이 제공되어 온프레미스 제품 인스턴스를 {{site.data.keyword.product-insights_short}} 서비스에 연결할 수 있습니다. 필요한 경우, 사용 가능한 온프레미스 IBM 소프트웨어 제품을 최소 전제조건 레벨로 업데이트하십시오. 최소 지원 레벨이 필요한 제품의 경우, 수정팩 또는 임시 수정사항을 설치하여 {{site.data.keyword.product-insights_short}}와 통합하십시오. +2. 사용 가능한 온프레미스 IBM 소프트웨어 제품을 {{site.data.keyword.product-insights_short}} 서비스에 연결하십시오. 각 제품에 대한 구성 프로세스의 일부로 서비스 신임 정보(즉, apikey 및 apihost)가 필요합니다. 서비스 대시보드의 **서비스 신임 정보** 탭에서 서비스 신임 정보를 찾을 수 있습니다. +3. 각 제품 인스턴스를 사용으로 설정하고 연결한 후 제품 또는 제품 인스턴스를 시작하거나 재시작하여 제품 및 사용 정보를 {{site.data.keyword.product-insights_short}} 서비스에 제공해야 합니다. + +제품 사용 설정, 각 제품에 필요한 최소 지원 레벨, 각 제품을 {{site.data.keyword.product-insights_short}}와 통합하는 방법에 대한 세부사항은 {{site.data.keyword.product-insights_full}} [Technical Community](https://developer.ibm.com/product-insights/)에 참여하여 확인하십시오. + +서비스 대시보드에서 **관리**를 선택하여 인벤토리를 볼 수 있습니다. + +* 서비스 대시보드에서 연결된 제품의 이름은 **제품** 분할창에 나열됩니다. +* 모든 제품 인스턴스를 표시하려면 **모두 보기**를 선택하십시오. 제품에 대한 제품 인스턴스를 표시하려면 **제품** 분할창에서 제품을 선택하십시오. **인스턴스** 분할창에 제품 인스턴스가 표시됩니다. +* 단일 제품 인스턴스에 대한 세부사항을 표시하려면 **인스턴스** 분할창에서 제품 인스턴스를 선택하십시오. **세부사항** 분할창이 채워집니다. **세부사항** 분할창에 제품 인스턴스의 세부사항 및 인스턴스에서 전송한 사용 정보가 표시됩니다. +* **사용** 탭에 그래픽 형식의 제품 사용 정보가 표시됩니다. 제품에 따라 표시할 정보 유형 및 샘플링 기간을 지정할 수 있습니다. +* **세부사항** 탭에 제품 정보, 환경 정보 및 컴포넌트 정보가 포함된 제품 인스턴스 정보가 표시됩니다. +* **서비스** 탭의 **어드바이저** 탭에는 현재 제품 인스턴스와 관련하여 이점이 될 수 있는 추가 서비스에 대한 세부사항이 제공됩니다. **업데이트** 탭에는 제품 인스턴스 버전 레벨 및 통화에 대한 정보가 제공됩니다. + + + + + + + + + + diff --git a/services/product-insights/nl/ko/product-insights_overview.md b/services/product-insights/nl/ko/product-insights_overview.md index 54763a6ad..488686eb5 100644 --- a/services/product-insights/nl/ko/product-insights_overview.md +++ b/services/product-insights/nl/ko/product-insights_overview.md @@ -1,145 +1,145 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" - ---- - - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# IBM {{site.data.keyword.product-insights_short}} 정보 -{: #about_product-insights} - -{{site.data.keyword.product-insights_full}}는 IBM Bluemix 서비스이며 IBM Connect to Cloud의 일부분입니다. 이는 온프레미스 IBM 소프트웨어 제품을 {{site.data.keyword.product-insights_short}} 서비스에 연결하고 실행 인벤토리와 런타임 사용 메트릭에 대한 인사이트를 제공합니다. - -{:shortdesc} - -{{site.data.keyword.product-insights_short}} 서비스는 엔트리 포인트이며 향후 기능이 추가될 수 있습니다. - -{{site.data.keyword.product-insights_short}}는 다음 기능을 제공합니다. - -* 온프레미스 IBM 소프트웨어 제품을 IBM, 특히 Bluemix 서비스에 등록. -* 연결된 온프레미스 제품 및 연관된 사용 데이터에 대한 데이터 콜렉션. -* 제품 사용 및 워크로드에 대한 실제 인사이트를 제공하는 런타임 사용 데이터에 대한 대시보드. - - -{{site.data.keyword.product-insights_full}} 기능을 사용하려면 다음 단계를 완료하십시오. - -1. Bluemix에서 {{site.data.keyword.product-insights_short}}를 위한 하나 이상의 서비스를 작성하십시오. -1. 온프레미스 IBM 소프트웨어 제품을 필수 릴리스 레벨로 업그레이드하고 각 제품 설치에 대한 인에이블먼트 코드를 추가하십시오. -1. {{site.data.keyword.product-insights_short}} 서비스 인스턴스에 대한 {{site.data.keyword.bluemix_short}} 신임 정보를 사용하여 소프트웨어 설치를 구성하십시오. 모든 데이터가 이러한 신임 정보를 사용하여 안전하게 저장됩니다. 데이터는 서비스에 대한 올바른 권한을 가진 개인만 사용할 수 있습니다. - - - -## 작동 방식 -{: #product-insights_howitworks} -{{site.data.keyword.product-insights_full}} 서비스는 온프레미스 IBM 소프트웨어 제품과 통합되어 런타임 제품 정보 및 사용 메트릭을 수집하고 표시합니다. 처음에, 이 서비스와 통합되도록 IBM 소프트웨어 제품의 서브세트가 사용 설정됩니다. 등록 및 연결된 온프레미스 소프트웨어 제품은 시작과 사용 정보를 주기적으로 전송합니다. 구성된 신임 정보를 통해 이 서비스 인스턴스에 대한 정보가 저장됩니다. 서비스 인스턴스 대시보드를 사용하여 Bluemix 내에서 정보를 볼 수 있습니다. - -{{site.data.keyword.product-insights_short}} 솔루션은 다음 그래픽과 같이 여러 컴포넌트를 포함합니다. - -![{{site.data.keyword.product-insights_full}} 아키텍처](images/architecture_product-insights.png "{{site.data.keyword.product-insights_full}} 아키텍처"). - - -## 조직 및 영역 -{: #product-insights_orgs} -{{site.data.keyword.product-insights_full}} 서비스는 단일 Bluemix 조직 및 영역과 연관되어 있으며 고유 신임 정보를 갖습니다. 하나 이상의 Bluemix 조직 및 영역을 설정해야 합니다. 예를 들어, 액세스를 특정 개인으로 제한하기 위해 데이터를 구분하려는 경우, 각 영역마다 하나의 서비스 인스턴스가 있는 여러 영역을 하나의 조직 안에 작성할 수 있습니다. 각 서비스 인스턴스에는 IBM 소프트웨어 제품에 대해 제공해야 하는 고유 신임 정보가 있습니다. - -신임 정보 세트로 구성된 제품에 대한 정보는 해당 신임 정보를 사용하는 서비스 내에서만 볼 수 있습니다. 필요한 경우, 각각 고유한 신임 정보를 갖는 여러 서비스를 작성하여 데이터를 구분할 수 있습니다. - - -## 서비스 대시보드 -{: #service_dashboard} -서비스 인스턴스를 작성하면 서비스 대시보드로 이동합니다. 언제든 조직 대시보드에서 서비스 아이콘을 클릭하여 서비스 대시보드로 돌아갈 수 있습니다. 서비스 대시보드에서 다음 항목에 액세스할 수 있습니다. - -* 시작하기 문서 -* 온프레미스 제품의 연결에 필요한 서비스 신임 정보 -* {{site.data.keyword.product-insights_short}} 서비스 인스턴스에 등록된 런타임 인스턴스 및 지원되는 제품의 인벤토리 -* 연결된 런타임 인스턴스에 대한 사용 정보 -* 연결된 런타임 인스턴스에 대한 제품 및 환경 정보 - -관리 탭에 나열된 제품이 없는 경우 **제품 등록**을 클릭하여 지원되는 제품 목록을 확인하고 제품 인스턴스 연결에 대한 특정 세부사항에 액세스하십시오. -![등록된 제품이 없는 서비스 대시보드](images/NoRegisteredProducts.jpg "등록된 제품이 없는 서비스 대시보드") - -## 제품 등록 -{: #product-insights_register} -**관리** 탭에서 **제품 등록**을 클릭하여 지원되는 제품 목록을 확인하십시오. 스크롤하여 제품을 찾거나 검색 필드를 사용하여 제품 목록을 필터링하십시오. -![검색 문자열을 사용하여 필터링된 지원되는 제품 목록](images/products-filtered.png "등록 가능한 제품의 필터링된 목록") - -제품 인스턴스 등록에 대한 지시사항을 보려면 해당 항목을 목록에서 선택하십시오. - -제품 인스턴스를 {{site.data.keyword.product-insights_short}} 서비스에 연결하면 대시보드의 **관리** 탭에 표시됩니다. 대시보드는 여러 제품에 걸쳐 복수의 연결된 제품 인스턴스를 나열할 수 있습니다. - -## 제품 인벤토리 -{: #product-insights_products} -제품 인스턴스를 사용하도록 설정하여 데이터를 {{site.data.keyword.product-insights_short}}로 전송하면 서비스 대시보드에서 **관리**를 선택하여 인벤토리를 볼 수 있습니다. - -![제품 및 제품 인스턴스가 포함된 서비스 대시보드](images/productinstances.png "제품 및 제품 인스턴스가 포함된 서비스 대시보드") - -{{site.data.keyword.product-insights_short}}에서 제품은 제품 인스턴스와 다릅니다. 제품에는 IBM MQ 또는 IBM WebSphere Application Server Liberty Network Deployment와 같은 제품 이름이 있습니다. 제품 인스턴스는 제품을 설치하고 실행한 후 제품을 나타내는 데 사용됩니다. 일부 제품에는 동일한 제품 설치 내에서 실행되는 여러 인스턴스가 있습니다. 예를 들어, WebSphere Application Server Liberty Network Deployment는 제품의 단일 설치에서 작성된 여러 애플리케이션 서버를 실행할 수 있습니다. - -서비스 대시보드에서 등록된 제품의 이름은 **제품** 분할창의 *모두 보기* 선택사항 아래에 표시됩니다. 연결된 인스턴스는 **인스턴스** 분할창에 나열됩니다. 이 분할창에는 **제품** 분할창에서 선택한 제품의 인스턴스가 포함됩니다. 다음 예에서 *모두 보기* 선택사항이 제품 분할창에서 선택되어 있으므로 모든 제품 인스턴스가 표시됩니다. 이 예에서는 6개의 제품을 표시하며, 이 중 일부에는 여러 인스턴스가 연결되어 있습니다. **인스턴스 검색** 필드를 사용하거나 제품 항목을 선택하여 인스턴스 목록을 필터링할 수 있습니다. 제품 인스턴스에 대한 세부사항을 보려면 **인스턴스** 분할창에서 해당 항목을 선택하십시오. - -찾아보기 시 표시된 제품 인스턴스의 목록이 필터링됩니다. 탐색을 돕기 위해, 선택한 인스턴스에 대한 과거의 찾아보기 경로가 표시됩니다. - -![서비스 대시보드](images/products.png "서비스 대시보드") - - - -## 제품 인스턴스 정보 -{: #product-insights_productinstances} -제품 인스턴스를 선택하면 **인스턴스 세부사항** 분할창이 채워집니다. 이 분할창은 사용 데이터, 제품 세부사항 그리고 **어드바이저** 탭을 통해 제품 인스턴스에 대한 권장사항을 표시합니다. - - -## 사용 정보 -{: #product-insights_usage} -사용 정보는 **사용** 탭에 표시됩니다. 두 개의 드롭 다운 목록을 사용하여 표시할 메트릭(제품 인스턴스가 둘 이상의 메트릭을 전송하는 경우) 및 표시할 기간을 선택하십시오. - -제품 인스턴스가 둘 이상의 메트릭을 전송하는 경우 첫 번째 드롭 다운을 사용하여 표시할 메트릭을 선택하십시오. 두 번째 드롭 다운에서 표시할 기간을 선택하십시오. 섹션의 기간에 대한 옵션은 지난 24시간, 1주, 1개월, 6개월, 1년입니다. - -첫 번째 섹션에는 선택한 기간에 대한 메트릭 값의 평균 최대, 평균, 평균 최소 및 총계가 표시됩니다. 두 번째 섹션에는 x축을 기간으로 하는 기간 내 값의 그래프가 표시되며 선택한 기간에 따라 변경됩니다. 예를 들어, 지난 24시간은 각 시간에 대한 그래프 점을 표시하는 반면 1주는 해당 주 내 각 요일에 대한 그래프 점을 표시합니다. 마지막 섹션에는 선택한 그래프 점의 최대값, 평균 및 최소값이 표시됩니다. 그래프에 다른 점의 값을 표시하려면 시간 표시줄을 새 위치로 끌어오십시오. - -해당 기간에 대한 데이터가 없는 경우 메시지가 표시됩니다. 예를 들어, 중지된 인스턴스는 데이터를 제공하지 않으며 중지된 기간에 대한 데이터는 표시되지 않습니다. 다른 기간에는 표시할 사용 정보가 있을 수 있습니다. 다른 기간을 표시하려면 드롭 다운에서 기간을 변경하십시오. - -**세부사항** 탭은 제품 인스턴스 정보를 표시하며 다음과 같은 항목을 포함할 수 있습니다. - -* 제품 이름 및 버전 -* 제품이 설치된 위치(호스트 이름 및 디렉토리 포함) -* 인스턴스가 시작 시 정보를 전송한 마지막 시간 -* 인스턴스 ID(제품이 단일 디렉토리 내에 여러 인스턴스를 가질 경우) - -![제품 인스턴스 세부사항](images/instancedetail.png "제품 인스턴스 세부사항") - -제품 인스턴스는 다음 선택적 정보도 제공합니다. - -* 설치된 APAR 목록. -* **환경** 탭에 표시되는 운영 체제 및 해당 버전. -![제품 인스턴스 세부사항 - 환경 탭](images/instancedetails-env.png "제품 인스턴스 세부사항 - 환경 탭") -* **컴포넌트** 탭에 표시되는 컴포넌트 또는 설치된 기능. IBM 제품 XYZ의 인스턴스가 추가 컴포넌트 정보를 제공하지 않으므로 예에서는 **컴포넌트** 탭이 표시되지 않습니다. -![제품 인스턴스 세부사항 - 컴포넌트 탭](images/instancedetails-comps.png "제품 인스턴스 세부사항 - 컴포넌트 탭") -* 호스트 이름, 디렉토리 및 인스턴스 ID의 조합인, 제품 인스턴스에 대한 고유 ID. - - - - -## 검색 -{: #product-insights_search} -**제품 인스턴스** 분할창에는 제품 목록을 필터링하는 기본 검색 기능이 제공됩니다. 검색 필드에 검색에 사용할 문자열을 입력하십시오. 검색은 제품 인스턴스 데이터(즉, **세부사항** 탭의 정보)에 대해서만 수행될 수 있습니다. - - - - - -## {{site.data.keyword.product-insights_short}}에 대한 도움 받기 -{: #gettinghelp} - -서비스 작성, 사용 가능한 IBM 소프트웨어 제품에 대한 업데이트 가져오기 및 설치와 구성 단계에 대한 자세한 정보는 [{{site.data.keyword.product-insights_full}}Technical Community](https://developer.ibm.com/product-insights/)에 있습니다. {{site.data.keyword.product-insights_short}}를 사용하면서 문제점 또는 질문이 있는 경우, 커뮤니티의 포럼 섹션에서 질문을 보거나 게시하십시오. 이러한 질문은 개발 및 고객 프로그램 팀에서 처리합니다. - -또한 Stack Overflow 및 IBM DeveloperWorks dw Answers 포럼을 사용하여 질문을 보거나 게시할 수 있습니다. 서비스 및 시작하기 지시사항에 대한 질문은 IBM developerWorks dW Answers를 사용하십시오. 이 두 개의 포럼 중 하나에 질문을 게시하는 경우 Bluemix 개발 팀이 질문을 쉽게 볼 수 있도록 다음 태그 지정 규칙을 적용하십시오. - -* [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window}에 게시하려면 클릭하고 "ibm-bluemix" 및 "productinsights"로 질문에 태그를 지정하십시오. -* [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window}에 게시하려면 클릭하고 "productinsights" 또는 "hybridconnect"로 질문에 태그를 지정하십시오. - -포럼 사용에 대한 자세한 정보는 [도움 받기](https://www.{DomainName}/docs/support/index.html#getting-help) 주제를 참조하십시오. +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" + +--- + + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# IBM {{site.data.keyword.product-insights_short}} 정보 +{: #about_product-insights} + +{{site.data.keyword.product-insights_full}}는 IBM Bluemix 서비스이며 IBM Connect to Cloud의 일부분입니다. 이는 온프레미스 IBM 소프트웨어 제품을 {{site.data.keyword.product-insights_short}} 서비스에 연결하고 실행 인벤토리와 런타임 사용 메트릭에 대한 인사이트를 제공합니다. + +{:shortdesc} + +{{site.data.keyword.product-insights_short}} 서비스는 엔트리 포인트이며 향후 기능이 추가될 수 있습니다. + +{{site.data.keyword.product-insights_short}}는 다음 기능을 제공합니다. + +* 온프레미스 IBM 소프트웨어 제품을 IBM, 특히 Bluemix 서비스에 등록. +* 연결된 온프레미스 제품 및 연관된 사용 데이터에 대한 데이터 콜렉션. +* 제품 사용 및 워크로드에 대한 실제 인사이트를 제공하는 런타임 사용 데이터에 대한 대시보드. + + +{{site.data.keyword.product-insights_full}} 기능을 사용하려면 다음 단계를 완료하십시오. + +1. Bluemix에서 {{site.data.keyword.product-insights_short}}를 위한 하나 이상의 서비스를 작성하십시오. +1. 온프레미스 IBM 소프트웨어 제품을 필수 릴리스 레벨로 업그레이드하고 각 제품 설치에 대한 인에이블먼트 코드를 추가하십시오. +1. {{site.data.keyword.product-insights_short}} 서비스 인스턴스에 대한 {{site.data.keyword.bluemix_short}} 신임 정보를 사용하여 소프트웨어 설치를 구성하십시오. 모든 데이터가 이러한 신임 정보를 사용하여 안전하게 저장됩니다. 데이터는 서비스에 대한 올바른 권한을 가진 개인만 사용할 수 있습니다. + + + +## 작동 방식 +{: #product-insights_howitworks} +{{site.data.keyword.product-insights_full}} 서비스는 온프레미스 IBM 소프트웨어 제품과 통합되어 런타임 제품 정보 및 사용 메트릭을 수집하고 표시합니다. 처음에, 이 서비스와 통합되도록 IBM 소프트웨어 제품의 서브세트가 사용 설정됩니다. 등록 및 연결된 온프레미스 소프트웨어 제품은 시작과 사용 정보를 주기적으로 전송합니다. 구성된 신임 정보를 통해 이 서비스 인스턴스에 대한 정보가 저장됩니다. 서비스 인스턴스 대시보드를 사용하여 Bluemix 내에서 정보를 볼 수 있습니다. + +{{site.data.keyword.product-insights_short}} 솔루션은 다음 그래픽과 같이 여러 컴포넌트를 포함합니다. + +![{{site.data.keyword.product-insights_full}} 아키텍처](images/architecture_product-insights.png "{{site.data.keyword.product-insights_full}} 아키텍처"). + + +## 조직 및 영역 +{: #product-insights_orgs} +{{site.data.keyword.product-insights_full}} 서비스는 단일 Bluemix 조직 및 영역과 연관되어 있으며 고유 신임 정보를 갖습니다. 하나 이상의 Bluemix 조직 및 영역을 설정해야 합니다. 예를 들어, 액세스를 특정 개인으로 제한하기 위해 데이터를 구분하려는 경우, 각 영역마다 하나의 서비스 인스턴스가 있는 여러 영역을 하나의 조직 안에 작성할 수 있습니다. 각 서비스 인스턴스에는 IBM 소프트웨어 제품에 대해 제공해야 하는 고유 신임 정보가 있습니다. + +신임 정보 세트로 구성된 제품에 대한 정보는 해당 신임 정보를 사용하는 서비스 내에서만 볼 수 있습니다. 필요한 경우, 각각 고유한 신임 정보를 갖는 여러 서비스를 작성하여 데이터를 구분할 수 있습니다. + + +## 서비스 대시보드 +{: #service_dashboard} +서비스 인스턴스를 작성하면 서비스 대시보드로 이동합니다. 언제든 조직 대시보드에서 서비스 아이콘을 클릭하여 서비스 대시보드로 돌아갈 수 있습니다. 서비스 대시보드에서 다음 항목에 액세스할 수 있습니다. + +* 시작하기 문서 +* 온프레미스 제품의 연결에 필요한 서비스 신임 정보 +* {{site.data.keyword.product-insights_short}} 서비스 인스턴스에 등록된 런타임 인스턴스 및 지원되는 제품의 인벤토리 +* 연결된 런타임 인스턴스에 대한 사용 정보 +* 연결된 런타임 인스턴스에 대한 제품 및 환경 정보 + +관리 탭에 나열된 제품이 없는 경우 **제품 등록**을 클릭하여 지원되는 제품 목록을 확인하고 제품 인스턴스 연결에 대한 특정 세부사항에 액세스하십시오. +![등록된 제품이 없는 서비스 대시보드](images/NoRegisteredProducts.jpg "등록된 제품이 없는 서비스 대시보드") + +## 제품 등록 +{: #product-insights_register} +**관리** 탭에서 **제품 등록**을 클릭하여 지원되는 제품 목록을 확인하십시오. 스크롤하여 제품을 찾거나 검색 필드를 사용하여 제품 목록을 필터링하십시오. +![검색 문자열을 사용하여 필터링된 지원되는 제품 목록](images/products-filtered.png "등록 가능한 제품의 필터링된 목록") + +제품 인스턴스 등록에 대한 지시사항을 보려면 해당 항목을 목록에서 선택하십시오. + +제품 인스턴스를 {{site.data.keyword.product-insights_short}} 서비스에 연결하면 대시보드의 **관리** 탭에 표시됩니다. 대시보드는 여러 제품에 걸쳐 복수의 연결된 제품 인스턴스를 나열할 수 있습니다. + +## 제품 인벤토리 +{: #product-insights_products} +제품 인스턴스를 사용하도록 설정하여 데이터를 {{site.data.keyword.product-insights_short}}로 전송하면 서비스 대시보드에서 **관리**를 선택하여 인벤토리를 볼 수 있습니다. + +![제품 및 제품 인스턴스가 포함된 서비스 대시보드](images/productinstances.png "제품 및 제품 인스턴스가 포함된 서비스 대시보드") + +{{site.data.keyword.product-insights_short}}에서 제품은 제품 인스턴스와 다릅니다. 제품에는 IBM MQ 또는 IBM WebSphere Application Server Liberty Network Deployment와 같은 제품 이름이 있습니다. 제품 인스턴스는 제품을 설치하고 실행한 후 제품을 나타내는 데 사용됩니다. 일부 제품에는 동일한 제품 설치 내에서 실행되는 여러 인스턴스가 있습니다. 예를 들어, WebSphere Application Server Liberty Network Deployment는 제품의 단일 설치에서 작성된 여러 애플리케이션 서버를 실행할 수 있습니다. + +서비스 대시보드에서 등록된 제품의 이름은 **제품** 분할창의 *모두 보기* 선택사항 아래에 표시됩니다. 연결된 인스턴스는 **인스턴스** 분할창에 나열됩니다. 이 분할창에는 **제품** 분할창에서 선택한 제품의 인스턴스가 포함됩니다. 다음 예에서 *모두 보기* 선택사항이 제품 분할창에서 선택되어 있으므로 모든 제품 인스턴스가 표시됩니다. 이 예에서는 6개의 제품을 표시하며, 이 중 일부에는 여러 인스턴스가 연결되어 있습니다. **인스턴스 검색** 필드를 사용하거나 제품 항목을 선택하여 인스턴스 목록을 필터링할 수 있습니다. 제품 인스턴스에 대한 세부사항을 보려면 **인스턴스** 분할창에서 해당 항목을 선택하십시오. + +찾아보기 시 표시된 제품 인스턴스의 목록이 필터링됩니다. 탐색을 돕기 위해, 선택한 인스턴스에 대한 과거의 찾아보기 경로가 표시됩니다. + +![서비스 대시보드](images/products.png "서비스 대시보드") + + + +## 제품 인스턴스 정보 +{: #product-insights_productinstances} +제품 인스턴스를 선택하면 **인스턴스 세부사항** 분할창이 채워집니다. 이 분할창은 사용 데이터, 제품 세부사항 그리고 **어드바이저** 탭을 통해 제품 인스턴스에 대한 권장사항을 표시합니다. + + +## 사용 정보 +{: #product-insights_usage} +사용 정보는 **사용** 탭에 표시됩니다. 두 개의 드롭 다운 목록을 사용하여 표시할 메트릭(제품 인스턴스가 둘 이상의 메트릭을 전송하는 경우) 및 표시할 기간을 선택하십시오. + +제품 인스턴스가 둘 이상의 메트릭을 전송하는 경우 첫 번째 드롭 다운을 사용하여 표시할 메트릭을 선택하십시오. 두 번째 드롭 다운에서 표시할 기간을 선택하십시오. 섹션의 기간에 대한 옵션은 지난 24시간, 1주, 1개월, 6개월, 1년입니다. + +첫 번째 섹션에는 선택한 기간에 대한 메트릭 값의 평균 최대, 평균, 평균 최소 및 총계가 표시됩니다. 두 번째 섹션에는 x축을 기간으로 하는 기간 내 값의 그래프가 표시되며 선택한 기간에 따라 변경됩니다. 예를 들어, 지난 24시간은 각 시간에 대한 그래프 점을 표시하는 반면 1주는 해당 주 내 각 요일에 대한 그래프 점을 표시합니다. 마지막 섹션에는 선택한 그래프 점의 최대값, 평균 및 최소값이 표시됩니다. 그래프에 다른 점의 값을 표시하려면 시간 표시줄을 새 위치로 끌어오십시오. + +해당 기간에 대한 데이터가 없는 경우 메시지가 표시됩니다. 예를 들어, 중지된 인스턴스는 데이터를 제공하지 않으며 중지된 기간에 대한 데이터는 표시되지 않습니다. 다른 기간에는 표시할 사용 정보가 있을 수 있습니다. 다른 기간을 표시하려면 드롭 다운에서 기간을 변경하십시오. + +**세부사항** 탭은 제품 인스턴스 정보를 표시하며 다음과 같은 항목을 포함할 수 있습니다. + +* 제품 이름 및 버전 +* 제품이 설치된 위치(호스트 이름 및 디렉토리 포함) +* 인스턴스가 시작 시 정보를 전송한 마지막 시간 +* 인스턴스 ID(제품이 단일 디렉토리 내에 여러 인스턴스를 가질 경우) + +![제품 인스턴스 세부사항](images/instancedetail.png "제품 인스턴스 세부사항") + +제품 인스턴스는 다음 선택적 정보도 제공합니다. + +* 설치된 APAR 목록. +* **환경** 탭에 표시되는 운영 체제 및 해당 버전. +![제품 인스턴스 세부사항 - 환경 탭](images/instancedetails-env.png "제품 인스턴스 세부사항 - 환경 탭") +* **컴포넌트** 탭에 표시되는 컴포넌트 또는 설치된 기능. IBM 제품 XYZ의 인스턴스가 추가 컴포넌트 정보를 제공하지 않으므로 예에서는 **컴포넌트** 탭이 표시되지 않습니다. +![제품 인스턴스 세부사항 - 컴포넌트 탭](images/instancedetails-comps.png "제품 인스턴스 세부사항 - 컴포넌트 탭") +* 호스트 이름, 디렉토리 및 인스턴스 ID의 조합인, 제품 인스턴스에 대한 고유 ID. + + + + +## 검색 +{: #product-insights_search} +**제품 인스턴스** 분할창에는 제품 목록을 필터링하는 기본 검색 기능이 제공됩니다. 검색 필드에 검색에 사용할 문자열을 입력하십시오. 검색은 제품 인스턴스 데이터(즉, **세부사항** 탭의 정보)에 대해서만 수행될 수 있습니다. + + + + + +## {{site.data.keyword.product-insights_short}}에 대한 도움 받기 +{: #gettinghelp} + +서비스 작성, 사용 가능한 IBM 소프트웨어 제품에 대한 업데이트 가져오기 및 설치와 구성 단계에 대한 자세한 정보는 [{{site.data.keyword.product-insights_full}}Technical Community](https://developer.ibm.com/product-insights/)에 있습니다. {{site.data.keyword.product-insights_short}}를 사용하면서 문제점 또는 질문이 있는 경우, 커뮤니티의 포럼 섹션에서 질문을 보거나 게시하십시오. 이러한 질문은 개발 및 고객 프로그램 팀에서 처리합니다. + +또한 Stack Overflow 및 IBM DeveloperWorks dw Answers 포럼을 사용하여 질문을 보거나 게시할 수 있습니다. 서비스 및 시작하기 지시사항에 대한 질문은 IBM developerWorks dW Answers를 사용하십시오. 이 두 개의 포럼 중 하나에 질문을 게시하는 경우 Bluemix 개발 팀이 질문을 쉽게 볼 수 있도록 다음 태그 지정 규칙을 적용하십시오. + +* [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window}에 게시하려면 클릭하고 "ibm-bluemix" 및 "productinsights"로 질문에 태그를 지정하십시오. +* [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window}에 게시하려면 클릭하고 "productinsights" 또는 "hybridconnect"로 질문에 태그를 지정하십시오. + +포럼 사용에 대한 자세한 정보는 [도움 받기](https://www.{DomainName}/docs/support/index.html#getting-help) 주제를 참조하십시오. diff --git a/services/product-insights/nl/pt/BR/index.md b/services/product-insights/nl/pt/BR/index.md index e1e8e02c8..a9199c803 100644 --- a/services/product-insights/nl/pt/BR/index.md +++ b/services/product-insights/nl/pt/BR/index.md @@ -1,50 +1,50 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# Introdução ao {{site.data.keyword.product-insights_short}} -{: #product-insights} - -O {{site.data.keyword.product-insights_full}} se conecta a produtos de software IBM no local para construir um inventário de produto cruzado e fornecer insights sobre métricas de uso de produto. - -{:shortdesc} - -O serviço {{site.data.keyword.product-insights_short}} é executado dentro do IBM Bluemix e recebe informações dos produtos de software IBM ativados no local. Essas informações são então mostradas no painel da instância de serviço. Para usar o serviço, você deve ter uma conta do Bluemix e criar o serviço em uma organização e espaço. As informações do produto e de uso para seus produtos ativados no local são armazenadas com segurança e visualizadas dentro do escopo ou contexto desse serviço exclusivo. - -Dica: para simplificar, é possível usar inicialmente uma única instância de serviço. - -Para iniciar o {{site.data.keyword.product-insights_short}}, conclua as etapas a seguir: - -1. Na guia **Gerenciar**, clique no botão **Registrar um produto** para visualizar uma lista de produtos suportados e o nível de versão necessário. São fornecidas instruções para cada tipo de produto, para que seja possível se conectar a instâncias do produto no local para o serviço {{site.data.keyword.product-insights_short}}. Se necessário, atualize seus produtos de software IBM no local, ativados para o nível mínimo de pré-requisito. Para um produto que requer um nível mínimo suportado, instale o fix pack ou a correção temporária para permitir a integração com o {{site.data.keyword.product-insights_short}}. -2. Conecte seus produtos de software IBM no local, ativados no serviço do {{site.data.keyword.product-insights_short}}. Como parte do processo de configuração para cada produto, você precisa das credenciais de serviço (ou seja, apikey e apihost). É possível localizar as credenciais de serviço na guia **Credenciais de Serviço** do seu painel de serviço. -3. Depois de ativar e conectar cada instância do produto, pode ser necessário iniciar ou reiniciar os produtos ou as instâncias do produto para que forneçam informações do produto e de uso para o serviço do {{site.data.keyword.product-insights_short}}. - -Para obter detalhes sobre a ativação de produtos, o nível mínimo de suporte necessário para cada produto e o modo de ativar cada produto para integração com o {{site.data.keyword.product-insights_short}}, faça parte da {{site.data.keyword.product-insights_full}} [Comunidade Técnica](https://developer.ibm.com/product-insights/). - -É possível visualizar seu inventário selecionando **Gerenciar** no painel de serviço. - -* No painel de serviço, os nomes dos produtos que foram conectados são listados na área de janela **Produtos**. -* Para mostrar todas as instâncias do produto, selecione **Visualizar tudo**. Para mostrar as instâncias para um produto, selecione esse produto na área de janela **Produtos** e elas serão exibidas na área de janela **Instâncias**. -* Para mostrar os detalhes de uma única instância do produto, selecione a instância do produto na área de janela **Instâncias**. A área de janela **Detalhes** é, então, preenchida. A área de janela **Detalhes** mostra detalhes da instância do produto e as informações de uso que foram enviadas da instância. -* A guia **Uso** mostra as informações de uso do produto em formato gráfico. Dependendo do produto, é possível especificar o tipo de informações que você deseja visualizar e o período de amostragem. -* A guia **Detalhes** mostra informações da instância do produto; incluindo informações do produto, do ambiente e do componente. -* A guia **Advisor**, em sua guia **Serviços**, fornece detalhes sobre serviços adicionais que podem ser úteis em relação à instância do produto atual. Na guia **Atualizações**, fornece informações sobre o nível de versão da instância do produto e sua moeda. - - - - - - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# Introdução ao {{site.data.keyword.product-insights_short}} +{: #product-insights} + +O {{site.data.keyword.product-insights_full}} se conecta a produtos de software IBM no local para construir um inventário de produto cruzado e fornecer insights sobre métricas de uso de produto. + +{:shortdesc} + +O serviço {{site.data.keyword.product-insights_short}} é executado dentro do IBM Bluemix e recebe informações dos produtos de software IBM ativados no local. Essas informações são então mostradas no painel da instância de serviço. Para usar o serviço, você deve ter uma conta do Bluemix e criar o serviço em uma organização e espaço. As informações do produto e de uso para seus produtos ativados no local são armazenadas com segurança e visualizadas dentro do escopo ou contexto desse serviço exclusivo. + +Dica: para simplificar, é possível usar inicialmente uma única instância de serviço. + +Para iniciar o {{site.data.keyword.product-insights_short}}, conclua as etapas a seguir: + +1. Na guia **Gerenciar**, clique no botão **Registrar um produto** para visualizar uma lista de produtos suportados e o nível de versão necessário. São fornecidas instruções para cada tipo de produto, para que seja possível se conectar a instâncias do produto no local para o serviço {{site.data.keyword.product-insights_short}}. Se necessário, atualize seus produtos de software IBM no local, ativados para o nível mínimo de pré-requisito. Para um produto que requer um nível mínimo suportado, instale o fix pack ou a correção temporária para permitir a integração com o {{site.data.keyword.product-insights_short}}. +2. Conecte seus produtos de software IBM no local, ativados no serviço do {{site.data.keyword.product-insights_short}}. Como parte do processo de configuração para cada produto, você precisa das credenciais de serviço (ou seja, apikey e apihost). É possível localizar as credenciais de serviço na guia **Credenciais de Serviço** do seu painel de serviço. +3. Depois de ativar e conectar cada instância do produto, pode ser necessário iniciar ou reiniciar os produtos ou as instâncias do produto para que forneçam informações do produto e de uso para o serviço do {{site.data.keyword.product-insights_short}}. + +Para obter detalhes sobre a ativação de produtos, o nível mínimo de suporte necessário para cada produto e o modo de ativar cada produto para integração com o {{site.data.keyword.product-insights_short}}, faça parte da {{site.data.keyword.product-insights_full}} [Comunidade Técnica](https://developer.ibm.com/product-insights/). + +É possível visualizar seu inventário selecionando **Gerenciar** no painel de serviço. + +* No painel de serviço, os nomes dos produtos que foram conectados são listados na área de janela **Produtos**. +* Para mostrar todas as instâncias do produto, selecione **Visualizar tudo**. Para mostrar as instâncias para um produto, selecione esse produto na área de janela **Produtos** e elas serão exibidas na área de janela **Instâncias**. +* Para mostrar os detalhes de uma única instância do produto, selecione a instância do produto na área de janela **Instâncias**. A área de janela **Detalhes** é, então, preenchida. A área de janela **Detalhes** mostra detalhes da instância do produto e as informações de uso que foram enviadas da instância. +* A guia **Uso** mostra as informações de uso do produto em formato gráfico. Dependendo do produto, é possível especificar o tipo de informações que você deseja visualizar e o período de amostragem. +* A guia **Detalhes** mostra informações da instância do produto; incluindo informações do produto, do ambiente e do componente. +* A guia **Advisor**, em sua guia **Serviços**, fornece detalhes sobre serviços adicionais que podem ser úteis em relação à instância do produto atual. Na guia **Atualizações**, fornece informações sobre o nível de versão da instância do produto e sua moeda. + + + + + + + + + + diff --git a/services/product-insights/nl/pt/BR/product-insights_overview.md b/services/product-insights/nl/pt/BR/product-insights_overview.md index 7a40b37cc..fe42f0815 100644 --- a/services/product-insights/nl/pt/BR/product-insights_overview.md +++ b/services/product-insights/nl/pt/BR/product-insights_overview.md @@ -1,145 +1,145 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" - ---- - - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# Sobre o IBM {{site.data.keyword.product-insights_short}} -{: #about_product-insights} - -{{site.data.keyword.product-insights_full}} é um serviço IBM Bluemix, que faz parte do IBM Connect para Cloud. Ele conecta seus produtos de software IBM no local ao seu serviço do {{site.data.keyword.product-insights_short}} e fornece insights ao seu inventário em execução e às métricas de uso de tempo de execução. - -{:shortdesc} - -O serviço {{site.data.keyword.product-insights_short}} é um ponto de entrada, e mais funções podem ser incluídas no futuro. - -O {{site.data.keyword.product-insights_short}} fornece os seguintes recursos: - -* Registro de seus produtos de software IBM no local com a IBM, especificamente com um serviço Bluemix. -* Coleta de dados para produtos no local conectados e dados de uso associados. -* Painel para dados de uso de tempo de execução para fornecer insights reais sobre o uso do produto e a carga de trabalho. - - -Para usar os recursos do {{site.data.keyword.product-insights_full}}, conclua as etapas a seguir: - -1. Crie pelo menos um serviço no Bluemix para {{site.data.keyword.product-insights_short}}. -1. Faça upgrade de seus produtos de software IBM no local para os níveis de liberação necessários e inclua o código de ativação para cada instalação do produto. -1. Configure a instalação de software com as credenciais do {{site.data.keyword.bluemix_short}} para sua instância de serviço do {{site.data.keyword.product-insights_short}}. Todos os seus dados são armazenados com segurança com essas credenciais. Os dados estão disponíveis apenas para os indivíduos com as permissões adequadas ao serviço. - - - -## Como ele funciona -{: #product-insights_howitworks} -O serviço {{site.data.keyword.product-insights_full}} se integra aos seus produtos de software IBM no local para reunir e exibir informações do produto de tempo de execução e métricas de uso. Inicialmente, um subconjunto de produtos de software IBM é ativado para se integrar a este serviço. Quando registrados e conectados, os produtos de software no local enviam periodicamente informações de inicialização e uso. As informações são armazenadas em relação a essa instância de serviço por meio das credenciais configuradas. É possível usar o painel de instância de serviço para visualizar as informações no Bluemix. - -A solução {{site.data.keyword.product-insights_short}} inclui vários componentes, conforme mostrado no gráfico a seguir: - -![{{site.data.keyword.product-insights_full}} arquitetura](images/architecture_product-insights.png "{{site.data.keyword.product-insights_full}} architecture"). - - -## Organizações e espaços -{: #product-insights_orgs} -O serviço {{site.data.keyword.product-insights_full}} está associado a uma única organização e espaço do Bluemix e tem credenciais exclusivas. Deve-se configurar pelo menos uma organização e espaço do Bluemix. Se desejar separar os dados, por exemplo, para limitar o acesso a indivíduos específicos, você poderá criar vários espaços dentro de uma organização com uma instância de serviço em cada espaço. Cada instância de serviço tem credenciais exclusivas que você precisa fornecer a seus produtos de software IBM. - -As informações para os produtos que são configurados com um conjunto de credenciais são visíveis apenas dentro do serviço com essas credenciais. Vários serviços podem ser criados para separar os dados se necessário, cada um com credenciais exclusivas. - - -## Painel de serviço -{: #service_dashboard} -Depois de criar sua instância de serviço, você é direcionado ao painel de serviço. Você sempre pode retornar ao painel de serviço clicando no ícone de serviço no painel da organização. No painel de serviço, é possível acessar os seguintes itens: - -* A documentação de Introdução -* As credenciais de serviço necessárias para conectar seus produtos no local -* Um inventário de produtos suportados e todas as instâncias de tempo de execução registradas na instância de serviço do {{site.data.keyword.product-insights_short}} -* Informações de uso para instâncias de tempo de execução conectadas -* Informações do produto e do ambiente para instâncias de tempo de execução conectadas - -Se não houver produtos listados na guia Gerenciar, clique em **Registrar um produto** para visualizar uma lista de produtos suportados e acessar detalhes específicos sobre como conectar instâncias do produto. -![Painel de serviço sem nenhum produto registrado](images/NoRegisteredProducts.jpg "Service dashboard with no registered products") - -## Registrar um produto -{: #product-insights_register} -Na guia **Gerenciar**, clique em **Registrar um produto** para visualizar uma lista de produtos suportados. Role para seu produto ou use um campo de procura para filtrar a lista de produtos. -![Lista de produtos suportados filtrada usando a sequência de procura](images/products-filtered.png "Filtered list of products available to be registered") - -Para visualizar instruções sobre como registrar uma instância de um produto, selecione-o na lista. - -Ao conectar uma instância do produto ao serviço do {{site.data.keyword.product-insights_short}}, ele é exibido na guia **Gerenciar** do painel. Um painel pode listar várias instâncias de produtos conectadas em diferentes produtos. - -## Inventário do produto -{: #product-insights_products} -Depois de ativar as instâncias do produto para enviar dados para o {{site.data.keyword.product-insights_short}}, é possível visualizar seu inventário selecionando **Gerenciar** no painel de serviço. - -![Painel de serviço com produtos e instâncias do produto](images/productinstances.png "Service dashboard with products and product instances") - -Para o {{site.data.keyword.product-insights_short}}, um produto é diferente de uma instância do produto. Um produto tem um nome de produto, como IBM MQ ou IBM WebSphere Application Server Liberty Network Deployment. Uma instância de produto é usada para representar um produto depois que ele é instalado e está em execução. Alguns produtos têm várias instâncias que são executadas na mesma instalação do produto. Por exemplo, o WebSphere Application Server Liberty Network Deployment pode executar vários servidores de aplicativos que são criados em uma única instalação do produto. - -No painel de serviço, os nomes dos produtos registrados são mostrados na opção *Visualizar tudo* na área de janela **Produtos**. Instâncias conectadas são listadas na área de janela **Instâncias**. Esta área de janela contém instâncias dos produtos que são selecionados na área de janela **Produtos**. No exemplo a seguir, todas as instâncias do produto são mostradas porque a opção *Visualizar tudo* é selecionada na área de janela Produtos. Este exemplo mostra seis produtos, alguns com várias instâncias conectadas. É possível filtrar a lista de instâncias usando o campo **Procurar Instâncias** ou selecionando uma entrada do produto. Para visualizar detalhes para uma instância do produto, selecione sua entrada na área de janela **Instâncias**. - -A lista de instâncias do produto que são exibidas é filtrada conforme você navega. Para auxiliar a navegação, o caminho navegado para uma instância selecionada é exibido. - -![Painel de serviço](images/products.png "Service dashboard") - - - -## Informações da instância do produto -{: #product-insights_productinstances} -Quando uma instância do produto é selecionada, a área de janela **Detalhes da instância** é preenchida. A área de janela mostra dados de uso, detalhes do produto e recomendações para a instância do produto por meio de uma guia **Advisor**. - - -## Informações de uso -{: #product-insights_usage} -As informações de uso são mostradas na guia **Uso**. Use as duas listas suspensas para selecionar a métrica a exibir (se a instância do produto enviar mais de uma métrica) e o período de tempo a ser exibido. - -Se a instância do produto enviar mais de uma métrica, use a primeira lista suspensa para selecionar qual métrica exibir. Na segunda lista suspensa, selecione o período de tempo a exibir. As opções para o período de tempo para as seções são Últimas 24 horas, 1 semana, 1 mês, 6 meses, 1 ano. - -A primeira seção mostra a média máxima, média, média mínima e o total dos valores da métrica sobre o período de tempo selecionado. A segunda seção mostra um gráfico dos valores dentro do período de tempo com o período do eixo X, que muda com base no período de tempo selecionado. Por exemplo, Últimas 24 horas mostra pontos gráficos para cada hora, enquanto a exibição de 1 semana mostra pontos gráficos para cada dia dentro dessa semana). A seção final mostra o máximo, médio e mínimo para o ponto gráfico selecionado. Para ver os valores para outro ponto no gráfico, arraste a barra de tempo para uma nova posição. - -Uma mensagem será exibida se não houver nenhum dado para esse período de tempo. Por exemplo, uma instância parada não forneceria dados e nenhum dado será mostrado para o período de tempo em que estava parada. Outros períodos de tempo podem ter uso a exibir. Mude o período de tempo na lista suspensa para ver outros períodos de tempo. - -A guia **Detalhes** mostra informações da instância do produto, que podem incluir os seguintes itens: - -* O nome e a versão do produto -* O local em que o produto está instalado, incluindo o nome do host e o diretório -* A última vez em que a instância enviou informações sobre a inicialização -* O identificador da instância se o produto puder ter várias instâncias em um único diretório - -![Detalhes da instância do produto](images/instancedetail.png "Product instance details") - -A instância do produto também fornece as seguintes informações opcionais: - -* Uma lista de APARs instaladas. -* O sistema operacional e sua versão, que são mostrados na guia **Ambiente**. -![Detalhes da instância do produto - guia Ambiente](images/instancedetails-env.png "Product instance details - Environment tab") -* Componentes ou recursos instalados, que são mostrados na guia **Componentes**. O exemplo não mostra a guia **Componentes** porque a instância do IBM Product XYZ não fornece nenhuma informação de componente adicional. -![Detalhes da instância do produto - guia Componente](images/instancedetails-comps.png "Product instance details - Component tab") -* O identificador exclusivo para a instância do produto, que é uma combinação do nome do host, diretório e identificador da instância. - - - - -## Procurando -{: #product-insights_search} -A área de janela **Instância do produto** fornece um recurso de procura básica para filtrar a lista de produtos. No campo de procura, digite a sequência que deseja usar para a procura. A procura pode ser feita apenas para dados de instância do produto (ou seja, as informações na guia **Detalhes**). - - - - - -## Obtendo ajuda para o {{site.data.keyword.product-insights_short}} -{: #gettinghelp} - -Informações detalhadas sobre como criar um serviço, obter as atualizações para os produtos de software IBM ativados e as etapas de instalação e configuração são localizadas na [{{site.data.keyword.product-insights_full}} Comunidade Técnica](https://developer.ibm.com/product-insights/). Se você tiver problemas ou dúvidas quando estiver usando o {{site.data.keyword.product-insights_short}}, visualize ou poste as dúvidas na seção Fóruns da Comunidade. Estas dúvidas são respondidas pela equipe de programas de desenvolvimento e do cliente. - -É possível também usar os fóruns Stack Overflow e IBM DeveloperWorks dw Answers para visualizar ou postar dúvidas. Para dúvidas sobre o serviço e instruções de início, use o IBM developerWorks dW Answers. Quando postar uma dúvida em qualquer um desses dois fóruns, aplique as seguintes regras de tag para que as equipes de desenvolvimento do Bluemix possam ver facilmente sua dúvida. - -* Clique para postar em [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window}, identifique sua dúvida com "ibm-bluemix" e "productinsights". -* Clique para postar em [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window}, identifique suas dúvidas com "productinsights" ou "hybridconnect". - -Para obter mais informações sobre como usar os fóruns, consulte o tópico [Obtendo ajuda](https://www.{DomainName}/docs/support/index.html#getting-help). +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" + +--- + + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# Sobre o IBM {{site.data.keyword.product-insights_short}} +{: #about_product-insights} + +{{site.data.keyword.product-insights_full}} é um serviço IBM Bluemix, que faz parte do IBM Connect para Cloud. Ele conecta seus produtos de software IBM no local ao seu serviço do {{site.data.keyword.product-insights_short}} e fornece insights ao seu inventário em execução e às métricas de uso de tempo de execução. + +{:shortdesc} + +O serviço {{site.data.keyword.product-insights_short}} é um ponto de entrada, e mais funções podem ser incluídas no futuro. + +O {{site.data.keyword.product-insights_short}} fornece os seguintes recursos: + +* Registro de seus produtos de software IBM no local com a IBM, especificamente com um serviço Bluemix. +* Coleta de dados para produtos no local conectados e dados de uso associados. +* Painel para dados de uso de tempo de execução para fornecer insights reais sobre o uso do produto e a carga de trabalho. + + +Para usar os recursos do {{site.data.keyword.product-insights_full}}, conclua as etapas a seguir: + +1. Crie pelo menos um serviço no Bluemix para {{site.data.keyword.product-insights_short}}. +1. Faça upgrade de seus produtos de software IBM no local para os níveis de liberação necessários e inclua o código de ativação para cada instalação do produto. +1. Configure a instalação de software com as credenciais do {{site.data.keyword.bluemix_short}} para sua instância de serviço do {{site.data.keyword.product-insights_short}}. Todos os seus dados são armazenados com segurança com essas credenciais. Os dados estão disponíveis apenas para os indivíduos com as permissões adequadas ao serviço. + + + +## Como ele funciona +{: #product-insights_howitworks} +O serviço {{site.data.keyword.product-insights_full}} se integra aos seus produtos de software IBM no local para reunir e exibir informações do produto de tempo de execução e métricas de uso. Inicialmente, um subconjunto de produtos de software IBM é ativado para se integrar a este serviço. Quando registrados e conectados, os produtos de software no local enviam periodicamente informações de inicialização e uso. As informações são armazenadas em relação a essa instância de serviço por meio das credenciais configuradas. É possível usar o painel de instância de serviço para visualizar as informações no Bluemix. + +A solução {{site.data.keyword.product-insights_short}} inclui vários componentes, conforme mostrado no gráfico a seguir: + +![{{site.data.keyword.product-insights_full}} arquitetura](images/architecture_product-insights.png "{{site.data.keyword.product-insights_full}} architecture"). + + +## Organizações e espaços +{: #product-insights_orgs} +O serviço {{site.data.keyword.product-insights_full}} está associado a uma única organização e espaço do Bluemix e tem credenciais exclusivas. Deve-se configurar pelo menos uma organização e espaço do Bluemix. Se desejar separar os dados, por exemplo, para limitar o acesso a indivíduos específicos, você poderá criar vários espaços dentro de uma organização com uma instância de serviço em cada espaço. Cada instância de serviço tem credenciais exclusivas que você precisa fornecer a seus produtos de software IBM. + +As informações para os produtos que são configurados com um conjunto de credenciais são visíveis apenas dentro do serviço com essas credenciais. Vários serviços podem ser criados para separar os dados se necessário, cada um com credenciais exclusivas. + + +## Painel de serviço +{: #service_dashboard} +Depois de criar sua instância de serviço, você é direcionado ao painel de serviço. Você sempre pode retornar ao painel de serviço clicando no ícone de serviço no painel da organização. No painel de serviço, é possível acessar os seguintes itens: + +* A documentação de Introdução +* As credenciais de serviço necessárias para conectar seus produtos no local +* Um inventário de produtos suportados e todas as instâncias de tempo de execução registradas na instância de serviço do {{site.data.keyword.product-insights_short}} +* Informações de uso para instâncias de tempo de execução conectadas +* Informações do produto e do ambiente para instâncias de tempo de execução conectadas + +Se não houver produtos listados na guia Gerenciar, clique em **Registrar um produto** para visualizar uma lista de produtos suportados e acessar detalhes específicos sobre como conectar instâncias do produto. +![Painel de serviço sem nenhum produto registrado](images/NoRegisteredProducts.jpg "Service dashboard with no registered products") + +## Registrar um produto +{: #product-insights_register} +Na guia **Gerenciar**, clique em **Registrar um produto** para visualizar uma lista de produtos suportados. Role para seu produto ou use um campo de procura para filtrar a lista de produtos. +![Lista de produtos suportados filtrada usando a sequência de procura](images/products-filtered.png "Filtered list of products available to be registered") + +Para visualizar instruções sobre como registrar uma instância de um produto, selecione-o na lista. + +Ao conectar uma instância do produto ao serviço do {{site.data.keyword.product-insights_short}}, ele é exibido na guia **Gerenciar** do painel. Um painel pode listar várias instâncias de produtos conectadas em diferentes produtos. + +## Inventário do produto +{: #product-insights_products} +Depois de ativar as instâncias do produto para enviar dados para o {{site.data.keyword.product-insights_short}}, é possível visualizar seu inventário selecionando **Gerenciar** no painel de serviço. + +![Painel de serviço com produtos e instâncias do produto](images/productinstances.png "Service dashboard with products and product instances") + +Para o {{site.data.keyword.product-insights_short}}, um produto é diferente de uma instância do produto. Um produto tem um nome de produto, como IBM MQ ou IBM WebSphere Application Server Liberty Network Deployment. Uma instância de produto é usada para representar um produto depois que ele é instalado e está em execução. Alguns produtos têm várias instâncias que são executadas na mesma instalação do produto. Por exemplo, o WebSphere Application Server Liberty Network Deployment pode executar vários servidores de aplicativos que são criados em uma única instalação do produto. + +No painel de serviço, os nomes dos produtos registrados são mostrados na opção *Visualizar tudo* na área de janela **Produtos**. Instâncias conectadas são listadas na área de janela **Instâncias**. Esta área de janela contém instâncias dos produtos que são selecionados na área de janela **Produtos**. No exemplo a seguir, todas as instâncias do produto são mostradas porque a opção *Visualizar tudo* é selecionada na área de janela Produtos. Este exemplo mostra seis produtos, alguns com várias instâncias conectadas. É possível filtrar a lista de instâncias usando o campo **Procurar Instâncias** ou selecionando uma entrada do produto. Para visualizar detalhes para uma instância do produto, selecione sua entrada na área de janela **Instâncias**. + +A lista de instâncias do produto que são exibidas é filtrada conforme você navega. Para auxiliar a navegação, o caminho navegado para uma instância selecionada é exibido. + +![Painel de serviço](images/products.png "Service dashboard") + + + +## Informações da instância do produto +{: #product-insights_productinstances} +Quando uma instância do produto é selecionada, a área de janela **Detalhes da instância** é preenchida. A área de janela mostra dados de uso, detalhes do produto e recomendações para a instância do produto por meio de uma guia **Advisor**. + + +## Informações de uso +{: #product-insights_usage} +As informações de uso são mostradas na guia **Uso**. Use as duas listas suspensas para selecionar a métrica a exibir (se a instância do produto enviar mais de uma métrica) e o período de tempo a ser exibido. + +Se a instância do produto enviar mais de uma métrica, use a primeira lista suspensa para selecionar qual métrica exibir. Na segunda lista suspensa, selecione o período de tempo a exibir. As opções para o período de tempo para as seções são Últimas 24 horas, 1 semana, 1 mês, 6 meses, 1 ano. + +A primeira seção mostra a média máxima, média, média mínima e o total dos valores da métrica sobre o período de tempo selecionado. A segunda seção mostra um gráfico dos valores dentro do período de tempo com o período do eixo X, que muda com base no período de tempo selecionado. Por exemplo, Últimas 24 horas mostra pontos gráficos para cada hora, enquanto a exibição de 1 semana mostra pontos gráficos para cada dia dentro dessa semana). A seção final mostra o máximo, médio e mínimo para o ponto gráfico selecionado. Para ver os valores para outro ponto no gráfico, arraste a barra de tempo para uma nova posição. + +Uma mensagem será exibida se não houver nenhum dado para esse período de tempo. Por exemplo, uma instância parada não forneceria dados e nenhum dado será mostrado para o período de tempo em que estava parada. Outros períodos de tempo podem ter uso a exibir. Mude o período de tempo na lista suspensa para ver outros períodos de tempo. + +A guia **Detalhes** mostra informações da instância do produto, que podem incluir os seguintes itens: + +* O nome e a versão do produto +* O local em que o produto está instalado, incluindo o nome do host e o diretório +* A última vez em que a instância enviou informações sobre a inicialização +* O identificador da instância se o produto puder ter várias instâncias em um único diretório + +![Detalhes da instância do produto](images/instancedetail.png "Product instance details") + +A instância do produto também fornece as seguintes informações opcionais: + +* Uma lista de APARs instaladas. +* O sistema operacional e sua versão, que são mostrados na guia **Ambiente**. +![Detalhes da instância do produto - guia Ambiente](images/instancedetails-env.png "Product instance details - Environment tab") +* Componentes ou recursos instalados, que são mostrados na guia **Componentes**. O exemplo não mostra a guia **Componentes** porque a instância do IBM Product XYZ não fornece nenhuma informação de componente adicional. +![Detalhes da instância do produto - guia Componente](images/instancedetails-comps.png "Product instance details - Component tab") +* O identificador exclusivo para a instância do produto, que é uma combinação do nome do host, diretório e identificador da instância. + + + + +## Procurando +{: #product-insights_search} +A área de janela **Instância do produto** fornece um recurso de procura básica para filtrar a lista de produtos. No campo de procura, digite a sequência que deseja usar para a procura. A procura pode ser feita apenas para dados de instância do produto (ou seja, as informações na guia **Detalhes**). + + + + + +## Obtendo ajuda para o {{site.data.keyword.product-insights_short}} +{: #gettinghelp} + +Informações detalhadas sobre como criar um serviço, obter as atualizações para os produtos de software IBM ativados e as etapas de instalação e configuração são localizadas na [{{site.data.keyword.product-insights_full}} Comunidade Técnica](https://developer.ibm.com/product-insights/). Se você tiver problemas ou dúvidas quando estiver usando o {{site.data.keyword.product-insights_short}}, visualize ou poste as dúvidas na seção Fóruns da Comunidade. Estas dúvidas são respondidas pela equipe de programas de desenvolvimento e do cliente. + +É possível também usar os fóruns Stack Overflow e IBM DeveloperWorks dw Answers para visualizar ou postar dúvidas. Para dúvidas sobre o serviço e instruções de início, use o IBM developerWorks dW Answers. Quando postar uma dúvida em qualquer um desses dois fóruns, aplique as seguintes regras de tag para que as equipes de desenvolvimento do Bluemix possam ver facilmente sua dúvida. + +* Clique para postar em [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window}, identifique sua dúvida com "ibm-bluemix" e "productinsights". +* Clique para postar em [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window}, identifique suas dúvidas com "productinsights" ou "hybridconnect". + +Para obter mais informações sobre como usar os fóruns, consulte o tópico [Obtendo ajuda](https://www.{DomainName}/docs/support/index.html#getting-help). diff --git a/services/product-insights/nl/zh/CN/index.md b/services/product-insights/nl/zh/CN/index.md index 1ab02f6dc..6880d9d26 100644 --- a/services/product-insights/nl/zh/CN/index.md +++ b/services/product-insights/nl/zh/CN/index.md @@ -1,50 +1,50 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# {{site.data.keyword.product-insights_short}} 入门 -{: #product-insights} - -{{site.data.keyword.product-insights_full}} 连接至内部部署 IBM 软件产品，以构建跨产品清单并洞察产品使用情况度量值。 - -{:shortdesc} - -{{site.data.keyword.product-insights_short}} 服务在 IBM Bluemix 内运行并从已启用的内部部署 IBM 软件产品接收信息。此信息随后会显示在服务实例仪表板中。要使用该服务，您必须具有 Bluemix 帐户并在组织和空间中创建该服务。在该唯一服务的范围或上下文中，可安全地存储并查看已启用的内部部署产品的产品和使用情况信息。 - -提示：为简单起见，您一开始就可以使用单个服务实例。 - -要开始使用 {{site.data.keyword.product-insights_short}}，请完成以下步骤： - -1. 在**管理**选项卡中，单击**注册产品**按钮，以查看受支持产品和必要版本级别的列表。系统还提供了每个产品类型的指示信息，以便您可以将内部部署产品实例连接至 {{site.data.keyword.product-insights_short}} 服务。如果必要，请将已启用的内部部署 IBM 软件产品更新到最低必备软件级别。对于需要最低受支持级别的产品，请安装修订包或临时修订，以启用与 {{site.data.keyword.product-insights_short}} 的集成。 -2. 将已启用的内部部署 IBM 软件产品连接至 {{site.data.keyword.product-insights_short}} 服务。在对每个产品进行配置的过程中，您需要服务凭证（即 apikey 和 apihost）。您可以在服务仪表板的**服务凭证**选项卡中找到服务凭证。 -3. 在您启用并连接每个产品实例后，您可能需要针对它们启动或重新启动产品或产品实例，以向 {{site.data.keyword.product-insights_short}} 服务提供产品和使用情况信息。 - -如需启用产品、每个产品所需的最低支持级别，以及如何启用每个产品以与 {{site.data.keyword.product-insights_short}} 集成的详细信息，请加入{{site.data.keyword.product-insights_full}}[技术社区](https://developer.ibm.com/product-insights/)。 - -通过在服务仪表板中选择**管理**，可以查看清单。 - -* 在服务仪表板中，已连接的产品的名称会在**产品**窗格中列出。 -* 要显示所有产品实例，请选择**全部查看**。要显示某个产品的产品实例，请从**产品**窗格中选择该产品，该产品的实例即会显示在**实例**窗格中。 -* 要显示单个产品实例的详细信息，请从**实例**窗格中选择产品实例。**详细信息**窗格中随后会填充信息。**详细信息**窗格显示产品实例的详细信息，以及已从该实例发送的使用情况信息。 -* **使用情况**选项卡以图形形式显示产品使用情况信息。根据产品，您可以指定要查看的信息类型和采样周期。 -* **详细信息**选项卡显示产品实例信息，包括产品信息、环境信息和组件信息。 -* **顾问程序**选项卡中的**服务**选项卡提供其他服务的详细信息，这些服务可能对当前产品实例方面有所裨益。在**更新**选项卡中，它提供产品实例版本级别及其当前状态的相关信息。 - - - - - - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# {{site.data.keyword.product-insights_short}} 入门 +{: #product-insights} + +{{site.data.keyword.product-insights_full}} 连接至内部部署 IBM 软件产品，以构建跨产品清单并洞察产品使用情况度量值。 + +{:shortdesc} + +{{site.data.keyword.product-insights_short}} 服务在 IBM Bluemix 内运行并从已启用的内部部署 IBM 软件产品接收信息。此信息随后会显示在服务实例仪表板中。要使用该服务，您必须具有 Bluemix 帐户并在组织和空间中创建该服务。在该唯一服务的范围或上下文中，可安全地存储并查看已启用的内部部署产品的产品和使用情况信息。 + +提示：为简单起见，您一开始就可以使用单个服务实例。 + +要开始使用 {{site.data.keyword.product-insights_short}}，请完成以下步骤： + +1. 在**管理**选项卡中，单击**注册产品**按钮，以查看受支持产品和必要版本级别的列表。系统还提供了每个产品类型的指示信息，以便您可以将内部部署产品实例连接至 {{site.data.keyword.product-insights_short}} 服务。如果必要，请将已启用的内部部署 IBM 软件产品更新到最低必备软件级别。对于需要最低受支持级别的产品，请安装修订包或临时修订，以启用与 {{site.data.keyword.product-insights_short}} 的集成。 +2. 将已启用的内部部署 IBM 软件产品连接至 {{site.data.keyword.product-insights_short}} 服务。在对每个产品进行配置的过程中，您需要服务凭证（即 apikey 和 apihost）。您可以在服务仪表板的**服务凭证**选项卡中找到服务凭证。 +3. 在您启用并连接每个产品实例后，您可能需要针对它们启动或重新启动产品或产品实例，以向 {{site.data.keyword.product-insights_short}} 服务提供产品和使用情况信息。 + +如需启用产品、每个产品所需的最低支持级别，以及如何启用每个产品以与 {{site.data.keyword.product-insights_short}} 集成的详细信息，请加入{{site.data.keyword.product-insights_full}}[技术社区](https://developer.ibm.com/product-insights/)。 + +通过在服务仪表板中选择**管理**，可以查看清单。 + +* 在服务仪表板中，已连接的产品的名称会在**产品**窗格中列出。 +* 要显示所有产品实例，请选择**全部查看**。要显示某个产品的产品实例，请从**产品**窗格中选择该产品，该产品的实例即会显示在**实例**窗格中。 +* 要显示单个产品实例的详细信息，请从**实例**窗格中选择产品实例。**详细信息**窗格中随后会填充信息。**详细信息**窗格显示产品实例的详细信息，以及已从该实例发送的使用情况信息。 +* **使用情况**选项卡以图形形式显示产品使用情况信息。根据产品，您可以指定要查看的信息类型和采样周期。 +* **详细信息**选项卡显示产品实例信息，包括产品信息、环境信息和组件信息。 +* **顾问程序**选项卡中的**服务**选项卡提供其他服务的详细信息，这些服务可能对当前产品实例方面有所裨益。在**更新**选项卡中，它提供产品实例版本级别及其当前状态的相关信息。 + + + + + + + + + + diff --git a/services/product-insights/nl/zh/CN/product-insights_overview.md b/services/product-insights/nl/zh/CN/product-insights_overview.md index 8be75493d..0194da34c 100644 --- a/services/product-insights/nl/zh/CN/product-insights_overview.md +++ b/services/product-insights/nl/zh/CN/product-insights_overview.md @@ -1,145 +1,145 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" - ---- - - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# 关于 IBM {{site.data.keyword.product-insights_short}} -{: #about_product-insights} - -{{site.data.keyword.product-insights_full}} 是 IBM Bluemix 服务，其为 IBM Connect to Cloud 的一部分。它可将内部部署 IBM 软件产品连接到 {{site.data.keyword.product-insights_short}} 服务，并洞察运行清单和运行时使用情况度量值。 - -{:shortdesc} - -{{site.data.keyword.product-insights_short}} 服务是入口点，未来可能还会添加更多功能。 - -{{site.data.keyword.product-insights_short}} 提供了以下功能： - -* 向 IBM（特别是向 Bluemix 服务）注册内部部署 IBM 软件产品。 -* 对连接的内部部署产品和相关联使用情况数据进行数据收集。 -* 提供用于运行时使用情况数据的仪表板，以真正了解产品使用情况和工作负载。 - - -要使用 {{site.data.keyword.product-insights_full}} 功能，请完成以下步骤： - -1. 在 Bluemix for {{site.data.keyword.product-insights_short}} 中至少创建一个服务。 -1. 将内部部署 IBM 软件产品升级至所需的发行版级别，并为每个产品安装添加启动代码。 -1. 使用 {{site.data.keyword.bluemix_short}} 凭证为 {{site.data.keyword.product-insights_short}} 服务实例配置软件安装。所有数据都安全地随这些凭证一起存储。只有对服务具有适当权限的个人才可以使用这些数据。 - - - -## 运作方式 -{: #product-insights_howitworks} -{{site.data.keyword.product-insights_full}} 服务与内部部署 IBM 软件产品相集成，以收集和显示运行时产品信息和使用情况度量值。一开始，会启用一小部分 IBM 软件产品以与此服务集成。在已注册并已连接后，内部部署软件产品会定期发送启动和使用情况信息。这些信息通过已配置的凭证，存储在与此服务实例相关的位置。您可以使用服务实例仪表板，在 Bluemix 中查看该信息。 - -{{site.data.keyword.product-insights_short}} 解决方案包括多个组件，如下图所示： - -![{{site.data.keyword.product-insights_full}} 体系结构](images/architecture_product-insights.png "{{site.data.keyword.product-insights_full}} 体系结构")。 - - -## 组织和空间 -{: #product-insights_orgs} -{{site.data.keyword.product-insights_full}} 服务与单个 Bluemix 组织和空间相关联且具有唯一的凭证。您必须至少设置一个 Bluemix 组织和空间。举例来说，如果您想要分隔数据，以将访问权限制为特定个人，那么您可以在组织内创建多个空间，每个空间中一个服务实例。每个服务实例具有您需要为 IBM 软件产品提供的唯一凭证。 - -使用一组凭证配置的产品的信息仅在具有那些凭证的服务中可见。必要的话，可以创建多个服务以分隔数据，每个服务具有唯一的凭证。 - - -## 服务仪表板 -{: #service_dashboard} -创建服务实例后，系统会将您定向到服务仪表板。您始终可以通过单击组织仪表板中的服务图标，返回到服务仪表板。从服务仪表板中，您可以访问以下项： - -* 入门文档 -* 连接内部部署产品所需的服务凭证 -* 向 {{site.data.keyword.product-insights_short}} 服务实例注册的受支持产品和任何运行时实例的清单 -* 已连接运行时实例的使用情况信息 -* 已连接运行时实例的产品和环境信息 - -如果在“管理”选项卡中未列出任何产品，请单击**注册产品**，以查看受支持产品的列表并访问连接产品实例的特定详细信息。 -![没有已注册产品的服务仪表板](images/NoRegisteredProducts.jpg "没有已注册产品的服务仪表板") - -## 注册产品 -{: #product-insights_register} -在**管理**选项卡中，单击**注册产品**，以查看受支持产品的列表。滚动至您的产品或使用搜索字段过滤产品列表。 -![使用搜索字符串过滤的受支持产品列表](images/products-filtered.png "可用于注册的已过滤产品列表") - -要查看注册产品实例的指示信息，请从列表中选择该实例。 - -当您将产品实例连接到 {{site.data.keyword.product-insights_short}} 服务时，它会显示在仪表板的**管理**选项卡中。仪表板可以列出跨不同产品的多个已连接产品实例。 - -## 产品清单 -{: #product-insights_products} -在您启用产品实例以将数据发送至 {{site.data.keyword.product-insights_short}} 之后，您可以在服务仪表板中选择**管理**以查看清单。 - -![具有产品和产品实例的服务仪表板](images/productinstances.png "具有产品和产品实例的服务仪表板") - -对于 {{site.data.keyword.product-insights_short}} 而言，产品与产品实例不同。产品具有产品名称，如 IBM MQ 或 IBM WebSphere Application Server Liberty Network Deployment。产品实例用于在安装并运行产品后代表产品。一些产品具有多个实例，可从同一产品安装中运行。例如，WebSphere Application Server Liberty Network Deployment 可以运行从单个产品安装创建的多个应用程序服务器。 - -在服务仪表板中，已注册的产品的名称会显示在**产品**窗格的*全部查看*选项下。已连接的实例会在**实例**窗格中列出。此窗格包含**产品**窗格中选择的产品实例。在以下示例中，会显示所有产品实例，这是因为在“产品”窗格中已选择*全部查看*选项。此示例显示六个产品，其中有一些已连接多个实例。您可以使用**搜索实例**字段或选择产品条目，来过滤实例列表。要查看产品实例的详细信息，请在**实例**窗格中选择其条目。 - -在您浏览时会过滤所显示的产品实例列表。为辅助导航，会显示所选实例的浏览路径。 - -![服务仪表板](images/products.png "服务仪表板") - - - -## 产品实例信息 -{: #product-insights_productinstances} -选择产品实例时，**实例详细信息**窗格中会填充信息。该窗格通过**顾问程序**选项卡，显示产品实例的使用情况数据、产品详细信息和建议。 - - -## 使用情况信息 -{: #product-insights_usage} -使用情况信息显示在**使用情况**选项卡上。使用两个下拉列表来选择要显示的度量值（如果产品实例发送多个度量值）和要显示的时间段。 - -如果产品实例发送多个度量值，请使用第一个下拉列表来选择要显示的度量值。从第二个下拉列表中选择要显示的时间段。部分的时间段选项为“过去 24 小时”、“1 周”、“1 个月”、“6 个月”、“1 年”。 - -第一部分显示所选时间段内，平均最大、平均、平均最小和总计度量值。第二部分以 X 轴为时间段，显示时间段内值的图形，其根据所选时间段而变更。例如，“过去 24 小时”显示每个小时的图形点，而“1 周”显示该周内每天的图形点。最后的部分显示所选图形点的最大、平均和最小值。要在图形上查看其他点的值，请将时间条拖到新位置。 - -如果该时间段没有任何数据，则会显示一条消息。例如，已停止的实例不会提供数据，所以当停止时，该时间段不会显示任何数据。其他时间段可以具有要显示的使用情况。在下拉列表中更改时间段以查看其他时间段。 - -**详细信息**选项卡显示产品实例信息，其可包括以下项： - -* 产品名称和版本 -* 产品的安装位置，包括主机名和目录 -* 启动时实例发送信息的最后时间 -* 产品在单个目录中可以具有多个实例时的实例标识 - -![产品实例详细信息](images/instancedetail.png "产品实例详细信息") - -产品实例还提供以下可选信息： - -* 安装的 APAR 列表。 -* 操作系统及其版本，其显示在**环境**选项卡中。 -![产品实例详细信息 - 环境选项卡](images/instancedetails-env.png "产品实例详细信息 - 环境选项卡") -* 组件或已安装的功能，其显示在**组件**选项卡中。示例不会显示**组件**选项卡，因为 IBM Product XYZ 的实例不会提供任何其他组件信息。 -![产品实例详细信息 - 组件选项卡](images/instancedetails-comps.png "产品实例详细信息 - 组件选项卡") -* 产品实例的唯一标识，其为主机名、目录和实例标识的组合。 - - - - -## 搜索 -{: #product-insights_search} -**产品实例**窗格提供基本搜索功能以过滤产品列表。在搜索字段中，键入要用于搜索的字符串。仅可搜索产品实例数据（即**详细信息**选项卡中的信息）。 - - - - - -## 获取 {{site.data.keyword.product-insights_short}} 的帮助 -{: #gettinghelp} - -在 [{{site.data.keyword.product-insights_full}} 技术社区](https://developer.ibm.com/product-insights/)中可以找到创建服务、获取已启用 IBM 软件产品更新，以及安装和配置步骤的详细信息。如果在使用 {{site.data.keyword.product-insights_short}} 时有问题，请在社区的论坛部分查看或发布问题。这些问题将由开发和客户项目团队处理。 - -您还可以使用 Stack Overflow 和 IBM DeveloperWorks dw Answers 论坛来查看或发布问题。有关服务和入门指示信息的问题，请使用 IBM developerWorks dW Answers。当您在这两个论坛中的任何一个上发布问题时，请应用以下标记规则，以便 Bluemix 开发团队能够轻易地查看您的问题。 - -* 单击以在 [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window} 上发布问题，将您的问题以“ibm-bluemix”和“productinsights”进行标记。 -* 单击以在 [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window} 上发布问题，将您的问题以“productinsights”或“hybridconnect”进行标记。 - -有关使用论坛的更多信息，请参阅[获取帮助](https://www.{DomainName}/docs/support/index.html#getting-help)主题。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" + +--- + + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# 关于 IBM {{site.data.keyword.product-insights_short}} +{: #about_product-insights} + +{{site.data.keyword.product-insights_full}} 是 IBM Bluemix 服务，其为 IBM Connect to Cloud 的一部分。它可将内部部署 IBM 软件产品连接到 {{site.data.keyword.product-insights_short}} 服务，并洞察运行清单和运行时使用情况度量值。 + +{:shortdesc} + +{{site.data.keyword.product-insights_short}} 服务是入口点，未来可能还会添加更多功能。 + +{{site.data.keyword.product-insights_short}} 提供了以下功能： + +* 向 IBM（特别是向 Bluemix 服务）注册内部部署 IBM 软件产品。 +* 对连接的内部部署产品和相关联使用情况数据进行数据收集。 +* 提供用于运行时使用情况数据的仪表板，以真正了解产品使用情况和工作负载。 + + +要使用 {{site.data.keyword.product-insights_full}} 功能，请完成以下步骤： + +1. 在 Bluemix for {{site.data.keyword.product-insights_short}} 中至少创建一个服务。 +1. 将内部部署 IBM 软件产品升级至所需的发行版级别，并为每个产品安装添加启动代码。 +1. 使用 {{site.data.keyword.bluemix_short}} 凭证为 {{site.data.keyword.product-insights_short}} 服务实例配置软件安装。所有数据都安全地随这些凭证一起存储。只有对服务具有适当权限的个人才可以使用这些数据。 + + + +## 运作方式 +{: #product-insights_howitworks} +{{site.data.keyword.product-insights_full}} 服务与内部部署 IBM 软件产品相集成，以收集和显示运行时产品信息和使用情况度量值。一开始，会启用一小部分 IBM 软件产品以与此服务集成。在已注册并已连接后，内部部署软件产品会定期发送启动和使用情况信息。这些信息通过已配置的凭证，存储在与此服务实例相关的位置。您可以使用服务实例仪表板，在 Bluemix 中查看该信息。 + +{{site.data.keyword.product-insights_short}} 解决方案包括多个组件，如下图所示： + +![{{site.data.keyword.product-insights_full}} 体系结构](images/architecture_product-insights.png "{{site.data.keyword.product-insights_full}} 体系结构")。 + + +## 组织和空间 +{: #product-insights_orgs} +{{site.data.keyword.product-insights_full}} 服务与单个 Bluemix 组织和空间相关联且具有唯一的凭证。您必须至少设置一个 Bluemix 组织和空间。举例来说，如果您想要分隔数据，以将访问权限制为特定个人，那么您可以在组织内创建多个空间，每个空间中一个服务实例。每个服务实例具有您需要为 IBM 软件产品提供的唯一凭证。 + +使用一组凭证配置的产品的信息仅在具有那些凭证的服务中可见。必要的话，可以创建多个服务以分隔数据，每个服务具有唯一的凭证。 + + +## 服务仪表板 +{: #service_dashboard} +创建服务实例后，系统会将您定向到服务仪表板。您始终可以通过单击组织仪表板中的服务图标，返回到服务仪表板。从服务仪表板中，您可以访问以下项： + +* 入门文档 +* 连接内部部署产品所需的服务凭证 +* 向 {{site.data.keyword.product-insights_short}} 服务实例注册的受支持产品和任何运行时实例的清单 +* 已连接运行时实例的使用情况信息 +* 已连接运行时实例的产品和环境信息 + +如果在“管理”选项卡中未列出任何产品，请单击**注册产品**，以查看受支持产品的列表并访问连接产品实例的特定详细信息。 +![没有已注册产品的服务仪表板](images/NoRegisteredProducts.jpg "没有已注册产品的服务仪表板") + +## 注册产品 +{: #product-insights_register} +在**管理**选项卡中，单击**注册产品**，以查看受支持产品的列表。滚动至您的产品或使用搜索字段过滤产品列表。 +![使用搜索字符串过滤的受支持产品列表](images/products-filtered.png "可用于注册的已过滤产品列表") + +要查看注册产品实例的指示信息，请从列表中选择该实例。 + +当您将产品实例连接到 {{site.data.keyword.product-insights_short}} 服务时，它会显示在仪表板的**管理**选项卡中。仪表板可以列出跨不同产品的多个已连接产品实例。 + +## 产品清单 +{: #product-insights_products} +在您启用产品实例以将数据发送至 {{site.data.keyword.product-insights_short}} 之后，您可以在服务仪表板中选择**管理**以查看清单。 + +![具有产品和产品实例的服务仪表板](images/productinstances.png "具有产品和产品实例的服务仪表板") + +对于 {{site.data.keyword.product-insights_short}} 而言，产品与产品实例不同。产品具有产品名称，如 IBM MQ 或 IBM WebSphere Application Server Liberty Network Deployment。产品实例用于在安装并运行产品后代表产品。一些产品具有多个实例，可从同一产品安装中运行。例如，WebSphere Application Server Liberty Network Deployment 可以运行从单个产品安装创建的多个应用程序服务器。 + +在服务仪表板中，已注册的产品的名称会显示在**产品**窗格的*全部查看*选项下。已连接的实例会在**实例**窗格中列出。此窗格包含**产品**窗格中选择的产品实例。在以下示例中，会显示所有产品实例，这是因为在“产品”窗格中已选择*全部查看*选项。此示例显示六个产品，其中有一些已连接多个实例。您可以使用**搜索实例**字段或选择产品条目，来过滤实例列表。要查看产品实例的详细信息，请在**实例**窗格中选择其条目。 + +在您浏览时会过滤所显示的产品实例列表。为辅助导航，会显示所选实例的浏览路径。 + +![服务仪表板](images/products.png "服务仪表板") + + + +## 产品实例信息 +{: #product-insights_productinstances} +选择产品实例时，**实例详细信息**窗格中会填充信息。该窗格通过**顾问程序**选项卡，显示产品实例的使用情况数据、产品详细信息和建议。 + + +## 使用情况信息 +{: #product-insights_usage} +使用情况信息显示在**使用情况**选项卡上。使用两个下拉列表来选择要显示的度量值（如果产品实例发送多个度量值）和要显示的时间段。 + +如果产品实例发送多个度量值，请使用第一个下拉列表来选择要显示的度量值。从第二个下拉列表中选择要显示的时间段。部分的时间段选项为“过去 24 小时”、“1 周”、“1 个月”、“6 个月”、“1 年”。 + +第一部分显示所选时间段内，平均最大、平均、平均最小和总计度量值。第二部分以 X 轴为时间段，显示时间段内值的图形，其根据所选时间段而变更。例如，“过去 24 小时”显示每个小时的图形点，而“1 周”显示该周内每天的图形点。最后的部分显示所选图形点的最大、平均和最小值。要在图形上查看其他点的值，请将时间条拖到新位置。 + +如果该时间段没有任何数据，则会显示一条消息。例如，已停止的实例不会提供数据，所以当停止时，该时间段不会显示任何数据。其他时间段可以具有要显示的使用情况。在下拉列表中更改时间段以查看其他时间段。 + +**详细信息**选项卡显示产品实例信息，其可包括以下项： + +* 产品名称和版本 +* 产品的安装位置，包括主机名和目录 +* 启动时实例发送信息的最后时间 +* 产品在单个目录中可以具有多个实例时的实例标识 + +![产品实例详细信息](images/instancedetail.png "产品实例详细信息") + +产品实例还提供以下可选信息： + +* 安装的 APAR 列表。 +* 操作系统及其版本，其显示在**环境**选项卡中。 +![产品实例详细信息 - 环境选项卡](images/instancedetails-env.png "产品实例详细信息 - 环境选项卡") +* 组件或已安装的功能，其显示在**组件**选项卡中。示例不会显示**组件**选项卡，因为 IBM Product XYZ 的实例不会提供任何其他组件信息。 +![产品实例详细信息 - 组件选项卡](images/instancedetails-comps.png "产品实例详细信息 - 组件选项卡") +* 产品实例的唯一标识，其为主机名、目录和实例标识的组合。 + + + + +## 搜索 +{: #product-insights_search} +**产品实例**窗格提供基本搜索功能以过滤产品列表。在搜索字段中，键入要用于搜索的字符串。仅可搜索产品实例数据（即**详细信息**选项卡中的信息）。 + + + + + +## 获取 {{site.data.keyword.product-insights_short}} 的帮助 +{: #gettinghelp} + +在 [{{site.data.keyword.product-insights_full}} 技术社区](https://developer.ibm.com/product-insights/)中可以找到创建服务、获取已启用 IBM 软件产品更新，以及安装和配置步骤的详细信息。如果在使用 {{site.data.keyword.product-insights_short}} 时有问题，请在社区的论坛部分查看或发布问题。这些问题将由开发和客户项目团队处理。 + +您还可以使用 Stack Overflow 和 IBM DeveloperWorks dw Answers 论坛来查看或发布问题。有关服务和入门指示信息的问题，请使用 IBM developerWorks dW Answers。当您在这两个论坛中的任何一个上发布问题时，请应用以下标记规则，以便 Bluemix 开发团队能够轻易地查看您的问题。 + +* 单击以在 [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window} 上发布问题，将您的问题以“ibm-bluemix”和“productinsights”进行标记。 +* 单击以在 [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window} 上发布问题，将您的问题以“productinsights”或“hybridconnect”进行标记。 + +有关使用论坛的更多信息，请参阅[获取帮助](https://www.{DomainName}/docs/support/index.html#getting-help)主题。 diff --git a/services/product-insights/nl/zh/TW/index.md b/services/product-insights/nl/zh/TW/index.md index 0448c8ec5..97280645e 100644 --- a/services/product-insights/nl/zh/TW/index.md +++ b/services/product-insights/nl/zh/TW/index.md @@ -1,50 +1,50 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# 開始使用 {{site.data.keyword.product-insights_short}} -{: #product-insights} - -{{site.data.keyword.product-insights_full}} 會連接至內部部署的 IBM 軟體產品，以建置跨產品的庫存，並提供關於產品用量度量值的見解。 - -{:shortdesc} - -{{site.data.keyword.product-insights_short}} 服務會在 IBM Bluemix 內執行，並接收來自已啟用之內部部署 IBM 軟體產品的資訊。這項資訊接著會顯示在服務實例儀表板內。若要使用服務，您必須有 Bluemix 帳戶，並在組織及空間中建立服務。您的已啟用內部部署產品的產品及用量資訊，會在該項獨特服務的範圍或環境定義中安全地儲存與檢視。 - -提示：為了簡單起見，您可以一開始使用單一服務實例。 - -若要開始使用 {{site.data.keyword.product-insights_short}}，請完成下列步驟： - -1. 在**管理**標籤中，按一下**登錄產品**按鈕，以檢視支援的產品清單，以及所需的版本層次。我們提供了每個產品類型的指示，以便您能將內部部署產品實例連接到 {{site.data.keyword.product-insights_short}} 服務。如果需要，請將您的已啟用內部部署 IBM 軟體產品更新至最低的必要層次。若為需要最低支援層次的產品，請安裝修正套件或臨時修正程式，以便啟用與 {{site.data.keyword.product-insights_short}} 的整合。 -2. 將您的已啟用內部部署 IBM 軟體產品連接至 {{site.data.keyword.product-insights_short}} 服務。在每個產品的配置過程中，您需要服務認證（亦即 apikey 和 apihost）。您可以在服務儀表板的**服務認證**標籤找到服務認證。 -3. 啟用並連接每個產品實例之後，您可能需要啟動或重新啟動產品或產品實例，它們才能提供產品及用量資訊給 {{site.data.keyword.product-insights_short}} 服務。 - -如需啟用產品的詳細資料、每個產品所需的最低支援層次，以及如何啟用每個產品以和 {{site.data.keyword.product-insights_short}} 整合，請加入 {{site.data.keyword.product-insights_full}} [技術社群](https://developer.ibm.com/product-insights/)。 - -您可以在服務儀表板選取**管理**，來檢視您的庫存。 - -* 在服務儀表板中，已連接的產品名稱會列在**產品**窗格中。 -* 若要顯示所有產品實例，請選取**檢視全部**。若要顯示產品的產品實例，請從**產品**窗格選取該產品，它們便會顯示在**實例**窗格。 -* 若要顯示單一產品實例的詳細資料，請從**實例**窗格選取產品實例。**詳細資料**窗格隨即移入資料。**詳細資料**窗格會顯示產品實例的詳細資料，以及從實例傳送的用量資訊。 -* **用量**標籤會以圖形格式顯示產品用量資訊。視產品而定，您可以指定想要檢視的資訊類型，以及取樣期間。 -* **詳細資料**標籤會顯示產品實例資訊；包括產品資訊、環境資訊及元件資訊。 -* 在其**服務**標籤的**警告器**標籤中，提供了可能對現行產品實例有益的其他服務詳細資料。在其**更新**標籤中，提供了產品實例版本層次及其貨幣的資訊。 - - - - - - - - - - +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# 開始使用 {{site.data.keyword.product-insights_short}} +{: #product-insights} + +{{site.data.keyword.product-insights_full}} 會連接至內部部署的 IBM 軟體產品，以建置跨產品的庫存，並提供關於產品用量度量值的見解。 + +{:shortdesc} + +{{site.data.keyword.product-insights_short}} 服務會在 IBM Bluemix 內執行，並接收來自已啟用之內部部署 IBM 軟體產品的資訊。這項資訊接著會顯示在服務實例儀表板內。若要使用服務，您必須有 Bluemix 帳戶，並在組織及空間中建立服務。您的已啟用內部部署產品的產品及用量資訊，會在該項獨特服務的範圍或環境定義中安全地儲存與檢視。 + +提示：為了簡單起見，您可以一開始使用單一服務實例。 + +若要開始使用 {{site.data.keyword.product-insights_short}}，請完成下列步驟： + +1. 在**管理**標籤中，按一下**登錄產品**按鈕，以檢視支援的產品清單，以及所需的版本層次。我們提供了每個產品類型的指示，以便您能將內部部署產品實例連接到 {{site.data.keyword.product-insights_short}} 服務。如果需要，請將您的已啟用內部部署 IBM 軟體產品更新至最低的必要層次。若為需要最低支援層次的產品，請安裝修正套件或臨時修正程式，以便啟用與 {{site.data.keyword.product-insights_short}} 的整合。 +2. 將您的已啟用內部部署 IBM 軟體產品連接至 {{site.data.keyword.product-insights_short}} 服務。在每個產品的配置過程中，您需要服務認證（亦即 apikey 和 apihost）。您可以在服務儀表板的**服務認證**標籤找到服務認證。 +3. 啟用並連接每個產品實例之後，您可能需要啟動或重新啟動產品或產品實例，它們才能提供產品及用量資訊給 {{site.data.keyword.product-insights_short}} 服務。 + +如需啟用產品的詳細資料、每個產品所需的最低支援層次，以及如何啟用每個產品以和 {{site.data.keyword.product-insights_short}} 整合，請加入 {{site.data.keyword.product-insights_full}} [技術社群](https://developer.ibm.com/product-insights/)。 + +您可以在服務儀表板選取**管理**，來檢視您的庫存。 + +* 在服務儀表板中，已連接的產品名稱會列在**產品**窗格中。 +* 若要顯示所有產品實例，請選取**檢視全部**。若要顯示產品的產品實例，請從**產品**窗格選取該產品，它們便會顯示在**實例**窗格。 +* 若要顯示單一產品實例的詳細資料，請從**實例**窗格選取產品實例。**詳細資料**窗格隨即移入資料。**詳細資料**窗格會顯示產品實例的詳細資料，以及從實例傳送的用量資訊。 +* **用量**標籤會以圖形格式顯示產品用量資訊。視產品而定，您可以指定想要檢視的資訊類型，以及取樣期間。 +* **詳細資料**標籤會顯示產品實例資訊；包括產品資訊、環境資訊及元件資訊。 +* 在其**服務**標籤的**警告器**標籤中，提供了可能對現行產品實例有益的其他服務詳細資料。在其**更新**標籤中，提供了產品實例版本層次及其貨幣的資訊。 + + + + + + + + + + diff --git a/services/product-insights/nl/zh/TW/product-insights_overview.md b/services/product-insights/nl/zh/TW/product-insights_overview.md index 77eff976d..559f6415a 100644 --- a/services/product-insights/nl/zh/TW/product-insights_overview.md +++ b/services/product-insights/nl/zh/TW/product-insights_overview.md @@ -1,145 +1,145 @@ ---- - -copyright: - years: 2016, 2017 -lastupdated: "2017-3-3" - ---- - - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# 關於 IBM {{site.data.keyword.product-insights_short}} -{: #about_product-insights} - -{{site.data.keyword.product-insights_full}} 是一項 IBM Bluemix 服務，屬於 IBM Connect to Cloud 的一部分。它會將您的內部部署 IBM 軟體產品連接至 {{site.data.keyword.product-insights_short}} 服務，並提供執行中庫存與運行環境用量度量值的深入了解。 - -{:shortdesc} - -{{site.data.keyword.product-insights_short}} 服務是進入點，未來可能會新增更多功能。 - -{{site.data.keyword.product-insights_short}} 提供下列特性： - -* 向 IBM 登錄您的內部部署 IBM 軟體產品，尤其是 Bluemix 服務。 -* 針對已連接的內部部署產品及相關聯用量資料的資料收集。 -* 運行環境用量資料的儀表板，以便提供產品用量與工作負載的真實深入了解。 - - -若要使用 {{site.data.keyword.product-insights_short}} 功能，請完成下列步驟： - -1. 在 Bluemix 內為 {{site.data.keyword.product-insights_short}} 建立至少一個服務。 -1. 將您的內部部署 IBM 軟體產品升級至必要的版次層次，以及新增每個產品安裝的啟用程式碼。 -1. 使用 {{site.data.keyword.product-insights_short}} 服務實例的 {{site.data.keyword.bluemix_short}} 認證配置軟體安裝。您的所有資料都會以這些認證安全地儲存。只有對服務具有適當許可權的人能夠使用該資料。 - - - -## 運作方式 -{: #product-insights_howitworks} -{{site.data.keyword.product-insights_full}} 服務與您的內部部署 IBM 軟體產品整合，以便收集和顯示運行環境產品資訊與用量度量值。在一開始，會啟用一部分的 IBM 軟體產品以便與此服務整合。登錄並連接之後，內部部署軟體產品會定期傳送啟動與用量資訊。資訊透過已配置的認證與此服務實例進行相關的儲存。您可以使用服務實例儀表板，在 Bluemix 內檢視資訊。 - -{{site.data.keyword.product-insights_short}} 解決方案包含多個元件，如下所示： - -![{{site.data.keyword.product-insights_full}} 架構](images/architecture_product-insights.png "{{site.data.keyword.product-insights_full}} 架構")。 - - -## 組織及空間 -{: #product-insights_orgs} -您的 {{site.data.keyword.product-insights_full}} 服務與單一 Bluemix 組織及空間相關聯，並且有唯一的認證。您必須設定至少一個 Bluemix 組織及空間。如果您要區隔資料，例如，限制只有特定人能存取，則可以在組織內建立多個空間，在每個空間有一個服務實例。每個服務實例都有唯一的認證，您需要為您的 IBM 軟體產品提供此認證。 - -對於使用一組認證配置的產品，只能在服務內以那些認證看到其資訊。可以視需要建立多個服務來區隔資料，每個服務都具有唯一的認證。 - - -## 服務儀表板 -{: #service_dashboard} -建立服務實例之後，您會被導向服務儀表板。您隨時都可按一下組織儀表板中的服務圖示，回到服務儀表板。從服務儀表板，您可以存取下列項目： - -* 開始使用文件 -* 連接內部部署產品所需的服務認證 -* 支援產品的庫存，以及向 {{site.data.keyword.product-insights_short}} 服務實例登錄的任何運行環境實例 -* 已連接運行環境實例的用量資訊 -* 已連接運行環境實例的產品及環境資訊 - -如果「管理」標籤中未列出任何產品，請按一下**登錄產品**，以檢視支援的產品清單，以及存取連接產品實例的特定詳細資料。 -![沒有任何登錄產品的服務儀表板](images/NoRegisteredProducts.jpg "沒有任何登錄產品的服務儀表板") - -## 登錄產品 -{: #product-insights_register} -在**管理**標籤中，按一下**登錄產品**，以檢視支援的產品清單。捲動到您的產品，或使用搜尋欄位過濾產品的清單。 -![可以登錄的已過濾產品清單](images/products-filtered.png "可以登錄的已過濾產品清單") - -若要檢視登錄產品實例的指示，請從清單選取該產品。 - -當您將產品實例連接至 {{site.data.keyword.product-insights_short}} 服務時，它會顯示在儀表板的**管理**標籤。儀表板可以列出不同產品的多個已連接產品實例。 - -## 產品庫存 -{: #product-insights_products} -啟用產品實例以傳送資料到 {{site.data.keyword.product-insights_short}} 之後，您可以在服務儀表板選取**管理**，來檢視您的庫存。 - -![具有產品及產品實例的服務儀表板](images/productinstances.png "具有產品及產品實例的服務儀表板") - -對於 {{site.data.keyword.product-insights_short}} 而言，產品與產品實例不同。產品有產品名稱，像是 IBM MQ 或 IBM WebSphere Application Server Liberty Network Deployment。產品實例用來在產品安裝並執行之後代表產品。部分產品有多個從相同產品安裝內執行的實例。例如，WebSphere Application Server Liberty Network Deployment 可以執行多個從單一產品安裝建立的伺服器。 - -在服務儀表板中，登錄產品的名稱會顯示在**產品**窗格中的*檢視全部* 選項下。已連接的實例列在**實例**窗格中。此窗格包含**產品**窗格中所選產品的實例。在下列範例中，所有產品實例都會顯示，因為在「產品」窗格中選取了*檢視全部* 選項。此範例顯示六個產品，部分已有多個連接實例。您可以使用**搜尋實例**欄位或選取產品項目來過濾實例清單。若要檢視產品實例的詳細資料，請在**實例**窗格中選取它的項目。 - -顯示的產品實例清單會在您瀏覽時過濾。為了輔助導覽，畫面上會顯示所選實例的瀏覽路徑。 - -![服務儀表板](images/products.png "服務儀表板") - - - -## 產品實例資訊 -{: #product-insights_productinstances} -選取產品實例時，**實例詳細資料**窗格中會移入資料。窗格會顯示產品實例的用量資料、產品詳細資料，及透過**警告器**標籤顯示其建議。 - - -## 用量資訊 -{: #product-insights_usage} -用量資訊顯示在**用量**標籤上。使用兩個下拉清單可選取要顯示的度量值（如果產品實例傳送多個度量值），以及要顯示的時段。 - -如果產品實例傳送多個度量值，請使用第一個下拉清單選取要顯示哪個度量值。從第二個下拉清單選取要顯示的時段。各區段的時段選項有最近 24 小時、1 週、1 個月、6 個月、1 年。 - -第一個區段顯示在所選時段之度量值的平均最大值、平均值、平均最小值以及總計。第二個區段顯示具有 X 軸期間的時段內之值的圖形，X 軸期間會根據選取的時段而改變。例如，最近 24 小時會顯示一小時的圖形點，而 1 週則顯示該週內每天的圖形點。最後的區段顯示所選圖形點的最大值、平均值和最小值。若要在圖形上查看另一個點的值，請將時間列拖曳到新的位置。 - -如果該時段沒有資料，會顯示一則訊息。例如，已停止的實例不會提供資料，因此針對它已停止的時段便不會顯示任何資料。其他時段可能有用量可顯示。請在下拉清單中變更時段以查看其他時段。 - -**詳細資料**標籤會顯示產品實例資訊，這可能包括下列項目： - -* 產品名稱及版本 -* 產品安裝的位置，包括主機名稱及目錄 -* 實例在啟動時傳送資訊的最後時間 -* 實例 ID，如果產品可以在單一目錄內有多個實例的話 - -![產品實例詳細資料](images/instancedetail.png "產品實例詳細資料") - -產品實例也會提供下列選用性資訊： - -* 已安裝的 APAR 清單。 -* 作業系統及其版本，顯示於**環境**標籤。 -![產品實例詳細資料 - 環境標籤](images/instancedetails-env.png "產品實例詳細資料 - 環境標籤") -* 元件或已安裝的特性，顯示於**元件**標籤。範例不會顯示**元件**標籤，因為 IBM Product XYZ 的實例未提供任何其他元件資訊。 -![產品實例詳細資料 - 元件標籤](images/instancedetails-comps.png "產品實例詳細資料 - 元件標籤") -* 產品實例的唯一 ID，這是主機名稱、目錄及實例 ID 的組合。 - - - - -## 搜尋 -{: #product-insights_search} -**產品實例**窗格提供基本的搜尋功能，可以過濾產品清單。在搜尋欄位中，鍵入您要用於搜尋的字串。搜尋只能針對產品實例資料進行（亦即，**詳細資料**標籤中的資訊）。 - - - - - -## 取得 {{site.data.keyword.product-insights_short}} 的協助 -{: #gettinghelp} - -關於建立服務、取得已啟用 IBM 軟體產品的更新，和安裝與配置步驟的詳細資訊，可以在 [{{site.data.keyword.product-insights_full}} 技術社群](https://developer.ibm.com/product-insights/)找到。如果您在使用 {{site.data.keyword.product-insights_short}} 時有問題或疑問，請在社群的論壇區段檢視或張貼問題。這些問題會由開發及客戶計畫團隊處理。 - -您也可以使用 Stack Overflow 及 IBM DeveloperWorks dw Answers 論壇來檢視或張貼問題。若為服務及開始使用指示的相關問題，請使用 IBM developerWorks dW Answers。當您在這兩個論壇張貼問題時，請套用下列標記規則以便 Bluemix 開發團隊能輕鬆看到您的問題。 - -* 按一下以在 [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window} 上張貼、使用 "ibm-bluemix" 和 "productinsights" 標記您的問題。 -* 按一下以在 [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window} 上張貼、使用 "productinsights" 或 "hybridconnect" 標記您的問題。 - -如需使用論壇的相關資訊，請參閱[取得協助](https://www.{DomainName}/docs/support/index.html#getting-help)主題。 +--- + +copyright: + years: 2016, 2017 +lastupdated: "2017-3-3" + +--- + + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# 關於 IBM {{site.data.keyword.product-insights_short}} +{: #about_product-insights} + +{{site.data.keyword.product-insights_full}} 是一項 IBM Bluemix 服務，屬於 IBM Connect to Cloud 的一部分。它會將您的內部部署 IBM 軟體產品連接至 {{site.data.keyword.product-insights_short}} 服務，並提供執行中庫存與運行環境用量度量值的深入了解。 + +{:shortdesc} + +{{site.data.keyword.product-insights_short}} 服務是進入點，未來可能會新增更多功能。 + +{{site.data.keyword.product-insights_short}} 提供下列特性： + +* 向 IBM 登錄您的內部部署 IBM 軟體產品，尤其是 Bluemix 服務。 +* 針對已連接的內部部署產品及相關聯用量資料的資料收集。 +* 運行環境用量資料的儀表板，以便提供產品用量與工作負載的真實深入了解。 + + +若要使用 {{site.data.keyword.product-insights_short}} 功能，請完成下列步驟： + +1. 在 Bluemix 內為 {{site.data.keyword.product-insights_short}} 建立至少一個服務。 +1. 將您的內部部署 IBM 軟體產品升級至必要的版次層次，以及新增每個產品安裝的啟用程式碼。 +1. 使用 {{site.data.keyword.product-insights_short}} 服務實例的 {{site.data.keyword.bluemix_short}} 認證配置軟體安裝。您的所有資料都會以這些認證安全地儲存。只有對服務具有適當許可權的人能夠使用該資料。 + + + +## 運作方式 +{: #product-insights_howitworks} +{{site.data.keyword.product-insights_full}} 服務與您的內部部署 IBM 軟體產品整合，以便收集和顯示運行環境產品資訊與用量度量值。在一開始，會啟用一部分的 IBM 軟體產品以便與此服務整合。登錄並連接之後，內部部署軟體產品會定期傳送啟動與用量資訊。資訊透過已配置的認證與此服務實例進行相關的儲存。您可以使用服務實例儀表板，在 Bluemix 內檢視資訊。 + +{{site.data.keyword.product-insights_short}} 解決方案包含多個元件，如下所示： + +![{{site.data.keyword.product-insights_full}} 架構](images/architecture_product-insights.png "{{site.data.keyword.product-insights_full}} 架構")。 + + +## 組織及空間 +{: #product-insights_orgs} +您的 {{site.data.keyword.product-insights_full}} 服務與單一 Bluemix 組織及空間相關聯，並且有唯一的認證。您必須設定至少一個 Bluemix 組織及空間。如果您要區隔資料，例如，限制只有特定人能存取，則可以在組織內建立多個空間，在每個空間有一個服務實例。每個服務實例都有唯一的認證，您需要為您的 IBM 軟體產品提供此認證。 + +對於使用一組認證配置的產品，只能在服務內以那些認證看到其資訊。可以視需要建立多個服務來區隔資料，每個服務都具有唯一的認證。 + + +## 服務儀表板 +{: #service_dashboard} +建立服務實例之後，您會被導向服務儀表板。您隨時都可按一下組織儀表板中的服務圖示，回到服務儀表板。從服務儀表板，您可以存取下列項目： + +* 開始使用文件 +* 連接內部部署產品所需的服務認證 +* 支援產品的庫存，以及向 {{site.data.keyword.product-insights_short}} 服務實例登錄的任何運行環境實例 +* 已連接運行環境實例的用量資訊 +* 已連接運行環境實例的產品及環境資訊 + +如果「管理」標籤中未列出任何產品，請按一下**登錄產品**，以檢視支援的產品清單，以及存取連接產品實例的特定詳細資料。 +![沒有任何登錄產品的服務儀表板](images/NoRegisteredProducts.jpg "沒有任何登錄產品的服務儀表板") + +## 登錄產品 +{: #product-insights_register} +在**管理**標籤中，按一下**登錄產品**，以檢視支援的產品清單。捲動到您的產品，或使用搜尋欄位過濾產品的清單。 +![可以登錄的已過濾產品清單](images/products-filtered.png "可以登錄的已過濾產品清單") + +若要檢視登錄產品實例的指示，請從清單選取該產品。 + +當您將產品實例連接至 {{site.data.keyword.product-insights_short}} 服務時，它會顯示在儀表板的**管理**標籤。儀表板可以列出不同產品的多個已連接產品實例。 + +## 產品庫存 +{: #product-insights_products} +啟用產品實例以傳送資料到 {{site.data.keyword.product-insights_short}} 之後，您可以在服務儀表板選取**管理**，來檢視您的庫存。 + +![具有產品及產品實例的服務儀表板](images/productinstances.png "具有產品及產品實例的服務儀表板") + +對於 {{site.data.keyword.product-insights_short}} 而言，產品與產品實例不同。產品有產品名稱，像是 IBM MQ 或 IBM WebSphere Application Server Liberty Network Deployment。產品實例用來在產品安裝並執行之後代表產品。部分產品有多個從相同產品安裝內執行的實例。例如，WebSphere Application Server Liberty Network Deployment 可以執行多個從單一產品安裝建立的伺服器。 + +在服務儀表板中，登錄產品的名稱會顯示在**產品**窗格中的*檢視全部* 選項下。已連接的實例列在**實例**窗格中。此窗格包含**產品**窗格中所選產品的實例。在下列範例中，所有產品實例都會顯示，因為在「產品」窗格中選取了*檢視全部* 選項。此範例顯示六個產品，部分已有多個連接實例。您可以使用**搜尋實例**欄位或選取產品項目來過濾實例清單。若要檢視產品實例的詳細資料，請在**實例**窗格中選取它的項目。 + +顯示的產品實例清單會在您瀏覽時過濾。為了輔助導覽，畫面上會顯示所選實例的瀏覽路徑。 + +![服務儀表板](images/products.png "服務儀表板") + + + +## 產品實例資訊 +{: #product-insights_productinstances} +選取產品實例時，**實例詳細資料**窗格中會移入資料。窗格會顯示產品實例的用量資料、產品詳細資料，及透過**警告器**標籤顯示其建議。 + + +## 用量資訊 +{: #product-insights_usage} +用量資訊顯示在**用量**標籤上。使用兩個下拉清單可選取要顯示的度量值（如果產品實例傳送多個度量值），以及要顯示的時段。 + +如果產品實例傳送多個度量值，請使用第一個下拉清單選取要顯示哪個度量值。從第二個下拉清單選取要顯示的時段。各區段的時段選項有最近 24 小時、1 週、1 個月、6 個月、1 年。 + +第一個區段顯示在所選時段之度量值的平均最大值、平均值、平均最小值以及總計。第二個區段顯示具有 X 軸期間的時段內之值的圖形，X 軸期間會根據選取的時段而改變。例如，最近 24 小時會顯示一小時的圖形點，而 1 週則顯示該週內每天的圖形點。最後的區段顯示所選圖形點的最大值、平均值和最小值。若要在圖形上查看另一個點的值，請將時間列拖曳到新的位置。 + +如果該時段沒有資料，會顯示一則訊息。例如，已停止的實例不會提供資料，因此針對它已停止的時段便不會顯示任何資料。其他時段可能有用量可顯示。請在下拉清單中變更時段以查看其他時段。 + +**詳細資料**標籤會顯示產品實例資訊，這可能包括下列項目： + +* 產品名稱及版本 +* 產品安裝的位置，包括主機名稱及目錄 +* 實例在啟動時傳送資訊的最後時間 +* 實例 ID，如果產品可以在單一目錄內有多個實例的話 + +![產品實例詳細資料](images/instancedetail.png "產品實例詳細資料") + +產品實例也會提供下列選用性資訊： + +* 已安裝的 APAR 清單。 +* 作業系統及其版本，顯示於**環境**標籤。 +![產品實例詳細資料 - 環境標籤](images/instancedetails-env.png "產品實例詳細資料 - 環境標籤") +* 元件或已安裝的特性，顯示於**元件**標籤。範例不會顯示**元件**標籤，因為 IBM Product XYZ 的實例未提供任何其他元件資訊。 +![產品實例詳細資料 - 元件標籤](images/instancedetails-comps.png "產品實例詳細資料 - 元件標籤") +* 產品實例的唯一 ID，這是主機名稱、目錄及實例 ID 的組合。 + + + + +## 搜尋 +{: #product-insights_search} +**產品實例**窗格提供基本的搜尋功能，可以過濾產品清單。在搜尋欄位中，鍵入您要用於搜尋的字串。搜尋只能針對產品實例資料進行（亦即，**詳細資料**標籤中的資訊）。 + + + + + +## 取得 {{site.data.keyword.product-insights_short}} 的協助 +{: #gettinghelp} + +關於建立服務、取得已啟用 IBM 軟體產品的更新，和安裝與配置步驟的詳細資訊，可以在 [{{site.data.keyword.product-insights_full}} 技術社群](https://developer.ibm.com/product-insights/)找到。如果您在使用 {{site.data.keyword.product-insights_short}} 時有問題或疑問，請在社群的論壇區段檢視或張貼問題。這些問題會由開發及客戶計畫團隊處理。 + +您也可以使用 Stack Overflow 及 IBM DeveloperWorks dw Answers 論壇來檢視或張貼問題。若為服務及開始使用指示的相關問題，請使用 IBM developerWorks dW Answers。當您在這兩個論壇張貼問題時，請套用下列標記規則以便 Bluemix 開發團隊能輕鬆看到您的問題。 + +* 按一下以在 [Stack Overflow](http://stackoverflow.com/search?q=hybrid-connect+ibm-bluemix){:new_window} 上張貼、使用 "ibm-bluemix" 和 "productinsights" 標記您的問題。 +* 按一下以在 [IBM developerWorks dW Answers](https://developer.ibm.com/answers/smartspace/productinsights/){:new_window} 上張貼、使用 "productinsights" 或 "hybridconnect" 標記您的問題。 + +如需使用論壇的相關資訊，請參閱[取得協助](https://www.{DomainName}/docs/support/index.html#getting-help)主題。 diff --git a/services/reqnsi.md b/services/reqnsi.md index 1e4bf1ac3..dec7a5708 100644 --- a/services/reqnsi.md +++ b/services/reqnsi.md @@ -11,7 +11,7 @@ lastupdated: "2017-01-11" {:shortdesc: .shortdesc} -#Services +# Services {: #services} You can find available services in the **Catalog** under **Services** in the {{site.data.keyword.Bluemix}} user interface. @@ -60,7 +60,7 @@ To use a service in the {{site.data.keyword.Bluemix_notm}} user interface, cf co 3. Write your own code in your application to interact with the service. -##Services by region +## Services by region Not all services are available in every {{site.data.keyword.Bluemix_notm}} region. The following table shows the services that are provided by IBM. diff --git a/services/visual-recognition-dedicated/customizing.md b/services/visual-recognition-dedicated/customizing.md index 399c6775f..64b4dbfce 100644 --- a/services/visual-recognition-dedicated/customizing.md +++ b/services/visual-recognition-dedicated/customizing.md @@ -1,193 +1,193 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-31" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# Guidelines for training classifiers -{: #classifier} - -After you classify an image and create, train, and query a custom classifier with the example data in the [Creating a custom classifier tutorial](tutorial-custom-classifier.html), you will want to classify your own data or create your own custom classifier. -{: shortdesc} - -## Default classifier categories -{: #default-classifiers} - -The default classifier returns classes from thousands of possible tags organized into categories and subcategories. The following list shows the top-level categories: - -- Animals (including birds, reptiles, amphibians, etc.) - -- Person and people-oriented information and activities - -- Food (including cooked food and beverages) - -- Plants (including trees, shrubs, aquatic plants, vegetables) - -- Sports - -- Nature (including many types of natural formations, geological structures) - -- Transportation (land, water, air) - -- And many more, including furnishings, fruits, musical instruments, tools, colors, gadgets, devices, instruments, weapons, buildings, structures and man-made objects, clothing and garments, and flowers, among others. - -### Classify response hierarchy -{: notoc} - -The `/v3/classify` method classifies images within a hierarchy of related classes. For example, a picture of a Beagle might be classified as "animal" as well as the related "dog" and "beagle". A positive match with the related classes, in this case "dog" and "beagle", boosts the score of the parent response. In this example, the response includes all three classes: "animal", "dog", and "beagle". The score of the parent class ("animal") is boosted because it matches the related classes ("dog" and "beagle"). The parent is also a "type\_hierarchy" to show that it is a parent of the hierarchy. - -## Structure of the training data -{: #structure} - -A custom classifier is a group of classes that are trained against each other. This allows you to create a multi-faceted classifier that can identify highly specialized subjects, while also providing a score for each individual class. - -During classifier training, classes are created when you upload separate compressed (.zip) files of positive examples for each class. For example, to create a classifier called "fruit", you might upload a .zip file of images of pears, a .zip file of images of apples, and a .zip file of images of bananas in a single training call. - -You can also provide a .zip file of negative examples in the same training call to further hone your classifier. Negative example files are not used to create a class. For the custom classifier "fruit", you might provide a .zip file with images of various vegetables. - -![Fruit classifier with positive and negative examples](images/classifier.png) - -After training completes, when the service identifies fruit in an image, it will return the classifier "fruit" as an array containing the classes "pears", "apples", and "bananas" with their respective confidence scores. - -**Important**: The `POST /v3/classifiers` training call requires that you provide at least two example .zip files: two positive examples files, or one positive examples file and one negative examples file. - -Custom classifiers are only accessible to the specific service instance where they were created and cannot be shared with other {{site.data.keyword.Bluemix_notm}} users who do not have access to your instance of the service. - -## Updating custom classifiers -{: #update-classifier} - -You can update an existing classifier by adding new classes, or by adding new images to existing classes. To update the existing classifier, use several compressed (.zip) files, including files containing positive or negative images (.jpg, or .png). You must supply at least one compressed file, with additional positive or negative examples. - -Compressed files containing positive examples are used to create and update "classes" to impact all of the classes in that classifier. The prefix that you specify for each positive example parameter is used as the class name within the new classifier. The "\_positive\_examples" suffix is required. There is no limit on the number of positive example files you can upload in a single call. - -The compressed file containing negative examples is not used to create a class within the created classifier, but does define what the updated classifier is not. Negative example files should contain images that do not depict the subject of any of the positive examples. You can only specify one negative example file in a single call. - -![Fruits classifier retrained with new positive class for oranges and negative class for cheese](images/retrain.png) - -### How retraining works -{: notoc} - -If you train a classifier with three sets of positive class pictures - Apples, Bananas, and Pears - the system trains three models internally. For the Apples model, the group of pictures in "Apples" is trained as a positive example, and the group of pictures uploaded in "Bananas" and "Pears" are trained as negative examples. The system then knows that bananas and pears are not apples. The other classes are used as negative examples for the Bananas, and Pears models as well. - -Next, say you want to retrain your classifier with new positive classes: YellowPears and GreenPears. In order to do this, you'll need to manually look through your old pears.zip folder, and split the images out into two new folders: YellowPears.zip and GreenPears.zip. - -**Important:** Splitting a class definition via retraining is possible, but it calls for great care in organizing the data. You must submit the **exact** same image files to the new folders - no resizing or anything - that you used during the original training. For example, when creating YellowPears or GreenPears, every single yellow pear image from the original pears.zip training set should be exactly copied into the YellowPears.zip folder; otherwise, any image that is not copied exactly will be in the Pears training set, and used as a negative when YellowPears is trained. - -Now, you simply retrain the system with YellowPears.zip and GreenPears.zip as positive examples. When you do this, the system recognizes the exact duplicate images in the YellowPears and GreenPears folders from the original pears.zip folder, and those images are retrained as positive examples for their new classes. The rule is that a duplicate image is kept in the positive set, if it is also found in both the negative and positive set for a class. - -The end result is that the YellowPears and GreenPears classes will have Apples and Bananas as negative examples, but will not have any exact duplicate images from the Pears class as negative examples. - -## Size limitations -{: #size-limits} - -There are size limitations for training calls and data: - -- The service accepts a maximum of 10,000 images or 100 MB per .zip file - -- The service requires a minimum of 10 images per .zip file. - -- The service accepts a maximum of 256 MB per training call. - -- Minimum recommend size of an image is 32X32 pixels. - -There are also size limitations for classification calls: - -- The `POST /v3/classify` methods accept a maximum of 20 images per batch. - -- The `POST /v3/detect_faces` methods accept a maximum of 15 images per batch. - -## Guidelines for good training -{: #good-training} - -The following guidelines are not enforced by the API. However, the service tends to perform better when the training data adheres to them: - -- A minimum of 50 images is recommended in each .zip file, as fewer than 50 images can decrease the quality of the trained classifier. - -- If the quality and content of training data is the same, then classifiers that are trained on more images will generally be more accurate than classifiers that are trained on fewer images. The benefits of training a classifier on more images plateaus at around 5000 images, and this can take a while to process. You can train a classifier on more than 5000 images, but it may not significantly increase that classifier's accuracy. - -- Uploading a total of 150-200 images per .zip file gives you the best balance between the time it takes to train and the improvement to classifier accuracy. More than 200 images increases the time, and it does increase the accuracy, but with diminishing returns for the amount of time it takes. - -- Include approximately the same number of images in each examples file. Including an unequal number of images can cause the quality of the trained classifier to decline. - -- The accuracy of your custom classifier can be affected by the kinds of images you provide to train it. Provide example images that are similar to the images you plan to analyze. For example, if you are training the classifier "tiger", your classifier might be less accurate if you provide only images of tigers in a zoo taken by a mobile phone to train the classifier, but you want to test the classifier on images of tigers in the wild taken by professional photographers. - -## Guidelines for high volume classifying -{: #high-volume} - -If you want to classify many images, submitting one image at a time can take a long time. You can maximize efficiency and performance of the service in the following ways: - -- Resize images to be no larger than 320 pixels in either width or height. Images do not need to be high resolution. - -- Submit images in batches as compressed (.zip) files. - -- Specify only the classifiers you want results for in the `classifier_ids` parameter. If you do not specify a value for this parameter, the service classifies the images against the default classifier and takes longer to return a response. - -## Custom classifier scores -{: #scores} - -The `/classify` method produces a score between 0.0 and 1.0 for each image for each class. This section delves into the meaning of those scores for custom classifiers (as opposed to the default classifier). - -### Background reading -{: notoc} - -- The service performs [statistical classification ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://en.wikipedia.org/wiki/Statistical_classification){:new_window}. - -- You can [measure statistical classifiers ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://en.wikipedia.org/wiki/Category:Information_retrieval_evaluation){:new_window} in several ways. - -### How to use the scores -{: notoc} - -- Think about possible actions to be taken in response to a classification. Specifically, analyze how you will use "true" or "false" positive or negative conditions. These conditions are described in the Background Reading. - -- This cost-benefit balance is crucial to deciding what to do with each class score, and only someone who understands the final application can determine it. The score value needed for the application to take some action is called the "decision threshold." The service does not compute this for you. - -- Custom classifiers use binary "one versus the rest" models to train each class against the other classes. The system assumes that two classes within a classifier cannot occur at the same time, so you should create separate classifiers to test for classes that can exist together, like `blue` and `sky`. Alternatively, you could create a distinct classifier for cases where both classes exist at the same time and test for a class like `blueSky`. - -### Example -{: notoc} - -Imagine that you are monitoring an assigned parking space with a webcam. You train a custom classifier to recognize whether your car is in the spot, some other car is in the spot, the spot is empty, or the camera has been blocked. You collect training examples for each of these cases and train a custom classifier with four classes. Your application classifies images from the webcam to report the status of the spot, and the system notifies you with a message if the status is unexpected. Each time the service classifies the image from the camera, it produces four scores: `myCar`, `unknownCar`, `emptySpot`, and `blockedCamera`. - -The first action to consider is whether to send a notification. - -Suppose you park in your spot and have the service start classifying the images. You see the `myCar` score computed as 0.8 on average over a few hours, while the `unknownCar` score hovers around 0.3, `emptySpot` is around 0.15 and `blockedCamera` is around 0.1. Given this data, you write your code to notify you if the `myCar` score is less than 0.75, or if one of the others is greater than 0.6. During the day, you get about one false alarm every three hours when people walk by and obscure the car. The system sends you the photo along with the notice, so you can see it's nothing to worry about. That seems fine, but then at night those false alarms every three hours get very annoying! Your preferences for day vs. night notification reflect the higher cost of a false alarm at night time for your application. - -So, the notification logic and threshold will probably vary, depending on the perceived risk of car theft, the accuracy of your classifiers, and the amount of annoyance caused by a false alarm. - -Similarly, as a person, you may face the same trade-off. If the system notifies you that the camera has been blocked, the accompanying image will likely simply be all black or gray. Do you go to check on the car in person or ignore it? Again, this depends on your other priorities and the perceived risks. - -### Questions -{: notoc} - -**What do the scores mean?** - -- The scores are comparable indicators, with a range from 0.0 to 1.0. You can compare the scores of two custom classes (from the same or different classifiers) on the same or different images, and the higher one should be more likely to appear in the image than the lower one. However, they may both be present. It is best to pick a decision threshold for each class individually. - -- The custom classifier scores are not comparable to the scores returned by the default classifier (which has `classifier\_id: "default"`) - -- The service attempts to normalize the score output so that 0.5 is a good decision threshold. By default, scores below 0.5 are not reported in the results of `/classify`. You can override this behavior by setting the threshold parameter of the `/classify` method. This normalization is only computed on the training data, so with new data or different application contexts, you might find that a different threshold works better. - -- The scores are unitless and are neither percentages nor probabilities. (They do not add up to 100% or 1.0). - -**Why do I get scores between 0.5 and 0.6 for images that I would expect to return a high score, near 1.0?** - -- You might get lower scores if there is a significant amount of similarity between your classes, so that in the feature space your examples are not in distinct clusters, and the scores reflect this closeness to the best boundary between positives and negatives that the system could learn. - -**How can I evaluate the accuracy of a custom classifier for my use case?** - -There are many ways to do this, here is one: - -1. Assemble a set of labeled images "L" that was not used in training the classifier. - -2. Split L into two sets, V and T - validation and testing. - -3. Run V through your classifier and pick a score threshold "R" which optimizes the correctness metric you value, such as top-5 precision, across all of V. - -4. From T, select a random subset "Q" and classify it using your classifier and "R". Compute the probability of a correct classification on Q. That's one experiment. - +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-31" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# Guidelines for training classifiers +{: #classifier} + +After you classify an image and create, train, and query a custom classifier with the example data in the [Creating a custom classifier tutorial](tutorial-custom-classifier.html), you will want to classify your own data or create your own custom classifier. +{: shortdesc} + +## Default classifier categories +{: #default-classifiers} + +The default classifier returns classes from thousands of possible tags organized into categories and subcategories. The following list shows the top-level categories: + +- Animals (including birds, reptiles, amphibians, etc.) + +- Person and people-oriented information and activities + +- Food (including cooked food and beverages) + +- Plants (including trees, shrubs, aquatic plants, vegetables) + +- Sports + +- Nature (including many types of natural formations, geological structures) + +- Transportation (land, water, air) + +- And many more, including furnishings, fruits, musical instruments, tools, colors, gadgets, devices, instruments, weapons, buildings, structures and man-made objects, clothing and garments, and flowers, among others. + +### Classify response hierarchy +{: notoc} + +The `/v3/classify` method classifies images within a hierarchy of related classes. For example, a picture of a Beagle might be classified as "animal" as well as the related "dog" and "beagle". A positive match with the related classes, in this case "dog" and "beagle", boosts the score of the parent response. In this example, the response includes all three classes: "animal", "dog", and "beagle". The score of the parent class ("animal") is boosted because it matches the related classes ("dog" and "beagle"). The parent is also a "type\_hierarchy" to show that it is a parent of the hierarchy. + +## Structure of the training data +{: #structure} + +A custom classifier is a group of classes that are trained against each other. This allows you to create a multi-faceted classifier that can identify highly specialized subjects, while also providing a score for each individual class. + +During classifier training, classes are created when you upload separate compressed (.zip) files of positive examples for each class. For example, to create a classifier called "fruit", you might upload a .zip file of images of pears, a .zip file of images of apples, and a .zip file of images of bananas in a single training call. + +You can also provide a .zip file of negative examples in the same training call to further hone your classifier. Negative example files are not used to create a class. For the custom classifier "fruit", you might provide a .zip file with images of various vegetables. + +![Fruit classifier with positive and negative examples](images/classifier.png) + +After training completes, when the service identifies fruit in an image, it will return the classifier "fruit" as an array containing the classes "pears", "apples", and "bananas" with their respective confidence scores. + +**Important**: The `POST /v3/classifiers` training call requires that you provide at least two example .zip files: two positive examples files, or one positive examples file and one negative examples file. + +Custom classifiers are only accessible to the specific service instance where they were created and cannot be shared with other {{site.data.keyword.Bluemix_notm}} users who do not have access to your instance of the service. + +## Updating custom classifiers +{: #update-classifier} + +You can update an existing classifier by adding new classes, or by adding new images to existing classes. To update the existing classifier, use several compressed (.zip) files, including files containing positive or negative images (.jpg, or .png). You must supply at least one compressed file, with additional positive or negative examples. + +Compressed files containing positive examples are used to create and update "classes" to impact all of the classes in that classifier. The prefix that you specify for each positive example parameter is used as the class name within the new classifier. The "\_positive\_examples" suffix is required. There is no limit on the number of positive example files you can upload in a single call. + +The compressed file containing negative examples is not used to create a class within the created classifier, but does define what the updated classifier is not. Negative example files should contain images that do not depict the subject of any of the positive examples. You can only specify one negative example file in a single call. + +![Fruits classifier retrained with new positive class for oranges and negative class for cheese](images/retrain.png) + +### How retraining works +{: notoc} + +If you train a classifier with three sets of positive class pictures - Apples, Bananas, and Pears - the system trains three models internally. For the Apples model, the group of pictures in "Apples" is trained as a positive example, and the group of pictures uploaded in "Bananas" and "Pears" are trained as negative examples. The system then knows that bananas and pears are not apples. The other classes are used as negative examples for the Bananas, and Pears models as well. + +Next, say you want to retrain your classifier with new positive classes: YellowPears and GreenPears. In order to do this, you'll need to manually look through your old pears.zip folder, and split the images out into two new folders: YellowPears.zip and GreenPears.zip. + +**Important:** Splitting a class definition via retraining is possible, but it calls for great care in organizing the data. You must submit the **exact** same image files to the new folders - no resizing or anything - that you used during the original training. For example, when creating YellowPears or GreenPears, every single yellow pear image from the original pears.zip training set should be exactly copied into the YellowPears.zip folder; otherwise, any image that is not copied exactly will be in the Pears training set, and used as a negative when YellowPears is trained. + +Now, you simply retrain the system with YellowPears.zip and GreenPears.zip as positive examples. When you do this, the system recognizes the exact duplicate images in the YellowPears and GreenPears folders from the original pears.zip folder, and those images are retrained as positive examples for their new classes. The rule is that a duplicate image is kept in the positive set, if it is also found in both the negative and positive set for a class. + +The end result is that the YellowPears and GreenPears classes will have Apples and Bananas as negative examples, but will not have any exact duplicate images from the Pears class as negative examples. + +## Size limitations +{: #size-limits} + +There are size limitations for training calls and data: + +- The service accepts a maximum of 10,000 images or 100 MB per .zip file + +- The service requires a minimum of 10 images per .zip file. + +- The service accepts a maximum of 256 MB per training call. + +- Minimum recommend size of an image is 32X32 pixels. + +There are also size limitations for classification calls: + +- The `POST /v3/classify` methods accept a maximum of 20 images per batch. + +- The `POST /v3/detect_faces` methods accept a maximum of 15 images per batch. + +## Guidelines for good training +{: #good-training} + +The following guidelines are not enforced by the API. However, the service tends to perform better when the training data adheres to them: + +- A minimum of 50 images is recommended in each .zip file, as fewer than 50 images can decrease the quality of the trained classifier. + +- If the quality and content of training data is the same, then classifiers that are trained on more images will generally be more accurate than classifiers that are trained on fewer images. The benefits of training a classifier on more images plateaus at around 5000 images, and this can take a while to process. You can train a classifier on more than 5000 images, but it may not significantly increase that classifier's accuracy. + +- Uploading a total of 150-200 images per .zip file gives you the best balance between the time it takes to train and the improvement to classifier accuracy. More than 200 images increases the time, and it does increase the accuracy, but with diminishing returns for the amount of time it takes. + +- Include approximately the same number of images in each examples file. Including an unequal number of images can cause the quality of the trained classifier to decline. + +- The accuracy of your custom classifier can be affected by the kinds of images you provide to train it. Provide example images that are similar to the images you plan to analyze. For example, if you are training the classifier "tiger", your classifier might be less accurate if you provide only images of tigers in a zoo taken by a mobile phone to train the classifier, but you want to test the classifier on images of tigers in the wild taken by professional photographers. + +## Guidelines for high volume classifying +{: #high-volume} + +If you want to classify many images, submitting one image at a time can take a long time. You can maximize efficiency and performance of the service in the following ways: + +- Resize images to be no larger than 320 pixels in either width or height. Images do not need to be high resolution. + +- Submit images in batches as compressed (.zip) files. + +- Specify only the classifiers you want results for in the `classifier_ids` parameter. If you do not specify a value for this parameter, the service classifies the images against the default classifier and takes longer to return a response. + +## Custom classifier scores +{: #scores} + +The `/classify` method produces a score between 0.0 and 1.0 for each image for each class. This section delves into the meaning of those scores for custom classifiers (as opposed to the default classifier). + +### Background reading +{: notoc} + +- The service performs [statistical classification ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://en.wikipedia.org/wiki/Statistical_classification){:new_window}. + +- You can [measure statistical classifiers ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://en.wikipedia.org/wiki/Category:Information_retrieval_evaluation){:new_window} in several ways. + +### How to use the scores +{: notoc} + +- Think about possible actions to be taken in response to a classification. Specifically, analyze how you will use "true" or "false" positive or negative conditions. These conditions are described in the Background Reading. + +- This cost-benefit balance is crucial to deciding what to do with each class score, and only someone who understands the final application can determine it. The score value needed for the application to take some action is called the "decision threshold." The service does not compute this for you. + +- Custom classifiers use binary "one versus the rest" models to train each class against the other classes. The system assumes that two classes within a classifier cannot occur at the same time, so you should create separate classifiers to test for classes that can exist together, like `blue` and `sky`. Alternatively, you could create a distinct classifier for cases where both classes exist at the same time and test for a class like `blueSky`. + +### Example +{: notoc} + +Imagine that you are monitoring an assigned parking space with a webcam. You train a custom classifier to recognize whether your car is in the spot, some other car is in the spot, the spot is empty, or the camera has been blocked. You collect training examples for each of these cases and train a custom classifier with four classes. Your application classifies images from the webcam to report the status of the spot, and the system notifies you with a message if the status is unexpected. Each time the service classifies the image from the camera, it produces four scores: `myCar`, `unknownCar`, `emptySpot`, and `blockedCamera`. + +The first action to consider is whether to send a notification. + +Suppose you park in your spot and have the service start classifying the images. You see the `myCar` score computed as 0.8 on average over a few hours, while the `unknownCar` score hovers around 0.3, `emptySpot` is around 0.15 and `blockedCamera` is around 0.1. Given this data, you write your code to notify you if the `myCar` score is less than 0.75, or if one of the others is greater than 0.6. During the day, you get about one false alarm every three hours when people walk by and obscure the car. The system sends you the photo along with the notice, so you can see it's nothing to worry about. That seems fine, but then at night those false alarms every three hours get very annoying! Your preferences for day vs. night notification reflect the higher cost of a false alarm at night time for your application. + +So, the notification logic and threshold will probably vary, depending on the perceived risk of car theft, the accuracy of your classifiers, and the amount of annoyance caused by a false alarm. + +Similarly, as a person, you may face the same trade-off. If the system notifies you that the camera has been blocked, the accompanying image will likely simply be all black or gray. Do you go to check on the car in person or ignore it? Again, this depends on your other priorities and the perceived risks. + +### Questions +{: notoc} + +**What do the scores mean?** + +- The scores are comparable indicators, with a range from 0.0 to 1.0. You can compare the scores of two custom classes (from the same or different classifiers) on the same or different images, and the higher one should be more likely to appear in the image than the lower one. However, they may both be present. It is best to pick a decision threshold for each class individually. + +- The custom classifier scores are not comparable to the scores returned by the default classifier (which has `classifier\_id: "default"`) + +- The service attempts to normalize the score output so that 0.5 is a good decision threshold. By default, scores below 0.5 are not reported in the results of `/classify`. You can override this behavior by setting the threshold parameter of the `/classify` method. This normalization is only computed on the training data, so with new data or different application contexts, you might find that a different threshold works better. + +- The scores are unitless and are neither percentages nor probabilities. (They do not add up to 100% or 1.0). + +**Why do I get scores between 0.5 and 0.6 for images that I would expect to return a high score, near 1.0?** + +- You might get lower scores if there is a significant amount of similarity between your classes, so that in the feature space your examples are not in distinct clusters, and the scores reflect this closeness to the best boundary between positives and negatives that the system could learn. + +**How can I evaluate the accuracy of a custom classifier for my use case?** + +There are many ways to do this, here is one: + +1. Assemble a set of labeled images "L" that was not used in training the classifier. + +2. Split L into two sets, V and T - validation and testing. + +3. Run V through your classifier and pick a score threshold "R" which optimizes the correctness metric you value, such as top-5 precision, across all of V. + +4. From T, select a random subset "Q" and classify it using your classifier and "R". Compute the probability of a correct classification on Q. That's one experiment. + 5. Repeat step 4 with a different subset Q from T, then compute the average % correct across all experiments. \ No newline at end of file diff --git a/services/visual-recognition-dedicated/index.md b/services/visual-recognition-dedicated/index.md index fed6c51a5..cd1f4230d 100644 --- a/services/visual-recognition-dedicated/index.md +++ b/services/visual-recognition-dedicated/index.md @@ -1,110 +1,110 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-31" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:pre: .pre} - -# Getting started with Visual Recognition Dedicated -{: #getting-started} - -The {{site.data.keyword.visualrecognitionshort}} Dedicated service allows you to use default classifiers to classify images. -{: shortdesc} - -## Step 1: Log in, create the service, and get your credentials -You create your free instance of the {{site.data.keyword.visualrecognitionshort}} service through {{site.data.keyword.Bluemix}}, so you need a free {{site.data.keyword.Bluemix_notm}} account to get started. - -**Why {{site.data.keyword.Bluemix_notm}}?** - -{{site.data.keyword.Bluemix_notm}} is the cloud platform for the {{site.data.keyword.visualrecognitionshort}} Dedicated service. For details, see [What is {{site.data.keyword.Bluemix_notm}}? ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://console.ng.bluemix.net/docs/overview/whatisbluemix.html){:new_window} - -**Tip**: The API uses HTTP basic authentication. If you already know your credentials for the {{site.data.keyword.visualrecognitionshort}} service, skip this step. - -1. Log into your {{site.data.keyword.Bluemix_notm}} account. -1. After you log in, in the {{site.data.keyword.visualrecognitionshort}} Dedicated service page, enter a name in the **Service name** field to identify your instance of the service and click **Create**. -1. Copy your credentials: - 1. Click **Service Credentials**. - 2. Copy the `username` and `password` that are associated with the instance. - **Note**: Service credentials (`username` and `password`) are different from your Bluemix account username and password. - -## Step 2: Classifying an image - -**Important**: The endpoint used in this tutorial might not be your service endpoint. Check your endpoint URL on the **Service Credentials** page in your instance of the {{site.data.keyword.visualrecognitionshort}} Dedicated service on {{site.data.keyword.Bluemix_notm}}. - -1. Download the sample [fruitbowl.jpg ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/fruitbowl.jpg){:new_window} image. -1. Issue the following cURL command to upload the image and classify it against all built-in classifiers: - - Replace `{username}` and `{password}` with the service credentials you copied earlier. - - Modify the location of the `images\_file` to point to where you saved the image. - - Replace the `https . . .` endpoint with your endpoint URL - - ```bash - curl -X POST -u "{username}:{password}" -F "images_file=@fruitbowl.jpg" "https://gateway.yourenvironment.watsonplatform.net/visual-recognition/api/v3/classify?version=2016-05-17" - ``` - {: pre} - - The response includes the default classifier, the classes identified in the image, and a score for each class. - -

      - - ```json - { - "custom_classes": 0, - "images": [ - { - "classifiers": [ - { - "classes": [ - { - "class": "banana", - "score": 0.81, - "type_hierarchy": "/fruit/banana" - }, - { - "class": "fruit", - "score": 0.922 - }, - { - "class": "mango", - "score": 0.554, - "type_hierarchy": "/fruit/mango" - }, - { - "class": "olive color", - "score": 0.951 - }, - { - "class": "olive green color", - "score": 0.747 - } - ], - "classifier_id": "default", - "name": "default" - } - ], - "image": "fruitbowl.jpg" - } - ], - "images_processed": 1 - } - ``` - {: screen} - - Scores range from 0-1, with a higher score indicating greater correlation. The `/v3/classify` calls don't include low-scoring classes by default. - -### Attributions -{: #attributions notoc} - -* "[Fruit basket ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://flic.kr/p/JPHES "Fruit basket"){:new_window} by Flikr user [Ryan Edwards-Crewe ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://www.flickr.com/photos/ryanec/){:new_window} used under [Creative Commons Attribution 2.0 license ![External link icon](../../icons/launch-glyph.svg "External link icon")](http://creativecommons.org/licenses/by/2.0/deed.en){:new_window}. No changes were made to this image. - -### Related Links -{: #rellinks notoc} - -### Tutorials and Samples -{: #samples} -* Learn more about how to [Build a custom classifier](tutorial-custom-classifier.html). +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-31" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:pre: .pre} + +# Getting started with Visual Recognition Dedicated +{: #getting-started} + +The {{site.data.keyword.visualrecognitionshort}} Dedicated service allows you to use default classifiers to classify images. +{: shortdesc} + +## Step 1: Log in, create the service, and get your credentials +You create your free instance of the {{site.data.keyword.visualrecognitionshort}} service through {{site.data.keyword.Bluemix}}, so you need a free {{site.data.keyword.Bluemix_notm}} account to get started. + +**Why {{site.data.keyword.Bluemix_notm}}?** + +{{site.data.keyword.Bluemix_notm}} is the cloud platform for the {{site.data.keyword.visualrecognitionshort}} Dedicated service. For details, see [What is {{site.data.keyword.Bluemix_notm}}? ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://console.ng.bluemix.net/docs/overview/whatisbluemix.html){:new_window} + +**Tip**: The API uses HTTP basic authentication. If you already know your credentials for the {{site.data.keyword.visualrecognitionshort}} service, skip this step. + +1. Log into your {{site.data.keyword.Bluemix_notm}} account. +1. After you log in, in the {{site.data.keyword.visualrecognitionshort}} Dedicated service page, enter a name in the **Service name** field to identify your instance of the service and click **Create**. +1. Copy your credentials: + 1. Click **Service Credentials**. + 2. Copy the `username` and `password` that are associated with the instance. + **Note**: Service credentials (`username` and `password`) are different from your Bluemix account username and password. + +## Step 2: Classifying an image + +**Important**: The endpoint used in this tutorial might not be your service endpoint. Check your endpoint URL on the **Service Credentials** page in your instance of the {{site.data.keyword.visualrecognitionshort}} Dedicated service on {{site.data.keyword.Bluemix_notm}}. + +1. Download the sample [fruitbowl.jpg ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/fruitbowl.jpg){:new_window} image. +1. Issue the following cURL command to upload the image and classify it against all built-in classifiers: + - Replace `{username}` and `{password}` with the service credentials you copied earlier. + - Modify the location of the `images\_file` to point to where you saved the image. + - Replace the `https . . .` endpoint with your endpoint URL + + ```bash + curl -X POST -u "{username}:{password}" -F "images_file=@fruitbowl.jpg" "https://gateway.yourenvironment.watsonplatform.net/visual-recognition/api/v3/classify?version=2016-05-17" + ``` + {: pre} + + The response includes the default classifier, the classes identified in the image, and a score for each class. + +

      + + ```json + { + "custom_classes": 0, + "images": [ + { + "classifiers": [ + { + "classes": [ + { + "class": "banana", + "score": 0.81, + "type_hierarchy": "/fruit/banana" + }, + { + "class": "fruit", + "score": 0.922 + }, + { + "class": "mango", + "score": 0.554, + "type_hierarchy": "/fruit/mango" + }, + { + "class": "olive color", + "score": 0.951 + }, + { + "class": "olive green color", + "score": 0.747 + } + ], + "classifier_id": "default", + "name": "default" + } + ], + "image": "fruitbowl.jpg" + } + ], + "images_processed": 1 + } + ``` + {: screen} + + Scores range from 0-1, with a higher score indicating greater correlation. The `/v3/classify` calls don't include low-scoring classes by default. + +### Attributions +{: #attributions notoc} + +* "[Fruit basket ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://flic.kr/p/JPHES "Fruit basket"){:new_window} by Flikr user [Ryan Edwards-Crewe ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://www.flickr.com/photos/ryanec/){:new_window} used under [Creative Commons Attribution 2.0 license ![External link icon](../../icons/launch-glyph.svg "External link icon")](http://creativecommons.org/licenses/by/2.0/deed.en){:new_window}. No changes were made to this image. + +### Related Links +{: #rellinks notoc} + +### Tutorials and Samples +{: #samples} +* Learn more about how to [Build a custom classifier](tutorial-custom-classifier.html). diff --git a/services/visual-recognition-dedicated/release-notes.md b/services/visual-recognition-dedicated/release-notes.md index fb991a823..612779e8c 100644 --- a/services/visual-recognition-dedicated/release-notes.md +++ b/services/visual-recognition-dedicated/release-notes.md @@ -1,27 +1,27 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-02-03" - ---- - -{:new_window: target="_blank"} - -# Release Notes for Visual Recognition Dedicated -The following new features and changes to the service are available. - -## 31 March 2017 -{: notoc} - -This is the General Availability release of the {{site.data.keyword.visualrecognitionshort}} Dedicated service. - -Any custom classifiers that were created while the service was in Beta must be recreated in a GA instance of the service. - -Please be aware of the following items when using the {{site.data.keyword.visualrecognitionshort}} service: - -- **Version date:** To utilize the features of this release, use `2016-05-17` as the value for the `version` parameter. -- **Classes and classifiers:** Single classifiers are called "classes". A group of classes is called a "classifier". -- **Classification:** Use the `POST` or `GET /v3/classify` methods to quickly and accurately identify a variety of subjects and scenes with default classes. -- **Multi-faceted custom classifiers:** You can create and train highly-specialized classifiers that are defined by several classes. For example, you can create a "new\_red\_car" classifier that is defined by the classes "new\_cars" and "red\_cars". To learn more about creating multi-faceted classifiers, see [Structure of the training data](customizing.html#structure). -- **Asynchronous training:** Training of custom classifiers is asynchronous, so training calls complete quickly while your custom classifier continues to learn in the background. To check on the training status of your custom classifier and find out when it is available for use, call the `GET /v3/classifiers/{classifier_id}` method and check the `status` response parameter. +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-02-03" + +--- + +{:new_window: target="_blank"} + +# Release Notes for Visual Recognition Dedicated +The following new features and changes to the service are available. + +## 31 March 2017 +{: notoc} + +This is the General Availability release of the {{site.data.keyword.visualrecognitionshort}} Dedicated service. + +Any custom classifiers that were created while the service was in Beta must be recreated in a GA instance of the service. + +Please be aware of the following items when using the {{site.data.keyword.visualrecognitionshort}} service: + +- **Version date:** To utilize the features of this release, use `2016-05-17` as the value for the `version` parameter. +- **Classes and classifiers:** Single classifiers are called "classes". A group of classes is called a "classifier". +- **Classification:** Use the `POST` or `GET /v3/classify` methods to quickly and accurately identify a variety of subjects and scenes with default classes. +- **Multi-faceted custom classifiers:** You can create and train highly-specialized classifiers that are defined by several classes. For example, you can create a "new\_red\_car" classifier that is defined by the classes "new\_cars" and "red\_cars". To learn more about creating multi-faceted classifiers, see [Structure of the training data](customizing.html#structure). +- **Asynchronous training:** Training of custom classifiers is asynchronous, so training calls complete quickly while your custom classifier continues to learn in the background. To check on the training status of your custom classifier and find out when it is available for use, call the `GET /v3/classifiers/{classifier_id}` method and check the `status` response parameter. diff --git a/services/visual-recognition-dedicated/tutorial-custom-classifier.md b/services/visual-recognition-dedicated/tutorial-custom-classifier.md index 59037870c..7bf1f199e 100644 --- a/services/visual-recognition-dedicated/tutorial-custom-classifier.md +++ b/services/visual-recognition-dedicated/tutorial-custom-classifier.md @@ -1,219 +1,219 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-31" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen: .screen} -{:pre: .pre} - -# Creating a custom classifier -{: #custom-classifier} -After you classify an image, you are ready to train and create a custom classifier. With a custom classifier, you can train the {{site.data.keyword.visualrecognitionshort}} Dedicated service to classify images to suit your business needs. -{: shortdesc} - -## Step 1: Log in, create the service, and get your credentials -If you created your free instance of the {{site.data.keyword.visualrecognitionshort}} Dedicated service in "Getting started", use those credentials for this tutorial. If you haven't created a service, go back and run through those steps in the beginning of [Getting started](index.html). - -## Step 2: Creating a custom classifier -The {{site.data.keyword.visualrecognitionshort}} Dedicated service can learn from example images you upload to create a new, multi-faceted classifier. Each example file is trained against the other files in that call, and positive examples are stored as classes. These classes are grouped to define a single classifier, but return their own scores. - -**Note**: Negative example files are not stored as classes. - -1. Download the [beagle.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/beagle.zip){:new_window}, [husky.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/husky.zip){:new_window}, [golden-retriever.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/golden-retriever.zip){:new_window}, and [cats.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/cats.zip){:new_window} example training files. -2. Call the `POST /v3/classifiers` method with the following cURL command, which uploads the training data and creates the classifier "dogs": - - Replace `{username}` and `{password}` with the service credentials you copied in the first step. - - Modify the location of the `{class}_positive_examples` to point to where you saved the .zip files. - - Replace the `https . . .` endpoint with your endpoint URL - - ```bash - curl -X POST -u "{username}:{password}" -F "beagle_positive_examples=@beagle.zip" -F "husky_positive_examples=@husky.zip" -F "goldenretriever_positive_examples=@golden-retriever.zip" -F "negative_examples=@cats.zip" -F "name=dogs" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classifiers?version=2016-05-20" - ``` - {: pre} - - Positive example filenames require the suffix `_positive_examples`. In this example, the filenames are `beagle_positive_examples`, `goldenretriever_positive_examples`, and `husky_positive_examples`. The prefix (beagle, goldenretriever, and husky) is returned as the name of class. - - The response includes a new classifier ID and status, for example: - -

      - - ```json - { - "classifier_id": "dogs_1941945966", - "name": "dogs", - "owner": "xxxx-xxxxx-xxx-xxxx", - "status": "training", - "created": "2016-05-18T21:32:27.752Z", - "classes": [ - {"class": "husky"}, - {"class": "goldenretriever"}, - {"class": "beagle"} - ] - } - ``` - {: screen} - -3. Check the training status periodically until you see a status of `ready`. Training begins immediately and must finish before you can query the classifier. Replace `{username}`, `{password}`, `{classifier_id}`, and the `https . . .` endpoint with your information: - - ```bash - curl -X GET -u "{username}:{password}" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classifiers/{classifier_id}?version=2016-05-17" - ``` - {: pre} - -## Step 3: Updating an existing custom classifier -You can update an existing {{site.data.keyword.visualrecognitionshort}} Dedicated service custom classifier by adding new classes to an existing classifier, or by adding images to an existing class. Improve on the classifier that you created in step 2 by adding a *Dalmatian* class to the types of dogs which can be classified, and by adding more images of cats to the negative example set for the "dogs" classifier. - -### To add new classes to an existing classifier: - -1. Download the [dalmatian.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/dalmatian.zip){:new_window} and [more-cats.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/more-cats.zip){:new_window} sample training files. - -2. Call the `POST /v3/classifiers/{classifier_id}` method with the following cURL command, which uploads the training data and updates the classifier "dogs\_1941945966": - - Replace `{username}` and `{password}` with the service credentials you copied in the first step. - - Replace `{classifier_id}` with the ID of the classifier you want to update. - - Modify the location of the `{class}_positive_examples` to point to where you saved the .zip files. - - Replace the `https . . .` endpoint with your endpoint URL - - ```bash - curl -X POST -u "{username}:{password}" -F "dalmatian_positive_examples=@dalmatian.zip" -F "negative_examples=@more-cats.zip" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classifiers/{classifier_id}?version=2016-05-17" - ``` - {: pre} - - The existing "dogs" classifier is replaced by the retrained one with the same `classifier_id`. The response lists the new set of classes and the current status. For example: - -

      - - ```json - { - "classifier_id": "dogs_1941945966", - "name": "dogs", - "owner": "xxxx-xxxxx-xxx-xxxx", - "status": "retraining", - "created": "2016-05-18T21:32:27.752Z", - "classes": [ - {"class": "dalmatian"}, - {"class": "husky"}, - {"class": "goldenretriever"}, - {"class": "beagle"} - ] - } - ``` - {: screen} - - Training begins immediately. When the new one is available, the status changes to `ready`. - - Don't issue another retraining request until after the current status `ready` state. Multiple requests to retrain a classifier result in a single retraining taking effect. A timestamp called `retrained` shows the last time the classifier retraining completed. - - If you call the `/classify` method while the classifier is retraining, the old definition of the classifier is used. - -3. Check the training status periodically until you see a status of `ready`. Replace `{username}`, `{password}`, `{classifier_id}`, and the `https . . .` endpoint with your information: - - ```bash - curl -X GET -u "{username}:{password}" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classifiers/{classifier_id}?version=2016-05-17" - ``` - {: pre} - -## Step 4: Classifying an image with a custom classifier -When the new classifier completes training, you can call it to see how it performs. - -1. Create a JSON file called `myparams.json` that includes the parameters for your call, such as the `classifier_id` of your new classifier, and the default classifier. A simple JSON file might look like the following: - -

      - - ```json - { - "classifier_ids": ["dogs_1941945966", "default"] - } - ``` - {: screen} - -2. Use the `POST /v3/classify` method to test your custom classifier. The following example uploads the image [dogs.jpg](https://github.com/watson-developer-cloud/doc-tutorial-downloads/raw/master/visual-recognition/dogs.jpg), and classifies it against the "dogs\_1941945966" classifier. - - Replace `{username}` and `{password}` with the service credentials you copied in the first step. - - Replace the `https . . .` endpoint with your endpoint URL - - To classify against default classes, omit the `parameters` parameter. - - ```bash - curl -X POST -u "{username}:{password}" -F "images_file=@dogs.jpg" -F "parameters=@myparams.json" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classify?version=2016-05-17" - ``` - {: pre} - - The response includes classifiers, their classes, and a score for each class. Scores range from 0-1, with a higher score indicating greater correlation. The `/v3/classify` calls omit low-scoring classes by default if high-scoring classes are identified. You can set a minimum score to display by specifying a floating point value for the `threshold` parameter in your call. - -

      - - ```json - { - "images": [ - { - "classifiers": [ - { - "classes": [ - { - "class": "animal", - "score": 1.0, - "type_hierarchy": "/animals" - }, - { - "class": "mammal", - "score": 1.0, - "type_hierarchy": "/animals/mammal" - }, - { - "class": "dog", - "score": 0.880797, - "type_hierarchy": "/animals/pets/dog" - } - ], - "classifier_id": "default", - "name": "default" - }, - { - "classes": [ - { - "class": "goldenretriever", - "score": 0.610501 - } - ], - "classifier_id": "dogs_2084675858", - "name": "dogs" - } - ], - "image": "dogs.jpg" - } - ], - "images_processed": 1 - } - ``` - {: screen} - -3. Review your results. - -You're done! You created, trained, and queried a custom classifier with the {{site.data.keyword.visualrecognitionshort}} service. - -## Step 5: Deleting your custom classifier - -You might want to delete your custom classifier to begin developing your application with a clean instance. - -To delete the classifier, call the `DELETE /v3/classifiers/{classifier_id}` method. Replace `{username}`, `{password}`, and the `https . . .` endpoint with your information. Include the `classifier_id` for the classifier you want to delete: - -```bash -curl -X DELETE -u "{username}:{password}" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classifiers/{classifier_id}?version=2016-05-17" -``` -{: pre} - -### Attributions -{: #attributions} - -All images used on this page are from Flikr and used under [Creative Commons Attribution 2.0 license ![External link icon](../../icons/launch-glyph.svg "External link icon")](http://creativecommons.org/licenses/by/2.0/deed.en){:new_window}. No changes were made to these images. - -# Related Links -{: #rellinks notoc} - -## Tutorials and Samples -{: #samples} - -* Learn more about how to [Use your own data to train a classifier](customizing.html). +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-31" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen: .screen} +{:pre: .pre} + +# Creating a custom classifier +{: #custom-classifier} +After you classify an image, you are ready to train and create a custom classifier. With a custom classifier, you can train the {{site.data.keyword.visualrecognitionshort}} Dedicated service to classify images to suit your business needs. +{: shortdesc} + +## Step 1: Log in, create the service, and get your credentials +If you created your free instance of the {{site.data.keyword.visualrecognitionshort}} Dedicated service in "Getting started", use those credentials for this tutorial. If you haven't created a service, go back and run through those steps in the beginning of [Getting started](index.html). + +## Step 2: Creating a custom classifier +The {{site.data.keyword.visualrecognitionshort}} Dedicated service can learn from example images you upload to create a new, multi-faceted classifier. Each example file is trained against the other files in that call, and positive examples are stored as classes. These classes are grouped to define a single classifier, but return their own scores. + +**Note**: Negative example files are not stored as classes. + +1. Download the [beagle.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/beagle.zip){:new_window}, [husky.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/husky.zip){:new_window}, [golden-retriever.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/golden-retriever.zip){:new_window}, and [cats.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/cats.zip){:new_window} example training files. +2. Call the `POST /v3/classifiers` method with the following cURL command, which uploads the training data and creates the classifier "dogs": + - Replace `{username}` and `{password}` with the service credentials you copied in the first step. + - Modify the location of the `{class}_positive_examples` to point to where you saved the .zip files. + - Replace the `https . . .` endpoint with your endpoint URL + + ```bash + curl -X POST -u "{username}:{password}" -F "beagle_positive_examples=@beagle.zip" -F "husky_positive_examples=@husky.zip" -F "goldenretriever_positive_examples=@golden-retriever.zip" -F "negative_examples=@cats.zip" -F "name=dogs" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classifiers?version=2016-05-20" + ``` + {: pre} + + Positive example filenames require the suffix `_positive_examples`. In this example, the filenames are `beagle_positive_examples`, `goldenretriever_positive_examples`, and `husky_positive_examples`. The prefix (beagle, goldenretriever, and husky) is returned as the name of class. + + The response includes a new classifier ID and status, for example: + +

      + + ```json + { + "classifier_id": "dogs_1941945966", + "name": "dogs", + "owner": "xxxx-xxxxx-xxx-xxxx", + "status": "training", + "created": "2016-05-18T21:32:27.752Z", + "classes": [ + {"class": "husky"}, + {"class": "goldenretriever"}, + {"class": "beagle"} + ] + } + ``` + {: screen} + +3. Check the training status periodically until you see a status of `ready`. Training begins immediately and must finish before you can query the classifier. Replace `{username}`, `{password}`, `{classifier_id}`, and the `https . . .` endpoint with your information: + + ```bash + curl -X GET -u "{username}:{password}" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classifiers/{classifier_id}?version=2016-05-17" + ``` + {: pre} + +## Step 3: Updating an existing custom classifier +You can update an existing {{site.data.keyword.visualrecognitionshort}} Dedicated service custom classifier by adding new classes to an existing classifier, or by adding images to an existing class. Improve on the classifier that you created in step 2 by adding a *Dalmatian* class to the types of dogs which can be classified, and by adding more images of cats to the negative example set for the "dogs" classifier. + +### To add new classes to an existing classifier: + +1. Download the [dalmatian.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/dalmatian.zip){:new_window} and [more-cats.zip ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://watson-developer-cloud.github.io/doc-tutorial-downloads/visual-recognition/more-cats.zip){:new_window} sample training files. + +2. Call the `POST /v3/classifiers/{classifier_id}` method with the following cURL command, which uploads the training data and updates the classifier "dogs\_1941945966": + - Replace `{username}` and `{password}` with the service credentials you copied in the first step. + - Replace `{classifier_id}` with the ID of the classifier you want to update. + - Modify the location of the `{class}_positive_examples` to point to where you saved the .zip files. + - Replace the `https . . .` endpoint with your endpoint URL + + ```bash + curl -X POST -u "{username}:{password}" -F "dalmatian_positive_examples=@dalmatian.zip" -F "negative_examples=@more-cats.zip" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classifiers/{classifier_id}?version=2016-05-17" + ``` + {: pre} + + The existing "dogs" classifier is replaced by the retrained one with the same `classifier_id`. The response lists the new set of classes and the current status. For example: + +

      + + ```json + { + "classifier_id": "dogs_1941945966", + "name": "dogs", + "owner": "xxxx-xxxxx-xxx-xxxx", + "status": "retraining", + "created": "2016-05-18T21:32:27.752Z", + "classes": [ + {"class": "dalmatian"}, + {"class": "husky"}, + {"class": "goldenretriever"}, + {"class": "beagle"} + ] + } + ``` + {: screen} + + Training begins immediately. When the new one is available, the status changes to `ready`. + + Don't issue another retraining request until after the current status `ready` state. Multiple requests to retrain a classifier result in a single retraining taking effect. A timestamp called `retrained` shows the last time the classifier retraining completed. + + If you call the `/classify` method while the classifier is retraining, the old definition of the classifier is used. + +3. Check the training status periodically until you see a status of `ready`. Replace `{username}`, `{password}`, `{classifier_id}`, and the `https . . .` endpoint with your information: + + ```bash + curl -X GET -u "{username}:{password}" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classifiers/{classifier_id}?version=2016-05-17" + ``` + {: pre} + +## Step 4: Classifying an image with a custom classifier +When the new classifier completes training, you can call it to see how it performs. + +1. Create a JSON file called `myparams.json` that includes the parameters for your call, such as the `classifier_id` of your new classifier, and the default classifier. A simple JSON file might look like the following: + +

      + + ```json + { + "classifier_ids": ["dogs_1941945966", "default"] + } + ``` + {: screen} + +2. Use the `POST /v3/classify` method to test your custom classifier. The following example uploads the image [dogs.jpg](https://github.com/watson-developer-cloud/doc-tutorial-downloads/raw/master/visual-recognition/dogs.jpg), and classifies it against the "dogs\_1941945966" classifier. + - Replace `{username}` and `{password}` with the service credentials you copied in the first step. + - Replace the `https . . .` endpoint with your endpoint URL + - To classify against default classes, omit the `parameters` parameter. + + ```bash + curl -X POST -u "{username}:{password}" -F "images_file=@dogs.jpg" -F "parameters=@myparams.json" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classify?version=2016-05-17" + ``` + {: pre} + + The response includes classifiers, their classes, and a score for each class. Scores range from 0-1, with a higher score indicating greater correlation. The `/v3/classify` calls omit low-scoring classes by default if high-scoring classes are identified. You can set a minimum score to display by specifying a floating point value for the `threshold` parameter in your call. + +

      + + ```json + { + "images": [ + { + "classifiers": [ + { + "classes": [ + { + "class": "animal", + "score": 1.0, + "type_hierarchy": "/animals" + }, + { + "class": "mammal", + "score": 1.0, + "type_hierarchy": "/animals/mammal" + }, + { + "class": "dog", + "score": 0.880797, + "type_hierarchy": "/animals/pets/dog" + } + ], + "classifier_id": "default", + "name": "default" + }, + { + "classes": [ + { + "class": "goldenretriever", + "score": 0.610501 + } + ], + "classifier_id": "dogs_2084675858", + "name": "dogs" + } + ], + "image": "dogs.jpg" + } + ], + "images_processed": 1 + } + ``` + {: screen} + +3. Review your results. + +You're done! You created, trained, and queried a custom classifier with the {{site.data.keyword.visualrecognitionshort}} service. + +## Step 5: Deleting your custom classifier + +You might want to delete your custom classifier to begin developing your application with a clean instance. + +To delete the classifier, call the `DELETE /v3/classifiers/{classifier_id}` method. Replace `{username}`, `{password}`, and the `https . . .` endpoint with your information. Include the `classifier_id` for the classifier you want to delete: + +```bash +curl -X DELETE -u "{username}:{password}" "https://gateway.watsonplatform.net/visual-recognition/api/v3/classifiers/{classifier_id}?version=2016-05-17" +``` +{: pre} + +### Attributions +{: #attributions} + +All images used on this page are from Flikr and used under [Creative Commons Attribution 2.0 license ![External link icon](../../icons/launch-glyph.svg "External link icon")](http://creativecommons.org/licenses/by/2.0/deed.en){:new_window}. No changes were made to these images. + +# Related Links +{: #rellinks notoc} + +## Tutorials and Samples +{: #samples} + +* Learn more about how to [Use your own data to train a classifier](customizing.html). * Learn more about [Best practices for custom classifiers](https://www.ibm.com/blogs/bluemix/2016/10/watson-visual-recognition-training-best-practices/) \ No newline at end of file diff --git a/services/visual-recognition-dedicated/visual-recognition-overview.md b/services/visual-recognition-dedicated/visual-recognition-overview.md index cfb3a13c0..e4431ca8f 100644 --- a/services/visual-recognition-dedicated/visual-recognition-overview.md +++ b/services/visual-recognition-dedicated/visual-recognition-overview.md @@ -1,58 +1,58 @@ ---- - -copyright: - years: 2015, 2017 -lastupdated: "2017-03-31" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# About the IBM Watson Visual Recognition Dedicated service -{: #about} -The {{site.data.keyword.visualrecognitionfull}} Dedicated service uses deep learning algorithms to analyze images for scenes, objects, and other content. The response includes keywords that provide information about the content. -{: shortdesc} - -A set of built-in classes provides highly accurate results without training. You can train custom classifiers to create specialized classes. - -## How to use the service -{: notoc} -The following image shows the process of creating and using the classifier: -![Describes the flow of the {{site.data.keyword.visualrecognitionshort}} service, from preparing, training, and classifying images to viewing results](images/vr-process2.png) - -## What to use the service for -{: #use-cases} -The {{site.data.keyword.visualrecognitionshort}} Dedicated service can be used for diverse applications and industries, such as: - -- **Manufacturing:** Use images from a manufacturing setting to make sure products are being positioned correctly on an assembly line - -- **Visual Auditing:** Look for visual compliance or deterioration in a fleet of trucks, planes, or windmills out in the field, train custom classifiers to understand what defects look like - -- **Insurance:** Rapidly process claims by using images to classify claims into different categories. - -- **Social listening:** Use images from your product line or your logo to track buzz about your company on social media - -- **Social commerce:** Use an image of a plated dish to find out which restaurant serves it and find reviews, use a travel photo to find vacation suggestions based on similar experiences, use a house image to find similar homes that are for sale - -- **Retail:** Take a photo of a favorite outfit to find stores with those clothes in stock or on sale, use a travel image to find retail suggestions in that area - -- **Education:** Create image-based applications to educate about taxonomies, use pictures to find educational material on similar subjects - -## Supported languages -{: #supported-languages} -The **Classify an image** method supports English (en), Spanish (es), Arabic (ar), and Japanese (ja) for default classes. Custom classifiers returned with this method support only English. - -All other methods support English only. - -# Related Links -{: #rellinks notoc} - -## Tutorials and Samples -{: #samples} - -* [View a video introduction ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://www.youtube.com/watch?v=vnWblT50w1Y){:new_window} about training and retraining classifiers. - -* [Get started with the service](getting-started.html). - +--- + +copyright: + years: 2015, 2017 +lastupdated: "2017-03-31" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# About the IBM Watson Visual Recognition Dedicated service +{: #about} +The {{site.data.keyword.visualrecognitionfull}} Dedicated service uses deep learning algorithms to analyze images for scenes, objects, and other content. The response includes keywords that provide information about the content. +{: shortdesc} + +A set of built-in classes provides highly accurate results without training. You can train custom classifiers to create specialized classes. + +## How to use the service +{: notoc} +The following image shows the process of creating and using the classifier: +![Describes the flow of the {{site.data.keyword.visualrecognitionshort}} service, from preparing, training, and classifying images to viewing results](images/vr-process2.png) + +## What to use the service for +{: #use-cases} +The {{site.data.keyword.visualrecognitionshort}} Dedicated service can be used for diverse applications and industries, such as: + +- **Manufacturing:** Use images from a manufacturing setting to make sure products are being positioned correctly on an assembly line + +- **Visual Auditing:** Look for visual compliance or deterioration in a fleet of trucks, planes, or windmills out in the field, train custom classifiers to understand what defects look like + +- **Insurance:** Rapidly process claims by using images to classify claims into different categories. + +- **Social listening:** Use images from your product line or your logo to track buzz about your company on social media + +- **Social commerce:** Use an image of a plated dish to find out which restaurant serves it and find reviews, use a travel photo to find vacation suggestions based on similar experiences, use a house image to find similar homes that are for sale + +- **Retail:** Take a photo of a favorite outfit to find stores with those clothes in stock or on sale, use a travel image to find retail suggestions in that area + +- **Education:** Create image-based applications to educate about taxonomies, use pictures to find educational material on similar subjects + +## Supported languages +{: #supported-languages} +The **Classify an image** method supports English (en), Spanish (es), Arabic (ar), and Japanese (ja) for default classes. Custom classifiers returned with this method support only English. + +All other methods support English only. + +# Related Links +{: #rellinks notoc} + +## Tutorials and Samples +{: #samples} + +* [View a video introduction ![External link icon](../../icons/launch-glyph.svg "External link icon")](https://www.youtube.com/watch?v=vnWblT50w1Y){:new_window} about training and retraining classifiers. + +* [Get started with the service](getting-started.html). + * [Try out the demo ![External link icon](../../icons/launch-glyph.svg "External link icon")](http://visual-recognition-demo.mybluemix.net){:new_window}. \ No newline at end of file diff --git a/services/vpn/nl/de/vpn_monitoring.md b/services/vpn/nl/de/vpn_monitoring.md index 6af53490a..3d4356b68 100644 --- a/services/vpn/nl/de/vpn_monitoring.md +++ b/services/vpn/nl/de/vpn_monitoring.md @@ -17,7 +17,7 @@ copyright: Mit der Überwachungsfunktion können Sie den Verbindungsstatus und die Geschwindigkeit des Datenflusses zwischen Ihrem lokal oder auf dem SoftLayer-Server vorhandenen VPN-Gateway und Ihrem {{site.data.keyword.vpn_short}}-Gateway anzeigen. {:shortdesc} -##Im Service-Dashboard überwachen +## Im Service-Dashboard überwachen {: #dashboard} Wählen Sie die Registerkarte **Überwachung** aus, um die folgende Verbindungsstatistik anzuzeigen. @@ -29,7 +29,7 @@ Wählen Sie die Registerkarte **Überwachung** aus, um die folgende Verbindungss Die Überwachungsstatistik wird als Diagramme mit Daten aus den letzten 48 Stunden angezeigt. Die Diagramme werden alle 20 Minuten automatisch aktualisiert. Sie können jedoch die neuesten Daten jederzeit abrufen, indem Sie die Registerkarte 'Überwachung' verlassen und wieder zu ihr zurückkehren. **Hinweis:** In den Diagrammen wird die koordinierte Weltzeit und nicht die Ortszeit verwendet. -##Mit Logmet überwachen +## Mit Logmet überwachen {: #logmet} Verwenden Sie [Logmet](https://logmet.{DomainName}), um eine detaillierte Verbindungsstatistik anzuzeigen. diff --git a/services/vpn/nl/de/vpn_overview.md b/services/vpn/nl/de/vpn_overview.md index f277d3af5..a785f4fc0 100644 --- a/services/vpn/nl/de/vpn_overview.md +++ b/services/vpn/nl/de/vpn_overview.md @@ -17,7 +17,7 @@ Der Service {{site.data.keyword.vpn_full}} (VPN) bietet einen sicheren Kanal fü {:shortdesc} Der Service {{site.data.keyword.vpn_short}} bietet folgende Produktmerkmale: -##Sicherheit +## Sicherheit Der Service IBM VPN verwendet für die Authentifizierung und die Verschlüsselung der IP-Kommunikation zwischen dem Rechenzentrum Ihres Unternehmens und der IBM Bluemix-Cloudumgebung die standardisierte Protokollsuite Internet Protocol Security (IPSec). IPSec bietet auf Netzwerkebene Peerauthentifizierung, Datenintegrität und Datenschutz (Verschlüsselung). Der Service IBM VPN unterstützt folgende IPSec-Protokolle und Umsetzungen: @@ -43,8 +43,8 @@ Der Service IBM VPN ist konform zu den folgenden IETF-RFCs: * RFC 4303 für IPv4-Encapsulated Security Payload (ESP) * RFC 2104 HMAC und RFC 2404 HMAC-SHA-1-96 für Authentifizierung * RFC 2451 3DES-CBC; RFC 3602 AES128-CBC, AES192-CBC und AES256-CBC für Verschlüsselung -##Einfachheit +## Einfachheit Sie können den Service IBM VPN mithilfe einer einfachen und intuitiv zu bedienenden grafischen Schnittstelle erstellen. Sie können Ihre Gateway-IP-Adresse und die Teilnetze Ihres Rechenzentrums angeben. Sie können entweder IPSec- und IKE-Standardrichtlinien verwenden oder die Richtlinien entsprechend Ihren Bedürfnissen anpassen. -##Management +## Management Sie können den Service IBM VPN mithilfe einer grafischen Benutzerschnittstelle, einer [Befehlszeilenschnittstelle](../../cli/plugins/vpn/index.html) oder mithilfe von [APIs](https://new-console.ng.bluemix.net/apidocs/101) verwalten. diff --git a/services/vpn/nl/es/vpn_onpremises.md b/services/vpn/nl/es/vpn_onpremises.md index acafad934..566e8e0b3 100644 --- a/services/vpn/nl/es/vpn_onpremises.md +++ b/services/vpn/nl/es/vpn_onpremises.md @@ -23,7 +23,7 @@ La pasarela VPN local se conecta con la pasarela {{site.data.keyword.vpn_short}} * [Configuración de IBM VPN con GaaS (SoftLayer Gateway Appliance Service)](vpn_onpremises.html#gaas) * [Configuración de IBM VPN con Cisco ASA](vpn_onpremises.html#cisco) -##Configuración del servicio IBM VPN con strongSwan +## Configuración del servicio IBM VPN con strongSwan {: #strongswan} La configuración de IBM VPN utiliza la siguiente configuración de ejemplo: @@ -37,7 +37,7 @@ La configuración de strongSwan local utiliza la siguiente configuración de eje * Dirección IP de pasarela VPN (IP de pasarela de cliente): 169.55.254.166 * Dirección de subred a la que están conectados los puntos finales (subred de cliente): 10.121.33.192/26 -###Para utilizar el servicio IBM VPN con strongSwan, configure lo siguiente: +### Para utilizar el servicio IBM VPN con strongSwan, configure lo siguiente: 1. [Configure la pasarela](index.html#gateway). 2. [Configure la conexión de sitio](index.html#site). @@ -155,7 +155,7 @@ La configuración de strongSwan local utiliza la siguiente configuración de eje ``` {: screen} -##Configuración del servicio IBM VPN con Vyatta +## Configuración del servicio IBM VPN con Vyatta {: #vyatta} La configuración de IBM VPN utiliza la siguiente configuración de ejemplo: @@ -169,7 +169,7 @@ La configuración de Vyatta local utiliza la siguiente configuración de ejemplo * Dirección IP de pasarela VPN (IP de pasarela de cliente): 173.192.83.82 * Dirección de subred a la que están conectados los puntos finales (subred de cliente): 192.168.201.0/24 -###Para utilizar el servicio IBM VPN con Vyatta, configure lo siguiente: +### Para utilizar el servicio IBM VPN con Vyatta, configure lo siguiente: 1. [Configure la pasarela](index.html#gateway). 2. [Configure la conexión de sitio](index.html#site). @@ -437,7 +437,7 @@ La configuración de Vyatta local utiliza la siguiente configuración de ejemplo ``` {: screen} -##Configuración del servicio IBM VPN con el servicio GaaS (SoftLayer Gateway Appliance Service) +## Configuración del servicio IBM VPN con el servicio GaaS (SoftLayer Gateway Appliance Service) {: #gaas} La configuración de IBM VPN utiliza la siguiente configuración de ejemplo: @@ -452,7 +452,7 @@ La configuración de SoftLayer GaaS local utiliza la siguiente configuración de * Dirección de subred a la que están conectados los puntos finales (subred de cliente): 10.86.88.128/26 * Serie de clave compartida previamente: 567890 -###Para utilizar el servicio IBM VPN con SoftLayer GaaS, configure lo siguiente: +### Para utilizar el servicio IBM VPN con SoftLayer GaaS, configure lo siguiente: 1. Configure SoftLayer GaaS: @@ -652,7 +652,7 @@ La configuración de SoftLayer GaaS local utiliza la siguiente configuración de ``` {: screen} -##Configuración del servicio IBM VPN con Cisco ASA +## Configuración del servicio IBM VPN con Cisco ASA {: #cisco} La configuración de IBM VPN utiliza la siguiente configuración de ejemplo: @@ -666,7 +666,7 @@ La configuración local utiliza la siguiente configuración de ejemplo: * Dirección IP de pasarela VPN (IP de pasarela de cliente): 62.95.35.53 * Dirección de subred a la que están conectados los puntos finales (subred de cliente): 10.2.0.0/16 -###Para utilizar el servicio IBM VPN con Cisco ASA, configure lo siguiente: +### Para utilizar el servicio IBM VPN con Cisco ASA, configure lo siguiente: 1. [Configure la pasarela](index.html#gateway). 2. [Configure la conexión de sitio](index.html#site). diff --git a/services/vpn/nl/es/vpn_overview.md b/services/vpn/nl/es/vpn_overview.md index a6484ea81..a160d9cb8 100644 --- a/services/vpn/nl/es/vpn_overview.md +++ b/services/vpn/nl/es/vpn_overview.md @@ -17,7 +17,7 @@ El servicio {{site.data.keyword.vpn_full}} (VPN) proporciona un canal de comunic {:shortdesc} El servicio {{site.data.keyword.vpn_short}} proporciona las siguientes características: -##Seguridad +## Seguridad El servicio IBM VPN utiliza la suite de protocolo IPSec (Internet Protocol Security) estándar del sector para autenticar y cifrar la comunicación IP entre el centro de datos corporativo y el entorno de nube de IBM Bluemix. IPSec proporciona autenticación de iguales a nivel de red, integridad de datos y confidencialidad de datos (cifrado). El servicio IBM VPN da soporte a las siguientes transformaciones y protocolos IPSec: @@ -43,8 +43,8 @@ El servicio IBM VPN cumple con los siguientes IETF RFCs: * RFC 4303 para la carga útil de seguridad encapsulada (ESP) de IPv4 * RFC 2104 HMAC y RFC 2404 HMAC-SHA-1-96 para autenticación * RFC 2451 3DES-CBC; RFC 3602 AES128-CBC, AES192-CBC y AES256-CBC para cifrado -##Simplicidad +## Simplicidad Puede crear el servicio IBM VPN utilizando una interfaz gráfica simple e intuitiva. Puede especificar la dirección IP de pasarela y las subredes del centro de datos. También puede utilizar las políticas IPSec y IKE predeterminadas, o personalizar las políticas para adaptarse a sus necesidades. -##Gestión +## Gestión Puede gestionar el servicio IBM VPN utilizando una interfaz gráfica, una [interfaz de línea de mandatos](../../cli/plugins/vpn/index.html) o [API](https://new-console.ng.bluemix.net/apidocs/101). diff --git a/services/vpn/nl/fr/vpn_monitoring.md b/services/vpn/nl/fr/vpn_monitoring.md index ac2515cb3..6038d1885 100644 --- a/services/vpn/nl/fr/vpn_monitoring.md +++ b/services/vpn/nl/fr/vpn_monitoring.md @@ -18,7 +18,7 @@ copyright : Utilisez la fonction de surveillance pour afficher l'état de connexion et le débit du flux de trafic entre votre passerelle VPN de serveur SoftLayer ou sur site et la passerelle {{site.data.keyword.vpn_short}}. {:shortdesc} -##Surveillance sur le tableau de bord du service +## Surveillance sur le tableau de bord du service {: #dashboard} Sélectionnez l'onglet **Monitoring** pour afficher les statistiques de connexion suivantes. @@ -31,7 +31,7 @@ Les statistiques de surveillance s'affichent sous forme de graphique et contienn vous pouvez extraire les données les plus récentes à tout moment en sortant de l'onglet Monitoring et en y accédant à nouveau. **Remarque :** Les graphiques utilisent l'heure UTC et non l'heure locale. -##Surveillance sur Logmet +## Surveillance sur Logmet {: #logmet} Utilisez [Logmet](https://logmet.{DomainName}) pour afficher des statistiques de connexion détaillées. diff --git a/services/vpn/nl/fr/vpn_overview.md b/services/vpn/nl/fr/vpn_overview.md index 2dc283958..7d2ea0027 100644 --- a/services/vpn/nl/fr/vpn_overview.md +++ b/services/vpn/nl/fr/vpn_overview.md @@ -18,7 +18,7 @@ l'environnement de cloud IBM Bluemix®. La connexion est établie via Interne {:shortdesc} Le service {{site.data.keyword.vpn_short}} offre les fonctions suivantes : -##Sécurité +## Sécurité Le service IBM VPN utilise le protocole IPSec (Internet Protocol Security) standard pour authentifier et chiffrer la communication IP entre le centre de données de votre entreprise et l'environnement de cloud IBM Bluemix. IPSec offre une authentification d'homologue au niveau du réseau, une intégrité des données et une confidentialité des données (chiffrement). @@ -48,10 +48,10 @@ Le service IBM VPN est conforme aux demandes de commentaires (RFC) IETF suivante * RFC 4303 pour IPv4 Encapsulating Security Payload (ESP) * RFC 2104 HMAC et RFC 2404 HMAC-SHA-1-96 pour l'authentification * RFC 2451 3DES-CBC ; RFC 3602 AES128-CBC, AES192-CBC et AES256-CBC pour le chiffrement -##Simplicité +## Simplicité Vous pouvez créer le service IBM VPN à l'aide d'une interface graphique simple et intuitive. Vous pouvez spécifier l'adresse IP de votre passerelle et les sous-réseaux de votre centre de données. Vous pouvez utiliser les règles IPSec et IKE par défaut ou personnaliser les règles en fonction de vos besoins. -##Gestion +## Gestion Vous pouvez gérer le service IBM VPN à l'aide d'une interface graphique, d'une [interface de ligne de commande](../../cli/plugins/vpn/index.html) ou à l'aide d'[interfaces API](https://new-console.ng.bluemix.net/apidocs/101). diff --git a/services/vpn/nl/it/vpn_monitoring.md b/services/vpn/nl/it/vpn_monitoring.md index 3ea74ae06..4233f572e 100644 --- a/services/vpn/nl/it/vpn_monitoring.md +++ b/services/vpn/nl/it/vpn_monitoring.md @@ -17,7 +17,7 @@ copyright: Utilizza la funzione di monitoraggio per visualizzare lo stato della connessione e la frequenza del flusso del traffico tra il tuo gateway VPN server SoftLayer o in loco e il gateway {{site.data.keyword.vpn_short}}. {:shortdesc} -##Monitoraggio del dashboard del servizio +## Monitoraggio del dashboard del servizio {: #dashboard} Seleziona la scheda **Monitoraggio** per visualizzare le seguenti statistiche della connessione. @@ -29,7 +29,7 @@ Seleziona la scheda **Monitoraggio** per visualizzare le seguenti statistiche de Le statistiche del monitoraggio vengono visualizzate come grafici con i dati delle ultime 48 ore. I grafici vengono automaticamente aggiornati ogni 20 minuti. Tuttavia, puoi recuperare gli ultimi dati in ogni momento uscendo dalla scheda di monitoraggio e ritornandoci. **Nota:** i grafici utilizzano l'ora UTC (Coordinated Universal Time) e non l'ora locale. -##Monitoraggio di Logmet +## Monitoraggio di Logmet {: #logmet} Utilizza [Logmet](https://logmet.{DomainName}) per visualizzare le statistiche di connessione dettagliate. diff --git a/services/vpn/nl/it/vpn_onpremises.md b/services/vpn/nl/it/vpn_onpremises.md index 2ef93ff19..780beb561 100644 --- a/services/vpn/nl/it/vpn_onpremises.md +++ b/services/vpn/nl/it/vpn_onpremises.md @@ -23,7 +23,7 @@ Il tuo gateway VPN in loco si collega con il gateway {{site.data.keyword.vpn_sho * [Configurazione di IBM VPN con Gaas (SoftLayer Gateway Appliance Service)](vpn_onpremises.html#gaas) * [Configurazione di IBM VPN con Cisco ASA](vpn_onpremises.html#cisco) -##Configurazione del servizio IBM VPN con strongSwan +## Configurazione del servizio IBM VPN con strongSwan {: #strongswan} La configurazione di IBM VPN utilizza la seguente configurazione di esempio: @@ -37,7 +37,7 @@ La configurazione di strongSwan in loco utilizza la seguente configurazione di e * Indirizzo IP gateway VPN (IP gateway cliente): 169.55.254.166 * Indirizzo di sottorete al quale sono collegati gli endpoint (sottorete cliente): 10.121.33.192/26 -###Per utilizzare il servizio IBM VPN con strongSwa, esegui la configurazione nel seguente modo: +### Per utilizzare il servizio IBM VPN con strongSwa, esegui la configurazione nel seguente modo: 1. [Configura il gateway](index.html#gateway). 2. [Configura la connessione al sito](index.html#site). @@ -155,7 +155,7 @@ La configurazione di strongSwan in loco utilizza la seguente configurazione di e ``` {: screen} -##Configurazione del servizio IBM VPN con Vyatta +## Configurazione del servizio IBM VPN con Vyatta {: #vyatta} La configurazione di IBM VPN utilizza la seguente configurazione di esempio: @@ -169,7 +169,7 @@ La configurazione di Vyatta in loco utilizza la seguente configurazione di esemp * Indirizzo IP gateway VPN (IP gateway cliente): 173.192.83.82 * Indirizzo di sottorete al quale sono collegati gli endpoint (sottorete cliente): 192.168.201.0/24 -###Per utilizzare il servizio IBM VPN con Vyatta, esegui la configurazione nel seguente modo: +### Per utilizzare il servizio IBM VPN con Vyatta, esegui la configurazione nel seguente modo: 1. [Configura il gateway](index.html#gateway). 2. [Configura la connessione al sito](index.html#site). @@ -437,7 +437,7 @@ La configurazione di Vyatta in loco utilizza la seguente configurazione di esemp ``` {: screen} -##Configurazione del servizio IBM VPN con Gaas (SoftLayer Gateway Appliance Service) +## Configurazione del servizio IBM VPN con Gaas (SoftLayer Gateway Appliance Service) {: #gaas} La configurazione di IBM VPN utilizza la seguente configurazione di esempio: @@ -452,7 +452,7 @@ La configurazione di SoftLayer GaaS in loco utilizza la seguente configurazione * Indirizzo di sottorete al quale sono collegati gli endpoint (sottorete cliente): 10.86.88.128/26 * Stringa chiave precondivisa: 567890 -###Per utilizzare il servizio IBM VPN con SoftLayer GaaS, esegui la configurazione nel seguente modo: +### Per utilizzare il servizio IBM VPN con SoftLayer GaaS, esegui la configurazione nel seguente modo: 1. Configura SoftLayer GaaS: @@ -652,7 +652,7 @@ La configurazione di SoftLayer GaaS in loco utilizza la seguente configurazione ``` {: screen} -##Configurazione del servizio IBM VPN con Cisco ASA +## Configurazione del servizio IBM VPN con Cisco ASA {: #cisco} La configurazione di IBM VPN utilizza la seguente configurazione di esempio: @@ -666,7 +666,7 @@ La configurazione in loco utilizza la seguente configurazione di esempio: * Indirizzo IP gateway VPN (IP gateway cliente): 62.95.35.53 * Indirizzo di sottorete al quale sono collegati gli endpoint (sottorete cliente): 10.2.0.0/16 -###Per utilizzare il servizio IBM VPN con Cisco ASA, esegui la configurazione nel seguente modo: +### Per utilizzare il servizio IBM VPN con Cisco ASA, esegui la configurazione nel seguente modo: 1. [Configura il gateway](index.html#gateway). 2. [Configura la connessione al sito](index.html#site). diff --git a/services/vpn/nl/ja/vpn_onpremises.md b/services/vpn/nl/ja/vpn_onpremises.md index b6c4b664c..28d38bcb5 100644 --- a/services/vpn/nl/ja/vpn_onpremises.md +++ b/services/vpn/nl/ja/vpn_onpremises.md @@ -23,7 +23,7 @@ copyright: * [IBM VPN を SoftLayer Gateway Appliance Service (GaaS) と共に構成する](vpn_onpremises.html#gaas) * [IBM VPN を Cisco ASA と共に構成する](vpn_onpremises.html#cisco) -##IBM VPN サービスを strongSwan と共に構成する +## IBM VPN サービスを strongSwan と共に構成する {: #strongswan} IBM VPN セットアップでは、以下のサンプル構成を使用します。 @@ -37,7 +37,7 @@ IBM VPN セットアップでは、以下のサンプル構成を使用します * VPN ゲートウェイの IP アドレス (Customer Gateway IP): 169.55.254.166 * エンドポイントが接続されているサブネット・アドレス (Customer Subnet): 10.121.33.192/26 -###IBM VPN サービスを strongSwan で使用するには、以下のように構成します。 +### IBM VPN サービスを strongSwan で使用するには、以下のように構成します。 1. [ゲートウェイを構成します](index.html#gateway)。 2. [サイト接続を構成します](index.html#site)。 @@ -155,7 +155,7 @@ IBM VPN セットアップでは、以下のサンプル構成を使用します ``` {: screen} -##IBM VPN サービスを Vyatta と共に構成する +## IBM VPN サービスを Vyatta と共に構成する {: #vyatta} IBM VPN セットアップでは、以下のサンプル構成を使用します。 @@ -169,7 +169,7 @@ IBM VPN セットアップでは、以下のサンプル構成を使用します * VPN ゲートウェイの IP アドレス (Customer Gateway IP): 173.192.83.82 * エンドポイントが接続されているサブネット・アドレス (Customer Subnet): 192.168.201.0/24 -###IBM VPN サービスを Vyatta で使用するには、以下のように構成します。 +### IBM VPN サービスを Vyatta で使用するには、以下のように構成します。 1. [ゲートウェイを構成します](index.html#gateway)。 2. [サイト接続を構成します](index.html#site)。 @@ -437,7 +437,7 @@ IBM VPN セットアップでは、以下のサンプル構成を使用します ``` {: screen} -##IBM VPN サービスを SoftLayer Gateway Appliance Service (GaaS) と共に構成する +## IBM VPN サービスを SoftLayer Gateway Appliance Service (GaaS) と共に構成する {: #gaas} IBM VPN セットアップでは、以下のサンプル構成を使用します。 @@ -452,7 +452,7 @@ IBM VPN セットアップでは、以下のサンプル構成を使用します * エンドポイントが接続されているサブネット・アドレス (Customer Subnet): 10.86.88.128/26 * 事前共有鍵ストリング: 567890 -###IBM VPN サービスを SoftLayer GaaS で使用するには、以下のように構成します。 +### IBM VPN サービスを SoftLayer GaaS で使用するには、以下のように構成します。 1. SoftLayer GaaS を構成します。 @@ -652,7 +652,7 @@ IBM VPN セットアップでは、以下のサンプル構成を使用します ``` {: screen} -##IBM VPN サービスを Cisco ASA と共に構成する +## IBM VPN サービスを Cisco ASA と共に構成する {: #cisco} IBM VPN セットアップでは、以下のサンプル構成を使用します。 @@ -666,7 +666,7 @@ IBM VPN セットアップでは、以下のサンプル構成を使用します * VPN ゲートウェイの IP アドレス (Customer Gateway IP): 62.95.35.53 * エンドポイントが接続されているサブネット・アドレス (Customer Subnet): 10.2.0.0/16 -###IBM VPN サービスを Cisco ASA で使用するには、以下のように構成します。 +### IBM VPN サービスを Cisco ASA で使用するには、以下のように構成します。 1. [ゲートウェイを構成します](index.html#gateway)。 2. [サイト接続を構成します](index.html#site)。 diff --git a/services/vpn/nl/ja/vpn_overview.md b/services/vpn/nl/ja/vpn_overview.md index 670df1ce3..0c5c7cc65 100644 --- a/services/vpn/nl/ja/vpn_overview.md +++ b/services/vpn/nl/ja/vpn_overview.md @@ -17,7 +17,7 @@ copyright: {:shortdesc} {{site.data.keyword.vpn_short}} サービスには、以下のフィーチャーがあります。 -##セキュリティー +## セキュリティー IBM VPN サービスは、業界標準の Internet Protocol Security (IPSec) プロトコル・スイートを使用して、社内データ・センターと IBM Bluemix クラウド環境の間で IP 通信の認証と暗号化を行います。IPSec は、ネットワーク・レベルのピア認証、データ保全性、およびデータ機密性 (暗号化) を提供します。 IBM VPN サービスは、以下の IPSec プロトコルと変換をサポートします。 @@ -43,8 +43,8 @@ IBM VPN サービスは、以下の IETF RFC に準拠しています。 * IPv4 カプセル化セキュリティー・ペイロード (ESP) 用の RFC 4303 * 認証用の RFC 2104 HMAC と RFC 2404 HMAC-SHA-1-96 * 暗号化用の RFC 2451 3DES-CBC、RFC 3602 AES128-CBC、AES192-CBC、AES256-CBC -##容易さ +## 容易さ IBM VPN サービスは、シンプルで直観的なグラフィカル・インターフェースを使用して作成できます。ゲートウェイ IP アドレスとデータ・センターのサブネットを指定できます。デフォルトの IPSec と IKE ポリシーを使用するか、またはそれらのポリシーを必要に合わせてカスタマイズすることができます。 -##管理 +## 管理 IBM VPN サービスは、グラフィカル・インターフェース、[コマンド・ライン・インターフェース](../../cli/plugins/vpn/index.html)、または [API](https://new-console.ng.bluemix.net/apidocs/101) を使用して管理できます。 diff --git a/services/vpn/nl/ko/vpn_onpremises.md b/services/vpn/nl/ko/vpn_onpremises.md index 12af1cc1d..68d8f1f94 100644 --- a/services/vpn/nl/ko/vpn_onpremises.md +++ b/services/vpn/nl/ko/vpn_onpremises.md @@ -23,7 +23,7 @@ copyright: * [SoftLayer GaaS(Gateway Appliance Service)와 함께 IBM VPN 구성](vpn_onpremises.html#gaas) * [Cisco ASA와 함께 IBM VPN 구성](vpn_onpremises.html#cisco) -##strongSwan과 함께 IBM VPN 서비스 구성 +## strongSwan과 함께 IBM VPN 서비스 구성 {: #strongswan} IBM VPN 설정에서는 다음과 같은 예의 구성을 사용합니다. @@ -37,7 +37,7 @@ IBM VPN 설정에서는 다음과 같은 예의 구성을 사용합니다. * VPN 게이트웨이 IP 주소(고객 게이트웨이 IP): 169.55.254.166 * 엔드포인트가 연결되는 서브넷 주소(고객 서브넷): 10.121.33.192/26 -###strongSwan과 함께 IBM VPN 서비스를 사용하려면 다음과 같이 구성하십시오. +### strongSwan과 함께 IBM VPN 서비스를 사용하려면 다음과 같이 구성하십시오. 1. [게이트웨이를 구성하십시오](index.html#gateway). 2. [사이트 연결을 구성하십시오](index.html#site). @@ -155,7 +155,7 @@ IBM VPN 설정에서는 다음과 같은 예의 구성을 사용합니다. ``` {: screen} -##Vyatta와 함께 IBM VPN 서비스 구성 +## Vyatta와 함께 IBM VPN 서비스 구성 {: #vyatta} IBM VPN 설정에서는 다음과 같은 예의 구성을 사용합니다. @@ -169,7 +169,7 @@ IBM VPN 설정에서는 다음과 같은 예의 구성을 사용합니다. * VPN 게이트웨이 IP 주소(고객 게이트웨이 IP): 173.192.83.82 * 엔드포인트가 연결되는 서브넷 주소(고객 서브넷): 192.168.201.0/24 -###Vyatta와 함께 IBM VPN 서비스를 사용하려면 다음과 같이 구성하십시오. +### Vyatta와 함께 IBM VPN 서비스를 사용하려면 다음과 같이 구성하십시오. 1. [게이트웨이를 구성하십시오](index.html#gateway). 2. [사이트 연결을 구성하십시오](index.html#site). @@ -437,7 +437,7 @@ IBM VPN 설정에서는 다음과 같은 예의 구성을 사용합니다. ``` {: screen} -##SoftLayer GaaS(Gateway Appliance Service)와 함께 IBM VPN 서비스 구성 +## SoftLayer GaaS(Gateway Appliance Service)와 함께 IBM VPN 서비스 구성 {: #gaas} IBM VPN 설정에서는 다음과 같은 예의 구성을 사용합니다. @@ -452,7 +452,7 @@ IBM VPN 설정에서는 다음과 같은 예의 구성을 사용합니다. * 엔드포인트가 연결되는 서브넷 주소(고객 서브넷): 10.86.88.128/26 * 사전공유 키 문자열: 567890 -###SoftLayer GaaS와 함께 IBM VPN 서비스를 사용하려면 다음과 같이 구성하십시오. +### SoftLayer GaaS와 함께 IBM VPN 서비스를 사용하려면 다음과 같이 구성하십시오. 1. SoftLayer GaaS를 구성하십시오. @@ -652,7 +652,7 @@ IBM VPN 설정에서는 다음과 같은 예의 구성을 사용합니다. ``` {: screen} -##Cisco ASA와 함께 IBM VPN 서비스 구성 +## Cisco ASA와 함께 IBM VPN 서비스 구성 {: #cisco} IBM VPN 설정에서는 다음과 같은 예의 구성을 사용합니다. @@ -666,7 +666,7 @@ IBM VPN 설정에서는 다음과 같은 예의 구성을 사용합니다. * VPN 게이트웨이 IP 주소(고객 게이트웨이 IP): 62.95.35.53 * 엔드포인트가 연결되는 서브넷 주소(고객 서브넷): 10.2.0.0/16 -###Cisco ASA와 함께 IBM VPN 서비스를 사용하려면 다음과 같이 구성하십시오. +### Cisco ASA와 함께 IBM VPN 서비스를 사용하려면 다음과 같이 구성하십시오. 1. [게이트웨이를 구성하십시오](index.html#gateway). 2. [사이트 연결을 구성하십시오](index.html#site). diff --git a/services/vpn/nl/ko/vpn_overview.md b/services/vpn/nl/ko/vpn_overview.md index 44cc78ed3..cd5edccf2 100644 --- a/services/vpn/nl/ko/vpn_overview.md +++ b/services/vpn/nl/ko/vpn_overview.md @@ -17,7 +17,7 @@ copyright: {:shortdesc} {{site.data.keyword.vpn_short}} 서비스는 다음과 같은 기능을 제공합니다. -##보안 +## 보안 IBM VPN 서비스는 산업 표준 IPSec(Internet Protocol Security) 프로토콜 스위트를 사용하여 회사 데이터 센터와 IBM Bluemix 클라우드 환경 간의 IP 통신을 인증하고 암호화합니다. IPSec은 네트워크 레벨의 피어 인증, 데이터 무결성 및 데이터 기밀성(암호화)을 제공합니다. IBM VPN 서비스는 다음과 같은 IPSec 프로토콜을 지원 및 변환합니다. @@ -43,8 +43,8 @@ IBM VPN 서비스는 다음 IETF RFC를 준수합니다. * IPv4 ESP(Encapsulating Security Payload)에 대해 RFC 4303 * 인증에 대해 RFC 2104 HMAC 및 RFC 2404 HMAC-SHA-1-96 * 암호화에 대해 RFC 2451 3DES-CBC, RFC 3602 AES128-CBC, AES192-CBC, AES256-CBC -##간편성 +## 간편성 간편하고 직관적인 그래픽 인터페이스를 사용하여 IBM VPN 서비스를 작성할 수 있습니다. 사용 중인 게이트웨이 IP 주소와 데이터 센터 서브넷을 지정할 수 있습니다. 기본 IPSec 및 IKE 정책을 사용하거나 필요에 알맞도록 정책을 사용자 정의할 수 있습니다. -##관리 +## 관리 그래픽 인터페이스, [명령행 인터페이스](../../cli/plugins/vpn/index.html) 또는 [API](https://new-console.ng.bluemix.net/apidocs/101)를 사용하여 IBM VPN 서비스를 관리할 수 있습니다. diff --git a/services/vpn/nl/pt/BR/vpn_monitoring.md b/services/vpn/nl/pt/BR/vpn_monitoring.md index 7d1016c7c..dd39db8fa 100644 --- a/services/vpn/nl/pt/BR/vpn_monitoring.md +++ b/services/vpn/nl/pt/BR/vpn_monitoring.md @@ -17,7 +17,7 @@ copyright: Use o recurso de monitoramento para visualizar o status da conexão e a taxa de fluxo de tráfego entre o gateway VPN no local ou do servidor SoftLayer e o gateway {{site.data.keyword.vpn_short}}. {:shortdesc} -##Monitoramento no painel de serviço +## Monitoramento no painel de serviço {: #dashboard} Selecione a guia **Monitoramento** para visualizar as estatísticas de conexão a seguir. @@ -29,7 +29,7 @@ Selecione a guia **Monitoramento** para visualizar as estatísticas de conexão As estatísticas de monitoramento são exibidas como gráficos com dados das últimas 48 horas. Os gráficos são atualizados automaticamente a cada 20 minutos. No entanto, é possível buscar os dados mais recentes a qualquer momento alternando da guia de monitoramento e retornando a ela. **Nota:** os gráficos usam o horário da Hora Universal Coordenada (UTC) e não o horário local. -##Monitoramento no Logmet +## Monitoramento no Logmet {: #logmet} Use o [Logmet](https://logmet.{DomainName}) para visualizar estatísticas detalhadas de conexão. diff --git a/services/vpn/nl/pt/BR/vpn_overview.md b/services/vpn/nl/pt/BR/vpn_overview.md index 444a6ab99..db7ea23e3 100644 --- a/services/vpn/nl/pt/BR/vpn_overview.md +++ b/services/vpn/nl/pt/BR/vpn_overview.md @@ -17,7 +17,7 @@ O serviço {{site.data.keyword.vpn_full}} (VPN) fornece um canal de comunicaçã {:shortdesc} O serviço {{site.data.keyword.vpn_short}} fornece os recursos a seguir: -##Privacidade +## Privacidade O serviço IBM VPN usa o conjunto de protocolo padrão de mercado Internet Protocol Security (IPSec) para autenticar e criptografar a comunicação IP entre o datacenter corporativo e o ambiente de nuvem IBM Bluemix. O IPSec fornece autenticação de peer de nível de rede, integridade de dados e confidencialidade de dados (criptografia). O serviço IBM VPN suporta os protocolos e conversões IPSec a seguir: @@ -43,8 +43,8 @@ O serviço IBM VPN é compatível com as RFCs do IETF a seguir: * RFC 4303 para o Encapsulating Security Payload (ESP) IPv4 * RFC 2104 HMAC e RFC 2404 HMAC-SHA-1-96 para autenticação * RFC 2451 3DES-CBC; RFC 3602 AES128-CBC, AES192-CBC e AES256-CBC para criptografia -##Simplicidade +## Simplicidade É possível criar o serviço IBM VPN usando uma interface gráfica simples e intuitiva. É possível especificar seu endereço IP do gateway e suas sub-redes do datacenter. É possível usar as políticas IPSec e IKE padrão ou customizar as políticas para adequar às suas necessidades. -##Management +## Management É possível gerenciar o serviço IBM VPN usando uma interface gráfica, um [interface da linha de comandos](../../cli/plugins/vpn/index.html) ou [APIs](https://new-console.ng.bluemix.net/apidocs/101). diff --git a/services/vpn/nl/zh/CN/vpn_monitoring.md b/services/vpn/nl/zh/CN/vpn_monitoring.md index e5a39b677..621427ec2 100644 --- a/services/vpn/nl/zh/CN/vpn_monitoring.md +++ b/services/vpn/nl/zh/CN/vpn_monitoring.md @@ -17,7 +17,7 @@ copyright: 使用监视功能可查看内部部署或 SoftLayer 服务器 VPN 网关与 {{site.data.keyword.vpn_short}} 网关之间的连接状态和通讯流速率。 {:shortdesc} -##在服务仪表板上监视 +## 在服务仪表板上监视 {: #dashboard} 选择**监视**选项卡可查看以下连接统计信息。 @@ -29,7 +29,7 @@ copyright: 监视统计信息以图形显示，其中包含过去 48 小时的数据。这些图形每 20 分钟自动更新一次。不过，只要从监视选项卡切换出来再重新返回，即可随时访存最新数据。 **注：**这些图形使用全球标准时间 (UTC) 而非本地时间。 -##在 Logmet 上监视 +## 在 Logmet 上监视 {: #logmet} 使用 [Logmet](https://logmet.{DomainName}) 可查看详细的连接统计信息。 diff --git a/services/vpn/nl/zh/CN/vpn_onpremises.md b/services/vpn/nl/zh/CN/vpn_onpremises.md index cb1ed45f7..94ea4a33f 100644 --- a/services/vpn/nl/zh/CN/vpn_onpremises.md +++ b/services/vpn/nl/zh/CN/vpn_onpremises.md @@ -23,7 +23,7 @@ copyright: * [使用 SoftLayer Gateway Appliance Service (GaaS) 配置 IBM VPN](vpn_onpremises.html#gaas) * [使用 Cisco ASA 配置 IBM VPN](vpn_onpremises.html#cisco) -##使用 strongSwan 配置 IBM VPN 服务 +## 使用 strongSwan 配置 IBM VPN 服务 {: #strongswan} IBM VPN 设置使用以下示例配置： @@ -37,7 +37,7 @@ IBM VPN 设置使用以下示例配置： * VPN 网关 IP 地址（客户网关 IP）：169.55.254.166 * 与端点相连的子网地址（客户子网）：10.121.33.192/26 -###要搭配使用 IBM VPN 服务与 strongSwan，请按如下所示进行配置： +### 要搭配使用 IBM VPN 服务与 strongSwan，请按如下所示进行配置： 1. [配置网关](index.html#gateway)。 2. [配置站点连接](index.html#site)。 @@ -155,7 +155,7 @@ IBM VPN 设置使用以下示例配置： ``` {: screen} -##使用 Vyatta 配置 IBM VPN 服务 +## 使用 Vyatta 配置 IBM VPN 服务 {: #vyatta} IBM VPN 设置使用以下示例配置： @@ -169,7 +169,7 @@ IBM VPN 设置使用以下示例配置： * VPN 网关 IP 地址（客户网关 IP）：173.192.83.82 * 与端点相连的子网地址（客户子网）：192.168.201.0/24 -###要搭配使用 IBM VPN 服务与 Vyatta，请按如下所示进行配置： +### 要搭配使用 IBM VPN 服务与 Vyatta，请按如下所示进行配置： 1. [配置网关](index.html#gateway)。 2. [配置站点连接](index.html#site)。 @@ -437,7 +437,7 @@ IBM VPN 设置使用以下示例配置： ``` {: screen} -##使用 SoftLayer Gateway Appliance Service (GaaS) 配置 IBM VPN 服务 +## 使用 SoftLayer Gateway Appliance Service (GaaS) 配置 IBM VPN 服务 {: #gaas} IBM VPN 设置使用以下示例配置： @@ -452,7 +452,7 @@ IBM VPN 设置使用以下示例配置： * 与端点相连的子网地址（客户子网）：10.86.88.128/26 * 预共享密钥字符串：567890 -###要搭配使用 IBM VPN 服务与 SoftLayer GaaS，请按如下所示进行配置： +### 要搭配使用 IBM VPN 服务与 SoftLayer GaaS，请按如下所示进行配置： 1. 配置 SoftLayer GaaS： @@ -652,7 +652,7 @@ IBM VPN 设置使用以下示例配置： ``` {: screen} -##使用 Cisco ASA 配置 IBM VPN 服务 +## 使用 Cisco ASA 配置 IBM VPN 服务 {: #cisco} IBM VPN 设置使用以下示例配置： @@ -666,7 +666,7 @@ IBM VPN 设置使用以下示例配置： * VPN 网关 IP 地址（客户网关 IP）：62.95.35.53 * 与端点相连的子网地址（客户子网）：10.2.0.0/16 -###要搭配使用 IBM VPN 服务与 Cisco ASA，请按如下所示进行配置： +### 要搭配使用 IBM VPN 服务与 Cisco ASA，请按如下所示进行配置： 1. [配置网关](index.html#gateway)。 2. [配置站点连接](index.html#site)。 diff --git a/services/vpn/nl/zh/TW/vpn_onpremises.md b/services/vpn/nl/zh/TW/vpn_onpremises.md index 021881c2c..1d8e17ac8 100644 --- a/services/vpn/nl/zh/TW/vpn_onpremises.md +++ b/services/vpn/nl/zh/TW/vpn_onpremises.md @@ -23,7 +23,7 @@ copyright: * [使用 SoftLayer Gateway Appliance Service (GaaS) 配置 IBM VPN](vpn_onpremises.html#gaas) * [使用 Cisco ASA 配置 IBM VPN](vpn_onpremises.html#cisco) -##使用 strongSwan 配置 IBM VPN 服務 +## 使用 strongSwan 配置 IBM VPN 服務 {: #strongswan} IBM VPN 設定使用下列範例配置： @@ -37,7 +37,7 @@ IBM VPN 設定使用下列範例配置： * VPN 閘道 IP 位址（客戶閘道 IP）：169.55.254.166 * 與端點連接的子網路位址（客戶子網路）：10.121.33.192/26 -###若要搭配使用 IBM VPN 服務與 strongSwan，請如下進行配置： +### 若要搭配使用 IBM VPN 服務與 strongSwan，請如下進行配置： 1. [配置閘道](index.html#gateway)。 2. [配置網站連線](index.html#site)。 @@ -155,7 +155,7 @@ IBM VPN 設定使用下列範例配置： ``` {: screen} -##使用 Vyatta 配置 IBM VPN 服務 +## 使用 Vyatta 配置 IBM VPN 服務 {: #vyatta} IBM VPN 設定使用下列範例配置： @@ -169,7 +169,7 @@ IBM VPN 設定使用下列範例配置： * VPN 閘道 IP 位址（客戶閘道 IP）：173.192.83.82 * 與端點連接的子網路位址（客戶子網路）：192.168.201.0/24 -###若要搭配使用 IBM VPN 服務與 Vyatta，請如下進行配置： +### 若要搭配使用 IBM VPN 服務與 Vyatta，請如下進行配置： 1. [配置閘道](index.html#gateway)。 2. [配置網站連線](index.html#site)。 @@ -437,7 +437,7 @@ IBM VPN 設定使用下列範例配置： ``` {: screen} -##使用 SoftLayer Gateway Appliance Service (GaaS) 配置 IBM VPN 服務 +## 使用 SoftLayer Gateway Appliance Service (GaaS) 配置 IBM VPN 服務 {: #gaas} IBM VPN 設定使用下列範例配置： @@ -452,7 +452,7 @@ IBM VPN 設定使用下列範例配置： * 與端點連接的子網路位址（客戶子網路）：10.86.88.128/26 * 預先共用金鑰字串：567890 -###若要搭配使用 IBM VPN 服務與 SoftLayer GaaS，請如下進行配置： +### 若要搭配使用 IBM VPN 服務與 SoftLayer GaaS，請如下進行配置： 1. 配置 SoftLayer GaaS： @@ -652,7 +652,7 @@ IBM VPN 設定使用下列範例配置： ``` {: screen} -##使用 Cisco ASA 配置 IBM VPN 服務 +## 使用 Cisco ASA 配置 IBM VPN 服務 {: #cisco} IBM VPN 設定使用下列範例配置： @@ -666,7 +666,7 @@ IBM VPN 設定使用下列範例配置： * VPN 閘道 IP 位址（客戶閘道 IP）：62.95.35.53 * 與端點連接的子網路位址（客戶子網路）：10.2.0.0/16 -###若要搭配使用 IBM VPN 服務與 Cisco ASA，請如下進行配置： +### 若要搭配使用 IBM VPN 服務與 Cisco ASA，請如下進行配置： 1. [配置閘道](index.html#gateway)。 2. [配置網站連線](index.html#site)。 diff --git a/services/vpn/nl/zh/TW/vpn_overview.md b/services/vpn/nl/zh/TW/vpn_overview.md index e4aff1f4f..f973dcd7d 100644 --- a/services/vpn/nl/zh/TW/vpn_overview.md +++ b/services/vpn/nl/zh/TW/vpn_overview.md @@ -17,7 +17,7 @@ copyright: {:shortdesc} {{site.data.keyword.vpn_short}} 服務提供下列特性： -##安全 +## 安全 IBM VPN 服務使用業界標準網際網路通訊協定安全 (IPSec) 通訊協定套組，對公司資料中心與 IBM Bluemix 雲端環境之間的 IP 通訊進行鑑別和加密。IPSec 提供網路層次對等節點鑑別、資料完整性和資料機密性（加密）。 IBM VPN 服務支援下列 IPSec 通訊協定和轉換： @@ -43,8 +43,8 @@ IBM VPN 服務符合下列 IETF RFC 標準： * 適用於 IPv4 封裝安全有效負載 (ESP) 的 RFC 4303 * 適用於鑑別的 RFC 2104 HMAC 和 RFC 2404 HMAC-SHA-1-96 * 適用於加密的 RFC 2451 3DES-CBC、RFC 3602 AES128-CBC、AES192-CBC 和 AES256-CBC -##簡化 +## 簡化 您可以使用簡單且直覺的圖形介面來建立 IBM VPN 服務。您可以指定閘道 IP 位址和資料中心子網路。您可以使用預設 IPSec 和 IKE 原則，也可以根據需要自訂原則。 -##管理 +## 管理 您可以使用圖形介面、[指令行介面](../../cli/plugins/vpn/index.html)或 [API](https://new-console.ng.bluemix.net/apidocs/101) 來管理 IBM VPN 服務。 diff --git a/services/vpn/vpn_onpremises.md b/services/vpn/vpn_onpremises.md index 1d106cd2f..194dcd4b4 100644 --- a/services/vpn/vpn_onpremises.md +++ b/services/vpn/vpn_onpremises.md @@ -24,7 +24,7 @@ Your on-premises VPN gateway connects with the {{site.data.keyword.vpn_short}} g * [Configuring IBM VPN with IBM Bluemix Gateway Appliance Service](vpn_onpremises.html#gaas) * [Configuring IBM VPN with Cisco ASA](vpn_onpremises.html#cisco) -##Configuring the IBM VPN service with strongSwan +## Configuring the IBM VPN service with strongSwan {: #strongswan} The IBM VPN setup uses the following example configuration: @@ -37,7 +37,7 @@ Your on-premises strongSwan setup uses the following example configuration: * VPN gateway IP address (Customer Gateway IP): 169.55.254.166 * Subnet address to which endpoints are connected (Customer Subnet): 10.121.33.192/26 -###To use the IBM VPN service with strongSwan, configure as follows: +### To use the IBM VPN service with strongSwan, configure as follows: 1. [Configure the gateway](index.html#gateway). 2. [Configure site connection](index.html#site). @@ -154,7 +154,7 @@ Your on-premises strongSwan setup uses the following example configuration: ``` {: screen} -##Configuring the IBM VPN service with Vyatta +## Configuring the IBM VPN service with Vyatta {: #vyatta} The IBM VPN setup uses the following example configuration: @@ -167,7 +167,7 @@ Your on-premises Vyatta setup uses the following example configuration: * VPN gateway IP address (Customer Gateway IP): 173.192.83.82 * Subnet address to which endpoints are connected (Customer Subnet): 192.168.201.0/24 -###To use the IBM VPN service with Vyatta, configure as follows: +### To use the IBM VPN service with Vyatta, configure as follows: 1. [Configure the gateway](index.html#gateway). 2. [Configure site connection](index.html#site). @@ -435,7 +435,7 @@ Your on-premises Vyatta setup uses the following example configuration: ``` {: screen} -##Configuring the IBM VPN service with the IBM Bluemix Gateway Appliance Service +## Configuring the IBM VPN service with the IBM Bluemix Gateway Appliance Service {: #gaas} The IBM VPN setup uses the following example configuration: @@ -449,7 +449,7 @@ Your on-premises IBM Bluemix Gateway Appliance Service setup uses the following * Subnet address to which endpoints are connected (Customer Subnet): 10.86.88.128/26 * Preshared key string: 567890 -###To use the IBM VPN service with the IBM Bluemix Gateway Appliance Service, configure as follows: +### To use the IBM VPN service with the IBM Bluemix Gateway Appliance Service, configure as follows: 1. Configure IBM Bluemix Gateway Appliance Service: @@ -649,7 +649,7 @@ Your on-premises IBM Bluemix Gateway Appliance Service setup uses the following ``` {: screen} -##Configuring the IBM VPN service with Cisco ASA +## Configuring the IBM VPN service with Cisco ASA {: #cisco} The IBM VPN setup uses the following example configuration: @@ -662,7 +662,7 @@ Your on-premises setup uses the following example configuration: * VPN gateway IP address (Customer Gateway IP): 62.95.35.53 * Subnet address to which endpoints are connected (Customer Subnet): 10.2.0.0/16 -###To use the IBM VPN service with Cisco ASA, configure as follows: +### To use the IBM VPN service with Cisco ASA, configure as follows: 1. [Configure the gateway](index.html#gateway). 2. [Configure site connection](index.html#site). diff --git a/services/vpn/vpn_overview.md b/services/vpn/vpn_overview.md index 00e0dc0bc..0d08f8684 100644 --- a/services/vpn/vpn_overview.md +++ b/services/vpn/vpn_overview.md @@ -18,7 +18,7 @@ The {{site.data.keyword.vpn_full}} (VPN) service provides a secure communication {:shortdesc} The {{site.data.keyword.vpn_short}} service provides the following features: -##Security +## Security The IBM VPN service uses the industry-standard Internet Protocol Security (IPsec) protocol suite to authenticate and encrypt IP communication between your corporate data center and the IBM Bluemix cloud environment. IPsec provides network-level peer authentication, data integrity, and data confidentiality (encryption). The IBM VPN service supports the following IPsec protocols and transforms: @@ -45,9 +45,9 @@ The IBM VPN service is compliant with the following IETF RFCs: * RFC 4303 for IPv4 Encapsulating Security Payload (ESP) * RFC 2104 HMAC and RFC 2404 HMAC-SHA-1-96 for authentication * RFC 2451 3DES-CBC; RFC 3602 AES128-CBC, AES192-CBC, and AES256-CBC for encryption -##Simplicity +## Simplicity You can create the IBM VPN service by using a simple and intuitive graphical interface. You can specify your gateway IP address and your data center subnets. You can either use default IPsec and IKE policies, or customize the policies to suit your needs. -##Management +## Management You can manage the IBM VPN service by using a graphical interface, a [command line interface](/docs/cli/plugins/vpn/index.html), or [APIs](https://new-console.ng.bluemix.net/apidocs/101). ## Getting help and support for {{site.data.keyword.vpn_short}} diff --git a/starters/nl/it/deploy_devops.md b/starters/nl/it/deploy_devops.md index 32db6157c..a620658e1 100644 --- a/starters/nl/it/deploy_devops.md +++ b/starters/nl/it/deploy_devops.md @@ -1,91 +1,91 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2016-03-02" - - - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:download: .download} - -# Inizia a codificare con Git - -Puoi creare un repository Git ospitato che viene distribuito automaticamente a {{site.data.keyword.Bluemix}}. Puoi poi modificare il codice eseguito nella tua applicazione eseguendo il push -delle modifiche nel repository Git. -{:shortdesc} - -1. Per iniziare, nella pagina Panoramica dell'applicazione, fai clic su **Aggiungi pipeline e repository Git** o, nella modalità classica {{site.data.keyword.Bluemix_notm}}, fai clic su **AGGIUNGI GIT**. -2. Nella finestra così visualizzata, assicurati che la casella di spunta **Inserisci il pacchetto dell'applicazione starter nel repository e abilita la pipeline Crea e distribuisci** sia selezionata. Il repository Git viene creato. Se il codice di starter è disponibile, -è caricato nel repository. Inoltre, l'applicazione viene distribuita dal servizio Delivery Pipeline in esecuzione in {{site.data.keyword.jazzhub}}. -3. Per aggiornare la tua applicazione, puoi utilizzare la riga comandi o il Web IDE. - **Se utilizzi la riga comandi:** - a. Clona il tuo repository Git dall'URL Git nella pagina Panoramica dell'applicazione. - b. Aggiorna il codice nel tuo editor preferito. - c. Esegui il push delle modifiche dall'interfaccia della riga di comando Git. - - **Se utilizzi l'IDE web:** - a. Nella pagina Panoramica dell'applicazione, fai clic su **Modifica codice**. Il tuo progetto viene aperto nel Web IDE. - b. Apporta le modifiche necessarie ed esegui il push utilizzando il supporto Git integrato. - -L'applicazione aggiornata viene ridistribuita in {{site.data.keyword.Bluemix_notm}}. - -Per istruzioni dettagliate, vedi [Set up Git integration and auto-deploy in DevOps Services ![icona link esterno](../icons/launch-glyph.svg)](https://hub.jazz.net/tutorials/jazzeditor/#git_integration_and_autodeployment){: new_window}. - -## Hai aggiunto Git? Prova {{site.data.keyword.Bluemix_notm}} Live Sync - -Se stai creando un'applicazione Node.js, puoi utilizzare {{site.data.keyword.Bluemix_notm}} Live Sync per aggiornare rapidamente l'istanza dell'applicazione su {{site.data.keyword.Bluemix_notm}} ed eseguire attività di sviluppo come faresti sul desktop. - -Per ulteriori informazioni su {{site.data.keyword.Bluemix_notm}} Live Sync, vedi [{{site.data.keyword.Bluemix_notm}} Live Sync](/docs/develop/bluemixlive.html). Per ulteriori dettagli sui comandi, vedi la [{{site.data.keyword.Bluemix_notm}} documentazione della CLI Live Sync](/docs/cli/reference/bl/index.html). Per utilizzare {{site.data.keyword.Bluemix_notm}} Live Sync con il Web IDE, vedi [Live Edit](/docs/develop/bluemixlive.html). - -Prima di iniziare, scarica e installa la riga di comando bl di {{site.data.keyword.Bluemix_notm}} Live Sync. - -**Importante:** lo strumento riga di comando bl è disponibile solo per Windows 7 e 8 e per Mac OS X versione 10.9 o successive. - -

      -Pulsante Scarica la riga di comando bl per Windows -Pulsante Scarica la riga di comando bl per Mac -

      - -1. Su una riga di comando, accedi immettendo il seguente comando: -``` -bl login -``` -Quando ti viene richiesto, immetti il tuo {{site.data.keyword.ibmid}} e la password. - -2. Visualizza l'elenco dei progetti disponibili per la sincronizzazione di {{site.data.keyword.Bluemix_notm}} Live Sync immettendo il seguente comando: -``` -bl projects -``` -Trova il nome progetto nell'elenco che corrisponde alla -tua applicazione. Il nome del progetto ha il formato *alias* | *nome applicazione*. - -3. Sincronizza il tuo ambiente locale con il tuo progetto su {{site.data.keyword.Bluemix_notm}} immettendo -il seguente comando. Se sei il proprietario del progetto, devi specificare solo il nome-della-tua-applicazione per nomeProgetto. - -``` -bl sync projectName -d localDirectory --verbose -``` -L'esecuzione di questo comando (così come la sincronizzazione) continua finché -non si immette una "q". L'opzione --verbose visualizza informazioni sulla registrazione e sullo stato. Se qualcuno dei tuoi argomenti contiene uno spazio, devi racchiudere il nome tra virgolette. - -4. In un'altra finestra di riga di comando, nella tua directory locale, distribuisci l'applicazione a {{site.data.keyword.Bluemix_notm}} in -modalità Live Edit immettendo il seguente comando: -``` -bl start -``` - -Quando modifichi i file nella tua directory locale, le modifiche vengono propagate automaticamente sia -all'applicazione che è in esecuzione su {{site.data.keyword.Bluemix_notm}} sia -allo spazio di lavoro cloud del progetto. Se devi riavviare l'applicazione Node, puoi utilizzare -il comando: -``` -bl start --restart -``` +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2016-03-02" + + + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:download: .download} + +# Inizia a codificare con Git + +Puoi creare un repository Git ospitato che viene distribuito automaticamente a {{site.data.keyword.Bluemix}}. Puoi poi modificare il codice eseguito nella tua applicazione eseguendo il push +delle modifiche nel repository Git. +{:shortdesc} + +1. Per iniziare, nella pagina Panoramica dell'applicazione, fai clic su **Aggiungi pipeline e repository Git** o, nella modalità classica {{site.data.keyword.Bluemix_notm}}, fai clic su **AGGIUNGI GIT**. +2. Nella finestra così visualizzata, assicurati che la casella di spunta **Inserisci il pacchetto dell'applicazione starter nel repository e abilita la pipeline Crea e distribuisci** sia selezionata. Il repository Git viene creato. Se il codice di starter è disponibile, +è caricato nel repository. Inoltre, l'applicazione viene distribuita dal servizio Delivery Pipeline in esecuzione in {{site.data.keyword.jazzhub}}. +3. Per aggiornare la tua applicazione, puoi utilizzare la riga comandi o il Web IDE. + **Se utilizzi la riga comandi:** + a. Clona il tuo repository Git dall'URL Git nella pagina Panoramica dell'applicazione. + b. Aggiorna il codice nel tuo editor preferito. + c. Esegui il push delle modifiche dall'interfaccia della riga di comando Git. + + **Se utilizzi l'IDE web:** + a. Nella pagina Panoramica dell'applicazione, fai clic su **Modifica codice**. Il tuo progetto viene aperto nel Web IDE. + b. Apporta le modifiche necessarie ed esegui il push utilizzando il supporto Git integrato. + +L'applicazione aggiornata viene ridistribuita in {{site.data.keyword.Bluemix_notm}}. + +Per istruzioni dettagliate, vedi [Set up Git integration and auto-deploy in DevOps Services ![icona link esterno](../icons/launch-glyph.svg)](https://hub.jazz.net/tutorials/jazzeditor/#git_integration_and_autodeployment){: new_window}. + +## Hai aggiunto Git? Prova {{site.data.keyword.Bluemix_notm}} Live Sync + +Se stai creando un'applicazione Node.js, puoi utilizzare {{site.data.keyword.Bluemix_notm}} Live Sync per aggiornare rapidamente l'istanza dell'applicazione su {{site.data.keyword.Bluemix_notm}} ed eseguire attività di sviluppo come faresti sul desktop. + +Per ulteriori informazioni su {{site.data.keyword.Bluemix_notm}} Live Sync, vedi [{{site.data.keyword.Bluemix_notm}} Live Sync](/docs/develop/bluemixlive.html). Per ulteriori dettagli sui comandi, vedi la [{{site.data.keyword.Bluemix_notm}} documentazione della CLI Live Sync](/docs/cli/reference/bl/index.html). Per utilizzare {{site.data.keyword.Bluemix_notm}} Live Sync con il Web IDE, vedi [Live Edit](/docs/develop/bluemixlive.html). + +Prima di iniziare, scarica e installa la riga di comando bl di {{site.data.keyword.Bluemix_notm}} Live Sync. + +**Importante:** lo strumento riga di comando bl è disponibile solo per Windows 7 e 8 e per Mac OS X versione 10.9 o successive. + +

      +Pulsante Scarica la riga di comando bl per Windows +Pulsante Scarica la riga di comando bl per Mac +

      + +1. Su una riga di comando, accedi immettendo il seguente comando: +``` +bl login +``` +Quando ti viene richiesto, immetti il tuo {{site.data.keyword.ibmid}} e la password. + +2. Visualizza l'elenco dei progetti disponibili per la sincronizzazione di {{site.data.keyword.Bluemix_notm}} Live Sync immettendo il seguente comando: +``` +bl projects +``` +Trova il nome progetto nell'elenco che corrisponde alla +tua applicazione. Il nome del progetto ha il formato *alias* | *nome applicazione*. + +3. Sincronizza il tuo ambiente locale con il tuo progetto su {{site.data.keyword.Bluemix_notm}} immettendo +il seguente comando. Se sei il proprietario del progetto, devi specificare solo il nome-della-tua-applicazione per nomeProgetto. + +``` +bl sync projectName -d localDirectory --verbose +``` +L'esecuzione di questo comando (così come la sincronizzazione) continua finché +non si immette una "q". L'opzione --verbose visualizza informazioni sulla registrazione e sullo stato. Se qualcuno dei tuoi argomenti contiene uno spazio, devi racchiudere il nome tra virgolette. + +4. In un'altra finestra di riga di comando, nella tua directory locale, distribuisci l'applicazione a {{site.data.keyword.Bluemix_notm}} in +modalità Live Edit immettendo il seguente comando: +``` +bl start +``` + +Quando modifichi i file nella tua directory locale, le modifiche vengono propagate automaticamente sia +all'applicazione che è in esecuzione su {{site.data.keyword.Bluemix_notm}} sia +allo spazio di lavoro cloud del progetto. Se devi riavviare l'applicazione Node, puoi utilizzare +il comando: +``` +bl start --restart +``` diff --git a/starters/nl/it/deploy_eclipsetools.md b/starters/nl/it/deploy_eclipsetools.md index 92b322a60..ce1291221 100644 --- a/starters/nl/it/deploy_eclipsetools.md +++ b/starters/nl/it/deploy_eclipsetools.md @@ -1,35 +1,35 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2017-01-12" - - - ---- - -{:download: .download} -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# Sviluppare con Eclipse Tools - -{{site.data.keyword.eclipsetoolsfull}} fornisce -dei leggeri strumenti in Eclipse per uno sviluppo e un'integrazione rapidi di applicazioni con cloud {{site.data.keyword.Bluemix}} o -Cloud Foundry. -{:shortdesc} - - 1. Se non disponi già di Eclipse, installa Eclipse Neon for Java EE Developers (4.6.1). - 2. Fai clic e tieni premuto il seguente pulsante per trascinarlo e rilasciarlo nella barra degli strumenti Eclipse e segui quindi le richieste che ti vengono presentate per installare IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}: - - [![Trascinalo e rilascialo in uno spazio di lavoro Eclipse Neon in esecuzione per installare IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}](images/installbutton.png)](http://marketplace.eclipse.org/marketplace-client-intro?mpc_install=1774120) - - 3. {: download} Scarica il tuo codice di starter e importalo in Eclipse andando a **File>Importa progetti esistenti nello spazio di lavoro>File di archivio**. - - Scarica codice di starter - -Per istruzioni dettagliate relative alla distribuzione delle applicazioni, vedi [Distribuzione di applicazioni con IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](/docs/manageapps/eclipsetools/eclipsetools.html#eclipsetools){: new_window}. +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2017-01-12" + + + +--- + +{:download: .download} +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# Sviluppare con Eclipse Tools + +{{site.data.keyword.eclipsetoolsfull}} fornisce +dei leggeri strumenti in Eclipse per uno sviluppo e un'integrazione rapidi di applicazioni con cloud {{site.data.keyword.Bluemix}} o +Cloud Foundry. +{:shortdesc} + + 1. Se non disponi già di Eclipse, installa Eclipse Neon for Java EE Developers (4.6.1). + 2. Fai clic e tieni premuto il seguente pulsante per trascinarlo e rilasciarlo nella barra degli strumenti Eclipse e segui quindi le richieste che ti vengono presentate per installare IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}: + + [![Trascinalo e rilascialo in uno spazio di lavoro Eclipse Neon in esecuzione per installare IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}](images/installbutton.png)](http://marketplace.eclipse.org/marketplace-client-intro?mpc_install=1774120) + + 3. {: download} Scarica il tuo codice di starter e importalo in Eclipse andando a **File>Importa progetti esistenti nello spazio di lavoro>File di archivio**. + + Scarica codice di starter + +Per istruzioni dettagliate relative alla distribuzione delle applicazioni, vedi [Distribuzione di applicazioni con IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](/docs/manageapps/eclipsetools/eclipsetools.html#eclipsetools){: new_window}. diff --git a/starters/nl/it/deploy_vs.md b/starters/nl/it/deploy_vs.md index f3aaeebf1..3dfb0b0f9 100644 --- a/starters/nl/it/deploy_vs.md +++ b/starters/nl/it/deploy_vs.md @@ -1,31 +1,31 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2016-06-25" - - - ---- - -{:download: .download} -{:new_window: target="_blank"} - -# Sviluppo con Visual Studio - - 1. Se ancora non hai Visual Studio, installa Visual Studio 2015 o Visual Studio Code seguendo le istruzioni [qui ![icona link esterno](../icons/launch-glyph.svg)](https://msdn.microsoft.com/en-us/library/e2h7fzkw.aspx){: new_window}. - - 1. {: download} Scarica il codice starter e estrailo in una cartella del tuo disco rigido. - - 1. Apri il progetto in Visual Studio - - + Se stai utilizzando Visual Studio 2015, apri il file della soluzione (file .sln) andando in **File > Open > Project/Solution**. - + Se stai utilizzando Visual Studio Code, apri la cartella che contiene il file della soluzione (file .slne) andando in **File > Open**. - - 1. Come hai modificato il tuo codice puoi ridistribuirlo utilizzando gli strumenti CF o CLI Bluemix. - -Per istruzioni dettagliate relative alla distribuzione delle applicazioni, vedi [Deploying apps with CF CLI ![icona link esterno](../icons/launch-glyph.svg)](./install_cli.html){: new_window}. +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2016-06-25" + + + +--- + +{:download: .download} +{:new_window: target="_blank"} + +# Sviluppo con Visual Studio + + 1. Se ancora non hai Visual Studio, installa Visual Studio 2015 o Visual Studio Code seguendo le istruzioni [qui ![icona link esterno](../icons/launch-glyph.svg)](https://msdn.microsoft.com/en-us/library/e2h7fzkw.aspx){: new_window}. + + 1. {: download} Scarica il codice starter e estrailo in una cartella del tuo disco rigido. + + 1. Apri il progetto in Visual Studio + + + Se stai utilizzando Visual Studio 2015, apri il file della soluzione (file .sln) andando in **File > Open > Project/Solution**. + + Se stai utilizzando Visual Studio Code, apri la cartella che contiene il file della soluzione (file .slne) andando in **File > Open**. + + 1. Come hai modificato il tuo codice puoi ridistribuirlo utilizzando gli strumenti CF o CLI Bluemix. + +Per istruzioni dettagliate relative alla distribuzione delle applicazioni, vedi [Deploying apps with CF CLI ![icona link esterno](../icons/launch-glyph.svg)](./install_cli.html){: new_window}. diff --git a/starters/nl/it/install_cli.md b/starters/nl/it/install_cli.md index 61bc39d3f..db57ec311 100644 --- a/starters/nl/it/install_cli.md +++ b/starters/nl/it/install_cli.md @@ -1,77 +1,77 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2017-01-12" - - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:prereq: .prereq} -{:download: .download} -{:pre: .pre} -{:app_name: data-hd-keyref="app_name"} -{:app_key: data-hd-keyref="app_key"} -{:app_secret: data-hd-keyref="app_secret"} -{:app_url: data-hd-keyref="app_url"} -{:host: data-hd-keyref="host"} -{:org_name: data-hd-keyref="org_name"} -{:route: data-hd-keyref="route"} -{:space_name: data-hd-keyref="space_name"} -{:service_name: data-hd-keyref="service_name"} -{:service_instance_name: data-hd-keyref="service_instance_name"} -{:user_ID: data-hd-keyref="user_ID"} - -# Scarica, modifica e ridistribuisci la tua applicazione Cloud Foundry con l'interfaccia della riga di comando - -Utilizza l'interfaccia riga di comando Cloud Foundry per scaricare, modificare e ridistribuire le tue istanze del servizio e applicazioni Cloud Foundry. -{:shortdesc} - -Prima di iniziare, scarica e installa l'interfaccia di riga di comando Cloud Foundry. - -

      -Scarica l'interfaccia riga di comando Cloud Foundry -

      - -**Limitazione:** lo strumento della riga di comando non è supportato da Cygwin. Utilizzalo in una finestra della riga di comando diversa da quella di Cygwin. -{:prereq} - -Dopo aver installato l'interfaccia riga di comando, puoi iniziare: - - 1. {: download} Scarica il codice per la tua applicazione in una nuova directory per configurare il tuo ambiente di sviluppo. - - Scarica il codice dell'applicazione - - 2. Passa alla directory in cui si trova il codice. - - 
      cd your_new_directory
      - - 3. Apporta le modifiche al codice della tua applicazione, adattandolo. Ad esempio, se stai utilizzando un'applicazione di esempio {{site.data.keyword.Bluemix}} che contiene il file `src/main/webapp/index.html`, puoi modificarlo con "Thanks for creating ..." per fare qualcosa di nuovo. Assicurati che l'applicazione sia in esecuzione localmente prima di distribuirla a {{site.data.keyword.Bluemix_notm}}. - - Prendi nota del file `manifest.yml`. Quando ridistribuisci la tua applicazione a {{site.data.keyword.Bluemix_notm}}, questo file viene utilizzato per determinare l'URL, l'allocazione di memoria, il numero di istanze e altri parametri fondamentali della tua applicazione. Puoi [leggere ulteriori informazioni sul file manifest ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://docs.cloudfoundry.org/devguide/deploy-apps/manifest.html){: new_window} nella documentazione Cloud Foundry. - - Presta inoltre attenzione al file `README.md`, che contiene dettagli come le istruzioni di creazione se applicabili. - - Nota: se la tua applicazione è un'applicazione Liberty, devi crearla prima di ridistribuirla. - - 4. Collegati ed accedi a {{site.data.keyword.Bluemix_notm}}. - - 
      cf api https://api.DomainName
      - - 
      cf login -u nomeutente -o nome_org -s nome_spazio
      - - Se stai utilizzando un ID federato, usa l'opzione `-sso`. - - 
      cf login -u username -o org_name -s space_name -sso
      - - 5. Da your_new_directory, ridistribuisci la tua applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando il comando `cf push`. Per ulteriori informazioni sul comando `cf push`, consulta [Caricamento della tua applicazione](/docs/starters/upload_app.html). - - 
      cf push nome_applicazione
      - - 6. Accedi alla tua applicazione andando all'indirizzo https://nome_applicazione.AppDomainName. +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2017-01-12" + + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:prereq: .prereq} +{:download: .download} +{:pre: .pre} +{:app_name: data-hd-keyref="app_name"} +{:app_key: data-hd-keyref="app_key"} +{:app_secret: data-hd-keyref="app_secret"} +{:app_url: data-hd-keyref="app_url"} +{:host: data-hd-keyref="host"} +{:org_name: data-hd-keyref="org_name"} +{:route: data-hd-keyref="route"} +{:space_name: data-hd-keyref="space_name"} +{:service_name: data-hd-keyref="service_name"} +{:service_instance_name: data-hd-keyref="service_instance_name"} +{:user_ID: data-hd-keyref="user_ID"} + +# Scarica, modifica e ridistribuisci la tua applicazione Cloud Foundry con l'interfaccia della riga di comando + +Utilizza l'interfaccia riga di comando Cloud Foundry per scaricare, modificare e ridistribuire le tue istanze del servizio e applicazioni Cloud Foundry. +{:shortdesc} + +Prima di iniziare, scarica e installa l'interfaccia di riga di comando Cloud Foundry. + +

      +Scarica l'interfaccia riga di comando Cloud Foundry +

      + +**Limitazione:** lo strumento della riga di comando non è supportato da Cygwin. Utilizzalo in una finestra della riga di comando diversa da quella di Cygwin. +{:prereq} + +Dopo aver installato l'interfaccia riga di comando, puoi iniziare: + + 1. {: download} Scarica il codice per la tua applicazione in una nuova directory per configurare il tuo ambiente di sviluppo. + + Scarica il codice dell'applicazione + + 2. Passa alla directory in cui si trova il codice. + + 
      cd your_new_directory
      + + 3. Apporta le modifiche al codice della tua applicazione, adattandolo. Ad esempio, se stai utilizzando un'applicazione di esempio {{site.data.keyword.Bluemix}} che contiene il file `src/main/webapp/index.html`, puoi modificarlo con "Thanks for creating ..." per fare qualcosa di nuovo. Assicurati che l'applicazione sia in esecuzione localmente prima di distribuirla a {{site.data.keyword.Bluemix_notm}}. + + Prendi nota del file `manifest.yml`. Quando ridistribuisci la tua applicazione a {{site.data.keyword.Bluemix_notm}}, questo file viene utilizzato per determinare l'URL, l'allocazione di memoria, il numero di istanze e altri parametri fondamentali della tua applicazione. Puoi [leggere ulteriori informazioni sul file manifest ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://docs.cloudfoundry.org/devguide/deploy-apps/manifest.html){: new_window} nella documentazione Cloud Foundry. + + Presta inoltre attenzione al file `README.md`, che contiene dettagli come le istruzioni di creazione se applicabili. + + Nota: se la tua applicazione è un'applicazione Liberty, devi crearla prima di ridistribuirla. + + 4. Collegati ed accedi a {{site.data.keyword.Bluemix_notm}}. + + 
      cf api https://api.DomainName
      + + 
      cf login -u nomeutente -o nome_org -s nome_spazio
      + + Se stai utilizzando un ID federato, usa l'opzione `-sso`. + + 
      cf login -u username -o org_name -s space_name -sso
      + + 5. Da your_new_directory, ridistribuisci la tua applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando il comando `cf push`. Per ulteriori informazioni sul comando `cf push`, consulta [Caricamento della tua applicazione](/docs/starters/upload_app.html). + + 
      cf push nome_applicazione
      + + 6. Accedi alla tua applicazione andando all'indirizzo https://nome_applicazione.AppDomainName. diff --git a/starters/nl/it/upload_app.md b/starters/nl/it/upload_app.md index c30025471..b757cd035 100644 --- a/starters/nl/it/upload_app.md +++ b/starters/nl/it/upload_app.md @@ -1,66 +1,66 @@ ---- - - - -copyright: - - years: 2015，2017 - -lastupdated: "2017-01-12" - - - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# Caricamento della tua applicazione - -Dopo che hai eseguito l'accesso a {{site.data.keyword.Bluemix}}, puoi caricare la tua applicazione con il comando cf push. -{:shortdesc} - -Prima di iniziare, devi: - 1. Installa le interfacce riga di comando {{site.data.keyword.Bluemix}} e Cloud Foundry. - - Scarica l'interfaccia riga di comando {{site.data.keyword.Bluemix}} Scarica l'interfaccia riga di comando Cloud Foundry - - 2. Stabilisci una connessione a {{site.data.keyword.Bluemix}}. - - 
      bluemix api https://api.DomainName
      - - 3. Accedi a {{site.data.keyword.Bluemix_notm}}. - - 
      bluemix login -u nome_utente -o nome_organizzazione -s nome_spazio
      - -Quando viene immesso un comando **cf push**, l'interfaccia riga di comando **cf** fornisce -la directory di lavoro all'ambiente {{site.data.keyword.Bluemix_notm}} che usa -un pacchetto di build per creare ed eseguire l'applicazione. - - 1. Dalla directory dell'applicazione, immetti il comando **cf -push** con il nome dell'applicazione. Il nome dell'applicazione deve essere univoco nell'ambiente {{site.data.keyword.Bluemix_notm}}. - - 
      cf push app_name -m 512m
      - - {{site.data.keyword.Bluemix_notm}} include -i pacchetti di build integrati. In alcuni casi, anche per i pacchetti di build integrati, devi fornire inoltre un'opzione -c per specificare il comando utilizzato per avviare la tua applicazione. Ad esempio, devi usare l'opzione -c per distribuire la tua applicazione Node.js: - - 
      cf push app_name -c start_command
      - - Inoltre, l'applicazione Node.js deve contenere un file package.json valido. - - La distribuzione di tutti gli altri pacchetti di build esterni deve essere eseguita utilizzando l'opzione -b. Ad -esempio: - - 
      cf push app_name -b buildpack_URL
      - - **Suggerimento:** quando utilizzi il comando **cf push**, l'interfaccia riga di comando **cf** copia tutti i file e tutte le directory dalla tua directory corrente a Bluemix. Assicurati di avere solo i file richiesti nella directory della tua applicazione. - - Il comando cf push carica e distribuisce la tua applicazione a {{site.data.keyword.Bluemix_notm}}. Per ulteriori informazioni su cf push, vedi [Comandi cf](/docs/cli/reference/cfcommands/index.html). Per informazioni sui pacchetti di build, vedi [Utilizzo dei pacchetti di build della community](/docs/cfapps/byob.html). - - 2. Se modifichi la tua applicazione, puoi caricare tali modifiche immettendo nuovamente il comando cf push. L'Interfaccia -riga di comando cf utilizza le tue opzioni precedenti e le tue risposte -ai prompt per aggiornare con i nuovi bit di codice le eventuali istanze dell'applicazione -in esecuzione. - -**Suggerimento:** puoi anche caricare o distribuire un'applicazione da DevOps Services. Consulta [Developing a {{site.data.keyword.Bluemix_notm}} application in Node.js with the Web IDE ![icona link esterno](../icons/launch-glyph.svg)](https://hub.jazz.net/tutorials/devopsweb/){: new_window}. +--- + + + +copyright: + + years: 2015，2017 + +lastupdated: "2017-01-12" + + + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# Caricamento della tua applicazione + +Dopo che hai eseguito l'accesso a {{site.data.keyword.Bluemix}}, puoi caricare la tua applicazione con il comando cf push. +{:shortdesc} + +Prima di iniziare, devi: + 1. Installa le interfacce riga di comando {{site.data.keyword.Bluemix}} e Cloud Foundry. + + Scarica l'interfaccia riga di comando {{site.data.keyword.Bluemix}} Scarica l'interfaccia riga di comando Cloud Foundry + + 2. Stabilisci una connessione a {{site.data.keyword.Bluemix}}. + + 
      bluemix api https://api.DomainName
      + + 3. Accedi a {{site.data.keyword.Bluemix_notm}}. + + 
      bluemix login -u nome_utente -o nome_organizzazione -s nome_spazio
      + +Quando viene immesso un comando **cf push**, l'interfaccia riga di comando **cf** fornisce +la directory di lavoro all'ambiente {{site.data.keyword.Bluemix_notm}} che usa +un pacchetto di build per creare ed eseguire l'applicazione. + + 1. Dalla directory dell'applicazione, immetti il comando **cf +push** con il nome dell'applicazione. Il nome dell'applicazione deve essere univoco nell'ambiente {{site.data.keyword.Bluemix_notm}}. + + 
      cf push app_name -m 512m
      + + {{site.data.keyword.Bluemix_notm}} include +i pacchetti di build integrati. In alcuni casi, anche per i pacchetti di build integrati, devi fornire inoltre un'opzione -c per specificare il comando utilizzato per avviare la tua applicazione. Ad esempio, devi usare l'opzione -c per distribuire la tua applicazione Node.js: + + 
      cf push app_name -c start_command
      + + Inoltre, l'applicazione Node.js deve contenere un file package.json valido. + + La distribuzione di tutti gli altri pacchetti di build esterni deve essere eseguita utilizzando l'opzione -b. Ad +esempio: + + 
      cf push app_name -b buildpack_URL
      + + **Suggerimento:** quando utilizzi il comando **cf push**, l'interfaccia riga di comando **cf** copia tutti i file e tutte le directory dalla tua directory corrente a Bluemix. Assicurati di avere solo i file richiesti nella directory della tua applicazione. + + Il comando cf push carica e distribuisce la tua applicazione a {{site.data.keyword.Bluemix_notm}}. Per ulteriori informazioni su cf push, vedi [Comandi cf](/docs/cli/reference/cfcommands/index.html). Per informazioni sui pacchetti di build, vedi [Utilizzo dei pacchetti di build della community](/docs/cfapps/byob.html). + + 2. Se modifichi la tua applicazione, puoi caricare tali modifiche immettendo nuovamente il comando cf push. L'Interfaccia +riga di comando cf utilizza le tue opzioni precedenti e le tue risposte +ai prompt per aggiornare con i nuovi bit di codice le eventuali istanze dell'applicazione +in esecuzione. + +**Suggerimento:** puoi anche caricare o distribuire un'applicazione da DevOps Services. Consulta [Developing a {{site.data.keyword.Bluemix_notm}} application in Node.js with the Web IDE ![icona link esterno](../icons/launch-glyph.svg)](https://hub.jazz.net/tutorials/devopsweb/){: new_window}. diff --git a/support/nl/it/index.md b/support/nl/it/index.md index 4656c42a9..a68227424 100644 --- a/support/nl/it/index.md +++ b/support/nl/it/index.md @@ -1,405 +1,405 @@ ---- - -copyright: - years: 2015, 2017 - -lastupdated: "2017-03-01" - ---- - - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# Richiesta di assistenza clienti -{: #getting-customer-support} - - - -Se riscontri dei problemi con {{site.data.keyword.Bluemix}}, hai diverse opzioni di supporto, quali l'ottenimento di una guida mediante un forum o l'apertura di un ticket di supporto. -{:shortdesc} - - -## Come ottenere supporto -{: #getting-help} -Per aprire un ticket di supporto o trovare altre opzioni di assistenza, puoi utilizzare il widget Supporto. Puoi anche andare direttamente ai forum di Stack Overflow o developerWorks (dW) Answers per cercare informazioni o pubblicare domande. Se stai utilizzando un account che è collegato tra {{site.data.keyword.Bluemix_notm}} e {{site.data.keyword.BluSoftlayer}}, vedi [Utilizzo del widget Supporto per gli account collegati](#using-avatar-linked) e [Apertura di un ticket di supporto per i link collegati](#open-ticket-linked). - -{:shortdesc} - - -### Utilizzo del widget Supporto -{: #using-avatar} -Il widget Supporto ti consente di ottenere assistenza e fornire un feedback. - -Per aprire il widget Supporto, accedi alla console {{site.data.keyword.Bluemix_notm}}. Dalla barra dei menu, fai clic su **Supporto** > **Trova risposte** per individuare le risposte alle tue domande. Nella pagina che viene visualizzata, immetti la tua domanda nel campo di ricerca. Vengono visualizzate risposte provenienti da tutta la documentazione di {{site.data.keyword.Bluemix_notm}} e da Stack Overflow. La pagina fornisce anche opzioni per la pubblicazione della tua domanda in Stack Overflow o per aprire un ticket facendo clic su **CONTATTA**. Sebbene il widget di supporto sia il metodo preferito per l'ottenimento del supporto, se non puoi accedere a Bluemix, puoi utilizzare la pagina [Richiedi assistenza](ibm.biz/bluemixsupport) per inviare un ticket. - -### Utilizzo del widget Supporto per gli account collegati -{: #using-avatar-linked} - -Se stai utilizzando un account che è collegato tra {{site.data.keyword.Bluemix_notm}} e {{site.data.keyword.BluSoftlayer}}, il widget Supporto è leggermente diverso. Accedi alla console {{site.data.keyword.Bluemix_notm}} e fai clic sul link **Supporto** nella barra dei menu per aprire il widget Supporto e seleziona quindi **Aggiungi ticket** > **Trova risposte**. Sono disponibili le seguenti opzioni: - -* Puoi effettuare delle ricerche tramite la documentazione {{site.data.keyword.Bluemix_notm}}, Stack Overflow e DW Answers impostando un filtro per modificare i risultati della ricerca in modo da includere solo gli elementi selezionati. -* Puoi collegarti direttamente a Stack Overflow **#IBMBluemix** o DW Answers per le tue ricerche o pubblicazioni. -* Puoi inoltrare un'idea strutturata al sito [IBM Cloud - Structured Ideas](https://ibmcloud.ideas.aha.io/). -* Puoi contattare il reparto vendite chiamando o cercando un rappresentante delle vendite. Vedi la pagina [Contatti](https://www.ibm.com/cloud-computing/bluemix/contact-us). -* Puoi connetterti con [**@IBMBluemixHelp**](http://www.twitter.com/IBMBluemixHelp) su Twitter per migliorare la tua esperienza {{site.data.keyword.Bluemix_notm}}. -* Sebbene il widget di supporto sia il metodo preferito per l'ottenimento del supporto, se non puoi accedere a {{site.data.keyword.Bluemix_notm}}, puoi utilizzare la pagina [Richiedi assistenza](ibm.biz/bluemixsupport) per inviare un ticket. - - - -### Utilizzo delle voci del menu Account -{: #using-accountmenu} - -Utilizza le voci del menu Account per restare aggiornato sulle notifiche della piattaforma, gestire l'organizzazione e i membri del team e visualizzare le informazioni sull'utilizzo dell'organizzazione e gli addebiti correnti. - - -### Porre una domanda -{: #asking-a-question} - -I forum Stack Overflow e dW Answers forniscono entrambi un'ampia gamma di risposte alle tue domande relative a {{site.data.keyword.Bluemix_notm}} che puoi consultare. Se non trovi una risposta esistente, poni una nuova domanda. - - * Vai a [Stack Overflow ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://stackoverflow.com/questions/tagged/ibm-bluemix){: new_window} per porre domande tecniche sullo sviluppo di applicazioni con la piattaforma e i servizi {{site.data.keyword.Bluemix_notm}}. - * Vai a [dW Answers ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/answers/smart-spaces/12/bluemix.html){: new_window} per porre domande sull'offerta {{site.data.keyword.Bluemix_notm}} e su istruzioni introduttive. - - -Puoi anche porre una domanda in Stack Overflow direttamente dalle voci di menu Supporto completando la seguente procedura: - 1. Fai clic su **Supporto** > **Trova risposte**. - 2. Nel pannello visualizzato, immetti la tua domanda nel campo di ricerca e fai clic sull'icona Ricerca per cercare le risposte. - 3. Se non viene restituita la risposta prevista, fai clic su **PUBBLICA in STACK OVERFLOW** per pubblicare la tua domanda. - -I team di sviluppo e supporto di {{site.data.keyword.Bluemix_notm}} monitorano attivamente Stack Overflow e dW Answers e seguono le domande -che hanno la tag **bluemix**. Quando crei una domanda nell'uno o nell'altro forum, aggiungi una tag **bluemix** alla tua domanda per accertarti che venga vista dai team di sviluppo e supporto di {{site.data.keyword.Bluemix_notm}}. - - - -## Visualizzazione dello stato di {{site.data.keyword.Bluemix_notm}} -{: #viewing-bluemix-status} - -La pagina Stato di {{site.data.keyword.Bluemix_notm}} è la posizione centrale per trovare notifiche e annunci sugli eventi chiave che interessano la piattaforma {{site.data.keyword.Bluemix_notm}} e i principali servizi in {{site.data.keyword.Bluemix_notm}}. - -Nella pagina Stato, puoi trovare le seguenti informazioni: - - * Lo stato corrente di servizi e componenti in tutte le regioni {{site.data.keyword.Bluemix_notm}}. - * Un elenco di annunci, in ordine cronologico, per la manutenzione -e gli eventi imprevisti. Puoi filtrare l'elenco o aprire un singolo annuncio -per ulteriori dettagli. - * Finestre di manutenzione pianificata, che vengono pubblicate con almeno 24 ore -di anticipo, tranne che in casi estremi. - * Interruzioni o eventi imprevisti non pianificati, che vengono pubblicati non appena il team di {{site.data.keyword.Bluemix_notm}} ne -viene a conoscenza. Le notifiche sugli eventi imprevisti vengono regolarmente aggiornati finché non -vengono risolti. - * Riferimenti a bollettini di sicurezza che incidono sulla piattaforma e sui vari servizi {{site.data.keyword.Bluemix_notm}}. - * Altri annunci a livello di piattaforma di interesse generale per te. - * Un feed RSS a cui puoi sottoscrivere. - -Puoi individuare la pagina Stato scegliendo una delle seguenti opzioni: - - * Accedi alla console {{site.data.keyword.Bluemix_notm}}. Dalla barra dei menu, fai clic su **Supporto** e seleziona **Stato**. Controlla le risorse elencate per l'icona di ![alcuni problemi](images/some_issues.svg). Questa icona potrebbe indicare un'interruzione. - * Accedi direttamente alla pagina [IBM {{site.data.keyword.Bluemix_notm}} - Stato del sistema![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://ibm.biz/bluemixstatus){: new_window}. - - -### Sottoscrizione a un feed RSS -{: #subscribing-rss-feed} - -Puoi ricevere avvisi di eventuali notifiche sottoscrivendo il feed RSS per la pagina Stato di {{site.data.keyword.Bluemix_notm}}. In questo modo puoi ottenere gli aggiornamenti senza dover consultare regolarmente la pagina sullo stato. - -Per eseguire la sottoscrizione, completa la seguente procedura: - - 1. Scarica e installa un lettore RSS. - 2. Utilizza il tuo lettore per sottoscrivere il feed con uno dei seguenti -metodi: - * Trascina l'icona RSS ![RSS](images/rss.svg) nel tuo lettore RSS. - * Fai clic con il tasto destro del mouse sull'icona RSS, seleziona **Copia indirizzo link** e incolla l'URL -nel tuo lettore RSS. - - Per ulteriori informazioni, vedi la sezione **Guida** del -tuo lettore. - -Altri metodi di lettura dei feed RSS sono disponibili tramite plug-in del browser Web come: - * [RSS Feed ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://feeder.co/){: new_window} Reader for Chrome - * [Brief ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://addons.mozilla.org/en-US/firefox/addon/brief/){: new_window} add-on for Firefox - -Fonti di notizie, come i seguenti siti, forniscono anche dei metodi per la lettura dei feed RSS: - * [Feedly ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://www.feedly.com/){: new_window} - * [G2reader ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://www.g2reader.com/en/){: new_window} - -Puoi inoltre -utilizzare un servizio di terze parti per inviare automaticamente un'e-mail -per ogni aggiornamento RSS. Il seguente elenco riporta alcuni esempi di servizi di terze parti: - - * www.feedmyinbox.com - * www.rssforward.com - * www.feedrabbit.com - * www.mailchimp.com - * www.feedmailer.com - * www.iftt.com - -{{site.data.keyword.Bluemix_notm}} solitamente -ha circa 50 aggiornamenti al mese. - - - -### Configurazione di notifiche e-mail per incidenti e manutenzione -{: #setting-up-notifications} - -Per {{site.data.keyword.Bluemix_notm}} pubblico, puoi registrarti per ricevere le notifiche della piattaforma. Le notifiche della piattaforma sono avvisi e-mail facoltativi per eventi di incidenti e manutenzione relativi alla piattaforma {{site.data.keyword.Bluemix_notm}}. Puoi scegliere di ricevere queste notifiche e-mail facendo clic sulle opzioni della voce di menu **Account** > **Notifiche** > **Piattaforma**. Per ulteriori informazioni sull'impostazione delle notifiche di account, vai a [Impostazione delle notifiche](/docs/admin/account.html#notifications). - - -### Procedure consigliate per il monitoraggio dello stato -{: #best-practices} - - * Controlla le prossime finestre di manutenzione - - Controlla le prossime finestre di manutenzione pubblicate nella pagina dello stato, -almeno una volta ogni 24 ore, utilizzando una delle seguenti opzioni:: - * Andando direttamente alla pagina [Stato ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://ibm.biz/bluemixstatus){: new_window} - * Utilizzando il feed RSS o un'utilità di inoltro da RSS a email - - * Controlla le finestre di manutenzione correnti o un evento imprevisto in corso - - Se hai il sospetto che {{site.data.keyword.Bluemix_notm}} non -funzioni nel modo previsto, consulta la pagina dello stato per controllare le finestre di manutenzione correnti o -un evento imprevisto in corso. Per segnalare un evento imprevisto non ancora elencato nella pagina dello stato, apri un ticket di supporto tramite la voce di **Supporto** nella barra dei menu o la pagina di assistenza [IBM Bluemix Support ![icona link esterno](../icons/launch-glyph.svg "External link icon")](ibm.biz/bluemixsupport){: new_window}. - - * Usufruisci di più regioni {{site.data.keyword.Bluemix_notm}} - - Tutti gli utenti di {{site.data.keyword.Bluemix_notm}} pubblico hanno automaticamente accesso alle regioni US-SOUTH, EU-GB e AU-SYD: - - * US-SOUTH: https://console.ng.bluemix.net - * EU-GB: https://console.eu-gb.bluemix.net - * AU-SYD: https://console.au-syd.bluemix.net - - Il team di {{site.data.keyword.Bluemix_notm}} Global Operations gestisce tutte le regioni per evitare impatti sulla manutenzione e ridurre al minimo il rischio di eventi imprevisti che influiscano contemporaneamente su tutte le regioni. - - * Prepararsi a piccole interruzioni - - Nella maggior parte dei casi, si può continuare a utilizzare {{site.data.keyword.Bluemix_notm}} -normalmente, anche durante la finestra di manutenzione. Tuttavia, non è sempre possibile evitare delle brevi interruzioni di servizio. In genere, le applicazioni in esecuzione rimangono disponibili anche se le funzioni -di gestione applicazione di {{site.data.keyword.Bluemix_notm}}, -come l'avvio o l'arresto di applicazioni, vengono temporaneamente interrotte. Per -massimizzare la disponibilità delle tue applicazioni in esecuzione, esegui almeno -tre istanze di ciascuna applicazione. - - - -## Come contattare il supporto -{: #contacting-support} - -Se disponi di un account {{site.data.keyword.Bluemix_notm}} valido, puoi aprire ticket di supporto utilizzando una serie di opzioni. [Apertura di un ticket di supporto](#open-ticket). - -Se hai un account {{site.data.keyword.Bluemix_notm}} collegato a un account {{site.data.keyword.BluSoftlayer_full}}, puoi aprire ticket di supporto per {{site.data.keyword.Bluemix_notm}} dal portale del cliente {{site.data.keyword.BluSoftlayer}} o dalla console {{site.data.keyword.Bluemix_notm}} utilizzando il widget Supporto. Vedi [Apertura di un ticket di supporto per i link collegati](#open-ticket-linked). - -### Come contattare il supporto per {{site.data.keyword.Bluemix_notm}} pubblico -{: #contacting-bluemix-support} - -A tutti i clienti di {{site.data.keyword.Bluemix_notm}} viene fornito supporto tecnico gratuito tramite la community {{site.data.keyword.Bluemix_notm}} o Stack Overflow. Inoltre, vengono forniti diversi tipi di supporto per soddisfare i bisogni di diversi clienti. Fai riferimento alla seguente tabella per scegliere tra i livelli di supporto gratuito, di base, standard e premium. - -Livelli | Gratuito | Di base | Standard | Premium ---- | --- | --- | --- | --- | -Descrizione | Supporto per tutti i clienti in prova di {{site.data.keyword.Bluemix_notm}}. | Supporto per gli ambienti di non produzione o per i carichi di lavoro per cui le severità e i tempi di risposta tradizionali non sono necessari. | Supporto per gli ambienti con un numero limitato di applicazioni critiche di business. I clienti {{site.data.keyword.Bluemix_notm}} dedicato e {{site.data.keyword.Bluemix_notm}} locale ricevono il supporto standard. | Supporto per gli ambienti di importanza critica che hanno una dipendenza strategica da {{site.data.keyword.Bluemix_notm}}. -Supporto severità 1-4 | N/D | N/D | Incluso | Include -il supporto lingua | Inglese | Inglese | Inglese, Giapponese | CSM (client success manager) -assegnato Inglese, Giapponese | Non incluso | Non incluso | Non incluso | Incluso per
      8 ore a settimana -{: caption="Table 1. Support levels" caption-side="top"} - -**Importante:** il supporto in lingua giapponese è disponibile per i ticket con severità 2-4 dal lunedì al venerdì dalle ore 9:00 a.m. alle ore 5:00 p.m. JST, escluse le festività nazionali o ufficiali. I servizi della community e di terze parti sono esclusi. I ticket con severità 1 sono trattati solo in inglese. - -### Apertura di un ticket di supporto -{: #open-ticket} - -Se non sei riuscito a risolvere il tuo problema tecnico con le opzioni di risoluzione dei problemi e di guida, puoi richiedere assistenza. Tuttavia, prima di contattare il supporto per un problema tecnico, accertati che non sia dovuto a un'interruzione del servizio, controllando lo stato di [{{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://ibm.biz/bluemixstatus){: new_window}. - - - -Se il problema non è dovuto a un'interruzione, apri un ticket di supporto attraverso una delle seguenti opzioni: - - * Dal menu Supporto, fai clic su **Aggiungi ticket**. Nella pagina che viene visualizzata, compila il modulo per indicare il tipo di supporto tecnico di cui hai bisogno. - * Utilizza la pagina di assistenza [IBM {{site.data.keyword.Bluemix_notm}} Support ![icona link esterno](../icons/launch-glyph.svg "External link icon")](ibm.biz/bluemixsupport){: new_window}. Puoi inoltrare ticket per problemi relativi a vendite, fatturazione, ID IBM e accesso e supporto tecnico. Per questi ultimi, una volta fatto clic su **Supporto tecnico** puoi selezionare un gruppo tecnico. Ad esempio, se hai bisogno di assistenza per le applicazioni Cloud Foundry, {{site.data.keyword.openwhisk_short}}, Containers, Virtual Servers o per i server Bare Metal, puoi selezionare **Servizi dell'applicazione**. Se hai bisogno di aiuto per un servizio specifico, seleziona la categoria di servizi corrispondente. Per determinare la categoria di appartenenza del tuo servizio, consulta le categorie riportate in [Servizi](/docs/services/index.html) nel riquadro di navigazione. - -Quando apri un ticket di supporto, accertati di indicare una gravità appropriata per il tuo ticket. Quest'ultima determina il modo in cui il tuo ticket viene gestito. Per informazioni sui diversi livelli di severità, vedi [Severità e tempo di risposta del ticket di supporto](/docs/support/index.html#support-ticket-severity). Se la tua domanda di supporto richiede una risposta più immediata, ti raccomandiamo di eseguire l'aggiornamento ai nostri livelli di supporto Standard o Premium in modo che puoi aumentare la severità dei ticket di supporto da 1 a 4. Per eseguire l'upgrade a un livello di supporto superiore, contatta il tuo [rappresentante delle vendite IBM![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://www.ibm.com/cloud-computing/bluemix/contact-us){: new_window} o inviaci una e-email all'indirizzo sales@bluemix.net. - -### Apertura di un ticket di supporto per i link collegati -{: #open-ticket-linked} - -Se stai utilizzando un account che è collegato tra {{site.data.keyword.Bluemix_notm}} e {{site.data.keyword.BluSoftlayer}}, puoi aprire un ticket di supporto dalla console {{site.data.keyword.Bluemix_notm}} utilizzando il widget Supporto. - -Per aprire un ticket di supporto {{site.data.keyword.Bluemix_notm}} per un account collegato, fai clic su **Supporto** dalla barra dei menu per aprire il widget Supporto e seleziona **Aggiungi ticket**. Nel modulo del ticket, seleziona **Tecnico** per il tipo di ticket e compila il modulo per indicare per cosa hai bisogno di supporto tecnico. Se disponi di un supporto di livello Premium, scegli il livello di gravità per il tuo problema. In pochi minuti riceverai una notifica e-mail per il ticket. Segui le istruzioni nell'e-mail per ulteriori comunicazioni sul problema. - - -### Controllo dello stato del ticket di supporto -{: #check-ticket-status} - -Tutti i problemi di supporto per il client vengono documentati in un ticket di supporto. A ogni ticket di supporto viene assegnato un numero di riferimento ticket univoco e un livello di severità in base ai dettagli nella descrizione del ticket. Puoi utilizzare il numero di ticket per vedere lo stato di avanzamento del tuo ticket di supporto e per aggiornare il ticket. Dal menu Supporto, seleziona **Visualizza ticket**. Gli aggiornamenti e le risposte ti vengono inviati per email e registrati nelle note del ticket. - - - - -### Come contattare il supporto per {{site.data.keyword.Bluemix_notm}} dedicato -{: #contacting-bluemix-support-dedicated} - - - -Se sei un cliente di {{site.data.keyword.Bluemix_notm}} dedicato, il supporto viene fornito dal team di IBM {{site.data.keyword.Bluemix_notm}} Support. A seconda che tu disponga di un {{site.data.keyword.ibmid}} puoi scegliere tra diverse opzioni per ottenere assistenza. - -
        -
      • Contatta il supporto aprendo un nuovo ticket mediante la pagina -di assistenza IBM {{site.data.keyword.Bluemix_notm}} Support. Per questo modulo puoi utilizzare un indirizzo e-mail o il tuo {{site.data.keyword.ibmid}}. Seleziona l'opzione **{{site.data.keyword.Bluemix_notm}} dedicato** per il campo regione. -

        Gli invii dei moduli vengono monitorati dalla domenica alle ore 21:30 UTC fino al venerdì alle ore 23:59 UTC. Per assistenza nella conversione di queste ore di supporto al tuo fuso orario locale, vedi [Timeanddate.com ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://www.timeanddate.com).

        -
        • -
      • Se disponi di un {{site.data.keyword.ibmid}} e dell'accesso all'ambiente {{site.data.keyword.Bluemix_notm}} pubblico, nella barra dei menu fai clic su **Supporto** > **Aggiungi ticket**. Seleziona l'area tematica per il tuo problema e segui le indicazioni per inviare il ticket.
        • -
      • Se non disponi di un {{site.data.keyword.ibmid}}, puoi contattare un membro della tua organizzazione che ne abbia uno o collaborare con il tuo rappresentante IBM. -

        **Nota**: su richiesta, è disponibile un elenco di utenti dell'organizzazione che possono fungere da contatti per i ticket di supporto e che può essere visualizzato nella pagina **Supporto** della console {{site.data.keyword.Bluemix_notm}} nel tuo ambiente Dedicato.

        • -
      - -### Come contattare il supporto per {{site.data.keyword.Bluemix_notm}} locale -{: #contacting-bluemix-support-local} - - - -Se sei un cliente di {{site.data.keyword.Bluemix_notm}} locale, l'assistenza viene fornita dal team di supporto {{site.data.keyword.Bluemix_notm}} IBM. Tuttavia, poiché potresti non disporre di un {{site.data.keyword.ibmid}}, hai alcune opzioni diverse per ottenere assistenza. - -
        -
      • Contatta il supporto aprendo un nuovo ticket mediante la pagina -di assistenza IBM {{site.data.keyword.Bluemix_notm}} Support icona link eserno. Per questo modulo puoi utilizzare un indirizzo e-mail o il tuo {{site.data.keyword.ibmid}}. Seleziona l'opzione **{{site.data.keyword.Bluemix_notm}} locale** per il campo regione. -

        Gli invii dei moduli vengono monitorati dalla domenica alle ore 21:30 UTC fino al venerdì alle ore 23:59 UTC. Per assistenza nella conversione di queste ore di supporto al tuo fuso orario locale, vedi [Timeanddate.com ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://www.timeanddate.com).

        -
        • -
      • Se disponi di un {{site.data.keyword.ibmid}} e dell'accesso all'ambiente {{site.data.keyword.Bluemix_notm}} pubblico, nella barra dei menu fai clic su **Supporto** > **Aggiungi ticket**. Seleziona l'area tematica per il tuo problema e segui le indicazioni per inviare il ticket.
        • -
      • Se non disponi di un {{site.data.keyword.ibmid}}, puoi contattare un membro della tua organizzazione che ne abbia uno o collaborare con il tuo rappresentante IBM. -

        **Nota**: su richiesta, è disponibile un elenco di utenti dell'organizzazione che possono fungere da contatti per i ticket di supporto e che può essere visualizzato nella pagina **Supporto** della console {{site.data.keyword.Bluemix_notm}} nel tuo ambiente Locale.

        • -
      - -### Gravità e tempo di risposta del ticket di supporto -{: #support-ticket-severity} - -Quando contatti il supporto, puoi richiedere un determinato livello di severità, a seconda del tipo e dell'urgenza del problema. Il livello di severità può incidere sulla rapidità con cui viene affrontato il tuo problema. - -La seguente tabella elenca alcuni esempi comuni di problemi di supporto, di livelli di gravità suggeriti e di obiettivi del tempo di risposta. Gli obiettivi del tempo di risposta vengono utilizzati solo per descrivere gli obiettivi di IBM e non rappresentano una garanzia sulle prestazioni. - -**Orario di operatività:** dalla domenica alle 21:30 UTC al venerdì alle 23:59 UTC (escluse festività di Stati Uniti/Italia/Australia). Per assistenza nella conversione di queste ore di supporto al tuo fuso orario locale, vedi [Timeanddate.com ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://www.timeanddate.com). Per ulteriori informazioni sulla pianificazione delle festività, vedi [Bluemix Support Holidays ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://ibm.biz/bluemixholidays). - - -Severità | Definizione di gravità | Obiettivi del tempo di risposta | Copertura del tempo di risposta -------|-------- | --- | --- | -Severità 1 | Impatto sul business critico o il servizio non funziona.
      La funzionalità critica di business non è utilizzabile o un'interfaccia critica ha avuto un malfunzionamento. Questa gravità normalmente si applica all'ambiente di produzione e indica l'impossibilità ad accedere ai servizi ed è segno di un impatto critico sulle operazioni. Questa condizione richiede una soluzione immediata. |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: in 1 ora
      • Premium: in 1 ora
      |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: 24x7
      • Premium: 24x7
      -Severità 2 | Impatto sul business significativo.
      L'utilizzo di una funzione o funzionalità è severamente limitato o sei a rischio di saltare delle scadenze di business. |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: in 2 ore
      • Premium: in 90 minuti
      |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: Orario di operatività
      • Premium: Orario di operatività
      -Severità 3 | Impatto sul business minore.
      Una funzione o funzionalità è utilizzabile ma riscontra dei problemi che ne influenzano l'utilizzo. Non viene causato alcun impatto critico sulle operazioni. |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: in 4 ore
      • Premium: in 2 ore
      |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: Orario di operatività
      • Premium: Orario di operatività
      -Severità 4 | Impatto sul business minimo.
      Una domanda o una richiesta non tecnica. |
      • Gratuito: Massimo impegno
      • Di base: Massimo impegno
      • Standard: in 8 ore
      • Premium: in 4 ore
      |
      • Gratuito: Orario di operatività
      • Di base: Orario di operatività
      • Standard: Orario di operatività
      • Premium: Orario di operatività
      -{: caption="Table 2. Severity definition and response time" caption-side="top"} - - -### Modalità di supporto per i diversi servizi -Puoi definire la severità del problema in base alle tue esigenze di business e al tuo livello di supporto. Tutti i ticket vengono esaminati con lo scopo di identificare e risolvere la causa principale. Se sono richiesti i dati diagnostici del problema per determinarne la causa principale, ti verrà chiesta l'approvazione per accedere ai file di log e ad altri dati per la determinazione del problema dalla tua applicazione. Senza questi dati, la risoluzione del problema potrebbe richiedere più tempo. Una volta completata l'analisi della causa principale, il team effettuerà una delle seguenti operazioni: -* Servizio generalmente disponibile IBM o immagine contenitore
      -Se l'analisi della causa principale stabilisce che il problema è un difetto nel servizio generalmente disponibile IBM o nell'immagine del contenitore, il ticket viene indirizzato in base alla severità che hai assegnato. -* Servizio Beta IBM o immagine contenitore
      -IBM rilascerà i servizi o le immagini del contenitore classificati come una release Beta. Una release Beta aiuta i team di sviluppo e di marketing IBM a valutare la qualità del servizio nel mercato. Di conseguenza, possono apportare modifiche prima di rilasciarla come servizio generalmente disponibile o immagine del contenitore. Se l'analisi della causa principale stabilisce che il problema è un difetto nel servizio Beta IBM o nell'immagine del contenitore, IBM non è tenuto a fornire una correzione. Inoltre, al ticket viene assegnata una severità 3 o 4 a seconda del caso. -* Servizio sperimentale IBM o immagine contenitore
      -IBM rilascerà i servizi o le immagini del contenitore classificati come sperimentali. Questi servizi potrebbero essere instabili, cambiare frequentemente e potrebbero essere sospesi con breve preavviso. Per i servizi classificati come sperimentali, puoi ottenere l'assistenza della community solo attraverso [Stack Overflow ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://stackoverflow.com/questions/tagged/ibm-bluemix){: new_window} e [dW Answers ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/answers/smart-spaces/12/bluemix.html){: new_window}. -* Servizio di terze parti
      -I servizi di terze parti sono offerti dai fornitori esterni a IBM. Questi servizi sono forniti da singole entità software, partner o fornitori software indipendenti (ISV). Se l'analisi della causa principale stabilisce che il problema è un difetto in un servizio di terze parti, IBM non è tenuto a fornire una correzione. Tuttavia, IBM collaborerà attraverso il nostro Marketplace con il servizio di terze parti e con il nostro cliente per risolvere il problema. -* Servizio open source o della community
      -I servizi open source o della community sono forniti dalle community open source esterne a IBM. Se l'analisi della causa principale stabilisce che il problema è un difetto in un servizio open source o della community, IBM non è tenuto a fornire una correzione. IBM chiuderà il ticket e ti rimanderà alla community o al forum per assistenza. - - -### Notifica di una vulnerabilità di sicurezza potenziale -{: #report-security-vulnerability} - -Se credi si sia verificata una vulnerabilità di sicurezza potenziale, notificalo a Bluemix aprendo un ticket di supporto. - -Per notificare una vulnerabilità di sicurezza potenziale, completa la seguente procedura: - 1. Apri un ticket di severità 1 o un ticket di un alto livello di severità consentito dal tuo supporto. Per informazioni su come aprire un ticket, vedi [Apertura di un ticket di supporto![icona link esterno](../icons/launch-glyph.svg "External link icon")](#open-ticket){: new_window}. - 2. Descrivi chiaramente nel riepilogo del ticket che riguarda una vulnerabilità di sicurezza potenziale. - 2. Fornisci i dettagli della vulnerabilità di sicurezza potenziale includendo una delle seguenti voci: - * Un numero di telefono in cui puoi essere raggiunto per discutere del problema. - * I dettagli del problema. Devi crittografare i dettagli come un blocco di testo nel corpo del ticket e fornire le istruzioni su come il supporto IBM può contattarti in sicurezza per ottenere le istruzioni di decrittografia. - - - -### Escalation di un ticket di supporto -{: #escalation} - -Con un supporto standard o premium, se non hai ricevuto una risposta tempestiva a un ticket di supporto o ritieni che il ticket non venga affrontato in maniera appropriata, puoi effettuarne l'escalation. Attraverso il processo di escalation del ticket di supporto, IBM prende in considerazione le tue preoccupazioni e collabora con te per migliorare la tua esperienza di supporto. - -Per inoltrare una richiesta di escalation, completa la seguente procedura: - 1. Apri un nuovo ticket di supporto con riepilogo **Richiesta di escalation**. - 2. Per accertarti che venga trovata una corrispondenza tra la tua richiesta di escalation e il ticket di supporto originale, includi le seguenti informazioni nel corpo del ticket: - * Il numero del tuo ticket di supporto aperto, che necessita di un'escalation. - * Un breve riepilogo dei motivi per cui occorre un'escalation. - - - -## Raccolta delle informazioni di diagnostica -{: #collecting-diagnostic-information} -Per diagnosticare e risolvere i problemi con le applicazioni e i servizi {{site.data.keyword.Bluemix_notm}}, -il team di supporto {{site.data.keyword.Bluemix_notm}} -potrebbe chiederti di raccogliere informazioni di diagnostica. - -Prima di raccogliere le informazioni di diagnostica, completa la -seguente procedura: - - 1. Assicurati di aver installato l'interfaccia riga di comando cf più recente. Per ulteriori informazioni, vedi [Installing the cf -command line interface](/docs/starters/install_cli.html). - - **Nota:** se non hai installato l'interfaccia riga di comando cf più recente, dopo aver connesso la riga di comando cf a {{site.data.keyword.Bluemix_notm}}, il comando `cf logs` potrebbe non restituire alcun input. - - 2. Assicurati di aver connesso l'interfaccia riga di comando cf alla posizione in cui {{site.data.keyword.Bluemix_notm}} è -in esecuzione utilizzando il comando `cf api`. - - 3. Assicurati di soddisfare tutti i prerequisiti in [Prerequisiti di {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/bluemix/support/#prereqs){: new_window}. - -Utilizza i seguenti script per raccogliere le informazioni di diagnostica: - - * Per i sistemi operativi Windows, scarica il file [bmdiag-general.bat ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://bluemix-mustgather.mybluemix.net/mustgather/general/bmdiag-general.bat){: new_window} ed eseguilo. - * Per i sistemi operativi Linux e Mac, scarica il file [bmdiag-general.sh ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://bluemix-mustgather.mybluemix.net/mustgather/general/bmdiag-general.sh){: new_window} ed eseguilo. - -Gli script utilizzano l'interfaccia riga di comando cf per estrarre -le seguenti informazioni dal tuo ambiente applicativo: - - * Log dell'applicazione - * Metadati dell'applicazione - * Rotte configurate - * Eventi - * Servizi con provisioning - - -## Supporto di lingua nazionale per {{site.data.keyword.Bluemix_notm}} -{: #lang} - -{{site.data.keyword.Bluemix_notm}} supporta -lingue nazionali diverse dall'inglese. Tuttavia, non tutto il contenuto fornito con {{site.data.keyword.Bluemix_notm}} -è tradotto. -La seguente tabella elenca le lingue nazionali supportate e i codici lingua per {{site.data.keyword.Bluemix_notm}}. - -| **Lingua nazionale** | **Codice lingua** | -|-------------------|---------------| -| Portoghese (Brasile) | pt_BR | -| Inglese | en | -| Francese | fr | -| Tedesco | de | -| Giapponese | ja | -| Coreano | ko | -| Italiano | it | -| Spagnolo | es | -| Cinese semplificato | zh_CN | -| Cinese tradizionale | zh_TW | -{: caption="Table 3. Supported national languages and language codes" caption-side="top"} - - - -## Sondaggio sulla soddisfazione per il supporto {{site.data.keyword.Bluemix_notm}} -{: #survey} - -IBM invia periodicamente i sondaggi ai clienti {{site.data.keyword.Bluemix_notm}} per ottenere i loro feedback sulle recenti esperienze con il supporto clienti. Il sondaggio si concentra sulla qualità del supporto e sull'esperienza complessiva. La gestione di IBM rivede i risultati del sondaggio per migliorare l'esperienza di supporto. - - -# rellinks -{: #rellinks} - -## general -{: #general} - - * [Bluemix support portal ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://support.ibmcloud.com){: new_window} - * [dW Answers ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/answers/smart-spaces/12/bluemix.html){: new_window} - * [Installazione dello strumento di comando cf](/docs/starters/install_cli.html) - * [Stack Overflow ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://stackoverflow.com/questions/tagged/ibm-bluemix){: new_window} - +--- + +copyright: + years: 2015, 2017 + +lastupdated: "2017-03-01" + +--- + + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# Richiesta di assistenza clienti +{: #getting-customer-support} + + + +Se riscontri dei problemi con {{site.data.keyword.Bluemix}}, hai diverse opzioni di supporto, quali l'ottenimento di una guida mediante un forum o l'apertura di un ticket di supporto. +{:shortdesc} + + +## Come ottenere supporto +{: #getting-help} +Per aprire un ticket di supporto o trovare altre opzioni di assistenza, puoi utilizzare il widget Supporto. Puoi anche andare direttamente ai forum di Stack Overflow o developerWorks (dW) Answers per cercare informazioni o pubblicare domande. Se stai utilizzando un account che è collegato tra {{site.data.keyword.Bluemix_notm}} e {{site.data.keyword.BluSoftlayer}}, vedi [Utilizzo del widget Supporto per gli account collegati](#using-avatar-linked) e [Apertura di un ticket di supporto per i link collegati](#open-ticket-linked). + +{:shortdesc} + + +### Utilizzo del widget Supporto +{: #using-avatar} +Il widget Supporto ti consente di ottenere assistenza e fornire un feedback. + +Per aprire il widget Supporto, accedi alla console {{site.data.keyword.Bluemix_notm}}. Dalla barra dei menu, fai clic su **Supporto** > **Trova risposte** per individuare le risposte alle tue domande. Nella pagina che viene visualizzata, immetti la tua domanda nel campo di ricerca. Vengono visualizzate risposte provenienti da tutta la documentazione di {{site.data.keyword.Bluemix_notm}} e da Stack Overflow. La pagina fornisce anche opzioni per la pubblicazione della tua domanda in Stack Overflow o per aprire un ticket facendo clic su **CONTATTA**. Sebbene il widget di supporto sia il metodo preferito per l'ottenimento del supporto, se non puoi accedere a Bluemix, puoi utilizzare la pagina [Richiedi assistenza](ibm.biz/bluemixsupport) per inviare un ticket. + +### Utilizzo del widget Supporto per gli account collegati +{: #using-avatar-linked} + +Se stai utilizzando un account che è collegato tra {{site.data.keyword.Bluemix_notm}} e {{site.data.keyword.BluSoftlayer}}, il widget Supporto è leggermente diverso. Accedi alla console {{site.data.keyword.Bluemix_notm}} e fai clic sul link **Supporto** nella barra dei menu per aprire il widget Supporto e seleziona quindi **Aggiungi ticket** > **Trova risposte**. Sono disponibili le seguenti opzioni: + +* Puoi effettuare delle ricerche tramite la documentazione {{site.data.keyword.Bluemix_notm}}, Stack Overflow e DW Answers impostando un filtro per modificare i risultati della ricerca in modo da includere solo gli elementi selezionati. +* Puoi collegarti direttamente a Stack Overflow **#IBMBluemix** o DW Answers per le tue ricerche o pubblicazioni. +* Puoi inoltrare un'idea strutturata al sito [IBM Cloud - Structured Ideas](https://ibmcloud.ideas.aha.io/). +* Puoi contattare il reparto vendite chiamando o cercando un rappresentante delle vendite. Vedi la pagina [Contatti](https://www.ibm.com/cloud-computing/bluemix/contact-us). +* Puoi connetterti con [**@IBMBluemixHelp**](http://www.twitter.com/IBMBluemixHelp) su Twitter per migliorare la tua esperienza {{site.data.keyword.Bluemix_notm}}. +* Sebbene il widget di supporto sia il metodo preferito per l'ottenimento del supporto, se non puoi accedere a {{site.data.keyword.Bluemix_notm}}, puoi utilizzare la pagina [Richiedi assistenza](ibm.biz/bluemixsupport) per inviare un ticket. + + + +### Utilizzo delle voci del menu Account +{: #using-accountmenu} + +Utilizza le voci del menu Account per restare aggiornato sulle notifiche della piattaforma, gestire l'organizzazione e i membri del team e visualizzare le informazioni sull'utilizzo dell'organizzazione e gli addebiti correnti. + + +### Porre una domanda +{: #asking-a-question} + +I forum Stack Overflow e dW Answers forniscono entrambi un'ampia gamma di risposte alle tue domande relative a {{site.data.keyword.Bluemix_notm}} che puoi consultare. Se non trovi una risposta esistente, poni una nuova domanda. + + * Vai a [Stack Overflow ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://stackoverflow.com/questions/tagged/ibm-bluemix){: new_window} per porre domande tecniche sullo sviluppo di applicazioni con la piattaforma e i servizi {{site.data.keyword.Bluemix_notm}}. + * Vai a [dW Answers ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/answers/smart-spaces/12/bluemix.html){: new_window} per porre domande sull'offerta {{site.data.keyword.Bluemix_notm}} e su istruzioni introduttive. + + +Puoi anche porre una domanda in Stack Overflow direttamente dalle voci di menu Supporto completando la seguente procedura: + 1. Fai clic su **Supporto** > **Trova risposte**. + 2. Nel pannello visualizzato, immetti la tua domanda nel campo di ricerca e fai clic sull'icona Ricerca per cercare le risposte. + 3. Se non viene restituita la risposta prevista, fai clic su **PUBBLICA in STACK OVERFLOW** per pubblicare la tua domanda. + +I team di sviluppo e supporto di {{site.data.keyword.Bluemix_notm}} monitorano attivamente Stack Overflow e dW Answers e seguono le domande +che hanno la tag **bluemix**. Quando crei una domanda nell'uno o nell'altro forum, aggiungi una tag **bluemix** alla tua domanda per accertarti che venga vista dai team di sviluppo e supporto di {{site.data.keyword.Bluemix_notm}}. + + + +## Visualizzazione dello stato di {{site.data.keyword.Bluemix_notm}} +{: #viewing-bluemix-status} + +La pagina Stato di {{site.data.keyword.Bluemix_notm}} è la posizione centrale per trovare notifiche e annunci sugli eventi chiave che interessano la piattaforma {{site.data.keyword.Bluemix_notm}} e i principali servizi in {{site.data.keyword.Bluemix_notm}}. + +Nella pagina Stato, puoi trovare le seguenti informazioni: + + * Lo stato corrente di servizi e componenti in tutte le regioni {{site.data.keyword.Bluemix_notm}}. + * Un elenco di annunci, in ordine cronologico, per la manutenzione +e gli eventi imprevisti. Puoi filtrare l'elenco o aprire un singolo annuncio +per ulteriori dettagli. + * Finestre di manutenzione pianificata, che vengono pubblicate con almeno 24 ore +di anticipo, tranne che in casi estremi. + * Interruzioni o eventi imprevisti non pianificati, che vengono pubblicati non appena il team di {{site.data.keyword.Bluemix_notm}} ne +viene a conoscenza. Le notifiche sugli eventi imprevisti vengono regolarmente aggiornati finché non +vengono risolti. + * Riferimenti a bollettini di sicurezza che incidono sulla piattaforma e sui vari servizi {{site.data.keyword.Bluemix_notm}}. + * Altri annunci a livello di piattaforma di interesse generale per te. + * Un feed RSS a cui puoi sottoscrivere. + +Puoi individuare la pagina Stato scegliendo una delle seguenti opzioni: + + * Accedi alla console {{site.data.keyword.Bluemix_notm}}. Dalla barra dei menu, fai clic su **Supporto** e seleziona **Stato**. Controlla le risorse elencate per l'icona di ![alcuni problemi](images/some_issues.svg). Questa icona potrebbe indicare un'interruzione. + * Accedi direttamente alla pagina [IBM {{site.data.keyword.Bluemix_notm}} - Stato del sistema![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://ibm.biz/bluemixstatus){: new_window}. + + +### Sottoscrizione a un feed RSS +{: #subscribing-rss-feed} + +Puoi ricevere avvisi di eventuali notifiche sottoscrivendo il feed RSS per la pagina Stato di {{site.data.keyword.Bluemix_notm}}. In questo modo puoi ottenere gli aggiornamenti senza dover consultare regolarmente la pagina sullo stato. + +Per eseguire la sottoscrizione, completa la seguente procedura: + + 1. Scarica e installa un lettore RSS. + 2. Utilizza il tuo lettore per sottoscrivere il feed con uno dei seguenti +metodi: + * Trascina l'icona RSS ![RSS](images/rss.svg) nel tuo lettore RSS. + * Fai clic con il tasto destro del mouse sull'icona RSS, seleziona **Copia indirizzo link** e incolla l'URL +nel tuo lettore RSS. + + Per ulteriori informazioni, vedi la sezione **Guida** del +tuo lettore. + +Altri metodi di lettura dei feed RSS sono disponibili tramite plug-in del browser Web come: + * [RSS Feed ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://feeder.co/){: new_window} Reader for Chrome + * [Brief ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://addons.mozilla.org/en-US/firefox/addon/brief/){: new_window} add-on for Firefox + +Fonti di notizie, come i seguenti siti, forniscono anche dei metodi per la lettura dei feed RSS: + * [Feedly ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://www.feedly.com/){: new_window} + * [G2reader ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://www.g2reader.com/en/){: new_window} + +Puoi inoltre +utilizzare un servizio di terze parti per inviare automaticamente un'e-mail +per ogni aggiornamento RSS. Il seguente elenco riporta alcuni esempi di servizi di terze parti: + + * www.feedmyinbox.com + * www.rssforward.com + * www.feedrabbit.com + * www.mailchimp.com + * www.feedmailer.com + * www.iftt.com + +{{site.data.keyword.Bluemix_notm}} solitamente +ha circa 50 aggiornamenti al mese. + + + +### Configurazione di notifiche e-mail per incidenti e manutenzione +{: #setting-up-notifications} + +Per {{site.data.keyword.Bluemix_notm}} pubblico, puoi registrarti per ricevere le notifiche della piattaforma. Le notifiche della piattaforma sono avvisi e-mail facoltativi per eventi di incidenti e manutenzione relativi alla piattaforma {{site.data.keyword.Bluemix_notm}}. Puoi scegliere di ricevere queste notifiche e-mail facendo clic sulle opzioni della voce di menu **Account** > **Notifiche** > **Piattaforma**. Per ulteriori informazioni sull'impostazione delle notifiche di account, vai a [Impostazione delle notifiche](/docs/admin/account.html#notifications). + + +### Procedure consigliate per il monitoraggio dello stato +{: #best-practices} + + * Controlla le prossime finestre di manutenzione + + Controlla le prossime finestre di manutenzione pubblicate nella pagina dello stato, +almeno una volta ogni 24 ore, utilizzando una delle seguenti opzioni:: + * Andando direttamente alla pagina [Stato ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://ibm.biz/bluemixstatus){: new_window} + * Utilizzando il feed RSS o un'utilità di inoltro da RSS a email + + * Controlla le finestre di manutenzione correnti o un evento imprevisto in corso + + Se hai il sospetto che {{site.data.keyword.Bluemix_notm}} non +funzioni nel modo previsto, consulta la pagina dello stato per controllare le finestre di manutenzione correnti o +un evento imprevisto in corso. Per segnalare un evento imprevisto non ancora elencato nella pagina dello stato, apri un ticket di supporto tramite la voce di **Supporto** nella barra dei menu o la pagina di assistenza [IBM Bluemix Support ![icona link esterno](../icons/launch-glyph.svg "External link icon")](ibm.biz/bluemixsupport){: new_window}. + + * Usufruisci di più regioni {{site.data.keyword.Bluemix_notm}} + + Tutti gli utenti di {{site.data.keyword.Bluemix_notm}} pubblico hanno automaticamente accesso alle regioni US-SOUTH, EU-GB e AU-SYD: + + * US-SOUTH: https://console.ng.bluemix.net + * EU-GB: https://console.eu-gb.bluemix.net + * AU-SYD: https://console.au-syd.bluemix.net + + Il team di {{site.data.keyword.Bluemix_notm}} Global Operations gestisce tutte le regioni per evitare impatti sulla manutenzione e ridurre al minimo il rischio di eventi imprevisti che influiscano contemporaneamente su tutte le regioni. + + * Prepararsi a piccole interruzioni + + Nella maggior parte dei casi, si può continuare a utilizzare {{site.data.keyword.Bluemix_notm}} +normalmente, anche durante la finestra di manutenzione. Tuttavia, non è sempre possibile evitare delle brevi interruzioni di servizio. In genere, le applicazioni in esecuzione rimangono disponibili anche se le funzioni +di gestione applicazione di {{site.data.keyword.Bluemix_notm}}, +come l'avvio o l'arresto di applicazioni, vengono temporaneamente interrotte. Per +massimizzare la disponibilità delle tue applicazioni in esecuzione, esegui almeno +tre istanze di ciascuna applicazione. + + + +## Come contattare il supporto +{: #contacting-support} + +Se disponi di un account {{site.data.keyword.Bluemix_notm}} valido, puoi aprire ticket di supporto utilizzando una serie di opzioni. [Apertura di un ticket di supporto](#open-ticket). + +Se hai un account {{site.data.keyword.Bluemix_notm}} collegato a un account {{site.data.keyword.BluSoftlayer_full}}, puoi aprire ticket di supporto per {{site.data.keyword.Bluemix_notm}} dal portale del cliente {{site.data.keyword.BluSoftlayer}} o dalla console {{site.data.keyword.Bluemix_notm}} utilizzando il widget Supporto. Vedi [Apertura di un ticket di supporto per i link collegati](#open-ticket-linked). + +### Come contattare il supporto per {{site.data.keyword.Bluemix_notm}} pubblico +{: #contacting-bluemix-support} + +A tutti i clienti di {{site.data.keyword.Bluemix_notm}} viene fornito supporto tecnico gratuito tramite la community {{site.data.keyword.Bluemix_notm}} o Stack Overflow. Inoltre, vengono forniti diversi tipi di supporto per soddisfare i bisogni di diversi clienti. Fai riferimento alla seguente tabella per scegliere tra i livelli di supporto gratuito, di base, standard e premium. + +Livelli | Gratuito | Di base | Standard | Premium +--- | --- | --- | --- | --- | +Descrizione | Supporto per tutti i clienti in prova di {{site.data.keyword.Bluemix_notm}}. | Supporto per gli ambienti di non produzione o per i carichi di lavoro per cui le severità e i tempi di risposta tradizionali non sono necessari. | Supporto per gli ambienti con un numero limitato di applicazioni critiche di business. I clienti {{site.data.keyword.Bluemix_notm}} dedicato e {{site.data.keyword.Bluemix_notm}} locale ricevono il supporto standard. | Supporto per gli ambienti di importanza critica che hanno una dipendenza strategica da {{site.data.keyword.Bluemix_notm}}. +Supporto severità 1-4 | N/D | N/D | Incluso | Include +il supporto lingua | Inglese | Inglese | Inglese, Giapponese | CSM (client success manager) +assegnato Inglese, Giapponese | Non incluso | Non incluso | Non incluso | Incluso per
      8 ore a settimana +{: caption="Table 1. Support levels" caption-side="top"} + +**Importante:** il supporto in lingua giapponese è disponibile per i ticket con severità 2-4 dal lunedì al venerdì dalle ore 9:00 a.m. alle ore 5:00 p.m. JST, escluse le festività nazionali o ufficiali. I servizi della community e di terze parti sono esclusi. I ticket con severità 1 sono trattati solo in inglese. + +### Apertura di un ticket di supporto +{: #open-ticket} + +Se non sei riuscito a risolvere il tuo problema tecnico con le opzioni di risoluzione dei problemi e di guida, puoi richiedere assistenza. Tuttavia, prima di contattare il supporto per un problema tecnico, accertati che non sia dovuto a un'interruzione del servizio, controllando lo stato di [{{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://ibm.biz/bluemixstatus){: new_window}. + + + +Se il problema non è dovuto a un'interruzione, apri un ticket di supporto attraverso una delle seguenti opzioni: + + * Dal menu Supporto, fai clic su **Aggiungi ticket**. Nella pagina che viene visualizzata, compila il modulo per indicare il tipo di supporto tecnico di cui hai bisogno. + * Utilizza la pagina di assistenza [IBM {{site.data.keyword.Bluemix_notm}} Support ![icona link esterno](../icons/launch-glyph.svg "External link icon")](ibm.biz/bluemixsupport){: new_window}. Puoi inoltrare ticket per problemi relativi a vendite, fatturazione, ID IBM e accesso e supporto tecnico. Per questi ultimi, una volta fatto clic su **Supporto tecnico** puoi selezionare un gruppo tecnico. Ad esempio, se hai bisogno di assistenza per le applicazioni Cloud Foundry, {{site.data.keyword.openwhisk_short}}, Containers, Virtual Servers o per i server Bare Metal, puoi selezionare **Servizi dell'applicazione**. Se hai bisogno di aiuto per un servizio specifico, seleziona la categoria di servizi corrispondente. Per determinare la categoria di appartenenza del tuo servizio, consulta le categorie riportate in [Servizi](/docs/services/index.html) nel riquadro di navigazione. + +Quando apri un ticket di supporto, accertati di indicare una gravità appropriata per il tuo ticket. Quest'ultima determina il modo in cui il tuo ticket viene gestito. Per informazioni sui diversi livelli di severità, vedi [Severità e tempo di risposta del ticket di supporto](/docs/support/index.html#support-ticket-severity). Se la tua domanda di supporto richiede una risposta più immediata, ti raccomandiamo di eseguire l'aggiornamento ai nostri livelli di supporto Standard o Premium in modo che puoi aumentare la severità dei ticket di supporto da 1 a 4. Per eseguire l'upgrade a un livello di supporto superiore, contatta il tuo [rappresentante delle vendite IBM![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://www.ibm.com/cloud-computing/bluemix/contact-us){: new_window} o inviaci una e-email all'indirizzo sales@bluemix.net. + +### Apertura di un ticket di supporto per i link collegati +{: #open-ticket-linked} + +Se stai utilizzando un account che è collegato tra {{site.data.keyword.Bluemix_notm}} e {{site.data.keyword.BluSoftlayer}}, puoi aprire un ticket di supporto dalla console {{site.data.keyword.Bluemix_notm}} utilizzando il widget Supporto. + +Per aprire un ticket di supporto {{site.data.keyword.Bluemix_notm}} per un account collegato, fai clic su **Supporto** dalla barra dei menu per aprire il widget Supporto e seleziona **Aggiungi ticket**. Nel modulo del ticket, seleziona **Tecnico** per il tipo di ticket e compila il modulo per indicare per cosa hai bisogno di supporto tecnico. Se disponi di un supporto di livello Premium, scegli il livello di gravità per il tuo problema. In pochi minuti riceverai una notifica e-mail per il ticket. Segui le istruzioni nell'e-mail per ulteriori comunicazioni sul problema. + + +### Controllo dello stato del ticket di supporto +{: #check-ticket-status} + +Tutti i problemi di supporto per il client vengono documentati in un ticket di supporto. A ogni ticket di supporto viene assegnato un numero di riferimento ticket univoco e un livello di severità in base ai dettagli nella descrizione del ticket. Puoi utilizzare il numero di ticket per vedere lo stato di avanzamento del tuo ticket di supporto e per aggiornare il ticket. Dal menu Supporto, seleziona **Visualizza ticket**. Gli aggiornamenti e le risposte ti vengono inviati per email e registrati nelle note del ticket. + + + + +### Come contattare il supporto per {{site.data.keyword.Bluemix_notm}} dedicato +{: #contacting-bluemix-support-dedicated} + + + +Se sei un cliente di {{site.data.keyword.Bluemix_notm}} dedicato, il supporto viene fornito dal team di IBM {{site.data.keyword.Bluemix_notm}} Support. A seconda che tu disponga di un {{site.data.keyword.ibmid}} puoi scegliere tra diverse opzioni per ottenere assistenza. + +
        +
      • Contatta il supporto aprendo un nuovo ticket mediante la pagina +di assistenza IBM {{site.data.keyword.Bluemix_notm}} Support. Per questo modulo puoi utilizzare un indirizzo e-mail o il tuo {{site.data.keyword.ibmid}}. Seleziona l'opzione **{{site.data.keyword.Bluemix_notm}} dedicato** per il campo regione. +

        Gli invii dei moduli vengono monitorati dalla domenica alle ore 21:30 UTC fino al venerdì alle ore 23:59 UTC. Per assistenza nella conversione di queste ore di supporto al tuo fuso orario locale, vedi [Timeanddate.com ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://www.timeanddate.com).

        +
        • +
      • Se disponi di un {{site.data.keyword.ibmid}} e dell'accesso all'ambiente {{site.data.keyword.Bluemix_notm}} pubblico, nella barra dei menu fai clic su **Supporto** > **Aggiungi ticket**. Seleziona l'area tematica per il tuo problema e segui le indicazioni per inviare il ticket.
        • +
      • Se non disponi di un {{site.data.keyword.ibmid}}, puoi contattare un membro della tua organizzazione che ne abbia uno o collaborare con il tuo rappresentante IBM. +

        **Nota**: su richiesta, è disponibile un elenco di utenti dell'organizzazione che possono fungere da contatti per i ticket di supporto e che può essere visualizzato nella pagina **Supporto** della console {{site.data.keyword.Bluemix_notm}} nel tuo ambiente Dedicato.

        • +
      + +### Come contattare il supporto per {{site.data.keyword.Bluemix_notm}} locale +{: #contacting-bluemix-support-local} + + + +Se sei un cliente di {{site.data.keyword.Bluemix_notm}} locale, l'assistenza viene fornita dal team di supporto {{site.data.keyword.Bluemix_notm}} IBM. Tuttavia, poiché potresti non disporre di un {{site.data.keyword.ibmid}}, hai alcune opzioni diverse per ottenere assistenza. + +
        +
      • Contatta il supporto aprendo un nuovo ticket mediante la pagina +di assistenza IBM {{site.data.keyword.Bluemix_notm}} Support icona link eserno. Per questo modulo puoi utilizzare un indirizzo e-mail o il tuo {{site.data.keyword.ibmid}}. Seleziona l'opzione **{{site.data.keyword.Bluemix_notm}} locale** per il campo regione. +

        Gli invii dei moduli vengono monitorati dalla domenica alle ore 21:30 UTC fino al venerdì alle ore 23:59 UTC. Per assistenza nella conversione di queste ore di supporto al tuo fuso orario locale, vedi [Timeanddate.com ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://www.timeanddate.com).

        +
        • +
      • Se disponi di un {{site.data.keyword.ibmid}} e dell'accesso all'ambiente {{site.data.keyword.Bluemix_notm}} pubblico, nella barra dei menu fai clic su **Supporto** > **Aggiungi ticket**. Seleziona l'area tematica per il tuo problema e segui le indicazioni per inviare il ticket.
        • +
      • Se non disponi di un {{site.data.keyword.ibmid}}, puoi contattare un membro della tua organizzazione che ne abbia uno o collaborare con il tuo rappresentante IBM. +

        **Nota**: su richiesta, è disponibile un elenco di utenti dell'organizzazione che possono fungere da contatti per i ticket di supporto e che può essere visualizzato nella pagina **Supporto** della console {{site.data.keyword.Bluemix_notm}} nel tuo ambiente Locale.

        • +
      + +### Gravità e tempo di risposta del ticket di supporto +{: #support-ticket-severity} + +Quando contatti il supporto, puoi richiedere un determinato livello di severità, a seconda del tipo e dell'urgenza del problema. Il livello di severità può incidere sulla rapidità con cui viene affrontato il tuo problema. + +La seguente tabella elenca alcuni esempi comuni di problemi di supporto, di livelli di gravità suggeriti e di obiettivi del tempo di risposta. Gli obiettivi del tempo di risposta vengono utilizzati solo per descrivere gli obiettivi di IBM e non rappresentano una garanzia sulle prestazioni. + +**Orario di operatività:** dalla domenica alle 21:30 UTC al venerdì alle 23:59 UTC (escluse festività di Stati Uniti/Italia/Australia). Per assistenza nella conversione di queste ore di supporto al tuo fuso orario locale, vedi [Timeanddate.com ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://www.timeanddate.com). Per ulteriori informazioni sulla pianificazione delle festività, vedi [Bluemix Support Holidays ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://ibm.biz/bluemixholidays). + + +Severità | Definizione di gravità | Obiettivi del tempo di risposta | Copertura del tempo di risposta +------|-------- | --- | --- | +Severità 1 | Impatto sul business critico o il servizio non funziona.
      La funzionalità critica di business non è utilizzabile o un'interfaccia critica ha avuto un malfunzionamento. Questa gravità normalmente si applica all'ambiente di produzione e indica l'impossibilità ad accedere ai servizi ed è segno di un impatto critico sulle operazioni. Questa condizione richiede una soluzione immediata. |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: in 1 ora
      • Premium: in 1 ora
      |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: 24x7
      • Premium: 24x7
      +Severità 2 | Impatto sul business significativo.
      L'utilizzo di una funzione o funzionalità è severamente limitato o sei a rischio di saltare delle scadenze di business. |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: in 2 ore
      • Premium: in 90 minuti
      |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: Orario di operatività
      • Premium: Orario di operatività
      +Severità 3 | Impatto sul business minore.
      Una funzione o funzionalità è utilizzabile ma riscontra dei problemi che ne influenzano l'utilizzo. Non viene causato alcun impatto critico sulle operazioni. |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: in 4 ore
      • Premium: in 2 ore
      |
      • Gratuito: N/D
      • Di base: N/D
      • Standard: Orario di operatività
      • Premium: Orario di operatività
      +Severità 4 | Impatto sul business minimo.
      Una domanda o una richiesta non tecnica. |
      • Gratuito: Massimo impegno
      • Di base: Massimo impegno
      • Standard: in 8 ore
      • Premium: in 4 ore
      |
      • Gratuito: Orario di operatività
      • Di base: Orario di operatività
      • Standard: Orario di operatività
      • Premium: Orario di operatività
      +{: caption="Table 2. Severity definition and response time" caption-side="top"} + + +### Modalità di supporto per i diversi servizi +Puoi definire la severità del problema in base alle tue esigenze di business e al tuo livello di supporto. Tutti i ticket vengono esaminati con lo scopo di identificare e risolvere la causa principale. Se sono richiesti i dati diagnostici del problema per determinarne la causa principale, ti verrà chiesta l'approvazione per accedere ai file di log e ad altri dati per la determinazione del problema dalla tua applicazione. Senza questi dati, la risoluzione del problema potrebbe richiedere più tempo. Una volta completata l'analisi della causa principale, il team effettuerà una delle seguenti operazioni: +* Servizio generalmente disponibile IBM o immagine contenitore
      +Se l'analisi della causa principale stabilisce che il problema è un difetto nel servizio generalmente disponibile IBM o nell'immagine del contenitore, il ticket viene indirizzato in base alla severità che hai assegnato. +* Servizio Beta IBM o immagine contenitore
      +IBM rilascerà i servizi o le immagini del contenitore classificati come una release Beta. Una release Beta aiuta i team di sviluppo e di marketing IBM a valutare la qualità del servizio nel mercato. Di conseguenza, possono apportare modifiche prima di rilasciarla come servizio generalmente disponibile o immagine del contenitore. Se l'analisi della causa principale stabilisce che il problema è un difetto nel servizio Beta IBM o nell'immagine del contenitore, IBM non è tenuto a fornire una correzione. Inoltre, al ticket viene assegnata una severità 3 o 4 a seconda del caso. +* Servizio sperimentale IBM o immagine contenitore
      +IBM rilascerà i servizi o le immagini del contenitore classificati come sperimentali. Questi servizi potrebbero essere instabili, cambiare frequentemente e potrebbero essere sospesi con breve preavviso. Per i servizi classificati come sperimentali, puoi ottenere l'assistenza della community solo attraverso [Stack Overflow ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://stackoverflow.com/questions/tagged/ibm-bluemix){: new_window} e [dW Answers ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/answers/smart-spaces/12/bluemix.html){: new_window}. +* Servizio di terze parti
      +I servizi di terze parti sono offerti dai fornitori esterni a IBM. Questi servizi sono forniti da singole entità software, partner o fornitori software indipendenti (ISV). Se l'analisi della causa principale stabilisce che il problema è un difetto in un servizio di terze parti, IBM non è tenuto a fornire una correzione. Tuttavia, IBM collaborerà attraverso il nostro Marketplace con il servizio di terze parti e con il nostro cliente per risolvere il problema. +* Servizio open source o della community
      +I servizi open source o della community sono forniti dalle community open source esterne a IBM. Se l'analisi della causa principale stabilisce che il problema è un difetto in un servizio open source o della community, IBM non è tenuto a fornire una correzione. IBM chiuderà il ticket e ti rimanderà alla community o al forum per assistenza. + + +### Notifica di una vulnerabilità di sicurezza potenziale +{: #report-security-vulnerability} + +Se credi si sia verificata una vulnerabilità di sicurezza potenziale, notificalo a Bluemix aprendo un ticket di supporto. + +Per notificare una vulnerabilità di sicurezza potenziale, completa la seguente procedura: + 1. Apri un ticket di severità 1 o un ticket di un alto livello di severità consentito dal tuo supporto. Per informazioni su come aprire un ticket, vedi [Apertura di un ticket di supporto![icona link esterno](../icons/launch-glyph.svg "External link icon")](#open-ticket){: new_window}. + 2. Descrivi chiaramente nel riepilogo del ticket che riguarda una vulnerabilità di sicurezza potenziale. + 2. Fornisci i dettagli della vulnerabilità di sicurezza potenziale includendo una delle seguenti voci: + * Un numero di telefono in cui puoi essere raggiunto per discutere del problema. + * I dettagli del problema. Devi crittografare i dettagli come un blocco di testo nel corpo del ticket e fornire le istruzioni su come il supporto IBM può contattarti in sicurezza per ottenere le istruzioni di decrittografia. + + + +### Escalation di un ticket di supporto +{: #escalation} + +Con un supporto standard o premium, se non hai ricevuto una risposta tempestiva a un ticket di supporto o ritieni che il ticket non venga affrontato in maniera appropriata, puoi effettuarne l'escalation. Attraverso il processo di escalation del ticket di supporto, IBM prende in considerazione le tue preoccupazioni e collabora con te per migliorare la tua esperienza di supporto. + +Per inoltrare una richiesta di escalation, completa la seguente procedura: + 1. Apri un nuovo ticket di supporto con riepilogo **Richiesta di escalation**. + 2. Per accertarti che venga trovata una corrispondenza tra la tua richiesta di escalation e il ticket di supporto originale, includi le seguenti informazioni nel corpo del ticket: + * Il numero del tuo ticket di supporto aperto, che necessita di un'escalation. + * Un breve riepilogo dei motivi per cui occorre un'escalation. + + + +## Raccolta delle informazioni di diagnostica +{: #collecting-diagnostic-information} +Per diagnosticare e risolvere i problemi con le applicazioni e i servizi {{site.data.keyword.Bluemix_notm}}, +il team di supporto {{site.data.keyword.Bluemix_notm}} +potrebbe chiederti di raccogliere informazioni di diagnostica. + +Prima di raccogliere le informazioni di diagnostica, completa la +seguente procedura: + + 1. Assicurati di aver installato l'interfaccia riga di comando cf più recente. Per ulteriori informazioni, vedi [Installing the cf +command line interface](/docs/starters/install_cli.html). + + **Nota:** se non hai installato l'interfaccia riga di comando cf più recente, dopo aver connesso la riga di comando cf a {{site.data.keyword.Bluemix_notm}}, il comando `cf logs` potrebbe non restituire alcun input. + + 2. Assicurati di aver connesso l'interfaccia riga di comando cf alla posizione in cui {{site.data.keyword.Bluemix_notm}} è +in esecuzione utilizzando il comando `cf api`. + + 3. Assicurati di soddisfare tutti i prerequisiti in [Prerequisiti di {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/bluemix/support/#prereqs){: new_window}. + +Utilizza i seguenti script per raccogliere le informazioni di diagnostica: + + * Per i sistemi operativi Windows, scarica il file [bmdiag-general.bat ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://bluemix-mustgather.mybluemix.net/mustgather/general/bmdiag-general.bat){: new_window} ed eseguilo. + * Per i sistemi operativi Linux e Mac, scarica il file [bmdiag-general.sh ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://bluemix-mustgather.mybluemix.net/mustgather/general/bmdiag-general.sh){: new_window} ed eseguilo. + +Gli script utilizzano l'interfaccia riga di comando cf per estrarre +le seguenti informazioni dal tuo ambiente applicativo: + + * Log dell'applicazione + * Metadati dell'applicazione + * Rotte configurate + * Eventi + * Servizi con provisioning + + +## Supporto di lingua nazionale per {{site.data.keyword.Bluemix_notm}} +{: #lang} + +{{site.data.keyword.Bluemix_notm}} supporta +lingue nazionali diverse dall'inglese. Tuttavia, non tutto il contenuto fornito con {{site.data.keyword.Bluemix_notm}} +è tradotto. +La seguente tabella elenca le lingue nazionali supportate e i codici lingua per {{site.data.keyword.Bluemix_notm}}. + +| **Lingua nazionale** | **Codice lingua** | +|-------------------|---------------| +| Portoghese (Brasile) | pt_BR | +| Inglese | en | +| Francese | fr | +| Tedesco | de | +| Giapponese | ja | +| Coreano | ko | +| Italiano | it | +| Spagnolo | es | +| Cinese semplificato | zh_CN | +| Cinese tradizionale | zh_TW | +{: caption="Table 3. Supported national languages and language codes" caption-side="top"} + + + +## Sondaggio sulla soddisfazione per il supporto {{site.data.keyword.Bluemix_notm}} +{: #survey} + +IBM invia periodicamente i sondaggi ai clienti {{site.data.keyword.Bluemix_notm}} per ottenere i loro feedback sulle recenti esperienze con il supporto clienti. Il sondaggio si concentra sulla qualità del supporto e sull'esperienza complessiva. La gestione di IBM rivede i risultati del sondaggio per migliorare l'esperienza di supporto. + + +# rellinks +{: #rellinks} + +## general +{: #general} + + * [Bluemix support portal ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://support.ibmcloud.com){: new_window} + * [dW Answers ![icona link esterno](../icons/launch-glyph.svg "External link icon")](https://developer.ibm.com/answers/smart-spaces/12/bluemix.html){: new_window} + * [Installazione dello strumento di comando cf](/docs/starters/install_cli.html) + * [Stack Overflow ![icona link esterno](../icons/launch-glyph.svg "External link icon")](http://stackoverflow.com/questions/tagged/ibm-bluemix){: new_window} + diff --git a/toolchains/nl/de/toolchains_about.md b/toolchains/nl/de/toolchains_about.md index 965974582..efc35c0d9 100644 --- a/toolchains/nl/de/toolchains_about.md +++ b/toolchains/nl/de/toolchains_about.md @@ -1,42 +1,42 @@ ---- - -Copyright: - Jahre: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# Informationen zu Toolchains -{: #toolchains_about} - -Letzte Aktualisierung: 13. September 2016 -{: .last-updated} - -Eine *Toolchain* ist eine Gruppe von Toolintegrationen, die Entwicklungs-, Bereitstellungs- und Systemtasks unterstützen. Die kollektive Leistung einer Toolchain ist höher als die Summe der zugehörigen einzelnen Toolintegrationen. -{:shortdesc} - -Toolchains stehen in öffentlichen und dedizierten {{site.data.keyword.Bluemix}}-Umgebungen zur Verfügung. Sie können eine Toolchain auf zwei Arten erstellen: Entweder Sie verwenden eine Vorlage zum Erstellen einer Toolchain oder Sie erstellen eine Toolchain aus einer App. Als Ausgangspunkt können Sie eine Toolchain-Vorlage verwenden. Abhängig von der verwendeten Vorlage können Sie eine Toolchain erstellen, die eine bestimmte Gruppe von Toolintegrationen enthält, oder eine leere Toolchain, zu der Sie Toolintegrationen hinzufügen können. - -Abhängig von der verwendeten Vorlage oder Toolchain umfasst die Toolchain in der öffentlichen {{site.data.keyword.Bluemix_notm}}-Umgebung (Bluemix Public) unter Umständen ein GitHub-Repository, in dem ein App-Starter-Code und eine vorkonfigurierte Delivery Pipeline angegeben wird. Wenn Sie Änderungen per Push-Operation an das GitHub-Repository der Toolchain übertragen, erstellt die Delivery Pipeline automatisch Builds und stellt die App in {{site.data.keyword.Bluemix_notm}} bereit. - -Abhängig von der verwendeten Toolchain umfasst die Toolchain in der dedizierten {{site.data.keyword.Bluemix_notm}}-Umgebung (Bluemix Dedicated) unter Umständen ein GitHub-Repository, in dem ein App-Starter-Code und eine vorkonfigurierte Delivery Pipeline angegeben wird. Wenn Sie Änderungen per Push-Operation an das GitHub Enterprise-Repository der Toolchain übertragen, erstellt die Delivery Pipeline automatisch Builds und stellt die Apps in {{site.data.keyword.Bluemix_notm}} bereit. - -## Hilfe und Unterstützung für Toolchains anfordern -{: #gettinghelp} - -Wenn Probleme auftreten oder Sie Fragen zur Verwendung von Toolchains haben, können Sie Hilfe anfordern, indem Sie nach Informationen suchen oder indem Sie Ihre Fragen in einem Forum stellen. Sie haben außerdem die Möglichkeit, ein Support-Ticket zu öffnen. - -Wenn Sie die Foren verwenden, um eine Frage zu stellen, taggen Sie Ihre Frage, sodass die {{site.data.keyword.Bluemix_notm}}-Entwicklerteams auf sie aufmerksam wird. - -* Wenn Sie technische Fragen zur Entwicklung oder Bereitstellung einer App mit Toolchains haben, posten Sie Ihre Frage unter [Stack Overflow (Link wird in neuem Fenster geöffnet)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} und taggen Sie Ihre Frage mit "ibm-bluemix" und "devops". - -* Verwenden Sie für Fragen zu Toolchains und zu ersten Schritten das Forum [IBM developerWorks dW Answers (Link wird in neuem Fenster geöffnet)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}. Taggen Sie Ihre Frage mit "devops-services" und "bluemix". - -Unter [Hilfe anfordern (Link wird in neuem Fenster geöffnet)](https://www.{DomainName}/docs/support/index.html#getting-help) finden Sie weitere Informationen zur Verwendung der Foren. - -Informationen zum Öffnen eines IBM Support-Tickets oder zu Support-Levels und Ticketprioritäten finden Sie unter [Unterstützung anfordern (Link wird in neuem Fenster geöffnet)](https://www.{DomainName}/docs/support/index.html#contacting-support). +--- + +Copyright: + Jahre: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# Informationen zu Toolchains +{: #toolchains_about} + +Letzte Aktualisierung: 13. September 2016 +{: .last-updated} + +Eine *Toolchain* ist eine Gruppe von Toolintegrationen, die Entwicklungs-, Bereitstellungs- und Systemtasks unterstützen. Die kollektive Leistung einer Toolchain ist höher als die Summe der zugehörigen einzelnen Toolintegrationen. +{:shortdesc} + +Toolchains stehen in öffentlichen und dedizierten {{site.data.keyword.Bluemix}}-Umgebungen zur Verfügung. Sie können eine Toolchain auf zwei Arten erstellen: Entweder Sie verwenden eine Vorlage zum Erstellen einer Toolchain oder Sie erstellen eine Toolchain aus einer App. Als Ausgangspunkt können Sie eine Toolchain-Vorlage verwenden. Abhängig von der verwendeten Vorlage können Sie eine Toolchain erstellen, die eine bestimmte Gruppe von Toolintegrationen enthält, oder eine leere Toolchain, zu der Sie Toolintegrationen hinzufügen können. + +Abhängig von der verwendeten Vorlage oder Toolchain umfasst die Toolchain in der öffentlichen {{site.data.keyword.Bluemix_notm}}-Umgebung (Bluemix Public) unter Umständen ein GitHub-Repository, in dem ein App-Starter-Code und eine vorkonfigurierte Delivery Pipeline angegeben wird. Wenn Sie Änderungen per Push-Operation an das GitHub-Repository der Toolchain übertragen, erstellt die Delivery Pipeline automatisch Builds und stellt die App in {{site.data.keyword.Bluemix_notm}} bereit. + +Abhängig von der verwendeten Toolchain umfasst die Toolchain in der dedizierten {{site.data.keyword.Bluemix_notm}}-Umgebung (Bluemix Dedicated) unter Umständen ein GitHub-Repository, in dem ein App-Starter-Code und eine vorkonfigurierte Delivery Pipeline angegeben wird. Wenn Sie Änderungen per Push-Operation an das GitHub Enterprise-Repository der Toolchain übertragen, erstellt die Delivery Pipeline automatisch Builds und stellt die Apps in {{site.data.keyword.Bluemix_notm}} bereit. + +## Hilfe und Unterstützung für Toolchains anfordern +{: #gettinghelp} + +Wenn Probleme auftreten oder Sie Fragen zur Verwendung von Toolchains haben, können Sie Hilfe anfordern, indem Sie nach Informationen suchen oder indem Sie Ihre Fragen in einem Forum stellen. Sie haben außerdem die Möglichkeit, ein Support-Ticket zu öffnen. + +Wenn Sie die Foren verwenden, um eine Frage zu stellen, taggen Sie Ihre Frage, sodass die {{site.data.keyword.Bluemix_notm}}-Entwicklerteams auf sie aufmerksam wird. + +* Wenn Sie technische Fragen zur Entwicklung oder Bereitstellung einer App mit Toolchains haben, posten Sie Ihre Frage unter [Stack Overflow (Link wird in neuem Fenster geöffnet)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} und taggen Sie Ihre Frage mit "ibm-bluemix" und "devops". + +* Verwenden Sie für Fragen zu Toolchains und zu ersten Schritten das Forum [IBM developerWorks dW Answers (Link wird in neuem Fenster geöffnet)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}. Taggen Sie Ihre Frage mit "devops-services" und "bluemix". + +Unter [Hilfe anfordern (Link wird in neuem Fenster geöffnet)](https://www.{DomainName}/docs/support/index.html#getting-help) finden Sie weitere Informationen zur Verwendung der Foren. + +Informationen zum Öffnen eines IBM Support-Tickets oder zu Support-Levels und Ticketprioritäten finden Sie unter [Unterstützung anfordern (Link wird in neuem Fenster geöffnet)](https://www.{DomainName}/docs/support/index.html#contacting-support). diff --git a/toolchains/nl/de/toolchains_integrations.md b/toolchains/nl/de/toolchains_integrations.md index 1b95f97b3..14190bdf5 100644 --- a/toolchains/nl/de/toolchains_integrations.md +++ b/toolchains/nl/de/toolchains_integrations.md @@ -1,306 +1,306 @@ ---- - -Copyright: - Jahre: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Toolintegrationen konfigurieren -{: #integrations} - -Letzte Aktualisierung: 18. Oktober 2016 -{: .last-updated} - -Sie können Toolintegrationen konfigurieren, die Entwicklungs-, Bereitstellungs- und Systemtasks unterstützen, während Sie eine Toolchain erstellen, oder Sie können Toolintegrationen hinzufügen und konfigurieren, um eine vorhandene Toolchain anzupassen. -{:shortdesc} - -**Wichtig**: Unter {{site.data.keyword.Bluemix_notm}} Public sind Toolchains nur in den USA (Süden) verfügbar. - -Die Toolintegrationen, die zum Hinzufügen und Konfigurieren für Ihre Toolchain zur Verfügung stehen, sind unterschiedlich, abhängig davon, ob Sie Toolchains unter {{site.data.keyword.Bluemix_notm}} Public oder {{site.data.keyword.Bluemix_notm}} Dedicated verwenden. Falls Sie Toolchains bei {{site.data.keyword.Bluemix_notm}} Dedicated verwenden, variieren die für Sie verfügbaren Toolintegrationen abhängig davon, wie {{site.data.keyword.jazzhub_title}} in Ihrer speziellen Umgebung konfiguriert wurde. - -*Tabelle 1. Toolintegrationen, die für Toolchains unter {{site.data.keyword.Bluemix_notm}} Public und Dedicated verfügbar sind* - -|Toolintegration |Verfügbar unter {{site.data.keyword.Bluemix_notm}} Public |Verfügbar unter {{site.data.keyword.Bluemix_notm}} Dedicated (umgebungsabhängig)| -|:----------|:------------------------------|:------------------| -|{{site.data.keyword.deliverypipeline}} |Ja |Ja | -|{{site.data.keyword.DRA_short}} |Ja |Nein | -|Eclipse Orion {{site.data.keyword.webide}} |Ja |Ja | -|GitHub |Ja |Ja | -|Dedicated GitHub Enterprise |Nein |Ja | -|Anderes Tool |Ja |Ja | -|PagerDuty |Ja |Ja | -|Sauce Labs |Ja |Nein | -|Slack |Ja |Ja | - -**Tipp**: Wenn Sie beginnen möchten, mit Ihrem eigenen Code unter {{site.data.keyword.Bluemix_notm}} Public zu entwickeln, müssen Sie die GitHub-Toolintegration konfigurieren, bevor Sie die {{site.data.keyword.deliverypipeline}} konfigurieren. Wenn Sie beginnen möchten, mit Ihrem eigenen Code unter {{site.data.keyword.Bluemix_notm}} Dedicated zu entwickeln, müssen Sie die {{site.data.keyword.ghe_short}}-Toolintegration oder die GitHub-Toolintegration vor der {{site.data.keyword.deliverypipeline}} konfigurieren. - - -## Delivery Pipeline konfigurieren -{: #deliverypipeline} - -Die {{site.data.keyword.deliverypipeline}} automatisiert die kontinuierliche Entwicklung Ihrer Projekte durch aufeinanderfolgende Stages, in denen Eingaben abgerufen und Jobs wie Builds, Tests und Bereitstellungen ausgeführt werden. - -Konfigurieren Sie die {{site.data.keyword.deliverypipeline}}, um das kontinuierliche Erstellen, Testen und Bereitstellen Ihrer Apps zu automatisieren: - -1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **Delivery Pipeline**. Abhängig von der Vorlage, die Sie verwenden, sind unterschiedliche Felder verfügbar. Überprüfen Sie die Standardfeldwerte und ändern Sie diese Einstellungen gegebenenfalls. -1. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Public eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite Ihrer App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Dedicated eine Toolchain verwenden, klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). -1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **Delivery Pipeline**. -1. Geben Sie einen Namen für Ihre neue Pipeline an. -1. Wenn Sie mithilfe Ihrer Pipeline eine Benutzerschnittstelle bereitstellen möchten, wählen Sie das Kontrollkästchen **Anzeigbare App** aus. Alle Apps, die Ihre Pipeline erstellt, werden in der Liste **APP ANZEIGEN** auf der Seite mit den Toolintegrationen der Toolchain angezeigt. -1. Klicken Sie auf **Integration erstellen**, um die {{site.data.keyword.deliverypipeline}} zu Ihrer Toolchain hinzuzufügen. -1. Klicken Sie auf die {{site.data.keyword.deliverypipeline}}-Kachel, um die Pipeline anzuzeigen und zu konfigurieren. Die Grundlagen des Konfigurierens einer Pipeline finden Sie unter [Pipelines erstellen und bereitstellen (Link wird in neuem Fenster geöffnet)](../services/DeliveryPipeline/build_deploy.html){: new_window}. - - **Tipp**: Falls Sie die Pipeline aktivieren möchten, wenn Sie Änderungen per Push-Operation an Ihr GitHub- oder {{site.data.keyword.ghe_short}}-Repository übertragen, müssen Sie GitHub oder {{site.data.keyword.ghe_short}} für Ihre Toolchain konfigurieren, bevor Sie die Stages für Ihre Pipeline definieren. Die Pipeline-Stages benötigen die Git-URLs für Ihre Repositorys. Jede Pipeline-Stage kann nur auf eines der GitHub- oder {{site.data.keyword.ghe_short}}-Repositorys verweisen, das Ihrer Toolchain zugeordnet ist. Anweisungen zum Konfigurieren von GitHub finden Sie im Abschnitt [GitHub](#github). Anweisungen zum Konfigurieren von Dedicated GitHub Enterprise finden Sie unter [Einführung in {{site.data.keyword.ghe_long}} (Link wird in neuem Fenster geöffnet)](../services/ghededicated/index.html){: new_window}. - -1. Optional: Wenn Sie eine Toolchain unter {{site.data.keyword.Bluemix_notm}} Public verwenden und Sie möchten, dass Sauce Labs Ihre App testet, konfigurieren Sie die {{site.data.keyword.deliverypipeline}}, um einen Sauce Labs-Testjob hinzuzufügen. Anweisungen zum Konfigurieren des Testjobs finden Sie im Abschnitt [Sauce Labs-Testjob in Ihrer Pipeline konfigurieren](#config_saucelabs). - -### Sauce Labs-Testjob in Ihrer Pipeline konfigurieren -{: #config_saucelabs} - -Bevor Sie einen Sauce Labs-Testjob in Ihrer Pipeline konfigurieren, brauchen Sie eine funktionstüchtige Pipeline, die Stages zum Erstellen und Bereitstellen Ihrer App umfasst, und Sie müssen Sauce Labs für Ihre Toolchain konfigurieren. Anweisungen zum Konfigurieren von Sauce Labs finden Sie im Abschnitt [Sauce Labs](#saucelabs). - -Konfigurieren Sie die {{site.data.keyword.deliverypipeline}}, um einen Sauce Labs-Testjob hinzuzufügen: - -1. Wenn keine Stage vorhanden ist, die eine Testversion Ihrer App bereitstellt, erstellen Sie eine. -1. Fügen Sie in der Stage einen Testjob nach dem Bereitstellungsjob hinzu. Indem Sie diese Jobs in derselben Stage platzieren, können sie auf dieselbe Gruppe von Umgebungseigenschaften zugreifen. - ![Testjob](images/toolchain_test_job.png) - -1. Konfigurieren Sie die Stage: - - a. Erstellen Sie auf der Registerkarte **UMGEBUNGSEIGENSCHAFTEN** drei Eigenschaften: CF_APP_NAME, SAUCE_USERNAME und SAUCE_ACCESS_KEY. - - b. Geben Sie Ihren Sauce Labs-Benutzernamen und -Zugriffsschlüssel ein. Dadurch stellen Sie diese Werte extern bereit und können sie in Ihren Tests verwenden. - -1. Konfigurieren Sie den Bereitstellungsjob. Schließen Sie im Feld **Bereitstellungsscript** diesen Befehl ein: `export CF_APP_NAME="$CF_APP"`. Der Befehl exportiert den Namen der App als Umgebungseigenschaft. -1. Konfigurieren Sie den Testjob. Die Werte in der folgenden Abbildung sind Beispiele. In die Felder **Serviceinstanz**, **Ziel**, **Organisation** und **Bereich** werden der Sauce Labs-Benutzername, die Region, die Organisation und der Bereich eingetragen, die Sie verwenden. -![Job konfigurieren](images/toolchain_configure_job.png) - - Wählen Sie als Testertyp **Sauce Labs** aus. - - b. Wählen Sie als Serviceinstanz den Sauce Labs-Benutzernamen aus, den Sie beim Konfigurieren von Sauce Labs für Ihre Toolchain verwendet haben. - - **Tipp**: Um zu sehen, welchen Benutzernamen und Zugriffsschlüssel Sie beim Konfigurieren von Sauce Labs für Ihre Toolchain verwendet haben, klicken Sie auf **Konfigurieren**. - - c. Geben Sie im Feld **Befehl für die Testausführung** die Befehle ein, die die für Ihre Tests erforderlichen Abhängigkeiten installieren, und führen Sie dann die Tests aus. Für eine Node.js-App würden Sie beispielsweise folgende Befehle eingeben: - ``` - npm install - node_modules/grunt-cli/bin/grunt test:sauce:parallel - ``` - - d. Wenn Sie Ihre Testberichte in den Testjobprotokollen anzeigen möchten, wählen Sie das Kontrollkästchen **Testbericht aktivieren** aus und legen Sie Dateimuster für Testergebnisse auf `test/*.xml` fest. - -1. Klicken Sie auf **SPEICHERN**. Immer, wenn Ihre Pipeline aktiv ist, werden Sauce Labs-Tests ausgeführt. - -Weitere Informationen finden Sie unter [Delivery Pipeline (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}. - - -## {{site.data.keyword.DRA_short}} hinzufügen -{: #dra} - -{{site.data.keyword.DRA_full}} erfasst und analysiert die Ergebnisse von Komponententests, Funktionstests und Codeabdeckungstools, um zu bestimmen, ob Ihr Code vordefinierte Kriterien an angegebenen Punkten in Ihrem Bereitstellungsprozess erfüllt. Falls Ihr Code die Kriterien nicht erfüllt oder mehr als erfüllt, wird die Bereitstellung gestoppt, um keine Risiken einzuführen. Sie können {{site.data.keyword.DRA_short}} als Sicherheitsnetz für Ihre kontinuierliche Bereitstellungsumgebung oder als Methode zum Implementieren und Verbessern von Qualitätsstandards einsetzen. - - **Hinweis**: Diese Toolintegration ist vorkonfiguriert. Sie erfordert keine Konfigurationsparameter und Sie können sie nicht neu konfigurieren. - -Fügen Sie {{site.data.keyword.DRA_short}} hinzu, um die Qualität Ihres Codes in {{site.data.keyword.Bluemix_notm}} aufrechtzuerhalten und zu verbessern, indem Sie Ihre Bereitstellungen überwachen und Risiken erkennen, bevor sie eingeführt werden. - -1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). -1. Klicken Sie im Abschnitt mit den Toolintegrationen auf die Option für Bereitstellungsrisikoanalysen****. -1. Klicken Sie auf **Integration erstellen**. -1. Klicken Sie auf die Kachel für {{site.data.keyword.DRA_short}} und führen Sie dann die anfänglichen Schritte aus: Kriterien erstellen, Kriterien mit der Pipeline verknüpfen und Pipeline ausführen. Weitere Informationen finden Sie unter [{{site.data.keyword.DRA_short}} (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}. - - -## Eclipse Orion-{{site.data.keyword.webide}} hinzufügen -{: #webide} - -Die Eclipse Orion-{{site.data.keyword.webide}} ist eine integrierte webbasierte Umgebung, in der Sie Quellcodeverwaltungstasks erstellen, bearbeiten, ausführen, debuggen und abschließen können. Sie können nahtlos von der Bearbeitung zur Ausführung, zur Übergabe und zur Bereitstellung übergehen. - - **Hinweis**: Diese Toolintegration ist vorkonfiguriert. Sie erfordert keine Konfigurationsparameter und Sie können sie nicht neu konfigurieren. - -Fügen Sie die Toolintegration der Eclipse Orion-{{site.data.keyword.webide}} hinzu, um Quellcodeverwaltungstasks auszuführen: - -1. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Public eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Dedicated eine Toolchain verwenden, klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). -1. Klicken Sie im Abschnitt mit den Toolintegrationen auf die Option für die Eclipse Orion-Web-IDE****. -1. Klicken Sie auf **Integration erstellen**. -1. Klicken Sie auf die Kachel für die neue Eclipse Orion-{{site.data.keyword.webide}}. In Ihrem Arbeitsbereich sind Ihre GitHub- oder {{site.data.keyword.ghe_short}}-Repositorys bereits aufgeführt. Die Repositorys, die Ihrer aktuellen Toolchain zugeordnet sind, sind hervorgehoben. - -Weitere Informationen finden Sie unter [Code mit Eclipse Orion-{{site.data.keyword.webide}} bearbeiten (Link wird in neuem Fenster geöffnet)](../toolchains/web_ide.html){: new_window}. - - -## GitHub konfigurieren -{: #github} - -GitHub ist ein webbasierter Hosting-Service für Git-Repositorys. Sie können sowohl über lokale als auch über ferne Kopien Ihrer Repositorys verfügen, was die Zusammenarbeit sehr einfach gestaltet. - -GitHub Issues ist ein Überwachungstool, das Ihre Arbeit und Ihre Pläne an einem zentralen Ort aufbewahrt. Es ist in Ihr Entwicklungsrepository integriert, damit Sie sich auf die wichtigen Aufgaben konzentrieren können. - -Konfigurieren Sie GitHub zum Verwalten Ihres Quellcodes in der Cloud: - -1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, führen Sie diese Schritte aus: - - a. Klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **GitHub**. Wenn Sie die Toolchain unter {{site.data.keyword.Bluemix_notm}} Public erstellen und {{site.data.keyword.Bluemix_notm}} nicht für den Zugriff auf GitHub autorisiert haben, klicken Sie auf **Autorisieren**, um zur GitHub-Website zu wechseln. Wenn keine aktive GitHub-Sitzung existiert, werden Sie aufgefordert, sich anzumelden. Klicken Sie auf **Anwendung autorisieren**, um {{site.data.keyword.Bluemix_notm}} den Zugriff auf Ihr GitHub-Konto zu erlauben. Falls eine aktive GitHub-Sitzung existiert, Sie Ihr Kennwort aber bereits vor einiger Zeit eingegeben haben, werden Sie möglicherweise aufgefordert, Ihr GitHub-Kennwort durch erneute Eingabe zu bestätigen. - - b. Überprüfen Sie die Standardspeicherorte für die GitHub-Zielrepositorys. Diese Repositorys werden aus den Beispielrepositorys geklont. Ändern Sie gegebenenfalls die Namen der Zielrepositorys. - ![Standardspeicherorte für Zielrepositorys](images/toolchain_github_config.png) - -1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). -1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **GitHub**. -1. Falls Sie über ein GitHub-Repository verfügen und es verwenden möchten, geben Sie die URL ein. Klicken Sie für den Repository-Typ auf **Link**. -1. Falls Sie ein neues GitHub-Repository verwenden möchten, geben Sie einen Namen für das GitHub-Repository ein, das Sie klonen oder verzweigen, und wählen Sie den Repository-Typ aus: - - a. Klicken Sie auf **Neu**, um ein leeres Repository zu erstellen. - - b. Klicken Sie auf **Klonen**, um eine Kopie eines GitHub-Repositorys zu erstellen. - - c. Klicken Sie auf **Verzweigen**, um ein GitHub-Repository zu verzweigen, sodass Sie Änderungen per Pull-Anforderungen beitragen können. - -1. Wenn Sie GitHub Issues zum Überwachen von Problemen verwenden möchten, wählen Sie das Kontrollkästchen **GitHub Issues aktivieren** aus. -1. Klicken Sie auf **Integration erstellen**. -1. Klicken Sie auf die Kachel für das GitHub-Repository, mit dem Sie arbeiten möchten. Daraufhin wird die GitHub-Website geöffnet, auf der Sie die Inhalte des Repositorys anzeigen können. - - **Tipp**: Sie können die integrierten Quellcodeverwaltungstools in der Eclipse Orion-{{site.data.keyword.webide}} verwenden, um das GitHub-Repository zu bearbeiten und eine App aus Ihrem Arbeitsbereich bereitzustellen. - -1. Falls Sie GitHub Issues aktiviert haben, klicken Sie auf die Kachel für GitHub Issues, um GitHub Issues zu öffnen. - -Weitere Informationen finden Sie unter [GitHub (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} und [GitHub Issues (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. - - -## Dedicated GitHub Enterprise konfigurieren -{: #configghe} - -{{site.data.keyword.ghe_long}} ist ein lokaler webbasierter Hosting-Service für Git-Repositorys. Dedicated GitHub Enterprise ist nur für {{site.data.keyword.Bluemix_notm}} Dedicated-Kunden verfügbar. GitHub Issues ist ein Überwachungstool, das Ihre Arbeit und Ihre Pläne an einem zentralen Ort aufbewahrt. Es ist in Ihr Entwicklungsrepository integriert, damit Sie sich auf die wichtigen Aufgaben konzentrieren können. Weitere Informationen zu Dedicated GitHub Enterprise und GitHub Issues finden Sie im Abschnitt zur [Verwendung von Dedicated GitHub Enterprise (Link wird in neuem Fenster geöffnet)](../services/ghededicated/index.html){: new_window} bzw. unter [GitHub Issues (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. - -Sie können {{site.data.keyword.ghe_short}} als Toolintegration in Ihrer Toolchain konfigurieren, sodass Sie Quellcode -in der Instanz von [{{site.data.keyword.Bluemix_notm}} Dedicated (Link wird in neuem Fenster geöffnet)](../dedicated/index.html#dedicated){: new_window} -Ihres Unternehmens verwalten können. - -1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, führen Sie diese Schritte aus: - - a. Bevor Sie sich zum ersten Mal bei Dedicated GitHub Enterprise anmelden, bitten Sie den Regionsadministrator Ihres Unternehmens, der {{site.data.keyword.Bluemix_notm}} Dedicated-Instanz Ihre Benutzer-ID aus dem Benutzerregistry Ihres Unternehmens unter Verwendung von LDAP hinzuzufügen. Informationen zum Einrichten Ihres {{site.data.keyword.ghe_short}}-Kontos finden Sie im Abschnitt zur Verwendung von [Dedicated GitHub Enterprise (Link wird in neuem Fenster geöffnet)](../services/ghededicated/index.html){: new_window}. - - b. Klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **{{site.data.keyword.ghe_short}}**. - - c. Prüfen Sie den Standardnamen für das neue {{site.data.keyword.ghe_short}}-Repository. Ändern Sie gegebenenfalls den Namen des neuen Repositorys. Die folgende Abbildung zeigt ein Beispiel für ein Repository, das aus einem Beispielrepository geklont ist. Sie können ein vorhandenes oder ein neues Repository verwenden. Um ein neues Repository zu verwenden, können Sie ein leeres Repository erstellen oder Sie können ein Repository klonen oder verzweigen. - ![Standardspeicherorte für Repositorys](images/toolchain_ghe_config.png) - -1. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Public eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite Ihrer App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Dedicated eine Toolchain verwenden, klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). -1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **{{site.data.keyword.ghe_short}}**. -1. Falls Sie über ein {{site.data.keyword.ghe_short}}-Repository verfügen, das Sie verwenden wollen, geben Sie die URL für das Repository ein. Klicken Sie für den Repository-Typ auf **Vorhanden**. -1. Falls Sie ein neues {{site.data.keyword.ghe_short}}-Repository verwenden möchten, geben Sie einen Namen für das Repository ein, das Sie klonen oder verzweigen, und wählen Sie den Repository-Typ aus: - - a. Klicken Sie auf **Neu**, um ein leeres Repository zu erstellen. - - b. Klicken Sie auf **Klonen**, um eine Kopie eines Repositorys zu erstellen. - - c. Klicken Sie auf **Verzweigen**, um ein Repository zu verzweigen, sodass Sie Änderungen per Pull-Anforderungen beitragen können. - -1. Wenn Sie GitHub Issues zum Überwachen von Problemen verwenden möchten, wählen Sie das Kontrollkästchen **GitHub Issues aktivieren** aus. -1. Klicken Sie auf **Integration erstellen**. -1. Klicken Sie auf die Kachel für das {{site.data.keyword.ghe_short}}-Repository, mit dem Sie arbeiten möchten. Die Instanz von [{{site.data.keyword.Bluemix_notm}} Dedicated (Link wird in neuem Fenster geöffnet)](../dedicated/index.html#dedicated){: new_window} Ihres Unternehmens wird geöffnet, in der Sie die Inhalte des Repositorys anzeigen können. - - **Tipp**: Sie können die integrierten Quellcodeverwaltungstools in der Eclipse Orion-{{site.data.keyword.webide}} verwenden, um das {{site.data.keyword.ghe_short}}-Repository zu bearbeiten und eine App aus Ihrem Arbeitsbereich bereitzustellen. - -1. Falls Sie GitHub Issues aktiviert haben, klicken Sie auf die Kachel für GitHub Issues. - - - -## Angepasstes Tool konfigurieren (Option 'Other Tool') -{: #othertool} - -Falls Ihr Team ein Tool verwendet, das nicht in der Liste der Toolchainintegrationen enthalten ist, können Sie ein angepasstes Tool integrieren. - -So konfigurieren Sie ein angepasstes Tool, damit es mit anderen Tools in Ihrer Toolchain zusammenarbeitet und für Ihr Team verfügbar ist: -1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **Other Tool**. - -1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). -1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **Other Tool**. -1. Geben Sie den Namen des Tools ein. -1. Wählen Sie eine Lebenszyklusphase aus, die dem Tool am genauesten entspricht. Die Auswahl der Lebenszyklusphase bestimmt die Kategorie, unter der Ihr Tool auf der Seite mit den Toolintegrationen angezeigt wird. -1. Fügen Sie eine URL für ein Symbol hinzu. Das Symbol wird auf der Karte für die Integration Ihres Tools angezeigt. -1. Fügen Sie eine URL für die Dokumentation hinzu. -1. Geben Sie einen Instanznamen für das Tool an. Beispiel: Tool für mein Team. -1. Fügen Sie eine URL für die Toolinstanz hinzu. Beim Klicken auf die Karte für die Toolintegration werden Sie zu der URL geführt, die Sie für die Toolinstanz angeben. -1. Fügen Sie eine Beschreibung des Tools hinzu. -1. (Erweitert) Fügen Sie bei Bedarf zusätzliche Eigenschaften hinzu. Listen Sie beispielsweise alle Informationen oder Attribute auf, die gegebenenfalls für die Integration Ihres Tools bei anderen Tools in Ihrer Toolchain erforderlich sind. -1. Klicken Sie auf **Integration erstellen**. - -## PagerDuty konfigurieren -{: #pagerduty} - -PagerDuty integriert Daten aus mehreren Überwachungssystemen in einer Gesamtansicht. Wenn ein Problem auftritt, stellt PagerDuty sicher, dass das Teammitglied, das zu diesem Zeitpunkt am besten geeignet ist, das Problem zu lösen, benachrichtigt wird. Falls das Teammitglied nicht auf das Problem reagiert, können Eskalationen konfiguriert werden, um es an sekundäre Entwickler oder Betriebsleiter weiterzuleiten. - -Konfigurieren Sie PagerDuty, um Benachrichtigungen zu senden, wenn Pipeline-Stage-Fehler auftreten, damit Sie Probleme schneller beheben und Ausfallzeiten reduzieren können: - -1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **PagerDuty**. -1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). -1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **PagerDuty**. -1. Geben Sie den Namen der PagerDuty-Website ein, die Ihrem PagerDuty-Konto zugeordnet ist. Wenn Sie kein PagerDuty-Konto haben, [registrieren Sie sich für ein solches Konto (Link wird in neuem Fenster geöffnet)](https://signup.pagerduty.com/accounts/new){: new_window}. -1. Geben Sie den API-Zugriffsschlüssel für Ihr PagerDuty-Konto ein. Anweisungen zum Auffinden des Schlüssels finden Sie auf der Seite für die [API-Authentifizierung (Link wird in neuem Fenster geöffnet)](https://signup.pagerduty.com/accounts/new){: new_window}. -1. Geben Sie den Namen Ihres PagerDuty-Service ein. -1. Geben Sie die E-Mail-Adresse für den primären PagerDuty-Kontakt ein. -1. Geben Sie die Telefonnummer für den primären PagerDuty-Kontakt ein. -1. Klicken Sie auf **Integration erstellen**. -1. Klicken Sie auf die Kachel für PagerDuty, um pagerduty.com zu öffnen. Sie können die Ereignisse anzeigen, die dem PagerDuty-Service zugeordnet sind, den Sie während der Konfiguration dieser Toolintegration für Ihre Toolchain angegeben haben. - -Weitere Informationen finden Sie unter [PagerDuty (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}. - - -## Sauce Labs konfigurieren -{: #saucelabs} - -Sauce Labs führt funktionelle Komponententests aus. Wenn eine Sauce Labs-Testsuite als Testjob in der {{site.data.keyword.deliverypipeline}} konfiguriert wird, kann die Testsuite Tests für Ihre Web- oder Mobil-App als Teil Ihres kontinuierlichen Bereitstellungsprozesses ausführen. Anhand dieser Tests können Sie eine reibungslose Ablaufsteuerung für Ihre Projekte erzielen, da die Bereitstellung von fehlerhaftem Code verhindert wird. - -Konfigurieren Sie Sauce Labs, um automatische Funktionstests auf mehreren Betriebssystemen und in mehreren Browsern auszuführen, sodass Sie die Art und Weise emulieren können, auf die ein Benutzer möglicherweise eine Website oder eine Anwendung nutzt. - -1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **Sauce Labs**. -1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). -1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **Sauce Labs**. -1. Geben Sie den Benutzernamen ein, der Ihrem Sauce Labs-Konto zugeordnet ist. Sie finden [Ihren Benutzernamen in der Begrüßungsnachricht oben auf Ihrer Sauce Labs-Kontoseite (Link wird in neuem Fenster geöffnet)](https://saucelabs.com/account){: new_window}. -1. Geben Sie den Zugriffsschlüssel für Ihr Sauce Labs-Konto ein. Sie finden [den Schlüssel auf der Sauce Labs-Kontoseite (Link wird in neuem Fenster geöffnet)](https://saucelabs.com/account){: new_window}. -1. Klicken Sie auf **Integration erstellen**. -1. Klicken Sie auf die Kachel für Sauce Labs, um saucelabs.com zu öffnen und die Testaktivität für die Toolchain anzuzeigen. - - **Tipp**: Wenn Sie einen Sauce Labs-Testjob zur {{site.data.keyword.deliverypipeline}} hinzugefügt haben, können Sie die Serviceinstanz auswählen. - -Weitere Informationen finden Sie unter [Sauce Labs (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}. - - -## Slack konfigurieren -{: #slack} - -**Wichtig**: Benachrichtigungen, die in öffentlichen Slack-Kanälen gepostet werden, sind für jeden im Team sichtbar. Denken Sie daran, dass Sie für den Inhalt, den Sie posten, verantwortlich sind. - -Slack ist ein cloudbasiertes echtzeitorientiertes Messaging- und Benachrichtigungssystem. Slack stellt persistenten Chat bereit, wobei es sich um eine interaktivere Alternative zu E-Mail für die Teamzusammenarbeit handelt. Sie können mit Ihrem Team über einen dedizierten Kanal oder über eine Reihe von Kanälen kommunizieren, die in direktem Zusammenhang mit Ihrer Arbeit stehen. Sie können außerdem Dateien und Bilder über die Kanäle oder in direkten Nachrichten zwischen zwei oder mehr Personen teilen. Die Kommunikation in direkten Nachrichten und über die Kanäle wird aufbewahrt und kann durchsucht werden. - -Konfigurieren Sie Slack, um Benachrichtigungen zu Ihrer Toolchain von den Toolintegrationen zu erhalten, z. B. Test- und Bereitstellungsaktivitäten: - -1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **Slack**. -1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). -1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **Slack**. -1. Geben Sie das API-Authentifizierungstoken für Ihr Slack-Konto ein. Sie müssen ein generiertes Token für uneingeschränkten Zugriff zur Authentifizierung bei Slack verwenden. Anweisungen zum Auffinden des Tokens finden Sie im Abschnitt zur [Slack-Authentifizierung (Link wird in neuem Fenster geöffnet)](https://api.slack.com/web#authentication){: new_window}. -1. Geben Sie den Namen des Slack-Kanals ein, an den die Benachrichtigungen gesendet werden sollen. Falls der Kanal, den Sie angeben, nicht existiert, wird er erstellt. Falls der Kanal archiviert wurde, wird er reaktiviert. -1. Klicken Sie auf **Integration erstellen**. -1. Klicken Sie auf die Kachel für Slack. Sie können alle Aktivitäten für Ihre Toolchain im konfigurierten Slack-Kanal anzeigen. - -Weitere Informationen finden Sie unter [Slack (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}. - - - - - - - - +--- + +Copyright: + Jahre: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Toolintegrationen konfigurieren +{: #integrations} + +Letzte Aktualisierung: 18. Oktober 2016 +{: .last-updated} + +Sie können Toolintegrationen konfigurieren, die Entwicklungs-, Bereitstellungs- und Systemtasks unterstützen, während Sie eine Toolchain erstellen, oder Sie können Toolintegrationen hinzufügen und konfigurieren, um eine vorhandene Toolchain anzupassen. +{:shortdesc} + +**Wichtig**: Unter {{site.data.keyword.Bluemix_notm}} Public sind Toolchains nur in den USA (Süden) verfügbar. + +Die Toolintegrationen, die zum Hinzufügen und Konfigurieren für Ihre Toolchain zur Verfügung stehen, sind unterschiedlich, abhängig davon, ob Sie Toolchains unter {{site.data.keyword.Bluemix_notm}} Public oder {{site.data.keyword.Bluemix_notm}} Dedicated verwenden. Falls Sie Toolchains bei {{site.data.keyword.Bluemix_notm}} Dedicated verwenden, variieren die für Sie verfügbaren Toolintegrationen abhängig davon, wie {{site.data.keyword.jazzhub_title}} in Ihrer speziellen Umgebung konfiguriert wurde. + +*Tabelle 1. Toolintegrationen, die für Toolchains unter {{site.data.keyword.Bluemix_notm}} Public und Dedicated verfügbar sind* + +|Toolintegration |Verfügbar unter {{site.data.keyword.Bluemix_notm}} Public |Verfügbar unter {{site.data.keyword.Bluemix_notm}} Dedicated (umgebungsabhängig)| +|:----------|:------------------------------|:------------------| +|{{site.data.keyword.deliverypipeline}} |Ja |Ja | +|{{site.data.keyword.DRA_short}} |Ja |Nein | +|Eclipse Orion {{site.data.keyword.webide}} |Ja |Ja | +|GitHub |Ja |Ja | +|Dedicated GitHub Enterprise |Nein |Ja | +|Anderes Tool |Ja |Ja | +|PagerDuty |Ja |Ja | +|Sauce Labs |Ja |Nein | +|Slack |Ja |Ja | + +**Tipp**: Wenn Sie beginnen möchten, mit Ihrem eigenen Code unter {{site.data.keyword.Bluemix_notm}} Public zu entwickeln, müssen Sie die GitHub-Toolintegration konfigurieren, bevor Sie die {{site.data.keyword.deliverypipeline}} konfigurieren. Wenn Sie beginnen möchten, mit Ihrem eigenen Code unter {{site.data.keyword.Bluemix_notm}} Dedicated zu entwickeln, müssen Sie die {{site.data.keyword.ghe_short}}-Toolintegration oder die GitHub-Toolintegration vor der {{site.data.keyword.deliverypipeline}} konfigurieren. + + +## Delivery Pipeline konfigurieren +{: #deliverypipeline} + +Die {{site.data.keyword.deliverypipeline}} automatisiert die kontinuierliche Entwicklung Ihrer Projekte durch aufeinanderfolgende Stages, in denen Eingaben abgerufen und Jobs wie Builds, Tests und Bereitstellungen ausgeführt werden. + +Konfigurieren Sie die {{site.data.keyword.deliverypipeline}}, um das kontinuierliche Erstellen, Testen und Bereitstellen Ihrer Apps zu automatisieren: + +1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **Delivery Pipeline**. Abhängig von der Vorlage, die Sie verwenden, sind unterschiedliche Felder verfügbar. Überprüfen Sie die Standardfeldwerte und ändern Sie diese Einstellungen gegebenenfalls. +1. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Public eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite Ihrer App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Dedicated eine Toolchain verwenden, klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). +1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **Delivery Pipeline**. +1. Geben Sie einen Namen für Ihre neue Pipeline an. +1. Wenn Sie mithilfe Ihrer Pipeline eine Benutzerschnittstelle bereitstellen möchten, wählen Sie das Kontrollkästchen **Anzeigbare App** aus. Alle Apps, die Ihre Pipeline erstellt, werden in der Liste **APP ANZEIGEN** auf der Seite mit den Toolintegrationen der Toolchain angezeigt. +1. Klicken Sie auf **Integration erstellen**, um die {{site.data.keyword.deliverypipeline}} zu Ihrer Toolchain hinzuzufügen. +1. Klicken Sie auf die {{site.data.keyword.deliverypipeline}}-Kachel, um die Pipeline anzuzeigen und zu konfigurieren. Die Grundlagen des Konfigurierens einer Pipeline finden Sie unter [Pipelines erstellen und bereitstellen (Link wird in neuem Fenster geöffnet)](../services/DeliveryPipeline/build_deploy.html){: new_window}. + + **Tipp**: Falls Sie die Pipeline aktivieren möchten, wenn Sie Änderungen per Push-Operation an Ihr GitHub- oder {{site.data.keyword.ghe_short}}-Repository übertragen, müssen Sie GitHub oder {{site.data.keyword.ghe_short}} für Ihre Toolchain konfigurieren, bevor Sie die Stages für Ihre Pipeline definieren. Die Pipeline-Stages benötigen die Git-URLs für Ihre Repositorys. Jede Pipeline-Stage kann nur auf eines der GitHub- oder {{site.data.keyword.ghe_short}}-Repositorys verweisen, das Ihrer Toolchain zugeordnet ist. Anweisungen zum Konfigurieren von GitHub finden Sie im Abschnitt [GitHub](#github). Anweisungen zum Konfigurieren von Dedicated GitHub Enterprise finden Sie unter [Einführung in {{site.data.keyword.ghe_long}} (Link wird in neuem Fenster geöffnet)](../services/ghededicated/index.html){: new_window}. + +1. Optional: Wenn Sie eine Toolchain unter {{site.data.keyword.Bluemix_notm}} Public verwenden und Sie möchten, dass Sauce Labs Ihre App testet, konfigurieren Sie die {{site.data.keyword.deliverypipeline}}, um einen Sauce Labs-Testjob hinzuzufügen. Anweisungen zum Konfigurieren des Testjobs finden Sie im Abschnitt [Sauce Labs-Testjob in Ihrer Pipeline konfigurieren](#config_saucelabs). + +### Sauce Labs-Testjob in Ihrer Pipeline konfigurieren +{: #config_saucelabs} + +Bevor Sie einen Sauce Labs-Testjob in Ihrer Pipeline konfigurieren, brauchen Sie eine funktionstüchtige Pipeline, die Stages zum Erstellen und Bereitstellen Ihrer App umfasst, und Sie müssen Sauce Labs für Ihre Toolchain konfigurieren. Anweisungen zum Konfigurieren von Sauce Labs finden Sie im Abschnitt [Sauce Labs](#saucelabs). + +Konfigurieren Sie die {{site.data.keyword.deliverypipeline}}, um einen Sauce Labs-Testjob hinzuzufügen: + +1. Wenn keine Stage vorhanden ist, die eine Testversion Ihrer App bereitstellt, erstellen Sie eine. +1. Fügen Sie in der Stage einen Testjob nach dem Bereitstellungsjob hinzu. Indem Sie diese Jobs in derselben Stage platzieren, können sie auf dieselbe Gruppe von Umgebungseigenschaften zugreifen. + ![Testjob](images/toolchain_test_job.png) + +1. Konfigurieren Sie die Stage: + + a. Erstellen Sie auf der Registerkarte **UMGEBUNGSEIGENSCHAFTEN** drei Eigenschaften: CF_APP_NAME, SAUCE_USERNAME und SAUCE_ACCESS_KEY. + + b. Geben Sie Ihren Sauce Labs-Benutzernamen und -Zugriffsschlüssel ein. Dadurch stellen Sie diese Werte extern bereit und können sie in Ihren Tests verwenden. + +1. Konfigurieren Sie den Bereitstellungsjob. Schließen Sie im Feld **Bereitstellungsscript** diesen Befehl ein: `export CF_APP_NAME="$CF_APP"`. Der Befehl exportiert den Namen der App als Umgebungseigenschaft. +1. Konfigurieren Sie den Testjob. Die Werte in der folgenden Abbildung sind Beispiele. In die Felder **Serviceinstanz**, **Ziel**, **Organisation** und **Bereich** werden der Sauce Labs-Benutzername, die Region, die Organisation und der Bereich eingetragen, die Sie verwenden. +![Job konfigurieren](images/toolchain_configure_job.png) + + Wählen Sie als Testertyp **Sauce Labs** aus. + + b. Wählen Sie als Serviceinstanz den Sauce Labs-Benutzernamen aus, den Sie beim Konfigurieren von Sauce Labs für Ihre Toolchain verwendet haben. + + **Tipp**: Um zu sehen, welchen Benutzernamen und Zugriffsschlüssel Sie beim Konfigurieren von Sauce Labs für Ihre Toolchain verwendet haben, klicken Sie auf **Konfigurieren**. + + c. Geben Sie im Feld **Befehl für die Testausführung** die Befehle ein, die die für Ihre Tests erforderlichen Abhängigkeiten installieren, und führen Sie dann die Tests aus. Für eine Node.js-App würden Sie beispielsweise folgende Befehle eingeben: + ``` + npm install + node_modules/grunt-cli/bin/grunt test:sauce:parallel + ``` + + d. Wenn Sie Ihre Testberichte in den Testjobprotokollen anzeigen möchten, wählen Sie das Kontrollkästchen **Testbericht aktivieren** aus und legen Sie Dateimuster für Testergebnisse auf `test/*.xml` fest. + +1. Klicken Sie auf **SPEICHERN**. Immer, wenn Ihre Pipeline aktiv ist, werden Sauce Labs-Tests ausgeführt. + +Weitere Informationen finden Sie unter [Delivery Pipeline (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}. + + +## {{site.data.keyword.DRA_short}} hinzufügen +{: #dra} + +{{site.data.keyword.DRA_full}} erfasst und analysiert die Ergebnisse von Komponententests, Funktionstests und Codeabdeckungstools, um zu bestimmen, ob Ihr Code vordefinierte Kriterien an angegebenen Punkten in Ihrem Bereitstellungsprozess erfüllt. Falls Ihr Code die Kriterien nicht erfüllt oder mehr als erfüllt, wird die Bereitstellung gestoppt, um keine Risiken einzuführen. Sie können {{site.data.keyword.DRA_short}} als Sicherheitsnetz für Ihre kontinuierliche Bereitstellungsumgebung oder als Methode zum Implementieren und Verbessern von Qualitätsstandards einsetzen. + + **Hinweis**: Diese Toolintegration ist vorkonfiguriert. Sie erfordert keine Konfigurationsparameter und Sie können sie nicht neu konfigurieren. + +Fügen Sie {{site.data.keyword.DRA_short}} hinzu, um die Qualität Ihres Codes in {{site.data.keyword.Bluemix_notm}} aufrechtzuerhalten und zu verbessern, indem Sie Ihre Bereitstellungen überwachen und Risiken erkennen, bevor sie eingeführt werden. + +1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). +1. Klicken Sie im Abschnitt mit den Toolintegrationen auf die Option für Bereitstellungsrisikoanalysen****. +1. Klicken Sie auf **Integration erstellen**. +1. Klicken Sie auf die Kachel für {{site.data.keyword.DRA_short}} und führen Sie dann die anfänglichen Schritte aus: Kriterien erstellen, Kriterien mit der Pipeline verknüpfen und Pipeline ausführen. Weitere Informationen finden Sie unter [{{site.data.keyword.DRA_short}} (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}. + + +## Eclipse Orion-{{site.data.keyword.webide}} hinzufügen +{: #webide} + +Die Eclipse Orion-{{site.data.keyword.webide}} ist eine integrierte webbasierte Umgebung, in der Sie Quellcodeverwaltungstasks erstellen, bearbeiten, ausführen, debuggen und abschließen können. Sie können nahtlos von der Bearbeitung zur Ausführung, zur Übergabe und zur Bereitstellung übergehen. + + **Hinweis**: Diese Toolintegration ist vorkonfiguriert. Sie erfordert keine Konfigurationsparameter und Sie können sie nicht neu konfigurieren. + +Fügen Sie die Toolintegration der Eclipse Orion-{{site.data.keyword.webide}} hinzu, um Quellcodeverwaltungstasks auszuführen: + +1. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Public eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Dedicated eine Toolchain verwenden, klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). +1. Klicken Sie im Abschnitt mit den Toolintegrationen auf die Option für die Eclipse Orion-Web-IDE****. +1. Klicken Sie auf **Integration erstellen**. +1. Klicken Sie auf die Kachel für die neue Eclipse Orion-{{site.data.keyword.webide}}. In Ihrem Arbeitsbereich sind Ihre GitHub- oder {{site.data.keyword.ghe_short}}-Repositorys bereits aufgeführt. Die Repositorys, die Ihrer aktuellen Toolchain zugeordnet sind, sind hervorgehoben. + +Weitere Informationen finden Sie unter [Code mit Eclipse Orion-{{site.data.keyword.webide}} bearbeiten (Link wird in neuem Fenster geöffnet)](../toolchains/web_ide.html){: new_window}. + + +## GitHub konfigurieren +{: #github} + +GitHub ist ein webbasierter Hosting-Service für Git-Repositorys. Sie können sowohl über lokale als auch über ferne Kopien Ihrer Repositorys verfügen, was die Zusammenarbeit sehr einfach gestaltet. + +GitHub Issues ist ein Überwachungstool, das Ihre Arbeit und Ihre Pläne an einem zentralen Ort aufbewahrt. Es ist in Ihr Entwicklungsrepository integriert, damit Sie sich auf die wichtigen Aufgaben konzentrieren können. + +Konfigurieren Sie GitHub zum Verwalten Ihres Quellcodes in der Cloud: + +1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, führen Sie diese Schritte aus: + + a. Klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **GitHub**. Wenn Sie die Toolchain unter {{site.data.keyword.Bluemix_notm}} Public erstellen und {{site.data.keyword.Bluemix_notm}} nicht für den Zugriff auf GitHub autorisiert haben, klicken Sie auf **Autorisieren**, um zur GitHub-Website zu wechseln. Wenn keine aktive GitHub-Sitzung existiert, werden Sie aufgefordert, sich anzumelden. Klicken Sie auf **Anwendung autorisieren**, um {{site.data.keyword.Bluemix_notm}} den Zugriff auf Ihr GitHub-Konto zu erlauben. Falls eine aktive GitHub-Sitzung existiert, Sie Ihr Kennwort aber bereits vor einiger Zeit eingegeben haben, werden Sie möglicherweise aufgefordert, Ihr GitHub-Kennwort durch erneute Eingabe zu bestätigen. + + b. Überprüfen Sie die Standardspeicherorte für die GitHub-Zielrepositorys. Diese Repositorys werden aus den Beispielrepositorys geklont. Ändern Sie gegebenenfalls die Namen der Zielrepositorys. + ![Standardspeicherorte für Zielrepositorys](images/toolchain_github_config.png) + +1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). +1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **GitHub**. +1. Falls Sie über ein GitHub-Repository verfügen und es verwenden möchten, geben Sie die URL ein. Klicken Sie für den Repository-Typ auf **Link**. +1. Falls Sie ein neues GitHub-Repository verwenden möchten, geben Sie einen Namen für das GitHub-Repository ein, das Sie klonen oder verzweigen, und wählen Sie den Repository-Typ aus: + + a. Klicken Sie auf **Neu**, um ein leeres Repository zu erstellen. + + b. Klicken Sie auf **Klonen**, um eine Kopie eines GitHub-Repositorys zu erstellen. + + c. Klicken Sie auf **Verzweigen**, um ein GitHub-Repository zu verzweigen, sodass Sie Änderungen per Pull-Anforderungen beitragen können. + +1. Wenn Sie GitHub Issues zum Überwachen von Problemen verwenden möchten, wählen Sie das Kontrollkästchen **GitHub Issues aktivieren** aus. +1. Klicken Sie auf **Integration erstellen**. +1. Klicken Sie auf die Kachel für das GitHub-Repository, mit dem Sie arbeiten möchten. Daraufhin wird die GitHub-Website geöffnet, auf der Sie die Inhalte des Repositorys anzeigen können. + + **Tipp**: Sie können die integrierten Quellcodeverwaltungstools in der Eclipse Orion-{{site.data.keyword.webide}} verwenden, um das GitHub-Repository zu bearbeiten und eine App aus Ihrem Arbeitsbereich bereitzustellen. + +1. Falls Sie GitHub Issues aktiviert haben, klicken Sie auf die Kachel für GitHub Issues, um GitHub Issues zu öffnen. + +Weitere Informationen finden Sie unter [GitHub (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} und [GitHub Issues (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. + + +## Dedicated GitHub Enterprise konfigurieren +{: #configghe} + +{{site.data.keyword.ghe_long}} ist ein lokaler webbasierter Hosting-Service für Git-Repositorys. Dedicated GitHub Enterprise ist nur für {{site.data.keyword.Bluemix_notm}} Dedicated-Kunden verfügbar. GitHub Issues ist ein Überwachungstool, das Ihre Arbeit und Ihre Pläne an einem zentralen Ort aufbewahrt. Es ist in Ihr Entwicklungsrepository integriert, damit Sie sich auf die wichtigen Aufgaben konzentrieren können. Weitere Informationen zu Dedicated GitHub Enterprise und GitHub Issues finden Sie im Abschnitt zur [Verwendung von Dedicated GitHub Enterprise (Link wird in neuem Fenster geöffnet)](../services/ghededicated/index.html){: new_window} bzw. unter [GitHub Issues (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. + +Sie können {{site.data.keyword.ghe_short}} als Toolintegration in Ihrer Toolchain konfigurieren, sodass Sie Quellcode +in der Instanz von [{{site.data.keyword.Bluemix_notm}} Dedicated (Link wird in neuem Fenster geöffnet)](../dedicated/index.html#dedicated){: new_window} +Ihres Unternehmens verwalten können. + +1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, führen Sie diese Schritte aus: + + a. Bevor Sie sich zum ersten Mal bei Dedicated GitHub Enterprise anmelden, bitten Sie den Regionsadministrator Ihres Unternehmens, der {{site.data.keyword.Bluemix_notm}} Dedicated-Instanz Ihre Benutzer-ID aus dem Benutzerregistry Ihres Unternehmens unter Verwendung von LDAP hinzuzufügen. Informationen zum Einrichten Ihres {{site.data.keyword.ghe_short}}-Kontos finden Sie im Abschnitt zur Verwendung von [Dedicated GitHub Enterprise (Link wird in neuem Fenster geöffnet)](../services/ghededicated/index.html){: new_window}. + + b. Klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **{{site.data.keyword.ghe_short}}**. + + c. Prüfen Sie den Standardnamen für das neue {{site.data.keyword.ghe_short}}-Repository. Ändern Sie gegebenenfalls den Namen des neuen Repositorys. Die folgende Abbildung zeigt ein Beispiel für ein Repository, das aus einem Beispielrepository geklont ist. Sie können ein vorhandenes oder ein neues Repository verwenden. Um ein neues Repository zu verwenden, können Sie ein leeres Repository erstellen oder Sie können ein Repository klonen oder verzweigen. + ![Standardspeicherorte für Repositorys](images/toolchain_ghe_config.png) + +1. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Public eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite Ihrer App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. Wenn Sie unter {{site.data.keyword.Bluemix_notm}} Dedicated eine Toolchain verwenden, klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). +1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **{{site.data.keyword.ghe_short}}**. +1. Falls Sie über ein {{site.data.keyword.ghe_short}}-Repository verfügen, das Sie verwenden wollen, geben Sie die URL für das Repository ein. Klicken Sie für den Repository-Typ auf **Vorhanden**. +1. Falls Sie ein neues {{site.data.keyword.ghe_short}}-Repository verwenden möchten, geben Sie einen Namen für das Repository ein, das Sie klonen oder verzweigen, und wählen Sie den Repository-Typ aus: + + a. Klicken Sie auf **Neu**, um ein leeres Repository zu erstellen. + + b. Klicken Sie auf **Klonen**, um eine Kopie eines Repositorys zu erstellen. + + c. Klicken Sie auf **Verzweigen**, um ein Repository zu verzweigen, sodass Sie Änderungen per Pull-Anforderungen beitragen können. + +1. Wenn Sie GitHub Issues zum Überwachen von Problemen verwenden möchten, wählen Sie das Kontrollkästchen **GitHub Issues aktivieren** aus. +1. Klicken Sie auf **Integration erstellen**. +1. Klicken Sie auf die Kachel für das {{site.data.keyword.ghe_short}}-Repository, mit dem Sie arbeiten möchten. Die Instanz von [{{site.data.keyword.Bluemix_notm}} Dedicated (Link wird in neuem Fenster geöffnet)](../dedicated/index.html#dedicated){: new_window} Ihres Unternehmens wird geöffnet, in der Sie die Inhalte des Repositorys anzeigen können. + + **Tipp**: Sie können die integrierten Quellcodeverwaltungstools in der Eclipse Orion-{{site.data.keyword.webide}} verwenden, um das {{site.data.keyword.ghe_short}}-Repository zu bearbeiten und eine App aus Ihrem Arbeitsbereich bereitzustellen. + +1. Falls Sie GitHub Issues aktiviert haben, klicken Sie auf die Kachel für GitHub Issues. + + + +## Angepasstes Tool konfigurieren (Option 'Other Tool') +{: #othertool} + +Falls Ihr Team ein Tool verwendet, das nicht in der Liste der Toolchainintegrationen enthalten ist, können Sie ein angepasstes Tool integrieren. + +So konfigurieren Sie ein angepasstes Tool, damit es mit anderen Tools in Ihrer Toolchain zusammenarbeitet und für Ihr Team verfügbar ist: +1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **Other Tool**. + +1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). +1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **Other Tool**. +1. Geben Sie den Namen des Tools ein. +1. Wählen Sie eine Lebenszyklusphase aus, die dem Tool am genauesten entspricht. Die Auswahl der Lebenszyklusphase bestimmt die Kategorie, unter der Ihr Tool auf der Seite mit den Toolintegrationen angezeigt wird. +1. Fügen Sie eine URL für ein Symbol hinzu. Das Symbol wird auf der Karte für die Integration Ihres Tools angezeigt. +1. Fügen Sie eine URL für die Dokumentation hinzu. +1. Geben Sie einen Instanznamen für das Tool an. Beispiel: Tool für mein Team. +1. Fügen Sie eine URL für die Toolinstanz hinzu. Beim Klicken auf die Karte für die Toolintegration werden Sie zu der URL geführt, die Sie für die Toolinstanz angeben. +1. Fügen Sie eine Beschreibung des Tools hinzu. +1. (Erweitert) Fügen Sie bei Bedarf zusätzliche Eigenschaften hinzu. Listen Sie beispielsweise alle Informationen oder Attribute auf, die gegebenenfalls für die Integration Ihres Tools bei anderen Tools in Ihrer Toolchain erforderlich sind. +1. Klicken Sie auf **Integration erstellen**. + +## PagerDuty konfigurieren +{: #pagerduty} + +PagerDuty integriert Daten aus mehreren Überwachungssystemen in einer Gesamtansicht. Wenn ein Problem auftritt, stellt PagerDuty sicher, dass das Teammitglied, das zu diesem Zeitpunkt am besten geeignet ist, das Problem zu lösen, benachrichtigt wird. Falls das Teammitglied nicht auf das Problem reagiert, können Eskalationen konfiguriert werden, um es an sekundäre Entwickler oder Betriebsleiter weiterzuleiten. + +Konfigurieren Sie PagerDuty, um Benachrichtigungen zu senden, wenn Pipeline-Stage-Fehler auftreten, damit Sie Probleme schneller beheben und Ausfallzeiten reduzieren können: + +1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **PagerDuty**. +1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). +1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **PagerDuty**. +1. Geben Sie den Namen der PagerDuty-Website ein, die Ihrem PagerDuty-Konto zugeordnet ist. Wenn Sie kein PagerDuty-Konto haben, [registrieren Sie sich für ein solches Konto (Link wird in neuem Fenster geöffnet)](https://signup.pagerduty.com/accounts/new){: new_window}. +1. Geben Sie den API-Zugriffsschlüssel für Ihr PagerDuty-Konto ein. Anweisungen zum Auffinden des Schlüssels finden Sie auf der Seite für die [API-Authentifizierung (Link wird in neuem Fenster geöffnet)](https://signup.pagerduty.com/accounts/new){: new_window}. +1. Geben Sie den Namen Ihres PagerDuty-Service ein. +1. Geben Sie die E-Mail-Adresse für den primären PagerDuty-Kontakt ein. +1. Geben Sie die Telefonnummer für den primären PagerDuty-Kontakt ein. +1. Klicken Sie auf **Integration erstellen**. +1. Klicken Sie auf die Kachel für PagerDuty, um pagerduty.com zu öffnen. Sie können die Ereignisse anzeigen, die dem PagerDuty-Service zugeordnet sind, den Sie während der Konfiguration dieser Toolintegration für Ihre Toolchain angegeben haben. + +Weitere Informationen finden Sie unter [PagerDuty (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}. + + +## Sauce Labs konfigurieren +{: #saucelabs} + +Sauce Labs führt funktionelle Komponententests aus. Wenn eine Sauce Labs-Testsuite als Testjob in der {{site.data.keyword.deliverypipeline}} konfiguriert wird, kann die Testsuite Tests für Ihre Web- oder Mobil-App als Teil Ihres kontinuierlichen Bereitstellungsprozesses ausführen. Anhand dieser Tests können Sie eine reibungslose Ablaufsteuerung für Ihre Projekte erzielen, da die Bereitstellung von fehlerhaftem Code verhindert wird. + +Konfigurieren Sie Sauce Labs, um automatische Funktionstests auf mehreren Betriebssystemen und in mehreren Browsern auszuführen, sodass Sie die Art und Weise emulieren können, auf die ein Benutzer möglicherweise eine Website oder eine Anwendung nutzt. + +1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **Sauce Labs**. +1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). +1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **Sauce Labs**. +1. Geben Sie den Benutzernamen ein, der Ihrem Sauce Labs-Konto zugeordnet ist. Sie finden [Ihren Benutzernamen in der Begrüßungsnachricht oben auf Ihrer Sauce Labs-Kontoseite (Link wird in neuem Fenster geöffnet)](https://saucelabs.com/account){: new_window}. +1. Geben Sie den Zugriffsschlüssel für Ihr Sauce Labs-Konto ein. Sie finden [den Schlüssel auf der Sauce Labs-Kontoseite (Link wird in neuem Fenster geöffnet)](https://saucelabs.com/account){: new_window}. +1. Klicken Sie auf **Integration erstellen**. +1. Klicken Sie auf die Kachel für Sauce Labs, um saucelabs.com zu öffnen und die Testaktivität für die Toolchain anzuzeigen. + + **Tipp**: Wenn Sie einen Sauce Labs-Testjob zur {{site.data.keyword.deliverypipeline}} hinzugefügt haben, können Sie die Serviceinstanz auswählen. + +Weitere Informationen finden Sie unter [Sauce Labs (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}. + + +## Slack konfigurieren +{: #slack} + +**Wichtig**: Benachrichtigungen, die in öffentlichen Slack-Kanälen gepostet werden, sind für jeden im Team sichtbar. Denken Sie daran, dass Sie für den Inhalt, den Sie posten, verantwortlich sind. + +Slack ist ein cloudbasiertes echtzeitorientiertes Messaging- und Benachrichtigungssystem. Slack stellt persistenten Chat bereit, wobei es sich um eine interaktivere Alternative zu E-Mail für die Teamzusammenarbeit handelt. Sie können mit Ihrem Team über einen dedizierten Kanal oder über eine Reihe von Kanälen kommunizieren, die in direktem Zusammenhang mit Ihrer Arbeit stehen. Sie können außerdem Dateien und Bilder über die Kanäle oder in direkten Nachrichten zwischen zwei oder mehr Personen teilen. Die Kommunikation in direkten Nachrichten und über die Kanäle wird aufbewahrt und kann durchsucht werden. + +Konfigurieren Sie Slack, um Benachrichtigungen zu Ihrer Toolchain von den Toolintegrationen zu erhalten, z. B. Test- und Bereitstellungsaktivitäten: + +1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf **Slack**. +1. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen, klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+). +1. Klicken Sie im Abschnitt mit den Toolintegrationen auf **Slack**. +1. Geben Sie das API-Authentifizierungstoken für Ihr Slack-Konto ein. Sie müssen ein generiertes Token für uneingeschränkten Zugriff zur Authentifizierung bei Slack verwenden. Anweisungen zum Auffinden des Tokens finden Sie im Abschnitt zur [Slack-Authentifizierung (Link wird in neuem Fenster geöffnet)](https://api.slack.com/web#authentication){: new_window}. +1. Geben Sie den Namen des Slack-Kanals ein, an den die Benachrichtigungen gesendet werden sollen. Falls der Kanal, den Sie angeben, nicht existiert, wird er erstellt. Falls der Kanal archiviert wurde, wird er reaktiviert. +1. Klicken Sie auf **Integration erstellen**. +1. Klicken Sie auf die Kachel für Slack. Sie können alle Aktivitäten für Ihre Toolchain im konfigurierten Slack-Kanal anzeigen. + +Weitere Informationen finden Sie unter [Slack (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}. + + + + + + + + diff --git a/toolchains/nl/de/toolchains_overview.md b/toolchains/nl/de/toolchains_overview.md index fff8a184c..6a269e843 100644 --- a/toolchains/nl/de/toolchains_overview.md +++ b/toolchains/nl/de/toolchains_overview.md @@ -1,160 +1,160 @@ ---- - -Copyright: - Jahre: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Erste Schritte mit Toolchains (Beta) -{: #toolchains_getting_started} - -Letzte Aktualisierung: 7. Oktober 2016 -{: .last-updated} - -Toolchains stehen in öffentlichen und dedizierten {{site.data.keyword.Bluemix}}-Umgebungen (Public bzw. Dedicated) zur Verfügung. Sie können eine Toolchain auf zwei Arten erstellen: Entweder Sie verwenden eine Vorlage zum Erstellen einer Toolchain oder Sie erstellen eine Toolchain aus einer App. Unter {{site.data.keyword.Bluemix_notm}} Public sind Toolchains nur in den USA (Süden) verfügbar. -{: shortdesc} - -##Erste Schritte mit Toolchains: Public -{: #getting_started_public} - -**Anmerkung:** Vergewissern Sie sich, dass Sie in der neuen Bluemix-Version arbeiten. Dies erkennen Sie am oberen Banner. - - * Falls eine Nachricht ausgegeben wird, die Ihnen die Verwendung der neuen Bluemix-Version anbietet, arbeiten Sie mit dem klassischen Zugang von Bluemix. Klicken Sie auf den Link, um die neue Bluemix-Version zu öffnen. - * Wenn keine entsprechende Nachricht angezeigt wird, arbeiten Sie bereits mit der neuen Bluemix-Version. - -Jede Toolchain ist einer bestimmten Organisation zugeordnet und alle Benutzer, die Mitglied dieser Organisation sind, können auf die ihr zugeordneten Toolchains zugreifen. Bevor Sie eine Toolchain erstellen, müssen Sie sicherstellen, dass Sie in der Organisation arbeiten, in der Sie die Toolchain erstellen wollen. Die Organisation, in der Sie gegenwärtig arbeiten, wird in der Menüleiste angezeigt. Um zu einer anderen Organisation zu wechseln, klicken Sie in der Menüleiste auf die Organisation und wählen Sie anschließend die Organisation aus, zu der Sie wechseln möchten. - -###Toolchain aus einer Vorlage erstellen -{: #creating_a_toolchain_from_a_template} - -Sie können eine Vorlage als Ausgangspunkt zum Erstellen einer Toolchain verwenden, die eine bestimmte Gruppe von Toolintegrationen enthält. - -1. Wenn Sie Ihre erste Toolchain erstellen, müssen Sie sicherstellen, dass Toolchains in Ihrer Organisation aktiviert sind: - 1. Öffnen Sie das DevOps-Dashboard und klicken Sie auf die Seite **Toolchains**. - 2. Wenn die Schaltfläche **Toolchains aktivieren** angezeigt wird, klicken Sie sie an und folgen Sie den angezeigten Anweisungen, um Ihre Toolchain zu erstellen. - 3. Wenn die Schaltfläche **Toolchains aktivieren** nicht angezeigt wird, sind die Toolchains bereits aktiviert. Setzen Sie den Vorgang mit Schritt 2 fort. -1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Schaltfläche zum Hinzufügen (+), um eine Toolchain zu erstellen. -1. Klicken Sie auf eine Toolchain-Vorlage. Klicken Sie beispielsweise auf **Microservices-Toolchain**, um ein Onlinegeschäftsmuster zum Erstellen der Toolchain zu verwenden. -1. Überprüfen Sie auf der Seite zum Erstellen der Toolchain das Diagramm der Toolchain, die Sie gerade erstellen. In dem Diagramm wird jede Toolintegration in ihrer aktuellen Lebenszyklusphase in der Toolchain angezeigt. Das Diagramm in der folgenden Abbildung ist ein Beispiel. Wenn Sie eine Toolchain erstellen, zeigt das Diagramm jede Toolintegration an, die Teil der Toolchain ist. -![Diagramm einer Toolchain](images/toolchain_diagram.png) - -1. Überprüfen Sie die Standardinformationen für die Toolchain-Einstellungen. Der Name der Toolchain macht sie in {{site.data.keyword.Bluemix_notm}} identifizierbar. Wenn es bereits eine Toolchain mit diesem Namen gibt oder wenn Sie einen anderen Namen verwenden möchten, ändern Sie den Namen der Toolchain. -1. Wählen Sie im Abschnitt mit den konfigurierbaren Integrationen jede Toolintegration aus, die Sie für Ihre Toolchain konfigurieren möchten. Bestimmte Toolintegrationen erfordern keine Konfiguration. Informationen zum Konfigurieren der Toolintegrationen finden Sie unter [Toolintegrationen konfigurieren (Link wird in neuem Fenster geöffnet)](../toolchains/toolchains_integrations.html){: new_window}. -1. Klicken Sie auf **Erstellen**. Es werden verschiedene Schritte automatisch ausgeführt, um Ihre Toolchain einzurichten: - - * Die Toolchain wird erstellt. - * Falls Sie die Delivery Pipeline-Toolintegration konfiguriert haben, werden die Pipelines aktiviert. - * Falls Sie die Sauce Labs-Toolintegration konfiguriert haben, wird die Sauce Labs-Integration konfiguriert, um Jobs zu Pipelines hinzuzufügen und Tests auszuführen. - * Falls Sie die PagerDuty-Toolintegration konfiguriert haben, wird die PagerDuty-Integration konfiguriert, um Benachrichtigungen an den in Slack konfigurierten Kanal zu senden. Diese Benachrichtigungen weisen auf Probleme hin. - * Falls Sie die Slack-Toolintegration konfiguriert haben, wird die Slack-Integration konfiguriert, um Benachrichtigungen an den in Slack konfigurierten Kanal zu senden. Diese Benachrichtigungen geben den Entwicklungsfortschritt an, z. B. `Verbunden mit Projekt XYZ`, `Pipeline konfiguriert` und `Stage 'Build' gestartet`. - * Falls Sie die GitHub-Toolintegration konfiguriert haben, wird das GitHub-Beispielrepository in Ihr GitHub-Konto geklont. - - -###Toolchain aus einer App erstellen -{: #creating_a_toolchain_from_an_app} - -Sie können eine Toolchain aus Ihrer App erstellen. Die Toolchain kann kontinuierliche Entwicklung, Bereitstellung, Überwachung und mehr unterstützen und sie ist Ihrer App zugeordnet. Jede App kann einer Toolchain zugeordnet sein. Wenn Sie Änderungen per Push-Operation an das GitHub-Repository der Toolchain übertragen, erstellt die Pipeline automatisch Builds und stellt die App bereit. - -1. Wenn Sie Ihre erste Toolchain erstellen, müssen Sie sicherstellen, dass Toolchains in Ihrer Organisation aktiviert sind: - 1. Öffnen Sie das DevOps-Dashboard und klicken Sie auf die Seite **Toolchains**. - 2. Wenn die Schaltfläche **Toolchains aktivieren** angezeigt wird, klicken Sie sie an und folgen Sie den angezeigten Anweisungen, um Ihre Toolchain zu erstellen. - 3. Wenn die Schaltfläche **Toolchains aktivieren** nicht angezeigt wird, sind die Toolchains bereits aktiviert. Setzen Sie den Vorgang mit Schritt 2 fort. -1. Klicken Sie auf der Übersichtsseite Ihrer App auf der Kachel 'Continuous Delivery' auf **Aktivieren**. Alternativ können Sie beim klassischen Zugang von {{site.data.keyword.Bluemix_notm}} in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain hinzufügen** klicken. Ihre App wird für eine kontinuierliche Bereitstellung aus einem neuen GitHub-Repository konfiguriert, in dem der App-Starter-Code angegeben wird. -1. Überprüfen Sie auf der Seite zum Erstellen der Toolchain das Diagramm der Toolchain, die Sie gerade erstellen. In dem Diagramm wird jede Toolintegration in ihrer aktuellen Lebenszyklusphase in der Toolchain angezeigt. -1. Überprüfen Sie die Standardinformationen für die Toolchain-Einstellungen. Der Name der Toolchain macht sie in {{site.data.keyword.Bluemix_notm}} identifizierbar. Wenn es bereits eine Toolchain mit diesem Namen gibt oder wenn Sie einen anderen Namen verwenden möchten, ändern Sie den Namen der Toolchain. -1. Wählen Sie im Abschnitt mit den konfigurierbaren Integrationen jede Toolintegration aus, die Sie für Ihre Toolchain konfigurieren möchten. Bestimmte Toolintegrationen erfordern keine Konfiguration. Informationen zum Konfigurieren der Toolintegrationen finden Sie unter [Toolintegrationen konfigurieren (Link wird in neuem Fenster geöffnet)](../toolchains/toolchains_integrations.html){: new_window}. -1. Klicken Sie auf **Erstellen**. Es werden verschiedene Schritte automatisch ausgeführt, um Ihre Toolchain einzurichten: - - * Die Toolchain wird erstellt. - * Falls Sie die Delivery Pipeline-Toolintegration konfiguriert haben, werden die Pipelines aktiviert. - * Falls Sie die Sauce Labs-Toolintegration konfiguriert haben, wird die Sauce Labs-Integration konfiguriert, um Jobs zu Pipelines hinzuzufügen und Tests auszuführen. - * Falls Sie die PagerDuty-Toolintegration konfiguriert haben, wird die PagerDuty-Integration konfiguriert, um Benachrichtigungen an den in Slack konfigurierten Kanal zu senden. Diese Benachrichtigungen weisen auf Probleme hin. - * Falls Sie die Slack-Toolintegration konfiguriert haben, wird die Slack-Integration konfiguriert, um Benachrichtigungen an den in Slack konfigurierten Kanal zu senden. Diese Benachrichtigungen geben den Entwicklungsfortschritt an, z. B. `Verbunden mit Projekt XYZ`, `Pipeline konfiguriert` und `Stage 'Build' gestartet`. - * Falls Sie die GitHub-Toolintegration konfiguriert haben, wird das GitHub-Beispielrepository in Ihr GitHub-Konto geklont. - - -##Erste Schritte mit Toolchains: Dedicated -{: #getting_started_dedicated} - -Jede Toolchain ist einer bestimmten Organisation zugeordnet und alle Benutzer, die Mitglied dieser Organisation sind, können auf die ihr zugeordneten Toolchains zugreifen. Klicken Sie vor dem Erstellen einer Toolchain auf das Symbol **{{site.data.keyword.avatar}}** ![Avatar-Symbol](../icons/i-avatar-icon.svg) in der Menüleiste, um das Widget 'Konto und Unterstützung' zu öffnen und um die Organisation anzuzeigen, in der Sie arbeiten. Wenn es sich dabei nicht um die Organisation handelt, in der Sie die Toolchain erstellen wollen, müssen Sie zu einer anderen Organisation wechseln. - -###Toolchain aus einer Vorlage erstellen -{: #creating_a_toolchain_from_a_template_dedicated} - -Sie können eine Vorlage als Ausgangspunkt zum Erstellen einer Toolchain verwenden, die eine bestimmte Gruppe von Toolintegrationen enthält. - -1. Wenn Sie Ihre erste Toolchain erstellen, müssen Sie sicherstellen, dass Toolchains in Ihrer Organisation aktiviert sind: - 1. Öffnen Sie das DevOps-Dashboard und klicken Sie auf die Registerkarte **Toolchains**. - 2. Wenn die Schaltfläche **Toolchains aktivieren** angezeigt wird, klicken Sie sie an und folgen Sie den angezeigten Anweisungen, um Ihre Toolchain zu erstellen. - 3. Wenn die Schaltfläche **Toolchains aktivieren** nicht angezeigt wird, sind die Toolchains bereits aktiviert. Setzen Sie den Vorgang mit Schritt 2 fort. -1. Klicken Sie im {{site.data.keyword.Bluemix_notm}}-Dashboard auf der Registerkarte **DEVOPS** auf die Schaltfläche zum Hinzufügen (+), um eine Toolchain zu erstellen. -1. Klicken Sie auf eine Toolchain-Vorlage. Um beispielsweise eine einfache Toolchain zu erstellen, um eine neue Cloud Foundry-App bereitzustellen, klicken Sie auf **Einfache Cloud Foundry-Toolchain**. -1. Überprüfen Sie auf der Seite zum Erstellen der Toolchain das Diagramm der Toolchain, die Sie gerade erstellen. In dem Diagramm wird jede Toolintegration in ihrer aktuellen Lebenszyklusphase in der Toolchain angezeigt. Das Diagramm in der folgenden Abbildung ist ein Beispiel. Wenn Sie eine Toolchain erstellen, zeigt das Diagramm jede Toolintegration an, die Teil der Toolchain ist. -![Dedicated-Toolchain-Diagramm](images/toolchain_dedicated_diagram.png) - -1. Überprüfen Sie die Standardinformationen für die Toolchain-Einstellungen. Der Name der Toolchain macht sie in {{site.data.keyword.Bluemix_notm}} identifizierbar. Wenn es bereits eine Toolchain mit diesem Namen gibt oder wenn Sie einen anderen Namen verwenden möchten, ändern Sie den Namen der Toolchain. -1. Wählen Sie im Abschnitt mit den konfigurierbaren Integrationen jede Toolintegration aus, die Sie für Ihre Toolchain konfigurieren möchten. Bestimmte Toolintegrationen erfordern keine Konfiguration. Informationen zum Konfigurieren der Toolintegrationen finden Sie unter [Toolintegrationen konfigurieren (Link wird in neuem Fenster geöffnet)](../toolchains/toolchains_integrations.html){: new_window}. -1. Klicken Sie auf **Erstellen**. Es werden verschiedene Schritte automatisch ausgeführt, um Ihre Toolchain einzurichten: - - * Die Toolchain wird erstellt. - * Falls Sie die Delivery Pipeline-Toolintegration konfiguriert haben, werden die Pipelines aktiviert. - * Falls Sie die GitHub Enterprise-Toolintegration konfiguriert haben, wird das GitHub Enterprise-Beispielrepository in Ihr GitHub Enterprise-Konto geklont. - - -###Toolchain aus einer App erstellen -{: #creating_a_toolchain_from_an_app_dedicated} - -Sie können eine Toolchain aus Ihrer App erstellen. Die Toolchain kann kontinuierliche Entwicklung, Bereitstellung, Überwachung und mehr unterstützen und sie ist Ihrer App zugeordnet. Jede App kann einer Toolchain zugeordnet sein. Wenn Sie Änderungen per Push-Operation an das GitHub Enterprise-Repository der Toolchain übertragen, erstellt die Pipeline automatisch Builds und stellt die App bereit. - -1. Wenn Sie Ihre erste Toolchain erstellen, müssen Sie sicherstellen, dass Toolchains in Ihrer Organisation aktiviert sind: - 1. Öffnen Sie das DevOps-Dashboard und klicken Sie auf die Registerkarte **Toolchains**. - 2. Wenn die Schaltfläche **Toolchains aktivieren** angezeigt wird, klicken Sie sie an und folgen Sie den angezeigten Anweisungen, um Ihre Toolchain zu erstellen. - 3. Wenn die Schaltfläche **Toolchains aktivieren** nicht angezeigt wird, sind die Toolchains bereits aktiviert. Setzen Sie den Vorgang mit Schritt 2 fort. -1. Klicken Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain hinzufügen**. Ihre App wird für eine kontinuierliche Bereitstellung aus einem neuen GitHub Enterprise-Repository konfiguriert, in dem der App-Starter-Code angegeben wird. -1. Überprüfen Sie auf der Seite zum Erstellen der Toolchain das Diagramm der Toolchain, die Sie gerade erstellen. In dem Diagramm wird jede Toolintegration in ihrer aktuellen Lebenszyklusphase in der Toolchain angezeigt. -1. Überprüfen Sie die Standardinformationen für die Toolchain-Einstellungen. Der Name der Toolchain macht sie in {{site.data.keyword.Bluemix_notm}} identifizierbar. Wenn es bereits eine Toolchain mit diesem Namen gibt oder wenn Sie einen anderen Namen verwenden möchten, ändern Sie den Namen der Toolchain. -1. Wählen Sie im Abschnitt mit den konfigurierbaren Integrationen jede Toolintegration aus, die Sie für Ihre Toolchain konfigurieren möchten. Bestimmte Toolintegrationen erfordern keine Konfiguration. Informationen zum Konfigurieren der Toolintegrationen finden Sie unter [Toolintegrationen konfigurieren (Link wird in neuem Fenster geöffnet)](../toolchains/toolchains_integrations.html){: new_window}. -1. Klicken Sie auf **Erstellen**. Es werden verschiedene Schritte automatisch ausgeführt, um Ihre Toolchain einzurichten: - - * Die Toolchain wird erstellt. - * Falls Sie die Delivery Pipeline-Toolintegration konfiguriert haben, werden die Pipelines aktiviert. - * Falls Sie die GitHub Enterprise-Toolintegration konfiguriert haben, wird das GitHub Enterprise-Beispielrepository in Ihr GitHub Enterprise-Konto geklont. - - -##Toolchain anzeigen -{: #viewing_a_toolchain} - -Nachdem Sie die Toolchain und die zugehörigen Toolintegrationen konfiguriert haben, können Sie eine grafische Darstellung der Toolchain auf der Seite mit den Toolintegrationen anzeigen. - -* Klicken Sie bei Verwendung von {{site.data.keyword.Bluemix_notm}} Public im DevOps-Dashboard auf der Seite **Toolchains** auf eine Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. - -* Wenn Sie {{site.data.keyword.Bluemix_notm}} Dedicated verwenden, klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. - -* Um auf eine Toolintegration in Ihrer Toolchain zuzugreifen, klicken Sie auf die Kachel des entsprechenden Tools. - - **Tipp**: Wenn Sie über mehr als ein GitHub Enterprise-Repository verfügen, kann es für dieselbe Toolintegration mehrere Kacheln geben, da jedes Repository durch eine eigene Kachel dargestellt wird. - - - - - -# Zugehörige Links -{: #rellinks} - -## Lernprogramme und Beispiele -{: #samples} - -* [Create an application with three microservices (Beta) (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} -* [Create a toolchain from a template on {{site.data.keyword.Bluemix_notm}} Dedicated (Betaversion) (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} -* [Create a toolchain from an app on {{site.data.keyword.Bluemix_notm}} Dedicated (Betaversion) (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} - -## Zugehörige Links -{: #general} - -* [Microservices toolchain (Beta) (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} -* [Simple toolchain (Beta) (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} -* [IBM Bluemix Garage Method (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method){:new_window} +--- + +Copyright: + Jahre: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Erste Schritte mit Toolchains (Beta) +{: #toolchains_getting_started} + +Letzte Aktualisierung: 7. Oktober 2016 +{: .last-updated} + +Toolchains stehen in öffentlichen und dedizierten {{site.data.keyword.Bluemix}}-Umgebungen (Public bzw. Dedicated) zur Verfügung. Sie können eine Toolchain auf zwei Arten erstellen: Entweder Sie verwenden eine Vorlage zum Erstellen einer Toolchain oder Sie erstellen eine Toolchain aus einer App. Unter {{site.data.keyword.Bluemix_notm}} Public sind Toolchains nur in den USA (Süden) verfügbar. +{: shortdesc} + +##Erste Schritte mit Toolchains: Public +{: #getting_started_public} + +**Anmerkung:** Vergewissern Sie sich, dass Sie in der neuen Bluemix-Version arbeiten. Dies erkennen Sie am oberen Banner. + + * Falls eine Nachricht ausgegeben wird, die Ihnen die Verwendung der neuen Bluemix-Version anbietet, arbeiten Sie mit dem klassischen Zugang von Bluemix. Klicken Sie auf den Link, um die neue Bluemix-Version zu öffnen. + * Wenn keine entsprechende Nachricht angezeigt wird, arbeiten Sie bereits mit der neuen Bluemix-Version. + +Jede Toolchain ist einer bestimmten Organisation zugeordnet und alle Benutzer, die Mitglied dieser Organisation sind, können auf die ihr zugeordneten Toolchains zugreifen. Bevor Sie eine Toolchain erstellen, müssen Sie sicherstellen, dass Sie in der Organisation arbeiten, in der Sie die Toolchain erstellen wollen. Die Organisation, in der Sie gegenwärtig arbeiten, wird in der Menüleiste angezeigt. Um zu einer anderen Organisation zu wechseln, klicken Sie in der Menüleiste auf die Organisation und wählen Sie anschließend die Organisation aus, zu der Sie wechseln möchten. + +###Toolchain aus einer Vorlage erstellen +{: #creating_a_toolchain_from_a_template} + +Sie können eine Vorlage als Ausgangspunkt zum Erstellen einer Toolchain verwenden, die eine bestimmte Gruppe von Toolintegrationen enthält. + +1. Wenn Sie Ihre erste Toolchain erstellen, müssen Sie sicherstellen, dass Toolchains in Ihrer Organisation aktiviert sind: + 1. Öffnen Sie das DevOps-Dashboard und klicken Sie auf die Seite **Toolchains**. + 2. Wenn die Schaltfläche **Toolchains aktivieren** angezeigt wird, klicken Sie sie an und folgen Sie den angezeigten Anweisungen, um Ihre Toolchain zu erstellen. + 3. Wenn die Schaltfläche **Toolchains aktivieren** nicht angezeigt wird, sind die Toolchains bereits aktiviert. Setzen Sie den Vorgang mit Schritt 2 fort. +1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die Schaltfläche zum Hinzufügen (+), um eine Toolchain zu erstellen. +1. Klicken Sie auf eine Toolchain-Vorlage. Klicken Sie beispielsweise auf **Microservices-Toolchain**, um ein Onlinegeschäftsmuster zum Erstellen der Toolchain zu verwenden. +1. Überprüfen Sie auf der Seite zum Erstellen der Toolchain das Diagramm der Toolchain, die Sie gerade erstellen. In dem Diagramm wird jede Toolintegration in ihrer aktuellen Lebenszyklusphase in der Toolchain angezeigt. Das Diagramm in der folgenden Abbildung ist ein Beispiel. Wenn Sie eine Toolchain erstellen, zeigt das Diagramm jede Toolintegration an, die Teil der Toolchain ist. +![Diagramm einer Toolchain](images/toolchain_diagram.png) + +1. Überprüfen Sie die Standardinformationen für die Toolchain-Einstellungen. Der Name der Toolchain macht sie in {{site.data.keyword.Bluemix_notm}} identifizierbar. Wenn es bereits eine Toolchain mit diesem Namen gibt oder wenn Sie einen anderen Namen verwenden möchten, ändern Sie den Namen der Toolchain. +1. Wählen Sie im Abschnitt mit den konfigurierbaren Integrationen jede Toolintegration aus, die Sie für Ihre Toolchain konfigurieren möchten. Bestimmte Toolintegrationen erfordern keine Konfiguration. Informationen zum Konfigurieren der Toolintegrationen finden Sie unter [Toolintegrationen konfigurieren (Link wird in neuem Fenster geöffnet)](../toolchains/toolchains_integrations.html){: new_window}. +1. Klicken Sie auf **Erstellen**. Es werden verschiedene Schritte automatisch ausgeführt, um Ihre Toolchain einzurichten: + + * Die Toolchain wird erstellt. + * Falls Sie die Delivery Pipeline-Toolintegration konfiguriert haben, werden die Pipelines aktiviert. + * Falls Sie die Sauce Labs-Toolintegration konfiguriert haben, wird die Sauce Labs-Integration konfiguriert, um Jobs zu Pipelines hinzuzufügen und Tests auszuführen. + * Falls Sie die PagerDuty-Toolintegration konfiguriert haben, wird die PagerDuty-Integration konfiguriert, um Benachrichtigungen an den in Slack konfigurierten Kanal zu senden. Diese Benachrichtigungen weisen auf Probleme hin. + * Falls Sie die Slack-Toolintegration konfiguriert haben, wird die Slack-Integration konfiguriert, um Benachrichtigungen an den in Slack konfigurierten Kanal zu senden. Diese Benachrichtigungen geben den Entwicklungsfortschritt an, z. B. `Verbunden mit Projekt XYZ`, `Pipeline konfiguriert` und `Stage 'Build' gestartet`. + * Falls Sie die GitHub-Toolintegration konfiguriert haben, wird das GitHub-Beispielrepository in Ihr GitHub-Konto geklont. + + +###Toolchain aus einer App erstellen +{: #creating_a_toolchain_from_an_app} + +Sie können eine Toolchain aus Ihrer App erstellen. Die Toolchain kann kontinuierliche Entwicklung, Bereitstellung, Überwachung und mehr unterstützen und sie ist Ihrer App zugeordnet. Jede App kann einer Toolchain zugeordnet sein. Wenn Sie Änderungen per Push-Operation an das GitHub-Repository der Toolchain übertragen, erstellt die Pipeline automatisch Builds und stellt die App bereit. + +1. Wenn Sie Ihre erste Toolchain erstellen, müssen Sie sicherstellen, dass Toolchains in Ihrer Organisation aktiviert sind: + 1. Öffnen Sie das DevOps-Dashboard und klicken Sie auf die Seite **Toolchains**. + 2. Wenn die Schaltfläche **Toolchains aktivieren** angezeigt wird, klicken Sie sie an und folgen Sie den angezeigten Anweisungen, um Ihre Toolchain zu erstellen. + 3. Wenn die Schaltfläche **Toolchains aktivieren** nicht angezeigt wird, sind die Toolchains bereits aktiviert. Setzen Sie den Vorgang mit Schritt 2 fort. +1. Klicken Sie auf der Übersichtsseite Ihrer App auf der Kachel 'Continuous Delivery' auf **Aktivieren**. Alternativ können Sie beim klassischen Zugang von {{site.data.keyword.Bluemix_notm}} in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain hinzufügen** klicken. Ihre App wird für eine kontinuierliche Bereitstellung aus einem neuen GitHub-Repository konfiguriert, in dem der App-Starter-Code angegeben wird. +1. Überprüfen Sie auf der Seite zum Erstellen der Toolchain das Diagramm der Toolchain, die Sie gerade erstellen. In dem Diagramm wird jede Toolintegration in ihrer aktuellen Lebenszyklusphase in der Toolchain angezeigt. +1. Überprüfen Sie die Standardinformationen für die Toolchain-Einstellungen. Der Name der Toolchain macht sie in {{site.data.keyword.Bluemix_notm}} identifizierbar. Wenn es bereits eine Toolchain mit diesem Namen gibt oder wenn Sie einen anderen Namen verwenden möchten, ändern Sie den Namen der Toolchain. +1. Wählen Sie im Abschnitt mit den konfigurierbaren Integrationen jede Toolintegration aus, die Sie für Ihre Toolchain konfigurieren möchten. Bestimmte Toolintegrationen erfordern keine Konfiguration. Informationen zum Konfigurieren der Toolintegrationen finden Sie unter [Toolintegrationen konfigurieren (Link wird in neuem Fenster geöffnet)](../toolchains/toolchains_integrations.html){: new_window}. +1. Klicken Sie auf **Erstellen**. Es werden verschiedene Schritte automatisch ausgeführt, um Ihre Toolchain einzurichten: + + * Die Toolchain wird erstellt. + * Falls Sie die Delivery Pipeline-Toolintegration konfiguriert haben, werden die Pipelines aktiviert. + * Falls Sie die Sauce Labs-Toolintegration konfiguriert haben, wird die Sauce Labs-Integration konfiguriert, um Jobs zu Pipelines hinzuzufügen und Tests auszuführen. + * Falls Sie die PagerDuty-Toolintegration konfiguriert haben, wird die PagerDuty-Integration konfiguriert, um Benachrichtigungen an den in Slack konfigurierten Kanal zu senden. Diese Benachrichtigungen weisen auf Probleme hin. + * Falls Sie die Slack-Toolintegration konfiguriert haben, wird die Slack-Integration konfiguriert, um Benachrichtigungen an den in Slack konfigurierten Kanal zu senden. Diese Benachrichtigungen geben den Entwicklungsfortschritt an, z. B. `Verbunden mit Projekt XYZ`, `Pipeline konfiguriert` und `Stage 'Build' gestartet`. + * Falls Sie die GitHub-Toolintegration konfiguriert haben, wird das GitHub-Beispielrepository in Ihr GitHub-Konto geklont. + + +##Erste Schritte mit Toolchains: Dedicated +{: #getting_started_dedicated} + +Jede Toolchain ist einer bestimmten Organisation zugeordnet und alle Benutzer, die Mitglied dieser Organisation sind, können auf die ihr zugeordneten Toolchains zugreifen. Klicken Sie vor dem Erstellen einer Toolchain auf das Symbol **{{site.data.keyword.avatar}}** ![Avatar-Symbol](../icons/i-avatar-icon.svg) in der Menüleiste, um das Widget 'Konto und Unterstützung' zu öffnen und um die Organisation anzuzeigen, in der Sie arbeiten. Wenn es sich dabei nicht um die Organisation handelt, in der Sie die Toolchain erstellen wollen, müssen Sie zu einer anderen Organisation wechseln. + +###Toolchain aus einer Vorlage erstellen +{: #creating_a_toolchain_from_a_template_dedicated} + +Sie können eine Vorlage als Ausgangspunkt zum Erstellen einer Toolchain verwenden, die eine bestimmte Gruppe von Toolintegrationen enthält. + +1. Wenn Sie Ihre erste Toolchain erstellen, müssen Sie sicherstellen, dass Toolchains in Ihrer Organisation aktiviert sind: + 1. Öffnen Sie das DevOps-Dashboard und klicken Sie auf die Registerkarte **Toolchains**. + 2. Wenn die Schaltfläche **Toolchains aktivieren** angezeigt wird, klicken Sie sie an und folgen Sie den angezeigten Anweisungen, um Ihre Toolchain zu erstellen. + 3. Wenn die Schaltfläche **Toolchains aktivieren** nicht angezeigt wird, sind die Toolchains bereits aktiviert. Setzen Sie den Vorgang mit Schritt 2 fort. +1. Klicken Sie im {{site.data.keyword.Bluemix_notm}}-Dashboard auf der Registerkarte **DEVOPS** auf die Schaltfläche zum Hinzufügen (+), um eine Toolchain zu erstellen. +1. Klicken Sie auf eine Toolchain-Vorlage. Um beispielsweise eine einfache Toolchain zu erstellen, um eine neue Cloud Foundry-App bereitzustellen, klicken Sie auf **Einfache Cloud Foundry-Toolchain**. +1. Überprüfen Sie auf der Seite zum Erstellen der Toolchain das Diagramm der Toolchain, die Sie gerade erstellen. In dem Diagramm wird jede Toolintegration in ihrer aktuellen Lebenszyklusphase in der Toolchain angezeigt. Das Diagramm in der folgenden Abbildung ist ein Beispiel. Wenn Sie eine Toolchain erstellen, zeigt das Diagramm jede Toolintegration an, die Teil der Toolchain ist. +![Dedicated-Toolchain-Diagramm](images/toolchain_dedicated_diagram.png) + +1. Überprüfen Sie die Standardinformationen für die Toolchain-Einstellungen. Der Name der Toolchain macht sie in {{site.data.keyword.Bluemix_notm}} identifizierbar. Wenn es bereits eine Toolchain mit diesem Namen gibt oder wenn Sie einen anderen Namen verwenden möchten, ändern Sie den Namen der Toolchain. +1. Wählen Sie im Abschnitt mit den konfigurierbaren Integrationen jede Toolintegration aus, die Sie für Ihre Toolchain konfigurieren möchten. Bestimmte Toolintegrationen erfordern keine Konfiguration. Informationen zum Konfigurieren der Toolintegrationen finden Sie unter [Toolintegrationen konfigurieren (Link wird in neuem Fenster geöffnet)](../toolchains/toolchains_integrations.html){: new_window}. +1. Klicken Sie auf **Erstellen**. Es werden verschiedene Schritte automatisch ausgeführt, um Ihre Toolchain einzurichten: + + * Die Toolchain wird erstellt. + * Falls Sie die Delivery Pipeline-Toolintegration konfiguriert haben, werden die Pipelines aktiviert. + * Falls Sie die GitHub Enterprise-Toolintegration konfiguriert haben, wird das GitHub Enterprise-Beispielrepository in Ihr GitHub Enterprise-Konto geklont. + + +###Toolchain aus einer App erstellen +{: #creating_a_toolchain_from_an_app_dedicated} + +Sie können eine Toolchain aus Ihrer App erstellen. Die Toolchain kann kontinuierliche Entwicklung, Bereitstellung, Überwachung und mehr unterstützen und sie ist Ihrer App zugeordnet. Jede App kann einer Toolchain zugeordnet sein. Wenn Sie Änderungen per Push-Operation an das GitHub Enterprise-Repository der Toolchain übertragen, erstellt die Pipeline automatisch Builds und stellt die App bereit. + +1. Wenn Sie Ihre erste Toolchain erstellen, müssen Sie sicherstellen, dass Toolchains in Ihrer Organisation aktiviert sind: + 1. Öffnen Sie das DevOps-Dashboard und klicken Sie auf die Registerkarte **Toolchains**. + 2. Wenn die Schaltfläche **Toolchains aktivieren** angezeigt wird, klicken Sie sie an und folgen Sie den angezeigten Anweisungen, um Ihre Toolchain zu erstellen. + 3. Wenn die Schaltfläche **Toolchains aktivieren** nicht angezeigt wird, sind die Toolchains bereits aktiviert. Setzen Sie den Vorgang mit Schritt 2 fort. +1. Klicken Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain hinzufügen**. Ihre App wird für eine kontinuierliche Bereitstellung aus einem neuen GitHub Enterprise-Repository konfiguriert, in dem der App-Starter-Code angegeben wird. +1. Überprüfen Sie auf der Seite zum Erstellen der Toolchain das Diagramm der Toolchain, die Sie gerade erstellen. In dem Diagramm wird jede Toolintegration in ihrer aktuellen Lebenszyklusphase in der Toolchain angezeigt. +1. Überprüfen Sie die Standardinformationen für die Toolchain-Einstellungen. Der Name der Toolchain macht sie in {{site.data.keyword.Bluemix_notm}} identifizierbar. Wenn es bereits eine Toolchain mit diesem Namen gibt oder wenn Sie einen anderen Namen verwenden möchten, ändern Sie den Namen der Toolchain. +1. Wählen Sie im Abschnitt mit den konfigurierbaren Integrationen jede Toolintegration aus, die Sie für Ihre Toolchain konfigurieren möchten. Bestimmte Toolintegrationen erfordern keine Konfiguration. Informationen zum Konfigurieren der Toolintegrationen finden Sie unter [Toolintegrationen konfigurieren (Link wird in neuem Fenster geöffnet)](../toolchains/toolchains_integrations.html){: new_window}. +1. Klicken Sie auf **Erstellen**. Es werden verschiedene Schritte automatisch ausgeführt, um Ihre Toolchain einzurichten: + + * Die Toolchain wird erstellt. + * Falls Sie die Delivery Pipeline-Toolintegration konfiguriert haben, werden die Pipelines aktiviert. + * Falls Sie die GitHub Enterprise-Toolintegration konfiguriert haben, wird das GitHub Enterprise-Beispielrepository in Ihr GitHub Enterprise-Konto geklont. + + +##Toolchain anzeigen +{: #viewing_a_toolchain} + +Nachdem Sie die Toolchain und die zugehörigen Toolintegrationen konfiguriert haben, können Sie eine grafische Darstellung der Toolchain auf der Seite mit den Toolintegrationen anzeigen. + +* Klicken Sie bei Verwendung von {{site.data.keyword.Bluemix_notm}} Public im DevOps-Dashboard auf der Seite **Toolchains** auf eine Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. + +* Wenn Sie {{site.data.keyword.Bluemix_notm}} Dedicated verwenden, klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen zu öffnen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. + +* Um auf eine Toolintegration in Ihrer Toolchain zuzugreifen, klicken Sie auf die Kachel des entsprechenden Tools. + + **Tipp**: Wenn Sie über mehr als ein GitHub Enterprise-Repository verfügen, kann es für dieselbe Toolintegration mehrere Kacheln geben, da jedes Repository durch eine eigene Kachel dargestellt wird. + + + + + +# Zugehörige Links +{: #rellinks} + +## Lernprogramme und Beispiele +{: #samples} + +* [Create an application with three microservices (Beta) (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} +* [Create a toolchain from a template on {{site.data.keyword.Bluemix_notm}} Dedicated (Betaversion) (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} +* [Create a toolchain from an app on {{site.data.keyword.Bluemix_notm}} Dedicated (Betaversion) (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} + +## Zugehörige Links +{: #general} + +* [Microservices toolchain (Beta) (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} +* [Simple toolchain (Beta) (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} +* [IBM Bluemix Garage Method (Link wird in neuem Fenster geöffnet)](https://www.ibm.com/devops/method){:new_window} diff --git a/toolchains/nl/de/toolchains_using.md b/toolchains/nl/de/toolchains_using.md index e03d75ed1..52dcc16f6 100644 --- a/toolchains/nl/de/toolchains_using.md +++ b/toolchains/nl/de/toolchains_using.md @@ -1,97 +1,97 @@ ---- - -Copyright: - Jahre: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Toolchains unter {{site.data.keyword.Bluemix_notm}} Public verwenden -{: #toolchains-using} - -Letzte Aktualisierung: 7. Oktober 2016 -{: .last-updated} - -Mithilfe einer Toolchain können Sie Ihre täglichen Entwicklungs-, Bereitstellungs- und Systemaufgaben produktiv abwickeln. Nach dem Einrichten einer Toolchain können Sie Toolintegrationen hinzufügen, löschen oder konfigurieren sowie den Zugriff auf die Toolchain verwalten. Toolchains sind nur in den USA (Süden) verfügbar. -{: shortdesc} - -**Anmerkung:** Vergewissern Sie sich, dass Sie in der neuen Bluemix-Version arbeiten. Dies erkennen Sie am oberen Banner. - - * Falls eine Nachricht ausgegeben wird, die Ihnen die Verwendung der neuen Bluemix-Version anbietet, arbeiten Sie mit dem klassischen Zugang von Bluemix. Klicken Sie auf den Link, um die neue Bluemix-Version zu öffnen. - * Wenn keine entsprechende Nachricht angezeigt wird, arbeiten Sie bereits mit der neuen Bluemix-Version. - -## Toolintegration konfigurieren -{: #configuring_a_tool_integration} - -Wenn Sie die Konfiguration einer Toolintegration beim Erstellen einer Toolchain noch nicht vorgenommen haben, wird eine Schaltfläche **Konfigurieren** auf der zugehörigen Kachel angezeigt. Wenn Sie beim Erstellen einer Toolchain eine Toolintegration konfiguriert haben, können Sie die Konfigurationseinstellungen aktualisieren. - -1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf eine Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** und dann auf **Toolintegrationen** klicken. -1. Wenn Sie eine Toolintegration erstmalig konfigurieren müssen, klicken Sie auf der zugehörigen Kachel auf **Konfigurieren**. - - ![Schaltfläche 'Konfigurieren'](images/toolchain_tile_configure.png) - - Wenn Sie die Konfiguration der Toolintegration abgeschlossen haben, klicken Sie auf **Integration speichern**. - -1. Wenn Sie die Konfiguration einer Toolintegration aktualisieren müssen, klicken Sie auf der zugehörigen Kachel auf das Menü für den Zugriff auf die Konfigurationsoptionen. - - ![Konfigurationsmenü](images/toolchain_tile_menu.png) - - Wenn Sie die Aktualisierung der Einstellungen abgeschlossen haben, klicken Sie auf **Integration speichern**. - -## Toolintegration hinzufügen -{: #adding_a_tool_integration} - -Sie können Toolintegrationen für Ihre Toolchain hinzufügen und konfigurieren. - -1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf eine Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** und dann auf **Toolintegrationen** klicken. -1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+), um eine Liste von hinzuzufügenden Toolintegrationen anzuzeigen. -1. Klicken Sie auf eine Toolintegration, die Sie hinzufügen möchten. -1. Geben Sie alle erforderlichen Informationen zum Konfigurieren der Toolintegration ein. -1. Klicken Sie auf **Integration erstellen**, um die Toolintegration zu Ihrer Toolchain hinzuzufügen. - -## Toolintegration löschen -{: #deleting_a_tool_integration} - -Wenn Sie eine Toolintegration aus Ihrer Toolchain löschen, kann diese Löschung nicht mehr rückgängig gemacht werden. - -1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf eine Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** und dann auf **Toolintegrationen** klicken. -1. Klicken Sie auf der Kachel für die Toolintegration, die Sie löschen möchten, auf das Menü für den Zugriff auf die Konfigurationsoptionen. -1. Klicken Sie auf **Löschen**, um die Toolintegration aus Ihrer Toolchain zu löschen. -1. Bestätigen Sie dies, indem Sie nochmals auf **Löschen** klicken. - -## Zugriff verwalten -{: #managing_access} - -Sie können Benutzern Zugriff auf eine Toolchain gewähren, indem Sie sie zu der Organisation hinzufügen, der die Toolchain zugeordnet ist. Jede Toolchain ist einer bestimmten Organisation zugeordnet und alle Benutzer, die Mitglied dieser Organisation sind, können auf die zugeordneten Toolchains zugreifen. Die Organisation, in der Sie gegenwärtig arbeiten, wird in der Menüleiste angezeigt. Klicken Sie auf die Organisation und wechseln Sie zu einer anderen Organisation, um auf andere Toolchains zugreifen zu können. - - - - - -1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die zu verwaltende Toolchain und klicken Sie dann auf **Verwalten**. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** und dann auf **Verwalten** klicken. -1. Klicken Sie auf den Link zu Ihrer Organisation. -1. Klicken Sie auf der Seite 'Organisationen verwalten' auf **Benutzer einladen** und geben Sie die E-Mail-Adresse des Benutzers ein. -1. Wenn Sie erweiterte Berechtigungen zur Verwaltung von Benutzern in {{site.data.keyword.Bluemix_notm}}-Organisationen erteilen möchten, wählen Sie mindestens eines der folgenden Kontrollkästchen aus: **Manager**, **Abrechnungsmanager** und **Auditor**. -1. Klicken Sie auf **EINLADEN**. -1. Klicken Sie auf **SPEICHERN**. - -## Toolchain löschen -{: #deleting_a_toolchain} - -Sie können eine Toolchain löschen und angeben, welche der zugehörigen Toolintegrationen ebenfalls gelöscht werden sollen. Wenn Sie eine Toolchain löschen, kann diese Löschung nicht mehr rückgängig gemacht werden. - -1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die zu löschende Toolchain und klicken Sie dann auf **Verwalten**. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** und dann auf **Verwalten** klicken. -1. Klicken Sie auf **Toolchain löschen** und überprüfen oder ändern Sie die zu löschenden Toolintegrationen. -1. Bestätigen Sie das Löschen, indem Sie den Namen der Toolchain eingeben und auf **Löschen** klicken. - - **Tipp**: Wenn Sie eine GitHub-Toolintegration löschen, wird das zugeordnete GitHub-Repository nicht aus GitHub gelöscht. Sie müssen das Repository manuell aus GitHub entfernen. +--- + +Copyright: + Jahre: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Toolchains unter {{site.data.keyword.Bluemix_notm}} Public verwenden +{: #toolchains-using} + +Letzte Aktualisierung: 7. Oktober 2016 +{: .last-updated} + +Mithilfe einer Toolchain können Sie Ihre täglichen Entwicklungs-, Bereitstellungs- und Systemaufgaben produktiv abwickeln. Nach dem Einrichten einer Toolchain können Sie Toolintegrationen hinzufügen, löschen oder konfigurieren sowie den Zugriff auf die Toolchain verwalten. Toolchains sind nur in den USA (Süden) verfügbar. +{: shortdesc} + +**Anmerkung:** Vergewissern Sie sich, dass Sie in der neuen Bluemix-Version arbeiten. Dies erkennen Sie am oberen Banner. + + * Falls eine Nachricht ausgegeben wird, die Ihnen die Verwendung der neuen Bluemix-Version anbietet, arbeiten Sie mit dem klassischen Zugang von Bluemix. Klicken Sie auf den Link, um die neue Bluemix-Version zu öffnen. + * Wenn keine entsprechende Nachricht angezeigt wird, arbeiten Sie bereits mit der neuen Bluemix-Version. + +## Toolintegration konfigurieren +{: #configuring_a_tool_integration} + +Wenn Sie die Konfiguration einer Toolintegration beim Erstellen einer Toolchain noch nicht vorgenommen haben, wird eine Schaltfläche **Konfigurieren** auf der zugehörigen Kachel angezeigt. Wenn Sie beim Erstellen einer Toolchain eine Toolintegration konfiguriert haben, können Sie die Konfigurationseinstellungen aktualisieren. + +1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf eine Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** und dann auf **Toolintegrationen** klicken. +1. Wenn Sie eine Toolintegration erstmalig konfigurieren müssen, klicken Sie auf der zugehörigen Kachel auf **Konfigurieren**. + + ![Schaltfläche 'Konfigurieren'](images/toolchain_tile_configure.png) + + Wenn Sie die Konfiguration der Toolintegration abgeschlossen haben, klicken Sie auf **Integration speichern**. + +1. Wenn Sie die Konfiguration einer Toolintegration aktualisieren müssen, klicken Sie auf der zugehörigen Kachel auf das Menü für den Zugriff auf die Konfigurationsoptionen. + + ![Konfigurationsmenü](images/toolchain_tile_menu.png) + + Wenn Sie die Aktualisierung der Einstellungen abgeschlossen haben, klicken Sie auf **Integration speichern**. + +## Toolintegration hinzufügen +{: #adding_a_tool_integration} + +Sie können Toolintegrationen für Ihre Toolchain hinzufügen und konfigurieren. + +1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf eine Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** und dann auf **Toolintegrationen** klicken. +1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+), um eine Liste von hinzuzufügenden Toolintegrationen anzuzeigen. +1. Klicken Sie auf eine Toolintegration, die Sie hinzufügen möchten. +1. Geben Sie alle erforderlichen Informationen zum Konfigurieren der Toolintegration ein. +1. Klicken Sie auf **Integration erstellen**, um die Toolintegration zu Ihrer Toolchain hinzuzufügen. + +## Toolintegration löschen +{: #deleting_a_tool_integration} + +Wenn Sie eine Toolintegration aus Ihrer Toolchain löschen, kann diese Löschung nicht mehr rückgängig gemacht werden. + +1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf eine Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** und dann auf **Toolintegrationen** klicken. +1. Klicken Sie auf der Kachel für die Toolintegration, die Sie löschen möchten, auf das Menü für den Zugriff auf die Konfigurationsoptionen. +1. Klicken Sie auf **Löschen**, um die Toolintegration aus Ihrer Toolchain zu löschen. +1. Bestätigen Sie dies, indem Sie nochmals auf **Löschen** klicken. + +## Zugriff verwalten +{: #managing_access} + +Sie können Benutzern Zugriff auf eine Toolchain gewähren, indem Sie sie zu der Organisation hinzufügen, der die Toolchain zugeordnet ist. Jede Toolchain ist einer bestimmten Organisation zugeordnet und alle Benutzer, die Mitglied dieser Organisation sind, können auf die zugeordneten Toolchains zugreifen. Die Organisation, in der Sie gegenwärtig arbeiten, wird in der Menüleiste angezeigt. Klicken Sie auf die Organisation und wechseln Sie zu einer anderen Organisation, um auf andere Toolchains zugreifen zu können. + + + + + +1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die zu verwaltende Toolchain und klicken Sie dann auf **Verwalten**. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** und dann auf **Verwalten** klicken. +1. Klicken Sie auf den Link zu Ihrer Organisation. +1. Klicken Sie auf der Seite 'Organisationen verwalten' auf **Benutzer einladen** und geben Sie die E-Mail-Adresse des Benutzers ein. +1. Wenn Sie erweiterte Berechtigungen zur Verwaltung von Benutzern in {{site.data.keyword.Bluemix_notm}}-Organisationen erteilen möchten, wählen Sie mindestens eines der folgenden Kontrollkästchen aus: **Manager**, **Abrechnungsmanager** und **Auditor**. +1. Klicken Sie auf **EINLADEN**. +1. Klicken Sie auf **SPEICHERN**. + +## Toolchain löschen +{: #deleting_a_toolchain} + +Sie können eine Toolchain löschen und angeben, welche der zugehörigen Toolintegrationen ebenfalls gelöscht werden sollen. Wenn Sie eine Toolchain löschen, kann diese Löschung nicht mehr rückgängig gemacht werden. + +1. Klicken Sie im DevOps-Dashboard auf der Seite **Toolchains** auf die zu löschende Toolchain und klicken Sie dann auf **Verwalten**. Alternativ können Sie auf der Übersichtsseite der App auf der Kachel 'Continuous Delivery' auf **Toolchain anzeigen** und dann auf **Verwalten** klicken. +1. Klicken Sie auf **Toolchain löschen** und überprüfen oder ändern Sie die zu löschenden Toolintegrationen. +1. Bestätigen Sie das Löschen, indem Sie den Namen der Toolchain eingeben und auf **Löschen** klicken. + + **Tipp**: Wenn Sie eine GitHub-Toolintegration löschen, wird das zugeordnete GitHub-Repository nicht aus GitHub gelöscht. Sie müssen das Repository manuell aus GitHub entfernen. diff --git a/toolchains/nl/de/toolchains_using_dedicated.md b/toolchains/nl/de/toolchains_using_dedicated.md index 61044129b..895316bb4 100644 --- a/toolchains/nl/de/toolchains_using_dedicated.md +++ b/toolchains/nl/de/toolchains_using_dedicated.md @@ -1,84 +1,84 @@ ---- - -Copyright: - Jahre: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Toolchains unter {{site.data.keyword.Bluemix_notm}} Dedicated verwenden -{: #toolchains-using_dedicated} - -Letzte Aktualisierung: 13. September 2016 -{: .last-updated} - -Mithilfe einer Toolchain können Sie Ihre täglichen Entwicklungs-, Bereitstellungs- und Systemaufgaben produktiv abwickeln. Nach dem Einrichten einer Toolchain können Sie Toolintegrationen hinzufügen, löschen oder konfigurieren sowie den Zugriff auf die Toolchain verwalten. -{: shortdesc} - -## Toolintegration konfigurieren -{: #configuring_a_tool_integration_dedicated} - -Wenn Sie die Konfiguration einer Toolintegration beim Erstellen einer Toolchain noch nicht vorgenommen haben, wird eine Schaltfläche **Konfigurieren** auf der zugehörigen Kachel angezeigt. Wenn Sie beim Erstellen einer Toolchain eine Toolintegration konfiguriert haben, können Sie die Konfigurationseinstellungen aktualisieren. - -1. Klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Wenn Sie eine Toolintegration erstmalig konfigurieren müssen, klicken Sie auf der zugehörigen Kachel auf **Konfigurieren**. - - ![Schaltfläche 'Konfigurieren'](images/toolchain_tile_configure.png) - - Wenn Sie die Konfiguration der Toolintegration abgeschlossen haben, klicken Sie auf **Integration speichern**. - -1. Wenn Sie die Konfiguration einer Toolintegration aktualisieren müssen, klicken Sie auf der zugehörigen Kachel auf das Menü für den Zugriff auf die Konfigurationsoptionen. - - ![Konfigurationsmenü](images/toolchain_tile_menu.png) - - Wenn Sie die Aktualisierung der Einstellungen abgeschlossen haben, klicken Sie auf **Integration speichern**. - -## Toolintegration hinzufügen -{: #adding_a_tool_integration_dedicated} - -Sie können Toolintegrationen für Ihre Toolchain hinzufügen und konfigurieren. - -1. Klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+), um eine Liste von hinzuzufügenden Toolintegrationen anzuzeigen. -1. Klicken Sie auf die Toolintegration, die Sie hinzufügen möchten. -1. Geben Sie alle erforderlichen Informationen zum Konfigurieren der Toolintegration ein. -1. Klicken Sie auf **Integration erstellen**, um die Toolintegration zu Ihrer Toolchain hinzuzufügen. - -## Toolintegration löschen -{: #deleting_a_tool_integration} - -Wenn Sie eine Toolintegration aus Ihrer Toolchain löschen, kann diese Löschung nicht mehr rückgängig gemacht werden. - -1. Klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. -1. Klicken Sie auf der Kachel für die Toolintegration, die Sie löschen möchten, auf das Menü für den Zugriff auf die Konfigurationsoptionen. -1. Klicken Sie auf **Löschen**, um die Toolintegration aus Ihrer Toolchain zu löschen. -1. Bestätigen Sie dies, indem Sie nochmals auf **Löschen** klicken. - -## Zugriff verwalten -{: #managing_access_dedicated} - -Sie können Benutzern Zugriff auf eine Toolchain gewähren, indem Sie sie zu der Organisation hinzufügen, der die Toolchain zugeordnet ist. Jede Toolchain ist einer bestimmten Organisation zugeordnet und alle Benutzer, die Mitglied dieser Organisation sind, können auf die zugeordneten Toolchains zugreifen. Um die Organisation anzuzeigen, in der Sie gerade arbeiten, klicken Sie auf das Symbol **{{site.data.keyword.avatar}}** ![Avatar-Symbol](../icons/i-avatar-icon.svg) in der Menüleiste. Um auf andere Toolchains zugreifen zu können, wechseln Sie zu einer anderen Organisation. - -Wenn Sie Benutzer zu Ihren {{site.data.keyword.Bluemix}}-Organisationen und -Bereichen hinzufügen, können sich die Benutzer mit ihrer {{site.data.keyword.Bluemix_notm}}-ID und dem zugehörigen Kennwort bei GitHub Enterprise anmelden. Wenn sich die Benutzer anmelden, werden Konten für sie erstellt. Wenn Sie Benutzer zu Ihren {{site.data.keyword.Bluemix_notm}}-Organisationen und -Bereichen hinzufügen, werden sie nicht automatisch dem GitHub Enterprise-Repository hinzugefügt. Ein Benutzer mit Verwaltungsrechten für das Repository muss sie hinzufügen. Weitere Informationen finden Sie im Abschnitt zur Verwendung von [Dedicated GitHub Enterprise (Link wird in neuem Fenster geöffnet)](../services/ghededicated/index.html){: new_window}. - -Führen Sie die folgenden Schritte aus, um einen Benutzer hinzuzufügen: - -1. Klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Klicken Sie anschließend auf **Verwalten**. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie anschließend auf **Verwalten**. -1. Klicken Sie auf den Link zu Ihrer Organisation. -1. Klicken Sie auf der Seite 'Organisationen verwalten' auf **Benutzer einladen** und geben Sie die E-Mail-Adresse des Benutzers ein. -1. Wenn Sie erweiterte Berechtigungen zur Verwaltung von Benutzern in {{site.data.keyword.Bluemix_notm}}-Organisationen erteilen möchten, wählen Sie mindestens eines der folgenden Kontrollkästchen aus: **Manager**, **Abrechnungsmanager** und **Auditor**. -1. Klicken Sie auf **EINLADEN**. -1. Klicken Sie auf **SPEICHERN**. - -## Toolchain löschen -{: #deleting_a_toolchain_dedicated} - -Sie können eine Toolchain löschen und angeben, welche der zugehörigen Toolintegrationen ebenfalls gelöscht werden sollen. Wenn Sie eine Toolchain löschen, kann diese Löschung nicht mehr rückgängig gemacht werden. - -1. Klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Klicken Sie anschließend auf **Verwalten**. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie anschließend auf **Verwalten**. -1. Klicken Sie auf **Toolchain löschen** und überprüfen oder ändern Sie die zu löschenden Toolintegrationen. -1. Bestätigen Sie das Löschen, indem Sie den Namen der Toolchain eingeben und auf **Löschen** klicken. - - **Tipp**: Wenn Sie eine GitHub Enterprise-Toolintegration löschen, wird das zugeordnete GitHub Enterprise-Repository nicht aus der Toolintegration gelöscht. Sie müssen das Repository manuell aus GitHub Enterprise entfernen. +--- + +Copyright: + Jahre: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Toolchains unter {{site.data.keyword.Bluemix_notm}} Dedicated verwenden +{: #toolchains-using_dedicated} + +Letzte Aktualisierung: 13. September 2016 +{: .last-updated} + +Mithilfe einer Toolchain können Sie Ihre täglichen Entwicklungs-, Bereitstellungs- und Systemaufgaben produktiv abwickeln. Nach dem Einrichten einer Toolchain können Sie Toolintegrationen hinzufügen, löschen oder konfigurieren sowie den Zugriff auf die Toolchain verwalten. +{: shortdesc} + +## Toolintegration konfigurieren +{: #configuring_a_tool_integration_dedicated} + +Wenn Sie die Konfiguration einer Toolintegration beim Erstellen einer Toolchain noch nicht vorgenommen haben, wird eine Schaltfläche **Konfigurieren** auf der zugehörigen Kachel angezeigt. Wenn Sie beim Erstellen einer Toolchain eine Toolintegration konfiguriert haben, können Sie die Konfigurationseinstellungen aktualisieren. + +1. Klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Wenn Sie eine Toolintegration erstmalig konfigurieren müssen, klicken Sie auf der zugehörigen Kachel auf **Konfigurieren**. + + ![Schaltfläche 'Konfigurieren'](images/toolchain_tile_configure.png) + + Wenn Sie die Konfiguration der Toolintegration abgeschlossen haben, klicken Sie auf **Integration speichern**. + +1. Wenn Sie die Konfiguration einer Toolintegration aktualisieren müssen, klicken Sie auf der zugehörigen Kachel auf das Menü für den Zugriff auf die Konfigurationsoptionen. + + ![Konfigurationsmenü](images/toolchain_tile_menu.png) + + Wenn Sie die Aktualisierung der Einstellungen abgeschlossen haben, klicken Sie auf **Integration speichern**. + +## Toolintegration hinzufügen +{: #adding_a_tool_integration_dedicated} + +Sie können Toolintegrationen für Ihre Toolchain hinzufügen und konfigurieren. + +1. Klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Klicken Sie auf die Schaltfläche zum Hinzufügen (+), um eine Liste von hinzuzufügenden Toolintegrationen anzuzeigen. +1. Klicken Sie auf die Toolintegration, die Sie hinzufügen möchten. +1. Geben Sie alle erforderlichen Informationen zum Konfigurieren der Toolintegration ein. +1. Klicken Sie auf **Integration erstellen**, um die Toolintegration zu Ihrer Toolchain hinzuzufügen. + +## Toolintegration löschen +{: #deleting_a_tool_integration} + +Wenn Sie eine Toolintegration aus Ihrer Toolchain löschen, kann diese Löschung nicht mehr rückgängig gemacht werden. + +1. Klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie dann auf **Toolintegrationen**. +1. Klicken Sie auf der Kachel für die Toolintegration, die Sie löschen möchten, auf das Menü für den Zugriff auf die Konfigurationsoptionen. +1. Klicken Sie auf **Löschen**, um die Toolintegration aus Ihrer Toolchain zu löschen. +1. Bestätigen Sie dies, indem Sie nochmals auf **Löschen** klicken. + +## Zugriff verwalten +{: #managing_access_dedicated} + +Sie können Benutzern Zugriff auf eine Toolchain gewähren, indem Sie sie zu der Organisation hinzufügen, der die Toolchain zugeordnet ist. Jede Toolchain ist einer bestimmten Organisation zugeordnet und alle Benutzer, die Mitglied dieser Organisation sind, können auf die zugeordneten Toolchains zugreifen. Um die Organisation anzuzeigen, in der Sie gerade arbeiten, klicken Sie auf das Symbol **{{site.data.keyword.avatar}}** ![Avatar-Symbol](../icons/i-avatar-icon.svg) in der Menüleiste. Um auf andere Toolchains zugreifen zu können, wechseln Sie zu einer anderen Organisation. + +Wenn Sie Benutzer zu Ihren {{site.data.keyword.Bluemix}}-Organisationen und -Bereichen hinzufügen, können sich die Benutzer mit ihrer {{site.data.keyword.Bluemix_notm}}-ID und dem zugehörigen Kennwort bei GitHub Enterprise anmelden. Wenn sich die Benutzer anmelden, werden Konten für sie erstellt. Wenn Sie Benutzer zu Ihren {{site.data.keyword.Bluemix_notm}}-Organisationen und -Bereichen hinzufügen, werden sie nicht automatisch dem GitHub Enterprise-Repository hinzugefügt. Ein Benutzer mit Verwaltungsrechten für das Repository muss sie hinzufügen. Weitere Informationen finden Sie im Abschnitt zur Verwendung von [Dedicated GitHub Enterprise (Link wird in neuem Fenster geöffnet)](../services/ghededicated/index.html){: new_window}. + +Führen Sie die folgenden Schritte aus, um einen Benutzer hinzuzufügen: + +1. Klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Klicken Sie anschließend auf **Verwalten**. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie anschließend auf **Verwalten**. +1. Klicken Sie auf den Link zu Ihrer Organisation. +1. Klicken Sie auf der Seite 'Organisationen verwalten' auf **Benutzer einladen** und geben Sie die E-Mail-Adresse des Benutzers ein. +1. Wenn Sie erweiterte Berechtigungen zur Verwaltung von Benutzern in {{site.data.keyword.Bluemix_notm}}-Organisationen erteilen möchten, wählen Sie mindestens eines der folgenden Kontrollkästchen aus: **Manager**, **Abrechnungsmanager** und **Auditor**. +1. Klicken Sie auf **EINLADEN**. +1. Klicken Sie auf **SPEICHERN**. + +## Toolchain löschen +{: #deleting_a_toolchain_dedicated} + +Sie können eine Toolchain löschen und angeben, welche der zugehörigen Toolintegrationen ebenfalls gelöscht werden sollen. Wenn Sie eine Toolchain löschen, kann diese Löschung nicht mehr rückgängig gemacht werden. + +1. Klicken Sie im Dashboard auf der Registerkarte **DEVOPS** auf die Toolchain, um die zugehörige Seite mit den Toolintegrationen anzuzeigen. Klicken Sie anschließend auf **Verwalten**. Alternativ können Sie in der rechten oberen Ecke auf der Übersichtsseite der App auf **Toolchain anzeigen** klicken. Klicken Sie anschließend auf **Verwalten**. +1. Klicken Sie auf **Toolchain löschen** und überprüfen oder ändern Sie die zu löschenden Toolintegrationen. +1. Bestätigen Sie das Löschen, indem Sie den Namen der Toolchain eingeben und auf **Löschen** klicken. + + **Tipp**: Wenn Sie eine GitHub Enterprise-Toolintegration löschen, wird das zugeordnete GitHub Enterprise-Repository nicht aus der Toolintegration gelöscht. Sie müssen das Repository manuell aus GitHub Enterprise entfernen. diff --git a/toolchains/nl/de/web_ide.md b/toolchains/nl/de/web_ide.md index 839561ace..73345c678 100644 --- a/toolchains/nl/de/web_ide.md +++ b/toolchains/nl/de/web_ide.md @@ -1,152 +1,152 @@ ---- - -Copyright: - Jahre: 2015, 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} -{:pre: .pre} - -# Code mit der Eclipse Orion-{{site.data.keyword.webide}} bearbeiten -{: #web_ide} - -Letzte Aktualisierung: 9. September 2016 -{: .last-updated} - -Die Eclipse Orion-{{site.data.keyword.webide}} ist eine browserbasierte Entwicklungsumgebung, in der Sie Anwendungen für das Web entwickeln können. Für die Entwicklung in JavaScript, HTML und CSS stehen Content-Assist-Funktionen, Codevervollständigung und Fehlerprüfung zur Verfügung. Die {{site.data.keyword.webide}} ist mit nahezu jeder Programmiersprache verwendbar und bietet Syntaxhervorhebung für die meisten [Dateitypen (Link wird in neuem Fenster geöffnet)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}. Die Quellcodeverwaltung ist durch Git oder Jazz SCM integriert und Sie können Code lokal bereitstellen, um Ihre Apps zu testen und zu debuggen. -{:shortdesc} - -Als weiterer wesentlicher Vorteil kommt hinzu, dass {{site.data.keyword.webide}} auf der Webtechnologie basiert. Es entsteht keinerlei Installations-, Wartungs- und Skalierungsaufwand. Für die Codeentwicklung benötigen Sie lediglich einen Internetanschluss. - -## Editor einrichten -{: #editorsetup} - -Die {{site.data.keyword.webide}} ist konfigurierbar, d. h. Sie können Farbschemen, technische Tools und Einstellungen wählen, die Ihren Entwicklunganforderungen entsprechen. Um die Einstellungen anzuzeigen und zu ändern, klicken Sie links im Menü auf das Symbol **Einstellungen** Symbol 'Einstellungen'. - -Wenn Sie bestimmte Einstellungen beim Bearbeiten häufig ändern müssen, können Sie auf diese Einstellungen schnell über das Symbol **Lokale Einstellungen für Editor** Symbol 'Lokale Einstellungen für Editor' in der rechten oberen Ecke des Editors zugreifen. - -![Lokale Einstellungen für Editor](images/webide_local_editor_settings.png) - -Standardmäßig werden die Einstellungen für den Editorstil und die Schriftgröße immer angezeigt. Führen Sie die folgenden Schritte aus, um weitere Einstellungen in das Menü aufzunehmen: - -1. Klicken Sie auf das Symbol **Lokale Einstellungen für Editor** Symbol 'Lokale Einstellungen für Editor'. - -2. Klicken Sie auf **Editoreinstellungen**. - -3. Um eine Einstellung in das Menü **Lokale Einstellungen für Editor** aufzunehmen oder daraus zu entfernen, klicken Sie auf den Kreis neben der betreffenden Einstellung. - -![Umschalter für Editoreinstellungen](images/webide_editor_settings_toggle.png) - - -## Code bearbeiten -{: #editcode} - -Die {{site.data.keyword.webide}} setzt sich aus zwei Hauptabschnitten zusammen. Der erste Abschnitt ist der Dateinavigator auf der linken Seite, der Ihre Projektdateien in einer Baumstruktur zeigt. Über den Dateinavigator können Sie Dateien und Ordner erstellen, umbenennen, löschen und verwalten. - -**Tipp:** Um Dateien in den Dateinavigator hochzuladen, ziehen Sie sie von Ihrem Computer in den Dateinavigator. - -Der zweite Abschnitt ist das Editorteilfenster auf der rechten Seite. Der Editor bietet verschiedene Codierungsfunktionen, einschließlich Content-Assist und Syntaxprüfung. - -![Web-IDE](images/webide.png) - -### Mit mehreren Dateien arbeiten -1. Um mit zwei Dateien gleichzeitig zu arbeiten, klicken Sie auf das Symbol **Teilungsmodus des Editors ändern** Symbol 'Geteilter Editor' oben im Editor. -2. Wählen Sie in dem geöffneten Menü eine Ansicht aus. - - Wenn bereits eine Datei im Editor geöffnet war, wird sie nach Auswahl einer Ansicht in beiden Editoransichten angezeigt. - - Gehen Sie wie folgt vor, um eine Datei, die in einer der Editoransichten angezeigt wird, zu öffnen oder zu ändern: - 1. Bewegen Sie den Cursor zu der Editoransicht, die Sie ändern wollen. - 2. Klicken Sie im Dateinavigator auf eine Datei. - -### Tastenkombinationen -Die meisten Befehle in der {{site.data.keyword.webide}} können nur über die Tastatur ausgeführt werden. - -Verwenden Sie die Tastenkombination Alt+Umschalttaste+?, um eine Liste mit den Tastenbelegungen anzuzeigen. Wenn Sie Mac OS verwenden, lautet die Tastenkombination Strg+Umschalttaste+?. - -## Quellcode verwalten -{: #sourcecontrol} - -Die {{site.data.keyword.webide}} ist mit Quellcodeverwaltungstools integriert. Um mit dem Git-Repository zu arbeiten, klicken Sie auf das Symbol **Git-Repository** Symbol 'Git-Repository'. Weitere Informationen finden Sie unter [Source control with Git (Link wird in neuem Fenster geöffnet)](https://hub.jazz.net/docs/git/){: new_window}. - - -## App vom Arbeitsbereich aus bereitstellen -{: #deploy} - -1. Um die App von der Ausführungsleiste bereitzustellen, wählen oder [erstellen Sie (Link wird in neuem Fenster geöffnet)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} eine Startkonfiguration. -1. Klicken Sie auf das Symbol für die Bereitstellung Symbol 'Bereitstellung'. Bei der Bereitstellung einer Instanz Ihrer App werden der aktuelle Inhalt Ihres Arbeitsbereichs und die Umgebung verwendet, die in Ihrer Startkonfiguration definiert sind. -2. Wenn Ihre App bereitgestellt wurde, können Sie die Ausführungsleiste verwenden, um Ihre App zu stoppen, erneut zu starten oder zu debuggen, um Protokolle anzuzeigen usw. -![Ausführungsleiste](images/webide_runbar.png) - - - - ## Editor außerhalb der {{site.data.keyword.webide}} verwenden -{: #editlocal} - -Um einen Editor außerhalb der {{site.data.keyword.webide}} zu verwenden, richten Sie die {{site.data.keyword.Bluemix_live}} so ein, dass Sie in einem beliebigen Tool direkt mit Ihren Projektdateien arbeiten können. {{site.data.keyword.Bluemix_live_notm}} ist eine Befehlszeilenanwendung, die die Änderungen in Ihrem lokalen Dateisystem mit Ihrem Cloudarbeitsbereich in {{site.data.keyword.jazzhub}} synchronisiert. - -### Vorbemerkungen - -Laden Sie die [{{site.data.keyword.Bluemix_live_notm}}-Befehlszeilenschnittstelle herunter und installieren Sie sie (Link wird in neuem Fenster geöffnet)](http://livesyncdownload.ng.bluemix.net){: new_window}. - -### Lokale Umgebung mit {{site.data.keyword.Bluemix_notm}} synchronisieren -{: #edit_local_download} - -1. Öffnen Sie ein Befehlszeilenfenster. -2. Melden Sie sich bei {{site.data.keyword.Bluemix_notm}} an: - - ``` - bl login - ``` - {: pre} - -3. Geben Sie Ihre IBMid und das Kennwort ein, wenn Sie dazu aufgefordert werden. -4. Zeigen Sie eine Liste Ihrer {{site.data.keyword.Bluemix_notm}}-Projekte an: - - ``` - bl projects - ``` - {: pre} - -4. Synchronisieren Sie Ihre lokale Umgebung mit Ihrem Projekt unter {{site.data.keyword.Bluemix_notm}}: - - ``` - bl sync projektname - ``` - {: pre} - -Dabei ist `projektname` der Name Ihrer {{site.data.keyword.Bluemix_notm}}-App. - -Wenn Sie die Bearbeitung abgeschlossen haben, geben Sie `q` ein, um die Synchronisation zu beenden. - -### Feature 'Desktop Sync' für lokale Codebearbeitung aktivieren - -Das Feature 'Desktop Sync' entspricht dem Modus 'Livebearbeitung' für die Befehlszeile. Sie benötigen das Feature 'Desktop Sync' für das Debugging in der Befehlszeile. -1. Aktivieren Sie das Feature 'Desktop Sync' in einem anderen Befehlszeilenfenster: - - ``` - cd localDirectory - bl start - ``` - {: codeblock} - -2. Verwenden Sie die Startkonfiguration, die Sie in der {{site.data.keyword.webide}} erstellt haben. Wenn Sie die Startkonfiguration ausgewählt haben, ist das Feature 'Desktop Sync' in Ihrer lokalen Umgebung aktiviert. In dem Befehlszeilenfenster, das Sie gerade geöffnet haben, können Sie die URL der App, die Debug-URL und die Verwaltungs-URL anzeigen und den Status von {{site.data.keyword.Bluemix_live_notm}} anzeigen. - -3. Aktualisieren Sie die Browseranzeige und prüfen Sie, ob Sie die Änderungen sehen, die Sie in statischen Dateien im lokalen Arbeitsbereich gespeichert haben. - -### Feature 'Desktop Sync' inaktivieren - -1. Geben Sie im zweiten Befehlszeilenfenster `bl stop` ein. -2. Geben Sie im ersten Befehlszeilenfenster `q` ein. +--- + +Copyright: + Jahre: 2015, 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} +{:pre: .pre} + +# Code mit der Eclipse Orion-{{site.data.keyword.webide}} bearbeiten +{: #web_ide} + +Letzte Aktualisierung: 9. September 2016 +{: .last-updated} + +Die Eclipse Orion-{{site.data.keyword.webide}} ist eine browserbasierte Entwicklungsumgebung, in der Sie Anwendungen für das Web entwickeln können. Für die Entwicklung in JavaScript, HTML und CSS stehen Content-Assist-Funktionen, Codevervollständigung und Fehlerprüfung zur Verfügung. Die {{site.data.keyword.webide}} ist mit nahezu jeder Programmiersprache verwendbar und bietet Syntaxhervorhebung für die meisten [Dateitypen (Link wird in neuem Fenster geöffnet)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}. Die Quellcodeverwaltung ist durch Git oder Jazz SCM integriert und Sie können Code lokal bereitstellen, um Ihre Apps zu testen und zu debuggen. +{:shortdesc} + +Als weiterer wesentlicher Vorteil kommt hinzu, dass {{site.data.keyword.webide}} auf der Webtechnologie basiert. Es entsteht keinerlei Installations-, Wartungs- und Skalierungsaufwand. Für die Codeentwicklung benötigen Sie lediglich einen Internetanschluss. + +## Editor einrichten +{: #editorsetup} + +Die {{site.data.keyword.webide}} ist konfigurierbar, d. h. Sie können Farbschemen, technische Tools und Einstellungen wählen, die Ihren Entwicklunganforderungen entsprechen. Um die Einstellungen anzuzeigen und zu ändern, klicken Sie links im Menü auf das Symbol **Einstellungen** Symbol 'Einstellungen'. + +Wenn Sie bestimmte Einstellungen beim Bearbeiten häufig ändern müssen, können Sie auf diese Einstellungen schnell über das Symbol **Lokale Einstellungen für Editor** Symbol 'Lokale Einstellungen für Editor' in der rechten oberen Ecke des Editors zugreifen. + +![Lokale Einstellungen für Editor](images/webide_local_editor_settings.png) + +Standardmäßig werden die Einstellungen für den Editorstil und die Schriftgröße immer angezeigt. Führen Sie die folgenden Schritte aus, um weitere Einstellungen in das Menü aufzunehmen: + +1. Klicken Sie auf das Symbol **Lokale Einstellungen für Editor** Symbol 'Lokale Einstellungen für Editor'. + +2. Klicken Sie auf **Editoreinstellungen**. + +3. Um eine Einstellung in das Menü **Lokale Einstellungen für Editor** aufzunehmen oder daraus zu entfernen, klicken Sie auf den Kreis neben der betreffenden Einstellung. + +![Umschalter für Editoreinstellungen](images/webide_editor_settings_toggle.png) + + +## Code bearbeiten +{: #editcode} + +Die {{site.data.keyword.webide}} setzt sich aus zwei Hauptabschnitten zusammen. Der erste Abschnitt ist der Dateinavigator auf der linken Seite, der Ihre Projektdateien in einer Baumstruktur zeigt. Über den Dateinavigator können Sie Dateien und Ordner erstellen, umbenennen, löschen und verwalten. + +**Tipp:** Um Dateien in den Dateinavigator hochzuladen, ziehen Sie sie von Ihrem Computer in den Dateinavigator. + +Der zweite Abschnitt ist das Editorteilfenster auf der rechten Seite. Der Editor bietet verschiedene Codierungsfunktionen, einschließlich Content-Assist und Syntaxprüfung. + +![Web-IDE](images/webide.png) + +### Mit mehreren Dateien arbeiten +1. Um mit zwei Dateien gleichzeitig zu arbeiten, klicken Sie auf das Symbol **Teilungsmodus des Editors ändern** Symbol 'Geteilter Editor' oben im Editor. +2. Wählen Sie in dem geöffneten Menü eine Ansicht aus. + + Wenn bereits eine Datei im Editor geöffnet war, wird sie nach Auswahl einer Ansicht in beiden Editoransichten angezeigt. + + Gehen Sie wie folgt vor, um eine Datei, die in einer der Editoransichten angezeigt wird, zu öffnen oder zu ändern: + 1. Bewegen Sie den Cursor zu der Editoransicht, die Sie ändern wollen. + 2. Klicken Sie im Dateinavigator auf eine Datei. + +### Tastenkombinationen +Die meisten Befehle in der {{site.data.keyword.webide}} können nur über die Tastatur ausgeführt werden. + +Verwenden Sie die Tastenkombination Alt+Umschalttaste+?, um eine Liste mit den Tastenbelegungen anzuzeigen. Wenn Sie Mac OS verwenden, lautet die Tastenkombination Strg+Umschalttaste+?. + +## Quellcode verwalten +{: #sourcecontrol} + +Die {{site.data.keyword.webide}} ist mit Quellcodeverwaltungstools integriert. Um mit dem Git-Repository zu arbeiten, klicken Sie auf das Symbol **Git-Repository** Symbol 'Git-Repository'. Weitere Informationen finden Sie unter [Source control with Git (Link wird in neuem Fenster geöffnet)](https://hub.jazz.net/docs/git/){: new_window}. + + +## App vom Arbeitsbereich aus bereitstellen +{: #deploy} + +1. Um die App von der Ausführungsleiste bereitzustellen, wählen oder [erstellen Sie (Link wird in neuem Fenster geöffnet)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} eine Startkonfiguration. +1. Klicken Sie auf das Symbol für die Bereitstellung Symbol 'Bereitstellung'. Bei der Bereitstellung einer Instanz Ihrer App werden der aktuelle Inhalt Ihres Arbeitsbereichs und die Umgebung verwendet, die in Ihrer Startkonfiguration definiert sind. +2. Wenn Ihre App bereitgestellt wurde, können Sie die Ausführungsleiste verwenden, um Ihre App zu stoppen, erneut zu starten oder zu debuggen, um Protokolle anzuzeigen usw. +![Ausführungsleiste](images/webide_runbar.png) + + + + ## Editor außerhalb der {{site.data.keyword.webide}} verwenden +{: #editlocal} + +Um einen Editor außerhalb der {{site.data.keyword.webide}} zu verwenden, richten Sie die {{site.data.keyword.Bluemix_live}} so ein, dass Sie in einem beliebigen Tool direkt mit Ihren Projektdateien arbeiten können. {{site.data.keyword.Bluemix_live_notm}} ist eine Befehlszeilenanwendung, die die Änderungen in Ihrem lokalen Dateisystem mit Ihrem Cloudarbeitsbereich in {{site.data.keyword.jazzhub}} synchronisiert. + +### Vorbemerkungen + +Laden Sie die [{{site.data.keyword.Bluemix_live_notm}}-Befehlszeilenschnittstelle herunter und installieren Sie sie (Link wird in neuem Fenster geöffnet)](http://livesyncdownload.ng.bluemix.net){: new_window}. + +### Lokale Umgebung mit {{site.data.keyword.Bluemix_notm}} synchronisieren +{: #edit_local_download} + +1. Öffnen Sie ein Befehlszeilenfenster. +2. Melden Sie sich bei {{site.data.keyword.Bluemix_notm}} an: + + ``` + bl login + ``` + {: pre} + +3. Geben Sie Ihre IBMid und das Kennwort ein, wenn Sie dazu aufgefordert werden. +4. Zeigen Sie eine Liste Ihrer {{site.data.keyword.Bluemix_notm}}-Projekte an: + + ``` + bl projects + ``` + {: pre} + +4. Synchronisieren Sie Ihre lokale Umgebung mit Ihrem Projekt unter {{site.data.keyword.Bluemix_notm}}: + + ``` + bl sync projektname + ``` + {: pre} + +Dabei ist `projektname` der Name Ihrer {{site.data.keyword.Bluemix_notm}}-App. + +Wenn Sie die Bearbeitung abgeschlossen haben, geben Sie `q` ein, um die Synchronisation zu beenden. + +### Feature 'Desktop Sync' für lokale Codebearbeitung aktivieren + +Das Feature 'Desktop Sync' entspricht dem Modus 'Livebearbeitung' für die Befehlszeile. Sie benötigen das Feature 'Desktop Sync' für das Debugging in der Befehlszeile. +1. Aktivieren Sie das Feature 'Desktop Sync' in einem anderen Befehlszeilenfenster: + + ``` + cd localDirectory + bl start + ``` + {: codeblock} + +2. Verwenden Sie die Startkonfiguration, die Sie in der {{site.data.keyword.webide}} erstellt haben. Wenn Sie die Startkonfiguration ausgewählt haben, ist das Feature 'Desktop Sync' in Ihrer lokalen Umgebung aktiviert. In dem Befehlszeilenfenster, das Sie gerade geöffnet haben, können Sie die URL der App, die Debug-URL und die Verwaltungs-URL anzeigen und den Status von {{site.data.keyword.Bluemix_live_notm}} anzeigen. + +3. Aktualisieren Sie die Browseranzeige und prüfen Sie, ob Sie die Änderungen sehen, die Sie in statischen Dateien im lokalen Arbeitsbereich gespeichert haben. + +### Feature 'Desktop Sync' inaktivieren + +1. Geben Sie im zweiten Befehlszeilenfenster `bl stop` ein. +2. Geben Sie im ersten Befehlszeilenfenster `q` ein. diff --git a/toolchains/nl/es/toolchains_about.md b/toolchains/nl/es/toolchains_about.md index 4462836d7..6840c1ed9 100644 --- a/toolchains/nl/es/toolchains_about.md +++ b/toolchains/nl/es/toolchains_about.md @@ -1,42 +1,42 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# Acerca de cadenas de herramientas -{: #toolchains_about} - -Última actualización: 13 de septiembre de 2016 -{: .last-updated} - -Una *cadena de herramientas* es un conjunto de integraciones de herramientas que admiten tareas de desarrollo, despliegue y operaciones. La potencia en conjunto de una cadena de herramientas es superior a la suma de las integraciones de las herramientas individuales. -{:shortdesc} - -Las cadenas de herramientas están disponibles en los entornos Público y Dedicado en {{site.data.keyword.Bluemix}}. Una cadena de herramientas se puede crear de dos formas: mediante una plantilla o a partir de una app. Como punto de partida, puede utilizar una plantilla de cadena de herramientas. En función de la plantilla que utilice, puede crear una cadena de herramientas que tenga un conjunto específico de integraciones de herramientas o bien una cadena de herramientas vacía a la que puede añadir integraciones de herramientas. - -En {{site.data.keyword.Bluemix_notm}} Público, en función de la plantilla o cadena de herramientas que se utilice, es posible que la cadena de herramientas incluya un repositorio de GitHub que contenga código de inicio de la app y un conducto de entrega ya configurado. Cuando se envían los cambios al repositorio de GitHub de la cadena de herramientas, el conducto de entrega crea y despliega automáticamente la app en {{site.data.keyword.Bluemix_notm}}. - -En {{site.data.keyword.Bluemix_notm}} Dedicado, en función de la cadena de herramientas que se utilice, es posible que la cadena de herramientas incluya un repositorio de GitHub Enterprise que contenga código de inicio de la app y un conducto de entrega ya configurado. Cuando se envían los cambios al repositorio de GitHub Enterprise de la cadena de herramientas, el conducto de entrega crea y despliega automáticamente las apps en {{site.data.keyword.Bluemix_notm}}. - -## Obtención de ayuda y soporte para las cadenas de herramientas -{: #gettinghelp} - -Si tiene problemas o preguntas al utilizar las cadenas de herramientas, puede obtener ayuda buscando información o formulando preguntas en un foro. También puede abrir una incidencia de soporte. - -Al utilizar los foros para formular una pregunta, etiquete la pregunta para que la puedan ver los equipos de desarrollo de {{site.data.keyword.Bluemix_notm}}. - -* Si tiene preguntas técnicas sobre el desarrollo o el despliegue de una app con cadenas de herramientas, publique la pregunta en [Desbordamiento de pila (El enlace se abre en una ventana nueva)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} y etiquete la pregunta con "ibm-bluemix" y "devops". - -* Para preguntas sobre cadenas de herramientas e instrucciones sobre cómo empezar, utilice el foro [IBM developerWorks dW Answers (El enlace se abre en una ventana nueva)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}. Incluya las etiquetas "devops-services" y "bluemix". - -Consulte [Obtención de ayuda (El enlace se abre en una ventana nueva)](https://www.{DomainName}/docs/support/index.html#getting-help) para obtener más detalles sobre cómo utilizar los foros. - -Para obtener información sobre cómo abrir una incidencia de soporte de IBM, o sobre los niveles de soporte y las gravedades de las incidencias, consulte [Cómo contactar con el servicio de soporte (El enlace se abre en una ventana nueva)](https://www.{DomainName}/docs/support/index.html#contacting-support). +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# Acerca de cadenas de herramientas +{: #toolchains_about} + +Última actualización: 13 de septiembre de 2016 +{: .last-updated} + +Una *cadena de herramientas* es un conjunto de integraciones de herramientas que admiten tareas de desarrollo, despliegue y operaciones. La potencia en conjunto de una cadena de herramientas es superior a la suma de las integraciones de las herramientas individuales. +{:shortdesc} + +Las cadenas de herramientas están disponibles en los entornos Público y Dedicado en {{site.data.keyword.Bluemix}}. Una cadena de herramientas se puede crear de dos formas: mediante una plantilla o a partir de una app. Como punto de partida, puede utilizar una plantilla de cadena de herramientas. En función de la plantilla que utilice, puede crear una cadena de herramientas que tenga un conjunto específico de integraciones de herramientas o bien una cadena de herramientas vacía a la que puede añadir integraciones de herramientas. + +En {{site.data.keyword.Bluemix_notm}} Público, en función de la plantilla o cadena de herramientas que se utilice, es posible que la cadena de herramientas incluya un repositorio de GitHub que contenga código de inicio de la app y un conducto de entrega ya configurado. Cuando se envían los cambios al repositorio de GitHub de la cadena de herramientas, el conducto de entrega crea y despliega automáticamente la app en {{site.data.keyword.Bluemix_notm}}. + +En {{site.data.keyword.Bluemix_notm}} Dedicado, en función de la cadena de herramientas que se utilice, es posible que la cadena de herramientas incluya un repositorio de GitHub Enterprise que contenga código de inicio de la app y un conducto de entrega ya configurado. Cuando se envían los cambios al repositorio de GitHub Enterprise de la cadena de herramientas, el conducto de entrega crea y despliega automáticamente las apps en {{site.data.keyword.Bluemix_notm}}. + +## Obtención de ayuda y soporte para las cadenas de herramientas +{: #gettinghelp} + +Si tiene problemas o preguntas al utilizar las cadenas de herramientas, puede obtener ayuda buscando información o formulando preguntas en un foro. También puede abrir una incidencia de soporte. + +Al utilizar los foros para formular una pregunta, etiquete la pregunta para que la puedan ver los equipos de desarrollo de {{site.data.keyword.Bluemix_notm}}. + +* Si tiene preguntas técnicas sobre el desarrollo o el despliegue de una app con cadenas de herramientas, publique la pregunta en [Desbordamiento de pila (El enlace se abre en una ventana nueva)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} y etiquete la pregunta con "ibm-bluemix" y "devops". + +* Para preguntas sobre cadenas de herramientas e instrucciones sobre cómo empezar, utilice el foro [IBM developerWorks dW Answers (El enlace se abre en una ventana nueva)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}. Incluya las etiquetas "devops-services" y "bluemix". + +Consulte [Obtención de ayuda (El enlace se abre en una ventana nueva)](https://www.{DomainName}/docs/support/index.html#getting-help) para obtener más detalles sobre cómo utilizar los foros. + +Para obtener información sobre cómo abrir una incidencia de soporte de IBM, o sobre los niveles de soporte y las gravedades de las incidencias, consulte [Cómo contactar con el servicio de soporte (El enlace se abre en una ventana nueva)](https://www.{DomainName}/docs/support/index.html#contacting-support). diff --git a/toolchains/nl/es/toolchains_integrations.md b/toolchains/nl/es/toolchains_integrations.md index f056f7d43..3df9da374 100644 --- a/toolchains/nl/es/toolchains_integrations.md +++ b/toolchains/nl/es/toolchains_integrations.md @@ -1,304 +1,304 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configuración de la integración de herramientas -{: #integrations} - -Última actualización: 18 de octubre de 2016 -{: .last-updated} - -Puede configurar integraciones de herramientas que admitan tareas de desarrollo, despliegue y operaciones mientras crea una cadena de herramientas, o bien puede añadir y configurar integraciones de herramientas para personalizar una cadena de herramientas existente. -{:shortdesc} - -**Importante**: En {{site.data.keyword.Bluemix_notm}} Público, las cadenas de herramientas están disponibles únicamente en el sur de EE. UU. - -Las integraciones de herramientas que están disponibles para añadirse y configurarse para la cadena de herramientas son distintas en función de si está utilizando cadenas de herramientas en {{site.data.keyword.Bluemix_notm}} Público o {{site.data.keyword.Bluemix_notm}} Dedicado. Si está utilizando cadenas de herramientas en {{site.data.keyword.Bluemix_notm}} Dedicado, las integraciones de herramientas disponibles para usted dependerán de cómo se haya configurado {{site.data.keyword.jazzhub_title}} en el entorno específico. - -*Tabla 1. Integraciones de herramientas disponibles para cadenas de herramientas en {{site.data.keyword.Bluemix_notm}} Público y Dedicado* - -|Integración de herramientas |Disponible en {{site.data.keyword.Bluemix_notm}} Público |Disponible en {{site.data.keyword.Bluemix_notm}} Dedicado (dependiente del entorno)| -|:----------|:------------------------------|:------------------| -|{{site.data.keyword.deliverypipeline}} |Sí |Sí | -|{{site.data.keyword.DRA_short}} |Sí |No | -|Eclipse Orion {{site.data.keyword.webide}} |Sí |Sí | -|GitHub |Sí |Sí | -|GitHub Enterprise Dedicado |No |Sí | -|Otras herramientas |Sí |Sí | -|PagerDuty |Sí |Sí | -|Sauce Labs |Sí |No | -|Slack |Sí |Sí | - -**Consejo**: si desea empezar a desarrollar su propio código en {{site.data.keyword.Bluemix_notm}} Público, configure la integración de herramientas GitHub antes de configurar el {{site.data.keyword.deliverypipeline}}. Si desea empezar a desarrollar su propio código en {{site.data.keyword.Bluemix_notm}} Dedicado, configure la integración de herramientas {{site.data.keyword.ghe_short}} o la integración de herramientas GitHub antes de configurar el {{site.data.keyword.deliverypipeline}}. - - -## Configuración del conducto de entrega -{: #deliverypipeline} - -El {{site.data.keyword.deliverypipeline}} automatiza el despliegue continuado de los proyectos a través de secuencias de fases que recuperan entradas y ejecutan trabajos, como compilaciones, pruebas y despliegues. - -Configure el {{site.data.keyword.deliverypipeline}} para automatizar la creación, las pruebas y el despliegue automáticos de sus apps: - -1. Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Configurable Integrations, pulse **Delivery Pipeline**. En función de la plantilla que utilice, los campos disponibles serán distintos. Revise los valores del campo predeterminado y, si es necesario, realice cambios. -1. Si tiene una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Público y añade esta integración de herramientas a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Continuous Delivery, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. Si utiliza una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Dedicado, en el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Integraciones de herramientas. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. Pulse el botón de adición (+). -1. En la sección Tool Integrations, pulse **Delivery Pipeline**. -1. Especifique un nombre para el nuevo conducto. -1. Si tiene previsto utilizar el conducto para desplegar una interfaz de usuario, seleccione el recuadro de selección **Viewable App**. Todas las apps creadas por el conducto se muestran en la lista **VIEW APP** de la página Tool Integrations de la cadena de herramientas. -1. Pulse **Create Integration** para añadir el {{site.data.keyword.deliverypipeline}} a la cadena de herramientas. -1. Pulse el mosaico para {{site.data.keyword.deliverypipeline}} para ver el conducto y configurarlo. Para obtener información básica sobre cómo configurar un conducto, consulte [Creación y despliegue de conductos (El enlace se abre en una ventana nueva)](../services/DeliveryPipeline/build_deploy.html){: new_window}. - - **Consejo**: si desea activar el conducto al transferir cambios al repositorio (repo) de GitHub o {{site.data.keyword.ghe_short}}, debe configurar GitHub o {{site.data.keyword.ghe_short}} para la cadena de herramientas antes de definir las fases del conducto. Las fases del conducto necesitan los URL Git para los repositorios. Cada fase de conducto puede hacer referencia a un único repositorio de GitHub o {{site.data.keyword.ghe_short}} que esté asociado con la cadena de herramientas. Para obtener instrucciones sobre cómo configurar GitHub, consulte la sección [GitHub](#github). Para obtener instrucciones sobre cómo configurar GitHub Enterprise Dedicado, consulte [Iniciación a {{site.data.keyword.ghe_long}} (El enlace se abre en una ventana nueva)](../services/ghededicated/index.html){: new_window}. - -1. Opcional: si utiliza una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Público y desea que Sauce Labs ejecute pruebas en la app, configure el {{site.data.keyword.deliverypipeline}} para añadir el trabajo de pruebas Sauce Labs. Para obtener instrucciones sobre cómo configurar el trabajo de pruebas, consulte [Configuración de un trabajo de pruebas Sauce Labs en el conducto](#config_saucelabs). - -### Configuración de un trabajo de pruebas Sauce Labs en el conducto -{: #config_saucelabs} - -Antes de configurar un trabajo de pruebas Sauce Labs en el conducto, necesita un conducto de trabajo que incluya fases para crear y desplegar la app, y debe configurar Sauce Labs para su cadena de herramientas. Para obtener instrucciones sobre cómo configurar Sauce Labs, consulte la sección [Sauce Labs](#saucelabs). - -Configure el {{site.data.keyword.deliverypipeline}} para añadir un trabajo de pruebas Sauce Labs: - -1. Si no tiene ninguna fase que despliegue una versión de pruebas de su app, cree una. -1. En la fase, añada un trabajo de prueba después del trabajo de despliegue. Disponer de estos trabajos en la misma fase permite que accedan al mismo conjunto de propiedades del entorno. - ![Trabajo de prueba](images/toolchain_test_job.png) - -1. Configure la fase: - - a. En el separador **ENVIRONMENT PROPERTIES**, cree tres propiedades: CF_APP_NAME, SAUCE_USERNAME y SAUCE_ACCESS_KEY. - - b. Introduzca su nombre de usuario y clave de acceso para Sauce Labs. De este modo, externaliza estos valores para poder utilizarlos en sus pruebas. - -1. Configure el trabajo de despliegue. En el campo **Deploy Script**, incluya este mandato: `export CF_APP_NAME="$CF_APP"`. Este mandato exporta el nombre de la app como propiedad del entorno. -1. Configure el trabajo de prueba. Los valores de la imagen siguiente son ejemplos. Los campos **Service Instance**, **Target**, **Organization** y **Space** se rellenan con el nombre de usuario de Sauce Labs, la región, la organización y el espacio que se está utilizando. -![Trabajo de configuración](images/toolchain_configure_job.png) - - a. Para el tipo de prueba, seleccione **Sauce Labs**. - - b. Para la instancia de servicio, seleccione el nombre de usuario de Sauce Labs que ha utilizado al configurar Sauce Labs para su cadena de herramientas. - - **Consejo**: para ver el nombre de usuario y la clave de acceso que ha utilizado al configurar Sauce Labs para su cadena de herramientas, pulse **Configurar**. - - c. En el campo **Test Execution Command**, especifique los mandatos que instalan las dependencias necesarias para las pruebas y, a continuación, ejecute las pruebas. Por ejemplo, para una app Node.js, puede introducir estos mandatos: - ``` - npm install - node_modules/grunt-cli/bin/grunt test:sauce:parallel - ``` - - d. Si desea ver los informes de las pruebas en los registros del trabajo de prueba, seleccione el recuadro de selección **Enable Test Report** y establezca el valor de Test Result File Pattern en `test/*.xml`. - -1. Pulse **SAVE**. Siempre que se ejecute su conducto, se ejecutarán las pruebas de Sauce Labs. - -Para obtener más información, consulte [Conducto de entrega (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}. - - -## Adición de {{site.data.keyword.DRA_short}} -{: #dra} - -{{site.data.keyword.DRA_full}} recopila y analiza los resultados de las pruebas de unidad, de las pruebas funcionales y de las herramientas de cobertura de código para determinar si el código cumple los criterios predefinidos en las puertas especificadas del proceso de despliegue. Si el código no cumple o excede los criterios, el despliegue se detiene para evitar la exposición a riesgos. Puede utilizar {{site.data.keyword.DRA_short}} como red de seguridad para el entorno de entrega continuada o como método para implementar y mejorar los estándares de calidad. - - **Nota**: esta integración de herramientas está preconfigurada. No es necesario configurar ningún parámetro y tampoco es posible modificar la configuración existente. - -Añada {{site.data.keyword.DRA_short}} para mantener y mejorar la calidad de su código en {{site.data.keyword.Bluemix_notm}} supervisando las implementaciones para identificar los riesgos antes de distribuir la aplicación. - -1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. Pulse el botón de adición (+). -1. En la sección Tool Integrations, pulse **Deployment Risk Analytics**. -1. Pulse **Create Integration**. -1. Pulse el mosaico para {{site.data.keyword.DRA_short}} y, a continuación, complete los primeros pasos: crear criterios, conectar los criterios al conducto y ejecutar el conducto. Para obtener más información, consulte [{{site.data.keyword.DRA_short}} (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}. - - -## Adición de Eclipse Orion {{site.data.keyword.webide}} -{: #webide} - -Eclipse Orion {{site.data.keyword.webide}} es un entorno integrado basado en web en el que puede crear, editar, ejecutar, depurar y controlar las tareas de control del código fuente. Puede pasar sin problemas de editar a ejecutar, enviar y desplegar. - - **Nota**: esta integración de herramientas está preconfigurada. No es necesario configurar ningún parámetro y tampoco es posible modificar la configuración existente. - -Para completar las tareas de control del código fuente, añada la integración de herramientas Eclipse Orion {{site.data.keyword.webide}}: - -1. Si tiene una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Público y añade esta integración de herramientas a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. Si utiliza una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Dedicado, en el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Integraciones de herramientas. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. Pulse el botón de adición (+). -1. En la sección Tool Integrations, pulse **Eclipse Orion Web IDE**. -1. Pulse **Create Integration**. -1. Pulse el mosaico para el nuevo Eclipse Orion {{site.data.keyword.webide}}. El espacio de trabajo ya contiene los repositorios de GitHub o {{site.data.keyword.ghe_short}}. Los repositorios que están asociados a la cadena de herramientas actual aparecen resaltados. - -Para obtener más información, consulte [Edición de código con Eclipse Orion {{site.data.keyword.webide}} (El enlace se abre en una ventana nueva)](../toolchains/web_ide.html){: new_window}. - - -## Configuración de GitHub -{: #github} - -GitHub es un servicio de alojamiento basado en web para repositorios Git. Puede tener copias locales y remotas de sus repositorios, lo que facilita la colaboración. - -GitHub Issues es una herramienta de seguimiento que mantiene todo su trabajo y sus planificaciones en un mismo lugar. Está integrado con el repositorio de desarrollo de modo que pueda centrarse en las tareas importantes. - -Configure GitHub para gestionar el código fuente en la nube: - -1. Si configura la integración de esta herramienta mientras crea la cadena de herramientas, siga estos pasos: - - a. En la sección Configurable Integrations, pulse **GitHub**. Si está creando la cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Público y no ha autorizado a {{site.data.keyword.Bluemix_notm}} acceso a GitHub, pulse **Authorize** para ir al sitio web de GitHub. Si no tiene ninguna sesión de GitHub activa, se le solicitará que inicie sesión. Pulse **Authorize Application** para permitir que {{site.data.keyword.Bluemix_notm}} acceda a su cuenta de GitHub. Si tiene una sesión activa de GitHub pero no ha introducido recientemente su contraseña, es posible que se le solicite que introduzca la contraseña de GitHub para confirmarla. - - b. Revise las ubicaciones de repositorio de destino predeterminadas para el repositorio de GitHub. Dichos repositorios se clonan a partir del repositorio de ejemplo. Si es necesario, cambie el nombre de los repositorios de destino. - ![Ubicaciones de repositorio de destino predeterminadas](images/toolchain_github_config.png) - -1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. Pulse el botón de adición (+). -1. En la sección Tool Integrations, pulse **GitHub**. -1. Si tiene un repositorio de GitHub y desea utilizarlo, escriba el URL. Para el tipo de repositorio, pulse **Link**. -1. Si desea utilizar un repositorio nuevo de GitHub, escriba un nombre para el repositorio de GitHub, escriba el URL del repositorio que está clonando o bifurcando y seleccione el tipo de repositorio: - - a. Para crear un repositorio vacío, pulse **New**. - - b. Para crear una copia de un repositorio de GitHub, pulse **Clone**. - - c. Para bifurcar un repositorio de GitHub de modo que pueda aportar cambios a través de todas las solicitudes de extracción, pulse **Fork**. - -1. Si desea utilizar GitHub Issues para realizar un seguimiento de los problemas, seleccione el recuadro de selección **Enable GitHub Issues**. -1. Pulse **Create Integration**. -1. Pulse el mosaico del repositorio de GitHub con el que desee trabajar. Se abrirá el sitio web de GitHub, donde puede ver el contenido del repositorio. - - **Consejo**: puede utilizar estas herramientas integradas de gestión del código fuente en Eclipse Orion {{site.data.keyword.webide}} para editar el repositorio de GitHub y desplegar una app desde su espacio de trabajo. - -1. Si ha habilitado GitHub Issues, pulse el mosaico de GitHub Issues para abrirlo. - -Para obtener más información, consulte [GitHub (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} y [GitHub Issues (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. - - -## Configuración de GitHub Enterprise Dedicado -{: #configghe} - -{{site.data.keyword.ghe_long}} es un servicio de alojamiento basado en web para repositorios Git. GitHub Enterprise Dedicado es únicamente para clientes de {{site.data.keyword.Bluemix_notm}} Dedicado. GitHub Issues es una herramienta de seguimiento que mantiene todo su trabajo y sus planificaciones en un mismo lugar. Está integrado con el repositorio de desarrollo de modo que pueda centrarse en las tareas importantes. Para obtener más información sobre GitHub Enterprise Dedicado y GitHub Issues, consulte [Uso de GitHub Enterprise Dedicado (El enlace se abre en una ventana nueva)](../services/ghededicated/index.html){: new_window} y [GitHub Issues (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. - -Puede configurar {{site.data.keyword.ghe_short}} como una integración de herramientas de la cadena de herramientas para que pueda gestionar el código fuente en la instancia de [{{site.data.keyword.Bluemix_notm}} Dedicado de la empresa (El enlace se abre en una ventana nueva)](../dedicated/index.html#dedicated){: new_window}. - -1. Si configura la integración de esta herramienta mientras crea la cadena de herramientas, siga estos pasos: - - a. Antes de iniciar sesión en GitHub Enterprise Dedicado por primera vez, pida al administrador de región de su empresa que añada su ID de usuario a la instancia de {{site.data.keyword.Bluemix_notm}} Dedicado desde el registro de usuario de la empresa utilizando LDAP. Para obtener información sobre cómo configurar la cuenta de {{site.data.keyword.ghe_short}}, consulte [Uso de GitHub Enterprise Dedicado (El enlace se abre en una ventana nueva)](../services/ghededicated/index.html){: new_window}. - - b. En la sección Configurable Integrations, pulse **{{site.data.keyword.ghe_short}}**. - - c. Revise el nombre predeterminado para el nuevo repositorio de {{site.data.keyword.ghe_short}}. Si es necesario, cambie el nombre del repositorio nuevo. La siguiente imagen muestra un ejemplo de un repositorio clonado desde un repositorio de ejemplo. Puede utilizar un repositorio existente o uno nuevo. Para utilizar un repositorio nuevo, puede crear un repositorio vacío, clonarlo o bifurcarlo. - ![Ubicaciones de repositorio predeterminado](images/toolchain_ghe_config.png) - -1. Si tiene una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Público y añade esta integración de herramientas a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Continuous Delivery, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. Si utiliza una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Dedicado, en el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Integraciones de herramientas. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. Pulse el botón de adición (+). -1. En la sección Tool Integrations, pulse **{{site.data.keyword.ghe_short}}**. -1. Si tiene un repositorio de {{site.data.keyword.ghe_short}} que desea utilizar, escriba el URL para el repositorio. Para el tipo de repositorio, pulse **Existing**. -1. Si desea utilizar un repositorio nuevo de {{site.data.keyword.ghe_short}}, escriba un nombre para el repositorio, escriba el URL del repositorio que está clonando o bifurcando y seleccione el tipo de repositorio: - - a. Para crear un repositorio vacío, pulse **New**. - - b. Para crear una copia de un repositorio, pulse **Clone**. - - c. Para bifurcar un repositorio de modo que pueda aportar cambios a través de todas las solicitudes de extracción, pulse **Fork**. - -1. Para utilizar GitHub Issues para realizar un seguimiento de los problemas, seleccione el recuadro de selección **Enable GitHub Issues**. -1. Pulse **Create Integration**. -1. Pulse el mosaico del repositorio de {{site.data.keyword.ghe_short}} con el que desee trabajar. Se abrirá la instancia de [{{site.data.keyword.Bluemix_notm}} Dedicado de la empresa (El enlace se abre en una ventana nueva)](../dedicated/index.html#dedicated){: new_window}, donde puede ver el contenido del repositorio. - - **Consejo**: puede utilizar estas herramientas integradas de gestión del código fuente en Eclipse Orion {{site.data.keyword.webide}} para editar el repositorio de {{site.data.keyword.ghe_short}} y desplegar una app desde su espacio de trabajo. - -1. Si ha habilitado GitHub Issues, pulse el mosaico de GitHub Issues. - - - -## Configuración de una herramienta personalizada (Otras herramientas) -{: #othertool} - -Si el equipo utiliza una herramienta no incluida en la lista de integraciones de las cadenas de herramientas, puede integrar una herramienta personalizada. - -Configure una herramienta personalizada para que funcione con otras herramientas de la cadena de herramientas y que esté disponible para el equipo: -1. Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Configurable Integrations, pulse **Other Tool**. - -1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. Pulse el botón de adición (+). -1. En la sección Tool Integrations, pulse **Other Tool**. -1. Escriba el nombre de la herramienta. -1. Seleccione la fase del Ciclo de vida que esté asociada de forma más cercana con la herramienta. La elección de la fase del ciclo de vida determina en qué categoría está listada la herramienta en la página Toolchains Integrations. -1. Añada un URL de icono. El icono aparecerá en la tarjeta de integración de la herramienta. -1. Añada un URL de documentación. -1. Especifique un nombre de instancia de la herramienta. Por ejemplo: My Team Tool. -1. Añada un URL de instancia de herramienta. Pulsar la tarjeta de integración de la herramienta le llevará al URL que liste para la instancia de herramientas. -1. Añada una descripción de la herramienta. -1. (Avanzado) Añada propiedades adicional si es necesario. Por ejemplo, liste cualquier información o atributos necesarios para que la herramienta se integre con otras herramientas en la cadena de herramientas. -1. Pulse **Create Integration**. - -## Configuración de PagerDuty -{: #pagerduty} - -PagerDuty integra datos de varios sistemas de supervisión en una única vista. Cuando se produce un problema, PagerDuty se asegura de que el miembro del equipo más adecuado para corregirlo reciba una notificación. Si el miembro del equipo no responde al problema, pueden configurarse sistemas de escalado para pasar el problema a ingenieros o gestores de operaciones secundarios. - -Configure PagerDuty para enviar notificaciones cuando se producen errores en la fase de conducto para que pueda corregir los problemas con mayor celeridad y reducir el tiempo de inactividad: - -1. Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Configurable Integrations, pulse **PagerDuty**. -1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. Pulse el botón de adición (+). -1. En la sección Tool Integrations, pulse **PagerDuty**. -1. Escriba el nombre del sitio de PagerDuty asociado con su cuenta de PagerDuty. Si no tiene ninguna cuenta de PagerDuty, [regístrese en una (El enlace se abre en una ventana nueva)](https://signup.pagerduty.com/accounts/new){: new_window}. -1. Escriba la clave de acceso de API para su cuenta de PagerDuty. Para obtener instrucciones sobre cómo encontrar la clave, consulte [Autenticación de API (El enlace se abre en una ventana nueva)](https://signup.pagerduty.com/accounts/new){: new_window}. -1. Escriba el nombre del servicio PagerDuty. -1. Escriba la dirección de correo electrónico del contacto principal de PagerDuty. -1. Escriba el número de teléfono del contacto principal de PagerDuty. -1. Pulse **Create Integration**. -1. Pulse el mosaico de PagerDuty para ir a pagerduty.com. Puede ver los sucesos asociados con el servicio PagerDuty que ha especificado al configurar la integración de esta herramienta para su cadena de herramientas. - -Para obtener más información, consulte [PagerDuty (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}. - - -## Configuración de Sauce Labs -{: #saucelabs} - -Sauce Labs ejecuta pruebas de unidad funcionales. Cuando se configura una suite de pruebas de Sauce Labs como trabajo de pruebas en {{site.data.keyword.deliverypipeline}}, la suite de pruebas puede ejecutar pruebas para la app web o móvil como parte del proceso de entrega continuo. Estas pruebas pueden proporcionar un control de flujo muy valioso para los proyectos, y actuar como pasarelas para evitar el despliegue de código defectuoso. - -Configure Sauce Labs para ejecutar pruebas funcionales automatizadas en varios sistemas operativos y navegadores a fin de poder emular el modo en que el usuario puede utilizar un sitio web o una aplicación: - -1. Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Configurable Integrations, pulse **Sauce Labs**. -1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. Pulse el botón de adición (+). -1. En la sección Tool Integrations, pulse **Sauce Labs**. -1. Escriba el nombre de usuario asociado con su cuenta de Sauce Labs. Puede [encontrar su nombre de usuario en el mensaje de bienvenida de la parte superior de la página de la cuenta de Sauce Labs (El enlace se abre en una ventana nueva)](https://saucelabs.com/account){: new_window}. -1. Escriba la clave de acceso para su cuenta de Sauce Labs. Puede [encontrar la clave en la página de la cuenta de Sauce Labs (El enlace se abre en una ventana nueva)](https://saucelabs.com/account){: new_window}. -1. Pulse **Create Integration**. -1. Pulse el mosaico de Sauce Labs para ir a saucelabs.com y verla actividad de prueba para la cadena de herramientas. - - **Consejo**: si ha añadido un trabajo de pruebas de Sauce Labs al {{site.data.keyword.deliverypipeline}}, puede seleccionar la instancia del servicio. - -Para obtener más información, consulte [Sauce Labs (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}. - - -## Configuración de Slack -{: #slack} - -**Importante**: las notificaciones que se publican en canales Slack públicos son visibles para todas las personas del equipo. Recuerde que es responsable de todo el contenido que publique. - -Slack es un sistema de notificaciones y mensajería en tiempo real y basado en la nube. Slack proporciona una función de chat permanente, que es una alternativa más interactiva que el correo electrónico para facilitar la colaboración del equipo. Puede comunicarse con su equipo en un canal dedicado o en un conjunto de canales directamente relacionados con su trabajo. Asimismo, puede compartir archivos e imágenes a través de los canales o a través de mensajes directos entre dos o más personas. Las comunicaciones en los mensajes directos y en los canales se conservan para poder realizar búsquedas. - -Configure Slack para recibir notificaciones acerca de su cadena de herramientas desde las integraciones de herramientas, como actividades de prueba y de despliegue: - -1. Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Configurable Integrations, pulse **Slack**. -1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. Pulse el botón de adición (+). -1. En la sección Tool Integrations, pulse **Slack**. -1. Escriba la señal de autenticación de API para su cuenta de Slack. Debe utilizar la señal con acceso completo garantizado para autenticarse con Slack. Para obtener instrucciones sobre cómo encontrar la señal, consulte [Autenticación de Slack (El enlace se abre en una ventana nueva)](https://api.slack.com/web#authentication){: new_window}. -1. Escriba el nombre del canal Slack al que desea enviar las notificaciones. Si el canal que intenta especificar no existe, se crea. Si el canal se ha archivado, se reactiva. -1. Pulse **Create Integration**. -1. Pulse el mosaico de Slack. Puede ver toda la actividad de su cadena de herramientas en el canal Slack configurado. - -Para obtener más información, consulte [Slack (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}. - - - - - - - - +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configuración de la integración de herramientas +{: #integrations} + +Última actualización: 18 de octubre de 2016 +{: .last-updated} + +Puede configurar integraciones de herramientas que admitan tareas de desarrollo, despliegue y operaciones mientras crea una cadena de herramientas, o bien puede añadir y configurar integraciones de herramientas para personalizar una cadena de herramientas existente. +{:shortdesc} + +**Importante**: En {{site.data.keyword.Bluemix_notm}} Público, las cadenas de herramientas están disponibles únicamente en el sur de EE. UU. + +Las integraciones de herramientas que están disponibles para añadirse y configurarse para la cadena de herramientas son distintas en función de si está utilizando cadenas de herramientas en {{site.data.keyword.Bluemix_notm}} Público o {{site.data.keyword.Bluemix_notm}} Dedicado. Si está utilizando cadenas de herramientas en {{site.data.keyword.Bluemix_notm}} Dedicado, las integraciones de herramientas disponibles para usted dependerán de cómo se haya configurado {{site.data.keyword.jazzhub_title}} en el entorno específico. + +*Tabla 1. Integraciones de herramientas disponibles para cadenas de herramientas en {{site.data.keyword.Bluemix_notm}} Público y Dedicado* + +|Integración de herramientas |Disponible en {{site.data.keyword.Bluemix_notm}} Público |Disponible en {{site.data.keyword.Bluemix_notm}} Dedicado (dependiente del entorno)| +|:----------|:------------------------------|:------------------| +|{{site.data.keyword.deliverypipeline}} |Sí |Sí | +|{{site.data.keyword.DRA_short}} |Sí |No | +|Eclipse Orion {{site.data.keyword.webide}} |Sí |Sí | +|GitHub |Sí |Sí | +|GitHub Enterprise Dedicado |No |Sí | +|Otras herramientas |Sí |Sí | +|PagerDuty |Sí |Sí | +|Sauce Labs |Sí |No | +|Slack |Sí |Sí | + +**Consejo**: si desea empezar a desarrollar su propio código en {{site.data.keyword.Bluemix_notm}} Público, configure la integración de herramientas GitHub antes de configurar el {{site.data.keyword.deliverypipeline}}. Si desea empezar a desarrollar su propio código en {{site.data.keyword.Bluemix_notm}} Dedicado, configure la integración de herramientas {{site.data.keyword.ghe_short}} o la integración de herramientas GitHub antes de configurar el {{site.data.keyword.deliverypipeline}}. + + +## Configuración del conducto de entrega +{: #deliverypipeline} + +El {{site.data.keyword.deliverypipeline}} automatiza el despliegue continuado de los proyectos a través de secuencias de fases que recuperan entradas y ejecutan trabajos, como compilaciones, pruebas y despliegues. + +Configure el {{site.data.keyword.deliverypipeline}} para automatizar la creación, las pruebas y el despliegue automáticos de sus apps: + +1. Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Configurable Integrations, pulse **Delivery Pipeline**. En función de la plantilla que utilice, los campos disponibles serán distintos. Revise los valores del campo predeterminado y, si es necesario, realice cambios. +1. Si tiene una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Público y añade esta integración de herramientas a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Continuous Delivery, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. Si utiliza una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Dedicado, en el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Integraciones de herramientas. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. Pulse el botón de adición (+). +1. En la sección Tool Integrations, pulse **Delivery Pipeline**. +1. Especifique un nombre para el nuevo conducto. +1. Si tiene previsto utilizar el conducto para desplegar una interfaz de usuario, seleccione el recuadro de selección **Viewable App**. Todas las apps creadas por el conducto se muestran en la lista **VIEW APP** de la página Tool Integrations de la cadena de herramientas. +1. Pulse **Create Integration** para añadir el {{site.data.keyword.deliverypipeline}} a la cadena de herramientas. +1. Pulse el mosaico para {{site.data.keyword.deliverypipeline}} para ver el conducto y configurarlo. Para obtener información básica sobre cómo configurar un conducto, consulte [Creación y despliegue de conductos (El enlace se abre en una ventana nueva)](../services/DeliveryPipeline/build_deploy.html){: new_window}. + + **Consejo**: si desea activar el conducto al transferir cambios al repositorio (repo) de GitHub o {{site.data.keyword.ghe_short}}, debe configurar GitHub o {{site.data.keyword.ghe_short}} para la cadena de herramientas antes de definir las fases del conducto. Las fases del conducto necesitan los URL Git para los repositorios. Cada fase de conducto puede hacer referencia a un único repositorio de GitHub o {{site.data.keyword.ghe_short}} que esté asociado con la cadena de herramientas. Para obtener instrucciones sobre cómo configurar GitHub, consulte la sección [GitHub](#github). Para obtener instrucciones sobre cómo configurar GitHub Enterprise Dedicado, consulte [Iniciación a {{site.data.keyword.ghe_long}} (El enlace se abre en una ventana nueva)](../services/ghededicated/index.html){: new_window}. + +1. Opcional: si utiliza una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Público y desea que Sauce Labs ejecute pruebas en la app, configure el {{site.data.keyword.deliverypipeline}} para añadir el trabajo de pruebas Sauce Labs. Para obtener instrucciones sobre cómo configurar el trabajo de pruebas, consulte [Configuración de un trabajo de pruebas Sauce Labs en el conducto](#config_saucelabs). + +### Configuración de un trabajo de pruebas Sauce Labs en el conducto +{: #config_saucelabs} + +Antes de configurar un trabajo de pruebas Sauce Labs en el conducto, necesita un conducto de trabajo que incluya fases para crear y desplegar la app, y debe configurar Sauce Labs para su cadena de herramientas. Para obtener instrucciones sobre cómo configurar Sauce Labs, consulte la sección [Sauce Labs](#saucelabs). + +Configure el {{site.data.keyword.deliverypipeline}} para añadir un trabajo de pruebas Sauce Labs: + +1. Si no tiene ninguna fase que despliegue una versión de pruebas de su app, cree una. +1. En la fase, añada un trabajo de prueba después del trabajo de despliegue. Disponer de estos trabajos en la misma fase permite que accedan al mismo conjunto de propiedades del entorno. + ![Trabajo de prueba](images/toolchain_test_job.png) + +1. Configure la fase: + + a. En el separador **ENVIRONMENT PROPERTIES**, cree tres propiedades: CF_APP_NAME, SAUCE_USERNAME y SAUCE_ACCESS_KEY. + + b. Introduzca su nombre de usuario y clave de acceso para Sauce Labs. De este modo, externaliza estos valores para poder utilizarlos en sus pruebas. + +1. Configure el trabajo de despliegue. En el campo **Deploy Script**, incluya este mandato: `export CF_APP_NAME="$CF_APP"`. Este mandato exporta el nombre de la app como propiedad del entorno. +1. Configure el trabajo de prueba. Los valores de la imagen siguiente son ejemplos. Los campos **Service Instance**, **Target**, **Organization** y **Space** se rellenan con el nombre de usuario de Sauce Labs, la región, la organización y el espacio que se está utilizando. +![Trabajo de configuración](images/toolchain_configure_job.png) + + a. Para el tipo de prueba, seleccione **Sauce Labs**. + + b. Para la instancia de servicio, seleccione el nombre de usuario de Sauce Labs que ha utilizado al configurar Sauce Labs para su cadena de herramientas. + + **Consejo**: para ver el nombre de usuario y la clave de acceso que ha utilizado al configurar Sauce Labs para su cadena de herramientas, pulse **Configurar**. + + c. En el campo **Test Execution Command**, especifique los mandatos que instalan las dependencias necesarias para las pruebas y, a continuación, ejecute las pruebas. Por ejemplo, para una app Node.js, puede introducir estos mandatos: + ``` + npm install + node_modules/grunt-cli/bin/grunt test:sauce:parallel + ``` + + d. Si desea ver los informes de las pruebas en los registros del trabajo de prueba, seleccione el recuadro de selección **Enable Test Report** y establezca el valor de Test Result File Pattern en `test/*.xml`. + +1. Pulse **SAVE**. Siempre que se ejecute su conducto, se ejecutarán las pruebas de Sauce Labs. + +Para obtener más información, consulte [Conducto de entrega (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}. + + +## Adición de {{site.data.keyword.DRA_short}} +{: #dra} + +{{site.data.keyword.DRA_full}} recopila y analiza los resultados de las pruebas de unidad, de las pruebas funcionales y de las herramientas de cobertura de código para determinar si el código cumple los criterios predefinidos en las puertas especificadas del proceso de despliegue. Si el código no cumple o excede los criterios, el despliegue se detiene para evitar la exposición a riesgos. Puede utilizar {{site.data.keyword.DRA_short}} como red de seguridad para el entorno de entrega continuada o como método para implementar y mejorar los estándares de calidad. + + **Nota**: esta integración de herramientas está preconfigurada. No es necesario configurar ningún parámetro y tampoco es posible modificar la configuración existente. + +Añada {{site.data.keyword.DRA_short}} para mantener y mejorar la calidad de su código en {{site.data.keyword.Bluemix_notm}} supervisando las implementaciones para identificar los riesgos antes de distribuir la aplicación. + +1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. Pulse el botón de adición (+). +1. En la sección Tool Integrations, pulse **Deployment Risk Analytics**. +1. Pulse **Create Integration**. +1. Pulse el mosaico para {{site.data.keyword.DRA_short}} y, a continuación, complete los primeros pasos: crear criterios, conectar los criterios al conducto y ejecutar el conducto. Para obtener más información, consulte [{{site.data.keyword.DRA_short}} (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}. + + +## Adición de Eclipse Orion {{site.data.keyword.webide}} +{: #webide} + +Eclipse Orion {{site.data.keyword.webide}} es un entorno integrado basado en web en el que puede crear, editar, ejecutar, depurar y controlar las tareas de control del código fuente. Puede pasar sin problemas de editar a ejecutar, enviar y desplegar. + + **Nota**: esta integración de herramientas está preconfigurada. No es necesario configurar ningún parámetro y tampoco es posible modificar la configuración existente. + +Para completar las tareas de control del código fuente, añada la integración de herramientas Eclipse Orion {{site.data.keyword.webide}}: + +1. Si tiene una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Público y añade esta integración de herramientas a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. Si utiliza una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Dedicado, en el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Integraciones de herramientas. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. Pulse el botón de adición (+). +1. En la sección Tool Integrations, pulse **Eclipse Orion Web IDE**. +1. Pulse **Create Integration**. +1. Pulse el mosaico para el nuevo Eclipse Orion {{site.data.keyword.webide}}. El espacio de trabajo ya contiene los repositorios de GitHub o {{site.data.keyword.ghe_short}}. Los repositorios que están asociados a la cadena de herramientas actual aparecen resaltados. + +Para obtener más información, consulte [Edición de código con Eclipse Orion {{site.data.keyword.webide}} (El enlace se abre en una ventana nueva)](../toolchains/web_ide.html){: new_window}. + + +## Configuración de GitHub +{: #github} + +GitHub es un servicio de alojamiento basado en web para repositorios Git. Puede tener copias locales y remotas de sus repositorios, lo que facilita la colaboración. + +GitHub Issues es una herramienta de seguimiento que mantiene todo su trabajo y sus planificaciones en un mismo lugar. Está integrado con el repositorio de desarrollo de modo que pueda centrarse en las tareas importantes. + +Configure GitHub para gestionar el código fuente en la nube: + +1. Si configura la integración de esta herramienta mientras crea la cadena de herramientas, siga estos pasos: + + a. En la sección Configurable Integrations, pulse **GitHub**. Si está creando la cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Público y no ha autorizado a {{site.data.keyword.Bluemix_notm}} acceso a GitHub, pulse **Authorize** para ir al sitio web de GitHub. Si no tiene ninguna sesión de GitHub activa, se le solicitará que inicie sesión. Pulse **Authorize Application** para permitir que {{site.data.keyword.Bluemix_notm}} acceda a su cuenta de GitHub. Si tiene una sesión activa de GitHub pero no ha introducido recientemente su contraseña, es posible que se le solicite que introduzca la contraseña de GitHub para confirmarla. + + b. Revise las ubicaciones de repositorio de destino predeterminadas para el repositorio de GitHub. Dichos repositorios se clonan a partir del repositorio de ejemplo. Si es necesario, cambie el nombre de los repositorios de destino. + ![Ubicaciones de repositorio de destino predeterminadas](images/toolchain_github_config.png) + +1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. Pulse el botón de adición (+). +1. En la sección Tool Integrations, pulse **GitHub**. +1. Si tiene un repositorio de GitHub y desea utilizarlo, escriba el URL. Para el tipo de repositorio, pulse **Link**. +1. Si desea utilizar un repositorio nuevo de GitHub, escriba un nombre para el repositorio de GitHub, escriba el URL del repositorio que está clonando o bifurcando y seleccione el tipo de repositorio: + + a. Para crear un repositorio vacío, pulse **New**. + + b. Para crear una copia de un repositorio de GitHub, pulse **Clone**. + + c. Para bifurcar un repositorio de GitHub de modo que pueda aportar cambios a través de todas las solicitudes de extracción, pulse **Fork**. + +1. Si desea utilizar GitHub Issues para realizar un seguimiento de los problemas, seleccione el recuadro de selección **Enable GitHub Issues**. +1. Pulse **Create Integration**. +1. Pulse el mosaico del repositorio de GitHub con el que desee trabajar. Se abrirá el sitio web de GitHub, donde puede ver el contenido del repositorio. + + **Consejo**: puede utilizar estas herramientas integradas de gestión del código fuente en Eclipse Orion {{site.data.keyword.webide}} para editar el repositorio de GitHub y desplegar una app desde su espacio de trabajo. + +1. Si ha habilitado GitHub Issues, pulse el mosaico de GitHub Issues para abrirlo. + +Para obtener más información, consulte [GitHub (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} y [GitHub Issues (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. + + +## Configuración de GitHub Enterprise Dedicado +{: #configghe} + +{{site.data.keyword.ghe_long}} es un servicio de alojamiento basado en web para repositorios Git. GitHub Enterprise Dedicado es únicamente para clientes de {{site.data.keyword.Bluemix_notm}} Dedicado. GitHub Issues es una herramienta de seguimiento que mantiene todo su trabajo y sus planificaciones en un mismo lugar. Está integrado con el repositorio de desarrollo de modo que pueda centrarse en las tareas importantes. Para obtener más información sobre GitHub Enterprise Dedicado y GitHub Issues, consulte [Uso de GitHub Enterprise Dedicado (El enlace se abre en una ventana nueva)](../services/ghededicated/index.html){: new_window} y [GitHub Issues (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. + +Puede configurar {{site.data.keyword.ghe_short}} como una integración de herramientas de la cadena de herramientas para que pueda gestionar el código fuente en la instancia de [{{site.data.keyword.Bluemix_notm}} Dedicado de la empresa (El enlace se abre en una ventana nueva)](../dedicated/index.html#dedicated){: new_window}. + +1. Si configura la integración de esta herramienta mientras crea la cadena de herramientas, siga estos pasos: + + a. Antes de iniciar sesión en GitHub Enterprise Dedicado por primera vez, pida al administrador de región de su empresa que añada su ID de usuario a la instancia de {{site.data.keyword.Bluemix_notm}} Dedicado desde el registro de usuario de la empresa utilizando LDAP. Para obtener información sobre cómo configurar la cuenta de {{site.data.keyword.ghe_short}}, consulte [Uso de GitHub Enterprise Dedicado (El enlace se abre en una ventana nueva)](../services/ghededicated/index.html){: new_window}. + + b. En la sección Configurable Integrations, pulse **{{site.data.keyword.ghe_short}}**. + + c. Revise el nombre predeterminado para el nuevo repositorio de {{site.data.keyword.ghe_short}}. Si es necesario, cambie el nombre del repositorio nuevo. La siguiente imagen muestra un ejemplo de un repositorio clonado desde un repositorio de ejemplo. Puede utilizar un repositorio existente o uno nuevo. Para utilizar un repositorio nuevo, puede crear un repositorio vacío, clonarlo o bifurcarlo. + ![Ubicaciones de repositorio predeterminado](images/toolchain_ghe_config.png) + +1. Si tiene una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Público y añade esta integración de herramientas a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Continuous Delivery, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. Si utiliza una cadena de herramientas en {{site.data.keyword.Bluemix_notm}} Dedicado, en el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Integraciones de herramientas. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. Pulse el botón de adición (+). +1. En la sección Tool Integrations, pulse **{{site.data.keyword.ghe_short}}**. +1. Si tiene un repositorio de {{site.data.keyword.ghe_short}} que desea utilizar, escriba el URL para el repositorio. Para el tipo de repositorio, pulse **Existing**. +1. Si desea utilizar un repositorio nuevo de {{site.data.keyword.ghe_short}}, escriba un nombre para el repositorio, escriba el URL del repositorio que está clonando o bifurcando y seleccione el tipo de repositorio: + + a. Para crear un repositorio vacío, pulse **New**. + + b. Para crear una copia de un repositorio, pulse **Clone**. + + c. Para bifurcar un repositorio de modo que pueda aportar cambios a través de todas las solicitudes de extracción, pulse **Fork**. + +1. Para utilizar GitHub Issues para realizar un seguimiento de los problemas, seleccione el recuadro de selección **Enable GitHub Issues**. +1. Pulse **Create Integration**. +1. Pulse el mosaico del repositorio de {{site.data.keyword.ghe_short}} con el que desee trabajar. Se abrirá la instancia de [{{site.data.keyword.Bluemix_notm}} Dedicado de la empresa (El enlace se abre en una ventana nueva)](../dedicated/index.html#dedicated){: new_window}, donde puede ver el contenido del repositorio. + + **Consejo**: puede utilizar estas herramientas integradas de gestión del código fuente en Eclipse Orion {{site.data.keyword.webide}} para editar el repositorio de {{site.data.keyword.ghe_short}} y desplegar una app desde su espacio de trabajo. + +1. Si ha habilitado GitHub Issues, pulse el mosaico de GitHub Issues. + + + +## Configuración de una herramienta personalizada (Otras herramientas) +{: #othertool} + +Si el equipo utiliza una herramienta no incluida en la lista de integraciones de las cadenas de herramientas, puede integrar una herramienta personalizada. + +Configure una herramienta personalizada para que funcione con otras herramientas de la cadena de herramientas y que esté disponible para el equipo: +1. Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Configurable Integrations, pulse **Other Tool**. + +1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. Pulse el botón de adición (+). +1. En la sección Tool Integrations, pulse **Other Tool**. +1. Escriba el nombre de la herramienta. +1. Seleccione la fase del Ciclo de vida que esté asociada de forma más cercana con la herramienta. La elección de la fase del ciclo de vida determina en qué categoría está listada la herramienta en la página Toolchains Integrations. +1. Añada un URL de icono. El icono aparecerá en la tarjeta de integración de la herramienta. +1. Añada un URL de documentación. +1. Especifique un nombre de instancia de la herramienta. Por ejemplo: My Team Tool. +1. Añada un URL de instancia de herramienta. Pulsar la tarjeta de integración de la herramienta le llevará al URL que liste para la instancia de herramientas. +1. Añada una descripción de la herramienta. +1. (Avanzado) Añada propiedades adicional si es necesario. Por ejemplo, liste cualquier información o atributos necesarios para que la herramienta se integre con otras herramientas en la cadena de herramientas. +1. Pulse **Create Integration**. + +## Configuración de PagerDuty +{: #pagerduty} + +PagerDuty integra datos de varios sistemas de supervisión en una única vista. Cuando se produce un problema, PagerDuty se asegura de que el miembro del equipo más adecuado para corregirlo reciba una notificación. Si el miembro del equipo no responde al problema, pueden configurarse sistemas de escalado para pasar el problema a ingenieros o gestores de operaciones secundarios. + +Configure PagerDuty para enviar notificaciones cuando se producen errores en la fase de conducto para que pueda corregir los problemas con mayor celeridad y reducir el tiempo de inactividad: + +1. Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Configurable Integrations, pulse **PagerDuty**. +1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. Pulse el botón de adición (+). +1. En la sección Tool Integrations, pulse **PagerDuty**. +1. Escriba el nombre del sitio de PagerDuty asociado con su cuenta de PagerDuty. Si no tiene ninguna cuenta de PagerDuty, [regístrese en una (El enlace se abre en una ventana nueva)](https://signup.pagerduty.com/accounts/new){: new_window}. +1. Escriba la clave de acceso de API para su cuenta de PagerDuty. Para obtener instrucciones sobre cómo encontrar la clave, consulte [Autenticación de API (El enlace se abre en una ventana nueva)](https://signup.pagerduty.com/accounts/new){: new_window}. +1. Escriba el nombre del servicio PagerDuty. +1. Escriba la dirección de correo electrónico del contacto principal de PagerDuty. +1. Escriba el número de teléfono del contacto principal de PagerDuty. +1. Pulse **Create Integration**. +1. Pulse el mosaico de PagerDuty para ir a pagerduty.com. Puede ver los sucesos asociados con el servicio PagerDuty que ha especificado al configurar la integración de esta herramienta para su cadena de herramientas. + +Para obtener más información, consulte [PagerDuty (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}. + + +## Configuración de Sauce Labs +{: #saucelabs} + +Sauce Labs ejecuta pruebas de unidad funcionales. Cuando se configura una suite de pruebas de Sauce Labs como trabajo de pruebas en {{site.data.keyword.deliverypipeline}}, la suite de pruebas puede ejecutar pruebas para la app web o móvil como parte del proceso de entrega continuo. Estas pruebas pueden proporcionar un control de flujo muy valioso para los proyectos, y actuar como pasarelas para evitar el despliegue de código defectuoso. + +Configure Sauce Labs para ejecutar pruebas funcionales automatizadas en varios sistemas operativos y navegadores a fin de poder emular el modo en que el usuario puede utilizar un sitio web o una aplicación: + +1. Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Configurable Integrations, pulse **Sauce Labs**. +1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. Pulse el botón de adición (+). +1. En la sección Tool Integrations, pulse **Sauce Labs**. +1. Escriba el nombre de usuario asociado con su cuenta de Sauce Labs. Puede [encontrar su nombre de usuario en el mensaje de bienvenida de la parte superior de la página de la cuenta de Sauce Labs (El enlace se abre en una ventana nueva)](https://saucelabs.com/account){: new_window}. +1. Escriba la clave de acceso para su cuenta de Sauce Labs. Puede [encontrar la clave en la página de la cuenta de Sauce Labs (El enlace se abre en una ventana nueva)](https://saucelabs.com/account){: new_window}. +1. Pulse **Create Integration**. +1. Pulse el mosaico de Sauce Labs para ir a saucelabs.com y verla actividad de prueba para la cadena de herramientas. + + **Consejo**: si ha añadido un trabajo de pruebas de Sauce Labs al {{site.data.keyword.deliverypipeline}}, puede seleccionar la instancia del servicio. + +Para obtener más información, consulte [Sauce Labs (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}. + + +## Configuración de Slack +{: #slack} + +**Importante**: las notificaciones que se publican en canales Slack públicos son visibles para todas las personas del equipo. Recuerde que es responsable de todo el contenido que publique. + +Slack es un sistema de notificaciones y mensajería en tiempo real y basado en la nube. Slack proporciona una función de chat permanente, que es una alternativa más interactiva que el correo electrónico para facilitar la colaboración del equipo. Puede comunicarse con su equipo en un canal dedicado o en un conjunto de canales directamente relacionados con su trabajo. Asimismo, puede compartir archivos e imágenes a través de los canales o a través de mensajes directos entre dos o más personas. Las comunicaciones en los mensajes directos y en los canales se conservan para poder realizar búsquedas. + +Configure Slack para recibir notificaciones acerca de su cadena de herramientas desde las integraciones de herramientas, como actividades de prueba y de despliegue: + +1. Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Configurable Integrations, pulse **Slack**. +1. Si tiene una cadena de herramientas y añade esta integración de herramienta a dicha cadena, en el panel de control DevOps, en la página **Cadenas de herramientas**, pulse la cadena de herramientas para abrir la página Integraciones de herramientas. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. Pulse el botón de adición (+). +1. En la sección Tool Integrations, pulse **Slack**. +1. Escriba la señal de autenticación de API para su cuenta de Slack. Debe utilizar la señal con acceso completo garantizado para autenticarse con Slack. Para obtener instrucciones sobre cómo encontrar la señal, consulte [Autenticación de Slack (El enlace se abre en una ventana nueva)](https://api.slack.com/web#authentication){: new_window}. +1. Escriba el nombre del canal Slack al que desea enviar las notificaciones. Si el canal que intenta especificar no existe, se crea. Si el canal se ha archivado, se reactiva. +1. Pulse **Create Integration**. +1. Pulse el mosaico de Slack. Puede ver toda la actividad de su cadena de herramientas en el canal Slack configurado. + +Para obtener más información, consulte [Slack (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}. + + + + + + + + diff --git a/toolchains/nl/es/toolchains_overview.md b/toolchains/nl/es/toolchains_overview.md index fad64958b..07e6c2044 100644 --- a/toolchains/nl/es/toolchains_overview.md +++ b/toolchains/nl/es/toolchains_overview.md @@ -1,160 +1,160 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Iniciación a las cadenas de herramientas (Beta) -{: #toolchains_getting_started} - -Última actualización: 7 de octubre de 2016 -{: .last-updated} - -Las cadenas de herramientas están disponibles en los entornos Público y Dedicado en {{site.data.keyword.Bluemix}}. Una cadena de herramientas se puede crear de dos formas: mediante una plantilla o a partir de una app. En {{site.data.keyword.Bluemix_notm}} Público, las cadenas de herramientas están disponibles únicamente en el sur de EE. UU. -{: shortdesc} - -##Iniciación a las cadenas de herramientas: Público -{: #getting_started_public} - -**Nota:** Asegúrese de que está trabajando en la experiencia de New Bluemix comprobando el banner superior. - - * Si ve un mensaje sobre probar el nuevo Bluemix, estará trabajando en la experiencia de Classic Bluemix. Pulse el enlace para abrir la experiencia de New Bluemix. - * Si no ve dicho mensaje, ya estará trabajando en la experiencia de New Bluemix. - -Cada cadena de herramientas está asociada con una organización (org) específica y cualquier usuario que sea miembro de dicha organización puede acceder a las cadenas de herramientas asociadas. Para poder crear una cadena de herramientas, asegúrese de que está trabajando en la organización donde desea crear la cadena de herramientas. La organización en la que está trabajando actualmente se muestra en la barra de menús. Para conmutar a otra organización, pulse la organización en la barra de menús y, a continuación, seleccione la organización a la que desea conmutar. - -###Creación de una cadena de herramientas a partir de una plantilla -{: #creating_a_toolchain_from_a_template} - -Puede utilizar una plantilla como punto de partida para crear una cadena de herramientas que incluya un conjunto específico de integraciones de herramientas. - -1. Si está creando su primera cadena de herramientas, asegúrese de que las cadenas de herramientas estén habilitadas en su organización: - 1. Abra el panel de control de DevOps y pulse la página **Toolchains**. - 2. Si se muestra el botón **Enable Toolchains**, púlselo y siga las solicitudes para crear la cadena de herramientas. - 3. Si no se muestra el botón **Enable Toolchains**, las cadenas de herramientas ya estarán habilitadas. Continúe con el paso 2. -1. En el panel de control de DevOps, en la página **Toolchains**, pulse el botón add (+) para crear una cadena de herramientas. -1. Pulse la plantilla de la cadena de herramientas. Por ejemplo, para utilizar un ejemplo de tienda en línea para crear la cadena de herramientas, pulse **Microservices toolchain**. -1. En la página de creación de la cadena de herramientas, revise el diagrama de la cadena de herramientas que se dispone a crear. El diagrama muestra cada integración de herramienta en su fase de ciclo en la cadena de herramientas. El diagrama de la imagen siguiente es un ejemplo. Al crear una cadena de herramientas, el diagrama muestra cada una de las integraciones de herramienta que forma parte de la cadena de herramientas. -![Diagrama de cadena de herramientas](images/toolchain_diagram.png) - -1. Revise la información predeterminada para la configuración de la cadena de herramientas. El nombre de la cadena de herramientas la identifica en {{site.data.keyword.Bluemix_notm}}. Si ya tiene una cadena de herramientas con dicho nombre, o si desea utilizar otro nombre, cambie el nombre de la cadena de herramientas. -1. En la sección Configurable Integrations, seleccione cada una de las integraciones de herramienta para las que desee configurar su cadena de herramientas. Algunas integraciones de herramientas no necesitan configuración. Para obtener información sobre cómo configurar las integraciones de herramientas, consulte [Configurar integraciones de herramientas (El enlace se abre en una ventana nueva)](../toolchains/toolchains_integrations.html){: new_window}. -1. Pulse **Create**. Para configurar la cadena de herramientas, se ejecutan varios pasos automáticamente: - - * Se crea la cadena de herramientas. - * Si ha configurado la integración de la herramienta Delivery Pipeline, los conductos se activan. - * Si ha configurado la integración de la herramienta Sauce Labs, la integración de Sauce Labs se configura para añadir trabajos a los conductos y ejecutar pruebas. - * Si ha configurado la integración de la herramienta PagerDuty, la integración de PagerDuty se configura para enviar notificaciones al canal configurado en Slack. Estas notificaciones indican cuándo se produce el problema. - * Si ha configurado la integración de la herramienta Slack, la integración de Slack se configura para enviar notificaciones al canal configurado en Slack. Estas notificaciones indican el progreso del despliegue; por ejemplo, `Connected with Project XYZ`, `Pipeline Configured` y `Stage 'build' started`. - * Si ha configurado la integración de la herramienta GitHub, el repositorio de ejemplo de GitHub se clona en su cuenta de GitHub. - - -###Creación de una cadena de herramientas a partir de una app -{: #creating_a_toolchain_from_an_app} - -Puede crear una cadena de herramientas desde la app. La cadena de herramientas puede admitir tareas continuadas de desarrollo, despliegue, supervisión, etc., y está asociada con su app. Cada app puede asociarse a una cadena de herramientas. Cuando se envían los cambios al repositorio de GitHub de la cadena de herramientas, el conducto crea y despliega automáticamente la app. - -1. Si está creando su primera cadena de herramientas, asegúrese de que las cadenas de herramientas estén habilitadas en su organización: - 1. Abra el panel de control de DevOps y pulse la página **Toolchains**. - 2. Si se muestra el botón **Enable Toolchains**, púlselo y siga las solicitudes para crear la cadena de herramientas. - 3. Si no se muestra el botón **Enable Toolchains**, las cadenas de herramientas ya estarán habilitadas. Continúe con el paso 2. -1. En la página Visión general de la app, en el mosaico Continuous Delivery, pulse **Enable**. Como alternativa, en {{site.data.keyword.Bluemix_notm}} Classic Experience, en la esquina superior derecha de la página Visión general de la app, pulse **Añadir cadena de herramientas**. La app se configura para una entrega continuada desde un nuevo repositorio de GitHub que ya contiene el código de inicio de la app. -1. En la página de creación de la cadena de herramientas, revise el diagrama de la cadena de herramientas que se dispone a crear. El diagrama muestra cada integración de herramienta en su fase de ciclo en la cadena de herramientas. -1. Revise la información predeterminada para la configuración de la cadena de herramientas. El nombre de la cadena de herramientas la identifica en {{site.data.keyword.Bluemix_notm}}. Si ya tiene una cadena de herramientas con dicho nombre, o si desea utilizar otro nombre, cambie el nombre de la cadena de herramientas. -1. En la sección Configurable Integrations, seleccione cada una de las integraciones de herramienta para las que desee configurar su cadena de herramientas. Algunas integraciones de herramientas no necesitan configuración. Para obtener información sobre cómo configurar las integraciones de herramientas, consulte [Configurar integraciones de herramientas (El enlace se abre en una ventana nueva)](../toolchains/toolchains_integrations.html){: new_window}. -1. Pulse **Create**. Para configurar la cadena de herramientas, se ejecutan varios pasos automáticamente: - - * Se crea la cadena de herramientas. - * Si ha configurado la integración de la herramienta Delivery Pipeline, los conductos se activan. - * Si ha configurado la integración de la herramienta Sauce Labs, la integración de Sauce Labs se configura para añadir trabajos a los conductos y ejecutar pruebas. - * Si ha configurado la integración de la herramienta PagerDuty, la integración de PagerDuty se configura para enviar notificaciones al canal configurado en Slack. Estas notificaciones indican cuándo se produce el problema. - * Si ha configurado la integración de la herramienta Slack, la integración de Slack se configura para enviar notificaciones al canal configurado en Slack. Estas notificaciones indican el progreso del despliegue; por ejemplo, `Connected with Project XYZ`, `Pipeline Configured` y `Stage 'build' started`. - * Si ha configurado la integración de la herramienta GitHub, el repositorio de ejemplo de GitHub se clona en su cuenta de GitHub. - - -##Iniciación a las cadenas de herramientas: Dedicado -{: #getting_started_dedicated} - -Cada cadena de herramientas está asociada con una organización (org) específica y cualquier usuario que sea miembro de dicha organización puede acceder a las cadenas de herramientas asociadas. Para poder crear una cadena de herramientas, pulse el icono **{{site.data.keyword.avatar}}** ![Icono de avatar](../icons/i-avatar-icon.svg) en la barra de menús para abrir el widget de Cuenta y soporte y ver la organización en la que está trabajando. Si dicha organización no es la misma en la que desea crear la cadena de herramientas, conmute a otra organización. - -###Creación de una cadena de herramientas a partir de una plantilla -{: #creating_a_toolchain_from_a_template_dedicated} - -Puede utilizar una plantilla como punto de partida para crear una cadena de herramientas que incluya un conjunto específico de integraciones de herramientas. - -1. Si está creando su primera cadena de herramientas, asegúrese de que las cadenas de herramientas estén habilitadas en su organización: - 1. Abra el panel de control de DevOps y pulse el separador **Toolchains**. - 2. Si se muestra el botón **Enable Toolchains**, púlselo y siga las solicitudes para crear la cadena de herramientas. - 3. Si no se muestra el botón **Enable Toolchains**, las cadenas de herramientas ya estarán habilitadas. Continúe con el paso 2. -1. En el panel de control de {{site.data.keyword.Bluemix_notm}}, en el separador **DEVOPS**, pulse el botón add (+) para crear una cadena de herramientas. -1. Pulse la plantilla de la cadena de herramientas. Por ejemplo, para crear una cadena de herramientas simple para desplegar una nueva app de Cloud Foundry, pulse **Cadena de herramientas simple de Cloud Foundry**. -1. En la página de creación de la cadena de herramientas, revise el diagrama de la cadena de herramientas que se dispone a crear. El diagrama muestra cada integración de herramienta en su fase de ciclo en la cadena de herramientas. El diagrama de la imagen siguiente es un ejemplo. Al crear una cadena de herramientas, el diagrama muestra cada una de las integraciones de herramienta que forma parte de la cadena de herramientas. -![Diagrama de cadena de herramientas dedicada](images/toolchain_dedicated_diagram.png) - -1. Revise la información predeterminada para la configuración de la cadena de herramientas. El nombre de la cadena de herramientas la identifica en {{site.data.keyword.Bluemix_notm}}. Si ya tiene una cadena de herramientas con dicho nombre, o si desea utilizar otro nombre, cambie el nombre de la cadena de herramientas. -1. En la sección Configurable Integrations, seleccione cada una de las integraciones de herramienta para las que desee configurar su cadena de herramientas. Algunas integraciones de herramientas no necesitan configuración. Para obtener información sobre cómo configurar las integraciones de herramientas, consulte [Configurar integraciones de herramientas (El enlace se abre en una ventana nueva)](../toolchains/toolchains_integrations.html){: new_window}. -1. Pulse **Create**. Para configurar la cadena de herramientas, se ejecutan varios pasos automáticamente: - - * Se crea la cadena de herramientas. - * Si ha configurado la integración de la herramienta Delivery Pipeline, los conductos se activan. - * Si ha configurado la integración de herramientas de GitHub Enterprise, el repositorio de ejemplo de GitHub Enterprise se clona en su cuenta de GitHub Enterprise. - - -###Creación de una cadena de herramientas a partir de una app -{: #creating_a_toolchain_from_an_app_dedicated} - -Puede crear una cadena de herramientas desde la app. La cadena de herramientas puede admitir tareas continuadas de desarrollo, despliegue, supervisión, etc., y está asociada con su app. Cada app puede asociarse a una cadena de herramientas. Cuando se envían los cambios al repositorio de GitHub Enterprise de la cadena de herramientas, el conducto crea y despliega automáticamente la app. - -1. Si está creando su primera cadena de herramientas, asegúrese de que las cadenas de herramientas estén habilitadas en su organización: - 1. Abra el panel de control de DevOps y pulse el separador **Toolchains**. - 2. Si se muestra el botón **Enable Toolchains**, púlselo y siga las solicitudes para crear la cadena de herramientas. - 3. Si no se muestra el botón **Enable Toolchains**, las cadenas de herramientas ya estarán habilitadas. Continúe con el paso 2. -1. En la esquina superior derecha de la página Visión general de la aplicación, pulse **Añadir cadena de herramientas**. La app se configura para una entrega continuada desde un nuevo repositorio de GitHub Enterprise que ya contiene el código de inicio de la app. -1. En la página de creación de la cadena de herramientas, revise el diagrama de la cadena de herramientas que se dispone a crear. El diagrama muestra cada integración de herramienta en su fase de ciclo en la cadena de herramientas. -1. Revise la información predeterminada para la configuración de la cadena de herramientas. El nombre de la cadena de herramientas la identifica en {{site.data.keyword.Bluemix_notm}}. Si ya tiene una cadena de herramientas con dicho nombre, o si desea utilizar otro nombre, cambie el nombre de la cadena de herramientas. -1. En la sección Configurable Integrations, seleccione cada una de las integraciones de herramienta para las que desee configurar su cadena de herramientas. Algunas integraciones de herramientas no necesitan configuración. Para obtener información sobre cómo configurar las integraciones de herramientas, consulte [Configurar integraciones de herramientas (El enlace se abre en una ventana nueva)](../toolchains/toolchains_integrations.html){: new_window}. -1. Pulse **Create**. Para configurar la cadena de herramientas, se ejecutan varios pasos automáticamente: - - * Se crea la cadena de herramientas. - * Si ha configurado la integración de la herramienta Delivery Pipeline, los conductos se activan. - * Si ha configurado la integración de herramientas de GitHub Enterprise, el repositorio de ejemplo de GitHub Enterprise se clona en su cuenta de GitHub Enterprise. - - -##Visualización de una cadena de herramientas -{: #viewing_a_toolchain} - -Una vez que se ha configurado la cadena de herramientas y sus integraciones de herramientas, es posible obtener una representación visual de la cadena de herramientas en la página Tool Integrations. - -* Si utiliza {{site.data.keyword.Bluemix_notm}} Público, en el panel de control DevOps, en la página **Toolchains**, pulse una cadena de herramientas para abrir su página Tool Integrations. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. - -* Si utiliza {{site.data.keyword.Bluemix_notm}} Dedicado, en el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. - -* Para acceder a una integración de herramienta de su cadena de herramientas, pulse el mosaico de la herramienta. - - **Consejo**: si tiene más de un repositorio de GitHub o GitHub Enterprise, es posible que tenga varios mosaicos para la misma integración de herramienta porque cada repositorio está representado por su propio mosaico. - - - - - -# Enlaces relacionados -{: #rellinks} - -## Guías de aprendizaje y ejemplos -{: #samples} - -* [Crear una aplicación con tres microservicios (Beta) (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} -* [Crear una cadena de herramientas desde una plantilla en {{site.data.keyword.Bluemix_notm}} Dedicado (Beta) (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} -* [Crear una cadena de herramientas desde una app en {{site.data.keyword.Bluemix_notm}} Dedicado (Beta) (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} - -## Enlaces relacionados -{: #general} - -* [Cadena de herramientas de microservicios (Beta) (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} -* [Cadena de herramientas simple (Beta) (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} -* [IBM Bluemix Garage Method (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method){:new_window} +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Iniciación a las cadenas de herramientas (Beta) +{: #toolchains_getting_started} + +Última actualización: 7 de octubre de 2016 +{: .last-updated} + +Las cadenas de herramientas están disponibles en los entornos Público y Dedicado en {{site.data.keyword.Bluemix}}. Una cadena de herramientas se puede crear de dos formas: mediante una plantilla o a partir de una app. En {{site.data.keyword.Bluemix_notm}} Público, las cadenas de herramientas están disponibles únicamente en el sur de EE. UU. +{: shortdesc} + +##Iniciación a las cadenas de herramientas: Público +{: #getting_started_public} + +**Nota:** Asegúrese de que está trabajando en la experiencia de New Bluemix comprobando el banner superior. + + * Si ve un mensaje sobre probar el nuevo Bluemix, estará trabajando en la experiencia de Classic Bluemix. Pulse el enlace para abrir la experiencia de New Bluemix. + * Si no ve dicho mensaje, ya estará trabajando en la experiencia de New Bluemix. + +Cada cadena de herramientas está asociada con una organización (org) específica y cualquier usuario que sea miembro de dicha organización puede acceder a las cadenas de herramientas asociadas. Para poder crear una cadena de herramientas, asegúrese de que está trabajando en la organización donde desea crear la cadena de herramientas. La organización en la que está trabajando actualmente se muestra en la barra de menús. Para conmutar a otra organización, pulse la organización en la barra de menús y, a continuación, seleccione la organización a la que desea conmutar. + +###Creación de una cadena de herramientas a partir de una plantilla +{: #creating_a_toolchain_from_a_template} + +Puede utilizar una plantilla como punto de partida para crear una cadena de herramientas que incluya un conjunto específico de integraciones de herramientas. + +1. Si está creando su primera cadena de herramientas, asegúrese de que las cadenas de herramientas estén habilitadas en su organización: + 1. Abra el panel de control de DevOps y pulse la página **Toolchains**. + 2. Si se muestra el botón **Enable Toolchains**, púlselo y siga las solicitudes para crear la cadena de herramientas. + 3. Si no se muestra el botón **Enable Toolchains**, las cadenas de herramientas ya estarán habilitadas. Continúe con el paso 2. +1. En el panel de control de DevOps, en la página **Toolchains**, pulse el botón add (+) para crear una cadena de herramientas. +1. Pulse la plantilla de la cadena de herramientas. Por ejemplo, para utilizar un ejemplo de tienda en línea para crear la cadena de herramientas, pulse **Microservices toolchain**. +1. En la página de creación de la cadena de herramientas, revise el diagrama de la cadena de herramientas que se dispone a crear. El diagrama muestra cada integración de herramienta en su fase de ciclo en la cadena de herramientas. El diagrama de la imagen siguiente es un ejemplo. Al crear una cadena de herramientas, el diagrama muestra cada una de las integraciones de herramienta que forma parte de la cadena de herramientas. +![Diagrama de cadena de herramientas](images/toolchain_diagram.png) + +1. Revise la información predeterminada para la configuración de la cadena de herramientas. El nombre de la cadena de herramientas la identifica en {{site.data.keyword.Bluemix_notm}}. Si ya tiene una cadena de herramientas con dicho nombre, o si desea utilizar otro nombre, cambie el nombre de la cadena de herramientas. +1. En la sección Configurable Integrations, seleccione cada una de las integraciones de herramienta para las que desee configurar su cadena de herramientas. Algunas integraciones de herramientas no necesitan configuración. Para obtener información sobre cómo configurar las integraciones de herramientas, consulte [Configurar integraciones de herramientas (El enlace se abre en una ventana nueva)](../toolchains/toolchains_integrations.html){: new_window}. +1. Pulse **Create**. Para configurar la cadena de herramientas, se ejecutan varios pasos automáticamente: + + * Se crea la cadena de herramientas. + * Si ha configurado la integración de la herramienta Delivery Pipeline, los conductos se activan. + * Si ha configurado la integración de la herramienta Sauce Labs, la integración de Sauce Labs se configura para añadir trabajos a los conductos y ejecutar pruebas. + * Si ha configurado la integración de la herramienta PagerDuty, la integración de PagerDuty se configura para enviar notificaciones al canal configurado en Slack. Estas notificaciones indican cuándo se produce el problema. + * Si ha configurado la integración de la herramienta Slack, la integración de Slack se configura para enviar notificaciones al canal configurado en Slack. Estas notificaciones indican el progreso del despliegue; por ejemplo, `Connected with Project XYZ`, `Pipeline Configured` y `Stage 'build' started`. + * Si ha configurado la integración de la herramienta GitHub, el repositorio de ejemplo de GitHub se clona en su cuenta de GitHub. + + +###Creación de una cadena de herramientas a partir de una app +{: #creating_a_toolchain_from_an_app} + +Puede crear una cadena de herramientas desde la app. La cadena de herramientas puede admitir tareas continuadas de desarrollo, despliegue, supervisión, etc., y está asociada con su app. Cada app puede asociarse a una cadena de herramientas. Cuando se envían los cambios al repositorio de GitHub de la cadena de herramientas, el conducto crea y despliega automáticamente la app. + +1. Si está creando su primera cadena de herramientas, asegúrese de que las cadenas de herramientas estén habilitadas en su organización: + 1. Abra el panel de control de DevOps y pulse la página **Toolchains**. + 2. Si se muestra el botón **Enable Toolchains**, púlselo y siga las solicitudes para crear la cadena de herramientas. + 3. Si no se muestra el botón **Enable Toolchains**, las cadenas de herramientas ya estarán habilitadas. Continúe con el paso 2. +1. En la página Visión general de la app, en el mosaico Continuous Delivery, pulse **Enable**. Como alternativa, en {{site.data.keyword.Bluemix_notm}} Classic Experience, en la esquina superior derecha de la página Visión general de la app, pulse **Añadir cadena de herramientas**. La app se configura para una entrega continuada desde un nuevo repositorio de GitHub que ya contiene el código de inicio de la app. +1. En la página de creación de la cadena de herramientas, revise el diagrama de la cadena de herramientas que se dispone a crear. El diagrama muestra cada integración de herramienta en su fase de ciclo en la cadena de herramientas. +1. Revise la información predeterminada para la configuración de la cadena de herramientas. El nombre de la cadena de herramientas la identifica en {{site.data.keyword.Bluemix_notm}}. Si ya tiene una cadena de herramientas con dicho nombre, o si desea utilizar otro nombre, cambie el nombre de la cadena de herramientas. +1. En la sección Configurable Integrations, seleccione cada una de las integraciones de herramienta para las que desee configurar su cadena de herramientas. Algunas integraciones de herramientas no necesitan configuración. Para obtener información sobre cómo configurar las integraciones de herramientas, consulte [Configurar integraciones de herramientas (El enlace se abre en una ventana nueva)](../toolchains/toolchains_integrations.html){: new_window}. +1. Pulse **Create**. Para configurar la cadena de herramientas, se ejecutan varios pasos automáticamente: + + * Se crea la cadena de herramientas. + * Si ha configurado la integración de la herramienta Delivery Pipeline, los conductos se activan. + * Si ha configurado la integración de la herramienta Sauce Labs, la integración de Sauce Labs se configura para añadir trabajos a los conductos y ejecutar pruebas. + * Si ha configurado la integración de la herramienta PagerDuty, la integración de PagerDuty se configura para enviar notificaciones al canal configurado en Slack. Estas notificaciones indican cuándo se produce el problema. + * Si ha configurado la integración de la herramienta Slack, la integración de Slack se configura para enviar notificaciones al canal configurado en Slack. Estas notificaciones indican el progreso del despliegue; por ejemplo, `Connected with Project XYZ`, `Pipeline Configured` y `Stage 'build' started`. + * Si ha configurado la integración de la herramienta GitHub, el repositorio de ejemplo de GitHub se clona en su cuenta de GitHub. + + +##Iniciación a las cadenas de herramientas: Dedicado +{: #getting_started_dedicated} + +Cada cadena de herramientas está asociada con una organización (org) específica y cualquier usuario que sea miembro de dicha organización puede acceder a las cadenas de herramientas asociadas. Para poder crear una cadena de herramientas, pulse el icono **{{site.data.keyword.avatar}}** ![Icono de avatar](../icons/i-avatar-icon.svg) en la barra de menús para abrir el widget de Cuenta y soporte y ver la organización en la que está trabajando. Si dicha organización no es la misma en la que desea crear la cadena de herramientas, conmute a otra organización. + +###Creación de una cadena de herramientas a partir de una plantilla +{: #creating_a_toolchain_from_a_template_dedicated} + +Puede utilizar una plantilla como punto de partida para crear una cadena de herramientas que incluya un conjunto específico de integraciones de herramientas. + +1. Si está creando su primera cadena de herramientas, asegúrese de que las cadenas de herramientas estén habilitadas en su organización: + 1. Abra el panel de control de DevOps y pulse el separador **Toolchains**. + 2. Si se muestra el botón **Enable Toolchains**, púlselo y siga las solicitudes para crear la cadena de herramientas. + 3. Si no se muestra el botón **Enable Toolchains**, las cadenas de herramientas ya estarán habilitadas. Continúe con el paso 2. +1. En el panel de control de {{site.data.keyword.Bluemix_notm}}, en el separador **DEVOPS**, pulse el botón add (+) para crear una cadena de herramientas. +1. Pulse la plantilla de la cadena de herramientas. Por ejemplo, para crear una cadena de herramientas simple para desplegar una nueva app de Cloud Foundry, pulse **Cadena de herramientas simple de Cloud Foundry**. +1. En la página de creación de la cadena de herramientas, revise el diagrama de la cadena de herramientas que se dispone a crear. El diagrama muestra cada integración de herramienta en su fase de ciclo en la cadena de herramientas. El diagrama de la imagen siguiente es un ejemplo. Al crear una cadena de herramientas, el diagrama muestra cada una de las integraciones de herramienta que forma parte de la cadena de herramientas. +![Diagrama de cadena de herramientas dedicada](images/toolchain_dedicated_diagram.png) + +1. Revise la información predeterminada para la configuración de la cadena de herramientas. El nombre de la cadena de herramientas la identifica en {{site.data.keyword.Bluemix_notm}}. Si ya tiene una cadena de herramientas con dicho nombre, o si desea utilizar otro nombre, cambie el nombre de la cadena de herramientas. +1. En la sección Configurable Integrations, seleccione cada una de las integraciones de herramienta para las que desee configurar su cadena de herramientas. Algunas integraciones de herramientas no necesitan configuración. Para obtener información sobre cómo configurar las integraciones de herramientas, consulte [Configurar integraciones de herramientas (El enlace se abre en una ventana nueva)](../toolchains/toolchains_integrations.html){: new_window}. +1. Pulse **Create**. Para configurar la cadena de herramientas, se ejecutan varios pasos automáticamente: + + * Se crea la cadena de herramientas. + * Si ha configurado la integración de la herramienta Delivery Pipeline, los conductos se activan. + * Si ha configurado la integración de herramientas de GitHub Enterprise, el repositorio de ejemplo de GitHub Enterprise se clona en su cuenta de GitHub Enterprise. + + +###Creación de una cadena de herramientas a partir de una app +{: #creating_a_toolchain_from_an_app_dedicated} + +Puede crear una cadena de herramientas desde la app. La cadena de herramientas puede admitir tareas continuadas de desarrollo, despliegue, supervisión, etc., y está asociada con su app. Cada app puede asociarse a una cadena de herramientas. Cuando se envían los cambios al repositorio de GitHub Enterprise de la cadena de herramientas, el conducto crea y despliega automáticamente la app. + +1. Si está creando su primera cadena de herramientas, asegúrese de que las cadenas de herramientas estén habilitadas en su organización: + 1. Abra el panel de control de DevOps y pulse el separador **Toolchains**. + 2. Si se muestra el botón **Enable Toolchains**, púlselo y siga las solicitudes para crear la cadena de herramientas. + 3. Si no se muestra el botón **Enable Toolchains**, las cadenas de herramientas ya estarán habilitadas. Continúe con el paso 2. +1. En la esquina superior derecha de la página Visión general de la aplicación, pulse **Añadir cadena de herramientas**. La app se configura para una entrega continuada desde un nuevo repositorio de GitHub Enterprise que ya contiene el código de inicio de la app. +1. En la página de creación de la cadena de herramientas, revise el diagrama de la cadena de herramientas que se dispone a crear. El diagrama muestra cada integración de herramienta en su fase de ciclo en la cadena de herramientas. +1. Revise la información predeterminada para la configuración de la cadena de herramientas. El nombre de la cadena de herramientas la identifica en {{site.data.keyword.Bluemix_notm}}. Si ya tiene una cadena de herramientas con dicho nombre, o si desea utilizar otro nombre, cambie el nombre de la cadena de herramientas. +1. En la sección Configurable Integrations, seleccione cada una de las integraciones de herramienta para las que desee configurar su cadena de herramientas. Algunas integraciones de herramientas no necesitan configuración. Para obtener información sobre cómo configurar las integraciones de herramientas, consulte [Configurar integraciones de herramientas (El enlace se abre en una ventana nueva)](../toolchains/toolchains_integrations.html){: new_window}. +1. Pulse **Create**. Para configurar la cadena de herramientas, se ejecutan varios pasos automáticamente: + + * Se crea la cadena de herramientas. + * Si ha configurado la integración de la herramienta Delivery Pipeline, los conductos se activan. + * Si ha configurado la integración de herramientas de GitHub Enterprise, el repositorio de ejemplo de GitHub Enterprise se clona en su cuenta de GitHub Enterprise. + + +##Visualización de una cadena de herramientas +{: #viewing_a_toolchain} + +Una vez que se ha configurado la cadena de herramientas y sus integraciones de herramientas, es posible obtener una representación visual de la cadena de herramientas en la página Tool Integrations. + +* Si utiliza {{site.data.keyword.Bluemix_notm}} Público, en el panel de control DevOps, en la página **Toolchains**, pulse una cadena de herramientas para abrir su página Tool Integrations. Como alternativa, en la página Visión general de la aplicación, en el mosaico Entrega continua, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. + +* Si utiliza {{site.data.keyword.Bluemix_notm}} Dedicado, en el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. + +* Para acceder a una integración de herramienta de su cadena de herramientas, pulse el mosaico de la herramienta. + + **Consejo**: si tiene más de un repositorio de GitHub o GitHub Enterprise, es posible que tenga varios mosaicos para la misma integración de herramienta porque cada repositorio está representado por su propio mosaico. + + + + + +# Enlaces relacionados +{: #rellinks} + +## Guías de aprendizaje y ejemplos +{: #samples} + +* [Crear una aplicación con tres microservicios (Beta) (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} +* [Crear una cadena de herramientas desde una plantilla en {{site.data.keyword.Bluemix_notm}} Dedicado (Beta) (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} +* [Crear una cadena de herramientas desde una app en {{site.data.keyword.Bluemix_notm}} Dedicado (Beta) (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} + +## Enlaces relacionados +{: #general} + +* [Cadena de herramientas de microservicios (Beta) (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} +* [Cadena de herramientas simple (Beta) (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} +* [IBM Bluemix Garage Method (El enlace se abre en una ventana nueva)](https://www.ibm.com/devops/method){:new_window} diff --git a/toolchains/nl/es/toolchains_using.md b/toolchains/nl/es/toolchains_using.md index f653026ef..9e4ffb86c 100644 --- a/toolchains/nl/es/toolchains_using.md +++ b/toolchains/nl/es/toolchains_using.md @@ -1,97 +1,97 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Uso de cadenas de herramientas en {{site.data.keyword.Bluemix_notm}} Público -{: #toolchains-using} - -Última actualización: 7 de octubre de 2016 -{: .last-updated} - -Puede utilizar una cadena de herramientas para que sea productiva en su trabajo diario de desarrollo, despliegue y operaciones. Una vez que se ha configurado una cadena de herramientas, es posible añadir, eliminar o configurar integraciones de herramientas y gestionar el acceso a la cadena de herramientas. Las cadenas de herramientas están disponibles únicamente en el sur de EE. UU. -{: shortdesc} - -**Nota**: Asegúrese de que está trabajando en la experiencia de New Bluemix comprobando el banner superior. - - * Si ve un mensaje sobre probar el nuevo Bluemix, estará trabajando en la experiencia de Classic Bluemix. Pulse el enlace para abrir la experiencia de New Bluemix. - * Si no ve dicho mensaje, ya estará trabajando en la experiencia de New Bluemix. - -## Configuración de una integración de herramienta -{: #configuring_a_tool_integration} - -Si ha aplazado la configuración de una integración de herramientas al crear una cadena de herramientas, se mostrará un botón **Configure** en su mosaico. Si ha configurado una integración de herramientas al crear una cadena de herramientas, puede actualizar los valores de configuración. - -1. En el panel de control de DevOps, en la página **Toolchains**, pulse una cadena de herramientas para abrir la página Tool Integrations correspondiente. Como alternativa, en la página de visión general de la app, en el mosaico Continuous Delivery, pulse **View Toolchain** y, a continuación, pulse **Tool Integrations**. -1. Si necesita configurar una integración de herramienta por primera vez, en su mosaico, pulse **Configure**. - - ![Botón de configuración](images/toolchain_tile_configure.png) - - Cuando haya terminado de configurar la integración de la herramienta, pulse **Save Integration**. - -1. Si necesita actualizar la configuración de una integración de herramienta, en su mosaico, pulse el menú para acceder a las opciones de configuración. - - ![Menú de configuración](images/toolchain_tile_menu.png) - - Cuando haya terminado de configurar los ajustes, pulse **Save Integration**. - -## Adición de una integración de herramienta -{: #adding_a_tool_integration} - -Puede añadir y configurar integraciones de herramientas para su cadena de herramientas. - -1. En el panel de control de DevOps, en la página **Toolchains**, pulse una cadena de herramientas para abrir la página Tool Integrations correspondiente. Como alternativa, en la página de visión general de la app, en el mosaico Continuous Delivery, pulse **View Toolchain** y, a continuación, pulse **Tool Integrations**. -1. Para ver una lista de las integraciones de herramientas que se deben añadir, pulse el botón de adición (+). -1. Pulse en la integración de herramientas que desee añadir. -1. Introduzca la información necesaria para configurar la integración de la herramienta. -1. Pulse **Create Integration** para añadir la integración de la herramienta en su cadena de herramientas. - -## Eliminación de una integración de herramienta -{: #deleting_a_tool_integration} - -Si suprime una integración de herramientas desde su cadena de herramientas, la supresión no se podrá deshacer. - -1. En el panel de control de DevOps, en la página **Toolchains**, pulse una cadena de herramientas para abrir la página Tool Integrations correspondiente. Como alternativa, en la página de visión general de la app, en el mosaico Continuous Delivery, pulse **View Toolchain** y, a continuación, pulse **Tool Integrations**. -1. En el mosaico de la integración de herramienta que desea eliminar, pulse el menú para acceder a las opciones de configuración. -1. Para eliminar la integración de herramienta de su cadena de herramientas, pulse **Delete**. -1. Confirme la acción pulsando **Delete**. - -## Gestión del acceso -{: #managing_access} - -Puede conceder acceso a los usuarios a una cadena de herramientas si los añade a la organización con la que está asociada la cadena de herramientas. Cada cadena de herramientas está asociada con una organización específica, y cualquier usuario que sea miembro de dicha organización puede acceder a las cadenas de herramientas asociadas. La organización en la que está trabajando actualmente se muestra en la barra de menús. Pulse la organización y, a continuación, cambie de organización para acceder a un conjunto distinto de cadenas de herramientas. - - - - - -1. En el panel de control de DevOps, en la página **Toolchains**, pulse la cadena de herramientas que desee gestionar y pulse **Manage**. Como alternativa, en la página de visión general de la aplicación, en el mosaico Continuous Delivery, pulse **View Toolchain** y luego pulse **Manage**. -1. Pulse el enlace de su organización. -1. En la página Manage Organizations, pulse **Invite a User** y escriba la dirección de correo electrónico del usuario. -1. Si desea conceder permisos avanzados para gestionar usuarios en las organizaciones de {{site.data.keyword.Bluemix_notm}}, seleccione uno o varios de los recuadros de selección **Manager**, **Billing Manager** o **Auditor**. -1. Pulse **INVITE**. -1. Pulse **SAVE**. - -## Eliminación de una cadena de herramientas -{: #deleting_a_toolchain} - -Puede eliminar una cadena de herramientas y especificar qué integraciones de herramienta asociadas desea eliminar. Al suprimir una cadena de herramientas, la supresión no se podrá deshacer. - -1. En el panel de control de DevOps, en la página **Toolchains**, pulse la cadena de herramientas que desee eliminar y pulse **Manage**. Como alternativa, en la página de visión general de la aplicación, en el mosaico Continuous Delivery, pulse **View Toolchain** y luego pulse **Manage**. -1. Pulse **Delete Toolchain** y revise o ajuste las integraciones de herramientas que se dispone a eliminar. -1. Para confirmar la eliminación, escriba el nombre de la cadena de herramientas y pulse **Delete**. - - **Consejo**: cuando elimine la integración de una herramienta GitHub, el repositorio de GitHub asociado no se eliminará de GitHub. Deberá eliminar el repositorio manualmente. +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Uso de cadenas de herramientas en {{site.data.keyword.Bluemix_notm}} Público +{: #toolchains-using} + +Última actualización: 7 de octubre de 2016 +{: .last-updated} + +Puede utilizar una cadena de herramientas para que sea productiva en su trabajo diario de desarrollo, despliegue y operaciones. Una vez que se ha configurado una cadena de herramientas, es posible añadir, eliminar o configurar integraciones de herramientas y gestionar el acceso a la cadena de herramientas. Las cadenas de herramientas están disponibles únicamente en el sur de EE. UU. +{: shortdesc} + +**Nota**: Asegúrese de que está trabajando en la experiencia de New Bluemix comprobando el banner superior. + + * Si ve un mensaje sobre probar el nuevo Bluemix, estará trabajando en la experiencia de Classic Bluemix. Pulse el enlace para abrir la experiencia de New Bluemix. + * Si no ve dicho mensaje, ya estará trabajando en la experiencia de New Bluemix. + +## Configuración de una integración de herramienta +{: #configuring_a_tool_integration} + +Si ha aplazado la configuración de una integración de herramientas al crear una cadena de herramientas, se mostrará un botón **Configure** en su mosaico. Si ha configurado una integración de herramientas al crear una cadena de herramientas, puede actualizar los valores de configuración. + +1. En el panel de control de DevOps, en la página **Toolchains**, pulse una cadena de herramientas para abrir la página Tool Integrations correspondiente. Como alternativa, en la página de visión general de la app, en el mosaico Continuous Delivery, pulse **View Toolchain** y, a continuación, pulse **Tool Integrations**. +1. Si necesita configurar una integración de herramienta por primera vez, en su mosaico, pulse **Configure**. + + ![Botón de configuración](images/toolchain_tile_configure.png) + + Cuando haya terminado de configurar la integración de la herramienta, pulse **Save Integration**. + +1. Si necesita actualizar la configuración de una integración de herramienta, en su mosaico, pulse el menú para acceder a las opciones de configuración. + + ![Menú de configuración](images/toolchain_tile_menu.png) + + Cuando haya terminado de configurar los ajustes, pulse **Save Integration**. + +## Adición de una integración de herramienta +{: #adding_a_tool_integration} + +Puede añadir y configurar integraciones de herramientas para su cadena de herramientas. + +1. En el panel de control de DevOps, en la página **Toolchains**, pulse una cadena de herramientas para abrir la página Tool Integrations correspondiente. Como alternativa, en la página de visión general de la app, en el mosaico Continuous Delivery, pulse **View Toolchain** y, a continuación, pulse **Tool Integrations**. +1. Para ver una lista de las integraciones de herramientas que se deben añadir, pulse el botón de adición (+). +1. Pulse en la integración de herramientas que desee añadir. +1. Introduzca la información necesaria para configurar la integración de la herramienta. +1. Pulse **Create Integration** para añadir la integración de la herramienta en su cadena de herramientas. + +## Eliminación de una integración de herramienta +{: #deleting_a_tool_integration} + +Si suprime una integración de herramientas desde su cadena de herramientas, la supresión no se podrá deshacer. + +1. En el panel de control de DevOps, en la página **Toolchains**, pulse una cadena de herramientas para abrir la página Tool Integrations correspondiente. Como alternativa, en la página de visión general de la app, en el mosaico Continuous Delivery, pulse **View Toolchain** y, a continuación, pulse **Tool Integrations**. +1. En el mosaico de la integración de herramienta que desea eliminar, pulse el menú para acceder a las opciones de configuración. +1. Para eliminar la integración de herramienta de su cadena de herramientas, pulse **Delete**. +1. Confirme la acción pulsando **Delete**. + +## Gestión del acceso +{: #managing_access} + +Puede conceder acceso a los usuarios a una cadena de herramientas si los añade a la organización con la que está asociada la cadena de herramientas. Cada cadena de herramientas está asociada con una organización específica, y cualquier usuario que sea miembro de dicha organización puede acceder a las cadenas de herramientas asociadas. La organización en la que está trabajando actualmente se muestra en la barra de menús. Pulse la organización y, a continuación, cambie de organización para acceder a un conjunto distinto de cadenas de herramientas. + + + + + +1. En el panel de control de DevOps, en la página **Toolchains**, pulse la cadena de herramientas que desee gestionar y pulse **Manage**. Como alternativa, en la página de visión general de la aplicación, en el mosaico Continuous Delivery, pulse **View Toolchain** y luego pulse **Manage**. +1. Pulse el enlace de su organización. +1. En la página Manage Organizations, pulse **Invite a User** y escriba la dirección de correo electrónico del usuario. +1. Si desea conceder permisos avanzados para gestionar usuarios en las organizaciones de {{site.data.keyword.Bluemix_notm}}, seleccione uno o varios de los recuadros de selección **Manager**, **Billing Manager** o **Auditor**. +1. Pulse **INVITE**. +1. Pulse **SAVE**. + +## Eliminación de una cadena de herramientas +{: #deleting_a_toolchain} + +Puede eliminar una cadena de herramientas y especificar qué integraciones de herramienta asociadas desea eliminar. Al suprimir una cadena de herramientas, la supresión no se podrá deshacer. + +1. En el panel de control de DevOps, en la página **Toolchains**, pulse la cadena de herramientas que desee eliminar y pulse **Manage**. Como alternativa, en la página de visión general de la aplicación, en el mosaico Continuous Delivery, pulse **View Toolchain** y luego pulse **Manage**. +1. Pulse **Delete Toolchain** y revise o ajuste las integraciones de herramientas que se dispone a eliminar. +1. Para confirmar la eliminación, escriba el nombre de la cadena de herramientas y pulse **Delete**. + + **Consejo**: cuando elimine la integración de una herramienta GitHub, el repositorio de GitHub asociado no se eliminará de GitHub. Deberá eliminar el repositorio manualmente. diff --git a/toolchains/nl/es/toolchains_using_dedicated.md b/toolchains/nl/es/toolchains_using_dedicated.md index 258799bc9..8b2856df3 100644 --- a/toolchains/nl/es/toolchains_using_dedicated.md +++ b/toolchains/nl/es/toolchains_using_dedicated.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Uso de cadenas de herramientas en {{site.data.keyword.Bluemix_notm}} Dedicado -{: #toolchains-using_dedicated} - -Última actualización: 13 de septiembre de 2016 -{: .last-updated} - -Puede utilizar una cadena de herramientas para que sea productiva en su trabajo diario de desarrollo, despliegue y operaciones. Una vez que se ha configurado una cadena de herramientas, es posible añadir, eliminar o configurar integraciones de herramientas y gestionar el acceso a la cadena de herramientas. -{: shortdesc} - -## Configuración de una integración de herramienta -{: #configuring_a_tool_integration_dedicated} - -Si ha aplazado la configuración de una integración de herramientas al crear una cadena de herramientas, se mostrará un botón **Configure** en su mosaico. Si ha configurado una integración de herramientas al crear una cadena de herramientas, puede actualizar los valores de configuración. - -1. En el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. Si necesita configurar una integración de herramienta por primera vez, en su mosaico, pulse **Configure**. - - ![Botón de configuración](images/toolchain_tile_configure.png) - - Cuando haya terminado de configurar la integración de la herramienta, pulse **Save Integration**. - -1. Si necesita actualizar la configuración de una integración de herramienta, en su mosaico, pulse el menú para acceder a las opciones de configuración. - - ![Menú de configuración](images/toolchain_tile_menu.png) - - Cuando haya terminado de configurar los ajustes, pulse **Save Integration**. - -## Adición de una integración de herramienta -{: #adding_a_tool_integration_dedicated} - -Puede añadir y configurar integraciones de herramientas para su cadena de herramientas. - -1. En el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. Para ver una lista de las integraciones de herramientas que se deben añadir, pulse el botón de adición (+). -1. Pulse en la integración de herramientas a añadir. -1. Introduzca la información necesaria para configurar la integración de la herramienta. -1. Pulse **Create Integration** para añadir la integración de la herramienta en su cadena de herramientas. - -## Eliminación de una integración de herramienta -{: #deleting_a_tool_integration} - -Si suprime una integración de herramientas desde su cadena de herramientas, la supresión no se podrá deshacer. - -1. En el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. -1. En el mosaico de la integración de herramientas a suprimir, pulse el menú para acceder a las opciones de configuración. -1. Para eliminar la integración de herramienta de su cadena de herramientas, pulse **Delete**. -1. Confirme la acción pulsando **Delete**. - -## Gestión del acceso -{: #managing_access_dedicated} - -Puede conceder acceso a los usuarios a una cadena de herramientas si los añade a la organización con la que está asociada la cadena de herramientas. Cada cadena de herramientas está asociada con una organización específica, y cualquier usuario que sea miembro de dicha organización puede acceder a las cadenas de herramientas asociadas. Para ver la organización en la que está trabajando en este momento, pulse el icono **{{site.data.keyword.avatar}}** ![Icono de avatar](../icons/i-avatar-icon.svg) en la barra de menús. Para acceder a un conjunto distinto de cadenas de herramientas, cambie a una organización distinta. - -Al añadir usuarios a la organización y a los espacios de {{site.data.keyword.Bluemix}}, los usuarios pueden iniciar sesión en GitHub Enterprise utilizando su ID y contraseña de {{site.data.keyword.Bluemix_notm}}. Cuando los usuarios inician sesión, se les crearán cuentas. Al añadir usuarios a la organización y a los espacios de {{site.data.keyword.Bluemix_notm}}, no se añadirán automáticamente al repositorio de GitHub Enterprise. Debe añadirlos alguien que tenga privilegios de administración para el repositorio. Para obtener más información, consulte [Uso de GitHub Enterprise Dedicado (El enlace se abre en una ventana nueva)](../services/ghededicated/index.html){: new_window}. - -Para añadir un usuario, siga estos pasos: - -1. En el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. A continuación, pulse **Manage**. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Manage**. -1. Pulse el enlace de su organización. -1. En la página Manage Organizations, pulse **Invite a User** y escriba la dirección de correo electrónico del usuario. -1. Si desea conceder permisos avanzados para gestionar usuarios en las organizaciones de {{site.data.keyword.Bluemix_notm}}, seleccione uno o varios de los recuadros de selección **Manager**, **Billing Manager** o **Auditor**. -1. Pulse **INVITE**. -1. Pulse **SAVE**. - -## Eliminación de una cadena de herramientas -{: #deleting_a_toolchain_dedicated} - -Puede eliminar una cadena de herramientas y especificar qué integraciones de herramienta asociadas desea eliminar. Al suprimir una cadena de herramientas, la supresión no se podrá deshacer. - -1. En el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. A continuación, pulse **Manage**. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Manage**. -1. Pulse **Delete Toolchain** y revise o ajuste las integraciones de herramientas que se dispone a eliminar. -1. Para confirmar la eliminación, escriba el nombre de la cadena de herramientas y pulse **Delete**. - - **Consejo**: cuando elimine la integración de una herramienta GitHub Enterprise, el repositorio de GitHub Enterprise asociado no se eliminará de GitHub Enterprise. Deberá eliminar el repositorio manualmente de GitHub Enterprise. +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Uso de cadenas de herramientas en {{site.data.keyword.Bluemix_notm}} Dedicado +{: #toolchains-using_dedicated} + +Última actualización: 13 de septiembre de 2016 +{: .last-updated} + +Puede utilizar una cadena de herramientas para que sea productiva en su trabajo diario de desarrollo, despliegue y operaciones. Una vez que se ha configurado una cadena de herramientas, es posible añadir, eliminar o configurar integraciones de herramientas y gestionar el acceso a la cadena de herramientas. +{: shortdesc} + +## Configuración de una integración de herramienta +{: #configuring_a_tool_integration_dedicated} + +Si ha aplazado la configuración de una integración de herramientas al crear una cadena de herramientas, se mostrará un botón **Configure** en su mosaico. Si ha configurado una integración de herramientas al crear una cadena de herramientas, puede actualizar los valores de configuración. + +1. En el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. Si necesita configurar una integración de herramienta por primera vez, en su mosaico, pulse **Configure**. + + ![Botón de configuración](images/toolchain_tile_configure.png) + + Cuando haya terminado de configurar la integración de la herramienta, pulse **Save Integration**. + +1. Si necesita actualizar la configuración de una integración de herramienta, en su mosaico, pulse el menú para acceder a las opciones de configuración. + + ![Menú de configuración](images/toolchain_tile_menu.png) + + Cuando haya terminado de configurar los ajustes, pulse **Save Integration**. + +## Adición de una integración de herramienta +{: #adding_a_tool_integration_dedicated} + +Puede añadir y configurar integraciones de herramientas para su cadena de herramientas. + +1. En el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. Para ver una lista de las integraciones de herramientas que se deben añadir, pulse el botón de adición (+). +1. Pulse en la integración de herramientas a añadir. +1. Introduzca la información necesaria para configurar la integración de la herramienta. +1. Pulse **Create Integration** para añadir la integración de la herramienta en su cadena de herramientas. + +## Eliminación de una integración de herramienta +{: #deleting_a_tool_integration} + +Si suprime una integración de herramientas desde su cadena de herramientas, la supresión no se podrá deshacer. + +1. En el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Tool Integrations**. +1. En el mosaico de la integración de herramientas a suprimir, pulse el menú para acceder a las opciones de configuración. +1. Para eliminar la integración de herramienta de su cadena de herramientas, pulse **Delete**. +1. Confirme la acción pulsando **Delete**. + +## Gestión del acceso +{: #managing_access_dedicated} + +Puede conceder acceso a los usuarios a una cadena de herramientas si los añade a la organización con la que está asociada la cadena de herramientas. Cada cadena de herramientas está asociada con una organización específica, y cualquier usuario que sea miembro de dicha organización puede acceder a las cadenas de herramientas asociadas. Para ver la organización en la que está trabajando en este momento, pulse el icono **{{site.data.keyword.avatar}}** ![Icono de avatar](../icons/i-avatar-icon.svg) en la barra de menús. Para acceder a un conjunto distinto de cadenas de herramientas, cambie a una organización distinta. + +Al añadir usuarios a la organización y a los espacios de {{site.data.keyword.Bluemix}}, los usuarios pueden iniciar sesión en GitHub Enterprise utilizando su ID y contraseña de {{site.data.keyword.Bluemix_notm}}. Cuando los usuarios inician sesión, se les crearán cuentas. Al añadir usuarios a la organización y a los espacios de {{site.data.keyword.Bluemix_notm}}, no se añadirán automáticamente al repositorio de GitHub Enterprise. Debe añadirlos alguien que tenga privilegios de administración para el repositorio. Para obtener más información, consulte [Uso de GitHub Enterprise Dedicado (El enlace se abre en una ventana nueva)](../services/ghededicated/index.html){: new_window}. + +Para añadir un usuario, siga estos pasos: + +1. En el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. A continuación, pulse **Manage**. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Manage**. +1. Pulse el enlace de su organización. +1. En la página Manage Organizations, pulse **Invite a User** y escriba la dirección de correo electrónico del usuario. +1. Si desea conceder permisos avanzados para gestionar usuarios en las organizaciones de {{site.data.keyword.Bluemix_notm}}, seleccione uno o varios de los recuadros de selección **Manager**, **Billing Manager** o **Auditor**. +1. Pulse **INVITE**. +1. Pulse **SAVE**. + +## Eliminación de una cadena de herramientas +{: #deleting_a_toolchain_dedicated} + +Puede eliminar una cadena de herramientas y especificar qué integraciones de herramienta asociadas desea eliminar. Al suprimir una cadena de herramientas, la supresión no se podrá deshacer. + +1. En el Panel de control, en el separador **DEVOPS**, pulse la cadena de herramientas para abrir su página Tool Integrations. A continuación, pulse **Manage**. Como alternativa, en la esquina superior derecha de la página Visión general de la aplicación, pulse **Ver cadena de herramientas**. A continuación, pulse **Manage**. +1. Pulse **Delete Toolchain** y revise o ajuste las integraciones de herramientas que se dispone a eliminar. +1. Para confirmar la eliminación, escriba el nombre de la cadena de herramientas y pulse **Delete**. + + **Consejo**: cuando elimine la integración de una herramienta GitHub Enterprise, el repositorio de GitHub Enterprise asociado no se eliminará de GitHub Enterprise. Deberá eliminar el repositorio manualmente de GitHub Enterprise. diff --git a/toolchains/nl/es/web_ide.md b/toolchains/nl/es/web_ide.md index 72f92ae2e..8667862fd 100644 --- a/toolchains/nl/es/web_ide.md +++ b/toolchains/nl/es/web_ide.md @@ -1,152 +1,152 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} -{:pre: .pre} - -# Edición de código con Eclipse Orion {{site.data.keyword.webide}} -{: #web_ide} - -Última actualización: 9 de septiembre de 2016 -{: .last-updated} - -Eclipse Orion {{site.data.keyword.webide}} es un entorno de desarrollo basado en navegador donde puede desarrollar para la web. Puede desarrollar en JavaScript, HTML y CSS con la ayuda de asistencia de contenido, finalización del código y comprobación de errores. {{site.data.keyword.webide}} funciona con casi cualquier idioma y ofrece realce de la sintaxis para la mayoría de los [tipos de archivos (El enlace se abre en una ventana nueva)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}. El control de origen se crea mediante Git o Jazz SCM, y puede desplegar código de forma local para probar y depurar las apps. -{:shortdesc} - -Lo mejor de todo es que {{site.data.keyword.webide}} está basado en la web. No tiene que instalar, mantener ni escalar nada. Puede desarrollar en cualquier lugar donde tenga conexión a Internet. - -## Configuración del editor -{: #editorsetup} - -{{site.data.keyword.webide}} se puede personalizar para que pueda elegir los esquemas de colores, las herramientas técnicas y los valores que cumplan sus necesidades de desarrollo. Para ver y modificar los valores, desde el menú de la izquierda, pulse el icono **Settings** El icono de valores. - -Si necesita cambiar con frecuencia determinados valores mientras edita, puede acceder a dichos valores rápidamente desde el icono **Valores del editor local** Icono de Valores del editor local en la esquina superior derecha del editor - -![Valores del editor local](images/webide_local_editor_settings.png) - -De forma predeterminada, siempre se muestran los valores para el estilo del editor y el tamaño de fuente. Para incluir otros valores de editor en el menú, siga estos pasos: - -1. Pulse el icono **Valores del editor local** Icono de Valores del editor local. - -2. Pulse **Valores del editor**. - -3. Para incluir o excluir un valor del menú **Valores del editor local**, pulse el círculo que hay junto al valor. - -![Conmutador de Valores del editor](images/webide_editor_settings_toggle.png) - - -## Edición de código -{: #editcode} - -{{site.data.keyword.webide}} tiene dos secciones principales. La primera sección es el navegador de archivos de la izquierda, que muestra los archivos del proyecto en una estructura de árbol. Desde el navegador de archivos, puede crear, cambiar el nombre, suprimir y gestionar los archivos y carpetas. - -**Consejo:** para cargar archivos en el navegador de archivos, arrástrelos desde el sistema al navegador de archivos. - -La segunda sección es el panel del editor a la derecha. El editor proporciona varias características de codificación, incluida la asistencia de contenido y la validación de sintaxis. - -![Web IDE](images/webide.png) - -### Cómo trabajar con varios archivos -1. Para trabajar con dos archivos a la vez, pulse el icono **Cambiar modalidad del editor de división** Icono del Editor de división en la parte superior del editor. -2. Desde el menú que se abre, seleccione una vista. - - Tras seleccionar una vista, si ya se ha abierto un archivo en el editor, se mostrará en ambas vistas de editor. - - Para abrir o cambiar un archivo que se muestra en una de las vistas del editor: - 1. Mueva el cursor a la vista de editor que desee cambiar. - 2. En el navegador de archivos, pulse un archivo. - -### Accesos directos de teclado -Sólo se puede acceder a la mayoría de los mandatos de {{site.data.keyword.webide}} mediante accesos directos de teclado. - -Para ver una lista de los accesos directos de teclado en el editor, pulse Alt+Mayús+?. Si está utilizando un Mac OS, pulse Ctrl+Mayús+?. - -## Gestión del código fuente -{: #sourcecontrol} - -{{site.data.keyword.webide}} se integra con herramientas de gestión de código fuente. Para trabajar con el repositorio de Git, pulse el icono **Repositorio de Git** El icono del repositorio de Git. Para obtener más información, consulte [Control de origen con Git (El enlace se abre en una ventana nueva)](https://hub.jazz.net/docs/git/){: new_window}. - - -## Despliegue de una app desde el espacio de trabajo -{: #deploy} - -1. Para desplegar la app, desde la barra de ejecución, seleccione o [cree (El enlace se abre en una ventana nueva)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} una configuración de lanzamiento. -1. Pulse el icono de despliegue El icono de despliegue. Se desplegará una instancia de la app utilizando el contenido actual del espacio de trabajo y del entorno definido en la configuración de lanzamiento. -2. Una vez que se despliegue la app, puede utilizar la barra de ejecución para detener, reiniciar o depurar la app, ver registros, etc. -![Barra de ejecución](images/webide_runbar.png) - - - - ## Edición fuera del {{site.data.keyword.webide}} -{: #editlocal} - -Para utilizar un editor distinto a {{site.data.keyword.webide}}, configure {{site.data.keyword.Bluemix_live}} para que pueda trabajar directamente con los archivos de proyectos en cualquier herramienta. {{site.data.keyword.Bluemix_live_notm}} es una aplicación de línea de mandatos que sincroniza los cambios del sistema de archivos local con el espacio de trabajo de la nube en {{site.data.keyword.jazzhub}}. - -### Antes de empezar - -Descargue e instale la interfaz de línea de mandatos de [{{site.data.keyword.Bluemix_live_notm}} (El enlace se abre en una ventana nueva)](http://livesyncdownload.ng.bluemix.net){: new_window}. - -### Sincronización del entorno local con {{site.data.keyword.Bluemix_notm}} -{: #edit_local_download} - -1. Abra una ventana de línea de mandatos. -2. Inicie una sesión en {{site.data.keyword.Bluemix_notm}}: - - ``` - bl login - ``` - {: pre} - -3. Cuando se le solicite, especifique su ID de IBM y su contraseña. -4. Visualice una lista de los proyectos de {{site.data.keyword.Bluemix_notm}}: - - ``` - bl projects - ``` - {: pre} - -4. Sincronice el entorno local con el proyecto en {{site.data.keyword.Bluemix_notm}}: - - ``` - bl sync projectName - ``` - {: pre} - -donde `projectName` es el nombre de la aplicación de {{site.data.keyword.Bluemix_notm}}. - -Cuando haya terminado de editar, especifique `q` para finalizar la sincronización. - -### Habilitación de la característica Desktop Sync para editar código de forma local - -La característica Desktop Sync es como la modalidad Live Edit para la línea de mandatos. Necesita la característica Desktop Sync para depurar en la línea de mandatos. -1. En otra ventana de línea de mandatos, habilite la característica Desktop Sync: - - ``` - cd localDirectory - bl start - ``` - {: codeblock} - -2. Utilice la configuración de lanzamiento que haya creado en {{site.data.keyword.webide}}. Tras seleccionar la configuración de lanzamiento, la característica Desktop Sync estará habilitada en el entorno local. En la ventana de línea de mandatos que acaba de abrir, puede ver el URL de la aplicación, de depuración, de gestión, y ver el estado de {{site.data.keyword.Bluemix_live_notm}}. - -3. Renueve el navegador y verifique que puede ver los cambios que ha guardado en archivos estáticos en el espacio de trabajo local. - -### Inhabilitación de la característica Desktop Sync - -1. En la segunda ventana de la línea de mandatos, especifique `bl stop`. -2. En la primera ventana de la línea de mandatos, especifique `q`. +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} +{:pre: .pre} + +# Edición de código con Eclipse Orion {{site.data.keyword.webide}} +{: #web_ide} + +Última actualización: 9 de septiembre de 2016 +{: .last-updated} + +Eclipse Orion {{site.data.keyword.webide}} es un entorno de desarrollo basado en navegador donde puede desarrollar para la web. Puede desarrollar en JavaScript, HTML y CSS con la ayuda de asistencia de contenido, finalización del código y comprobación de errores. {{site.data.keyword.webide}} funciona con casi cualquier idioma y ofrece realce de la sintaxis para la mayoría de los [tipos de archivos (El enlace se abre en una ventana nueva)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}. El control de origen se crea mediante Git o Jazz SCM, y puede desplegar código de forma local para probar y depurar las apps. +{:shortdesc} + +Lo mejor de todo es que {{site.data.keyword.webide}} está basado en la web. No tiene que instalar, mantener ni escalar nada. Puede desarrollar en cualquier lugar donde tenga conexión a Internet. + +## Configuración del editor +{: #editorsetup} + +{{site.data.keyword.webide}} se puede personalizar para que pueda elegir los esquemas de colores, las herramientas técnicas y los valores que cumplan sus necesidades de desarrollo. Para ver y modificar los valores, desde el menú de la izquierda, pulse el icono **Settings** El icono de valores. + +Si necesita cambiar con frecuencia determinados valores mientras edita, puede acceder a dichos valores rápidamente desde el icono **Valores del editor local** Icono de Valores del editor local en la esquina superior derecha del editor + +![Valores del editor local](images/webide_local_editor_settings.png) + +De forma predeterminada, siempre se muestran los valores para el estilo del editor y el tamaño de fuente. Para incluir otros valores de editor en el menú, siga estos pasos: + +1. Pulse el icono **Valores del editor local** Icono de Valores del editor local. + +2. Pulse **Valores del editor**. + +3. Para incluir o excluir un valor del menú **Valores del editor local**, pulse el círculo que hay junto al valor. + +![Conmutador de Valores del editor](images/webide_editor_settings_toggle.png) + + +## Edición de código +{: #editcode} + +{{site.data.keyword.webide}} tiene dos secciones principales. La primera sección es el navegador de archivos de la izquierda, que muestra los archivos del proyecto en una estructura de árbol. Desde el navegador de archivos, puede crear, cambiar el nombre, suprimir y gestionar los archivos y carpetas. + +**Consejo:** para cargar archivos en el navegador de archivos, arrástrelos desde el sistema al navegador de archivos. + +La segunda sección es el panel del editor a la derecha. El editor proporciona varias características de codificación, incluida la asistencia de contenido y la validación de sintaxis. + +![Web IDE](images/webide.png) + +### Cómo trabajar con varios archivos +1. Para trabajar con dos archivos a la vez, pulse el icono **Cambiar modalidad del editor de división** Icono del Editor de división en la parte superior del editor. +2. Desde el menú que se abre, seleccione una vista. + + Tras seleccionar una vista, si ya se ha abierto un archivo en el editor, se mostrará en ambas vistas de editor. + + Para abrir o cambiar un archivo que se muestra en una de las vistas del editor: + 1. Mueva el cursor a la vista de editor que desee cambiar. + 2. En el navegador de archivos, pulse un archivo. + +### Accesos directos de teclado +Sólo se puede acceder a la mayoría de los mandatos de {{site.data.keyword.webide}} mediante accesos directos de teclado. + +Para ver una lista de los accesos directos de teclado en el editor, pulse Alt+Mayús+?. Si está utilizando un Mac OS, pulse Ctrl+Mayús+?. + +## Gestión del código fuente +{: #sourcecontrol} + +{{site.data.keyword.webide}} se integra con herramientas de gestión de código fuente. Para trabajar con el repositorio de Git, pulse el icono **Repositorio de Git** El icono del repositorio de Git. Para obtener más información, consulte [Control de origen con Git (El enlace se abre en una ventana nueva)](https://hub.jazz.net/docs/git/){: new_window}. + + +## Despliegue de una app desde el espacio de trabajo +{: #deploy} + +1. Para desplegar la app, desde la barra de ejecución, seleccione o [cree (El enlace se abre en una ventana nueva)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} una configuración de lanzamiento. +1. Pulse el icono de despliegue El icono de despliegue. Se desplegará una instancia de la app utilizando el contenido actual del espacio de trabajo y del entorno definido en la configuración de lanzamiento. +2. Una vez que se despliegue la app, puede utilizar la barra de ejecución para detener, reiniciar o depurar la app, ver registros, etc. +![Barra de ejecución](images/webide_runbar.png) + + + + ## Edición fuera del {{site.data.keyword.webide}} +{: #editlocal} + +Para utilizar un editor distinto a {{site.data.keyword.webide}}, configure {{site.data.keyword.Bluemix_live}} para que pueda trabajar directamente con los archivos de proyectos en cualquier herramienta. {{site.data.keyword.Bluemix_live_notm}} es una aplicación de línea de mandatos que sincroniza los cambios del sistema de archivos local con el espacio de trabajo de la nube en {{site.data.keyword.jazzhub}}. + +### Antes de empezar + +Descargue e instale la interfaz de línea de mandatos de [{{site.data.keyword.Bluemix_live_notm}} (El enlace se abre en una ventana nueva)](http://livesyncdownload.ng.bluemix.net){: new_window}. + +### Sincronización del entorno local con {{site.data.keyword.Bluemix_notm}} +{: #edit_local_download} + +1. Abra una ventana de línea de mandatos. +2. Inicie una sesión en {{site.data.keyword.Bluemix_notm}}: + + ``` + bl login + ``` + {: pre} + +3. Cuando se le solicite, especifique su ID de IBM y su contraseña. +4. Visualice una lista de los proyectos de {{site.data.keyword.Bluemix_notm}}: + + ``` + bl projects + ``` + {: pre} + +4. Sincronice el entorno local con el proyecto en {{site.data.keyword.Bluemix_notm}}: + + ``` + bl sync projectName + ``` + {: pre} + +donde `projectName` es el nombre de la aplicación de {{site.data.keyword.Bluemix_notm}}. + +Cuando haya terminado de editar, especifique `q` para finalizar la sincronización. + +### Habilitación de la característica Desktop Sync para editar código de forma local + +La característica Desktop Sync es como la modalidad Live Edit para la línea de mandatos. Necesita la característica Desktop Sync para depurar en la línea de mandatos. +1. En otra ventana de línea de mandatos, habilite la característica Desktop Sync: + + ``` + cd localDirectory + bl start + ``` + {: codeblock} + +2. Utilice la configuración de lanzamiento que haya creado en {{site.data.keyword.webide}}. Tras seleccionar la configuración de lanzamiento, la característica Desktop Sync estará habilitada en el entorno local. En la ventana de línea de mandatos que acaba de abrir, puede ver el URL de la aplicación, de depuración, de gestión, y ver el estado de {{site.data.keyword.Bluemix_live_notm}}. + +3. Renueve el navegador y verifique que puede ver los cambios que ha guardado en archivos estáticos en el espacio de trabajo local. + +### Inhabilitación de la característica Desktop Sync + +1. En la segunda ventana de la línea de mandatos, especifique `bl stop`. +2. En la primera ventana de la línea de mandatos, especifique `q`. diff --git a/toolchains/nl/fr/toolchains_about.md b/toolchains/nl/fr/toolchains_about.md index 7523e10d5..3ad38b8af 100644 --- a/toolchains/nl/fr/toolchains_about.md +++ b/toolchains/nl/fr/toolchains_about.md @@ -1,42 +1,42 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# A propos des chaînes d'outils -{: #toolchains_about} - -Dernière mise à jour : 13 septembre 2016 -{: .last-updated} - -Une *chaîne d'outils* est un ensemble d'intégrations d'outils prenant en charge des tâches de développement, de déploiement et d'opérations. La puissance collective d'une chaîne d'outils est supérieure à la somme de ses intégrations d'outils individuelles. -{:shortdesc} - -Les chaînes d'outils sont disponibles dans les environnements {{site.data.keyword.Bluemix}} public et dédié. Vous pouvez créer une chaîne d'outils de deux façons : à l'aide d'un modèle ou à partir d'une application. Comme point de départ, vous pouvez utiliser un modèle de chaîne d'outils. En fonction du modèle utilisé, vous pouvez créer une chaîne d'outils possédant un ensemble spécifique d'intégrations d'outils ou une chaîne d'outils vide dans laquelle ajouter des intégrations d'outils. - -Sur {{site.data.keyword.Bluemix_notm}} public, selon le modèle ou la chaîne d'outils que vous utilisez, il est possible que la chaîne d'outils inclue un référentiel GitHub (repo) rempli avec le code de démarrage d'application et un pipeline de distribution préconfiguré. Lorsque vous envoyez des modifications au référentiel GitHub de la chaîne d'outils, le pipeline de distribution génère et déploie automatiquement l'application sur {{site.data.keyword.Bluemix_notm}}. - -Sur {{site.data.keyword.Bluemix_notm}} dédié, selon la chaîne d'outils utilisée, il est possible que celle-ci inclue un référentiel GitHub Enterprise rempli avec le code de démarrage d'application et un pipeline de distribution préconfiguré. Lorsque vous envoyez des modifications au référentiel GitHub Enterprise de la chaîne d'outils, le pipeline de distribution génère et déploie automatiquement les applications sur {{site.data.keyword.Bluemix_notm}}. - -## Aide et assistance pour les chaînes d'outils -{: #gettinghelp} - -Si vous rencontrez des problèmes lors de l'utilisation de chaînes d'outils, ou si vous avez des questions, vous pouvez obtenir de l'aide en recherchant des informations ou en posant des questions via un forum. Vous pouvez également ouvrir un ticket de demande de service. - -Si vous utilisez les forums pour poser une question, marquez votre question pour être sûr qu'elle soit vue par les équipes de développement {{site.data.keyword.Bluemix_notm}}. - -* Si vous avez des questions d'ordre technique sur le développement et le déploiement d'une application avec des chaînes d'outils, postez votre question sur [Stack Overflow (Lien s'ouvrant dans une nouvelle fenêtre)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} en y ajoutant les balises "ibm-bluemix" et "devops". - -* Pour les questions relatives aux chaînes d'outils et aux instructions de mise en route, utilisez le forum [IBM developerWorks dW Answers (Lien s'ouvrant dans une nouvelle fenêtre)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}. Ajoutez les balises "devops-services" et "bluemix". - -Pour plus d'informations sur l'utilisation des forums, voir [Comment obtenir de l'aide (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.{DomainName}/docs/support/index.html#getting-help). - -Pour des informations sur l'ouverture d'un ticket de demande de service IBM, ou sur les niveaux de support et les degrés de gravité des tickets, voir [Contacter le service de support (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.{DomainName}/docs/support/index.html#contacting-support). +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# A propos des chaînes d'outils +{: #toolchains_about} + +Dernière mise à jour : 13 septembre 2016 +{: .last-updated} + +Une *chaîne d'outils* est un ensemble d'intégrations d'outils prenant en charge des tâches de développement, de déploiement et d'opérations. La puissance collective d'une chaîne d'outils est supérieure à la somme de ses intégrations d'outils individuelles. +{:shortdesc} + +Les chaînes d'outils sont disponibles dans les environnements {{site.data.keyword.Bluemix}} public et dédié. Vous pouvez créer une chaîne d'outils de deux façons : à l'aide d'un modèle ou à partir d'une application. Comme point de départ, vous pouvez utiliser un modèle de chaîne d'outils. En fonction du modèle utilisé, vous pouvez créer une chaîne d'outils possédant un ensemble spécifique d'intégrations d'outils ou une chaîne d'outils vide dans laquelle ajouter des intégrations d'outils. + +Sur {{site.data.keyword.Bluemix_notm}} public, selon le modèle ou la chaîne d'outils que vous utilisez, il est possible que la chaîne d'outils inclue un référentiel GitHub (repo) rempli avec le code de démarrage d'application et un pipeline de distribution préconfiguré. Lorsque vous envoyez des modifications au référentiel GitHub de la chaîne d'outils, le pipeline de distribution génère et déploie automatiquement l'application sur {{site.data.keyword.Bluemix_notm}}. + +Sur {{site.data.keyword.Bluemix_notm}} dédié, selon la chaîne d'outils utilisée, il est possible que celle-ci inclue un référentiel GitHub Enterprise rempli avec le code de démarrage d'application et un pipeline de distribution préconfiguré. Lorsque vous envoyez des modifications au référentiel GitHub Enterprise de la chaîne d'outils, le pipeline de distribution génère et déploie automatiquement les applications sur {{site.data.keyword.Bluemix_notm}}. + +## Aide et assistance pour les chaînes d'outils +{: #gettinghelp} + +Si vous rencontrez des problèmes lors de l'utilisation de chaînes d'outils, ou si vous avez des questions, vous pouvez obtenir de l'aide en recherchant des informations ou en posant des questions via un forum. Vous pouvez également ouvrir un ticket de demande de service. + +Si vous utilisez les forums pour poser une question, marquez votre question pour être sûr qu'elle soit vue par les équipes de développement {{site.data.keyword.Bluemix_notm}}. + +* Si vous avez des questions d'ordre technique sur le développement et le déploiement d'une application avec des chaînes d'outils, postez votre question sur [Stack Overflow (Lien s'ouvrant dans une nouvelle fenêtre)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} en y ajoutant les balises "ibm-bluemix" et "devops". + +* Pour les questions relatives aux chaînes d'outils et aux instructions de mise en route, utilisez le forum [IBM developerWorks dW Answers (Lien s'ouvrant dans une nouvelle fenêtre)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}. Ajoutez les balises "devops-services" et "bluemix". + +Pour plus d'informations sur l'utilisation des forums, voir [Comment obtenir de l'aide (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.{DomainName}/docs/support/index.html#getting-help). + +Pour des informations sur l'ouverture d'un ticket de demande de service IBM, ou sur les niveaux de support et les degrés de gravité des tickets, voir [Contacter le service de support (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.{DomainName}/docs/support/index.html#contacting-support). diff --git a/toolchains/nl/fr/toolchains_integrations.md b/toolchains/nl/fr/toolchains_integrations.md index 98ed75d2c..2fcdefd92 100644 --- a/toolchains/nl/fr/toolchains_integrations.md +++ b/toolchains/nl/fr/toolchains_integrations.md @@ -1,368 +1,368 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configuration d'intégrations d'outils -{: #integrations} - -Dernière mise à jour : 18 octobre 2016 -{: .last-updated} - -Vous pouvez configurer des intégrations d'outils prenant en charge des tâches de développement, de déploiement et d'opérations lors de la création d'une chaîne d'outils, ou bien vous pouvez ajouter et configurer des intégrations d'outils afin de personnaliser une chaîne d'outils existante. -{:shortdesc} - -**Important** : Sur {{site.data.keyword.Bluemix_notm}} public, les chaînes d'outils sont disponibles uniquement dans la région sud des Etats-Unis. - -Les intégrations d'outils disponibles pour ajouter et configurer votre chaîne d'outils varient selon que vous utilisez des chaînes d'outils sur {{site.data.keyword.Bluemix_notm}} public ou {{site.data.keyword.Bluemix_notm}} dédié. Si -vous utilisez des chaînes d'outils sur -{{site.data.keyword.Bluemix_notm}} Dedicated, les -Intégrations d'outils qui sont disponibles dépendent de la manière -dont {{site.data.keyword.jazzhub_title}} a été configuré dans -votre environnement spécifique. - -*Tableau 1. Intégrations d'outils disponibles pour les chaînes d'outils sur {{site.data.keyword.Bluemix_notm}} public et dédié* - -|Intégration d'outil |Disponible sur {{site.data.keyword.Bluemix_notm}} public | -Disponible sur {{site.data.keyword.Bluemix_notm}} Dedicated -(dépendant de l'environnement)| -|:----------|:------------------------------|:------------------| -|{{site.data.keyword.deliverypipeline}} |Oui |Oui | -|{{site.data.keyword.DRA_short}} |Oui |Non | -|Eclipse Orion {{site.data.keyword.webide}} |Oui |Oui | -|GitHub |Oui |Oui | -|Dedicated GitHub Enterprise |Non |Oui | -|Autre outil |Oui |Oui | -|PagerDuty |Oui |Oui | -|Sauce Labs |Oui |Non | -|Slack |Oui |Oui | - -**Conseil** : Si vous souhaitez débuter le développement par votre code source sur {{site.data.keyword.Bluemix_notm}} public, configurez les intégrations d'outils GitHub et GitHub Issues avant de configurer {{site.data.keyword.deliverypipeline}}. -Si vous souhaitez débuter le développement par votre code source sur -{{site.data.keyword.Bluemix_notm}} dédié, configurez -l'intégration d'outil {{site.data.keyword.ghe_short}} ou -l'intégration d'outil GitHub avant -de configurer {{site.data.keyword.deliverypipeline}}. - - -## Configuration du pipeline de distribution -{: #deliverypipeline} - -{{site.data.keyword.deliverypipeline}} automatise le déploiement de vos projets via des séquences d'étapes qui extraient des travaux en entrée et d'exécution tels que des générations, des tests et des déploiements. - -Configurez {{site.data.keyword.deliverypipeline}} afin d'automatiser la génération, le test et le déploiement en continu de vos applications. - -1. Si vous configurez cette intégration d'outil lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur **Delivery Pipeline**. En fonction du modèle utilisé, des zones différentes peuvent être disponibles. Passez en revue les valeurs de zone par défaut et, si nécessaire, modifiez ces paramètres. -1. Si vous disposez d'une chaîne d'outils sur -{{site.data.keyword.Bluemix_notm}} public et si vous y -ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, -page **Chaînes d'outils**, cliquez sur la chaîne -d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis votre page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. Si vous utilisez une chaîne d'outils sur {{site.data.keyword.Bluemix_notm}} dédié, depuis le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Cliquez sur le bouton d'ajout (+). -1. A la section Intégrations d'outils, cliquez sur **Delivery Pipeline**. -1. Indiquez un nom pour votre nouveau pipeline. -1. Si vous prévoyez d'utiliser votre pipeline pour déployer une interface utilisateur, sélectionnez la case **Application visualisable**. Toutes les applications créées par votre pipeline sont affichées dans la liste **AFFICHER L'APPLICATION** de la page Intégrations d'outils de la chaîne d'outils. -1. Cliquez sur **Créer une intégration** pour ajouter {{site.data.keyword.deliverypipeline}} à votre chaîne d'outils. -1. Cliquez sur la vignette de {{site.data.keyword.deliverypipeline}} pour afficher le pipeline et le configurer. Pour en savoir plus sur les notions de base et la configuration d'un pipeline, voir [Building and deploying from pipelines (Lien s'ouvrant dans une nouvelle fenêtre)](../services/DeliveryPipeline/build_deploy.html){: new_window}. - - **Conseil **: Si vous souhaitez déclencher le pipeline lorsque vous envoyez des modifications à votre référentiel GitHub ou {{site.data.keyword.ghe_short}} (repo), vous devez configurer GitHub ou {{site.data.keyword.ghe_short}} pour votre chaîne d'outils avant de définir les étapes du pipeline. Ces étapes requièrent les URL de vos référentiels. Chaque étape de pipeline peut faire référence à un seul des référentiels GitHub ou {{site.data.keyword.ghe_short}} associé à votre chaîne d'outils. Pour des instructions de configuration de GitHub, voir la section [GitHub](#github). Pour des instructions sur la configuration de Dedicated GitHub Enterprise, voir [Getting started with {{site.data.keyword.ghe_long}} (Lien s'ouvrant dans une nouvelle fenêtre)](../services/ghededicated/index.html){: new_window}. - -1. Facultatif : Si vous utilisez une chaîne d'outils sur {{site.data.keyword.Bluemix_notm}} public et souhaitez que Sauce Labs exécute des tests sur votre application, configurez {{site.data.keyword.deliverypipeline}} pour ajouter un travail de test Sauce Labs. Pour des instructions de configuration du travail de test, voir la section [Configuration d'un travail de test Sauce Labs sur votre pipeline](#config_saucelabs). - -### Configuration d'un travail de test Sauce Labs sur votre pipeline -{: #config_saucelabs} - -Avant de configurer un travail de test Sauce Labs sur votre pipeline, vous avez besoin d'un pipeline opérationnel qui comporte des étapes pour la génération et le déploiement de votre application, et vous devez configurer Sauce Labs pour votre chaîne d'outils. Pour des instructions de configuration de Sauce Labs, voir la section [Configuration de Sauce Labs](#saucelabs). - -Configurez {{site.data.keyword.deliverypipeline}} pour ajouter un travail de test Sauce Labs. - -1. Si vous n'avez pas d'étape pour le déploiement d'une version de test de votre application, créez-en une. -1. Dans l'étape, ajoutez un travail de test après le travail de déploiement. Le fait de placer ces travaux dans la même étape leur permet d'accéder au même ensemble de propriétés d'environnement. - ![Travail de test](images/toolchain_test_job.png) - -1. Configurez l'étape : - - a. Dans l'onglet **PROPRIETES D'ENVIRONNEMENT**, créez trois propriétés : CF_APP_NAME, SAUCE_USERNAME et SAUCE_ACCESS_KEY. - - b. Entrez vos nom d'utilisateur et clé d'accès Sauce Labs. En procédant ainsi, vous externalisez ces valeurs de façon à pouvoir les utiliser dans vos tests. - -1. Configurez le travail de déploiement. Dans la zone **Script de déploiement**, ajoutez la commande suivante : `export CF_APP_NAME="$CF_APP"`. Cette commande exporte le nom d'application en tant que propriété d'environnement. -1. Configurez le travail de test. Les valeurs figurant dans l'image suivante sont des exemples. Les zones d'**instance de service**, de **cible**, d'**organisation** et d'**espace** sont renseignées avec les informations Sauce Labs de nom d'utilisateur, région, organisation et espace que vous utilisez. -![Configuration du travail](images/toolchain_configure_job.png) - - a. Pour le type d'outil de test, sélectionnez **Sauce Labs**. - - b. Pour l'instance de service, sélectionnez le nom d'utilisateur Sauce Labs utilisé lors de la configuration de Sauce Labs pour votre chaîne d'outils. - - **Conseil **: Pour voir le nom d'utilisateur et la clé d'accès que vous avez utilisés lors de la configuration de Sauce Labs pour votre chaîne d'outils, cliquez sur **Configurer**. - - c. Dans la zone de **commande d'exécution de test**, entrez les commandes d'installation des dépendances qui sont requises par vos tests, puis exécutez les tests. Par exemple, pour une application Node.js, vous pourriez entrer les commandes suivantes : - ``` - npm install - node_modules/grunt-cli/bin/grunt test:sauce:parallel - ``` - - d. Si vous souhaitez voir vos rapports de test dans les journaux de travail, sélectionnez la case **Activer le rapport de test** et définissez le masque de fichiers de résultats de test sur `test/*.xml`. - -1. Cliquez sur **SAUVEGARDER**. A chaque exécution de votre pipeline, vos tests Sauce Labs s'exécuteront. - -Pour en savoir plus, voir [Delivery Pipeline (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}. - - -## Ajout de {{site.data.keyword.DRA_short}} -{: #dra} - -{{site.data.keyword.DRA_full}} collecte et analyse les résultats provenant de tests unitaires, de tests fonctionnels et d'outils de couverture de code afin de déterminer si votre code satisfait les critères prédéfinis à certains stades de votre processus de déploiement. Si votre code ne satisfait pas ou dépasse les critères, le déploiement est interrompu afin de prévenir tout risque. Vous pouvez utiliser {{site.data.keyword.DRA_short}} comme filet de sécurité pour votre environnement de distribution continue ou comme moyen d'implémenter et d'améliorer les normes qualité. - - **Remarque** : Cette intégration d'outil est préconfigurée. Elle ne requiert aucun paramètre de configuration et vous ne pouvez pas la reconfigurer. - -Ajoutez {{site.data.keyword.DRA_short}} afin de gérer et d'améliorer la qualité de votre code dans {{site.data.keyword.Bluemix_notm}} en surveillant vos déploiements afin d'identifier les risques avant la publication. - -1. Si vous disposez d'une chaîne d'outils et que vous y -ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, -page **Chaînes d'outils**, cliquez sur la chaîne -d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Cliquez sur le bouton d'ajout (+). -1. A la section Intégrations d'outils, cliquez sur **Deployment Risk Analytics**. -1. Cliquez sur **Créer une intégration**. -1. Cliquez sur la vignette de {{site.data.keyword.DRA_short}}, puis complétez les étapes de mise en route : créez des critères, connectez-les au pipeline, puis exécutez ce dernier. Pour plus d'informations, voir [{{site.data.keyword.DRA_short}} (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}. - - -## Ajout d'Eclipse Orion {{site.data.keyword.webide}} -{: #webide} - -Eclipse Orion {{site.data.keyword.webide}} est un environnement de développement Web intégré dans lequel vous pouvez créer, éditer, exécuter, déboguer et terminer des tâches de contrôle des sources. Vous pouvez facilement passer de l'édition à l'exécution, à la soumission, puis au développement. - - **Remarque** : Cette intégration d'outil est préconfigurée. Elle ne requiert aucun paramètre de configuration et vous ne pouvez pas la reconfigurer. - -Pour effectuer des tâches de contrôle des sources, ajoutez l'intégration d'outil Eclipse Orion {{site.data.keyword.webide}} : - -1. Si vous disposez d'une chaîne d'outils sur -{{site.data.keyword.Bluemix_notm}} public et si vous y -ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, -page **Chaînes d'outils**, cliquez sur la chaîne -d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. Si vous utilisez une chaîne d'outils sur {{site.data.keyword.Bluemix_notm}} dédié, depuis le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Cliquez sur le bouton d'ajout (+). -1. A la section Intégrations d'outils, cliquez sur **Eclipse Orion Web IDE**. -1. Cliquez sur **Créer une intégration**. -1. Cliquez sur la vignette de la nouvelle intégration Eclipse Orion {{site.data.keyword.webide}}. Votre espace de travail est prérempli avec vos référentiels GitHub ou {{site.data.keyword.ghe_short}}. Les référentiels associés à votre chaîne d'outils en cours sont mis en évidence. - -Pour en savoir plus, voir [Edition de code avec Eclipse Orion {{site.data.keyword.webide}} (Lien s'ouvrant dans une nouvelle fenêtre)](../toolchains/web_ide.html){: new_window}. - - -## Configuration de GitHub -{: #github} - -GitHub est un service d'hébergement Web pour les référentiels Git. Vous pouvez avoir des copies en local et à distance de vos référentiels, ce qui simplifie la collaboration. - -GitHub Issues est un outil de suivi qui conserve votre travail et vos plans à un seul et même emplacement. Il est intégré à votre référentiel de développement pour vous permettre de vous concentrer sur les tâches importantes. - -Configurez GitHub pour gérer votre code source dans le cloud : - -1. Si vous configurez cette intégration d'outil lors de la création de la chaîne d'outils, procédez comme suit : - - a. A la section Intégrations configurables, cliquez sur **GitHub**. -Si vous créez la chaîne d'outils sur -{{site.data.keyword.Bluemix_notm}} public et si vous n'avez pas -autorisé -{{site.data.keyword.Bluemix_notm}} à accéder à GitHub, -cliquez sur **Autorisation** pour accéder au site -Web GitHub. Si vous n'avez pas de session GitHub active, vous êtes invité à vous connecter. Cliquez sur **Authorize Application** pour autoriser {{site.data.keyword.Bluemix_notm}} à accéder à votre compte GitHub. Si vous disposez d'une session GitHub active mais n'avez pas saisi votre mot de passe récemment, vous êtes invité à entrer votre mot de passe GitHub pour confirmation. - - b. Passez en revue les emplacements de référentiel cible par défaut pour les référentiels GitHub. Ces référentiels sont clonés à partir des référentiels exemple. Si nécessaire, modifiez les noms des référentiels cible. - ![Emplacements de référentiel cible par défaut](images/toolchain_github_config.png) - -1. Si vous disposez d'une chaîne d'outils et que vous y -ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, -page **Chaînes d'outils**, cliquez sur la chaîne -d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Cliquez sur le bouton d'ajout (+). -1. A la section Intégrations d'outils, cliquez sur **GitHub**. -1. Si vous disposez d'un référentiel GitHub et souhaitez l'utiliser, entrez son URL. Pour le type de référentiel, cliquez sur **Lier**. -1. Si vous souhaitez utiliser un nouveau référentiel GitHub, indiquez un nom pour le référentiel GitHub, entrez l'URL du référentiel que vous clonez ou déviez, puis sélectionnez le type de référentiel : - - a. Pour créer un référentiel vide, cliquez sur **Nouveau**. - - b. Pour créer une copie d'un référentiel GitHub, cliquez sur **Cloner**. - - c. Pour dévier un référentiel GitHub afin de pouvoir participer aux modifications via des demandes d'extraction, cliquez sur **Dévier**. - -1. Si vous souhaitez utiliser GitHub Issues pour le suivi des problèmes, sélectionnez la case **Activer GitHub Issues**. -1. Cliquez sur **Créer une intégration**. -1. Cliquez sur la vignette du référentiel GitHub que vous souhaitez utiliser. Le site Web GitHub s'ouvre ; vous pouvez y afficher le contenu du référentiel. - - **Conseil **: Vous pouvez utiliser les outils intégrés de gestion de code source d'Eclipse Orion {{site.data.keyword.webide}} pour éditer le référentiel GitHub et déployer une application depuis votre poste de travail. - -1. Si vous avez activé GitHub Issues, cliquez sur la vignette GitHub Issues pour l'ouvrir. - -Pour plus d'informations, voir [GitHub (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} et [GitHub Issues (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. - - -## Configuration de Dedicated GitHub Enterprise -{: #configghe} - -{{site.data.keyword.ghe_long}} est un service d'hébergement Web sur site pour les référentiels Git. Dedicated GitHub Enterprise est destiné aux clients de {{site.data.keyword.Bluemix_notm}} dédié uniquement. GitHub Issues est un outil de suivi qui conserve votre travail et vos plans à un seul et même emplacement. Il est intégré à votre référentiel de développement pour vous permettre de vous concentrer sur les tâches importantes. Pour plus d'informations sur Dedicated GitHub Enterprise et GitHub Issues, voir [Utilisation de Dedicated GitHub Enterprise (Lien s'ouvrant dans une nouvelle fenêtre)](../services/ghededicated/index.html){: new_window} et [GitHub Issues (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. - -Vous pouvez configurer {{site.data.keyword.ghe_short}} en tan qu'intégration d'outil dans votre chaîne d'outils afin de pouvoir gérer le code source depuis l'instance [{{site.data.keyword.Bluemix_notm}} dédié (Lien s'ouvrant dans une nouvelle fenêtre)](../dedicated/index.html#dedicated){: new_window} de votre société. - -1. Si vous configurez cette intégration d'outil lors de la création de la chaîne d'outils, procédez comme suit : - - a. Avant de vous connecter à Dedicated GitHub Enterprise pour la première fois, demandez à l'administrateur régional de votre société d'ajouter votre ID utilisateur à votre instance {{site.data.keyword.Bluemix_notm}} dédié à partir du registre d'utilisateurs de la société, via LDAP. Pour des informations sur la configuration de votre compte {{site.data.keyword.ghe_short}}, voir [Utilisation de Dedicated GitHub Enterprise (Lien s'ouvrant dans une nouvelle fenêtre)](../services/ghededicated/index.html){: new_window}. - - b. A la section Intégrations configurables, cliquez sur **{{site.data.keyword.ghe_short}}**. - - c. Vérifiez le nom par défaut pour le nouveau référentiel {{site.data.keyword.ghe_short}}. Si nécessaire, changez le nom du nouveau référentiel. L'image suivante montre un exemple de référentiel cloné à partir d'un référentiel exemple. Vous pouvez utiliser un référentiel existant ou un nouveau référentiel. Pour utiliser un nouveau référentiel, vous pouvez créer un référentiel vide, cloner un référentiel ou dévier un référentiel. - ![Emplacements de référentiel par défaut](images/toolchain_ghe_config.png) - -1. Si vous disposez d'une chaîne d'outils sur -{{site.data.keyword.Bluemix_notm}} public et si vous y -ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, -page **Chaînes d'outils**, cliquez sur la chaîne -d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis votre page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. Si vous utilisez une chaîne d'outils sur {{site.data.keyword.Bluemix_notm}} dédié, depuis le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Cliquez sur le bouton d'ajout (+). -1. A la section Intégrations d'outils, cliquez sur **{{site.data.keyword.ghe_short}}**. -1. Si vous disposez d'un référentiel {{site.data.keyword.ghe_short}} que vous souhaitez utiliser, entrez l'URL du référentiel. Pour le type de référentiel, cliquez sur **Existant**. -1. Si vous souhaitez utiliser un nouveau référentiel {{site.data.keyword.ghe_short}}, indiquez un nom pour le référentiel, entrez l'URL du référentiel que vous clonez ou déviez, puis sélectionnez le type de référentiel : - - a. Pour créer un référentiel vide, cliquez sur **Nouveau**. - - b. Pour créer une copie d'un référentiel, cliquez sur **Cloner**. - - c. Pour dévier un référentiel afin de pouvoir participer aux modifications via des demandes d'extraction, cliquez sur **Dévier**. - -1. Pour utiliser GitHub Issues pour le suivi des problèmes, sélectionnez la case **Activer GitHub Issues**. -1. Cliquez sur **Créer une intégration**. -1. Cliquez sur la vignette du référentiel {{site.data.keyword.ghe_short}} à utiliser. L'instance de [{{site.data.keyword.Bluemix_notm}} dédié (Lien s'ouvrant dans une nouvelle fenêtre)](../dedicated/index.html#dedicated){: new_window} de votre société s'ouvre, vous permettant de consulter le contenu du référentiel. - - **Conseil **: Vous pouvez utiliser les outils intégrés de gestion de code source d'Eclipse Orion {{site.data.keyword.webide}} pour éditer le référentiel {{site.data.keyword.ghe_short}} et déployer une application depuis votre poste de travail. - -1. Si vous avez activé GitHub Issues, cliquez sur la vignette GitHub Issues. - - - -## Configuration d'un outil personnalisé (autre outil) -{: #othertool} - -Si votre équipe utilise un outil qui n'est pas inclus dans la -liste des intégrations de chaîne d'outils, vous pouvez intégrer un -outil personnalisé. - -Configurez un outil personnalisé qui puisse fonctionner avec -les autres outils de votre chaîne d'outils et qui soit disponible -pour votre équipe : -1. Si vous configurez cette intégration d'outil lorsque vous -créez la chaîne d'outils, à la section Intégrations configurables, -cliquez sur **Autre outil**. - -1. Si vous disposez d'une chaîne d'outils et que vous y -ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, -page **Chaînes d'outils**, cliquez sur la chaîne -d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Cliquez sur le bouton d'ajout (+). -1. A la section Intégrations d'outils, cliquez sur -**Autre outil**. -1. Saisissez le nom de l'outil. -1. Sélectionnez la phase de cycle de vie qui est le plus -étroitement associée à l'outil. Ce choix détermine la catégorie sous -laquelle est répertorié votre outil dans la page Toolchain Integration. -1. Ajoutez une URL d'icône. Cette icône figurera sur la carte -d'intégration de votre outil. -1. Ajoutez une URL de documentation. -1. Indiquez un nom d'instance d'outil. Par exemple : Outil de -mon équipe. -1. Ajoutez une URL d'instance de l'outil. Un clic sur -la carte de l'outil d'intégration permet d'accéder à l'URL que vous -indiquez pour l'instance d'outil. -1. Ajoutez une description de votre outil. -1. (Avancé) Ajoutez des propriétés supplémentaires si besoin. Par -exemple, indiquez les informations ou les attributs qui sont -requis pour l'intégration de votre outil aux autres outils de votre -chaîne d'outils. -1. Cliquez sur **Créer une intégration**. - -## Configuration de PagerDuty -{: #pagerduty} - -PagerDuty intègre dans une vue unique les données provenant de plusieurs systèmes de surveillance. Quand un problème survient, PagerDuty s'assure que le membre d'équipe le plus à même de le résoudre reçoit une notification. Si le membre d'équipe ne résout pas le problème, il est possible de mettre en place des escalades afin de router le problème vers des ingénieurs de second niveau ou des gestionnaires des opérations. - -Configurez PagerDuty pour l'envoi de notifications en cas d'échec d'étape de pipeline afin de pouvoir résoudre les problèmes plus rapidement et de réduire le temps d'indisponibilité. - -1. Si vous configurez cette intégration d'outil lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur **PagerDuty**. -1. Si vous disposez d'une chaîne d'outils et que vous y -ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, -page **Chaînes d'outils**, cliquez sur la chaîne -d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Cliquez sur le bouton d'ajout (+). -1. A la section Intégrations d'outils, cliquez sur **PagerDuty**. -1. Entrez le nom du site PagerDuty associé à votre compte PagerDuty. Si vous ne disposez pas d'un compte PagerDuty, [inscrivez-vous (Lien s'ouvrant dans une nouvelle fenêtre)](https://signup.pagerduty.com/accounts/new){: new_window}. -1. Entrez la clé d'accès d'API pour votre compte PagerDuty. Pour des instructions de recherche de la clé, voir [API Authentication (Lien s'ouvrant dans une nouvelle fenêtre)](https://signup.pagerduty.com/accounts/new){: new_window}. -1. Entrez le nom de votre service PagerDuty. -1. Entrez l'adresse électronique du contact PagerDuty principal. -1. Entrez le numéro de téléphone du contact PagerDuty principal. -1. Cliquez sur **Créer une intégration**. -1. Cliquez sur la vignette PagerDuty pour accéder à pagerduty.com. Vous pouvez afficher les événements associés au service PagerDuty spécifié lors de la configuration de cette intégration d'outil pour votre chaîne d'outils. - -Pour en savoir plus, voir [PagerDuty (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}. - - -## Configuration de Sauce Labs -{: #saucelabs} - -Sauce Labs exécute des tests unitaires fonctionnels. Quand une suite de tests Sauce Labs est configurée comme travail de test dans {{site.data.keyword.deliverypipeline}}, cette suite de tests peut exécuter des tests en fonction de votre application Web ou mobile dans le cadre de votre processus de distribution continue. Ces tests peuvent fournir un contrôle de flux de valeur pour vos projets, agissant comme des barrières pour empêcher le déploiement de code incorrect. - -Configurez Sauce Labs pour l'exécution de tests fonctionnels automatisés sur plusieurs systèmes d'exploitation et navigateurs afin de pouvoir émuler la façon dont un utilisateur peut utiliser un site Web ou une application : - -1. Si vous configurez cette intégration d'outil lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur **Sauce Labs**. -1. Si vous disposez d'une chaîne d'outils et que vous y -ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, -page **Chaînes d'outils**, cliquez sur la chaîne -d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Cliquez sur le bouton d'ajout (+). -1. A la section Intégrations d'outils, cliquez sur **Sauce Labs**. -1. Entrez le nom d'utilisateur associé à votre compte Sauce Labs. Vous pouvez [trouver votre nom d'utilisateur dans le message d’accueil, en haut de la page de votre compte Sauce Labs (Lien s'ouvrant dans une nouvelle fenêtre)](https://saucelabs.com/account){: new_window}. -1. Entrez la clé d'accès de votre compte Sauce Labs. Vous pouvez [trouver la clé sur la page de votre compte Sauce Labs (Lien s'ouvrant dans une nouvelle fenêtre)](https://saucelabs.com/account){: new_window}. -1. Cliquez sur **Créer une intégration**. -1. Cliquez sur la vignette Sauce Labs pour accéder à saucelabs.com et afficher l'activité de test pour la chaîne d'outils. - - **Conseil **: Si vous avez ajouté un travail de test Sauce Labs à {{site.data.keyword.deliverypipeline}}, vous pouvez sélectionner l'instance de service. - -Pour en savoir plus, voir [Sauce Labs (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}. - - -## Configuration de Slack -{: #slack} - -**Important **: Les notifications postées sur des canaux Slack publics sont visibles de tout membre de l'équipe. N'oubliez pas que vous êtes responsable du contenu de vos articles. - -Slack est un système de messagerie et de notification en temps réel, basé sur le cloud. Slack fournit un système de discussion permanente, alternative plus interactive au courrier électronique pour la collaboration des équipes. Vous pouvez communiquer avec votre équipe sur un canal dédié ou sur un ensemble de canaux directement liés à votre travail. Vous pouvez également partager des fichiers et des images via ces canaux, ou dans des messages directs entre deux personnes ou plus. Les communications dans les messages directs ou sur les canaux sont conservées pour que vous puissiez y faire des recherches. - -Configurez Slack pour la réception de notifications concernant votre chaîne d'outils depuis les intégrations d'outils, par exemple les activités de test et de déploiement : - -1. Si vous configurez cette intégration d'outil lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur **Slack**. -1. Si vous disposez d'une chaîne d'outils et que vous y -ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, -page **Chaînes d'outils**, cliquez sur la chaîne -d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Cliquez sur le bouton d'ajout (+). -1. A la section Intégrations d'outils, cliquez sur **Slack**. -1. Entrez le jeton d'authentification d'API pour votre compte Slack. Vous devez utiliser un jeton d'accès complet généré pour l'authentification avec Slack. Pour des instructions de recherche du jeton, voir [Slack authentication (Lien s'ouvrant dans une nouvelle fenêtre)](https://api.slack.com/web#authentication){: new_window}. -1. Entrez le nom du canal Slack sur lequel vous souhaitez recevoir les notifications. Si le canal spécifié n'existe pas, il est créé. Si le canal a été archivé, il est réactivé. -1. Cliquez sur **Créer une intégration**. -1. Cliquez sur la vignette Slack. Vous pouvez afficher toutes les activités de votre chaîne d'outils dans le canal Slack configuré. - -Pour en savoir plus, voir [Slack (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}. - - - - - - - - +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configuration d'intégrations d'outils +{: #integrations} + +Dernière mise à jour : 18 octobre 2016 +{: .last-updated} + +Vous pouvez configurer des intégrations d'outils prenant en charge des tâches de développement, de déploiement et d'opérations lors de la création d'une chaîne d'outils, ou bien vous pouvez ajouter et configurer des intégrations d'outils afin de personnaliser une chaîne d'outils existante. +{:shortdesc} + +**Important** : Sur {{site.data.keyword.Bluemix_notm}} public, les chaînes d'outils sont disponibles uniquement dans la région sud des Etats-Unis. + +Les intégrations d'outils disponibles pour ajouter et configurer votre chaîne d'outils varient selon que vous utilisez des chaînes d'outils sur {{site.data.keyword.Bluemix_notm}} public ou {{site.data.keyword.Bluemix_notm}} dédié. Si +vous utilisez des chaînes d'outils sur +{{site.data.keyword.Bluemix_notm}} Dedicated, les +Intégrations d'outils qui sont disponibles dépendent de la manière +dont {{site.data.keyword.jazzhub_title}} a été configuré dans +votre environnement spécifique. + +*Tableau 1. Intégrations d'outils disponibles pour les chaînes d'outils sur {{site.data.keyword.Bluemix_notm}} public et dédié* + +|Intégration d'outil |Disponible sur {{site.data.keyword.Bluemix_notm}} public | +Disponible sur {{site.data.keyword.Bluemix_notm}} Dedicated +(dépendant de l'environnement)| +|:----------|:------------------------------|:------------------| +|{{site.data.keyword.deliverypipeline}} |Oui |Oui | +|{{site.data.keyword.DRA_short}} |Oui |Non | +|Eclipse Orion {{site.data.keyword.webide}} |Oui |Oui | +|GitHub |Oui |Oui | +|Dedicated GitHub Enterprise |Non |Oui | +|Autre outil |Oui |Oui | +|PagerDuty |Oui |Oui | +|Sauce Labs |Oui |Non | +|Slack |Oui |Oui | + +**Conseil** : Si vous souhaitez débuter le développement par votre code source sur {{site.data.keyword.Bluemix_notm}} public, configurez les intégrations d'outils GitHub et GitHub Issues avant de configurer {{site.data.keyword.deliverypipeline}}. +Si vous souhaitez débuter le développement par votre code source sur +{{site.data.keyword.Bluemix_notm}} dédié, configurez +l'intégration d'outil {{site.data.keyword.ghe_short}} ou +l'intégration d'outil GitHub avant +de configurer {{site.data.keyword.deliverypipeline}}. + + +## Configuration du pipeline de distribution +{: #deliverypipeline} + +{{site.data.keyword.deliverypipeline}} automatise le déploiement de vos projets via des séquences d'étapes qui extraient des travaux en entrée et d'exécution tels que des générations, des tests et des déploiements. + +Configurez {{site.data.keyword.deliverypipeline}} afin d'automatiser la génération, le test et le déploiement en continu de vos applications. + +1. Si vous configurez cette intégration d'outil lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur **Delivery Pipeline**. En fonction du modèle utilisé, des zones différentes peuvent être disponibles. Passez en revue les valeurs de zone par défaut et, si nécessaire, modifiez ces paramètres. +1. Si vous disposez d'une chaîne d'outils sur +{{site.data.keyword.Bluemix_notm}} public et si vous y +ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, +page **Chaînes d'outils**, cliquez sur la chaîne +d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis votre page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. Si vous utilisez une chaîne d'outils sur {{site.data.keyword.Bluemix_notm}} dédié, depuis le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Cliquez sur le bouton d'ajout (+). +1. A la section Intégrations d'outils, cliquez sur **Delivery Pipeline**. +1. Indiquez un nom pour votre nouveau pipeline. +1. Si vous prévoyez d'utiliser votre pipeline pour déployer une interface utilisateur, sélectionnez la case **Application visualisable**. Toutes les applications créées par votre pipeline sont affichées dans la liste **AFFICHER L'APPLICATION** de la page Intégrations d'outils de la chaîne d'outils. +1. Cliquez sur **Créer une intégration** pour ajouter {{site.data.keyword.deliverypipeline}} à votre chaîne d'outils. +1. Cliquez sur la vignette de {{site.data.keyword.deliverypipeline}} pour afficher le pipeline et le configurer. Pour en savoir plus sur les notions de base et la configuration d'un pipeline, voir [Building and deploying from pipelines (Lien s'ouvrant dans une nouvelle fenêtre)](../services/DeliveryPipeline/build_deploy.html){: new_window}. + + **Conseil **: Si vous souhaitez déclencher le pipeline lorsque vous envoyez des modifications à votre référentiel GitHub ou {{site.data.keyword.ghe_short}} (repo), vous devez configurer GitHub ou {{site.data.keyword.ghe_short}} pour votre chaîne d'outils avant de définir les étapes du pipeline. Ces étapes requièrent les URL de vos référentiels. Chaque étape de pipeline peut faire référence à un seul des référentiels GitHub ou {{site.data.keyword.ghe_short}} associé à votre chaîne d'outils. Pour des instructions de configuration de GitHub, voir la section [GitHub](#github). Pour des instructions sur la configuration de Dedicated GitHub Enterprise, voir [Getting started with {{site.data.keyword.ghe_long}} (Lien s'ouvrant dans une nouvelle fenêtre)](../services/ghededicated/index.html){: new_window}. + +1. Facultatif : Si vous utilisez une chaîne d'outils sur {{site.data.keyword.Bluemix_notm}} public et souhaitez que Sauce Labs exécute des tests sur votre application, configurez {{site.data.keyword.deliverypipeline}} pour ajouter un travail de test Sauce Labs. Pour des instructions de configuration du travail de test, voir la section [Configuration d'un travail de test Sauce Labs sur votre pipeline](#config_saucelabs). + +### Configuration d'un travail de test Sauce Labs sur votre pipeline +{: #config_saucelabs} + +Avant de configurer un travail de test Sauce Labs sur votre pipeline, vous avez besoin d'un pipeline opérationnel qui comporte des étapes pour la génération et le déploiement de votre application, et vous devez configurer Sauce Labs pour votre chaîne d'outils. Pour des instructions de configuration de Sauce Labs, voir la section [Configuration de Sauce Labs](#saucelabs). + +Configurez {{site.data.keyword.deliverypipeline}} pour ajouter un travail de test Sauce Labs. + +1. Si vous n'avez pas d'étape pour le déploiement d'une version de test de votre application, créez-en une. +1. Dans l'étape, ajoutez un travail de test après le travail de déploiement. Le fait de placer ces travaux dans la même étape leur permet d'accéder au même ensemble de propriétés d'environnement. + ![Travail de test](images/toolchain_test_job.png) + +1. Configurez l'étape : + + a. Dans l'onglet **PROPRIETES D'ENVIRONNEMENT**, créez trois propriétés : CF_APP_NAME, SAUCE_USERNAME et SAUCE_ACCESS_KEY. + + b. Entrez vos nom d'utilisateur et clé d'accès Sauce Labs. En procédant ainsi, vous externalisez ces valeurs de façon à pouvoir les utiliser dans vos tests. + +1. Configurez le travail de déploiement. Dans la zone **Script de déploiement**, ajoutez la commande suivante : `export CF_APP_NAME="$CF_APP"`. Cette commande exporte le nom d'application en tant que propriété d'environnement. +1. Configurez le travail de test. Les valeurs figurant dans l'image suivante sont des exemples. Les zones d'**instance de service**, de **cible**, d'**organisation** et d'**espace** sont renseignées avec les informations Sauce Labs de nom d'utilisateur, région, organisation et espace que vous utilisez. +![Configuration du travail](images/toolchain_configure_job.png) + + a. Pour le type d'outil de test, sélectionnez **Sauce Labs**. + + b. Pour l'instance de service, sélectionnez le nom d'utilisateur Sauce Labs utilisé lors de la configuration de Sauce Labs pour votre chaîne d'outils. + + **Conseil **: Pour voir le nom d'utilisateur et la clé d'accès que vous avez utilisés lors de la configuration de Sauce Labs pour votre chaîne d'outils, cliquez sur **Configurer**. + + c. Dans la zone de **commande d'exécution de test**, entrez les commandes d'installation des dépendances qui sont requises par vos tests, puis exécutez les tests. Par exemple, pour une application Node.js, vous pourriez entrer les commandes suivantes : + ``` + npm install + node_modules/grunt-cli/bin/grunt test:sauce:parallel + ``` + + d. Si vous souhaitez voir vos rapports de test dans les journaux de travail, sélectionnez la case **Activer le rapport de test** et définissez le masque de fichiers de résultats de test sur `test/*.xml`. + +1. Cliquez sur **SAUVEGARDER**. A chaque exécution de votre pipeline, vos tests Sauce Labs s'exécuteront. + +Pour en savoir plus, voir [Delivery Pipeline (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}. + + +## Ajout de {{site.data.keyword.DRA_short}} +{: #dra} + +{{site.data.keyword.DRA_full}} collecte et analyse les résultats provenant de tests unitaires, de tests fonctionnels et d'outils de couverture de code afin de déterminer si votre code satisfait les critères prédéfinis à certains stades de votre processus de déploiement. Si votre code ne satisfait pas ou dépasse les critères, le déploiement est interrompu afin de prévenir tout risque. Vous pouvez utiliser {{site.data.keyword.DRA_short}} comme filet de sécurité pour votre environnement de distribution continue ou comme moyen d'implémenter et d'améliorer les normes qualité. + + **Remarque** : Cette intégration d'outil est préconfigurée. Elle ne requiert aucun paramètre de configuration et vous ne pouvez pas la reconfigurer. + +Ajoutez {{site.data.keyword.DRA_short}} afin de gérer et d'améliorer la qualité de votre code dans {{site.data.keyword.Bluemix_notm}} en surveillant vos déploiements afin d'identifier les risques avant la publication. + +1. Si vous disposez d'une chaîne d'outils et que vous y +ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, +page **Chaînes d'outils**, cliquez sur la chaîne +d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Cliquez sur le bouton d'ajout (+). +1. A la section Intégrations d'outils, cliquez sur **Deployment Risk Analytics**. +1. Cliquez sur **Créer une intégration**. +1. Cliquez sur la vignette de {{site.data.keyword.DRA_short}}, puis complétez les étapes de mise en route : créez des critères, connectez-les au pipeline, puis exécutez ce dernier. Pour plus d'informations, voir [{{site.data.keyword.DRA_short}} (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}. + + +## Ajout d'Eclipse Orion {{site.data.keyword.webide}} +{: #webide} + +Eclipse Orion {{site.data.keyword.webide}} est un environnement de développement Web intégré dans lequel vous pouvez créer, éditer, exécuter, déboguer et terminer des tâches de contrôle des sources. Vous pouvez facilement passer de l'édition à l'exécution, à la soumission, puis au développement. + + **Remarque** : Cette intégration d'outil est préconfigurée. Elle ne requiert aucun paramètre de configuration et vous ne pouvez pas la reconfigurer. + +Pour effectuer des tâches de contrôle des sources, ajoutez l'intégration d'outil Eclipse Orion {{site.data.keyword.webide}} : + +1. Si vous disposez d'une chaîne d'outils sur +{{site.data.keyword.Bluemix_notm}} public et si vous y +ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, +page **Chaînes d'outils**, cliquez sur la chaîne +d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. Si vous utilisez une chaîne d'outils sur {{site.data.keyword.Bluemix_notm}} dédié, depuis le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Cliquez sur le bouton d'ajout (+). +1. A la section Intégrations d'outils, cliquez sur **Eclipse Orion Web IDE**. +1. Cliquez sur **Créer une intégration**. +1. Cliquez sur la vignette de la nouvelle intégration Eclipse Orion {{site.data.keyword.webide}}. Votre espace de travail est prérempli avec vos référentiels GitHub ou {{site.data.keyword.ghe_short}}. Les référentiels associés à votre chaîne d'outils en cours sont mis en évidence. + +Pour en savoir plus, voir [Edition de code avec Eclipse Orion {{site.data.keyword.webide}} (Lien s'ouvrant dans une nouvelle fenêtre)](../toolchains/web_ide.html){: new_window}. + + +## Configuration de GitHub +{: #github} + +GitHub est un service d'hébergement Web pour les référentiels Git. Vous pouvez avoir des copies en local et à distance de vos référentiels, ce qui simplifie la collaboration. + +GitHub Issues est un outil de suivi qui conserve votre travail et vos plans à un seul et même emplacement. Il est intégré à votre référentiel de développement pour vous permettre de vous concentrer sur les tâches importantes. + +Configurez GitHub pour gérer votre code source dans le cloud : + +1. Si vous configurez cette intégration d'outil lors de la création de la chaîne d'outils, procédez comme suit : + + a. A la section Intégrations configurables, cliquez sur **GitHub**. +Si vous créez la chaîne d'outils sur +{{site.data.keyword.Bluemix_notm}} public et si vous n'avez pas +autorisé +{{site.data.keyword.Bluemix_notm}} à accéder à GitHub, +cliquez sur **Autorisation** pour accéder au site +Web GitHub. Si vous n'avez pas de session GitHub active, vous êtes invité à vous connecter. Cliquez sur **Authorize Application** pour autoriser {{site.data.keyword.Bluemix_notm}} à accéder à votre compte GitHub. Si vous disposez d'une session GitHub active mais n'avez pas saisi votre mot de passe récemment, vous êtes invité à entrer votre mot de passe GitHub pour confirmation. + + b. Passez en revue les emplacements de référentiel cible par défaut pour les référentiels GitHub. Ces référentiels sont clonés à partir des référentiels exemple. Si nécessaire, modifiez les noms des référentiels cible. + ![Emplacements de référentiel cible par défaut](images/toolchain_github_config.png) + +1. Si vous disposez d'une chaîne d'outils et que vous y +ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, +page **Chaînes d'outils**, cliquez sur la chaîne +d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Cliquez sur le bouton d'ajout (+). +1. A la section Intégrations d'outils, cliquez sur **GitHub**. +1. Si vous disposez d'un référentiel GitHub et souhaitez l'utiliser, entrez son URL. Pour le type de référentiel, cliquez sur **Lier**. +1. Si vous souhaitez utiliser un nouveau référentiel GitHub, indiquez un nom pour le référentiel GitHub, entrez l'URL du référentiel que vous clonez ou déviez, puis sélectionnez le type de référentiel : + + a. Pour créer un référentiel vide, cliquez sur **Nouveau**. + + b. Pour créer une copie d'un référentiel GitHub, cliquez sur **Cloner**. + + c. Pour dévier un référentiel GitHub afin de pouvoir participer aux modifications via des demandes d'extraction, cliquez sur **Dévier**. + +1. Si vous souhaitez utiliser GitHub Issues pour le suivi des problèmes, sélectionnez la case **Activer GitHub Issues**. +1. Cliquez sur **Créer une intégration**. +1. Cliquez sur la vignette du référentiel GitHub que vous souhaitez utiliser. Le site Web GitHub s'ouvre ; vous pouvez y afficher le contenu du référentiel. + + **Conseil **: Vous pouvez utiliser les outils intégrés de gestion de code source d'Eclipse Orion {{site.data.keyword.webide}} pour éditer le référentiel GitHub et déployer une application depuis votre poste de travail. + +1. Si vous avez activé GitHub Issues, cliquez sur la vignette GitHub Issues pour l'ouvrir. + +Pour plus d'informations, voir [GitHub (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} et [GitHub Issues (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. + + +## Configuration de Dedicated GitHub Enterprise +{: #configghe} + +{{site.data.keyword.ghe_long}} est un service d'hébergement Web sur site pour les référentiels Git. Dedicated GitHub Enterprise est destiné aux clients de {{site.data.keyword.Bluemix_notm}} dédié uniquement. GitHub Issues est un outil de suivi qui conserve votre travail et vos plans à un seul et même emplacement. Il est intégré à votre référentiel de développement pour vous permettre de vous concentrer sur les tâches importantes. Pour plus d'informations sur Dedicated GitHub Enterprise et GitHub Issues, voir [Utilisation de Dedicated GitHub Enterprise (Lien s'ouvrant dans une nouvelle fenêtre)](../services/ghededicated/index.html){: new_window} et [GitHub Issues (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. + +Vous pouvez configurer {{site.data.keyword.ghe_short}} en tan qu'intégration d'outil dans votre chaîne d'outils afin de pouvoir gérer le code source depuis l'instance [{{site.data.keyword.Bluemix_notm}} dédié (Lien s'ouvrant dans une nouvelle fenêtre)](../dedicated/index.html#dedicated){: new_window} de votre société. + +1. Si vous configurez cette intégration d'outil lors de la création de la chaîne d'outils, procédez comme suit : + + a. Avant de vous connecter à Dedicated GitHub Enterprise pour la première fois, demandez à l'administrateur régional de votre société d'ajouter votre ID utilisateur à votre instance {{site.data.keyword.Bluemix_notm}} dédié à partir du registre d'utilisateurs de la société, via LDAP. Pour des informations sur la configuration de votre compte {{site.data.keyword.ghe_short}}, voir [Utilisation de Dedicated GitHub Enterprise (Lien s'ouvrant dans une nouvelle fenêtre)](../services/ghededicated/index.html){: new_window}. + + b. A la section Intégrations configurables, cliquez sur **{{site.data.keyword.ghe_short}}**. + + c. Vérifiez le nom par défaut pour le nouveau référentiel {{site.data.keyword.ghe_short}}. Si nécessaire, changez le nom du nouveau référentiel. L'image suivante montre un exemple de référentiel cloné à partir d'un référentiel exemple. Vous pouvez utiliser un référentiel existant ou un nouveau référentiel. Pour utiliser un nouveau référentiel, vous pouvez créer un référentiel vide, cloner un référentiel ou dévier un référentiel. + ![Emplacements de référentiel par défaut](images/toolchain_ghe_config.png) + +1. Si vous disposez d'une chaîne d'outils sur +{{site.data.keyword.Bluemix_notm}} public et si vous y +ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, +page **Chaînes d'outils**, cliquez sur la chaîne +d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis votre page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. Si vous utilisez une chaîne d'outils sur {{site.data.keyword.Bluemix_notm}} dédié, depuis le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Cliquez sur le bouton d'ajout (+). +1. A la section Intégrations d'outils, cliquez sur **{{site.data.keyword.ghe_short}}**. +1. Si vous disposez d'un référentiel {{site.data.keyword.ghe_short}} que vous souhaitez utiliser, entrez l'URL du référentiel. Pour le type de référentiel, cliquez sur **Existant**. +1. Si vous souhaitez utiliser un nouveau référentiel {{site.data.keyword.ghe_short}}, indiquez un nom pour le référentiel, entrez l'URL du référentiel que vous clonez ou déviez, puis sélectionnez le type de référentiel : + + a. Pour créer un référentiel vide, cliquez sur **Nouveau**. + + b. Pour créer une copie d'un référentiel, cliquez sur **Cloner**. + + c. Pour dévier un référentiel afin de pouvoir participer aux modifications via des demandes d'extraction, cliquez sur **Dévier**. + +1. Pour utiliser GitHub Issues pour le suivi des problèmes, sélectionnez la case **Activer GitHub Issues**. +1. Cliquez sur **Créer une intégration**. +1. Cliquez sur la vignette du référentiel {{site.data.keyword.ghe_short}} à utiliser. L'instance de [{{site.data.keyword.Bluemix_notm}} dédié (Lien s'ouvrant dans une nouvelle fenêtre)](../dedicated/index.html#dedicated){: new_window} de votre société s'ouvre, vous permettant de consulter le contenu du référentiel. + + **Conseil **: Vous pouvez utiliser les outils intégrés de gestion de code source d'Eclipse Orion {{site.data.keyword.webide}} pour éditer le référentiel {{site.data.keyword.ghe_short}} et déployer une application depuis votre poste de travail. + +1. Si vous avez activé GitHub Issues, cliquez sur la vignette GitHub Issues. + + + +## Configuration d'un outil personnalisé (autre outil) +{: #othertool} + +Si votre équipe utilise un outil qui n'est pas inclus dans la +liste des intégrations de chaîne d'outils, vous pouvez intégrer un +outil personnalisé. + +Configurez un outil personnalisé qui puisse fonctionner avec +les autres outils de votre chaîne d'outils et qui soit disponible +pour votre équipe : +1. Si vous configurez cette intégration d'outil lorsque vous +créez la chaîne d'outils, à la section Intégrations configurables, +cliquez sur **Autre outil**. + +1. Si vous disposez d'une chaîne d'outils et que vous y +ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, +page **Chaînes d'outils**, cliquez sur la chaîne +d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Cliquez sur le bouton d'ajout (+). +1. A la section Intégrations d'outils, cliquez sur +**Autre outil**. +1. Saisissez le nom de l'outil. +1. Sélectionnez la phase de cycle de vie qui est le plus +étroitement associée à l'outil. Ce choix détermine la catégorie sous +laquelle est répertorié votre outil dans la page Toolchain Integration. +1. Ajoutez une URL d'icône. Cette icône figurera sur la carte +d'intégration de votre outil. +1. Ajoutez une URL de documentation. +1. Indiquez un nom d'instance d'outil. Par exemple : Outil de +mon équipe. +1. Ajoutez une URL d'instance de l'outil. Un clic sur +la carte de l'outil d'intégration permet d'accéder à l'URL que vous +indiquez pour l'instance d'outil. +1. Ajoutez une description de votre outil. +1. (Avancé) Ajoutez des propriétés supplémentaires si besoin. Par +exemple, indiquez les informations ou les attributs qui sont +requis pour l'intégration de votre outil aux autres outils de votre +chaîne d'outils. +1. Cliquez sur **Créer une intégration**. + +## Configuration de PagerDuty +{: #pagerduty} + +PagerDuty intègre dans une vue unique les données provenant de plusieurs systèmes de surveillance. Quand un problème survient, PagerDuty s'assure que le membre d'équipe le plus à même de le résoudre reçoit une notification. Si le membre d'équipe ne résout pas le problème, il est possible de mettre en place des escalades afin de router le problème vers des ingénieurs de second niveau ou des gestionnaires des opérations. + +Configurez PagerDuty pour l'envoi de notifications en cas d'échec d'étape de pipeline afin de pouvoir résoudre les problèmes plus rapidement et de réduire le temps d'indisponibilité. + +1. Si vous configurez cette intégration d'outil lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur **PagerDuty**. +1. Si vous disposez d'une chaîne d'outils et que vous y +ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, +page **Chaînes d'outils**, cliquez sur la chaîne +d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Cliquez sur le bouton d'ajout (+). +1. A la section Intégrations d'outils, cliquez sur **PagerDuty**. +1. Entrez le nom du site PagerDuty associé à votre compte PagerDuty. Si vous ne disposez pas d'un compte PagerDuty, [inscrivez-vous (Lien s'ouvrant dans une nouvelle fenêtre)](https://signup.pagerduty.com/accounts/new){: new_window}. +1. Entrez la clé d'accès d'API pour votre compte PagerDuty. Pour des instructions de recherche de la clé, voir [API Authentication (Lien s'ouvrant dans une nouvelle fenêtre)](https://signup.pagerduty.com/accounts/new){: new_window}. +1. Entrez le nom de votre service PagerDuty. +1. Entrez l'adresse électronique du contact PagerDuty principal. +1. Entrez le numéro de téléphone du contact PagerDuty principal. +1. Cliquez sur **Créer une intégration**. +1. Cliquez sur la vignette PagerDuty pour accéder à pagerduty.com. Vous pouvez afficher les événements associés au service PagerDuty spécifié lors de la configuration de cette intégration d'outil pour votre chaîne d'outils. + +Pour en savoir plus, voir [PagerDuty (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}. + + +## Configuration de Sauce Labs +{: #saucelabs} + +Sauce Labs exécute des tests unitaires fonctionnels. Quand une suite de tests Sauce Labs est configurée comme travail de test dans {{site.data.keyword.deliverypipeline}}, cette suite de tests peut exécuter des tests en fonction de votre application Web ou mobile dans le cadre de votre processus de distribution continue. Ces tests peuvent fournir un contrôle de flux de valeur pour vos projets, agissant comme des barrières pour empêcher le déploiement de code incorrect. + +Configurez Sauce Labs pour l'exécution de tests fonctionnels automatisés sur plusieurs systèmes d'exploitation et navigateurs afin de pouvoir émuler la façon dont un utilisateur peut utiliser un site Web ou une application : + +1. Si vous configurez cette intégration d'outil lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur **Sauce Labs**. +1. Si vous disposez d'une chaîne d'outils et que vous y +ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, +page **Chaînes d'outils**, cliquez sur la chaîne +d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Cliquez sur le bouton d'ajout (+). +1. A la section Intégrations d'outils, cliquez sur **Sauce Labs**. +1. Entrez le nom d'utilisateur associé à votre compte Sauce Labs. Vous pouvez [trouver votre nom d'utilisateur dans le message d’accueil, en haut de la page de votre compte Sauce Labs (Lien s'ouvrant dans une nouvelle fenêtre)](https://saucelabs.com/account){: new_window}. +1. Entrez la clé d'accès de votre compte Sauce Labs. Vous pouvez [trouver la clé sur la page de votre compte Sauce Labs (Lien s'ouvrant dans une nouvelle fenêtre)](https://saucelabs.com/account){: new_window}. +1. Cliquez sur **Créer une intégration**. +1. Cliquez sur la vignette Sauce Labs pour accéder à saucelabs.com et afficher l'activité de test pour la chaîne d'outils. + + **Conseil **: Si vous avez ajouté un travail de test Sauce Labs à {{site.data.keyword.deliverypipeline}}, vous pouvez sélectionner l'instance de service. + +Pour en savoir plus, voir [Sauce Labs (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}. + + +## Configuration de Slack +{: #slack} + +**Important **: Les notifications postées sur des canaux Slack publics sont visibles de tout membre de l'équipe. N'oubliez pas que vous êtes responsable du contenu de vos articles. + +Slack est un système de messagerie et de notification en temps réel, basé sur le cloud. Slack fournit un système de discussion permanente, alternative plus interactive au courrier électronique pour la collaboration des équipes. Vous pouvez communiquer avec votre équipe sur un canal dédié ou sur un ensemble de canaux directement liés à votre travail. Vous pouvez également partager des fichiers et des images via ces canaux, ou dans des messages directs entre deux personnes ou plus. Les communications dans les messages directs ou sur les canaux sont conservées pour que vous puissiez y faire des recherches. + +Configurez Slack pour la réception de notifications concernant votre chaîne d'outils depuis les intégrations d'outils, par exemple les activités de test et de déploiement : + +1. Si vous configurez cette intégration d'outil lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur **Slack**. +1. Si vous disposez d'une chaîne d'outils et que vous y +ajoutez cette intégration d'outil, depuis le tableau de bord DevOps, +page **Chaînes d'outils**, cliquez sur la chaîne +d'outils pour ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Cliquez sur le bouton d'ajout (+). +1. A la section Intégrations d'outils, cliquez sur **Slack**. +1. Entrez le jeton d'authentification d'API pour votre compte Slack. Vous devez utiliser un jeton d'accès complet généré pour l'authentification avec Slack. Pour des instructions de recherche du jeton, voir [Slack authentication (Lien s'ouvrant dans une nouvelle fenêtre)](https://api.slack.com/web#authentication){: new_window}. +1. Entrez le nom du canal Slack sur lequel vous souhaitez recevoir les notifications. Si le canal spécifié n'existe pas, il est créé. Si le canal a été archivé, il est réactivé. +1. Cliquez sur **Créer une intégration**. +1. Cliquez sur la vignette Slack. Vous pouvez afficher toutes les activités de votre chaîne d'outils dans le canal Slack configuré. + +Pour en savoir plus, voir [Slack (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}. + + + + + + + + diff --git a/toolchains/nl/fr/toolchains_overview.md b/toolchains/nl/fr/toolchains_overview.md index e89745780..fbb046ecc 100644 --- a/toolchains/nl/fr/toolchains_overview.md +++ b/toolchains/nl/fr/toolchains_overview.md @@ -1,168 +1,168 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Initiation aux chaînes d'outils (Bêta) -{: #toolchains_getting_started} - -Dernière mise à jour : 7 octobre 2016 -{: .last-updated} - -Les chaînes d'outils sont disponibles dans les environnements {{site.data.keyword.Bluemix}} public et dédié. Vous pouvez créer une chaîne d'outils de deux façons : à l'aide d'un modèle ou à partir d'une application. Sur {{site.data.keyword.Bluemix_notm}} public, les chaînes d'outils sont disponibles uniquement dans la région sud des Etats-Unis. -{: shortdesc} - -##Initiation aux chaînes d'outils : public -{: #getting_started_public} - -**Remarque :** Assurez-vous de travailler dans le nouvel environnement Bluemix en vérifiant la bannière supérieure. - - * Si vous voyez un message relatif à l'essai du nouveau Bluemix, vous êtes dans l'environnement Bluemix classique. Cliquez sur le lien pour accéder au nouvel environnement Bluemix. - * Si vous ne voyez pas ce message, vous êtes bien déjà dans le nouvel environnement Bluemix. - -Chaque chaîne d'outils est associée à une organisation spécifique (org) et tout membre de cette organisation peut accéder aux chaînes d'outils associées. Avant de créer une chaîne d'outils, assurez-vous de travailler dans l'organisation dans laquelle vous voulez créer la chaîne d'outils. L'organisation au sein de laquelle vous travaillez actuellement s'affiche dans la barre de menus. Pour passer à une autre organisation, cliquez sur l'organisation dans la barre de menus, puis sélectionnez l'organisation souhaitée. - -###Création d'une chaîne d'outils à partir d'un modèle -{: #creating_a_toolchain_from_a_template} - -Vous pouvez utiliser un modèle comme point de départ pour créer une chaîne d'outils incluant un ensemble spécifique d'intégrations d'outils. - -1. Si vous créez votre première chaîne d'outils, assurez-vous que les chaînes d'outils sont activées dans votre organisation : - 1. Ouvrez le tableau de bord DevOps et cliquez sur la page **Chaînes d'outils**. - 2. Si le bouton **Activer les chaînes d'outils** est affiché, cliquez dessus et suivez les invites pour créer votre chaîne d'outils. - 3. Si le bouton **Activer les chaînes d'outils** n'est pas affiché, les chaînes d'outils sont déjà activées. Passez à l'étape 2. -1. Dans le tableau de bord DevOps, page **Chaînes d'outils**, cliquez sur le bouton d'ajout (+) pour créer une chaîne d'outils. -1. Cliquez sur un modèle de chaîne d'outils. Ainsi, pour utiliser un exemple de magasin en ligne, cliquez sur **Chaîne d'outils de microservices**. -1. Sur la page de création de chaîne d'outils, passez en revue le diagramme de la chaîne d'outils que vous allez créer. Ce diagramme montre chaque intégration d'outil dans sa phase de cycle de vie au sein de la chaîne d'outils. L'image suivante fournit un exemple de diagramme. Lorsque vous créez une chaîne d'outils, le diagramme représente chaque intégration d'outil faisant partie de la chaîne d'outils. -![Diagramme de chaîne d'outils](images/toolchain_diagram.png) - -1. Passez en revue les informations par défaut des paramètres de chaîne d'outils. Le nom de la chaîne d'outils l'identifie dans {{site.data.keyword.Bluemix_notm}}. Si vous disposez déjà d'une chaîne d'outils portant ce nom, ou si vous souhaitez utiliser un nom différent, changez le nom de la chaîne d'outils. -1. A la section Intégrations configurables, sélectionnez chaque intégration d'outil à configurer pour votre chaîne d'outils. Certaines intégrations d'outils ne nécessitent pas de configuration. Pour des informations sur la configuration des intégrations d'outils, voir [Configuration des intégrations d'outils (Lien s'ouvrant dans une nouvelle fenêtre)](../toolchains/toolchains_integrations.html){: new_window}. -1. Cliquez sur **Créer**. Plusieurs étapes s'exécutent automatiquement pour configurer votre chaîne d'outils. - - * La chaîne d'outils est créée. - * Si vous avez configuré l'intégration d'outil Delivery Pipeline, les pipelines sont déclenchés. - * Si vous avez configuré l'intégration d'outil Sauce Labs, l'intégration de Sauce Labs est configurée pour ajouter des travaux aux pipelines et exécuter des tests. - * Si vous avez configuré l'intégration d'outil PagerDuty, l'intégration de PagerDuty est configurée pour envoyer des notifications au canal configuré dans Slack. Ces notifications signalent quand un problème survient. - * Si vous avez configuré l'intégration d'outil Slack, l'intégration de Slack est configurée pour envoyer des notifications au canal configuré dans Slack. Ces notifications indiquent la progression du déploiement, par exemple `Connected with Project XYZ` (connecté au projet xyz), `Pipeline Configured` (pipeline configuré) ou `Stage 'build' started` (étape de génération lancée). - * Si vous avez configuré l'intégration d'outil GitHub, le référentiel exemple GitHub est cloné dans votre compte GitHub. - - -###Création d'une chaîne d'outils à partir d'une application -{: #creating_a_toolchain_from_an_app} - -Vous pouvez créer une chaîne d'outils à partir de votre application. La chaîne d'outils peut prendre en charge le développement, le déploiement, la surveillance, etc. en continu, et elle est associée à votre application. Chaque application peut être associée à une chaîne d'outils. Lorsque vous envoyez des modifications au référentiel GitHub de la chaîne d'outils, le pipeline génère et déploie automatiquement l'application. - -1. Si vous créez votre première chaîne d'outils, assurez-vous que les chaînes d'outils sont activées dans votre organisation : - 1. Ouvrez le tableau de bord DevOps et cliquez sur la page -**Chaînes d'outils**. - 2. Si le bouton **Activer les chaînes d'outils** est affiché, cliquez dessus et suivez les invites pour créer votre chaîne d'outils. - 3. Si le bouton **Activer les chaînes d'outils** n'est pas affiché, les chaînes d'outils sont déjà activées. Passez à l'étape 2. -1. Depuis la page de présentation de votre application, -vignette de distribution continue, cliquez sur **Activer**. Vous pouvez également, dans {{site.data.keyword.Bluemix_notm}} Classic Experience, coin supérieur droit de la page de présentation de votre application, cliquer sur **Ajouter une chaîne d'outils**. Votre application est configurée pour la distribution continue depuis un nouveau référentiel GitHub rempli avec le code de démarrage d'application. -1. Sur la page de création de chaîne d'outils, passez en revue le diagramme de la chaîne d'outils que vous allez créer. Ce diagramme montre chaque intégration d'outil dans sa phase de cycle de vie au sein de la chaîne d'outils. -1. Passez en revue les informations par défaut des paramètres de chaîne d'outils. Le nom de la chaîne d'outils l'identifie dans {{site.data.keyword.Bluemix_notm}}. Si vous disposez déjà d'une chaîne d'outils portant ce nom, ou si vous souhaitez utiliser un nom différent, changez le nom de la chaîne d'outils. -1. A la section Intégrations configurables, sélectionnez chaque intégration d'outil à configurer pour votre chaîne d'outils. Certaines intégrations d'outils ne nécessitent pas de configuration .Pour des informations sur la configuration des intégrations d'outils, voir [Configuration des intégrations d'outils (Lien s'ouvrant dans une nouvelle fenêtre)](../toolchains/toolchains_integrations.html){: new_window}. -1. Cliquez sur **Créer**. Plusieurs étapes s'exécutent automatiquement pour configurer votre chaîne d'outils. - - * La chaîne d'outils est créée. - * Si vous avez configuré l'intégration d'outil Delivery Pipeline, les pipelines sont déclenchés. - * Si vous avez configuré l'intégration d'outil Sauce Labs, l'intégration de Sauce Labs est configurée pour ajouter des travaux aux pipelines et exécuter des tests. - * Si vous avez configuré l'intégration d'outil PagerDuty, l'intégration de PagerDuty est configurée pour envoyer des notifications au canal configuré dans Slack. Ces notifications signalent quand un problème survient. - * Si vous avez configuré l'intégration d'outil Slack, l'intégration de Slack est configurée pour envoyer des notifications au canal configuré dans Slack. Ces notifications indiquent la progression du déploiement, par exemple `Connected with Project XYZ` (connecté au projet xyz), `Pipeline Configured` (pipeline configuré) ou `Stage 'build' started` (étape de génération lancée). - * Si vous avez configuré l'intégration d'outil GitHub, le référentiel exemple GitHub est cloné dans votre compte GitHub. - - -##Initiation aux chaînes d'outils : dédié -{: #getting_started_dedicated} - -Chaque chaîne d'outils est associée à une organisation spécifique (org) et tout membre de cette organisation peut accéder aux chaînes d'outils associées. Avant de créer une chaîne d'outils, cliquez sur l'icône **{{site.data.keyword.avatar}}** ![icône Avatar](../icons/i-avatar-icon.svg) dans la barre de menus pour ouvrir le widget Compte et support et afficher l'organisation dans laquelle vous travaillez. Si cette organisation n'est pas celle dans laquelle vous voulez créer la chaîne d'outils, passez à une autre organisation. - -###Création d'une chaîne d'outils à partir d'un modèle -{: #creating_a_toolchain_from_a_template_dedicated} - -Vous pouvez utiliser un modèle comme point de départ pour créer une chaîne d'outils incluant un ensemble spécifique d'intégrations d'outils. - -1. Si vous créez votre première chaîne d'outils, assurez-vous que les chaînes d'outils sont activées dans votre organisation : - 1. Ouvrez le tableau de bord DevOps et cliquez sur l'onglet **Chaînes d'outils**. - 2. Si le bouton **Activer les chaînes d'outils** est affiché, cliquez dessus et suivez les invites pour créer votre chaîne d'outils. - 3. Si le bouton **Activer les chaînes d'outils** n'est pas affiché, les chaînes d'outils sont déjà activées. Passez à l'étape 2. -1. Dans le tableau de bord {{site.data.keyword.Bluemix_notm}}, onglet **DEVOPS**, cliquez sur le bouton d'ajout (+) pour créer une chaîne d'outils. -1. Cliquez sur un modèle de chaîne d'outils. Par exemple, pour créer une chaîne d'outils simple à déployer sur une nouvelle application Cloud Foundry, cliquez sur **Chaîne d'outils Cloud Foundry simple**. -1. Sur la page de création de chaîne d'outils, passez en revue le diagramme de la chaîne d'outils que vous allez créer. Ce diagramme montre chaque intégration d'outil dans sa phase de cycle de vie au sein de la chaîne d'outils. L'image suivante fournit un exemple de diagramme. Lorsque vous créez une chaîne d'outils, le diagramme représente chaque intégration d'outil faisant partie de la chaîne d'outils. -![Diagramme des chaînes d'outils dédiées](images/toolchain_dedicated_diagram.png) - -1. Passez en revue les informations par défaut des paramètres de chaîne d'outils. Le nom de la chaîne d'outils l'identifie dans {{site.data.keyword.Bluemix_notm}}. Si vous disposez déjà d'une chaîne d'outils portant ce nom, ou si vous souhaitez utiliser un nom différent, changez le nom de la chaîne d'outils. -1. A la section Intégrations configurables, sélectionnez chaque intégration d'outil à configurer pour votre chaîne d'outils. Certaines intégrations d'outils ne nécessitent pas de configuration. -Pour des informations sur la configuration des intégrations d'outils, -voir -[Configuration -des intégrations d'outils (Lien s'ouvrant dans une nouvelle -fenêtre)](../toolchains/toolchains_integrations.html){: new_window}. -1. Cliquez sur **Créer**. Plusieurs étapes s'exécutent automatiquement pour configurer votre chaîne d'outils. - - * La chaîne d'outils est créée. - * Si vous avez configuré l'intégration d'outil Delivery Pipeline, les pipelines sont déclenchés. - * Si vous avez configuré l'intégration d'outil GitHub Enterprise, le référentiel exemple GitHub Enterprise est cloné dans votre compte GitHub Enterprise. - - -###Création d'une chaîne d'outils à partir d'une application -{: #creating_a_toolchain_from_an_app_dedicated} - -Vous pouvez créer une chaîne d'outils à partir de votre application. La chaîne d'outils peut prendre en charge le développement, le déploiement, la surveillance, etc. en continu, et elle est associée à votre application. Chaque application peut être associée à une chaîne d'outils. Lorsque vous envoyez des modifications au référentiel GitHub Enterprise de la chaîne d'outils, le pipeline génère et déploie automatiquement l'application. - -1. Si vous créez votre première chaîne d'outils, assurez-vous que les chaînes d'outils sont activées dans votre organisation : - 1. Ouvrez le tableau de bord DevOps et cliquez sur l'onglet **Chaînes d'outils**. - 2. Si le bouton **Activer les chaînes d'outils** est affiché, cliquez dessus et suivez les invites pour créer votre chaîne d'outils. - 3. Si le bouton **Activer les chaînes d'outils** n'est pas affiché, les chaînes d'outils sont déjà activées. Passez à l'étape 2. -1. Dans le coin supérieur droit de la page de présentation de votre application, cliquez sur **Ajouter une chaîne d'outils**. Votre application est configurée pour la distribution continue depuis un nouveau référentiel GitHub Enterprise rempli avec le code de démarrage d'application. -1. Sur la page de création de chaîne d'outils, passez en revue le diagramme de la chaîne d'outils que vous allez créer. Ce diagramme montre chaque intégration d'outil dans sa phase de cycle de vie au sein de la chaîne d'outils. -1. Passez en revue les informations par défaut des paramètres de chaîne d'outils. Le nom de la chaîne d'outils l'identifie dans {{site.data.keyword.Bluemix_notm}}. Si vous disposez déjà d'une chaîne d'outils portant ce nom, ou si vous souhaitez utiliser un nom différent, changez le nom de la chaîne d'outils. -1. A la section Intégrations configurables, sélectionnez chaque intégration d'outil à configurer pour votre chaîne d'outils. Certaines intégrations d'outils ne nécessitent pas de configuration. Pour des informations sur la configuration des intégrations d'outils, voir [Configuration des intégrations d'outils (Lien s'ouvrant dans une nouvelle fenêtre)](../toolchains/toolchains_integrations.html){: new_window}. -1. Cliquez sur **Créer**. Plusieurs étapes s'exécutent automatiquement pour configurer votre chaîne d'outils. - - * La chaîne d'outils est créée. - * Si vous avez configuré l'intégration d'outil Delivery Pipeline, les pipelines sont déclenchés. - * Si vous avez configuré l'intégration d'outil GitHub Enterprise, le référentiel exemple GitHub Enterprise est cloné dans votre compte GitHub Enterprise. - - -##Affichage d'une chaîne d'outils -{: #viewing_a_toolchain} - -Une fois que vous avez configuré la chaîne d'outils et ses intégrations d'outils, vous pouvez afficher une représentation graphique de la chaîne d'outils sur la page Intégrations d'outils. - -* Si vous utilisez {{site.data.keyword.Bluemix_notm}} public, dans le tableau de bord DevOps, page **Chaînes d'outils**, cliquez sur une chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. - -* Si vous utilisez {{site.data.keyword.Bluemix_notm}} dédié, dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. - -* Pour accéder à une intégration d'outil de votre chaîne d'outils, cliquez sur la vignette de l'outil. - - **Conseil **: Si vous disposez de plusieurs référentiels GitHub ou GitHub Enterprise, plusieurs vignettes peuvent être disponibles pour une même intégration d'outil car chaque référentiel dispose de sa propre vignette. - - - - - -# Liens connexes -{: #rellinks} - -## Tutoriels et exemples -{: #samples} - -* -[Create an application with three microservices (Beta) (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} -* [Create a toolchain from a template on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} -* [Create a toolchain from an app on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} - -## Liens connexes -{: #general} - -* [Microservices toolchain (Beta) (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} -* [Simple toolchain (Beta) (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} -* [IBM Bluemix Garage Method (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method){:new_window} +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Initiation aux chaînes d'outils (Bêta) +{: #toolchains_getting_started} + +Dernière mise à jour : 7 octobre 2016 +{: .last-updated} + +Les chaînes d'outils sont disponibles dans les environnements {{site.data.keyword.Bluemix}} public et dédié. Vous pouvez créer une chaîne d'outils de deux façons : à l'aide d'un modèle ou à partir d'une application. Sur {{site.data.keyword.Bluemix_notm}} public, les chaînes d'outils sont disponibles uniquement dans la région sud des Etats-Unis. +{: shortdesc} + +## Initiation aux chaînes d'outils : public +{: #getting_started_public} + +**Remarque :** Assurez-vous de travailler dans le nouvel environnement Bluemix en vérifiant la bannière supérieure. + + * Si vous voyez un message relatif à l'essai du nouveau Bluemix, vous êtes dans l'environnement Bluemix classique. Cliquez sur le lien pour accéder au nouvel environnement Bluemix. + * Si vous ne voyez pas ce message, vous êtes bien déjà dans le nouvel environnement Bluemix. + +Chaque chaîne d'outils est associée à une organisation spécifique (org) et tout membre de cette organisation peut accéder aux chaînes d'outils associées. Avant de créer une chaîne d'outils, assurez-vous de travailler dans l'organisation dans laquelle vous voulez créer la chaîne d'outils. L'organisation au sein de laquelle vous travaillez actuellement s'affiche dans la barre de menus. Pour passer à une autre organisation, cliquez sur l'organisation dans la barre de menus, puis sélectionnez l'organisation souhaitée. + +### Création d'une chaîne d'outils à partir d'un modèle +{: #creating_a_toolchain_from_a_template} + +Vous pouvez utiliser un modèle comme point de départ pour créer une chaîne d'outils incluant un ensemble spécifique d'intégrations d'outils. + +1. Si vous créez votre première chaîne d'outils, assurez-vous que les chaînes d'outils sont activées dans votre organisation : + 1. Ouvrez le tableau de bord DevOps et cliquez sur la page **Chaînes d'outils**. + 2. Si le bouton **Activer les chaînes d'outils** est affiché, cliquez dessus et suivez les invites pour créer votre chaîne d'outils. + 3. Si le bouton **Activer les chaînes d'outils** n'est pas affiché, les chaînes d'outils sont déjà activées. Passez à l'étape 2. +1. Dans le tableau de bord DevOps, page **Chaînes d'outils**, cliquez sur le bouton d'ajout (+) pour créer une chaîne d'outils. +1. Cliquez sur un modèle de chaîne d'outils. Ainsi, pour utiliser un exemple de magasin en ligne, cliquez sur **Chaîne d'outils de microservices**. +1. Sur la page de création de chaîne d'outils, passez en revue le diagramme de la chaîne d'outils que vous allez créer. Ce diagramme montre chaque intégration d'outil dans sa phase de cycle de vie au sein de la chaîne d'outils. L'image suivante fournit un exemple de diagramme. Lorsque vous créez une chaîne d'outils, le diagramme représente chaque intégration d'outil faisant partie de la chaîne d'outils. +![Diagramme de chaîne d'outils](images/toolchain_diagram.png) + +1. Passez en revue les informations par défaut des paramètres de chaîne d'outils. Le nom de la chaîne d'outils l'identifie dans {{site.data.keyword.Bluemix_notm}}. Si vous disposez déjà d'une chaîne d'outils portant ce nom, ou si vous souhaitez utiliser un nom différent, changez le nom de la chaîne d'outils. +1. A la section Intégrations configurables, sélectionnez chaque intégration d'outil à configurer pour votre chaîne d'outils. Certaines intégrations d'outils ne nécessitent pas de configuration. Pour des informations sur la configuration des intégrations d'outils, voir [Configuration des intégrations d'outils (Lien s'ouvrant dans une nouvelle fenêtre)](../toolchains/toolchains_integrations.html){: new_window}. +1. Cliquez sur **Créer**. Plusieurs étapes s'exécutent automatiquement pour configurer votre chaîne d'outils. + + * La chaîne d'outils est créée. + * Si vous avez configuré l'intégration d'outil Delivery Pipeline, les pipelines sont déclenchés. + * Si vous avez configuré l'intégration d'outil Sauce Labs, l'intégration de Sauce Labs est configurée pour ajouter des travaux aux pipelines et exécuter des tests. + * Si vous avez configuré l'intégration d'outil PagerDuty, l'intégration de PagerDuty est configurée pour envoyer des notifications au canal configuré dans Slack. Ces notifications signalent quand un problème survient. + * Si vous avez configuré l'intégration d'outil Slack, l'intégration de Slack est configurée pour envoyer des notifications au canal configuré dans Slack. Ces notifications indiquent la progression du déploiement, par exemple `Connected with Project XYZ` (connecté au projet xyz), `Pipeline Configured` (pipeline configuré) ou `Stage 'build' started` (étape de génération lancée). + * Si vous avez configuré l'intégration d'outil GitHub, le référentiel exemple GitHub est cloné dans votre compte GitHub. + + +### Création d'une chaîne d'outils à partir d'une application +{: #creating_a_toolchain_from_an_app} + +Vous pouvez créer une chaîne d'outils à partir de votre application. La chaîne d'outils peut prendre en charge le développement, le déploiement, la surveillance, etc. en continu, et elle est associée à votre application. Chaque application peut être associée à une chaîne d'outils. Lorsque vous envoyez des modifications au référentiel GitHub de la chaîne d'outils, le pipeline génère et déploie automatiquement l'application. + +1. Si vous créez votre première chaîne d'outils, assurez-vous que les chaînes d'outils sont activées dans votre organisation : + 1. Ouvrez le tableau de bord DevOps et cliquez sur la page +**Chaînes d'outils**. + 2. Si le bouton **Activer les chaînes d'outils** est affiché, cliquez dessus et suivez les invites pour créer votre chaîne d'outils. + 3. Si le bouton **Activer les chaînes d'outils** n'est pas affiché, les chaînes d'outils sont déjà activées. Passez à l'étape 2. +1. Depuis la page de présentation de votre application, +vignette de distribution continue, cliquez sur **Activer**. Vous pouvez également, dans {{site.data.keyword.Bluemix_notm}} Classic Experience, coin supérieur droit de la page de présentation de votre application, cliquer sur **Ajouter une chaîne d'outils**. Votre application est configurée pour la distribution continue depuis un nouveau référentiel GitHub rempli avec le code de démarrage d'application. +1. Sur la page de création de chaîne d'outils, passez en revue le diagramme de la chaîne d'outils que vous allez créer. Ce diagramme montre chaque intégration d'outil dans sa phase de cycle de vie au sein de la chaîne d'outils. +1. Passez en revue les informations par défaut des paramètres de chaîne d'outils. Le nom de la chaîne d'outils l'identifie dans {{site.data.keyword.Bluemix_notm}}. Si vous disposez déjà d'une chaîne d'outils portant ce nom, ou si vous souhaitez utiliser un nom différent, changez le nom de la chaîne d'outils. +1. A la section Intégrations configurables, sélectionnez chaque intégration d'outil à configurer pour votre chaîne d'outils. Certaines intégrations d'outils ne nécessitent pas de configuration .Pour des informations sur la configuration des intégrations d'outils, voir [Configuration des intégrations d'outils (Lien s'ouvrant dans une nouvelle fenêtre)](../toolchains/toolchains_integrations.html){: new_window}. +1. Cliquez sur **Créer**. Plusieurs étapes s'exécutent automatiquement pour configurer votre chaîne d'outils. + + * La chaîne d'outils est créée. + * Si vous avez configuré l'intégration d'outil Delivery Pipeline, les pipelines sont déclenchés. + * Si vous avez configuré l'intégration d'outil Sauce Labs, l'intégration de Sauce Labs est configurée pour ajouter des travaux aux pipelines et exécuter des tests. + * Si vous avez configuré l'intégration d'outil PagerDuty, l'intégration de PagerDuty est configurée pour envoyer des notifications au canal configuré dans Slack. Ces notifications signalent quand un problème survient. + * Si vous avez configuré l'intégration d'outil Slack, l'intégration de Slack est configurée pour envoyer des notifications au canal configuré dans Slack. Ces notifications indiquent la progression du déploiement, par exemple `Connected with Project XYZ` (connecté au projet xyz), `Pipeline Configured` (pipeline configuré) ou `Stage 'build' started` (étape de génération lancée). + * Si vous avez configuré l'intégration d'outil GitHub, le référentiel exemple GitHub est cloné dans votre compte GitHub. + + +## Initiation aux chaînes d'outils : dédié +{: #getting_started_dedicated} + +Chaque chaîne d'outils est associée à une organisation spécifique (org) et tout membre de cette organisation peut accéder aux chaînes d'outils associées. Avant de créer une chaîne d'outils, cliquez sur l'icône **{{site.data.keyword.avatar}}** ![icône Avatar](../icons/i-avatar-icon.svg) dans la barre de menus pour ouvrir le widget Compte et support et afficher l'organisation dans laquelle vous travaillez. Si cette organisation n'est pas celle dans laquelle vous voulez créer la chaîne d'outils, passez à une autre organisation. + +### Création d'une chaîne d'outils à partir d'un modèle +{: #creating_a_toolchain_from_a_template_dedicated} + +Vous pouvez utiliser un modèle comme point de départ pour créer une chaîne d'outils incluant un ensemble spécifique d'intégrations d'outils. + +1. Si vous créez votre première chaîne d'outils, assurez-vous que les chaînes d'outils sont activées dans votre organisation : + 1. Ouvrez le tableau de bord DevOps et cliquez sur l'onglet **Chaînes d'outils**. + 2. Si le bouton **Activer les chaînes d'outils** est affiché, cliquez dessus et suivez les invites pour créer votre chaîne d'outils. + 3. Si le bouton **Activer les chaînes d'outils** n'est pas affiché, les chaînes d'outils sont déjà activées. Passez à l'étape 2. +1. Dans le tableau de bord {{site.data.keyword.Bluemix_notm}}, onglet **DEVOPS**, cliquez sur le bouton d'ajout (+) pour créer une chaîne d'outils. +1. Cliquez sur un modèle de chaîne d'outils. Par exemple, pour créer une chaîne d'outils simple à déployer sur une nouvelle application Cloud Foundry, cliquez sur **Chaîne d'outils Cloud Foundry simple**. +1. Sur la page de création de chaîne d'outils, passez en revue le diagramme de la chaîne d'outils que vous allez créer. Ce diagramme montre chaque intégration d'outil dans sa phase de cycle de vie au sein de la chaîne d'outils. L'image suivante fournit un exemple de diagramme. Lorsque vous créez une chaîne d'outils, le diagramme représente chaque intégration d'outil faisant partie de la chaîne d'outils. +![Diagramme des chaînes d'outils dédiées](images/toolchain_dedicated_diagram.png) + +1. Passez en revue les informations par défaut des paramètres de chaîne d'outils. Le nom de la chaîne d'outils l'identifie dans {{site.data.keyword.Bluemix_notm}}. Si vous disposez déjà d'une chaîne d'outils portant ce nom, ou si vous souhaitez utiliser un nom différent, changez le nom de la chaîne d'outils. +1. A la section Intégrations configurables, sélectionnez chaque intégration d'outil à configurer pour votre chaîne d'outils. Certaines intégrations d'outils ne nécessitent pas de configuration. +Pour des informations sur la configuration des intégrations d'outils, +voir +[Configuration +des intégrations d'outils (Lien s'ouvrant dans une nouvelle +fenêtre)](../toolchains/toolchains_integrations.html){: new_window}. +1. Cliquez sur **Créer**. Plusieurs étapes s'exécutent automatiquement pour configurer votre chaîne d'outils. + + * La chaîne d'outils est créée. + * Si vous avez configuré l'intégration d'outil Delivery Pipeline, les pipelines sont déclenchés. + * Si vous avez configuré l'intégration d'outil GitHub Enterprise, le référentiel exemple GitHub Enterprise est cloné dans votre compte GitHub Enterprise. + + +### Création d'une chaîne d'outils à partir d'une application +{: #creating_a_toolchain_from_an_app_dedicated} + +Vous pouvez créer une chaîne d'outils à partir de votre application. La chaîne d'outils peut prendre en charge le développement, le déploiement, la surveillance, etc. en continu, et elle est associée à votre application. Chaque application peut être associée à une chaîne d'outils. Lorsque vous envoyez des modifications au référentiel GitHub Enterprise de la chaîne d'outils, le pipeline génère et déploie automatiquement l'application. + +1. Si vous créez votre première chaîne d'outils, assurez-vous que les chaînes d'outils sont activées dans votre organisation : + 1. Ouvrez le tableau de bord DevOps et cliquez sur l'onglet **Chaînes d'outils**. + 2. Si le bouton **Activer les chaînes d'outils** est affiché, cliquez dessus et suivez les invites pour créer votre chaîne d'outils. + 3. Si le bouton **Activer les chaînes d'outils** n'est pas affiché, les chaînes d'outils sont déjà activées. Passez à l'étape 2. +1. Dans le coin supérieur droit de la page de présentation de votre application, cliquez sur **Ajouter une chaîne d'outils**. Votre application est configurée pour la distribution continue depuis un nouveau référentiel GitHub Enterprise rempli avec le code de démarrage d'application. +1. Sur la page de création de chaîne d'outils, passez en revue le diagramme de la chaîne d'outils que vous allez créer. Ce diagramme montre chaque intégration d'outil dans sa phase de cycle de vie au sein de la chaîne d'outils. +1. Passez en revue les informations par défaut des paramètres de chaîne d'outils. Le nom de la chaîne d'outils l'identifie dans {{site.data.keyword.Bluemix_notm}}. Si vous disposez déjà d'une chaîne d'outils portant ce nom, ou si vous souhaitez utiliser un nom différent, changez le nom de la chaîne d'outils. +1. A la section Intégrations configurables, sélectionnez chaque intégration d'outil à configurer pour votre chaîne d'outils. Certaines intégrations d'outils ne nécessitent pas de configuration. Pour des informations sur la configuration des intégrations d'outils, voir [Configuration des intégrations d'outils (Lien s'ouvrant dans une nouvelle fenêtre)](../toolchains/toolchains_integrations.html){: new_window}. +1. Cliquez sur **Créer**. Plusieurs étapes s'exécutent automatiquement pour configurer votre chaîne d'outils. + + * La chaîne d'outils est créée. + * Si vous avez configuré l'intégration d'outil Delivery Pipeline, les pipelines sont déclenchés. + * Si vous avez configuré l'intégration d'outil GitHub Enterprise, le référentiel exemple GitHub Enterprise est cloné dans votre compte GitHub Enterprise. + + +## Affichage d'une chaîne d'outils +{: #viewing_a_toolchain} + +Une fois que vous avez configuré la chaîne d'outils et ses intégrations d'outils, vous pouvez afficher une représentation graphique de la chaîne d'outils sur la page Intégrations d'outils. + +* Si vous utilisez {{site.data.keyword.Bluemix_notm}} public, dans le tableau de bord DevOps, page **Chaînes d'outils**, cliquez sur une chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. + +* Si vous utilisez {{site.data.keyword.Bluemix_notm}} dédié, dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. + +* Pour accéder à une intégration d'outil de votre chaîne d'outils, cliquez sur la vignette de l'outil. + + **Conseil **: Si vous disposez de plusieurs référentiels GitHub ou GitHub Enterprise, plusieurs vignettes peuvent être disponibles pour une même intégration d'outil car chaque référentiel dispose de sa propre vignette. + + + + + +# Liens connexes +{: #rellinks} + +## Tutoriels et exemples +{: #samples} + +* +[Create an application with three microservices (Beta) (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} +* [Create a toolchain from a template on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} +* [Create a toolchain from an app on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} + +## Liens connexes +{: #general} + +* [Microservices toolchain (Beta) (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} +* [Simple toolchain (Beta) (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} +* [IBM Bluemix Garage Method (Lien s'ouvrant dans une nouvelle fenêtre)](https://www.ibm.com/devops/method){:new_window} diff --git a/toolchains/nl/fr/toolchains_using.md b/toolchains/nl/fr/toolchains_using.md index 1356f2dce..c4efc333b 100644 --- a/toolchains/nl/fr/toolchains_using.md +++ b/toolchains/nl/fr/toolchains_using.md @@ -1,100 +1,100 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Utilisation de chaînes d'outils sur {{site.data.keyword.Bluemix_notm}} public -{: #toolchains-using} - -Dernière mise à jour : 7 octobre 2016 -{: .last-updated} - -Vous pouvez utiliser une chaîne d'outils pour améliorer la productivité de votre travail quotidien de développement, de déploiement et de vos opérations. Après avoir configuré une chaîne d'outils, vous pouvez ajouter, supprimer ou configurer des intégrations d'outils et gérer l'accès à la chaîne d'outils. -Les chaînes d'outils sont disponibles uniquement dans la région sud des Etats-Unis. -{: shortdesc} - -**Remarque** : Assurez-vous de travailler dans le nouvel environnement Bluemix en vérifiant la bannière supérieure. - - * Si vous voyez un message relatif à l'essai du nouveau Bluemix, vous êtes dans l'environnement Bluemix classique. Cliquez sur le lien pour accéder au nouvel environnement Bluemix. - * Si vous ne voyez pas ce message, vous êtes bien déjà dans le nouvel environnement Bluemix. - -## Configuration d'une intégration d'outil -{: #configuring_a_tool_integration} - -Si vous avez différé la configuration d'une intégration d'outil lors de la création d'une chaîne d'outils, un bouton **Configurer** s'affiche sur sa vignette. Si vous avez configuré une intégration d'outil à la création d'une chaîne d'outils, vous pouvez mettre à jour les paramètres de configuration. - -1. Dans le tableau de bord DevOps, sur la page **Chaînes d'outils**, cliquez sur une chaîne d'outils afin d'ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils** puis sur **Intégrations d'outils**. -1. Si vous devez configurer une intégration d'outil pour la première fois, depuis sa vignette, cliquez sur **Configurer**. - - ![Bouton Configurer](images/toolchain_tile_configure.png) - - Lorsque vous avez terminé la configuration de l'intégration d'outil, cliquez sur **Sauvegarder l'intégration**. - -1. Si vous devez mettre à jour la configuration d'une intégration d'outil, depuis sa vignette, cliquez sur le menu pour accéder aux options de configuration. - - ![Menu Configuration](images/toolchain_tile_menu.png) - - Lorsque vous avez terminé la mis à jour des paramètres, cliquez sur **Sauvegarder l'intégration**. - -## Ajout d'une intégration d'outil -{: #adding_a_tool_integration} - -Vous pouvez ajouter et configurer des intégrations d'outils pour votre chaîne d'outils. - -1. Dans le tableau de bord DevOps, sur la page **Chaînes d'outils**, cliquez sur une chaîne d'outils afin d'ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils** puis sur **Intégrations d'outils**. -1. Pour afficher la liste des intégrations d'outils à ajouter, cliquez sur le bouton d'ajout (+). -1. Cliquez sur une intégration d'outil à ajouter. -1. Entrez les informations requises pour configurer l'intégration d'outil. -1. Cliquez sur **Créer une intégration** pour ajouter l'intégration d'outil à votre chaîne d'outils. - -## Suppression d'une intégration d'outil -{: #deleting_a_tool_integration} - -Si vous supprimez une intégration d'outil de votre chaîne d'outils, la suppression est irréversible. - -1. Dans le tableau de bord DevOps, sur la page **Chaînes d'outils**, cliquez sur une chaîne d'outils afin d'ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils** puis sur **Intégrations d'outils**. -1. Sur la vignette de l'intégration d'outil à supprimer, cliquez sur le menu pour accéder aux options de configuration. -1. Pour supprimer l'intégration d'outil de votre chaîne d'outils, cliquez sur **Supprimer**. -1. Confirmez en cliquant sur **Supprimer**. - -## Gestion des accès -{: #managing_access} - -Vous pouvez accorder l'accès à une chaîne d'outils à des utilisateurs en les ajoutant à l'organisation (org) à laquelle la chaîne d'outils est associée. Chaque chaîne d'outils est associée à une organisation spécifique, et tout membre de cette organisation peut accéder aux chaînes d'outils associées. -L'organisation au sein de laquelle vous travaillez actuellement s'affiche dans la barre de menus. Cliquez sur l'organisation et changez d'organisation pour accéder -à un ensemble différent de chaînes d'outils. - - - - - -1. Dans le tableau de bord DevOps, sur la page **Chaînes d'outils**, cliquez sur la chaîne d'outils à gérer puis cliquez sur **Gérer**. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils** puis sur **Gérer**. -1. Cliquez sur le lien de votre organisation. -1. Dans la page de gestion des organisations, cliquez sur **Inviter un utilisateur** et entrez l'adresse électronique de l'utilisateur. -1. Si vous souhaitez donner des droits avancés à des responsables {{site.data.keyword.Bluemix_notm}} d'organisations, sélectionnez une ou plusieurs des cases à cocher **Responsable**, **Responsable de la facturation** et **Auditeur**. -1. Cliquez sur **INVITER**. -1. Cliquez sur **SAUVEGARDER**. - -## Suppression d'une chaîne d'outils -{: #deleting_a_toolchain} - -Vous pouvez supprimer une chaîne d'outils et spécifier les intégrations d'outils associées à supprimer. Lorsque vous supprimez une chaîne d'outils, la suppression est irréversible. - -1. Dans le tableau de bord DevOps, sur la page **Chaînes d'outils**, cliquez sur la chaîne d'outils à supprimer puis cliquez sur **Gérer**. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils** puis sur **Gérer**. -1. Cliquez sur **Supprimer la chaîne d'outils**, examinez et modifiez éventuellement la liste des intégrations d'outils à supprimer. -1. Confirmez la suppression en entrant le nom de la chaîne d'outils et en cliquant sur **Supprimer**. - - **Conseil **: Lorsque vous supprimer une intégration d'outil GitHub, le référentiel GitHub associé n'est pas supprimé de GitHub. Vous devez supprimer manuellement le référentiel depuis GitHub. +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Utilisation de chaînes d'outils sur {{site.data.keyword.Bluemix_notm}} public +{: #toolchains-using} + +Dernière mise à jour : 7 octobre 2016 +{: .last-updated} + +Vous pouvez utiliser une chaîne d'outils pour améliorer la productivité de votre travail quotidien de développement, de déploiement et de vos opérations. Après avoir configuré une chaîne d'outils, vous pouvez ajouter, supprimer ou configurer des intégrations d'outils et gérer l'accès à la chaîne d'outils. +Les chaînes d'outils sont disponibles uniquement dans la région sud des Etats-Unis. +{: shortdesc} + +**Remarque** : Assurez-vous de travailler dans le nouvel environnement Bluemix en vérifiant la bannière supérieure. + + * Si vous voyez un message relatif à l'essai du nouveau Bluemix, vous êtes dans l'environnement Bluemix classique. Cliquez sur le lien pour accéder au nouvel environnement Bluemix. + * Si vous ne voyez pas ce message, vous êtes bien déjà dans le nouvel environnement Bluemix. + +## Configuration d'une intégration d'outil +{: #configuring_a_tool_integration} + +Si vous avez différé la configuration d'une intégration d'outil lors de la création d'une chaîne d'outils, un bouton **Configurer** s'affiche sur sa vignette. Si vous avez configuré une intégration d'outil à la création d'une chaîne d'outils, vous pouvez mettre à jour les paramètres de configuration. + +1. Dans le tableau de bord DevOps, sur la page **Chaînes d'outils**, cliquez sur une chaîne d'outils afin d'ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils** puis sur **Intégrations d'outils**. +1. Si vous devez configurer une intégration d'outil pour la première fois, depuis sa vignette, cliquez sur **Configurer**. + + ![Bouton Configurer](images/toolchain_tile_configure.png) + + Lorsque vous avez terminé la configuration de l'intégration d'outil, cliquez sur **Sauvegarder l'intégration**. + +1. Si vous devez mettre à jour la configuration d'une intégration d'outil, depuis sa vignette, cliquez sur le menu pour accéder aux options de configuration. + + ![Menu Configuration](images/toolchain_tile_menu.png) + + Lorsque vous avez terminé la mis à jour des paramètres, cliquez sur **Sauvegarder l'intégration**. + +## Ajout d'une intégration d'outil +{: #adding_a_tool_integration} + +Vous pouvez ajouter et configurer des intégrations d'outils pour votre chaîne d'outils. + +1. Dans le tableau de bord DevOps, sur la page **Chaînes d'outils**, cliquez sur une chaîne d'outils afin d'ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils** puis sur **Intégrations d'outils**. +1. Pour afficher la liste des intégrations d'outils à ajouter, cliquez sur le bouton d'ajout (+). +1. Cliquez sur une intégration d'outil à ajouter. +1. Entrez les informations requises pour configurer l'intégration d'outil. +1. Cliquez sur **Créer une intégration** pour ajouter l'intégration d'outil à votre chaîne d'outils. + +## Suppression d'une intégration d'outil +{: #deleting_a_tool_integration} + +Si vous supprimez une intégration d'outil de votre chaîne d'outils, la suppression est irréversible. + +1. Dans le tableau de bord DevOps, sur la page **Chaînes d'outils**, cliquez sur une chaîne d'outils afin d'ouvrir sa page Intégrations d'outils. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils** puis sur **Intégrations d'outils**. +1. Sur la vignette de l'intégration d'outil à supprimer, cliquez sur le menu pour accéder aux options de configuration. +1. Pour supprimer l'intégration d'outil de votre chaîne d'outils, cliquez sur **Supprimer**. +1. Confirmez en cliquant sur **Supprimer**. + +## Gestion des accès +{: #managing_access} + +Vous pouvez accorder l'accès à une chaîne d'outils à des utilisateurs en les ajoutant à l'organisation (org) à laquelle la chaîne d'outils est associée. Chaque chaîne d'outils est associée à une organisation spécifique, et tout membre de cette organisation peut accéder aux chaînes d'outils associées. +L'organisation au sein de laquelle vous travaillez actuellement s'affiche dans la barre de menus. Cliquez sur l'organisation et changez d'organisation pour accéder +à un ensemble différent de chaînes d'outils. + + + + + +1. Dans le tableau de bord DevOps, sur la page **Chaînes d'outils**, cliquez sur la chaîne d'outils à gérer puis cliquez sur **Gérer**. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils** puis sur **Gérer**. +1. Cliquez sur le lien de votre organisation. +1. Dans la page de gestion des organisations, cliquez sur **Inviter un utilisateur** et entrez l'adresse électronique de l'utilisateur. +1. Si vous souhaitez donner des droits avancés à des responsables {{site.data.keyword.Bluemix_notm}} d'organisations, sélectionnez une ou plusieurs des cases à cocher **Responsable**, **Responsable de la facturation** et **Auditeur**. +1. Cliquez sur **INVITER**. +1. Cliquez sur **SAUVEGARDER**. + +## Suppression d'une chaîne d'outils +{: #deleting_a_toolchain} + +Vous pouvez supprimer une chaîne d'outils et spécifier les intégrations d'outils associées à supprimer. Lorsque vous supprimez une chaîne d'outils, la suppression est irréversible. + +1. Dans le tableau de bord DevOps, sur la page **Chaînes d'outils**, cliquez sur la chaîne d'outils à supprimer puis cliquez sur **Gérer**. Vous pouvez également, depuis la page de présentation de l'application, vignette de distribution continue, cliquer sur **Afficher la chaîne d'outils** puis sur **Gérer**. +1. Cliquez sur **Supprimer la chaîne d'outils**, examinez et modifiez éventuellement la liste des intégrations d'outils à supprimer. +1. Confirmez la suppression en entrant le nom de la chaîne d'outils et en cliquant sur **Supprimer**. + + **Conseil **: Lorsque vous supprimer une intégration d'outil GitHub, le référentiel GitHub associé n'est pas supprimé de GitHub. Vous devez supprimer manuellement le référentiel depuis GitHub. diff --git a/toolchains/nl/fr/toolchains_using_dedicated.md b/toolchains/nl/fr/toolchains_using_dedicated.md index db2bad238..3c0d943ce 100644 --- a/toolchains/nl/fr/toolchains_using_dedicated.md +++ b/toolchains/nl/fr/toolchains_using_dedicated.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Utilisation de chaînes d'outils sur {{site.data.keyword.Bluemix_notm}} dédié -{: #toolchains-using_dedicated} - -Dernière mise à jour : 13 septembre 2016 -{: .last-updated} - -Vous pouvez utiliser une chaîne d'outils pour améliorer la productivité de votre travail quotidien de développement, de déploiement et de vos opérations. Après avoir configuré une chaîne d'outils, vous pouvez ajouter, supprimer ou configurer des intégrations d'outils et gérer l'accès à la chaîne d'outils. -{: shortdesc} - -## Configuration d'une intégration d'outil -{: #configuring_a_tool_integration_dedicated} - -Si vous avez différé la configuration d'une intégration d'outil lors de la création d'une chaîne d'outils, un bouton **Configurer** s'affiche sur sa vignette. Si vous avez configuré une intégration d'outil à la création d'une chaîne d'outils, vous pouvez mettre à jour les paramètres de configuration. - -1. Dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Si vous devez configurer une intégration d'outil pour la première fois, depuis sa vignette, cliquez sur **Configurer**. - - ![Bouton Configurer](images/toolchain_tile_configure.png) - - Lorsque vous avez terminé la configuration de l'intégration d'outil, cliquez sur **Sauvegarder l'intégration**. - -1. Si vous devez mettre à jour la configuration d'une intégration d'outil, depuis sa vignette, cliquez sur le menu pour accéder aux options de configuration. - - ![Menu Configuration](images/toolchain_tile_menu.png) - - Lorsque vous avez terminé la mis à jour des paramètres, cliquez sur **Sauvegarder l'intégration**. - -## Ajout d'une intégration d'outil -{: #adding_a_tool_integration_dedicated} - -Vous pouvez ajouter et configurer des intégrations d'outils pour votre chaîne d'outils. - -1. Dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Pour afficher la liste des intégrations d'outils à ajouter, cliquez sur le bouton d'ajout (+). -1. Cliquez sur l'intégration d'outil à ajouter. -1. Entrez les informations requises pour configurer l'intégration d'outil. -1. Cliquez sur **Créer une intégration** pour ajouter l'intégration d'outil à votre chaîne d'outils. - -## Suppression d'une intégration d'outil -{: #deleting_a_tool_integration} - -Si vous supprimez une intégration d'outil de votre chaîne d'outils, la suppression est irréversible. - -1. Dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. -1. Sur la vignette de l'intégration d'outil à supprimer, cliquez sur le menu pour accéder aux options de configuration. -1. Pour supprimer l'intégration d'outil de votre chaîne d'outils, cliquez sur **Supprimer**. -1. Confirmez en cliquant sur **Supprimer**. - -## Gestion des accès -{: #managing_access_dedicated} - -Vous pouvez accorder l'accès à une chaîne d'outils à des utilisateurs en les ajoutant à l'organisation (org) à laquelle la chaîne d'outils est associée. Chaque chaîne d'outils est associée à une organisation spécifique, et tout membre de cette organisation peut accéder aux chaînes d'outils associées. Pour afficher l'organisation que vous utilisez actuellement, cliquez sur l'icône **{{site.data.keyword.avatar}}** ![Icône Avatar](../icons/i-avatar-icon.svg) dans la barre de menus. Pour accéder à un ensemble différent de chaînes d'outils, changez d'organisation. - -Lorsque vous ajoutez des utilisateurs à votre organisation et vos espaces {{site.data.keyword.Bluemix}}, ces utilisateurs peuvent se connecter à GitHub Enterprise à l'aide de leurs ID et mot de passe {{site.data.keyword.Bluemix_notm}}. Lorsque les utilisateurs se connectent, les comptes correspondants sont créés. Lorsque vous ajoutez des utilisateurs à votre organisation et vos espaces {{site.data.keyword.Bluemix_notm}}, ils ne sont pas automatiquement ajoutés au référentiel GitHub Enterprise. Une personne dotée de privilèges d'administrateur pour le référentiel doit les ajouter. Pour plus d'informations, voir [Utilisation de Dedicated GitHub Enterprise (Lien s'ouvrant dans une nouvelle fenêtre)](../services/ghededicated/index.html){: new_window}. - -Pour ajouter un utilisateur, procédez comme suit : - -1. Dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Cliquez ensuite sur **Gérer**. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Gérer**. -1. Cliquez sur le lien de votre organisation. -1. Dans la page de gestion des organisations, cliquez sur **Inviter un utilisateur** et entrez l'adresse électronique de l'utilisateur. -1. Si vous souhaitez donner des droits avancés à des responsables {{site.data.keyword.Bluemix_notm}} d'organisations, sélectionnez une ou plusieurs des cases à cocher **Responsable**, **Responsable de la facturation** et **Auditeur**. -1. Cliquez sur **INVITER**. -1. Cliquez sur **SAUVEGARDER**. - -## Suppression d'une chaîne d'outils -{: #deleting_a_toolchain_dedicated} - -Vous pouvez supprimer une chaîne d'outils et spécifier les intégrations d'outils associées à supprimer. Lorsque vous supprimez une chaîne d'outils, la suppression est irréversible. - -1. Dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Cliquez ensuite sur **Gérer**. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Gérer**. -1. Cliquez sur **Supprimer la chaîne d'outils**, examinez et modifiez éventuellement la liste des intégrations d'outils à supprimer. -1. Confirmez la suppression en entrant le nom de la chaîne d'outils et en cliquant sur **Supprimer**. - - **Conseil** : Lorsque vous supprimez une intégration d'outil GitHub Enterprise, le référentiel GitHub Enterprise associé n'est pas supprimé de GitHub Enterprise. Vous devez supprimer manuellement le référentiel depuis GitHub Enterprise. +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Utilisation de chaînes d'outils sur {{site.data.keyword.Bluemix_notm}} dédié +{: #toolchains-using_dedicated} + +Dernière mise à jour : 13 septembre 2016 +{: .last-updated} + +Vous pouvez utiliser une chaîne d'outils pour améliorer la productivité de votre travail quotidien de développement, de déploiement et de vos opérations. Après avoir configuré une chaîne d'outils, vous pouvez ajouter, supprimer ou configurer des intégrations d'outils et gérer l'accès à la chaîne d'outils. +{: shortdesc} + +## Configuration d'une intégration d'outil +{: #configuring_a_tool_integration_dedicated} + +Si vous avez différé la configuration d'une intégration d'outil lors de la création d'une chaîne d'outils, un bouton **Configurer** s'affiche sur sa vignette. Si vous avez configuré une intégration d'outil à la création d'une chaîne d'outils, vous pouvez mettre à jour les paramètres de configuration. + +1. Dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Si vous devez configurer une intégration d'outil pour la première fois, depuis sa vignette, cliquez sur **Configurer**. + + ![Bouton Configurer](images/toolchain_tile_configure.png) + + Lorsque vous avez terminé la configuration de l'intégration d'outil, cliquez sur **Sauvegarder l'intégration**. + +1. Si vous devez mettre à jour la configuration d'une intégration d'outil, depuis sa vignette, cliquez sur le menu pour accéder aux options de configuration. + + ![Menu Configuration](images/toolchain_tile_menu.png) + + Lorsque vous avez terminé la mis à jour des paramètres, cliquez sur **Sauvegarder l'intégration**. + +## Ajout d'une intégration d'outil +{: #adding_a_tool_integration_dedicated} + +Vous pouvez ajouter et configurer des intégrations d'outils pour votre chaîne d'outils. + +1. Dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Pour afficher la liste des intégrations d'outils à ajouter, cliquez sur le bouton d'ajout (+). +1. Cliquez sur l'intégration d'outil à ajouter. +1. Entrez les informations requises pour configurer l'intégration d'outil. +1. Cliquez sur **Créer une intégration** pour ajouter l'intégration d'outil à votre chaîne d'outils. + +## Suppression d'une intégration d'outil +{: #deleting_a_tool_integration} + +Si vous supprimez une intégration d'outil de votre chaîne d'outils, la suppression est irréversible. + +1. Dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Intégrations d'outils**. +1. Sur la vignette de l'intégration d'outil à supprimer, cliquez sur le menu pour accéder aux options de configuration. +1. Pour supprimer l'intégration d'outil de votre chaîne d'outils, cliquez sur **Supprimer**. +1. Confirmez en cliquant sur **Supprimer**. + +## Gestion des accès +{: #managing_access_dedicated} + +Vous pouvez accorder l'accès à une chaîne d'outils à des utilisateurs en les ajoutant à l'organisation (org) à laquelle la chaîne d'outils est associée. Chaque chaîne d'outils est associée à une organisation spécifique, et tout membre de cette organisation peut accéder aux chaînes d'outils associées. Pour afficher l'organisation que vous utilisez actuellement, cliquez sur l'icône **{{site.data.keyword.avatar}}** ![Icône Avatar](../icons/i-avatar-icon.svg) dans la barre de menus. Pour accéder à un ensemble différent de chaînes d'outils, changez d'organisation. + +Lorsque vous ajoutez des utilisateurs à votre organisation et vos espaces {{site.data.keyword.Bluemix}}, ces utilisateurs peuvent se connecter à GitHub Enterprise à l'aide de leurs ID et mot de passe {{site.data.keyword.Bluemix_notm}}. Lorsque les utilisateurs se connectent, les comptes correspondants sont créés. Lorsque vous ajoutez des utilisateurs à votre organisation et vos espaces {{site.data.keyword.Bluemix_notm}}, ils ne sont pas automatiquement ajoutés au référentiel GitHub Enterprise. Une personne dotée de privilèges d'administrateur pour le référentiel doit les ajouter. Pour plus d'informations, voir [Utilisation de Dedicated GitHub Enterprise (Lien s'ouvrant dans une nouvelle fenêtre)](../services/ghededicated/index.html){: new_window}. + +Pour ajouter un utilisateur, procédez comme suit : + +1. Dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Cliquez ensuite sur **Gérer**. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Gérer**. +1. Cliquez sur le lien de votre organisation. +1. Dans la page de gestion des organisations, cliquez sur **Inviter un utilisateur** et entrez l'adresse électronique de l'utilisateur. +1. Si vous souhaitez donner des droits avancés à des responsables {{site.data.keyword.Bluemix_notm}} d'organisations, sélectionnez une ou plusieurs des cases à cocher **Responsable**, **Responsable de la facturation** et **Auditeur**. +1. Cliquez sur **INVITER**. +1. Cliquez sur **SAUVEGARDER**. + +## Suppression d'une chaîne d'outils +{: #deleting_a_toolchain_dedicated} + +Vous pouvez supprimer une chaîne d'outils et spécifier les intégrations d'outils associées à supprimer. Lorsque vous supprimez une chaîne d'outils, la suppression est irréversible. + +1. Dans le tableau de bord, onglet **DEVOPS**, cliquez sur la chaîne d'outils pour ouvrir la page d'intégration d'outil correspondante. Cliquez ensuite sur **Gérer**. Vous pouvez également, dans le coin supérieur droit de la page de présentation de l'application, cliquer sur **Afficher la chaîne d'outils**. Cliquez ensuite sur **Gérer**. +1. Cliquez sur **Supprimer la chaîne d'outils**, examinez et modifiez éventuellement la liste des intégrations d'outils à supprimer. +1. Confirmez la suppression en entrant le nom de la chaîne d'outils et en cliquant sur **Supprimer**. + + **Conseil** : Lorsque vous supprimez une intégration d'outil GitHub Enterprise, le référentiel GitHub Enterprise associé n'est pas supprimé de GitHub Enterprise. Vous devez supprimer manuellement le référentiel depuis GitHub Enterprise. diff --git a/toolchains/nl/fr/web_ide.md b/toolchains/nl/fr/web_ide.md index fa89028e4..00d3e0e21 100644 --- a/toolchains/nl/fr/web_ide.md +++ b/toolchains/nl/fr/web_ide.md @@ -1,152 +1,152 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} -{:pre: .pre} - -# Edition de code avec Eclipse Orion {{site.data.keyword.webide}} -{: #web_ide} - -Dernière mise à jour : 9 septembre 2016 -{: .last-updated} - -Eclipse Orion {{site.data.keyword.webide}} est un environnement de développement basé navigateur dans lequel vous pouvez faire du développement pour le Web. Vous pouvez développer en JavaScript, HTML et CSS en vous aidant de l'assistant de contenu, de la validation de code et du contrôle des erreurs. {{site.data.keyword.webide}} fonctionne avec quasiment toutes les langues et offre une mise en évidence de syntaxe pour la plupart des [types de fichier (Lien s'ouvrant dans une nouvelle fenêtre)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}. Le contrôle des sources est généré via Git ou Jazz SCM, et vous pouvez déployer le code en local afin de tester et déboguer vos applications. -{:shortdesc} - -Mais surtout, {{site.data.keyword.webide}} est basé sur le Web. Vous n'avez rien à installer, rien à gérer, et rien à mettre à l'échelle. Vous pouvez faire du développement depuis n'importe quel endroit, dans la mesure où vous disposez d'une connexion Internet. - -## Configuration de l'éditeur -{: #editorsetup} - -{{site.data.keyword.webide}} est personnalisable : vous pouvez choisir les schémas de couleurs, les outils techniques et les paramètres correspondant à vos besoins de développement. Pour afficher et modifier les paramètres, depuis le menu de gauche, cliquez sur l'icône **Paramètres** Icône des paramètres. - -Si vous avez fréquemment besoin de changer certains paramètres lors de l'édition, vous pouvez accéder à ces paramètres rapidement via l'icône **Paramètres de l'éditeur local** Icône Paramètres de l'éditeur local située dans le coin supérieur droit de l'éditeur. - -![Paramètres de l'éditeur local](images/webide_local_editor_settings.png) - -Par défaut, les paramètres de style et de taille de police de l'éditeur sont toujours affichés. Pour inclure d'autres paramètres de l'éditeur dans le menu, procédez comme suit : - -1. Cliquez sur l'icône **Paramètres de l'éditeur local** Icône Paramètres de l'éditeur local. - -2. Cliquez sur **Paramètres de l'éditeur**. - -3. Pour inclure ou exclure un paramètre du menu **Paramètres de l'éditeur local**, cliquez sur la pastille en regard du paramètre. - -![Activation/désactivation des Paramètres de l'éditeur](images/webide_editor_settings_toggle.png) - - -## Edition de code -{: #editcode} - -{{site.data.keyword.webide}} comporte deux sections principales. La première section correspond au navigateur de fichiers, situé à gauche, qui affiche vos fichiers de projet dans une structure arborescente. Depuis le navigateur de fichiers, vous pouvez créer, renommer, supprimer et gérer vos fichiers et dossiers. - -**Conseil :** Pour télécharger des fichiers dans le navigateur de fichiers, faites-les glisser depuis votre ordinateur vers le navigateur. - -La seconde section correspond à la sous-fenêtre de l'éditeur, située sur la droite. L'éditeur fournit plusieurs fonctions de codage, notamment l'assistant de contenu et la validation de la syntaxe. - -![Web IDE](images/webide.png) - -### Utilisation de plusieurs fichiers -1. Pour utiliser deux fichiers en même temps, cliquez sur l'icône **Changer le mode de fractionnement de l'éditeur** Icône Fractionner l'éditeur situé en haut de l'éditeur. -2. Dans le menu qui s'ouvre, sélectionnez une vue. - - Une fois que vous avez sélectionné une vue, si un fichier était déjà ouvert dans l'éditeur, il s'affiche dans les deux vues. - - Pour ouvrir ou changer un fichier affiché dans l'une des vues de l'éditeur : - 1. Placez le curseur sur la vue que vous souhaitez changer. - 2. Dans le navigateur de fichiers, cliquez sur un fichier. - -### Raccourcis-clavier -La plupart des commandes de {{site.data.keyword.webide}} sont accessibles uniquement via des raccourcis-clavier. - -Pour afficher la liste des raccourcis-clavier dans l'éditeur, appuyez sur Alt+Maj+?. Si vous utilisez un système Mac OS, appuyez sur Ctrl+Maj+?. - -## Gestion du code source -{: #sourcecontrol} - -{{site.data.keyword.webide}} est intégré aux outils de gestion du code source. Pour utiliser votre référentiel Git, cliquez sur l'icône **Référentiel Git** Icône Référentiel Git. Pour plus d'informations, voir [Source control with Git (Lien s'ouvrant dans une nouvelle fenêtre)](https://hub.jazz.net/docs/git/){: new_window}. - - -## Déploiement d'une application depuis votre espace de travail -{: #deploy} - -1. Pour déployer votre application, depuis la barre d'exécution, sélectionnez ou [créez (Lien s'ouvrant dans une nouvelle fenêtre)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} une configuration de lancement. -1. Cliquez sur l'icône de déploiement Icône de déploiement. Une instance de votre application est déployée à l'aide du contenu actuel de votre espace de travail et de l'environnement défini dans votre configuration de lancement. -2. Une fois voter application déployée, vous pouvez utiliser la barre d'exécution pour arrêter, redémarrer ou déboguer votre application, consulter des journaux, etc. -![ Barre d'exécution](images/webide_runbar.png) - - - - ## Edition hors de {{site.data.keyword.webide}} -{: #editlocal} - -Pour utiliser un éditeur en dehors de {{site.data.keyword.webide}}, configurez {{site.data.keyword.Bluemix_live}} de façon à utiliser directement vos fichiers de projet dans l'outil de votre choix. {{site.data.keyword.Bluemix_live_notm}} est une application de ligne de commande qui synchronise les changements sur votre système de fichiers local avec votre espace de travail cloud dans {{site.data.keyword.jazzhub}}. - -### En premier lieu - -Téléchargez et installez l'[interface de ligne de commande {{site.data.keyword.Bluemix_live_notm}} (Lien s'ouvrant dans une nouvelle fenêtre)](http://livesyncdownload.ng.bluemix.net){: new_window}. - -### Synchronisation de votre environnement local avec {{site.data.keyword.Bluemix_notm}} -{: #edit_local_download} - -1. Ouvrez une fenêtre de ligne de commande. -2. Connectez-vous à {{site.data.keyword.Bluemix_notm}}: - - ``` - bl login - ``` - {: pre} - -3. Lorsque vous y êtes invité, entrez vos IBMid et mot de passe. -4. Affichez la liste de vos projets {{site.data.keyword.Bluemix_notm}} : - - ``` - bl projects - ``` - {: pre} - -4. Synchronisez votre environnement local avec votre projet sur {{site.data.keyword.Bluemix_notm}} : - - ``` - bl sync projectName - ``` - {: pre} - -où `projectName` correspond au nom de votre application {{site.data.keyword.Bluemix_notm}}. - -Une fois l'édition terminée, entrez `q` pour mettre fin à la synchronisation. - -### Activation de la fonction Desktop Sync pour éditer du code en local - -La fonction Desktop Sync est similaire au mode d'édition directe (Live Edit) de la ligne de commande. Vous avez besoin de la fonction Desktop Sync pour le débogage sur la ligne de commande. -1. Dans une autre fenêtre de ligne de commande, activez la fonction Desktop Sync : - - ``` - cd localDirectory - bl start - ``` - {: codeblock} - -2. Utilisez la configuration de lancement créée dans {{site.data.keyword.webide}}. Une fois la configuration de lancement sélectionnée, la fonction Desktop Sync est activée dans votre environnement local. Dans la fenêtre de ligne de commande que vous venez d'ouvrir, vous pouvez voir l'URL de l'application, l'URL de débogage, l'URL de gestion, ainsi que l'état de {{site.data.keyword.Bluemix_live_notm}}. - -3. Actualisez le navigateur et vérifiez que vous pouvez voir les modifications sauvegardées dans des fichiers statiques de l'espace de travail local. - -### Désactivation de la fonction Desktop Sync - -1. Dans la deuxième fenêtre de ligne de commande, entrez `bl stop`. -2. Dans la première fenêtre de ligne de commande, entrez `q`. +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} +{:pre: .pre} + +# Edition de code avec Eclipse Orion {{site.data.keyword.webide}} +{: #web_ide} + +Dernière mise à jour : 9 septembre 2016 +{: .last-updated} + +Eclipse Orion {{site.data.keyword.webide}} est un environnement de développement basé navigateur dans lequel vous pouvez faire du développement pour le Web. Vous pouvez développer en JavaScript, HTML et CSS en vous aidant de l'assistant de contenu, de la validation de code et du contrôle des erreurs. {{site.data.keyword.webide}} fonctionne avec quasiment toutes les langues et offre une mise en évidence de syntaxe pour la plupart des [types de fichier (Lien s'ouvrant dans une nouvelle fenêtre)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}. Le contrôle des sources est généré via Git ou Jazz SCM, et vous pouvez déployer le code en local afin de tester et déboguer vos applications. +{:shortdesc} + +Mais surtout, {{site.data.keyword.webide}} est basé sur le Web. Vous n'avez rien à installer, rien à gérer, et rien à mettre à l'échelle. Vous pouvez faire du développement depuis n'importe quel endroit, dans la mesure où vous disposez d'une connexion Internet. + +## Configuration de l'éditeur +{: #editorsetup} + +{{site.data.keyword.webide}} est personnalisable : vous pouvez choisir les schémas de couleurs, les outils techniques et les paramètres correspondant à vos besoins de développement. Pour afficher et modifier les paramètres, depuis le menu de gauche, cliquez sur l'icône **Paramètres** Icône des paramètres. + +Si vous avez fréquemment besoin de changer certains paramètres lors de l'édition, vous pouvez accéder à ces paramètres rapidement via l'icône **Paramètres de l'éditeur local** Icône Paramètres de l'éditeur local située dans le coin supérieur droit de l'éditeur. + +![Paramètres de l'éditeur local](images/webide_local_editor_settings.png) + +Par défaut, les paramètres de style et de taille de police de l'éditeur sont toujours affichés. Pour inclure d'autres paramètres de l'éditeur dans le menu, procédez comme suit : + +1. Cliquez sur l'icône **Paramètres de l'éditeur local** Icône Paramètres de l'éditeur local. + +2. Cliquez sur **Paramètres de l'éditeur**. + +3. Pour inclure ou exclure un paramètre du menu **Paramètres de l'éditeur local**, cliquez sur la pastille en regard du paramètre. + +![Activation/désactivation des Paramètres de l'éditeur](images/webide_editor_settings_toggle.png) + + +## Edition de code +{: #editcode} + +{{site.data.keyword.webide}} comporte deux sections principales. La première section correspond au navigateur de fichiers, situé à gauche, qui affiche vos fichiers de projet dans une structure arborescente. Depuis le navigateur de fichiers, vous pouvez créer, renommer, supprimer et gérer vos fichiers et dossiers. + +**Conseil :** Pour télécharger des fichiers dans le navigateur de fichiers, faites-les glisser depuis votre ordinateur vers le navigateur. + +La seconde section correspond à la sous-fenêtre de l'éditeur, située sur la droite. L'éditeur fournit plusieurs fonctions de codage, notamment l'assistant de contenu et la validation de la syntaxe. + +![Web IDE](images/webide.png) + +### Utilisation de plusieurs fichiers +1. Pour utiliser deux fichiers en même temps, cliquez sur l'icône **Changer le mode de fractionnement de l'éditeur** Icône Fractionner l'éditeur situé en haut de l'éditeur. +2. Dans le menu qui s'ouvre, sélectionnez une vue. + + Une fois que vous avez sélectionné une vue, si un fichier était déjà ouvert dans l'éditeur, il s'affiche dans les deux vues. + + Pour ouvrir ou changer un fichier affiché dans l'une des vues de l'éditeur : + 1. Placez le curseur sur la vue que vous souhaitez changer. + 2. Dans le navigateur de fichiers, cliquez sur un fichier. + +### Raccourcis-clavier +La plupart des commandes de {{site.data.keyword.webide}} sont accessibles uniquement via des raccourcis-clavier. + +Pour afficher la liste des raccourcis-clavier dans l'éditeur, appuyez sur Alt+Maj+?. Si vous utilisez un système Mac OS, appuyez sur Ctrl+Maj+?. + +## Gestion du code source +{: #sourcecontrol} + +{{site.data.keyword.webide}} est intégré aux outils de gestion du code source. Pour utiliser votre référentiel Git, cliquez sur l'icône **Référentiel Git** Icône Référentiel Git. Pour plus d'informations, voir [Source control with Git (Lien s'ouvrant dans une nouvelle fenêtre)](https://hub.jazz.net/docs/git/){: new_window}. + + +## Déploiement d'une application depuis votre espace de travail +{: #deploy} + +1. Pour déployer votre application, depuis la barre d'exécution, sélectionnez ou [créez (Lien s'ouvrant dans une nouvelle fenêtre)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} une configuration de lancement. +1. Cliquez sur l'icône de déploiement Icône de déploiement. Une instance de votre application est déployée à l'aide du contenu actuel de votre espace de travail et de l'environnement défini dans votre configuration de lancement. +2. Une fois voter application déployée, vous pouvez utiliser la barre d'exécution pour arrêter, redémarrer ou déboguer votre application, consulter des journaux, etc. +![ Barre d'exécution](images/webide_runbar.png) + + + + ## Edition hors de {{site.data.keyword.webide}} +{: #editlocal} + +Pour utiliser un éditeur en dehors de {{site.data.keyword.webide}}, configurez {{site.data.keyword.Bluemix_live}} de façon à utiliser directement vos fichiers de projet dans l'outil de votre choix. {{site.data.keyword.Bluemix_live_notm}} est une application de ligne de commande qui synchronise les changements sur votre système de fichiers local avec votre espace de travail cloud dans {{site.data.keyword.jazzhub}}. + +### En premier lieu + +Téléchargez et installez l'[interface de ligne de commande {{site.data.keyword.Bluemix_live_notm}} (Lien s'ouvrant dans une nouvelle fenêtre)](http://livesyncdownload.ng.bluemix.net){: new_window}. + +### Synchronisation de votre environnement local avec {{site.data.keyword.Bluemix_notm}} +{: #edit_local_download} + +1. Ouvrez une fenêtre de ligne de commande. +2. Connectez-vous à {{site.data.keyword.Bluemix_notm}}: + + ``` + bl login + ``` + {: pre} + +3. Lorsque vous y êtes invité, entrez vos IBMid et mot de passe. +4. Affichez la liste de vos projets {{site.data.keyword.Bluemix_notm}} : + + ``` + bl projects + ``` + {: pre} + +4. Synchronisez votre environnement local avec votre projet sur {{site.data.keyword.Bluemix_notm}} : + + ``` + bl sync projectName + ``` + {: pre} + +où `projectName` correspond au nom de votre application {{site.data.keyword.Bluemix_notm}}. + +Une fois l'édition terminée, entrez `q` pour mettre fin à la synchronisation. + +### Activation de la fonction Desktop Sync pour éditer du code en local + +La fonction Desktop Sync est similaire au mode d'édition directe (Live Edit) de la ligne de commande. Vous avez besoin de la fonction Desktop Sync pour le débogage sur la ligne de commande. +1. Dans une autre fenêtre de ligne de commande, activez la fonction Desktop Sync : + + ``` + cd localDirectory + bl start + ``` + {: codeblock} + +2. Utilisez la configuration de lancement créée dans {{site.data.keyword.webide}}. Une fois la configuration de lancement sélectionnée, la fonction Desktop Sync est activée dans votre environnement local. Dans la fenêtre de ligne de commande que vous venez d'ouvrir, vous pouvez voir l'URL de l'application, l'URL de débogage, l'URL de gestion, ainsi que l'état de {{site.data.keyword.Bluemix_live_notm}}. + +3. Actualisez le navigateur et vérifiez que vous pouvez voir les modifications sauvegardées dans des fichiers statiques de l'espace de travail local. + +### Désactivation de la fonction Desktop Sync + +1. Dans la deuxième fenêtre de ligne de commande, entrez `bl stop`. +2. Dans la première fenêtre de ligne de commande, entrez `q`. diff --git a/toolchains/nl/it/toolchains_about.md b/toolchains/nl/it/toolchains_about.md index 59afb4de6..a72d77078 100644 --- a/toolchains/nl/it/toolchains_about.md +++ b/toolchains/nl/it/toolchains_about.md @@ -1,44 +1,44 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# Informazioni sulle toolchain -{: #toolchains_about} - -Ultimo aggiornamento: 13 settembre 2016 -{: .last-updated} - -Una *toolchain* è una serie di integrazioni dello strumento che supporta le attività di operazioni, sviluppo e distribuzione. La potenza collettiva di una toolchain è superiore alla somma delle relative integrazioni dello strumento. -{:shortdesc} - -Le toolchain sono disponibili negli ambienti pubblico e dedicato in {{site.data.keyword.Bluemix}}. Puoi creare una toolchain in due modi: utilizzando un template per creare una toolchain o creando una toolchain da un'applicazione. Come punto di partenza, puoi utilizzare un template toolchain. A seconda del template che utilizzi, puoi creare una toolchain che dispone di una serie di integrazioni dello strumento o una toolchain vuota a cui puoi aggiungere le integrazioni dello strumento. - -In {{site.data.keyword.Bluemix_notm}} pubblico, a seconda della toolchain o del template che utilizzi, la toolchain può includere un repository (repo) GitHub che viene popolato con il codice starter dell'applicazione e una delivery pipeline preconfigurata. Quando esegui il push delle modifiche a un repository GitHub della toolchain, la delivery pipeline automaticamente crea e distribuisce l'applicazione a {{site.data.keyword.Bluemix_notm}}. - -In {{site.data.keyword.Bluemix_notm}} dedicato, a seconda della toolchain che utilizzi, la toolchain può includere un repository GitHub Enterprise che viene popolato con il codice starter dell'applicazione e una delivery pipeline preconfigurata. Quando esegui il push delle modifiche a un repository GitHub Enterprise della toolchain, la delivery pipeline automaticamente crea e distribuisce le applicazioni a {{site.data.keyword.Bluemix_notm}}. - -## Come ottenere supporto per le toolchain -{: #gettinghelp} - -Se hai dei problemi o delle domande quando utilizzi le toolchain, puoi ottenere aiuto ricercando le informazioni o facendo delle domande in un forum. Puoi inoltre aprire un ticket di supporto. - -Quando utilizzi i forum per fare una domanda, contrassegnala con una tag in modo che sia visualizzabile dai team di sviluppo {{site.data.keyword.Bluemix_notm}}. - -* Se hai domande tecniche sullo sviluppo o la distribuzione di un'applicazione con le toolchain, inserisci la tua domanda in -[Stack Overflow (il link si apre in una nuova finestra)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} -e contrassegna la tua domanda con le tag "ibm-bluemix" e "devops". - -* Per domande sulle toolchain e le istruzioni introduttive, utilizza il forum [IBM developerWorks dW Answers (il link si apre in una nuova finestra)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}. Includi le tag "devops-services" e "bluemix". - -Consulta [Come ottenere supporto (il link si apre in una nuova finestra)](https://www.{DomainName}/docs/support/index.html#getting-help) per ulteriori dettagli sull'utilizzo dei forum. - -Per informazioni su come aprire un ticket di supporto IBM o sui livelli di supporto e sulla gravità dei ticket, consulta [Come contattare il supporto (il link si apre in una nuova finestra)](https://www.{DomainName}/docs/support/index.html#contacting-support). +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# Informazioni sulle toolchain +{: #toolchains_about} + +Ultimo aggiornamento: 13 settembre 2016 +{: .last-updated} + +Una *toolchain* è una serie di integrazioni dello strumento che supporta le attività di operazioni, sviluppo e distribuzione. La potenza collettiva di una toolchain è superiore alla somma delle relative integrazioni dello strumento. +{:shortdesc} + +Le toolchain sono disponibili negli ambienti pubblico e dedicato in {{site.data.keyword.Bluemix}}. Puoi creare una toolchain in due modi: utilizzando un template per creare una toolchain o creando una toolchain da un'applicazione. Come punto di partenza, puoi utilizzare un template toolchain. A seconda del template che utilizzi, puoi creare una toolchain che dispone di una serie di integrazioni dello strumento o una toolchain vuota a cui puoi aggiungere le integrazioni dello strumento. + +In {{site.data.keyword.Bluemix_notm}} pubblico, a seconda della toolchain o del template che utilizzi, la toolchain può includere un repository (repo) GitHub che viene popolato con il codice starter dell'applicazione e una delivery pipeline preconfigurata. Quando esegui il push delle modifiche a un repository GitHub della toolchain, la delivery pipeline automaticamente crea e distribuisce l'applicazione a {{site.data.keyword.Bluemix_notm}}. + +In {{site.data.keyword.Bluemix_notm}} dedicato, a seconda della toolchain che utilizzi, la toolchain può includere un repository GitHub Enterprise che viene popolato con il codice starter dell'applicazione e una delivery pipeline preconfigurata. Quando esegui il push delle modifiche a un repository GitHub Enterprise della toolchain, la delivery pipeline automaticamente crea e distribuisce le applicazioni a {{site.data.keyword.Bluemix_notm}}. + +## Come ottenere supporto per le toolchain +{: #gettinghelp} + +Se hai dei problemi o delle domande quando utilizzi le toolchain, puoi ottenere aiuto ricercando le informazioni o facendo delle domande in un forum. Puoi inoltre aprire un ticket di supporto. + +Quando utilizzi i forum per fare una domanda, contrassegnala con una tag in modo che sia visualizzabile dai team di sviluppo {{site.data.keyword.Bluemix_notm}}. + +* Se hai domande tecniche sullo sviluppo o la distribuzione di un'applicazione con le toolchain, inserisci la tua domanda in +[Stack Overflow (il link si apre in una nuova finestra)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} +e contrassegna la tua domanda con le tag "ibm-bluemix" e "devops". + +* Per domande sulle toolchain e le istruzioni introduttive, utilizza il forum [IBM developerWorks dW Answers (il link si apre in una nuova finestra)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}. Includi le tag "devops-services" e "bluemix". + +Consulta [Come ottenere supporto (il link si apre in una nuova finestra)](https://www.{DomainName}/docs/support/index.html#getting-help) per ulteriori dettagli sull'utilizzo dei forum. + +Per informazioni su come aprire un ticket di supporto IBM o sui livelli di supporto e sulla gravità dei ticket, consulta [Come contattare il supporto (il link si apre in una nuova finestra)](https://www.{DomainName}/docs/support/index.html#contacting-support). diff --git a/toolchains/nl/it/toolchains_integrations.md b/toolchains/nl/it/toolchains_integrations.md index d712f1302..f0d0c326f 100644 --- a/toolchains/nl/it/toolchains_integrations.md +++ b/toolchains/nl/it/toolchains_integrations.md @@ -1,304 +1,304 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configurazione delle integrazioni dello strumento -{: #integrations} - -Ultimo aggiornamento: 18 ottobre 2016 -{: .last-updated} - -Puoi configurare le integrazioni dello strumento che supportano le attività di operazioni, sviluppo e distribuzione mentre crei una toolchain o puoi aggiungere e configurare le integrazioni dello strumento per personalizzare una toolchain esistente. -{:shortdesc} - -**Importante**: in {{site.data.keyword.Bluemix_notm}} pubblico, le toolchain sono disponibili solo nella regione degli Stati Uniti Sud. - -Le integrazioni dello strumento disponibili per aggiungere e configurare la tua toolchain sono diverse a seconda se stai utilizzando le toolchain in {{site.data.keyword.Bluemix_notm}} pubblico o {{site.data.keyword.Bluemix_notm}} dedicato. Se stai utilizzando le toolchain in {{site.data.keyword.Bluemix_notm}} dedicato, le integrazioni dello strumento disponibili dipendono dal modo in cui {{site.data.keyword.jazzhub_title}} è stato configurato nel tuo ambiente specifico. - -*Tabella 1. Integrazioni dello strumento disponibili per le toolchain in {{site.data.keyword.Bluemix_notm}} pubblico e dedicato* - -|Integrazione strumento |Disponibile in {{site.data.keyword.Bluemix_notm}} pubblico |Disponibile in {{site.data.keyword.Bluemix_notm}} dedicato (dipendente dall'ambiente)| -|:----------|:------------------------------|:------------------| -|{{site.data.keyword.deliverypipeline}} |Sì |Sì | -|{{site.data.keyword.DRA_short}} |Sì |No | -|Eclipse Orion {{site.data.keyword.webide}} |Sì |Sì | -|GitHub |Sì |Sì | -|Dedicated GitHub Enterprise |No |Sì | -|Altro strumento |Sì |Sì | -|PagerDuty |Sì |Sì | -|Sauce Labs |Sì |No | -|Slack |Sì |Sì | - -**Suggerimento**: se desideri avviare lo sviluppo con il codice di origine in {{site.data.keyword.Bluemix_notm}} pubblico, configura l'integrazione dello strumento GitHub prima di configurare la {{site.data.keyword.deliverypipeline}}. Se desideri avviare lo sviluppo con il codice in {{site.data.keyword.Bluemix_notm}} dedicato, configura l'integrazione dello strumento {{site.data.keyword.ghe_short}} o l'integrazione dello strumento GitHub prima di configurare la {{site.data.keyword.deliverypipeline}}. - - -## Configurazione della delivery pipeline -{: #deliverypipeline} - -La {{site.data.keyword.deliverypipeline}} automatizza la distribuzione continua dei tuoi progetti tramite una sequenza di fasi che richiamano i lavori di input ed esecuzione, come le creazioni, le verifiche e le distribuzioni. - -Configura la {{site.data.keyword.deliverypipeline}} per automatizzare la distribuzione, la verifica e la creazione continua delle tue applicazioni: - -1. Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su **Delivery Pipeline**. A seconda del template che utilizzi, possono essere disponibili diversi campi. Rivedi i valori di campo predefiniti e se necessario, modifica queste impostazioni. -1. Se disponi di una toolchain in {{site.data.keyword.Bluemix_notm}} pubblico a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella tua pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. Se stai utilizzando una toolchain in {{site.data.keyword.Bluemix_notm}} dedicato, nel dashboard, fai clic sulla scheda **DEVOPS** e fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Fai clic sul pulsante di aggiunta (+). -1. Nella sezione Integrazione toolchain, fai clic su **Delivery Pipeline**. -1. Specifica un nome per la tua nuova pipeline. -1. Se stai pianificando di utilizzare la tua pipeline per distribuire un'interfaccia utente, seleziona la casella di spunta **Applicazione visualizzabile**. Tutte le applicazioni create dalla tua pipeline vengono visualizzate nell'elenco **VIEW APP** nella pagina Integrazioni dello strumento della toolchain. -1. Fai clic su **Create Integration** per aggiungere la {{site.data.keyword.deliverypipeline}} alla tua toolchain. -1. Fai clic sul tile per la {{site.data.keyword.deliverypipeline}} per visualizzare la pipeline e configurarla. Per informazioni sulla configurazione di una pipeline, consulta [Building and deploying pipelines (il link si apre in una nuova finestra)](../services/DeliveryPipeline/build_deploy.html){: new_window}. - - **Suggerimento**: se desideri attivare la pipeline quando esegui il push delle modifiche al tuo repository GitHub o {{site.data.keyword.ghe_short}} devi configurare GitHub o {{site.data.keyword.ghe_short}} per la tua toolchain prima di definire le fasi per la tua pipeline. Le fasi della pipeline necessitano di URL Git per i tuoi repository. Ogni fase della pipeline può far riferimento solo a uno dei repository GitHub o {{site.data.keyword.ghe_short}} associato con la tua toolchain. Per istruzioni su come configurare GitHub, consulta la sezione [Problemi GitHub e GitHub](#github). Per istruzioni su come configurare Dedicated GitHub Enterprise, consulta [Getting started with {{site.data.keyword.ghe_long}} (il link si apre in una nuova finestra)](../services/ghededicated/index.html){: new_window}. - -1. Facoltativo: se stai utilizzando una toolchain in {{site.data.keyword.Bluemix_notm}} pubblico e desideri che Sauce Labs esegua delle verifiche sulla tua applicazione, configura la {{site.data.keyword.deliverypipeline}} per aggiungere un lavoro di verifica Sauce Labs. Per istruzioni sulla configurazione del lavoro di verifica, consulta la sezione [Configurazione di un lavoro di verifica Sauce Labs nella tua pipeline](#config_saucelabs). - -### Configurazione di un lavoro di verifica Sauce Labs nella tua pipeline -{: #config_saucelabs} - -Prima di configurare un lavoro di verifica Sauce Labs nella tua pipeline, devi disporre di una pipeline funzionante provvista di fasi per creare e distribuire la tua applicazione e devi configurare Sauce Labs per la tua toolchain. Per istruzioni sulla configurazione di Sauce Labs, consulta la sezione [Sauce Labs](#saucelabs). - -Configura la {{site.data.keyword.deliverypipeline}} per aggiungere un lavoro di verifica Sauce Labs: - -1. Se non disponi di una fase che distribuisce una versione di verifica della tua applicazione, creane una. -1. Nella fase, aggiungi un lavoro di verifica dopo il lavoro di distribuzione. Posizionando questi lavori nella stessa fase, essi possono accedere alla stessa serie di proprietà di ambiente. - ![Lavoro di verifica](images/toolchain_test_job.png) - -1. Configura la fase: - - a. Nella scheda **PROPRIETÀ AMBIENTE**, crea tre proprietà: CF_APP_NAME, SAUCE_USERNAME e SAUCE_ACCESS_KEY. - - b. Immetti il nome utente e la chiave di accesso Sauce Labs. In questo modo esternalizzi questi valori così da poterli utilizzare nelle tue verifiche. - -1. Configura il lavoro di distribuzione. Nel campo **Deploy Script**, includi questo comando: `export CF_APP_NAME="$CF_APP"`. Questo comando esporta il nome dell'applicazione come una proprietà di ambiente. -1. Configura il lavoro di verifica. I valori nella seguente immagine sono degli esempi. I campi **Istanza del servizio**, **Destinazione**, **Organizzazione** e **Spazio** vengono popolati con il nome utente, la regione, l'organizzazione e lo spazio Sauce Labs che stai utilizzando. -![Configura lavoro](images/toolchain_configure_job.png) - - a. Per il tipo di verifica, seleziona **Sauce Labs**. - - b. Per il servizio dell'istanza, seleziona il nome utente Sauce Labs che hai utilizzato nella configurazione di Sauce Labs per la tua toolchain. - - **Suggerimento**: per visualizzare il nome utente e la chiave di accesso che hai utilizzato nella configurazione di Sauce Labs per la tua toolchain, fai clic su **Configura**. - - c. Nel campo **Test Execution Command**, immetti i comandi per installare le dipendenze necessarie per le tue verifiche e quindi eseguile. Ad esempio, per un'applicazione Node.js, devi immettere questi comandi: - ``` - npm install - node_modules/grunt-cli/bin/grunt test:sauce:parallel - ``` - - d. Se desideri visualizzare i report di verifica nei log del lavoro di verifica, seleziona la casella di spunta **Enable Test Report** e imposta il pattern del file dei risultati della verifica su `test/*.xml`. - -1. Fai clic su **SAVE**. Se la tua pipeline è in esecuzione, puoi eseguire le tue verifiche Sauce Labs. - -Per ulteriori informazioni, consulta [Delivery Pipeline (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}. - - -## Aggiunta di {{site.data.keyword.DRA_short}} -{: #dra} - -{{site.data.keyword.DRA_full}} raccoglie e analizza i risultati dalle verifiche di unità, dalle verifiche funzionali e dagli strumenti di copertura del codice per determinare se il tuo codice soddisfa i criteri predefiniti nei gate specificati nel tuo processo di distribuzione. Se il tuo codice non soddisfa o supera i criteri, la distribuzione viene arrestata per prevenire che vengano rilasciati dei rischi. Puoi utilizzare {{site.data.keyword.DRA_short}} come una rete di sicurezza per il tuo ambiente di distribuzione continua o come modo per implementare e migliorare gli standard di qualità. - - **Nota**: questa integrazione dello strumento è preconfigurata. Non richiede alcun parametro di configurazione e non puoi riconfigurarla. - -Aggiungi {{site.data.keyword.DRA_short}} per mantenere e migliorare la qualità del tuo codice {{site.data.keyword.Bluemix_notm}} monitorando le tue distribuzioni per identificare i rischi prima che vangano rilasciati. - -1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Fai clic sul pulsante di aggiunta (+). -1. Nella sezione Integrazione toolchain, fai clic su **Deployment Risk Analytics**. -1. Fai clic su **Create Integration**. -1. Fai clic sul tile per {{site.data.keyword.DRA_short}} e quindi completa i primi passi: creazione dei criteri, connessione dei criteri alla pipeline ed esecuzione della pipeline. Per ulteriori informazioni, consulta [{{site.data.keyword.DRA_short}} (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}. - - -## Aggiunta di Eclipse Orion {{site.data.keyword.webide}} -{: #webide} - -Eclipse Orion {{site.data.keyword.webide}} è un ambiente basato sul web integrato dove puoi creare, modificare, eseguire il debug e completare le attività di controllo dell'origine. Puoi spostare senza interruzioni dalla modifica per l'esecuzione, l'invio e la distribuzione. - - **Nota**: questa integrazione dello strumento è preconfigurata. Non richiede alcun parametro di configurazione e non puoi riconfigurarla. - -Aggiungi l'integrazione dello strumento Eclipse Orion {{site.data.keyword.webide}} per completare le attività di controllo dell'origine: - -1. Se disponi di una toolchain in {{site.data.keyword.Bluemix_notm}} pubblico a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. Se stai utilizzando una toolchain in {{site.data.keyword.Bluemix_notm}} dedicato, nel dashboard, fai clic sulla scheda **DEVOPS** e fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Fai clic sul pulsante di aggiunta (+). -1. Nella sezione Integrazione toolchain, fai clic su **Eclipse Orion Web IDE**. -1. Fai clic su **Create Integration**. -1. Fai clic sul tile per la nuova Eclipse Orion {{site.data.keyword.webide}}. Il tuo spazio di lavoro viene prepopolato con i repository GitHub o {{site.data.keyword.ghe_short}}. I repository associati con la tua toolchain corrente sono evidenziati. - -Per ulteriori informazioni, consulta [Modifica del codice con l'IDE web Eclipse Orion {{site.data.keyword.webide}} (il link si apre in una nuova finestra)](../toolchains/web_ide.html){: new_window}. - - -## Configurazione di GitHub -{: #github} - -GitHub è un servizio host basato sul web per i repository Git. Puoi avere sia copie locali che remote dei tuoi repository, ciò rende più semplice la collaborazione. - -Problemi GitHub è uno strumento di traccia che ti permette di lavorare sui tuoi piani in un solo posto. È integrato con il tuo repository di sviluppo in modo che puoi focalizzarti sulle attività importanti. - -Configura GitHub per gestire il tuo codice di origine nel cloud: - -1. Se stai configurando questa integrazione dello strumento mentre stai creando la toolchain, segui questi passi: - - a. Nella sezione Configurable, fai clic su **GitHub**. Se stai creando la toolchain in {{site.data.keyword.Bluemix_notm}} pubblico e non hai autorizzato {{site.data.keyword.Bluemix_notm}} ad accedere a GitHub, fai clic su **Autorizza** per andare al sito web GitHub. Se non disponi di una sessione GitHub attiva, ti viene richiesto di accedere. Fai clic su **Authorize Application** per consentire a {{site.data.keyword.Bluemix_notm}} di accedere al tuo account GitHub. Se disponi di una sessione GitHub attiva ma non hai immesso la tua password recentemente, ti potrebbe essere richiesto di immettere la tua password GitHub per la conferma. - - b. Rivedi le ubicazioni del repository di destinazione predefinite per i repository GitHub. Questi repository vengono clonati dai repository di esempio. Se necessario, modifica i nomi dei repository di destinazione. - ![Ubicazioni del repository di destinazione predefinite](images/toolchain_github_config.png) - -1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Fai clic sul pulsante di aggiunta (+). -1. Nella sezione Integrazione toolchain, fai clic su **GitHub**. -1. Se disponi di un repository GitHub e desideri utilizzarlo, digita l'URL. Per il tipo di repository, fai clic su **Link**. -1. Se desideri utilizzare un nuovo repository GitHub, immetti un nome per il repository GitHub, l'URL per il repository che stai clonando o dividendo e seleziona il tipo di repository: - - a. Per creare un repository vuoto, fai clic su **New**. - - b. Per creare una copia di un repository GitHub, fai clic su **Clone**. - - c. Per dividere un repository GitHub in modo che puoi contribuire alle modifiche tramite l'inserimento di richieste, fai clic su **Fork**. - -1. Se desideri utilizzare Problemi GitHub per la traccia del problema, seleziona la casella di spunta **Enable GitHub Issues**. -1. Fai clic su **Create Integration**. -1. Fai clic sul tile per il repository GitHub con cui vuoi lavorare. Si apre il sito web GitHub, dove puoi visualizzare i contenuti del repository. - - **Suggerimento**: puoi utilizzare gli strumenti di gestione del codice di origine integrati in Eclipse Orion {{site.data.keyword.webide}} per modificare il repository GitHub e distribuire un'applicazione dal tuo spazio di lavoro. - -1. Se hai abilitato Problemi GitHub, fai clic sul tile per i problemi GitHub per aprirlo. - -Per ulteriori informazioni, consulta [GitHub (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} e [GitHub Issues (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. - - -## Configurazione di Dedicated GitHub Enterprise -{: #configghe} - -{{site.data.keyword.ghe_long}} è un servizio host basato sul web, in loco per i repository Git. Dedicated GitHub Enterprise è solo per i clienti {{site.data.keyword.Bluemix_notm}} dedicato. GitHub Issues è uno strumento di traccia che ti permette di lavorare sui tuoi piani in un solo posto. È integrato con il tuo repository di sviluppo in modo che puoi focalizzarti sulle attività importanti. Per ulteriori informazioni su Dedicated GitHub Enterprise e i problemi GitHub, consulta [Using Dedicated GitHub Enterprise (il link si apre in una nuova finestra)](../services/ghededicated/index.html){: new_window} and [GitHub Issues (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. - -Puoi configurare {{site.data.keyword.ghe_short}} come una integrazione dello strumento nella tua toolchain in modo da poter gestire il codice di origine nella tua istanza [{{site.data.keyword.Bluemix_notm}} dedicato aziendale (il link si apre in una nuova finestra)](../dedicated/index.html#dedicated){: new_window}. - -1. Se stai configurando questa integrazione dello strumento mentre stai creando la toolchain, segui questi passi: - - a. Prima di accedere a Dedicated GitHub Enterprise per la prima volta, chiedi all'amministratore di regione della tua azienda di aggiungere il tuo ID utente alla tua istanza {{site.data.keyword.Bluemix_notm}} dedicato dal registro utenti della tua azienda utilizzando LDAP. Per informazioni sulla configurazione del tuo account {{site.data.keyword.ghe_short}}, consulta [Using Dedicated GitHub Enterprise (il link si apre in una nuova finestra)](../services/ghededicated/index.html){: new_window}. - - b. Nella sezione Configurable, fai clic su **{{site.data.keyword.ghe_short}}**. - - c. Controlla il nome predefinito per il nuovo repository {{site.data.keyword.ghe_short}}. Se necessario, modifica il nome del nuovo repository. La seguente immagine mostra un esempio di un repository clonato da un repository di esempio. Puoi utilizzare un repository esistente o nuovo. Per utilizzare un nuovo repository, puoi creare un repository vuoto, o biforcarne uno. - ![Ubicazioni del repository predefinite](images/toolchain_ghe_config.png) - -1. Se disponi di una toolchain in {{site.data.keyword.Bluemix_notm}} pubblico a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella tua pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. Se stai utilizzando una toolchain in {{site.data.keyword.Bluemix_notm}} dedicato, nel dashboard, fai clic sulla scheda **DEVOPS** e fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Fai clic sul pulsante di aggiunta (+). -1. Nella sezione Integrazione toolchain, fai clic su **{{site.data.keyword.ghe_short}}**. -1. Se disponi di un repository {{site.data.keyword.ghe_short}} e desideri utilizzarlo, digitane l'URL. Per il tipo di repository, fai clic su **Existing**. -1. Se desideri utilizzare un nuovo repository {{site.data.keyword.ghe_short}}, immetti un nome per il repository, l'URL per il repository che stai clonando o dividendo e seleziona il tipo di repository: - - a. Per creare un repository vuoto, fai clic su **New**. - - b. Per creare una copia di un repository, fai clic su **Clone**. - - c. Per dividere un repository in modo che puoi contribuire alle modifiche tramite l'inserimento di richieste, fai clic su **Fork**. - -1. Per utilizzare GitHub Issues per la traccia del problema, seleziona la casella di spunta **Enable GitHub Issues**. -1. Fai clic su **Create Integration**. -1. Fai clic sul tile per il repository {{site.data.keyword.ghe_short}} con cui vuoi lavorare. Si apre la tua istanza [{{site.data.keyword.Bluemix_notm}} dedicato aziendale (il link si apre in una nuova finestra)](../dedicated/index.html#dedicated){: new_window}, dove puoi visualizzare i contenuti del repository. - - **Suggerimento**: puoi utilizzare gli strumenti di gestione del codice di origine integrati in Eclipse Orion {{site.data.keyword.webide}} per modificare il repository {{site.data.keyword.ghe_short}} e distribuire un'applicazione dal tuo spazio di lavoro. - -1. Se hai abilitato Problemi GitHub, fai clic sul tile per GitHub Issues. - - - -## Configurazione di uno strumento personalizzato (altro strumento) -{: #othertool} - -Se il tuo team utilizza uno strumento che non è incluso nell'elenco di integrazioni delle toolchain, puoi integrare uno strumento personalizzato. - -Configura uno strumento personalizzato in modo che funzioni con gli altri strumenti della tua toolchain e sia disponibile per il tuo team: -1. Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su **Altro strumento**. - -1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Fai clic sul pulsante di aggiunta (+). -1. Nella sezione Integrazioni strumento, fai clic su **Altro strumento**. -1. Immetti il nome dello strumento. -1. Seleziona la fase del ciclo di vita strettamente associata allo strumento. La scelta della fase del ciclo di vita determina sotto quale categoria viene elencato lo strumento nella pagina Integrazioni toolchain. -1. Aggiungi un URL icona. L'icona verrà visualizzata nella scheda dell'integrazione strumento. -1. Aggiungi un URL documentazione. -1. Specifica un nome per l'istanza dello strumento. Ad esempio: My Team Tool. -1. Aggiungi un URL istanza dello strumento. Facendo clic sulla scheda di integrazione strumento, si accede all'URL elencato per l'istanza dello strumento. -1. Aggiungi una descrizione dello strumento. -1. (Avanzate) Aggiungi ulteriori proprietà come necessario. Ad esempio, elenca eventuali informazioni o attributi richiesti per integrare il tuo strumento con gli altri strumenti della toolchain. -1. Fai clic su **Create Integration**. - -## Configurazione di PagerDuty -{: #pagerduty} - -PagerDuty integra i dati da più sistemi di monitoraggio in un singola vista. Quando si verifica un problema, PagerDuty si assicura che venga inviata una notifica al membro del team più adatto a risolverlo in quel momento. Se il membro del team non risponde al problema, possono essere configurate delle escalation per instradare il problema agli ingegneri secondari o ai gestori delle operazioni. - -Configura PagerDuty per inviare notifiche quando si verifica un problema nella fase della pipeline in modo che puoi risolvere i problemi più velocemente e ridurre il tempo di inattività: - -1. Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su **PagerDuty**. -1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Fai clic sul pulsante di aggiunta (+). -1. Nella sezione Integrazione toolchain, fai clic su **PagerDuty** -1. Digita il nome del sito PagerDuty associato con il tuo account PagerDuty. Se non disponi di un account PagerDuty, [registrane uno (il link si apre in una nuova finestra)](https://signup.pagerduty.com/accounts/new){: new_window}. -1. Digita la chiave di accesso API per il tuo account PagerDuty. Per istruzioni su come trovare una chiave, consulta [API Authentication (il link si apre in una nuova finestra)](https://signup.pagerduty.com/accounts/new){: new_window}. -1. Digita il nome del tuo servizio PagerDuty. -1. Digita l'indirizzo email per il contatto PagerDuty primario. -1. Digita il numero di telefono del contatto PagerDuty primario. -1. Fai clic su **Create Integration**. -1. Fai clic sul tile per PagerDuty per andare alla pagina pagerduty.com. Puoi visualizzare gli eventi associati al servizio PagerDuty che hai specificato quando hai configurato questa integrazione dello strumento per la tua toolchain. - -Per ulteriori informazioni, consulta [PagerDuty (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}. - - -## Configurazione di Sauce Labs -{: #saucelabs} - -Sauce Labs esegue verifiche di unità funzionali. Quando una suite di verifica Sauce Labs è configurata come un lavoro di verifica nella {{site.data.keyword.deliverypipeline}}, la suite di test può eseguire verifiche sulla tua applicazione mobile o web come parte di un processo di distribuzione continua. Queste verifiche possono fornire un controllo prezioso del flusso per i tuoi progetti, che funzionano come gate per prevenire la distribuzione di codice errato. - -Configura Sauce Labs per eseguire verifiche funzionali automatizzate su più sistemi operativi e browser in modo che puoi emulare la modalità di utilizzo di un sito o di un'applicazione di un utente. - -1. Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su **Sauce Labs**. -1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Fai clic sul pulsante di aggiunta (+). -1. Nella sezione Integrazione toolchain, fai clic su **Sauce Labs**. -1. Digita il nome utente associato con il tuo account Sauce Labs. Puoi [trovare il tuo nome utente nel messaggio di benvenuto all'inizio della tua pagina account Sauce Labs (il link si apre in una nuova finestra)](https://saucelabs.com/account){: new_window}. -1. Digita la chiave di accesso per il tuo account Sauce Labs. Puoi [trovare la chiave nella tua pagina account Sauce Labs (il link si apre in una nuova finestra)](https://saucelabs.com/account){: new_window}. -1. Fai clic su **Create Integration**. -1. Fai clic sul tile per Sauce Labs per andare alla pagina saucelabs.com e visualizzare l'attività di verifica per la toolchain. - - **Suggerimento**: se hai aggiunto un lavoro di verifica Sauce Labs alla {{site.data.keyword.deliverypipeline}}, puoi selezionare l'istanza del servizio. - -Per ulteriori informazioni, consulta [Sauce Labs (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}. - - -## Configurazione di Slack -{: #slack} - -**Importante**: le notifiche pubblicate nei canali Slack pubblici sono visibili a chiunque nel team. Ricorda che sei responsabile del contenuto che pubblichi. - -Slack è un sistema di notifica e messaggistica in tempo reale basato sul cloud. Slack fornisce chat persistente, che è un'alternativa più interattiva alla email per la collaborazione del team. Puoi comunicare con il tuo team su un canale dedicato o su una serie di canali direttamente correlati al tuo lavoro. Puoi inoltre condividere file e immagini tramite i canali o con messaggi diretti tra due o più persone. Le comunicazioni nei messaggi diretti e sui canali vengono conservate in modo che puoi ricercarle. - -Configura Slack per ricevere notifiche sulla tua toolchain dalle integrazioni delle strumento, come ad esempio le attività di distribuzione e verifica: - -1. Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su **Slack**. -1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Fai clic sul pulsante di aggiunta (+). -1. Nella sezione Integrazione toolchain, fai clic su **Slack**. -1. Digita il token di autenticazione API per il tuo account Slack. Devi utilizzare un token di accesso completo generato per l'autenticazione con Slack. Per istruzioni su come trovare il token, consulta [Slack authentication (il link si apre in una nuova finestra)](https://api.slack.com/web#authentication){: new_window}. -1. Digita il nome del canale Slack a cui desideri vengano inviate le notifiche. Se il canale che hai specificato non esiste, viene creato. Se il canale è stato archiviato, viene riattivato. -1. Fai clic su **Create Integration**. -1. Fai clic sul tile per Slack. Puoi visualizzare tutte le attività per la tua toolchain nel canale Slack configurato. - -Per ulteriori informazioni, consulta [Slack (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}. - - - - - - - - +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configurazione delle integrazioni dello strumento +{: #integrations} + +Ultimo aggiornamento: 18 ottobre 2016 +{: .last-updated} + +Puoi configurare le integrazioni dello strumento che supportano le attività di operazioni, sviluppo e distribuzione mentre crei una toolchain o puoi aggiungere e configurare le integrazioni dello strumento per personalizzare una toolchain esistente. +{:shortdesc} + +**Importante**: in {{site.data.keyword.Bluemix_notm}} pubblico, le toolchain sono disponibili solo nella regione degli Stati Uniti Sud. + +Le integrazioni dello strumento disponibili per aggiungere e configurare la tua toolchain sono diverse a seconda se stai utilizzando le toolchain in {{site.data.keyword.Bluemix_notm}} pubblico o {{site.data.keyword.Bluemix_notm}} dedicato. Se stai utilizzando le toolchain in {{site.data.keyword.Bluemix_notm}} dedicato, le integrazioni dello strumento disponibili dipendono dal modo in cui {{site.data.keyword.jazzhub_title}} è stato configurato nel tuo ambiente specifico. + +*Tabella 1. Integrazioni dello strumento disponibili per le toolchain in {{site.data.keyword.Bluemix_notm}} pubblico e dedicato* + +|Integrazione strumento |Disponibile in {{site.data.keyword.Bluemix_notm}} pubblico |Disponibile in {{site.data.keyword.Bluemix_notm}} dedicato (dipendente dall'ambiente)| +|:----------|:------------------------------|:------------------| +|{{site.data.keyword.deliverypipeline}} |Sì |Sì | +|{{site.data.keyword.DRA_short}} |Sì |No | +|Eclipse Orion {{site.data.keyword.webide}} |Sì |Sì | +|GitHub |Sì |Sì | +|Dedicated GitHub Enterprise |No |Sì | +|Altro strumento |Sì |Sì | +|PagerDuty |Sì |Sì | +|Sauce Labs |Sì |No | +|Slack |Sì |Sì | + +**Suggerimento**: se desideri avviare lo sviluppo con il codice di origine in {{site.data.keyword.Bluemix_notm}} pubblico, configura l'integrazione dello strumento GitHub prima di configurare la {{site.data.keyword.deliverypipeline}}. Se desideri avviare lo sviluppo con il codice in {{site.data.keyword.Bluemix_notm}} dedicato, configura l'integrazione dello strumento {{site.data.keyword.ghe_short}} o l'integrazione dello strumento GitHub prima di configurare la {{site.data.keyword.deliverypipeline}}. + + +## Configurazione della delivery pipeline +{: #deliverypipeline} + +La {{site.data.keyword.deliverypipeline}} automatizza la distribuzione continua dei tuoi progetti tramite una sequenza di fasi che richiamano i lavori di input ed esecuzione, come le creazioni, le verifiche e le distribuzioni. + +Configura la {{site.data.keyword.deliverypipeline}} per automatizzare la distribuzione, la verifica e la creazione continua delle tue applicazioni: + +1. Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su **Delivery Pipeline**. A seconda del template che utilizzi, possono essere disponibili diversi campi. Rivedi i valori di campo predefiniti e se necessario, modifica queste impostazioni. +1. Se disponi di una toolchain in {{site.data.keyword.Bluemix_notm}} pubblico a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella tua pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. Se stai utilizzando una toolchain in {{site.data.keyword.Bluemix_notm}} dedicato, nel dashboard, fai clic sulla scheda **DEVOPS** e fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Fai clic sul pulsante di aggiunta (+). +1. Nella sezione Integrazione toolchain, fai clic su **Delivery Pipeline**. +1. Specifica un nome per la tua nuova pipeline. +1. Se stai pianificando di utilizzare la tua pipeline per distribuire un'interfaccia utente, seleziona la casella di spunta **Applicazione visualizzabile**. Tutte le applicazioni create dalla tua pipeline vengono visualizzate nell'elenco **VIEW APP** nella pagina Integrazioni dello strumento della toolchain. +1. Fai clic su **Create Integration** per aggiungere la {{site.data.keyword.deliverypipeline}} alla tua toolchain. +1. Fai clic sul tile per la {{site.data.keyword.deliverypipeline}} per visualizzare la pipeline e configurarla. Per informazioni sulla configurazione di una pipeline, consulta [Building and deploying pipelines (il link si apre in una nuova finestra)](../services/DeliveryPipeline/build_deploy.html){: new_window}. + + **Suggerimento**: se desideri attivare la pipeline quando esegui il push delle modifiche al tuo repository GitHub o {{site.data.keyword.ghe_short}} devi configurare GitHub o {{site.data.keyword.ghe_short}} per la tua toolchain prima di definire le fasi per la tua pipeline. Le fasi della pipeline necessitano di URL Git per i tuoi repository. Ogni fase della pipeline può far riferimento solo a uno dei repository GitHub o {{site.data.keyword.ghe_short}} associato con la tua toolchain. Per istruzioni su come configurare GitHub, consulta la sezione [Problemi GitHub e GitHub](#github). Per istruzioni su come configurare Dedicated GitHub Enterprise, consulta [Getting started with {{site.data.keyword.ghe_long}} (il link si apre in una nuova finestra)](../services/ghededicated/index.html){: new_window}. + +1. Facoltativo: se stai utilizzando una toolchain in {{site.data.keyword.Bluemix_notm}} pubblico e desideri che Sauce Labs esegua delle verifiche sulla tua applicazione, configura la {{site.data.keyword.deliverypipeline}} per aggiungere un lavoro di verifica Sauce Labs. Per istruzioni sulla configurazione del lavoro di verifica, consulta la sezione [Configurazione di un lavoro di verifica Sauce Labs nella tua pipeline](#config_saucelabs). + +### Configurazione di un lavoro di verifica Sauce Labs nella tua pipeline +{: #config_saucelabs} + +Prima di configurare un lavoro di verifica Sauce Labs nella tua pipeline, devi disporre di una pipeline funzionante provvista di fasi per creare e distribuire la tua applicazione e devi configurare Sauce Labs per la tua toolchain. Per istruzioni sulla configurazione di Sauce Labs, consulta la sezione [Sauce Labs](#saucelabs). + +Configura la {{site.data.keyword.deliverypipeline}} per aggiungere un lavoro di verifica Sauce Labs: + +1. Se non disponi di una fase che distribuisce una versione di verifica della tua applicazione, creane una. +1. Nella fase, aggiungi un lavoro di verifica dopo il lavoro di distribuzione. Posizionando questi lavori nella stessa fase, essi possono accedere alla stessa serie di proprietà di ambiente. + ![Lavoro di verifica](images/toolchain_test_job.png) + +1. Configura la fase: + + a. Nella scheda **PROPRIETÀ AMBIENTE**, crea tre proprietà: CF_APP_NAME, SAUCE_USERNAME e SAUCE_ACCESS_KEY. + + b. Immetti il nome utente e la chiave di accesso Sauce Labs. In questo modo esternalizzi questi valori così da poterli utilizzare nelle tue verifiche. + +1. Configura il lavoro di distribuzione. Nel campo **Deploy Script**, includi questo comando: `export CF_APP_NAME="$CF_APP"`. Questo comando esporta il nome dell'applicazione come una proprietà di ambiente. +1. Configura il lavoro di verifica. I valori nella seguente immagine sono degli esempi. I campi **Istanza del servizio**, **Destinazione**, **Organizzazione** e **Spazio** vengono popolati con il nome utente, la regione, l'organizzazione e lo spazio Sauce Labs che stai utilizzando. +![Configura lavoro](images/toolchain_configure_job.png) + + a. Per il tipo di verifica, seleziona **Sauce Labs**. + + b. Per il servizio dell'istanza, seleziona il nome utente Sauce Labs che hai utilizzato nella configurazione di Sauce Labs per la tua toolchain. + + **Suggerimento**: per visualizzare il nome utente e la chiave di accesso che hai utilizzato nella configurazione di Sauce Labs per la tua toolchain, fai clic su **Configura**. + + c. Nel campo **Test Execution Command**, immetti i comandi per installare le dipendenze necessarie per le tue verifiche e quindi eseguile. Ad esempio, per un'applicazione Node.js, devi immettere questi comandi: + ``` + npm install + node_modules/grunt-cli/bin/grunt test:sauce:parallel + ``` + + d. Se desideri visualizzare i report di verifica nei log del lavoro di verifica, seleziona la casella di spunta **Enable Test Report** e imposta il pattern del file dei risultati della verifica su `test/*.xml`. + +1. Fai clic su **SAVE**. Se la tua pipeline è in esecuzione, puoi eseguire le tue verifiche Sauce Labs. + +Per ulteriori informazioni, consulta [Delivery Pipeline (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}. + + +## Aggiunta di {{site.data.keyword.DRA_short}} +{: #dra} + +{{site.data.keyword.DRA_full}} raccoglie e analizza i risultati dalle verifiche di unità, dalle verifiche funzionali e dagli strumenti di copertura del codice per determinare se il tuo codice soddisfa i criteri predefiniti nei gate specificati nel tuo processo di distribuzione. Se il tuo codice non soddisfa o supera i criteri, la distribuzione viene arrestata per prevenire che vengano rilasciati dei rischi. Puoi utilizzare {{site.data.keyword.DRA_short}} come una rete di sicurezza per il tuo ambiente di distribuzione continua o come modo per implementare e migliorare gli standard di qualità. + + **Nota**: questa integrazione dello strumento è preconfigurata. Non richiede alcun parametro di configurazione e non puoi riconfigurarla. + +Aggiungi {{site.data.keyword.DRA_short}} per mantenere e migliorare la qualità del tuo codice {{site.data.keyword.Bluemix_notm}} monitorando le tue distribuzioni per identificare i rischi prima che vangano rilasciati. + +1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Fai clic sul pulsante di aggiunta (+). +1. Nella sezione Integrazione toolchain, fai clic su **Deployment Risk Analytics**. +1. Fai clic su **Create Integration**. +1. Fai clic sul tile per {{site.data.keyword.DRA_short}} e quindi completa i primi passi: creazione dei criteri, connessione dei criteri alla pipeline ed esecuzione della pipeline. Per ulteriori informazioni, consulta [{{site.data.keyword.DRA_short}} (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}. + + +## Aggiunta di Eclipse Orion {{site.data.keyword.webide}} +{: #webide} + +Eclipse Orion {{site.data.keyword.webide}} è un ambiente basato sul web integrato dove puoi creare, modificare, eseguire il debug e completare le attività di controllo dell'origine. Puoi spostare senza interruzioni dalla modifica per l'esecuzione, l'invio e la distribuzione. + + **Nota**: questa integrazione dello strumento è preconfigurata. Non richiede alcun parametro di configurazione e non puoi riconfigurarla. + +Aggiungi l'integrazione dello strumento Eclipse Orion {{site.data.keyword.webide}} per completare le attività di controllo dell'origine: + +1. Se disponi di una toolchain in {{site.data.keyword.Bluemix_notm}} pubblico a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. Se stai utilizzando una toolchain in {{site.data.keyword.Bluemix_notm}} dedicato, nel dashboard, fai clic sulla scheda **DEVOPS** e fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Fai clic sul pulsante di aggiunta (+). +1. Nella sezione Integrazione toolchain, fai clic su **Eclipse Orion Web IDE**. +1. Fai clic su **Create Integration**. +1. Fai clic sul tile per la nuova Eclipse Orion {{site.data.keyword.webide}}. Il tuo spazio di lavoro viene prepopolato con i repository GitHub o {{site.data.keyword.ghe_short}}. I repository associati con la tua toolchain corrente sono evidenziati. + +Per ulteriori informazioni, consulta [Modifica del codice con l'IDE web Eclipse Orion {{site.data.keyword.webide}} (il link si apre in una nuova finestra)](../toolchains/web_ide.html){: new_window}. + + +## Configurazione di GitHub +{: #github} + +GitHub è un servizio host basato sul web per i repository Git. Puoi avere sia copie locali che remote dei tuoi repository, ciò rende più semplice la collaborazione. + +Problemi GitHub è uno strumento di traccia che ti permette di lavorare sui tuoi piani in un solo posto. È integrato con il tuo repository di sviluppo in modo che puoi focalizzarti sulle attività importanti. + +Configura GitHub per gestire il tuo codice di origine nel cloud: + +1. Se stai configurando questa integrazione dello strumento mentre stai creando la toolchain, segui questi passi: + + a. Nella sezione Configurable, fai clic su **GitHub**. Se stai creando la toolchain in {{site.data.keyword.Bluemix_notm}} pubblico e non hai autorizzato {{site.data.keyword.Bluemix_notm}} ad accedere a GitHub, fai clic su **Autorizza** per andare al sito web GitHub. Se non disponi di una sessione GitHub attiva, ti viene richiesto di accedere. Fai clic su **Authorize Application** per consentire a {{site.data.keyword.Bluemix_notm}} di accedere al tuo account GitHub. Se disponi di una sessione GitHub attiva ma non hai immesso la tua password recentemente, ti potrebbe essere richiesto di immettere la tua password GitHub per la conferma. + + b. Rivedi le ubicazioni del repository di destinazione predefinite per i repository GitHub. Questi repository vengono clonati dai repository di esempio. Se necessario, modifica i nomi dei repository di destinazione. + ![Ubicazioni del repository di destinazione predefinite](images/toolchain_github_config.png) + +1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Fai clic sul pulsante di aggiunta (+). +1. Nella sezione Integrazione toolchain, fai clic su **GitHub**. +1. Se disponi di un repository GitHub e desideri utilizzarlo, digita l'URL. Per il tipo di repository, fai clic su **Link**. +1. Se desideri utilizzare un nuovo repository GitHub, immetti un nome per il repository GitHub, l'URL per il repository che stai clonando o dividendo e seleziona il tipo di repository: + + a. Per creare un repository vuoto, fai clic su **New**. + + b. Per creare una copia di un repository GitHub, fai clic su **Clone**. + + c. Per dividere un repository GitHub in modo che puoi contribuire alle modifiche tramite l'inserimento di richieste, fai clic su **Fork**. + +1. Se desideri utilizzare Problemi GitHub per la traccia del problema, seleziona la casella di spunta **Enable GitHub Issues**. +1. Fai clic su **Create Integration**. +1. Fai clic sul tile per il repository GitHub con cui vuoi lavorare. Si apre il sito web GitHub, dove puoi visualizzare i contenuti del repository. + + **Suggerimento**: puoi utilizzare gli strumenti di gestione del codice di origine integrati in Eclipse Orion {{site.data.keyword.webide}} per modificare il repository GitHub e distribuire un'applicazione dal tuo spazio di lavoro. + +1. Se hai abilitato Problemi GitHub, fai clic sul tile per i problemi GitHub per aprirlo. + +Per ulteriori informazioni, consulta [GitHub (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} e [GitHub Issues (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. + + +## Configurazione di Dedicated GitHub Enterprise +{: #configghe} + +{{site.data.keyword.ghe_long}} è un servizio host basato sul web, in loco per i repository Git. Dedicated GitHub Enterprise è solo per i clienti {{site.data.keyword.Bluemix_notm}} dedicato. GitHub Issues è uno strumento di traccia che ti permette di lavorare sui tuoi piani in un solo posto. È integrato con il tuo repository di sviluppo in modo che puoi focalizzarti sulle attività importanti. Per ulteriori informazioni su Dedicated GitHub Enterprise e i problemi GitHub, consulta [Using Dedicated GitHub Enterprise (il link si apre in una nuova finestra)](../services/ghededicated/index.html){: new_window} and [GitHub Issues (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. + +Puoi configurare {{site.data.keyword.ghe_short}} come una integrazione dello strumento nella tua toolchain in modo da poter gestire il codice di origine nella tua istanza [{{site.data.keyword.Bluemix_notm}} dedicato aziendale (il link si apre in una nuova finestra)](../dedicated/index.html#dedicated){: new_window}. + +1. Se stai configurando questa integrazione dello strumento mentre stai creando la toolchain, segui questi passi: + + a. Prima di accedere a Dedicated GitHub Enterprise per la prima volta, chiedi all'amministratore di regione della tua azienda di aggiungere il tuo ID utente alla tua istanza {{site.data.keyword.Bluemix_notm}} dedicato dal registro utenti della tua azienda utilizzando LDAP. Per informazioni sulla configurazione del tuo account {{site.data.keyword.ghe_short}}, consulta [Using Dedicated GitHub Enterprise (il link si apre in una nuova finestra)](../services/ghededicated/index.html){: new_window}. + + b. Nella sezione Configurable, fai clic su **{{site.data.keyword.ghe_short}}**. + + c. Controlla il nome predefinito per il nuovo repository {{site.data.keyword.ghe_short}}. Se necessario, modifica il nome del nuovo repository. La seguente immagine mostra un esempio di un repository clonato da un repository di esempio. Puoi utilizzare un repository esistente o nuovo. Per utilizzare un nuovo repository, puoi creare un repository vuoto, o biforcarne uno. + ![Ubicazioni del repository predefinite](images/toolchain_ghe_config.png) + +1. Se disponi di una toolchain in {{site.data.keyword.Bluemix_notm}} pubblico a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella tua pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. Se stai utilizzando una toolchain in {{site.data.keyword.Bluemix_notm}} dedicato, nel dashboard, fai clic sulla scheda **DEVOPS** e fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Fai clic sul pulsante di aggiunta (+). +1. Nella sezione Integrazione toolchain, fai clic su **{{site.data.keyword.ghe_short}}**. +1. Se disponi di un repository {{site.data.keyword.ghe_short}} e desideri utilizzarlo, digitane l'URL. Per il tipo di repository, fai clic su **Existing**. +1. Se desideri utilizzare un nuovo repository {{site.data.keyword.ghe_short}}, immetti un nome per il repository, l'URL per il repository che stai clonando o dividendo e seleziona il tipo di repository: + + a. Per creare un repository vuoto, fai clic su **New**. + + b. Per creare una copia di un repository, fai clic su **Clone**. + + c. Per dividere un repository in modo che puoi contribuire alle modifiche tramite l'inserimento di richieste, fai clic su **Fork**. + +1. Per utilizzare GitHub Issues per la traccia del problema, seleziona la casella di spunta **Enable GitHub Issues**. +1. Fai clic su **Create Integration**. +1. Fai clic sul tile per il repository {{site.data.keyword.ghe_short}} con cui vuoi lavorare. Si apre la tua istanza [{{site.data.keyword.Bluemix_notm}} dedicato aziendale (il link si apre in una nuova finestra)](../dedicated/index.html#dedicated){: new_window}, dove puoi visualizzare i contenuti del repository. + + **Suggerimento**: puoi utilizzare gli strumenti di gestione del codice di origine integrati in Eclipse Orion {{site.data.keyword.webide}} per modificare il repository {{site.data.keyword.ghe_short}} e distribuire un'applicazione dal tuo spazio di lavoro. + +1. Se hai abilitato Problemi GitHub, fai clic sul tile per GitHub Issues. + + + +## Configurazione di uno strumento personalizzato (altro strumento) +{: #othertool} + +Se il tuo team utilizza uno strumento che non è incluso nell'elenco di integrazioni delle toolchain, puoi integrare uno strumento personalizzato. + +Configura uno strumento personalizzato in modo che funzioni con gli altri strumenti della tua toolchain e sia disponibile per il tuo team: +1. Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su **Altro strumento**. + +1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Fai clic sul pulsante di aggiunta (+). +1. Nella sezione Integrazioni strumento, fai clic su **Altro strumento**. +1. Immetti il nome dello strumento. +1. Seleziona la fase del ciclo di vita strettamente associata allo strumento. La scelta della fase del ciclo di vita determina sotto quale categoria viene elencato lo strumento nella pagina Integrazioni toolchain. +1. Aggiungi un URL icona. L'icona verrà visualizzata nella scheda dell'integrazione strumento. +1. Aggiungi un URL documentazione. +1. Specifica un nome per l'istanza dello strumento. Ad esempio: My Team Tool. +1. Aggiungi un URL istanza dello strumento. Facendo clic sulla scheda di integrazione strumento, si accede all'URL elencato per l'istanza dello strumento. +1. Aggiungi una descrizione dello strumento. +1. (Avanzate) Aggiungi ulteriori proprietà come necessario. Ad esempio, elenca eventuali informazioni o attributi richiesti per integrare il tuo strumento con gli altri strumenti della toolchain. +1. Fai clic su **Create Integration**. + +## Configurazione di PagerDuty +{: #pagerduty} + +PagerDuty integra i dati da più sistemi di monitoraggio in un singola vista. Quando si verifica un problema, PagerDuty si assicura che venga inviata una notifica al membro del team più adatto a risolverlo in quel momento. Se il membro del team non risponde al problema, possono essere configurate delle escalation per instradare il problema agli ingegneri secondari o ai gestori delle operazioni. + +Configura PagerDuty per inviare notifiche quando si verifica un problema nella fase della pipeline in modo che puoi risolvere i problemi più velocemente e ridurre il tempo di inattività: + +1. Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su **PagerDuty**. +1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Fai clic sul pulsante di aggiunta (+). +1. Nella sezione Integrazione toolchain, fai clic su **PagerDuty** +1. Digita il nome del sito PagerDuty associato con il tuo account PagerDuty. Se non disponi di un account PagerDuty, [registrane uno (il link si apre in una nuova finestra)](https://signup.pagerduty.com/accounts/new){: new_window}. +1. Digita la chiave di accesso API per il tuo account PagerDuty. Per istruzioni su come trovare una chiave, consulta [API Authentication (il link si apre in una nuova finestra)](https://signup.pagerduty.com/accounts/new){: new_window}. +1. Digita il nome del tuo servizio PagerDuty. +1. Digita l'indirizzo email per il contatto PagerDuty primario. +1. Digita il numero di telefono del contatto PagerDuty primario. +1. Fai clic su **Create Integration**. +1. Fai clic sul tile per PagerDuty per andare alla pagina pagerduty.com. Puoi visualizzare gli eventi associati al servizio PagerDuty che hai specificato quando hai configurato questa integrazione dello strumento per la tua toolchain. + +Per ulteriori informazioni, consulta [PagerDuty (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}. + + +## Configurazione di Sauce Labs +{: #saucelabs} + +Sauce Labs esegue verifiche di unità funzionali. Quando una suite di verifica Sauce Labs è configurata come un lavoro di verifica nella {{site.data.keyword.deliverypipeline}}, la suite di test può eseguire verifiche sulla tua applicazione mobile o web come parte di un processo di distribuzione continua. Queste verifiche possono fornire un controllo prezioso del flusso per i tuoi progetti, che funzionano come gate per prevenire la distribuzione di codice errato. + +Configura Sauce Labs per eseguire verifiche funzionali automatizzate su più sistemi operativi e browser in modo che puoi emulare la modalità di utilizzo di un sito o di un'applicazione di un utente. + +1. Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su **Sauce Labs**. +1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Fai clic sul pulsante di aggiunta (+). +1. Nella sezione Integrazione toolchain, fai clic su **Sauce Labs**. +1. Digita il nome utente associato con il tuo account Sauce Labs. Puoi [trovare il tuo nome utente nel messaggio di benvenuto all'inizio della tua pagina account Sauce Labs (il link si apre in una nuova finestra)](https://saucelabs.com/account){: new_window}. +1. Digita la chiave di accesso per il tuo account Sauce Labs. Puoi [trovare la chiave nella tua pagina account Sauce Labs (il link si apre in una nuova finestra)](https://saucelabs.com/account){: new_window}. +1. Fai clic su **Create Integration**. +1. Fai clic sul tile per Sauce Labs per andare alla pagina saucelabs.com e visualizzare l'attività di verifica per la toolchain. + + **Suggerimento**: se hai aggiunto un lavoro di verifica Sauce Labs alla {{site.data.keyword.deliverypipeline}}, puoi selezionare l'istanza del servizio. + +Per ulteriori informazioni, consulta [Sauce Labs (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}. + + +## Configurazione di Slack +{: #slack} + +**Importante**: le notifiche pubblicate nei canali Slack pubblici sono visibili a chiunque nel team. Ricorda che sei responsabile del contenuto che pubblichi. + +Slack è un sistema di notifica e messaggistica in tempo reale basato sul cloud. Slack fornisce chat persistente, che è un'alternativa più interattiva alla email per la collaborazione del team. Puoi comunicare con il tuo team su un canale dedicato o su una serie di canali direttamente correlati al tuo lavoro. Puoi inoltre condividere file e immagini tramite i canali o con messaggi diretti tra due o più persone. Le comunicazioni nei messaggi diretti e sui canali vengono conservate in modo che puoi ricercarle. + +Configura Slack per ricevere notifiche sulla tua toolchain dalle integrazioni delle strumento, come ad esempio le attività di distribuzione e verifica: + +1. Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su **Slack**. +1. Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, nella pagina **Toolchain** del dashboard DevOps, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Fai clic sul pulsante di aggiunta (+). +1. Nella sezione Integrazione toolchain, fai clic su **Slack**. +1. Digita il token di autenticazione API per il tuo account Slack. Devi utilizzare un token di accesso completo generato per l'autenticazione con Slack. Per istruzioni su come trovare il token, consulta [Slack authentication (il link si apre in una nuova finestra)](https://api.slack.com/web#authentication){: new_window}. +1. Digita il nome del canale Slack a cui desideri vengano inviate le notifiche. Se il canale che hai specificato non esiste, viene creato. Se il canale è stato archiviato, viene riattivato. +1. Fai clic su **Create Integration**. +1. Fai clic sul tile per Slack. Puoi visualizzare tutte le attività per la tua toolchain nel canale Slack configurato. + +Per ulteriori informazioni, consulta [Slack (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}. + + + + + + + + diff --git a/toolchains/nl/it/toolchains_overview.md b/toolchains/nl/it/toolchains_overview.md index 1f27de5a1..f3ea642f4 100644 --- a/toolchains/nl/it/toolchains_overview.md +++ b/toolchains/nl/it/toolchains_overview.md @@ -1,160 +1,160 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Introduzione alle toolchain (Beta) -{: #toolchains_getting_started} - -Ultimo aggiornamento: 7 ottobre 2016 -{: .last-updated} - -Le toolchain sono disponibili negli ambienti pubblico e dedicato in {{site.data.keyword.Bluemix}}. Puoi creare una toolchain in due modi: utilizzando un template per creare una toolchain o creando una toolchain da un'applicazione. In {{site.data.keyword.Bluemix_notm}} pubblico, le toolchain sono disponibili solo nella regione degli Stati Uniti Sud. -{: shortdesc} - -##Introduzione alle toolchain: pubblico -{: #getting_started_public} - -**Nota:** assicurati di lavorare nella Nuova esperienza Bluemix controllando il banner superiore. - - * Se vedi un messaggio che indica di provare il nuovo Bluemix, stai lavorando nell'esperienza classica di Bluemix. Fai clic sul link per aprire la Nuova esperienza Bluemix. - * Se non vedi tale messaggio, stai già lavorando nella Nuova esperienza Bluemix. - -Ogni toolchain è associata a un'organizzazione (org) specifica e ogni utente che è membro di tale organizzazione può accedere alle toolchain associate. Prima di creare una toolchain, assicurati di lavorare nell'organizzazione in cui desideri creare la toolchain. L'organizzazione in cui stai attualmente lavorando è visualizzata nella barra dei menu. Per passare a un'altra organizzazione, fai clic sull'organizzazione nella barra dei menu e seleziona quella a cui vuoi passare. - -###Creazione di una toolchain da un template -{: #creating_a_toolchain_from_a_template} - -Puoi utilizzare un template come punto di partenza nella creazione di una toolchain che includa una serie specifica di integrazioni dello strumento. - -1. Se stai creando la tua prima toolchain, assicurati che tali toolchain siano abilitate nella tua organizzazione: - 1. Apri il dashboard DevOps e fai clic sulla pagina **Toolchain**. - 2. Se viene visualizzato il pulsante **Enable Toolchains**, fai clic su di esso e segui le istruzioni per creare la tua toolchain. - 3. Se non viene visualizzato il pulsante **Enable Toolchains**, le toolchain sono già abilitate. Continua con il passo 2. -1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic sul pulsante (+) per creare una toolchain. -1. Fai clic su un template toolchain. Ad esempio, per utilizzare un esempio di archivio online per creare una toolchain, fai clic su **Microservices toolchain**. -1. Nella pagina di creazione della toolchain, rivedi il diagramma della toolchain che stai per creare. Il diagramma mostra ogni integrazione dello strumento nella fase del suo ciclo di vita nella toolchain. Il diagramma nella seguente immagine è un esempio. Quando crei una toolchain, il diagramma mostra ogni integrazione dello strumento che fa parte della toolchain. -![Diagramma della toolchain](images/toolchain_diagram.png) - -1. Rivedi le informazioni predefinite per la configurazione della toolchain. Il nome della toolchain la identifica in {{site.data.keyword.Bluemix_notm}}. Se già hai una toolchain con lo stesso nome o se desideri utilizzare un nome differente, modifica il nome della toolchain. -1. Nella sezione Integrazioni configurabili, seleziona ogni integrazione dello strumento che desideri configurare per la tua toolchain. Le stesse integrazioni dello strumento non richiedono alcuna configurazione. Per informazioni sulla configurazione delle integrazioni dello strumento, consulta [Configuring tool integrations (il link si apre in una nuova finestra)](../toolchains/toolchains_integrations.html){: new_window}. -1. Fai clic su **Create**. Diversi passi vengono eseguiti automaticamente per configurare la tua toolchain: - - * La toolchain viene creata. - * Se hai configurato l'integrazione dello strumento Delivery Pipeline, le pipeline vengono attivate. - * Se hai configurato l'integrazione dello strumento Sauce Labs, l'integrazione Sauce Labs viene configurata per aggiungere lavori alle pipeline e per eseguire verifiche. - * Se hai configurato l'integrazione dello strumento PagerDuty, l'integrazione PagerDuty viene configurata per inviare notifiche al canale configurato in Slack. Queste notifiche indicano quando si verifica un problema. - * Se hai configurato l'integrazione dello strumento Slack, l'integrazione Slack viene configurata per inviare notifiche al canale configurato in Slack. Queste notifiche indicano l'avanzamento della distribuzione; ad esempio, `Connected with Project XYZ`, `Pipeline Configured` e `Stage 'build' started`. - * Se hai configurato l'integrazione dello strumento GitHub, il repository GitHub di esempio viene clonato nel tuo account GitHub. - - -###Creazione di una toolchain da un applicazione -{: #creating_a_toolchain_from_an_app} - -Puoi creare una toolchain dalla tua applicazione. La toolchain può supportare il monitoraggio, la distribuzione e lo sviluppo continuo ed anche altro, e viene associata alla tua applicazione. Ogni applicazione può essere associata con una toolchain. Quando esegui il push delle modifiche a un repository GitHub della toolchain, la pipeline automaticamente crea e distribuisce l'applicazione. - -1. Se stai creando la tua prima toolchain, assicurati che tali toolchain siano abilitate nella tua organizzazione: - 1. Apri il dashboard DevOps e fai clic sulla pagina **Toolchain**. - 2. Se viene visualizzato il pulsante **Enable Toolchains**, fai clic su di esso e segui le istruzioni per creare la tua toolchain. - 3. Se non viene visualizzato il pulsante **Enable Toolchains**, le toolchain sono già abilitate. Continua con il passo 2. -1. Nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **Abilita**. In alternativa, nella modalità classica di {{site.data.keyword.Bluemix_notm}}, nell'angolo in alto a destra della pagina della panoramica della tua applicazione, fai clic su **Add Toolchain**. La tua applicazione è configurata per la distribuzione continua da un nuovo repository GitHub che viene popolato con il codice starter dell'applicazione. -1. Nella pagina di creazione della toolchain, rivedi il diagramma della toolchain che stai per creare. Il diagramma mostra ogni integrazione dello strumento nella fase del suo ciclo di vita nella toolchain. -1. Rivedi le informazioni predefinite per la configurazione della toolchain. Il nome della toolchain la identifica in {{site.data.keyword.Bluemix_notm}}. Se già hai una toolchain con lo stesso nome o se desideri utilizzare un nome differente, modifica il nome della toolchain. -1. Nella sezione Integrazioni configurabili, seleziona ogni integrazione dello strumento che desideri configurare per la tua toolchain. Le stesse integrazioni dello strumento non richiedono alcuna configurazione. Per informazioni sulla configurazione delle integrazioni dello strumento, consulta [Configuring tool integrations (il link si apre in una nuova finestra)](../toolchains/toolchains_integrations.html){: new_window}. -1. Fai clic su **Create**. Diversi passi vengono eseguiti automaticamente per configurare la tua toolchain: - - * La toolchain viene creata. - * Se hai configurato l'integrazione dello strumento Delivery Pipeline, le pipeline vengono attivate. - * Se hai configurato l'integrazione dello strumento Sauce Labs, l'integrazione Sauce Labs viene configurata per aggiungere lavori alle pipeline e per eseguire verifiche. - * Se hai configurato l'integrazione dello strumento PagerDuty, l'integrazione PagerDuty viene configurata per inviare notifiche al canale configurato in Slack. Queste notifiche indicano quando si verifica un problema. - * Se hai configurato l'integrazione dello strumento Slack, l'integrazione Slack viene configurata per inviare notifiche al canale configurato in Slack. Queste notifiche indicano l'avanzamento della distribuzione; ad esempio, `Connected with Project XYZ`, `Pipeline Configured` e `Stage 'build' started`. - * Se hai configurato l'integrazione dello strumento GitHub, il repository GitHub di esempio viene clonato nel tuo account GitHub. - - -##Introduzione alle toolchain: dedicato -{: #getting_started_dedicated} - -Ogni toolchain è associata a un'organizzazione (org) specifica e ogni utente che è membro di tale organizzazione può accedere alle toolchain associate. Prima di creare una toolchain, fai clic sull'icona **{{site.data.keyword.avatar}}** ![Icona Avatar](../icons/i-avatar-icon.svg) nella barra del menu per aprire il widget Account e supporto e visualizza l'organizzazione con cui stai lavorando. Se tale organizzazione non è l'organizzazione dove desideri creare la toolchain, passa a un'altra organizzazione. - -###Creazione di una toolchain da un template -{: #creating_a_toolchain_from_a_template_dedicated} - -Puoi utilizzare un template come punto di partenza nella creazione di una toolchain che includa una serie specifica di integrazioni dello strumento. - -1. Se stai creando la tua prima toolchain, assicurati che tali toolchain siano abilitate nella tua organizzazione: - 1. Apri il dashboard DevOps e fai clic sulla scheda **Toolchains**. - 2. Se viene visualizzato il pulsante **Enable Toolchains**, fai clic su di esso e segui le istruzioni per creare la tua toolchain. - 3. Se non viene visualizzato il pulsante **Enable Toolchains**, le toolchain sono già abilitate. Continua con il passo 2. -1. Nel dashboard {{site.data.keyword.Bluemix_notm}}, nella scheda **DEVOPS**, fai clic sul pulsante (+) per creare una toolchain. -1. Fai clic su un template toolchain. Ad esempio, per creare una toolchain semplice per distribuire una nuova applicazione Cloud Foundry, fai clic su **Simple Cloud Foundry toolchain**. -1. Nella pagina di creazione della toolchain, rivedi il diagramma della toolchain che stai per creare. Il diagramma mostra ogni integrazione dello strumento nella fase del suo ciclo di vita nella toolchain. Il diagramma nella seguente immagine è un esempio. Quando crei una toolchain, il diagramma mostra ogni integrazione dello strumento che fa parte della toolchain. -![Diagramma toolchain dedicato](images/toolchain_dedicated_diagram.png) - -1. Rivedi le informazioni predefinite per la configurazione della toolchain. Il nome della toolchain la identifica in {{site.data.keyword.Bluemix_notm}}. Se già hai una toolchain con lo stesso nome o se desideri utilizzare un nome differente, modifica il nome della toolchain. -1. Nella sezione Integrazioni configurabili, seleziona ogni integrazione dello strumento che desideri configurare per la tua toolchain. Le stesse integrazioni dello strumento non richiedono alcuna configurazione. Per informazioni sulla configurazione delle integrazioni dello strumento, consulta [Configuring tool integrations (il link si apre in una nuova finestra)](../toolchains/toolchains_integrations.html){: new_window}. -1. Fai clic su **Create**. Diversi passi vengono eseguiti automaticamente per configurare la tua toolchain: - - * La toolchain viene creata. - * Se hai configurato l'integrazione dello strumento Delivery Pipeline, le pipeline vengono attivate. - * Se hai configurato l'integrazione dello strumento GitHub Enterprise, il repository GitHub Enterprise di esempio viene clonato nel tuo account GitHub. - - -###Creazione di una toolchain da un applicazione -{: #creating_a_toolchain_from_an_app_dedicated} - -Puoi creare una toolchain dalla tua applicazione. La toolchain può supportare il monitoraggio, la distribuzione e lo sviluppo continuo ed anche altro, e viene associata alla tua applicazione. Ogni applicazione può essere associata con una toolchain. Quando esegui il push delle modifiche a un repository GitHub Enterprise della toolchain, la pipeline automaticamente crea e distribuisce l'applicazione. - -1. Se stai creando la tua prima toolchain, assicurati che tali toolchain siano abilitate nella tua organizzazione: - 1. Apri il dashboard DevOps e fai clic sulla scheda **Toolchains**. - 2. Se viene visualizzato il pulsante **Enable Toolchains**, fai clic su di esso e segui le istruzioni per creare la tua toolchain. - 3. Se non viene visualizzato il pulsante **Enable Toolchains**, le toolchain sono già abilitate. Continua con il passo 2. -1. Nell'angolo in alto a destra della pagina di panoramica della tua applicazione, fai clic su **Add Toolchain**. La tua applicazione è configurata per la distribuzione continua da un nuovo repository GitHub Enterprise che viene popolato con il codice starter dell'applicazione. -1. Nella pagina di creazione della toolchain, rivedi il diagramma della toolchain che stai per creare. Il diagramma mostra ogni integrazione dello strumento nella fase del suo ciclo di vita nella toolchain. -1. Rivedi le informazioni predefinite per la configurazione della toolchain. Il nome della toolchain la identifica in {{site.data.keyword.Bluemix_notm}}. Se già hai una toolchain con lo stesso nome o se desideri utilizzare un nome differente, modifica il nome della toolchain. -1. Nella sezione Integrazioni configurabili, seleziona ogni integrazione dello strumento che desideri configurare per la tua toolchain. Le stesse integrazioni dello strumento non richiedono alcuna configurazione. Per informazioni sulla configurazione delle integrazioni dello strumento, consulta [Configuring tool integrations (il link si apre in una nuova finestra)](../toolchains/toolchains_integrations.html){: new_window}. -1. Fai clic su **Create**. Diversi passi vengono eseguiti automaticamente per configurare la tua toolchain: - - * La toolchain viene creata. - * Se hai configurato l'integrazione dello strumento Delivery Pipeline, le pipeline vengono attivate. - * Se hai configurato l'integrazione dello strumento GitHub Enterprise, il repository GitHub Enterprise di esempio viene clonato nel tuo account GitHub. - - -##Visualizzazione di una toolchain -{: #viewing_a_toolchain} - -Dopo che la toolchain e tutte le integrazioni dello strumento sono state configurate, puoi visualizzare una rappresentazione grafica della toolchain nella pagina Integrazioni dello strumento. - -* Se utilizzi {{site.data.keyword.Bluemix_notm}} pubblico, nella pagina **Toolchain** del dashboard DevOps, fai clic su una toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. - -* Se utilizzi {{site.data.keyword.Bluemix_notm}} dedicato, nel dashboard, fai clic sulla scheda **DEVOPS** e fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. - -* Per accedere all'integrazione dello strumento nella tua toolchain, fai clic sul tile dello strumento. - - **Suggerimento**: se disponi di più di un repository GitHub o GitHub Enterprise, puoi avere più tile per la stessa integrazione dello strumento perché ogni repository è rappresentato dal proprio tile. - - - - - -# Link correlati -{: #rellinks} - -## Esercitazioni ed esempi -{: #samples} - -* [Create an application with three microservices (Beta) (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} -* [Create a toolchain from a template on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} -* [Create a toolchain from an app on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} - -## Link correlati -{: #general} - -* [Microservices toolchain (Beta) (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} -* [Simple toolchain (Beta) (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} -* [IBM Bluemix Garage Method (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method){:new_window} +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Introduzione alle toolchain (Beta) +{: #toolchains_getting_started} + +Ultimo aggiornamento: 7 ottobre 2016 +{: .last-updated} + +Le toolchain sono disponibili negli ambienti pubblico e dedicato in {{site.data.keyword.Bluemix}}. Puoi creare una toolchain in due modi: utilizzando un template per creare una toolchain o creando una toolchain da un'applicazione. In {{site.data.keyword.Bluemix_notm}} pubblico, le toolchain sono disponibili solo nella regione degli Stati Uniti Sud. +{: shortdesc} + +##Introduzione alle toolchain: pubblico +{: #getting_started_public} + +**Nota:** assicurati di lavorare nella Nuova esperienza Bluemix controllando il banner superiore. + + * Se vedi un messaggio che indica di provare il nuovo Bluemix, stai lavorando nell'esperienza classica di Bluemix. Fai clic sul link per aprire la Nuova esperienza Bluemix. + * Se non vedi tale messaggio, stai già lavorando nella Nuova esperienza Bluemix. + +Ogni toolchain è associata a un'organizzazione (org) specifica e ogni utente che è membro di tale organizzazione può accedere alle toolchain associate. Prima di creare una toolchain, assicurati di lavorare nell'organizzazione in cui desideri creare la toolchain. L'organizzazione in cui stai attualmente lavorando è visualizzata nella barra dei menu. Per passare a un'altra organizzazione, fai clic sull'organizzazione nella barra dei menu e seleziona quella a cui vuoi passare. + +###Creazione di una toolchain da un template +{: #creating_a_toolchain_from_a_template} + +Puoi utilizzare un template come punto di partenza nella creazione di una toolchain che includa una serie specifica di integrazioni dello strumento. + +1. Se stai creando la tua prima toolchain, assicurati che tali toolchain siano abilitate nella tua organizzazione: + 1. Apri il dashboard DevOps e fai clic sulla pagina **Toolchain**. + 2. Se viene visualizzato il pulsante **Enable Toolchains**, fai clic su di esso e segui le istruzioni per creare la tua toolchain. + 3. Se non viene visualizzato il pulsante **Enable Toolchains**, le toolchain sono già abilitate. Continua con il passo 2. +1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic sul pulsante (+) per creare una toolchain. +1. Fai clic su un template toolchain. Ad esempio, per utilizzare un esempio di archivio online per creare una toolchain, fai clic su **Microservices toolchain**. +1. Nella pagina di creazione della toolchain, rivedi il diagramma della toolchain che stai per creare. Il diagramma mostra ogni integrazione dello strumento nella fase del suo ciclo di vita nella toolchain. Il diagramma nella seguente immagine è un esempio. Quando crei una toolchain, il diagramma mostra ogni integrazione dello strumento che fa parte della toolchain. +![Diagramma della toolchain](images/toolchain_diagram.png) + +1. Rivedi le informazioni predefinite per la configurazione della toolchain. Il nome della toolchain la identifica in {{site.data.keyword.Bluemix_notm}}. Se già hai una toolchain con lo stesso nome o se desideri utilizzare un nome differente, modifica il nome della toolchain. +1. Nella sezione Integrazioni configurabili, seleziona ogni integrazione dello strumento che desideri configurare per la tua toolchain. Le stesse integrazioni dello strumento non richiedono alcuna configurazione. Per informazioni sulla configurazione delle integrazioni dello strumento, consulta [Configuring tool integrations (il link si apre in una nuova finestra)](../toolchains/toolchains_integrations.html){: new_window}. +1. Fai clic su **Create**. Diversi passi vengono eseguiti automaticamente per configurare la tua toolchain: + + * La toolchain viene creata. + * Se hai configurato l'integrazione dello strumento Delivery Pipeline, le pipeline vengono attivate. + * Se hai configurato l'integrazione dello strumento Sauce Labs, l'integrazione Sauce Labs viene configurata per aggiungere lavori alle pipeline e per eseguire verifiche. + * Se hai configurato l'integrazione dello strumento PagerDuty, l'integrazione PagerDuty viene configurata per inviare notifiche al canale configurato in Slack. Queste notifiche indicano quando si verifica un problema. + * Se hai configurato l'integrazione dello strumento Slack, l'integrazione Slack viene configurata per inviare notifiche al canale configurato in Slack. Queste notifiche indicano l'avanzamento della distribuzione; ad esempio, `Connected with Project XYZ`, `Pipeline Configured` e `Stage 'build' started`. + * Se hai configurato l'integrazione dello strumento GitHub, il repository GitHub di esempio viene clonato nel tuo account GitHub. + + +###Creazione di una toolchain da un applicazione +{: #creating_a_toolchain_from_an_app} + +Puoi creare una toolchain dalla tua applicazione. La toolchain può supportare il monitoraggio, la distribuzione e lo sviluppo continuo ed anche altro, e viene associata alla tua applicazione. Ogni applicazione può essere associata con una toolchain. Quando esegui il push delle modifiche a un repository GitHub della toolchain, la pipeline automaticamente crea e distribuisce l'applicazione. + +1. Se stai creando la tua prima toolchain, assicurati che tali toolchain siano abilitate nella tua organizzazione: + 1. Apri il dashboard DevOps e fai clic sulla pagina **Toolchain**. + 2. Se viene visualizzato il pulsante **Enable Toolchains**, fai clic su di esso e segui le istruzioni per creare la tua toolchain. + 3. Se non viene visualizzato il pulsante **Enable Toolchains**, le toolchain sono già abilitate. Continua con il passo 2. +1. Nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **Abilita**. In alternativa, nella modalità classica di {{site.data.keyword.Bluemix_notm}}, nell'angolo in alto a destra della pagina della panoramica della tua applicazione, fai clic su **Add Toolchain**. La tua applicazione è configurata per la distribuzione continua da un nuovo repository GitHub che viene popolato con il codice starter dell'applicazione. +1. Nella pagina di creazione della toolchain, rivedi il diagramma della toolchain che stai per creare. Il diagramma mostra ogni integrazione dello strumento nella fase del suo ciclo di vita nella toolchain. +1. Rivedi le informazioni predefinite per la configurazione della toolchain. Il nome della toolchain la identifica in {{site.data.keyword.Bluemix_notm}}. Se già hai una toolchain con lo stesso nome o se desideri utilizzare un nome differente, modifica il nome della toolchain. +1. Nella sezione Integrazioni configurabili, seleziona ogni integrazione dello strumento che desideri configurare per la tua toolchain. Le stesse integrazioni dello strumento non richiedono alcuna configurazione. Per informazioni sulla configurazione delle integrazioni dello strumento, consulta [Configuring tool integrations (il link si apre in una nuova finestra)](../toolchains/toolchains_integrations.html){: new_window}. +1. Fai clic su **Create**. Diversi passi vengono eseguiti automaticamente per configurare la tua toolchain: + + * La toolchain viene creata. + * Se hai configurato l'integrazione dello strumento Delivery Pipeline, le pipeline vengono attivate. + * Se hai configurato l'integrazione dello strumento Sauce Labs, l'integrazione Sauce Labs viene configurata per aggiungere lavori alle pipeline e per eseguire verifiche. + * Se hai configurato l'integrazione dello strumento PagerDuty, l'integrazione PagerDuty viene configurata per inviare notifiche al canale configurato in Slack. Queste notifiche indicano quando si verifica un problema. + * Se hai configurato l'integrazione dello strumento Slack, l'integrazione Slack viene configurata per inviare notifiche al canale configurato in Slack. Queste notifiche indicano l'avanzamento della distribuzione; ad esempio, `Connected with Project XYZ`, `Pipeline Configured` e `Stage 'build' started`. + * Se hai configurato l'integrazione dello strumento GitHub, il repository GitHub di esempio viene clonato nel tuo account GitHub. + + +##Introduzione alle toolchain: dedicato +{: #getting_started_dedicated} + +Ogni toolchain è associata a un'organizzazione (org) specifica e ogni utente che è membro di tale organizzazione può accedere alle toolchain associate. Prima di creare una toolchain, fai clic sull'icona **{{site.data.keyword.avatar}}** ![Icona Avatar](../icons/i-avatar-icon.svg) nella barra del menu per aprire il widget Account e supporto e visualizza l'organizzazione con cui stai lavorando. Se tale organizzazione non è l'organizzazione dove desideri creare la toolchain, passa a un'altra organizzazione. + +###Creazione di una toolchain da un template +{: #creating_a_toolchain_from_a_template_dedicated} + +Puoi utilizzare un template come punto di partenza nella creazione di una toolchain che includa una serie specifica di integrazioni dello strumento. + +1. Se stai creando la tua prima toolchain, assicurati che tali toolchain siano abilitate nella tua organizzazione: + 1. Apri il dashboard DevOps e fai clic sulla scheda **Toolchains**. + 2. Se viene visualizzato il pulsante **Enable Toolchains**, fai clic su di esso e segui le istruzioni per creare la tua toolchain. + 3. Se non viene visualizzato il pulsante **Enable Toolchains**, le toolchain sono già abilitate. Continua con il passo 2. +1. Nel dashboard {{site.data.keyword.Bluemix_notm}}, nella scheda **DEVOPS**, fai clic sul pulsante (+) per creare una toolchain. +1. Fai clic su un template toolchain. Ad esempio, per creare una toolchain semplice per distribuire una nuova applicazione Cloud Foundry, fai clic su **Simple Cloud Foundry toolchain**. +1. Nella pagina di creazione della toolchain, rivedi il diagramma della toolchain che stai per creare. Il diagramma mostra ogni integrazione dello strumento nella fase del suo ciclo di vita nella toolchain. Il diagramma nella seguente immagine è un esempio. Quando crei una toolchain, il diagramma mostra ogni integrazione dello strumento che fa parte della toolchain. +![Diagramma toolchain dedicato](images/toolchain_dedicated_diagram.png) + +1. Rivedi le informazioni predefinite per la configurazione della toolchain. Il nome della toolchain la identifica in {{site.data.keyword.Bluemix_notm}}. Se già hai una toolchain con lo stesso nome o se desideri utilizzare un nome differente, modifica il nome della toolchain. +1. Nella sezione Integrazioni configurabili, seleziona ogni integrazione dello strumento che desideri configurare per la tua toolchain. Le stesse integrazioni dello strumento non richiedono alcuna configurazione. Per informazioni sulla configurazione delle integrazioni dello strumento, consulta [Configuring tool integrations (il link si apre in una nuova finestra)](../toolchains/toolchains_integrations.html){: new_window}. +1. Fai clic su **Create**. Diversi passi vengono eseguiti automaticamente per configurare la tua toolchain: + + * La toolchain viene creata. + * Se hai configurato l'integrazione dello strumento Delivery Pipeline, le pipeline vengono attivate. + * Se hai configurato l'integrazione dello strumento GitHub Enterprise, il repository GitHub Enterprise di esempio viene clonato nel tuo account GitHub. + + +###Creazione di una toolchain da un applicazione +{: #creating_a_toolchain_from_an_app_dedicated} + +Puoi creare una toolchain dalla tua applicazione. La toolchain può supportare il monitoraggio, la distribuzione e lo sviluppo continuo ed anche altro, e viene associata alla tua applicazione. Ogni applicazione può essere associata con una toolchain. Quando esegui il push delle modifiche a un repository GitHub Enterprise della toolchain, la pipeline automaticamente crea e distribuisce l'applicazione. + +1. Se stai creando la tua prima toolchain, assicurati che tali toolchain siano abilitate nella tua organizzazione: + 1. Apri il dashboard DevOps e fai clic sulla scheda **Toolchains**. + 2. Se viene visualizzato il pulsante **Enable Toolchains**, fai clic su di esso e segui le istruzioni per creare la tua toolchain. + 3. Se non viene visualizzato il pulsante **Enable Toolchains**, le toolchain sono già abilitate. Continua con il passo 2. +1. Nell'angolo in alto a destra della pagina di panoramica della tua applicazione, fai clic su **Add Toolchain**. La tua applicazione è configurata per la distribuzione continua da un nuovo repository GitHub Enterprise che viene popolato con il codice starter dell'applicazione. +1. Nella pagina di creazione della toolchain, rivedi il diagramma della toolchain che stai per creare. Il diagramma mostra ogni integrazione dello strumento nella fase del suo ciclo di vita nella toolchain. +1. Rivedi le informazioni predefinite per la configurazione della toolchain. Il nome della toolchain la identifica in {{site.data.keyword.Bluemix_notm}}. Se già hai una toolchain con lo stesso nome o se desideri utilizzare un nome differente, modifica il nome della toolchain. +1. Nella sezione Integrazioni configurabili, seleziona ogni integrazione dello strumento che desideri configurare per la tua toolchain. Le stesse integrazioni dello strumento non richiedono alcuna configurazione. Per informazioni sulla configurazione delle integrazioni dello strumento, consulta [Configuring tool integrations (il link si apre in una nuova finestra)](../toolchains/toolchains_integrations.html){: new_window}. +1. Fai clic su **Create**. Diversi passi vengono eseguiti automaticamente per configurare la tua toolchain: + + * La toolchain viene creata. + * Se hai configurato l'integrazione dello strumento Delivery Pipeline, le pipeline vengono attivate. + * Se hai configurato l'integrazione dello strumento GitHub Enterprise, il repository GitHub Enterprise di esempio viene clonato nel tuo account GitHub. + + +##Visualizzazione di una toolchain +{: #viewing_a_toolchain} + +Dopo che la toolchain e tutte le integrazioni dello strumento sono state configurate, puoi visualizzare una rappresentazione grafica della toolchain nella pagina Integrazioni dello strumento. + +* Se utilizzi {{site.data.keyword.Bluemix_notm}} pubblico, nella pagina **Toolchain** del dashboard DevOps, fai clic su una toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. + +* Se utilizzi {{site.data.keyword.Bluemix_notm}} dedicato, nel dashboard, fai clic sulla scheda **DEVOPS** e fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. + +* Per accedere all'integrazione dello strumento nella tua toolchain, fai clic sul tile dello strumento. + + **Suggerimento**: se disponi di più di un repository GitHub o GitHub Enterprise, puoi avere più tile per la stessa integrazione dello strumento perché ogni repository è rappresentato dal proprio tile. + + + + + +# Link correlati +{: #rellinks} + +## Esercitazioni ed esempi +{: #samples} + +* [Create an application with three microservices (Beta) (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} +* [Create a toolchain from a template on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} +* [Create a toolchain from an app on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} + +## Link correlati +{: #general} + +* [Microservices toolchain (Beta) (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} +* [Simple toolchain (Beta) (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} +* [IBM Bluemix Garage Method (il link si apre in una nuova finestra)](https://www.ibm.com/devops/method){:new_window} diff --git a/toolchains/nl/it/toolchains_using.md b/toolchains/nl/it/toolchains_using.md index e378e01e9..d790f8862 100644 --- a/toolchains/nl/it/toolchains_using.md +++ b/toolchains/nl/it/toolchains_using.md @@ -1,97 +1,97 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Utilizzo delle toolchain in {{site.data.keyword.Bluemix_notm}} pubblico -{: #toolchains-using} - -Ultimo aggiornamento: 7 ottobre 2016 -{: .last-updated} - -Puoi utilizzare una toolchain per essere produttivo nella tua attività di sviluppo, distribuzione e nelle operazioni giornaliere. Dopo che hai configurato una toolchain, puoi aggiungere, eliminare o configurare le integrazioni dello strumento e gestire l'accesso alla toolchain. Le toolchain sono disponibili solo nella regione degli Stati Uniti Sud. -{: shortdesc} - -**Nota**: assicurati di lavorare nella Nuova esperienza Bluemix controllando il banner superiore. - - * Se vedi un messaggio che indica di provare il nuovo Bluemix, stai lavorando nell'esperienza classica di Bluemix. Fai clic sul link per aprire la Nuova esperienza Bluemix. - * Se non vedi tale messaggio, stai già lavorando nella Nuova esperienza Bluemix. - -## Configurazione di un'integrazione dello strumento -{: #configuring_a_tool_integration} - -Se hai differito la configurazione di un'integrazione dello strumento quando hai creato una toolchain, viene visualizzato un pulsante **Configure** nel relativo tile. Se hai configurato un'integrazione dello strumento quando hai creato una toolchain, puoi aggiornare le impostazioni di configurazione. - -1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic su una toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain** e quindi su **Integrazioni dello strumento**. -1. Se hai bisogno di configurare un'integrazione dello strumento per la prima volta, nel suo tile, fai clic su **Configure**. - - ![Pulsante configura](images/toolchain_tile_configure.png) - - Quando hai terminato la configurazione dell'integrazione dello strumento, fai clic su **Save Integration**. - -1. Se hai bisogno di aggiornare la configurazione dell'integrazione dello strumento, nel suo tile, fai clic sul menu per accedere alle opzioni di configurazione. - - ![Menu Configurazione](images/toolchain_tile_menu.png) - - Quando hai terminato di aggiornare le impostazioni, fai clic su **Save Integration**. - -## Aggiunta di un'integrazione dello strumento -{: #adding_a_tool_integration} - -Puoi aggiungere e configurare le integrazioni dello strumento per la tua toolchain. - -1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic su una toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain** e quindi su **Integrazioni dello strumento**. -1. Per visualizzare un elenco delle integrazioni dello strumento da aggiungere, fai clic sul pulsante di aggiunta (+). -1. Fai clic sull'integrazione dello strumento che desideri aggiungere. -1. Immetti tutte le informazioni necessarie per configurare l'integrazione dello strumento. -1. Fai clic su **Create Integration** per aggiungere l'integrazione dello strumento alla tua toolchain. - -## Eliminazione di un'integrazione dello strumento -{: #deleting_a_tool_integration} - -Se elimini un'integrazione dello strumento dalla tua toolchain, l'eliminazione non può essere annullata. - -1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic su una toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain** e quindi su **Integrazioni dello strumento**. -1. Nel tile per l'integrazione dello strumento che desideri eliminare, fai clic sul menu per accedere alle opzioni di configurazione. -1. Per eliminare l'integrazione dello strumento dalla tua toolchain, fai clic su **Delete**. -1. Conferma facendo clic su **Delete**. - -## Gestione dell'accesso -{: #managing_access} - -Puoi consentire agli utenti di accedere alla toolchain aggiungendoli all'organizzazione (org) a cui è associata la toolchain. Ogni toolchain è associata a un'organizzazione specifica e ogni utente che è membro di tale organizzazione può accedere alle toolchain associate. L'organizzazione in cui stai attualmente lavorando è visualizzata nella barra dei menu. Fai clic sull'organizzazione e passa a un'organizzazione differente per accedere a una serie diversa di toolchain. - - - - - -1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic sulla toolchain da gestire e quindi fai clic su **Manage**. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain** e quindi su **Manage**. -1. Fai clic sul link alla tua organizzazione. -1. Nella pagina Manage Organizations, fai clic su **Invite a User** e immetti l'indirizzo email dell'utente. -1. Se desideri fornire le autorizzazioni avanzate per gestire gli utenti in {{site.data.keyword.Bluemix_notm}}, seleziona una o più delle seguenti caselle di spunta **Manager**, **Billing Manager** o **Auditor**. -1. Fai clic su **INVITE**. -1. Fai clic su **SAVE**. - -## Eliminazione di una toolchain -{: #deleting_a_toolchain} - -Puoi eliminare una toolchain e specificare quali delle integrazioni dello strumento associate desideri eliminare. Quando elimini una toolchain, l'eliminazione non può essere annullata. - -1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic sulla toolchain da eliminare e quindi su **Manage**. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain** e quindi su **Manage**. -1. Fai clic su **Delete Toolchain** e rivedi o modifica le integrazioni dello strumento che stai eliminando. -1. Conferma l'eliminazione digitando il nome della toolchain e facendo clic su **Delete**. - - **Suggerimento**: quando elimini un'integrazione dello strumento GitHub, il repository GitHub associato non viene eliminato da GitHub. Devi rimuovere manualmente il repository da GitHub. +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Utilizzo delle toolchain in {{site.data.keyword.Bluemix_notm}} pubblico +{: #toolchains-using} + +Ultimo aggiornamento: 7 ottobre 2016 +{: .last-updated} + +Puoi utilizzare una toolchain per essere produttivo nella tua attività di sviluppo, distribuzione e nelle operazioni giornaliere. Dopo che hai configurato una toolchain, puoi aggiungere, eliminare o configurare le integrazioni dello strumento e gestire l'accesso alla toolchain. Le toolchain sono disponibili solo nella regione degli Stati Uniti Sud. +{: shortdesc} + +**Nota**: assicurati di lavorare nella Nuova esperienza Bluemix controllando il banner superiore. + + * Se vedi un messaggio che indica di provare il nuovo Bluemix, stai lavorando nell'esperienza classica di Bluemix. Fai clic sul link per aprire la Nuova esperienza Bluemix. + * Se non vedi tale messaggio, stai già lavorando nella Nuova esperienza Bluemix. + +## Configurazione di un'integrazione dello strumento +{: #configuring_a_tool_integration} + +Se hai differito la configurazione di un'integrazione dello strumento quando hai creato una toolchain, viene visualizzato un pulsante **Configure** nel relativo tile. Se hai configurato un'integrazione dello strumento quando hai creato una toolchain, puoi aggiornare le impostazioni di configurazione. + +1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic su una toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain** e quindi su **Integrazioni dello strumento**. +1. Se hai bisogno di configurare un'integrazione dello strumento per la prima volta, nel suo tile, fai clic su **Configure**. + + ![Pulsante configura](images/toolchain_tile_configure.png) + + Quando hai terminato la configurazione dell'integrazione dello strumento, fai clic su **Save Integration**. + +1. Se hai bisogno di aggiornare la configurazione dell'integrazione dello strumento, nel suo tile, fai clic sul menu per accedere alle opzioni di configurazione. + + ![Menu Configurazione](images/toolchain_tile_menu.png) + + Quando hai terminato di aggiornare le impostazioni, fai clic su **Save Integration**. + +## Aggiunta di un'integrazione dello strumento +{: #adding_a_tool_integration} + +Puoi aggiungere e configurare le integrazioni dello strumento per la tua toolchain. + +1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic su una toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain** e quindi su **Integrazioni dello strumento**. +1. Per visualizzare un elenco delle integrazioni dello strumento da aggiungere, fai clic sul pulsante di aggiunta (+). +1. Fai clic sull'integrazione dello strumento che desideri aggiungere. +1. Immetti tutte le informazioni necessarie per configurare l'integrazione dello strumento. +1. Fai clic su **Create Integration** per aggiungere l'integrazione dello strumento alla tua toolchain. + +## Eliminazione di un'integrazione dello strumento +{: #deleting_a_tool_integration} + +Se elimini un'integrazione dello strumento dalla tua toolchain, l'eliminazione non può essere annullata. + +1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic su una toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain** e quindi su **Integrazioni dello strumento**. +1. Nel tile per l'integrazione dello strumento che desideri eliminare, fai clic sul menu per accedere alle opzioni di configurazione. +1. Per eliminare l'integrazione dello strumento dalla tua toolchain, fai clic su **Delete**. +1. Conferma facendo clic su **Delete**. + +## Gestione dell'accesso +{: #managing_access} + +Puoi consentire agli utenti di accedere alla toolchain aggiungendoli all'organizzazione (org) a cui è associata la toolchain. Ogni toolchain è associata a un'organizzazione specifica e ogni utente che è membro di tale organizzazione può accedere alle toolchain associate. L'organizzazione in cui stai attualmente lavorando è visualizzata nella barra dei menu. Fai clic sull'organizzazione e passa a un'organizzazione differente per accedere a una serie diversa di toolchain. + + + + + +1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic sulla toolchain da gestire e quindi fai clic su **Manage**. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain** e quindi su **Manage**. +1. Fai clic sul link alla tua organizzazione. +1. Nella pagina Manage Organizations, fai clic su **Invite a User** e immetti l'indirizzo email dell'utente. +1. Se desideri fornire le autorizzazioni avanzate per gestire gli utenti in {{site.data.keyword.Bluemix_notm}}, seleziona una o più delle seguenti caselle di spunta **Manager**, **Billing Manager** o **Auditor**. +1. Fai clic su **INVITE**. +1. Fai clic su **SAVE**. + +## Eliminazione di una toolchain +{: #deleting_a_toolchain} + +Puoi eliminare una toolchain e specificare quali delle integrazioni dello strumento associate desideri eliminare. Quando elimini una toolchain, l'eliminazione non può essere annullata. + +1. Nel dashboard DevOps, nella pagina **Toolchain**, fai clic sulla toolchain da eliminare e quindi su **Manage**. In alternativa, nella pagina della panoramica dell'applicazione, nel tile di fornitura continua, fai clic su **View Toolchain** e quindi su **Manage**. +1. Fai clic su **Delete Toolchain** e rivedi o modifica le integrazioni dello strumento che stai eliminando. +1. Conferma l'eliminazione digitando il nome della toolchain e facendo clic su **Delete**. + + **Suggerimento**: quando elimini un'integrazione dello strumento GitHub, il repository GitHub associato non viene eliminato da GitHub. Devi rimuovere manualmente il repository da GitHub. diff --git a/toolchains/nl/it/toolchains_using_dedicated.md b/toolchains/nl/it/toolchains_using_dedicated.md index 8163f4069..0f7ef861c 100644 --- a/toolchains/nl/it/toolchains_using_dedicated.md +++ b/toolchains/nl/it/toolchains_using_dedicated.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Utilizzo delle toolchain in {{site.data.keyword.Bluemix_notm}} dedicato -{: #toolchains-using_dedicated} - -Ultimo aggiornamento: 13 settembre 2016 -{: .last-updated} - -Puoi utilizzare una toolchain per essere produttivo nella tua attività di sviluppo, distribuzione e nelle operazioni giornaliere. Dopo che hai configurato una toolchain, puoi aggiungere, eliminare o configurare le integrazioni dello strumento e gestire l'accesso alla toolchain. -{: shortdesc} - -## Configurazione di un'integrazione dello strumento -{: #configuring_a_tool_integration_dedicated} - -Se hai differito la configurazione di un'integrazione dello strumento quando hai creato una toolchain, viene visualizzato un pulsante **Configure** nel relativo tile. Se hai configurato un'integrazione dello strumento quando hai creato una toolchain, puoi aggiornare le impostazioni di configurazione. - -1. Nel dashboard, nella scheda **DEVOPS**, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Se hai bisogno di configurare un'integrazione dello strumento per la prima volta, nel suo tile, fai clic su **Configure**. - - ![Pulsante configura](images/toolchain_tile_configure.png) - - Quando hai terminato la configurazione dell'integrazione dello strumento, fai clic su **Save Integration**. - -1. Se hai bisogno di aggiornare la configurazione dell'integrazione dello strumento, nel suo tile, fai clic sul menu per accedere alle opzioni di configurazione. - - ![Menu Configurazione](images/toolchain_tile_menu.png) - - Quando hai terminato di aggiornare le impostazioni, fai clic su **Save Integration**. - -## Aggiunta di un'integrazione dello strumento -{: #adding_a_tool_integration_dedicated} - -Puoi aggiungere e configurare le integrazioni dello strumento per la tua toolchain. - -1. Nel dashboard, nella scheda **DEVOPS**, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Per visualizzare un elenco delle integrazioni dello strumento da aggiungere, fai clic sul pulsante di aggiunta (+). -1. Fai clic sull'integrazione dello strumento da aggiungere. -1. Immetti tutte le informazioni necessarie per configurare l'integrazione dello strumento. -1. Fai clic su **Create Integration** per aggiungere l'integrazione dello strumento alla tua toolchain. - -## Eliminazione di un'integrazione dello strumento -{: #deleting_a_tool_integration} - -Se elimini un'integrazione dello strumento dalla tua toolchain, l'eliminazione non può essere annullata. - -1. Nel dashboard, nella scheda **DEVOPS**, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. -1. Nel tile per l'integrazione dello strumento da eliminare, fai clic sul menu per accedere alle opzioni di configurazione. -1. Per eliminare l'integrazione dello strumento dalla tua toolchain, fai clic su **Delete**. -1. Conferma facendo clic su **Delete**. - -## Gestione dell'accesso -{: #managing_access_dedicated} - -Puoi consentire agli utenti di accedere alla toolchain aggiungendoli all'organizzazione (org) a cui è associata la toolchain. Ogni toolchain è associata a un'organizzazione specifica e ogni utente che è membro di tale organizzazione può accedere alle toolchain associate. Per visualizzare l'organizzazione con cui stai correntemente lavorando, fai clic sull'icona **{{site.data.keyword.avatar}}** ![Icona Avatar](../icons/i-avatar-icon.svg) nella barra del menu. Per accedere a un diversa serie di toolchain, passa a un'altra organizzazione. - -Quando aggiungi utenti ai tuoi spazi o organizzazioni {{site.data.keyword.Bluemix}}, gli utenti possono accedere a GitHub Enterprise utilizzando i loro ID e password {{site.data.keyword.Bluemix_notm}}. Quando gli utenti accedono, vengono creati degli account per loro. Quando aggiungi utenti ai tuoi spazi o organizzazioni {{site.data.keyword.Bluemix_notm}}, vengono automaticamente aggiunti al repository GitHub Enterprise. Qualcuno che dispone dei privilegi da amministratore per il repository li deve aggiungere. Per ulteriori informazioni, consulta [Using Dedicated GitHub Enterprise (il link si apre in una nuova finestra)](../services/ghededicated/index.html){: new_window}. - -Per aggiungere un utente, completa la seguente procedura: - -1. Nel dashboard, nella scheda **DEVOPS**, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. Quindi, fai clic su **Manage**. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Manage**. -1. Fai clic sul link alla tua organizzazione. -1. Nella pagina Manage Organizations, fai clic su **Invite a User** e immetti l'indirizzo email dell'utente. -1. Se desideri fornire le autorizzazioni avanzate per gestire gli utenti in {{site.data.keyword.Bluemix_notm}}, seleziona una o più delle seguenti caselle di spunta **Manager**, **Billing Manager** o **Auditor**. -1. Fai clic su **INVITE**. -1. Fai clic su **SAVE**. - -## Eliminazione di una toolchain -{: #deleting_a_toolchain_dedicated} - -Puoi eliminare una toolchain e specificare quali delle integrazioni dello strumento associate desideri eliminare. Quando elimini una toolchain, l'eliminazione non può essere annullata. - -1. Nel dashboard, nella scheda **DEVOPS**, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. Quindi, fai clic su **Manage**. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Manage**. -1. Fai clic su **Delete Toolchain** e rivedi o modifica le integrazioni dello strumento che stai eliminando. -1. Conferma l'eliminazione digitando il nome della toolchain e facendo clic su **Delete**. - - **Suggerimento**: quando elimini un'integrazione dello strumento GitHub Enterprise, il repository GitHub Enterprise associato non viene eliminato da GitHub Enterprise. Devi rimuovere manualmente il repository da GitHub Enterprise. +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Utilizzo delle toolchain in {{site.data.keyword.Bluemix_notm}} dedicato +{: #toolchains-using_dedicated} + +Ultimo aggiornamento: 13 settembre 2016 +{: .last-updated} + +Puoi utilizzare una toolchain per essere produttivo nella tua attività di sviluppo, distribuzione e nelle operazioni giornaliere. Dopo che hai configurato una toolchain, puoi aggiungere, eliminare o configurare le integrazioni dello strumento e gestire l'accesso alla toolchain. +{: shortdesc} + +## Configurazione di un'integrazione dello strumento +{: #configuring_a_tool_integration_dedicated} + +Se hai differito la configurazione di un'integrazione dello strumento quando hai creato una toolchain, viene visualizzato un pulsante **Configure** nel relativo tile. Se hai configurato un'integrazione dello strumento quando hai creato una toolchain, puoi aggiornare le impostazioni di configurazione. + +1. Nel dashboard, nella scheda **DEVOPS**, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Se hai bisogno di configurare un'integrazione dello strumento per la prima volta, nel suo tile, fai clic su **Configure**. + + ![Pulsante configura](images/toolchain_tile_configure.png) + + Quando hai terminato la configurazione dell'integrazione dello strumento, fai clic su **Save Integration**. + +1. Se hai bisogno di aggiornare la configurazione dell'integrazione dello strumento, nel suo tile, fai clic sul menu per accedere alle opzioni di configurazione. + + ![Menu Configurazione](images/toolchain_tile_menu.png) + + Quando hai terminato di aggiornare le impostazioni, fai clic su **Save Integration**. + +## Aggiunta di un'integrazione dello strumento +{: #adding_a_tool_integration_dedicated} + +Puoi aggiungere e configurare le integrazioni dello strumento per la tua toolchain. + +1. Nel dashboard, nella scheda **DEVOPS**, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Per visualizzare un elenco delle integrazioni dello strumento da aggiungere, fai clic sul pulsante di aggiunta (+). +1. Fai clic sull'integrazione dello strumento da aggiungere. +1. Immetti tutte le informazioni necessarie per configurare l'integrazione dello strumento. +1. Fai clic su **Create Integration** per aggiungere l'integrazione dello strumento alla tua toolchain. + +## Eliminazione di un'integrazione dello strumento +{: #deleting_a_tool_integration} + +Se elimini un'integrazione dello strumento dalla tua toolchain, l'eliminazione non può essere annullata. + +1. Nel dashboard, nella scheda **DEVOPS**, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Integrazioni dello strumento**. +1. Nel tile per l'integrazione dello strumento da eliminare, fai clic sul menu per accedere alle opzioni di configurazione. +1. Per eliminare l'integrazione dello strumento dalla tua toolchain, fai clic su **Delete**. +1. Conferma facendo clic su **Delete**. + +## Gestione dell'accesso +{: #managing_access_dedicated} + +Puoi consentire agli utenti di accedere alla toolchain aggiungendoli all'organizzazione (org) a cui è associata la toolchain. Ogni toolchain è associata a un'organizzazione specifica e ogni utente che è membro di tale organizzazione può accedere alle toolchain associate. Per visualizzare l'organizzazione con cui stai correntemente lavorando, fai clic sull'icona **{{site.data.keyword.avatar}}** ![Icona Avatar](../icons/i-avatar-icon.svg) nella barra del menu. Per accedere a un diversa serie di toolchain, passa a un'altra organizzazione. + +Quando aggiungi utenti ai tuoi spazi o organizzazioni {{site.data.keyword.Bluemix}}, gli utenti possono accedere a GitHub Enterprise utilizzando i loro ID e password {{site.data.keyword.Bluemix_notm}}. Quando gli utenti accedono, vengono creati degli account per loro. Quando aggiungi utenti ai tuoi spazi o organizzazioni {{site.data.keyword.Bluemix_notm}}, vengono automaticamente aggiunti al repository GitHub Enterprise. Qualcuno che dispone dei privilegi da amministratore per il repository li deve aggiungere. Per ulteriori informazioni, consulta [Using Dedicated GitHub Enterprise (il link si apre in una nuova finestra)](../services/ghededicated/index.html){: new_window}. + +Per aggiungere un utente, completa la seguente procedura: + +1. Nel dashboard, nella scheda **DEVOPS**, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. Quindi, fai clic su **Manage**. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Manage**. +1. Fai clic sul link alla tua organizzazione. +1. Nella pagina Manage Organizations, fai clic su **Invite a User** e immetti l'indirizzo email dell'utente. +1. Se desideri fornire le autorizzazioni avanzate per gestire gli utenti in {{site.data.keyword.Bluemix_notm}}, seleziona una o più delle seguenti caselle di spunta **Manager**, **Billing Manager** o **Auditor**. +1. Fai clic su **INVITE**. +1. Fai clic su **SAVE**. + +## Eliminazione di una toolchain +{: #deleting_a_toolchain_dedicated} + +Puoi eliminare una toolchain e specificare quali delle integrazioni dello strumento associate desideri eliminare. Quando elimini una toolchain, l'eliminazione non può essere annullata. + +1. Nel dashboard, nella scheda **DEVOPS**, fai clic sulla toolchain per aprirne la pagina Integrazioni dello strumento. Quindi, fai clic su **Manage**. In alternativa, nell'angolo in alto a destra della tua pagina di panoramica, fai clic su **View Toolchain**. Quindi, fai clic su **Manage**. +1. Fai clic su **Delete Toolchain** e rivedi o modifica le integrazioni dello strumento che stai eliminando. +1. Conferma l'eliminazione digitando il nome della toolchain e facendo clic su **Delete**. + + **Suggerimento**: quando elimini un'integrazione dello strumento GitHub Enterprise, il repository GitHub Enterprise associato non viene eliminato da GitHub Enterprise. Devi rimuovere manualmente il repository da GitHub Enterprise. diff --git a/toolchains/nl/it/web_ide.md b/toolchains/nl/it/web_ide.md index 102b857e4..3a1a250ac 100644 --- a/toolchains/nl/it/web_ide.md +++ b/toolchains/nl/it/web_ide.md @@ -1,152 +1,152 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} -{:pre: .pre} - -# Modifica del codice con Eclipse Orion {{site.data.keyword.webide}} -{: #web_ide} - -Ultimo aggiornamento: 9 settembre 2016 -{: .last-updated} - -Eclipse Orion {{site.data.keyword.webide}} è un ambiente di sviluppo basato sul browser in cui puoi sviluppare per il web. Puoi sviluppare in JavaScript, HTML e CSS con l'aiuto dell'assistenza del contenuto, del completamento del codice e del controllo errori. {{site.data.keyword.webide}} utilizza quasi tutti i linguaggi e offre l'evidenziazione della sintassi per molti tipi di file [ (il link si apre in una nuova finestra)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}. Il controllo di origine è integrato in Git o Jazz SCM e può distribuire il codice localmente per verificare ed eseguire il debug delle tue applicazioni. -{:shortdesc} - -Cosa più importante, {{site.data.keyword.webide}} si avvale della tecnologia web. Non hai nulla da installare, da mantenere e da scalare. Puoi sviluppare ovunque tu abbia una connessione a internet. - -## Configurazione dell'editor -{: #editorsetup} - -{{site.data.keyword.webide}} è personalizzabile in modo che puoi scegliere gli schemi di colori, gli strumenti tecnici e le impostazioni che incontrano i tuoi bisogni di sviluppo. Per visualizzare e modificare le impostazioni, dal menu di sinistra, fai clic sull'icona **Impostazioni** L'icona impostazioni. - -Se hai spesso bisogno di modificare alcune impostazioni mentre lavori, puoi accedere a queste impostazioni velocemente dall'icona **Impostazioni editor locali** Icona Impostazioni editor locali nell'angolo in alto a destra dell'editor - -![Impostazioni dell'editor locali](images/webide_local_editor_settings.png) - -Per impostazione predefinita, le impostazioni per lo stile dell'editor e la dimensione del carattere vengono sempre visualizzate. Per includere altre impostazioni dell'editor nel menu, completa la seguente procedura: - -1. Fai clic sull'icona **Impostazioni dell'editor locali** Icona Impostazioni dell'editor locali. - -2. Fai clic su **Impostazioni dell'editor**. - -3. Per includere o escludere un'impostazione dal menu **Impostazioni dell'editor locali**, fai clic sul circolo vicino all'impostazione. - -![Attiva impostazioni dell'editor](images/webide_editor_settings_toggle.png) - - -## Modifica del codice -{: #editcode} - -{{site.data.keyword.webide}} ha due sezioni principali. La prima sezione è il navigator dei file sulla sinistra, che mostra i tuoi file del progetto in tre strutture. Dal navigator dei file, puoi creare, ridenominare, eliminare e gestire i tuoi file e cartelle. - -**Suggerimento:** per caricare i file nel navigator dei file, trascinaceli dal tuo computer. - -La seconda sezione è il pannello dell'editor sulla destra. L'editor fornisce diverse funzioni di scrittura del codice, tra cui l'assistenza del contenuto e la convalida della sintassi. - -![Web IDE](images/webide.png) - -### Utilizzo di più file -1. Per utilizzare due file contemporaneamente, fai clic sull'icona **Modifica modalità di suddivisione editor** Icona suddivisione editor all'inizio dell'editor. -2. Dal menu che si apre, seleziona una vista. - - Dopo avere selezionato la vista, se era già stato aperto un file nell'editor, viene visualizzato in entrambe le viste dell'editor. - - Per aprire o modificare un file visualizzato in una delle due viste dell'editor: - 1. Sposta il cursore del mouse nella vista editor che desideri modificare. - 2. Nel navigator dei file, fai clic su un file. - -### Tasti di scelta rapida -Molti dei comandi in {{site.data.keyword.webide}} sono accessibili tramite dei tasti di scelta rapida. - -Per visualizzare un elenco dei tasti di scelta rapida nell'editor, premi Alt+Shift+?. Se stai utilizzando un SO Mac, premi Ctrl+Shift+?. - -## Gestione del codice di origine -{: #sourcecontrol} - -{{site.data.keyword.webide}} è integrata con gli strumenti di gestione del codice di origine. Per utilizzare il tuo repository Git, fai clic sull'icona **Repository Git** L'icona repository Git. Per ulteriori informazioni, consulta [Source control with Git (il link si apre in una nuova finestra)](https://hub.jazz.net/docs/git/){: new_window}. - - -## Distribuzione di un'applicazione dal tuo spazio di lavoro -{: #deploy} - -1. Per distribuire la tua applicazione, dalla barra del menu, seleziona o [crea (il link si apre in una nuova finestra)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} una configurazione di avvio. -1. Fai clic sull'icona di distribuzione L'icona di distribuzione. Viene distribuita un'istanza alla tua applicazione utilizzando i contenuti correnti del tuo spazio di lavoro e l'ambiente definito nella tua configurazione di avvio. -2. Dopo che la tua applicazione è stata distribuita, puoi utilizzare la barra di esecuzione per arrestare, riavviare o eseguire il debug della applicazione, dei log di visualizzazione o di altro. -![Barra di esecuzione](images/webide_runbar.png) - - - - ## Modifica al di fuori di {{site.data.keyword.webide}} -{: #editlocal} - -Per utilizzare un editor all'esterno di {{site.data.keyword.webide}}, configura {{site.data.keyword.Bluemix_live}} in modo che tu possa lavorare direttamente con i tuoi file del progetto in qualsiasi strumento. {{site.data.keyword.Bluemix_live_notm}} è un'applicazione della riga di comando che sincronizza le modifiche nel tuo file system locale con lo spazio di lavoro nel cloud in {{site.data.keyword.jazzhub}}. - -### Attività preliminari - -Scarica e installa la CLI (command-line interface) di [{{site.data.keyword.Bluemix_live_notm}} (il link si apre in una nuova finestra)](http://livesyncdownload.ng.bluemix.net){: new_window}. - -### Sincronizzazione del tuo ambiente locale con {{site.data.keyword.Bluemix_notm}} -{: #edit_local_download} - -1. Apri una finestra della riga di comando. -2. Accedi a {{site.data.keyword.Bluemix_notm}}: - - ``` - bl login - ``` - {: pre} - -3. Quando ti viene richiesto, immetti il tuo ID IBM e la password. -4. Visualizza un elenco dei tuoi progetti {{site.data.keyword.Bluemix_notm}}: - - ``` - bl projects - ``` - {: pre} - -4. Sincronizza il tuo ambiente locale con il tuo progetto in {{site.data.keyword.Bluemix_notm}}: - - ``` - bl sync projectName - ``` - {: pre} - -dove `projectName` è il tuo nome dell'applicazione {{site.data.keyword.Bluemix_notm}}. - -Quando hai finito le modifiche, immetti `q` per terminare la sincronizzazione. - -### Abilitazione della funzione Desktop Sync per modificare il codice localmente - -La funzione Desktop Sync è simile alla modalità Live Edit per la riga di comando. Hai bisogno della funzione Desktop Sync per eseguire il debug nella riga di comando. -1. In un'altra finestra della riga di comando, abilita la funzione Desktop Sync: - - ``` - cd localDirectory - bl start - ``` - {: codeblock} - -2. Utilizza la configurazione di avvio che hai creato in {{site.data.keyword.webide}}. Dopo che hai selezionato la configurazione di avvio, la funzione Desktop Sync viene abilitata nel tuo ambiente locale. Nella finestra della riga di comando che hai appena aperto, puoi visualizzare l'URL dell'applicazione, di debug, di gestione e visualizzare lo stato di {{site.data.keyword.Bluemix_live_notm}}. - -3. Aggiorna il browser e verifica che puoi visualizzare le modifiche che hai salvato nei file statici nello spazio di lavoro locale. - -### Disabilitazione della funzione Desktop Sync - -1. In una seconda finestra della riga di comando, immetti `bl stop`. -2. Nella prima finestra della riga di comando, immetti `q`. +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} +{:pre: .pre} + +# Modifica del codice con Eclipse Orion {{site.data.keyword.webide}} +{: #web_ide} + +Ultimo aggiornamento: 9 settembre 2016 +{: .last-updated} + +Eclipse Orion {{site.data.keyword.webide}} è un ambiente di sviluppo basato sul browser in cui puoi sviluppare per il web. Puoi sviluppare in JavaScript, HTML e CSS con l'aiuto dell'assistenza del contenuto, del completamento del codice e del controllo errori. {{site.data.keyword.webide}} utilizza quasi tutti i linguaggi e offre l'evidenziazione della sintassi per molti tipi di file [ (il link si apre in una nuova finestra)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}. Il controllo di origine è integrato in Git o Jazz SCM e può distribuire il codice localmente per verificare ed eseguire il debug delle tue applicazioni. +{:shortdesc} + +Cosa più importante, {{site.data.keyword.webide}} si avvale della tecnologia web. Non hai nulla da installare, da mantenere e da scalare. Puoi sviluppare ovunque tu abbia una connessione a internet. + +## Configurazione dell'editor +{: #editorsetup} + +{{site.data.keyword.webide}} è personalizzabile in modo che puoi scegliere gli schemi di colori, gli strumenti tecnici e le impostazioni che incontrano i tuoi bisogni di sviluppo. Per visualizzare e modificare le impostazioni, dal menu di sinistra, fai clic sull'icona **Impostazioni** L'icona impostazioni. + +Se hai spesso bisogno di modificare alcune impostazioni mentre lavori, puoi accedere a queste impostazioni velocemente dall'icona **Impostazioni editor locali** Icona Impostazioni editor locali nell'angolo in alto a destra dell'editor + +![Impostazioni dell'editor locali](images/webide_local_editor_settings.png) + +Per impostazione predefinita, le impostazioni per lo stile dell'editor e la dimensione del carattere vengono sempre visualizzate. Per includere altre impostazioni dell'editor nel menu, completa la seguente procedura: + +1. Fai clic sull'icona **Impostazioni dell'editor locali** Icona Impostazioni dell'editor locali. + +2. Fai clic su **Impostazioni dell'editor**. + +3. Per includere o escludere un'impostazione dal menu **Impostazioni dell'editor locali**, fai clic sul circolo vicino all'impostazione. + +![Attiva impostazioni dell'editor](images/webide_editor_settings_toggle.png) + + +## Modifica del codice +{: #editcode} + +{{site.data.keyword.webide}} ha due sezioni principali. La prima sezione è il navigator dei file sulla sinistra, che mostra i tuoi file del progetto in tre strutture. Dal navigator dei file, puoi creare, ridenominare, eliminare e gestire i tuoi file e cartelle. + +**Suggerimento:** per caricare i file nel navigator dei file, trascinaceli dal tuo computer. + +La seconda sezione è il pannello dell'editor sulla destra. L'editor fornisce diverse funzioni di scrittura del codice, tra cui l'assistenza del contenuto e la convalida della sintassi. + +![Web IDE](images/webide.png) + +### Utilizzo di più file +1. Per utilizzare due file contemporaneamente, fai clic sull'icona **Modifica modalità di suddivisione editor** Icona suddivisione editor all'inizio dell'editor. +2. Dal menu che si apre, seleziona una vista. + + Dopo avere selezionato la vista, se era già stato aperto un file nell'editor, viene visualizzato in entrambe le viste dell'editor. + + Per aprire o modificare un file visualizzato in una delle due viste dell'editor: + 1. Sposta il cursore del mouse nella vista editor che desideri modificare. + 2. Nel navigator dei file, fai clic su un file. + +### Tasti di scelta rapida +Molti dei comandi in {{site.data.keyword.webide}} sono accessibili tramite dei tasti di scelta rapida. + +Per visualizzare un elenco dei tasti di scelta rapida nell'editor, premi Alt+Shift+?. Se stai utilizzando un SO Mac, premi Ctrl+Shift+?. + +## Gestione del codice di origine +{: #sourcecontrol} + +{{site.data.keyword.webide}} è integrata con gli strumenti di gestione del codice di origine. Per utilizzare il tuo repository Git, fai clic sull'icona **Repository Git** L'icona repository Git. Per ulteriori informazioni, consulta [Source control with Git (il link si apre in una nuova finestra)](https://hub.jazz.net/docs/git/){: new_window}. + + +## Distribuzione di un'applicazione dal tuo spazio di lavoro +{: #deploy} + +1. Per distribuire la tua applicazione, dalla barra del menu, seleziona o [crea (il link si apre in una nuova finestra)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} una configurazione di avvio. +1. Fai clic sull'icona di distribuzione L'icona di distribuzione. Viene distribuita un'istanza alla tua applicazione utilizzando i contenuti correnti del tuo spazio di lavoro e l'ambiente definito nella tua configurazione di avvio. +2. Dopo che la tua applicazione è stata distribuita, puoi utilizzare la barra di esecuzione per arrestare, riavviare o eseguire il debug della applicazione, dei log di visualizzazione o di altro. +![Barra di esecuzione](images/webide_runbar.png) + + + + ## Modifica al di fuori di {{site.data.keyword.webide}} +{: #editlocal} + +Per utilizzare un editor all'esterno di {{site.data.keyword.webide}}, configura {{site.data.keyword.Bluemix_live}} in modo che tu possa lavorare direttamente con i tuoi file del progetto in qualsiasi strumento. {{site.data.keyword.Bluemix_live_notm}} è un'applicazione della riga di comando che sincronizza le modifiche nel tuo file system locale con lo spazio di lavoro nel cloud in {{site.data.keyword.jazzhub}}. + +### Attività preliminari + +Scarica e installa la CLI (command-line interface) di [{{site.data.keyword.Bluemix_live_notm}} (il link si apre in una nuova finestra)](http://livesyncdownload.ng.bluemix.net){: new_window}. + +### Sincronizzazione del tuo ambiente locale con {{site.data.keyword.Bluemix_notm}} +{: #edit_local_download} + +1. Apri una finestra della riga di comando. +2. Accedi a {{site.data.keyword.Bluemix_notm}}: + + ``` + bl login + ``` + {: pre} + +3. Quando ti viene richiesto, immetti il tuo ID IBM e la password. +4. Visualizza un elenco dei tuoi progetti {{site.data.keyword.Bluemix_notm}}: + + ``` + bl projects + ``` + {: pre} + +4. Sincronizza il tuo ambiente locale con il tuo progetto in {{site.data.keyword.Bluemix_notm}}: + + ``` + bl sync projectName + ``` + {: pre} + +dove `projectName` è il tuo nome dell'applicazione {{site.data.keyword.Bluemix_notm}}. + +Quando hai finito le modifiche, immetti `q` per terminare la sincronizzazione. + +### Abilitazione della funzione Desktop Sync per modificare il codice localmente + +La funzione Desktop Sync è simile alla modalità Live Edit per la riga di comando. Hai bisogno della funzione Desktop Sync per eseguire il debug nella riga di comando. +1. In un'altra finestra della riga di comando, abilita la funzione Desktop Sync: + + ``` + cd localDirectory + bl start + ``` + {: codeblock} + +2. Utilizza la configurazione di avvio che hai creato in {{site.data.keyword.webide}}. Dopo che hai selezionato la configurazione di avvio, la funzione Desktop Sync viene abilitata nel tuo ambiente locale. Nella finestra della riga di comando che hai appena aperto, puoi visualizzare l'URL dell'applicazione, di debug, di gestione e visualizzare lo stato di {{site.data.keyword.Bluemix_live_notm}}. + +3. Aggiorna il browser e verifica che puoi visualizzare le modifiche che hai salvato nei file statici nello spazio di lavoro locale. + +### Disabilitazione della funzione Desktop Sync + +1. In una seconda finestra della riga di comando, immetti `bl stop`. +2. Nella prima finestra della riga di comando, immetti `q`. diff --git a/toolchains/nl/ja/toolchains_about.md b/toolchains/nl/ja/toolchains_about.md index 4b56df667..c367b1bca 100644 --- a/toolchains/nl/ja/toolchains_about.md +++ b/toolchains/nl/ja/toolchains_about.md @@ -1,42 +1,42 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# ツールチェーンについて -{: #toolchains_about} - -最終更新日: 2016 年 9 月 13 日 -{: .last-updated} - -*ツールチェーン*は、開発、デプロイメント、運用の作業をサポートするツール統合のセットです。ツールチェーンの集合的な機能は、個々のツール統合の機能を合わせたものより優れています。 -{:shortdesc} - -ツールチェーンは、{{site.data.keyword.Bluemix}} の Public と Dedicated の環境で使用できます。ツールチェーンを作成する方法は、2 つあります。テンプレートを使用してツールチェーンを作成する方法と、アプリからツールチェーンを作成する方法です。開始点として、ツールチェーン・テンプレートを使用できます。使用するテンプレートに応じて、特定のツール統合のセットが含まれたツールチェーンを作成するか、または、空のツールチェーンを作成してそこにツール統合を追加していくことができます。 - -{{site.data.keyword.Bluemix_notm}} Public の場合、使用するテンプレートまたはツールチェーンによっては、アプリのスターター・コードが設定された GitHub リポジトリーと、事前構成済みのデリバリー・パイプラインがツールチェーンに含まれていることがあります。ツールチェーンの GitHub リポジトリーに変更内容をプッシュすると、デリバリー・パイプラインによってアプリが自動的に作成され、{{site.data.keyword.Bluemix_notm}} にデプロイされます。 - -{{site.data.keyword.Bluemix_notm}} Dedicated の場合、使用するツールチェーンによっては、アプリのスターター・コードが設定された GitHub Enterprise リポジトリーと、事前構成済みのデリバリー・パイプラインがツールチェーンに含まれていることがあります。ツールチェーンの GitHub Enterprise リポジトリーに変更内容をプッシュすると、デリバリー・パイプラインによってアプリが自動的に作成され、{{site.data.keyword.Bluemix_notm}} にデプロイされます。 - -## ツールチェーンのヘルプ情報とサポート -{: #gettinghelp} - -ツールチェーンの使用について問題点や疑問点がある場合は、ヘルプ情報を検索したりフォーラムに質問を投稿したりできます。サポート・チケットを開くことも可能です。 - -フォーラムに質問を投稿する場合は、質問にタグを付けて、{{site.data.keyword.Bluemix_notm}} 開発チームが確認できるようにしてください。 - -* ツールチェーンでのアプリの開発またはデプロイに関する技術的な質問がある場合は、[Stack Overflow (リンク先が新しいウィンドウで開きます)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} に質問を投稿し、「ibm-bluemix」と「devops」というタグを付けてください。 - -* ツールチェーンや概説に関する質問がある場合は、[IBM developerWorks dW Answers (リンク先が新しいウィンドウで開きます)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window} フォーラムを利用してください。「devops-services」と「bluemix」というタグを付けてください。 - -フォーラムの詳しい使い方については、[ヘルプ情報の入手 (リンク先が新しいウィンドウで開きます)](https://www.{DomainName}/docs/support/index.html#getting-help) を参照してください。 - -IBM サポート・チケットを開く方法やサポート・レベルやチケットの重大度については、[サポートへのお問い合わせ (リンク先が新しいウィンドウで開きます)](https://www.{DomainName}/docs/support/index.html#contacting-support) を参照してください。 +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# ツールチェーンについて +{: #toolchains_about} + +最終更新日: 2016 年 9 月 13 日 +{: .last-updated} + +*ツールチェーン*は、開発、デプロイメント、運用の作業をサポートするツール統合のセットです。ツールチェーンの集合的な機能は、個々のツール統合の機能を合わせたものより優れています。 +{:shortdesc} + +ツールチェーンは、{{site.data.keyword.Bluemix}} の Public と Dedicated の環境で使用できます。ツールチェーンを作成する方法は、2 つあります。テンプレートを使用してツールチェーンを作成する方法と、アプリからツールチェーンを作成する方法です。開始点として、ツールチェーン・テンプレートを使用できます。使用するテンプレートに応じて、特定のツール統合のセットが含まれたツールチェーンを作成するか、または、空のツールチェーンを作成してそこにツール統合を追加していくことができます。 + +{{site.data.keyword.Bluemix_notm}} Public の場合、使用するテンプレートまたはツールチェーンによっては、アプリのスターター・コードが設定された GitHub リポジトリーと、事前構成済みのデリバリー・パイプラインがツールチェーンに含まれていることがあります。ツールチェーンの GitHub リポジトリーに変更内容をプッシュすると、デリバリー・パイプラインによってアプリが自動的に作成され、{{site.data.keyword.Bluemix_notm}} にデプロイされます。 + +{{site.data.keyword.Bluemix_notm}} Dedicated の場合、使用するツールチェーンによっては、アプリのスターター・コードが設定された GitHub Enterprise リポジトリーと、事前構成済みのデリバリー・パイプラインがツールチェーンに含まれていることがあります。ツールチェーンの GitHub Enterprise リポジトリーに変更内容をプッシュすると、デリバリー・パイプラインによってアプリが自動的に作成され、{{site.data.keyword.Bluemix_notm}} にデプロイされます。 + +## ツールチェーンのヘルプ情報とサポート +{: #gettinghelp} + +ツールチェーンの使用について問題点や疑問点がある場合は、ヘルプ情報を検索したりフォーラムに質問を投稿したりできます。サポート・チケットを開くことも可能です。 + +フォーラムに質問を投稿する場合は、質問にタグを付けて、{{site.data.keyword.Bluemix_notm}} 開発チームが確認できるようにしてください。 + +* ツールチェーンでのアプリの開発またはデプロイに関する技術的な質問がある場合は、[Stack Overflow (リンク先が新しいウィンドウで開きます)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} に質問を投稿し、「ibm-bluemix」と「devops」というタグを付けてください。 + +* ツールチェーンや概説に関する質問がある場合は、[IBM developerWorks dW Answers (リンク先が新しいウィンドウで開きます)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window} フォーラムを利用してください。「devops-services」と「bluemix」というタグを付けてください。 + +フォーラムの詳しい使い方については、[ヘルプ情報の入手 (リンク先が新しいウィンドウで開きます)](https://www.{DomainName}/docs/support/index.html#getting-help) を参照してください。 + +IBM サポート・チケットを開く方法やサポート・レベルやチケットの重大度については、[サポートへのお問い合わせ (リンク先が新しいウィンドウで開きます)](https://www.{DomainName}/docs/support/index.html#contacting-support) を参照してください。 diff --git a/toolchains/nl/ja/toolchains_integrations.md b/toolchains/nl/ja/toolchains_integrations.md index 0b6d0836c..76ea3d648 100644 --- a/toolchains/nl/ja/toolchains_integrations.md +++ b/toolchains/nl/ja/toolchains_integrations.md @@ -1,311 +1,311 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# ツール統合の構成 -{: #integrations} - -最終更新日: 2016 年 10 月 18 日 -{: .last-updated} - -ツールチェーンを作成するときに開発、デプロイメント、運用の作業をサポートするツール統合を構成したり、既存のツールチェーンにツール統合を追加、構成してカスタマイズしたりできます。 -{:shortdesc} - -**重要**: {{site.data.keyword.Bluemix_notm}} Public の場合、ツールチェーンは米国南部地域でのみ利用可能です。 - -ツールチェーンに追加して構成できるツール統合は、ツールチェーンを {{site.data.keyword.Bluemix_notm}} Public で使用するか {{site.data.keyword.Bluemix_notm}} Dedicated で使用するかによって異なります。 -{{site.data.keyword.Bluemix_notm}} Dedicated でツールチェーンを使用している場合、利用可能なツール統合は、特定の環境で {{site.data.keyword.jazzhub_title}} がセットアップされる方法によって異なります。 - -*表 1. {{site.data.keyword.Bluemix_notm}} Public と Dedicated のツールチェーンで使用できるツール統合* - -|ツール統合 |{{site.data.keyword.Bluemix_notm}} Public で利用可能 |{{site.data.keyword.Bluemix_notm}} Dedicated で利用可能 (環境依存)| -|:----------|:------------------------------|:------------------| -|{{site.data.keyword.deliverypipeline}} |可 |可 | -|{{site.data.keyword.DRA_short}} |可 |不可 | -|Eclipse Orion {{site.data.keyword.webide}} |可 |可 | -|GitHub |可 |可 | -|Dedicated GitHub Enterprise |不可 |可 | -|他のツール |可 |可 | -|PagerDuty |可 |可 | -|Sauce Labs |可 |不可 | -|Slack |可 |可 | - -**ヒント**: {{site.data.keyword.Bluemix_notm}} Public でソース・コードの開発を開始する場合は、{{site.data.keyword.deliverypipeline}} を構成する前に GitHub ツール統合を構成してください。 -{{site.data.keyword.Bluemix_notm}} Dedicated でコードの開発を開始する場合は、{{site.data.keyword.deliverypipeline}} を構成する前に {{site.data.keyword.ghe_short}} ツール統合または GitHub ツール統合を構成してください。 - - -## Delivery Pipeline の構成 -{: #deliverypipeline} - -{{site.data.keyword.deliverypipeline}} は、入力を取得してビルド、テスト、デプロイメントなどのジョブを実行する一連のステージによって、プロジェクトの継続的デプロイメントを自動化します。 - -{{site.data.keyword.deliverypipeline}} を構成し、アプリケーションの継続的なビルド、テスト、デプロイメントを自動化します。 - -1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、「構成可能な統合 (Configurable Integrations)」セクションで、**「Delivery Pipeline」**をクリックします。使用するテンプレートに応じて、異なるフィールドを利用できます。デフォルトのフィールド値を確認し、必要に応じてそれらの設定を変更します。 -1. {{site.data.keyword.Bluemix_notm}} Public のツールチェーンにこのツール統合を追加する場合は、DevOps ダッシュボードの **「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。{{site.data.keyword.Bluemix_notm}} Dedicated でツールチェーンを使用する場合は、ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 追加ボタン (+) をクリックします。 -1. 「ツール統合 (Tool Integrations)」セクションで、**「Delivery Pipeline」**をクリックします。 -1. 新しいパイプラインの名前を指定します。 -1. パイプラインを使用してユーザー・インターフェースをデプロイしようと計画している場合は、**「表示可能なアプリケーション (Viewable App)」**チェック・ボックスにチェック・マークを付けます。パイプラインで作成されるすべてのアプリケーションが、ツールチェーンの「ツール統合 (Tool Integrations) 」ページの**「アプリの表示 (VIEW APP)」**リストに表示されます。 -1. **「統合の作成 (Create Integration)」**をクリックして、{{site.data.keyword.deliverypipeline}} をツールチェーンに追加します。 -1. {{site.data.keyword.deliverypipeline}} のタイルをクリックし、パイプラインを表示して構成します。パイプラインの構成方法の基本を確認するには、[パイプラインのビルドとデプロイ (リンク先が新しいウィンドウで開きます)](../services/DeliveryPipeline/build_deploy.html){: new_window} を参照してください。 - - **ヒント**: 変更を GitHub または {{site.data.keyword.ghe_short}} のリポジトリーにプッシュしたときにパイプラインをトリガーしたい場合は、パイプラインのステージを定義する前に、ツールチェーン用の GitHub または {{site.data.keyword.ghe_short}} を構成しておく必要があります。パイプラインのステージには、リポジトリーの Git URL が必要です。パイプラインのステージごとに、ツールチェーンに関連付けられている GitHub または {{site.data.keyword.ghe_short}} のリポジトリーを 1 つだけ参照できます。GitHub の構成手順については、[GitHub](#github) のセクションを参照してください。Dedicated GitHub Enterprise の構成手順については、[{{site.data.keyword.ghe_long}} の概要 (リンク先が新しいウィンドウで開きます)](../services/ghededicated/index.html){: new_window} を参照してください。 - -1. オプション: {{site.data.keyword.Bluemix_notm}} Public でツールチェーンを使用している環境で Sauce Labs によってアプリのテストを実行したい場合は、{{site.data.keyword.deliverypipeline}} を構成して Sauce Labs テスト・ジョブを追加します。テスト・ジョブの構成手順については、「[パイプラインに SauceLabs テスト・ジョブを構成する](#config_saucelabs)」セクションを参照してください。 - -### パイプラインに Sauce Labs テスト・ジョブを構成する -{: #config_saucelabs} - -パイプラインに Sauce Labs テスト・ジョブを構成する前に、アプリケーションをビルドしてデプロイするためのステージを含む、正常に機能するパイプラインが存在していなければなりません。また、ツールチェーンに Sauce Labs を構成しておく必要もあります。Sauce Labs の構成手順については、[Sauce Labs](#saucelabs)のセクションを参照してください。 - -{{site.data.keyword.deliverypipeline}} を構成して Sauce Labs テスト・ジョブを追加します。 - -1. アプリケーションのテスト・バージョンをデプロイするステージがない場合は作成します。 -1. そのステージのデプロイ・ジョブの後にテスト・ジョブを追加します。これらのジョブを同じステージに配置することで、両方のジョブで同じ環境プロパティーのセットを利用できます。 -![テスト・ジョブ -](images/toolchain_test_job.png) - -1. ステージを構成します。 - - a. **「環境プロパティー (ENVIRONMENT PROPERTIES)」**タブで、CF_APP_NAME、SAUCE_USERNAME、および SAUCE_ACCESS_KEY の 3 つのプロパティーを作成します。 - - b. Sauce Labs のユーザー名とアクセス・キーを入力します。こうすることで、これらの値を外部化し、テストで利用できるようになります。 - -1. デプロイ・ジョブを構成します。**「デプロイ・スクリプト (Deploy Script)」**フィールドに `export CF_APP_NAME="$CF_APP"` というコマンドを入力します。このコマンドは、アプリケーション名を環境プロパティーとしてエクスポートします。 -1. テスト・ジョブを構成します。次の図は、値の例を示しています。 -**「サービス・インスタンス」**、**「ターゲット」**、**「組織」**、**「スペース」**の各フィールドには、使用中の Sauce Labs のユーザー名、地域、組織、スペースが取り込まれます。 -![ジョブの構成](images/toolchain_configure_job.png) - - a. テスター・タイプでは、**「Sauce Labs」**を選択します。 - - b. サービス・インスタンスでは、ツールチェーンに Sauce Labs を構成したときに使用した Sauce Labs のユーザー名を選択します。 - - **ヒント**: ツールチェーンで Sauce Labs を構成したときに使用したユーザー名とアクセス・キーを確認するには、**「構成」**をクリックします。 - - c. **「テスト実行コマンド (Test Execution Command)」**フィールドに、テストに必要な依存関係をインストールしてテストを実行するコマンドを入力します。例えば、Node.js アプリをテストする場合は、次のコマンドを入力します。 - ``` -npm install - node_modules/grunt-cli/bin/grunt test:sauce:parallel - ``` - - d. テスト・ジョブ・ログでテストのレポートを確認する場合は、**「テスト・レポートを有効にする (Enable Test Report)」**チェック・ボックスにチェックマークを付け、「テスト結果のファイル・パターン (Test Result File Pattern)」を `test/*.xml` に設定します。 - -1. **「保存」**をクリックします。パイプラインが実行されるときには必ず Sauce Labs のテストが実行されます。 - -詳しくは、[Delivery Pipeline (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window} を参照してください。 - - -## {{site.data.keyword.DRA_short}} の追加 -{: #dra} - -{{site.data.keyword.DRA_full}} は、単体テスト、機能テスト、およびコード・カバレッジ・ツールからの結果を収集して分析し、コードがデプロイメント・プロセスの指定されたゲートで事前定義の基準を満たすかどうかを判断します。コードが基準を満たしていない、または基準を超えていない場合、リスクがリリースされないように、デプロイメントが停止されます。継続的デリバリー環境のセーフティー・ネットとして、または品質基準を実装して向上させる方法として、{{site.data.keyword.DRA_short}} を使用できます。 - - **注記**: このツール統合は、事前構成されています。構成パラメーターは不要で、再構成はできません。 - -{{site.data.keyword.DRA_short}} を追加し、デプロイメントをモニタリングしてリリース前にリスクを洗い出すことで、{{site.data.keyword.Bluemix_notm}} のコードの品質を維持し、向上させることができます。 - -1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 追加ボタン (+) をクリックします。 -1. 「ツール統合 (Tool Integrations)」セクションで、**「Deployment Risk Analytics」**をクリックします。 -1. **「統合の作成 (Create Integration)」**をクリックします。 -1. {{site.data.keyword.DRA_short}} のタイルをクリックし、基準を作成する、基準をパイプラインに接続する、パイプラインを実行する、という開始手順を完了させます。詳しくは、[{{site.data.keyword.DRA_short}} (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window} を参照してください。 - - -## Eclipse Orion {{site.data.keyword.webide}} の追加 -{: #webide} - -Eclipse Orion {{site.data.keyword.webide}} は、ソース管理タスクを作成、編集、実行、デバッグ、完了できる Web ベースの統合環境です。 -編集から実行、送信、そしてデプロイまで、シームレスに行うことができます。 - - **注記**: このツール統合は、事前構成されています。構成パラメーターは不要で、再構成はできません。 - -ソース管理タスクを完了させるために、Eclipse Orion {{site.data.keyword.webide}} ツール統合を追加します。 - -1. {{site.data.keyword.Bluemix_notm}} Public のツールチェーンにこのツール統合を追加する場合は、DevOps ダッシュボードの **「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。{{site.data.keyword.Bluemix_notm}} Dedicated でツールチェーンを使用する場合は、ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 追加ボタン (+) をクリックします。 -1. 「ツール統合 (Tool Integrations)」セクションで、**「Eclipse Orion Web IDE」**をクリックします。 -1. **「統合の作成 (Create Integration)」**をクリックします。 -1. 新しい Eclipse Orion {{site.data.keyword.webide}} のタイルをクリックします。ワークスペースに GitHub または {{site.data.keyword.ghe_short}} のリポジトリーが取り込まれます。現在のツールチェーンに関連付けられたリポジトリーが強調表示されます。 - -詳しくは、[Eclipse Orion {{site.data.keyword.webide}} によるコードの編集 (リンク先が新しいウィンドウで開きます)](../toolchains/web_ide.html){: new_window} を参照してください。 - - -## GitHub の構成 -{: #github} - -GitHub は、Web ベースの Git リポジトリー・ホスティング・サービスです。リポジトリーのローカルとリモートの両方のコピーを持つことができるので、共同作業が容易になります。 - -GitHub Issues は、作業と計画をすべて 1 カ所に保持するトラッキング・ツールです。開発リポジトリーに統合されるため、重要なタスクに集中できます。 - -GitHub を構成して、クラウドでソース・コードを管理します。 - -1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、次の手順を実行します。 - - a. 「構成可能な統合 (Configurable Integrations)」セクションで、**「GitHub」**をクリックします。{{site.data.keyword.Bluemix_notm}} Public でツールチェーンを作成し、GitHub へのアクセスを {{site.data.keyword.Bluemix_notm}} に許可していない場合は、**「許可 (Authorize)」**をクリックして、GitHub の Web サイトに移動します。アクティブな GitHub セッションがない場合は、ログインを求めるプロンプトが出されます。**「アプリケーションを許可 (Authorize Application)」**をクリックして、{{site.data.keyword.Bluemix_notm}} が GitHub アカウントにアクセスできるようにします。アクティブな GitHub セッションがあるが、最近パスワードを入力していない場合は、確認のために GitHub パスワードを入力するよう求めるプロンプトが出される場合があります。 - - b. GitHub リポジトリーのデフォルトのターゲット・リポジトリーのロケーションを確認します。これらのリポジトリーは、サンプル・リポジトリーのクローンです。必要に応じて、ターゲット・リポジトリーの名前を変更します。 -![デフォルトのターゲット・リポジトリーのロケーション](images/toolchain_github_config.png) - -1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 追加ボタン (+) をクリックします。 -1. 「ツール統合 (Tool Integrations)」セクションで、**「GitHub」**をクリックします。 -1. 既存の GitHub リポジトリーを使用する場合は、その URL を入力します。リポジトリー・タイプで、**「リンク (Link)」**をクリックします。 -1. 新しい GitHub リポジトリーを使用する場合は、GitHub リポジトリーの名前を入力し、クローン作成またはフォークするリポジトリーの URL を入力し、リポジトリーのタイプを選択します。 - - a. 空のリポジトリーを作成するには、**「新規 (New)」**をクリックします。 - - b. GitHub リポジトリーのコピーを作成するには、**「クローンを作成する (Clone)」**をクリックします。 - - c. プル要求により変更を提出できるように GitHub リポジトリーをフォークするには、**「フォーク (Fork)」**をクリックします。 - -1. 問題のトラッキングに GitHub Issues を使用する場合は、**「GitHub Issues を使用可能にする (Enable GitHub Issues)」**チェック・ボックスにチェック・マークを付けます。 -1. **「統合の作成 (Create Integration)」**をクリックします。 -1. 操作する GitHub リポジトリーのタイルをクリックします。GitHub の Web サイトが開きます。そこでリポジトリーの内容を表示できます。 - - **ヒント**: Eclipse Orion {{site.data.keyword.webide}} の統合されたソース・コード管理ツールを使用して、GitHub リポジトリーを編集し、ワークスペースからアプリをデプロイできます。 - -1. GitHub Issues を有効にした場合は、GitHub Issues のタイルをクリックして開きます。 - -詳しくは、[GitHub (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} と [GitHub Issues (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window} を参照してください。 - - -## Dedicated GitHub Enterprise の構成 -{: #configghe} - -{{site.data.keyword.ghe_long}} は、オンプレミス型の Web ベースの Git リポジトリー・ホスティング・サービスです。Dedicated GitHub Enterprise は {{site.data.keyword.Bluemix_notm}} Dedicated ユーザー専用です。GitHub Issues は、作業と計画を 1 カ所に保持するトラッキング・ツールです。開発リポジトリーに統合されるため、重要なタスクに集中できます。Dedicated GitHub Enterprise と GitHub Issues の詳細については、[Dedicated GitHub Enterprise の使い方 (リンク先が新しいウィンドウで開きます)](../services/ghededicated/index.html){: new_window} と [GitHub Issues (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window} を参照してください。 - -{{site.data.keyword.ghe_short}} をツールチェーンのツール統合として構成すれば、会社の [{{site.data.keyword.Bluemix_notm}} Dedicated (リンク先が新しいウィンドウで開きます)](../dedicated/index.html#dedicated){: new_window} インスタンスでソース・コードを管理できます。 - -1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、次の手順を実行します。 - - a. Dedicated GitHub Enterprise に初めてログインする前に、LDAP を使用して会社のユーザー・レジストリーからあなたのユーザー ID を {{site.data.keyword.Bluemix_notm}} Dedicated インスタンスに追加するよう、会社の地域管理者に依頼してください。{{site.data.keyword.ghe_short}} アカウントの設定については、[Dedicated GitHub Enterprise の使い方 (リンク先が新しいウィンドウで開きます)](../services/ghededicated/index.html){: new_window} を参照してください。 - - b. 「構成可能な統合 (Configurable Integrations)」セクションで、**「{{site.data.keyword.ghe_short}}」**をクリックします。 - - c. 新しい {{site.data.keyword.ghe_short}} リポジトリーのデフォルト名を確認します。必要に応じて新しいリポジトリーの名前を変更してください。以下の画像は、サンプル・リポジトリーから複製したリポジトリーの例です。既存のリポジトリーを使用することも、新しいリポジトリーを使用することもできます。新しいリポジトリーを使用する場合は、空のリポジトリーを作成するか、リポジトリーのクローンを作成するか、リポジトリーをフォークします。![リポジトリーのデフォルトの場所](images/toolchain_ghe_config.png) - -1. {{site.data.keyword.Bluemix_notm}} Public のツールチェーンにこのツール統合を追加する場合は、DevOps ダッシュボードの **「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。{{site.data.keyword.Bluemix_notm}} Dedicated でツールチェーンを使用する場合は、ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 追加ボタン (+) をクリックします。 -1. 「ツール統合 (Tool Integrations)」セクションで、**「{{site.data.keyword.ghe_short}}」**をクリックします。 -1. 既存の {{site.data.keyword.ghe_short}} リポジトリーを使用する場合は、そのリポジトリーの URL を入力します。リポジトリーのタイプとして、**「既存」**をクリックしてください。 -1. 新しい {{site.data.keyword.ghe_short}} リポジトリーを使用する場合は、そのリポジトリーの名前を入力し、クローンを作成またはフォークする対象のリポジトリーの URL を入力し、リポジトリーのタイプを選択します。 - - a. 空のリポジトリーを作成するには、**「新規 (New)」**をクリックします。 - - b. リポジトリーのコピーを作成するには、**「クローンを作成する (Clone)」**をクリックします。 - - c. プル要求により変更を提出できるようにリポジトリーをフォークするには、**「フォーク (Fork)」**をクリックします。 - -1. 問題のトラッキングに GitHub Issues を使用する場合は、**「GitHub Issues を使用可能にする (Enable GitHub Issues)」**チェック・ボックスにチェック・マークを付けます。 -1. **「統合の作成 (Create Integration)」**をクリックします。 -1. 操作する {{site.data.keyword.ghe_short}} リポジトリーのタイルをクリックします。会社の [{{site.data.keyword.Bluemix_notm}} Dedicated (リンク先が新しいウィンドウで開きます)](../dedicated/index.html#dedicated){: new_window} インスタンスが開きます。そこでリポジトリーの内容を表示できます。 - - **ヒント**: Eclipse Orion {{site.data.keyword.webide}} の統合されたソース・コード管理ツールを使用して、{{site.data.keyword.ghe_short}} リポジトリーを編集し、ワークスペースからアプリをデプロイできます。 - -1. GitHub Issues を有効にした場合は、GitHub Issues のタイルをクリックします。 - - - -## カスタム・ツール (他のツール) の構成 -{: #othertool} - -チームが、ツールチェーン統合リストに含まれていないツールを使用する場合、カスタム・ツールを統合できます。 - -カスタム・ツールを構成し、それがツールチェーンで他のツールと連携し、チームで利用可能になるようにします。 -1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、「構成可能な統合 (Configurable Integrations)」セクションで、**「他のツール (Other Tool)」**をクリックします。 - -1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 追加ボタン (+) をクリックします。 -1. 「ツール統合 (Tool Integrations)」セクションで、**「他のツール (Other Tool)」**をクリックします。 -1. ツール名を入力します。 -1. ツールに最も関連の強いライフサイクル・フェーズを選択します。ライフサイクル・フェーズの選択は、「ツールチェーン統合 (Toolchains Integrations)」ページのどのカテゴリーの下に -ツールがリストされるかを決定します。 -1. アイコンの URL を追加します。アイコンは、ご使用のツールの統合カードに表示されます。 -1. 資料 URL を追加します。 -1. ツール・インスタンス名を指定します。例えば: マイ・チーム・ツール。 -1. ツール・インスタンスの URL を追加します。ツール統合カードをクリックすると、ツール・インスタンス用にリストした URL に移動します。 -1. ツールの説明を追加します。 -1. (拡張機能) 必要に応じて、追加のプロパティーを追加します。例えば、ツールチェーンの他のツールと統合するために、ご使用のツールに必要な情報または属性をリストします。 -1. **「統合の作成 (Create Integration)」**をクリックします。 - -## PagerDuty の構成 -{: #pagerduty} - -PagerDuty は、複数のモニタリング・システムのデータを単一のビューに統合します。問題が発生すると、PagerDuty はそのとき問題を修正できる最適なチーム・メンバーに通知します。そのチーム・メンバーが問題に対応しない場合は、エスカレーションを構成して、2 番目のエンジニアまたは運用マネージャーに転送することができます。 - -パイプライン・ステージの障害が発生したときに通知を送信するよう PagerDuty を構成し、問題を迅速に修正して、ダウン時間を減少できるようにします。 - -1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、「構成可能な統合 (Configurable Integrations)」セクションで、**「PagerDuty」**をクリックします。 -1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 追加ボタン (+) をクリックします。 -1. 「ツール統合 (Tool Integrations)」セクションで、**「PagerDuty」**をクリックします。 -1. PagerDuty アカウントと関連付けられている PagerDuty のサイト名を入力します。PagerDuty アカウントがない場合は、[アカウントを登録します (リンク先が新しいウィンドウで開きます)](https://signup.pagerduty.com/accounts/new){: new_window}。 -1. PagerDuty アカウントの API アクセス・キーを入力します。キーを確認する方法については、[API 認証 (リンク先が新しいウィンドウで開きます)](https://signup.pagerduty.com/accounts/new){: new_window} を参照してください。 -1. PagerDuty サービスの名前を入力します。 -1. PagerDuty の 1 次連絡先の E メール・アドレスを入力します。 -1. PagerDuty の 1 次連絡先の電話番号を入力します。 -1. **「統合の作成 (Create Integration)」**をクリックします。 -1. PagerDuty のタイルをクリックして、pagerduty.com にアクセスします。ツールチェーンに対してこのツール統合を構成したときに指定した、PagerDuty サービスに関連付けられているイベントを表示できます。 - -詳しくは、[PagerDuty (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window} を参照してください。 - - -## Sauce Labs の構成 -{: #saucelabs} - -Sauce Labs は、機能単体テストを実行します。Sauce Labs のテスト・スイートを {{site.data.keyword.deliverypipeline}} にテスト・ジョブとして構成した場合、テスト・スイートは、継続的デリバリー・プロセスの一部として Web アプリケーションまたはモバイル・アプリケーションに対してテストを実行できます。これらのテストは、プロジェクトの重要なフロー制御を提供し、誤ったコードのデプロイメントを防ぐゲートとして機能します。 - -自動化された機能テストを複数のオペレーティング・システムとブラウザーで実行するように Sauce Labs を構成します。これにより、ユーザーが Web サイトまたはアプリケーションを使用する可能性がある方法をエミュレートできます。 - -1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、「構成可能な統合 (Configurable Integrations)」セクションで、**「Sauce Labs」**をクリックします。 -1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 追加ボタン (+) をクリックします。 -1. 「ツール統合 (Tool Integrations)」セクションで、**「Sauce Labs」**をクリックします。 -1. Sauce Labs アカウントと関連付けられているユーザー名を入力します。[Sauce Labs アカウント・ページの上部にあるウェルカム・メッセージでユーザー名を確認できます (リンク先が新しいウィンドウで開きます)](https://saucelabs.com/account){: new_window}。 -1. Sauce Labs アカウントのアクセス・キーを入力します。[Sauce Labs アカウント・ページでキーを確認できます (リンク先が新しいウィンドウで開きます)](https://saucelabs.com/account){: new_window}。 -1. **「統合の作成 (Create Integration)」**をクリックします。 -1. Sauce Labs のタイルをクリックして、saucelabs.com に移動し、ツールチェーンのテスト・アクティビティーを表示します。 - - **ヒント**: Sauce Labs テスト・ジョブを {{site.data.keyword.deliverypipeline}} に追加した場合は、サービス・インスタンスを選択できます。 - -詳しくは、[Sauce Labs (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window} を参照してください。 - - -## Slack の構成 -{: #slack} - -**重要**: Slack の公開チャネルに投稿された通知は、チームの全員に表示されます。投稿したコンテンツの責任はお客様が負うことに注意してください。 - -Slack は、リアルタイム・メッセージングと通知を提供するクラウド・ベースのシステムです。 -Slack が提供する永続的なチャットは、E メールの代わりに使用できる対話性に優れたチームのコラボレーション手段になります。 -チームとのコミュニケーションには、専用チャネルを使用することも、作業に直接関連する一連のチャネルを使用することもできます。また、チャネルを通じて、または 2 人以上のメンバーでのダイレクト・メッセージで、ファイルとイメージを共有することもできます。ダイレクト・メッセージとチャネル上の通信は保持されるため、検索することができます。 - -テストやデプロイのアクティビティーなどのツールチェーンに関する通知をツール統合から受信するように Slack を構成します。 - -1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、「構成可能な統合 (Configurable Integrations)」セクションで、**「Slack」**をクリックします。 -1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 追加ボタン (+) をクリックします。 -1. 「ツール統合 (Tool Integrations)」セクションで、**「Slack」**をクリックします。 -1. Slack アカウントの API 認証トークンを入力します。Slack での認証には、生成されたフルアクセス・トークンを使用する必要があります。トークンを確認する方法については、[Slack 認証 (リンク先が新しいウィンドウで開きます)](https://api.slack.com/web#authentication){: new_window} を参照してください。 -1. 通知を送信する Slack チャネルの名前を入力します。指定したチャネルが存在しない場合は、そのチャネルが作成されます。チャネルがアーカイブされたら、再アクティブ化します。 -1. **「統合の作成 (Create Integration)」**をクリックします。 -1. Slack のタイルをクリックします。構成した Slack チャネルでツールチェーンのアクティビティーをすべて表示できます。 - -詳しくは、[Slack (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window} を参照してください。 - - - - - - - - +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# ツール統合の構成 +{: #integrations} + +最終更新日: 2016 年 10 月 18 日 +{: .last-updated} + +ツールチェーンを作成するときに開発、デプロイメント、運用の作業をサポートするツール統合を構成したり、既存のツールチェーンにツール統合を追加、構成してカスタマイズしたりできます。 +{:shortdesc} + +**重要**: {{site.data.keyword.Bluemix_notm}} Public の場合、ツールチェーンは米国南部地域でのみ利用可能です。 + +ツールチェーンに追加して構成できるツール統合は、ツールチェーンを {{site.data.keyword.Bluemix_notm}} Public で使用するか {{site.data.keyword.Bluemix_notm}} Dedicated で使用するかによって異なります。 +{{site.data.keyword.Bluemix_notm}} Dedicated でツールチェーンを使用している場合、利用可能なツール統合は、特定の環境で {{site.data.keyword.jazzhub_title}} がセットアップされる方法によって異なります。 + +*表 1. {{site.data.keyword.Bluemix_notm}} Public と Dedicated のツールチェーンで使用できるツール統合* + +|ツール統合 |{{site.data.keyword.Bluemix_notm}} Public で利用可能 |{{site.data.keyword.Bluemix_notm}} Dedicated で利用可能 (環境依存)| +|:----------|:------------------------------|:------------------| +|{{site.data.keyword.deliverypipeline}} |可 |可 | +|{{site.data.keyword.DRA_short}} |可 |不可 | +|Eclipse Orion {{site.data.keyword.webide}} |可 |可 | +|GitHub |可 |可 | +|Dedicated GitHub Enterprise |不可 |可 | +|他のツール |可 |可 | +|PagerDuty |可 |可 | +|Sauce Labs |可 |不可 | +|Slack |可 |可 | + +**ヒント**: {{site.data.keyword.Bluemix_notm}} Public でソース・コードの開発を開始する場合は、{{site.data.keyword.deliverypipeline}} を構成する前に GitHub ツール統合を構成してください。 +{{site.data.keyword.Bluemix_notm}} Dedicated でコードの開発を開始する場合は、{{site.data.keyword.deliverypipeline}} を構成する前に {{site.data.keyword.ghe_short}} ツール統合または GitHub ツール統合を構成してください。 + + +## Delivery Pipeline の構成 +{: #deliverypipeline} + +{{site.data.keyword.deliverypipeline}} は、入力を取得してビルド、テスト、デプロイメントなどのジョブを実行する一連のステージによって、プロジェクトの継続的デプロイメントを自動化します。 + +{{site.data.keyword.deliverypipeline}} を構成し、アプリケーションの継続的なビルド、テスト、デプロイメントを自動化します。 + +1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、「構成可能な統合 (Configurable Integrations)」セクションで、**「Delivery Pipeline」**をクリックします。使用するテンプレートに応じて、異なるフィールドを利用できます。デフォルトのフィールド値を確認し、必要に応じてそれらの設定を変更します。 +1. {{site.data.keyword.Bluemix_notm}} Public のツールチェーンにこのツール統合を追加する場合は、DevOps ダッシュボードの **「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。{{site.data.keyword.Bluemix_notm}} Dedicated でツールチェーンを使用する場合は、ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 追加ボタン (+) をクリックします。 +1. 「ツール統合 (Tool Integrations)」セクションで、**「Delivery Pipeline」**をクリックします。 +1. 新しいパイプラインの名前を指定します。 +1. パイプラインを使用してユーザー・インターフェースをデプロイしようと計画している場合は、**「表示可能なアプリケーション (Viewable App)」**チェック・ボックスにチェック・マークを付けます。パイプラインで作成されるすべてのアプリケーションが、ツールチェーンの「ツール統合 (Tool Integrations) 」ページの**「アプリの表示 (VIEW APP)」**リストに表示されます。 +1. **「統合の作成 (Create Integration)」**をクリックして、{{site.data.keyword.deliverypipeline}} をツールチェーンに追加します。 +1. {{site.data.keyword.deliverypipeline}} のタイルをクリックし、パイプラインを表示して構成します。パイプラインの構成方法の基本を確認するには、[パイプラインのビルドとデプロイ (リンク先が新しいウィンドウで開きます)](../services/DeliveryPipeline/build_deploy.html){: new_window} を参照してください。 + + **ヒント**: 変更を GitHub または {{site.data.keyword.ghe_short}} のリポジトリーにプッシュしたときにパイプラインをトリガーしたい場合は、パイプラインのステージを定義する前に、ツールチェーン用の GitHub または {{site.data.keyword.ghe_short}} を構成しておく必要があります。パイプラインのステージには、リポジトリーの Git URL が必要です。パイプラインのステージごとに、ツールチェーンに関連付けられている GitHub または {{site.data.keyword.ghe_short}} のリポジトリーを 1 つだけ参照できます。GitHub の構成手順については、[GitHub](#github) のセクションを参照してください。Dedicated GitHub Enterprise の構成手順については、[{{site.data.keyword.ghe_long}} の概要 (リンク先が新しいウィンドウで開きます)](../services/ghededicated/index.html){: new_window} を参照してください。 + +1. オプション: {{site.data.keyword.Bluemix_notm}} Public でツールチェーンを使用している環境で Sauce Labs によってアプリのテストを実行したい場合は、{{site.data.keyword.deliverypipeline}} を構成して Sauce Labs テスト・ジョブを追加します。テスト・ジョブの構成手順については、「[パイプラインに SauceLabs テスト・ジョブを構成する](#config_saucelabs)」セクションを参照してください。 + +### パイプラインに Sauce Labs テスト・ジョブを構成する +{: #config_saucelabs} + +パイプラインに Sauce Labs テスト・ジョブを構成する前に、アプリケーションをビルドしてデプロイするためのステージを含む、正常に機能するパイプラインが存在していなければなりません。また、ツールチェーンに Sauce Labs を構成しておく必要もあります。Sauce Labs の構成手順については、[Sauce Labs](#saucelabs)のセクションを参照してください。 + +{{site.data.keyword.deliverypipeline}} を構成して Sauce Labs テスト・ジョブを追加します。 + +1. アプリケーションのテスト・バージョンをデプロイするステージがない場合は作成します。 +1. そのステージのデプロイ・ジョブの後にテスト・ジョブを追加します。これらのジョブを同じステージに配置することで、両方のジョブで同じ環境プロパティーのセットを利用できます。 +![テスト・ジョブ +](images/toolchain_test_job.png) + +1. ステージを構成します。 + + a. **「環境プロパティー (ENVIRONMENT PROPERTIES)」**タブで、CF_APP_NAME、SAUCE_USERNAME、および SAUCE_ACCESS_KEY の 3 つのプロパティーを作成します。 + + b. Sauce Labs のユーザー名とアクセス・キーを入力します。こうすることで、これらの値を外部化し、テストで利用できるようになります。 + +1. デプロイ・ジョブを構成します。**「デプロイ・スクリプト (Deploy Script)」**フィールドに `export CF_APP_NAME="$CF_APP"` というコマンドを入力します。このコマンドは、アプリケーション名を環境プロパティーとしてエクスポートします。 +1. テスト・ジョブを構成します。次の図は、値の例を示しています。 +**「サービス・インスタンス」**、**「ターゲット」**、**「組織」**、**「スペース」**の各フィールドには、使用中の Sauce Labs のユーザー名、地域、組織、スペースが取り込まれます。 +![ジョブの構成](images/toolchain_configure_job.png) + + a. テスター・タイプでは、**「Sauce Labs」**を選択します。 + + b. サービス・インスタンスでは、ツールチェーンに Sauce Labs を構成したときに使用した Sauce Labs のユーザー名を選択します。 + + **ヒント**: ツールチェーンで Sauce Labs を構成したときに使用したユーザー名とアクセス・キーを確認するには、**「構成」**をクリックします。 + + c. **「テスト実行コマンド (Test Execution Command)」**フィールドに、テストに必要な依存関係をインストールしてテストを実行するコマンドを入力します。例えば、Node.js アプリをテストする場合は、次のコマンドを入力します。 + ``` +npm install + node_modules/grunt-cli/bin/grunt test:sauce:parallel + ``` + + d. テスト・ジョブ・ログでテストのレポートを確認する場合は、**「テスト・レポートを有効にする (Enable Test Report)」**チェック・ボックスにチェックマークを付け、「テスト結果のファイル・パターン (Test Result File Pattern)」を `test/*.xml` に設定します。 + +1. **「保存」**をクリックします。パイプラインが実行されるときには必ず Sauce Labs のテストが実行されます。 + +詳しくは、[Delivery Pipeline (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window} を参照してください。 + + +## {{site.data.keyword.DRA_short}} の追加 +{: #dra} + +{{site.data.keyword.DRA_full}} は、単体テスト、機能テスト、およびコード・カバレッジ・ツールからの結果を収集して分析し、コードがデプロイメント・プロセスの指定されたゲートで事前定義の基準を満たすかどうかを判断します。コードが基準を満たしていない、または基準を超えていない場合、リスクがリリースされないように、デプロイメントが停止されます。継続的デリバリー環境のセーフティー・ネットとして、または品質基準を実装して向上させる方法として、{{site.data.keyword.DRA_short}} を使用できます。 + + **注記**: このツール統合は、事前構成されています。構成パラメーターは不要で、再構成はできません。 + +{{site.data.keyword.DRA_short}} を追加し、デプロイメントをモニタリングしてリリース前にリスクを洗い出すことで、{{site.data.keyword.Bluemix_notm}} のコードの品質を維持し、向上させることができます。 + +1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 追加ボタン (+) をクリックします。 +1. 「ツール統合 (Tool Integrations)」セクションで、**「Deployment Risk Analytics」**をクリックします。 +1. **「統合の作成 (Create Integration)」**をクリックします。 +1. {{site.data.keyword.DRA_short}} のタイルをクリックし、基準を作成する、基準をパイプラインに接続する、パイプラインを実行する、という開始手順を完了させます。詳しくは、[{{site.data.keyword.DRA_short}} (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window} を参照してください。 + + +## Eclipse Orion {{site.data.keyword.webide}} の追加 +{: #webide} + +Eclipse Orion {{site.data.keyword.webide}} は、ソース管理タスクを作成、編集、実行、デバッグ、完了できる Web ベースの統合環境です。 +編集から実行、送信、そしてデプロイまで、シームレスに行うことができます。 + + **注記**: このツール統合は、事前構成されています。構成パラメーターは不要で、再構成はできません。 + +ソース管理タスクを完了させるために、Eclipse Orion {{site.data.keyword.webide}} ツール統合を追加します。 + +1. {{site.data.keyword.Bluemix_notm}} Public のツールチェーンにこのツール統合を追加する場合は、DevOps ダッシュボードの **「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。{{site.data.keyword.Bluemix_notm}} Dedicated でツールチェーンを使用する場合は、ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 追加ボタン (+) をクリックします。 +1. 「ツール統合 (Tool Integrations)」セクションで、**「Eclipse Orion Web IDE」**をクリックします。 +1. **「統合の作成 (Create Integration)」**をクリックします。 +1. 新しい Eclipse Orion {{site.data.keyword.webide}} のタイルをクリックします。ワークスペースに GitHub または {{site.data.keyword.ghe_short}} のリポジトリーが取り込まれます。現在のツールチェーンに関連付けられたリポジトリーが強調表示されます。 + +詳しくは、[Eclipse Orion {{site.data.keyword.webide}} によるコードの編集 (リンク先が新しいウィンドウで開きます)](../toolchains/web_ide.html){: new_window} を参照してください。 + + +## GitHub の構成 +{: #github} + +GitHub は、Web ベースの Git リポジトリー・ホスティング・サービスです。リポジトリーのローカルとリモートの両方のコピーを持つことができるので、共同作業が容易になります。 + +GitHub Issues は、作業と計画をすべて 1 カ所に保持するトラッキング・ツールです。開発リポジトリーに統合されるため、重要なタスクに集中できます。 + +GitHub を構成して、クラウドでソース・コードを管理します。 + +1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、次の手順を実行します。 + + a. 「構成可能な統合 (Configurable Integrations)」セクションで、**「GitHub」**をクリックします。{{site.data.keyword.Bluemix_notm}} Public でツールチェーンを作成し、GitHub へのアクセスを {{site.data.keyword.Bluemix_notm}} に許可していない場合は、**「許可 (Authorize)」**をクリックして、GitHub の Web サイトに移動します。アクティブな GitHub セッションがない場合は、ログインを求めるプロンプトが出されます。**「アプリケーションを許可 (Authorize Application)」**をクリックして、{{site.data.keyword.Bluemix_notm}} が GitHub アカウントにアクセスできるようにします。アクティブな GitHub セッションがあるが、最近パスワードを入力していない場合は、確認のために GitHub パスワードを入力するよう求めるプロンプトが出される場合があります。 + + b. GitHub リポジトリーのデフォルトのターゲット・リポジトリーのロケーションを確認します。これらのリポジトリーは、サンプル・リポジトリーのクローンです。必要に応じて、ターゲット・リポジトリーの名前を変更します。 +![デフォルトのターゲット・リポジトリーのロケーション](images/toolchain_github_config.png) + +1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 追加ボタン (+) をクリックします。 +1. 「ツール統合 (Tool Integrations)」セクションで、**「GitHub」**をクリックします。 +1. 既存の GitHub リポジトリーを使用する場合は、その URL を入力します。リポジトリー・タイプで、**「リンク (Link)」**をクリックします。 +1. 新しい GitHub リポジトリーを使用する場合は、GitHub リポジトリーの名前を入力し、クローン作成またはフォークするリポジトリーの URL を入力し、リポジトリーのタイプを選択します。 + + a. 空のリポジトリーを作成するには、**「新規 (New)」**をクリックします。 + + b. GitHub リポジトリーのコピーを作成するには、**「クローンを作成する (Clone)」**をクリックします。 + + c. プル要求により変更を提出できるように GitHub リポジトリーをフォークするには、**「フォーク (Fork)」**をクリックします。 + +1. 問題のトラッキングに GitHub Issues を使用する場合は、**「GitHub Issues を使用可能にする (Enable GitHub Issues)」**チェック・ボックスにチェック・マークを付けます。 +1. **「統合の作成 (Create Integration)」**をクリックします。 +1. 操作する GitHub リポジトリーのタイルをクリックします。GitHub の Web サイトが開きます。そこでリポジトリーの内容を表示できます。 + + **ヒント**: Eclipse Orion {{site.data.keyword.webide}} の統合されたソース・コード管理ツールを使用して、GitHub リポジトリーを編集し、ワークスペースからアプリをデプロイできます。 + +1. GitHub Issues を有効にした場合は、GitHub Issues のタイルをクリックして開きます。 + +詳しくは、[GitHub (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} と [GitHub Issues (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window} を参照してください。 + + +## Dedicated GitHub Enterprise の構成 +{: #configghe} + +{{site.data.keyword.ghe_long}} は、オンプレミス型の Web ベースの Git リポジトリー・ホスティング・サービスです。Dedicated GitHub Enterprise は {{site.data.keyword.Bluemix_notm}} Dedicated ユーザー専用です。GitHub Issues は、作業と計画を 1 カ所に保持するトラッキング・ツールです。開発リポジトリーに統合されるため、重要なタスクに集中できます。Dedicated GitHub Enterprise と GitHub Issues の詳細については、[Dedicated GitHub Enterprise の使い方 (リンク先が新しいウィンドウで開きます)](../services/ghededicated/index.html){: new_window} と [GitHub Issues (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window} を参照してください。 + +{{site.data.keyword.ghe_short}} をツールチェーンのツール統合として構成すれば、会社の [{{site.data.keyword.Bluemix_notm}} Dedicated (リンク先が新しいウィンドウで開きます)](../dedicated/index.html#dedicated){: new_window} インスタンスでソース・コードを管理できます。 + +1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、次の手順を実行します。 + + a. Dedicated GitHub Enterprise に初めてログインする前に、LDAP を使用して会社のユーザー・レジストリーからあなたのユーザー ID を {{site.data.keyword.Bluemix_notm}} Dedicated インスタンスに追加するよう、会社の地域管理者に依頼してください。{{site.data.keyword.ghe_short}} アカウントの設定については、[Dedicated GitHub Enterprise の使い方 (リンク先が新しいウィンドウで開きます)](../services/ghededicated/index.html){: new_window} を参照してください。 + + b. 「構成可能な統合 (Configurable Integrations)」セクションで、**「{{site.data.keyword.ghe_short}}」**をクリックします。 + + c. 新しい {{site.data.keyword.ghe_short}} リポジトリーのデフォルト名を確認します。必要に応じて新しいリポジトリーの名前を変更してください。以下の画像は、サンプル・リポジトリーから複製したリポジトリーの例です。既存のリポジトリーを使用することも、新しいリポジトリーを使用することもできます。新しいリポジトリーを使用する場合は、空のリポジトリーを作成するか、リポジトリーのクローンを作成するか、リポジトリーをフォークします。![リポジトリーのデフォルトの場所](images/toolchain_ghe_config.png) + +1. {{site.data.keyword.Bluemix_notm}} Public のツールチェーンにこのツール統合を追加する場合は、DevOps ダッシュボードの **「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。{{site.data.keyword.Bluemix_notm}} Dedicated でツールチェーンを使用する場合は、ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 追加ボタン (+) をクリックします。 +1. 「ツール統合 (Tool Integrations)」セクションで、**「{{site.data.keyword.ghe_short}}」**をクリックします。 +1. 既存の {{site.data.keyword.ghe_short}} リポジトリーを使用する場合は、そのリポジトリーの URL を入力します。リポジトリーのタイプとして、**「既存」**をクリックしてください。 +1. 新しい {{site.data.keyword.ghe_short}} リポジトリーを使用する場合は、そのリポジトリーの名前を入力し、クローンを作成またはフォークする対象のリポジトリーの URL を入力し、リポジトリーのタイプを選択します。 + + a. 空のリポジトリーを作成するには、**「新規 (New)」**をクリックします。 + + b. リポジトリーのコピーを作成するには、**「クローンを作成する (Clone)」**をクリックします。 + + c. プル要求により変更を提出できるようにリポジトリーをフォークするには、**「フォーク (Fork)」**をクリックします。 + +1. 問題のトラッキングに GitHub Issues を使用する場合は、**「GitHub Issues を使用可能にする (Enable GitHub Issues)」**チェック・ボックスにチェック・マークを付けます。 +1. **「統合の作成 (Create Integration)」**をクリックします。 +1. 操作する {{site.data.keyword.ghe_short}} リポジトリーのタイルをクリックします。会社の [{{site.data.keyword.Bluemix_notm}} Dedicated (リンク先が新しいウィンドウで開きます)](../dedicated/index.html#dedicated){: new_window} インスタンスが開きます。そこでリポジトリーの内容を表示できます。 + + **ヒント**: Eclipse Orion {{site.data.keyword.webide}} の統合されたソース・コード管理ツールを使用して、{{site.data.keyword.ghe_short}} リポジトリーを編集し、ワークスペースからアプリをデプロイできます。 + +1. GitHub Issues を有効にした場合は、GitHub Issues のタイルをクリックします。 + + + +## カスタム・ツール (他のツール) の構成 +{: #othertool} + +チームが、ツールチェーン統合リストに含まれていないツールを使用する場合、カスタム・ツールを統合できます。 + +カスタム・ツールを構成し、それがツールチェーンで他のツールと連携し、チームで利用可能になるようにします。 +1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、「構成可能な統合 (Configurable Integrations)」セクションで、**「他のツール (Other Tool)」**をクリックします。 + +1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 追加ボタン (+) をクリックします。 +1. 「ツール統合 (Tool Integrations)」セクションで、**「他のツール (Other Tool)」**をクリックします。 +1. ツール名を入力します。 +1. ツールに最も関連の強いライフサイクル・フェーズを選択します。ライフサイクル・フェーズの選択は、「ツールチェーン統合 (Toolchains Integrations)」ページのどのカテゴリーの下に +ツールがリストされるかを決定します。 +1. アイコンの URL を追加します。アイコンは、ご使用のツールの統合カードに表示されます。 +1. 資料 URL を追加します。 +1. ツール・インスタンス名を指定します。例えば: マイ・チーム・ツール。 +1. ツール・インスタンスの URL を追加します。ツール統合カードをクリックすると、ツール・インスタンス用にリストした URL に移動します。 +1. ツールの説明を追加します。 +1. (拡張機能) 必要に応じて、追加のプロパティーを追加します。例えば、ツールチェーンの他のツールと統合するために、ご使用のツールに必要な情報または属性をリストします。 +1. **「統合の作成 (Create Integration)」**をクリックします。 + +## PagerDuty の構成 +{: #pagerduty} + +PagerDuty は、複数のモニタリング・システムのデータを単一のビューに統合します。問題が発生すると、PagerDuty はそのとき問題を修正できる最適なチーム・メンバーに通知します。そのチーム・メンバーが問題に対応しない場合は、エスカレーションを構成して、2 番目のエンジニアまたは運用マネージャーに転送することができます。 + +パイプライン・ステージの障害が発生したときに通知を送信するよう PagerDuty を構成し、問題を迅速に修正して、ダウン時間を減少できるようにします。 + +1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、「構成可能な統合 (Configurable Integrations)」セクションで、**「PagerDuty」**をクリックします。 +1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 追加ボタン (+) をクリックします。 +1. 「ツール統合 (Tool Integrations)」セクションで、**「PagerDuty」**をクリックします。 +1. PagerDuty アカウントと関連付けられている PagerDuty のサイト名を入力します。PagerDuty アカウントがない場合は、[アカウントを登録します (リンク先が新しいウィンドウで開きます)](https://signup.pagerduty.com/accounts/new){: new_window}。 +1. PagerDuty アカウントの API アクセス・キーを入力します。キーを確認する方法については、[API 認証 (リンク先が新しいウィンドウで開きます)](https://signup.pagerduty.com/accounts/new){: new_window} を参照してください。 +1. PagerDuty サービスの名前を入力します。 +1. PagerDuty の 1 次連絡先の E メール・アドレスを入力します。 +1. PagerDuty の 1 次連絡先の電話番号を入力します。 +1. **「統合の作成 (Create Integration)」**をクリックします。 +1. PagerDuty のタイルをクリックして、pagerduty.com にアクセスします。ツールチェーンに対してこのツール統合を構成したときに指定した、PagerDuty サービスに関連付けられているイベントを表示できます。 + +詳しくは、[PagerDuty (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window} を参照してください。 + + +## Sauce Labs の構成 +{: #saucelabs} + +Sauce Labs は、機能単体テストを実行します。Sauce Labs のテスト・スイートを {{site.data.keyword.deliverypipeline}} にテスト・ジョブとして構成した場合、テスト・スイートは、継続的デリバリー・プロセスの一部として Web アプリケーションまたはモバイル・アプリケーションに対してテストを実行できます。これらのテストは、プロジェクトの重要なフロー制御を提供し、誤ったコードのデプロイメントを防ぐゲートとして機能します。 + +自動化された機能テストを複数のオペレーティング・システムとブラウザーで実行するように Sauce Labs を構成します。これにより、ユーザーが Web サイトまたはアプリケーションを使用する可能性がある方法をエミュレートできます。 + +1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、「構成可能な統合 (Configurable Integrations)」セクションで、**「Sauce Labs」**をクリックします。 +1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 追加ボタン (+) をクリックします。 +1. 「ツール統合 (Tool Integrations)」セクションで、**「Sauce Labs」**をクリックします。 +1. Sauce Labs アカウントと関連付けられているユーザー名を入力します。[Sauce Labs アカウント・ページの上部にあるウェルカム・メッセージでユーザー名を確認できます (リンク先が新しいウィンドウで開きます)](https://saucelabs.com/account){: new_window}。 +1. Sauce Labs アカウントのアクセス・キーを入力します。[Sauce Labs アカウント・ページでキーを確認できます (リンク先が新しいウィンドウで開きます)](https://saucelabs.com/account){: new_window}。 +1. **「統合の作成 (Create Integration)」**をクリックします。 +1. Sauce Labs のタイルをクリックして、saucelabs.com に移動し、ツールチェーンのテスト・アクティビティーを表示します。 + + **ヒント**: Sauce Labs テスト・ジョブを {{site.data.keyword.deliverypipeline}} に追加した場合は、サービス・インスタンスを選択できます。 + +詳しくは、[Sauce Labs (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window} を参照してください。 + + +## Slack の構成 +{: #slack} + +**重要**: Slack の公開チャネルに投稿された通知は、チームの全員に表示されます。投稿したコンテンツの責任はお客様が負うことに注意してください。 + +Slack は、リアルタイム・メッセージングと通知を提供するクラウド・ベースのシステムです。 +Slack が提供する永続的なチャットは、E メールの代わりに使用できる対話性に優れたチームのコラボレーション手段になります。 +チームとのコミュニケーションには、専用チャネルを使用することも、作業に直接関連する一連のチャネルを使用することもできます。また、チャネルを通じて、または 2 人以上のメンバーでのダイレクト・メッセージで、ファイルとイメージを共有することもできます。ダイレクト・メッセージとチャネル上の通信は保持されるため、検索することができます。 + +テストやデプロイのアクティビティーなどのツールチェーンに関する通知をツール統合から受信するように Slack を構成します。 + +1. ツールチェーンを作成しているときにこのツール統合を構成する場合は、「構成可能な統合 (Configurable Integrations)」セクションで、**「Slack」**をクリックします。 +1. 既に存在するツールチェーンに、このツール統合を追加する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 追加ボタン (+) をクリックします。 +1. 「ツール統合 (Tool Integrations)」セクションで、**「Slack」**をクリックします。 +1. Slack アカウントの API 認証トークンを入力します。Slack での認証には、生成されたフルアクセス・トークンを使用する必要があります。トークンを確認する方法については、[Slack 認証 (リンク先が新しいウィンドウで開きます)](https://api.slack.com/web#authentication){: new_window} を参照してください。 +1. 通知を送信する Slack チャネルの名前を入力します。指定したチャネルが存在しない場合は、そのチャネルが作成されます。チャネルがアーカイブされたら、再アクティブ化します。 +1. **「統合の作成 (Create Integration)」**をクリックします。 +1. Slack のタイルをクリックします。構成した Slack チャネルでツールチェーンのアクティビティーをすべて表示できます。 + +詳しくは、[Slack (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window} を参照してください。 + + + + + + + + diff --git a/toolchains/nl/ja/toolchains_overview.md b/toolchains/nl/ja/toolchains_overview.md index 69bc6102c..e4ab5e46e 100644 --- a/toolchains/nl/ja/toolchains_overview.md +++ b/toolchains/nl/ja/toolchains_overview.md @@ -1,160 +1,160 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# ツールチェーン (ベータ版) の概要 -{: #toolchains_getting_started} - -最終更新日: 2016 年 10 月 7 日 -{: .last-updated} - -ツールチェーンは、{{site.data.keyword.Bluemix}} の Public と Dedicated の環境で使用できます。ツールチェーンを作成する方法は、2 つあります。テンプレートを使用してツールチェーンを作成する方法と、アプリからツールチェーンを作成する方法です。{{site.data.keyword.Bluemix_notm}} Public の場合、ツールチェーンは米国南部地域でのみ利用可能です。 -{: shortdesc} - -##ツールチェーンの概要: Public -{: #getting_started_public} - -**注記:** トップ・バナーをチェックして、新しい Bluemix エクスペリエンスで作業していることを確認してください。 - - * 新しい Bluemix の試行についてのメッセージが表示される場合、クラシック Bluemix エクスペリエンスで作業しています。リンクをクリックして、新しい Bluemix エクスペリエンスを開きます。 - * メッセージが表示されない場合、すでに新しい Bluemix エクスペリエンスで作業しています。 - -それぞれのツールチェーンは特定の組織に関連付けられており、その組織のメンバーであるユーザーはだれでも、関連付けられたツールチェーンにアクセスできます。ツールチェーンを作成する前に、ツールチェーンを作成する組織内で作業していることを確認してください。現在作業中の組織は、メニュー・バーに表示されます。別の組織に切り替えるには、メニュー・バーの組織をクリックして、切り替えたい組織を選択します。 - -###テンプレートからのツールチェーンの作成 -{: #creating_a_toolchain_from_a_template} - -テンプレートを開始点として使用して、特定のツール統合のセットが含まれたツールチェーンを作成できます。 - -1. 最初のツールチェーンを作成する場合は、ツールチェーンが組織内で有効になっていることを確認してください。 - 1. DevOps ダッシュボードを開き、**「ツールチェーン」**ページをクリックします。 - 2. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されたら、そのボタンをクリックし、画面の指示に従ってツールチェーンを作成します。 - 3. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されない場合、ツールチェーンはすでに有効になっています。ステップ 2 に進みます。 -1. DevOps ダッシュボードの**「ツールチェーン」**ページで追加ボタン (+) をクリックし、ツールチェーンを作成します。 -1. ツールチェーン・テンプレートをクリックします。例えば、オンライン・ストアのサンプルを使用してツールチェーンを作成する場合は、**「マイクロサービス・ツールチェーン (Microservices toolchain)」**をクリックします。 -1. ツールチェーン作成ページで、作成しようとしているツールチェーンの図を確認します。この図は、各ツール統合のツールチェーンにおけるライフサイクル・フェーズを表しています。次のイメージの図はその例です。ツールチェーンを作成するときは、この図に、ツールチェーンを構成する各ツール統合が表示されます。 -![ツールチェーンの図](images/toolchain_diagram.png) - -1. ツールチェーンの設定値のデフォルトの情報を確認します。{{site.data.keyword.Bluemix_notm}} にツールチェーンの名前が示されます。同じ名前のツールチェーンが既に存在する場合や、別の名前を使用したい場合は、ツールチェーンの名前を変更してください。 -1. 「構成可能な統合 (Configurable Integrations)」セクションで、ツールチェーンに構成する各ツール統合を選択します。一部のツール統合では、構成は不要です。ツール統合の構成については、[ツール統合の構成 (リンク先が新しいウィンドウで開きます)](../toolchains/toolchains_integrations.html){: new_window} を参照してください。 -1. **「作成」**をクリックします。以下のようないくつかのステップが自動で実行されて、ツールチェーンがセットアップされます。 - - * ツールチェーンが作成されます。 - * Delivery Pipeline ツール統合を構成した場合は、それらのパイプラインが起動されます。 - * Sauce Labs ツール統合を構成した場合は、ジョブをパイプラインに追加してテストを実行するように Sauce Labs 統合が構成されます。 - * PagerDuty ツール統合を構成した場合は、Slack で構成したチャネルに通知を送信するように PagerDuty 統合が構成されます。これらの通知は、いつ問題が発生したかを示します。 - * Slack ツール統合を構成した場合は、Slack で構成したチャネルに通知を送信するように Slack 統合が構成されます。これらの通知は、デプロイメントの進捗 (例えば、「`プロジェクト XYZ に接続しました (Connected with Project XYZ)`」、「`パイプラインが構成されました (Pipeline Configured)`」、「 `'build' ステージを開始しました (Stage 'build' started)`」など) を示します。 - * GitHub ツール統合を構成した場合は、サンプルの GitHub リポジトリーが GitHub アカウント内に複製されます。 - - -###アプリからのツールチェーンの作成 -{: #creating_a_toolchain_from_an_app} - -アプリからツールチェーンを作成できます。ツールチェーンは、継続的な開発、デプロイメント、モニタリングなどをサポートでき、使用するアプリに関連付けられます。それぞれのアプリをツールチェーンに関連付けることができます。ツールチェーンの GitHub リポジトリーに変更内容をプッシュすると、パイプラインによってアプリが自動的に作成されてデプロイされます。 - -1. 最初のツールチェーンを作成する場合は、ツールチェーンが組織内で有効になっていることを確認してください。 - 1. DevOps ダッシュボードを開き、**「ツールチェーン」**ページをクリックします。 - 2. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されたら、そのボタンをクリックし、画面の指示に従ってツールチェーンを作成します。 - 3. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されない場合、ツールチェーンはすでに有効になっています。ステップ 2 に進みます。 -1. 使用するアプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「有効にする (Enable)」**をクリックします。または、{{site.data.keyword.Bluemix_notm}} Classic Experience では、アプリの「概要」ページの右上隅にある**「ツールチェーンの追加」**をクリックしてください。使用するアプリに、アプリのスターター・コードが設定された新しい GitHub リポジトリーからの継続的デリバリーのための構成が行われます。 -1. ツールチェーン作成ページで、作成しようとしているツールチェーンの図を確認します。この図は、各ツール統合のツールチェーンにおけるライフサイクル・フェーズを表しています。 -1. ツールチェーンの設定値のデフォルトの情報を確認します。{{site.data.keyword.Bluemix_notm}} にツールチェーンの名前が示されます。同じ名前のツールチェーンが既に存在する場合や、別の名前を使用したい場合は、ツールチェーンの名前を変更してください。 -1. 「構成可能な統合 (Configurable Integrations)」セクションで、ツールチェーンに構成する各ツール統合を選択します。一部のツール統合では、構成は不要です。ツール統合の構成については、[ツール統合の構成 (リンク先が新しいウィンドウで開きます)](../toolchains/toolchains_integrations.html){: new_window} を参照してください。 -1. **「作成」**をクリックします。以下のようないくつかのステップが自動で実行されて、ツールチェーンがセットアップされます。 - - * ツールチェーンが作成されます。 - * Delivery Pipeline ツール統合を構成した場合は、それらのパイプラインが起動されます。 - * Sauce Labs ツール統合を構成した場合は、ジョブをパイプラインに追加してテストを実行するように Sauce Labs 統合が構成されます。 - * PagerDuty ツール統合を構成した場合は、Slack で構成したチャネルに通知を送信するように PagerDuty 統合が構成されます。これらの通知は、いつ問題が発生したかを示します。 - * Slack ツール統合を構成した場合は、Slack で構成したチャネルに通知を送信するように Slack 統合が構成されます。これらの通知は、デプロイメントの進捗 (例えば、「`プロジェクト XYZ に接続しました (Connected with Project XYZ)`」、「`パイプラインが構成されました (Pipeline Configured)`」、「 `'build' ステージを開始しました (Stage 'build' started)`」など) を示します。 - * GitHub ツール統合を構成した場合は、サンプルの GitHub リポジトリーが GitHub アカウント内に複製されます。 - - -##ツールチェーンの概要: Dedicated -{: #getting_started_dedicated} - -それぞれのツールチェーンは特定の組織に関連付けられており、その組織のメンバーであるユーザーはだれでも、関連付けられたツールチェーンにアクセスできます。ツールチェーンを作成する前に、メニューバーの **{{site.data.keyword.avatar}}** アイコン![Avatar アイコン](../icons/i-avatar-icon.svg)をクリックして「アカウントとサポート」ウィジェットを開き、作業中の組織を表示してください。その組織でツールチェーンを作成するわけでない場合は、別の組織に切り替えます。 - -###テンプレートからのツールチェーンの作成 -{: #creating_a_toolchain_from_a_template_dedicated} - -テンプレートを開始点として使用して、特定のツール統合のセットが含まれたツールチェーンを作成できます。 - -1. 最初のツールチェーンを作成する場合は、ツールチェーンが組織内で有効になっていることを確認してください。 - 1. DevOps ダッシュボードを開き、**「ツールチェーン」**タブをクリックします。 - 2. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されたら、そのボタンをクリックし、画面の指示に従ってツールチェーンを作成します。 - 3. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されない場合、ツールチェーンはすでに有効になっています。ステップ 2 に進みます。 -1. {{site.data.keyword.Bluemix_notm}} ダッシュボードの**「DEVOPS」**タブで追加ボタン (+) をクリックし、ツールチェーンを作成します。 -1. ツールチェーン・テンプレートをクリックします。例えば、新しい Cloud Foundry アプリをデプロイするためのシンプルなツールチェーンを作成する場合は、**「簡易 Cloud Foundry ツールチェーン (Simple Cloud Foundry toolchain)」**をクリックします。 -1. ツールチェーン作成ページで、作成しようとしているツールチェーンの図を確認します。この図は、各ツール統合のツールチェーンにおけるライフサイクル・フェーズを表しています。次のイメージの図はその例です。ツールチェーンを作成するときは、この図に、ツールチェーンを構成する各ツール統合が表示されます。 -![Dedicated のツールチェーンの図](images/toolchain_dedicated_diagram.png) - -1. ツールチェーンの設定値のデフォルトの情報を確認します。{{site.data.keyword.Bluemix_notm}} にツールチェーンの名前が示されます。同じ名前のツールチェーンが既に存在する場合や、別の名前を使用したい場合は、ツールチェーンの名前を変更してください。 -1. 「構成可能な統合 (Configurable Integrations)」セクションで、ツールチェーンに構成する各ツール統合を選択します。一部のツール統合では、構成は不要です。ツール統合の構成については、[ツール統合の構成 (リンク先が新しいウィンドウで開きます)](../toolchains/toolchains_integrations.html){: new_window} を参照してください。 -1. **「作成」**をクリックします。以下のようないくつかのステップが自動で実行されて、ツールチェーンがセットアップされます。 - - * ツールチェーンが作成されます。 - * Delivery Pipeline ツール統合を構成した場合は、それらのパイプラインが起動されます。 - * GitHub Enterprise ツール統合を構成した場合は、サンプルの GitHub Enterprise リポジトリーが GitHub Enterprise アカウント内に複製されます。 - - -###アプリからのツールチェーンの作成 -{: #creating_a_toolchain_from_an_app_dedicated} - -アプリからツールチェーンを作成できます。ツールチェーンは、継続的な開発、デプロイメント、モニタリングなどをサポートでき、使用するアプリに関連付けられます。それぞれのアプリをツールチェーンに関連付けることができます。ツールチェーンの GitHub Enterprise リポジトリーに変更内容をプッシュすると、パイプラインによってアプリが自動的に作成されてデプロイされます。 - -1. 最初のツールチェーンを作成する場合は、ツールチェーンが組織内で有効になっていることを確認してください。 - 1. DevOps ダッシュボードを開き、**「ツールチェーン」**タブをクリックします。 - 2. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されたら、そのボタンをクリックし、画面の指示に従ってツールチェーンを作成します。 - 3. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されない場合、ツールチェーンはすでに有効になっています。ステップ 2 に進みます。 -1. アプリの「概要」ページの右上隅にある**「ツールチェーンの追加」**をクリックします。使用するアプリに、アプリのスターター・コードが設定された新しい GitHub Enterprise リポジトリーからの継続的デリバリーのための構成が行われます。 -1. ツールチェーン作成ページで、作成しようとしているツールチェーンの図を確認します。この図は、各ツール統合のツールチェーンにおけるライフサイクル・フェーズを表しています。 -1. ツールチェーンの設定値のデフォルトの情報を確認します。{{site.data.keyword.Bluemix_notm}} にツールチェーンの名前が示されます。同じ名前のツールチェーンが既に存在する場合や、別の名前を使用したい場合は、ツールチェーンの名前を変更してください。 -1. 「構成可能な統合 (Configurable Integrations)」セクションで、ツールチェーンに構成する各ツール統合を選択します。一部のツール統合では、構成は不要です。ツール統合の構成については、[ツール統合の構成 (リンク先が新しいウィンドウで開きます)](../toolchains/toolchains_integrations.html){: new_window} を参照してください。 -1. **「作成」**をクリックします。以下のようないくつかのステップが自動で実行されて、ツールチェーンがセットアップされます。 - - * ツールチェーンが作成されます。 - * Delivery Pipeline ツール統合を構成した場合は、それらのパイプラインが起動されます。 - * GitHub Enterprise ツール統合を構成した場合は、サンプルの GitHub Enterprise リポジトリーが GitHub Enterprise アカウント内に複製されます。 - - -##ツールチェーンの表示 -{: #viewing_a_toolchain} - -ツールチェーンとツール統合を構成したら、「ツール統合 (Tool Integrations)」ページでそのツールチェーンのビジュアル表示を確認できます。 - -* {{site.data.keyword.Bluemix_notm}} Public を使用する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 - -* {{site.data.keyword.Bluemix_notm}} Dedicated を使用する場合は、ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。 - -* ツールチェーン内のツール統合にアクセスするには、そのツールのタイルをクリックします。 - - **ヒント**: GitHub または GitHub Enterprise のリポジトリーが複数ある場合は、それぞれのリポジトリーに対応するタイルが表示されるので、同じツール統合に対して複数のタイルが表示されることがあります。 - - - - - -# 関連リンク -{: #rellinks} - -## チュートリアルとサンプル -{: #samples} - -* [3 つのマイクロサービス (ベータ版) でアプリケーションを作成する方法 (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} -* [{{site.data.keyword.Bluemix_notm}} Dedicated (ベータ版) でテンプレートからツールチェーンを作成する方法 (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} -* [{{site.data.keyword.Bluemix_notm}} Dedicated (ベータ版) でアプリからツールチェーンを作成する方法 (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} - -## 関連リンク -{: #general} - -* [マイクロサービス・ツールチェーン (ベータ版) (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} -* [簡易ツールチェーン (ベータ版) (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} -* [IBM Bluemix Garage Method (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method){:new_window} +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# ツールチェーン (ベータ版) の概要 +{: #toolchains_getting_started} + +最終更新日: 2016 年 10 月 7 日 +{: .last-updated} + +ツールチェーンは、{{site.data.keyword.Bluemix}} の Public と Dedicated の環境で使用できます。ツールチェーンを作成する方法は、2 つあります。テンプレートを使用してツールチェーンを作成する方法と、アプリからツールチェーンを作成する方法です。{{site.data.keyword.Bluemix_notm}} Public の場合、ツールチェーンは米国南部地域でのみ利用可能です。 +{: shortdesc} + +##ツールチェーンの概要: Public +{: #getting_started_public} + +**注記:** トップ・バナーをチェックして、新しい Bluemix エクスペリエンスで作業していることを確認してください。 + + * 新しい Bluemix の試行についてのメッセージが表示される場合、クラシック Bluemix エクスペリエンスで作業しています。リンクをクリックして、新しい Bluemix エクスペリエンスを開きます。 + * メッセージが表示されない場合、すでに新しい Bluemix エクスペリエンスで作業しています。 + +それぞれのツールチェーンは特定の組織に関連付けられており、その組織のメンバーであるユーザーはだれでも、関連付けられたツールチェーンにアクセスできます。ツールチェーンを作成する前に、ツールチェーンを作成する組織内で作業していることを確認してください。現在作業中の組織は、メニュー・バーに表示されます。別の組織に切り替えるには、メニュー・バーの組織をクリックして、切り替えたい組織を選択します。 + +###テンプレートからのツールチェーンの作成 +{: #creating_a_toolchain_from_a_template} + +テンプレートを開始点として使用して、特定のツール統合のセットが含まれたツールチェーンを作成できます。 + +1. 最初のツールチェーンを作成する場合は、ツールチェーンが組織内で有効になっていることを確認してください。 + 1. DevOps ダッシュボードを開き、**「ツールチェーン」**ページをクリックします。 + 2. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されたら、そのボタンをクリックし、画面の指示に従ってツールチェーンを作成します。 + 3. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されない場合、ツールチェーンはすでに有効になっています。ステップ 2 に進みます。 +1. DevOps ダッシュボードの**「ツールチェーン」**ページで追加ボタン (+) をクリックし、ツールチェーンを作成します。 +1. ツールチェーン・テンプレートをクリックします。例えば、オンライン・ストアのサンプルを使用してツールチェーンを作成する場合は、**「マイクロサービス・ツールチェーン (Microservices toolchain)」**をクリックします。 +1. ツールチェーン作成ページで、作成しようとしているツールチェーンの図を確認します。この図は、各ツール統合のツールチェーンにおけるライフサイクル・フェーズを表しています。次のイメージの図はその例です。ツールチェーンを作成するときは、この図に、ツールチェーンを構成する各ツール統合が表示されます。 +![ツールチェーンの図](images/toolchain_diagram.png) + +1. ツールチェーンの設定値のデフォルトの情報を確認します。{{site.data.keyword.Bluemix_notm}} にツールチェーンの名前が示されます。同じ名前のツールチェーンが既に存在する場合や、別の名前を使用したい場合は、ツールチェーンの名前を変更してください。 +1. 「構成可能な統合 (Configurable Integrations)」セクションで、ツールチェーンに構成する各ツール統合を選択します。一部のツール統合では、構成は不要です。ツール統合の構成については、[ツール統合の構成 (リンク先が新しいウィンドウで開きます)](../toolchains/toolchains_integrations.html){: new_window} を参照してください。 +1. **「作成」**をクリックします。以下のようないくつかのステップが自動で実行されて、ツールチェーンがセットアップされます。 + + * ツールチェーンが作成されます。 + * Delivery Pipeline ツール統合を構成した場合は、それらのパイプラインが起動されます。 + * Sauce Labs ツール統合を構成した場合は、ジョブをパイプラインに追加してテストを実行するように Sauce Labs 統合が構成されます。 + * PagerDuty ツール統合を構成した場合は、Slack で構成したチャネルに通知を送信するように PagerDuty 統合が構成されます。これらの通知は、いつ問題が発生したかを示します。 + * Slack ツール統合を構成した場合は、Slack で構成したチャネルに通知を送信するように Slack 統合が構成されます。これらの通知は、デプロイメントの進捗 (例えば、「`プロジェクト XYZ に接続しました (Connected with Project XYZ)`」、「`パイプラインが構成されました (Pipeline Configured)`」、「 `'build' ステージを開始しました (Stage 'build' started)`」など) を示します。 + * GitHub ツール統合を構成した場合は、サンプルの GitHub リポジトリーが GitHub アカウント内に複製されます。 + + +###アプリからのツールチェーンの作成 +{: #creating_a_toolchain_from_an_app} + +アプリからツールチェーンを作成できます。ツールチェーンは、継続的な開発、デプロイメント、モニタリングなどをサポートでき、使用するアプリに関連付けられます。それぞれのアプリをツールチェーンに関連付けることができます。ツールチェーンの GitHub リポジトリーに変更内容をプッシュすると、パイプラインによってアプリが自動的に作成されてデプロイされます。 + +1. 最初のツールチェーンを作成する場合は、ツールチェーンが組織内で有効になっていることを確認してください。 + 1. DevOps ダッシュボードを開き、**「ツールチェーン」**ページをクリックします。 + 2. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されたら、そのボタンをクリックし、画面の指示に従ってツールチェーンを作成します。 + 3. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されない場合、ツールチェーンはすでに有効になっています。ステップ 2 に進みます。 +1. 使用するアプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「有効にする (Enable)」**をクリックします。または、{{site.data.keyword.Bluemix_notm}} Classic Experience では、アプリの「概要」ページの右上隅にある**「ツールチェーンの追加」**をクリックしてください。使用するアプリに、アプリのスターター・コードが設定された新しい GitHub リポジトリーからの継続的デリバリーのための構成が行われます。 +1. ツールチェーン作成ページで、作成しようとしているツールチェーンの図を確認します。この図は、各ツール統合のツールチェーンにおけるライフサイクル・フェーズを表しています。 +1. ツールチェーンの設定値のデフォルトの情報を確認します。{{site.data.keyword.Bluemix_notm}} にツールチェーンの名前が示されます。同じ名前のツールチェーンが既に存在する場合や、別の名前を使用したい場合は、ツールチェーンの名前を変更してください。 +1. 「構成可能な統合 (Configurable Integrations)」セクションで、ツールチェーンに構成する各ツール統合を選択します。一部のツール統合では、構成は不要です。ツール統合の構成については、[ツール統合の構成 (リンク先が新しいウィンドウで開きます)](../toolchains/toolchains_integrations.html){: new_window} を参照してください。 +1. **「作成」**をクリックします。以下のようないくつかのステップが自動で実行されて、ツールチェーンがセットアップされます。 + + * ツールチェーンが作成されます。 + * Delivery Pipeline ツール統合を構成した場合は、それらのパイプラインが起動されます。 + * Sauce Labs ツール統合を構成した場合は、ジョブをパイプラインに追加してテストを実行するように Sauce Labs 統合が構成されます。 + * PagerDuty ツール統合を構成した場合は、Slack で構成したチャネルに通知を送信するように PagerDuty 統合が構成されます。これらの通知は、いつ問題が発生したかを示します。 + * Slack ツール統合を構成した場合は、Slack で構成したチャネルに通知を送信するように Slack 統合が構成されます。これらの通知は、デプロイメントの進捗 (例えば、「`プロジェクト XYZ に接続しました (Connected with Project XYZ)`」、「`パイプラインが構成されました (Pipeline Configured)`」、「 `'build' ステージを開始しました (Stage 'build' started)`」など) を示します。 + * GitHub ツール統合を構成した場合は、サンプルの GitHub リポジトリーが GitHub アカウント内に複製されます。 + + +##ツールチェーンの概要: Dedicated +{: #getting_started_dedicated} + +それぞれのツールチェーンは特定の組織に関連付けられており、その組織のメンバーであるユーザーはだれでも、関連付けられたツールチェーンにアクセスできます。ツールチェーンを作成する前に、メニューバーの **{{site.data.keyword.avatar}}** アイコン![Avatar アイコン](../icons/i-avatar-icon.svg)をクリックして「アカウントとサポート」ウィジェットを開き、作業中の組織を表示してください。その組織でツールチェーンを作成するわけでない場合は、別の組織に切り替えます。 + +###テンプレートからのツールチェーンの作成 +{: #creating_a_toolchain_from_a_template_dedicated} + +テンプレートを開始点として使用して、特定のツール統合のセットが含まれたツールチェーンを作成できます。 + +1. 最初のツールチェーンを作成する場合は、ツールチェーンが組織内で有効になっていることを確認してください。 + 1. DevOps ダッシュボードを開き、**「ツールチェーン」**タブをクリックします。 + 2. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されたら、そのボタンをクリックし、画面の指示に従ってツールチェーンを作成します。 + 3. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されない場合、ツールチェーンはすでに有効になっています。ステップ 2 に進みます。 +1. {{site.data.keyword.Bluemix_notm}} ダッシュボードの**「DEVOPS」**タブで追加ボタン (+) をクリックし、ツールチェーンを作成します。 +1. ツールチェーン・テンプレートをクリックします。例えば、新しい Cloud Foundry アプリをデプロイするためのシンプルなツールチェーンを作成する場合は、**「簡易 Cloud Foundry ツールチェーン (Simple Cloud Foundry toolchain)」**をクリックします。 +1. ツールチェーン作成ページで、作成しようとしているツールチェーンの図を確認します。この図は、各ツール統合のツールチェーンにおけるライフサイクル・フェーズを表しています。次のイメージの図はその例です。ツールチェーンを作成するときは、この図に、ツールチェーンを構成する各ツール統合が表示されます。 +![Dedicated のツールチェーンの図](images/toolchain_dedicated_diagram.png) + +1. ツールチェーンの設定値のデフォルトの情報を確認します。{{site.data.keyword.Bluemix_notm}} にツールチェーンの名前が示されます。同じ名前のツールチェーンが既に存在する場合や、別の名前を使用したい場合は、ツールチェーンの名前を変更してください。 +1. 「構成可能な統合 (Configurable Integrations)」セクションで、ツールチェーンに構成する各ツール統合を選択します。一部のツール統合では、構成は不要です。ツール統合の構成については、[ツール統合の構成 (リンク先が新しいウィンドウで開きます)](../toolchains/toolchains_integrations.html){: new_window} を参照してください。 +1. **「作成」**をクリックします。以下のようないくつかのステップが自動で実行されて、ツールチェーンがセットアップされます。 + + * ツールチェーンが作成されます。 + * Delivery Pipeline ツール統合を構成した場合は、それらのパイプラインが起動されます。 + * GitHub Enterprise ツール統合を構成した場合は、サンプルの GitHub Enterprise リポジトリーが GitHub Enterprise アカウント内に複製されます。 + + +###アプリからのツールチェーンの作成 +{: #creating_a_toolchain_from_an_app_dedicated} + +アプリからツールチェーンを作成できます。ツールチェーンは、継続的な開発、デプロイメント、モニタリングなどをサポートでき、使用するアプリに関連付けられます。それぞれのアプリをツールチェーンに関連付けることができます。ツールチェーンの GitHub Enterprise リポジトリーに変更内容をプッシュすると、パイプラインによってアプリが自動的に作成されてデプロイされます。 + +1. 最初のツールチェーンを作成する場合は、ツールチェーンが組織内で有効になっていることを確認してください。 + 1. DevOps ダッシュボードを開き、**「ツールチェーン」**タブをクリックします。 + 2. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されたら、そのボタンをクリックし、画面の指示に従ってツールチェーンを作成します。 + 3. **「ツールチェーンを有効にする (Enable Toolchains)」**ボタンが表示されない場合、ツールチェーンはすでに有効になっています。ステップ 2 に進みます。 +1. アプリの「概要」ページの右上隅にある**「ツールチェーンの追加」**をクリックします。使用するアプリに、アプリのスターター・コードが設定された新しい GitHub Enterprise リポジトリーからの継続的デリバリーのための構成が行われます。 +1. ツールチェーン作成ページで、作成しようとしているツールチェーンの図を確認します。この図は、各ツール統合のツールチェーンにおけるライフサイクル・フェーズを表しています。 +1. ツールチェーンの設定値のデフォルトの情報を確認します。{{site.data.keyword.Bluemix_notm}} にツールチェーンの名前が示されます。同じ名前のツールチェーンが既に存在する場合や、別の名前を使用したい場合は、ツールチェーンの名前を変更してください。 +1. 「構成可能な統合 (Configurable Integrations)」セクションで、ツールチェーンに構成する各ツール統合を選択します。一部のツール統合では、構成は不要です。ツール統合の構成については、[ツール統合の構成 (リンク先が新しいウィンドウで開きます)](../toolchains/toolchains_integrations.html){: new_window} を参照してください。 +1. **「作成」**をクリックします。以下のようないくつかのステップが自動で実行されて、ツールチェーンがセットアップされます。 + + * ツールチェーンが作成されます。 + * Delivery Pipeline ツール統合を構成した場合は、それらのパイプラインが起動されます。 + * GitHub Enterprise ツール統合を構成した場合は、サンプルの GitHub Enterprise リポジトリーが GitHub Enterprise アカウント内に複製されます。 + + +##ツールチェーンの表示 +{: #viewing_a_toolchain} + +ツールチェーンとツール統合を構成したら、「ツール統合 (Tool Integrations)」ページでそのツールチェーンのビジュアル表示を確認できます。 + +* {{site.data.keyword.Bluemix_notm}} Public を使用する場合は、DevOps ダッシュボードの**「ツールチェーン」**ページで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 + +* {{site.data.keyword.Bluemix_notm}} Dedicated を使用する場合は、ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。 + +* ツールチェーン内のツール統合にアクセスするには、そのツールのタイルをクリックします。 + + **ヒント**: GitHub または GitHub Enterprise のリポジトリーが複数ある場合は、それぞれのリポジトリーに対応するタイルが表示されるので、同じツール統合に対して複数のタイルが表示されることがあります。 + + + + + +# 関連リンク +{: #rellinks} + +## チュートリアルとサンプル +{: #samples} + +* [3 つのマイクロサービス (ベータ版) でアプリケーションを作成する方法 (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} +* [{{site.data.keyword.Bluemix_notm}} Dedicated (ベータ版) でテンプレートからツールチェーンを作成する方法 (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} +* [{{site.data.keyword.Bluemix_notm}} Dedicated (ベータ版) でアプリからツールチェーンを作成する方法 (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} + +## 関連リンク +{: #general} + +* [マイクロサービス・ツールチェーン (ベータ版) (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} +* [簡易ツールチェーン (ベータ版) (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} +* [IBM Bluemix Garage Method (リンク先が新しいウィンドウで開きます)](https://www.ibm.com/devops/method){:new_window} diff --git a/toolchains/nl/ja/toolchains_using.md b/toolchains/nl/ja/toolchains_using.md index 16c967bee..ebc5dd82d 100644 --- a/toolchains/nl/ja/toolchains_using.md +++ b/toolchains/nl/ja/toolchains_using.md @@ -1,100 +1,100 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# {{site.data.keyword.Bluemix_notm}} Public でのツールチェーンの使い方 -{: #toolchains-using} - -最終更新日: 2016 年 10 月 7 日 -{: .last-updated} - -ツールチェーンを使用して、日常的な開発、デプロイメント、運用の作業の生産性を向上させることができます。ツールチェーンをセットアップした後、 -ツール統合を追加、削除、構成して、ツールチェーンへのアクセスを管理することができます。 -ツールチェーンは米国南部地域でのみ利用可能です。 -{: shortdesc} - -**注記**: トップ・バナーをチェックして、新しい Bluemix エクスペリエンスで作業していることを確認してください。 - - * 新しい Bluemix の試行についてのメッセージが表示される場合、クラシック Bluemix エクスペリエンスで作業しています。リンクをクリックして、新しい Bluemix エクスペリエンスを開きます。 - * メッセージが表示されない場合、すでに新しい Bluemix エクスペリエンスで作業しています。 - -## ツール統合の構成 -{: #configuring_a_tool_integration} - -ツールチェーンの作成時にツール統合の構成を据え置いた場合は、**「構成」**ボタンがタイルに表示されます。ツールチェーンの作成時にツール統合を構成した場合は、その構成設定を更新できます。 - -1. DevOps ダッシュボードの**「ツールチェーン (Toolchains)」**ページで、ツールチェーンをクリックしてその「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックしてから、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. ツール統合の初回構成を行う必要がある場合は、そのツール統合のタイルで**「構成」**をクリックします。 - - ![「構成」ボタン](images/toolchain_tile_configure.png) - - ツール統合の構成を完了したら、**「統合の保存 (Save Integration)」**をクリックします。 - -1. ツール統合の構成を更新する必要がある場合は、そのツール統合のタイルで、構成オプションにアクセスするためのメニューをクリックします。 - - ![構成メニュー](images/toolchain_tile_menu.png) - - 設定の更新を完了したら、**「統合の保存 (Save Integration)」**をクリックします。 - -## ツール統合の追加 -{: #adding_a_tool_integration} - -ツールチェーンにツール統合を追加して構成することができます。 - -1. DevOps ダッシュボードの**「ツールチェーン (Toolchains)」**ページで、ツールチェーンをクリックしてその「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックしてから、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 追加するツール統合のリストを表示するために、追加ボタン (+) をクリックします。 -1. 追加するツール統合をクリックします。 -1. ツール統合を構成するために必要な情報を入力します。 -1. **「統合の作成 (Create Integration)」**をクリックして、ツールチェーンにツール統合を追加します。 - -## ツール統合の削除 -{: #deleting_a_tool_integration} - -ツールチェーンからツール統合を削除した場合、その削除を元に戻すことはできません。 - -1. DevOps ダッシュボードの**「ツールチェーン (Toolchains)」**ページで、ツールチェーンをクリックしてその「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックしてから、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 削除するツール統合のタイルで、構成オプションにアクセスするためのメニューをクリックします。 -1. ツールチェーンからツール統合を削除するために、**「削除」**をクリックします。 -1. **「削除」**をクリックして確認します。 - -## アクセスの管理 -{: #managing_access} - -ユーザーにツールチェーンへのアクセス権を付与するには、ツールチェーンが関連付けられている組織にユーザーを追加します。それぞれのツールチェーンは特定の組織に関連付けられており、その組織のメンバーであるユーザーはだれでも、関連付けられたツールチェーンにアクセスできます。現在作業中の組織は、メニュー・バーに表示されます。 -組織をクリックして別の組織に切り替えれば、別のツールチェーン・セットにアクセスできます。 - - - - - -1. DevOps ダッシュボードの**「ツールチェーン (Toolchains)」**ページで、管理対象のツールチェーンをクリックしてから、**「管理」**をクリックします。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックしてから、**「管理」**をクリックします。 -1. 組織へのリンクをクリックします。 -1. 「組織の管理」ページで、**「ユーザーの招待」**をクリックしてユーザーの E メール・アドレスを入力します。 -1. {{site.data.keyword.Bluemix_notm}} の組織のユーザーを管理するための拡張権限を与える場合は、**「管理者」**、**「請求管理者」**、**「監査員」**のチェック・ボックスを 1 つ以上選択します。 -1. **「招待 (INVITE)」**をクリックします。 -1. **「保存」**をクリックします。 - -## ツールチェーンの削除 -{: #deleting_a_toolchain} - -ツールチェーンを削除し、関連付けられたツール統合のうちどれを削除するかを指定することができます。ツールチェーンを削除した場合、その削除を元に戻すことはできません。 - -1. DevOps ダッシュボードの**「ツールチェーン (Toolchains)」**ページで、削除するツールチェーンをクリックしてから、**「管理」**をクリックします。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックしてから、**「管理」**をクリックします。 -1. **「ツールチェーンの削除 (Delete Toolchain)」**をクリックし、削除するツール統合を確認したり調整したりします。 -1. ツールチェーンの名前を入力し、**「削除」**をクリックして削除を確認します。 - - **ヒント**: GitHub ツール統合を削除する場合、関連付けられている GitHub リポジトリーは GitHub から削除されません。リポジトリーは手動で GitHub から削除する必要があります。 +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# {{site.data.keyword.Bluemix_notm}} Public でのツールチェーンの使い方 +{: #toolchains-using} + +最終更新日: 2016 年 10 月 7 日 +{: .last-updated} + +ツールチェーンを使用して、日常的な開発、デプロイメント、運用の作業の生産性を向上させることができます。ツールチェーンをセットアップした後、 +ツール統合を追加、削除、構成して、ツールチェーンへのアクセスを管理することができます。 +ツールチェーンは米国南部地域でのみ利用可能です。 +{: shortdesc} + +**注記**: トップ・バナーをチェックして、新しい Bluemix エクスペリエンスで作業していることを確認してください。 + + * 新しい Bluemix の試行についてのメッセージが表示される場合、クラシック Bluemix エクスペリエンスで作業しています。リンクをクリックして、新しい Bluemix エクスペリエンスを開きます。 + * メッセージが表示されない場合、すでに新しい Bluemix エクスペリエンスで作業しています。 + +## ツール統合の構成 +{: #configuring_a_tool_integration} + +ツールチェーンの作成時にツール統合の構成を据え置いた場合は、**「構成」**ボタンがタイルに表示されます。ツールチェーンの作成時にツール統合を構成した場合は、その構成設定を更新できます。 + +1. DevOps ダッシュボードの**「ツールチェーン (Toolchains)」**ページで、ツールチェーンをクリックしてその「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックしてから、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. ツール統合の初回構成を行う必要がある場合は、そのツール統合のタイルで**「構成」**をクリックします。 + + ![「構成」ボタン](images/toolchain_tile_configure.png) + + ツール統合の構成を完了したら、**「統合の保存 (Save Integration)」**をクリックします。 + +1. ツール統合の構成を更新する必要がある場合は、そのツール統合のタイルで、構成オプションにアクセスするためのメニューをクリックします。 + + ![構成メニュー](images/toolchain_tile_menu.png) + + 設定の更新を完了したら、**「統合の保存 (Save Integration)」**をクリックします。 + +## ツール統合の追加 +{: #adding_a_tool_integration} + +ツールチェーンにツール統合を追加して構成することができます。 + +1. DevOps ダッシュボードの**「ツールチェーン (Toolchains)」**ページで、ツールチェーンをクリックしてその「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックしてから、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 追加するツール統合のリストを表示するために、追加ボタン (+) をクリックします。 +1. 追加するツール統合をクリックします。 +1. ツール統合を構成するために必要な情報を入力します。 +1. **「統合の作成 (Create Integration)」**をクリックして、ツールチェーンにツール統合を追加します。 + +## ツール統合の削除 +{: #deleting_a_tool_integration} + +ツールチェーンからツール統合を削除した場合、その削除を元に戻すことはできません。 + +1. DevOps ダッシュボードの**「ツールチェーン (Toolchains)」**ページで、ツールチェーンをクリックしてその「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックしてから、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 削除するツール統合のタイルで、構成オプションにアクセスするためのメニューをクリックします。 +1. ツールチェーンからツール統合を削除するために、**「削除」**をクリックします。 +1. **「削除」**をクリックして確認します。 + +## アクセスの管理 +{: #managing_access} + +ユーザーにツールチェーンへのアクセス権を付与するには、ツールチェーンが関連付けられている組織にユーザーを追加します。それぞれのツールチェーンは特定の組織に関連付けられており、その組織のメンバーであるユーザーはだれでも、関連付けられたツールチェーンにアクセスできます。現在作業中の組織は、メニュー・バーに表示されます。 +組織をクリックして別の組織に切り替えれば、別のツールチェーン・セットにアクセスできます。 + + + + + +1. DevOps ダッシュボードの**「ツールチェーン (Toolchains)」**ページで、管理対象のツールチェーンをクリックしてから、**「管理」**をクリックします。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックしてから、**「管理」**をクリックします。 +1. 組織へのリンクをクリックします。 +1. 「組織の管理」ページで、**「ユーザーの招待」**をクリックしてユーザーの E メール・アドレスを入力します。 +1. {{site.data.keyword.Bluemix_notm}} の組織のユーザーを管理するための拡張権限を与える場合は、**「管理者」**、**「請求管理者」**、**「監査員」**のチェック・ボックスを 1 つ以上選択します。 +1. **「招待 (INVITE)」**をクリックします。 +1. **「保存」**をクリックします。 + +## ツールチェーンの削除 +{: #deleting_a_toolchain} + +ツールチェーンを削除し、関連付けられたツール統合のうちどれを削除するかを指定することができます。ツールチェーンを削除した場合、その削除を元に戻すことはできません。 + +1. DevOps ダッシュボードの**「ツールチェーン (Toolchains)」**ページで、削除するツールチェーンをクリックしてから、**「管理」**をクリックします。または、アプリの「概要」ページの「継続的デリバリー (Continuous Delivery)」タイルで、**「ツールチェーンの表示」**をクリックしてから、**「管理」**をクリックします。 +1. **「ツールチェーンの削除 (Delete Toolchain)」**をクリックし、削除するツール統合を確認したり調整したりします。 +1. ツールチェーンの名前を入力し、**「削除」**をクリックして削除を確認します。 + + **ヒント**: GitHub ツール統合を削除する場合、関連付けられている GitHub リポジトリーは GitHub から削除されません。リポジトリーは手動で GitHub から削除する必要があります。 diff --git a/toolchains/nl/ja/toolchains_using_dedicated.md b/toolchains/nl/ja/toolchains_using_dedicated.md index bb55c6ca9..f94bd67f5 100644 --- a/toolchains/nl/ja/toolchains_using_dedicated.md +++ b/toolchains/nl/ja/toolchains_using_dedicated.md @@ -1,85 +1,85 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# {{site.data.keyword.Bluemix_notm}} Dedicated でのツールチェーンの使い方 -{: #toolchains-using_dedicated} - -最終更新日: 2016 年 9 月 13 日 -{: .last-updated} - -ツールチェーンを使用して、日常的な開発、デプロイメント、運用の作業の生産性を向上させることができます。ツールチェーンをセットアップした後、 -ツール統合を追加、削除、構成して、ツールチェーンへのアクセスを管理することができます。 -{: shortdesc} - -## ツール統合の構成 -{: #configuring_a_tool_integration_dedicated} - -ツールチェーンの作成時にツール統合の構成を据え置いた場合は、**「構成」**ボタンがタイルに表示されます。ツールチェーンの作成時にツール統合を構成した場合は、その構成設定を更新できます。 - -1. ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. ツール統合の初回構成を行う必要がある場合は、そのツール統合のタイルで**「構成」**をクリックします。 - - ![「構成」ボタン](images/toolchain_tile_configure.png) - - ツール統合の構成を完了したら、**「統合の保存 (Save Integration)」**をクリックします。 - -1. ツール統合の構成を更新する必要がある場合は、そのツール統合のタイルで、構成オプションにアクセスするためのメニューをクリックします。 - - ![構成メニュー](images/toolchain_tile_menu.png) - - 設定の更新を完了したら、**「統合の保存 (Save Integration)」**をクリックします。 - -## ツール統合の追加 -{: #adding_a_tool_integration_dedicated} - -ツールチェーンにツール統合を追加して構成することができます。 - -1. ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 追加するツール統合のリストを表示するために、追加ボタン (+) をクリックします。 -1. 追加するツール統合をクリックします。 -1. ツール統合を構成するために必要な情報を入力します。 -1. **「統合の作成 (Create Integration)」**をクリックして、ツールチェーンにツール統合を追加します。 - -## ツール統合の削除 -{: #deleting_a_tool_integration} - -ツールチェーンからツール統合を削除した場合、その削除を元に戻すことはできません。 - -1. ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 -1. 削除するツール統合のタイルで、構成オプションにアクセスするためのメニューをクリックします。 -1. ツールチェーンからツール統合を削除するために、**「削除」**をクリックします。 -1. **「削除」**をクリックして確認します。 - -## アクセスの管理 -{: #managing_access_dedicated} - -ユーザーにツールチェーンへのアクセス権を付与するには、ツールチェーンが関連付けられている組織にユーザーを追加します。それぞれのツールチェーンは特定の組織に関連付けられており、その組織のメンバーであるユーザーはだれでも、関連付けられたツールチェーンにアクセスできます。現在作業中の組織を表示するには、メニュー・バーの **{{site.data.keyword.avatar}}** アイコン ![Avatar アイコン](../icons/i-avatar-icon.svg)をクリックします。別のツールチェーン・セットにアクセスするには、別の組織に切り替えます。 - -{{site.data.keyword.Bluemix}} の組織やスペースにユーザーを追加すると、そのユーザーは、自分用の {{site.data.keyword.Bluemix_notm}} ID とパスワードで GitHub Enterprise にログインできるようになります。ユーザーがログインすると、そのユーザーのアカウントが作成されます。{{site.data.keyword.Bluemix_notm}} の組織やスペースにユーザーを追加しても、そのユーザーは、GitHub Enterprise リポジトリーに自動的に追加されるわけではありません。リポジトリーの管理特権を持った人がそのユーザーを追加する必要があります。詳しくは、[Dedicated GitHub Enterprise の使い方 (リンク先が新しいウィンドウで開きます)](../services/ghededicated/index.html){: new_window} を参照してください。 - -ユーザーを追加するには、以下の手順を実行します。 - -1. ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。**「管理」**をクリックします。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。**「管理」**をクリックします。 -1. 組織へのリンクをクリックします。 -1. 「組織の管理」ページで、**「ユーザーの招待」**をクリックしてユーザーの E メール・アドレスを入力します。 -1. {{site.data.keyword.Bluemix_notm}} の組織のユーザーを管理するための拡張権限を与える場合は、**「管理者」**、**「請求管理者」**、**「監査員」**のチェック・ボックスを 1 つ以上選択します。 -1. **「招待 (INVITE)」**をクリックします。 -1. **「保存」**をクリックします。 - -## ツールチェーンの削除 -{: #deleting_a_toolchain_dedicated} - -ツールチェーンを削除し、関連付けられたツール統合のうちどれを削除するかを指定できます。ツールチェーンを削除した場合、その削除を元に戻すことはできません。 - -1. ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。**「管理」**をクリックします。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。**「管理」**をクリックします。 -1. **「ツールチェーンの削除 (Delete Toolchain)」**をクリックし、削除するツール統合を確認したり調整したりします。 -1. ツールチェーンの名前を入力し、**「削除」**をクリックして削除を確認します。 - - **ヒント**: GitHub Enterprise ツール統合を削除しても、関連する GitHub Enterprise リポジトリーは GitHub Enterprise から削除されません。リポジトリーは手動で GitHub Enterprise から削除する必要があります。 +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# {{site.data.keyword.Bluemix_notm}} Dedicated でのツールチェーンの使い方 +{: #toolchains-using_dedicated} + +最終更新日: 2016 年 9 月 13 日 +{: .last-updated} + +ツールチェーンを使用して、日常的な開発、デプロイメント、運用の作業の生産性を向上させることができます。ツールチェーンをセットアップした後、 +ツール統合を追加、削除、構成して、ツールチェーンへのアクセスを管理することができます。 +{: shortdesc} + +## ツール統合の構成 +{: #configuring_a_tool_integration_dedicated} + +ツールチェーンの作成時にツール統合の構成を据え置いた場合は、**「構成」**ボタンがタイルに表示されます。ツールチェーンの作成時にツール統合を構成した場合は、その構成設定を更新できます。 + +1. ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. ツール統合の初回構成を行う必要がある場合は、そのツール統合のタイルで**「構成」**をクリックします。 + + ![「構成」ボタン](images/toolchain_tile_configure.png) + + ツール統合の構成を完了したら、**「統合の保存 (Save Integration)」**をクリックします。 + +1. ツール統合の構成を更新する必要がある場合は、そのツール統合のタイルで、構成オプションにアクセスするためのメニューをクリックします。 + + ![構成メニュー](images/toolchain_tile_menu.png) + + 設定の更新を完了したら、**「統合の保存 (Save Integration)」**をクリックします。 + +## ツール統合の追加 +{: #adding_a_tool_integration_dedicated} + +ツールチェーンにツール統合を追加して構成することができます。 + +1. ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 追加するツール統合のリストを表示するために、追加ボタン (+) をクリックします。 +1. 追加するツール統合をクリックします。 +1. ツール統合を構成するために必要な情報を入力します。 +1. **「統合の作成 (Create Integration)」**をクリックして、ツールチェーンにツール統合を追加します。 + +## ツール統合の削除 +{: #deleting_a_tool_integration} + +ツールチェーンからツール統合を削除した場合、その削除を元に戻すことはできません。 + +1. ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。次に、**「ツール統合 (Tool Integrations)」**をクリックします。 +1. 削除するツール統合のタイルで、構成オプションにアクセスするためのメニューをクリックします。 +1. ツールチェーンからツール統合を削除するために、**「削除」**をクリックします。 +1. **「削除」**をクリックして確認します。 + +## アクセスの管理 +{: #managing_access_dedicated} + +ユーザーにツールチェーンへのアクセス権を付与するには、ツールチェーンが関連付けられている組織にユーザーを追加します。それぞれのツールチェーンは特定の組織に関連付けられており、その組織のメンバーであるユーザーはだれでも、関連付けられたツールチェーンにアクセスできます。現在作業中の組織を表示するには、メニュー・バーの **{{site.data.keyword.avatar}}** アイコン ![Avatar アイコン](../icons/i-avatar-icon.svg)をクリックします。別のツールチェーン・セットにアクセスするには、別の組織に切り替えます。 + +{{site.data.keyword.Bluemix}} の組織やスペースにユーザーを追加すると、そのユーザーは、自分用の {{site.data.keyword.Bluemix_notm}} ID とパスワードで GitHub Enterprise にログインできるようになります。ユーザーがログインすると、そのユーザーのアカウントが作成されます。{{site.data.keyword.Bluemix_notm}} の組織やスペースにユーザーを追加しても、そのユーザーは、GitHub Enterprise リポジトリーに自動的に追加されるわけではありません。リポジトリーの管理特権を持った人がそのユーザーを追加する必要があります。詳しくは、[Dedicated GitHub Enterprise の使い方 (リンク先が新しいウィンドウで開きます)](../services/ghededicated/index.html){: new_window} を参照してください。 + +ユーザーを追加するには、以下の手順を実行します。 + +1. ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。**「管理」**をクリックします。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。**「管理」**をクリックします。 +1. 組織へのリンクをクリックします。 +1. 「組織の管理」ページで、**「ユーザーの招待」**をクリックしてユーザーの E メール・アドレスを入力します。 +1. {{site.data.keyword.Bluemix_notm}} の組織のユーザーを管理するための拡張権限を与える場合は、**「管理者」**、**「請求管理者」**、**「監査員」**のチェック・ボックスを 1 つ以上選択します。 +1. **「招待 (INVITE)」**をクリックします。 +1. **「保存」**をクリックします。 + +## ツールチェーンの削除 +{: #deleting_a_toolchain_dedicated} + +ツールチェーンを削除し、関連付けられたツール統合のうちどれを削除するかを指定できます。ツールチェーンを削除した場合、その削除を元に戻すことはできません。 + +1. ダッシュボードの**「DEVOPS」**タブで、ツールチェーンをクリックして「ツール統合 (Tool Integrations)」ページを開きます。**「管理」**をクリックします。または、アプリの「概要」ページの右上隅にある**「ツールチェーンの表示」**をクリックします。**「管理」**をクリックします。 +1. **「ツールチェーンの削除 (Delete Toolchain)」**をクリックし、削除するツール統合を確認したり調整したりします。 +1. ツールチェーンの名前を入力し、**「削除」**をクリックして削除を確認します。 + + **ヒント**: GitHub Enterprise ツール統合を削除しても、関連する GitHub Enterprise リポジトリーは GitHub Enterprise から削除されません。リポジトリーは手動で GitHub Enterprise から削除する必要があります。 diff --git a/toolchains/nl/ja/web_ide.md b/toolchains/nl/ja/web_ide.md index 61c84a08b..c51349e57 100644 --- a/toolchains/nl/ja/web_ide.md +++ b/toolchains/nl/ja/web_ide.md @@ -1,152 +1,152 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} -{:pre: .pre} - -# Eclipse Orion {{site.data.keyword.webide}} によるコードの編集 -{: #web_ide} - -最終更新日: 2016 年 9 月 9 日 -{: .last-updated} - -Eclipse Orion {{site.data.keyword.webide}} は、Web 向けの開発を行うためのブラウザー・ベースの開発環境です。JavaScript、HTML、CSS での開発が可能であり、コンテンツ・アシスト、コード補完、エラー・チェックの機能を備えています。{{site.data.keyword.webide}} はほぼすべての言語に対応しており、ほとんどの[ファイル・タイプ (リンク先が新しいウィンドウで開きます)](https://hub.jazz.net/docs/overview/#dev_support){: new_window} で構文の強調表示が可能です。Git または Jazz の SCM によるソース管理機能が組み込まれており、ローカル環境にコードをデプロイしてアプリのテストやデバッグを実行できるようになっています。 -{:shortdesc} - -何よりも、{{site.data.keyword.webide}} は Web が基盤になっています。インストールもメンテナンスもスケーリングも不要です。インターネット接続さえあれば、どこでも開発作業を行えます。 - -## エディターの設定 -{: #editorsetup} - -{{site.data.keyword.webide}} はカスタマイズが可能なので、それぞれの開発要件に合わせてカラー・スキームやテクニカル・ツールや設定を選択できます。設定を表示して変更するには、左側のメニューから**「設定」**アイコン「設定」アイコンをクリックします。 - -編集中にしばしば設定を変更する必要がある場合は、エディターの右上隅にある**「ローカル・エディター設定」**アイコン 「ローカル・エディター設定」アイコンから簡単に設定にアクセスできます。 - -![ローカル・エディター設定](images/webide_local_editor_settings.png) - -デフォルトでは、エディターのスタイルやフォント・サイズの設定は常に表示されます。その他のエディター設定をメニューに組み込む場合は、以下の手順を実行してください。 - -1. **「ローカル・エディター設定」**アイコン「ローカル・エディター設定」アイコンをクリックします。 - -2. **「エディター設定」**をクリックします。 - -3. **「ローカル・エディター設定」**メニューで設定を組み込んだり除外したりするには、各設定の横にある円をクリックします。 - -![エディター設定の切り替え](images/webide_editor_settings_toggle.png) - - -## コードの編集 -{: #editcode} - -{{site.data.keyword.webide}} には 2 つの主なセクションがあります。1 番目のセクションは、左側のファイル・ナビゲーターです。そこにはプロジェクト・ファイルがツリー構造で表示されます。ファイル・ナビゲーターから、ファイルやフォルダーの作成、名前変更、削除、管理を実行できます。 - -**ヒント:** ファイル・ナビゲーターにファイルをアップロードするには、コンピューターからファイル・ナビゲーターにファイルをドラッグします。 - -2 番目のセクションは、右側のエディター・ペインです。エディターには、コンテンツ・アシストや構文検証などのコーディング機能が用意されています。 - -![Web IDE](images/webide.png) - -### 複数のファイルの操作 -1. 2 つのファイルを同時に操作するには、エディターの上部にある**「分割エディター・モードを変更します」**アイコン「分割エディター」アイコンをクリックします。 -2. メニューが表示されたら、ビューを選択します。 - - ビューを選択した時に、ファイルがすでにエディターで開かれていた場合は、両方のエディター・ビューに表示されます。 - - いずれかのエディター・ビューで表示されているファイルを開いたり変更したりする場合は、以下のようにします。 - 1. 変更するエディター・ビューにカーソルを移動します。 - 2. ファイル・ナビゲーターでファイルをクリックします。 - -### キーボード・ショートカット -{{site.data.keyword.webide}} のほとんどのコマンドは、キーボード・ショートカットでのみアクセスできます。 - -エディターのキーボード・ショートカットのリストを参照するには、Alt+Shift+? を押してください。Mac OS を使用している場合は、Ctrl+Shift+? を押してください。 - -## ソース・コードの管理 -{: #sourcecontrol} - -{{site.data.keyword.webide}} には、ソース・コード管理ツールが統合されています。Git リポジトリーを操作するには、**「Git リポジトリー」**アイコン「Git リポジトリー」アイコンをクリックします。詳しくは、[Git によるソース管理 (リンク先が新しいウィンドウで開きます)](https://hub.jazz.net/docs/git/){: new_window} を参照してください。 - - -## ワークスペースからアプリをデプロイする方法 -{: #deploy} - -1. 実行バーからアプリをデプロイするには、起動構成を選択するか[作成 (リンク先が新しいウィンドウで開きます)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} します。 -1. デプロイ・アイコンデプロイ・アイコンをクリックします。ワークスペースの現在のコンテンツと起動構成で定義されている環境に基づいて、アプリのインスタンスがデプロイされます。 -2. アプリがデプロイされたら、実行バーから、アプリの停止、再始動、デバッグ、ログの表示などの操作を実行できます。 -![実行バー](images/webide_runbar.png) - - - - ## {{site.data.keyword.webide}} の外部での編集 -{: #editlocal} - -{{site.data.keyword.webide}} 以外のエディターを使用する場合は、プロジェクト・ファイルを任意のツールで直接操作できるように {{site.data.keyword.Bluemix_live}} をセットアップする必要があります。{{site.data.keyword.Bluemix_live_notm}} は、ローカル・ファイル・システムの変更内容を {{site.data.keyword.jazzhub}} のクラウド・ワークスペースと同期するためのコマンド・ライン・アプリケーションです。 - -### 始めに - -[{{site.data.keyword.Bluemix_live_notm}} コマンド・ライン・インターフェース (リンク先が新しいウィンドウで開きます)](http://livesyncdownload.ng.bluemix.net){: new_window} をダウンロードしてインストールします。 - -### ローカル環境と {{site.data.keyword.Bluemix_notm}} の同期 -{: #edit_local_download} - -1. コマンド・ライン・ウィンドウを開きます。 -2. {{site.data.keyword.Bluemix_notm}} にサインインします。 - - ``` - bl login - ``` - {: pre} - -3. IBMid とパスワードが要求されたら、それぞれを入力します。 -4. {{site.data.keyword.Bluemix_notm}} プロジェクトのリストを表示します。 - - ``` - bl projects - ``` - {: pre} - -4. ローカル環境を {{site.data.keyword.Bluemix_notm}} のプロジェクトと同期します。 - - ``` - bl sync projectName - ``` - {: pre} - -`projectName` は {{site.data.keyword.Bluemix_notm}} アプリの名前です。 - -編集が終わったら、`q` と入力して同期を終了します。 - -### デスクトップ同期機能を有効にしてローカル環境でコードを編集する方法 - -デスクトップ同期機能は、コマンド・ラインのライブ編集モードのようなものです。コマンド・ラインでデバッグを実行するには、デスクトップ同期機能が必要です。 -1. 別のコマンド・ライン・ウィンドウでデスクトップ同期機能を有効にします。 - - ``` - cd localDirectory - bl start - ``` - {: codeblock} - -2. {{site.data.keyword.webide}} で作成した起動構成を使用します。起動構成を選択すると、ローカル環境でデスクトップ同期機能が有効になります。先ほど開いたコマンド・ライン・ウィンドウで、アプリの URL、デバッグ URL、管理 URL、{{site.data.keyword.Bluemix_live_notm}} の状態を表示できます。 - -3. ブラウザーの表示を更新して、ローカル・ワークスペースの静的ファイルに保存した変更内容が表示されることを確認します。 - -### デスクトップ同期機能を無効にする方法 - -1. 2 番目のコマンド・ライン・ウィンドウで `bl stop` と入力します。 -2. 1 番目のコマンド・ライン・ウィンドウで `q` と入力します。 +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} +{:pre: .pre} + +# Eclipse Orion {{site.data.keyword.webide}} によるコードの編集 +{: #web_ide} + +最終更新日: 2016 年 9 月 9 日 +{: .last-updated} + +Eclipse Orion {{site.data.keyword.webide}} は、Web 向けの開発を行うためのブラウザー・ベースの開発環境です。JavaScript、HTML、CSS での開発が可能であり、コンテンツ・アシスト、コード補完、エラー・チェックの機能を備えています。{{site.data.keyword.webide}} はほぼすべての言語に対応しており、ほとんどの[ファイル・タイプ (リンク先が新しいウィンドウで開きます)](https://hub.jazz.net/docs/overview/#dev_support){: new_window} で構文の強調表示が可能です。Git または Jazz の SCM によるソース管理機能が組み込まれており、ローカル環境にコードをデプロイしてアプリのテストやデバッグを実行できるようになっています。 +{:shortdesc} + +何よりも、{{site.data.keyword.webide}} は Web が基盤になっています。インストールもメンテナンスもスケーリングも不要です。インターネット接続さえあれば、どこでも開発作業を行えます。 + +## エディターの設定 +{: #editorsetup} + +{{site.data.keyword.webide}} はカスタマイズが可能なので、それぞれの開発要件に合わせてカラー・スキームやテクニカル・ツールや設定を選択できます。設定を表示して変更するには、左側のメニューから**「設定」**アイコン「設定」アイコンをクリックします。 + +編集中にしばしば設定を変更する必要がある場合は、エディターの右上隅にある**「ローカル・エディター設定」**アイコン 「ローカル・エディター設定」アイコンから簡単に設定にアクセスできます。 + +![ローカル・エディター設定](images/webide_local_editor_settings.png) + +デフォルトでは、エディターのスタイルやフォント・サイズの設定は常に表示されます。その他のエディター設定をメニューに組み込む場合は、以下の手順を実行してください。 + +1. **「ローカル・エディター設定」**アイコン「ローカル・エディター設定」アイコンをクリックします。 + +2. **「エディター設定」**をクリックします。 + +3. **「ローカル・エディター設定」**メニューで設定を組み込んだり除外したりするには、各設定の横にある円をクリックします。 + +![エディター設定の切り替え](images/webide_editor_settings_toggle.png) + + +## コードの編集 +{: #editcode} + +{{site.data.keyword.webide}} には 2 つの主なセクションがあります。1 番目のセクションは、左側のファイル・ナビゲーターです。そこにはプロジェクト・ファイルがツリー構造で表示されます。ファイル・ナビゲーターから、ファイルやフォルダーの作成、名前変更、削除、管理を実行できます。 + +**ヒント:** ファイル・ナビゲーターにファイルをアップロードするには、コンピューターからファイル・ナビゲーターにファイルをドラッグします。 + +2 番目のセクションは、右側のエディター・ペインです。エディターには、コンテンツ・アシストや構文検証などのコーディング機能が用意されています。 + +![Web IDE](images/webide.png) + +### 複数のファイルの操作 +1. 2 つのファイルを同時に操作するには、エディターの上部にある**「分割エディター・モードを変更します」**アイコン「分割エディター」アイコンをクリックします。 +2. メニューが表示されたら、ビューを選択します。 + + ビューを選択した時に、ファイルがすでにエディターで開かれていた場合は、両方のエディター・ビューに表示されます。 + + いずれかのエディター・ビューで表示されているファイルを開いたり変更したりする場合は、以下のようにします。 + 1. 変更するエディター・ビューにカーソルを移動します。 + 2. ファイル・ナビゲーターでファイルをクリックします。 + +### キーボード・ショートカット +{{site.data.keyword.webide}} のほとんどのコマンドは、キーボード・ショートカットでのみアクセスできます。 + +エディターのキーボード・ショートカットのリストを参照するには、Alt+Shift+? を押してください。Mac OS を使用している場合は、Ctrl+Shift+? を押してください。 + +## ソース・コードの管理 +{: #sourcecontrol} + +{{site.data.keyword.webide}} には、ソース・コード管理ツールが統合されています。Git リポジトリーを操作するには、**「Git リポジトリー」**アイコン「Git リポジトリー」アイコンをクリックします。詳しくは、[Git によるソース管理 (リンク先が新しいウィンドウで開きます)](https://hub.jazz.net/docs/git/){: new_window} を参照してください。 + + +## ワークスペースからアプリをデプロイする方法 +{: #deploy} + +1. 実行バーからアプリをデプロイするには、起動構成を選択するか[作成 (リンク先が新しいウィンドウで開きます)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} します。 +1. デプロイ・アイコンデプロイ・アイコンをクリックします。ワークスペースの現在のコンテンツと起動構成で定義されている環境に基づいて、アプリのインスタンスがデプロイされます。 +2. アプリがデプロイされたら、実行バーから、アプリの停止、再始動、デバッグ、ログの表示などの操作を実行できます。 +![実行バー](images/webide_runbar.png) + + + + ## {{site.data.keyword.webide}} の外部での編集 +{: #editlocal} + +{{site.data.keyword.webide}} 以外のエディターを使用する場合は、プロジェクト・ファイルを任意のツールで直接操作できるように {{site.data.keyword.Bluemix_live}} をセットアップする必要があります。{{site.data.keyword.Bluemix_live_notm}} は、ローカル・ファイル・システムの変更内容を {{site.data.keyword.jazzhub}} のクラウド・ワークスペースと同期するためのコマンド・ライン・アプリケーションです。 + +### 始めに + +[{{site.data.keyword.Bluemix_live_notm}} コマンド・ライン・インターフェース (リンク先が新しいウィンドウで開きます)](http://livesyncdownload.ng.bluemix.net){: new_window} をダウンロードしてインストールします。 + +### ローカル環境と {{site.data.keyword.Bluemix_notm}} の同期 +{: #edit_local_download} + +1. コマンド・ライン・ウィンドウを開きます。 +2. {{site.data.keyword.Bluemix_notm}} にサインインします。 + + ``` + bl login + ``` + {: pre} + +3. IBMid とパスワードが要求されたら、それぞれを入力します。 +4. {{site.data.keyword.Bluemix_notm}} プロジェクトのリストを表示します。 + + ``` + bl projects + ``` + {: pre} + +4. ローカル環境を {{site.data.keyword.Bluemix_notm}} のプロジェクトと同期します。 + + ``` + bl sync projectName + ``` + {: pre} + +`projectName` は {{site.data.keyword.Bluemix_notm}} アプリの名前です。 + +編集が終わったら、`q` と入力して同期を終了します。 + +### デスクトップ同期機能を有効にしてローカル環境でコードを編集する方法 + +デスクトップ同期機能は、コマンド・ラインのライブ編集モードのようなものです。コマンド・ラインでデバッグを実行するには、デスクトップ同期機能が必要です。 +1. 別のコマンド・ライン・ウィンドウでデスクトップ同期機能を有効にします。 + + ``` + cd localDirectory + bl start + ``` + {: codeblock} + +2. {{site.data.keyword.webide}} で作成した起動構成を使用します。起動構成を選択すると、ローカル環境でデスクトップ同期機能が有効になります。先ほど開いたコマンド・ライン・ウィンドウで、アプリの URL、デバッグ URL、管理 URL、{{site.data.keyword.Bluemix_live_notm}} の状態を表示できます。 + +3. ブラウザーの表示を更新して、ローカル・ワークスペースの静的ファイルに保存した変更内容が表示されることを確認します。 + +### デスクトップ同期機能を無効にする方法 + +1. 2 番目のコマンド・ライン・ウィンドウで `bl stop` と入力します。 +2. 1 番目のコマンド・ライン・ウィンドウで `q` と入力します。 diff --git a/toolchains/nl/ko/toolchains_about.md b/toolchains/nl/ko/toolchains_about.md index af22af42c..d16e93b70 100644 --- a/toolchains/nl/ko/toolchains_about.md +++ b/toolchains/nl/ko/toolchains_about.md @@ -1,43 +1,43 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# 도구 체인 정보 -{: #toolchains_about} - -마지막 업데이트 날짜: 2016년 9월 13일 -{: .last-updated} - -*도구 체인*은 개발, 배치 및 운영 태스크를 지원하는 도구 통합 세트입니다. 도구 체인의 전체 기능은 개별 도구 통합을 합한 기능보다 강합니다. - -{:shortdesc} - -도구 체인은 {{site.data.keyword.Bluemix}}의 퍼블릭 및 데디케이티드 환경에서 사용할 수 있습니다. 템플리트를 사용하여 도구 체인을 작성하거나 앱에서 도구 체인을 작성하는 식의 두 방식으로 도구 체인을 작성할 수 있습니다. 시작점으로 도구 체인 템플리트를 사용할 수 있습니다. 사용하는 템플리트에 따라 특정 도구 통합 세트가 있는 도구 체인을 작성하거나 도구 통합을 추가할 수 있는 비어 있는 도구 체인을 작성할 수 있습니다. - -{{site.data.keyword.Bluemix_notm}} 퍼블릭에서 사용하는 템플리트 또는 도구 체인에 따라 도구 체인에는 앱 스타터 코드 및 사전 구성된 Delivery Pipeline으로 채워진 GitHub 저장소(repo)가 포함될 수 있습니다. 도구 체인의 GitHub 저장소에 변경사항을 푸시하면 Delivery Pipeline에서 자동으로 앱을 빌드하여 {{site.data.keyword.Bluemix_notm}}에 배치합니다. - -{{site.data.keyword.Bluemix_notm}} 데디케이티드에서 사용하는 도구 체인에 따라 도구 체인에는 앱 스타터 코드 및 사전 구성된 Delivery Pipeline으로 채워진 GitHub Enterprise 저장소가 포함될 수 있습니다. 도구 체인의 GitHub Enterprise 저장소에 변경사항을 푸시하면 Delivery Pipeline에서 자동으로 앱을 빌드하여 {{site.data.keyword.Bluemix_notm}}에 배치합니다. - -## 도구 체인에 대한 도움 및 지원 받기 -{: #gettinghelp} - -도구 체인을 사용할 때 문제점이나 질문이 있으면 정보를 검색하거나 포럼을 통해 질문하여 도움을 받을 수 있습니다. 또한 지원 티켓을 열 수도 있습니다. - -포럼을 통해 질문하는 경우, {{site.data.keyword.Bluemix_notm}} 개발 팀이 볼 수 있도록 질문에 태그를 지정하십시오. - -* 도구 체인으로 앱을 개발하거나 배치하는 데 대한 기술 질문이 있으면 [스택 오버플로우(링크가 새 창에서 열림)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window}에 질문을 게시하고 "ibm-bluemix" 및 "devops"로 질문에 태그를 지정하십시오. - -* 도구 체인 및 시작하기 지시사항에 대한 질문은 [IBM developerWorks dW 응답(링크가 새 창에서 열림)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window} 포럼을 사용하십시오. "devops-services" 및 "bluemix" 태그를 포함하십시오. - -포럼을 사용하는 데 대한 자세한 정보는 [도움받기(링크가 새 창에서 열림)](https://www.{DomainName}/docs/support/index.html#getting-help)를 참조하십시오. - -IBM 지원 티켓을 여는 데 관한 정보 또는 지원 레벨 및 티켓 심각도는 [지원에 문의(링크가 새 창에서 열림)](https://www.{DomainName}/docs/support/index.html#contacting-support)를 참조하십시오. +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# 도구 체인 정보 +{: #toolchains_about} + +마지막 업데이트 날짜: 2016년 9월 13일 +{: .last-updated} + +*도구 체인*은 개발, 배치 및 운영 태스크를 지원하는 도구 통합 세트입니다. 도구 체인의 전체 기능은 개별 도구 통합을 합한 기능보다 강합니다. + +{:shortdesc} + +도구 체인은 {{site.data.keyword.Bluemix}}의 퍼블릭 및 데디케이티드 환경에서 사용할 수 있습니다. 템플리트를 사용하여 도구 체인을 작성하거나 앱에서 도구 체인을 작성하는 식의 두 방식으로 도구 체인을 작성할 수 있습니다. 시작점으로 도구 체인 템플리트를 사용할 수 있습니다. 사용하는 템플리트에 따라 특정 도구 통합 세트가 있는 도구 체인을 작성하거나 도구 통합을 추가할 수 있는 비어 있는 도구 체인을 작성할 수 있습니다. + +{{site.data.keyword.Bluemix_notm}} 퍼블릭에서 사용하는 템플리트 또는 도구 체인에 따라 도구 체인에는 앱 스타터 코드 및 사전 구성된 Delivery Pipeline으로 채워진 GitHub 저장소(repo)가 포함될 수 있습니다. 도구 체인의 GitHub 저장소에 변경사항을 푸시하면 Delivery Pipeline에서 자동으로 앱을 빌드하여 {{site.data.keyword.Bluemix_notm}}에 배치합니다. + +{{site.data.keyword.Bluemix_notm}} 데디케이티드에서 사용하는 도구 체인에 따라 도구 체인에는 앱 스타터 코드 및 사전 구성된 Delivery Pipeline으로 채워진 GitHub Enterprise 저장소가 포함될 수 있습니다. 도구 체인의 GitHub Enterprise 저장소에 변경사항을 푸시하면 Delivery Pipeline에서 자동으로 앱을 빌드하여 {{site.data.keyword.Bluemix_notm}}에 배치합니다. + +## 도구 체인에 대한 도움 및 지원 받기 +{: #gettinghelp} + +도구 체인을 사용할 때 문제점이나 질문이 있으면 정보를 검색하거나 포럼을 통해 질문하여 도움을 받을 수 있습니다. 또한 지원 티켓을 열 수도 있습니다. + +포럼을 통해 질문하는 경우, {{site.data.keyword.Bluemix_notm}} 개발 팀이 볼 수 있도록 질문에 태그를 지정하십시오. + +* 도구 체인으로 앱을 개발하거나 배치하는 데 대한 기술 질문이 있으면 [스택 오버플로우(링크가 새 창에서 열림)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window}에 질문을 게시하고 "ibm-bluemix" 및 "devops"로 질문에 태그를 지정하십시오. + +* 도구 체인 및 시작하기 지시사항에 대한 질문은 [IBM developerWorks dW 응답(링크가 새 창에서 열림)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window} 포럼을 사용하십시오. "devops-services" 및 "bluemix" 태그를 포함하십시오. + +포럼을 사용하는 데 대한 자세한 정보는 [도움받기(링크가 새 창에서 열림)](https://www.{DomainName}/docs/support/index.html#getting-help)를 참조하십시오. + +IBM 지원 티켓을 여는 데 관한 정보 또는 지원 레벨 및 티켓 심각도는 [지원에 문의(링크가 새 창에서 열림)](https://www.{DomainName}/docs/support/index.html#contacting-support)를 참조하십시오. diff --git a/toolchains/nl/ko/toolchains_integrations.md b/toolchains/nl/ko/toolchains_integrations.md index ee2eeda09..7e152f4ab 100644 --- a/toolchains/nl/ko/toolchains_integrations.md +++ b/toolchains/nl/ko/toolchains_integrations.md @@ -1,304 +1,304 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 도구 통합 구성 -{: #integrations} - -마지막 업데이트 날짜: 2016년 10월 18일 -{: .last-updated} - -도구 체인을 작성하는 동안 개발, 배치 및 운영 태스크를 지원하는 도구 통합을 구성하거나 기존 도구 체인을 사용자 정의하도록 도구 통합을 추가하여 구성할 수 있습니다. -{:shortdesc} - -**중요**: {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 도구 체인은 미국 남부 지역에서만 사용할 수 있습니다. - -도구 체인용으로 추가하여 구성할 수 있는 도구 통합은 도구 체인을 사용하는 환경({{site.data.keyword.Bluemix_notm}} 퍼블릭 또는 {{site.data.keyword.Bluemix_notm}} 데디케이티드)에 따라 달라집니다. {{site.data.keyword.Bluemix_notm}} 데디케이티드에서 도구 체인을 사용하는 경우 사용 가능한 도구 통합은 {{site.data.keyword.jazzhub_title}}를 특정 환경에 설정한 방법에 따라 다릅니다. - -*표 1. {{site.data.keyword.Bluemix_notm}} 퍼블릭 및 데디케이티드에서 도구 체인에 사용 가능한 도구 통합* - -|도구 통합 |{{site.data.keyword.Bluemix_notm}} 퍼블릭에서 사용 가능 |{{site.data.keyword.Bluemix_notm}} 데디케이티드에서 사용 가능(환경에 따라 다름) | -|:----------|:------------------------------|:------------------| -|{{site.data.keyword.deliverypipeline}} |예 |예 | -|{{site.data.keyword.DRA_short}} |예 |아니오 | -|Eclipse Orion {{site.data.keyword.webide}} |예 |예 | -|GitHub |예 |예 | -|Dedicated GitHub Enterprise |아니오 |예 | -|기타 도구 |예 |예 | -|PagerDuty |예 |예 | -|Sauce Labs |예 |아니오 | -|Slack |예 |예 | - -**팁**: {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 소스 코드로 개발을 시작하려면 {{site.data.keyword.deliverypipeline}}을 구성하기 전에 GitHub 도구 통합을 구성하십시오. {{site.data.keyword.Bluemix_notm}} 데디케이티드에서 코드로 개발을 시작하려면 {{site.data.keyword.deliverypipeline}}을 구성하기 전에 {{site.data.keyword.ghe_short}} 도구 통합 또는 GibHub 도구 통합을 구성하십시오. - - -## Delivery Pipeline 구성 -{: #deliverypipeline} - -{{site.data.keyword.deliverypipeline}}은 입력을 검색하고 작업(예: 빌드, 테스트 및 배치)을 실행하는 일련의 단계를 통해 자동으로 프로젝트를 연속 배치합니다. - -앱을 자동으로 연속 빌드, 테스트 및 배치하도록 {{site.data.keyword.deliverypipeline}}을 구성하십시오. - -1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 구성 가능한 통합 섹션에서 **Delivery Pipeline**을 클릭하십시오. 사용하는 템플리트에 따라 여러 다른 필드를 사용할 수 있습니다. 기본 필드 값을 검토하고 필요한 경우 해당 설정을 변경하십시오. -1. {{site.data.keyword.Bluemix_notm}} 퍼블릭에 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. {{site.data.keyword.Bluemix_notm}} 데디케이티드에서 도구 체인을 사용하는 경우 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. -1. 추가 단추(+)를 클릭하십시오. -1. 도구 통합 섹션에서 **Delivery Pipeline**을 클릭하십시오. -1. 새 파이프라인의 이름을 지정하십시오. -1. 파이프라인을 통해 사용자 인터페이스를 배치하려는 경우 **표시 가능 앱** 선택란을 선택하십시오. 파이프라인에서 작성하는 모든 앱이 도구 체인의 도구 통합 페이지에 있는 **앱 보기** 목록에 표시됩니다. -1. **통합 작성**을 클릭하여 도구 체인에 {{site.data.keyword.deliverypipeline}}을 추가하십시오. -1. {{site.data.keyword.deliverypipeline}}의 타일을 클릭하여 파이프라인을 보고 구성하십시오. 파이프라인 구성에 대한 기본사항을 알아보려면 [파이프라인 빌드 및 배치(링크가 새 창에서 열림)](../services/DeliveryPipeline/build_deploy.html){: new_window}를 참조하십시오. - - **팁**: GitHub 또는 {{site.data.keyword.ghe_short}} 저장소(repo)에 변경사항을 푸시할 때 파이프라인을 트리거하려면 파이프라인의 단계를 정의하기 전에 도구 체인의 GitHub 또는 {{site.data.keyword.ghe_short}}를 구성해야 합니다. 파이프라인 단계에는 저장소의 Git URL이 필요합니다. 각 파이프라인 단계는 도구 체인과 연관된 GitHub 또는 {{site.data.keyword.ghe_short}} 저장소 중 하나만 참조할 수 있습니다. GitHub 구성 지시사항은 [GitHub](#github) 섹션을 참조하십시오. Dedicated GitHub Enterprise 구성 지시사항은 [{{site.data.keyword.ghe_long}} 시작하기(링크가 새 창에서 열림)](../services/ghededicated/index.html){: new_window}를 참조하십시오, - -1. 선택사항: {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 도구 체인을 사용하고 Sauce Labs에서 앱에 대한 테스트를 실행하도록 하려면 Sauce Labs 테스트 작업을 추가하도록 {{site.data.keyword.deliverypipeline}}을 구성하십시오. 테스트 작업을 구성하는 데 관한 지시사항은 [파이프라인에서 Sauce Labs 테스트 작업 구성](#config_saucelabs) 섹션을 참조하십시오. - -### 파이프라인에서 Sauce Labs 테스트 작업 구성 -{: #config_saucelabs} - -파이프라인에서 Sauce Labs 테스트 작업을 구성하기 전에 앱을 빌드하고 배치하는 단계가 포함된 작동하는 파이프라인이 있어야 하며 도구 체인에 맞게 Sauce Labs를 구성해야 합니다. Sauce Labs를 구성하는 데 관한 지시사항은 [Sauce Labs](#saucelabs) 섹션을 참조하십시오. - -다음과 같이 Sauce Labs 테스트 작업을 추가하도록 {{site.data.keyword.deliverypipeline}}을 구성하십시오. - -1. 앱의 테스트 버전을 배치하는 단계가 없으면 하나를 작성하십시오. -1. 이 단계에서 배치 작업 다음에 테스트 작업을 추가하십시오. 이러한 작업을 동일한 단계에 배치하면 동일한 환경 특성 세트에 액세스할 수 있습니다. - ![테스트 작업](images/toolchain_test_job.png) - -1. 다음과 같이 단계를 구성하십시오. - - a. **환경 특성** 탭에서 세 가지 특성(CF_APP_NAME, SAUCE_USERNAME 및 SAUCE_ACCESS_KEY)을 작성하십시오. - - b. Sauce Labs 사용자 이름과 액세스 키를 입력하십시오. 그러면 테스트에서 사용할 수 있도록 이 값을 구체화할 수 있습니다. - -1. 배치 작업을 구성하십시오. **스크립트 배치** 필드에 `export CF_APP_NAME="$CF_APP"` 명령을 포함하십시오. 이 명령은 앱 이름을 환경 특성으로 내보냅니다. -1. 테스트 작업을 구성하십시오. 다음 이미지의 값은 예입니다. 사용 중인 Sauce Labs 사용자 이름, 영역, 조직 및 영역이 **서비스 인스턴스**, **대상**, **조직** 및 **영역** 필드에 입력됩니다. -![작업 구성](images/toolchain_configure_job.png) - - a. 테스터 유형으로 **Sauce Labs**를 선택하십시오. - - b. 서비스 인스턴스의 경우, 도구 체인의 Sauce Labs를 구성할 때 사용한 Sauce Labs 사용자 이름을 선택하십시오. - - **팁**: 도구 체인의 Sauce Labs를 구성할 때 사용한 사용자 이름과 액세스 키를 확인하려면 **구성**을 클릭하십시오. - - c. **테스트 실행 명령** 필드에 테스트에 필요한 종속 항목을 설치한 다음 테스트를 실행하는 명령을 입력하십시오. 예를 들어 Node.js 앱의 경우 다음 명령을 입력할 수 있습니다. - ``` -npm install - node_modules/grunt-cli/bin/grunt test:sauce:parallel - ``` - - d. 테스트 작업 로그에서 테스트 보고서를 보려면 **테스트 보고서 사용** 선택란을 선택하고 테스트 결과 파일 패턴을 `test/*.xml`로 설정하십시오. - -1. **저장**을 클릭하십시오. 파이프라인을 실행할 때마다 Sauce Labs 테스트가 실행됩니다. - -자세한 정보는 [Delivery Pipeline(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}을 참조하십시오. - - -## {{site.data.keyword.DRA_short}} 추가 -{: #dra} - -{{site.data.keyword.DRA_full}}에서는 코드가 배치 프로세스의 지정된 게이트에 사전 정의된 기준을 만족하는지 판별하기 위해 단위 테스트, Functional Test 및 코드 적용 범위 도구에서 결과를 수집하여 분석합니다. 코드가 기준을 충족하지 않거나 초과하는 경우 위험이 표출되지 않도록 배치가 중지됩니다. {{site.data.keyword.DRA_short}}를 Continuous Delivery 환경의 안전망 또는 품질 표준을 구현하고 개선하는 방법으로 사용할 수 있습니다. - - **참고**: 이 도구 통합은 사전 구성됩니다. 구성 매개변수가 필요하지 않고 이 통합을 다시 구성할 수 없습니다. - -위험이 표출되기 전에 위험을 식별하기 위해 배치를 모니터링하여 {{site.data.keyword.Bluemix_notm}}의 코드 품질을 유지보수하고 개선하도록 {{site.data.keyword.DRA_short}}를 추가하십시오. - -1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. -1. 추가 단추(+)를 클릭하십시오. -1. 도구 통합 섹션에서 **배치 위험 분석**을 클릭하십시오. -1. **통합 작성**을 클릭하십시오. -1. {{site.data.keyword.DRA_short}}의 타일을 클릭한 후 시작하기 단계(기준 작성, 파이프라인에 기준 연결 및 파이프라인 실행)를 완료하십시오. 자세한 정보는 [{{site.data.keyword.DRA_short}}(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}을 참조하십시오. - - -## Eclipse Orion {{site.data.keyword.webide}} 추가 -{: #webide} - -Eclipse Orion {{site.data.keyword.webide}}는 소스 제어 태스크를 작성, 편집, 실행, 디버그 및 완료할 수 있는 통합된 웹 기반 환경입니다. 편집에서 실행, 제출 및 배치까지 원활하게 이동할 수 있습니다. - - **참고**: 이 도구 통합은 사전 구성됩니다. 구성 매개변수가 필요하지 않고 이 통합을 다시 구성할 수 없습니다. - -소스 제어 태스크를 완료하려면 다음과 같이 Eclipse Orion {{site.data.keyword.webide}} 도구 통합을 추가하십시오. - -1. {{site.data.keyword.Bluemix_notm}} 퍼블릭에 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. {{site.data.keyword.Bluemix_notm}} 데디케이티드에서 도구 체인을 사용하는 경우 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. -1. 추가 단추(+)를 클릭하십시오. -1. 도구 통합 섹션에서 **Eclipse Orion Web IDE**를 클릭하십시오. -1. **통합 작성**을 클릭하십시오. -1. 새 Eclipse Orion {{site.data.keyword.webide}}의 타일을 클릭하십시오. 작업공간이 GitHub 또는 {{site.data.keyword.ghe_short}} 저장소로 미리 채워집니다. 현재 도구 체인과 연관된 저장소가 강조표시됩니다. - -자세한 정보는 [Eclipse Orion {{site.data.keyword.webide}}로 노드 편집(링크가 새 창에서 열림)](../toolchains/web_ide.html){: new_window}을 참조하십시오. - - -## GitHub 구성 -{: #github} - -GitHub는 Git 저장소의 웹 기반 호스팅 서비스입니다. 쉽게 협업할 수 있도록 저장소의 로컬 및 원격 사본을 모두 보유할 수 있습니다. - -GitHub Issues는 작업과 플랜을 모두 한 위치에 보관하는 추적 도구입니다. 중요한 태스크에 초점을 맞출 수 있도록 개발 저장소와 통합됩니다. - -클라우드에서 소스 코드를 관리하도록 다음과 같이 GitHub를 구성하십시오. - -1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 다음 단계를 따르십시오. - - a. 구성 가능한 통합 섹션에서 **GitHub**를 클릭하십시오. {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 도구 체인을 작성하고 있으며 GitHub에 액세스할 수 있는 {{site.data.keyword.Bluemix_notm}}에 권한을 부여받지 않은 경우 **권한 부여**를 클릭하여 GitHub 웹 사이트로 이동하십시오. 활성 GitHub 세션이 없으면 로그인하도록 메시지를 표시합니다. **애플리케이션 권한 부여**를 클릭하여 {{site.data.keyword.Bluemix_notm}}에서 GitHub 계정에 액세스하도록 허용하십시오. 활성 GitHub 세션이 있지만 최근에 비밀번호를 입력하지 않은 경우 확인을 위해 GitHub 비밀번호 입력을 요구하는 프롬프트가 표시될 수 있습니다. - - b. GitHub 저장소의 기본 대상 저장소 위치를 검토하십시오. 해당 저장소는 샘플 저장소에서 복제됩니다. 필요한 경우 대상 저장소의 이름을 변경하십시오. - ![기본 대상 저장소 위치](images/toolchain_github_config.png) - -1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. -1. 추가 단추(+)를 클릭하십시오. -1. 도구 통합 섹션에서 **GitHub**를 클릭하십시오. -1. 보유한 GitHub 저장소를 사용하려는 경우 URL을 입력하십시오. 저장소 유형으로 **링크**를 클릭하십시오. -1. 새 GitHub 저장소를 사용하려면 다음과 같이 GitHub 저장소의 이름을 입력하고 복제 또는 분기 중인 저장소의 URL을 입력한 다음 저장소 유형을 선택하십시오. - - a. 비어 있는 저장소를 작성하려면 **새로 작성**을 클릭하십시오. - - b. GitHub 저장소의 사본을 작성하려면 **복제**를 클릭하십시오. - - c. 가져오기 요청을 통해 변경사항을 컨트리뷰션하도록 GitHub 저장소를 분기 실행하려면 **분기**를 클릭하십시오. - -1. GitHub Issues를 문제 추적에 사용하려는 경우 **GitHub Issues 사용** 선택란을 선택하십시오. -1. **통합 작성**을 클릭하십시오. -1. 작업할 GitHub 저장소의 타일을 클릭하십시오. 저장소의 컨텐츠를 볼 수 있는 GitHub 웹 사이트가 열립니다. - - **팁**: Eclipse Orion {{site.data.keyword.webide}}에서 통합 소스 코드 관리 도구를 사용하여 GitHub 저장소를 편집하고 작업공간에서 앱을 배치할 수 있습니다. - -1. GitHub Issues를 사용한 경우 GitHub Issues의 타일을 클릭하여 여십시오. - -자세한 정보는 [GitHub(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} 및 [GitHub Issues(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}를 참조하십시오. - - -## Dedicated GitHub Enterprise 구성 -{: #configghe} - -{{site.data.keyword.ghe_long}}는 Git 저장소의 사내 구축형 웹 기반 호스팅 서비스입니다. Dedicated GitHub Enterprise는 {{site.data.keyword.Bluemix_notm}} 데디케이티드 고객 전용입니다. GitHub Issues는 작업과 플랜을 한 위치에 보관하는 추적 도구입니다. 중요한 태스크에 초점을 맞출 수 있도록 개발 저장소와 통합됩니다. Dedicated GitHub Enterprise 및 GitHub Issues에 대한 자세한 정보 [Dedicated GitHub Enterprise 사용(링크가 새 창에서 열림)](../services/ghededicated/index.html){: new_window} 및 [GitHub Issues(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}를 참조하십시오. - -회사의 [{{site.data.keyword.Bluemix_notm}} 데디케이티드(링크가 새 창에서 열림)](../dedicated/index.html#dedicated){: new_window} 인스턴스에서 소스 코드를 관리할 수 있도록 {{site.data.keyword.ghe_short}}를 도구 체인의 도구 통합으로 구성할 수 있습니다. - -1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 다음 단계를 따르십시오. - - a. Dedicated GitHub Enterprise에 처음 로그인하기 전에 LDAP을 사용하여 회사의 사용자 레지스트리에서 {{site.data.keyword.Bluemix_notm}} 데디케이티드 인스턴스에 사용자 ID를 추가하도록 회사의 지역 관리자에게 요청하십시오. {{site.data.keyword.ghe_short}} 계정 설정에 대한 자세한 정보는 [Dedicated GitHub Enterprise 사용(링크가 새 창에서 열림)](../services/ghededicated/index.html){: new_window}을 참조하십시오. - - b. 구성 가능한 통합 섹션에서 **{{site.data.keyword.ghe_short}}**를 클릭하십시오. - - c. 새 {{site.data.keyword.ghe_short}} 저장소의 기본 이름을 검토하십시오. 필요한 경우 새 저장소의 이름을 변경하십시오. 다음 이미지는 샘플 저장소에서 복제한 저장소의 예를 표시합니다. 기존 저장소 또는 새 저장소를 사용할 수 있습니다. 새 저장소를 사용하려면 빈 저장소를 작성하거나 저장소를 복제하거나 저장소를 분기할 수 있습니다. - ![기본 저장소 위치](images/toolchain_ghe_config.png) - -1. {{site.data.keyword.Bluemix_notm}} 퍼블릭에 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. {{site.data.keyword.Bluemix_notm}} 데디케이티드에서 도구 체인을 사용하는 경우 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. -1. 추가 단추(+)를 클릭하십시오. -1. 도구 통합 섹션에서 **{{site.data.keyword.ghe_short}}**를 클릭하십시오. -1. 사용할 {{site.data.keyword.ghe_short}} 저장소가 있으면 해당 URL을 입력하십시오. 저장소 유형으로 **기존**을 클릭하십시오. -1. 새 {{site.data.keyword.ghe_short}} 저장소를 사용하려면 다음과 같이 저장소의 이름을 입력하고 복제 또는 분기 중인 저장소의 URL을 입력한 다음 저장소 유형을 선택하십시오. - - a. 비어 있는 저장소를 작성하려면 **새로 작성**을 클릭하십시오. - - b. 저장소의 사본을 작성하려면 **복제**를 클릭하십시오. - - c. 가져오기 요청을 통해 변경사항을 컨트리뷰션하도록 저장소를 분기 실행하려면 **분기**를 클릭하십시오. - -1. GitHub Issues를 문제 추적에 사용하려면 **GitHub Issues 사용** 선택란을 선택하십시오. -1. **통합 작성**을 클릭하십시오. -1. 작업할 {{site.data.keyword.ghe_short}} 저장소의 타일을 클릭하십시오. 저장소의 컨텐츠를 볼 수 있는 회사의 [{{site.data.keyword.Bluemix_notm}} 데디케이티드(링크가 새 창에서 열림)](../dedicated/index.html#dedicated){: new_window} 인스턴스가 열립니다. - - **팁**: Eclipse Orion {{site.data.keyword.webide}}에서 통합 소스 코드 관리 도구를 사용하여 {{site.data.keyword.ghe_short}} 저장소를 편집하고 작업공간에서 앱을 배치할 수 있습니다. - -1. GitHub Issues를 사용한 경우 GitHub Issues의 타일을 클릭하십시오. - - - -## 사용자 정의 도구(기타 도구) 구성 -{: #othertool} - -팀이 도구 체인 통합 목록에 포함되지 않은 도구를 사용하는 경우 사용자 정의 도구를 통합할 수 있습니다. - -사용자 정의 도구가 도구 체인의 다른 도구와 함께 작동되고 팀이 사용할 수 있도록 이 도구를 구성하십시오. -1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 구성 가능한 통합 섹션에서 **기타 도구**를 클릭하십시오. - -1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. -1. 추가 단추(+)를 클릭하십시오. -1. 도구 통합 섹션에서 **기타 도구**를 클릭하십시오. -1. 도구 이름을 입력하십시오. -1. 도구와 가장 밀접하게 연관된 라이프사이클 단계(Phase)를 선택하십시오. 라이프사이클 단계(Phase) 선택사항으로 도구 체인 통합 페이지에서 도구가 나열되는 카테고리를 결정합니다. -1. 아이콘 URL을 추가하십시오. 도구의 통합 카드에 아이콘이 표시됩니다. -1. 문서 URL을 추가하십시오. -1. 도구 인스턴스 이름을 지정하십시오. 예를 들어, My Team Tool입니다. -1. 도구 인스턴스 URL을 추가하십시오. 도구 통합 카드를 클릭하면 도구 인스턴스에 대해 URL이 나열됩니다. -1. 도구에 대한 설명을 추가하십시오. -1. (고급) 필요한 경우 특성을 추가하십시오. 예를 들어, 도구를 도구 체인에 있는 다른 도구와 통합하기 위해 필요한 정보 또는 속성을 나열하십시오. -1. **통합 작성**을 클릭하십시오. - -## PagerDuty 구성 -{: #pagerduty} - -PagerDuty에서는 여러 모니터링 시스템의 데이터를 단일 보기로 통합합니다. 문제가 발생하면 PagerDuty를 통해 현재 문제점을 가장 잘 해결할 수 있는 팀 구성원에게 해당 문제를 알릴 수 있습니다. 팀 구성원이 문제점에 응답하지 않으면 보조 엔지니어나 운영 관리자에게 라우팅하도록 에스컬레이션을 구성할 수 있습니다. - -문제점을 더 빨리 수정하고 중단 시간을 단축시킬 수 있도록 파이프라인 단계 실패가 발생하면 알림을 보내도록 다음과 같이 PagerDuty를 구성하십시오. - -1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 구성 가능한 통합 섹션에서 **PagerDuty**를 클릭하십시오. -1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. -1. 추가 단추(+)를 클릭하십시오. -1. 도구 통합 섹션에서 **PagerDuty**를 클릭하십시오. -1. PagerDuty 계정과 연관된 PagerDuty 사이트 이름을 입력하십시오. PagerDuty 계정이 없으면 [하나를 등록(링크가 새 창에서 열림)](https://signup.pagerduty.com/accounts/new){: new_window}하십시오. -1. PagerDuty 계정의 API 액세스 키를 입력하십시오. 키를 찾는 데 관한 지시사항은 [API 인증(링크가 새 창에서 열림)](https://signup.pagerduty.com/accounts/new){: new_window}을 참조하십시오. -1. PagerDuty 서비스의 이름을 입력하십시오. -1. 기본 PagerDuty 담당자의 이메일 주소를 입력하십시오. -1. 기본 PagerDuty 담당자의 전화번호를 입력하십시오. -1. **통합 작성**을 클릭하십시오. -1. PagerDuty의 타일을 클릭하여 pagerduty.com으로 이동하십시오. 도구 체인에 대해 이 도구 통합을 구성할 때 지정한 PagerDuty 서비스와 연관된 이벤트를 볼 수 있습니다. - -자세한 정보는 [PagerDuty(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}를 참조하십시오. - - -## Sauce Labs 구성 -{: #saucelabs} - -Sauce Labs는 기능 단위 테스트를 실행합니다. Sauce Labs 테스트 스위트가 {{site.data.keyword.deliverypipeline}}의 테스트 작업으로 구성된 경우 테스트 스위트에서 Continuous Delivery 프로세스의 일부로 웹이나 모바일 앱에 대해 테스트를 실행할 수 있습니다. 이러한 테스트는 프로젝트의 귀중한 플로우 제어를 제공하여, 잘못된 코드가 배치되지 못하게 하는 게이트 역할을 수행할 수 있습니다. - -사용자가 웹 사이트나 애플리케이션을 사용할 수 있는 방법을 에뮬레이트할 수 있도록 여러 운영 체제와 브라우저에서 자동화된 Functional Test를 실행하도록 Sauce Labs를 구성하십시오. - -1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 구성 가능한 통합 섹션에서 **Sauce Labs**를 클릭하십시오. -1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. -1. 추가 단추(+)를 클릭하십시오. -1. 도구 통합 섹션에서 **Sauce Labs**를 클릭하십시오. -1. Sauce Labs 계정과 연관된 사용자 이름을 입력하십시오. [Sauce Labs 계정 페이지 맨 위의 환영 메시지에서 사용자 이름 찾기(링크가 새 창에서 열림)](https://saucelabs.com/account){: new_window}를 수행할 수 있습니다. -1. Sauce Labs 계정의 액세스 키를 입력하십시오. [Sauce Labs 계정 페이지에서 키 찾기(링크가 새 창에서 열림)](https://saucelabs.com/account){: new_window}를 수행하십시오. -1. **통합 작성**을 클릭하십시오. -1. Sauce Labs의 타일을 클릭하여 saucelabs.com으로 이동하고 도구 체인의 테스트 활동을 보십시오. - - **팁**: {{site.data.keyword.deliverypipeline}}에 Sauce Labs 테스트 작업을 추가한 경우 서비스 인스턴스를 선택할 수 있습니다. - -자세한 정보는 [Sauce Labs(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}를 참조하십시오. - - -## Slack 구성 -{: #slack} - -**중요**: 공용 Slack 채널에 게시한 알림은 팀의 모든 사용자가 볼 수 있습니다. 각 사용자는 직접 게시한 컨텐츠에 대한 책임이 있습니다. - -Slack은 클라우드 기반의 실시간 메시징 및 알림 시스템입니다. Slack에서는 팀 협업용 이메일을 대체하며 대화식 특성이 강화된 지속적 대화를 제공합니다. 작업과 직접 연관된 채널 세트 또는 전용 채널에서 팀과 통신할 수 있습니다. 채널을 통하거나 둘 이상의 사용자 간 직접 메시지를 통해 파일과 이미지도 공유할 수 있습니다. 직접 메시지와 채널에서의 통신은 검색할 수 있도록 유지합니다. - -도구 통합에서 도구 체인에 대한 알림(예: 테스트 및 배치 활동)을 받도록 Slack을 구성하십시오. - -1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 구성 가능한 통합 섹션에서 **Slack**을 클릭하십시오. -1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. -1. 추가 단추(+)를 클릭하십시오. -1. 도구 통합 섹션에서 **Slack**을 클릭하십시오. -1. Slack 계정의 API 인증 토큰을 입력하십시오. 생성된 전체 액세스 토큰을 사용하여 Slack을 인증해야 합니다. 토큰을 찾는 데 관한 지시사항은 [Slack 인증(링크가 새 창에서 열림)](https://api.slack.com/web#authentication){: new_window}을 참조하십시오. -1. 알림을 보낼 Slack 채널의 이름을 입력하십시오. 지정하는 채널이 없으면 작성됩니다. 채널이 아카이브된 경우 재활성화됩니다. -1. **통합 작성**을 클릭하십시오. -1. Slack의 타일을 클릭하십시오. 구성된 Slack 채널에서 도구 체인의 활동을 모두 볼 수 있습니다. - -자세한 정보는 [Slack(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}을 참조하십시오. - - - - - - - - +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 도구 통합 구성 +{: #integrations} + +마지막 업데이트 날짜: 2016년 10월 18일 +{: .last-updated} + +도구 체인을 작성하는 동안 개발, 배치 및 운영 태스크를 지원하는 도구 통합을 구성하거나 기존 도구 체인을 사용자 정의하도록 도구 통합을 추가하여 구성할 수 있습니다. +{:shortdesc} + +**중요**: {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 도구 체인은 미국 남부 지역에서만 사용할 수 있습니다. + +도구 체인용으로 추가하여 구성할 수 있는 도구 통합은 도구 체인을 사용하는 환경({{site.data.keyword.Bluemix_notm}} 퍼블릭 또는 {{site.data.keyword.Bluemix_notm}} 데디케이티드)에 따라 달라집니다. {{site.data.keyword.Bluemix_notm}} 데디케이티드에서 도구 체인을 사용하는 경우 사용 가능한 도구 통합은 {{site.data.keyword.jazzhub_title}}를 특정 환경에 설정한 방법에 따라 다릅니다. + +*표 1. {{site.data.keyword.Bluemix_notm}} 퍼블릭 및 데디케이티드에서 도구 체인에 사용 가능한 도구 통합* + +|도구 통합 |{{site.data.keyword.Bluemix_notm}} 퍼블릭에서 사용 가능 |{{site.data.keyword.Bluemix_notm}} 데디케이티드에서 사용 가능(환경에 따라 다름) | +|:----------|:------------------------------|:------------------| +|{{site.data.keyword.deliverypipeline}} |예 |예 | +|{{site.data.keyword.DRA_short}} |예 |아니오 | +|Eclipse Orion {{site.data.keyword.webide}} |예 |예 | +|GitHub |예 |예 | +|Dedicated GitHub Enterprise |아니오 |예 | +|기타 도구 |예 |예 | +|PagerDuty |예 |예 | +|Sauce Labs |예 |아니오 | +|Slack |예 |예 | + +**팁**: {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 소스 코드로 개발을 시작하려면 {{site.data.keyword.deliverypipeline}}을 구성하기 전에 GitHub 도구 통합을 구성하십시오. {{site.data.keyword.Bluemix_notm}} 데디케이티드에서 코드로 개발을 시작하려면 {{site.data.keyword.deliverypipeline}}을 구성하기 전에 {{site.data.keyword.ghe_short}} 도구 통합 또는 GibHub 도구 통합을 구성하십시오. + + +## Delivery Pipeline 구성 +{: #deliverypipeline} + +{{site.data.keyword.deliverypipeline}}은 입력을 검색하고 작업(예: 빌드, 테스트 및 배치)을 실행하는 일련의 단계를 통해 자동으로 프로젝트를 연속 배치합니다. + +앱을 자동으로 연속 빌드, 테스트 및 배치하도록 {{site.data.keyword.deliverypipeline}}을 구성하십시오. + +1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 구성 가능한 통합 섹션에서 **Delivery Pipeline**을 클릭하십시오. 사용하는 템플리트에 따라 여러 다른 필드를 사용할 수 있습니다. 기본 필드 값을 검토하고 필요한 경우 해당 설정을 변경하십시오. +1. {{site.data.keyword.Bluemix_notm}} 퍼블릭에 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. {{site.data.keyword.Bluemix_notm}} 데디케이티드에서 도구 체인을 사용하는 경우 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. +1. 추가 단추(+)를 클릭하십시오. +1. 도구 통합 섹션에서 **Delivery Pipeline**을 클릭하십시오. +1. 새 파이프라인의 이름을 지정하십시오. +1. 파이프라인을 통해 사용자 인터페이스를 배치하려는 경우 **표시 가능 앱** 선택란을 선택하십시오. 파이프라인에서 작성하는 모든 앱이 도구 체인의 도구 통합 페이지에 있는 **앱 보기** 목록에 표시됩니다. +1. **통합 작성**을 클릭하여 도구 체인에 {{site.data.keyword.deliverypipeline}}을 추가하십시오. +1. {{site.data.keyword.deliverypipeline}}의 타일을 클릭하여 파이프라인을 보고 구성하십시오. 파이프라인 구성에 대한 기본사항을 알아보려면 [파이프라인 빌드 및 배치(링크가 새 창에서 열림)](../services/DeliveryPipeline/build_deploy.html){: new_window}를 참조하십시오. + + **팁**: GitHub 또는 {{site.data.keyword.ghe_short}} 저장소(repo)에 변경사항을 푸시할 때 파이프라인을 트리거하려면 파이프라인의 단계를 정의하기 전에 도구 체인의 GitHub 또는 {{site.data.keyword.ghe_short}}를 구성해야 합니다. 파이프라인 단계에는 저장소의 Git URL이 필요합니다. 각 파이프라인 단계는 도구 체인과 연관된 GitHub 또는 {{site.data.keyword.ghe_short}} 저장소 중 하나만 참조할 수 있습니다. GitHub 구성 지시사항은 [GitHub](#github) 섹션을 참조하십시오. Dedicated GitHub Enterprise 구성 지시사항은 [{{site.data.keyword.ghe_long}} 시작하기(링크가 새 창에서 열림)](../services/ghededicated/index.html){: new_window}를 참조하십시오, + +1. 선택사항: {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 도구 체인을 사용하고 Sauce Labs에서 앱에 대한 테스트를 실행하도록 하려면 Sauce Labs 테스트 작업을 추가하도록 {{site.data.keyword.deliverypipeline}}을 구성하십시오. 테스트 작업을 구성하는 데 관한 지시사항은 [파이프라인에서 Sauce Labs 테스트 작업 구성](#config_saucelabs) 섹션을 참조하십시오. + +### 파이프라인에서 Sauce Labs 테스트 작업 구성 +{: #config_saucelabs} + +파이프라인에서 Sauce Labs 테스트 작업을 구성하기 전에 앱을 빌드하고 배치하는 단계가 포함된 작동하는 파이프라인이 있어야 하며 도구 체인에 맞게 Sauce Labs를 구성해야 합니다. Sauce Labs를 구성하는 데 관한 지시사항은 [Sauce Labs](#saucelabs) 섹션을 참조하십시오. + +다음과 같이 Sauce Labs 테스트 작업을 추가하도록 {{site.data.keyword.deliverypipeline}}을 구성하십시오. + +1. 앱의 테스트 버전을 배치하는 단계가 없으면 하나를 작성하십시오. +1. 이 단계에서 배치 작업 다음에 테스트 작업을 추가하십시오. 이러한 작업을 동일한 단계에 배치하면 동일한 환경 특성 세트에 액세스할 수 있습니다. + ![테스트 작업](images/toolchain_test_job.png) + +1. 다음과 같이 단계를 구성하십시오. + + a. **환경 특성** 탭에서 세 가지 특성(CF_APP_NAME, SAUCE_USERNAME 및 SAUCE_ACCESS_KEY)을 작성하십시오. + + b. Sauce Labs 사용자 이름과 액세스 키를 입력하십시오. 그러면 테스트에서 사용할 수 있도록 이 값을 구체화할 수 있습니다. + +1. 배치 작업을 구성하십시오. **스크립트 배치** 필드에 `export CF_APP_NAME="$CF_APP"` 명령을 포함하십시오. 이 명령은 앱 이름을 환경 특성으로 내보냅니다. +1. 테스트 작업을 구성하십시오. 다음 이미지의 값은 예입니다. 사용 중인 Sauce Labs 사용자 이름, 영역, 조직 및 영역이 **서비스 인스턴스**, **대상**, **조직** 및 **영역** 필드에 입력됩니다. +![작업 구성](images/toolchain_configure_job.png) + + a. 테스터 유형으로 **Sauce Labs**를 선택하십시오. + + b. 서비스 인스턴스의 경우, 도구 체인의 Sauce Labs를 구성할 때 사용한 Sauce Labs 사용자 이름을 선택하십시오. + + **팁**: 도구 체인의 Sauce Labs를 구성할 때 사용한 사용자 이름과 액세스 키를 확인하려면 **구성**을 클릭하십시오. + + c. **테스트 실행 명령** 필드에 테스트에 필요한 종속 항목을 설치한 다음 테스트를 실행하는 명령을 입력하십시오. 예를 들어 Node.js 앱의 경우 다음 명령을 입력할 수 있습니다. + ``` +npm install + node_modules/grunt-cli/bin/grunt test:sauce:parallel + ``` + + d. 테스트 작업 로그에서 테스트 보고서를 보려면 **테스트 보고서 사용** 선택란을 선택하고 테스트 결과 파일 패턴을 `test/*.xml`로 설정하십시오. + +1. **저장**을 클릭하십시오. 파이프라인을 실행할 때마다 Sauce Labs 테스트가 실행됩니다. + +자세한 정보는 [Delivery Pipeline(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}을 참조하십시오. + + +## {{site.data.keyword.DRA_short}} 추가 +{: #dra} + +{{site.data.keyword.DRA_full}}에서는 코드가 배치 프로세스의 지정된 게이트에 사전 정의된 기준을 만족하는지 판별하기 위해 단위 테스트, Functional Test 및 코드 적용 범위 도구에서 결과를 수집하여 분석합니다. 코드가 기준을 충족하지 않거나 초과하는 경우 위험이 표출되지 않도록 배치가 중지됩니다. {{site.data.keyword.DRA_short}}를 Continuous Delivery 환경의 안전망 또는 품질 표준을 구현하고 개선하는 방법으로 사용할 수 있습니다. + + **참고**: 이 도구 통합은 사전 구성됩니다. 구성 매개변수가 필요하지 않고 이 통합을 다시 구성할 수 없습니다. + +위험이 표출되기 전에 위험을 식별하기 위해 배치를 모니터링하여 {{site.data.keyword.Bluemix_notm}}의 코드 품질을 유지보수하고 개선하도록 {{site.data.keyword.DRA_short}}를 추가하십시오. + +1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. +1. 추가 단추(+)를 클릭하십시오. +1. 도구 통합 섹션에서 **배치 위험 분석**을 클릭하십시오. +1. **통합 작성**을 클릭하십시오. +1. {{site.data.keyword.DRA_short}}의 타일을 클릭한 후 시작하기 단계(기준 작성, 파이프라인에 기준 연결 및 파이프라인 실행)를 완료하십시오. 자세한 정보는 [{{site.data.keyword.DRA_short}}(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}을 참조하십시오. + + +## Eclipse Orion {{site.data.keyword.webide}} 추가 +{: #webide} + +Eclipse Orion {{site.data.keyword.webide}}는 소스 제어 태스크를 작성, 편집, 실행, 디버그 및 완료할 수 있는 통합된 웹 기반 환경입니다. 편집에서 실행, 제출 및 배치까지 원활하게 이동할 수 있습니다. + + **참고**: 이 도구 통합은 사전 구성됩니다. 구성 매개변수가 필요하지 않고 이 통합을 다시 구성할 수 없습니다. + +소스 제어 태스크를 완료하려면 다음과 같이 Eclipse Orion {{site.data.keyword.webide}} 도구 통합을 추가하십시오. + +1. {{site.data.keyword.Bluemix_notm}} 퍼블릭에 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. {{site.data.keyword.Bluemix_notm}} 데디케이티드에서 도구 체인을 사용하는 경우 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. +1. 추가 단추(+)를 클릭하십시오. +1. 도구 통합 섹션에서 **Eclipse Orion Web IDE**를 클릭하십시오. +1. **통합 작성**을 클릭하십시오. +1. 새 Eclipse Orion {{site.data.keyword.webide}}의 타일을 클릭하십시오. 작업공간이 GitHub 또는 {{site.data.keyword.ghe_short}} 저장소로 미리 채워집니다. 현재 도구 체인과 연관된 저장소가 강조표시됩니다. + +자세한 정보는 [Eclipse Orion {{site.data.keyword.webide}}로 노드 편집(링크가 새 창에서 열림)](../toolchains/web_ide.html){: new_window}을 참조하십시오. + + +## GitHub 구성 +{: #github} + +GitHub는 Git 저장소의 웹 기반 호스팅 서비스입니다. 쉽게 협업할 수 있도록 저장소의 로컬 및 원격 사본을 모두 보유할 수 있습니다. + +GitHub Issues는 작업과 플랜을 모두 한 위치에 보관하는 추적 도구입니다. 중요한 태스크에 초점을 맞출 수 있도록 개발 저장소와 통합됩니다. + +클라우드에서 소스 코드를 관리하도록 다음과 같이 GitHub를 구성하십시오. + +1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 다음 단계를 따르십시오. + + a. 구성 가능한 통합 섹션에서 **GitHub**를 클릭하십시오. {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 도구 체인을 작성하고 있으며 GitHub에 액세스할 수 있는 {{site.data.keyword.Bluemix_notm}}에 권한을 부여받지 않은 경우 **권한 부여**를 클릭하여 GitHub 웹 사이트로 이동하십시오. 활성 GitHub 세션이 없으면 로그인하도록 메시지를 표시합니다. **애플리케이션 권한 부여**를 클릭하여 {{site.data.keyword.Bluemix_notm}}에서 GitHub 계정에 액세스하도록 허용하십시오. 활성 GitHub 세션이 있지만 최근에 비밀번호를 입력하지 않은 경우 확인을 위해 GitHub 비밀번호 입력을 요구하는 프롬프트가 표시될 수 있습니다. + + b. GitHub 저장소의 기본 대상 저장소 위치를 검토하십시오. 해당 저장소는 샘플 저장소에서 복제됩니다. 필요한 경우 대상 저장소의 이름을 변경하십시오. + ![기본 대상 저장소 위치](images/toolchain_github_config.png) + +1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. +1. 추가 단추(+)를 클릭하십시오. +1. 도구 통합 섹션에서 **GitHub**를 클릭하십시오. +1. 보유한 GitHub 저장소를 사용하려는 경우 URL을 입력하십시오. 저장소 유형으로 **링크**를 클릭하십시오. +1. 새 GitHub 저장소를 사용하려면 다음과 같이 GitHub 저장소의 이름을 입력하고 복제 또는 분기 중인 저장소의 URL을 입력한 다음 저장소 유형을 선택하십시오. + + a. 비어 있는 저장소를 작성하려면 **새로 작성**을 클릭하십시오. + + b. GitHub 저장소의 사본을 작성하려면 **복제**를 클릭하십시오. + + c. 가져오기 요청을 통해 변경사항을 컨트리뷰션하도록 GitHub 저장소를 분기 실행하려면 **분기**를 클릭하십시오. + +1. GitHub Issues를 문제 추적에 사용하려는 경우 **GitHub Issues 사용** 선택란을 선택하십시오. +1. **통합 작성**을 클릭하십시오. +1. 작업할 GitHub 저장소의 타일을 클릭하십시오. 저장소의 컨텐츠를 볼 수 있는 GitHub 웹 사이트가 열립니다. + + **팁**: Eclipse Orion {{site.data.keyword.webide}}에서 통합 소스 코드 관리 도구를 사용하여 GitHub 저장소를 편집하고 작업공간에서 앱을 배치할 수 있습니다. + +1. GitHub Issues를 사용한 경우 GitHub Issues의 타일을 클릭하여 여십시오. + +자세한 정보는 [GitHub(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} 및 [GitHub Issues(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}를 참조하십시오. + + +## Dedicated GitHub Enterprise 구성 +{: #configghe} + +{{site.data.keyword.ghe_long}}는 Git 저장소의 사내 구축형 웹 기반 호스팅 서비스입니다. Dedicated GitHub Enterprise는 {{site.data.keyword.Bluemix_notm}} 데디케이티드 고객 전용입니다. GitHub Issues는 작업과 플랜을 한 위치에 보관하는 추적 도구입니다. 중요한 태스크에 초점을 맞출 수 있도록 개발 저장소와 통합됩니다. Dedicated GitHub Enterprise 및 GitHub Issues에 대한 자세한 정보 [Dedicated GitHub Enterprise 사용(링크가 새 창에서 열림)](../services/ghededicated/index.html){: new_window} 및 [GitHub Issues(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}를 참조하십시오. + +회사의 [{{site.data.keyword.Bluemix_notm}} 데디케이티드(링크가 새 창에서 열림)](../dedicated/index.html#dedicated){: new_window} 인스턴스에서 소스 코드를 관리할 수 있도록 {{site.data.keyword.ghe_short}}를 도구 체인의 도구 통합으로 구성할 수 있습니다. + +1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 다음 단계를 따르십시오. + + a. Dedicated GitHub Enterprise에 처음 로그인하기 전에 LDAP을 사용하여 회사의 사용자 레지스트리에서 {{site.data.keyword.Bluemix_notm}} 데디케이티드 인스턴스에 사용자 ID를 추가하도록 회사의 지역 관리자에게 요청하십시오. {{site.data.keyword.ghe_short}} 계정 설정에 대한 자세한 정보는 [Dedicated GitHub Enterprise 사용(링크가 새 창에서 열림)](../services/ghededicated/index.html){: new_window}을 참조하십시오. + + b. 구성 가능한 통합 섹션에서 **{{site.data.keyword.ghe_short}}**를 클릭하십시오. + + c. 새 {{site.data.keyword.ghe_short}} 저장소의 기본 이름을 검토하십시오. 필요한 경우 새 저장소의 이름을 변경하십시오. 다음 이미지는 샘플 저장소에서 복제한 저장소의 예를 표시합니다. 기존 저장소 또는 새 저장소를 사용할 수 있습니다. 새 저장소를 사용하려면 빈 저장소를 작성하거나 저장소를 복제하거나 저장소를 분기할 수 있습니다. + ![기본 저장소 위치](images/toolchain_ghe_config.png) + +1. {{site.data.keyword.Bluemix_notm}} 퍼블릭에 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. {{site.data.keyword.Bluemix_notm}} 데디케이티드에서 도구 체인을 사용하는 경우 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. +1. 추가 단추(+)를 클릭하십시오. +1. 도구 통합 섹션에서 **{{site.data.keyword.ghe_short}}**를 클릭하십시오. +1. 사용할 {{site.data.keyword.ghe_short}} 저장소가 있으면 해당 URL을 입력하십시오. 저장소 유형으로 **기존**을 클릭하십시오. +1. 새 {{site.data.keyword.ghe_short}} 저장소를 사용하려면 다음과 같이 저장소의 이름을 입력하고 복제 또는 분기 중인 저장소의 URL을 입력한 다음 저장소 유형을 선택하십시오. + + a. 비어 있는 저장소를 작성하려면 **새로 작성**을 클릭하십시오. + + b. 저장소의 사본을 작성하려면 **복제**를 클릭하십시오. + + c. 가져오기 요청을 통해 변경사항을 컨트리뷰션하도록 저장소를 분기 실행하려면 **분기**를 클릭하십시오. + +1. GitHub Issues를 문제 추적에 사용하려면 **GitHub Issues 사용** 선택란을 선택하십시오. +1. **통합 작성**을 클릭하십시오. +1. 작업할 {{site.data.keyword.ghe_short}} 저장소의 타일을 클릭하십시오. 저장소의 컨텐츠를 볼 수 있는 회사의 [{{site.data.keyword.Bluemix_notm}} 데디케이티드(링크가 새 창에서 열림)](../dedicated/index.html#dedicated){: new_window} 인스턴스가 열립니다. + + **팁**: Eclipse Orion {{site.data.keyword.webide}}에서 통합 소스 코드 관리 도구를 사용하여 {{site.data.keyword.ghe_short}} 저장소를 편집하고 작업공간에서 앱을 배치할 수 있습니다. + +1. GitHub Issues를 사용한 경우 GitHub Issues의 타일을 클릭하십시오. + + + +## 사용자 정의 도구(기타 도구) 구성 +{: #othertool} + +팀이 도구 체인 통합 목록에 포함되지 않은 도구를 사용하는 경우 사용자 정의 도구를 통합할 수 있습니다. + +사용자 정의 도구가 도구 체인의 다른 도구와 함께 작동되고 팀이 사용할 수 있도록 이 도구를 구성하십시오. +1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 구성 가능한 통합 섹션에서 **기타 도구**를 클릭하십시오. + +1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. +1. 추가 단추(+)를 클릭하십시오. +1. 도구 통합 섹션에서 **기타 도구**를 클릭하십시오. +1. 도구 이름을 입력하십시오. +1. 도구와 가장 밀접하게 연관된 라이프사이클 단계(Phase)를 선택하십시오. 라이프사이클 단계(Phase) 선택사항으로 도구 체인 통합 페이지에서 도구가 나열되는 카테고리를 결정합니다. +1. 아이콘 URL을 추가하십시오. 도구의 통합 카드에 아이콘이 표시됩니다. +1. 문서 URL을 추가하십시오. +1. 도구 인스턴스 이름을 지정하십시오. 예를 들어, My Team Tool입니다. +1. 도구 인스턴스 URL을 추가하십시오. 도구 통합 카드를 클릭하면 도구 인스턴스에 대해 URL이 나열됩니다. +1. 도구에 대한 설명을 추가하십시오. +1. (고급) 필요한 경우 특성을 추가하십시오. 예를 들어, 도구를 도구 체인에 있는 다른 도구와 통합하기 위해 필요한 정보 또는 속성을 나열하십시오. +1. **통합 작성**을 클릭하십시오. + +## PagerDuty 구성 +{: #pagerduty} + +PagerDuty에서는 여러 모니터링 시스템의 데이터를 단일 보기로 통합합니다. 문제가 발생하면 PagerDuty를 통해 현재 문제점을 가장 잘 해결할 수 있는 팀 구성원에게 해당 문제를 알릴 수 있습니다. 팀 구성원이 문제점에 응답하지 않으면 보조 엔지니어나 운영 관리자에게 라우팅하도록 에스컬레이션을 구성할 수 있습니다. + +문제점을 더 빨리 수정하고 중단 시간을 단축시킬 수 있도록 파이프라인 단계 실패가 발생하면 알림을 보내도록 다음과 같이 PagerDuty를 구성하십시오. + +1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 구성 가능한 통합 섹션에서 **PagerDuty**를 클릭하십시오. +1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. +1. 추가 단추(+)를 클릭하십시오. +1. 도구 통합 섹션에서 **PagerDuty**를 클릭하십시오. +1. PagerDuty 계정과 연관된 PagerDuty 사이트 이름을 입력하십시오. PagerDuty 계정이 없으면 [하나를 등록(링크가 새 창에서 열림)](https://signup.pagerduty.com/accounts/new){: new_window}하십시오. +1. PagerDuty 계정의 API 액세스 키를 입력하십시오. 키를 찾는 데 관한 지시사항은 [API 인증(링크가 새 창에서 열림)](https://signup.pagerduty.com/accounts/new){: new_window}을 참조하십시오. +1. PagerDuty 서비스의 이름을 입력하십시오. +1. 기본 PagerDuty 담당자의 이메일 주소를 입력하십시오. +1. 기본 PagerDuty 담당자의 전화번호를 입력하십시오. +1. **통합 작성**을 클릭하십시오. +1. PagerDuty의 타일을 클릭하여 pagerduty.com으로 이동하십시오. 도구 체인에 대해 이 도구 통합을 구성할 때 지정한 PagerDuty 서비스와 연관된 이벤트를 볼 수 있습니다. + +자세한 정보는 [PagerDuty(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}를 참조하십시오. + + +## Sauce Labs 구성 +{: #saucelabs} + +Sauce Labs는 기능 단위 테스트를 실행합니다. Sauce Labs 테스트 스위트가 {{site.data.keyword.deliverypipeline}}의 테스트 작업으로 구성된 경우 테스트 스위트에서 Continuous Delivery 프로세스의 일부로 웹이나 모바일 앱에 대해 테스트를 실행할 수 있습니다. 이러한 테스트는 프로젝트의 귀중한 플로우 제어를 제공하여, 잘못된 코드가 배치되지 못하게 하는 게이트 역할을 수행할 수 있습니다. + +사용자가 웹 사이트나 애플리케이션을 사용할 수 있는 방법을 에뮬레이트할 수 있도록 여러 운영 체제와 브라우저에서 자동화된 Functional Test를 실행하도록 Sauce Labs를 구성하십시오. + +1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 구성 가능한 통합 섹션에서 **Sauce Labs**를 클릭하십시오. +1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. +1. 추가 단추(+)를 클릭하십시오. +1. 도구 통합 섹션에서 **Sauce Labs**를 클릭하십시오. +1. Sauce Labs 계정과 연관된 사용자 이름을 입력하십시오. [Sauce Labs 계정 페이지 맨 위의 환영 메시지에서 사용자 이름 찾기(링크가 새 창에서 열림)](https://saucelabs.com/account){: new_window}를 수행할 수 있습니다. +1. Sauce Labs 계정의 액세스 키를 입력하십시오. [Sauce Labs 계정 페이지에서 키 찾기(링크가 새 창에서 열림)](https://saucelabs.com/account){: new_window}를 수행하십시오. +1. **통합 작성**을 클릭하십시오. +1. Sauce Labs의 타일을 클릭하여 saucelabs.com으로 이동하고 도구 체인의 테스트 활동을 보십시오. + + **팁**: {{site.data.keyword.deliverypipeline}}에 Sauce Labs 테스트 작업을 추가한 경우 서비스 인스턴스를 선택할 수 있습니다. + +자세한 정보는 [Sauce Labs(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}를 참조하십시오. + + +## Slack 구성 +{: #slack} + +**중요**: 공용 Slack 채널에 게시한 알림은 팀의 모든 사용자가 볼 수 있습니다. 각 사용자는 직접 게시한 컨텐츠에 대한 책임이 있습니다. + +Slack은 클라우드 기반의 실시간 메시징 및 알림 시스템입니다. Slack에서는 팀 협업용 이메일을 대체하며 대화식 특성이 강화된 지속적 대화를 제공합니다. 작업과 직접 연관된 채널 세트 또는 전용 채널에서 팀과 통신할 수 있습니다. 채널을 통하거나 둘 이상의 사용자 간 직접 메시지를 통해 파일과 이미지도 공유할 수 있습니다. 직접 메시지와 채널에서의 통신은 검색할 수 있도록 유지합니다. + +도구 통합에서 도구 체인에 대한 알림(예: 테스트 및 배치 활동)을 받도록 Slack을 구성하십시오. + +1. 도구 체인을 작성하면서 이 도구 통합을 구성하는 경우 구성 가능한 통합 섹션에서 **Slack**을 클릭하십시오. +1. 보유한 도구 체인에 도구 통합을 추가하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. +1. 추가 단추(+)를 클릭하십시오. +1. 도구 통합 섹션에서 **Slack**을 클릭하십시오. +1. Slack 계정의 API 인증 토큰을 입력하십시오. 생성된 전체 액세스 토큰을 사용하여 Slack을 인증해야 합니다. 토큰을 찾는 데 관한 지시사항은 [Slack 인증(링크가 새 창에서 열림)](https://api.slack.com/web#authentication){: new_window}을 참조하십시오. +1. 알림을 보낼 Slack 채널의 이름을 입력하십시오. 지정하는 채널이 없으면 작성됩니다. 채널이 아카이브된 경우 재활성화됩니다. +1. **통합 작성**을 클릭하십시오. +1. Slack의 타일을 클릭하십시오. 구성된 Slack 채널에서 도구 체인의 활동을 모두 볼 수 있습니다. + +자세한 정보는 [Slack(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}을 참조하십시오. + + + + + + + + diff --git a/toolchains/nl/ko/toolchains_overview.md b/toolchains/nl/ko/toolchains_overview.md index 9925d0f89..73a85051e 100644 --- a/toolchains/nl/ko/toolchains_overview.md +++ b/toolchains/nl/ko/toolchains_overview.md @@ -1,160 +1,160 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# 도구 체인 시작하기(베타) -{: #toolchains_getting_started} - -마지막 업데이트 날짜: 2016년 10월 7일 -{: .last-updated} - -도구 체인은 {{site.data.keyword.Bluemix}}의 퍼블릭 및 데디케이티드 환경에서 사용할 수 있습니다. 템플리트를 사용하여 도구 체인을 작성하거나 앱에서 도구 체인을 작성하는 식의 두 방식으로 도구 체인을 작성할 수 있습니다. {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 도구 체인은 미국 남부 지역에서만 사용할 수 있습니다. -{: shortdesc} - -##도구 체인 시작하기: 퍼블릭 -{: #getting_started_public} - -**참고:** 맨 위 배너를 확인하여 새 Bluemix 인터페이스에서 작업 중인지 확인하십시오. - - * 새 Bluemix에 대한 메시지가 표시되면 기존 Bluemix 인터페이스에서 작업하고 있는 것입니다. 링크를 클릭하여 새 Bluemix 인터페이스를 여십시오. - * 메시지가 표시되지 않으면 새 Bluemix 인터페이스에서 작업하고 있는 것입니다. - -각 도구 체인은 특정 조직과 연관되며 해당 조직의 구성원인 사용자가 연관된 도구 체인에 액세스할 수 있습니다. 도구 체인을 작성하기 전에 도구 체인을 작성할 조직에서 작업 중인지 확인하십시오. 현재 작업 중인 조직이 메뉴 표시줄에 표시됩니다. 다른 조직으로 전환하려면 메뉴 표시줄에서 조직을 클릭한 다음 전환할 조직을 선택하십시오. - -###템플리트에서 도구 체인 작성 -{: #creating_a_toolchain_from_a_template} - -템플리트를 시작점으로 사용하여 특정 도구 통합 세트가 포함된 도구 체인을 작성할 수 있습니다. - -1. 첫 번째 도구 체인을 작성하는 경우 조직에서 도구 체인이 사용되는지 확인하십시오. - 1. DevOps 대시보드를 열고 **도구 체인** 페이지를 클릭하십시오. - 2. **도구 체인 사용** 단추가 표시되면 클릭한 다음 프롬프트를 따라 도구 체인을 작성하십시오. - 3. **도구 체인 사용** 단추가 표시되지 않으면 도구 체인이 이미 사용되는 것입니다. 2단계를 진행하십시오. -1. DevOps 대시보드의 **도구 체인** 페이지에서 추가 단추(+)를 클릭하여 도구 체인을 작성하십시오. -1. 도구 체인 템플리트를 클릭하십시오. 예를 들어, 온라인 상점 샘플을 사용하여 도구 체인을 작성하려면 **마이크로 서비스 도구 체인**을 클릭하십시오. -1. 도구 체인 작성 페이지에서 작성할 도구 체인의 다이어그램을 검토하십시오. 다이어그램에서는 도구 체인의 라이프사이클 단계(Phase)에 있는 각 도구 통합을 보여줍니다. 다음 이미지의 다이어그램은 예입니다. 도구 체인을 작성할 때 다이어그램에서 도구 체인의 일부인 각 도구 통합을 보여줍니다. -![도구 체인 다이어그램](images/toolchain_diagram.png) - -1. 도구 체인 설정의 기본 정보를 검토하십시오. 도구 체인의 이름을 통해 {{site.data.keyword.Bluemix_notm}}에서 도구 체인을 식별합니다. 해당 이름의 도구 체인이 이미 있거나 다른 이름을 사용하려는 경우 도구 체인의 이름을 변경하십시오. -1. 구성 가능한 통합 섹션에서 도구 체인에 대해 구성하려는 각 도구 통합을 선택하십시오. 일부 도구 통합의 경우 구성할 필요가 없습니다. 도구 통합 구성에 대한 정보는 [도구 통합 구성(링크가 새 창에서 열림)](../toolchains/toolchains_integrations.html){: new_window}을 참조하십시오. -1. **작성**을 클릭하십시오. 도구 체인을 설정하기 위해 다음과 같은 여러 단계가 자동으로 실행됩니다. - - * 도구 체인이 작성됩니다. - * Delivery Pipeline 도구 통합을 구성한 경우 파이프라인이 트리거됩니다. - * Sauce Labs 도구 통합을 구성한 경우 파이프라인에 작업을 추가하고 테스트를 실행하도록 Sauce Labs 통합이 구성됩니다. - * PagerDuty 도구 통합을 구성한 경우 Slack에서 구성한 채널에 알림을 보내도록 PagerDuty 통합이 구성됩니다. 이러한 알림은 문제가 발생한 시기를 나타냅니다. - * Slack 도구 통합을 구성한 경우 Slack에서 구성한 채널에 알림을 보내도록 Slack 통합이 구성됩니다. 이러한 알림은 배치의 진행상태를 표시합니다(예: `프로젝트 XYZ와 연결됨`, `파이프라인이 구성됨` 및 `'빌드' 단계가 시작됨`). - * GitHub 도구 통합을 구성한 경우 샘플 GitHub 저장소가 GitHub 계정에 복제됩니다. - - -###앱에서 도구 체인 작성 -{: #creating_a_toolchain_from_an_app} - -앱에서 도구 체인을 작성할 수 있습니다. 도구 체인은 연속 개발, 배치, 모니터링 등을 지원할 수 있으며 앱과 연관되어 있습니다. 각 앱은 도구 체인과 연관될 수 있습니다. 도구 체인의 GitHub 저장소에 변경사항을 푸시하면 파이프라인에서 앱을 자동으로 빌드하여 배치합니다. - -1. 첫 번째 도구 체인을 작성하는 경우 조직에서 도구 체인이 사용되는지 확인하십시오. - 1. DevOps 대시보드를 열고 **도구 체인** 페이지를 클릭하십시오. - 2. **도구 체인 사용** 단추가 표시되면 클릭한 다음 프롬프트를 따라 도구 체인을 작성하십시오. - 3. **도구 체인 사용** 단추가 표시되지 않으면 도구 체인이 이미 사용되는 것입니다. 2단계를 진행하십시오. -1. 앱 개요 페이지의 Continuous Delivery 타일에서 **사용**을 클릭하십시오. 또는 {{site.data.keyword.Bluemix_notm}} 기존 인터페이스에서 앱의 개요 페이지 오른쪽 상단에 있는 **도구 체인 추가**를 클릭하십시오. 앱 스타터 코드로 채워진 새 GitHub 저장소의 Continuous Delivery에 맞게 앱이 구성됩니다. -1. 도구 체인 작성 페이지에서 작성할 도구 체인의 다이어그램을 검토하십시오. 다이어그램에서는 도구 체인의 라이프사이클 단계(Phase)에 있는 각 도구 통합을 보여줍니다. -1. 도구 체인 설정의 기본 정보를 검토하십시오. 도구 체인의 이름을 통해 {{site.data.keyword.Bluemix_notm}}에서 도구 체인을 식별합니다. 해당 이름의 도구 체인이 이미 있거나 다른 이름을 사용하려는 경우 도구 체인의 이름을 변경하십시오. -1. 구성 가능한 통합 섹션에서 도구 체인에 대해 구성하려는 각 도구 통합을 선택하십시오. 일부 도구 통합의 경우 구성할 필요가 없습니다. 도구 통합 구성에 대한 정보는 [도구 통합 구성(링크가 새 창에서 열림)](../toolchains/toolchains_integrations.html){: new_window}을 참조하십시오. -1. **작성**을 클릭하십시오. 도구 체인을 설정하기 위해 다음과 같은 여러 단계가 자동으로 실행됩니다. - - * 도구 체인이 작성됩니다. - * Delivery Pipeline 도구 통합을 구성한 경우 파이프라인이 트리거됩니다. - * Sauce Labs 도구 통합을 구성한 경우 파이프라인에 작업을 추가하고 테스트를 실행하도록 Sauce Labs 통합이 구성됩니다. - * PagerDuty 도구 통합을 구성한 경우 Slack에서 구성한 채널에 알림을 보내도록 PagerDuty 통합이 구성됩니다. 이러한 알림은 문제가 발생한 시기를 나타냅니다. - * Slack 도구 통합을 구성한 경우 Slack에서 구성한 채널에 알림을 보내도록 Slack 통합이 구성됩니다. 이러한 알림은 배치의 진행상태를 표시합니다(예: `프로젝트 XYZ와 연결됨`, `파이프라인이 구성됨` 및 `'빌드' 단계가 시작됨`). - * GitHub 도구 통합을 구성한 경우 샘플 GitHub 저장소가 GitHub 계정에 복제됩니다. - - -##도구 체인 시작하기: 데디케이티드 -{: #getting_started_dedicated} - -각 도구 체인은 특정 조직과 연관되며 해당 조직의 구성원인 사용자가 연관된 도구 체인에 액세스할 수 있습니다. 도구 체인을 작성하기 전에 메뉴 표시줄에서 **{{site.data.keyword.avatar}}** 아이콘 ![아바타 아이콘](../icons/i-avatar-icon.svg)을 클릭하여 계정 및 지원 위젯을 열고 작업 중인 조직을 확인하십시오. 해당 조직이 도구 체인을 작성하려는 조직이 아니면 다른 조직으로 전환하십시오. - -###템플리트에서 도구 체인 작성 -{: #creating_a_toolchain_from_a_template_dedicated} - -템플리트를 시작점으로 사용하여 특정 도구 통합 세트가 포함된 도구 체인을 작성할 수 있습니다. - -1. 첫 번째 도구 체인을 작성하는 경우 조직에서 도구 체인이 사용되는지 확인하십시오. - 1. DevOps 대시보드를 열고 **도구 체인** 탭을 클릭하십시오. - 2. **도구 체인 사용** 단추가 표시되면 클릭한 다음 프롬프트를 따라 도구 체인을 작성하십시오. - 3. **도구 체인 사용** 단추가 표시되지 않으면 도구 체인이 이미 사용되는 것입니다. 2단계를 진행하십시오. -1. {{site.data.keyword.Bluemix_notm}} 대시보드의 **DEVOPS** 탭에서 추가 단추(+)를 클릭하여 도구 체인을 작성하십시오. -1. 도구 체인 템플리트를 클릭하십시오. 예를 들어 새 Cloud Foundry 앱을 배치하기 위해 단순 도구 체인을 작성하려면 **단순 Cloud Foundry 도구 체인**을 클릭하십시오. -1. 도구 체인 작성 페이지에서 작성할 도구 체인의 다이어그램을 검토하십시오. 다이어그램에서는 도구 체인의 라이프사이클 단계(Phase)에 있는 각 도구 통합을 보여줍니다. 다음 이미지의 다이어그램은 예입니다. 도구 체인을 작성할 때 다이어그램에서 도구 체인의 일부인 각 도구 통합을 보여줍니다. -![데디케이티드 도구 체인 다이어그램](images/toolchain_dedicated_diagram.png) - -1. 도구 체인 설정의 기본 정보를 검토하십시오. 도구 체인의 이름을 통해 {{site.data.keyword.Bluemix_notm}}에서 도구 체인을 식별합니다. 해당 이름의 도구 체인이 이미 있거나 다른 이름을 사용하려는 경우 도구 체인의 이름을 변경하십시오. -1. 구성 가능한 통합 섹션에서 도구 체인에 대해 구성하려는 각 도구 통합을 선택하십시오. 일부 도구 통합의 경우 구성할 필요가 없습니다. 도구 통합 구성에 대한 정보는 [도구 통합 구성(링크가 새 창에서 열림)](../toolchains/toolchains_integrations.html){: new_window}을 참조하십시오. -1. **작성**을 클릭하십시오. 도구 체인을 설정하기 위해 다음과 같은 여러 단계가 자동으로 실행됩니다. - - * 도구 체인이 작성됩니다. - * Delivery Pipeline 도구 통합을 구성한 경우 파이프라인이 트리거됩니다. - * GitHub Enterprise 도구 통합을 구성한 경우 샘플 GitHub Enterprise 저장소가 GitHub Enterprise 계정에 복제됩니다. - - -###앱에서 도구 체인 작성 -{: #creating_a_toolchain_from_an_app_dedicated} - -앱에서 도구 체인을 작성할 수 있습니다. 도구 체인은 연속 개발, 배치, 모니터링 등을 지원할 수 있으며 앱과 연관되어 있습니다. 각 앱은 도구 체인과 연관될 수 있습니다. 도구 체인의 GitHub Enterprise 저장소에 변경사항을 푸시하면 파이프라인에서 앱을 자동으로 빌드하여 배치합니다. - -1. 첫 번째 도구 체인을 작성하는 경우 조직에서 도구 체인이 사용되는지 확인하십시오. - 1. DevOps 대시보드를 열고 **도구 체인** 탭을 클릭하십시오. - 2. **도구 체인 사용** 단추가 표시되면 클릭한 다음 프롬프트를 따라 도구 체인을 작성하십시오. - 3. **도구 체인 사용** 단추가 표시되지 않으면 도구 체인이 이미 사용되는 것입니다. 2단계를 진행하십시오. -1. 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 추가**를 클릭하십시오. 앱 스타터 코드로 채워진 새 GitHub Enterprise 저장소의 Continuous Delivery에 맞게 앱이 구성됩니다. -1. 도구 체인 작성 페이지에서 작성할 도구 체인의 다이어그램을 검토하십시오. 다이어그램에서는 도구 체인의 라이프사이클 단계(Phase)에 있는 각 도구 통합을 보여줍니다. -1. 도구 체인 설정의 기본 정보를 검토하십시오. 도구 체인의 이름을 통해 {{site.data.keyword.Bluemix_notm}}에서 도구 체인을 식별합니다. 해당 이름의 도구 체인이 이미 있거나 다른 이름을 사용하려는 경우 도구 체인의 이름을 변경하십시오. -1. 구성 가능한 통합 섹션에서 도구 체인에 대해 구성하려는 각 도구 통합을 선택하십시오. 일부 도구 통합의 경우 구성할 필요가 없습니다. 도구 통합 구성에 대한 정보는 [도구 통합 구성(링크가 새 창에서 열림)](../toolchains/toolchains_integrations.html){: new_window}을 참조하십시오. -1. **작성**을 클릭하십시오. 도구 체인을 설정하기 위해 다음과 같은 여러 단계가 자동으로 실행됩니다. - - * 도구 체인이 작성됩니다. - * Delivery Pipeline 도구 통합을 구성한 경우 파이프라인이 트리거됩니다. - * GitHub Enterprise 도구 통합을 구성한 경우 샘플 GitHub Enterprise 저장소가 GitHub Enterprise 계정에 복제됩니다. - - -##도구 체인 보기 -{: #viewing_a_toolchain} - -도구 체인과 해당 도구 통합을 구성하고 나면 도구 통합 페이지에서 도구 체인의 시각적 표시를 볼 수 있습니다. - -* {{site.data.keyword.Bluemix_notm}} 퍼블릭을 사용하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. - -* {{site.data.keyword.Bluemix_notm}} 데디케이티드를 사용하는 경우 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오. - -* 도구 체인에 있는 도구 통합에 액세스하려면 도구 타일을 클릭하십시오. - - **팁**: GitHub 또는 GitHub Enterprise 저장소가 두 개 이상이면 각 저장소는 고유 타일로 표시되므로 동일한 도구 통합에 여러 타일이 있을 수 있습니다. - - - - - -# 관련 링크 -{: #rellinks} - -## 튜토리얼 및 샘플 -{: #samples} - -* [세 개의 마이크로 서비스가 포함된 애플리케이션(베타) 작성(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} -* [Create a toolchain from a template on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta)(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} -* [Create a toolchain from an app on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta)(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} - -## 관련 링크 -{: #general} - -* [마이크로 서비스 도구 체인(베타)(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} -* [단순 도구 체인(베타)(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} -* [IBM Bluemix Garage Method(링크가 새 창에서 열림)](https://www.ibm.com/devops/method){:new_window} +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# 도구 체인 시작하기(베타) +{: #toolchains_getting_started} + +마지막 업데이트 날짜: 2016년 10월 7일 +{: .last-updated} + +도구 체인은 {{site.data.keyword.Bluemix}}의 퍼블릭 및 데디케이티드 환경에서 사용할 수 있습니다. 템플리트를 사용하여 도구 체인을 작성하거나 앱에서 도구 체인을 작성하는 식의 두 방식으로 도구 체인을 작성할 수 있습니다. {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 도구 체인은 미국 남부 지역에서만 사용할 수 있습니다. +{: shortdesc} + +##도구 체인 시작하기: 퍼블릭 +{: #getting_started_public} + +**참고:** 맨 위 배너를 확인하여 새 Bluemix 인터페이스에서 작업 중인지 확인하십시오. + + * 새 Bluemix에 대한 메시지가 표시되면 기존 Bluemix 인터페이스에서 작업하고 있는 것입니다. 링크를 클릭하여 새 Bluemix 인터페이스를 여십시오. + * 메시지가 표시되지 않으면 새 Bluemix 인터페이스에서 작업하고 있는 것입니다. + +각 도구 체인은 특정 조직과 연관되며 해당 조직의 구성원인 사용자가 연관된 도구 체인에 액세스할 수 있습니다. 도구 체인을 작성하기 전에 도구 체인을 작성할 조직에서 작업 중인지 확인하십시오. 현재 작업 중인 조직이 메뉴 표시줄에 표시됩니다. 다른 조직으로 전환하려면 메뉴 표시줄에서 조직을 클릭한 다음 전환할 조직을 선택하십시오. + +###템플리트에서 도구 체인 작성 +{: #creating_a_toolchain_from_a_template} + +템플리트를 시작점으로 사용하여 특정 도구 통합 세트가 포함된 도구 체인을 작성할 수 있습니다. + +1. 첫 번째 도구 체인을 작성하는 경우 조직에서 도구 체인이 사용되는지 확인하십시오. + 1. DevOps 대시보드를 열고 **도구 체인** 페이지를 클릭하십시오. + 2. **도구 체인 사용** 단추가 표시되면 클릭한 다음 프롬프트를 따라 도구 체인을 작성하십시오. + 3. **도구 체인 사용** 단추가 표시되지 않으면 도구 체인이 이미 사용되는 것입니다. 2단계를 진행하십시오. +1. DevOps 대시보드의 **도구 체인** 페이지에서 추가 단추(+)를 클릭하여 도구 체인을 작성하십시오. +1. 도구 체인 템플리트를 클릭하십시오. 예를 들어, 온라인 상점 샘플을 사용하여 도구 체인을 작성하려면 **마이크로 서비스 도구 체인**을 클릭하십시오. +1. 도구 체인 작성 페이지에서 작성할 도구 체인의 다이어그램을 검토하십시오. 다이어그램에서는 도구 체인의 라이프사이클 단계(Phase)에 있는 각 도구 통합을 보여줍니다. 다음 이미지의 다이어그램은 예입니다. 도구 체인을 작성할 때 다이어그램에서 도구 체인의 일부인 각 도구 통합을 보여줍니다. +![도구 체인 다이어그램](images/toolchain_diagram.png) + +1. 도구 체인 설정의 기본 정보를 검토하십시오. 도구 체인의 이름을 통해 {{site.data.keyword.Bluemix_notm}}에서 도구 체인을 식별합니다. 해당 이름의 도구 체인이 이미 있거나 다른 이름을 사용하려는 경우 도구 체인의 이름을 변경하십시오. +1. 구성 가능한 통합 섹션에서 도구 체인에 대해 구성하려는 각 도구 통합을 선택하십시오. 일부 도구 통합의 경우 구성할 필요가 없습니다. 도구 통합 구성에 대한 정보는 [도구 통합 구성(링크가 새 창에서 열림)](../toolchains/toolchains_integrations.html){: new_window}을 참조하십시오. +1. **작성**을 클릭하십시오. 도구 체인을 설정하기 위해 다음과 같은 여러 단계가 자동으로 실행됩니다. + + * 도구 체인이 작성됩니다. + * Delivery Pipeline 도구 통합을 구성한 경우 파이프라인이 트리거됩니다. + * Sauce Labs 도구 통합을 구성한 경우 파이프라인에 작업을 추가하고 테스트를 실행하도록 Sauce Labs 통합이 구성됩니다. + * PagerDuty 도구 통합을 구성한 경우 Slack에서 구성한 채널에 알림을 보내도록 PagerDuty 통합이 구성됩니다. 이러한 알림은 문제가 발생한 시기를 나타냅니다. + * Slack 도구 통합을 구성한 경우 Slack에서 구성한 채널에 알림을 보내도록 Slack 통합이 구성됩니다. 이러한 알림은 배치의 진행상태를 표시합니다(예: `프로젝트 XYZ와 연결됨`, `파이프라인이 구성됨` 및 `'빌드' 단계가 시작됨`). + * GitHub 도구 통합을 구성한 경우 샘플 GitHub 저장소가 GitHub 계정에 복제됩니다. + + +###앱에서 도구 체인 작성 +{: #creating_a_toolchain_from_an_app} + +앱에서 도구 체인을 작성할 수 있습니다. 도구 체인은 연속 개발, 배치, 모니터링 등을 지원할 수 있으며 앱과 연관되어 있습니다. 각 앱은 도구 체인과 연관될 수 있습니다. 도구 체인의 GitHub 저장소에 변경사항을 푸시하면 파이프라인에서 앱을 자동으로 빌드하여 배치합니다. + +1. 첫 번째 도구 체인을 작성하는 경우 조직에서 도구 체인이 사용되는지 확인하십시오. + 1. DevOps 대시보드를 열고 **도구 체인** 페이지를 클릭하십시오. + 2. **도구 체인 사용** 단추가 표시되면 클릭한 다음 프롬프트를 따라 도구 체인을 작성하십시오. + 3. **도구 체인 사용** 단추가 표시되지 않으면 도구 체인이 이미 사용되는 것입니다. 2단계를 진행하십시오. +1. 앱 개요 페이지의 Continuous Delivery 타일에서 **사용**을 클릭하십시오. 또는 {{site.data.keyword.Bluemix_notm}} 기존 인터페이스에서 앱의 개요 페이지 오른쪽 상단에 있는 **도구 체인 추가**를 클릭하십시오. 앱 스타터 코드로 채워진 새 GitHub 저장소의 Continuous Delivery에 맞게 앱이 구성됩니다. +1. 도구 체인 작성 페이지에서 작성할 도구 체인의 다이어그램을 검토하십시오. 다이어그램에서는 도구 체인의 라이프사이클 단계(Phase)에 있는 각 도구 통합을 보여줍니다. +1. 도구 체인 설정의 기본 정보를 검토하십시오. 도구 체인의 이름을 통해 {{site.data.keyword.Bluemix_notm}}에서 도구 체인을 식별합니다. 해당 이름의 도구 체인이 이미 있거나 다른 이름을 사용하려는 경우 도구 체인의 이름을 변경하십시오. +1. 구성 가능한 통합 섹션에서 도구 체인에 대해 구성하려는 각 도구 통합을 선택하십시오. 일부 도구 통합의 경우 구성할 필요가 없습니다. 도구 통합 구성에 대한 정보는 [도구 통합 구성(링크가 새 창에서 열림)](../toolchains/toolchains_integrations.html){: new_window}을 참조하십시오. +1. **작성**을 클릭하십시오. 도구 체인을 설정하기 위해 다음과 같은 여러 단계가 자동으로 실행됩니다. + + * 도구 체인이 작성됩니다. + * Delivery Pipeline 도구 통합을 구성한 경우 파이프라인이 트리거됩니다. + * Sauce Labs 도구 통합을 구성한 경우 파이프라인에 작업을 추가하고 테스트를 실행하도록 Sauce Labs 통합이 구성됩니다. + * PagerDuty 도구 통합을 구성한 경우 Slack에서 구성한 채널에 알림을 보내도록 PagerDuty 통합이 구성됩니다. 이러한 알림은 문제가 발생한 시기를 나타냅니다. + * Slack 도구 통합을 구성한 경우 Slack에서 구성한 채널에 알림을 보내도록 Slack 통합이 구성됩니다. 이러한 알림은 배치의 진행상태를 표시합니다(예: `프로젝트 XYZ와 연결됨`, `파이프라인이 구성됨` 및 `'빌드' 단계가 시작됨`). + * GitHub 도구 통합을 구성한 경우 샘플 GitHub 저장소가 GitHub 계정에 복제됩니다. + + +##도구 체인 시작하기: 데디케이티드 +{: #getting_started_dedicated} + +각 도구 체인은 특정 조직과 연관되며 해당 조직의 구성원인 사용자가 연관된 도구 체인에 액세스할 수 있습니다. 도구 체인을 작성하기 전에 메뉴 표시줄에서 **{{site.data.keyword.avatar}}** 아이콘 ![아바타 아이콘](../icons/i-avatar-icon.svg)을 클릭하여 계정 및 지원 위젯을 열고 작업 중인 조직을 확인하십시오. 해당 조직이 도구 체인을 작성하려는 조직이 아니면 다른 조직으로 전환하십시오. + +###템플리트에서 도구 체인 작성 +{: #creating_a_toolchain_from_a_template_dedicated} + +템플리트를 시작점으로 사용하여 특정 도구 통합 세트가 포함된 도구 체인을 작성할 수 있습니다. + +1. 첫 번째 도구 체인을 작성하는 경우 조직에서 도구 체인이 사용되는지 확인하십시오. + 1. DevOps 대시보드를 열고 **도구 체인** 탭을 클릭하십시오. + 2. **도구 체인 사용** 단추가 표시되면 클릭한 다음 프롬프트를 따라 도구 체인을 작성하십시오. + 3. **도구 체인 사용** 단추가 표시되지 않으면 도구 체인이 이미 사용되는 것입니다. 2단계를 진행하십시오. +1. {{site.data.keyword.Bluemix_notm}} 대시보드의 **DEVOPS** 탭에서 추가 단추(+)를 클릭하여 도구 체인을 작성하십시오. +1. 도구 체인 템플리트를 클릭하십시오. 예를 들어 새 Cloud Foundry 앱을 배치하기 위해 단순 도구 체인을 작성하려면 **단순 Cloud Foundry 도구 체인**을 클릭하십시오. +1. 도구 체인 작성 페이지에서 작성할 도구 체인의 다이어그램을 검토하십시오. 다이어그램에서는 도구 체인의 라이프사이클 단계(Phase)에 있는 각 도구 통합을 보여줍니다. 다음 이미지의 다이어그램은 예입니다. 도구 체인을 작성할 때 다이어그램에서 도구 체인의 일부인 각 도구 통합을 보여줍니다. +![데디케이티드 도구 체인 다이어그램](images/toolchain_dedicated_diagram.png) + +1. 도구 체인 설정의 기본 정보를 검토하십시오. 도구 체인의 이름을 통해 {{site.data.keyword.Bluemix_notm}}에서 도구 체인을 식별합니다. 해당 이름의 도구 체인이 이미 있거나 다른 이름을 사용하려는 경우 도구 체인의 이름을 변경하십시오. +1. 구성 가능한 통합 섹션에서 도구 체인에 대해 구성하려는 각 도구 통합을 선택하십시오. 일부 도구 통합의 경우 구성할 필요가 없습니다. 도구 통합 구성에 대한 정보는 [도구 통합 구성(링크가 새 창에서 열림)](../toolchains/toolchains_integrations.html){: new_window}을 참조하십시오. +1. **작성**을 클릭하십시오. 도구 체인을 설정하기 위해 다음과 같은 여러 단계가 자동으로 실행됩니다. + + * 도구 체인이 작성됩니다. + * Delivery Pipeline 도구 통합을 구성한 경우 파이프라인이 트리거됩니다. + * GitHub Enterprise 도구 통합을 구성한 경우 샘플 GitHub Enterprise 저장소가 GitHub Enterprise 계정에 복제됩니다. + + +###앱에서 도구 체인 작성 +{: #creating_a_toolchain_from_an_app_dedicated} + +앱에서 도구 체인을 작성할 수 있습니다. 도구 체인은 연속 개발, 배치, 모니터링 등을 지원할 수 있으며 앱과 연관되어 있습니다. 각 앱은 도구 체인과 연관될 수 있습니다. 도구 체인의 GitHub Enterprise 저장소에 변경사항을 푸시하면 파이프라인에서 앱을 자동으로 빌드하여 배치합니다. + +1. 첫 번째 도구 체인을 작성하는 경우 조직에서 도구 체인이 사용되는지 확인하십시오. + 1. DevOps 대시보드를 열고 **도구 체인** 탭을 클릭하십시오. + 2. **도구 체인 사용** 단추가 표시되면 클릭한 다음 프롬프트를 따라 도구 체인을 작성하십시오. + 3. **도구 체인 사용** 단추가 표시되지 않으면 도구 체인이 이미 사용되는 것입니다. 2단계를 진행하십시오. +1. 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 추가**를 클릭하십시오. 앱 스타터 코드로 채워진 새 GitHub Enterprise 저장소의 Continuous Delivery에 맞게 앱이 구성됩니다. +1. 도구 체인 작성 페이지에서 작성할 도구 체인의 다이어그램을 검토하십시오. 다이어그램에서는 도구 체인의 라이프사이클 단계(Phase)에 있는 각 도구 통합을 보여줍니다. +1. 도구 체인 설정의 기본 정보를 검토하십시오. 도구 체인의 이름을 통해 {{site.data.keyword.Bluemix_notm}}에서 도구 체인을 식별합니다. 해당 이름의 도구 체인이 이미 있거나 다른 이름을 사용하려는 경우 도구 체인의 이름을 변경하십시오. +1. 구성 가능한 통합 섹션에서 도구 체인에 대해 구성하려는 각 도구 통합을 선택하십시오. 일부 도구 통합의 경우 구성할 필요가 없습니다. 도구 통합 구성에 대한 정보는 [도구 통합 구성(링크가 새 창에서 열림)](../toolchains/toolchains_integrations.html){: new_window}을 참조하십시오. +1. **작성**을 클릭하십시오. 도구 체인을 설정하기 위해 다음과 같은 여러 단계가 자동으로 실행됩니다. + + * 도구 체인이 작성됩니다. + * Delivery Pipeline 도구 통합을 구성한 경우 파이프라인이 트리거됩니다. + * GitHub Enterprise 도구 통합을 구성한 경우 샘플 GitHub Enterprise 저장소가 GitHub Enterprise 계정에 복제됩니다. + + +##도구 체인 보기 +{: #viewing_a_toolchain} + +도구 체인과 해당 도구 통합을 구성하고 나면 도구 통합 페이지에서 도구 체인의 시각적 표시를 볼 수 있습니다. + +* {{site.data.keyword.Bluemix_notm}} 퍼블릭을 사용하는 경우 DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭하십시오. 그런 다음 **도구 통합**을 클릭하십시오. + +* {{site.data.keyword.Bluemix_notm}} 데디케이티드를 사용하는 경우 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오. + +* 도구 체인에 있는 도구 통합에 액세스하려면 도구 타일을 클릭하십시오. + + **팁**: GitHub 또는 GitHub Enterprise 저장소가 두 개 이상이면 각 저장소는 고유 타일로 표시되므로 동일한 도구 통합에 여러 타일이 있을 수 있습니다. + + + + + +# 관련 링크 +{: #rellinks} + +## 튜토리얼 및 샘플 +{: #samples} + +* [세 개의 마이크로 서비스가 포함된 애플리케이션(베타) 작성(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} +* [Create a toolchain from a template on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta)(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} +* [Create a toolchain from an app on {{site.data.keyword.Bluemix_notm}} Dedicated (Beta)(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} + +## 관련 링크 +{: #general} + +* [마이크로 서비스 도구 체인(베타)(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} +* [단순 도구 체인(베타)(링크가 새 창에서 열림)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} +* [IBM Bluemix Garage Method(링크가 새 창에서 열림)](https://www.ibm.com/devops/method){:new_window} diff --git a/toolchains/nl/ko/toolchains_using.md b/toolchains/nl/ko/toolchains_using.md index f07473d37..646aa853c 100644 --- a/toolchains/nl/ko/toolchains_using.md +++ b/toolchains/nl/ko/toolchains_using.md @@ -1,98 +1,98 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 도구 체인 사용 -{: #toolchains-using} - -마지막 업데이트 날짜: 2016년 10월 7일 -{: .last-updated} - -매일의 개발, 배치 및 운영 작업이 생산적이도록 도구 체인을 사용할 수 있습니다. 도구 체인을 설정하고 나면 도구 통합을 추가, 삭제 또는 구성하고 도구 체인에 대한 액세스를 관리할 수 있습니다. -도구 체인은 미국 남부 지역에서만 사용할 수 있습니다. -{: shortdesc} - -**참고**: 맨 위 배너를 확인하여 새 Bluemix 인터페이스에서 작업 중인지 확인하십시오. - - * 새 Bluemix에 대한 메시지가 표시되면 기존 Bluemix 인터페이스에서 작업하고 있는 것입니다. 링크를 클릭하여 새 Bluemix 인터페이스를 여십시오. - * 메시지가 표시되지 않으면 새 Bluemix 인터페이스에서 작업하고 있는 것입니다. - -## 도구 통합 구성 -{: #configuring_a_tool_integration} - -도구 체인을 작성할 때 도구 통합의 구성을 연기한 경우 **구성** 단추가 해당 타일에 표시됩니다. 도구 체인을 작성할 때 도구 통합을 구성한 경우 구성 설정을 업데이트할 수 있습니다. - -1. DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭한 다음 **도구 통합**을 클릭하십시오. -1. 도구 통합을 처음으로 구성해야 하는 경우 해당 타일에서 **구성**을 클릭하십시오. - - ![구성 단추](images/toolchain_tile_configure.png) - - 도구 통합 구성을 완료하면 **통합 저장**을 클릭하십시오. - -1. 도구 통합 구성을 업데이트해야 하는 경우 해당 타일에서 메뉴를 클릭하여 구성 옵션에 액세스하십시오. - - ![구성 메뉴](images/toolchain_tile_menu.png) - - 설정 업데이트를 완료하고 나면 **통합 저장**을 클릭하십시오. - -## 도구 통합 추가 -{: #adding_a_tool_integration} - -도구 체인의 도구 통합을 추가하고 구성할 수 있습니다. - -1. DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭한 다음 **도구 통합**을 클릭하십시오. -1. 추가할 도구 통합 목록을 보려면 추가 단추(+)를 클릭하십시오. -1. 추가할 도구 통합을 클릭하십시오. -1. 도구 통합을 구성하는 데 필요한 정보를 입력하십시오. -1. **통합 작성**을 클릭하여 도구 체인에 도구 통합을 추가하십시오. - -## 도구 통합 삭제 -{: #deleting_a_tool_integration} - -도구 체인에서 도구 통합을 삭제하는 경우 삭제를 실행 취소할 수 없습니다. - -1. DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭한 다음 **도구 통합**을 클릭하십시오. -1. 삭제할 도구 통합의 타일에서 메뉴를 클릭하여 구성 옵션에 액세스하십시오. -1. 도구 체인에서 도구 통합을 삭제하려면 **삭제**를 클릭하십시오. -1. **삭제**를 클릭하여 확인하십시오. - -## 액세스 관리 -{: #managing_access} - -도구 체인이 연관된 조직(org)에 추가하여 사용자에게 도구 체인에 대한 액세스 권한을 부여할 수 있습니다. 각 도구 체인은 특정 조직과 연관되며 해당 조직의 구성원인 사용자가 연관된 도구 체인에 액세스할 수 있습니다. 현재 작업 중인 조직이 메뉴 표시줄에 표시됩니다. 조직을 클릭한 다음 다른 조직으로 전환하여 다른 도구 체인 세트에 액세스하십시오. - - - - - -1. DevOps 대시보드의 **도구 체인** 페이지에서 관리할 도구 체인을 클릭한 다음 **관리**를 클릭하십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭한 다음 **관리**를 클릭하십시오. -1. 조직에 대한 링크를 클릭하십시오. -1. 조직 관리 페이지에서 **사용자 초대**를 클릭하고 사용자 이메일 주소를 입력하십시오. -1. {{site.data.keyword.Bluemix_notm}} 조직의 사용자를 관리할 고급 권한을 제공하려면 하나 이상의 **관리자**, **비용 청구 관리자** 또는 **감사자** 선택란을 선택하십시오. -1. **초대**를 클릭하십시오. -1. **저장**을 클릭하십시오. - -## 도구 체인 삭제 -{: #deleting_a_toolchain} - -도구 체인을 삭제하고 삭제할 연관된 도구 통합을 지정할 수 있습니다.도구 체인을 삭제하면 삭제를 실행 취소할 수 없습니다. - -1. DevOps 대시보드의 **도구 체인** 페이지에서 삭제할 도구 체인을 클릭한 다음 **관리**를 클릭하십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭한 다음 **관리**를 클릭하십시오. -1. **도구 체인 삭제**를 클릭하고 삭제할 도구 통합을 검토하거나 조정하십시오. -1. 도구 체인의 이름을 입력하고 **삭제**를 클릭하여 삭제를 확인하십시오. - - **팁**: GitHub 도구 통합을 삭제해도 연관된 GitHub 저장소는 GitHub에서 삭제되지 않습니다. GitHub에서 수동으로 저장소를 제거해야 합니다. +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# {{site.data.keyword.Bluemix_notm}} 퍼블릭에서 도구 체인 사용 +{: #toolchains-using} + +마지막 업데이트 날짜: 2016년 10월 7일 +{: .last-updated} + +매일의 개발, 배치 및 운영 작업이 생산적이도록 도구 체인을 사용할 수 있습니다. 도구 체인을 설정하고 나면 도구 통합을 추가, 삭제 또는 구성하고 도구 체인에 대한 액세스를 관리할 수 있습니다. +도구 체인은 미국 남부 지역에서만 사용할 수 있습니다. +{: shortdesc} + +**참고**: 맨 위 배너를 확인하여 새 Bluemix 인터페이스에서 작업 중인지 확인하십시오. + + * 새 Bluemix에 대한 메시지가 표시되면 기존 Bluemix 인터페이스에서 작업하고 있는 것입니다. 링크를 클릭하여 새 Bluemix 인터페이스를 여십시오. + * 메시지가 표시되지 않으면 새 Bluemix 인터페이스에서 작업하고 있는 것입니다. + +## 도구 통합 구성 +{: #configuring_a_tool_integration} + +도구 체인을 작성할 때 도구 통합의 구성을 연기한 경우 **구성** 단추가 해당 타일에 표시됩니다. 도구 체인을 작성할 때 도구 통합을 구성한 경우 구성 설정을 업데이트할 수 있습니다. + +1. DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭한 다음 **도구 통합**을 클릭하십시오. +1. 도구 통합을 처음으로 구성해야 하는 경우 해당 타일에서 **구성**을 클릭하십시오. + + ![구성 단추](images/toolchain_tile_configure.png) + + 도구 통합 구성을 완료하면 **통합 저장**을 클릭하십시오. + +1. 도구 통합 구성을 업데이트해야 하는 경우 해당 타일에서 메뉴를 클릭하여 구성 옵션에 액세스하십시오. + + ![구성 메뉴](images/toolchain_tile_menu.png) + + 설정 업데이트를 완료하고 나면 **통합 저장**을 클릭하십시오. + +## 도구 통합 추가 +{: #adding_a_tool_integration} + +도구 체인의 도구 통합을 추가하고 구성할 수 있습니다. + +1. DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭한 다음 **도구 통합**을 클릭하십시오. +1. 추가할 도구 통합 목록을 보려면 추가 단추(+)를 클릭하십시오. +1. 추가할 도구 통합을 클릭하십시오. +1. 도구 통합을 구성하는 데 필요한 정보를 입력하십시오. +1. **통합 작성**을 클릭하여 도구 체인에 도구 통합을 추가하십시오. + +## 도구 통합 삭제 +{: #deleting_a_tool_integration} + +도구 체인에서 도구 통합을 삭제하는 경우 삭제를 실행 취소할 수 없습니다. + +1. DevOps 대시보드의 **도구 체인** 페이지에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭한 다음 **도구 통합**을 클릭하십시오. +1. 삭제할 도구 통합의 타일에서 메뉴를 클릭하여 구성 옵션에 액세스하십시오. +1. 도구 체인에서 도구 통합을 삭제하려면 **삭제**를 클릭하십시오. +1. **삭제**를 클릭하여 확인하십시오. + +## 액세스 관리 +{: #managing_access} + +도구 체인이 연관된 조직(org)에 추가하여 사용자에게 도구 체인에 대한 액세스 권한을 부여할 수 있습니다. 각 도구 체인은 특정 조직과 연관되며 해당 조직의 구성원인 사용자가 연관된 도구 체인에 액세스할 수 있습니다. 현재 작업 중인 조직이 메뉴 표시줄에 표시됩니다. 조직을 클릭한 다음 다른 조직으로 전환하여 다른 도구 체인 세트에 액세스하십시오. + + + + + +1. DevOps 대시보드의 **도구 체인** 페이지에서 관리할 도구 체인을 클릭한 다음 **관리**를 클릭하십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭한 다음 **관리**를 클릭하십시오. +1. 조직에 대한 링크를 클릭하십시오. +1. 조직 관리 페이지에서 **사용자 초대**를 클릭하고 사용자 이메일 주소를 입력하십시오. +1. {{site.data.keyword.Bluemix_notm}} 조직의 사용자를 관리할 고급 권한을 제공하려면 하나 이상의 **관리자**, **비용 청구 관리자** 또는 **감사자** 선택란을 선택하십시오. +1. **초대**를 클릭하십시오. +1. **저장**을 클릭하십시오. + +## 도구 체인 삭제 +{: #deleting_a_toolchain} + +도구 체인을 삭제하고 삭제할 연관된 도구 통합을 지정할 수 있습니다.도구 체인을 삭제하면 삭제를 실행 취소할 수 없습니다. + +1. DevOps 대시보드의 **도구 체인** 페이지에서 삭제할 도구 체인을 클릭한 다음 **관리**를 클릭하십시오. 또는 앱 개요 페이지의 Continuous Delivery 타일에서 **도구 체인 보기**를 클릭한 다음 **관리**를 클릭하십시오. +1. **도구 체인 삭제**를 클릭하고 삭제할 도구 통합을 검토하거나 조정하십시오. +1. 도구 체인의 이름을 입력하고 **삭제**를 클릭하여 삭제를 확인하십시오. + + **팁**: GitHub 도구 통합을 삭제해도 연관된 GitHub 저장소는 GitHub에서 삭제되지 않습니다. GitHub에서 수동으로 저장소를 제거해야 합니다. diff --git a/toolchains/nl/ko/toolchains_using_dedicated.md b/toolchains/nl/ko/toolchains_using_dedicated.md index 9c85b33c0..d84283744 100644 --- a/toolchains/nl/ko/toolchains_using_dedicated.md +++ b/toolchains/nl/ko/toolchains_using_dedicated.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# {{site.data.keyword.Bluemix_notm}} 데디케이티드의 도구 체인 사용 -{: #toolchains-using_dedicated} - -마지막 업데이트 날짜: 2016년 9월 13일 -{: .last-updated} - -매일의 개발, 배치 및 운영 작업이 생산적이도록 도구 체인을 사용할 수 있습니다. 도구 체인을 설정하고 나면 도구 통합을 추가, 삭제 또는 구성하고 도구 체인에 대한 액세스를 관리할 수 있습니다. -{: shortdesc} - -## 도구 통합 구성 -{: #configuring_a_tool_integration_dedicated} - -도구 체인을 작성할 때 도구 통합의 구성을 연기한 경우 **구성** 단추가 해당 타일에 표시됩니다. 도구 체인을 작성할 때 도구 통합을 구성한 경우 구성 설정을 업데이트할 수 있습니다. - -1. 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오.그런 다음 **도구 통합**을 클릭하십시오. -1. 도구 통합을 처음으로 구성해야 하는 경우 해당 타일에서 **구성**을 클릭하십시오. - - ![구성 단추](images/toolchain_tile_configure.png) - - 도구 통합 구성을 완료하면 **통합 저장**을 클릭하십시오. - -1. 도구 통합 구성을 업데이트해야 하는 경우 해당 타일에서 메뉴를 클릭하여 구성 옵션에 액세스하십시오. - - ![구성 메뉴](images/toolchain_tile_menu.png) - - 설정 업데이트를 완료하고 나면 **통합 저장**을 클릭하십시오. - -## 도구 통합 추가 -{: #adding_a_tool_integration_dedicated} - -도구 체인의 도구 통합을 추가하고 구성할 수 있습니다. - -1. 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오.그런 다음 **도구 통합**을 클릭하십시오. -1. 추가할 도구 통합 목록을 보려면 추가 단추(+)를 클릭하십시오. -1. 추가할 도구 통합을 클릭하십시오. -1. 도구 통합을 구성하는 데 필요한 정보를 입력하십시오. -1. **통합 작성**을 클릭하여 도구 체인에 도구 통합을 추가하십시오. - -## 도구 통합 삭제 -{: #deleting_a_tool_integration} - -도구 체인에서 도구 통합을 삭제하는 경우 삭제를 실행 취소할 수 없습니다. - -1. 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오.그런 다음 **도구 통합**을 클릭하십시오. -1. 삭제할 도구 통합의 타일에서 메뉴를 클릭하여 구성 옵션에 액세스하십시오. -1. 도구 체인에서 도구 통합을 삭제하려면 **삭제**를 클릭하십시오. -1. **삭제**를 클릭하여 확인하십시오. - -## 액세스 관리 -{: #managing_access_dedicated} - -도구 체인이 연관된 조직(org)에 추가하여 사용자에게 도구 체인에 대한 액세스 권한을 부여할 수 있습니다. 각 도구 체인은 특정 조직과 연관되며 해당 조직의 구성원인 사용자가 연관된 도구 체인에 액세스할 수 있습니다. 현재 작업 중인 조직을 보려면 메뉴 표시줄에서 **{{site.data.keyword.avatar}}** 아이콘 ![아바타 아이콘](../icons/i-avatar-icon.svg)을 클릭하십시오. 다른 도구 체인 세트에 액세스하려면 다른 조직으로 전환하십시오. - -{{site.data.keyword.Bluemix}} 조직 및 영역에 사용자를 추가할 때 사용자가 {{site.data.keyword.Bluemix_notm}} ID 및 비밀번호를 사용하여 GitHub Enterprise에 로그인할 수 있습니다. 사용자가 로그인하면 계정이 작성됩니다. {{site.data.keyword.Bluemix_notm}} 조직 및 영역에 사용자를 추가할 때 계정이 GitHub Enterprise 저장소에 자동으로 추가되지 않습니다. 저장소의 관리자 권한이 있는 사용자가 추가해야 합니다. 자세한 정보는 [Dedicated GitHub Enterprise 사용(링크가 새 창에서 열림)](../services/ghededicated/index.html){: new_window}을 참조하십시오. - -사용자를 추가하려면 다음 단계를 따르십시오. - -1. 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 그런 다음 **관리**를 클릭하십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오.그런 다음 **관리**를 클릭하십시오. -1. 조직에 대한 링크를 클릭하십시오. -1. 조직 관리 페이지에서 **사용자 초대**를 클릭하고 사용자 이메일 주소를 입력하십시오. -1. {{site.data.keyword.Bluemix_notm}} 조직의 사용자를 관리할 고급 권한을 제공하려면 하나 이상의 **관리자**, **비용 청구 관리자** 또는 **감사자** 선택란을 선택하십시오. -1. **초대**를 클릭하십시오. -1. **저장**을 클릭하십시오. - -## 도구 체인 삭제 -{: #deleting_a_toolchain_dedicated} - -도구 체인을 삭제하고 삭제할 연관된 도구 통합을 지정할 수 있습니다. 도구 체인을 삭제하면 삭제를 실행 취소할 수 없습니다. - -1. 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 그런 다음 **관리**를 클릭하십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오.그런 다음 **관리**를 클릭하십시오. -1. **도구 체인 삭제**를 클릭하고 삭제할 도구 통합을 검토하거나 조정하십시오. -1. 도구 체인의 이름을 입력하고 **삭제**를 클릭하여 삭제를 확인하십시오. - - **팁**: GitHub Enterprise 도구 통합을 삭제해도 연관된 GitHub Enterprise 저장소는 GitHub Enterprise에서 삭제되지 않습니다. GitHub Enterprise에서 수동으로 저장소를 제거해야 합니다. +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# {{site.data.keyword.Bluemix_notm}} 데디케이티드의 도구 체인 사용 +{: #toolchains-using_dedicated} + +마지막 업데이트 날짜: 2016년 9월 13일 +{: .last-updated} + +매일의 개발, 배치 및 운영 작업이 생산적이도록 도구 체인을 사용할 수 있습니다. 도구 체인을 설정하고 나면 도구 통합을 추가, 삭제 또는 구성하고 도구 체인에 대한 액세스를 관리할 수 있습니다. +{: shortdesc} + +## 도구 통합 구성 +{: #configuring_a_tool_integration_dedicated} + +도구 체인을 작성할 때 도구 통합의 구성을 연기한 경우 **구성** 단추가 해당 타일에 표시됩니다. 도구 체인을 작성할 때 도구 통합을 구성한 경우 구성 설정을 업데이트할 수 있습니다. + +1. 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오.그런 다음 **도구 통합**을 클릭하십시오. +1. 도구 통합을 처음으로 구성해야 하는 경우 해당 타일에서 **구성**을 클릭하십시오. + + ![구성 단추](images/toolchain_tile_configure.png) + + 도구 통합 구성을 완료하면 **통합 저장**을 클릭하십시오. + +1. 도구 통합 구성을 업데이트해야 하는 경우 해당 타일에서 메뉴를 클릭하여 구성 옵션에 액세스하십시오. + + ![구성 메뉴](images/toolchain_tile_menu.png) + + 설정 업데이트를 완료하고 나면 **통합 저장**을 클릭하십시오. + +## 도구 통합 추가 +{: #adding_a_tool_integration_dedicated} + +도구 체인의 도구 통합을 추가하고 구성할 수 있습니다. + +1. 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오.그런 다음 **도구 통합**을 클릭하십시오. +1. 추가할 도구 통합 목록을 보려면 추가 단추(+)를 클릭하십시오. +1. 추가할 도구 통합을 클릭하십시오. +1. 도구 통합을 구성하는 데 필요한 정보를 입력하십시오. +1. **통합 작성**을 클릭하여 도구 체인에 도구 통합을 추가하십시오. + +## 도구 통합 삭제 +{: #deleting_a_tool_integration} + +도구 체인에서 도구 통합을 삭제하는 경우 삭제를 실행 취소할 수 없습니다. + +1. 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오.그런 다음 **도구 통합**을 클릭하십시오. +1. 삭제할 도구 통합의 타일에서 메뉴를 클릭하여 구성 옵션에 액세스하십시오. +1. 도구 체인에서 도구 통합을 삭제하려면 **삭제**를 클릭하십시오. +1. **삭제**를 클릭하여 확인하십시오. + +## 액세스 관리 +{: #managing_access_dedicated} + +도구 체인이 연관된 조직(org)에 추가하여 사용자에게 도구 체인에 대한 액세스 권한을 부여할 수 있습니다. 각 도구 체인은 특정 조직과 연관되며 해당 조직의 구성원인 사용자가 연관된 도구 체인에 액세스할 수 있습니다. 현재 작업 중인 조직을 보려면 메뉴 표시줄에서 **{{site.data.keyword.avatar}}** 아이콘 ![아바타 아이콘](../icons/i-avatar-icon.svg)을 클릭하십시오. 다른 도구 체인 세트에 액세스하려면 다른 조직으로 전환하십시오. + +{{site.data.keyword.Bluemix}} 조직 및 영역에 사용자를 추가할 때 사용자가 {{site.data.keyword.Bluemix_notm}} ID 및 비밀번호를 사용하여 GitHub Enterprise에 로그인할 수 있습니다. 사용자가 로그인하면 계정이 작성됩니다. {{site.data.keyword.Bluemix_notm}} 조직 및 영역에 사용자를 추가할 때 계정이 GitHub Enterprise 저장소에 자동으로 추가되지 않습니다. 저장소의 관리자 권한이 있는 사용자가 추가해야 합니다. 자세한 정보는 [Dedicated GitHub Enterprise 사용(링크가 새 창에서 열림)](../services/ghededicated/index.html){: new_window}을 참조하십시오. + +사용자를 추가하려면 다음 단계를 따르십시오. + +1. 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 그런 다음 **관리**를 클릭하십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오.그런 다음 **관리**를 클릭하십시오. +1. 조직에 대한 링크를 클릭하십시오. +1. 조직 관리 페이지에서 **사용자 초대**를 클릭하고 사용자 이메일 주소를 입력하십시오. +1. {{site.data.keyword.Bluemix_notm}} 조직의 사용자를 관리할 고급 권한을 제공하려면 하나 이상의 **관리자**, **비용 청구 관리자** 또는 **감사자** 선택란을 선택하십시오. +1. **초대**를 클릭하십시오. +1. **저장**을 클릭하십시오. + +## 도구 체인 삭제 +{: #deleting_a_toolchain_dedicated} + +도구 체인을 삭제하고 삭제할 연관된 도구 통합을 지정할 수 있습니다. 도구 체인을 삭제하면 삭제를 실행 취소할 수 없습니다. + +1. 대시보드의 **DEVOPS** 탭에서 도구 체인을 클릭하여 도구 통합 페이지를 여십시오. 그런 다음 **관리**를 클릭하십시오. 또는 앱 개요 페이지의 오른쪽 상단에서 **도구 체인 보기**를 클릭하십시오.그런 다음 **관리**를 클릭하십시오. +1. **도구 체인 삭제**를 클릭하고 삭제할 도구 통합을 검토하거나 조정하십시오. +1. 도구 체인의 이름을 입력하고 **삭제**를 클릭하여 삭제를 확인하십시오. + + **팁**: GitHub Enterprise 도구 통합을 삭제해도 연관된 GitHub Enterprise 저장소는 GitHub Enterprise에서 삭제되지 않습니다. GitHub Enterprise에서 수동으로 저장소를 제거해야 합니다. diff --git a/toolchains/nl/ko/web_ide.md b/toolchains/nl/ko/web_ide.md index b48541a55..7b6d9aa32 100644 --- a/toolchains/nl/ko/web_ide.md +++ b/toolchains/nl/ko/web_ide.md @@ -1,152 +1,152 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} -{:pre: .pre} - -# Eclipse Orion {{site.data.keyword.webide}}로 코드 편집 -{: #web_ide} - -마지막 업데이트 날짜: 2016년 9월 9일 -{: .last-updated} - -Eclipse Orion {{site.data.keyword.webide}}는 웹용으로 개발할 수 있는 브라우저 기반 개발 환경입니다. 컨텐츠 지원, 코드 자동 완성 및 오류 검사를 사용하여 JavaScript, HTML 및 CSS로 개발할 수 있습니다. {{site.data.keyword.webide}}는 거의 모든 언어와 작동하며 대부분의 [파일 유형(링크가 새 창에서 열림)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}에 대한 구문 강조표시를 제공합니다. 소스 제어는 Git 또는 Jazz SCM을 통해 내장되며 앱을 테스트하고 디버그하기 위해 로컬에 코드를 배치할 수 있습니다. -{:shortdesc} - -무엇보다도 {{site.data.keyword.webide}}는 웹을 통해 구동됩니다. 설치하거나 유지보수하거나 스케일링할 필요가 없습니다. 인터넷에 연결되어 있으면 어디서든 개발할 수 있습니다. - -## 편집기 설정 -{: #editorsetup} - -{{site.data.keyword.webide}}는 사용자가 색상 구성표, 기술 도구 및 개발 요구사항에 맞는 설정을 선택할 수 있도록 사용자 정의할 수 있습니다. 설정을 보고 수정하려면 왼쪽에 있는 메뉴에서 **설정** 아이콘 설정 아이콘을 클릭하십시오. - -편집하는 동안 자주 특정 설정을 변경해야 하는 경우 편집기의 오른쪽 상단에 있는 **로컬 편집기 설정** 아이콘 로컬 편집기 설정 아이콘을 통해 해당 설정에 신속하게 액세스할 수 있습니다. - -![로컬 편집기 설정](images/webide_local_editor_settings.png) - -기본적으로 편집기 스타일 및 글꼴 크기 설정은 항상 표시됩니다. 메뉴에 다른 편집기 설정을 포함하려면 다음 단계를 따르십시오. - -1. **로컬 편집기 설정** 아이콘 로컬 편집기 설정 아이콘을 클릭하십시오. - -2. **편집기 설정**을 클릭하십시오. - -3. **로컬 편집기 설정** 메뉴에서 설정을 포함하거나 제외하려면 설정 옆에 있는 원을 클릭하십시오. - -![편집기 설정 토글](images/webide_editor_settings_toggle.png) - - -## 코드 편집 -{: #editcode} - -{{site.data.keyword.webide}}에는 두 개의 기본 섹션이 있습니다. 첫 번째 섹션은 왼쪽에 있는 파일 네비게이터이며, 여기에는 트리 구조로 프로젝트 파일이 표시됩니다. 파일 네비게이터에서 파일과 폴더를 작성, 이름 바꾸기, 삭제 및 관리할 수 있습니다. - -**팁:** 파일 네비게이터에 파일을 업로드하려면 컴퓨터에서 파일 네비게이터로 끌어 오십시오. - -두 번째 섹션은 오른쪽에 있는 편집기 분할창입니다. 이 편집기에서는 컨텐츠 지원 및 구문 유효성 검증을 포함하는 여러 코딩 기능을 제공합니다. - -![Web IDE](images/webide.png) - -### 여러 파일에 대한 작업 -1. 동시에 두 개의 파일에 대해 작업하려면 편집기의 맨 위에 있는 **분할 편집기 모드 변경** 아이콘 분할 편집기 아이콘을 클릭하십시오. -2. 메뉴가 열리면 보기를 선택하십시오. - - 보기를 선택한 다음 파일이 편집기에 이미 열려 있으면 두 편집기 보기 모두에 파일이 표시됩니다. - - 편집기 보기 중 하나에 표시되는 파일을 열거나 변경하려면 다음을 수행하십시오. - 1. 변경할 편집기 보기로 커서를 이동하십시오. - 2. 파일 네비게이터에서 파일을 클릭하십시오. - -### 키보드 단축키 -{{site.data.keyword.webide}}에 있는 대부분의 명령은 키보드 단축키를 통해서만 액세스할 수 있습니다. - -편집기에서 키보드 단축키 목록을 보려면 Alt+Shift+?를 누르십시오. Mac OS를 사용하는 경우 Ctrl+Shift+?를 누르십시오. - -## 소스 코드 관리 -{: #sourcecontrol} - -{{site.data.keyword.webide}}는 소스 코드 관리 도구와 통합됩니다. Git 저장소에 대해 작업하려면 **Git 저장소** 아이콘 Git 저장소 아이콘을 클릭하십시오. 자세한 정보는 [Git로 소스 제어(링크가 새 창에서 열림)](https://hub.jazz.net/docs/git/){: new_window}를 참조하십시오. - - -## 작업공간에서 앱 배치 -{: #deploy} - -1. 앱을 배치하려면 실행 표시줄에서 실행 구성을 선택하거나 [작성(링크가 새 창에서 열림)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window}하십시오. -1. 배치 아이콘 배치 아이콘을 클릭하십시오. 앱의 인스턴스는 작업공간의 현재 컨텐츠와 실행 구성에 정의된 환경을 사용하여 배치합니다. -2. 앱을 배치하고 나면 실행 표시줄을 사용하여 앱을 중지, 다시 시작 또는 디버그하고 로그를 보는 등의 작업을 수행할 수 있습니다. -![실행 표시줄](images/webide_runbar.png) - - - - ## {{site.data.keyword.webide}} 외부에서 편집 -{: #editlocal} - -{{site.data.keyword.webide}} 이외의 편집기를 사용하려면 어느 도구에서나 프로젝트 파일에 대해 직접 작업할 수 있도록 {{site.data.keyword.Bluemix_live}}를 설정하십시오. {{site.data.keyword.Bluemix_live_notm}}는 로컬 파일 시스템의 변경사항을 {{site.data.keyword.jazzhub}}의 클라우드 작업공간과 동기화하는 명령행 애플리케이션입니다. - -### 시작하기 전에 - -[{{site.data.keyword.Bluemix_live_notm}} 명령행 인터페이스(링크가 새 창에서 열림)](http://livesyncdownload.ng.bluemix.net){: new_window}를 다운로드하여 설치하십시오. - -### 로컬 환경을 {{site.data.keyword.Bluemix_notm}}와 동기화 -{: #edit_local_download} - -1. 명령행 창을 여십시오. -2. 다음을 수행하여 {{site.data.keyword.Bluemix_notm}}에 로그인하십시오. - - ``` - bl login - ``` - {: pre} - -3. 프롬프트가 표시되면 IBM ID 및 비밀번호를 입력하십시오. -4. 다음을 수행하여 {{site.data.keyword.Bluemix_notm}} 프로젝트 목록을 보십시오. - - ``` - bl projects - ``` - {: pre} - -4. 다음을 수행하여 로컬 환경을 {{site.data.keyword.Bluemix_notm}}의 프로젝트와 동기화하십시오. - - ``` - bl sync projectName - ``` - {: pre} - -여기서 `projectName`은 {{site.data.keyword.Bluemix_notm}} 앱의 이름입니다. - -편집을 완료하면 `q`를 입력하여 동기화를 종료하십시오. - -### Desktop Sync 기능을 사용하여 로컬에서 코드 편집 - -Desktop Sync 기능은 명령행의 Live Edit 모드와 유사합니다. 명령행에서 디버그하려면 Desktop Sync 기능이 필요합니다. -1. 다른 명령행 창에서 다음과 같이 Desktop Sync 기능을 사용하십시오. - - ``` - cd localDirectory - bl start - ``` - {: codeblock} - -2. {{site.data.keyword.webide}}에서 작성한 실행 구성을 사용하십시오. 실행 구성을 선택하고 나면 로컬 환경에서 Desktop Sync 기능이 사용됩니다. 방금 연 명령행 창에서 앱의 URL, 디버그 URL, 관리 URL을 보고 {{site.data.keyword.Bluemix_live_notm}} 상태를 볼 수 있습니다. - -3. 브라우저를 새로 고치고 로컬 작업공간에서 정적 파일에 저장한 변경사항이 표시되는지 확인하십시오. - -### Desktop Sync 기능 사용 안함 - -1. 두 번째 명령행 창에서 `bl stop`을 입력하십시오. -2. 첫 번째 명령행 창에서 `q`를 입력하십시오. +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} +{:pre: .pre} + +# Eclipse Orion {{site.data.keyword.webide}}로 코드 편집 +{: #web_ide} + +마지막 업데이트 날짜: 2016년 9월 9일 +{: .last-updated} + +Eclipse Orion {{site.data.keyword.webide}}는 웹용으로 개발할 수 있는 브라우저 기반 개발 환경입니다. 컨텐츠 지원, 코드 자동 완성 및 오류 검사를 사용하여 JavaScript, HTML 및 CSS로 개발할 수 있습니다. {{site.data.keyword.webide}}는 거의 모든 언어와 작동하며 대부분의 [파일 유형(링크가 새 창에서 열림)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}에 대한 구문 강조표시를 제공합니다. 소스 제어는 Git 또는 Jazz SCM을 통해 내장되며 앱을 테스트하고 디버그하기 위해 로컬에 코드를 배치할 수 있습니다. +{:shortdesc} + +무엇보다도 {{site.data.keyword.webide}}는 웹을 통해 구동됩니다. 설치하거나 유지보수하거나 스케일링할 필요가 없습니다. 인터넷에 연결되어 있으면 어디서든 개발할 수 있습니다. + +## 편집기 설정 +{: #editorsetup} + +{{site.data.keyword.webide}}는 사용자가 색상 구성표, 기술 도구 및 개발 요구사항에 맞는 설정을 선택할 수 있도록 사용자 정의할 수 있습니다. 설정을 보고 수정하려면 왼쪽에 있는 메뉴에서 **설정** 아이콘 설정 아이콘을 클릭하십시오. + +편집하는 동안 자주 특정 설정을 변경해야 하는 경우 편집기의 오른쪽 상단에 있는 **로컬 편집기 설정** 아이콘 로컬 편집기 설정 아이콘을 통해 해당 설정에 신속하게 액세스할 수 있습니다. + +![로컬 편집기 설정](images/webide_local_editor_settings.png) + +기본적으로 편집기 스타일 및 글꼴 크기 설정은 항상 표시됩니다. 메뉴에 다른 편집기 설정을 포함하려면 다음 단계를 따르십시오. + +1. **로컬 편집기 설정** 아이콘 로컬 편집기 설정 아이콘을 클릭하십시오. + +2. **편집기 설정**을 클릭하십시오. + +3. **로컬 편집기 설정** 메뉴에서 설정을 포함하거나 제외하려면 설정 옆에 있는 원을 클릭하십시오. + +![편집기 설정 토글](images/webide_editor_settings_toggle.png) + + +## 코드 편집 +{: #editcode} + +{{site.data.keyword.webide}}에는 두 개의 기본 섹션이 있습니다. 첫 번째 섹션은 왼쪽에 있는 파일 네비게이터이며, 여기에는 트리 구조로 프로젝트 파일이 표시됩니다. 파일 네비게이터에서 파일과 폴더를 작성, 이름 바꾸기, 삭제 및 관리할 수 있습니다. + +**팁:** 파일 네비게이터에 파일을 업로드하려면 컴퓨터에서 파일 네비게이터로 끌어 오십시오. + +두 번째 섹션은 오른쪽에 있는 편집기 분할창입니다. 이 편집기에서는 컨텐츠 지원 및 구문 유효성 검증을 포함하는 여러 코딩 기능을 제공합니다. + +![Web IDE](images/webide.png) + +### 여러 파일에 대한 작업 +1. 동시에 두 개의 파일에 대해 작업하려면 편집기의 맨 위에 있는 **분할 편집기 모드 변경** 아이콘 분할 편집기 아이콘을 클릭하십시오. +2. 메뉴가 열리면 보기를 선택하십시오. + + 보기를 선택한 다음 파일이 편집기에 이미 열려 있으면 두 편집기 보기 모두에 파일이 표시됩니다. + + 편집기 보기 중 하나에 표시되는 파일을 열거나 변경하려면 다음을 수행하십시오. + 1. 변경할 편집기 보기로 커서를 이동하십시오. + 2. 파일 네비게이터에서 파일을 클릭하십시오. + +### 키보드 단축키 +{{site.data.keyword.webide}}에 있는 대부분의 명령은 키보드 단축키를 통해서만 액세스할 수 있습니다. + +편집기에서 키보드 단축키 목록을 보려면 Alt+Shift+?를 누르십시오. Mac OS를 사용하는 경우 Ctrl+Shift+?를 누르십시오. + +## 소스 코드 관리 +{: #sourcecontrol} + +{{site.data.keyword.webide}}는 소스 코드 관리 도구와 통합됩니다. Git 저장소에 대해 작업하려면 **Git 저장소** 아이콘 Git 저장소 아이콘을 클릭하십시오. 자세한 정보는 [Git로 소스 제어(링크가 새 창에서 열림)](https://hub.jazz.net/docs/git/){: new_window}를 참조하십시오. + + +## 작업공간에서 앱 배치 +{: #deploy} + +1. 앱을 배치하려면 실행 표시줄에서 실행 구성을 선택하거나 [작성(링크가 새 창에서 열림)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window}하십시오. +1. 배치 아이콘 배치 아이콘을 클릭하십시오. 앱의 인스턴스는 작업공간의 현재 컨텐츠와 실행 구성에 정의된 환경을 사용하여 배치합니다. +2. 앱을 배치하고 나면 실행 표시줄을 사용하여 앱을 중지, 다시 시작 또는 디버그하고 로그를 보는 등의 작업을 수행할 수 있습니다. +![실행 표시줄](images/webide_runbar.png) + + + + ## {{site.data.keyword.webide}} 외부에서 편집 +{: #editlocal} + +{{site.data.keyword.webide}} 이외의 편집기를 사용하려면 어느 도구에서나 프로젝트 파일에 대해 직접 작업할 수 있도록 {{site.data.keyword.Bluemix_live}}를 설정하십시오. {{site.data.keyword.Bluemix_live_notm}}는 로컬 파일 시스템의 변경사항을 {{site.data.keyword.jazzhub}}의 클라우드 작업공간과 동기화하는 명령행 애플리케이션입니다. + +### 시작하기 전에 + +[{{site.data.keyword.Bluemix_live_notm}} 명령행 인터페이스(링크가 새 창에서 열림)](http://livesyncdownload.ng.bluemix.net){: new_window}를 다운로드하여 설치하십시오. + +### 로컬 환경을 {{site.data.keyword.Bluemix_notm}}와 동기화 +{: #edit_local_download} + +1. 명령행 창을 여십시오. +2. 다음을 수행하여 {{site.data.keyword.Bluemix_notm}}에 로그인하십시오. + + ``` + bl login + ``` + {: pre} + +3. 프롬프트가 표시되면 IBM ID 및 비밀번호를 입력하십시오. +4. 다음을 수행하여 {{site.data.keyword.Bluemix_notm}} 프로젝트 목록을 보십시오. + + ``` + bl projects + ``` + {: pre} + +4. 다음을 수행하여 로컬 환경을 {{site.data.keyword.Bluemix_notm}}의 프로젝트와 동기화하십시오. + + ``` + bl sync projectName + ``` + {: pre} + +여기서 `projectName`은 {{site.data.keyword.Bluemix_notm}} 앱의 이름입니다. + +편집을 완료하면 `q`를 입력하여 동기화를 종료하십시오. + +### Desktop Sync 기능을 사용하여 로컬에서 코드 편집 + +Desktop Sync 기능은 명령행의 Live Edit 모드와 유사합니다. 명령행에서 디버그하려면 Desktop Sync 기능이 필요합니다. +1. 다른 명령행 창에서 다음과 같이 Desktop Sync 기능을 사용하십시오. + + ``` + cd localDirectory + bl start + ``` + {: codeblock} + +2. {{site.data.keyword.webide}}에서 작성한 실행 구성을 사용하십시오. 실행 구성을 선택하고 나면 로컬 환경에서 Desktop Sync 기능이 사용됩니다. 방금 연 명령행 창에서 앱의 URL, 디버그 URL, 관리 URL을 보고 {{site.data.keyword.Bluemix_live_notm}} 상태를 볼 수 있습니다. + +3. 브라우저를 새로 고치고 로컬 작업공간에서 정적 파일에 저장한 변경사항이 표시되는지 확인하십시오. + +### Desktop Sync 기능 사용 안함 + +1. 두 번째 명령행 창에서 `bl stop`을 입력하십시오. +2. 첫 번째 명령행 창에서 `q`를 입력하십시오. diff --git a/toolchains/nl/pt/BR/toolchains_about.md b/toolchains/nl/pt/BR/toolchains_about.md index 88b3d385a..dcbf160f3 100644 --- a/toolchains/nl/pt/BR/toolchains_about.md +++ b/toolchains/nl/pt/BR/toolchains_about.md @@ -1,57 +1,57 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# Sobre cadeias de ferramentas -{: #toolchains_about} - -Última atualização: 13 de setembro de 2016 -{: .last-updated} - -Uma *cadeia de ferramentas* é um conjunto de integrações de ferramentas que suporta tarefas de desenvolvimento, de implementação e de operações. O -poder coletivo de uma cadeia de ferramentas é maior que a soma de suas integrações de ferramentas individuais. -{:shortdesc} - -Cadeias de ferramentas estão disponíveis nos ambientes Public e Dedicated no {{site.data.keyword.Bluemix}}. É possível criar uma cadeia de ferramentas de duas formas: usar um modelo para criar uma cadeia de ferramentas ou criar uma cadeia de -ferramentas a partir de um app. Como um ponto de início, é possível usar um modelo de cadeia de ferramentas. Dependendo do modelo que você usar, é possível criar uma cadeia de ferramentas que tenha um -conjunto específico de integrações de ferramentas ou uma cadeia de ferramentas vazia em que é possível incluir integrações de ferramentas. - -No {{site.data.keyword.Bluemix_notm}} Public, dependendo do modelo ou cadeia de ferramentas que você usar, a cadeia de ferramentas poderá incluir um repositório (repo) GitHub que é preenchido com o código de início do aplicativo e uma pipeline de entrega pré-configurada. Ao -enviar por push as mudanças no repositório GitHub da cadeia de -ferramentas, o pipeline de entrega automaticamente constrói e implementa o app no {{site.data.keyword.Bluemix_notm}}. - -No {{site.data.keyword.Bluemix_notm}} Dedicated, dependendo da cadeia de ferramentas que você usar, a cadeia de ferramentas poderá incluir um repositório GitHub Enterprise que é preenchido com -o código de início do aplicativo e uma pipeline de entrega pré-configurada. Quando você envia por push as mudanças no repositório GitHub Enterprise da cadeia de ferramentas, a pipeline de entrega -automaticamente constrói e implementa os aplicativos no {{site.data.keyword.Bluemix_notm}}. - -## Obtendo ajuda e suporte para cadeias de ferramentas -{: #gettinghelp} - -Se você tiver problemas ou perguntas ao usar cadeias de ferramentas, será possível obter ajuda procurando informações e fazendo perguntas através de um fórum. Também é possível abrir um chamado de suporte. - -Ao usar os fóruns para fazer uma pergunta, marque a sua pergunta -para que ela possa ser vista pelas equipes de desenvolvimento do {{site.data.keyword.Bluemix_notm}}. - -* Se você tiver questões técnicas sobre o desenvolvimento ou a implementação de um aplicativo com cadeias de ferramentas, poste a sua pergunta no -[Estouro da capacidade (O link -é aberto em uma nova janela)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} e identifique a sua pergunta com "ibm-bluemix" e "devops". - -* Para perguntas sobre cadeias de ferramentas e instruções de introdução, use o fórum do -[IBM -developerWorks dW Answers (O link -é aberto em uma nova janela)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}. Inclua as identificações "devops-services" e "bluemix". - -Consulte [Obtendo ajuda (O link é aberto em uma nova janela)](https://www.{DomainName}/docs/support/index.html#getting-help) para obter mais detalhes sobre como usar os fóruns. - -Para obter informações sobre como abrir um chamado de suporte IBM ou sobre níveis de suporte e severidades de chamado, consulte -[Entrando em contato com o suporte -(O link é aberto em uma nova janela)](https://www.{DomainName}/docs/support/index.html#contacting-support). +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# Sobre cadeias de ferramentas +{: #toolchains_about} + +Última atualização: 13 de setembro de 2016 +{: .last-updated} + +Uma *cadeia de ferramentas* é um conjunto de integrações de ferramentas que suporta tarefas de desenvolvimento, de implementação e de operações. O +poder coletivo de uma cadeia de ferramentas é maior que a soma de suas integrações de ferramentas individuais. +{:shortdesc} + +Cadeias de ferramentas estão disponíveis nos ambientes Public e Dedicated no {{site.data.keyword.Bluemix}}. É possível criar uma cadeia de ferramentas de duas formas: usar um modelo para criar uma cadeia de ferramentas ou criar uma cadeia de +ferramentas a partir de um app. Como um ponto de início, é possível usar um modelo de cadeia de ferramentas. Dependendo do modelo que você usar, é possível criar uma cadeia de ferramentas que tenha um +conjunto específico de integrações de ferramentas ou uma cadeia de ferramentas vazia em que é possível incluir integrações de ferramentas. + +No {{site.data.keyword.Bluemix_notm}} Public, dependendo do modelo ou cadeia de ferramentas que você usar, a cadeia de ferramentas poderá incluir um repositório (repo) GitHub que é preenchido com o código de início do aplicativo e uma pipeline de entrega pré-configurada. Ao +enviar por push as mudanças no repositório GitHub da cadeia de +ferramentas, o pipeline de entrega automaticamente constrói e implementa o app no {{site.data.keyword.Bluemix_notm}}. + +No {{site.data.keyword.Bluemix_notm}} Dedicated, dependendo da cadeia de ferramentas que você usar, a cadeia de ferramentas poderá incluir um repositório GitHub Enterprise que é preenchido com +o código de início do aplicativo e uma pipeline de entrega pré-configurada. Quando você envia por push as mudanças no repositório GitHub Enterprise da cadeia de ferramentas, a pipeline de entrega +automaticamente constrói e implementa os aplicativos no {{site.data.keyword.Bluemix_notm}}. + +## Obtendo ajuda e suporte para cadeias de ferramentas +{: #gettinghelp} + +Se você tiver problemas ou perguntas ao usar cadeias de ferramentas, será possível obter ajuda procurando informações e fazendo perguntas através de um fórum. Também é possível abrir um chamado de suporte. + +Ao usar os fóruns para fazer uma pergunta, marque a sua pergunta +para que ela possa ser vista pelas equipes de desenvolvimento do {{site.data.keyword.Bluemix_notm}}. + +* Se você tiver questões técnicas sobre o desenvolvimento ou a implementação de um aplicativo com cadeias de ferramentas, poste a sua pergunta no +[Estouro da capacidade (O link +é aberto em uma nova janela)](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window} e identifique a sua pergunta com "ibm-bluemix" e "devops". + +* Para perguntas sobre cadeias de ferramentas e instruções de introdução, use o fórum do +[IBM +developerWorks dW Answers (O link +é aberto em uma nova janela)](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}. Inclua as identificações "devops-services" e "bluemix". + +Consulte [Obtendo ajuda (O link é aberto em uma nova janela)](https://www.{DomainName}/docs/support/index.html#getting-help) para obter mais detalhes sobre como usar os fóruns. + +Para obter informações sobre como abrir um chamado de suporte IBM ou sobre níveis de suporte e severidades de chamado, consulte +[Entrando em contato com o suporte +(O link é aberto em uma nova janela)](https://www.{DomainName}/docs/support/index.html#contacting-support). diff --git a/toolchains/nl/pt/BR/toolchains_integrations.md b/toolchains/nl/pt/BR/toolchains_integrations.md index 92bbeff95..28b449cb2 100644 --- a/toolchains/nl/pt/BR/toolchains_integrations.md +++ b/toolchains/nl/pt/BR/toolchains_integrations.md @@ -1,411 +1,411 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# Configurando integrações de ferramenta -{: #integrations} - -Última atualização: 18 de outubro de 2016 -{: .last-updated} - -É possível configurar integrações de ferramenta que suportam tarefas de desenvolvimento, implementação e operações ao criar uma cadeia de ferramentas ou é possível incluir e configurar integrações de ferramenta para customizar uma cadeia de ferramentas existente. -{:shortdesc} - -**Importante**: no {{site.data.keyword.Bluemix_notm}} Public, cadeias de ferramentas estão disponíveis somente na região sul dos EUA. - -As integrações de ferramentas que estão disponíveis para incluir e configurar para a sua cadeia de ferramentas são diferentes, dependendo de você estar usando cadeias de ferramentas no -{{site.data.keyword.Bluemix_notm}} Public ou no {{site.data.keyword.Bluemix_notm}} Dedicated. Se estiver usando cadeias de ferramentas no -{{site.data.keyword.Bluemix_notm}} Dedicated, as integrações de ferramenta disponíveis para você dependerão de como o {{site.data.keyword.jazzhub_title}} foi configurado em seu ambiente específico. - -*Tabela 1. Integrações de ferramentas disponíveis para cadeias de ferramentas no {{site.data.keyword.Bluemix_notm}} Dedicated e Public* - -|Integração de ferramentas |Disponível no {{site.data.keyword.Bluemix_notm}} Public |Disponível no {{site.data.keyword.Bluemix_notm}} Dedicated (ambiente dependente)| -|:----------|:------------------------------|:------------------| -|{{site.data.keyword.deliverypipeline}} |Sim |Sim | -|{{site.data.keyword.DRA_short}} |Sim |no | -|Eclipse Orion {{site.data.keyword.webide}} |Sim |Sim | -|GitHub |Sim |Sim | -|Dedicated GitHub Enterprise |no |Sim | -|Outra Ferramenta |Sim |Sim | -|PagerDuty |Sim |Sim | -|Sauce Labs |Sim |no | -|Slack |Sim |Sim | - -**Dica**: se você deseja iniciar o desenvolvimento com o seu código-fonte no {{site.data.keyword.Bluemix_notm}} Public, configure a integração de ferramenta do GitHub antes de configurar a {{site.data.keyword.deliverypipeline}}. Se -você deseja começar a desenvolver com o seu código no {{site.data.keyword.Bluemix_notm}} Dedicated, configure a integração de ferramenta {{site.data.keyword.ghe_short}} ou a integração de ferramenta GitHub antes de configurar o {{site.data.keyword.deliverypipeline}}. - - -## Configurando o pipeline de entrega -{: #deliverypipeline} - -O {{site.data.keyword.deliverypipeline}} automatiza a implementação contínua de seus projetos por meio de sequências de estágios que -recuperam tarefas de entrada e de execução, como construções, testes e implementações. - -Configure o {{site.data.keyword.deliverypipeline}} para automatizar a construção, o teste e a implementação contínuos de seus apps: - -1. Se estiver configurando essa integração de ferramenta conforme estiver criando a cadeia de ferramentas, na seção Integrações -configuráveis, clique em **Pipeline de entrega**. Dependendo do modelo que usar, campos diferentes poderão estar disponíveis. Revise -os valores de campo padrão e, se necessário, mude essas configurações. -1. Se você tiver uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Public e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como alternativa, na página Visão geral de seu aplicativo, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique em **Integrações de ferramenta**. Se você estiver usando uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Dedicated, no Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em -seguida, clique em **Integrações de ferramenta**. -1. Clique no botão de inclusão (+). -1. Na seção Integrações de ferramenta, clique em **Pipeline de entrega**. -1. Especifique um nome para seu novo pipeline. -1. Se planejar usar seu pipeline para implementar uma interface com o usuário, selecione a caixa de seleção **App -visualizável**. Todos os apps que seu pipeline criar serão mostrados na lista **VISUALIZAR APP** na página Integrações -de ferramenta da cadeia de ferramentas. -1. Clique em **Criar integração** para incluir o {{site.data.keyword.deliverypipeline}} em sua cadeia de -ferramentas. -1. Clique no ladrilho para {{site.data.keyword.deliverypipeline}} para visualizar o pipeline e configurá-lo. Para aprender os conceitos básicos de configuração de uma pipeline, consulte [Construindo e implementando pipelines (O link é aberto em uma nova janela)](../services/DeliveryPipeline/build_deploy.html){: new_window}. - - **Dica**: se você deseja acionar a pipeline ao enviar por push mudanças para o seu repositório (repo) GitHub ou do {{site.data.keyword.ghe_short}}, deve-se configurar o GitHub ou o {{site.data.keyword.ghe_short}} para a sua cadeia de ferramentas antes de definir os estágios para a sua pipeline. Os estágios de pipeline precisam das URLs do Git para os seus repositórios. Cada estágio de pipeline pode se referir a somente um dos repositórios GitHub ou do {{site.data.keyword.ghe_short}} que está associado com a sua cadeia de ferramentas. Para obter instruções para configurar o GitHub, consulte a seção [GitHub](#github). Para obter instruções para configurar o Dedicated GitHub Enterprise, consulte [Introdução ao {{site.data.keyword.ghe_long}} (O link é aberto em uma nova janela)](../services/ghededicated/index.html){: new_window}. - -1. Opcional: se você estiver usando uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Public e desejar que os Sauce Labs executem testes em seu aplicativo, configure o {{site.data.keyword.deliverypipeline}} para incluir uma tarefa de teste dos Sauce Labs. Para obter instruções para configurar a tarefa de teste, consulte a seção -[Configurando uma tarefa de teste Sauce Labs em seu pipeline](#config_saucelabs). - -### Configurando uma tarefa de teste Sauce Labs em seu pipeline -{: #config_saucelabs} - -Antes de configurar uma tarefa de teste Sauce Labs em seu pipeline, será necessário um pipeline em funcionamento que possua estágios para -construir e implementar seu app e deve-se configurar o Sauce Labs para sua cadeia de ferramentas. Para obter instruções para configurar o Sauce -Labs, consulte a seção [Sauce Labs](#saucelabs). - -Configure o {{site.data.keyword.deliverypipeline}} para incluir uma tarefa de teste Sauce Labs: - -1. Se você não tiver um estágio que implemente uma versão de teste de seu app, crie um. -1. No estágio, inclua uma tarefa de teste após a tarefa de implementação. Ao colocar essas tarefas no mesmo estágio, elas poderão acessar o -mesmo conjunto de propriedades do ambiente. - ![Tarefa de Teste -](images/toolchain_test_job.png) - -1. Configure o estágio: - - a. Na guia **PROPRIEDADES DO AMBIENTE**, crie três propriedades: CF_APP_NAME, SAUCE_USERNAME e SAUCE_ACCESS_KEY. - - b. Insira seu nome de usuário e chave de acesso do Sauce Labs. Ao fazer isso, você externaliza esses valores para que possa usá-los em -seus testes. - -1. Configure a tarefa de implementação. No campo **Implementar script**, inclua esse comando: `export CF_APP_NAME="$CF_APP"`. Esse -comando exporta o nome do app como uma propriedade do ambiente. -1. Configure a tarefa de teste. Os valores na imagem a seguir são exemplos. Os campos **Instância de serviço**, **Destino**, -**Organização** e **Espaço** são preenchidos com o nome do usuário, a região, a organização e o espaço dos Sauce Labs que você estiver usando. -![Configurar tarefa](images/toolchain_configure_job.png) - - a. Para o tipo de testador, selecione **Sauce Labs**. - - b. Para a instância de serviço, selecione o nome de usuário Sauce Labs que usou quando configurou o Sauce Labs para sua cadeia de ferramentas. - - **Dica**: para ver o nome de usuário e chave de acesso que usou quando configurou o Sauce Labs para sua cadeia de -ferramentas, clique em **Configurar**. - - c. No campo **Comando de execução de teste**, insira os comandos que instalam as dependências necessárias por -seus testes e, em seguida, execute os testes. Por exemplo, para um aplicativo Node.js, você pode inserir esses comandos: - ``` - npm install - node_modules/grunt-cli/bin/grunt test:sauce:parallel - ``` - - d. Se desejar ver seus relatórios de teste nos logs de tarefa de teste, selecione a caixa de seleção **Ativar -relatório de teste** e configure o Padrão de arquivo de resultado de teste como `test/*.xml`. - -1. Clique em **SALVAR**. Sempre que a sua pipeline for executada, os seus testes dos Sauce Labs serão executados. - -Para saber mais, consulte [Pipeline de entrega (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}. - - -## Incluindo o {{site.data.keyword.DRA_short}} -{: #dra} - -{{site.data.keyword.DRA_full}} coleta e analisa os resultados dos testes de unidade, testes funcionais e ferramentas de -cobertura de código para determinar se seu código atende a critérios predefinidos em gates especificados em seu processo de implementação. Se seu -código não atender ou exceder os critérios, a implementação será interrompida para evitar riscos de serem liberados. É possível usar o {{site.data.keyword.DRA_short}} como uma rede de segurança para o -seu ambiente de entrega contínua ou como uma forma de implementar e melhorar os padrões de qualidade. - - **Nota**: esta integração de ferramenta é pré-configurada. Ela não requer nenhum parâmetro de configuração e não é -possível reconfigurá-la. - -Inclua o {{site.data.keyword.DRA_short}} para manter e melhorar a qualidade de seu código no {{site.data.keyword.Bluemix_notm}} monitorando as suas implementações para identificar riscos -antes de serem liberadas. - -1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como -alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em -seguida, clique em **Integrações de ferramenta**. -1. Clique no botão de inclusão (+). -1. Na seção Integrações de ferramenta, clique em **Deployment Risk Analytics**. -1. Clique em -**Criar integração**. -1. Clique no ladrilho para o {{site.data.keyword.DRA_short}} e, em seguida, conclua as etapas de introdução: criar critérios, conectar os critérios à pipeline e executar a pipeline. Para obter -mais informações, consulte [{{site.data.keyword.DRA_short}} (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}. - - -## Incluindo o Eclipse Orion {{site.data.keyword.webide}} -{: #webide} - -O Eclipse Orion {{site.data.keyword.webide}} é um ambiente baseado na web integrado em que é possível criar, editar, executar, -depurar e concluir tarefas de controle de fonte. É possível mover perfeitamente da edição para execução, do envio para implementação. - - **Nota**: esta integração de ferramenta é pré-configurada. Ela não requer nenhum parâmetro de configuração e não é -possível reconfigurá-la. - -Para concluir tarefas de controle de fonte, inclua a integração de ferramenta do Eclipse Orion {{site.data.keyword.webide}}: - -1. Se você tiver uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Public e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como -alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique em **Integrações de ferramenta**. Se você estiver usando uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Dedicated, no Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em -seguida, clique em **Integrações de ferramenta**. -1. Clique no botão de inclusão (+). -1. Na seção Integrações de ferramenta, clique em **Eclipse Orion Web IDE**. -1. Clique em -**Criar integração**. -1. Clique no ladrilho para o novo Eclipse Orion {{site.data.keyword.webide}}. A sua área de trabalho é previamente preenchida com seus repositórios GitHub ou do -{{site.data.keyword.ghe_short}}. Os -repos associados a -sua cadeia de ferramentas atual são destacados. - -Para saber mais, consulte [Editando o código com o Eclipse Orion {{site.data.keyword.webide}} (O link é aberto em uma nova janela)](../toolchains/web_ide.html){: new_window}. - - -## Configurando o GitHub -{: #github} - -O GitHub é um serviço de hospedagem baseado na web para -repos Git. É possível ter ambas as cópias local e remota de -seus repos, o que -facilita a colaboração. - -O GitHub Issues é uma ferramenta de controle que mantém seu trabalho e seus planos todos em um lugar. Ele -é integrado a seu repo de -desenvolvimento para que possa focar em tarefas importantes. - -Configure o GitHub para gerenciar o seu código-fonte na nuvem: - -1. Se estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, siga estas etapas: - - a. Na seção Integrações configuráveis, clique em **GitHub**. Se você estiver criando a cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Public e não for autorizado {{site.data.keyword.Bluemix_notm}} a acessar o GitHub, clique em **Autorizar** para acessar o website GitHub. Se você não -tiver uma sessão GitHub ativa, será solicitado que efetue login. Clique em **Autorizar aplicativo** para permitir que o {{site.data.keyword.Bluemix_notm}} acesse sua conta GitHub. Se -você tiver uma sessão GitHub ativa, mas não tiver inserido sua senha recentemente, poderá ser solicitado que insira sua senha GitHub para -confirmar. - - b. Revise os locais de repo de destino padrão para os -repos GitHub. Esses repos são clonados a partir dos mesmos -repos de amostra. Se -necessário, mude os nomes dos repos de destino. - ![Locais de repo de destino padrão](images/toolchain_github_config.png) - -1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como -alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em -seguida, clique em **Integrações de ferramenta**. -1. Clique no botão de inclusão (+). -1. Na seção Integrações de ferramenta, clique em **GitHub**. -1. Se você tiver um repo GitHub e desejar usá-lo, digite -a -URL. Para o tipo de repositório, clique em **Link**. -1. Se desejar usar um novo repo GitHub, digite um nome -para o repo GitHub, digite a URL para o repo que estiver -clonando ou bifurcando e -selecione o tipo de repositório: - - a. Para criar um repositório vazio, clique em **Novo**. - - b. Para criar uma cópia de um repositório GitHub, clique em **Clone**. - - c. Para bifurcar um repositório GitHub para que você possa contribuir com as mudanças por meio das solicitações de pull, clique em **Bifurcar**. - -1. Se desejar usar o GitHub Issues para o controle de emissões, selecione a caixa de seleção **Ativar GitHub Issues**. -1. Clique em -**Criar integração**. -1. Clique no ladrilho para o repositório GitHub com o qual deseja trabalhar. O website do GitHub é aberto, no qual é possível visualizar os conteúdos do repositório. - - **Dica**: é possível usar as ferramentas de gerenciamento de código-fonte integradas no Eclipse Orion {{site.data.keyword.webide}} para editar o repositório GitHub e -implementar um aplicativo a partir de sua área de trabalho. - -1. Se você ativou o GitHub Issues, clique no ladrilho para o GitHub Issues para abri-lo. - -Para obter mais informações, consulte [GitHub (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} e -[GitHub Issues (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. - - -## Configurando o Dedicated GitHub Enterprise -{: #configghe} - -O {{site.data.keyword.ghe_long}} é um serviço de hospedagem no local, baseado na web para repositórios Git. O Dedicated GitHub Enterprise destina-se somente para clientes do -{{site.data.keyword.Bluemix_notm}} Dedicated. O GitHub Issues é uma ferramenta de rastreamento que mantém o seu trabalho e os seus planos em um local. Ele -é integrado a seu repo de -desenvolvimento para que possa focar em tarefas importantes. Para obter mais informações sobre o Dedicated GitHub Enterprise e o GitHub Issues, consulte -[Usando o Dedicated GitHub Enterprise (O link -é aberto em uma nova janela)](../services/ghededicated/index.html){: new_window} e [GitHub Issues (O link -é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. - -É possível configurar o {{site.data.keyword.ghe_short}} como uma integração de ferramenta em sua cadeia de ferramentas de forma que seja possível gerenciar código-fonte na instância do -[{{site.data.keyword.Bluemix_notm}} Dedicated de sua empresa (O link -é aberto em uma nova janela)](../dedicated/index.html#dedicated){: new_window}. - -1. Se estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, siga estas etapas: - - a. Antes de efetuar login no Dedicated GitHub Enterprise pela primeira vez, solicite ao administrador de região de sua empresa para incluir o seu ID do usuário em sua instância do -{{site.data.keyword.Bluemix_notm}} Dedicated a partir de seu registro do usuário usando LDAP. Para obter informações sobre como configurar a sua conta do {{site.data.keyword.ghe_short}}, -consulte [Usando o Dedicated GitHub Enterprise (O link é aberto em uma nova janela)](../services/ghededicated/index.html){: new_window}. - - b. Na seção Integrações configuráveis, clique em **{{site.data.keyword.ghe_short}}**. - - c. Revise o nome padrão para o novo repositório do {{site.data.keyword.ghe_short}}. Se necessário, mude o nome do novo repositório. A imagem a seguir mostra um exemplo de um repositório que -é clonado a partir de um repositório de amostra. É possível usar um repositório existente ou um novo repositório. Para usar um repositório novo, é possível criar um repositório vazio, clonar um repositório -ou bifurcar um repositório. - ![Locais de repositório padrão](images/toolchain_ghe_config.png) - -1. Se você tiver uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Public e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como alternativa, na página Visão geral de seu aplicativo, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique em **Integrações de ferramenta**. Se você estiver usando uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Dedicated, no Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em -seguida, clique em **Integrações de ferramenta**. -1. Clique no botão de inclusão (+). -1. Na seção Integrações de ferramentas, clique em **{{site.data.keyword.ghe_short}}**. -1. Se você tiver um repositório do {{site.data.keyword.ghe_short}} que deseja usar, digite a URL para o repositório. Para o tipo de repositório, clique em -**Existente**. -1. Se você deseja usar um novo repositório do {{site.data.keyword.ghe_short}}, digite um nome para o repositório, digite a URL para o repositório que você está clonando ou bifurcando e -selecione o tipo de repositório: - - a. Para criar um repositório vazio, clique em **Novo**. - - b. Para criar uma cópia de um repositório, clique em **Clonar**. - - c. Para bifurcar um repositório de maneira que você possa contribuir com as mudanças por meio de solicitações de pull, clique em **Bifurcar**. - -1. Para usar o GitHub Issues para rastreamento de emissão, marque a caixa de seleção **Ativar o GitHub Issues**. -1. Clique em -**Criar integração**. -1. Clique no ladrilho para o repositório do {{site.data.keyword.ghe_short}} com o qual deseja trabalhar. A instância do -[{{site.data.keyword.Bluemix_notm}} Dedicated de sua empresa (O link é aberto em uma nova janela)](../dedicated/index.html#dedicated){: new_window} é aberta, na qual é possível -visualizar os conteúdos do repositório. - - **Dica**: é possível usar as ferramentas de gerenciamento de código-fonte integradas no Eclipse Orion {{site.data.keyword.webide}} para editar o repositório do -{{site.data.keyword.ghe_short}} e -implementar um aplicativo a partir de sua área de trabalho. - -1. Se você ativou o GitHub Issues, clique no ladrilho para o GitHub Issues. - - - -## Configurando uma ferramenta customizada (Outra Ferramenta) -{: #othertool} - -Se sua equipe usa uma ferramenta que não está incluída na lista de integração de cadeias de ferramentas, é possível integrar uma ferramenta customizada. - -Configure uma ferramenta customizada para que ela trabalhe com outras ferramentas em sua cadeia de ferramentas e esteja disponível para a sua equipe: -1. Se você estiver configurando essa integração de ferramenta conforme cria a cadeia de ferramentas, na seção Integrações configuráveis, clique em **Outra ferramenta**. - -1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como -alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em -seguida, clique em **Integrações de ferramenta**. -1. Clique no botão de inclusão (+). -1. Na seção Integrações de ferramenta, clique em **Outra Ferramenta**. -1. Digite o nome da ferramenta. -1. Selecione a fase do Ciclo de vida mais estreitamente associada com a ferramenta. A escolha da fase do Ciclo de Vida determina sob qual categoria sua ferramenta está listada na página Integração de Cadeia de ferramentas. -1. Inclua uma URL de ícone. O ícone aparecerá no cartão de integração da ferramenta. -1. Inclua uma URL de documentação. -1. Especifique um nome da instância da ferramenta. Por exemplo: Minha Ferramenta de Equipe. -1. Inclua uma URL da instância da ferramenta. Clicar no cartão de integração da ferramenta leva à URL que você listar para a instância da ferramenta. -1. Inclua uma descrição da sua ferramenta. -1. (Avançado) Inclua propriedades adicionais se necessário. Por exemplo, liste qualquer informação ou atributos que são necessários para integrar sua ferramenta com outras ferramentas em sua cadeia de ferramentas. -1. Clique em -**Criar integração**. - -## Configurando o PagerDuty -{: #pagerduty} - -O PagerDuty integra dados de diversos sistemas de monitoramento em uma única visualização. Quando um problema ocorre, o PagerDuty -assegura que o membro da equipe que melhor se adapta para corrigi-lo no momento seja notificado. Se o membro da equipe não responder ao problema, as escaladas poderão ser configuradas para roteá-lo para engenheiros secundários ou gerenciadores de operações. - -Configure o PagerDuty para enviar notificações quando as falhas de estágio de pipeline ocorrerem para que você possa corrigir problemas mais rapidamente e reduzir o tempo de inatividade: - -1. Se você estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, na seção Integrações configuráveis, clique em **PagerDuty**. -1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como -alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em -seguida, clique em **Integrações de ferramenta**. -1. Clique no botão de inclusão (+). -1. Na seção Integrações de ferramenta, clique em **PagerDuty** -1. Digite o nome do site PagerDuty associado à sua conta PagerDuty. Se você não tiver uma conta do PagerDuty, [registre-se em uma (o link é aberto em uma nova janela)](https://signup.pagerduty.com/accounts/new){: new_window}. -1. Digite a chave de acesso API para sua conta PagerDuty. Para obter instruções para localizar a chave, consulte [Autenticação de API (O link é -aberto em uma nova janela)](https://signup.pagerduty.com/accounts/new){: new_window}. -1. Digite o nome de seu serviço PagerDuty. -1. Digite o endereço de e-mail para o contato PagerDuty primário. -1. Digite o número do telefone para o contato PagerDuty primário. -1. Clique em -**Criar integração**. -1. Clique no ladrilho para o PagerDuty para acessar o pagerduty.com. É possível visualizar os eventos associados ao serviço PagerDuty -que você especificou quando configurou esta integração de ferramenta para sua cadeia de ferramentas. - -Para saber mais, consulte [PagerDuty (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}. - - -## Configurando o Sauce Labs -{: #saucelabs} - -O Sauce Labs executa testes de unidade funcional. Quando o suíte de testes do Sauce Labs é configurado como uma tarefa de teste no -{{site.data.keyword.deliverypipeline}}, o suíte de testes pode executar testes em relação a seu app da web ou móvel como parte de seu -processo de entrega contínua. Esses testes podem fornecer um controle de fluxo valioso para seus projetos, atuando como gates para impedir a -implementação de um código ruim. - -Configure o Sauce Labs para executar testes funcionais automatizados em múltiplos sistemas operacionais e navegadores para que possa emular a -forma que um usuário pode usar um website ou um aplicativo: - -1. Se você estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, na seção Integrações configuráveis, clique em **Sauce Labs**. -1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como -alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em -seguida, clique em **Integrações de ferramenta**. -1. Clique no botão de inclusão (+). -1. Na seção Integrações de ferramenta, clique em **Sauce Labs**. -1. Digite o nome de usuário associado à sua conta Sauce Labs. É possível [localizar o seu nome do usuário na mensagem de boas-vindas na parte superior de sua -página de conta dos Sauce Labs (O link é aberto em uma nova janela)](https://saucelabs.com/account){: new_window}. -1. Digite a chave de acesso para sua conta Sauce Labs. É possível [localizar a chave em sua página de conta dos Sauce Labs (O link é aberto em uma nova -janela)](https://saucelabs.com/account){: new_window}. -1. Clique em -**Criar integração**. -1. Clique no ladrilho para o Sauce Labs para acessar saucelabs.com e visualizar a atividade de teste para a cadeia de ferramentas. - - **Dica**: se você incluiu uma tarefa de teste Sauce Labs no {{site.data.keyword.deliverypipeline}}, é possível selecionar a instância de serviço. - -Para saber mais, consulte [Sauce Labs (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}. - - -## Configurando o Slack -{: #slack} - -**Importante**: as notificações que são postadas nos canais públicos Slack estão visíveis a todos na equipe. Lembre-se -que você é responsável pelo conteúdo que postar. - -O Slack é um sistema de mensagens e um sistema de notificação tempo real baseados na nuvem. O Slack fornece o bate-papo persistente, que é uma alternativa interativa ao e-mail para a colaboração da equipe. É -possível se comunicar com sua equipe em um canal dedicado ou em um conjunto de canais diretamente relacionado ao seu trabalho. Também é possível -compartilhar arquivos e imagens por meio dos canais ou em mensagens diretas entre duas ou mais pessoas. As comunicações nas mensagens diretas e nos -canais são retidas para que seja possível procurá-las. - -Configure o Slack para recuperar notificações sobre sua cadeia de ferramentas a partir das integrações de ferramenta, como atividades de -teste e de implementação: - -1. Se você estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, na seção Integrações -configuráveis, clique em **Slack**. -1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como -alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em -seguida, clique em **Integrações de ferramenta**. -1. Clique no botão de inclusão (+). -1. Na seção Integrações de ferramenta, clique em **Slack**. -1. Digite o token de autenticação API para sua conta Slack. Deve-se usar um token de acesso total gerado para se autenticar com o Slack. Para obter instruções para localizar o token, consulte -[Autenticação de folga (O link é aberto em uma nova janela)](https://api.slack.com/web#authentication){: new_window}. -1. Digite o nome do canal Slack para o qual deseja que as notificações sejam enviadas. Se o canal que especificar não existir, ele será criado. Se o canal foi arquivado, ele será reativado. -1. Clique em -**Criar integração**. -1. Clique no ladrilho para o Slack. É possível visualizar todas as atividades para sua cadeia de ferramentas no canal Slack configurado. - -Para saber mais, consulte [Folga (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}. - - - - - - - - +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# Configurando integrações de ferramenta +{: #integrations} + +Última atualização: 18 de outubro de 2016 +{: .last-updated} + +É possível configurar integrações de ferramenta que suportam tarefas de desenvolvimento, implementação e operações ao criar uma cadeia de ferramentas ou é possível incluir e configurar integrações de ferramenta para customizar uma cadeia de ferramentas existente. +{:shortdesc} + +**Importante**: no {{site.data.keyword.Bluemix_notm}} Public, cadeias de ferramentas estão disponíveis somente na região sul dos EUA. + +As integrações de ferramentas que estão disponíveis para incluir e configurar para a sua cadeia de ferramentas são diferentes, dependendo de você estar usando cadeias de ferramentas no +{{site.data.keyword.Bluemix_notm}} Public ou no {{site.data.keyword.Bluemix_notm}} Dedicated. Se estiver usando cadeias de ferramentas no +{{site.data.keyword.Bluemix_notm}} Dedicated, as integrações de ferramenta disponíveis para você dependerão de como o {{site.data.keyword.jazzhub_title}} foi configurado em seu ambiente específico. + +*Tabela 1. Integrações de ferramentas disponíveis para cadeias de ferramentas no {{site.data.keyword.Bluemix_notm}} Dedicated e Public* + +|Integração de ferramentas |Disponível no {{site.data.keyword.Bluemix_notm}} Public |Disponível no {{site.data.keyword.Bluemix_notm}} Dedicated (ambiente dependente)| +|:----------|:------------------------------|:------------------| +|{{site.data.keyword.deliverypipeline}} |Sim |Sim | +|{{site.data.keyword.DRA_short}} |Sim |no | +|Eclipse Orion {{site.data.keyword.webide}} |Sim |Sim | +|GitHub |Sim |Sim | +|Dedicated GitHub Enterprise |no |Sim | +|Outra Ferramenta |Sim |Sim | +|PagerDuty |Sim |Sim | +|Sauce Labs |Sim |no | +|Slack |Sim |Sim | + +**Dica**: se você deseja iniciar o desenvolvimento com o seu código-fonte no {{site.data.keyword.Bluemix_notm}} Public, configure a integração de ferramenta do GitHub antes de configurar a {{site.data.keyword.deliverypipeline}}. Se +você deseja começar a desenvolver com o seu código no {{site.data.keyword.Bluemix_notm}} Dedicated, configure a integração de ferramenta {{site.data.keyword.ghe_short}} ou a integração de ferramenta GitHub antes de configurar o {{site.data.keyword.deliverypipeline}}. + + +## Configurando o pipeline de entrega +{: #deliverypipeline} + +O {{site.data.keyword.deliverypipeline}} automatiza a implementação contínua de seus projetos por meio de sequências de estágios que +recuperam tarefas de entrada e de execução, como construções, testes e implementações. + +Configure o {{site.data.keyword.deliverypipeline}} para automatizar a construção, o teste e a implementação contínuos de seus apps: + +1. Se estiver configurando essa integração de ferramenta conforme estiver criando a cadeia de ferramentas, na seção Integrações +configuráveis, clique em **Pipeline de entrega**. Dependendo do modelo que usar, campos diferentes poderão estar disponíveis. Revise +os valores de campo padrão e, se necessário, mude essas configurações. +1. Se você tiver uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Public e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como alternativa, na página Visão geral de seu aplicativo, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique em **Integrações de ferramenta**. Se você estiver usando uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Dedicated, no Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em +seguida, clique em **Integrações de ferramenta**. +1. Clique no botão de inclusão (+). +1. Na seção Integrações de ferramenta, clique em **Pipeline de entrega**. +1. Especifique um nome para seu novo pipeline. +1. Se planejar usar seu pipeline para implementar uma interface com o usuário, selecione a caixa de seleção **App +visualizável**. Todos os apps que seu pipeline criar serão mostrados na lista **VISUALIZAR APP** na página Integrações +de ferramenta da cadeia de ferramentas. +1. Clique em **Criar integração** para incluir o {{site.data.keyword.deliverypipeline}} em sua cadeia de +ferramentas. +1. Clique no ladrilho para {{site.data.keyword.deliverypipeline}} para visualizar o pipeline e configurá-lo. Para aprender os conceitos básicos de configuração de uma pipeline, consulte [Construindo e implementando pipelines (O link é aberto em uma nova janela)](../services/DeliveryPipeline/build_deploy.html){: new_window}. + + **Dica**: se você deseja acionar a pipeline ao enviar por push mudanças para o seu repositório (repo) GitHub ou do {{site.data.keyword.ghe_short}}, deve-se configurar o GitHub ou o {{site.data.keyword.ghe_short}} para a sua cadeia de ferramentas antes de definir os estágios para a sua pipeline. Os estágios de pipeline precisam das URLs do Git para os seus repositórios. Cada estágio de pipeline pode se referir a somente um dos repositórios GitHub ou do {{site.data.keyword.ghe_short}} que está associado com a sua cadeia de ferramentas. Para obter instruções para configurar o GitHub, consulte a seção [GitHub](#github). Para obter instruções para configurar o Dedicated GitHub Enterprise, consulte [Introdução ao {{site.data.keyword.ghe_long}} (O link é aberto em uma nova janela)](../services/ghededicated/index.html){: new_window}. + +1. Opcional: se você estiver usando uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Public e desejar que os Sauce Labs executem testes em seu aplicativo, configure o {{site.data.keyword.deliverypipeline}} para incluir uma tarefa de teste dos Sauce Labs. Para obter instruções para configurar a tarefa de teste, consulte a seção +[Configurando uma tarefa de teste Sauce Labs em seu pipeline](#config_saucelabs). + +### Configurando uma tarefa de teste Sauce Labs em seu pipeline +{: #config_saucelabs} + +Antes de configurar uma tarefa de teste Sauce Labs em seu pipeline, será necessário um pipeline em funcionamento que possua estágios para +construir e implementar seu app e deve-se configurar o Sauce Labs para sua cadeia de ferramentas. Para obter instruções para configurar o Sauce +Labs, consulte a seção [Sauce Labs](#saucelabs). + +Configure o {{site.data.keyword.deliverypipeline}} para incluir uma tarefa de teste Sauce Labs: + +1. Se você não tiver um estágio que implemente uma versão de teste de seu app, crie um. +1. No estágio, inclua uma tarefa de teste após a tarefa de implementação. Ao colocar essas tarefas no mesmo estágio, elas poderão acessar o +mesmo conjunto de propriedades do ambiente. + ![Tarefa de Teste +](images/toolchain_test_job.png) + +1. Configure o estágio: + + a. Na guia **PROPRIEDADES DO AMBIENTE**, crie três propriedades: CF_APP_NAME, SAUCE_USERNAME e SAUCE_ACCESS_KEY. + + b. Insira seu nome de usuário e chave de acesso do Sauce Labs. Ao fazer isso, você externaliza esses valores para que possa usá-los em +seus testes. + +1. Configure a tarefa de implementação. No campo **Implementar script**, inclua esse comando: `export CF_APP_NAME="$CF_APP"`. Esse +comando exporta o nome do app como uma propriedade do ambiente. +1. Configure a tarefa de teste. Os valores na imagem a seguir são exemplos. Os campos **Instância de serviço**, **Destino**, +**Organização** e **Espaço** são preenchidos com o nome do usuário, a região, a organização e o espaço dos Sauce Labs que você estiver usando. +![Configurar tarefa](images/toolchain_configure_job.png) + + a. Para o tipo de testador, selecione **Sauce Labs**. + + b. Para a instância de serviço, selecione o nome de usuário Sauce Labs que usou quando configurou o Sauce Labs para sua cadeia de ferramentas. + + **Dica**: para ver o nome de usuário e chave de acesso que usou quando configurou o Sauce Labs para sua cadeia de +ferramentas, clique em **Configurar**. + + c. No campo **Comando de execução de teste**, insira os comandos que instalam as dependências necessárias por +seus testes e, em seguida, execute os testes. Por exemplo, para um aplicativo Node.js, você pode inserir esses comandos: + ``` + npm install + node_modules/grunt-cli/bin/grunt test:sauce:parallel + ``` + + d. Se desejar ver seus relatórios de teste nos logs de tarefa de teste, selecione a caixa de seleção **Ativar +relatório de teste** e configure o Padrão de arquivo de resultado de teste como `test/*.xml`. + +1. Clique em **SALVAR**. Sempre que a sua pipeline for executada, os seus testes dos Sauce Labs serão executados. + +Para saber mais, consulte [Pipeline de entrega (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}. + + +## Incluindo o {{site.data.keyword.DRA_short}} +{: #dra} + +{{site.data.keyword.DRA_full}} coleta e analisa os resultados dos testes de unidade, testes funcionais e ferramentas de +cobertura de código para determinar se seu código atende a critérios predefinidos em gates especificados em seu processo de implementação. Se seu +código não atender ou exceder os critérios, a implementação será interrompida para evitar riscos de serem liberados. É possível usar o {{site.data.keyword.DRA_short}} como uma rede de segurança para o +seu ambiente de entrega contínua ou como uma forma de implementar e melhorar os padrões de qualidade. + + **Nota**: esta integração de ferramenta é pré-configurada. Ela não requer nenhum parâmetro de configuração e não é +possível reconfigurá-la. + +Inclua o {{site.data.keyword.DRA_short}} para manter e melhorar a qualidade de seu código no {{site.data.keyword.Bluemix_notm}} monitorando as suas implementações para identificar riscos +antes de serem liberadas. + +1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como +alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em +seguida, clique em **Integrações de ferramenta**. +1. Clique no botão de inclusão (+). +1. Na seção Integrações de ferramenta, clique em **Deployment Risk Analytics**. +1. Clique em +**Criar integração**. +1. Clique no ladrilho para o {{site.data.keyword.DRA_short}} e, em seguida, conclua as etapas de introdução: criar critérios, conectar os critérios à pipeline e executar a pipeline. Para obter +mais informações, consulte [{{site.data.keyword.DRA_short}} (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}. + + +## Incluindo o Eclipse Orion {{site.data.keyword.webide}} +{: #webide} + +O Eclipse Orion {{site.data.keyword.webide}} é um ambiente baseado na web integrado em que é possível criar, editar, executar, +depurar e concluir tarefas de controle de fonte. É possível mover perfeitamente da edição para execução, do envio para implementação. + + **Nota**: esta integração de ferramenta é pré-configurada. Ela não requer nenhum parâmetro de configuração e não é +possível reconfigurá-la. + +Para concluir tarefas de controle de fonte, inclua a integração de ferramenta do Eclipse Orion {{site.data.keyword.webide}}: + +1. Se você tiver uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Public e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como +alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique em **Integrações de ferramenta**. Se você estiver usando uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Dedicated, no Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em +seguida, clique em **Integrações de ferramenta**. +1. Clique no botão de inclusão (+). +1. Na seção Integrações de ferramenta, clique em **Eclipse Orion Web IDE**. +1. Clique em +**Criar integração**. +1. Clique no ladrilho para o novo Eclipse Orion {{site.data.keyword.webide}}. A sua área de trabalho é previamente preenchida com seus repositórios GitHub ou do +{{site.data.keyword.ghe_short}}. Os +repos associados a +sua cadeia de ferramentas atual são destacados. + +Para saber mais, consulte [Editando o código com o Eclipse Orion {{site.data.keyword.webide}} (O link é aberto em uma nova janela)](../toolchains/web_ide.html){: new_window}. + + +## Configurando o GitHub +{: #github} + +O GitHub é um serviço de hospedagem baseado na web para +repos Git. É possível ter ambas as cópias local e remota de +seus repos, o que +facilita a colaboração. + +O GitHub Issues é uma ferramenta de controle que mantém seu trabalho e seus planos todos em um lugar. Ele +é integrado a seu repo de +desenvolvimento para que possa focar em tarefas importantes. + +Configure o GitHub para gerenciar o seu código-fonte na nuvem: + +1. Se estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, siga estas etapas: + + a. Na seção Integrações configuráveis, clique em **GitHub**. Se você estiver criando a cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Public e não for autorizado {{site.data.keyword.Bluemix_notm}} a acessar o GitHub, clique em **Autorizar** para acessar o website GitHub. Se você não +tiver uma sessão GitHub ativa, será solicitado que efetue login. Clique em **Autorizar aplicativo** para permitir que o {{site.data.keyword.Bluemix_notm}} acesse sua conta GitHub. Se +você tiver uma sessão GitHub ativa, mas não tiver inserido sua senha recentemente, poderá ser solicitado que insira sua senha GitHub para +confirmar. + + b. Revise os locais de repo de destino padrão para os +repos GitHub. Esses repos são clonados a partir dos mesmos +repos de amostra. Se +necessário, mude os nomes dos repos de destino. + ![Locais de repo de destino padrão](images/toolchain_github_config.png) + +1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como +alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em +seguida, clique em **Integrações de ferramenta**. +1. Clique no botão de inclusão (+). +1. Na seção Integrações de ferramenta, clique em **GitHub**. +1. Se você tiver um repo GitHub e desejar usá-lo, digite +a +URL. Para o tipo de repositório, clique em **Link**. +1. Se desejar usar um novo repo GitHub, digite um nome +para o repo GitHub, digite a URL para o repo que estiver +clonando ou bifurcando e +selecione o tipo de repositório: + + a. Para criar um repositório vazio, clique em **Novo**. + + b. Para criar uma cópia de um repositório GitHub, clique em **Clone**. + + c. Para bifurcar um repositório GitHub para que você possa contribuir com as mudanças por meio das solicitações de pull, clique em **Bifurcar**. + +1. Se desejar usar o GitHub Issues para o controle de emissões, selecione a caixa de seleção **Ativar GitHub Issues**. +1. Clique em +**Criar integração**. +1. Clique no ladrilho para o repositório GitHub com o qual deseja trabalhar. O website do GitHub é aberto, no qual é possível visualizar os conteúdos do repositório. + + **Dica**: é possível usar as ferramentas de gerenciamento de código-fonte integradas no Eclipse Orion {{site.data.keyword.webide}} para editar o repositório GitHub e +implementar um aplicativo a partir de sua área de trabalho. + +1. Se você ativou o GitHub Issues, clique no ladrilho para o GitHub Issues para abri-lo. + +Para obter mais informações, consulte [GitHub (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window} e +[GitHub Issues (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. + + +## Configurando o Dedicated GitHub Enterprise +{: #configghe} + +O {{site.data.keyword.ghe_long}} é um serviço de hospedagem no local, baseado na web para repositórios Git. O Dedicated GitHub Enterprise destina-se somente para clientes do +{{site.data.keyword.Bluemix_notm}} Dedicated. O GitHub Issues é uma ferramenta de rastreamento que mantém o seu trabalho e os seus planos em um local. Ele +é integrado a seu repo de +desenvolvimento para que possa focar em tarefas importantes. Para obter mais informações sobre o Dedicated GitHub Enterprise e o GitHub Issues, consulte +[Usando o Dedicated GitHub Enterprise (O link +é aberto em uma nova janela)](../services/ghededicated/index.html){: new_window} e [GitHub Issues (O link +é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}. + +É possível configurar o {{site.data.keyword.ghe_short}} como uma integração de ferramenta em sua cadeia de ferramentas de forma que seja possível gerenciar código-fonte na instância do +[{{site.data.keyword.Bluemix_notm}} Dedicated de sua empresa (O link +é aberto em uma nova janela)](../dedicated/index.html#dedicated){: new_window}. + +1. Se estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, siga estas etapas: + + a. Antes de efetuar login no Dedicated GitHub Enterprise pela primeira vez, solicite ao administrador de região de sua empresa para incluir o seu ID do usuário em sua instância do +{{site.data.keyword.Bluemix_notm}} Dedicated a partir de seu registro do usuário usando LDAP. Para obter informações sobre como configurar a sua conta do {{site.data.keyword.ghe_short}}, +consulte [Usando o Dedicated GitHub Enterprise (O link é aberto em uma nova janela)](../services/ghededicated/index.html){: new_window}. + + b. Na seção Integrações configuráveis, clique em **{{site.data.keyword.ghe_short}}**. + + c. Revise o nome padrão para o novo repositório do {{site.data.keyword.ghe_short}}. Se necessário, mude o nome do novo repositório. A imagem a seguir mostra um exemplo de um repositório que +é clonado a partir de um repositório de amostra. É possível usar um repositório existente ou um novo repositório. Para usar um repositório novo, é possível criar um repositório vazio, clonar um repositório +ou bifurcar um repositório. + ![Locais de repositório padrão](images/toolchain_ghe_config.png) + +1. Se você tiver uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Public e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como alternativa, na página Visão geral de seu aplicativo, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique em **Integrações de ferramenta**. Se você estiver usando uma cadeia de ferramentas no {{site.data.keyword.Bluemix_notm}} Dedicated, no Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em +seguida, clique em **Integrações de ferramenta**. +1. Clique no botão de inclusão (+). +1. Na seção Integrações de ferramentas, clique em **{{site.data.keyword.ghe_short}}**. +1. Se você tiver um repositório do {{site.data.keyword.ghe_short}} que deseja usar, digite a URL para o repositório. Para o tipo de repositório, clique em +**Existente**. +1. Se você deseja usar um novo repositório do {{site.data.keyword.ghe_short}}, digite um nome para o repositório, digite a URL para o repositório que você está clonando ou bifurcando e +selecione o tipo de repositório: + + a. Para criar um repositório vazio, clique em **Novo**. + + b. Para criar uma cópia de um repositório, clique em **Clonar**. + + c. Para bifurcar um repositório de maneira que você possa contribuir com as mudanças por meio de solicitações de pull, clique em **Bifurcar**. + +1. Para usar o GitHub Issues para rastreamento de emissão, marque a caixa de seleção **Ativar o GitHub Issues**. +1. Clique em +**Criar integração**. +1. Clique no ladrilho para o repositório do {{site.data.keyword.ghe_short}} com o qual deseja trabalhar. A instância do +[{{site.data.keyword.Bluemix_notm}} Dedicated de sua empresa (O link é aberto em uma nova janela)](../dedicated/index.html#dedicated){: new_window} é aberta, na qual é possível +visualizar os conteúdos do repositório. + + **Dica**: é possível usar as ferramentas de gerenciamento de código-fonte integradas no Eclipse Orion {{site.data.keyword.webide}} para editar o repositório do +{{site.data.keyword.ghe_short}} e +implementar um aplicativo a partir de sua área de trabalho. + +1. Se você ativou o GitHub Issues, clique no ladrilho para o GitHub Issues. + + + +## Configurando uma ferramenta customizada (Outra Ferramenta) +{: #othertool} + +Se sua equipe usa uma ferramenta que não está incluída na lista de integração de cadeias de ferramentas, é possível integrar uma ferramenta customizada. + +Configure uma ferramenta customizada para que ela trabalhe com outras ferramentas em sua cadeia de ferramentas e esteja disponível para a sua equipe: +1. Se você estiver configurando essa integração de ferramenta conforme cria a cadeia de ferramentas, na seção Integrações configuráveis, clique em **Outra ferramenta**. + +1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como +alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em +seguida, clique em **Integrações de ferramenta**. +1. Clique no botão de inclusão (+). +1. Na seção Integrações de ferramenta, clique em **Outra Ferramenta**. +1. Digite o nome da ferramenta. +1. Selecione a fase do Ciclo de vida mais estreitamente associada com a ferramenta. A escolha da fase do Ciclo de Vida determina sob qual categoria sua ferramenta está listada na página Integração de Cadeia de ferramentas. +1. Inclua uma URL de ícone. O ícone aparecerá no cartão de integração da ferramenta. +1. Inclua uma URL de documentação. +1. Especifique um nome da instância da ferramenta. Por exemplo: Minha Ferramenta de Equipe. +1. Inclua uma URL da instância da ferramenta. Clicar no cartão de integração da ferramenta leva à URL que você listar para a instância da ferramenta. +1. Inclua uma descrição da sua ferramenta. +1. (Avançado) Inclua propriedades adicionais se necessário. Por exemplo, liste qualquer informação ou atributos que são necessários para integrar sua ferramenta com outras ferramentas em sua cadeia de ferramentas. +1. Clique em +**Criar integração**. + +## Configurando o PagerDuty +{: #pagerduty} + +O PagerDuty integra dados de diversos sistemas de monitoramento em uma única visualização. Quando um problema ocorre, o PagerDuty +assegura que o membro da equipe que melhor se adapta para corrigi-lo no momento seja notificado. Se o membro da equipe não responder ao problema, as escaladas poderão ser configuradas para roteá-lo para engenheiros secundários ou gerenciadores de operações. + +Configure o PagerDuty para enviar notificações quando as falhas de estágio de pipeline ocorrerem para que você possa corrigir problemas mais rapidamente e reduzir o tempo de inatividade: + +1. Se você estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, na seção Integrações configuráveis, clique em **PagerDuty**. +1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como +alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em +seguida, clique em **Integrações de ferramenta**. +1. Clique no botão de inclusão (+). +1. Na seção Integrações de ferramenta, clique em **PagerDuty** +1. Digite o nome do site PagerDuty associado à sua conta PagerDuty. Se você não tiver uma conta do PagerDuty, [registre-se em uma (o link é aberto em uma nova janela)](https://signup.pagerduty.com/accounts/new){: new_window}. +1. Digite a chave de acesso API para sua conta PagerDuty. Para obter instruções para localizar a chave, consulte [Autenticação de API (O link é +aberto em uma nova janela)](https://signup.pagerduty.com/accounts/new){: new_window}. +1. Digite o nome de seu serviço PagerDuty. +1. Digite o endereço de e-mail para o contato PagerDuty primário. +1. Digite o número do telefone para o contato PagerDuty primário. +1. Clique em +**Criar integração**. +1. Clique no ladrilho para o PagerDuty para acessar o pagerduty.com. É possível visualizar os eventos associados ao serviço PagerDuty +que você especificou quando configurou esta integração de ferramenta para sua cadeia de ferramentas. + +Para saber mais, consulte [PagerDuty (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}. + + +## Configurando o Sauce Labs +{: #saucelabs} + +O Sauce Labs executa testes de unidade funcional. Quando o suíte de testes do Sauce Labs é configurado como uma tarefa de teste no +{{site.data.keyword.deliverypipeline}}, o suíte de testes pode executar testes em relação a seu app da web ou móvel como parte de seu +processo de entrega contínua. Esses testes podem fornecer um controle de fluxo valioso para seus projetos, atuando como gates para impedir a +implementação de um código ruim. + +Configure o Sauce Labs para executar testes funcionais automatizados em múltiplos sistemas operacionais e navegadores para que possa emular a +forma que um usuário pode usar um website ou um aplicativo: + +1. Se você estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, na seção Integrações configuráveis, clique em **Sauce Labs**. +1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como +alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em +seguida, clique em **Integrações de ferramenta**. +1. Clique no botão de inclusão (+). +1. Na seção Integrações de ferramenta, clique em **Sauce Labs**. +1. Digite o nome de usuário associado à sua conta Sauce Labs. É possível [localizar o seu nome do usuário na mensagem de boas-vindas na parte superior de sua +página de conta dos Sauce Labs (O link é aberto em uma nova janela)](https://saucelabs.com/account){: new_window}. +1. Digite a chave de acesso para sua conta Sauce Labs. É possível [localizar a chave em sua página de conta dos Sauce Labs (O link é aberto em uma nova +janela)](https://saucelabs.com/account){: new_window}. +1. Clique em +**Criar integração**. +1. Clique no ladrilho para o Sauce Labs para acessar saucelabs.com e visualizar a atividade de teste para a cadeia de ferramentas. + + **Dica**: se você incluiu uma tarefa de teste Sauce Labs no {{site.data.keyword.deliverypipeline}}, é possível selecionar a instância de serviço. + +Para saber mais, consulte [Sauce Labs (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}. + + +## Configurando o Slack +{: #slack} + +**Importante**: as notificações que são postadas nos canais públicos Slack estão visíveis a todos na equipe. Lembre-se +que você é responsável pelo conteúdo que postar. + +O Slack é um sistema de mensagens e um sistema de notificação tempo real baseados na nuvem. O Slack fornece o bate-papo persistente, que é uma alternativa interativa ao e-mail para a colaboração da equipe. É +possível se comunicar com sua equipe em um canal dedicado ou em um conjunto de canais diretamente relacionado ao seu trabalho. Também é possível +compartilhar arquivos e imagens por meio dos canais ou em mensagens diretas entre duas ou mais pessoas. As comunicações nas mensagens diretas e nos +canais são retidas para que seja possível procurá-las. + +Configure o Slack para recuperar notificações sobre sua cadeia de ferramentas a partir das integrações de ferramenta, como atividades de +teste e de implementação: + +1. Se você estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, na seção Integrações +configuráveis, clique em **Slack**. +1. Se você tiver uma cadeia de ferramentas e estiver incluindo essa integração de ferramenta nela, no painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como +alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em +seguida, clique em **Integrações de ferramenta**. +1. Clique no botão de inclusão (+). +1. Na seção Integrações de ferramenta, clique em **Slack**. +1. Digite o token de autenticação API para sua conta Slack. Deve-se usar um token de acesso total gerado para se autenticar com o Slack. Para obter instruções para localizar o token, consulte +[Autenticação de folga (O link é aberto em uma nova janela)](https://api.slack.com/web#authentication){: new_window}. +1. Digite o nome do canal Slack para o qual deseja que as notificações sejam enviadas. Se o canal que especificar não existir, ele será criado. Se o canal foi arquivado, ele será reativado. +1. Clique em +**Criar integração**. +1. Clique no ladrilho para o Slack. É possível visualizar todas as atividades para sua cadeia de ferramentas no canal Slack configurado. + +Para saber mais, consulte [Folga (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}. + + + + + + + + diff --git a/toolchains/nl/pt/BR/toolchains_overview.md b/toolchains/nl/pt/BR/toolchains_overview.md index 8c3984d5f..a7d3c610b 100644 --- a/toolchains/nl/pt/BR/toolchains_overview.md +++ b/toolchains/nl/pt/BR/toolchains_overview.md @@ -1,217 +1,217 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Introdução às cadeias de ferramentas (Beta) -{: #toolchains_getting_started} - -Última atualização: 7 de outubro de 2016 -{: .last-updated} - -Cadeias de ferramentas estão disponíveis nos ambientes Public e Dedicated no {{site.data.keyword.Bluemix}}. É possível criar uma cadeia de ferramentas de duas formas: usar um modelo para criar uma cadeia de ferramentas ou criar uma cadeia de -ferramentas a partir de um app. No {{site.data.keyword.Bluemix_notm}} Public, cadeias de ferramentas estão disponíveis somente na região sul dos EUA. -{: shortdesc} - -##Introdução às cadeias de ferramentas: Público -{: #getting_started_public} - -**Nota:** Certifique-se de estar trabalhando na experiência New Bluemix verificando o banner na parte superior. - - * Se você vir uma mensagem sobre testar o novo Bluemix, estará trabalhando na experiência Classic Bluemix. Clique no link para abrir a experiência New Bluemix. - * Se você não vir essa mensagem, já estará trabalhando na experiência New Bluemix. - -Cada cadeia de ferramentas é associada com uma organização específica (org) e qualquer usuário que for um membro dessa organização poderá acessar as suas cadeias de ferramentas associadas. Antes de -você criar uma cadeia de ferramentas, certifique-se de estar trabalhando na organização na qual deseja criar a cadeia de ferramentas. A organização na qual você está trabalhando atualmente está exibida na barra de menus. Para alternar para outra organização, clique na organização na barra de menus e, em seguida, selecione a organização para a qual você deseja alternar. - -###Criando uma cadeia de ferramentas com base em um modelo -{: #creating_a_toolchain_from_a_template} - -É possível usar um modelo como um ponto de início para criar uma cadeia de ferramentas que inclua um conjunto específico de integrações de ferramentas. - -1. Se você estiver criando a sua primeira cadeia de ferramentas, certifique-se de que as cadeias de ferramentas estejam ativadas em sua organização: - 1. Abra o painel DevOps e clique na página **Cadeias de ferramentas**. - 2. Se o botão **Ativar cadeias de ferramentas** for mostrado, clique nele e siga os avisos para criar a sua cadeia de ferramentas. - 3. Se o botão **Ativar cadeias de ferramentas** não for mostrado, as cadeias de ferramentas já estarão ativadas. Continue -na etapa 2. -1. No painel DevOps, na página **Cadeias de ferramentas**, clique no botão (+) para criar uma cadeia de ferramentas. -1. Clique em um modelo da cadeia de ferramentas. Por exemplo, para usar uma amostra de armazenamento on-line para criar a cadeia de ferramentas, clique em **Cadeia de ferramentas de -microsserviços**. -1. Na página de criação da cadeia de ferramentas, revise o diagrama da cadeia de ferramentas que estiver prestes a criar. O diagrama -mostrará cada integração de ferramenta em sua fase de ciclo de vida na cadeia de ferramentas. O diagrama na imagem a seguir é um exemplo. Ao criar -uma cadeia de ferramentas, o diagrama mostrará cada integração de ferramenta que é parte da cadeia de ferramentas. -![Diagrama da cadeia de ferramentas](images/toolchain_diagram.png) - -1. Revise as informações padrão para as configurações da cadeia de ferramentas. O nome da cadeia de ferramentas as identifica em -{{site.data.keyword.Bluemix_notm}}. Se você já tiver uma cadeia de ferramentas com esse nome ou se desejar usar um nome diferente, mude o nome -da cadeia de ferramentas. -1. Na seção Integrações configuráveis, selecione cada integração de ferramenta que deseja configurar para sua cadeia de ferramentas. Algumas integrações de ferramentas não requerem qualquer -configuração. Para obter informações sobre configurar integrações de ferramentas, consulte [Configurando integrações de ferramentas (O link é aberto em -uma nova janela)](../toolchains/toolchains_integrations.html){: new_window}. -1. Clique em **Criar**. Várias etapas são executadas automaticamente para configurar sua cadeia de ferramentas: - - * A cadeia de ferramentas é criada. - * Se você tiver configurado a integração de ferramenta Pipeline de entrega, os pipelines serão acionados. - * Se você tiver configurado a integração de ferramenta Sauce Labs, a integração Sauce Labs será configurada para incluir tarefas nos -pipelines e executar testes. - * Se você tiver configurado a integração de ferramenta PagerDuty, a integração PagerDuty será configurada para enviar notificações -ao canal configurado no Slack. Essas notificações indicam quando ocorre um problema. - * Se você tiver configurado a integração de ferramenta Slack, a integração Slack será configurada para enviar notificações ao canal -configurado no Slack. Essas notificações indicam o progresso da implementação; por exemplo, `Conectado com projeto XYZ`, -`Pipeline configurado` e `Estágio 'construção' iniciado`. - * Se você tiver configurado a integração de ferramenta -GitHub, o repo GitHub de amostra é clonado na conta do GitHub. - - -###Criando uma cadeia de ferramentas com base em um aplicativo -{: #creating_a_toolchain_from_an_app} - -É possível criar uma cadeia de ferramentas a partir de seu aplicativo. A cadeia de -ferramentas pode suportar desenvolvimento, implementação e monitoramento contínuos e mais, e é associada ao seu app. Cada app pode ser -associado a uma cadeia de ferramentas. Ao enviar por push mudanças no -repo GitHub da cadeia de ferramentas, o pipeline automaticamente -constrói e implementa o app. - -1. Se você estiver criando a sua primeira cadeia de ferramentas, certifique-se de que as cadeias de ferramentas estejam ativadas em sua organização: - 1. Abra o painel DevOps e clique na página **Cadeias de ferramentas**. - 2. Se o botão **Ativar cadeias de ferramentas** for mostrado, clique nele e siga os avisos para criar a sua cadeia de ferramentas. - 3. Se o botão **Ativar cadeias de ferramentas** não for mostrado, as cadeias de ferramentas já estarão ativadas. Continue -na etapa 2. -1. Na Página de visão geral de seu app, no quadro Entrega Contínua, clique em **Ativar**. Como alternativa, no {{site.data.keyword.Bluemix_notm}} Classic -Experience, no canto superior direito de sua página Visão geral do aplicativo, clique em **Incluir cadeia de ferramentas**. Seu app é configurado para entrega contínua a partir -de um novo repo GitHub que é preenchido com o código de início do -iniciador. -1. Na página de criação da cadeia de ferramentas, revise o diagrama da cadeia de ferramentas que estiver prestes a criar. O diagrama -mostrará cada integração de ferramenta em sua fase de ciclo de vida na cadeia de ferramentas. -1. Revise as informações padrão para as configurações da cadeia de ferramentas. O nome da cadeia de ferramentas as identifica em -{{site.data.keyword.Bluemix_notm}}. Se você já tiver uma cadeia de ferramentas com esse nome ou se desejar usar um nome diferente, mude o nome -da cadeia de ferramentas. -1. Na seção Integrações configuráveis, selecione cada integração de ferramenta que deseja configurar para sua cadeia de ferramentas. Algumas integrações de ferramentas não requerem qualquer -configuração. Para obter informações sobre configurar integrações de ferramentas, consulte [Configurando integrações de ferramentas (O link é aberto em -uma nova janela)](../toolchains/toolchains_integrations.html){: new_window}. -1. Clique em **Criar**. Várias etapas são executadas automaticamente para configurar sua cadeia de ferramentas: - - * A cadeia de ferramentas é criada. - * Se você tiver configurado a integração de ferramenta Pipeline de entrega, os pipelines serão acionados. - * Se você tiver configurado a integração de ferramenta Sauce Labs, a integração Sauce Labs será configurada para incluir tarefas nos -pipelines e executar testes. - * Se você tiver configurado a integração de ferramenta PagerDuty, a integração PagerDuty será configurada para enviar notificações -ao canal configurado no Slack. Essas notificações indicam quando ocorre um problema. - * Se você tiver configurado a integração de ferramenta Slack, a integração Slack será configurada para enviar notificações ao canal -configurado no Slack. Essas notificações indicam o progresso da implementação; por exemplo, `Conectado com projeto XYZ`, -`Pipeline configurado` e `Estágio 'construção' iniciado`. - * Se você tiver configurado a integração de ferramenta -GitHub, o repo GitHub de amostra é clonado na conta do GitHub. - - -##Introdução às cadeias de ferramentas: Dedicado -{: #getting_started_dedicated} - -Cada cadeia de ferramentas é associada com uma organização específica (org) e qualquer usuário que for um membro dessa organização poderá acessar as suas cadeias de ferramentas associadas. Antes de -criar uma cadeia de ferramentas, clique no ícone **{{site.data.keyword.avatar}}** ![ícone Avatar](../icons/i-avatar-icon.svg) na barra de menus para -abrir o widget de Conta e Suporte e visualizar a organização na qual você está trabalhando. Se essa organização não for a organização na qual você deseja criar a cadeia de ferramentas, alterne para outra -organização. - -###Criando uma cadeia de ferramentas com base em um modelo -{: #creating_a_toolchain_from_a_template_dedicated} - -É possível usar um modelo como um ponto de início para criar uma cadeia de ferramentas que inclua um conjunto específico de integrações de ferramentas. - -1. Se você estiver criando a sua primeira cadeia de ferramentas, certifique-se de que as cadeias de ferramentas estejam ativadas em sua organização: - 1. Abra o painel do DevOps e clique na guia **Cadeias de ferramentas**. - 2. Se o botão **Ativar cadeias de ferramentas** for mostrado, clique nele e siga os avisos para criar a sua cadeia de ferramentas. - 3. Se o botão **Ativar cadeias de ferramentas** não for mostrado, as cadeias de ferramentas já estarão ativadas. Continue -na etapa 2. -1. No painel do {{site.data.keyword.Bluemix_notm}}, na guia **DEVOPS**, clique no botão incluir (+) para criar uma cadeia de ferramentas. -1. Clique em um modelo da cadeia de ferramentas. Por exemplo, para criar uma cadeia de ferramentas simples para implementar um novo aplicativo Cloud Foundry, clique em **Cadeia de -ferramentas simples do Cloud Foundry**. -1. Na página de criação da cadeia de ferramentas, revise o diagrama da cadeia de ferramentas que estiver prestes a criar. O diagrama -mostrará cada integração de ferramenta em sua fase de ciclo de vida na cadeia de ferramentas. O diagrama na imagem a seguir é um exemplo. Ao criar -uma cadeia de ferramentas, o diagrama mostrará cada integração de ferramenta que é parte da cadeia de ferramentas. -![Diagrama de cadeia de ferramentas dedicada](images/toolchain_dedicated_diagram.png) - -1. Revise as informações padrão para as configurações da cadeia de ferramentas. O nome da cadeia de ferramentas as identifica em -{{site.data.keyword.Bluemix_notm}}. Se você já tiver uma cadeia de ferramentas com esse nome ou se desejar usar um nome diferente, mude o nome -da cadeia de ferramentas. -1. Na seção Integrações configuráveis, selecione cada integração de ferramenta que deseja configurar para sua cadeia de ferramentas. Algumas integrações de ferramentas não requerem qualquer -configuração. Para obter informações sobre configurar integrações de ferramentas, consulte [Configurando integrações de ferramentas (O link é aberto em -uma nova janela)](../toolchains/toolchains_integrations.html){: new_window}. -1. Clique em **Criar**. Várias etapas são executadas automaticamente para configurar sua cadeia de ferramentas: - - * A cadeia de ferramentas é criada. - * Se você tiver configurado a integração de ferramenta Pipeline de entrega, os pipelines serão acionados. - * Se você tiver configurado a integração de ferramenta do GitHub Enterprise, o repositório GitHub Enterprise será clonado na sua conta do GitHub Enterprise. - - -###Criando uma cadeia de ferramentas com base em um aplicativo -{: #creating_a_toolchain_from_an_app_dedicated} - -É possível criar uma cadeia de ferramentas a partir de seu aplicativo. A cadeia de -ferramentas pode suportar desenvolvimento, implementação e monitoramento contínuos e mais, e é associada ao seu app. Cada app pode ser -associado a uma cadeia de ferramentas. Quando você envia por push as mudanças no repositório GitHub Enterprise da cadeia de ferramentas, a pipeline automaticamente constrói e implementa o aplicativo. - -1. Se você estiver criando a sua primeira cadeia de ferramentas, certifique-se de que as cadeias de ferramentas estejam ativadas em sua organização: - 1. Abra o painel do DevOps e clique na guia **Cadeias de ferramentas**. - 2. Se o botão **Ativar cadeias de ferramentas** for mostrado, clique nele e siga os avisos para criar a sua cadeia de ferramentas. - 3. Se o botão **Ativar cadeias de ferramentas** não for mostrado, as cadeias de ferramentas já estarão ativadas. Continue -na etapa 2. -1. No canto superior direito de sua página Visão geral do aplicativo, clique em **Incluir cadeia de ferramentas**. O seu aplicativo é configurado para entrega contínua a partir -de um novo repositório GitHub Enterprise que é preenchido com o código de início do aplicativo. -1. Na página de criação da cadeia de ferramentas, revise o diagrama da cadeia de ferramentas que estiver prestes a criar. O diagrama -mostrará cada integração de ferramenta em sua fase de ciclo de vida na cadeia de ferramentas. -1. Revise as informações padrão para as configurações da cadeia de ferramentas. O nome da cadeia de ferramentas as identifica em -{{site.data.keyword.Bluemix_notm}}. Se você já tiver uma cadeia de ferramentas com esse nome ou se desejar usar um nome diferente, mude o nome -da cadeia de ferramentas. -1. Na seção Integrações configuráveis, selecione cada integração de ferramenta que deseja configurar para sua cadeia de ferramentas. Algumas integrações de ferramentas não requerem qualquer -configuração. Para obter informações sobre configurar integrações de ferramentas, consulte [Configurando integrações de ferramentas (O link é aberto em -uma nova janela)](../toolchains/toolchains_integrations.html){: new_window}. -1. Clique em **Criar**. Várias etapas são executadas automaticamente para configurar sua cadeia de ferramentas: - - * A cadeia de ferramentas é criada. - * Se você tiver configurado a integração de ferramenta Pipeline de entrega, os pipelines serão acionados. - * Se você tiver configurado a integração de ferramenta do GitHub Enterprise, o repositório GitHub Enterprise será clonado na sua conta do GitHub Enterprise. - - -##Visualizando uma cadeia de ferramentas -{: #viewing_a_toolchain} - -Após você configurar a cadeia de ferramentas e as suas integrações de ferramentas, será possível visualizar uma representação visual da cadeia de ferramentas na página Integrações de ferramentas. - -* Se você usar o {{site.data.keyword.Bluemix_notm}} Public, no painel DevOps, na página **Cadeias de ferramentas**, clique em uma cadeia de ferramentas para -abrir a sua página de Integrações de ferramenta. Como alternativa, -na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique -em **Integrações de ferramenta**. - -* Se você usar o {{site.data.keyword.Bluemix_notm}} Dedicated, no Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. - -* Para acessar uma integração de ferramenta que estiver em sua cadeia de ferramentas, clique no ladrilho da ferramenta. - - **Dica**: se você tiver mais de um repositório GitHub ou GitHub Enterprise, poderá ter múltiplos ladrilhos para a mesma integração de ferramenta porque cada repositório é -representado por seu próprio ladrilho. - - - - - -# Links relacionados -{: #rellinks} - -## Tutoriais e amostras -{: #samples} - -* [Crie um aplicativo com três microsserviços (Beta) (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} -* [Crie uma cadeia de ferramentas a partir de um modelo em {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (o link é aberto em uma nova janela)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} -* [Crie uma cadeia de ferramentas a partir de um app em {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (o link é aberto em uma nova janela)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} - -## Links relacionados -{: #general} - -* [Cadeia de ferramentas de microsserviços (Beta) (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} -* [Cadeia de ferramentas simples (Beta) (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} -* [IBM Bluemix Garage Method (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method){:new_window} +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Introdução às cadeias de ferramentas (Beta) +{: #toolchains_getting_started} + +Última atualização: 7 de outubro de 2016 +{: .last-updated} + +Cadeias de ferramentas estão disponíveis nos ambientes Public e Dedicated no {{site.data.keyword.Bluemix}}. É possível criar uma cadeia de ferramentas de duas formas: usar um modelo para criar uma cadeia de ferramentas ou criar uma cadeia de +ferramentas a partir de um app. No {{site.data.keyword.Bluemix_notm}} Public, cadeias de ferramentas estão disponíveis somente na região sul dos EUA. +{: shortdesc} + +## Introdução às cadeias de ferramentas: Público +{: #getting_started_public} + +**Nota:** Certifique-se de estar trabalhando na experiência New Bluemix verificando o banner na parte superior. + + * Se você vir uma mensagem sobre testar o novo Bluemix, estará trabalhando na experiência Classic Bluemix. Clique no link para abrir a experiência New Bluemix. + * Se você não vir essa mensagem, já estará trabalhando na experiência New Bluemix. + +Cada cadeia de ferramentas é associada com uma organização específica (org) e qualquer usuário que for um membro dessa organização poderá acessar as suas cadeias de ferramentas associadas. Antes de +você criar uma cadeia de ferramentas, certifique-se de estar trabalhando na organização na qual deseja criar a cadeia de ferramentas. A organização na qual você está trabalhando atualmente está exibida na barra de menus. Para alternar para outra organização, clique na organização na barra de menus e, em seguida, selecione a organização para a qual você deseja alternar. + +### Criando uma cadeia de ferramentas com base em um modelo +{: #creating_a_toolchain_from_a_template} + +É possível usar um modelo como um ponto de início para criar uma cadeia de ferramentas que inclua um conjunto específico de integrações de ferramentas. + +1. Se você estiver criando a sua primeira cadeia de ferramentas, certifique-se de que as cadeias de ferramentas estejam ativadas em sua organização: + 1. Abra o painel DevOps e clique na página **Cadeias de ferramentas**. + 2. Se o botão **Ativar cadeias de ferramentas** for mostrado, clique nele e siga os avisos para criar a sua cadeia de ferramentas. + 3. Se o botão **Ativar cadeias de ferramentas** não for mostrado, as cadeias de ferramentas já estarão ativadas. Continue +na etapa 2. +1. No painel DevOps, na página **Cadeias de ferramentas**, clique no botão (+) para criar uma cadeia de ferramentas. +1. Clique em um modelo da cadeia de ferramentas. Por exemplo, para usar uma amostra de armazenamento on-line para criar a cadeia de ferramentas, clique em **Cadeia de ferramentas de +microsserviços**. +1. Na página de criação da cadeia de ferramentas, revise o diagrama da cadeia de ferramentas que estiver prestes a criar. O diagrama +mostrará cada integração de ferramenta em sua fase de ciclo de vida na cadeia de ferramentas. O diagrama na imagem a seguir é um exemplo. Ao criar +uma cadeia de ferramentas, o diagrama mostrará cada integração de ferramenta que é parte da cadeia de ferramentas. +![Diagrama da cadeia de ferramentas](images/toolchain_diagram.png) + +1. Revise as informações padrão para as configurações da cadeia de ferramentas. O nome da cadeia de ferramentas as identifica em +{{site.data.keyword.Bluemix_notm}}. Se você já tiver uma cadeia de ferramentas com esse nome ou se desejar usar um nome diferente, mude o nome +da cadeia de ferramentas. +1. Na seção Integrações configuráveis, selecione cada integração de ferramenta que deseja configurar para sua cadeia de ferramentas. Algumas integrações de ferramentas não requerem qualquer +configuração. Para obter informações sobre configurar integrações de ferramentas, consulte [Configurando integrações de ferramentas (O link é aberto em +uma nova janela)](../toolchains/toolchains_integrations.html){: new_window}. +1. Clique em **Criar**. Várias etapas são executadas automaticamente para configurar sua cadeia de ferramentas: + + * A cadeia de ferramentas é criada. + * Se você tiver configurado a integração de ferramenta Pipeline de entrega, os pipelines serão acionados. + * Se você tiver configurado a integração de ferramenta Sauce Labs, a integração Sauce Labs será configurada para incluir tarefas nos +pipelines e executar testes. + * Se você tiver configurado a integração de ferramenta PagerDuty, a integração PagerDuty será configurada para enviar notificações +ao canal configurado no Slack. Essas notificações indicam quando ocorre um problema. + * Se você tiver configurado a integração de ferramenta Slack, a integração Slack será configurada para enviar notificações ao canal +configurado no Slack. Essas notificações indicam o progresso da implementação; por exemplo, `Conectado com projeto XYZ`, +`Pipeline configurado` e `Estágio 'construção' iniciado`. + * Se você tiver configurado a integração de ferramenta +GitHub, o repo GitHub de amostra é clonado na conta do GitHub. + + +### Criando uma cadeia de ferramentas com base em um aplicativo +{: #creating_a_toolchain_from_an_app} + +É possível criar uma cadeia de ferramentas a partir de seu aplicativo. A cadeia de +ferramentas pode suportar desenvolvimento, implementação e monitoramento contínuos e mais, e é associada ao seu app. Cada app pode ser +associado a uma cadeia de ferramentas. Ao enviar por push mudanças no +repo GitHub da cadeia de ferramentas, o pipeline automaticamente +constrói e implementa o app. + +1. Se você estiver criando a sua primeira cadeia de ferramentas, certifique-se de que as cadeias de ferramentas estejam ativadas em sua organização: + 1. Abra o painel DevOps e clique na página **Cadeias de ferramentas**. + 2. Se o botão **Ativar cadeias de ferramentas** for mostrado, clique nele e siga os avisos para criar a sua cadeia de ferramentas. + 3. Se o botão **Ativar cadeias de ferramentas** não for mostrado, as cadeias de ferramentas já estarão ativadas. Continue +na etapa 2. +1. Na Página de visão geral de seu app, no quadro Entrega Contínua, clique em **Ativar**. Como alternativa, no {{site.data.keyword.Bluemix_notm}} Classic +Experience, no canto superior direito de sua página Visão geral do aplicativo, clique em **Incluir cadeia de ferramentas**. Seu app é configurado para entrega contínua a partir +de um novo repo GitHub que é preenchido com o código de início do +iniciador. +1. Na página de criação da cadeia de ferramentas, revise o diagrama da cadeia de ferramentas que estiver prestes a criar. O diagrama +mostrará cada integração de ferramenta em sua fase de ciclo de vida na cadeia de ferramentas. +1. Revise as informações padrão para as configurações da cadeia de ferramentas. O nome da cadeia de ferramentas as identifica em +{{site.data.keyword.Bluemix_notm}}. Se você já tiver uma cadeia de ferramentas com esse nome ou se desejar usar um nome diferente, mude o nome +da cadeia de ferramentas. +1. Na seção Integrações configuráveis, selecione cada integração de ferramenta que deseja configurar para sua cadeia de ferramentas. Algumas integrações de ferramentas não requerem qualquer +configuração. Para obter informações sobre configurar integrações de ferramentas, consulte [Configurando integrações de ferramentas (O link é aberto em +uma nova janela)](../toolchains/toolchains_integrations.html){: new_window}. +1. Clique em **Criar**. Várias etapas são executadas automaticamente para configurar sua cadeia de ferramentas: + + * A cadeia de ferramentas é criada. + * Se você tiver configurado a integração de ferramenta Pipeline de entrega, os pipelines serão acionados. + * Se você tiver configurado a integração de ferramenta Sauce Labs, a integração Sauce Labs será configurada para incluir tarefas nos +pipelines e executar testes. + * Se você tiver configurado a integração de ferramenta PagerDuty, a integração PagerDuty será configurada para enviar notificações +ao canal configurado no Slack. Essas notificações indicam quando ocorre um problema. + * Se você tiver configurado a integração de ferramenta Slack, a integração Slack será configurada para enviar notificações ao canal +configurado no Slack. Essas notificações indicam o progresso da implementação; por exemplo, `Conectado com projeto XYZ`, +`Pipeline configurado` e `Estágio 'construção' iniciado`. + * Se você tiver configurado a integração de ferramenta +GitHub, o repo GitHub de amostra é clonado na conta do GitHub. + + +## Introdução às cadeias de ferramentas: Dedicado +{: #getting_started_dedicated} + +Cada cadeia de ferramentas é associada com uma organização específica (org) e qualquer usuário que for um membro dessa organização poderá acessar as suas cadeias de ferramentas associadas. Antes de +criar uma cadeia de ferramentas, clique no ícone **{{site.data.keyword.avatar}}** ![ícone Avatar](../icons/i-avatar-icon.svg) na barra de menus para +abrir o widget de Conta e Suporte e visualizar a organização na qual você está trabalhando. Se essa organização não for a organização na qual você deseja criar a cadeia de ferramentas, alterne para outra +organização. + +### Criando uma cadeia de ferramentas com base em um modelo +{: #creating_a_toolchain_from_a_template_dedicated} + +É possível usar um modelo como um ponto de início para criar uma cadeia de ferramentas que inclua um conjunto específico de integrações de ferramentas. + +1. Se você estiver criando a sua primeira cadeia de ferramentas, certifique-se de que as cadeias de ferramentas estejam ativadas em sua organização: + 1. Abra o painel do DevOps e clique na guia **Cadeias de ferramentas**. + 2. Se o botão **Ativar cadeias de ferramentas** for mostrado, clique nele e siga os avisos para criar a sua cadeia de ferramentas. + 3. Se o botão **Ativar cadeias de ferramentas** não for mostrado, as cadeias de ferramentas já estarão ativadas. Continue +na etapa 2. +1. No painel do {{site.data.keyword.Bluemix_notm}}, na guia **DEVOPS**, clique no botão incluir (+) para criar uma cadeia de ferramentas. +1. Clique em um modelo da cadeia de ferramentas. Por exemplo, para criar uma cadeia de ferramentas simples para implementar um novo aplicativo Cloud Foundry, clique em **Cadeia de +ferramentas simples do Cloud Foundry**. +1. Na página de criação da cadeia de ferramentas, revise o diagrama da cadeia de ferramentas que estiver prestes a criar. O diagrama +mostrará cada integração de ferramenta em sua fase de ciclo de vida na cadeia de ferramentas. O diagrama na imagem a seguir é um exemplo. Ao criar +uma cadeia de ferramentas, o diagrama mostrará cada integração de ferramenta que é parte da cadeia de ferramentas. +![Diagrama de cadeia de ferramentas dedicada](images/toolchain_dedicated_diagram.png) + +1. Revise as informações padrão para as configurações da cadeia de ferramentas. O nome da cadeia de ferramentas as identifica em +{{site.data.keyword.Bluemix_notm}}. Se você já tiver uma cadeia de ferramentas com esse nome ou se desejar usar um nome diferente, mude o nome +da cadeia de ferramentas. +1. Na seção Integrações configuráveis, selecione cada integração de ferramenta que deseja configurar para sua cadeia de ferramentas. Algumas integrações de ferramentas não requerem qualquer +configuração. Para obter informações sobre configurar integrações de ferramentas, consulte [Configurando integrações de ferramentas (O link é aberto em +uma nova janela)](../toolchains/toolchains_integrations.html){: new_window}. +1. Clique em **Criar**. Várias etapas são executadas automaticamente para configurar sua cadeia de ferramentas: + + * A cadeia de ferramentas é criada. + * Se você tiver configurado a integração de ferramenta Pipeline de entrega, os pipelines serão acionados. + * Se você tiver configurado a integração de ferramenta do GitHub Enterprise, o repositório GitHub Enterprise será clonado na sua conta do GitHub Enterprise. + + +### Criando uma cadeia de ferramentas com base em um aplicativo +{: #creating_a_toolchain_from_an_app_dedicated} + +É possível criar uma cadeia de ferramentas a partir de seu aplicativo. A cadeia de +ferramentas pode suportar desenvolvimento, implementação e monitoramento contínuos e mais, e é associada ao seu app. Cada app pode ser +associado a uma cadeia de ferramentas. Quando você envia por push as mudanças no repositório GitHub Enterprise da cadeia de ferramentas, a pipeline automaticamente constrói e implementa o aplicativo. + +1. Se você estiver criando a sua primeira cadeia de ferramentas, certifique-se de que as cadeias de ferramentas estejam ativadas em sua organização: + 1. Abra o painel do DevOps e clique na guia **Cadeias de ferramentas**. + 2. Se o botão **Ativar cadeias de ferramentas** for mostrado, clique nele e siga os avisos para criar a sua cadeia de ferramentas. + 3. Se o botão **Ativar cadeias de ferramentas** não for mostrado, as cadeias de ferramentas já estarão ativadas. Continue +na etapa 2. +1. No canto superior direito de sua página Visão geral do aplicativo, clique em **Incluir cadeia de ferramentas**. O seu aplicativo é configurado para entrega contínua a partir +de um novo repositório GitHub Enterprise que é preenchido com o código de início do aplicativo. +1. Na página de criação da cadeia de ferramentas, revise o diagrama da cadeia de ferramentas que estiver prestes a criar. O diagrama +mostrará cada integração de ferramenta em sua fase de ciclo de vida na cadeia de ferramentas. +1. Revise as informações padrão para as configurações da cadeia de ferramentas. O nome da cadeia de ferramentas as identifica em +{{site.data.keyword.Bluemix_notm}}. Se você já tiver uma cadeia de ferramentas com esse nome ou se desejar usar um nome diferente, mude o nome +da cadeia de ferramentas. +1. Na seção Integrações configuráveis, selecione cada integração de ferramenta que deseja configurar para sua cadeia de ferramentas. Algumas integrações de ferramentas não requerem qualquer +configuração. Para obter informações sobre configurar integrações de ferramentas, consulte [Configurando integrações de ferramentas (O link é aberto em +uma nova janela)](../toolchains/toolchains_integrations.html){: new_window}. +1. Clique em **Criar**. Várias etapas são executadas automaticamente para configurar sua cadeia de ferramentas: + + * A cadeia de ferramentas é criada. + * Se você tiver configurado a integração de ferramenta Pipeline de entrega, os pipelines serão acionados. + * Se você tiver configurado a integração de ferramenta do GitHub Enterprise, o repositório GitHub Enterprise será clonado na sua conta do GitHub Enterprise. + + +## Visualizando uma cadeia de ferramentas +{: #viewing_a_toolchain} + +Após você configurar a cadeia de ferramentas e as suas integrações de ferramentas, será possível visualizar uma representação visual da cadeia de ferramentas na página Integrações de ferramentas. + +* Se você usar o {{site.data.keyword.Bluemix_notm}} Public, no painel DevOps, na página **Cadeias de ferramentas**, clique em uma cadeia de ferramentas para +abrir a sua página de Integrações de ferramenta. Como alternativa, +na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique +em **Integrações de ferramenta**. + +* Se você usar o {{site.data.keyword.Bluemix_notm}} Dedicated, no Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. + +* Para acessar uma integração de ferramenta que estiver em sua cadeia de ferramentas, clique no ladrilho da ferramenta. + + **Dica**: se você tiver mais de um repositório GitHub ou GitHub Enterprise, poderá ter múltiplos ladrilhos para a mesma integração de ferramenta porque cada repositório é +representado por seu próprio ladrilho. + + + + + +# Links relacionados +{: #rellinks} + +## Tutoriais e amostras +{: #samples} + +* [Crie um aplicativo com três microsserviços (Beta) (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} +* [Crie uma cadeia de ferramentas a partir de um modelo em {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (o link é aberto em uma nova janela)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} +* [Crie uma cadeia de ferramentas a partir de um app em {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) (o link é aberto em uma nova janela)](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} + +## Links relacionados +{: #general} + +* [Cadeia de ferramentas de microsserviços (Beta) (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} +* [Cadeia de ferramentas simples (Beta) (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} +* [IBM Bluemix Garage Method (O link é aberto em uma nova janela)](https://www.ibm.com/devops/method){:new_window} diff --git a/toolchains/nl/pt/BR/toolchains_using.md b/toolchains/nl/pt/BR/toolchains_using.md index 74407f7f3..21729c134 100644 --- a/toolchains/nl/pt/BR/toolchains_using.md +++ b/toolchains/nl/pt/BR/toolchains_using.md @@ -1,112 +1,112 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Usando cadeias de ferramentas no {{site.data.keyword.Bluemix_notm}} Public -{: #toolchains-using} - -Última atualização: 7 de outubro de 2016 -{: .last-updated} - -É possível usar uma cadeia de ferramentas para ser produtivo em seu trabalho diário de desenvolvimento, implementação e operações. Após -configurar uma cadeia de ferramentas, é possível incluir, excluir ou configurar integrações de ferramenta e gerenciar acesso à cadeia de ferramentas. As cadeias de ferramentas estão disponíveis na região sul dos EUA somente. -{: shortdesc} - -**Nota**: Certifique-se de estar trabalhando na experiência New Bluemix verificando o banner na parte superior. - - * Se você vir uma mensagem sobre testar o novo Bluemix, estará trabalhando na experiência Classic Bluemix. Clique no link para abrir a experiência New Bluemix. - * Se você não vir essa mensagem, já estará trabalhando na experiência New Bluemix. - -## Configurando uma integração de ferramenta -{: #configuring_a_tool_integration} - -Se você adiou a configuração de uma integração de ferramenta quando criou uma cadeia de ferramentas, um botão **Configurar** será -mostrado em seu ladrilho. Se você configurou uma integração de ferramenta quando criou uma cadeia de ferramentas, será possível atualizar as definições de configuração. - -1. No painel DevOps, na página **Cadeias de ferramentas**, clique em uma cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de -ferramentas** e, em seguida, clique em **Integrações de ferramenta**. -1. Se precisar configurar uma integração de ferramenta pela primeira vez, em seu ladrilho, clique em **Configurar**. - - ![Botão de configuração -](images/toolchain_tile_configure.png) - - Quando tiver finalizado a configuração da integração de ferramenta, clique em **Salvar integração**. - -1. Se precisar atualizar uma configuração de integração de ferramenta, em seu ladrilho, clique no menu para acessar as opções de configuração. - - ![Menu Configuração](images/toolchain_tile_menu.png) - - Quando tiver finalizado a atualização das configurações, clique em **Salvar integração**. - -## Incluindo uma integração de ferramenta -{: #adding_a_tool_integration} - -É possível incluir e configurar integrações de ferramenta para sua cadeia de ferramentas. - -1. No painel DevOps, na página **Cadeias de ferramentas**, clique em uma cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de -ferramentas** e, em seguida, clique em **Integrações de ferramenta**. -1. Para ver uma lista de integrações de ferramenta para incluir, clique no botão de inclusão (+). -1. Clique em uma integração de ferramenta que deseja incluir. -1. Insira quaisquer informações necessárias para configurar a integração de ferramenta. -1. Clique em **Criar integração** para incluir a integração de ferramenta em sua cadeia de ferramentas. - -## Excluindo uma integração de ferramenta -{: #deleting_a_tool_integration} - -Se você excluir uma integração de ferramenta a partir de sua cadeia de ferramentas, a exclusão não poderá ser desfeita. - -1. No painel DevOps, na página **Cadeias de ferramentas**, clique em uma cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de -ferramentas** e, em seguida, clique em **Integrações de ferramenta**. -1. No ladrilho para a integração de ferramenta que deseja excluir, clique no menu para acessar as opções de configuração. -1. Para excluir a integração de ferramenta de sua cadeia de ferramentas, clique em **Excluir**. -1. Confirme clicando em **Excluir**. - -## Gerenciando acesso -{: #managing_access} - -É possível conceder aos usuários o acesso a uma cadeia de ferramentas, incluindo-os na organização (org) à qual a cadeia de ferramentas está -associada. Cada cadeia de ferramentas é associada a uma organização específica e qualquer usuário que for um membro dessa organização poderá -acessar as cadeias de ferramentas associadas. A organização na qual você está trabalhando atualmente está exibida na barra de menus. Clique na organização e, em seguida, alterne para uma organização diferente para acessar um conjunto diferente de cadeias de ferramentas. - - - - - -1. No painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para gerenciar e, em seguida, clique em **Gerenciar**. Como alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em -**Visualizar cadeia de ferramentas** e, em seguida, clique em **Gerenciar**. -1. Clique no link para sua organização. -1. Na página Gerenciar organizações, clique em **Convidar um usuário** e digite o endereço de e-mail do usuário. -1. Se você deseja conceder permissões para gerenciar usuários em organizações do {{site.data.keyword.Bluemix_notm}}, selecione uma ou mais das -caixas de seleção **Gerenciador**, **Gerenciador -de faturamento** ou **Auditor**. -1. Clique em **CONVIDAR**. -1. Clique em **SALVAR**. - -## Excluindo uma cadeia de ferramentas -{: #deleting_a_toolchain} - -É possível excluir uma cadeia de ferramentas e especificar qual das integrações de ferramenta associadas deseja excluir. Quando você excluir uma cadeia de ferramentas, a exclusão não poderá ser desfeita. - -1. No painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para excluir e, em seguida, clique em **Gerenciar**. Como alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em -**Visualizar cadeia de ferramentas** e, em seguida, clique em **Gerenciar**. -1. Clique em **Excluir cadeia de ferramentas** e revise ou ajuste as integrações de ferramentas que você estiver excluindo. -1. Confirme a exclusão digitando o nome da cadeia de ferramentas e clicando em **Excluir**. - - **Dica**: ao excluir uma integração de -ferramenta GitHub, o repo GitHub associado não é excluído do -GitHub. Deve-se -remover manualmente o repo do GitHub. +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Usando cadeias de ferramentas no {{site.data.keyword.Bluemix_notm}} Public +{: #toolchains-using} + +Última atualização: 7 de outubro de 2016 +{: .last-updated} + +É possível usar uma cadeia de ferramentas para ser produtivo em seu trabalho diário de desenvolvimento, implementação e operações. Após +configurar uma cadeia de ferramentas, é possível incluir, excluir ou configurar integrações de ferramenta e gerenciar acesso à cadeia de ferramentas. As cadeias de ferramentas estão disponíveis na região sul dos EUA somente. +{: shortdesc} + +**Nota**: Certifique-se de estar trabalhando na experiência New Bluemix verificando o banner na parte superior. + + * Se você vir uma mensagem sobre testar o novo Bluemix, estará trabalhando na experiência Classic Bluemix. Clique no link para abrir a experiência New Bluemix. + * Se você não vir essa mensagem, já estará trabalhando na experiência New Bluemix. + +## Configurando uma integração de ferramenta +{: #configuring_a_tool_integration} + +Se você adiou a configuração de uma integração de ferramenta quando criou uma cadeia de ferramentas, um botão **Configurar** será +mostrado em seu ladrilho. Se você configurou uma integração de ferramenta quando criou uma cadeia de ferramentas, será possível atualizar as definições de configuração. + +1. No painel DevOps, na página **Cadeias de ferramentas**, clique em uma cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de +ferramentas** e, em seguida, clique em **Integrações de ferramenta**. +1. Se precisar configurar uma integração de ferramenta pela primeira vez, em seu ladrilho, clique em **Configurar**. + + ![Botão de configuração +](images/toolchain_tile_configure.png) + + Quando tiver finalizado a configuração da integração de ferramenta, clique em **Salvar integração**. + +1. Se precisar atualizar uma configuração de integração de ferramenta, em seu ladrilho, clique no menu para acessar as opções de configuração. + + ![Menu Configuração](images/toolchain_tile_menu.png) + + Quando tiver finalizado a atualização das configurações, clique em **Salvar integração**. + +## Incluindo uma integração de ferramenta +{: #adding_a_tool_integration} + +É possível incluir e configurar integrações de ferramenta para sua cadeia de ferramentas. + +1. No painel DevOps, na página **Cadeias de ferramentas**, clique em uma cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de +ferramentas** e, em seguida, clique em **Integrações de ferramenta**. +1. Para ver uma lista de integrações de ferramenta para incluir, clique no botão de inclusão (+). +1. Clique em uma integração de ferramenta que deseja incluir. +1. Insira quaisquer informações necessárias para configurar a integração de ferramenta. +1. Clique em **Criar integração** para incluir a integração de ferramenta em sua cadeia de ferramentas. + +## Excluindo uma integração de ferramenta +{: #deleting_a_tool_integration} + +Se você excluir uma integração de ferramenta a partir de sua cadeia de ferramentas, a exclusão não poderá ser desfeita. + +1. No painel DevOps, na página **Cadeias de ferramentas**, clique em uma cadeia de ferramentas para abrir sua página de Integrações de ferramenta. Como alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em **Visualizar cadeia de +ferramentas** e, em seguida, clique em **Integrações de ferramenta**. +1. No ladrilho para a integração de ferramenta que deseja excluir, clique no menu para acessar as opções de configuração. +1. Para excluir a integração de ferramenta de sua cadeia de ferramentas, clique em **Excluir**. +1. Confirme clicando em **Excluir**. + +## Gerenciando acesso +{: #managing_access} + +É possível conceder aos usuários o acesso a uma cadeia de ferramentas, incluindo-os na organização (org) à qual a cadeia de ferramentas está +associada. Cada cadeia de ferramentas é associada a uma organização específica e qualquer usuário que for um membro dessa organização poderá +acessar as cadeias de ferramentas associadas. A organização na qual você está trabalhando atualmente está exibida na barra de menus. Clique na organização e, em seguida, alterne para uma organização diferente para acessar um conjunto diferente de cadeias de ferramentas. + + + + + +1. No painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para gerenciar e, em seguida, clique em **Gerenciar**. Como alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em +**Visualizar cadeia de ferramentas** e, em seguida, clique em **Gerenciar**. +1. Clique no link para sua organização. +1. Na página Gerenciar organizações, clique em **Convidar um usuário** e digite o endereço de e-mail do usuário. +1. Se você deseja conceder permissões para gerenciar usuários em organizações do {{site.data.keyword.Bluemix_notm}}, selecione uma ou mais das +caixas de seleção **Gerenciador**, **Gerenciador +de faturamento** ou **Auditor**. +1. Clique em **CONVIDAR**. +1. Clique em **SALVAR**. + +## Excluindo uma cadeia de ferramentas +{: #deleting_a_toolchain} + +É possível excluir uma cadeia de ferramentas e especificar qual das integrações de ferramenta associadas deseja excluir. Quando você excluir uma cadeia de ferramentas, a exclusão não poderá ser desfeita. + +1. No painel DevOps, na página **Cadeias de ferramentas**, clique na cadeia de ferramentas para excluir e, em seguida, clique em **Gerenciar**. Como alternativa, na página Visão geral do app, no ladrilho Entrega contínua, clique em +**Visualizar cadeia de ferramentas** e, em seguida, clique em **Gerenciar**. +1. Clique em **Excluir cadeia de ferramentas** e revise ou ajuste as integrações de ferramentas que você estiver excluindo. +1. Confirme a exclusão digitando o nome da cadeia de ferramentas e clicando em **Excluir**. + + **Dica**: ao excluir uma integração de +ferramenta GitHub, o repo GitHub associado não é excluído do +GitHub. Deve-se +remover manualmente o repo do GitHub. diff --git a/toolchains/nl/pt/BR/toolchains_using_dedicated.md b/toolchains/nl/pt/BR/toolchains_using_dedicated.md index cabafdae1..3e4b4ab67 100644 --- a/toolchains/nl/pt/BR/toolchains_using_dedicated.md +++ b/toolchains/nl/pt/BR/toolchains_using_dedicated.md @@ -1,106 +1,106 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# Usando cadeias de ferramentas no {{site.data.keyword.Bluemix_notm}} Dedicated -{: #toolchains-using_dedicated} - -Última atualização: 13 de setembro de 2016 -{: .last-updated} - -É possível usar uma cadeia de ferramentas para ser produtivo em seu trabalho diário de desenvolvimento, implementação e operações. Após -configurar uma cadeia de ferramentas, é possível incluir, excluir ou configurar integrações de ferramenta e gerenciar acesso à cadeia de ferramentas. -{: shortdesc} - -## Configurando uma integração de ferramenta -{: #configuring_a_tool_integration_dedicated} - -Se você adiou a configuração de uma integração de ferramenta quando criou uma cadeia de ferramentas, um botão **Configurar** será mostrado em seu ladrilho. Se você configurou uma -integração de ferramenta quando criou uma cadeia de ferramentas, será possível atualizar as definições de configuração. - -1. No Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão -geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique -em **Integrações de ferramenta**. -1. Se precisar configurar uma integração de ferramenta pela primeira vez, em seu ladrilho, clique em **Configurar**. - - ![Botão de configuração -](images/toolchain_tile_configure.png) - - Quando tiver finalizado a configuração da integração de ferramenta, clique em **Salvar integração**. - -1. Se precisar atualizar uma configuração de integração de ferramenta, em seu ladrilho, clique no menu para acessar as opções de configuração. - - ![Menu Configuração](images/toolchain_tile_menu.png) - - Quando tiver finalizado a atualização das configurações, clique em **Salvar integração**. - -## Incluindo uma integração de ferramenta -{: #adding_a_tool_integration_dedicated} - -É possível incluir e configurar integrações de ferramenta para sua cadeia de ferramentas. - -1. No Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão -geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique -em **Integrações de ferramenta**. -1. Para ver uma lista de integrações de ferramenta para incluir, clique no botão de inclusão (+). -1. Clique na integração de ferramenta a ser incluída. -1. Insira quaisquer informações necessárias para configurar a integração de ferramenta. -1. Clique em **Criar integração** para incluir a integração de ferramenta em sua cadeia de ferramentas. - -## Excluindo uma integração de ferramenta -{: #deleting_a_tool_integration} - -Se você excluir uma integração de ferramenta a partir de sua cadeia de ferramentas, a exclusão não poderá ser desfeita. - -1. No Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão -geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique -em **Integrações de ferramenta**. -1. No ladrilho para a integração de ferramenta a ser excluída, clique no menu para acessar as opções de configuração. -1. Para excluir a integração de ferramenta de sua cadeia de ferramentas, clique em **Excluir**. -1. Confirme clicando em **Excluir**. - -## Gerenciando acesso -{: #managing_access_dedicated} - -É possível conceder aos usuários o acesso a uma cadeia de ferramentas, incluindo-os na organização (org) à qual a cadeia de ferramentas está -associada. Cada cadeia de ferramentas é associada a uma organização específica e qualquer usuário que for um membro dessa organização poderá -acessar as cadeias de ferramentas associadas. Para visualizar a organização na qual você está trabalhando atualmente, clique no ícone -**{{site.data.keyword.avatar}}** -![Avatar icon](../icons/i-avatar-icon.svg) na barra de menus. Para acessar um conjunto diferente de cadeias de ferramentas, alterne para uma organização diferente. - -Quando você incluir usuários em sua organização e nos espaços do {{site.data.keyword.Bluemix}}, os usuários poderão efetuar login no GitHub Enterprise usando o seu ID e senha do -{{site.data.keyword.Bluemix_notm}}. Quando os usuários efetuarem login, as contas serão criadas para eles. Quando você incluir usuários em sua organização e nos espaços do -{{site.data.keyword.Bluemix_notm}}, eles não serão incluídos automaticamente no repositório GitHub Enterprise. Alguém com privilégio do administrador para o repositório deverá inclui-los. Para -obter mais informações, consulte [Usando o Dedicated GitHub Enterprise (O link é aberto em uma nova janela)](../services/ghededicated/index.html){: new_window}. - -Para incluir um usuário, siga estas etapas: - -1. No Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Em seguida, clique -em **Gerenciar**. Como alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique em -**Gerenciar**. -1. Clique no link para a sua organização. -1. Na página Gerenciar organizações, clique em **Convidar um usuário** e digite o endereço de e-mail do usuário. -1. Se você deseja conceder permissões para gerenciar usuários em organizações do {{site.data.keyword.Bluemix_notm}}, selecione uma ou mais das caixas de seleção -**Gerenciador**, **Gerenciador de faturamento** ou **Auditor**. -1. Clique em **CONVIDAR**. -1. Clique em **SALVAR**. - -## Excluindo uma cadeia de ferramentas -{: #deleting_a_toolchain_dedicated} - -É possível excluir uma cadeia de ferramentas e especificar qual de suas integrações de ferramenta associadas você deseja excluir. Quando você excluir uma cadeia de ferramentas, a exclusão não poderá ser -desfeita. - -1. No Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Em seguida, clique em **Gerenciar**. Como -alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique em **Gerenciar**. -1. Clique em **Excluir cadeia de ferramentas** e revise ou ajuste as integrações de ferramentas que você estiver excluindo. -1. Confirme a exclusão digitando o nome da cadeia de ferramentas e clicando em **Excluir**. - - **Dica**: quando você excluir uma integração de ferramenta do GitHub Enterprise, o repositório GitHub Enterprise associado não será excluído do GitHub Enterprise. Deve-se -remover manualmente o repositório a partir do GitHub Enterprise. +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# Usando cadeias de ferramentas no {{site.data.keyword.Bluemix_notm}} Dedicated +{: #toolchains-using_dedicated} + +Última atualização: 13 de setembro de 2016 +{: .last-updated} + +É possível usar uma cadeia de ferramentas para ser produtivo em seu trabalho diário de desenvolvimento, implementação e operações. Após +configurar uma cadeia de ferramentas, é possível incluir, excluir ou configurar integrações de ferramenta e gerenciar acesso à cadeia de ferramentas. +{: shortdesc} + +## Configurando uma integração de ferramenta +{: #configuring_a_tool_integration_dedicated} + +Se você adiou a configuração de uma integração de ferramenta quando criou uma cadeia de ferramentas, um botão **Configurar** será mostrado em seu ladrilho. Se você configurou uma +integração de ferramenta quando criou uma cadeia de ferramentas, será possível atualizar as definições de configuração. + +1. No Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão +geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique +em **Integrações de ferramenta**. +1. Se precisar configurar uma integração de ferramenta pela primeira vez, em seu ladrilho, clique em **Configurar**. + + ![Botão de configuração +](images/toolchain_tile_configure.png) + + Quando tiver finalizado a configuração da integração de ferramenta, clique em **Salvar integração**. + +1. Se precisar atualizar uma configuração de integração de ferramenta, em seu ladrilho, clique no menu para acessar as opções de configuração. + + ![Menu Configuração](images/toolchain_tile_menu.png) + + Quando tiver finalizado a atualização das configurações, clique em **Salvar integração**. + +## Incluindo uma integração de ferramenta +{: #adding_a_tool_integration_dedicated} + +É possível incluir e configurar integrações de ferramenta para sua cadeia de ferramentas. + +1. No Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão +geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique +em **Integrações de ferramenta**. +1. Para ver uma lista de integrações de ferramenta para incluir, clique no botão de inclusão (+). +1. Clique na integração de ferramenta a ser incluída. +1. Insira quaisquer informações necessárias para configurar a integração de ferramenta. +1. Clique em **Criar integração** para incluir a integração de ferramenta em sua cadeia de ferramentas. + +## Excluindo uma integração de ferramenta +{: #deleting_a_tool_integration} + +Se você excluir uma integração de ferramenta a partir de sua cadeia de ferramentas, a exclusão não poderá ser desfeita. + +1. No Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Como alternativa, no canto superior direito da página Visão +geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique +em **Integrações de ferramenta**. +1. No ladrilho para a integração de ferramenta a ser excluída, clique no menu para acessar as opções de configuração. +1. Para excluir a integração de ferramenta de sua cadeia de ferramentas, clique em **Excluir**. +1. Confirme clicando em **Excluir**. + +## Gerenciando acesso +{: #managing_access_dedicated} + +É possível conceder aos usuários o acesso a uma cadeia de ferramentas, incluindo-os na organização (org) à qual a cadeia de ferramentas está +associada. Cada cadeia de ferramentas é associada a uma organização específica e qualquer usuário que for um membro dessa organização poderá +acessar as cadeias de ferramentas associadas. Para visualizar a organização na qual você está trabalhando atualmente, clique no ícone +**{{site.data.keyword.avatar}}** +![Avatar icon](../icons/i-avatar-icon.svg) na barra de menus. Para acessar um conjunto diferente de cadeias de ferramentas, alterne para uma organização diferente. + +Quando você incluir usuários em sua organização e nos espaços do {{site.data.keyword.Bluemix}}, os usuários poderão efetuar login no GitHub Enterprise usando o seu ID e senha do +{{site.data.keyword.Bluemix_notm}}. Quando os usuários efetuarem login, as contas serão criadas para eles. Quando você incluir usuários em sua organização e nos espaços do +{{site.data.keyword.Bluemix_notm}}, eles não serão incluídos automaticamente no repositório GitHub Enterprise. Alguém com privilégio do administrador para o repositório deverá inclui-los. Para +obter mais informações, consulte [Usando o Dedicated GitHub Enterprise (O link é aberto em uma nova janela)](../services/ghededicated/index.html){: new_window}. + +Para incluir um usuário, siga estas etapas: + +1. No Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Em seguida, clique +em **Gerenciar**. Como alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique em +**Gerenciar**. +1. Clique no link para a sua organização. +1. Na página Gerenciar organizações, clique em **Convidar um usuário** e digite o endereço de e-mail do usuário. +1. Se você deseja conceder permissões para gerenciar usuários em organizações do {{site.data.keyword.Bluemix_notm}}, selecione uma ou mais das caixas de seleção +**Gerenciador**, **Gerenciador de faturamento** ou **Auditor**. +1. Clique em **CONVIDAR**. +1. Clique em **SALVAR**. + +## Excluindo uma cadeia de ferramentas +{: #deleting_a_toolchain_dedicated} + +É possível excluir uma cadeia de ferramentas e especificar qual de suas integrações de ferramenta associadas você deseja excluir. Quando você excluir uma cadeia de ferramentas, a exclusão não poderá ser +desfeita. + +1. No Painel, na guia **DEVOPS**, clique na cadeia de ferramentas para abrir a sua página Integrações de ferramentas. Em seguida, clique em **Gerenciar**. Como +alternativa, no canto superior direito da página Visão geral do aplicativo, clique em **Visualizar cadeia de ferramentas**. Em seguida, clique em **Gerenciar**. +1. Clique em **Excluir cadeia de ferramentas** e revise ou ajuste as integrações de ferramentas que você estiver excluindo. +1. Confirme a exclusão digitando o nome da cadeia de ferramentas e clicando em **Excluir**. + + **Dica**: quando você excluir uma integração de ferramenta do GitHub Enterprise, o repositório GitHub Enterprise associado não será excluído do GitHub Enterprise. Deve-se +remover manualmente o repositório a partir do GitHub Enterprise. diff --git a/toolchains/nl/pt/BR/web_ide.md b/toolchains/nl/pt/BR/web_ide.md index 3964cc21d..4780017e7 100644 --- a/toolchains/nl/pt/BR/web_ide.md +++ b/toolchains/nl/pt/BR/web_ide.md @@ -1,154 +1,154 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} -{:pre: .pre} - -# Editando código com o Eclipse Orion {{site.data.keyword.webide}} -{: #web_ide} - -Última atualização: 9 de setembro de 2016 -{: .last-updated} - -O Eclipse Orion {{site.data.keyword.webide}} é um ambiente de desenvolvimento baseado em navegador no qual é possível desenvolver para a web. É possível desenvolver em JavaScript, HTML e CSS com a ajuda de assistência de conteúdo, conclusão de código e verificação de erro. O {{site.data.keyword.webide}} funciona com praticamente qualquer idioma e oferece destaque da sintaxe para a maioria dos tipos de arquivos [ (O link é aberto em uma nova janela)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}. O controle de fonte é construído por meio do Git ou Jazz SCM e é possível implementar código localmente para testar e depurar os seus aplicativos. -{:shortdesc} - -O melhor de tudo, o {{site.data.keyword.webide}} é desenvolvido com a web. Você não tem nada para instalar, nada para manter e nada para escalar. É possível desenvolver em qualquer lugar no qual haja uma conexão de Internet. - -## Configurando o editor -{: #editorsetup} - -O {{site.data.keyword.webide}} é customizável de maneira que é possível escolher os esquemas de cores, as ferramentas técnicas e configurações que atendam às necessidades de desenvolvimento. Para visualizar e modificar configurações, a partir do menu à esquerda, clique no ícone **Configurações** O ícone configurações. - -Se muitas vezes você precisar mudar certas configurações enquanto edita, será possível acessar essas configurações de forma rápida a partir do ícone **Configurações do editor local** ícone Configurações do editor local no canto superior direito do editor - -![Configurações do editor local](images/webide_local_editor_settings.png) - -Por padrão, as configurações para o estilo de editor e o tamanho da fonte são sempre mostradas. Para incluir outras configurações do editor no menu, siga estas etapas: - -1. Clique no ícone **Configurações do editor local** ícone Configurações do editor local. - -2. Clique em **Configurações do editor**. - -3. Para incluir ou excluir uma configuração a partir do menu de **Configurações do editor local**, clique no círculo que está próximo da configuração. - -![Botão de alternância de Configurações do editor](images/webide_editor_settings_toggle.png) - - -## Editando código -{: #editcode} - -O {{site.data.keyword.webide}} tem duas seções. A primeira seção é o navegador de arquivo à esquerda, que mostra os seus arquivos de projeto em uma estrutura em árvore. A partir do navegador de arquivo, é possível criar, renomear, excluir e gerenciar os seus arquivos e pastas. - -**Dica:** para fazer upload de arquivos no navegador de arquivo, arraste-os a partir de seu computador para o navegador de arquivo. - -A segunda seção é a área de janela do editor à direita. O editor fornece vários recursos de codificação, incluindo assistência de conteúdo e validação de sintaxe. - -![IDE da Web](images/webide.png) - -### Trabalhando com múltiplos arquivos -1. Para trabalhar com dois arquivos ao mesmo tempo, clique no ícone **Mudar modo do editor de divisão** ícone Editor de divisão na parte superior do editor. -2. A partir do menu que é aberto, selecione uma visualização. - - Após você selecionar uma visualização, se um arquivo já foi aberto no editor, ele será mostrado em ambas as visualizações do editor. - - Para abrir ou mudar um arquivo que é mostrado em uma das visualizações do editor: - 1. Mova o cursor para a visualização do editor que você deseja mudar. - 2. No navegador de arquivo, clique em um arquivo. - -### Atalhos pelo Teclado -A maioria dos comandos no {{site.data.keyword.webide}} é acessível somente por meio de atalhos do teclado. - -Para ver uma lista de atalhos do teclado no editor, pressione Alt+Shift+?. Se você estiver usando um Mac OS, pressione Ctrl+Shift+?. - -## Gerenciamento de código fonte -{: #sourcecontrol} - -O {{site.data.keyword.webide}} é integrado com ferramentas de gerenciamento de código-fonte. Para trabalhar com o seu repositório Git, clique no ícone **Repositório Git ** O ícone Repositório Git. Para obter mais informações, consulte [Controle de fonte com Git (O link é aberto em uma nova janela)](https://hub.jazz.net/docs/git/){: new_window}. - - -## Implementando um aplicativo a partir de sua área de trabalho -{: #deploy} - -1. Para implementar o seu aplicativo, a partir da barra de execução, selecione ou [crie (O link é aberto em uma nova janela)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} uma configuração de ativação. -1. Clique no ícone de implementação O ícone de implementação. Uma instância de seu aplicativo é implementada usando os conteúdos atuais de sua área de trabalho e o ambiente que está definido em sua configuração de ativação. -2. Após o seu aplicativo ser implementado, é possível usar a barra de execução para parar, reiniciar ou depurar o seu aplicativo, visualizar logs e mais. -![Barra de execução](images/webide_runbar.png) - - - - ## Editando fora do {{site.data.keyword.webide}} -{: #editlocal} - -Para usar um editor além do {{site.data.keyword.webide}}, configure o {{site.data.keyword.Bluemix_live}} para que seja possível trabalhar diretamente com os seus arquivos de projeto em qualquer ferramenta. O {{site.data.keyword.Bluemix_live_notm}} é um aplicativo de linha de comandos que sincroniza as mudanças em seu sistema de arquivos local com a sua área de trabalho de nuvem no {{site.data.keyword.jazzhub}}. - -### Antes de Começar - -Faça download e instale a interface da linha de comandos do [{{site.data.keyword.Bluemix_live_notm}} (O link é aberto em uma nova janela)](http://livesyncdownload.ng.bluemix.net){: new_window}. - -### Sincronizando o seu ambiente local com o {{site.data.keyword.Bluemix_notm}} -{: #edit_local_download} - -1. Abra uma janela de linha de comandos. -2. Conecte-se ao {{site.data.keyword.Bluemix_notm}}: - - ``` - bl login - ``` - {: pre} - -3. Quando você for avisado, insira o seu ID IBM e senha. -4. Visualize uma lista de seus projetos do {{site.data.keyword.Bluemix_notm}}: - - ``` - bl projects - ``` - {: pre} - -4. Sincronize o seu ambiente local com os seus projetos no {{site.data.keyword.Bluemix_notm}}: - - ``` - bl sync projectName - ``` - {: pre} - -Em que `projectName` é o seu nome do aplicativo {{site.data.keyword.Bluemix_notm}}. - -Quando você concluir a edição, insira `q` para terminar a sincronização. - -### Ativando o recurso Desktop Sync para editar código localmente - -O recurso Desktop Sync é como o modo Live Edit para a linha de comandos. Você precisa do recurso Desktop Sync para depurar a linha de comandos. -1. Em uma outra linha de comandos, ative o recurso Desktop Sync: - - ``` - cd localDirectory - bl start - ``` - {: codeblock} - -2. Use a configuração de ativação que você criou no {{site.data.keyword.webide}}. Após você selecionar a configuração de ativação, o recurso Desktop Sync será ativado em seu ambiente local. Na -janela de linha de comandos que você acaba de abrir, é possível visualizar a URL do aplicativo, a URL de depuração, a URL de gerenciamento e visualizar o estado do -{{site.data.keyword.Bluemix_live_notm}}. - -3. Atualize o navegador e verifique se você pode ver as mudanças que salvou nos arquivos estáticos na área de trabalho local. - -### Desativando o recurso Desktop Sync - -1. Na segunda janela de linha de comandos, insira `bl stop`. -2. Na primeira janela de linha de comandos, insira `q`. +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} +{:pre: .pre} + +# Editando código com o Eclipse Orion {{site.data.keyword.webide}} +{: #web_ide} + +Última atualização: 9 de setembro de 2016 +{: .last-updated} + +O Eclipse Orion {{site.data.keyword.webide}} é um ambiente de desenvolvimento baseado em navegador no qual é possível desenvolver para a web. É possível desenvolver em JavaScript, HTML e CSS com a ajuda de assistência de conteúdo, conclusão de código e verificação de erro. O {{site.data.keyword.webide}} funciona com praticamente qualquer idioma e oferece destaque da sintaxe para a maioria dos tipos de arquivos [ (O link é aberto em uma nova janela)](https://hub.jazz.net/docs/overview/#dev_support){: new_window}. O controle de fonte é construído por meio do Git ou Jazz SCM e é possível implementar código localmente para testar e depurar os seus aplicativos. +{:shortdesc} + +O melhor de tudo, o {{site.data.keyword.webide}} é desenvolvido com a web. Você não tem nada para instalar, nada para manter e nada para escalar. É possível desenvolver em qualquer lugar no qual haja uma conexão de Internet. + +## Configurando o editor +{: #editorsetup} + +O {{site.data.keyword.webide}} é customizável de maneira que é possível escolher os esquemas de cores, as ferramentas técnicas e configurações que atendam às necessidades de desenvolvimento. Para visualizar e modificar configurações, a partir do menu à esquerda, clique no ícone **Configurações** O ícone configurações. + +Se muitas vezes você precisar mudar certas configurações enquanto edita, será possível acessar essas configurações de forma rápida a partir do ícone **Configurações do editor local** ícone Configurações do editor local no canto superior direito do editor + +![Configurações do editor local](images/webide_local_editor_settings.png) + +Por padrão, as configurações para o estilo de editor e o tamanho da fonte são sempre mostradas. Para incluir outras configurações do editor no menu, siga estas etapas: + +1. Clique no ícone **Configurações do editor local** ícone Configurações do editor local. + +2. Clique em **Configurações do editor**. + +3. Para incluir ou excluir uma configuração a partir do menu de **Configurações do editor local**, clique no círculo que está próximo da configuração. + +![Botão de alternância de Configurações do editor](images/webide_editor_settings_toggle.png) + + +## Editando código +{: #editcode} + +O {{site.data.keyword.webide}} tem duas seções. A primeira seção é o navegador de arquivo à esquerda, que mostra os seus arquivos de projeto em uma estrutura em árvore. A partir do navegador de arquivo, é possível criar, renomear, excluir e gerenciar os seus arquivos e pastas. + +**Dica:** para fazer upload de arquivos no navegador de arquivo, arraste-os a partir de seu computador para o navegador de arquivo. + +A segunda seção é a área de janela do editor à direita. O editor fornece vários recursos de codificação, incluindo assistência de conteúdo e validação de sintaxe. + +![IDE da Web](images/webide.png) + +### Trabalhando com múltiplos arquivos +1. Para trabalhar com dois arquivos ao mesmo tempo, clique no ícone **Mudar modo do editor de divisão** ícone Editor de divisão na parte superior do editor. +2. A partir do menu que é aberto, selecione uma visualização. + + Após você selecionar uma visualização, se um arquivo já foi aberto no editor, ele será mostrado em ambas as visualizações do editor. + + Para abrir ou mudar um arquivo que é mostrado em uma das visualizações do editor: + 1. Mova o cursor para a visualização do editor que você deseja mudar. + 2. No navegador de arquivo, clique em um arquivo. + +### Atalhos pelo Teclado +A maioria dos comandos no {{site.data.keyword.webide}} é acessível somente por meio de atalhos do teclado. + +Para ver uma lista de atalhos do teclado no editor, pressione Alt+Shift+?. Se você estiver usando um Mac OS, pressione Ctrl+Shift+?. + +## Gerenciamento de código fonte +{: #sourcecontrol} + +O {{site.data.keyword.webide}} é integrado com ferramentas de gerenciamento de código-fonte. Para trabalhar com o seu repositório Git, clique no ícone **Repositório Git ** O ícone Repositório Git. Para obter mais informações, consulte [Controle de fonte com Git (O link é aberto em uma nova janela)](https://hub.jazz.net/docs/git/){: new_window}. + + +## Implementando um aplicativo a partir de sua área de trabalho +{: #deploy} + +1. Para implementar o seu aplicativo, a partir da barra de execução, selecione ou [crie (O link é aberto em uma nova janela)](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window} uma configuração de ativação. +1. Clique no ícone de implementação O ícone de implementação. Uma instância de seu aplicativo é implementada usando os conteúdos atuais de sua área de trabalho e o ambiente que está definido em sua configuração de ativação. +2. Após o seu aplicativo ser implementado, é possível usar a barra de execução para parar, reiniciar ou depurar o seu aplicativo, visualizar logs e mais. +![Barra de execução](images/webide_runbar.png) + + + + ## Editando fora do {{site.data.keyword.webide}} +{: #editlocal} + +Para usar um editor além do {{site.data.keyword.webide}}, configure o {{site.data.keyword.Bluemix_live}} para que seja possível trabalhar diretamente com os seus arquivos de projeto em qualquer ferramenta. O {{site.data.keyword.Bluemix_live_notm}} é um aplicativo de linha de comandos que sincroniza as mudanças em seu sistema de arquivos local com a sua área de trabalho de nuvem no {{site.data.keyword.jazzhub}}. + +### Antes de Começar + +Faça download e instale a interface da linha de comandos do [{{site.data.keyword.Bluemix_live_notm}} (O link é aberto em uma nova janela)](http://livesyncdownload.ng.bluemix.net){: new_window}. + +### Sincronizando o seu ambiente local com o {{site.data.keyword.Bluemix_notm}} +{: #edit_local_download} + +1. Abra uma janela de linha de comandos. +2. Conecte-se ao {{site.data.keyword.Bluemix_notm}}: + + ``` + bl login + ``` + {: pre} + +3. Quando você for avisado, insira o seu ID IBM e senha. +4. Visualize uma lista de seus projetos do {{site.data.keyword.Bluemix_notm}}: + + ``` + bl projects + ``` + {: pre} + +4. Sincronize o seu ambiente local com os seus projetos no {{site.data.keyword.Bluemix_notm}}: + + ``` + bl sync projectName + ``` + {: pre} + +Em que `projectName` é o seu nome do aplicativo {{site.data.keyword.Bluemix_notm}}. + +Quando você concluir a edição, insira `q` para terminar a sincronização. + +### Ativando o recurso Desktop Sync para editar código localmente + +O recurso Desktop Sync é como o modo Live Edit para a linha de comandos. Você precisa do recurso Desktop Sync para depurar a linha de comandos. +1. Em uma outra linha de comandos, ative o recurso Desktop Sync: + + ``` + cd localDirectory + bl start + ``` + {: codeblock} + +2. Use a configuração de ativação que você criou no {{site.data.keyword.webide}}. Após você selecionar a configuração de ativação, o recurso Desktop Sync será ativado em seu ambiente local. Na +janela de linha de comandos que você acaba de abrir, é possível visualizar a URL do aplicativo, a URL de depuração, a URL de gerenciamento e visualizar o estado do +{{site.data.keyword.Bluemix_live_notm}}. + +3. Atualize o navegador e verifique se você pode ver as mudanças que salvou nos arquivos estáticos na área de trabalho local. + +### Desativando o recurso Desktop Sync + +1. Na segunda janela de linha de comandos, insira `bl stop`. +2. Na primeira janela de linha de comandos, insira `q`. diff --git a/toolchains/nl/zh/CN/toolchains_about.md b/toolchains/nl/zh/CN/toolchains_about.md index 3acf83b35..377f1fb10 100644 --- a/toolchains/nl/zh/CN/toolchains_about.md +++ b/toolchains/nl/zh/CN/toolchains_about.md @@ -1,43 +1,43 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# 关于工具链 -{: #toolchains_about} - -上次更新时间：2016 年 9 月 13 日 -{: .last-updated} - -*工具链*是支持开发、部署和操作任务的一组工具集成。这种集合起来的工具链的能力要远大于其个别工具集成的总和。 - -{:shortdesc} - -{{site.data.keyword.Bluemix}} 的 Public 和 Dedicated 环境中可使用工具链。您可以使用两种方法来创建工具链：使用模板创建工具链，或者通过应用程序创建工具链。您可以使用工具链模板作为起始点。根据使用的模板，您可以创建具有一组特定工具集成的工具链，或者创建可以向其中添加工具集成的空工具链。 - -在 {{site.data.keyword.Bluemix_notm}} Public 中，根据您所使用的模板或工具链，工具链可能包括已经填充了应用程序入门模板代码的 GitHub 存储库和预配置的 Delivery Pipeline。当您将更改推送到工具链的 GitHub 存储库时，Delivery Pipeline 会自动构建应用程序，并将其部署到 {{site.data.keyword.Bluemix_notm}}。 - -在 {{site.data.keyword.Bluemix_notm}} Dedicated 中，根据您所使用的工具链，工具链可能包括已经填充了应用程序入门模板代码的 GitHub Enterprise 存储库和预配置的 Delivery Pipeline。当您将更改推送到工具链的 GitHub Enterprise 存储库时，Delivery Pipeline 会自动构建应用程序，并将其部署到 {{site.data.keyword.Bluemix_notm}}。 - -## 获取工具链的帮助和支持 -{: #gettinghelp} - -如果您在使用工具链时有任何疑问或遇到任何问题，您可以在论坛中搜索相关信息或进行提问来获取帮助。还可以提交支持凭单。 - -使用论坛进行提问时，请使用适当的标记来标注您的问题，以方便 {{site.data.keyword.Bluemix_notm}} 开发团队识别。 - -* 有关使用工具链开发或部署应用程序的技术问题，请将您的问题发布到 [Stack Overflow（在新窗口中打开链接）](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window}上，并使用“ibm-bluemix”和“devops”标记您的问题。 - -* 有关工具链和入门指示信息的问题，请使用 [IBM developerWorks dW Answers（在新窗口中打开链接）](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}论坛。另请加上“devops-services”和“bluemix”标记。 - -有关使用论坛的更多详细信息，请参阅[获取帮助（在新窗口中打开链接）](https://www.{DomainName}/docs/support/index.html#getting-help)。 - -有关提交 IBM 支持凭单或支持级别和凭单严重性的信息，请参阅[联系支持人员（在新窗口中打开链接）](https://www.{DomainName}/docs/support/index.html#contacting-support)。 +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# 关于工具链 +{: #toolchains_about} + +上次更新时间：2016 年 9 月 13 日 +{: .last-updated} + +*工具链*是支持开发、部署和操作任务的一组工具集成。这种集合起来的工具链的能力要远大于其个别工具集成的总和。 + +{:shortdesc} + +{{site.data.keyword.Bluemix}} 的 Public 和 Dedicated 环境中可使用工具链。您可以使用两种方法来创建工具链：使用模板创建工具链，或者通过应用程序创建工具链。您可以使用工具链模板作为起始点。根据使用的模板，您可以创建具有一组特定工具集成的工具链，或者创建可以向其中添加工具集成的空工具链。 + +在 {{site.data.keyword.Bluemix_notm}} Public 中，根据您所使用的模板或工具链，工具链可能包括已经填充了应用程序入门模板代码的 GitHub 存储库和预配置的 Delivery Pipeline。当您将更改推送到工具链的 GitHub 存储库时，Delivery Pipeline 会自动构建应用程序，并将其部署到 {{site.data.keyword.Bluemix_notm}}。 + +在 {{site.data.keyword.Bluemix_notm}} Dedicated 中，根据您所使用的工具链，工具链可能包括已经填充了应用程序入门模板代码的 GitHub Enterprise 存储库和预配置的 Delivery Pipeline。当您将更改推送到工具链的 GitHub Enterprise 存储库时，Delivery Pipeline 会自动构建应用程序，并将其部署到 {{site.data.keyword.Bluemix_notm}}。 + +## 获取工具链的帮助和支持 +{: #gettinghelp} + +如果您在使用工具链时有任何疑问或遇到任何问题，您可以在论坛中搜索相关信息或进行提问来获取帮助。还可以提交支持凭单。 + +使用论坛进行提问时，请使用适当的标记来标注您的问题，以方便 {{site.data.keyword.Bluemix_notm}} 开发团队识别。 + +* 有关使用工具链开发或部署应用程序的技术问题，请将您的问题发布到 [Stack Overflow（在新窗口中打开链接）](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window}上，并使用“ibm-bluemix”和“devops”标记您的问题。 + +* 有关工具链和入门指示信息的问题，请使用 [IBM developerWorks dW Answers（在新窗口中打开链接）](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}论坛。另请加上“devops-services”和“bluemix”标记。 + +有关使用论坛的更多详细信息，请参阅[获取帮助（在新窗口中打开链接）](https://www.{DomainName}/docs/support/index.html#getting-help)。 + +有关提交 IBM 支持凭单或支持级别和凭单严重性的信息，请参阅[联系支持人员（在新窗口中打开链接）](https://www.{DomainName}/docs/support/index.html#contacting-support)。 diff --git a/toolchains/nl/zh/CN/toolchains_integrations.md b/toolchains/nl/zh/CN/toolchains_integrations.md index eb9de137e..f2e218d41 100644 --- a/toolchains/nl/zh/CN/toolchains_integrations.md +++ b/toolchains/nl/zh/CN/toolchains_integrations.md @@ -1,303 +1,303 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 配置工具集成 -{: #integrations} - -上次更新时间：2016 年 10 月 18 日 -{: .last-updated} - -您可以在创建工具链时配置支持开发、部署和操作任务的工具集成，或者您可以添加并配置工具集成，以定制现有工具链。 -{:shortdesc} - -**重要信息**：在 {{site.data.keyword.Bluemix_notm}} Public 中，工具链仅在美国南部区域可用。 - -根据您是在 {{site.data.keyword.Bluemix_notm}} Public 还是 {{site.data.keyword.Bluemix_notm}} Dedicated 中使用工具链，工具链可添加和配置的工具集成有所不同。如果要在 {{site.data.keyword.Bluemix_notm}} Dedicated 上使用工具链，那么哪些工具集成可用将取决于 {{site.data.keyword.jazzhub_title}} 在您的特定环境中如何设置。 - -*表 1. {{site.data.keyword.Bluemix_notm}} Public 和 Dedicated 中，工具链可使用的工具集成* - -|工具集成 |在 {{site.data.keyword.Bluemix_notm}} Public 中可用 |在 {{site.data.keyword.Bluemix_notm}} Dedicated 中可用（具体取决于环境）| -|:----------|:------------------------------|:------------------| -|{{site.data.keyword.deliverypipeline}} |是 |是 | -|{{site.data.keyword.DRA_short}} |是 |否 | -|Eclipse Orion {{site.data.keyword.webide}} |是 |是 | -|GitHub |是 |是 | -|Dedicated GitHub Enterprise |否 |是 | -|Other Tool |是 |是 | -|PagerDuty |是 |是 | -|Sauce Labs |是 |否 | -|Slack |是 |是 | - -**提示**：如果您想要在 {{site.data.keyword.Bluemix_notm}} Public 中开始使用源代码进行开发，请配置 GitHub 工具集成，然后再配置 {{site.data.keyword.deliverypipeline}}。如果要在 {{site.data.keyword.Bluemix_notm}} Dedicated 上开始使用您的代码进行开发，请先配置 {{site.data.keyword.ghe_short}} 工具集成或 GitHub 工具集成，然后再配置 {{site.data.keyword.deliverypipeline}}。 - - -## 配置 Delivery Pipeline -{: #deliverypipeline} - -{{site.data.keyword.deliverypipeline}} 可通过检索输入和运行作业的阶段序列（如构建、测试和部署），自动持续部署项目。 - -配置 {{site.data.keyword.deliverypipeline}} 以自动持续构建、测试和部署应用程序： - -1. 如果您在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 **Delivery Pipeline**。根据您所使用的模板，可能会有不同的字段可用。请复查缺省字段值，如果必要，更改那些设置。 -1. 如果您在 {{site.data.keyword.Bluemix_notm}} Public 中有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。如果您在 {{site.data.keyword.Bluemix_notm}} Dedicated 中使用工具链，请在仪表板的 **DEVOPS** 选项卡上，单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 -1. 单击添加按钮 (+)。 -1. 在“工具集成”部分中，单击 **Delivery Pipeline**。 -1. 指定新管道的名称。 -1. 如果您计划使用管道来部署用户界面，请选择**可查看的应用程序**复选框。管道所创建的所有应用程序都会显示在工具链“工具集成”页面上的**查看应用程序**列表中。 -1. 单击**创建集成**，以向工具链添加 {{site.data.keyword.deliverypipeline}}。 -1. 单击 {{site.data.keyword.deliverypipeline}} 的磁贴，以查看管道并对其进行配置。要了解配置管道的基础知识，请参阅[构建和部署管道（在新窗口中打开链接）](../services/DeliveryPipeline/build_deploy.html){: new_window}。 - - **提示**：如果在向 GitHub 或 {{site.data.keyword.ghe_short}} 存储库推送更改时您想要触发管道，那么您必须先为工具链配置 GitHub 或 {{site.data.keyword.ghe_short}}，然后再为管道定义阶段。管道阶段需要存储库的 Git URL。每一个管道阶段仅可以参考与工具链相关联的其中一个 GitHub 或 {{site.data.keyword.ghe_short}} 存储库。有关配置 GitHub 的指示信息，请参阅 [GitHub](#github) 一节。有关配置 Dedicated GitHub Enterprise 的指示信息，请参阅 [{{site.data.keyword.ghe_long}} 入门（在新窗口中打开链接）](../services/ghededicated/index.html){: new_window}。 - -1. 可选：如果您在 {{site.data.keyword.Bluemix_notm}} Public 中使用工具链，并且想要 Sauce Labs 对您的应用程序运行测试，请配置 {{site.data.keyword.deliverypipeline}} 以添加 Sauce Labs 测试作业。有关配置测试作业的指示信息，请参阅[在管道中配置 Sauce Labs 测试作业](#config_saucelabs)一节。 - -### 在管道中配置 Sauce Labs 测试作业 -{: #config_saucelabs} - -在管道中配置 Sauce Labs 测试作业之前，您需要具有构建和部署应用程序阶段的工作管道，且您必须为工具链配置 Sauce Labs。有关配置 Sauce Labs 的指示信息，请参阅 [Sauce Labs](#saucelabs) 一节。 - -配置 {{site.data.keyword.deliverypipeline}} 以添加 Sauce Labs 测试作业： - -1. 如果您没有部署应用程序测试版本的阶段，请创建一个。 -1. 在该阶段中，在部署作业之后添加测试作业。通过将这些作业置于相同的阶段中，它们可以访问相同的环境属性集。 -![测试作业](images/toolchain_test_job.png) - -1. 配置阶段： - - a. 在**环境属性**选项卡，创建三个属性：CF_APP_NAME、SAUCE_USERNAME 和 SAUCE_ACCESS_KEY。 - - b. 输入 Sauce Labs 用户名和访问密钥。这样做可外部化那些值，以便您可以在测试中使用它们。 - -1. 配置部署作业。在**部署脚本**字段中，包括以下命令：`export CF_APP_NAME="$CF_APP"`。该命令会将应用程序名称导出为环境属性。 -1. 配置测试作业。以下图像中的值为示例。**服务实例**、**目标**、**组织**和**空间**字段中会填充您使用的 Sauce Labs 用户名、区域、组织和空间。 -![配置作业](images/toolchain_configure_job.png) - - a. 对于测试器类型，请选择 **Sauce Labs**。 - - b. 对于服务实例，请选择您为工具链配置 Sauce Labs 时所使用的 Sauce Labs 用户名。 - - **提示**：要查看您为工具链配置 Sauce Labs 时所使用的用户名和访问密钥，请单击**配置**。 - - c. 在**测试执行命令**字段中，输入安装测试所需依赖项的命令，然后运行测试。例如，对于 Node.js 应用程序，您可能会输入以下命令： - ``` -npm install - node_modules/grunt-cli/bin/grunt test:sauce:parallel - ``` - - d. 如果您想要在测试作业日志中查看测试报告，请选择**启用测试报告**复选框，然后将“测试结果文件模式”设置为 `test/*.xml`。 - -1. 单击**保存**。无论何时您的管道运行，Sauce Labs 测试都会运行。 - -要了解更多信息，请参阅 [Delivery Pipeline（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}。 - - -## 添加 {{site.data.keyword.DRA_short}} -{: #dra} - -{{site.data.keyword.DRA_full}} 会从单元测试、功能测试和代码覆盖工具收集和分析结果，以确定您的代码是否满足部署过程中指定保护门处的预定义条件。如果您的代码不满足或超出条件，那么会停止部署以防止释放风险。您可以使用 {{site.data.keyword.DRA_short}} 作为持续交付环境的安全网或作为实现和提高质量标准的方法。 - - **注**：此工具集成是预配置的。它不需要任何配置参数，您无法对其重新配置。 - -添加 {{site.data.keyword.DRA_short}}，以在发行部署之前，监视这些部署以识别风险，从而保持并提高 {{site.data.keyword.Bluemix_notm}} 中代码的质量。 - -1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 -1. 单击添加按钮 (+)。 -1. 在“工具集成”部分中，单击 **Deployment Risk Analytics**。 -1. 单击**创建集成**。 -1. 单击 {{site.data.keyword.DRA_short}} 的磁贴，然后完成入门步骤：创建条件、将条件连接到管道并运行管道。有关更多信息，请参阅 [{{site.data.keyword.DRA_short}}（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}。 - - -## 添加 Eclipse Orion {{site.data.keyword.webide}} -{: #webide} - -Eclipse Orion {{site.data.keyword.webide}} 是基于 Web 的集成环境，您可以在其中创建、编辑、运行、调试和完成源代码控制任务。您可以无缝地从编辑移到运行到提交再到部署。 - - **注**：此工具集成是预配置的。它不需要任何配置参数，您无法对其重新配置。 - -要完成源代码控制任务，请添加 Eclipse Orion {{site.data.keyword.webide}} 工具集成： - -1. 如果您在 {{site.data.keyword.Bluemix_notm}} Public 中有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。如果您在 {{site.data.keyword.Bluemix_notm}} Dedicated 中使用工具链，请在仪表板的 **DEVOPS** 选项卡上，单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 -1. 单击添加按钮 (+)。 -1. 在“工具集成”部分中，单击 **Eclipse Orion Web IDE**。 -1. 单击**创建集成**。 -1. 单击新 Eclipse Orion {{site.data.keyword.webide}} 的磁贴。此时，您的工作空间会预填充 GitHub 或 {{site.data.keyword.ghe_short}} 存储库。与您当前工具链相关联的存储库会突出显示。 - -要了解更多信息，请参阅[使用 Eclipse Orion {{site.data.keyword.webide}} 编辑代码（在新窗口中打开链接）](../toolchains/web_ide.html){: new_window}。 - - -## 配置 GitHub -{: #github} - -GitHub 是 Git 存储库基于 Web 的托管服务。您可以同时具有存储库的本地和远程副本，这使协作变得更加轻松。 - -GitHub Issues 是一种跟踪工具，可将您的全部工作和计划保留在一个地方。它与您的开发存储库相集成，以便您可将重点放在重要的任务的上。 - -配置 GitHub，以在云中管理源代码： - -1. 如果您在创建工具链时配置此工具集成，请遵循以下步骤： - - a. 在“可配置的集成”部分中，单击 **GitHub**。如果您要在 {{site.data.keyword.Bluemix_notm}} Public 上创建工具链，但尚未授权 {{site.data.keyword.Bluemix_notm}} 访问 GitHub，请单击**授权**以转至 GitHub Web 站点。如果您没有活动 GitHub 会话，那么系统会提示您登录。单击**授权应用程序**，以允许 {{site.data.keyword.Bluemix_notm}} 访问 GitHub 帐户。如果您具有活动 GitHub 会话但最近未输入过密码，那么系统可能会提示您输入 GitHub 密码以进行确认。 - - b. 复查 GitHub 存储库的缺省目标存储库位置。那些存储库是从样本存储库克隆而来。如果需要，请更改目标存储库的名称。 -![缺省目标存储库位置](images/toolchain_github_config.png) - -1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 -1. 单击添加按钮 (+)。 -1. 在“工具集成”部分中，单击 **GitHub**。 -1. 如果您具有 GitHub 存储库且想要使用它，请输入 URL。对于存储库类型，请单击**链接**。 -1. 如果您想要使用新的 GitHub 存储库，请输入 GitHub 存储库的名称，输入您要克隆或派生的存储库的 URL，然后选择存储库类型： - - a. 要创建空的存储库，请单击**新建**。 - - b. 要创建 GitHub 存储库的副本，请单击**克隆**。 - - c. 要派生 GitHub 存储库以便您可以通过拉出请求来促进更改，请单击**派生**。 - -1. 如果您想要使用 GitHub Issues 进行问题跟踪，请选中**启用 GitHub Issues** 复选框。 -1. 单击**创建集成**。 -1. 单击您要使用的 GitHub 存储库的磁贴。这将打开 GitHub Web 站点，您可在其中查看存储库的内容。 - - **提示**：您可以在 Eclipse Orion {{site.data.keyword.webide}} 中使用集成的源代码管理工具，以编辑 GitHub 存储库，并从您的工作空间部署应用程序。 - -1. 如果您已启用 GitHub Issues，请单击 GitHub Issues 的磁贴，以将其打开。 - -有关更多信息，请参阅 [GitHub（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window}和 [GitHub Issues（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}。 - - -## 配置 Dedicated GitHub Enterprise -{: #configghe} - -{{site.data.keyword.ghe_long}} 是 Git 存储库基于 Web 的内部部署托管服务。Dedicated GitHub Enterprise 仅适用于 {{site.data.keyword.Bluemix_notm}} Dedicated 客户。GitHub Issues 是一种跟踪工具，可将您的工作和计划保留在一个地方。它与您的开发存储库相集成，以便您可将重点放在重要的任务的上。有关 Dedicated GitHub Enterprise 和 GitHub Issues 的更多信息，请参阅[使用 Dedicated GitHub Enterprise（在新窗口中打开链接）](../services/ghededicated/index.html){: new_window}和 [GitHub Issues（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}。 - -您可以将 {{site.data.keyword.ghe_short}} 配置为工具链中的工具集成，以便您可以管理公司 [{{site.data.keyword.Bluemix_notm}} Dedicated（在新窗口中打开链接）](../dedicated/index.html#dedicated){: new_window}实例中的源代码。 - -1. 如果您在创建工具链时配置此工具集成，请遵循以下步骤： - - a. 首次登录到 Dedicated GitHub Enterprise 之前，请要求公司的区域管理员使用 LDAP，在公司的用户注册表中，将您的用户标识添加到 {{site.data.keyword.Bluemix_notm}} Dedicated 实例。有关设置 {{site.data.keyword.ghe_short}} 帐户的信息，请参阅[使用 Dedicated GitHub Enterprise（在新窗口中打开链接）](../services/ghededicated/index.html){: new_window}。 - - b. 在“可配置的集成”部分中，单击 **{{site.data.keyword.ghe_short}}**。 - - c. 复查新 {{site.data.keyword.ghe_short}} 存储库的缺省名称。如果需要，请更改新存储库的名称。下图显示了从样本存储库克隆的存储库示例。您可以使用现有存储库或新存储库。要使用新存储库，您可以创建空的存储库、克隆存储库或派生存储库。![缺省存储库位置](images/toolchain_ghe_config.png) - -1. 如果您在 {{site.data.keyword.Bluemix_notm}} Public 中有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。如果您在 {{site.data.keyword.Bluemix_notm}} Dedicated 中使用工具链，请在仪表板的 **DEVOPS** 选项卡上，单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 -1. 单击添加按钮 (+)。 -1. 在“工具集成”部分中，单击 **{{site.data.keyword.ghe_short}}**。 -1. 如果您具有 {{site.data.keyword.ghe_short}} 存储库且想要使用，请输入该存储库的 URL。对于存储库类型，请单击**现有**。 -1. 如果您想要使用新的 {{site.data.keyword.ghe_short}} 存储库，请输入存储库的名称，输入您要克隆或派生的存储库的 URL，然后选择存储库类型： - - a. 要创建空的存储库，请单击**新建**。 - - b. 要创建存储库的副本，请单击**克隆**。 - - c. 要派生存储库以便您可以通过拉出请求来促进更改，请单击**派生**。 - -1. 要使用 GitHub Issues 进行问题跟踪，请选中**启用 GitHub Issues** 复选框。 -1. 单击**创建集成**。 -1. 单击您要使用的 {{site.data.keyword.ghe_short}} 存储库的磁贴。这将打开您公司的 [{{site.data.keyword.Bluemix_notm}} Dedicated（在新窗口中打开链接）](../dedicated/index.html#dedicated){: new_window}实例，可在其中查看存储库的内容。 - - **提示**：您可以在 Eclipse Orion {{site.data.keyword.webide}} 中使用集成的源代码管理工具，以编辑 {{site.data.keyword.ghe_short}} 存储库，并从您的工作空间部署应用程序。 - -1. 如果您已启用 GitHub Issues，请单击 GitHub Issues 的磁贴。 - - - -## 配置定制工具 (Other Tool) -{: #othertool} - -如果您的团队使用工具链集成列表中不包含的工具，那么您可以集成定制工具。 - -配置定制工具，以便与工具链中的其他工具一起使用，并且可供您的团队使用： -1. 如果要在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 **Other Tool**。 - -1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 -1. 单击添加按钮 (+)。 -1. 在“工具集成”部分中，单击 **Other Tool**。 -1. 输入工具名称。 -1. 选择与该工具关联最紧密的生命周期阶段。选择哪个生命周期阶段将决定在“工具链集成”页面中，您的工具列在哪个类别之下。 -1. 添加图标 URL。该图标将显示在工具集成卡上。 -1. 添加文档 URL。 -1. 指定工具实例名称。例如：我的团队工具。 -1. 添加工具实例 URL。单击工具集成卡可转至您为该工具实例所列出的 URL。 -1. 添加工具的描述。 -1. （高级）根据需要添加其他属性。例如，列出您的工具与工具链中其他工具集成所需的任何信息或属性。 -1. 单击**创建集成**。 - -## 配置 PagerDuty -{: #pagerduty} - -PagerDuty 可将多个监视系统的数据集成到单一视图。发生问题时，PagerDuty 可确保及时通知当时最有能力修正该问题的团队成员。如果该团队成员未响应该问题，可以配置呈报，以将该问题传递给第二顺位的工程师或运作管理员。 - -配置 PagerDuty，以在发生管道阶段失败时发送通知，以便您可以更快速地修正问题，并缩短停机时间： - -1. 如果您在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 **PagerDuty**。 -1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 -1. 单击添加按钮 (+)。 -1. 在“工具集成”部分中，单击 **PagerDuty** -1. 输入与 PagerDuty 帐户相关联的 PagerDuty 站点名称。如果您没有 PagerDuty 帐户，请[注册帐户（在新窗口中打开链接）](https://signup.pagerduty.com/accounts/new){: new_window}。 -1. 输入 PagerDuty 帐户的 API 访问密钥。有关查找密钥的指示信息，请参阅 [API 认证（在新窗口中打开链接）](https://signup.pagerduty.com/accounts/new){: new_window}。 -1. 输入 PagerDuty 服务的名称。 -1. 输入主要 PagerDuty 联系人的电子邮件地址。 -1. 输入主要 PagerDuty 联系人的电话号码。 -1. 单击**创建集成**。 -1. 单击 PagerDuty 的磁贴，以转至 pagerduty.com。您可以查看与您在为工具链配置此工具集成时所指定的 PagerDuty 服务相关联的事件。 - -要了解更多信息，请参阅 [PagerDuty（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}。 - - -## 配置 Sauce Labs -{: #saucelabs} - -Sauce Labs 运行功能单元测试。当 Sauce Labs 测试套件配置为 {{site.data.keyword.deliverypipeline}} 中的测试作业时，测试套件可以作为您持续交付过程的一部分，根据您的 Web 或移动应用程序，运行测试。这些测试可以为您的项目提供有价值的流程控制，充当防止部署错误代码的保护门。 - -配置 Sauce Labs，以在多个操作系统和浏览器上运行自动功能测试，以便您可以模拟用户可能使用 Web 站点或应用程序的方式。 - -1. 如果您在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 **Sauce Labs**。 -1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 -1. 单击添加按钮 (+)。 -1. 在“工具集成”部分中，单击 **Sauce Labs**。 -1. 输入与 Sauce Labs 帐户相关联的用户名。您可以[在 Sauce Labs 帐户页面顶部的欢迎消息中查找用户名（在新窗口中打开链接）](https://saucelabs.com/account){: new_window}。 -1. 输入 Sauce Labs 帐户的访问密钥。您可以[在 Sauce Labs 帐户页面中查找密钥（在新窗口中打开链接）](https://saucelabs.com/account){: new_window}。 -1. 单击**创建集成**。 -1. 单击 Sauce Labs 的磁贴，以转至 saucelabs.com 并查看工具链的测试活动。 - - **提示**：如果您将 Sauce Labs 测试作业添加到 {{site.data.keyword.deliverypipeline}}，那么您可以选择服务实例。 - -要了解更多信息，请参阅 [Sauce Labs（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}。 - - -## 配置 Slack -{: #slack} - -**重要信息**：团队中的每一个人都可以看到发布到公共 Slack 通道的通知。记住您要对发布的内容负责。 - -Slack 是基于云的实时消息传递和通知系统。Slack 提供持久交谈，可替代电子邮件用于团队协作，其互动性更高。您可以通过专用通道或与您工作直接相关的一组通道，与团队进行通信。您还可以通过通道或直接消息，在两人或多人之间共享文件和图像。直接消息和通道的通信会保留，以便您可以对它们进行搜索。 - -配置 Slack，以从工具集成接收有关工具链的通知，如测试和部署活动： - -1. 如果您在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 **Slack**。 -1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 -1. 单击添加按钮 (+)。 -1. 在“工具集成”部分中，单击 **Slack**。 -1. 输入 Slack 帐户的 API 认证令牌。您必须使用生成的完全访问令牌，向 Slack 进行认证。有关查找令牌的指示信息，请参阅 [Slack 认证（在新窗口中打开链接）](https://api.slack.com/web#authentication){: new_window}。 -1. 输入您想要发送通知的目标 Slack 通道的名称。如果指定的通道不存在，那么会创建该通道。如果通道已归档，那么会重新激活该通道。 -1. 单击**创建集成**。 -1. 单击 Slack 的磁贴。您可以在已配置的 Slack 通道中查看工具链的所有活动。 - -要了解更多信息，请参阅 [Slack（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}。 - - - - - - - - +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 配置工具集成 +{: #integrations} + +上次更新时间：2016 年 10 月 18 日 +{: .last-updated} + +您可以在创建工具链时配置支持开发、部署和操作任务的工具集成，或者您可以添加并配置工具集成，以定制现有工具链。 +{:shortdesc} + +**重要信息**：在 {{site.data.keyword.Bluemix_notm}} Public 中，工具链仅在美国南部区域可用。 + +根据您是在 {{site.data.keyword.Bluemix_notm}} Public 还是 {{site.data.keyword.Bluemix_notm}} Dedicated 中使用工具链，工具链可添加和配置的工具集成有所不同。如果要在 {{site.data.keyword.Bluemix_notm}} Dedicated 上使用工具链，那么哪些工具集成可用将取决于 {{site.data.keyword.jazzhub_title}} 在您的特定环境中如何设置。 + +*表 1. {{site.data.keyword.Bluemix_notm}} Public 和 Dedicated 中，工具链可使用的工具集成* + +|工具集成 |在 {{site.data.keyword.Bluemix_notm}} Public 中可用 |在 {{site.data.keyword.Bluemix_notm}} Dedicated 中可用（具体取决于环境）| +|:----------|:------------------------------|:------------------| +|{{site.data.keyword.deliverypipeline}} |是 |是 | +|{{site.data.keyword.DRA_short}} |是 |否 | +|Eclipse Orion {{site.data.keyword.webide}} |是 |是 | +|GitHub |是 |是 | +|Dedicated GitHub Enterprise |否 |是 | +|Other Tool |是 |是 | +|PagerDuty |是 |是 | +|Sauce Labs |是 |否 | +|Slack |是 |是 | + +**提示**：如果您想要在 {{site.data.keyword.Bluemix_notm}} Public 中开始使用源代码进行开发，请配置 GitHub 工具集成，然后再配置 {{site.data.keyword.deliverypipeline}}。如果要在 {{site.data.keyword.Bluemix_notm}} Dedicated 上开始使用您的代码进行开发，请先配置 {{site.data.keyword.ghe_short}} 工具集成或 GitHub 工具集成，然后再配置 {{site.data.keyword.deliverypipeline}}。 + + +## 配置 Delivery Pipeline +{: #deliverypipeline} + +{{site.data.keyword.deliverypipeline}} 可通过检索输入和运行作业的阶段序列（如构建、测试和部署），自动持续部署项目。 + +配置 {{site.data.keyword.deliverypipeline}} 以自动持续构建、测试和部署应用程序： + +1. 如果您在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 **Delivery Pipeline**。根据您所使用的模板，可能会有不同的字段可用。请复查缺省字段值，如果必要，更改那些设置。 +1. 如果您在 {{site.data.keyword.Bluemix_notm}} Public 中有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。如果您在 {{site.data.keyword.Bluemix_notm}} Dedicated 中使用工具链，请在仪表板的 **DEVOPS** 选项卡上，单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 +1. 单击添加按钮 (+)。 +1. 在“工具集成”部分中，单击 **Delivery Pipeline**。 +1. 指定新管道的名称。 +1. 如果您计划使用管道来部署用户界面，请选择**可查看的应用程序**复选框。管道所创建的所有应用程序都会显示在工具链“工具集成”页面上的**查看应用程序**列表中。 +1. 单击**创建集成**，以向工具链添加 {{site.data.keyword.deliverypipeline}}。 +1. 单击 {{site.data.keyword.deliverypipeline}} 的磁贴，以查看管道并对其进行配置。要了解配置管道的基础知识，请参阅[构建和部署管道（在新窗口中打开链接）](../services/DeliveryPipeline/build_deploy.html){: new_window}。 + + **提示**：如果在向 GitHub 或 {{site.data.keyword.ghe_short}} 存储库推送更改时您想要触发管道，那么您必须先为工具链配置 GitHub 或 {{site.data.keyword.ghe_short}}，然后再为管道定义阶段。管道阶段需要存储库的 Git URL。每一个管道阶段仅可以参考与工具链相关联的其中一个 GitHub 或 {{site.data.keyword.ghe_short}} 存储库。有关配置 GitHub 的指示信息，请参阅 [GitHub](#github) 一节。有关配置 Dedicated GitHub Enterprise 的指示信息，请参阅 [{{site.data.keyword.ghe_long}} 入门（在新窗口中打开链接）](../services/ghededicated/index.html){: new_window}。 + +1. 可选：如果您在 {{site.data.keyword.Bluemix_notm}} Public 中使用工具链，并且想要 Sauce Labs 对您的应用程序运行测试，请配置 {{site.data.keyword.deliverypipeline}} 以添加 Sauce Labs 测试作业。有关配置测试作业的指示信息，请参阅[在管道中配置 Sauce Labs 测试作业](#config_saucelabs)一节。 + +### 在管道中配置 Sauce Labs 测试作业 +{: #config_saucelabs} + +在管道中配置 Sauce Labs 测试作业之前，您需要具有构建和部署应用程序阶段的工作管道，且您必须为工具链配置 Sauce Labs。有关配置 Sauce Labs 的指示信息，请参阅 [Sauce Labs](#saucelabs) 一节。 + +配置 {{site.data.keyword.deliverypipeline}} 以添加 Sauce Labs 测试作业： + +1. 如果您没有部署应用程序测试版本的阶段，请创建一个。 +1. 在该阶段中，在部署作业之后添加测试作业。通过将这些作业置于相同的阶段中，它们可以访问相同的环境属性集。 +![测试作业](images/toolchain_test_job.png) + +1. 配置阶段： + + a. 在**环境属性**选项卡，创建三个属性：CF_APP_NAME、SAUCE_USERNAME 和 SAUCE_ACCESS_KEY。 + + b. 输入 Sauce Labs 用户名和访问密钥。这样做可外部化那些值，以便您可以在测试中使用它们。 + +1. 配置部署作业。在**部署脚本**字段中，包括以下命令：`export CF_APP_NAME="$CF_APP"`。该命令会将应用程序名称导出为环境属性。 +1. 配置测试作业。以下图像中的值为示例。**服务实例**、**目标**、**组织**和**空间**字段中会填充您使用的 Sauce Labs 用户名、区域、组织和空间。 +![配置作业](images/toolchain_configure_job.png) + + a. 对于测试器类型，请选择 **Sauce Labs**。 + + b. 对于服务实例，请选择您为工具链配置 Sauce Labs 时所使用的 Sauce Labs 用户名。 + + **提示**：要查看您为工具链配置 Sauce Labs 时所使用的用户名和访问密钥，请单击**配置**。 + + c. 在**测试执行命令**字段中，输入安装测试所需依赖项的命令，然后运行测试。例如，对于 Node.js 应用程序，您可能会输入以下命令： + ``` +npm install + node_modules/grunt-cli/bin/grunt test:sauce:parallel + ``` + + d. 如果您想要在测试作业日志中查看测试报告，请选择**启用测试报告**复选框，然后将“测试结果文件模式”设置为 `test/*.xml`。 + +1. 单击**保存**。无论何时您的管道运行，Sauce Labs 测试都会运行。 + +要了解更多信息，请参阅 [Delivery Pipeline（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}。 + + +## 添加 {{site.data.keyword.DRA_short}} +{: #dra} + +{{site.data.keyword.DRA_full}} 会从单元测试、功能测试和代码覆盖工具收集和分析结果，以确定您的代码是否满足部署过程中指定保护门处的预定义条件。如果您的代码不满足或超出条件，那么会停止部署以防止释放风险。您可以使用 {{site.data.keyword.DRA_short}} 作为持续交付环境的安全网或作为实现和提高质量标准的方法。 + + **注**：此工具集成是预配置的。它不需要任何配置参数，您无法对其重新配置。 + +添加 {{site.data.keyword.DRA_short}}，以在发行部署之前，监视这些部署以识别风险，从而保持并提高 {{site.data.keyword.Bluemix_notm}} 中代码的质量。 + +1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 +1. 单击添加按钮 (+)。 +1. 在“工具集成”部分中，单击 **Deployment Risk Analytics**。 +1. 单击**创建集成**。 +1. 单击 {{site.data.keyword.DRA_short}} 的磁贴，然后完成入门步骤：创建条件、将条件连接到管道并运行管道。有关更多信息，请参阅 [{{site.data.keyword.DRA_short}}（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}。 + + +## 添加 Eclipse Orion {{site.data.keyword.webide}} +{: #webide} + +Eclipse Orion {{site.data.keyword.webide}} 是基于 Web 的集成环境，您可以在其中创建、编辑、运行、调试和完成源代码控制任务。您可以无缝地从编辑移到运行到提交再到部署。 + + **注**：此工具集成是预配置的。它不需要任何配置参数，您无法对其重新配置。 + +要完成源代码控制任务，请添加 Eclipse Orion {{site.data.keyword.webide}} 工具集成： + +1. 如果您在 {{site.data.keyword.Bluemix_notm}} Public 中有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。如果您在 {{site.data.keyword.Bluemix_notm}} Dedicated 中使用工具链，请在仪表板的 **DEVOPS** 选项卡上，单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 +1. 单击添加按钮 (+)。 +1. 在“工具集成”部分中，单击 **Eclipse Orion Web IDE**。 +1. 单击**创建集成**。 +1. 单击新 Eclipse Orion {{site.data.keyword.webide}} 的磁贴。此时，您的工作空间会预填充 GitHub 或 {{site.data.keyword.ghe_short}} 存储库。与您当前工具链相关联的存储库会突出显示。 + +要了解更多信息，请参阅[使用 Eclipse Orion {{site.data.keyword.webide}} 编辑代码（在新窗口中打开链接）](../toolchains/web_ide.html){: new_window}。 + + +## 配置 GitHub +{: #github} + +GitHub 是 Git 存储库基于 Web 的托管服务。您可以同时具有存储库的本地和远程副本，这使协作变得更加轻松。 + +GitHub Issues 是一种跟踪工具，可将您的全部工作和计划保留在一个地方。它与您的开发存储库相集成，以便您可将重点放在重要的任务的上。 + +配置 GitHub，以在云中管理源代码： + +1. 如果您在创建工具链时配置此工具集成，请遵循以下步骤： + + a. 在“可配置的集成”部分中，单击 **GitHub**。如果您要在 {{site.data.keyword.Bluemix_notm}} Public 上创建工具链，但尚未授权 {{site.data.keyword.Bluemix_notm}} 访问 GitHub，请单击**授权**以转至 GitHub Web 站点。如果您没有活动 GitHub 会话，那么系统会提示您登录。单击**授权应用程序**，以允许 {{site.data.keyword.Bluemix_notm}} 访问 GitHub 帐户。如果您具有活动 GitHub 会话但最近未输入过密码，那么系统可能会提示您输入 GitHub 密码以进行确认。 + + b. 复查 GitHub 存储库的缺省目标存储库位置。那些存储库是从样本存储库克隆而来。如果需要，请更改目标存储库的名称。 +![缺省目标存储库位置](images/toolchain_github_config.png) + +1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 +1. 单击添加按钮 (+)。 +1. 在“工具集成”部分中，单击 **GitHub**。 +1. 如果您具有 GitHub 存储库且想要使用它，请输入 URL。对于存储库类型，请单击**链接**。 +1. 如果您想要使用新的 GitHub 存储库，请输入 GitHub 存储库的名称，输入您要克隆或派生的存储库的 URL，然后选择存储库类型： + + a. 要创建空的存储库，请单击**新建**。 + + b. 要创建 GitHub 存储库的副本，请单击**克隆**。 + + c. 要派生 GitHub 存储库以便您可以通过拉出请求来促进更改，请单击**派生**。 + +1. 如果您想要使用 GitHub Issues 进行问题跟踪，请选中**启用 GitHub Issues** 复选框。 +1. 单击**创建集成**。 +1. 单击您要使用的 GitHub 存储库的磁贴。这将打开 GitHub Web 站点，您可在其中查看存储库的内容。 + + **提示**：您可以在 Eclipse Orion {{site.data.keyword.webide}} 中使用集成的源代码管理工具，以编辑 GitHub 存储库，并从您的工作空间部署应用程序。 + +1. 如果您已启用 GitHub Issues，请单击 GitHub Issues 的磁贴，以将其打开。 + +有关更多信息，请参阅 [GitHub（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window}和 [GitHub Issues（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}。 + + +## 配置 Dedicated GitHub Enterprise +{: #configghe} + +{{site.data.keyword.ghe_long}} 是 Git 存储库基于 Web 的内部部署托管服务。Dedicated GitHub Enterprise 仅适用于 {{site.data.keyword.Bluemix_notm}} Dedicated 客户。GitHub Issues 是一种跟踪工具，可将您的工作和计划保留在一个地方。它与您的开发存储库相集成，以便您可将重点放在重要的任务的上。有关 Dedicated GitHub Enterprise 和 GitHub Issues 的更多信息，请参阅[使用 Dedicated GitHub Enterprise（在新窗口中打开链接）](../services/ghededicated/index.html){: new_window}和 [GitHub Issues（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}。 + +您可以将 {{site.data.keyword.ghe_short}} 配置为工具链中的工具集成，以便您可以管理公司 [{{site.data.keyword.Bluemix_notm}} Dedicated（在新窗口中打开链接）](../dedicated/index.html#dedicated){: new_window}实例中的源代码。 + +1. 如果您在创建工具链时配置此工具集成，请遵循以下步骤： + + a. 首次登录到 Dedicated GitHub Enterprise 之前，请要求公司的区域管理员使用 LDAP，在公司的用户注册表中，将您的用户标识添加到 {{site.data.keyword.Bluemix_notm}} Dedicated 实例。有关设置 {{site.data.keyword.ghe_short}} 帐户的信息，请参阅[使用 Dedicated GitHub Enterprise（在新窗口中打开链接）](../services/ghededicated/index.html){: new_window}。 + + b. 在“可配置的集成”部分中，单击 **{{site.data.keyword.ghe_short}}**。 + + c. 复查新 {{site.data.keyword.ghe_short}} 存储库的缺省名称。如果需要，请更改新存储库的名称。下图显示了从样本存储库克隆的存储库示例。您可以使用现有存储库或新存储库。要使用新存储库，您可以创建空的存储库、克隆存储库或派生存储库。![缺省存储库位置](images/toolchain_ghe_config.png) + +1. 如果您在 {{site.data.keyword.Bluemix_notm}} Public 中有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。如果您在 {{site.data.keyword.Bluemix_notm}} Dedicated 中使用工具链，请在仪表板的 **DEVOPS** 选项卡上，单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 +1. 单击添加按钮 (+)。 +1. 在“工具集成”部分中，单击 **{{site.data.keyword.ghe_short}}**。 +1. 如果您具有 {{site.data.keyword.ghe_short}} 存储库且想要使用，请输入该存储库的 URL。对于存储库类型，请单击**现有**。 +1. 如果您想要使用新的 {{site.data.keyword.ghe_short}} 存储库，请输入存储库的名称，输入您要克隆或派生的存储库的 URL，然后选择存储库类型： + + a. 要创建空的存储库，请单击**新建**。 + + b. 要创建存储库的副本，请单击**克隆**。 + + c. 要派生存储库以便您可以通过拉出请求来促进更改，请单击**派生**。 + +1. 要使用 GitHub Issues 进行问题跟踪，请选中**启用 GitHub Issues** 复选框。 +1. 单击**创建集成**。 +1. 单击您要使用的 {{site.data.keyword.ghe_short}} 存储库的磁贴。这将打开您公司的 [{{site.data.keyword.Bluemix_notm}} Dedicated（在新窗口中打开链接）](../dedicated/index.html#dedicated){: new_window}实例，可在其中查看存储库的内容。 + + **提示**：您可以在 Eclipse Orion {{site.data.keyword.webide}} 中使用集成的源代码管理工具，以编辑 {{site.data.keyword.ghe_short}} 存储库，并从您的工作空间部署应用程序。 + +1. 如果您已启用 GitHub Issues，请单击 GitHub Issues 的磁贴。 + + + +## 配置定制工具 (Other Tool) +{: #othertool} + +如果您的团队使用工具链集成列表中不包含的工具，那么您可以集成定制工具。 + +配置定制工具，以便与工具链中的其他工具一起使用，并且可供您的团队使用： +1. 如果要在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 **Other Tool**。 + +1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 +1. 单击添加按钮 (+)。 +1. 在“工具集成”部分中，单击 **Other Tool**。 +1. 输入工具名称。 +1. 选择与该工具关联最紧密的生命周期阶段。选择哪个生命周期阶段将决定在“工具链集成”页面中，您的工具列在哪个类别之下。 +1. 添加图标 URL。该图标将显示在工具集成卡上。 +1. 添加文档 URL。 +1. 指定工具实例名称。例如：我的团队工具。 +1. 添加工具实例 URL。单击工具集成卡可转至您为该工具实例所列出的 URL。 +1. 添加工具的描述。 +1. （高级）根据需要添加其他属性。例如，列出您的工具与工具链中其他工具集成所需的任何信息或属性。 +1. 单击**创建集成**。 + +## 配置 PagerDuty +{: #pagerduty} + +PagerDuty 可将多个监视系统的数据集成到单一视图。发生问题时，PagerDuty 可确保及时通知当时最有能力修正该问题的团队成员。如果该团队成员未响应该问题，可以配置呈报，以将该问题传递给第二顺位的工程师或运作管理员。 + +配置 PagerDuty，以在发生管道阶段失败时发送通知，以便您可以更快速地修正问题，并缩短停机时间： + +1. 如果您在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 **PagerDuty**。 +1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 +1. 单击添加按钮 (+)。 +1. 在“工具集成”部分中，单击 **PagerDuty** +1. 输入与 PagerDuty 帐户相关联的 PagerDuty 站点名称。如果您没有 PagerDuty 帐户，请[注册帐户（在新窗口中打开链接）](https://signup.pagerduty.com/accounts/new){: new_window}。 +1. 输入 PagerDuty 帐户的 API 访问密钥。有关查找密钥的指示信息，请参阅 [API 认证（在新窗口中打开链接）](https://signup.pagerduty.com/accounts/new){: new_window}。 +1. 输入 PagerDuty 服务的名称。 +1. 输入主要 PagerDuty 联系人的电子邮件地址。 +1. 输入主要 PagerDuty 联系人的电话号码。 +1. 单击**创建集成**。 +1. 单击 PagerDuty 的磁贴，以转至 pagerduty.com。您可以查看与您在为工具链配置此工具集成时所指定的 PagerDuty 服务相关联的事件。 + +要了解更多信息，请参阅 [PagerDuty（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}。 + + +## 配置 Sauce Labs +{: #saucelabs} + +Sauce Labs 运行功能单元测试。当 Sauce Labs 测试套件配置为 {{site.data.keyword.deliverypipeline}} 中的测试作业时，测试套件可以作为您持续交付过程的一部分，根据您的 Web 或移动应用程序，运行测试。这些测试可以为您的项目提供有价值的流程控制，充当防止部署错误代码的保护门。 + +配置 Sauce Labs，以在多个操作系统和浏览器上运行自动功能测试，以便您可以模拟用户可能使用 Web 站点或应用程序的方式。 + +1. 如果您在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 **Sauce Labs**。 +1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 +1. 单击添加按钮 (+)。 +1. 在“工具集成”部分中，单击 **Sauce Labs**。 +1. 输入与 Sauce Labs 帐户相关联的用户名。您可以[在 Sauce Labs 帐户页面顶部的欢迎消息中查找用户名（在新窗口中打开链接）](https://saucelabs.com/account){: new_window}。 +1. 输入 Sauce Labs 帐户的访问密钥。您可以[在 Sauce Labs 帐户页面中查找密钥（在新窗口中打开链接）](https://saucelabs.com/account){: new_window}。 +1. 单击**创建集成**。 +1. 单击 Sauce Labs 的磁贴，以转至 saucelabs.com 并查看工具链的测试活动。 + + **提示**：如果您将 Sauce Labs 测试作业添加到 {{site.data.keyword.deliverypipeline}}，那么您可以选择服务实例。 + +要了解更多信息，请参阅 [Sauce Labs（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}。 + + +## 配置 Slack +{: #slack} + +**重要信息**：团队中的每一个人都可以看到发布到公共 Slack 通道的通知。记住您要对发布的内容负责。 + +Slack 是基于云的实时消息传递和通知系统。Slack 提供持久交谈，可替代电子邮件用于团队协作，其互动性更高。您可以通过专用通道或与您工作直接相关的一组通道，与团队进行通信。您还可以通过通道或直接消息，在两人或多人之间共享文件和图像。直接消息和通道的通信会保留，以便您可以对它们进行搜索。 + +配置 Slack，以从工具集成接收有关工具链的通知，如测试和部署活动： + +1. 如果您在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 **Slack**。 +1. 如果您有工具链，并且要将此工具集成添加到该工具链，请在 DevOps 仪表板的**工具链**页面上单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 +1. 单击添加按钮 (+)。 +1. 在“工具集成”部分中，单击 **Slack**。 +1. 输入 Slack 帐户的 API 认证令牌。您必须使用生成的完全访问令牌，向 Slack 进行认证。有关查找令牌的指示信息，请参阅 [Slack 认证（在新窗口中打开链接）](https://api.slack.com/web#authentication){: new_window}。 +1. 输入您想要发送通知的目标 Slack 通道的名称。如果指定的通道不存在，那么会创建该通道。如果通道已归档，那么会重新激活该通道。 +1. 单击**创建集成**。 +1. 单击 Slack 的磁贴。您可以在已配置的 Slack 通道中查看工具链的所有活动。 + +要了解更多信息，请参阅 [Slack（在新窗口中打开链接）](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}。 + + + + + + + + diff --git a/toolchains/nl/zh/CN/toolchains_overview.md b/toolchains/nl/zh/CN/toolchains_overview.md index 1db1fefea..ff86f702c 100644 --- a/toolchains/nl/zh/CN/toolchains_overview.md +++ b/toolchains/nl/zh/CN/toolchains_overview.md @@ -1,160 +1,160 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# 开始使用工具链 (Beta) -{: #toolchains_getting_started} - -上次更新时间：2016 年 10 月 7 日 -{: .last-updated} - -{{site.data.keyword.Bluemix}} 的 Public 和 Dedicated 环境中可使用工具链。您可以使用两种方法来创建工具链：使用模板创建工具链，或者通过应用程序创建工具链。在 {{site.data.keyword.Bluemix_notm}} Public 中，工具链仅在美国南部区域可用。 -{: shortdesc} - -##开始使用工具链：Public -{: #getting_started_public} - -**注：**请查看顶部条幅，以确保是在“新 Bluemix 体验”中执行操作。 - - * 如果看到有关尝试新 Bluemix 的消息，那么说明您是在“经典 Bluemix 体验”中执行操作。单击该链接以打开“新 Bluemix 体验”。 - * 如果没有看到该消息，那么说们您已经在“新 Bluemix 体验”中。 - -每一个工具链都与特定组织相关联，且作为该组织成员的任何用户都可以访问其关联的工具链。创建工具链之前，请确保您在想要创建工具链的组织中工作。您当前正在哪个组织中工作会显示在菜单栏中。要切换到其他组织，请单击菜单栏中的该组织，然后选择您要切换到的组织。 - -###通过模板创建工具链 -{: #creating_a_toolchain_from_a_template} - -您可以使用模板作为起始点，来创建包含一组特定工具集成的工具链。 - -1. 如果是创建第一个工具链，请确保组织中已启用工具链： - 1. 打开 DevOps 仪表板，然后单击**工具链**页面。 - 2. 如果显示**启用工具链**按钮，请在其上单击，并遵循提示来创建工具链。 - 3. 如果未显示**启用工具链**按钮，表明工具链已启用。请转至步骤 2。 -1. 在 DevOps 仪表板的**工具链**页面上，单击添加按钮 (+)，以创建工具链。 -1. 单击工具链模板。例如，要使用网上商店样本来创建工具链，请单击**微型服务工具链**。 -1. 在工具链创建页面上，复查您要创建的工具链的图。该图显示工具链中处于其生命周期阶段的每一个工具集成。以下图像中的图是示例。创建工具链时，该图显示属于工具链的每一个工具集成。 -![工具链图](images/toolchain_diagram.png) - -1. 复查工具链设置的缺省信息。工具链名称使其可在 {{site.data.keyword.Bluemix_notm}} 中进行识别。如果您的工具链已经具有该名称，或者您想要使用不同的名称，请更改工具链的名称。 -1. 在“可配置的集成”部分中，选择要为工具链配置的每一个工具集成。有些工具集成无需进行任何配置。有关配置工具集成的信息，请参阅[配置工具集成（在新窗口中打开链接）](../toolchains/toolchains_integrations.html){: new_window}。 -1. 单击**创建**。此时将自动运行数个步骤，以设置工具链： - - * 创建工具链。 - * 如果已配置 Delivery Pipeline 工具集成，那么会触发管道。 - * 如果已配置 Sauce Labs 工具集成，那么 Sauce Labs 集成会配置为向管道添加作业，并运行测试。 - * 如果已配置 PagerDuty 工具集成，那么 PagerDuty 集成会配置为向您在 Slack 中配置的通道发送通知。这些通知指示何时发生问题。 - * 如果已配置 Slack 工具集成，那么 Slack 集成会配置为向您在 Slack 中配置的通道发送通知。这些通知指示部署的进度；例如，`已与项目 XYZ 连接`、`已配置管道`和`已启动“构建”阶段`。 - * 如果已配置 GitHub 工具集成，那么样本 GitHub 存储库会克隆到 GitHub 帐户。 - - -###通过应用程序创建工具链 -{: #creating_a_toolchain_from_an_app} - -您可以从应用程序创建工具链。工具链可以支持持续开发、部署、监视等操作，且与应用程序相关联。每一个应用程序都可以与工具链相关联。当您将更改推送到工具链的 GitHub 存储库时，管道会自动构建和部署应用程序。 - -1. 如果是创建第一个工具链，请确保组织中已启用工具链： - 1. 打开 DevOps 仪表板，然后单击**工具链**页面。 - 2. 如果显示**启用工具链**按钮，请在其上单击，并遵循提示来创建工具链。 - 3. 如果未显示**启用工具链**按钮，表明工具链已启用。请转至步骤 2。 -1. 在应用程序“概述”页面的“持续交付”磁贴上，单击**启用**。或者，在 {{site.data.keyword.Bluemix_notm}}“典型经验”中，在应用程序的“概述”页面的右上角，单击**添加工具链**。此时，将会对您的应用程序进行配置，以便可通过填充应用程序入门模板代码的新 GitHub 存储库，进行持续交付。 -1. 在工具链创建页面上，复查您要创建的工具链的图。该图显示工具链中处于其生命周期阶段的每一个工具集成。 -1. 复查工具链设置的缺省信息。工具链名称使其可在 {{site.data.keyword.Bluemix_notm}} 中进行识别。如果您的工具链已经具有该名称，或者您想要使用不同的名称，请更改工具链的名称。 -1. 在“可配置的集成”部分中，选择要为工具链配置的每一个工具集成。有些工具集成无需进行任何配置。有关配置工具集成的信息，请参阅[配置工具集成（在新窗口中打开链接）](../toolchains/toolchains_integrations.html){: new_window}。 -1. 单击**创建**。此时将自动运行数个步骤，以设置工具链： - - * 创建工具链。 - * 如果已配置 Delivery Pipeline 工具集成，那么会触发管道。 - * 如果已配置 Sauce Labs 工具集成，那么 Sauce Labs 集成会配置为向管道添加作业，并运行测试。 - * 如果已配置 PagerDuty 工具集成，那么 PagerDuty 集成会配置为向您在 Slack 中配置的通道发送通知。这些通知指示何时发生问题。 - * 如果已配置 Slack 工具集成，那么 Slack 集成会配置为向您在 Slack 中配置的通道发送通知。这些通知指示部署的进度；例如，`已与项目 XYZ 连接`、`已配置管道`和`已启动“构建”阶段`。 - * 如果已配置 GitHub 工具集成，那么样本 GitHub 存储库会克隆到 GitHub 帐户。 - - -##开始使用工具链：Dedicated -{: #getting_started_dedicated} - -每一个工具链都与特定组织相关联，且作为该组织成员的任何用户都可以访问其关联的工具链。创建工具链之前，请单击菜单栏中的 **{{site.data.keyword.avatar}}** 图标 ![Avatar 图标](../icons/i-avatar-icon.svg)，以打开“帐户和支持”窗口小部件，并查看您正在其中工作的组织。如果该组织不是您要创建工具链的组织，请切换为其他组织。 - -###通过模板创建工具链 -{: #creating_a_toolchain_from_a_template_dedicated} - -您可以使用模板作为起始点，来创建包含一组特定工具集成的工具链。 - -1. 如果是创建第一个工具链，请确保组织中已启用工具链： - 1. 打开 DevOps 仪表板，并单击**工具链**选项卡。 - 2. 如果显示**启用工具链**按钮，请在其上单击，并遵循提示来创建工具链。 - 3. 如果未显示**启用工具链**按钮，表明工具链已启用。请转至步骤 2。 -1. 在 {{site.data.keyword.Bluemix_notm}} 仪表板的 **DEVOPS** 选项卡上，单击添加按钮 (+)，以创建工具链。 -1. 单击工具链模板。例如，要创建简单工具链来部署新的 Cloud Foundry 应用程序，请单击**简单 Cloud Foundry 工具链**。 -1. 在工具链创建页面上，复查您要创建的工具链的图。该图显示工具链中处于其生命周期阶段的每一个工具集成。以下图像中的图是示例。创建工具链时，该图显示属于工具链的每一个工具集成。 -![Dedicated 工具链图](images/toolchain_dedicated_diagram.png) - -1. 复查工具链设置的缺省信息。工具链名称使其可在 {{site.data.keyword.Bluemix_notm}} 中进行识别。如果您的工具链已经具有该名称，或者您想要使用不同的名称，请更改工具链的名称。 -1. 在“可配置的集成”部分中，选择要为工具链配置的每一个工具集成。有些工具集成无需进行任何配置。有关配置工具集成的信息，请参阅[配置工具集成（在新窗口中打开链接）](../toolchains/toolchains_integrations.html){: new_window}。 -1. 单击**创建**。此时将自动运行数个步骤，以设置工具链： - - * 创建工具链。 - * 如果已配置 Delivery Pipeline 工具集成，那么会触发管道。 - * 如果已配置 GitHub Enterprise 工具集成，那么样本 GitHub Enterprise 存储库会克隆到 GitHub Enterprise 帐户。 - - -###通过应用程序创建工具链 -{: #creating_a_toolchain_from_an_app_dedicated} - -您可以从应用程序创建工具链。工具链可以支持持续开发、部署、监视等操作，且与应用程序相关联。每一个应用程序都可以与工具链相关联。当您将更改推送到工具链的 GitHub Enterprise 存储库时，管道会自动构建和部署应用程序。 - -1. 如果是创建第一个工具链，请确保组织中已启用工具链： - 1. 打开 DevOps 仪表板，并单击**工具链**选项卡。 - 2. 如果显示**启用工具链**按钮，请在其上单击，并遵循提示来创建工具链。 - 3. 如果未显示**启用工具链**按钮，表明工具链已启用。请转至步骤 2。 -1. 在应用程序“概述”页面的右上角，单击**添加工具链**。此时，将会对您的应用程序进行配置，以便可通过填充应用程序入门模板代码的新 GitHub Enterprise 存储库，进行持续交付。 -1. 在工具链创建页面上，复查您要创建的工具链的图。该图显示工具链中处于其生命周期阶段的每一个工具集成。 -1. 复查工具链设置的缺省信息。工具链名称使其可在 {{site.data.keyword.Bluemix_notm}} 中进行识别。如果您的工具链已经具有该名称，或者您想要使用不同的名称，请更改工具链的名称。 -1. 在“可配置的集成”部分中，选择要为工具链配置的每一个工具集成。有些工具集成无需进行任何配置。有关配置工具集成的信息，请参阅[配置工具集成（在新窗口中打开链接）](../toolchains/toolchains_integrations.html){: new_window}。 -1. 单击**创建**。此时将自动运行数个步骤，以设置工具链： - - * 创建工具链。 - * 如果已配置 Delivery Pipeline 工具集成，那么会触发管道。 - * 如果已配置 GitHub Enterprise 工具集成，那么样本 GitHub Enterprise 存储库会克隆到 GitHub Enterprise 帐户。 - - -##查看工具链 -{: #viewing_a_toolchain} - -配置工具链及其工具集成之后，您可以在“工具集成”页面中，查看工具链的可视化表示。 - -* 如果使用的是 {{site.data.keyword.Bluemix_notm}} Public，请在 DevOps 仪表板的**工具链**页面上单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 - -* 如果使用的是 {{site.data.keyword.Bluemix_notm}} Dedicated，请在仪表板的 **DEVOPS** 选项卡上，单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。 - -* 要访问工具链中的工具集成，请单击工具的磁贴。 - - **提示**：如果您具有多个 GitHub 或 GitHub Enterprise 存储库，那么相同的工具集成可能具有多个磁贴，因为每一个存储库由其自己的磁贴表示。 - - - - - -# 相关链接 -{: #rellinks} - -## 教程与样本 -{: #samples} - -* [Create an application with three microservices (Beta)（在新窗口中打开链接）](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} -* [在 {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) 上从模板创建工具链（在新窗口中打开链接）](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} -* [在 {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) 上从应用程序创建工具链（在新窗口中打开链接）](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} - -## 相关链接 -{: #general} - -* [Microservices toolchain (Beta)（在新窗口中打开链接）](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} -* [Simple toolchain (Beta)（在新窗口中打开链接）](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} -* [IBM Bluemix Garage Method（在新窗口中打开链接）](https://www.ibm.com/devops/method){:new_window} +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# 开始使用工具链 (Beta) +{: #toolchains_getting_started} + +上次更新时间：2016 年 10 月 7 日 +{: .last-updated} + +{{site.data.keyword.Bluemix}} 的 Public 和 Dedicated 环境中可使用工具链。您可以使用两种方法来创建工具链：使用模板创建工具链，或者通过应用程序创建工具链。在 {{site.data.keyword.Bluemix_notm}} Public 中，工具链仅在美国南部区域可用。 +{: shortdesc} + +## 开始使用工具链：Public +{: #getting_started_public} + +**注：**请查看顶部条幅，以确保是在“新 Bluemix 体验”中执行操作。 + + * 如果看到有关尝试新 Bluemix 的消息，那么说明您是在“经典 Bluemix 体验”中执行操作。单击该链接以打开“新 Bluemix 体验”。 + * 如果没有看到该消息，那么说们您已经在“新 Bluemix 体验”中。 + +每一个工具链都与特定组织相关联，且作为该组织成员的任何用户都可以访问其关联的工具链。创建工具链之前，请确保您在想要创建工具链的组织中工作。您当前正在哪个组织中工作会显示在菜单栏中。要切换到其他组织，请单击菜单栏中的该组织，然后选择您要切换到的组织。 + +### 通过模板创建工具链 +{: #creating_a_toolchain_from_a_template} + +您可以使用模板作为起始点，来创建包含一组特定工具集成的工具链。 + +1. 如果是创建第一个工具链，请确保组织中已启用工具链： + 1. 打开 DevOps 仪表板，然后单击**工具链**页面。 + 2. 如果显示**启用工具链**按钮，请在其上单击，并遵循提示来创建工具链。 + 3. 如果未显示**启用工具链**按钮，表明工具链已启用。请转至步骤 2。 +1. 在 DevOps 仪表板的**工具链**页面上，单击添加按钮 (+)，以创建工具链。 +1. 单击工具链模板。例如，要使用网上商店样本来创建工具链，请单击**微型服务工具链**。 +1. 在工具链创建页面上，复查您要创建的工具链的图。该图显示工具链中处于其生命周期阶段的每一个工具集成。以下图像中的图是示例。创建工具链时，该图显示属于工具链的每一个工具集成。 +![工具链图](images/toolchain_diagram.png) + +1. 复查工具链设置的缺省信息。工具链名称使其可在 {{site.data.keyword.Bluemix_notm}} 中进行识别。如果您的工具链已经具有该名称，或者您想要使用不同的名称，请更改工具链的名称。 +1. 在“可配置的集成”部分中，选择要为工具链配置的每一个工具集成。有些工具集成无需进行任何配置。有关配置工具集成的信息，请参阅[配置工具集成（在新窗口中打开链接）](../toolchains/toolchains_integrations.html){: new_window}。 +1. 单击**创建**。此时将自动运行数个步骤，以设置工具链： + + * 创建工具链。 + * 如果已配置 Delivery Pipeline 工具集成，那么会触发管道。 + * 如果已配置 Sauce Labs 工具集成，那么 Sauce Labs 集成会配置为向管道添加作业，并运行测试。 + * 如果已配置 PagerDuty 工具集成，那么 PagerDuty 集成会配置为向您在 Slack 中配置的通道发送通知。这些通知指示何时发生问题。 + * 如果已配置 Slack 工具集成，那么 Slack 集成会配置为向您在 Slack 中配置的通道发送通知。这些通知指示部署的进度；例如，`已与项目 XYZ 连接`、`已配置管道`和`已启动“构建”阶段`。 + * 如果已配置 GitHub 工具集成，那么样本 GitHub 存储库会克隆到 GitHub 帐户。 + + +### 通过应用程序创建工具链 +{: #creating_a_toolchain_from_an_app} + +您可以从应用程序创建工具链。工具链可以支持持续开发、部署、监视等操作，且与应用程序相关联。每一个应用程序都可以与工具链相关联。当您将更改推送到工具链的 GitHub 存储库时，管道会自动构建和部署应用程序。 + +1. 如果是创建第一个工具链，请确保组织中已启用工具链： + 1. 打开 DevOps 仪表板，然后单击**工具链**页面。 + 2. 如果显示**启用工具链**按钮，请在其上单击，并遵循提示来创建工具链。 + 3. 如果未显示**启用工具链**按钮，表明工具链已启用。请转至步骤 2。 +1. 在应用程序“概述”页面的“持续交付”磁贴上，单击**启用**。或者，在 {{site.data.keyword.Bluemix_notm}}“典型经验”中，在应用程序的“概述”页面的右上角，单击**添加工具链**。此时，将会对您的应用程序进行配置，以便可通过填充应用程序入门模板代码的新 GitHub 存储库，进行持续交付。 +1. 在工具链创建页面上，复查您要创建的工具链的图。该图显示工具链中处于其生命周期阶段的每一个工具集成。 +1. 复查工具链设置的缺省信息。工具链名称使其可在 {{site.data.keyword.Bluemix_notm}} 中进行识别。如果您的工具链已经具有该名称，或者您想要使用不同的名称，请更改工具链的名称。 +1. 在“可配置的集成”部分中，选择要为工具链配置的每一个工具集成。有些工具集成无需进行任何配置。有关配置工具集成的信息，请参阅[配置工具集成（在新窗口中打开链接）](../toolchains/toolchains_integrations.html){: new_window}。 +1. 单击**创建**。此时将自动运行数个步骤，以设置工具链： + + * 创建工具链。 + * 如果已配置 Delivery Pipeline 工具集成，那么会触发管道。 + * 如果已配置 Sauce Labs 工具集成，那么 Sauce Labs 集成会配置为向管道添加作业，并运行测试。 + * 如果已配置 PagerDuty 工具集成，那么 PagerDuty 集成会配置为向您在 Slack 中配置的通道发送通知。这些通知指示何时发生问题。 + * 如果已配置 Slack 工具集成，那么 Slack 集成会配置为向您在 Slack 中配置的通道发送通知。这些通知指示部署的进度；例如，`已与项目 XYZ 连接`、`已配置管道`和`已启动“构建”阶段`。 + * 如果已配置 GitHub 工具集成，那么样本 GitHub 存储库会克隆到 GitHub 帐户。 + + +## 开始使用工具链：Dedicated +{: #getting_started_dedicated} + +每一个工具链都与特定组织相关联，且作为该组织成员的任何用户都可以访问其关联的工具链。创建工具链之前，请单击菜单栏中的 **{{site.data.keyword.avatar}}** 图标 ![Avatar 图标](../icons/i-avatar-icon.svg)，以打开“帐户和支持”窗口小部件，并查看您正在其中工作的组织。如果该组织不是您要创建工具链的组织，请切换为其他组织。 + +### 通过模板创建工具链 +{: #creating_a_toolchain_from_a_template_dedicated} + +您可以使用模板作为起始点，来创建包含一组特定工具集成的工具链。 + +1. 如果是创建第一个工具链，请确保组织中已启用工具链： + 1. 打开 DevOps 仪表板，并单击**工具链**选项卡。 + 2. 如果显示**启用工具链**按钮，请在其上单击，并遵循提示来创建工具链。 + 3. 如果未显示**启用工具链**按钮，表明工具链已启用。请转至步骤 2。 +1. 在 {{site.data.keyword.Bluemix_notm}} 仪表板的 **DEVOPS** 选项卡上，单击添加按钮 (+)，以创建工具链。 +1. 单击工具链模板。例如，要创建简单工具链来部署新的 Cloud Foundry 应用程序，请单击**简单 Cloud Foundry 工具链**。 +1. 在工具链创建页面上，复查您要创建的工具链的图。该图显示工具链中处于其生命周期阶段的每一个工具集成。以下图像中的图是示例。创建工具链时，该图显示属于工具链的每一个工具集成。 +![Dedicated 工具链图](images/toolchain_dedicated_diagram.png) + +1. 复查工具链设置的缺省信息。工具链名称使其可在 {{site.data.keyword.Bluemix_notm}} 中进行识别。如果您的工具链已经具有该名称，或者您想要使用不同的名称，请更改工具链的名称。 +1. 在“可配置的集成”部分中，选择要为工具链配置的每一个工具集成。有些工具集成无需进行任何配置。有关配置工具集成的信息，请参阅[配置工具集成（在新窗口中打开链接）](../toolchains/toolchains_integrations.html){: new_window}。 +1. 单击**创建**。此时将自动运行数个步骤，以设置工具链： + + * 创建工具链。 + * 如果已配置 Delivery Pipeline 工具集成，那么会触发管道。 + * 如果已配置 GitHub Enterprise 工具集成，那么样本 GitHub Enterprise 存储库会克隆到 GitHub Enterprise 帐户。 + + +### 通过应用程序创建工具链 +{: #creating_a_toolchain_from_an_app_dedicated} + +您可以从应用程序创建工具链。工具链可以支持持续开发、部署、监视等操作，且与应用程序相关联。每一个应用程序都可以与工具链相关联。当您将更改推送到工具链的 GitHub Enterprise 存储库时，管道会自动构建和部署应用程序。 + +1. 如果是创建第一个工具链，请确保组织中已启用工具链： + 1. 打开 DevOps 仪表板，并单击**工具链**选项卡。 + 2. 如果显示**启用工具链**按钮，请在其上单击，并遵循提示来创建工具链。 + 3. 如果未显示**启用工具链**按钮，表明工具链已启用。请转至步骤 2。 +1. 在应用程序“概述”页面的右上角，单击**添加工具链**。此时，将会对您的应用程序进行配置，以便可通过填充应用程序入门模板代码的新 GitHub Enterprise 存储库，进行持续交付。 +1. 在工具链创建页面上，复查您要创建的工具链的图。该图显示工具链中处于其生命周期阶段的每一个工具集成。 +1. 复查工具链设置的缺省信息。工具链名称使其可在 {{site.data.keyword.Bluemix_notm}} 中进行识别。如果您的工具链已经具有该名称，或者您想要使用不同的名称，请更改工具链的名称。 +1. 在“可配置的集成”部分中，选择要为工具链配置的每一个工具集成。有些工具集成无需进行任何配置。有关配置工具集成的信息，请参阅[配置工具集成（在新窗口中打开链接）](../toolchains/toolchains_integrations.html){: new_window}。 +1. 单击**创建**。此时将自动运行数个步骤，以设置工具链： + + * 创建工具链。 + * 如果已配置 Delivery Pipeline 工具集成，那么会触发管道。 + * 如果已配置 GitHub Enterprise 工具集成，那么样本 GitHub Enterprise 存储库会克隆到 GitHub Enterprise 帐户。 + + +## 查看工具链 +{: #viewing_a_toolchain} + +配置工具链及其工具集成之后，您可以在“工具集成”页面中，查看工具链的可视化表示。 + +* 如果使用的是 {{site.data.keyword.Bluemix_notm}} Public，请在 DevOps 仪表板的**工具链**页面上单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**。然后，单击**工具集成**。 + +* 如果使用的是 {{site.data.keyword.Bluemix_notm}} Dedicated，请在仪表板的 **DEVOPS** 选项卡上，单击该工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。 + +* 要访问工具链中的工具集成，请单击工具的磁贴。 + + **提示**：如果您具有多个 GitHub 或 GitHub Enterprise 存储库，那么相同的工具集成可能具有多个磁贴，因为每一个存储库由其自己的磁贴表示。 + + + + + +# 相关链接 +{: #rellinks} + +## 教程与样本 +{: #samples} + +* [Create an application with three microservices (Beta)（在新窗口中打开链接）](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} +* [在 {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) 上从模板创建工具链（在新窗口中打开链接）](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} +* [在 {{site.data.keyword.Bluemix_notm}} Dedicated (Beta) 上从应用程序创建工具链（在新窗口中打开链接）](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} + +## 相关链接 +{: #general} + +* [Microservices toolchain (Beta)（在新窗口中打开链接）](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} +* [Simple toolchain (Beta)（在新窗口中打开链接）](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} +* [IBM Bluemix Garage Method（在新窗口中打开链接）](https://www.ibm.com/devops/method){:new_window} diff --git a/toolchains/nl/zh/CN/toolchains_using.md b/toolchains/nl/zh/CN/toolchains_using.md index 637ece520..c559e2456 100644 --- a/toolchains/nl/zh/CN/toolchains_using.md +++ b/toolchains/nl/zh/CN/toolchains_using.md @@ -1,98 +1,98 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# 在 {{site.data.keyword.Bluemix_notm}} Public 中使用工具链 -{: #toolchains-using} - -上次更新时间：2016 年 10 月 7 日 -{: .last-updated} - -您可以使用工具链，以使您的每日开发、部署和操作工作更富成效。设置工具链之后，您可以添加、删除或配置工具集成，并管理工具链的访问。 -工具链仅在美国南部区域可用。 -{: shortdesc} - -**注：**请查看顶部条幅，以确保是在“新 Bluemix 体验”中执行操作。 - - * 如果看到有关尝试新 Bluemix 的消息，那么说明您是在“经典 Bluemix 体验”中执行操作。单击该链接以打开“新 Bluemix 体验”。 - * 如果没有看到该消息，那么说们您已经在“新 Bluemix 体验”中。 - -## 配置工具集成 -{: #configuring_a_tool_integration} - -如果创建工具链时延迟了工具集成的配置，那么其磁贴上会显示**配置**按钮。如果创建工具链时配置了工具集成，可以更新配置设置。 - -1. 在 DevOps 仪表板的**工具链**页面上单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**，然后单击**工具集成**。 -1. 如果您需要全新配置工具集成，请在其磁贴上，单击**配置**。 - - ![“配置”按钮](images/toolchain_tile_configure.png) - - 完成配置工具集成时，单击**保存集成**。 - -1. 如果您需要更新工具集成的配置，请在其磁贴上，单击菜单以访问配置选项。 - - ![配置菜单](images/toolchain_tile_menu.png) - - 完成更新设置时，单击**保存集成**。 - -## 添加工具集成 -{: #adding_a_tool_integration} - -您可以为工具链添加和配置工具集成。 - -1. 在 DevOps 仪表板的**工具链**页面上单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**，然后单击**工具集成**。 -1. 要查看要添加的工具集成列表，请单击添加按钮 (+)。 -1. 单击要添加的工具集成。 -1. 输入配置工具集成所需的任何信息。 -1. 单击**创建集成**，以向工具链添加工具集成。 - -## 删除工具集成 -{: #deleting_a_tool_integration} - -如果从工具链删除工具集成，那么该删除操作无法撤销。 - -1. 在 DevOps 仪表板的**工具链**页面上单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**，然后单击**工具集成**。 -1. 在要删除的工具集成的磁贴上，单击菜单以访问配置选项。 -1. 要从工具链删除工具集成，请单击**删除**。 -1. 单击**删除**以确认。 - -## 管理访问权 -{: #managing_access} - -您可以通过将用户添加到与工具链相关联的组织，对用户授予工具链的访问权。每一个工具链都与特定组织相关联，且属于该组织成员的任何用户都可以访问相关联的工具链。您当前正在哪个组织中工作会显示在菜单栏中。单击该组织，然后切换到不同的组织以访问不同的工具链集。 - - - - - -1. 在 DevOps 仪表板的**工具链**页面上，单击要管理的工具链，然后单击**管理**。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**，然后单击**管理**。 -1. 单击指向组织的链接。 -1. 在“管理组织”页面上，单击**邀请用户**，并输入用户的电子邮件地址。 -1. 如果您想要授予高级许可权以管理 {{site.data.keyword.Bluemix_notm}} 组织中的用户，请选中**管理员**、**记帐管理员**或**审计员**复选框中的一个或多个。 -1. 单击**邀请**。 -1. 单击**保存**。 - -## 删除工具链 -{: #deleting_a_toolchain} - -您可以删除工具链，并指定您要删除的相关联工具集成。如果删除工具链，那么该删除操作无法撤销。 - -1. 在 DevOps 仪表板的**工具链**页面上，单击要删除的工具链，然后单击**管理**。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**，然后单击**管理**。 -1. 单击**删除工具链**，并复查或调整要删除的工具集成。 -1. 通过输入工具链的名称并单击**删除**，以确认删除。 - - **提示**：当您删除 GitHub 工具集成时，不会从 GitHub 删除相关联的 GitHub 存储库。您必须手动从 GitHub 除去存储库。 +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# 在 {{site.data.keyword.Bluemix_notm}} Public 中使用工具链 +{: #toolchains-using} + +上次更新时间：2016 年 10 月 7 日 +{: .last-updated} + +您可以使用工具链，以使您的每日开发、部署和操作工作更富成效。设置工具链之后，您可以添加、删除或配置工具集成，并管理工具链的访问。 +工具链仅在美国南部区域可用。 +{: shortdesc} + +**注：**请查看顶部条幅，以确保是在“新 Bluemix 体验”中执行操作。 + + * 如果看到有关尝试新 Bluemix 的消息，那么说明您是在“经典 Bluemix 体验”中执行操作。单击该链接以打开“新 Bluemix 体验”。 + * 如果没有看到该消息，那么说们您已经在“新 Bluemix 体验”中。 + +## 配置工具集成 +{: #configuring_a_tool_integration} + +如果创建工具链时延迟了工具集成的配置，那么其磁贴上会显示**配置**按钮。如果创建工具链时配置了工具集成，可以更新配置设置。 + +1. 在 DevOps 仪表板的**工具链**页面上单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**，然后单击**工具集成**。 +1. 如果您需要全新配置工具集成，请在其磁贴上，单击**配置**。 + + ![“配置”按钮](images/toolchain_tile_configure.png) + + 完成配置工具集成时，单击**保存集成**。 + +1. 如果您需要更新工具集成的配置，请在其磁贴上，单击菜单以访问配置选项。 + + ![配置菜单](images/toolchain_tile_menu.png) + + 完成更新设置时，单击**保存集成**。 + +## 添加工具集成 +{: #adding_a_tool_integration} + +您可以为工具链添加和配置工具集成。 + +1. 在 DevOps 仪表板的**工具链**页面上单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**，然后单击**工具集成**。 +1. 要查看要添加的工具集成列表，请单击添加按钮 (+)。 +1. 单击要添加的工具集成。 +1. 输入配置工具集成所需的任何信息。 +1. 单击**创建集成**，以向工具链添加工具集成。 + +## 删除工具集成 +{: #deleting_a_tool_integration} + +如果从工具链删除工具集成，那么该删除操作无法撤销。 + +1. 在 DevOps 仪表板的**工具链**页面上单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**，然后单击**工具集成**。 +1. 在要删除的工具集成的磁贴上，单击菜单以访问配置选项。 +1. 要从工具链删除工具集成，请单击**删除**。 +1. 单击**删除**以确认。 + +## 管理访问权 +{: #managing_access} + +您可以通过将用户添加到与工具链相关联的组织，对用户授予工具链的访问权。每一个工具链都与特定组织相关联，且属于该组织成员的任何用户都可以访问相关联的工具链。您当前正在哪个组织中工作会显示在菜单栏中。单击该组织，然后切换到不同的组织以访问不同的工具链集。 + + + + + +1. 在 DevOps 仪表板的**工具链**页面上，单击要管理的工具链，然后单击**管理**。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**，然后单击**管理**。 +1. 单击指向组织的链接。 +1. 在“管理组织”页面上，单击**邀请用户**，并输入用户的电子邮件地址。 +1. 如果您想要授予高级许可权以管理 {{site.data.keyword.Bluemix_notm}} 组织中的用户，请选中**管理员**、**记帐管理员**或**审计员**复选框中的一个或多个。 +1. 单击**邀请**。 +1. 单击**保存**。 + +## 删除工具链 +{: #deleting_a_toolchain} + +您可以删除工具链，并指定您要删除的相关联工具集成。如果删除工具链，那么该删除操作无法撤销。 + +1. 在 DevOps 仪表板的**工具链**页面上，单击要删除的工具链，然后单击**管理**。或者，在应用程序“概述”页面的“持续交付”磁贴上，单击**查看工具链**，然后单击**管理**。 +1. 单击**删除工具链**，并复查或调整要删除的工具集成。 +1. 通过输入工具链的名称并单击**删除**，以确认删除。 + + **提示**：当您删除 GitHub 工具集成时，不会从 GitHub 删除相关联的 GitHub 存储库。您必须手动从 GitHub 除去存储库。 diff --git a/toolchains/nl/zh/CN/toolchains_using_dedicated.md b/toolchains/nl/zh/CN/toolchains_using_dedicated.md index ab41612ad..04b4c5417 100644 --- a/toolchains/nl/zh/CN/toolchains_using_dedicated.md +++ b/toolchains/nl/zh/CN/toolchains_using_dedicated.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# 在 {{site.data.keyword.Bluemix_notm}} Dedicated 中使用工具链 -{: #toolchains-using_dedicated} - -上次更新时间：2016 年 9 月 13 日 -{: .last-updated} - -您可以使用工具链，以使您的每日开发、部署和操作工作更富成效。设置工具链之后，您可以添加、删除或配置工具集成，并管理工具链的访问。 -{: shortdesc} - -## 配置工具集成 -{: #configuring_a_tool_integration_dedicated} - -如果创建工具链时延迟了工具集成的配置，那么其磁贴上会显示**配置**按钮。如果创建工具链时配置了工具集成，可以更新配置设置。 - -1. 在仪表板的 **DEVOPS** 选项卡上，单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 -1. 如果您需要全新配置工具集成，请在其磁贴上，单击**配置**。 - - ![“配置”按钮](images/toolchain_tile_configure.png) - - 完成配置工具集成时，单击**保存集成**。 - -1. 如果您需要更新工具集成的配置，请在其磁贴上，单击菜单以访问配置选项。 - - ![配置菜单](images/toolchain_tile_menu.png) - - 完成更新设置时，单击**保存集成**。 - -## 添加工具集成 -{: #adding_a_tool_integration_dedicated} - -您可以为工具链添加和配置工具集成。 - -1. 在仪表板的 **DEVOPS** 选项卡上，单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 -1. 要查看要添加的工具集成列表，请单击添加按钮 (+)。 -1. 单击要添加的工具集成。 -1. 输入配置工具集成所需的任何信息。 -1. 单击**创建集成**，以向工具链添加工具集成。 - -## 删除工具集成 -{: #deleting_a_tool_integration} - -如果从工具链删除工具集成，那么该删除操作无法撤销。 - -1. 在仪表板的 **DEVOPS** 选项卡上，单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 -1. 在要删除的工具集成的磁贴上，单击菜单以访问配置选项。 -1. 要从工具链删除工具集成，请单击**删除**。 -1. 单击**删除**以确认。 - -## 管理访问权 -{: #managing_access_dedicated} - -您可以通过将用户添加到与工具链相关联的组织，对用户授予工具链的访问权。每一个工具链都与特定组织相关联，且属于该组织成员的任何用户都可以访问相关联的工具链。要查看您当前正在其中工作的组织，请单击菜单栏中的 **{{site.data.keyword.avatar}}** 图标 ![Avatar 图标](../icons/i-avatar-icon.svg)。要访问不同的工具链集，请切换到不同的组织。 - -将用户添加到 {{site.data.keyword.Bluemix}} 组织和空间后，用户可以使用他们的 {{site.data.keyword.Bluemix_notm}} 标识和密码登录到 GitHub Enterprise。用户登录之后，将会他们创建帐户。将用户添加到 {{site.data.keyword.Bluemix_notm}} 组织和空间后，他们不会自动添加到 GitHub Enterprise 存储库。必须由具有存储库管理权限的人员进行添加。有关更多信息，请参阅[使用 Dedicated GitHub Enterprise（在新窗口中打开链接）](../services/ghededicated/index.html){: new_window}。 - -要添加用户，请遵循以下步骤： - -1. 在仪表板的 **DEVOPS** 选项卡上，单击工具链，以打开其“工具集成”页面。然后，单击**管理**。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**管理**。 -1. 单击指向组织的链接。 -1. 在“管理组织”页面上，单击**邀请用户**，并输入用户的电子邮件地址。 -1. 如果您想要授予高级许可权以管理 {{site.data.keyword.Bluemix_notm}} 组织中的用户，请选中**管理员**、**记帐管理员**或**审计员**复选框中的一个或多个。 -1. 单击**邀请**。 -1. 单击**保存**。 - -## 删除工具链 -{: #deleting_a_toolchain_dedicated} - -您可以删除工具链，并指定您要删除的与其关联的工具集成。如果删除工具链，那么该删除操作无法撤销。 - -1. 在仪表板的 **DEVOPS** 选项卡上，单击工具链，以打开其“工具集成”页面。然后，单击**管理**。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**管理**。 -1. 单击**删除工具链**，并复查或调整要删除的工具集成。 -1. 通过输入工具链的名称并单击**删除**，以确认删除。 - - **提示**：当您删除 GitHub Enterprise 工具集成时，不会从 GitHub Enterprise 删除相关联的 GitHub Enterprise 存储库。必须手动从 GitHub Enterprise 除去存储库。 +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# 在 {{site.data.keyword.Bluemix_notm}} Dedicated 中使用工具链 +{: #toolchains-using_dedicated} + +上次更新时间：2016 年 9 月 13 日 +{: .last-updated} + +您可以使用工具链，以使您的每日开发、部署和操作工作更富成效。设置工具链之后，您可以添加、删除或配置工具集成，并管理工具链的访问。 +{: shortdesc} + +## 配置工具集成 +{: #configuring_a_tool_integration_dedicated} + +如果创建工具链时延迟了工具集成的配置，那么其磁贴上会显示**配置**按钮。如果创建工具链时配置了工具集成，可以更新配置设置。 + +1. 在仪表板的 **DEVOPS** 选项卡上，单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 +1. 如果您需要全新配置工具集成，请在其磁贴上，单击**配置**。 + + ![“配置”按钮](images/toolchain_tile_configure.png) + + 完成配置工具集成时，单击**保存集成**。 + +1. 如果您需要更新工具集成的配置，请在其磁贴上，单击菜单以访问配置选项。 + + ![配置菜单](images/toolchain_tile_menu.png) + + 完成更新设置时，单击**保存集成**。 + +## 添加工具集成 +{: #adding_a_tool_integration_dedicated} + +您可以为工具链添加和配置工具集成。 + +1. 在仪表板的 **DEVOPS** 选项卡上，单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 +1. 要查看要添加的工具集成列表，请单击添加按钮 (+)。 +1. 单击要添加的工具集成。 +1. 输入配置工具集成所需的任何信息。 +1. 单击**创建集成**，以向工具链添加工具集成。 + +## 删除工具集成 +{: #deleting_a_tool_integration} + +如果从工具链删除工具集成，那么该删除操作无法撤销。 + +1. 在仪表板的 **DEVOPS** 选项卡上，单击工具链，以打开其“工具集成”页面。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**工具集成**。 +1. 在要删除的工具集成的磁贴上，单击菜单以访问配置选项。 +1. 要从工具链删除工具集成，请单击**删除**。 +1. 单击**删除**以确认。 + +## 管理访问权 +{: #managing_access_dedicated} + +您可以通过将用户添加到与工具链相关联的组织，对用户授予工具链的访问权。每一个工具链都与特定组织相关联，且属于该组织成员的任何用户都可以访问相关联的工具链。要查看您当前正在其中工作的组织，请单击菜单栏中的 **{{site.data.keyword.avatar}}** 图标 ![Avatar 图标](../icons/i-avatar-icon.svg)。要访问不同的工具链集，请切换到不同的组织。 + +将用户添加到 {{site.data.keyword.Bluemix}} 组织和空间后，用户可以使用他们的 {{site.data.keyword.Bluemix_notm}} 标识和密码登录到 GitHub Enterprise。用户登录之后，将会他们创建帐户。将用户添加到 {{site.data.keyword.Bluemix_notm}} 组织和空间后，他们不会自动添加到 GitHub Enterprise 存储库。必须由具有存储库管理权限的人员进行添加。有关更多信息，请参阅[使用 Dedicated GitHub Enterprise（在新窗口中打开链接）](../services/ghededicated/index.html){: new_window}。 + +要添加用户，请遵循以下步骤： + +1. 在仪表板的 **DEVOPS** 选项卡上，单击工具链，以打开其“工具集成”页面。然后，单击**管理**。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**管理**。 +1. 单击指向组织的链接。 +1. 在“管理组织”页面上，单击**邀请用户**，并输入用户的电子邮件地址。 +1. 如果您想要授予高级许可权以管理 {{site.data.keyword.Bluemix_notm}} 组织中的用户，请选中**管理员**、**记帐管理员**或**审计员**复选框中的一个或多个。 +1. 单击**邀请**。 +1. 单击**保存**。 + +## 删除工具链 +{: #deleting_a_toolchain_dedicated} + +您可以删除工具链，并指定您要删除的与其关联的工具集成。如果删除工具链，那么该删除操作无法撤销。 + +1. 在仪表板的 **DEVOPS** 选项卡上，单击工具链，以打开其“工具集成”页面。然后，单击**管理**。或者，在应用程序“概述”页面的右上角，单击**查看工具链**。然后，单击**管理**。 +1. 单击**删除工具链**，并复查或调整要删除的工具集成。 +1. 通过输入工具链的名称并单击**删除**，以确认删除。 + + **提示**：当您删除 GitHub Enterprise 工具集成时，不会从 GitHub Enterprise 删除相关联的 GitHub Enterprise 存储库。必须手动从 GitHub Enterprise 除去存储库。 diff --git a/toolchains/nl/zh/CN/web_ide.md b/toolchains/nl/zh/CN/web_ide.md index d3b75cdb5..2fa6b3090 100644 --- a/toolchains/nl/zh/CN/web_ide.md +++ b/toolchains/nl/zh/CN/web_ide.md @@ -1,152 +1,152 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} -{:pre: .pre} - -# 使用 Eclipse Orion {{site.data.keyword.webide}} 编辑代码 -{: #web_ide} - -上次更新时间：2016 年 9 月 9 日 -{: .last-updated} - -Eclipse Orion {{site.data.keyword.webide}} 是基于浏览器的开发环境，可在其中针对 Web 进行开发。您可以借助内容辅助、代码完成和错误检查功能，在 JavaScript、HTML 和 CSS 中进行开发。{{site.data.keyword.webide}} 可使用几乎任何语言，并为大部分[文件类型（在新窗口中打开链接）](https://hub.jazz.net/docs/overview/#dev_support){: new_window}提供语法突出显示功能。源代码控制功能通过 Git 或 Jazz SCM 内置其中，因此您可以在本地部署代码并调试应用程序。 -{:shortdesc} - -最重要的是，{{site.data.keyword.webide}} 由 Web 提供支持。您无需进行任何安装、维护和扩展。您可以在具有因特网连接的任何地方进行开发。 - -## 设置编辑器 -{: #editorsetup} - -{{site.data.keyword.webide}} 可进行定制，因此您可以选择满足开发需要的颜色方案、技术工具和设置。要查看和修改设置，请从左侧菜单中，单击**设置**图标 “设置”图标。 - -如果在编辑时经常需要更改某些设置，您可以从编辑器右上角的**本地编辑器设置**图标 “本地编辑器设置”图标 快速访问这些设置。 - -![本地编辑器设置](images/webide_local_editor_settings.png) - -缺省情况下，始终显示编辑器样式和字体大小的设置。要在菜单中包含其他编辑器设置，请遵循以下步骤： - -1. 单击**本地编辑器设置**图标 “本地编辑器设置”图标。 - -2. 单击**编辑器设置**。 - -3. 要在**本地编辑器设置**菜单中包含或排除某个设置，请单击该设置旁边的圆圈。 - -![编辑器设置切换](images/webide_editor_settings_toggle.png) - - -## 编辑代码 -{: #editcode} - -{{site.data.keyword.webide}} 包含两个主要部分。第一个部分是左侧的文件导航器，以树结构显示您的项目文件。从文件导航器中，可以创建、重命名、删除以及管理文件和文件夹。 - -**提示：**要将文件上传到文件导航器中，请将文件从您的计算机拖动到文件导航器中。 - -第二个部分是右侧的编辑器窗格。编辑器提供多种编码功能，包括内容辅助和语法验证。 - -![Web IDE](images/webide.png) - -### 使用多个文件 -1. 要同时使用两个文件，请单击编辑器顶部的**更改分割编辑器方式**图标 “分割编辑器”图标。 -2. 从打开的菜单中，选择视图。 - - 选择视图之后，如果文件已在编辑器中打开，那么该文件将显示在两个编辑器视图中。 - - 要打开或更改其中一个编辑器视图中显示的文件，请执行以下操作： - 1. 将光标移至您要更改的编辑器视图中。 - 2. 在文件导航器中，单击某个文件。 - -### 键盘快捷键 -{{site.data.keyword.webide}} 中的大部分命令仅通过键盘快捷键即可访问。 - -要查看编辑器中的键盘快捷键列表，请按 Alt+Shift+?。如果使用的是 Mac OS，请按 Ctrl+Shift+?。 - -## 管理源代码 -{: #sourcecontrol} - -{{site.data.keyword.webide}} 与源代码管理工具相集成。要使用 Git 存储库，请单击 **Git 存储库**图标 “Git 存储库”图标。有关更多信息，请参阅[使用 Git 进行源代码控制（在新窗口中打开链接）](https://hub.jazz.net/docs/git/){: new_window}。 - - -## 从您的工作空间部署应用程序 -{: #deploy} - -1. 要部署应用程序，请从运行栏选择或[创建（在新窗口中打开链接）](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window}启动配置。 -1. 单击“部署”图标 “部署”图标。这时将使用工作空间的当前内容以及启动配置中定义的环境来部署应用程序的实例。 -2. 部署应用程序之后，您可以使用运行栏停止、重新启动或调试应用程序，以及查看日志等等。 -![运行栏](images/webide_runbar.png) - - - - ## 在 {{site.data.keyword.webide}} 以外进行编辑 -{: #editlocal} - -要使用 {{site.data.keyword.webide}} 以外的编辑器，请设置 {{site.data.keyword.Bluemix_live}}，以便您可以在任何工具中直接使用项目文件。{{site.data.keyword.Bluemix_live_notm}} 是一种命令行应用程序，其将本地文件系统中的更改与 {{site.data.keyword.jazzhub}} 中的云工作空间同步。 - -### 开始之前 - -下载并安装 [{{site.data.keyword.Bluemix_live_notm}} 命令行界面（在新窗口中打开链接）](http://livesyncdownload.ng.bluemix.net){: new_window}。 - -### 将本地环境与 {{site.data.keyword.Bluemix_notm}} 同步 -{: #edit_local_download} - -1. 打开命令行窗口。 -2. 登录到 {{site.data.keyword.Bluemix_notm}}： - - ``` - bl login - ``` - {: pre} - -3. 系统提示时，输入您的 IBM 标识和密码。 -4. 查看您的 {{site.data.keyword.Bluemix_notm}} 项目列表： - - ``` - bl projects - ``` - {: pre} - -4. 将本地环境与 {{site.data.keyword.Bluemix_notm}} 上的项目同步： - - ``` - bl sync projectName - ``` - {: pre} - -其中 `projectName` 是您的 {{site.data.keyword.Bluemix_notm}} 应用程序名称。 - -完成编辑后，请输入 `q` 以结束同步。 - -### 启用桌面同步功能以在本地编辑代码 - -“桌面同步”功能类似于命令行的“实时编辑”方式。您需要使用“桌面同步”功能来调试命令行。 -1. 在另一个命令行窗口中，启用“桌面同步”功能： - - ``` - cd localDirectory - bl start - ``` - {: codeblock} - -2. 使用您在 {{site.data.keyword.webide}} 中创建的启动配置。选择启动配置之后，“桌面同步”功能将在本地环境中启用。在您刚刚打开的命令行窗口中，您可以查看应用程序的 URL、调试 URL、管理 URL 以及查看 {{site.data.keyword.Bluemix_live_notm}} 状态。 - -3. 刷新浏览器，并验证您是否可以查看本地工作空间的静态文件中保存的更改。 - -### 禁用桌面同步功能 - -1. 在第二个命令行窗口中，输入 `bl stop`。 -2. 在第一个命令行窗口中，输入 `q`。 +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} +{:pre: .pre} + +# 使用 Eclipse Orion {{site.data.keyword.webide}} 编辑代码 +{: #web_ide} + +上次更新时间：2016 年 9 月 9 日 +{: .last-updated} + +Eclipse Orion {{site.data.keyword.webide}} 是基于浏览器的开发环境，可在其中针对 Web 进行开发。您可以借助内容辅助、代码完成和错误检查功能，在 JavaScript、HTML 和 CSS 中进行开发。{{site.data.keyword.webide}} 可使用几乎任何语言，并为大部分[文件类型（在新窗口中打开链接）](https://hub.jazz.net/docs/overview/#dev_support){: new_window}提供语法突出显示功能。源代码控制功能通过 Git 或 Jazz SCM 内置其中，因此您可以在本地部署代码并调试应用程序。 +{:shortdesc} + +最重要的是，{{site.data.keyword.webide}} 由 Web 提供支持。您无需进行任何安装、维护和扩展。您可以在具有因特网连接的任何地方进行开发。 + +## 设置编辑器 +{: #editorsetup} + +{{site.data.keyword.webide}} 可进行定制，因此您可以选择满足开发需要的颜色方案、技术工具和设置。要查看和修改设置，请从左侧菜单中，单击**设置**图标 “设置”图标。 + +如果在编辑时经常需要更改某些设置，您可以从编辑器右上角的**本地编辑器设置**图标 “本地编辑器设置”图标 快速访问这些设置。 + +![本地编辑器设置](images/webide_local_editor_settings.png) + +缺省情况下，始终显示编辑器样式和字体大小的设置。要在菜单中包含其他编辑器设置，请遵循以下步骤： + +1. 单击**本地编辑器设置**图标 “本地编辑器设置”图标。 + +2. 单击**编辑器设置**。 + +3. 要在**本地编辑器设置**菜单中包含或排除某个设置，请单击该设置旁边的圆圈。 + +![编辑器设置切换](images/webide_editor_settings_toggle.png) + + +## 编辑代码 +{: #editcode} + +{{site.data.keyword.webide}} 包含两个主要部分。第一个部分是左侧的文件导航器，以树结构显示您的项目文件。从文件导航器中，可以创建、重命名、删除以及管理文件和文件夹。 + +**提示：**要将文件上传到文件导航器中，请将文件从您的计算机拖动到文件导航器中。 + +第二个部分是右侧的编辑器窗格。编辑器提供多种编码功能，包括内容辅助和语法验证。 + +![Web IDE](images/webide.png) + +### 使用多个文件 +1. 要同时使用两个文件，请单击编辑器顶部的**更改分割编辑器方式**图标 “分割编辑器”图标。 +2. 从打开的菜单中，选择视图。 + + 选择视图之后，如果文件已在编辑器中打开，那么该文件将显示在两个编辑器视图中。 + + 要打开或更改其中一个编辑器视图中显示的文件，请执行以下操作： + 1. 将光标移至您要更改的编辑器视图中。 + 2. 在文件导航器中，单击某个文件。 + +### 键盘快捷键 +{{site.data.keyword.webide}} 中的大部分命令仅通过键盘快捷键即可访问。 + +要查看编辑器中的键盘快捷键列表，请按 Alt+Shift+?。如果使用的是 Mac OS，请按 Ctrl+Shift+?。 + +## 管理源代码 +{: #sourcecontrol} + +{{site.data.keyword.webide}} 与源代码管理工具相集成。要使用 Git 存储库，请单击 **Git 存储库**图标 “Git 存储库”图标。有关更多信息，请参阅[使用 Git 进行源代码控制（在新窗口中打开链接）](https://hub.jazz.net/docs/git/){: new_window}。 + + +## 从您的工作空间部署应用程序 +{: #deploy} + +1. 要部署应用程序，请从运行栏选择或[创建（在新窗口中打开链接）](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window}启动配置。 +1. 单击“部署”图标 “部署”图标。这时将使用工作空间的当前内容以及启动配置中定义的环境来部署应用程序的实例。 +2. 部署应用程序之后，您可以使用运行栏停止、重新启动或调试应用程序，以及查看日志等等。 +![运行栏](images/webide_runbar.png) + + + + ## 在 {{site.data.keyword.webide}} 以外进行编辑 +{: #editlocal} + +要使用 {{site.data.keyword.webide}} 以外的编辑器，请设置 {{site.data.keyword.Bluemix_live}}，以便您可以在任何工具中直接使用项目文件。{{site.data.keyword.Bluemix_live_notm}} 是一种命令行应用程序，其将本地文件系统中的更改与 {{site.data.keyword.jazzhub}} 中的云工作空间同步。 + +### 开始之前 + +下载并安装 [{{site.data.keyword.Bluemix_live_notm}} 命令行界面（在新窗口中打开链接）](http://livesyncdownload.ng.bluemix.net){: new_window}。 + +### 将本地环境与 {{site.data.keyword.Bluemix_notm}} 同步 +{: #edit_local_download} + +1. 打开命令行窗口。 +2. 登录到 {{site.data.keyword.Bluemix_notm}}： + + ``` + bl login + ``` + {: pre} + +3. 系统提示时，输入您的 IBM 标识和密码。 +4. 查看您的 {{site.data.keyword.Bluemix_notm}} 项目列表： + + ``` + bl projects + ``` + {: pre} + +4. 将本地环境与 {{site.data.keyword.Bluemix_notm}} 上的项目同步： + + ``` + bl sync projectName + ``` + {: pre} + +其中 `projectName` 是您的 {{site.data.keyword.Bluemix_notm}} 应用程序名称。 + +完成编辑后，请输入 `q` 以结束同步。 + +### 启用桌面同步功能以在本地编辑代码 + +“桌面同步”功能类似于命令行的“实时编辑”方式。您需要使用“桌面同步”功能来调试命令行。 +1. 在另一个命令行窗口中，启用“桌面同步”功能： + + ``` + cd localDirectory + bl start + ``` + {: codeblock} + +2. 使用您在 {{site.data.keyword.webide}} 中创建的启动配置。选择启动配置之后，“桌面同步”功能将在本地环境中启用。在您刚刚打开的命令行窗口中，您可以查看应用程序的 URL、调试 URL、管理 URL 以及查看 {{site.data.keyword.Bluemix_live_notm}} 状态。 + +3. 刷新浏览器，并验证您是否可以查看本地工作空间的静态文件中保存的更改。 + +### 禁用桌面同步功能 + +1. 在第二个命令行窗口中，输入 `bl stop`。 +2. 在第一个命令行窗口中，输入 `q`。 diff --git a/toolchains/nl/zh/TW/toolchains_about.md b/toolchains/nl/zh/TW/toolchains_about.md index 5695b93d9..8f2710d76 100644 --- a/toolchains/nl/zh/TW/toolchains_about.md +++ b/toolchains/nl/zh/TW/toolchains_about.md @@ -1,43 +1,43 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - - -# 關於工具鏈 -{: #toolchains_about} - -前次更新：2016 年 9 月 13 日 -{: .last-updated} - -*工具鏈* 是一組可支援開發、部署及操作作業的工具整合。工具鏈的集體力量大於其個別工具整合的總和。 - -{:shortdesc} - -工具鏈適用於 {{site.data.keyword.Bluemix}} 的「公用」及「專用」環境。您可以透過兩種方法建立工具鏈：使用範本來建立工具鏈，或從應用程式中建立工具鏈。作為起點，您可以使用工具鏈範本。根據您使用的範本，您可以建立具有一組特定工具整合的工具鏈，或是建立可在其中新增工具整合的空白工具鏈。 - -在「{{site.data.keyword.Bluemix_notm}} 公用」上，根據您使用的範本或工具鏈，工具鏈可能包括已移入應用程式入門範本程式碼和預先配置交付管線的 GitHub 儲存庫。將變更推送至工具鏈的 GitHub 儲存庫時，交付管線會自動建置應用程式，並將它部署至 {{site.data.keyword.Bluemix_notm}}。 - -在「{{site.data.keyword.Bluemix_notm}} 專用」上，根據您使用的工具鏈，工具鏈可能包括已移入應用程式入門範本程式碼和預先配置交付管線的 GitHub Enterprise 儲存庫。將變更推送至工具鏈的 GitHub Enterprise 儲存庫時，交付管線會自動建置應用程式，並將它部署至 {{site.data.keyword.Bluemix_notm}}。 - -## 取得工具鏈的協助及支援 -{: #gettinghelp} - -如果您在使用工具鏈時有問題或疑問，可以搜尋資訊或透過討論區提問來取得協助。您也可以開啟支援問題單。 - -使用討論區提問時，請標記您的問題，以便 {{site.data.keyword.Bluemix_notm}} 開發團隊能看到它。 - -* 如果您有使用工具鏈開發或部署應用程式的相關技術問題，請將問題張貼在 [Stack Overflow（在新視窗中開啟鏈結）](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window}，並使用 "ibm-bluemix" 和 "devops" 來標記您的問題。 - -* 若是工具鏈及開始使用指示的相關問題，請使用 [IBM developerWorks dW Answers（在新視窗中開啟鏈結）](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}討論區。請包含 "devops-services" 及 "bluemix" 標記。 - -如需使用討論區的詳細資料，請參閱[取得協助（在新視窗中開啟鏈結）](https://www.{DomainName}/docs/support/index.html#getting-help)。 - -如需開啟 IBM 支援問題單的相關資訊，或支援層次與問題單嚴重性的相關資訊，請參閱[與支援中心聯絡（在新視窗中開啟鏈結）](https://www.{DomainName}/docs/support/index.html#contacting-support)。 +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + + +# 關於工具鏈 +{: #toolchains_about} + +前次更新：2016 年 9 月 13 日 +{: .last-updated} + +*工具鏈* 是一組可支援開發、部署及操作作業的工具整合。工具鏈的集體力量大於其個別工具整合的總和。 + +{:shortdesc} + +工具鏈適用於 {{site.data.keyword.Bluemix}} 的「公用」及「專用」環境。您可以透過兩種方法建立工具鏈：使用範本來建立工具鏈，或從應用程式中建立工具鏈。作為起點，您可以使用工具鏈範本。根據您使用的範本，您可以建立具有一組特定工具整合的工具鏈，或是建立可在其中新增工具整合的空白工具鏈。 + +在「{{site.data.keyword.Bluemix_notm}} 公用」上，根據您使用的範本或工具鏈，工具鏈可能包括已移入應用程式入門範本程式碼和預先配置交付管線的 GitHub 儲存庫。將變更推送至工具鏈的 GitHub 儲存庫時，交付管線會自動建置應用程式，並將它部署至 {{site.data.keyword.Bluemix_notm}}。 + +在「{{site.data.keyword.Bluemix_notm}} 專用」上，根據您使用的工具鏈，工具鏈可能包括已移入應用程式入門範本程式碼和預先配置交付管線的 GitHub Enterprise 儲存庫。將變更推送至工具鏈的 GitHub Enterprise 儲存庫時，交付管線會自動建置應用程式，並將它部署至 {{site.data.keyword.Bluemix_notm}}。 + +## 取得工具鏈的協助及支援 +{: #gettinghelp} + +如果您在使用工具鏈時有問題或疑問，可以搜尋資訊或透過討論區提問來取得協助。您也可以開啟支援問題單。 + +使用討論區提問時，請標記您的問題，以便 {{site.data.keyword.Bluemix_notm}} 開發團隊能看到它。 + +* 如果您有使用工具鏈開發或部署應用程式的相關技術問題，請將問題張貼在 [Stack Overflow（在新視窗中開啟鏈結）](http://stackoverflow.com/search?q=devops+ibm-bluemix){:new_window}，並使用 "ibm-bluemix" 和 "devops" 來標記您的問題。 + +* 若是工具鏈及開始使用指示的相關問題，請使用 [IBM developerWorks dW Answers（在新視窗中開啟鏈結）](https://developer.ibm.com/answers/topics/devops-services/?smartspace=bluemix){:new_window}討論區。請包含 "devops-services" 及 "bluemix" 標記。 + +如需使用討論區的詳細資料，請參閱[取得協助（在新視窗中開啟鏈結）](https://www.{DomainName}/docs/support/index.html#getting-help)。 + +如需開啟 IBM 支援問題單的相關資訊，或支援層次與問題單嚴重性的相關資訊，請參閱[與支援中心聯絡（在新視窗中開啟鏈結）](https://www.{DomainName}/docs/support/index.html#contacting-support)。 diff --git a/toolchains/nl/zh/TW/toolchains_integrations.md b/toolchains/nl/zh/TW/toolchains_integrations.md index b2ca3bc3b..ae99db89f 100644 --- a/toolchains/nl/zh/TW/toolchains_integrations.md +++ b/toolchains/nl/zh/TW/toolchains_integrations.md @@ -1,304 +1,304 @@ ---- - -copyright: - years: 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} - -# 配置工具整合 -{: #integrations} - -前次更新：2016 年 10 月 18 日 -{: .last-updated} - -您可以在建立工具鏈時配置可支援開發、部署及操作作業的工具整合，也可以新增及配置用來自訂現有工具鏈的工具整合。 -{:shortdesc} - -**重要事項**：在「{{site.data.keyword.Bluemix_notm}} 公用」上，工具鏈只適用於美國南部地區。 - -根據是在「{{site.data.keyword.Bluemix_notm}} 公用」還是在「{{site.data.keyword.Bluemix_notm}} 專用」上使用工具鏈，可用來新增及配置工具鏈的工具整合會不同。如果您在「{{site.data.keyword.Bluemix_notm}} 專用」上使用工具鏈，則可供您使用的工具整合取決於 {{site.data.keyword.jazzhub_title}} 在特定環境上的設定方式。 - -*表格 1. 可用於「{{site.data.keyword.Bluemix_notm}} 公用」及「專用」上之工具鏈的工具整合* - -|工具整合 |可用於 {{site.data.keyword.Bluemix_notm}} 公用 |可用於 {{site.data.keyword.Bluemix_notm}} 專用（環境相依）| -|:----------|:------------------------------|:------------------| -|{{site.data.keyword.deliverypipeline}} |是 |是 | -|{{site.data.keyword.DRA_short}} |是 |否 | -|Eclipse Orion {{site.data.keyword.webide}} |是 |是 | -|GitHub |是 |是 | -|專用 GitHub Enterprise |否 |是 | -|其他工具 |是 |是 | -|PagerDuty |是 |是 | -|Sauce Labs |是 |否 | -|Slack |是 |是 | - -**提示**：如果您要在「{{site.data.keyword.Bluemix_notm}} 公用」上開始使用原始碼進行開發，請先配置 GitHub 工具整合，再配置 {{site.data.keyword.deliverypipeline}}。如果您要在「{{site.data.keyword.Bluemix_notm}} 專用」上開始使用程式碼進行開發，請先配置 {{site.data.keyword.ghe_short}} 工具整合或 GitHub 工作整合，再配置 {{site.data.keyword.deliverypipeline}}。 - - -## 配置 Delivery Pipeline -{: #deliverypipeline} - -{{site.data.keyword.deliverypipeline}} 會透過數個系列的階段來自動化專案的持續部署，而這些階段會擷取輸入及執行工作（例如建置、測試及部署）。 - -配置 {{site.data.keyword.deliverypipeline}} 來自動化您應用程式的持續建置、測試及部署： - -1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的 **Delivery Pipeline**。根據您使用的範本，可能會有不同的欄位。請檢閱預設欄位值，並在必要時變更那些設定。 -1. 如果您在「{{site.data.keyword.Bluemix_notm}} 公用」上有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。如果您是在「{{site.data.keyword.Bluemix_notm}} 專用」上使用工具鏈，請在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 按一下新增按鈕 (+)。 -1. 在「工具整合」區段中，按一下 **Delivery Pipeline**。 -1. 指定新管線的名稱。 -1. 如果您計劃使用管線來部署使用者介面，請選取**可檢視的應用程式**勾選框。管線所建立的所有應用程式都會顯示在工具鏈之「工具整合」頁面的**檢視應用程式**清單中。 -1. 按一下**建立整合**，以將 {{site.data.keyword.deliverypipeline}} 新增至您的工具鏈。 -1. 按一下 {{site.data.keyword.deliverypipeline}} 的磚來檢視管線，並對其進行配置。若要瞭解如何配置管線的基本觀念，請參閱[建置及部署管線（在新視窗中開啟鏈結）](../services/DeliveryPipeline/build_deploy.html){: new_window}。 - - **提示**：如果您要在將變更推送至 GitHub 或 {{site.data.keyword.ghe_short}} 儲存庫時觸發管線，必須先配置工具鏈的 GitHub 或 {{site.data.keyword.ghe_short}}，再定義管線的階段。管線階段需要儲存庫的 Git URL。每一個管線階段都只能參照與您工具鏈相關聯的其中一個 GitHub 或 {{site.data.keyword.ghe_short}} 儲存庫。如需配置 GitHub 的指示，請參閱 [GitHub](#github) 一節。如需配置「專用 GitHub Enterprise」的指示，請參閱[開始使用 {{site.data.keyword.ghe_long}}（在新視窗中開啟鏈結）](../services/ghededicated/index.html){: new_window}。 - -1. 選用項目：如果您是在「{{site.data.keyword.Bluemix_notm}} 公用」上使用工具鏈，並且想要 Sauce Labs 對您的應用程式執行測試，請配置 {{site.data.keyword.deliverypipeline}} 來新增 Sauce Labs 測試工作。如需配置測試工作的指示，請參閱[在管線中配置 Sauce Labs 測試工作](#config_saucelabs)一節。 - -### 在管線中配置 Sauce Labs 測試工作 -{: #config_saucelabs} - -您需要工作中管線有建置並部署應用程式的階段，而且必須為工具鏈配置 Sauce Labs，再於管線中配置 Sauce Labs 測試工作。如需配置 Sauce Labs 的指示，請參閱 [Sauce Labs](#saucelabs) 一節。 - -配置 {{site.data.keyword.deliverypipeline}} 來新增 Sauce Labs 測試工作： - -1. 如果您沒有可部署您應用程式之測試版本的階段，請建立一個。 -1. 在此階段中，於部署工作之後新增測試工作。將這些工作放在相同的階段中，它們即可存取一組相同的環境內容。 - ![測試工作](images/toolchain_test_job.png) - -1. 配置階段： - - a. 在**環境內容**標籤上，建立三個內容：CF_APP_NAME、SAUCE_USERNAME 及 SAUCE_ACCESS_KEY。 - - b. 輸入 Sauce Labs 使用者名稱和存取金鑰。這麼做可以提出那些值，以將它們用於測試中。 - -1. 配置部署工作。在**部署 Script** 欄位中，包括下列指令：`export CF_APP_NAME="$CF_APP"`。該指令會將應用程式名稱匯出為環境內容。 -1. 配置測試工作。下列影像中的值是範例。**服務實例**、**目標**、**組織**及**空間**欄位會移入您正在使用的 Sauce Labs 使用者名稱、地區、組織及空間。 -![配置工作](images/toolchain_configure_job.png) - - a. 針對測試器類型，選取 **Sauce Labs**。 - - b. 針對服務實例，選取您為工具鏈配置 Sauce Labs 時所使用的 Sauce Labs 使用者名稱。 - - **提示**：若要查看您為工具鏈配置 Sauce Labs 時所使用的使用者名稱和存取金鑰，請按一下**配置**。 - - c. 在**測試執行指令**欄位中，輸入可安裝測試所需相依關係的指令，然後執行測試。例如，針對 Node.js 應用程式，您可以輸入下列指令： - ``` - npm install - node_modules/grunt-cli/bin/grunt test:sauce:parallel - ``` - - d. 如果您要在測試工作日誌中查看測試報告，請選取**啟用測試報告**勾選框，然後將「測試結果檔案型樣」設為 `test/*.xml`。 - -1. 按一下**儲存**。只要執行管線，就會執行 Sauce Labs 測試。 - -若要進一步瞭解，請參閱 [Delivery Pipeline（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}。 - - -## 新增 {{site.data.keyword.DRA_short}} -{: #dra} - -{{site.data.keyword.DRA_full}} 會收集並分析單元測試、功能測試及程式碼涵蓋面工具的結果，來判定您的程式碼是否符合部署程序中所指定閘道的預先定義準則。如果程式碼不符合或超出準則，則會停止部署，以防止釋出風險。您可以使用「{{site.data.keyword.DRA_short}}」作為持續交付環境的安全網，或作為實作並改善品質標準的方法。 - - **附註**：這是預先配置的工具整合。它不需要任何配置參數，而且您無法重新配置它。 - -新增「{{site.data.keyword.DRA_short}}」來維護及改善您的程式碼在 {{site.data.keyword.Bluemix_notm}} 中的品質，方法是在發行部署之前監視部署來識別風險。 - -1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 按一下新增按鈕 (+)。 -1. 在「工具整合」區段中，按一下**部署風險分析**。 -1. 按一下**建立整合**。 -1. 按一下「{{site.data.keyword.DRA_short}}」的磚，然後完成開始使用步驟：建立準則，並將準則連接至管線，然後執行管線。如需相關資訊，請參閱 [{{site.data.keyword.DRA_short}}（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}。 - - -## 新增 Eclipse Orion {{site.data.keyword.webide}} -{: #webide} - -Eclipse Orion {{site.data.keyword.webide}} 是一個整合的 Web 型環境，您可以在其中建立、編輯、執行、除錯以及完成來源控制作業。您可以平順地從編輯移至執行，再移至提交，然後移至部署。 - - **附註**：這是預先配置的工具整合。它不需要任何配置參數，而且您無法重新配置它。 - -若要完成來源控制作業，請新增 Eclipse Orion {{site.data.keyword.webide}} 工具整合： - -1. 如果您在「{{site.data.keyword.Bluemix_notm}} 公用」上有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。如果您是在「{{site.data.keyword.Bluemix_notm}} 專用」上使用工具鏈，請在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 按一下新增按鈕 (+)。 -1. 在「工具整合」區段中，按一下 **Eclipse Orion Web IDE**。 -1. 按一下**建立整合**。 -1. 按一下新 Eclipse Orion {{site.data.keyword.webide}} 的磚。您的工作區會預先移入您的 GitHub 或 {{site.data.keyword.ghe_short}} 儲存庫。會強調顯示與現行工具鏈相關聯的儲存庫。 - -若要進一步瞭解，請參閱[使用 Eclipse Orion {{site.data.keyword.webide}} 編輯程式碼（在新視窗中開啟鏈結）](../toolchains/web_ide.html){: new_window}。 - - -## 配置 GitHub -{: #github} - -GitHub 是 Git 儲存庫的 Web 型管理服務。您可以同時具有儲存庫的本端和遠端副本，方便進行分工合作。 - -GitHub Issues 是一個追蹤工具，可將您的工作和方案都保留在一個位置。它會與您的開發儲存庫整合，以聚焦在重要作業。 - -配置 GitHub，以在雲端上管理您的原始碼： - -1. 如果您要在建立工具鏈時配置此工具整合，請遵循下列步驟： - - a. 在「可配置的整合」區段中，按一下 **GitHub**。如果您在「{{site.data.keyword.Bluemix_notm}} 公用」上建立工具鏈，但並未授權 {{site.data.keyword.Bluemix_notm}} 存取 GitHub，請按一下**授權**來移至 GitHub 網站。如果您沒有作用中的 GitHub 階段作業，則系統會提示您登入。按一下**授權應用程式**，以容許 {{site.data.keyword.Bluemix_notm}} 存取 GitHub 帳戶。如果您有作用中的 GitHub 階段作業，但最近未輸入過密碼，則系統可能會提示您輸入 GitHub 密碼進行確認。 - - b. 檢閱 GitHub 儲存庫的預設目標儲存庫位置。那些儲存庫是從範例儲存庫中複製而來。必要的話，請變更目標儲存庫的名稱。 - ![預設目標儲存庫位置](images/toolchain_github_config.png) - -1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 按一下新增按鈕 (+)。 -1. 在「工具整合」區段中，按一下 **GitHub**。 -1. 如果您有 GitHub 儲存庫並且想要使用它，請鍵入 URL。針對儲存庫類型，請按一下**鏈結**。 -1. 如果您要使用新的 GitHub 儲存庫，請鍵入 GitHub 儲存庫的名稱，並鍵入您所複製或分出之儲存庫的 URL，然後選取儲存庫類型： - - a. 若要建立空的儲存庫，請按一下**新建**。 - - b. 若要建立 GitHub 儲存庫的副本，請按一下**複製**。 - - c. 若要分出 GitHub 儲存庫，以透過取回要求來提出變更，請按一下**分出**。 - -1. 如果您要使用 GitHub Issues 進行問題追蹤，請選取**啟用 GitHub Issues** 勾選框。 -1. 按一下**建立整合**。 -1. 按一下您要使用之 GitHub 儲存庫的磚。即會開啟 GitHub 網站，您可以在其中檢視儲存庫的內容。 - - **提示**：您可以使用 Eclipse Orion {{site.data.keyword.webide}} 中的整合原始碼管理工具來編輯 GitHub 儲存庫，以及從工作區中部署應用程式。 - -1. 如果您已啟用 GitHub Issues，請按一下 GitHub Issues 的磚予以開啟。 - -如需相關資訊，請參閱 [GitHub（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window}及 [GitHub Issues（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}。 - - -## 配置專用 GitHub Enterprise -{: #configghe} - -「{{site.data.keyword.ghe_long}}」是 Git 儲存庫的內部部署 Web 型管理服務。「專用 GitHub Enterprise」僅供「{{site.data.keyword.Bluemix_notm}} 專用」客戶使用。GitHub Issues 是一個追蹤工具，可將您的工作及方案保留在一個位置。它會與您的開發儲存庫整合，以聚焦在重要作業。如需「專用 GitHub Enterprise」及 GitHub Issues 的相關資訊，請參閱[使用專用 GitHub Enterprise（在新視窗中開啟鏈結）](../services/ghededicated/index.html){: new_window}及 [GitHub Issues（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}。 - -您可以將 {{site.data.keyword.ghe_short}} 配置為工具鏈中的工具整合，以在公司的 [{{site.data.keyword.Bluemix_notm}} 專用（在新視窗中開啟鏈結）](../dedicated/index.html#dedicated){: new_window}實例中管理原始碼。 - -1. 如果您要在建立工具鏈時配置此工具整合，請遵循下列步驟： - - a. 第一次登入「專用 GitHub Enterprise」之前，請要求公司的地區管理者使用 LDAP 將您的使用者 ID 從公司的使用者登錄新增至「{{site.data.keyword.Bluemix_notm}} 專用」實例。如需設定 {{site.data.keyword.ghe_short}} 帳戶的相關資訊，請參閱[使用專用 GitHub Enterprise（在新視窗中開啟鏈結）](../services/ghededicated/index.html){: new_window}。 - - b. 在「可配置的整合」區段中，按一下 **{{site.data.keyword.ghe_short}}**。 - - c. 檢閱新 {{site.data.keyword.ghe_short}} 儲存庫的預設名稱。必要的話，請變更新儲存庫的名稱。下列影像顯示從範例儲存庫複製的儲存庫範例。您可以使用現有儲存庫或新儲存庫。若要使用新的儲存庫，您可以建立空的儲存庫、複製儲存庫，或分出儲存庫。 - ![預設儲存庫位置](images/toolchain_ghe_config.png) - -1. 如果您在「{{site.data.keyword.Bluemix_notm}} 公用」上有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。如果您是在「{{site.data.keyword.Bluemix_notm}} 專用」上使用工具鏈，請在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 按一下新增按鈕 (+)。 -1. 在「工具整合」區段中，按一下 **{{site.data.keyword.ghe_short}}**。 -1. 如果您有想要使用的 {{site.data.keyword.ghe_short}} 儲存庫，請鍵入儲存庫的 URL。針對儲存庫類型，請按一下**現有**。 -1. 如果您要使用新的 {{site.data.keyword.ghe_short}} 儲存庫，請鍵入儲存庫的名稱，並鍵入您所複製或分出之儲存庫的 URL，然後選取儲存庫類型： - - a. 若要建立空的儲存庫，請按一下**新建**。 - - b. 若要建立儲存庫的副本，請按一下**複製**。 - - c. 若要分出儲存庫，以透過取回要求來提出變更，請按一下**分出**。 - -1. 若要使用 GitHub Issues 進行問題追蹤，請選取**啟用 GitHub Issues** 勾選框。 -1. 按一下**建立整合**。 -1. 按一下您要使用之 {{site.data.keyword.ghe_short}} 儲存庫的磚。即會開啟您公司的 [{{site.data.keyword.Bluemix_notm}} 專用（在新視窗中開啟鏈結）](../dedicated/index.html#dedicated){: new_window}實例，您可以在其中檢視儲存庫的內容。 - - **提示**：您可以使用 Eclipse Orion {{site.data.keyword.webide}} 中的整合原始碼管理工具來編輯 {{site.data.keyword.ghe_short}} 儲存庫，以及從工作區中部署應用程式。 - -1. 如果您已啟用 GitHub Issues，請按一下 GitHub Issues 的磚。 - - - -## 配置自訂工具（其他工具） -{: #othertool} - -如果您的團隊使用未包含在工具鏈整合清單中的工具，您可以整合自訂工具。 - -配置自訂工具，使其可與工具鏈上的其他工具一起運作，且可供您的團隊使用： -1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的**其他工具**。 - -1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 按一下新增按鈕 (+)。 -1. 在「工具整合」區段中，按一下**其他工具**。 -1. 鍵入工具名稱。 -1. 選取與工具最密切關聯的生命週期階段。生命週期階段選擇可決定在「工具鏈整合」頁面上用來列出工具的種類。 -1. 新增圖示 URL。此圖示將出現在工具的整合卡上。 -1. 新增文件 URL。 -1. 指定工具實例名稱。例如：我的團隊工具。 -1. 新增工具實例 URL。按一下工具整合卡會導向至您為工具實例列出的 URL。 -1. 新增工具的說明。 -1. （進階）必要的話，新增其他內容。例如，列出您的工具與工具鏈中的其他工具整合時所需的任何資訊或屬性。 -1. 按一下**建立整合**。 - -## 配置 PagerDuty -{: #pagerduty} - -PagerDuty 會將多個監視系統中的資料整合至單一視圖。發生問題時，PagerDuty 可確保那時最能修正該問題的團隊成員收到通知。如果團隊成員未回應該問題，則可以配置呈報，將它遞送給次要工程師或作業管理員。 - -配置 PagerDuty 在管線階段失敗時傳送通知，讓您可以更快速地修正問題，並減少關閉時間： - -1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的 **PagerDuty**。 -1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 按一下新增按鈕 (+)。 -1. 在「工具整合」區段中，按一下 **PagerDuty**。 -1. 鍵入與 PagerDuty 帳戶相關聯的 PagerDuty 網站名稱。如果您沒有 PagerDuty 帳戶，請[註冊一個帳戶（在新視窗中開啟鏈結）](https://signup.pagerduty.com/accounts/new){: new_window}。 -1. 鍵入 PagerDuty 帳戶的 API 存取金鑰。如需尋找金鑰的指示，請參閱 [API 鑑別（在新視窗中開啟鏈結）](https://signup.pagerduty.com/accounts/new){: new_window}。 -1. 鍵入 PagerDuty 服務的名稱。 -1. 鍵入主要 PagerDuty 聯絡人的電子郵件位址。 -1. 鍵入主要 PagerDuty 聯絡人的電話號碼。 -1. 按一下**建立整合**。 -1. 按一下 PagerDuty 的磚以移至 pagerduty.com。您可以檢視與 PagerDuty 服務相關聯的事件，而 PagerDuty 服務是您在配置工具鏈的這個工具整合時所指定。 - -若要進一步瞭解，請參閱 [PagerDuty（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}。 - - -## 配置 Sauce Labs -{: #saucelabs} - -Sauce Labs 會執行功能單元測試。在 {{site.data.keyword.deliverypipeline}} 中將 Sauce Labs 測試套組配置為測試工作時，測試套組可以在持續交付處理程序期間對 Web 或行動應用程式執行測試。這些測試可以提供對專案的重要流程控制，作為防止部署不正確程式碼的閘道。 - -配置 Sauce Labs 對多個作業系統和瀏覽器執行自動化功能測試，讓您模擬使用者可能使用網站或應用程式的方式： - -1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的 **Sauce Labs**。 -1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 按一下新增按鈕 (+)。 -1. 在「工具整合」區段中，按一下 **Sauce Labs**。 -1. 鍵入與 Sauce Labs 帳戶相關聯的使用者名稱。您可以[在 Sauce Labs 帳戶頁面頂端的歡迎使用訊息中找到使用者名稱（在新視窗中開啟鏈結）](https://saucelabs.com/account){: new_window}。 -1. 鍵入 Sauce Labs 帳戶的存取金鑰。您可以[在 Sauce Labs 帳戶頁面上找到金鑰（在新視窗中開啟鏈結）](https://saucelabs.com/account){: new_window}。 -1. 按一下**建立整合**。 -1. 按一下 Sauce Labs 的磚以移至 saucelabs.com，然後檢視工具鏈的測試活動。 - - **提示**：如果您已將 Sauce Labs 測試工作新增至 {{site.data.keyword.deliverypipeline}}，則可以選取服務實例。 - -若要進一步瞭解，請參閱 [Sauce Labs（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}。 - - -## 配置 Slack -{: #slack} - -**重要事項**：團隊的所有人都可以看到張貼到公用 Slack 通道的通知。請記住，您需要自行負責所張貼的內容。 - -Slack 是一種雲端型、即時傳訊和通知系統。Slack 會提供持續性會談，這在進行團隊協同作業時比電子郵件更具互動性。您可以透過專用通道或與工作直接相關的一組通道來與團隊進行通訊。您也可以透過通道或兩位以上人員之間的直接訊息來共用檔案和影像。會保留透過直接訊息和通道的通訊，讓您可以搜尋它們。 - -配置 Slack 接收來自工具整合有關工具鏈的通知（例如測試和部署活動）： - -1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的 **Slack**。 -1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 按一下新增按鈕 (+)。 -1. 在「工具整合」區段中，按一下 **Slack**。 -1. 鍵入 Slack 帳戶的 API 鑑別記號。您必須使用產生的完整存取記號向 Slack 進行鑑別。如需尋找記號的指示，請參閱 [Slack 鑑別（在新視窗中開啟鏈結）](https://api.slack.com/web#authentication){: new_window}。 -1. 鍵入您要接收通知的 Slack 通道名稱。如果您指定的通道不存在，則會建立它。如果已保存通道，則會重新啟動它。 -1. 按一下**建立整合**。 -1. 按一下 Slack 的磚。您可以在已配置的 Slack 通道中檢視工具鏈的所有活動。 - -若要進一步瞭解，請參閱 [Slack（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}。 - - - - - - - - +--- + +copyright: + years: 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} + +# 配置工具整合 +{: #integrations} + +前次更新：2016 年 10 月 18 日 +{: .last-updated} + +您可以在建立工具鏈時配置可支援開發、部署及操作作業的工具整合，也可以新增及配置用來自訂現有工具鏈的工具整合。 +{:shortdesc} + +**重要事項**：在「{{site.data.keyword.Bluemix_notm}} 公用」上，工具鏈只適用於美國南部地區。 + +根據是在「{{site.data.keyword.Bluemix_notm}} 公用」還是在「{{site.data.keyword.Bluemix_notm}} 專用」上使用工具鏈，可用來新增及配置工具鏈的工具整合會不同。如果您在「{{site.data.keyword.Bluemix_notm}} 專用」上使用工具鏈，則可供您使用的工具整合取決於 {{site.data.keyword.jazzhub_title}} 在特定環境上的設定方式。 + +*表格 1. 可用於「{{site.data.keyword.Bluemix_notm}} 公用」及「專用」上之工具鏈的工具整合* + +|工具整合 |可用於 {{site.data.keyword.Bluemix_notm}} 公用 |可用於 {{site.data.keyword.Bluemix_notm}} 專用（環境相依）| +|:----------|:------------------------------|:------------------| +|{{site.data.keyword.deliverypipeline}} |是 |是 | +|{{site.data.keyword.DRA_short}} |是 |否 | +|Eclipse Orion {{site.data.keyword.webide}} |是 |是 | +|GitHub |是 |是 | +|專用 GitHub Enterprise |否 |是 | +|其他工具 |是 |是 | +|PagerDuty |是 |是 | +|Sauce Labs |是 |否 | +|Slack |是 |是 | + +**提示**：如果您要在「{{site.data.keyword.Bluemix_notm}} 公用」上開始使用原始碼進行開發，請先配置 GitHub 工具整合，再配置 {{site.data.keyword.deliverypipeline}}。如果您要在「{{site.data.keyword.Bluemix_notm}} 專用」上開始使用程式碼進行開發，請先配置 {{site.data.keyword.ghe_short}} 工具整合或 GitHub 工作整合，再配置 {{site.data.keyword.deliverypipeline}}。 + + +## 配置 Delivery Pipeline +{: #deliverypipeline} + +{{site.data.keyword.deliverypipeline}} 會透過數個系列的階段來自動化專案的持續部署，而這些階段會擷取輸入及執行工作（例如建置、測試及部署）。 + +配置 {{site.data.keyword.deliverypipeline}} 來自動化您應用程式的持續建置、測試及部署： + +1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的 **Delivery Pipeline**。根據您使用的範本，可能會有不同的欄位。請檢閱預設欄位值，並在必要時變更那些設定。 +1. 如果您在「{{site.data.keyword.Bluemix_notm}} 公用」上有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。如果您是在「{{site.data.keyword.Bluemix_notm}} 專用」上使用工具鏈，請在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 按一下新增按鈕 (+)。 +1. 在「工具整合」區段中，按一下 **Delivery Pipeline**。 +1. 指定新管線的名稱。 +1. 如果您計劃使用管線來部署使用者介面，請選取**可檢視的應用程式**勾選框。管線所建立的所有應用程式都會顯示在工具鏈之「工具整合」頁面的**檢視應用程式**清單中。 +1. 按一下**建立整合**，以將 {{site.data.keyword.deliverypipeline}} 新增至您的工具鏈。 +1. 按一下 {{site.data.keyword.deliverypipeline}} 的磚來檢視管線，並對其進行配置。若要瞭解如何配置管線的基本觀念，請參閱[建置及部署管線（在新視窗中開啟鏈結）](../services/DeliveryPipeline/build_deploy.html){: new_window}。 + + **提示**：如果您要在將變更推送至 GitHub 或 {{site.data.keyword.ghe_short}} 儲存庫時觸發管線，必須先配置工具鏈的 GitHub 或 {{site.data.keyword.ghe_short}}，再定義管線的階段。管線階段需要儲存庫的 Git URL。每一個管線階段都只能參照與您工具鏈相關聯的其中一個 GitHub 或 {{site.data.keyword.ghe_short}} 儲存庫。如需配置 GitHub 的指示，請參閱 [GitHub](#github) 一節。如需配置「專用 GitHub Enterprise」的指示，請參閱[開始使用 {{site.data.keyword.ghe_long}}（在新視窗中開啟鏈結）](../services/ghededicated/index.html){: new_window}。 + +1. 選用項目：如果您是在「{{site.data.keyword.Bluemix_notm}} 公用」上使用工具鏈，並且想要 Sauce Labs 對您的應用程式執行測試，請配置 {{site.data.keyword.deliverypipeline}} 來新增 Sauce Labs 測試工作。如需配置測試工作的指示，請參閱[在管線中配置 Sauce Labs 測試工作](#config_saucelabs)一節。 + +### 在管線中配置 Sauce Labs 測試工作 +{: #config_saucelabs} + +您需要工作中管線有建置並部署應用程式的階段，而且必須為工具鏈配置 Sauce Labs，再於管線中配置 Sauce Labs 測試工作。如需配置 Sauce Labs 的指示，請參閱 [Sauce Labs](#saucelabs) 一節。 + +配置 {{site.data.keyword.deliverypipeline}} 來新增 Sauce Labs 測試工作： + +1. 如果您沒有可部署您應用程式之測試版本的階段，請建立一個。 +1. 在此階段中，於部署工作之後新增測試工作。將這些工作放在相同的階段中，它們即可存取一組相同的環境內容。 + ![測試工作](images/toolchain_test_job.png) + +1. 配置階段： + + a. 在**環境內容**標籤上，建立三個內容：CF_APP_NAME、SAUCE_USERNAME 及 SAUCE_ACCESS_KEY。 + + b. 輸入 Sauce Labs 使用者名稱和存取金鑰。這麼做可以提出那些值，以將它們用於測試中。 + +1. 配置部署工作。在**部署 Script** 欄位中，包括下列指令：`export CF_APP_NAME="$CF_APP"`。該指令會將應用程式名稱匯出為環境內容。 +1. 配置測試工作。下列影像中的值是範例。**服務實例**、**目標**、**組織**及**空間**欄位會移入您正在使用的 Sauce Labs 使用者名稱、地區、組織及空間。 +![配置工作](images/toolchain_configure_job.png) + + a. 針對測試器類型，選取 **Sauce Labs**。 + + b. 針對服務實例，選取您為工具鏈配置 Sauce Labs 時所使用的 Sauce Labs 使用者名稱。 + + **提示**：若要查看您為工具鏈配置 Sauce Labs 時所使用的使用者名稱和存取金鑰，請按一下**配置**。 + + c. 在**測試執行指令**欄位中，輸入可安裝測試所需相依關係的指令，然後執行測試。例如，針對 Node.js 應用程式，您可以輸入下列指令： + ``` + npm install + node_modules/grunt-cli/bin/grunt test:sauce:parallel + ``` + + d. 如果您要在測試工作日誌中查看測試報告，請選取**啟用測試報告**勾選框，然後將「測試結果檔案型樣」設為 `test/*.xml`。 + +1. 按一下**儲存**。只要執行管線，就會執行 Sauce Labs 測試。 + +若要進一步瞭解，請參閱 [Delivery Pipeline（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/deliver/tool_build_and_deploy/){: new_window}。 + + +## 新增 {{site.data.keyword.DRA_short}} +{: #dra} + +{{site.data.keyword.DRA_full}} 會收集並分析單元測試、功能測試及程式碼涵蓋面工具的結果，來判定您的程式碼是否符合部署程序中所指定閘道的預先定義準則。如果程式碼不符合或超出準則，則會停止部署，以防止釋出風險。您可以使用「{{site.data.keyword.DRA_short}}」作為持續交付環境的安全網，或作為實作並改善品質標準的方法。 + + **附註**：這是預先配置的工具整合。它不需要任何配置參數，而且您無法重新配置它。 + +新增「{{site.data.keyword.DRA_short}}」來維護及改善您的程式碼在 {{site.data.keyword.Bluemix_notm}} 中的品質，方法是在發行部署之前監視部署來識別風險。 + +1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 按一下新增按鈕 (+)。 +1. 在「工具整合」區段中，按一下**部署風險分析**。 +1. 按一下**建立整合**。 +1. 按一下「{{site.data.keyword.DRA_short}}」的磚，然後完成開始使用步驟：建立準則，並將準則連接至管線，然後執行管線。如需相關資訊，請參閱 [{{site.data.keyword.DRA_short}}（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/deliver/tool_deployment_risk_analytics/){: new_window}。 + + +## 新增 Eclipse Orion {{site.data.keyword.webide}} +{: #webide} + +Eclipse Orion {{site.data.keyword.webide}} 是一個整合的 Web 型環境，您可以在其中建立、編輯、執行、除錯以及完成來源控制作業。您可以平順地從編輯移至執行，再移至提交，然後移至部署。 + + **附註**：這是預先配置的工具整合。它不需要任何配置參數，而且您無法重新配置它。 + +若要完成來源控制作業，請新增 Eclipse Orion {{site.data.keyword.webide}} 工具整合： + +1. 如果您在「{{site.data.keyword.Bluemix_notm}} 公用」上有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。如果您是在「{{site.data.keyword.Bluemix_notm}} 專用」上使用工具鏈，請在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 按一下新增按鈕 (+)。 +1. 在「工具整合」區段中，按一下 **Eclipse Orion Web IDE**。 +1. 按一下**建立整合**。 +1. 按一下新 Eclipse Orion {{site.data.keyword.webide}} 的磚。您的工作區會預先移入您的 GitHub 或 {{site.data.keyword.ghe_short}} 儲存庫。會強調顯示與現行工具鏈相關聯的儲存庫。 + +若要進一步瞭解，請參閱[使用 Eclipse Orion {{site.data.keyword.webide}} 編輯程式碼（在新視窗中開啟鏈結）](../toolchains/web_ide.html){: new_window}。 + + +## 配置 GitHub +{: #github} + +GitHub 是 Git 儲存庫的 Web 型管理服務。您可以同時具有儲存庫的本端和遠端副本，方便進行分工合作。 + +GitHub Issues 是一個追蹤工具，可將您的工作和方案都保留在一個位置。它會與您的開發儲存庫整合，以聚焦在重要作業。 + +配置 GitHub，以在雲端上管理您的原始碼： + +1. 如果您要在建立工具鏈時配置此工具整合，請遵循下列步驟： + + a. 在「可配置的整合」區段中，按一下 **GitHub**。如果您在「{{site.data.keyword.Bluemix_notm}} 公用」上建立工具鏈，但並未授權 {{site.data.keyword.Bluemix_notm}} 存取 GitHub，請按一下**授權**來移至 GitHub 網站。如果您沒有作用中的 GitHub 階段作業，則系統會提示您登入。按一下**授權應用程式**，以容許 {{site.data.keyword.Bluemix_notm}} 存取 GitHub 帳戶。如果您有作用中的 GitHub 階段作業，但最近未輸入過密碼，則系統可能會提示您輸入 GitHub 密碼進行確認。 + + b. 檢閱 GitHub 儲存庫的預設目標儲存庫位置。那些儲存庫是從範例儲存庫中複製而來。必要的話，請變更目標儲存庫的名稱。 + ![預設目標儲存庫位置](images/toolchain_github_config.png) + +1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 按一下新增按鈕 (+)。 +1. 在「工具整合」區段中，按一下 **GitHub**。 +1. 如果您有 GitHub 儲存庫並且想要使用它，請鍵入 URL。針對儲存庫類型，請按一下**鏈結**。 +1. 如果您要使用新的 GitHub 儲存庫，請鍵入 GitHub 儲存庫的名稱，並鍵入您所複製或分出之儲存庫的 URL，然後選取儲存庫類型： + + a. 若要建立空的儲存庫，請按一下**新建**。 + + b. 若要建立 GitHub 儲存庫的副本，請按一下**複製**。 + + c. 若要分出 GitHub 儲存庫，以透過取回要求來提出變更，請按一下**分出**。 + +1. 如果您要使用 GitHub Issues 進行問題追蹤，請選取**啟用 GitHub Issues** 勾選框。 +1. 按一下**建立整合**。 +1. 按一下您要使用之 GitHub 儲存庫的磚。即會開啟 GitHub 網站，您可以在其中檢視儲存庫的內容。 + + **提示**：您可以使用 Eclipse Orion {{site.data.keyword.webide}} 中的整合原始碼管理工具來編輯 GitHub 儲存庫，以及從工作區中部署應用程式。 + +1. 如果您已啟用 GitHub Issues，請按一下 GitHub Issues 的磚予以開啟。 + +如需相關資訊，請參閱 [GitHub（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/code/tool_github/){: new_window}及 [GitHub Issues（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}。 + + +## 配置專用 GitHub Enterprise +{: #configghe} + +「{{site.data.keyword.ghe_long}}」是 Git 儲存庫的內部部署 Web 型管理服務。「專用 GitHub Enterprise」僅供「{{site.data.keyword.Bluemix_notm}} 專用」客戶使用。GitHub Issues 是一個追蹤工具，可將您的工作及方案保留在一個位置。它會與您的開發儲存庫整合，以聚焦在重要作業。如需「專用 GitHub Enterprise」及 GitHub Issues 的相關資訊，請參閱[使用專用 GitHub Enterprise（在新視窗中開啟鏈結）](../services/ghededicated/index.html){: new_window}及 [GitHub Issues（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/think/tool_github_issues/){: new_window}。 + +您可以將 {{site.data.keyword.ghe_short}} 配置為工具鏈中的工具整合，以在公司的 [{{site.data.keyword.Bluemix_notm}} 專用（在新視窗中開啟鏈結）](../dedicated/index.html#dedicated){: new_window}實例中管理原始碼。 + +1. 如果您要在建立工具鏈時配置此工具整合，請遵循下列步驟： + + a. 第一次登入「專用 GitHub Enterprise」之前，請要求公司的地區管理者使用 LDAP 將您的使用者 ID 從公司的使用者登錄新增至「{{site.data.keyword.Bluemix_notm}} 專用」實例。如需設定 {{site.data.keyword.ghe_short}} 帳戶的相關資訊，請參閱[使用專用 GitHub Enterprise（在新視窗中開啟鏈結）](../services/ghededicated/index.html){: new_window}。 + + b. 在「可配置的整合」區段中，按一下 **{{site.data.keyword.ghe_short}}**。 + + c. 檢閱新 {{site.data.keyword.ghe_short}} 儲存庫的預設名稱。必要的話，請變更新儲存庫的名稱。下列影像顯示從範例儲存庫複製的儲存庫範例。您可以使用現有儲存庫或新儲存庫。若要使用新的儲存庫，您可以建立空的儲存庫、複製儲存庫，或分出儲存庫。 + ![預設儲存庫位置](images/toolchain_ghe_config.png) + +1. 如果您在「{{site.data.keyword.Bluemix_notm}} 公用」上有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。如果您是在「{{site.data.keyword.Bluemix_notm}} 專用」上使用工具鏈，請在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 按一下新增按鈕 (+)。 +1. 在「工具整合」區段中，按一下 **{{site.data.keyword.ghe_short}}**。 +1. 如果您有想要使用的 {{site.data.keyword.ghe_short}} 儲存庫，請鍵入儲存庫的 URL。針對儲存庫類型，請按一下**現有**。 +1. 如果您要使用新的 {{site.data.keyword.ghe_short}} 儲存庫，請鍵入儲存庫的名稱，並鍵入您所複製或分出之儲存庫的 URL，然後選取儲存庫類型： + + a. 若要建立空的儲存庫，請按一下**新建**。 + + b. 若要建立儲存庫的副本，請按一下**複製**。 + + c. 若要分出儲存庫，以透過取回要求來提出變更，請按一下**分出**。 + +1. 若要使用 GitHub Issues 進行問題追蹤，請選取**啟用 GitHub Issues** 勾選框。 +1. 按一下**建立整合**。 +1. 按一下您要使用之 {{site.data.keyword.ghe_short}} 儲存庫的磚。即會開啟您公司的 [{{site.data.keyword.Bluemix_notm}} 專用（在新視窗中開啟鏈結）](../dedicated/index.html#dedicated){: new_window}實例，您可以在其中檢視儲存庫的內容。 + + **提示**：您可以使用 Eclipse Orion {{site.data.keyword.webide}} 中的整合原始碼管理工具來編輯 {{site.data.keyword.ghe_short}} 儲存庫，以及從工作區中部署應用程式。 + +1. 如果您已啟用 GitHub Issues，請按一下 GitHub Issues 的磚。 + + + +## 配置自訂工具（其他工具） +{: #othertool} + +如果您的團隊使用未包含在工具鏈整合清單中的工具，您可以整合自訂工具。 + +配置自訂工具，使其可與工具鏈上的其他工具一起運作，且可供您的團隊使用： +1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的**其他工具**。 + +1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 按一下新增按鈕 (+)。 +1. 在「工具整合」區段中，按一下**其他工具**。 +1. 鍵入工具名稱。 +1. 選取與工具最密切關聯的生命週期階段。生命週期階段選擇可決定在「工具鏈整合」頁面上用來列出工具的種類。 +1. 新增圖示 URL。此圖示將出現在工具的整合卡上。 +1. 新增文件 URL。 +1. 指定工具實例名稱。例如：我的團隊工具。 +1. 新增工具實例 URL。按一下工具整合卡會導向至您為工具實例列出的 URL。 +1. 新增工具的說明。 +1. （進階）必要的話，新增其他內容。例如，列出您的工具與工具鏈中的其他工具整合時所需的任何資訊或屬性。 +1. 按一下**建立整合**。 + +## 配置 PagerDuty +{: #pagerduty} + +PagerDuty 會將多個監視系統中的資料整合至單一視圖。發生問題時，PagerDuty 可確保那時最能修正該問題的團隊成員收到通知。如果團隊成員未回應該問題，則可以配置呈報，將它遞送給次要工程師或作業管理員。 + +配置 PagerDuty 在管線階段失敗時傳送通知，讓您可以更快速地修正問題，並減少關閉時間： + +1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的 **PagerDuty**。 +1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 按一下新增按鈕 (+)。 +1. 在「工具整合」區段中，按一下 **PagerDuty**。 +1. 鍵入與 PagerDuty 帳戶相關聯的 PagerDuty 網站名稱。如果您沒有 PagerDuty 帳戶，請[註冊一個帳戶（在新視窗中開啟鏈結）](https://signup.pagerduty.com/accounts/new){: new_window}。 +1. 鍵入 PagerDuty 帳戶的 API 存取金鑰。如需尋找金鑰的指示，請參閱 [API 鑑別（在新視窗中開啟鏈結）](https://signup.pagerduty.com/accounts/new){: new_window}。 +1. 鍵入 PagerDuty 服務的名稱。 +1. 鍵入主要 PagerDuty 聯絡人的電子郵件位址。 +1. 鍵入主要 PagerDuty 聯絡人的電話號碼。 +1. 按一下**建立整合**。 +1. 按一下 PagerDuty 的磚以移至 pagerduty.com。您可以檢視與 PagerDuty 服務相關聯的事件，而 PagerDuty 服務是您在配置工具鏈的這個工具整合時所指定。 + +若要進一步瞭解，請參閱 [PagerDuty（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/manage/tool_pagerduty/){: new_window}。 + + +## 配置 Sauce Labs +{: #saucelabs} + +Sauce Labs 會執行功能單元測試。在 {{site.data.keyword.deliverypipeline}} 中將 Sauce Labs 測試套組配置為測試工作時，測試套組可以在持續交付處理程序期間對 Web 或行動應用程式執行測試。這些測試可以提供對專案的重要流程控制，作為防止部署不正確程式碼的閘道。 + +配置 Sauce Labs 對多個作業系統和瀏覽器執行自動化功能測試，讓您模擬使用者可能使用網站或應用程式的方式： + +1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的 **Sauce Labs**。 +1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 按一下新增按鈕 (+)。 +1. 在「工具整合」區段中，按一下 **Sauce Labs**。 +1. 鍵入與 Sauce Labs 帳戶相關聯的使用者名稱。您可以[在 Sauce Labs 帳戶頁面頂端的歡迎使用訊息中找到使用者名稱（在新視窗中開啟鏈結）](https://saucelabs.com/account){: new_window}。 +1. 鍵入 Sauce Labs 帳戶的存取金鑰。您可以[在 Sauce Labs 帳戶頁面上找到金鑰（在新視窗中開啟鏈結）](https://saucelabs.com/account){: new_window}。 +1. 按一下**建立整合**。 +1. 按一下 Sauce Labs 的磚以移至 saucelabs.com，然後檢視工具鏈的測試活動。 + + **提示**：如果您已將 Sauce Labs 測試工作新增至 {{site.data.keyword.deliverypipeline}}，則可以選取服務實例。 + +若要進一步瞭解，請參閱 [Sauce Labs（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/code/tool_sauce_labs/){: new_window}。 + + +## 配置 Slack +{: #slack} + +**重要事項**：團隊的所有人都可以看到張貼到公用 Slack 通道的通知。請記住，您需要自行負責所張貼的內容。 + +Slack 是一種雲端型、即時傳訊和通知系統。Slack 會提供持續性會談，這在進行團隊協同作業時比電子郵件更具互動性。您可以透過專用通道或與工作直接相關的一組通道來與團隊進行通訊。您也可以透過通道或兩位以上人員之間的直接訊息來共用檔案和影像。會保留透過直接訊息和通道的通訊，讓您可以搜尋它們。 + +配置 Slack 接收來自工具整合有關工具鏈的通知（例如測試和部署活動）： + +1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的 **Slack**。 +1. 如果您有工具鏈，並且要在其中新增此工具整合，請在 DevOps 儀表板的**工具鏈**頁面上按一下工具鏈，以開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 按一下新增按鈕 (+)。 +1. 在「工具整合」區段中，按一下 **Slack**。 +1. 鍵入 Slack 帳戶的 API 鑑別記號。您必須使用產生的完整存取記號向 Slack 進行鑑別。如需尋找記號的指示，請參閱 [Slack 鑑別（在新視窗中開啟鏈結）](https://api.slack.com/web#authentication){: new_window}。 +1. 鍵入您要接收通知的 Slack 通道名稱。如果您指定的通道不存在，則會建立它。如果已保存通道，則會重新啟動它。 +1. 按一下**建立整合**。 +1. 按一下 Slack 的磚。您可以在已配置的 Slack 通道中檢視工具鏈的所有活動。 + +若要進一步瞭解，請參閱 [Slack（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/content/culture/tool_slack/){: new_window}。 + + + + + + + + diff --git a/toolchains/nl/zh/TW/toolchains_overview.md b/toolchains/nl/zh/TW/toolchains_overview.md index 4fd577ca4..75485d383 100644 --- a/toolchains/nl/zh/TW/toolchains_overview.md +++ b/toolchains/nl/zh/TW/toolchains_overview.md @@ -1,160 +1,160 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# 開始使用工具鏈（測試版） -{: #toolchains_getting_started} - -前次更新：2016 年 10 月 7 日 -{: .last-updated} - -工具鏈適用於 {{site.data.keyword.Bluemix}} 的「公用」及「專用」環境。您可以透過兩種方法建立工具鏈：使用範本來建立工具鏈，或從應用程式中建立工具鏈。在「{{site.data.keyword.Bluemix_notm}} 公用」上，工具鏈只適用於美國南部地區。 -{: shortdesc} - -##開始使用工具鏈：公用 -{: #getting_started_public} - -**附註：**請透過檢查頂端橫幅來確定您是以「全新 Bluemix」體驗進行工作。 - - * 如果看到有關試用新的 Bluemix 的訊息，則表示您是以「傳統 Bluemix」體驗進行工作。請按一下鏈結，以開啟「全新 Bluemix」體驗。 - * 如果未看到該訊息，則表示您已經以「全新 Bluemix」體驗進行工作。 - -每一個工具鏈都會與特定組織相關聯，而且任何屬於該組織成員的使用者都可以存取其相關聯的工具鏈。建立工具鏈之前，請確定您是在要建立工具鏈的組織中工作。您目前在其中工作的組織顯示在功能表列中。若要切換至另一個組織，請按一下功能表列中的該組織，然後選取您要切換至的組識。 - -###從範本建立工具鏈 -{: #creating_a_toolchain_from_a_template} - -您可以使用範本作為起點來建立包括一組特定工具整合的工具鏈。 - -1. 如果您是建立第一個工具鏈，請確定組織中已啟用工具鏈： - 1. 開啟 DevOps 儀表板，然後按一下**工具鏈**頁面。 - 2. 如果顯示**啟用工具鏈**按鈕，請按一下它，然後遵循提示來建立工具鏈。 - 3. 如果未顯示**啟用工具鏈**按鈕，則表示已啟用工具鏈。請繼續進行步驟 2。 -1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下新增按鈕 (+) 來建立工具鏈。 -1. 按一下工具鏈範本。例如，若要使用線上商店範例來建立工具鏈，請按一下**微服務工具鏈**。 -1. 在工具鏈建立頁面上，檢閱即將建立之工具鏈的圖表。此圖會顯示每個工具整合在工具鏈中的生命週期階段。下列影像中的圖表是範例。當您建立工具鏈時，圖表會顯示每一個屬於工具鏈一部分的工具整合。 -![工具鏈圖表](images/toolchain_diagram.png) - -1. 檢閱工具鏈設定的預設資訊。在 {{site.data.keyword.Bluemix_notm}} 中，可透過工具鏈名稱來識別工具鏈。如果您已有該名稱的工具鏈，或要使用不同的名稱，請變更工具鏈的名稱。 -1. 在「可配置的整合」區段中，選取您要配置給工具鏈的每一個工具整合。部分工具整合不需要進行任何配置。如需配置工具整合的相關資訊，請參閱[配置工具整合（在新視窗中開啟鏈結）](../toolchains/toolchains_integrations.html){: new_window}。 -1. 按一下**建立**。會自動執行數個步驟來設定工具鏈： - - * 建立工具鏈。 - * 如果您已配置 Delivery Pipeline 工具整合，則會觸發管線。 - * 如果您已配置 Sauce Labs 工具整合，則 Sauce Labs 整合會配置成將工作新增至管線，然後執行測試。 - * 如果您已配置 PagerDuty 工具整合，則 PagerDuty 整合會配置成將通知傳送給您在 Slack 中所配置的通道。這些通知會指出何時發生問題。 - * 如果您已配置 Slack 工具整合，則 Slack 整合會配置成將通知傳送給您在 Slack 中所配置的通道。這些通知會指出部署進度；例如，`Connected with Project XYZ`、`Pipeline Configured` 及 `Stage 'build' started`。 - * 如果您已配置 GitHub 工具整合，則會將範例 GitHub 儲存庫複製到 GitHub 帳戶。 - - -###從應用程式建立工具鏈 -{: #creating_a_toolchain_from_an_app} - -您可以從應用程式建立工具鏈。工具鏈可支援持續開發、部署、監視及其他作業，且其與應用程式相關聯。每一個應用程式都可能與工具鏈相關聯。將變更推送至工具鏈的 GitHub 儲存庫時，管線會自動建置及部署應用程式。 - -1. 如果您是建立第一個工具鏈，請確定組織中已啟用工具鏈： - 1. 開啟 DevOps 儀表板，然後按一下**工具鏈**頁面。 - 2. 如果顯示**啟用工具鏈**按鈕，請按一下它，然後遵循提示來建立工具鏈。 - 3. 如果未顯示**啟用工具鏈**按鈕，則表示已啟用工具鏈。請繼續進行步驟 2。 -1. 在應用程式之「概觀」頁面的「持續交付」磚上，按一下**啟用**。或者，在「{{site.data.keyword.Bluemix_notm}} 一般經驗」中，按一下應用程式之「概觀」頁面右上角中的**新增工具鏈**。您的應用程式會配置成從移入應用程式入門範本程式碼的新 GitHub 儲存庫進行持續交付。 -1. 在工具鏈建立頁面上，檢閱即將建立之工具鏈的圖表。此圖會顯示每個工具整合在工具鏈中的生命週期階段。 -1. 檢閱工具鏈設定的預設資訊。在 {{site.data.keyword.Bluemix_notm}} 中，可透過工具鏈名稱來識別工具鏈。如果您已有該名稱的工具鏈，或要使用不同的名稱，請變更工具鏈的名稱。 -1. 在「可配置的整合」區段中，選取您要配置給工具鏈的每一個工具整合。部分工具整合不需要進行任何配置。如需配置工具整合的相關資訊，請參閱[配置工具整合（在新視窗中開啟鏈結）](../toolchains/toolchains_integrations.html){: new_window}。 -1. 按一下**建立**。會自動執行數個步驟來設定工具鏈： - - * 建立工具鏈。 - * 如果您已配置 Delivery Pipeline 工具整合，則會觸發管線。 - * 如果您已配置 Sauce Labs 工具整合，則 Sauce Labs 整合會配置成將工作新增至管線，然後執行測試。 - * 如果您已配置 PagerDuty 工具整合，則 PagerDuty 整合會配置成將通知傳送給您在 Slack 中所配置的通道。這些通知會指出何時發生問題。 - * 如果您已配置 Slack 工具整合，則 Slack 整合會配置成將通知傳送給您在 Slack 中所配置的通道。這些通知會指出部署進度；例如，`Connected with Project XYZ`、`Pipeline Configured` 及 `Stage 'build' started`。 - * 如果您已配置 GitHub 工具整合，則會將範例 GitHub 儲存庫複製到 GitHub 帳戶。 - - -##開始使用工具鏈：專用 -{: #getting_started_dedicated} - -每一個工具鏈都會與特定組織相關聯，而且任何屬於該組織成員的使用者都可以存取其相關聯的工具鏈。建立工具鏈之前，請按一下功能表列中的**{{site.data.keyword.avatar}}**圖示 ![「虛擬人像」圖示](../icons/i-avatar-icon.svg) 來開啟「帳戶及支援」小組件，以及檢視您在其中工作的組織。如果該組織不是您要建立工具鏈的組織，請切換至另一個組織。 - -###從範本建立工具鏈 -{: #creating_a_toolchain_from_a_template_dedicated} - -您可以使用範本作為起點來建立包括一組特定工具整合的工具鏈。 - -1. 如果您是建立第一個工具鏈，請確定組織中已啟用工具鏈： - 1. 開啟 DevOps 儀表板，然後按一下**工具鏈**標籤。 - 2. 如果顯示**啟用工具鏈**按鈕，請按一下它，然後遵循提示來建立工具鏈。 - 3. 如果未顯示**啟用工具鏈**按鈕，則表示已啟用工具鏈。請繼續進行步驟 2。 -1. 在「{{site.data.keyword.Bluemix_notm}} 儀表板」的 **DevOps** 標籤上，按一下新增按鈕 (+) 來建立工具鏈。 -1. 按一下工具鏈範本。例如，若要建立簡式工具鏈來部署新的 Cloud Foundry 應用程式，請按一下**簡式 Cloud Foundry 工具鏈**。 -1. 在工具鏈建立頁面上，檢閱即將建立之工具鏈的圖表。此圖會顯示每個工具整合在工具鏈中的生命週期階段。下列影像中的圖表是範例。當您建立工具鏈時，圖表會顯示每一個屬於工具鏈一部分的工具整合。 -![專用工具鏈圖表](images/toolchain_dedicated_diagram.png) - -1. 檢閱工具鏈設定的預設資訊。在 {{site.data.keyword.Bluemix_notm}} 中，可透過工具鏈名稱來識別工具鏈。如果您已有該名稱的工具鏈，或要使用不同的名稱，請變更工具鏈的名稱。 -1. 在「可配置的整合」區段中，選取您要配置給工具鏈的每一個工具整合。部分工具整合不需要進行任何配置。如需配置工具整合的相關資訊，請參閱[配置工具整合（在新視窗中開啟鏈結）](../toolchains/toolchains_integrations.html){: new_window}。 -1. 按一下**建立**。會自動執行數個步驟來設定工具鏈： - - * 建立工具鏈。 - * 如果您已配置 Delivery Pipeline 工具整合，則會觸發管線。 - * 如果您已配置 GitHub Enterprise 工具整合，則會將範例 GitHub Enterprise 儲存庫複製到 GitHub Enterprise 帳戶。 - - -###從應用程式建立工具鏈 -{: #creating_a_toolchain_from_an_app_dedicated} - -您可以從應用程式建立工具鏈。工具鏈可支援持續開發、部署、監視及其他作業，且其與應用程式相關聯。每一個應用程式都可能與工具鏈相關聯。將變更推送至工具鏈的 GitHub Enterprise 儲存庫時，管線會自動建置及部署應用程式。 - -1. 如果您是建立第一個工具鏈，請確定組織中已啟用工具鏈： - 1. 開啟 DevOps 儀表板，然後按一下**工具鏈**標籤。 - 2. 如果顯示**啟用工具鏈**按鈕，請按一下它，然後遵循提示來建立工具鏈。 - 3. 如果未顯示**啟用工具鏈**按鈕，則表示已啟用工具鏈。請繼續進行步驟 2。 -1. 在應用程式之「概觀」頁面的右上角，按一下**新增工具鏈**。您的應用程式會配置成從移入應用程式入門範本程式碼的新 GitHub Enterprise 儲存庫進行持續交付。 -1. 在工具鏈建立頁面上，檢閱即將建立之工具鏈的圖表。此圖會顯示每個工具整合在工具鏈中的生命週期階段。 -1. 檢閱工具鏈設定的預設資訊。在 {{site.data.keyword.Bluemix_notm}} 中，可透過工具鏈名稱來識別工具鏈。如果您已有該名稱的工具鏈，或要使用不同的名稱，請變更工具鏈的名稱。 -1. 在「可配置的整合」區段中，選取您要配置給工具鏈的每一個工具整合。部分工具整合不需要進行任何配置。如需配置工具整合的相關資訊，請參閱[配置工具整合（在新視窗中開啟鏈結）](../toolchains/toolchains_integrations.html){: new_window}。 -1. 按一下**建立**。會自動執行數個步驟來設定工具鏈： - - * 建立工具鏈。 - * 如果您已配置 Delivery Pipeline 工具整合，則會觸發管線。 - * 如果您已配置 GitHub Enterprise 工具整合，則會將範例 GitHub Enterprise 儲存庫複製到 GitHub Enterprise 帳戶。 - - -##檢視工具鏈 -{: #viewing_a_toolchain} - -在您配置工具鏈及其工具整合之後，即可在「工具整合」頁面上檢視工具鏈的視覺化呈現。 - -* 如果您使用「{{site.data.keyword.Bluemix_notm}} 公用」，請在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 - -* 如果您使用「{{site.data.keyword.Bluemix_notm}} 專用」，請在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。 - -* 若要存取工具鏈中的工具整合，請按一下工具的磚。 - - **提示**：如果您有多個 GitHub 或 GitHub Enterprise 儲存庫，則相同的工具整合可能會有多個磚，因為每一個儲存庫都會以它自己的磚來呈現。 - - - - - -# 相關鏈結 -{: #rellinks} - -## 指導教學和範例 -{: #samples} - -* [建立具有三個微服務的應用程式（測試版）（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} -* [從 {{site.data.keyword.Bluemix_notm}} 專用的範本建立工具鏈（測試版）（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} -* [從 {{site.data.keyword.Bluemix_notm}} 專用的應用程式建立工具鏈（測試版）（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} - -## 相關鏈結 -{: #general} - -* [微服務工具鏈（測試版）（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} -* [簡式工具鏈（測試版）（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} -* [IBM Bluemix Garage Method（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method){:new_window} +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# 開始使用工具鏈（測試版） +{: #toolchains_getting_started} + +前次更新：2016 年 10 月 7 日 +{: .last-updated} + +工具鏈適用於 {{site.data.keyword.Bluemix}} 的「公用」及「專用」環境。您可以透過兩種方法建立工具鏈：使用範本來建立工具鏈，或從應用程式中建立工具鏈。在「{{site.data.keyword.Bluemix_notm}} 公用」上，工具鏈只適用於美國南部地區。 +{: shortdesc} + +##開始使用工具鏈：公用 +{: #getting_started_public} + +**附註：**請透過檢查頂端橫幅來確定您是以「全新 Bluemix」體驗進行工作。 + + * 如果看到有關試用新的 Bluemix 的訊息，則表示您是以「傳統 Bluemix」體驗進行工作。請按一下鏈結，以開啟「全新 Bluemix」體驗。 + * 如果未看到該訊息，則表示您已經以「全新 Bluemix」體驗進行工作。 + +每一個工具鏈都會與特定組織相關聯，而且任何屬於該組織成員的使用者都可以存取其相關聯的工具鏈。建立工具鏈之前，請確定您是在要建立工具鏈的組織中工作。您目前在其中工作的組織顯示在功能表列中。若要切換至另一個組織，請按一下功能表列中的該組織，然後選取您要切換至的組識。 + +###從範本建立工具鏈 +{: #creating_a_toolchain_from_a_template} + +您可以使用範本作為起點來建立包括一組特定工具整合的工具鏈。 + +1. 如果您是建立第一個工具鏈，請確定組織中已啟用工具鏈： + 1. 開啟 DevOps 儀表板，然後按一下**工具鏈**頁面。 + 2. 如果顯示**啟用工具鏈**按鈕，請按一下它，然後遵循提示來建立工具鏈。 + 3. 如果未顯示**啟用工具鏈**按鈕，則表示已啟用工具鏈。請繼續進行步驟 2。 +1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下新增按鈕 (+) 來建立工具鏈。 +1. 按一下工具鏈範本。例如，若要使用線上商店範例來建立工具鏈，請按一下**微服務工具鏈**。 +1. 在工具鏈建立頁面上，檢閱即將建立之工具鏈的圖表。此圖會顯示每個工具整合在工具鏈中的生命週期階段。下列影像中的圖表是範例。當您建立工具鏈時，圖表會顯示每一個屬於工具鏈一部分的工具整合。 +![工具鏈圖表](images/toolchain_diagram.png) + +1. 檢閱工具鏈設定的預設資訊。在 {{site.data.keyword.Bluemix_notm}} 中，可透過工具鏈名稱來識別工具鏈。如果您已有該名稱的工具鏈，或要使用不同的名稱，請變更工具鏈的名稱。 +1. 在「可配置的整合」區段中，選取您要配置給工具鏈的每一個工具整合。部分工具整合不需要進行任何配置。如需配置工具整合的相關資訊，請參閱[配置工具整合（在新視窗中開啟鏈結）](../toolchains/toolchains_integrations.html){: new_window}。 +1. 按一下**建立**。會自動執行數個步驟來設定工具鏈： + + * 建立工具鏈。 + * 如果您已配置 Delivery Pipeline 工具整合，則會觸發管線。 + * 如果您已配置 Sauce Labs 工具整合，則 Sauce Labs 整合會配置成將工作新增至管線，然後執行測試。 + * 如果您已配置 PagerDuty 工具整合，則 PagerDuty 整合會配置成將通知傳送給您在 Slack 中所配置的通道。這些通知會指出何時發生問題。 + * 如果您已配置 Slack 工具整合，則 Slack 整合會配置成將通知傳送給您在 Slack 中所配置的通道。這些通知會指出部署進度；例如，`Connected with Project XYZ`、`Pipeline Configured` 及 `Stage 'build' started`。 + * 如果您已配置 GitHub 工具整合，則會將範例 GitHub 儲存庫複製到 GitHub 帳戶。 + + +###從應用程式建立工具鏈 +{: #creating_a_toolchain_from_an_app} + +您可以從應用程式建立工具鏈。工具鏈可支援持續開發、部署、監視及其他作業，且其與應用程式相關聯。每一個應用程式都可能與工具鏈相關聯。將變更推送至工具鏈的 GitHub 儲存庫時，管線會自動建置及部署應用程式。 + +1. 如果您是建立第一個工具鏈，請確定組織中已啟用工具鏈： + 1. 開啟 DevOps 儀表板，然後按一下**工具鏈**頁面。 + 2. 如果顯示**啟用工具鏈**按鈕，請按一下它，然後遵循提示來建立工具鏈。 + 3. 如果未顯示**啟用工具鏈**按鈕，則表示已啟用工具鏈。請繼續進行步驟 2。 +1. 在應用程式之「概觀」頁面的「持續交付」磚上，按一下**啟用**。或者，在「{{site.data.keyword.Bluemix_notm}} 一般經驗」中，按一下應用程式之「概觀」頁面右上角中的**新增工具鏈**。您的應用程式會配置成從移入應用程式入門範本程式碼的新 GitHub 儲存庫進行持續交付。 +1. 在工具鏈建立頁面上，檢閱即將建立之工具鏈的圖表。此圖會顯示每個工具整合在工具鏈中的生命週期階段。 +1. 檢閱工具鏈設定的預設資訊。在 {{site.data.keyword.Bluemix_notm}} 中，可透過工具鏈名稱來識別工具鏈。如果您已有該名稱的工具鏈，或要使用不同的名稱，請變更工具鏈的名稱。 +1. 在「可配置的整合」區段中，選取您要配置給工具鏈的每一個工具整合。部分工具整合不需要進行任何配置。如需配置工具整合的相關資訊，請參閱[配置工具整合（在新視窗中開啟鏈結）](../toolchains/toolchains_integrations.html){: new_window}。 +1. 按一下**建立**。會自動執行數個步驟來設定工具鏈： + + * 建立工具鏈。 + * 如果您已配置 Delivery Pipeline 工具整合，則會觸發管線。 + * 如果您已配置 Sauce Labs 工具整合，則 Sauce Labs 整合會配置成將工作新增至管線，然後執行測試。 + * 如果您已配置 PagerDuty 工具整合，則 PagerDuty 整合會配置成將通知傳送給您在 Slack 中所配置的通道。這些通知會指出何時發生問題。 + * 如果您已配置 Slack 工具整合，則 Slack 整合會配置成將通知傳送給您在 Slack 中所配置的通道。這些通知會指出部署進度；例如，`Connected with Project XYZ`、`Pipeline Configured` 及 `Stage 'build' started`。 + * 如果您已配置 GitHub 工具整合，則會將範例 GitHub 儲存庫複製到 GitHub 帳戶。 + + +##開始使用工具鏈：專用 +{: #getting_started_dedicated} + +每一個工具鏈都會與特定組織相關聯，而且任何屬於該組織成員的使用者都可以存取其相關聯的工具鏈。建立工具鏈之前，請按一下功能表列中的**{{site.data.keyword.avatar}}**圖示 ![「虛擬人像」圖示](../icons/i-avatar-icon.svg) 來開啟「帳戶及支援」小組件，以及檢視您在其中工作的組織。如果該組織不是您要建立工具鏈的組織，請切換至另一個組織。 + +###從範本建立工具鏈 +{: #creating_a_toolchain_from_a_template_dedicated} + +您可以使用範本作為起點來建立包括一組特定工具整合的工具鏈。 + +1. 如果您是建立第一個工具鏈，請確定組織中已啟用工具鏈： + 1. 開啟 DevOps 儀表板，然後按一下**工具鏈**標籤。 + 2. 如果顯示**啟用工具鏈**按鈕，請按一下它，然後遵循提示來建立工具鏈。 + 3. 如果未顯示**啟用工具鏈**按鈕，則表示已啟用工具鏈。請繼續進行步驟 2。 +1. 在「{{site.data.keyword.Bluemix_notm}} 儀表板」的 **DevOps** 標籤上，按一下新增按鈕 (+) 來建立工具鏈。 +1. 按一下工具鏈範本。例如，若要建立簡式工具鏈來部署新的 Cloud Foundry 應用程式，請按一下**簡式 Cloud Foundry 工具鏈**。 +1. 在工具鏈建立頁面上，檢閱即將建立之工具鏈的圖表。此圖會顯示每個工具整合在工具鏈中的生命週期階段。下列影像中的圖表是範例。當您建立工具鏈時，圖表會顯示每一個屬於工具鏈一部分的工具整合。 +![專用工具鏈圖表](images/toolchain_dedicated_diagram.png) + +1. 檢閱工具鏈設定的預設資訊。在 {{site.data.keyword.Bluemix_notm}} 中，可透過工具鏈名稱來識別工具鏈。如果您已有該名稱的工具鏈，或要使用不同的名稱，請變更工具鏈的名稱。 +1. 在「可配置的整合」區段中，選取您要配置給工具鏈的每一個工具整合。部分工具整合不需要進行任何配置。如需配置工具整合的相關資訊，請參閱[配置工具整合（在新視窗中開啟鏈結）](../toolchains/toolchains_integrations.html){: new_window}。 +1. 按一下**建立**。會自動執行數個步驟來設定工具鏈： + + * 建立工具鏈。 + * 如果您已配置 Delivery Pipeline 工具整合，則會觸發管線。 + * 如果您已配置 GitHub Enterprise 工具整合，則會將範例 GitHub Enterprise 儲存庫複製到 GitHub Enterprise 帳戶。 + + +###從應用程式建立工具鏈 +{: #creating_a_toolchain_from_an_app_dedicated} + +您可以從應用程式建立工具鏈。工具鏈可支援持續開發、部署、監視及其他作業，且其與應用程式相關聯。每一個應用程式都可能與工具鏈相關聯。將變更推送至工具鏈的 GitHub Enterprise 儲存庫時，管線會自動建置及部署應用程式。 + +1. 如果您是建立第一個工具鏈，請確定組織中已啟用工具鏈： + 1. 開啟 DevOps 儀表板，然後按一下**工具鏈**標籤。 + 2. 如果顯示**啟用工具鏈**按鈕，請按一下它，然後遵循提示來建立工具鏈。 + 3. 如果未顯示**啟用工具鏈**按鈕，則表示已啟用工具鏈。請繼續進行步驟 2。 +1. 在應用程式之「概觀」頁面的右上角，按一下**新增工具鏈**。您的應用程式會配置成從移入應用程式入門範本程式碼的新 GitHub Enterprise 儲存庫進行持續交付。 +1. 在工具鏈建立頁面上，檢閱即將建立之工具鏈的圖表。此圖會顯示每個工具整合在工具鏈中的生命週期階段。 +1. 檢閱工具鏈設定的預設資訊。在 {{site.data.keyword.Bluemix_notm}} 中，可透過工具鏈名稱來識別工具鏈。如果您已有該名稱的工具鏈，或要使用不同的名稱，請變更工具鏈的名稱。 +1. 在「可配置的整合」區段中，選取您要配置給工具鏈的每一個工具整合。部分工具整合不需要進行任何配置。如需配置工具整合的相關資訊，請參閱[配置工具整合（在新視窗中開啟鏈結）](../toolchains/toolchains_integrations.html){: new_window}。 +1. 按一下**建立**。會自動執行數個步驟來設定工具鏈： + + * 建立工具鏈。 + * 如果您已配置 Delivery Pipeline 工具整合，則會觸發管線。 + * 如果您已配置 GitHub Enterprise 工具整合，則會將範例 GitHub Enterprise 儲存庫複製到 GitHub Enterprise 帳戶。 + + +##檢視工具鏈 +{: #viewing_a_toolchain} + +在您配置工具鏈及其工具整合之後，即可在「工具整合」頁面上檢視工具鏈的視覺化呈現。 + +* 如果您使用「{{site.data.keyword.Bluemix_notm}} 公用」，請在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**。然後，按一下**工具整合**。 + +* 如果您使用「{{site.data.keyword.Bluemix_notm}} 專用」，請在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。 + +* 若要存取工具鏈中的工具整合，請按一下工具的磚。 + + **提示**：如果您有多個 GitHub 或 GitHub Enterprise 儲存庫，則相同的工具整合可能會有多個磚，因為每一個儲存庫都會以它自己的磚來呈現。 + + + + + +# 相關鏈結 +{: #rellinks} + +## 指導教學和範例 +{: #samples} + +* [建立具有三個微服務的應用程式（測試版）（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/tutorials/tutorial_microservices_part1){:new_window} +* [從 {{site.data.keyword.Bluemix_notm}} 專用的範本建立工具鏈（測試版）（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_template_flow){:new_window} +* [從 {{site.data.keyword.Bluemix_notm}} 專用的應用程式建立工具鏈（測試版）（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/tutorials/tutorial_dedicated_toolchain_app_flow){:new_window} + +## 相關鏈結 +{: #general} + +* [微服務工具鏈（測試版）（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/toolchains/microservices_toolchain){:new_window} +* [簡式工具鏈（測試版）（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method/toolchains/simple_toolchain){:new_window} +* [IBM Bluemix Garage Method（在新視窗中開啟鏈結）](https://www.ibm.com/devops/method){:new_window} diff --git a/toolchains/nl/zh/TW/toolchains_using.md b/toolchains/nl/zh/TW/toolchains_using.md index 96e99054b..c15a657fb 100644 --- a/toolchains/nl/zh/TW/toolchains_using.md +++ b/toolchains/nl/zh/TW/toolchains_using.md @@ -1,97 +1,97 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# 在 {{site.data.keyword.Bluemix_notm}} 公用上使用工具鏈 -{: #toolchains-using} - -前次更新：2016 年 10 月 7 日 -{: .last-updated} - -在每日開發、部署及操作工作中，使用工具鏈較具生產力。設定工具鏈之後，即可新增、刪除或配置工具整合，以及管理對工具鏈的存取。工具鏈只適用於美國南部地區。 -{: shortdesc} - -**附註**：請透過檢查頂端橫幅來確定您是以「全新 Bluemix」體驗進行工作。 - - * 如果看到有關試用新的 Bluemix 的訊息，則表示您是以「傳統 Bluemix」體驗進行工作。請按一下鏈結，以開啟「全新 Bluemix」體驗。 - * 如果未看到該訊息，則表示您已經以「全新 Bluemix」體驗進行工作。 - -## 配置工具整合 -{: #configuring_a_tool_integration} - -如果您已在建立工具鏈時延遲配置工具整合，則會在其磚上顯示**配置**按鈕。如果您已在建立工具鏈時配置工具整合，則可以更新配置設定。 - -1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**，然後按一下**工具整合**。 -1. 如果您需要配置首次工具整合，請在其磚上按一下**配置**。 - - ![「配置」按鈕](images/toolchain_tile_configure.png) - - 完成工具整合的配置後，請按一下**儲存整合**。 - -1. 如果您需要更新工具整合的配置，請在其磚上按一下功能表來存取配置選項。 - - ![「配置」功能表](images/toolchain_tile_menu.png) - - 完成設定的更新後，請按一下**儲存整合**。 - -## 新增工具整合 -{: #adding_a_tool_integration} - -您可以新增及配置工具鏈的工具整合。 - -1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**，然後按一下**工具整合**。 -1. 若要查看要新增的工具整合清單，請按一下新增按鈕 (+)。 -1. 按一下您要新增的工具整合。 -1. 輸入用來配置工具整合的任何必要資訊。 -1. 按一下**建立整合**，以將工具整合新增至您的工具鏈。 - -## 刪除工具整合 -{: #deleting_a_tool_integration} - -如果您從工具鏈中刪除工具整合，則無法復原刪除。 - -1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**，然後按一下**工具整合**。 -1. 在您要刪除之工具整合的磚上，按一下功能表來存取配置選項。 -1. 若要從工具鏈中刪除工具整合，請按一下**刪除**。 -1. 按一下**刪除**來進行確認。 - -## 管理存取權 -{: #managing_access} - -將使用者新增至與工具鏈相關聯的組織，即可將工具鏈存取權授與使用者。每一個工具鏈都會與特定組織相關聯，而且任何屬於該組織成員的使用者都可以存取相關聯的工具鏈。您目前在其中工作的組織顯示在功能表列中。請按一下該組織，然後切換至不同的組織來存取一組不同的工具鏈。 - - - - - -1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下要管理的工具鏈，然後按一下**管理**。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**，然後按一下**管理**。 -1. 按一下您組織的鏈結。 -1. 在「管理組織」頁面上，按一下**邀請使用者**，然後鍵入使用者的電子郵件位址。 -1. 如果您要授與管理 {{site.data.keyword.Bluemix_notm}} 組織中使用者的進階許可權，請選取一個以上的**管理員**、**帳單管理員**或**審核員**勾選框。 -1. 按一下**邀請**。 -1. 按一下**儲存**。 - -## 刪除工具鏈 -{: #deleting_a_toolchain} - -您可以刪除工具鏈，以及指定您要刪除的相關聯工具整合。當您刪除工具鏈時，無法復原刪除。 - -1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下要刪除的工具鏈，然後按一下**管理**。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**，然後按一下**管理**。 -1. 按一下**刪除工具鏈**，然後檢閱或調整所刪除的工具整合。 -1. 鍵入工具鏈名稱，然後按一下**刪除**，來確認刪除。 - - **提示**：當您刪除 GitHub 工具整合時，不會從 GitHub 中刪除相關聯的 GitHub 儲存庫。您必須從 GitHub 中手動移除儲存庫。 +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# 在 {{site.data.keyword.Bluemix_notm}} 公用上使用工具鏈 +{: #toolchains-using} + +前次更新：2016 年 10 月 7 日 +{: .last-updated} + +在每日開發、部署及操作工作中，使用工具鏈較具生產力。設定工具鏈之後，即可新增、刪除或配置工具整合，以及管理對工具鏈的存取。工具鏈只適用於美國南部地區。 +{: shortdesc} + +**附註**：請透過檢查頂端橫幅來確定您是以「全新 Bluemix」體驗進行工作。 + + * 如果看到有關試用新的 Bluemix 的訊息，則表示您是以「傳統 Bluemix」體驗進行工作。請按一下鏈結，以開啟「全新 Bluemix」體驗。 + * 如果未看到該訊息，則表示您已經以「全新 Bluemix」體驗進行工作。 + +## 配置工具整合 +{: #configuring_a_tool_integration} + +如果您已在建立工具鏈時延遲配置工具整合，則會在其磚上顯示**配置**按鈕。如果您已在建立工具鏈時配置工具整合，則可以更新配置設定。 + +1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**，然後按一下**工具整合**。 +1. 如果您需要配置首次工具整合，請在其磚上按一下**配置**。 + + ![「配置」按鈕](images/toolchain_tile_configure.png) + + 完成工具整合的配置後，請按一下**儲存整合**。 + +1. 如果您需要更新工具整合的配置，請在其磚上按一下功能表來存取配置選項。 + + ![「配置」功能表](images/toolchain_tile_menu.png) + + 完成設定的更新後，請按一下**儲存整合**。 + +## 新增工具整合 +{: #adding_a_tool_integration} + +您可以新增及配置工具鏈的工具整合。 + +1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**，然後按一下**工具整合**。 +1. 若要查看要新增的工具整合清單，請按一下新增按鈕 (+)。 +1. 按一下您要新增的工具整合。 +1. 輸入用來配置工具整合的任何必要資訊。 +1. 按一下**建立整合**，以將工具整合新增至您的工具鏈。 + +## 刪除工具整合 +{: #deleting_a_tool_integration} + +如果您從工具鏈中刪除工具整合，則無法復原刪除。 + +1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**，然後按一下**工具整合**。 +1. 在您要刪除之工具整合的磚上，按一下功能表來存取配置選項。 +1. 若要從工具鏈中刪除工具整合，請按一下**刪除**。 +1. 按一下**刪除**來進行確認。 + +## 管理存取權 +{: #managing_access} + +將使用者新增至與工具鏈相關聯的組織，即可將工具鏈存取權授與使用者。每一個工具鏈都會與特定組織相關聯，而且任何屬於該組織成員的使用者都可以存取相關聯的工具鏈。您目前在其中工作的組織顯示在功能表列中。請按一下該組織，然後切換至不同的組織來存取一組不同的工具鏈。 + + + + + +1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下要管理的工具鏈，然後按一下**管理**。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**，然後按一下**管理**。 +1. 按一下您組織的鏈結。 +1. 在「管理組織」頁面上，按一下**邀請使用者**，然後鍵入使用者的電子郵件位址。 +1. 如果您要授與管理 {{site.data.keyword.Bluemix_notm}} 組織中使用者的進階許可權，請選取一個以上的**管理員**、**帳單管理員**或**審核員**勾選框。 +1. 按一下**邀請**。 +1. 按一下**儲存**。 + +## 刪除工具鏈 +{: #deleting_a_toolchain} + +您可以刪除工具鏈，以及指定您要刪除的相關聯工具整合。當您刪除工具鏈時，無法復原刪除。 + +1. 在 DevOps 儀表板的**工具鏈**頁面上，按一下要刪除的工具鏈，然後按一下**管理**。或者，在應用程式之「概觀」頁面的「持續交付」磚上，按一下**檢視工具鏈**，然後按一下**管理**。 +1. 按一下**刪除工具鏈**，然後檢閱或調整所刪除的工具整合。 +1. 鍵入工具鏈名稱，然後按一下**刪除**，來確認刪除。 + + **提示**：當您刪除 GitHub 工具整合時，不會從 GitHub 中刪除相關聯的 GitHub 儲存庫。您必須從 GitHub 中手動移除儲存庫。 diff --git a/toolchains/nl/zh/TW/toolchains_using_dedicated.md b/toolchains/nl/zh/TW/toolchains_using_dedicated.md index b213b030e..97376e2e0 100644 --- a/toolchains/nl/zh/TW/toolchains_using_dedicated.md +++ b/toolchains/nl/zh/TW/toolchains_using_dedicated.md @@ -1,84 +1,84 @@ ---- - -copyright: - years: 2016 - ---- - -{:shortdesc: .shortdesc} -{:new_window: target="_blank"} - -# 在 {{site.data.keyword.Bluemix_notm}} 專用上使用工具鏈 -{: #toolchains-using_dedicated} - -前次更新：2016 年 9 月 13 日 -{: .last-updated} - -在每日開發、部署及操作工作中，使用工具鏈較具生產力。設定工具鏈之後，即可新增、刪除或配置工具整合，以及管理對工具鏈的存取。 -{: shortdesc} - -## 配置工具整合 -{: #configuring_a_tool_integration_dedicated} - -如果您已在建立工具鏈時延遲配置工具整合，則會在其磚上顯示**配置**按鈕。如果您已在建立工具鏈時配置工具整合，則可以更新配置設定。 - -1. 在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 如果您需要配置首次工具整合，請在其磚上按一下**配置**。 - - ![「配置」按鈕](images/toolchain_tile_configure.png) - - 完成工具整合的配置後，請按一下**儲存整合**。 - -1. 如果您需要更新工具整合的配置，請在其磚上按一下功能表來存取配置選項。 - - ![「配置」功能表](images/toolchain_tile_menu.png) - - 完成設定的更新後，請按一下**儲存整合**。 - -## 新增工具整合 -{: #adding_a_tool_integration_dedicated} - -您可以新增及配置工具鏈的工具整合。 - -1. 在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 若要查看要新增的工具整合清單，請按一下新增按鈕 (+)。 -1. 按一下要新增的工具整合。 -1. 輸入用來配置工具整合的任何必要資訊。 -1. 按一下**建立整合**，以將工具整合新增至您的工具鏈。 - -## 刪除工具整合 -{: #deleting_a_tool_integration} - -如果您從工具鏈中刪除工具整合，則無法復原刪除。 - -1. 在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 -1. 在要刪除之工具整合的磚上，按一下功能表來存取配置選項。 -1. 若要從工具鏈中刪除工具整合，請按一下**刪除**。 -1. 按一下**刪除**來進行確認。 - -## 管理存取權 -{: #managing_access_dedicated} - -將使用者新增至與工具鏈相關聯的組織，即可將工具鏈存取權授與使用者。每一個工具鏈都會與特定組織相關聯，而且任何屬於該組織成員的使用者都可以存取相關聯的工具鏈。若要檢視您目前在其中工作的組織，請按一下功能表列中的**{{site.data.keyword.avatar}}**圖示 ![「虛擬人像」圖示](../icons/i-avatar-icon.svg)。若要存取一組不同的工具鏈，請切換至不同的組織。 - -當您將使用者新增至 {{site.data.keyword.Bluemix}} 組織及空間時，使用者可以使用其 {{site.data.keyword.Bluemix_notm}} ID 及密碼來登入 GitHub Enterprise。使用者登入時，就會建立他們的帳戶。當您將使用者新增至 {{site.data.keyword.Bluemix_notm}} 組織及空間時，並不會將他們自動新增至 GitHub Enterprise 儲存庫。必須由具有儲存庫管理專用權的人員來新增他們。如需相關資訊，請參閱[使用專用 GitHub Enterprise（在新視窗中開啟鏈結）](../services/ghededicated/index.html){: new_window}。 - -若要新增使用者，請遵循下列步驟： - -1. 在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。然後，按一下**管理**。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**管理**。 -1. 按一下您組織的鏈結。 -1. 在「管理組織」頁面上，按一下**邀請使用者**，然後鍵入使用者的電子郵件位址。 -1. 如果您要授與管理 {{site.data.keyword.Bluemix_notm}} 組織中使用者的進階許可權，請選取一個以上的**管理員**、**帳單管理員**或**審核員**勾選框。 -1. 按一下**邀請**。 -1. 按一下**儲存**。 - -## 刪除工具鏈 -{: #deleting_a_toolchain_dedicated} - -您可以刪除工具鏈，以及指定您要刪除哪一個相關聯的工具整合。當您刪除工具鏈時，無法復原刪除。 - -1. 在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。然後，按一下**管理**。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**管理**。 -1. 按一下**刪除工具鏈**，然後檢閱或調整所刪除的工具整合。 -1. 鍵入工具鏈名稱，然後按一下**刪除**，來確認刪除。 - - **提示**：當您刪除 GitHub Enterprise 工具整合時，不會從 GitHub Enterprise 中刪除相關聯的 GitHub Enterprise 儲存庫。您必須從 GitHub Enterprise 中手動移除儲存庫。 +--- + +copyright: + years: 2016 + +--- + +{:shortdesc: .shortdesc} +{:new_window: target="_blank"} + +# 在 {{site.data.keyword.Bluemix_notm}} 專用上使用工具鏈 +{: #toolchains-using_dedicated} + +前次更新：2016 年 9 月 13 日 +{: .last-updated} + +在每日開發、部署及操作工作中，使用工具鏈較具生產力。設定工具鏈之後，即可新增、刪除或配置工具整合，以及管理對工具鏈的存取。 +{: shortdesc} + +## 配置工具整合 +{: #configuring_a_tool_integration_dedicated} + +如果您已在建立工具鏈時延遲配置工具整合，則會在其磚上顯示**配置**按鈕。如果您已在建立工具鏈時配置工具整合，則可以更新配置設定。 + +1. 在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 如果您需要配置首次工具整合，請在其磚上按一下**配置**。 + + ![「配置」按鈕](images/toolchain_tile_configure.png) + + 完成工具整合的配置後，請按一下**儲存整合**。 + +1. 如果您需要更新工具整合的配置，請在其磚上按一下功能表來存取配置選項。 + + ![「配置」功能表](images/toolchain_tile_menu.png) + + 完成設定的更新後，請按一下**儲存整合**。 + +## 新增工具整合 +{: #adding_a_tool_integration_dedicated} + +您可以新增及配置工具鏈的工具整合。 + +1. 在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 若要查看要新增的工具整合清單，請按一下新增按鈕 (+)。 +1. 按一下要新增的工具整合。 +1. 輸入用來配置工具整合的任何必要資訊。 +1. 按一下**建立整合**，以將工具整合新增至您的工具鏈。 + +## 刪除工具整合 +{: #deleting_a_tool_integration} + +如果您從工具鏈中刪除工具整合，則無法復原刪除。 + +1. 在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**工具整合**。 +1. 在要刪除之工具整合的磚上，按一下功能表來存取配置選項。 +1. 若要從工具鏈中刪除工具整合，請按一下**刪除**。 +1. 按一下**刪除**來進行確認。 + +## 管理存取權 +{: #managing_access_dedicated} + +將使用者新增至與工具鏈相關聯的組織，即可將工具鏈存取權授與使用者。每一個工具鏈都會與特定組織相關聯，而且任何屬於該組織成員的使用者都可以存取相關聯的工具鏈。若要檢視您目前在其中工作的組織，請按一下功能表列中的**{{site.data.keyword.avatar}}**圖示 ![「虛擬人像」圖示](../icons/i-avatar-icon.svg)。若要存取一組不同的工具鏈，請切換至不同的組織。 + +當您將使用者新增至 {{site.data.keyword.Bluemix}} 組織及空間時，使用者可以使用其 {{site.data.keyword.Bluemix_notm}} ID 及密碼來登入 GitHub Enterprise。使用者登入時，就會建立他們的帳戶。當您將使用者新增至 {{site.data.keyword.Bluemix_notm}} 組織及空間時，並不會將他們自動新增至 GitHub Enterprise 儲存庫。必須由具有儲存庫管理專用權的人員來新增他們。如需相關資訊，請參閱[使用專用 GitHub Enterprise（在新視窗中開啟鏈結）](../services/ghededicated/index.html){: new_window}。 + +若要新增使用者，請遵循下列步驟： + +1. 在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。然後，按一下**管理**。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**管理**。 +1. 按一下您組織的鏈結。 +1. 在「管理組織」頁面上，按一下**邀請使用者**，然後鍵入使用者的電子郵件位址。 +1. 如果您要授與管理 {{site.data.keyword.Bluemix_notm}} 組織中使用者的進階許可權，請選取一個以上的**管理員**、**帳單管理員**或**審核員**勾選框。 +1. 按一下**邀請**。 +1. 按一下**儲存**。 + +## 刪除工具鏈 +{: #deleting_a_toolchain_dedicated} + +您可以刪除工具鏈，以及指定您要刪除哪一個相關聯的工具整合。當您刪除工具鏈時，無法復原刪除。 + +1. 在「儀表板」的 **DevOps** 標籤上，按一下工具鏈來開啟它的「工具整合」頁面。然後，按一下**管理**。或者，在應用程式之「概觀」頁面的右上角，按一下**檢視工具鏈**。然後，按一下**管理**。 +1. 按一下**刪除工具鏈**，然後檢閱或調整所刪除的工具整合。 +1. 鍵入工具鏈名稱，然後按一下**刪除**，來確認刪除。 + + **提示**：當您刪除 GitHub Enterprise 工具整合時，不會從 GitHub Enterprise 中刪除相關聯的 GitHub Enterprise 儲存庫。您必須從 GitHub Enterprise 中手動移除儲存庫。 diff --git a/toolchains/nl/zh/TW/web_ide.md b/toolchains/nl/zh/TW/web_ide.md index cf0b171bf..623e4f475 100644 --- a/toolchains/nl/zh/TW/web_ide.md +++ b/toolchains/nl/zh/TW/web_ide.md @@ -1,152 +1,152 @@ ---- - -copyright: - years: 2015, 2016 - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:screen:.screen} -{:codeblock:.codeblock} -{:pre: .pre} - -# 使用 Eclipse Orion {{site.data.keyword.webide}} 編輯程式碼 -{: #web_ide} - -前次更新：2016 年 9 月 9 日 -{: .last-updated} - -Eclipse Orion {{site.data.keyword.webide}} 是一種您可以針對 Web 進行開發的瀏覽器型開發環境。有了內容輔助、程式碼完成及錯誤檢查的協助，您就可以使用 JavaScript、HTML 及 CSS 進行開發。{{site.data.keyword.webide}} 幾乎使用任何語言，並且提供大部分[檔案類型（在新視窗中開啟鏈結）](https://hub.jazz.net/docs/overview/#dev_support){: new_window}的語法強調顯示。來源控制是透過 Git 或 Jazz SCM 所建置，而且您可以在本端部署程式碼來測試及除錯應用程式。 -{:shortdesc} - -最好的是，{{site.data.keyword.webide}} 採用 Web 技術。您沒有要安裝的項目、要維護的項目，以及要調整的項目。您可以在具有網際網路連線的任何位置進行開發。 - -## 設定編輯器 -{: #editorsetup} - -{{site.data.keyword.webide}} 可進行自訂，以選擇色系、技術工具，以及符合開發需求的設定。若要檢視及修改設定，請從左邊的功能表中，按一下**設定**圖示 「設定」圖示。 - -如果您經常需要在編輯時變更特定設定，則可以從編輯器右上角的**本端編輯器設定**圖示 「本端編輯器設定」圖示 快速存取這些設定。 - -![本端編輯器設定](images/webide_local_editor_settings.png) - -預設一律會顯示編輯器樣式及字型大小的設定。若要在功能表中包括其他編輯器設定，請遵循下列步驟： - -1. 按一下**本端編輯器設定**圖示 「本端編輯器設定」圖示。 - -2. 按一下**編輯器設定**。 - -3. 若要從**本端編輯器設定**功能表中包括或排除設定，請按一下設定旁邊的圓形。 - -![「編輯器設定」切換](images/webide_editor_settings_toggle.png) - - -## 編輯程式碼 -{: #editcode} - -{{site.data.keyword.webide}} 有兩個主要區段。第一個區段是左邊的檔案導覽器，會以樹狀結構顯示專案檔。您可以從檔案導覽器中建立、重新命名、刪除及管理檔案和資料夾。 - -**提示：**若要將檔案上傳至檔案導覽器，請將它們從您的電腦拖曳至檔案導覽器。 - -第二個區段是右邊的編輯器窗格。編輯器提供數個程式碼特性（包括內容輔助及語法驗證）。 - -![Web IDE](images/webide.png) - -### 使用多個檔案 -1. 若要同時使用兩個檔案，請按一下編輯器頂端的**變更分割編輯器模式**圖示 「分割編輯器」圖示。 -2. 從開啟的功能表中，選取視圖。 - - 在您選取視圖之後，如果已在編輯器中開啟檔案，則會以兩種編輯器視圖顯示檔案。 - - 若要開啟或變更在其中一個編輯器視圖中顯示的檔案，請執行下列動作： - 1. 將游標移至您要變更的編輯器視圖。 - 2. 在檔案導覽器中，按一下檔案。 - -### 鍵盤快速鍵 -只能透過鍵盤快速鍵存取 {{site.data.keyword.webide}} 中的大部分指令。 - -若要查看編輯器中的鍵盤快速鍵清單，請按 Alt+Shift+?。如果您是使用 Mac OS，請按 Ctrl+Shift+?。 - -## 管理原始碼 -{: #sourcecontrol} - -{{site.data.keyword.webide}} 是與原始碼管理工具整合。若要使用 Git 儲存庫，請按一下 **Git 儲存庫**圖示 「Git 儲存庫」圖示。如需相關資訊，請參閱[使用 Git 進行來源控制（在新視窗中開啟鏈結）](https://hub.jazz.net/docs/git/){: new_window}。 - - -## 從工作區部署應用程式 -{: #deploy} - -1. 若要部署應用程式，請從執行列中選取或[建立（在新視窗中開啟鏈結）](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window}啟動配置。 -1. 按一下部署圖示 部署圖示。使用您工作區的現行內容以及啟動配置中所定義的環境，即可部署您應用程式的實例。 -2. 部署應用程式之後，即可使用執行列來停止、重新啟動或除錯應用程式、檢視日誌，以及執行其他作業。 -![執行列](images/webide_runbar.png) - - - - ## 在 {{site.data.keyword.webide}} 外部編輯 -{: #editlocal} - -若要使用 {{site.data.keyword.webide}} 以外的編輯器，請設定 {{site.data.keyword.Bluemix_live}}，以便直接在任何工具中使用專案檔。{{site.data.keyword.Bluemix_live_notm}} 是一種指令行應用程式，可同步化本端檔案系統中的變更與 {{site.data.keyword.jazzhub}} 中的雲端工作區。 - -### 開始之前 - -下載並安裝 [{{site.data.keyword.Bluemix_live_notm}} 指令行介面（在新視窗中開啟鏈結）](http://livesyncdownload.ng.bluemix.net){: new_window}。 - -### 同步化本端環境與 {{site.data.keyword.Bluemix_notm}} -{: #edit_local_download} - -1. 開啟指令行視窗。 -2. 登入 {{site.data.keyword.Bluemix_notm}}： - - ``` - bl login - ``` - {: pre} - -3. 系統提示您時，請輸入 IBM ID 及密碼。 -4. 檢視 {{site.data.keyword.Bluemix_notm}} 專案清單： - - ``` - bl projects - ``` - {: pre} - -4. 同步化本端環境與 {{site.data.keyword.Bluemix_notm}} 上的專案： - - ``` - bl sync projectName - ``` - {: pre} - -其中 `projectName` 是您 {{site.data.keyword.Bluemix_notm}} 應用程式的名稱。 - -完成編輯時，請輸入 `q` 以結束同步化。 - -### 啟用桌面同步特性以在本端編輯程式碼 - -「桌面同步」特性就像指令行的「即時編輯」模式。您需要「桌面同步」特性，才能在指令行上進行除錯。 -1. 在另一個指令行視窗中，啟用「桌面同步」特性： - - ``` - cd localDirectory - bl start - ``` - {: codeblock} - -2. 使用您在 {{site.data.keyword.webide}} 中建立的啟動配置。在您選取啟動配置之後，會在本端環境中啟用「桌面同步」特性。在剛剛開啟的指令行視窗中，您可以檢視應用程式的 URL、除錯 URL、管理 URL，以及檢視 {{site.data.keyword.Bluemix_live_notm}} 狀態。 - -3. 重新整理瀏覽器，並驗證您可以在本端工作區中看到儲存至靜態檔案的變更。 - -### 停用桌面同步特性 - -1. 在第二個指令行視窗中，輸入 `bl stop`。 -2. 在第一個指令行視窗中，輸入 `q`。 +--- + +copyright: + years: 2015, 2016 + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:screen:.screen} +{:codeblock:.codeblock} +{:pre: .pre} + +# 使用 Eclipse Orion {{site.data.keyword.webide}} 編輯程式碼 +{: #web_ide} + +前次更新：2016 年 9 月 9 日 +{: .last-updated} + +Eclipse Orion {{site.data.keyword.webide}} 是一種您可以針對 Web 進行開發的瀏覽器型開發環境。有了內容輔助、程式碼完成及錯誤檢查的協助，您就可以使用 JavaScript、HTML 及 CSS 進行開發。{{site.data.keyword.webide}} 幾乎使用任何語言，並且提供大部分[檔案類型（在新視窗中開啟鏈結）](https://hub.jazz.net/docs/overview/#dev_support){: new_window}的語法強調顯示。來源控制是透過 Git 或 Jazz SCM 所建置，而且您可以在本端部署程式碼來測試及除錯應用程式。 +{:shortdesc} + +最好的是，{{site.data.keyword.webide}} 採用 Web 技術。您沒有要安裝的項目、要維護的項目，以及要調整的項目。您可以在具有網際網路連線的任何位置進行開發。 + +## 設定編輯器 +{: #editorsetup} + +{{site.data.keyword.webide}} 可進行自訂，以選擇色系、技術工具，以及符合開發需求的設定。若要檢視及修改設定，請從左邊的功能表中，按一下**設定**圖示 「設定」圖示。 + +如果您經常需要在編輯時變更特定設定，則可以從編輯器右上角的**本端編輯器設定**圖示 「本端編輯器設定」圖示 快速存取這些設定。 + +![本端編輯器設定](images/webide_local_editor_settings.png) + +預設一律會顯示編輯器樣式及字型大小的設定。若要在功能表中包括其他編輯器設定，請遵循下列步驟： + +1. 按一下**本端編輯器設定**圖示 「本端編輯器設定」圖示。 + +2. 按一下**編輯器設定**。 + +3. 若要從**本端編輯器設定**功能表中包括或排除設定，請按一下設定旁邊的圓形。 + +![「編輯器設定」切換](images/webide_editor_settings_toggle.png) + + +## 編輯程式碼 +{: #editcode} + +{{site.data.keyword.webide}} 有兩個主要區段。第一個區段是左邊的檔案導覽器，會以樹狀結構顯示專案檔。您可以從檔案導覽器中建立、重新命名、刪除及管理檔案和資料夾。 + +**提示：**若要將檔案上傳至檔案導覽器，請將它們從您的電腦拖曳至檔案導覽器。 + +第二個區段是右邊的編輯器窗格。編輯器提供數個程式碼特性（包括內容輔助及語法驗證）。 + +![Web IDE](images/webide.png) + +### 使用多個檔案 +1. 若要同時使用兩個檔案，請按一下編輯器頂端的**變更分割編輯器模式**圖示 「分割編輯器」圖示。 +2. 從開啟的功能表中，選取視圖。 + + 在您選取視圖之後，如果已在編輯器中開啟檔案，則會以兩種編輯器視圖顯示檔案。 + + 若要開啟或變更在其中一個編輯器視圖中顯示的檔案，請執行下列動作： + 1. 將游標移至您要變更的編輯器視圖。 + 2. 在檔案導覽器中，按一下檔案。 + +### 鍵盤快速鍵 +只能透過鍵盤快速鍵存取 {{site.data.keyword.webide}} 中的大部分指令。 + +若要查看編輯器中的鍵盤快速鍵清單，請按 Alt+Shift+?。如果您是使用 Mac OS，請按 Ctrl+Shift+?。 + +## 管理原始碼 +{: #sourcecontrol} + +{{site.data.keyword.webide}} 是與原始碼管理工具整合。若要使用 Git 儲存庫，請按一下 **Git 儲存庫**圖示 「Git 儲存庫」圖示。如需相關資訊，請參閱[使用 Git 進行來源控制（在新視窗中開啟鏈結）](https://hub.jazz.net/docs/git/){: new_window}。 + + +## 從工作區部署應用程式 +{: #deploy} + +1. 若要部署應用程式，請從執行列中選取或[建立（在新視窗中開啟鏈結）](https://hub.jazz.net/tutorials/livesync/#launch_configuration){: new_window}啟動配置。 +1. 按一下部署圖示 部署圖示。使用您工作區的現行內容以及啟動配置中所定義的環境，即可部署您應用程式的實例。 +2. 部署應用程式之後，即可使用執行列來停止、重新啟動或除錯應用程式、檢視日誌，以及執行其他作業。 +![執行列](images/webide_runbar.png) + + + + ## 在 {{site.data.keyword.webide}} 外部編輯 +{: #editlocal} + +若要使用 {{site.data.keyword.webide}} 以外的編輯器，請設定 {{site.data.keyword.Bluemix_live}}，以便直接在任何工具中使用專案檔。{{site.data.keyword.Bluemix_live_notm}} 是一種指令行應用程式，可同步化本端檔案系統中的變更與 {{site.data.keyword.jazzhub}} 中的雲端工作區。 + +### 開始之前 + +下載並安裝 [{{site.data.keyword.Bluemix_live_notm}} 指令行介面（在新視窗中開啟鏈結）](http://livesyncdownload.ng.bluemix.net){: new_window}。 + +### 同步化本端環境與 {{site.data.keyword.Bluemix_notm}} +{: #edit_local_download} + +1. 開啟指令行視窗。 +2. 登入 {{site.data.keyword.Bluemix_notm}}： + + ``` + bl login + ``` + {: pre} + +3. 系統提示您時，請輸入 IBM ID 及密碼。 +4. 檢視 {{site.data.keyword.Bluemix_notm}} 專案清單： + + ``` + bl projects + ``` + {: pre} + +4. 同步化本端環境與 {{site.data.keyword.Bluemix_notm}} 上的專案： + + ``` + bl sync projectName + ``` + {: pre} + +其中 `projectName` 是您 {{site.data.keyword.Bluemix_notm}} 應用程式的名稱。 + +完成編輯時，請輸入 `q` 以結束同步化。 + +### 啟用桌面同步特性以在本端編輯程式碼 + +「桌面同步」特性就像指令行的「即時編輯」模式。您需要「桌面同步」特性，才能在指令行上進行除錯。 +1. 在另一個指令行視窗中，啟用「桌面同步」特性： + + ``` + cd localDirectory + bl start + ``` + {: codeblock} + +2. 使用您在 {{site.data.keyword.webide}} 中建立的啟動配置。在您選取啟動配置之後，會在本端環境中啟用「桌面同步」特性。在剛剛開啟的指令行視窗中，您可以檢視應用程式的 URL、除錯 URL、管理 URL，以及檢視 {{site.data.keyword.Bluemix_live_notm}} 狀態。 + +3. 重新整理瀏覽器，並驗證您可以在本端工作區中看到儲存至靜態檔案的變更。 + +### 停用桌面同步特性 + +1. 在第二個指令行視窗中，輸入 `bl stop`。 +2. 在第一個指令行視窗中，輸入 `q`。 diff --git a/troubleshoot/bxnui.md b/troubleshoot/bxnui.md index 86162415a..4a325c27e 100755 --- a/troubleshoot/bxnui.md +++ b/troubleshoot/bxnui.md @@ -1,1567 +1,1567 @@ ---- - - - -copyright: - - years: 2015, 2016 - -lastupdated: "2016-11-21" - ---- - -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# {{site.data.keyword.Bluemix_notm}} error messages - - -When you receive an error message from {{site.data.keyword.Bluemix}}, you can use the message ID to find more information about how to resolve the problem. -{:shortdesc} - -## BXNUI0001E -**Message**: The page wasn't loaded because Bluemix didn't detect whether a session exists. - -For instructions to fix this problem, see this [troubleshooting topic](https://www.{DomainName}/docs/troubleshoot/accessing.html#tr_err){: new_window}. - - - -## BXNUI0004E -**Message**: The '{0}' app wasn't deleted because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0005E -**Message**: The '{0}' app wasn't created because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0006E -**Message**: The '{0}' app didn't stop because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - - - -## BXNUI0008E -**Message**: The '{0}' app details weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0009E -**Message**: The application starters weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0010E -**Message**: The '{0}' starter for the '{1}' app wasn't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0011E -**Message**: The '{0}' starter wasn't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0013E -**Message**: The '{0}' service instance wasn't created because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0014E -**Message**: The settings for the '{0}' service weren't updated because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0015E -**Message**: Service offerings weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0016E -**Message**: The apps and services weren't retrieved because a Bluemix page didn't load. - -For instructions to fix this problem, see this [troubleshooting topic](https://www.{DomainName}/docs/troubleshoot/accessing.html#tr_err){: new_window}. - -## BXNUI0017E -**Message**: The service instance wasn't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0018E -**Message**: The instances for the '{0}' app weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0019E -**Message**: The instances for your app weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0020E -**Message**: The settings for the '{0}' app weren't updated because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0021E -**Message**: The environment variables for the '{0}' app weren't updated because a problem occurred contacting Cloud Foundry. -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0022E -**Message**: The routes for the '{0}' app weren't updated because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0023E -**Message**: The settings for the '{0}' service instance weren't updated because a problem occurred contacting Cloud Foundry. -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0024E -**Message**: The quick start for the '{0}' app wasn't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0025E -**Message**: The quick start for the '{0}' service wasn't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0026E -**Message**: The '{0}' space wasn't created because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0027E -**Message**: The '{0}' space wasn't deleted because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0028E -**Message**: The '{0}' organization wasn't created because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0029E -**Message**: The '{0}' organization wasn't deleted because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0030E -**Message**: The '{0}' route wasn't mapped to the '{1}' app because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0031E -**Message**: The '{0}' route wasn't unmapped from the '{1}' app because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0032E -**Message**: Information for the '{0}' organization or space wasn't saved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0033E -**Message**: The '{0}' service wasn't added to the '{1}' app because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0034E -**Message**: The '{0}' service wasn't removed from the '{1}' app because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0035E -**Message**: The '{0}' service instance wasn't deleted because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0036E -**Message**: The service bindings for the '{0}' app or service weren't deleted because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0037E -**Message**: The service instances that were bound to the '{0}' app weren't deleted because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0038E -**Message**: The routes that are associated with the '{0}' app weren't deleted because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0039E -**Message**: The route associations for the '{0}' domain must be deleted. - -On the app's Overview page, click **Routes and domains** drop-down, and select **Edit routes**. - -## BXNUI0040E -**Message**: Service bindings weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - - - - - -## BXNUI0044E -**Message**: Information wasn't retrieved from the server because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0045E -**Message**: Files or logs for the '{0}' application weren't retrieved by using the '{1}' instance because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0046E -**Message**: Your organizations weren't retrieved because of a problem contacting Cloud Foundry. - -You will be logged out of Bluemix. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0048E -**Message**: Spaces for the '{0}' organization weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0049E -**Message**: The organization's domains weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0050E -**Message**: The organization's summary wasn't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0052E -**Message**: The users for the '{0}' organization weren't updated because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0053E -**Message**: The users for the '{0}' space weren't updated because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0054E -**Message**: The user, '{0}', wasn't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0055E -**Message**: The users for the parent organization of the '{0}' space weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0056E -**Message**: The users for the '{0}' organization weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0057E -**Message**: The users for the '{0}' space weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0058E -**Message**: A domain wasn't created because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0059E -**Message**: A domain wasn't deleted because a problem occurred contacting IBM DataPower Gateway. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0060E -**Message**: A certificate for the '{0}' domain wasn't uploaded because a problem occurred contacting IBM DataPower Gateway. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0061E -**Message**: The user, '{0}', wasn't added to the account because a problem occurred contacting the business support system. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0062E -**Message**: Your session expired, and you must log in again. - -## BXNUI0063E -**Message**: The operation timed out. - -Try again later. - -## BXNUI0064E -**Message**: The browser that you are using is not supported by IBM Bluemix. - -The following browsers are supported. Ensure that you use the latest version for your operating system. -* Google Chrome -* Mozilla Firefox -* Internet Explorer -* Safari - -For details, see the [Bluemix Prerequisites page](https://developer.ibm.com/bluemix/support/#prereqs). - - -## BXNUI0065E -**Message**: The VCAP_SERVICES environment variable for '{0}' wasn't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0066E -**Message**: The runtime can't be deleted because when the runtime was added, a buildpack value was explicitly set for the application by using the `-b` option on the `cf` push command. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0067E -**Message**: The data for the plans wasn't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - - - -## BXNUI0070E -**Message**: The certificate for the '{0}' domain wasn't retrieved because a problem occurred contacting IBM DataPower Gateway. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0071E -**Message**: The certificate for the '{0}' domain wasn't deleted because a problem occurred contacting IBM DataPower Gateway. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0072E -**Message**: The certificate for the '{0}' domain wasn't replaced because a problem occurred contacting IBM DataPower Gateway. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0073E -**Message**: Information about the uploaded certificates could not be retrieved. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0076E -**Message**: The '{0}' service is already connected to all apps in the '{1}' space. - -To use a different plan for this service, you must delete the service and connect it again. - -## BXNUI0077E -**Message**: The '{0}' service already exists in the '{1}' space. - -Choose another space, if needed. - -## BXNUI0078E -**Message**: The '{1}' app already uses the '{0}' service. - -Select a different service. - -## BXNUI0079E -**Message**: The '{1}' app already uses the '{2}' service. The '{0}' service and the '{2}' service cannot be used together. - -Select a different service. - -## BXNUI0080E -**Message**: Before you can add the '{0}' service to the '{1}' app, the app must use the prerequisite service, '{2}'. - -Add the prerequisite service first, and then try again. - -## BXNUI0081E -**Message**: You uploaded {0} certificates, which is the maximum number that your organization can use. - -Either delete a certificate or upgrade your account. - -## BXNUI0082E -**Message**: Bluemix can't load your notification preferences at the moment. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0083E -**Message**: Your notification preferences could not be saved. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0085E -**Message**: The usage data for containers wasn't retrieved. - -The container might be temporarily out of service. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0086E -**Message**: The '{0}' container didn't start. - -The container might be temporarily out of service. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0087E -**Message**: The '{0}' container didn't stop. - -The container might be temporarily out of service. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0088E -**Message**: The '{0}' container didn't restart. - -The container might be temporarily out of service. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0089E -**Message**: The '{0}' container can't be paused. - -The container might be temporarily out of service. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0090E -**Message**: The '{0}' container can't be unpaused. - -The container might be temporarily out of service. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0091E -**Message**: The '{0}' container wasn't deleted. - -The container might be temporarily out of service. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0092E -**Message**: The '{0}' VM group wasn't deleted because of a problem connecting to the VM resources. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0093E -**Message**: The '{0}' container group wasn't deleted. - -The container group might be temporarily out of service. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0094E -**Message**: The registry name could not be set. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0095E -**Message**: The private registry name is already being used. - -Use a different name and try again. - -## BXNUI0096E -**Message**: The app wasn't created. - -Your account is inactive because it was canceled or suspended. - -For instructions to fix this problem, see this [troubleshooting topic](https://www.{DomainName}/docs/troubleshoot/managingaccounts.html#ts_accnt_inactive){: new_window}. - -## BXNUI0097E -**Message**: Before you can add an app, at least one space must be associated with your organization and region. - -On the Dashboard, click **Create a Space**. When the space is created, try again. For more instructions to fix this problem, see this [troubleshooting topic](https://www.{DomainName}/docs/troubleshoot/managingaccounts.html#ts_no_space){: new_window}. - -## BXNUI0098E -**Message**: The list of credentials can't be retrieved at the moment. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0099E - -**Message**: The '{0}' credential wasn't added. - -Try using a different name, or try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0100E - -**Message**: The '{0}' credential wasn't deleted. - -The credential might have already been deleted. - -Return to the Dashboard and try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0101E - -**Message**: Your current browser settings prevent pop-up windows. - -Change your browser settings to allow pop-up windows. - -## BXNUI0111E -**Message**: The login server can't be contacted at the moment. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0112E -**Message**: The plan could not be updated. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0113E -**Message**: The {0} service instance wasn't deleted because its credentials weren't deleted. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - - - - - -## BXNUI0118E - -**Message**: {0}'s access to {1} could not be revoked. - -Try to revoke access again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0119E - -**Message**: The '{0}' VM didn't start because of a problem connecting to the VM resources. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0120E - -**Message**: The '{0}' VM didn't stop because of a problem connecting to the VM resources. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0121E - -**Message**: The '{0}' VM didn't reboot because of a problem connecting to the VM resources. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0122E - -**Message**: The '{0}' VM wasn't suspended because of a problem connecting to the VM resources. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0123E - -**Message**: The '{0}' VM wasn't resumed because of a problem connecting to the VM resources. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0124E - -**Message**: The '{0}' VM wasn't deleted because of a problem connecting to the VM resources. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0125E - -**Message**: You will be logged out because you are not a member of an active account. - -Your Bluemix account might have expired or been cancelled, or you might have been removed from your org. -Contact your org manager. Or, for help and support options, see the Troubleshooting section of the Bluemix Docs. - -## BXNUI0126E - -**Message**: The {0} container group is still in the process of being deleted. - -Refresh the page later to verify that the container group is deleted. - -## BXNUI0127E - -**Message**: The {0} container is still in the process of being deleted. - -Refresh the page later to verify that the container is deleted. - -## BXNUI0128E - -**Message**: Your organizations weren't retrieved because of a problem contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0129E -**Message**: The account information wasn't retrieved because of a problem contacting the business support system. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0130E -**Message**: The account information wasn't retrieved because of a problem contacting the business support system. - -You will be logged out of Bluemix. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0131E -**Message**: Your email address wasn't registered because an error occurred during the registration process. - -To resolve this problem, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0132E -**Message**: The __name__ information was not retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0133E - -**Message**: Service bindings weren't retrieved because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0200E -**Message**: The routes for the app weren't retrieved because of an internal error. - -Try again later. If the problem continues, go to IBM Bluemix Support. - -## BXNUI0201E -**Message**: The routes for the space weren't retrieved because of an internal error. - -Try again later. If the problem continues, go to IBM Bluemix Support. - -## BXNUI0202E -**Message**: The domains for the org weren't retrieved because of an internal error. - -Try again later. If the problem continues, go to IBM Bluemix Support. - -## BXNUI0203E -**Message**: The routes for the app weren't retrieved because of an internal error. - -Try again later. If the problem continues, go to IBM Bluemix Support. - -## BXNUI0300E -**Message**: The usage information could not be retrieved. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0301E -**Message**: While the usage information was being retrieved, the organizations could not be retrieved. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0305E -**Message**: The usage information could not be displayed. - -If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0306E -**Message**: Third-party services information could not be retrieved. - -If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0307E -**Message**: Promotional codes can't be applied at this time. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0400E -**Message**: The list of countries could not be displayed. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0402E -**Message**: Your account can't be canceled at this time. - -Try again later or go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0500E -**Message**: Your request to reserve a dedicated instance wasn't submitted due to an error. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0501E -**Message**: That container name is already in use. - -Enter a different name. - -## BXNUI0502E -**Message**: The container wasn't created. - -Either your user role does not have the required authority in this space, or you are not a member of the space. - -If you are a member of the space, you must have the developer user role to create container instances. You can request that role from your org manager. If you are not a member of this space, you can request to be added to it. - -## BXNUI0503E -**Message**: The container wasn't created because of an internal error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0504E -**Message**: The container was created, but the IP address was not assigned to it because that IP address isn't available. - -Select a different IP address or select to request and bind public IP address. - -## BXNUI0505E -**Message**: The container was created, but it wasn't assigned an IP address because no IP addresses are available. - -You can adjust the quota on the Quota tab for your organization. - -## BXNUI0506E -**Message**: The container wasn't created because the VCAP_SERVICES environment variable details were not retrieved. - -Bind a service to your selected app or select a different app. - -## BXNUI0507E -**Message**: That container group name is already in use. - -Enter a different name. - -## BXNUI0508E -**Message**: The container group wasn't created because your user role does not have the required authority in this space. - -To create container groups, you must have the developer role. Request that role from your org manager. - -## BXNUI0509E -**Message**: The container group wasn't created because of an internal error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0510E -**Message**: The container wasn't created because some resources, such as an IP address or memory, are not available. - -To adjust the quotas, go to **Manage Organizations**, click the **Quota** tab for your org, and click **Containers**. Then, try to select the image again. - -## BXNUI0511E - -**Message**: The container group wasn't created because some resources, such as an IP address or memory, are not available. - -To adjust the quotas, go to **Manage Organizations**, click the **Quota** tab for your org, and click **Containers**. Then, try to create the container group again. - -## BXNUI0512E - -**Message**: While attempting to create a container from the image, an internal error occurred. Some resources, such as an IP address or memory, were not available when the namespace was being retrieved. - -To adjust the quotas, go to **Manage Organizations**, click the **Quota** tab for your org, and click **Containers**. Then, try to select the image again. - -## BXNUI0513E - -**Message**: The containers weren't retrieved because a problem occurred contacting IBM Containers. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0514E - -**Message**: You are not a developer for any of the spaces in the '__orgName__' organization. - -Try to select another org or create a space, or request the developer role from your org manager. - -## BXNUI0515E - -**Message**: The spaces in the org weren't retrieved because of a network connection problem. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0516E - -**Message**: The container namespace of the org wasn't retrieved because of an internal error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0517E - -**Message**: The container namespace of the org wasn't retrieved because of an internal error with incident ID __incidentID__. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0518E - -**Message**: The container wasn't created because of an internal error with incident ID __incidentID__. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0519E - -**Message**:The container group wasn't created because of an internal error with incident ID __incidentID__. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0521E - -**Message**: While attempting to create a container from the image, an internal error with incident ID __incidentID__ occurred. Some resources, such as an IP address or memory, were not available when the namespace was being retrieved. - -To adjust the quotas, go to **Manage Organizations**, click the **Quota** tab for your org, and click **Containers**. Then, try to select the image again. - -## BXNUI0522E - -**Message**: You can't create the resource because you are not a developer for the __spaceName__ in the __orgName__ organization. - -Try to select another space or org or create a space, or request the developer role from your org manager. - -## BXNUI0523E - -**Message**: The infrastructure resources weren't retrieved because a problem occurred contacting SoftLayer. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0524E - -**Message**: The attempt to register the container namespace failed because a problem occurred connecting to the container API. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0525E - -**Message**: The attempt to create a registry failed because you do not have authority to the registry namespace for org __orgName__. The developer user role is required to create a registry. - -Request a different role from your org manager. - -## BXNUI0526E - -**Message**: The attempt to retrieve the container image failed because a problem occurred contacting IBM Containers. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0600E - -**Message**: The route '{0}' is already assigned. - -Try a different route. - -## BXNUI0602E - -**Message**: Failed to add the {0} service to your application because a problem occurred contacting Cloud Foundry. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0700E - -**Message**: The ‘{0}’ space wasn't created because a problem occurred contacting Cloud Foundry. - -Click **Create** to try again or cancel the action. - -## BXNUI0701E - -**Message**: Failed to invite users. Error Code: __errorCode__. - -Try again later. If you see this message again, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0702E - -**Message**: Failed to invite __emailAddress__. Error Code: __errorCode__. - -Try again later. If you see this message again, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI0703E - -**Message**: The details for this invited user are currently unavailable. - -Try again later. - -## BXNUI0704E - -**Message**: The details for this invited user could not be loaded from the following region or regions: __regions__. - -Try again later. - -## BXNUI2000E -**Message**: The request was not processed because of an error. This exception was issued: {0} - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2001E -**Message**: No Ant `build.xml` file exists for the "{0}" starter. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2002E -**Message**:No builder exists for the "{0}" starter. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - - - -## BXNUI2004E -**Message**: The app was not created because of an error from the cloud server. - -Try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - - - - - - - -## BXNUI2008E -**Message**: The app was not created because a .zip file could not be created for the {0} app that uses the {1} starter. - -Try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2009E -**Message**: The configuration wasn't loaded because of an error. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2010E -**Message**: The configuration could not be loaded. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2011E -**Message**: The configuration can't be saved because it comes from multiple sources. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2012E -**Message**: The configuration can't be saved because it is read-only. - -## BXNUI2013E -**Message**: A class wasn't created from the "{0}" configuration because of an error. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2014E -**Message**: The class name is not in the "{0}" configuration. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2015E -**Message**: The attempt to log in failed because the cloud controller URL is formatted incorrectly. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2016E -**Message**: The resource metadata could not be loaded. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2017E -**Message**: The resource metadata could not be saved. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2018E -**Message**: The metadata for the "{1}" starter didn't have the required "{0}" property. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2019E -**Message**: The template metadata specified an unknown source control management type of "{0}". - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2020E -**Message**: The "{0}" resource doesn't exist. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2021E -**Message**: The "{0}" starter directory doesn't exist. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2022E -**Message**: The starters could not be copied. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2023E -**Message**: The `VCAP_SERVICES` environment variable isn't defined. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2024E -**Message**: Self registration for users isn't enabled. - -Contact the account owner. - -## BXNUI2025E -**Message**: During an attempt to build an entity tag for web caching, an error occurred. IBM Bluemix could not determine whether an icon was cached. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2026E -**Message**: Another user already uses that name. - -Try again with a different user name. - -## BXNUI2027E -**Message**: No user is logged in. - -Log in and try again. - -## BXNUI2028E -**Message**: Cloud Foundry issued an unexpected exception with this message: "{0}" - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2029E -**Message**: The cloud information could not be retrieved. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2030E -**Message**: Cloud Foundry message: "{0}" - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2031E -**Message**: The Bluemix datastore component isn't available. - -Contact the system administrator for assistance in fixing the datastore component. - -## BXNUI2032E -**Message**: The {1} resource wasn't created. - -While Cloud Foundry was being contacted to create the resource, an error occurred. Cloud Foundry message: "{0}." - -For instructions to fix this problem, see this [troubleshooting topic](https://www.{DomainName}/docs/troubleshoot/managingapps.html#tr_servicelimit){: new_window}. - -## BXNUI2033E - **Message**: The {1} resource wasn't modified. While Cloud Foundry was being contacted to modify the resource, an error occurred. Cloud Foundry message: "{0}." - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2034E - **Message**: The {1} resource wasn't retrieved. While Cloud Foundry was being contacted to retrieve the resource, an error occurred. Cloud Foundry message: "{0}." - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2035E - **Message**: The {1} resource wasn't deleted. While Cloud Foundry was being contacted to delete the resource, an error occurred. Cloud Foundry message: "{0}." - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2036E -**Message**: To modify starters, you must have additional permissions. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2037E -**Message**: The starter metadata of ID "{0}" at URL "{1}" could not be read. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2038E -**Message**: The registration of the starter ID, "{0}", failed for the URL, "{1}". - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2039E -**Message**: The starter ID, "{0}", wasn't copied because the Git repository that associated with the boilerplate template isn't accessible. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2040E -**Message**: The metadata for the starter ID, "{0}", could not be registered. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2041E -**Message**: The starter registry metadata could not be read. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2042E -**Message**: An archive of the "{0}" starter could not be created. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2043E -**Message**: The template metadata URL, {0}, is invalid. Error: "{1}". - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2044E -**Message**: The starter metadata URL {0} is invalid because the host name is invalid. - -The host name must include only alphanumeric and dash characters. - -Try again. - -## BXNUI2045E -**Message**: The "{0}" service doesn't exist. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2046E -**Message**: The service categories could not be read. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2047E -**Message**: The "{0}" service already exists. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2048E -**Message**: The action failed because the service label and provider cannot be updated. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2049E -**Message**: Instances of the "{0}" service already exist. - -Delete the instances, and then try again. - -## BXNUI2050E -**Message**: The "{0}" organization doesn't exist. - -Make sure that the organization is specified correctly. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2051E -**Message**: While the service was being created, an icon could not be created. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2052E -**Message**: The login attempt failed. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2053E -**Message**: The login attempt failed because the access token request could not be encoded. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2054E -**Message**: Bluemix requires authorization with scope {0}. - -Try logging in again and providing the requested authorization. - -## BXNUI2055E -**Message**: The attempt to connect to Cloud Foundry failed because of the following exception: "{0}." - -If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2056E -**Message**: Your user information could not be retrieved. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2057E -**Message**: JSON cannot be pretty-printed. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2058E -**Message**: The request is unauthorized because it does not have the required scope, {0}. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2059E -**Message**: A service cannot be published with "ibm_created" or "3rd_party" tags. These tags can be set only by an administrator. - -## BXNUI2060E -**Message**: The usage information could not be processed. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2061E -**Message**: The pricing catalog information cannot be parsed. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2062E -**Message**: The account information could not be processed. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2063E -**Message**: No starter is associated with this app. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2064E -**Message**: The web identity unique ID cannot be retrieved. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2065E -**Message**: The template ID is invalid because it contains HTML. - -The template ID cannot include HTML tags `<` and `>`. - -Remove those tags and try again. - -## BXNUI2066E -**Message**: No JazzHub repository is associated with this app. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2067E -**A service broker with the ID of "{1}" wasn't created or updated because an invalid URL, "{0}", was detected. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2068E -**Message**: A remote URL for the service ID, "{0}", wasn't loaded because a null URL value was detected. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2069E -**Message**: The URL, "{0}", for the service ID, "{2}", wasn't loaded because of an error: "{1}". - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2070E -**Message**: The {0} organization doesn't own {1}. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2071E -**Message**: Only managers can modify certificates. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2072E -**Message**: The certificate wasn't uploaded. - -The domain name, {0}, that is specified in the certificate does not match your custom domain name. - -Correct the domain name in the certificate and try again. - -## BXNUI2073E -**Message**: The private key doesn't match the public certificate. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2074E -**Message**: The private key isn't supported. An unencrypted RSA key is expected. - -## BXNUI2075E -**Message**: The public key isn't supported. Supported algorithms include: RSA. - -## BXNUI2076E -**Message**: The certificate isn't yet valid. It becomes valid at {0}. - -## BXNUI2077E -**Message**: The certificate expired at {0}. - -## BXNUI2078E -**Message**: The intermediate certificate isn't yet valid. It becomes valid at {0}. - -## BXNUI2079E -**Message**: The intermediate certificate expired at {0}. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2080E -**Message**: The operation timed out while certificates and keys were being modified. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2081E -**Message**: The certificates and keys weren't modified because an unknown error occurred: {0}. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2082E -**Message**: The contents of the uploaded certificate wasn't read because a problem occurred: {0}. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2083E -**Message**: The request to an extension of Business Support Systems could not be completed. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2084E -**Message**: The list of countries that support payment could not be retrieved. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2085E -**Message**: The pricing cost calculation cannot be parsed. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2086E -**Message**: During an attempt to retrieve uploaded certificates, the organization could not be found. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2087E -**Message**: The app name is too long. This app name is limited to {0} characters. - -Try again with a shorter name. - -## BXNUI2088E -**Message**: The action that you requested wasn't completed because the CSRF token is missing or invalid. - -Log out, log back in, and try again. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2089E -**Message**: During an attempt to register a template at the URL "{0}", an error occurred. Error: "{1}". - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2090E -**Message**: The attempt to register a template at the following URL failed: "{0}". The template's contents are malformed. Error: "{1}" - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2091E -**Message**: The attempt to connect to the service broker URL, "{0}", failed because of an error: "{1}". - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2092E -**Message**: An attempt to obtain the service broker catalog at the URL,"{0}", returned null. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2093E -**Message**: The number of intermediate certificates exceeds the number allowed. - -For details about the number of allowed certificates and how to delete or replace them, see this [topic](https://www.{DomainName}/docs/manageapps/securingapps.html#ssl_certificate){: new_window}. - -## BXNUI2094E -**Message**: The attempted operation failed because of a connection error. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - - - - - - -## BXNUI2099E -**Message**: Bluemix service billing issued an unexpected exception with this message: "{0}"" - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2100E -**Message**: JazzHub issued an unexpected exception with this message: "{0}" - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2101E -**Message**: IBM DataPower issued an unexpected exception with this message: "{0}" - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2102E -**Message**: Bluemix service billing message: "{0}" - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2103E -**Message**: JazzHub message: "{0}" - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2104E -**Message**: IBM DataPower message: "{0}" - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2105E -**Message**: The attempt to connect to Cloud Foundry failed. - -If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - - - - - -## BXNUI2108E -**Message**: The contents of the uploaded certificate weren't read because a problem occurred: {0}. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2109E -**Message**: The service broker wasn't created or updated because your user ID ("{0}") is not assigned the org manager role in the org. - -You must be an org manager in organization "{1}", as specified for owningOrganization in the JSON input file, to create or update this service broker. - -Verify that you entered the correct owning organization or request that role from the account owner or an org manager. - -## BXNUI2111E - -**Message**: The client certificate is not yet valid. It becomes valid at {0}. - -## BXNUI2112E - -**Message**: The client certificate expired at {0}. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI2113E - -**Message**: The user platform preferences could not be processed. - -Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3000E -**Message**: The operation to start the container instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3001E -**Message**: The operation to stop the container instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3002E -**Message**: The operation to restart the container instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3003E -**Message**: The operation to pause the container instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3004E -**Message**: The operation to unpause the container instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3005E -**Message**: The operation to delete the container instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3006E -**Message**: The operation to start the container instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3007E -**Message**: The operation to stop the container instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3008E -**Message**: The operation to restart the container instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3009E -**Message**: The operation to pause the container instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3010E -**Message**: The operation to unpause the container instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3011E -**Message**: The operation to delete the container instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3012E -**Message**: An error occurred while restarting the container. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3013E -**Message**: An error occurred while pausing the container. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3014E -**Message**: An error occurred while unpausing the container. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3015E -**Message**: An authentication problem occurred. - -Log out, log back in, and try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3016E -**Message**: The container does not exist. It might have been deleted. - -Check and try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3017E -**Message**: A problem occurred while contacting IBM Containers. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3018E -**Message**: An error occurred when stopping the container, and it is now in a conflict state. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}." - -## BXNUI3050E -**Message**: The operation to start the virtual server instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3051E -**Message**: The operation to stop the virtual server instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3052E -**Message**: The operation to resume the virtual server instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3053E -**Message**: The operation to suspend the virtual server instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3054E -**Message**: The operation to reboot the virtual server instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3055E -**Message**: The operation to delete the virtual server instance timed out. - -Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3056E -**Message**: The operation to start the virtual server instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3057E -**Message**: The operation to stop the virtual server instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3058E -**Message**: The operation to resume the virtual server instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3059E -**Message**: The operation to suspend the virtual server instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3060E -**Message**: The operation to reboot the virtual server instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3061E -**Message**: The operation to delete the virtual server instance encountered a connection error. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3062E -**Message**: An authentication problem occurred. - -Log out, log back in, and try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3063E -**Message**: The virtual server does not exist. - -It might have been deleted. - -Check and try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3064E -**Message**: An error occurred and the virtual server instance is now in a conflict state. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. - -## BXNUI3065E -**Message**: A problem occurred while contacting IBM Virtual Servers. - -Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}." +--- + + + +copyright: + + years: 2015, 2016 + +lastupdated: "2016-11-21" + +--- + +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# {{site.data.keyword.Bluemix_notm}} error messages + + +When you receive an error message from {{site.data.keyword.Bluemix}}, you can use the message ID to find more information about how to resolve the problem. +{:shortdesc} + +## BXNUI0001E +**Message**: The page wasn't loaded because Bluemix didn't detect whether a session exists. + +For instructions to fix this problem, see this [troubleshooting topic](https://www.{DomainName}/docs/troubleshoot/accessing.html#tr_err){: new_window}. + + + +## BXNUI0004E +**Message**: The '{0}' app wasn't deleted because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0005E +**Message**: The '{0}' app wasn't created because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0006E +**Message**: The '{0}' app didn't stop because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + + + +## BXNUI0008E +**Message**: The '{0}' app details weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0009E +**Message**: The application starters weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0010E +**Message**: The '{0}' starter for the '{1}' app wasn't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0011E +**Message**: The '{0}' starter wasn't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0013E +**Message**: The '{0}' service instance wasn't created because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0014E +**Message**: The settings for the '{0}' service weren't updated because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0015E +**Message**: Service offerings weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0016E +**Message**: The apps and services weren't retrieved because a Bluemix page didn't load. + +For instructions to fix this problem, see this [troubleshooting topic](https://www.{DomainName}/docs/troubleshoot/accessing.html#tr_err){: new_window}. + +## BXNUI0017E +**Message**: The service instance wasn't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0018E +**Message**: The instances for the '{0}' app weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0019E +**Message**: The instances for your app weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0020E +**Message**: The settings for the '{0}' app weren't updated because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0021E +**Message**: The environment variables for the '{0}' app weren't updated because a problem occurred contacting Cloud Foundry. +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0022E +**Message**: The routes for the '{0}' app weren't updated because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0023E +**Message**: The settings for the '{0}' service instance weren't updated because a problem occurred contacting Cloud Foundry. +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0024E +**Message**: The quick start for the '{0}' app wasn't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0025E +**Message**: The quick start for the '{0}' service wasn't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0026E +**Message**: The '{0}' space wasn't created because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0027E +**Message**: The '{0}' space wasn't deleted because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0028E +**Message**: The '{0}' organization wasn't created because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0029E +**Message**: The '{0}' organization wasn't deleted because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0030E +**Message**: The '{0}' route wasn't mapped to the '{1}' app because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0031E +**Message**: The '{0}' route wasn't unmapped from the '{1}' app because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0032E +**Message**: Information for the '{0}' organization or space wasn't saved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0033E +**Message**: The '{0}' service wasn't added to the '{1}' app because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0034E +**Message**: The '{0}' service wasn't removed from the '{1}' app because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0035E +**Message**: The '{0}' service instance wasn't deleted because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0036E +**Message**: The service bindings for the '{0}' app or service weren't deleted because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0037E +**Message**: The service instances that were bound to the '{0}' app weren't deleted because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0038E +**Message**: The routes that are associated with the '{0}' app weren't deleted because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0039E +**Message**: The route associations for the '{0}' domain must be deleted. + +On the app's Overview page, click **Routes and domains** drop-down, and select **Edit routes**. + +## BXNUI0040E +**Message**: Service bindings weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + + + + + +## BXNUI0044E +**Message**: Information wasn't retrieved from the server because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0045E +**Message**: Files or logs for the '{0}' application weren't retrieved by using the '{1}' instance because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0046E +**Message**: Your organizations weren't retrieved because of a problem contacting Cloud Foundry. + +You will be logged out of Bluemix. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0048E +**Message**: Spaces for the '{0}' organization weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0049E +**Message**: The organization's domains weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0050E +**Message**: The organization's summary wasn't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0052E +**Message**: The users for the '{0}' organization weren't updated because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0053E +**Message**: The users for the '{0}' space weren't updated because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0054E +**Message**: The user, '{0}', wasn't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0055E +**Message**: The users for the parent organization of the '{0}' space weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0056E +**Message**: The users for the '{0}' organization weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0057E +**Message**: The users for the '{0}' space weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0058E +**Message**: A domain wasn't created because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0059E +**Message**: A domain wasn't deleted because a problem occurred contacting IBM DataPower Gateway. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0060E +**Message**: A certificate for the '{0}' domain wasn't uploaded because a problem occurred contacting IBM DataPower Gateway. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0061E +**Message**: The user, '{0}', wasn't added to the account because a problem occurred contacting the business support system. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0062E +**Message**: Your session expired, and you must log in again. + +## BXNUI0063E +**Message**: The operation timed out. + +Try again later. + +## BXNUI0064E +**Message**: The browser that you are using is not supported by IBM Bluemix. + +The following browsers are supported. Ensure that you use the latest version for your operating system. +* Google Chrome +* Mozilla Firefox +* Internet Explorer +* Safari + +For details, see the [Bluemix Prerequisites page](https://developer.ibm.com/bluemix/support/#prereqs). + + +## BXNUI0065E +**Message**: The VCAP_SERVICES environment variable for '{0}' wasn't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0066E +**Message**: The runtime can't be deleted because when the runtime was added, a buildpack value was explicitly set for the application by using the `-b` option on the `cf` push command. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0067E +**Message**: The data for the plans wasn't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + + + +## BXNUI0070E +**Message**: The certificate for the '{0}' domain wasn't retrieved because a problem occurred contacting IBM DataPower Gateway. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0071E +**Message**: The certificate for the '{0}' domain wasn't deleted because a problem occurred contacting IBM DataPower Gateway. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0072E +**Message**: The certificate for the '{0}' domain wasn't replaced because a problem occurred contacting IBM DataPower Gateway. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0073E +**Message**: Information about the uploaded certificates could not be retrieved. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0076E +**Message**: The '{0}' service is already connected to all apps in the '{1}' space. + +To use a different plan for this service, you must delete the service and connect it again. + +## BXNUI0077E +**Message**: The '{0}' service already exists in the '{1}' space. + +Choose another space, if needed. + +## BXNUI0078E +**Message**: The '{1}' app already uses the '{0}' service. + +Select a different service. + +## BXNUI0079E +**Message**: The '{1}' app already uses the '{2}' service. The '{0}' service and the '{2}' service cannot be used together. + +Select a different service. + +## BXNUI0080E +**Message**: Before you can add the '{0}' service to the '{1}' app, the app must use the prerequisite service, '{2}'. + +Add the prerequisite service first, and then try again. + +## BXNUI0081E +**Message**: You uploaded {0} certificates, which is the maximum number that your organization can use. + +Either delete a certificate or upgrade your account. + +## BXNUI0082E +**Message**: Bluemix can't load your notification preferences at the moment. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0083E +**Message**: Your notification preferences could not be saved. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0085E +**Message**: The usage data for containers wasn't retrieved. + +The container might be temporarily out of service. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0086E +**Message**: The '{0}' container didn't start. + +The container might be temporarily out of service. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0087E +**Message**: The '{0}' container didn't stop. + +The container might be temporarily out of service. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0088E +**Message**: The '{0}' container didn't restart. + +The container might be temporarily out of service. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0089E +**Message**: The '{0}' container can't be paused. + +The container might be temporarily out of service. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0090E +**Message**: The '{0}' container can't be unpaused. + +The container might be temporarily out of service. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0091E +**Message**: The '{0}' container wasn't deleted. + +The container might be temporarily out of service. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0092E +**Message**: The '{0}' VM group wasn't deleted because of a problem connecting to the VM resources. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0093E +**Message**: The '{0}' container group wasn't deleted. + +The container group might be temporarily out of service. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0094E +**Message**: The registry name could not be set. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0095E +**Message**: The private registry name is already being used. + +Use a different name and try again. + +## BXNUI0096E +**Message**: The app wasn't created. + +Your account is inactive because it was canceled or suspended. + +For instructions to fix this problem, see this [troubleshooting topic](https://www.{DomainName}/docs/troubleshoot/managingaccounts.html#ts_accnt_inactive){: new_window}. + +## BXNUI0097E +**Message**: Before you can add an app, at least one space must be associated with your organization and region. + +On the Dashboard, click **Create a Space**. When the space is created, try again. For more instructions to fix this problem, see this [troubleshooting topic](https://www.{DomainName}/docs/troubleshoot/managingaccounts.html#ts_no_space){: new_window}. + +## BXNUI0098E +**Message**: The list of credentials can't be retrieved at the moment. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0099E + +**Message**: The '{0}' credential wasn't added. + +Try using a different name, or try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0100E + +**Message**: The '{0}' credential wasn't deleted. + +The credential might have already been deleted. + +Return to the Dashboard and try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0101E + +**Message**: Your current browser settings prevent pop-up windows. + +Change your browser settings to allow pop-up windows. + +## BXNUI0111E +**Message**: The login server can't be contacted at the moment. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0112E +**Message**: The plan could not be updated. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0113E +**Message**: The {0} service instance wasn't deleted because its credentials weren't deleted. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + + + + + +## BXNUI0118E + +**Message**: {0}'s access to {1} could not be revoked. + +Try to revoke access again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0119E + +**Message**: The '{0}' VM didn't start because of a problem connecting to the VM resources. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0120E + +**Message**: The '{0}' VM didn't stop because of a problem connecting to the VM resources. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0121E + +**Message**: The '{0}' VM didn't reboot because of a problem connecting to the VM resources. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0122E + +**Message**: The '{0}' VM wasn't suspended because of a problem connecting to the VM resources. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0123E + +**Message**: The '{0}' VM wasn't resumed because of a problem connecting to the VM resources. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0124E + +**Message**: The '{0}' VM wasn't deleted because of a problem connecting to the VM resources. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0125E + +**Message**: You will be logged out because you are not a member of an active account. + +Your Bluemix account might have expired or been cancelled, or you might have been removed from your org. +Contact your org manager. Or, for help and support options, see the Troubleshooting section of the Bluemix Docs. + +## BXNUI0126E + +**Message**: The {0} container group is still in the process of being deleted. + +Refresh the page later to verify that the container group is deleted. + +## BXNUI0127E + +**Message**: The {0} container is still in the process of being deleted. + +Refresh the page later to verify that the container is deleted. + +## BXNUI0128E + +**Message**: Your organizations weren't retrieved because of a problem contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0129E +**Message**: The account information wasn't retrieved because of a problem contacting the business support system. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0130E +**Message**: The account information wasn't retrieved because of a problem contacting the business support system. + +You will be logged out of Bluemix. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0131E +**Message**: Your email address wasn't registered because an error occurred during the registration process. + +To resolve this problem, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0132E +**Message**: The __name__ information was not retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0133E + +**Message**: Service bindings weren't retrieved because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0200E +**Message**: The routes for the app weren't retrieved because of an internal error. + +Try again later. If the problem continues, go to IBM Bluemix Support. + +## BXNUI0201E +**Message**: The routes for the space weren't retrieved because of an internal error. + +Try again later. If the problem continues, go to IBM Bluemix Support. + +## BXNUI0202E +**Message**: The domains for the org weren't retrieved because of an internal error. + +Try again later. If the problem continues, go to IBM Bluemix Support. + +## BXNUI0203E +**Message**: The routes for the app weren't retrieved because of an internal error. + +Try again later. If the problem continues, go to IBM Bluemix Support. + +## BXNUI0300E +**Message**: The usage information could not be retrieved. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0301E +**Message**: While the usage information was being retrieved, the organizations could not be retrieved. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0305E +**Message**: The usage information could not be displayed. + +If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0306E +**Message**: Third-party services information could not be retrieved. + +If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0307E +**Message**: Promotional codes can't be applied at this time. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0400E +**Message**: The list of countries could not be displayed. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0402E +**Message**: Your account can't be canceled at this time. + +Try again later or go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0500E +**Message**: Your request to reserve a dedicated instance wasn't submitted due to an error. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0501E +**Message**: That container name is already in use. + +Enter a different name. + +## BXNUI0502E +**Message**: The container wasn't created. + +Either your user role does not have the required authority in this space, or you are not a member of the space. + +If you are a member of the space, you must have the developer user role to create container instances. You can request that role from your org manager. If you are not a member of this space, you can request to be added to it. + +## BXNUI0503E +**Message**: The container wasn't created because of an internal error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0504E +**Message**: The container was created, but the IP address was not assigned to it because that IP address isn't available. + +Select a different IP address or select to request and bind public IP address. + +## BXNUI0505E +**Message**: The container was created, but it wasn't assigned an IP address because no IP addresses are available. + +You can adjust the quota on the Quota tab for your organization. + +## BXNUI0506E +**Message**: The container wasn't created because the VCAP_SERVICES environment variable details were not retrieved. + +Bind a service to your selected app or select a different app. + +## BXNUI0507E +**Message**: That container group name is already in use. + +Enter a different name. + +## BXNUI0508E +**Message**: The container group wasn't created because your user role does not have the required authority in this space. + +To create container groups, you must have the developer role. Request that role from your org manager. + +## BXNUI0509E +**Message**: The container group wasn't created because of an internal error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0510E +**Message**: The container wasn't created because some resources, such as an IP address or memory, are not available. + +To adjust the quotas, go to **Manage Organizations**, click the **Quota** tab for your org, and click **Containers**. Then, try to select the image again. + +## BXNUI0511E + +**Message**: The container group wasn't created because some resources, such as an IP address or memory, are not available. + +To adjust the quotas, go to **Manage Organizations**, click the **Quota** tab for your org, and click **Containers**. Then, try to create the container group again. + +## BXNUI0512E + +**Message**: While attempting to create a container from the image, an internal error occurred. Some resources, such as an IP address or memory, were not available when the namespace was being retrieved. + +To adjust the quotas, go to **Manage Organizations**, click the **Quota** tab for your org, and click **Containers**. Then, try to select the image again. + +## BXNUI0513E + +**Message**: The containers weren't retrieved because a problem occurred contacting IBM Containers. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0514E + +**Message**: You are not a developer for any of the spaces in the '__orgName__' organization. + +Try to select another org or create a space, or request the developer role from your org manager. + +## BXNUI0515E + +**Message**: The spaces in the org weren't retrieved because of a network connection problem. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0516E + +**Message**: The container namespace of the org wasn't retrieved because of an internal error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0517E + +**Message**: The container namespace of the org wasn't retrieved because of an internal error with incident ID __incidentID__. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0518E + +**Message**: The container wasn't created because of an internal error with incident ID __incidentID__. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0519E + +**Message**:The container group wasn't created because of an internal error with incident ID __incidentID__. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0521E + +**Message**: While attempting to create a container from the image, an internal error with incident ID __incidentID__ occurred. Some resources, such as an IP address or memory, were not available when the namespace was being retrieved. + +To adjust the quotas, go to **Manage Organizations**, click the **Quota** tab for your org, and click **Containers**. Then, try to select the image again. + +## BXNUI0522E + +**Message**: You can't create the resource because you are not a developer for the __spaceName__ in the __orgName__ organization. + +Try to select another space or org or create a space, or request the developer role from your org manager. + +## BXNUI0523E + +**Message**: The infrastructure resources weren't retrieved because a problem occurred contacting SoftLayer. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0524E + +**Message**: The attempt to register the container namespace failed because a problem occurred connecting to the container API. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0525E + +**Message**: The attempt to create a registry failed because you do not have authority to the registry namespace for org __orgName__. The developer user role is required to create a registry. + +Request a different role from your org manager. + +## BXNUI0526E + +**Message**: The attempt to retrieve the container image failed because a problem occurred contacting IBM Containers. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0600E + +**Message**: The route '{0}' is already assigned. + +Try a different route. + +## BXNUI0602E + +**Message**: Failed to add the {0} service to your application because a problem occurred contacting Cloud Foundry. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0700E + +**Message**: The ‘{0}’ space wasn't created because a problem occurred contacting Cloud Foundry. + +Click **Create** to try again or cancel the action. + +## BXNUI0701E + +**Message**: Failed to invite users. Error Code: __errorCode__. + +Try again later. If you see this message again, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0702E + +**Message**: Failed to invite __emailAddress__. Error Code: __errorCode__. + +Try again later. If you see this message again, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI0703E + +**Message**: The details for this invited user are currently unavailable. + +Try again later. + +## BXNUI0704E + +**Message**: The details for this invited user could not be loaded from the following region or regions: __regions__. + +Try again later. + +## BXNUI2000E +**Message**: The request was not processed because of an error. This exception was issued: {0} + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2001E +**Message**: No Ant `build.xml` file exists for the "{0}" starter. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2002E +**Message**:No builder exists for the "{0}" starter. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + + + +## BXNUI2004E +**Message**: The app was not created because of an error from the cloud server. + +Try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + + + + + + + +## BXNUI2008E +**Message**: The app was not created because a .zip file could not be created for the {0} app that uses the {1} starter. + +Try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2009E +**Message**: The configuration wasn't loaded because of an error. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2010E +**Message**: The configuration could not be loaded. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2011E +**Message**: The configuration can't be saved because it comes from multiple sources. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2012E +**Message**: The configuration can't be saved because it is read-only. + +## BXNUI2013E +**Message**: A class wasn't created from the "{0}" configuration because of an error. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2014E +**Message**: The class name is not in the "{0}" configuration. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2015E +**Message**: The attempt to log in failed because the cloud controller URL is formatted incorrectly. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2016E +**Message**: The resource metadata could not be loaded. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2017E +**Message**: The resource metadata could not be saved. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2018E +**Message**: The metadata for the "{1}" starter didn't have the required "{0}" property. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2019E +**Message**: The template metadata specified an unknown source control management type of "{0}". + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2020E +**Message**: The "{0}" resource doesn't exist. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2021E +**Message**: The "{0}" starter directory doesn't exist. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2022E +**Message**: The starters could not be copied. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2023E +**Message**: The `VCAP_SERVICES` environment variable isn't defined. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2024E +**Message**: Self registration for users isn't enabled. + +Contact the account owner. + +## BXNUI2025E +**Message**: During an attempt to build an entity tag for web caching, an error occurred. IBM Bluemix could not determine whether an icon was cached. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2026E +**Message**: Another user already uses that name. + +Try again with a different user name. + +## BXNUI2027E +**Message**: No user is logged in. + +Log in and try again. + +## BXNUI2028E +**Message**: Cloud Foundry issued an unexpected exception with this message: "{0}" + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2029E +**Message**: The cloud information could not be retrieved. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2030E +**Message**: Cloud Foundry message: "{0}" + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2031E +**Message**: The Bluemix datastore component isn't available. + +Contact the system administrator for assistance in fixing the datastore component. + +## BXNUI2032E +**Message**: The {1} resource wasn't created. + +While Cloud Foundry was being contacted to create the resource, an error occurred. Cloud Foundry message: "{0}." + +For instructions to fix this problem, see this [troubleshooting topic](https://www.{DomainName}/docs/troubleshoot/managingapps.html#tr_servicelimit){: new_window}. + +## BXNUI2033E + **Message**: The {1} resource wasn't modified. While Cloud Foundry was being contacted to modify the resource, an error occurred. Cloud Foundry message: "{0}." + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2034E + **Message**: The {1} resource wasn't retrieved. While Cloud Foundry was being contacted to retrieve the resource, an error occurred. Cloud Foundry message: "{0}." + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2035E + **Message**: The {1} resource wasn't deleted. While Cloud Foundry was being contacted to delete the resource, an error occurred. Cloud Foundry message: "{0}." + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2036E +**Message**: To modify starters, you must have additional permissions. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2037E +**Message**: The starter metadata of ID "{0}" at URL "{1}" could not be read. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2038E +**Message**: The registration of the starter ID, "{0}", failed for the URL, "{1}". + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2039E +**Message**: The starter ID, "{0}", wasn't copied because the Git repository that associated with the boilerplate template isn't accessible. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2040E +**Message**: The metadata for the starter ID, "{0}", could not be registered. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2041E +**Message**: The starter registry metadata could not be read. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2042E +**Message**: An archive of the "{0}" starter could not be created. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2043E +**Message**: The template metadata URL, {0}, is invalid. Error: "{1}". + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2044E +**Message**: The starter metadata URL {0} is invalid because the host name is invalid. + +The host name must include only alphanumeric and dash characters. + +Try again. + +## BXNUI2045E +**Message**: The "{0}" service doesn't exist. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2046E +**Message**: The service categories could not be read. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2047E +**Message**: The "{0}" service already exists. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2048E +**Message**: The action failed because the service label and provider cannot be updated. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2049E +**Message**: Instances of the "{0}" service already exist. + +Delete the instances, and then try again. + +## BXNUI2050E +**Message**: The "{0}" organization doesn't exist. + +Make sure that the organization is specified correctly. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2051E +**Message**: While the service was being created, an icon could not be created. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2052E +**Message**: The login attempt failed. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2053E +**Message**: The login attempt failed because the access token request could not be encoded. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2054E +**Message**: Bluemix requires authorization with scope {0}. + +Try logging in again and providing the requested authorization. + +## BXNUI2055E +**Message**: The attempt to connect to Cloud Foundry failed because of the following exception: "{0}." + +If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2056E +**Message**: Your user information could not be retrieved. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2057E +**Message**: JSON cannot be pretty-printed. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2058E +**Message**: The request is unauthorized because it does not have the required scope, {0}. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2059E +**Message**: A service cannot be published with "ibm_created" or "3rd_party" tags. These tags can be set only by an administrator. + +## BXNUI2060E +**Message**: The usage information could not be processed. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2061E +**Message**: The pricing catalog information cannot be parsed. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2062E +**Message**: The account information could not be processed. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2063E +**Message**: No starter is associated with this app. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2064E +**Message**: The web identity unique ID cannot be retrieved. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2065E +**Message**: The template ID is invalid because it contains HTML. + +The template ID cannot include HTML tags `<` and `>`. + +Remove those tags and try again. + +## BXNUI2066E +**Message**: No JazzHub repository is associated with this app. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2067E +**A service broker with the ID of "{1}" wasn't created or updated because an invalid URL, "{0}", was detected. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2068E +**Message**: A remote URL for the service ID, "{0}", wasn't loaded because a null URL value was detected. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2069E +**Message**: The URL, "{0}", for the service ID, "{2}", wasn't loaded because of an error: "{1}". + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2070E +**Message**: The {0} organization doesn't own {1}. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2071E +**Message**: Only managers can modify certificates. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2072E +**Message**: The certificate wasn't uploaded. + +The domain name, {0}, that is specified in the certificate does not match your custom domain name. + +Correct the domain name in the certificate and try again. + +## BXNUI2073E +**Message**: The private key doesn't match the public certificate. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2074E +**Message**: The private key isn't supported. An unencrypted RSA key is expected. + +## BXNUI2075E +**Message**: The public key isn't supported. Supported algorithms include: RSA. + +## BXNUI2076E +**Message**: The certificate isn't yet valid. It becomes valid at {0}. + +## BXNUI2077E +**Message**: The certificate expired at {0}. + +## BXNUI2078E +**Message**: The intermediate certificate isn't yet valid. It becomes valid at {0}. + +## BXNUI2079E +**Message**: The intermediate certificate expired at {0}. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2080E +**Message**: The operation timed out while certificates and keys were being modified. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2081E +**Message**: The certificates and keys weren't modified because an unknown error occurred: {0}. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2082E +**Message**: The contents of the uploaded certificate wasn't read because a problem occurred: {0}. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2083E +**Message**: The request to an extension of Business Support Systems could not be completed. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2084E +**Message**: The list of countries that support payment could not be retrieved. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2085E +**Message**: The pricing cost calculation cannot be parsed. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2086E +**Message**: During an attempt to retrieve uploaded certificates, the organization could not be found. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2087E +**Message**: The app name is too long. This app name is limited to {0} characters. + +Try again with a shorter name. + +## BXNUI2088E +**Message**: The action that you requested wasn't completed because the CSRF token is missing or invalid. + +Log out, log back in, and try again. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2089E +**Message**: During an attempt to register a template at the URL "{0}", an error occurred. Error: "{1}". + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2090E +**Message**: The attempt to register a template at the following URL failed: "{0}". The template's contents are malformed. Error: "{1}" + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2091E +**Message**: The attempt to connect to the service broker URL, "{0}", failed because of an error: "{1}". + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2092E +**Message**: An attempt to obtain the service broker catalog at the URL,"{0}", returned null. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2093E +**Message**: The number of intermediate certificates exceeds the number allowed. + +For details about the number of allowed certificates and how to delete or replace them, see this [topic](https://www.{DomainName}/docs/manageapps/securingapps.html#ssl_certificate){: new_window}. + +## BXNUI2094E +**Message**: The attempted operation failed because of a connection error. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + + + + + + +## BXNUI2099E +**Message**: Bluemix service billing issued an unexpected exception with this message: "{0}"" + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2100E +**Message**: JazzHub issued an unexpected exception with this message: "{0}" + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2101E +**Message**: IBM DataPower issued an unexpected exception with this message: "{0}" + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2102E +**Message**: Bluemix service billing message: "{0}" + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2103E +**Message**: JazzHub message: "{0}" + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2104E +**Message**: IBM DataPower message: "{0}" + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2105E +**Message**: The attempt to connect to Cloud Foundry failed. + +If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + + + + + +## BXNUI2108E +**Message**: The contents of the uploaded certificate weren't read because a problem occurred: {0}. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2109E +**Message**: The service broker wasn't created or updated because your user ID ("{0}") is not assigned the org manager role in the org. + +You must be an org manager in organization "{1}", as specified for owningOrganization in the JSON input file, to create or update this service broker. + +Verify that you entered the correct owning organization or request that role from the account owner or an org manager. + +## BXNUI2111E + +**Message**: The client certificate is not yet valid. It becomes valid at {0}. + +## BXNUI2112E + +**Message**: The client certificate expired at {0}. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI2113E + +**Message**: The user platform preferences could not be processed. + +Go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3000E +**Message**: The operation to start the container instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3001E +**Message**: The operation to stop the container instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3002E +**Message**: The operation to restart the container instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3003E +**Message**: The operation to pause the container instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3004E +**Message**: The operation to unpause the container instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3005E +**Message**: The operation to delete the container instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3006E +**Message**: The operation to start the container instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3007E +**Message**: The operation to stop the container instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3008E +**Message**: The operation to restart the container instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3009E +**Message**: The operation to pause the container instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3010E +**Message**: The operation to unpause the container instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3011E +**Message**: The operation to delete the container instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3012E +**Message**: An error occurred while restarting the container. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3013E +**Message**: An error occurred while pausing the container. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3014E +**Message**: An error occurred while unpausing the container. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3015E +**Message**: An authentication problem occurred. + +Log out, log back in, and try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3016E +**Message**: The container does not exist. It might have been deleted. + +Check and try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3017E +**Message**: A problem occurred while contacting IBM Containers. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3018E +**Message**: An error occurred when stopping the container, and it is now in a conflict state. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}." + +## BXNUI3050E +**Message**: The operation to start the virtual server instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3051E +**Message**: The operation to stop the virtual server instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3052E +**Message**: The operation to resume the virtual server instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3053E +**Message**: The operation to suspend the virtual server instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3054E +**Message**: The operation to reboot the virtual server instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3055E +**Message**: The operation to delete the virtual server instance timed out. + +Try again later. If you see this message again, go to the [Bluemix status page](https://developer.ibm.com/bluemix/support/#status){: new_window} to check whether a service or component has an issue. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3056E +**Message**: The operation to start the virtual server instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3057E +**Message**: The operation to stop the virtual server instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3058E +**Message**: The operation to resume the virtual server instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3059E +**Message**: The operation to suspend the virtual server instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3060E +**Message**: The operation to reboot the virtual server instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3061E +**Message**: The operation to delete the virtual server instance encountered a connection error. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3062E +**Message**: An authentication problem occurred. + +Log out, log back in, and try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3063E +**Message**: The virtual server does not exist. + +It might have been deleted. + +Check and try again. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3064E +**Message**: An error occurred and the virtual server instance is now in a conflict state. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}. + +## BXNUI3065E +**Message**: A problem occurred while contacting IBM Virtual Servers. + +Try again later. If the problem continues, go to [IBM Bluemix Support](http://ibm.biz/bluemixsupport){: new_window}." diff --git a/troubleshoot/nl/it/err_messages.md b/troubleshoot/nl/it/err_messages.md index 74ce1cb87..97d1a1a4a 100644 --- a/troubleshoot/nl/it/err_messages.md +++ b/troubleshoot/nl/it/err_messages.md @@ -1,18 +1,18 @@ ---- - -copyright: - year: 2015, 2015 - -lastupdated: "2015-12-09" - - ---- - - -# Messaggi di errore -{: #error-messages} - - -Quando ricevi un messaggio di errore da {{site.data.keyword.IBM}}, -puoi utilizzare l'ID messaggio per trovare ulteriori informazioni su come risolvere -il problema. +--- + +copyright: + year: 2015, 2015 + +lastupdated: "2015-12-09" + + +--- + + +# Messaggi di errore +{: #error-messages} + + +Quando ricevi un messaggio di errore da {{site.data.keyword.IBM}}, +puoi utilizzare l'ID messaggio per trovare ulteriori informazioni su come risolvere +il problema. diff --git a/troubleshoot/nl/it/general.md b/troubleshoot/nl/it/general.md index ca21cce4d..2bdfae782 100644 --- a/troubleshoot/nl/it/general.md +++ b/troubleshoot/nl/it/general.md @@ -1,52 +1,52 @@ ---- - -copyright: - year: 2015, 2015 - -lastupdated: "2016-08-12" - - ---- - - -{:tsSymptoms: .tsSymptoms} -{:tsCauses: .tsCauses} -{:tsResolve: .tsResolve} -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - - -# Problemi dei servizi generali -{: #general} - - -I problemi relativi ai servizi {{site.data.keyword.Bluemix}} -potrebbero includere un errore di timeout del gateway che si verifica quando elimini -un'istanza del servizio. Tuttavia, in molti casi, puoi eseguire un ripristino da tali problemi seguendo pochi semplici passi. -{:shortdesc} - -## Si verifica un errore del broker di servizi quando elimini un'istanza del servizio -{: #ts_service_broker} - -Quando tenti di eliminare un'istanza del servizio che è già stata eliminata dal controller cloud, -potresti ricevere un messaggio di errore. -{:shortdesc} - - -Quando tenti di eliminare un'istanza del servizio, visualizzi -il messaggio di errore del broker dei servizi, `Timeout gateway`. -{: tsSymptoms} - - -Questo problema si verifica se - l'istanza del servizio è già stata eliminata -dal controller cloud. -{: tsCauses} - - -Per - risolvere questo problema, crea un'istanza del servizio con lo stesso -nome servizio, quindi eseguine il bind alle tue applicazioni. Dopo di che, -puoi eliminare l'istanza del servizio e le applicazioni che utilizzano -il servizio. -{: tsResolve} +--- + +copyright: + year: 2015, 2015 + +lastupdated: "2016-08-12" + + +--- + + +{:tsSymptoms: .tsSymptoms} +{:tsCauses: .tsCauses} +{:tsResolve: .tsResolve} +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + + +# Problemi dei servizi generali +{: #general} + + +I problemi relativi ai servizi {{site.data.keyword.Bluemix}} +potrebbero includere un errore di timeout del gateway che si verifica quando elimini +un'istanza del servizio. Tuttavia, in molti casi, puoi eseguire un ripristino da tali problemi seguendo pochi semplici passi. +{:shortdesc} + +## Si verifica un errore del broker di servizi quando elimini un'istanza del servizio +{: #ts_service_broker} + +Quando tenti di eliminare un'istanza del servizio che è già stata eliminata dal controller cloud, +potresti ricevere un messaggio di errore. +{:shortdesc} + + +Quando tenti di eliminare un'istanza del servizio, visualizzi +il messaggio di errore del broker dei servizi, `Timeout gateway`. +{: tsSymptoms} + + +Questo problema si verifica se + l'istanza del servizio è già stata eliminata +dal controller cloud. +{: tsCauses} + + +Per + risolvere questo problema, crea un'istanza del servizio con lo stesso +nome servizio, quindi eseguine il bind alle tue applicazioni. Dopo di che, +puoi eliminare l'istanza del servizio e le applicazioni che utilizzano +il servizio. +{: tsResolve} diff --git a/troubleshoot/nl/it/index.md b/troubleshoot/nl/it/index.md index 2661612c9..f5cfbcceb 100644 --- a/troubleshoot/nl/it/index.md +++ b/troubleshoot/nl/it/index.md @@ -1,1882 +1,1882 @@ ---- - -copyright: - years: 2015, 2017 - -lastupdated: "2017-01-11" - - ---- - -{:tsSymptoms: .tsSymptoms} -{:tsCauses: .tsCauses} -{:tsResolve: .tsResolve} -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} -{:codeblock: .codeblock} - -# Risoluzione dei problemi di accesso a {{site.data.keyword.Bluemix_notm}} -{: #accessing} - - - -I problemi generali con l'accesso a {{site.data.keyword.Bluemix}} potrebbero includere un utente che non riesce ad accedere a {{site.data.keyword.Bluemix_notm}}, un account bloccato in uno stato In sospeso e così via. Tuttavia, in molti casi, puoi eseguire un ripristino da tali problemi seguendo pochi semplici passi. -{:shortdesc} - -## Impossibile accedere a {{site.data.keyword.Bluemix_notm}} -{: #ts_logintobm} - -Per accedere a {{site.data.keyword.Bluemix_notm}}, devi disporre di un ID IBM e password validi. - - -Quando tenti di accedere a {{site.data.keyword.Bluemix_notm}}, visualizzi il seguente messaggio di errore: -{: tsSymptoms} - -`La password immessa non è corretta.` - - -L'ID IBM e password da te utilizzati per accedere a {{site.data.keyword.Bluemix_notm}} non sono validi. -{: tsCauses} - - -Per ottenere un ID IBM e una password validi, vai alla pagina Il mio profilo IBM e completa una della seguenti procedure: -{: tsResolve} - * Se già hai registrato un ID IBM e vuoi controllare se il tuo ID e la tua password sono validi, fai clic su **Accedi** e immetti il tuo ID IBM e la relativa password nella pagina di accesso. Se hai dimenticato la password, fai clic su **Password dimenticata** per reimpostarla. Se hai dimenticato il tuo ID IBM o continui ad avere problemi con la tua password, contatta l'Help Desk Worldwide IBM Registration per ottenere assistenza. - * Se non hai un ID IBM, fai clic su **Registrati** per registrare un ID IBM e password. - -**Nota:** per i dipendenti IBM, l'ID IBM potrebbe essere diverso dall'ID di accesso Intranet. - - - - - -## Sono presenti modifiche non salvate -{: #ts_unsaved_changes} - - -Quando navighi nella pagina dei dettagli dell'applicazione, potresti non riuscire ad eseguire delle azioni ed è possibile che ti venga richiesto di salvare le modifiche prima di continuare. - - -Quanto tenti di controllare la tua applicazione o i tuoi servizi nella pagina dei dettagli dell'applicazione, continui a visualizzare il seguente messaggio di errore: -{: tsSymptoms} - -`Sono presenti modifiche non salvate nella pagina nomeapplicazione. Salva o annulla le modifiche.` - - -Quando passi il mouse sul campo **ISTANZE** o **QUOTA DI MEMORIA** nel riquadro del runtime, i valori cambiano. Questo è il funzionamento previsto; tuttavia, il messaggio di errore di richiede di salvare le impostazioni della memoria o dell'istanza prima di uscire dalla pagina. -{: tsCauses} - - -Chiudi la finestra del messaggio, quindi fai clic sul pulsante **REIMPOSTA** nel riquadro del runtime. -{: tsResolve} - - - - - - -## Il failover automatico tra le regioni {{site.data.keyword.Bluemix_notm}} non è disponibile -{: #ts_failover} - -Non riesci a utilizzare il failover automatico tra le regioni {{site.data.keyword.Bluemix_notm}}. Tuttavia, come soluzione alternativa, puoi utilizzare un provider DNS che supporti il failover tra più indirizzi IP. - - -Quando una regione {{site.data.keyword.Bluemix_notm}} diventa non disponibile, anche le applicazioni in esecuzione in tale regione non saranno più disponibili, anche se le stesse applicazioni sono in esecuzione in un'altra regione {{site.data.keyword.Bluemix_notm}}. -{: tsSymptoms} - - -{{site.data.keyword.Bluemix_notm}} non fornisce ancora il failover automatico da una regione all'altra. -{: tsCauses} - - -Puoi utilizzare un provider DNS che supporti il failover intelligente tra più indirizzi IP e configurare manualmente le tue impostazioni -DNS per abilitare il failover automatico tra le regioni {{site.data.keyword.Bluemix_notm}}. I provider DNS con questa capacità comprendono NSONE, Akamai, Dyn. -{: tsResolve} - -Quando configuri le tue impostazioni DNS, devi specificare gli indirizzi IP pubblici delle regioni {{site.data.keyword.Bluemix_notm}} in cui sono esecuzione le tue applicazioni. Per ottenere l'indirizzo IP pubblico -di una regione {{site.data.keyword.Bluemix_notm}}, -usa il comando `nslookup`. Ad esempio, puoi immettere -il seguente comando in una finestra della riga di comando: -``` -nslookup mybluemix.net -``` - - - -## L'account è in sospeso -{: #ts_accntpding} - -Se il tuo account è in sospeso, non puoi accedere a {{site.data.keyword.Bluemix_notm}}. - - -Dopo aver eseguito la registrazione per un account di prova {{site.data.keyword.Bluemix_notm}}, -potresti non riuscire ad accedere a {{site.data.keyword.Bluemix_notm}}. Invece, visualizzi il seguente messaggio: -{: tsSymptoms} - -Your account is pending. Please wait up to 24 hours for email confirmation and also check your -spam folder. If you still have not received your email confirmation, contact Bluemix Support External link icon. - - -Dopo aver eseguito la registrazione per un account di prova {{site.data.keyword.Bluemix_notm}}, -riceverai un'e-mail di conferma. Dovrai fare clic sul link -che si trova nella email di conferma per completare il processo di registrazione. -{: tsCauses} - -L'e-mail di conferma viene inviata all'indirizzo di posta -da te fornito. Controlla la cartella della posta in arrivo e quella della posta indesiderata. Se non hai ricevuto un'e-mail di conferma, contatta il [{{site.data.keyword.Bluemix_notm}} Supporto ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixsupport.com){: new_window}. -{: tsResolve} - - - -## Impossibile aggiungere utenti a un'organizzazione -{: #ts_adduser} - -Puoi invitare più di un utente a lavorare nella stessa organizzazione. Puoi invitare utenti nella tua organizzazione solo -se sei il proprietario dell'account o se sei allo stesso tempo un gestore e un membro dell'organizzazione. - - -Non riesci a visualizzare il link **Invita un nuovo utente** -nella sezione **Gestisci organizzazioni**. -{: tsSymptoms} - - - -Solo i seguenti utenti {{site.data.keyword.Bluemix_notm}} -possono invitare gli utenti in un'organizzazione: -{: tsCauses} - * Il proprietario dell'account dell'organizzazione - * I gestori dell'organizzazione che sono anche membri, e non collaboratori, -dell'organizzazione - -In {{site.data.keyword.Bluemix_notm}}, -puoi essere un membro o un collaboratore di un'organizzazione. - -
      Collaboratore
      -
      Sei un collaboratore di un'organizzazione se disponi già -di un account {{site.data.keyword.Bluemix_notm}} -e qualcun altro ti invita nell'organizzazione.
      -
      Membro
      -
      Sei membro di un'organizzazione se non disponi di un account {{site.data.keyword.Bluemix_notm}}, -ma poi qualcuno ti invita nell'organizzazione e ti registri a {{site.data.keyword.Bluemix_notm}} -tramite l'invito.
      -
      - - -Non puoi invitare utenti nella tua organizzazione se sei -un collaboratore, anche se ti è stato assegnato il ruolo di -gestore organizzazione. - -**Nota:** tutti i gestori organizzazione, compresi quelli che sono collaboratori di un'organizzazione, possono aggiungere, modificare e rimuovere gli utenti già presenti nell'organizzazione. - - - -Se non riesci a inviare utenti nella tua organizzazione e per farlo -hai bisogno di un ruolo differente, contatta il gestore della tua organizzazione -per modificare il tuo ruolo. Per identificare il gestore della tua organizzazione, completa -la seguente procedura: -{: tsResolve} - - 1. Vai al Dashboard {{site.data.keyword.Bluemix_notm}}, fai clic sull'icona {{site.data.keyword.avatar}} ![icona Avatar](images/account_support.svg) nella barra dei menu e seleziona **Gestisci organizzazioni**. - 2. Vai alla tua organizzazione e visualizza le informazioni del gestore organizzazione -sulla scheda **UTENTI**. - -Se non riesci a invitare utenti perché sei un collaboratore e non -un membro, devi eliminare il tuo account {{site.data.keyword.Bluemix_notm}} precedente -ed essere inviato a entrare a far parte dell'account come membro dell'organizzazione. Per eliminare il tuo account precedente ed entrare a far parte dell'account come membro, -completa la seguente procedura: - - 1. Contatta il [{{site.data.keyword.Bluemix_notm}} Supporto ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixsupport){: new_window} per aprire un ticket di supporto e richiedere l'eliminazione del tuo account. Se hai dei dati associati al tuo -account precedente che vuoi salvare e passare al nuovo account, -includi queste informazioni nell'email. - 2. Una volta eliminato il tuo account, fa sì che un utente con il ruolo di gestore -organizzazione ti inviti nell'organizzazione come gestore. Utilizza quindi l'invito per registrarti in -{{site.data.keyword.Bluemix_notm}}. - - - - -## La registrazione batch degli utenti non è supportata -{: #ts_batchregistration} - -Quando -registri gli utenti per {{site.data.keyword.Bluemix_notm}}, -devi registrare ciascun utente singolarmente. - - -{{site.data.keyword.Bluemix_notm}} non -fornisce la capacità di registrare più utenti -contemporaneamente. -{: tsSymptoms} - - -{{site.data.keyword.Bluemix_notm}} non -supporta la registra batch di utenti. Per registrare gli utenti per {{site.data.keyword.Bluemix_notm}}, -devi registrare ciascun utente singolarmente. -{: tsCauses} - - -Per registrare più utenti per {{site.data.keyword.Bluemix_notm}}, -devi completare la seguente procedura per ogni utente: -{: tsResolve} - - 1. Fai clic su **ESEGUI REGISTRAZIONE** nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. - 2. Completa i passi seguendo la procedura guidata. - - - -## Impossibile caricare una pagina -{{site.data.keyword.Bluemix_notm}} -{: #ts_err} - -Durante l'utilizzo dell'interfaccia utente {{site.data.keyword.Bluemix_notm}}, -potresti non riuscire a caricare una pagina {{site.data.keyword.Bluemix_notm}}. Potresti visualizzare invece i messaggi di errore BXNUI0001E o BXNUI0016E. - - -Quando utilizzi l'interfaccia utente -{{site.data.keyword.Bluemix_notm}}, potresti visualizzare -uno dei seguenti messaggi di errore: -{: tsSymptoms} - -`BXNUI0001E: La pagina non è stata caricata perché Bluemix non ha rilevato se esiste una sessione.` - - -`BXNUI0016E: Le applicazioni e i servizi non sono stati recuperati perché una pagina di Bluemix non è stata caricata.` - - - -Puoi completare una o più delle seguenti azioni, -secondo necessità: -{: tsResolve} - - * Aggiorna o riavvia il tuo browser. - * Disconnettiti da {{site.data.keyword.Bluemix_notm}} e -riesegui l'accesso. - * Utilizza la modalità di navigazione privata del tuo browser. - * Cancella i cookie e la cache del browser. - * Utilizza un browser differente. Per informazioni sulle versioni dei browser supportati da {{site.data.keyword.Bluemix_notm}}, consulta [Prerequisiti di {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/bluemix/support/#prereqs){: new_window}. - * Se hai installato l'interfaccia riga di comando cf, immetti il comando `cf -apps` per vedere se l'applicazione è in esecuzione. - - - - - - - - -# Risoluzione dei problemi relativi alla gestione delle applicazioni -{: #managingapps} - -I problemi generali con la gestione delle applicazioni potrebbero includere -applicazioni che non possono essere aggiornate o caratteri double-byte che non vengono visualizzati. Tuttavia, in molti casi, puoi eseguire un ripristino da tali problemi seguendo pochi semplici passi. -{:shortdesc} - - - - - -## Impossibile passare le applicazioni alla modalità di debug -{: #ts_debug} - -Potresti non essere in grado di abilitare la modalità di debug se la versione della JVM (Java virtual machine) è 8 o precedente. - - -Dopo che hai selezionato **Enable application debug**, gli strumenti tentano di passare l'applicazione alla modalità di debug. Quindi, il workbench di Eclipse avvia una sessione di debug. Quando gli strumenti hanno abilitato correttamente la modalità di debug, lo stato dell'applicazione web visualizza `Updating mode`, `Developing` e `Debugging`. -{: tsSymptoms} - -Tuttavia, quando gli strumenti non riescono ad abilitare la modalità di debug, lo stato dell'applicazione web visualizza solo `Updating mode` e `Developing` e non visualizza `Debugging`. Gli strumenti visualizzano inoltre il seguente messaggio di errore nella vista Console: - -``` -bluemixMgmgClient - ???? [pool-1-thread-1] .... ERROR --- ClientProxyImpl: Cannot create the websocket connections for MyWebProj -com.ibm.ws.cloudoe.management.client.exception.ApplicationManagementException: javax.websocket.DeploymentException: The HTTP request to initiate the WebSocket connection failed -at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl.onNewClientSocket(ClientProxyImpl.java:161) -at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl$RunServerTask.run(ClientProxyImpl.java:267) -at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:522) -at java.util.concurrent.FutureTask.run(FutureTask.java:277) -at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1153) -at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628) -at java.lang.Thread.run(Thread.java:785) -Caused by: javax.websocket.DeploymentException: The HTTP request to initiate the WebSocket connection failed -at org.apache.tomcat.websocket.WsWebSocketContainer.connectToServer(WsWebSocketContainer.java:315) -at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl.onNewClientSocket(ClientProxyImpl.java:158) -... 6 more -Caused by: java.util.concurrent.TimeoutException -at org.apache.tomcat.websocket.AsyncChannelWrapperSecure$WrapperFuture.get(AsyncChannelWrapperSecure.java:505) -at org.apache.tomcat.websocket.WsWebSocketContainer.processResponse(WsWebSocketContainer.java:542) -at org.apache.tomcat.websocket.WsWebSocketContainer.connectToServer(WsWebSocketContainer.java:296) -... 7 more -[2016-01-15 13:33:51.075] bluemixMgmgClient - ???? [pool-1-thread-1] .... ERROR --- ClientProxyImpl: Cannot create the websocket connections for MyWebProj -com.ibm.ws.cloudoe.management.client.exception.ApplicationManagementException: javax.websocket.DeploymentException: The HTTP request to initiate the WebSocket connection failed -at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl.onNewClientSocket(ClientProxyImpl.java:161) -at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl$RunServerTask.run(ClientProxyImpl.java:267) -at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:522) -at java.util.concurrent.FutureTask.run(FutureTask.java:277) -at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1153) -at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628) -at java.lang.Thread.run(Thread.java:785) -Caused by: javax.websocket.DeploymentException: The HTTP request to initiate the WebSocket connection failed -at org.apache.tomcat.websocket.WsWebSocketContainer.connectToServer(WsWebSocketContainer.java:315) -at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl.onNewClientSocket(ClientProxyImpl.java:158) -... 6 more -Caused by: java.util.concurrent.TimeoutException -at org.apache.tomcat.websocket.AsyncChannelWrapperSecure$WrapperFuture.get(AsyncChannelWrapperSecure.java:505) -at org.apache.tomcat.websocket.WsWebSocketContainer.processResponse(WsWebSocketContainer.java:542) -at org.apache.tomcat.websocket.WsWebSocketContainer.connectToServer(WsWebSocketContainer.java:296) -... 7 more -``` - - -Le seguenti versioni della JVM (Java virtual machine) non possono stabilire una sessione di debug: IBM JVM 7, IBM JVM 8 e versioni precedenti di Oracle JVM 8. -{: tsCauses} - -Se il tuo workbench JVM è di una di queste versioni, potresti avere problemi durante la creazione di una sessione di debug. La versione JVM del workbench è normalmente la JVM di sistema del tuo computer locale. La tua JVM di sistema non è la stessa della tua applicazione Java Bluemix in esecuzione. L'applicazione Java Bluemix viene quasi sempre eseguita su JVM IBM e alcune volte su JVM OpenJDK. - - -Per controllare la versione di Java che segue IBM Eclipse Tools for Bluemix, completa la seguente procedura: -{: tsResolve} - - 1. In IBM Eclipse Tools for Bluemix, seleziona **Guida** > **Informazioni su Eclipse** > **Dettagli dell'installazione** > **Configurazione**. - 2. Trova la proprietà `eclipse.vm` dall'elenco. La seguente linea è un esempio di una proprietà `eclipse.vm`: - - ``` - eclipse.vm=C:\Program Files\IBM\ibm-java-sdk-80-win-x86_64\bin\..\jre\bin\j9vm\jvm.dll - ``` - - 3. Nella riga di comando, immetti `java -version` dalla directory `bin` della tua installazione Java. Vengono visualizzate le informazioni sulla tua versione Java IBM. - -Se il JVM workbench JVM è IBM JVM 7 o 8 o una versione precedente di Oracle JVM 8, completa la seguente procedura per passare a Oracle JVM 8: - - 1. Scarica e installa Oracle JVM 8, per i dettagli consulta [Java SE Downloads ![icona link esterno](../icons/launch-glyph.svg)](http://www.oracle.com/technetwork/java/javase/downloads/index.html){: new_window}. - 2. Riavvia Eclipse. - 3. Controlla se la proprietà `eclipse.vm` punta alla tua nuova installazione di Oracle JVM 8. - - - -## Impossibile riutilizzare i nomi di applicazioni eliminate -{: #ts_reuse_appname} - -Dopo aver eliminato un'applicazione, puoi riutilizzarne il nome solo dopo aver eliminato la rotta dell'applicazione. - -Quando tenti di riutilizzare il nome applicazione, ricevi il seguente messaggio: -{: tsSymptoms} - -`Il nome è già utilizzato da un'altra applicazione.` - -Quando si elimina un'applicazione, la sua rotta, ossia l'URL dell'applicazione, non viene eliminata automaticamente. Pertanto, non è disponibile per il riutilizzo. Per poterlo riutilizzare, devi accedere allo spazio in cui è stata creata l'applicazione per eliminare la rotta. -{: tsCauses} - -Per eliminare la rotta non utilizzata, effettua la seguente procedura: -{: tsResolve} - - 1. Controlla se la rotta appartiene allo spazio corrente immettendo il seguente comando: - ``` - cf routes - ``` - 2. Se la rotta non appartiene allo spazio corrente, passa allo spazio o all'organizzazione a cui appartiene immettendo il seguente comando: - ``` - cf target -o org_name -s space_name - ``` - 3. Elimina la rotta dell'applicazione immettendo il seguente comando: - ``` - cf delete-route domain_name -n host_name - ``` - Ad -esempio: - ``` - cf delete-route mybluemix.net -n app001 - ``` - - - - - - - - -## Impossibile richiamare gli spazi in un'organizzazione -{: #ts_retrieve_space} - -Non puoi creare un'applicazione o un servizio se la tua organizzazione corrente non dispone di uno spazio associato ad essa. - -Quando tenti di creare un'applicazione in Bluemix, viene visualizzato il seguente messaggio di errore: -{: tsSymptoms} - -`BXNUI0515E: il tentativo di richiamare gli spazi nell'organizzazione non è riuscito a causa di un problema nella connessione di rete.` - -Questo errore spesso viene ricevuto la prima volta che si tenta di creare un'applicazione o un servizio dal catalogo quando ancora non è stato creato uno spazio. -{: tsCauses} - -Assicurati di aver creato uno spazio nella tua organizzazione corrente. Per creare uno spazio, utilizza uno dei seguenti metodi: -{: tsResolve} - - * Fai clic sull'icona {{site.data.keyword.avatar}} ![icona Avatar](images/account_support.svg) per aprire il widget Account e supporto, seleziona l'organizzazione in cui vuoi creare lo spazio e fai clic su **Crea uno spazio**. - * Nell'interfaccia riga di comando cf, immetti `cf create-space --o `. - -Riprova. Se vedi di nuovo questo messaggio, vai alla pagina sugli [stati di Bluemix ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixstatus){: new_window} per controllare se un servizio o un componente ha qualche problema. - - - - -## Impossibile effettuare le azioni richieste -{: #ts_authority} - -Potresti non riuscire a completare delle azioni senza un'appropriata autorità di accesso. - - - -Quando tenti di eseguire azioni per un'istanza del servizio o un'istanza dell'applicazione, non riesci a completare le azioni richieste e visualizzai uno dei seguenti messaggi di errore: -{: tsSymptoms} - -`BXNUI0514E: You are not a developer for any of the spaces in the organization.` - - -`Server error, status code: 403, error code: 10003, message: You are not authorized to perform the requested action.` - - - -Non disponi di un adeguato livello di autorità necessario per eseguire le azioni. -{: tsCauses} - - - -Per ottenere il livello di autorità appropriato, utilizza uno dei seguenti metodi: -{: tsResolve} - * Seleziona un'altra organizzazione e uno spazio per cui disponi del ruolo di sviluppatore. - * Chiedi al gestore organizzazione di modificare il tuo ruolo in sviluppatore oppure di creare uno spazio e assegnarti quindi un ruolo sviluppatore. Consulta [Gestione di organizzazioni e spazi](/docs/admin/orgs_spaces.html) per i dettagli. - - - - - -## Impossibile accedere ai servizi {{site.data.keyword.Bluemix_notm}} a causa di errori di autorizzazione -{: #ts_vcap} - -Gli errori di autorizzazione potrebbero verificarsi quando la tua applicazione accede a un servizio {{site.data.keyword.Bluemix_notm}} se le credenziali del servizio sono hardcoded nell'applicazione. - -Dopo aver configurato l'applicazione per comunicare con un servizio {{site.data.keyword.Bluemix_notm}}, distribuisci l'applicazione a {{site.data.keyword.Bluemix_notm}}. Tuttavia, non riesci a utilizzare l'applicazione per accedere al servizio {{site.data.keyword.Bluemix_notm}} e ricevi un messaggio di errore. -{: tsSymptoms} - -Le credenziali hardcoded nell'applicazione potrebbero non essere corrette. Ogni volta che il servizio viene ricreato, le credenziali per accedervi cambiano. -{: tsCauses} - - -Invece di impostare come hardcoded le credenziali nella tua applicazione, utilizza i parametri di connessione dalla variabile di ambiente VCAP_SERVICES. I metodi per utilizzare i parametri di connessione dalla variabile di ambiente VCAP_SERVICES variano a seconda dei linguaggi di programmazione. Ad esempio, per le applicazioni Node.js, puoi utilizzare il seguente comando: -{: tsResolve} - -``` -process.env.VCAP_SERVICES -``` -Per ulteriori informazioni sui comandi che puoi utilizzare in altri linguaggi di programmazione, consulta [Java ![icona link esterno](../icons/launch-glyph.svg)](http://docs.run.pivotal.io/buildpacks/java/java-tips.html#env-var){: new_window} e [Ruby ![icona link esterno](../icons/launch-glyph.svg)](http://docs.run.pivotal.io/buildpacks/ruby/ruby-tips.html#env-var){: new_window}. - - - - - - - - -## Impossibile distribuire le applicazioni utilizzando IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}} -{: #ts_bm_tools_facet} - -Quando al tuo progetto Eclipse viene applicato un facet non supportato, potresti non essere in grado di distribuire le -tue applicazioni a {{site.data.keyword.Bluemix_notm}} utilizzando IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}. - - - -Puoi distribuire correttamente la tua applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando la CLI Cloud Foundry. Tuttavia, non puoi distribuire l'applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}, e vedi un messaggio di errore: `Project facet is not supported.`. Ad esempio, `Project facet Cloud Foundry Standalone Application version 1.0 is not supported.` -{: tsSymptoms} - - - -IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}} associa i progetti ai runtime {{site.data.keyword.Bluemix_notm}} in base ai facet di progetto. I facet definiscono i requisiti per i progetti Java EE in Eclipse e sono utilizzati come parte della configurazione di runtime, in modo che runtime differenti siano associati a progetti differenti. Se il facet applicato al progetto non è supportato da -IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}, potresti non essere in grado di distribuire la tua applicazione utilizzando IBM Eclipse -Tools for {{site.data.keyword.Bluemix_notm}}. -{: tsCauses} - - -Devi rimuovere il facet dal progetto Eclipse in modo da poter distribuire la tua applicazione -utilizzando IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}. -{: tsResolve} - -Per rimuovere il -facet, in IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}, fai clic su **Project>Properties>Project Facets** per il progetto. Deseleziona quindi la casella di spunta per il facet non supportato. - - - -## Ricezione di errori 502 Bad Gateway -{: #ts_502_error} - -Se ricevi degli errori 502 Bad Gateway quando interagisci -con le applicazioni su {{site.data.keyword.Bluemix_notm}}, -controlla la pagina degli stati di {{site.data.keyword.Bluemix_notm}} -ed effettua le operazioni appropriate. - - - -Ricevi dei messaggi di errore che iniziano con 502 Bad Gateway. Ad esempio, potresti vedere `502 Bad Gateway: Registered endpoint failed to handle the request.` -{: tsSymptoms} - - - -Un errore -Bad Gateway di solito si verifica quando visiti un sito Web che utilizza -un server proxy per memorizzare e inoltrare i dati dal server principale che -ospita il sito. Il server principale e il server proxy potrebbero non connettersi -correttamente, pertanto visualizzi il codice di stato HTTP 502 nella finestra del -browser. Questo codice di stato indica che il server principale del sito non ha -ricevuto l'implementazione HTTP prevista dal server -proxy. -{: tsCauses} - -Altre cause meno comuni di un errore Bad Gateway sono -interruzioni ISP (Internet Service Provider), configurazioni firewall non valide ed -errori della cache del browser. - - - -Se sospetti che un servizio {{site.data.keyword.Bluemix_notm}} sia inattivo, controlla prima la pagina [{{site.data.keyword.Bluemix_notm}} status ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixstatus){: new_window}. Come soluzione alternativa, potresti voler utilizzare questo servizio in un'altra regione -{{site.data.keyword.Bluemix_notm}}. Informazioni dettagliate sono disponibili in [Utilizzo -dei servizi in un'altra regione](/docs/services/reqnsi.html#cross_region_service). Se lo stato del servizio è normale, -prova le seguenti operazioni per risolvere il problema: -{: tsResolve} - - * Ritenta l'azione: - * Ricarica la pagina premendo F5 sulla tastiera o facendo clic sul -pulsante di aggiornamento. Se questa operazione non funziona, cancella la cache -e i cookie del tuo browser e ricarica di nuovo la pagina. - * Utilizza un browser differente. - * Riavvia il router, il modem e il computer. Il riavvio di questi -dispositivi può cancellare i diversi errori che portano all'errore 502. - * Attendi e riprova in seguito. In alcuni casi, possono verificarsi dei -problemi temporanei con il tuo provider dei servizi Internet o con i servizi {{site.data.keyword.Bluemix_notm}}. Puoi attendere finché i problemi non vengono risolti. - * Se il problema persiste, contatta il supporto {{site.data.keyword.Bluemix_notm}}. Per ulteriori informazioni, consulta [Come contattare il supporto {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](/docs/support/index.html#contacting-bluemix-support){: new_window}. - - - - -## Quota disco superata -{: #ts_disk_quota} - -Se esaurisci lo spazio su disco, puoi modificare manualmente la quota per -ottenere ulteriore spazio sul disco. - - - -Se esaurisci lo spazio su disco, potresti visualizzare un messaggio -che indica che la quota di disco è stata superata. Per risolvere il problema, -potresti aver tentato di ridimensionare la tua istanza dell'applicazione per ottenere ulteriore spazio -su disco. Ad esempio, avresti potuto eseguire il ridimensionamento da 256 MB a 1256 MB modificando -la quota di memoria nella pagina dei dettagli dell'applicazione. Tuttavia, poiché la quota di -disco è rimasta la stessa, non hai ottenuto ulteriore spazio su disco. -{: tsSymptoms} - - -La quota di disco predefinita assegnata a un'applicazione è 1 -GB. Se hai bisogno di più spazio su disco, devi specificare manualmente la -quota di disco. -{: tsCauses} - - -Utilizza uno dei seguenti metodi per specificare la quota disco. La quota di disco massima che puoi specificare è 2 GB. Se 2 GB non è ancora -sufficiente, prova un servizio esterno come [Object Store](/docs/services/ObjectStorage/index.html). -{: tsResolve} - - * Nel file manifest.yml, aggiungi la seguente voce: - ``` - disk_quota: - ``` - * Utilizza l'opzione **-k** con il comando `cf push` -quando distribuisci la tua applicazione a {{site.data.keyword.Bluemix_notm}}: - ``` - cf push appname -p app_path -k - ``` - - - -## Impossibile aggiungere il repository Git -{: #ts_cannot_addgit} - -Dopo aver creato un'applicazione sul Dashboard, fai clic sul AGGIUNGI GIT per aggiungere un repository Git, ma non riesci a continuare. - - - -Quando fai clic su **AGGIUNGI GIT**, si apre una finestra -e si verifica uno dei seguenti problemi: -{: tsSymptoms} - - * La finestra si blocca con una schermata vuota. - * Un messaggio indica che esiste un problema con i cookie di terze parti. - - - -È possibile che il tuo browser sia configurato per impedire l'impostazione -di un cookie. Tale cookie deve essere impostato dal sito di IBM® Bluemix DevOps Services nel dominio Internet hub.jazz.net all'interno del contesto della console {{site.data.keyword.Bluemix_notm}}. -{: tsCauses} - - - -Puoi risolvere questo problema in uno dei seguenti modi: -{: tsResolve} - - * Segui le istruzioni presenti nella finestra che viene visualizzata -dalla console {{site.data.keyword.Bluemix_notm}}. Fai clic sul pulsante. Si aprirà temporaneamente un'altra finestra del browser. In tale -finestra, DevOps Services imposta il cookie di autenticazione. - * In un'altra scheda del browser, vai all'indirizzo https://hub.jazz.net ed esegui l'accesso. Torna alla console {{site.data.keyword.Bluemix_notm}} -e aggiorna la pagina. Fai di nuovo clic su **AGGIUNGI GIT**. - * Modifica le impostazioni del tuo browser per abilitare i cookie di terze parti e fai di nuovo clic su AGGIUNGI GIT. Per i dettagli sulla configurazione delle impostazioni, -consulta la documentazione relativa al tuo browser: - * [Mozilla Firefox ![icona link esterno](../icons/launch-glyph.svg)](https://support.mozilla.org/en-US/kb/enable-and-disable-cookies-website-preferences#w_how-do-i-change-cookie-settings){: new_window} - * [Google Chrome ![icona link esterno](../icons/launch-glyph.svg)](https://support.google.com/chrome/answer/95647){: new_window} - * [Apple Safari ![icona link esterno](../icons/launch-glyph.svg)](https://support.apple.com/kb/PH17191){: new_window} - * [Microsoft Internet Explorer ![icona link esterno](../icons/launch-glyph.svg)](http://windows.microsoft.com/en-us/internet-explorer/delete-manage-cookies#ie=ie-11){: new_window} -Se queste soluzioni alternative non risolvono il problema, invia un'email a idslogin@jazz.net. - - - -## Le applicazioni Android non possono ricevere le notifiche di push -{: #ts_push} - -In alcune regioni in cui Google non è accessibile, le applicazioni Android -non possono ricevere le notifiche che invii tramite il servizio IBM -Push. In questo caso, puoi utilizzare servizi di terze parti come soluzione alternativa. - - - -Esegui il bind di un servizio Push per la tua applicazione Bluemix e invii un messaggio ai dispositivi registrati. Tuttavia, le applicazioni -sviluppate sulla piattaforma Android non possono ricevere le tue notifiche -in determinate regioni. -{: tsSymptoms} - - -Il servizio IBM Push utilizza il servizio GCM (Google Cloud Messaging) -per inviare notifiche alle applicazioni mobili sviluppate sulla -piattaforma Android. Per consentire alle applicazioni Android di ricevere le notifiche, -è necessario che il servizio GCM (Google Cloud Messaging) sia accessibile dalle applicazioni -mobili. Nelle regioni in cui il servizio GCM non può essere raggiunto dalle applicazioni Android, -tali applicazioni non saranno in grado di ricevere le notifiche di push. -{: tsCauses} - - -Come soluzione alternativa, utilizza servizi di terze parti che non si basano sul servizio GCM, ad esempio -[Pushy ![icona link esterno](../icons/launch-glyph.svg)](https://pushy.me){: new_window}, -[igetui ![icona link esterno](../icons/launch-glyph.svg)](http://www.getui.com/){: new_window} e -[jpush ![icona link esterno](../icons/launch-glyph.svg)](https://www.jpush.cn/){: new_window}. -{: tsResolve} - - - -## Limite dei servizi dell'organizzazione superato -{: #ts_servicelimit} - -Se utilizzi un account utente di prova, potresti non riuscire -a creare un'applicazione in {{site.data.keyword.Bluemix_notm}} se -hai superato il limite dei servizi della tua organizzazione. - - -Quando tenti di creare un'applicazione in {{site.data.keyword.Bluemix_notm}}, -visualizzi il seguente messaggio di errore: -{: tsSymptoms} - -`BXNUI2032E: La risorsa non è stata creata. Mentre Cloud Foundry veniva contattato per creare la risorsa, si è verificato un errore. Messaggio di Cloud Foundry: "È stato superato il limite -dei servizi dell'organizzazione."` - - - -Questo errore si verifica quando superi il limite per il -numero di istanze del servizio che puoi avere per l'account. Il -numero massimo di istanze di servizi per un account di prova è 10. -{: tsCauses} - - - -Elimina tutte le istanze dei servizi che non sono necessarie o rimuovi -il limite per il numero di istanze del servizio che puoi avere. -{: tsResolve} - - * Per eliminare un'istanza dei servizi, puoi utilizzare l'interfaccia utente di {{site.data.keyword.Bluemix_notm}} -o l'interfaccia riga di comando. - Per utilizzare l'interfaccia utente di {{site.data.keyword.Bluemix_notm}} -per eliminare un'istanza del servizio, completa la seguente procedura: - 1. Nel Dashboard {{site.data.keyword.Bluemix_notm}}, fai clic sul servizio che vuoi eliminare. Viene visualizzato il tile del servizio. - 2. Sul tile del servizio, fai clic sull'icona **Menu**. - 3. Fai clic su **Elimina servizio**. Dopo aver eliminato -l'istanza del servizio, ti verrà richiesto di preparare nuovamente l'applicazione -a cui era associata l'istanza del servizio. - Per utilizzare l'interfaccia riga di comando per eliminare un'istanza del -servizio, completa la seguente procedura: - 1. Annulla il bind dell'istanza del servizio da un'applicazione immettendo `cf -unbind-service `. - 2. Elimina l'istanza del servizio immettendo `cf delete-service `. - 3. Dopo aver eliminato l'istanza del servizio, potresti voler preparare nuovamente l'applicazione -a cui era associata l'istanza del servizio immettendo `cf -restage `. - * Per rimuovere il limite sul numero di istanze del servizio che puoi avere, -converti il tuo account di prova in un account a pagamento. Per informazioni su come convertire il tuo account di prova in un account a pagamento, vedi [Come modificare il tuo piano](/docs/pricing/index.html#changing). - - - -## Impossibile eseguire gli eseguibili su {{site.data.keyword.Bluemix_notm}} -{: #ts_executable} - -Potresti non riuscire ad eseguire gli eseguibili su {{site.data.keyword.Bluemix_notm}} se -tali eseguibili sono stati sviluppati e creati in un ambiente diverso. - - - -Non riesci ad eseguire gli eseguibili su {{site.data.keyword.Bluemix_notm}} quando -tali eseguibili sono stati sviluppati e creati in un ambiente diverso. -{: tsSymptoms} - - - -Se il contenuto che desideri distribuire a {{site.data.keyword.Bluemix_notm}} è -già un eseguibile, il contenuto è stato creato precedentemente e non è necessario -crearlo in {{site.data.keyword.Bluemix_notm}}. In questo caso, non è richiesto alcun pacchetto di build per l'eseguibile da eseguire -su {{site.data.keyword.Bluemix_notm}}. Tuttavia, devi indicare esplicitamente a {{site.data.keyword.Bluemix_notm}} che -non è richiesto alcun pacchetto di build. -{: tsCauses} - - - -Quando distribuisci l'eseguibile a {{site.data.keyword.Bluemix_notm}}, -devi specificare un pacchetto di build null, che indica che -non è richiesto alcun pacchetto di build. Specifica un pacchetto di build null utilizzando l'opzione **-b** -con il comando `cf push`: -{: tsResolve} - -``` -cf push appname -p -c -b -``` -Per esempio: -``` -cf push appname -p -c ./RunMeNow -b https://github.com/ryandotsmith/null-buildpack -``` - - -## Limite di memoria dell'organizzazione superato -{: #ts_outofmemory} - -Se utilizzi un account utente di prova, potresti non riuscire a distribuire un'applicazione a {{site.data.keyword.Bluemix_notm}} se hai superato il limite di memoria della tua organizzazione. Puoi -ridurre la memoria utilizzata dalle tue applicazioni o aumentare la quota di memoria -del tuo account. - - - -Quando distribuisci un'applicazione a {{site.data.keyword.Bluemix_notm}}, visualizzi il seguente messaggio di errore: -{: tsSymptoms} - -`FAILED Server error, -status code: 400, error code: 100005, message: You have exceeded your -organization's memory limit.` - - - -Questo errore si verifica quando la quantità di memoria rimanente per la tua organizzazione è inferiore alla quantità di memoria richiesta dall'applicazione che desideri distribuire. La quota massima di memoria -per un account di prova è 2 GB. -{: tsCauses} - - - -Puoi aumentare la quota di memoria del tuo account o ridurre la memoria utilizzata dalle tue applicazioni. -{: tsResolve} - - * Per aumentare la quota di memoria dell'account, -converti il tuo account di prova in un account a pagamento. Per informazioni -su come convertire il tuo account di prova in un account a pagamento, vedi [Pay -accounts](/docs/pricing/index.html#pay-accounts). - * Per ridurre la memoria utilizzata dalle tue applicazioni, utilizza l'interfaccia utente{{site.data.keyword.Bluemix_notm}} o l'interfaccia riga di comando cf. - Se utilizzi l'interfaccia utente {{site.data.keyword.Bluemix_notm}}, completa la seguente procedura: - 1. Sul Dashboard {{site.data.keyword.Bluemix_notm}}, seleziona la tua applicazione. Viene visualizzata la pagina dei dettagli dell'applicazione. - 2. Nel riquadro runtime, puoi ridurre il limite massimo di memoria o il numero di istanze dell'applicazione, o entrambi, per tua applicazione. - Se utilizzi l'interfaccia riga di comando cf, completa la seguente procedura: - 1. Verifica la quantità di memoria utilizzata per le tue applicazioni: - ``` - cf apps - ``` - Il comando cf apps elenca tutte le applicazioni che hai distribuito nel tuo spazio corrente. Viene visualizzato anche lo stato di ciascuna applicazione. - 2. Per ridurre la quantità di memoria utilizzata dalla tua applicazione, riduci il numero di istanze dell'applicazione e/o il limite massimo di memoria. - ``` - cf push -p -i -m - ``` - 3. Riavvia la tua applicazione per rendere effettive le modifiche. - - - - -## Le applicazioni non si riavviano automaticamente -{: #ts_apps_not_auto_restarted} - - -Un'applicazione non si riavvia automaticamente quando un servizio che associ mediante bind all'applicazione smette di funzionare. - - - -Quando un servizio che associ mediante bind a un'applicazione viene arrestato in modo anomalo, nell'applicazione potrebbero verificarsi dei problemi come interruzioni, eccezioni ed errori di connessione. {{site.data.keyword.Bluemix_notm}} non riavvia automaticamente l'applicazione per eseguire un ripristino da tali problemi. -{: tsSymptoms} - - - -Questo è il funzionamento progettato da Cloud Foundry. -{: tsCauses} - - - -Puoi riavviare manualmente l'applicazione immettendo il seguente comando nell'interfaccia riga di comando: -{: tsResolve} - -``` -cf push -p -``` -Inoltre, puoi codificare l'applicazione per identificare e risolvere problemi come interruzioni, eccezioni ed errori di connessione. - - - -## Le variabili definite dall'utente vengono perse dopo la distribuzione di un'applicazione -{: #ts_varsnotretained} - -Quando esegui il push di un'applicazione a {{site.data.keyword.Bluemix_notm}} da IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}, le variabili che hai specificato vengono reimpostate a meno che non salvi tali variabili nel file -manifest. - - - -Le variabili che hai specificato vengono perse in seguito all'esecuzione del push di un'applicazione a {{site.data.keyword.Bluemix_notm}} da IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}. -{: tsSymptoms} - - -Le variabili specificate vengono mantenute solo se le salvi -nel file manifest. -{: tsCauses} - - - -Quando esegui il push di un'applicazione a {{site.data.keyword.Bluemix_notm}} da IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}, seleziona la casella di spunta **Salva nel file manifest** nella pagina Dettagli applicazione della procedura guidata Applicazione. Quindi, -le variabili che hai specificato nella -procedura guidata vengono -salvate nel file manifest della tua applicazione. La prossima volta che apri la procedura guidata, le variabili vengono visualizzate automaticamente. -{: tsResolve} - - - -## Le icone di {{site.data.keyword.Bluemix_notm}} Live -Sync non vengono visualizzate -{: #ts_llz_lkb_3r} - -Hai creato un'applicazione in IBM Bluemix DevOps Services, ma le icone IBM Bluemix Live Sync non sono visualizzate nel Web IDE. - - - -Quando modifichi un'applicazione Node.js nel DevOps Services Web IDE, le icone di le icone di live edit, riavvio rapido e debug di {{site.data.keyword.Bluemix_notm}} non vengono visualizzate. -{: tsSymptoms} - - - -Le icone non sono disponibili nei seguenti casi: -{: tsCauses} - - * Il file `manifest.yml` non è memorizzato al -livello superiore del tuo progetto. - * La tua applicazione è memorizzata in una sottodirectory anziché al livello superiore -del tuo progetto, ma il percorso della sottodirectory non è specificato -nel file `manifest.yml`. - * L'applicazione non contiene un file `package.json`. - - -Per risolvere il problema utilizza uno dei seguenti metodi: -{: tsResolve} - - * Se il file `manifest.yml` non è memorizzato al -livello superiore del tuo progetto, memorizzalo lì. - * Se la tua applicazione è memorizzata in una sottodirectory, specifica il percorso -di tale sottodirectory nel file `manifest.yml`. - ``` - path: percorso_alla_applicazione - ``` - * Crea un file `package.json` che si trovi nella stessa -directory della tua applicazione. - - - - - - - - - - -## Impossibile trovare le organizzazioni in {{site.data.keyword.Bluemix_notm}} -{: #ts_orgs} - -Potresti non riuscire a individuare la tua organizzazione in {{site.data.keyword.Bluemix_notm}} quando -lavori su una regione {{site.data.keyword.Bluemix_notm}}. - - - -Riesci ad accedere correttamente all'interfaccia utente {{site.data.keyword.Bluemix_notm}} ma non puoi distribuire le applicazioni utilizzando l'interfaccia riga di comando cf o il plug-in Eclipse. -{: tsSymptoms} - -Quando tenti di distribuire un'applicazione -a {{site.data.keyword.Bluemix_notm}} utilizzando -l'interfaccia riga di comando cf, puoi visualizzare uno dei seguenti -messaggi di errore in cui viene specificato il nome dell'organizzazione: - -`Error finding org` - -`Organization not found` - - -Quando tenti di distribuire un'applicazione a {{site.data.keyword.Bluemix_notm}} -utilizzando il plug-in Eclipse Cloud Foundry, visualizzi il seguente messaggio di -errore: - -`cloudspace not found.` - - - -Questo problema si verifica poiché l'endpoint API della regione -che vuoi utilizzare non è specificato e l'organizzazione che stai -cercando potrebbe trovarsi in una regione differente. -{: tsCauses} - - - -Se stai eseguendo il push della tua applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando l'interfaccia riga di comando cf, immetti il comando cf api e specifica l'endpoint API della regione. Ad esempio, immetti il seguente comando per stabilire una connessione alla regione {{site.data.keyword.Bluemix_notm}} Europa -Regno Unito: -{: tsResolve} - -``` -cf api https://api.eu-gb.bluemix.net -``` -Se stai distribuendo la tua applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando -gli strumenti Eclipse, devi prima creare un server {{site.data.keyword.Bluemix_notm}} -e specificare l'endpoint API della regione {{site.data.keyword.Bluemix_notm}} in -cui è stata creata la tua organizzazione. Per ulteriori informazioni sull'utilizzo di strumenti Eclipse, consulta il documento relativo alla [distribuzione di applicazioni con IBM Eclipse Tools for Bluemix](/docs/manageapps/eclipsetools/eclipsetools.html). - - - - -## Impossibile creare rotte di applicazione -{: #ts_hostistaken} - -Quando distribuisci un'applicazione a {{site.data.keyword.Bluemix_notm}}, la rotta dell'applicazione non può essere creata se il nome host da te specificato è già in uso. - - - -Quando distribuisci un'applicazione a {{site.data.keyword.Bluemix_notm}}, visualizzi il seguente messaggio di errore: -{: tsSymptoms} - -`Creating route hostname.domainname ... FAILED Server error, status code: 400, error code: 210003, message: The host is taken: hostname` - - - -Questo problema si verifica se il nome host da te specificato -è già in uso. -{: tsCauses} - - - -Il nome host specificato deve essere univoco all'interno -del dominio che stai utilizzando. Per specificare un nome host differente, usa uno dei -seguenti metodi: -{: tsResolve} - - * Se distribuisci la tua applicazione utilizzando il file `manifest.yml`, specifica il nome host nell'opzione host. - ``` - host: - ``` - * Se distribuisci la tua applicazione dal prompt dei comandi, utilizza il comando `cf -push` con l'opzione **-n**. - ``` - cf push -p -n - ``` - - -## Non è possibile distribuire delle applicazioni WAR utilizzando il comando cf push -{: #ts_cf_war} - -Potresti non riuscire a utilizzare il comando cf push per distribuire un'applicazione web archiviata a {{site.data.keyword.Bluemix_notm}} se la posizione dell'applicazione non è specificata correttamente. - - - -Quando carichi un'applicazione WAR in {{site.data.keyword.Bluemix_notm}} utilizzando il comando `cf push`, visualizzi il messaggio di errore `Staging -error: cannot get instances since staging failed.` -{: tsSymptoms} - - - -Questo problema potrebbe verificarsi se non si specifica il file WAR -o il percorso del file WAR. -{: tsCauses} - - - -Utilizza l'opzione **-p** per specificare -un file WAR o aggiungere il percorso del file WAR. Per esempio: -{: tsResolve} - -``` -cf push MyUniqueAppName01 -p app.war -``` - -``` -cf push MyUniqueAppName02 -p "./app.war" -``` -Per ulteriori informazioni sul comando `cf push` , immettere `cf push -h`. - - - - - -## I caratteri double-byte non vengono visualizzati correttamente quando si distribuiscono le applicazioni Liberty a {{site.data.keyword.Bluemix_notm}} -{: #ts_doublebytes} - -I caratteri double-byte potrebbero non essere visualizzati correttamente se il supporto Unicode non è adeguatamente configurato per i file servlet o JSP. - - - -Quando un'applicazione Liberty viene distribuita a {{site.data.keyword.Bluemix_notm}}, i caratteri double-byte specificati all'interno dell'applicazione non vengono visualizzati correttamente. -{: tsSymptoms} - - - -Il problema può verificarsi se il supporto Unicode non è configurato correttamente per i file servlet o JSP. -{: tsCauses} - - -Puoi utilizzare il seguente codice all'interno dei tuoi file servlet o JSP: -{: tsResolve} - - * Nel file di origine servlet - ``` - response.setContentType("text/html; charset=UTF-8"); - ``` - * Nel JSP - ``` - - ``` - - - - -## Impossibile distribuire le applicazioni Node.js -{: #ts_nodejs_deploy} - -Potresti riscontrare dei problemi quando aggiorni un'applicazione Node.js -o quando distribuisci un'applicazione Node.js a {{site.data.keyword.Bluemix_notm}}. - - - -Quando aggiorni un'applicazione Node.js o distribuisci la tua applicazione Node.js -a {{site.data.keyword.Bluemix_notm}}, -potresti visualizzare uno dei seguenti messaggi di errore: -{: tsSymptoms} - -`An app was not successfully detected by any available buildpack.` - - -`Instance (index 0) failed to start accepting connections.` - - -`Cannot get instances since staging failed.` - - - - -Di seguito sono indicate le possibili cause del problema: -{: tsCauses} - - * Il comando di avvio non è specificato. - * I file richiesti per distribuire un'applicazione Node.js non sono presenti -nell'applicazione o si trovano in una cartella diversa dalla directory root. - - - - -Effettua le seguenti operazioni in base alla causa del -problema: -{: tsResolve} - - * Specifica il comando di avvio utilizzando uno dei seguenti metodi: - * Utilizza l'interfaccia riga di comando cf. Per esempio: - ``` - cf push MyUniqueNodejs01 -p app_path -c "node app.js" - ``` - * Utilizza il file [package.json ![icona link esterno](../icons/launch-glyph.svg)](https://docs.npmjs.com/json){: new_window}. Per esempio: - ``` - { - ... - "scripts": { - "start": "node app.js" - } - } - ``` - * Utilizza il file `manifest.yml`. Per esempio: - ``` - applications: - name: MyUniqueNodejs01 - ... - command: node app.js - ... - ``` - - * Assicurati che nella tua applicazione Node.js sia presente un file `package.json` per consentire al pacchetto di build Node.js di riconoscere l'applicazione. Inoltre, devi inserire questo file nella directory root della tua applicazione. - Il seguente - esempio mostra un semplice file - `package.json`: - ``` - { - "name": "MyUniqueNodejs01", - "version": "0.0.1", - "description": "A sample package.json file", - "dependencies": { - "express": "3.4.x", - "jade": "1.1.x" - }, - "engines": { - "node": "0.10.x" - }, - "scripts": { - "start": "node app.js" - } - } - ``` - -Per ulteriori suggerimenti relativi alle applicazioni Node.js, vedi [Tips for Node.js Applications ![icona link esterno](../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/buildpacks/node/node-tips.html){: new_window}. - - - - -## Sono presenti degli errori di configurazione nel file `server.xml` dopo che importi un'applicazione {{site.data.keyword.Bluemix_notm}} Liberty da Bluemix DevOps Services a Eclipse -{: #ts_eclipse} - -Se vedi degli errori di configurazione nel file `server.xml` dopo aver importato un'applicazione {{site.data.keyword.Bluemix_notm}} Liberty da IBM Bluemix DevOps Services a Eclipse, potresti dover rimuovere il file `server.xml` dal progetto. - - - -Dopo aver importato un'applicazione {{site.data.keyword.Bluemix_notm}} Liberty da {{site.data.keyword.Bluemix_notm}} DevOps Services in Eclipse, vedi degli errori di configurazione nel file `server.xml` dalla vista Problemi di Eclipse. -{: tsSymptoms} - - - -Il pacchetto di build Liberty utilizza il file `server.xml` per configurare l'applicazione e genera un file `runtime-vars.xml` quando viene eseguito il push dell'applicazione Liberty a {{site.data.keyword.Bluemix_notm}}. Quando importi l'applicazione in Eclipse, il file `runtime-vars.xml` non esiste nel tuo ambiente locale. -{: tsCauses} - - - -Puoi risolvere questo problema rimuovendo il file server.xml dal progetto. Il pacchetto di build crea il file `server.xml` dinamicamente quando esegui il push dell'applicazione come un'applicazione WAR. Per ulteriori informazioni, consulta [Liberty for Java](/docs/runtimes/liberty/index.html). -{: tsResolve} - - -## Impossibile preparare l'applicazione utilizzando i pacchetti di build personalizzati -{: #ts_bp_compilation} - -Potresti non riuscire a distribuire un'applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando un pacchetto di build personalizzato se gli script all'interno del pacchetto di build non sono eseguibili. - - - -Quando distribuisci un'applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando un pacchetto di build personalizzato, visualizzi il messaggio di errore `La preparazione dell'applicazione non è riuscita e, pertanto, non ci sono istanze da visualizzare.` -{: tsSymptoms} - - -Questo problema -potrebbe verificarsi se gli script, ad esempio lo script di rilevamento, lo script di compilazione e lo - script di rilascio, non sono eseguibili. -{: tsCauses} - - - -Puoi utilizzare il comando [git update ![icona link esterno](../icons/launch-glyph.svg)](http://git-scm.com/docs/git-update-index){: new_window} per modificare l'autorizzazione di ciascuno script in eseguibile. Ad esempio, puoi immettere `git update --chmod=+x script.sh`. -{: tsResolve} - - - -## Un'applicazione non può essere distribuita da DevOps Services a {{site.data.keyword.Bluemix_notm}} -{: #ts_devops_to_bm} - -Potresti non riuscire ad eseguire il push della tua applicazione da IBM Bluemix DevOps Services a {{site.data.keyword.Bluemix_notm}} se il file `manifest.yml` non è presente nella tua applicazione. - - - -Quando distribuisci un'applicazione da DevOps Services a {{site.data.keyword.Bluemix_notm}}, potrebbe essere visualizzato un messaggio di errore `Unable to detect a supported application type`. -{: tsSymptoms} - - - -Questo problema potrebbe verificarsi perché DevOps Services richiede un file `manifest.yml` per distribuire un'applicazione a {{site.data.keyword.Bluemix_notm}}. -{: tsCauses} - - - -Per risolvere questo problema, devi creare un file `manifest.yml`. Per ulteriori informazioni su come creare un file `manifest.yml`, -vedi [Manifest -dell'applicazione](/docs/manageapps/depapps.html#appmanifest). -{: tsResolve} - - - - - -## Impossibile distribuire le applicazioni Meteor -{: #ts_meteor} - -Potresti non riuscire a distribuire un'applicazione Meteor a {{site.data.keyword.Bluemix_notm}} se -il pacchetto di build non è specificato correttamente. - - - -Quando distribuisci un'applicazione Meteor a {{site.data.keyword.Bluemix_notm}}, potresti visualizzare il messaggio di errore `La -preparazione dell'applicazione non è riuscita e, pertanto, non ci sono istanze da visualizzare.` -{: tsSymptoms} - - -Questo problema si verifica perché non viene fornito alcun pacchetto di build integrato per le applicazioni Meteor. Devi utilizzare un pacchetto di build personalizzato. -{: tsCauses} - - - - -Per utilizzare un pacchetto di build personalizzato per le applicazioni Meteor, usa uno dei seguenti metodi: -{: tsResolve} - - * Se distribuisci la tua applicazione utilizzando il file `manifest.yml`, specifica l'URL o il nome del pacchetto di build personalizzato usando l'opzione buildpack. Per esempio: - ``` - buildpack: https://github.com/Sing-Li/bluemix-bp-meteor - ``` - * Se distribuisci la tua applicazione dal prompt dei comandi, utilizza il comando `cf -push` e specifica il pacchetto di build personalizzato usando -l'opzione **-b**. Per esempio: - ``` - cf push appname -p app_path -b https://github.com/Sing-Li/bluemix-bp-meteor - ``` - - - - -## Il pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}} -non distribuisce un'applicazione -{: #deploytobluemixbuttondoesntdeployanapp} - -Se fai clic sul pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}} -e rilevi che il repository Git non viene clonato o che l'applicazione -non viene distribuita, prova i metodi di risoluzione per i seguenti problemi. - * [Impossibile creare il progetto Bluemix DevOps Services](#project-cannot-be-created) - * [Il repository Git non viene trovato e non può essere clonato in DevOps Services](#repo-not-found) - * [Il repository Git viene clonato in DevOps Services, ma l'applicazione non viene -distribuita a {{site.data.keyword.Bluemix_notm}}](#repo-cloned-app-not-deployed) -Per ulteriori informazioni su come creare il pulsante, vedi Creazione di un pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}}. - -### Impossibile creare il progetto Bluemix DevOps Services -{: #project-cannot-be-created} - -Se noti che il progetto DevOps Services non può essere creato, il tuo account {{site.data.keyword.Bluemix_notm}} potrebbe essere scaduto. - - - -Fai clic sul pulsante **Distribuisci a Bluemix**, ma il passo "Creazione del progetto" non viene completato correttamente. -{: tsSymptoms} - - -Il tuo account {{site.data.keyword.Bluemix_notm}} -potrebbe essere scaduto. -{: tsCauses} - -Per risolvere il problema utilizza uno dei seguenti metodi: -{: tsResolve} - - * Accedi a {{site.data.keyword.Bluemix_notm}} e -aggiorna le informazioni del tuo account. - * Fai di nuovo clic sul pulsante **Distribuisci a Bluemix**. - - -### Il repository Git non viene trovato e non può essere clonato in DevOps Services -{: #repo-not-found} - -Se noti che il repository Git non viene clonato, potrebbe esistere -un problema con il repository o con il frammento di pulsante. - - - -Fai clic sul pulsante **Distribuisci a Bluemix**, ma il repository Git non viene trovato e non può essere clonato in DevOps Services. Il passo "Clonazione del repository" non viene completato correttamente. Di conseguenza, l'applicazione non può essere distribuita a {{site.data.keyword.Bluemix_notm}}. -{: tsSymptoms} - -Questo problema si verifica a causa dei seguenti motivi: -{: tsCauses} - - * Il repository Git potrebbe non esistere o non essere accessibile. - * Potrebbe esistere un problema nell'HTML o markdown per il frammento di pulsante. - * Potrebbe esistere un problema in cui dei caratteri speciali, parametri di query -o frammenti nell'URL impediscono di accedere correttamente al repository -Git. - -Per risolvere il problema utilizza uno dei seguenti metodi: -{: tsResolve} - - * Verifica che il repository Git esista e sia accessibile pubblicamente -e che l'URL sia corretto. - * Verifica che il frammento non contenga errori di HTML o markdown. - * Se caratteri speciali, parametri di query o frammenti causano problemi con l'URL del repository Git, codifica l'URL nel frammento di pulsante. - - - - -### Il repository Git viene clonato in DevOps Services, ma l'applicazione non viene distribuita a {{site.data.keyword.Bluemix_notm}} -{: #repo-cloned-app-not-deployed} - -Se noti che l'applicazione non viene distribuita, potrebbero esistere -dei problemi con il codice nel repository. - - - -Fai clic sul pulsante **Distribuisci a Bluemix** e il repository Git viene clonato in DevOps Services, ma l'applicazione non viene distribuita a {{site.data.keyword.Bluemix_notm}}. Il passo "Distribuzione a Bluemix" non viene completato correttamente. -{: tsSymptoms} - -Questo problema si verifica a causa dei seguenti motivi: -{: tsCauses} - - * Nel tuo spazio {{site.data.keyword.Bluemix_notm}} potrebbe non esserci spazio sufficiente -per distribuire un'applicazione. - * Un servizio richiesto potrebbe non essere dichiarato nel file `manifest.yml`. - * Un servizio richiesto potrebbe essere dichiarato nel file `manifest.yml`, -ma il servizio si trova già nello spazio di destinazione. - * Potrebbe esistere un problema con il codice nel repository. -Per diagnosticare il problema, riesamina i log di creazione e distribuzione -dalla distribuzione: - 1. Quando il passo "Distribuzione a Bluemix" non viene completato correttamente, fai clic sul link nel precedente passo di "Configurazione della pipeline" per aprire Delivery Pipeline. - 2. Identifica la fase di creazione o distribuzione non riuscita. - 3. Nella fase non riuscita, fai clic su **Visualizza log e cronologia**. - 4. Individua il messaggio di errore. - -Per risolvere il problema utilizza uno dei seguenti metodi: -{: tsResolve} - - * Se il messaggio di errore indica che nello -spazio {{site.data.keyword.Bluemix_notm}} non vi è spazio sufficiente -per distribuire l'applicazione, mira a un altro spazio. - * Se il messaggio di errore indica che un servizio richiesto non è -dichiarato nel file `manifest.yml`, comunica al proprietario -del repository che è necessario aggiungere il servizio richiesto. - * Se il messaggio di errore indica che un servizio richiesto esiste -già nello spazio di destinazione, seleziona un spazio differente da utilizzare. - * Se il messaggio di errore indica che esiste un problema con la creazione, -correggi eventuali problemi con il codice che impediscono la creazione -dell'applicazione. Per verificare che il codice non contenga alcun problema, crea il -codice utilizzando i comandi Git: - 1. Clona il repository Git: - ``` - git clone - ``` - 2. Apri la directory dell'applicazione: - ``` - cd - ``` - 3. Crea l'applicazione: - ``` - create - ``` - 4. Se necessario, fornisci componenti aggiuntivi. - 5. Aggiungi eventuali variabili di configurazione richieste. - 6. Distribuisci il codice: - ``` - git push master - ``` - 7. Verifica che l'applicazione venga creata correttamente. - 8. Se necessario, esegui il comando di post distribuzione: - ``` - run - ``` - 9. Apri l'applicazione e verifica che funzioni correttamente: - ``` - open - ``` - -## La distribuzione di un'applicazione dalla barra di esecuzione non riesce -{: #deployinganappfromtherunbarfails} - -In questo scenario, la distribuzione non riesce indicando uno stato "non sincronizzato" di colore giallo. - -L'applicazione che stai distribuendo ha la stessa rotta di un'altra applicazione in esecuzione. Per correggere questo problema, modifica la rotta in modo che sia univoca. - -## Impossibile trovare la barra di esecuzione -{: #runbarcannotbefound} - -Se non riesci a visualizzare la barra di esecuzione in Eclipse Orion {{site.data.keyword.webide}}, si è verificato uno dei seguenti problemi: - -1. {{site.data.keyword.jazzhub}} non riesce a identificare il tuo progetto. - * Correzione: nella directory root del tuo progetto, crea un file `project.json`. -2. {{site.data.keyword.jazzhub_short}} non riesce a determinare in quale cartella si trova la tua applicazione. - * Correzione: se la tua applicazione si trova in una directory diversa dalla root del progetto, effettua una delle seguenti operazioni: - * Nella directory root del tuo progetto, crea un file `manifest.yml`. Modifica quindi il file in modo che punti alla posizione della tua applicazione, ad esempio `path: percorso_tua_applicazione` - * Sposta la tua applicazione nella directory root del tuo progetto. -3. {{site.data.keyword.jazzhub_short}} non riconosce la tua applicazione come applicazione Node.js. - * Correzione: nella cartella dell'applicazione del tuo progetto, crea un file `package.json`. - - -## L'hook GitHub non funziona -{: #githubhookisntworking} - -Se hai configurato il tuo progetto GitHub per creare link dell'elemento di lavoro quando esegui il push di commit e i link non funzionano nel modo previsto, usa la seguente procedura per trovare il problema: - -1. Nel repository GitHub, fai clic su **Impostazioni**. - ![Link alle impostazioni GitHub](images/githubSettings1_small.png) - -2. Fai clic su **Webhook & servizi**. - ![Link ai servizi e webhook GitHub](images/githubHooks1_small.png) - -3. Per visualizzare il messaggio, passa il puntatore del mouse sull'icona dello stato {{site.data.keyword.jazzhub}}. - ![Messaggio di errore sull'hook del servizio](images/troubleshoothook1_small.png) - -4. Risolvi il problema in base al messaggio GitHub. - -5. Per verificare che la correzione abbia funzionato, esegui il commit e il push di un'altra modifica o vai alla pagina del servizio per {{site.data.keyword.jazzhub_short}} e fai clic su **Verifica servizio**. - ![Pulsante Verifica servizio GitHub](images/githubTestService_small.png) - -6. Verifica che non vi siano errori controllando di nuovo l'icona dello stato. - ![Icona dello stato senza errori](images/githubResolved_small.png) - -Per ulteriori informazioni, consulta [Setting up GitHub for Bluemix DevOps Services projects ![icona link esterno](../icons/launch-glyph.svg)](https://hub.jazz.net/docs/githubhooks/){: new_window}. - - -# Risoluzione dei problemi relativi alla gestione degli account -{: #managingaccounts} - -Potrebbero verificarsi dei problemi durante la gestione del tuo account, ad esempio problemi relativi ad applicazioni differenti che condividono lo stesso nome dominio o amministratori che non riescono a visualizzare tutte le organizzazioni. Tuttavia, in molti casi, puoi eseguire un ripristino da tali problemi seguendo pochi semplici passi. -{:shortdesc} - - -## Account non attivo -{: #ts_accnt_inactive} - -Non puoi creare un'applicazione in {{site.data.keyword.Bluemix_notm}} se il tuo account non è attivo. Per risolvere questo problema, devi contattare il team di supporto. - - - -Quando tenti di creare un'applicazione in {{site.data.keyword.Bluemix_notm}}, viene visualizzato il seguente messaggio di errore: -{: tsSymptoms} - -`BXNUI0096E: L'applicazione non è stata creata. Il tuo account non è attivo perché è stato annullato o sospeso.` - - -Lo stato del tuo account {{site.data.keyword.Bluemix_notm}} diventa inattivo quando l'account viene annullato o sospeso. -{: tsCauses} - - - -Per riattivare il tuo account, contatta il [Supporto {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixsupport.com){: new_window}. Nell'email, devi includere le seguenti informazioni: -{: tsResolve} - - * L'ID IBM utilizzato per accedere a {{site.data.keyword.Bluemix_notm}}. - * Il nome dell'organizzazione in cui verrà creata la tua applicazione. Queste informazioni consentono al team di supporto di determinare se ti sono stati assegnati i ruoli o l'appartenenza appropriati all'interno della tua organizzazione. - - - -## Nessuno spazio associato alla tua organizzazione corrente -{: #ts_no_space} - -Non puoi creare un'applicazione se non vi è alcuno spazio -associato alla tua organizzazione corrente. - - - -Quando tenti di creare un'applicazione in {{site.data.keyword.Bluemix_notm}}, viene visualizzato il seguente messaggio di errore: -{: tsSymptoms} - - -`BXNUI0097E: Prima di poter aggiungere un'applicazione, è necessario associare almeno uno spazio alla tua organizzazione e alla tua regione. Sul Dashboard, fai clic su **Crea uno spazio**. Una volta creato lo spazio, prova di nuovo. ` - - - -Le applicazioni in {{site.data.keyword.Bluemix_notm}} devono essere create all'interno di uno spazio nella tua organizzazione. -{: tsCauses} - - - -Per creare uno spazio, utilizza uno dei seguenti metodi: -{: tsResolve} - - * Sul Dashboard {{site.data.keyword.Bluemix_notm}}, seleziona l'organizzazione in cui vuoi creare lo spazio e fai quindi clic su **Crea uno spazio**. - * Nell'interfaccia riga di comando cf, immetti `cf create-space --o `. - - - - -## Le applicazioni condividono lo stesso nome di dominio -{: #ts_domain_diff} - -Potresti notare che diverse applicazioni condividono lo stesso -URL in {{site.data.keyword.Bluemix_notm}}. - - - -Questo problema potrebbe verificarsi quando assegni -la stessa rotta URL per applicazioni differenti all'interno di uno spazio. -{: tsCauses} - -Ad esempio, esegui il push dell'applicazione myApp1 a {{site.data.keyword.Bluemix_notm}} e imposti il dominio su "mynewapp.mybluemix.net". Esegui quindi il push di un'altra applicazione myApp2 allo stesso spazio e imposti una delle sue rotte URL su "mynewapp.mybluemix.net". La rotta è ora associata a entrambe le applicazioni. - - - -Questo è il funzionamento supportato da {{site.data.keyword.Bluemix_notm}} e -puoi utilizzare questa procedura affinché non si verifichino tempi di inattività -per l'aggiornamento della tua applicazione. Per ulteriori informazioni, vedi Distribuzioni Blue-Green. -{: tsResolve} - - - - - - - - -## Impossibile aggiungere la carta di credito -{: #ts_addcc} - -Non riesci a inoltrare le informazioni della tua carta di credito per convertire -il tuo account di prova in un account con pagamento a consumo. - - - -Il pulsante Inoltra nella pagina Aggiungi carta di credito è disabilitato. -{: tsSymptoms} - - - -Questo problema si verifica se le tue informazioni non sono compilate correttamente nella pagina Aggiungi carta di credito. -{: tsCauses} - - - -Per risolvere il problema, completa la seguente procedura: -{: tsResolve} - - 1. Nella pagina Aggiungi carta di credito, compila tutti i campi richiesti che si trovano nelle sezioni relative a informazioni di contatto, indirizzo di contatto e indirizzo di fatturazione. - 2. Seleziona **Ho letto e accetto i termini e le condizioni IBM** -e fai clic su **Inoltra**. Viene visualizzata la sezione **Seleziona un -metodo di pagamento**. - 3. Immetti il numero della tua carta di credito, la data di scadenza della carta -e il codice di sicurezza. Quindi, fai clic su **Inoltra**. - - - - - -# Risoluzione dei problemi relativi ai runtime -{: #runtimes} - -Potresti riscontrare dei problemi quando utilizzi i runtime IBM® Bluemix™. Tuttavia, in molti casi, puoi eseguire un ripristino da tali problemi seguendo pochi semplici passi. -{:shortdesc} - - -## Pacchetto di build obsoleto utilizzato quando viene eseguito il push di un'applicazione -{: #ts_loading_bp} - - -Potresti non essere in grado di utilizzare i componenti di pacchetti di build più recenti quando esegui il push di un'applicazione. Puoi utilizzare i pacchetti di build che hanno dei meccanismi integrati per impedire il caricamento di componenti obsoleti oppure puoi eliminare il contenuto nella directory cache della tua applicazione prima di eseguire il push o di preparare di nuovo l'applicazione. - - - -Quando esegui il push o prepari di nuovo un'applicazione -dopo l'aggiornamento del pacchetto di build, i componenti del pacchetto di build più recenti non vengono -caricati automaticamente. Di conseguenza, la tua applicazione utilizza i componenti del pacchetto di build obsoleti dalla cache. Gli aggiornamenti che -sono stati applicati al pacchetto di build dall'ultima volta che hai eseguito il push -dell'applicazione non vengono implementati. -{: tsSymptoms} - - - -Alcuni -pacchetti di build non sono configurati per scaricare automaticamente tutti -i componenti aggiornati da Internet per garantire che tu utilizzi sempre -la versione più recente. -{: tsCauses} - - - -Puoi utilizzare dei pacchetti di build che hanno dei meccanismi integrati per evitare il caricamento di componenti obsoleti. I seguenti pacchetti di build sono due esempi: -{: tsResolve} - - * [Pacchetto di build Java Cloud Foundry ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/java-buildpack){: new_window}. Questo pacchetto di build ha un meccanismo integrato per garantire che venga utilizzata la versione più recente del pacchetto di build. Per ulteriori informazioni sulla modalità di funzionamento di questo meccanismo, consulta [extending-caches.md ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/java-buildpack/blob/master/docs/extending-caches.md){: new_window}. - * [Pacchetto di build Cloud Foundry Node.js ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/nodejs-buildpack){: new_window}. Questo pacchetto di build ha una funzionalità simile all'utilizzo delle variabili di ambiente. Per abilitare il pacchetto di build Node.js a scaricare i modulo nodo da Internet ogni volta, immetti il -seguente comando nell'interfaccia riga di comando cf: - ``` - set NODE_MODULES_CACHE=false - ``` -Se il pacchetto di build che stai utilizzando non fornisce un meccanismo per caricare i componenti più recenti in modo automatico, puoi eliminare manualmente il contento nella directory cache ed eseguire nuovamente il push della tua applicazione attenendoti alla seguente procedura: - 1. Estrai mediante checkout un ramo di un pacchetto di build null, ad esempio https://github.com/ryandotsmith/null-buildpack. Per informazioni su come estrarre mediante check-out un ramo, consulta [Git Basics - Getting a Git Repository ![icona link esterno](../icons/launch-glyph.svg)](http://www.git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository){: new_window}. - 2. Aggiungi la seguente riga al file `null-buildpack/bin/compile` ed esegui il commit delle modifiche. Per informazioni su come eseguire il commit delle modifiche, consulta [Git Basics - Recording Changes to the Repository ![icona link esterno](../icons/launch-glyph.svg)](http://www.git-scm.com/book/en/v2/Git-Basics-Recording-Changes-to-the-Repository){: new_window}. - ``` - rm -rfv $2/* - ``` - 3. Esegui il push della tua applicazione con il pacchetto di build null che è stato modificato per eliminare -la cache utilizzando il seguente comando. Dopo che hai completato questo passo, tutto il contenuto nella directory -cache della tua applicazione viene eliminato. - ``` - cf push appname -p app_path -b - ``` - 4. Esegui il push della tua applicazione con il pacchetto di build più recente che vuoi utilizzare servendoti del seguente comando: - ``` - cf push appname -p app_path -b - ``` - - - - -## Messaggi NOTICE dal pacchetto di build PHP -{: #ts_phplog} - -Potresti visualizzare dei messaggi di log che contengono NOTICE. Puoi interrompere la registrazione di questi messaggi modificando il -livello di registrazione. - - - -Quando distribuisci un'applicazione a Bluemix utilizzando un pacchetto di build PHP, potresti visualizzare dei messaggi che contengono `NOTICE`: -{: tsSymptoms} - -``` -• 2015-01-26T15:00:59.70+0100 [App/0] ERR [26-Jan-2015 14:00:59] NOTICE: [pool www] 'user' directive is ignored when FPM is not running as root -• 2015-01-26T15:01:00.63+0100 [App/0] ERR [26-Jan-2015 14:00:59] NOTICE: [pool www] 'user' directive is ignored when FPM is not running as root -• 2015-01-26T15:01:00.63+0100 [App/0] ERR [26-Jan-2015 14:00:59] NOTICE: fpm is running, pid 93 -• 2015-01-26T15:01:00.63+0100 [App/0] ERR [26-Jan-2015 14:00:59] NOTICE: ready to handle connections -``` - - - -Nel pacchetto di build PHP, il parametro error_log è utilizzato per definire il livello di registrazione. Per impostazione predefinita, il valore del parametro `error_log` -è **stderr notice**. Il seguente esempio mostra la configurazione -del livello di registrazione predefinita nel file `nginx-defaults.conf` -del pacchetto di build PHP fornito da Cloud Foundry. Per ulteriori informazioni, vedi [cloudfoundry/php-buildpack ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/php-buildpack/blob/ff71ea41d00c1226d339e83cf2c7d6dda6c590ef/defaults/config/nginx/1.5.x/nginx-defaults.conf){: new_window}. -{: tsCauses} - -``` -daemon off; -error_log stderr notice; -pid @{HOME}/nginx/logs/nginx.pid; -``` - - - -I messaggi `NOTICE` sono informativi e non -indicano necessariamente che si è verificato un problema. Puoi interrompere la registrazione di questi messaggi modificando il livello di registrazione da stderr notice a stderr error nel file nginx-defaults.conf del tuo pacchetto di build. Ad -esempio: -{: tsResolve} - -``` -daemon off; -error_log stderr error; -pid @{HOME}/nginx/logs/nginx.pid; -``` -Per ulteriori informazioni su come modificare la configurazione di registrazione predefinita, vedi [error_log ![icona link esterno](../icons/launch-glyph.svg)](http://nginx.org/en/docs/ngx_core_module.html#error_log){: new_window}. - - -## Impossibile importare una libreria Python di terze parti in {{site.data.keyword.Bluemix_notm}} -{: #ts_importpylib} - -Potresti non riuscire a importare una libreria Python di terze parti -in {{site.data.keyword.Bluemix_notm}}. Puoi risolvere il problema aggiungendo file di configurazione nella directory -root della tua applicazione Python. - - -Quando tenti di importare una libreria Python di terze parti, come -la libreria `web.py`, il comando `cf push` -non riesce. -{: tsSymptoms} - - - - -Questo problema si verifica quando mancano delle informazioni di configurazione -per l'applicazione Python. -{: tsCauses} - - - - -Per risolvere il problema, aggiungi un file `requirements.txt` e un file `Procfile` nella directory root della tua applicazione Python. Le seguenti informazioni presumono che tu stia importando la libreria web.py: -{: tsResolve} - - 1. Aggiungi un file `requirements.txt` nella directory root della tua applicazione Python. - Il file `requirements.txt` specifica i pacchetti di libreria richiesti per l'applicazione Python e la versione dei pacchetti. Il seguente esempio mostra il contenuto del file `requirements.txt`, dove `web.py==0.37` indica -che la versione della libreria `web.py` che verrà scaricata è la 0.37 e `wsgiref==0.1.2` indica che la versione dell'interfaccia gateway del server Web richiesta dalla libreria web.py è la 0.1.2. - ``` - web.py==0.37 - wsgiref==0.1.2 - ``` - Per ulteriori informazioni su come configurare -il file `requirements.txt`, vedi [Requirements files](https://pip.readthedocs.org/en/1.1/requirements.html). - - 2. Aggiungi un file `Procfile` nella directory root -della tua applicazione Python. - Il file `Procfile` -deve contenere il comando di avvio per la tua applicazione Python. Nel seguente comando, *ilnomedellatuaapplicazione* è il nome della tua applicazione Python e *PORT* è il numero di porta che l'applicazione Python dovrà utilizzare per ricevere le richieste dagli utenti dell'applicazione. *$PORT* è facoltativo. Se non specifichi una PORTA nel comando di avvio, verrà utilizzato -il numero di porta indicato nella variabile di ambiente `VCAP_APP_PORT` che si trova all'interno dell'applicazione. - ``` - web: python .py $PORT - ``` -Adesso, puoi importare la libreria Python di terze parti -in {{site.data.keyword.Bluemix_notm}}. - - - -## Il pulsante Azioni nella pagina Dettagli istanza è disabilitato -{: #ts_actionsbutton} - - - -Il pulsante Azioni nella pagina Dettagli istanza è disabilitato. -{: tsSymptoms} - - - -Questo problema si verifica a causa dei seguenti motivi: -{: tsCauses} - - * L'applicazione non è un'applicazione web Java™. RMU (Runtime Management Utilities) supporta solo le applicazioni -Web distribuite con i pacchetti di build Liberty. - * L'applicazione non viene distribuita con il pacchetto di build Liberty integrato. - * L'applicazione è stata distribuita con una versione precedente del pacchetto di build -Liberty. - - - -Se il problema è causato da una versione precedente del pacchetto di build Liberty, ridistribuisci l'applicazione in {{site.data.keyword.Bluemix_notm}}. In caso contrario, puoi -fornire i seguenti file di log dell'applicazione client al team -di supporto: -{: tsResolve} - - * logs/messages.log - * logs/stdout.log - * logs/stderr.log - - - - -## Credenziali richieste all'apertura della finestra di traccia o di dump -{: #ts_username} - - - - -Vengono richiesti un nome utente e una password quando si apre la finestra di traccia -e di dump. -{: tsSymptoms} - - - -Questo problema si verifica a causa del timeout della sessione di accesso. -{: tsCauses} - - - -La soluzione consiste nell'immettere nuovamente il nome utente e la password. -{: tsResolve} - - - - -## Si verifica un errore durante l'esecuzione delle operazioni di traccia o di dump -{: #ts_target} - - - -Viene visualizzato un messaggio di errore mentre le operazioni di -traccia o di dump sono in esecuzione. Il messaggio indica che un'istanza di destinazione -per un'applicazione non si trova nello stato di In esecuzione: -{: tsSymptoms} - -``` -Istanza 0: La specifica di traccia è stata impostata correttamente -Istanza 2: La specifica di traccia è stata impostata correttamente -Istanza 1: L'istanza di destinazione 1 per l'applicazione abcd non si trova nello stato di In esecuzione. -Istanza 3: La specifica di traccia è stata impostata correttamente -Istanza 4: La specifica di traccia è stata impostata correttamente -``` - - - -Questo problema si verifica a causa dei seguenti motivi: -{: tsCauses} - - * Le capacità di gestione della traccia o del dump riguardano solo le istanze dell'applicazione -che sono in esecuzione. Le operazioni di traccia o di dump non possono essere utilizzate -su istanze dell'applicazione arrestate, in fase di avvio o bloccate. - * Lo stato dell'istanza dell'applicazione cambia quando si apre la finestra di dialogo della traccia o -del dump. - - - -La soluzione consiste nel chiudere la finestra, e quindi -riaprirla. -{: tsResolve} - - - -## Le istanza hanno una configurazione traceSpecification differente -{: #ts_different_config} - - - -Per diverse istanze di un'applicazione, potresti vedere una configurazione traceSpecification differente. -{: tsSymptoms} - - - -Questo problema si verifica a causa dei seguenti motivi: -{: tsCauses} - - * Potresti aver modificato la configurazione per una o più istanze, precedentemente. Se modifichi la configurazione traceSpecification per una istanza, essa non si applica ad altre istanze della stessa applicazione. Ad esempio, la tua applicazione utilizza log4j e hai 2 istanze per questa applicazione. Puoi modificare il livello di log dell'istanza 0 da info a debug ma il livello di log dell'istanza 1 rimane info. - * Viene eseguito un ridimensionamento incrementale dell'applicazione, che presenta delle nuove istanze. RMU non applica la configurazione traceSpecification dell'istanza esistente alla nuova istanza di cui è stato eseguito il ridimensionamento incrementale. La nuova istanza utilizza la configurazione predefinita. Ad esempio, la tua applicazione utilizza log4j e ha una istanza. Puoi modificare il livello di log di questa istanza da info a debug. Dopo che hai apportato questo modifica, se esegui il ridimensionamento incrementale della tua applicazione in due istanze, il livello di log della nuova istanza è info, invece di debug. - - - -Questo è il comportamento previsto. -{: tsResolve} - - - - - -## Quota disco superata -{: #ts_diskquota} - -Nel log dell'applicazione, potresti notare che la quota del disco è stata superata. - - - -Nel log della tua applicazione vedi il messaggio di errore `Disk quota exceeded`. -{: tsSymptoms} - - - -Questo problema è causato da uno dei seguenti motivi: -{: tsCauses} - - * I file di dump vengono generati con le istanze dell'applicazione in esecuzione -e i file utilizzano la quota di disco assegnata. Per impostazione predefinita, la quota del disco -per un'istanza dell'applicazione è di 1 GB. Puoi controllare l'utilizzo del -disco facendo clic su **Dashboard>Applicazione>Runtime applicazione**. Il seguente esempio mostra le informazioni di runtime, -incluso l'utilizzo del disco, per due istanze di un'applicazione: - ``` - Instance State CPU Memory Usage Disk Usage - - 0 Running 1.0% 344.8MB/512MB 236.8MB/1GB - 2 Running 2.3% 361.2MB/512MB 235.7MB/1GB - ``` - * La quota del disco è limitata dalla quota dell'organizzazione corrente. - - - - -Puoi risolvere il problema utilizzando uno dei seguenti -metodi: -{: tsResolve} - - * Elimina i file di dump dopo averli scaricati. - * Ridistribuisci l'applicazione con una quota di disco maggiore includendo -la seguente voce nel manifest di distribuzione: - ``` - disk_quota: 2048 - ``` - - - - +--- + +copyright: + years: 2015, 2017 + +lastupdated: "2017-01-11" + + +--- + +{:tsSymptoms: .tsSymptoms} +{:tsCauses: .tsCauses} +{:tsResolve: .tsResolve} +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} +{:codeblock: .codeblock} + +# Risoluzione dei problemi di accesso a {{site.data.keyword.Bluemix_notm}} +{: #accessing} + + + +I problemi generali con l'accesso a {{site.data.keyword.Bluemix}} potrebbero includere un utente che non riesce ad accedere a {{site.data.keyword.Bluemix_notm}}, un account bloccato in uno stato In sospeso e così via. Tuttavia, in molti casi, puoi eseguire un ripristino da tali problemi seguendo pochi semplici passi. +{:shortdesc} + +## Impossibile accedere a {{site.data.keyword.Bluemix_notm}} +{: #ts_logintobm} + +Per accedere a {{site.data.keyword.Bluemix_notm}}, devi disporre di un ID IBM e password validi. + + +Quando tenti di accedere a {{site.data.keyword.Bluemix_notm}}, visualizzi il seguente messaggio di errore: +{: tsSymptoms} + +`La password immessa non è corretta.` + + +L'ID IBM e password da te utilizzati per accedere a {{site.data.keyword.Bluemix_notm}} non sono validi. +{: tsCauses} + + +Per ottenere un ID IBM e una password validi, vai alla pagina Il mio profilo IBM e completa una della seguenti procedure: +{: tsResolve} + * Se già hai registrato un ID IBM e vuoi controllare se il tuo ID e la tua password sono validi, fai clic su **Accedi** e immetti il tuo ID IBM e la relativa password nella pagina di accesso. Se hai dimenticato la password, fai clic su **Password dimenticata** per reimpostarla. Se hai dimenticato il tuo ID IBM o continui ad avere problemi con la tua password, contatta l'Help Desk Worldwide IBM Registration per ottenere assistenza. + * Se non hai un ID IBM, fai clic su **Registrati** per registrare un ID IBM e password. + +**Nota:** per i dipendenti IBM, l'ID IBM potrebbe essere diverso dall'ID di accesso Intranet. + + + + + +## Sono presenti modifiche non salvate +{: #ts_unsaved_changes} + + +Quando navighi nella pagina dei dettagli dell'applicazione, potresti non riuscire ad eseguire delle azioni ed è possibile che ti venga richiesto di salvare le modifiche prima di continuare. + + +Quanto tenti di controllare la tua applicazione o i tuoi servizi nella pagina dei dettagli dell'applicazione, continui a visualizzare il seguente messaggio di errore: +{: tsSymptoms} + +`Sono presenti modifiche non salvate nella pagina nomeapplicazione. Salva o annulla le modifiche.` + + +Quando passi il mouse sul campo **ISTANZE** o **QUOTA DI MEMORIA** nel riquadro del runtime, i valori cambiano. Questo è il funzionamento previsto; tuttavia, il messaggio di errore di richiede di salvare le impostazioni della memoria o dell'istanza prima di uscire dalla pagina. +{: tsCauses} + + +Chiudi la finestra del messaggio, quindi fai clic sul pulsante **REIMPOSTA** nel riquadro del runtime. +{: tsResolve} + + + + + + +## Il failover automatico tra le regioni {{site.data.keyword.Bluemix_notm}} non è disponibile +{: #ts_failover} + +Non riesci a utilizzare il failover automatico tra le regioni {{site.data.keyword.Bluemix_notm}}. Tuttavia, come soluzione alternativa, puoi utilizzare un provider DNS che supporti il failover tra più indirizzi IP. + + +Quando una regione {{site.data.keyword.Bluemix_notm}} diventa non disponibile, anche le applicazioni in esecuzione in tale regione non saranno più disponibili, anche se le stesse applicazioni sono in esecuzione in un'altra regione {{site.data.keyword.Bluemix_notm}}. +{: tsSymptoms} + + +{{site.data.keyword.Bluemix_notm}} non fornisce ancora il failover automatico da una regione all'altra. +{: tsCauses} + + +Puoi utilizzare un provider DNS che supporti il failover intelligente tra più indirizzi IP e configurare manualmente le tue impostazioni +DNS per abilitare il failover automatico tra le regioni {{site.data.keyword.Bluemix_notm}}. I provider DNS con questa capacità comprendono NSONE, Akamai, Dyn. +{: tsResolve} + +Quando configuri le tue impostazioni DNS, devi specificare gli indirizzi IP pubblici delle regioni {{site.data.keyword.Bluemix_notm}} in cui sono esecuzione le tue applicazioni. Per ottenere l'indirizzo IP pubblico +di una regione {{site.data.keyword.Bluemix_notm}}, +usa il comando `nslookup`. Ad esempio, puoi immettere +il seguente comando in una finestra della riga di comando: +``` +nslookup mybluemix.net +``` + + + +## L'account è in sospeso +{: #ts_accntpding} + +Se il tuo account è in sospeso, non puoi accedere a {{site.data.keyword.Bluemix_notm}}. + + +Dopo aver eseguito la registrazione per un account di prova {{site.data.keyword.Bluemix_notm}}, +potresti non riuscire ad accedere a {{site.data.keyword.Bluemix_notm}}. Invece, visualizzi il seguente messaggio: +{: tsSymptoms} + +Your account is pending. Please wait up to 24 hours for email confirmation and also check your +spam folder. If you still have not received your email confirmation, contact Bluemix Support External link icon. + + +Dopo aver eseguito la registrazione per un account di prova {{site.data.keyword.Bluemix_notm}}, +riceverai un'e-mail di conferma. Dovrai fare clic sul link +che si trova nella email di conferma per completare il processo di registrazione. +{: tsCauses} + +L'e-mail di conferma viene inviata all'indirizzo di posta +da te fornito. Controlla la cartella della posta in arrivo e quella della posta indesiderata. Se non hai ricevuto un'e-mail di conferma, contatta il [{{site.data.keyword.Bluemix_notm}} Supporto ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixsupport.com){: new_window}. +{: tsResolve} + + + +## Impossibile aggiungere utenti a un'organizzazione +{: #ts_adduser} + +Puoi invitare più di un utente a lavorare nella stessa organizzazione. Puoi invitare utenti nella tua organizzazione solo +se sei il proprietario dell'account o se sei allo stesso tempo un gestore e un membro dell'organizzazione. + + +Non riesci a visualizzare il link **Invita un nuovo utente** +nella sezione **Gestisci organizzazioni**. +{: tsSymptoms} + + + +Solo i seguenti utenti {{site.data.keyword.Bluemix_notm}} +possono invitare gli utenti in un'organizzazione: +{: tsCauses} + * Il proprietario dell'account dell'organizzazione + * I gestori dell'organizzazione che sono anche membri, e non collaboratori, +dell'organizzazione + +In {{site.data.keyword.Bluemix_notm}}, +puoi essere un membro o un collaboratore di un'organizzazione. + +
      Collaboratore
      +
      Sei un collaboratore di un'organizzazione se disponi già +di un account {{site.data.keyword.Bluemix_notm}} +e qualcun altro ti invita nell'organizzazione.
      +
      Membro
      +
      Sei membro di un'organizzazione se non disponi di un account {{site.data.keyword.Bluemix_notm}}, +ma poi qualcuno ti invita nell'organizzazione e ti registri a {{site.data.keyword.Bluemix_notm}} +tramite l'invito.
      +
      + + +Non puoi invitare utenti nella tua organizzazione se sei +un collaboratore, anche se ti è stato assegnato il ruolo di +gestore organizzazione. + +**Nota:** tutti i gestori organizzazione, compresi quelli che sono collaboratori di un'organizzazione, possono aggiungere, modificare e rimuovere gli utenti già presenti nell'organizzazione. + + + +Se non riesci a inviare utenti nella tua organizzazione e per farlo +hai bisogno di un ruolo differente, contatta il gestore della tua organizzazione +per modificare il tuo ruolo. Per identificare il gestore della tua organizzazione, completa +la seguente procedura: +{: tsResolve} + + 1. Vai al Dashboard {{site.data.keyword.Bluemix_notm}}, fai clic sull'icona {{site.data.keyword.avatar}} ![icona Avatar](images/account_support.svg) nella barra dei menu e seleziona **Gestisci organizzazioni**. + 2. Vai alla tua organizzazione e visualizza le informazioni del gestore organizzazione +sulla scheda **UTENTI**. + +Se non riesci a invitare utenti perché sei un collaboratore e non +un membro, devi eliminare il tuo account {{site.data.keyword.Bluemix_notm}} precedente +ed essere inviato a entrare a far parte dell'account come membro dell'organizzazione. Per eliminare il tuo account precedente ed entrare a far parte dell'account come membro, +completa la seguente procedura: + + 1. Contatta il [{{site.data.keyword.Bluemix_notm}} Supporto ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixsupport){: new_window} per aprire un ticket di supporto e richiedere l'eliminazione del tuo account. Se hai dei dati associati al tuo +account precedente che vuoi salvare e passare al nuovo account, +includi queste informazioni nell'email. + 2. Una volta eliminato il tuo account, fa sì che un utente con il ruolo di gestore +organizzazione ti inviti nell'organizzazione come gestore. Utilizza quindi l'invito per registrarti in +{{site.data.keyword.Bluemix_notm}}. + + + + +## La registrazione batch degli utenti non è supportata +{: #ts_batchregistration} + +Quando +registri gli utenti per {{site.data.keyword.Bluemix_notm}}, +devi registrare ciascun utente singolarmente. + + +{{site.data.keyword.Bluemix_notm}} non +fornisce la capacità di registrare più utenti +contemporaneamente. +{: tsSymptoms} + + +{{site.data.keyword.Bluemix_notm}} non +supporta la registra batch di utenti. Per registrare gli utenti per {{site.data.keyword.Bluemix_notm}}, +devi registrare ciascun utente singolarmente. +{: tsCauses} + + +Per registrare più utenti per {{site.data.keyword.Bluemix_notm}}, +devi completare la seguente procedura per ogni utente: +{: tsResolve} + + 1. Fai clic su **ESEGUI REGISTRAZIONE** nell'interfaccia utente {{site.data.keyword.Bluemix_notm}}. + 2. Completa i passi seguendo la procedura guidata. + + + +## Impossibile caricare una pagina +{{site.data.keyword.Bluemix_notm}} +{: #ts_err} + +Durante l'utilizzo dell'interfaccia utente {{site.data.keyword.Bluemix_notm}}, +potresti non riuscire a caricare una pagina {{site.data.keyword.Bluemix_notm}}. Potresti visualizzare invece i messaggi di errore BXNUI0001E o BXNUI0016E. + + +Quando utilizzi l'interfaccia utente +{{site.data.keyword.Bluemix_notm}}, potresti visualizzare +uno dei seguenti messaggi di errore: +{: tsSymptoms} + +`BXNUI0001E: La pagina non è stata caricata perché Bluemix non ha rilevato se esiste una sessione.` + + +`BXNUI0016E: Le applicazioni e i servizi non sono stati recuperati perché una pagina di Bluemix non è stata caricata.` + + + +Puoi completare una o più delle seguenti azioni, +secondo necessità: +{: tsResolve} + + * Aggiorna o riavvia il tuo browser. + * Disconnettiti da {{site.data.keyword.Bluemix_notm}} e +riesegui l'accesso. + * Utilizza la modalità di navigazione privata del tuo browser. + * Cancella i cookie e la cache del browser. + * Utilizza un browser differente. Per informazioni sulle versioni dei browser supportati da {{site.data.keyword.Bluemix_notm}}, consulta [Prerequisiti di {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](https://developer.ibm.com/bluemix/support/#prereqs){: new_window}. + * Se hai installato l'interfaccia riga di comando cf, immetti il comando `cf +apps` per vedere se l'applicazione è in esecuzione. + + + + + + + + +# Risoluzione dei problemi relativi alla gestione delle applicazioni +{: #managingapps} + +I problemi generali con la gestione delle applicazioni potrebbero includere +applicazioni che non possono essere aggiornate o caratteri double-byte che non vengono visualizzati. Tuttavia, in molti casi, puoi eseguire un ripristino da tali problemi seguendo pochi semplici passi. +{:shortdesc} + + + + + +## Impossibile passare le applicazioni alla modalità di debug +{: #ts_debug} + +Potresti non essere in grado di abilitare la modalità di debug se la versione della JVM (Java virtual machine) è 8 o precedente. + + +Dopo che hai selezionato **Enable application debug**, gli strumenti tentano di passare l'applicazione alla modalità di debug. Quindi, il workbench di Eclipse avvia una sessione di debug. Quando gli strumenti hanno abilitato correttamente la modalità di debug, lo stato dell'applicazione web visualizza `Updating mode`, `Developing` e `Debugging`. +{: tsSymptoms} + +Tuttavia, quando gli strumenti non riescono ad abilitare la modalità di debug, lo stato dell'applicazione web visualizza solo `Updating mode` e `Developing` e non visualizza `Debugging`. Gli strumenti visualizzano inoltre il seguente messaggio di errore nella vista Console: + +``` +bluemixMgmgClient - ???? [pool-1-thread-1] .... ERROR --- ClientProxyImpl: Cannot create the websocket connections for MyWebProj +com.ibm.ws.cloudoe.management.client.exception.ApplicationManagementException: javax.websocket.DeploymentException: The HTTP request to initiate the WebSocket connection failed +at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl.onNewClientSocket(ClientProxyImpl.java:161) +at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl$RunServerTask.run(ClientProxyImpl.java:267) +at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:522) +at java.util.concurrent.FutureTask.run(FutureTask.java:277) +at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1153) +at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628) +at java.lang.Thread.run(Thread.java:785) +Caused by: javax.websocket.DeploymentException: The HTTP request to initiate the WebSocket connection failed +at org.apache.tomcat.websocket.WsWebSocketContainer.connectToServer(WsWebSocketContainer.java:315) +at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl.onNewClientSocket(ClientProxyImpl.java:158) +... 6 more +Caused by: java.util.concurrent.TimeoutException +at org.apache.tomcat.websocket.AsyncChannelWrapperSecure$WrapperFuture.get(AsyncChannelWrapperSecure.java:505) +at org.apache.tomcat.websocket.WsWebSocketContainer.processResponse(WsWebSocketContainer.java:542) +at org.apache.tomcat.websocket.WsWebSocketContainer.connectToServer(WsWebSocketContainer.java:296) +... 7 more +[2016-01-15 13:33:51.075] bluemixMgmgClient - ???? [pool-1-thread-1] .... ERROR --- ClientProxyImpl: Cannot create the websocket connections for MyWebProj +com.ibm.ws.cloudoe.management.client.exception.ApplicationManagementException: javax.websocket.DeploymentException: The HTTP request to initiate the WebSocket connection failed +at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl.onNewClientSocket(ClientProxyImpl.java:161) +at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl$RunServerTask.run(ClientProxyImpl.java:267) +at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:522) +at java.util.concurrent.FutureTask.run(FutureTask.java:277) +at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1153) +at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628) +at java.lang.Thread.run(Thread.java:785) +Caused by: javax.websocket.DeploymentException: The HTTP request to initiate the WebSocket connection failed +at org.apache.tomcat.websocket.WsWebSocketContainer.connectToServer(WsWebSocketContainer.java:315) +at com.ibm.ws.cloudoe.management.client.impl.ClientProxyImpl.onNewClientSocket(ClientProxyImpl.java:158) +... 6 more +Caused by: java.util.concurrent.TimeoutException +at org.apache.tomcat.websocket.AsyncChannelWrapperSecure$WrapperFuture.get(AsyncChannelWrapperSecure.java:505) +at org.apache.tomcat.websocket.WsWebSocketContainer.processResponse(WsWebSocketContainer.java:542) +at org.apache.tomcat.websocket.WsWebSocketContainer.connectToServer(WsWebSocketContainer.java:296) +... 7 more +``` + + +Le seguenti versioni della JVM (Java virtual machine) non possono stabilire una sessione di debug: IBM JVM 7, IBM JVM 8 e versioni precedenti di Oracle JVM 8. +{: tsCauses} + +Se il tuo workbench JVM è di una di queste versioni, potresti avere problemi durante la creazione di una sessione di debug. La versione JVM del workbench è normalmente la JVM di sistema del tuo computer locale. La tua JVM di sistema non è la stessa della tua applicazione Java Bluemix in esecuzione. L'applicazione Java Bluemix viene quasi sempre eseguita su JVM IBM e alcune volte su JVM OpenJDK. + + +Per controllare la versione di Java che segue IBM Eclipse Tools for Bluemix, completa la seguente procedura: +{: tsResolve} + + 1. In IBM Eclipse Tools for Bluemix, seleziona **Guida** > **Informazioni su Eclipse** > **Dettagli dell'installazione** > **Configurazione**. + 2. Trova la proprietà `eclipse.vm` dall'elenco. La seguente linea è un esempio di una proprietà `eclipse.vm`: + + ``` + eclipse.vm=C:\Program Files\IBM\ibm-java-sdk-80-win-x86_64\bin\..\jre\bin\j9vm\jvm.dll + ``` + + 3. Nella riga di comando, immetti `java -version` dalla directory `bin` della tua installazione Java. Vengono visualizzate le informazioni sulla tua versione Java IBM. + +Se il JVM workbench JVM è IBM JVM 7 o 8 o una versione precedente di Oracle JVM 8, completa la seguente procedura per passare a Oracle JVM 8: + + 1. Scarica e installa Oracle JVM 8, per i dettagli consulta [Java SE Downloads ![icona link esterno](../icons/launch-glyph.svg)](http://www.oracle.com/technetwork/java/javase/downloads/index.html){: new_window}. + 2. Riavvia Eclipse. + 3. Controlla se la proprietà `eclipse.vm` punta alla tua nuova installazione di Oracle JVM 8. + + + +## Impossibile riutilizzare i nomi di applicazioni eliminate +{: #ts_reuse_appname} + +Dopo aver eliminato un'applicazione, puoi riutilizzarne il nome solo dopo aver eliminato la rotta dell'applicazione. + +Quando tenti di riutilizzare il nome applicazione, ricevi il seguente messaggio: +{: tsSymptoms} + +`Il nome è già utilizzato da un'altra applicazione.` + +Quando si elimina un'applicazione, la sua rotta, ossia l'URL dell'applicazione, non viene eliminata automaticamente. Pertanto, non è disponibile per il riutilizzo. Per poterlo riutilizzare, devi accedere allo spazio in cui è stata creata l'applicazione per eliminare la rotta. +{: tsCauses} + +Per eliminare la rotta non utilizzata, effettua la seguente procedura: +{: tsResolve} + + 1. Controlla se la rotta appartiene allo spazio corrente immettendo il seguente comando: + ``` + cf routes + ``` + 2. Se la rotta non appartiene allo spazio corrente, passa allo spazio o all'organizzazione a cui appartiene immettendo il seguente comando: + ``` + cf target -o org_name -s space_name + ``` + 3. Elimina la rotta dell'applicazione immettendo il seguente comando: + ``` + cf delete-route domain_name -n host_name + ``` + Ad +esempio: + ``` + cf delete-route mybluemix.net -n app001 + ``` + + + + + + + + +## Impossibile richiamare gli spazi in un'organizzazione +{: #ts_retrieve_space} + +Non puoi creare un'applicazione o un servizio se la tua organizzazione corrente non dispone di uno spazio associato ad essa. + +Quando tenti di creare un'applicazione in Bluemix, viene visualizzato il seguente messaggio di errore: +{: tsSymptoms} + +`BXNUI0515E: il tentativo di richiamare gli spazi nell'organizzazione non è riuscito a causa di un problema nella connessione di rete.` + +Questo errore spesso viene ricevuto la prima volta che si tenta di creare un'applicazione o un servizio dal catalogo quando ancora non è stato creato uno spazio. +{: tsCauses} + +Assicurati di aver creato uno spazio nella tua organizzazione corrente. Per creare uno spazio, utilizza uno dei seguenti metodi: +{: tsResolve} + + * Fai clic sull'icona {{site.data.keyword.avatar}} ![icona Avatar](images/account_support.svg) per aprire il widget Account e supporto, seleziona l'organizzazione in cui vuoi creare lo spazio e fai clic su **Crea uno spazio**. + * Nell'interfaccia riga di comando cf, immetti `cf create-space +-o `. + +Riprova. Se vedi di nuovo questo messaggio, vai alla pagina sugli [stati di Bluemix ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixstatus){: new_window} per controllare se un servizio o un componente ha qualche problema. + + + + +## Impossibile effettuare le azioni richieste +{: #ts_authority} + +Potresti non riuscire a completare delle azioni senza un'appropriata autorità di accesso. + + + +Quando tenti di eseguire azioni per un'istanza del servizio o un'istanza dell'applicazione, non riesci a completare le azioni richieste e visualizzai uno dei seguenti messaggi di errore: +{: tsSymptoms} + +`BXNUI0514E: You are not a developer for any of the spaces in the organization.` + + +`Server error, status code: 403, error code: 10003, message: You are not authorized to perform the requested action.` + + + +Non disponi di un adeguato livello di autorità necessario per eseguire le azioni. +{: tsCauses} + + + +Per ottenere il livello di autorità appropriato, utilizza uno dei seguenti metodi: +{: tsResolve} + * Seleziona un'altra organizzazione e uno spazio per cui disponi del ruolo di sviluppatore. + * Chiedi al gestore organizzazione di modificare il tuo ruolo in sviluppatore oppure di creare uno spazio e assegnarti quindi un ruolo sviluppatore. Consulta [Gestione di organizzazioni e spazi](/docs/admin/orgs_spaces.html) per i dettagli. + + + + + +## Impossibile accedere ai servizi {{site.data.keyword.Bluemix_notm}} a causa di errori di autorizzazione +{: #ts_vcap} + +Gli errori di autorizzazione potrebbero verificarsi quando la tua applicazione accede a un servizio {{site.data.keyword.Bluemix_notm}} se le credenziali del servizio sono hardcoded nell'applicazione. + +Dopo aver configurato l'applicazione per comunicare con un servizio {{site.data.keyword.Bluemix_notm}}, distribuisci l'applicazione a {{site.data.keyword.Bluemix_notm}}. Tuttavia, non riesci a utilizzare l'applicazione per accedere al servizio {{site.data.keyword.Bluemix_notm}} e ricevi un messaggio di errore. +{: tsSymptoms} + +Le credenziali hardcoded nell'applicazione potrebbero non essere corrette. Ogni volta che il servizio viene ricreato, le credenziali per accedervi cambiano. +{: tsCauses} + + +Invece di impostare come hardcoded le credenziali nella tua applicazione, utilizza i parametri di connessione dalla variabile di ambiente VCAP_SERVICES. I metodi per utilizzare i parametri di connessione dalla variabile di ambiente VCAP_SERVICES variano a seconda dei linguaggi di programmazione. Ad esempio, per le applicazioni Node.js, puoi utilizzare il seguente comando: +{: tsResolve} + +``` +process.env.VCAP_SERVICES +``` +Per ulteriori informazioni sui comandi che puoi utilizzare in altri linguaggi di programmazione, consulta [Java ![icona link esterno](../icons/launch-glyph.svg)](http://docs.run.pivotal.io/buildpacks/java/java-tips.html#env-var){: new_window} e [Ruby ![icona link esterno](../icons/launch-glyph.svg)](http://docs.run.pivotal.io/buildpacks/ruby/ruby-tips.html#env-var){: new_window}. + + + + + + + + +## Impossibile distribuire le applicazioni utilizzando IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}} +{: #ts_bm_tools_facet} + +Quando al tuo progetto Eclipse viene applicato un facet non supportato, potresti non essere in grado di distribuire le +tue applicazioni a {{site.data.keyword.Bluemix_notm}} utilizzando IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}. + + + +Puoi distribuire correttamente la tua applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando la CLI Cloud Foundry. Tuttavia, non puoi distribuire l'applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}, e vedi un messaggio di errore: `Project facet is not supported.`. Ad esempio, `Project facet Cloud Foundry Standalone Application version 1.0 is not supported.` +{: tsSymptoms} + + + +IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}} associa i progetti ai runtime {{site.data.keyword.Bluemix_notm}} in base ai facet di progetto. I facet definiscono i requisiti per i progetti Java EE in Eclipse e sono utilizzati come parte della configurazione di runtime, in modo che runtime differenti siano associati a progetti differenti. Se il facet applicato al progetto non è supportato da +IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}, potresti non essere in grado di distribuire la tua applicazione utilizzando IBM Eclipse +Tools for {{site.data.keyword.Bluemix_notm}}. +{: tsCauses} + + +Devi rimuovere il facet dal progetto Eclipse in modo da poter distribuire la tua applicazione +utilizzando IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}. +{: tsResolve} + +Per rimuovere il +facet, in IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}, fai clic su **Project>Properties>Project Facets** per il progetto. Deseleziona quindi la casella di spunta per il facet non supportato. + + + +## Ricezione di errori 502 Bad Gateway +{: #ts_502_error} + +Se ricevi degli errori 502 Bad Gateway quando interagisci +con le applicazioni su {{site.data.keyword.Bluemix_notm}}, +controlla la pagina degli stati di {{site.data.keyword.Bluemix_notm}} +ed effettua le operazioni appropriate. + + + +Ricevi dei messaggi di errore che iniziano con 502 Bad Gateway. Ad esempio, potresti vedere `502 Bad Gateway: Registered endpoint failed to handle the request.` +{: tsSymptoms} + + + +Un errore +Bad Gateway di solito si verifica quando visiti un sito Web che utilizza +un server proxy per memorizzare e inoltrare i dati dal server principale che +ospita il sito. Il server principale e il server proxy potrebbero non connettersi +correttamente, pertanto visualizzi il codice di stato HTTP 502 nella finestra del +browser. Questo codice di stato indica che il server principale del sito non ha +ricevuto l'implementazione HTTP prevista dal server +proxy. +{: tsCauses} + +Altre cause meno comuni di un errore Bad Gateway sono +interruzioni ISP (Internet Service Provider), configurazioni firewall non valide ed +errori della cache del browser. + + + +Se sospetti che un servizio {{site.data.keyword.Bluemix_notm}} sia inattivo, controlla prima la pagina [{{site.data.keyword.Bluemix_notm}} status ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixstatus){: new_window}. Come soluzione alternativa, potresti voler utilizzare questo servizio in un'altra regione +{{site.data.keyword.Bluemix_notm}}. Informazioni dettagliate sono disponibili in [Utilizzo +dei servizi in un'altra regione](/docs/services/reqnsi.html#cross_region_service). Se lo stato del servizio è normale, +prova le seguenti operazioni per risolvere il problema: +{: tsResolve} + + * Ritenta l'azione: + * Ricarica la pagina premendo F5 sulla tastiera o facendo clic sul +pulsante di aggiornamento. Se questa operazione non funziona, cancella la cache +e i cookie del tuo browser e ricarica di nuovo la pagina. + * Utilizza un browser differente. + * Riavvia il router, il modem e il computer. Il riavvio di questi +dispositivi può cancellare i diversi errori che portano all'errore 502. + * Attendi e riprova in seguito. In alcuni casi, possono verificarsi dei +problemi temporanei con il tuo provider dei servizi Internet o con i servizi {{site.data.keyword.Bluemix_notm}}. Puoi attendere finché i problemi non vengono risolti. + * Se il problema persiste, contatta il supporto {{site.data.keyword.Bluemix_notm}}. Per ulteriori informazioni, consulta [Come contattare il supporto {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](/docs/support/index.html#contacting-bluemix-support){: new_window}. + + + + +## Quota disco superata +{: #ts_disk_quota} + +Se esaurisci lo spazio su disco, puoi modificare manualmente la quota per +ottenere ulteriore spazio sul disco. + + + +Se esaurisci lo spazio su disco, potresti visualizzare un messaggio +che indica che la quota di disco è stata superata. Per risolvere il problema, +potresti aver tentato di ridimensionare la tua istanza dell'applicazione per ottenere ulteriore spazio +su disco. Ad esempio, avresti potuto eseguire il ridimensionamento da 256 MB a 1256 MB modificando +la quota di memoria nella pagina dei dettagli dell'applicazione. Tuttavia, poiché la quota di +disco è rimasta la stessa, non hai ottenuto ulteriore spazio su disco. +{: tsSymptoms} + + +La quota di disco predefinita assegnata a un'applicazione è 1 +GB. Se hai bisogno di più spazio su disco, devi specificare manualmente la +quota di disco. +{: tsCauses} + + +Utilizza uno dei seguenti metodi per specificare la quota disco. La quota di disco massima che puoi specificare è 2 GB. Se 2 GB non è ancora +sufficiente, prova un servizio esterno come [Object Store](/docs/services/ObjectStorage/index.html). +{: tsResolve} + + * Nel file manifest.yml, aggiungi la seguente voce: + ``` + disk_quota: + ``` + * Utilizza l'opzione **-k** con il comando `cf push` +quando distribuisci la tua applicazione a {{site.data.keyword.Bluemix_notm}}: + ``` + cf push appname -p app_path -k + ``` + + + +## Impossibile aggiungere il repository Git +{: #ts_cannot_addgit} + +Dopo aver creato un'applicazione sul Dashboard, fai clic sul AGGIUNGI GIT per aggiungere un repository Git, ma non riesci a continuare. + + + +Quando fai clic su **AGGIUNGI GIT**, si apre una finestra +e si verifica uno dei seguenti problemi: +{: tsSymptoms} + + * La finestra si blocca con una schermata vuota. + * Un messaggio indica che esiste un problema con i cookie di terze parti. + + + +È possibile che il tuo browser sia configurato per impedire l'impostazione +di un cookie. Tale cookie deve essere impostato dal sito di IBM® Bluemix DevOps Services nel dominio Internet hub.jazz.net all'interno del contesto della console {{site.data.keyword.Bluemix_notm}}. +{: tsCauses} + + + +Puoi risolvere questo problema in uno dei seguenti modi: +{: tsResolve} + + * Segui le istruzioni presenti nella finestra che viene visualizzata +dalla console {{site.data.keyword.Bluemix_notm}}. Fai clic sul pulsante. Si aprirà temporaneamente un'altra finestra del browser. In tale +finestra, DevOps Services imposta il cookie di autenticazione. + * In un'altra scheda del browser, vai all'indirizzo https://hub.jazz.net ed esegui l'accesso. Torna alla console {{site.data.keyword.Bluemix_notm}} +e aggiorna la pagina. Fai di nuovo clic su **AGGIUNGI GIT**. + * Modifica le impostazioni del tuo browser per abilitare i cookie di terze parti e fai di nuovo clic su AGGIUNGI GIT. Per i dettagli sulla configurazione delle impostazioni, +consulta la documentazione relativa al tuo browser: + * [Mozilla Firefox ![icona link esterno](../icons/launch-glyph.svg)](https://support.mozilla.org/en-US/kb/enable-and-disable-cookies-website-preferences#w_how-do-i-change-cookie-settings){: new_window} + * [Google Chrome ![icona link esterno](../icons/launch-glyph.svg)](https://support.google.com/chrome/answer/95647){: new_window} + * [Apple Safari ![icona link esterno](../icons/launch-glyph.svg)](https://support.apple.com/kb/PH17191){: new_window} + * [Microsoft Internet Explorer ![icona link esterno](../icons/launch-glyph.svg)](http://windows.microsoft.com/en-us/internet-explorer/delete-manage-cookies#ie=ie-11){: new_window} +Se queste soluzioni alternative non risolvono il problema, invia un'email a idslogin@jazz.net. + + + +## Le applicazioni Android non possono ricevere le notifiche di push +{: #ts_push} + +In alcune regioni in cui Google non è accessibile, le applicazioni Android +non possono ricevere le notifiche che invii tramite il servizio IBM +Push. In questo caso, puoi utilizzare servizi di terze parti come soluzione alternativa. + + + +Esegui il bind di un servizio Push per la tua applicazione Bluemix e invii un messaggio ai dispositivi registrati. Tuttavia, le applicazioni +sviluppate sulla piattaforma Android non possono ricevere le tue notifiche +in determinate regioni. +{: tsSymptoms} + + +Il servizio IBM Push utilizza il servizio GCM (Google Cloud Messaging) +per inviare notifiche alle applicazioni mobili sviluppate sulla +piattaforma Android. Per consentire alle applicazioni Android di ricevere le notifiche, +è necessario che il servizio GCM (Google Cloud Messaging) sia accessibile dalle applicazioni +mobili. Nelle regioni in cui il servizio GCM non può essere raggiunto dalle applicazioni Android, +tali applicazioni non saranno in grado di ricevere le notifiche di push. +{: tsCauses} + + +Come soluzione alternativa, utilizza servizi di terze parti che non si basano sul servizio GCM, ad esempio +[Pushy ![icona link esterno](../icons/launch-glyph.svg)](https://pushy.me){: new_window}, +[igetui ![icona link esterno](../icons/launch-glyph.svg)](http://www.getui.com/){: new_window} e +[jpush ![icona link esterno](../icons/launch-glyph.svg)](https://www.jpush.cn/){: new_window}. +{: tsResolve} + + + +## Limite dei servizi dell'organizzazione superato +{: #ts_servicelimit} + +Se utilizzi un account utente di prova, potresti non riuscire +a creare un'applicazione in {{site.data.keyword.Bluemix_notm}} se +hai superato il limite dei servizi della tua organizzazione. + + +Quando tenti di creare un'applicazione in {{site.data.keyword.Bluemix_notm}}, +visualizzi il seguente messaggio di errore: +{: tsSymptoms} + +`BXNUI2032E: La risorsa non è stata creata. Mentre Cloud Foundry veniva contattato per creare la risorsa, si è verificato un errore. Messaggio di Cloud Foundry: "È stato superato il limite +dei servizi dell'organizzazione."` + + + +Questo errore si verifica quando superi il limite per il +numero di istanze del servizio che puoi avere per l'account. Il +numero massimo di istanze di servizi per un account di prova è 10. +{: tsCauses} + + + +Elimina tutte le istanze dei servizi che non sono necessarie o rimuovi +il limite per il numero di istanze del servizio che puoi avere. +{: tsResolve} + + * Per eliminare un'istanza dei servizi, puoi utilizzare l'interfaccia utente di {{site.data.keyword.Bluemix_notm}} +o l'interfaccia riga di comando. + Per utilizzare l'interfaccia utente di {{site.data.keyword.Bluemix_notm}} +per eliminare un'istanza del servizio, completa la seguente procedura: + 1. Nel Dashboard {{site.data.keyword.Bluemix_notm}}, fai clic sul servizio che vuoi eliminare. Viene visualizzato il tile del servizio. + 2. Sul tile del servizio, fai clic sull'icona **Menu**. + 3. Fai clic su **Elimina servizio**. Dopo aver eliminato +l'istanza del servizio, ti verrà richiesto di preparare nuovamente l'applicazione +a cui era associata l'istanza del servizio. + Per utilizzare l'interfaccia riga di comando per eliminare un'istanza del +servizio, completa la seguente procedura: + 1. Annulla il bind dell'istanza del servizio da un'applicazione immettendo `cf +unbind-service `. + 2. Elimina l'istanza del servizio immettendo `cf delete-service `. + 3. Dopo aver eliminato l'istanza del servizio, potresti voler preparare nuovamente l'applicazione +a cui era associata l'istanza del servizio immettendo `cf +restage `. + * Per rimuovere il limite sul numero di istanze del servizio che puoi avere, +converti il tuo account di prova in un account a pagamento. Per informazioni su come convertire il tuo account di prova in un account a pagamento, vedi [Come modificare il tuo piano](/docs/pricing/index.html#changing). + + + +## Impossibile eseguire gli eseguibili su {{site.data.keyword.Bluemix_notm}} +{: #ts_executable} + +Potresti non riuscire ad eseguire gli eseguibili su {{site.data.keyword.Bluemix_notm}} se +tali eseguibili sono stati sviluppati e creati in un ambiente diverso. + + + +Non riesci ad eseguire gli eseguibili su {{site.data.keyword.Bluemix_notm}} quando +tali eseguibili sono stati sviluppati e creati in un ambiente diverso. +{: tsSymptoms} + + + +Se il contenuto che desideri distribuire a {{site.data.keyword.Bluemix_notm}} è +già un eseguibile, il contenuto è stato creato precedentemente e non è necessario +crearlo in {{site.data.keyword.Bluemix_notm}}. In questo caso, non è richiesto alcun pacchetto di build per l'eseguibile da eseguire +su {{site.data.keyword.Bluemix_notm}}. Tuttavia, devi indicare esplicitamente a {{site.data.keyword.Bluemix_notm}} che +non è richiesto alcun pacchetto di build. +{: tsCauses} + + + +Quando distribuisci l'eseguibile a {{site.data.keyword.Bluemix_notm}}, +devi specificare un pacchetto di build null, che indica che +non è richiesto alcun pacchetto di build. Specifica un pacchetto di build null utilizzando l'opzione **-b** +con il comando `cf push`: +{: tsResolve} + +``` +cf push appname -p -c -b +``` +Per esempio: +``` +cf push appname -p -c ./RunMeNow -b https://github.com/ryandotsmith/null-buildpack +``` + + +## Limite di memoria dell'organizzazione superato +{: #ts_outofmemory} + +Se utilizzi un account utente di prova, potresti non riuscire a distribuire un'applicazione a {{site.data.keyword.Bluemix_notm}} se hai superato il limite di memoria della tua organizzazione. Puoi +ridurre la memoria utilizzata dalle tue applicazioni o aumentare la quota di memoria +del tuo account. + + + +Quando distribuisci un'applicazione a {{site.data.keyword.Bluemix_notm}}, visualizzi il seguente messaggio di errore: +{: tsSymptoms} + +`FAILED Server error, +status code: 400, error code: 100005, message: You have exceeded your +organization's memory limit.` + + + +Questo errore si verifica quando la quantità di memoria rimanente per la tua organizzazione è inferiore alla quantità di memoria richiesta dall'applicazione che desideri distribuire. La quota massima di memoria +per un account di prova è 2 GB. +{: tsCauses} + + + +Puoi aumentare la quota di memoria del tuo account o ridurre la memoria utilizzata dalle tue applicazioni. +{: tsResolve} + + * Per aumentare la quota di memoria dell'account, +converti il tuo account di prova in un account a pagamento. Per informazioni +su come convertire il tuo account di prova in un account a pagamento, vedi [Pay +accounts](/docs/pricing/index.html#pay-accounts). + * Per ridurre la memoria utilizzata dalle tue applicazioni, utilizza l'interfaccia utente{{site.data.keyword.Bluemix_notm}} o l'interfaccia riga di comando cf. + Se utilizzi l'interfaccia utente {{site.data.keyword.Bluemix_notm}}, completa la seguente procedura: + 1. Sul Dashboard {{site.data.keyword.Bluemix_notm}}, seleziona la tua applicazione. Viene visualizzata la pagina dei dettagli dell'applicazione. + 2. Nel riquadro runtime, puoi ridurre il limite massimo di memoria o il numero di istanze dell'applicazione, o entrambi, per tua applicazione. + Se utilizzi l'interfaccia riga di comando cf, completa la seguente procedura: + 1. Verifica la quantità di memoria utilizzata per le tue applicazioni: + ``` + cf apps + ``` + Il comando cf apps elenca tutte le applicazioni che hai distribuito nel tuo spazio corrente. Viene visualizzato anche lo stato di ciascuna applicazione. + 2. Per ridurre la quantità di memoria utilizzata dalla tua applicazione, riduci il numero di istanze dell'applicazione e/o il limite massimo di memoria. + ``` + cf push -p -i -m + ``` + 3. Riavvia la tua applicazione per rendere effettive le modifiche. + + + + +## Le applicazioni non si riavviano automaticamente +{: #ts_apps_not_auto_restarted} + + +Un'applicazione non si riavvia automaticamente quando un servizio che associ mediante bind all'applicazione smette di funzionare. + + + +Quando un servizio che associ mediante bind a un'applicazione viene arrestato in modo anomalo, nell'applicazione potrebbero verificarsi dei problemi come interruzioni, eccezioni ed errori di connessione. {{site.data.keyword.Bluemix_notm}} non riavvia automaticamente l'applicazione per eseguire un ripristino da tali problemi. +{: tsSymptoms} + + + +Questo è il funzionamento progettato da Cloud Foundry. +{: tsCauses} + + + +Puoi riavviare manualmente l'applicazione immettendo il seguente comando nell'interfaccia riga di comando: +{: tsResolve} + +``` +cf push -p +``` +Inoltre, puoi codificare l'applicazione per identificare e risolvere problemi come interruzioni, eccezioni ed errori di connessione. + + + +## Le variabili definite dall'utente vengono perse dopo la distribuzione di un'applicazione +{: #ts_varsnotretained} + +Quando esegui il push di un'applicazione a {{site.data.keyword.Bluemix_notm}} da IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}, le variabili che hai specificato vengono reimpostate a meno che non salvi tali variabili nel file +manifest. + + + +Le variabili che hai specificato vengono perse in seguito all'esecuzione del push di un'applicazione a {{site.data.keyword.Bluemix_notm}} da IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}. +{: tsSymptoms} + + +Le variabili specificate vengono mantenute solo se le salvi +nel file manifest. +{: tsCauses} + + + +Quando esegui il push di un'applicazione a {{site.data.keyword.Bluemix_notm}} da IBM Eclipse Tools for {{site.data.keyword.Bluemix_notm}}, seleziona la casella di spunta **Salva nel file manifest** nella pagina Dettagli applicazione della procedura guidata Applicazione. Quindi, +le variabili che hai specificato nella +procedura guidata vengono +salvate nel file manifest della tua applicazione. La prossima volta che apri la procedura guidata, le variabili vengono visualizzate automaticamente. +{: tsResolve} + + + +## Le icone di {{site.data.keyword.Bluemix_notm}} Live +Sync non vengono visualizzate +{: #ts_llz_lkb_3r} + +Hai creato un'applicazione in IBM Bluemix DevOps Services, ma le icone IBM Bluemix Live Sync non sono visualizzate nel Web IDE. + + + +Quando modifichi un'applicazione Node.js nel DevOps Services Web IDE, le icone di le icone di live edit, riavvio rapido e debug di {{site.data.keyword.Bluemix_notm}} non vengono visualizzate. +{: tsSymptoms} + + + +Le icone non sono disponibili nei seguenti casi: +{: tsCauses} + + * Il file `manifest.yml` non è memorizzato al +livello superiore del tuo progetto. + * La tua applicazione è memorizzata in una sottodirectory anziché al livello superiore +del tuo progetto, ma il percorso della sottodirectory non è specificato +nel file `manifest.yml`. + * L'applicazione non contiene un file `package.json`. + + +Per risolvere il problema utilizza uno dei seguenti metodi: +{: tsResolve} + + * Se il file `manifest.yml` non è memorizzato al +livello superiore del tuo progetto, memorizzalo lì. + * Se la tua applicazione è memorizzata in una sottodirectory, specifica il percorso +di tale sottodirectory nel file `manifest.yml`. + ``` + path: percorso_alla_applicazione + ``` + * Crea un file `package.json` che si trovi nella stessa +directory della tua applicazione. + + + + + + + + + + +## Impossibile trovare le organizzazioni in {{site.data.keyword.Bluemix_notm}} +{: #ts_orgs} + +Potresti non riuscire a individuare la tua organizzazione in {{site.data.keyword.Bluemix_notm}} quando +lavori su una regione {{site.data.keyword.Bluemix_notm}}. + + + +Riesci ad accedere correttamente all'interfaccia utente {{site.data.keyword.Bluemix_notm}} ma non puoi distribuire le applicazioni utilizzando l'interfaccia riga di comando cf o il plug-in Eclipse. +{: tsSymptoms} + +Quando tenti di distribuire un'applicazione +a {{site.data.keyword.Bluemix_notm}} utilizzando +l'interfaccia riga di comando cf, puoi visualizzare uno dei seguenti +messaggi di errore in cui viene specificato il nome dell'organizzazione: + +`Error finding org` + +`Organization not found` + + +Quando tenti di distribuire un'applicazione a {{site.data.keyword.Bluemix_notm}} +utilizzando il plug-in Eclipse Cloud Foundry, visualizzi il seguente messaggio di +errore: + +`cloudspace not found.` + + + +Questo problema si verifica poiché l'endpoint API della regione +che vuoi utilizzare non è specificato e l'organizzazione che stai +cercando potrebbe trovarsi in una regione differente. +{: tsCauses} + + + +Se stai eseguendo il push della tua applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando l'interfaccia riga di comando cf, immetti il comando cf api e specifica l'endpoint API della regione. Ad esempio, immetti il seguente comando per stabilire una connessione alla regione {{site.data.keyword.Bluemix_notm}} Europa +Regno Unito: +{: tsResolve} + +``` +cf api https://api.eu-gb.bluemix.net +``` +Se stai distribuendo la tua applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando +gli strumenti Eclipse, devi prima creare un server {{site.data.keyword.Bluemix_notm}} +e specificare l'endpoint API della regione {{site.data.keyword.Bluemix_notm}} in +cui è stata creata la tua organizzazione. Per ulteriori informazioni sull'utilizzo di strumenti Eclipse, consulta il documento relativo alla [distribuzione di applicazioni con IBM Eclipse Tools for Bluemix](/docs/manageapps/eclipsetools/eclipsetools.html). + + + + +## Impossibile creare rotte di applicazione +{: #ts_hostistaken} + +Quando distribuisci un'applicazione a {{site.data.keyword.Bluemix_notm}}, la rotta dell'applicazione non può essere creata se il nome host da te specificato è già in uso. + + + +Quando distribuisci un'applicazione a {{site.data.keyword.Bluemix_notm}}, visualizzi il seguente messaggio di errore: +{: tsSymptoms} + +`Creating route hostname.domainname ... FAILED Server error, status code: 400, error code: 210003, message: The host is taken: hostname` + + + +Questo problema si verifica se il nome host da te specificato +è già in uso. +{: tsCauses} + + + +Il nome host specificato deve essere univoco all'interno +del dominio che stai utilizzando. Per specificare un nome host differente, usa uno dei +seguenti metodi: +{: tsResolve} + + * Se distribuisci la tua applicazione utilizzando il file `manifest.yml`, specifica il nome host nell'opzione host. + ``` + host: + ``` + * Se distribuisci la tua applicazione dal prompt dei comandi, utilizza il comando `cf +push` con l'opzione **-n**. + ``` + cf push -p -n + ``` + + +## Non è possibile distribuire delle applicazioni WAR utilizzando il comando cf push +{: #ts_cf_war} + +Potresti non riuscire a utilizzare il comando cf push per distribuire un'applicazione web archiviata a {{site.data.keyword.Bluemix_notm}} se la posizione dell'applicazione non è specificata correttamente. + + + +Quando carichi un'applicazione WAR in {{site.data.keyword.Bluemix_notm}} utilizzando il comando `cf push`, visualizzi il messaggio di errore `Staging +error: cannot get instances since staging failed.` +{: tsSymptoms} + + + +Questo problema potrebbe verificarsi se non si specifica il file WAR +o il percorso del file WAR. +{: tsCauses} + + + +Utilizza l'opzione **-p** per specificare +un file WAR o aggiungere il percorso del file WAR. Per esempio: +{: tsResolve} + +``` +cf push MyUniqueAppName01 -p app.war +``` + +``` +cf push MyUniqueAppName02 -p "./app.war" +``` +Per ulteriori informazioni sul comando `cf push` , immettere `cf push -h`. + + + + + +## I caratteri double-byte non vengono visualizzati correttamente quando si distribuiscono le applicazioni Liberty a {{site.data.keyword.Bluemix_notm}} +{: #ts_doublebytes} + +I caratteri double-byte potrebbero non essere visualizzati correttamente se il supporto Unicode non è adeguatamente configurato per i file servlet o JSP. + + + +Quando un'applicazione Liberty viene distribuita a {{site.data.keyword.Bluemix_notm}}, i caratteri double-byte specificati all'interno dell'applicazione non vengono visualizzati correttamente. +{: tsSymptoms} + + + +Il problema può verificarsi se il supporto Unicode non è configurato correttamente per i file servlet o JSP. +{: tsCauses} + + +Puoi utilizzare il seguente codice all'interno dei tuoi file servlet o JSP: +{: tsResolve} + + * Nel file di origine servlet + ``` + response.setContentType("text/html; charset=UTF-8"); + ``` + * Nel JSP + ``` + + ``` + + + + +## Impossibile distribuire le applicazioni Node.js +{: #ts_nodejs_deploy} + +Potresti riscontrare dei problemi quando aggiorni un'applicazione Node.js +o quando distribuisci un'applicazione Node.js a {{site.data.keyword.Bluemix_notm}}. + + + +Quando aggiorni un'applicazione Node.js o distribuisci la tua applicazione Node.js +a {{site.data.keyword.Bluemix_notm}}, +potresti visualizzare uno dei seguenti messaggi di errore: +{: tsSymptoms} + +`An app was not successfully detected by any available buildpack.` + + +`Instance (index 0) failed to start accepting connections.` + + +`Cannot get instances since staging failed.` + + + + +Di seguito sono indicate le possibili cause del problema: +{: tsCauses} + + * Il comando di avvio non è specificato. + * I file richiesti per distribuire un'applicazione Node.js non sono presenti +nell'applicazione o si trovano in una cartella diversa dalla directory root. + + + + +Effettua le seguenti operazioni in base alla causa del +problema: +{: tsResolve} + + * Specifica il comando di avvio utilizzando uno dei seguenti metodi: + * Utilizza l'interfaccia riga di comando cf. Per esempio: + ``` + cf push MyUniqueNodejs01 -p app_path -c "node app.js" + ``` + * Utilizza il file [package.json ![icona link esterno](../icons/launch-glyph.svg)](https://docs.npmjs.com/json){: new_window}. Per esempio: + ``` + { + ... + "scripts": { + "start": "node app.js" + } + } + ``` + * Utilizza il file `manifest.yml`. Per esempio: + ``` + applications: + name: MyUniqueNodejs01 + ... + command: node app.js + ... + ``` + + * Assicurati che nella tua applicazione Node.js sia presente un file `package.json` per consentire al pacchetto di build Node.js di riconoscere l'applicazione. Inoltre, devi inserire questo file nella directory root della tua applicazione. + Il seguente + esempio mostra un semplice file + `package.json`: + ``` + { + "name": "MyUniqueNodejs01", + "version": "0.0.1", + "description": "A sample package.json file", + "dependencies": { + "express": "3.4.x", + "jade": "1.1.x" + }, + "engines": { + "node": "0.10.x" + }, + "scripts": { + "start": "node app.js" + } + } + ``` + +Per ulteriori suggerimenti relativi alle applicazioni Node.js, vedi [Tips for Node.js Applications ![icona link esterno](../icons/launch-glyph.svg)](http://docs.cloudfoundry.org/buildpacks/node/node-tips.html){: new_window}. + + + + +## Sono presenti degli errori di configurazione nel file `server.xml` dopo che importi un'applicazione {{site.data.keyword.Bluemix_notm}} Liberty da Bluemix DevOps Services a Eclipse +{: #ts_eclipse} + +Se vedi degli errori di configurazione nel file `server.xml` dopo aver importato un'applicazione {{site.data.keyword.Bluemix_notm}} Liberty da IBM Bluemix DevOps Services a Eclipse, potresti dover rimuovere il file `server.xml` dal progetto. + + + +Dopo aver importato un'applicazione {{site.data.keyword.Bluemix_notm}} Liberty da {{site.data.keyword.Bluemix_notm}} DevOps Services in Eclipse, vedi degli errori di configurazione nel file `server.xml` dalla vista Problemi di Eclipse. +{: tsSymptoms} + + + +Il pacchetto di build Liberty utilizza il file `server.xml` per configurare l'applicazione e genera un file `runtime-vars.xml` quando viene eseguito il push dell'applicazione Liberty a {{site.data.keyword.Bluemix_notm}}. Quando importi l'applicazione in Eclipse, il file `runtime-vars.xml` non esiste nel tuo ambiente locale. +{: tsCauses} + + + +Puoi risolvere questo problema rimuovendo il file server.xml dal progetto. Il pacchetto di build crea il file `server.xml` dinamicamente quando esegui il push dell'applicazione come un'applicazione WAR. Per ulteriori informazioni, consulta [Liberty for Java](/docs/runtimes/liberty/index.html). +{: tsResolve} + + +## Impossibile preparare l'applicazione utilizzando i pacchetti di build personalizzati +{: #ts_bp_compilation} + +Potresti non riuscire a distribuire un'applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando un pacchetto di build personalizzato se gli script all'interno del pacchetto di build non sono eseguibili. + + + +Quando distribuisci un'applicazione a {{site.data.keyword.Bluemix_notm}} utilizzando un pacchetto di build personalizzato, visualizzi il messaggio di errore `La preparazione dell'applicazione non è riuscita e, pertanto, non ci sono istanze da visualizzare.` +{: tsSymptoms} + + +Questo problema +potrebbe verificarsi se gli script, ad esempio lo script di rilevamento, lo script di compilazione e lo + script di rilascio, non sono eseguibili. +{: tsCauses} + + + +Puoi utilizzare il comando [git update ![icona link esterno](../icons/launch-glyph.svg)](http://git-scm.com/docs/git-update-index){: new_window} per modificare l'autorizzazione di ciascuno script in eseguibile. Ad esempio, puoi immettere `git update --chmod=+x script.sh`. +{: tsResolve} + + + +## Un'applicazione non può essere distribuita da DevOps Services a {{site.data.keyword.Bluemix_notm}} +{: #ts_devops_to_bm} + +Potresti non riuscire ad eseguire il push della tua applicazione da IBM Bluemix DevOps Services a {{site.data.keyword.Bluemix_notm}} se il file `manifest.yml` non è presente nella tua applicazione. + + + +Quando distribuisci un'applicazione da DevOps Services a {{site.data.keyword.Bluemix_notm}}, potrebbe essere visualizzato un messaggio di errore `Unable to detect a supported application type`. +{: tsSymptoms} + + + +Questo problema potrebbe verificarsi perché DevOps Services richiede un file `manifest.yml` per distribuire un'applicazione a {{site.data.keyword.Bluemix_notm}}. +{: tsCauses} + + + +Per risolvere questo problema, devi creare un file `manifest.yml`. Per ulteriori informazioni su come creare un file `manifest.yml`, +vedi [Manifest +dell'applicazione](/docs/manageapps/depapps.html#appmanifest). +{: tsResolve} + + + + + +## Impossibile distribuire le applicazioni Meteor +{: #ts_meteor} + +Potresti non riuscire a distribuire un'applicazione Meteor a {{site.data.keyword.Bluemix_notm}} se +il pacchetto di build non è specificato correttamente. + + + +Quando distribuisci un'applicazione Meteor a {{site.data.keyword.Bluemix_notm}}, potresti visualizzare il messaggio di errore `La +preparazione dell'applicazione non è riuscita e, pertanto, non ci sono istanze da visualizzare.` +{: tsSymptoms} + + +Questo problema si verifica perché non viene fornito alcun pacchetto di build integrato per le applicazioni Meteor. Devi utilizzare un pacchetto di build personalizzato. +{: tsCauses} + + + + +Per utilizzare un pacchetto di build personalizzato per le applicazioni Meteor, usa uno dei seguenti metodi: +{: tsResolve} + + * Se distribuisci la tua applicazione utilizzando il file `manifest.yml`, specifica l'URL o il nome del pacchetto di build personalizzato usando l'opzione buildpack. Per esempio: + ``` + buildpack: https://github.com/Sing-Li/bluemix-bp-meteor + ``` + * Se distribuisci la tua applicazione dal prompt dei comandi, utilizza il comando `cf +push` e specifica il pacchetto di build personalizzato usando +l'opzione **-b**. Per esempio: + ``` + cf push appname -p app_path -b https://github.com/Sing-Li/bluemix-bp-meteor + ``` + + + + +## Il pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}} +non distribuisce un'applicazione +{: #deploytobluemixbuttondoesntdeployanapp} + +Se fai clic sul pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}} +e rilevi che il repository Git non viene clonato o che l'applicazione +non viene distribuita, prova i metodi di risoluzione per i seguenti problemi. + * [Impossibile creare il progetto Bluemix DevOps Services](#project-cannot-be-created) + * [Il repository Git non viene trovato e non può essere clonato in DevOps Services](#repo-not-found) + * [Il repository Git viene clonato in DevOps Services, ma l'applicazione non viene +distribuita a {{site.data.keyword.Bluemix_notm}}](#repo-cloned-app-not-deployed) +Per ulteriori informazioni su come creare il pulsante, vedi Creazione di un pulsante Distribuisci a {{site.data.keyword.Bluemix_notm}}. + +### Impossibile creare il progetto Bluemix DevOps Services +{: #project-cannot-be-created} + +Se noti che il progetto DevOps Services non può essere creato, il tuo account {{site.data.keyword.Bluemix_notm}} potrebbe essere scaduto. + + + +Fai clic sul pulsante **Distribuisci a Bluemix**, ma il passo "Creazione del progetto" non viene completato correttamente. +{: tsSymptoms} + + +Il tuo account {{site.data.keyword.Bluemix_notm}} +potrebbe essere scaduto. +{: tsCauses} + +Per risolvere il problema utilizza uno dei seguenti metodi: +{: tsResolve} + + * Accedi a {{site.data.keyword.Bluemix_notm}} e +aggiorna le informazioni del tuo account. + * Fai di nuovo clic sul pulsante **Distribuisci a Bluemix**. + + +### Il repository Git non viene trovato e non può essere clonato in DevOps Services +{: #repo-not-found} + +Se noti che il repository Git non viene clonato, potrebbe esistere +un problema con il repository o con il frammento di pulsante. + + + +Fai clic sul pulsante **Distribuisci a Bluemix**, ma il repository Git non viene trovato e non può essere clonato in DevOps Services. Il passo "Clonazione del repository" non viene completato correttamente. Di conseguenza, l'applicazione non può essere distribuita a {{site.data.keyword.Bluemix_notm}}. +{: tsSymptoms} + +Questo problema si verifica a causa dei seguenti motivi: +{: tsCauses} + + * Il repository Git potrebbe non esistere o non essere accessibile. + * Potrebbe esistere un problema nell'HTML o markdown per il frammento di pulsante. + * Potrebbe esistere un problema in cui dei caratteri speciali, parametri di query +o frammenti nell'URL impediscono di accedere correttamente al repository +Git. + +Per risolvere il problema utilizza uno dei seguenti metodi: +{: tsResolve} + + * Verifica che il repository Git esista e sia accessibile pubblicamente +e che l'URL sia corretto. + * Verifica che il frammento non contenga errori di HTML o markdown. + * Se caratteri speciali, parametri di query o frammenti causano problemi con l'URL del repository Git, codifica l'URL nel frammento di pulsante. + + + + +### Il repository Git viene clonato in DevOps Services, ma l'applicazione non viene distribuita a {{site.data.keyword.Bluemix_notm}} +{: #repo-cloned-app-not-deployed} + +Se noti che l'applicazione non viene distribuita, potrebbero esistere +dei problemi con il codice nel repository. + + + +Fai clic sul pulsante **Distribuisci a Bluemix** e il repository Git viene clonato in DevOps Services, ma l'applicazione non viene distribuita a {{site.data.keyword.Bluemix_notm}}. Il passo "Distribuzione a Bluemix" non viene completato correttamente. +{: tsSymptoms} + +Questo problema si verifica a causa dei seguenti motivi: +{: tsCauses} + + * Nel tuo spazio {{site.data.keyword.Bluemix_notm}} potrebbe non esserci spazio sufficiente +per distribuire un'applicazione. + * Un servizio richiesto potrebbe non essere dichiarato nel file `manifest.yml`. + * Un servizio richiesto potrebbe essere dichiarato nel file `manifest.yml`, +ma il servizio si trova già nello spazio di destinazione. + * Potrebbe esistere un problema con il codice nel repository. +Per diagnosticare il problema, riesamina i log di creazione e distribuzione +dalla distribuzione: + 1. Quando il passo "Distribuzione a Bluemix" non viene completato correttamente, fai clic sul link nel precedente passo di "Configurazione della pipeline" per aprire Delivery Pipeline. + 2. Identifica la fase di creazione o distribuzione non riuscita. + 3. Nella fase non riuscita, fai clic su **Visualizza log e cronologia**. + 4. Individua il messaggio di errore. + +Per risolvere il problema utilizza uno dei seguenti metodi: +{: tsResolve} + + * Se il messaggio di errore indica che nello +spazio {{site.data.keyword.Bluemix_notm}} non vi è spazio sufficiente +per distribuire l'applicazione, mira a un altro spazio. + * Se il messaggio di errore indica che un servizio richiesto non è +dichiarato nel file `manifest.yml`, comunica al proprietario +del repository che è necessario aggiungere il servizio richiesto. + * Se il messaggio di errore indica che un servizio richiesto esiste +già nello spazio di destinazione, seleziona un spazio differente da utilizzare. + * Se il messaggio di errore indica che esiste un problema con la creazione, +correggi eventuali problemi con il codice che impediscono la creazione +dell'applicazione. Per verificare che il codice non contenga alcun problema, crea il +codice utilizzando i comandi Git: + 1. Clona il repository Git: + ``` + git clone + ``` + 2. Apri la directory dell'applicazione: + ``` + cd + ``` + 3. Crea l'applicazione: + ``` + create + ``` + 4. Se necessario, fornisci componenti aggiuntivi. + 5. Aggiungi eventuali variabili di configurazione richieste. + 6. Distribuisci il codice: + ``` + git push master + ``` + 7. Verifica che l'applicazione venga creata correttamente. + 8. Se necessario, esegui il comando di post distribuzione: + ``` + run + ``` + 9. Apri l'applicazione e verifica che funzioni correttamente: + ``` + open + ``` + +## La distribuzione di un'applicazione dalla barra di esecuzione non riesce +{: #deployinganappfromtherunbarfails} + +In questo scenario, la distribuzione non riesce indicando uno stato "non sincronizzato" di colore giallo. + +L'applicazione che stai distribuendo ha la stessa rotta di un'altra applicazione in esecuzione. Per correggere questo problema, modifica la rotta in modo che sia univoca. + +## Impossibile trovare la barra di esecuzione +{: #runbarcannotbefound} + +Se non riesci a visualizzare la barra di esecuzione in Eclipse Orion {{site.data.keyword.webide}}, si è verificato uno dei seguenti problemi: + +1. {{site.data.keyword.jazzhub}} non riesce a identificare il tuo progetto. + * Correzione: nella directory root del tuo progetto, crea un file `project.json`. +2. {{site.data.keyword.jazzhub_short}} non riesce a determinare in quale cartella si trova la tua applicazione. + * Correzione: se la tua applicazione si trova in una directory diversa dalla root del progetto, effettua una delle seguenti operazioni: + * Nella directory root del tuo progetto, crea un file `manifest.yml`. Modifica quindi il file in modo che punti alla posizione della tua applicazione, ad esempio `path: percorso_tua_applicazione` + * Sposta la tua applicazione nella directory root del tuo progetto. +3. {{site.data.keyword.jazzhub_short}} non riconosce la tua applicazione come applicazione Node.js. + * Correzione: nella cartella dell'applicazione del tuo progetto, crea un file `package.json`. + + +## L'hook GitHub non funziona +{: #githubhookisntworking} + +Se hai configurato il tuo progetto GitHub per creare link dell'elemento di lavoro quando esegui il push di commit e i link non funzionano nel modo previsto, usa la seguente procedura per trovare il problema: + +1. Nel repository GitHub, fai clic su **Impostazioni**. + ![Link alle impostazioni GitHub](images/githubSettings1_small.png) + +2. Fai clic su **Webhook & servizi**. + ![Link ai servizi e webhook GitHub](images/githubHooks1_small.png) + +3. Per visualizzare il messaggio, passa il puntatore del mouse sull'icona dello stato {{site.data.keyword.jazzhub}}. + ![Messaggio di errore sull'hook del servizio](images/troubleshoothook1_small.png) + +4. Risolvi il problema in base al messaggio GitHub. + +5. Per verificare che la correzione abbia funzionato, esegui il commit e il push di un'altra modifica o vai alla pagina del servizio per {{site.data.keyword.jazzhub_short}} e fai clic su **Verifica servizio**. + ![Pulsante Verifica servizio GitHub](images/githubTestService_small.png) + +6. Verifica che non vi siano errori controllando di nuovo l'icona dello stato. + ![Icona dello stato senza errori](images/githubResolved_small.png) + +Per ulteriori informazioni, consulta [Setting up GitHub for Bluemix DevOps Services projects ![icona link esterno](../icons/launch-glyph.svg)](https://hub.jazz.net/docs/githubhooks/){: new_window}. + + +# Risoluzione dei problemi relativi alla gestione degli account +{: #managingaccounts} + +Potrebbero verificarsi dei problemi durante la gestione del tuo account, ad esempio problemi relativi ad applicazioni differenti che condividono lo stesso nome dominio o amministratori che non riescono a visualizzare tutte le organizzazioni. Tuttavia, in molti casi, puoi eseguire un ripristino da tali problemi seguendo pochi semplici passi. +{:shortdesc} + + +## Account non attivo +{: #ts_accnt_inactive} + +Non puoi creare un'applicazione in {{site.data.keyword.Bluemix_notm}} se il tuo account non è attivo. Per risolvere questo problema, devi contattare il team di supporto. + + + +Quando tenti di creare un'applicazione in {{site.data.keyword.Bluemix_notm}}, viene visualizzato il seguente messaggio di errore: +{: tsSymptoms} + +`BXNUI0096E: L'applicazione non è stata creata. Il tuo account non è attivo perché è stato annullato o sospeso.` + + +Lo stato del tuo account {{site.data.keyword.Bluemix_notm}} diventa inattivo quando l'account viene annullato o sospeso. +{: tsCauses} + + + +Per riattivare il tuo account, contatta il [Supporto {{site.data.keyword.Bluemix_notm}} ![icona link esterno](../icons/launch-glyph.svg)](http://ibm.biz/bluemixsupport.com){: new_window}. Nell'email, devi includere le seguenti informazioni: +{: tsResolve} + + * L'ID IBM utilizzato per accedere a {{site.data.keyword.Bluemix_notm}}. + * Il nome dell'organizzazione in cui verrà creata la tua applicazione. Queste informazioni consentono al team di supporto di determinare se ti sono stati assegnati i ruoli o l'appartenenza appropriati all'interno della tua organizzazione. + + + +## Nessuno spazio associato alla tua organizzazione corrente +{: #ts_no_space} + +Non puoi creare un'applicazione se non vi è alcuno spazio +associato alla tua organizzazione corrente. + + + +Quando tenti di creare un'applicazione in {{site.data.keyword.Bluemix_notm}}, viene visualizzato il seguente messaggio di errore: +{: tsSymptoms} + + +`BXNUI0097E: Prima di poter aggiungere un'applicazione, è necessario associare almeno uno spazio alla tua organizzazione e alla tua regione. Sul Dashboard, fai clic su **Crea uno spazio**. Una volta creato lo spazio, prova di nuovo. ` + + + +Le applicazioni in {{site.data.keyword.Bluemix_notm}} devono essere create all'interno di uno spazio nella tua organizzazione. +{: tsCauses} + + + +Per creare uno spazio, utilizza uno dei seguenti metodi: +{: tsResolve} + + * Sul Dashboard {{site.data.keyword.Bluemix_notm}}, seleziona l'organizzazione in cui vuoi creare lo spazio e fai quindi clic su **Crea uno spazio**. + * Nell'interfaccia riga di comando cf, immetti `cf create-space +-o `. + + + + +## Le applicazioni condividono lo stesso nome di dominio +{: #ts_domain_diff} + +Potresti notare che diverse applicazioni condividono lo stesso +URL in {{site.data.keyword.Bluemix_notm}}. + + + +Questo problema potrebbe verificarsi quando assegni +la stessa rotta URL per applicazioni differenti all'interno di uno spazio. +{: tsCauses} + +Ad esempio, esegui il push dell'applicazione myApp1 a {{site.data.keyword.Bluemix_notm}} e imposti il dominio su "mynewapp.mybluemix.net". Esegui quindi il push di un'altra applicazione myApp2 allo stesso spazio e imposti una delle sue rotte URL su "mynewapp.mybluemix.net". La rotta è ora associata a entrambe le applicazioni. + + + +Questo è il funzionamento supportato da {{site.data.keyword.Bluemix_notm}} e +puoi utilizzare questa procedura affinché non si verifichino tempi di inattività +per l'aggiornamento della tua applicazione. Per ulteriori informazioni, vedi Distribuzioni Blue-Green. +{: tsResolve} + + + + + + + + +## Impossibile aggiungere la carta di credito +{: #ts_addcc} + +Non riesci a inoltrare le informazioni della tua carta di credito per convertire +il tuo account di prova in un account con pagamento a consumo. + + + +Il pulsante Inoltra nella pagina Aggiungi carta di credito è disabilitato. +{: tsSymptoms} + + + +Questo problema si verifica se le tue informazioni non sono compilate correttamente nella pagina Aggiungi carta di credito. +{: tsCauses} + + + +Per risolvere il problema, completa la seguente procedura: +{: tsResolve} + + 1. Nella pagina Aggiungi carta di credito, compila tutti i campi richiesti che si trovano nelle sezioni relative a informazioni di contatto, indirizzo di contatto e indirizzo di fatturazione. + 2. Seleziona **Ho letto e accetto i termini e le condizioni IBM** +e fai clic su **Inoltra**. Viene visualizzata la sezione **Seleziona un +metodo di pagamento**. + 3. Immetti il numero della tua carta di credito, la data di scadenza della carta +e il codice di sicurezza. Quindi, fai clic su **Inoltra**. + + + + + +# Risoluzione dei problemi relativi ai runtime +{: #runtimes} + +Potresti riscontrare dei problemi quando utilizzi i runtime IBM® Bluemix™. Tuttavia, in molti casi, puoi eseguire un ripristino da tali problemi seguendo pochi semplici passi. +{:shortdesc} + + +## Pacchetto di build obsoleto utilizzato quando viene eseguito il push di un'applicazione +{: #ts_loading_bp} + + +Potresti non essere in grado di utilizzare i componenti di pacchetti di build più recenti quando esegui il push di un'applicazione. Puoi utilizzare i pacchetti di build che hanno dei meccanismi integrati per impedire il caricamento di componenti obsoleti oppure puoi eliminare il contenuto nella directory cache della tua applicazione prima di eseguire il push o di preparare di nuovo l'applicazione. + + + +Quando esegui il push o prepari di nuovo un'applicazione +dopo l'aggiornamento del pacchetto di build, i componenti del pacchetto di build più recenti non vengono +caricati automaticamente. Di conseguenza, la tua applicazione utilizza i componenti del pacchetto di build obsoleti dalla cache. Gli aggiornamenti che +sono stati applicati al pacchetto di build dall'ultima volta che hai eseguito il push +dell'applicazione non vengono implementati. +{: tsSymptoms} + + + +Alcuni +pacchetti di build non sono configurati per scaricare automaticamente tutti +i componenti aggiornati da Internet per garantire che tu utilizzi sempre +la versione più recente. +{: tsCauses} + + + +Puoi utilizzare dei pacchetti di build che hanno dei meccanismi integrati per evitare il caricamento di componenti obsoleti. I seguenti pacchetti di build sono due esempi: +{: tsResolve} + + * [Pacchetto di build Java Cloud Foundry ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/java-buildpack){: new_window}. Questo pacchetto di build ha un meccanismo integrato per garantire che venga utilizzata la versione più recente del pacchetto di build. Per ulteriori informazioni sulla modalità di funzionamento di questo meccanismo, consulta [extending-caches.md ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/java-buildpack/blob/master/docs/extending-caches.md){: new_window}. + * [Pacchetto di build Cloud Foundry Node.js ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/nodejs-buildpack){: new_window}. Questo pacchetto di build ha una funzionalità simile all'utilizzo delle variabili di ambiente. Per abilitare il pacchetto di build Node.js a scaricare i modulo nodo da Internet ogni volta, immetti il +seguente comando nell'interfaccia riga di comando cf: + ``` + set NODE_MODULES_CACHE=false + ``` +Se il pacchetto di build che stai utilizzando non fornisce un meccanismo per caricare i componenti più recenti in modo automatico, puoi eliminare manualmente il contento nella directory cache ed eseguire nuovamente il push della tua applicazione attenendoti alla seguente procedura: + 1. Estrai mediante checkout un ramo di un pacchetto di build null, ad esempio https://github.com/ryandotsmith/null-buildpack. Per informazioni su come estrarre mediante check-out un ramo, consulta [Git Basics - Getting a Git Repository ![icona link esterno](../icons/launch-glyph.svg)](http://www.git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository){: new_window}. + 2. Aggiungi la seguente riga al file `null-buildpack/bin/compile` ed esegui il commit delle modifiche. Per informazioni su come eseguire il commit delle modifiche, consulta [Git Basics - Recording Changes to the Repository ![icona link esterno](../icons/launch-glyph.svg)](http://www.git-scm.com/book/en/v2/Git-Basics-Recording-Changes-to-the-Repository){: new_window}. + ``` + rm -rfv $2/* + ``` + 3. Esegui il push della tua applicazione con il pacchetto di build null che è stato modificato per eliminare +la cache utilizzando il seguente comando. Dopo che hai completato questo passo, tutto il contenuto nella directory +cache della tua applicazione viene eliminato. + ``` + cf push appname -p app_path -b + ``` + 4. Esegui il push della tua applicazione con il pacchetto di build più recente che vuoi utilizzare servendoti del seguente comando: + ``` + cf push appname -p app_path -b + ``` + + + + +## Messaggi NOTICE dal pacchetto di build PHP +{: #ts_phplog} + +Potresti visualizzare dei messaggi di log che contengono NOTICE. Puoi interrompere la registrazione di questi messaggi modificando il +livello di registrazione. + + + +Quando distribuisci un'applicazione a Bluemix utilizzando un pacchetto di build PHP, potresti visualizzare dei messaggi che contengono `NOTICE`: +{: tsSymptoms} + +``` +• 2015-01-26T15:00:59.70+0100 [App/0] ERR [26-Jan-2015 14:00:59] NOTICE: [pool www] 'user' directive is ignored when FPM is not running as root +• 2015-01-26T15:01:00.63+0100 [App/0] ERR [26-Jan-2015 14:00:59] NOTICE: [pool www] 'user' directive is ignored when FPM is not running as root +• 2015-01-26T15:01:00.63+0100 [App/0] ERR [26-Jan-2015 14:00:59] NOTICE: fpm is running, pid 93 +• 2015-01-26T15:01:00.63+0100 [App/0] ERR [26-Jan-2015 14:00:59] NOTICE: ready to handle connections +``` + + + +Nel pacchetto di build PHP, il parametro error_log è utilizzato per definire il livello di registrazione. Per impostazione predefinita, il valore del parametro `error_log` +è **stderr notice**. Il seguente esempio mostra la configurazione +del livello di registrazione predefinita nel file `nginx-defaults.conf` +del pacchetto di build PHP fornito da Cloud Foundry. Per ulteriori informazioni, vedi [cloudfoundry/php-buildpack ![icona link esterno](../icons/launch-glyph.svg)](https://github.com/cloudfoundry/php-buildpack/blob/ff71ea41d00c1226d339e83cf2c7d6dda6c590ef/defaults/config/nginx/1.5.x/nginx-defaults.conf){: new_window}. +{: tsCauses} + +``` +daemon off; +error_log stderr notice; +pid @{HOME}/nginx/logs/nginx.pid; +``` + + + +I messaggi `NOTICE` sono informativi e non +indicano necessariamente che si è verificato un problema. Puoi interrompere la registrazione di questi messaggi modificando il livello di registrazione da stderr notice a stderr error nel file nginx-defaults.conf del tuo pacchetto di build. Ad +esempio: +{: tsResolve} + +``` +daemon off; +error_log stderr error; +pid @{HOME}/nginx/logs/nginx.pid; +``` +Per ulteriori informazioni su come modificare la configurazione di registrazione predefinita, vedi [error_log ![icona link esterno](../icons/launch-glyph.svg)](http://nginx.org/en/docs/ngx_core_module.html#error_log){: new_window}. + + +## Impossibile importare una libreria Python di terze parti in {{site.data.keyword.Bluemix_notm}} +{: #ts_importpylib} + +Potresti non riuscire a importare una libreria Python di terze parti +in {{site.data.keyword.Bluemix_notm}}. Puoi risolvere il problema aggiungendo file di configurazione nella directory +root della tua applicazione Python. + + +Quando tenti di importare una libreria Python di terze parti, come +la libreria `web.py`, il comando `cf push` +non riesce. +{: tsSymptoms} + + + + +Questo problema si verifica quando mancano delle informazioni di configurazione +per l'applicazione Python. +{: tsCauses} + + + + +Per risolvere il problema, aggiungi un file `requirements.txt` e un file `Procfile` nella directory root della tua applicazione Python. Le seguenti informazioni presumono che tu stia importando la libreria web.py: +{: tsResolve} + + 1. Aggiungi un file `requirements.txt` nella directory root della tua applicazione Python. + Il file `requirements.txt` specifica i pacchetti di libreria richiesti per l'applicazione Python e la versione dei pacchetti. Il seguente esempio mostra il contenuto del file `requirements.txt`, dove `web.py==0.37` indica +che la versione della libreria `web.py` che verrà scaricata è la 0.37 e `wsgiref==0.1.2` indica che la versione dell'interfaccia gateway del server Web richiesta dalla libreria web.py è la 0.1.2. + ``` + web.py==0.37 + wsgiref==0.1.2 + ``` + Per ulteriori informazioni su come configurare +il file `requirements.txt`, vedi [Requirements files](https://pip.readthedocs.org/en/1.1/requirements.html). + + 2. Aggiungi un file `Procfile` nella directory root +della tua applicazione Python. + Il file `Procfile` +deve contenere il comando di avvio per la tua applicazione Python. Nel seguente comando, *ilnomedellatuaapplicazione* è il nome della tua applicazione Python e *PORT* è il numero di porta che l'applicazione Python dovrà utilizzare per ricevere le richieste dagli utenti dell'applicazione. *$PORT* è facoltativo. Se non specifichi una PORTA nel comando di avvio, verrà utilizzato +il numero di porta indicato nella variabile di ambiente `VCAP_APP_PORT` che si trova all'interno dell'applicazione. + ``` + web: python .py $PORT + ``` +Adesso, puoi importare la libreria Python di terze parti +in {{site.data.keyword.Bluemix_notm}}. + + + +## Il pulsante Azioni nella pagina Dettagli istanza è disabilitato +{: #ts_actionsbutton} + + + +Il pulsante Azioni nella pagina Dettagli istanza è disabilitato. +{: tsSymptoms} + + + +Questo problema si verifica a causa dei seguenti motivi: +{: tsCauses} + + * L'applicazione non è un'applicazione web Java™. RMU (Runtime Management Utilities) supporta solo le applicazioni +Web distribuite con i pacchetti di build Liberty. + * L'applicazione non viene distribuita con il pacchetto di build Liberty integrato. + * L'applicazione è stata distribuita con una versione precedente del pacchetto di build +Liberty. + + + +Se il problema è causato da una versione precedente del pacchetto di build Liberty, ridistribuisci l'applicazione in {{site.data.keyword.Bluemix_notm}}. In caso contrario, puoi +fornire i seguenti file di log dell'applicazione client al team +di supporto: +{: tsResolve} + + * logs/messages.log + * logs/stdout.log + * logs/stderr.log + + + + +## Credenziali richieste all'apertura della finestra di traccia o di dump +{: #ts_username} + + + + +Vengono richiesti un nome utente e una password quando si apre la finestra di traccia +e di dump. +{: tsSymptoms} + + + +Questo problema si verifica a causa del timeout della sessione di accesso. +{: tsCauses} + + + +La soluzione consiste nell'immettere nuovamente il nome utente e la password. +{: tsResolve} + + + + +## Si verifica un errore durante l'esecuzione delle operazioni di traccia o di dump +{: #ts_target} + + + +Viene visualizzato un messaggio di errore mentre le operazioni di +traccia o di dump sono in esecuzione. Il messaggio indica che un'istanza di destinazione +per un'applicazione non si trova nello stato di In esecuzione: +{: tsSymptoms} + +``` +Istanza 0: La specifica di traccia è stata impostata correttamente +Istanza 2: La specifica di traccia è stata impostata correttamente +Istanza 1: L'istanza di destinazione 1 per l'applicazione abcd non si trova nello stato di In esecuzione. +Istanza 3: La specifica di traccia è stata impostata correttamente +Istanza 4: La specifica di traccia è stata impostata correttamente +``` + + + +Questo problema si verifica a causa dei seguenti motivi: +{: tsCauses} + + * Le capacità di gestione della traccia o del dump riguardano solo le istanze dell'applicazione +che sono in esecuzione. Le operazioni di traccia o di dump non possono essere utilizzate +su istanze dell'applicazione arrestate, in fase di avvio o bloccate. + * Lo stato dell'istanza dell'applicazione cambia quando si apre la finestra di dialogo della traccia o +del dump. + + + +La soluzione consiste nel chiudere la finestra, e quindi +riaprirla. +{: tsResolve} + + + +## Le istanza hanno una configurazione traceSpecification differente +{: #ts_different_config} + + + +Per diverse istanze di un'applicazione, potresti vedere una configurazione traceSpecification differente. +{: tsSymptoms} + + + +Questo problema si verifica a causa dei seguenti motivi: +{: tsCauses} + + * Potresti aver modificato la configurazione per una o più istanze, precedentemente. Se modifichi la configurazione traceSpecification per una istanza, essa non si applica ad altre istanze della stessa applicazione. Ad esempio, la tua applicazione utilizza log4j e hai 2 istanze per questa applicazione. Puoi modificare il livello di log dell'istanza 0 da info a debug ma il livello di log dell'istanza 1 rimane info. + * Viene eseguito un ridimensionamento incrementale dell'applicazione, che presenta delle nuove istanze. RMU non applica la configurazione traceSpecification dell'istanza esistente alla nuova istanza di cui è stato eseguito il ridimensionamento incrementale. La nuova istanza utilizza la configurazione predefinita. Ad esempio, la tua applicazione utilizza log4j e ha una istanza. Puoi modificare il livello di log di questa istanza da info a debug. Dopo che hai apportato questo modifica, se esegui il ridimensionamento incrementale della tua applicazione in due istanze, il livello di log della nuova istanza è info, invece di debug. + + + +Questo è il comportamento previsto. +{: tsResolve} + + + + + +## Quota disco superata +{: #ts_diskquota} + +Nel log dell'applicazione, potresti notare che la quota del disco è stata superata. + + + +Nel log della tua applicazione vedi il messaggio di errore `Disk quota exceeded`. +{: tsSymptoms} + + + +Questo problema è causato da uno dei seguenti motivi: +{: tsCauses} + + * I file di dump vengono generati con le istanze dell'applicazione in esecuzione +e i file utilizzano la quota di disco assegnata. Per impostazione predefinita, la quota del disco +per un'istanza dell'applicazione è di 1 GB. Puoi controllare l'utilizzo del +disco facendo clic su **Dashboard>Applicazione>Runtime applicazione**. Il seguente esempio mostra le informazioni di runtime, +incluso l'utilizzo del disco, per due istanze di un'applicazione: + ``` + Instance State CPU Memory Usage Disk Usage + + 0 Running 1.0% 344.8MB/512MB 236.8MB/1GB + 2 Running 2.3% 361.2MB/512MB 235.7MB/1GB + ``` + * La quota del disco è limitata dalla quota dell'organizzazione corrente. + + + + +Puoi risolvere il problema utilizzando uno dei seguenti +metodi: +{: tsResolve} + + * Elimina i file di dump dopo averli scaricati. + * Ridistribuisci l'applicazione con una quota di disco maggiore includendo +la seguente voce nel manifest di distribuzione: + ``` + disk_quota: 2048 + ``` + + + + diff --git a/troubleshoot/nl/it/sendgrid.md b/troubleshoot/nl/it/sendgrid.md index 604c28e49..3b289353d 100644 --- a/troubleshoot/nl/it/sendgrid.md +++ b/troubleshoot/nl/it/sendgrid.md @@ -1,48 +1,48 @@ ---- - -copyright: - anni: 2015, 2015 - - ---- - - -{:tsSymptoms: .tsSymptoms} -{:tsCauses: .tsCauses} -{:tsResolve: .tsResolve} -{:new_window: target="_blank"} -{:shortdesc: .shortdesc} - -# Risoluzione dei problemi di SendGrid -{: #ts_sendgrid} - -*Ultimo aggiornamento: 9 dicembre 2015* -{: .last-updated} - -Di seguito è riportata la risposta a una domanda relativa all'utilizzo di SendGrid di {{site.data.keyword.Bluemix}}. -{:shortdesc} - - -## Impossibile inviare email utilizzando SendGrid -{: #ts_sendgrid_email} - -Se non riesci a inviare email utilizzando il servizio SendGrid, potresti aver raggiunto il limite di email consentite per ciascuna istanza del servizio. -{:shortdesc} - - -Dopo aver inviato il numero massimo di email consentite, non riesci a utilizzare il servizio SendGrid per inviare altre email. -{: tsSymptoms} - - -Quando invii email utilizzando il servizio SendGrid, esiste un limite di invio pari a 25.000 email per istanza del servizio al mese. Dopo che hai raggiunto il limite, SendGrid interrompe -l'invio delle email e non vengono applicati ulteriori addebiti per l'utilizzo di questo servizio. -{: tsCauses} - -Per controllare il numero restante di email consentite, fai clic sulla tua istanza del servizio SendGrid dal Dashboard {{site.data.keyword.Bluemix_notm}} e fai clic su **APRI DASHBOARD SENDGRID**. Puoi -visualizzare il numero nel campo **Crediti rimanenti**. - - -Se desideri inviare altre email anche dopo aver raggiunto il limite -di 25.000 email per istanza del servizio al mese, puoi aggiungere un'altra -istanza del servizio. Per ulteriori informazioni su SendGrid, vedi [Introduzione a SendGrid](https://sendgrid.com/docs/index.html){: new_window}. -{: tsResolve} +--- + +copyright: + anni: 2015, 2015 + + +--- + + +{:tsSymptoms: .tsSymptoms} +{:tsCauses: .tsCauses} +{:tsResolve: .tsResolve} +{:new_window: target="_blank"} +{:shortdesc: .shortdesc} + +# Risoluzione dei problemi di SendGrid +{: #ts_sendgrid} + +*Ultimo aggiornamento: 9 dicembre 2015* +{: .last-updated} + +Di seguito è riportata la risposta a una domanda relativa all'utilizzo di SendGrid di {{site.data.keyword.Bluemix}}. +{:shortdesc} + + +## Impossibile inviare email utilizzando SendGrid +{: #ts_sendgrid_email} + +Se non riesci a inviare email utilizzando il servizio SendGrid, potresti aver raggiunto il limite di email consentite per ciascuna istanza del servizio. +{:shortdesc} + + +Dopo aver inviato il numero massimo di email consentite, non riesci a utilizzare il servizio SendGrid per inviare altre email. +{: tsSymptoms} + + +Quando invii email utilizzando il servizio SendGrid, esiste un limite di invio pari a 25.000 email per istanza del servizio al mese. Dopo che hai raggiunto il limite, SendGrid interrompe +l'invio delle email e non vengono applicati ulteriori addebiti per l'utilizzo di questo servizio. +{: tsCauses} + +Per controllare il numero restante di email consentite, fai clic sulla tua istanza del servizio SendGrid dal Dashboard {{site.data.keyword.Bluemix_notm}} e fai clic su **APRI DASHBOARD SENDGRID**. Puoi +visualizzare il numero nel campo **Crediti rimanenti**. + + +Se desideri inviare altre email anche dopo aver raggiunto il limite +di 25.000 email per istanza del servizio al mese, puoi aggiungere un'altra +istanza del servizio. Per ulteriori informazioni su SendGrid, vedi [Introduzione a SendGrid](https://sendgrid.com/docs/index.html){: new_window}. +{: tsResolve} diff --git a/troubleshoot/nl/it/services_troubleshooting.md b/troubleshoot/nl/it/services_troubleshooting.md index 3e3cfded2..5125b852b 100644 --- a/troubleshoot/nl/it/services_troubleshooting.md +++ b/troubleshoot/nl/it/services_troubleshooting.md @@ -1,17 +1,17 @@ ---- - -copyright: - year: 2015, 2015 - -lastupdated: "2015-12-09" - - ---- - -# Risoluzione dei problemi relativi ai servizi -{: #services_troubleshooting} - - -Se riscontri dei problemi con l'utilizzo dei servizi {{site.data.keyword.Bluemix}}, -puoi riesaminare le informazioni sulla risoluzione dei problemi per determinare l'azione da -intraprendere. +--- + +copyright: + year: 2015, 2015 + +lastupdated: "2015-12-09" + + +--- + +# Risoluzione dei problemi relativi ai servizi +{: #services_troubleshooting} + + +Se riscontri dei problemi con l'utilizzo dei servizi {{site.data.keyword.Bluemix}}, +puoi riesaminare le informazioni sulla risoluzione dei problemi per determinare l'azione da +intraprendere. diff --git a/troubleshoot/nl/it/troubleshoot.md b/troubleshoot/nl/it/troubleshoot.md index c058e603f..f0e18aa26 100644 --- a/troubleshoot/nl/it/troubleshoot.md +++ b/troubleshoot/nl/it/troubleshoot.md @@ -1,28 +1,28 @@ ---- - -copyright: - years: 2015, 2017 - -lastupdated: "2016-03-08" - ---- - - -{:new_window: target="_blank"} - - - -# Risoluzione dei problemi -{: #troubleshooting} - -Se si verificano problemi con {{site.data.keyword.Bluemix}}, puoi utilizzare queste informazioni sulla risoluzione dei problemi per identificare e risolvere il problema. - -Accedi alla console {{site.data.keyword.Bluemix_notm}}: -* Per visualizzare lo stato dei runtime e dei servizi in esecuzione, fai clic su **Supporto > Stato** nella barra dei menu. -* Per visualizzare le notifiche, fai clic su **Account > Notifiche** nella barra dei menu. -* Per eseguire ricerche nella documentazione e nei forum di Stack Overflow o developerWorks (dW) Answers per cercare risposte o per contattare il supporto, fai clic su **Supporto > Trova risposte** nella barra dei menu. - -Se il tuo account è collegato tra {{site.data.keyword.Bluemix_notm}} e {{site.data.keyword.BluSoftlayer}}, accedi alla console Bluemix: -* Per visualizzare lo stato dei runtime e dei servizi in esecuzione, fai clic sul link **Stato**. -* Per cercare delle risposte, fai clic sul link **Supporto** nella barra dei menu, quindi seleziona **Aggiungi ticket > Trova risposte**. - Puoi anche andare direttamente ai forum *Stack Overflow* o *developerWorks (dW) Answers* per cercare risposte o pubblicare domande. +--- + +copyright: + years: 2015, 2017 + +lastupdated: "2016-03-08" + +--- + + +{:new_window: target="_blank"} + + + +# Risoluzione dei problemi +{: #troubleshooting} + +Se si verificano problemi con {{site.data.keyword.Bluemix}}, puoi utilizzare queste informazioni sulla risoluzione dei problemi per identificare e risolvere il problema. + +Accedi alla console {{site.data.keyword.Bluemix_notm}}: +* Per visualizzare lo stato dei runtime e dei servizi in esecuzione, fai clic su **Supporto > Stato** nella barra dei menu. +* Per visualizzare le notifiche, fai clic su **Account > Notifiche** nella barra dei menu. +* Per eseguire ricerche nella documentazione e nei forum di Stack Overflow o developerWorks (dW) Answers per cercare risposte o per contattare il supporto, fai clic su **Supporto > Trova risposte** nella barra dei menu. + +Se il tuo account è collegato tra {{site.data.keyword.Bluemix_notm}} e {{site.data.keyword.BluSoftlayer}}, accedi alla console Bluemix: +* Per visualizzare lo stato dei runtime e dei servizi in esecuzione, fai clic sul link **Stato**. +* Per cercare delle risposte, fai clic sul link **Supporto** nella barra dei menu, quindi seleziona **Aggiungi ticket > Trova risposte**. + Puoi anche andare direttamente ai forum *Stack Overflow* o *developerWorks (dW) Answers* per cercare risposte o pubblicare domande.